@navels/neal 0.6.4 → 0.6.6

package/dist/neal/context/inline-review-context.js

@@ -180,7 +180,7 @@ export function renderInlinedRangeDiffSection(args) {
     return [
         `## Inlined commit-range diff from Neal (${args.rangeLabel})`,
         '',
-        'You have read-only repository tools (read and search, no shell) but no commit-range diff tool, so Neal has inlined the commit-range diff below.',
+        'You have read-only repository access but no commit-range diff tool, so Neal has inlined the commit-range diff below. That access may be dedicated read and search tools, or a shell running in a read-only sandbox; if it is a shell, use it only to read files and search the tree, never to write.',
         'This inlined diff is the source of truth for exactly what this range changed, including deletions and renames that head-state file reads cannot reveal. Use your read tools to verify the surrounding code.',
         '',
         args.diff.trim() === '' ? '(empty diff)' : truncateInlineSectionBody(args.diff),

package/dist/neal/prompts/review-doctrine.js

@@ -23,7 +23,7 @@ export function getCodeReviewFalsificationLines(context) {
             : `Review that ${context.rangeLabel} directly with repository tools. The ${context.rangeLabel} is the source of truth for this review.`);
     }
     if (mode === 'read-only') {
-        lines.push('A diff shows only changed hunks; declarations such as imports, struct fields, or helpers may exist in unchanged parts of the file. Absence from the diff is not evidence of absence from the repository — open the affected file with your read tools and verify before claiming a missing import or missing declaration.');
+        lines.push('A diff shows only changed hunks; declarations such as imports, struct fields, or helpers may exist in unchanged parts of the file. Absence from the diff is not evidence of absence from the repository — open the affected file with your read tools and verify before claiming a missing import or missing declaration.', 'Your read tools may be dedicated read and search tools, or a shell running in a read-only sandbox. If your only repository tool is that shell, use it to read files and search the tree (for example cat, sed -n, grep, ls); it cannot write, and you must not try to.');
     }
     if (context.gitInspectionExamples) {
         if (mode === 'tool-access') {

package/dist/neal/prompts/specs.js

@@ -406,7 +406,7 @@ export const PROMPT_SPECS = [
     },
     {
         id: 'scope_reviewer',
-        version: 5,
+        version: 6,
         changelog: [
             {
                 version: 1,
@@ -428,6 +428,10 @@ export const PROMPT_SPECS = [
                 version: 5,
                 renderSha: 'e8dcb976d0ea22e9026e09a87d7dde93c8513334f62ad89472ebefe91771754b',
             },
+            {
+                version: 6,
+                renderSha: 'ed8d66b768a869817ff4c6b3d127b0f6f3958dff3cf57e036cc27c21800201a4',
+            },
         ],
         role: 'reviewer',
         purpose: 'Review execute-scope results for correctness, verification coverage, and meaningful progress toward the active parent objective.',
@@ -584,7 +588,7 @@ export const PROMPT_SPECS = [
     },
     {
         id: 'completion_reviewer',
-        version: 5,
+        version: 6,
         changelog: [
             {
                 version: 1,
@@ -606,6 +610,10 @@ export const PROMPT_SPECS = [
                 version: 5,
                 renderSha: '7930cec95560ad880bba94a7ae48e68c621805787261e295c4c405d09235c87b',
             },
+            {
+                version: 6,
+                renderSha: '079a57a685c33aaba5b9a6b919ed4cb961a79f89e770ed6ede85020b618addd6',
+            },
         ],
         role: 'reviewer',
         purpose: 'Judge whole-plan completion and decide whether Neal should accept completion, continue execution, or block for operator input.',

package/dist/neal/review-findings/prompts.js

@@ -57,7 +57,7 @@ export function buildReviewFindingsInlinedDiffSection(context) {
     return [
         '## Inlined Selected-Range Diff',
         '',
-        'You have read-only repository tools (read and search, no shell) but no commit-range diff tool, so the full selected-range diff is inlined below.',
+        'You have read-only repository access but no commit-range diff tool, so the full selected-range diff is inlined below. That access may be dedicated read and search tools, or a shell running in a read-only sandbox; if it is a shell, use it only to read files and search the tree, never to write.',
         'This inlined diff is the source of truth for what the resolved range actually changed, including deletions and renames that head-state file reads cannot reveal.',
         `Resolved range: ${context.externalBaseCommit}..${context.externalHeadCommit}.`,
         'Verify draft claims against the surrounding code with your read tools; absence from a diff hunk is not evidence of absence from the repository.',

package/docs/compat.md

@@ -53,6 +53,9 @@ neal compat [--model <slug>] [--role coder|reviewer|planner|all] [--reference op
 
 - `--role` (default `all`) selects which role(s) to test: `coder`, `reviewer`,
   `planner`, or `all`.
+- With no flags at all, every role runs on your configured provider and model,
+  which is how to verify a native slug (`openai-codex` or `anthropic-claude`);
+  `--model` always routes the candidate to `openai-compatible`.
 - `--model <slug>` runs the slug on the **`openai-compatible`** provider in the
   candidate role (provider forced to `openai-compatible`, any configured effort
   dropped, so the slug drives a clean OpenRouter call). When omitted, the

package/docs/compatible-models.md

@@ -156,6 +156,24 @@ don't support tool use.
 | `openai-codex` | supported | supported | supported |
 | `anthropic-claude` | supported | supported | supported |
 
+### Native model slugs run through the fixtures
+
+The adapters above are supported by construction. A row here means a specific
+slug has also been run through `neal compat`. To add one, put the slug in your
+config and run `neal compat` with no flags: every role then runs on your
+configured provider and model (`--model` always routes to `openai-compatible`,
+so it can't test a native slug). Cells are passed/total, same as the whitelist.
+
+| Slug | Provider | Coder | Reviewer | Planner | Run |
+| --- | --- | --- | --- | --- | --- |
+| `claude-fable-5-1` | `anthropic-claude` | 2/2 | not run | 1/1 | 2026-09-04 |
+| `gpt-6-astra` | `openai-codex` | not run | 2/2 pairs | not run | 2026-09-04 |
+
+`gpt-6-astra` as reviewer needs the read-only doctrine wording from #57. Before
+that, the doctrine told a Codex reviewer it had no shell, and Astra took it at
+its word and blocked every reviewer fixture for lack of a read tool; with the
+wording fixed it passed 4/4.
+
 ## Reproducing / extending
 
 ```

package/docs/maintenance.md

@@ -52,7 +52,9 @@ is gated on it as a whole.
    opens and merges the release-preparation PR (version bump + changelog), and
    runs the Publish workflow through the npm 2FA approval. See
    [docs/release.md](release.md). Urgent bumps (a fix neal needs immediately)
-   may skip the Renovate soak with a manual PR. Qualify them the same way.
+   may skip the Renovate soak with a manual PR: `scripts/bump-native-sdks.sh`
+   opens one at the current latest releases. Qualify it the same way. Leave
+   Renovate's own SDK PR open; it closes itself once the manual bump merges.
 
 ## TypeScript 6 and 7 side by side
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@navels/neal",
-  "version": "0.6.4",
+  "version": "0.6.6",
   "description": "A source-first multi-agent CLI for planning, executing, reviewing, and resuming scoped code changes.",
   "license": "MIT",
   "publishConfig": {
@@ -56,8 +56,8 @@
   },
   "dependencies": {
     "@ai-sdk/openai-compatible": "3.0.39",
-    "@anthropic-ai/claude-agent-sdk": "0.3.252",
-    "@openai/codex-sdk": "0.151.0",
+    "@anthropic-ai/claude-agent-sdk": "0.3.260",
+    "@openai/codex-sdk": "0.153.2",
     "ai": "7.0.83",
     "dotenv": "^17.4.2",
     "yaml": "^2.9.0",