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

package/agentic-lib.toml

@@ -52,14 +52,8 @@ model = "gpt-5-mini"
 # reasoning-effort = "low"       # low | medium | high | none (none = disable entirely)
 infinite-sessions = false        # set to true for long sessions with compaction
 # transformation-budget = 4      # max code-changing cycles per run (0 = unlimited)
-# max-feature-files = 3
-# max-source-files = 3
-# max-source-chars = 1000
-# max-test-chars = 500
 # max-issues = 5
-# issue-body-limit = 200
 # stale-days = 14
-# max-summary-chars = 500
 # max-discussion-comments = 5
 
 # ─── Profile Definitions ────────────────────────────────────────────
@@ -68,19 +62,13 @@ infinite-sessions = false        # set to true for long sessions with compaction
 # [tuning] or [limits] to deviate from the active profile.
 
 [profiles.min]
-# ~10% of gpt-4.1 context (128K). Fast, cheap — CI testing, quick validation.
+# Fast, cheap — CI testing, quick validation.
 reasoning-effort = "low"                # low | medium | high | none
 infinite-sessions = false               # enable session compaction for long runs
 transformation-budget = 16             # max code-changing cycles per run
-max-feature-files = 3                      # max feature files included in prompts
-max-source-files = 3                        # max source files included in prompts
-max-source-chars = 4000                  # max chars of each source file's content included in prompts
-max-test-chars = 2000                     # max chars of each test file's content included in prompts
-max-issues = 5                        # max open issues included in prompts
-issue-body-limit = 1000                 # max chars of each issue's body text included in prompts
-stale-days = 14                        # days since last activity before an issue is considered stale and excluded
-max-summary-chars = 2000                 # max chars of each document's summary included in prompts
-max-discussion-comments = 3               # max recent discussion comments (newest first) included in prompts
+max-issues = 5                        # max open issues fetched from GitHub
+stale-days = 14                        # days since last activity before an issue is considered stale
+max-discussion-comments = 3               # max recent discussion comments fetched
 max-feature-issues = 1                     # max concurrent feature development issues
 max-maintenance-issues = 1                 # max concurrent maintenance issues
 max-attempts-per-branch = 2               # max transform attempts before abandoning a branch
@@ -89,19 +77,13 @@ features-limit = 2                     # max feature files in features/ director
 library-limit = 8                      # max library entries in library/ directory
 
 [profiles.recommended]
-# ~30% of claude-sonnet-4 context (216K). Balanced — good results, default for consumer repos.
+# Balanced — good results, default for consumer repos.
 reasoning-effort = "medium"            # low | medium | high | none
 infinite-sessions = true               # enable session compaction for long runs
 transformation-budget = 32             # max code-changing cycles per run
-max-feature-files = 10                     # max feature files included in prompts
-max-source-files = 10                       # max source files included in prompts
-max-source-chars = 8000                  # max chars of each source file's content included in prompts
-max-test-chars = 5000                    # max chars of each test file's content included in prompts
-max-issues = 15                       # max open issues included in prompts
-issue-body-limit = 2000                 # max chars of each issue's body text included in prompts
-stale-days = 30                        # days since last activity before an issue is considered stale and excluded
-max-summary-chars = 5000                # max chars of each document's summary included in prompts
-max-discussion-comments = 10              # max recent discussion comments (newest first) included in prompts
+max-issues = 15                       # max open issues fetched from GitHub
+stale-days = 30                        # days since last activity before an issue is considered stale
+max-discussion-comments = 10              # max recent discussion comments fetched
 max-feature-issues = 2                     # max concurrent feature development issues
 max-maintenance-issues = 1                 # max concurrent maintenance issues
 max-attempts-per-branch = 3               # max transform attempts before abandoning a branch
@@ -110,19 +92,13 @@ features-limit = 4                     # max feature files in features/ director
 library-limit = 32                     # max library entries in library/ directory
 
 [profiles.max]
-# ~90% of gpt-5-mini context (264K). Thorough — maximum context for complex missions.
+# Thorough — maximum context for complex missions.
 reasoning-effort = "high"              # low | medium | high | none
 infinite-sessions = true               # enable session compaction for long runs
 transformation-budget = 128           # max code-changing cycles per run
-max-feature-files = 20                     # max feature files included in prompts
-max-source-files = 25                       # max source files included in prompts
-max-source-chars = 12000                 # max chars of each source file's content included in prompts
-max-test-chars = 8000                   # max chars of each test file's content included in prompts
-max-issues = 30                      # max open issues included in prompts
-issue-body-limit = 3000                # max chars of each issue's body text included in prompts
-stale-days = 90                        # days since last activity before an issue is considered stale and excluded
-max-summary-chars = 8000               # max chars of each document's summary included in prompts
-max-discussion-comments = 20              # max recent discussion comments (newest first) included in prompts
+max-issues = 30                      # max open issues fetched from GitHub
+stale-days = 90                        # days since last activity before an issue is considered stale
+max-discussion-comments = 20              # max recent discussion comments fetched
 max-feature-issues = 4                     # max concurrent feature development issues
 max-maintenance-issues = 2                 # max concurrent maintenance issues
 max-attempts-per-branch = 5               # max transform attempts before abandoning a branch
@@ -133,9 +109,11 @@ library-limit = 64                     # max library entries in library/ directo
 [mission-complete]
 # Thresholds for deterministic mission-complete declaration.
 # All conditions must be met simultaneously.
-min-resolved-issues = 3            # minimum closed-as-RESOLVED issues since init
-min-dedicated-tests = 1            # minimum test files that import from src/lib/
+min-resolved-issues = 2            # minimum closed-as-RESOLVED issues since init
+min-dedicated-tests = 0            # minimum test files that import from src/lib/
 max-source-todos = 0               # max TODO comments allowed in ./src (0 = none)
 
 [bot]
 log-file = "test/intentïon.md"                  #@dist "intentïon.md"
+log-branch = "agentic-lib-logs"
+screenshot-file = "SCREENSHOT_INDEX.png"

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,11 +553,23 @@ function initActions(agenticDir) {
   }
 }
 
-function initDirContents(srcSubdir, dstDir, label) {
+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);
   if (!existsSync(dir)) return;
+  const excludeSet = new Set(excludeFiles);
   for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    if (excludeSet.has(entry.name)) continue;
     if (entry.isDirectory()) {
       initCopyDirRecursive(resolve(dir, entry.name), resolve(dstDir, entry.name), `${srcSubdir}/${entry.name}`);
     } else {
@@ -768,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);
@@ -1269,7 +1260,14 @@ function runInit() {
   initWorkflows();
   initActions(agenticDir);
   initDirContents("copilot", resolve(agenticDir, "copilot"), "Copilot (shared modules)");
-  initDirContents("agents", resolve(agenticDir, "agents"), "Agents");
+  initAgents(resolve(target, ".github/agents"));
+  // Remove stale legacy agents directory
+  const legacyAgentsDir = resolve(agenticDir, "agents");
+  if (existsSync(legacyAgentsDir)) {
+    if (!dryRun) rmSync(legacyAgentsDir, { recursive: true });
+    console.log("  REMOVE stale: .github/agentic-lib/agents/ (migrated to .github/agents/)");
+    initChanges++;
+  }
   initDirContents("seeds", resolve(agenticDir, "seeds"), "Seeds");
   initScripts(agenticDir);
   initConfig(seedsDir);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xn-intenton-z2a/agentic-lib",
-  "version": "7.4.7",
+  "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,9 +16,9 @@ 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: ".github/agentic-lib/agents/agentic-lib.yml"
+    default: "agentic-lib.toml"
   instructions:
     description: "Path to agent prompt/instructions file (.md)"
     required: false

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
+    }
+  }
 }
 
 /**