@xn-intenton-z2a/agentic-lib 7.4.22 → 7.4.24

package/.github/agents/agent-issue-resolution.md

@@ -85,6 +85,8 @@ When writing both tests and implementation:
 **Both unit tests AND behaviour tests must pass.** The project runs `npm test` (unit tests) and
 `npm run test:behaviour` (Playwright). Both are gated — your changes must pass both.
 
+**Code coverage:** Aim for the coverage thresholds stated in the Constraints section of the prompt. Write tests that exercise the code paths you're adding or modifying.
+
 ### Test philosophy
 
 - **Unit tests** bind to the detail: exact return values, error types, edge cases, parameter validation.

package/.github/agents/agent-supervisor.md

@@ -68,7 +68,7 @@ If an **Implementation Review** section is present in the prompt, examine it car
 
 ## Priority Order
 
-1. **Always strive to close gaps** — every action you take should aim to satisfy the remaining NOT MET metrics. If the code is already complete (see Source Exports and Recently Closed Issues), use `nop` and let the director evaluate. Otherwise, create one comprehensive issue that targets the entire mission (all acceptance criteria, tests, website, docs, README). Only create a second issue if the first transform couldn't complete everything, and scope it to the remaining work. Do not create issues just to fill a quota.
+1. **Always strive to close gaps** — every action you take should aim to satisfy the remaining NOT MET metrics. If the code is already complete (see Source Exports and Recently Closed Issues), use `nop` and let the director evaluate. Otherwise, assess the full gap between current state and mission, then create as many distinct issues as needed to cover the entire gap. Ideally one comprehensive issue covering the whole gap, but if the work is naturally separable (e.g. different features, different layers), create multiple focused issues. Create up to the WIP limit. Each issue should be self-contained and independently deliverable.
 2. **Dispatch transform when ready issues exist** — transform is where code gets written. Always prefer it over maintain when there are open issues with the `ready` label.
 3. **Dispatch review after transform** — when recent workflow runs show a transform completion, dispatch review to close resolved issues and add `ready` labels to new issues. This keeps the pipeline flowing.
 4. **Fix failing PRs** — dispatch fix-code for any PR with failing checks (include pr-number).
@@ -78,7 +78,7 @@ If an **Implementation Review** section is present in the prompt, examine it car
 
 1. **Check what's already in progress** — don't duplicate work. If the workflow is already running, don't dispatch another.
 2. **Prioritise code generation** — the goal is working code. Prefer actions that produce code (dev-only, fix) over metadata (maintain, label).
-3. **Right-size the work** — break the mission into chunks just big enough to reliably deliver. One comprehensive issue is better than many small ones. Only create a follow-up issue when the previous transform has landed and gaps remain.
+3. **Right-size the work** — break the mission into the fewest chunks that can each be reliably delivered in a single transform. Create all the issues needed upfront rather than waiting for each to land before creating the next. Each issue should request maximum implementation in its scope.
 4. **Respect limits** — don't create issues beyond the WIP limit shown in the context. Don't dispatch workflows that will fail due to missing prerequisites.
 
 ## When to use each action

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

@@ -3,8 +3,9 @@
 # .github/workflows/agentic-lib-flow.yml
 #
 # Uber workflow: runs the full pipeline end-to-end.
-# Pattern: update → init → (test + bot + N×workflow) × 4 → test + bot → verify mission-complete
+# Pattern: update → init → (test + bot + N×workflow) × 4 → test + bot → verify → report
 # Each sub-workflow dispatches at HEAD of main at dispatch time (not at uber job start).
+# Mission-complete/failed checks before each workflow run to skip remaining iterations.
 
 name: agentic-lib-flow
 run-name: "agentic-lib-flow [${{ github.ref_name }}] ${{ inputs.mission-seed }} (${{ inputs.workflow-runs }} runs)"
@@ -51,9 +52,8 @@ on:
         description: "Copilot SDK model"
         type: choice
         required: false
-        default: ""
+        default: "gpt-5-mini"
         options:
-          - ""
           - gpt-5-mini
           - claude-sonnet-4
           - gpt-4.1
@@ -61,11 +61,10 @@ on:
         description: "Tuning profile"
         type: choice
         required: false
-        default: ""
+        default: "max"
         options:
-          - ""
           - min
-          - recommended
+          - med
           - max
       workflow-runs:
         description: "Number of workflow iterations (1-16)"
@@ -125,27 +124,104 @@ jobs:
     uses: ./.github/workflows/agentic-lib-bot.yml
     secrets: inherit
 
-  workflow-1:
+  check-1:
     needs: [bot-1]
     if: always() && needs.bot-1.result == 'success' && inputs.workflow-runs >= 1
+    runs-on: ubuntu-latest
+    outputs:
+      mission-over: ${{ steps.check.outputs.mission-over }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: main
+          fetch-depth: 1
+      - id: check
+        run: |
+          if [ -f MISSION_COMPLETE.md ] || [ -f MISSION_FAILED.md ]; then
+            echo "mission-over=true" >> "$GITHUB_OUTPUT"
+            echo "Mission is over — skipping remaining workflow runs"
+          else
+            echo "mission-over=false" >> "$GITHUB_OUTPUT"
+          fi
+
+  workflow-1:
+    needs: [check-1]
+    if: always() && needs.check-1.result == 'success' && needs.check-1.outputs.mission-over != 'true' && inputs.workflow-runs >= 1
     uses: ./.github/workflows/agentic-lib-workflow.yml
     secrets: inherit
 
-  workflow-2:
+  check-2:
     needs: [workflow-1]
     if: always() && needs.workflow-1.result == 'success' && inputs.workflow-runs >= 2
+    runs-on: ubuntu-latest
+    outputs:
+      mission-over: ${{ steps.check.outputs.mission-over }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: main
+          fetch-depth: 1
+      - id: check
+        run: |
+          if [ -f MISSION_COMPLETE.md ] || [ -f MISSION_FAILED.md ]; then
+            echo "mission-over=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "mission-over=false" >> "$GITHUB_OUTPUT"
+          fi
+
+  workflow-2:
+    needs: [check-2]
+    if: always() && needs.check-2.result == 'success' && needs.check-2.outputs.mission-over != 'true' && inputs.workflow-runs >= 2
     uses: ./.github/workflows/agentic-lib-workflow.yml
     secrets: inherit
 
-  workflow-3:
+  check-3:
     needs: [workflow-2]
     if: always() && needs.workflow-2.result == 'success' && inputs.workflow-runs >= 3
+    runs-on: ubuntu-latest
+    outputs:
+      mission-over: ${{ steps.check.outputs.mission-over }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: main
+          fetch-depth: 1
+      - id: check
+        run: |
+          if [ -f MISSION_COMPLETE.md ] || [ -f MISSION_FAILED.md ]; then
+            echo "mission-over=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "mission-over=false" >> "$GITHUB_OUTPUT"
+          fi
+
+  workflow-3:
+    needs: [check-3]
+    if: always() && needs.check-3.result == 'success' && needs.check-3.outputs.mission-over != 'true' && inputs.workflow-runs >= 3
     uses: ./.github/workflows/agentic-lib-workflow.yml
     secrets: inherit
 
-  workflow-4:
+  check-4:
     needs: [workflow-3]
     if: always() && needs.workflow-3.result == 'success' && inputs.workflow-runs >= 4
+    runs-on: ubuntu-latest
+    outputs:
+      mission-over: ${{ steps.check.outputs.mission-over }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: main
+          fetch-depth: 1
+      - id: check
+        run: |
+          if [ -f MISSION_COMPLETE.md ] || [ -f MISSION_FAILED.md ]; then
+            echo "mission-over=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "mission-over=false" >> "$GITHUB_OUTPUT"
+          fi
+
+  workflow-4:
+    needs: [check-4]
+    if: always() && needs.check-4.result == 'success' && needs.check-4.outputs.mission-over != 'true' && inputs.workflow-runs >= 4
     uses: ./.github/workflows/agentic-lib-workflow.yml
     secrets: inherit
 
@@ -162,27 +238,103 @@ jobs:
     uses: ./.github/workflows/agentic-lib-bot.yml
     secrets: inherit
 
-  workflow-5:
+  check-5:
     needs: [bot-2]
     if: always() && needs.bot-2.result == 'success' && inputs.workflow-runs >= 5
+    runs-on: ubuntu-latest
+    outputs:
+      mission-over: ${{ steps.check.outputs.mission-over }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: main
+          fetch-depth: 1
+      - id: check
+        run: |
+          if [ -f MISSION_COMPLETE.md ] || [ -f MISSION_FAILED.md ]; then
+            echo "mission-over=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "mission-over=false" >> "$GITHUB_OUTPUT"
+          fi
+
+  workflow-5:
+    needs: [check-5]
+    if: always() && needs.check-5.result == 'success' && needs.check-5.outputs.mission-over != 'true' && inputs.workflow-runs >= 5
     uses: ./.github/workflows/agentic-lib-workflow.yml
     secrets: inherit
 
-  workflow-6:
+  check-6:
     needs: [workflow-5]
     if: always() && needs.workflow-5.result == 'success' && inputs.workflow-runs >= 6
+    runs-on: ubuntu-latest
+    outputs:
+      mission-over: ${{ steps.check.outputs.mission-over }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: main
+          fetch-depth: 1
+      - id: check
+        run: |
+          if [ -f MISSION_COMPLETE.md ] || [ -f MISSION_FAILED.md ]; then
+            echo "mission-over=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "mission-over=false" >> "$GITHUB_OUTPUT"
+          fi
+
+  workflow-6:
+    needs: [check-6]
+    if: always() && needs.check-6.result == 'success' && needs.check-6.outputs.mission-over != 'true' && inputs.workflow-runs >= 6
     uses: ./.github/workflows/agentic-lib-workflow.yml
     secrets: inherit
 
-  workflow-7:
+  check-7:
     needs: [workflow-6]
     if: always() && needs.workflow-6.result == 'success' && inputs.workflow-runs >= 7
+    runs-on: ubuntu-latest
+    outputs:
+      mission-over: ${{ steps.check.outputs.mission-over }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: main
+          fetch-depth: 1
+      - id: check
+        run: |
+          if [ -f MISSION_COMPLETE.md ] || [ -f MISSION_FAILED.md ]; then
+            echo "mission-over=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "mission-over=false" >> "$GITHUB_OUTPUT"
+          fi
+
+  workflow-7:
+    needs: [check-7]
+    if: always() && needs.check-7.result == 'success' && needs.check-7.outputs.mission-over != 'true' && inputs.workflow-runs >= 7
     uses: ./.github/workflows/agentic-lib-workflow.yml
     secrets: inherit
 
-  workflow-8:
+  check-8:
     needs: [workflow-7]
     if: always() && needs.workflow-7.result == 'success' && inputs.workflow-runs >= 8
+    runs-on: ubuntu-latest
+    outputs:
+      mission-over: ${{ steps.check.outputs.mission-over }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: main
+          fetch-depth: 1
+      - id: check
+        run: |
+          if [ -f MISSION_COMPLETE.md ] || [ -f MISSION_FAILED.md ]; then
+            echo "mission-over=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "mission-over=false" >> "$GITHUB_OUTPUT"
+          fi
+
+  workflow-8:
+    needs: [check-8]
+    if: always() && needs.check-8.result == 'success' && needs.check-8.outputs.mission-over != 'true' && inputs.workflow-runs >= 8
     uses: ./.github/workflows/agentic-lib-workflow.yml
     secrets: inherit
 
@@ -199,27 +351,103 @@ jobs:
     uses: ./.github/workflows/agentic-lib-bot.yml
     secrets: inherit
 
-  workflow-9:
+  check-9:
     needs: [bot-3]
     if: always() && needs.bot-3.result == 'success' && inputs.workflow-runs >= 9
+    runs-on: ubuntu-latest
+    outputs:
+      mission-over: ${{ steps.check.outputs.mission-over }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: main
+          fetch-depth: 1
+      - id: check
+        run: |
+          if [ -f MISSION_COMPLETE.md ] || [ -f MISSION_FAILED.md ]; then
+            echo "mission-over=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "mission-over=false" >> "$GITHUB_OUTPUT"
+          fi
+
+  workflow-9:
+    needs: [check-9]
+    if: always() && needs.check-9.result == 'success' && needs.check-9.outputs.mission-over != 'true' && inputs.workflow-runs >= 9
     uses: ./.github/workflows/agentic-lib-workflow.yml
     secrets: inherit
 
-  workflow-10:
+  check-10:
     needs: [workflow-9]
     if: always() && needs.workflow-9.result == 'success' && inputs.workflow-runs >= 10
+    runs-on: ubuntu-latest
+    outputs:
+      mission-over: ${{ steps.check.outputs.mission-over }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: main
+          fetch-depth: 1
+      - id: check
+        run: |
+          if [ -f MISSION_COMPLETE.md ] || [ -f MISSION_FAILED.md ]; then
+            echo "mission-over=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "mission-over=false" >> "$GITHUB_OUTPUT"
+          fi
+
+  workflow-10:
+    needs: [check-10]
+    if: always() && needs.check-10.result == 'success' && needs.check-10.outputs.mission-over != 'true' && inputs.workflow-runs >= 10
     uses: ./.github/workflows/agentic-lib-workflow.yml
     secrets: inherit
 
-  workflow-11:
+  check-11:
     needs: [workflow-10]
     if: always() && needs.workflow-10.result == 'success' && inputs.workflow-runs >= 11
+    runs-on: ubuntu-latest
+    outputs:
+      mission-over: ${{ steps.check.outputs.mission-over }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: main
+          fetch-depth: 1
+      - id: check
+        run: |
+          if [ -f MISSION_COMPLETE.md ] || [ -f MISSION_FAILED.md ]; then
+            echo "mission-over=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "mission-over=false" >> "$GITHUB_OUTPUT"
+          fi
+
+  workflow-11:
+    needs: [check-11]
+    if: always() && needs.check-11.result == 'success' && needs.check-11.outputs.mission-over != 'true' && inputs.workflow-runs >= 11
     uses: ./.github/workflows/agentic-lib-workflow.yml
     secrets: inherit
 
-  workflow-12:
+  check-12:
     needs: [workflow-11]
     if: always() && needs.workflow-11.result == 'success' && inputs.workflow-runs >= 12
+    runs-on: ubuntu-latest
+    outputs:
+      mission-over: ${{ steps.check.outputs.mission-over }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: main
+          fetch-depth: 1
+      - id: check
+        run: |
+          if [ -f MISSION_COMPLETE.md ] || [ -f MISSION_FAILED.md ]; then
+            echo "mission-over=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "mission-over=false" >> "$GITHUB_OUTPUT"
+          fi
+
+  workflow-12:
+    needs: [check-12]
+    if: always() && needs.check-12.result == 'success' && needs.check-12.outputs.mission-over != 'true' && inputs.workflow-runs >= 12
     uses: ./.github/workflows/agentic-lib-workflow.yml
     secrets: inherit
 
@@ -236,31 +464,107 @@ jobs:
     uses: ./.github/workflows/agentic-lib-bot.yml
     secrets: inherit
 
-  workflow-13:
+  check-13:
     needs: [bot-4]
     if: always() && needs.bot-4.result == 'success' && inputs.workflow-runs >= 13
+    runs-on: ubuntu-latest
+    outputs:
+      mission-over: ${{ steps.check.outputs.mission-over }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: main
+          fetch-depth: 1
+      - id: check
+        run: |
+          if [ -f MISSION_COMPLETE.md ] || [ -f MISSION_FAILED.md ]; then
+            echo "mission-over=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "mission-over=false" >> "$GITHUB_OUTPUT"
+          fi
+
+  workflow-13:
+    needs: [check-13]
+    if: always() && needs.check-13.result == 'success' && needs.check-13.outputs.mission-over != 'true' && inputs.workflow-runs >= 13
     uses: ./.github/workflows/agentic-lib-workflow.yml
     secrets: inherit
 
-  workflow-14:
+  check-14:
     needs: [workflow-13]
     if: always() && needs.workflow-13.result == 'success' && inputs.workflow-runs >= 14
+    runs-on: ubuntu-latest
+    outputs:
+      mission-over: ${{ steps.check.outputs.mission-over }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: main
+          fetch-depth: 1
+      - id: check
+        run: |
+          if [ -f MISSION_COMPLETE.md ] || [ -f MISSION_FAILED.md ]; then
+            echo "mission-over=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "mission-over=false" >> "$GITHUB_OUTPUT"
+          fi
+
+  workflow-14:
+    needs: [check-14]
+    if: always() && needs.check-14.result == 'success' && needs.check-14.outputs.mission-over != 'true' && inputs.workflow-runs >= 14
     uses: ./.github/workflows/agentic-lib-workflow.yml
     secrets: inherit
 
-  workflow-15:
+  check-15:
     needs: [workflow-14]
     if: always() && needs.workflow-14.result == 'success' && inputs.workflow-runs >= 15
+    runs-on: ubuntu-latest
+    outputs:
+      mission-over: ${{ steps.check.outputs.mission-over }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: main
+          fetch-depth: 1
+      - id: check
+        run: |
+          if [ -f MISSION_COMPLETE.md ] || [ -f MISSION_FAILED.md ]; then
+            echo "mission-over=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "mission-over=false" >> "$GITHUB_OUTPUT"
+          fi
+
+  workflow-15:
+    needs: [check-15]
+    if: always() && needs.check-15.result == 'success' && needs.check-15.outputs.mission-over != 'true' && inputs.workflow-runs >= 15
     uses: ./.github/workflows/agentic-lib-workflow.yml
     secrets: inherit
 
-  workflow-16:
+  check-16:
     needs: [workflow-15]
     if: always() && needs.workflow-15.result == 'success' && inputs.workflow-runs >= 16
+    runs-on: ubuntu-latest
+    outputs:
+      mission-over: ${{ steps.check.outputs.mission-over }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: main
+          fetch-depth: 1
+      - id: check
+        run: |
+          if [ -f MISSION_COMPLETE.md ] || [ -f MISSION_FAILED.md ]; then
+            echo "mission-over=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "mission-over=false" >> "$GITHUB_OUTPUT"
+          fi
+
+  workflow-16:
+    needs: [check-16]
+    if: always() && needs.check-16.result == 'success' && needs.check-16.outputs.mission-over != 'true' && inputs.workflow-runs >= 16
     uses: ./.github/workflows/agentic-lib-workflow.yml
     secrets: inherit
 
-  # ── Final: test + bot ──────────────────────────────────────────────
+  # ── Final: test + bot (always runs) ────────────────────────────────
   test-final:
     needs: [workflow-4, workflow-8, workflow-12, workflow-16]
     if: always()
@@ -310,7 +614,6 @@ jobs:
         run: |
           git fetch origin agentic-lib-logs --depth=1 2>/dev/null || true
           git show origin/agentic-lib-logs:agentic-lib-state.toml > /tmp/state.toml 2>/dev/null || echo "# no state" > /tmp/state.toml
-          # List agent log files
           git ls-tree origin/agentic-lib-logs --name-only 2>/dev/null | grep '^agent-log-' | sort > /tmp/log-files.txt || true
 
       - name: Read source and mission
@@ -321,7 +624,7 @@ jobs:
 
       - name: Generate report
         run: |
-          REPORT_NUM=$(printf "%03d" $(( $(ls BENCHMARK_REPORT_*.md 2>/dev/null | wc -l) + 1 )))
+          REPORT_NUM=$(printf "%03d" $(( $(ls BENCHMARK_REPORT_FLOW_*.md 2>/dev/null | wc -l) + 1 )))
           MISSION_SEED="${{ inputs.mission-seed }}"
           MODEL="${{ inputs.model || 'default' }}"
           PROFILE="${{ inputs.profile || 'default' }}"
@@ -329,7 +632,9 @@ jobs:
           SOURCE_LINES=$(cat /tmp/source-lines.txt)
           TEST_FILES=$(cat /tmp/test-files.txt)
           MISSION_COMPLETE="NO"
+          MISSION_FAILED="NO"
           if [ -f MISSION_COMPLETE.md ]; then MISSION_COMPLETE="YES"; fi
+          if [ -f MISSION_FAILED.md ]; then MISSION_FAILED="YES"; fi
 
           cat > "BENCHMARK_REPORT_FLOW_${REPORT_NUM}.md" << REPORT_EOF
           # Flow Benchmark Report ${REPORT_NUM}
@@ -362,6 +667,7 @@ jobs:
           | Metric | Value |
           |--------|-------|
           | Mission complete | ${MISSION_COMPLETE} |
+          | Mission failed | ${MISSION_FAILED} |
           | Source lines | ${SOURCE_LINES} |
           | Test files | ${TEST_FILES} |
           | Agent log files | $(wc -l < /tmp/log-files.txt) |

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

@@ -124,7 +124,7 @@ on:
         options:
           - ""
           - min
-          - recommended
+          - med
           - max
       create-seed-issues:
         description: "Create initial seed issues after purge"

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

@@ -67,7 +67,7 @@ on:
         options:
           - ""
           - min
-          - recommended
+          - med
           - max
       dry-run:
         description: "Skip commit and push"