total-recall-brain 3.41.2 → 3.41.4

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

@@ -1,10 +1,11 @@
 {
   "name": "tr-plugin-openwiki",
-  "version": "0.1.2",
+  "version": "0.1.7",
   "type": "module",
   "description": "Multi-repo knowledge graph and documentation wiki engine for Total Recall",
   "scripts": {
-    "test": "node --test test/*.test.mjs"
+    "test": "node --test test/*.test.mjs",
+    "ssss": "ssss"
   },
   "license": "MIT",
   "files": [
@@ -14,6 +15,11 @@
     "LICENSE",
     "ui/",
     "src/",
+    "capability/",
     "templates/"
-  ]
+  ],
+  "dependencies": {
+    "@gregiteen/ssss-cli": "0.14.3",
+    "openwiki": "^0.7.3"
+  }
 }

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

@@ -2,15 +2,34 @@
   "$schema": "https://github.com/gregiteen/total-recall/blob/main/metadata.plugin.schema.json",
   "id": "openwiki",
   "name": "OpenWiki",
-  "version": "0.1.2",
+  "version": "0.1.7",
   "description": "Multi-repo knowledge graph and documentation wiki engine for Total Recall.",
   "license": "MIT",
+  "tasks": [
+    {
+      "intent": "Watch upstream OpenWiki repository and announce/propagate updates",
+      "schedule": "0 */4 * * *",
+      "command": "watch"
+    }
+  ],
   "branding": {
     "name": "OpenWiki",
     "color": "#b45309",
     "badge": "Knowledge Graph",
     "font": "newsreader"
   },
+  "secrets": [
+    {
+      "key": "OPENROUTER_API_KEY",
+      "description": "Platform OpenRouter API key for cheap model documentation generation",
+      "required": false
+    },
+    {
+      "key": "GOOGLE_API_KEY",
+      "description": "Platform Google Gemini API key for direct Gemini model documentation generation",
+      "required": false
+    }
+  ],
   "card_face": {
     "headline": "OpenWiki Control Deck",
     "quick_actions": [
@@ -70,18 +89,64 @@
       {
         "name": "status",
         "description": "Show which OpenWiki subcommands are implemented",
-        "effect": "read"
+        "effect": "read",
+        "output": "json",
+        "args": [
+          {
+            "name": "json",
+            "flag": "--json",
+            "label": "JSON output",
+            "type": "boolean"
+          }
+        ]
       },
       {
         "name": "hubs",
         "description": "List indexed OpenWiki hubs and page counts",
-        "effect": "read"
+        "effect": "read",
+        "output": "json",
+        "args": [
+          {
+            "name": "json",
+            "flag": "--json",
+            "label": "JSON output",
+            "type": "boolean"
+          }
+        ]
       },
       {
         "name": "ingest",
         "description": "Ingest markdown documentation into the semantic knowledge graph",
         "timeout_ms": 600000,
-        "effect": "write"
+        "effect": "write",
+        "output": "json",
+        "args": [
+          {
+            "name": "path",
+            "label": "OpenWiki path",
+            "type": "string",
+            "required": true,
+            "positional": true
+          },
+          {
+            "name": "dryRun",
+            "flag": "--dry-run",
+            "label": "Preview without writing",
+            "type": "boolean"
+          },
+          {
+            "name": "global",
+            "flag": "--global",
+            "label": "Target global brain",
+            "type": "boolean"
+          },
+          {
+            "name": "project",
+            "flag": "--project",
+            "label": "Target project brain",
+            "type": "boolean"
+          }
+        ]
       },
       {
         "name": "bootstrap",
@@ -119,7 +184,146 @@
       {
         "name": "probe",
         "description": "Run HTTP 200 health verification probe",
-        "effect": "read"
+        "effect": "read",
+        "output": "json",
+        "args": [
+          {
+            "name": "json",
+            "flag": "--json",
+            "label": "JSON output",
+            "type": "boolean"
+          }
+        ]
+      },
+      {
+        "name": "refresh",
+        "description": "Report which registered projects' generated OpenWiki pages are stale; --apply regenerates them (openwiki/ only)",
+        "timeout_ms": 600000,
+        "effect": "write",
+        "output": "json",
+        "args": [
+          {
+            "name": "repo",
+            "flag": "--repo",
+            "label": "Target repository",
+            "type": "string"
+          },
+          {
+            "name": "apply",
+            "flag": "--apply",
+            "label": "Regenerate stale pages",
+            "type": "boolean"
+          },
+          {
+            "name": "force",
+            "flag": "--force",
+            "label": "Force regeneration",
+            "type": "boolean"
+          },
+          {
+            "name": "json",
+            "flag": "--json",
+            "label": "JSON output",
+            "type": "boolean"
+          }
+        ]
+      },
+      {
+        "name": "watch",
+        "description": "Watch upstream OpenWiki repository, announce new releases, and trigger propagation",
+        "effect": "write",
+        "output": "json",
+        "args": [
+          {
+            "name": "checkOnly",
+            "flag": "--check-only",
+            "label": "Check without announcing or propagating",
+            "type": "boolean"
+          },
+          {
+            "name": "announce",
+            "flag": "--announce",
+            "label": "Dispatch operator announcement",
+            "type": "boolean"
+          },
+          {
+            "name": "propagate",
+            "flag": "--propagate",
+            "label": "Execute fleet propagation",
+            "type": "boolean"
+          },
+          {
+            "name": "json",
+            "flag": "--json",
+            "label": "JSON output",
+            "type": "boolean"
+          }
+        ]
+      },
+      {
+        "name": "propagate",
+        "description": "Propagate updated OpenWiki generator across registered user repositories",
+        "effect": "write",
+        "output": "json",
+        "timeout_ms": 600000,
+        "args": [
+          {
+            "name": "repo",
+            "flag": "--repo",
+            "label": "Target repository",
+            "type": "string"
+          },
+          {
+            "name": "force",
+            "flag": "--force",
+            "label": "Force regeneration",
+            "type": "boolean"
+          },
+          {
+            "name": "dryRun",
+            "flag": "--dry-run",
+            "label": "Preview without writing",
+            "type": "boolean"
+          },
+          {
+            "name": "json",
+            "flag": "--json",
+            "label": "JSON output",
+            "type": "boolean"
+          }
+        ]
+      },
+      {
+        "name": "config",
+        "description": "Configure OpenWiki generator model routing, token bounds, and timeout",
+        "effect": "write",
+        "output": "json",
+        "args": [
+          {
+            "name": "action",
+            "label": "Action verb (show, get, set, reset)",
+            "type": "string",
+            "positional": true
+          },
+          {
+            "name": "key",
+            "label": "Configuration key",
+            "type": "string",
+            "positional": true
+          },
+          {
+            "name": "value",
+            "label": "Configuration value",
+            "type": "string",
+            "positional": true
+          },
+          {
+            "name": "json",
+            "flag": "--json",
+            "label": "JSON output",
+            "type": "boolean"
+          }
+        ]
       }
     ]
   },
@@ -161,6 +365,20 @@
     ],
     "session_verification": true
   },
+  "capability": {
+    "entry": "capability/index.mjs",
+    "description": "Standalone documentation hub discovery, wiki page auditing, and knowledge structure bootstrapping",
+    "dependencies": [],
+    "exports": [
+      "discoverWikiHubs",
+      "parseWikiHub",
+      "inspectWikiStaleness",
+      "bootstrapWikiPages",
+      "compareSemanticVersions",
+      "createPropagationPlan",
+      "formatPropagationReceipt"
+    ]
+  },
   "status": {
     "command": "status",
     "refresh_seconds": 300

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

@@ -0,0 +1,129 @@
+/**
+ * OpenWiki Configuration Management
+ * Handles persistent settings for documentation generation, provider selection, and cheap model routing.
+ */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+export const DEFAULT_OPENWIKI_CONFIG = Object.freeze({
+  provider: 'openrouter',
+  model: 'deepseek/deepseek-v4.1-flash',
+  fallback_model: 'qwen/qwen-2.5-coder-32b-instruct',
+  max_tokens: 4096,
+  timeout_ms: 300000
+});
+
+export const ALLOWED_CONFIG_KEYS = Object.freeze([
+  'provider',
+  'model',
+  'fallback_model',
+  'max_tokens',
+  'timeout_ms'
+]);
+
+export const ALLOWED_PROVIDERS = Object.freeze([
+  'openrouter',
+  'google',
+  'custom'
+]);
+
+/** Resolve the active configuration file path. */
+export function resolveConfigPath(options = {}) {
+  if (options.configPath) return options.configPath;
+  if (process.env.OPENWIKI_CONFIG_PATH) return process.env.OPENWIKI_CONFIG_PATH;
+  const home = options.home || os.homedir();
+  return path.join(home, '.agent', 'skills', 'total-recall', 'config', 'openwiki.json');
+}
+
+/** Load current OpenWiki configuration merged with defaults. */
+export function loadOpenWikiConfig(options = {}) {
+  const filePath = resolveConfigPath(options);
+  try {
+    if (!fs.existsSync(filePath)) {
+      return { ...DEFAULT_OPENWIKI_CONFIG };
+    }
+    const raw = fs.readFileSync(filePath, 'utf8');
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== 'object') {
+      return { ...DEFAULT_OPENWIKI_CONFIG };
+    }
+    return {
+      provider: typeof parsed.provider === 'string' && parsed.provider ? parsed.provider : DEFAULT_OPENWIKI_CONFIG.provider,
+      model: typeof parsed.model === 'string' && parsed.model ? parsed.model : DEFAULT_OPENWIKI_CONFIG.model,
+      fallback_model: typeof parsed.fallback_model === 'string' && parsed.fallback_model ? parsed.fallback_model : DEFAULT_OPENWIKI_CONFIG.fallback_model,
+      max_tokens: Number.isInteger(parsed.max_tokens) && parsed.max_tokens >= 512 && parsed.max_tokens <= 131072
+        ? parsed.max_tokens
+        : 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
+    };
+  } catch {
+    return { ...DEFAULT_OPENWIKI_CONFIG };
+  }
+}
+
+/** Save configuration atomically to disk. */
+export function saveOpenWikiConfig(config, options = {}) {
+  const filePath = resolveConfigPath(options);
+  const validated = {
+    provider: String(config.provider || DEFAULT_OPENWIKI_CONFIG.provider).toLowerCase(),
+    model: String(config.model || DEFAULT_OPENWIKI_CONFIG.model).trim(),
+    fallback_model: String(config.fallback_model || DEFAULT_OPENWIKI_CONFIG.fallback_model).trim(),
+    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
+  };
+
+  if (!ALLOWED_PROVIDERS.includes(validated.provider)) {
+    throw new Error(`Invalid provider: ${validated.provider}. Allowed: ${ALLOWED_PROVIDERS.join(', ')}`);
+  }
+  if (!validated.model) {
+    throw new Error('Model identifier cannot be empty');
+  }
+
+  const dir = path.dirname(filePath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+
+  const tmpPath = `${filePath}.tmp.${Date.now()}`;
+  fs.writeFileSync(tmpPath, `${JSON.stringify(validated, null, 2)}\n`, 'utf8');
+  fs.renameSync(tmpPath, filePath);
+  return validated;
+}
+
+/** Update a single configuration key. */
+export function setOpenWikiConfigValue(key, value, options = {}) {
+  if (!ALLOWED_CONFIG_KEYS.includes(key)) {
+    throw new Error(`Unknown configuration key: ${key}. Allowed: ${ALLOWED_CONFIG_KEYS.join(', ')}`);
+  }
+
+  const current = loadOpenWikiConfig(options);
+  let coercedValue = value;
+
+  if (key === 'max_tokens' || key === 'timeout_ms') {
+    const num = Number(value);
+    if (!Number.isInteger(num)) {
+      throw new Error(`${key} must be an integer`);
+    }
+    coercedValue = num;
+  } else if (key === 'provider') {
+    const p = String(value).toLowerCase().trim();
+    if (!ALLOWED_PROVIDERS.includes(p)) {
+      throw new Error(`Invalid provider: ${p}. Allowed: ${ALLOWED_PROVIDERS.join(', ')}`);
+    }
+    coercedValue = p;
+  } else {
+    coercedValue = String(value).trim();
+    if (!coercedValue) throw new Error(`${key} cannot be empty`);
+  }
+
+  current[key] = coercedValue;
+  return saveOpenWikiConfig(current, options);
+}
+
+/** Reset configuration to defaults. */
+export function resetOpenWikiConfig(options = {}) {
+  return saveOpenWikiConfig(DEFAULT_OPENWIKI_CONFIG, options);
+}