@tienne/gestalt 0.102.0 → 0.104.0

package/dist/plugin/skills/video-digest/templates/resources.md

@@ -0,0 +1,14 @@
+---
+id: resources
+title: 언급된 리소스
+description: 영상에 나온 책, 도구, 서비스, 사람, 자료를 모은다
+blocks: [heading, list]
+order: 80
+---
+
+강의나 리뷰 영상에서 언급된 리소스를 모은다.
+
+- 종류별로 heading 블록을 둔다. 책, 도구와 서비스, 사람, 논문과 자료 가운데 실제로 나온 것만 쓴다
+- 각 heading 아래 list 블록 하나에 항목을 둔다. 항목 text는 이름과 영상이 그걸 어떻게 소개했는지 한 문장이다
+- 항목마다 처음 언급된 문장을 cite로 단다
+- 링크나 URL은 쓰지 않는다. 영상에서 이름을 정확히 못 알아들었으면 들린 대로 적고 그렇다고 밝힌다

package/dist/plugin/skills/video-digest/templates/timestamps.md

@@ -0,0 +1,14 @@
+---
+id: timestamps
+title: 타임스탬프
+description: 주제가 바뀌는 자리마다 시각과 제목을 단 목차를 만든다
+blocks: [timestamps]
+order: 20
+---
+
+영상 전체를 훑는 목차를 만든다.
+
+- timestamps 블록 하나만 쓴다. 주제가 바뀌는 자리마다 항목 하나를 둔다
+- 10분 영상이면 6~10개, 1시간이면 15~30개 정도로 둔다. 너무 잘게 쪼개지 않는다
+- cite.key는 그 주제가 시작되는 문장이고 from~to는 그 주제가 이어지는 구간이다. 항목끼리 구간이 겹치지 않게 시간 순으로 둔다
+- title은 20자 안쪽 명사구로 쓴다. summary는 한 문장으로 그 구간에서 무슨 말을 하는지 적는다

package/dist/plugin/skills/video-digest/templates/visual.md

@@ -0,0 +1,22 @@
+---
+id: visual
+title: 그림 해설
+description: 핵심 개념마다 그림 하나와 짧은 설명을 짝지은 리포트
+blocks: [text, figure]
+order: 16
+---
+
+영상의 핵심 개념을 4~8개 골라 개념마다 그림 하나와 짧은 설명을 짝지어 보여준다. 요약 탭은 영상 순서를 따라가지만 이 탭은 개념 순서를 따라간다. 앞 개념을 알아야 뒤 개념이 읽히면 그 순서로 놓는다. 그림은 렌더러가 그리므로 도식 구조만 채운다. SVG나 HTML은 쓰지 않는다.
+
+- 첫 text 블록에 어떤 개념을 골랐고 어떤 순서로 놓았는지 한두 문장으로 적는다
+- 개념마다 figure 블록을 하나 둔다. title은 개념 이름을 명사구로 적는다
+- diagram은 대섹션 도식과 같은 구조다. 개념의 모양에 맞는 종류를 고른다
+  - 차례로 이어지는 단계는 flow, 처음으로 돌아오는 고리는 cycle
+  - 둘 이상을 나란히 견주면 compare, 한 주제에서 가지가 뻗으면 tree
+  - 시점이 붙은 사건 흐름은 timeline, 두 기준으로 나눈 네 칸은 matrix
+  - 원인과 결과가 한 현상에 모이면 causal, 바뀌기 전과 후를 보여주면 beforeAfter
+- 같은 종류만 이어 쓰지 않는다. 개념마다 맞는 모양이 다르다
+- explanation은 2~4문장으로 그림이 말하지 않는 것을 적는다. 왜 그런지, 언제 쓰는지, 영상에서 어떤 예를 들었는지다. 그림 라벨을 그대로 다시 읊지 않는다
+- cite는 그 개념을 가장 잘 설명한 구간을 단다. 대섹션 범위에 묶이지 않고 스크립트 안이면 된다
+- 그림 라벨은 한 줄에 들어가는 짧은 명사구로 쓴다. 굵게(\*\*)를 쓰지 않는다
+- 영상에서 그 내용이 나온 자리가 분명한 노드에는 cite를 단다. 누르면 영상이 그 자리로 간다

package/dist/src/cli/commands/digest.d.ts

@@ -0,0 +1,60 @@
+import { type OcrResult } from '../../digest/ocr.js';
+import { type RenderFilesResult } from '../../digest/render.js';
+/**
+ * `gestalt digest` — 영상 요약 CLI.
+ *
+ * yt-dlp와 ffmpeg, whisper를 부르는 셸 작업이라 MCP action이 아니라 여기 둔다.
+ * research가 slide-extract.mjs를 MCP로 올리지 않은 것과 같은 이유다.
+ */
+export interface DigestCommonOptions {
+    repoRoot?: string;
+    json?: boolean;
+}
+export declare function digestIngestCommand(input: string, opts: DigestCommonOptions & {
+    lang?: string;
+    slug?: string;
+    whisper?: boolean;
+    whisperModel?: string;
+    ocr?: boolean;
+    ocrInterval?: string;
+}): Promise<void>;
+export declare function digestCommentsCommand(slug: string, opts: DigestCommonOptions & {
+    max?: string;
+}): Promise<void>;
+export declare function digestFramesCommand(slug: string, opts: DigestCommonOptions & {
+    force?: boolean;
+}): Promise<void>;
+export declare function digestScenesCommand(slug: string, opts: DigestCommonOptions): Promise<void>;
+export declare function printOcr(r: OcrResult): void;
+export declare function digestOcrCommand(slug: string, opts: DigestCommonOptions & {
+    interval?: string;
+    lang?: string;
+}): Promise<void>;
+export declare function digestValidateCommand(slug: string, opts: DigestCommonOptions): void;
+export declare function renderDigestFiles(slug: string, opts: DigestCommonOptions & {
+    inlineFrames?: boolean;
+}): RenderFilesResult;
+export declare function digestRenderCommand(slug: string, opts: DigestCommonOptions & {
+    inlineFrames?: boolean;
+}): void;
+export declare function digestExportCommand(slug: string, opts: DigestCommonOptions & {
+    md?: boolean;
+    out?: string;
+    report?: string;
+}): void;
+export declare function digestMergeCommand(slug: string, reportFile: string, opts: DigestCommonOptions & {
+    extension?: boolean;
+}): void;
+export declare function digestTemplatesCommand(opts: DigestCommonOptions): void;
+/** 요약 에이전트에게 넘길 템플릿 지시를 출력한다. --json이면 frontmatter까지 함께 준다 */
+export declare function digestTemplateCommand(id: string, opts: DigestCommonOptions): void;
+export declare function digestSliceCommand(slug: string, opts: DigestCommonOptions & {
+    range: string;
+}): void;
+export declare function digestTranslateApplyCommand(slug: string, file: string, opts: DigestCommonOptions): void;
+export declare function parsePort(value: string): number;
+export declare function digestServeCommand(slug: string, opts: DigestCommonOptions & {
+    port?: string;
+    browser?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=digest.d.ts.map

package/dist/src/cli/commands/digest.d.ts.map

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

package/dist/src/cli/commands/digest.js

@@ -0,0 +1,401 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { loadConfig } from '../../core/config.js';
+import { COMMENTS_DEFAULT_MAX, commentsMap, fetchComments } from '../../digest/comments.js';
+import { extractFrames } from '../../digest/frames.js';
+import { ingest } from '../../digest/ingest.js';
+import { lintDigest, lintErrors } from '../../digest/lint.js';
+import { pickScenes, sceneSecs } from '../../digest/scenes.js';
+import { mergeExtension, mergeReport } from '../../digest/merge.js';
+import { runOcr } from '../../digest/ocr.js';
+import { exportMarkdown, renderToFiles } from '../../digest/render.js';
+import { parseDigest } from '../../digest/schema.js';
+import { parseRangeArg, sliceFileName, sliceTranscript } from '../../digest/slice.js';
+import { DigestServer, findDigestPort, openInBrowser } from '../../digest/server.js';
+import { DigestStore } from '../../digest/store.js';
+import { loadDigestTemplates, templateMap } from '../../digest/templates.js';
+import { applyTranslation } from '../../digest/translate.js';
+const rootOf = (opts) => resolve(opts.repoRoot ?? process.cwd());
+function emit(value, json, human) {
+    if (json)
+        console.log(JSON.stringify(value, null, 2));
+    else
+        human();
+}
+function fail(e) {
+    console.error(e instanceof Error ? e.message : String(e));
+    process.exit(1);
+}
+// 깨진 템플릿 하나가 명령 전체를 막지 않게 경고만 stderr로 알린다. --json이면 결과에 싣는다
+function templatesOf(opts) {
+    const load = loadDigestTemplates(rootOf(opts), loadConfig({}, { skipDotEnv: true }).skillsDir);
+    if (!opts.json)
+        for (const w of load.warnings)
+            console.error(`템플릿 경고: ${w}`);
+    return load;
+}
+const mmss = (sec) => `${Math.floor(sec / 60)}:${String(Math.floor(sec % 60)).padStart(2, '0')}`;
+export async function digestIngestCommand(input, opts) {
+    try {
+        // 간격이 틀렸으면 수집을 다 마친 뒤가 아니라 시작하기 전에 알린다
+        const intervalSec = opts.ocr ? parseInterval(opts.ocrInterval) : undefined;
+        const r = await ingest(input, {
+            repoRoot: rootOf(opts),
+            lang: opts.lang,
+            slug: opts.slug,
+            whisper: opts.whisper,
+            whisperModel: opts.whisperModel,
+        });
+        // OCR이 실패해도 수집 결과는 남아 있어서 slug와 경로를 출력하고 종료 코드로만 알린다
+        let ocr;
+        if (opts.ocr) {
+            try {
+                ocr = await runOcr(r.slug, { repoRoot: rootOf(opts), intervalSec });
+            }
+            catch (e) {
+                ocr = { error: e.message };
+                process.exitCode = 1;
+            }
+        }
+        emit(ocr ? { ...r, ocr } : r, opts.json, () => {
+            console.log(`${r.title} (${mmss(r.durationSec)})`);
+            console.log(`자막: ${r.captionSource} [${r.captionTrack}] → 문장 ${r.segmentCount}개`);
+            console.log(`slug: ${r.slug}`);
+            console.log(`저장: ${r.transcriptPath}`);
+            if (r.staleDigest) {
+                const before = r.staleDigest.previousSegmentCount ?? '?';
+                console.log(`문장 번호가 바뀌어 기존 요약을 옮겼어요(문장 ${before}개 → ${r.segmentCount}개): ${r.staleDigest.movedTo}`);
+            }
+            if (ocr && 'error' in ocr)
+                console.log(`화면 글자를 못 읽었어요: ${ocr.error}`);
+            else if (ocr)
+                printOcr(ocr);
+        });
+    }
+    catch (e) {
+        fail(e);
+    }
+}
+export async function digestCommentsCommand(slug, opts) {
+    try {
+        const max = opts.max === undefined ? COMMENTS_DEFAULT_MAX : Number(opts.max);
+        const r = await fetchComments(slug, { repoRoot: rootOf(opts), max });
+        emit(r, opts.json, () => {
+            const total = r.commentCount === null ? '' : ` (영상 전체 ${r.commentCount}개)`;
+            console.log(`댓글 ${r.fetched}개를 받았어요${total}. 작성자 정보는 저장하지 않았어요.`);
+            console.log(`저장: ${r.path}`);
+        });
+    }
+    catch (e) {
+        fail(e);
+    }
+}
+export async function digestFramesCommand(slug, opts) {
+    try {
+        const r = await extractFrames(slug, { repoRoot: rootOf(opts), force: opts.force });
+        emit(r, opts.json, () => {
+            console.log(`프레임 ${r.total}장 중 ${r.extracted}장 새로 뽑음, ${r.skipped}장은 있던 것`);
+            if (r.missing.length > 0)
+                console.log(`못 뽑은 시각: ${r.missing.map(mmss).join(', ')}`);
+            const { shots } = r;
+            if (shots.total > 0) {
+                console.log(`장면 ${shots.total}장 중 ${shots.extracted}장 새로 뽑음(720p ${shots.hires}장), ${shots.skipped}장은 있던 것`);
+                if (shots.missing.length > 0) {
+                    console.log(`못 뽑은 장면: ${shots.missing.map(mmss).join(', ')}`);
+                }
+                if (shots.extracted > shots.hires) {
+                    // 사유 없이 저화질로 뽑았으면 720p 영상은 멀쩡한데 그 시각에서 파일이 안 생긴 것이다
+                    const why = shots.hiresFailure ?? '720p 영상에서 그 시각을 못 뽑았어요';
+                    console.log(`${why}. ${shots.extracted - shots.hires}장은 낮은 화질로 뽑았어요. 720p로 다시 뽑으려면 --force를 붙여 돌려 주세요.`);
+                }
+            }
+            console.log(`저장: ${r.framesDir}`);
+        });
+    }
+    catch (e) {
+        fail(e);
+    }
+}
+export async function digestScenesCommand(slug, opts) {
+    try {
+        const r = await pickScenes(slug, { repoRoot: rootOf(opts) });
+        emit(r, opts.json, () => {
+            const how = r.source === 'ocr' ? '화면 글자(ocr.json)' : 'ffmpeg 장면 전환';
+            console.log(`후보 장면 ${r.items}개 (${how})`);
+            if (r.truncated) {
+                console.log(`후보가 ${r.total}개라 영상 전체에서 고르게 ${r.items}개만 남겼어요.`);
+            }
+            console.log(`저장: ${r.path}`);
+        });
+    }
+    catch (e) {
+        fail(e);
+    }
+}
+function parseInterval(value) {
+    if (value === undefined)
+        return undefined;
+    if (!/^\d+$/.test(value.trim()))
+        throw new Error(`OCR 간격은 초 단위 정수여야 해요: ${value}`);
+    return Number(value);
+}
+export function printOcr(r) {
+    if (r.requestedIntervalSec !== undefined) {
+        console.log(`프레임이 너무 많아 간격을 ${r.requestedIntervalSec}초에서 ${r.intervalSec}초로 넓혔어요`);
+    }
+    console.log(`화면 글자: 프레임 ${r.frames}장(${r.intervalSec}초 간격, ${r.lang}) → ${r.items}개`);
+    if (r.truncated > 0)
+        console.log(`글자가 길어 줄 단위로 자른 항목: ${r.truncated}개`);
+    if (r.loggedTimes !== undefined) {
+        console.log(`프레임 ${r.frames}장 중 시각 로그가 ${r.loggedTimes}개뿐이라 나머지는 간격으로 시각을 어림했어요`);
+    }
+    console.log(`저장: ${r.path}`);
+}
+export async function digestOcrCommand(slug, opts) {
+    try {
+        const r = await runOcr(slug, {
+            repoRoot: rootOf(opts),
+            intervalSec: parseInterval(opts.interval),
+            lang: opts.lang,
+        });
+        emit(r, opts.json, () => printOcr(r));
+    }
+    catch (e) {
+        fail(e);
+    }
+}
+export function digestValidateCommand(slug, opts) {
+    try {
+        const store = new DigestStore(rootOf(opts));
+        const t = store.readTranscript(slug);
+        if (!t.ok)
+            throw new Error(t.message);
+        const transcript = t.transcript;
+        const raw = store.readDigestFile(slug);
+        if (raw.kind !== 'ok') {
+            throw new Error(raw.kind === 'missing' ? `digest.json이 없어요: ${slug}` : raw.message);
+        }
+        const parsed = parseDigest(raw.value);
+        if (!parsed.ok)
+            throw parsed.error;
+        const { templates } = templatesOf(opts);
+        const issues = lintDigest(parsed.value, transcript, {
+            templates: templateMap(templates),
+            comments: commentsMap(store, slug) ?? undefined,
+            scenes: sceneSecs(store, slug),
+        });
+        const errors = lintErrors(issues);
+        emit({ slug, ok: errors.length === 0, issues }, opts.json, () => {
+            for (const i of issues)
+                console.log(`${i.severity} ${i.code} ${i.path}: ${i.message}`);
+            console.log(errors.length === 0 ? `통과 (경고 ${issues.length}개)` : `오류 ${errors.length}개`);
+        });
+        if (errors.length > 0)
+            process.exitCode = 1;
+    }
+    catch (e) {
+        fail(e);
+    }
+}
+// serve도 render와 같은 템플릿 목록으로 그려야 '+ 더 만들기' 메뉴가 사라지지 않는다
+export function renderDigestFiles(slug, opts) {
+    return renderToFiles(slug, {
+        repoRoot: rootOf(opts),
+        inlineFrames: opts.inlineFrames,
+        templates: templatesOf(opts).templates,
+    });
+}
+export function digestRenderCommand(slug, opts) {
+    try {
+        const r = renderDigestFiles(slug, opts);
+        emit(r, opts.json, () => {
+            console.log(`HTML: ${r.htmlPath}`);
+            console.log(`마크다운: ${r.mdPath}`);
+            for (const w of r.warnings)
+                console.log(`경고: ${w}`);
+        });
+    }
+    catch (e) {
+        fail(e);
+    }
+}
+export function digestExportCommand(slug, opts) {
+    try {
+        if (!opts.md)
+            throw new Error('지금은 --md 내보내기만 있어요.');
+        const r = exportMarkdown(slug, { repoRoot: rootOf(opts), out: opts.out, report: opts.report });
+        emit(r, opts.json, () => console.log(`마크다운: ${r.mdPath}`));
+    }
+    catch (e) {
+        fail(e);
+    }
+}
+export function digestMergeCommand(slug, reportFile, opts) {
+    try {
+        let input;
+        try {
+            input = JSON.parse(readFileSync(resolve(reportFile), 'utf-8'));
+        }
+        catch (e) {
+            throw new Error(`리포트 파일을 못 읽었어요: ${reportFile}`, { cause: e });
+        }
+        const r = opts.extension
+            ? mergeExtension(rootOf(opts), slug, input, {
+                templates: templateMap(templatesOf(opts).templates),
+            })
+            : mergeReport(rootOf(opts), slug, input);
+        emit(r, opts.json, () => {
+            for (const i of r.issues)
+                console.log(`${i.severity} ${i.code} ${i.path}: ${i.message}`);
+            if (r.saved) {
+                console.log(`${r.replaced ? '바꿔 끼움' : '추가'}: ${r.key} → ${r.digestPath}`);
+            }
+            else {
+                console.log(`lint 오류가 있어 저장하지 않았어요: ${r.key}`);
+            }
+        });
+        if (!r.saved)
+            process.exitCode = 1;
+    }
+    catch (e) {
+        fail(e);
+    }
+}
+export function digestTemplatesCommand(opts) {
+    try {
+        const load = templatesOf(opts);
+        const list = load.templates.map(({ prompt: _prompt, ...t }) => t);
+        emit({ templates: list, warnings: load.warnings }, opts.json, () => {
+            for (const t of list) {
+                const tag = t.overridesBuiltin
+                    ? ' (사용자, 기본 템플릿을 대신함)'
+                    : t.source === 'user'
+                        ? ' (사용자)'
+                        : '';
+                console.log(`${t.id}${tag}  ${t.title} — ${t.description}`);
+                console.log(`  블록: ${t.blocks.join(', ')}${t.needs.length ? ` / 먼저 받을 자료: ${t.needs.join(', ')}` : ''}`);
+            }
+            if (list.length === 0)
+                console.log('템플릿이 없어요.');
+        });
+    }
+    catch (e) {
+        fail(e);
+    }
+}
+/** 요약 에이전트에게 넘길 템플릿 지시를 출력한다. --json이면 frontmatter까지 함께 준다 */
+export function digestTemplateCommand(id, opts) {
+    try {
+        const t = templatesOf(opts).templates.find((x) => x.id === id);
+        if (!t)
+            throw new Error(`템플릿 ${id}가 없어요. gestalt digest templates로 목록을 보세요.`);
+        emit(t, opts.json, () => console.log(t.prompt));
+    }
+    catch (e) {
+        fail(e);
+    }
+}
+export function digestSliceCommand(slug, opts) {
+    try {
+        const store = new DigestStore(rootOf(opts));
+        const t = store.readTranscript(slug);
+        if (!t.ok)
+            throw new Error(t.message);
+        const range = parseRangeArg(opts.range);
+        const slice = sliceTranscript(t.transcript, range);
+        const path = join(store.dir(slug), sliceFileName(range));
+        writeFileSync(path, JSON.stringify(slice, null, 2) + '\n');
+        const result = {
+            path,
+            range: slice.range,
+            from: slice.from,
+            to: slice.to,
+            count: slice.segments.length,
+        };
+        emit(result, opts.json, () => {
+            console.log(`구간: ${mmss(range[0])}~${mmss(range[1])} → 문장 ${slice.from}~${slice.to} (${result.count}개)`);
+            console.log(`저장: ${path}`);
+        });
+    }
+    catch (e) {
+        fail(e);
+    }
+}
+export function digestTranslateApplyCommand(slug, file, opts) {
+    try {
+        let input;
+        try {
+            input = JSON.parse(readFileSync(resolve(file), 'utf-8'));
+        }
+        catch (e) {
+            throw new Error(`번역 파일을 못 읽었어요: ${file}`, { cause: e });
+        }
+        const store = new DigestStore(rootOf(opts));
+        const t = store.readTranscript(slug);
+        if (!t.ok)
+            throw new Error(t.message);
+        const r = applyTranslation(t.transcript, input);
+        const path = store.saveTranscript(r.transcript);
+        const result = {
+            path,
+            lang: r.transcript.meta.translationLang,
+            applied: r.applied,
+            unknown: r.unknown,
+            missing: r.missing,
+        };
+        emit(result, opts.json, () => {
+            console.log(`번역(${result.lang}) ${r.applied}문장 반영 → ${path}`);
+            if (r.unknown.length > 0)
+                console.log(`스크립트에 없는 문장 번호: ${r.unknown.join(', ')}`);
+            if (r.missing.length > 0)
+                console.log(`번역이 빠진 문장: ${r.missing.length}개`);
+        });
+    }
+    catch (e) {
+        fail(e);
+    }
+}
+export function parsePort(value) {
+    const n = Number(value);
+    if (!/^\d+$/.test(value.trim()) || n < 1 || n > 65535) {
+        throw new Error(`포트는 1~65535 정수여야 해요: ${value}`);
+    }
+    return n;
+}
+export async function digestServeCommand(slug, opts) {
+    try {
+        const repoRoot = rootOf(opts);
+        const r = renderDigestFiles(slug, opts);
+        const server = new DigestServer(new DigestStore(repoRoot).root);
+        const port = opts.port ? parsePort(opts.port) : await findDigestPort();
+        try {
+            await server.start(port);
+        }
+        catch (e) {
+            if (e.code === 'EADDRINUSE') {
+                throw new Error(`${port}번은 이미 쓰는 포트예요. --port를 비우면 빈 곳을 찾아요.`, {
+                    cause: e,
+                });
+            }
+            throw e;
+        }
+        const url = `http://127.0.0.1:${server.port}/${slug}/`;
+        emit({ ...r, url }, opts.json, () => {
+            for (const w of r.warnings)
+                console.log(`경고: ${w}`);
+            console.log(`뷰어: ${url}`);
+            console.log('끝내려면 Ctrl+C');
+        });
+        if (opts.browser !== false)
+            await openInBrowser(url);
+        const stop = () => {
+            void server.stop().finally(() => process.exit(0));
+        };
+        process.once('SIGINT', stop);
+        process.once('SIGTERM', stop);
+    }
+    catch (e) {
+        fail(e);
+    }
+}
+//# sourceMappingURL=digest.js.map

package/dist/src/cli/commands/digest.js.map

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

package/dist/src/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsDpC,wBAAgB,SAAS,IAAI,OAAO,CAsdnC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsEpC,wBAAgB,SAAS,IAAI,OAAO,CAokBnC"}

package/dist/src/cli/index.js

@@ -17,6 +17,7 @@ import { reviewLoopDirCommand, reviewLoopParseCommand, reviewLoopResolveCommand,
 import { approveGateCommand, reviewRoundsCommand } from './commands/approve-gate.js';
 import { harnessRefsClonesPruneCommand, harnessRefsCollectCommand, } from './commands/harness-refs.js';
 import { harnessRefsFollowupBuildCommand, harnessRefsFollowupCheckCommand, harnessRefsFollowupFindCommand, harnessRefsRelatedPrsCommand, harnessRefsThreeStateCommand, } from './commands/harness-refs-cross-pr.js';
+import { digestCommentsCommand, digestExportCommand, digestFramesCommand, digestOcrCommand, digestScenesCommand, digestIngestCommand, digestMergeCommand, digestTemplateCommand, digestTemplatesCommand, digestSliceCommand, digestTranslateApplyCommand, digestRenderCommand, digestServeCommand, digestValidateCommand, } from './commands/digest.js';
 import { getVersion } from '../core/version.js';
 import { prCheckoutCommand, prCloseCommand, prCommentCommand, prCommentsCommand, prCreateCommand, prDiffCommand, prEditCommand, prListCommand, prMergeCommand, prReposCommand, prResolveCommand, prReviewCommand, prPruneCommand, prServeCommand, prShowCommand, prUnregisterCommand, prUpdateCommand, } from './commands/pr.js';
 export function createCli() {
@@ -173,6 +174,86 @@ export function createCli() {
     pr.command('unregister <key>')
         .description('그 레포를 웹 UI 목록에서 뺀다. 레포 자체는 안 건드린다')
         .action((key, o, cmd) => prUnregisterCommand({ ...inherited(cmd), ...o, key }));
+    const digest = program
+        .command('digest')
+        .description('영상 요약 — 스크립트 수집, 프레임, 뷰어')
+        .option('--repo-root <path>', 'Repository root (defaults to cwd)')
+        .option('--json', '에이전트가 파싱할 JSON으로');
+    const digestInherited = (cmd) => (cmd.parent?.opts() ?? {});
+    digest
+        .command('ingest <input>')
+        .description('유튜브 주소나 영상 파일에서 문장 단위 스크립트(transcript.json)를 만든다')
+        .option('--lang <code>', '자막 언어 (기본: 영상 원어)')
+        .option('--slug <slug>', '저장 폴더 이름 (기본: 제목과 영상 id)')
+        .option('--whisper', '자막이 있어도 faster-whisper로 받아쓴다')
+        .option('--whisper-model <name>', 'faster-whisper 모델 (기본 large-v3)')
+        .option('--ocr', '스크립트를 만든 뒤 화면 글자도 읽어 ocr.json에 둔다 (tesseract 필요)')
+        .option('--ocr-interval <sec>', '화면 글자를 읽는 간격 (기본 10초)')
+        .action((input, o, cmd) => digestIngestCommand(input, { ...digestInherited(cmd), ...o }));
+    digest
+        .command('ocr <slug>')
+        .description('일정 간격으로 프레임을 뽑아 화면 글자를 읽고 ocr.json에 둔다 (tesseract 필요)')
+        .option('--interval <sec>', '읽는 간격 (기본 10초)')
+        .option('--lang <tess>', 'tesseract 언어, kor+eng 꼴 (기본: 스크립트 언어에서 고름)')
+        .action((slug, o, cmd) => digestOcrCommand(slug, { ...digestInherited(cmd), ...o }));
+    digest
+        .command('scenes <slug>')
+        .description('shots가 고를 후보 장면을 scenes.json에 둔다. ocr.json이 있으면 화면 글자로, 없으면 장면 전환으로 고른다')
+        .action((slug, o, cmd) => digestScenesCommand(slug, { ...digestInherited(cmd), ...o }));
+    digest
+        .command('comments <slug>')
+        .description('유튜브 댓글을 인기순으로 받아 comments.json에 둔다 (작성자 정보는 저장 안 함)')
+        .option('--max <n>', '받을 댓글 수, 1~1000 (기본 200)')
+        .action((slug, o, cmd) => digestCommentsCommand(slug, { ...digestInherited(cmd), ...o }));
+    digest
+        .command('frames <slug>')
+        .description('digest.json의 소섹션 frameSec마다 프레임을 뽑고 shots 장면은 720p로 뽑는다')
+        .option('--force', '이미 뽑은 프레임도 다시 뽑는다')
+        .action((slug, o, cmd) => digestFramesCommand(slug, { ...digestInherited(cmd), ...o }));
+    digest
+        .command('validate <slug>')
+        .description('digest.json을 스키마와 lint로 검사한다')
+        .action((slug, o, cmd) => digestValidateCommand(slug, { ...digestInherited(cmd), ...o }));
+    digest
+        .command('render <slug>')
+        .description('digest.json으로 뷰어 HTML과 마크다운을 만든다')
+        .option('--inline-frames', '프레임을 HTML 안에 넣는다 (파일 하나로 들고 다닐 때)')
+        .action((slug, o, cmd) => digestRenderCommand(slug, { ...digestInherited(cmd), ...o }));
+    digest
+        .command('export <slug>')
+        .description('요약을 다른 형식으로 내보낸다')
+        .option('--md', '마크다운으로')
+        .option('--out <path>', '저장 경로 (기본: 첫 리포트는 digest.md, 나머지는 digest.<키>.md)')
+        .option('--report <key>', '내보낼 리포트 키 (기본: 첫 리포트)')
+        .action((slug, o, cmd) => digestExportCommand(slug, { ...digestInherited(cmd), ...o }));
+    digest
+        .command('merge <slug> <reportFile>')
+        .description('리포트 한 벌을 digest.json에 합친다. 같은 키면 바꿔 끼운다')
+        .option('--extension', '템플릿으로 만든 확장 리포트를 합친다. 템플릿과 언어가 같으면 바꿔 끼운다')
+        .action((slug, reportFile, o, cmd) => digestMergeCommand(slug, reportFile, { ...digestInherited(cmd), ...o }));
+    digest
+        .command('templates')
+        .description('확장 리포트 템플릿 목록 (기본 템플릿과 .gestalt/digest/templates/)')
+        .action((o, cmd) => digestTemplatesCommand({ ...digestInherited(cmd), ...o }));
+    digest
+        .command('template <id>')
+        .description('템플릿의 요약 지시를 출력한다. 요약 에이전트에게 그대로 넘긴다')
+        .action((id, o, cmd) => digestTemplateCommand(id, { ...digestInherited(cmd), ...o }));
+    digest
+        .command('slice <slug>')
+        .description('구간 리포트용으로 스크립트를 그 구간 문장만 잘라 저장한다. 문장 번호는 그대로 둔다')
+        .requiredOption('--range <from-to>', '영상 시각 구간 (예: 1:30-5:00, 90-300)')
+        .action((slug, o, cmd) => digestSliceCommand(slug, { ...digestInherited(cmd), ...o }));
+    digest
+        .command('translate-apply <slug> <file>')
+        .description('스크립트 번역({ lang, items: [{ i, translation }] })을 문장 번호로 붙인다. 언어가 바뀌면 이전 번역을 지운다')
+        .action((slug, file, o, cmd) => digestTranslateApplyCommand(slug, file, { ...digestInherited(cmd), ...o }));
+    digest
+        .command('serve <slug>')
+        .description('뷰어를 로컬 서버(127.0.0.1)로 띄운다. 유튜브 재생과 따라가기는 여기서만 된다')
+        .option('--port <n>', '포트 (기본: 7893부터 빈 곳)')
+        .option('--no-browser', '브라우저를 열지 않는다')
+        .action((slug, o, cmd) => digestServeCommand(slug, { ...digestInherited(cmd), ...o }));
     const reviewLoop = program
         .command('review-loop')
         .description('남의 PR 리뷰 루프가 쓰는 조회 — 판정에 쓰는 수를 여기서 낸다');