total-recall-brain 3.46.2 → 3.47.0

package/frontend/src/components/workspace/PluginHome.tsx

@@ -18,7 +18,7 @@ export function PluginHome({ plugin, plugins, brainId, onCommand }: {
   const home = (plugin.manifest?.ui as { home?: string } | undefined)?.home || plugin.ui?.home
   const panel = panels.find(element => element.id === home) || panels[0]
   const operations = scopedPluginOperations(plugin)
-  const chunks = published?.chunks.length ? published.chunks : defaults
+  const chunks = published?.chunks.length ? published.chunks : (panel ? [] : defaults)
 
   useEffect(() => {
     const controller = new AbortController()
@@ -62,8 +62,8 @@ export function PluginHome({ plugin, plugins, brainId, onCommand }: {
     )}
     {!loading && !published?.chunks.length && panel && !chunks.some(chunk => chunk.panel === panel.id) &&
       <PluginPanel plugin={plugin} elementId={panel.id} designCss={designCss} brainId={brainId} />}
-    {!published?.chunks.length && !chunks.some(chunk => chunk.operations?.length) && operations.length > 0 && <section aria-label="Plugin operations">
-      <h2>Start a workflow</h2>
+    {!loading && !panel && !chunks.length && operations.length > 0 && <section aria-label="Plugin operations">
+      <h2>Quick actions</h2>
       <ul className="plugin-home-operations">
         {operations.slice(0, 6).map(command => <li key={command.name}>
           <button type="button" className="btn btn-ghost" onClick={() => onCommand(command.name)}>{command.name}</button>

package/frontend/src/index.css

@@ -132,17 +132,15 @@ code, pre { font-family: var(--font-mono); }
   inset: 0 auto 0 0;
   width: var(--sidebar-width);
   min-width: var(--sidebar-width);
-  background: var(--glass);
-  backdrop-filter: blur(20px) saturate(1.4);
-  -webkit-backdrop-filter: blur(20px) saturate(1.4);
-  border-right: 1px solid var(--glass-border);
+  background: var(--bg-secondary);
+  border-right: 1px solid var(--border);
   display: flex;
   flex-direction: column;
   padding: 14px 0 12px;
   transform: translateX(-100%);
   transition: transform var(--transition-normal);
   z-index: 100;
-  box-shadow: 4px 0 40px rgba(0, 0, 0, 0.25);
+  box-shadow: 4px 0 40px rgba(0, 0, 0, 0.45);
 }
 
 .sidebar-nav {
@@ -211,24 +209,56 @@ code, pre { font-family: var(--font-mono); }
   flex-direction: column;
   min-width: 0;
   min-height: 0;
+  max-width: 100%;
+  overflow-x: hidden;
 }
 
 .workspace-toolbar {
-  display: flex;
+  display: grid;
+  grid-template-columns: 1fr auto 1fr;
   align-items: center;
-  justify-content: space-between;
-  gap: 12px;
-  padding: 8px clamp(12px, 3vw, 24px);
+  gap: 8px 12px;
+  width: 100%;
+  max-width: 100%;
+  box-sizing: border-box;
+  padding: 10px clamp(12px, 3vw, 24px);
   border-bottom: 1px solid var(--border);
 }
 
 .workspace-logo {
+  grid-column: 2;
+  justify-self: center;
   border-radius: var(--radius-sm);
 }
 
+.workspace-toolbar-actions {
+  grid-column: 3;
+  justify-self: end;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
+@media (max-width: 680px) {
+  .workspace-toolbar {
+    grid-template-columns: minmax(0, 1fr);
+    justify-items: center;
+  }
+  .workspace-toolbar-spacer {
+    display: none;
+  }
+  .workspace-logo,
+  .workspace-toolbar-actions {
+    grid-column: 1;
+    justify-self: center;
+  }
+}
+
 .workspace-body {
   flex: 1;
+  min-width: 0;
   min-height: 0;
+  max-width: 100%;
 }
 
 .workspace-body[hidden] {
@@ -399,14 +429,16 @@ code, pre { font-family: var(--font-mono); }
 .drawer-shortcut-edit { display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 2fr) auto; gap: 8px; }
 .drawer-code, .drawer-context { font-family: var(--font-mono), monospace; white-space: pre-wrap; overflow-wrap: anywhere; }
 .drawer-code { width: 100%; resize: vertical; }
-.drawer-html { display: block; width: 100%; height: clamp(160px, 35vh, 340px); border: 1px solid var(--border); border-radius: var(--radius-sm); }
+.drawer-html { display: block; width: 100%; height: 110px; border: 1px solid var(--border); border-radius: var(--radius-sm); }
 .help-content { display: grid; gap: 10px; min-width: 0; }
 .help-topic-picker { display: grid; gap: 4px; font-size: 13px; color: var(--text-secondary); }
 .help-topic-description { font-size: 12px; color: var(--text-secondary); }
 .help-article { min-width: 0; overflow-wrap: anywhere; }
 
 @media (max-width: 540px) {
-  .app-layout { --workspace-right-width: calc(100vw - 48px); --workspace-bottom-height: min(72dvh, 600px); }
+  .app-layout { --workspace-right-width: calc(100vw - 48px); --workspace-bottom-height: min(72dvh, 600px); overflow-x: clip; }
+  .workspace-toolbar { gap: 6px 8px; padding: 6px 10px; }
+  .workspace-toolbar .btn { padding-inline: 10px; font-size: 13px; }
   .workspace-edge-handle--right { font-size: 11px; padding-inline: 5px; }
   .workspace-edge-handle--right[aria-expanded="true"] { font-size: 0; }
   .drawer-shortcut-edit { grid-template-columns: minmax(0, 1fr); }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "total-recall-brain",
-  "version": "3.46.2",
+  "version": "3.47.0",
   "description": "The Vibe Coding Brain & Autonomous Software Factory: memory, rules, secrets, and 33 visual plugins automatically managed across all your devices.",
   "type": "module",
   "bin": {

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

@@ -1,18 +1,18 @@
 {
   "name": "tr-plugin-git",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "tr-plugin-git",
-      "version": "2.2.0",
+      "version": "2.3.0",
       "license": "MIT",
       "dependencies": {
         "@gregiteen/ssss-cli": "0.14.5"
       },
       "devDependencies": {
-        "total-recall-brain": "3.45.0",
+        "total-recall-brain": "3.46.2",
         "vitest": "^4.1.10"
       }
     },
@@ -6533,9 +6533,9 @@
       }
     },
     "node_modules/total-recall-brain": {
-      "version": "3.45.0",
-      "resolved": "https://registry.npmjs.org/total-recall-brain/-/total-recall-brain-3.45.0.tgz",
-      "integrity": "sha512-HDYfROazZbsLHQsFPnlBcSpe1HL1QEi7JG8x/eNRUI06RxVQsZWl8LwBo2lTWjWRDrKmCy7BUmSXQDuWF3lrEw==",
+      "version": "3.46.2",
+      "resolved": "https://registry.npmjs.org/total-recall-brain/-/total-recall-brain-3.46.2.tgz",
+      "integrity": "sha512-xEVtIA/lLbMtDJ4fO6WT37N4tDGbDjL/8imvrbFygOA+C17v6Y5M5023A5Wbm8PvwiUE18j8vzBdX5DJl8H3cg==",
       "dev": true,
       "license": "MIT",
       "workspaces": [

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

@@ -1,6 +1,6 @@
 {
   "name": "tr-plugin-git",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "type": "module",
   "description": "Reports the state of the current git repository: branch, dirty files, unpushed commits and stashes.",
   "scripts": {

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

@@ -2,7 +2,7 @@
   "$schema": "https://github.com/gregiteen/total-recall/blob/main/metadata.plugin.schema.json",
   "id": "git",
   "name": "Git",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "The whole git CLI through Total Recall: sign-in from the auth store, guarded commits and pushes, undo, fleet state, and the intent behind every change.",
   "author": "Total Recall",
   "license": "MIT",
@@ -147,5 +147,12 @@
   "distribution": {
     "tier": "official",
     "license": "open"
+  },
+  "reuse": {
+    "commands": [
+      "total-recall auth secret",
+      "total-recall ssss status"
+    ],
+    "owned": "Secret-firewalled commits and pushes, worktree management, unmerged branch detection, and fleet repository hygiene."
   }
 }

package/scaffold/.agent/skills/total-recall/plugins/git/src/ops/commit-memory.mjs

@@ -1,26 +1,9 @@
-import { spawn } from 'node:child_process';
 import { git, tr, ledger, intent, session } from '../lib/context.mjs';
-import { defaultBranch } from './unmerged.mjs';
 
-/**
- * Ask OpenWiki to refresh this repository without waiting for it. A due refresh
- * regenerates pages with a model for minutes; OpenWiki throttles repeats, keeps
- * its own 30-minute limit and writes the outcome to openwiki/.refresh-attempt.json.
- * Waiting here held every commit for 30 s, then killed only the CLI: the
- * generator finished on its own while the commit reported the refresh as failed.
- */
-export function requestWikiRefresh(ctx, launch = spawn) {
-  try {
-    const child = launch(ctx.env.GIT_PLUGIN_TR_BIN || 'total-recall', ['openwiki', 'refresh', '--repo', ctx.cwd, '--apply', '--json'], {
-      cwd: ctx.cwd, env: ctx.env, detached: true, stdio: 'ignore', shell: false,
-    });
-    child.on?.('error', () => {});
-    child.unref?.();
-    return child.pid ? { status: 'requested', command: 'openwiki refresh', outcome: 'openwiki/.refresh-attempt.json' } : { status: 'failed', command: 'openwiki refresh', reason: 'could not start' };
-  } catch {
-    return { status: 'failed', command: 'openwiki refresh', reason: 'could not start' };
-  }
-}
+// A commit never starts an OpenWiki refresh. Requesting one after every commit on the default
+// branch paid a model to re-check wiki pages after each automatic version-pin commit, in about
+// 40 repositories per Total Recall release. OpenWiki refreshes from its own nightly task on one
+// selected node (total-recall openwiki schedule).
 
 export const guards = [{
   name: 'commit-memory',
@@ -37,18 +20,7 @@ export const guards = [{
     // Save the commit before any optional provider call.
     store.append(record, { idempotencyKey: `commit-${sha}` });
     const memory = record.decisions.length ? tr(ctx, ['remember', 'decision', `${record.decisions.join('\n')}\nCommit: ${sha}`, '--project', '--slug', `git-decision-${sha}`]) : null;
-    let wiki;
-    // The wiki documents the default branch. Regenerating it from a feature branch spends model
-    // calls on pages that only conflict when the branch merges.
-    const branch = ctx.git(['symbolic-ref', '--quiet', '--short', 'HEAD']);
-    const base = defaultBranch(ctx);
-    if (!base || branch.status !== 0 || String(branch.stdout).trim() !== base.name) wiki = { status: 'skipped', reason: 'not on the default branch' };
-    else {
-      const available = tr(ctx, ['openwiki', '--help']);
-      wiki = available.status !== 0 || available.error ? { status: 'skipped', reason: 'OpenWiki is unavailable' } : requestWikiRefresh(ctx);
-    }
-    store.append({ type: 'git.commit_memory', sha, timestamp: new Date().toISOString(), memory: memory === null ? 'skipped: no named decision' : memory.status === 0 && !memory.error ? 'recorded' : 'failed', openwiki: wiki });
+    store.append({ type: 'git.commit_memory', sha, timestamp: new Date().toISOString(), memory: memory === null ? 'skipped: no named decision' : memory.status === 0 && !memory.error ? 'recorded' : 'failed' });
     if (memory && (memory.status !== 0 || memory.error)) console.error('Commit saved. Repository decision memory failed.');
-    if (wiki.status === 'failed') console.error('Commit saved. The OpenWiki refresh could not be started.');
   },
 }];

package/scaffold/.agent/skills/total-recall/plugins/git/ui/chunks/git-fleet-ops.md

@@ -0,0 +1,16 @@
+---
+type: ui-chunk:chunk
+title: Fleet routing & agent coordination
+description: Inspect fleet locations, bisect regressions, resolve conflicts, and coordinate multi-agent git handoffs.
+timestamp: "2026-11-14T08:51:00Z"
+plugin: git
+id: git-fleet-ops
+intents: [inspect fleet repos, locate branch or worktree, bisect or resolve conflicts, hand off git state]
+surfaces: [page]
+operations: [fleet, where, why, group, message, bisect-agent, resolve, handoff]
+---
+
+<section>
+  <h2>Fleet &amp; coordination ops</h2>
+  <p>Track repository placement across the fleet, diagnose branch divergence, resolve conflicts, and hand off clean git state between agents.</p>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/git/ui/chunks/git-publish.md

@@ -0,0 +1,16 @@
+---
+type: ui-chunk:chunk
+title: Secret-firewalled git publish & auth
+description: Commit, push, configure git credential helper/auth/cli bindings, and safely undo recent changes.
+timestamp: "2026-11-14T08:51:00Z"
+plugin: git
+id: git-publish
+intents: [commit changes, push branch, configure git auth, undo git change]
+surfaces: [page]
+operations: [commit, push, credential-helper, auth, cli, undo]
+---
+
+<section>
+  <h2>Publish &amp; credential guard</h2>
+  <p>Run secret-firewalled commits and pushes, bind Total Recall git credentials, or undo recent working-tree changes.</p>
+</section>

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

@@ -5,8 +5,11 @@
  */
 import fs from "node:fs";
 import path from "node:path";
+import { pathToFileURL } from "node:url";
 import { runBootstrapCommand } from './src/bootstrap.mjs';
-import { describeRetention, hasWiki, isDue, readProjects, refreshProject, refreshProjectAsync, resolveKey, staleness } from './src/refresh.mjs';
+import { CREDIT_REFUSAL, NO_MODEL, describeRetention, hasWiki, isDue, readProjects, refreshProject, refreshProjectAsync, resolveKey, staleness } from './src/refresh.mjs';
+
+const DEFAULT_REPO_CONCURRENCY = 2;
 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';
@@ -26,12 +29,14 @@ import { refreshDiagnostics } from './src/refresh-diagnostics.mjs';
  * Defaults to a report; --apply performs the refreshes, because regenerating a
  * repository's documentation is a write to that repository.
  */
+// OpenRouter answers 402 when the balance cannot cover a request.
+
 export async function refreshCommand(args, {
   read = readProjects, dueFor = isDue, refresh = refreshProjectAsync,
-  getKey = resolveKey, configFor = loadOpenWikiConfig,
+  getKey = resolveKey, configFor = loadOpenWikiConfig, clock = Date.now,
 } = {}) {
   if (args.includes('--help') || args.includes('-h')) {
-    console.log('Usage: total-recall openwiki refresh [--repo <name>] [--apply] [--force] [--diagnostics [--slot <local-minute>]] [--json]');
+    console.log('Usage: total-recall openwiki refresh [--repo <name>] [--apply [--budget-ms <n>]] [--force] [--diagnostics [--slot <local-minute>]] [--json]');
     return;
   }
   const json = args.includes('--json');
@@ -80,6 +85,8 @@ export async function refreshCommand(args, {
     if (!state.due) {
       if (state.skipped) {
         reports.push({ ...project, action: 'skipped', reason: state.reason });
+      } else if (state.held) {
+        reports.push({ ...project, action: 'held', uninitialized: Boolean(state.uninitialized), reason: state.reason, generationCommit: state.generationCommit, generationTime: state.generationTime, generatedAt: state.generatedAt, commitsSince: state.commitsSince });
       } else {
         reports.push({ ...project, action: 'current', reason: state.reason, generationCommit: state.generationCommit, generationTime: state.generationTime, generatedAt: state.generatedAt, commitsSince: state.commitsSince });
       }
@@ -102,6 +109,12 @@ export async function refreshCommand(args, {
   let payloadBudgetNote = null;
   if (apply && due.length) {
     const config = configFor();
+    if (!String(config.model || '').trim()) {
+      if (json) console.log(JSON.stringify({ ok: false, error: NO_MODEL, reports }));
+      else console.error(`OpenWiki refresh: ${NO_MODEL}`);
+      process.exitCode = 1;
+      return;
+    }
     const { key, from } = getKey({ provider: config.provider });
     if (!key) {
       const keyName = config.provider === 'google' ? 'GOOGLE_API_KEY' : 'OPENROUTER_API_KEY';
@@ -111,21 +124,37 @@ export async function refreshCommand(args, {
       process.exitCode = 1;
       return;
     }
+    // Repositories refreshed at once. Each one is a separate paid generator run, so
+    // the default stays low; OpenWiki's own page concurrency is left at its default.
     const concurrencyArg = args.find((a) => a.startsWith('--concurrency='));
     const concurrencyIndex = args.indexOf('--concurrency');
     const concurrency = Math.max(1, parseInt(
-      concurrencyArg ? concurrencyArg.slice('--concurrency='.length) : (concurrencyIndex >= 0 ? args[concurrencyIndex + 1] : '8'),
+      concurrencyArg ? concurrencyArg.slice('--concurrency='.length) : (concurrencyIndex >= 0 ? args[concurrencyIndex + 1] : String(DEFAULT_REPO_CONCURRENCY)),
       10
-    ) || 8);
+    ) || DEFAULT_REPO_CONCURRENCY);
+
+    // A scheduled run passes the time it has left before the task runner kills
+    // it. A generation started without room to finish is killed part-way, marked
+    // interrupted and paid for again on the next attempt, so none is started.
+    const budgetArg = args.find((a) => a.startsWith('--budget-ms='));
+    const budgetIndex = args.indexOf('--budget-ms');
+    const budgetMs = Number(budgetArg ? budgetArg.slice('--budget-ms='.length) : (budgetIndex >= 0 ? args[budgetIndex + 1] : NaN));
+    const generationMs = Number.isInteger(config.timeout_ms) ? config.timeout_ms : 300000;
+    const dispatchStarted = clock();
+    let stopReason = null;
 
     if (!json) {
-      console.log(`OpenWiki refresh (apply): dispatching ${due.length} projects with concurrency ${concurrency}`);
+      console.log(`OpenWiki refresh (apply): dispatching ${due.length} projects with concurrency ${concurrency}${Number.isFinite(budgetMs) ? ` within ${Math.round(budgetMs / 1000)}s` : ''}`);
     }
 
     let queueIndex = 0;
     let completedCount = 0;
     const worker = async () => {
       while (queueIndex < due.length) {
+        if (!stopReason && Number.isFinite(budgetMs) && clock() - dispatchStarted + generationMs > budgetMs) {
+          stopReason = `not started: fewer than ${Math.round(generationMs / 1000)}s left in this run's ${Math.round(budgetMs / 1000)}s budget`;
+        }
+        if (stopReason) break;
         const itemIndex = queueIndex++;
         const entry = due[itemIndex];
         const mode = entry.mode || (entry.uninitialized ? 'init' : 'update');
@@ -142,6 +171,9 @@ export async function refreshCommand(args, {
           result = { action: 'failed', reason: error.message.split(key).join('[REDACTED]') };
         }
         completedCount++;
+        if (!stopReason && CREDIT_REFUSAL.test(String(result.reason || ''))) {
+          stopReason = `not started: the provider refused ${entry.name} for credit; add credit, then refresh again`;
+        }
         const index = reports.findIndex((r) => r.root === entry.root);
         reports[index] = { ...reports[index], ...result, credential: from };
         if (!json) {
@@ -154,6 +186,11 @@ export async function refreshCommand(args, {
 
     const workers = Array.from({ length: Math.min(concurrency, due.length) }, () => worker());
     await Promise.all(workers);
+    for (const entry of due.slice(queueIndex)) {
+      const index = reports.findIndex((r) => r.root === entry.root);
+      reports[index] = { ...reports[index], action: 'deferred', reason: stopReason };
+    }
+    if (stopReason && queueIndex < due.length) payloadBudgetNote = `${due.length - queueIndex} project(s) ${stopReason}.`;
   }
 
   const failed = reports.filter((r) => r.action === 'failed');
@@ -171,6 +208,8 @@ export async function refreshCommand(args, {
       refreshed: reports.filter((r) => r.action === 'refreshed' || r.action === 'initialized').length,
       failed: failed.length,
       partial: partial.length,
+      held: reports.filter((r) => r.action === 'held').length,
+      deferred: reports.filter((r) => r.action === 'deferred').length,
       skipped: reports.filter((r) => r.action === 'skipped').length,
       current: reports.filter((r) => r.action === 'current').length,
     },
@@ -438,6 +477,8 @@ async function generateCommand(args) {
 
     if (json) {
       console.log(JSON.stringify(res, null, 2));
+    } else if (res.dryRun) {
+      console.log(`\n${res.message}\n`);
     } else {
       console.log(`\n✔ Generated documentation for ${res.repoName} (${Math.round((res.durationMs || 0)/1000)}s) via ${res.generatorVia}`);
       console.log(`  Output: ${res.outputDir}\n`);
@@ -572,8 +613,8 @@ async function configCommand(args) {
       else {
         console.log(`\nOpenWiki Configuration (${configPath}):`);
         console.log(`  Provider        : ${config.provider}`);
-        console.log(`  Model           : ${config.model}`);
-        console.log(`  Fallback Model  : ${config.fallback_model}`);
+        console.log(`  Model           : ${config.model || 'not set (refreshes stop until one is chosen)'}`);
+        console.log(`  Fallback Model  : ${config.fallback_model || 'not set'}`);
         console.log(`  Max Tokens      : ${config.max_tokens}`);
         console.log(`  Timeout (ms)    : ${config.timeout_ms}\n`);
       }
@@ -624,9 +665,76 @@ async function configCommand(args) {
   }
 }
 
+/**
+ * The scheduled run. The Automations runner kills it at the task's declared
+ * timeout_ms, so it dispatches only generations that can finish a minute
+ * before that.
+ */
+export function autoRefreshBudgetMs(manifestPath = new URL('./plugin.json', import.meta.url)) {
+  let timeout = null;
+  try {
+    const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+    timeout = manifest.tasks?.find((task) => task.command === 'auto-refresh')?.timeout_ms ?? null;
+  } catch { /* no readable manifest: use the runner's own limit */ }
+  return Math.max(60000, (Number.isInteger(timeout) ? timeout : 600000) - 60000);
+}
+
+async function loadScheduleCore() {
+  const root = process.env.TR_PACKAGE_ROOT;
+  if (!root) throw new Error('Run through total-recall openwiki schedule');
+  const load = (module) => import(pathToFileURL(path.join(root, 'src', 'core', module)).href);
+  const [loader, store, mesh] = await Promise.all([load('plugin-loader.mjs'), load('plugin-store.mjs'), load('mesh.mjs')]);
+  return { getPlugin: loader.getPlugin, readPluginRecord: store.readPluginRecord, patchPluginRecord: store.patchPluginRecord, getMeshSelf: mesh.getMeshSelf };
+}
+
+/**
+ * Where the nightly refresh runs. Like other selected-node tasks, the placement is
+ * task_nodes['auto-refresh'] in this plugin's record; with none, the task stays idle.
+ * Pick the node that holds the repository checkouts.
+ */
+export async function scheduleCommand(args = [], { core = null, config = loadOpenWikiConfig } = {}) {
+  const json = args.includes('--json');
+  const usage = 'Usage: total-recall openwiki schedule [--node <mesh hostname>|--node self|--off] [--json]';
+  try {
+    if (args.includes('--help') || args.includes('-h')) { console.log(usage); return; }
+    const nodeIndex = args.indexOf('--node');
+    const nodeArg = nodeIndex >= 0 ? args[nodeIndex + 1] : null;
+    if (nodeIndex >= 0 && (!nodeArg || nodeArg.startsWith('--'))) throw new Error(usage);
+    const off = args.includes('--off');
+    if (off && nodeArg) throw new Error(usage);
+    const owner = core || await loadScheduleCore();
+    const plugin = owner.getPlugin('openwiki');
+    if (!plugin?.valid) throw new Error('Install a valid OpenWiki plugin first');
+    const record = owner.readPluginRecord(plugin) || {};
+    const task = plugin.manifest?.tasks?.find((entry) => entry.command === 'auto-refresh') || null;
+    let node = record.task_nodes?.['auto-refresh'] || null;
+    if (off || nodeArg) {
+      node = off ? null : nodeArg === 'self' ? owner.getMeshSelf()?.hostname || null : nodeArg;
+      if (!off && !node) throw new Error('This machine has no mesh hostname; name the node with --node <hostname>');
+      const taskNodes = { ...(record.task_nodes || {}) };
+      if (node) taskNodes['auto-refresh'] = node;
+      else delete taskNodes['auto-refresh'];
+      await owner.patchPluginRecord(plugin, { task_nodes: taskNodes });
+    }
+    const model = config().model || null;
+    const payload = { ok: true, task: 'auto-refresh', schedule: task?.schedule || null, placement: task?.placement || null, node, model, ready: Boolean(node && model) };
+    if (json) console.log(JSON.stringify(payload, null, 2));
+    else {
+      console.log(`OpenWiki nightly refresh: ${node ? `runs on ${node}` : 'idle (no node selected)'} at "${payload.schedule}"`);
+      console.log(`  Model: ${model || `not set — ${NO_MODEL}`}`);
+    }
+  } catch (err) {
+    if (json) console.log(JSON.stringify({ ok: false, error: err.message }));
+    else console.error(`OpenWiki schedule: ${err.message}`);
+    process.exitCode = 1;
+  }
+}
+
 async function autoRefreshCommand(args = []) {
-  const hasApply = args.includes('--apply');
-  const forwardArgs = hasApply ? args : ['--apply', ...args];
+  const forwardArgs = args.includes('--apply') ? [...args] : ['--apply', ...args];
+  if (!forwardArgs.some((a) => a === '--budget-ms' || a.startsWith('--budget-ms='))) {
+    forwardArgs.push(`--budget-ms=${autoRefreshBudgetMs()}`);
+  }
   return refreshCommand(forwardArgs);
 }
 
@@ -651,6 +759,7 @@ IMPLEMENTED.autorefresh = autoRefreshCommand;
 IMPLEMENTED.watch = watchCommand;
 IMPLEMENTED.propagate = propagateCommand;
 IMPLEMENTED.config = configCommand;
+IMPLEMENTED.schedule = scheduleCommand;
 IMPLEMENTED.search = searchCommand;
 IMPLEMENTED.graph = graphCommand;
 IMPLEMENTED.token = tokenCommand;

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

@@ -1,18 +1,18 @@
 {
   "name": "tr-plugin-openwiki",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "tr-plugin-openwiki",
-      "version": "0.2.0",
+      "version": "0.3.0",
       "license": "MIT",
       "dependencies": {
         "@gregiteen/ssss-cli": "0.14.5"
       },
       "devDependencies": {
-        "total-recall-brain": "3.45.0"
+        "total-recall-brain": "3.46.2"
       }
     },
     "node_modules/@alcalzone/ansi-tokenize": {
@@ -5529,9 +5529,9 @@
       }
     },
     "node_modules/total-recall-brain": {
-      "version": "3.45.0",
-      "resolved": "https://registry.npmjs.org/total-recall-brain/-/total-recall-brain-3.45.0.tgz",
-      "integrity": "sha512-HDYfROazZbsLHQsFPnlBcSpe1HL1QEi7JG8x/eNRUI06RxVQsZWl8LwBo2lTWjWRDrKmCy7BUmSXQDuWF3lrEw==",
+      "version": "3.46.2",
+      "resolved": "https://registry.npmjs.org/total-recall-brain/-/total-recall-brain-3.46.2.tgz",
+      "integrity": "sha512-xEVtIA/lLbMtDJ4fO6WT37N4tDGbDjL/8imvrbFygOA+C17v6Y5M5023A5Wbm8PvwiUE18j8vzBdX5DJl8H3cg==",
       "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.2.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "Multi-repo knowledge graph and documentation wiki engine for Total Recall",
   "scripts": {

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.2.0",
+  "version": "0.3.0",
   "description": "Multi-repo knowledge graph and documentation wiki engine for Total Recall.",
   "license": "MIT",
   "runtime": {
@@ -17,10 +17,11 @@
       "command": "watch"
     },
     {
-      "intent": "Auto-refresh OpenWiki documentation for repositories with new commits",
-      "schedule": "*/30 * * * *",
+      "intent": "Refresh OpenWiki documentation nightly for repositories with real code changes, on the selected node",
+      "schedule": "20 1-5 * * *",
       "command": "auto-refresh",
-      "timeout_ms": 600000
+      "timeout_ms": 600000,
+      "placement": "selected-node"
     }
   ],
   "branding": {
@@ -291,6 +292,12 @@
             "label": "Force regeneration",
             "type": "boolean"
           },
+          {
+            "name": "budgetMs",
+            "flag": "--budget-ms",
+            "label": "Start no generation that cannot finish within this many milliseconds",
+            "type": "number"
+          },
           {
             "name": "json",
             "flag": "--json",
@@ -422,6 +429,32 @@
             "type": "boolean"
           }
         ]
+      },
+      {
+        "name": "schedule",
+        "description": "Show or choose the node that runs the nightly wiki refresh (task auto-refresh)",
+        "effect": "write",
+        "output": "json",
+        "args": [
+          {
+            "name": "node",
+            "flag": "--node",
+            "label": "Mesh hostname, or self for this machine",
+            "type": "string"
+          },
+          {
+            "name": "off",
+            "flag": "--off",
+            "label": "Stop the nightly refresh on every node",
+            "type": "boolean"
+          },
+          {
+            "name": "json",
+            "flag": "--json",
+            "label": "JSON output",
+            "type": "boolean"
+          }
+        ]
       }
     ]
   },
@@ -460,8 +493,23 @@
       "formatPropagationReceipt"
     ]
   },
+  "auth": {
+    "plugin": "auth",
+    "methods": [
+      "passkey",
+      "google-oauth2"
+    ],
+    "session_verification": true
+  },
   "status": {
     "command": "status",
     "refresh_seconds": 300
+  },
+  "reuse": {
+    "commands": [
+      "total-recall auth secret",
+      "total-recall ssss status"
+    ],
+    "owned": "Documentation hub discovery, wiki page auditing, staleness tracking, and OpenWiki knowledge ingestion."
   }
 }