@nathapp/nax 0.18.1

package/biome.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+  "organizeImports": { "enabled": true },
+  "linter": {
+    "enabled": true,
+    "rules": { "recommended": true }
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 120
+  }
+}

package/bun.lock

@@ -0,0 +1,168 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "ngent",
+      "dependencies": {
+        "@anthropic-ai/sdk": "^0.74.0",
+        "@types/react": "^19.2.14",
+        "chalk": "^5.6.2",
+        "commander": "^13.1.0",
+        "ink": "^6.7.0",
+        "ink-spinner": "^5.0.0",
+        "ink-testing-library": "^4.0.0",
+        "node-pty": "^1.1.0",
+        "react": "^19.2.4",
+        "zod": "^4.3.6",
+      },
+      "devDependencies": {
+        "@biomejs/biome": "^1.9.4",
+        "@types/bun": "^1.2.4",
+        "react-devtools-core": "^7.0.1",
+        "typescript": "^5.7.3",
+      },
+    },
+  },
+  "packages": {
+    "@alcalzone/ansi-tokenize": ["@alcalzone/ansi-tokenize@0.2.5", "", { "dependencies": { "ansi-styles": "^6.2.1", "is-fullwidth-code-point": "^5.0.0" } }, "sha512-3NX/MpTdroi0aKz134A6RC2Gb2iXVECN4QaAXnvCIxxIm3C3AVB1mkUe8NaaiyvOpDfsrqWhYtj+Q6a62RrTsw=="],
+
+    "@anthropic-ai/sdk": ["@anthropic-ai/sdk@0.74.0", "", { "dependencies": { "json-schema-to-ts": "^3.1.1" }, "peerDependencies": { "zod": "^3.25.0 || ^4.0.0" }, "optionalPeers": ["zod"], "bin": { "anthropic-ai-sdk": "bin/cli" } }, "sha512-srbJV7JKsc5cQ6eVuFzjZO7UR3xEPJqPamHFIe29bs38Ij2IripoAhC0S5NslNbaFUYqBKypmmpzMTpqfHEUDw=="],
+
+    "@babel/runtime": ["@babel/runtime@7.28.6", "", {}, "sha512-05WQkdpL9COIMz4LjTxGpPNCdlpyimKppYNoJ5Di5EUObifl8t4tuLuUBBZEpoLYOmfvIWrsp9fCl0HoPRVTdA=="],
+
+    "@biomejs/biome": ["@biomejs/biome@1.9.4", "", { "optionalDependencies": { "@biomejs/cli-darwin-arm64": "1.9.4", "@biomejs/cli-darwin-x64": "1.9.4", "@biomejs/cli-linux-arm64": "1.9.4", "@biomejs/cli-linux-arm64-musl": "1.9.4", "@biomejs/cli-linux-x64": "1.9.4", "@biomejs/cli-linux-x64-musl": "1.9.4", "@biomejs/cli-win32-arm64": "1.9.4", "@biomejs/cli-win32-x64": "1.9.4" }, "bin": { "biome": "bin/biome" } }, "sha512-1rkd7G70+o9KkTn5KLmDYXihGoTaIGO9PIIN2ZB7UJxFrWw04CZHPYiMRjYsaDvVV7hP1dYNRLxSANLaBFGpog=="],
+
+    "@biomejs/cli-darwin-arm64": ["@biomejs/cli-darwin-arm64@1.9.4", "", { "os": "darwin", "cpu": "arm64" }, "sha512-bFBsPWrNvkdKrNCYeAp+xo2HecOGPAy9WyNyB/jKnnedgzl4W4Hb9ZMzYNbf8dMCGmUdSavlYHiR01QaYR58cw=="],
+
+    "@biomejs/cli-darwin-x64": ["@biomejs/cli-darwin-x64@1.9.4", "", { "os": "darwin", "cpu": "x64" }, "sha512-ngYBh/+bEedqkSevPVhLP4QfVPCpb+4BBe2p7Xs32dBgs7rh9nY2AIYUL6BgLw1JVXV8GlpKmb/hNiuIxfPfZg=="],
+
+    "@biomejs/cli-linux-arm64": ["@biomejs/cli-linux-arm64@1.9.4", "", { "os": "linux", "cpu": "arm64" }, "sha512-fJIW0+LYujdjUgJJuwesP4EjIBl/N/TcOX3IvIHJQNsAqvV2CHIogsmA94BPG6jZATS4Hi+xv4SkBBQSt1N4/g=="],
+
+    "@biomejs/cli-linux-arm64-musl": ["@biomejs/cli-linux-arm64-musl@1.9.4", "", { "os": "linux", "cpu": "arm64" }, "sha512-v665Ct9WCRjGa8+kTr0CzApU0+XXtRgwmzIf1SeKSGAv+2scAlW6JR5PMFo6FzqqZ64Po79cKODKf3/AAmECqA=="],
+
+    "@biomejs/cli-linux-x64": ["@biomejs/cli-linux-x64@1.9.4", "", { "os": "linux", "cpu": "x64" }, "sha512-lRCJv/Vi3Vlwmbd6K+oQ0KhLHMAysN8lXoCI7XeHlxaajk06u7G+UsFSO01NAs5iYuWKmVZjmiOzJ0OJmGsMwg=="],
+
+    "@biomejs/cli-linux-x64-musl": ["@biomejs/cli-linux-x64-musl@1.9.4", "", { "os": "linux", "cpu": "x64" }, "sha512-gEhi/jSBhZ2m6wjV530Yy8+fNqG8PAinM3oV7CyO+6c3CEh16Eizm21uHVsyVBEB6RIM8JHIl6AGYCv6Q6Q9Tg=="],
+
+    "@biomejs/cli-win32-arm64": ["@biomejs/cli-win32-arm64@1.9.4", "", { "os": "win32", "cpu": "arm64" }, "sha512-tlbhLk+WXZmgwoIKwHIHEBZUwxml7bRJgk0X2sPyNR3S93cdRq6XulAZRQJ17FYGGzWne0fgrXBKpl7l4M87Hg=="],
+
+    "@biomejs/cli-win32-x64": ["@biomejs/cli-win32-x64@1.9.4", "", { "os": "win32", "cpu": "x64" }, "sha512-8Y5wMhVIPaWe6jw2H+KlEm4wP/f7EW3810ZLmDlrEEy5KvBsb9ECEfu/kMWD484ijfQ8+nIi0giMgu9g1UAuuA=="],
+
+    "@types/bun": ["@types/bun@1.3.9", "", { "dependencies": { "bun-types": "1.3.9" } }, "sha512-KQ571yULOdWJiMH+RIWIOZ7B2RXQGpL1YQrBtLIV3FqDcCu6FsbFUBwhdKUlCKUpS3PJDsHlJ1QKlpxoVR+xtw=="],
+
+    "@types/node": ["@types/node@25.2.3", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-m0jEgYlYz+mDJZ2+F4v8D1AyQb+QzsNqRuI7xg1VQX/KlKS0qT9r1Mo16yo5F/MtifXFgaofIFsdFMox2SxIbQ=="],
+
+    "@types/react": ["@types/react@19.2.14", "", { "dependencies": { "csstype": "^3.2.2" } }, "sha512-ilcTH/UniCkMdtexkoCN0bI7pMcJDvmQFPvuPvmEaYA/NSfFTAgdUSLAoVjaRJm7+6PvcM+q1zYOwS4wTYMF9w=="],
+
+    "ansi-escapes": ["ansi-escapes@7.3.0", "", { "dependencies": { "environment": "^1.0.0" } }, "sha512-BvU8nYgGQBxcmMuEeUEmNTvrMVjJNSH7RgW24vXexN4Ven6qCvy4TntnvlnwnMLTVlcRQQdbRY8NKnaIoeWDNg=="],
+
+    "ansi-regex": ["ansi-regex@6.2.2", "", {}, "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg=="],
+
+    "ansi-styles": ["ansi-styles@6.2.3", "", {}, "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg=="],
+
+    "auto-bind": ["auto-bind@5.0.1", "", {}, "sha512-ooviqdwwgfIfNmDwo94wlshcdzfO64XV0Cg6oDsDYBJfITDz1EngD2z7DkbvCWn+XIMsIqW27sEVF6qcpJrRcg=="],
+
+    "bun-types": ["bun-types@1.3.9", "", { "dependencies": { "@types/node": "*" } }, "sha512-+UBWWOakIP4Tswh0Bt0QD0alpTY8cb5hvgiYeWCMet9YukHbzuruIEeXC2D7nMJPB12kbh8C7XJykSexEqGKJg=="],
+
+    "chalk": ["chalk@5.6.2", "", {}, "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA=="],
+
+    "cli-boxes": ["cli-boxes@3.0.0", "", {}, "sha512-/lzGpEWL/8PfI0BmBOPRwp0c/wFNX1RdUML3jK/RcSBA9T8mZDdQpqYBKtCFTOfQbwPqWEOpjqW+Fnayc0969g=="],
+
+    "cli-cursor": ["cli-cursor@4.0.0", "", { "dependencies": { "restore-cursor": "^4.0.0" } }, "sha512-VGtlMu3x/4DOtIUwEkRezxUZ2lBacNJCHash0N0WeZDBS+7Ux1dm3XWAgWYxLJFMMdOeXMHXorshEFhbMSGelg=="],
+
+    "cli-spinners": ["cli-spinners@2.9.2", "", {}, "sha512-ywqV+5MmyL4E7ybXgKys4DugZbX0FC6LnwrhjuykIjnK9k8OQacQ7axGKnjDXWNhns0xot3bZI5h55H8yo9cJg=="],
+
+    "cli-truncate": ["cli-truncate@5.1.1", "", { "dependencies": { "slice-ansi": "^7.1.0", "string-width": "^8.0.0" } }, "sha512-SroPvNHxUnk+vIW/dOSfNqdy1sPEFkrTk6TUtqLCnBlo3N7TNYYkzzN7uSD6+jVjrdO4+p8nH7JzH6cIvUem6A=="],
+
+    "code-excerpt": ["code-excerpt@4.0.0", "", { "dependencies": { "convert-to-spaces": "^2.0.1" } }, "sha512-xxodCmBen3iy2i0WtAK8FlFNrRzjUqjRsMfho58xT/wvZU1YTM3fCnRjcy1gJPMepaRlgm/0e6w8SpWHpn3/cA=="],
+
+    "commander": ["commander@13.1.0", "", {}, "sha512-/rFeCpNJQbhSZjGVwO9RFV3xPqbnERS8MmIQzCtD/zl6gpJuV/bMLuN92oG3F7d8oDEHHRrujSXNUr8fpjntKw=="],
+
+    "convert-to-spaces": ["convert-to-spaces@2.0.1", "", {}, "sha512-rcQ1bsQO9799wq24uE5AM2tAILy4gXGIK/njFWcVQkGNZ96edlpY+A7bjwvzjYvLDyzmG1MmMLZhpcsb+klNMQ=="],
+
+    "csstype": ["csstype@3.2.3", "", {}, "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ=="],
+
+    "emoji-regex": ["emoji-regex@10.6.0", "", {}, "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A=="],
+
+    "environment": ["environment@1.1.0", "", {}, "sha512-xUtoPkMggbz0MPyPiIWr1Kp4aeWJjDZ6SMvURhimjdZgsRuDplF5/s9hcgGhyXMhs+6vpnuoiZ2kFiu3FMnS8Q=="],
+
+    "es-toolkit": ["es-toolkit@1.44.0", "", {}, "sha512-6penXeZalaV88MM3cGkFZZfOoLGWshWWfdy0tWw/RlVVyhvMaWSBTOvXNeiW3e5FwdS5ePW0LGEu17zT139ktg=="],
+
+    "escape-string-regexp": ["escape-string-regexp@2.0.0", "", {}, "sha512-UpzcLCXolUWcNu5HtVMHYdXJjArjsF9C0aNnquZYY4uW/Vu0miy5YoWvbV345HauVvcAUnpRuhMMcqTcGOY2+w=="],
+
+    "get-east-asian-width": ["get-east-asian-width@1.4.0", "", {}, "sha512-QZjmEOC+IT1uk6Rx0sX22V6uHWVwbdbxf1faPqJ1QhLdGgsRGCZoyaQBm/piRdJy/D2um6hM1UP7ZEeQ4EkP+Q=="],
+
+    "indent-string": ["indent-string@5.0.0", "", {}, "sha512-m6FAo/spmsW2Ab2fU35JTYwtOKa2yAwXSwgjSv1TJzh4Mh7mC3lzAOVLBprb72XsTrgkEIsl7YrFNAiDiRhIGg=="],
+
+    "ink": ["ink@6.7.0", "", { "dependencies": { "@alcalzone/ansi-tokenize": "^0.2.4", "ansi-escapes": "^7.3.0", "ansi-styles": "^6.2.1", "auto-bind": "^5.0.1", "chalk": "^5.6.0", "cli-boxes": "^3.0.0", "cli-cursor": "^4.0.0", "cli-truncate": "^5.1.1", "code-excerpt": "^4.0.0", "es-toolkit": "^1.39.10", "indent-string": "^5.0.0", "is-in-ci": "^2.0.0", "patch-console": "^2.0.0", "react-reconciler": "^0.33.0", "scheduler": "^0.27.0", "signal-exit": "^3.0.7", "slice-ansi": "^7.1.0", "stack-utils": "^2.0.6", "string-width": "^8.1.1", "terminal-size": "^4.0.1", "type-fest": "^5.4.1", "widest-line": "^6.0.0", "wrap-ansi": "^9.0.0", "ws": "^8.18.0", "yoga-layout": "~3.2.1" }, "peerDependencies": { "@types/react": ">=19.0.0", "react": ">=19.0.0", "react-devtools-core": "^6.1.2" }, "optionalPeers": ["@types/react", "react-devtools-core"] }, "sha512-dhB16KfdTO8yYwF2K0E4wPXpL88tdrjjB6w44AZ0ljSktYoUQQcxccq9KL1vpRhk8JIa0A7B7zvjajHqI42teA=="],
+
+    "ink-spinner": ["ink-spinner@5.0.0", "", { "dependencies": { "cli-spinners": "^2.7.0" }, "peerDependencies": { "ink": ">=4.0.0", "react": ">=18.0.0" } }, "sha512-EYEasbEjkqLGyPOUc8hBJZNuC5GvXGMLu0w5gdTNskPc7Izc5vO3tdQEYnzvshucyGCBXc86ig0ujXPMWaQCdA=="],
+
+    "ink-testing-library": ["ink-testing-library@4.0.0", "", { "peerDependencies": { "@types/react": ">=18.0.0" }, "optionalPeers": ["@types/react"] }, "sha512-yF92kj3pmBvk7oKbSq5vEALO//o7Z9Ck/OaLNlkzXNeYdwfpxMQkSowGTFUCS5MSu9bWfSZMewGpp7bFc66D7Q=="],
+
+    "is-fullwidth-code-point": ["is-fullwidth-code-point@5.1.0", "", { "dependencies": { "get-east-asian-width": "^1.3.1" } }, "sha512-5XHYaSyiqADb4RnZ1Bdad6cPp8Toise4TzEjcOYDHZkTCbKgiUl7WTUCpNWHuxmDt91wnsZBc9xinNzopv3JMQ=="],
+
+    "is-in-ci": ["is-in-ci@2.0.0", "", { "bin": { "is-in-ci": "cli.js" } }, "sha512-cFeerHriAnhrQSbpAxL37W1wcJKUUX07HyLWZCW1URJT/ra3GyUTzBgUnh24TMVfNTV2Hij2HLxkPHFZfOZy5w=="],
+
+    "json-schema-to-ts": ["json-schema-to-ts@3.1.1", "", { "dependencies": { "@babel/runtime": "^7.18.3", "ts-algebra": "^2.0.0" } }, "sha512-+DWg8jCJG2TEnpy7kOm/7/AxaYoaRbjVB4LFZLySZlWn8exGs3A4OLJR966cVvU26N7X9TWxl+Jsw7dzAqKT6g=="],
+
+    "mimic-fn": ["mimic-fn@2.1.0", "", {}, "sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg=="],
+
+    "node-addon-api": ["node-addon-api@7.1.1", "", {}, "sha512-5m3bsyrjFWE1xf7nz7YXdN4udnVtXK6/Yfgn5qnahL6bCkf2yKt4k3nuTKAtT4r3IG8JNR2ncsIMdZuAzJjHQQ=="],
+
+    "node-pty": ["node-pty@1.1.0", "", { "dependencies": { "node-addon-api": "^7.1.0" } }, "sha512-20JqtutY6JPXTUnL0ij1uad7Qe1baT46lyolh2sSENDd4sTzKZ4nmAFkeAARDKwmlLjPx6XKRlwRUxwjOy+lUg=="],
+
+    "onetime": ["onetime@5.1.2", "", { "dependencies": { "mimic-fn": "^2.1.0" } }, "sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg=="],
+
+    "patch-console": ["patch-console@2.0.0", "", {}, "sha512-0YNdUceMdaQwoKce1gatDScmMo5pu/tfABfnzEqeG0gtTmd7mh/WcwgUjtAeOU7N8nFFlbQBnFK2gXW5fGvmMA=="],
+
+    "react": ["react@19.2.4", "", {}, "sha512-9nfp2hYpCwOjAN+8TZFGhtWEwgvWHXqESH8qT89AT/lWklpLON22Lc8pEtnpsZz7VmawabSU0gCjnj8aC0euHQ=="],
+
+    "react-devtools-core": ["react-devtools-core@7.0.1", "", { "dependencies": { "shell-quote": "^1.6.1", "ws": "^7" } }, "sha512-C3yNvRHaizlpiASzy7b9vbnBGLrhvdhl1CbdU6EnZgxPNbai60szdLtl+VL76UNOt5bOoVTOz5rNWZxgGt+Gsw=="],
+
+    "react-reconciler": ["react-reconciler@0.33.0", "", { "dependencies": { "scheduler": "^0.27.0" }, "peerDependencies": { "react": "^19.2.0" } }, "sha512-KetWRytFv1epdpJc3J4G75I4WrplZE5jOL7Yq0p34+OVOKF4Se7WrdIdVC45XsSSmUTlht2FM/fM1FZb1mfQeA=="],
+
+    "restore-cursor": ["restore-cursor@4.0.0", "", { "dependencies": { "onetime": "^5.1.0", "signal-exit": "^3.0.2" } }, "sha512-I9fPXU9geO9bHOt9pHHOhOkYerIMsmVaWB0rA2AI9ERh/+x/i7MV5HKBNrg+ljO5eoPVgCcnFuRjJ9uH6I/3eg=="],
+
+    "scheduler": ["scheduler@0.27.0", "", {}, "sha512-eNv+WrVbKu1f3vbYJT/xtiF5syA5HPIMtf9IgY/nKg0sWqzAUEvqY/xm7OcZc/qafLx/iO9FgOmeSAp4v5ti/Q=="],
+
+    "shell-quote": ["shell-quote@1.8.3", "", {}, "sha512-ObmnIF4hXNg1BqhnHmgbDETF8dLPCggZWBjkQfhZpbszZnYur5DUljTcCHii5LC3J5E0yeO/1LIMyH+UvHQgyw=="],
+
+    "signal-exit": ["signal-exit@3.0.7", "", {}, "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ=="],
+
+    "slice-ansi": ["slice-ansi@7.1.2", "", { "dependencies": { "ansi-styles": "^6.2.1", "is-fullwidth-code-point": "^5.0.0" } }, "sha512-iOBWFgUX7caIZiuutICxVgX1SdxwAVFFKwt1EvMYYec/NWO5meOJ6K5uQxhrYBdQJne4KxiqZc+KptFOWFSI9w=="],
+
+    "stack-utils": ["stack-utils@2.0.6", "", { "dependencies": { "escape-string-regexp": "^2.0.0" } }, "sha512-XlkWvfIm6RmsWtNJx+uqtKLS8eqFbxUg0ZzLXqY0caEy9l7hruX8IpiDnjsLavoBgqCCR71TqWO8MaXYheJ3RQ=="],
+
+    "string-width": ["string-width@8.1.1", "", { "dependencies": { "get-east-asian-width": "^1.3.0", "strip-ansi": "^7.1.0" } }, "sha512-KpqHIdDL9KwYk22wEOg/VIqYbrnLeSApsKT/bSj6Ez7pn3CftUiLAv2Lccpq1ALcpLV9UX1Ppn92npZWu2w/aw=="],
+
+    "strip-ansi": ["strip-ansi@7.1.2", "", { "dependencies": { "ansi-regex": "^6.0.1" } }, "sha512-gmBGslpoQJtgnMAvOVqGZpEz9dyoKTCzy2nfz/n8aIFhN/jCE/rCmcxabB6jOOHV+0WNnylOxaxBQPSvcWklhA=="],
+
+    "tagged-tag": ["tagged-tag@1.0.0", "", {}, "sha512-yEFYrVhod+hdNyx7g5Bnkkb0G6si8HJurOoOEgC8B/O0uXLHlaey/65KRv6cuWBNhBgHKAROVpc7QyYqE5gFng=="],
+
+    "terminal-size": ["terminal-size@4.0.1", "", {}, "sha512-avMLDQpUI9I5XFrklECw1ZEUPJhqzcwSWsyyI8blhRLT+8N1jLJWLWWYQpB2q2xthq8xDvjZPISVh53T/+CLYQ=="],
+
+    "ts-algebra": ["ts-algebra@2.0.0", "", {}, "sha512-FPAhNPFMrkwz76P7cdjdmiShwMynZYN6SgOujD1urY4oNm80Ou9oMdmbR45LotcKOXoy7wSmHkRFE6Mxbrhefw=="],
+
+    "type-fest": ["type-fest@5.4.4", "", { "dependencies": { "tagged-tag": "^1.0.0" } }, "sha512-JnTrzGu+zPV3aXIUhnyWJj4z/wigMsdYajGLIYakqyOW1nPllzXEJee0QQbHj+CTIQtXGlAjuK0UY+2xTyjVAw=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
+
+    "widest-line": ["widest-line@6.0.0", "", { "dependencies": { "string-width": "^8.1.0" } }, "sha512-U89AsyEeAsyoF0zVJBkG9zBgekjgjK7yk9sje3F4IQpXBJ10TF6ByLlIfjMhcmHMJgHZI4KHt4rdNfktzxIAMA=="],
+
+    "wrap-ansi": ["wrap-ansi@9.0.2", "", { "dependencies": { "ansi-styles": "^6.2.1", "string-width": "^7.0.0", "strip-ansi": "^7.1.0" } }, "sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww=="],
+
+    "ws": ["ws@7.5.10", "", { "peerDependencies": { "bufferutil": "^4.0.1", "utf-8-validate": "^5.0.2" }, "optionalPeers": ["bufferutil", "utf-8-validate"] }, "sha512-+dbF1tHwZpXcbOJdVOkzLDxZP1ailvSxM6ZweXTegylPny803bFhA+vqBYw4s31NSAk4S2Qz+AKXK9a4wkdjcQ=="],
+
+    "yoga-layout": ["yoga-layout@3.2.1", "", {}, "sha512-0LPOt3AxKqMdFBZA3HBAt/t/8vIKq7VaQYbuA8WxCgung+p9TVyKRYdpvCb80HcdTN2NkbIKbhNwKUfm3tQywQ=="],
+
+    "zod": ["zod@4.3.6", "", {}, "sha512-rftlrkhHZOcjDwkGlnUtZZkvaPHCsDATp4pGpuOOMDaTdDDXF91wuVDJoWoPsKX/3YPQ5fHuF3STjcYyKr+Qhg=="],
+
+    "ink/ws": ["ws@8.19.0", "", { "peerDependencies": { "bufferutil": "^4.0.1", "utf-8-validate": ">=5.0.2" }, "optionalPeers": ["bufferutil", "utf-8-validate"] }, "sha512-blAT2mjOEIi0ZzruJfIhb3nps74PRWTCz1IjglWEEpQl5XS/UNama6u2/rjFkDDouqr4L67ry+1aGIALViWjDg=="],
+
+    "wrap-ansi/string-width": ["string-width@7.2.0", "", { "dependencies": { "emoji-regex": "^10.3.0", "get-east-asian-width": "^1.0.0", "strip-ansi": "^7.1.0" } }, "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ=="],
+  }
+}

package/bunfig.toml

@@ -0,0 +1,11 @@
+# Bun Test Configuration
+
+[test]
+# Global test timeout: 30 seconds per test (unit/integration)
+# This prevents individual tests from hanging indefinitely
+timeout = 30000
+
+# Exclude nax dogfood feature directories (contain acceptance tests from nax runs, not source tests)
+exclude = ["nax/**"]
+
+# Note: E2E tests may override this with longer timeouts using test options

package/docs/20260216-fix-plan-context-review.md

@@ -0,0 +1,56 @@
+# Fix Plan: Context Builder Review Findings
+**Date:** 2026-02-16
+**Branch:** main (local commits only)
+
+## Phase 1: DRY + Token Estimation + Dead Config
+
+### Fix 1: Extract context building helper in runner.ts
+**File:** `src/execution/runner.ts`
+**Impact:** Code duplication between TDD and single-session paths
+**Change:** Extract the duplicated 8-line context building block (build + log) into a helper function like `maybeGetContext(story, config, useContext)` that returns `string | undefined`. Call it from both TDD and single-session branches.
+
+### Fix 2: Token estimation ratio
+**File:** `src/context/builder.ts`
+**Impact:** Budget underestimates for code (1:4 is too generous; code averages closer to 1:3)
+**Change:** Change `estimateTokens()` from `Math.ceil(text.length / 4)` to `Math.ceil(text.length / 3)`. Update any test assertions that check specific token counts.
+
+### Fix 3: Remove dead config paths
+**File:** `src/context/types.ts`, `src/context/builder.ts`, `src/execution/runner.ts`
+**Impact:** `includeConfig` and `includeDependencies` in `ContextBuilderConfig` are set but never read in `buildContext()`
+**Change:** Remove `includeConfig` and `includeDependencies` from `ContextBuilderConfig`. Remove them from the config object in `buildStoryContext()`. If dependencies should be used, wire them — otherwise remove the dead path. The `dependency` type in `ContextElement` can stay for future use.
+
+## Phase 2: Wire UserStory fields for real context
+
+### Fix 4: Add optional context fields to UserStory
+**File:** `src/prd/types.ts`
+**Change:** Add to `UserStory` interface:
+```ts
+/** Relevant source files for context injection */
+relevantFiles?: string[];
+/** Prior error messages from failed attempts */
+priorErrors?: string[];
+/** Custom context strings */
+customContext?: string[];
+```
+
+### Fix 5: Wire UserStory fields into buildStoryContext
+**File:** `src/execution/runner.ts`
+**Change:** Replace the hardcoded empty arrays in `buildStoryContext()` with actual values from `story`:
+```ts
+relevantFiles: story.relevantFiles || [],
+priorErrors: story.priorErrors,
+customContext: story.customContext,
+```
+
+### Fix 6: Populate priorErrors on retry
+**File:** `src/execution/runner.ts`
+**Change:** When a story fails and gets retried (escalation), capture the error/failure reason and push it to `story.priorErrors` so the next attempt gets context about what went wrong.
+
+## Test Strategy
+- Mode: test-after
+- Run: `bun test` after each phase
+- Update existing assertions in `test/context.test.ts` and `test/context-integration.test.ts` for token ratio change
+
+## Commits
+- Phase 1: `refactor: DRY context helper, fix token estimation, remove dead config`
+- Phase 2: `feat: wire UserStory context fields into context builder`

package/docs/20260216-relentless-vs-ngent-comparison.md

@@ -0,0 +1,208 @@
+# Relentless vs ngent — Architecture Comparison & Port Recommendations
+
+**Date:** 2026-02-16
+**Relentless version:** v0.8.0 (~18,872 LOC src, 72 source files)
+**ngent version:** v0.1 (~2,799 LOC src, 33 source files)
+
+## Executive Summary
+
+Relentless is a mature, feature-rich orchestrator with 6 agent adapters, a sophisticated routing system, and a polished TUI. ngent is a focused proof-of-concept with stronger TDD enforcement and simpler architecture. Rather than trying to match Relentless feature-for-feature, ngent should **selectively port the highest-impact features** while preserving its architectural advantages.
+
+**Bottom line:** Port 5 features from Relentless. Skip 4. Keep 3 ngent strengths.
+
+---
+
+## Feature-by-Feature Comparison
+
+### 1. Agent Adapters
+
+| | Relentless | ngent |
+|:---|:---|:---|
+| **Agents** | 6 (Claude, Codex, Droid, OpenCode, Amp, Gemini) | 1 (Claude Code) |
+| **LOC** | ~1,800 across 8 files | ~180 in 1 file |
+| **Rate limit detection** | Yes (per-agent patterns) | No |
+| **Cross-agent fallback** | Yes (cascade system) | No |
+
+**Verdict:** ngent's single-agent focus is correct for v0.2. Multi-agent only matters when rate-limited or cost-optimizing with free models. **Port rate limit detection only** — cross-agent fallback is premature.
+
+### 2. Routing & Classification
+
+| | Relentless | ngent |
+|:---|:---|:---|
+| **Model matrix** | 4x4 (free/cheap/good/genius x simple/medium/complex/expert) | 2-tier (haiku/sonnet) |
+| **Classifier** | Hybrid (regex heuristic + LLM fallback at <0.8 confidence) | Tag-based + complexity field |
+| **Confidence scoring** | Yes (0.0-1.0) | No |
+| **Cost estimation** | Per-model token estimates | Per-tier fixed estimates |
+
+**Verdict:** The 4-mode matrix is overkill for Claude-only. But **expanding to 3 tiers** (haiku/sonnet/opus) with the hybrid classifier approach would improve routing accuracy. The confidence-based LLM fallback is clever — worth porting.
+
+### 3. Cascade & Escalation
+
+| | Relentless | ngent |
+|:---|:---|:---|
+| **Escalation path** | Configurable chain (e.g., haiku -> sonnet -> opus) | Simple tier bump |
+| **Per-attempt cost tracking** | Yes (Zod schema, actual cost per step) | Partial (estimates only) |
+| **Blocked detection** | Yes (marks stories as blocked with reason) | No |
+| **Max attempts** | Configurable | Hardcoded (3) |
+
+**Verdict:** ngent already has basic escalation. **Port per-attempt cost tracking and blocked detection.** Configurable max attempts is a quick win.
+
+### 4. Context Optimization
+
+| | Relentless | ngent |
+|:---|:---|:---|
+| **Approach** | Extract current story + dependencies from tasks.md | Token-budgeted element builder |
+| **LOC** | 417 (single file, focused) | 276 (builder.ts) + integration |
+| **Story extraction** | Regex-based section parsing from tasks.md | Generic element types (file/config/error/custom) |
+| **Checklist filtering** | Tag-based ([US-XXX], [Constitution], [Edge Case]) | Not implemented |
+| **Progress summary** | Auto-generated ("5/18 stories complete") | Not implemented |
+| **Token savings claim** | ~84% | Not measured yet |
+
+**Verdict:** Relentless's context builder is more practical — it works with the actual tasks.md format. ngent's is more generic but currently inert (relevantFiles empty until PRD populates them). **Port the story extraction approach** — parse the PRD/tasks to inject only the current story + dependencies into each session prompt. This is the #1 cost saver.
+
+### 5. Queue & Mid-Run Control
+
+| | Relentless | ngent |
+|:---|:---|:---|
+| **Queue file** | Custom format with commands | `.queue.txt` with cursor marker |
+| **Commands** | PAUSE, ABORT, SKIP, RETRY | None (read-only) |
+| **File locking** | Yes (lock.ts) | No |
+| **Hot reload** | Yes (watches file changes) | Yes (reads between stories) |
+
+**Verdict:** PAUSE/ABORT/SKIP are essential for production use. **Port queue commands.** File locking is nice-to-have.
+
+### 6. Review System
+
+| | Relentless | ngent |
+|:---|:---|:---|
+| **Post-run review** | 6 micro-tasks (typecheck, lint, test, security, quality, docs) | None |
+| **Review prompts** | Templated per task type | N/A |
+| **Review runner** | Dedicated (337 LOC) | N/A |
+
+**Verdict:** The 6-phase review is valuable for production but heavy for POC stage. **Port a simplified 3-phase version** (typecheck, test, lint) for v0.3. Security/quality/docs can wait.
+
+### 7. TUI
+
+| | Relentless | ngent |
+|:---|:---|:---|
+| **Framework** | Ink (React for CLI) with 3-column layout | Console.log |
+| **LOC** | ~2,000+ (App.tsx, components/, layouts/, hooks/) | 0 |
+| **Live cost tracking** | Yes | No |
+| **Story progress** | Visual grid | Text output |
+
+**Verdict:** Ink TUI is polished but massive investment. **Skip for v0.2.** ngent's planned `node-pty` supervised mode serves the same need with less code. Consider a minimal progress display (single-line status updates) instead.
+
+### 8. Configuration
+
+| | Relentless | ngent |
+|:---|:---|:---|
+| **Schema** | Zod with full validation | Zod with validation |
+| **Constitution** | Versioned constitution system | Not implemented |
+| **Init wizard** | Interactive `init` command | Not implemented |
+
+**Verdict:** Constitution system is interesting but not critical. **Skip for v0.2.**
+
+---
+
+## ngent Advantages to Preserve
+
+### 1. Three-Session TDD (Architectural Enforcement)
+Relentless uses prompt-based TDD ("write tests first, then implement"). ngent uses **session isolation** — separate Claude Code sessions for test writer, implementer, and verifier with git-diff verification. This is architecturally stronger and prevents the "AI writes tests that match its planned implementation" problem.
+
+**Keep and strengthen.** This is ngent's #1 differentiator.
+
+### 2. Actual Cost Tracking
+ngent tracks real API costs from Claude Code's output. Relentless estimates costs from token counts. Actual > estimated.
+
+**Keep.** Extend with per-attempt tracking (from Relentless).
+
+### 3. Simplicity (2.8K vs 18.9K LOC)
+ngent is 6.7x smaller. Easier to understand, modify, and debug. Every feature port should be evaluated against complexity cost.
+
+**Keep.** Resist feature bloat. Each port must earn its LOC.
+
+---
+
+## Port Recommendations (Prioritized)
+
+### P0 — Do in v0.2 (High Impact, Moderate Effort)
+
+| # | Feature | Source | Est. LOC | Impact |
+|:---|:---|:---|:---|:---|
+| 1 | **Story-scoped context extraction** | `execution/context-builder.ts` | ~200 | #1 cost saver (~84% token reduction per session) |
+| 2 | **Queue commands (PAUSE/ABORT/SKIP)** | `queue/processor.ts`, `queue/parser.ts` | ~150 | Essential for production mid-run control |
+| 3 | **3-tier model routing** (haiku/sonnet/opus) | `routing/router.ts` | ~80 | Better cost optimization, already partially exists |
+
+### P1 — Do in v0.3 (Medium Impact)
+
+| # | Feature | Source | Est. LOC | Impact |
+|:---|:---|:---|:---|:---|
+| 4 | **Per-attempt cost tracking** | `routing/cascade.ts` | ~100 | Better cost visibility, debugging |
+| 5 | **Hybrid classifier** (regex + LLM fallback) | `routing/classifier.ts` | ~150 | More accurate complexity routing |
+| 6 | **Simplified review phase** (typecheck + test + lint) | `review/runner.ts`, `review/tasks/` | ~200 | Quality gate before marking story complete |
+| 7 | **Blocked story detection** | `routing/cascade.ts` | ~50 | Avoid infinite retry loops |
+
+### P2 — Consider for v0.4+ (Lower Priority)
+
+| # | Feature | Source | Reason to Defer |
+|:---|:---|:---|:---|
+| 8 | Multi-agent adapters | `agents/*.ts` | Only useful when rate-limited or using free models |
+| 9 | Ink TUI | `tui/` | ~2K LOC investment, node-pty serves similar need |
+| 10 | Constitution system | `config/` | Nice-to-have, not a blocker |
+| 11 | Init wizard | `init/` | One-time convenience, low ROI |
+
+### Skip Entirely
+
+| Feature | Reason |
+|:---|:---|
+| Cross-agent fallback | Claude-only for foreseeable future |
+| File locking for queue | Single-instance execution = no contention |
+| 4x4 mode-model matrix | Overkill for 1 agent; 3-tier sufficient |
+
+---
+
+## v0.2 Implementation Plan (from P0 items)
+
+### Phase 1: Story-Scoped Context (~200 LOC)
+Replace the generic context builder with Relentless-style story extraction:
+- Parse PRD to get current story + dependency stories
+- Inject only those sections into session prompt
+- Add progress summary ("Story 5/12, 4 passed")
+- Wire into both single-session and TDD paths
+
+### Phase 2: Queue Commands (~150 LOC)
+Extend `.queue.txt` parser:
+- `PAUSE` — pause after current story completes
+- `ABORT` — stop immediately, mark remaining as skipped
+- `SKIP US-XXX` — skip a specific story
+- Check queue between stories (existing hook point)
+
+### Phase 3: 3-Tier Model Routing (~80 LOC)
+Extend existing config:
+- Add `opus` tier for expert-complexity stories
+- Update router to support 3 tiers
+- Keep backward compat with existing 2-tier configs
+
+**Estimated total: ~430 LOC added to ngent (15% growth)**
+
+---
+
+## Metrics Comparison (12-Story Benchmark)
+
+| Metric | Relentless (estimated*) | ngent v0.1 | ngent v0.2 (projected) |
+|:---|:---|:---|:---|
+| Session overhead | ~2-3 min (context optimization) | ~9 min (full context per session) | ~3-4 min (story-scoped) |
+| Cost (12 stories) | ~$0.40-0.60* | $1.17 | ~$0.50-0.70 |
+| Test coverage | Prompt-based TDD | Session-isolated TDD | Session-isolated TDD |
+| Mid-run control | PAUSE/ABORT/SKIP/RETRY | None | PAUSE/ABORT/SKIP |
+| Review phase | 6 micro-tasks | None | None (P1 for v0.3) |
+
+*Relentless estimates based on context optimization claims and architecture analysis; no direct benchmark run.
+
+---
+
+## Conclusion
+
+ngent v0.2 should focus on the **three P0 features** (context extraction, queue commands, 3-tier routing) which together address the two biggest pain points from benchmarking: **session cost** and **lack of mid-run control**. Combined with the existing TDD enforcement advantage, this would make ngent competitive with Relentless for our use case while staying at ~3.2K LOC (vs 18.9K).
+
+The key insight: **don't try to be Relentless.** Port the ideas, not the code. ngent's value is in being opinionated and simple — a tool that does one thing well (orchestrate Claude Code with TDD) rather than a platform that supports everything.

package/docs/20260216-v02-plan.md

@@ -0,0 +1,136 @@
+# ngent v0.2 Implementation Plan
+**Date:** 2026-02-16
+**Branch:** master (local commits only)
+
+## Overview
+4 features, 4 phases. ~530 LOC total. Each phase is self-contained.
+
+## Phase 1: Story-Scoped Context Extraction (~200 LOC)
+
+Replace the generic token-budgeted context builder with PRD-aware story extraction.
+
+### Changes:
+**`src/context/builder.ts`** — Rewrite `buildContext()`:
+- Accept the full PRD + current story ID
+- Extract only: current story description + AC + dependency stories from PRD
+- Add progress summary line: "Progress: 5/12 stories complete (4 passed, 1 failed)"
+- Keep token budget enforcement but feed it story-scoped content instead of file reads
+- Remove `readFileSafe` and file-based context (not used in practice)
+
+**`src/context/types.ts`** — Simplify:
+- `StoryContext` should accept `PRD` + `currentStoryId` instead of `relevantFiles[]`
+- Keep `BuiltContext` and `ContextBudget` as-is
+- Remove `ContextBuilderConfig` (over-engineered for what we need)
+
+**`src/execution/runner.ts`** — Update `maybeGetContext()`:
+- Pass the loaded PRD + current story to the new builder
+- Remove the `ContextBuilderConfig` construction
+
+**`test/context.test.ts`** + **`test/context-integration.test.ts`** — Update tests:
+- Test story extraction from a sample PRD
+- Test dependency story inclusion
+- Test progress summary generation
+- Remove file-read tests
+
+**Run:** `bun test`
+**Commit:** `feat(context): story-scoped extraction from PRD`
+
+## Phase 2: Queue Commands — PAUSE/ABORT/SKIP (~150 LOC)
+
+Add mid-run control commands to `.queue.txt`.
+
+### Changes:
+**`src/queue/types.ts`** — Add:
+```ts
+export type QueueCommand = "PAUSE" | "ABORT" | { type: "SKIP"; storyId: string };
+export interface QueueFileResult {
+  commands: QueueCommand[];
+  guidance: string[];  // Non-command lines (existing behavior)
+}
+```
+
+**`src/queue/manager.ts`** — Add `parseQueueFile(content: string): QueueFileResult`:
+- Parse lines: `PAUSE`, `ABORT`, `SKIP US-XXX` are commands
+- Everything else after `--- PENDING ---` is guidance (existing behavior)
+- Commands are case-insensitive
+- Return both commands and guidance
+
+**`src/execution/runner.ts`** — Check queue between stories:
+- After each story completes, read `.queue.txt` and parse
+- `PAUSE` → log "⏸️ Paused by user", break loop, return partial results
+- `ABORT` → mark remaining stories as skipped, break loop
+- `SKIP US-XXX` → set that story's status to "skipped", continue
+- Clear processed commands from `.queue.txt` after handling
+
+**`test/queue.test.ts`** — Add tests:
+- Parse PAUSE, ABORT, SKIP commands
+- Mixed commands + guidance text
+- Case insensitivity
+- Integration: runner respects PAUSE/ABORT/SKIP
+
+**Run:** `bun test`
+**Commit:** `feat(queue): add PAUSE/ABORT/SKIP commands`
+
+## Phase 3: 3-Tier Model Routing (~80 LOC)
+
+The config already has 3 tiers (fast/balanced/powerful). The router maps complexity→tier correctly. What's missing: the escalation path should support all 3 tiers explicitly, and the `escalateModelTier()` function in runner.ts needs to handle the full chain.
+
+### Changes:
+**`src/execution/runner.ts`** — Fix `escalateModelTier()`:
+- Current: simple tier bump that may not cover all tiers
+- New: explicit chain `fast → balanced → powerful → null` (null = max reached)
+- Log the escalation with tier names
+
+**`src/config/schema.ts`** — Add validation:
+- Ensure `complexityRouting` values are valid `ModelTier` keys
+- Ensure escalation `maxAttempts` >= 1
+
+**`test/routing.test.ts`** — Add tests:
+- Verify all 4 complexities route to correct tiers
+- Verify escalation chain: fast→balanced→powerful→null
+- Verify config validation catches invalid tiers
+
+**Run:** `bun test`
+**Commit:** `feat(routing): explicit 3-tier escalation chain`
+
+## Phase 4: Story Batching (~100 LOC)
+
+Group consecutive simple-complexity stories into a single agent session to reduce startup overhead.
+
+### Changes:
+**`src/execution/runner.ts`** — Add batching logic:
+- Before the main loop, scan pending stories
+- Group consecutive simple stories into batches (max 4 per batch)
+- For batched stories: build a combined prompt with all stories
+- Execute batch in a single session, parse results per-story
+- Non-simple stories execute individually (existing behavior)
+- Add `--no-batch` CLI flag to disable
+
+**`bin/ngent.ts`** — Add `--no-batch` flag
+
+**`src/execution/runner.ts`** — Add `buildBatchPrompt(stories: UserStory[]): string`:
+- Combine multiple stories into one prompt
+- Number each story clearly: "## Story 1: ...", "## Story 2: ..."
+- Instruct agent to commit each story separately
+
+**`test/runner.test.ts`** — Add tests:
+- Batch grouping logic (consecutive simple stories)
+- Mixed complexity stops batching
+- Max batch size enforcement
+- Batch prompt generation
+
+**Run:** `bun test`
+**Commit:** `feat(execution): story batching for simple stories`
+
+## Test Strategy
+- Mode: hybrid
+- TDD targets: Phase 2 (queue commands — new public API, write tests first)
+- Test-after targets: Phase 1, 3, 4 (extending existing tested modules)
+
+## Summary
+| Phase | Feature | Est. LOC | Strategy |
+|:---|:---|:---|:---|
+| 1 | Story-scoped context | ~200 | test-after |
+| 2 | Queue commands | ~150 | test-first |
+| 3 | 3-tier escalation | ~80 | test-after |
+| 4 | Story batching | ~100 | test-after |