@thunderkiller/video-clipper 1.5.3 → 1.5.4

package/scripts/detect_events.py

@@ -0,0 +1,81 @@
+import tensorflow_hub as hub
+import soundfile as sf
+import numpy as np
+import json
+import sys
+
+GAME_EVENTS = {
+  67: 'gunshot',
+  366: 'explosion',
+  389: 'crowd_cheering',
+  63: 'gunfire_burst',
+}
+
+def cluster_events(events, gap=1.5):
+  if not events:
+    return []
+
+  events = sorted(events, key=lambda x: x['time'])
+  clusters = []
+  current_cluster = [events[0]]
+
+  for i in range(1, len(events)):
+    if events[i]['time'] - events[i - 1]['time'] <= gap:
+      current_cluster.append(events[i])
+    else:
+      max_conf = max(e['confidence'] for e in current_cluster)
+      first_time = current_cluster[0]['time']
+      clusters.append({
+        'time': first_time,
+        'event': current_cluster[0]['event'],
+        'confidence': max_conf,
+      })
+      current_cluster = [events[i]]
+
+  if current_cluster:
+    max_conf = max(e['confidence'] for e in current_cluster)
+    first_time = current_cluster[0]['time']
+    clusters.append({
+      'time': first_time,
+      'event': current_cluster[0]['event'],
+      'confidence': max_conf,
+    })
+
+  return clusters
+
+def detect_events(audio_path, threshold=0.30):
+  model = hub.load('https://tfhub.dev/google/yamnet/1')
+  wav, sr = sf.read(audio_path, dtype='float32')
+
+  if sr != 16000:
+    import warnings
+    warnings.warn(f'Audio sample rate is {sr} Hz, expected 16000 Hz for YAMNet')
+
+  scores, _, _ = model(wav)
+  events = []
+
+  for i, frame in enumerate(scores.numpy()):
+    for cid, label in GAME_EVENTS.items():
+      if frame[cid] > threshold:
+        events.append({
+          'time': round(i * 0.48, 2),
+          'event': label,
+          'confidence': float(frame[cid]),
+        })
+
+  return cluster_events(events, gap=1.5)
+
+if __name__ == '__main__':
+  if len(sys.argv) < 2:
+    print(json.dumps({'error': 'Usage: python detect_events.py <audio_path> [threshold]'}))
+    sys.exit(1)
+
+  audio_path = sys.argv[1]
+  threshold = float(sys.argv[2]) if len(sys.argv) > 2 else 0.30
+
+  try:
+    result = detect_events(audio_path, threshold)
+    print(json.dumps(result))
+  except Exception as e:
+    print(json.dumps({'error': str(e)}))
+    sys.exit(1)

package/scripts/detect_events_whisper.py

@@ -0,0 +1,101 @@
+import json
+import sys
+
+# Keyword sets per game profile.
+# Keys are lowercase; matches are case-insensitive.
+PROFILE_KEYWORDS: dict[str, list[str]] = {
+    'valorant': [
+        'ace', 'clutch', 'defuse', 'spike', '1v1', '1v2', '1v3', '1v4', '1v5',
+        "let's go", 'no way', 'insane', 'bro', 'what', 'oh my god', 'omg',
+        'unbelievable', 'crazy', 'yooo', 'yo', 'filthy', 'clean',
+        'wallbang', 'headshot',
+    ],
+    'fps': [
+        'kill', 'headshot', 'streak', 'collateral', 'insane', 'no way',
+        "let's go", 'yooo', 'yo', 'crazy', 'oh my god', 'omg', 'unbelievable',
+        'nice', 'what', 'bro',
+    ],
+    'boss_fight': [
+        'finally', "let's go", 'dead', 'down', 'phase', 'unbelievable', 'insane',
+        'crazy', 'no way', 'oh my god', 'omg', 'yooo', 'yo', 'what', 'bro',
+    ],
+    'general': [
+        'insane', 'crazy', 'no way', "let's go", 'oh my god', 'omg',
+        'what', 'wow', 'yooo', 'yo', 'unbelievable', 'bro',
+    ],
+}
+
+# Phrases that get full confidence (exact multi-word match carries more signal).
+HIGH_CONFIDENCE_PHRASES: set[str] = {
+    'ace', 'clutch', "let's go", 'no way', 'oh my god', 'omg', 'unbelievable',
+    '1v1', '1v2', '1v3', '1v4', '1v5', 'finally',
+}
+
+
+def score_text(text: str, keywords: list[str]) -> tuple[str | None, float]:
+    """
+    Return the first matching keyword and its confidence, or (None, 0).
+    Multi-word phrases and high-confidence phrases get confidence 1.0;
+    single-word partial matches get 0.8.
+    """
+    lower = text.lower()
+    for kw in keywords:
+        if kw in lower:
+            conf = 1.0 if kw in HIGH_CONFIDENCE_PHRASES else 0.8
+            return kw, conf
+    return None, 0.0
+
+
+def detect_events_whisper(
+    audio_path: str,
+    model_size: str = 'medium',
+    game_profile: str = 'general',
+    threshold: float = 0.3,
+) -> list[dict]:
+    try:
+        import whisper  # type: ignore
+    except ImportError:
+        print(
+            json.dumps({'error': 'openai-whisper not installed. Run: pip install openai-whisper'}),
+            file=sys.stderr,
+        )
+        sys.exit(2)
+
+    keywords = PROFILE_KEYWORDS.get(game_profile, PROFILE_KEYWORDS['general'])
+
+    model = whisper.load_model(model_size)
+    result = model.transcribe(audio_path, word_timestamps=False, fp16=False)
+
+    events: list[dict] = []
+    for seg in result.get('segments', []):
+        text: str = seg.get('text', '')
+        start: float = float(seg.get('start', 0))
+        matched_kw, confidence = score_text(text, keywords)
+        if matched_kw is not None and confidence >= threshold:
+            events.append({
+                'time': round(start, 2),
+                'event': matched_kw,
+                'confidence': confidence,
+            })
+
+    return events
+
+
+if __name__ == '__main__':
+    if len(sys.argv) < 2:
+        print(
+            json.dumps({'error': 'Usage: python detect_events_whisper.py <audio_path> [threshold] [game_profile] [model_size]'}),
+        )
+        sys.exit(1)
+
+    audio_path = sys.argv[1]
+    threshold = float(sys.argv[2]) if len(sys.argv) > 2 else 0.3
+    game_profile = sys.argv[3] if len(sys.argv) > 3 else 'general'
+    model_size = sys.argv[4] if len(sys.argv) > 4 else 'medium'
+
+    try:
+        result = detect_events_whisper(audio_path, model_size, game_profile, threshold)
+        print(json.dumps(result))
+    except Exception as e:
+        print(json.dumps({'error': str(e)}))
+        sys.exit(1)

package/scripts/transcribe_whisper.py

@@ -0,0 +1,70 @@
+"""
+transcribe_whisper.py — Full Whisper transcription for transcript generation.
+
+Runs OpenAI Whisper on the provided audio file and writes a JSON array of
+transcript segments to stdout:
+
+    [{"text": "...", "start": 0.0, "duration": 3.5}, ...]
+
+Usage:
+    python transcribe_whisper.py <audio_path> [model_size]
+
+Arguments:
+    audio_path  - Path to the audio WAV file
+    model_size  - Whisper model to use (default: medium)
+                  Options: tiny, base, small, medium, large-v3
+
+Requires: pip install openai-whisper
+"""
+
+import json
+import sys
+
+
+def transcribe(audio_path: str, model_size: str = 'medium') -> list[dict]:
+    try:
+        import whisper  # type: ignore
+    except ImportError:
+        print(
+            'ModuleNotFoundError: openai-whisper not installed. Run: pip install openai-whisper',
+            file=sys.stderr,
+        )
+        sys.exit(2)
+
+    model = whisper.load_model(model_size)
+    result = model.transcribe(audio_path, word_timestamps=False, fp16=False)
+
+    segments: list[dict] = []
+    for seg in result.get('segments', []):
+        text: str = seg.get('text', '').strip()
+        start: float = float(seg.get('start', 0))
+        end: float = float(seg.get('end', start))
+        duration = max(0.0, round(end - start, 3))
+
+        if text:
+            segments.append({
+                'text': text,
+                'start': round(start, 3),
+                'duration': duration,
+            })
+
+    return segments
+
+
+if __name__ == '__main__':
+    if len(sys.argv) < 2:
+        print(
+            'Usage: python transcribe_whisper.py <audio_path> [model_size]',
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+    audio_path = sys.argv[1]
+    model_size = sys.argv[2] if len(sys.argv) > 2 else 'medium'
+
+    try:
+        output = transcribe(audio_path, model_size)
+        print(json.dumps(output))
+    except Exception as e:
+        print(f'Error: {e}', file=sys.stderr)
+        sys.exit(1)

package/.env.example

@@ -1,130 +0,0 @@
-# ── Provider selection ────────────────────────────────────────────────────────
-# Allowed values: openai | anthropic | google | xai | mistral | groq | zai | openrouter | custom
-# Default: openai
-LLM_PROVIDER=openai
-
-# ── API keys — set only the key for your chosen provider ─────────────────────
-OPENAI_API_KEY=your_key_here
-# ANTHROPIC_API_KEY=your_key_here
-# GOOGLE_GENERATIVE_AI_API_KEY=your_key_here
-# XAI_API_KEY=your_key_here
-# MISTRAL_API_KEY=your_key_here
-# GROQ_API_KEY=your_key_here
-# ZAI_API_KEY=your_key_here
-# OPENROUTER_API_KEY=your_key_here
-
-# ── Custom OpenAI-compatible provider ─────────────────────────────────────────
-# Set LLM_PROVIDER=custom and supply the base URL + API key for any endpoint
-# that speaks the OpenAI Chat Completions API (e.g. LM Studio, vLLM, Ollama,
-# LocalAI, Together AI, Fireworks AI, etc.).
-# Both vars are required when LLM_PROVIDER=custom.
-# CUSTOM_OPENAI_BASE_URL=http://localhost:11434/v1
-# CUSTOM_OPENAI_API_KEY=your_key_here
-
-# ── Model name — must match the chosen provider's model IDs ──────────────────
-# openai:    gpt-4o, gpt-4o-mini, gpt-4-turbo, ...
-# anthropic: claude-sonnet-4-5, claude-opus-4, claude-haiku-3-5, ...
-# google:    gemini-2.0-flash, gemini-1.5-pro, ...
-# xai:       grok-beta, grok-2, ...
-# mistral:   mistral-large-latest, mistral-small-latest, ...
-# groq:      llama-3.3-70b-versatile, llama-3.1-8b-instant, ...
-# zai:       glm-5, glm-4.7, glm-4.6, glm-5-turbo, ...
-# openrouter: meta-llama/llama-3.3-70b-instruct:free, google/gemma-3-27b-it:free, ...
-# custom:    depends on your endpoint (e.g. llama3.2, mistral, phi4, ...)
-LLM_MODEL=gpt-4o
-
-# ── Tunable parameters (all have defaults — only set if you want to override) ─
-# SCORE_THRESHOLD=7        # min score 1–10 to keep a segment
-# TOP_N_SEGMENTS=10        # max segments returned
-# CHUNK_LENGTH_SEC=120     # LLM chunk window size in seconds
-# CHUNK_OVERLAP_SEC=20     # overlap between consecutive chunks in seconds
-# MICRO_BLOCK_SEC=15       # micro-block grouping window in seconds
-# LLM_MAX_RETRIES=3        # max retries on rate-limit errors
-# DOWNLOAD_DIR=downloads/  # directory for yt-dlp downloads
-# OUTPUT_DIR=outputs/      # directory for clips and dumps
-# CACHE_DIR=outputs/cache  # directory for transcript and LLM result caching
-# LLM_CONCURRENCY=3        # max parallel LLM calls
-# CLIP_CONCURRENCY=1       # max parallel clip generation operations
-# DOWNLOAD_SECTIONS_MODE=all  # yt-dlp download mode: all (full video) or segments (individual clips)
-# FFMPEG_PRESET=fast       # ffmpeg encoding preset: ultrafast, superfast, veryfast, fast (default), medium, slow, slower
-# TIMESTAMP_OFFSET_SECONDS=0  # Adjust all clip timestamps (positive = later, negative = earlier) if transcript is misaligned with video
-
-# ── Custom system prompt ────────────────────────────────────────────────────────
-# Override the default LLM system prompt with a custom one. Useful for adapting
-# the analysis to specific content types (e.g., comedy, tech, education).
-# LLM_SYSTEM_PROMPT=You are an expert video editor specializing in viral clips.
-
-# ── LLM evaluation limits ─────────────────────────────────────────────────────
-# Cap the number of transcript chunks sent to the LLM. Useful for testing or
-# controlling API costs. Unset (default) means all chunks are evaluated.
-# MAX_CHUNKS=5
-
-# ── Output dumping ────────────────────────────────────────────────────────────
-# When true (default), writes two files after each run:
-#   OUTPUT_DIR/transcript/{videoId}.json  — raw normalized transcript lines
-#   OUTPUT_DIR/analysis/{videoId}.json    — full pipeline result (metadata + ranked segments)
-# Set to false to disable.
-# DUMP_OUTPUTS=true
-
-# ── Audio event detection ───────────────────────────────────────────────────────
-# Enable/disable audio event detection. When false, transcript-only mode is used.
-# Default: true
-# AUDIO_DETECTION_ENABLED=true
-
-# ── Transcript provider ─────────────────────────────────────────────────────────
-# Comma-separated ordered fallback chain. First provider to succeed wins.
-#   ytdlp   — yt-dlp auto-generated VTT subtitles (default, no audio required)
-#   whisper — local openai-whisper (Python), requires audio download + pip install openai-whisper
-#   gemini  — Gemini multimodal transcription (not yet implemented)
-# Default: ytdlp
-# TRANSCRIPT_PROVIDER=ytdlp
-
-# Audio provider:
-#   gemini  — Gemini Flash, semantic understanding, requires GOOGLE_GENERATIVE_AI_API_KEY
-#   yamnet  — local YAMNet (Python), class-ID based, requires: pip install tensorflow-hub soundfile numpy
-#   whisper — local openai-whisper (Python), speech-to-text + keyword match, requires: pip install openai-whisper
-#   both    — deprecated alias for "gemini,whisper"
-# Default: gemini,whisper
-# AUDIO_PROVIDER=gemini,whisper
-
-# Whisper model size to use when AUDIO_PROVIDER=whisper or AUDIO_PROVIDER=both.
-# Larger models are more accurate but slower. medium is the recommended default.
-# Options: tiny | base | small | medium | large-v3
-# Default: medium
-# AUDIO_WHISPER_MODEL=medium
-
-# Confidence threshold (0-1). Events below this value are discarded.
-# For Whisper: 1.0 = exact phrase match, 0.8 = partial keyword match.
-# For YAMNet: raw class score from the model.
-# Default: 0.30
-# AUDIO_CONFIDENCE_THRESHOLD=0.30
-
-# Pre-roll and post-roll for audio-only clip candidates (seconds before/after event)
-# Default: 5s pre-roll, 15s post-roll
-# AUDIO_CLIP_PRE_ROLL=5
-# AUDIO_CLIP_POST_ROLL=15
-
-# Time window (seconds) within which audio events boost LLM segment scores
-# Default: 10s
-# AUDIO_LLM_BOOST_WINDOW=10
-
-# Score boost applied to LLM segments when audio event is detected nearby
-# Default: 2
-# AUDIO_LLM_SCORE_BOOST=2
-
-# ── Game profile ────────────────────────────────────────────────────────────────
-# Game-specific event detection and LLM keywords:
-#   valorant:   gunshot, gunfire_burst, explosion + ace, clutch, defuse, spike
-#   fps:        gunshot, gunfire_burst, explosion + kill, streak, headshot
-#   boss_fight: explosion, crowd_cheering + phase, dead, finally
-#   general:    crowd_cheering, applause + insane, crazy, let's go
-# Default: general
-# GAME_PROFILE=general
-
-# ── Audio extra instructions ─────────────────────────────────────────────────
-# Optional extra instructions appended to the Gemini audio detection prompt,
-# after the game-profile preamble and before the JSON format block.
-# Use this to focus detection on specific moments, ignore certain sounds, or
-# add game-specific context not covered by the built-in profiles.
-# Example:
-# AUDIO_EXTRA_INSTRUCTIONS=Also flag moments where the caster's voice rises sharply. Ignore background music.

package/CHANGELOG.md

@@ -1,102 +0,0 @@
-## [1.5.3](https://github.com/AmreetKumarkhuntia/video-clipper/compare/v1.5.2...v1.5.3) (2026-03-20)
-
-### Bug Fixes
-
-- **release:** use GITHUB_TOKEN and project-level .npmrc for GitHub Packages ([437234f](https://github.com/AmreetKumarkhuntia/video-clipper/commit/437234fe43edbf5e7e0ad5c1e9f21149bb589bb5))
-
-## [1.5.2](https://github.com/AmreetKumarkhuntia/video-clipper/compare/v1.5.1...v1.5.2) (2026-03-20)
-
-### Bug Fixes
-
-- **release:** use PUSH_TOKEN for GitHub Packages auth ([eb89f64](https://github.com/AmreetKumarkhuntia/video-clipper/commit/eb89f64159f9903d5051587bb43e2e7f0c82c51a))
-
-## [1.5.1](https://github.com/AmreetKumarkhuntia/video-clipper/compare/v1.5.0...v1.5.1) (2026-03-20)
-
-### Bug Fixes
-
-- **release:** use explicit --registry flag for GitHub Packages publish ([1aec842](https://github.com/AmreetKumarkhuntia/video-clipper/commit/1aec842846fa1308b50eba53fee6465a0dbbb958))
-
-# [1.5.0](https://github.com/AmreetKumarkhuntia/video-clipper/compare/v1.4.0...v1.5.0) (2026-03-20)
-
-### Features
-
-- **release:** publish to GitHub Packages alongside npm ([dee2e57](https://github.com/AmreetKumarkhuntia/video-clipper/commit/dee2e574eceb83a43be47155ad87060d74658713))
-
-# [1.4.0](https://github.com/AmreetKumarkhuntia/video-clipper/compare/v1.3.1...v1.4.0) (2026-03-20)
-
-### Features
-
-- **commitlint:** enforce conventional commit message format ([9d99882](https://github.com/AmreetKumarkhuntia/video-clipper/commit/9d998828617be72a81fbe4e72caa15eb28e88b82))
-
-## [1.3.1](https://github.com/AmreetKumarkhuntia/video-clipper/compare/v1.3.0...v1.3.1) (2026-03-20)
-
-### Bug Fixes
-
-- **release:** add @semantic-release/npm plugin to update package.json version ([fe6498d](https://github.com/AmreetKumarkhuntia/video-clipper/commit/fe6498d779459455387e2ca2736862e704ea8b1c))
-- **release:** add @semantic-release/npm to update package.json version ([9de3397](https://github.com/AmreetKumarkhuntia/video-clipper/commit/9de33977fe9f856aa8749436cbee7422dd622322))
-
-# [1.3.0](https://github.com/AmreetKumarkhuntia/video-clipper/compare/v1.2.0...v1.3.0) (2026-03-19)
-
-### Features
-
-- **npm:** configure npm package publishing ([b268345](https://github.com/AmreetKumarkhuntia/video-clipper/commit/b26834559ce97db683c393db765d7d5c7e989236))
-
-# [1.2.0](https://github.com/AmreetKumarkhuntia/video-clipper/compare/v1.1.1...v1.2.0) (2026-03-19)
-
-### Features
-
-- **docs:** add advanced examples section to README with common use cases ([6d730f6](https://github.com/AmreetKumarkhuntia/video-clipper/commit/6d730f615830247977273bacb26c9bee24a6e474))
-
-## [1.1.1](https://github.com/AmreetKumarkhuntia/video-clipper/compare/v1.1.0...v1.1.1) (2026-03-19)
-
-### Bug Fixes
-
-- github workflows ([18a9536](https://github.com/AmreetKumarkhuntia/video-clipper/commit/18a953619ed17de71d3c9bd0a86e1b42a10aea37))
-- **release:** pull updated package.json before npm publish to avoid race condition ([1839e4a](https://github.com/AmreetKumarkhuntia/video-clipper/commit/1839e4a57d516234ad629f0217e4fa5f4852e4e3))
-- yaml correction ([33c7854](https://github.com/AmreetKumarkhuntia/video-clipper/commit/33c7854015e1266b3fc01b6206da4ec946f94307))
-
-# 1.0.0 (2026-03-18)
-
-### Bug Fixes
-
-- **audio:** align audio chunk windows with transcript LLM chunks ([f81981f](https://github.com/AmreetKumarkhuntia/video-clipper/commit/f81981fdca8c8b4b13682112551541b1df75a138))
-- **audio:** fix Gemini markdown fence parse error and add per-chunk caching ([3cc237f](https://github.com/AmreetKumarkhuntia/video-clipper/commit/3cc237f851c56236fb3f2795f5378b02cf34bde3))
-- **audio:** fix Gemini MM.SS timestamp ambiguity and make model configurable ([2139c5f](https://github.com/AmreetKumarkhuntia/video-clipper/commit/2139c5fa2030679bb460b402108f0e64482c0d0b))
-- **audio:** use python3 or python whichever available ([6501bf6](https://github.com/AmreetKumarkhuntia/video-clipper/commit/6501bf6ba99ba1364d285b7b921a22ecdfd23182))
-- github workflows ([18a9536](https://github.com/AmreetKumarkhuntia/video-clipper/commit/18a953619ed17de71d3c9bd0a86e1b42a10aea37))
-- **logging:** improve chunk analysis logs and gitignore outputs dir ([cc007de](https://github.com/AmreetKumarkhuntia/video-clipper/commit/cc007de0b1f453064a907689f9f30f6da2bebded))
-- **release:** add explicit npm auth setup step ([21c9287](https://github.com/AmreetKumarkhuntia/video-clipper/commit/21c928748fe90f278e67e34ae57553e5c279faf2))
-- **release:** add explicit npm auth setup step ([7e423fa](https://github.com/AmreetKumarkhuntia/video-clipper/commit/7e423fa76779d1dd6fe0d5bd0bac1cf0d54ffc8a))
-- **release:** remove github release plugin, keep npm only ([b37870b](https://github.com/AmreetKumarkhuntia/video-clipper/commit/b37870bfe997ad9d16ec1e0c22d52a07c99b4aaf))
-- **release:** restore github releases and fix git push permissions ([73e6fea](https://github.com/AmreetKumarkhuntia/video-clipper/commit/73e6fea88040844d00cebe79953f50f5ac96bc1e))
-- **release:** use PUSH_TOKEN instead of GITHUB_TOKEN ([d3414ad](https://github.com/AmreetKumarkhuntia/video-clipper/commit/d3414ad84944d48bc5dfcee7562b00c358bca27e))
-- **tests:** add global vitest setup to mock config module ([ecffd3b](https://github.com/AmreetKumarkhuntia/video-clipper/commit/ecffd3b940b4a2a3e5d0bd29911f2e70e22bdfe8))
-- yaml correction ([33c7854](https://github.com/AmreetKumarkhuntia/video-clipper/commit/33c7854015e1266b3fc01b6206da4ec946f94307))
-
-### Features
-
-- **analysis:** add per-chunk evaluations to analysis dump ([c562878](https://github.com/AmreetKumarkhuntia/video-clipper/commit/c562878971c65b8739b373cf2cac235d5c6697c0))
-- **audio:** add audio event result caching + requirements.txt ([5fd41d5](https://github.com/AmreetKumarkhuntia/video-clipper/commit/5fd41d5895e50060a93e9ef20621c85db52e80c4))
-- **audio:** add openai-whisper as local audio event detector ([12aa5be](https://github.com/AmreetKumarkhuntia/video-clipper/commit/12aa5be9a5521efef07e29f20ea93dd1a54aeda6))
-- **audio:** apply --max-parallel to audio event detection ([4996fc7](https://github.com/AmreetKumarkhuntia/video-clipper/commit/4996fc744f5000b791ecdd6677c95c24d5cf8e59))
-- **cache:** add chunk/transcript caching and format timestamps as HH:MM:SS ([4ea921d](https://github.com/AmreetKumarkhuntia/video-clipper/commit/4ea921d409c2b8cda2a1a5d59eb8bec14ca2c919))
-- **cache:** write chunk cache immediately after LLM analysis ([2ef3454](https://github.com/AmreetKumarkhuntia/video-clipper/commit/2ef3454a57c61abd5e0031639d6b79a726c7f413))
-- **ci:** add semantic-release for automated versioning ([0b7b6b6](https://github.com/AmreetKumarkhuntia/video-clipper/commit/0b7b6b65f685f486f3b51d21a78ac63108b87695))
-- **clip-generator:** add CLIP_CONCURRENCY config to prevent memory spikes ([be2c8af](https://github.com/AmreetKumarkhuntia/video-clipper/commit/be2c8af7763c5967b9b88d0b4406ac1a2c50af71))
-- **clip:** fix audio/video sync and add flexible download options ([c8ebe1a](https://github.com/AmreetKumarkhuntia/video-clipper/commit/c8ebe1a7f2218dcb881d10bd421e7b77b84009b6))
-- **llm:** add multi-provider support via modelFactory ([d72cb81](https://github.com/AmreetKumarkhuntia/video-clipper/commit/d72cb81d8adfe6366b60ef8ab74bbd7c38f67fe5))
-- **llm:** support custom system prompt via LLM_SYSTEM_PROMPT env var ([8b4525d](https://github.com/AmreetKumarkhuntia/video-clipper/commit/8b4525d9fffe2806c2232035b9a8553e56f37270))
-- **npm:** convert to scoped package @thunderkiller/video-clipper ([c8bf930](https://github.com/AmreetKumarkhuntia/video-clipper/commit/c8bf930c789cd9ceee3d8143fc5ff75674609f9a))
-- **output:** add transcript and analysis dump feature ([15db23c](https://github.com/AmreetKumarkhuntia/video-clipper/commit/15db23c77244b9db89604be463bccb97f6161987))
-- **phase4:** add video downloader and clip generator modules ([5c1cbde](https://github.com/AmreetKumarkhuntia/video-clipper/commit/5c1cbdeabe84a65013f7d5a8f34b3c2c336097e0))
-- **phase5:** add CLI flags, error handling, and progress logging ([36edf0a](https://github.com/AmreetKumarkhuntia/video-clipper/commit/36edf0a93da5389c7d5dee555fb6e3c7c7e47ee1))
-- **pipeline:** implement phase 2 core pipeline modules ([957b068](https://github.com/AmreetKumarkhuntia/video-clipper/commit/957b068a36dc29552c1a950ac74a8e337f097764))
-- **pipeline:** implement phase 3 LLM analysis and metadata modules ([8a088c9](https://github.com/AmreetKumarkhuntia/video-clipper/commit/8a088c99498824b35c9e348dd1ef8bb01eba7659))
-- **provider:** add custom OpenAI-compatible provider support ([5dc0c4e](https://github.com/AmreetKumarkhuntia/video-clipper/commit/5dc0c4e5fedddc97ba7907d5af89ba2fa46f2bc3))
-- **provider:** add openrouter support and free models doc ([e41d4a6](https://github.com/AmreetKumarkhuntia/video-clipper/commit/e41d4a6780dc5d72e83aafd1a1b4b8a46f2dd284))
-- **refiner:** add concurrency control and caching to segment refinement ([0738599](https://github.com/AmreetKumarkhuntia/video-clipper/commit/073859948700da0d59b806e29f03e9b7956f704d))
-- **release:** split into two sequential stages - GitHub then npm ([9f6d110](https://github.com/AmreetKumarkhuntia/video-clipper/commit/9f6d1108abd80cacf695d3872f4800fb84884bdd))
-- **scaffold:** bootstrap project structure and core infrastructure ([b187b3f](https://github.com/AmreetKumarkhuntia/video-clipper/commit/b187b3f43082ae88525f9444e84297b975167720))
-- **tooling:** add prettier, husky pre-commit hooks, and github actions ci ([fdbdc9a](https://github.com/AmreetKumarkhuntia/video-clipper/commit/fdbdc9a838e083d2777e6c6fb0f700b28fb1c324))
-- **version:** updated version ([69164f5](https://github.com/AmreetKumarkhuntia/video-clipper/commit/69164f59acca2e3236b4ab9a6e85441f89df01b4))
-- **yt-dlp:** add cookie support and improve error logging ([ae4afd4](https://github.com/AmreetKumarkhuntia/video-clipper/commit/ae4afd476b4176645bd69f40a62f22fd775356eb))

package/CONTRIBUTING.md

@@ -1,100 +0,0 @@
-# Contributing
-
-## Getting Started
-
-```bash
-pnpm install
-```
-
-This will install all dependencies and set up git hooks via Husky.
-
-## Commit Message Format
-
-This project uses [Conventional Commits](https://www.conventionalcommits.org/) enforced by [commitlint](https://commitlint.js.org/).
-
-### Format
-
-```
-<type>(<scope>): <short description>
-
-- <detail 1>
-- <detail 2>
-```
-
-### Types
-
-| Type       | Description                                             | Version Bump           |
-| ---------- | ------------------------------------------------------- | ---------------------- |
-| `feat`     | New feature                                             | minor (1.0.0 -> 1.1.0) |
-| `fix`      | Bug fix                                                 | patch (1.0.0 -> 1.0.1) |
-| `docs`     | Documentation only                                      | none                   |
-| `refactor` | Code change that neither fixes a bug nor adds a feature | none                   |
-| `test`     | Adding or updating tests                                | none                   |
-| `chore`    | Maintenance tasks (deps, config, etc.)                  | none                   |
-| `style`    | Formatting, missing semicolons, etc. (no code change)   | none                   |
-| `perf`     | Performance improvement                                 | none                   |
-| `ci`       | CI/CD configuration changes                             | none                   |
-| `build`    | Build system or external dependency changes             | none                   |
-| `revert`   | Reverts a previous commit                               | none                   |
-
-### Rules
-
-- **type** (required): one from the table above
-- **scope** (recommended): kebab-case name of the feature area, e.g. `release`, `transcript-fetcher`, `llm-analyzer`
-- **short description** (required): lowercase, imperative mood, max 100 chars, no period at end
-- **body** (optional): pointwise with `-`, max 500 chars total
-
-### Examples
-
-```
-feat(clip-refiner): add overlap detection for adjacent segments
-
-- detect when refined segments overlap by more than 2s
-- merge overlapping segments and keep the higher-scored one
-```
-
-```
-fix(release): add @semantic-release/npm to update package.json version
-
-- add @semantic-release/npm with npmPublish: false
-- npm publish remains a separate workflow step
-```
-
-```
-docs(readme): add advanced examples section
-```
-
-### Breaking Changes
-
-Add `BREAKING CHANGE:` in the commit body or `!` after the type to trigger a major version bump:
-
-```
-feat(config)!: rename ENV_VAR to NEW_ENV_VAR
-
-BREAKING CHANGE: ENV_VAR is no longer supported, use NEW_ENV_VAR instead
-```
-
-## Git Hooks
-
-The following hooks run automatically on every commit:
-
-| Hook         | What it runs                                                  |
-| ------------ | ------------------------------------------------------------- |
-| `pre-commit` | `lint-staged` (Prettier), `type-check` (tsc), `test` (vitest) |
-| `commit-msg` | `commitlint` (validates commit message format)                |
-
-If your commit is rejected, check the error output — it will tell you exactly which rule was violated.
-
-## Code Style
-
-- TypeScript only — no plain `.js` files
-- Prettier handles formatting automatically via `lint-staged`
-- Run `pnpm format` to format all files manually
-- Run `pnpm type-check` to check for type errors
-
-## Testing
-
-- Write unit tests for pure functions
-- Test files live in `tests/` at the project root
-- Run `pnpm test` to run all tests
-- Run `pnpm test:watch` for watch mode

package/commitlint.config.js

@@ -1,25 +0,0 @@
-export default {
-  extends: ['@commitlint/config-conventional'],
-  rules: {
-    'type-enum': [
-      2,
-      'always',
-      [
-        'feat',
-        'fix',
-        'docs',
-        'refactor',
-        'test',
-        'chore',
-        'style',
-        'perf',
-        'ci',
-        'build',
-        'revert',
-      ],
-    ],
-    'scope-case': [2, 'always', 'kebab-case'],
-    'subject-max-length': [2, 'always', 100],
-    'body-max-line-length': [2, 'always', 500],
-  },
-};