@thunderkiller/video-clipper 1.6.0 → 1.8.0

package/README.md

@@ -1,5 +1,9 @@
 # @thunderkiller/video-clipper
 
+[![CI](https://github.com/AmreetKumarkhuntia/video-clipper/actions/workflows/ci.yml/badge.svg)](https://github.com/AmreetKumarkhuntia/video-clipper/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/@thunderkiller/video-clipper.svg)](https://www.npmjs.com/package/@thunderkiller/video-clipper)
+[![license](https://img.shields.io/npm/l/@thunderkiller/video-clipper.svg)](https://github.com/AmreetKumarkhuntia/video-clipper/blob/master/LICENSE)
+
 A TypeScript CLI (and library) that analyzes a YouTube video with an LLM, finds the most interesting moments, and optionally downloads the video and cuts clips automatically.
 
 ## How It Works
@@ -137,13 +141,22 @@ await runPipeline(args);
 
 All public types and Zod schemas are exported from the package root. See [src/lib.ts](src/lib.ts) for the full surface.
 
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feat/my-feature`)
+3. Commit with [Conventional Commits](https://www.conventionalcommits.org/) — enforced by commitlint
+4. Push and open a Pull Request
+
+Pre-commit hooks run automatically: formatting (Prettier), type-check, and tests. Make sure `yt-dlp` and `ffmpeg` are installed locally.
+
 ## Documentation
 
-| Doc                                              | Description                                                           |
-| ------------------------------------------------ | --------------------------------------------------------------------- |
-| [docs/configuration.md](docs/configuration.md)   | Full environment variable reference, provider setup, FFmpeg presets   |
-| [docs/advanced-usage.md](docs/advanced-usage.md) | Advanced CLI examples, caching, pre-downloaded videos                 |
-| [docs/audio-sync.md](docs/audio-sync.md)         | Audio/video sync troubleshooting and `TIMESTAMP_OFFSET_SECONDS` guide |
-| [docs/yt-downloader.md](docs/yt-downloader.md)   | yt-dlp download modes explained                                       |
-| [docs/free-models.md](docs/free-models.md)       | Free models that work well with this tool                             |
-| [docs/plan.md](docs/plan.md)                     | Full architecture and pipeline design                                 |
+| Doc                                              | Description                                                                                   |
+| ------------------------------------------------ | --------------------------------------------------------------------------------------------- |
+| [docs/configuration.md](docs/configuration.md)   | Full environment variable reference, provider setup, FFmpeg presets, yt-dlp cookie auth guide |
+| [docs/advanced-usage.md](docs/advanced-usage.md) | Advanced CLI examples, caching, pre-downloaded videos                                         |
+| [docs/audio-sync.md](docs/audio-sync.md)         | Audio/video sync troubleshooting and `TIMESTAMP_OFFSET_SECONDS` guide                         |
+| [docs/yt-downloader.md](docs/yt-downloader.md)   | yt-dlp download modes, transcript bot-detection errors, and cookie troubleshooting            |
+| [docs/free-models.md](docs/free-models.md)       | Free models that work well with this tool                                                     |
+| [docs/plan.md](docs/plan.md)                     | Full architecture and pipeline design                                                         |

package/dist/{cli.d.ts → app/cli/args.d.ts}

@@ -1,5 +1,5 @@
-import type { CliArgs } from './types/index.js';
+import type { CliArgs } from '../../lib/types/index.js';
 export type { CliArgs };
 export declare function parseArgs(argv: string[]): CliArgs;
 export declare function printUsage(): void;
-//# sourceMappingURL=cli.d.ts.map
+//# sourceMappingURL=args.d.ts.map

package/dist/app/cli/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../../src/app/cli/args.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,YAAY,EAAE,OAAO,EAAE,CAAC;AAMxB,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CA+HjD;AAMD,wBAAgB,UAAU,IAAI,IAAI,CA0CjC"}

package/dist/{cli.js → app/cli/args.js}

@@ -1,5 +1,5 @@
-import { config } from './config/index.js';
-import { log } from './utils/logger.js';
+import { config } from '../../lib/config/index.js';
+import { log } from '../../lib/utils/logger.js';
 // ---------------------------------------------------------------------------
 // Argument parser
 // ---------------------------------------------------------------------------
@@ -185,4 +185,4 @@ Examples:
   npm run start -- https://youtube.com/watch?v=dQw4w9WgXcQ --max-parallel 5
 `.trim());
 }
-//# sourceMappingURL=cli.js.map
+//# sourceMappingURL=args.js.map

package/dist/app/cli/args.js.map

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

package/dist/{index.d.ts.map → app/cli/index.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/app/cli/index.ts"],"names":[],"mappings":""}

package/dist/{index.js → app/cli/index.js}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { log } from './utils/logger.js';
-import { formatConfig } from './utils/format.js';
-import { config } from './config/index.js';
-import { parseArgs, printUsage } from './cli.js';
+import { log } from '../../lib/utils/logger.js';
+import { formatConfig } from '../../lib/utils/format.js';
+import { config } from '../../lib/config/index.js';
+import { parseArgs, printUsage } from './args.js';
 import { runPipeline } from './pipeline/runner.js';
 const args = parseArgs(process.argv);
 if (args.help) {

package/dist/app/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/app/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAErC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,UAAU,EAAE,CAAC;IACb,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IACd,GAAG,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACtC,UAAU,EAAE,CAAC;IACb,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAClC,GAAG,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAChD,UAAU,EAAE,CAAC;IACb,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC7C,GAAG,CAAC,IAAI,CACN,8FAA8F,CAC/F,CAAC;AACJ,CAAC;AAED,GAAG,CAAC,IAAI,CACN,kCAAkC,MAAM,CAAC,SAAS,GAAG;IACnD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;IACtC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,oBAAoB,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,CAAC,IAAI,CAAC,gBAAgB,KAAK,SAAS,IAAI,IAAI,CAAC,gBAAgB,KAAK,KAAK;QACrE,CAAC,CAAC,0BAA0B,IAAI,CAAC,gBAAgB,GAAG;QACpD,CAAC,CAAC,EAAE,CAAC;IACP,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAC/D,CAAC;AACF,GAAG,CAAC,IAAI,CAAC,WAAW,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE5C,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC9B,GAAG,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/{pipeline → app/cli/pipeline}/dumper.d.ts

@@ -1,4 +1,4 @@
-import type { TranscriptLine, PipelineResult } from '../types/index.js';
+import type { TranscriptLine, PipelineResult } from '../../../lib/types/index.js';
 /**
  * Writes the raw normalized transcript lines to
  * `{OUTPUT_DIR}/transcript/{videoId}.json`.

package/dist/app/cli/pipeline/dumper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dumper.d.ts","sourceRoot":"","sources":["../../../../src/app/cli/pipeline/dumper.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1E;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAY5F;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAYzF"}

package/dist/{pipeline → app/cli/pipeline}/dumper.js

@@ -1,7 +1,7 @@
 import { promises as fs } from 'fs';
 import path from 'path';
-import { config } from '../config/index.js';
-import { log } from '../utils/logger.js';
+import { config } from '../../../lib/config/index.js';
+import { log } from '../../../lib/utils/logger.js';
 /**
  * Writes the raw normalized transcript lines to
  * `{OUTPUT_DIR}/transcript/{videoId}.json`.

package/dist/app/cli/pipeline/dumper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dumper.js","sourceRoot":"","sources":["../../../../src/app/cli/pipeline/dumper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAG3C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAe,EAAE,KAAuB;IAC3E,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QACvD,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,OAAO,CAAC,CAAC;QACnD,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACtE,GAAG,CAAC,IAAI,CAAC,wBAAwB,QAAQ,EAAE,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CACN,iCAAiC,OAAO,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAChG,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAe,EAAE,MAAsB;IACxE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QACrD,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,OAAO,CAAC,CAAC;QACnD,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACvE,GAAG,CAAC,IAAI,CAAC,sBAAsB,QAAQ,EAAE,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CACN,+BAA+B,OAAO,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC9F,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/{pipeline → app/cli/pipeline}/runner.d.ts

@@ -1,4 +1,4 @@
-import type { CliArgs } from '../types/index.js';
+import type { CliArgs } from '../../../lib/types/index.js';
 /**
  * Runs the full video-clipper pipeline for the given CLI arguments.
  *

package/dist/app/cli/pipeline/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../../src/app/cli/pipeline/runner.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,OAAO,EAAkB,MAAM,qBAAqB,CAAC;AAenE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAuO9D"}

package/dist/app/cli/pipeline/runner.js

@@ -0,0 +1,248 @@
+import { promises as fs } from 'fs';
+import { config } from '../../../lib/config/index.js';
+import { Cache } from '../../../lib/utils/cache.js';
+import { createCacheBackend } from '../../../lib/utils/cacheFactory.js';
+import { log } from '../../../lib/utils/logger.js';
+import { getModel } from '../../../lib/utils/modelFactory.js';
+import { dumpAnalysis, dumpTranscript } from './dumper.js';
+import { resolveVideo } from './stages/videoResolver.js';
+import { processAudio } from './stages/audioProcessor.js';
+import { analyzeSegments, refineRankedSegments } from '../../../lib/pipeline/stages/segmentAnalyzer.js';
+import { selectSegments } from '../../../lib/pipeline/stages/segmentSelector.js';
+import { exportClips } from '../../../lib/pipeline/stages/clipExporter.js';
+import { downloadAudio } from '../../../lib/services/audio/source/youtube.js';
+async function outputResult(result, outputJsonPath) {
+    const json = JSON.stringify(result, null, 2);
+    if (outputJsonPath) {
+        await fs.writeFile(outputJsonPath, json, 'utf-8');
+        log.info(`Output written to ${outputJsonPath}`);
+    }
+    else {
+        console.log('\n' + json);
+    }
+}
+/**
+ * Runs the full video-clipper pipeline for the given CLI arguments.
+ *
+ * Stage ordering:
+ *   1. resolveVideo         — parse URL, extract video ID + metadata
+ *   2. downloadAudio        — download WAV so Whisper/Gemini transcript providers can use it
+ *   3. processAudio         — detect audio events per window (reuses downloaded WAV)
+ *   4a. analyzeSegments     — fetch transcript + LLM pass 1 (informed by audio events)
+ *   5. selectSegments       — merge signals, rank, threshold filter
+ *   4b. refineRankedSegments — LLM pass 2 to tighten clip boundaries
+ *   6. exportClips          — download video + run ffmpeg (only if --clip)
+ *
+ * downloadAudio runs before analyzeSegments so that `audioPath` is available
+ * for Whisper/Gemini transcript providers. processAudio reuses the same WAV.
+ *
+ * Hard errors (invalid URL, transcript failure, all LLM chunks failed) are
+ * thrown so the caller can catch, log, and exit(1). Soft failures (audio
+ * detection, individual clip failures) are logged as warnings and the pipeline
+ * continues.
+ */
+export async function runPipeline(args) {
+    const threshold = args.threshold ?? config.SCORE_THRESHOLD;
+    const topN = args.topN ?? config.TOP_N_SEGMENTS;
+    const gameProfile = args.gameProfile ?? config.GAME_PROFILE;
+    const maxParallel = args.maxParallel ?? config.LLM_CONCURRENCY;
+    const cookies = {
+        cookiesFromBrowser: config.YT_DLP_COOKIES_FROM_BROWSER,
+        cookiesFile: config.YT_DLP_COOKIES_FILE,
+        quiet: config.YT_DLP_QUIET,
+        retryCount: config.YT_DLP_RETRY_COUNT,
+        segmentCookiesEnabled: config.YT_DLP_SEGMENT_COOKIES_ENABLED,
+        playerClient: config.YT_DLP_PLAYER_CLIENT,
+        noCheckCertificates: config.YT_DLP_NO_CHECK_CERTIFICATES,
+        forceIpv4: config.YT_DLP_FORCE_IPV4,
+        geoBypass: config.YT_DLP_GEO_BYPASS,
+        sleepRequests: config.YT_DLP_SLEEP_REQUESTS,
+    };
+    const audioDownloadConfig = {
+        ...cookies,
+        ffmpegPath: config.FFMPEG_PATH,
+    };
+    const slicerConfig = {
+        ffmpegPath: config.FFMPEG_PATH,
+        ffprobePath: config.FFPROBE_PATH,
+    };
+    const clipperConfig = {
+        ffmpegPath: config.FFMPEG_PATH,
+        ffprobePath: config.FFPROBE_PATH,
+        timestampOffset: config.TIMESTAMP_OFFSET_SECONDS,
+        ffmpegPreset: config.FFMPEG_PRESET,
+        outputDir: config.OUTPUT_DIR,
+    };
+    const downloaderConfig = {
+        ...cookies,
+        downloadDir: config.DOWNLOAD_DIR,
+        timestampOffset: config.TIMESTAMP_OFFSET_SECONDS,
+        llmConcurrency: config.LLM_CONCURRENCY,
+    };
+    const analyzerChainConfig = {
+        confidenceThreshold: config.AUDIO_CONFIDENCE_THRESHOLD,
+        whisperModel: config.AUDIO_WHISPER_MODEL,
+        gemini: {
+            apiKey: config.GOOGLE_GENERATIVE_AI_API_KEY,
+            model: config.AUDIO_GEMINI_MODEL,
+            extraInstructions: config.AUDIO_EXTRA_INSTRUCTIONS,
+        },
+    };
+    const transcriptChainConfig = {
+        ...cookies,
+        whisperModel: config.AUDIO_WHISPER_MODEL,
+    };
+    const model = getModel(config.LLM_PROVIDER, config.LLM_MODEL, {
+        ZAI_API_KEY: config.ZAI_API_KEY,
+        OPENROUTER_API_KEY: config.OPENROUTER_API_KEY,
+        CUSTOM_OPENAI_BASE_URL: config.CUSTOM_OPENAI_BASE_URL,
+        CUSTOM_OPENAI_API_KEY: config.CUSTOM_OPENAI_API_KEY,
+    });
+    const backend = await createCacheBackend(config, args.noCache);
+    const cache = new Cache(backend);
+    try {
+        const { videoId, metadata } = await resolveVideo(args.url, args.maxDuration, cookies);
+        let audioPath = null;
+        const audioEnabled = config.AUDIO_DETECTION_ENABLED && !args.noAudio;
+        if (audioEnabled) {
+            try {
+                audioPath = await downloadAudio(videoId, `${config.OUTPUT_DIR}/audio`, audioDownloadConfig);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                log.warn(`Audio download failed — continuing without audio: ${message}`);
+            }
+        }
+        const audioProcConfig = {
+            audioEnabled: config.AUDIO_DETECTION_ENABLED,
+            audioProvider: config.AUDIO_PROVIDER,
+            chunkLengthSec: config.CHUNK_LENGTH_SEC,
+            chunkOverlapSec: config.CHUNK_OVERLAP_SEC,
+            outputDir: config.OUTPUT_DIR,
+            audioDownloadConfig,
+            slicerConfig,
+            analyzerChainConfig,
+        };
+        const audioEvents = await processAudio(videoId, metadata.duration, cache, {
+            noAudio: args.noAudio,
+            gameProfile,
+            maxParallel,
+            audioPath,
+        }, audioProcConfig);
+        const callbacks = {
+            onChunkTextDelta: (chunkIndex, text) => {
+                process.stdout.write(text);
+            },
+            onChunkAnalyzed: (chunkIndex, evaluation) => {
+                if (evaluation.status === 'success') {
+                    log.info(`  ✓ chunk ${chunkIndex}: interesting=${evaluation.interesting}, score=${evaluation.score}`);
+                }
+            },
+            onSegmentTextDelta: (rank, text) => {
+                process.stdout.write(text);
+            },
+            onSegmentRefined: (rank, segment) => {
+                log.info(`  ✓ segment rank=${rank}: ${segment.start.toFixed(1)}s–${segment.end.toFixed(1)}s`);
+            },
+        };
+        const { lines, microBlocks, chunkEvals } = await analyzeSegments(videoId, audioPath, audioEvents, cache, {
+            maxChunks: args.maxChunks,
+            maxParallel,
+            noCache: args.noCache,
+            transcriptProvider: config.TRANSCRIPT_PROVIDER,
+            transcriptChainConfig,
+            microBlockSec: config.MICRO_BLOCK_SEC,
+            chunkLengthSec: config.CHUNK_LENGTH_SEC,
+            chunkOverlapSec: config.CHUNK_OVERLAP_SEC,
+            model,
+            maxRetries: config.LLM_MAX_RETRIES,
+            systemPrompt: config.LLM_SYSTEM_PROMPT ?? DEFAULT_SYSTEM_PROMPT,
+            llmModel: config.LLM_MODEL,
+            callbacks,
+        });
+        if (config.DUMP_OUTPUTS) {
+            await dumpTranscript(videoId, lines);
+        }
+        const rankedSegments = selectSegments(chunkEvals, audioEvents, {
+            threshold,
+            topN,
+            boostWindow: config.AUDIO_LLM_BOOST_WINDOW,
+            scoreBoost: config.AUDIO_LLM_SCORE_BOOST,
+            preRoll: config.AUDIO_CLIP_PRE_ROLL,
+            postRoll: config.AUDIO_CLIP_POST_ROLL,
+        });
+        const partialResult = {
+            video_id: videoId,
+            title: metadata.title,
+            duration: metadata.duration,
+            chunk_evaluations: chunkEvals,
+            segments: rankedSegments,
+        };
+        if (rankedSegments.length === 0) {
+            await outputResult(partialResult, args.outputJson);
+            if (config.DUMP_OUTPUTS)
+                await dumpAnalysis(videoId, partialResult);
+            return;
+        }
+        const refinedSegments = await refineRankedSegments(rankedSegments, microBlocks, cache, {
+            maxParallel,
+            noCache: args.noCache,
+            maxRetries: config.LLM_MAX_RETRIES,
+            model,
+            callbacks,
+        });
+        const result = {
+            video_id: videoId,
+            title: metadata.title,
+            duration: metadata.duration,
+            chunk_evaluations: chunkEvals,
+            segments: refinedSegments,
+        };
+        await outputResult(result, args.outputJson);
+        if (config.DUMP_OUTPUTS)
+            await dumpAnalysis(videoId, result);
+        log.info('Done.');
+        if (!args.clip) {
+            log.info('Tip: run with --clip to download the video and generate mp4 clips.');
+            return;
+        }
+        const exporterConfig = {
+            downloader: downloaderConfig,
+            clipper: clipperConfig,
+            downloadSectionsMode: config.DOWNLOAD_SECTIONS_MODE,
+        };
+        const clipPaths = await exportClips(videoId, refinedSegments, {
+            localVideo: args.localVideo,
+            downloadSections: args.downloadSections,
+            videoPath: args.videoPath,
+            clipConcurrency: config.CLIP_CONCURRENCY,
+        }, exporterConfig);
+        if (clipPaths.length === 0) {
+            log.warn('No clips were generated successfully.');
+        }
+        else {
+            log.info(`Done — ${clipPaths.length} clip${clipPaths.length !== 1 ? 's' : ''} saved:`);
+            for (const p of clipPaths) {
+                log.info(`  ${p}`);
+            }
+        }
+    }
+    finally {
+        await cache.close();
+    }
+}
+const DEFAULT_SYSTEM_PROMPT = `You are an expert video editor analyzing a YouTube transcript segment.
+
+Identify if this segment contains a potentially interesting moment worth clipping.
+
+Interesting moments include:
+- surprising insights or revelations
+- strong or controversial opinions
+- humor or entertaining storytelling
+- emotional moments
+- key explanations of important concepts
+- "aha" moments or turning points
+
+If audio events are listed in the segment, treat them as strong positive signals —
+they indicate high-action or high-energy moments that are often clip-worthy.`;
+//# sourceMappingURL=runner.js.map

package/dist/app/cli/pipeline/runner.js.map

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

package/dist/app/cli/pipeline/stages/audioProcessor.d.ts

@@ -0,0 +1,17 @@
+import type { AudioDownloadConfig } from '../../../../lib/services/audio/source/youtube.js';
+import type { AnalyzerChainConfig } from '../../../../lib/services/audio/analyzer/index.js';
+import type { SlicerConfig } from '../../../../lib/services/audio/processor/slicer.js';
+import type { Cache } from '../../../../lib/utils/cache.js';
+import type { AudioEvent, AudioProcessorOpts } from '../../../../lib/types/index.js';
+export interface AudioProcessorConfig {
+    audioEnabled: boolean;
+    audioProvider: string;
+    chunkLengthSec: number;
+    chunkOverlapSec: number;
+    outputDir: string;
+    audioDownloadConfig: AudioDownloadConfig;
+    slicerConfig: SlicerConfig;
+    analyzerChainConfig: AnalyzerChainConfig;
+}
+export declare function processAudio(videoId: string, duration: number, cache: Cache, opts: AudioProcessorOpts, procConfig: AudioProcessorConfig): Promise<AudioEvent[]>;
+//# sourceMappingURL=audioProcessor.d.ts.map

package/dist/app/cli/pipeline/stages/audioProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioProcessor.d.ts","sourceRoot":"","sources":["../../../../../src/app/cli/pipeline/stages/audioProcessor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAEjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAGjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAG5E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE1E,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,YAAY,EAAE,YAAY,CAAC;IAC3B,mBAAmB,EAAE,mBAAmB,CAAC;CAC1C;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,kBAAkB,EACxB,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAAC,UAAU,EAAE,CAAC,CAkGvB"}

package/dist/{pipeline → app/cli/pipeline}/stages/audioProcessor.js

@@ -1,55 +1,40 @@
 import { promises as fs } from 'fs';
 import pLimit from 'p-limit';
-import { downloadAudio } from '../../services/audioDownloader/index.js';
-import { createAnalyzerChain } from '../../services/audioAnalyzers/index.js';
-import { EventDetector } from '../../services/eventDetector/index.js';
-import { sliceAudio } from '../../services/audioDownloader/sliceAudio.js';
-import { buildWindows } from '../../utils/chunker.js';
-import { log } from '../../utils/logger.js';
-import { config } from '../../config/index.js';
-/**
- * Stage 3 — Audio Processor
- *
- * Downloads audio-only WAV, slices it into chunks using the generic
- * `buildWindows` utility, runs event detection on each slice via an
- * EventDetector (constructed from the ordered provider chain in config),
- * and persists the results to cache.
- *
- * The provider chain is built once per run from `config.AUDIO_PROVIDER`
- * (e.g. "gemini,whisper") via `createAnalyzerChain`. The EventDetector
- * walks the chain in order, falling back to the next analyzer on failure.
- *
- * Returns an empty array immediately when audio detection is disabled via
- * `--no-audio` or the `AUDIO_DETECTION_ENABLED` config flag.
- */
-export async function processAudio(videoId, duration, cache, opts) {
-    const audioEnabled = config.AUDIO_DETECTION_ENABLED && !opts.noAudio;
+import { downloadAudio } from '../../../../lib/services/audio/source/youtube.js';
+import { createAnalyzerChain } from '../../../../lib/services/audio/analyzer/index.js';
+import { EventDetector } from '../../../../lib/services/audio/processor/detector.js';
+import { sliceAudio } from '../../../../lib/services/audio/processor/slicer.js';
+import { buildWindows } from '../../../../lib/utils/chunker.js';
+import { log } from '../../../../lib/utils/logger.js';
+export async function processAudio(videoId, duration, cache, opts, procConfig) {
+    const audioEnabled = procConfig.audioEnabled && !opts.noAudio;
     if (!audioEnabled)
         return [];
-    const cached = await cache.readAudioEvents(videoId, opts.gameProfile, config.AUDIO_PROVIDER);
+    const cached = await cache.readAudioEvents(videoId, opts.gameProfile, procConfig.audioProvider);
     if (cached) {
         log.info(`[cache hit] Audio events loaded from cache (${cached.length} events)`);
         return cached;
     }
     try {
-        const audioPath = opts.audioPath ?? (await downloadAudio(videoId, `${config.OUTPUT_DIR}/audio`));
-        const chain = createAnalyzerChain(config.AUDIO_PROVIDER);
+        const audioPath = opts.audioPath ??
+            (await downloadAudio(videoId, `${procConfig.outputDir}/audio`, procConfig.audioDownloadConfig));
+        const chain = createAnalyzerChain(procConfig.audioProvider, procConfig.analyzerChainConfig);
         const detector = new EventDetector(chain);
         const providerNames = chain.map((a) => a.source).join(' → ');
         log.info(`Detecting audio events (chain: ${providerNames}, profile: ${opts.gameProfile}, max ${opts.maxParallel} parallel)...`);
-        const windows = buildWindows(duration, config.CHUNK_LENGTH_SEC, config.CHUNK_OVERLAP_SEC);
+        const windows = buildWindows(duration, procConfig.chunkLengthSec, procConfig.chunkOverlapSec);
         const limit = pLimit(opts.maxParallel);
         const results = await Promise.allSettled(windows.map((window) => limit(async () => {
             log.info(`  Processing audio chunk ${window.start}s - ${window.end}s...`);
-            const cachedChunk = await cache.readAudioChunk(videoId, opts.gameProfile, config.AUDIO_PROVIDER, window.start, window.end);
+            const cachedChunk = await cache.readAudioChunk(videoId, opts.gameProfile, procConfig.audioProvider, window.start, window.end);
             if (cachedChunk) {
                 log.info(`  [cache hit] Audio chunk ${window.start}s - ${window.end}s (${cachedChunk.length} events)`);
                 return cachedChunk;
             }
-            const slicePath = await sliceAudio(audioPath, window.start, window.end - window.start, config.OUTPUT_DIR);
+            const slicePath = await sliceAudio(audioPath, window.start, window.end - window.start, procConfig.outputDir, procConfig.slicerConfig);
             const events = await detector.detect(slicePath, opts.gameProfile, window.start, window.end - window.start);
             await fs.unlink(slicePath);
-            await cache.writeAudioChunk(videoId, opts.gameProfile, config.AUDIO_PROVIDER, window.start, window.end, events);
+            await cache.writeAudioChunk(videoId, opts.gameProfile, procConfig.audioProvider, window.start, window.end, events);
             return events;
         })));
         const audioEvents = results
@@ -62,7 +47,7 @@ export async function processAudio(videoId, duration, cache, opts) {
         })
             .sort((a, b) => a.time - b.time);
         log.info(`Audio event detection complete: ${audioEvents.length} events found`);
-        await cache.writeAudioEvents(videoId, opts.gameProfile, config.AUDIO_PROVIDER, audioEvents);
+        await cache.writeAudioEvents(videoId, opts.gameProfile, procConfig.audioProvider, audioEvents);
         return audioEvents;
     }
     catch (err) {

package/dist/app/cli/pipeline/stages/audioProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioProcessor.js","sourceRoot":"","sources":["../../../../../src/app/cli/pipeline/stages/audioProcessor.ts"],"names":[],"mappings":"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"}

package/dist/app/cli/pipeline/stages/videoResolver.d.ts

@@ -0,0 +1,4 @@
+import type { YtDlpCookies } from '../../../../lib/services/video/source/youtube/metadata.js';
+import type { VideoResolverResult } from '../../../../lib/types/index.js';
+export declare function resolveVideo(rawUrl: string, maxDurationSec: number | undefined, cookies: YtDlpCookies): Promise<VideoResolverResult>;
+//# sourceMappingURL=videoResolver.d.ts.map

package/dist/app/cli/pipeline/stages/videoResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"videoResolver.d.ts","sourceRoot":"","sources":["../../../../../src/app/cli/pipeline/stages/videoResolver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gDAAgD,CAAC;AAGnF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,mBAAmB,CAAC,CAwB9B"}

package/dist/{pipeline → app/cli/pipeline}/stages/videoResolver.js

@@ -1,16 +1,8 @@
-import { parseUrl } from '../../services/urlParser/index.js';
-import { extractMetadata } from '../../services/metadataExtractor/index.js';
-import { log } from '../../utils/logger.js';
-import { formatSeconds } from '../../utils/format.js';
-/**
- * Stage 1 — Video Resolver
- *
- * Parses a raw YouTube URL into a validated video ID, fetches metadata
- * (title + duration), and enforces the optional --max-duration guard.
- *
- * @throws {Error} on invalid URL, metadata fetch failure, or exceeded duration
- */
-export async function resolveVideo(rawUrl, maxDurationSec) {
+import { parseUrl } from '../../../../lib/services/video/source/youtube/parser.js';
+import { extractMetadata } from '../../../../lib/services/video/source/youtube/metadata.js';
+import { log } from '../../../../lib/utils/logger.js';
+import { formatSeconds } from '../../../../lib/utils/format.js';
+export async function resolveVideo(rawUrl, maxDurationSec, cookies) {
     let videoId;
     try {
         videoId = parseUrl(rawUrl);
@@ -19,7 +11,7 @@ export async function resolveVideo(rawUrl, maxDurationSec) {
         throw new Error(`Invalid YouTube URL: ${rawUrl}`);
     }
     log.info(`Fetching metadata for ${videoId}...`);
-    const metadata = await extractMetadata(videoId);
+    const metadata = await extractMetadata(videoId, cookies);
     log.info(`Video: "${metadata.title}" (${metadata.duration > 0 ? formatSeconds(metadata.duration) : 'duration unknown'})`);
     if (maxDurationSec !== undefined && metadata.duration > 0) {
         if (metadata.duration > maxDurationSec) {

package/dist/app/cli/pipeline/stages/videoResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"videoResolver.js","sourceRoot":"","sources":["../../../../../src/app/cli/pipeline/stages/videoResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,8CAA8C,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAEjF,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,cAAkC,EAClC,OAAqB;IAErB,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,yBAAyB,OAAO,KAAK,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACzD,GAAG,CAAC,IAAI,CACN,WAAW,QAAQ,CAAC,KAAK,MAAM,QAAQ,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,kBAAkB,GAAG,CAChH,CAAC;IAEF,IAAI,cAAc,KAAK,SAAS,IAAI,QAAQ,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QAC1D,IAAI,QAAQ,CAAC,QAAQ,GAAG,cAAc,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CACb,+CAA+C;gBAC7C,IAAI,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,aAAa,CAAC,cAAc,CAAC,GAAG,CAC7E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC"}

package/dist/app/web/lib/activity/analysisActivity.d.ts

@@ -0,0 +1,20 @@
+import type { ChunkEvaluation, RankedSegment } from '../../../../lib/types/index.js';
+import type { AnalysisActivityItem, ActivityStatus } from '../../types/activity.js';
+export interface AnalysisActivityState {
+    items: AnalysisActivityItem[];
+    nextId: number;
+}
+export declare function createInitialActivityState(): AnalysisActivityState;
+export declare function createStartedActivityState(): AnalysisActivityState;
+export declare function appendSystemActivity(state: AnalysisActivityState, input: {
+    title: string;
+    status: ActivityStatus;
+    detail?: string;
+}): AnalysisActivityState;
+export declare function upsertChunkStarted(state: AnalysisActivityState, chunkIndex: number): AnalysisActivityState;
+export declare function upsertChunkProgress(state: AnalysisActivityState, chunkIndex: number, text: string): AnalysisActivityState;
+export declare function upsertChunkCompletion(state: AnalysisActivityState, chunkIndex: number, evaluation: ChunkEvaluation): AnalysisActivityState;
+export declare function upsertSegmentProgress(state: AnalysisActivityState, rank: number, text: string): AnalysisActivityState;
+export declare function upsertSegmentStarted(state: AnalysisActivityState, rank: number): AnalysisActivityState;
+export declare function upsertSegmentCompletion(state: AnalysisActivityState, rank: number, segment: RankedSegment, formatTime: (seconds: number) => string): AnalysisActivityState;
+//# sourceMappingURL=analysisActivity.d.ts.map

package/dist/app/web/lib/activity/analysisActivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysisActivity.d.ts","sourceRoot":"","sources":["../../../../../src/app/web/lib/activity/analysisActivity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEvF,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,0BAA0B,IAAI,qBAAqB,CAKlE;AAED,wBAAgB,0BAA0B,IAAI,qBAAqB,CAMlE;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,qBAAqB,EAC5B,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAChE,qBAAqB,CAcvB;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,qBAAqB,EAC5B,UAAU,EAAE,MAAM,GACjB,qBAAqB,CAsBvB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,qBAAqB,EAC5B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,qBAAqB,CAiCvB;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,qBAAqB,EAC5B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,eAAe,GAC1B,qBAAqB,CAuCvB;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,qBAAqB,EAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,qBAAqB,CAiCvB;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,qBAAqB,EAC5B,IAAI,EAAE,MAAM,GACX,qBAAqB,CAsBvB;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,qBAAqB,EAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GACtC,qBAAqB,CAgCvB"}