@xn-intenton-z2a/agentic-lib 7.1.60 → 7.1.62

package/.github/workflows/agentic-lib-bot.yml

@@ -11,9 +11,9 @@
 
 name: agentic-lib-bot
 run-name: "agentic-lib-bot [${{ github.ref_name }}]"
-#concurrency:
-#  group: agentic-lib-bot-${{ github.event.discussion.node_id || github.run_id }}
-#  cancel-in-progress: false
+#@dist concurrency:
+#@dist   group: agentic-lib-bot-${{ github.event.discussion.node_id || github.run_id }}
+#@dist   cancel-in-progress: false
 
 on:
   #@dist discussion:
@@ -86,12 +86,15 @@ jobs:
   respond:
     needs: params
     runs-on: ubuntu-latest
+    outputs:
+      action: ${{ steps.respond.outputs.action }}
+      action-arg: ${{ steps.respond.outputs.action-arg }}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           node-version: "24"
 
@@ -103,9 +106,32 @@ jobs:
         working-directory: .github/agentic-lib/actions/agentic-step
         run: npm ci
 
+      - name: Read test command from config
+        id: config
+        shell: bash
+        run: |
+          if [ -f agentic-lib.toml ]; then
+            TEST_CMD=$(grep '^\s*test\s*=' agentic-lib.toml | head -1 | sed 's/.*=\s*"\([^"]*\)".*/\1/')
+          fi
+          echo "test-command=${TEST_CMD:-npm ci && npm test}" >> $GITHUB_OUTPUT
+
+      - name: Run tests before responding
+        id: tests
+        shell: bash
+        run: |
+          set +e
+          ${{ steps.config.outputs.test-command }}
+          EXIT_CODE=$?
+          set -e
+          if [ $EXIT_CODE -eq 0 ]; then
+            echo "result=pass" >> $GITHUB_OUTPUT
+          else
+            echo "result=fail" >> $GITHUB_OUTPUT
+          fi
+
       - name: Get discussion URL
         id: discussion-url
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           script: |
             let url = '${{ inputs.discussion-url }}' || '';
@@ -114,15 +140,42 @@ jobs:
             }
             core.setOutput('url', url);
 
+      - name: Skip if comment is from bot
+        id: guard
+        shell: bash
+        run: |
+          COMMENT_USER='${{ github.event.comment.user.login }}'
+          if [ "$COMMENT_USER" = "github-actions[bot]" ] || [ "$COMMENT_USER" = "github-actions" ]; then
+            echo "Bot comment detected — skipping to avoid self-reply loop"
+            echo "skip=true" >> $GITHUB_OUTPUT
+          fi
+
       - name: Respond to discussion
-        if: steps.discussion-url.outputs.url != ''
+        id: respond
+        if: steps.discussion-url.outputs.url != '' && steps.guard.outputs.skip != 'true'
         uses: ./.github/agentic-lib/actions/agentic-step
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
+          TEST_RESULT: ${{ steps.tests.outputs.result }}
         with:
           task: "discussions"
           config: ${{ env.configPath }}
           instructions: ".github/agentic-lib/agents/agent-discussion-bot.md"
           discussion-url: ${{ steps.discussion-url.outputs.url }}
           model: ${{ needs.params.outputs.model }}
+
+  dispatch-supervisor:
+    needs: [params, respond]
+    if: github.repository != 'xn-intenton-z2a/agentic-lib' && needs.respond.outputs.action == 'request-supervisor'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Dispatch supervisor workflow
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          gh workflow run agentic-lib-workflow.yml \
+            --repo "${{ github.repository }}" \
+            -f mode=full \
+            -f model="${{ needs.params.outputs.model }}" \
+            -f message="${{ needs.respond.outputs.action-arg }}"

package/.github/workflows/agentic-lib-init.yml

@@ -141,20 +141,20 @@ jobs:
       INIT_MISSION_SEED: ${{ needs.params.outputs.mission-seed }}
       INIT_MISSION_TEXT: ${{ needs.params.outputs.mission-text }}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         if: needs.params.outputs.dry-run == 'true'
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         if: needs.params.outputs.dry-run != 'true'
         with:
           ref: main
           token: ${{ secrets.WORKFLOW_TOKEN }}
 
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           node-version: "24"
 
       - name: Close hanging init PRs
-        if: env.INIT_MODE == 'purge' && needs.params.outputs.dry-run != 'true'
+        if: github.repository != 'xn-intenton-z2a/agentic-lib' && env.INIT_MODE == 'purge' && needs.params.outputs.dry-run != 'true'
         env:
           GH_TOKEN: ${{ secrets.WORKFLOW_TOKEN }}
         run: |
@@ -203,8 +203,8 @@ jobs:
       - run: npm test
 
       - name: Update schedule (if requested)
-        if: needs.params.outputs.schedule != '' && needs.params.outputs.dry-run != 'true'
-        uses: actions/github-script@v7
+        if: github.repository != 'xn-intenton-z2a/agentic-lib' && needs.params.outputs.schedule != '' && needs.params.outputs.dry-run != 'true'
+        uses: actions/github-script@v8
         with:
           script: |
             const fs = require('fs');
@@ -255,7 +255,7 @@ jobs:
             }
 
       - name: Commit and push to main [skip ci]
-        if: needs.params.outputs.dry-run != 'true'
+        if: github.repository != 'xn-intenton-z2a/agentic-lib' && needs.params.outputs.dry-run != 'true'
         env:
           GH_TOKEN: ${{ secrets.WORKFLOW_TOKEN }}
         run: |

package/.github/workflows/agentic-lib-schedule.yml

@@ -61,16 +61,16 @@ jobs:
   update-schedule:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         if: inputs.dry-run == 'true' || inputs.dry-run == true
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         if: inputs.dry-run != 'true' && inputs.dry-run != true
         with:
           ref: main
           token: ${{ secrets.WORKFLOW_TOKEN }}
 
       - name: Update workflow schedule and model
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           script: |
             const fs = require('fs');
@@ -146,7 +146,7 @@ jobs:
             }
 
       - name: Commit and push
-        if: inputs.dry-run != 'true' && inputs.dry-run != true
+        if: github.repository != 'xn-intenton-z2a/agentic-lib' && inputs.dry-run != 'true' && inputs.dry-run != true
         env:
           GH_TOKEN: ${{ secrets.WORKFLOW_TOKEN }}
         run: |

package/.github/workflows/agentic-lib-test.yml

@@ -23,17 +23,25 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           node-version: 24
           cache: "npm"
 
-      - run: npm ci
+      - name: Read test command from config
+        id: config
+        shell: bash
+        run: |
+          if [ -f agentic-lib.toml ]; then
+            TEST_CMD=$(grep '^\s*test\s*=' agentic-lib.toml | head -1 | sed 's/.*=\s*"\([^"]*\)".*/\1/')
+          fi
+          echo "test-command=${TEST_CMD:-npm ci && npm test}" >> $GITHUB_OUTPUT
 
       - name: Install sub-project dependencies (agentic-lib dev only)
         if: hashFiles('src/actions/agentic-step/package.json') != ''
         run: cd src/actions/agentic-step && npm ci
 
-      - run: npm test
+      - name: Run tests
+        run: ${{ steps.config.outputs.test-command }}

package/.github/workflows/agentic-lib-workflow.yml

@@ -125,7 +125,14 @@ jobs:
           PR='${{ inputs.pr-number }}'
           echo "pr-number=${PR}" >> $GITHUB_OUTPUT
           DRY_RUN='${{ inputs.dry-run }}'
-          echo "dry-run=${DRY_RUN:-true}" >> $GITHUB_OUTPUT
+          # Schedule triggers have no inputs, so DRY_RUN is empty.
+          # Default to false for schedule events (they should run live).
+          if [ "${{ github.event_name }}" = "schedule" ]; then
+            DRY_RUN="${DRY_RUN:-false}"
+          else
+            DRY_RUN="${DRY_RUN:-true}"
+          fi
+          echo "dry-run=${DRY_RUN}" >> $GITHUB_OUTPUT
           CONFIG='${{ inputs.config-path }}'
           echo "config-path=${CONFIG:-${{ env.configPath }}}" >> $GITHUB_OUTPUT
     outputs:
@@ -142,12 +149,12 @@ jobs:
   pr-cleanup:
     needs: params
     if: |
-      needs.params.outputs.dry-run != 'true' &&
-      (needs.params.outputs.mode == 'full' || needs.params.outputs.mode == 'pr-cleanup-only')
+      needs.params.outputs.mode == 'full' || needs.params.outputs.mode == 'pr-cleanup-only'
     runs-on: ubuntu-latest
     steps:
       - name: PR cleanup
-        uses: actions/github-script@v7
+        if: github.repository != 'xn-intenton-z2a/agentic-lib' && needs.params.outputs.dry-run != 'true'
+        uses: actions/github-script@v8
         with:
           script: |
             const owner = context.repo.owner;
@@ -214,14 +221,13 @@ jobs:
   telemetry:
     needs: params
     if: |
-      needs.params.outputs.dry-run != 'true' &&
-      (needs.params.outputs.mode == 'full' || needs.params.outputs.mode == 'dev-only' || needs.params.outputs.mode == 'review-only')
+      needs.params.outputs.mode == 'full' || needs.params.outputs.mode == 'dev-only' || needs.params.outputs.mode == 'review-only'
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - name: Gather telemetry
         id: gather
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           script: |
             const fs = require('fs');
@@ -292,14 +298,13 @@ jobs:
     needs: [params, pr-cleanup, telemetry]
     if: |
       always() &&
-      needs.params.outputs.dry-run != 'true' &&
       (needs.params.outputs.mode == 'full' || needs.params.outputs.mode == 'dev-only') &&
       needs.params.result == 'success'
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           node-version: "24"
 
@@ -312,6 +317,7 @@ jobs:
         run: npm ci
 
       - name: Run supervisor
+        if: github.repository != 'xn-intenton-z2a/agentic-lib'
         uses: ./.github/agentic-lib/actions/agentic-step
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -331,11 +337,22 @@ jobs:
       needs.params.result == 'success'
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
-      - uses: actions/setup-node@v4
+      - name: Check mission-complete signal
+        id: mission-check
+        run: |
+          if [ -f MISSION_COMPLETE.md ]; then
+            echo "mission-complete=true" >> $GITHUB_OUTPUT
+            echo "Mission is complete — skipping budget-consuming tasks"
+            cat MISSION_COMPLETE.md
+          else
+            echo "mission-complete=false" >> $GITHUB_OUTPUT
+          fi
+
+      - uses: actions/setup-node@v6
         with:
           node-version: "24"
 
@@ -358,6 +375,7 @@ jobs:
           echo "libraryWritablePaths=${LIBRARY};${SOURCES}" >> $GITHUB_OUTPUT
 
       - name: Maintain features
+        if: steps.mission-check.outputs.mission-complete != 'true'
         uses: ./.github/agentic-lib/actions/agentic-step
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -370,6 +388,7 @@ jobs:
           model: ${{ needs.params.outputs.model }}
 
       - name: Maintain library
+        if: steps.mission-check.outputs.mission-complete != 'true'
         uses: ./.github/agentic-lib/actions/agentic-step
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -382,7 +401,7 @@ jobs:
           model: ${{ needs.params.outputs.model }}
 
       - name: Commit and push changes
-        if: needs.params.outputs.dry-run != 'true'
+        if: github.repository != 'xn-intenton-z2a/agentic-lib' && needs.params.outputs.dry-run != 'true'
         uses: ./.github/agentic-lib/actions/commit-if-changed
         with:
           commit-message: "agentic-step: maintain features and library"
@@ -393,16 +412,15 @@ jobs:
     needs: [params, supervisor]
     if: |
       always() &&
-      needs.params.outputs.dry-run != 'true' &&
       needs.params.outputs.mode == 'full' &&
       needs.params.result == 'success'
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           node-version: "24"
 
@@ -417,8 +435,19 @@ jobs:
         working-directory: .github/agentic-lib/actions/agentic-step
         run: npm ci
 
+      - name: Check mission-complete signal
+        id: fix-mission-check
+        run: |
+          if [ -f MISSION_COMPLETE.md ]; then
+            echo "mission-complete=true" >> $GITHUB_OUTPUT
+            echo "Mission is complete — skipping fix-stuck"
+          else
+            echo "mission-complete=false" >> $GITHUB_OUTPUT
+          fi
+
       - name: Find and fix stuck PRs
-        uses: actions/github-script@v7
+        if: steps.fix-mission-check.outputs.mission-complete != 'true'
+        uses: actions/github-script@v8
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
@@ -478,14 +507,14 @@ jobs:
             }
 
       - name: Checkout PR branch
-        if: env.FIX_PR_NUMBER != ''
+        if: env.FIX_PR_NUMBER != '' && steps.fix-mission-check.outputs.mission-complete != 'true'
         run: |
           gh pr checkout ${{ env.FIX_PR_NUMBER }}
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
       - name: "Tier 1: Auto-resolve trivial merge conflicts"
-        if: env.FIX_PR_NUMBER != '' && env.FIX_REASON == 'merge conflicts'
+        if: env.FIX_PR_NUMBER != '' && env.FIX_REASON == 'merge conflicts' && steps.fix-mission-check.outputs.mission-complete != 'true'
         id: trivial-resolve
         run: |
           git fetch origin main
@@ -517,6 +546,7 @@ jobs:
       - name: "Tier 2: LLM fix (conflicts or failing checks)"
         if: |
           env.FIX_PR_NUMBER != '' &&
+          steps.fix-mission-check.outputs.mission-complete != 'true' &&
           (env.FIX_REASON != 'merge conflicts' ||
            steps.trivial-resolve.outputs.resolved == 'none')
         uses: ./.github/agentic-lib/actions/agentic-step
@@ -529,11 +559,11 @@ jobs:
           config: ${{ needs.params.outputs.config-path }}
           instructions: ".github/agentic-lib/agents/agent-apply-fix.md"
           pr-number: ${{ env.FIX_PR_NUMBER }}
-          test-command: "npm test"
+          # test-command read from [execution].test in agentic-lib.toml
           model: ${{ needs.params.outputs.model }}
 
       - name: Commit and push fixes
-        if: env.FIX_PR_NUMBER != ''
+        if: github.repository != 'xn-intenton-z2a/agentic-lib' && env.FIX_PR_NUMBER != '' && steps.fix-mission-check.outputs.mission-complete != 'true'
         uses: ./.github/agentic-lib/actions/commit-if-changed
         with:
           commit-message: "agentic-step: fix failing tests / resolve conflicts"
@@ -547,9 +577,9 @@ jobs:
       needs.params.result == 'success'
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           node-version: "24"
 
@@ -592,12 +622,12 @@ jobs:
       needs.params.result == 'success'
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
           token: ${{ secrets.GITHUB_TOKEN }}
 
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           node-version: "24"
 
@@ -626,9 +656,21 @@ jobs:
           DEPS=$(yq -r '.paths.dependenciesFilepath.path // "package.json"' "$CONFIG")
           echo "writablePaths=${SOURCE};${TESTS};${FEATURES};${DOCS};${LIBRARY};${SOURCES};${README};${DEPS}" >> $GITHUB_OUTPUT
 
+      - name: Check mission-complete signal
+        id: dev-mission-check
+        run: |
+          if [ -f MISSION_COMPLETE.md ]; then
+            echo "mission-complete=true" >> $GITHUB_OUTPUT
+            echo "Mission is complete — skipping dev transformation"
+            cat MISSION_COMPLETE.md
+          else
+            echo "mission-complete=false" >> $GITHUB_OUTPUT
+          fi
+
       - name: Find target issue
+        if: steps.dev-mission-check.outputs.mission-complete != 'true'
         id: issue
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           script: |
             const specificIssue = '${{ needs.params.outputs.issue-number }}';
@@ -668,21 +710,21 @@ jobs:
           task: "transform"
           config: ${{ needs.params.outputs.config-path }}
           instructions: ".github/agentic-lib/agents/agent-issue-resolution.md"
-          test-command: "npm test"
+          # test-command read from [execution].test in agentic-lib.toml
           model: ${{ needs.params.outputs.model }}
           issue-number: ${{ steps.issue.outputs.issue-number }}
           writable-paths: ${{ steps.config.outputs.writablePaths }}
 
       - name: Commit and push
-        if: steps.issue.outputs.issue-number != '' && needs.params.outputs.dry-run != 'true'
+        if: github.repository != 'xn-intenton-z2a/agentic-lib' && steps.issue.outputs.issue-number != '' && needs.params.outputs.dry-run != 'true'
         uses: ./.github/agentic-lib/actions/commit-if-changed
         with:
           commit-message: "agentic-step: transform issue #${{ steps.issue.outputs.issue-number }}"
           push-ref: ${{ steps.branch.outputs.branchName }}
 
       - name: Create PR and attempt merge
-        if: steps.issue.outputs.issue-number != '' && needs.params.outputs.dry-run != 'true'
-        uses: actions/github-script@v7
+        if: github.repository != 'xn-intenton-z2a/agentic-lib' && steps.issue.outputs.issue-number != '' && needs.params.outputs.dry-run != 'true'
+        uses: actions/github-script@v8
         with:
           script: |
             const owner = context.repo.owner;
@@ -774,7 +816,7 @@ jobs:
     if: always() && needs.params.result == 'success'
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
 

package/README.md

@@ -172,22 +172,37 @@ contributing = "CONTRIBUTING.md"
 library-sources = "SOURCES.md"
 
 [execution]
-build = "npm run build"
-test = "npm test"
-start = "npm run start"
+test = "npm ci && npm test"
 
 [limits]
-feature-issues = 2
-maintenance-issues = 1
-attempts-per-branch = 3
-attempts-per-issue = 2
+max-feature-issues = 2
+max-maintenance-issues = 1
+max-attempts-per-branch = 3
+max-attempts-per-issue = 2
 features-limit = 4
 library-limit = 32
 
+[tuning]
+profile = "recommended"       # min | recommended | max
+# model = "gpt-5-mini"        # override model per-profile
+# transformation-budget = 8   # max code-changing cycles per run
+
 [bot]
 log-file = "intentïon.md"
 ```
 
+### Tuning Profiles
+
+The `profile` setting controls all tuning defaults. Three profiles are built in:
+
+| Profile | Budget | Source scan | Issues | Best for |
+|---------|--------|-------------|--------|----------|
+| `min` | 4 cycles | 3 files, 1000 chars | 5, 14d stale | CI testing, quick validation |
+| `recommended` | 8 cycles | 10 files, 5000 chars | 20, 30d stale | Balanced cost/quality |
+| `max` | 32 cycles | 50 files, 20000 chars | 100, 90d stale | Complex missions |
+
+Override individual knobs in `[tuning]` to deviate from a profile. Limits (`[limits]`) also scale with the profile.
+
 The YAML config at `.github/agentic-lib/agents/agentic-lib.yml` is also supported as a fallback.
 
 ## The `agentic-step` Action
@@ -217,6 +232,7 @@ npx @xn-intenton-z2a/agentic-lib transform            # advance code toward the
 npx @xn-intenton-z2a/agentic-lib maintain-features     # generate feature files from mission
 npx @xn-intenton-z2a/agentic-lib maintain-library      # update library docs from SOURCES.md
 npx @xn-intenton-z2a/agentic-lib fix-code              # fix failing tests
+npx @xn-intenton-z2a/agentic-lib iterate               # run N cycles with budget tracking
 ```
 
 All task commands accept these flags:
@@ -226,6 +242,9 @@ All task commands accept these flags:
 | `--dry-run` | off | Show the prompt without calling the Copilot SDK |
 | `--target <path>` | current directory | Target repository to transform |
 | `--model <name>` | `claude-sonnet-4` | Copilot SDK model |
+| `--cycles <N>` | from budget | Max iteration cycles (iterate only) |
+| `--steps <list>` | all three | Comma-separated steps per cycle (iterate only) |
+| `--mission <name>` | hamming-distance | Init with --purge before iterating (iterate only) |
 
 ### Example: Full Walkthrough
 
@@ -278,6 +297,28 @@ Use `--dry-run` to see what prompt would be sent without calling the SDK:
 npx @xn-intenton-z2a/agentic-lib transform --dry-run
 ```
 
+### Iterator
+
+The `iterate` command runs multiple cycles of maintain → transform → fix with automatic stop conditions and budget tracking:
+
+```bash
+# Init a mission and iterate with default budget
+npx @xn-intenton-z2a/agentic-lib iterate --mission fizz-buzz --model gpt-5-mini
+
+# Run 4 cycles on an existing workspace
+npx @xn-intenton-z2a/agentic-lib iterate --cycles 4
+
+# Transform-only cycles (skip maintain)
+npx @xn-intenton-z2a/agentic-lib iterate --steps transform,fix-code --cycles 3
+```
+
+**Stop conditions:**
+- Tests pass for 2 consecutive cycles
+- No files change for 2 consecutive cycles
+- Transformation budget exhausted (configurable via `transformation-budget` in `agentic-lib.toml`)
+
+Each cycle logs `**agentic-lib transformation cost:** 1` to `intentïon.md` when source files change. The iterator reads these to track cumulative cost against the budget.
+
 ### Environment
 
 | Variable | Required | Purpose |
@@ -301,6 +342,8 @@ Built-in safety mechanisms:
 
 - **WIP limits** -- maximum concurrent issues to prevent runaway generation
 - **Attempt limits** -- maximum retries per branch and per issue
+- **Transformation budget** -- caps code-changing cycles per run (profile-scaled)
+- **Mission-complete signal** -- `MISSION_COMPLETE.md` gates budget-consuming jobs without LLM calls
 - **Path enforcement** -- writable and read-only path separation
 - **TDD mode** -- optionally require tests before implementation
 - **Mission protection** -- MISSION.md is read-only to the agent
@@ -331,7 +374,7 @@ src/
 
 ### Testing
 
-269 unit tests across 22 test files, plus system tests:
+393 unit tests across 26 test files, plus system tests:
 
 ```bash
 npm test                  # Run all tests (vitest)