@tienne/gestalt 0.5.1 → 0.7.0

package/dist/src/recording/agg-converter.d.ts

@@ -0,0 +1,25 @@
+export interface ConvertOptions {
+    /** 변환 완료 후 .cast 파일을 삭제할지 여부 (기본값: true) */
+    deleteCastAfter?: boolean;
+    /** 변환 완료 콜백 (파일 경로 출력 등) */
+    onComplete?: (outputPath: string) => void;
+    /** 변환 실패 콜백 */
+    onError?: (err: Error) => void;
+}
+/**
+ * AggConverter: agg 바이너리를 사용해 .cast → GIF 변환을 비동기 백그라운드로 수행한다.
+ * convert()는 즉시 return하며, 변환은 백그라운드에서 진행된다.
+ */
+export declare class AggConverter {
+    /**
+     * .cast 파일을 GIF로 변환한다 (백그라운드 비동기).
+     * 반환값은 변환 완료를 기다리는 Promise이지만, 호출 측에서 await하지 않아도 된다.
+     */
+    convertAsync(castPath: string, outputPath: string, options?: ConvertOptions): Promise<string>;
+    /**
+     * GIF → MP4 변환 (ffmpeg 사용).
+     * agg는 gif만 지원하므로 gifPath → mp4Path 변환은 ffmpeg에 위임한다.
+     */
+    convertGifToMp4Async(gifPath: string, mp4Path: string, options?: ConvertOptions): Promise<string>;
+}
+//# sourceMappingURL=agg-converter.d.ts.map

package/dist/src/recording/agg-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agg-converter.d.ts","sourceRoot":"","sources":["../../../src/recording/agg-converter.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,4BAA4B;IAC5B,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,eAAe;IACf,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAChC;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IA2CjG;;;OAGG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;CAiCtG"}

package/dist/src/recording/agg-converter.js

@@ -0,0 +1,80 @@
+import { spawn } from 'node:child_process';
+import { unlink } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { mkdirSync } from 'node:fs';
+/**
+ * AggConverter: agg 바이너리를 사용해 .cast → GIF 변환을 비동기 백그라운드로 수행한다.
+ * convert()는 즉시 return하며, 변환은 백그라운드에서 진행된다.
+ */
+export class AggConverter {
+    /**
+     * .cast 파일을 GIF로 변환한다 (백그라운드 비동기).
+     * 반환값은 변환 완료를 기다리는 Promise이지만, 호출 측에서 await하지 않아도 된다.
+     */
+    convertAsync(castPath, outputPath, options = {}) {
+        const { deleteCastAfter = true, onComplete, onError } = options;
+        mkdirSync(dirname(outputPath), { recursive: true });
+        return new Promise((resolve, reject) => {
+            const child = spawn('agg', [castPath, outputPath], {
+                stdio: ['ignore', 'pipe', 'pipe'],
+                detached: false,
+            });
+            child.stderr?.on('data', (data) => {
+                const msg = data.toString().trim();
+                if (msg)
+                    process.stderr.write(`[agg] ${msg}\n`);
+            });
+            child.on('close', async (code) => {
+                if (code !== 0) {
+                    const err = new Error(`agg exited with code ${code}. GIF conversion failed for: ${castPath}`);
+                    onError?.(err);
+                    reject(err);
+                    return;
+                }
+                if (deleteCastAfter) {
+                    try {
+                        await unlink(castPath);
+                    }
+                    catch {
+                        // 삭제 실패는 무시
+                    }
+                }
+                onComplete?.(outputPath);
+                resolve(outputPath);
+            });
+            child.on('error', (err) => {
+                onError?.(err);
+                reject(err);
+            });
+        });
+    }
+    /**
+     * GIF → MP4 변환 (ffmpeg 사용).
+     * agg는 gif만 지원하므로 gifPath → mp4Path 변환은 ffmpeg에 위임한다.
+     */
+    convertGifToMp4Async(gifPath, mp4Path, options = {}) {
+        const { onComplete, onError } = options;
+        mkdirSync(dirname(mp4Path), { recursive: true });
+        return new Promise((resolve, reject) => {
+            const child = spawn('ffmpeg', ['-y', '-i', gifPath, '-movflags', 'faststart', '-pix_fmt', 'yuv420p', mp4Path], { stdio: ['ignore', 'pipe', 'pipe'], detached: false });
+            child.stderr?.on('data', () => {
+                // ffmpeg는 stderr에 진행상황 출력 — 무시
+            });
+            child.on('close', (code) => {
+                if (code !== 0) {
+                    const err = new Error(`ffmpeg exited with code ${code}. MP4 conversion failed.`);
+                    onError?.(err);
+                    reject(err);
+                    return;
+                }
+                onComplete?.(mp4Path);
+                resolve(mp4Path);
+            });
+            child.on('error', (err) => {
+                onError?.(err);
+                reject(err);
+            });
+        });
+    }
+}
+//# sourceMappingURL=agg-converter.js.map

package/dist/src/recording/agg-converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agg-converter.js","sourceRoot":"","sources":["../../../src/recording/agg-converter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAWpC;;;GAGG;AACH,MAAM,OAAO,YAAY;IACvB;;;OAGG;IACH,YAAY,CAAC,QAAgB,EAAE,UAAkB,EAAE,UAA0B,EAAE;QAC7E,MAAM,EAAE,eAAe,GAAG,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAEhE,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE;gBACjD,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;gBACjC,QAAQ,EAAE,KAAK;aAChB,CAAC,CAAC;YAEH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBACxC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;gBACnC,IAAI,GAAG;oBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;YAClD,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBAC/B,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,wBAAwB,IAAI,gCAAgC,QAAQ,EAAE,CAAC,CAAC;oBAC9F,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;oBACf,MAAM,CAAC,GAAG,CAAC,CAAC;oBACZ,OAAO;gBACT,CAAC;gBAED,IAAI,eAAe,EAAE,CAAC;oBACpB,IAAI,CAAC;wBACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;oBACzB,CAAC;oBAAC,MAAM,CAAC;wBACP,YAAY;oBACd,CAAC;gBACH,CAAC;gBAED,UAAU,EAAE,CAAC,UAAU,CAAC,CAAC;gBACzB,OAAO,CAAC,UAAU,CAAC,CAAC;YACtB,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACxB,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;gBACf,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,oBAAoB,CAAC,OAAe,EAAE,OAAe,EAAE,UAA0B,EAAE;QACjF,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAExC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEjD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,KAAK,GAAG,KAAK,CACjB,QAAQ,EACR,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,EAC/E,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CACvD,CAAC;YAEF,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;gBAC5B,+BAA+B;YACjC,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,2BAA2B,IAAI,0BAA0B,CAAC,CAAC;oBACjF,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;oBACf,MAAM,CAAC,GAAG,CAAC,CAAC;oBACZ,OAAO;gBACT,CAAC;gBACD,UAAU,EAAE,CAAC,OAAO,CAAC,CAAC;gBACtB,OAAO,CAAC,OAAO,CAAC,CAAC;YACnB,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACxB,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;gBACf,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/src/recording/agg-installer.d.ts

@@ -0,0 +1,6 @@
+export declare class AggInstaller {
+    isInstalled(): boolean;
+    ensureInstalled(): Promise<void>;
+    private hasCommand;
+}
+//# sourceMappingURL=agg-installer.d.ts.map

package/dist/src/recording/agg-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agg-installer.d.ts","sourceRoot":"","sources":["../../../src/recording/agg-installer.ts"],"names":[],"mappings":"AAEA,qBAAa,YAAY;IACvB,WAAW,IAAI,OAAO;IAShB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAkCtC,OAAO,CAAC,UAAU;CAQnB"}

package/dist/src/recording/agg-installer.js

@@ -0,0 +1,50 @@
+import { execSync, spawnSync } from 'node:child_process';
+export class AggInstaller {
+    isInstalled() {
+        try {
+            execSync('which agg', { stdio: 'pipe' });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async ensureInstalled() {
+        if (this.isInstalled())
+            return;
+        console.log('📦 agg is not installed. Installing...');
+        const hasCargo = this.hasCommand('cargo');
+        const hasNpm = this.hasCommand('npm');
+        if (hasCargo) {
+            console.log('  → cargo install agg');
+            const result = spawnSync('cargo', ['install', 'agg'], { stdio: 'inherit' });
+            if (result.status !== 0) {
+                throw new Error('Failed to install agg via cargo. Please install manually: https://github.com/asciinema/agg');
+            }
+        }
+        else if (hasNpm) {
+            console.log('  → npm install -g @asciinema/agg');
+            const result = spawnSync('npm', ['install', '-g', '@asciinema/agg'], { stdio: 'inherit' });
+            if (result.status !== 0) {
+                throw new Error('Failed to install agg via npm. Please install manually: https://github.com/asciinema/agg');
+            }
+        }
+        else {
+            throw new Error('Neither cargo nor npm is available. Please install agg manually: https://github.com/asciinema/agg');
+        }
+        if (!this.isInstalled()) {
+            throw new Error('agg installation failed. Please install it manually: https://github.com/asciinema/agg');
+        }
+        console.log('✅ agg installed successfully.\n');
+    }
+    hasCommand(cmd) {
+        try {
+            execSync(`which ${cmd}`, { stdio: 'pipe' });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=agg-installer.js.map

package/dist/src/recording/agg-installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agg-installer.js","sourceRoot":"","sources":["../../../src/recording/agg-installer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,OAAO,YAAY;IACvB,WAAW;QACT,IAAI,CAAC;YACH,QAAQ,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YACzC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,eAAe;QACnB,IAAI,IAAI,CAAC,WAAW,EAAE;YAAE,OAAO;QAE/B,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;QAEtD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAEtC,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;YACrC,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YAC5E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,4FAA4F,CAAC,CAAC;YAChH,CAAC;QACH,CAAC;aAAM,IAAI,MAAM,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,gBAAgB,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YAC3F,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CACb,0FAA0F,CAC3F,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CACb,mGAAmG,CACpG,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,uFAAuF,CAAC,CAAC;QAC3G,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IACjD,CAAC;IAEO,UAAU,CAAC,GAAW;QAC5B,IAAI,CAAC;YACH,QAAQ,CAAC,SAAS,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YAC5C,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

package/dist/src/recording/asciinema-installer.d.ts

@@ -0,0 +1,6 @@
+export declare class AsciinemaInstaller {
+    isInstalled(): boolean;
+    ensureInstalled(): Promise<void>;
+    private ensureBrewAvailable;
+}
+//# sourceMappingURL=asciinema-installer.d.ts.map

package/dist/src/recording/asciinema-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asciinema-installer.d.ts","sourceRoot":"","sources":["../../../src/recording/asciinema-installer.ts"],"names":[],"mappings":"AAGA,qBAAa,kBAAkB;IAC7B,WAAW,IAAI,OAAO;IAShB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAiCtC,OAAO,CAAC,mBAAmB;CAS5B"}

package/dist/src/recording/asciinema-installer.js

@@ -0,0 +1,50 @@
+import { execSync, spawnSync } from 'node:child_process';
+import { platform } from 'node:os';
+export class AsciinemaInstaller {
+    isInstalled() {
+        try {
+            execSync('which asciinema', { stdio: 'pipe' });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async ensureInstalled() {
+        if (this.isInstalled())
+            return;
+        const os = platform();
+        console.log('📦 asciinema is not installed. Installing...');
+        if (os === 'darwin') {
+            this.ensureBrewAvailable();
+            console.log('  → brew install asciinema');
+            const result = spawnSync('brew', ['install', 'asciinema'], { stdio: 'inherit' });
+            if (result.status !== 0) {
+                throw new Error('Failed to install asciinema via brew. Please install manually: brew install asciinema');
+            }
+        }
+        else if (os === 'linux') {
+            console.log('  → pip3 install asciinema');
+            const result = spawnSync('pip3', ['install', 'asciinema'], { stdio: 'inherit' });
+            if (result.status !== 0) {
+                throw new Error('Failed to install asciinema via pip3. Please install manually: pip3 install asciinema');
+            }
+        }
+        else {
+            throw new Error(`Unsupported platform for automatic asciinema installation: ${os}. Please install asciinema manually: https://docs.asciinema.org/manual/cli/installation/`);
+        }
+        if (!this.isInstalled()) {
+            throw new Error('asciinema installation failed. Please install it manually: https://docs.asciinema.org/manual/cli/installation/');
+        }
+        console.log('✅ asciinema installed successfully.\n');
+    }
+    ensureBrewAvailable() {
+        try {
+            execSync('which brew', { stdio: 'pipe' });
+        }
+        catch {
+            throw new Error('Homebrew is not installed. Please install it first: https://brew.sh, then run: brew install asciinema');
+        }
+    }
+}
+//# sourceMappingURL=asciinema-installer.js.map

package/dist/src/recording/asciinema-installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asciinema-installer.js","sourceRoot":"","sources":["../../../src/recording/asciinema-installer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,MAAM,OAAO,kBAAkB;IAC7B,WAAW;QACT,IAAI,CAAC;YACH,QAAQ,CAAC,iBAAiB,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YAC/C,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,eAAe;QACnB,IAAI,IAAI,CAAC,WAAW,EAAE;YAAE,OAAO;QAE/B,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;QAE5D,IAAI,EAAE,KAAK,QAAQ,EAAE,CAAC;YACpB,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YACjF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,uFAAuF,CAAC,CAAC;YAC3G,CAAC;QACH,CAAC;aAAM,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YACjF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,uFAAuF,CAAC,CAAC;YAC3G,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CACb,8DAA8D,EAAE,0FAA0F,CAC3J,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,gHAAgH,CACjH,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;IACvD,CAAC;IAEO,mBAAmB;QACzB,IAAI,CAAC;YACH,QAAQ,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,uGAAuG,CACxG,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,26 @@
+/**
+ * AsciinemaRecorder: self-respawn 패턴으로 asciinema 녹화를 구현한다.
+ *
+ * --record 플래그가 있고 GESTALT_RECORDING 환경변수가 없으면,
+ * 현재 프로세스를 asciinema rec으로 감싸서 재실행한다.
+ * 재실행된 프로세스는 GESTALT_RECORDING=1로 실행되므로 일반 인터뷰 로직을 수행한다.
+ */
+export declare class AsciinemaRecorder {
+    /** 이미 asciinema로 감싸진 상태인지 확인 */
+    static isInsideRecording(): boolean;
+    /** 현재 녹화 중인 cast 파일 경로 (GESTALT_CAST_PATH 환경변수) */
+    static getCurrentCastPath(): string | undefined;
+    /**
+     * 임시 cast 파일 경로를 생성한다.
+     * 실제 파일명은 인터뷰 완료 후 topic 기반으로 rename된다.
+     */
+    static createTempCastPath(recordingsDir?: string): string;
+    /**
+     * asciinema rec으로 현재 프로세스를 재실행한다.
+     * 이 함수는 return하지 않는다 (spawnSync가 블로킹).
+     *
+     * @param castPath - 녹화 결과를 저장할 .cast 파일 경로
+     */
+    static respawnWithAsciinema(castPath: string): void;
+}
+//# sourceMappingURL=asciinema-recorder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"asciinema-recorder.d.ts","sourceRoot":"","sources":["../../../src/recording/asciinema-recorder.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAC5B,gCAAgC;IAChC,MAAM,CAAC,iBAAiB,IAAI,OAAO;IAInC,mDAAmD;IACnD,MAAM,CAAC,kBAAkB,IAAI,MAAM,GAAG,SAAS;IAI/C;;;OAGG;IACH,MAAM,CAAC,kBAAkB,CAAC,aAAa,SAAwB,GAAG,MAAM;IAKxE;;;;;OAKG;IACH,MAAM,CAAC,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAmBpD"}

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

@@ -0,0 +1,52 @@
+import { spawnSync } from 'node:child_process';
+import { mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { randomUUID } from 'node:crypto';
+/**
+ * AsciinemaRecorder: self-respawn 패턴으로 asciinema 녹화를 구현한다.
+ *
+ * --record 플래그가 있고 GESTALT_RECORDING 환경변수가 없으면,
+ * 현재 프로세스를 asciinema rec으로 감싸서 재실행한다.
+ * 재실행된 프로세스는 GESTALT_RECORDING=1로 실행되므로 일반 인터뷰 로직을 수행한다.
+ */
+export class AsciinemaRecorder {
+    /** 이미 asciinema로 감싸진 상태인지 확인 */
+    static isInsideRecording() {
+        return process.env['GESTALT_RECORDING'] === '1';
+    }
+    /** 현재 녹화 중인 cast 파일 경로 (GESTALT_CAST_PATH 환경변수) */
+    static getCurrentCastPath() {
+        return process.env['GESTALT_CAST_PATH'];
+    }
+    /**
+     * 임시 cast 파일 경로를 생성한다.
+     * 실제 파일명은 인터뷰 완료 후 topic 기반으로 rename된다.
+     */
+    static createTempCastPath(recordingsDir = '.gestalt/recordings') {
+        mkdirSync(recordingsDir, { recursive: true });
+        return `${recordingsDir}/tmp-${randomUUID()}.cast`;
+    }
+    /**
+     * asciinema rec으로 현재 프로세스를 재실행한다.
+     * 이 함수는 return하지 않는다 (spawnSync가 블로킹).
+     *
+     * @param castPath - 녹화 결과를 저장할 .cast 파일 경로
+     */
+    static respawnWithAsciinema(castPath) {
+        // 현재 process.argv에서 node 실행파일을 제외한 스크립트 + 인자
+        const [, ...scriptAndArgs] = process.argv;
+        // --record, -r 플래그 제거 (재실행 시 무한루프 방지)
+        const filteredArgs = (scriptAndArgs ?? []).filter((a) => a !== '--record' && a !== '-r');
+        mkdirSync(dirname(castPath), { recursive: true });
+        const result = spawnSync('asciinema', ['rec', '--overwrite', castPath, '--', 'node', ...filteredArgs], {
+            stdio: 'inherit',
+            env: {
+                ...process.env,
+                GESTALT_RECORDING: '1',
+                GESTALT_CAST_PATH: castPath,
+            },
+        });
+        process.exit(result.status ?? 0);
+    }
+}
+//# sourceMappingURL=asciinema-recorder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"asciinema-recorder.js","sourceRoot":"","sources":["../../../src/recording/asciinema-recorder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,OAAO,iBAAiB;IAC5B,gCAAgC;IAChC,MAAM,CAAC,iBAAiB;QACtB,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,KAAK,GAAG,CAAC;IAClD,CAAC;IAED,mDAAmD;IACnD,MAAM,CAAC,kBAAkB;QACvB,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,kBAAkB,CAAC,aAAa,GAAG,qBAAqB;QAC7D,SAAS,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,OAAO,GAAG,aAAa,QAAQ,UAAU,EAAE,OAAO,CAAC;IACrD,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,oBAAoB,CAAC,QAAgB;QAC1C,6CAA6C;QAC7C,MAAM,CAAC,EAAE,GAAG,aAAa,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;QAC1C,sCAAsC;QACtC,MAAM,YAAY,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QAEzF,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAElD,MAAM,MAAM,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,EAAE;YACrG,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE;gBACH,GAAG,OAAO,CAAC,GAAG;gBACd,iBAAiB,EAAE,GAAG;gBACtB,iBAAiB,EAAE,QAAQ;aAC5B;SACF,CAAC,CAAC;QAEH,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/src/recording/cast-generator.d.ts

@@ -0,0 +1,7 @@
+import type { InterviewSession } from '../core/types.js';
+export declare function slugify(topic: string): string;
+export declare function getDateString(date?: Date): string;
+export declare class CastGenerator {
+    generate(session: InterviewSession, outputPath: string): void;
+}
+//# sourceMappingURL=cast-generator.d.ts.map

package/dist/src/recording/cast-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cast-generator.d.ts","sourceRoot":"","sources":["../../../src/recording/cast-generator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAYzD,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7C;AAED,wBAAgB,aAAa,CAAC,IAAI,OAAa,GAAG,MAAM,CAEvD;AAED,qBAAa,aAAa;IACxB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;CAyD9D"}

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

@@ -0,0 +1,72 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+// ANSI color codes
+const RESET = '\x1b[0m';
+const BOLD = '\x1b[1m';
+const CYAN = '\x1b[36m';
+const YELLOW = '\x1b[33m';
+const GREEN = '\x1b[32m';
+const DIM = '\x1b[2m';
+export function slugify(topic) {
+    return topic
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 50) || 'interview';
+}
+export function getDateString(date = new Date()) {
+    return date.toISOString().slice(0, 10).replace(/-/g, '');
+}
+export class CastGenerator {
+    generate(session, outputPath) {
+        const startTs = Math.floor(Date.parse(session.createdAt) / 1000);
+        const header = {
+            version: 2,
+            width: 100,
+            height: 40,
+            timestamp: startTs,
+            title: `Gestalt Interview: ${session.topic}`,
+        };
+        const events = [];
+        let t = 0;
+        // Banner
+        events.push([t, 'o', `\r\n${BOLD}${CYAN}╔══════════════════════════════════════════════╗${RESET}\r\n`]);
+        t += 0.05;
+        events.push([t, 'o', `${BOLD}${CYAN}║  🎯 Gestalt Interview                        ║${RESET}\r\n`]);
+        t += 0.05;
+        events.push([t, 'o', `${BOLD}${CYAN}║  ${DIM}${session.topic.slice(0, 44).padEnd(44)}${RESET}${BOLD}${CYAN}  ║${RESET}\r\n`]);
+        t += 0.05;
+        events.push([t, 'o', `${BOLD}${CYAN}╚══════════════════════════════════════════════╝${RESET}\r\n\r\n`]);
+        t += 0.5;
+        // Q&A rounds
+        for (const round of session.rounds) {
+            if (!round.userResponse)
+                continue;
+            // Question
+            events.push([t, 'o', `${BOLD}${YELLOW}Q${round.roundNumber} [${round.gestaltFocus}]${RESET}\r\n`]);
+            t += 0.1;
+            events.push([t, 'o', `${round.question}\r\n\r\n`]);
+            t += 1.2;
+            // Answer
+            events.push([t, 'o', `${BOLD}${GREEN}❯${RESET} `]);
+            t += 0.1;
+            events.push([t, 'o', `${round.userResponse}\r\n\r\n`]);
+            t += 0.8;
+        }
+        // Footer
+        events.push([t, 'o', `${BOLD}${CYAN}✅ Interview completed — ${session.rounds.length} rounds${RESET}\r\n`]);
+        t += 0.3;
+        if (session.ambiguityScore) {
+            events.push([t, 'o', `${DIM}Ambiguity score: ${session.ambiguityScore.overall.toFixed(2)}${RESET}\r\n`]);
+        }
+        events.push([t + 0.2, 'o', '\r\n']);
+        // Write file
+        mkdirSync(dirname(outputPath), { recursive: true });
+        const lines = [
+            JSON.stringify(header),
+            ...events.map((e) => JSON.stringify(e)),
+        ];
+        writeFileSync(outputPath, lines.join('\n') + '\n', 'utf8');
+    }
+}
+//# sourceMappingURL=cast-generator.js.map

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

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

package/dist/src/recording/filename-generator.d.ts

@@ -0,0 +1,19 @@
+import type { LLMAdapter } from '../llm/types.js';
+export interface FilenameGeneratorOptions {
+    outputDir?: string;
+}
+export declare class FilenameGenerator {
+    private readonly llm;
+    private readonly options;
+    constructor(llm: LLMAdapter, options?: FilenameGeneratorOptions);
+    /**
+     * 인터뷰 topic 기반으로 kebab-case 이름을 LLM에게 요청하고
+     * YYYYMMDD 날짜 접미사를 붙여 GIF 파일명을 생성한다.
+     */
+    generate(topic: string, sessionId: string): Promise<string>;
+    generateCast(topic: string, sessionId: string, outputDir?: string): Promise<string>;
+    private requestSlugFromLLM;
+    private fallbackSlug;
+    private getDateString;
+}
+//# sourceMappingURL=filename-generator.d.ts.map

package/dist/src/recording/filename-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filename-generator.d.ts","sourceRoot":"","sources":["../../../src/recording/filename-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,GAAG,EAAE,UAAU,EACf,OAAO,GAAE,wBAA6B;IAGzD;;;OAGG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ3D,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAQ3E,kBAAkB;IA2BhC,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,aAAa;CAOtB"}

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

@@ -0,0 +1,67 @@
+export class FilenameGenerator {
+    llm;
+    options;
+    constructor(llm, options = {}) {
+        this.llm = llm;
+        this.options = options;
+    }
+    /**
+     * 인터뷰 topic 기반으로 kebab-case 이름을 LLM에게 요청하고
+     * YYYYMMDD 날짜 접미사를 붙여 GIF 파일명을 생성한다.
+     */
+    async generate(topic, sessionId) {
+        const slug = await this.requestSlugFromLLM(topic, sessionId);
+        const date = this.getDateString();
+        const filename = `${slug}-${date}.gif`;
+        const dir = this.options.outputDir ?? '.';
+        return dir === '.' ? filename : `${dir}/${filename}`;
+    }
+    async generateCast(topic, sessionId, outputDir) {
+        const slug = await this.requestSlugFromLLM(topic, sessionId);
+        const date = this.getDateString();
+        const filename = `${slug}-${date}.cast`;
+        const dir = outputDir ?? this.options.outputDir ?? '.gestalt/recordings';
+        return `${dir}/${filename}`;
+    }
+    async requestSlugFromLLM(topic, sessionId) {
+        try {
+            const response = await this.llm.chat({
+                system: 'You are a file naming assistant. Respond with ONLY a kebab-case slug (2-5 words, lowercase, hyphens only, no spaces, no special chars, no extension).',
+                messages: [
+                    {
+                        role: 'user',
+                        content: `Generate a descriptive kebab-case filename for a terminal recording of an interview about: "${topic}"\n\nSession: ${sessionId}\n\nRespond with ONLY the kebab-case slug, nothing else.`,
+                    },
+                ],
+                maxTokens: 50,
+                temperature: 0.3,
+            });
+            const slug = response.content
+                .trim()
+                .toLowerCase()
+                .replace(/[^a-z0-9-]/g, '-')
+                .replace(/-+/g, '-')
+                .replace(/^-|-$/g, '');
+            return slug || this.fallbackSlug(topic);
+        }
+        catch {
+            return this.fallbackSlug(topic);
+        }
+    }
+    fallbackSlug(topic) {
+        return topic
+            .toLowerCase()
+            .replace(/[^a-z0-9\s]/g, '')
+            .trim()
+            .replace(/\s+/g, '-')
+            .slice(0, 40) || 'interview';
+    }
+    getDateString() {
+        const now = new Date();
+        const year = now.getFullYear();
+        const month = String(now.getMonth() + 1).padStart(2, '0');
+        const day = String(now.getDate()).padStart(2, '0');
+        return `${year}${month}${day}`;
+    }
+}
+//# sourceMappingURL=filename-generator.js.map

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

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

package/dist/src/recording/gif-generator.d.ts

@@ -0,0 +1,21 @@
+import type { TerminalFrame, GifOutput } from '../core/types.js';
+export interface GifGeneratorOptions {
+    repeat?: number;
+    quality?: number;
+    frameDelay?: number;
+}
+export declare class GifGenerator {
+    private readonly repeat;
+    private readonly quality;
+    private readonly frameDelay;
+    constructor(options?: GifGeneratorOptions);
+    /** .frames NDJSON 파일을 읽어 GIF 파일로 변환 */
+    generate(framesPath: string, outputPath: string): Promise<GifOutput>;
+    /** TerminalFrame 배열을 직접 받아 GIF 생성 (SegmentMerger에서 병합된 결과 사용) */
+    generateFromFrames(frames: TerminalFrame[], outputPath: string): Promise<GifOutput>;
+    readFrames(framesPath: string): Promise<TerminalFrame[]>;
+    private encodeGif;
+    private renderFrame;
+    private loadTerminalFont;
+}
+//# sourceMappingURL=gif-generator.d.ts.map

package/dist/src/recording/gif-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gif-generator.d.ts","sourceRoot":"","sources":["../../../src/recording/gif-generator.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAWjE,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,OAAO,GAAE,mBAAwB;IAM7C,uCAAuC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAa1E,iEAAiE;IAC3D,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAOnF,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;YAqBhD,SAAS;YA6CT,WAAW;YAuBX,gBAAgB;CAS/B"}