compound-agent 1.3.1 → 1.3.2

package/CHANGELOG.md

@@ -9,11 +9,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.3.2] - 2026-02-21
+
+### Added
+
+- **Banner audio**: Pure TypeScript WAV synthesis plays a rising pentatonic melody during the tendril animation. Cross-platform: `afplay` (macOS), `aplay` (Linux), PowerShell (Windows). Silently skips if player unavailable. Zero dependencies.
+- **Test coverage**: 19 new tests for `ca about` command, changelog extraction/escaping, and `--update` doc migration path
+
+### Fixed
+
+- **`setup --update` doc migration**: `--update` now installs the 5 split docs before removing legacy `HOW_TO_COMPOUND.md`, preventing empty `docs/compound/`
+- **Fresh checkout type-check**: `src/changelog-data.ts` tracked in git so `tsc --noEmit` passes without a prior build
+- **Trailing status text**: Banner animation no longer leaves "al tendrils..." remnant from previous phase
+
+### Changed
+
+- **`ca about` command**: Renamed from `ca version-show` for brevity
+- **Changelog extraction**: Core parsing/escaping logic extracted to `scripts/changelog-utils.ts` (shared between prebuild script and tests)
+- **Narrowed `.gitignore`**: Setup-generated patterns scoped to `compound/` subdirectories to avoid hiding tracked TDD agent definitions
+
 ## [1.3.1] - 2026-02-21
 
 ### Added
 
-- **`ca version-show` command**: Displays version with terminal animation (tendril growth) and recent changelog entries. Non-TTY environments get plain text output. Changelog is embedded at build time from CHANGELOG.md.
+- **`ca about` command**: Displays version with terminal animation (tendril growth) and recent changelog entries. Non-TTY environments get plain text output. Changelog is embedded at build time from CHANGELOG.md.
 - **3 new doctor checks**: Beads initialized (`.beads/` dir), beads healthy (`bd doctor`), codebase scope (user-scope detection)
 - **Beads + scope status in init/setup output**: Full beads health display (CLI available, initialized, healthy) and scope status shown after `ca init`, `ca setup`, and `ca setup --update`
 - **Banner on `--update`**: Terminal art animation now plays during `ca setup --update` and `ca init --update` (same TTY/quiet guards as fresh install)

package/README.md

@@ -210,7 +210,7 @@ Generated scripts detect three markers: `EPIC_COMPLETE` (success), `EPIC_FAILED`
 | `ca setup claude --status` | Check Claude Code integration health |
 | `ca setup claude --uninstall` | Remove Claude hooks only |
 | `ca download-model` | Download the embedding model |
-| `ca version-show` | Show version with animation and recent changelog |
+| `ca about` | Show version, animation, and recent changelog |
 | `ca doctor` | Verify external dependencies and project health |
 
 ## Workflow Commands

package/dist/cli.js

@@ -2,14 +2,14 @@
 import { Command } from 'commander';
 import { getLlama, resolveModelFile } from 'node-llama-cpp';
 import { mkdirSync, writeFileSync, statSync, unlinkSync, existsSync, readFileSync, copyFileSync, chmodSync, readdirSync } from 'fs';
-import { homedir } from 'os';
+import { homedir, tmpdir } from 'os';
 import path, { join, dirname, resolve, relative } from 'path';
 import * as fs from 'fs/promises';
 import { readFile, mkdir, appendFile, writeFile, chmod, rm, rename, readdir } from 'fs/promises';
 import { createHash } from 'crypto';
 import { z } from 'zod';
 import { createRequire } from 'module';
-import { execSync, execFileSync } from 'child_process';
+import { execSync, execFileSync, spawn } from 'child_process';
 import chalk from 'chalk';
 
 // src/cli-utils.ts
@@ -1135,6 +1135,171 @@ function registerCompoundCommands(program2) {
 var _require = createRequire(import.meta.url);
 var _pkg = _require("../package.json");
 var VERSION = _pkg.version;
+var SAMPLE_RATE = 22050;
+var BITS = 16;
+var MAX_AMP = 24576;
+var NOTE = {
+  C3: 131,
+  E3: 165,
+  G3: 196,
+  C4: 262,
+  E4: 330,
+  G4: 392,
+  C5: 523,
+  E5: 659,
+  G5: 784,
+  C6: 1047
+};
+function envelope(i, total, attack, release) {
+  if (i < attack) return i / attack;
+  if (i > total - release) return (total - i) / release;
+  return 1;
+}
+function tone(freq, durationMs, amp = 1) {
+  const samples = Math.floor(SAMPLE_RATE * durationMs / 1e3);
+  const attack = Math.min(Math.floor(samples * 0.05), 200);
+  const release = Math.min(Math.floor(samples * 0.15), 400);
+  const out2 = [];
+  for (let i = 0; i < samples; i++) {
+    const env = envelope(i, samples, attack, release);
+    out2.push(Math.sin(2 * Math.PI * freq * i / SAMPLE_RATE) * env * amp);
+  }
+  return out2;
+}
+function chord(freqs, durationMs, amp = 1) {
+  const tones = freqs.map((f) => tone(f, durationMs, 1));
+  const len = tones[0].length;
+  const out2 = [];
+  const scale = amp / freqs.length;
+  for (let i = 0; i < len; i++) {
+    let sum = 0;
+    for (const t of tones) sum += t[i];
+    out2.push(sum * scale);
+  }
+  return out2;
+}
+function silence(durationMs) {
+  return new Array(Math.floor(SAMPLE_RATE * durationMs / 1e3)).fill(0);
+}
+function composeMelody() {
+  const samples = [];
+  samples.push(...tone(NOTE.C3, 250, 0.3));
+  samples.push(...silence(150));
+  samples.push(...tone(NOTE.C3, 250, 0.35));
+  samples.push(...silence(100));
+  samples.push(...tone(NOTE.E3, 200, 0.3));
+  samples.push(...silence(80));
+  samples.push(...tone(NOTE.C4, 140, 0.45));
+  samples.push(...silence(30));
+  samples.push(...tone(NOTE.E4, 140, 0.5));
+  samples.push(...silence(30));
+  samples.push(...tone(NOTE.G4, 140, 0.5));
+  samples.push(...silence(30));
+  samples.push(...tone(NOTE.C5, 160, 0.55));
+  samples.push(...silence(30));
+  samples.push(...tone(NOTE.E5, 160, 0.55));
+  samples.push(...silence(30));
+  samples.push(...tone(NOTE.G5, 180, 0.6));
+  samples.push(...silence(60));
+  samples.push(...tone(NOTE.C4, 100, 0.4));
+  samples.push(...tone(NOTE.E4, 100, 0.45));
+  samples.push(...tone(NOTE.G4, 100, 0.45));
+  samples.push(...tone(NOTE.C5, 120, 0.5));
+  samples.push(...tone(NOTE.E5, 120, 0.55));
+  samples.push(...tone(NOTE.G5, 140, 0.6));
+  samples.push(...silence(60));
+  samples.push(...tone(NOTE.C6, 80, 0.3));
+  samples.push(...silence(40));
+  samples.push(...tone(NOTE.G5, 80, 0.35));
+  samples.push(...silence(40));
+  samples.push(...tone(NOTE.C6, 80, 0.3));
+  samples.push(...silence(40));
+  samples.push(...tone(NOTE.E5, 100, 0.35));
+  samples.push(...silence(60));
+  samples.push(...chord([NOTE.C4, NOTE.E4, NOTE.G4], 600, 0.7));
+  samples.push(...chord([NOTE.C4, NOTE.E4, NOTE.G4, NOTE.C5], 500, 0.6));
+  samples.push(...chord([NOTE.C3, NOTE.G3, NOTE.C4], 1200, 0.35));
+  return samples;
+}
+function encodeWav(samples) {
+  const dataSize = samples.length * (BITS / 8);
+  const fileSize = 44 + dataSize;
+  const buf = Buffer.alloc(fileSize);
+  buf.write("RIFF", 0);
+  buf.writeUInt32LE(fileSize - 8, 4);
+  buf.write("WAVE", 8);
+  buf.write("fmt ", 12);
+  buf.writeUInt32LE(16, 16);
+  buf.writeUInt16LE(1, 20);
+  buf.writeUInt16LE(1, 22);
+  buf.writeUInt32LE(SAMPLE_RATE, 24);
+  buf.writeUInt32LE(SAMPLE_RATE * BITS / 8, 28);
+  buf.writeUInt16LE(BITS / 8, 32);
+  buf.writeUInt16LE(BITS, 34);
+  buf.write("data", 36);
+  buf.writeUInt32LE(dataSize, 40);
+  let offset = 44;
+  for (const s of samples) {
+    const clamped = Math.max(-1, Math.min(1, s));
+    buf.writeInt16LE(Math.round(clamped * MAX_AMP), offset);
+    offset += 2;
+  }
+  return buf;
+}
+function spawnPlayer(filePath) {
+  try {
+    switch (process.platform) {
+      case "darwin":
+        return spawn("afplay", [filePath], { stdio: "ignore", detached: true });
+      case "linux":
+        return spawn("aplay", ["-q", filePath], { stdio: "ignore", detached: true });
+      case "win32":
+        return spawn("powershell", [
+          "-c",
+          `(New-Object Media.SoundPlayer '${filePath}').PlaySync()`
+        ], { stdio: "ignore", detached: true });
+      default:
+        return null;
+    }
+  } catch {
+    return null;
+  }
+}
+function playBannerAudio() {
+  try {
+    const wav = encodeWav(composeMelody());
+    const tmpPath = join(tmpdir(), `ca-banner-${process.pid}.wav`);
+    writeFileSync(tmpPath, wav);
+    const proc = spawnPlayer(tmpPath);
+    if (!proc) {
+      try {
+        unlinkSync(tmpPath);
+      } catch {
+      }
+      return null;
+    }
+    proc.unref();
+    const cleanup2 = () => {
+      try {
+        proc.kill();
+      } catch {
+      }
+      try {
+        unlinkSync(tmpPath);
+      } catch {
+      }
+    };
+    proc.on("exit", () => {
+      try {
+        unlinkSync(tmpPath);
+      } catch {
+      }
+    });
+    return { stop: cleanup2 };
+  } catch {
+    return null;
+  }
+}
 
 // src/setup/banner.ts
 var W = 62;
@@ -1316,6 +1481,7 @@ async function playInstallBanner() {
   const ps = [];
   const write = (s) => process.stdout.write(s);
   write("\x1B[?25l\x1B[2J\x1B[H");
+  const audio = playBannerAudio();
   const restoreCursor = () => process.stdout.write("\x1B[?25h\x1B[0m");
   process.on("exit", restoreCursor);
   try {
@@ -1327,7 +1493,7 @@ async function playInstallBanner() {
       put(cvs, nx(CENTER), ny(CENTER), seedCh[f % 4], seedCo[f % 4]);
       write(flush(cvs));
       write(`
-  ${CO.DIM}Seed detected...${CO.VOID}
+  ${CO.DIM}Seed detected...\x1B[K${CO.VOID}
 `);
       await sleep(60);
     }
@@ -1374,7 +1540,7 @@ async function playInstallBanner() {
       let active = 0;
       for (let i = 0; i < nc; i++) if (isGrown[i]) active++;
       write(`
-  \x1B[0;35mNodes \x1B[1;36m${active}\x1B[0;35m/${nc}\x1B[0m  \x1B[0;90mGrowing neural tendrils...\x1B[0m
+  \x1B[0;35mNodes \x1B[1;36m${active}\x1B[0;35m/${nc}\x1B[0m  \x1B[0;90mGrowing neural tendrils...\x1B[K\x1B[0m
 `);
       await sleep(40);
     }
@@ -1397,7 +1563,7 @@ async function playInstallBanner() {
       renderParticles(cvs, ps, f);
       write(flush(cvs));
       write(`
-  ${CO.SETTLED}Crystallizing pathways...${CO.VOID}
+  ${CO.SETTLED}Crystallizing pathways...\x1B[K${CO.VOID}
 `);
       await sleep(60);
     }
@@ -1473,6 +1639,7 @@ async function playInstallBanner() {
       await sleep(120);
     }
   } finally {
+    audio?.stop();
     process.removeListener("exit", restoreCursor);
     restoreCursor();
     write("\n");
@@ -4532,7 +4699,7 @@ npx ca loop --force            # Overwrite existing script
 ## Health, audit, and verification commands
 
 \`\`\`bash
-npx ca version-show             # Show version with animation and recent changelog
+npx ca about                    # Show version, animation, and recent changelog
 npx ca doctor                  # Check external dependencies and project health
 npx ca audit                   # Run pattern, rule, and lesson quality checks
 npx ca rules check             # Check codebase against .claude/rules.json
@@ -7365,11 +7532,30 @@ function registerVerifyGatesCommand(program2) {
 }
 
 // src/changelog-data.ts
-var CHANGELOG_RECENT = `## [1.3.1] - 2026-02-21
+var CHANGELOG_RECENT = `## [1.3.2] - 2026-02-21
 
 ### Added
 
-- **\`ca version-show\` command**: Displays version with terminal animation (tendril growth) and recent changelog entries. Non-TTY environments get plain text output. Changelog is embedded at build time from CHANGELOG.md.
+- **Banner audio**: Pure TypeScript WAV synthesis plays a rising pentatonic melody during the tendril animation. Cross-platform: \`afplay\` (macOS), \`aplay\` (Linux), PowerShell (Windows). Silently skips if player unavailable. Zero dependencies.
+- **Test coverage**: 19 new tests for \`ca about\` command, changelog extraction/escaping, and \`--update\` doc migration path
+
+### Fixed
+
+- **\`setup --update\` doc migration**: \`--update\` now installs the 5 split docs before removing legacy \`HOW_TO_COMPOUND.md\`, preventing empty \`docs/compound/\`
+- **Fresh checkout type-check**: \`src/changelog-data.ts\` tracked in git so \`tsc --noEmit\` passes without a prior build
+- **Trailing status text**: Banner animation no longer leaves "al tendrils..." remnant from previous phase
+
+### Changed
+
+- **\`ca about\` command**: Renamed from \`ca version-show\` for brevity
+- **Changelog extraction**: Core parsing/escaping logic extracted to \`scripts/changelog-utils.ts\` (shared between prebuild script and tests)
+- **Narrowed \`.gitignore\`**: Setup-generated patterns scoped to \`compound/\` subdirectories to avoid hiding tracked TDD agent definitions
+
+## [1.3.1] - 2026-02-21
+
+### Added
+
+- **\`ca about\` command**: Displays version with terminal animation (tendril growth) and recent changelog entries. Non-TTY environments get plain text output. Changelog is embedded at build time from CHANGELOG.md.
 - **3 new doctor checks**: Beads initialized (\`.beads/\` dir), beads healthy (\`bd doctor\`), codebase scope (user-scope detection)
 - **Beads + scope status in init/setup output**: Full beads health display (CLI available, initialized, healthy) and scope status shown after \`ca init\`, \`ca setup\`, and \`ca setup --update\`
 - **Banner on \`--update\`**: Terminal art animation now plays during \`ca setup --update\` and \`ca init --update\` (same TTY/quiet guards as fresh install)
@@ -7420,33 +7606,11 @@ var CHANGELOG_RECENT = `## [1.3.1] - 2026-02-21
 ### Removed
 
 - **5 deprecated CLI wrapper commands**: \`search.md\`, \`list.md\`, \`show.md\`, \`stats.md\`, \`wrong.md\` (redundant wrappers around \`npx ca <cmd>\`)
-- **\`GENERATED_MARKER\` on new installs**: New installs use path-based detection; marker retained only for backward-compatible \`--update\` detection
-
-## [1.2.11] - 2026-02-19
-
-### Added
-
-- **Git worktree integration** (\`ca worktree\`): Isolate epic work in separate git worktrees for parallel execution. Five subcommands:
-  - \`ca worktree create <epic-id>\` \u2014 Create worktree, install deps, copy lessons, create Merge beads task
-  - \`ca worktree wire-deps <epic-id>\` \u2014 Connect Review/Compound tasks as merge blockers (graceful no-op without worktree)
-  - \`ca worktree merge <epic-id>\` \u2014 Two-phase merge: resolve conflicts in worktree, then land clean on main
-  - \`ca worktree list\` \u2014 Show active worktrees with epic and merge task status
-  - \`ca worktree cleanup <epic-id>\` \u2014 Remove worktree, branch, and close Merge task (--force for dirty worktrees)
-- **\`/compound:set-worktree\` slash command**: Set up a worktree before running \`/compound:lfg\` for isolated epic execution
-- **Conditional Merge gate in \`verify-gates\`**: Worktree epics require the Merge task to be closed before epic closure. Non-worktree epics unaffected.
-- **Plan skill wire-deps step**: Plan phase now calls \`ca worktree wire-deps\` to connect merge dependencies when a worktree is active.
-
-### Changed
-
-- **Worktree merge safety hardening**: Added branch verification (asserts main repo is on \`main\`), worktree existence guard, structured error messages with worktree paths for conflict resolution and test failures
-- **JSONL reconciliation**: Switched from ID-based to line-based deduplication to preserve last-write-wins semantics for same-ID updates and deletes
-- **Worktree cleanup safety**: Branch deletion uses \`-d\` (safe) by default; \`-D\` (force) only with \`--force\` flag
-- **Shared beads utilities**: Extracted \`validateEpicId\`, \`parseBdShowDeps\`, and \`shortId\` to \`cli-utils.ts\`, eliminating duplication between \`worktree.ts\` and \`verify-gates.ts\`
-- **Sync API**: All worktree functions are now synchronous (removed misleading \`async\` wrapper around purely synchronous \`execFileSync\` calls)`;
+- **\`GENERATED_MARKER\` on new installs**: New installs use path-based detection; marker retained only for backward-compatible \`--update\` detection`;
 
-// src/commands/version-show.ts
-function registerVersionShowCommand(program2) {
-  program2.command("version-show").description("Show version with animation and recent changelog").action(async () => {
+// src/commands/about.ts
+function registerAboutCommand(program2) {
+  program2.command("about").description("Show version, animation, and recent changelog").action(async () => {
     if (process.stdout.isTTY) {
       await playInstallBanner();
     } else {
@@ -8564,7 +8728,7 @@ function registerManagementCommands(program2) {
   registerRulesCommands(program2);
   registerTestSummaryCommand(program2);
   registerVerifyGatesCommand(program2);
-  registerVersionShowCommand(program2);
+  registerAboutCommand(program2);
   registerWorktreeCommands(program2);
 }