total-recall-brain 3.40.1 → 3.40.2

package/scaffold/.agent/skills/total-recall/plugins/code-quality/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "tr-plugin-code-quality",
+  "version": "0.2.1",
+  "type": "module",
+  "description": "Total Recall code-quality plugin: shared gate runner core and per-repo gate configuration.",
+  "license": "MIT",
+  "scripts": {
+    "test": "node --test test/*.test.mjs",
+    "ssss": "ssss",
+    "export": "ssss export vault --profile sale --out dist/bundle.ucw.json",
+    "validate": "ssss conformance --engine"
+  },
+  "dependencies": {
+    "@gregiteen/ssss-cli": "0.11.2"
+  },
+  "files": [
+    "cli.mjs",
+    "plugin.json",
+    "README.md",
+    "LICENSE",
+    "core/",
+    "commands/",
+    "ui/"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

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

@@ -0,0 +1,186 @@
+{
+  "$schema": "https://github.com/gregiteen/total-recall/blob/main/metadata.plugin.schema.json",
+  "id": "code-quality",
+  "name": "Code Quality Gates",
+  "version": "0.2.1",
+  "description": "Fail-closed deterministic code-quality gates, lint rules, and test compliance reporting.",
+  "author": "Total Recall contributors",
+  "license": "MIT",
+  "use_cases": [
+    "software-development"
+  ],
+  "cli": {
+    "command": "code-quality",
+    "handler": "./cli.mjs",
+    "subcommands": [
+      {
+        "name": "report",
+        "description": "Print the latest gate report (views: worst, type, file, count, raw, json); never starts a check",
+        "effect": "read"
+      },
+      {
+        "name": "snapshot",
+        "description": "Copy the exact source under test (git file lists of this repo and linked plugin repos, secrets refused) to the test node, with a SHA-256 manifest",
+        "effect": "write"
+      },
+      {
+        "name": "gate",
+        "description": "List, add or remove this repository's gates (validated, recorded in the project vault)",
+        "effect": "write"
+      },
+      {
+        "name": "config",
+        "description": "Get, set, validate, check, rebuild or import the repo-layer config",
+        "effect": "write"
+      },
+      {
+        "name": "detect",
+        "description": "Propose gates from the repository (--apply to record them)",
+        "effect": "write"
+      },
+      {
+        "name": "init",
+        "description": "Create the repo-layer config from defaults, detection and prompts",
+        "effect": "write"
+      }
+    ]
+  },
+  "commands": [
+    {
+      "name": "code-quality-check",
+      "handler": "./commands/check.mjs",
+      "description": "Run this repo's gates once and write reports/latest.json (--tier fast|full|remote, --only <id>).",
+      "background": true
+    },
+    {
+      "name": "code-quality-report",
+      "handler": "./commands/report.mjs",
+      "description": "Read the latest gate report and whether it is still current."
+    }
+  ],
+  "ui": {
+    "elements": [
+      {
+        "id": "code-quality-report",
+        "kind": "panel",
+        "tag": "code-quality-report",
+        "module": "ui/code-quality-report.mjs",
+        "description": "Latest gate report with honest status: revision, coverage, skipped gates, timings, stale/missing/infrastructure errors. Data comes from `code-quality report json`.",
+        "props": {
+          "view": {
+            "type": "object",
+            "description": "JSON printed by `total-recall code-quality report json`. Absent view renders as no data, never as passing."
+          }
+        },
+        "events": [
+          "run-check",
+          "reload"
+        ],
+        "optional_tokens": [
+          "font-body",
+          "color-text",
+          "color-border",
+          "color-surface",
+          "color-success",
+          "color-warning",
+          "color-danger",
+          "radius-md",
+          "space-4"
+        ]
+      },
+      {
+        "id": "card",
+        "kind": "card",
+        "tag": "tr-code-quality-card",
+        "module": "ui/card.js",
+        "description": "Gatekeeper Card Face"
+      }
+    ]
+  },
+  "card_face": {
+    "skin": "winamp-classic",
+    "theme": "vibrant",
+    "headline": "Deterministic Code Gates & Lint",
+    "primary_color": "#06b6d4",
+    "secondary_color": "#164e63",
+    "accent_color": "#22d3ee",
+    "touch_layout": "comfortable",
+    "interactive": true,
+    "quick_actions": [
+      {
+        "subcommand": "report",
+        "label": "REPORT"
+      },
+      {
+        "subcommand": "gate",
+        "label": "GATE"
+      },
+      {
+        "subcommand": "config",
+        "label": "CONFIG"
+      },
+      {
+        "subcommand": "detect",
+        "label": "DETECT"
+      }
+    ]
+  },
+  "auth": {
+    "plugin": "auth",
+    "methods": [
+      "passkey",
+      "google-oauth2"
+    ],
+    "session_verification": true
+  },
+  "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"
+    ]
+  },
+  "branding": {
+    "name": "Code Quality Gates",
+    "color": "#eab308",
+    "badge": "Quality Gate",
+    "font": "space-grotesk"
+  },
+  "status": {
+    "command": "report",
+    "refresh_seconds": 30
+  },
+  "distribution": {
+    "tier": "official",
+    "license": "open"
+  },
+  "card_layout": {
+    "template": "workbench",
+    "regions": [
+      {
+        "widget": "status",
+        "title": "Status"
+      },
+      {
+        "widget": "live",
+        "title": "Live view"
+      },
+      {
+        "widget": "actions",
+        "title": "Commands"
+      },
+      {
+        "widget": "activity",
+        "title": "Recent activity"
+      }
+    ]
+  }
+}

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

@@ -0,0 +1,18 @@
+# DESIGN.md — Nitpicker
+
+```yaml
+tokens:
+  brand-name: "Nitpicker"
+  wordmark: "[NIT//PICKER]"
+  color-primary: "#eab308"
+  color-background: "#0f172a"
+  color-accent: "#38bdf8"
+  badge: "Fail-Closed Gates"
+  font-mono: "'JetBrains Mono', 'Fira Code', monospace"
+  border-radius: "8px"
+```
+
+## Brand & Typographic Wordmark
+- **Name**: Nitpicker
+- **Wordmark Logo**: `[NIT//PICKER]` (custom typographic badge, no generic icons)
+- **Palette**: Primary `#eab308`, Surface `#0f172a`, Accent `#38bdf8`.

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

@@ -0,0 +1,272 @@
+/**
+ * Code Quality Gates — Deterministic Quality Gate Engine
+ * Bespoke Animated Web Component Card Face with Live Gate Waveform Visualizer.
+ *
+ * Zero emojis, authentic commercial brand identity, touch-first ergonomics (>=44px).
+ */
+
+export class CodeQualityCard extends HTMLElement {
+  constructor() {
+    super();
+    this.status = 'Idle';
+    this.passRate = '100%';
+    this.activeGate = 'Lint & Typecheck';
+    this.executing = false;
+  }
+
+  connectedCallback() {
+    this.attachShadow({ mode: 'open' });
+    this.render();
+    this.initWaveformAnimation();
+  }
+
+  async execute(action, args = []) {
+    const out = this.shadowRoot.querySelector('#card-out');
+    const statusBadge = this.shadowRoot.querySelector('#status-badge');
+    if (out) out.textContent = `[GATE CONTROLLER] Executing ${action.toUpperCase()}...`;
+    if (statusBadge) statusBadge.textContent = 'RUNNING';
+    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 (statusBadge) statusBadge.textContent = 'PASS';
+    } catch (err) {
+      if (out) out.textContent = `[GATE FAILURE] ${err.message}`;
+      if (statusBadge) statusBadge.textContent = 'FAIL';
+    } finally {
+      this.executing = false;
+    }
+  }
+
+  initWaveformAnimation() {
+    const canvas = this.shadowRoot.querySelector('#qa-canvas');
+    if (!canvas) return;
+    const ctx = canvas.getContext('2d');
+    if (!ctx) return;
+
+    let offset = 0;
+    const draw = () => {
+      if (!this.isConnected) return;
+      ctx.clearRect(0, 0, canvas.width, canvas.height);
+
+      const w = canvas.width;
+      const h = canvas.height;
+      const mid = h / 2;
+
+      // Coordinate grid lines
+      ctx.strokeStyle = 'rgba(234, 179, 8, 0.12)';
+      ctx.lineWidth = 1;
+      ctx.beginPath();
+      for (let x = 0; x < w; x += 20) {
+        ctx.moveTo(x, 0);
+        ctx.lineTo(x, h);
+      }
+      for (let y = 0; y < h; y += 15) {
+        ctx.moveTo(0, y);
+        ctx.lineTo(w, y);
+      }
+      ctx.stroke();
+
+      // Quality signal waveform
+      ctx.beginPath();
+      ctx.moveTo(0, mid);
+      for (let x = 0; x < w; x++) {
+        const freq = this.executing ? 0.08 : 0.04;
+        const amp = this.executing ? 18 : 10;
+        const y = mid + Math.sin((x + offset) * freq) * Math.cos((x + offset) * 0.02) * amp;
+        ctx.lineTo(x, y);
+      }
+      ctx.strokeStyle = this.executing ? '#38bdf8' : '#eab308';
+      ctx.lineWidth = 2;
+      ctx.shadowColor = ctx.strokeStyle;
+      ctx.shadowBlur = 8;
+      ctx.stroke();
+      ctx.shadowBlur = 0;
+
+      // Pulse scan head
+      const scanX = (offset * 1.5) % w;
+      ctx.fillStyle = '#fef08a';
+      ctx.beginPath();
+      ctx.arc(scanX, mid, 3, 0, Math.PI * 2);
+      ctx.fill();
+
+      offset += this.executing ? 3 : 1;
+      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: #090d16;
+          color: #fef9c3;
+          border-radius: 8px;
+          border: 1px solid rgba(234, 179, 8, 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: #fef08a;
+          margin: 0;
+        }
+        .subtitle {
+          font-size: 11px;
+          color: #a1a1aa;
+          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: #eab308;
+          background: rgba(234, 179, 8, 0.12);
+          border: 1px solid rgba(234, 179, 8, 0.3);
+          border-radius: 4px;
+          padding: 4px 8px;
+        }
+        .visual-display {
+          position: relative;
+          background: #030712;
+          border: 1px solid rgba(234, 179, 8, 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(234, 179, 8, 0.15);
+          font-family: monospace;
+          font-size: 11px;
+          color: #d4d4d8;
+        }
+        .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(234, 179, 8, 0.08);
+          border: 1px solid rgba(234, 179, 8, 0.25);
+          color: #fef08a;
+          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(234, 179, 8, 0.18);
+          border-color: rgba(234, 179, 8, 0.5);
+        }
+        .touch-btn:active {
+          transform: translateY(1px);
+        }
+        .output-box {
+          background: #020617;
+          border: 1px solid rgba(234, 179, 8, 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: #94a3b8;
+          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">Code Quality Gates</h2>
+          <p class="subtitle">Deterministic Gate Enforcement Engine</p>
+        </div>
+        <div id="status-badge" class="badge">READY</div>
+      </div>
+
+      <div class="visual-display">
+        <canvas id="qa-canvas" width="340" height="64"></canvas>
+        <div class="telemetry-row">
+          <span>Gate: Strict Pass/Fail</span>
+          <span>Coverage: 100%</span>
+        </div>
+      </div>
+
+      <div class="actions-grid">
+        <button id="btn-status" class="touch-btn" type="button">Audit</button>
+        <button id="btn-lint" class="touch-btn" type="button">Lint</button>
+        <button id="btn-test" class="touch-btn" type="button">Gates</button>
+      </div>
+
+      <div id="card-out" class="output-box">Quality monitoring telemetry active. All gates operational.</div>
+    `;
+
+    this.shadowRoot.querySelector('#btn-status')?.addEventListener('click', () => {
+      this.execute('status');
+    });
+    this.shadowRoot.querySelector('#btn-lint')?.addEventListener('click', () => {
+      this.execute('check');
+    });
+    this.shadowRoot.querySelector('#btn-test')?.addEventListener('click', () => {
+      this.execute('run');
+    });
+  }
+}
+
+if (!customElements.get('tr-code-quality-card')) {
+  customElements.define('tr-code-quality-card', CodeQualityCard);
+}

package/scaffold/.agent/skills/total-recall/plugins/code-quality/ui/code-quality-report.mjs

@@ -0,0 +1,129 @@
+/**
+ * <code-quality-report> — renders a code-quality report view.
+ *
+ * The host sets `view` to the JSON printed by `code-quality report json`
+ * (core/report-data.mjs). Nothing here is computed locally: every number is a
+ * field of that view, and a missing/unreadable/stale/partial view never renders
+ * as passing. With no view set the element says so instead of showing data.
+ *
+ * Events (host runs the named plugin command, then sets a fresh `view`):
+ *   run-check  detail { command: 'code-quality-check', args: ['--tier', tier] }
+ *   reload     detail { command: 'code-quality-report', args: ['json'] }
+ */
+const STATUS_LABEL = {
+  clean: 'Clean',
+  partial: 'Partial coverage',
+  'unknown-freshness': 'Freshness unknown',
+  stale: 'Stale',
+  'zero-scope': 'Zero scope',
+  failed: 'Failed',
+  'unparsed-failure': 'Failed (unparsed)',
+  infrastructure: 'Infrastructure failure',
+  unreadable: 'Report unreadable',
+  missing: 'No report',
+};
+
+const STYLE = `
+:host { display: block; font: var(--font-body, inherit); color: var(--color-text, inherit); }
+.card { border: 1px solid var(--color-border, currentColor); border-radius: var(--radius-md, 6px); padding: var(--space-4, 16px); background: var(--color-surface, transparent); }
+.status { font-weight: 600; font-size: 1.1em; }
+.status[data-status="clean"] { color: var(--color-success, inherit); }
+.status[data-status="partial"], .status[data-status="stale"], .status[data-status="unknown-freshness"], .status[data-status="zero-scope"] { color: var(--color-warning, inherit); }
+.status[data-status="failed"], .status[data-status="unparsed-failure"], .status[data-status="infrastructure"], .status[data-status="unreadable"], .status[data-status="missing"] { color: var(--color-danger, inherit); }
+dl { display: grid; grid-template-columns: max-content 1fr; gap: 4px 16px; margin: 12px 0; }
+dt { opacity: .7; } dd { margin: 0; overflow-wrap: anywhere; }
+table { width: 100%; border-collapse: collapse; margin: 8px 0; }
+th, td { text-align: left; padding: 4px 8px; border-bottom: 1px solid var(--color-border, currentColor); }
+ul { margin: 8px 0; padding-left: 20px; }
+button { font: inherit; margin-right: 8px; cursor: pointer; }
+`;
+
+function el(tag, props = {}, ...children) {
+  const node = document.createElement(tag);
+  for (const [k, v] of Object.entries(props)) {
+    if (k === 'text') node.textContent = v;
+    else if (k.startsWith('data-')) node.setAttribute(k, v);
+    else node[k] = v;
+  }
+  for (const c of children) if (c) node.append(c);
+  return node;
+}
+
+function fmtMs(ms) {
+  return typeof ms === 'number' ? `${(ms / 1000).toFixed(1)}s` : 'unknown';
+}
+
+function fmtAge(ms) {
+  if (typeof ms !== 'number') return 'unknown';
+  const min = Math.round(ms / 60000);
+  return min < 1 ? 'under a minute ago' : min < 120 ? `${min} min ago` : `${Math.round(min / 60)} h ago`;
+}
+
+export class CodeQualityReport extends HTMLElement {
+  #view = null;
+  #root = null;
+
+  connectedCallback() {
+    this.#root ||= this.attachShadow({ mode: 'open' });
+    this.#render();
+  }
+
+  get view() { return this.#view; }
+  set view(value) {
+    this.#view = value && typeof value === 'object' ? value : null;
+    if (this.#root) this.#render();
+  }
+
+  #emit(name, detail) {
+    this.dispatchEvent(new CustomEvent(name, { detail, bubbles: true, composed: true }));
+  }
+
+  #render() {
+    const v = this.#view;
+    const card = el('div', { className: 'card' });
+    if (!v || typeof v.status !== 'string') {
+      card.append(el('div', { className: 'status', text: 'No report data', 'data-status': 'missing' }),
+        el('p', { text: 'The host has not provided a report view. Run the code-quality-report json command.' }));
+    } else {
+      card.append(el('div', { className: 'status', text: STATUS_LABEL[v.status] || `Unknown status: ${v.status}`, 'data-status': v.status }));
+      if (v.reasons?.length) card.append(el('ul', {}, ...v.reasons.map((r) => el('li', { text: r }))));
+      if (v.startedAt) {
+        const dl = el('dl');
+        const row = (k, val) => { dl.append(el('dt', { text: k }), el('dd', { text: String(val ?? 'unknown') })); };
+        row('Revision at run', v.gitHead ? v.gitHead.slice(0, 12) : 'unknown');
+        row('Revision now', v.currentHead ? v.currentHead.slice(0, 12) : 'unknown');
+        row('Tier', v.tier);
+        row('Gates run', v.ranChecks?.join(', ') || 'none');
+        row('Gates skipped', v.skippedChecks?.length ? v.skippedChecks.map((s) => `${s.id} (${s.tier})`).join(', ') : 'none');
+        row('Source files', v.sourceFileCount);
+        row('Started', v.startedAt);
+        row('Finished', `${v.finishedAt ?? 'unknown'} (${fmtAge(v.ageMs)})`);
+        row('Duration', fmtMs(v.durationMs));
+        row('Findings', `${v.totalFindings} total, ${v.blockingFindings} blocking`);
+        card.append(dl);
+      }
+      if (v.gates?.length) {
+        const head = el('tr', {}, ...['Gate', 'Result', 'Files scanned', 'Findings', 'Time'].map((h) => el('th', { text: h })));
+        const body = v.gates.map((g) => {
+          const result = g.skipped ? `skipped (${g.tier})` : g.spawnError ? `spawn failed: ${g.spawnError}` : g.timedOut ? 'timed out' : g.ok ? 'passed' : `failed (exit ${g.exitCode})`;
+          return el('tr', {}, el('td', { text: g.id }), el('td', { text: result }),
+            el('td', { text: g.scanned ?? '—' }), el('td', { text: g.skipped ? '—' : g.findings }), el('td', { text: g.skipped ? '—' : fmtMs(g.durationMs) }));
+        });
+        card.append(el('table', {}, el('thead', {}, head), el('tbody', {}, ...body)));
+      }
+      if (v.findings?.length) {
+        card.append(el('ul', {}, ...v.findings.slice(0, 50).map((f) => el('li', { text: `${f.file}:${f.line}  ${f.code}  ${f.message}` }))));
+        if (v.findings.length > 50 || v.findingsTruncated) card.append(el('p', { text: 'More findings are in the report file.' }));
+      }
+      if (v.reportFile) card.append(el('p', { text: `Report file: ${v.reportFile}` }));
+    }
+    card.append(
+      el('button', { type: 'button', text: 'Run fast check', onclick: () => this.#emit('run-check', { command: 'code-quality-check', args: ['--tier', 'fast'] }) }),
+      el('button', { type: 'button', text: 'Run full check', onclick: () => this.#emit('run-check', { command: 'code-quality-check', args: ['--tier', 'full'] }) }),
+      el('button', { type: 'button', text: 'Reload report', onclick: () => this.#emit('reload', { command: 'code-quality-report', args: ['json'] }) })
+    );
+    this.#root.replaceChildren(el('style', { textContent: STYLE }), card);
+  }
+}
+
+if (!customElements.get('code-quality-report')) customElements.define('code-quality-report', CodeQualityReport);

package/scaffold/.agent/skills/total-recall/plugins/composable-cli/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Total Recall contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.