@kenkaiiii/gg-editor 0.1.0

package/dist/core/sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../src/core/sessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;;;;;;;;GASG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;AAmBtE,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAmD;IAEnD,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,MAAM,OAAO,GAAqB;QAChC,CAAC,EAAE,CAAC;QACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,GAAG,QAAQ;KACZ,CAAC;IACF,iEAAiE;IACjE,MAAM,GAAG,GAAG,GAAG,iBAAiB,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;IACtD,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAClE,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;IACzD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAqB,CAAC;QACnD,IAAI,MAAM,CAAC,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAChC,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,OAAO,UAAU,CAAC,iBAAiB,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,QAAmB;IAC7C,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;AACrD,CAAC"}

package/dist/core/sfx-on-cuts.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Sound-design-on-cuts: drop a short SFX (whoosh, pop, swoosh) at
+ * every cut point. Sound holds attention longer than visuals, and a
+ * subtle whoosh-on-cut is the standard polish on every retention-
+ * optimized vlog / short.
+ *
+ * We layer the SFX on top of the existing audio with a configurable
+ * gain offset (default -8 dB so it doesn't fight the voice). One
+ * ffmpeg pass — we read the SFX once and use the `adelay` filter to
+ * shift one copy per cut point onto its target timestamp, then
+ * `amix` everything down with the original audio.
+ *
+ * Pure logic here just builds the filter graph string; the tool
+ * wrapper spawns ffmpeg.
+ */
+export interface SfxOnCutsOptions {
+    /** Cut points in seconds. */
+    cutPoints: number[];
+    /** Total media duration (sec). Cuts >= total are dropped. */
+    totalSec: number;
+    /**
+     * SFX gain relative to original audio. Default -8 dB. Use -12 dB
+     * for very subtle, -4 dB for prominent.
+     */
+    sfxGainDb?: number;
+    /**
+     * Original-track sidechain duck depth (dB) at each cut. Default 0
+     * (no ducking). Use -3 to -6 to slightly dip the voice under the
+     * whoosh — adds polish but harder to undo.
+     */
+    duckDb?: number;
+    /**
+     * Min spacing (sec) between SFX hits. Default 0.25s — closer hits
+     * get collapsed (fast machine-gun cuts shouldn't stack 8 whooshes).
+     */
+    minSpacingSec?: number;
+}
+export interface SfxFilterGraph {
+    /**
+     * Complete `-filter_complex` value. Two inputs expected on the
+     * ffmpeg command line: `[0:a]` (original) and `[1:a]` (sfx file).
+     * The output label is `[mix]`.
+     */
+    filterComplex: string;
+    /** Number of SFX hits the graph emits (after deduplication). */
+    hits: number;
+}
+/**
+ * Build a filter_complex that lays one SFX hit per cut point onto
+ * the original audio, returning the result on label `[mix]`.
+ *
+ * Strategy:
+ *   1. Drop cut points outside [0, totalSec) and dedupe by min spacing.
+ *   2. For each hit i: `[1:a]adelay=Tms|Tms,volume=Gd[s_i]` produces a
+ *      gained, delayed copy of the SFX on its own label. (`Tms|Tms`
+ *      delays both stereo channels equally.)
+ *   3. amix=inputs=N+1 sums the original + all SFX copies into [mix].
+ */
+export declare function buildSfxOnCutsFilter(opts: SfxOnCutsOptions): SfxFilterGraph;
+//# sourceMappingURL=sfx-on-cuts.d.ts.map

package/dist/core/sfx-on-cuts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sfx-on-cuts.d.ts","sourceRoot":"","sources":["../../src/core/sfx-on-cuts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,GAAG,cAAc,CAyD3E"}

package/dist/core/sfx-on-cuts.js

@@ -0,0 +1,90 @@
+/**
+ * Sound-design-on-cuts: drop a short SFX (whoosh, pop, swoosh) at
+ * every cut point. Sound holds attention longer than visuals, and a
+ * subtle whoosh-on-cut is the standard polish on every retention-
+ * optimized vlog / short.
+ *
+ * We layer the SFX on top of the existing audio with a configurable
+ * gain offset (default -8 dB so it doesn't fight the voice). One
+ * ffmpeg pass — we read the SFX once and use the `adelay` filter to
+ * shift one copy per cut point onto its target timestamp, then
+ * `amix` everything down with the original audio.
+ *
+ * Pure logic here just builds the filter graph string; the tool
+ * wrapper spawns ffmpeg.
+ */
+/**
+ * Build a filter_complex that lays one SFX hit per cut point onto
+ * the original audio, returning the result on label `[mix]`.
+ *
+ * Strategy:
+ *   1. Drop cut points outside [0, totalSec) and dedupe by min spacing.
+ *   2. For each hit i: `[1:a]adelay=Tms|Tms,volume=Gd[s_i]` produces a
+ *      gained, delayed copy of the SFX on its own label. (`Tms|Tms`
+ *      delays both stereo channels equally.)
+ *   3. amix=inputs=N+1 sums the original + all SFX copies into [mix].
+ */
+export function buildSfxOnCutsFilter(opts) {
+    const minSpacing = Math.max(0, opts.minSpacingSec ?? 0.25);
+    const sfxGain = dbToLinear(opts.sfxGainDb ?? -8);
+    const duckDb = opts.duckDb ?? 0;
+    const sorted = [...opts.cutPoints]
+        .filter((t) => Number.isFinite(t) && t >= 0 && t < opts.totalSec)
+        .sort((a, b) => a - b);
+    const deduped = [];
+    for (const t of sorted) {
+        if (deduped.length === 0 || t - deduped[deduped.length - 1] >= minSpacing) {
+            deduped.push(t);
+        }
+    }
+    if (deduped.length === 0) {
+        // No-op graph: just label the original audio as [mix].
+        return {
+            filterComplex: "[0:a]anull[mix]",
+            hits: 0,
+        };
+    }
+    const segments = [];
+    const sfxLabels = [];
+    deduped.forEach((t, i) => {
+        const ms = Math.max(0, Math.round(t * 1000));
+        const label = `s${i}`;
+        sfxLabels.push(`[${label}]`);
+        segments.push(`[1:a]adelay=${ms}|${ms},volume=${fmt(sfxGain)}[${label}]`);
+    });
+    // Optional ducking: sidechaincompress the original against a sum of
+    // the SFX copies so the voice dips slightly when a whoosh fires.
+    // We keep this off by default — pushing the duck depth requires the
+    // user understand it.
+    let originalLabel = "[0:a]";
+    if (duckDb < 0) {
+        // Sum sfx copies into [duckSrc] and sidechain.
+        segments.push(`${sfxLabels.join("")}amix=inputs=${sfxLabels.length}:normalize=0[duckSrc]`);
+        const ratio = duckDbToRatio(duckDb);
+        segments.push(`[0:a][duckSrc]sidechaincompress=threshold=0.05:ratio=${fmt(ratio)}:attack=5:release=200[ducked]`);
+        originalLabel = "[ducked]";
+    }
+    // Final amix combines the (possibly ducked) original + every SFX copy.
+    segments.push(`${originalLabel}${sfxLabels.join("")}amix=inputs=${1 + sfxLabels.length}:normalize=0[mix]`);
+    return {
+        filterComplex: segments.join(";"),
+        hits: deduped.length,
+    };
+}
+function dbToLinear(db) {
+    return Math.pow(10, db / 20);
+}
+/**
+ * Convert "duck the voice by N dB" into a sidechaincompress ratio. A
+ * crude mapping: -3 dB → 2:1, -6 dB → 4:1, -9 dB → 8:1. Floors at 1.5.
+ */
+function duckDbToRatio(duckDb) {
+    const absDb = Math.abs(duckDb);
+    return Math.max(1.5, Math.pow(2, absDb / 3));
+}
+function fmt(n) {
+    if (!Number.isFinite(n))
+        return "0";
+    return Number(n.toFixed(4)).toString();
+}
+//# sourceMappingURL=sfx-on-cuts.js.map

package/dist/core/sfx-on-cuts.js.map

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

package/dist/core/sfx-on-cuts.test.d.ts

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

package/dist/core/sfx-on-cuts.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sfx-on-cuts.test.d.ts","sourceRoot":"","sources":["../../src/core/sfx-on-cuts.test.ts"],"names":[],"mappings":""}

package/dist/core/sfx-on-cuts.test.js

@@ -0,0 +1,53 @@
+import { describe, expect, it } from "vitest";
+import { buildSfxOnCutsFilter } from "./sfx-on-cuts.js";
+describe("buildSfxOnCutsFilter", () => {
+    it("emits a no-op graph when there are no cut points", () => {
+        const r = buildSfxOnCutsFilter({ cutPoints: [], totalSec: 10 });
+        expect(r.filterComplex).toBe("[0:a]anull[mix]");
+        expect(r.hits).toBe(0);
+    });
+    it("emits one delayed SFX copy per cut, mixed with the original", () => {
+        const r = buildSfxOnCutsFilter({ cutPoints: [1, 2.5, 4], totalSec: 10 });
+        expect(r.hits).toBe(3);
+        expect(r.filterComplex).toContain("adelay=1000|1000");
+        expect(r.filterComplex).toContain("adelay=2500|2500");
+        expect(r.filterComplex).toContain("adelay=4000|4000");
+        // Final mix should sum 1 (original) + 3 (sfx copies) = 4 inputs.
+        expect(r.filterComplex).toContain("amix=inputs=4");
+    });
+    it("drops cut points outside [0, totalSec)", () => {
+        const r = buildSfxOnCutsFilter({ cutPoints: [-1, 0, 5, 10, 11], totalSec: 10 });
+        expect(r.hits).toBe(2);
+    });
+    it("dedupes cut points within minSpacingSec", () => {
+        const r = buildSfxOnCutsFilter({
+            cutPoints: [1, 1.1, 1.2, 2, 2.1, 5],
+            totalSec: 10,
+            minSpacingSec: 0.25,
+        });
+        // Expect: keep 1, drop 1.1 and 1.2, keep 2 (dist from 1 = 1s ≥ 0.25),
+        // drop 2.1, keep 5.
+        expect(r.hits).toBe(3);
+    });
+    it("renders sfxGainDb as a linear volume coefficient", () => {
+        // -6dB ≈ 0.5012
+        const r = buildSfxOnCutsFilter({ cutPoints: [1], totalSec: 10, sfxGainDb: -6 });
+        expect(r.filterComplex).toContain("volume=0.5012");
+    });
+    it("inserts a sidechaincompress stage when duckDb < 0", () => {
+        const r = buildSfxOnCutsFilter({ cutPoints: [1], totalSec: 10, duckDb: -6 });
+        expect(r.filterComplex).toContain("sidechaincompress");
+        expect(r.filterComplex).toContain("[ducked]");
+        expect(r.filterComplex).toContain("amix=inputs=2"); // ducked original + 1 sfx
+    });
+    it("does NOT insert sidechaincompress when duckDb is 0", () => {
+        const r = buildSfxOnCutsFilter({ cutPoints: [1], totalSec: 10, duckDb: 0 });
+        expect(r.filterComplex).not.toContain("sidechaincompress");
+    });
+    it("uses integer ms in adelay (no decimals)", () => {
+        const r = buildSfxOnCutsFilter({ cutPoints: [1.2342], totalSec: 10 });
+        expect(r.filterComplex).toContain("adelay=1234|1234");
+        expect(r.filterComplex).not.toMatch(/adelay=\d+\.\d+/);
+    });
+});
+//# sourceMappingURL=sfx-on-cuts.test.js.map

package/dist/core/sfx-on-cuts.test.js.map

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

package/dist/core/silence.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Parser for ffmpeg's `silencedetect` filter output.
+ *
+ * The filter writes pairs of lines to stderr:
+ *   [silencedetect @ 0x...] silence_start: 1.234
+ *   [silencedetect @ 0x...] silence_end: 2.456 | silence_duration: 1.222
+ *
+ * If the recording ends mid-silence, the closing `silence_end` is omitted.
+ * We close it ourselves using the optional `totalSec` parameter.
+ */
+export interface SilenceRange {
+    startSec: number;
+    endSec: number;
+    durSec: number;
+}
+/**
+ * Parse silencedetect lines into ranges. Robust to interleaved ffmpeg log
+ * lines, partial buffers, and unterminated final silences.
+ *
+ * @param stderr  Combined ffmpeg stderr text.
+ * @param totalSec  Total media duration. If the last detected silence has no
+ *                  matching `silence_end`, it's closed at totalSec.
+ */
+export declare function parseSilenceDetect(stderr: string, totalSec?: number): SilenceRange[];
+/**
+ * Convert silence ranges (in seconds) to frame-aligned ranges. Rounds INWARD
+ * — start ceils, end floors — so the resulting cut never trims into speech.
+ */
+export declare function silencesToFrameRanges(silences: SilenceRange[], fps: number): Array<{
+    startFrame: number;
+    endFrame: number;
+}>;
+/**
+ * Compute the inverse: "keep" ranges between silences. Convenient for the
+ * agent which mostly cares about what to KEEP (those become EDL events).
+ *
+ * Pads each keep range outward by `paddingSec` (clamped to neighbours and
+ * total duration) so cuts don't slice the first/last syllable.
+ */
+export declare function keepRangesFromSilences(silences: SilenceRange[], totalSec: number, paddingSec?: number): SilenceRange[];
+//# sourceMappingURL=silence.d.ts.map

package/dist/core/silence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"silence.d.ts","sourceRoot":"","sources":["../../src/core/silence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAKD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CA2CpF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,EAAE,EACxB,GAAG,EAAE,MAAM,GACV,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAQjD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,YAAY,EAAE,EACxB,QAAQ,EAAE,MAAM,EAChB,UAAU,SAAI,GACb,YAAY,EAAE,CAoBhB"}

package/dist/core/silence.js

@@ -0,0 +1,104 @@
+/**
+ * Parser for ffmpeg's `silencedetect` filter output.
+ *
+ * The filter writes pairs of lines to stderr:
+ *   [silencedetect @ 0x...] silence_start: 1.234
+ *   [silencedetect @ 0x...] silence_end: 2.456 | silence_duration: 1.222
+ *
+ * If the recording ends mid-silence, the closing `silence_end` is omitted.
+ * We close it ourselves using the optional `totalSec` parameter.
+ */
+const START_RE = /silence_start:\s*(-?\d+(?:\.\d+)?)/;
+const END_RE = /silence_end:\s*(-?\d+(?:\.\d+)?)/;
+/**
+ * Parse silencedetect lines into ranges. Robust to interleaved ffmpeg log
+ * lines, partial buffers, and unterminated final silences.
+ *
+ * @param stderr  Combined ffmpeg stderr text.
+ * @param totalSec  Total media duration. If the last detected silence has no
+ *                  matching `silence_end`, it's closed at totalSec.
+ */
+export function parseSilenceDetect(stderr, totalSec) {
+    const ranges = [];
+    let openStart;
+    for (const line of stderr.split(/\r?\n/)) {
+        const startMatch = START_RE.exec(line);
+        if (startMatch) {
+            const v = Number(startMatch[1]);
+            if (!Number.isFinite(v)) {
+                continue;
+            }
+            // ffmpeg can emit a slightly-negative start (e.g. -0.00133333) when the
+            // file leads with silence — it's a filter look-back artifact, not a real
+            // negative time. Clamp to 0 so leading-silence detection works.
+            // We still reject genuinely-negative values (< -1s) as parse errors.
+            if (v < -1)
+                continue;
+            openStart = Math.max(0, v);
+            continue;
+        }
+        const endMatch = END_RE.exec(line);
+        if (endMatch && openStart !== undefined) {
+            const end = Number(endMatch[1]);
+            if (Number.isFinite(end) && end > openStart) {
+                ranges.push({
+                    startSec: openStart,
+                    endSec: end,
+                    durSec: +(end - openStart).toFixed(6),
+                });
+            }
+            openStart = undefined;
+        }
+    }
+    // Close a trailing unterminated silence at the end of the file.
+    if (openStart !== undefined && totalSec !== undefined && totalSec > openStart) {
+        ranges.push({
+            startSec: openStart,
+            endSec: totalSec,
+            durSec: +(totalSec - openStart).toFixed(6),
+        });
+    }
+    return ranges;
+}
+/**
+ * Convert silence ranges (in seconds) to frame-aligned ranges. Rounds INWARD
+ * — start ceils, end floors — so the resulting cut never trims into speech.
+ */
+export function silencesToFrameRanges(silences, fps) {
+    const out = [];
+    for (const s of silences) {
+        const sf = Math.ceil(s.startSec * fps);
+        const ef = Math.floor(s.endSec * fps);
+        if (ef > sf)
+            out.push({ startFrame: sf, endFrame: ef });
+    }
+    return out;
+}
+/**
+ * Compute the inverse: "keep" ranges between silences. Convenient for the
+ * agent which mostly cares about what to KEEP (those become EDL events).
+ *
+ * Pads each keep range outward by `paddingSec` (clamped to neighbours and
+ * total duration) so cuts don't slice the first/last syllable.
+ */
+export function keepRangesFromSilences(silences, totalSec, paddingSec = 0) {
+    // Sort defensively; ffmpeg always emits in order but tests/callers may not.
+    const sorted = [...silences].sort((a, b) => a.startSec - b.startSec);
+    const keeps = [];
+    let cursor = 0;
+    for (const s of sorted) {
+        if (s.startSec > cursor) {
+            const start = Math.max(0, cursor - paddingSec);
+            const end = Math.min(totalSec, s.startSec + paddingSec);
+            if (end > start)
+                keeps.push({ startSec: start, endSec: end, durSec: +(end - start).toFixed(6) });
+        }
+        cursor = Math.max(cursor, s.endSec);
+    }
+    if (cursor < totalSec) {
+        const start = Math.max(0, cursor - paddingSec);
+        keeps.push({ startSec: start, endSec: totalSec, durSec: +(totalSec - start).toFixed(6) });
+    }
+    return keeps;
+}
+//# sourceMappingURL=silence.js.map

package/dist/core/silence.js.map

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

package/dist/core/silence.test.d.ts

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

package/dist/core/silence.test.d.ts.map

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

package/dist/core/silence.test.js

@@ -0,0 +1,143 @@
+import { describe, expect, it } from "vitest";
+import { keepRangesFromSilences, parseSilenceDetect, silencesToFrameRanges } from "./silence.js";
+describe("parseSilenceDetect", () => {
+    it("parses a clean pair", () => {
+        const stderr = `
+[silencedetect @ 0x1234] silence_start: 1.500
+[silencedetect @ 0x1234] silence_end: 3.000 | silence_duration: 1.500
+`;
+        expect(parseSilenceDetect(stderr)).toEqual([{ startSec: 1.5, endSec: 3.0, durSec: 1.5 }]);
+    });
+    it("parses multiple ranges interleaved with other ffmpeg log lines", () => {
+        const stderr = `
+frame=  100 fps=30 q=0
+[silencedetect @ 0x1] silence_start: 0.0
+size=N/A time=00:00:01
+[silencedetect @ 0x1] silence_end: 1.0 | silence_duration: 1.0
+[silencedetect @ 0x1] silence_start: 5.5
+[silencedetect @ 0x1] silence_end: 6.25 | silence_duration: 0.75
+`;
+        expect(parseSilenceDetect(stderr)).toEqual([
+            { startSec: 0, endSec: 1, durSec: 1 },
+            { startSec: 5.5, endSec: 6.25, durSec: 0.75 },
+        ]);
+    });
+    it("ignores end without preceding start", () => {
+        const stderr = `[silencedetect @ 0x1] silence_end: 2.0 | silence_duration: 2.0`;
+        expect(parseSilenceDetect(stderr)).toEqual([]);
+    });
+    it("closes trailing silence at totalSec when end is missing", () => {
+        const stderr = `[silencedetect @ 0x1] silence_start: 9.5`;
+        expect(parseSilenceDetect(stderr, 10)).toEqual([{ startSec: 9.5, endSec: 10, durSec: 0.5 }]);
+    });
+    it("does not close trailing silence when totalSec not provided", () => {
+        const stderr = `[silencedetect @ 0x1] silence_start: 9.5`;
+        expect(parseSilenceDetect(stderr)).toEqual([]);
+    });
+    it("rejects non-finite starts and starts more than a second negative", () => {
+        const stderr = `
+[silencedetect @ 0x1] silence_start: -5.0
+[silencedetect @ 0x1] silence_end: 2.0 | silence_duration: 3.0
+`;
+        expect(parseSilenceDetect(stderr)).toEqual([]);
+    });
+    it("clamps near-zero negative starts to 0 (leading-silence artifact)", () => {
+        // ffmpeg often emits silence_start: -0.00133333 when the file leads with
+        // silence — a filter look-back artifact. Real-world fixtures observed in
+        // the wild (danbooru, jappeace/cut-the-crap).
+        const stderr = `[silencedetect @ 0x1] silence_start: -0.00133333
+[silencedetect @ 0x1] silence_end: 1.5 | silence_duration: 1.5`;
+        const r = parseSilenceDetect(stderr);
+        expect(r).toHaveLength(1);
+        expect(r[0].startSec).toBe(0);
+        expect(r[0].endSec).toBe(1.5);
+    });
+    it("survives concatenated ffmpeg log junk after the start value", () => {
+        // jappeace test fixture: silence_start: 430.41'peed= 858x
+        const stderr = `[silencedetect @ 0x1] silence_start: 430.41'peed= 858x
+[silencedetect @ 0x1] silence_end: 432.5 | silence_duration: 2.09`;
+        const r = parseSilenceDetect(stderr);
+        expect(r).toHaveLength(1);
+        expect(r[0].startSec).toBe(430.41);
+        expect(r[0].endSec).toBe(432.5);
+    });
+});
+describe("silencesToFrameRanges", () => {
+    it("rounds inward (start ceils, end floors)", () => {
+        const r = silencesToFrameRanges([{ startSec: 1.01, endSec: 1.99, durSec: 0.98 }], 30);
+        // start: ceil(1.01 * 30) = 31. end: floor(1.99 * 30) = 59.
+        expect(r).toEqual([{ startFrame: 31, endFrame: 59 }]);
+    });
+    it("drops ranges that collapse after rounding", () => {
+        const r = silencesToFrameRanges([{ startSec: 1.01, endSec: 1.02, durSec: 0.01 }], 30);
+        expect(r).toEqual([]);
+    });
+});
+describe("keepRangesFromSilences", () => {
+    it("inverts silences to keeps", () => {
+        const k = keepRangesFromSilences([
+            { startSec: 1, endSec: 2, durSec: 1 },
+            { startSec: 5, endSec: 6, durSec: 1 },
+        ], 10);
+        expect(k).toEqual([
+            { startSec: 0, endSec: 1, durSec: 1 },
+            { startSec: 2, endSec: 5, durSec: 3 },
+            { startSec: 6, endSec: 10, durSec: 4 },
+        ]);
+    });
+    it("returns the whole duration when there are no silences", () => {
+        expect(keepRangesFromSilences([], 10)).toEqual([{ startSec: 0, endSec: 10, durSec: 10 }]);
+    });
+    it("applies padding without exceeding bounds or neighbours", () => {
+        const k = keepRangesFromSilences([{ startSec: 1, endSec: 2, durSec: 1 }], 10, 0.2);
+        // First keep: 0..1 padded to 0..1.2 (start clamped at 0)
+        // Second keep: 2..10 padded to 1.8..10 (end at totalSec, no cap needed)
+        expect(k[0].startSec).toBe(0);
+        expect(k[0].endSec).toBeCloseTo(1.2);
+        expect(k[1].startSec).toBeCloseTo(1.8);
+        expect(k[1].endSec).toBe(10);
+    });
+    it("emits no keeps when silence covers the entire file", () => {
+        expect(keepRangesFromSilences([{ startSec: 0, endSec: 10, durSec: 10 }], 10)).toEqual([]);
+    });
+    it("does not emit a zero-length keep between two adjacent silences", () => {
+        // Silence ends at 5; next silence starts at 5 — no keep should be emitted
+        // for the zero-width gap.
+        const k = keepRangesFromSilences([
+            { startSec: 1, endSec: 5, durSec: 4 },
+            { startSec: 5, endSec: 8, durSec: 3 },
+        ], 10);
+        // Two keeps total: 0..1 and 8..10. NO keep at [5,5].
+        expect(k).toEqual([
+            { startSec: 0, endSec: 1, durSec: 1 },
+            { startSec: 8, endSec: 10, durSec: 2 },
+        ]);
+    });
+    it("merges overlapping silences correctly", () => {
+        // s1 = [1,5], s2 = [3,8] (overlapping). cursor advances to max(5,8)=8.
+        const k = keepRangesFromSilences([
+            { startSec: 1, endSec: 5, durSec: 4 },
+            { startSec: 3, endSec: 8, durSec: 5 },
+        ], 10);
+        expect(k).toEqual([
+            { startSec: 0, endSec: 1, durSec: 1 },
+            { startSec: 8, endSec: 10, durSec: 2 },
+        ]);
+    });
+    it("handles a silence that runs past totalSec without spurious trailing keep", () => {
+        const k = keepRangesFromSilences([{ startSec: 5, endSec: 100, durSec: 95 }], 10);
+        expect(k).toEqual([{ startSec: 0, endSec: 5, durSec: 5 }]);
+    });
+    it("sorts unsorted input defensively", () => {
+        const k = keepRangesFromSilences([
+            { startSec: 5, endSec: 6, durSec: 1 },
+            { startSec: 1, endSec: 2, durSec: 1 },
+        ], 10);
+        expect(k).toEqual([
+            { startSec: 0, endSec: 1, durSec: 1 },
+            { startSec: 2, endSec: 5, durSec: 3 },
+            { startSec: 6, endSec: 10, durSec: 4 },
+        ]);
+    });
+});
+//# sourceMappingURL=silence.test.js.map

package/dist/core/silence.test.js.map

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

package/dist/core/skills-loader.d.ts

@@ -0,0 +1,34 @@
+import type { BundledSkill } from "../skills.js";
+/**
+ * User-extensible skill discovery.
+ *
+ * Priority (last wins on name collisions):
+ *   bundled (compiled into the package)
+ *   → project (<cwd>/.gg/editor-skills/*.md)
+ *   → user    (~/.gg/editor-skills/*.md)
+ *
+ * Silent override is the intended behaviour. The system prompt's skill list
+ * tags overridden entries so the agent (and the user) can see the layering.
+ */
+export interface SkillSource {
+    name: string;
+    description: string;
+    content: string;
+    origin: "bundled" | "project" | "user";
+    /** Absolute path on disk (project / user only). */
+    path?: string;
+}
+export interface DiscoverSkillsOptions {
+    cwd: string;
+    homeDir?: string;
+    bundled: BundledSkill[];
+}
+export declare function discoverSkills(opts: DiscoverSkillsOptions): SkillSource[];
+/**
+ * Extract a one-line description from a skill markdown.
+ *
+ * Strategy: the first non-empty, non-heading line of plain text. Truncated at
+ * 200 chars. Falls back to "(no description)" if absent.
+ */
+export declare function extractDescription(content: string): string;
+//# sourceMappingURL=skills-loader.d.ts.map

package/dist/core/skills-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-loader.d.ts","sourceRoot":"","sources":["../../src/core/skills-loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,WAAW,EAAE,CAqBzE;AAiCD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAW1D"}