@xn-intenton-z2a/agentic-lib 7.4.8 → 7.4.9

package/bin/agentic-lib.js

@@ -37,7 +37,7 @@ const TASK_AGENT_MAP = {
   "maintain-library": "agent-maintain-library",
 };
 const INIT_COMMANDS = ["init", "update", "reset"];
-const ALL_COMMANDS = [...INIT_COMMANDS, ...TASK_COMMANDS, "version", "mcp", "iterate"];
+const ALL_COMMANDS = [...INIT_COMMANDS, ...TASK_COMMANDS, "version", "iterate"];
 
 const HELP = `
 @xn-intenton-z2a/agentic-lib — Agentic Coding Systems SDK
@@ -61,9 +61,6 @@ Iterator:
   iterate --here       Discover the project and generate a MISSION.md, then iterate
   iterate --list-missions  List available built-in mission seeds
 
-MCP Server:
-  mcp                  Start MCP server (for Claude Code, Cursor, etc.)
-
 Options:
   --purge              Full reset — clear features, activity log, source code
   --reseed             Clear features + activity log (keep source code)
@@ -135,13 +132,6 @@ const discussionUrl = discussionIdx >= 0 ? flags[discussionIdx + 1] : "";
 
 // ─── Task Commands ───────────────────────────────────────────────────
 
-if (command === "mcp") {
-  const { startServer } = await import("../src/mcp/server.js");
-  await startServer();
-  // Server runs until stdin closes — don't exit
-  await new Promise(() => {}); // block forever
-}
-
 if (command === "iterate") {
   process.exit(await runIterate());
 }
@@ -215,10 +205,10 @@ async function runIterate() {
       console.log("");
 
       const discoveryPrompt = loadAgentPrompt("agent-discovery");
-      const { runHybridSession } = await import("../src/copilot/hybrid-session.js");
+      const { runCopilotSession } = await import("../src/copilot/copilot-session.js");
       const effectiveModel = model || config.model || "gpt-5-mini";
 
-      const discoveryResult = await runHybridSession({
+      const discoveryResult = await runCopilotSession({
         workspacePath: target,
         model: effectiveModel,
         tuning: config.tuning || {},
@@ -298,8 +288,8 @@ async function runIterate() {
     );
   }
 
-  const { runHybridSession } = await import("../src/copilot/hybrid-session.js");
-  const { gatherLocalContext, gatherGitHubContext, buildUserPrompt } = await import("../src/copilot/context.js");
+  const { runCopilotSession } = await import("../src/copilot/copilot-session.js");
+  const { readOptionalFile } = await import("../src/copilot/session.js");
 
   // Load agent prompt: --agent flag > default agent-iterate
   const agentName = agentFlag || "agent-iterate";
@@ -322,32 +312,26 @@ async function runIterate() {
   if (discussionUrl) console.log(`Discussion: ${discussionUrl}`);
   console.log("");
 
-  // Gather context for the agent
-  const localContext = gatherLocalContext(target, config);
-
-  // Optionally gather GitHub context
-  let githubContext;
-  if (issueNumber || prNumber || discussionUrl) {
-    console.log("Fetching GitHub context...");
-    githubContext = gatherGitHubContext({
-      issueNumber: issueNumber || undefined,
-      prNumber: prNumber || undefined,
-      discussionUrl: discussionUrl || undefined,
-      workspacePath: target,
-    });
-  }
-
-  // Build context-aware user prompt
-  const { prompt: userPrompt } = buildUserPrompt(agentName, localContext, githubContext, {
-    tuning: config.tuning,
-    config,
-  });
+  // Build lean prompt — the model explores via tools (read_file, list_files, run_command)
+  const missionPath = resolve(target, config.paths?.mission?.path || "MISSION.md");
+  const missionContent = readOptionalFile(missionPath, 2000) || "(no mission defined)";
+  const userPrompt = [
+    "## Mission",
+    missionContent,
+    "",
+    "## Your Task",
+    "Use list_files to explore the repository, read_file to examine source code and tests,",
+    "and run_command to run the test suite. Write code to advance the mission.",
+    ...(issueNumber ? [``, `Focus on issue #${issueNumber}.`] : []),
+    ...(prNumber ? [``, `Focus on PR #${prNumber}.`] : []),
+    ...(discussionUrl ? [``, `Discussion context: ${discussionUrl}`] : []),
+  ].join("\n");
 
   // Derive maxToolCalls from transformation budget
   const budget = config.transformationBudget || 0;
   const effectiveMaxToolCalls = budget > 0 ? budget * 20 : undefined;
 
-  const result = await runHybridSession({
+  const result = await runCopilotSession({
     workspacePath: target,
     model: effectiveModel,
     tuning: config.tuning || {},
@@ -423,31 +407,31 @@ async function runTask(taskName) {
 
   try {
     const { loadAgentPrompt } = await import("../src/copilot/agents.js");
-    const { runHybridSession } = await import("../src/copilot/hybrid-session.js");
-    const { gatherLocalContext, gatherGitHubContext, buildUserPrompt } = await import("../src/copilot/context.js");
+    const { runCopilotSession } = await import("../src/copilot/copilot-session.js");
+    const { readOptionalFile } = await import("../src/copilot/session.js");
 
     const agentPrompt = loadAgentPrompt(agentName);
-    const localContext = gatherLocalContext(target, config);
-
-    let githubContext;
-    if (issueNumber || prNumber) {
-      githubContext = gatherGitHubContext({
-        issueNumber: issueNumber || undefined,
-        prNumber: prNumber || undefined,
-        workspacePath: target,
-      });
-    }
 
-    const { prompt: userPrompt, promptBudget } = buildUserPrompt(agentName, localContext, githubContext, {
-      tuning: config.tuning,
-      config,
-    });
+    // Build lean prompt — the model explores via tools (read_file, list_files, run_command)
+    const missionPath = resolve(target, config.paths?.mission?.path || config.paths?.mission || "MISSION.md");
+    const missionContent = readOptionalFile(missionPath, 2000) || "(no mission defined)";
+    const userPrompt = [
+      "## Mission",
+      missionContent,
+      "",
+      "## Your Task",
+      "Use list_files to explore the repository, read_file to examine source code and tests,",
+      "and run_command to run the test suite. Write code to advance the mission.",
+      ...(issueNumber ? [``, `Focus on issue #${issueNumber}.`] : []),
+      ...(prNumber ? [``, `Focus on PR #${prNumber}.`] : []),
+      ...(discussionUrl ? [``, `Discussion context: ${discussionUrl}`] : []),
+    ].join("\n");
 
     // Derive maxToolCalls from transformation budget (budget × 20, or unlimited)
     const budget = config.transformationBudget || 0;
     const effectiveMaxToolCalls = budget > 0 ? budget * 20 : undefined;
 
-    const result = await runHybridSession({
+    const result = await runCopilotSession({
       workspacePath: target,
       model: effectiveModel,
       tuning: config.tuning || {},
@@ -469,12 +453,6 @@ async function runTask(taskName) {
     console.log(`Tool calls:    ${result.toolCalls}`);
     console.log(`Tokens:        ${tokensUsed} (in=${result.tokensIn} out=${result.tokensOut})`);
     if (result.narrative) console.log(`Narrative: ${result.narrative}`);
-    if (promptBudget) {
-      console.log("Prompt budget:");
-      for (const entry of promptBudget) {
-        console.log(`  ${entry.section}: ${entry.size} chars, ${entry.files} files ${entry.notes}`);
-      }
-    }
     console.log("");
     return result.success ? 0 : 1;
   } catch (err) {
@@ -575,6 +553,16 @@ function initActions(agenticDir) {
   }
 }
 
+function initAgents(dstDir) {
+  console.log("\n--- Agents ---");
+  const agentsSrcDir = resolve(pkgRoot, ".github/agents");
+  if (!existsSync(agentsSrcDir)) return;
+  for (const entry of readdirSync(agentsSrcDir, { withFileTypes: true })) {
+    if (!entry.isFile()) continue;
+    initCopyFile(resolve(agentsSrcDir, entry.name), resolve(dstDir, entry.name), `agents/${entry.name}`);
+  }
+}
+
 function initDirContents(srcSubdir, dstDir, label, excludeFiles = []) {
   console.log(`\n--- ${label} ---`);
   const dir = resolve(srcDir, srcSubdir);
@@ -770,6 +758,7 @@ function initPurge(seedsDir, missionName, initTimestamp) {
     "zero-package.json": "package.json",
     "zero-README.md": "README.md",
     "zero-.gitignore": ".gitignore",
+    "zero-SCREENSHOT_INDEX.png": "SCREENSHOT_INDEX.png",
   };
   for (const [seedFile, targetRel] of Object.entries(SEED_MAP)) {
     const src = resolve(seedsDir, seedFile);
@@ -1271,7 +1260,7 @@ function runInit() {
   initWorkflows();
   initActions(agenticDir);
   initDirContents("copilot", resolve(agenticDir, "copilot"), "Copilot (shared modules)");
-  initDirContents("agents", resolve(target, ".github/agents"), "Agents", ["agentic-lib.yml"]);
+  initAgents(resolve(target, ".github/agents"));
   // Remove stale legacy agents directory
   const legacyAgentsDir = resolve(agenticDir, "agents");
   if (existsSync(legacyAgentsDir)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xn-intenton-z2a/agentic-lib",
-  "version": "7.4.8",
+  "version": "7.4.9",
   "description": "Agentic-lib Agentic Coding Systems SDK powering automated GitHub workflows.",
   "type": "module",
   "scripts": {
@@ -79,10 +79,9 @@
     "src/actions/agentic-step/tasks/",
     "src/actions/commit-if-changed/",
     "src/actions/setup-npmrc/",
-    "src/agents/",
+    ".github/agents/",
     "src/seeds/",
-    "src/scripts/",
-    "src/mcp/"
+    "src/scripts/"
   ],
   "overrides": {
     "minimatch": ">=10.2.3",

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

@@ -16,7 +16,7 @@ inputs:
       maintain-library, enhance-issue, review-issue, discussions, supervise
     required: true
   config:
-    description: "Path to agentic-lib.yml configuration file"
+    description: "Path to agentic-lib.toml configuration file"
     required: false
     default: "agentic-lib.toml"
   instructions:

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

@@ -39,7 +39,6 @@ import {
   scanDirectory as _scanDirectory,
   buildClientOptions as _buildClientOptions,
   logTuningParam as _logTuningParam,
-  runCopilotTask as _runCopilotTask,
 } from "../../copilot/session.js";
 
 export function readOptionalFile(filePath, limit) {
@@ -57,7 +56,3 @@ export function buildClientOptions(githubToken) {
 export function logTuningParam(param, value, profileName, model, clip) {
   return _logTuningParam(param, value, profileName, model, clip, actionsLogger);
 }
-
-export async function runCopilotTask(options) {
-  return _runCopilotTask({ ...options, logger: actionsLogger });
-}

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

@@ -9,7 +9,7 @@ import * as core from "@actions/core";
 import * as github from "@actions/github";
 import { loadConfig, getWritablePaths } from "./config-loader.js";
 import { logActivity, generateClosingNotes } from "./logging.js";
-import { readFileSync } from "fs";
+import { readFileSync, existsSync } from "fs";
 import {
   buildMissionMetrics, buildMissionReadiness,
   computeTransformationCost, readCumulativeCost, buildLimitsStatus,
@@ -60,6 +60,12 @@ async function run() {
     const handler = TASKS[task];
     if (!handler) throw new Error(`Unknown task: ${task}. Available: ${Object.keys(TASKS).join(", ")}`);
 
+    // Resolve log and screenshot paths (fetched from agentic-lib-logs branch by workflow)
+    const logFile = config.intentionBot?.intentionFilepath || "intenti\u00F6n.md";
+    const screenshotFile = config.intentionBot?.screenshotFile || "SCREENSHOT_INDEX.png";
+    const logFilePath = existsSync(logFile) ? logFile : null;
+    const screenshotFilePath = existsSync(screenshotFile) ? screenshotFile : null;
+
     const context = {
       task, config, instructions, issueNumber, writablePaths, testCommand, model,
       prNumber: core.getInput("pr-number"),
@@ -68,6 +74,7 @@ async function run() {
       commentCreatedAt: core.getInput("comment-created-at"),
       octokit: github.getOctokit(process.env.GITHUB_TOKEN),
       repo: github.context.repo, github: github.context,
+      logFilePath, screenshotFilePath,
     };
 
     const startTime = Date.now();

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

@@ -5,8 +5,9 @@
 // Appends structured entries to the intentïon.md activity log,
 // including commit URLs and safety-check outcomes.
 
-import { writeFileSync, readFileSync, appendFileSync, existsSync, mkdirSync } from "fs";
-import { dirname } from "path";
+import { writeFileSync, readFileSync, appendFileSync, existsSync, mkdirSync, copyFileSync } from "fs";
+import { dirname, basename } from "path";
+import { join } from "path";
 import * as core from "@actions/core";
 
 /**
@@ -158,6 +159,17 @@ export function logActivity({
   } else {
     writeFileSync(filepath, `# intentïon Activity Log\n${entry}`);
   }
+
+  // Write ASCII fallback copy (intention.md) for systems that can't handle UTF-8 filenames
+  const name = basename(filepath);
+  if (name !== "intention.md" && name.includes("intenti")) {
+    const fallbackPath = join(dirname(filepath), "intention.md");
+    try {
+      copyFileSync(filepath, fallbackPath);
+    } catch {
+      // Best-effort — don't fail the log if the copy fails
+    }
+  }
 }
 
 /**

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

@@ -2,13 +2,15 @@
 // Copyright (C) 2025-2026 Polycode Limited
 // tasks/direct.js — Director: mission-complete/failed evaluation via LLM
 //
-// Gathers mission metrics, builds an advisory assessment, asks the LLM
-// to decide mission-complete, mission-failed, or produce a gap analysis.
+// Uses runCopilotSession with lean prompts: the model reads source files
+// via tools to determine mission status and produce a structured evaluation.
 // The director does NOT dispatch workflows or create issues — that's the supervisor's job.
 
 import * as core from "@actions/core";
 import { existsSync, readFileSync, writeFileSync, readdirSync, statSync } from "fs";
-import { runCopilotTask, readOptionalFile, scanDirectory, filterIssues } from "../copilot.js";
+import { readOptionalFile, scanDirectory, filterIssues, extractNarrative, NARRATIVE_INSTRUCTION } from "../copilot.js";
+import { runCopilotSession } from "../../../copilot/copilot-session.js";
+import { createGitHubTools, createGitTools } from "../../../copilot/github-tools.js";
 
 /**
  * Count TODO comments recursively in a directory.
@@ -98,7 +100,7 @@ function buildMetricAssessment(ctx, config) {
 }
 
 /**
- * Build the director prompt.
+ * Build the director prompt (lean version — model explores via tools).
  */
 function buildPrompt(ctx, agentInstructions, metricAssessment) {
   return [
@@ -114,35 +116,21 @@ function buildPrompt(ctx, agentInstructions, metricAssessment) {
     "### Mission-Complete Metrics",
     metricAssessment.table,
     "",
-    "## Repository State",
-    `### Open Issues (${ctx.issuesSummary.length})`,
-    ctx.issuesSummary.join("\n") || "none",
+    "## Repository Summary",
+    `Open issues: ${ctx.issuesSummary.length}`,
+    `Recently closed issues: ${ctx.recentlyClosedSummary.length}`,
+    `Open PRs: ${ctx.prsSummary.length}`,
+    `Dedicated test files: ${ctx.dedicatedTestCount}`,
+    `Source TODOs: ${ctx.sourceTodoCount}`,
+    `Transformation budget: ${ctx.cumulativeTransformationCost}/${ctx.transformationBudget || "unlimited"}`,
     "",
-    `### Recently Closed Issues (${ctx.recentlyClosedSummary.length})`,
-    ctx.recentlyClosedSummary.join("\n") || "none",
-    "",
-    `### Open PRs (${ctx.prsSummary.length})`,
-    ctx.prsSummary.join("\n") || "none",
-    "",
-    ...(ctx.sourceExports?.length > 0
-      ? [
-          `### Source Exports`,
-          ...ctx.sourceExports.map((e) => `- ${e}`),
-          "",
-        ]
-      : []),
-    `### Test Coverage`,
-    ctx.dedicatedTestCount > 0
-      ? `Dedicated test files (${ctx.dedicatedTestCount}): ${ctx.dedicatedTestFiles.join(", ")}`
-      : "**No dedicated test files found.**",
-    "",
-    `### Source TODO Count: ${ctx.sourceTodoCount}`,
-    "",
-    `### Transformation Budget: ${ctx.cumulativeTransformationCost}/${ctx.transformationBudget || "unlimited"}`,
-    "",
-    `### Recent Activity`,
-    ctx.recentActivity || "none",
+    "## Your Task",
+    "Use list_issues and list_prs to review open work items.",
+    "Use read_file to inspect source code and tests for completeness.",
+    "Use git_diff or git_status for additional context if needed.",
+    "Then call report_director_decision with your determination.",
     "",
+    "**You MUST call report_director_decision exactly once.**",
   ].join("\n");
 }
 
@@ -240,13 +228,12 @@ async function executeMissionFailed(octokit, repo, reason) {
  * @returns {Promise<Object>} Result with outcome, tokensUsed, model
  */
 export async function direct(context) {
-  const { octokit, repo, config, instructions, model } = context;
+  const { octokit, repo, config, instructions, model, logFilePath, screenshotFilePath } = context;
   const t = config.tuning || {};
 
   // --- Gather context (similar to supervisor but focused on metrics) ---
   const mission = readOptionalFile(config.paths.mission.path);
   const intentionLogFull = readOptionalFile(config.intentionBot.intentionFilepath);
-  const recentActivity = intentionLogFull.split("\n").slice(-20).join("\n");
 
   const costMatches = intentionLogFull.matchAll(/\*\*agentic-lib transformation cost:\*\* (\d+)/g);
   const cumulativeTransformationCost = [...costMatches].reduce((sum, m) => sum + parseInt(m[1], 10), 0);
@@ -271,7 +258,7 @@ export async function direct(context) {
   const initTimestamp = config.init?.timestamp || null;
 
   const { data: openIssues } = await octokit.rest.issues.listForRepo({
-    ...repo, state: "open", per_page: t.issuesScan || 20, sort: "created", direction: "asc",
+    ...repo, state: "open", per_page: 20, sort: "created", direction: "asc",
   });
   const issuesOnly = openIssues.filter((i) => !i.pull_request);
   const filteredIssues = filterIssues(issuesOnly, { staleDays: t.staleDays || 30, initTimestamp });
@@ -307,7 +294,6 @@ export async function direct(context) {
             closeReason = "RESOLVED";
           }
         }
-        // Check for automerge closure (issue has "merged" label — set by ci-automerge)
         if (closeReason !== "RESOLVED") {
           const issueLabels = ci.labels.map((l) => (typeof l === "string" ? l : l.name));
           if (issueLabels.includes("merged")) {
@@ -328,23 +314,6 @@ export async function direct(context) {
   });
   const prsSummary = openPRs.map((pr) => `#${pr.number}: ${pr.title} (${pr.head.ref})`);
 
-  // Source exports
-  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 */ }
-
   // Dedicated tests
   const { dedicatedTestCount, dedicatedTestFiles } = detectDedicatedTests();
 
@@ -357,12 +326,10 @@ export async function direct(context) {
   // Build context
   const ctx = {
     mission,
-    recentActivity,
     issuesSummary,
     recentlyClosedSummary,
     resolvedCount,
     prsSummary,
-    sourceExports,
     dedicatedTestCount,
     dedicatedTestFiles,
     sourceTodoCount,
@@ -374,20 +341,74 @@ export async function direct(context) {
   const metricAssessment = buildMetricAssessment(ctx, config);
   core.info(`Metric assessment: ${metricAssessment.assessment}`);
 
-  // --- LLM decision ---
+  // --- LLM decision via hybrid session ---
   const agentInstructions = instructions || "You are the director. Evaluate mission readiness.";
   const prompt = buildPrompt(ctx, agentInstructions, metricAssessment);
 
-  const { content, tokensUsed, inputTokens, outputTokens, cost } = await runCopilotTask({
+  const systemPrompt =
+    "You are the director of an autonomous coding repository. Your job is to evaluate whether the mission is complete, failed, or in progress. You produce a structured assessment — you do NOT dispatch workflows or create issues." +
+    NARRATIVE_INSTRUCTION;
+
+  // Shared mutable state to capture the decision
+  const decisionResult = { decision: "in-progress", reason: "", analysis: "" };
+
+  const createTools = (defineTool, _wp, logger) => {
+    const ghTools = createGitHubTools(octokit, repo, defineTool, logger);
+    const gitTools = createGitTools(defineTool, logger);
+
+    const reportDecision = defineTool("report_director_decision", {
+      description: "Report the director's mission evaluation decision. Call this exactly once.",
+      parameters: {
+        type: "object",
+        properties: {
+          decision: {
+            type: "string",
+            enum: ["mission-complete", "mission-failed", "in-progress"],
+            description: "The mission status decision",
+          },
+          reason: { type: "string", description: "One-line summary of the decision" },
+          analysis: { type: "string", description: "Detailed analysis of the mission state" },
+        },
+        required: ["decision", "reason"],
+      },
+      handler: async ({ decision, reason, analysis }) => {
+        decisionResult.decision = decision;
+        decisionResult.reason = reason || "";
+        decisionResult.analysis = analysis || "";
+        return { textResultForLlm: `Decision recorded: ${decision}` };
+      },
+    });
+
+    return [...ghTools, ...gitTools, reportDecision];
+  };
+
+  const attachments = [];
+  if (logFilePath) attachments.push({ type: "file", path: logFilePath });
+  if (screenshotFilePath) attachments.push({ type: "file", path: screenshotFilePath });
+
+  const result = await runCopilotSession({
+    workspacePath: process.cwd(),
     model,
-    systemMessage:
-      "You are the director of an autonomous coding repository. Your job is to evaluate whether the mission is complete, failed, or in progress. You produce a structured assessment — you do NOT dispatch workflows or create issues.",
-    prompt,
-    writablePaths: [],
     tuning: t,
+    agentPrompt: systemPrompt,
+    userPrompt: prompt,
+    writablePaths: [],
+    createTools,
+    attachments,
+    excludedTools: ["write_file", "run_command", "run_tests", "dispatch_workflow", "close_issue", "label_issue", "post_discussion_comment", "create_issue", "comment_on_issue"],
+    logger: { info: core.info, warning: core.warning, error: core.error, debug: core.debug },
   });
 
-  const { decision, reason, analysis } = parseDirectorResponse(content);
+  const tokensUsed = result.tokensIn + result.tokensOut;
+
+  // Extract decision — prefer tool result, fall back to text parsing
+  let { decision, reason, analysis } = decisionResult;
+  if (decision === "in-progress" && !decisionResult.reason && result.agentMessage) {
+    const parsed = parseDirectorResponse(result.agentMessage);
+    decision = parsed.decision;
+    reason = parsed.reason;
+    analysis = parsed.analysis;
+  }
   core.info(`Director decision: ${decision} — ${reason}`);
 
   // Execute the decision
@@ -414,12 +435,12 @@ export async function direct(context) {
   return {
     outcome,
     tokensUsed,
-    inputTokens,
-    outputTokens,
-    cost,
+    inputTokens: result.tokensIn,
+    outputTokens: result.tokensOut,
+    cost: 0,
     model,
     details: `Decision: ${decision}\nReason: ${reason}\nAnalysis: ${analysis.substring(0, 300)}`,
-    narrative: `Director: ${reason}`,
+    narrative: result.narrative || `Director: ${reason}`,
     metricAssessment: metricAssessment.assessment,
     directorAnalysis: analysis,
     dedicatedTestCount,