@tienne/gestalt 0.5.1 → 0.7.0

package/dist/src/recording/gif-generator.js

@@ -0,0 +1,121 @@
+import { createReadStream, createWriteStream, existsSync } from 'node:fs';
+import { createInterface } from 'node:readline';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { Jimp, loadFont } from 'jimp';
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+import GIFEncoder from 'gifencoder';
+// ANSI escape code 제거 정규식
+const ANSI_RE = /\x1B\[[0-9;]*[a-zA-Z]|\x1B\][^\x07]*\x07|\x1B[()][A-Z0-9]|\r/g;
+// 터미널 렌더링 설정
+const CHAR_WIDTH = 9;
+const CHAR_HEIGHT = 18;
+const PADDING = 10;
+const BG_COLOR = 0x1e1e2eff; // dark background
+export class GifGenerator {
+    repeat;
+    quality;
+    frameDelay;
+    constructor(options = {}) {
+        this.repeat = options.repeat ?? 0;
+        this.quality = options.quality ?? 10;
+        this.frameDelay = options.frameDelay ?? 100;
+    }
+    /** .frames NDJSON 파일을 읽어 GIF 파일로 변환 */
+    async generate(framesPath, outputPath) {
+        if (!existsSync(framesPath)) {
+            throw new Error(`Frames file not found: ${framesPath}`);
+        }
+        const frames = await this.readFrames(framesPath);
+        if (frames.length === 0) {
+            throw new Error('No frames found in recording');
+        }
+        return this.encodeGif(frames, outputPath);
+    }
+    /** TerminalFrame 배열을 직접 받아 GIF 생성 (SegmentMerger에서 병합된 결과 사용) */
+    async generateFromFrames(frames, outputPath) {
+        if (frames.length === 0) {
+            throw new Error('No frames to encode');
+        }
+        return this.encodeGif(frames, outputPath);
+    }
+    async readFrames(framesPath) {
+        const frames = [];
+        const rl = createInterface({
+            input: createReadStream(framesPath),
+            crlfDelay: Infinity,
+        });
+        for await (const line of rl) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                const frame = JSON.parse(trimmed);
+                frames.push(frame);
+            }
+            catch {
+                // 파싱 실패한 라인 무시
+            }
+        }
+        return frames;
+    }
+    async encodeGif(frames, outputPath) {
+        const font = await this.loadTerminalFont();
+        const firstFrame = frames[0];
+        const width = firstFrame.cols * CHAR_WIDTH + PADDING * 2;
+        const height = firstFrame.rows * CHAR_HEIGHT + PADDING * 2;
+        const encoder = new GIFEncoder(width, height);
+        const outputStream = createWriteStream(outputPath);
+        encoder.createReadStream().pipe(outputStream);
+        encoder.start();
+        encoder.setRepeat(this.repeat);
+        encoder.setDelay(this.frameDelay);
+        encoder.setQuality(this.quality);
+        let prevTimestamp = frames[0].timestamp;
+        for (const frame of frames) {
+            const delay = Math.min(Math.max(frame.timestamp - prevTimestamp, 50), 3000);
+            encoder.setDelay(delay || this.frameDelay);
+            prevTimestamp = frame.timestamp;
+            const imageData = await this.renderFrame(frame, font, width, height);
+            encoder.addFrame(imageData);
+        }
+        encoder.finish();
+        await new Promise((resolve, reject) => {
+            outputStream.on('finish', resolve);
+            outputStream.on('error', reject);
+        });
+        const { statSync } = await import('node:fs');
+        const stat = statSync(outputPath);
+        return {
+            filePath: outputPath,
+            sizeBytes: stat.size,
+            frameCount: frames.length,
+            durationMs: frames[frames.length - 1].timestamp - frames[0].timestamp,
+        };
+    }
+    async renderFrame(frame, font, width, height) {
+        const image = new Jimp({ width, height, color: BG_COLOR });
+        const text = stripAnsi(frame.data);
+        const lines = text.split('\n');
+        let y = PADDING;
+        for (const line of lines) {
+            if (y >= height - PADDING)
+                break;
+            if (line.length > 0) {
+                image.print({ font, x: PADDING, y, text: line });
+            }
+            y += CHAR_HEIGHT;
+        }
+        return image.bitmap.data;
+    }
+    async loadTerminalFont() {
+        const req = createRequire(import.meta.url);
+        const jimpPath = req.resolve('jimp');
+        const fontPath = join(dirname(jimpPath), '../../../@jimp/plugin-print/fonts/open-sans/open-sans-16-white/open-sans-16-white.fnt');
+        return loadFont(fontPath);
+    }
+}
+function stripAnsi(str) {
+    return str.replace(ANSI_RE, '');
+}
+//# sourceMappingURL=gif-generator.js.map

package/dist/src/recording/gif-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gif-generator.js","sourceRoot":"","sources":["../../../src/recording/gif-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACtC,iEAAiE;AACjE,OAAO,UAAU,MAAM,YAAY,CAAC;AAGpC,0BAA0B;AAC1B,MAAM,OAAO,GAAG,+DAA+D,CAAC;AAEhF,aAAa;AACb,MAAM,UAAU,GAAG,CAAC,CAAC;AACrB,MAAM,WAAW,GAAG,EAAE,CAAC;AACvB,MAAM,OAAO,GAAG,EAAE,CAAC;AACnB,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,kBAAkB;AAQ/C,MAAM,OAAO,YAAY;IACN,MAAM,CAAS;IACf,OAAO,CAAS;IAChB,UAAU,CAAS;IAEpC,YAAY,UAA+B,EAAE;QAC3C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,GAAG,CAAC;IAC9C,CAAC;IAED,uCAAuC;IACvC,KAAK,CAAC,QAAQ,CAAC,UAAkB,EAAE,UAAkB;QACnD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,0BAA0B,UAAU,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QACjD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,kBAAkB,CAAC,MAAuB,EAAE,UAAkB;QAClE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,UAAkB;QACjC,MAAM,MAAM,GAAoB,EAAE,CAAC;QACnC,MAAM,EAAE,GAAG,eAAe,CAAC;YACzB,KAAK,EAAE,gBAAgB,CAAC,UAAU,CAAC;YACnC,SAAS,EAAE,QAAQ;SACpB,CAAC,CAAC;QAEH,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,EAAE,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAkB,CAAC;gBACnD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,eAAe;YACjB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,MAAuB,EAAE,UAAkB;QACjE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAE3C,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,GAAG,UAAU,GAAG,OAAO,GAAG,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,GAAG,WAAW,GAAG,OAAO,GAAG,CAAC,CAAC;QAE3D,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC9C,MAAM,YAAY,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;QACnD,OAAO,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAE9C,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEjC,IAAI,aAAa,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC,SAAS,CAAC;QAEzC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,GAAG,aAAa,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;YAC5E,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC;YAC3C,aAAa,GAAG,KAAK,CAAC,SAAS,CAAC;YAEhC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YACrE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO,CAAC,MAAM,EAAE,CAAC;QAEjB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACnC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;QAElC,OAAO;YACL,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,IAAI,CAAC,IAAI;YACpB,UAAU,EAAE,MAAM,CAAC,MAAM;YACzB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC,SAAS;SACxE,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,WAAW,CACvB,KAAoB,EACpB,IAA0C,EAC1C,KAAa,EACb,MAAc;QAEd,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE3D,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE/B,IAAI,CAAC,GAAG,OAAO,CAAC;QAChB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,MAAM,GAAG,OAAO;gBAAE,MAAM;YACjC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,KAAK,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,CAAC;YACD,CAAC,IAAI,WAAW,CAAC;QACnB,CAAC;QAED,OAAO,KAAK,CAAC,MAAM,CAAC,IAAc,CAAC;IACrC,CAAC;IAEO,KAAK,CAAC,gBAAgB;QAC5B,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAG,IAAI,CACnB,OAAO,CAAC,QAAQ,CAAC,EACjB,uFAAuF,CACxF,CAAC;QACF,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;CACF;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAClC,CAAC"}

package/dist/src/recording/recording-dir.d.ts

@@ -0,0 +1,5 @@
+export declare const RECORDINGS_BASE_DIR = ".gestalt/recordings";
+/** sessionId에 대한 .frames 파일 경로를 반환하고, 부모 디렉토리가 없으면 생성한다 */
+export declare function ensureRecordingsDir(): void;
+export declare function getFramesPath(sessionId: string): string;
+//# sourceMappingURL=recording-dir.d.ts.map

package/dist/src/recording/recording-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-dir.d.ts","sourceRoot":"","sources":["../../../src/recording/recording-dir.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAEzD,2DAA2D;AAC3D,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/src/recording/recording-dir.js

@@ -0,0 +1,13 @@
+import { mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+export const RECORDINGS_BASE_DIR = '.gestalt/recordings';
+/** sessionId에 대한 .frames 파일 경로를 반환하고, 부모 디렉토리가 없으면 생성한다 */
+export function ensureRecordingsDir() {
+    if (!existsSync(RECORDINGS_BASE_DIR)) {
+        mkdirSync(RECORDINGS_BASE_DIR, { recursive: true });
+    }
+}
+export function getFramesPath(sessionId) {
+    return join(RECORDINGS_BASE_DIR, `${sessionId}.frames`);
+}
+//# sourceMappingURL=recording-dir.js.map

package/dist/src/recording/recording-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-dir.js","sourceRoot":"","sources":["../../../src/recording/recording-dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAEzD,2DAA2D;AAC3D,MAAM,UAAU,mBAAmB;IACjC,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACrC,SAAS,CAAC,mBAAmB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,OAAO,IAAI,CAAC,mBAAmB,EAAE,GAAG,SAAS,SAAS,CAAC,CAAC;AAC1D,CAAC"}

package/dist/src/recording/recording-orchestrator.d.ts

@@ -0,0 +1,50 @@
+import type { LLMAdapter } from '../llm/types.js';
+export interface RecordingOptions {
+    /** --record 또는 -r 플래그 */
+    record?: boolean;
+    /** --mp4 플래그 — GIF와 함께 mp4도 생성 */
+    mp4?: boolean;
+    /** 출력 디렉토리 (기본값: 현재 디렉토리) */
+    outputDir?: string;
+}
+/**
+ * RecordingOrchestrator: asciinema 기반 녹화의 전체 생명주기를 조율한다.
+ *
+ * 사용 패턴 (interview CLI):
+ *
+ * 1. startIfNeeded() — interview 시작 전 호출. --record 플래그가 있고
+ *    아직 asciinema로 감싸지지 않았으면 self-respawn으로 재실행.
+ *
+ * 2. stopAndConvert() — interview 완료 후 호출. 백그라운드 비동기로
+ *    .cast → GIF (→ mp4) 변환을 트리거한다.
+ */
+export declare class RecordingOrchestrator {
+    private readonly llm;
+    private readonly asciinemaInstaller;
+    private readonly aggInstaller;
+    private readonly converter;
+    constructor(llm: LLMAdapter);
+    /**
+     * 필요하면 asciinema 녹화를 시작한다.
+     * - GESTALT_RECORDING=1이면 이미 asciinema 안에 있으므로 아무것도 하지 않음.
+     * - --record 플래그가 있으면 asciinema를 설치하고 self-respawn.
+     * - 재실행 후에는 process.exit()이 호출되므로 이 함수는 return하지 않을 수 있음.
+     */
+    startIfNeeded(options: RecordingOptions): Promise<void>;
+    /**
+     * 현재 프로세스가 asciinema로 녹화 중인지 확인.
+     * GESTALT_CAST_PATH 환경변수가 있으면 true.
+     */
+    isRecording(): boolean;
+    /**
+     * 녹화를 종료하고 GIF (+ mp4) 변환을 백그라운드로 트리거한다.
+     * asciinema는 부모 프로세스(respawned)에서 자동 종료되므로
+     * 여기서는 cast 파일 경로를 읽어 변환만 시작한다.
+     *
+     * @param topic - 인터뷰 주제 (파일명 생성용)
+     * @param sessionId - 세션 ID (파일명 생성용)
+     * @param options - 녹화 옵션
+     */
+    stopAndConvert(topic: string, sessionId: string, options?: RecordingOptions): Promise<void>;
+}
+//# sourceMappingURL=recording-orchestrator.d.ts.map

package/dist/src/recording/recording-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-orchestrator.d.ts","sourceRoot":"","sources":["../../../src/recording/recording-orchestrator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,WAAW,gBAAgB;IAC/B,yBAAyB;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,qBAAqB;IAKpB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAJhC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA4B;IAC/D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;gBAEnB,GAAG,EAAE,UAAU;IAE5C;;;;;OAKG;IACG,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAY7D;;;OAGG;IACH,WAAW,IAAI,OAAO;IAItB;;;;;;;;OAQG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;CAyCtG"}

package/dist/src/recording/recording-orchestrator.js

@@ -0,0 +1,98 @@
+import { AsciinemaInstaller } from './asciinema-installer.js';
+import { AsciinemaRecorder } from './asciinema-recorder.js';
+import { AggInstaller } from './agg-installer.js';
+import { AggConverter } from './agg-converter.js';
+import { FilenameGenerator } from './filename-generator.js';
+/**
+ * RecordingOrchestrator: asciinema 기반 녹화의 전체 생명주기를 조율한다.
+ *
+ * 사용 패턴 (interview CLI):
+ *
+ * 1. startIfNeeded() — interview 시작 전 호출. --record 플래그가 있고
+ *    아직 asciinema로 감싸지지 않았으면 self-respawn으로 재실행.
+ *
+ * 2. stopAndConvert() — interview 완료 후 호출. 백그라운드 비동기로
+ *    .cast → GIF (→ mp4) 변환을 트리거한다.
+ */
+export class RecordingOrchestrator {
+    llm;
+    asciinemaInstaller = new AsciinemaInstaller();
+    aggInstaller = new AggInstaller();
+    converter = new AggConverter();
+    constructor(llm) {
+        this.llm = llm;
+    }
+    /**
+     * 필요하면 asciinema 녹화를 시작한다.
+     * - GESTALT_RECORDING=1이면 이미 asciinema 안에 있으므로 아무것도 하지 않음.
+     * - --record 플래그가 있으면 asciinema를 설치하고 self-respawn.
+     * - 재실행 후에는 process.exit()이 호출되므로 이 함수는 return하지 않을 수 있음.
+     */
+    async startIfNeeded(options) {
+        if (!options.record)
+            return;
+        if (AsciinemaRecorder.isInsideRecording())
+            return;
+        await this.asciinemaInstaller.ensureInstalled();
+        const castPath = AsciinemaRecorder.createTempCastPath();
+        console.log('📹 Starting asciinema recording...\n');
+        AsciinemaRecorder.respawnWithAsciinema(castPath);
+        // respawnWithAsciinema calls process.exit() — 이 줄은 실행되지 않음
+    }
+    /**
+     * 현재 프로세스가 asciinema로 녹화 중인지 확인.
+     * GESTALT_CAST_PATH 환경변수가 있으면 true.
+     */
+    isRecording() {
+        return AsciinemaRecorder.isInsideRecording() && !!AsciinemaRecorder.getCurrentCastPath();
+    }
+    /**
+     * 녹화를 종료하고 GIF (+ mp4) 변환을 백그라운드로 트리거한다.
+     * asciinema는 부모 프로세스(respawned)에서 자동 종료되므로
+     * 여기서는 cast 파일 경로를 읽어 변환만 시작한다.
+     *
+     * @param topic - 인터뷰 주제 (파일명 생성용)
+     * @param sessionId - 세션 ID (파일명 생성용)
+     * @param options - 녹화 옵션
+     */
+    async stopAndConvert(topic, sessionId, options = {}) {
+        const castPath = AsciinemaRecorder.getCurrentCastPath();
+        if (!castPath)
+            return;
+        try {
+            await this.aggInstaller.ensureInstalled();
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`⚠️  agg installation failed: ${msg}`);
+            console.error('  GIF conversion skipped. The .cast file is preserved at:', castPath);
+            return;
+        }
+        const filenameGen = new FilenameGenerator(this.llm, { outputDir: options.outputDir });
+        const gifPath = await filenameGen.generate(topic, sessionId);
+        console.log('\n🎬 Converting recording to GIF in background...');
+        // 백그라운드 비동기 — await하지 않음
+        void this.converter
+            .convertAsync(castPath, gifPath, {
+            deleteCastAfter: true,
+            onComplete: (outputPath) => {
+                console.log(`✅ GIF saved: ${outputPath}\n`);
+                if (options.mp4) {
+                    const mp4Path = outputPath.replace(/\.gif$/, '.mp4');
+                    void this.converter.convertGifToMp4Async(outputPath, mp4Path, {
+                        onComplete: (p) => console.log(`✅ MP4 saved: ${p}\n`),
+                        onError: (e) => console.error(`⚠️  MP4 conversion failed: ${e.message}`),
+                    });
+                }
+            },
+            onError: (err) => {
+                console.error(`⚠️  GIF conversion failed: ${err.message}`);
+                console.error('  The .cast file may be preserved at:', castPath);
+            },
+        })
+            .catch(() => {
+            // onError에서 처리됨
+        });
+    }
+}
+//# sourceMappingURL=recording-orchestrator.js.map

package/dist/src/recording/recording-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-orchestrator.js","sourceRoot":"","sources":["../../../src/recording/recording-orchestrator.ts"],"names":[],"mappings":"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"}

package/dist/src/recording/resume-detector.d.ts

@@ -0,0 +1,10 @@
+export interface ResumeInfo {
+    isResuming: boolean;
+    framesPath: string;
+}
+/**
+ * sessionId에 해당하는 .frames 임시 파일이 존재하는지 확인한다.
+ * 존재하면 이전 녹화를 이어붙일 수 있음을 의미한다.
+ */
+export declare function detectResume(sessionId: string): ResumeInfo;
+//# sourceMappingURL=resume-detector.d.ts.map

package/dist/src/recording/resume-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume-detector.d.ts","sourceRoot":"","sources":["../../../src/recording/resume-detector.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAM1D"}

package/dist/src/recording/resume-detector.js

@@ -0,0 +1,14 @@
+import { existsSync } from 'node:fs';
+import { getFramesPath } from './recording-dir.js';
+/**
+ * sessionId에 해당하는 .frames 임시 파일이 존재하는지 확인한다.
+ * 존재하면 이전 녹화를 이어붙일 수 있음을 의미한다.
+ */
+export function detectResume(sessionId) {
+    const framesPath = getFramesPath(sessionId);
+    return {
+        isResuming: existsSync(framesPath),
+        framesPath,
+    };
+}
+//# sourceMappingURL=resume-detector.js.map

package/dist/src/recording/resume-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume-detector.js","sourceRoot":"","sources":["../../../src/recording/resume-detector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOnD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,MAAM,UAAU,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAC5C,OAAO;QACL,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC;QAClC,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/src/recording/segment-merger.d.ts

@@ -0,0 +1,27 @@
+import type { TerminalFrame } from '../core/types.js';
+import { GifGenerator } from './gif-generator.js';
+/**
+ * SegmentMerger: 동일 sessionId의 여러 .frames 파일 세그먼트를
+ * 시간순으로 병합해 GifGenerator에 전달한다.
+ *
+ * 현재 아키텍처에서는 sessionId당 .frames 파일이 1개이므로,
+ * 단일 파일 읽기도 이 클래스를 경유해 일관된 인터페이스를 유지한다.
+ */
+export declare class SegmentMerger {
+    private readonly gifGenerator;
+    constructor(gifGenerator?: GifGenerator);
+    /**
+     * 여러 .frames 파일을 읽어 타임스탬프 기준 오름차순으로 병합한다.
+     * 각 세그먼트 사이의 긴 갭(5초 이상)은 3초로 압축한다.
+     */
+    mergeFrameFiles(framesPaths: string[]): Promise<TerminalFrame[]>;
+    /**
+     * 단일 .frames 파일 읽기 (공통 인터페이스 유지)
+     */
+    readSingleFile(framesPath: string): Promise<TerminalFrame[]>;
+    /**
+     * 타임스탬프를 오름차순 정렬하고 큰 갭을 압축한다.
+     */
+    private normalizeTimestamps;
+}
+//# sourceMappingURL=segment-merger.d.ts.map

package/dist/src/recording/segment-merger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"segment-merger.d.ts","sourceRoot":"","sources":["../../../src/recording/segment-merger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAEhC,YAAY,CAAC,EAAE,YAAY;IAIvC;;;OAGG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAYtE;;OAEG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAIlE;;OAEG;IACH,OAAO,CAAC,mBAAmB;CA4B5B"}

package/dist/src/recording/segment-merger.js

@@ -0,0 +1,65 @@
+import { existsSync } from 'node:fs';
+import { GifGenerator } from './gif-generator.js';
+/**
+ * SegmentMerger: 동일 sessionId의 여러 .frames 파일 세그먼트를
+ * 시간순으로 병합해 GifGenerator에 전달한다.
+ *
+ * 현재 아키텍처에서는 sessionId당 .frames 파일이 1개이므로,
+ * 단일 파일 읽기도 이 클래스를 경유해 일관된 인터페이스를 유지한다.
+ */
+export class SegmentMerger {
+    gifGenerator;
+    constructor(gifGenerator) {
+        this.gifGenerator = gifGenerator ?? new GifGenerator();
+    }
+    /**
+     * 여러 .frames 파일을 읽어 타임스탬프 기준 오름차순으로 병합한다.
+     * 각 세그먼트 사이의 긴 갭(5초 이상)은 3초로 압축한다.
+     */
+    async mergeFrameFiles(framesPaths) {
+        const allFrames = [];
+        for (const framesPath of framesPaths) {
+            if (!existsSync(framesPath))
+                continue;
+            const frames = await this.gifGenerator.readFrames(framesPath);
+            allFrames.push(...frames);
+        }
+        return this.normalizeTimestamps(allFrames);
+    }
+    /**
+     * 단일 .frames 파일 읽기 (공통 인터페이스 유지)
+     */
+    async readSingleFile(framesPath) {
+        return this.mergeFrameFiles([framesPath]);
+    }
+    /**
+     * 타임스탬프를 오름차순 정렬하고 큰 갭을 압축한다.
+     */
+    normalizeTimestamps(frames) {
+        if (frames.length === 0)
+            return [];
+        // 타임스탬프 오름차순 정렬
+        frames.sort((a, b) => a.timestamp - b.timestamp);
+        // 세그먼트 갭 압축: 5초 이상 빈 구간은 3초로 압축
+        const GAP_THRESHOLD_MS = 5000;
+        const MAX_GAP_MS = 3000;
+        const normalized = [frames[0]];
+        for (let i = 1; i < frames.length; i++) {
+            const curr = frames[i];
+            const prev_frame = frames[i - 1];
+            const gap = curr.timestamp - prev_frame.timestamp;
+            if (gap > GAP_THRESHOLD_MS) {
+                const prev = normalized[normalized.length - 1];
+                normalized.push({
+                    ...curr,
+                    timestamp: prev.timestamp + MAX_GAP_MS,
+                });
+            }
+            else {
+                normalized.push(curr);
+            }
+        }
+        return normalized;
+    }
+}
+//# sourceMappingURL=segment-merger.js.map

package/dist/src/recording/segment-merger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"segment-merger.js","sourceRoot":"","sources":["../../../src/recording/segment-merger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IACP,YAAY,CAAe;IAE5C,YAAY,YAA2B;QACrC,IAAI,CAAC,YAAY,GAAG,YAAY,IAAI,IAAI,YAAY,EAAE,CAAC;IACzD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CAAC,WAAqB;QACzC,MAAM,SAAS,GAAoB,EAAE,CAAC;QAEtC,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;gBAAE,SAAS;YACtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YAC9D,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QAC5B,CAAC;QAED,OAAO,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,UAAkB;QACrC,OAAO,IAAI,CAAC,eAAe,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,MAAuB;QACjD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEnC,gBAAgB;QAChB,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;QAEjD,gCAAgC;QAChC,MAAM,gBAAgB,GAAG,IAAI,CAAC;QAC9B,MAAM,UAAU,GAAG,IAAI,CAAC;QAExB,MAAM,UAAU,GAAoB,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC;QACjD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;YACxB,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;YAClC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;YAClD,IAAI,GAAG,GAAG,gBAAgB,EAAE,CAAC;gBAC3B,MAAM,IAAI,GAAG,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;gBAChD,UAAU,CAAC,IAAI,CAAC;oBACd,GAAG,IAAI;oBACP,SAAS,EAAE,IAAI,CAAC,SAAS,GAAG,UAAU;iBACvC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;CACF"}

package/dist/src/recording/terminal-recorder.d.ts

@@ -0,0 +1,31 @@
+import type { RecordingSegment } from '../core/types.js';
+/**
+ * TerminalRecorder: process.stdout.write를 인터셉트하여
+ * TerminalFrame을 .frames NDJSON 파일에 실시간 append한다.
+ *
+ * node-pty 없이도 동작하지만, PTY 기반 캡처가 필요한 경우
+ * 향후 node-pty 통합으로 확장 가능하도록 설계한다.
+ */
+export declare class TerminalRecorder {
+    private readonly sessionId;
+    private readonly framesPath;
+    private segment;
+    private isRecording;
+    private frameBuffer;
+    private originalStdoutWrite;
+    constructor(sessionId: string);
+    /** 녹화 시작. 기존 .frames 파일이 있으면 이어서 append (resume) */
+    start(): RecordingSegment;
+    /** 녹화 일시 중지 (세션 중단 시) */
+    pause(): void;
+    /** 녹화 완전 종료 */
+    stop(): RecordingSegment | null;
+    get recording(): boolean;
+    get framesFilePath(): string;
+    /** stdout.write 인터셉트 */
+    private interceptStdout;
+    private restoreStdout;
+    private captureFrame;
+    private flushBuffer;
+}
+//# sourceMappingURL=terminal-recorder.d.ts.map

package/dist/src/recording/terminal-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-recorder.d.ts","sourceRoot":"","sources":["../../../src/recording/terminal-recorder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAExE;;;;;;GAMG;AACH,qBAAa,gBAAgB;IASf,OAAO,CAAC,QAAQ,CAAC,SAAS;IARtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAuB;IAG1C,OAAO,CAAC,mBAAmB,CAA+B;gBAE7B,SAAS,EAAE,MAAM;IAK9C,oDAAoD;IACpD,KAAK,IAAI,gBAAgB;IAoBzB,yBAAyB;IACzB,KAAK,IAAI,IAAI;IAUb,eAAe;IACf,IAAI,IAAI,gBAAgB,GAAG,IAAI;IAO/B,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,wBAAwB;IACxB,OAAO,CAAC,eAAe;IA2BvB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,WAAW;CAMpB"}

package/dist/src/recording/terminal-recorder.js

@@ -0,0 +1,111 @@
+import { appendFileSync, existsSync } from 'node:fs';
+import { ensureRecordingsDir, getFramesPath } from './recording-dir.js';
+/**
+ * TerminalRecorder: process.stdout.write를 인터셉트하여
+ * TerminalFrame을 .frames NDJSON 파일에 실시간 append한다.
+ *
+ * node-pty 없이도 동작하지만, PTY 기반 캡처가 필요한 경우
+ * 향후 node-pty 통합으로 확장 가능하도록 설계한다.
+ */
+export class TerminalRecorder {
+    sessionId;
+    framesPath;
+    segment = null;
+    isRecording = false;
+    frameBuffer = [];
+    // 원본 stdout.write 저장
+    originalStdoutWrite;
+    constructor(sessionId) {
+        this.sessionId = sessionId;
+        ensureRecordingsDir();
+        this.framesPath = getFramesPath(sessionId);
+    }
+    /** 녹화 시작. 기존 .frames 파일이 있으면 이어서 append (resume) */
+    start() {
+        if (this.isRecording)
+            return this.segment;
+        const isResuming = existsSync(this.framesPath);
+        this.segment = {
+            sessionId: this.sessionId,
+            framesPath: this.framesPath,
+            startedAt: Date.now(),
+        };
+        this.isRecording = true;
+        this.interceptStdout();
+        if (!isResuming) {
+            // 새 녹화: 빈 파일로 시작
+        }
+        return this.segment;
+    }
+    /** 녹화 일시 중지 (세션 중단 시) */
+    pause() {
+        if (!this.isRecording)
+            return;
+        this.restoreStdout();
+        this.flushBuffer();
+        if (this.segment) {
+            this.segment.endedAt = Date.now();
+        }
+        this.isRecording = false;
+    }
+    /** 녹화 완전 종료 */
+    stop() {
+        if (this.isRecording) {
+            this.pause();
+        }
+        return this.segment;
+    }
+    get recording() {
+        return this.isRecording;
+    }
+    get framesFilePath() {
+        return this.framesPath;
+    }
+    /** stdout.write 인터셉트 */
+    interceptStdout() {
+        const self = this;
+        this.originalStdoutWrite = process.stdout.write.bind(process.stdout);
+        // overwrite with interceptor
+        const intercepted = function (chunk, encodingOrCallback, callback) {
+            const data = typeof chunk === 'string' ? chunk : Buffer.from(chunk).toString('utf8');
+            self.captureFrame(data);
+            // 원본 write 호출
+            if (typeof encodingOrCallback === 'function') {
+                return self.originalStdoutWrite(chunk, encodingOrCallback);
+            }
+            if (typeof encodingOrCallback === 'string') {
+                return self.originalStdoutWrite(chunk, encodingOrCallback, callback);
+            }
+            return self.originalStdoutWrite(chunk);
+        };
+        process.stdout.write = intercepted;
+    }
+    restoreStdout() {
+        if (this.originalStdoutWrite) {
+            process.stdout.write = this.originalStdoutWrite;
+        }
+    }
+    captureFrame(data) {
+        if (!data || !this.isRecording)
+            return;
+        const frame = {
+            timestamp: Date.now(),
+            data,
+            cols: process.stdout.columns ?? 80,
+            rows: process.stdout.rows ?? 24,
+        };
+        this.frameBuffer.push(frame);
+        // 버퍼가 10개 이상 쌓이면 즉시 flush
+        if (this.frameBuffer.length >= 10) {
+            this.flushBuffer();
+        }
+    }
+    flushBuffer() {
+        if (this.frameBuffer.length === 0)
+            return;
+        const lines = this.frameBuffer.map((f) => JSON.stringify(f)).join('\n') + '\n';
+        appendFileSync(this.framesPath, lines, 'utf8');
+        this.frameBuffer = [];
+    }
+}
+//# sourceMappingURL=terminal-recorder.js.map

package/dist/src/recording/terminal-recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-recorder.js","sourceRoot":"","sources":["../../../src/recording/terminal-recorder.ts"],"names":[],"mappings":"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"}

package/dist/src/scripts/postinstall.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=postinstall.d.ts.map

package/dist/src/scripts/postinstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postinstall.d.ts","sourceRoot":"","sources":["../../../src/scripts/postinstall.ts"],"names":[],"mappings":""}

package/dist/src/scripts/postinstall.js

@@ -0,0 +1,27 @@
+/**
+ * Postinstall script: auto-setup agg for GIF recording support.
+ * Runs after: npm install @tienne/gestalt
+ *
+ * - Silently skips in CI or if GESTALT_SKIP_DEPS=1
+ * - Always exits 0 (never fails the install)
+ */
+import { AggInstaller } from '../recording/agg-installer.js';
+async function main() {
+    if (process.env['CI'] || process.env['GESTALT_SKIP_DEPS'] === '1') {
+        return;
+    }
+    const installer = new AggInstaller();
+    if (installer.isInstalled())
+        return;
+    process.stdout.write('\n[gestalt] agg not found — setting up GIF recording support...\n');
+    try {
+        await installer.ensureInstalled();
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stdout.write(`[gestalt] Skipping agg setup: ${msg}\n`);
+        process.stdout.write('[gestalt] Install manually later: https://github.com/asciinema/agg\n\n');
+    }
+}
+main().then(() => process.exit(0)).catch(() => process.exit(0));
+//# sourceMappingURL=postinstall.js.map