@xn-intenton-z2a/agentic-lib 7.1.81 → 7.1.82

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

@@ -32,6 +32,10 @@ on:
         type: string
         required: false
         default: ""
+      message:
+        type: string
+        required: false
+        default: ""
       model:
         type: string
         required: false
@@ -43,6 +47,11 @@ on:
         type: string
         required: false
         default: ""
+      message:
+        description: "Context message from supervisor or lifecycle event"
+        type: string
+        required: false
+        default: ""
       model:
         description: "Copilot SDK model to use"
         type: choice
@@ -169,6 +178,7 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
           TEST_RESULT: ${{ steps.tests.outputs.result }}
+          BOT_MESSAGE: ${{ inputs.message }}
         with:
           task: "discussions"
           config: ${{ env.configPath }}

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

@@ -61,14 +61,19 @@ jobs:
       - name: Install dependencies
         run: npm ci
 
-      - name: Build website
-        run: npm run build:web
-
       - name: Run behaviour tests
         run: npm run test:behaviour
         env:
           HOME: /root
 
+      - name: Upload screenshot
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: screenshot
+          path: SCREENSHOT_INDEX.png
+          if-no-files-found: ignore
+
       - name: Push screenshot on main
         if: github.ref == 'refs/heads/main' && github.event_name != 'pull_request'
         run: |

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

@@ -411,6 +411,7 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
+          INPUT_MESSAGE: ${{ needs.params.outputs.message }}
         with:
           task: "supervise"
           config: ${{ needs.params.outputs.config-path }}

package/package.json

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

package/src/actions/agentic-step/tasks/discussions.js

@@ -104,6 +104,18 @@ function buildPrompt(discussionUrl, discussion, context, t, repoContext, trigger
     parts.push("", "### Your Last Reply (DO NOT REPEAT THIS)", lastBotReply.body.substring(0, 500));
   }
 
+  // Include supervisor message if dispatched with context
+  const botMessage = process.env.BOT_MESSAGE || "";
+  if (botMessage) {
+    parts.push(
+      "",
+      "## Triggering Request",
+      "The supervisor dispatched you with the following message. This is your primary request — respond to it in the discussion thread:",
+      "",
+      botMessage,
+    );
+  }
+
   parts.push(
     "",
     "## Repository Context",

package/src/actions/agentic-step/tasks/supervise.js

@@ -55,7 +55,8 @@ async function dispatchBot(octokit, repo, message, discussionUrl) {
     core.info("Skipping bot dispatch — running in SDK repo");
     return;
   }
-  const inputs = { message };
+  const inputs = {};
+  if (message) inputs.message = message;
   if (discussionUrl) inputs["discussion-url"] = discussionUrl;
   try {
     await octokit.rest.actions.createWorkflowDispatch({
@@ -64,7 +65,7 @@ async function dispatchBot(octokit, repo, message, discussionUrl) {
       ref: "main",
       inputs,
     });
-    core.info(`Dispatched bot: ${message.substring(0, 100)}`);
+    core.info(`Dispatched bot: ${(message || discussionUrl || "(default)").substring(0, 100)}`);
   } catch (err) {
     core.warning(`Could not dispatch bot: ${err.message}`);
   }
@@ -234,6 +235,23 @@ async function gatherContext(octokit, repo, config, t) {
     core.warning(`Could not fetch workflow runs: ${err.message}`);
   }
 
+  // Scan source files for exported function/const names (Strategy E: source summary for supervisor)
+  let sourceExports = [];
+  try {
+    const sourcePath = config.paths.source?.path || "src/lib/";
+    if (existsSync(sourcePath)) {
+      const sourceFiles = scanDirectory(sourcePath, [".js", ".ts"], { limit: 5 });
+      for (const sf of sourceFiles) {
+        const content = readFileSync(sf.path, "utf8");
+        const exports = [...content.matchAll(/export\s+(?:async\s+)?(?:function|const|let|var|class)\s+(\w+)/g)]
+          .map((m) => m[1]);
+        if (exports.length > 0) {
+          sourceExports.push(`${sf.name}: ${exports.join(", ")}`);
+        }
+      }
+    }
+  } catch { /* ignore */ }
+
   return {
     mission,
     recentActivity,
@@ -260,6 +278,7 @@ async function gatherContext(octokit, repo, config, t) {
     transformationBudget,
     cumulativeTransformationCost,
     recentlyClosedSummary,
+    sourceExports,
   };
 }
 
@@ -287,6 +306,14 @@ function buildPrompt(ctx, agentInstructions) {
     `### Library Docs (${ctx.libraryNames.length}/${ctx.libraryLimit})`,
     ctx.libraryNames.join(", ") || "none",
     "",
+    ...(ctx.sourceExports?.length > 0
+      ? [
+          `### Source Exports`,
+          "Functions and constants exported from source files:",
+          ...ctx.sourceExports.map((e) => `- ${e}`),
+          "",
+        ]
+      : []),
     `### Recent Workflow Runs`,
     ctx.workflowsSummary.join("\n") || "none",
     "",
@@ -509,20 +536,13 @@ async function executeCloseIssue(octokit, repo, params) {
 async function executeRespondDiscussions(octokit, repo, params, ctx) {
   const message = params.message || "";
   const url = params["discussion-url"] || ctx?.activeDiscussionUrl || "";
-  if (message) {
+  if (message || url) {
     if (process.env.GITHUB_REPOSITORY === "xn-intenton-z2a/agentic-lib") {
       core.info("Skipping bot dispatch — running in SDK repo");
       return `skipped:sdk-repo:respond-discussions`;
     }
-    core.info(`Dispatching discussions bot with response: ${message.substring(0, 100)}`);
-    const inputs = { message };
-    if (url) inputs["discussion-url"] = url;
-    await octokit.rest.actions.createWorkflowDispatch({
-      ...repo,
-      workflow_id: "agentic-lib-bot.yml",
-      ref: "main",
-      inputs,
-    });
+    core.info(`Dispatching discussions bot: ${(message || url).substring(0, 100)}`);
+    await dispatchBot(octokit, repo, message, url);
     return `respond-discussions:${url || "no-url"}`;
   }
   return "skipped:respond-no-message";
@@ -648,9 +668,12 @@ export async function supervise(context) {
   // --- Deterministic lifecycle posts (before LLM) ---
 
   // Step 2: Auto-announce on first run after init
-  // Detect first supervisor run: initTimestamp exists but no supervisor entries in activity
+  // Detect first supervisor run: initTimestamp exists but no prior supervisor workflow runs since init
   if (ctx.initTimestamp && !ctx.missionComplete && !ctx.missionFailed) {
-    const hasPriorSupervisor = ctx.recentActivity.includes("supervisor");
+    const hasPriorSupervisor = ctx.actionsSinceInit.some(
+      (a) => a.name === "agentic-lib-workflow" && a.conclusion === "success" &&
+        a.commitMessage?.toLowerCase().includes("supervisor"),
+    ) || ctx.recentActivity.includes("supervised:");
     if (!hasPriorSupervisor && ctx.mission && ctx.activeDiscussionUrl) {
       core.info("First supervisor run after init — announcing mission");
       const announcement = `New mission started!\n\n**Mission:** ${ctx.mission.substring(0, 300)}\n\n**Website:** ${websiteUrl}`;
@@ -691,6 +714,28 @@ export async function supervise(context) {
 
   // --- Deterministic lifecycle posts (after LLM) ---
 
+  // Strategy A: Deterministic mission-complete fallback
+  // If the LLM didn't choose mission-complete but conditions are clearly met, auto-execute it.
+  if (!ctx.missionComplete && !ctx.missionFailed) {
+    const llmChoseMissionComplete = results.some((r) => r.startsWith("mission-complete:"));
+    if (!llmChoseMissionComplete) {
+      const resolvedCount = ctx.recentlyClosedSummary.filter((s) => s.includes("closed by review as RESOLVED")).length;
+      const hasNoOpenIssues = ctx.issuesSummary.length === 0;
+      const hasNoOpenPRs = ctx.prsSummary.length === 0;
+      if (hasNoOpenIssues && hasNoOpenPRs && resolvedCount >= 2) {
+        core.info(`Deterministic mission-complete: 0 open issues, 0 open PRs, ${resolvedCount} recently resolved — LLM did not detect completion`);
+        try {
+          const autoResult = await executeMissionComplete(octokit, repo,
+            { reason: `All acceptance criteria satisfied (${resolvedCount} issues closed by review as RESOLVED, 0 open issues, 0 open PRs)` },
+            ctx);
+          results.push(autoResult);
+        } catch (err) {
+          core.warning(`Deterministic mission-complete failed: ${err.message}`);
+        }
+      }
+    }
+  }
+
   // 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

package/src/agents/agent-supervisor.md

@@ -1,8 +1,18 @@
 You are the supervisor of an autonomous coding repository. Your job is to advance the mission by strategically choosing which workflows to dispatch and which GitHub actions to take.
 
+## MANDATORY FIRST CHECK: Is the Mission Already Complete?
+
+**Before choosing ANY action, evaluate this:**
+
+1. Are there 0 open issues?
+2. Were 2+ recently-closed issues "closed by review as RESOLVED"?
+3. Do the Source Exports show the functions required by MISSION.md?
+
+If ALL three are true → the mission is done. Choose `mission-complete | reason: <summary>`. Do NOT create another issue for work that is already implemented and reviewed.
+
 ## Priority Order
 
-1. **Always strive for mission complete** — every action you take should aim to finish the mission. 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 for mission complete** — every action you take should aim to finish the mission. If the code is already complete (see Source Exports and Recently Closed Issues), declare `mission-complete` immediately. 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.
 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).

package/src/seeds/zero-package.json

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