kasaframe 0.0.0-stage → 0.1.3

package/packages/cli/src/commands/doctor.ts

@@ -0,0 +1,30 @@
+import { capabilities } from "@kasaframe/gen";
+import { readFileSync } from "node:fs";
+import { arch, platform } from "node:os";
+import { join } from "node:path";
+import type { Command } from "../command.ts";
+import { checks, pad, report } from "../deps.ts";
+import { repoRoot } from "../serve.ts";
+
+const cmd: Command = {
+  summary: "바깥 도구 점검 — ffmpeg·크롬(Playwright)·python3+librosa·OG 키, 없으면 까는 명령",
+  usage: `kf doctor
+  없음 은 렌더가 안 되는 것, 선택 은 그 기능만 빠지는 것. 크롬·librosa 는 kf setup 이 깐다. 종료 코드: 없음 이 있으면 1`,
+  async run() {
+    const version = JSON.parse(readFileSync(join(repoRoot, "package.json"), "utf8")).version ?? "?";
+    console.log(`kasaframe ${version} · Node ${process.version} · ${platform()} ${arch()}\n`);
+    const list = await checks();
+    report(list);
+    const missing = list.filter((c) => c.required && !c.ok);
+    console.log("\n생성 능력(kf make 가 쓰는 것 — 없으면 kf make 가 만들기 전에 묻는다. 키는 값 없이 유무만)");
+    for (const c of await capabilities({ probe: true })) {
+      const ok = c.providers.filter((p) => p.ready);
+      console.log(`  ${pad(ok.length ? "ok" : "없음", 4)}  ${pad(c.label, 30)}${c.best ? `권장 ${c.best.id}${c.best.unitUsd ? ` $${c.best.unitUsd.toFixed(3)}/${c.best.unit}` : " 0원"}` : "쓸 수 있는 것 없음"}${ok.length > 1 ? ` · 그 밖 ${ok.filter((p) => p !== c.best).map((p) => p.id).join(" ")}` : ""}`);
+      for (const p of c.providers.filter((x) => !x.ready && x.fix)) console.log(`  ${pad("", 36)}${p.id}: ${p.detail} → ${p.fix}`);
+      for (const p of ok.filter((x) => x.restrict)) console.log(`  ${pad("", 36)}${p.id} 제한: ${p.restrict}`);
+    }
+    console.log(missing.length ? `\n렌더에 필요한 것이 ${missing.length}개 없다 — 위 → 대로 깔고 다시 kf doctor` : "\n렌더 준비 됨 — kf new <폴더> --template shorts 부터");
+    return missing.length ? 1 : 0;
+  },
+};
+export default cmd;

package/packages/cli/src/commands/gen.ts

@@ -0,0 +1,173 @@
+import { join, resolve } from "node:path";
+import {
+  DEFAULT_MAX_USD,
+  estimateImageUsd,
+  genImage,
+  genVideo,
+  hasKey,
+  imageProviders,
+  NeedsApproval,
+  planVideo,
+  resolvePlan,
+  seam,
+  videoProviders,
+  whereToPut,
+  type Asset,
+  type GenContext,
+} from "@kasaframe/gen";
+import type { Command } from "../command.ts";
+import { num, parseFlags } from "../command.ts";
+
+const USAGE = `kf gen models
+kf gen img "<프롬프트>" --id <이름> [--size 1920x1080] [--transparent] [--ref a.png,b.png] [--quality high] [--provider og-gpt-image-2.5-sunburst]
+kf gen vid "<프롬프트>" --id <이름> [--first a.png] [--last b.png] [--dur 5] [--aspect 16:9] [--provider wan-2.2-turbo] [--max-usd 1] [--yes]
+kf gen seam <폴더> <이음매 장면 id> "<프롬프트>" [--provider ...] [--first a.png] [--last b.png] [--smooth] [--yes]
+kf gen plan <폴더> [--yes]
+
+공통: --project <폴더>(결과는 <폴더>/assets/gen) · --out <폴더> · --max-usd <영상 하나 상한, 기본 ${DEFAULT_MAX_USD}>
+영상은 --yes 가 없으면 견적만 내고 종료 코드 3. 같은 입력은 캐시(~/.cache/kasaframe/gen)에서 꺼내 돈이 안 든다.`;
+
+function usage(): number {
+  console.error(USAGE);
+  return 2;
+}
+
+function ctxOf(opts: Record<string, string | boolean | undefined>, outDir: string): GenContext {
+  return {
+    outDir,
+    maxUsd: num(opts["max-usd"], DEFAULT_MAX_USD),
+    approve: opts.yes === true,
+    log: (l) => console.error(l),
+  };
+}
+
+function outDirOf(opts: Record<string, string | boolean | undefined>): string {
+  if (typeof opts.out === "string") return resolve(opts.out);
+  if (typeof opts.project === "string") return join(resolve(opts.project), "assets", "gen");
+  return resolve("assets/gen");
+}
+
+function report(a: Asset): void {
+  const m = a.meta;
+  const cost = a.cached ? "캐시(0)" : `$${m.costUsd.toFixed(4)}${m.costEstimated ? "(단가표)" : ""}`;
+  const size = m.duration ? `${m.width}x${m.height} ${m.duration.toFixed(2)}초` : `${m.width}x${m.height}`;
+  console.log(`${a.path}\n  ${m.provider} · ${size} · ${cost} · ${(m.elapsedMs / 1000).toFixed(1)}초${m.notes?.length ? ` · ${m.notes.join(" ")}` : ""}`);
+}
+
+function models(): number {
+  const sample = { prompt: "", duration: 5, aspect: "16:9", firstFrame: "x", lastFrame: "y", resolution: "720p" };
+  console.log("그림");
+  for (const p of imageProviders()) {
+    const est = estimateImageUsd({ prompt: "", size: "1920x1080", quality: "high" });
+    console.log(`  ${p.id.padEnd(30)} 1920x1080 high 최대 $${est.toFixed(3)}  키 ${hasKey(p.keyName) ? "있음" : `없음 — ${whereToPut(p.keyName)}`}`);
+  }
+  console.log("\n영상 (5초 720p 끝 프레임 포함 견적)");
+  for (const p of videoProviders()) {
+    const key = hasKey(p.keyName) ? "있음" : `없음 — ${whereToPut(p.keyName)}`;
+    console.log(`  ${p.id.padEnd(30)} $${p.estimateUsd(sample).toFixed(3).padEnd(6)} 길이 ${p.durations[0]}–${p.durations[p.durations.length - 1]}초  키 ${key}`);
+    console.log(`  ${"".padEnd(30)} ${p.license} · ${p.region}`);
+  }
+  return 0;
+}
+
+async function guarded(f: () => Promise<number>): Promise<number> {
+  try {
+    return await f();
+  } catch (e) {
+    if (e instanceof NeedsApproval) {
+      console.error(`승인 필요: ${e.message}\n  돈을 쓰려면 같은 명령에 --yes (상한은 --max-usd)`);
+      return 3;
+    }
+    throw e;
+  }
+}
+
+const cmd: Command = {
+  summary: "그림·영상 생성(OG gpt-image · fal Wan/Kling · MiniMax · Veo · LTX) — 캐시·예산·이음매 전환",
+  usage: USAGE,
+  async run(argv) {
+    const [sub, ...rest] = argv;
+    const { args, opts } = parseFlags(rest);
+    if (sub === "models") return models();
+
+    if (sub === "img") {
+      const prompt = args[0];
+      if (!prompt || typeof opts.id !== "string") return usage();
+      return guarded(async () => {
+        const refs = typeof opts.ref === "string" ? opts.ref.split(",").map((r) => resolve(r)) : undefined;
+        const a = await genImage(
+          opts.id as string,
+          { prompt, size: typeof opts.size === "string" ? opts.size : "1920x1080", transparent: opts.transparent === true, refs, quality: opts.quality as string | undefined },
+          ctxOf(opts, outDirOf(opts)),
+          opts.provider as string | undefined,
+        );
+        report(a);
+        return 0;
+      });
+    }
+
+    if (sub === "vid") {
+      const prompt = args[0];
+      if (!prompt || typeof opts.id !== "string") return usage();
+      return guarded(async () => {
+        const req = {
+          prompt,
+          firstFrame: typeof opts.first === "string" ? resolve(opts.first) : undefined,
+          lastFrame: typeof opts.last === "string" ? resolve(opts.last) : undefined,
+          duration: num(opts.dur, 5),
+          aspect: typeof opts.aspect === "string" ? opts.aspect : "16:9",
+          resolution: opts.resolution as string | undefined,
+          seed: typeof opts.seed === "string" ? Number(opts.seed) : undefined,
+        };
+        const ctx = ctxOf(opts, outDirOf(opts));
+        const plan = planVideo(req, ctx, opts.provider as string | undefined);
+        console.error(`${plan.provider.id} 견적 $${plan.estimateUsd.toFixed(3)}${plan.cached ? " (캐시 있음 — 0원)" : ""}`);
+        report(await genVideo(opts.id as string, req, ctx, opts.provider as string | undefined));
+        return 0;
+      });
+    }
+
+    if (sub === "seam") {
+      const [project, scene, prompt] = args;
+      if (!project || !scene || !prompt) return usage();
+      return guarded(async () => {
+        const a = await seam(
+          {
+            project,
+            scene,
+            prompt,
+            provider: opts.provider as string | undefined,
+            first: typeof opts.first === "string" ? resolve(opts.first) : undefined,
+            last: typeof opts.last === "string" ? resolve(opts.last) : undefined,
+            smooth: opts.smooth === true,
+            resolution: opts.resolution as string | undefined,
+          },
+          ctxOf(opts, join(resolve(project), "assets", "gen")),
+        );
+        report(a);
+        return 0;
+      });
+    }
+
+    if (sub === "plan") {
+      const project = args[0];
+      if (!project) return usage();
+      const { outDir: _, ...ctx } = ctxOf(opts, "");
+      const reports = await resolvePlan(project, ctx);
+      let spent = 0;
+      let waiting = 0;
+      for (const r of reports) {
+        spent += r.costUsd ?? 0;
+        if (r.status === "needs-approval") waiting += r.estimateUsd ?? 0;
+        const tail = r.status === "made" || r.status === "cached" ? r.path : r.error;
+        console.log(`${r.status.padEnd(15)} ${r.kind} ${r.id.padEnd(20)} ${tail ?? ""}`);
+      }
+      console.log(`\n쓴 돈 $${spent.toFixed(4)}${waiting ? ` · 승인 기다리는 영상 견적 $${waiting.toFixed(3)} (--yes)` : ""}`);
+      if (reports.some((r) => r.status === "error")) return 1;
+      return reports.some((r) => r.status === "needs-approval") ? 3 : 0;
+    }
+
+    return usage();
+  },
+};
+export default cmd;

package/packages/cli/src/commands/look.ts

@@ -0,0 +1,46 @@
+import { writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { DEFAULT_EYES, formatLook, look, lookSheet, premiumBlock } from "@kasaframe/plan";
+import { type Command, parseFlags } from "../command.ts";
+
+const cmd: Command = {
+  summary: "세션이 직접 볼 것 — 장면 모음 한 장과 장면별 확인표의 경로(외부 모델 0). 눈 없는 세션은 --vision-model",
+  usage: `kf look <폴더 | 영상.mp4> [--vision-model ${DEFAULT_EYES} [--ask "<볼 것>"]] [--json]
+
+  기본: 장면 모음(kf sheet — 장면마다 가운데 한 장, 4열)과 장면별 확인표(look.md)를 만들고 경로를 찍는다.
+  세션이 그림을 Read 로 직접 보고 확인표를 따라 고친다. 외부 모델을 부르지 않는다(돈 0). 폴더면 out/, mp4 면 옆에 둔다.
+  정지 그림이라 0.1초 멈춤·박·섬광·카메라 이동은 kf check 가 본다.
+
+  --vision-model  그림을 못 보는 세션(Claude Code 를 OG 로 딥시크 같은 모델에 붙이면 OG /v1/messages 가 그림을 버린다)용.
+                  그 모델이 OG chat/completions 로 장면 모음을 보고 장면별 글 보고(한 번에 1센트 안팎) — JSON 은 out/look.json,
+                  문제 장면이 있으면 종료 코드 1
+  --ask           --vision-model 에게 따로 물을 것
+  --allow-premium Opus·GPT 계열 모델을 푼다(KF_ALLOW_PREMIUM=1 과 같다) — 없으면 부르기 전에 막는다`,
+  async run(argv) {
+    const { args, opts } = parseFlags(argv);
+    if (!args[0]) {
+      console.error("kf look: 폴더나 mp4 를 준다 — kf look --help");
+      return 2;
+    }
+    const target = resolve(args[0]);
+    const model = typeof opts["vision-model"] === "string" ? opts["vision-model"] : undefined;
+    if (!model) {
+      if (typeof opts.ask === "string") console.error("kf look: --ask 는 --vision-model 과 함께 쓴다 — 기본은 세션이 직접 본다");
+      const s = lookSheet(target);
+      console.log(opts.json ? JSON.stringify(s, null, 2) : `장면 모음: ${s.sheet}\n확인표:   ${s.checklist}\n— 장면 ${s.scenes}개. 그림을 Read 로 직접 보고 확인표대로 고친다`);
+      return 0;
+    }
+    if (opts["allow-premium"]) process.env.KF_ALLOW_PREMIUM = "1";
+    const why = premiumBlock(model);
+    if (why) {
+      console.error(`kf look: ${why}`);
+      return 2;
+    }
+    const r = await look(target, { ask: typeof opts.ask === "string" ? opts.ask : undefined, model });
+    const out = /\.(mp4|mov|webm|m4v)$/i.test(target) ? join(dirname(target), "look.json") : join(target, "out", "look.json");
+    writeFileSync(out, `${JSON.stringify(r, null, 2)}\n`);
+    console.log(opts.json ? JSON.stringify(r, null, 2) : formatLook(r));
+    return r.scenes.some((s) => !s.ok) ? 1 : 0;
+  },
+};
+export default cmd;

package/packages/cli/src/commands/lyrics.ts

@@ -0,0 +1,157 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { type Question, WAIT } from "@kasaframe/gen";
+import { install, type Missing } from "@kasaframe/jizura/install";
+import { parseLyrics, toLrc } from "@kasaframe/jizura/lyrics";
+import { type Command, num, parseFlags } from "../command.ts";
+import { pyVenv, venvPython } from "../deps.ts";
+
+const tools = fileURLToPath(new URL("../../../../tools/lyrics/", import.meta.url));
+const script = join(tools, "align.py");
+const requirements = join(tools, "requirements.txt");
+// torch·demucs 가 무거워(2GB 안팎) beats 의 librosa venv 와 따로 둔다
+const venv = () => pyVenv("lyrics");
+const python = () => process.env.KF_LYRICS_PYTHON ?? venvPython(venv());
+
+/** kf doctor 한 줄 */
+export function lyricsCheck() {
+  const py = python();
+  const r = existsSync(py) || process.env.KF_LYRICS_PYTHON ? spawnSync(py, ["-c", "import demucs, stable_whisper; print(stable_whisper.__version__)"], { encoding: "utf8" }) : null;
+  const ok = r?.status === 0;
+  return {
+    name: "가사 정렬(demucs+stable-ts)",
+    ok,
+    required: false,
+    detail: ok ? `${py} · stable-ts ${r!.stdout.trim()}` : "없음 — kf lyrics align(공식 가사에 시각 붙이기)만 못 쓴다",
+    fix: ok ? undefined : "kf setup lyrics  (torch·demucs·whisper 2GB 안팎, 첫 정렬 때 whisper 모델 1.6GB 를 더 받는다)",
+  };
+}
+
+const which = (cmd: string) => spawnSync(cmd, ["--version"], { stdio: "ignore" }).status === 0;
+
+/** kf setup lyrics — uv 가 있으면 uv 로(빠르고 파이썬 3.12 를 스스로 받는다), 없으면 python3.12·3.11 venv + pip */
+export function setupLyrics(): boolean {
+  const dir = venv();
+  const step = (cmd: string, args: string[]) => {
+    console.log(`\n가사 정렬: ${cmd} ${args.join(" ")}`);
+    return spawnSync(cmd, args, { stdio: "inherit" }).status === 0;
+  };
+  if (which("uv")) {
+    return (existsSync(venvPython(dir)) || step("uv", ["venv", "--python", "3.12", dir])) && step("uv", ["pip", "install", "--python", venvPython(dir), "-r", requirements]);
+  }
+  const py = ["python3.12", "python3.11"].find(which);
+  if (!py) {
+    console.error("가사 정렬: python3.12(또는 3.11)이 없다 — torch 가 3.13 이하에서 선다. uv 를 깔면(https://docs.astral.sh/uv) 파이썬까지 알아서 받는다");
+    return false;
+  }
+  return (existsSync(venvPython(dir)) || step(py, ["-m", "venv", dir])) && step(venvPython(dir), ["-m", "pip", "install", "-r", requirements]);
+}
+
+/** 가사 층이 처음 쓰는 글꼴을 못 받았을 때 — 다른 글꼴로 대신 그리지 않고 묻는다. 답은 kf lyrics use 가 kf.json 에 적는다 */
+export function fontsQuestion(missing: Missing[]): Question {
+  const stand = missing.every((m) => m.stand);
+  return {
+    id: "lyrics", cap: "lyrics", header: "가사 글꼴", flag: `kf lyrics use ${missing[0].project ?? "<폴더>"}`, missing: true, default: WAIT, skip: "words",
+    ask: `가사 층이 처음 쓰는 글꼴 ${missing.map((m) => m.family).join("·")} 을 못 받았다(${missing[0].reason}) — 다른 글꼴로 대신 그리지 않고 멈췄다`,
+    choices: [
+      { value: WAIT, label: "받고 다시", note: "지금 다시 받아 본다(kf setup jizura 와 같다 — 막힌 망이면 KF_JIZURA_FONTS_URL 에 google/fonts 거울) → 같은 명령을 다시" },
+      ...(stand ? [{ value: "builtin", label: "내장 글꼴로", note: `${missing.map((m) => `${m.family} → ${m.stand}`).join(", ")} — 플랜·컷은 그대로, 글자 모양만 바뀐다` }] : []),
+      { value: "words", label: "가사 층 없이 낱말로", note: "JIZURA 레이아웃·효과 없이 부른 낱말을 DOM 글로" },
+    ],
+  };
+}
+
+// kf.json "lyrics" — 가사 층이 읽는다(layer.ts lyricsMode). wait 는 지금 받아 보고 되면 원래대로(jizura)
+async function use(dir: string | undefined, value: string | undefined): Promise<number> {
+  const kfPath = dir ? join(resolve(dir), "kf.json") : "";
+  if (!dir || !existsSync(kfPath) || !value || ![WAIT, "jizura", "builtin", "words"].includes(value)) {
+    console.error("kf lyrics use <폴더> wait|builtin|words|jizura");
+    return 2;
+  }
+  if (value === WAIT) {
+    const lyricsPath = join(resolve(dir), "lyrics.json");
+    const lang = existsSync(lyricsPath) && JSON.parse(readFileSync(lyricsPath, "utf8")).lang === "ja" ? "ja" : "ko";
+    try {
+      await install([lang]);
+    } catch (err) {
+      console.error(`kf lyrics use: 아직 못 받는다 — ${err instanceof Error ? err.message : err}`);
+      return 1;
+    }
+    value = "jizura";
+  }
+  const kf = JSON.parse(readFileSync(kfPath, "utf8"));
+  if (value === "jizura") delete kf.lyrics;
+  else kf.lyrics = value;
+  writeFileSync(kfPath, `${JSON.stringify(kf, null, 2)}\n`);
+  console.log(`${kfPath} lyrics: ${value} — 같은 명령을 다시`);
+  return 0;
+}
+
+function writeLrc(json: string, lrcPath: string): void {
+  const lyrics = parseLyrics(JSON.parse(readFileSync(json, "utf8")));
+  writeFileSync(lrcPath, toLrc(lyrics));
+}
+
+const cmd: Command = {
+  summary: "가사 — 공식 가사에 줄·어절 시각을 붙여 lyrics.json + LRC (보컬 분리 + whisper 강제 정렬)",
+  usage: `kf lyrics align <곡> --text 공식가사.txt [--lang ko|ja] [--out lyrics.json] [--from 초 --duration 초] [--model large-v3-turbo] [--vocals]
+kf lyrics lrc <lyrics.json> [--out x.lrc]
+kf lyrics use <폴더> wait|builtin|words|jizura
+
+  align  글자는 공식 가사(한 줄 = 가사 한 줄)가 정본이고 시각만 붙인다. 곡의 일부만 쓰면 --from·--duration(시각은 --from 을 0 으로 —
+         beats.json 과 같다). 보컬만 있는 소리면 --vocals(분리를 건너뛴다). 옆에 같은 이름 .lrc 도 쓴다(2.5초 넘는 빈 자리는 [間奏]).
+         MMS 강제 정렬은 가중치가 비상업(CC-BY-NC)이라 쓰지 않는다. 깔기: kf setup lyrics (KF_LYRICS_PYTHON 으로 바꿀 수 있다)
+         모델·장치: --model(기본 large-v3-turbo) · WHISPER_DEVICE(기본 cpu — mps 는 정렬에서 깨질 때가 있다)
+  lrc    lyrics.json → LRC(JIZURA·노래방 형식)
+  use    가사 층 글꼴을 처음 쓰다 못 받았을 때 고른 답을 kf.json 에 — wait(지금 다시 받기) · builtin(못 받은 얼굴을 내장 글꼴로)
+         · words(가사 층 없이 낱말로) · jizura(원래대로). 페이지 주소 ?lyrics= 가 그 판만 덮는다`,
+  async run(argv) {
+    const { args, opts } = parseFlags(argv);
+    const [sub, input] = args;
+    if (sub === "use") return use(input, args[2]);
+    if (sub === "lrc") {
+      if (!input || !existsSync(input)) {
+        console.error("kf lyrics lrc: lyrics.json 경로가 필요하다");
+        return 2;
+      }
+      const out = typeof opts.out === "string" ? opts.out : input.replace(/\.json$/, "") + ".lrc";
+      writeLrc(input, out);
+      console.log(out);
+      return 0;
+    }
+    if (sub !== "align") {
+      console.error("kf lyrics: align 또는 lrc. kf lyrics --help");
+      return 2;
+    }
+    if (!input || !existsSync(input)) {
+      console.error(`kf lyrics align: 곡이 없다: ${input ?? "(안 줌)"}`);
+      return 2;
+    }
+    if (typeof opts.text !== "string" || !existsSync(opts.text)) {
+      console.error("kf lyrics align: --text 공식가사.txt 가 필요하다(한 줄 = 가사 한 줄)");
+      return 2;
+    }
+    const lang = typeof opts.lang === "string" ? opts.lang : "ko";
+    const out = resolve(typeof opts.out === "string" ? opts.out : "lyrics.json");
+    const check = lyricsCheck();
+    if (!check.ok) {
+      console.error(`kf lyrics align: ${check.detail}\n  → ${check.fix}`);
+      return 1;
+    }
+    const pyArgs = [script, "--audio", resolve(input), "--text", resolve(opts.text), "--lang", lang, "--out", out];
+    if (opts.from !== undefined) pyArgs.push("--from", String(num(opts.from, 0)));
+    if (opts.duration !== undefined) pyArgs.push("--duration", String(num(opts.duration, 0)));
+    if (typeof opts.model === "string") pyArgs.push("--model", opts.model);
+    if (opts.vocals) pyArgs.push("--no-separate");
+    const r = spawnSync(python(), pyArgs, { stdio: "inherit", cwd: dirname(out) });
+    if (r.status !== 0) return r.status ?? 1;
+    const lrc = out.replace(/\.json$/, "") + ".lrc";
+    writeLrc(out, lrc);
+    console.log(out);
+    console.log(lrc);
+    return 0;
+  },
+};
+export default cmd;