@rogeriohsjr/nodulus
v2.5.0
Published
An open-source TypeScript CLI for LLM workflows with validated artifacts and resumable execution.
Readme
Nodulus
An open-source TypeScript CLI for LLM workflows with validated artifacts and resumable execution.
Install the public npm package with Node.js 24:
npm install --global @rogeriohsjr/nodulus@latest
nodulus --version
nodulus --helpFor project setup and usage, see the Nodulus user guide.
Status: folders 00 through 08 are implemented and independently reviewed: initialization, request capture, validated node outcomes, sequential workflows, persisted pause/resume, bounded repair/crash detection, Codex/Cursor adapters, and local package installation/upgrades. Hosted Windows, macOS and Linux checks exercise the scenario and package install/upgrade suites. The public package identity is @rogeriohsjr/nodulus; release and registry validation status is recorded in folder 09. The generated project has no configured provider. Adapter tests use real local fixture executables; Codex, OpenCode/Ollama, and Cursor have separate Windows live proof, while macOS/Linux live-provider compatibility remains pending.
The current feature branch adds bounded feedback routing and read-only inspection/export/replay. FB-010/030/040/045/060 have independent local review; FB-050 is a green local candidate awaiting review and the final repository check. This branch status does not change the currently published npm package.
Start with the implementation sequence. Each numbered folder contains scenarios, implementation guidance, checkboxes, and an evidence record.
- User scenarios
- Architecture
- Code quality and AI checklist
- Testing policy
- Codex guidance
- Skill usage and developer assignment examples
Repository skills: $nodulus-scenario-tdd and $nodulus-delivery-validation.
For development, use Node.js 24, run npm ci, then npm run check to run lint, typecheck, scenarios and package checks.
For a local bounded feedback-routing walkthrough, see the normalization and review example. It uses a controlled child-process fixture and the exported API without calling a live provider.
Contribute and license
Issues and pull requests are welcome. See the contribution guide for the development workflow and test expectations.
Copyright 2026 Rogeriohsjr and Nodulus contributors. Licensed under Apache-2.0, with attribution in NOTICE. You may use, copy, modify and redistribute this project under those terms.
Develop with Nodulus
The development workflow example connects an OpenCode/Qwen test author, Luna test reviewer, OpenCode/Qwen implementer and GPT-5.6 Sol final reviewer. An actual npm run check validator gates completion. A separate verification workflow checks existing work, and escalation is optional. See the example for isolated-worktree setup, required CLI versions and live-validation limitations.
