@they-juanreina/compost-cli 0.1.1 → 0.1.3

package/dist/commands/transcribe.js

@@ -2,7 +2,9 @@ import { existsSync, readdirSync } from 'node:fs';
 import { join } from 'node:path';
 import { CompostError, isCompostError } from '../errors.js';
 import { isAppleSilicon, pickRuntime, resolveNativeRuntime } from '../lib/nativeRuntime.js';
+import { HF_ALIASES, resolveSecret } from '../lib/secrets.js';
 import { resolveSeedPath } from '../lib/seedResolve.js';
+import { applySidecar } from '../lib/speakers.js';
 import { transcribeNative } from '../lib/transcribeNative.js';
 import { emit, emitError, getOutputOpts } from '../output.js';
 import { writeTranscriptMd } from '../render/transcript_md.js';
@@ -56,15 +58,22 @@ export function registerTranscribe(program) {
                         '--python and --transcriber-dir (or set COMPOST_TRANSCRIBER_PYTHON / COMPOST_TRANSCRIBER_DIR), ' +
                         'or run `compost setup` to provision the native venv.');
                 }
+                // Resolve the HF token by the documented precedence (env > keychain >
+                // secrets.env) and pass it explicitly to the python subprocess, so a
+                // keychain-stored token works even though it isn't in process.env.
+                const hf = resolveSecret('HUGGINGFACE_TOKEN', { aliases: HF_ALIASES });
                 const resp = transcribeNative(seedPath, sessionId, source, {
                     python: native.python,
                     transcriberDir: native.transcriberDir,
                     engine: flags.engine ?? 'parakeet',
                     ...(flags.model !== undefined ? { model: flags.model } : {}),
                     ...(flags.language !== undefined ? { language: flags.language } : {}),
+                    ...(hf ? { env: { HUGGINGFACE_TOKEN: hf.value } } : {}),
                 });
-                if (existsSync(resp.transcript_path))
+                if (existsSync(resp.transcript_path)) {
+                    applySidecar(resp.transcript_path); // re-apply persisted speaker names (#177)
                     writeTranscriptMd(resp.transcript_path);
+                }
                 emit({
                     status: resp.status,
                     command: 'transcribe',
@@ -83,8 +92,10 @@ export function registerTranscribe(program) {
             }
             const client = new TranscriberClient(flags.baseUrl !== undefined ? { baseUrl: flags.baseUrl } : {});
             const resp = await client.transcribe(source, sessionId, seedPath, flags.language);
-            if (existsSync(resp.transcript_path))
+            if (existsSync(resp.transcript_path)) {
+                applySidecar(resp.transcript_path); // re-apply persisted speaker names (#177)
                 writeTranscriptMd(resp.transcript_path);
+            }
             emit({
                 status: resp.status,
                 command: 'transcribe',

package/dist/commands/transcribe.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAWxC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuEvD"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAiBxC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqGvD"}

package/dist/commands/validate.js

@@ -1,10 +1,38 @@
 import { isCompostError } from '../errors.js';
-import { validateCues, validateEventsExport, validateFrames, validateTranscript, } from '../lib/validate.js';
+import { resolveSeedPath } from '../lib/seedResolve.js';
+import { validateCues, validateEventsExport, validateFrames, validateSeed, validateTranscript, } from '../lib/validate.js';
 import { emit, emitError, getOutputOpts } from '../output.js';
 export function registerValidate(program) {
     const validate = program
         .command('validate')
         .description('Validate JSON artifacts against compost schemas');
+    validate
+        .command('seed')
+        .description('Validate a whole seed: every transcript.json + normalized legacy + the event log (#174)')
+        .option('--seed <name>', 'Seed (default: the only seed under ./Seeds)')
+        .action((flags, cmd) => {
+        const out = getOutputOpts(cmd);
+        try {
+            const seedPath = resolveSeedPath(process.cwd(), flags.seed);
+            const result = validateSeed(seedPath);
+            emit({
+                status: result.ok ? 'ok' : 'invalid',
+                command: 'validate seed',
+                seed: result.seed,
+                transcripts_checked: result.transcripts.length,
+                transcripts_invalid: result.transcripts.filter((t) => !t.ok).length,
+                events: result.events,
+                invalid: result.transcripts.filter((t) => !t.ok),
+            }, out);
+            if (!result.ok)
+                process.exit(1);
+        }
+        catch (err) {
+            if (isCompostError(err))
+                emitError(err, out);
+            throw err;
+        }
+    });
     validate
         .command('transcript')
         .description('Validate a transcript.json against transcript.schema.json (#5)')

package/dist/commands/validate.js.map

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

package/dist/engine.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Public engine surface for in-process consumers (the Next.js web app, #119).
+ *
+ * The web UI reads via better-sqlite3 and performs every mutation through these
+ * functions — the SAME write+emit path the CLI uses — so files and provenance
+ * events never diverge between the two front-ends (ROADMAP: "mutations dispatch
+ * the CLI engine"). Nothing here is re-implemented in web/lib.
+ *
+ * Exposed as the `@they-juanreina/compost-cli/engine` subpath so importing the
+ * engine never drags in commander or the CLI program wiring.
+ */
+export { type Action, type ActorType, type Event, type EventInput, EventWriter, reduce, type Snapshot, SnapshotStore, } from '@they-juanreina/compost-provenance';
+export type { Chunk, ChunkMetadata, ScoredChunk } from '@they-juanreina/compost-retrieval';
+export { CompostError, type CompostErrorCode } from './errors.js';
+export { type CreateCodeInput, type CreatedArtifact, type CreateHighlightInput, type CreateThemeInput, createCode, createHighlight, createTheme, defaultResearcherId, endorseArtifact, HUMAN_REF_RE, rejectArtifact, updateArtifact, } from './lib/artifacts.js';
+export { type BlameEvent, type BlameResult, blame } from './lib/blame.js';
+export { type AiInputBundle, type Author, artifactId, emitAgentCreate, emitCreate, emitEndorse, emitReject, emitUpdate, openSeedEvents, } from './lib/events.js';
+export { agentsPath, type JournalSaveResult, type JournalVersion, parseVersions, readJournal, saveJournal, } from './lib/journal.js';
+export { getArtifact, listArtifacts, type SnapshotView } from './lib/reads.js';
+export { buildDenseRetriever, type LoadedCorpus, loadSeedCorpus, type RetrievalMode, type RetrieveResult, retrieveChunks, } from './lib/retrieve.js';
+export { resolveSeedPath } from './lib/seedResolve.js';
+export { getSession, listSessions, type SessionSummary, type SessionView, } from './lib/session.js';
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACL,KAAK,MAAM,EACX,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,UAAU,EACf,WAAW,EACX,MAAM,EACN,KAAK,QAAQ,EACb,aAAa,GACd,MAAM,oCAAoC,CAAA;AAE3C,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAA;AAE1F,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEjE,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,UAAU,EACV,eAAe,EACf,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,cAAc,GACf,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAEzE,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,MAAM,EACX,UAAU,EACV,eAAe,EACf,UAAU,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,cAAc,GACf,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,aAAa,EACb,WAAW,EACX,WAAW,GACZ,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE9E,OAAO,EACL,mBAAmB,EACnB,KAAK,YAAY,EACjB,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,cAAc,GACf,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAEtD,OAAO,EACL,UAAU,EACV,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAA"}

package/dist/engine.js

@@ -0,0 +1,32 @@
+/**
+ * Public engine surface for in-process consumers (the Next.js web app, #119).
+ *
+ * The web UI reads via better-sqlite3 and performs every mutation through these
+ * functions — the SAME write+emit path the CLI uses — so files and provenance
+ * events never diverge between the two front-ends (ROADMAP: "mutations dispatch
+ * the CLI engine"). Nothing here is re-implemented in web/lib.
+ *
+ * Exposed as the `@they-juanreina/compost-cli/engine` subpath so importing the
+ * engine never drags in commander or the CLI program wiring.
+ */
+// ---- provenance primitives re-exported so web has a single engine import
+export { EventWriter, reduce, SnapshotStore, } from '@they-juanreina/compost-provenance';
+// ---- errors
+export { CompostError } from './errors.js';
+// ---- artifact writes: create / endorse / reject / update (#119, #121)
+export { createCode, createHighlight, createTheme, defaultResearcherId, endorseArtifact, HUMAN_REF_RE, rejectArtifact, updateArtifact, } from './lib/artifacts.js';
+// ---- blame: artifact lineage chain (#122)
+export { blame } from './lib/blame.js';
+// ---- low-level event helpers (for callers that compose their own writes)
+export { artifactId, emitAgentCreate, emitCreate, emitEndorse, emitReject, emitUpdate, openSeedEvents, } from './lib/events.js';
+// ---- prompt journal: AGENTS.md read/parse/save (#122)
+export { agentsPath, parseVersions, readJournal, saveJournal, } from './lib/journal.js';
+// ---- artifact reads: list / get current snapshots (#121 GET endpoints)
+export { getArtifact, listArtifacts } from './lib/reads.js';
+// ---- chat retrieval: hybrid BM25 + dense, no LLM call (#122)
+export { buildDenseRetriever, loadSeedCorpus, retrieveChunks, } from './lib/retrieve.js';
+// ---- seed resolution (path-traversal hardened, #211)
+export { resolveSeedPath } from './lib/seedResolve.js';
+// ---- session reads (#120)
+export { getSession, listSessions, } from './lib/session.js';
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,2EAA2E;AAC3E,OAAO,EAKL,WAAW,EACX,MAAM,EAEN,aAAa,GACd,MAAM,oCAAoC,CAAA;AAG3C,cAAc;AACd,OAAO,EAAE,YAAY,EAAyB,MAAM,aAAa,CAAA;AACjE,wEAAwE;AACxE,OAAO,EAKL,UAAU,EACV,eAAe,EACf,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,cAAc,GACf,MAAM,oBAAoB,CAAA;AAC3B,4CAA4C;AAC5C,OAAO,EAAqC,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACzE,2EAA2E;AAC3E,OAAO,EAGL,UAAU,EACV,eAAe,EACf,UAAU,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,cAAc,GACf,MAAM,iBAAiB,CAAA;AACxB,wDAAwD;AACxD,OAAO,EACL,UAAU,EAGV,aAAa,EACb,WAAW,EACX,WAAW,GACZ,MAAM,kBAAkB,CAAA;AACzB,yEAAyE;AACzE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAqB,MAAM,gBAAgB,CAAA;AAC9E,+DAA+D;AAC/D,OAAO,EACL,mBAAmB,EAEnB,cAAc,EAGd,cAAc,GACf,MAAM,mBAAmB,CAAA;AAC1B,uDAAuD;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,4BAA4B;AAC5B,OAAO,EACL,UAAU,EACV,YAAY,GAGb,MAAM,kBAAkB,CAAA"}

package/dist/exporters/prov.d.ts

@@ -0,0 +1,11 @@
+export interface ProvExport {
+    document: Record<string, unknown>;
+    entities: number;
+    activities: number;
+    agents: number;
+    inputs: number;
+    models: number;
+    tools: number;
+}
+export declare function eventsToProvO(eventsDbPath: string): ProvExport;
+//# sourceMappingURL=prov.d.ts.map

package/dist/exporters/prov.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prov.d.ts","sourceRoot":"","sources":["../../src/exporters/prov.ts"],"names":[],"mappings":"AA2CA,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACd;AAsBD,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,CAyH9D"}

package/dist/exporters/prov.js

@@ -0,0 +1,151 @@
+import { existsSync } from 'node:fs';
+import Database from 'better-sqlite3';
+import { CompostError } from '../errors.js';
+const CONTEXT = {
+    prov: 'http://www.w3.org/ns/prov#',
+    compost: 'https://compost.dev/prov#',
+    provagent: 'https://compost.dev/prov-agent#',
+    xsd: 'http://www.w3.org/2001/XMLSchema#',
+};
+const ART = (id) => `compost:artifact/${id}`;
+const EVT = (id) => `compost:event/${id}`;
+const AGENT = (id) => `compost:agent/${encodeURIComponent(id)}`;
+const INPUT = (id) => `compost:input/${id}`;
+const MODEL = (m) => `compost:model/${encodeURIComponent(m)}`;
+const TOOL = (id) => `compost:tool/${encodeURIComponent(id)}`;
+function agentTypes(actorType) {
+    if (actorType === 'researcher')
+        return ['prov:Agent', 'prov:Person'];
+    if (actorType === 'ai')
+        return ['prov:Agent', 'prov:SoftwareAgent', 'provagent:AIAgent'];
+    return ['prov:Agent', 'prov:SoftwareAgent']; // agent
+}
+export function eventsToProvO(eventsDbPath) {
+    if (!existsSync(eventsDbPath)) {
+        throw new CompostError('FILE_NOT_FOUND', `No events.sqlite at ${eventsDbPath}`);
+    }
+    const db = new Database(eventsDbPath, { readonly: true, fileMustExist: true });
+    let rows;
+    try {
+        rows = db
+            .prepare('SELECT id, ts, artifact_kind, artifact_id, action, actor_type, actor_id, agent_name, agent_version, model, input_id, parent_event FROM events ORDER BY ts, rowid')
+            .all();
+    }
+    finally {
+        db.close();
+    }
+    const graph = [];
+    const artifacts = new Map(); // artifact_id → kind
+    const agents = new Map(); // actor_id → actor_type
+    const inputs = new Set();
+    const promptInputs = new Set(); // input bundles used by ai invocations
+    const aiArtifacts = new Set(); // artifacts generated by an ai invocation
+    const models = new Set();
+    const tools = new Map();
+    for (const e of rows) {
+        if (!artifacts.has(e.artifact_id))
+            artifacts.set(e.artifact_id, e.artifact_kind);
+        if (!agents.has(e.actor_id))
+            agents.set(e.actor_id, e.actor_type);
+        if (e.input_id !== null) {
+            inputs.add(e.input_id);
+            if (e.actor_type === 'ai')
+                promptInputs.add(e.input_id);
+        }
+        if (e.model !== null)
+            models.add(e.model);
+        if (e.actor_type === 'agent')
+            tools.set(e.actor_id, { name: e.agent_name, version: e.agent_version });
+        const generates = e.action === 'create' || e.action === 'link';
+        if (generates && e.actor_type === 'ai')
+            aiArtifacts.add(e.artifact_id);
+        const types = e.actor_type === 'ai' ? ['prov:Activity', 'provagent:AIModelInvocation'] : 'prov:Activity';
+        const activity = {
+            '@id': EVT(e.id),
+            '@type': types,
+            'prov:startedAtTime': { '@value': e.ts, '@type': 'xsd:dateTime' },
+            'prov:wasAssociatedWith': { '@id': AGENT(e.actor_id) },
+            'compost:action': e.action,
+            'compost:artifactKind': e.artifact_kind,
+        };
+        // create/link generate the entity; other actions use it.
+        const used = [];
+        if (generates) {
+            activity['prov:generated'] = { '@id': ART(e.artifact_id) };
+        }
+        else {
+            used.push({ '@id': ART(e.artifact_id) });
+        }
+        if (e.input_id !== null)
+            used.push({ '@id': INPUT(e.input_id) });
+        if (e.actor_type === 'ai' && e.model !== null)
+            used.push({ '@id': MODEL(e.model) });
+        if (e.actor_type === 'agent')
+            used.push({ '@id': TOOL(e.actor_id) });
+        if (used.length === 1)
+            activity['prov:used'] = used[0];
+        else if (used.length > 1)
+            activity['prov:used'] = used;
+        if (e.parent_event !== null)
+            activity['prov:wasInformedBy'] = { '@id': EVT(e.parent_event) };
+        if (e.model !== null)
+            activity['compost:model'] = e.model;
+        graph.push(activity);
+    }
+    // Entities (artifacts). ai-generated artifacts are also provagent:ResponseData.
+    for (const [artifactId, kind] of artifacts) {
+        graph.push({
+            '@id': ART(artifactId),
+            '@type': aiArtifacts.has(artifactId)
+                ? ['prov:Entity', 'provagent:ResponseData']
+                : 'prov:Entity',
+            'compost:kind': kind,
+            'compost:contentAddress': artifactId,
+        });
+    }
+    // Agents.
+    for (const [actorId, actorType] of agents) {
+        graph.push({
+            '@id': AGENT(actorId),
+            '@type': agentTypes(actorType),
+            'compost:actorType': actorType,
+            'compost:actorId': actorId,
+        });
+    }
+    // Input bundles. Those used by ai invocations are provagent:Prompt.
+    for (const inputId of inputs) {
+        graph.push({
+            '@id': INPUT(inputId),
+            '@type': promptInputs.has(inputId) ? ['prov:Entity', 'provagent:Prompt'] : 'prov:Entity',
+            'compost:kind': 'ai_input_bundle',
+            'compost:contentAddress': inputId,
+        });
+    }
+    // AI models referenced.
+    for (const model of models) {
+        graph.push({
+            '@id': MODEL(model),
+            '@type': ['prov:Entity', 'provagent:AIModel'],
+            'compost:model': model,
+        });
+    }
+    // Agent tools (deterministic software actors invoked as tools).
+    for (const [actorId, meta] of tools) {
+        graph.push({
+            '@id': TOOL(actorId),
+            '@type': ['prov:Entity', 'provagent:AgentTool'],
+            'compost:agentName': meta.name,
+            'compost:agentVersion': meta.version,
+        });
+    }
+    return {
+        document: { '@context': CONTEXT, '@graph': graph },
+        entities: artifacts.size,
+        activities: rows.length,
+        agents: agents.size,
+        inputs: inputs.size,
+        models: models.size,
+        tools: tools.size,
+    };
+}
+//# sourceMappingURL=prov.js.map

package/dist/exporters/prov.js.map

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

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,wBAAsB,GAAG,CAAC,IAAI,GAAE,SAAS,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,wBAAsB,GAAG,CAAC,IAAI,GAAE,SAAS,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ/E"}

package/dist/index.js

@@ -1,5 +1,11 @@
+import { loadSecretsEnv } from './lib/secrets.js';
 import { buildProgram } from './router.js';
 export async function run(argv = process.argv) {
+    // Load ~/.compost/secrets.env into the environment so file-stored secrets
+    // resolve everywhere an env var would (provider api_key_env, HUGGINGFACE_TOKEN,
+    // the native transcriber subprocess) without editing a shell profile. Env vars
+    // already set win; an insecure (group/world-readable) file is refused, not read.
+    loadSecretsEnv({ warn: (msg) => process.stderr.write(`${msg}\n`) });
     const program = buildProgram();
     await program.parseAsync(argv);
 }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,OAA0B,OAAO,CAAC,IAAI;IAC9D,MAAM,OAAO,GAAG,YAAY,EAAE,CAAA;IAC9B,MAAM,OAAO,CAAC,UAAU,CAAC,IAAgB,CAAC,CAAA;AAC5C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,OAA0B,OAAO,CAAC,IAAI;IAC9D,0EAA0E;IAC1E,gFAAgF;IAChF,+EAA+E;IAC/E,iFAAiF;IACjF,cAAc,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAA;IACnE,MAAM,OAAO,GAAG,YAAY,EAAE,CAAA;IAC9B,MAAM,OAAO,CAAC,UAAU,CAAC,IAAgB,CAAC,CAAA;AAC5C,CAAC"}

package/dist/lib/agreement.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Human↔machine intercoder agreement (§4).
+ *
+ * compost's *native* workflow produces endorse/reject decisions, which are
+ * reactive (the human sees the AI code first) — a κ computed on that violates κ's
+ * independence assumption. So legitimate agreement requires INDEPENDENT double
+ * coding: a researcher codes a sampled highlight set against the shared codebook
+ * WITHOUT seeing the machine's codes (`compost recode --blind`), and we compare
+ * those blind human codings to the machine codings on the doubly-coded units.
+ *
+ * A unit (highlight) can carry multiple codes, so we model each (unit, code) as a
+ * binary present/absent decision and compute, over the doubly-coded set:
+ *  - Cohen's κ per code and pooled over all (unit, code) cells (2 coders),
+ *  - Krippendorff's nominal α over the pooled cells (cross-check; handles the
+ *    general case).
+ */
+export type Coder = 'human' | 'machine';
+/** One coder asserting one code applies to one unit (highlight). */
+export interface Coding {
+    coder: Coder;
+    unit: string;
+    code: string;
+}
+export interface KappaResult {
+    kappa: number | null;
+    po: number;
+    pe: number;
+    n: number;
+}
+export interface PerCodeAgreement {
+    code: string;
+    kappa: number | null;
+    support: number;
+}
+export interface AgreementReport {
+    status: 'ok' | 'insufficient';
+    doubly_coded_units: number;
+    codes: number;
+    per_code: PerCodeAgreement[];
+    pooled_kappa: number | null;
+    krippendorff_alpha: number | null;
+    interpretation: string;
+    excluded_unnamed_machine_codes: number;
+    note?: string;
+}
+/** Cohen's κ for a single binary variable across paired ratings. */
+export declare function cohensKappaBinary(a: boolean[], b: boolean[]): KappaResult;
+/**
+ * Krippendorff's α (nominal metric) over a units × coders matrix. Cells may be
+ * null (a coder didn't code that unit). Units with fewer than two values are
+ * dropped (not pairable). General coincidence-matrix algorithm.
+ */
+export declare function krippendorffAlphaNominal(units: Array<Array<string | null>>): number | null;
+export interface AgreementOptions {
+    /** Minimum doubly-coded units below which κ is statistical noise. */
+    minUnits?: number;
+    excludedUnnamedMachineCodes?: number;
+}
+/**
+ * Compute agreement from a flat list of (coder, unit, code) codings. Only units
+ * coded by BOTH coders count (the doubly-coded set); the codebook is the union of
+ * codes either coder used on those units.
+ */
+export declare function computeAgreement(codings: Coding[], opts?: AgreementOptions): AgreementReport;
+/**
+ * Extract codings from a seed's event log. Machine codings come from named `code`
+ * create events (actor ai/agent) via their `evidence` highlight ids; unnamed
+ * cluster codes (similarity-scanner `members`) have no shared label and are
+ * excluded (counted, never silently dropped). Human codings come from blind
+ * `coding` link events (actor researcher, payload.blind === true). Artifacts with
+ * a reject/unlink event are excluded.
+ */
+export declare function readCodings(eventsDbPath: string): {
+    codings: Coding[];
+    excludedUnnamedMachineCodes: number;
+};
+//# sourceMappingURL=agreement.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agreement.d.ts","sourceRoot":"","sources":["../../src/lib/agreement.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,SAAS,CAAA;AAEvC,oEAAoE;AACpE,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,KAAK,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;IACV,CAAC,EAAE,MAAM,CAAA;CACV;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,IAAI,GAAG,cAAc,CAAA;IAC7B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,gBAAgB,EAAE,CAAA;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,cAAc,EAAE,MAAM,CAAA;IACtB,8BAA8B,EAAE,MAAM,CAAA;IACtC,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAID,oEAAoE;AACpE,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,WAAW,CAuBzE;AAID;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,CAiD1F;AAcD,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2BAA2B,CAAC,EAAE,MAAM,CAAA;CACrC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,gBAAqB,GAAG,eAAe,CA8EhG;AAUD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG;IACjD,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,2BAA2B,EAAE,MAAM,CAAA;CACpC,CAuDA"}