@xn-intenton-z2a/agentic-lib 7.1.85 → 7.1.87

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

@@ -190,7 +190,10 @@ jobs:
 
   dispatch-supervisor:
     needs: [params, respond]
-    if: github.repository != 'xn-intenton-z2a/agentic-lib' && needs.respond.outputs.action == 'request-supervisor'
+    if: >-
+      github.repository != 'xn-intenton-z2a/agentic-lib'
+      && needs.respond.outputs.action == 'request-supervisor'
+      && inputs.message == ''
     runs-on: ubuntu-latest
     steps:
       - name: Dispatch supervisor workflow

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

@@ -23,6 +23,7 @@ on:
 
 permissions:
   contents: write
+  actions: write
 
 jobs:
   test:
@@ -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: >-
+      always()
+      && 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

@@ -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,12 +616,52 @@ 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]
@@ -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'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xn-intenton-z2a/agentic-lib",
-  "version": "7.1.85",
+  "version": "7.1.87",
   "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/actions/agentic-step/tasks/supervise.js

@@ -71,6 +71,36 @@ async function dispatchBot(octokit, repo, message, discussionUrl) {
   }
 }
 
+/**
+ * Post a comment directly to a discussion via GraphQL.
+ * Used for supervisor-originated messages to avoid triggering the bot workflow
+ * (which could loop back via request-supervisor).
+ */
+async function postDirectReply(octokit, repo, nodeId, body) {
+  if (process.env.GITHUB_REPOSITORY === "xn-intenton-z2a/agentic-lib") {
+    core.info("Skipping direct reply — running in SDK repo");
+    return;
+  }
+  if (!nodeId || !body) {
+    core.warning(`Cannot post direct reply: ${!nodeId ? "no nodeId" : "no body"}`);
+    return;
+  }
+  try {
+    const mutation = `mutation($discussionId: ID!, $body: String!) {
+      addDiscussionComment(input: { discussionId: $discussionId, body: $body }) {
+        comment { url }
+      }
+    }`;
+    const { addDiscussionComment } = await octokit.graphql(mutation, {
+      discussionId: nodeId,
+      body,
+    });
+    core.info(`Posted direct reply: ${addDiscussionComment.comment.url}`);
+  } catch (err) {
+    core.warning(`Could not post direct reply: ${err.message}`);
+  }
+}
+
 async function gatherContext(octokit, repo, config, t) {
   const mission = readOptionalFile(config.paths.mission.path);
   const intentionLogFull = readOptionalFile(config.intentionBot.intentionFilepath);
@@ -100,11 +130,21 @@ async function gatherContext(octokit, repo, config, t) {
   // Extract discussion URL from recent activity for supervisor reporting
   const discussionUrlMatch = recentActivity.match(/https:\/\/github\.com\/[^/]+\/[^/]+\/discussions\/\d+/);
   let activeDiscussionUrl = discussionUrlMatch ? discussionUrlMatch[0] : "";
+  let activeDiscussionNodeId = "";
 
   // Fallback: look up the "Talk to the repository" discussion if not found in activity log
   if (!activeDiscussionUrl) {
     const talk = await findTalkDiscussion(octokit, repo);
     activeDiscussionUrl = talk.url;
+    activeDiscussionNodeId = talk.nodeId;
+  }
+
+  // Resolve node ID from URL if we got the URL from activity log
+  if (activeDiscussionUrl && !activeDiscussionNodeId) {
+    const talk = await findTalkDiscussion(octokit, repo);
+    if (talk.url === activeDiscussionUrl) {
+      activeDiscussionNodeId = talk.nodeId;
+    }
   }
 
   const featuresPath = config.paths.features.path;
@@ -271,6 +311,7 @@ async function gatherContext(octokit, repo, config, t) {
     featureIssuesWipLimit: config.featureDevelopmentIssuesWipLimit,
     maintenanceIssuesWipLimit: config.maintenanceIssuesWipLimit,
     activeDiscussionUrl,
+    activeDiscussionNodeId,
     missionComplete,
     missionCompleteInfo,
     missionFailed,
@@ -670,14 +711,15 @@ export async function supervise(context) {
   // Step 2: Auto-announce on first run after init
   // Detect first supervisor run: initTimestamp exists but no prior supervisor workflow runs since init
   if (ctx.initTimestamp && !ctx.missionComplete && !ctx.missionFailed) {
-    const hasPriorSupervisor = ctx.actionsSinceInit.some(
-      (a) => a.name === "agentic-lib-workflow" && a.conclusion === "success" &&
-        a.commitMessage?.toLowerCase().includes("supervisor"),
-    ) || ctx.recentActivity.includes("supervised:");
+    // Check for any prior agentic-lib-workflow runs since init (count > 1 because current run is included)
+    const supervisorRunCount = ctx.actionsSinceInit.filter(
+      (a) => a.name === "agentic-lib-workflow",
+    ).length;
+    const hasPriorSupervisor = supervisorRunCount > 1 || ctx.recentActivity.includes("supervised:");
     if (!hasPriorSupervisor && ctx.mission && ctx.activeDiscussionUrl) {
-      core.info("First supervisor run after init — announcing mission");
+      core.info("First supervisor run after init — announcing mission directly");
       const announcement = `New mission started!\n\n**Mission:** ${ctx.mission.substring(0, 300)}\n\n**Website:** ${websiteUrl}`;
-      await dispatchBot(octokit, repo, announcement, ctx.activeDiscussionUrl);
+      await postDirectReply(octokit, repo, ctx.activeDiscussionNodeId, announcement);
     }
   }
 
@@ -738,16 +780,18 @@ export async function supervise(context) {
 
   // Step 3: Auto-respond when a message referral is present
   // If the workflow was triggered with a message (from bot's request-supervisor),
-  // and the LLM didn't include a respond:discussions action, post back automatically
+  // and the LLM didn't include a respond:discussions action, post back directly.
+  // Posts directly via GraphQL to avoid triggering the bot workflow (which would
+  // request-supervisor again, creating an infinite loop).
   const workflowMessage = context.discussionUrl ? "" : (process.env.INPUT_MESSAGE || "");
   if (workflowMessage && ctx.activeDiscussionUrl) {
     const hasDiscussionResponse = results.some((r) => r.startsWith("respond-discussions:"));
     if (!hasDiscussionResponse) {
-      core.info("Message referral detected — auto-responding to discussion");
+      core.info("Message referral detected — posting auto-response directly");
       const response = reasoning
         ? `Supervisor update: ${reasoning.substring(0, 400)}`
         : `Supervisor processed your request. Actions taken: ${results.join(", ")}`;
-      await dispatchBot(octokit, repo, response, ctx.activeDiscussionUrl);
+      await postDirectReply(octokit, repo, ctx.activeDiscussionNodeId, response);
       results.push(`auto-respond:${ctx.activeDiscussionUrl}`);
     }
   }

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.85"
+    "@xn-intenton-z2a/agentic-lib": "^7.1.87"
   },
   "devDependencies": {
     "@playwright/test": "^1.58.0",