@xn-intenton-z2a/agentic-lib 7.1.59 → 7.1.61

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,6 +86,9 @@ 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
         with:
@@ -114,8 +117,19 @@ 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 }}
@@ -126,3 +140,18 @@ jobs:
           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

@@ -154,7 +154,7 @@ jobs:
           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,7 +203,7 @@ jobs:
       - run: npm test
 
       - name: Update schedule (if requested)
-        if: needs.params.outputs.schedule != '' && needs.params.outputs.dry-run != 'true'
+        if: github.repository != 'xn-intenton-z2a/agentic-lib' && needs.params.outputs.schedule != '' && needs.params.outputs.dry-run != 'true'
         uses: actions/github-script@v7
         with:
           script: |
@@ -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

@@ -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-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,11 +149,11 @@ 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
+        if: github.repository != 'xn-intenton-z2a/agentic-lib' && needs.params.outputs.dry-run != 'true'
         uses: actions/github-script@v7
         with:
           script: |
@@ -214,8 +221,7 @@ 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
@@ -292,7 +298,6 @@ 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
@@ -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 }}
@@ -382,7 +388,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,7 +399,6 @@ 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
@@ -533,7 +538,7 @@ jobs:
           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 != ''
         uses: ./.github/agentic-lib/actions/commit-if-changed
         with:
           commit-message: "agentic-step: fix failing tests / resolve conflicts"
@@ -674,14 +679,14 @@ jobs:
           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'
+        if: github.repository != 'xn-intenton-z2a/agentic-lib' && steps.issue.outputs.issue-number != '' && needs.params.outputs.dry-run != 'true'
         uses: actions/github-script@v7
         with:
           script: |

package/agentic-lib.toml

@@ -38,9 +38,17 @@ library-limit = 32
 # Profile sets defaults for all tuning knobs: min | recommended | max
 # min = fast & cheap (CI testing), recommended = balanced, max = thorough
 profile = "min"                                  #@dist "recommended"
-model = "gpt-5-mini"              # gpt-5-mini | claude-sonnet-4 | gpt-4.1
+#
+# Model selection — each has different strengths:
+#   gpt-5-mini      — Fast, cheap, supports reasoning-effort. Best for CI and iteration.
+#   claude-sonnet-4  — Strong code quality, nuanced reasoning. Best for complex transforms.
+#   gpt-4.1         — High capability, large context. Best for thorough analysis.
+# Note: reasoning-effort only works with gpt-5-mini and o4-mini.
+# For other models it is automatically skipped.
+model = "gpt-5-mini"
+#
 # Override individual knobs below. Omit or comment out to use profile defaults.
-# reasoning-effort = "low"       # low | medium | high | xhigh
+# reasoning-effort = "low"       # low | medium | high | none (none = disable entirely)
 infinite-sessions = false        # set to true for long sessions with compaction
 # features-scan = 3              # feature files to include in prompts
 # source-scan = 3                # source files to include

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xn-intenton-z2a/agentic-lib",
-  "version": "7.1.59",
+  "version": "7.1.61",
   "description": "Agentic-lib Agentic Coding Systems SDK powering automated GitHub workflows.",
   "type": "module",
   "scripts": {
@@ -29,19 +29,17 @@
   "license": "GPL-3.0, MIT",
   "devDependencies": {
     "@microsoft/eslint-formatter-sarif": "^3.1.0",
-    "eslint": "^9.25.0",
+    "eslint": "^9.39.3",
     "eslint-config-google": "^0.14.0",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-import": "^2.31.0",
-    "eslint-plugin-prettier": "^5.4.0",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-prettier": "^5.5.5",
     "eslint-plugin-promise": "^7.2.1",
-    "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-security": "^4.0.0",
-    "eslint-plugin-sonarjs": "^4.0.0",
-    "js-yaml": "^4.1.0",
-    "markdown-it": "^14.1.0",
+    "eslint-plugin-sonarjs": "^4.0.1",
+    "js-yaml": "^4.1.1",
+    "markdown-it": "^14.1.1",
     "markdown-it-github": "^0.5.0",
-    "npm-check-updates": "^19.6.3",
     "prettier": "^3.8.1",
     "vitest": "^4.0.18"
   },
@@ -85,7 +83,8 @@
     "src/mcp/"
   ],
   "overrides": {
-    "minimatch": ">=10.2.3"
+    "minimatch": ">=10.2.3",
+    "@github/copilot": ">=0.0.423"
   },
   "repository": {
     "type": "git",
@@ -99,8 +98,8 @@
   "dependencies": {
     "@actions/core": "^3.0.0",
     "@actions/github": "^9.0.0",
-    "@github/copilot-sdk": "^0.1.29",
-    "@modelcontextprotocol/sdk": "^1.27.0",
+    "@github/copilot-sdk": "^0.1.31-unstable.0",
+    "@modelcontextprotocol/sdk": "^1.27.1",
     "smol-toml": "^1.6.0"
   }
 }

package/src/actions/agentic-step/action.yml

@@ -52,6 +52,10 @@ outputs:
     description: "Total tokens consumed by the Copilot SDK"
   model:
     description: "Model used for the completion"
+  action:
+    description: "Action chosen by the task (e.g. request-supervisor, create-feature, nop)"
+  action-arg:
+    description: "Argument for the chosen action (free text)"
 
 runs:
   using: "node24"

package/src/actions/agentic-step/config-loader.js

@@ -116,9 +116,12 @@ function readPackageJson(tomlPath, depsRelPath) {
 function resolveTuning(tuningSection) {
   const profileName = tuningSection.profile || "recommended";
   const profile = TUNING_PROFILES[profileName] || TUNING_PROFILES.recommended;
-  const tuning = { ...profile };
+  const tuning = { ...profile, profileName };
 
-  if (tuningSection["reasoning-effort"]) tuning.reasoningEffort = tuningSection["reasoning-effort"];
+  // "none" explicitly disables reasoning-effort regardless of profile
+  if (tuningSection["reasoning-effort"]) {
+    tuning.reasoningEffort = tuningSection["reasoning-effort"] === "none" ? "" : tuningSection["reasoning-effort"];
+  }
   if (tuningSection["infinite-sessions"] === true || tuningSection["infinite-sessions"] === false) {
     tuning.infiniteSessions = tuningSection["infinite-sessions"];
   }

package/src/actions/agentic-step/copilot.js

@@ -10,6 +10,11 @@ import { join } from "path";
 import { createAgentTools } from "./tools.js";
 import * as core from "@actions/core";
 
+// Models known to support the reasoningEffort SessionConfig parameter.
+// Updated from Copilot SDK ModelInfo.supportedReasoningEfforts (v0.1.30).
+// When in doubt, omit reasoning-effort — the SDK uses its default.
+const MODELS_SUPPORTING_REASONING_EFFORT = new Set(["gpt-5-mini", "o4-mini"]);
+
 /**
  * Build the CopilotClient options for authentication.
  *
@@ -38,6 +43,34 @@ export function buildClientOptions(githubToken) {
   return { env };
 }
 
+/**
+ * Log tuning parameter application with profile context.
+ *
+ * @param {string} param - Parameter name
+ * @param {*} value - Resolved value being applied
+ * @param {string} profileName - Profile the default came from
+ * @param {string} model - Model being used
+ * @param {Object} [clip] - Optional clipping info { available, requested }
+ */
+export function logTuningParam(param, value, profileName, model, clip) {
+  const clipInfo = clip
+    ? ` (requested=${clip.requested}, available=${clip.available}, excess=${clip.requested - clip.available})`
+    : "";
+  core.info(`[tuning] ${param}=${value} profile=${profileName} model=${model}${clipInfo}`);
+}
+
+/**
+ * Check if a model supports reasoningEffort.
+ * Uses the static allowlist; at runtime the SDK's models.list() could be used
+ * but that requires an authenticated client which isn't available at config time.
+ *
+ * @param {string} model - Model name
+ * @returns {boolean}
+ */
+export function supportsReasoningEffort(model) {
+  return MODELS_SUPPORTING_REASONING_EFFORT.has(model);
+}
+
 /**
  * Run a Copilot SDK session and return the response.
  * Handles the full lifecycle: create client → create session → send → stop.
@@ -49,11 +82,21 @@ export function buildClientOptions(githubToken) {
  * @param {string[]} options.writablePaths - Paths the agent may modify
  * @param {string} [options.githubToken] - Optional token; falls back to COPILOT_GITHUB_TOKEN env var.
  * @param {Object} [options.tuning] - Tuning config (reasoningEffort, infiniteSessions)
+ * @param {string} [options.profileName] - Profile name for logging
  * @returns {Promise<{content: string, tokensUsed: number}>}
  */
-export async function runCopilotTask({ model, systemMessage, prompt, writablePaths, githubToken, tuning }) {
+export async function runCopilotTask({
+  model,
+  systemMessage,
+  prompt,
+  writablePaths,
+  githubToken,
+  tuning,
+  profileName,
+}) {
+  const profile = profileName || "unknown";
   core.info(
-    `[copilot] Creating client (model=${model}, promptLen=${prompt.length}, writablePaths=${writablePaths.length}, tuning=${tuning?.reasoningEffort || "default"})`,
+    `[copilot] Creating client (model=${model}, promptLen=${prompt.length}, writablePaths=${writablePaths.length}, tuning=${tuning?.reasoningEffort || "default"}, profile=${profile})`,
   );
 
   const clientOptions = buildClientOptions(githubToken);
@@ -68,12 +111,32 @@ export async function runCopilotTask({ model, systemMessage, prompt, writablePat
       onPermissionRequest: approveAll,
       workingDirectory: process.cwd(),
     };
-    if (tuning?.reasoningEffort) {
-      sessionConfig.reasoningEffort = tuning.reasoningEffort;
+
+    // Only set reasoningEffort for models that support it
+    if (tuning?.reasoningEffort && tuning.reasoningEffort !== "none") {
+      if (supportsReasoningEffort(model)) {
+        sessionConfig.reasoningEffort = tuning.reasoningEffort;
+        logTuningParam("reasoningEffort", tuning.reasoningEffort, profile, model);
+      } else {
+        core.info(
+          `[copilot] Skipping reasoningEffort="${tuning.reasoningEffort}" — not supported by model "${model}". Only supported by: ${[...MODELS_SUPPORTING_REASONING_EFFORT].join(", ")}`,
+        );
+      }
     }
+
     if (tuning?.infiniteSessions === true) {
       sessionConfig.infiniteSessions = {};
+      logTuningParam("infiniteSessions", true, profile, model);
     }
+
+    // Log scan/context tuning params
+    if (tuning?.featuresScan) logTuningParam("featuresScan", tuning.featuresScan, profile, model);
+    if (tuning?.sourceScan) logTuningParam("sourceScan", tuning.sourceScan, profile, model);
+    if (tuning?.sourceContent) logTuningParam("sourceContent", tuning.sourceContent, profile, model);
+    if (tuning?.issuesScan) logTuningParam("issuesScan", tuning.issuesScan, profile, model);
+    if (tuning?.documentSummary) logTuningParam("documentSummary", tuning.documentSummary, profile, model);
+    if (tuning?.discussionComments) logTuningParam("discussionComments", tuning.discussionComments, profile, model);
+
     const session = await client.createSession(sessionConfig);
     core.info(`[copilot] Session created: ${session.sessionId}`);
 
@@ -105,7 +168,9 @@ export async function runCopilotTask({ model, systemMessage, prompt, writablePat
         totalInputTokens += input;
         totalOutputTokens += output;
         totalCost += cost;
-        core.info(`[copilot] event=${eventType}: model=${d.model} input=${input} output=${output} cacheRead=${cacheRead} cost=${cost}`);
+        core.info(
+          `[copilot] event=${eventType}: model=${d.model} input=${input} output=${output} cacheRead=${cacheRead} cost=${cost}`,
+        );
       } else if (eventType === "session.idle") {
         core.info(`[copilot] event=${eventType}`);
       } else if (eventType === "session.error") {
@@ -161,18 +226,31 @@ export function scanDirectory(dirPath, extensions, options = {}) {
 
   if (!existsSync(dirPath)) return [];
 
-  return readdirSync(dirPath, recursive ? { recursive: true } : undefined)
-    .filter((f) => exts.some((ext) => f.endsWith(ext)))
-    .slice(0, fileLimit)
-    .map((f) => {
-      try {
-        const content = readFileSync(join(dirPath, f), "utf8");
-        return { name: f, content: contentLimit ? content.substring(0, contentLimit) : content };
-      } catch (err) {
-        core.debug(`[scanDirectory] ${join(dirPath, f)}: ${err.message}`);
-        return { name: f, content: "" };
+  const allFiles = readdirSync(dirPath, recursive ? { recursive: true } : undefined).filter((f) =>
+    exts.some((ext) => f.endsWith(ext)),
+  );
+  const clipped = allFiles.slice(0, fileLimit);
+  if (allFiles.length > fileLimit) {
+    core.info(
+      `[scanDirectory] Clipped ${dirPath}: ${allFiles.length} files found, returning ${fileLimit} (excess=${allFiles.length - fileLimit})`,
+    );
+  }
+
+  return clipped.map((f) => {
+    try {
+      const raw = readFileSync(join(dirPath, f), "utf8");
+      const content = contentLimit ? raw.substring(0, contentLimit) : raw;
+      if (contentLimit && raw.length > contentLimit) {
+        core.info(
+          `[scanDirectory] Clipped ${f}: ${raw.length} chars, returning ${contentLimit} (excess=${raw.length - contentLimit})`,
+        );
       }
-    });
+      return { name: f, content };
+    } catch (err) {
+      core.debug(`[scanDirectory] ${join(dirPath, f)}: ${err.message}`);
+      return { name: f, content: "" };
+    }
+  });
 }
 
 /**

package/src/actions/agentic-step/index.js

@@ -95,6 +95,8 @@ async function run() {
     if (result.prNumber) core.setOutput("pr-number", String(result.prNumber));
     if (result.tokensUsed) core.setOutput("tokens-used", String(result.tokensUsed));
     if (result.model) core.setOutput("model", result.model);
+    if (result.action) core.setOutput("action", result.action);
+    if (result.actionArg) core.setOutput("action-arg", result.actionArg);
 
     // Log to intentïon.md (commit-if-changed excludes this on non-default branches)
     const intentionFilepath = config.intentionBot?.intentionFilepath;

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

@@ -13,6 +13,10 @@ async function gatherContext(octokit, repo, config, t) {
   const mission = readOptionalFile(config.paths.mission.path);
   const recentActivity = readOptionalFile(config.intentionBot.intentionFilepath).split("\n").slice(-20).join("\n");
 
+  // Extract discussion URL from recent activity for supervisor reporting
+  const discussionUrlMatch = recentActivity.match(/https:\/\/github\.com\/[^/]+\/[^/]+\/discussions\/\d+/);
+  const activeDiscussionUrl = discussionUrlMatch ? discussionUrlMatch[0] : "";
+
   const featuresPath = config.paths.features.path;
   const featureNames = existsSync(featuresPath)
     ? scanDirectory(featuresPath, ".md").map((f) => f.name.replace(".md", ""))
@@ -80,6 +84,7 @@ async function gatherContext(octokit, repo, config, t) {
     packageJson: config.packageJson,
     featureIssuesWipLimit: config.featureDevelopmentIssuesWipLimit,
     maintenanceIssuesWipLimit: config.maintenanceIssuesWipLimit,
+    activeDiscussionUrl,
   };
 }
 
@@ -118,6 +123,7 @@ function buildPrompt(ctx, agentInstructions) {
     "```",
     "",
     ...(ctx.packageJson ? ["### Dependencies (package.json)", "```json", ctx.packageJson, "```", ""] : []),
+    ...(ctx.activeDiscussionUrl ? [`### Active Discussion`, `${ctx.activeDiscussionUrl}`, ""] : []),
     ...(ctx.oldestReadyIssue
       ? [`### Oldest Ready Issue`, `#${ctx.oldestReadyIssue.number}: ${ctx.oldestReadyIssue.title}`, ""]
       : []),

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

@@ -109,6 +109,13 @@ export async function transform(context) {
     "Determine the single most impactful next step to transform this repository.",
     "Then implement that step.",
     "",
+    "## When NOT to make changes",
+    "If the existing code already satisfies all requirements in MISSION.md and all open issues have been addressed:",
+    "- Do NOT make cosmetic changes (reformatting, renaming, reordering)",
+    "- Do NOT add features beyond what MISSION.md specifies",
+    "- Do NOT rewrite working code for stylistic preferences",
+    "- Instead, report that the mission is satisfied and make no file changes",
+    "",
     formatPathsSection(writablePaths, readOnlyPaths, config),
     "",
     "## Constraints",

package/src/agents/agent-discussion-bot.md

@@ -8,12 +8,32 @@ You are the voice of this GitHub repository. You exist as this repository — re
 - **Be engaging.** Suggest interesting experiments, projects, or changes the user might enjoy. Encourage them to try things and ask questions.
 - **Don't dump capabilities.** Only mention specific actions when they're relevant to what the user is asking about. Don't list all your actions in every response.
 
+## Scope — Stay On Topic
+
+You are this repository. Only discuss topics related to:
+- The current mission (MISSION.md) and its progress
+- The code, tests, features, and issues in this repository
+- How to use, clone, or contribute to this project
+- Experiments and ideas that relate to the project's purpose
+- The autonomous development pipeline and how it works
+
+If someone asks about something completely unrelated to this repository (e.g. trivia, unrelated topics, general knowledge):
+- Politely redirect: "That's outside my scope — I'm focused on this repository's mission. Want to hear about what I'm working on instead?"
+- Use it as an opportunity to engage them with the project: suggest an experiment, ask what they'd like to build, or share recent progress.
+
 ## Mission Alignment
 
 Your mission comes from MISSION.md. Everything you do should serve that mission.
 - If a user requests something that contradicts the mission, push back politely and suggest an aligned alternative.
 - Be proactive about suggesting features that advance the mission without needing to be asked.
 
+## Encouraging Engagement
+
+- When users visit, invite them to participate: "Want to try changing the mission and see what happens?"
+- Share concrete progress: "I just completed X — here's what changed."
+- Suggest experiments: "You could fork this and set MISSION.md to build a [specific idea]. Want to try?"
+- Ask what they think about the current direction.
+
 ## Supervisor Integration
 
 You work with a supervisor system that orchestrates the repository's workflows. When a user requests an action:

package/src/agents/agent-supervisor.md

@@ -67,6 +67,23 @@ When the transform agent has implemented all major features but minor polish rem
 
 - The `set-schedule` action requires a `WORKFLOW_TOKEN` secret (classic PAT with `workflow` scope) to push workflow file changes to main.
 
+## Stability Detection
+
+Check the Recent Activity log for patterns that indicate the mission is done:
+- If the last 2+ workflow runs produced no transform commits (only maintain-only or nop outcomes), AND all open issues are closed, the mission is likely accomplished. Follow the "Mission Accomplished" protocol above.
+- Look for `transform: nop` or `transform: transformed` patterns in the activity log to distinguish productive iterations from idle ones.
+
+## Discussions Awareness
+
+Check the Recent Activity log for discussion bot referrals (lines containing `discussion-request-supervisor`). These indicate a user asked the bot something that requires supervisor action. **Prioritise responding to these referrals.**
+
+Also check for notable progress worth reporting:
+- Mission milestones achieved (all core functions implemented, all tests passing)
+- Schedule changes (mission accomplished, throttling down)
+- Significant code changes (large PRs merged, new features completed)
+
+When notable progress exists or there are unresponded referrals, use `respond:discussions | message: <status update> | discussion-url: <url>` to post an update. Keep it concise — 2-3 sentences summarising what happened and what's next.
+
 ## Guidelines
 
 - Pick multiple actions when appropriate — concurrent work is encouraged.

package/src/seeds/zero-SOURCES.md

@@ -5,4 +5,4 @@ Reference material and documentation sources for this project.
 Add URLs, papers, API docs, or other reference material here.
 The maintain-library workflow will process these into `library/` documents.
 
-- https://en.wikipedia.org/wiki/Fizz_buzz
+- https://github.com/xn-intenton-z2a/repository0

package/src/seeds/zero-package.json

@@ -14,7 +14,7 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@xn-intenton-z2a/agentic-lib": "^7.1.59"
+    "@xn-intenton-z2a/agentic-lib": "^7.1.61"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.18",