total-recall-brain 3.47.0 → 3.47.2

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

@@ -11,7 +11,7 @@ import { CREDIT_REFUSAL, NO_MODEL, describeRetention, hasWiki, isDue, readProjec
 
 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 { loadOpenWikiConfig, setOpenWikiConfigValue, resetOpenWikiConfig, resolveConfigPath, setExcludedRoots, ALLOWED_CONFIG_KEYS, ALLOWED_PROVIDERS } from './src/config.mjs';
 import { discoverAllHubs } from './src/mesh-vaults.mjs';
 import { searchWikiHubs } from './src/search.mjs';
 import { buildKnowledgeGraph } from './src/graph.mjs';
@@ -83,8 +83,12 @@ export async function refreshCommand(args, {
       continue;
     }
     if (!state.due) {
-      if (state.skipped) {
+      if (state.excluded) {
+        reports.push({ ...project, action: 'excluded', reason: state.reason });
+      } else if (state.skipped) {
         reports.push({ ...project, action: 'skipped', reason: state.reason });
+      } else if (state.uninitialized && !state.held) {
+        reports.push({ ...project, action: 'no-wiki', uninitialized: true, reason: state.reason, generatedAt: state.generatedAt });
       } 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 {
@@ -202,9 +206,10 @@ export async function refreshCommand(args, {
     note: payloadBudgetNote,
     counts: {
       registered: projects.length,
-      withPages: reports.filter((r) => r.action !== 'skipped' && !r.uninitialized).length,
+      withPages: reports.filter((r) => !['skipped', 'excluded'].includes(r.action) && !r.uninitialized).length,
       due: due.length,
       uninitialized: reports.filter((r) => r.uninitialized).length,
+      excluded: reports.filter((r) => r.action === 'excluded').length,
       refreshed: reports.filter((r) => r.action === 'refreshed' || r.action === 'initialized').length,
       failed: failed.length,
       partial: partial.length,
@@ -217,11 +222,11 @@ export 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)`);
+    console.log(`OpenWiki refresh (${apply ? 'apply' : 'report'}): ${payload.counts.registered} registered, ${payload.counts.due} due, ${payload.counts.uninitialized} without a finished wiki, ${payload.counts.excluded} excluded`);
     // 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.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');
+      if (r.action === 'current' || r.action === 'excluded') continue;
+      const age = r.action === 'skipped' ? 'outside repository generation' : r.generationTime ? `generated ${r.generationTime} at ${r.generationCommit}` : r.uninitialized ? 'no finished wiki' : (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);
@@ -730,6 +735,46 @@ export async function scheduleCommand(args = [], { core = null, config = loadOpe
   }
 }
 
+/**
+ * List, add or remove repositories the refresh never touches. Takes registered
+ * project names or absolute paths; with none, lists the current exclusions.
+ */
+export async function excludeCommand(args = [], { read = readProjects, load = loadOpenWikiConfig, save = setExcludedRoots } = {}) {
+  const json = args.includes('--json');
+  const usage = 'Usage: total-recall openwiki exclude [<name|absolute path>...] [--remove] [--json]';
+  if (args.includes('--help') || args.includes('-h')) { console.log(usage); return; }
+  const remove = args.includes('--remove');
+  const targets = args.filter((a) => !a.startsWith('--'));
+  try {
+    if (remove && !targets.length) throw new Error(usage);
+    let roots = load().exclude || [];
+    if (targets.length) {
+      let projects = [];
+      try { projects = read({ exclude: [] }); } catch { projects = []; }
+      const chosen = [];
+      for (const target of targets) {
+        const matches = projects.filter((p) => p.name === target || (path.isAbsolute(target) && path.resolve(p.root) === path.resolve(target)));
+        if (matches.length > 1) throw new Error(`${target} names ${matches.length} registered projects; pass its absolute path`);
+        if (matches.length === 1) chosen.push(path.resolve(matches[0].root));
+        else if (path.isAbsolute(target)) chosen.push(path.resolve(target));
+        else throw new Error(`${target} is not a registered project name or an absolute path`);
+      }
+      roots = save(remove ? roots.filter((root) => !chosen.includes(root)) : [...roots, ...chosen]).exclude;
+    }
+    const payload = { ok: true, changed: targets.length > 0, exclude: roots };
+    if (json) console.log(JSON.stringify(payload, null, 2));
+    else {
+      console.log(`OpenWiki never refreshes ${roots.length} ${roots.length === 1 ? 'repository' : 'repositories'}${roots.length ? ':' : '.'}`);
+      for (const root of roots) console.log(`  ${root}`);
+    }
+    return payload;
+  } catch (err) {
+    if (json) console.log(JSON.stringify({ ok: false, error: err.message }));
+    else console.error(`OpenWiki exclude: ${err.message}`);
+    process.exitCode = 1;
+  }
+}
+
 async function autoRefreshCommand(args = []) {
   const forwardArgs = args.includes('--apply') ? [...args] : ['--apply', ...args];
   if (!forwardArgs.some((a) => a === '--budget-ms' || a.startsWith('--budget-ms='))) {
@@ -760,6 +805,7 @@ IMPLEMENTED.watch = watchCommand;
 IMPLEMENTED.propagate = propagateCommand;
 IMPLEMENTED.config = configCommand;
 IMPLEMENTED.schedule = scheduleCommand;
+IMPLEMENTED.exclude = excludeCommand;
 IMPLEMENTED.search = searchCommand;
 IMPLEMENTED.graph = graphCommand;
 IMPLEMENTED.token = tokenCommand;
@@ -830,7 +876,10 @@ export async function run(argv = process.argv) {
                               Create missing plugin-owned documentation pages
     refresh [--repo <name>] [--apply] [--force] [--json]
                               Report which registered projects' generated pages are stale;
-                              --apply regenerates stale pages (writes openwiki/ only)
+                              --apply regenerates stale pages (writes openwiki/ only).
+                              Never creates a wiki: use generate for that
+    exclude [<name|path>...] [--remove] [--json]
+                              List, add or remove repositories the refresh never touches
     auto-refresh [--repo <name>] [--force] [--json]
                               Automated daemon trigger to regenerate stale pages across repositories
     config [show|get <key>|set <key> <value>|reset] [--json]

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

@@ -1,18 +1,18 @@
 {
   "name": "tr-plugin-openwiki",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "tr-plugin-openwiki",
-      "version": "0.3.0",
+      "version": "0.4.0",
       "license": "MIT",
       "dependencies": {
         "@gregiteen/ssss-cli": "0.14.5"
       },
       "devDependencies": {
-        "total-recall-brain": "3.46.2"
+        "total-recall-brain": "3.47.0"
       }
     },
     "node_modules/@alcalzone/ansi-tokenize": {
@@ -5529,9 +5529,9 @@
       }
     },
     "node_modules/total-recall-brain": {
-      "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==",
+      "version": "3.47.0",
+      "resolved": "https://registry.npmjs.org/total-recall-brain/-/total-recall-brain-3.47.0.tgz",
+      "integrity": "sha512-S4UIdbbTyxw7C4+rix+7oHMm/6gYkcxwNBcP6kRDySX40p5IgqVTKgHk1n8rmaKiyYFoIX/HZHlHSjNrHgn0Gw==",
       "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.3.0",
+  "version": "0.4.1",
   "type": "module",
   "description": "Multi-repo knowledge graph and documentation wiki engine for Total Recall",
   "scripts": {
@@ -18,7 +18,8 @@
     "src/",
     "vendor/",
     "capability/",
-    "templates/"
+    "templates/",
+    "skills/"
   ],
   "dependencies": {
     "@gregiteen/ssss-cli": "0.14.5"

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

@@ -2,7 +2,7 @@
   "$schema": "https://github.com/gregiteen/total-recall/blob/main/metadata.plugin.schema.json",
   "id": "openwiki",
   "name": "OpenWiki",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Multi-repo knowledge graph and documentation wiki engine for Total Recall.",
   "license": "MIT",
   "runtime": {
@@ -72,7 +72,11 @@
     ]
   },
   "gate": {
-    "tasks": ["Search or read a repository's wiki", "Generate or refresh wiki pages", "Ingest documentation into memory"],
+    "tasks": [
+      "Search or read a repository's wiki",
+      "Generate or refresh wiki pages",
+      "Ingest documentation into memory"
+    ],
     "owned_commands": []
   },
   "cli": {
@@ -85,8 +89,19 @@
         "effect": "read",
         "output": "json",
         "args": [
-          { "name": "task", "label": "Task description", "type": "string", "positional": true, "required": true },
-          { "name": "json", "label": "JSON output", "type": "boolean", "flag": "--json" }
+          {
+            "name": "task",
+            "label": "Task description",
+            "type": "string",
+            "positional": true,
+            "required": true
+          },
+          {
+            "name": "json",
+            "label": "JSON output",
+            "type": "boolean",
+            "flag": "--json"
+          }
         ]
       },
       {
@@ -95,11 +110,37 @@
         "effect": "read",
         "output": "json",
         "args": [
-          { "name": "query", "label": "Search terms", "type": "string", "positional": true, "required": true },
-          { "name": "allVaults", "label": "Search all registered vaults", "type": "boolean", "flag": "--all-vaults" },
-          { "name": "node", "label": "Mesh node", "type": "string", "flag": "--node" },
-          { "name": "limit", "label": "Maximum results", "type": "number", "flag": "--limit" },
-          { "name": "json", "label": "JSON output", "type": "boolean", "flag": "--json" }
+          {
+            "name": "query",
+            "label": "Search terms",
+            "type": "string",
+            "positional": true,
+            "required": true
+          },
+          {
+            "name": "allVaults",
+            "label": "Search all registered vaults",
+            "type": "boolean",
+            "flag": "--all-vaults"
+          },
+          {
+            "name": "node",
+            "label": "Mesh node",
+            "type": "string",
+            "flag": "--node"
+          },
+          {
+            "name": "limit",
+            "label": "Maximum results",
+            "type": "number",
+            "flag": "--limit"
+          },
+          {
+            "name": "json",
+            "label": "JSON output",
+            "type": "boolean",
+            "flag": "--json"
+          }
         ]
       },
       {
@@ -108,10 +149,35 @@
         "effect": "read",
         "output": "json",
         "args": [
-          { "name": "allVaults", "label": "Inspect all registered vaults", "type": "boolean", "flag": "--all-vaults" },
-          { "name": "node", "label": "Mesh node", "type": "string", "flag": "--node" },
-          { "name": "format", "label": "Graph format", "type": "choice", "options": ["json", "mermaid", "dot"], "flag": "--format" },
-          { "name": "json", "label": "JSON output", "type": "boolean", "flag": "--json" }
+          {
+            "name": "allVaults",
+            "label": "Inspect all registered vaults",
+            "type": "boolean",
+            "flag": "--all-vaults"
+          },
+          {
+            "name": "node",
+            "label": "Mesh node",
+            "type": "string",
+            "flag": "--node"
+          },
+          {
+            "name": "format",
+            "label": "Graph format",
+            "type": "choice",
+            "options": [
+              "json",
+              "mermaid",
+              "dot"
+            ],
+            "flag": "--format"
+          },
+          {
+            "name": "json",
+            "label": "JSON output",
+            "type": "boolean",
+            "flag": "--json"
+          }
         ]
       },
       {
@@ -121,11 +187,36 @@
         "output": "json",
         "timeout_ms": 600000,
         "args": [
-          { "name": "repo", "label": "Registered repository", "type": "string", "flag": "--repo" },
-          { "name": "node", "label": "Mesh node", "type": "string", "flag": "--node" },
-          { "name": "force", "label": "Regenerate existing pages", "type": "boolean", "flag": "--force" },
-          { "name": "dryRun", "label": "Describe generation without writing", "type": "boolean", "flag": "--dry-run" },
-          { "name": "json", "label": "JSON output", "type": "boolean", "flag": "--json" }
+          {
+            "name": "repo",
+            "label": "Registered repository",
+            "type": "string",
+            "flag": "--repo"
+          },
+          {
+            "name": "node",
+            "label": "Mesh node",
+            "type": "string",
+            "flag": "--node"
+          },
+          {
+            "name": "force",
+            "label": "Regenerate existing pages",
+            "type": "boolean",
+            "flag": "--force"
+          },
+          {
+            "name": "dryRun",
+            "label": "Describe generation without writing",
+            "type": "boolean",
+            "flag": "--dry-run"
+          },
+          {
+            "name": "json",
+            "label": "JSON output",
+            "type": "boolean",
+            "flag": "--json"
+          }
         ]
       },
       {
@@ -134,11 +225,44 @@
         "effect": "write",
         "output": "json",
         "args": [
-          { "name": "action", "label": "Credential action", "type": "choice", "options": ["status", "set"], "positional": true },
-          { "name": "provider", "label": "Credential provider", "type": "choice", "options": ["openrouter", "google"], "positional": true },
-          { "name": "value", "label": "Secret value through stdin", "type": "string", "secret": true },
-          { "name": "stdin", "label": "Read secret from stdin", "type": "boolean", "flag": "--stdin" },
-          { "name": "json", "label": "JSON output", "type": "boolean", "flag": "--json" }
+          {
+            "name": "action",
+            "label": "Credential action",
+            "type": "choice",
+            "options": [
+              "status",
+              "set"
+            ],
+            "positional": true
+          },
+          {
+            "name": "provider",
+            "label": "Credential provider",
+            "type": "choice",
+            "options": [
+              "openrouter",
+              "google"
+            ],
+            "positional": true
+          },
+          {
+            "name": "value",
+            "label": "Secret value through stdin",
+            "type": "string",
+            "secret": true
+          },
+          {
+            "name": "stdin",
+            "label": "Read secret from stdin",
+            "type": "boolean",
+            "flag": "--stdin"
+          },
+          {
+            "name": "json",
+            "label": "JSON output",
+            "type": "boolean",
+            "flag": "--json"
+          }
         ]
       },
       {
@@ -147,9 +271,24 @@
         "effect": "read",
         "output": "json",
         "args": [
-          { "name": "allVaults", "label": "Inspect all registered vaults", "type": "boolean", "flag": "--all-vaults" },
-          { "name": "node", "label": "Mesh node", "type": "string", "flag": "--node" },
-          { "name": "json", "label": "JSON output", "type": "boolean", "flag": "--json" }
+          {
+            "name": "allVaults",
+            "label": "Inspect all registered vaults",
+            "type": "boolean",
+            "flag": "--all-vaults"
+          },
+          {
+            "name": "node",
+            "label": "Mesh node",
+            "type": "string",
+            "flag": "--node"
+          },
+          {
+            "name": "json",
+            "label": "JSON output",
+            "type": "boolean",
+            "flag": "--json"
+          }
         ]
       },
       {
@@ -269,7 +408,7 @@
       },
       {
         "name": "refresh",
-        "description": "Report which registered projects' generated OpenWiki pages are stale; --apply regenerates them (openwiki/ only)",
+        "description": "Report which registered projects' generated OpenWiki pages are stale; --apply updates existing wikis (openwiki/ only), never creates one, and skips excluded repositories",
         "timeout_ms": 600000,
         "effect": "write",
         "output": "json",
@@ -455,6 +594,31 @@
             "type": "boolean"
           }
         ]
+      },
+      {
+        "name": "exclude",
+        "description": "List, add or remove repositories the wiki refresh and generate never touch (clones, forks, backups)",
+        "effect": "write",
+        "args": [
+          {
+            "name": "targets",
+            "type": "string",
+            "label": "Registered project name or absolute path",
+            "positional": true
+          },
+          {
+            "name": "remove",
+            "flag": "--remove",
+            "label": "Take the repositories off the list",
+            "type": "boolean"
+          },
+          {
+            "name": "json",
+            "flag": "--json",
+            "label": "JSON output",
+            "type": "boolean"
+          }
+        ]
       }
     ]
   },
@@ -493,14 +657,6 @@
       "formatPropagationReceipt"
     ]
   },
-  "auth": {
-    "plugin": "auth",
-    "methods": [
-      "passkey",
-      "google-oauth2"
-    ],
-    "session_verification": true
-  },
   "status": {
     "command": "status",
     "refresh_seconds": 300
@@ -511,5 +667,12 @@
       "total-recall ssss status"
     ],
     "owned": "Documentation hub discovery, wiki page auditing, staleness tracking, and OpenWiki knowledge ingestion."
-  }
+  },
+  "skills": [
+    {
+      "id": "openwiki",
+      "path": "./skills/openwiki/SKILL.md",
+      "description": "Multi-repo knowledge graph and documentation wiki engine for Total Recall."
+    }
+  ]
 }

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

@@ -0,0 +1,32 @@
+---
+name: openwiki
+description: "Multi-repo knowledge graph and documentation wiki engine for Total Recall."
+version: 0.4.0
+repo_scoped: false
+---
+
+# OpenWiki
+
+Multi-repo knowledge graph and documentation wiki engine for Total Recall.
+
+## When to Use
+
+Use the `openwiki` Total Recall plugin (`total-recall openwiki`) instead of ad-hoc scripts or raw commands whenever working on openwiki tasks.
+
+## Commands
+
+```bash
+total-recall openwiki --help
+total-recall openwiki context  # Retrieve task-relevant wiki and explicitly linked source evidence with provenance and freshness
+total-recall openwiki search  # Search evidence passages in workspace, registered-vault or mesh documentation hubs
+total-recall openwiki graph  # Extract documentation link topology as JSON, Mermaid or DOT
+total-recall openwiki generate  # Generate documentation for the selected registered repository or current workspace
+total-recall openwiki token  # Inspect provider credential status or save a provider key through the shared auth owner
+total-recall openwiki lint  # Inspect documentation links and orphaned hubs without rewriting files
+total-recall openwiki status  # Show which OpenWiki subcommands are implemented
+total-recall openwiki hubs  # List indexed OpenWiki hubs and page counts
+total-recall openwiki ingest  # Ingest markdown documentation into the semantic knowledge graph
+total-recall openwiki bootstrap  # Create missing OpenWiki documentation pages in explicit brain and project directories
+total-recall openwiki probe  # Run HTTP 200 health verification probe
+total-recall openwiki refresh  # Report which registered projects' generated OpenWiki pages are stale; --apply updates existing wikis (openwiki/ only), never creates one, and skips excluded repositories
+```

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

@@ -9,14 +9,28 @@ import path from 'node:path';
 // No model default: models and prices change too often to fix one in code, and a stale
 // default (deepseek/deepseek-chat) cost about 5x a current model of the same family.
 // A refresh with no configured model stops before it calls a provider.
+//
+// exclude lists repository roots the refresh never touches: upstream clones,
+// forks, backups and test probes. Registering a repository with Total Recall
+// gives it a brain; it does not make its code something to document.
 export const DEFAULT_OPENWIKI_CONFIG = Object.freeze({
   provider: 'openrouter',
   model: null,
   fallback_model: null,
   max_tokens: 4096,
-  timeout_ms: 300000
+  timeout_ms: 300000,
+  exclude: Object.freeze([])
 });
 
+/** Absolute, de-duplicated, sorted repository roots. */
+export function normalizeExclude(list) {
+  if (!Array.isArray(list)) return [];
+  const roots = list
+    .filter((entry) => typeof entry === 'string' && entry.trim() && path.isAbsolute(entry.trim()))
+    .map((entry) => path.resolve(entry.trim()));
+  return [...new Set(roots)].sort();
+}
+
 export const ALLOWED_CONFIG_KEYS = Object.freeze([
   'provider',
   'model',
@@ -44,12 +58,12 @@ export function loadOpenWikiConfig(options = {}) {
   const filePath = resolveConfigPath(options);
   try {
     if (!fs.existsSync(filePath)) {
-      return { ...DEFAULT_OPENWIKI_CONFIG };
+      return { ...DEFAULT_OPENWIKI_CONFIG, exclude: [] };
     }
     const raw = fs.readFileSync(filePath, 'utf8');
     const parsed = JSON.parse(raw);
     if (!parsed || typeof parsed !== 'object') {
-      return { ...DEFAULT_OPENWIKI_CONFIG };
+      return { ...DEFAULT_OPENWIKI_CONFIG, exclude: [] };
     }
     return {
       provider: typeof parsed.provider === 'string' && parsed.provider ? parsed.provider : DEFAULT_OPENWIKI_CONFIG.provider,
@@ -60,10 +74,11 @@ export function loadOpenWikiConfig(options = {}) {
         : DEFAULT_OPENWIKI_CONFIG.max_tokens,
       timeout_ms: Number.isInteger(parsed.timeout_ms) && parsed.timeout_ms >= 30000 && parsed.timeout_ms <= 1800000
         ? parsed.timeout_ms
-        : DEFAULT_OPENWIKI_CONFIG.timeout_ms
+        : DEFAULT_OPENWIKI_CONFIG.timeout_ms,
+      exclude: normalizeExclude(parsed.exclude)
     };
   } catch {
-    return { ...DEFAULT_OPENWIKI_CONFIG };
+    return { ...DEFAULT_OPENWIKI_CONFIG, exclude: [] };
   }
 }
 
@@ -75,7 +90,8 @@ export function saveOpenWikiConfig(config, options = {}) {
     model: config.model ? String(config.model).trim() || null : null,
     fallback_model: config.fallback_model ? String(config.fallback_model).trim() || null : null,
     max_tokens: Number.isInteger(Number(config.max_tokens)) ? Math.max(512, Math.min(131072, Number(config.max_tokens))) : DEFAULT_OPENWIKI_CONFIG.max_tokens,
-    timeout_ms: Number.isInteger(Number(config.timeout_ms)) ? Math.max(30000, Math.min(1800000, Number(config.timeout_ms))) : DEFAULT_OPENWIKI_CONFIG.timeout_ms
+    timeout_ms: Number.isInteger(Number(config.timeout_ms)) ? Math.max(30000, Math.min(1800000, Number(config.timeout_ms))) : DEFAULT_OPENWIKI_CONFIG.timeout_ms,
+    exclude: normalizeExclude(config.exclude)
   };
 
   if (!ALLOWED_PROVIDERS.includes(validated.provider)) {
@@ -123,7 +139,17 @@ export function setOpenWikiConfigValue(key, value, options = {}) {
   return saveOpenWikiConfig(current, options);
 }
 
-/** Reset configuration to defaults. */
+/**
+ * Reset the generator settings to defaults. The exclude list is kept: a reset
+ * must not put clones and backups back into a paid refresh.
+ */
 export function resetOpenWikiConfig(options = {}) {
-  return saveOpenWikiConfig(DEFAULT_OPENWIKI_CONFIG, options);
+  const { exclude } = loadOpenWikiConfig(options);
+  return saveOpenWikiConfig({ ...DEFAULT_OPENWIKI_CONFIG, exclude }, options);
+}
+
+/** Replace the list of repository roots the refresh never touches. */
+export function setExcludedRoots(roots, options = {}) {
+  const current = loadOpenWikiConfig(options);
+  return saveOpenWikiConfig({ ...current, exclude: roots }, options);
 }

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

@@ -70,6 +70,12 @@ export async function generateWiki({
     throw new Error(`Target path does not exist: ${resolvedTarget}`);
   }
 
+  // An excluded repository (an upstream clone, fork, backup or probe) is never
+  // documented, even from inside its own checkout.
+  if ((loadOpenWikiConfig().exclude || []).includes(path.resolve(resolvedTarget))) {
+    throw new Error(`${repoName} is excluded from OpenWiki. To document it, first run: total-recall openwiki exclude --remove ${repoName}`);
+  }
+
   const outPath = outputDir ? path.resolve(resolvedTarget, outputDir) : path.join(resolvedTarget, 'openwiki');
 
   if (dryRun) {