compound-agent 1.3.2 → 1.3.3

package/CHANGELOG.md

@@ -9,11 +9,17 @@ 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 plays a rising pentatonic melody during the tendril animation. Cross-platform: `afplay` (macOS), `aplay` (Linux), PowerShell (Windows). Silently skips if player unavailable. Zero dependencies.
+- **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

package/dist/cli.js

@@ -1135,114 +1135,254 @@ 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
+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 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);
+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 = [];
-  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);
+  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 chord(freqs, durationMs, amp = 1) {
-  const tones = freqs.map((f) => tone(f, durationMs, 1));
-  const len = tones[0].length;
+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 = [];
-  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);
+  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 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);
+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(fileSize - 8, 4);
+  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(SAMPLE_RATE, 24);
-  buf.writeUInt32LE(SAMPLE_RATE * BITS / 8, 28);
-  buf.writeUInt16LE(BITS / 8, 32);
-  buf.writeUInt16LE(BITS, 34);
+  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 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;
+  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;
 }
@@ -1267,7 +1407,7 @@ function spawnPlayer(filePath) {
 }
 function playBannerAudio() {
   try {
-    const wav = encodeWav(composeMelody());
+    const wav = encodeWav(compose());
     const tmpPath = join(tmpdir(), `ca-banner-${process.pid}.wav`);
     writeFileSync(tmpPath, wav);
     const proc = spawnPlayer(tmpPath);
@@ -1639,10 +1779,13 @@ async function playInstallBanner() {
       await sleep(120);
     }
   } finally {
-    audio?.stop();
     process.removeListener("exit", restoreCursor);
     restoreCursor();
     write("\n");
+    if (audio) {
+      await sleep(1800);
+      audio.stop();
+    }
   }
 }
 function checkBeadsAvailable() {
@@ -7532,11 +7675,17 @@ function registerVerifyGatesCommand(program2) {
 }
 
 // src/changelog-data.ts
-var CHANGELOG_RECENT = `## [1.3.2] - 2026-02-21
+var CHANGELOG_RECENT = `## [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 plays a rising pentatonic melody during the tendril animation. Cross-platform: \`afplay\` (macOS), \`aplay\` (Linux), PowerShell (Windows). Silently skips if player unavailable. Zero dependencies.
+- **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
@@ -7566,47 +7715,7 @@ var CHANGELOG_RECENT = `## [1.3.2] - 2026-02-21
 - **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\`
-
-## [1.3.0] - 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
-
-### 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
-
-### 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\`
-
-### 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`;
+- **Doctor doc check**: Now checks for \`docs/compound/README.md\` instead of \`HOW_TO_COMPOUND.md\``;
 
 // src/commands/about.ts
 function registerAboutCommand(program2) {