kasaframe 0.0.0-stage → 0.1.1

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,39 @@
+import { writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { DEFAULT_EYES, formatLook, look, lookSheet } 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 에게 따로 물을 것`,
+  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;
+    }
+    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,111 @@
+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 { 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]);
+}
+
+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]
+
+  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·노래방 형식)`,
+  async run(argv) {
+    const { args, opts } = parseFlags(argv);
+    const [sub, input] = args;
+    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;