npm - catalyst-os - Versions diffs - 2.0.2 → 3.0.0 - Mend

catalyst-os 2.0.2 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (23) hide show

package/.catalyst/bin/install.js +46 -0
package/.catalyst/main/project-config.yaml +16 -0
package/.catalyst/spec-structure.yaml +1 -1
package/.catalyst/voice/README.md +78 -0
package/.catalyst/voice/artifact.js +61 -0
package/.catalyst/voice/meet-server.js +293 -0
package/.catalyst/voice/meeting-diy.html +205 -0
package/.catalyst/voice/meeting.html +198 -0
package/.catalyst/voice/package.json +11 -0
package/.claude/agents/arbiter.md +4 -2
package/.claude/agents/curator.md +75 -0
package/.claude/commands/audit-spec.md +1 -1
package/.claude/commands/challenge-spec.md +31 -0
package/.claude/commands/meet-spec.md +43 -0
package/.claude/commands/seal-spec.md +16 -0
package/.claude/skills/meet-spec/SKILL.md +112 -0
package/.claude/skills/spec-approval/SKILL.md +8 -1
package/.claude/skills/spec-challenge/SKILL.md +139 -0
package/.claude/skills/spec-shaping/SKILL.md +2 -1
package/.claude/skills/spec-validation/SKILL.md +5 -3
package/.claude/skills/using-skills/SKILL.md +2 -0
package/README.md +8 -0
package/package.json +2 -1

package/.catalyst/voice/meeting-diy.html ADDED Viewed

@@ -0,0 +1,205 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>Catalyst Meeting Room (DIY)</title>
+  <script src="https://cdn.jsdelivr.net/npm/marked@12/marked.min.js"></script>
+  <style>
+    :root { --bg:#0e0e14; --panel:#1a1a24; --accent:#4fd1a5; --text:#e8e8f0; --dim:#8a8a9a; }
+    * { box-sizing: border-box; }
+    body { margin:0; font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;
+      background:var(--bg); color:var(--text); }
+    .room { max-width:1080px; margin:0 auto; padding:28px 24px; }
+    h1 { font-size:20px; font-weight:600; margin:0 0 4px; }
+    .topic { color:var(--dim); margin:0 0 22px; font-size:14px; }
+    .split { display:flex; gap:20px; align-items:flex-start; }
+    .notes-pane { flex:1; min-width:0; background:var(--panel); border:1px solid #2a2a36;
+      border-radius:12px; overflow:hidden; }
+    .chat-pane { width:360px; flex:none; }
+    @media (max-width:820px){ .split{flex-direction:column;} .chat-pane{width:100%;} }
+    .pane-h { padding:12px 16px; font-size:13px; font-weight:600; color:var(--dim);
+      border-bottom:1px solid #2a2a36; letter-spacing:.04em; text-transform:uppercase; }
+    .notes { padding:6px 20px 18px; max-height:62vh; overflow-y:auto; font-size:14px; line-height:1.55; }
+    .notes h1 { font-size:18px; } .notes h2 { font-size:15px; color:var(--accent); margin:18px 0 6px; }
+    .notes ul { margin:6px 0; padding-left:20px; } .notes li { margin:3px 0; }
+    .notes .empty { color:var(--dim); font-style:italic; }
+    .controls { text-align:center; }
+    .orb { width:84px; height:84px; border-radius:50%; margin:6px auto 12px;
+      background:radial-gradient(circle at 35% 35%, #8fe6c8, var(--accent));
+      box-shadow:0 0 0 0 rgba(79,209,165,.5); transition:transform .2s; }
+    .orb.listening { animation:pulse 2s infinite; }
+    .orb.speaking { animation:pulse .7s infinite; transform:scale(1.08); }
+    .orb.thinking { background:radial-gradient(circle at 35% 35%,#ffd27a,#ff9b3d); animation:spin 1.1s linear infinite; }
+    @keyframes pulse { 0%{box-shadow:0 0 0 0 rgba(79,209,165,.5);} 70%{box-shadow:0 0 0 18px rgba(79,209,165,0);} 100%{box-shadow:0 0 0 0 rgba(79,209,165,0);} }
+    @keyframes spin { to { transform:rotate(360deg);} }
+    .status { color:var(--dim); min-height:20px; margin-bottom:14px; font-size:13px; }
+    .btns { display:flex; gap:10px; justify-content:center; }
+    button { border:none; border-radius:10px; padding:10px 18px; font-size:14px; font-weight:600; cursor:pointer; }
+    .start { background:var(--accent); color:#06281e; } .end { background:#2a2a36; color:var(--text); }
+    button:disabled { opacity:.4; cursor:not-allowed; }
+    .chat { display:flex; gap:8px; margin-top:14px; }
+    .chat input { flex:1; min-width:0; background:var(--panel); border:1px solid #2a2a36; color:var(--text);
+      border-radius:8px; padding:9px 11px; font-size:14px; }
+    .chat input:focus { outline:none; border-color:var(--accent); }
+    .chat button { background:#2a2a36; color:var(--text); }
+    .log { margin-top:14px; background:var(--panel); border:1px solid #2a2a36; border-radius:10px;
+      padding:12px; max-height:34vh; overflow-y:auto; font-size:13px; line-height:1.5; }
+    .log .u { color:#7fd1ff; } .log .a { color:#8fe6c8; } .log .t { color:var(--dim); font-style:italic; }
+    .hint { color:var(--dim); font-size:12px; margin-top:16px; }
+    .done { text-align:center; padding:30px; } .done code { background:var(--panel); padding:4px 8px; border-radius:6px; }
+  </style>
+</head>
+<body>
+  <div class="room">
+    <h1>Catalyst Meeting Room</h1>
+    <p class="topic" id="topic">Loading…</p>
+    <div class="split">
+      <section class="notes-pane">
+        <div class="pane-h">Meeting Notes — live</div>
+        <div class="notes" id="notes"><p class="empty">Notes will build up here as you talk…</p></div>
+      </section>
+      <section class="chat-pane">
+        <div class="controls">
+          <div class="orb" id="orb"></div>
+          <div class="status" id="status">Ready when you are.</div>
+          <div class="btns">
+            <button class="start" id="startBtn">Start</button>
+            <button class="end" id="endBtn" disabled>End meeting</button>
+          </div>
+        </div>
+        <div class="chat" id="chatRow" hidden>
+          <input id="chatInput" type="text" placeholder="Type instead of speaking…" autocomplete="off" />
+          <button id="chatSend">Send</button>
+        </div>
+        <div class="log" id="log"></div>
+      </section>
+    </div>
+    <p class="hint">Free mode: browser speech + Claude reading the codebase. No ElevenLabs.</p>
+  </div>
+  <script>
+    const $ = (id) => document.getElementById(id);
+    const orb = $('orb'), status = $('status'), log = $('log'), notes = $('notes');
+    const startBtn = $('startBtn'), endBtn = $('endBtn');
+    const chatRow = $('chatRow'), chatInput = $('chatInput'), chatSend = $('chatSend');
+    const LANG_MAP = { tr: 'tr-TR', en: 'en-US', de: 'de-DE', fr: 'fr-FR', es: 'es-ES' };
+    const transcript = [];
+    let lang = 'en-US', ended = false, busy = false;
+    let recognition = null, wantListen = false;
+    let lastNotesMd = '', lastNotesHtml = '';
+    fetch('/config').then(r => r.json()).then(c => {
+      $('topic').textContent = c.topic || 'Untitled meeting';
+      lang = LANG_MAP[c.language] || c.language || 'en-US';
+    });
+    function setStatus(t) { status.textContent = t; }
+    function setOrb(cls) { orb.className = 'orb' + (cls ? ' ' + cls : ''); }
+    function esc(s){ return String(s).replace(/[&<>]/g,c=>({'&':'&amp;','<':'&lt;','>':'&gt;'}[c])); }
+    function addLine(kind, text) {
+      const cls = kind === 'user' ? 'u' : kind === 'ai' ? 'a' : 't';
+      const who = kind === 'user' ? 'You' : kind === 'ai' ? 'Catalyst' : '·';
+      const div = document.createElement('div');
+      div.className = cls; div.textContent = `${who}: ${text}`;
+      log.appendChild(div); log.scrollTop = log.scrollHeight;
+      if (kind === 'user' || kind === 'ai') transcript.push(`${who}: ${text}`);
+    }
+    function renderNotes(md) {
+      if (!md) return;
+      lastNotesMd = md;
+      lastNotesHtml = (window.marked && marked.parse) ? marked.parse(md) : `<pre>${esc(md)}</pre>`;
+      notes.innerHTML = lastNotesHtml;
+    }
+    function speak(text) {
+      return new Promise((resolve) => {
+        if (!('speechSynthesis' in window)) return resolve();
+        const u = new SpeechSynthesisUtterance(text);
+        u.lang = lang; u.onend = resolve; u.onerror = resolve;
+        setOrb('speaking'); setStatus('Catalyst is speaking…');
+        speechSynthesis.speak(u);
+      });
+    }
+    async function handleTurn(text) {
+      if (!text || busy || ended) return;
+      busy = true; stopListening();
+      addLine('user', text);
+      setOrb('thinking'); setStatus('Thinking… (reading the codebase)');
+      let reply = '(no response)';
+      try {
+        const r = await fetch('/turn', {
+          method: 'POST', headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ text }),
+        });
+        const data = await r.json();
+        reply = data.reply || reply;
+        renderNotes(data.notes);
+      } catch (e) { reply = 'Error: ' + (e?.message || e); }
+      addLine('ai', reply);
+      await speak(reply);
+      busy = false;
+      if (!ended) startListening();
+    }
+    function buildRecognition() {
+      const SR = window.SpeechRecognition || window.webkitSpeechRecognition;
+      if (!SR) return null;
+      const rec = new SR();
+      rec.lang = lang; rec.continuous = false; rec.interimResults = true;
+      rec.onresult = (e) => {
+        let finalText = '';
+        for (let i = e.resultIndex; i < e.results.length; i++) {
+          if (e.results[i].isFinal) finalText += e.results[i][0].transcript;
+          else setStatus('… ' + e.results[i][0].transcript);
+        }
+        if (finalText.trim()) handleTurn(finalText.trim());
+      };
+      rec.onend = () => { if (wantListen && !busy && !ended) { try { rec.start(); } catch {} } };
+      rec.onerror = (ev) => { if (ev.error === 'not-allowed') setStatus('Mic blocked — use the text box.'); };
+      return rec;
+    }
+    function startListening() {
+      wantListen = true; if (!recognition) return;
+      setOrb('listening'); setStatus('Listening…');
+      try { recognition.start(); } catch {}
+    }
+    function stopListening() { wantListen = false; if (recognition) { try { recognition.stop(); } catch {} } }
+    startBtn.onclick = () => {
+      startBtn.disabled = true; endBtn.disabled = false; chatRow.hidden = false;
+      recognition = buildRecognition();
+      if (!recognition) { setStatus('Speech needs Chrome. You can still type below.'); setOrb(''); return; }
+      startListening();
+    };
+    function sendChat() {
+      const t = chatInput.value.trim(); if (!t) return;
+      chatInput.value = ''; handleTurn(t);
+    }
+    chatSend.onclick = sendChat;
+    chatInput.addEventListener('keydown', (e) => { if (e.key === 'Enter') sendChat(); });
+    endBtn.onclick = async () => {
+      ended = true; endBtn.disabled = true; stopListening();
+      if ('speechSynthesis' in window) speechSynthesis.cancel();
+      setOrb('thinking'); setStatus('Wrapping up…');
+      try {
+        const r = await fetch('/end', {
+          method: 'POST', headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ transcript: transcript.join('\n'), notesMd: lastNotesMd, notesHtml: lastNotesHtml }),
+        });
+        const j = await r.json();
+        document.querySelector('.room').innerHTML =
+          `<div class="done"><h1>Meeting captured ✓</h1>` +
+          `<p>Notes saved to:</p><p><code>${j.path}</code><br><code>${j.htmlPath || ''}</code></p>` +
+          `<p class="topic">Back in your terminal, shape it with<br>` +
+          `<code>/catalyze-spec @${j.path}</code></p>` +
+          `<p class="topic">You can close this tab.</p></div>`;
+      } catch (e) { setStatus('Failed to save: ' + (e?.message || e)); }
+    };
+  </script>
+</body>
+</html>

package/.catalyst/voice/meeting.html ADDED Viewed

@@ -0,0 +1,198 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>Catalyst Meeting Room</title>
+  <style>
+    :root { --bg:#0e0e14; --panel:#1a1a24; --accent:#9b6dff; --text:#e8e8f0; --dim:#8a8a9a; }
+    * { box-sizing: border-box; }
+    body { margin:0; font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;
+      background:var(--bg); color:var(--text); display:flex; min-height:100vh; }
+    .room { margin:auto; width:100%; max-width:680px; padding:32px; }
+    h1 { font-size:20px; font-weight:600; margin:0 0 4px; }
+    .topic { color:var(--dim); margin:0 0 28px; font-size:14px; }
+    .orb { width:120px; height:120px; border-radius:50%; margin:24px auto;
+      background:radial-gradient(circle at 35% 35%, #b89bff, var(--accent));
+      box-shadow:0 0 0 0 rgba(155,109,255,.5); transition:transform .2s; }
+    .orb.listening { animation:pulse 2s infinite; }
+    .orb.speaking { animation:pulse .7s infinite; transform:scale(1.08); }
+    .orb.thinking { background:radial-gradient(circle at 35% 35%,#ffd27a,#ff9b3d);
+      animation:spin 1.1s linear infinite; }
+    @keyframes pulse { 0%{box-shadow:0 0 0 0 rgba(155,109,255,.5);} 70%{box-shadow:0 0 0 22px rgba(155,109,255,0);} 100%{box-shadow:0 0 0 0 rgba(155,109,255,0);} }
+    @keyframes spin { to { transform:rotate(360deg);} }
+    .status { text-align:center; color:var(--dim); min-height:22px; margin:8px 0 24px; font-size:14px; }
+    .btns { display:flex; gap:12px; justify-content:center; }
+    button { border:none; border-radius:10px; padding:12px 22px; font-size:15px;
+      font-weight:600; cursor:pointer; }
+    .start { background:var(--accent); color:#fff; }
+    .end { background:#2a2a36; color:var(--text); }
+    button:disabled { opacity:.4; cursor:not-allowed; }
+    .log { margin-top:28px; background:var(--panel); border-radius:12px; padding:16px;
+      max-height:34vh; overflow-y:auto; font-size:13px; line-height:1.6; }
+    .log .u { color:#7fd1ff; } .log .a { color:#c8b0ff; } .log .t { color:var(--dim); font-style:italic; }
+    .done { text-align:center; padding:20px; }
+    .done code { background:var(--panel); padding:4px 8px; border-radius:6px; }
+    .chat { display:flex; gap:8px; margin-top:16px; }
+    .chat input { flex:1; background:var(--panel); border:1px solid #2a2a36; color:var(--text);
+      border-radius:8px; padding:10px 12px; font-size:14px; }
+    .chat input:focus { outline:none; border-color:var(--accent); }
+    .chat button { background:#2a2a36; color:var(--text); }
+  </style>
+</head>
+<body>
+  <div class="room">
+    <h1>Catalyst Meeting Room</h1>
+    <p class="topic" id="topic">Loading…</p>
+    <div class="orb" id="orb"></div>
+    <div class="status" id="status">Ready when you are.</div>
+    <div class="btns">
+      <button class="start" id="startBtn">Start meeting</button>
+      <button class="end" id="endBtn" disabled>End meeting</button>
+    </div>
+    <div class="chat" id="chatRow" hidden>
+      <input id="chatInput" type="text" placeholder="Type a message instead of speaking…" autocomplete="off" />
+      <button id="chatSend">Send</button>
+    </div>
+    <div class="log" id="log" hidden></div>
+  </div>
+  <script type="module">
+    import { Conversation } from 'https://esm.sh/@elevenlabs/client';
+    const $ = (id) => document.getElementById(id);
+    const orb = $('orb'), status = $('status'), log = $('log');
+    const startBtn = $('startBtn'), endBtn = $('endBtn');
+    const chatRow = $('chatRow'), chatInput = $('chatInput'), chatSend = $('chatSend');
+    let conversation = null;
+    const transcript = [];
+    fetch('/config').then(r => r.json()).then(c => {
+      $('topic').textContent = c.topic || 'Untitled meeting';
+    });
+    function setStatus(t) { status.textContent = t; }
+    function setOrb(cls) { orb.className = 'orb' + (cls ? ' ' + cls : ''); }
+    function addLine(kind, text) {
+      log.hidden = false;
+      const cls = kind === 'user' ? 'u' : kind === 'ai' ? 'a' : 't';
+      const who = kind === 'user' ? 'You' : kind === 'ai' ? 'Catalyst' : '·';
+      const div = document.createElement('div');
+      div.className = cls;
+      div.textContent = `${who}: ${text}`;
+      log.appendChild(div);
+      log.scrollTop = log.scrollHeight;
+      if (kind === 'user' || kind === 'ai') transcript.push(`${who}: ${text}`);
+    }
+    // Client tool: live codebase investigation via the local daemon -> claude -p.
+    const clientTools = {
+      investigate_codebase: async ({ query }) => {
+        const prev = orb.className;
+        setOrb('thinking');
+        setStatus(`🔍 Investigating: ${query}`);
+        addLine('tool', `investigating: ${query}`);
+        try {
+          const r = await fetch('/tool', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ query }),
+          });
+          const j = await r.json();
+          addLine('tool', `findings ready`);
+          return j.result || 'No result.';
+        } catch (e) {
+          return `Investigation failed: ${e.message}`;
+        } finally {
+          orb.className = prev;
+          setStatus('Listening…');
+        }
+      },
+    };
+    startBtn.onclick = async () => {
+      startBtn.disabled = true;
+      setStatus('Connecting…');
+      try {
+        const cfg = await (await fetch('/config')).json();
+        const signed = await (await fetch('/signed-url')).json();
+        const opts = {
+          clientTools,
+          onConnect: () => { setStatus('Listening…'); setOrb('listening'); endBtn.disabled = false; chatRow.hidden = false; },
+          onDisconnect: () => { setOrb(''); },
+          onError: (e) => { setStatus('Error: ' + (e?.message || e)); },
+          onModeChange: ({ mode }) => {
+            setOrb(mode === 'speaking' ? 'speaking' : 'listening');
+            setStatus(mode === 'speaking' ? 'Catalyst is speaking…' : 'Listening…');
+          },
+          onMessage: (payload) => {
+            // SDK versions differ: payload may be {message, source} or a bare string.
+            const raw = payload && typeof payload === 'object' ? payload.message ?? payload : payload;
+            const text = typeof raw === 'string' ? raw : (raw && raw.message) || JSON.stringify(raw);
+            const src = payload && payload.source;
+            if (text) addLine(src === 'user' ? 'user' : 'ai', text);
+          },
+        };
+        if (signed.signedUrl) opts.signedUrl = signed.signedUrl;
+        else opts.agentId = cfg.agentId;
+        // Drive the conversation language from project-config (voice.language).
+        // Requires the language override to be enabled on the agent; if it isn't,
+        // ElevenLabs rejects the override, so we retry once without it.
+        if (cfg.language) opts.overrides = { agent: { language: cfg.language } };
+        try {
+          conversation = await Conversation.startSession(opts);
+        } catch (err) {
+          if (opts.overrides) {
+            console.warn('Language override rejected (enable it on the agent). Retrying without it.', err);
+            delete opts.overrides;
+            conversation = await Conversation.startSession(opts);
+          } else {
+            throw err;
+          }
+        }
+      } catch (e) {
+        setStatus('Could not start: ' + (e?.message || e));
+        startBtn.disabled = false;
+      }
+    };
+    // Typed messages — useful when speech is misheard. Treated as a user turn.
+    function sendChat() {
+      const t = chatInput.value.trim();
+      if (!t || !conversation) return;
+      try {
+        conversation.sendUserMessage(t);
+        addLine('user', t);
+        chatInput.value = '';
+      } catch (e) {
+        addLine('tool', 'could not send message: ' + (e?.message || e));
+      }
+    }
+    chatSend.onclick = sendChat;
+    chatInput.addEventListener('keydown', (e) => { if (e.key === 'Enter') sendChat(); });
+    endBtn.onclick = async () => {
+      endBtn.disabled = true;
+      setStatus('Wrapping up…');
+      setOrb('thinking');
+      try { if (conversation) await conversation.endSession(); } catch {}
+      try {
+        const r = await fetch('/end', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ transcript: transcript.join('\n') }),
+        });
+        const j = await r.json();
+        document.querySelector('.room').innerHTML =
+          `<div class="done"><h1>Meeting captured ✓</h1>` +
+          `<p>Artifact written to:</p><p><code>${j.path}</code></p>` +
+          `<p class="topic">Back in your terminal, shape it with<br>` +
+          `<code>/catalyze-spec @${j.path}</code></p>` +
+          `<p class="topic">You can close this tab.</p></div>`;
+      } catch (e) {
+        setStatus('Failed to save: ' + (e?.message || e));
+      }
+    };
+  </script>
+</body>
+</html>

package/.catalyst/voice/package.json ADDED Viewed

@@ -0,0 +1,11 @@
+{
+  "name": "catalyst-os-voice",
+  "version": "1.0.0",
+  "private": true,
+  "description": "Local voice-meeting runtime for /meet-spec. Zero npm dependencies — Node stdlib only; the browser loads the ElevenLabs SDK from a CDN.",
+  "type": "commonjs",
+  "main": "meet-server.js",
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/.claude/agents/arbiter.md CHANGED Viewed

@@ -6,8 +6,9 @@ description: >
   - Implementation is complete and needs quality checks
   - Production readiness needs to be verified
-  This agent orchestrates Guardians (Enforcer, Sentinel, Inquisitor, Watcher)
-  to run tests, check code quality, scan for security issues, and verify compliance.
+  This agent orchestrates Guardians (Enforcer, Sentinel, Inquisitor, Watcher,
+  and Curator for database specs) to run tests, check code quality, scan for
+  security issues, verify schema integrity, and verify compliance.
   DO NOT validate implementations yourself - delegate to Arbiter.
 model: opus
@@ -56,6 +57,7 @@ Before any action, load `.claude/skills/using-skills/SKILL.md` and check which s
 4. **Coverage**: Meets coverage thresholds
 5. **Performance**: No regressions detected
 6. **Documentation**: Required docs are present
+7. **Schema Integrity** (database specs only): Live DB matches the spec — delegate to Curator (read-only), never to the Alchemist that built it
 ## Output

package/.claude/agents/curator.md ADDED Viewed

@@ -0,0 +1,75 @@
+---
+name: curator
+description: >
+  PROACTIVELY DELEGATE schema-integrity audits to this agent. MUST BE USED when:
+  - Verifying a built implementation matches the actual database schema
+  - Confirming columns, constraints, and foreign keys exist in the real DB
+  - Tracing that API endpoints persist every field the spec expects
+  - Validating SQL functions, sequences, or triggers the feature depends on
+  This is a READ-ONLY Guardian. It audits the database — it never creates or
+  modifies schemas, migrations, or data. Building is the Alchemist's job.
+  DO NOT audit database integrity yourself - delegate to Curator.
+model: sonnet
+color: cyan
+skills: secret-scanning
+---
+You are the Curator, a schema-integrity auditor who verifies that the
+implementation matches the real database.
+## Opening
+*"Reconciling the schema against reality..."*
+## Role
+You are a **Guardian** in the `/audit-spec` validation phase, orchestrated by the
+Arbiter. You audit — you do not build. The Alchemist designs and migrates the
+schema during `/forge-spec`; you independently verify that what was built is real
+and complete. This separation is the point: the agent that creates a table must
+never be the one that signs off on it.
+## Read-Only Discipline — BLOCKING
+- **NEVER** run migrations, `ALTER`/`CREATE`/`DROP`, or any write/DDL statement.
+- **NEVER** edit migration files, schema definitions, or application code.
+- Use read-only queries only (`SELECT`, `information_schema`, `pg_catalog`, describe).
+- If you discover a defect, you **report** it — you do not fix it. Remediation
+  goes back to the Alchemist via `/forge-spec`.
+## Audit Checklist (only for specs touching the database)
+1. **Tables exist**: Every table the spec/code references exists in the live DB.
+2. **Columns match**: Real column names and types match what the spec and code
+   assume — check against `information_schema.columns`, not code aliases.
+3. **Constraints & keys**: All foreign keys, unique constraints, NOT NULL, and
+   check constraints the spec requires actually exist.
+4. **End-to-end persistence**: Trace each field the spec expects through the API
+   path (API call → DB write → DB read → API response). Flag any dropped field.
+5. **Functions & procedures**: Any SQL functions/stored procedures the feature
+   calls actually exist with the expected signature.
+6. **DB-level machinery**: Sequences, triggers, and DB-level defaults the feature
+   assumes are present.
+## Verification Before Reporting
+Follow `.claude/skills/verification-before-completion/SKILL.md`. Every claim must
+be backed by the actual query output — paste it. "The column exists" is not
+evidence; the `information_schema` row is.
+## Output
+Provide a schema-integrity report to the Arbiter:
+- Overall status: PASS / FAIL
+- Tables / columns verified (with query evidence)
+- Constraints and foreign keys verified
+- API end-to-end trace result per expected field
+- DB functions / sequences / triggers verified
+- Issues found, by severity, each with a remediation note pointing back to
+  `/forge-spec` (Alchemist)
+Block on any mismatch between what the spec expects and what the database
+actually contains.

package/.claude/commands/audit-spec.md CHANGED Viewed

@@ -28,6 +28,6 @@ echo "=== FILES CHANGED ===" && git diff --name-only main...HEAD 2>/dev/null ||
 **Invoke skill:** `spec-validation`
-**Orchestrator:** Arbiter (delegates to Enforcer, Sentinel, Inquisitor, Watcher)
+**Orchestrator:** Arbiter (delegates to Enforcer, Sentinel, Inquisitor, Watcher, and Curator for database specs)
 **Process skills used:** `verification-before-completion`, `agent-delegation`, `test-driven-development`

package/.claude/commands/challenge-spec.md ADDED Viewed

@@ -0,0 +1,31 @@
+# /challenge-spec
+Stress-test a shaped spec by interviewing the user across every branch of the design tree.
+> **Lifecycle position:** `/catalyze-spec` → **`/challenge-spec`** *(optional)* → `/forge-spec` → `/audit-spec` → `/seal-spec`
+>
+> **Optional gate.** Use when a spec has real design surface area and you want every branch resolved before tests are written. Skip it for trivial specs.
+## Usage
+```
+/challenge-spec @2026-05-13-stripe-integration
+```
+## Pre-computed Context
+```bash
+# Spec state for challenge
+echo "=== SPEC FILES ===" && ls .catalyst/specs/*$ARGUMENTS*/ 2>/dev/null || echo "No spec found for: $ARGUMENTS"
+echo "=== SPEC STATUS ===" && head -20 .catalyst/specs/*$ARGUMENTS*/spec.md 2>/dev/null || echo "No spec.md"
+echo "=== OPEN QUESTIONS ===" && grep -A 20 "## Open Questions" .catalyst/specs/*$ARGUMENTS*/spec.md 2>/dev/null || echo "No Open Questions section"
+echo "=== TASKS EXIST? ===" && ls .catalyst/specs/*$ARGUMENTS*/tasks.md 2>/dev/null && echo "WARNING: tasks.md exists — use /update-spec instead" || echo "No tasks.md (expected)"
+```
+---
+**Invoke skill:** `spec-challenge`
+**Orchestrator:** Main thread (direct interview). Spawn Seer if a question becomes a codebase research task.
+**Process skills used:** `brainstorming` (form, not 9-question cap), `agent-delegation`

package/.claude/commands/meet-spec.md ADDED Viewed

@@ -0,0 +1,43 @@
+# /meet-spec
+Hold a **voice meeting** with Catalyst, then turn the notes into a spec.
+Start a local browser meeting room. Talk through a feature; the meeting agent can
+investigate the codebase, docs, and web live (via `claude -p` → Seer/Scout). When you
+click **End meeting**, a structured, `/catalyze-spec`-ready notes artifact is written.
+Default mode is **diy** — free, browser speech + local Claude, no API key. Switch
+`voice.mode` to `bundled` for ElevenLabs' nicer (paid) voice.
+> **Lifecycle position:** **`/meet-spec`** → `/catalyze-spec` → *(optional)* `/challenge-spec` → `/forge-spec` → `/audit-spec` → `/seal-spec`
+## Usage
+```
+/meet-spec "realtime notifications"
+/meet-spec                          # will ask for the meeting topic
+```
+The output is a meeting artifact, NOT a spec. After the meeting, shape it yourself:
+```
+/catalyze-spec @.catalyst/meetings/YYYY-MM-DD-{slug}/meeting.md
+```
+## Pre-computed Context
+```bash
+echo "=== NODE VERSION ===" && node --version
+echo "=== CLAUDE CLI? ===" && command -v claude >/dev/null && echo "claude found" || echo "MISSING claude CLI (needed for the brain)"
+echo "=== VOICE CONFIG ===" && sed -n '/^voice:/,/^[^ ]/p' .catalyst/main/project-config.yaml 2>/dev/null || echo "No voice config"
+echo "=== VOICE RUNTIME? ===" && test -f .catalyst/voice/meet-server.js && echo "meet-server.js found" || echo "MISSING .catalyst/voice/ (re-install catalyst-os)"
+echo "=== SECRETS (bundled mode only) ===" && test -f .catalyst/secrets.local.yaml && echo "secrets.local.yaml found" || echo "no secrets.local.yaml (only needed for bundled mode)"
+```
+---
+**Invoke skill:** `meet-spec`
+**Orchestrator:** Catalyst (the meeting persona lives in the ElevenLabs agent prompt; codebase investigation delegates to Seer/Scout via headless `claude -p`)
+**Process skills used:** `brainstorming`, `agent-delegation`

package/.claude/commands/seal-spec.md CHANGED Viewed

@@ -18,3 +18,19 @@ Commit, archive, and propagate learnings from a **fully built and audited** impl
 **Invoke skill:** `spec-approval`
 **Process skills used:** `verification-before-completion`, `agent-delegation`
+---
+## Execution Mode
+`/seal-spec` is the user's explicit authorization to run the **full ceremony end-to-end**:
+> commit → archive → push → **create PR** → self-document
+Do **not** stop and ask for confirmation between phases. In particular, after `git push` succeeds, immediately run `gh pr create` in the same turn. The only valid reasons to halt are:
+- A hard gate from Phase 1 fails (TDD missing, validation not passed, handoff missing)
+- A `git` or `gh` command returns an error
+- The working tree contains unexpected uncommitted state
+If everything is clean, the entire flow runs to completion and reports the PR URL at the end.