total-recall-brain 3.45.0 → 3.46.0

package/scaffold/.agent/skills/total-recall/plugins/meta-harness/ui/chunks/fleet-maintenance.md

@@ -0,0 +1,21 @@
+---
+type: ui-chunk:chunk
+plugin: meta-harness
+id: fleet-maintenance
+title: Maintain the harness registry
+description: Review upstream versions, register supported adapters and explicitly maintain integrations.
+timestamp: "2026-11-08T09:34:00Z"
+intents: [check harness updates, inspect changelog, configure a custom harness, maintain fleet integrations]
+surfaces: [page]
+operations: [upstream, changelog, adapter, setup, maintenance]
+data: ["adapter:/active/0/id"]
+---
+
+<section>
+  <h2>Maintain the harness registry</h2>
+  <dl>
+    <dt><strong>Release evidence</strong></dt><dd>Check <code>upstream</code> and request <code>changelog</code> where an adapter supports it.</dd>
+    <dt><strong>Adapter declarations</strong></dt><dd>Inspect the active registry with <code>adapter list</code>. Register a reviewed definition through the same owner command.</dd>
+    <dt><strong>Integration work</strong></dt><dd>Choose a host before using <code>setup</code> or <code>maintenance</code> and review the resulting receipts.</dd>
+  </dl>
+</section>

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

@@ -0,0 +1,21 @@
+---
+type: ui-chunk:chunk
+plugin: meta-harness
+id: harness-inventory
+title: Inspect harness availability
+description: Compare registered adapters, selected nodes, observed installations and adoption evidence.
+timestamp: "2026-11-08T09:34:00Z"
+intents: [inspect harness inventory, check local agents, compare mesh harness availability, verify managed adoption]
+surfaces: [page, right]
+operations: [catalog, status, nodes, inspect, adoption]
+data: ["catalog:/permissions"]
+---
+
+<section style="border-inline-start:2px solid var(--color-signal,#38bdf8);padding-inline-start:1rem">
+  <h2>Inspect harness availability</h2>
+  <dl>
+    <dt><strong>Registry</strong></dt><dd><code>catalog</code> lists the configured adapters and supported command effects.</dd>
+    <dt><strong>Selected host</strong></dt><dd><code>nodes</code> lists execution targets. Use <code>inspect</code> or <code>status</code> for observed binary and login state on a specific node.</dd>
+    <dt><strong>Managed adoption</strong></dt><dd><code>adoption</code> brings native gate activity and actual managed run receipts together.</dd>
+  </dl>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/meta-harness/ui/chunks/included-access.md

@@ -0,0 +1,18 @@
+---
+type: ui-chunk:chunk
+plugin: meta-harness
+id: included-access
+title: Inspect included access
+description: Review the saved usage policy and the separate approval paths for provider bindings.
+timestamp: "2026-11-08T09:34:00Z"
+intents: [check included usage policy, inspect harness billing bindings, verify approved connector access]
+surfaces: [page, right]
+operations: [included-status, included-enforce, included-bind-claude, included-bind-claude-plan, openrouter-bind]
+data: ["included-status:/enabled", "included-status:/policyVersion"]
+---
+
+<section>
+  <h2>Inspect included access</h2>
+  <p>Read <code>included-status</code> to check the saved policy. The policy distinguishes included subscription access from approved provider bindings.</p>
+  <p>Use the owning CLI for an explicit enforcement or binding change. Validate billing evidence and use the Auth store for credential references.</p>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/meta-harness/ui/chunks/included-usage-verification.md

@@ -0,0 +1,15 @@
+---
+type: ui-chunk:chunk
+plugin: meta-harness
+id: included-usage-verification
+title: Verify included harness access before dispatch
+description: Read the registered adapters and included-usage status to check whether a proposed harness may run under existing access.
+timestamp: "2026-11-08T23:12:00Z"
+intents: [verify included access before dispatch, find harnesses covered by current access, distinguish subscription use from provider spend]
+surfaces: [page]
+operations: [catalog, included-status, quota]
+---
+<section>
+  <h2>Check which harness can run under existing access</h2>
+  <ol><li>Identify the intended adapter in the harness catalog.</li><li>Read included usage and quota for that adapter.</li><li>Queue or reroute when the permitted adapter is unavailable.</li></ol>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/meta-harness/ui/chunks/independent-review.md

@@ -0,0 +1,17 @@
+---
+type: ui-chunk:chunk
+plugin: meta-harness
+id: independent-review
+title: Review a real change
+description: Select the target diff and known author for an independent Metaharness review.
+timestamp: "2026-11-08T09:34:00Z"
+intents: [run independent code review, review a diff, attach review evidence to a thread]
+surfaces: [page]
+operations: [review]
+---
+
+<section style="border-block-start:1px solid var(--color-line,#334155)">
+  <h2>Review a real change</h2>
+  <p>Select a diff, staged changes or a supported review target. Supply the known author and use the owner’s independent reviewer selection.</p>
+  <p>Attach the resulting receipt to its work thread when one is available. Read the verdict and any findings with their source locations.</p>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/meta-harness/ui/chunks/managed-execution.md

@@ -0,0 +1,20 @@
+---
+type: ui-chunk:chunk
+plugin: meta-harness
+id: managed-execution
+title: Prepare managed execution
+description: Choose a harness, node, workspace and allowed effects before running a managed command.
+timestamp: "2026-11-08T09:34:00Z"
+intents: [run a plugin command through a harness, dispatch a managed task, maintain an agent runtime]
+surfaces: [page]
+operations: [run-command, runtime, dispatch]
+---
+
+<section>
+  <h2>Prepare managed execution</h2>
+  <ol>
+    <li>Choose a verified node and its absolute workspace.</li>
+    <li>Use <code>run-command</code> for a declared plugin operation, <code>dispatch</code> for a task request, or <code>runtime</code> for an allowed maintenance action.</li>
+    <li>Submit the approved request through the owner. Read the returned exit status and native tool evidence before treating the task as finished.</li>
+  </ol>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/meta-harness/ui/chunks/official-documentation.md

@@ -0,0 +1,18 @@
+---
+type: ui-chunk:chunk
+plugin: meta-harness
+id: official-documentation
+title: Read verified harness documentation
+description: Find approved sources and inspect cached documentation integrity and freshness.
+timestamp: "2026-11-08T09:34:00Z"
+intents: [find harness documentation, search official command docs, inspect documentation cache freshness]
+surfaces: [page, right]
+operations: [docs-status, docs-sources, docs-read, docs-search, docs-refresh, docs-ensure]
+data: ["docs-status:/ok", "docs-sources:/sources"]
+---
+
+<article>
+  <h2>Read verified harness documentation</h2>
+  <p>Start with <code>docs-sources</code> for the approved official sources. Use <code>docs-status</code> to check the local copy, then <code>docs-search</code> and <code>docs-read</code> to locate the relevant section.</p>
+  <p>Use <code>docs-ensure</code> to refresh missing or stale pages, or <code>docs-refresh</code> to request a refresh. Verify the result through the cache status.</p>
+</article>

package/scaffold/.agent/skills/total-recall/plugins/meta-harness/ui/chunks/quota-recovery.md

@@ -0,0 +1,21 @@
+---
+type: ui-chunk:chunk
+plugin: meta-harness
+id: quota-recovery
+title: Inspect queued work and quota
+description: Review observed usage and decide whether to retry or cancel a queued job.
+timestamp: "2026-11-08T09:34:00Z"
+intents: [show quota wait queue, inspect harness limits, retry after quota resets, cancel queued job]
+surfaces: [page, right]
+operations: [quota, usage-queue, usage-retry, usage-cancel]
+data: ["usage-queue:/ok"]
+---
+
+<section>
+  <h2>Inspect queued work and quota</h2>
+  <ol>
+    <li>Use <code>quota</code> for observed limits on the selected host.</li>
+    <li>Use <code>usage-queue</code> to find jobs waiting for included capacity.</li>
+    <li>After reviewing the selected job, use <code>usage-retry</code> for an explicit retry or <code>usage-cancel</code> to stop waiting.</li>
+  </ol>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/meta-harness/ui/chunks/review-routing-decision.md

@@ -0,0 +1,16 @@
+---
+type: ui-chunk:chunk
+plugin: meta-harness
+id: review-routing-decision
+title: Explain why a harness was selected
+description: Review the selected adapter, classifier source and surrounding routing evidence before committing a managed run.
+timestamp: "2026-11-08T23:12:00Z"
+intents: [explain a harness routing choice, review selected adapter before execution, compare route evidence with task needs]
+surfaces: [page]
+operations: [route, benchmarks, learn]
+data: ["route:/selected", "route:/classifier/source", "benchmarks:/synced", "learn:/totalHistoryRuns"]
+---
+<section>
+  <h2>Review the route decision</h2>
+  <p>Compare the chosen adapter with the classifier source and available history. A route receipt records the decision. Inspect run evidence separately after execution.</p>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/meta-harness/ui/chunks/route-work.md

@@ -0,0 +1,18 @@
+---
+type: ui-chunk:chunk
+plugin: meta-harness
+id: route-work
+title: Preview task routing
+description: Compare harness choice and workflow stages before approving managed execution.
+timestamp: "2026-11-08T09:34:00Z"
+intents: [preview harness route, decompose a task, plan a coordinated run, inspect selected harness]
+surfaces: [page]
+operations: [route, decompose, coordinate, orchestrate]
+data: ["route:/selected", "route:/classifier/source"]
+---
+
+<section>
+  <h2>Preview task routing</h2>
+  <p><code>route</code> explains the selected harness and classification source. <code>decompose</code> lays out the work stages.</p>
+  <p>Use <code>coordinate</code> or <code>orchestrate</code> to inspect the roles and candidate assignments. Add <code>--execute</code> only after approving the plan, workspace and gates.</p>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/meta-harness/ui/chunks/routing-evidence.md

@@ -0,0 +1,18 @@
+---
+type: ui-chunk:chunk
+plugin: meta-harness
+id: routing-evidence
+title: Review routing evidence
+description: Compare sourced benchmark metadata with observed local run history and alert outcomes.
+timestamp: "2026-11-08T09:34:00Z"
+intents: [review harness benchmarks, inspect routing scorecard, check quota alerts, inspect run history]
+surfaces: [page, right]
+operations: [benchmarks, learn, alerts]
+data: ["benchmarks:/synced", "learn:/totalHistoryRuns"]
+---
+
+<section style="border-inline-start:2px solid var(--color-signal,#38bdf8);padding-inline-start:1rem">
+  <h2>Review routing evidence</h2>
+  <p><code>benchmarks</code> separates sourced figures from the pass rates measured on this machine. <code>learn</code> summarizes the managed run receipts and identifies recurring limits.</p>
+  <p>Use <code>alerts</code> for an explicit check of the operator alert path. Review delivery evidence through the owning alert plugin.</p>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/meta-harness/ui/chunks/run-ledger.md

@@ -0,0 +1,18 @@
+---
+type: ui-chunk:chunk
+plugin: meta-harness
+id: run-ledger
+title: Follow managed work
+description: Inspect work threads and track Metaharness-owned processes using recorded identities.
+timestamp: "2026-11-08T09:34:00Z"
+intents: [inspect managed process, follow a work thread, find a run receipt, check agent progress]
+surfaces: [page, right]
+operations: [threads, process]
+data: ["process:/ok"]
+---
+
+<section>
+  <h2>Follow managed work</h2>
+  <p>Use <code>threads list</code> to find tracked work. Use <code>process list</code> to find Metaharness-owned processes and select a run by its recorded ID.</p>
+  <p>Inspect the selected process status or log in the owner. Keep the run receipt with the relevant work thread.</p>
+</section>

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

@@ -0,0 +1,198 @@
+const template = document.createElement('template');
+template.innerHTML = `
+  <style>
+    :host {
+      display: block;
+      color: var(--color-text, #f1f5f9);
+      font: 14px/1.5 var(--typography-body-font-family, system-ui, sans-serif);
+    }
+    * { box-sizing: border-box; }
+    .home {
+      background: var(--color-canvas, #0c1427);
+      border: 1px solid var(--color-line, #334155);
+      border-radius: var(--radius-frame, 8px);
+      padding: var(--spacing-inset, 16px);
+    }
+    header, .actions {
+      display: flex;
+      justify-content: space-between;
+      align-items: start;
+      flex-wrap: wrap;
+      gap: var(--spacing-row, 12px);
+    }
+    h2 {
+      font-size: var(--typography-title-font-size, 18px);
+      font-weight: var(--typography-title-font-weight, 650);
+      margin: 0;
+    }
+    p { margin: 0.25rem 0; }
+    .route {
+      margin-block: var(--spacing-row, 12px);
+      border-inline-start: 2px solid var(--color-signal, #38bdf8);
+      background: var(--color-surface, #1e293b);
+      padding: 0.6rem 0.75rem;
+    }
+    .label {
+      color: var(--color-signal, #38bdf8);
+      font: 600 11px/1.4 var(--typography-label-font-family, ui-monospace, monospace);
+      letter-spacing: 0.08em;
+      text-transform: uppercase;
+    }
+    .subtle { color: var(--color-muted, #94a3b8); }
+    [data-error] { color: var(--color-danger, #ef4444); }
+    .fields {
+      display: grid;
+      grid-template-columns: minmax(0, 1fr) minmax(0, 1.5fr);
+      gap: var(--spacing-row, 12px);
+    }
+    label { display: block; font-weight: 600; }
+    input, select, button {
+      background: var(--color-surface, #1e293b);
+      border: 1px solid var(--color-line, #334155);
+      border-radius: var(--radius-frame, 8px);
+      color: inherit;
+      font: inherit;
+      min-height: 44px;
+      padding: 0.4rem 0.7rem;
+    }
+    input, select { width: 100%; min-width: 0; margin-top: 0.3rem; }
+    button { cursor: pointer; }
+    button:disabled { cursor: default; opacity: 0.55; }
+    button:focus-visible, input:focus-visible, select:focus-visible {
+      outline: 2px solid var(--color-signal, #38bdf8);
+      outline-offset: 2px;
+    }
+    .actions { align-items: center; margin-top: var(--spacing-row, 12px); }
+    #save { border-color: var(--color-signal, #38bdf8); }
+    @media (max-width: 530px) { .fields { grid-template-columns: 1fr; } }
+  </style>
+  <section class="home" aria-labelledby="default-title">
+    <header>
+      <div>
+        <h2 id="default-title">Default Chat harness</h2>
+        <p class="subtle">Use this destination with any brain selection in the Chat drawer.</p>
+      </div>
+      <button type="button" id="refresh">Reload settings</button>
+    </header>
+    <div class="route" aria-live="polite">
+      <div class="label">Saved handoff</div>
+      <strong id="saved">Reading Chat settings…</strong>
+      <p class="subtle" id="mode"></p>
+    </div>
+    <div class="fields">
+      <label>Registered harness
+        <select id="adapter" disabled><option value="">Choose a harness</option></select>
+      </label>
+      <label>Optional launch URL
+        <input id="url" type="text" inputmode="url" autocomplete="off" maxlength="2048" disabled>
+      </label>
+    </div>
+    <p class="subtle">Use a trusted HTTPS page or a supported native Chat link.</p>
+    <div class="actions">
+      <p id="notice" class="subtle" role="status"></p>
+      <button type="button" id="save" disabled>Save default</button>
+    </div>
+  </section>
+`;
+
+const adapterId = /^[a-z][a-z0-9-]{0,63}$/;
+const nativeDraft = /^codex:\/\/threads\/new(?:\?|$)/;
+
+class MetaharnessHome extends HTMLElement {
+  #target = null;
+  #working = false;
+
+  constructor() {
+    super();
+    this.attachShadow({ mode: 'open' }).append(template.content.cloneNode(true));
+    this.#field('refresh').addEventListener('click', () => void this.load());
+    this.#field('save').addEventListener('click', () => void this.#save());
+    this.#field('adapter').addEventListener('change', () => {
+      this.#fillUrl();
+      this.#syncControls();
+    });
+  }
+
+  #field(id) {
+    return this.shadowRoot.getElementById(id);
+  }
+
+  #notice(text, error = false) {
+    const notice = this.#field('notice');
+    notice.textContent = text;
+    notice.toggleAttribute('data-error', error);
+  }
+
+  #syncControls() {
+    const adapter = this.#field('adapter');
+    const locked = this.#working || !this.#target;
+    adapter.disabled = locked;
+    this.#field('url').disabled = locked || !adapter.value;
+    this.#field('save').disabled = locked || !adapter.value;
+    this.#field('refresh').disabled = this.#working;
+  }
+
+  #fillUrl() {
+    const { harness, href } = this.#target || {};
+    this.#field('url').value = harness?.id === this.#field('adapter').value && typeof href === 'string' && !nativeDraft.test(href)
+      ? href : '';
+  }
+
+  #showTarget(target) {
+    if (target?.ok !== true || typeof target.configured !== 'boolean' || !Array.isArray(target.choices)) throw new Error('Invalid Chat target');
+    const choices = target.choices.filter(choice => typeof choice?.id === 'string' &&
+      adapterId.test(choice.id) && typeof choice.name === 'string');
+    const selected = choices.find(choice => choice.id === target.harness?.id);
+    if (target.configured && !selected) throw new Error('Invalid saved Chat adapter');
+    this.#target = { choices, harness: selected, href: target.href };
+    const picker = this.#field('adapter');
+    picker.replaceChildren(new Option('Choose a harness', ''), ...choices.map(choice => new Option(choice.name, choice.id)));
+    picker.value = selected?.id || '';
+    this.#fillUrl();
+    this.#field('saved').textContent = selected?.name || 'Choose a default harness';
+    this.#field('mode').textContent = !selected
+      ? target.warning || `${choices.length} registered harnesses`
+      : nativeDraft.test(target.href) ? 'Opens a reviewable native draft'
+        : target.href ? 'Opens the saved destination' : 'Copy context from the Chat drawer';
+  }
+
+  async load() {
+    if (this.#working) return;
+    this.#working = true;
+    this.#syncControls();
+    this.#notice('Reading Chat settings…');
+    try {
+      this.#showTarget(await this.host.run('chat-target'));
+      this.#notice('');
+    } catch {
+      this.#target = null;
+      this.#field('saved').textContent = 'Chat settings unavailable';
+      this.#field('mode').textContent = '';
+      this.#notice('Reload to try the owner read again.', true);
+    } finally {
+      this.#working = false;
+      this.#syncControls();
+    }
+  }
+
+  async #save() {
+    const id = this.#field('adapter').value;
+    if (this.#working || !this.#target?.choices.some(choice => choice.id === id)) return;
+    const url = this.#field('url').value.trim();
+    this.#working = true;
+    this.#syncControls();
+    this.#notice('Saving Chat default…');
+    try {
+      const target = await this.host.run('chat-default', [id, ...(url ? ['--url', url] : [])]);
+      this.#showTarget(target);
+      this.#notice('Chat default saved.');
+    } catch {
+      this.#notice('Could not save the default. Check the harness and launch URL.', true);
+    } finally {
+      this.#working = false;
+      this.#syncControls();
+    }
+  }
+}
+
+if (!customElements.get('tr-metaharness-home')) customElements.define('tr-metaharness-home', MetaharnessHome);

package/scaffold/.agent/skills/total-recall/plugins/openwiki/DESIGN.md

@@ -0,0 +1,75 @@
+---
+name: OpenWiki
+description: A warm reference atlas for repository documentation, evidence, and links.
+colors:
+  background: "#f9f1e3"
+  surface: "#fff9ee"
+  text: "#302519"
+  muted: "#6d5741"
+  outline: "#cbb497"
+  primary: "#8d3e10"
+  on-primary: "#fff9ee"
+  error: "#9b2a20"
+typography:
+  heading:
+    fontFamily: "Newsreader, Georgia, serif"
+    fontWeight: 600
+    fontSize: 1.8rem
+  body:
+    fontFamily: "DM Sans, system-ui, sans-serif"
+    fontSize: 1rem
+    lineHeight: 1.55
+  source:
+    fontFamily: "DM Mono, ui-monospace, monospace"
+    fontSize: 0.8rem
+    lineHeight: 1.5
+spacing:
+  sm: 0.65rem
+  md: 1rem
+  lg: 1.5rem
+rounded:
+  panel: 0.45rem
+  control: 0.3rem
+components:
+  atlas-intro:
+    backgroundColor: "{colors.surface}"
+    borderColor: "{colors.outline}"
+    borderWidth: 1px
+    borderStyle: solid
+    padding: "{spacing.md}"
+    rounded: "{rounded.panel}"
+---
+
+# OpenWiki
+
+## Overview
+
+OpenWiki should read like a maintained reference atlas. The index establishes which pages exist. Search moves directly to evidence with its source. The topology shows how those pages refer to one another. Repository maintenance belongs in separate blocks.
+
+## Colors
+
+Warm ivory is the background and pale cream holds content. Brown-black carries the text. Burnt orange marks active controls and relationships. Use red for a failed read and accompany it with a message.
+
+## Typography
+
+Use Newsreader for headings, DM Sans for body text, and DM Mono for paths and version labels. Give quotations space to wrap. Keep source lines beside their passages.
+
+## Layout
+
+Give search the full width, then place the page index beside the link topology. Stack these regions at narrow widths. Let file names and section labels wrap without obscuring line numbers.
+
+## Elevation & Depth
+
+Use hairline rules between index entries. A lightly contrasting reading surface is enough to separate passages from metadata.
+
+## Shapes
+
+Use restrained corners on the atlas and controls. Show links as direct relationships between page labels.
+
+## Components
+
+The atlas introduction carries the `atlas-intro` tokens. The native panel holds recorded upstream status, workspace evidence search, a page list, and the live link topology. Each independent block explains one operator workflow.
+
+## Do's and Don'ts
+
+Use explicit search, refresh, and topology controls with visible focus and at least 44 pixels of target height. Keep motion still. Distinguish an empty read from a failed one, and show recorded versions with their freshness. Keep generated documentation, provider checks, and credential entry outside the Home load.

package/scaffold/.agent/skills/total-recall/plugins/openwiki/README.md

@@ -30,6 +30,8 @@ total-recall openwiki bootstrap --brain /absolute/path/to/brain \
 - **CLI Command**: `npx total-recall openwiki`
 - **UI**: `ui/panel.js` custom element with DESIGN.md tokens
 
+Open **OpenWiki** from the dashboard's Plugins folder to search workspace passages, browse indexed Markdown pages, and inspect the links between them. The atlas reads local wiki files and recorded upstream status. Customize its theme in the root `DESIGN.md`. The 16 owner blocks in `ui/chunks/` can be composed into pages or drawers. Use Settings for write-only credential entry or run `total-recall openwiki token set <provider> --stdin` in the terminal.
+
 ## Use it two ways
 
 This plugin is a reusable brick, so a new project does not start from zero.

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';
@@ -345,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}`);
@@ -457,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;
   }
 }
@@ -675,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,
@@ -685,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;
@@ -709,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.11",
+  "version": "0.2.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "tr-plugin-openwiki",
-      "version": "0.1.11",
+      "version": "0.2.0",
       "license": "MIT",
       "dependencies": {
         "@gregiteen/ssss-cli": "0.14.5"
       },
       "devDependencies": {
-        "total-recall-brain": "3.44.0"
+        "total-recall-brain": "3.45.0"
       }
     },
     "node_modules/@alcalzone/ansi-tokenize": {
@@ -5529,9 +5529,9 @@
       }
     },
     "node_modules/total-recall-brain": {
-      "version": "3.44.0",
-      "resolved": "https://registry.npmjs.org/total-recall-brain/-/total-recall-brain-3.44.0.tgz",
-      "integrity": "sha512-VNPaIO9zsSwoxAsJ5ByIQBP9zPpLq4RiQO7Vrex4rBOHFQJT50P7utcZiLMSZTyZJU4C/m5uB8qTCSBMp6+l6Q==",
+      "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": [

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

@@ -1,6 +1,6 @@
 {
   "name": "tr-plugin-openwiki",
-  "version": "0.1.11",
+  "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/",