@xn-intenton-z2a/agentic-lib 7.1.73 → 7.1.75

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

@@ -81,10 +81,10 @@ jobs:
 
             const SCHEDULE_MAP = {
               off: null,
-              weekly: '0 6 * * 1',
-              daily: '0 6 * * *',
-              hourly: '0 * * * *',
-              continuous: '*/15 * * * *',
+              weekly: '15 6 * * 1',
+              daily: '15 6 * * *',
+              hourly: '15 * * * *',
+              continuous: '5,15,25,35,45,55 * * * *',
             };
 
             // Update agentic-lib-workflow.yml schedule

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

@@ -293,44 +293,10 @@ jobs:
     outputs:
       telemetry: ${{ steps.gather.outputs.telemetry }}
 
-  # ─── Supervisor: LLM decides what to do ─────────────────────────────
-  supervisor:
-    needs: [params, pr-cleanup, telemetry]
-    if: |
-      always() &&
-      (needs.params.outputs.mode == 'full' || needs.params.outputs.mode == 'dev-only') &&
-      needs.params.result == 'success'
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-
-      - uses: actions/setup-node@v6
-        with:
-          node-version: "24"
-
-      - 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
-
-      - name: Install agentic-step dependencies
-        working-directory: .github/agentic-lib/actions/agentic-step
-        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 }}
-          COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
-        with:
-          task: "supervise"
-          config: ${{ needs.params.outputs.config-path }}
-          instructions: ".github/agentic-lib/agents/agent-supervisor.md"
-          model: ${{ needs.params.outputs.model }}
-
   # ─── Maintain: features + library (push to main) ───────────────────
+  # Runs early (parallel with pr-cleanup/telemetry) so supervisor sees features.
   maintain:
-    needs: [params, supervisor]
+    needs: [params]
     if: |
       always() &&
       (needs.params.outputs.mode == 'full' || needs.params.outputs.mode == 'maintain-only') &&
@@ -375,6 +341,7 @@ jobs:
           echo "libraryWritablePaths=${LIBRARY};${SOURCES}" >> $GITHUB_OUTPUT
 
       - name: Maintain features
+        id: maintain-features
         if: steps.mission-check.outputs.mission-complete != 'true'
         uses: ./.github/agentic-lib/actions/agentic-step
         env:
@@ -388,6 +355,7 @@ jobs:
           model: ${{ needs.params.outputs.model }}
 
       - name: Maintain library
+        id: maintain-library
         if: steps.mission-check.outputs.mission-complete != 'true'
         uses: ./.github/agentic-lib/actions/agentic-step
         env:
@@ -400,6 +368,13 @@ jobs:
           writable-paths: ${{ steps.config.outputs.libraryWritablePaths }}
           model: ${{ needs.params.outputs.model }}
 
+      - name: Log narrative thread
+        if: steps.mission-check.outputs.mission-complete != 'true'
+        run: |
+          echo "## Maintain Narrative Thread" >> $GITHUB_STEP_SUMMARY
+          echo "- **Features:** ${{ steps.maintain-features.outputs.narrative }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **Library:** ${{ steps.maintain-library.outputs.narrative }}" >> $GITHUB_STEP_SUMMARY
+
       - name: Commit and push changes
         if: github.repository != 'xn-intenton-z2a/agentic-lib' && needs.params.outputs.dry-run != 'true'
         uses: ./.github/agentic-lib/actions/commit-if-changed
@@ -407,6 +382,41 @@ jobs:
           commit-message: "agentic-step: maintain features and library"
           push-ref: ${{ github.ref_name }}
 
+  # ─── Supervisor: LLM decides what to do (after maintain has features) ──
+  supervisor:
+    needs: [params, pr-cleanup, telemetry, maintain]
+    if: |
+      always() &&
+      (needs.params.outputs.mode == 'full' || needs.params.outputs.mode == 'dev-only') &&
+      needs.params.result == 'success'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: "24"
+
+      - 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
+
+      - name: Install agentic-step dependencies
+        working-directory: .github/agentic-lib/actions/agentic-step
+        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 }}
+          COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
+        with:
+          task: "supervise"
+          config: ${{ needs.params.outputs.config-path }}
+          instructions: ".github/agentic-lib/agents/agent-supervisor.md"
+          model: ${{ needs.params.outputs.model }}
+
   # ─── Fix stuck PRs with failing checks ─────────────────────────────
   fix-stuck:
     needs: [params, supervisor]
@@ -570,7 +580,7 @@ jobs:
 
   # ─── Review: close resolved issues, enhance with criteria ──────────
   review-features:
-    needs: [params, maintain]
+    needs: [params, supervisor]
     if: |
       always() &&
       (needs.params.outputs.mode == 'full' || needs.params.outputs.mode == 'review-only') &&

package/package.json

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

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

@@ -56,6 +56,8 @@ outputs:
     description: "Action chosen by the task (e.g. request-supervisor, create-feature, nop)"
   action-arg:
     description: "Argument for the chosen action (free text)"
+  narrative:
+    description: "One-sentence English narrative of what the task did and why"
 
 runs:
   using: "node24"

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

@@ -83,19 +83,27 @@ export function generateOutline(raw, filePath) {
 }
 
 /**
- * Filter issues by recency and label quality.
+ * Filter issues by recency, init epoch, and label quality.
  *
  * @param {Array} issues - GitHub issue objects
  * @param {Object} [options]
  * @param {number} [options.staleDays=30] - Issues older than this with no activity are excluded
  * @param {boolean} [options.excludeBotOnly=true] - Exclude issues with only bot labels
+ * @param {string} [options.initTimestamp] - ISO timestamp; exclude issues created before this epoch
  * @returns {Array} Filtered issues
  */
 export function filterIssues(issues, options = {}) {
-  const { staleDays = 30, excludeBotOnly = true } = options;
+  const { staleDays = 30, excludeBotOnly = true, initTimestamp } = options;
   const cutoff = Date.now() - staleDays * 86400000;
+  const initEpoch = initTimestamp ? new Date(initTimestamp).getTime() : 0;
 
   return issues.filter((issue) => {
+    // Exclude issues created before the most recent init
+    if (initEpoch > 0) {
+      const created = new Date(issue.created_at).getTime();
+      if (created < initEpoch) return false;
+    }
+
     const lastActivity = new Date(issue.updated_at || issue.created_at).getTime();
     if (lastActivity < cutoff) return false;
 
@@ -398,6 +406,28 @@ async function _runCopilotTaskOnce({
   }
 }
 
+/**
+ * Extract a [NARRATIVE] line from an LLM response.
+ * Returns the text after the tag, or a fallback summary.
+ *
+ * @param {string} content - Raw LLM response content
+ * @param {string} [fallback] - Fallback if no [NARRATIVE] tag found
+ * @returns {string} The narrative sentence
+ */
+export function extractNarrative(content, fallback) {
+  if (!content) return fallback || "";
+  const match = content.match(/\[NARRATIVE\]\s*(.+)/);
+  if (match) return match[1].trim();
+  return fallback || "";
+}
+
+/**
+ * Narrative solicitation to append to system messages.
+ * Asks the LLM to end its response with a one-sentence summary.
+ */
+export const NARRATIVE_INSTRUCTION =
+  "\n\nAfter completing your task, end your response with a line starting with [NARRATIVE] followed by one plain English sentence describing what you did and why, for the activity log.";
+
 /**
  * Read a file, returning empty string on failure. For optional context files.
  *

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

@@ -98,6 +98,7 @@ async function run() {
     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);
+    if (result.narrative) core.setOutput("narrative", result.narrative);
 
     const profileName = config.tuning?.profileName || "unknown";
 

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

@@ -187,8 +187,10 @@ export async function discussions(context) {
       const { data: openIssues } = await octokit.rest.issues.listForRepo({
         ...repo, state: "open", per_page: 10, sort: "created", direction: "asc",
       });
+      const initTimestampForIssues = config?.init?.timestamp || null;
+      const initEpochForIssues = initTimestampForIssues ? new Date(initTimestampForIssues).getTime() : 0;
       repoContext.issuesSummary = openIssues
-        .filter((i) => !i.pull_request)
+        .filter((i) => !i.pull_request && (initEpochForIssues <= 0 || new Date(i.created_at).getTime() >= initEpochForIssues))
         .map((i) => {
           const labels = i.labels.map((l) => l.name).join(", ");
           return `#${i.number}: ${i.title} [${labels || "no labels"}]`;
@@ -238,6 +240,14 @@ export async function discussions(context) {
   }
 
   const discussion = await fetchDiscussion(octokit, discussionUrl, t.discussionComments || 10);
+
+  // Filter discussion comments to only those after the most recent init
+  const initTs = config?.init?.timestamp || null;
+  if (initTs && discussion.comments.length > 0) {
+    const initDate = new Date(initTs);
+    discussion.comments = discussion.comments.filter((c) => new Date(c.createdAt) >= initDate);
+  }
+
   const prompt = buildPrompt(discussionUrl, discussion, context, t, repoContext);
   const { content, tokensUsed, inputTokens, outputTokens, cost } = await runCopilotTask({
     model,
@@ -336,6 +346,7 @@ export async function discussions(context) {
     cost,
     model,
     details: `Action: ${action}${argSuffix}\nReply: ${replyBody.substring(0, 200)}`,
+    narrative: `Responded to discussion with action ${action}${argSuffix}.`,
     action,
     actionArg,
     replyBody,

package/src/actions/agentic-step/tasks/enhance-issue.js

@@ -102,6 +102,7 @@ async function enhanceSingleIssue({ octokit, repo, config, issueNumber, instruct
     cost,
     model,
     details: `Enhanced issue #${issueNumber} with acceptance criteria`,
+    narrative: `Enhanced issue #${issueNumber} with testable acceptance criteria.`,
   };
 }
 
@@ -173,5 +174,6 @@ export async function enhanceIssue(context) {
       .map((r) => r.details)
       .join("; ")
       .substring(0, 500)}`,
+    narrative: `Enhanced ${enhanced} issue(s) with testable acceptance criteria.`,
   };
 }

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

@@ -9,7 +9,7 @@
 import * as core from "@actions/core";
 import { readFileSync } from "fs";
 import { execSync } from "child_process";
-import { runCopilotTask, formatPathsSection } from "../copilot.js";
+import { runCopilotTask, formatPathsSection, extractNarrative, NARRATIVE_INSTRUCTION } from "../copilot.js";
 
 /**
  * Extract run_id from a check run's details_url.
@@ -100,7 +100,7 @@ async function resolveConflicts({ config, pr, prNumber, instructions, model, wri
   const t = config.tuning || {};
   const { tokensUsed, inputTokens, outputTokens, cost, content: resultContent } = await runCopilotTask({
     model,
-    systemMessage: `You are resolving git merge conflicts on PR #${prNumber}. Write resolved versions of each conflicted file, removing all conflict markers. Preserve the PR's feature intent while incorporating main's updates.`,
+    systemMessage: `You are resolving git merge conflicts on PR #${prNumber}. Write resolved versions of each conflicted file, removing all conflict markers. Preserve the PR's feature intent while incorporating main's updates.` + NARRATIVE_INSTRUCTION,
     prompt,
     writablePaths,
     tuning: t,
@@ -116,7 +116,7 @@ async function resolveConflicts({ config, pr, prNumber, instructions, model, wri
     cost,
     model,
     details: `Resolved ${conflicts.length} conflicted file(s) on PR #${prNumber}`,
-    narrative: (resultContent || "").substring(0, 2000),
+    narrative: extractNarrative(resultContent, `Resolved ${conflicts.length} merge conflict(s) on PR #${prNumber}.`),
   };
 }
 
@@ -189,7 +189,7 @@ export async function fixCode(context) {
   const t = config.tuning || {};
   const { tokensUsed, inputTokens, outputTokens, cost, content: resultContent } = await runCopilotTask({
     model,
-    systemMessage: `You are an autonomous coding agent fixing failing tests on PR #${prNumber}. Make minimal, targeted changes to fix the test failures.`,
+    systemMessage: `You are an autonomous coding agent fixing failing tests on PR #${prNumber}. Make minimal, targeted changes to fix the test failures.` + NARRATIVE_INSTRUCTION,
     prompt,
     writablePaths,
     tuning: t,
@@ -205,6 +205,6 @@ export async function fixCode(context) {
     cost,
     model,
     details: `Applied fix for ${failedChecks.length} failing check(s) on PR #${prNumber}`,
-    narrative: (resultContent || "").substring(0, 2000),
+    narrative: extractNarrative(resultContent, `Fixed ${failedChecks.length} failing check(s) on PR #${prNumber}.`),
   };
 }

package/src/actions/agentic-step/tasks/maintain-features.js

@@ -6,7 +6,7 @@
 // prunes completed/irrelevant features, and ensures quality.
 
 import { existsSync } from "fs";
-import { runCopilotTask, readOptionalFile, scanDirectory, formatPathsSection, extractFeatureSummary } from "../copilot.js";
+import { runCopilotTask, readOptionalFile, scanDirectory, formatPathsSection, extractFeatureSummary, extractNarrative, NARRATIVE_INSTRUCTION } from "../copilot.js";
 import { checkWipLimit } from "../safety.js";
 
 /**
@@ -45,13 +45,20 @@ export async function maintainFeatures(context) {
     contentLimit: t.documentSummary || 1000,
   });
 
-  const { data: closedIssues } = await octokit.rest.issues.listForRepo({
+  // Filter closed issues to only those created after the most recent init
+  const initTimestamp = config.init?.timestamp || null;
+  const initEpoch = initTimestamp ? new Date(initTimestamp).getTime() : 0;
+
+  const { data: closedIssuesRaw } = await octokit.rest.issues.listForRepo({
     ...repo,
     state: "closed",
     per_page: t.issuesScan || 20,
     sort: "updated",
     direction: "desc",
   });
+  const closedIssues = initEpoch > 0
+    ? closedIssuesRaw.filter((i) => new Date(i.created_at).getTime() >= initEpoch)
+    : closedIssuesRaw;
 
   const agentInstructions = instructions || "Maintain the feature set by creating, updating, or pruning features.";
 
@@ -68,7 +75,7 @@ export async function maintainFeatures(context) {
     libraryDocs.length > 0 ? `## Library Documents (${libraryDocs.length})` : "",
     ...libraryDocs.map((d) => `### ${d.name}\n${d.content}`),
     "",
-    `## Recently Closed Issues (${closedIssues.length})`,
+    `## Recently Closed Issues (${closedIssues.length}${initTimestamp ? `, since init ${initTimestamp}` : ""})`,
     ...closedIssues.slice(0, Math.floor((t.issuesScan || 20) / 2)).map((i) => `- #${i.number}: ${i.title}`),
     "",
     "## Your Task",
@@ -83,10 +90,10 @@ export async function maintainFeatures(context) {
     "- Feature files must be markdown with a descriptive filename (e.g. HTTP_SERVER.md)",
   ].join("\n");
 
-  const { tokensUsed, inputTokens, outputTokens, cost } = await runCopilotTask({
+  const { content: resultContent, tokensUsed, inputTokens, outputTokens, cost } = await runCopilotTask({
     model,
     systemMessage:
-      "You are a feature lifecycle manager. Create, update, and prune feature specification files to keep the project focused on its mission.",
+      "You are a feature lifecycle manager. Create, update, and prune feature specification files to keep the project focused on its mission." + NARRATIVE_INSTRUCTION,
     prompt,
     writablePaths,
     tuning: t,
@@ -100,5 +107,6 @@ export async function maintainFeatures(context) {
     cost,
     model,
     details: `Maintained features (${features.length} existing, limit ${featureLimit})`,
+    narrative: extractNarrative(resultContent, `Maintained ${features.length} features (limit ${featureLimit}).`),
   };
 }

package/src/actions/agentic-step/tasks/maintain-library.js

@@ -7,7 +7,7 @@
 
 import * as core from "@actions/core";
 import { existsSync } from "fs";
-import { runCopilotTask, readOptionalFile, scanDirectory, formatPathsSection } from "../copilot.js";
+import { runCopilotTask, readOptionalFile, scanDirectory, formatPathsSection, extractNarrative, NARRATIVE_INSTRUCTION } from "../copilot.js";
 
 /**
  * Maintain the library of knowledge documents from source URLs.
@@ -81,10 +81,10 @@ export async function maintainLibrary(context) {
     ].join("\n");
   }
 
-  const { tokensUsed, inputTokens, outputTokens, cost } = await runCopilotTask({
+  const { content: resultContent, tokensUsed, inputTokens, outputTokens, cost } = await runCopilotTask({
     model,
     systemMessage:
-      "You are a knowledge librarian. Maintain a library of technical documents extracted from web sources.",
+      "You are a knowledge librarian. Maintain a library of technical documents extracted from web sources." + NARRATIVE_INSTRUCTION,
     prompt,
     writablePaths,
     tuning: t,
@@ -103,5 +103,6 @@ export async function maintainLibrary(context) {
     cost,
     model,
     details: detailsMsg,
+    narrative: extractNarrative(resultContent, detailsMsg),
   };
 }

package/src/actions/agentic-step/tasks/resolve-issue.js

@@ -7,7 +7,7 @@
 
 import * as core from "@actions/core";
 import { checkAttemptLimit, checkWipLimit, isIssueResolved } from "../safety.js";
-import { runCopilotTask, readOptionalFile, formatPathsSection } from "../copilot.js";
+import { runCopilotTask, readOptionalFile, formatPathsSection, extractNarrative, NARRATIVE_INSTRUCTION } from "../copilot.js";
 
 /**
  * Resolve a GitHub issue by generating code and creating a PR.
@@ -81,7 +81,7 @@ export async function resolveIssue(context) {
   const t = config.tuning || {};
   const { content: resultContent, tokensUsed, inputTokens, outputTokens, cost } = await runCopilotTask({
     model,
-    systemMessage: `You are an autonomous coding agent resolving GitHub issue #${issueNumber}. Write clean, tested code. Only modify files listed under "Writable" paths. Read-only paths are for context only.`,
+    systemMessage: `You are an autonomous coding agent resolving GitHub issue #${issueNumber}. Write clean, tested code. Only modify files listed under "Writable" paths. Read-only paths are for context only.` + NARRATIVE_INSTRUCTION,
     prompt,
     writablePaths,
     tuning: t,
@@ -99,6 +99,6 @@ export async function resolveIssue(context) {
     model,
     commitUrl: null,
     details: `Generated code for issue #${issueNumber}: ${resultContent.substring(0, 200)}`,
-    narrative: (resultContent || "").substring(0, 2000),
+    narrative: extractNarrative(resultContent, `Generated code for issue #${issueNumber}.`),
   };
 }

package/src/actions/agentic-step/tasks/review-issue.js

@@ -161,6 +161,7 @@ async function reviewSingleIssue({ octokit, repo, config, targetIssueNumber, ins
       cost,
       model,
       details: `Closed issue #${targetIssueNumber}: ${verdict.substring(0, 200)}`,
+      narrative: `Reviewed issue #${targetIssueNumber} and closed it as resolved.`,
     };
   }
 
@@ -173,6 +174,7 @@ async function reviewSingleIssue({ octokit, repo, config, targetIssueNumber, ins
     cost,
     model,
     details: `Issue #${targetIssueNumber} remains open: ${verdict.substring(0, 200)}`,
+    narrative: `Reviewed issue #${targetIssueNumber} — still open, not yet resolved.`,
   };
 }
 
@@ -271,5 +273,6 @@ export async function reviewIssue(context) {
       .map((r) => r.details)
       .join("; ")
       .substring(0, 500)}`,
+    narrative: `Reviewed ${reviewed} issue(s), closed ${closed} as resolved.`,
   };
 }

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

@@ -51,6 +51,9 @@ async function gatherContext(octokit, repo, config, t) {
     : [];
   const libraryLimit = config.paths.library?.limit || 32;
 
+  // Read init timestamp for epoch boundary (used by issue filtering below)
+  const initTimestamp = config.init?.timestamp || null;
+
   const { data: openIssues } = await octokit.rest.issues.listForRepo({
     ...repo,
     state: "open",
@@ -59,7 +62,7 @@ async function gatherContext(octokit, repo, config, t) {
     direction: "asc",
   });
   const issuesOnly = openIssues.filter((i) => !i.pull_request);
-  const filteredIssues = filterIssues(issuesOnly, { staleDays: t.staleDays || 30 });
+  const filteredIssues = filterIssues(issuesOnly, { staleDays: t.staleDays || 30, initTimestamp });
   const oldestReadyIssue = filteredIssues.find((i) => i.labels.some((l) => l.name === "ready"));
   const issuesSummary = filteredIssues.map((i) => {
     const age = Math.floor((Date.now() - new Date(i.created_at).getTime()) / 86400000);
@@ -77,7 +80,11 @@ async function gatherContext(octokit, repo, config, t) {
       sort: "updated",
       direction: "desc",
     });
-    for (const ci of closedIssuesRaw.filter((i) => !i.pull_request)) {
+    const initEpoch = initTimestamp ? new Date(initTimestamp).getTime() : 0;
+    const closedIssuesFiltered = closedIssuesRaw.filter((i) =>
+      !i.pull_request && (initEpoch <= 0 || new Date(i.created_at).getTime() >= initEpoch)
+    );
+    for (const ci of closedIssuesFiltered) {
       let closeReason = "closed";
       try {
         const { data: comments } = await octokit.rest.issues.listComments({
@@ -110,9 +117,6 @@ async function gatherContext(octokit, repo, config, t) {
     return `#${pr.number}: ${pr.title} (${pr.head.ref}) [${labels || "no labels"}] (${age}d old)`;
   });
 
-  // Read init timestamp for epoch boundary
-  const initTimestamp = config.init?.timestamp || null;
-
   let workflowsSummary = [];
   let actionsSinceInit = [];
   try {

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

@@ -7,7 +7,7 @@
 
 import * as core from "@actions/core";
 import { writeFileSync, existsSync } from "fs";
-import { runCopilotTask, readOptionalFile, scanDirectory, formatPathsSection, filterIssues, summariseIssue, extractFeatureSummary } from "../copilot.js";
+import { runCopilotTask, readOptionalFile, scanDirectory, formatPathsSection, filterIssues, summariseIssue, extractFeatureSummary, extractNarrative, NARRATIVE_INSTRUCTION } from "../copilot.js";
 
 /**
  * Run the full transformation pipeline from mission to code.
@@ -162,7 +162,7 @@ export async function transform(context) {
   } = await runCopilotTask({
     model,
     systemMessage:
-      "You are an autonomous code transformation agent. Your goal is to advance the repository toward its mission by making the most impactful change possible in a single step.",
+      "You are an autonomous code transformation agent. Your goal is to advance the repository toward its mission by making the most impactful change possible in a single step." + NARRATIVE_INSTRUCTION,
     prompt,
     writablePaths,
     tuning: t,
@@ -201,7 +201,7 @@ export async function transform(context) {
     cost,
     model,
     details: resultContent.substring(0, 500),
-    narrative: (resultContent || "").substring(0, 2000),
+    narrative: extractNarrative(resultContent, "Transformation step completed."),
     promptBudget,
     contextNotes: `Transformed with ${sourceFiles.length} source files (mtime-sorted, cleaned), ${features.length} features, ${openIssues.length} issues (${rawIssues.length - openIssues.length} stale filtered).`,
   };
@@ -324,7 +324,7 @@ async function transformTdd({
   const phase2 = await runCopilotTask({
     model,
     systemMessage:
-      "You are a TDD agent. A failing test was written in Phase 1. Write the minimum implementation to make it pass. Do not modify the test.",
+      "You are a TDD agent. A failing test was written in Phase 1. Write the minimum implementation to make it pass. Do not modify the test." + NARRATIVE_INSTRUCTION,
     prompt: implPrompt,
     writablePaths,
     tuning: t,
@@ -341,5 +341,6 @@ async function transformTdd({
     cost: (phase1.cost || 0) + (phase2.cost || 0),
     model,
     details: `TDD transformation: Phase 1 (failing test) + Phase 2 (implementation). ${testResult.substring(0, 200)}`,
+    narrative: extractNarrative(phase2.content, "TDD transformation: wrote failing test then implementation."),
   };
 }

package/src/seeds/zero-package.json

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