@tienne/gestalt 0.102.0 → 0.104.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (179) hide show
  1. package/README.ko.md +2 -1
  2. package/README.md +2 -1
  3. package/dist/package.json +1 -1
  4. package/dist/plugin/role-agents/video-summarizer/AGENT.md +208 -108
  5. package/dist/plugin/skills/_shared/proactive-routing.md +2 -1
  6. package/dist/plugin/skills/research/references/design.md +1 -1
  7. package/dist/plugin/skills/video-digest/SKILL.md +430 -0
  8. package/dist/plugin/skills/video-digest/templates/background.md +15 -0
  9. package/dist/plugin/skills/video-digest/templates/blog.md +16 -0
  10. package/dist/plugin/skills/video-digest/templates/comments.md +19 -0
  11. package/dist/plugin/skills/video-digest/templates/counterpoints.md +15 -0
  12. package/dist/plugin/skills/video-digest/templates/flashcards.md +15 -0
  13. package/dist/plugin/skills/video-digest/templates/interview.md +15 -0
  14. package/dist/plugin/skills/video-digest/templates/meeting.md +15 -0
  15. package/dist/plugin/skills/video-digest/templates/mindmap.md +16 -0
  16. package/dist/plugin/skills/video-digest/templates/quiz.md +16 -0
  17. package/dist/plugin/skills/video-digest/templates/quotes.md +16 -0
  18. package/dist/plugin/skills/video-digest/templates/resources.md +14 -0
  19. package/dist/plugin/skills/video-digest/templates/timestamps.md +14 -0
  20. package/dist/plugin/skills/video-digest/templates/visual.md +22 -0
  21. package/dist/src/cli/commands/digest.d.ts +60 -0
  22. package/dist/src/cli/commands/digest.d.ts.map +1 -0
  23. package/dist/src/cli/commands/digest.js +401 -0
  24. package/dist/src/cli/commands/digest.js.map +1 -0
  25. package/dist/src/cli/index.d.ts.map +1 -1
  26. package/dist/src/cli/index.js +81 -0
  27. package/dist/src/cli/index.js.map +1 -1
  28. package/dist/src/digest/blocks.d.ts +5224 -0
  29. package/dist/src/digest/blocks.d.ts.map +1 -0
  30. package/dist/src/digest/blocks.js +156 -0
  31. package/dist/src/digest/blocks.js.map +1 -0
  32. package/dist/src/digest/captions.d.ts +37 -0
  33. package/dist/src/digest/captions.d.ts.map +1 -0
  34. package/dist/src/digest/captions.js +138 -0
  35. package/dist/src/digest/captions.js.map +1 -0
  36. package/dist/src/digest/comments.d.ts +113 -0
  37. package/dist/src/digest/comments.d.ts.map +1 -0
  38. package/dist/src/digest/comments.js +153 -0
  39. package/dist/src/digest/comments.js.map +1 -0
  40. package/dist/src/digest/diagram-schema.d.ts +765 -0
  41. package/dist/src/digest/diagram-schema.d.ts.map +1 -0
  42. package/dist/src/digest/diagram-schema.js +72 -0
  43. package/dist/src/digest/diagram-schema.js.map +1 -0
  44. package/dist/src/digest/format.d.ts +9 -0
  45. package/dist/src/digest/format.d.ts.map +1 -0
  46. package/dist/src/digest/format.js +26 -0
  47. package/dist/src/digest/format.js.map +1 -0
  48. package/dist/src/digest/frames.d.ts +46 -0
  49. package/dist/src/digest/frames.d.ts.map +1 -0
  50. package/dist/src/digest/frames.js +206 -0
  51. package/dist/src/digest/frames.js.map +1 -0
  52. package/dist/src/digest/index.d.ts +26 -0
  53. package/dist/src/digest/index.d.ts.map +1 -0
  54. package/dist/src/digest/index.js +26 -0
  55. package/dist/src/digest/index.js.map +1 -0
  56. package/dist/src/digest/ingest.d.ts +65 -0
  57. package/dist/src/digest/ingest.d.ts.map +1 -0
  58. package/dist/src/digest/ingest.js +303 -0
  59. package/dist/src/digest/ingest.js.map +1 -0
  60. package/dist/src/digest/lint-extension.d.ts +71 -0
  61. package/dist/src/digest/lint-extension.d.ts.map +1 -0
  62. package/dist/src/digest/lint-extension.js +512 -0
  63. package/dist/src/digest/lint-extension.js.map +1 -0
  64. package/dist/src/digest/lint.d.ts +50 -0
  65. package/dist/src/digest/lint.d.ts.map +1 -0
  66. package/dist/src/digest/lint.js +560 -0
  67. package/dist/src/digest/lint.js.map +1 -0
  68. package/dist/src/digest/merge.d.ts +40 -0
  69. package/dist/src/digest/merge.d.ts.map +1 -0
  70. package/dist/src/digest/merge.js +107 -0
  71. package/dist/src/digest/merge.js.map +1 -0
  72. package/dist/src/digest/ocr.d.ts +100 -0
  73. package/dist/src/digest/ocr.d.ts.map +1 -0
  74. package/dist/src/digest/ocr.js +179 -0
  75. package/dist/src/digest/ocr.js.map +1 -0
  76. package/dist/src/digest/prose.d.ts +47 -0
  77. package/dist/src/digest/prose.d.ts.map +1 -0
  78. package/dist/src/digest/prose.js +171 -0
  79. package/dist/src/digest/prose.js.map +1 -0
  80. package/dist/src/digest/render-blocks.d.ts +38 -0
  81. package/dist/src/digest/render-blocks.d.ts.map +1 -0
  82. package/dist/src/digest/render-blocks.js +378 -0
  83. package/dist/src/digest/render-blocks.js.map +1 -0
  84. package/dist/src/digest/render-html.d.ts +22 -0
  85. package/dist/src/digest/render-html.d.ts.map +1 -0
  86. package/dist/src/digest/render-html.js +505 -0
  87. package/dist/src/digest/render-html.js.map +1 -0
  88. package/dist/src/digest/render-md.d.ts +18 -0
  89. package/dist/src/digest/render-md.d.ts.map +1 -0
  90. package/dist/src/digest/render-md.js +126 -0
  91. package/dist/src/digest/render-md.js.map +1 -0
  92. package/dist/src/digest/render.d.ts +47 -0
  93. package/dist/src/digest/render.d.ts.map +1 -0
  94. package/dist/src/digest/render.js +126 -0
  95. package/dist/src/digest/render.js.map +1 -0
  96. package/dist/src/digest/reports.d.ts +26 -0
  97. package/dist/src/digest/reports.d.ts.map +1 -0
  98. package/dist/src/digest/reports.js +70 -0
  99. package/dist/src/digest/reports.js.map +1 -0
  100. package/dist/src/digest/scenes.d.ts +92 -0
  101. package/dist/src/digest/scenes.d.ts.map +1 -0
  102. package/dist/src/digest/scenes.js +182 -0
  103. package/dist/src/digest/scenes.js.map +1 -0
  104. package/dist/src/digest/schema-base.d.ts +31 -0
  105. package/dist/src/digest/schema-base.d.ts.map +1 -0
  106. package/dist/src/digest/schema-base.js +19 -0
  107. package/dist/src/digest/schema-base.js.map +1 -0
  108. package/dist/src/digest/schema.d.ts +12886 -0
  109. package/dist/src/digest/schema.d.ts.map +1 -0
  110. package/dist/src/digest/schema.js +215 -0
  111. package/dist/src/digest/schema.js.map +1 -0
  112. package/dist/src/digest/server.d.ts +36 -0
  113. package/dist/src/digest/server.d.ts.map +1 -0
  114. package/dist/src/digest/server.js +278 -0
  115. package/dist/src/digest/server.js.map +1 -0
  116. package/dist/src/digest/slice.d.ts +20 -0
  117. package/dist/src/digest/slice.d.ts.map +1 -0
  118. package/dist/src/digest/slice.js +48 -0
  119. package/dist/src/digest/slice.js.map +1 -0
  120. package/dist/src/digest/store.d.ts +67 -0
  121. package/dist/src/digest/store.d.ts.map +1 -0
  122. package/dist/src/digest/store.js +152 -0
  123. package/dist/src/digest/store.js.map +1 -0
  124. package/dist/src/digest/svg.d.ts +74 -0
  125. package/dist/src/digest/svg.d.ts.map +1 -0
  126. package/dist/src/digest/svg.js +415 -0
  127. package/dist/src/digest/svg.js.map +1 -0
  128. package/dist/src/digest/templates.d.ts +38 -0
  129. package/dist/src/digest/templates.d.ts.map +1 -0
  130. package/dist/src/digest/templates.js +125 -0
  131. package/dist/src/digest/templates.js.map +1 -0
  132. package/dist/src/digest/translate.d.ts +46 -0
  133. package/dist/src/digest/translate.d.ts.map +1 -0
  134. package/dist/src/digest/translate.js +50 -0
  135. package/dist/src/digest/translate.js.map +1 -0
  136. package/dist/src/digest/viewer-js.d.ts +4 -0
  137. package/dist/src/digest/viewer-js.d.ts.map +1 -0
  138. package/dist/src/digest/viewer-js.js +735 -0
  139. package/dist/src/digest/viewer-js.js.map +1 -0
  140. package/dist/src/digest/viewer-logic.d.ts +46 -0
  141. package/dist/src/digest/viewer-logic.d.ts.map +1 -0
  142. package/dist/src/digest/viewer-logic.js +89 -0
  143. package/dist/src/digest/viewer-logic.js.map +1 -0
  144. package/dist/src/digest/ytdlp.d.ts +34 -0
  145. package/dist/src/digest/ytdlp.d.ts.map +1 -0
  146. package/dist/src/digest/ytdlp.js +64 -0
  147. package/dist/src/digest/ytdlp.js.map +1 -0
  148. package/dist/src/mcp/schemas.d.ts +48 -0
  149. package/dist/src/mcp/schemas.d.ts.map +1 -1
  150. package/dist/src/mcp/schemas.js +25 -0
  151. package/dist/src/mcp/schemas.js.map +1 -1
  152. package/dist/src/mcp/server.d.ts.map +1 -1
  153. package/dist/src/mcp/server.js +7 -1
  154. package/dist/src/mcp/server.js.map +1 -1
  155. package/dist/src/mcp/tools/digest-passthrough.d.ts +3 -0
  156. package/dist/src/mcp/tools/digest-passthrough.d.ts.map +1 -0
  157. package/dist/src/mcp/tools/digest-passthrough.js +151 -0
  158. package/dist/src/mcp/tools/digest-passthrough.js.map +1 -0
  159. package/package.json +1 -1
  160. package/plugin/.codex-plugin/plugin.json +1 -1
  161. package/plugin/.mcp.json +1 -1
  162. package/plugin/mcp.json +1 -1
  163. package/plugin/role-agents/video-summarizer/AGENT.md +208 -108
  164. package/plugin/skills/_shared/proactive-routing.md +2 -1
  165. package/plugin/skills/research/references/design.md +1 -1
  166. package/plugin/skills/video-digest/SKILL.md +430 -0
  167. package/plugin/skills/video-digest/templates/background.md +15 -0
  168. package/plugin/skills/video-digest/templates/blog.md +16 -0
  169. package/plugin/skills/video-digest/templates/comments.md +19 -0
  170. package/plugin/skills/video-digest/templates/counterpoints.md +15 -0
  171. package/plugin/skills/video-digest/templates/flashcards.md +15 -0
  172. package/plugin/skills/video-digest/templates/interview.md +15 -0
  173. package/plugin/skills/video-digest/templates/meeting.md +15 -0
  174. package/plugin/skills/video-digest/templates/mindmap.md +16 -0
  175. package/plugin/skills/video-digest/templates/quiz.md +16 -0
  176. package/plugin/skills/video-digest/templates/quotes.md +16 -0
  177. package/plugin/skills/video-digest/templates/resources.md +14 -0
  178. package/plugin/skills/video-digest/templates/timestamps.md +14 -0
  179. package/plugin/skills/video-digest/templates/visual.md +22 -0
@@ -0,0 +1,303 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { existsSync, mkdtempSync, readFileSync, readdirSync, renameSync, rmSync, statSync, } from 'node:fs';
3
+ import { tmpdir } from 'node:os';
4
+ import { basename, dirname, extname, join, resolve } from 'node:path';
5
+ import { pathToFileURL } from 'node:url';
6
+ import { log } from '../core/log.js';
7
+ import { captionsToSentences, cuesToWords, mergeSentences } from './captions.js';
8
+ import { TRANSCRIPT_SCHEMA_VERSION, youtubeWatchUrl, } from './schema.js';
9
+ import { DigestStore, isValidSlug, slugFromMeta } from './store.js';
10
+ import { CommandError, QUICK_TIMEOUT_MS, runCommand, timeoutFor, ytdlp, } from './ytdlp.js';
11
+ const DEFAULT_WHISPER_MODEL = 'large-v3';
12
+ const YOUTUBE_ID = /^[A-Za-z0-9_-]{11}$/;
13
+ /** watch?v=, youtu.be/, shorts/, embed/, live/ 꼴에서 영상 id를 꺼낸다. 유튜브 주소가 아니면 null */
14
+ export function parseYoutubeId(input) {
15
+ let url;
16
+ try {
17
+ url = new URL(input);
18
+ }
19
+ catch {
20
+ return null;
21
+ }
22
+ const host = url.hostname.replace(/^(www|m|music)\./, '');
23
+ let id = null;
24
+ if (host === 'youtu.be')
25
+ id = url.pathname.slice(1).split('/')[0] ?? null;
26
+ else if (host === 'youtube.com' || host === 'youtube-nocookie.com') {
27
+ if (url.pathname === '/watch')
28
+ id = url.searchParams.get('v');
29
+ else {
30
+ const m = url.pathname.match(/^\/(?:shorts|embed|live|v)\/([^/?#]+)/);
31
+ id = m ? m[1] : null;
32
+ }
33
+ }
34
+ return id && YOUTUBE_ID.test(id) ? id : null;
35
+ }
36
+ const langOf = (key) => key.replace(/-orig$/, '');
37
+ const matches = (key, pref) => key === pref || key.startsWith(`${pref}-`) || langOf(key) === pref;
38
+ const primary = (tag) => tag.split('-')[0].toLowerCase();
39
+ // 메타 원어는 `en-US`인데 트랙은 `en-orig`처럼 지역 태그만 다를 때가 있어 주 언어로 한 번 더 맞춘다
40
+ const findPref = (keys, pref) => keys.find((k) => matches(k, pref)) ?? keys.find((k) => primary(langOf(k)) === primary(pref));
41
+ /**
42
+ * 수동 자막 → 자동 자막 순으로 고른다. 자동 자막은 157개 언어가 기계 번역으로 딸려 오는데
43
+ * 영상 원어 트랙만 `-orig`가 붙어서 그걸 먼저 잡는다. 번역 자막은 문장 시각이 어긋나 쓰지 않는다.
44
+ * 자동 더빙이 붙은 영상은 더빙 언어마다 `-orig`가 생겨서 원어에 맞는 것을 먼저 고른다.
45
+ */
46
+ export function pickCaption(meta, prefLang) {
47
+ const prefs = [prefLang, meta.language ?? undefined].filter((p) => !!p);
48
+ const manual = Object.keys(meta.subtitles ?? {}).filter((k) => k !== 'live_chat');
49
+ const auto = Object.keys(meta.automatic_captions ?? {});
50
+ for (const p of prefs) {
51
+ const k = findPref(manual, p);
52
+ if (k)
53
+ return { kind: 'manual', key: k, lang: langOf(k) };
54
+ }
55
+ if (prefs.length === 0 && manual.length === 1) {
56
+ return { kind: 'manual', key: manual[0], lang: langOf(manual[0]) };
57
+ }
58
+ const origs = auto.filter((k) => k.endsWith('-orig'));
59
+ const orig = prefs.map((p) => findPref(origs, p)).find((k) => !!k) ?? origs[0];
60
+ if (orig)
61
+ return { kind: 'auto', key: orig, lang: langOf(orig) };
62
+ for (const p of prefs) {
63
+ if (auto.includes(p))
64
+ return { kind: 'auto', key: p, lang: p };
65
+ }
66
+ return null;
67
+ }
68
+ const toIsoDate = (yyyymmdd) => yyyymmdd && /^\d{8}$/.test(yyyymmdd)
69
+ ? `${yyyymmdd.slice(0, 4)}-${yyyymmdd.slice(4, 6)}-${yyyymmdd.slice(6, 8)}`
70
+ : undefined;
71
+ const round2 = (n) => Math.round(n * 100) / 100;
72
+ function toSegments(cues) {
73
+ let prev = 0;
74
+ return cues.map((c, i) => {
75
+ // 수동 자막은 큐가 겹치기도 해서 시각이 뒤로 가는 경우만 앞 문장에 맞춘다
76
+ prev = Math.max(prev, round2(c.startSec));
77
+ return { i, startSec: prev, text: c.text };
78
+ });
79
+ }
80
+ function findFile(dir, prefix, exts) {
81
+ const hit = readdirSync(dir)
82
+ .filter((f) => f.startsWith(prefix) && exts.includes(extname(f).toLowerCase()))
83
+ .sort();
84
+ return hit.length > 0 ? join(dir, hit[0]) : null;
85
+ }
86
+ // 모델을 받을 때 진행 로그가 stdout에 섞일 수 있어서 결과는 마지막 줄 한 줄로만 낸다
87
+ const WHISPER_SCRIPT = `
88
+ import json, sys
89
+ from faster_whisper import WhisperModel
90
+ audio, model_name, lang = sys.argv[1], sys.argv[2], sys.argv[3] or None
91
+ model = WhisperModel(model_name, device="auto", compute_type="auto")
92
+ segments, info = model.transcribe(audio, language=lang, vad_filter=True)
93
+ out = [{"start": s.start, "text": s.text.strip()} for s in segments if s.text.strip()]
94
+ sys.stdout.write("\\n" + json.dumps({"language": info.language, "segments": out}) + "\\n")
95
+ `;
96
+ const mmss = (sec) => `${Math.floor(sec / 60)}:${String(Math.floor(sec % 60)).padStart(2, '0')}`;
97
+ async function transcribeWithWhisper(run, cwd, audioPath, model, durationSec, lang) {
98
+ log(`faster-whisper ${model} 모델로 ${mmss(durationSec)} 분량을 받아써요. ` +
99
+ 'GPU가 없으면 영상 길이보다 오래 걸릴 수 있어요.');
100
+ let stdout;
101
+ try {
102
+ ({ stdout } = await run('python3', ['-c', WHISPER_SCRIPT, audioPath, model, lang ?? ''], {
103
+ cwd,
104
+ // CPU로 큰 모델을 돌리면 영상 길이의 몇 배가 걸린다. 멈춘 프로세스만 끊을 만큼 넉넉히 둔다
105
+ timeoutMs: timeoutFor(durationSec, 20, 600),
106
+ }));
107
+ }
108
+ catch (e) {
109
+ // faster-whisper 의존 모듈(ctranslate2, av)이 빠진 경우는 설치 안내가 틀려서 원래 오류를 그대로 올린다
110
+ if (e instanceof CommandError && /No module named ['"]faster_whisper/.test(e.stderr)) {
111
+ throw new Error('자막이 없어서 faster-whisper로 받아쓰려 했는데 설치돼 있지 않아요. ' +
112
+ '`python3 -m pip install faster-whisper`로 설치한 뒤 다시 돌려 주세요.', { cause: e });
113
+ }
114
+ throw e;
115
+ }
116
+ const last = stdout.trim().split('\n').pop() ?? '';
117
+ let parsed;
118
+ try {
119
+ parsed = JSON.parse(last);
120
+ }
121
+ catch {
122
+ throw new Error(`받아쓰기 결과를 JSON으로 못 읽었어요: ${stdout.trim().slice(0, 200)}`);
123
+ }
124
+ return {
125
+ lang: parsed.language,
126
+ cues: parsed.segments.map((s) => ({ startSec: s.start, text: s.text })),
127
+ };
128
+ }
129
+ async function probeDuration(run, cwd, file) {
130
+ const { stdout } = await run('ffprobe', ['-v', 'error', '-show_entries', 'format=duration', '-of', 'csv=p=0', file], { cwd, timeoutMs: QUICK_TIMEOUT_MS });
131
+ const sec = Number(stdout.trim());
132
+ if (!Number.isFinite(sec) || sec <= 0)
133
+ throw new Error(`영상 길이를 못 읽었어요: ${file}`);
134
+ return sec;
135
+ }
136
+ async function collectYoutube(videoId, opts, run, work) {
137
+ const watchUrl = youtubeWatchUrl(videoId);
138
+ const quick = { cwd: work, timeoutMs: QUICK_TIMEOUT_MS };
139
+ const { stdout } = await ytdlp(run, ['-J', '--skip-download', watchUrl], undefined, quick);
140
+ const meta = JSON.parse(stdout);
141
+ const title = meta.title?.trim() || videoId;
142
+ const base = {
143
+ source: 'youtube',
144
+ videoId,
145
+ url: watchUrl,
146
+ title,
147
+ ...(meta.channel || meta.uploader ? { channel: meta.channel ?? meta.uploader } : {}),
148
+ durationSec: meta.duration ?? 0,
149
+ ...(toIsoDate(meta.upload_date) ? { publishedAt: toIsoDate(meta.upload_date) } : {}),
150
+ };
151
+ const slug = opts.slug ?? slugFromMeta(videoId, title);
152
+ const pick = opts.whisper ? null : pickCaption(meta, opts.lang);
153
+ if (pick) {
154
+ const flag = pick.kind === 'manual' ? '--write-subs' : '--write-auto-subs';
155
+ const subArgs = [
156
+ ...['--skip-download', flag, '--sub-langs', pick.key, '--sub-format', 'vtt/srt/best'],
157
+ ...['-o', join(work, 'sub.%(ext)s'), watchUrl],
158
+ ];
159
+ await ytdlp(run, subArgs, undefined, quick);
160
+ const file = findFile(work, 'sub.', ['.vtt', '.srt']);
161
+ const cues = file ? captionsToSentences(readFileSync(file, 'utf-8')) : [];
162
+ if (cues.length > 0) {
163
+ return {
164
+ slug,
165
+ meta: { ...base, lang: pick.lang, captionSource: pick.kind },
166
+ cues,
167
+ track: pick.key,
168
+ };
169
+ }
170
+ }
171
+ const model = opts.whisperModel ?? DEFAULT_WHISPER_MODEL;
172
+ await ytdlp(run, ['-f', 'bestaudio/best', '-o', join(work, 'audio.%(ext)s'), watchUrl], undefined, { cwd: work, timeoutMs: timeoutFor(base.durationSec, 1) });
173
+ const audio = findFile(work, 'audio.', ['.m4a', '.webm', '.mp4', '.opus', '.mp3', '.ogg']);
174
+ if (!audio)
175
+ throw new Error('오디오를 받지 못했어요.');
176
+ const w = await transcribeWithWhisper(run, work, audio, model, base.durationSec, opts.lang ?? meta.language ?? undefined);
177
+ return {
178
+ slug,
179
+ meta: { ...base, lang: w.lang, captionSource: 'whisper' },
180
+ cues: mergeSentences(cuesToWords(w.cues)),
181
+ track: model,
182
+ };
183
+ }
184
+ async function collectFile(file, opts, run, work) {
185
+ const stem = basename(file, extname(file));
186
+ const durationSec = await probeDuration(run, work, file);
187
+ // 다른 폴더의 같은 이름 영상과 섞이지 않게 경로 해시를 slug 끝에 붙인다
188
+ const hash = createHash('sha1').update(file).digest('hex').slice(0, 8);
189
+ const slug = opts.slug ?? slugFromMeta(hash, stem);
190
+ const base = {
191
+ source: 'file',
192
+ url: pathToFileURL(file).href,
193
+ title: stem,
194
+ durationSec: round2(durationSec),
195
+ };
196
+ const sidecar = opts.whisper ? null : findFile(dirname(file), `${stem}.`, ['.vtt', '.srt']);
197
+ if (sidecar) {
198
+ const cues = captionsToSentences(readFileSync(sidecar, 'utf-8'));
199
+ if (cues.length > 0) {
200
+ return {
201
+ slug,
202
+ meta: { ...base, lang: opts.lang ?? 'und', captionSource: 'manual' },
203
+ cues,
204
+ track: basename(sidecar),
205
+ };
206
+ }
207
+ }
208
+ const model = opts.whisperModel ?? DEFAULT_WHISPER_MODEL;
209
+ const w = await transcribeWithWhisper(run, work, file, model, base.durationSec, opts.lang);
210
+ return {
211
+ slug,
212
+ meta: { ...base, lang: w.lang, captionSource: 'whisper' },
213
+ cues: mergeSentences(cuesToWords(w.cues)),
214
+ track: model,
215
+ };
216
+ }
217
+ const sameSegments = (a, b) => a.length === b.length &&
218
+ a.every((s, i) => s.startSec === b[i].startSec && s.text === b[i].text);
219
+ /**
220
+ * 문장이 바뀌었는데 digest.json을 두면 cite가 옛 번호로 엉뚱한 장면을 가리킨다.
221
+ * 지우지 않고 옮겨 두면 다음 validate가 DIGEST_NOT_FOUND로 요약을 새로 쓰게 이끈다
222
+ */
223
+ function moveStaleDigest(store, next) {
224
+ const digestPath = store.digestPath(next.slug);
225
+ if (!existsSync(digestPath))
226
+ return undefined;
227
+ const prev = store.readTranscript(next.slug);
228
+ if (prev.ok && sameSegments(prev.transcript.segments, next.segments))
229
+ return undefined;
230
+ const stamp = new Date().toISOString().replace(/[:.]/g, '-');
231
+ const movedTo = join(store.dir(next.slug), `digest.stale-${stamp}.json`);
232
+ renameSync(digestPath, movedTo);
233
+ return { movedTo, previousSegmentCount: prev.ok ? prev.transcript.segments.length : null };
234
+ }
235
+ function restoreStaleDigest(store, slug, movedTo, cause) {
236
+ let why;
237
+ try {
238
+ renameSync(movedTo, store.digestPath(slug));
239
+ return;
240
+ }
241
+ catch (restoreErr) {
242
+ why = restoreErr instanceof Error ? restoreErr.message : String(restoreErr);
243
+ }
244
+ // catch 밖에서 던져야 cause에 되돌리기 오류가 아닌 저장 오류를 둘 수 있다.
245
+ // CLI는 message만 찍어서 저장이 왜 실패했는지와 digest가 어디 남았는지, 왜 못 되돌렸는지를 message에 다 넣는다
246
+ const reason = cause instanceof Error ? cause.message : String(cause);
247
+ throw new Error(`${reason} (옮겨 둔 digest.json을 되돌리지 못해 ${movedTo}에 남아 있어요: ${why})`, { cause });
248
+ }
249
+ /**
250
+ * 유튜브 주소나 로컬 영상 파일에서 문장 단위 스크립트를 만들어 transcript.json으로 저장한다.
251
+ * 자막 순서는 수동 자막 → 자동 자막(문장 병합) → faster-whisper다.
252
+ */
253
+ export async function ingest(input, opts) {
254
+ const run = opts.run ?? runCommand;
255
+ if (opts.slug !== undefined && !isValidSlug(opts.slug)) {
256
+ throw new Error(`slug는 소문자, 숫자, 하이픈만 쓸 수 있어요: ${opts.slug}`);
257
+ }
258
+ const videoId = parseYoutubeId(input);
259
+ const filePath = videoId ? null : resolve(input);
260
+ if (!videoId && !(filePath && existsSync(filePath) && statSync(filePath).isFile())) {
261
+ throw new Error(`유튜브 주소도 아니고 파일도 찾지 못했어요: ${input}`);
262
+ }
263
+ const work = mkdtempSync(join(tmpdir(), 'gestalt-digest-'));
264
+ try {
265
+ const c = videoId
266
+ ? await collectYoutube(videoId, opts, run, work)
267
+ : await collectFile(filePath, opts, run, work);
268
+ if (c.cues.length === 0)
269
+ throw new Error('스크립트 문장이 하나도 안 나왔어요.');
270
+ const transcript = {
271
+ schemaVersion: TRANSCRIPT_SCHEMA_VERSION,
272
+ slug: c.slug,
273
+ meta: c.meta,
274
+ segments: toSegments(c.cues),
275
+ };
276
+ const store = new DigestStore(opts.repoRoot);
277
+ const staleDigest = moveStaleDigest(store, transcript);
278
+ let transcriptPath;
279
+ try {
280
+ transcriptPath = store.saveTranscript(transcript);
281
+ }
282
+ catch (e) {
283
+ // 저장 뒤에 옮기면 rename 실패 때 새 transcript 옆에 옛 digest가 남는다. 옮긴 걸 되돌려 옛 짝을 지킨다
284
+ if (staleDigest)
285
+ restoreStaleDigest(store, c.slug, staleDigest.movedTo, e);
286
+ throw e;
287
+ }
288
+ return {
289
+ slug: c.slug,
290
+ transcriptPath,
291
+ title: c.meta.title,
292
+ durationSec: c.meta.durationSec,
293
+ captionSource: c.meta.captionSource,
294
+ captionTrack: c.track,
295
+ segmentCount: transcript.segments.length,
296
+ ...(staleDigest ? { staleDigest } : {}),
297
+ };
298
+ }
299
+ finally {
300
+ rmSync(work, { recursive: true, force: true });
301
+ }
302
+ }
303
+ //# sourceMappingURL=ingest.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ingest.js","sourceRoot":"","sources":["../../../src/digest/ingest.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,71 @@
1
+ import { type Block, type Extension, type MindmapNode } from './blocks.js';
2
+ import type { DigestIssue } from './lint.js';
3
+ import { type Cite, type Diagram, type Transcript } from './schema.js';
4
+ import type { DigestTemplate } from './templates.js';
5
+ /**
6
+ * 확장 리포트의 문자열 한 칸.
7
+ * title은 탭과 소제목처럼 이름으로 쓰여 본문 윤문에서 빠진다. 그림 안 글자는 prose.ts가 라벨로 따로 모은다. verbatim은 대사나 댓글 원문이라 손대지 않는다
8
+ */
9
+ export interface ExtensionText {
10
+ path: string;
11
+ text: string;
12
+ role: 'title' | 'body' | 'verbatim';
13
+ }
14
+ export interface ExtensionCite {
15
+ path: string;
16
+ cite: Cite;
17
+ }
18
+ export interface ExtensionLintOptions {
19
+ /** 아는 템플릿. 있으면 템플릿에 없는 블록 타입과 모르는 템플릿을 경고한다 */
20
+ templates?: ReadonlyMap<string, Pick<DigestTemplate, 'id' | 'blocks'>>;
21
+ /**
22
+ * comments.json의 id → 본문. 있으면 댓글 예시를 대조한다.
23
+ * null은 찾아봤는데 없다는 뜻이라 댓글 블록이 있으면 오류다. 안 주면 대조를 건너뛴다
24
+ */
25
+ comments?: ReadonlyMap<string, string> | null;
26
+ /** 댓글 본문 불일치를 오류로 올린다. 저장을 막아야 하는 merge만 켠다 */
27
+ strictVerbatim?: boolean;
28
+ }
29
+ /** 마인드맵 상한. 루트가 0단이다. 이보다 크면 한 화면에 안 들어온다 */
30
+ export declare const MINDMAP_MAX_DEPTH = 3;
31
+ export declare const MINDMAP_MAX_NODES = 60;
32
+ export declare function walkMindmap(node: MindmapNode, path: string, depth?: number): Generator<{
33
+ node: MindmapNode;
34
+ path: string;
35
+ depth: number;
36
+ }>;
37
+ /** 도식에서 라벨 칸을 경로와 함께 돈다. 열 제목과 축 이름, 시점 글자는 출처가 없어서 cite도 없다 */
38
+ export declare function walkDiagram(d: Diagram, prefix: string): Generator<{
39
+ label: string;
40
+ cite?: Cite;
41
+ path: string;
42
+ labelPath: string;
43
+ }>;
44
+ /** 블록 하나에서 글자와 출처를 경로와 함께 뽑는다. lint와 윤문이 같은 경로를 쓴다 */
45
+ export declare function blockFields(block: Block, p: string): {
46
+ texts: ExtensionText[];
47
+ cites: ExtensionCite[];
48
+ };
49
+ export declare function extensionFields(ext: Extension, p: string): {
50
+ texts: ExtensionText[];
51
+ cites: ExtensionCite[];
52
+ };
53
+ export interface TreeLimit {
54
+ maxNodes: number;
55
+ depthCode: string;
56
+ sizeCode: string;
57
+ /** 메시지에 쓰는 이름. topic은 조사까지 붙인 꼴이다 (마인드맵은, 도식 트리는) */
58
+ name: string;
59
+ topic: string;
60
+ }
61
+ /** 마인드맵과 대섹션 도식 트리가 같은 깊이 규칙을 쓴다. 노드 상한과 코드만 다르다 */
62
+ export declare function checkTree(root: MindmapNode, rootPath: string, limit: TreeLimit, issues: DigestIssue[]): void;
63
+ /** 대섹션 도식의 트리는 마인드맵보다 작게 둔다. 본문 사이에 끼는 그림이라서다 */
64
+ export declare const DIAGRAM_TREE_MAX_NODES = 30;
65
+ /**
66
+ * 스키마로는 못 잡는 도식 모양을 본다. 트리 깊이와 크기, 상자 하나만 남는 인과도와 빈 매트릭스다.
67
+ * 확장 리포트의 figure 블록도 같은 검사를 쓴다
68
+ */
69
+ export declare function checkDiagramShape(d: Diagram, dp: string, issues: DigestIssue[]): void;
70
+ export declare function lintExtensions(extensions: Extension[], transcript: Transcript, issues: DigestIssue[], opts?: ExtensionLintOptions): void;
71
+ //# sourceMappingURL=lint-extension.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lint-extension.d.ts","sourceRoot":"","sources":["../../../src/digest/lint-extension.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,KAAK,EACV,KAAK,SAAS,EAEd,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAA+B,KAAK,IAAI,EAAE,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACpG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;CACrC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,SAAS,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC;IACvE;;;OAGG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC9C,+CAA+C;IAC/C,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,6CAA6C;AAC7C,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAcpC,wBAAiB,WAAW,CAC1B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,SAAI,GACR,SAAS,CAAC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAK/D;AAED,gEAAgE;AAChE,wBAAiB,WAAW,CAC1B,CAAC,EAAE,OAAO,EACV,MAAM,EAAE,MAAM,GACb,SAAS,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CA0D5E;AAED,sDAAsD;AACtD,wBAAgB,WAAW,CACzB,KAAK,EAAE,KAAK,EACZ,CAAC,EAAE,MAAM,GACR;IAAE,KAAK,EAAE,aAAa,EAAE,CAAC;IAAC,KAAK,EAAE,aAAa,EAAE,CAAA;CAAE,CA6GpD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM;;;EASxD;AAsHD,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,oDAAoD;AACpD,wBAAgB,SAAS,CACvB,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,WAAW,EAAE,GACpB,IAAI,CAqBN;AAED,iDAAiD;AACjD,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAUzC;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAmBrF;AAkHD,wBAAgB,cAAc,CAC5B,UAAU,EAAE,SAAS,EAAE,EACvB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,WAAW,EAAE,EACrB,IAAI,GAAE,oBAAyB,GAC9B,IAAI,CA2BN"}