total-recall-brain 3.40.0 → 3.40.2

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

@@ -0,0 +1,12 @@
+{
+  "name": "tr-plugin-openwiki",
+  "version": "0.1.1",
+  "private": true,
+  "type": "module",
+  "description": "Multi-repo knowledge graph and documentation wiki engine for Total Recall",
+  "scripts": {
+    "test": "node --test test/*.test.mjs"
+  },
+  "dependencies": {},
+  "license": "MIT"
+}

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

@@ -0,0 +1,165 @@
+{
+  "$schema": "https://github.com/gregiteen/total-recall/blob/main/metadata.plugin.schema.json",
+  "id": "openwiki",
+  "name": "OpenWiki",
+  "version": "0.1.1",
+  "description": "Multi-repo knowledge graph and documentation wiki engine for Total Recall.",
+  "license": "MIT",
+  "branding": {
+    "name": "OpenWiki",
+    "color": "#b45309",
+    "badge": "Knowledge Graph",
+    "font": "newsreader"
+  },
+  "card_face": {
+    "skin": "winamp-classic",
+    "theme": "vibrant",
+    "headline": "OpenWiki Control Deck",
+    "quick_actions": [
+      {
+        "subcommand": "status",
+        "label": "STATUS"
+      },
+      {
+        "subcommand": "hubs",
+        "label": "HUBS"
+      },
+      {
+        "subcommand": "ingest",
+        "label": "INGEST"
+      },
+      {
+        "subcommand": "probe",
+        "label": "200 PROBE"
+      }
+    ],
+    "touch_layout": "comfortable",
+    "interactive": true
+  },
+  "ssss_schemas": {
+    "categories": [
+      {
+        "name": "openwiki-hubs",
+        "description": "Multi-repo openwiki documentation and knowledge graph hubs",
+        "node_type": "memory"
+      },
+      {
+        "name": "openwiki-articles",
+        "description": "Ingested openwiki documentation pages and architecture summaries",
+        "node_type": "memory"
+      }
+    ]
+  },
+  "deploy": {
+    "targets": [
+      "ssss-app",
+      "nextjs",
+      "react",
+      "flask"
+    ],
+    "required_ssss_version": ">=0.9.3",
+    "access_grants": [
+      "auth:session:verify",
+      "ssss:vault:read",
+      "ssss:vault:write",
+      "ssss:events:append"
+    ]
+  },
+  "cli": {
+    "command": "openwiki",
+    "handler": "./cli.mjs",
+    "subcommands": [
+      {
+        "name": "status",
+        "description": "Show which OpenWiki subcommands are implemented",
+        "effect": "read"
+      },
+      {
+        "name": "hubs",
+        "description": "List indexed OpenWiki hubs and page counts",
+        "effect": "read"
+      },
+      {
+        "name": "ingest",
+        "description": "Ingest markdown documentation into the semantic knowledge graph",
+        "timeout_ms": 600000,
+        "effect": "write"
+      },
+      {
+        "name": "probe",
+        "description": "Run HTTP 200 health verification probe",
+        "effect": "read"
+      }
+    ]
+  },
+  "ui": {
+    "design_tokens": "ui/DESIGN.md",
+    "elements": [
+      {
+        "id": "panel",
+        "kind": "panel",
+        "tag": "openwiki-panel",
+        "module": "ui/panel.js",
+        "description": "OpenWiki panel",
+        "events": [
+          "save-token"
+        ],
+        "tokens": [
+          "color-text",
+          "color-surface",
+          "color-border",
+          "spacing-md",
+          "radius-md"
+        ],
+        "optional_tokens": []
+      },
+      {
+        "id": "card",
+        "kind": "card",
+        "tag": "tr-openwiki-card",
+        "module": "ui/card.js",
+        "description": "Knowledge Graph Card Face"
+      }
+    ]
+  },
+  "auth": {
+    "plugin": "auth",
+    "methods": [
+      "passkey",
+      "google-oauth2"
+    ],
+    "session_verification": true
+  },
+  "status": {
+    "command": "status",
+    "refresh_seconds": 300
+  },
+  "card_layout": {
+    "template": "dashboard",
+    "regions": [
+      {
+        "widget": "status",
+        "title": "Status"
+      },
+      {
+        "widget": "live",
+        "title": "Live view"
+      },
+      {
+        "widget": "list",
+        "title": "Details",
+        "source": {
+          "command": "hubs"
+        }
+      },
+      {
+        "widget": "actions",
+        "title": "Commands"
+      },
+      {
+        "widget": "activity",
+        "title": "Recent activity"
+      }
+    ]
+  }
+}

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

@@ -0,0 +1,127 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+
+const TR_BIN = process.env.TOTAL_RECALL_BIN || 'total-recall';
+
+function printHelp() {
+  console.log(`
+  Usage:
+    total-recall openwiki ingest <openwiki-path> [options]
+
+  Options:
+    --dry-run                 Preview import without writing
+    --global                  Target the global brain
+    --project                 Target the project brain (default)
+    --help, -h                Show this help
+  `);
+}
+
+export async function runOpenWikiIngest(args = []) {
+  let openwikiPath = null;
+  let dryRun = false;
+  let layerFlag = '--project';
+  let help = false;
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    switch (arg) {
+      case '--dry-run': dryRun = true; break;
+      case '--global': layerFlag = '--global'; break;
+      case '--project': layerFlag = '--project'; break;
+      case '--help': case '-h': help = true; break;
+      default:
+        if (!arg.startsWith('-') && !openwikiPath) {
+          openwikiPath = arg;
+        }
+    }
+  }
+
+  if (help || !openwikiPath) {
+    printHelp();
+    return { ok: true, imported: 0, errors: 0 };
+  }
+
+  if (openwikiPath && !fs.existsSync(openwikiPath)) {
+    console.error(`Error: OpenWiki directory not found at ${openwikiPath}`);
+    process.exitCode = 1;
+    return { ok: false, error: `Directory not found: ${openwikiPath}` };
+  }
+
+  console.log(`\n  Importing OpenWiki from: ${openwikiPath}`);
+  console.log(`  Target Brain: ${layerFlag.replace('--', '')}`);
+  if (dryRun) console.log('  DRY RUN: No actual writes will be committed.\n');
+
+  const mdFiles = [];
+  function scanDir(dir) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.name === 'node_modules' || entry.name === '.git' || entry.name === '.agent') continue;
+      const fullPath = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        scanDir(fullPath);
+      } else if (entry.isFile() && entry.name.endsWith('.md')) {
+        mdFiles.push(fullPath);
+      }
+    }
+  }
+
+  scanDir(openwikiPath);
+
+  let imported = 0;
+  let errors = 0;
+
+  for (const file of mdFiles) {
+    try {
+      const content = fs.readFileSync(file, 'utf8');
+      let title = path.basename(file, '.md').replace(/[-_]/g, ' ');
+      const titleMatch = content.match(/^#\s+(.+)$/m);
+      if (titleMatch) {
+        title = titleMatch[1].trim();
+      }
+
+      const relPath = path.relative(openwikiPath, file);
+      const slugBase = relPath.replace(/\.md$/, '').replace(/[^a-zA-Z0-9]+/g, '-').replace(/(^-|-$)/g, '');
+      const slug = 'openwiki-' + slugBase.toLowerCase();
+
+      if (dryRun) {
+        console.log(`  [DRY RUN] Would import: ${slug} ("${title}")`);
+        imported++;
+        continue;
+      }
+
+      const cliArgs = [
+        'remember', 'fact',
+        content,
+        '--title', title,
+        '--slug', slug,
+        '--tags', 'openwiki,architecture,documentation',
+        layerFlag
+      ];
+
+      const result = spawnSync(TR_BIN, cliArgs, { encoding: 'utf8' });
+      if (result.status === 0) {
+        console.log(`  Imported: ${slug}`);
+        imported++;
+      } else {
+        console.error(`  Error importing ${slug}: ${result.stderr}`);
+        errors++;
+      }
+    } catch (err) {
+      console.error(`  Exception on ${file}: ${err.message}`);
+      errors++;
+    }
+  }
+
+  console.log(`\n  Import Summary:`);
+  console.log(`  Imported: ${imported} files`);
+  console.log(`  Errors:   ${errors} files`);
+
+  if (!dryRun && imported > 0) {
+    console.log(`\n  OpenWiki knowledge graph successfully indexed into Total Recall.`);
+  }
+
+  return { ok: errors === 0, imported, errors };
+}
+
+export default runOpenWikiIngest;

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

@@ -0,0 +1,18 @@
+# DESIGN.md — Brain Dump
+
+```yaml
+tokens:
+  brand-name: "Brain Dump"
+  wordmark: "[BRAIN//DUMP]"
+  color-primary: "#3b82f6"
+  color-background: "#0f172a"
+  color-accent: "#facc15"
+  badge: "Knowledge Graph"
+  font-mono: "'JetBrains Mono', 'Fira Code', monospace"
+  border-radius: "8px"
+```
+
+## Brand & Typographic Wordmark
+- **Name**: Brain Dump
+- **Wordmark Logo**: `[BRAIN//DUMP]` (custom typographic badge, no generic icons)
+- **Palette**: Primary `#3b82f6`, Surface `#0f172a`, Accent `#facc15`.

package/scaffold/.agent/skills/total-recall/plugins/openwiki/ui/card.js

@@ -0,0 +1,279 @@
+/**
+ * OpenWiki — Multi-Repo Knowledge Graph & Documentation Wiki
+ * Bespoke Animated Web Component Card Face with Live Knowledge Graph Constellation.
+ *
+ * Zero emojis, authentic commercial brand identity, touch-first ergonomics (>=44px).
+ */
+
+export class OpenWikiCard extends HTMLElement {
+  constructor() {
+    super();
+    this.status = 'Ready';
+    this.executing = false;
+  }
+
+  connectedCallback() {
+    this.attachShadow({ mode: 'open' });
+    this.render();
+    this.initConstellationAnimation();
+  }
+
+  async execute(action, args = []) {
+    const out = this.shadowRoot.querySelector('#card-out');
+    const badge = this.shadowRoot.querySelector('#status-badge');
+    if (out) out.textContent = `[OPENWIKI] Querying ${action.toUpperCase()}...`;
+    if (badge) badge.textContent = 'INDEXING';
+    this.executing = true;
+
+    try {
+      const res = await this.host?.run(action, args);
+      let text = '';
+      if (typeof res === 'object') {
+        text = res.output || JSON.stringify(res, null, 2);
+      } else {
+        text = String(res || 'Execution completed without output.');
+      }
+      if (out) out.textContent = text.trim();
+      if (badge) badge.textContent = 'SYNCHRONIZED';
+    } catch (err) {
+      if (out) out.textContent = `[WIKI ERROR] ${err.message}`;
+      if (badge) badge.textContent = 'ERROR';
+    } finally {
+      this.executing = false;
+    }
+  }
+
+  initConstellationAnimation() {
+    const canvas = this.shadowRoot.querySelector('#wiki-canvas');
+    if (!canvas) return;
+    const ctx = canvas.getContext('2d');
+    if (!ctx) return;
+
+    const stars = [
+      { x: 50, y: 30, vx: 0.2, vy: 0.15 },
+      { x: 120, y: 18, vx: -0.15, vy: 0.2 },
+      { x: 170, y: 48, vx: 0.18, vy: -0.22 },
+      { x: 230, y: 22, vx: -0.2, vy: -0.1 },
+      { x: 290, y: 40, vx: 0.15, vy: 0.25 },
+      { x: 80, y: 50, vx: -0.1, vy: -0.18 }
+    ];
+
+    const draw = () => {
+      if (!this.isConnected) return;
+      ctx.clearRect(0, 0, canvas.width, canvas.height);
+
+      const w = canvas.width;
+      const h = canvas.height;
+
+      // Update positions
+      for (const s of stars) {
+        const mult = this.executing ? 2.5 : 1;
+        s.x += s.vx * mult;
+        s.y += s.vy * mult;
+        if (s.x < 15 || s.x > w - 15) s.vx *= -1;
+        if (s.y < 12 || s.y > h - 12) s.vy *= -1;
+      }
+
+      // Constellation graph links
+      ctx.strokeStyle = 'rgba(217, 119, 6, 0.22)';
+      ctx.lineWidth = 1;
+      for (let i = 0; i < stars.length; i++) {
+        for (let j = i + 1; j < stars.length; j++) {
+          const dx = stars[i].x - stars[j].x;
+          const dy = stars[i].y - stars[j].y;
+          const dist = Math.sqrt(dx * dx + dy * dy);
+          if (dist < 85) {
+            ctx.beginPath();
+            ctx.moveTo(stars[i].x, stars[i].y);
+            ctx.lineTo(stars[j].x, stars[j].y);
+            ctx.stroke();
+          }
+        }
+      }
+
+      // Constellation nodes
+      for (const s of stars) {
+        ctx.fillStyle = this.executing ? '#fde047' : '#d97706';
+        ctx.shadowColor = '#f59e0b';
+        ctx.shadowBlur = this.executing ? 8 : 4;
+        ctx.beginPath();
+        ctx.arc(s.x, s.y, 3, 0, Math.PI * 2);
+        ctx.fill();
+        ctx.shadowBlur = 0;
+      }
+
+      requestAnimationFrame(draw);
+    };
+
+    requestAnimationFrame(draw);
+  }
+
+  render() {
+    this.shadowRoot.innerHTML = `
+      <style>
+        :host {
+          display: block;
+          font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+          background: #130f06;
+          color: #fef3c7;
+          border-radius: 8px;
+          border: 1px solid rgba(217, 119, 6, 0.35);
+          box-shadow: 0 10px 28px rgba(0, 0, 0, 0.45);
+          padding: 18px;
+          box-sizing: border-box;
+          overflow: hidden;
+        }
+        .header {
+          display: flex;
+          justify-content: space-between;
+          align-items: flex-start;
+          margin-bottom: 14px;
+        }
+        .brand-meta {
+          display: flex;
+          flex-direction: column;
+          gap: 2px;
+        }
+        .title {
+          font-size: 16px;
+          font-weight: 700;
+          letter-spacing: 0.04em;
+          text-transform: uppercase;
+          color: #fde68a;
+          margin: 0;
+        }
+        .subtitle {
+          font-size: 11px;
+          color: #d97706;
+          letter-spacing: 0.02em;
+          margin: 0;
+        }
+        .badge {
+          display: inline-flex;
+          align-items: center;
+          justify-content: center;
+          font-size: 10px;
+          font-weight: 700;
+          letter-spacing: 0.08em;
+          text-transform: uppercase;
+          color: #f59e0b;
+          background: rgba(217, 119, 6, 0.12);
+          border: 1px solid rgba(217, 119, 6, 0.3);
+          border-radius: 4px;
+          padding: 4px 8px;
+        }
+        .visual-display {
+          position: relative;
+          background: #080602;
+          border: 1px solid rgba(217, 119, 6, 0.2);
+          border-radius: 6px;
+          margin-bottom: 14px;
+          overflow: hidden;
+        }
+        canvas {
+          display: block;
+          width: 100%;
+          height: 64px;
+        }
+        .telemetry-row {
+          display: flex;
+          justify-content: space-between;
+          padding: 6px 10px;
+          background: rgba(255, 255, 255, 0.03);
+          border-top: 1px solid rgba(217, 119, 6, 0.15);
+          font-family: monospace;
+          font-size: 11px;
+          color: #fcd34d;
+        }
+        .actions-grid {
+          display: grid;
+          grid-template-columns: repeat(3, 1fr);
+          gap: 8px;
+          margin-bottom: 12px;
+        }
+        .touch-btn {
+          min-height: 44px;
+          min-width: 44px;
+          display: inline-flex;
+          align-items: center;
+          justify-content: center;
+          background: rgba(217, 119, 6, 0.08);
+          border: 1px solid rgba(217, 119, 6, 0.25);
+          color: #fde68a;
+          font-size: 11px;
+          font-weight: 600;
+          letter-spacing: 0.04em;
+          text-transform: uppercase;
+          border-radius: 6px;
+          cursor: pointer;
+          transition: background 0.15s ease, border-color 0.15s ease;
+          padding: 6px 8px;
+          text-align: center;
+        }
+        .touch-btn:hover {
+          background: rgba(217, 119, 6, 0.18);
+          border-color: rgba(217, 119, 6, 0.5);
+        }
+        .touch-btn:active {
+          transform: translateY(1px);
+        }
+        .output-box {
+          background: #030201;
+          border: 1px solid rgba(217, 119, 6, 0.2);
+          border-radius: 6px;
+          padding: 8px 10px;
+          font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+          font-size: 11px;
+          line-height: 1.45;
+          color: #f59e0b;
+          min-height: 48px;
+          max-height: 85px;
+          overflow-y: auto;
+          white-space: pre-wrap;
+          word-break: break-word;
+        }
+      </style>
+
+      <div class="header">
+        <div class="brand-meta">
+          <h2 class="title">OpenWiki</h2>
+          <p class="subtitle">Multi-Repo Knowledge Graph & Documentation Wiki</p>
+        </div>
+        <div id="status-badge" class="badge">READY</div>
+      </div>
+
+      <div class="visual-display">
+        <canvas id="wiki-canvas" width="340" height="64"></canvas>
+        <div class="telemetry-row">
+          <span>Graph: Multi-Repo</span>
+          <span>Index: Real-Time</span>
+        </div>
+      </div>
+
+      <div class="actions-grid">
+        <button id="btn-status" class="touch-btn" type="button">Status</button>
+        <button id="btn-hubs" class="touch-btn" type="button">Indexed Hubs</button>
+        <button id="btn-ingest" class="touch-btn" type="button">Ingest</button>
+      </div>
+
+      <div id="card-out" class="output-box">Knowledge graph index operational. Ready for cross-repo documentation queries.</div>
+    `;
+
+    this.shadowRoot.querySelector('#btn-status')?.addEventListener('click', () => {
+      this.execute('status');
+    });
+    this.shadowRoot.querySelector('#btn-hubs')?.addEventListener('click', () => {
+      this.execute('hubs');
+    });
+    this.shadowRoot.querySelector('#btn-ingest')?.addEventListener('click', () => {
+      this.execute('ingest');
+    });
+  }
+}
+
+if (!customElements.get('tr-openwiki-card')) {
+  customElements.define('tr-openwiki-card', OpenWikiCard);
+}
+if (!customElements.get('openwiki-card')) {
+  customElements.define('openwiki-card', OpenWikiCard);
+}