@thunderkiller/video-clipper 1.8.0 → 1.10.0

package/dist/lib/{utils/fileCacheBackend.js → services/cache/backends/file.js}

@@ -2,8 +2,8 @@ import { createHash } from 'node:crypto';
 import { promises as fs } from 'fs';
 import path from 'path';
 import { z } from 'zod';
-import { log } from './logger.js';
-import { TranscriptLineSchema, ChunkEvaluationSchema, AudioEventSchema, SegmentRefinementSchema, } from '../types/index.js';
+import { log } from '../../../utils/logger.js';
+import { TranscriptLineSchema, ChunkEvaluationSchema, AudioEventSchema, SegmentRefinementSchema, } from '../../../types/index.js';
 // ---------------------------------------------------------------------------
 // Internal helpers
 // ---------------------------------------------------------------------------
@@ -20,12 +20,22 @@ function audioEventsKey(events) {
 function hashContent(input) {
     return createHash('sha256').update(input).digest('hex');
 }
+export function computeChunkCacheKey(chunk, chunkAudioEvents = []) {
+    const audioKey = audioEventsKey(chunkAudioEvents);
+    return hashContent(`${chunk.start}|${chunk.end}|${chunk.text}|${audioKey}`);
+}
+export function computeSegmentRefinementCacheKey(start, end, reason) {
+    return hashContent(`${start}|${end}|${reason}`);
+}
+export function computeVideoCacheKey(videoId) {
+    return hashContent(videoId);
+}
 async function readCacheFile(filePath, schema) {
     try {
         const raw = await fs.readFile(filePath, 'utf-8');
         const parsed = schema.safeParse(JSON.parse(raw));
         if (!parsed.success) {
-            log.warn(`[cache] Corrupt entry at ${filePath} — ignoring`);
+            log.warn('FileCacheBackend', `[cache] Corrupt entry at ${filePath} — ignoring`);
             return null;
         }
         return parsed.data;
@@ -41,7 +51,7 @@ async function writeCacheFile(filePath, data) {
         await fs.writeFile(filePath, JSON.stringify(data, null, 2), 'utf-8');
     }
     catch (err) {
-        log.warn(`[cache] Failed to write ${filePath}: ${err instanceof Error ? err.message : String(err)}`);
+        log.warn('FileCacheBackend', `[cache] Failed to write ${filePath}: ${err instanceof Error ? err.message : String(err)}`);
     }
 }
 // ---------------------------------------------------------------------------
@@ -64,7 +74,7 @@ export class FileCacheBackend {
     }
     // ---- Transcript -----------------------------------------------------------
     transcriptPath(videoId) {
-        return path.join(this.cacheDir, 'transcript', `${hashContent(videoId)}.json`);
+        return path.join(this.cacheDir, 'transcript', `${computeVideoCacheKey(videoId)}.json`);
     }
     async readTranscript(videoId) {
         return readCacheFile(this.transcriptPath(videoId), z.array(TranscriptLineSchema));
@@ -74,8 +84,7 @@ export class FileCacheBackend {
     }
     // ---- LLM chunk results ----------------------------------------------------
     chunkPath(chunk, chunkAudioEvents = []) {
-        const audioKey = audioEventsKey(chunkAudioEvents);
-        return path.join(this.cacheDir, 'chunks', `${hashContent(`${chunk.start}|${chunk.end}|${chunk.text}|${audioKey}`)}.json`);
+        return path.join(this.cacheDir, 'chunks', `${computeChunkCacheKey(chunk, chunkAudioEvents)}.json`);
     }
     async readChunk(chunk, chunkAudioEvents = []) {
         return readCacheFile(this.chunkPath(chunk, chunkAudioEvents), ChunkEvaluationSchema);
@@ -87,7 +96,7 @@ export class FileCacheBackend {
     }
     // ---- Segment refinement ---------------------------------------------------
     segmentRefinementPath(start, end, reason) {
-        return path.join(this.cacheDir, 'segments', `${hashContent(`${start}|${end}|${reason}`)}.json`);
+        return path.join(this.cacheDir, 'segments', `${computeSegmentRefinementCacheKey(start, end, reason)}.json`);
     }
     async readSegmentRefinement(start, end, reason) {
         return readCacheFile(this.segmentRefinementPath(start, end, reason), SegmentRefinementSchema);
@@ -120,4 +129,4 @@ export class FileCacheBackend {
         // No-op — file handles are not kept open between operations
     }
 }
-//# sourceMappingURL=fileCacheBackend.js.map
+//# sourceMappingURL=file.js.map

package/dist/lib/services/cache/backends/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../../../../src/lib/services/cache/backends/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAC3C,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAU7B,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;GAGG;AACH,SAAS,cAAc,CAAC,MAAoB;IAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAe,EAAE,mBAAiC,EAAE;IACvF,MAAM,QAAQ,GAAG,cAAc,CAAC,gBAAgB,CAAC,CAAC;IAClD,OAAO,WAAW,CAAC,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,IAAI,IAAI,QAAQ,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,KAAa,EACb,GAAW,EACX,MAAc;IAEd,OAAO,WAAW,CAAC,GAAG,KAAK,IAAI,GAAG,IAAI,MAAM,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED,KAAK,UAAU,aAAa,CAAI,QAAgB,EAAE,MAAoB;IACpE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,4BAA4B,QAAQ,aAAa,CAAC,CAAC;YAChF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,gEAAgE;QAChE,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,QAAgB,EAAE,IAAa;IAC3D,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CACN,kBAAkB,EAClB,2BAA2B,QAAQ,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC3F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,OAAO,gBAAgB;IACC;IAA5B,YAA4B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;IAEhD,8EAA8E;IAEtE,cAAc,CAAC,OAAe;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,oBAAoB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACzF,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAAe;QAClC,OAAO,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;IACpF,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAAe,EAAE,KAAuB;QAC5D,MAAM,cAAc,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;IAC5D,CAAC;IAED,8EAA8E;IAEtE,SAAS,CAAC,KAAe,EAAE,mBAAiC,EAAE;QACpE,OAAO,IAAI,CAAC,IAAI,CACd,IAAI,CAAC,QAAQ,EACb,QAAQ,EACR,GAAG,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,CAAC,OAAO,CACxD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CACb,KAAe,EACf,mBAAiC,EAAE;QAEnC,OAAO,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,gBAAgB,CAAC,EAAE,qBAAqB,CAAC,CAAC;IACvF,CAAC;IAED,KAAK,CAAC,UAAU,CACd,KAAe,EACf,UAA2B,EAC3B,mBAAiC,EAAE;QAEnC,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO;QAC5C,MAAM,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,gBAAgB,CAAC,EAAE,UAAU,CAAC,CAAC;IAC5E,CAAC;IAED,8EAA8E;IAEtE,qBAAqB,CAAC,KAAa,EAAE,GAAW,EAAE,MAAc;QACtE,OAAO,IAAI,CAAC,IAAI,CACd,IAAI,CAAC,QAAQ,EACb,UAAU,EACV,GAAG,gCAAgC,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,OAAO,CAC/D,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,qBAAqB,CACzB,KAAa,EACb,GAAW,EACX,MAAc;QAEd,OAAO,aAAa,CAAC,IAAI,CAAC,qBAAqB,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,uBAAuB,CAAC,CAAC;IAChG,CAAC;IAED,KAAK,CAAC,sBAAsB,CAC1B,KAAa,EACb,GAAW,EACX,MAAc,EACd,OAA0B;QAE1B,MAAM,cAAc,CAAC,IAAI,CAAC,qBAAqB,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;IAChF,CAAC;IAED,8EAA8E;IAEtE,cAAc,CAAC,OAAe,EAAE,WAAmB,EAAE,QAAgB;QAC3E,OAAO,IAAI,CAAC,IAAI,CACd,IAAI,CAAC,QAAQ,EACb,OAAO,EACP,GAAG,WAAW,CAAC,GAAG,OAAO,IAAI,WAAW,IAAI,QAAQ,EAAE,CAAC,OAAO,CAC/D,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,OAAe,EACf,WAAmB,EACnB,QAAgB;QAEhB,OAAO,aAAa,CAClB,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,EACnD,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAC1B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,OAAe,EACf,WAAmB,EACnB,QAAgB,EAChB,MAAoB;QAEpB,MAAM,cAAc,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;IACpF,CAAC;IAED,8EAA8E;IAEtE,cAAc,CACpB,OAAe,EACf,WAAmB,EACnB,QAAgB,EAChB,WAAmB,EACnB,SAAiB;QAEjB,OAAO,IAAI,CAAC,IAAI,CACd,IAAI,CAAC,QAAQ,EACb,OAAO,EACP,GAAG,WAAW,CAAC,GAAG,OAAO,IAAI,WAAW,IAAI,QAAQ,IAAI,WAAW,IAAI,SAAS,EAAE,CAAC,OAAO,CAC3F,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,OAAe,EACf,WAAmB,EACnB,QAAgB,EAChB,WAAmB,EACnB,SAAiB;QAEjB,OAAO,aAAa,CAClB,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,CAAC,EAC3E,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAC1B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,OAAe,EACf,WAAmB,EACnB,QAAgB,EAChB,WAAmB,EACnB,SAAiB,EACjB,MAAoB;QAEpB,MAAM,cAAc,CAClB,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,CAAC,EAC3E,MAAM,CACP,CAAC;IACJ,CAAC;IAED,8EAA8E;IAE9E,KAAK,CAAC,KAAK;QACT,4DAA4D;IAC9D,CAAC;CACF"}

package/dist/lib/{utils/mongoCacheBackend.d.ts → services/cache/backends/mongo.d.ts}

@@ -1,6 +1,6 @@
 import type { MongoClient } from 'mongodb';
-import type { TranscriptLine, LLMChunk, ChunkEvaluation, AudioEvent, SegmentRefinement } from '../types/index.js';
-import type { CacheBackend } from './cacheBackend.js';
+import type { TranscriptLine, LLMChunk, ChunkEvaluation, AudioEvent, SegmentRefinement } from '../../../types/index.js';
+import type { CacheBackend } from '../../../types/cache.js';
 /**
  * MongoDB-backed cache backend.
  *
@@ -48,4 +48,4 @@ export declare class MongoCacheBackend implements CacheBackend {
     writeAudioChunk(videoId: string, gameProfile: string, provider: string, windowStart: number, windowEnd: number, events: AudioEvent[]): Promise<void>;
     close(): Promise<void>;
 }
-//# sourceMappingURL=mongoCacheBackend.d.ts.map
+//# sourceMappingURL=mongo.d.ts.map

package/dist/lib/services/cache/backends/mongo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo.d.ts","sourceRoot":"","sources":["../../../../../src/lib/services/cache/backends/mongo.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAS3C,OAAO,KAAK,EACV,cAAc,EACd,QAAQ,EACR,eAAe,EACf,UAAU,EACV,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,qBAAqB,CAAC;AAwBvE;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IAOlD,OAAO,CAAC,QAAQ,CAAC,MAAM;IANzB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,+EAA+E;IAC/E,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;gBAGrC,MAAM,EAAE,WAAW,EACpC,YAAY,EAAE,MAAM,EACpB,UAAU,SAAI;IAUhB;;;OAGG;YACW,aAAa;YAwBb,OAAO;YA6BP,QAAQ;IAqBtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAiB;IAE9C,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC;IAQjE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAEpD,OAAO,CAAC,QAAQ;IAKV,SAAS,CACb,KAAK,EAAE,QAAQ,EACf,gBAAgB,GAAE,UAAU,EAAO,GAClC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAQ5B,UAAU,CACd,KAAK,EAAE,QAAQ,EACf,UAAU,EAAE,eAAe,EAC3B,gBAAgB,GAAE,UAAU,EAAO,GAClC,OAAO,CAAC,IAAI,CAAC;IAchB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IAElD,qBAAqB,CACzB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAQ9B,sBAAsB,CAC1B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC;IAYhB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAiB;IAE/C,eAAe,CACnB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC;IAQzB,gBAAgB,CACpB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,EAAE,GACnB,OAAO,CAAC,IAAI,CAAC;IAYhB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAiB;IAE/C,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC;IAQzB,eAAe,CACnB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,EAAE,GACnB,OAAO,CAAC,IAAI,CAAC;IAYV,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAU7B"}

package/dist/lib/{utils/mongoCacheBackend.js → services/cache/backends/mongo.js}

@@ -1,7 +1,7 @@
 import { createHash } from 'node:crypto';
 import { z } from 'zod';
-import { log } from './logger.js';
-import { TranscriptLineSchema, ChunkEvaluationSchema, AudioEventSchema, SegmentRefinementSchema, } from '../types/index.js';
+import { log } from '../../../utils/logger.js';
+import { TranscriptLineSchema, ChunkEvaluationSchema, AudioEventSchema, SegmentRefinementSchema, } from '../../../types/index.js';
 // ---------------------------------------------------------------------------
 // Internal helpers
 // ---------------------------------------------------------------------------
@@ -69,7 +69,7 @@ export class MongoCacheBackend {
         }
         catch (err) {
             // Non-fatal — pipeline should not crash if indexes can't be created
-            log.warn(`[mongo-cache] Failed to ensure indexes on "${collectionName}": ${err instanceof Error ? err.message : String(err)}`);
+            log.warn('MongoCacheBackend.ensureIndexes', `[mongo-cache] Failed to ensure indexes on "${collectionName}": ${err instanceof Error ? err.message : String(err)}`);
         }
     }
     // ---------------------------------------------------------------------------
@@ -84,13 +84,13 @@ export class MongoCacheBackend {
                 return null;
             const parsed = schema.safeParse(doc.data);
             if (!parsed.success) {
-                log.warn(`[mongo-cache] Corrupt entry in "${collectionName}" (key=${cacheKey}) — ignoring`);
+                log.warn('MongoCacheBackend.readDoc', `[mongo-cache] Corrupt entry in "${collectionName}" (key=${cacheKey}) — ignoring`);
                 return null;
             }
             return parsed.data;
         }
         catch (err) {
-            log.warn(`[mongo-cache] Read failed in "${collectionName}": ${err instanceof Error ? err.message : String(err)}`);
+            log.warn('MongoCacheBackend.readDoc', `[mongo-cache] Read failed in "${collectionName}": ${err instanceof Error ? err.message : String(err)}`);
             return null;
         }
     }
@@ -101,7 +101,7 @@ export class MongoCacheBackend {
             await col.updateOne({ cacheKey }, { $set: { cacheKey, data, createdAt: new Date() } }, { upsert: true });
         }
         catch (err) {
-            log.warn(`[mongo-cache] Write failed in "${collectionName}": ${err instanceof Error ? err.message : String(err)}`);
+            log.warn('MongoCacheBackend.writeDoc', `[mongo-cache] Write failed in "${collectionName}": ${err instanceof Error ? err.message : String(err)}`);
         }
     }
     // ---------------------------------------------------------------------------
@@ -169,8 +169,8 @@ export class MongoCacheBackend {
             await this.client.close();
         }
         catch (err) {
-            log.warn(`[mongo-cache] Failed to close MongoDB connection: ${err instanceof Error ? err.message : String(err)}`);
+            log.warn('MongoCacheBackend.close', `[mongo-cache] Failed to close MongoDB connection: ${err instanceof Error ? err.message : String(err)}`);
         }
     }
 }
-//# sourceMappingURL=mongoCacheBackend.js.map
+//# sourceMappingURL=mongo.js.map

package/dist/lib/services/cache/backends/mongo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo.js","sourceRoot":"","sources":["../../../../../src/lib/services/cache/backends/mongo.ts"],"names":[],"mappings":"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"}

package/dist/lib/{utils → services/cache}/cache.d.ts

@@ -1,20 +1,21 @@
-import type { CacheBackend } from './cacheBackend.js';
-import type { TranscriptLine, LLMChunk, ChunkEvaluation, AudioEvent, SegmentRefinement } from '../types/index.js';
-export type { CacheBackend };
+import type { CacheBackend } from '../../types/cache.js';
+import type { TranscriptLine, LLMChunk, ChunkEvaluation, AudioEvent, SegmentRefinement } from '../../types/index.js';
 /**
  * Facade that wraps a CacheBackend and implements the CacheBackend interface.
  *
  * This means `Cache` can be passed anywhere a `CacheBackend` is expected, so
  * all pipeline consumers work whether they type their parameter as `Cache` or
  * `CacheBackend`. The concrete backend is injected by the factory in
- * cacheFactory.ts.
+ * factory.ts.
  *
  * Call `close()` at the end of the pipeline to release backend resources
  * (important for the MongoDB backend which holds an open connection).
  */
 export declare class Cache implements CacheBackend {
     readonly backend: CacheBackend;
-    constructor(backend: CacheBackend);
+    private readonly videoId?;
+    constructor(backend: CacheBackend, videoId?: string | undefined);
+    private get manifestCacheDir();
     readTranscript(videoId: string): Promise<TranscriptLine[] | null>;
     writeTranscript(videoId: string, lines: TranscriptLine[]): Promise<void>;
     readChunk(chunk: LLMChunk, chunkAudioEvents?: AudioEvent[]): Promise<ChunkEvaluation | null>;

package/dist/lib/services/cache/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/cache/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EACV,cAAc,EACd,QAAQ,EACR,eAAe,EACf,UAAU,EACV,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAQ7B;;;;;;;;;;GAUG;AACH,qBAAa,KAAM,YAAW,YAAY;IAEtC,QAAQ,CAAC,OAAO,EAAE,YAAY;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;gBADhB,OAAO,EAAE,YAAY,EACb,OAAO,CAAC,EAAE,MAAM,YAAA;IAGnC,OAAO,KAAK,gBAAgB,GAI3B;IAIK,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC;IAIjE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxE,SAAS,CACb,KAAK,EAAE,QAAQ,EACf,gBAAgB,CAAC,EAAE,UAAU,EAAE,GAC9B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAI5B,UAAU,CACd,KAAK,EAAE,QAAQ,EACf,UAAU,EAAE,eAAe,EAC3B,gBAAgB,CAAC,EAAE,UAAU,EAAE,GAC9B,OAAO,CAAC,IAAI,CAAC;IAWV,qBAAqB,CACzB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAI9B,sBAAsB,CAC1B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC;IAWV,eAAe,CACnB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC;IAIzB,gBAAgB,CACpB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,EAAE,GACnB,OAAO,CAAC,IAAI,CAAC;IAMV,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC;IAIzB,eAAe,CACnB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,EAAE,GACnB,OAAO,CAAC,IAAI,CAAC;IAaV,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/lib/{utils → services/cache}/cache.js

@@ -1,18 +1,29 @@
+import { FileCacheBackend, computeChunkCacheKey, computeSegmentRefinementCacheKey, } from './backends/file.js';
+import { appendChunkHash, appendSegmentHash } from './manifest.js';
 /**
  * Facade that wraps a CacheBackend and implements the CacheBackend interface.
  *
  * This means `Cache` can be passed anywhere a `CacheBackend` is expected, so
  * all pipeline consumers work whether they type their parameter as `Cache` or
  * `CacheBackend`. The concrete backend is injected by the factory in
- * cacheFactory.ts.
+ * factory.ts.
  *
  * Call `close()` at the end of the pipeline to release backend resources
  * (important for the MongoDB backend which holds an open connection).
  */
 export class Cache {
     backend;
-    constructor(backend) {
+    videoId;
+    constructor(backend, videoId) {
         this.backend = backend;
+        this.videoId = videoId;
+    }
+    get manifestCacheDir() {
+        if (!this.videoId)
+            return null;
+        if (this.backend instanceof FileCacheBackend)
+            return this.backend.cacheDir;
+        return null;
     }
     // ---- Transcript -----------------------------------------------------------
     async readTranscript(videoId) {
@@ -26,14 +37,24 @@ export class Cache {
         return this.backend.readChunk(chunk, chunkAudioEvents);
     }
     async writeChunk(chunk, evaluation, chunkAudioEvents) {
-        return this.backend.writeChunk(chunk, evaluation, chunkAudioEvents);
+        await this.backend.writeChunk(chunk, evaluation, chunkAudioEvents);
+        const cacheDir = this.manifestCacheDir;
+        if (cacheDir && this.videoId && evaluation.status === 'success') {
+            const hash = computeChunkCacheKey(chunk, chunkAudioEvents ?? []);
+            await appendChunkHash(cacheDir, this.videoId, hash);
+        }
     }
     // ---- Segment refinement ---------------------------------------------------
     async readSegmentRefinement(start, end, reason) {
         return this.backend.readSegmentRefinement(start, end, reason);
     }
     async writeSegmentRefinement(start, end, reason, refined) {
-        return this.backend.writeSegmentRefinement(start, end, reason, refined);
+        await this.backend.writeSegmentRefinement(start, end, reason, refined);
+        const cacheDir = this.manifestCacheDir;
+        if (cacheDir && this.videoId) {
+            const hash = computeSegmentRefinementCacheKey(start, end, reason);
+            await appendSegmentHash(cacheDir, this.videoId, hash);
+        }
     }
     // ---- Audio events (whole-video) -------------------------------------------
     async readAudioEvents(videoId, gameProfile, provider) {

package/dist/lib/services/cache/cache.js.map

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

package/dist/lib/{utils/cacheFactory.d.ts → services/cache/factory.d.ts}

@@ -1,5 +1,5 @@
-import type { CacheBackend } from './cacheBackend.js';
-import type { Config } from '../types/index.js';
+import type { CacheBackend } from '../../types/cache.js';
+import type { Config } from '../../types/index.js';
 /**
  * Creates the appropriate CacheBackend based on config.
  *
@@ -11,4 +11,4 @@ import type { Config } from '../types/index.js';
  * finishes so that any open connections (e.g. MongoClient) are released.
  */
 export declare function createCacheBackend(config: Pick<Config, 'CACHE_BACKEND' | 'CACHE_DIR' | 'MONGODB_URI' | 'MONGODB_DATABASE' | 'CACHE_TTL_SECONDS'>, disabled: boolean): Promise<CacheBackend>;
-//# sourceMappingURL=cacheFactory.d.ts.map
+//# sourceMappingURL=factory.d.ts.map

package/dist/lib/services/cache/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/cache/factory.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,IAAI,CACV,MAAM,EACN,eAAe,GAAG,WAAW,GAAG,aAAa,GAAG,kBAAkB,GAAG,mBAAmB,CACzF,EACD,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,YAAY,CAAC,CAgBvB"}

package/dist/lib/{utils/cacheFactory.js → services/cache/factory.js}

@@ -1,8 +1,8 @@
 import { MongoClient } from 'mongodb';
-import { log } from './logger.js';
-import { FileCacheBackend } from './fileCacheBackend.js';
-import { MongoCacheBackend } from './mongoCacheBackend.js';
-import { DisabledCacheBackend } from './cacheBackend.js';
+import { log } from '../../utils/logger.js';
+import { FileCacheBackend } from './backends/file.js';
+import { MongoCacheBackend } from './backends/mongo.js';
+import { DisabledCacheBackend } from './backends/disabled.js';
 /**
  * Creates the appropriate CacheBackend based on config.
  *
@@ -20,7 +20,7 @@ export async function createCacheBackend(config, disabled) {
     if (config.CACHE_BACKEND === 'mongodb') {
         // MONGODB_URI is guaranteed to be set by the superRefine in ConfigSchema
         const uri = config.MONGODB_URI;
-        log.info(`[cache] Using MongoDB backend (${config.MONGODB_DATABASE})`);
+        log.info('createCacheBackend', `[cache] Using MongoDB backend (${config.MONGODB_DATABASE})`);
         const client = new MongoClient(uri);
         await client.connect();
         return new MongoCacheBackend(client, config.MONGODB_DATABASE, config.CACHE_TTL_SECONDS);
@@ -28,4 +28,4 @@ export async function createCacheBackend(config, disabled) {
     // Default: file-based backend
     return new FileCacheBackend(config.CACHE_DIR);
 }
-//# sourceMappingURL=cacheFactory.js.map
+//# sourceMappingURL=factory.js.map

package/dist/lib/services/cache/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../src/lib/services/cache/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAI9D;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAGC,EACD,QAAiB;IAEjB,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,IAAI,oBAAoB,EAAE,CAAC;IACpC,CAAC;IAED,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACvC,yEAAyE;QACzE,MAAM,GAAG,GAAG,MAAM,CAAC,WAAqB,CAAC;QACzC,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,kCAAkC,MAAM,CAAC,gBAAgB,GAAG,CAAC,CAAC;QAC7F,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,OAAO,IAAI,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC1F,CAAC;IAED,8BAA8B;IAC9B,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AAChD,CAAC"}

package/dist/lib/services/cache/index.d.ts

@@ -0,0 +1,4 @@
+export { Cache } from './cache.js';
+export { createCacheBackend } from './factory.js';
+export type { CacheBackend } from '../../types/cache.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/services/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/lib/services/cache/index.js

@@ -0,0 +1,3 @@
+export { Cache } from './cache.js';
+export { createCacheBackend } from './factory.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/services/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/services/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/lib/services/cache/manifest.d.ts

@@ -0,0 +1,6 @@
+import type { ClearVideoAnalysisResult, ClearVideoTranscriptResult } from '../../types/cache.js';
+export declare function appendChunkHash(cacheDir: string, videoId: string, hash: string): Promise<void>;
+export declare function appendSegmentHash(cacheDir: string, videoId: string, hash: string): Promise<void>;
+export declare function clearVideoAnalysisManifest(cacheDir: string, videoId: string): Promise<ClearVideoAnalysisResult>;
+export declare function clearVideoTranscriptCache(cacheDir: string, videoId: string): Promise<ClearVideoTranscriptResult>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/lib/services/cache/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/cache/manifest.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,wBAAwB,EACxB,0BAA0B,EAC3B,MAAM,qBAAqB,CAAC;AAwB7B,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,wBAAwB,CAAC,CAuCnC;AAED,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,0BAA0B,CAAC,CAQrC"}

package/dist/lib/services/cache/manifest.js

@@ -0,0 +1,101 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+import { log } from '../../utils/logger.js';
+import { computeVideoCacheKey } from './backends/file.js';
+function manifestPath(cacheDir, videoId) {
+    return path.join(cacheDir, 'manifests', `${computeVideoCacheKey(videoId)}.json`);
+}
+async function readManifest(filePath) {
+    try {
+        const raw = await fs.readFile(filePath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return {
+            chunkHashes: Array.isArray(parsed?.chunkHashes) ? parsed.chunkHashes : [],
+            segmentHashes: Array.isArray(parsed?.segmentHashes) ? parsed.segmentHashes : [],
+        };
+    }
+    catch {
+        return { chunkHashes: [], segmentHashes: [] };
+    }
+}
+async function writeManifest(filePath, manifest) {
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.writeFile(filePath, JSON.stringify(manifest, null, 2), 'utf-8');
+}
+export async function appendChunkHash(cacheDir, videoId, hash) {
+    try {
+        const filePath = manifestPath(cacheDir, videoId);
+        const manifest = await readManifest(filePath);
+        if (!manifest.chunkHashes.includes(hash)) {
+            manifest.chunkHashes.push(hash);
+            await writeManifest(filePath, manifest);
+        }
+    }
+    catch (err) {
+        log.warn('appendChunkHash', `Failed to append chunk hash: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+export async function appendSegmentHash(cacheDir, videoId, hash) {
+    try {
+        const filePath = manifestPath(cacheDir, videoId);
+        const manifest = await readManifest(filePath);
+        if (!manifest.segmentHashes.includes(hash)) {
+            manifest.segmentHashes.push(hash);
+            await writeManifest(filePath, manifest);
+        }
+    }
+    catch (err) {
+        log.warn('appendSegmentHash', `Failed to append segment hash: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+export async function clearVideoAnalysisManifest(cacheDir, videoId) {
+    const filePath = manifestPath(cacheDir, videoId);
+    let manifestExisted = false;
+    let chunksDeleted = 0;
+    let segmentsDeleted = 0;
+    let manifest;
+    try {
+        await fs.access(filePath);
+        manifestExisted = true;
+        manifest = await readManifest(filePath);
+    }
+    catch {
+        return { manifestExisted, chunksDeleted, segmentsDeleted };
+    }
+    for (const hash of manifest.chunkHashes) {
+        try {
+            await fs.unlink(path.join(cacheDir, 'chunks', `${hash}.json`));
+            chunksDeleted += 1;
+        }
+        catch {
+            // already gone
+        }
+    }
+    for (const hash of manifest.segmentHashes) {
+        try {
+            await fs.unlink(path.join(cacheDir, 'segments', `${hash}.json`));
+            segmentsDeleted += 1;
+        }
+        catch {
+            // already gone
+        }
+    }
+    try {
+        await fs.unlink(filePath);
+    }
+    catch {
+        // best-effort
+    }
+    return { manifestExisted, chunksDeleted, segmentsDeleted };
+}
+export async function clearVideoTranscriptCache(cacheDir, videoId) {
+    const filePath = path.join(cacheDir, 'transcript', `${computeVideoCacheKey(videoId)}.json`);
+    try {
+        await fs.unlink(filePath);
+        return { deleted: true };
+    }
+    catch {
+        return { deleted: false };
+    }
+}
+//# sourceMappingURL=manifest.js.map

package/dist/lib/services/cache/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../../src/lib/services/cache/manifest.ts"],"names":[],"mappings":"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"}

package/dist/lib/services/video/clipper/editor/drawtextBuilder.d.ts

@@ -0,0 +1,6 @@
+import type { TextOverlay } from '../../../../types/clipEdit.js';
+export declare function buildDrawtext(overlay: TextOverlay, output: {
+    width: number;
+    height: number;
+}, trimStartSec?: number): string;
+//# sourceMappingURL=drawtextBuilder.d.ts.map

package/dist/lib/services/video/clipper/editor/drawtextBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawtextBuilder.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/services/video/clipper/editor/drawtextBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAI1D,wBAAgB,aAAa,CAC3B,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACzC,YAAY,GAAE,MAAU,GACvB,MAAM,CA0CR"}

package/dist/lib/services/video/clipper/editor/drawtextBuilder.js

@@ -0,0 +1,42 @@
+import { resolveRenderedFontSize } from '../../../../utils/textScale.js';
+import { escapeDrawtext } from './textEscape.js';
+export function buildDrawtext(overlay, output, trimStartSec = 0) {
+    const xPx = Math.round(overlay.position.xCenter * output.width);
+    const yPx = Math.round(overlay.position.yCenter * output.height);
+    const renderedSize = resolveRenderedFontSize(overlay.style.fontSize, output);
+    // Mirror the canvas transform: translate(-50%, -50%) for center, (0, -50%) for left,
+    // (-100%, -50%) for right — so xCenter is always the semantic anchor.
+    let xExpr;
+    if (overlay.style.align === 'left') {
+        xExpr = `${xPx}`;
+    }
+    else if (overlay.style.align === 'right') {
+        xExpr = `(${xPx}-tw)`;
+    }
+    else {
+        xExpr = `(${xPx}-tw/2)`;
+    }
+    // Shift the enable window into the output (trimmed) timeline so the overlay
+    // appears at the correct time relative to the 0-based output video.
+    const enableStart = Math.max(0, overlay.startSec - trimStartSec);
+    const enableEnd = Math.max(0, overlay.endSec - trimStartSec);
+    const parts = [
+        `text='${escapeDrawtext(overlay.text)}'`,
+        `enable='between(t,${enableStart},${enableEnd})'`,
+        `x=${xExpr}`,
+        `y=(${yPx}-th/2)`,
+        `fontsize=${renderedSize}`,
+        `fontcolor=${overlay.style.color}`,
+    ];
+    if (overlay.style.outlineColor !== null) {
+        parts.push(`borderw=${overlay.style.outlineWidth}`);
+        parts.push(`bordercolor=${overlay.style.outlineColor}`);
+    }
+    if (overlay.style.bgColor !== null) {
+        parts.push(`box=1`);
+        parts.push(`boxcolor=${overlay.style.bgColor}`);
+        parts.push(`boxborderw=${overlay.style.bgPaddingX}`);
+    }
+    return `drawtext=${parts.join(':')}`;
+}
+//# sourceMappingURL=drawtextBuilder.js.map

package/dist/lib/services/video/clipper/editor/drawtextBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawtextBuilder.js","sourceRoot":"","sources":["../../../../../../src/lib/services/video/clipper/editor/drawtextBuilder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,UAAU,aAAa,CAC3B,OAAoB,EACpB,MAAyC,EACzC,eAAuB,CAAC;IAExB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAChE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACjE,MAAM,YAAY,GAAG,uBAAuB,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAE7E,qFAAqF;IACrF,sEAAsE;IACtE,IAAI,KAAa,CAAC;IAClB,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QACnC,KAAK,GAAG,GAAG,GAAG,EAAE,CAAC;IACnB,CAAC;SAAM,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;QAC3C,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;IACxB,CAAC;SAAM,CAAC;QACN,KAAK,GAAG,IAAI,GAAG,QAAQ,CAAC;IAC1B,CAAC;IAED,4EAA4E;IAC5E,oEAAoE;IACpE,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,GAAG,YAAY,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC;IAE7D,MAAM,KAAK,GAAa;QACtB,SAAS,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG;QACxC,qBAAqB,WAAW,IAAI,SAAS,IAAI;QACjD,KAAK,KAAK,EAAE;QACZ,MAAM,GAAG,QAAQ;QACjB,YAAY,YAAY,EAAE;QAC1B,aAAa,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE;KACnC,CAAC;IAEF,IAAI,OAAO,CAAC,KAAK,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,eAAe,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,cAAc,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,YAAY,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AACvC,CAAC"}

package/dist/lib/services/video/clipper/editor/filterGraphBuilder.d.ts

@@ -0,0 +1,7 @@
+import type { ClipEdits, FilterGraphResult } from '../../../../types/clipEdit.js';
+export declare function buildFilterGraph(edits: ClipEdits, srcMeta: {
+    width: number;
+    height: number;
+    fps: number;
+}, assPath: string | null): FilterGraphResult;
+//# sourceMappingURL=filterGraphBuilder.d.ts.map

package/dist/lib/services/video/clipper/editor/filterGraphBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterGraphBuilder.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/services/video/clipper/editor/filterGraphBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAS3E,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACvD,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB,iBAAiB,CA8BnB"}

package/dist/lib/services/video/clipper/editor/filterGraphBuilder.js

@@ -0,0 +1,58 @@
+import { buildDrawtext } from './drawtextBuilder.js';
+const RESOLUTIONS = {
+    '16:9': { w: 1920, h: 1080 },
+    '9:16': { w: 1080, h: 1920 },
+    '1:1': { w: 1080, h: 1080 },
+};
+export function buildFilterGraph(edits, srcMeta, assPath) {
+    const { w: oW, h: oH } = RESOLUTIONS[edits.viewport.preset];
+    const segments = [];
+    let labelN = 0;
+    const reframeResult = buildReframe(edits, srcMeta, oW, oH, labelN);
+    segments.push(reframeResult.filter);
+    labelN = reframeResult.nextN;
+    for (const overlay of edits.overlays) {
+        const inLabel = `[v${labelN - 1}]`;
+        const outLabel = `[v${labelN}]`;
+        segments.push(`${inLabel}${buildDrawtext(overlay, { width: oW, height: oH }, edits.trim.startSec)}${outLabel}`);
+        labelN++;
+    }
+    if (assPath !== null && edits.subtitles.length > 0) {
+        const inLabel = `[v${labelN - 1}]`;
+        const outLabel = `[v${labelN}]`;
+        const escapedPath = assPath.replace(/:/g, '\\:');
+        segments.push(`${inLabel}subtitles='${escapedPath}'${outLabel}`);
+        labelN++;
+    }
+    const mapLabel = `[v${labelN - 1}]`;
+    const filterComplex = segments.join(';');
+    return { filterComplex, mapLabel };
+}
+function buildReframe(edits, srcMeta, oW, oH, n) {
+    const { fillMode, focus } = edits.viewport;
+    const outLabel = `[v${n}]`;
+    if (fillMode === 'crop') {
+        const cropX = Math.max(0, Math.min(srcMeta.width - oW, Math.round(focus.xCenter * srcMeta.width - oW / 2)));
+        const cropY = Math.max(0, Math.min(srcMeta.height - oH, Math.round(focus.yCenter * srcMeta.height - oH / 2)));
+        return {
+            filter: `[0:v]crop=${oW}:${oH}:${cropX}:${cropY}${outLabel}`,
+            nextN: n + 1,
+        };
+    }
+    if (fillMode === 'pad-blur') {
+        const bgLabel = `[bg${n}]`;
+        const fgLabel = `[fg${n}]`;
+        const filter = [
+            `[0:v]scale=${oW}:${oH}:force_original_aspect_ratio=decrease,boxblur=20${bgLabel}`,
+            `[0:v]scale=${oW}:-2:force_original_aspect_ratio=decrease${fgLabel}`,
+            `${bgLabel}${fgLabel}overlay=(W-w)/2:(H-h)/2${outLabel}`,
+        ].join(';');
+        return { filter, nextN: n + 1 };
+    }
+    // pad-black
+    return {
+        filter: `[0:v]scale=${oW}:-2:force_original_aspect_ratio=decrease,pad=${oW}:${oH}:(ow-iw)/2:(oh-ih)/2:black${outLabel}`,
+        nextN: n + 1,
+    };
+}
+//# sourceMappingURL=filterGraphBuilder.js.map

package/dist/lib/services/video/clipper/editor/filterGraphBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterGraphBuilder.js","sourceRoot":"","sources":["../../../../../../src/lib/services/video/clipper/editor/filterGraphBuilder.ts"],"names":[],"mappings":"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"}