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

package/dist/loops/supervisor.js.map

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

package/dist/loops/synthesis.d.ts

@@ -0,0 +1,31 @@
+import { type EmbeddedItem, type SaturationPulse } from 'compost-retrieval';
+export interface ThemeSuggestion {
+    artifact_id: string;
+    members: string[];
+    cohesion: number;
+}
+/**
+ * Autonomous theme/code suggestion (#59): cluster un-coded highlights in
+ * embedding space and emit one AI-suggested `code` event per cohesive cluster.
+ * Throttled to 20 suggestions/run; suggestions are [draft] until endorsed.
+ */
+export declare function suggestThemesOnce(seedPath: string, highlights: EmbeddedItem[], opts?: {
+    threshold?: number;
+    minSize?: number;
+    model?: string;
+    promptHash?: string;
+}): ThemeSuggestion[];
+export interface PulseResult extends SaturationPulse {
+    notify: boolean;
+    artifact_id: string;
+}
+/**
+ * Saturation-pulse loop (#61): compute the pulse and emit an AI suggestion
+ * recording it. `notify` is true when the recommendation is pause/conclude —
+ * the watcher surfaces that to the researcher.
+ */
+export declare function saturationPulseOnce(seedPath: string, sessions: Array<{
+    id: string;
+    themes: string[];
+}>): PulseResult;
+//# sourceMappingURL=synthesis.d.ts.map

package/dist/loops/synthesis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesis.d.ts","sourceRoot":"","sources":["../../src/loops/synthesis.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,eAAe,EAGrB,MAAM,mBAAmB,CAAA;AAS1B,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,YAAY,EAAE,EAC1B,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACvF,eAAe,EAAE,CAgCnB;AAED,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD,MAAM,EAAE,OAAO,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,GAChD,WAAW,CAmBb"}

package/dist/loops/synthesis.js

@@ -0,0 +1,71 @@
+import { saturationPulse, suggestCodeClusters, } from 'compost-retrieval';
+import { artifactId, emitAgentCreate, openSeedEvents } from '../lib/events.js';
+const SCANNER = 'similarity-scanner';
+const PULSE = 'saturation-pulse';
+const VERSION = '0.1.0';
+const MAX_SUGGESTIONS = 20;
+/**
+ * Autonomous theme/code suggestion (#59): cluster un-coded highlights in
+ * embedding space and emit one AI-suggested `code` event per cohesive cluster.
+ * Throttled to 20 suggestions/run; suggestions are [draft] until endorsed.
+ */
+export function suggestThemesOnce(seedPath, highlights, opts = {}) {
+    const clusters = suggestCodeClusters(highlights, {
+        ...(opts.threshold !== undefined ? { threshold: opts.threshold } : {}),
+        ...(opts.minSize !== undefined ? { minSize: opts.minSize } : {}),
+    }).slice(0, MAX_SUGGESTIONS);
+    const events = openSeedEvents(seedPath);
+    const out = [];
+    try {
+        for (const cluster of clusters) {
+            const initialState = {
+                kind: 'code',
+                members: cluster.members,
+                cohesion: cluster.cohesion,
+                status: 'draft',
+            };
+            const event = emitAgentCreate(events, {
+                artifactKind: 'code',
+                initialState,
+                agentName: SCANNER,
+                agentVersion: VERSION,
+            });
+            out.push({
+                artifact_id: event.artifact_id,
+                members: cluster.members,
+                cohesion: cluster.cohesion,
+            });
+        }
+        return out;
+    }
+    finally {
+        events.close();
+    }
+}
+/**
+ * Saturation-pulse loop (#61): compute the pulse and emit an AI suggestion
+ * recording it. `notify` is true when the recommendation is pause/conclude —
+ * the watcher surfaces that to the researcher.
+ */
+export function saturationPulseOnce(seedPath, sessions) {
+    const pulse = saturationPulse(sessions);
+    const events = openSeedEvents(seedPath);
+    try {
+        const initialState = { kind: 'saturation_pulse', ...pulse };
+        const event = emitAgentCreate(events, {
+            artifactKind: 'insight',
+            initialState,
+            agentName: PULSE,
+            agentVersion: VERSION,
+        });
+        return {
+            ...pulse,
+            notify: pulse.recommendation !== 'continue',
+            artifact_id: event.artifact_id ?? artifactId(initialState),
+        };
+    }
+    finally {
+        events.close();
+    }
+}
+//# sourceMappingURL=synthesis.js.map

package/dist/loops/synthesis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesis.js","sourceRoot":"","sources":["../../src/loops/synthesis.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,eAAe,EACf,mBAAmB,GACpB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAE9E,MAAM,OAAO,GAAG,oBAAoB,CAAA;AACpC,MAAM,KAAK,GAAG,kBAAkB,CAAA;AAChC,MAAM,OAAO,GAAG,OAAO,CAAA;AACvB,MAAM,eAAe,GAAG,EAAE,CAAA;AAQ1B;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAgB,EAChB,UAA0B,EAC1B,OAAsF,EAAE;IAExF,MAAM,QAAQ,GAAG,mBAAmB,CAAC,UAAU,EAAE;QAC/C,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAA;IAE5B,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAA;IACvC,MAAM,GAAG,GAAsB,EAAE,CAAA;IACjC,IAAI,CAAC;QACH,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,YAAY,GAAG;gBACnB,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,MAAM,EAAE,OAAO;aAChB,CAAA;YACD,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,EAAE;gBACpC,YAAY,EAAE,MAAM;gBACpB,YAAY;gBACZ,SAAS,EAAE,OAAO;gBAClB,YAAY,EAAE,OAAO;aACtB,CAAC,CAAA;YACF,GAAG,CAAC,IAAI,CAAC;gBACP,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;aAC3B,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,KAAK,EAAE,CAAA;IAChB,CAAC;AACH,CAAC;AAOD;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,QAAiD;IAEjD,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAA;IACvC,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAA;IACvC,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,EAAE,IAAI,EAAE,kBAAkB,EAAE,GAAG,KAAK,EAAE,CAAA;QAC3D,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,EAAE;YACpC,YAAY,EAAE,SAAS;YACvB,YAAY;YACZ,SAAS,EAAE,KAAK;YAChB,YAAY,EAAE,OAAO;SACtB,CAAC,CAAA;QACF,OAAO;YACL,GAAG,KAAK;YACR,MAAM,EAAE,KAAK,CAAC,cAAc,KAAK,UAAU;YAC3C,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,UAAU,CAAC,YAAY,CAAC;SAC3D,CAAA;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,KAAK,EAAE,CAAA;IAChB,CAAC;AACH,CAAC"}

package/dist/loops/transcribe_worker.d.ts

@@ -0,0 +1,22 @@
+import { TranscriberClient } from '../transcriber_client.js';
+export interface WorkerStepResult {
+    processed: number;
+    results: Array<{
+        job_id: number;
+        session_id: string;
+        status: string;
+        transcript_path?: string;
+    }>;
+}
+export interface WorkerDeps {
+    client?: TranscriberClient;
+}
+/**
+ * Drain all queued `transcribe` jobs (concurrency 1 — the Python service is the
+ * bottleneck). For each: call the service, render transcript.md, and complete.
+ * Transient failures requeue via the queue's attempt counter (gives up after 3,
+ * marking the job failed). Returns what it did. Pure of timers — the supervisor
+ * calls this on a cadence.
+ */
+export declare function runTranscribeWorkerOnce(seedPath: string, deps?: WorkerDeps): Promise<WorkerStepResult>;
+//# sourceMappingURL=transcribe_worker.d.ts.map

package/dist/loops/transcribe_worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcribe_worker.d.ts","sourceRoot":"","sources":["../../src/loops/transcribe_worker.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAM5D,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACjG;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAC3B;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,UAAe,GACpB,OAAO,CAAC,gBAAgB,CAAC,CAyD3B"}

package/dist/loops/transcribe_worker.js

@@ -0,0 +1,77 @@
+import { existsSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { emitAgentCreate, openSeedEvents } from '../lib/events.js';
+import { JobQueue, stateDbPath } from '../lib/queue.js';
+import { writeTranscriptMd } from '../render/transcript_md.js';
+import { TranscriberClient } from '../transcriber_client.js';
+const AGENT_NAME = 'transcribe-worker';
+const AGENT_VERSION = '0.1.0';
+const MAX_ATTEMPTS = 3;
+/**
+ * Drain all queued `transcribe` jobs (concurrency 1 — the Python service is the
+ * bottleneck). For each: call the service, render transcript.md, and complete.
+ * Transient failures requeue via the queue's attempt counter (gives up after 3,
+ * marking the job failed). Returns what it did. Pure of timers — the supervisor
+ * calls this on a cadence.
+ */
+export async function runTranscribeWorkerOnce(seedPath, deps = {}) {
+    const client = deps.client ?? new TranscriberClient();
+    const queue = new JobQueue(stateDbPath(seedPath));
+    const events = openSeedEvents(seedPath);
+    const out = { processed: 0, results: [] };
+    try {
+        while (true) {
+            const job = queue.claim('transcribe');
+            if (job === null)
+                break;
+            out.processed += 1;
+            const sessionId = String(job.payload.session_id ?? 'S?');
+            try {
+                const language = typeof job.payload.language === 'string' ? job.payload.language : undefined;
+                const resp = await client.transcribe(job.source_path, sessionId, seedPath, language);
+                if (resp.status === 'failed_transcription') {
+                    queue.fail(job.id, 'service reported failed_transcription', MAX_ATTEMPTS);
+                    out.results.push({
+                        job_id: job.id,
+                        session_id: sessionId,
+                        status: 'failed_transcription',
+                    });
+                    continue;
+                }
+                if (existsSync(resp.transcript_path)) {
+                    writeTranscriptMd(resp.transcript_path);
+                }
+                queue.complete(job.id);
+                emitAgentCreate(events, {
+                    artifactKind: 'transcript',
+                    initialState: {
+                        session_id: resp.session_id,
+                        transcript_path: resp.transcript_path,
+                        status: resp.status,
+                    },
+                    agentName: AGENT_NAME,
+                    agentVersion: AGENT_VERSION,
+                });
+                out.results.push({
+                    job_id: job.id,
+                    session_id: sessionId,
+                    status: resp.status,
+                    transcript_path: resp.transcript_path,
+                });
+                // needs_speaker_labels: completed but flagged for human; surfaced in result.
+            }
+            catch (err) {
+                queue.fail(job.id, err instanceof Error ? err.message : String(err), MAX_ATTEMPTS);
+                out.results.push({ job_id: job.id, session_id: sessionId, status: 'error' });
+                // stop the drain on a service-down error; nothing else will succeed now.
+                break;
+            }
+        }
+        return out;
+    }
+    finally {
+        queue.close();
+        events.close();
+    }
+}
+//# sourceMappingURL=transcribe_worker.js.map

package/dist/loops/transcribe_worker.js.map

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

package/dist/output.d.ts

@@ -0,0 +1,8 @@
+import type { Command } from 'commander';
+export interface OutputOptions {
+    human: boolean;
+}
+export declare function getOutputOpts(cmd: Command): OutputOptions;
+export declare function emit(data: unknown, opts: OutputOptions): void;
+export declare function emitError(err: unknown, opts: OutputOptions): never;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAIxC,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAA;CACf;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAKzD;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAG7D;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,GAAG,KAAK,CAalE"}

package/dist/output.js

@@ -0,0 +1,26 @@
+import { isCompostError } from './errors.js';
+export function getOutputOpts(cmd) {
+    let root = cmd;
+    while (root.parent)
+        root = root.parent;
+    const opts = root.opts();
+    return { human: opts.human === true };
+}
+export function emit(data, opts) {
+    const text = opts.human ? JSON.stringify(data, null, 2) : JSON.stringify(data);
+    process.stdout.write(`${text}\n`);
+}
+export function emitError(err, opts) {
+    const compost = isCompostError(err);
+    const code = compost ? err.code : 'INTERNAL';
+    const message = err instanceof Error ? err.message : String(err);
+    if (opts.human) {
+        process.stderr.write(`error: ${message}\n`);
+        process.stderr.write(`code: ${code}\n`);
+    }
+    else {
+        process.stderr.write(`${JSON.stringify({ error: { code, message } })}\n`);
+    }
+    process.exit(1);
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAM5C,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,IAAI,IAAI,GAAY,GAAG,CAAA;IACvB,OAAO,IAAI,CAAC,MAAM;QAAE,IAAI,GAAG,IAAI,CAAC,MAAM,CAAA;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAyB,CAAA;IAC/C,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAA;AACvC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAa,EAAE,IAAmB;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IAC9E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAA;AACnC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAY,EAAE,IAAmB;IACzD,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,CAAA;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAA;IAC5C,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAEhE,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,IAAI,CAAC,CAAA;QAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,CAAA;IACzC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;IAC3E,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC"}

package/dist/render/transcript_md.d.ts

@@ -0,0 +1,5 @@
+/** Render transcript.json → transcript.md (cues + silences inlined) next to it.
+ * Reuses the Markdown exporter (#24) so the human mirror and `compost export`
+ * stay byte-identical. Returns the path written. */
+export declare function writeTranscriptMd(transcriptJsonPath: string): string;
+//# sourceMappingURL=transcript_md.d.ts.map

package/dist/render/transcript_md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript_md.d.ts","sourceRoot":"","sources":["../../src/render/transcript_md.ts"],"names":[],"mappings":"AAMA;;oDAEoD;AACpD,wBAAgB,iBAAiB,CAAC,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAMpE"}

package/dist/render/transcript_md.js

@@ -0,0 +1,14 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { transcriptToMarkdown } from '../exporters/md.js';
+/** Render transcript.json → transcript.md (cues + silences inlined) next to it.
+ * Reuses the Markdown exporter (#24) so the human mirror and `compost export`
+ * stay byte-identical. Returns the path written. */
+export function writeTranscriptMd(transcriptJsonPath) {
+    const transcript = JSON.parse(readFileSync(transcriptJsonPath, 'utf8'));
+    const md = transcriptToMarkdown(transcript);
+    const mdPath = join(dirname(transcriptJsonPath), 'transcript.md');
+    writeFileSync(mdPath, md, 'utf8');
+    return mdPath;
+}
+//# sourceMappingURL=transcript_md.js.map

package/dist/render/transcript_md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript_md.js","sourceRoot":"","sources":["../../src/render/transcript_md.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACrD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAGzD;;oDAEoD;AACpD,MAAM,UAAU,iBAAiB,CAAC,kBAA0B;IAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAe,CAAA;IACrF,MAAM,EAAE,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAA;IAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,eAAe,CAAC,CAAA;IACjE,aAAa,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,CAAA;IACjC,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/router.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function buildProgram(): Command;
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAgCnC,wBAAgB,YAAY,IAAI,OAAO,CA2CtC"}

package/dist/router.js

@@ -0,0 +1,68 @@
+import { Command } from 'commander';
+import { registerBlame } from './commands/blame.js';
+import { registerChat } from './commands/chat.js';
+import { registerCode } from './commands/code.js';
+import { registerConfig } from './commands/config.js';
+import { registerCreate } from './commands/create.js';
+import { registerEndorse } from './commands/endorse.js';
+import { registerEvals } from './commands/evals.js';
+import { registerExport } from './commands/export.js';
+import { registerIngest } from './commands/ingest.js';
+import { registerInit } from './commands/init.js';
+import { registerMigrate } from './commands/migrate.js';
+import { registerModels } from './commands/models.js';
+import { registerQuery } from './commands/query.js';
+import { registerReindex } from './commands/reindex.js';
+import { registerRescan } from './commands/rescan.js';
+import { registerSaturate } from './commands/saturate.js';
+import { registerSearch } from './commands/search.js';
+import { registerServe } from './commands/serve.js';
+import { registerSession } from './commands/session.js';
+import { registerSetup } from './commands/setup.js';
+import { registerSnap } from './commands/snap.js';
+import { registerStatus } from './commands/status.js';
+import { registerSynthesize } from './commands/synthesize.js';
+import { registerTag } from './commands/tag.js';
+import { registerTranscribe } from './commands/transcribe.js';
+import { registerValidate } from './commands/validate.js';
+import { registerWatch } from './commands/watch.js';
+const VERSION = '0.1.0-rc.1';
+export function buildProgram() {
+    const program = new Command();
+    program
+        .name('compost')
+        .description('Local-first, AI-first research analysis harness for coding agents and humans.')
+        .version(VERSION, '-V, --version')
+        .option('--human', 'Pretty-print output for human eyes (JSON is the default — agents parse it directly).')
+        .showHelpAfterError()
+        .configureHelp({ sortSubcommands: true });
+    registerInit(program);
+    registerIngest(program);
+    registerTranscribe(program);
+    registerWatch(program);
+    registerSnap(program);
+    registerStatus(program);
+    registerBlame(program);
+    registerMigrate(program);
+    registerExport(program);
+    registerReindex(program);
+    registerRescan(program);
+    registerSaturate(program);
+    registerValidate(program);
+    registerTag(program);
+    registerCode(program);
+    registerSynthesize(program);
+    registerSearch(program);
+    registerSession(program);
+    registerCreate(program);
+    registerEndorse(program);
+    registerSetup(program);
+    registerQuery(program);
+    registerChat(program);
+    registerServe(program);
+    registerModels(program);
+    registerEvals(program);
+    registerConfig(program);
+    return program;
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

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

package/dist/transcriber_client.d.ts

@@ -0,0 +1,42 @@
+import type { FetchLike } from './llm/types.js';
+export interface TranscribeResponse {
+    session_id: string;
+    transcript_path: string;
+    status: 'ok' | 'needs_speaker_labels' | 'failed_transcription';
+}
+export interface TranscriberHealth {
+    ok: boolean;
+    versions: Record<string, string | null>;
+}
+export declare class TranscriberServiceError extends Error {
+    readonly kind: 'down' | 'model_missing' | 'failed';
+    constructor(message: string, kind: 'down' | 'model_missing' | 'failed');
+}
+export interface TranscriberClientOptions {
+    baseUrl?: string;
+    fetchImpl?: FetchLike;
+    timeoutMs?: number;
+}
+/** HTTP client for the Python transcriber service (compose: localhost:7862). */
+export declare class TranscriberClient {
+    private readonly base;
+    private readonly fetchImpl;
+    private readonly timeoutMs;
+    constructor(opts?: TranscriberClientOptions);
+    health(): Promise<TranscriberHealth>;
+    /**
+     * Invoke POST /transcribe with the body shape the Python route expects.
+     *
+     * Bug fix (#148): the previous signature sent `{audio_path, session_id}` but
+     * the route requires `{seed_path, session_id, source_path}` per its pydantic
+     * `TranscribeRequest` model. The route returned 422 on every real call from
+     * the worker, breaking `compost transcribe` end-to-end.
+     *
+     * The fix takes `seedPath` (required) and an optional `language` hint, and
+     * sends the body shape the route actually expects. The shape is verified
+     * against the contract schema at `cli/contracts/transcribe-request.schema.json`
+     * (generated from the pydantic model — see contract test).
+     */
+    transcribe(audioPath: string, sessionId: string, seedPath: string, language?: string): Promise<TranscribeResponse>;
+}
+//# sourceMappingURL=transcriber_client.d.ts.map

package/dist/transcriber_client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcriber_client.d.ts","sourceRoot":"","sources":["../src/transcriber_client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;IACvB,MAAM,EAAE,IAAI,GAAG,sBAAsB,GAAG,sBAAsB,CAAA;CAC/D;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAA;IACX,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAA;CACxC;AAED,qBAAa,uBAAwB,SAAQ,KAAK;aAG9B,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,QAAQ;gBADzD,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,QAAQ;CAK5D;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,gFAAgF;AAChF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;gBAEtB,IAAI,GAAE,wBAA6B;IAMzC,MAAM,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAc1C;;;;;;;;;;;;OAYG;IACG,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,CAAC;CA+B/B"}

package/dist/transcriber_client.js

@@ -0,0 +1,72 @@
+import { resolveFetch } from './llm/http.js';
+export class TranscriberServiceError extends Error {
+    kind;
+    constructor(message, kind) {
+        super(message);
+        this.kind = kind;
+        this.name = 'TranscriberServiceError';
+    }
+}
+/** HTTP client for the Python transcriber service (compose: localhost:7862). */
+export class TranscriberClient {
+    base;
+    fetchImpl;
+    timeoutMs;
+    constructor(opts = {}) {
+        this.base = (opts.baseUrl ?? 'http://localhost:7862').replace(/\/$/, '');
+        this.fetchImpl = resolveFetch(opts.fetchImpl);
+        this.timeoutMs = opts.timeoutMs ?? 1_800_000; // 30 min; transcription is slow
+    }
+    async health() {
+        try {
+            const res = await this.fetchImpl(`${this.base}/health`, { method: 'GET' });
+            if (!res.ok)
+                return { ok: false, versions: {} };
+            const json = (await res.json());
+            return { ok: json.status === 'ok', versions: json.versions ?? {} };
+        }
+        catch {
+            return { ok: false, versions: {} };
+        }
+    }
+    /**
+     * Invoke POST /transcribe with the body shape the Python route expects.
+     *
+     * Bug fix (#148): the previous signature sent `{audio_path, session_id}` but
+     * the route requires `{seed_path, session_id, source_path}` per its pydantic
+     * `TranscribeRequest` model. The route returned 422 on every real call from
+     * the worker, breaking `compost transcribe` end-to-end.
+     *
+     * The fix takes `seedPath` (required) and an optional `language` hint, and
+     * sends the body shape the route actually expects. The shape is verified
+     * against the contract schema at `cli/contracts/transcribe-request.schema.json`
+     * (generated from the pydantic model — see contract test).
+     */
+    async transcribe(audioPath, sessionId, seedPath, language) {
+        const body = {
+            seed_path: seedPath,
+            session_id: sessionId,
+            source_path: audioPath,
+        };
+        if (language !== undefined)
+            body.language = language;
+        let res;
+        try {
+            res = await this.fetchImpl(`${this.base}/transcribe`, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify(body),
+            });
+        }
+        catch (err) {
+            throw new TranscriberServiceError(`transcriber service unreachable at ${this.base}: ${err instanceof Error ? err.message : String(err)}`, 'down');
+        }
+        if (res.status === 503)
+            throw new TranscriberServiceError('model missing/unavailable', 'model_missing');
+        if (!res.ok) {
+            throw new TranscriberServiceError(`transcribe failed: ${res.status} ${res.statusText}`, 'failed');
+        }
+        return (await res.json());
+    }
+}
+//# sourceMappingURL=transcriber_client.js.map

package/dist/transcriber_client.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@they-juanreina/compost-cli",
+  "version": "0.1.0-rc.1",
+  "description": "Compost CLI engine. Subcommand router, JSON-out, harness loop runner.",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "bin": {
+    "compost": "./bin/compost.js"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "templates",
+    "package.json"
+  ],
+  "dependencies": {
+    "ajv": "^8.20.0",
+    "ajv-formats": "^3.0.1",
+    "better-sqlite3": "^11.5.0",
+    "chokidar": "^4.0.0",
+    "commander": "^12.1.0",
+    "smol-toml": "^1.3.0",
+    "compost-provenance": "0.1.0-rc.1",
+    "compost-evals": "0.1.0-rc.1",
+    "compost-retrieval": "0.1.0-rc.1"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.11",
+    "tsx": "^4.19.0"
+  },
+  "scripts": {
+    "prebuild": "node scripts/generate-schemas.mjs",
+    "build": "tsc -p .",
+    "typecheck": "tsc -p . --noEmit",
+    "pretest": "node scripts/generate-schemas.mjs",
+    "dev": "tsx src/index.ts",
+    "test": "node --import tsx --test 'src/**/*.test.ts'"
+  }
+}

package/templates/AGENTS.md

@@ -0,0 +1,25 @@
+# AGENTS.md — {{seed_name}}
+
+This is the versioned prompt journal for this seed. Compost reads this file when invoking LLM tasks (synthesis, coding, query, chat) and prepends its contents to system prompts. Treat it like a `CLAUDE.md` for your research.
+
+Edit freely. Commit changes to version-control alongside the rest of the seed.
+
+## Voice & style
+
+- Direct. Cite utterance IDs.
+- "Insufficient evidence" is acceptable when retrieval comes up short — preferable to fabricating.
+- No paraphrasing as if it were a quote. Either quote verbatim with utterance_id, or speak in your own voice.
+
+## Domain glossary
+
+- Defer to `glossary/glossary.md`. Don't redefine terms that already live there.
+
+## Anti-patterns
+
+- Never invent quotes.
+- Never claim a theme without ≥2 supporting highlights from ≥2 sessions.
+- Never promote an AI-suggested artifact to "endorsed" status — only a researcher does that.
+
+## This seed's specifics
+
+_Add anything compost should know that's unique to this research initiative — the stakeholder audience, sensitivities, scope guardrails, deadline pressure, etc._