@xn-intenton-z2a/agentic-lib 7.1.19 → 7.1.21

package/README.md

@@ -82,7 +82,8 @@ your-repo/
 ├── package.json                              # [USER] Your package config (seeded on --purge)
 ├── README.md                                 # [USER] Your readme (seeded on --purge)
 ├── intentïon.md                              # [GENERATED] Activity log (cleared on --purge)
-└── .github/agentic-lib/features/             # [GENERATED] Feature definitions (cleared on --purge)
+├── features/                                  # [GENERATED] Feature definitions (cleared on --purge)
+└── library/                                   # [GENERATED] Library documents
 ```
 
 **Legend:**
@@ -123,7 +124,7 @@ tier = "schedule-1"       # schedule-1 through schedule-4
 mission = "MISSION.md"
 source = "src/lib/"
 tests = "tests/unit/"
-features = ".github/agentic-lib/features/"
+features = "features/"
 docs = "docs/"
 readme = "README.md"
 dependencies = "package.json"
@@ -205,7 +206,7 @@ npx @xn-intenton-z2a/agentic-lib maintain-features
 #   [context] Mission loaded, features: 0, library: 0
 #   [copilot] Creating session...
 #   [copilot] Sending prompt...
-#   [event] tool.call: write_file({"path":".github/agentic-lib/features/csv-parsing.md",...})
+#   [event] tool.call: write_file({"path":"features/csv-parsing.md",...})
 #   === maintain-features completed in 12.3s ===
 
 # 5. Transform code toward the mission

package/bin/agentic-lib.js

@@ -14,7 +14,7 @@
 //   npx @xn-intenton-z2a/agentic-lib maintain-library
 //   npx @xn-intenton-z2a/agentic-lib fix-code
 
-import { copyFileSync, existsSync, mkdirSync, rmSync, readdirSync, readFileSync, writeFileSync } from "fs";
+import { copyFileSync, existsSync, mkdirSync, rmSync, rmdirSync, readdirSync, readFileSync, writeFileSync } from "fs";
 import { resolve, dirname, join } from "path";
 import { fileURLToPath } from "url";
 import { execSync } from "child_process";
@@ -36,7 +36,9 @@ const HELP = `
 @xn-intenton-z2a/agentic-lib — Agentic Coding Systems SDK
 
 Infrastructure:
-  init [--purge]       Set up or update agentic infrastructure
+  init                 Update workflows, actions, agents, seeds, scripts
+  init --reseed        Also clear features + activity log (keep source code)
+  init --purge         Full reset — reseed + replace source files with seeds
   update               Alias for init
   reset                Alias for init --purge
   version              Show version
@@ -48,7 +50,8 @@ Tasks (run Copilot SDK transformations):
   fix-code             Fix failing tests
 
 Options:
-  --purge              Also reset source files to seed state
+  --purge              Full reset — clear features, activity log, source code
+  --reseed             Clear features + activity log (keep source code)
   --dry-run            Show what would be done without making changes
   --target <path>      Target repository (default: current directory)
   --model <name>       Copilot SDK model (default: claude-sonnet-4)
@@ -88,7 +91,8 @@ if (TASK_COMMANDS.includes(command)) {
 // ─── Init Commands ───────────────────────────────────────────────────
 
 let purge = flags.includes("--purge");
-if (command === "reset") purge = true;
+let reseed = flags.includes("--reseed") || purge;
+if (command === "reset") { purge = true; reseed = true; }
 
 if (!ALL_COMMANDS.includes(command)) {
   console.error(`Unknown command: ${command}`);
@@ -238,7 +242,7 @@ async function loadTaskConfig() {
     missionPath: toml.paths?.mission || "MISSION.md",
     sourcePath: toml.paths?.source || "src/lib/",
     testsPath: toml.paths?.tests || "tests/unit/",
-    featuresPath: toml.paths?.features || ".github/agentic-lib/features/",
+    featuresPath: toml.paths?.features || "features/",
     libraryPath: toml.paths?.docs || "library/",
     sourcesPath: toml.paths?.["library-sources"] || "SOURCES.md",
     readmePath: toml.paths?.readme || "README.md",
@@ -616,7 +620,7 @@ function initCopyDirRecursive(srcPath, dstPath, label, excludes = []) {
     const srcFull = join(srcPath, entry.name);
     const dstFull = join(dstPath, entry.name);
     const relLabel = `${label}/${entry.name}`;
-    if (excludes.some((ex) => entry.name === ex || srcFull.includes(ex))) continue;
+    if (excludes.some((ex) => entry.name === ex)) continue;
     if (entry.isDirectory()) {
       initCopyDirRecursive(srcFull, dstFull, relLabel, excludes);
     } else {
@@ -698,12 +702,24 @@ function initScripts(agenticDir) {
     "update.sh",
   ];
   if (!existsSync(scriptsDir)) return;
+  const distributedSet = new Set(DISTRIBUTED_SCRIPTS);
   for (const name of DISTRIBUTED_SCRIPTS) {
     const src = resolve(scriptsDir, name);
     if (existsSync(src)) {
       initCopyFile(src, resolve(agenticDir, "scripts", name), `scripts/${name}`);
     }
   }
+  // Remove stale scripts not in the distributed set
+  const targetScriptsDir = resolve(agenticDir, "scripts");
+  if (existsSync(targetScriptsDir)) {
+    for (const f of readdirSync(targetScriptsDir)) {
+      if (!distributedSet.has(f)) {
+        if (!dryRun) rmSync(resolve(targetScriptsDir, f));
+        console.log(`  REMOVE stale: scripts/${f}`);
+        initChanges++;
+      }
+    }
+  }
 }
 
 function initConfig(seedsDir) {
@@ -719,8 +735,45 @@ function initConfig(seedsDir) {
   }
 }
 
-function initPurge(seedsDir, agenticDir) {
-  console.log("\n--- Reset Source Files to Seed State ---");
+function initReseed() {
+  console.log("\n--- Reseed: Clear Features + Activity Log ---");
+  const intentionFile = resolve(target, "intentïon.md");
+  if (existsSync(intentionFile)) {
+    if (!dryRun) rmSync(intentionFile);
+    console.log("  REMOVE: intentïon.md");
+    initChanges++;
+  }
+  // Clear features directory (now at project root, next to library/)
+  const featuresDir = resolve(target, "features");
+  if (existsSync(featuresDir)) {
+    for (const f of readdirSync(featuresDir)) {
+      if (!dryRun) rmSync(resolve(featuresDir, f));
+      console.log(`  REMOVE: features/${f}`);
+      initChanges++;
+    }
+  }
+  // Also clear old features location if it exists
+  const oldFeaturesDir = resolve(target, ".github/agentic-lib/features");
+  if (existsSync(oldFeaturesDir)) {
+    for (const f of readdirSync(oldFeaturesDir)) {
+      if (!dryRun) rmSync(resolve(oldFeaturesDir, f));
+      console.log(`  REMOVE: .github/agentic-lib/features/${f} (old location)`);
+      initChanges++;
+    }
+    if (!dryRun) rmdirSync(oldFeaturesDir);
+    console.log("  REMOVE: .github/agentic-lib/features/ (old location)");
+  }
+  // Remove old getting-started-guide if it exists
+  const oldGuideDir = resolve(target, ".github/agentic-lib/getting-started-guide");
+  if (existsSync(oldGuideDir)) {
+    if (!dryRun) rmSync(oldGuideDir, { recursive: true });
+    console.log("  REMOVE: .github/agentic-lib/getting-started-guide/ (obsolete)");
+    initChanges++;
+  }
+}
+
+function initPurge(seedsDir) {
+  console.log("\n--- Purge: Reset Source Files to Seed State ---");
   const SEED_MAP = {
     "zero-main.js": "src/lib/main.js",
     "zero-main.test.js": "tests/unit/main.test.js",
@@ -734,19 +787,6 @@ function initPurge(seedsDir, agenticDir) {
       initCopyFile(src, resolve(target, targetRel), `SEED: ${seedFile} → ${targetRel}`);
     }
   }
-  const intentionFile = resolve(target, "intentïon.md");
-  if (existsSync(intentionFile)) {
-    if (!dryRun) rmSync(intentionFile);
-    console.log("  REMOVE: intentïon.md");
-    initChanges++;
-  }
-  const featuresDir = resolve(agenticDir, "features");
-  if (!existsSync(featuresDir)) return;
-  for (const f of readdirSync(featuresDir)) {
-    if (!dryRun) rmSync(resolve(featuresDir, f));
-    console.log(`  REMOVE: features/${f}`);
-    initChanges++;
-  }
 }
 
 function runInit() {
@@ -767,6 +807,7 @@ function runInit() {
   console.log("=== @xn-intenton-z2a/agentic-lib init ===");
   console.log(`Source:  ${srcDir}`);
   console.log(`Target:  ${target}`);
+  console.log(`Reseed:  ${reseed}`);
   console.log(`Purge:   ${purge}`);
   console.log(`Mode:    ${dryRun ? "DRY RUN" : "LIVE"}`);
   console.log("");
@@ -777,7 +818,8 @@ function runInit() {
   initDirContents("seeds", resolve(agenticDir, "seeds"), "Seeds");
   initScripts(agenticDir);
   initConfig(seedsDir);
-  if (purge) initPurge(seedsDir, agenticDir);
+  if (reseed) initReseed();
+  if (purge) initPurge(seedsDir);
 
   console.log(`\n${initChanges} change(s)${dryRun ? " (dry run)" : ""}`);
 

package/package.json

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

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

@@ -42,7 +42,7 @@ const PATH_DEFAULTS = {
   mission: "MISSION.md",
   source: "src/lib/",
   tests: "tests/unit/",
-  features: ".github/agentic-lib/features/",
+  features: "features/",
   docs: "docs/",
   readme: "README.md",
   dependencies: "package.json",

package/src/agents/agentic-lib.yml

@@ -15,7 +15,7 @@ paths:
     permissions: []
     limit: 0
   featuresPath:
-    path: ".github/agentic-lib/features/"
+    path: "features/"
     permissions: ["write"]
     limit: 2
 

package/src/seeds/init.yml

@@ -2,7 +2,7 @@
 # Copyright (C) 2025-2026 Polycode Limited
 # .github/workflows/init.yml
 #
-# Daily lifecycle: update agentic-lib, run init --purge, test, PR, automerge.
+# Daily lifecycle: update agentic-lib, run init, test, PR, automerge.
 # Keeps the repository current with the latest SDK infrastructure.
 
 name: init
@@ -12,12 +12,46 @@ on:
   schedule:
     - cron: "0 5 * * *"
   workflow_dispatch:
+    inputs:
+      mode:
+        description: "Init mode"
+        type: choice
+        required: false
+        default: "update"
+        options:
+          - update
+          - reseed
+          - purge
+      dry-run:
+        description: "Preview changes without writing files"
+        type: boolean
+        required: false
+        default: false
 
 permissions: write-all
 
 jobs:
+  params:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Normalise params
+        id: normalise
+        shell: bash
+        run: |
+          MODE='${{ inputs.mode }}'
+          echo "mode=${MODE:-update}" >> $GITHUB_OUTPUT
+          DRY_RUN='${{ inputs.dry-run }}'
+          echo "dry-run=${DRY_RUN:-false}" >> $GITHUB_OUTPUT
+    outputs:
+      mode: ${{ steps.normalise.outputs.mode }}
+      dry-run: ${{ steps.normalise.outputs.dry-run }}
+
   init:
+    needs: params
     runs-on: ubuntu-latest
+    env:
+      INIT_MODE: ${{ needs.params.outputs.mode }}
+      INIT_DRY_RUN: ${{ needs.params.outputs.dry-run }}
     steps:
       - uses: actions/checkout@v4
         with:
@@ -36,8 +70,13 @@ jobs:
       - name: Update agentic-lib to latest
         run: npm update @xn-intenton-z2a/agentic-lib
 
-      - name: Run init --purge
-        run: npx @xn-intenton-z2a/agentic-lib init --purge
+      - name: Run init
+        run: |
+          FLAGS="init"
+          if [ "$INIT_MODE" = "reseed" ]; then FLAGS="$FLAGS --reseed"; fi
+          if [ "$INIT_MODE" = "purge" ]; then FLAGS="$FLAGS --purge"; fi
+          if [ "$INIT_DRY_RUN" = "true" ]; then FLAGS="$FLAGS --dry-run"; fi
+          npx @xn-intenton-z2a/agentic-lib $FLAGS
 
       - run: npm install
 
@@ -53,7 +92,7 @@ jobs:
           git add -A
           git diff --cached --quiet && echo "No changes" && exit 0
           VERSION=$(npx @xn-intenton-z2a/agentic-lib version 2>/dev/null || echo "latest")
-          git commit -m "init --purge (agentic-lib@${VERSION})"
+          git commit -m "init ${INIT_MODE} (agentic-lib@${VERSION})"
           git push origin "$BRANCH"
 
       - name: Create PR
@@ -62,8 +101,8 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.WORKFLOW_TOKEN }}
         run: |
           gh pr create \
-            --title "init --purge ($(date -u +%Y-%m-%d))" \
-            --body "Nightly init --purge. Auto-labelled for automerge." \
+            --title "init ${INIT_MODE} ($(date -u +%Y-%m-%d))" \
+            --body "Nightly init ${INIT_MODE}. Auto-labelled for automerge." \
             --label automerge \
             --base main \
             --head "$BRANCH"

package/src/seeds/zero-MISSION.md

@@ -1,3 +1,3 @@
 # Mission
 
-Build a JavaScript library that is immediately useful to something or someone and it immediately available to run e.g. `npx @xn-intenton-z2a/<this package name>`.
+Describe your project's mission here. The agentic workflows will evolve `src/lib/main.js` to fulfil this mission.

package/src/seeds/zero-README.md

@@ -1,14 +1,13 @@
 # repo
 
-A repository powered by intentïon agentic-lib.
+Describe your project here.
 
 ## Getting Started
 
 1. Write your mission in `MISSION.md`
 2. Enable GitHub Actions
-3. The agentic workflows will evolve `src/lib/main.js` toward your mission
+3. The workflows will evolve `src/lib/main.js` toward your mission
 
 ## Links
 
-- [intentïon agentic-lib](https://github.com/xn-intenton-z2a/agentic-lib)
 - [MISSION.md](MISSION.md)

package/src/seeds/zero-agentic-lib.toml

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: MIT
 # Copyright (C) 2025-2026 Polycode Limited
-# agentic-lib.toml — Configuration for @xn-intenton-z2a/agentic-lib
+# agentic-lib.toml — Configuration for agentic-lib workflows
 #
 # This file controls how agentic workflows operate on your repository.
 # Place it at the root of your project.
@@ -12,7 +12,7 @@ tier = "schedule-1"       # schedule-1 through schedule-4
 mission = "MISSION.md"
 source = "src/lib/"
 tests = "tests/unit/"
-features = ".github/agentic-lib/features/"
+features = "features/"
 docs = "docs/"
 readme = "README.md"
 dependencies = "package.json"

package/src/seeds/zero-package.json

@@ -1,5 +1,5 @@
 {
-  "name": "@xn-intenton-z2a/repo",
+  "name": "repo",
   "version": "0.1.0",
   "description": "",
   "type": "module",
@@ -14,7 +14,7 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@xn-intenton-z2a/agentic-lib": "^7.1.19"
+    "@xn-intenton-z2a/agentic-lib": "^7.1.21"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.0",

package/src/workflows/agent-discussions-bot.yml

@@ -23,6 +23,16 @@ on:
   schedule:
     - cron: "7 12 */28 * *" # schedule-1: every 28 days
   workflow_dispatch:
+    inputs:
+      model:
+        description: "Copilot SDK model to use"
+        type: choice
+        required: false
+        default: "claude-sonnet-4"
+        options:
+          - claude-sonnet-4
+          - gpt-5-mini
+          - gpt-4.1
 
 permissions:
   contents: read
@@ -33,7 +43,20 @@ env:
   configPath: ".github/agentic-lib/agents/agentic-lib.yml"
 
 jobs:
+  params:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Normalise params
+        id: normalise
+        shell: bash
+        run: |
+          MODEL='${{ inputs.model }}'
+          echo "model=${MODEL:-claude-sonnet-4}" >> $GITHUB_OUTPUT
+    outputs:
+      model: ${{ steps.normalise.outputs.model }}
+
   respond:
+    needs: params
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -70,3 +93,4 @@ jobs:
           config: ${{ env.configPath }}
           instructions: ".github/agentic-lib/agents/agent-discussion-bot.md"
           discussion-url: ${{ steps.discussion-url.outputs.url }}
+          model: ${{ needs.params.outputs.model }}

package/src/workflows/agent-flow-fix-code.yml

@@ -21,6 +21,15 @@ on:
         description: "PR number to fix"
         required: true
         type: string
+      model:
+        description: "Copilot SDK model to use"
+        type: choice
+        required: false
+        default: "claude-sonnet-4"
+        options:
+          - claude-sonnet-4
+          - gpt-5-mini
+          - gpt-4.1
 
 permissions:
   contents: write
@@ -31,6 +40,18 @@ env:
   configPath: ".github/agentic-lib/agents/agentic-lib.yml"
 
 jobs:
+  params:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Normalise params
+        id: normalise
+        shell: bash
+        run: |
+          MODEL='${{ inputs.model }}'
+          echo "model=${MODEL:-claude-sonnet-4}" >> $GITHUB_OUTPUT
+    outputs:
+      model: ${{ steps.normalise.outputs.model }}
+
   find-failing-pr:
     if: >
       github.event_name == 'workflow_dispatch' ||
@@ -61,7 +82,7 @@ jobs:
             core.setOutput('prNumber', prNumber);
 
   fix:
-    needs: find-failing-pr
+    needs: [params, find-failing-pr]
     if: needs.find-failing-pr.outputs.prNumber != ''
     runs-on: ubuntu-latest
     steps:
@@ -94,6 +115,7 @@ jobs:
           instructions: ".github/agentic-lib/agents/agent-apply-fix.md"
           pr-number: ${{ needs.find-failing-pr.outputs.prNumber }}
           test-command: "npm test"
+          model: ${{ needs.params.outputs.model }}
 
       - name: Commit and push fixes
         uses: ./.github/agentic-lib/actions/commit-if-changed

package/src/workflows/agent-flow-maintain.yml

@@ -23,6 +23,15 @@ on:
           - all
           - features
           - library
+      model:
+        description: "Copilot SDK model to use"
+        type: choice
+        required: false
+        default: "claude-sonnet-4"
+        options:
+          - claude-sonnet-4
+          - gpt-5-mini
+          - gpt-4.1
 
 permissions:
   contents: write
@@ -41,8 +50,11 @@ jobs:
         run: |
           STEP='${{ inputs.step }}'
           echo "step=${STEP:-all}" >> $GITHUB_OUTPUT
+          MODEL='${{ inputs.model }}'
+          echo "model=${MODEL:-claude-sonnet-4}" >> $GITHUB_OUTPUT
     outputs:
       step: ${{ steps.normalise.outputs.step }}
+      model: ${{ steps.normalise.outputs.model }}
 
   maintain:
     needs: params
@@ -64,7 +76,7 @@ jobs:
         id: config
         run: |
           CONFIG="${{ env.configPath }}"
-          FEATURES=$(yq -r '.paths.featuresPath.path // ".github/agentic-lib/features/"' "$CONFIG")
+          FEATURES=$(yq -r '.paths.featuresPath.path // "features/"' "$CONFIG")
           LIBRARY=$(yq -r '.paths.libraryDocumentsPath.path // "library/"' "$CONFIG")
           SOURCES=$(yq -r '.paths.librarySourcesFilepath.path // "SOURCES.md"' "$CONFIG")
           echo "featuresWritablePaths=${FEATURES}" >> $GITHUB_OUTPUT
@@ -81,6 +93,7 @@ jobs:
           config: ${{ env.configPath }}
           instructions: ".github/agentic-lib/agents/agent-maintain-features.md"
           writable-paths: ${{ steps.config.outputs.featuresWritablePaths }}
+          model: ${{ needs.params.outputs.model }}
 
       - name: Maintain library
         if: needs.params.outputs.step == 'all' || needs.params.outputs.step == 'library'
@@ -93,6 +106,7 @@ jobs:
           config: ${{ env.configPath }}
           instructions: ".github/agentic-lib/agents/agent-maintain-library.md"
           writable-paths: ${{ steps.config.outputs.libraryWritablePaths }}
+          model: ${{ needs.params.outputs.model }}
 
       - name: Commit and push changes
         uses: ./.github/agentic-lib/actions/commit-if-changed

package/src/workflows/agent-flow-review.yml

@@ -22,6 +22,15 @@ on:
           - all
           - review
           - enhance
+      model:
+        description: "Copilot SDK model to use"
+        type: choice
+        required: false
+        default: "claude-sonnet-4"
+        options:
+          - claude-sonnet-4
+          - gpt-5-mini
+          - gpt-4.1
 
 permissions:
   contents: read
@@ -40,8 +49,11 @@ jobs:
         run: |
           STEP='${{ inputs.step }}'
           echo "step=${STEP:-all}" >> $GITHUB_OUTPUT
+          MODEL='${{ inputs.model }}'
+          echo "model=${MODEL:-claude-sonnet-4}" >> $GITHUB_OUTPUT
     outputs:
       step: ${{ steps.normalise.outputs.step }}
+      model: ${{ steps.normalise.outputs.model }}
 
   review-issues:
     needs: params
@@ -67,6 +79,7 @@ jobs:
           task: "review-issue"
           config: ${{ env.configPath }}
           instructions: ".github/agentic-lib/agents/agent-review-issue.md"
+          model: ${{ needs.params.outputs.model }}
 
   enhance-issues:
     needs: params
@@ -111,3 +124,4 @@ jobs:
           config: ${{ env.configPath }}
           instructions: ".github/agentic-lib/agents/agent-ready-issue.md"
           issue-number: ${{ steps.find-issue.outputs.issueNumber }}
+          model: ${{ needs.params.outputs.model }}

package/src/workflows/agent-flow-transform.yml

@@ -67,7 +67,7 @@ jobs:
           CONFIG="${{ env.configPath }}"
           SOURCE=$(yq -r '.paths.targetSourcePath.path // "src/lib/"' "$CONFIG")
           TESTS=$(yq -r '.paths.targetTestsPath.path // "tests/unit/"' "$CONFIG")
-          FEATURES=$(yq -r '.paths.featuresPath.path // ".github/agentic-lib/features/"' "$CONFIG")
+          FEATURES=$(yq -r '.paths.featuresPath.path // "features/"' "$CONFIG")
           DOCS=$(yq -r '.paths.documentationPath.path // "docs/"' "$CONFIG")
           LIBRARY=$(yq -r '.paths.libraryDocumentsPath.path // "library/"' "$CONFIG")
           SOURCES=$(yq -r '.paths.librarySourcesFilepath.path // "SOURCES.md"' "$CONFIG")