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

package/dist/lib/export.js

@@ -0,0 +1,36 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { CompostError } from '../errors.js';
+import { transcriptToCsv } from '../exporters/csv.js';
+import { transcriptToEaf } from '../exporters/eaf.js';
+import { transcriptToMarkdown } from '../exporters/md.js';
+export function loadTranscript(path) {
+    if (!existsSync(path)) {
+        throw new CompostError('FILE_NOT_FOUND', `No transcript at ${path}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch (cause) {
+        throw new CompostError('INVALID_INPUT', `Could not parse JSON at ${path}`, { cause });
+    }
+    const t = parsed;
+    if (typeof t.session_id !== 'string' || !Array.isArray(t.utterances)) {
+        throw new CompostError('SCHEMA_VIOLATION', `${path} is not a transcript (missing session_id or utterances)`);
+    }
+    return parsed;
+}
+export function exportTranscript(transcript, opts) {
+    let content;
+    if (opts.format === 'csv') {
+        content = transcriptToCsv(transcript, opts.createdDate !== undefined ? { createdDate: opts.createdDate } : {});
+    }
+    else if (opts.format === 'eaf') {
+        content = transcriptToEaf(transcript);
+    }
+    else {
+        content = transcriptToMarkdown(transcript);
+    }
+    return { format: opts.format, session_id: transcript.session_id, content };
+}
+//# sourceMappingURL=export.js.map

package/dist/lib/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/lib/export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAgBzD,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,YAAY,CAAC,gBAAgB,EAAE,oBAAoB,IAAI,EAAE,CAAC,CAAA;IACtE,CAAC;IACD,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;IACjD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,YAAY,CAAC,eAAe,EAAE,2BAA2B,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;IACvF,CAAC;IACD,MAAM,CAAC,GAAG,MAA6B,CAAA;IACvC,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,YAAY,CACpB,kBAAkB,EAClB,GAAG,IAAI,yDAAyD,CACjE,CAAA;IACH,CAAC;IACD,OAAO,MAAoB,CAAA;AAC7B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAAsB,EAAE,IAAmB;IAC1E,IAAI,OAAe,CAAA;IACnB,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QAC1B,OAAO,GAAG,eAAe,CACvB,UAAU,EACV,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CACxE,CAAA;IACH,CAAC;SAAM,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QACjC,OAAO,GAAG,eAAe,CAAC,UAAU,CAAC,CAAA;IACvC,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAA;IAC5C,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,UAAU,EAAE,OAAO,EAAE,CAAA;AAC5E,CAAC"}

package/dist/lib/ingest.d.ts

@@ -0,0 +1,21 @@
+export interface IngestItem {
+    path: string;
+    kind: string;
+    category: string;
+    job_id: number;
+    queued: boolean;
+}
+export interface IngestResult {
+    seed: string;
+    queued: number;
+    skipped: number;
+    unsupported: string[];
+    items: IngestItem[];
+}
+/**
+ * Route a file or folder into the job queue. Folder ingest is resumable:
+ * jobs are unique on (kind, source_path), so a re-run only enqueues new files.
+ * Each newly-queued file emits an agent-authored `create` event.
+ */
+export declare function ingestPath(seedPath: string, target: string): IngestResult;
+//# sourceMappingURL=ingest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../src/lib/ingest.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,KAAK,EAAE,UAAU,EAAE,CAAA;CACpB;AAcD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAsCzE"}

package/dist/lib/ingest.js

@@ -0,0 +1,68 @@
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { CompostError } from '../errors.js';
+import { classify } from './dispatch.js';
+import { emitAgentCreate, openSeedEvents } from './events.js';
+import { JobQueue, stateDbPath } from './queue.js';
+const AGENT_NAME = 'ingest';
+const AGENT_VERSION = '0.1.0';
+function walk(path) {
+    if (statSync(path).isFile())
+        return [path];
+    const out = [];
+    for (const entry of readdirSync(path)) {
+        if (entry.startsWith('.'))
+            continue;
+        const abs = join(path, entry);
+        if (statSync(abs).isDirectory())
+            out.push(...walk(abs));
+        else
+            out.push(abs);
+    }
+    return out;
+}
+/**
+ * Route a file or folder into the job queue. Folder ingest is resumable:
+ * jobs are unique on (kind, source_path), so a re-run only enqueues new files.
+ * Each newly-queued file emits an agent-authored `create` event.
+ */
+export function ingestPath(seedPath, target) {
+    if (!existsSync(target))
+        throw new CompostError('FILE_NOT_FOUND', `No such path: ${target}`);
+    const files = walk(target);
+    const queue = new JobQueue(stateDbPath(seedPath));
+    const events = openSeedEvents(seedPath);
+    try {
+        const items = [];
+        const unsupported = [];
+        let queued = 0;
+        let skipped = 0;
+        for (const file of files) {
+            const d = classify(file);
+            if (d === null) {
+                unsupported.push(file);
+                continue;
+            }
+            const { id, inserted } = queue.enqueue(d.kind, file, { category: d.category, ext: d.ext });
+            if (inserted) {
+                queued += 1;
+                emitAgentCreate(events, {
+                    artifactKind: 'ingest_job',
+                    initialState: { source_path: file, kind: d.kind, category: d.category },
+                    agentName: AGENT_NAME,
+                    agentVersion: AGENT_VERSION,
+                });
+            }
+            else {
+                skipped += 1;
+            }
+            items.push({ path: file, kind: d.kind, category: d.category, job_id: id, queued: inserted });
+        }
+        return { seed: seedPath, queued, skipped, unsupported, items };
+    }
+    finally {
+        queue.close();
+        events.close();
+    }
+}
+//# sourceMappingURL=ingest.js.map

package/dist/lib/ingest.js.map

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

package/dist/lib/journal.d.ts

@@ -0,0 +1,23 @@
+export interface JournalVersion {
+    ts: string;
+    body: string;
+}
+/** Split an AGENTS.md into versioned sections. The leading content (before any
+ * version marker) is the current working draft. */
+export declare function parseVersions(content: string): {
+    draft: string;
+    versions: JournalVersion[];
+};
+/** Append the current draft as a timestamped version section (git-less
+ * fallback). Returns the new file content. Idempotent if the draft is empty. */
+export declare function appendVersion(content: string, ts: string): string;
+export interface DiffLine {
+    type: 'add' | 'del' | 'ctx';
+    text: string;
+}
+/** A minimal line-level diff (LCS) between two versions, for the diff view. */
+export declare function diffLines(a: string, b: string): DiffLine[];
+export declare function agentsPath(seedPath: string): string;
+export declare function readJournal(seedPath: string): string;
+export declare function saveJournalVersion(seedPath: string, ts: string): void;
+//# sourceMappingURL=journal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../src/lib/journal.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;CACb;AAED;mDACmD;AACnD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,cAAc,EAAE,CAAA;CAAE,CAoB5F;AAED;gFACgF;AAChF,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAMjE;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAA;IAC3B,IAAI,EAAE,MAAM,CAAA;CACb;AAED,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,QAAQ,EAAE,CA+B1D;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAIrE"}

package/dist/lib/journal.js

@@ -0,0 +1,95 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+// Prompt-journal version/diff logic (#62). The seed's .compost/AGENTS.md is
+// the prompt journal loops read. When git is initialized the web UI commits on
+// save; otherwise we append a timestamped version section so history is never
+// lost. This module is the pure core consumed by the web page + a CLI command.
+const VERSION_RE = /^<!-- compost:version (.+?) -->$/;
+/** Split an AGENTS.md into versioned sections. The leading content (before any
+ * version marker) is the current working draft. */
+export function parseVersions(content) {
+    const lines = content.split('\n');
+    const versions = [];
+    const draftLines = [];
+    let current = null;
+    for (const line of lines) {
+        const m = VERSION_RE.exec(line);
+        if (m !== null) {
+            if (current !== null)
+                versions.push(current);
+            current = { ts: m[1], body: '' };
+            continue;
+        }
+        if (current === null)
+            draftLines.push(line);
+        else
+            current.body += `${line}\n`;
+    }
+    if (current !== null)
+        versions.push(current);
+    return {
+        draft: draftLines.join('\n').trimEnd(),
+        versions: versions.map((v) => ({ ts: v.ts, body: v.body.trimEnd() })),
+    };
+}
+/** Append the current draft as a timestamped version section (git-less
+ * fallback). Returns the new file content. Idempotent if the draft is empty. */
+export function appendVersion(content, ts) {
+    const { draft } = parseVersions(content);
+    if (draft.trim().length === 0)
+        return content;
+    const marker = `<!-- compost:version ${ts} -->`;
+    // The new draft stays at top; the snapshot is recorded below it.
+    return `${draft}\n\n${marker}\n${draft}\n`;
+}
+/** A minimal line-level diff (LCS) between two versions, for the diff view. */
+export function diffLines(a, b) {
+    const x = a.split('\n');
+    const y = b.split('\n');
+    const n = x.length;
+    const m = y.length;
+    const lcs = Array.from({ length: n + 1 }, () => new Array(m + 1).fill(0));
+    for (let i = n - 1; i >= 0; i--) {
+        for (let j = m - 1; j >= 0; j--) {
+            lcs[i][j] =
+                x[i] === y[j] ? lcs[i + 1][j + 1] + 1 : Math.max(lcs[i + 1][j], lcs[i][j + 1]);
+        }
+    }
+    const out = [];
+    let i = 0;
+    let j = 0;
+    while (i < n && j < m) {
+        if (x[i] === y[j]) {
+            out.push({ type: 'ctx', text: x[i] });
+            i++;
+            j++;
+        }
+        else if (lcs[i + 1][j] >= lcs[i][j + 1]) {
+            out.push({ type: 'del', text: x[i] });
+            i++;
+        }
+        else {
+            out.push({ type: 'add', text: y[j] });
+            j++;
+        }
+    }
+    while (i < n)
+        out.push({ type: 'del', text: x[i++] });
+    while (j < m)
+        out.push({ type: 'add', text: y[j++] });
+    return out;
+}
+export function agentsPath(seedPath) {
+    return join(seedPath, '.compost', 'AGENTS.md');
+}
+export function readJournal(seedPath) {
+    const p = agentsPath(seedPath);
+    return existsSync(p) ? readFileSync(p, 'utf8') : '';
+}
+export function saveJournalVersion(seedPath, ts) {
+    const p = agentsPath(seedPath);
+    if (!existsSync(p))
+        return;
+    writeFileSync(p, appendVersion(readFileSync(p, 'utf8'), ts), 'utf8');
+}
+//# sourceMappingURL=journal.js.map

package/dist/lib/journal.js.map

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

package/dist/lib/migrate.d.ts

@@ -0,0 +1,29 @@
+export interface RenamePlan {
+    from: string;
+    to: string;
+}
+export interface MigratePlan {
+    seed_name: string;
+    path: string;
+    already_migrated: boolean;
+    renames: RenamePlan[];
+    scaffold_dirs: string[];
+    scaffold_files: string[];
+}
+export interface MigrateOptions {
+    apply?: boolean;
+    now?: () => Date;
+}
+export interface MigrateResult extends MigratePlan {
+    applied: boolean;
+}
+/**
+ * Map a legacy directory name to its compost equivalent.
+ * Strips a leading numeric prefix (`01_`, `02-`, …) and lowercases the first
+ * path segment. "01_Plan" → "plan", "02_Sessions" → "sessions",
+ * "04_Evaluation" → "evaluation". Names without a numeric prefix are left alone.
+ */
+export declare function mapLegacyName(name: string): string;
+export declare function planMigration(seedPath: string): MigratePlan;
+export declare function migrate(seedPath: string, opts?: MigrateOptions): MigrateResult;
+//# sourceMappingURL=migrate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/lib/migrate.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;CACX;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,gBAAgB,EAAE,OAAO,CAAA;IACzB,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,cAAc,EAAE,MAAM,EAAE,CAAA;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CACjB;AAED,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CA4C3D;AAED,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,aAAa,CAoDlF"}

package/dist/lib/migrate.js

@@ -0,0 +1,117 @@
+import { existsSync, mkdirSync, readdirSync, renameSync, statSync, writeFileSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { CompostError } from '../errors.js';
+import { loadTemplate, render } from './templates.js';
+/** Folders that compost expects in a migrated seed, beyond the renamed legacy dirs. */
+const SCAFFOLD_DIRS = [
+    'glossary',
+    'highlights',
+    'codebook',
+    'exports',
+    'legacy',
+    'sessions/_inbox',
+    '.compost',
+    '.compost/logs',
+    '.compost/work',
+];
+const NUMBERED_PREFIX_RE = /^(\d+)[_-](.+)$/;
+/**
+ * Map a legacy directory name to its compost equivalent.
+ * Strips a leading numeric prefix (`01_`, `02-`, …) and lowercases the first
+ * path segment. "01_Plan" → "plan", "02_Sessions" → "sessions",
+ * "04_Evaluation" → "evaluation". Names without a numeric prefix are left alone.
+ */
+export function mapLegacyName(name) {
+    const m = NUMBERED_PREFIX_RE.exec(name);
+    if (m === null)
+        return name;
+    return m[2].toLowerCase();
+}
+export function planMigration(seedPath) {
+    if (!existsSync(seedPath) || !statSync(seedPath).isDirectory()) {
+        throw new CompostError('FILE_NOT_FOUND', `Not a directory: ${seedPath}`);
+    }
+    const entries = readdirSync(seedPath).filter((e) => {
+        if (e.startsWith('.'))
+            return false;
+        return statSync(join(seedPath, e)).isDirectory();
+    });
+    const renames = [];
+    for (const entry of entries) {
+        const mapped = mapLegacyName(entry);
+        if (mapped !== entry) {
+            renames.push({ from: entry, to: mapped });
+        }
+    }
+    const alreadyMigrated = renames.length === 0 && existsSync(join(seedPath, '.compost'));
+    const scaffoldDirs = [];
+    for (const dir of SCAFFOLD_DIRS) {
+        if (!existsSync(join(seedPath, dir)))
+            scaffoldDirs.push(dir);
+    }
+    const scaffoldFiles = [];
+    if (!existsSync(join(seedPath, '.compost', 'config.toml'))) {
+        scaffoldFiles.push('.compost/config.toml');
+    }
+    if (!existsSync(join(seedPath, '.compost', 'AGENTS.md'))) {
+        scaffoldFiles.push('.compost/AGENTS.md');
+    }
+    if (!existsSync(join(seedPath, 'seed.md'))) {
+        scaffoldFiles.push('seed.md');
+    }
+    return {
+        seed_name: basename(seedPath),
+        path: seedPath,
+        already_migrated: alreadyMigrated,
+        renames,
+        scaffold_dirs: scaffoldDirs,
+        scaffold_files: scaffoldFiles,
+    };
+}
+export function migrate(seedPath, opts = {}) {
+    const plan = planMigration(seedPath);
+    const apply = opts.apply === true;
+    if (!apply) {
+        return { ...plan, applied: false };
+    }
+    // Guard: refuse to overwrite an existing target dir with a rename.
+    for (const r of plan.renames) {
+        if (existsSync(join(seedPath, r.to))) {
+            throw new CompostError('INVALID_INPUT', `Cannot rename "${r.from}" → "${r.to}": target already exists. Resolve manually.`);
+        }
+    }
+    // Apply renames, tracking completed ones so we can roll back on failure.
+    const completed = [];
+    try {
+        for (const r of plan.renames) {
+            renameSync(join(seedPath, r.from), join(seedPath, r.to));
+            completed.push(r);
+        }
+    }
+    catch (cause) {
+        for (const done of completed.reverse()) {
+            try {
+                renameSync(join(seedPath, done.to), join(seedPath, done.from));
+            }
+            catch {
+                // best-effort rollback; report the original failure
+            }
+        }
+        throw new CompostError('IO_ERROR', `Migration failed during rename; rolled back`, { cause });
+    }
+    // Scaffold missing dirs + files (idempotent).
+    for (const dir of plan.scaffold_dirs) {
+        mkdirSync(join(seedPath, dir), { recursive: true });
+    }
+    const now = (opts.now ?? (() => new Date()))();
+    const vars = {
+        seed_name: plan.seed_name,
+        created_at: now.toISOString(),
+    };
+    for (const file of plan.scaffold_files) {
+        const templateName = file === 'seed.md' ? 'seed.md' : basename(file);
+        writeFileSync(join(seedPath, file), render(loadTemplate(templateName), vars), 'utf8');
+    }
+    return { ...plan, applied: true };
+}
+//# sourceMappingURL=migrate.js.map

package/dist/lib/migrate.js.map

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

package/dist/lib/nativeRuntime.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Native (host) transcription runtime resolution (#176, native-first).
+ *
+ * On Apple Silicon the native path (parakeet-mlx + pyannote on Metal) is ~20×
+ * faster than the Docker WhisperX container and runs on real host paths, so it's
+ * the default. The Docker container is a documented cross-platform fallback.
+ *
+ * `compost transcribe` defaults to native when both a Python interpreter and the
+ * transcriber package dir resolve; otherwise it falls back to Docker. Resolution
+ * precedence: explicit flag > env var > managed venv (provisioned by
+ * `compost setup`, #183) / repo-relative package.
+ */
+export interface NativeRuntimePaths {
+    python: string;
+    transcriberDir: string;
+}
+/** Native Metal/MLX ASR (parakeet-mlx) + pyannote-MPS require Apple Silicon. */
+export declare function isAppleSilicon(): boolean;
+/** Managed native venv directory, provisioned by `compost setup --provision-native`
+ * (#183). `$COMPOST_HOME` overrides the default `~/.compost`. */
+export declare function managedVenvDir(env?: NodeJS.ProcessEnv): string;
+/** Managed native venv python (`<venv>/bin/python`). */
+export declare function managedVenvPython(env?: NodeJS.ProcessEnv): string;
+/** Walk up from this module to find the repo's `transcriber/` package — works
+ * for repo/dev installs where cli/ and transcriber/ are siblings. Returns
+ * undefined for a bare global install (use the env var or managed venv there). */
+export declare function findRepoTranscriberDir(startDir?: string, exists?: (p: string) => boolean): string | undefined;
+export interface ResolveNativeOpts {
+    python?: string;
+    transcriberDir?: string;
+    env?: NodeJS.ProcessEnv;
+    exists?: (p: string) => boolean;
+    /** Override repo-dir discovery (tests). */
+    repoTranscriberDir?: () => string | undefined;
+}
+/**
+ * Resolve the native python + transcriber dir, or null when native isn't
+ * available. Precedence: explicit > env > managed venv / repo-relative.
+ */
+export declare function resolveNativeRuntime(opts?: ResolveNativeOpts): NativeRuntimePaths | null;
+/**
+ * Pick the runtime: an explicit `--runtime` wins; otherwise native on Apple
+ * Silicon when resolvable, else Docker (the cross-platform fallback).
+ */
+export declare function pickRuntime(explicit: string | undefined, native: NativeRuntimePaths | null, appleSilicon?: boolean): 'native' | 'docker';
+//# sourceMappingURL=nativeRuntime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nativeRuntime.d.ts","sourceRoot":"","sources":["../../src/lib/nativeRuntime.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,gFAAgF;AAChF,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;iEACiE;AACjE,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAI3E;AAED,wDAAwD;AACxD,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAE9E;AAED;;kFAEkF;AAClF,wBAAgB,sBAAsB,CACpC,QAAQ,GAAE,MAAgD,EAC1D,MAAM,GAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAoB,GAC1C,MAAM,GAAG,SAAS,CAUpB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAA;IAC/B,2CAA2C;IAC3C,kBAAkB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAA;CAC9C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,iBAAsB,GAAG,kBAAkB,GAAG,IAAI,CAY5F;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,kBAAkB,GAAG,IAAI,EACjC,YAAY,GAAE,OAA0B,GACvC,QAAQ,GAAG,QAAQ,CAGrB"}

package/dist/lib/nativeRuntime.js

@@ -0,0 +1,61 @@
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** Native Metal/MLX ASR (parakeet-mlx) + pyannote-MPS require Apple Silicon. */
+export function isAppleSilicon() {
+    return process.platform === 'darwin' && process.arch === 'arm64';
+}
+/** Managed native venv directory, provisioned by `compost setup --provision-native`
+ * (#183). `$COMPOST_HOME` overrides the default `~/.compost`. */
+export function managedVenvDir(env = process.env) {
+    // `?.trim()` so an empty/whitespace COMPOST_HOME doesn't yield a relative path.
+    const home = env.COMPOST_HOME?.trim() ? env.COMPOST_HOME : join(homedir(), '.compost');
+    return join(home, 'transcriber-venv');
+}
+/** Managed native venv python (`<venv>/bin/python`). */
+export function managedVenvPython(env = process.env) {
+    return join(managedVenvDir(env), 'bin', 'python');
+}
+/** Walk up from this module to find the repo's `transcriber/` package — works
+ * for repo/dev installs where cli/ and transcriber/ are siblings. Returns
+ * undefined for a bare global install (use the env var or managed venv there). */
+export function findRepoTranscriberDir(startDir = dirname(fileURLToPath(import.meta.url)), exists = existsSync) {
+    let dir = startDir;
+    for (let i = 0; i < 10; i++) {
+        const candidate = join(dir, 'transcriber');
+        if (exists(join(candidate, 'app', 'transcribe_cli.py')))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return undefined;
+}
+/**
+ * Resolve the native python + transcriber dir, or null when native isn't
+ * available. Precedence: explicit > env > managed venv / repo-relative.
+ */
+export function resolveNativeRuntime(opts = {}) {
+    const env = opts.env ?? process.env;
+    const exists = opts.exists ?? existsSync;
+    const managed = managedVenvPython(env);
+    const python = opts.python ?? env.COMPOST_TRANSCRIBER_PYTHON ?? (exists(managed) ? managed : undefined);
+    const transcriberDir = opts.transcriberDir ??
+        env.COMPOST_TRANSCRIBER_DIR ??
+        (opts.repoTranscriberDir ?? (() => findRepoTranscriberDir(undefined, exists)))();
+    if (python === undefined || transcriberDir === undefined)
+        return null;
+    return { python, transcriberDir };
+}
+/**
+ * Pick the runtime: an explicit `--runtime` wins; otherwise native on Apple
+ * Silicon when resolvable, else Docker (the cross-platform fallback).
+ */
+export function pickRuntime(explicit, native, appleSilicon = isAppleSilicon()) {
+    if (explicit === 'native' || explicit === 'docker')
+        return explicit;
+    return appleSilicon && native !== null ? 'native' : 'docker';
+}
+//# sourceMappingURL=nativeRuntime.js.map

package/dist/lib/nativeRuntime.js.map

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

package/dist/lib/provisionNative.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Provision the managed native transcription venv (#183) so `compost transcribe`
+ * runs native (Parakeet + pyannote on Metal) with zero flags on a fresh
+ * Apple-Silicon machine. Side-effectful, so it's an explicit opt-in
+ * (`compost setup --provision-native`), separate from the read-only doctor.
+ *
+ * The dep list mirrors the transcriber's `[native]` extra in pyproject.toml; a
+ * unit test asserts they stay in sync. We install the deps (not the package
+ * editable) to avoid depending on a build backend — the `app` package is found
+ * at run time via the entrypoint's cwd.
+ */
+/** Native ASR deps — keep in sync with transcriber/pyproject.toml `[native]`. */
+export declare const NATIVE_DEPS: string[];
+export interface ProvisionExecResult {
+    ok: boolean;
+    stdout: string;
+    stderr: string;
+}
+/** Injectable command runner. `stream` lets the slow pip step write to the
+ * terminal instead of being captured. */
+export type ProvisionExec = (cmd: string, args: string[], opts?: {
+    stream?: boolean;
+}) => ProvisionExecResult;
+export interface ProvisionNativeOptions {
+    env?: NodeJS.ProcessEnv;
+    exists?: (p: string) => boolean;
+    exec?: ProvisionExec;
+    /** Explicit interpreter to build the venv from (else discovered). */
+    pythonBin?: string;
+    /** transcriber/ dir (else COMPOST_TRANSCRIBER_DIR env or repo-relative). */
+    transcriberDir?: string;
+    /** Reinstall even if the venv already imports the native deps. */
+    force?: boolean;
+}
+export interface ProvisionNativeResult {
+    status: 'already-ready' | 'provisioned';
+    venvDir: string;
+    venvPython: string;
+    pythonBin: string | null;
+    transcriberDir: string;
+    steps: string[];
+}
+/** Create + populate the managed native venv. Idempotent: a venv that already
+ * imports the deps is a no-op unless `force`. */
+export declare function provisionNativeVenv(opts?: ProvisionNativeOptions): ProvisionNativeResult;
+//# sourceMappingURL=provisionNative.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provisionNative.d.ts","sourceRoot":"","sources":["../../src/lib/provisionNative.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;GAUG;AAEH,iFAAiF;AACjF,eAAO,MAAM,WAAW,UAMvB,CAAA;AAOD,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AACD;yCACyC;AACzC,MAAM,MAAM,aAAa,GAAG,CAC1B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,KACxB,mBAAmB,CAAA;AAExB,MAAM,WAAW,sBAAsB;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAA;IAC/B,IAAI,CAAC,EAAE,aAAa,CAAA;IACpB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,eAAe,GAAG,aAAa,CAAA;IACvC,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAgCD;iDACiD;AACjD,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,sBAA2B,GAAG,qBAAqB,CA+D5F"}