total-recall-brain 3.45.0 → 3.46.0

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.11",
+  "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.mjs

@@ -299,9 +299,12 @@ function finishRefresh(project, { before, result, git, key, mode, startedAt, via
   const completedAt = new Date(clock()).toISOString();
   const stdout = redact(result.stdout, key), stderr = redact(result.stderr, key);
   const error = redact(result.error?.message, key);
-  const lines = `${stderr}\n${stdout}`.replace(/\x1b\[[0-9;]*m/g, '').split('\n').map(line => line.trim()).filter(Boolean);
-  const diagnostic = lines.find(line => /context_length_exceeded|Provider returned error|exited without|Could not restore|interrupted OpenWiki|fetch failed/.test(line));
-  const reason = error || (result.signal ? `terminated by ${result.signal}` : diagnostic || lines.filter(line => !/^(\[ERR\]\s*)?Error Diagnostics$/.test(line)).at(-1) || `exit ${exitCode}`);
+  const clean = text => String(text || '').replace(/\x1b\[[0-9;]*m/g, '').split(/\r?\n/)
+    .map(line => line.trim().replace(/^\[ERR\]\s*/, '')).filter(line => line && line !== 'Error Diagnostics');
+  const errLines = clean(stderr), outLines = clean(stdout);
+  const diagnostic = [...errLines, ...outLines].find(line => /context_length_exceeded|Provider returned error|exited without|Could not restore|interrupted OpenWiki|fetch failed/.test(line));
+  // The generator's own first error line names the cause; a trailing "Status: 400" does not.
+  const reason = error || (result.signal ? `generator stopped by ${result.signal}` : diagnostic || errLines[0] || outLines.at(-1) || `exit ${exitCode}`);
   const wrote = pagesWritten(before, after) || (!before.files && hasWiki(project.root) ? 1 : 0);
   const advanced = after.generatedAt !== before.generatedAt;
   let action, failureReason;

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

@@ -36,11 +36,9 @@ export async function searchWikiHubs(query, {
 
   // If remote mesh node specified, dispatch via mesh
   if (node && node !== 'local' && node !== 'self') {
-    const escapedQuery = query.replace(/"/g, '\\"');
-    const meshRes = execOnMeshNode(
-      node,
-      `total-recall openwiki search "${escapedQuery}" ${allVaults ? '--all-vaults' : ''} --json`
-    );
+    const meshRes = execOnMeshNode(node, [
+      'search', query, ...(allVaults ? ['--all-vaults'] : []), '--limit', String(limit), '--json',
+    ]);
     if (meshRes.ok) {
       try {
         return JSON.parse(meshRes.stdout);

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

@@ -15,60 +15,34 @@ const PROVIDER_KEY_MAP = {
 /**
  * Checks token readiness across supported providers.
  */
-export function getTokenStatus() {
-  const result = spawnSync('total-recall', ['auth', 'secret', 'list', '--json'], {
+export function getTokenStatus({ run = spawnSync } = {}) {
+  const result = run('total-recall', ['auth', 'secret', 'list', '--json'], {
     encoding: 'utf8',
     timeout: 5000,
   });
 
-  const configured = {
-    openrouter: false,
-    google: false,
-  };
-
-  if (result.status === 0 && result.stdout) {
-    try {
-      const parsed = JSON.parse(result.stdout);
-      const keys = Array.isArray(parsed)
-        ? parsed.map((k) => (typeof k === 'string' ? k : k.key || k.name))
-        : (parsed.keys || []);
-
-      configured.openrouter = keys.includes('OPENROUTER_API_KEY') || Boolean(process.env.OPENROUTER_API_KEY);
-      configured.google = keys.includes('GOOGLE_API_KEY') || Boolean(process.env.GOOGLE_API_KEY);
-    } catch {
-      configured.openrouter = Boolean(process.env.OPENROUTER_API_KEY);
-      configured.google = Boolean(process.env.GOOGLE_API_KEY);
-    }
-  } else {
-    configured.openrouter = Boolean(process.env.OPENROUTER_API_KEY);
-    configured.google = Boolean(process.env.GOOGLE_API_KEY);
-  }
-
-  return {
-    ok: true,
-    tokens: {
-      openrouter: {
-        key: 'OPENROUTER_API_KEY',
-        configured: configured.openrouter,
-        status: configured.openrouter ? 'configured' : 'missing',
-      },
-      google: {
-        key: 'GOOGLE_API_KEY',
-        configured: configured.google,
-        status: configured.google ? 'configured' : 'missing',
-      },
-    },
-  };
+  if (result.status !== 0) throw new Error('Auth credential metadata is unavailable');
+  let payload;
+  try { payload = JSON.parse(result.stdout); }
+  catch { throw new Error('Auth credential metadata is invalid'); }
+  const rows = Array.isArray(payload) ? payload : payload?.keys;
+  if (!Array.isArray(rows)) throw new Error('Auth credential metadata is invalid');
+  const saved = new Set(rows.filter(row => row?.set !== false)
+    .map(row => typeof row === 'string' ? row : row?.key ?? row?.name));
+  const tokens = Object.fromEntries(Object.entries(PROVIDER_KEY_MAP).map(([provider, key]) => {
+    const configured = saved.has(key);
+    return [provider, { key, configured, status: configured ? 'configured' : 'missing' }];
+  }));
+  return { ok: true, tokens };
 }
 
 /**
  * Securely writes a token into Total Recall auth secrets store using --stdin.
  */
-export function setTokenValue(provider, secretValue) {
-  const keyName = PROVIDER_KEY_MAP[provider?.toLowerCase()] || provider;
-  if (!keyName) {
-    throw new Error(`Unsupported token provider '${provider}'. Allowed: openrouter, google`);
-  }
+export function setTokenValue(provider, secretValue, { run = spawnSync } = {}) {
+  const id = typeof provider === 'string' && provider.toLowerCase();
+  if (!Object.hasOwn(PROVIDER_KEY_MAP, id)) throw new Error('Supported token providers are openrouter and google');
+  const keyName = PROVIDER_KEY_MAP[id];
 
   if (!secretValue || typeof secretValue !== 'string' || !secretValue.trim()) {
     throw new Error(`Token value for ${keyName} must be a non-empty string`);
@@ -77,14 +51,14 @@ export function setTokenValue(provider, secretValue) {
   const trimmed = secretValue.trim();
 
   // Pipe into total-recall auth secret set <KEY> --stdin
-  const child = spawnSync('total-recall', ['auth', 'secret', 'set', keyName, '--stdin'], {
+  const child = run('total-recall', ['auth', 'secret', 'set', keyName, '--stdin'], {
     input: trimmed,
     encoding: 'utf8',
     timeout: 5000,
   });
 
   if (child.status !== 0) {
-    throw new Error(child.stderr || child.error?.message || `Failed to set ${keyName} in secrets store`);
+    throw new Error(`Auth could not save ${keyName}`);
   }
 
   return {

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

@@ -15,6 +15,15 @@ import { hasWiki, readProjects, refreshProject, resolveKey } from './refresh.mjs
 export const UPSTREAM_NPM_URL = 'https://registry.npmjs.org/openwiki/latest';
 export const UPSTREAM_GITHUB_URL = 'https://api.github.com/repos/langchain-ai/openwiki/releases/latest';
 
+export function bundledGeneratorVersion() {
+  try {
+    if (!fs.existsSync(new URL('../vendor/openwiki.mjs', import.meta.url))) return null;
+    const build = JSON.parse(fs.readFileSync(new URL('../vendor/build.json', import.meta.url), 'utf8'));
+    return typeof build.version === 'string' && /^\d+\.\d+\.\d+(?:[-+][a-zA-Z0-9.-]+)?$/.test(build.version)
+      ? build.version : null;
+  } catch { return null; }
+}
+
 /**
  * Resolves the path to the persistent upstream state file.
  * @param {string} [home] Home directory override
@@ -34,20 +43,21 @@ export function stateFile(home = os.homedir()) {
  * @returns {{ currentRecordedVersion: string, latestKnownVersion: string, lastCheckedAt: string | null, announcements: Array<object> }}
  */
 export function readUpstreamState({ statePath = stateFile() } = {}) {
+  const baseline = bundledGeneratorVersion() || '0.0.0';
   try {
     const raw = fs.readFileSync(statePath, 'utf8');
     const parsed = JSON.parse(raw);
     return {
-      currentRecordedVersion: typeof parsed.currentRecordedVersion === 'string' ? parsed.currentRecordedVersion : '0.7.2',
-      latestKnownVersion: typeof parsed.latestKnownVersion === 'string' ? parsed.latestKnownVersion : '0.7.2',
+      currentRecordedVersion: typeof parsed.currentRecordedVersion === 'string' ? parsed.currentRecordedVersion : baseline,
+      latestKnownVersion: typeof parsed.latestKnownVersion === 'string' ? parsed.latestKnownVersion : baseline,
       lastCheckedAt: typeof parsed.lastCheckedAt === 'string' ? parsed.lastCheckedAt : null,
       lastPropagatedAt: typeof parsed.lastPropagatedAt === 'string' ? parsed.lastPropagatedAt : null,
       announcements: Array.isArray(parsed.announcements) ? parsed.announcements : []
     };
   } catch {
     return {
-      currentRecordedVersion: '0.7.2',
-      latestKnownVersion: '0.7.2',
+      currentRecordedVersion: baseline,
+      latestKnownVersion: baseline,
       lastCheckedAt: null,
       lastPropagatedAt: null,
       announcements: []
@@ -62,13 +72,14 @@ export function readUpstreamState({ statePath = stateFile() } = {}) {
  * @param {string} [options.statePath] Custom state path
  */
 export function saveUpstreamState(state = {}, { statePath = stateFile() } = {}) {
+  const baseline = bundledGeneratorVersion() || '0.0.0';
   const dir = path.dirname(statePath);
   if (!fs.existsSync(dir)) {
     fs.mkdirSync(dir, { recursive: true });
   }
   const payload = {
-    currentRecordedVersion: state.currentRecordedVersion || '0.7.2',
-    latestKnownVersion: state.latestKnownVersion || '0.7.2',
+    currentRecordedVersion: state.currentRecordedVersion || baseline,
+    latestKnownVersion: state.latestKnownVersion || baseline,
     lastCheckedAt: state.lastCheckedAt || new Date().toISOString(),
     lastPropagatedAt: state.lastPropagatedAt || null,
     announcements: Array.isArray(state.announcements) ? state.announcements.slice(-20) : []

package/scaffold/.agent/skills/total-recall/plugins/openwiki/ui/chunks/auto-refresh.md

@@ -0,0 +1,18 @@
+---
+type: ui-chunk:chunk
+plugin: openwiki
+id: auto-refresh
+title: Scheduled wiki refresh
+description: Understand the daemon operation that applies regeneration to due registered repositories.
+timestamp: "2026-11-08T09:14:38Z"
+intents: [inspect scheduled wiki refresh, understand automatic regeneration, review daemon wiki refresh]
+surfaces: [page]
+operations: [auto-refresh]
+data: ["auto-refresh:/counts/current", "auto-refresh:/counts/refreshed"]
+---
+
+<section style="border-inline-start:3px solid var(--color-primary,#8d3e10);padding-inline-start:1rem">
+  <h2>Scheduled wiki refresh</h2>
+  <p><code>auto-refresh</code> is the daemon's applying operation. It checks the selected registered repositories and regenerates due pages.</p>
+  <p>Use <code>total-recall openwiki refresh --json</code> for an operator preview. Review the scheduled run receipt to see what the daemon refreshed.</p>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/openwiki/ui/chunks/bootstrap-pages.md

@@ -0,0 +1,18 @@
+---
+type: ui-chunk:chunk
+plugin: openwiki
+id: bootstrap-pages
+title: Seed missing wiki pages
+description: Preview which owner-provided pages would be created in an explicit brain or project.
+timestamp: "2026-11-08T09:14:38Z"
+intents: [bootstrap wiki pages, seed repository documentation, review missing starter pages]
+surfaces: [page]
+operations: [bootstrap]
+data: ["bootstrap:/files_planned", "bootstrap:/files_preserved"]
+---
+
+<section>
+  <h2>Seed missing wiki pages</h2>
+  <p>Choose an absolute brain path and, optionally, a project root. Run <code>total-recall openwiki bootstrap --brain &lt;path&gt; --dry-run --json</code> to see the planned pages.</p>
+  <p>Review the target paths before applying. The bootstrap receipt separates new pages from existing files that it preserved.</p>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/openwiki/ui/chunks/generate-wiki.md

@@ -0,0 +1,21 @@
+---
+type: ui-chunk:chunk
+plugin: openwiki
+id: generate-wiki
+title: Preview wiki generation
+description: Inspect the selected repository and output location before generating documentation.
+timestamp: "2026-11-08T09:14:38Z"
+intents: [preview wiki generation, generate repo documentation, inspect generation destination]
+surfaces: [page]
+operations: [generate]
+data: ["generate:/ok", "generate:/dryRun"]
+---
+
+<section>
+  <h2>Preview wiki generation</h2>
+  <ol>
+    <li>Run <code>total-recall openwiki generate --dry-run --json</code> for the current workspace, or select a registered repository with <code>--repo</code>.</li>
+    <li>Review the selected repository and wiki output directory.</li>
+    <li>Start generation after approving the target and configured provider.</li>
+  </ol>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/openwiki/ui/chunks/generator-settings.md

@@ -0,0 +1,18 @@
+---
+type: ui-chunk:chunk
+plugin: openwiki
+id: generator-settings
+title: Inspect generator configuration
+description: Review the configured provider, model routing, token bound and timeout.
+timestamp: "2026-11-08T09:14:38Z"
+intents: [inspect OpenWiki configuration, review generation limits, change wiki generator settings]
+surfaces: [page, right]
+operations: [config]
+data: ["config:/config/provider", "config:/config/max_tokens", "config:/config/timeout_ms"]
+---
+
+<section>
+  <h2>Inspect generator configuration</h2>
+  <p>Run <code>total-recall openwiki config show --json</code> to inspect the active provider, routing, token bound and timeout.</p>
+  <p>Use <code>config get</code> for an individual setting. An explicit <code>config set</code> changes the chosen setting for future generation.</p>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/openwiki/ui/chunks/host-probe.md

@@ -0,0 +1,18 @@
+---
+type: ui-chunk:chunk
+plugin: openwiki
+id: host-probe
+title: Probe the Total Recall host
+description: Check the configured host's health endpoint and observe response latency.
+timestamp: "2026-11-08T09:14:38Z"
+intents: [probe Total Recall host, inspect wiki host availability, check health response]
+surfaces: [page, right]
+operations: [probe]
+data: ["probe:/ok", "probe:/status", "probe:/latency_ms"]
+---
+
+<section>
+  <h2>Probe the Total Recall host</h2>
+  <p>Run <code>total-recall openwiki probe --json</code> to observe the HTTP status and response time for the configured host's health endpoint.</p>
+  <p>Use the wiki index or evidence search to check documentation coverage.</p>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/openwiki/ui/chunks/ingest-preview.md

@@ -0,0 +1,18 @@
+---
+type: ui-chunk:chunk
+plugin: openwiki
+id: ingest-preview
+title: Preview wiki ingestion
+description: Count pages selected for import into the requested Total Recall brain.
+timestamp: "2026-11-08T09:14:38Z"
+intents: [preview wiki ingest, import markdown into project brain, inspect wiki import receipt]
+surfaces: [page]
+operations: [ingest]
+data: ["ingest:/planned", "ingest:/imported", "ingest:/errors"]
+---
+
+<section>
+  <h2>Preview wiki ingestion</h2>
+  <p>Run <code>total-recall openwiki ingest &lt;directory&gt; --project --dry-run --json</code> to count pages planned for the project brain. Select <code>--global</code> only when the shared brain is the intended target.</p>
+  <p>After approving the target, run the import and review the completed and failed counts. Confirm indexed passages through Total Recall recall.</p>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/openwiki/ui/chunks/link-hygiene.md

@@ -0,0 +1,21 @@
+---
+type: ui-chunk:chunk
+plugin: openwiki
+id: link-hygiene
+title: Audit wiki link health
+description: Identify broken references and orphaned pages without rewriting Markdown.
+timestamp: "2026-11-08T09:14:38Z"
+intents: [lint wiki links, find broken markdown links, inspect orphaned wiki pages]
+surfaces: [page, right]
+operations: [lint]
+data: ["lint:/brokenLinksCount", "lint:/orphanCount"]
+---
+
+<section style="border-inline-start:3px solid var(--color-primary,#8d3e10);padding-inline-start:1rem">
+  <h2>Audit wiki link health</h2>
+  <dl>
+    <dt><strong>Broken links</strong></dt><dd>Check Markdown and wikilink targets.</dd>
+    <dt><strong>Orphaned pages</strong></dt><dd>Look for pages with neither incoming nor outgoing references.</dd>
+  </dl>
+  <p>Run <code>total-recall openwiki lint --json</code> and repair the reported files in their repository.</p>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/openwiki/ui/chunks/link-topology.md

@@ -0,0 +1,19 @@
+---
+type: ui-chunk:chunk
+plugin: openwiki
+id: link-topology
+title: Trace documentation links
+description: Inspect links and isolated pages in the wiki topology.
+timestamp: "2026-11-08T09:14:38Z"
+intents: [show wiki graph, trace page links, find unlinked documentation]
+surfaces: [page, right]
+operations: [graph]
+data: ["graph:/counts/nodes", "graph:/counts/edges", "graph:/counts/orphans", "graph:/scope"]
+panel: panel
+---
+
+<section style="border-block-start:1px solid var(--color-outline,#cbb497)">
+  <h2>Trace documentation links</h2>
+  <p>Set the evidence scope and select <strong>Inspect links</strong> to see the sources and destinations of resolved Markdown links and wikilinks.</p>
+  <p>Export topology through <code>total-recall openwiki graph --format mermaid</code> or <code>--format dot</code>.</p>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/openwiki/ui/chunks/passage-search.md

@@ -0,0 +1,19 @@
+---
+type: ui-chunk:chunk
+plugin: openwiki
+id: passage-search
+title: Search wiki passages
+description: Retrieve ranked wiki excerpts with source page and line references.
+timestamp: "2026-11-08T09:14:38Z"
+intents: [search wiki text, find documentation passage, find source line for a claim]
+surfaces: [page, right]
+operations: [search]
+data: ["search:/count", "search:/totalHits", "search:/totalHubsScanned", "search:/scope", "search:/results/0/repoName"]
+panel: panel
+---
+
+<section>
+  <h2>Search wiki passages</h2>
+  <p>Search a term or phrase in the atlas. Choose All registered wikis to broaden the search explicitly. The cross-project results include the repository, excerpt, section and line reference.</p>
+  <p>Use <code>total-recall openwiki search &lt;query&gt; --limit 8 --json</code> to retrieve the same evidence from a harness.</p>
+</section>