total-recall-brain 3.43.3 → 3.45.0

package/scaffold/.agent/skills/total-recall/plugins/meta-harness/src/worktree.mjs

@@ -20,18 +20,32 @@ export const diffBetween = (cwd, base, head) => must(cwd, ['diff', `${base}...${
 const ACTIVE_WORKTREES = new Map();
 
 /** `branch` creates a new branch from `ref`. Without it, the checkout is detached at `ref` (read-only use). */
-export function createWorktree(cwd, { branch, ref = 'HEAD', prefix = 'meta-harness-' } = {}) {
+export function createWorktree(cwd, { branch, ref = 'HEAD', prefix = 'meta-harness-', existingBranch = false } = {}) {
   const directory = fs.mkdtempSync(path.join(os.tmpdir(), prefix));
-  const args = branch ? ['worktree', 'add', '-b', branch, directory, ref] : ['worktree', 'add', '--detach', directory, ref];
+  const args = branch ? existingBranch ? ['worktree', 'add', directory, branch] : ['worktree', 'add', '-b', branch, directory, ref] : ['worktree', 'add', '--detach', directory, ref];
   const result = git(cwd, args, 120000);
   if (result.status !== 0) {
     fs.rmSync(directory, { recursive: true, force: true });
     throw new Error(`Creating a worktree failed: ${String(result.stderr).trim().slice(0, 300)}`);
   }
-  ACTIVE_WORKTREES.set(directory, { cwd, branch: branch || null });
+  ACTIVE_WORKTREES.set(directory, { cwd, branch: branch || null, base: headCommit(directory) });
   seedMandatorySkills(cwd, directory);
+  linkPrivatePlans(cwd, directory);
   return directory;
 }
+/**
+ * Plans in docs/projects are private and untracked in public repositories, so a checkout lacks them
+ * and an agent would start a duplicate plan (A-116). Link the one real plan folder in; never commit it.
+ */
+const PLANS = 'docs/projects';
+function linkPrivatePlans(cwd, directory) {
+  const root = git(cwd, ['rev-parse', '--show-toplevel']).stdout.trim();
+  const source = path.join(root, PLANS), target = path.join(directory, PLANS);
+  if (!root || !fs.existsSync(source) || fs.existsSync(target)) return;
+  if (git(cwd, ['ls-files', '--', PLANS]).stdout.trim()) return;
+  fs.mkdirSync(path.dirname(target), { recursive: true });
+  fs.symlinkSync(source, target);
+}
 /**
  * An agent's own Total Recall preflight needs these two files at the repository root, and they are
  * usually gitignored, so a fresh checkout lacks them and every agent inside it would report itself blocked.
@@ -57,17 +71,58 @@ export function linkDependencies(cwd, directory) {
   const target = path.join(directory, '.agent/skills/code-quality');
   if (fs.existsSync(quality) && !fs.existsSync(target)) fs.cpSync(quality, target, { recursive: true, filter: source => !source.includes(`${path.sep}reports`) });
 }
+/**
+ * Give an agent's checkout its own dependencies before it starts (A-109). A link would let an
+ * agent's `npm install` write into the operator's tree, so the checkout gets a copy-on-write
+ * clone of `node_modules` (macOS clonefile, Linux reflink: no extra disk), or, when the operator
+ * has none, a frozen install from the lockfile. Returns what it did, for the attempt record.
+ */
+export function provideDependencies(cwd, directory, { run = spawnSync } = {}) {
+  if (!fs.existsSync(path.join(directory, 'package.json'))) return { action: 'none', reason: 'no package.json' };
+  const target = path.join(directory, 'node_modules');
+  if (fs.existsSync(target)) return { action: 'present' };
+  const modules = path.join(cwd, 'node_modules');
+  if (fs.existsSync(modules)) {
+    const args = process.platform === 'darwin' ? ['-c', '-R', modules, target] : ['-a', '--reflink=auto', modules, target];
+    const copied = run('cp', args, { stdio: 'ignore' });
+    if (copied.status === 0) return { action: 'cloned' };
+  }
+  const lock = [['package-lock.json', 'npm', ['ci', '--no-audit', '--no-fund']], ['pnpm-lock.yaml', 'pnpm', ['install', '--frozen-lockfile']], ['yarn.lock', 'yarn', ['install', '--frozen-lockfile']]]
+    .find(([file]) => fs.existsSync(path.join(directory, file)));
+  if (!lock) return { action: 'none', reason: 'no lockfile' };
+  const installed = run(lock[1], lock[2], { cwd: directory, stdio: 'ignore', timeout: 600000 });
+  return installed.status === 0 ? { action: 'installed', manager: lock[1] } : { action: 'failed', manager: lock[1] };
+}
+
+/**
+ * Push a finished job's branch (A-113, Greg 2026-11-09: agents push finished work themselves).
+ * Only `meta-harness/...` branches are pushed, so a job can never push a deploy branch.
+ * No `origin` remote means nothing to push. Returns what happened, for the job record.
+ */
+export function pushBranch(cwd, branch) {
+  if (!branch || !branch.startsWith('meta-harness/')) return { pushed: false, reason: 'not a job branch' };
+  if (git(cwd, ['remote', 'get-url', 'origin']).status !== 0) return { pushed: false, reason: 'no origin remote' };
+  const result = git(cwd, ['push', '-q', '-u', 'origin', `${branch}:${branch}`], 120000);
+  return result.status === 0 ? { pushed: true, remote: 'origin', branch } : { pushed: false, reason: String(result.stderr || result.error || '').trim().slice(0, 300) };
+}
 export const deleteBranch = (cwd, branch) => git(cwd, ['branch', '-D', branch]).status === 0;
 export function removeWorktree(cwd, directory) {
   if (!directory) return;
   ACTIVE_WORKTREES.delete(directory);
-  try { if (fs.lstatSync(path.join(directory, 'node_modules')).isSymbolicLink()) fs.rmSync(path.join(directory, 'node_modules')); } catch { /* no link */ }
+  for (const link of ['node_modules', PLANS]) {
+    try { if (fs.lstatSync(path.join(directory, link)).isSymbolicLink()) fs.rmSync(path.join(directory, link)); } catch { /* no link */ }
+  }
   git(cwd, ['worktree', 'remove', '--force', directory], 60000);
   fs.rmSync(directory, { recursive: true, force: true });
 }
 /** Commit whatever the agent left. Returns the commit, or null when it changed nothing. */
 export function commitAll(directory, message) {
-  must(directory, ['add', '-A', '--', '.', ':!node_modules'], 'Staging agent changes');
+  // Stage everything git does not ignore. Naming node_modules in the pathspec fails when it is
+  // ignored (A-114), so it is unstaged afterwards instead, for repositories that do not ignore it.
+  must(directory, ['add', '-A'], 'Staging agent changes');
+  git(directory, ['rm', '-r', '--cached', '-q', '--ignore-unmatch', '--', 'node_modules']);
+  // The linked private plan folder (A-116) is the operator's, never part of the agent's commit.
+  try { if (fs.lstatSync(path.join(directory, PLANS)).isSymbolicLink()) git(directory, ['rm', '-r', '--cached', '-q', '--ignore-unmatch', '--', PLANS]); } catch { /* no link */ }
   // Seeded skills are scaffolding, not the agent's work. A repository that tracks them keeps normal history.
   for (const file of MANDATORY_SKILLS) if (git(directory, ['cat-file', '-e', `HEAD:${file}`]).status !== 0) git(directory, ['rm', '--cached', '-q', '--ignore-unmatch', '--', file]);
   if (git(directory, ['diff', '--cached', '--quiet']).status === 0) return null;
@@ -77,10 +132,22 @@ export function commitAll(directory, message) {
   must(directory, ['commit', '-m', message], 'Committing agent changes');
   return headCommit(directory);
 }
-/** A stopped run's checkouts and unfinished branches go with it. A branch already handed back has no active checkout. */
-export function removeActiveWorktrees() {
-  for (const [directory, { cwd, branch }] of [...ACTIVE_WORKTREES]) {
+/** Remove owned checkouts. Cancellation keeps branches that contain work. */
+export function removeActiveWorktrees({ preserveChanges = false } = {}) {
+  const saved = [];
+  for (const [directory, { cwd, branch, base }] of [...ACTIVE_WORKTREES]) {
+    let wip = null;
+    if (preserveChanges && branch) {
+      try { wip = commitAll(directory, 'meta-harness: unfinished work from a cancelled job'); }
+      catch (error) {
+        // Do not destroy edits if the WIP commit fails (for example, a credential file).
+        saved.push({ branch, directory, error: error.message });
+        continue;
+      }
+      if (wip || headCommit(directory) !== base) saved.push({ branch, wip, commit: headCommit(directory) });
+    }
     removeWorktree(cwd, directory);
-    if (branch) deleteBranch(cwd, branch);
+    if (branch && (!preserveChanges || !saved.some(item => item.branch === branch))) deleteBranch(cwd, branch);
   }
+  return saved;
 }

package/scaffold/.agent/skills/total-recall/plugins/meta-harness/ui/DESIGN.md

@@ -1,9 +1,9 @@
-# DESIGN.md — Meta Harness
+# DESIGN.md — Metaharness
 
 ```yaml
 tokens:
-  brand-name: "Meta Harness"
-  wordmark: "META HARNESS"
+  brand-name: "Metaharness"
+  wordmark: "METAHARNESS"
   color-primary: "#3b82f6"
   color-background: "#0c1427"
   color-surface: "#1e293b"
@@ -20,8 +20,8 @@ tokens:
 ```
 
 ## Brand & Typographic Wordmark
-- **Name**: Meta Harness
-- **Wordmark Logo**: `META HARNESS` (clean typographic badge, no invented cyber delimiters)
+- **Name**: Metaharness
+- **Wordmark Logo**: `METAHARNESS` (clean typographic badge, no invented cyber delimiters)
 - **Palette**: Primary `#3b82f6`, Surface `#0c1427`, Secondary Surface `#1e293b`, Accent `#38bdf8`, Line `#1e293b`, Text `#f1f5f9`.
 - **States**: Verified Pass `#10b981`, Warning `#f59e0b`, Danger `#ef4444`.
 

package/scaffold/.agent/skills/total-recall/plugins/meta-harness/ui/card.js

@@ -1,5 +1,5 @@
 /**
- * Meta Harness — Multi-Agent Coordination & Inspection Console
+ * Metaharness — Multi-Agent Coordination & Inspection Console
  *
  * Bespoke operator interface for terminal coding agent fleet management.
  * Displays real-time agent discovery matrix, mesh node targets, authentication
@@ -855,9 +855,9 @@ export class CommandFleetCard extends HTMLElement {
 
       <div class="header">
         <div class="brand-group">
-          <div class="wordmark-badge">META HARNESS</div>
+          <div class="wordmark-badge">METAHARNESS</div>
           <div class="title-meta">
-            <h3 class="plugin-title">Meta Harness Fleet</h3>
+            <h3 class="plugin-title">Metaharness Fleet</h3>
             <p class="plugin-subtitle">Multi-agent runtime coordination, quotas & benchmarks</p>
           </div>
         </div>

package/scaffold/.agent/skills/total-recall/plugins/openwiki/cli.mjs

@@ -16,6 +16,7 @@ import { getTokenStatus, setTokenValue } from './src/token.mjs';
 import { lintWikiHubs } from './src/lint.mjs';
 import { generateWiki } from './src/generate.mjs';
 import { retrieveContext } from './src/context-provider.mjs';
+import { refreshDiagnostics } from './src/refresh-diagnostics.mjs';
 
 /**
  * Regenerate the generated pages of every registered project that carries them.
@@ -25,7 +26,14 @@ import { retrieveContext } from './src/context-provider.mjs';
  * Defaults to a report; --apply performs the refreshes, because regenerating a
  * repository's documentation is a write to that repository.
  */
-async function refreshCommand(args) {
+export async function refreshCommand(args, {
+  read = readProjects, dueFor = isDue, refresh = refreshProjectAsync,
+  getKey = resolveKey, configFor = loadOpenWikiConfig,
+} = {}) {
+  if (args.includes('--help') || args.includes('-h')) {
+    console.log('Usage: total-recall openwiki refresh [--repo <name>] [--apply] [--force] [--diagnostics [--slot <local-minute>]] [--json]');
+    return;
+  }
   const json = args.includes('--json');
   const apply = args.includes('--apply');
   const force = args.includes('--force');
@@ -37,7 +45,7 @@ async function refreshCommand(args) {
 
   let projects;
   try {
-    projects = readProjects();
+    projects = read();
   } catch (err) {
     if (json) console.log(JSON.stringify({ ok: false, error: err.message }));
     else console.error(`OpenWiki refresh: ${err.message}`);
@@ -52,20 +60,28 @@ async function refreshCommand(args) {
     return;
   }
 
+  if (args.includes('--diagnostics')) {
+    const slotIndex = args.indexOf('--slot');
+    const result = await refreshDiagnostics({ projects, slot: slotIndex >= 0 ? args[slotIndex + 1] : null });
+    console.log(JSON.stringify(result, null, 2));
+    if (!result.ok) process.exitCode = 1;
+    return;
+  }
+
   const reports = [];
   for (const project of projects) {
     let state;
     try {
-      state = force ? { due: true, ...staleness(project.root) } : isDue(project);
+      state = dueFor(project, { force });
     } catch (err) {
-      reports.push({ ...project, action: 'skipped', reason: err.message });
+      reports.push({ ...project, action: 'failed', reason: err.message });
       continue;
     }
     if (!state.due) {
       if (state.skipped) {
         reports.push({ ...project, action: 'skipped', reason: state.reason });
       } else {
-        reports.push({ ...project, action: 'current', generatedAt: state.generatedAt, commitsSince: state.commitsSince });
+        reports.push({ ...project, action: 'current', reason: state.reason, generationCommit: state.generationCommit, generationTime: state.generationTime, generatedAt: state.generatedAt, commitsSince: state.commitsSince });
       }
       continue;
     }
@@ -73,7 +89,10 @@ async function refreshCommand(args) {
       ...project,
       action: 'due',
       uninitialized: Boolean(state.uninitialized),
+      mode: state.mode,
       generatedAt: state.generatedAt,
+      generationCommit: state.generationCommit,
+      generationTime: state.generationTime,
       commitsSince: state.commitsSince,
       reason: state.reason
     });
@@ -82,8 +101,8 @@ async function refreshCommand(args) {
   const due = reports.filter((r) => r.action === 'due');
   let payloadBudgetNote = null;
   if (apply && due.length) {
-    const config = loadOpenWikiConfig();
-    const { key, from } = resolveKey({ provider: config.provider });
+    const config = configFor();
+    const { key, from } = getKey({ provider: config.provider });
     if (!key) {
       const keyName = config.provider === 'google' ? 'GOOGLE_API_KEY' : 'OPENROUTER_API_KEY';
       const error = `No model credential for provider '${config.provider}'. Save via: total-recall auth secret set ${keyName} --stdin`;
@@ -109,20 +128,25 @@ async function refreshCommand(args) {
       while (queueIndex < due.length) {
         const itemIndex = queueIndex++;
         const entry = due[itemIndex];
-        const mode = entry.uninitialized ? 'init' : 'update';
+        const mode = entry.mode || (entry.uninitialized ? 'init' : 'update');
         if (!json) {
           console.log(`[${itemIndex + 1}/${due.length}] ▶ ${entry.name.padEnd(28)} starting ${mode}...`);
         }
-        const result = await refreshProjectAsync(
-          { name: entry.name, root: entry.root },
-          { key, model: config.model, provider: config.provider, timeoutMs: config.timeout_ms }
-        );
+        let result;
+        try {
+          result = await refresh(
+            { name: entry.name, root: entry.root },
+            { key, model: config.model, provider: config.provider, timeoutMs: config.timeout_ms }
+          );
+        } catch (error) {
+          result = { action: 'failed', reason: error.message.split(key).join('[REDACTED]') };
+        }
         completedCount++;
         const index = reports.findIndex((r) => r.root === entry.root);
         reports[index] = { ...reports[index], ...result, credential: from };
         if (!json) {
-          const duration = Math.round((Date.now() - (result.startedAt || Date.now())) / 1000);
-          const icon = result.action === 'failed' ? '✖' : '✔';
+          const duration = Math.round((result.durationMs || 0) / 1000);
+          const icon = ['failed', 'partial'].includes(result.action) ? '✖' : '✔';
           console.log(`[${completedCount}/${due.length}] ${icon} ${entry.name.padEnd(28)} ${result.action} (${duration}s)${result.reason ? ` — ${result.reason}` : ''}`);
         }
       }
@@ -133,8 +157,9 @@ async function refreshCommand(args) {
   }
 
   const failed = reports.filter((r) => r.action === 'failed');
+  const partial = reports.filter((r) => r.action === 'partial');
   const payload = {
-    ok: failed.length === 0,
+    ok: failed.length === 0 && partial.length === 0,
     applied: apply,
     retention: describeRetention(),
     note: payloadBudgetNote,
@@ -145,6 +170,8 @@ async function refreshCommand(args) {
       uninitialized: reports.filter((r) => r.uninitialized).length,
       refreshed: reports.filter((r) => r.action === 'refreshed' || r.action === 'initialized').length,
       failed: failed.length,
+      partial: partial.length,
+      skipped: reports.filter((r) => r.action === 'skipped').length,
       current: reports.filter((r) => r.action === 'current').length,
     },
     reports,
@@ -152,15 +179,17 @@ async function refreshCommand(args) {
   if (json) console.log(JSON.stringify(payload, null, 2));
   else {
     console.log(`OpenWiki refresh (${apply ? 'apply' : 'report'}): ${payload.counts.registered} registered, ${payload.counts.due} due (${payload.counts.uninitialized} uninitialized)`);
-    for (const r of reports) {
+    // Put failures last so bounded scheduler tails retain their causes.
+    for (const r of [...reports].sort((a, b) => Number(['failed', 'partial'].includes(a.action)) - Number(['failed', 'partial'].includes(b.action)))) {
       if (r.action === 'current') continue;
-      const age = r.uninitialized ? 'uninitialized' : (r.generatedAt ? `generated ${r.generatedAt.slice(0, 10)}` : 'never generated');
+      const age = r.action === 'skipped' ? 'outside repository generation' : r.generationTime ? `generated ${r.generationTime} at ${r.generationCommit}` : r.uninitialized ? 'uninitialized' : (r.generatedAt ? `last attempt ${r.generatedAt}; generation commit unknown` : 'never generated');
       console.log(`  ${r.action.padEnd(9)} ${r.name.padEnd(28)} ${age}${Number.isFinite(r.commitsSince) && r.commitsSince !== Infinity ? `, ${r.commitsSince} commits since` : ''}${r.reason ? ` — ${r.reason}` : ''}`);
     }
     if (payloadBudgetNote) console.log(payloadBudgetNote);
     if (!apply && due.length) console.log('Re-run with --apply to regenerate. Pages are a projection; vault content is never touched.');
   }
-  if (failed.length) process.exitCode = 1;
+  if (!payload.ok) process.exitCode = 1;
+  return payload;
 }
 
 async function probeCommand(args) {

package/scaffold/.agent/skills/total-recall/plugins/openwiki/package-lock.json

@@ -1,18 +1,18 @@
 {
   "name": "tr-plugin-openwiki",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "tr-plugin-openwiki",
-      "version": "0.1.9",
+      "version": "0.1.11",
       "license": "MIT",
       "dependencies": {
-        "@gregiteen/ssss-cli": "0.14.4"
+        "@gregiteen/ssss-cli": "0.14.5"
       },
       "devDependencies": {
-        "total-recall-brain": "3.42.1"
+        "total-recall-brain": "3.44.0"
       }
     },
     "node_modules/@alcalzone/ansi-tokenize": {
@@ -715,9 +715,9 @@
       "license": "MIT"
     },
     "node_modules/@gregiteen/ssss-cli": {
-      "version": "0.14.4",
-      "resolved": "https://registry.npmjs.org/@gregiteen/ssss-cli/-/ssss-cli-0.14.4.tgz",
-      "integrity": "sha512-R6JIgPRvS9xXp0xb6BYO3rauv+72r35GIiDrJcvbjPdTSHFZXr8/jRxFOgoF8yTed/5xyGFF3ey3DI9bOjmHVA==",
+      "version": "0.14.5",
+      "resolved": "https://registry.npmjs.org/@gregiteen/ssss-cli/-/ssss-cli-0.14.5.tgz",
+      "integrity": "sha512-qVEYOocnwn97uJ0eDzmuwN06CYsYWr2t3+iKylpisBHX4wlLWk7P8EmFFdBlx7NyKVIZDDeYT164Gd7/T8UGgw==",
       "license": "ISC",
       "bin": {
         "ssss": "scripts/ssss.mjs"
@@ -1590,9 +1590,9 @@
     },
     "node_modules/@ssss/cli": {
       "name": "@gregiteen/ssss-cli",
-      "version": "0.14.4",
-      "resolved": "https://registry.npmjs.org/@gregiteen/ssss-cli/-/ssss-cli-0.14.4.tgz",
-      "integrity": "sha512-R6JIgPRvS9xXp0xb6BYO3rauv+72r35GIiDrJcvbjPdTSHFZXr8/jRxFOgoF8yTed/5xyGFF3ey3DI9bOjmHVA==",
+      "version": "0.14.5",
+      "resolved": "https://registry.npmjs.org/@gregiteen/ssss-cli/-/ssss-cli-0.14.5.tgz",
+      "integrity": "sha512-qVEYOocnwn97uJ0eDzmuwN06CYsYWr2t3+iKylpisBHX4wlLWk7P8EmFFdBlx7NyKVIZDDeYT164Gd7/T8UGgw==",
       "dev": true,
       "license": "ISC",
       "bin": {
@@ -5529,9 +5529,9 @@
       }
     },
     "node_modules/total-recall-brain": {
-      "version": "3.42.1",
-      "resolved": "https://registry.npmjs.org/total-recall-brain/-/total-recall-brain-3.42.1.tgz",
-      "integrity": "sha512-woH7mdkGwPFYlKPZurhE8L3BPe+cSeIruNGaPOjGZJm/O8C92Bbr1gsdOY0tTLg5QHlgPHcXG1GMtsm9lPDz8w==",
+      "version": "3.44.0",
+      "resolved": "https://registry.npmjs.org/total-recall-brain/-/total-recall-brain-3.44.0.tgz",
+      "integrity": "sha512-VNPaIO9zsSwoxAsJ5ByIQBP9zPpLq4RiQO7Vrex4rBOHFQJT50P7utcZiLMSZTyZJU4C/m5uB8qTCSBMp6+l6Q==",
       "dev": true,
       "license": "MIT",
       "workspaces": [
@@ -5539,7 +5539,7 @@
       ],
       "dependencies": {
         "@simplewebauthn/server": "^13.3.2",
-        "@ssss/cli": "npm:@gregiteen/ssss-cli@0.14.4",
+        "@ssss/cli": "npm:@gregiteen/ssss-cli@0.14.5",
         "bcrypt": "^6.0.0",
         "better-sqlite3": "^12.11.1",
         "cookie-parser": "^1.4.7",
@@ -5562,6 +5562,7 @@
         "antigravity": "bin/antigravity.mjs",
         "total-recall": "bin/total-recall.mjs",
         "total-recall-memory": "bin/total-recall-memory.mjs",
+        "total-recall-server-release": "bin/total-recall-server-release.mjs",
         "vibebrain": "bin/total-recall.mjs"
       },
       "optionalDependencies": {

package/scaffold/.agent/skills/total-recall/plugins/openwiki/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tr-plugin-openwiki",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "type": "module",
   "description": "Multi-repo knowledge graph and documentation wiki engine for Total Recall",
   "scripts": {
@@ -20,9 +20,9 @@
     "templates/"
   ],
   "dependencies": {
-    "@gregiteen/ssss-cli": "0.14.4"
+    "@gregiteen/ssss-cli": "0.14.5"
   },
   "overrides": {
-    "@ssss/cli": "npm:@gregiteen/ssss-cli@0.14.4"
+    "@ssss/cli": "npm:@gregiteen/ssss-cli@0.14.5"
   }
 }

package/scaffold/.agent/skills/total-recall/plugins/openwiki/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://github.com/gregiteen/total-recall/blob/main/metadata.plugin.schema.json",
   "id": "openwiki",
   "name": "OpenWiki",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Multi-repo knowledge graph and documentation wiki engine for Total Recall.",
   "license": "MIT",
   "runtime": {

package/scaffold/.agent/skills/total-recall/plugins/openwiki/src/refresh-diagnostics.mjs

@@ -0,0 +1,44 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { readProjects } from './refresh.mjs';
+
+/** Read through Total Recall's event service. Never open vault files here. */
+async function readTaskEvents(options) {
+  const service = process.env.TR_PACKAGE_ROOT
+    ? pathToFileURL(path.join(process.env.TR_PACKAGE_ROOT, 'src', 'core', 'ssss-operation-service.mjs')).href
+    : 'total-recall-brain/src/core/ssss-operation-service.mjs';
+  const { listVfsEvents } = await import(service);
+  return listVfsEvents(options);
+}
+
+export async function refreshDiagnostics({
+  projects = readProjects(),
+  vaultRoot = path.join(os.homedir(), '.agent', 'skills', 'total-recall', 'memory-vault'),
+  listEvents = readTaskEvents,
+  slot = null,
+} = {}) {
+  let taskEvents = [], eventError = null;
+  try {
+    taskEvents = (await listEvents({ vaultRoot })).flatMap(event => {
+      let payload = event.payload || event.content;
+      if (typeof payload === 'string') {
+        try { payload = JSON.parse(payload); } catch { return []; }
+      }
+      return payload?.kind === 'plugin.task_run' && payload.plugin_id === 'openwiki' && payload.command === 'auto-refresh'
+        ? [{ at: event.timestamp || event.created_at || null, ...payload }] : [];
+    });
+  } catch (error) { eventError = error.message; }
+  taskEvents.sort((a, b) => String(a.at).localeCompare(String(b.at)));
+  taskEvents = slot ? taskEvents.filter(event => event.slot === slot) : taskEvents.slice(-1);
+  const reports = projects.map(project => {
+    const logPath = path.join(project.root, 'openwiki', '.refresh-attempt.json');
+    try { return { ...project, logPath, attempt: JSON.parse(fs.readFileSync(logPath, 'utf8')) }; }
+    catch (error) { return { ...project, logPath, attempt: null, logError: error.code === 'ENOENT' ? 'No retained generator output' : error.message }; }
+  });
+  return {
+    ok: !eventError, eventError, taskEvents, reports,
+    note: 'Task events retain only an output tail. Full legacy generator output was not saved; it cannot be reconstructed from that tail.',
+  };
+}