@they-juanreina/compost-cli 0.1.0-rc.1

package/dist/lib/transcribeNative.d.ts

@@ -0,0 +1,44 @@
+import { type SpawnSyncReturns } from 'node:child_process';
+/** Injectable spawn surface (real `spawnSync` in prod; a fake in tests). */
+export type SpawnImpl = (cmd: string, args: string[], opts: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    encoding: 'utf8';
+    maxBuffer: number;
+}) => Pick<SpawnSyncReturns<string>, 'status' | 'stdout' | 'stderr' | 'error'>;
+/**
+ * Native (host) transcription path (#176): shell out to the transcriber
+ * package's `app.transcribe_cli` running in a host Python venv, so Apple-Silicon
+ * ASR (`parakeet-mlx` / Metal) and pyannote use the GPU/CPU directly instead of
+ * the CPU-only Docker container. The Python entrypoint shares the exact same
+ * `run_pipeline` orchestration as the Docker `/transcribe` route.
+ */
+export interface NativeTranscribeOptions {
+    /** Path to a Python (3.11+) interpreter in a venv with the native deps. */
+    python: string;
+    /** Directory containing the `app` package (the transcriber/ root). */
+    transcriberDir: string;
+    /** ASR engine: 'parakeet' (default, native Metal) or 'whisper'. */
+    engine: string;
+    /** Optional ASR model id (engine default when omitted). */
+    model?: string;
+    /** Optional language hint (recorded; Parakeet v3 auto-detects). */
+    language?: string;
+    /** Extra env (e.g. HUGGINGFACE_TOKEN for pyannote). Merged over process.env. */
+    env?: NodeJS.ProcessEnv;
+    /** Injectable spawn (tests). Defaults to node:child_process spawnSync. */
+    spawnImpl?: SpawnImpl;
+}
+export interface NativeTranscribeResult {
+    session_id: string;
+    transcript_path: string;
+    status: string;
+    engine?: string;
+    model?: string;
+    error?: string;
+}
+/** Run the native transcriber entrypoint synchronously and return its parsed
+ * JSON result. Throws a CompostError on spawn failure, non-zero exit, or a
+ * `status: "failed"` payload. */
+export declare function transcribeNative(seedPath: string, sessionId: string, sourcePath: string, opts: NativeTranscribeOptions): NativeTranscribeResult;
+//# sourceMappingURL=transcribeNative.d.ts.map

package/dist/lib/transcribeNative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcribeNative.d.ts","sourceRoot":"","sources":["../../src/lib/transcribeNative.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAa,MAAM,oBAAoB,CAAA;AAIrE,4EAA4E;AAC5E,MAAM,MAAM,SAAS,GAAG,CACtB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,KAC/E,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC,CAAA;AAE7E;;;;;;GAMG;AAEH,MAAM,WAAW,uBAAuB;IACtC,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAA;IACd,sEAAsE;IACtE,cAAc,EAAE,MAAM,CAAA;IACtB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAA;IACd,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gFAAgF;IAChF,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;iCAEiC;AACjC,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,uBAAuB,GAC5B,sBAAsB,CAqDxB"}

package/dist/lib/transcribeNative.js

@@ -0,0 +1,53 @@
+import { spawnSync } from 'node:child_process';
+import { CompostError } from '../errors.js';
+/** Run the native transcriber entrypoint synchronously and return its parsed
+ * JSON result. Throws a CompostError on spawn failure, non-zero exit, or a
+ * `status: "failed"` payload. */
+export function transcribeNative(seedPath, sessionId, sourcePath, opts) {
+    const args = [
+        '-m',
+        'app.transcribe_cli',
+        '--seed-path',
+        seedPath,
+        '--session-id',
+        sessionId,
+        '--source-path',
+        sourcePath,
+        '--engine',
+        opts.engine,
+    ];
+    if (opts.model)
+        args.push('--model', opts.model);
+    if (opts.language)
+        args.push('--language', opts.language);
+    const spawn = opts.spawnImpl ?? spawnSync;
+    const res = spawn(opts.python, args, {
+        cwd: opts.transcriberDir,
+        env: { ...process.env, ...opts.env },
+        encoding: 'utf8',
+        maxBuffer: 64 * 1024 * 1024,
+    });
+    if (res.error) {
+        throw new CompostError('PROVIDER_ERROR', `native transcriber failed to start (${opts.python}): ${res.error.message}. ` +
+            'Run `compost setup` to provision the native transcription venv.');
+    }
+    // The entrypoint prints exactly one JSON line; take the last non-empty line.
+    const lastLine = (res.stdout || '').trim().split('\n').filter(Boolean).pop() ?? '';
+    let parsed;
+    try {
+        // JSON.parse succeeds on primitives (null, 123, "s"); require an object so a
+        // stray non-object line surfaces as the CompostError below, not a raw TypeError.
+        const value = JSON.parse(lastLine);
+        if (typeof value !== 'object' || value === null)
+            throw new Error('not a JSON object');
+        parsed = value;
+    }
+    catch {
+        throw new CompostError('PROVIDER_ERROR', `native transcriber produced no parseable result. stderr: ${(res.stderr || '').slice(-400)}`);
+    }
+    if (res.status !== 0 || parsed.status === 'failed') {
+        throw new CompostError('PROVIDER_ERROR', `native transcription failed: ${parsed.error ?? (res.stderr || '').slice(-400)}`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=transcribeNative.js.map

package/dist/lib/transcribeNative.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcribeNative.js","sourceRoot":"","sources":["../../src/lib/transcribeNative.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAErE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AA2C3C;;iCAEiC;AACjC,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,SAAiB,EACjB,UAAkB,EAClB,IAA6B;IAE7B,MAAM,IAAI,GAAG;QACX,IAAI;QACJ,oBAAoB;QACpB,aAAa;QACb,QAAQ;QACR,cAAc;QACd,SAAS;QACT,eAAe;QACf,UAAU;QACV,UAAU;QACV,IAAI,CAAC,MAAM;KACZ,CAAA;IACD,IAAI,IAAI,CAAC,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;IAChD,IAAI,IAAI,CAAC,QAAQ;QAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;IAEzD,MAAM,KAAK,GAAc,IAAI,CAAC,SAAS,IAAK,SAAkC,CAAA;IAC9E,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE;QACnC,GAAG,EAAE,IAAI,CAAC,cAAc;QACxB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE;QACpC,QAAQ,EAAE,MAAM;QAChB,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;KAC5B,CAAC,CAAA;IAEF,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QACd,MAAM,IAAI,YAAY,CACpB,gBAAgB,EAChB,uCAAuC,IAAI,CAAC,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI;YAC3E,iEAAiE,CACpE,CAAA;IACH,CAAC;IACD,6EAA6E;IAC7E,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAA;IAClF,IAAI,MAA8B,CAAA;IAClC,IAAI,CAAC;QACH,6EAA6E;QAC7E,iFAAiF;QACjF,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;QAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAA;QACrF,MAAM,GAAG,KAA+B,CAAA;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,YAAY,CACpB,gBAAgB,EAChB,4DAA4D,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAC7F,CAAA;IACH,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACnD,MAAM,IAAI,YAAY,CACpB,gBAAgB,EAChB,gCAAgC,MAAM,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CACjF,CAAA;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/lib/transcript.d.ts

@@ -0,0 +1,68 @@
+export interface TranscriptSpeaker {
+    id: string;
+    name?: string;
+    type: 'moderator' | 'participant' | 'other';
+}
+export interface TranscriptWord {
+    w: string;
+    s: number;
+    e: number;
+    conf?: number;
+}
+export interface TranscriptProsody {
+    volume?: 'low' | 'normal' | 'high';
+    pace?: 'slow' | 'normal' | 'fast';
+    hesitations?: number;
+}
+export interface TranscriptUtterance {
+    id: string;
+    speaker_id: string;
+    turn: number;
+    start_ms: number;
+    end_ms: number;
+    text: string;
+    words?: TranscriptWord[];
+    prosody?: TranscriptProsody;
+    annotation?: string;
+}
+export interface TranscriptSilence {
+    id: string;
+    start_ms: number;
+    end_ms: number;
+    duration_ms: number;
+    context: 'after_question' | 'mid_utterance' | 'thinking' | 'interruption';
+    annotation?: string;
+}
+export interface TranscriptCue {
+    id: string;
+    kind: string;
+    start_ms: number;
+    end_ms: number;
+    source: 'audio';
+    speaker_id?: string;
+    confidence?: number;
+    annotation?: string;
+}
+export interface TranscriptFrame {
+    id: string;
+    at_ms: number;
+    path: string;
+    trigger: string;
+    linked_utterance_id?: string;
+    annotation?: string;
+}
+export interface Transcript {
+    schema_version: string;
+    session_id: string;
+    source: string;
+    language: string;
+    duration_ms: number;
+    modality: string[];
+    speakers: TranscriptSpeaker[];
+    utterances: TranscriptUtterance[];
+    silences?: TranscriptSilence[];
+    cues?: TranscriptCue[];
+    frames?: TranscriptFrame[];
+}
+export declare function wordCount(text: string): number;
+//# sourceMappingURL=transcript.d.ts.map

package/dist/lib/transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../src/lib/transcript.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,WAAW,GAAG,aAAa,GAAG,OAAO,CAAA;CAC5C;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;IAClC,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAA;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,cAAc,EAAE,CAAA;IACxB,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,gBAAgB,GAAG,eAAe,GAAG,UAAU,GAAG,cAAc,CAAA;IACzE,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,EAAE,iBAAiB,EAAE,CAAA;IAC7B,UAAU,EAAE,mBAAmB,EAAE,CAAA;IACjC,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAA;IAC9B,IAAI,CAAC,EAAE,aAAa,EAAE,CAAA;IACtB,MAAM,CAAC,EAAE,eAAe,EAAE,CAAA;CAC3B;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI9C"}

package/dist/lib/transcript.js

@@ -0,0 +1,10 @@
+// Minimal structural types for the rich transcript (schema/transcript.schema.json).
+// The CLI reads transcripts produced by the Python transcriber; these types cover
+// the fields the Node side consumes. Full validation lives in `compost validate`.
+export function wordCount(text) {
+    const trimmed = text.trim();
+    if (trimmed.length === 0)
+        return 0;
+    return trimmed.split(/\s+/).length;
+}
+//# sourceMappingURL=transcript.js.map

package/dist/lib/transcript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.js","sourceRoot":"","sources":["../../src/lib/transcript.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,kFAAkF;AAClF,kFAAkF;AA4ElF,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAC3B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IAClC,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAA;AACpC,CAAC"}

package/dist/lib/validate.d.ts

@@ -0,0 +1,16 @@
+export interface ValidateResult {
+    ok: boolean;
+    path: string;
+    schema: string;
+    errors: unknown;
+}
+export declare function validateTranscript(path: string): ValidateResult;
+export declare function validateEventsExport(path: string): ValidateResult;
+/**
+ * Validate cue kinds in a transcript against the cues taxonomy.
+ * Path may be a transcript.json (we inspect cues[]) or the taxonomy file itself
+ * (sanity check of its own shape).
+ */
+export declare function validateCues(path: string): ValidateResult;
+export declare function validateFrames(path: string): ValidateResult;
+//# sourceMappingURL=validate.d.ts.map

package/dist/lib/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/lib/validate.ts"],"names":[],"mappings":"AAyDA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;CAChB;AAaD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAU/D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAwBjE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAuCzD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAqC3D"}

package/dist/lib/validate.js

@@ -0,0 +1,155 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { Ajv2020 } from 'ajv/dist/2020.js';
+import addFormatsImport from 'ajv-formats';
+import { CompostError } from '../errors.js';
+import { CUES_TAXONOMY, EVENTS_SCHEMA, FRAMES_TAXONOMY, TRANSCRIPT_SCHEMA, } from './schemas.generated.js';
+const addFormats = addFormatsImport.default ??
+    addFormatsImport;
+const ajv = new Ajv2020({ strict: false, allErrors: true });
+addFormats(ajv);
+let transcriptValidator = null;
+let eventsValidator = null;
+function getTranscriptValidator() {
+    if (transcriptValidator === null) {
+        const fn = ajv.compile(TRANSCRIPT_SCHEMA);
+        transcriptValidator = { fn, errors: () => fn.errors };
+    }
+    return transcriptValidator;
+}
+function getEventsValidator() {
+    if (eventsValidator === null) {
+        const fn = ajv.compile(EVENTS_SCHEMA);
+        eventsValidator = { fn, errors: () => fn.errors };
+    }
+    return eventsValidator;
+}
+function getCuesTaxonomy() {
+    return CUES_TAXONOMY;
+}
+function getFramesTaxonomy() {
+    return FRAMES_TAXONOMY;
+}
+function readJson(path) {
+    if (!existsSync(path)) {
+        throw new CompostError('FILE_NOT_FOUND', `No such file: ${path}`);
+    }
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch (err) {
+        throw new CompostError('INVALID_INPUT', `Failed to parse JSON at ${path}: ${String(err)}`);
+    }
+}
+export function validateTranscript(path) {
+    const data = readJson(path);
+    const v = getTranscriptValidator();
+    const ok = v.fn(data);
+    return {
+        ok,
+        path,
+        schema: 'transcript.schema.json',
+        errors: ok ? null : v.errors(),
+    };
+}
+export function validateEventsExport(path) {
+    // The schema describes a single event; an export is typically a JSON array.
+    // Accept either: an array → validate each; an object → validate as one event.
+    const data = readJson(path);
+    const v = getEventsValidator();
+    if (Array.isArray(data)) {
+        const errors = [];
+        for (const [i, evt] of data.entries()) {
+            if (!v.fn(evt))
+                errors.push({ index: i, errors: v.errors() });
+        }
+        return {
+            ok: errors.length === 0,
+            path,
+            schema: 'events.schema.json',
+            errors: errors.length === 0 ? null : errors,
+        };
+    }
+    const ok = v.fn(data);
+    return {
+        ok,
+        path,
+        schema: 'events.schema.json',
+        errors: ok ? null : v.errors(),
+    };
+}
+/**
+ * Validate cue kinds in a transcript against the cues taxonomy.
+ * Path may be a transcript.json (we inspect cues[]) or the taxonomy file itself
+ * (sanity check of its own shape).
+ */
+export function validateCues(path) {
+    const data = readJson(path);
+    const taxonomy = getCuesTaxonomy();
+    const allowed = new Set(taxonomy.kinds.map((k) => k.kind));
+    if (Array.isArray(data.kinds)) {
+        // Treat as a taxonomy file — verify shape.
+        const errors = [];
+        for (const k of data.kinds) {
+            if (typeof k !== 'object' ||
+                k === null ||
+                typeof k.kind !== 'string') {
+                errors.push(`taxonomy entry missing string 'kind': ${JSON.stringify(k)}`);
+            }
+        }
+        return {
+            ok: errors.length === 0,
+            path,
+            schema: 'cues.taxonomy.json',
+            errors: errors.length === 0 ? null : errors,
+        };
+    }
+    // Treat as a transcript — check cues[].kind values against the taxonomy.
+    const cues = data.cues ?? [];
+    const errors = [];
+    for (const [i, cue] of cues.entries()) {
+        if (typeof cue.kind !== 'string' || !allowed.has(cue.kind)) {
+            errors.push({ index: i, kind: cue.kind, reason: `not in cues taxonomy` });
+        }
+    }
+    return {
+        ok: errors.length === 0,
+        path,
+        schema: 'cues.taxonomy.json',
+        errors: errors.length === 0 ? null : errors,
+    };
+}
+export function validateFrames(path) {
+    const data = readJson(path);
+    const taxonomy = getFramesTaxonomy();
+    const allowed = new Set(taxonomy.triggers.map((t) => t.trigger));
+    if (Array.isArray(data.triggers)) {
+        const errors = [];
+        for (const t of data.triggers) {
+            if (typeof t !== 'object' ||
+                t === null ||
+                typeof t.trigger !== 'string') {
+                errors.push(`taxonomy entry missing string 'trigger': ${JSON.stringify(t)}`);
+            }
+        }
+        return {
+            ok: errors.length === 0,
+            path,
+            schema: 'frames.taxonomy.json',
+            errors: errors.length === 0 ? null : errors,
+        };
+    }
+    const frames = data.frames ?? [];
+    const errors = [];
+    for (const [i, frame] of frames.entries()) {
+        if (typeof frame.trigger !== 'string' || !allowed.has(frame.trigger)) {
+            errors.push({ index: i, trigger: frame.trigger, reason: `not in frames taxonomy` });
+        }
+    }
+    return {
+        ok: errors.length === 0,
+        path,
+        schema: 'frames.taxonomy.json',
+        errors: errors.length === 0 ? null : errors,
+    };
+}
+//# sourceMappingURL=validate.js.map

package/dist/lib/validate.js.map

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

package/dist/llm/adapter.d.ts

@@ -0,0 +1,33 @@
+import { type CompostConfig } from '../lib/config.js';
+import type { ChatMessage, ChatResponse, EmbedResponse, FetchLike, Provider, ProviderHealth } from './types.js';
+export interface AdapterOptions {
+    /** Inject a fetch stub for tests. Applied to every constructed provider. */
+    fetchImpl?: FetchLike;
+}
+export declare class LLMAdapter {
+    private readonly config;
+    private readonly opts;
+    private readonly providers;
+    constructor(config: CompostConfig, opts?: AdapterOptions);
+    /** Construct (and cache) the driver for a provider name. */
+    getProvider(name: string): Provider;
+    /** Resolve a task to its routed provider+model via the [defaults] table. */
+    resolveTask(task: string): {
+        provider: string;
+        model: string;
+    };
+    chat(task: string, messages: ChatMessage[], extra?: {
+        schema?: Record<string, unknown>;
+        temperature?: number;
+        maxTokens?: number;
+    }): Promise<ChatResponse>;
+    embed(task: string, input: string[]): Promise<EmbedResponse>;
+    /** Fail fast with an actionable message when a task routes to a key-requiring
+     * provider whose key isn't set — instead of a raw 401 from the HTTP layer. A
+     * provider needs a key iff it declares `api_key_env` in [providers] (local
+     * providers like ollama/lmstudio don't). */
+    private assertProviderHasKey;
+    /** Probe every distinct provider referenced by [defaults] plus those configured. */
+    healthAll(): Promise<Record<string, ProviderHealth>>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/llm/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/llm/adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,aAAa,EAA+C,MAAM,kBAAkB,CAAA;AAKlG,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,aAAa,EACb,SAAS,EACT,QAAQ,EACR,cAAc,EACf,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAED,qBAAa,UAAU;IAInB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;gBAGrC,MAAM,EAAE,aAAa,EACrB,IAAI,GAAE,cAAmB;IAG5C,4DAA4D;IAC5D,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAiCnC,4EAA4E;IAC5E,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAQxD,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACzF,OAAO,CAAC,YAAY,CAAC;IAMlB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAMlE;;;gDAG4C;IAC5C,OAAO,CAAC,oBAAoB;IAW5B,oFAAoF;IAC9E,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CA0B3D"}

package/dist/llm/adapter.js

@@ -0,0 +1,106 @@
+import { CompostError } from '../errors.js';
+import { parseRoute, providerApiKey, providerBaseUrl } from '../lib/config.js';
+import { AnthropicProvider } from './providers/anthropic.js';
+import { LMStudioProvider } from './providers/lmstudio.js';
+import { OllamaProvider } from './providers/ollama.js';
+import { OpenAIProvider } from './providers/openai.js';
+export class LLMAdapter {
+    config;
+    opts;
+    providers = new Map();
+    constructor(config, opts = {}) {
+        this.config = config;
+        this.opts = opts;
+    }
+    /** Construct (and cache) the driver for a provider name. */
+    getProvider(name) {
+        const cached = this.providers.get(name);
+        if (cached)
+            return cached;
+        const baseUrl = providerBaseUrl(this.config, name);
+        const apiKey = providerApiKey(this.config, name);
+        const cfg = {
+            baseUrl,
+            ...(apiKey !== undefined ? { apiKey } : {}),
+            ...(this.opts.fetchImpl ? { fetchImpl: this.opts.fetchImpl } : {}),
+        };
+        let provider;
+        switch (name) {
+            case 'ollama':
+                provider = new OllamaProvider(cfg);
+                break;
+            case 'lmstudio':
+                provider = new LMStudioProvider(cfg);
+                break;
+            case 'openai':
+                provider = new OpenAIProvider(cfg);
+                break;
+            case 'anthropic':
+                provider = new AnthropicProvider(cfg);
+                break;
+            default:
+                throw new CompostError('CONFIG_ERROR', `Unknown provider "${name}"`);
+        }
+        this.providers.set(name, provider);
+        return provider;
+    }
+    /** Resolve a task to its routed provider+model via the [defaults] table. */
+    resolveTask(task) {
+        const route = this.config.defaults[task];
+        if (route === undefined) {
+            throw new CompostError('CONFIG_ERROR', `No route configured for task "${task}" in [defaults]`);
+        }
+        return parseRoute(route);
+    }
+    async chat(task, messages, extra = {}) {
+        const { provider, model } = this.resolveTask(task);
+        this.assertProviderHasKey(task, provider);
+        return this.getProvider(provider).chat({ model, messages, ...extra });
+    }
+    async embed(task, input) {
+        const { provider, model } = this.resolveTask(task);
+        this.assertProviderHasKey(task, provider);
+        return this.getProvider(provider).embed({ model, input });
+    }
+    /** Fail fast with an actionable message when a task routes to a key-requiring
+     * provider whose key isn't set — instead of a raw 401 from the HTTP layer. A
+     * provider needs a key iff it declares `api_key_env` in [providers] (local
+     * providers like ollama/lmstudio don't). */
+    assertProviderHasKey(task, provider) {
+        const envName = this.config.providers[provider]?.api_key_env;
+        if (envName === undefined)
+            return; // local provider — no key needed
+        if (providerApiKey(this.config, provider) !== undefined)
+            return; // key present
+        throw new CompostError('CONFIG_ERROR', `The "${task}" task routes to ${provider}, which needs an API key — set ${envName}, ` +
+            'or route to a local model (e.g. `compost chat --task quick_chat`).');
+    }
+    /** Probe every distinct provider referenced by [defaults] plus those configured. */
+    async healthAll() {
+        const names = new Set(Object.keys(this.config.providers));
+        for (const route of Object.values(this.config.defaults)) {
+            try {
+                names.add(parseRoute(route).provider);
+            }
+            catch {
+                // skip malformed routes; doctor surfaces them separately
+            }
+        }
+        const out = {};
+        await Promise.all([...names].map(async (name) => {
+            try {
+                out[name] = await this.getProvider(name).health();
+            }
+            catch (err) {
+                out[name] = {
+                    ok: false,
+                    latency_ms: 0,
+                    model_list: [],
+                    error: err instanceof Error ? err.message : String(err),
+                };
+            }
+        }));
+        return out;
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/llm/adapter.js.map

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

package/dist/llm/http.d.ts

@@ -0,0 +1,9 @@
+import type { FetchLike } from './types.js';
+export declare function resolveFetch(injected?: FetchLike): FetchLike;
+export interface TimedJson {
+    json: unknown;
+    latency_ms: number;
+}
+export declare function postJson(fetchImpl: FetchLike, url: string, body: unknown, headers?: Record<string, string>, timeoutMs?: number): Promise<unknown>;
+export declare function getJsonTimed(fetchImpl: FetchLike, url: string, headers?: Record<string, string>, timeoutMs?: number): Promise<TimedJson>;
+//# sourceMappingURL=http.d.ts.map

package/dist/llm/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/llm/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,SAAS,GAAG,SAAS,CAI5D;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;CACnB;AAOD,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACb,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACpC,SAAS,SAAS,GACjB,OAAO,CAAC,OAAO,CAAC,CAkBlB;AAED,wBAAsB,YAAY,CAChC,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACpC,SAAS,SAAQ,GAChB,OAAO,CAAC,SAAS,CAAC,CAepB"}

package/dist/llm/http.js

@@ -0,0 +1,56 @@
+export function resolveFetch(injected) {
+    if (injected)
+        return injected;
+    // Node 18+ has global fetch. Cast through the structural FetchLike.
+    return globalThis.fetch;
+}
+/** A monotonic-ish clock that does not use Date.now directly in hot paths. */
+function nowMs() {
+    return performance.now();
+}
+export async function postJson(fetchImpl, url, body, headers = {}, timeoutMs = 120000) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetchImpl(url, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json', ...headers },
+            body: JSON.stringify(body),
+            signal: controller.signal,
+        });
+        if (!res.ok) {
+            const detail = await safeText(res);
+            throw new Error(`POST ${url} → ${res.status} ${res.statusText}: ${detail}`);
+        }
+        return await res.json();
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export async function getJsonTimed(fetchImpl, url, headers = {}, timeoutMs = 10000) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    const start = nowMs();
+    try {
+        const res = await fetchImpl(url, { method: 'GET', headers, signal: controller.signal });
+        const latency_ms = Math.round(nowMs() - start);
+        if (!res.ok) {
+            const detail = await safeText(res);
+            throw new Error(`GET ${url} → ${res.status} ${res.statusText}: ${detail}`);
+        }
+        return { json: await res.json(), latency_ms };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function safeText(res) {
+    try {
+        return (await res.text()).slice(0, 200);
+    }
+    catch {
+        return '<no body>';
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/llm/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/llm/http.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAAC,QAAoB;IAC/C,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAC7B,oEAAoE;IACpE,OAAO,UAAU,CAAC,KAA6B,CAAA;AACjD,CAAC;AAOD,8EAA8E;AAC9E,SAAS,KAAK;IACZ,OAAO,WAAW,CAAC,GAAG,EAAE,CAAA;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,SAAoB,EACpB,GAAW,EACX,IAAa,EACb,UAAkC,EAAE,EACpC,SAAS,GAAG,MAAM;IAElB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;IACxC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAA;IAC7D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE;YAC/B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,OAAO,EAAE;YAC3D,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC1B,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAA;QACF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAA;YAClC,MAAM,IAAI,KAAK,CAAC,QAAQ,GAAG,MAAM,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC,CAAA;QAC7E,CAAC;QACD,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;IACzB,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAA;IACrB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,SAAoB,EACpB,GAAW,EACX,UAAkC,EAAE,EACpC,SAAS,GAAG,KAAK;IAEjB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;IACxC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAA;IAC7D,MAAM,KAAK,GAAG,KAAK,EAAE,CAAA;IACrB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAA;QACvF,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,CAAA;QAC9C,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAA;YAClC,MAAM,IAAI,KAAK,CAAC,OAAO,GAAG,MAAM,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC,CAAA;QAC5E,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,CAAA;IAC/C,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAA;IACrB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,GAAoC;IAC1D,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,WAAW,CAAA;IACpB,CAAC;AACH,CAAC"}

package/dist/llm/providers/anthropic.d.ts

@@ -0,0 +1,14 @@
+import type { ChatRequest, ChatResponse, EmbedRequest, EmbedResponse, Provider, ProviderConfig, ProviderHealth } from '../types.js';
+export declare class AnthropicProvider implements Provider {
+    readonly name = "anthropic";
+    private readonly base;
+    private readonly apiKey;
+    private readonly fetchImpl;
+    private readonly timeoutMs;
+    constructor(config: ProviderConfig);
+    private headers;
+    chat(req: ChatRequest): Promise<ChatResponse>;
+    embed(_req: EmbedRequest): Promise<EmbedResponse>;
+    health(): Promise<ProviderHealth>;
+}
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/llm/providers/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/llm/providers/anthropic.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EAEb,QAAQ,EACR,cAAc,EACd,cAAc,EACf,MAAM,aAAa,CAAA;AAIpB,qBAAa,iBAAkB,YAAW,QAAQ;IAChD,QAAQ,CAAC,IAAI,eAAc;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;gBAEtB,MAAM,EAAE,cAAc;IAOlC,OAAO,CAAC,OAAO;IAOT,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAiC7C,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAMjD,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;CAkBxC"}