catalyst-os 3.0.0 → 3.0.2

package/.catalyst/bin/install.js

@@ -149,18 +149,20 @@ function install() {
     console.log(`  ${green}✓${reset} Installed .claude/skills`);
   }
 
-  // Install config files
-  const configs = [
-    ['.catalyst/spec-structure.yaml', '.catalyst/spec-structure.yaml'],
-    ['.catalyst/main/project-config.yaml', '.catalyst/main/project-config.yaml']
-  ];
-
-  for (const [srcFile, destFile] of configs) {
-    const srcPath = path.join(src, srcFile);
-    const destPath = path.join(cwd, destFile);
-    if (copyFile(srcPath, destPath)) {
-      console.log(`  ${green}✓${reset} Installed ${destFile}`);
+  // Framework-owned config: always refresh on (re)install.
+  if (copyFile(path.join(src, '.catalyst/spec-structure.yaml'), path.join(cwd, '.catalyst/spec-structure.yaml'))) {
+    console.log(`  ${green}✓${reset} Installed .catalyst/spec-structure.yaml`);
+  }
+
+  // User-owned config: create ONLY if missing — never clobber a customized
+  // project-config.yaml (branch settings, voice.language, agent_id, etc.) on update.
+  const pcDest = path.join(cwd, '.catalyst/main/project-config.yaml');
+  if (!fs.existsSync(pcDest)) {
+    if (copyFile(path.join(src, '.catalyst/main/project-config.yaml'), pcDest)) {
+      console.log(`  ${green}✓${reset} Installed .catalyst/main/project-config.yaml`);
     }
+  } else {
+    console.log(`  ${dim}•${reset} Kept existing .catalyst/main/project-config.yaml`);
   }
 
   // Install voice runtime (zero-dependency local meeting daemon for /meet-spec)

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

@@ -113,13 +113,33 @@
       notes.innerHTML = lastNotesHtml;
     }
 
+    let voices = [];
+    function loadVoices() { try { voices = speechSynthesis.getVoices() || []; } catch {} }
+    if ('speechSynthesis' in window) { loadVoices(); speechSynthesis.onvoiceschanged = loadVoices; }
+    function pickVoice() {
+      if (!voices.length) loadVoices();
+      const base = lang.split('-')[0].toLowerCase();
+      return voices.find(v => v.lang === lang)
+          || voices.find(v => (v.lang || '').toLowerCase().startsWith(base))
+          || voices[0] || null;
+    }
     function speak(text) {
       return new Promise((resolve) => {
-        if (!('speechSynthesis' in window)) return resolve();
+        if (!('speechSynthesis' in window) || !text) return resolve();
+        try { speechSynthesis.cancel(); } catch {}
         const u = new SpeechSynthesisUtterance(text);
-        u.lang = lang; u.onend = resolve; u.onerror = resolve;
+        u.lang = lang;
+        const v = pickVoice();
+        if (v) u.voice = v;        // explicit voice → avoids silent "no voice for lang"
+        let done = false;
+        const finish = () => { if (done) return; done = true; clearInterval(ka); resolve(); };
+        u.onend = finish; u.onerror = finish;
+        // Chrome silently pauses long utterances (~15s); nudge it to keep going.
+        const ka = setInterval(() => { try { if (speechSynthesis.speaking) speechSynthesis.resume(); } catch {} }, 4000);
         setOrb('speaking'); setStatus('Catalyst is speaking…');
         speechSynthesis.speak(u);
+        // If speech never starts (blocked / no voice), don't hang the turn loop.
+        setTimeout(() => { if (!done && !speechSynthesis.speaking) finish(); }, 2500);
       });
     }
 
@@ -170,6 +190,8 @@
 
     startBtn.onclick = () => {
       startBtn.disabled = true; endBtn.disabled = false; chatRow.hidden = false;
+      // Unlock audio within the user gesture so TTS works later, and warm up voices.
+      if ('speechSynthesis' in window) { try { speechSynthesis.cancel(); speechSynthesis.resume(); loadVoices(); } catch {} }
       recognition = buildRecognition();
       if (!recognition) { setStatus('Speech needs Chrome. You can still type below.'); setOrb(''); return; }
       startListening();

package/AGENTS.md

@@ -14,7 +14,7 @@ Quick reference for all agents and the skills they use.
 |----------|--------------|
 | Research phase | Oracle + Seer + Scout + Surveyor |
 | Build phase | Smith x N + Shaper x M (multiple instances) |
-| Validation phase | Inquisitor + Watcher + Sentinel |
+| Validation phase | Inquisitor + Watcher + Sentinel + Curator (DB specs) |
 
 ### Run Sequentially (Has Dependencies)
 
@@ -94,6 +94,7 @@ All builders follow `test-driven-development`, `systematic-debugging`, `verifica
 | [Sentinel](.claude/agents/sentinel.md) | E2E tests | — |
 | [Inquisitor](.claude/agents/inquisitor.md) | Code review | — |
 | [Watcher](.claude/agents/watcher.md) | Security audit | — |
+| [Curator](.claude/agents/curator.md) | Schema-integrity audit (read-only DB) | `secret-scanning` |
 
 ---
 

package/README.md

@@ -9,6 +9,7 @@
 ```bash
 npx catalyst-os                        # Install to your project
 /catalyze-project                      # Initialize project foundation
+/meet-spec "topic"                     # (optional) Talk it through -> meeting notes
 /catalyze-spec "description"           # Shape a feature specification
 /challenge-spec @spec-name             # (optional) Interrogate the spec branch by branch
 /forge-spec @spec-name                 # Implement with TDD
@@ -44,6 +45,7 @@ Then run `/catalyze-project` to initialize — this detects your workspace type,
 │   ├── agent-delegation/
 │   ├── receiving-code-review/
 │   ├── workspace-detection/
+│   ├── meet-spec/
 │   ├── spec-shaping/
 │   ├── spec-challenge/
 │   ├── build-orchestration/
@@ -57,6 +59,8 @@ Then run `/catalyze-project` to initialize — this detects your workspace type,
 
 .catalyst/
 ├── main/                # Mission, roadmap, tech-stack, project-config
+├── voice/               # /meet-spec meeting runtime (zero-dependency)
+├── meetings/            # Meeting notes artifacts (generated, git-ignored)
 ├── specs/               # Active specifications
 ├── completed/           # Archived specs
 └── library/             # Reusable patterns
@@ -103,6 +107,7 @@ Without this, skills are optional documentation. With it, they're mandatory proc
 
 | Skill | Command | Purpose |
 |-------|---------|---------|
+| `meet-spec` | `/meet-spec` | Voice meeting → `/catalyze-spec`-ready notes (optional) |
 | `spec-shaping` | `/catalyze-spec` | Shape feature requests into specifications |
 | `spec-challenge` | `/challenge-spec` | Interrogate a shaped spec branch by branch (optional) |
 | `build-orchestration` | `/forge-spec` | DAG-based TDD implementation |
@@ -143,7 +148,8 @@ Guardians (Quality)
 ├── Enforcer   → Unit tests
 ├── Sentinel   → E2E tests
 ├── Inquisitor → Code review
-└── Watcher    → Security
+├── Watcher    → Security
+└── Curator    → Schema integrity (DB, read-only)
 ```
 
 ### Agent Capabilities
@@ -167,6 +173,7 @@ Guardians (Quality)
 | | Sentinel | Run E2E tests |
 | | Inquisitor | Code review, linting |
 | | Watcher | Security audit, dependency scan |
+| | Curator | Schema-integrity audit (read-only DB) |
 
 ---
 
@@ -201,6 +208,7 @@ Guardians (Quality)
 | Command | When to Use | Output |
 |---------|-------------|--------|
 | `/catalyze-project` | Start new project | mission.md, roadmap.md, tech-stack.md |
+| `/meet-spec "topic"` | Shape a spec by talking it through (optional) | meeting.html + meeting.md |
 | `/catalyze-spec "feature"` | New feature request | spec.md, research.md |
 | `/challenge-spec @slug` | Stress-test the spec before forging (optional) | spec.md (patched), handoff.md (Challenge Log) |
 | `/forge-spec @slug` | Implement feature | tasks.md (updated) |
@@ -218,6 +226,34 @@ Guardians (Quality)
 
 ---
 
+## Voice Meetings (`/meet-spec`)
+
+Shape a spec by **talking it through**. `/meet-spec` opens a local browser meeting room,
+holds a spoken conversation, and writes a `/catalyze-spec`-ready notes artifact. The
+agent can read the codebase, docs, and the web live during the meeting.
+
+```
+/meet-spec "realtime notifications"     # opens the room → talk → End meeting
+/catalyze-spec @.catalyst/meetings/YYYY-MM-DD-{slug}/meeting.md
+```
+
+Two modes (`voice.mode` in `project-config.yaml`):
+
+| | **diy** (default) | **bundled** |
+|---|---|---|
+| Speech | Browser Web Speech API | ElevenLabs Conversational AI |
+| Brain | Local `claude -p` | ElevenLabs agent (Claude LLM) |
+| Cost | **Free** (uses your Claude) | Per-minute, BYOK key |
+| Setup | None — just Chrome | API key + agent |
+
+The room shows **live meeting notes** (left) beside the **chat history** (right). On
+**End meeting** it saves both `meeting.html` (rendered, self-contained) and `meeting.md`
+(canonical input for `/catalyze-spec`). Notes are written in English regardless of the
+spoken language (`voice.language`, e.g. `"tr"`). Runtime lives in `.catalyst/voice/`
+(zero npm dependencies). See `.catalyst/voice/README.md` for setup.
+
+---
+
 ## Spec Folder Structure
 
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "catalyst-os",
-  "version": "3.0.0",
+  "version": "3.0.2",
   "scripts": {
     "postinstall": "node .catalyst/bin/install.js",
     "validate": "node .catalyst/bin/validate-artifacts.js"