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

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/package.json

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

package/src/seeds/zero-package.json

@@ -17,7 +17,7 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@xn-intenton-z2a/agentic-lib": "^7.2.20"
+    "@xn-intenton-z2a/agentic-lib": "^7.2.21"
   },
   "devDependencies": {
     "@playwright/test": "^1.58.0",