@xn-intenton-z2a/agentic-lib 7.2.20 → 7.2.22

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

@@ -28,6 +28,10 @@ on:
   #@dist     - edited
   workflow_call:
     inputs:
+      ref:
+        type: string
+        required: false
+        default: ""
       discussion-url:
         type: string
         required: false
@@ -83,6 +87,7 @@ jobs:
     steps:
       - uses: actions/checkout@v6
         with:
+          ref: ${{ inputs.ref || github.sha }}
           sparse-checkout: ${{ env.configPath }}
           sparse-checkout-cone-mode: false
       - name: Normalise params
@@ -111,6 +116,7 @@ jobs:
       - uses: actions/checkout@v6
         with:
           fetch-depth: 0
+          ref: ${{ inputs.ref || github.sha }}
 
       - uses: actions/setup-node@v6
         with:

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

@@ -12,6 +12,10 @@ run-name: "agentic-lib-init ${{ inputs.mode || 'update' }} [${{ github.ref_name
 on:
   workflow_call:
     inputs:
+      ref:
+        type: string
+        required: false
+        default: ""
       mode:
         type: string
         required: false
@@ -121,6 +125,7 @@ jobs:
   update:
     uses: ./.github/workflows/agentic-lib-update.yml
     with:
+      ref: ${{ inputs.ref }}
       dry-run: ${{ inputs.dry-run || 'false' }}
     secrets: inherit
 
@@ -136,10 +141,12 @@ jobs:
     steps:
       - uses: actions/checkout@v6
         if: inputs.dry-run == 'true' || inputs.dry-run == true
+        with:
+          ref: ${{ inputs.ref || github.sha }}
       - uses: actions/checkout@v6
         if: inputs.dry-run != 'true' && inputs.dry-run != true
         with:
-          ref: main
+          ref: ${{ inputs.ref || 'main' }}
           token: ${{ secrets.WORKFLOW_TOKEN }}
 
       - uses: actions/setup-node@v6

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

@@ -13,6 +13,10 @@ run-name: "agentic-lib-schedule -> ${{ inputs.frequency }} (${{ inputs.model }}$
 on:
   workflow_call:
     inputs:
+      ref:
+        type: string
+        required: false
+        default: ""
       frequency:
         description: "How often the workflow should run"
         required: true
@@ -80,10 +84,12 @@ jobs:
     steps:
       - uses: actions/checkout@v6
         if: inputs.dry-run == 'true' || inputs.dry-run == true
+        with:
+          ref: ${{ inputs.ref || github.sha }}
       - uses: actions/checkout@v6
         if: inputs.dry-run != 'true' && inputs.dry-run != true
         with:
-          ref: main
+          ref: ${{ inputs.ref || 'main' }}
           token: ${{ secrets.WORKFLOW_TOKEN }}
 
       - name: Update workflow schedule and model

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

@@ -40,6 +40,10 @@ on:
         type: string
         required: false
         default: "false"
+      ref:
+        type: string
+        required: false
+        default: ""
   workflow_dispatch:
     inputs:
       push-screenshot:
@@ -58,6 +62,8 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
+        with:
+          ref: ${{ inputs.ref || github.sha }}
 
       - uses: actions/setup-node@v6
         with:
@@ -89,6 +95,8 @@ jobs:
       tests-failed: ${{ steps.result.outputs.tests-failed }}
     steps:
       - uses: actions/checkout@v6
+        with:
+          ref: ${{ inputs.ref || github.sha }}
 
       - name: Install dependencies
         run: npm ci
@@ -182,6 +190,8 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
+        with:
+          ref: ${{ inputs.ref || github.sha }}
 
       - name: Install dependencies (non-blocking)
         id: install-deps
@@ -291,6 +301,8 @@ jobs:
     container: mcr.microsoft.com/playwright:v1.58.2-noble
     steps:
       - uses: actions/checkout@v6
+        with:
+          ref: ${{ inputs.ref || github.sha }}
 
       - name: Install dependencies (non-blocking)
         id: install-deps

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

@@ -14,6 +14,10 @@ run-name: "agentic-lib-update [${{ github.ref_name }}]"
 on:
   workflow_call:
     inputs:
+      ref:
+        type: string
+        required: false
+        default: ""
       dry-run:
         type: string
         required: false
@@ -36,10 +40,12 @@ jobs:
     steps:
       - uses: actions/checkout@v6
         if: inputs.dry-run == 'true' || inputs.dry-run == true
+        with:
+          ref: ${{ inputs.ref || github.sha }}
       - uses: actions/checkout@v6
         if: inputs.dry-run != 'true' && inputs.dry-run != true
         with:
-          ref: main
+          ref: ${{ inputs.ref || 'main' }}
           token: ${{ secrets.WORKFLOW_TOKEN }}
 
       - uses: actions/setup-node@v6

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

@@ -20,6 +20,10 @@ on:
   #@dist   - cron: "0 6 * * 1"
   workflow_call:
     inputs:
+      ref:
+        type: string
+        required: false
+        default: ""
       model:
         type: string
         required: false
@@ -135,6 +139,7 @@ jobs:
     steps:
       - uses: actions/checkout@v6
         with:
+          ref: ${{ inputs.ref || github.sha }}
           sparse-checkout: ${{ env.configPath }}
           sparse-checkout-cone-mode: false
       - name: Normalise params
@@ -265,6 +270,8 @@ jobs:
     container: mcr.microsoft.com/playwright:v1.58.2-noble
     steps:
       - uses: actions/checkout@v6
+        with:
+          ref: ${{ inputs.ref || github.sha }}
 
       - uses: actions/setup-node@v6
         with:
@@ -305,6 +312,8 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
+        with:
+          ref: ${{ inputs.ref || github.sha }}
 
       - uses: actions/setup-node@v6
         with:
@@ -553,10 +562,13 @@ jobs:
       needs.params.result == 'success' &&
       inputs.skipMaintain != 'true' && inputs.skipMaintain != true
     runs-on: ubuntu-latest
+    outputs:
+      commit-sha: ${{ steps.get-sha.outputs.sha }}
     steps:
       - uses: actions/checkout@v6
         with:
           fetch-depth: 0
+          ref: ${{ inputs.ref || github.sha }}
 
       - name: Fetch log from agentic-lib-logs branch
         run: |
@@ -660,6 +672,10 @@ jobs:
           commit-message: "agentic-step: maintain features and library"
           push-ref: ${{ github.ref_name }}
 
+      - name: Capture commit SHA
+        id: get-sha
+        run: echo "sha=$(git rev-parse HEAD)" >> $GITHUB_OUTPUT
+
       - name: Push log to agentic-lib-logs branch
         if: github.repository != 'xn-intenton-z2a/agentic-lib' && needs.params.outputs.dry-run != 'true'
         run: bash .github/agentic-lib/scripts/push-to-logs.sh "intentïon.md" "intention.md"
@@ -679,6 +695,7 @@ jobs:
       - uses: actions/checkout@v6
         with:
           fetch-depth: 0
+          ref: ${{ needs.maintain.outputs.commit-sha || github.sha }}
 
       - name: Fetch log from agentic-lib-logs branch
         run: |
@@ -729,6 +746,7 @@ jobs:
       - uses: actions/checkout@v6
         with:
           fetch-depth: 0
+          ref: ${{ needs.maintain.outputs.commit-sha || github.sha }}
 
       - name: Fetch log from agentic-lib-logs branch
         run: |
@@ -767,7 +785,7 @@ jobs:
 
   # ─── Fix stuck PRs with failing checks ─────────────────────────────
   fix-stuck:
-    needs: [params, supervisor]
+    needs: [params, maintain, supervisor]
     if: |
       !cancelled() &&
       needs.params.outputs.mode == 'full' &&
@@ -777,6 +795,7 @@ jobs:
       - uses: actions/checkout@v6
         with:
           fetch-depth: 0
+          ref: ${{ needs.maintain.outputs.commit-sha || github.sha }}
 
       - uses: actions/setup-node@v6
         with:
@@ -1088,7 +1107,7 @@ jobs:
 
   # ─── Review: close resolved issues, enhance with criteria ──────────
   review-features:
-    needs: [params, supervisor]
+    needs: [params, maintain, supervisor]
     if: |
       !cancelled() &&
       (needs.params.outputs.mode == 'full' || needs.params.outputs.mode == 'review-only') &&
@@ -1096,6 +1115,8 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
+        with:
+          ref: ${{ needs.maintain.outputs.commit-sha || github.sha }}
 
       - uses: actions/setup-node@v6
         with:
@@ -1133,7 +1154,7 @@ jobs:
 
   # ─── Dev: sequential issue resolution ──────────────────────────────
   dev:
-    needs: [params, review-features]
+    needs: [params, maintain, review-features]
     if: |
       !cancelled() &&
       (needs.params.outputs.mode == 'full' || needs.params.outputs.mode == 'dev-only') &&
@@ -1144,6 +1165,7 @@ jobs:
         with:
           fetch-depth: 0
           token: ${{ secrets.GITHUB_TOKEN }}
+          ref: ${{ needs.maintain.outputs.commit-sha || github.sha }}
 
       - name: Fetch log from agentic-lib-logs branch
         run: |
@@ -1405,13 +1427,14 @@ jobs:
 
   # ─── Post-merge: stats, schedule, mission check ────────────────────
   post-merge:
-    needs: [params, dev, pr-cleanup]
+    needs: [params, maintain, dev, pr-cleanup]
     if: ${{ !cancelled() && needs.params.result == 'success' }}
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
         with:
           fetch-depth: 0
+          ref: ${{ needs.maintain.outputs.commit-sha || github.sha }}
 
       - name: Summary
         run: |
@@ -1428,20 +1451,23 @@ jobs:
 
   # ─── Post-commit validation: call test workflow to verify branch health ───
   post-commit-test:
-    needs: [params, dev, fix-stuck, post-merge]
+    needs: [params, maintain, dev, fix-stuck, post-merge]
     if: >-
       !cancelled()
       && needs.params.outputs.dry-run != 'true'
       && needs.params.result == 'success'
     uses: ./.github/workflows/agentic-lib-test.yml
+    with:
+      ref: ${{ needs.maintain.outputs.commit-sha || github.sha }}
     secrets: inherit
 
   # ─── Schedule change (if requested) ────────────────────────────────
   update-schedule:
-    needs: [params, dev]
+    needs: [params, maintain, dev]
     if: ${{ !cancelled() && needs.params.outputs.dry-run != 'true' && needs.params.outputs.schedule != '' && needs.params.result == 'success' }}
     uses: ./.github/workflows/agentic-lib-schedule.yml
     with:
+      ref: ${{ needs.maintain.outputs.commit-sha || github.sha }}
       frequency: ${{ needs.params.outputs.schedule }}
       model: ${{ needs.params.outputs.model }}
       profile: ${{ needs.params.outputs.profile }}

package/bin/agentic-lib.js

@@ -30,6 +30,12 @@ const flags = args.slice(1);
 
 let initChanges = 0;
 const TASK_COMMANDS = ["transform", "maintain-features", "maintain-library", "fix-code"];
+const TASK_AGENT_MAP = {
+  "transform": "agent-issue-resolution",
+  "fix-code": "agent-apply-fix",
+  "maintain-features": "agent-maintain-features",
+  "maintain-library": "agent-maintain-library",
+};
 const INIT_COMMANDS = ["init", "update", "reset"];
 const ALL_COMMANDS = [...INIT_COMMANDS, ...TASK_COMMANDS, "version", "mcp", "iterate"];
 
@@ -366,21 +372,30 @@ async function runIterate() {
 // ─── Task Runner ─────────────────────────────────────────────────────
 
 async function runTask(taskName) {
+  // Task commands are now aliases for iterate --agent <agent-name>
+  const agentName = TASK_AGENT_MAP[taskName];
+  if (!agentName) {
+    console.error(`Unknown task: ${taskName}`);
+    return 1;
+  }
+
   console.log("");
-  console.log(`=== agentic-lib ${taskName} ===`);
+  console.log(`=== agentic-lib ${taskName} (→ iterate --agent ${agentName}) ===`);
   console.log(`Target:  ${target}`);
   console.log(`Model:   ${model}`);
   console.log(`Dry-run: ${dryRun}`);
   console.log("");
 
-  // Load config from shared module
   const { loadConfig } = await import("../src/copilot/config.js");
-  const config = loadConfig(resolve(target, "agentic-lib.toml"));
-  const effectiveModel = model || config.model;
+  let config;
+  try {
+    config = loadConfig(resolve(target, "agentic-lib.toml"));
+  } catch {
+    config = { tuning: {}, model: "gpt-5-mini", paths: {}, writablePaths: [], readOnlyPaths: [] };
+  }
+  const effectiveModel = model || config.model || "gpt-5-mini";
 
-  console.log(`[config] supervisor=${config.supervisor}`);
-  console.log(`[config] writable=${config.writablePaths.join(", ")}`);
-  console.log(`[config] test=${config.testScript}`);
+  console.log(`[config] writable=${(config.writablePaths || []).join(", ")}`);
   console.log("");
 
   if (dryRun) {
@@ -388,62 +403,50 @@ async function runTask(taskName) {
     return 0;
   }
 
-  // Change to target directory so relative paths in config work
-  const originalCwd = process.cwd();
-  process.chdir(target);
-
   try {
-    const context = {
-      config,
-      writablePaths: config.writablePaths,
-      model: effectiveModel,
-      testCommand: config.testScript,
-      logger: { info: console.log, warning: console.warn, error: console.error, debug: () => {} },
-    };
-
-    let result;
-    switch (taskName) {
-      case "transform": {
-        const { transform } = await import("../src/copilot/tasks/transform.js");
-        result = await transform(context);
-        break;
-      }
-      case "maintain-features": {
-        const { maintainFeatures } = await import("../src/copilot/tasks/maintain-features.js");
-        result = await maintainFeatures(context);
-        break;
-      }
-      case "maintain-library": {
-        const { maintainLibrary } = await import("../src/copilot/tasks/maintain-library.js");
-        result = await maintainLibrary(context);
-        break;
-      }
-      case "fix-code": {
-        const { fixCode } = await import("../src/copilot/tasks/fix-code.js");
-        result = await fixCode(context);
-        break;
-      }
-      default:
-        console.error(`Unknown task: ${taskName}`);
-        return 1;
+    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 agentPrompt = loadAgentPrompt(agentName);
+    const localContext = gatherLocalContext(target, config);
+
+    let githubContext;
+    if (issueNumber || prNumber) {
+      githubContext = gatherGitHubContext({
+        issueNumber: issueNumber || undefined,
+        prNumber: prNumber || undefined,
+        workspacePath: target,
+      });
     }
 
+    const userPrompt = buildUserPrompt(agentName, localContext, githubContext, { tuning: config.tuning });
+
+    const result = await runHybridSession({
+      workspacePath: target,
+      model: effectiveModel,
+      tuning: config.tuning || {},
+      timeoutMs,
+      agentPrompt,
+      userPrompt,
+      writablePaths: config.writablePaths?.length > 0 ? config.writablePaths : undefined,
+    });
+
     console.log("");
     console.log(`=== ${taskName} completed ===`);
-    console.log(`Outcome: ${result.outcome}`);
-    if (result.details) console.log(`Details: ${result.details}`);
-    if (result.tokensUsed) console.log(`Tokens: ${result.tokensUsed} (in=${result.inputTokens} out=${result.outputTokens})`);
+    console.log(`Success:       ${result.success}`);
+    console.log(`Session time:  ${result.sessionTime}s`);
+    console.log(`Tool calls:    ${result.toolCalls}`);
+    console.log(`Tokens:        ${result.tokensIn + result.tokensOut} (in=${result.tokensIn} out=${result.tokensOut})`);
     if (result.narrative) console.log(`Narrative: ${result.narrative}`);
     console.log("");
-    return 0;
+    return result.success ? 0 : 1;
   } catch (err) {
     console.error("");
     console.error(`=== ${taskName} FAILED ===`);
     console.error(err.message);
     if (err.stack) console.error(err.stack);
     return 1;
-  } finally {
-    process.chdir(originalCwd);
   }
 }
 
@@ -1229,6 +1232,7 @@ function runInit() {
 
   initWorkflows();
   initActions(agenticDir);
+  initDirContents("copilot", resolve(agenticDir, "copilot"), "Copilot (shared modules)");
   initDirContents("agents", resolve(agenticDir, "agents"), "Agents");
   initDirContents("seeds", resolve(agenticDir, "seeds"), "Seeds");
   initScripts(agenticDir);

package/package.json

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

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

@@ -1,9 +1,9 @@
 // SPDX-License-Identifier: GPL-3.0-only
 // Copyright (C) 2025-2026 Polycode Limited
-// config-loader.js — Parse agentic-lib.toml and resolve paths
+// config-loader.js — Thin re-export from shared src/copilot/config.js
 //
-// TOML-only configuration. The config file is required.
-// All defaults are defined here in one place.
+// Phase 4: Configuration logic now lives in src/copilot/config.js.
+// This file re-exports for backwards compatibility with existing imports.
 
 import { readFileSync, existsSync } from "fs";
 import { dirname, join } from "path";
@@ -306,3 +306,4 @@ export function getWritablePaths(config, override) {
   }
   return config.writablePaths;
 }
+export { loadConfig, getWritablePaths } from "../../copilot/config.js";