@filmwhisper/mcp-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FilmWhisper Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/__tests__/data-integrity.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data-integrity.test.d.ts.map

package/dist/__tests__/data-integrity.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-integrity.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/data-integrity.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/data-integrity.test.js

@@ -0,0 +1,171 @@
+/**
+ * Data Integrity Hardening tests:
+ *   1. Stale .tmp.* cleanup
+ *   2. WAL integrity check on a valid database
+ *   3. Cross-store reconciliation mismatch detection
+ */
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import * as fs from "node:fs/promises";
+import * as os from "node:os";
+import * as path from "node:path";
+import { ProjectStore } from "../storage/project-store.js";
+import { SqliteStore } from "../storage/sqlite-store.js";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+async function makeTmpDir() {
+    return fs.mkdtemp(path.join(os.tmpdir(), "fw-integrity-"));
+}
+async function initFwDir(projectPath) {
+    await fs.mkdir(path.join(projectPath, ".fw", "assets"), { recursive: true });
+}
+// ---------------------------------------------------------------------------
+// 1. Stale .tmp.* cleanup
+// ---------------------------------------------------------------------------
+describe("ProjectStore.cleanupStaleFiles", () => {
+    let tmpDir;
+    const store = new ProjectStore();
+    beforeEach(async () => {
+        tmpDir = await makeTmpDir();
+        await initFwDir(tmpDir);
+    });
+    afterEach(async () => {
+        await fs.rm(tmpDir, { recursive: true, force: true });
+    });
+    it("removes .tmp.{pid} files from .fw/ and nested dirs", async () => {
+        const fw = path.join(tmpDir, ".fw");
+        const assetsDir = path.join(fw, "assets");
+        // Create stale temp files
+        const stale1 = path.join(fw, "project.fw.json.tmp.12345");
+        const stale2 = path.join(assetsDir, "abc123.fw.json.tmp.99999");
+        await fs.writeFile(stale1, "orphan");
+        await fs.writeFile(stale2, "orphan");
+        // Create a legitimate file that should NOT be deleted
+        const legit = path.join(fw, "project.fw.json");
+        await fs.writeFile(legit, "{}");
+        const deleted = await store.cleanupStaleFiles(tmpDir);
+        expect(deleted).toHaveLength(2);
+        expect(deleted).toContain(stale1);
+        expect(deleted).toContain(stale2);
+        // Legitimate file untouched
+        await expect(fs.access(legit)).resolves.toBeUndefined();
+        // Stale files gone
+        await expect(fs.access(stale1)).rejects.toThrow();
+        await expect(fs.access(stale2)).rejects.toThrow();
+    });
+    it("returns empty array when no stale files exist", async () => {
+        const fw = path.join(tmpDir, ".fw");
+        await fs.writeFile(path.join(fw, "project.fw.json"), "{}");
+        const deleted = await store.cleanupStaleFiles(tmpDir);
+        expect(deleted).toHaveLength(0);
+    });
+    it("does not throw when .fw directory does not exist", async () => {
+        const emptyDir = await makeTmpDir();
+        try {
+            const deleted = await store.cleanupStaleFiles(emptyDir);
+            expect(deleted).toHaveLength(0);
+        }
+        finally {
+            await fs.rm(emptyDir, { recursive: true, force: true });
+        }
+    });
+});
+// ---------------------------------------------------------------------------
+// 2. WAL integrity check
+// ---------------------------------------------------------------------------
+describe("SqliteStore.checkIntegrity", () => {
+    it("returns 'ok' for a freshly created in-memory database", () => {
+        const store = new SqliteStore(":memory:");
+        try {
+            expect(store.checkIntegrity()).toBe("ok");
+        }
+        finally {
+            store.close();
+        }
+    });
+    it("returns 'ok' for a freshly created on-disk database", async () => {
+        const tmpDir = await makeTmpDir();
+        const dbPath = path.join(tmpDir, "state.sqlite");
+        try {
+            const store = new SqliteStore(dbPath);
+            try {
+                expect(store.checkIntegrity()).toBe("ok");
+            }
+            finally {
+                store.close();
+            }
+        }
+        finally {
+            await fs.rm(tmpDir, { recursive: true, force: true });
+        }
+    });
+    it("walCheckpoint runs without error on a healthy database", () => {
+        const store = new SqliteStore(":memory:");
+        try {
+            expect(() => store.walCheckpoint()).not.toThrow();
+        }
+        finally {
+            store.close();
+        }
+    });
+});
+// ---------------------------------------------------------------------------
+// 3. Cross-store reconciliation
+// ---------------------------------------------------------------------------
+describe("SqliteStore.getAssetHashes reconciliation", () => {
+    it("returns empty set when no clips or reviews exist", () => {
+        const store = new SqliteStore(":memory:");
+        try {
+            expect(store.getAssetHashes().size).toBe(0);
+        }
+        finally {
+            store.close();
+        }
+    });
+    it("returns hashes referenced by timeline clips", () => {
+        const store = new SqliteStore(":memory:");
+        try {
+            store.addClip({ assetHash: "hash-aaa", inPointMs: 0, outPointMs: 1000 });
+            store.addClip({ assetHash: "hash-bbb", inPointMs: 0, outPointMs: 500 });
+            const hashes = store.getAssetHashes();
+            expect(hashes.has("hash-aaa")).toBe(true);
+            expect(hashes.has("hash-bbb")).toBe(true);
+            expect(hashes.size).toBe(2);
+        }
+        finally {
+            store.close();
+        }
+    });
+    it("returns hashes referenced by segment reviews", () => {
+        const store = new SqliteStore(":memory:");
+        try {
+            store.setReview({ assetHash: "hash-ccc", segmentIndex: 0, status: "keep" });
+            const hashes = store.getAssetHashes();
+            expect(hashes.has("hash-ccc")).toBe(true);
+        }
+        finally {
+            store.close();
+        }
+    });
+    it("detects SQLite-only hashes (no corresponding JSON asset file)", () => {
+        // Simulate what fw_project_rescan does: compare JSON asset hash set with SQLite
+        const store = new SqliteStore(":memory:");
+        try {
+            store.addClip({ assetHash: "orphan-hash", inPointMs: 0, outPointMs: 1000 });
+            const jsonAssetHashes = new Set(["known-hash"]);
+            const sqliteHashes = store.getAssetHashes();
+            const sqliteOnlyHashes = [];
+            for (const hash of sqliteHashes) {
+                if (!jsonAssetHashes.has(hash)) {
+                    sqliteOnlyHashes.push(hash);
+                }
+            }
+            expect(sqliteOnlyHashes).toContain("orphan-hash");
+            expect(sqliteOnlyHashes).toHaveLength(1);
+        }
+        finally {
+            store.close();
+        }
+    });
+});
+//# sourceMappingURL=data-integrity.test.js.map

package/dist/__tests__/data-integrity.test.js.map

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

package/dist/__tests__/engine/ipc-contract.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ipc-contract.test.d.ts.map

package/dist/__tests__/engine/ipc-contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc-contract.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/engine/ipc-contract.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/engine/ipc-contract.test.js

@@ -0,0 +1,122 @@
+/**
+ * IPC Contract Tests
+ *
+ * These tests spawn the real Python daemon and verify the JSON-RPC 2.0
+ * protocol contract between the TS client and the Python process.
+ */
+import { describe, it, expect, beforeAll, afterAll } from "vitest";
+import * as path from "node:path";
+import * as fs from "node:fs";
+import { EngineClient, EngineClientError } from "../../engine/engine-client.js";
+import { EngineManager } from "../../engine/engine-manager.js";
+const ENGINE_DIR = path.resolve(__dirname, "../../../../processing-engine");
+const VENV_PYTHON = path.join(ENGINE_DIR, ".venv", "bin", "python3");
+const PYTHON_PATH = fs.existsSync(VENV_PYTHON) ? VENV_PYTHON : "python3";
+describe("IPC Contract Tests", () => {
+    let client;
+    beforeAll(async () => {
+        client = new EngineClient(PYTHON_PATH);
+        await client.start(ENGINE_DIR);
+    });
+    afterAll(async () => {
+        await client.stop();
+    });
+    it("initialize handshake returns protocol version", async () => {
+        const result = await client.request("initialize", { protocol_version: "1.0" }, 5_000);
+        expect(result).toHaveProperty("protocol_version", "1.0");
+        expect(result).toHaveProperty("capabilities");
+        expect(typeof result.capabilities).toBe("object");
+    });
+    it("ping returns pong with uptime", async () => {
+        const result = await client.request("ping", {}, 5_000);
+        expect(result).toHaveProperty("status", "pong");
+        expect(result).toHaveProperty("uptime_seconds");
+        expect(typeof result.uptime_seconds).toBe("number");
+    });
+    it("unknown method returns -32601 error", async () => {
+        try {
+            await client.request("nonexistent_method", {}, 5_000);
+            expect.fail("Should have thrown");
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(EngineClientError);
+            expect(err.code).toBe(-32601);
+        }
+    });
+    it("timeout produces clear error", async () => {
+        // Spawn a separate client that we'll stop mid-request to test timeout.
+        // We create a second client, start it, then kill its process so it can't
+        // respond, and verify the pending request times out.
+        const timeoutClient = new EngineClient(PYTHON_PATH);
+        await timeoutClient.start(ENGINE_DIR);
+        // Verify it's alive
+        const pong = await timeoutClient.request("ping", {}, 5_000);
+        expect(pong.status).toBe("pong");
+        // Kill the underlying process so the next request can never get a response.
+        // Access the pid and kill it with SIGSTOP to freeze (not exit) so the
+        // client stays "running" but unresponsive.
+        const pid = timeoutClient.pid;
+        expect(pid).not.toBeNull();
+        process.kill(pid, "SIGSTOP");
+        try {
+            await timeoutClient.request("ping", {}, 200);
+            expect.fail("Should have thrown");
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(EngineClientError);
+            expect(err.message).toMatch(/timeout/i);
+        }
+        finally {
+            // SIGCONT then stop cleanly
+            try {
+                process.kill(pid, "SIGCONT");
+            }
+            catch { /* process may have exited */ }
+            await timeoutClient.stop();
+        }
+    });
+    it("transcode returns FILE_NOT_FOUND for missing source", async () => {
+        try {
+            await client.request("transcode", {
+                asset_hash: "test123",
+                source_path: "/nonexistent_test.mp4",
+                proxy_spec: "720p",
+                output_path: "/tmp/fw_test_out.mp4",
+            }, 5_000);
+            throw new Error("Should have thrown");
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(EngineClientError);
+            expect(err.code).toBe(1003); // FILE_NOT_FOUND
+        }
+    });
+});
+describe("EngineManager lifecycle", () => {
+    let manager;
+    afterAll(async () => {
+        if (manager) {
+            await manager.shutdown();
+        }
+    });
+    it("auto-starts daemon on first request", async () => {
+        manager = new EngineManager(ENGINE_DIR, PYTHON_PATH);
+        expect(manager.isRunning).toBe(false);
+        const result = await manager.request("ping", {}, 5_000);
+        expect(manager.isRunning).toBe(true);
+        expect(result.status).toBe("pong");
+    });
+    it("healthCheck returns true when daemon is running", async () => {
+        const healthy = await manager.healthCheck();
+        expect(healthy).toBe(true);
+    });
+    it("shutdown stops the daemon", async () => {
+        await manager.shutdown();
+        expect(manager.isRunning).toBe(false);
+    });
+    it("restarts after shutdown on next request", async () => {
+        const result = await manager.request("ping", {}, 5_000);
+        expect(manager.isRunning).toBe(true);
+        expect(result.status).toBe("pong");
+    });
+});
+//# sourceMappingURL=ipc-contract.test.js.map

package/dist/__tests__/engine/ipc-contract.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc-contract.test.js","sourceRoot":"","sources":["../../../src/__tests__/engine/ipc-contract.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACnE,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAE/D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,+BAA+B,CAAC,CAAC;AAC5E,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;AACrE,MAAM,WAAW,GAAG,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;AAEzE,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,IAAI,MAAoB,CAAC;IAEzB,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,GAAG,IAAI,YAAY,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,KAAK,IAAI,EAAE;QAClB,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAGhC,YAAY,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;QACzD,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;QAC9C,MAAM,CAAC,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAGhC,MAAM,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QACtB,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;QAChD,MAAM,CAAC,OAAO,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;YACtD,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;YAC9C,MAAM,CAAE,GAAyB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;QACvD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,uEAAuE;QACvE,yEAAyE;QACzE,qDAAqD;QACrD,MAAM,aAAa,GAAG,IAAI,YAAY,CAAC,WAAW,CAAC,CAAC;QACpD,MAAM,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAEtC,oBAAoB;QACpB,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,OAAO,CAAqB,MAAM,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QAChF,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEjC,4EAA4E;QAC5E,sEAAsE;QACtE,2CAA2C;QAC3C,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC;QAC9B,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,GAAI,EAAE,SAAS,CAAC,CAAC;QAE9B,IAAI,CAAC;YACH,MAAM,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;YAC9C,MAAM,CAAE,GAAyB,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACjE,CAAC;gBAAS,CAAC;YACT,4BAA4B;YAC5B,IAAI,CAAC;gBAAC,OAAO,CAAC,IAAI,CAAC,GAAI,EAAE,SAAS,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,6BAA6B,CAAC,CAAC;YAC9E,MAAM,aAAa,CAAC,IAAI,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,CAClB,WAAW,EACX;gBACE,UAAU,EAAE,SAAS;gBACrB,WAAW,EAAE,uBAAuB;gBACpC,UAAU,EAAE,MAAM;gBAClB,WAAW,EAAE,sBAAsB;aACpC,EACD,KAAK,CACN,CAAC;YACF,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;YAC9C,MAAM,CAAE,GAAyB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB;QACvE,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,IAAI,OAAsB,CAAC;IAE3B,QAAQ,CAAC,KAAK,IAAI,EAAE;QAClB,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,OAAO,GAAG,IAAI,aAAa,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QACrD,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEtC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAGjC,MAAM,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QAEtB,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QACzC,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAGjC,MAAM,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QAEtB,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/fw-project-init.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fw-project-init.test.d.ts.map

package/dist/__tests__/fw-project-init.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fw-project-init.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/fw-project-init.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/fw-project-init.test.js

@@ -0,0 +1,96 @@
+/**
+ * TDD RED → GREEN: fw_project_init MCP tool test
+ * Uses InMemoryTransport for process-free testing
+ */
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
+import * as fs from "node:fs/promises";
+import * as os from "node:os";
+import * as path from "node:path";
+import { createServer } from "../server.js";
+import { ProjectStore } from "../storage/project-store.js";
+describe("fw_project_init tool", () => {
+    let client;
+    let cleanup;
+    let tmpDir;
+    beforeEach(async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "fw-test-"));
+        const deps = {
+            projectStore: new ProjectStore(),
+            projects: new Map(),
+        };
+        const server = createServer(deps);
+        const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+        await server.connect(serverTransport);
+        client = new Client({ name: "test-client", version: "1.0.0" });
+        await client.connect(clientTransport);
+        cleanup = async () => {
+            await client.close();
+            await server.close();
+        };
+    });
+    afterEach(async () => {
+        await cleanup();
+        await fs.rm(tmpDir, { recursive: true, force: true });
+    });
+    it("should be listed in available tools", async () => {
+        const { tools } = await client.listTools();
+        const toolNames = tools.map((t) => t.name);
+        expect(toolNames).toContain("fw_project_init");
+    });
+    it("should return project_id and asset counts on valid input", async () => {
+        const result = await client.callTool({
+            name: "fw_project_init",
+            arguments: {
+                name: "Test Project",
+                source_path: tmpDir,
+            },
+        });
+        expect(result.isError).toBeFalsy();
+        const content = result.content;
+        expect(content).toHaveLength(1);
+        expect(content[0].type).toBe("text");
+        const data = JSON.parse(content[0].text);
+        expect(data).toHaveProperty("project_id");
+        expect(data).toHaveProperty("assets_discovered");
+        expect(data).toHaveProperty("assets_new");
+        expect(data).toHaveProperty("revision");
+        expect(typeof data.project_id).toBe("string");
+        expect(data.project_id.length).toBeGreaterThan(0);
+    });
+    it("should accept optional fields", async () => {
+        const result = await client.callTool({
+            name: "fw_project_init",
+            arguments: {
+                name: "Full Options Project",
+                source_path: tmpDir,
+                proxy_spec: "1280x720",
+                language: "ko",
+                target_duration_seconds: 120,
+            },
+        });
+        expect(result.isError).toBeFalsy();
+        const data = JSON.parse(result.content[0].text);
+        expect(data.project_id).toBeTruthy();
+    });
+    it("should fail when name is missing", async () => {
+        const result = await client.callTool({
+            name: "fw_project_init",
+            arguments: {
+                source_path: tmpDir,
+            },
+        });
+        expect(result.isError).toBe(true);
+    });
+    it("should fail when source_path is missing", async () => {
+        const result = await client.callTool({
+            name: "fw_project_init",
+            arguments: {
+                name: "Test",
+            },
+        });
+        expect(result.isError).toBe(true);
+    });
+});
+//# sourceMappingURL=fw-project-init.test.js.map

package/dist/__tests__/fw-project-init.test.js.map

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

package/dist/__tests__/helpers/mock-engine.d.ts

@@ -0,0 +1,2 @@
+export declare function createMockEngineManager(): unknown;
+//# sourceMappingURL=mock-engine.d.ts.map

package/dist/__tests__/helpers/mock-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-engine.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/mock-engine.ts"],"names":[],"mappings":"AAMA,wBAAgB,uBAAuB,IAAI,OAAO,CAuFjD"}

package/dist/__tests__/helpers/mock-engine.js

@@ -0,0 +1,81 @@
+export function createMockEngineManager() {
+    return {
+        async request(method, params, _timeout) {
+            switch (method) {
+                case "editorial_rank": {
+                    // Echo back the segments that were passed in as ranked clips
+                    const inputSegments = params.segments;
+                    return {
+                        ranked_clips: inputSegments.map((s) => ({
+                            asset_hash: s.asset_hash,
+                            segment_index: s.segment_index,
+                            score: 0.9,
+                            role: "interview",
+                            selection_reason: "high story value",
+                        })),
+                    };
+                }
+                case "duration_trim": {
+                    // Echo back the clips that were passed in, preserving asset_hash/segment_index
+                    const inputClips = params.clips;
+                    const trimmedClips = inputClips.map((c) => ({
+                        asset_hash: c.asset_hash,
+                        segment_index: c.segment_index,
+                        in_point_ms: c.start_ms,
+                        out_point_ms: c.end_ms,
+                        trimmed: false,
+                    }));
+                    const totalDurationMs = inputClips.reduce((sum, c) => sum + (c.end_ms - c.start_ms), 0);
+                    return {
+                        trimmed_clips: trimmedClips,
+                        total_duration_ms: totalDurationMs,
+                        rationale: trimmedClips.map((_, i) => ({
+                            clip_index: i,
+                            role: "interview",
+                            selection_reason: "included at full length",
+                        })),
+                    };
+                }
+                case "gap_fill": {
+                    // Echo backbone clips back as-is (no actual gap fill in tests)
+                    const backbone = params.backbone_clips;
+                    const filledClips = backbone.map((c) => ({
+                        asset_hash: c.asset_hash,
+                        segment_index: c.segment_index,
+                        in_point_ms: c.start_ms,
+                        out_point_ms: c.end_ms,
+                        is_gap_fill: false,
+                    }));
+                    return {
+                        filled_clips: filledClips,
+                        total_duration_ms: backbone.reduce((sum, c) => sum + (c.end_ms - c.start_ms), 0),
+                        rationale: filledClips.map((_, i) => ({
+                            clip_index: i,
+                            role: "backbone",
+                            selection_reason: "backbone clip",
+                        })),
+                    };
+                }
+                case "export":
+                    return { output_path: params.output_path };
+                case "assemble":
+                    return {
+                        output_path: params.output_path,
+                        duration_seconds: 30,
+                    };
+                default:
+                    throw new Error(`Mock: unknown method ${method}`);
+            }
+        },
+        async ensureRunning() {
+            // no-op
+        },
+        get isRunning() {
+            return true;
+        },
+        async shutdown() {
+            // no-op
+        },
+    };
+}
+//# sourceMappingURL=mock-engine.js.map

package/dist/__tests__/helpers/mock-engine.js.map

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

package/dist/__tests__/r1-quality.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=r1-quality.test.d.ts.map

package/dist/__tests__/r1-quality.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r1-quality.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/r1-quality.test.ts"],"names":[],"mappings":""}