@xn-intenton-z2a/agentic-lib 7.1.86 → 7.1.88

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

@@ -23,6 +23,7 @@ on:
 
 permissions:
   contents: write
+  actions: write
 
 jobs:
   test:
@@ -67,7 +68,7 @@ jobs:
           HOME: /root
 
       - name: Upload screenshot
-        if: always()
+        if: ${{ !cancelled() }}
         uses: actions/upload-artifact@v4
         with:
           name: screenshot
@@ -95,3 +96,24 @@ jobs:
               echo "::warning::Failed to push screenshot after 3 attempts"
             fi
           done
+
+  # ─── Dispatch fix workflow when tests fail on main ─────────────────
+  dispatch-fix:
+    needs: [test, behaviour]
+    if: >-
+      !cancelled()
+      && github.ref == 'refs/heads/main'
+      && github.event_name != 'pull_request'
+      && github.repository != 'xn-intenton-z2a/agentic-lib'
+      && (needs.test.result == 'failure' || needs.behaviour.result == 'failure')
+    runs-on: ubuntu-latest
+    steps:
+      - name: Dispatch agentic-lib-workflow to fix broken build
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          echo "Tests failed on main — dispatching agentic-lib-workflow to fix"
+          gh workflow run agentic-lib-workflow.yml \
+            --repo "${{ github.repository }}" \
+            -f mode=full \
+            -f message="Build broken on main: agentic-lib-test run ${{ github.run_id }} failed. Please fix."

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

@@ -298,7 +298,7 @@ jobs:
   maintain:
     needs: [params]
     if: |
-      always() &&
+      !cancelled() &&
       (needs.params.outputs.mode == 'full' || needs.params.outputs.mode == 'maintain-only') &&
       needs.params.result == 'success'
     runs-on: ubuntu-latest
@@ -386,7 +386,7 @@ jobs:
   supervisor:
     needs: [params, pr-cleanup, telemetry, maintain]
     if: |
-      always() &&
+      !cancelled() &&
       (needs.params.outputs.mode == 'full' || needs.params.outputs.mode == 'dev-only') &&
       needs.params.result == 'success'
     runs-on: ubuntu-latest
@@ -422,7 +422,7 @@ jobs:
   fix-stuck:
     needs: [params, supervisor]
     if: |
-      always() &&
+      !cancelled() &&
       needs.params.outputs.mode == 'full' &&
       needs.params.result == 'success'
     runs-on: ubuntu-latest
@@ -438,6 +438,10 @@ jobs:
       - name: Install project dependencies
         run: npm ci
 
+      - name: Install Playwright (for behaviour tests)
+        if: hashFiles('playwright.config.js') != '' || hashFiles('playwright.config.ts') != ''
+        run: npx playwright install --with-deps chromium
+
       - name: Self-init (agentic-lib dev only)
         if: hashFiles('scripts/self-init.sh') != '' && hashFiles('.github/agentic-lib/actions/agentic-step/package.json') == ''
         run: bash scripts/self-init.sh
@@ -456,7 +460,7 @@ jobs:
             echo "mission-complete=false" >> $GITHUB_OUTPUT
           fi
 
-      - name: Find and fix stuck PRs
+      - name: Find and fix stuck PRs or broken main build
         if: steps.fix-mission-check.outputs.mission-complete != 'true'
         uses: actions/github-script@v8
         env:
@@ -480,6 +484,7 @@ jobs:
               owner, repo, state: 'open', per_page: 10,
             });
 
+            let foundPR = false;
             for (const pr of openPRs) {
               const hasAutomerge = pr.labels.some(l => l.name === 'automerge');
               if (!hasAutomerge) continue;
@@ -514,9 +519,42 @@ jobs:
               core.info(`Will attempt to fix PR #${pr.number} (${reason})`);
               core.exportVariable('FIX_PR_NUMBER', String(pr.number));
               core.exportVariable('FIX_REASON', reason);
+              foundPR = true;
               break;
             }
 
+            // If no stuck PR found, check for broken main build
+            if (!foundPR) {
+              try {
+                const { data: testRuns } = await github.rest.actions.listWorkflowRuns({
+                  owner, repo,
+                  workflow_id: 'agentic-lib-test.yml',
+                  branch: 'main',
+                  per_page: 1,
+                });
+                if (testRuns.workflow_runs.length > 0) {
+                  const latestTest = testRuns.workflow_runs[0];
+                  if (latestTest.conclusion === 'failure') {
+                    // Check we haven't already opened a fix branch for this
+                    const { data: existingPRs } = await github.rest.pulls.list({
+                      owner, repo, state: 'open', head: `${owner}:agentic-lib-fix-main-build`, per_page: 1,
+                    });
+                    if (existingPRs.length > 0) {
+                      core.info(`Fix PR already open for main build (#${existingPRs[0].number}) — skipping`);
+                    } else {
+                      core.info(`Main build broken (run ${latestTest.id}) — will create fix branch`);
+                      core.exportVariable('FIX_MAIN_BUILD', 'true');
+                      core.exportVariable('FIX_RUN_ID', String(latestTest.id));
+                    }
+                  } else {
+                    core.info(`Latest agentic-lib-test on main: ${latestTest.conclusion} — no fix needed`);
+                  }
+                }
+              } catch (err) {
+                core.warning(`Could not check main build status: ${err.message}`);
+              }
+            }
+
       - name: Checkout PR branch
         if: env.FIX_PR_NUMBER != '' && steps.fix-mission-check.outputs.mission-complete != 'true'
         run: |
@@ -524,6 +562,11 @@ jobs:
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
+      - name: Create fix branch for broken main build
+        if: env.FIX_MAIN_BUILD == 'true' && steps.fix-mission-check.outputs.mission-complete != 'true'
+        run: |
+          git checkout -b agentic-lib-fix-main-build
+
       - name: "Tier 1: Auto-resolve trivial merge conflicts"
         if: env.FIX_PR_NUMBER != '' && env.FIX_REASON == 'merge conflicts' && steps.fix-mission-check.outputs.mission-complete != 'true'
         id: trivial-resolve
@@ -573,17 +616,57 @@ jobs:
           # test-command read from [execution].test in agentic-lib.toml
           model: ${{ needs.params.outputs.model }}
 
+      - name: "LLM fix for broken main build"
+        if: |
+          env.FIX_MAIN_BUILD == 'true' &&
+          steps.fix-mission-check.outputs.mission-complete != 'true'
+        uses: ./.github/agentic-lib/actions/agentic-step
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
+          FIX_RUN_ID: ${{ env.FIX_RUN_ID }}
+        with:
+          task: "fix-code"
+          config: ${{ needs.params.outputs.config-path }}
+          instructions: ".github/agentic-lib/agents/agent-apply-fix.md"
+          model: ${{ needs.params.outputs.model }}
+
+      - name: Build website and run behaviour tests (fix)
+        if: |
+          steps.fix-mission-check.outputs.mission-complete != 'true' &&
+          (env.FIX_PR_NUMBER != '' || env.FIX_MAIN_BUILD == 'true')
+        run: |
+          npm run build:web 2>/dev/null || echo "No build:web script"
+          npm run --if-present test:behaviour || echo "Behaviour tests failed (non-blocking for fix)"
+
       - name: Commit and push fixes
         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"
 
+      - name: Commit, push, and open PR for main build fix
+        if: github.repository != 'xn-intenton-z2a/agentic-lib' && env.FIX_MAIN_BUILD == 'true' && steps.fix-mission-check.outputs.mission-complete != 'true'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          if git diff --quiet && git diff --cached --quiet; then
+            echo "No changes to commit"
+            exit 0
+          fi
+          git add -A
+          git commit -m "agentic-step: fix broken main build (run ${{ env.FIX_RUN_ID }})"
+          git push -u origin agentic-lib-fix-main-build
+          gh pr create \
+            --title "fix: auto-fix broken main build" \
+            --body "Automated fix for failing agentic-lib-test run [${{ env.FIX_RUN_ID }}](https://github.com/${{ github.repository }}/actions/runs/${{ env.FIX_RUN_ID }})." \
+            --label automerge
+
   # ─── Review: close resolved issues, enhance with criteria ──────────
   review-features:
     needs: [params, supervisor]
     if: |
-      always() &&
+      !cancelled() &&
       (needs.params.outputs.mode == 'full' || needs.params.outputs.mode == 'review-only') &&
       needs.params.result == 'success'
     runs-on: ubuntu-latest
@@ -628,7 +711,7 @@ jobs:
   dev:
     needs: [params, review-features]
     if: |
-      always() &&
+      !cancelled() &&
       (needs.params.outputs.mode == 'full' || needs.params.outputs.mode == 'dev-only') &&
       needs.params.result == 'success'
     runs-on: ubuntu-latest
@@ -645,6 +728,10 @@ jobs:
       - name: Install project dependencies
         run: npm ci
 
+      - name: Install Playwright (for behaviour tests)
+        if: hashFiles('playwright.config.js') != '' || hashFiles('playwright.config.ts') != ''
+        run: npx playwright install --with-deps chromium
+
       - name: Self-init (agentic-lib dev only)
         if: hashFiles('scripts/self-init.sh') != '' && hashFiles('.github/agentic-lib/actions/agentic-step/package.json') == ''
         run: bash scripts/self-init.sh
@@ -739,18 +826,26 @@ jobs:
           CONFIG="${{ needs.params.outputs.config-path }}"
           TEST_CMD=$(grep -E '^\s*test\s*=' "$CONFIG" 2>/dev/null | sed 's/.*=\s*"\(.*\)"/\1/' | head -1)
           TEST_CMD="${TEST_CMD:-npm ci && npm test}"
-          echo "Running: $TEST_CMD"
+          echo "Running unit tests: $TEST_CMD"
           set +e
           eval "$TEST_CMD" 2>&1 | tail -30
           EXIT_CODE=$?
           set -e
           if [ $EXIT_CODE -ne 0 ]; then
             echo "tests-passed=false" >> $GITHUB_OUTPUT
-            echo "WARNING: Tests failed (exit $EXIT_CODE) — skipping commit and PR"
+            echo "WARNING: Unit tests failed (exit $EXIT_CODE) — skipping commit and PR"
+            exit 0
+          fi
+          # Run behaviour tests if available
+          if npm run --if-present test:behaviour; then
+            echo "Behaviour tests passed"
           else
-            echo "tests-passed=true" >> $GITHUB_OUTPUT
-            echo "Tests passed"
+            echo "tests-passed=false" >> $GITHUB_OUTPUT
+            echo "WARNING: Behaviour tests failed — skipping commit and PR"
+            exit 0
           fi
+          echo "tests-passed=true" >> $GITHUB_OUTPUT
+          echo "All tests passed"
 
       - name: Commit and push
         if: github.repository != 'xn-intenton-z2a/agentic-lib' && steps.issue.outputs.issue-number != '' && needs.params.outputs.dry-run != 'true' && steps.pre-commit-test.outputs.tests-passed == 'true'
@@ -850,7 +945,7 @@ jobs:
   # ─── Post-merge: stats, schedule, mission check ────────────────────
   post-merge:
     needs: [params, dev, pr-cleanup]
-    if: always() && needs.params.result == 'success'
+    if: ${{ !cancelled() && needs.params.result == 'success' }}
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
@@ -872,7 +967,7 @@ jobs:
   # ─── Schedule change (if requested) ────────────────────────────────
   update-schedule:
     needs: [params, dev]
-    if: always() && needs.params.outputs.dry-run != 'true' && needs.params.outputs.schedule != '' && needs.params.result == 'success'
+    if: ${{ !cancelled() && needs.params.outputs.dry-run != 'true' && needs.params.outputs.schedule != '' && needs.params.result == 'success' }}
     uses: ./.github/workflows/agentic-lib-schedule.yml
     with:
       frequency: ${{ needs.params.outputs.schedule }}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xn-intenton-z2a/agentic-lib",
-  "version": "7.1.86",
+  "version": "7.1.88",
   "description": "Agentic-lib Agentic Coding Systems SDK powering automated GitHub workflows.",
   "type": "module",
   "scripts": {

package/src/actions/agentic-step/tasks/fix-code.js

@@ -121,9 +121,67 @@ async function resolveConflicts({ config, pr, prNumber, instructions, model, wri
 }
 
 /**
- * Fix failing code or resolve merge conflicts on a pull request.
+ * Fix a broken main branch build.
+ * Called when no PR is involved — just a failing workflow run on main.
+ */
+async function fixMainBuild({ config, runId, instructions, model, writablePaths, testCommand }) {
+  const logContent = fetchRunLog(runId);
+  if (!logContent) {
+    core.info(`Could not fetch log for run ${runId}. Returning nop.`);
+    return { outcome: "nop", details: `Could not fetch log for run ${runId}` };
+  }
+
+  const agentInstructions = instructions || "Fix the failing tests by modifying the source code.";
+  const readOnlyPaths = config.readOnlyPaths;
+
+  const prompt = [
+    "## Instructions",
+    agentInstructions,
+    "",
+    "## Broken Build on Main",
+    `Workflow run ${runId} failed on the main branch.`,
+    "Fix the code so that the build passes.",
+    "",
+    "## Failed Run Log",
+    logContent,
+    "",
+    formatPathsSection(writablePaths, readOnlyPaths, config),
+    "",
+    "## Constraints",
+    `- Run \`${testCommand}\` to validate your fixes`,
+    "- Make minimal changes to fix the failing tests",
+    "- Do not introduce new features — focus on making the build green",
+  ].join("\n");
+
+  const t = config.tuning || {};
+  const { tokensUsed, inputTokens, outputTokens, cost, content: resultContent } = await runCopilotTask({
+    model,
+    systemMessage: `You are an autonomous coding agent fixing a broken build on the main branch. The test/build workflow has failed. Analyze the error log and make minimal, targeted changes to fix it.` + NARRATIVE_INSTRUCTION,
+    prompt,
+    writablePaths,
+    tuning: t,
+  });
+
+  core.info(`Main build fix completed (${tokensUsed} tokens)`);
+
+  return {
+    outcome: "fix-applied",
+    tokensUsed,
+    inputTokens,
+    outputTokens,
+    cost,
+    model,
+    details: `Applied fix for broken main build (run ${runId})`,
+    narrative: extractNarrative(resultContent, `Fixed broken main build (run ${runId}).`),
+  };
+}
+
+/**
+ * Fix failing code or resolve merge conflicts on a pull request,
+ * or fix a broken build on main.
  *
- * Priority: conflicts first (if NON_TRIVIAL_FILES env is set), then failing checks.
+ * Priority: main build fix (if FIX_RUN_ID env is set),
+ * then conflicts (if NON_TRIVIAL_FILES env is set), then failing checks.
  *
  * @param {Object} context - Task context from index.js
  * @returns {Promise<Object>} Result with outcome, tokensUsed, model
@@ -131,8 +189,14 @@ async function resolveConflicts({ config, pr, prNumber, instructions, model, wri
 export async function fixCode(context) {
   const { octokit, repo, config, prNumber, instructions, writablePaths, testCommand, model } = context;
 
+  // Fix main build (no PR involved)
+  const fixRunId = process.env.FIX_RUN_ID || "";
+  if (fixRunId && !prNumber) {
+    return fixMainBuild({ config, runId: fixRunId, instructions, model, writablePaths, testCommand });
+  }
+
   if (!prNumber) {
-    throw new Error("fix-code task requires pr-number input");
+    throw new Error("fix-code task requires pr-number input or FIX_RUN_ID env var");
   }
 
   // Fetch the PR

package/src/agents/agent-apply-fix.md

@@ -15,6 +15,10 @@ do it. Don't limit yourself to the minimal fix when you can deliver the whole mi
 The repository has a website in `src/web/` that uses the JS library. If a fix affects library
 exports or behaviour, also update the website files to stay in sync.
 
+**Both unit tests AND behaviour tests must pass.** If the project has a `test:behaviour` npm script
+(typically Playwright-based, testing the website), run it after your changes. If the behaviour test
+expects elements like `#demo-output`, `#lib-name`, or `#lib-version`, ensure the website provides them.
+
 ## Merge Conflict Resolution
 
 When resolving merge conflicts (files containing <<<<<<< / ======= / >>>>>>> markers):

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

@@ -21,6 +21,11 @@ When writing both tests and implementation:
 - Ensure the implementation passes those tests before delivering
 - Do not write tests with different expectations than the implementation produces
 
+**Both unit tests AND behaviour tests must pass.** If the project has a `test:behaviour` npm script
+(typically Playwright-based, testing the website), run it after your changes. If your changes affect
+the website (`src/web/`) or library exports, ensure the behaviour test still finds the expected
+elements (e.g. `#demo-output`, `#lib-name`, `#lib-version`).
+
 Follow the linting guidelines and the formatting guidelines from the included config.
 
 ## Evidence Gathering

package/src/seeds/zero-package.json

@@ -17,7 +17,7 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@xn-intenton-z2a/agentic-lib": "^7.1.86"
+    "@xn-intenton-z2a/agentic-lib": "^7.1.88"
   },
   "devDependencies": {
     "@playwright/test": "^1.58.0",