@tienne/gestalt 0.102.0 → 0.104.0

package/dist/src/digest/render-md.js

@@ -0,0 +1,126 @@
+import { frameFileName, shotFileName } from './frames.js';
+import { CAPTION_LABEL, formatTime, stripNumbering, watchUrlAt } from './format.js';
+import { blockMarkdown, mdInline, sectionDiagramMd } from './render-blocks.js';
+import { reportLabel } from './reports.js';
+import { keywordPattern, } from './schema.js';
+/** 키워드 마커는 표시 글자만 남긴다. 굵게(`**`)는 마크다운 문법 그대로라 둔다 */
+const plain = (text) => text.replace(keywordPattern(), (_m, _id, label) => label);
+/**
+ * digest.json을 마크다운 한 파일로 바꾼다. LLM을 부르지 않는다.
+ * 기존 video-summarizer가 직접 쓰던 마크다운을 이 출력이 대신한다.
+ */
+export function renderDigestMarkdown(digest, transcript, opts = {}) {
+    const { meta, segments } = transcript;
+    const long = meta.durationSec >= 3600;
+    const at = (i) => segments[i]?.startSec ?? 0;
+    const framesHref = opts.framesHref ?? 'frames';
+    const cite = mdCiter(transcript);
+    const out = mdHeader(transcript);
+    const report = opts.report ?? digest.reports[0];
+    // 리포트가 하나뿐이고 옵션도 기본이면 1차 출력과 같게 둔다
+    if (digest.reports.length > 1 || report.options.range || report.options.prompt) {
+        out.push(`> 리포트: ${reportLabel(report.options, long)}`);
+        if (report.options.prompt) {
+            out.push(`> 요청: ${report.options.prompt.replace(/\s+/g, ' ')}`);
+        }
+        out.push('');
+    }
+    const { lead, sections, skipped, keywords } = report;
+    out.push(`**${plain(lead.question)}**`, '', plain(lead.answer), '', plain(lead.takeaway), '');
+    const bullet = (b, depth) => {
+        const pad = '  '.repeat(depth);
+        const lines = [`${pad}- ${plain(b.text)}${cite(b.cite)}`];
+        for (const c of b.children ?? [])
+            lines.push(...bullet(c, depth + 1));
+        return lines;
+    };
+    const time = mdTimer(transcript);
+    sections.forEach((s, si) => {
+        out.push(`## ${si + 1}. ${stripNumbering(s.title)}`, '', plain(s.conclusion), '');
+        if (s.diagram)
+            out.push(...sectionDiagramMd(s.diagram, { cite, time }));
+        s.subsections.forEach((sub, ui) => {
+            out.push(`### ${si + 1}.${ui + 1}. ${stripNumbering(sub.title)}`, '');
+            // 뷰어와 같이 장면이 있으면 첫 문장 프레임 대신 장면을 싣는다
+            const shots = (sub.shots ?? []).filter((x) => opts.frameExists?.(shotFileName(x.sec)));
+            for (const shot of shots) {
+                // 개행이 남으면 이미지 문법이 깨져 다음 줄이 따로 해석된다
+                const alt = shot.caption
+                    .replace(/\s+/g, ' ')
+                    .trim()
+                    .replace(/[\\[\]<>!]/g, (ch) => `\\${ch}`);
+                out.push(`![${alt}](${framesHref}/${shotFileName(shot.sec)})`, '');
+                const url = watchUrlAt(transcript.meta, shot.sec);
+                const at = formatTime(shot.sec, long);
+                out.push(`*${mdInline(shot.caption)}* ${url ? `[${at}](${url})` : at}${cite(shot.cite)}`, '');
+            }
+            const frame = frameFileName(sub.frameSec);
+            if (shots.length === 0 && opts.frameExists?.(frame))
+                out.push(`![${formatTime(sub.frameSec, long)}](${framesHref}/${frame})`, '');
+            for (const b of sub.bullets)
+                out.push(...bullet(b, 0));
+            out.push('');
+        });
+    });
+    if (keywords.length > 0) {
+        out.push('## 키워드', '');
+        for (const k of keywords)
+            out.push(`- **${k.term}**: ${plain(k.explanation)}${cite(k.firstCite)}`);
+        out.push('');
+    }
+    if (skipped.length > 0) {
+        out.push('## 요약에서 뺀 구간', '');
+        for (const s of skipped) {
+            out.push(`- ${formatTime(at(s.from), long)}~ 문장 ${s.from + 1}-${s.to + 1}: ${plain(s.reason)}`);
+        }
+        out.push('');
+    }
+    return finish(out);
+}
+/** 확장 리포트 한 벌을 마크다운으로. 머리말은 요약 마크다운과 같다 */
+export function renderExtensionMarkdown(ext, transcript) {
+    const cite = mdCiter(transcript);
+    const out = mdHeader(transcript);
+    out.push(`> 리포트: ${mdInline(ext.title)}`, '');
+    const time = mdTimer(transcript);
+    for (const b of ext.blocks)
+        out.push(...blockMarkdown(b, { cite, time }));
+    return finish(out);
+}
+function mdCiter(transcript) {
+    const { meta, segments } = transcript;
+    const long = meta.durationSec >= 3600;
+    const at = (i) => segments[i]?.startSec ?? 0;
+    return (c) => {
+        const url = watchUrlAt(meta, at(c.key));
+        return url ? ` [[${c.key + 1}]](${url})` : ` [${c.key + 1} ${formatTime(at(c.key), long)}]`;
+    };
+}
+function mdTimer({ meta, segments }) {
+    const long = meta.durationSec >= 3600;
+    return (c) => {
+        const sec = segments[c.key]?.startSec ?? 0;
+        const url = watchUrlAt(meta, sec);
+        return url ? `[${formatTime(sec, long)}](${url})` : formatTime(sec, long);
+    };
+}
+function mdHeader({ meta }) {
+    const long = meta.durationSec >= 3600;
+    const out = [`# ${meta.title}`, ''];
+    const facts = [
+        meta.channel,
+        meta.publishedAt,
+        formatTime(meta.durationSec, long),
+        CAPTION_LABEL[meta.captionSource],
+    ].filter(Boolean);
+    out.push(`> ${facts.join(' | ')}`);
+    if (meta.source === 'youtube' && meta.url)
+        out.push(`> ${meta.url}`);
+    out.push('');
+    return out;
+}
+const finish = (out) => `${out
+    .join('\n')
+    .replace(/\n{3,}/g, '\n\n')
+    .trimEnd()}\n`;
+//# sourceMappingURL=render-md.js.map

package/dist/src/digest/render-md.js.map

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

package/dist/src/digest/render.d.ts

@@ -0,0 +1,47 @@
+import { type DigestIssue } from './lint.js';
+import { type Digest, type Transcript } from './schema.js';
+import { DigestStore } from './store.js';
+import { type DigestTemplate } from './templates.js';
+export interface RenderFilesOptions {
+    repoRoot: string;
+    inlineFrames?: boolean;
+    /** 아는 템플릿. lint가 확장의 블록을 대조하고 뷰어의 "+ 더 만들기" 메뉴가 이 목록을 띄운다 */
+    templates?: DigestTemplate[];
+}
+export interface RenderFilesResult {
+    slug: string;
+    htmlPath: string;
+    mdPath: string;
+    warnings: string[];
+}
+/** 렌더할 파일을 못 읽었다. code는 ges_digest validate가 내는 코드와 같다 */
+export declare class DigestLoadError extends Error {
+    readonly code: 'TRANSCRIPT_NOT_FOUND' | 'TRANSCRIPT_INVALID' | 'DIGEST_NOT_FOUND' | 'DIGEST_NOT_JSON' | 'INVALID_DIGEST' | 'REPORT_NOT_FOUND';
+    constructor(code: 'TRANSCRIPT_NOT_FOUND' | 'TRANSCRIPT_INVALID' | 'DIGEST_NOT_FOUND' | 'DIGEST_NOT_JSON' | 'INVALID_DIGEST' | 'REPORT_NOT_FOUND', message: string);
+}
+/** lint 오류가 남아 렌더를 막았다. 호출하는 쪽이 오류 전체를 구조로 받게 issues를 싣는다 */
+export declare class DigestLintError extends Error {
+    readonly issues: DigestIssue[];
+    constructor(issues: DigestIssue[]);
+}
+/** lint 오류가 남은 요약은 출처가 엉뚱한 문장을 가리킬 수 있어 렌더하지 않는다 */
+export declare function loadForRender(store: DigestStore, slug: string, templates?: DigestTemplate[]): {
+    transcript: Transcript;
+    digest: Digest;
+};
+/** digest.html과 digest.md를 한 번에 쓴다. 둘 다 같은 digest.json에서 나온다 */
+export declare function renderToFiles(slug: string, opts: RenderFilesOptions): RenderFilesResult;
+/**
+ * 마크다운만 원하는 자리에 쓴다. out이 없으면 저장 폴더에 쓴다.
+ * 첫 리포트는 digest.md, 다른 리포트와 확장은 digest.<key>.md다. render가 digest.md를 덮어쓰니 이름을 나눈다.
+ * 확장 키에는 늘 .이 들어가고 리포트 키에는 없어서 report 하나로 둘 다 받는다
+ */
+export declare function exportMarkdown(slug: string, opts: {
+    repoRoot: string;
+    out?: string;
+    report?: string;
+}): {
+    slug: string;
+    mdPath: string;
+};
+//# sourceMappingURL=render.d.ts.map

package/dist/src/digest/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/digest/render.ts"],"names":[],"mappings":"AAKA,OAAO,EAA0B,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAIrE,OAAO,EAAe,KAAK,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAe,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAElE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,0DAA0D;AAC1D,qBAAa,eAAgB,SAAQ,KAAK;IAEtC,QAAQ,CAAC,IAAI,EACT,sBAAsB,GACtB,oBAAoB,GACpB,kBAAkB,GAClB,iBAAiB,GACjB,gBAAgB,GAChB,kBAAkB;gBANb,IAAI,EACT,sBAAsB,GACtB,oBAAoB,GACpB,kBAAkB,GAClB,iBAAiB,GACjB,gBAAgB,GAChB,kBAAkB,EACtB,OAAO,EAAE,MAAM;CAKlB;AAED,6DAA6D;AAC7D,qBAAa,eAAgB,SAAQ,KAAK;IAC5B,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE;gBAArB,MAAM,EAAE,WAAW,EAAE;CAO3C;AAED,oDAAoD;AACpD,wBAAgB,aAAa,CAC3B,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,cAAc,EAAE,GAC3B;IAAE,UAAU,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA6B5C;AAED,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,iBAAiB,CAiBvF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA6ClC"}

package/dist/src/digest/render.js

@@ -0,0 +1,126 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join, relative, resolve, sep } from 'node:path';
+import { extensionKey } from './blocks.js';
+import { commentsMap } from './comments.js';
+import { sceneSecs } from './scenes.js';
+import { lintDigest, lintErrors } from './lint.js';
+import { renderDigestHtml } from './render-html.js';
+import { renderDigestMarkdown, renderExtensionMarkdown } from './render-md.js';
+import { findReport, reportKey } from './reports.js';
+import { parseDigest } from './schema.js';
+import { DigestStore } from './store.js';
+import { templateMap } from './templates.js';
+/** 렌더할 파일을 못 읽었다. code는 ges_digest validate가 내는 코드와 같다 */
+export class DigestLoadError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'DigestLoadError';
+    }
+}
+/** lint 오류가 남아 렌더를 막았다. 호출하는 쪽이 오류 전체를 구조로 받게 issues를 싣는다 */
+export class DigestLintError extends Error {
+    issues;
+    constructor(issues) {
+        super(`validate 오류 ${issues.length}개가 남아 있어 렌더하지 않았어요.\n` +
+            issues.map((i) => `${i.code} ${i.path}: ${i.message}`).join('\n'));
+        this.issues = issues;
+        this.name = 'DigestLintError';
+    }
+}
+/** lint 오류가 남은 요약은 출처가 엉뚱한 문장을 가리킬 수 있어 렌더하지 않는다 */
+export function loadForRender(store, slug, templates) {
+    const t = store.readTranscript(slug);
+    if (!t.ok)
+        throw new DigestLoadError(t.code, t.message);
+    const raw = store.readDigestFile(slug);
+    if (raw.kind === 'missing') {
+        throw new DigestLoadError('DIGEST_NOT_FOUND', `digest.json이 없어요. 먼저 요약을 써 주세요: ${slug}`);
+    }
+    if (raw.kind === 'invalid-json') {
+        throw new DigestLoadError('DIGEST_NOT_JSON', `digest.json을 JSON으로 못 읽었어요: ${raw.message}`);
+    }
+    const parsed = parseDigest(raw.value);
+    if (!parsed.ok)
+        throw new DigestLoadError('INVALID_DIGEST', parsed.error.message);
+    const errors = lintErrors(lintDigest(parsed.value, t.transcript, {
+        templates: templates ? templateMap(templates) : undefined,
+        // 댓글이나 후보 장면 파일을 나중에 지웠거나 깨졌어도 이미 합친 리포트는 그린다.
+        // 있을 때만 대조하고 없을 때 막는 일은 merge와 validate가 맡는다
+        comments: commentsMap(store, slug) ?? undefined,
+        scenes: sceneSecs(store, slug) ?? undefined,
+    }));
+    if (errors.length > 0)
+        throw new DigestLintError(errors);
+    return { transcript: t.transcript, digest: parsed.value };
+}
+/** digest.html과 digest.md를 한 번에 쓴다. 둘 다 같은 digest.json에서 나온다 */
+export function renderToFiles(slug, opts) {
+    const store = new DigestStore(opts.repoRoot);
+    const { transcript, digest } = loadForRender(store, slug, opts.templates);
+    const framesDir = store.framesDir(slug);
+    const frameExists = (file) => existsSync(join(framesDir, file));
+    const { html, warnings } = renderDigestHtml(digest, transcript, {
+        frameExists,
+        inlineFrames: opts.inlineFrames,
+        templates: opts.templates,
+        loadFrame: (file) => (frameExists(file) ? readFileSync(join(framesDir, file)) : null),
+    });
+    return {
+        slug,
+        htmlPath: store.saveHtml(slug, html),
+        mdPath: store.saveMd(slug, renderDigestMarkdown(digest, transcript, { frameExists })),
+        warnings,
+    };
+}
+/**
+ * 마크다운만 원하는 자리에 쓴다. out이 없으면 저장 폴더에 쓴다.
+ * 첫 리포트는 digest.md, 다른 리포트와 확장은 digest.<key>.md다. render가 digest.md를 덮어쓰니 이름을 나눈다.
+ * 확장 키에는 늘 .이 들어가고 리포트 키에는 없어서 report 하나로 둘 다 받는다
+ */
+export function exportMarkdown(slug, opts) {
+    const store = new DigestStore(opts.repoRoot);
+    const { transcript, digest } = loadForRender(store, slug);
+    const ext = opts.report
+        ? digest.extensions.find((x) => extensionKey(x) === opts.report)
+        : undefined;
+    if (ext) {
+        const md = renderExtensionMarkdown(ext, transcript);
+        const mdPath = opts.out
+            ? resolve(opts.out)
+            : join(store.dir(slug), `digest.${extensionKey(ext)}.md`);
+        mkdirSync(dirname(mdPath), { recursive: true });
+        writeFileSync(mdPath, md);
+        return { slug, mdPath };
+    }
+    const report = opts.report ? findReport(digest, opts.report) : digest.reports[0];
+    if (!report) {
+        const keys = [
+            ...digest.reports.map((r) => reportKey(r.options)),
+            ...digest.extensions.map(extensionKey),
+        ];
+        throw new DigestLoadError('REPORT_NOT_FOUND', `리포트 ${opts.report}가 없어요. 있는 리포트: ${keys.join(', ')}`);
+    }
+    const framesDir = store.framesDir(slug);
+    const frameExists = (file) => existsSync(join(framesDir, file));
+    if (!opts.out) {
+        const md = renderDigestMarkdown(digest, transcript, { frameExists, report });
+        if (report === digest.reports[0])
+            return { slug, mdPath: store.saveMd(slug, md) };
+        const mdPath = join(store.dir(slug), `digest.${reportKey(report.options)}.md`);
+        writeFileSync(mdPath, md);
+        return { slug, mdPath };
+    }
+    const mdPath = resolve(opts.out);
+    // 다른 폴더에 쓰면 frames/ 상대 경로가 깨지니 그 파일 기준으로 다시 잡는다
+    const framesHref = relative(dirname(mdPath), framesDir)
+        .split(sep)
+        .map(encodeURIComponent)
+        .join('/');
+    const md = renderDigestMarkdown(digest, transcript, { frameExists, framesHref, report });
+    mkdirSync(dirname(mdPath), { recursive: true });
+    writeFileSync(mdPath, md);
+    return { slug, mdPath };
+}
+//# sourceMappingURL=render.js.map

package/dist/src/digest/render.js.map

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

package/dist/src/digest/reports.d.ts

@@ -0,0 +1,26 @@
+import type { Digest, Report, ReportOptions, Segment } from './schema.js';
+export declare const LENGTH_LABEL: Record<ReportOptions['length'], string>;
+export declare const DIFFICULTY_LABEL: Record<ReportOptions['difficulty'], string>;
+/**
+ * 리포트를 가르는 키. 뷰어 툴바와 merge가 이 값으로 같은 리포트인지 본다.
+ * prompt는 그대로 넣으면 길고 HTML 속성에 실리므로 해시 앞 8자만 쓴다
+ */
+export declare function reportKey(options: ReportOptions): string;
+/** 구간 리포트가 덮어야 하는 문장 번호. startSec이 [시작, 끝)에 드는 문장들이다 */
+export declare function rangeSpan(range: readonly [number, number], segments: readonly Segment[]): {
+    from: number;
+    to: number;
+} | null;
+/**
+ * 툴바의 분량과 난이도 버튼으로 고를 수 있는 리포트인지 본다.
+ * 구간이나 프롬프트가 붙었거나 첫 리포트와 언어가 다르면 따로 고르는 리포트다
+ */
+export declare function isPreset(options: ReportOptions, base: ReportOptions): boolean;
+export declare function reportLabel(options: ReportOptions, withHours?: boolean): string;
+export declare function findReport(digest: Digest, key: string): Report | undefined;
+/** 같은 키의 리포트가 있으면 그 자리에 바꿔 끼우고 없으면 뒤에 붙인다 */
+export declare function upsertReport(digest: Digest, report: Report): {
+    digest: Digest;
+    replaced: boolean;
+};
+//# sourceMappingURL=reports.d.ts.map

package/dist/src/digest/reports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../../src/digest/reports.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE1E,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,CAIhE,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,MAAM,CAGxE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CASxD;AAED,wDAAwD;AACxD,wBAAgB,SAAS,CACvB,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAC3B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CASrC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAE7E;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,UAAQ,GAAG,MAAM,CAU7E;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1E;AAED,6CAA6C;AAC7C,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAOvC"}

package/dist/src/digest/reports.js

@@ -0,0 +1,70 @@
+import { createHash } from 'node:crypto';
+import { formatTime } from './format.js';
+export const LENGTH_LABEL = {
+    short: '짧게',
+    default: '기본',
+    long: '길게',
+};
+export const DIFFICULTY_LABEL = {
+    normal: '보통',
+    easy: '쉽게',
+};
+/**
+ * 리포트를 가르는 키. 뷰어 툴바와 merge가 이 값으로 같은 리포트인지 본다.
+ * prompt는 그대로 넣으면 길고 HTML 속성에 실리므로 해시 앞 8자만 쓴다
+ */
+export function reportKey(options) {
+    const parts = [options.length, options.difficulty, options.lang];
+    if (options.range) {
+        parts.push(`r${options.range[0]}-${options.range[1]}`);
+    }
+    if (options.prompt) {
+        parts.push(`p${createHash('sha256').update(options.prompt).digest('hex').slice(0, 8)}`);
+    }
+    return parts.join('-');
+}
+/** 구간 리포트가 덮어야 하는 문장 번호. startSec이 [시작, 끝)에 드는 문장들이다 */
+export function rangeSpan(range, segments) {
+    let from = -1;
+    let to = -1;
+    for (const s of segments) {
+        if (s.startSec < range[0] || s.startSec >= range[1])
+            continue;
+        if (from < 0)
+            from = s.i;
+        to = s.i;
+    }
+    return from < 0 ? null : { from, to };
+}
+/**
+ * 툴바의 분량과 난이도 버튼으로 고를 수 있는 리포트인지 본다.
+ * 구간이나 프롬프트가 붙었거나 첫 리포트와 언어가 다르면 따로 고르는 리포트다
+ */
+export function isPreset(options, base) {
+    return !options.range && !options.prompt && options.lang === base.lang;
+}
+export function reportLabel(options, withHours = false) {
+    const parts = [`${LENGTH_LABEL[options.length]}, ${DIFFICULTY_LABEL[options.difficulty]}`];
+    if (options.range) {
+        parts.push(`${formatTime(options.range[0], withHours)}~${formatTime(options.range[1], withHours)}`);
+    }
+    parts.push(options.lang);
+    if (options.prompt)
+        parts.push('요청 반영');
+    return parts.join(' / ');
+}
+export function findReport(digest, key) {
+    return digest.reports.find((r) => reportKey(r.options) === key);
+}
+/** 같은 키의 리포트가 있으면 그 자리에 바꿔 끼우고 없으면 뒤에 붙인다 */
+export function upsertReport(digest, report) {
+    const key = reportKey(report.options);
+    const at = digest.reports.findIndex((r) => reportKey(r.options) === key);
+    const reports = [...digest.reports];
+    if (at >= 0)
+        reports[at] = report;
+    else
+        reports.push(report);
+    return { digest: { ...digest, reports }, replaced: at >= 0 };
+}
+//# sourceMappingURL=reports.js.map

package/dist/src/digest/reports.js.map

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

package/dist/src/digest/scenes.d.ts

@@ -0,0 +1,92 @@
+import { z } from 'zod';
+import { type OcrFile } from './ocr.js';
+import { DigestStore } from './store.js';
+import { type RunCommand } from './ytdlp.js';
+/**
+ * 소섹션 shots가 고를 수 있는 후보 장면. 슬라이드가 넘어가거나 화면이 바뀐 시각이다.
+ * 요약 작성자는 장면을 보지 못하니 OCR 글자 앞부분을 붙여 무엇이 화면에 있었는지 짐작하게 한다
+ */
+export declare const SCENES_FILE = "scenes.json";
+/** 이보다 글자가 적은 화면은 사람 얼굴이나 자막 한 줄일 때가 많아 슬라이드로 보지 않는다 */
+export declare const SCENE_MIN_CHARS = 40;
+/** 앞 항목과 단어가 이 비율보다 많이 달라야 다른 화면으로 본다 */
+export declare const SCENE_CHANGE_RATIO = 0.5;
+/** ffmpeg 장면 전환 점수 문턱 */
+export declare const SCENE_THRESHOLD = 0.4;
+export declare const SCENE_MIN_GAP_SEC = 3;
+export declare const MAX_SCENES = 300;
+export declare const scenesFileSchema: z.ZodObject<{
+    source: z.ZodEnum<["ocr", "scene"]>;
+    items: z.ZodArray<z.ZodObject<{
+        sec: z.ZodNumber;
+        i: z.ZodNumber;
+        text: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        i: number;
+        sec: number;
+        text?: string | undefined;
+    }, {
+        i: number;
+        sec: number;
+        text?: string | undefined;
+    }>, "many">;
+    /** 상한을 넘어 솎았을 때만 있다. 솎기 전 후보 수다 */
+    total: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    source: "ocr" | "scene";
+    items: {
+        i: number;
+        sec: number;
+        text?: string | undefined;
+    }[];
+    total?: number | undefined;
+}, {
+    source: "ocr" | "scene";
+    items: {
+        i: number;
+        sec: number;
+        text?: string | undefined;
+    }[];
+    total?: number | undefined;
+}>;
+export type ScenesFile = z.infer<typeof scenesFileSchema>;
+export type SceneItem = ScenesFile['items'][number];
+/** cur의 단어 가운데 prev에 없는 비율. 0이면 같은 화면, 1이면 전혀 다른 화면이다 */
+export declare function textChange(prev: string, cur: string): number;
+export declare function textHead(text: string, max?: number): string;
+/** 글자가 넉넉하고 앞 항목과 절반 넘게 다른 화면만 남긴다. 슬라이드가 넘어간 자리다 */
+export declare function ocrScenes(ocr: OcrFile): SceneItem[];
+/** 앞 후보와 minGap초 안에 붙은 전환은 버린다. 카메라가 연달아 바뀌는 자리는 하나만 남는다 */
+export declare function thinSceneTimes(secs: number[], minGap?: number): number[];
+/** 시간순 후보가 max개를 넘으면 처음과 끝을 포함해 고르게 솎는다. 앞에서 자르면 영상 뒷부분 장면이 통째로 빠진다 */
+export declare function spreadEvenly<T>(items: readonly T[], max?: number): T[];
+export type ScenesRead = {
+    kind: 'missing';
+} | {
+    kind: 'invalid';
+    message: string;
+} | {
+    kind: 'ok';
+    value: ScenesFile;
+};
+export declare function readScenes(store: DigestStore, slug: string): ScenesRead;
+/** lint가 받는 꼴. 파일이 없거나 깨졌으면 null이다 */
+export declare function sceneSecs(store: DigestStore, slug: string): number[] | null;
+export interface ScenesOptions {
+    repoRoot: string;
+    run?: RunCommand;
+}
+export interface ScenesResult {
+    path: string;
+    source: ScenesFile['source'];
+    items: number;
+    /** 솎기 전 후보 수. items보다 크면 상한에 걸려 고르게 솎은 것이다 */
+    total: number;
+    truncated: boolean;
+}
+/**
+ * 후보 장면을 scenes.json에 둔다. ocr.json이 있으면 글자로 고르고 없으면 ffmpeg 장면 전환을 쓴다.
+ * 장면 전환만으로는 슬라이드인지 얼굴인지 못 가려서 글자가 있으면 글자를 먼저 쓴다
+ */
+export declare function pickScenes(slug: string, opts: ScenesOptions): Promise<ScenesResult>;
+//# sourceMappingURL=scenes.d.ts.map

package/dist/src/digest/scenes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenes.d.ts","sourceRoot":"","sources":["../../../src/digest/scenes.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAA2B,KAAK,OAAO,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,WAAW,EAAW,MAAM,YAAY,CAAC;AAElD,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,WAAW,gBAAgB,CAAC;AAEzC,wDAAwD;AACxD,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,yCAAyC;AACzC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,yBAAyB;AACzB,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,UAAU,MAAM,CAAC;AAG9B,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;IAW3B,mCAAmC;;;;;;;;;;;;;;;;;;EAEnC,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAoBpD,yDAAyD;AACzD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAO5D;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAY,GAAG,MAAM,CAG9D;AAED,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,EAAE,CAWnD;AAED,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,SAAoB,GAAG,MAAM,EAAE,CAOnF;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,GAAG,SAAa,GAAG,CAAC,EAAE,CAO1E;AAOD,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC;AAEtC,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAYvE;AAED,sCAAsC;AACtC,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAG3E;AAWD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;CACpB;AAcD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAmCzF"}