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

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

@@ -122,7 +122,7 @@ jobs:
           path: SCREENSHOT_INDEX.png
           if-no-files-found: ignore
 
-      - name: Push screenshot to .logs branch
+      - name: Push screenshot to agentic-lib-logs branch
         if: |
           github.ref == 'refs/heads/main' &&
           github.repository != 'xn-intenton-z2a/agentic-lib' &&

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

@@ -256,12 +256,53 @@ jobs:
       merged-prs: ${{ steps.cleanup.outputs.merged-prs }}
       closed-prs: ${{ steps.cleanup.outputs.closed-prs }}
 
-  # ─── Telemetry: gather repo state for supervisor ───────────────────
-  telemetry:
+  # ─── Behaviour Telemetry: run Playwright tests in container ────────
+  behaviour-telemetry:
     needs: params
     if: |
       needs.params.outputs.mode == 'full' || needs.params.outputs.mode == 'dev-only' || needs.params.outputs.mode == 'review-only'
     runs-on: ubuntu-latest
+    container: mcr.microsoft.com/playwright:v1.58.2-noble
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 24
+
+      - name: Install dependencies (non-blocking)
+        run: npm ci 2>/dev/null || npm install 2>/dev/null || true
+
+      - name: Build web assets (non-blocking)
+        run: npm run build:web 2>/dev/null || true
+
+      - name: Run behaviour tests (non-blocking)
+        id: behaviour-tests
+        if: hashFiles('playwright.config.js') != '' || hashFiles('playwright.config.ts') != ''
+        run: |
+          set +e
+          OUTPUT=$(npm run --if-present test:behaviour 2>&1)
+          EXIT_CODE=$?
+          echo "exit-code=$EXIT_CODE" | tee -a $GITHUB_OUTPUT
+          PASS_COUNT=$(echo "$OUTPUT" | grep -oP '\d+ passed' | head -1 | grep -oP '\d+' || echo "0")
+          FAIL_COUNT=$(echo "$OUTPUT" | grep -oP '\d+ failed' | head -1 | grep -oP '\d+' || echo "0")
+          echo "pass-count=$PASS_COUNT" | tee -a $GITHUB_OUTPUT
+          echo "fail-count=$FAIL_COUNT" | tee -a $GITHUB_OUTPUT
+          echo "$OUTPUT"
+          exit 0
+
+    outputs:
+      exit-code: ${{ steps.behaviour-tests.outputs.exit-code || '-1' }}
+      pass-count: ${{ steps.behaviour-tests.outputs.pass-count || '0' }}
+      fail-count: ${{ steps.behaviour-tests.outputs.fail-count || '0' }}
+
+  # ─── Telemetry: gather repo state for supervisor ───────────────────
+  telemetry:
+    needs: [params, behaviour-telemetry]
+    if: |
+      !cancelled() &&
+      (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@v6
 
@@ -304,24 +345,6 @@ jobs:
           echo "$OUTPUT"
           exit 0
 
-      - name: Run behaviour tests (non-blocking)
-        id: behaviour-tests
-        if: hashFiles('playwright.config.js') != '' || hashFiles('playwright.config.ts') != ''
-        run: |
-          set +e
-          npx playwright install --with-deps chromium 2>/dev/null || true
-          npm run build:web 2>/dev/null || true
-          OUTPUT=$(npm run --if-present test:behaviour 2>&1)
-          EXIT_CODE=$?
-          echo "exit-code=$EXIT_CODE" | tee -a  $GITHUB_OUTPUT
-          PASS_COUNT=$(echo "$OUTPUT" | grep -oP '\d+ passed' | head -1 | grep -oP '\d+' || echo "0")
-          FAIL_COUNT=$(echo "$OUTPUT" | grep -oP '\d+ failed' | head -1 | grep -oP '\d+' || echo "0")
-          echo "pass-count=$PASS_COUNT" | tee -a  $GITHUB_OUTPUT
-          echo "fail-count=$FAIL_COUNT" | tee -a  $GITHUB_OUTPUT
-          echo "$OUTPUT" > /tmp/behaviour-test-output.txt
-          echo "$OUTPUT"
-          exit 0
-
       - name: Gather telemetry
         id: gather
         uses: actions/github-script@v8
@@ -428,21 +451,21 @@ jobs:
             const missionComplete = fs.existsSync('MISSION_COMPLETE.md');
             const missionFailed = fs.existsSync('MISSION_FAILED.md');
 
-            // Activity log stats (fetched from .logs branch)
+            // Activity log stats (fetched from agentic-lib-logs branch)
             let activityStats = null;
             try {
-              // Try .logs branch first (new location), fall back to local file (legacy)
+              // Try agentic-lib-logs branch first (new location), fall back to local file (legacy)
               let log = null;
               for (const logFile of ['intenti\u00F6n.md', 'intention.md']) {
                 try {
                   const { data } = await github.rest.repos.getContent({
-                    owner, repo, path: logFile, ref: '.logs',
+                    owner, repo, path: logFile, ref: 'agentic-lib-logs',
                   });
                   log = Buffer.from(data.content, 'base64').toString('utf8');
                   break;
                 } catch { /* try next */ }
               }
-              // Fall back to local file (for repos not yet using .logs branch)
+              // Fall back to local file (for repos not yet using agentic-lib-logs branch)
               if (!log) {
                 const logPath = fs.existsSync('intenti\u00F6n.md') ? 'intenti\u00F6n.md' : (fs.existsSync('intention.md') ? 'intention.md' : null);
                 if (logPath) log = fs.readFileSync(logPath, 'utf8');
@@ -462,10 +485,6 @@ jobs:
             const unitOutput = fs.existsSync('/tmp/unit-test-output.txt')
               ? fs.readFileSync('/tmp/unit-test-output.txt', 'utf8')
               : '';
-            const behaviourOutput = fs.existsSync('/tmp/behaviour-test-output.txt')
-              ? fs.readFileSync('/tmp/behaviour-test-output.txt', 'utf8')
-              : '';
-
             const telemetry = {
               issues: issuesSummary,
               instabilityIssues: instabilityNumbers,
@@ -487,10 +506,9 @@ jobs:
                   output: unitOutput,
                 },
                 behaviour: {
-                  exitCode: parseInt('${{ steps.behaviour-tests.outputs.exit-code }}' || '-1'),
-                  passCount: parseInt('${{ steps.behaviour-tests.outputs.pass-count }}' || '0'),
-                  failCount: parseInt('${{ steps.behaviour-tests.outputs.fail-count }}' || '0'),
-                  output: behaviourOutput,
+                  exitCode: parseInt('${{ needs.behaviour-telemetry.outputs.exit-code }}' || '-1'),
+                  passCount: parseInt('${{ needs.behaviour-telemetry.outputs.pass-count }}' || '0'),
+                  failCount: parseInt('${{ needs.behaviour-telemetry.outputs.fail-count }}' || '0'),
                 },
               },
               externalTestResults,
@@ -540,10 +558,10 @@ jobs:
         with:
           fetch-depth: 0
 
-      - name: Fetch log from .logs branch
+      - name: Fetch log from agentic-lib-logs branch
         run: |
           for f in "intentïon.md" "intention.md"; do
-            git show "origin/.logs:${f}" > "$f" 2>/dev/null || true
+            git show "origin/agentic-lib-logs:${f}" > "$f" 2>/dev/null || true
           done
 
       - name: Check mission-complete signal
@@ -642,7 +660,7 @@ jobs:
           commit-message: "agentic-step: maintain features and library"
           push-ref: ${{ github.ref_name }}
 
-      - name: Push log to .logs branch
+      - 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"
 
@@ -662,10 +680,10 @@ jobs:
         with:
           fetch-depth: 0
 
-      - name: Fetch log from .logs branch
+      - name: Fetch log from agentic-lib-logs branch
         run: |
           for f in "intentïon.md" "intention.md"; do
-            git show "origin/.logs:${f}" > "$f" 2>/dev/null || true
+            git show "origin/agentic-lib-logs:${f}" > "$f" 2>/dev/null || true
           done
 
       - uses: actions/setup-node@v6
@@ -693,7 +711,7 @@ jobs:
           instructions: ".github/agentic-lib/agents/agent-director.md"
           model: ${{ needs.params.outputs.model }}
 
-      - name: Push log to .logs branch
+      - 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"
 
@@ -712,10 +730,10 @@ jobs:
         with:
           fetch-depth: 0
 
-      - name: Fetch log from .logs branch
+      - name: Fetch log from agentic-lib-logs branch
         run: |
           for f in "intentïon.md" "intention.md"; do
-            git show "origin/.logs:${f}" > "$f" 2>/dev/null || true
+            git show "origin/agentic-lib-logs:${f}" > "$f" 2>/dev/null || true
           done
 
       - uses: actions/setup-node@v6
@@ -743,7 +761,7 @@ jobs:
           instructions: ".github/agentic-lib/agents/agent-supervisor.md"
           model: ${{ needs.params.outputs.model }}
 
-      - name: Push log to .logs branch
+      - 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"
 
@@ -767,13 +785,13 @@ jobs:
       - name: Install project dependencies
         run: npm ci
 
-      - name: Install Playwright (for behaviour tests)
-        if: hashFiles('playwright.config.js') != '' || hashFiles('playwright.config.ts') != ''
-        run: npx playwright install --with-deps chromium
-
-      - 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 Playwright (for behaviour tests)
+#        if: hashFiles('playwright.config.js') != '' || hashFiles('playwright.config.ts') != ''
+#        run: npx playwright install --with-deps chromium
+#
+#      - 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
@@ -1127,10 +1145,10 @@ jobs:
           fetch-depth: 0
           token: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: Fetch log from .logs branch
+      - name: Fetch log from agentic-lib-logs branch
         run: |
           for f in "intentïon.md" "intention.md"; do
-            git show "origin/.logs:${f}" > "$f" 2>/dev/null || true
+            git show "origin/agentic-lib-logs:${f}" > "$f" 2>/dev/null || true
           done
 
       - uses: actions/setup-node@v6
@@ -1262,29 +1280,29 @@ jobs:
           echo "tests-passed=true" >> $GITHUB_OUTPUT
           echo "All tests passed"
 
-      - name: Run behaviour tests before committing
-        id: pre-commit-behaviour-test
-        if: steps.issue.outputs.issue-number != '' && steps.pre-commit-test.outputs.tests-passed == 'true' && (hashFiles('playwright.config.js') != '' || hashFiles('playwright.config.ts') != '')
-        run: |
-          npx playwright install --with-deps chromium 2>/dev/null || true
-          npm run build:web 2>/dev/null || true
-          set +e
-          npm run --if-present test:behaviour 2>&1 | tail -30
-          EXIT_CODE=$?
-          if [ $EXIT_CODE -ne 0 ]; then
-            echo "::warning::Behaviour test attempt 1 failed — retrying"
-            sleep 2
-            npm run --if-present test:behaviour 2>&1 | tail -30
-            EXIT_CODE=$?
-          fi
-          set -e
-          if [ $EXIT_CODE -ne 0 ]; then
-            echo "tests-passed=false" >> $GITHUB_OUTPUT
-            echo "WARNING: Behaviour tests failed (exit $EXIT_CODE) — skipping commit and PR"
-            exit 0
-          fi
-          echo "tests-passed=true" >> $GITHUB_OUTPUT
-          echo "Behaviour tests passed"
+#      - name: Run behaviour tests before committing
+#        id: pre-commit-behaviour-test
+#        if: steps.issue.outputs.issue-number != '' && steps.pre-commit-test.outputs.tests-passed == 'true' && (hashFiles('playwright.config.js') != '' || hashFiles('playwright.config.ts') != '')
+#        run: |
+#          npx playwright install --with-deps chromium 2>/dev/null || true
+#          npm run build:web 2>/dev/null || true
+#          set +e
+#          npm run --if-present test:behaviour 2>&1 | tail -30
+#          EXIT_CODE=$?
+#          if [ $EXIT_CODE -ne 0 ]; then
+#            echo "::warning::Behaviour test attempt 1 failed — retrying"
+#            sleep 2
+#            npm run --if-present test:behaviour 2>&1 | tail -30
+#            EXIT_CODE=$?
+#          fi
+#          set -e
+#          if [ $EXIT_CODE -ne 0 ]; then
+#            echo "tests-passed=false" >> $GITHUB_OUTPUT
+#            echo "WARNING: Behaviour tests failed (exit $EXIT_CODE) — skipping commit and PR"
+#            exit 0
+#          fi
+#          echo "tests-passed=true" >> $GITHUB_OUTPUT
+#          echo "Behaviour tests passed"
 
       - name: Commit and push
         if: github.repository != 'xn-intenton-z2a/agentic-lib' && steps.issue.outputs.issue-number != '' && needs.params.outputs.dry-run != 'true' && steps.pre-commit-test.outputs.tests-passed == 'true' && steps.pre-commit-behaviour-test.outputs.tests-passed != 'false'
@@ -1293,7 +1311,7 @@ jobs:
           commit-message: "agentic-step: transform issue #${{ steps.issue.outputs.issue-number }}"
           push-ref: ${{ steps.branch.outputs.branchName }}
 
-      - name: Push log to .logs branch
+      - 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"
 

package/bin/agentic-lib.js

@@ -1134,30 +1134,30 @@ function initPurgeGitHub() {
     console.log(`  SKIP: Could not create discussion (${err.message})`);
   }
 
-  // ── Create/reset .logs orphan branch ─────────────────────────────
-  console.log("\n--- .logs branch (activity log + screenshot) ---");
+  // ── Create/reset agentic-lib-logs orphan branch ─────────────────────────────
+  console.log("\n--- agentic-lib-logs branch (activity log + screenshot) ---");
   try {
     if (!dryRun) {
-      // Delete existing .logs branch if present
+      // Delete existing agentic-lib-logs branch if present
       try {
-        ghExec(`gh api repos/${repoSlug}/git/refs/heads/.logs -X DELETE`);
-        console.log("  DELETE: existing .logs branch");
+        ghExec(`gh api repos/${repoSlug}/git/refs/heads/agentic-lib-logs -X DELETE`);
+        console.log("  DELETE: existing agentic-lib-logs branch");
       } catch { /* branch may not exist */ }
-      // Create orphan .logs branch with an empty commit via the API
+      // Create orphan agentic-lib-logs branch with an empty commit via the API
       // First get the empty tree SHA
       const emptyTree = JSON.parse(ghExec(`gh api repos/${repoSlug}/git/trees -X POST -f "tree[0][path]=.gitkeep" -f "tree[0][mode]=100644" -f "tree[0][type]=blob" -f "tree[0][content]="`));
       const commitData = JSON.parse(ghExec(
-        `gh api repos/${repoSlug}/git/commits -X POST -f "message=init .logs branch" -f "tree=${emptyTree.sha}"`,
+        `gh api repos/${repoSlug}/git/commits -X POST -f "message=init agentic-lib-logs branch" -f "tree=${emptyTree.sha}"`,
       ));
-      ghExec(`gh api repos/${repoSlug}/git/refs -X POST -f "ref=refs/heads/.logs" -f "sha=${commitData.sha}"`);
-      console.log("  CREATE: .logs orphan branch");
+      ghExec(`gh api repos/${repoSlug}/git/refs -X POST -f "ref=refs/heads/agentic-lib-logs" -f "sha=${commitData.sha}"`);
+      console.log("  CREATE: agentic-lib-logs orphan branch");
       initChanges++;
     } else {
-      console.log("  CREATE: .logs orphan branch (dry run)");
+      console.log("  CREATE: agentic-lib-logs orphan branch (dry run)");
       initChanges++;
     }
   } catch (err) {
-    console.log(`  SKIP: Could not create .logs branch (${err.message})`);
+    console.log(`  SKIP: Could not create agentic-lib-logs branch (${err.message})`);
   }
 
   // ── Enable GitHub Pages ───────────────────────────────────────────

package/package.json

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

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

@@ -28,7 +28,7 @@ runs:
         git add -A
         # Unstage workflow files — GITHUB_TOKEN cannot push workflow changes
         git reset HEAD -- '.github/workflows/' 2>/dev/null || true
-        # Unstage log/screenshot files — these live on the .logs branch
+        # Unstage log/screenshot files — these live on the agentic-lib-logs branch
         git reset HEAD -- 'intentïon.md' 'intention.md' 'SCREENSHOT_INDEX.png' 2>/dev/null || true
         if git diff --cached --quiet; then
           echo "No changes to commit"

package/src/scripts/push-to-logs.sh

@@ -1,17 +1,17 @@
 #!/usr/bin/env bash
 # SPDX-License-Identifier: MIT
 # Copyright (C) 2025-2026 Polycode Limited
-# push-to-logs.sh — Push log/screenshot files to the .logs orphan branch.
+# push-to-logs.sh — Push log/screenshot files to the agentic-lib-logs orphan branch.
 #
 # Usage: bash .github/agentic-lib/scripts/push-to-logs.sh [file ...]
 #   e.g. bash .github/agentic-lib/scripts/push-to-logs.sh "intentïon.md" SCREENSHOT_INDEX.png
 #
-# Creates the .logs branch if it doesn't exist. Uses rebase/retry for
+# Creates the agentic-lib-logs branch if it doesn't exist. Uses rebase/retry for
 # concurrent pushes (same strategy as commit-if-changed).
 
 set -euo pipefail
 
-BRANCH=".logs"
+BRANCH="agentic-lib-logs"
 MAX_RETRIES=3
 
 # Collect files that actually exist in the workspace
@@ -39,12 +39,12 @@ for f in "${FILES[@]}"; do
   cp "$f" "${TMPDIR}/$(basename "$f")"
 done
 
-# Fetch the .logs branch (may not exist yet)
+# Fetch the agentic-lib-logs branch (may not exist yet)
 REMOTE_EXISTS=""
 git fetch origin "${BRANCH}" 2>/dev/null && REMOTE_EXISTS="true" || true
 
 if [ "$REMOTE_EXISTS" = "true" ]; then
-  # Check out existing .logs branch into a detached worktree-like state
+  # Check out existing agentic-lib-logs branch into a detached worktree-like state
   git checkout "origin/${BRANCH}" -- . 2>/dev/null || true
   git checkout -B "${BRANCH}" "origin/${BRANCH}"
 else

package/src/seeds/zero-.gitignore

@@ -20,7 +20,7 @@ Thumbs.db
 *.swp
 *.swo
 
-# Activity log and screenshot (live on .logs branch, not main)
+# Activity log and screenshot (live on agentic-lib-logs branch, not main)
 /intentïon.md
 /intention.md
 /SCREENSHOT_INDEX.png

package/src/seeds/zero-package.json

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