@xn-intenton-z2a/agentic-lib 7.1.54 → 7.1.55

package/{src → .github}/workflows/agentic-lib-bot.yml

@@ -5,24 +5,37 @@
 # Discussions bot: responds to GitHub Discussions using the Copilot SDK.
 # Checks thread + repo context, responds, and can escalate to the main
 # workflow by dispatching agentic-lib-workflow.yml with a message parameter.
+#
+# In agentic-lib: discussion triggers are commented out, dry-run defaults to true.
+# During init: #@dist restores triggers and sets dry-run to false.
 
 name: agentic-lib-bot
 run-name: "agentic-lib-bot [${{ github.ref_name }}]"
-concurrency:
-  group: agentic-lib-bot-${{ github.event.discussion.node_id || github.run_id }}
-  cancel-in-progress: false
+#concurrency:
+#  group: agentic-lib-bot-${{ github.event.discussion.node_id || github.run_id }}
+#  cancel-in-progress: false
 
 on:
-  discussion:
-    types:
-      - created
-      - edited
-      - answered
-      - unanswered
-  discussion_comment:
-    types:
-      - created
-      - edited
+  #@dist discussion:
+  #@dist   types:
+  #@dist     - created
+  #@dist     - edited
+  #@dist     - answered
+  #@dist     - unanswered
+  #@dist discussion_comment:
+  #@dist   types:
+  #@dist     - created
+  #@dist     - edited
+  workflow_call:
+    inputs:
+      discussion-url:
+        type: string
+        required: false
+        default: ""
+      model:
+        type: string
+        required: false
+        default: "gpt-5-mini"
   workflow_dispatch:
     inputs:
       discussion-url:
@@ -39,6 +52,11 @@ on:
           - gpt-5-mini
           - claude-sonnet-4
           - gpt-4.1
+      dry-run:
+        description: "Skip all push/PR/merge operations"
+        type: boolean
+        required: false
+        default: true                #@dist false
 
 permissions:
   contents: read
@@ -47,7 +65,7 @@ permissions:
   actions: write
 
 env:
-  configPath: ".github/agentic-lib/agents/agentic-lib.yml"
+  configPath: "agentic-lib.toml"
 
 jobs:
   params:
@@ -59,8 +77,11 @@ jobs:
         run: |
           MODEL='${{ inputs.model }}'
           echo "model=${MODEL:-gpt-5-mini}" >> $GITHUB_OUTPUT
+          DRY_RUN='${{ inputs.dry-run }}'
+          echo "dry-run=${DRY_RUN:-true}" >> $GITHUB_OUTPUT
     outputs:
       model: ${{ steps.normalise.outputs.model }}
+      dry-run: ${{ steps.normalise.outputs.dry-run }}
 
   respond:
     needs: params
@@ -74,6 +95,10 @@ jobs:
         with:
           node-version: "24"
 
+      - name: Self-init (agentic-lib dev only)
+        if: hashFiles('scripts/self-init.sh') != '' && hashFiles('.github/agentic-lib/actions/agentic-step/package.json') == ''
+        run: bash scripts/self-init.sh
+
       - name: Install agentic-step dependencies
         working-directory: .github/agentic-lib/actions/agentic-step
         run: npm ci

package/{src/seeds → .github/workflows}/agentic-lib-init.yml

@@ -5,13 +5,42 @@
 # Self-contained init: update agentic-lib, purge, push to main [skip ci].
 # Does NOT create a PR. Does NOT trigger any other workflow.
 # Closes hanging init PRs before running.
+#
+# In agentic-lib: schedule trigger is commented out.
+# During init: #@dist restores the schedule.
 
 name: agentic-lib-init
 run-name: "agentic-lib-init [${{ github.ref_name }}]"
 
 on:
-  schedule:
-    - cron: "0 5 * * *"
+  #@dist schedule:
+  #@dist   - cron: "0 5 * * *"
+  workflow_call:
+    inputs:
+      mode:
+        type: string
+        required: false
+        default: "update"
+      dry-run:
+        type: string
+        required: false
+        default: "false"
+      mission-seed:
+        type: string
+        required: false
+        default: "hamming-distance"
+      mission-text:
+        type: string
+        required: false
+        default: ""
+      schedule:
+        type: string
+        required: false
+        default: ""
+      model:
+        type: string
+        required: false
+        default: ""
   workflow_dispatch:
     inputs:
       mode:
@@ -113,6 +142,9 @@ jobs:
       INIT_MISSION_TEXT: ${{ needs.params.outputs.mission-text }}
     steps:
       - uses: actions/checkout@v4
+        if: needs.params.outputs.dry-run == 'true'
+      - uses: actions/checkout@v4
+        if: needs.params.outputs.dry-run != 'true'
         with:
           ref: main
           token: ${{ secrets.WORKFLOW_TOKEN }}
@@ -122,7 +154,7 @@ jobs:
           node-version: "24"
 
       - name: Close hanging init PRs
-        if: env.INIT_MODE == 'purge'
+        if: env.INIT_MODE == 'purge' && needs.params.outputs.dry-run != 'true'
         env:
           GH_TOKEN: ${{ secrets.WORKFLOW_TOKEN }}
         run: |
@@ -145,10 +177,15 @@ jobs:
           if [ "$INIT_MODE" = "reseed" ]; then FLAGS="$FLAGS --reseed"; fi
           if [ "$INIT_MODE" = "purge" ]; then FLAGS="$FLAGS --purge --mission $INIT_MISSION_SEED"; fi
           if [ "$INIT_DRY_RUN" = "true" ]; then FLAGS="$FLAGS --dry-run"; fi
-          npx @xn-intenton-z2a/agentic-lib $FLAGS
+          # Use local CLI if available (agentic-lib dev), otherwise npx
+          if [ -f "bin/agentic-lib.js" ]; then
+            node bin/agentic-lib.js $FLAGS
+          else
+            npx @xn-intenton-z2a/agentic-lib $FLAGS
+          fi
 
       - name: Write mission text (if provided, overrides seed)
-        if: env.INIT_MISSION_TEXT != ''
+        if: env.INIT_MISSION_TEXT != '' && needs.params.outputs.dry-run != 'true'
         run: |
           printf '# Mission\n\n%s\n' "$INIT_MISSION_TEXT" > MISSION.md
           echo "Wrote custom mission text to MISSION.md"
@@ -156,12 +193,17 @@ jobs:
       - run: npm install
 
       - name: Install agentic-step deps
+        if: hashFiles('.github/agentic-lib/actions/agentic-step/package.json') != ''
         run: cd .github/agentic-lib/actions/agentic-step && npm ci
 
+      - name: Install sub-project dependencies (agentic-lib dev only)
+        if: hashFiles('src/actions/agentic-step/package.json') != ''
+        run: cd src/actions/agentic-step && npm ci
+
       - run: npm test
 
       - name: Update schedule (if requested)
-        if: needs.params.outputs.schedule != ''
+        if: needs.params.outputs.schedule != '' && needs.params.outputs.dry-run != 'true'
         uses: actions/github-script@v7
         with:
           script: |
@@ -213,6 +255,7 @@ jobs:
             }
 
       - name: Commit and push to main [skip ci]
+        if: needs.params.outputs.dry-run != 'true'
         env:
           GH_TOKEN: ${{ secrets.WORKFLOW_TOKEN }}
         run: |

package/{src → .github}/workflows/agentic-lib-schedule.yml

@@ -4,6 +4,8 @@
 #
 # Changes the agentic-lib-workflow's cron schedule by editing the workflow file
 # directly and pushing to main. Also updates the model setting in agentic-lib.toml.
+#
+# No trigger changes needed — uses workflow_call and workflow_dispatch only.
 
 name: agentic-lib-schedule
 run-name: "agentic-lib-schedule -> ${{ inputs.frequency }} (${{ inputs.model }})"
@@ -20,6 +22,11 @@ on:
         required: false
         type: string
         default: "gpt-5-mini"
+      dry-run:
+        description: "Skip commit and push"
+        required: false
+        type: string
+        default: "false"
   workflow_dispatch:
     inputs:
       frequency:
@@ -41,6 +48,11 @@ on:
           - gpt-5-mini
           - claude-sonnet-4
           - gpt-4.1
+      dry-run:
+        description: "Skip commit and push"
+        type: boolean
+        required: false
+        default: false
 
 permissions:
   contents: write
@@ -50,6 +62,9 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+        if: inputs.dry-run == 'true' || inputs.dry-run == true
+      - uses: actions/checkout@v4
+        if: inputs.dry-run != 'true' && inputs.dry-run != true
         with:
           ref: main
           token: ${{ secrets.WORKFLOW_TOKEN }}
@@ -131,6 +146,7 @@ jobs:
             }
 
       - name: Commit and push
+        if: inputs.dry-run != 'true' && inputs.dry-run != true
         env:
           GH_TOKEN: ${{ secrets.WORKFLOW_TOKEN }}
         run: |

package/{src/seeds → .github/workflows}/agentic-lib-test.yml

@@ -4,15 +4,18 @@
 #
 # Test workflow seeded by agentic-lib init.
 # Also callable via workflow_call from the main pipeline.
+#
+# In agentic-lib: push/pull_request triggers are commented out.
+# During init: #@dist restores them.
 
 name: agentic-lib-test
 run-name: "agentic-lib-test [${{ github.ref_name }}]"
 
 on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
+  #@dist push:
+  #@dist   branches: [main]
+  #@dist pull_request:
+  #@dist   branches: [main]
   workflow_call:
   workflow_dispatch:
 
@@ -29,4 +32,8 @@ jobs:
 
       - run: npm ci
 
+      - name: Install sub-project dependencies (agentic-lib dev only)
+        if: hashFiles('src/actions/agentic-step/package.json') != ''
+        run: cd src/actions/agentic-step && npm ci
+
       - run: npm test

package/{src → .github}/workflows/agentic-lib-workflow.yml

@@ -5,16 +5,37 @@
 # Main autonomous pipeline: supervisor + maintain + review + dev + PR cleanup.
 # Replaces agent-supervisor, agent-flow-transform, agent-flow-review,
 # agent-flow-maintain, agent-flow-fix-code, and ci-automerge.
+#
+# In agentic-lib: schedule is commented out, dry-run defaults to true.
+# During init: #@dist restores schedule and sets dry-run to false.
 
 name: agentic-lib-workflow
 run-name: "agentic-lib-workflow [${{ github.ref_name }}]"
-concurrency:
-  group: agentic-lib-workflow
-  cancel-in-progress: false
+#concurrency:
+#  group: agentic-lib-workflow
+#  cancel-in-progress: false
 
 on:
-  schedule:
-    - cron: "0 6 * * 1"
+  #@dist schedule:
+  #@dist   - cron: "0 6 * * 1"
+  workflow_call:
+    inputs:
+      model:
+        type: string
+        required: false
+        default: "gpt-5-mini"
+      mode:
+        type: string
+        required: false
+        default: "full"
+      dry-run:
+        type: string
+        required: false
+        default: "true"
+      config-path:
+        type: string
+        required: false
+        default: ""
   workflow_dispatch:
     inputs:
       model:
@@ -64,6 +85,11 @@ on:
         type: string
         required: false
         default: ""
+      dry-run:
+        description: "Skip all push/PR/merge operations"
+        type: boolean
+        required: false
+        default: true                #@dist false
 
 permissions:
   actions: write
@@ -74,7 +100,7 @@ permissions:
   discussions: write
 
 env:
-  configPath: ".github/agentic-lib/agents/agentic-lib.yml"
+  configPath: "agentic-lib.toml"
   maxFixAttempts: "3"
   stalePrDays: "3"
 
@@ -98,6 +124,10 @@ jobs:
           echo "schedule=${SCHEDULE}" >> $GITHUB_OUTPUT
           PR='${{ inputs.pr-number }}'
           echo "pr-number=${PR}" >> $GITHUB_OUTPUT
+          DRY_RUN='${{ inputs.dry-run }}'
+          echo "dry-run=${DRY_RUN:-true}" >> $GITHUB_OUTPUT
+          CONFIG='${{ inputs.config-path }}'
+          echo "config-path=${CONFIG:-${{ env.configPath }}}" >> $GITHUB_OUTPUT
     outputs:
       model: ${{ steps.normalise.outputs.model }}
       mode: ${{ steps.normalise.outputs.mode }}
@@ -105,11 +135,15 @@ jobs:
       issue-number: ${{ steps.normalise.outputs.issue-number }}
       schedule: ${{ steps.normalise.outputs.schedule }}
       pr-number: ${{ steps.normalise.outputs.pr-number }}
+      dry-run: ${{ steps.normalise.outputs.dry-run }}
+      config-path: ${{ steps.normalise.outputs.config-path }}
 
   # ─── PR Cleanup: merge/close/delete stale PRs and branches ─────────
   pr-cleanup:
     needs: params
-    if: needs.params.outputs.mode == 'full' || needs.params.outputs.mode == 'pr-cleanup-only'
+    if: |
+      needs.params.outputs.dry-run != 'true' &&
+      (needs.params.outputs.mode == 'full' || needs.params.outputs.mode == 'pr-cleanup-only')
     runs-on: ubuntu-latest
     steps:
       - name: PR cleanup
@@ -194,7 +228,9 @@ jobs:
   # ─── Telemetry: gather repo state for supervisor ───────────────────
   telemetry:
     needs: params
-    if: needs.params.outputs.mode == 'full' || needs.params.outputs.mode == 'dev-only' || needs.params.outputs.mode == 'review-only'
+    if: |
+      needs.params.outputs.dry-run != 'true' &&
+      (needs.params.outputs.mode == 'full' || needs.params.outputs.mode == 'dev-only' || needs.params.outputs.mode == 'review-only')
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -271,6 +307,7 @@ jobs:
     needs: [params, pr-cleanup, telemetry]
     if: |
       always() &&
+      needs.params.outputs.dry-run != 'true' &&
       (needs.params.outputs.mode == 'full' || needs.params.outputs.mode == 'dev-only') &&
       needs.params.result == 'success'
     runs-on: ubuntu-latest
@@ -281,6 +318,10 @@ jobs:
         with:
           node-version: "24"
 
+      - name: Self-init (agentic-lib dev only)
+        if: hashFiles('scripts/self-init.sh') != '' && hashFiles('.github/agentic-lib/actions/agentic-step/package.json') == ''
+        run: bash scripts/self-init.sh
+
       - name: Install agentic-step dependencies
         working-directory: .github/agentic-lib/actions/agentic-step
         run: npm ci
@@ -292,7 +333,7 @@ jobs:
           COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
         with:
           task: "supervise"
-          config: ${{ env.configPath }}
+          config: ${{ needs.params.outputs.config-path }}
           instructions: ".github/agentic-lib/agents/agent-supervisor.md"
           model: ${{ needs.params.outputs.model }}
 
@@ -313,6 +354,10 @@ jobs:
         with:
           node-version: "24"
 
+      - name: Self-init (agentic-lib dev only)
+        if: hashFiles('scripts/self-init.sh') != '' && hashFiles('.github/agentic-lib/actions/agentic-step/package.json') == ''
+        run: bash scripts/self-init.sh
+
       - name: Install agentic-step dependencies
         working-directory: .github/agentic-lib/actions/agentic-step
         run: npm ci
@@ -320,7 +365,7 @@ jobs:
       - name: Load config
         id: config
         run: |
-          CONFIG="${{ env.configPath }}"
+          CONFIG="${{ needs.params.outputs.config-path }}"
           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")
@@ -334,7 +379,7 @@ jobs:
           COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
         with:
           task: "maintain-features"
-          config: ${{ env.configPath }}
+          config: ${{ needs.params.outputs.config-path }}
           instructions: ".github/agentic-lib/agents/agent-maintain-features.md"
           writable-paths: ${{ steps.config.outputs.featuresWritablePaths }}
           model: ${{ needs.params.outputs.model }}
@@ -346,12 +391,13 @@ jobs:
           COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
         with:
           task: "maintain-library"
-          config: ${{ env.configPath }}
+          config: ${{ needs.params.outputs.config-path }}
           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
+        if: needs.params.outputs.dry-run != 'true'
         uses: ./.github/agentic-lib/actions/commit-if-changed
         with:
           commit-message: "agentic-step: maintain features and library"
@@ -362,6 +408,7 @@ jobs:
     needs: [params, supervisor]
     if: |
       always() &&
+      needs.params.outputs.dry-run != 'true' &&
       needs.params.outputs.mode == 'full' &&
       needs.params.result == 'success'
     runs-on: ubuntu-latest
@@ -377,6 +424,10 @@ jobs:
       - name: Install project dependencies
         run: npm ci
 
+      - name: Self-init (agentic-lib dev only)
+        if: hashFiles('scripts/self-init.sh') != '' && hashFiles('.github/agentic-lib/actions/agentic-step/package.json') == ''
+        run: bash scripts/self-init.sh
+
       - name: Install agentic-step dependencies
         working-directory: .github/agentic-lib/actions/agentic-step
         run: npm ci
@@ -447,7 +498,7 @@ jobs:
           COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
         with:
           task: "fix-code"
-          config: ${{ env.configPath }}
+          config: ${{ needs.params.outputs.config-path }}
           instructions: ".github/agentic-lib/agents/agent-apply-fix.md"
           pr-number: ${{ env.FIX_PR_NUMBER }}
           test-command: "npm test"
@@ -474,6 +525,10 @@ jobs:
         with:
           node-version: "24"
 
+      - name: Self-init (agentic-lib dev only)
+        if: hashFiles('scripts/self-init.sh') != '' && hashFiles('.github/agentic-lib/actions/agentic-step/package.json') == ''
+        run: bash scripts/self-init.sh
+
       - name: Install agentic-step dependencies
         working-directory: .github/agentic-lib/actions/agentic-step
         run: npm ci
@@ -485,7 +540,7 @@ jobs:
           COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
         with:
           task: "review-issue"
-          config: ${{ env.configPath }}
+          config: ${{ needs.params.outputs.config-path }}
           instructions: ".github/agentic-lib/agents/agent-review-issue.md"
           model: ${{ needs.params.outputs.model }}
 
@@ -496,7 +551,7 @@ jobs:
           COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
         with:
           task: "enhance-issue"
-          config: ${{ env.configPath }}
+          config: ${{ needs.params.outputs.config-path }}
           instructions: ".github/agentic-lib/agents/agent-ready-issue.md"
           model: ${{ needs.params.outputs.model }}
 
@@ -521,6 +576,10 @@ jobs:
       - name: Install project dependencies
         run: npm ci
 
+      - name: Self-init (agentic-lib dev only)
+        if: hashFiles('scripts/self-init.sh') != '' && hashFiles('.github/agentic-lib/actions/agentic-step/package.json') == ''
+        run: bash scripts/self-init.sh
+
       - name: Install agentic-step dependencies
         working-directory: .github/agentic-lib/actions/agentic-step
         run: npm ci
@@ -528,7 +587,7 @@ jobs:
       - name: Load config
         id: config
         run: |
-          CONFIG="${{ env.configPath }}"
+          CONFIG="${{ needs.params.outputs.config-path }}"
           SOURCE=$(yq -r '.paths.targetSourcePath.path // "src/lib/"' "$CONFIG")
           TESTS=$(yq -r '.paths.targetTestsPath.path // "tests/unit/"' "$CONFIG")
           FEATURES=$(yq -r '.paths.featuresPath.path // "features/"' "$CONFIG")
@@ -579,7 +638,7 @@ jobs:
           COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
         with:
           task: "transform"
-          config: ${{ env.configPath }}
+          config: ${{ needs.params.outputs.config-path }}
           instructions: ".github/agentic-lib/agents/agent-issue-resolution.md"
           test-command: "npm test"
           model: ${{ needs.params.outputs.model }}
@@ -587,14 +646,14 @@ jobs:
           writable-paths: ${{ steps.config.outputs.writablePaths }}
 
       - name: Commit and push
-        if: steps.issue.outputs.issue-number != ''
+        if: steps.issue.outputs.issue-number != '' && needs.params.outputs.dry-run != 'true'
         uses: ./.github/agentic-lib/actions/commit-if-changed
         with:
           commit-message: "agentic-step: transform issue #${{ steps.issue.outputs.issue-number }}"
           push-ref: ${{ steps.branch.outputs.branchName }}
 
       - name: Create PR and attempt merge
-        if: steps.issue.outputs.issue-number != ''
+        if: steps.issue.outputs.issue-number != '' && needs.params.outputs.dry-run != 'true'
         uses: actions/github-script@v7
         with:
           script: |
@@ -696,11 +755,12 @@ jobs:
           echo "## agentic-lib-workflow run summary" >> $GITHUB_STEP_SUMMARY
           echo "- Mode: ${{ needs.params.outputs.mode }}" >> $GITHUB_STEP_SUMMARY
           echo "- Model: ${{ needs.params.outputs.model }}" >> $GITHUB_STEP_SUMMARY
+          echo "- Dry-run: ${{ needs.params.outputs.dry-run }}" >> $GITHUB_STEP_SUMMARY
 
   # ─── Schedule change (if requested) ────────────────────────────────
   update-schedule:
     needs: [params, dev]
-    if: always() && needs.params.outputs.schedule != '' && needs.params.result == 'success'
+    if: always() && needs.params.outputs.dry-run != 'true' && needs.params.outputs.schedule != '' && needs.params.result == 'success'
     uses: ./.github/workflows/agentic-lib-schedule.yml
     with:
       frequency: ${{ needs.params.outputs.schedule }}

package/agentic-lib.toml

@@ -0,0 +1,39 @@
+# SPDX-License-Identifier: GPL-3.0-only
+# Copyright (C) 2025-2026 Polycode Limited
+# agentic-lib.toml — Configuration for agentic-lib workflows
+#
+# Locally: paths point to test/ so dry-run workflows operate on test fixtures.
+# During init: #@dist transforms restore standard paths for consumer repos.
+
+[schedule]
+supervisor = "daily"              # off | weekly | daily | hourly | continuous
+model = "gpt-5-mini"              # gpt-5-mini | claude-sonnet-4 | gpt-4.1
+
+[paths]
+mission = "test/MISSION.md"                     #@dist "MISSION.md"
+source = "test/src/lib/"                        #@dist "src/lib/"
+tests = "test/tests/unit/"                      #@dist "tests/unit/"
+features = "test/features/"                     #@dist "features/"
+library = "test/library/"                       #@dist "library/"
+docs = "test/docs/"                             #@dist "docs/"
+examples = "test/examples/"                     #@dist "examples/"
+readme = "test/README.md"                       #@dist "README.md"
+dependencies = "test/package.json"              #@dist "package.json"
+contributing = "test/CONTRIBUTING.md"           #@dist "CONTRIBUTING.md"
+library-sources = "test/SOURCES.md"             #@dist "SOURCES.md"
+
+[execution]
+build = "npm run build"
+test = "npm test"
+start = "npm run start"
+
+[limits]
+feature-issues = 2
+maintenance-issues = 1
+attempts-per-branch = 3
+attempts-per-issue = 2
+features-limit = 2
+library-limit = 32
+
+[bot]
+log-file = "test/intentïon.md"                  #@dist "intentïon.md"

package/bin/agentic-lib.js

@@ -15,6 +15,7 @@
 //   npx @xn-intenton-z2a/agentic-lib fix-code
 
 import { copyFileSync, existsSync, mkdirSync, rmSync, rmdirSync, readdirSync, readFileSync, writeFileSync } from "fs";
+import { applyDistTransform } from "../src/dist-transform.js";
 import { resolve, dirname, join } from "path";
 import { fileURLToPath } from "url";
 import { execSync } from "child_process";
@@ -611,6 +612,19 @@ function createCliTools(writablePaths, defineTool) {
 
 // ─── Init Runner ─────────────────────────────────────────────────────
 
+function initTransformFile(src, dst, label) {
+  const content = readFileSync(src, "utf8");
+  const transformed = applyDistTransform(content);
+  if (dryRun) {
+    console.log(`  TRANSFORM: ${label}`);
+  } else {
+    mkdirSync(dirname(dst), { recursive: true });
+    writeFileSync(dst, transformed);
+    console.log(`  TRANSFORM: ${label}`);
+  }
+  initChanges++;
+}
+
 function initCopyFile(src, dst, label) {
   if (dryRun) {
     console.log(`  COPY: ${label}`);
@@ -655,33 +669,17 @@ function removeStaleWorkflows(templateWorkflows) {
 
 function initWorkflows() {
   console.log("--- Workflows ---");
-  const workflowsDir = resolve(srcDir, "workflows");
-  if (!existsSync(workflowsDir)) return;
+  // Distributable workflows live in .github/workflows/agentic-lib-*.yml
+  // and are transformed via #@dist markers during init
+  const ownWorkflowsDir = resolve(pkgRoot, ".github/workflows");
+  if (!existsSync(ownWorkflowsDir)) return;
   const templateWorkflows = new Set();
-  for (const f of readdirSync(workflowsDir)) {
-    if (f.endsWith(".yml")) {
+  for (const f of readdirSync(ownWorkflowsDir)) {
+    if (f.startsWith("agentic-lib-") && f.endsWith(".yml")) {
       templateWorkflows.add(f);
-      initCopyFile(resolve(workflowsDir, f), resolve(target, ".github/workflows", f), `workflows/${f}`);
+      initTransformFile(resolve(ownWorkflowsDir, f), resolve(target, ".github/workflows", f), `workflows/${f}`);
     }
   }
-  const seedTest = resolve(srcDir, "seeds/agentic-lib-test.yml");
-  if (existsSync(seedTest)) {
-    templateWorkflows.add("agentic-lib-test.yml");
-    initCopyFile(
-      seedTest,
-      resolve(target, ".github/workflows/agentic-lib-test.yml"),
-      "workflows/agentic-lib-test.yml (from seeds)",
-    );
-  }
-  const seedInit = resolve(srcDir, "seeds/agentic-lib-init.yml");
-  if (existsSync(seedInit)) {
-    templateWorkflows.add("agentic-lib-init.yml");
-    initCopyFile(
-      seedInit,
-      resolve(target, ".github/workflows/agentic-lib-init.yml"),
-      "workflows/agentic-lib-init.yml (from seeds)",
-    );
-  }
   removeStaleWorkflows(templateWorkflows);
 }
 
@@ -748,14 +746,15 @@ function initScripts(agenticDir) {
 
 function initConfig(seedsDir) {
   console.log("\n--- Config ---");
-  const tomlSeed = resolve(seedsDir, "zero-agentic-lib.toml");
+  // Config TOML lives at project root with #@dist markers — transform for distribution
+  const tomlSource = resolve(pkgRoot, "agentic-lib.toml");
   const tomlTarget = resolve(target, "agentic-lib.toml");
-  if (existsSync(tomlSeed) && !existsSync(tomlTarget)) {
-    initCopyFile(tomlSeed, tomlTarget, "agentic-lib.toml (new)");
+  if (existsSync(tomlSource) && !existsSync(tomlTarget)) {
+    initTransformFile(tomlSource, tomlTarget, "agentic-lib.toml (new)");
   } else if (existsSync(tomlTarget)) {
     console.log("  SKIP: agentic-lib.toml already exists");
   } else {
-    console.log("  SKIP: seed TOML not found");
+    console.log("  SKIP: source TOML not found");
   }
 
   const giSeed = resolve(seedsDir, "zero-.gitignore");
@@ -856,7 +855,6 @@ function initPurge(seedsDir, missionName) {
     "zero-SOURCES.md": "SOURCES.md",
     "zero-package.json": "package.json",
     "zero-README.md": "README.md",
-    "zero-agentic-lib.toml": "agentic-lib.toml",
     "zero-.gitignore": ".gitignore",
   };
   for (const [seedFile, targetRel] of Object.entries(SEED_MAP)) {
@@ -866,6 +864,12 @@ function initPurge(seedsDir, missionName) {
     }
   }
 
+  // Force-overwrite agentic-lib.toml during purge (transformed from root)
+  const tomlSource = resolve(pkgRoot, "agentic-lib.toml");
+  if (existsSync(tomlSource)) {
+    initTransformFile(tomlSource, resolve(target, "agentic-lib.toml"), "SEED: agentic-lib.toml (transformed)");
+  }
+
   // Copy mission seed file as MISSION.md
   const missionsDir = resolve(seedsDir, "missions");
   const missionFile = resolve(missionsDir, `${missionName}.md`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xn-intenton-z2a/agentic-lib",
-  "version": "7.1.54",
+  "version": "7.1.55",
   "description": "Agentic-lib Agentic Coding Systems SDK powering automated GitHub workflows.",
   "type": "module",
   "scripts": {
@@ -70,7 +70,9 @@
   "files": [
     "package.json",
     "bin/",
-    "src/workflows/",
+    "src/dist-transform.js",
+    ".github/workflows/agentic-lib-*.yml",
+    "agentic-lib.toml",
     "src/actions/agentic-step/*.js",
     "src/actions/agentic-step/*.yml",
     "src/actions/agentic-step/*.json",

package/src/actions/commit-if-changed/action.yml

@@ -40,15 +40,23 @@ runs:
           git commit -m "${{ inputs.commit-message }}"
           REF="${{ inputs.push-ref }}"
           MAX_RETRIES=3
+          REMOTE_REF_EXISTS=""
+          if [ -n "$REF" ]; then
+            git ls-remote --exit-code origin "$REF" > /dev/null 2>&1 && REMOTE_REF_EXISTS="true"
+          else
+            REMOTE_REF_EXISTS="true"
+          fi
           for attempt in $(seq 1 $MAX_RETRIES); do
             if [ -n "$REF" ]; then
-              git pull --rebase origin "$REF" || {
-                echo "Rebase conflict on attempt $attempt — aborting rebase and retrying"
-                git rebase --abort 2>/dev/null || true
-                sleep $((attempt * 2))
-                continue
-              }
-              git push origin "$REF" && break
+              if [ "$REMOTE_REF_EXISTS" = "true" ]; then
+                git pull --rebase origin "$REF" || {
+                  echo "Rebase conflict on attempt $attempt — aborting rebase and retrying"
+                  git rebase --abort 2>/dev/null || true
+                  sleep $((attempt * 2))
+                  continue
+                }
+              fi
+              git push origin "$REF" && { REMOTE_REF_EXISTS="true"; break; }
             else
               git pull --rebase || {
                 echo "Rebase conflict on attempt $attempt — aborting rebase and retrying"

package/src/dist-transform.js

@@ -0,0 +1,36 @@
+// SPDX-License-Identifier: GPL-3.0-only
+// Copyright (C) 2025-2026 Polycode Limited
+// src/dist-transform.js — #@dist marker transform for distribution
+
+/**
+ * Apply #@dist transforms to file content for distribution.
+ *
+ * Two patterns:
+ *   1. Line starts with "#@dist " — uncomment by removing the "#@dist " prefix
+ *      e.g. "#@dist schedule:" → "schedule:"
+ *   2. Line contains " #@dist <value>" suffix — replace the preceding value
+ *      e.g. 'default: true   #@dist false' → 'default: false'
+ *      e.g. 'mission = "test/MISSION.md"  #@dist "MISSION.md"' → 'mission = "MISSION.md"'
+ */
+export function applyDistTransform(content) {
+  return content
+    .split("\n")
+    .map((line) => {
+      // Pattern 1: line starts with #@dist — uncomment
+      const commentMatch = line.match(/^(\s*)#@dist (.*)$/);
+      if (commentMatch) {
+        return commentMatch[1] + commentMatch[2];
+      }
+      // Pattern 2: inline #@dist <replacement> — replace preceding value
+      const inlineMatch = line.match(/^(.+?)\s+#@dist\s+(.+)$/); // eslint-disable-line sonarjs/slow-regex
+      if (inlineMatch) {
+        const before = inlineMatch[1];
+        const replacement = inlineMatch[2];
+        // Replace the last value token on the line before #@dist
+        // Handles: 'key: value' (YAML) and 'key = "value"' (TOML)
+        return before.replace(/(:\s*|=\s*)(\S+)\s*$/, `$1${replacement}`); // eslint-disable-line sonarjs/slow-regex
+      }
+      return line;
+    })
+    .join("\n");
+}

package/src/seeds/zero-SOURCES.md

@@ -4,3 +4,5 @@ Reference material and documentation sources for this project.
 
 Add URLs, papers, API docs, or other reference material here.
 The maintain-library workflow will process these into `library/` documents.
+
+- https://en.wikipedia.org/wiki/Fizz_buzz

package/src/seeds/zero-package.json

@@ -14,7 +14,7 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@xn-intenton-z2a/agentic-lib": "^7.1.54"
+    "@xn-intenton-z2a/agentic-lib": "^7.1.55"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.18",

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

@@ -1,39 +0,0 @@
-# SPDX-License-Identifier: MIT
-# Copyright (C) 2025-2026 Polycode Limited
-# 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.
-
-[schedule]
-supervisor = "daily"              # off | weekly | daily | hourly | continuous
-model = "gpt-5-mini"              # gpt-5-mini | claude-sonnet-4 | gpt-4.1
-
-[paths]
-mission = "MISSION.md"
-source = "src/lib/"
-tests = "tests/unit/"
-features = "features/"
-library = "library/"
-docs = "docs/"
-examples = "examples/"
-readme = "README.md"
-dependencies = "package.json"
-contributing = "CONTRIBUTING.md"
-library-sources = "SOURCES.md"
-
-[execution]
-build = "npm run build"
-test = "npm test"
-start = "npm run start"
-
-[limits]
-feature-issues = 5
-maintenance-issues = 1
-attempts-per-branch = 3
-attempts-per-issue = 2
-features-limit = 4
-library-limit = 32
-
-[bot]
-log-file = "intentïon.md"