@xn-intenton-z2a/agentic-lib 7.2.10 → 7.2.12

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

@@ -2,15 +2,12 @@
 # Copyright (C) 2025-2026 Polycode Limited
 # .github/workflows/agentic-lib-init.yml
 #
-# 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.
+# Init: delegates to agentic-lib-update.yml for the update step, then
+# optionally reseeds or purges user content and configures schedule/model.
+# Commits and pushes to main [skip ci].
 
 name: agentic-lib-init
-run-name: "agentic-lib-init [${{ github.ref_name }}]"
+run-name: "agentic-lib-init ${{ inputs.mode || 'update' }} [${{ github.ref_name }}]"
 
 on:
   workflow_call:
@@ -120,49 +117,27 @@ on:
 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
-          MISSION_SEED='${{ inputs.mission-seed }}'
-          echo "mission-seed=${MISSION_SEED:-hamming-distance}" >> $GITHUB_OUTPUT
-          MISSION_TEXT='${{ inputs.mission-text }}'
-          echo "mission-text=${MISSION_TEXT}" >> $GITHUB_OUTPUT
-          SCHEDULE='${{ inputs.schedule }}'
-          echo "schedule=${SCHEDULE}" >> $GITHUB_OUTPUT
-          MODEL='${{ inputs.model }}'
-          echo "model=${MODEL:-gpt-5-mini}" >> $GITHUB_OUTPUT
-          PROFILE='${{ inputs.profile }}'
-          echo "profile=${PROFILE}" >> $GITHUB_OUTPUT
-    outputs:
-      mode: ${{ steps.normalise.outputs.mode }}
-      dry-run: ${{ steps.normalise.outputs.dry-run }}
-      mission-seed: ${{ steps.normalise.outputs.mission-seed }}
-      mission-text: ${{ steps.normalise.outputs.mission-text }}
-      schedule: ${{ steps.normalise.outputs.schedule }}
-      model: ${{ steps.normalise.outputs.model }}
-      profile: ${{ steps.normalise.outputs.profile }}
+  # Step 1: Update agentic-lib and infrastructure (commits to main)
+  update:
+    uses: ./.github/workflows/agentic-lib-update.yml
+    with:
+      dry-run: ${{ inputs.dry-run || 'false' }}
+    secrets: inherit
 
+  # Step 2: Reseed/purge and configure (only if mode != update)
   init:
-    needs: params
+    needs: update
+    if: inputs.mode == 'reseed' || inputs.mode == 'purge'
     runs-on: ubuntu-latest
     env:
-      INIT_MODE: ${{ needs.params.outputs.mode }}
-      INIT_DRY_RUN: ${{ needs.params.outputs.dry-run }}
-      INIT_MISSION_SEED: ${{ needs.params.outputs.mission-seed }}
-      INIT_MISSION_TEXT: ${{ needs.params.outputs.mission-text }}
+      INIT_MODE: ${{ inputs.mode }}
+      INIT_MISSION_SEED: ${{ inputs.mission-seed || 'hamming-distance' }}
+      INIT_MISSION_TEXT: ${{ inputs.mission-text }}
     steps:
       - uses: actions/checkout@v6
-        if: needs.params.outputs.dry-run == 'true'
+        if: inputs.dry-run == 'true' || inputs.dry-run == true
       - uses: actions/checkout@v6
-        if: needs.params.outputs.dry-run != 'true'
+        if: inputs.dry-run != 'true' && inputs.dry-run != true
         with:
           ref: main
           token: ${{ secrets.WORKFLOW_TOKEN }}
@@ -172,11 +147,10 @@ jobs:
           node-version: "24"
 
       - name: Close hanging init PRs
-        if: github.repository != 'xn-intenton-z2a/agentic-lib' && env.INIT_MODE == 'purge' && needs.params.outputs.dry-run != 'true'
+        if: github.repository != 'xn-intenton-z2a/agentic-lib' && env.INIT_MODE == 'purge' && inputs.dry-run != 'true' && inputs.dry-run != true
         env:
           GH_TOKEN: ${{ secrets.WORKFLOW_TOKEN }}
         run: |
-          # Close any open PRs from previous init runs
           gh pr list --state open --json number,headRefName \
             --jq '.[] | select(.headRefName | startswith("agentic-lib-init-")) | .number' \
             | while read -r pr_num; do
@@ -184,18 +158,15 @@ jobs:
                 gh pr close "$pr_num" --delete-branch || true
               done
 
-      - name: Update agentic-lib to latest
-        run: npm update @xn-intenton-z2a/agentic-lib
-
-      - name: Run init
+      - name: Run init (reseed/purge)
         env:
           GH_TOKEN: ${{ github.token }}
         run: |
           FLAGS="init"
           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
-          # Use local CLI if available (agentic-lib dev), otherwise npx
+          DRY_RUN='${{ inputs.dry-run }}'
+          if [ "$DRY_RUN" = "true" ]; then FLAGS="$FLAGS --dry-run"; fi
           if [ -f "bin/agentic-lib.js" ]; then
             node bin/agentic-lib.js $FLAGS
           else
@@ -203,7 +174,7 @@ jobs:
           fi
 
       - name: Write mission text (if provided, overrides seed)
-        if: env.INIT_MISSION_TEXT != '' && needs.params.outputs.dry-run != 'true'
+        if: env.INIT_MISSION_TEXT != '' && inputs.dry-run != 'true' && inputs.dry-run != true
         run: |
           printf '# Mission\n\n%s\n' "$INIT_MISSION_TEXT" > MISSION.md
           echo "Wrote custom mission text to MISSION.md"
@@ -221,18 +192,16 @@ jobs:
       - run: npm test
 
       - name: Update model and profile (if requested)
-        if: github.repository != 'xn-intenton-z2a/agentic-lib' && needs.params.outputs.dry-run != 'true' && (needs.params.outputs.model != '' || needs.params.outputs.profile != '')
+        if: github.repository != 'xn-intenton-z2a/agentic-lib' && inputs.dry-run != 'true' && inputs.dry-run != true && (inputs.model != '' || inputs.profile != '')
         uses: actions/github-script@v8
         with:
           script: |
             const fs = require('fs');
-            const model = '${{ needs.params.outputs.model }}';
-            const profile = '${{ needs.params.outputs.profile }}';
+            const model = '${{ inputs.model }}';
+            const profile = '${{ inputs.profile }}';
             const tomlPath = 'agentic-lib.toml';
             if (!fs.existsSync(tomlPath)) return;
             let toml = fs.readFileSync(tomlPath, 'utf8');
-            // Extract the [tuning] section, then replace within it.
-            // Previous regex [^\[]*? failed when comments contained '[' characters.
             const tuningSectionRegex = /(\[tuning\])([\s\S]*?)(?=\n\[|$)/;
             const tuningMatch = toml.match(tuningSectionRegex);
             if (tuningMatch) {
@@ -256,13 +225,13 @@ jobs:
             fs.writeFileSync(tomlPath, toml);
 
       - name: Update schedule (if requested)
-        if: github.repository != 'xn-intenton-z2a/agentic-lib' && needs.params.outputs.schedule != '' && needs.params.outputs.dry-run != 'true'
+        if: github.repository != 'xn-intenton-z2a/agentic-lib' && inputs.schedule != '' && inputs.dry-run != 'true' && inputs.dry-run != true
         uses: actions/github-script@v8
         with:
           script: |
             const fs = require('fs');
-            const frequency = '${{ needs.params.outputs.schedule }}';
-            const model = '${{ needs.params.outputs.model || 'gpt-5-mini' }}';
+            const frequency = '${{ inputs.schedule }}';
+            const model = '${{ inputs.model || 'gpt-5-mini' }}';
             const workflowPath = '.github/workflows/agentic-lib-workflow.yml';
             const tomlPath = 'agentic-lib.toml';
 
@@ -308,7 +277,7 @@ jobs:
             }
 
       - name: Commit and push to main [skip ci]
-        if: github.repository != 'xn-intenton-z2a/agentic-lib' && needs.params.outputs.dry-run != 'true'
+        if: github.repository != 'xn-intenton-z2a/agentic-lib' && inputs.dry-run != 'true' && inputs.dry-run != true
         env:
           GH_TOKEN: ${{ secrets.WORKFLOW_TOKEN }}
         run: |
@@ -334,9 +303,8 @@ jobs:
             fi
           done
 
-      # W8: Create initial seed issues after purge so the pipeline has work to do
       - name: Create initial seed issues
-        if: github.repository != 'xn-intenton-z2a/agentic-lib' && env.INIT_MODE == 'purge' && needs.params.outputs.dry-run != 'true'
+        if: github.repository != 'xn-intenton-z2a/agentic-lib' && env.INIT_MODE == 'purge' && inputs.dry-run != 'true' && inputs.dry-run != true
         uses: actions/github-script@v8
         with:
           script: |
@@ -345,7 +313,6 @@ jobs:
               ? fs.readFileSync('MISSION.md', 'utf8')
               : '(no MISSION.md found)';
 
-            // Ensure labels exist
             for (const label of ['automated', 'ready']) {
               try {
                 await github.rest.issues.createLabel({
@@ -356,7 +323,6 @@ jobs:
               } catch (e) { /* label already exists */ }
             }
 
-            // W8a: Initial unit tests issue
             const unitTestBody = [
               'Create a unit test file for each of the major features in the mission ',
               'and put a TODO in a trivial empty passing test in each.',
@@ -373,7 +339,6 @@ jobs:
             });
             core.info(`Created issue #${issue1.number}: Initial unit tests`);
 
-            // W8b: Initial web layout issue
             const webLayoutBody = [
               'Create the home page layout to showcase each of the major features in the mission ',
               'and put a TODO in a trivial empty passing test in each.',

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

@@ -0,0 +1,100 @@
+# SPDX-License-Identifier: MIT
+# Copyright (C) 2025-2026 Polycode Limited
+# .github/workflows/agentic-lib-update.yml
+#
+# Update agentic-lib to latest, extract workflows/actions/scripts, run tests,
+# commit and push to main [skip ci]. Does NOT reseed or purge user content.
+#
+# In agentic-lib: schedule trigger is commented out.
+# During init: #@dist restores the schedule.
+
+name: agentic-lib-update
+run-name: "agentic-lib-update [${{ github.ref_name }}]"
+
+on:
+  workflow_call:
+    inputs:
+      dry-run:
+        type: string
+        required: false
+        default: "false"
+  #@dist schedule:
+  #@dist   - cron: "15 6 * * *"
+  workflow_dispatch:
+    inputs:
+      dry-run:
+        description: "Preview changes without committing"
+        type: boolean
+        required: false
+        default: false
+
+permissions: write-all
+
+jobs:
+  update:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        if: inputs.dry-run == 'true' || inputs.dry-run == true
+      - uses: actions/checkout@v6
+        if: inputs.dry-run != 'true' && inputs.dry-run != true
+        with:
+          ref: main
+          token: ${{ secrets.WORKFLOW_TOKEN }}
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: "24"
+
+      - name: Update agentic-lib to latest
+        run: npm update @xn-intenton-z2a/agentic-lib
+
+      - name: Run init (update mode)
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          # Use local CLI if available (agentic-lib dev), otherwise npx
+          if [ -f "bin/agentic-lib.js" ]; then
+            node bin/agentic-lib.js init
+          else
+            npx @xn-intenton-z2a/agentic-lib init
+          fi
+
+      - 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: Commit and push to main [skip ci]
+        if: github.repository != 'xn-intenton-z2a/agentic-lib' && inputs.dry-run != 'true' && inputs.dry-run != true
+        env:
+          GH_TOKEN: ${{ secrets.WORKFLOW_TOKEN }}
+        run: |
+          TOKEN_USER=$(gh api /user --jq '.login')
+          TOKEN_ID=$(gh api /user --jq '.id')
+          git config user.name "${TOKEN_USER}"
+          git config user.email "${TOKEN_ID}+${TOKEN_USER}@users.noreply.github.com"
+          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 "update agentic-lib@${VERSION} [skip ci]"
+          for attempt in 1 2 3; do
+            git push origin main && break
+            echo "Push failed (attempt $attempt) — pulling and retrying"
+            git pull --rebase origin main || {
+              echo "Rebase conflict — aborting rebase and retrying"
+              git rebase --abort 2>/dev/null || true
+            }
+            sleep $((attempt * 2))
+            if [ "$attempt" -eq 3 ]; then
+              echo "::error::Failed to push after 3 attempts"
+              exit 1
+            fi
+          done

package/bin/agentic-lib.js

@@ -555,6 +555,7 @@ function initScripts(agenticDir) {
   const DISTRIBUTED_SCRIPTS = [
     "accept-release.sh",
     "activate-schedule.sh",
+    "build-web.cjs",
     "clean.sh",
     "initialise.sh",
     "md-to-html.js",

package/package.json

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

package/src/scripts/build-web.cjs

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+// SPDX-License-Identifier: MIT
+// Copyright (C) 2025-2026 Polycode Limited
+// scripts/build-web.cjs
+// Usage: node .github/agentic-lib/scripts/build-web.cjs
+//
+// Builds the docs/ directory for web serving:
+// 1. Creates docs/ and copies src/web/* into it
+// 2. Generates docs/lib-meta.js with package metadata exports
+// 3. Generates docs/lib-browser.js from src/lib/main.js (if it has named exports)
+//
+// This file is part of the Example Suite for `agentic-lib` see: https://github.com/xn-intenton-z2a/agentic-lib
+// This file is licensed under the MIT License. For details, see LICENSE-MIT
+
+const fs = require("fs");
+const path = require("path");
+
+const docsDir = path.resolve("docs");
+
+// Step 1: Create docs/ and copy src/web/* if it exists
+fs.mkdirSync(docsDir, { recursive: true });
+fs.writeFileSync(path.join(docsDir, ".nojekyll"), "");
+
+const webDir = path.resolve("src", "web");
+if (fs.existsSync(webDir)) {
+  for (const entry of fs.readdirSync(webDir, { withFileTypes: true })) {
+    const src = path.join(webDir, entry.name);
+    const dest = path.join(docsDir, entry.name);
+    if (entry.isFile()) {
+      fs.copyFileSync(src, dest);
+    } else if (entry.isDirectory()) {
+      fs.cpSync(src, dest, { recursive: true });
+    }
+  }
+}
+
+// Step 2: Generate docs/lib-meta.js with package metadata
+const pkg = JSON.parse(fs.readFileSync("package.json", "utf8"));
+const metaLines = ["name", "version", "description"].map(
+  (k) => `export const ${k} = ${JSON.stringify(pkg[k])};`
+);
+fs.writeFileSync(path.join(docsDir, "lib-meta.js"), metaLines.join("\n") + "\n");
+console.log("Wrote docs/lib-meta.js");
+
+// Step 3: Generate docs/lib-browser.js from src/lib/main.js named exports
+// Parse the main module for `export function` and `export async function` declarations
+// and re-emit them as a standalone browser-compatible module.
+const mainPath = path.resolve("src", "lib", "main.js");
+if (fs.existsSync(mainPath)) {
+  const mainSrc = fs.readFileSync(mainPath, "utf8");
+  // Match named export functions: export function foo(...) { ... } or export async function foo(...)
+  const exportRegex = /^export\s+(async\s+)?function\s+(\w+)/gm;
+  const exportNames = [];
+  let match;
+  while ((match = exportRegex.exec(mainSrc)) !== null) {
+    exportNames.push(match[2]);
+  }
+
+  if (exportNames.length > 0) {
+    // Extract the function bodies by finding each export function and copying it verbatim
+    const lines = mainSrc.split("\n");
+    const functionBodies = [];
+    for (let i = 0; i < lines.length; i++) {
+      if (/^export\s+(async\s+)?function\s+\w+/.test(lines[i])) {
+        // Collect lines until we find the closing brace at column 0
+        const fnLines = [lines[i]];
+        let braceDepth = 0;
+        for (let j = i; j < lines.length; j++) {
+          for (const ch of lines[j]) {
+            if (ch === "{") braceDepth++;
+            if (ch === "}") braceDepth--;
+          }
+          if (j > i) fnLines.push(lines[j]);
+          if (braceDepth === 0 && j >= i) {
+            break;
+          }
+        }
+        functionBodies.push(fnLines.join("\n"));
+      }
+    }
+
+    const header = [
+      "// docs/lib-browser.js",
+      "// Generated browser-compatible module exposing named exports from src/lib/main.js.",
+      "// Auto-generated by build-web.cjs — do not edit manually.",
+      "",
+    ].join("\n");
+
+    fs.writeFileSync(
+      path.join(docsDir, "lib-browser.js"),
+      header + functionBodies.join("\n\n") + "\n"
+    );
+    console.log(
+      `Wrote docs/lib-browser.js (${exportNames.length} exports: ${exportNames.join(", ")})`
+    );
+  }
+}

package/src/seeds/zero-package.json

@@ -6,7 +6,7 @@
   "main": "src/lib/main.js",
   "scripts": {
     "build": "npm run build:web",
-    "build:web": "mkdir -p docs && touch docs/.nojekyll && cp -r src/web/* docs/ 2>/dev/null || true && node --input-type=commonjs -p \"var p=require('./package.json');['name','version','description'].map(function(k){return 'export const '+k+' = '+JSON.stringify(p[k])+';'}).join('\\n')\" > docs/lib-meta.js",
+    "build:web": "node .github/agentic-lib/scripts/build-web.cjs",
     "test": "vitest --run tests/unit/*.test.js",
     "test:unit": "vitest --run --coverage tests/unit/*.test.js",
     "test:behaviour": "npm run build:web && npx playwright test --config playwright.config.js",
@@ -17,7 +17,7 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@xn-intenton-z2a/agentic-lib": "^7.2.10"
+    "@xn-intenton-z2a/agentic-lib": "^7.2.12"
   },
   "devDependencies": {
     "@playwright/test": "^1.58.0",