codehere 1.0.1 → 1.0.2

package/dist/infrastructure/orchestration/cassette-recorder.js

@@ -1,120 +0,0 @@
-/**
- * cassette-recorder · organic instrumentation for S2b of the capture-first plan.
- *
- * What it does:
- *   When CODEHERE_RECORD_CASSETTES=1 is set, every adapter spawn writes the
- *   raw stdout/stderr byte stream + exit to a JSONL cassette under
- *   ~/.codehere/cassettes/<adapter>/<scenario>-<ISO>.jsonl. The schema matches
- *   the locked L3b format (agent/src/testing/cassette.ts) so the same loader
- *   + replay infrastructure works on captures from real production sessions.
- *
- * Why this exists:
- *   Per chat 2026-05-23 (path 3 hybrid), we agreed cassettes accumulate from
- *   the founder's normal use rather than from dedicated capture sessions
- *   requiring fresh API keys. This module is the "accumulates" mechanism.
- *
- * Design choices:
- *   - OFF by default. Zero overhead when the env var is unset. The 5 adapters
- *     all call `startRecording()`, but it returns a no-op recorder if the
- *     env var isn't set, so the per-chunk hooks become free function calls.
- *   - Best-effort writes. A failed cassette never breaks the spawn path.
- *   - No PII scrubbing here · the user is recording their own sessions on
- *     their own machine. If we ever publish cassettes externally, scrubbing
- *     belongs in an export tool, not in the recorder.
- *   - One cassette per session (no append between sessions). Easier to reason
- *     about lifecycle, easier to discard / re-run, easier to ship in a PR.
- */
-import { appendFileSync, mkdirSync } from 'fs';
-import { homedir } from 'os';
-import { dirname, join } from 'path';
-const ENV_FLAG = 'CODEHERE_RECORD_CASSETTES';
-const NULL_RECORDER = {
-    enabled: false,
-    path: '',
-    onStdout() { },
-    onStderr() { },
-    onExit() { },
-};
-export function startRecording(opts) {
-    if (process.env[ENV_FLAG] !== '1')
-        return NULL_RECORDER;
-    const outDir = opts.outDir ?? join(process.env.CODEHERE_HOME || homedir(), '.codehere', 'cassettes', opts.adapter);
-    const scenario = `organic-${opts.sessionId.slice(0, 8)}`;
-    const stamp = new Date().toISOString().replace(/[:.]/g, '-');
-    const path = join(outDir, `${scenario}-${stamp}.jsonl`);
-    try {
-        mkdirSync(dirname(path), { recursive: true });
-    }
-    catch {
-        return NULL_RECORDER;
-    }
-    const start = Date.now();
-    const header = {
-        t: 0,
-        meta: {
-            adapter: opts.adapter,
-            scenario,
-            captured_at: new Date().toISOString(),
-            binary_version: opts.binary_version ?? 'unknown',
-            origin: 'real',
-            prompt: opts.prompt,
-            cwd_hint: hintCwd(opts.cwd),
-            schema: 1,
-        },
-    };
-    try {
-        appendFileSync(path, JSON.stringify(header) + '\n', 'utf-8');
-    }
-    catch {
-        return NULL_RECORDER;
-    }
-    let sealed = false;
-    return {
-        enabled: true,
-        path,
-        onStdout(chunk) {
-            if (sealed)
-                return;
-            writeEvent(path, { t: Date.now() - start, stream: 'stdout', data: chunk });
-        },
-        onStderr(chunk) {
-            if (sealed)
-                return;
-            writeEvent(path, { t: Date.now() - start, stream: 'stderr', data: chunk });
-        },
-        onExit(exit_code, signal) {
-            if (sealed)
-                return;
-            sealed = true;
-            writeEvent(path, { t: Date.now() - start, exit_code, signal });
-        },
-    };
-}
-/* ──────────────────────────────────────────────────────────────────────── */
-/* Internals                                                                 */
-/* ──────────────────────────────────────────────────────────────────────── */
-function writeEvent(path, payload) {
-    try {
-        appendFileSync(path, JSON.stringify(payload) + '\n', 'utf-8');
-    }
-    catch {
-        // best-effort · never break the spawn path
-    }
-}
-function hintCwd(cwd) {
-    if (!cwd)
-        return '.';
-    const home = homedir();
-    if (cwd === home)
-        return '~';
-    if (cwd.startsWith(home + '/'))
-        return '~/' + cwd.slice(home.length + 1);
-    return cwd;
-}
-/** Probe used by tests + the future status command. */
-export function isRecordingEnabled() {
-    return process.env[ENV_FLAG] === '1';
-}
-/** Returns the env flag name so callers can document it consistently. */
-export const RECORD_ENV_FLAG = ENV_FLAG;
-//# sourceMappingURL=cassette-recorder.js.map