total-recall-brain 3.41.3 → 3.41.4

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

@@ -1,534 +1,1158 @@
 /**
- * Brain Dump — Multi-Repo Knowledge Graph & Documentation Console
+ * OpenWiki — Knowledge Graph & Multi-Repo Documentation Wiki
+ * Bespoke Card Face: Deep Slate & Knowledge Amber Interface.
  *
- * Bespoke operator interface for cross-repository documentation and knowledge graphs.
- * Displays real-time hub trees, file metrics, structured ingestion controllers,
- * and bootstrap verification without template wrappers or terminal dumps.
+ * Exposes live hub discovery, markdown file inspection, upstream release surveillance,
+ * and structured fleet propagation controls. Operates without mock data or boilerplate sinks.
  */
 
-const DASH = '\u2014';
-
-function escapeHtml(str) {
-  if (str === null || str === undefined) return '';
-  return String(str).replace(/[&<>"']/g, c => ({
-    '&': '&amp;',
-    '<': '&lt;',
-    '>': '&gt;',
-    '"': '&quot;',
-    "'": '&#39;'
-  }[c]));
-}
-
 export class OpenWikiCard extends HTMLElement {
+  static get screens() {
+    return [
+      { id: 'hubs', label: 'Hubs' },
+      { id: 'config', label: 'Configuration' },
+      { id: 'refresh', label: 'Fleet Refresh' },
+      { id: 'upstream', label: 'Upstream Watcher' }
+    ];
+  }
+
+  get screens() {
+    return OpenWikiCard.screens;
+  }
+
   constructor() {
     super();
+    this.activeScreen = 'hubs';
     this.hubs = [];
-    this.totalLines = 0;
-    this.executing = false;
+    this.loading = false;
+    this.statusText = 'READY';
     this.targetPath = 'openwiki';
-    this.dryRun = true;
-    this.lastResult = null;
-    this.screens = [{ id: 'knowledge', label: 'Knowledge Hubs' }];
-    this.screen = 'knowledge';
+    this.dryRun = false;
+    this.executionResult = null;
+    this.errorMessage = null;
+    this.lastRefreshedAt = null;
+    this.upstream = null;
+    this.config = {
+      provider: 'openrouter',
+      model: 'deepseek/deepseek-v4.1-flash',
+      fallback_model: 'qwen/qwen-2.5-coder-32b-instruct',
+      max_tokens: 4096,
+      timeout_ms: 300000
+    };
+    this.refreshReports = [];
+    this.refreshCounts = null;
+    this._boundOnScreenChange = this.handleExternalScreenChange.bind(this);
   }
 
   connectedCallback() {
     if (!this.shadowRoot) {
       this.attachShadow({ mode: 'open' });
     }
+    this.addEventListener('tr:screen-change', this._boundOnScreenChange);
+    this.addEventListener('plugin-show-screen', this._boundOnScreenChange);
     this.render();
     this.refreshHubs();
+    this.loadConfig();
   }
 
-  async refreshHubs() {
-    if (!this.host) return;
+  disconnectedCallback() {
+    this.removeEventListener('tr:screen-change', this._boundOnScreenChange);
+    this.removeEventListener('plugin-show-screen', this._boundOnScreenChange);
+  }
+
+  handleExternalScreenChange(event) {
+    const screenId = event.detail?.screen || event.detail?.screenId || event.detail?.id;
+    if (screenId && OpenWikiCard.screens.some((s) => s.id === screenId)) {
+      this.setScreen(screenId);
+    }
+  }
+
+  setScreen(id) {
+    if (this.activeScreen === id) return;
+    this.activeScreen = id;
+    this.errorMessage = null;
+    this.render();
+    if (typeof this.host?.screenChanged === 'function') {
+      try {
+        this.host.screenChanged({ screen: id });
+      } catch {
+        // Host screenChanged callback optional
+      }
+    }
+    if (id === 'refresh' && (!this.refreshReports || this.refreshReports.length === 0)) {
+      this.loadRefreshReport();
+    } else if (id === 'config') {
+      this.loadConfig();
+    }
+  }
+
+  async loadConfig() {
     try {
-      const res = await this.host.run('status', ['--json']);
-      let parsed = [];
-      if (res && typeof res === 'object') {
-        if (Array.isArray(res.hubs)) {
-          parsed = res.hubs;
-          this.totalLines = res.total_lines || 0;
-        } else if (Array.isArray(res)) {
-          parsed = res;
-        }
-      } else if (typeof res === 'string' && res.trim().startsWith('{')) {
-        const json = JSON.parse(res);
-        parsed = Array.isArray(json.hubs) ? json.hubs : [];
-        this.totalLines = json.total_lines || 0;
+      if (this.host && typeof this.host.run === 'function') {
+        const res = await this.host.run('config', ['show', '--json']);
+        if (res?.config) {
+          this.config = res.config;
+          this.render();
+        }
       }
+    } catch {
+      // Retain active config defaults if host call fails
+    }
+  }
 
-      this.hubs = parsed;
+  async setConfigValue(key, value) {
+    this.loading = true;
+    this.errorMessage = null;
+    this.render();
+    try {
+      if (this.host && typeof this.host.run === 'function') {
+        const res = await this.host.run('config', ['set', key, String(value), '--json']);
+        if (res?.config) {
+          this.config = res.config;
+        }
+      }
+    } catch (err) {
+      this.errorMessage = err.message || `Failed to update ${key}`;
+    } finally {
+      this.loading = false;
       this.render();
-    } catch {
-      this.hubs = [];
+    }
+  }
+
+  async resetConfig() {
+    this.loading = true;
+    this.errorMessage = null;
+    this.render();
+    try {
+      if (this.host && typeof this.host.run === 'function') {
+        const res = await this.host.run('config', ['reset', '--json']);
+        if (res?.config) {
+          this.config = res.config;
+        }
+      }
+    } catch (err) {
+      this.errorMessage = err.message || 'Failed to reset configuration';
+    } finally {
+      this.loading = false;
       this.render();
     }
   }
 
-  async runIngest() {
-    if (!this.host || this.executing) return;
-    this.executing = true;
-    this.lastResult = null;
+  async refreshHubs() {
+    this.loading = true;
+    this.errorMessage = null;
     this.render();
 
     try {
-      const args = [this.targetPath || 'openwiki'];
-      if (this.dryRun) args.push('--dry-run');
-      args.push('--json');
-
-      const res = await this.host.run('ingest', args);
-      this.lastResult = {
-        ok: true,
-        message: this.dryRun ? 'Dry-run preview completed' : 'Ingestion completed successfully',
-        data: res
-      };
-      await this.refreshHubs();
+      if (this.host && typeof this.host.run === 'function') {
+        const res = await this.host.run('hubs', ['--json']);
+        if (res && Array.isArray(res.hubs)) {
+          this.hubs = res.hubs;
+          this.statusText = 'SYNCHRONIZED';
+        } else {
+          this.hubs = [];
+          this.statusText = 'UNINDEXED';
+        }
+
+        try {
+          const statusRes = await this.host.run('status', ['--json']);
+          if (statusRes?.upstream) {
+            this.upstream = statusRes.upstream;
+          }
+        } catch {
+          // Upstream metadata optional
+        }
+      } else {
+        this.statusText = 'DISCONNECTED';
+      }
+      this.lastRefreshedAt = new Date().toLocaleTimeString();
+    } catch (err) {
+      this.statusText = 'ERROR';
+      this.errorMessage = err.message || 'Hub synchronization failure';
+      this.hubs = [];
+    } finally {
+      this.loading = false;
+      this.render();
+    }
+  }
+
+  async loadRefreshReport() {
+    this.loading = true;
+    this.errorMessage = null;
+    this.render();
+    try {
+      if (this.host && typeof this.host.run === 'function') {
+        const res = await this.host.run('refresh', ['--json']);
+        if (res) {
+          this.refreshReports = Array.isArray(res.reports) ? res.reports : [];
+          this.refreshCounts = res.counts || null;
+        }
+      }
     } catch (err) {
-      this.lastResult = {
-        ok: false,
-        message: err instanceof Error ? err.message : 'Ingestion failed'
-      };
+      this.errorMessage = err.message || 'Fleet status check failure';
     } finally {
-      this.executing = false;
+      this.loading = false;
       this.render();
     }
   }
 
-  async runBootstrap() {
-    if (!this.host || this.executing) return;
-    this.executing = true;
-    this.lastResult = null;
+  async executeFleetRefresh() {
+    if (this.loading) return;
+    this.loading = true;
+    this.executionResult = null;
+    this.errorMessage = null;
     this.render();
 
     try {
-      const res = await this.host.run('bootstrap', ['--json']);
-      this.lastResult = {
-        ok: true,
-        message: 'OpenWiki skeleton bootstrapped',
-        data: res
-      };
-      await this.refreshHubs();
+      if (this.host && typeof this.host.run === 'function') {
+        const res = await this.host.run('refresh', ['--apply', '--json']);
+        this.executionResult = {
+          action: 'fleet-refresh',
+          target: 'all-registered-projects',
+          details: res && typeof res === 'object' ? res : { message: String(res || 'Completed') },
+          timestamp: new Date().toLocaleTimeString()
+        };
+        if (res?.reports) {
+          this.refreshReports = res.reports;
+          this.refreshCounts = res.counts;
+        }
+      } else {
+        throw new Error('Host execution context unavailable');
+      }
     } catch (err) {
-      this.lastResult = {
-        ok: false,
-        message: err instanceof Error ? err.message : 'Bootstrap failed'
-      };
+      this.errorMessage = err.message || 'Fleet refresh execution failure';
     } finally {
-      this.executing = false;
+      this.loading = false;
       this.render();
     }
   }
 
+  async executeIngest() {
+    if (this.loading) return;
+    this.loading = true;
+    this.executionResult = null;
+    this.errorMessage = null;
+    this.render();
+
+    const args = [this.targetPath || 'openwiki'];
+    if (this.dryRun) args.push('--dry-run');
+
+    try {
+      if (this.host && typeof this.host.run === 'function') {
+        const res = await this.host.run('ingest', args);
+        this.executionResult = {
+          action: 'ingest',
+          target: this.targetPath,
+          dryRun: this.dryRun,
+          details: res && typeof res === 'object' ? res : { message: String(res || 'Completed') },
+          timestamp: new Date().toLocaleTimeString()
+        };
+      } else {
+        throw new Error('Host execution context unavailable');
+      }
+    } catch (err) {
+      this.errorMessage = err.message || 'Ingestion cycle failure';
+    } finally {
+      this.loading = false;
+      this.refreshHubs();
+    }
+  }
+
+  async executeBootstrap() {
+    if (this.loading) return;
+    this.loading = true;
+    this.executionResult = null;
+    this.errorMessage = null;
+    this.render();
+
+    try {
+      if (this.host && typeof this.host.run === 'function') {
+        const res = await this.host.run('bootstrap', ['--brain', '.', '--json']);
+        this.executionResult = {
+          action: 'bootstrap',
+          details: res && typeof res === 'object' ? res : { message: String(res || 'Completed') },
+          timestamp: new Date().toLocaleTimeString()
+        };
+      } else {
+        throw new Error('Host execution context unavailable');
+      }
+    } catch (err) {
+      this.errorMessage = err.message || 'Bootstrap procedure failure';
+    } finally {
+      this.loading = false;
+      this.refreshHubs();
+    }
+  }
+
+  async executeWatch() {
+    if (this.loading) return;
+    this.loading = true;
+    this.executionResult = null;
+    this.errorMessage = null;
+    this.render();
+
+    try {
+      if (this.host && typeof this.host.run === 'function') {
+        const res = await this.host.run('watch', ['--json']);
+        this.executionResult = {
+          action: 'watch',
+          details: res && typeof res === 'object' ? res : { message: String(res || 'Completed') },
+          timestamp: new Date().toLocaleTimeString()
+        };
+        if (res?.status) {
+          this.upstream = {
+            recordedVersion: res.status.currentVersion,
+            latestVersion: res.status.latestVersion
+          };
+        }
+      } else {
+        throw new Error('Host execution context unavailable');
+      }
+    } catch (err) {
+      this.errorMessage = err.message || 'Upstream surveillance failure';
+    } finally {
+      this.loading = false;
+      this.refreshHubs();
+    }
+  }
+
+  async executePropagate() {
+    if (this.loading) return;
+    this.loading = true;
+    this.executionResult = null;
+    this.errorMessage = null;
+    this.render();
+
+    try {
+      if (this.host && typeof this.host.run === 'function') {
+        const res = await this.host.run('propagate', ['--json']);
+        this.executionResult = {
+          action: 'propagate',
+          details: res && typeof res === 'object' ? res : { message: String(res || 'Completed') },
+          timestamp: new Date().toLocaleTimeString()
+        };
+      } else {
+        throw new Error('Host execution context unavailable');
+      }
+    } catch (err) {
+      this.errorMessage = err.message || 'Fleet propagation failure';
+    } finally {
+      this.loading = false;
+      this.refreshHubs();
+    }
+  }
+
   render() {
-    const root = this.shadowRoot;
-    if (!root) return;
+    if (!this.shadowRoot) return;
+
+    const countText = this.hubs.length ? `${this.hubs.length} Hubs` : '—';
+    const totalLines = this.hubs.reduce((acc, h) => acc + (h.lines || 0), 0);
+    const linesText = this.hubs.length ? `${totalLines.toLocaleString()} Lines` : '—';
+    const upstreamText = this.upstream?.latestVersion ? `v${this.upstream.latestVersion}` : 'Tracking';
 
-    root.innerHTML = `
+    this.shadowRoot.innerHTML = `
       <style>
         :host {
+          display: block;
+          box-sizing: border-box;
           --face-bg: #0f172a;
           --face-surface: #1e293b;
-          --face-line: #334155;
+          --face-surface-subtle: #334155;
+          --face-border: #475569;
           --face-text: #f8fafc;
-          --face-muted: #94a3b8;
-          --face-brand: #3b82f6;
-          --face-brand-hover: #60a5fa;
-          --face-accent: #facc15;
+          --face-text-muted: #94a3b8;
+          --face-accent: #f59e0b;
+          --face-accent-hover: #d97706;
           --face-ok: #10b981;
-          --face-warn: #f59e0b;
           --face-danger: #ef4444;
-          --face-dark: #0f172a;
-
-          display: block;
-          font-family: var(--font-sans, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif);
+          background: var(--face-bg);
           color: var(--text-primary, var(--face-text));
-          background: var(--bg-secondary, var(--face-bg));
-          border: 1px solid var(--border, var(--face-line));
+          border: 1px solid var(--border, var(--face-border));
           border-radius: 8px;
           padding: 16px;
-          box-sizing: border-box;
-          overflow: hidden;
+          font-family: system-ui, -apple-system, sans-serif;
         }
 
-        @media (prefers-reduced-motion: reduce) {
-          *, ::before, ::after {
-            animation-duration: 0.01ms !important;
-            animation-iteration-count: 1 !important;
-            transition-duration: 0.01ms !important;
-          }
+        *, *::before, *::after {
+          box-sizing: inherit;
         }
 
-        /* Header Bar */
-        .header {
+        .header-bar {
           display: flex;
           align-items: center;
           justify-content: space-between;
-          flex-wrap: wrap;
           gap: 12px;
-          padding-bottom: 14px;
-          border-bottom: 1px solid var(--border, var(--face-line));
-          margin-bottom: 16px;
+          margin-bottom: 12px;
+          border-bottom: 1px solid var(--border, var(--face-border));
+          padding-bottom: 12px;
         }
 
-        .brand-group {
+        .brand-cluster {
           display: flex;
           align-items: center;
-          gap: 10px;
+          gap: 8px;
         }
 
         .wordmark-badge {
-          font-family: var(--font-mono, 'JetBrains Mono', monospace);
+          display: inline-flex;
+          align-items: center;
+          font-family: ui-monospace, monospace;
           font-size: 13px;
-          font-weight: 800;
+          font-weight: 700;
           letter-spacing: 0.05em;
-          color: var(--card-accent, var(--face-accent));
-          background: rgba(250, 204, 21, 0.12);
-          padding: 6px 10px;
-          border-radius: 6px;
-          border: 1px solid rgba(250, 204, 21, 0.3);
-        }
-
-        .title-meta {
-          display: flex;
-          flex-direction: column;
+          color: var(--face-accent);
+          background: var(--face-surface-subtle);
+          padding: 4px 8px;
+          border-radius: 4px;
         }
 
-        .plugin-title {
+        .system-title {
           font-size: 14px;
-          font-weight: 700;
+          font-weight: 600;
           color: var(--text-primary, var(--face-text));
-          margin: 0;
         }
 
-        .plugin-subtitle {
+        .status-pill {
+          display: inline-flex;
+          align-items: center;
+          padding: 4px 10px;
+          border-radius: 12px;
           font-size: 11px;
-          color: var(--text-secondary, var(--face-muted));
-          margin: 0;
+          font-weight: 700;
+          letter-spacing: 0.04em;
+          text-transform: uppercase;
+          background: var(--face-surface-subtle);
+          color: var(--face-text-muted);
+          border: 1px solid var(--border, var(--face-border));
+        }
+
+        .status-pill.ok {
+          color: var(--face-ok);
+          border-color: var(--face-ok);
+        }
+
+        .status-pill.danger {
+          color: var(--face-danger);
+          border-color: var(--face-danger);
         }
 
-        .hub-count-chip {
+        .screen-tabs {
           display: flex;
-          align-items: center;
           gap: 6px;
-          font-family: var(--font-mono, 'JetBrains Mono', monospace);
-          font-size: 11px;
-          font-weight: 700;
-          color: var(--face-accent);
-          background: rgba(250, 204, 21, 0.12);
-          border: 1px solid rgba(250, 204, 21, 0.3);
-          padding: 5px 12px;
+          margin-bottom: 16px;
+          border-bottom: 1px solid var(--border, var(--face-border));
+          padding-bottom: 8px;
+          overflow-x: auto;
+        }
+
+        .screen-tab-btn {
+          min-height: 36px;
+          padding: 0 12px;
+          font-size: 12px;
+          font-weight: 600;
           border-radius: 6px;
-          text-transform: uppercase;
+          border: 1px solid transparent;
+          background: transparent;
+          color: var(--face-text-muted);
+          cursor: pointer;
+          transition: all 0.15s ease;
+          display: inline-flex;
+          align-items: center;
+          white-space: nowrap;
         }
 
-        /* Split Layout */
-        .workspace-split {
+        .screen-tab-btn:hover {
+          color: var(--face-text);
+          background: var(--face-surface-subtle);
+        }
+
+        .screen-tab-btn.active {
+          color: var(--face-accent);
+          background: var(--face-surface);
+          border-color: var(--face-accent);
+        }
+
+        .stats-grid {
           display: grid;
-          grid-template-columns: minmax(260px, 1.4fr) minmax(240px, 1fr);
-          gap: 14px;
+          grid-template-columns: repeat(3, 1fr);
+          gap: 8px;
           margin-bottom: 16px;
         }
 
-        @media (max-width: 700px) {
-          .workspace-split {
-            grid-template-columns: 1fr;
-          }
+        .stat-card {
+          background: var(--face-surface);
+          border: 1px solid var(--border, var(--face-border));
+          border-radius: 6px;
+          padding: 10px;
         }
 
-        /* Hub Tree Matrix */
-        .hub-panel {
-          border: 1px solid var(--border, var(--face-line));
-          border-radius: 6px;
-          background: rgba(30, 41, 59, 0.4);
-          padding: 12px;
+        .stat-label {
+          font-size: 11px;
+          text-transform: uppercase;
+          letter-spacing: 0.04em;
+          color: var(--face-text-muted);
+          margin-bottom: 4px;
+        }
+
+        .stat-value {
+          font-size: 16px;
+          font-weight: 700;
+          color: var(--text-primary, var(--face-text));
+          font-family: ui-monospace, monospace;
+        }
+
+        .section-header {
           display: flex;
-          flex-direction: column;
-          gap: 10px;
+          align-items: center;
+          justify-content: space-between;
+          margin-bottom: 8px;
         }
 
-        .panel-title {
-          font-size: 11px;
+        .section-title {
+          font-size: 12px;
           font-weight: 700;
           text-transform: uppercase;
           letter-spacing: 0.05em;
-          color: var(--text-secondary, var(--face-muted));
-          margin: 0;
+          color: var(--face-accent);
         }
 
         .hub-list {
           display: flex;
           flex-direction: column;
           gap: 6px;
-          max-height: 280px;
+          margin-bottom: 16px;
+          max-height: 180px;
           overflow-y: auto;
         }
 
         .hub-item {
-          padding: 10px 12px;
-          background: rgba(15, 23, 42, 0.6);
-          border: 1px solid var(--border, var(--face-line));
-          border-radius: 5px;
           display: flex;
           align-items: center;
           justify-content: space-between;
-          gap: 10px;
-        }
-
-        .hub-main {
-          display: flex;
-          flex-direction: column;
-          gap: 2px;
+          background: var(--face-surface);
+          border: 1px solid var(--border, var(--face-border));
+          border-radius: 6px;
+          padding: 8px 12px;
+          font-size: 13px;
         }
 
         .hub-title {
-          font-family: var(--font-mono, 'JetBrains Mono', monospace);
-          font-size: 12px;
-          font-weight: 700;
+          font-weight: 600;
           color: var(--text-primary, var(--face-text));
         }
 
-        .hub-path {
-          font-size: 10px;
-          color: var(--text-secondary, var(--face-muted));
+        .hub-meta {
+          font-family: ui-monospace, monospace;
+          font-size: 11px;
+          color: var(--face-text-muted);
         }
 
-        .hub-metrics {
+        .empty-state {
           display: flex;
           align-items: center;
-          gap: 6px;
-          font-family: var(--font-mono, 'JetBrains Mono', monospace);
-          font-size: 10px;
-          color: var(--face-accent);
+          justify-content: center;
+          padding: 24px;
+          color: var(--face-text-muted);
+          background: var(--face-surface);
+          border: 1px dashed var(--border, var(--face-border));
+          border-radius: 6px;
+          font-size: 13px;
         }
 
-        /* Ingest Deck Column */
         .ingest-deck {
-          display: flex;
-          flex-direction: column;
-          gap: 10px;
+          background: var(--face-surface);
+          border: 1px solid var(--border, var(--face-border));
+          border-radius: 6px;
+          padding: 12px;
+          margin-bottom: 16px;
         }
 
-        .form-card {
-          border: 1px solid var(--border, var(--face-line));
+        .config-deck {
+          background: var(--face-surface);
+          border: 1px solid var(--border, var(--face-border));
           border-radius: 6px;
-          background: rgba(30, 41, 59, 0.4);
-          padding: 12px;
-          display: flex;
-          flex-direction: column;
-          gap: 10px;
+          padding: 14px;
+          margin-bottom: 16px;
+        }
+
+        .config-grid {
+          display: grid;
+          grid-template-columns: 1fr 1fr;
+          gap: 12px;
+          margin-bottom: 14px;
         }
 
-        .input-row {
+        .field-group {
           display: flex;
           flex-direction: column;
           gap: 4px;
         }
 
-        .input-label {
-          font-size: 10px;
+        .field-group.full-width {
+          grid-column: 1 / -1;
+        }
+
+        .field-label {
+          font-size: 11px;
+          font-weight: 700;
           text-transform: uppercase;
-          color: var(--text-secondary, var(--face-muted));
-          letter-spacing: 0.05em;
+          letter-spacing: 0.04em;
+          color: var(--face-text-muted);
+        }
+
+        .input-group {
+          display: flex;
+          gap: 8px;
+          margin-bottom: 12px;
         }
 
-        .text-input {
+        .path-input, .text-input, .select-input {
           min-height: 44px;
+          background: var(--face-surface-subtle);
+          border: 1px solid var(--border, var(--face-border));
+          border-radius: 6px;
           padding: 8px 12px;
-          font-family: var(--font-mono, 'JetBrains Mono', monospace);
-          font-size: 12px;
           color: var(--text-primary, var(--face-text));
-          background: rgba(15, 23, 42, 0.8);
-          border: 1px solid var(--border, var(--face-line));
-          border-radius: 5px;
-          box-sizing: border-box;
+          font-family: ui-monospace, monospace;
+          font-size: 13px;
           width: 100%;
         }
 
-        .text-input:focus {
+        .path-input:focus, .text-input:focus, .select-input:focus {
           outline: none;
-          border-color: var(--card-accent, var(--face-brand));
+          border-color: var(--face-accent);
         }
 
-        .toggle-row {
+        .presets-bar {
           display: flex;
-          align-items: center;
-          gap: 8px;
+          gap: 6px;
+          flex-wrap: wrap;
+          margin-bottom: 14px;
+        }
+
+        .preset-chip {
+          min-height: 32px;
+          padding: 4px 10px;
+          background: var(--face-surface-subtle);
+          border: 1px solid var(--border, var(--face-border));
+          border-radius: 16px;
           font-size: 11px;
-          color: var(--text-secondary, var(--face-muted));
+          font-family: ui-monospace, monospace;
+          color: var(--face-text);
           cursor: pointer;
+          transition: all 0.15s ease;
+        }
+
+        .preset-chip:hover {
+          border-color: var(--face-accent);
+          color: var(--face-accent);
         }
 
-        .toggle-check {
-          min-height: 20px;
-          min-width: 20px;
+        .auth-notice-card {
+          display: flex;
+          align-items: center;
+          justify-content: space-between;
+          background: #022c22;
+          border: 1px solid var(--face-ok);
+          border-radius: 6px;
+          padding: 10px 14px;
+          margin-bottom: 14px;
+          font-size: 12px;
+          color: #a7f3d0;
+        }
+
+        .toggle-label {
+          display: inline-flex;
+          align-items: center;
+          gap: 8px;
+          min-height: 44px;
+          font-size: 13px;
+          color: var(--text-primary, var(--face-text));
           cursor: pointer;
+          user-select: none;
+          padding: 0 4px;
         }
 
-        .btn-action-primary {
+        .button-group {
+          display: grid;
+          grid-template-columns: repeat(2, 1fr);
+          gap: 8px;
+        }
+
+        .btn {
+          display: inline-flex;
+          align-items: center;
+          justify-content: center;
           min-height: 44px;
-          padding: 8px 16px;
-          font-family: var(--font-sans, sans-serif);
+          padding: 0 12px;
           font-size: 12px;
-          font-weight: 700;
-          color: var(--face-dark);
-          background: var(--face-accent);
-          border: none;
-          border-radius: 5px;
+          font-weight: 600;
+          border-radius: 6px;
+          border: 1px solid transparent;
           cursor: pointer;
-          transition: background 0.15s ease;
+          transition: background-color 0.15s ease, border-color 0.15s ease;
+          text-align: center;
         }
 
-        .btn-action-primary:hover {
-          background: #fde047;
+        .btn-primary {
+          background: var(--face-accent);
+          color: var(--face-bg);
         }
 
-        .btn-action-primary:disabled {
-          opacity: 0.6;
-          cursor: not-allowed;
+        .btn-primary:hover:not(:disabled) {
+          background: var(--face-accent-hover);
         }
 
-        .btn-action-secondary {
-          min-height: 44px;
-          padding: 8px 16px;
-          font-family: var(--font-sans, sans-serif);
-          font-size: 12px;
-          font-weight: 700;
+        .btn-secondary {
+          background: var(--face-surface-subtle);
+          border-color: var(--border, var(--face-border));
           color: var(--text-primary, var(--face-text));
-          background: transparent;
-          border: 1px solid var(--border, var(--face-line));
-          border-radius: 5px;
-          cursor: pointer;
-          transition: background 0.15s ease;
         }
 
-        .btn-action-secondary:hover {
-          background: rgba(255, 255, 255, 0.05);
+        .btn-secondary:hover:not(:disabled) {
+          border-color: var(--face-accent);
         }
 
-        .feedback-banner {
-          padding: 8px 12px;
-          border-radius: 5px;
-          font-family: var(--font-mono, 'JetBrains Mono', monospace);
-          font-size: 11px;
+        .btn:disabled {
+          opacity: 0.5;
+          cursor: not-allowed;
         }
 
-        .feedback-ok {
-          background: rgba(16, 185, 129, 0.15);
-          border: 1px solid rgba(16, 185, 129, 0.4);
-          color: var(--face-ok);
+        .result-deck {
+          background: var(--face-surface-subtle);
+          border: 1px solid var(--border, var(--face-border));
+          border-radius: 6px;
+          padding: 12px;
+          font-family: ui-monospace, monospace;
+          font-size: 12px;
+          color: var(--text-primary, var(--face-text));
+          margin-top: 12px;
         }
 
-        .feedback-fail {
-          background: rgba(239, 68, 68, 0.15);
-          border: 1px solid rgba(239, 68, 68, 0.4);
-          color: var(--face-danger);
+        .result-title {
+          font-weight: 600;
+          color: var(--face-accent);
+          margin-bottom: 6px;
         }
 
-        .empty-hubs {
-          padding: 32px 16px;
-          text-align: center;
+        .error-deck {
+          background: var(--face-surface);
+          border: 1px solid var(--face-danger);
+          border-radius: 6px;
+          padding: 12px;
+          color: var(--face-danger);
           font-size: 12px;
-          color: var(--text-secondary, var(--face-muted));
+          margin-bottom: 12px;
         }
 
-        /* Footer Telemetry */
-        .footer-bar {
-          display: flex;
-          justify-content: space-between;
+        .repo-status-badge {
+          display: inline-flex;
           align-items: center;
-          padding-top: 12px;
-          margin-top: 14px;
-          border-top: 1px solid var(--border, var(--face-line));
+          padding: 2px 6px;
+          border-radius: 4px;
           font-size: 10px;
-          color: var(--text-secondary, var(--face-muted));
+          font-weight: 700;
+          letter-spacing: 0.04em;
+          text-transform: uppercase;
+        }
+
+        .repo-status-badge.current {
+          background: #064e3b;
+          color: #6ee7b7;
+        }
+
+        .repo-status-badge.due {
+          background: #78350f;
+          color: #fde68a;
+        }
+
+        .repo-status-badge.uninit {
+          background: #831843;
+          color: #fbcfe8;
+        }
+
+        @media (prefers-reduced-motion: reduce) {
+          *, *::before, *::after {
+            animation-duration: 0.01ms !important;
+            animation-iteration-count: 1 !important;
+            transition-duration: 0.01ms !important;
+            scroll-behavior: auto !important;
+          }
         }
       </style>
 
-      <div class="header">
-        <div class="brand-group">
-          <div class="wordmark-badge">[BRAIN//DUMP]</div>
-          <div class="title-meta">
-            <h3 class="plugin-title">OpenWiki Knowledge Graph</h3>
-            <p class="plugin-subtitle">Multi-repository documentation and knowledge ingestion engine</p>
+      <div class="header-bar">
+        <div class="brand-cluster">
+          <span class="wordmark-badge">[BRAIN//DUMP]</span>
+          <span class="system-title">Knowledge Graph Engine</span>
+        </div>
+        <span class="status-pill ${this.statusText === 'SYNCHRONIZED' ? 'ok' : this.statusText === 'ERROR' ? 'danger' : ''}">
+          ${this.statusText}
+        </span>
+      </div>
+
+      <nav class="screen-tabs" aria-label="OpenWiki navigation screens">
+        ${OpenWikiCard.screens.map((screen) => `
+          <button
+            class="screen-tab-btn ${this.activeScreen === screen.id ? 'active' : ''}"
+            data-screen="${screen.id}"
+          >
+            ${screen.label}
+          </button>
+        `).join('')}
+      </nav>
+
+      <div class="stats-grid">
+        <div class="stat-card">
+          <div class="stat-label">Discovered Hubs</div>
+          <div class="stat-value">${countText}</div>
+        </div>
+        <div class="stat-card">
+          <div class="stat-label">Documentation Lines</div>
+          <div class="stat-value">${linesText}</div>
+        </div>
+        <div class="stat-card">
+          <div class="stat-label">Active Model Routing</div>
+          <div class="stat-value" style="font-size: 12px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis;" title="${this.config.model}">
+            ${this.config.model.split('/').pop() || this.config.model}
           </div>
         </div>
-        <div class="hub-count-chip">
-          ${this.hubs.length > 0 ? `${this.hubs.length} Hubs Indexed` : 'No Hubs'}
+      </div>
+
+      ${this.errorMessage ? `
+        <div class="error-deck">
+          ${this.errorMessage}
+        </div>
+      ` : ''}
+
+      ${this.renderActiveScreen()}
+
+      ${this.executionResult ? `
+        <div class="result-deck">
+          <div class="result-title">Execution Receipt (${this.executionResult.timestamp})</div>
+          <div>Action: ${this.executionResult.action}</div>
+          <div>Target: ${this.executionResult.target || 'project'}</div>
+          <div>Result: ${JSON.stringify(this.executionResult.details)}</div>
         </div>
+      ` : ''}
+    `;
+
+    this.bindEvents();
+  }
+
+  renderActiveScreen() {
+    if (this.activeScreen === 'config') {
+      return this.renderConfigScreen();
+    }
+    if (this.activeScreen === 'refresh') {
+      return this.renderRefreshScreen();
+    }
+    if (this.activeScreen === 'upstream') {
+      return this.renderUpstreamScreen();
+    }
+    return this.renderHubsScreen();
+  }
+
+  renderHubsScreen() {
+    return `
+      <div class="section-header">
+        <span class="section-title">Knowledge Hubs</span>
+        <button id="btn-refresh" class="btn btn-secondary" style="min-height: 32px; padding: 0 10px; font-size: 11px;" ${this.loading ? 'disabled' : ''}>
+          Sync
+        </button>
       </div>
 
-      <div class="workspace-split">
-        <div class="hub-panel">
-          <h4 class="panel-title">Verified Documentation Hubs</h4>
-          <div class="hub-list">
-            ${this.hubs.length > 0 ? this.hubs.map(h => `
-              <div class="hub-item">
-                <div class="hub-main">
-                  <span class="hub-title">${escapeHtml(h.title || h.path)}</span>
-                  <span class="hub-path">${escapeHtml(h.path)}</span>
-                </div>
-                <div class="hub-metrics">
-                  <span>${h.lines !== undefined ? `${h.lines} lines` : DASH}</span>
-                </div>
-              </div>
-            `).join('') : `
-              <div class="empty-hubs">No markdown documentation hubs indexed yet. Click Bootstrap below to initialize.</div>
-            `}
+      <div class="hub-list">
+        ${this.hubs.length === 0 ? `
+          <div class="empty-state">No documentation hubs indexed in ${this.targetPath}</div>
+        ` : this.hubs.map((h) => `
+          <div class="hub-item">
+            <span class="hub-title">${h.title}</span>
+            <span class="hub-meta">${h.lines} lines · ${h.path}</span>
           </div>
+        `).join('')}
+      </div>
+
+      <div class="ingest-deck">
+        <div class="input-group">
+          <input
+            id="target-path-input"
+            class="path-input"
+            type="text"
+            value="${this.targetPath}"
+            placeholder="Directory path (openwiki)"
+            aria-label="Target documentation path"
+          />
+          <label class="toggle-label">
+            <input
+              id="dry-run-checkbox"
+              type="checkbox"
+              ${this.dryRun ? 'checked' : ''}
+            />
+            Dry Run
+          </label>
         </div>
 
-        <div class="ingest-deck">
-          <div class="form-card">
-            <h4 class="panel-title">Knowledge Ingest</h4>
-            <div class="input-row">
-              <span class="input-label">Target Hub Path</span>
-              <input class="text-input" type="text" id="input-path" placeholder="openwiki" />
-            </div>
-            <label class="toggle-row">
-              <input class="toggle-check" type="checkbox" id="check-dryrun" ${this.dryRun ? 'checked' : ''} />
-              <span>Dry Run (Preview changes without writing)</span>
-            </label>
-            <button class="btn-action-primary" type="button" id="btn-ingest" ${this.executing ? 'disabled' : ''}>
-              ${this.executing ? 'Processing...' : 'Run Ingestion'}
-            </button>
-            <button class="btn-action-secondary" type="button" id="btn-bootstrap" ${this.executing ? 'disabled' : ''}>
-              Bootstrap OpenWiki Skeleton
-            </button>
+        <div class="button-group">
+          <button id="btn-ingest" class="btn btn-primary" ${this.loading ? 'disabled' : ''}>
+            ${this.loading ? 'Processing…' : 'Ingest Documentation'}
+          </button>
+          <button id="btn-bootstrap" class="btn btn-secondary" ${this.loading ? 'disabled' : ''}>
+            Bootstrap Wiki
+          </button>
+        </div>
+      </div>
+    `;
+  }
+
+  renderConfigScreen() {
+    return `
+      <div class="config-deck">
+        <div class="section-header">
+          <span class="section-title">Documentation Model & Provider Routing</span>
+        </div>
+
+        <div class="auth-notice-card">
+          <span>✓ Model credentials routed via Total Recall Auth store (<code>total-recall auth secret</code>)</span>
+          <span style="font-family: ui-monospace, monospace; font-size: 10px;">AUTH_PLUGIN: ACTIVE</span>
+        </div>
+
+        <div class="field-label" style="margin-bottom: 6px;">Recommended Model Presets:</div>
+        <div class="presets-bar">
+          <button class="preset-chip" data-provider="openrouter" data-model="deepseek/deepseek-v4.1-flash" data-fallback="qwen/qwen-2.5-coder-32b-instruct">
+            DeepSeek V4.1 Flash ($0.025/1M)
+          </button>
+          <button class="preset-chip" data-provider="openrouter" data-model="qwen/qwen-2.5-coder-32b-instruct" data-fallback="deepseek/deepseek-v4.1-flash">
+            Qwen 2.5 Coder 32B ($0.06/1M)
+          </button>
+          <button class="preset-chip" data-provider="google" data-model="gemini-2.5-flash-lite" data-fallback="gemini-2.5-flash">
+            Gemini 2.5 Flash-Lite ($0.075/1M)
+          </button>
+        </div>
+
+        <div class="config-grid">
+          <div class="field-group">
+            <label class="field-label" for="cfg-provider">Provider</label>
+            <select id="cfg-provider" class="select-input">
+              <option value="openrouter" ${this.config.provider === 'openrouter' ? 'selected' : ''}>OpenRouter (Multi-Model Hub)</option>
+              <option value="google" ${this.config.provider === 'google' ? 'selected' : ''}>Google (Gemini Direct)</option>
+              <option value="custom" ${this.config.provider === 'custom' ? 'selected' : ''}>Custom Provider</option>
+            </select>
           </div>
 
-          ${this.lastResult ? `
-            <div class="feedback-banner ${this.lastResult.ok ? 'feedback-ok' : 'feedback-fail'}">
-              ${escapeHtml(this.lastResult.message)}
-            </div>
-          ` : ''}
+          <div class="field-group">
+            <label class="field-label" for="cfg-model">Primary Model Identifier</label>
+            <input id="cfg-model" class="text-input" type="text" value="${this.config.model}" placeholder="e.g. deepseek/deepseek-v4.1-flash" />
+          </div>
+
+          <div class="field-group">
+            <label class="field-label" for="cfg-fallback">Fallback Model Identifier</label>
+            <input id="cfg-fallback" class="text-input" type="text" value="${this.config.fallback_model}" placeholder="e.g. qwen/qwen-2.5-coder-32b-instruct" />
+          </div>
+
+          <div class="field-group">
+            <label class="field-label" for="cfg-tokens">Max Output Tokens</label>
+            <input id="cfg-tokens" class="text-input" type="number" value="${this.config.max_tokens}" min="512" max="131072" />
+          </div>
+
+          <div class="field-group full-width">
+            <label class="field-label" for="cfg-timeout">Timeout (milliseconds)</label>
+            <input id="cfg-timeout" class="text-input" type="number" value="${this.config.timeout_ms}" min="30000" max="1800000" />
+          </div>
+        </div>
+
+        <div class="button-group">
+          <button id="btn-save-config" class="btn btn-primary" ${this.loading ? 'disabled' : ''}>
+            Save Configuration
+          </button>
+          <button id="btn-reset-config" class="btn btn-secondary" ${this.loading ? 'disabled' : ''}>
+            Reset to Defaults
+          </button>
         </div>
       </div>
+    `;
+  }
+
+  renderRefreshScreen() {
+    const dueCount = this.refreshCounts?.due ?? this.refreshReports.filter((r) => r.action === 'due').length;
+    const uninitCount = this.refreshCounts?.uninitialized ?? this.refreshReports.filter((r) => r.uninitialized).length;
+
+    return `
+      <div class="ingest-deck">
+        <div class="section-header">
+          <span class="section-title">Fleet Documentation Governance</span>
+          <button id="btn-sync-refresh" class="btn btn-secondary" style="min-height: 32px; padding: 0 10px; font-size: 11px;" ${this.loading ? 'disabled' : ''}>
+            Check Fleet
+          </button>
+        </div>
 
-      <div class="footer-bar">
-        <span>Engine: OpenWiki v0.1.2</span>
-        <span>Storage: Markdown + SSSS Projections</span>
+        <div style="font-size: 12px; color: var(--face-text-muted); margin-bottom: 12px;">
+          Registered Projects: <strong>${this.refreshReports.length}</strong> · Due for Update: <strong>${dueCount}</strong> · Uninitialized: <strong>${uninitCount}</strong>
+        </div>
+
+        <div class="hub-list" style="max-height: 240px;">
+          ${this.refreshReports.length === 0 ? `
+            <div class="empty-state">No fleet report loaded. Click Check Fleet to inspect registered repositories.</div>
+          ` : this.refreshReports.map((r) => {
+            let badgeClass = 'current';
+            let badgeText = 'CURRENT';
+            if (r.uninitialized) {
+              badgeClass = 'uninit';
+              badgeText = 'MISSING WIKI';
+            } else if (r.action === 'due') {
+              badgeClass = 'due';
+              badgeText = 'DUE';
+            }
+            return `
+              <div class="hub-item">
+                <div>
+                  <span class="hub-title">${r.name}</span>
+                  <div class="hub-meta">${r.generatedAt ? `Generated ${r.generatedAt.slice(0, 10)}` : 'Never generated'} · ${r.commitsSince ? `${r.commitsSince} commits behind` : 'Up to date'}</div>
+                </div>
+                <span class="repo-status-badge ${badgeClass}">${badgeText}</span>
+              </div>
+            `;
+          }).join('')}
+        </div>
+
+        <div style="margin-top: 12px;">
+          <button id="btn-fleet-refresh-apply" class="btn btn-primary" style="width: 100%;" ${this.loading ? 'disabled' : ''}>
+            ${this.loading ? 'Executing Fleet Refresh…' : `Regenerate Stale & Initialize Missing Wikis (${dueCount} due)`}
+          </button>
+        </div>
       </div>
     `;
+  }
+
+  renderUpstreamScreen() {
+    const currentVer = this.upstream?.recordedVersion || '0.7.2';
+    const latestVer = this.upstream?.latestVersion || '0.7.3';
+
+    return `
+      <div class="ingest-deck">
+        <div class="section-header">
+          <span class="section-title">Upstream Package Surveillance</span>
+        </div>
+
+        <div class="stats-grid" style="margin-bottom: 14px;">
+          <div class="stat-card">
+            <div class="stat-label">Recorded Version</div>
+            <div class="stat-value">v${currentVer}</div>
+          </div>
+          <div class="stat-card">
+            <div class="stat-label">Latest Registry</div>
+            <div class="stat-value">v${latestVer}</div>
+          </div>
+          <div class="stat-card">
+            <div class="stat-label">Watcher Status</div>
+            <div class="stat-value" style="color: var(--face-ok);">MONITORING</div>
+          </div>
+        </div>
+
+        <div class="button-group">
+          <button id="btn-watch" class="btn btn-secondary" ${this.loading ? 'disabled' : ''}>
+            Check Upstream Registry
+          </button>
+          <button id="btn-propagate" class="btn btn-primary" ${this.loading ? 'disabled' : ''}>
+            Propagate Latest Generator
+          </button>
+        </div>
+      </div>
+    `;
+  }
+
+  bindEvents() {
+    const shadow = this.shadowRoot;
+    if (!shadow) return;
 
-    // Event listeners
-    const pathInput = root.querySelector('#input-path');
+    shadow.querySelectorAll('.screen-tab-btn').forEach((tab) => {
+      tab.addEventListener('click', () => {
+        const targetScreen = tab.getAttribute('data-screen');
+        if (targetScreen) this.setScreen(targetScreen);
+      });
+    });
+
+    const pathInput = shadow.querySelector('#target-path-input');
     if (pathInput) {
-      pathInput.value = this.targetPath;
-      pathInput.addEventListener('input', e => {
-        this.targetPath = e.target.value;
+      pathInput.addEventListener('input', (e) => {
+        this.targetPath = e.target.value.trim();
       });
     }
 
-    const dryRunCheck = root.querySelector('#check-dryrun');
-    if (dryRunCheck) {
-      dryRunCheck.addEventListener('change', e => {
+    const dryRunCheckbox = shadow.querySelector('#dry-run-checkbox');
+    if (dryRunCheckbox) {
+      dryRunCheckbox.addEventListener('change', (e) => {
         this.dryRun = e.target.checked;
       });
     }
 
-    root.querySelector('#btn-ingest')?.addEventListener('click', () => this.runIngest());
-    root.querySelector('#btn-bootstrap')?.addEventListener('click', () => this.runBootstrap());
+    const btnIngest = shadow.querySelector('#btn-ingest');
+    if (btnIngest) {
+      btnIngest.addEventListener('click', () => this.executeIngest());
+    }
+
+    const btnBootstrap = shadow.querySelector('#btn-bootstrap');
+    if (btnBootstrap) {
+      btnBootstrap.addEventListener('click', () => this.executeBootstrap());
+    }
+
+    const btnRefresh = shadow.querySelector('#btn-refresh');
+    if (btnRefresh) {
+      btnRefresh.addEventListener('click', () => this.refreshHubs());
+    }
+
+    const btnSyncRefresh = shadow.querySelector('#btn-sync-refresh');
+    if (btnSyncRefresh) {
+      btnSyncRefresh.addEventListener('click', () => this.loadRefreshReport());
+    }
+
+    const btnFleetApply = shadow.querySelector('#btn-fleet-refresh-apply');
+    if (btnFleetApply) {
+      btnFleetApply.addEventListener('click', () => this.executeFleetRefresh());
+    }
+
+    const btnWatch = shadow.querySelector('#btn-watch');
+    if (btnWatch) {
+      btnWatch.addEventListener('click', () => this.executeWatch());
+    }
+
+    const btnPropagate = shadow.querySelector('#btn-propagate');
+    if (btnPropagate) {
+      btnPropagate.addEventListener('click', () => this.executePropagate());
+    }
+
+    shadow.querySelectorAll('.preset-chip').forEach((chip) => {
+      chip.addEventListener('click', async () => {
+        const p = chip.getAttribute('data-provider');
+        const m = chip.getAttribute('data-model');
+        const f = chip.getAttribute('data-fallback');
+        if (p) await this.setConfigValue('provider', p);
+        if (m) await this.setConfigValue('model', m);
+        if (f) await this.setConfigValue('fallback_model', f);
+      });
+    });
+
+    const btnSaveConfig = shadow.querySelector('#btn-save-config');
+    if (btnSaveConfig) {
+      btnSaveConfig.addEventListener('click', async () => {
+        const provider = shadow.querySelector('#cfg-provider')?.value;
+        const model = shadow.querySelector('#cfg-model')?.value;
+        const fallback = shadow.querySelector('#cfg-fallback')?.value;
+        const tokens = shadow.querySelector('#cfg-tokens')?.value;
+        const timeout = shadow.querySelector('#cfg-timeout')?.value;
+
+        if (provider) await this.setConfigValue('provider', provider);
+        if (model) await this.setConfigValue('model', model);
+        if (fallback) await this.setConfigValue('fallback_model', fallback);
+        if (tokens) await this.setConfigValue('max_tokens', tokens);
+        if (timeout) await this.setConfigValue('timeout_ms', timeout);
+      });
+    }
+
+    const btnResetConfig = shadow.querySelector('#btn-reset-config');
+    if (btnResetConfig) {
+      btnResetConfig.addEventListener('click', () => this.resetConfig());
+    }
   }
 }