total-recall-brain 3.44.0 → 3.46.0

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

@@ -7,7 +7,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { runBootstrapCommand } from './src/bootstrap.mjs';
 import { describeRetention, hasWiki, isDue, readProjects, refreshProject, refreshProjectAsync, resolveKey, staleness } from './src/refresh.mjs';
-import { watchUpstream, propagateUpdates, readUpstreamState } from './src/upstream-watcher.mjs';
+import { watchUpstream, propagateUpdates, readUpstreamState, bundledGeneratorVersion } from './src/upstream-watcher.mjs';
 import { loadOpenWikiConfig, setOpenWikiConfigValue, resetOpenWikiConfig, resolveConfigPath, ALLOWED_CONFIG_KEYS, ALLOWED_PROVIDERS } from './src/config.mjs';
 import { discoverAllHubs } from './src/mesh-vaults.mjs';
 import { searchWikiHubs } from './src/search.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) {
@@ -316,22 +345,17 @@ async function tokenCommand(args) {
           const icon = t.configured ? '✔' : '✖';
           console.log(`  ${icon} ${provider.padEnd(12)} : ${t.key} (${t.status})`);
         }
-        console.log('\nTo set a token: total-recall openwiki token set <openrouter|google> <key>');
-        console.log('Or via stdin:  echo "$KEY" | total-recall openwiki token set <provider> --stdin\n');
+        console.log('\nTo set a token: total-recall openwiki token set <openrouter|google> --stdin\n');
       }
       return;
     }
 
     if (verb === 'set') {
-      const clean = args.filter((a) => !a.startsWith('--'));
-      const provider = clean[1];
-      let value = clean[2];
-      if (args.includes('--stdin')) {
-        value = fs.readFileSync(0, 'utf8').trim();
-      }
-      if (!provider || !value) {
-        throw new Error('Provider and secret value required: openwiki token set <provider> <value> (or --stdin)');
+      const [, provider, ...extra] = args.filter(arg => arg !== '--json' && arg !== '--stdin');
+      if (!args.includes('--stdin') || !provider || extra.length) {
+        throw new Error('Use openwiki token set <provider> --stdin with the credential on standard input');
       }
+      const value = fs.readFileSync(0, 'utf8');
       const res = setTokenValue(provider, value);
       if (json) console.log(JSON.stringify(res, null, 2));
       else console.log(`✔ ${res.message}`);
@@ -428,8 +452,14 @@ async function generateCommand(args) {
 import { runOpenWikiIngest } from "./src/ingest.mjs";
 
 async function ingestCommand(args) {
-  const result = await runOpenWikiIngest(args);
-  if (!result.ok) {
+  const json = args.includes('--json');
+  try {
+    const result = await runOpenWikiIngest(args);
+    if (json && !args.some(arg => arg === '--help' || arg === '-h')) console.log(JSON.stringify(result));
+    if (!result.ok) process.exitCode = 1;
+  } catch (error) {
+    if (json) console.log(JSON.stringify({ ok: false, error: error.message }));
+    else console.error(`OpenWiki ingest error: ${error.message}`);
     process.exitCode = 1;
   }
 }
@@ -646,6 +676,7 @@ export async function run(argv = process.argv) {
     const status = {
       plugin: "openwiki",
       implemented: Object.keys(IMPLEMENTED),
+      generatorVersion: bundledGeneratorVersion(),
       upstream: {
         recordedVersion: upstream.currentRecordedVersion,
         latestVersion: upstream.latestKnownVersion,
@@ -656,6 +687,7 @@ export async function run(argv = process.argv) {
     if (json) console.log(JSON.stringify(status, null, 2));
     else {
       console.log(`OpenWiki: implemented subcommands: ${status.implemented.join(", ")}`);
+      console.log(`Bundled generator: ${status.generatorVersion || 'unavailable'}`);
       console.log(`Upstream Status: recorded v${status.upstream.recordedVersion}, latest v${status.upstream.latestVersion}`);
     }
     return;
@@ -680,7 +712,7 @@ export async function run(argv = process.argv) {
                               Extract knowledge graph topology, nodes, and inter-hub links
     generate [--repo <name>] [--force] [--dry-run] [--node <node>] [--json]
                               Targeted on-demand documentation generation
-    token [status|set <provider> <value>] [--stdin] [--json]
+    token [status|set <provider> --stdin] [--json]
                               Check or securely configure Total Recall secrets store keys
     lint [--all-vaults] [--node <node>] [--json]
                               Validate link integrity, dead targets, and orphaned hubs

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

@@ -1,18 +1,18 @@
 {
   "name": "tr-plugin-openwiki",
-  "version": "0.1.10",
+  "version": "0.2.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "tr-plugin-openwiki",
-      "version": "0.1.10",
+      "version": "0.2.0",
       "license": "MIT",
       "dependencies": {
         "@gregiteen/ssss-cli": "0.14.5"
       },
       "devDependencies": {
-        "total-recall-brain": "3.43.3"
+        "total-recall-brain": "3.45.0"
       }
     },
     "node_modules/@alcalzone/ansi-tokenize": {
@@ -5529,9 +5529,9 @@
       }
     },
     "node_modules/total-recall-brain": {
-      "version": "3.43.3",
-      "resolved": "https://registry.npmjs.org/total-recall-brain/-/total-recall-brain-3.43.3.tgz",
-      "integrity": "sha512-yjfPN/BQxEEa+iodyFXQov/6fRt1pZg/7RcmgsbpALwBt6Ki3JJjT3tzArBC7NxHQmXgGYyKnCYId6xe/W2rPg==",
+      "version": "3.45.0",
+      "resolved": "https://registry.npmjs.org/total-recall-brain/-/total-recall-brain-3.45.0.tgz",
+      "integrity": "sha512-HDYfROazZbsLHQsFPnlBcSpe1HL1QEi7JG8x/eNRUI06RxVQsZWl8LwBo2lTWjWRDrKmCy7BUmSXQDuWF3lrEw==",
       "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",

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

@@ -1,6 +1,6 @@
 {
   "name": "tr-plugin-openwiki",
-  "version": "0.1.10",
+  "version": "0.2.0",
   "type": "module",
   "description": "Multi-repo knowledge graph and documentation wiki engine for Total Recall",
   "scripts": {
@@ -12,6 +12,7 @@
     "cli.mjs",
     "plugin.json",
     "README.md",
+    "DESIGN.md",
     "LICENSE",
     "ui/",
     "src/",

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.10",
+  "version": "0.2.0",
   "description": "Multi-repo knowledge graph and documentation wiki engine for Total Recall.",
   "license": "MIT",
   "runtime": {
@@ -41,29 +41,6 @@
       "required": false
     }
   ],
-  "card_face": {
-    "headline": "OpenWiki Control Deck",
-    "quick_actions": [
-      {
-        "subcommand": "status",
-        "label": "STATUS"
-      },
-      {
-        "subcommand": "hubs",
-        "label": "HUBS"
-      },
-      {
-        "subcommand": "ingest",
-        "label": "INGEST"
-      },
-      {
-        "subcommand": "probe",
-        "label": "200 PROBE"
-      }
-    ],
-    "touch_layout": "comfortable",
-    "interactive": true
-  },
   "ssss_schemas": {
     "categories": [
       {
@@ -233,6 +210,12 @@
             "flag": "--project",
             "label": "Target project brain",
             "type": "boolean"
+          },
+          {
+            "name": "json",
+            "flag": "--json",
+            "label": "JSON output",
+            "type": "boolean"
           }
         ]
       },
@@ -443,32 +426,15 @@
     ]
   },
   "ui": {
-    "design_tokens": "ui/DESIGN.md",
+    "home": "panel",
+    "design_tokens": "DESIGN.md",
     "elements": [
       {
         "id": "panel",
         "kind": "panel",
         "tag": "openwiki-panel",
         "module": "ui/panel.js",
-        "description": "OpenWiki panel",
-        "events": [
-          "save-token"
-        ],
-        "tokens": [
-          "color-text",
-          "color-surface",
-          "color-border",
-          "spacing-md",
-          "radius-md"
-        ],
-        "optional_tokens": []
-      },
-      {
-        "id": "card",
-        "kind": "card",
-        "tag": "tr-openwiki-card",
-        "module": "ui/card.js",
-        "description": "Knowledge Graph Card Face"
+        "description": "Workspace wiki atlas"
       }
     ]
   },

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

@@ -28,14 +28,15 @@ export async function generateWiki({
     const isSelf = selfNode && (selfNode.ip === node || selfNode.hostname.toLowerCase() === node.toLowerCase());
 
     if (!isSelf) {
-      const escapedRepo = repo ? `--repo="${repo}"` : '';
-      const cmd = `total-recall openwiki generate ${escapedRepo} ${force ? '--force' : ''} --json`;
-      const meshRes = execOnMeshNode(node, cmd);
+      const meshRes = execOnMeshNode(node, [
+        'generate', ...(repo ? [`--repo=${repo}`] : []), ...(force ? ['--force'] : []),
+        ...(dryRun ? ['--dry-run'] : []), '--json',
+      ]);
       if (meshRes.ok) {
         try {
           return JSON.parse(meshRes.stdout);
         } catch {
-          return { ok: true, node, output: meshRes.stdout };
+          throw new Error('Mesh generation returned invalid JSON');
         }
       } else {
         throw new Error(`Mesh generation failed on node ${node}: ${meshRes.stderr || meshRes.error}`);

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

@@ -19,10 +19,9 @@ export async function buildKnowledgeGraph({
 } = {}) {
   // If remote mesh node specified, dispatch via mesh
   if (node && node !== 'local' && node !== 'self') {
-    const meshRes = execOnMeshNode(
-      node,
-      `total-recall openwiki graph ${allVaults ? '--all-vaults' : ''} --format=${format} --json`
-    );
+    const meshRes = execOnMeshNode(node, [
+      'graph', ...(allVaults ? ['--all-vaults'] : []), '--format', format, '--json',
+    ]);
     if (meshRes.ok) {
       try {
         return JSON.parse(meshRes.stdout);

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

@@ -13,6 +13,7 @@ function printHelp() {
     --dry-run                 Preview import without writing
     --global                  Target the global brain
     --project                 Target the project brain (default)
+    --json                    Return a structured import receipt
     --help, -h                Show this help
   `);
 }
@@ -22,6 +23,9 @@ export async function runOpenWikiIngest(args = []) {
   let dryRun = false;
   let layerFlag = '--project';
   let help = false;
+  const json = args.includes('--json');
+  const log = message => { if (!json) console.log(message); };
+  const warn = message => { if (!json) console.error(message); };
 
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
@@ -37,20 +41,20 @@ export async function runOpenWikiIngest(args = []) {
     }
   }
 
-  if (help || !openwikiPath) {
+  if (help || (!json && !openwikiPath)) {
     printHelp();
     return { ok: true, imported: 0, errors: 0 };
   }
 
-  if (openwikiPath && !fs.existsSync(openwikiPath)) {
-    console.error(`Error: OpenWiki directory not found at ${openwikiPath}`);
-    process.exitCode = 1;
-    return { ok: false, error: `Directory not found: ${openwikiPath}` };
+  if (!openwikiPath || !fs.statSync(openwikiPath, { throwIfNoEntry: false })?.isDirectory()) {
+    const error = 'An existing OpenWiki directory is required';
+    warn(error);
+    return { ok: false, error };
   }
 
-  console.log(`\n  Importing OpenWiki from: ${openwikiPath}`);
-  console.log(`  Target Brain: ${layerFlag.replace('--', '')}`);
-  if (dryRun) console.log('  DRY RUN: No actual writes will be committed.\n');
+  log(`\n  Importing OpenWiki from: ${openwikiPath}`);
+  log(`  Target Brain: ${layerFlag.replace('--', '')}`);
+  if (dryRun) log('  DRY RUN: No actual writes will be committed.\n');
 
   const mdFiles = [];
   function scanDir(dir) {
@@ -69,6 +73,7 @@ export async function runOpenWikiIngest(args = []) {
   scanDir(openwikiPath);
 
   let imported = 0;
+  let planned = 0;
   let errors = 0;
 
   for (const file of mdFiles) {
@@ -85,8 +90,8 @@ export async function runOpenWikiIngest(args = []) {
       const slug = 'openwiki-' + slugBase.toLowerCase();
 
       if (dryRun) {
-        console.log(`  [DRY RUN] Would import: ${slug} ("${title}")`);
-        imported++;
+        log(`  [DRY RUN] Would import: ${slug} ("${title}")`);
+        planned++;
         continue;
       }
 
@@ -101,27 +106,27 @@ export async function runOpenWikiIngest(args = []) {
 
       const result = spawnSync(TR_BIN, cliArgs, { encoding: 'utf8' });
       if (result.status === 0) {
-        console.log(`  Imported: ${slug}`);
+        log(`  Imported: ${slug}`);
         imported++;
       } else {
-        console.error(`  Error importing ${slug}: ${result.stderr}`);
+        warn(`  Error importing ${slug}: ${result.stderr}`);
         errors++;
       }
     } catch (err) {
-      console.error(`  Exception on ${file}: ${err.message}`);
+      warn(`  Exception on ${file}: ${err.message}`);
       errors++;
     }
   }
 
-  console.log(`\n  Import Summary:`);
-  console.log(`  Imported: ${imported} files`);
-  console.log(`  Errors:   ${errors} files`);
+  log('\n  Import Summary:');
+  log(dryRun ? `  Would import: ${planned} files` : `  Imported: ${imported} files`);
+  log(`  Errors:   ${errors} files`);
 
   if (!dryRun && imported > 0) {
-    console.log(`\n  OpenWiki knowledge graph successfully indexed into Total Recall.`);
+    log('\n  OpenWiki knowledge graph successfully indexed into Total Recall.');
   }
 
-  return { ok: errors === 0, imported, errors };
+  return { ok: errors === 0, dryRun, imported, planned, errors };
 }
 
 export default runOpenWikiIngest;

package/scaffold/.agent/skills/total-recall/plugins/openwiki/src/mesh-vaults.mjs

@@ -102,7 +102,7 @@ export function getMeshNodes() {
  * Execute a command on a remote mesh node via Total Recall mesh plugin.
  * Guarded against self-execution (never ssh a machine into itself).
  */
-export function execOnMeshNode(nodeTarget, commandStr, { timeoutMs = 25000 } = {}) {
+export function execOnMeshNode(nodeTarget, args, { timeoutMs = 25000 } = {}) {
   if (!nodeTarget || typeof nodeTarget !== 'string') {
     throw new Error('A valid mesh node identifier or IP is required');
   }
@@ -117,7 +117,12 @@ export function execOnMeshNode(nodeTarget, commandStr, { timeoutMs = 25000 } = {
     throw new Error(`Target node '${nodeTarget}' is the local host. Do not mesh exec into self.`);
   }
 
-  const result = spawnSync('total-recall', ['mesh', 'exec', nodeTarget, commandStr], {
+  if (!Array.isArray(args) || args.some(arg => typeof arg !== 'string')) {
+    throw new Error('Mesh operation requires OpenWiki CLI arguments');
+  }
+  const quote = arg => "'" + arg.replaceAll("'", "'\\''") + "'";
+  const command = ['total-recall', 'openwiki', ...args].map(quote).join(' ');
+  const result = spawnSync('total-recall', ['mesh', 'exec', nodeTarget, command], {
     encoding: 'utf8',
     timeout: timeoutMs,
   });
@@ -203,7 +208,7 @@ export async function discoverAllHubs({
     const isSelf = selfNode && (selfNode.ip === node || selfNode.hostname.toLowerCase() === node.toLowerCase());
 
     if (!isSelf) {
-      const meshRes = execOnMeshNode(node, `total-recall openwiki hubs ${allVaults ? '--all-vaults' : ''} --json`);
+      const meshRes = execOnMeshNode(node, ['hubs', ...(allVaults ? ['--all-vaults'] : []), '--json']);
       if (meshRes.ok) {
         try {
           const parsed = JSON.parse(meshRes.stdout);

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.',
+  };
+}