aimakeall-mcp 0.8.0 → 0.9.1

package/README.md

@@ -16,7 +16,7 @@ Claude Code·Codex 같은 MCP 클라이언트에서 자연어로 AImakeAll 영
   "mcpServers": {
     "aimakeall": {
       "command": "npx",
-      "args": ["-y", "aimakeall-mcp@0.8.0"],
+      "args": ["-y", "aimakeall-mcp@0.9.1"],
       "env": { "AIMAKEALL_PAT": "aio_pat_..." }
     }
   }

package/lib/cloud-tools.mjs

@@ -23,16 +23,15 @@ import {
 import { mp3DurationSec } from "./mp3-duration.mjs";
 import { canonicalYoutubeWatchUrl } from "./payload-guard.mjs";
 import { createUsageEventId } from "./usage-event.mjs";
+import { loudnessDbfsFromWav, silenceRatioFromWav } from "./wav-dsp.mjs";
 import { trimWavToSeconds } from "./wav-trim.mjs";
 
 // 여러 파일을 base64 로 싣는 요청의 인코딩 크기 합이 서버 JSON 상한을 넘지 않게 사전 검사.
 // 서버가 전체 업로드를 받은 뒤 413 을 내는 것을 막고 행동 가능한 한국어 안내를 준다.
 const BODY_BUDGET_BYTES = SERVER_JSON_BODY_LIMIT_BYTES - 512 * 1024; // 바디의 나머지 필드 여유
 
-// 컴패니언 계약 상수 — companion/index.cjs 의 MAX_SHOT_COUNT 및 오디오 추출 포맷과 맞춘다.
-// 오디오는 extractCompanionAudio 기본값(16kHz)·16bit·모노 = 초당 32,000 바이트.
+// 컴패니언 계약 상수 — companion/index.cjs 의 MAX_SHOT_COUNT 와 맞춘다.
 const COMPANION_MAX_SHOTS = 18;
-const COMPANION_AUDIO_BYTES_PER_SECOND = 16_000 * 2;
 
 function assertEncodedBudget(filePaths, { context = "요청" } = {}) {
   let total = 0;
@@ -253,9 +252,9 @@ export function registerCloudTools(server, config, api) {
       categoryId: z.enum(["community-shorts", "viral-shorts", "insight"]).optional().describe("기본 community-shorts. insight=명언(통찰) 쇼츠"),
       targetCustomer: z.string().optional(),
       tone: z.string().optional().describe("기본 '자동 추천'"),
-      sceneCount: z.number().int().min(1).max(10).optional().describe("기본 3"),
+      sceneCount: z.number().int().min(1).max(10).optional().describe("씬 수. 생략하면 channelFingerprint 의 목표 길이로 자동 산출(지문도 없으면 3)"),
       channelFingerprint: z.object({
-        sampleSize: z.number().optional(),
+        sampleSize: z.number().describe("표본 수 — 서버는 이 값이 0보다 커야 지문을 규격으로 인정한다(없으면 조용히 무시됨)"),
         durationTargetSec: z.number().nullable().optional(),
         cutIntervalSec: z.number().nullable().optional(),
         cutsPerMin: z.number().nullable().optional(),
@@ -276,7 +275,7 @@ export function registerCloudTools(server, config, api) {
         forbidden: z.string().optional().describe("금지 변형 (기본: different face, different hairstyle)"),
       })).max(4).optional().describe("등장 캐릭터 — 서버가 씬마다 identity_lock 을 imagePrompt 에 강제 주입해 캐릭터 일관성을 잠급니다"),
     },
-    wrapCloudHandler(config, async ({ topic = "", copy = "", categoryId = "community-shorts", targetCustomer = "", tone = "자동 추천", sceneCount = 3, characters = [], channelFingerprint = null }) => {
+    wrapCloudHandler(config, async ({ topic = "", copy = "", categoryId = "community-shorts", targetCustomer = "", tone = "자동 추천", sceneCount = 0, characters = [], channelFingerprint = null }) => {
       if (!String(topic).trim() && !String(copy).trim()) {
         return textResult("topic 또는 copy 중 하나는 입력해야 합니다.", { isError: true });
       }
@@ -780,9 +779,14 @@ export function registerCloudTools(server, config, api) {
       emphasisKeywords: z.array(z.string()).max(12).optional().describe("강조 단어 목록 — 자막 라인 안에서 해당 단어만 다른 색/크기로 렌더 (plan_shorts_video의 emphasisKeywords 를 그대로 전달)"),
       emphasisColor: z.string().regex(/^#[0-9a-fA-F]{6}$/, "#RRGGBB 형식").optional().describe("강조 색 #RRGGBB (기본 #facc15 노랑)"),
       emphasisSizeScale: z.number().optional().describe("강조 크기 배율 0.5~2 (기본 1.2)"),
-      transitionMode: z.enum(["fade", "none"]).optional().describe("기본 fade"),
+      channelFingerprint: z.object({
+        subtitleYPct: z.number().nullable().optional(),
+        subtitleLines: z.number().nullable().optional(),
+        hasBgm: z.boolean().nullable().optional(),
+      }).passthrough().optional().describe("measure_channel_spec 이 반환한 fingerprint — 자막 세로 위치·BGM 유무를 참고 채널에 맞춥니다"),
+      transitionMode: z.enum(["fade", "none"]).optional().describe("기본 none(하드컷). fade 는 씬이 맞대기로 붙는 배치에서 컷마다 검은 딥을 만든다 — 명시 요청 시에만 쓸 것"),
     },
-    wrapCloudHandler(config, async ({ sceneVideos, featureKey = "commerceVideo", projectTitle = "aimakeall-mcp", aspectRatio = "9:16", ttsAudioPath = "", bgmAudioPath = "", audioDurationSec = 0, bgmVolume = null, muteVideoAudio = true, titleText = "", subtitleLines = [], emphasisKeywords = [], emphasisColor = "", emphasisSizeScale = 0, transitionMode = "fade" }) => {
+    wrapCloudHandler(config, async ({ sceneVideos, featureKey = "commerceVideo", projectTitle = "aimakeall-mcp", aspectRatio = "9:16", ttsAudioPath = "", bgmAudioPath = "", audioDurationSec = 0, bgmVolume = null, muteVideoAudio = true, titleText = "", subtitleLines = [], emphasisKeywords = [], emphasisColor = "", emphasisSizeScale = 0, transitionMode = "none", channelFingerprint = null }) => {
       // 오디오 확장자 검증 + 합산 크기 예산(서버 413 사전 차단).
       if (ttsAudioPath) assertAllowedInputFile(ttsAudioPath, new Set([".mp3", ".wav"]), { kind: "TTS 오디오" });
       if (bgmAudioPath) assertAllowedInputFile(bgmAudioPath, new Set([".mp3", ".wav"]), { kind: "BGM 오디오" });
@@ -807,6 +811,7 @@ export function registerCloudTools(server, config, api) {
         })),
         emphasisColor,
         emphasisKeywords,
+        channelFingerprint,
         emphasisSizeScale,
         subtitleLines,
         titleText,
@@ -937,13 +942,24 @@ export function registerCloudTools(server, config, api) {
       storyText: z.string().optional().describe("핵심 줄거리·내용 브리프"),
       styleId: z.enum(["standard", "senior", "insight", "webnovel", "christian", "community-shorts", "viral-shorts"]).optional().describe("기본 standard. senior=시니어(쉽고 친절), insight=명언(통찰)"),
       model: z.enum(["gemini", "opus", "sonnet"]).optional().describe("기본 gemini(가성비). opus/sonnet=Claude"),
-      targetLength: z.number().int().min(500).max(20000).optional().describe("목표 글자수, 기본 5000"),
+      targetLength: z.number().int().min(500).max(12000).optional().describe("목표 글자수, 기본 5000. 서버 출력 상한(8192토큰 ≈ 한국어 12,300자)을 넘으면 대본이 중간에 잘리므로 12000 이 상한이다"),
       targetLanguageLabel: z.string().optional().describe("출력 언어 라벨, 기본 '한국 (한국어)'"),
       contentFormat: z.enum(["longform", "shortform"]).optional().describe("기본 longform (standard/senior/insight는 항상 longform)"),
       webnovelSubtypeId: z.enum(["modern-webnovel", "regression-fantasy", "romance-fantasy", "martial-arts", "light-novel", "hunter-fantasy", "revenge-soda", "healing-daily", "relationship-drama", "literary-serial"]).optional().describe("styleId=webnovel일 때 장르"),
       christianContentType: z.enum(["youtube-narration", "prayer", "devotional", "comfort-message"]).optional().describe("styleId=christian일 때 유형"),
       insightFigureNames: z.string().optional().describe("styleId=insight일 때 인물명(쉼표 구분)"),
       userOpinion: z.string().optional().describe("본문에 자연스럽게 녹일 작성자 의견"),
+      channelFingerprint: z.object({
+        durationTargetSec: z.number().nullable().optional(),
+        cutIntervalSec: z.number().nullable().optional(),
+        cpsTarget: z.number().nullable().optional(),
+        subtitleYPct: z.number().nullable().optional(),
+        subtitleLines: z.number().nullable().optional(),
+        endingStyle: z.string().nullable().optional(),
+        emphasisCount: z.number().nullable().optional(),
+        hasBgm: z.boolean().nullable().optional(),
+        sampleSize: z.number().describe("표본 수 — 서버는 이 값이 0보다 커야 지문을 규격으로 인정한다(없으면 조용히 무시됨)"),
+      }).passthrough().optional().describe("measure_channel_spec 의 fingerprint — 실측 규격(길이·컷·말끝)을 대본에 강제합니다"),
     },
     wrapCloudHandler(config, async ({
       title,
@@ -957,12 +973,15 @@ export function registerCloudTools(server, config, api) {
       christianContentType = "youtube-narration",
       insightFigureNames = "",
       userOpinion = "",
+      channelFingerprint = null,
     }) => {
       const SCRIPT_MODEL_MAP = { gemini: "gemini-3.5-flash", opus: "claude-opus-4-8", sonnet: "claude-sonnet-5" };
       const payload = await api.request("/api/tracker/ai/script", {
         body: {
           apiModel: SCRIPT_MODEL_MAP[model] || SCRIPT_MODEL_MAP.gemini,
-          channelStyleProfile: null,
+          // 지문이 있으면 styleProfile 껍데기에 실어 보낸다 — 서버 script-prompts 가
+          // channelStyleProfile.fingerprint 에서 실측 규격 지시문을 뽑는다.
+          channelStyleProfile: channelFingerprint ? { fingerprint: channelFingerprint } : null,
           channelStyleReferenceText: "",
           christianContentType,
           contentFormat,
@@ -983,7 +1002,9 @@ export function registerCloudTools(server, config, api) {
           webnovelSubtypeId,
         },
         method: "POST",
-        timeoutMs: 240_000,
+        // 서버 최악 예산(리서치 40s + 생성 150s×2 = 340s)보다 크게 — 역전되면
+        // 클라는 실패로 끝나는데 서버는 계속 돌며 과금한다.
+        timeoutMs: 420_000,
       });
       const text = String(payload?.text || "").trim();
       if (!text) return textResult("대본 생성 결과가 비어 있습니다. 제목/브리프를 보강해 다시 시도하세요.", { isError: true });
@@ -1004,7 +1025,7 @@ export function registerCloudTools(server, config, api) {
       purpose: z.enum(["investment", "owner-occupancy", "move-up", "verification"]).optional().describe("기본 investment"),
       budget: z.string().optional().describe("예산/가격대"),
       notes: z.string().optional(),
-      targetLength: z.number().int().min(500).max(20000).optional().describe("목표 글자수, 기본 5000"),
+      targetLength: z.number().int().min(500).max(12000).optional().describe("목표 글자수, 기본 5000. 서버 출력 상한(8192토큰 ≈ 한국어 12,300자)을 넘으면 대본이 중간에 잘리므로 12000 이 상한이다"),
       targetLanguageLabel: z.string().optional().describe("기본 '한국 (한국어)'"),
     },
     wrapCloudHandler(config, async ({ analysisType = "apartment-report", primaryTarget = "", secondaryTarget = "", region = "", title = "", storyText = "", purpose = "investment", budget = "", notes = "", targetLength = 5000, targetLanguageLabel = "한국 (한국어)" }) => {
@@ -1034,7 +1055,9 @@ export function registerCloudTools(server, config, api) {
           title,
         },
         method: "POST",
-        timeoutMs: 240_000,
+        // 서버 최악 예산(리서치 40s + 생성 150s×2 = 340s)보다 크게 — 역전되면
+        // 클라는 실패로 끝나는데 서버는 계속 돌며 과금한다.
+        timeoutMs: 420_000,
       });
       const text = String(payload?.text || "").trim();
       if (!text) return textResult("부동산 분석 대본 결과가 비어 있습니다.", { isError: true });
@@ -1055,7 +1078,7 @@ export function registerCloudTools(server, config, api) {
       purpose: z.enum(["startup", "investment", "site-selection", "verification"]).optional().describe("기본 startup"),
       budget: z.string().optional().describe("예산/운영 여력"),
       notes: z.string().optional(),
-      targetLength: z.number().int().min(500).max(20000).optional().describe("목표 글자수, 기본 5000"),
+      targetLength: z.number().int().min(500).max(12000).optional().describe("목표 글자수, 기본 5000. 서버 출력 상한(8192토큰 ≈ 한국어 12,300자)을 넘으면 대본이 중간에 잘리므로 12000 이 상한이다"),
       targetLanguageLabel: z.string().optional().describe("기본 '한국 (한국어)'"),
     },
     wrapCloudHandler(config, async ({ analysisType = "commercial-district-report", primaryTarget = "", secondaryTarget = "", businessType = "", title = "", storyText = "", purpose = "startup", budget = "", notes = "", targetLength = 5000, targetLanguageLabel = "한국 (한국어)" }) => {
@@ -1085,7 +1108,9 @@ export function registerCloudTools(server, config, api) {
           title,
         },
         method: "POST",
-        timeoutMs: 240_000,
+        // 서버 최악 예산(리서치 40s + 생성 150s×2 = 340s)보다 크게 — 역전되면
+        // 클라는 실패로 끝나는데 서버는 계속 돌며 과금한다.
+        timeoutMs: 420_000,
       });
       const text = String(payload?.text || "").trim();
       if (!text) return textResult("상권 분석 대본 결과가 비어 있습니다.", { isError: true });
@@ -1438,20 +1463,18 @@ export function registerCloudTools(server, config, api) {
 
   server.tool(
     "measure_channel_spec",
-    "벤치마크 채널의 영상 표본(유튜브 URL ≤5)을 실측해 채널 규격 지문(길이·컷간격·컷/분·라우드니스·무음비율·자막 위치·말끝 스타일)을 만듭니다. 컴패니언 앱이 다운로드·샷감지·오디오 추출을 수행하고 서버가 집계합니다. 반환된 fingerprint 를 plan_shorts_video 의 channelFingerprint 로 넘기면 대본이 그 규격을 강제합니다.",
+    "벤치마크 채널의 영상 표본(유튜브 URL ≤5)을 실측해 채널 규격 지문(길이·컷간격·컷/분·라우드니스·무음비율·자막 위치·말끝 스타일)을 만듭니다. 말속도는 측정하지 않습니다. 컴패니언 앱이 다운로드·샷감지·오디오 추출을 수행하고 서버가 집계합니다. 반환된 fingerprint 를 plan_shorts_video 의 channelFingerprint 로 넘기면 대본이 그 규격을 강제합니다.",
     {
       videoUrls: z.array(z.string()).min(1).max(5).describe("표본 유튜브 URL 또는 11자 ID (조회수 상위 영상 권장)"),
     },
     wrapCloudHandler(config, async ({ videoUrls }) => {
       const specs = [];
       const notes = [];
-      // 서버 채널지문 라우트의 본문 상한은 16MB. 표본당 120초 WAV(16kHz·16bit 모노)는
-      // base64 ~5.1MB 라 표본 3개만 넘어도 합산이 상한을 넘겨 전체 413 으로 죽는다.
-      // 표본 수에 맞춰 오디오 트림 길이를 나눠 갖고, 누적 크기도 방어적으로 감시한다.
-      const audioBudgetChars = 9_000_000;
-      const base64CharsPerAudioSecond = Math.ceil(COMPANION_AUDIO_BYTES_PER_SECOND * 4 / 3);
-      const audioTrimSeconds = Math.max(20, Math.min(120, Math.floor(audioBudgetChars / videoUrls.length / base64CharsPerAudioSecond)));
-      let audioCharsUsed = 0;
+      // 라우드니스·무음은 여기서 재고 "숫자만" 보낸다. 오디오를 서버로 올리면 표본 3편만
+      // 넘어도 서버 본문 상한(16MB)을 넘겨 요청 전체가 죽고, 그걸 피하려 트림을 줄이면
+      // 표본이 많을수록 측정 구간이 짧아진다. 웹(src/lib/channelFingerprint.js)도 같은 이유로
+      // 브라우저에서 재고 숫자만 보낸다.
+      const audioTrimSeconds = 120;
       for (const [index, rawUrl] of videoUrls.entries()) {
         const watchUrl = canonicalYoutubeWatchUrl(rawUrl);
         if (!watchUrl) {
@@ -1485,31 +1508,33 @@ export function registerCloudTools(server, config, api) {
           if (cutCountClamped) {
             notes.push(`표본 ${index + 1}: 감지 컷이 컴패니언 상한(${COMPANION_MAX_SHOTS})에 도달 — 컷 수는 하한값이라 컷 리듬 축에서 제외`);
           }
-          // 오디오 — 라우드니스/무음은 서버가 검증된 DSP 로 실측.
-          let audioBase64 = "";
+          // 오디오 — 여기서 실측해 숫자만 싣는다(서버 DSP 와 동일 알고리즘, wav-dsp.mjs).
+          let loudnessDbfs = null;
+          let silenceRatio = null;
           try {
             const wav = await extractCompanionAudio(config.companionUrl, { url: watchUrl });
-            const encoded = trimWavToSeconds(wav, audioTrimSeconds).toString("base64");
-            if (audioCharsUsed + encoded.length > audioBudgetChars) {
-              notes.push(`표본 ${index + 1}: 본문 예산 초과로 오디오 제외 — 라우드니스 축 제외`);
-            } else {
-              audioBase64 = encoded;
-              audioCharsUsed += encoded.length;
-            }
+            const trimmed = trimWavToSeconds(wav, audioTrimSeconds);
+            loudnessDbfs = loudnessDbfsFromWav(trimmed);
+            silenceRatio = silenceRatioFromWav(trimmed);
+            if (loudnessDbfs === null) notes.push(`표본 ${index + 1}: WAV 파싱 실패 — 라우드니스 축 제외`);
           } catch (error) {
             notes.push(`표본 ${index + 1}: 오디오 추출 실패(${String(error?.message || error).slice(0, 80)}) — 라우드니스 축 제외`);
           }
           specs.push({
-            audioBase64,
             ...(cutCountClamped ? {} : { cutCount: shots.length }),
             durationSec,
             frames,
+            ...(loudnessDbfs !== null ? { loudnessDbfs } : {}),
+            ...(silenceRatio !== null ? { silenceRatio } : {}),
             videoId: watchUrl.slice(-11),
           });
         } catch (error) {
           notes.push(`표본 ${index + 1}: ${String(error?.message || error).slice(0, 100)}`);
         }
       }
+      // 말속도(cpsTarget)는 타임코드 전사가 있어야 산출된다. 이 도구는 전사를 하지 않으므로
+      // 그 축은 비워 둔다 — 재지 않은 것을 잰 척하지 않는다.
+      notes.push("말속도(cpsTarget)는 측정하지 않습니다 — 타임코드 전사가 필요합니다.");
       if (!specs.length) {
         return textResult(`표본 실측에 모두 실패했습니다. 컴패니언 앱 실행 여부를 확인하세요.\n${notes.join("\n")}`, { isError: true });
       }
@@ -1523,7 +1548,7 @@ export function registerCloudTools(server, config, api) {
       }
       return jsonResult({
         fingerprint: payload.fingerprint,
-        next: "이 fingerprint 객체를 plan_shorts_video 의 channelFingerprint 로 그대로 넘기세요 — 대본이 실측 규격(길이·컷·말속도·말끝)을 따르게 됩니다.",
+        next: "이 fingerprint 객체를 plan_shorts_video·stitch_timeline·write_script 의 channelFingerprint 로 그대로 넘기세요 — 길이·컷 리듬·말끝·자막 위치·BGM 이 이 규격을 따릅니다.",
         notes: notes.length ? notes : undefined,
         sampleCount: specs.length,
       });

package/lib/config.mjs

@@ -2,7 +2,7 @@ import { homedir } from "node:os";
 import path from "node:path";
 
 // 프록시 버전 — 서버가 X-AImakeAll-MCP-Version 으로 하한을 강제(426)할 수 있다.
-export const MCP_PROXY_VERSION = "0.8.0";
+export const MCP_PROXY_VERSION = "0.9.1";
 
 export const DEFAULT_API_BASE = "https://aimakeall.com";
 export const DEFAULT_COMPANION_URL = "http://127.0.0.1:9876";

package/lib/tool-contract.test.mjs

@@ -0,0 +1,80 @@
+// MCP 도구 ↔ 서버 계약 회귀.
+// 감사에서 확인된 실제 결함들을 고정한다 — 전부 "테스트는 통과하는데 사용자에겐 깨져 보이던" 종류다.
+//
+// 이 파일은 zod·cloud-tools 를 import 하지 않는다. mcp/ 는 별도 npm 패키지라 그 의존성이
+// 저장소 루트의 npm ci 에는 없고, 배포 게이트(prep.sh)는 루트에서 npm test 를 돌린다.
+// 다른 mcp 테스트들도 같은 이유로 의존성 없이 작성돼 있다.
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import test from "node:test";
+
+const SOURCE = readFileSync(new URL("./cloud-tools.mjs", import.meta.url), "utf8");
+
+/** 특정 api.request 호출 뒤에 붙은 timeoutMs 값을 읽는다. */
+function clientBudgetFor(routePath) {
+  const at = SOURCE.indexOf(`"${routePath}"`);
+  assert.ok(at > 0, `${routePath} 호출을 찾지 못했다`);
+  const found = SOURCE.slice(at, at + 2600).match(/timeoutMs:\s*([0-9_]+)/);
+  assert.ok(found, `${routePath}: timeoutMs 를 찾지 못했다`);
+  return Number(found[1].replace(/_/g, ""));
+}
+
+test("stitch_timeline 전환 기본값은 none — fade 는 맞대기 배치에서 컷마다 검은 딥을 만든다", () => {
+  // 0.8.0 이 서버·웹 기본값만 none 으로 바꾸고 MCP 를 놓쳐 MCP 렌더에만 딥이 남아 있었다.
+  // MCP 는 transitionMode 를 항상 명시 전송하므로 서버 기본값이 적용되지 않는다.
+  assert.match(SOURCE, /transitionMode = "none"/, "MCP 핸들러 기본값이 none 이 아니다");
+  assert.doesNotMatch(SOURCE, /transitionMode = "fade"/, "fade 기본값이 남아 있다");
+});
+
+test("대본 도구의 targetLength 상한이 서버 출력 상한 안에 있다", () => {
+  // 서버는 max_tokens 8192 고정이라 한국어 약 12,300자가 한계다. 20000 을 광고하면
+  // 프롬프트에 도달 불가한 목표가 나가고, 잘림 감지가 없어 끊긴 대본이 정상 반환된다.
+  assert.doesNotMatch(SOURCE, /targetLength: z\.number\(\)\.int\(\)\.min\(500\)\.max\(20000\)/,
+    "도달 불가한 20000 상한이 남아 있다");
+  const caps = [...SOURCE.matchAll(/targetLength: z\.number\(\)\.int\(\)\.min\(500\)\.max\((\d+)\)/g)]
+    .map((m) => Number(m[1]));
+  assert.equal(caps.length, 3, `대본 도구 3종을 찾지 못했다 (${caps.length}개)`);
+  for (const cap of caps) assert.ok(cap <= 12000, `상한 ${cap} 이 서버 한계를 넘는다`);
+});
+
+test("지문 파라미터는 sampleSize 를 요구한다 — 없으면 서버가 조용히 무시한다", () => {
+  // 서버 buildFingerprintDirectives 는 sampleSize > 0 이 아니면 빈 배열을 반환한다.
+  // 선택 필드로 두면 부분 지문이 통과해 아무 일도 안 일어나는데 성공처럼 보인다.
+  assert.doesNotMatch(SOURCE, /sampleSize: z\.number\(\)\.optional\(\)/,
+    "sampleSize 가 아직 선택 필드다");
+  const required = [...SOURCE.matchAll(/sampleSize: z\.number\(\)\.describe\(/g)].length;
+  assert.ok(required >= 2, `sampleSize 필수 선언이 부족하다 (${required}곳)`);
+});
+
+test("measure_channel_spec 은 재지 않는 축(말속도)을 약속하지 않는다", () => {
+  // cpsTarget 은 타임코드 전사가 있어야 산출되는데 이 도구는 전사를 하지 않는다.
+  const at = SOURCE.indexOf('"measure_channel_spec"');
+  assert.ok(at > 0);
+  const block = SOURCE.slice(at, at + 1200);
+  assert.match(block, /말속도는 측정하지 않습니다/, "재지 않는 축을 약속하고 있다");
+});
+
+test("대본 도구의 클라이언트 예산이 서버 최악 예산보다 크다", () => {
+  // 역전되면 클라는 실패로 끝나는데 서버는 계속 돌며 과금한다 — 회수 불가능한 지출.
+  // 서버 최악: 리서치 8초 + 생성 150초 × 2회 ≈ 310초.
+  for (const route of [
+    "/api/tracker/ai/script",
+    "/api/tracker/ai/real-estate-report",
+    "/api/tracker/ai/market-analysis",
+  ]) {
+    const budget = clientBudgetFor(route);
+    assert.ok(budget >= 400_000, `${route}: 클라이언트 예산 ${budget}ms 가 서버 최악보다 작다`);
+  }
+});
+
+test("이 테스트 파일은 mcp 전용 의존성을 import 하지 않는다", () => {
+  // 배포 게이트는 저장소 루트에서 npm test 를 돌리는데 zod 는 mcp/ 에만 있다.
+  // (실제로 이 규칙을 어겨 배포가 한 번 막혔다.)
+  const self = readFileSync(new URL("./tool-contract.test.mjs", import.meta.url), "utf8");
+  const importLines = self.split("\n").filter((line) => /^\s*import\s/.test(line));
+  for (const line of importLines) {
+    assert.doesNotMatch(line, /["']zod["']/, `zod 를 import 하면 루트 npm test 에서 깨진다: ${line.trim()}`);
+    assert.doesNotMatch(line, /cloud-tools\.mjs/, `cloud-tools 는 zod 를 import 하므로 같이 깨진다: ${line.trim()}`);
+  }
+  assert.ok(importLines.length >= 3, "import 문을 찾지 못했다 — 검사가 무력화됐다");
+});

package/lib/wav-dsp.mjs

@@ -0,0 +1,82 @@
+// WAV 라우드니스·무음 실측 — server/channel-fingerprint.mjs 의 동일 알고리즘을 MCP 로 이식한 것.
+// 이식하는 이유: 지문 측정에서 오디오를 서버로 올리면 표본 3편만 넘어도 서버 본문 상한(16MB)을
+// 넘겨 요청 전체가 죽는다. 웹(src/lib/channelFingerprint.js)도 같은 이유로 브라우저에서 재고
+// 숫자만 보낸다. MCP 는 별도 npm 패키지라 server/ 를 import 할 수 없어 코드를 복제하되,
+// wav-dsp.test.mjs 가 서버 구현과의 수치 일치를 계약으로 고정한다.
+//
+// 세 구현(서버·웹·MCP)은 반드시 같은 숫자를 내야 한다. 한쪽을 고치면 나머지도 같이 고칠 것.
+
+export function parseWavPcm(buffer) {
+  if (!Buffer.isBuffer(buffer) || buffer.length < 44) return null;
+  if (buffer.toString("ascii", 0, 4) !== "RIFF" || buffer.toString("ascii", 8, 12) !== "WAVE") return null;
+  let offset = 12;
+  let fmt = null;
+  let dataOffset = -1;
+  let dataLen = 0;
+  while (offset + 8 <= buffer.length) {
+    const id = buffer.toString("ascii", offset, offset + 4);
+    const size = buffer.readUInt32LE(offset + 4);
+    const body = offset + 8;
+    // fmt 청크 헤더는 있으나 본문(16바이트)이 잘린 버퍼는 건너뛴다 — 읽기 범위 초과 대신 null.
+    if (id === "fmt " && body + 16 <= buffer.length) {
+      fmt = {
+        audioFormat: buffer.readUInt16LE(body),
+        channels: buffer.readUInt16LE(body + 2),
+        sampleRate: buffer.readUInt32LE(body + 4),
+        bitsPerSample: buffer.readUInt16LE(body + 14),
+      };
+    } else if (id === "data") {
+      dataOffset = body;
+      dataLen = Math.min(size, buffer.length - body);
+    }
+    offset = body + size + (size % 2); // chunks are word-aligned
+  }
+  if (!fmt || dataOffset < 0 || fmt.bitsPerSample !== 16 || fmt.audioFormat !== 1) return null;
+  return { ...fmt, dataOffset, dataLen };
+}
+
+// 16-bit PCM 표본을 순회하며 콜백. 첫 채널만 사용(모노 가정, 스테레오면 좌채널).
+function forEachSample(buffer, wav, fn) {
+  const step = 2 * Math.max(1, wav.channels);
+  for (let i = wav.dataOffset; i + 1 < wav.dataOffset + wav.dataLen; i += step) {
+    fn(buffer.readInt16LE(i) / 32768);
+  }
+}
+
+// RMS → dBFS. 무음(전부 0)이면 -Infinity 대신 -100 으로 바닥 처리.
+export function loudnessDbfsFromWav(buffer) {
+  const wav = parseWavPcm(buffer);
+  if (!wav) return null;
+  let sumSq = 0;
+  let n = 0;
+  forEachSample(buffer, wav, (s) => { sumSq += s * s; n += 1; });
+  if (!n) return null;
+  const rms = Math.sqrt(sumSq / n);
+  if (rms <= 0) return -100;
+  return Math.max(-100, Math.round(20 * Math.log10(rms) * 10) / 10);
+}
+
+// 무음 비율 — 짧은 창(20ms)의 RMS 가 임계(dBFS) 아래인 시간 비율. 0~1.
+export function silenceRatioFromWav(buffer, { thresholdDb = -45, windowMs = 20 } = {}) {
+  const wav = parseWavPcm(buffer);
+  if (!wav) return null;
+  const win = Math.max(1, Math.floor((wav.sampleRate * windowMs) / 1000));
+  const thresholdRms = Math.pow(10, thresholdDb / 20);
+  let windows = 0;
+  let silent = 0;
+  let sumSq = 0;
+  let count = 0;
+  forEachSample(buffer, wav, (s) => {
+    sumSq += s * s;
+    count += 1;
+    if (count >= win) {
+      const rms = Math.sqrt(sumSq / count);
+      windows += 1;
+      if (rms < thresholdRms) silent += 1;
+      sumSq = 0;
+      count = 0;
+    }
+  });
+  if (!windows) return null;
+  return Math.round((silent / windows) * 1000) / 1000;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aimakeall-mcp",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "description": "AImakeAll MCP 서버 — Claude Code/Codex에서 자연어로 영상 기획·생성·렌더·퍼블리시 (렌더는 로컬 컴패니언)",
   "type": "module",
   "bin": {