compound-agent 1.3.1 → 1.3.3

package/CHANGELOG.md

@@ -9,11 +9,36 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.3.3] - 2026-02-21
+
+### Changed
+
+- **Banner audio**: Rewritten as vaporwave composition with PolyBLEP anti-aliased sawtooth synthesis, biquad filters, Schroeder reverb, and delay. E minor ambiguity resolves to E major at bloom, synced 300ms ahead of the visual climax (neural brain lighting up). Post-animation reverb tail holds 1.8s for natural dissolution.
+
+## [1.3.2] - 2026-02-21
+
+### Added
+
+- **Banner audio**: Pure TypeScript WAV synthesis 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,311 @@ function registerCompoundCommands(program2) {
 var _require = createRequire(import.meta.url);
 var _pkg = _require("../package.json");
 var VERSION = _pkg.version;
+var SR = 44100;
+var MAX_AMP = 28672;
+var E2 = 82.41;
+var B2 = 123.47;
+var E3 = 164.81;
+var B3 = 246.94;
+var E4 = 329.63;
+var Fs4 = 369.99;
+var Gs4 = 415.3;
+var B4 = 493.88;
+function polyBlep(phase, dt) {
+  if (phase < dt) {
+    const t = phase / dt;
+    return t + t - t * t - 1;
+  }
+  if (phase > 1 - dt) {
+    const t = (phase - 1) / dt;
+    return t * t + t + t + 1;
+  }
+  return 0;
+}
+function sawBL(freq, t, offset = 0) {
+  const dt = freq / SR;
+  const phase = ((freq * t + offset) % 1 + 1) % 1;
+  return 2 * phase - 1 - polyBlep(phase, dt);
+}
+function wideSaw(freq, t, cents = 10) {
+  const r = Math.pow(2, cents / 1200);
+  return (sawBL(freq, t, 0) + sawBL(freq * r, t, 0.33) + sawBL(freq / r, t, 0.66)) / 3;
+}
+var BiquadLPF = class {
+  constructor(Q = 0.707) {
+    this.Q = Q;
+  }
+  x1 = 0;
+  x2 = 0;
+  y1 = 0;
+  y2 = 0;
+  b0 = 0;
+  b1 = 0;
+  b2 = 0;
+  a1 = 0;
+  a2 = 0;
+  lastCut = -1;
+  process(x, cutoff) {
+    if (cutoff !== this.lastCut) {
+      this.lastCut = cutoff;
+      const w0 = 2 * Math.PI * Math.min(cutoff, SR * 0.45) / SR;
+      const sin0 = Math.sin(w0), cos0 = Math.cos(w0);
+      const alpha = sin0 / (2 * this.Q);
+      const a0 = 1 + alpha;
+      this.b0 = (1 - cos0) / 2 / a0;
+      this.b1 = (1 - cos0) / a0;
+      this.b2 = this.b0;
+      this.a1 = -2 * cos0 / a0;
+      this.a2 = (1 - alpha) / a0;
+    }
+    const y = this.b0 * x + this.b1 * this.x1 + this.b2 * this.x2 - this.a1 * this.y1 - this.a2 * this.y2;
+    this.x2 = this.x1;
+    this.x1 = x;
+    this.y2 = this.y1;
+    this.y1 = y;
+    return y;
+  }
+};
+function applyDelay(samples, ms, fb, wet, lpHz = 3e3) {
+  const len = Math.floor(SR * ms / 1e3);
+  const buf = new Float64Array(len);
+  const lpf = new BiquadLPF();
+  const out2 = [];
+  let i = 0;
+  for (const s of samples) {
+    const d = buf[i];
+    buf[i] = s + lpf.process(d, lpHz) * fb;
+    i = (i + 1) % len;
+    out2.push(s + d * wet);
+  }
+  return out2;
+}
+function applyReverb(samples, decayMs, wet) {
+  const combDs = [1116, 1188, 1277, 1356, 1422, 1491];
+  const apDs = [225, 341, 556];
+  function comb(input, delay, decay) {
+    const fb = Math.pow(1e-3, delay / (decay * SR / 1e3));
+    const buf = new Float64Array(delay);
+    const damp = new BiquadLPF(0.5);
+    const out3 = [];
+    let i = 0;
+    for (const s of input) {
+      const d = buf[i];
+      buf[i] = s + damp.process(d, 4500) * fb;
+      i = (i + 1) % delay;
+      out3.push(d);
+    }
+    return out3;
+  }
+  function allpass(input, delay, c = 0.5) {
+    const buf = new Float64Array(delay);
+    const out3 = [];
+    let i = 0;
+    for (const s of input) {
+      const d = buf[i];
+      const v = s + d * c;
+      buf[i] = v;
+      i = (i + 1) % delay;
+      out3.push(d - v * c);
+    }
+    return out3;
+  }
+  const pre = Math.floor(SR * 0.04);
+  const delayed = new Array(pre).fill(0);
+  for (const s of samples) delayed.push(s);
+  const combs = combDs.map((d) => comb(delayed, d, decayMs));
+  const sum = new Array(delayed.length).fill(0);
+  for (const c of combs)
+    for (let i = 0; i < sum.length; i++) sum[i] += (c[i] ?? 0) / combDs.length;
+  let ap = sum;
+  for (const d of apDs) ap = allpass(ap, d);
+  let hpY = 0;
+  const hpAlpha = 1 / SR / (1 / (2 * Math.PI * 120) + 1 / SR);
+  const clean = [];
+  for (const s of ap) {
+    hpY += hpAlpha * (s - hpY);
+    clean.push(s - hpY);
+  }
+  const outLen = Math.max(samples.length, clean.length);
+  const out2 = [];
+  for (let i = 0; i < outLen; i++) {
+    const dry = i < samples.length ? samples[i] : 0;
+    const w = i < clean.length ? clean[i] : 0;
+    out2.push(dry * (1 - wet * 0.3) + w * wet);
+  }
+  return out2;
+}
+function expCurve(x, pow = 2) {
+  return Math.pow(Math.max(0, Math.min(1, x)), pow);
+}
+function saturate(x) {
+  return Math.tanh(x * 1.15) / Math.tanh(1.15);
+}
+function voiceRoot(i, t, f) {
+  const atk = i < SR * 8e-3 ? i / (SR * 8e-3) : 1;
+  const dec = Math.exp(-t * 2.5);
+  const amp = atk * dec * 0.35;
+  if (amp < 1e-3) return 0;
+  const s = wideSaw(E2, t, 6) * 0.7 + Math.sin(2 * Math.PI * B2 * t) * 0.3;
+  return f.process(s, 800 + dec * 1200) * amp;
+}
+function voicePad(t, fE, fB) {
+  if (t < 1) return 0;
+  const padT = t - 1;
+  const fadeIn = expCurve(Math.min(1, padT / 1.8));
+  const fadeOut = t < 4 ? 1 : expCurve(1 - (t - 4) / 3.5, 1.5);
+  const amp = fadeIn * fadeOut * 0.2;
+  if (amp < 1e-3) return 0;
+  let cutoff;
+  if (t < 2.7) cutoff = 350 + padT / 1.7 * 850;
+  else if (t < 3.1) cutoff = 1200 + expCurve((t - 2.7) / 0.4) * 2800;
+  else cutoff = 4e3 - expCurve((t - 3.1) / 4, 1.3) * 3200;
+  cutoff *= 1 + 0.04 * Math.sin(2 * Math.PI * 0.11 * t);
+  const dE = 1 + 8e-4 * Math.sin(2 * Math.PI * 0.09 * t);
+  const dB = 1 + 7e-4 * Math.sin(2 * Math.PI * 0.12 * t + 0.5);
+  const e3 = fE.process(wideSaw(E3 * dE, t, 12), cutoff);
+  const b3 = fB.process(wideSaw(B3 * dB, t, 12), cutoff);
+  return (e3 * 0.55 + b3 * 0.45) * amp;
+}
+function voiceForeshadow(t, f) {
+  if (t < 2.3 || t >= 3.5) return 0;
+  const fT = t - 2.3;
+  const fadeIn = expCurve(Math.min(1, fT / 0.7));
+  const fadeOut = fT > 0.7 ? expCurve((1.2 - fT) / 0.5) : 1;
+  const amp = fadeIn * fadeOut * 0.07;
+  if (amp < 1e-3) return 0;
+  return f.process(Math.sin(2 * Math.PI * Fs4 * t), 3e3) * amp;
+}
+function voiceBloom(t, fE, fG, fB) {
+  if (t < 2.9) return 0;
+  const bT = t - 2.9;
+  const atk = Math.min(1, bT / 0.08);
+  const sus = bT < 1.5 ? 1 : Math.exp(-(bT - 1.5) * 0.8);
+  const amp = atk * sus;
+  if (amp < 2e-3) return 0;
+  const bloomF = bT < 0.3 ? 1500 + expCurve(bT / 0.3) * 3500 : 5e3 - expCurve(Math.min(1, (bT - 0.3) / 4), 1.2) * 3500;
+  const dE4 = 1 + 5e-4 * Math.sin(2 * Math.PI * 0.08 * t);
+  const e4 = fE.process(wideSaw(E4 * dE4, t, 8), bloomF);
+  let gs4 = 0;
+  if (bT > 0.03) {
+    const gsA = Math.min(1, (bT - 0.03) / 0.1);
+    const gsD = 1 + 6e-4 * Math.sin(2 * Math.PI * 0.1 * t + 1);
+    gs4 = fG.process(wideSaw(Gs4 * gsD, t, 9), bloomF) * gsA;
+  }
+  let b4 = 0;
+  if (bT > 0.05 && bT < 3) {
+    const bA = Math.min(1, (bT - 0.05) / 0.15) * (bT > 2 ? expCurve(1 - (bT - 2)) : 1);
+    b4 = fB.process(
+      Math.sin(2 * Math.PI * B4 * t) * 0.5 + wideSaw(B4, t, 6) * 0.5,
+      bloomF
+    ) * bA;
+  }
+  return (e4 * 0.35 + gs4 * 0.35 + b4 * 0.15) * amp * 0.28;
+}
+function voiceSub(t) {
+  const subIn = expCurve(Math.min(1, t / 2));
+  const subOut = t < 4.5 ? 1 : expCurve(1 - (t - 4.5) / 2.5, 1.5);
+  return Math.sin(2 * Math.PI * E2 * t) * subIn * subOut * 0.08;
+}
+function compose() {
+  const TOTAL = Math.floor(SR * 7.5);
+  const out2 = new Float64Array(TOTAL);
+  const f = [];
+  for (let i = 0; i < 7; i++) f.push(new BiquadLPF(0.6));
+  for (let i = 0; i < TOTAL; i++) {
+    const t = i / SR;
+    out2[i] = saturate(
+      voiceRoot(i, t, f[0]) + voicePad(t, f[1], f[2]) + voiceForeshadow(t, f[3]) + voiceBloom(t, f[4], f[5], f[6]) + voiceSub(t)
+    );
+  }
+  let result = Array.from(out2);
+  result = applyDelay(result, 520, 0.22, 0.18, 2800);
+  result = applyReverb(result, 4800, 0.4);
+  return result;
+}
+function encodeWav(raw) {
+  let peak = 0;
+  for (const s of raw) {
+    const a = Math.abs(s);
+    if (a > peak) peak = a;
+  }
+  const scale = peak > 0 ? 0.92 / peak : 1;
+  const dataSize = raw.length * 2;
+  const buf = Buffer.alloc(44 + dataSize);
+  buf.write("RIFF", 0);
+  buf.writeUInt32LE(36 + dataSize, 4);
+  buf.write("WAVE", 8);
+  buf.write("fmt ", 12);
+  buf.writeUInt32LE(16, 16);
+  buf.writeUInt16LE(1, 20);
+  buf.writeUInt16LE(1, 22);
+  buf.writeUInt32LE(SR, 24);
+  buf.writeUInt32LE(SR * 2, 28);
+  buf.writeUInt16LE(2, 32);
+  buf.writeUInt16LE(16, 34);
+  buf.write("data", 36);
+  buf.writeUInt32LE(dataSize, 40);
+  let off = 44;
+  for (const s of raw) {
+    buf.writeInt16LE(Math.round(Math.max(-1, Math.min(1, s * scale)) * MAX_AMP), off);
+    off += 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(compose());
+    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 +1621,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 +1633,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 +1680,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 +1703,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);
     }
@@ -1476,6 +1782,10 @@ async function playInstallBanner() {
     process.removeListener("exit", restoreCursor);
     restoreCursor();
     write("\n");
+    if (audio) {
+      await sleep(1800);
+      audio.stop();
+    }
   }
 }
 function checkBeadsAvailable() {
@@ -4532,7 +4842,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,88 +7675,51 @@ function registerVerifyGatesCommand(program2) {
 }
 
 // src/changelog-data.ts
-var CHANGELOG_RECENT = `## [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.
-- **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)
+var CHANGELOG_RECENT = `## [1.3.3] - 2026-02-21
 
 ### Changed
 
-- **Split documentation**: \`HOW_TO_COMPOUND.md\` replaced by 5 focused documents in \`docs/compound/\`: \`README.md\`, \`WORKFLOW.md\`, \`CLI_REFERENCE.md\`, \`SKILLS.md\`, \`INTEGRATION.md\`
-- **Test-cleaner Phase 3 strengthened**: Adversarial review phase now mandates iteration loop until both reviewers give unconditional approval. Heading, emphasis, and quality criteria updated.
-- **Update hint on upgrade**: When \`ca init\` or \`ca setup\` detects an existing install, displays tip to run with \`--update\` to regenerate managed files
-- **HOW_TO_COMPOUND.md migration**: \`ca setup --update\` automatically removes old monolithic \`HOW_TO_COMPOUND.md\` if it has version frontmatter (generated by compound-agent)
-- **Doctor doc check**: Now checks for \`docs/compound/README.md\` instead of \`HOW_TO_COMPOUND.md\`
+- **Banner audio**: Rewritten as vaporwave composition with PolyBLEP anti-aliased sawtooth synthesis, biquad filters, Schroeder reverb, and delay. E minor ambiguity resolves to E major at bloom, synced 300ms ahead of the visual climax (neural brain lighting up). Post-animation reverb tail holds 1.8s for natural dissolution.
 
-## [1.3.0] - 2026-02-21
+## [1.3.2] - 2026-02-21
 
 ### Added
 
-- **Setup hardening**: Four new pre-flight checks during \`ca init\` and \`ca setup\`:
-  - **Beads CLI check** (\`beads-check.ts\`): Detects if \`bd\` is available, shows install URL if missing (informational, non-blocking)
-  - **User-scope detection** (\`scope-check.ts\`): Warns when installing at home directory level where lessons are shared across projects
-  - **.gitignore injection** (\`gitignore.ts\`): Ensures \`node_modules/\` and \`.claude/.cache/\` patterns exist in \`.gitignore\`
-  - **Upgrade detection** (\`upgrade.ts\`): Detects existing installs and runs migration pipeline (deprecated command removal, header stripping, doc version update)
-- **Upgrade engine**: Automated migration from v1.2.x to v1.3.0:
-  - Removes 5 deprecated CLI wrapper commands (\`search.md\`, \`list.md\`, \`show.md\`, \`stats.md\`, \`wrong.md\`)
-  - Strips legacy \`<!-- generated by compound-agent -->\` headers from installed files
-  - Updates \`HOW_TO_COMPOUND.md\` version during upgrade
-- **\`/compound:research\` skill**: PhD-depth research producing structured survey documents following \`TEMPLATE_FOR_RESEARCH.md\` format
-- **\`/compound:test-clean\` skill**: 5-phase test suite optimization with adversarial review (audit, design, implement, verify, report)
-- **Documentation template**: \`HOW_TO_COMPOUND.md\` deployed to \`docs/compound/\` during setup with version and date placeholders
-- **Test scripts**: \`test:segment\` (run tests for specific module), \`test:random\` (seeded random subset), \`test:critical\` (*.critical.test.ts convention)
-- **3 new doctor checks**: Beads CLI availability, \`.gitignore\` health, usage documentation presence
+- **Banner audio**: Pure TypeScript WAV synthesis 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 --dry-run\` no longer mutates files**: \`runUpgrade()\` now accepts a \`dryRun\` parameter propagated to all sub-functions (removeDeprecatedCommands, stripGeneratedHeaders, upgradeDocVersion)
-- **\`setup --uninstall\` respects plugin.json ownership**: Checks \`name === "compound-agent"\` before deleting; user-owned plugin manifests are preserved
-- **Upgrade ownership guard**: \`removeDeprecatedCommands\` checks file content for compound-agent markers before deleting, preventing silent removal of user-authored files with the same name
-- **Malformed settings.json no longer silently clobbered**: On parse error, \`configureClaudeSettings\` warns and skips instead of overwriting with empty config
+- **\`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
 
-- **\`setup --update\` overhaul**: Now uses path-based file detection (compound/ = managed) instead of marker-based. Runs upgrade pipeline and \`.gitignore\` remediation during update
-- **JSON-first \`bd\` parsing in loop**: \`jq\` primary with \`python3\` fallback via \`parse_json()\` helper
-- **CLI test helpers hardened**: Replaced shell string interpolation with \`execFileSync\` for safety and reliability
-- **Beads check portable**: Uses POSIX \`command -v\` instead of non-portable \`which\`
-- **Template expansion**: Brainstorm and plan skills now cross-reference researcher skill; 9 total skills, 11 total commands
-- **Code organization**: Extracted display utilities to \`display-utils.ts\`, uninstall logic to \`uninstall.ts\`
+- **\`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
 
-### 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
+## [1.3.1] - 2026-02-21
 
 ### 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.
+- **\`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)
 
 ### 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)`;
+- **Split documentation**: \`HOW_TO_COMPOUND.md\` replaced by 5 focused documents in \`docs/compound/\`: \`README.md\`, \`WORKFLOW.md\`, \`CLI_REFERENCE.md\`, \`SKILLS.md\`, \`INTEGRATION.md\`
+- **Test-cleaner Phase 3 strengthened**: Adversarial review phase now mandates iteration loop until both reviewers give unconditional approval. Heading, emphasis, and quality criteria updated.
+- **Update hint on upgrade**: When \`ca init\` or \`ca setup\` detects an existing install, displays tip to run with \`--update\` to regenerate managed files
+- **HOW_TO_COMPOUND.md migration**: \`ca setup --update\` automatically removes old monolithic \`HOW_TO_COMPOUND.md\` if it has version frontmatter (generated by compound-agent)
+- **Doctor doc check**: Now checks for \`docs/compound/README.md\` instead of \`HOW_TO_COMPOUND.md\``;
 
-// 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 +8837,7 @@ function registerManagementCommands(program2) {
   registerRulesCommands(program2);
   registerTestSummaryCommand(program2);
   registerVerifyGatesCommand(program2);
-  registerVersionShowCommand(program2);
+  registerAboutCommand(program2);
   registerWorktreeCommands(program2);
 }