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

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

@@ -122,29 +122,12 @@ jobs:
           path: SCREENSHOT_INDEX.png
           if-no-files-found: ignore
 
-      - name: Push screenshot on main
+      - name: Push screenshot to .logs branch
         if: |
           github.ref == 'refs/heads/main' &&
+          github.repository != 'xn-intenton-z2a/agentic-lib' &&
           (github.event_name == 'schedule' || inputs.push-screenshot == 'true' || inputs.push-screenshot == true)
-        run: |
-          git config --global --add safe.directory "$GITHUB_WORKSPACE"
-          git config user.name "github-actions[bot]"
-          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
-          git add SCREENSHOT_INDEX.png
-          git diff --cached --quiet && echo "No screenshot changes" && exit 0
-          git commit -m "test: update SCREENSHOT_INDEX.png [skip ci]"
-          for attempt in 1 2 3; do
-            git push origin HEAD: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 "::warning::Failed to push screenshot after 3 attempts"
-            fi
-          done
+        run: bash .github/agentic-lib/scripts/push-to-logs.sh SCREENSHOT_INDEX.png
 
   # ─── Dispatch fix workflow when unit tests fail on main ─────────────
   dispatch-fix:

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

@@ -428,12 +428,26 @@ jobs:
             const missionComplete = fs.existsSync('MISSION_COMPLETE.md');
             const missionFailed = fs.existsSync('MISSION_FAILED.md');
 
-            // Activity log stats
+            // Activity log stats (fetched from .logs branch)
             let activityStats = null;
             try {
-              const logPath = fs.existsSync('intenti\u00F6n.md') ? 'intenti\u00F6n.md' : (fs.existsSync('intention.md') ? 'intention.md' : null);
-              if (logPath) {
-                const log = fs.readFileSync(logPath, 'utf8');
+              // Try .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',
+                  });
+                  log = Buffer.from(data.content, 'base64').toString('utf8');
+                  break;
+                } catch { /* try next */ }
+              }
+              // Fall back to local file (for repos not yet using .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');
+              }
+              if (log) {
                 const entries = log.split('\n## ').length - 1;
                 const costMatches = [...log.matchAll(/\*\*agentic-lib transformation cost:\*\* (\d+)/g)];
                 const totalCost = costMatches.reduce((sum, m) => sum + parseInt(m[1], 10), 0);
@@ -526,6 +540,12 @@ jobs:
         with:
           fetch-depth: 0
 
+      - name: Fetch log from .logs branch
+        run: |
+          for f in "intentïon.md" "intention.md"; do
+            git show "origin/.logs:${f}" > "$f" 2>/dev/null || true
+          done
+
       - name: Check mission-complete signal
         id: mission-check
         run: |
@@ -622,6 +642,10 @@ jobs:
           commit-message: "agentic-step: maintain features and library"
           push-ref: ${{ github.ref_name }}
 
+      - name: Push log to .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"
+
   # ─── Director: LLM evaluates mission status (complete/failed/in-progress) ──
   director:
     needs: [params, telemetry, maintain]
@@ -635,6 +659,14 @@ jobs:
       analysis: ${{ steps.director.outputs.director-analysis }}
     steps:
       - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Fetch log from .logs branch
+        run: |
+          for f in "intentïon.md" "intention.md"; do
+            git show "origin/.logs:${f}" > "$f" 2>/dev/null || true
+          done
 
       - uses: actions/setup-node@v6
         with:
@@ -661,6 +693,10 @@ jobs:
           instructions: ".github/agentic-lib/agents/agent-director.md"
           model: ${{ needs.params.outputs.model }}
 
+      - name: Push log to .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"
+
   # ─── Supervisor: LLM decides what to do (after director evaluates) ──
   supervisor:
     needs: [params, pr-cleanup, telemetry, maintain, director]
@@ -673,6 +709,14 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Fetch log from .logs branch
+        run: |
+          for f in "intentïon.md" "intention.md"; do
+            git show "origin/.logs:${f}" > "$f" 2>/dev/null || true
+          done
 
       - uses: actions/setup-node@v6
         with:
@@ -699,6 +743,10 @@ jobs:
           instructions: ".github/agentic-lib/agents/agent-supervisor.md"
           model: ${{ needs.params.outputs.model }}
 
+      - name: Push log to .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"
+
   # ─── Fix stuck PRs with failing checks ─────────────────────────────
   fix-stuck:
     needs: [params, supervisor]
@@ -1079,6 +1127,12 @@ jobs:
           fetch-depth: 0
           token: ${{ secrets.GITHUB_TOKEN }}
 
+      - name: Fetch log from .logs branch
+        run: |
+          for f in "intentïon.md" "intention.md"; do
+            git show "origin/.logs:${f}" > "$f" 2>/dev/null || true
+          done
+
       - uses: actions/setup-node@v6
         with:
           node-version: "24"
@@ -1239,6 +1293,10 @@ jobs:
           commit-message: "agentic-step: transform issue #${{ steps.issue.outputs.issue-number }}"
           push-ref: ${{ steps.branch.outputs.branchName }}
 
+      - name: Push log to .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"
+
       - name: Create PR and attempt merge
         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'
         uses: actions/github-script@v8

package/agentic-lib.toml

@@ -134,7 +134,7 @@ library-limit = 64                     # max library entries in library/ directo
 # Thresholds for deterministic mission-complete declaration.
 # All conditions must be met simultaneously.
 min-resolved-issues = 3            # minimum closed-as-RESOLVED issues since init
-require-dedicated-tests = true     # require test files that import from src/lib/
+min-dedicated-tests = 1            # minimum test files that import from src/lib/
 max-source-todos = 0               # max TODO comments allowed in ./src (0 = none)
 
 [bot]

package/bin/agentic-lib.js

@@ -559,6 +559,7 @@ function initScripts(agenticDir) {
     "clean.sh",
     "initialise.sh",
     "md-to-html.js",
+    "push-to-logs.sh",
     "update.sh",
   ];
   if (!existsSync(scriptsDir)) return;
@@ -1133,6 +1134,32 @@ function initPurgeGitHub() {
     console.log(`  SKIP: Could not create discussion (${err.message})`);
   }
 
+  // ── Create/reset .logs orphan branch ─────────────────────────────
+  console.log("\n--- .logs branch (activity log + screenshot) ---");
+  try {
+    if (!dryRun) {
+      // Delete existing .logs branch if present
+      try {
+        ghExec(`gh api repos/${repoSlug}/git/refs/heads/.logs -X DELETE`);
+        console.log("  DELETE: existing .logs branch");
+      } catch { /* branch may not exist */ }
+      // Create orphan .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}"`,
+      ));
+      ghExec(`gh api repos/${repoSlug}/git/refs -X POST -f "ref=refs/heads/.logs" -f "sha=${commitData.sha}"`);
+      console.log("  CREATE: .logs orphan branch");
+      initChanges++;
+    } else {
+      console.log("  CREATE: .logs orphan branch (dry run)");
+      initChanges++;
+    }
+  } catch (err) {
+    console.log(`  SKIP: Could not create .logs branch (${err.message})`);
+  }
+
   // ── Enable GitHub Pages ───────────────────────────────────────────
   console.log("\n--- Enable GitHub Pages ---");
   try {

package/package.json

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

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

@@ -261,7 +261,7 @@ export function loadConfig(configPath) {
   const mc = toml["mission-complete"] || {};
   const missionCompleteThresholds = {
     minResolvedIssues: mc["min-resolved-issues"] ?? 3,
-    requireDedicatedTests: mc["require-dedicated-tests"] ?? true,
+    minDedicatedTests: mc["min-dedicated-tests"] ?? (mc["require-dedicated-tests"] === false ? 0 : 1),
     maxSourceTodos: mc["max-source-todos"] ?? 0,
   };
 

package/src/actions/agentic-step/index.js

@@ -86,20 +86,20 @@ function buildMissionMetrics(config, result, limitsStatus, cumulativeCost, featu
   const srcRoot = sourceDir.includes("/") ? sourceDir.split("/").slice(0, -1).join("/") || "src" : "src";
   const todoCount = countSourceTodos(srcRoot);
 
-  // W3: Check for dedicated test files
-  const hasDedicatedTests = result.hasDedicatedTests ?? false;
+  // W3: Count dedicated test files
+  const dedicatedTestCount = result.dedicatedTestCount ?? 0;
 
   // W11: Thresholds from config
   const thresholds = config.missionCompleteThresholds || {};
   const minResolved = thresholds.minResolvedIssues ?? 3;
-  const requireTests = thresholds.requireDedicatedTests ?? true;
+  const minTests = thresholds.minDedicatedTests ?? 1;
   const maxTodos = thresholds.maxSourceTodos ?? 0;
 
   const metrics = [
     { metric: "Open issues", value: String(openIssues), target: "0", status: openIssues === 0 ? "MET" : "NOT MET" },
     { metric: "Open PRs", value: String(openPrs), target: "0", status: openPrs === 0 ? "MET" : "NOT MET" },
     { metric: "Issues resolved (review or PR merge)", value: String(resolvedCount), target: `>= ${minResolved}`, status: resolvedCount >= minResolved ? "MET" : "NOT MET" },
-    { metric: "Dedicated test files", value: hasDedicatedTests ? "YES" : "NO", target: requireTests ? "YES" : "—", status: !requireTests || hasDedicatedTests ? "MET" : "NOT MET" },
+    { metric: "Dedicated test files", value: String(dedicatedTestCount), target: `>= ${minTests}`, status: dedicatedTestCount >= minTests ? "MET" : "NOT MET" },
     { metric: "Source TODO count", value: String(todoCount), target: `<= ${maxTodos}`, status: todoCount <= maxTodos ? "MET" : "NOT MET" },
     { metric: "Transformation budget used", value: `${cumulativeCost}/${budgetCap}`, target: budgetCap > 0 ? `< ${budgetCap}` : "unlimited", status: budgetCap > 0 && cumulativeCost >= budgetCap ? "EXHAUSTED" : "OK" },
     { metric: "Cumulative transforms", value: String(cumulativeCost), target: ">= 1", status: cumulativeCost >= 1 ? "MET" : "NOT MET" },
@@ -117,7 +117,7 @@ function buildMissionReadiness(metrics) {
   const openIssues = parseInt(metrics.find((m) => m.metric === "Open issues")?.value || "0", 10);
   const openPrs = parseInt(metrics.find((m) => m.metric === "Open PRs")?.value || "0", 10);
   const resolved = parseInt(metrics.find((m) => m.metric === "Issues resolved (review or PR merge)")?.value || "0", 10);
-  const hasDedicatedTests = metrics.find((m) => m.metric === "Dedicated test files")?.value === "YES";
+  const dedicatedTests = parseInt(metrics.find((m) => m.metric === "Dedicated test files")?.value || "0", 10);
   const todoCount = parseInt(metrics.find((m) => m.metric === "Source TODO count")?.value || "0", 10);
   const missionComplete = metrics.find((m) => m.metric === "Mission complete declared")?.value === "YES";
   const missionFailed = metrics.find((m) => m.metric === "Mission failed declared")?.value === "YES";
@@ -136,7 +136,7 @@ function buildMissionReadiness(metrics) {
 
   if (allMet) {
     parts.push("Mission complete conditions ARE met.");
-    parts.push(`0 open issues, 0 open PRs, ${resolved} issue(s) resolved, dedicated tests: ${hasDedicatedTests ? "yes" : "no"}, TODOs: ${todoCount}.`);
+    parts.push(`0 open issues, 0 open PRs, ${resolved} issue(s) resolved, ${dedicatedTests} dedicated test(s), TODOs: ${todoCount}.`);
   } else {
     parts.push("Mission complete conditions are NOT met.");
     if (openIssues > 0) parts.push(`${openIssues} open issue(s) remain.`);
@@ -262,9 +262,9 @@ async function run() {
       ? readdirSync(libraryPath).filter((f) => f.endsWith(".md")).length
       : 0;
 
-    // W3/W10: Detect dedicated test files (centrally, for all tasks)
-    let hasDedicatedTests = result.hasDedicatedTests ?? false;
-    if (!hasDedicatedTests) {
+    // W3/W10: Count dedicated test files (centrally, for all tasks)
+    let dedicatedTestCount = result.dedicatedTestCount ?? 0;
+    if (dedicatedTestCount === 0) {
       try {
         const { scanDirectory: scanDir } = await import("./copilot.js");
         const testDirs = ["tests", "__tests__"];
@@ -275,17 +275,14 @@ async function run() {
               if (/^(main|web|behaviour)\.test\.[jt]s$/.test(tf.name)) continue;
               const content = readFileSync(tf.path, "utf8");
               if (/from\s+['"].*src\/lib\//.test(content) || /require\s*\(\s*['"].*src\/lib\//.test(content)) {
-                hasDedicatedTests = true;
-                break;
+                dedicatedTestCount++;
               }
             }
-            if (hasDedicatedTests) break;
           }
         }
       } catch { /* ignore — scanDirectory not available in test environment */ }
     }
-    // Inject hasDedicatedTests into result for buildMissionMetrics
-    result.hasDedicatedTests = hasDedicatedTests;
+    result.dedicatedTestCount = dedicatedTestCount;
 
     // Count open automated issues (feature vs maintenance)
     let featureIssueCount = 0;

package/src/actions/agentic-step/tasks/direct.js

@@ -40,7 +40,6 @@ function countTodos(dir) {
  * Detect dedicated test files that import from src/lib/.
  */
 function detectDedicatedTests() {
-  let hasDedicatedTests = false;
   const dedicatedTestFiles = [];
   const testDirs = ["tests", "__tests__"];
   for (const dir of testDirs) {
@@ -51,14 +50,13 @@ function detectDedicatedTests() {
           if (/^(main|web|behaviour)\.test\.[jt]s$/.test(tf.name)) continue;
           const content = readFileSync(tf.path, "utf8");
           if (/from\s+['"].*src\/lib\//.test(content) || /require\s*\(\s*['"].*src\/lib\//.test(content)) {
-            hasDedicatedTests = true;
             dedicatedTestFiles.push(tf.name);
           }
         }
       } catch { /* ignore */ }
     }
   }
-  return { hasDedicatedTests, dedicatedTestFiles };
+  return { dedicatedTestCount: dedicatedTestFiles.length, dedicatedTestFiles };
 }
 
 /**
@@ -68,14 +66,14 @@ function detectDedicatedTests() {
 function buildMetricAssessment(ctx, config) {
   const thresholds = config.missionCompleteThresholds || {};
   const minResolved = thresholds.minResolvedIssues ?? 3;
-  const requireTests = thresholds.requireDedicatedTests ?? true;
+  const minTests = thresholds.minDedicatedTests ?? 1;
   const maxTodos = thresholds.maxSourceTodos ?? 0;
 
   const metrics = [
     { metric: "Open issues", value: ctx.issuesSummary.length, target: 0, met: ctx.issuesSummary.length === 0 },
     { metric: "Open PRs", value: ctx.prsSummary.length, target: 0, met: ctx.prsSummary.length === 0 },
     { metric: "Issues resolved", value: ctx.resolvedCount, target: minResolved, met: ctx.resolvedCount >= minResolved },
-    { metric: "Dedicated tests", value: ctx.hasDedicatedTests ? "YES" : "NO", target: requireTests ? "YES" : "—", met: !requireTests || ctx.hasDedicatedTests },
+    { metric: "Dedicated tests", value: ctx.dedicatedTestCount, target: minTests, met: ctx.dedicatedTestCount >= minTests },
     { metric: "Source TODOs", value: ctx.sourceTodoCount, target: maxTodos, met: ctx.sourceTodoCount <= maxTodos },
     { metric: "Budget", value: ctx.cumulativeTransformationCost, target: ctx.transformationBudget || "unlimited", met: !(ctx.transformationBudget > 0 && ctx.cumulativeTransformationCost >= ctx.transformationBudget) },
   ];
@@ -86,7 +84,7 @@ function buildMetricAssessment(ctx, config) {
   const table = [
     "| Metric | Value | Target | Status |",
     "|--------|-------|--------|--------|",
-    ...metrics.map((m) => `| ${m.metric} | ${m.value} | ${typeof m.target === "number" ? (m.metric.includes("TODO") ? `<= ${m.target}` : m.metric.includes("resolved") ? `>= ${m.target}` : `${m.target}`) : m.target} | ${m.met ? "MET" : "NOT MET"} |`),
+    ...metrics.map((m) => `| ${m.metric} | ${m.value} | ${typeof m.target === "number" ? (m.metric.includes("TODO") ? `<= ${m.target}` : `>= ${m.target}`) : m.target} | ${m.met ? "MET" : "NOT MET"} |`),
   ].join("\n");
 
   let assessment;
@@ -134,8 +132,8 @@ function buildPrompt(ctx, agentInstructions, metricAssessment) {
         ]
       : []),
     `### Test Coverage`,
-    ctx.hasDedicatedTests
-      ? `Dedicated test files: ${ctx.dedicatedTestFiles.join(", ")}`
+    ctx.dedicatedTestCount > 0
+      ? `Dedicated test files (${ctx.dedicatedTestCount}): ${ctx.dedicatedTestFiles.join(", ")}`
       : "**No dedicated test files found.**",
     "",
     `### Source TODO Count: ${ctx.sourceTodoCount}`,
@@ -348,7 +346,7 @@ export async function direct(context) {
   } catch { /* ignore */ }
 
   // Dedicated tests
-  const { hasDedicatedTests, dedicatedTestFiles } = detectDedicatedTests();
+  const { dedicatedTestCount, dedicatedTestFiles } = detectDedicatedTests();
 
   // TODO count
   const sourcePath = config.paths.source?.path || "src/lib/";
@@ -365,7 +363,7 @@ export async function direct(context) {
     resolvedCount,
     prsSummary,
     sourceExports,
-    hasDedicatedTests,
+    dedicatedTestCount,
     dedicatedTestFiles,
     sourceTodoCount,
     cumulativeTransformationCost,
@@ -424,7 +422,7 @@ export async function direct(context) {
     narrative: `Director: ${reason}`,
     metricAssessment: metricAssessment.assessment,
     directorAnalysis: analysis,
-    hasDedicatedTests,
+    dedicatedTestCount,
     resolvedCount,
     changes: outcome === "mission-complete"
       ? [{ action: "mission-complete", file: "MISSION_COMPLETE.md", sizeInfo: reason.substring(0, 100) }]

package/src/actions/agentic-step/tasks/supervise.js

@@ -312,9 +312,9 @@ async function gatherContext(octokit, repo, config, t) {
     }
   } catch { /* ignore */ }
 
-  // Check for dedicated test files (not just seed tests)
+  // Count dedicated test files (not just seed tests)
   // A dedicated test imports from the source directory (src/lib/) rather than being a seed test
-  let hasDedicatedTests = false;
+  let dedicatedTestCount = 0;
   let dedicatedTestFiles = [];
   try {
     const testDirs = ["tests", "__tests__"];
@@ -327,7 +327,7 @@ async function gatherContext(octokit, repo, config, t) {
           const content = readFileSync(tf.path, "utf8");
           // Check if it imports from src/lib/ (mission-specific code)
           if (/from\s+['"].*src\/lib\//.test(content) || /require\s*\(\s*['"].*src\/lib\//.test(content)) {
-            hasDedicatedTests = true;
+            dedicatedTestCount++;
             dedicatedTestFiles.push(tf.name);
           }
         }
@@ -395,7 +395,7 @@ async function gatherContext(octokit, repo, config, t) {
     cumulativeTransformationCost,
     recentlyClosedSummary,
     sourceExports,
-    hasDedicatedTests,
+    dedicatedTestCount,
     dedicatedTestFiles,
     sourceTodoCount,
   };
@@ -434,8 +434,8 @@ function buildPrompt(ctx, agentInstructions, config) {
         ]
       : []),
     `### Test Coverage`,
-    ctx.hasDedicatedTests
-      ? `Dedicated test files: ${ctx.dedicatedTestFiles.join(", ")}`
+    ctx.dedicatedTestCount > 0
+      ? `Dedicated test files (${ctx.dedicatedTestCount}): ${ctx.dedicatedTestFiles.join(", ")}`
       : "**No dedicated test files found.** Only seed tests (main.test.js, web.test.js) exist. Mission-complete requires dedicated tests that import from src/lib/.",
     "",
     `### Source TODO Count: ${ctx.sourceTodoCount}`,
@@ -447,7 +447,7 @@ function buildPrompt(ctx, agentInstructions, config) {
       // W10: Build mission-complete metrics inline for the LLM
       const thresholds = config?.missionCompleteThresholds || {};
       const minResolved = thresholds.minResolvedIssues ?? 3;
-      const requireTests = thresholds.requireDedicatedTests ?? true;
+      const minTests = thresholds.minDedicatedTests ?? 1;
       const maxTodos = thresholds.maxSourceTodos ?? 0;
       const resolvedCount = ctx.recentlyClosedSummary.filter((s) => s.includes("RESOLVED")).length;
       const rows = [
@@ -457,7 +457,7 @@ function buildPrompt(ctx, agentInstructions, config) {
         `| Open issues | ${ctx.issuesSummary.length} | 0 | ${ctx.issuesSummary.length === 0 ? "MET" : "NOT MET"} |`,
         `| Open PRs | ${ctx.prsSummary.length} | 0 | ${ctx.prsSummary.length === 0 ? "MET" : "NOT MET"} |`,
         `| Issues resolved (RESOLVED) | ${resolvedCount} | >= ${minResolved} | ${resolvedCount >= minResolved ? "MET" : "NOT MET"} |`,
-        `| Dedicated test files | ${ctx.hasDedicatedTests ? "YES" : "NO"} | ${requireTests ? "YES" : "—"} | ${!requireTests || ctx.hasDedicatedTests ? "MET" : "NOT MET"} |`,
+        `| Dedicated test files | ${ctx.dedicatedTestCount} | >= ${minTests} | ${ctx.dedicatedTestCount >= minTests ? "MET" : "NOT MET"} |`,
         `| Source TODO count | ${ctx.sourceTodoCount} | <= ${maxTodos} | ${ctx.sourceTodoCount <= maxTodos ? "MET" : "NOT MET"} |`,
         `| Budget used | ${ctx.cumulativeTransformationCost}/${ctx.transformationBudget} | < ${ctx.transformationBudget || "unlimited"} | ${ctx.transformationBudget > 0 && ctx.cumulativeTransformationCost >= ctx.transformationBudget ? "EXHAUSTED" : "OK"} |`,
         "",

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

@@ -28,20 +28,10 @@ runs:
         git add -A
         # Unstage workflow files — GITHUB_TOKEN cannot push workflow changes
         git reset HEAD -- '.github/workflows/' 2>/dev/null || true
-        # Unstage log files on non-default branches to avoid merge conflicts
-        REF="${{ inputs.push-ref }}"
-        if [ -n "$REF" ] && [ "$REF" != "main" ] && [ "$REF" != "master" ]; then
-          git reset HEAD -- 'intentïon.md' 'intention.md' 2>/dev/null || true
-        fi
+        # Unstage log/screenshot files — these live on the .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"
-        elif git diff --cached --name-only | grep -qvE '(intentïon\.md|intention\.md)$'; then
-          # At least one non-log file changed — proceed with commit
-          true
-        else
-          echo "Only log files changed — skipping commit"
-          git reset HEAD -- . > /dev/null 2>&1
-          exit 0
         fi
         if ! git diff --cached --quiet; then
           git commit -m "${{ inputs.commit-message }}"

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

@@ -0,0 +1,86 @@
+#!/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.
+#
+# 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
+# concurrent pushes (same strategy as commit-if-changed).
+
+set -euo pipefail
+
+BRANCH=".logs"
+MAX_RETRIES=3
+
+# Collect files that actually exist in the workspace
+FILES=()
+for arg in "$@"; do
+  if [ -f "$arg" ]; then
+    FILES+=("$arg")
+  fi
+done
+
+if [ ${#FILES[@]} -eq 0 ]; then
+  echo "push-to-logs: no files to push"
+  exit 0
+fi
+
+echo "push-to-logs: pushing ${FILES[*]} to ${BRANCH}"
+
+# Configure git
+git config --local user.email 'action@github.com'
+git config --local user.name 'GitHub Actions[bot]'
+
+# Save file contents to temp
+TMPDIR=$(mktemp -d)
+for f in "${FILES[@]}"; do
+  cp "$f" "${TMPDIR}/$(basename "$f")"
+done
+
+# Fetch the .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
+  git checkout "origin/${BRANCH}" -- . 2>/dev/null || true
+  git checkout -B "${BRANCH}" "origin/${BRANCH}"
+else
+  # Create orphan branch
+  git checkout --orphan "${BRANCH}"
+  git rm -rf . 2>/dev/null || true
+fi
+
+# Copy files in
+for f in "${FILES[@]}"; do
+  cp "${TMPDIR}/$(basename "$f")" "$f"
+  git add "$f"
+done
+
+# Commit if changed
+if git diff --cached --quiet 2>/dev/null; then
+  echo "push-to-logs: no changes to commit"
+else
+  git commit -m "logs: update ${FILES[*]} [skip ci]"
+
+  for attempt in $(seq 1 $MAX_RETRIES); do
+    git push origin "${BRANCH}" && break
+    echo "push-to-logs: push failed (attempt $attempt) — pulling and retrying"
+    git pull --rebase origin "${BRANCH}" || {
+      echo "push-to-logs: rebase conflict — aborting and retrying"
+      git rebase --abort 2>/dev/null || true
+    }
+    sleep $((attempt * 2))
+    if [ "$attempt" -eq "$MAX_RETRIES" ]; then
+      echo "::warning::push-to-logs: failed to push after $MAX_RETRIES attempts"
+    fi
+  done
+fi
+
+# Return to previous branch
+git checkout - 2>/dev/null || git checkout main 2>/dev/null || true
+
+# Clean up
+rm -rf "$TMPDIR"

package/src/seeds/zero-.gitignore

@@ -20,8 +20,12 @@ Thumbs.db
 *.swp
 *.swo
 
+# Activity log and screenshot (live on .logs branch, not main)
+/intentïon.md
+/intention.md
+/SCREENSHOT_INDEX.png
+
 # Generated files at repo root (agents should use examples/ instead)
-/*.png
 /*.svg
 /*.pdf
 /*.csv

package/src/seeds/zero-package.json

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