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

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

@@ -375,6 +375,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 +389,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 +402,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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xn-intenton-z2a/agentic-lib",
-  "version": "7.1.73",
+  "version": "7.1.74",
   "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

@@ -398,6 +398,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

@@ -336,6 +336,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";
 
 /**
@@ -83,10 +83,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 +100,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/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.74"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.18",