@nathapp/nax 0.61.2 → 0.62.0-canary.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -4
- package/dist/nax.js +33697 -32280
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,5 +1,11 @@
|
|
|
1
1
|
# nax
|
|
2
2
|
|
|
3
|
+
[](https://npmjs.com/@nathapp/nax)
|
|
4
|
+
[](https://github.com/nathapp-io/nax/actions)
|
|
5
|
+
[](https://bun.sh)
|
|
6
|
+
[](https://nodejs.org)
|
|
7
|
+
[](LICENSE)
|
|
8
|
+
|
|
3
9
|
**AI Coding Agent Orchestrator** — loops until done.
|
|
4
10
|
|
|
5
11
|
Give it a spec. It writes tests, implements code, verifies quality, and retries until everything passes.
|
|
@@ -15,6 +21,7 @@ nax is an **orchestrator, not an agent** — it doesn't write code itself. It dr
|
|
|
15
21
|
- **Extensible** — plugin system for routing, review, reporting, and post-run actions
|
|
16
22
|
- **Language-aware** — auto-detects Go, Rust, Python, TypeScript from manifest files; adapts commands, test structure, and mocking patterns per language
|
|
17
23
|
- **Semantic review** — LLM-based behavioral review against story acceptance criteria; catches stubs, placeholders, and out-of-scope changes
|
|
24
|
+
- **Adversarial review** — LLM-based adversarial code review that probes for input handling, error paths, and abandoned implementations
|
|
18
25
|
|
|
19
26
|
## Install
|
|
20
27
|
|
|
@@ -24,7 +31,7 @@ npm install -g @nathapp/nax
|
|
|
24
31
|
bun install -g @nathapp/nax
|
|
25
32
|
```
|
|
26
33
|
|
|
27
|
-
Requires:
|
|
34
|
+
Requires: Bun 1.3.7+ or Node 22+. Git must be initialized.
|
|
28
35
|
|
|
29
36
|
## Quick Start
|
|
30
37
|
|
|
@@ -46,7 +53,7 @@ See [docs/](docs/) for full guides on configuration, test strategies, monorepo s
|
|
|
46
53
|
## How It Works
|
|
47
54
|
|
|
48
55
|
```
|
|
49
|
-
(plan →) acceptance setup → route → execute → verify → review → escalate → loop → regression gate → acceptance
|
|
56
|
+
(plan →) acceptance setup → route → execute → verify → review (semantic + adversarial) → escalate → loop → regression gate → acceptance
|
|
50
57
|
```
|
|
51
58
|
|
|
52
59
|
1. **Plan** *(optional)* — Generate `prd.json` from a spec file using an LLM
|
|
@@ -55,7 +62,7 @@ See [docs/](docs/) for full guides on configuration, test strategies, monorepo s
|
|
|
55
62
|
4. **Context** — Gather relevant code, tests, and project standards per story
|
|
56
63
|
5. **Execute** — Run agent session (Claude Code, Codex, Gemini CLI, or ACP)
|
|
57
64
|
6. **Verify** — Run scoped tests; rectify on failure before escalating
|
|
58
|
-
7. **Review** — Run lint + typecheck; autofix before escalating
|
|
65
|
+
7. **Review** — Run lint + typecheck + semantic review + adversarial review; autofix before escalating
|
|
59
66
|
8. **Escalate** — On repeated failure, retry with a higher model tier
|
|
60
67
|
9. **Loop** — Repeat steps 3–8 per story until all pass or a cost/iteration limit is hit
|
|
61
68
|
10. **Regression gate** — Run full test suite after all stories pass
|
|
@@ -142,10 +149,12 @@ After all stories pass, nax runs the full test suite once. If it fails, it retri
|
|
|
142
149
|
|
|
143
150
|
See [Regression Gate Guide](docs/guides/regression-gate.md).
|
|
144
151
|
|
|
145
|
-
### Parallel Execution
|
|
152
|
+
### Parallel & Isolated Execution
|
|
146
153
|
|
|
147
154
|
Stories are batched by compatibility (same model tier, similar complexity) and run in parallel within each batch. Use `--parallel <n>` to control concurrency. Sequential mode uses a deferred regression gate; parallel mode always runs regression at the end.
|
|
148
155
|
|
|
156
|
+
Even in sequential mode, stories can be isolated in per-story git worktrees (`execution.storyIsolation: "worktree"`) to prevent cross-story state leakage.
|
|
157
|
+
|
|
149
158
|
See [Parallel Execution Guide](docs/guides/parallel-execution.md).
|
|
150
159
|
|
|
151
160
|
### Monorepo Support
|