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

package/dist/legacy_client.js

@@ -0,0 +1,44 @@
+import { resolveFetch } from './llm/http.js';
+export class LegacyServiceError extends Error {
+    kind;
+    constructor(message, kind) {
+        super(message);
+        this.kind = kind;
+        this.name = 'LegacyServiceError';
+    }
+}
+/** HTTP client for the transcriber service's /legacy-ingest route. */
+export class LegacyIngestClient {
+    base;
+    fetchImpl;
+    timeoutMs;
+    constructor(opts = {}) {
+        this.base = (opts.baseUrl ?? 'http://localhost:7862').replace(/\/$/, '');
+        this.fetchImpl = resolveFetch(opts.fetchImpl);
+        this.timeoutMs = opts.timeoutMs ?? 600_000; // 10 min; PDFs with OCR can be slow
+    }
+    async ingest(req) {
+        let res;
+        try {
+            res = await this.fetchImpl(`${this.base}/legacy-ingest`, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify(req),
+            });
+        }
+        catch (err) {
+            throw new LegacyServiceError(`legacy-ingest service unreachable at ${this.base}: ${err instanceof Error ? err.message : String(err)}`, 'down');
+        }
+        if (res.status === 503)
+            throw new LegacyServiceError('legacy-ingest dep missing (install transcriber [legacy] extras)', 'dep_missing');
+        if (res.status === 422) {
+            const body = (await res.json());
+            throw new LegacyServiceError(`invalid_input: ${body.detail ?? 'unknown'}`, 'invalid_input');
+        }
+        if (!res.ok) {
+            throw new LegacyServiceError(`legacy-ingest failed: ${res.status} ${res.statusText}`, 'failed');
+        }
+        return (await res.json());
+    }
+}
+//# sourceMappingURL=legacy_client.js.map

package/dist/legacy_client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy_client.js","sourceRoot":"","sources":["../src/legacy_client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAwB5C,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAGzB;IAFlB,YACE,OAAe,EACC,IAAyD;QAEzE,KAAK,CAAC,OAAO,CAAC,CAAA;QAFE,SAAI,GAAJ,IAAI,CAAqD;QAGzE,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;IAClC,CAAC;CACF;AAQD,sEAAsE;AACtE,MAAM,OAAO,kBAAkB;IACZ,IAAI,CAAQ;IACZ,SAAS,CAAW;IACpB,SAAS,CAAQ;IAElC,YAAY,OAA4B,EAAE;QACxC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,uBAAuB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;QACxE,IAAI,CAAC,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAC7C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,OAAO,CAAA,CAAC,oCAAoC;IACjF,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAwB;QACnC,IAAI,GAAmC,CAAA;QACvC,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,IAAI,gBAAgB,EAAE;gBACvD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;aAC1B,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,kBAAkB,CAC1B,wCAAwC,IAAI,CAAC,IAAI,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EACxG,MAAM,CACP,CAAA;QACH,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YACpB,MAAM,IAAI,kBAAkB,CAC1B,iEAAiE,EACjE,aAAa,CACd,CAAA;QACH,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAwB,CAAA;YACtD,MAAM,IAAI,kBAAkB,CAAC,kBAAkB,IAAI,CAAC,MAAM,IAAI,SAAS,EAAE,EAAE,eAAe,CAAC,CAAA;QAC7F,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,kBAAkB,CAC1B,yBAAyB,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,EACvD,QAAQ,CACT,CAAA;QACH,CAAC;QACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAyB,CAAA;IACnD,CAAC;CACF"}

package/dist/lib/answerSchema.d.ts

@@ -0,0 +1,2 @@
+export declare const ANSWER_JSON_SCHEMA: Record<string, unknown>;
+//# sourceMappingURL=answerSchema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"answerSchema.d.ts","sourceRoot":"","sources":["../../src/lib/answerSchema.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAsBtD,CAAA"}

package/dist/lib/answerSchema.js

@@ -0,0 +1,27 @@
+// JSON Schema passed to providers that support structured output, so the
+// model returns a citation-carrying answer the retrieval validator can check.
+// Mirrors schema/answer.schema.json.
+export const ANSWER_JSON_SCHEMA = {
+    type: 'object',
+    required: ['answer', 'claims'],
+    additionalProperties: false,
+    properties: {
+        answer: { type: 'string' },
+        insufficient_evidence: { type: 'boolean' },
+        claims: {
+            type: 'array',
+            items: {
+                type: 'object',
+                required: ['quote', 'utterance_id', 'session_id', 'confidence'],
+                additionalProperties: false,
+                properties: {
+                    quote: { type: 'string' },
+                    utterance_id: { type: 'string' },
+                    session_id: { type: 'string' },
+                    confidence: { type: 'number' },
+                },
+            },
+        },
+    },
+};
+//# sourceMappingURL=answerSchema.js.map

package/dist/lib/answerSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"answerSchema.js","sourceRoot":"","sources":["../../src/lib/answerSchema.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,8EAA8E;AAC9E,qCAAqC;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAA4B;IACzD,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC9B,oBAAoB,EAAE,KAAK;IAC3B,UAAU,EAAE;QACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1B,qBAAqB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QAC1C,MAAM,EAAE;YACN,IAAI,EAAE,OAAO;YACb,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,CAAC;gBAC/D,oBAAoB,EAAE,KAAK;gBAC3B,UAAU,EAAE;oBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAChC,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC9B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC/B;aACF;SACF;KACF;CACF,CAAA"}

package/dist/lib/artifacts.d.ts

@@ -0,0 +1,64 @@
+import Database from 'better-sqlite3';
+import { type Author } from './events.js';
+export interface CreatedArtifact {
+    id: string;
+    artifact_id: string;
+    path: string;
+    event_id: string;
+}
+export interface CreateHighlightInput {
+    sessionId: string;
+    utteranceId: string;
+    span: [number, number];
+    text: string;
+    author: Author;
+}
+export declare function createHighlight(seedPath: string, input: CreateHighlightInput): CreatedArtifact;
+export interface CreateCodeInput {
+    name: string;
+    definition: string;
+    evidence?: string[];
+    author: Author;
+}
+export declare function createCode(seedPath: string, input: CreateCodeInput): CreatedArtifact;
+export interface CreateThemeInput {
+    name: string;
+    summary: string;
+    codes?: string[];
+    author: Author;
+}
+export declare function createTheme(seedPath: string, input: CreateThemeInput): CreatedArtifact;
+interface CreateEventRow {
+    id: string;
+    artifact_kind: string;
+}
+/**
+ * Human-id form for an artifact ref: `H-NNN`, `C-slug`, `T-slug` — the id
+ * `compost create` prints. We accept it wherever a SHA prefix is accepted so
+ * the obvious `endorse <id-from-create>` round-trip works (#168). The dash and
+ * non-hex chars make it unambiguous vs a SHA prefix (`^[a-f0-9]{8,64}$`).
+ */
+export declare const HUMAN_REF_RE: RegExp;
+/**
+ * Look up a create event by the human id stored in its payload (initialState.id).
+ * Returns undefined when the ref isn't a human id OR no matching create exists,
+ * so callers can fall through to SHA-prefix / latest: handling.
+ */
+export declare function tryResolveHumanRef(db: Database.Database, ref: string): (CreateEventRow & {
+    artifact_id: string;
+}) | undefined;
+/**
+ * Resolve an artifact ref (human id, full/prefix SHA, or `latest:<kind>=<seed>`)
+ * to its create event, then emit a researcher endorse chaining it. Mirrors
+ * blame's ref resolution so `compost endorse <id-from-create>` works (#168).
+ */
+export declare function endorseArtifact(seedPath: string, artifactRef: string, researcherId: string): {
+    artifact_id: string;
+    endorse_event_id: string;
+    parent_event_id: string;
+    already_endorsed?: true;
+};
+/** Read the configured researcher identity: COMPOST_USER env, else fallback. */
+export declare function defaultResearcherId(): string;
+export {};
+//# sourceMappingURL=artifacts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/lib/artifacts.ts"],"names":[],"mappings":"AAGA,OAAO,QAAQ,MAAM,gBAAgB,CAAA;AAGrC,OAAO,EAAE,KAAK,MAAM,EAAuD,MAAM,aAAa,CAAA;AAE9F,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB;AA8ED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACf;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,eAAe,CA+B9F;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,eAAe,CA2BpF;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,eAAe,CA4BtF;AAID,UAAU,cAAc;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,QAA2B,CAAA;AAEpD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,GAAG,EAAE,MAAM,GACV,CAAC,cAAc,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CAOxD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB;IACD,WAAW,EAAE,MAAM,CAAA;IACnB,gBAAgB,EAAE,MAAM,CAAA;IACxB,eAAe,EAAE,MAAM,CAAA;IACvB,gBAAgB,CAAC,EAAE,IAAI,CAAA;CACxB,CAmFA;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}

package/dist/lib/artifacts.js

@@ -0,0 +1,254 @@
+import { existsSync, mkdirSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import Database from 'better-sqlite3';
+import { CompostError } from '../errors.js';
+import { artifactId, emitCreate, emitEndorse, openSeedEvents } from './events.js';
+// ---------------------------------------------------------------- helpers
+/** Next sequential H-NNN in highlights/, scanning existing files. */
+function nextHighlightId(dir) {
+    let max = 0;
+    if (existsSync(dir)) {
+        for (const f of readdirSync(dir)) {
+            const m = /^H-(\d+)\.md$/.exec(f);
+            if (m)
+                max = Math.max(max, Number.parseInt(m[1], 10));
+        }
+    }
+    return `H-${String(max + 1).padStart(3, '0')}`;
+}
+/** Filesystem-safe slug for code/theme names. */
+function slug(name) {
+    const s = name
+        .toLowerCase()
+        .trim()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    if (s.length === 0)
+        throw new CompostError('INVALID_INPUT', `Name has no slug-able characters: ${JSON.stringify(name)}`);
+    return s;
+}
+function frontmatter(fields) {
+    const lines = Object.entries(fields).map(([k, v]) => `${k}: ${formatYamlValue(v)}`);
+    return `---\n${lines.join('\n')}\n---\n`;
+}
+function formatYamlValue(v) {
+    if (Array.isArray(v))
+        return `[${v.map((x) => String(x)).join(', ')}]`;
+    if (typeof v === 'object' && v !== null) {
+        const inner = Object.entries(v)
+            .map(([k, val]) => `${k}: ${String(val)}`)
+            .join(', ');
+        return `{ ${inner} }`;
+    }
+    return String(v);
+}
+// ---------------------------------------------------------------- create
+/**
+ * Write the markdown, then emit its create event — atomically. If the event
+ * fails (e.g. schema validation: AI events require model + prompt_hash), roll
+ * the file back so no code path ever leaves a `.md` without a matching create
+ * event (#165). The caller guarantees `path` did not pre-exist (existsSync
+ * check / fresh sequential id), so the rollback only removes our own write.
+ */
+function writeArtifactAtomic(seedPath, path, body, event) {
+    writeFileSync(path, body, 'utf8');
+    const events = openSeedEvents(seedPath);
+    try {
+        return emitCreate(events, event).id;
+    }
+    catch (err) {
+        try {
+            rmSync(path, { force: true }); // roll back the orphan-to-be
+        }
+        catch {
+            // best-effort cleanup; surface the original (more useful) error regardless
+        }
+        throw err;
+    }
+    finally {
+        events.close();
+    }
+}
+export function createHighlight(seedPath, input) {
+    const dir = join(seedPath, 'highlights');
+    mkdirSync(dir, { recursive: true });
+    const id = nextHighlightId(dir);
+    // initialState is what the SHA addresses — the artifact's identity at birth.
+    const initialState = {
+        id,
+        kind: 'highlight',
+        session_id: input.sessionId,
+        utterance_id: input.utteranceId,
+        span: input.span,
+        text: input.text,
+    };
+    const sha = artifactId(initialState);
+    const body = `${frontmatter({
+        id,
+        session_id: input.sessionId,
+        utterance_id: input.utteranceId,
+        span: input.span,
+        artifact_id: sha,
+        provenance: { actor_type: input.author.actorType, actor_id: input.author.actorId },
+    })}\n${input.text}\n`;
+    const path = join(dir, `${id}.md`);
+    const event_id = writeArtifactAtomic(seedPath, path, body, {
+        artifactKind: 'highlight',
+        initialState,
+        author: input.author,
+    });
+    return { id, artifact_id: sha, path, event_id };
+}
+export function createCode(seedPath, input) {
+    const dir = join(seedPath, 'codebook');
+    mkdirSync(dir, { recursive: true });
+    const name = slug(input.name);
+    const id = `C-${name}`;
+    const evidence = input.evidence ?? [];
+    const initialState = { id, kind: 'code', name, definition: input.definition, evidence };
+    const sha = artifactId(initialState);
+    const body = `${frontmatter({
+        id,
+        name,
+        evidence,
+        artifact_id: sha,
+        provenance: { actor_type: input.author.actorType, actor_id: input.author.actorId },
+    })}\n${input.definition}\n`;
+    const path = join(dir, `${name}.md`);
+    if (existsSync(path)) {
+        throw new CompostError('INVALID_INPUT', `Code "${id}" already exists at ${path}`);
+    }
+    const event_id = writeArtifactAtomic(seedPath, path, body, {
+        artifactKind: 'code',
+        initialState,
+        author: input.author,
+    });
+    return { id, artifact_id: sha, path, event_id };
+}
+export function createTheme(seedPath, input) {
+    const dir = join(seedPath, 'synthesis', 'themes');
+    mkdirSync(dir, { recursive: true });
+    const name = slug(input.name);
+    const id = `T-${name}`;
+    const codes = input.codes ?? [];
+    const initialState = { id, kind: 'theme', name, summary: input.summary, codes };
+    const sha = artifactId(initialState);
+    const title = input.name.trim();
+    const body = `${frontmatter({
+        id,
+        name,
+        codes,
+        artifact_id: sha,
+        provenance: { actor_type: input.author.actorType, actor_id: input.author.actorId },
+    })}\n# ${title}\n\n${input.summary}\n`;
+    const path = join(dir, `${name}.md`);
+    if (existsSync(path)) {
+        throw new CompostError('INVALID_INPUT', `Theme "${id}" already exists at ${path}`);
+    }
+    const event_id = writeArtifactAtomic(seedPath, path, body, {
+        artifactKind: 'theme',
+        initialState,
+        author: input.author,
+    });
+    return { id, artifact_id: sha, path, event_id };
+}
+/**
+ * Human-id form for an artifact ref: `H-NNN`, `C-slug`, `T-slug` — the id
+ * `compost create` prints. We accept it wherever a SHA prefix is accepted so
+ * the obvious `endorse <id-from-create>` round-trip works (#168). The dash and
+ * non-hex chars make it unambiguous vs a SHA prefix (`^[a-f0-9]{8,64}$`).
+ */
+export const HUMAN_REF_RE = /^[CHT]-[A-Za-z0-9_-]+$/;
+/**
+ * Look up a create event by the human id stored in its payload (initialState.id).
+ * Returns undefined when the ref isn't a human id OR no matching create exists,
+ * so callers can fall through to SHA-prefix / latest: handling.
+ */
+export function tryResolveHumanRef(db, ref) {
+    if (!HUMAN_REF_RE.test(ref))
+        return undefined;
+    return db
+        .prepare("SELECT id, artifact_kind, artifact_id FROM events WHERE action = 'create' AND json_extract(payload, '$.id') = ? ORDER BY ts, rowid LIMIT 1")
+        .get(ref);
+}
+/**
+ * Resolve an artifact ref (human id, full/prefix SHA, or `latest:<kind>=<seed>`)
+ * to its create event, then emit a researcher endorse chaining it. Mirrors
+ * blame's ref resolution so `compost endorse <id-from-create>` works (#168).
+ */
+export function endorseArtifact(seedPath, artifactRef, researcherId) {
+    const eventsDb = join(seedPath, '.compost', 'events.sqlite');
+    if (!existsSync(eventsDb)) {
+        throw new CompostError('FILE_NOT_FOUND', `No events.sqlite in seed; nothing to endorse.`);
+    }
+    const db = new Database(eventsDb, { readonly: true, fileMustExist: true });
+    let createRow;
+    // Same (artifact_id, researcher) endorse already on the timeline → idempotent
+    // no-op (#169). Looked up alongside the create row so we hold the read-only
+    // connection once and avoid a stat/open dance.
+    let existingEndorse;
+    try {
+        createRow = tryResolveHumanRef(db, artifactRef);
+        if (createRow === undefined) {
+            const latest = /^latest:(\w+)=(.+)$/.exec(artifactRef);
+            if (latest) {
+                const kind = latest[1];
+                createRow = db
+                    .prepare("SELECT id, artifact_kind, artifact_id FROM events WHERE artifact_kind = ? AND action = 'create' ORDER BY ts DESC, rowid DESC LIMIT 1")
+                    .get(kind);
+            }
+            else if (/^[a-f0-9]{8,64}$/i.test(artifactRef)) {
+                createRow = db
+                    .prepare("SELECT id, artifact_kind, artifact_id FROM events WHERE artifact_id LIKE ? AND action = 'create' ORDER BY ts, rowid LIMIT 1")
+                    .get(`${artifactRef.toLowerCase()}%`);
+            }
+            else if (!HUMAN_REF_RE.test(artifactRef)) {
+                // Not human-shaped, not SHA-shaped, not latest: → user typed something
+                // unparseable. (Human-shaped refs that didn't resolve fall through to
+                // the FILE_NOT_FOUND below with a clearer message.)
+                throw new CompostError('INVALID_INPUT', `Invalid artifact ref "${artifactRef}". Use the id from \`compost create\` (e.g. C-slug, H-001), a SHA256 prefix, or latest:<kind>=<seed>.`);
+            }
+        }
+        if (createRow !== undefined) {
+            existingEndorse = db
+                .prepare("SELECT id, parent_event FROM events WHERE artifact_id = ? AND action = 'endorse' AND actor_id = ? ORDER BY ts, rowid LIMIT 1")
+                .get(createRow.artifact_id, researcherId);
+        }
+    }
+    finally {
+        db.close();
+    }
+    if (createRow === undefined) {
+        throw new CompostError('FILE_NOT_FOUND', `No create event found for ref "${artifactRef}".`);
+    }
+    if (existingEndorse !== undefined) {
+        return {
+            artifact_id: createRow.artifact_id,
+            endorse_event_id: existingEndorse.id,
+            parent_event_id: existingEndorse.parent_event ?? createRow.id,
+            already_endorsed: true,
+        };
+    }
+    const events = openSeedEvents(seedPath);
+    try {
+        const endorse = emitEndorse(events, {
+            artifactKind: createRow.artifact_kind,
+            artifactId: createRow.artifact_id,
+            parentEventId: createRow.id,
+            researcherId,
+        });
+        return {
+            artifact_id: createRow.artifact_id,
+            endorse_event_id: endorse.id,
+            parent_event_id: createRow.id,
+        };
+    }
+    finally {
+        events.close();
+    }
+}
+/** Read the configured researcher identity: COMPOST_USER env, else fallback. */
+export function defaultResearcherId() {
+    return process.env.COMPOST_USER || process.env.USER || 'researcher';
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/lib/artifacts.js.map

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

package/dist/lib/blame.d.ts

@@ -0,0 +1,30 @@
+export interface BlameEvent {
+    id: string;
+    ts: string;
+    artifact_kind: string;
+    artifact_id: string;
+    action: string;
+    actor_type: 'researcher' | 'agent' | 'ai';
+    actor_id: string;
+    agent_name: string | null;
+    agent_version: string | null;
+    prompt_hash: string | null;
+    model: string | null;
+    payload: unknown;
+    parent_event: string | null;
+    batch_id: string | null;
+}
+export interface BlameResult {
+    schema_version: '1.0';
+    query: string;
+    resolved_artifact_id: string;
+    seed: string;
+    events: BlameEvent[];
+}
+export interface BlameOptions {
+    cwd?: string;
+    seed?: string;
+}
+export declare function blame(query: string, opts?: BlameOptions): BlameResult;
+export declare function renderHuman(result: BlameResult): string;
+//# sourceMappingURL=blame.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blame.d.ts","sourceRoot":"","sources":["../../src/lib/blame.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;IACV,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,YAAY,GAAG,OAAO,GAAG,IAAI,CAAA;IACzC,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,OAAO,EAAE,OAAO,CAAA;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,KAAK,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,oBAAoB,EAAE,MAAM,CAAA;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,UAAU,EAAE,CAAA;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAsBD,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,WAAW,CA4BzE;AAkJD,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAqBvD"}

package/dist/lib/blame.js

@@ -0,0 +1,164 @@
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import Database from 'better-sqlite3';
+import { CompostError } from '../errors.js';
+import { HUMAN_REF_RE, tryResolveHumanRef } from './artifacts.js';
+const ARTIFACT_PREFIX_RE = /^[a-f0-9]{8,64}$/i;
+const LATEST_REF_RE = /^latest:(\w+)=(.+)$/;
+export function blame(query, opts = {}) {
+    const cwd = opts.cwd ?? process.cwd();
+    const seedName = resolveSeedForBlame(query, opts.seed, cwd);
+    const eventsDb = resolve(cwd, 'Seeds', seedName, '.compost', 'events.sqlite');
+    if (!existsSync(eventsDb)) {
+        throw new CompostError('FILE_NOT_FOUND', `No events.sqlite at ${eventsDb}. Has any artifact been created in seed "${seedName}"?`);
+    }
+    const db = new Database(eventsDb, { readonly: true, fileMustExist: true });
+    try {
+        const artifactId = resolveArtifactId(db, query, seedName);
+        const rows = db
+            .prepare('SELECT * FROM events WHERE artifact_id = ? ORDER BY ts, rowid')
+            .all(artifactId);
+        return {
+            schema_version: '1.0',
+            query,
+            resolved_artifact_id: artifactId,
+            seed: seedName,
+            events: rows.map(rowToEvent),
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+function rowToEvent(row) {
+    return {
+        id: row.id,
+        ts: row.ts,
+        artifact_kind: row.artifact_kind,
+        artifact_id: row.artifact_id,
+        action: row.action,
+        actor_type: row.actor_type,
+        actor_id: row.actor_id,
+        agent_name: row.agent_name,
+        agent_version: row.agent_version,
+        prompt_hash: row.prompt_hash,
+        model: row.model,
+        payload: JSON.parse(row.payload),
+        parent_event: row.parent_event,
+        batch_id: row.batch_id,
+    };
+}
+function resolveArtifactId(db, query, seed) {
+    // Human id (H-NNN / C-slug / T-slug) — the form `compost create` prints (#168).
+    // Tried first so a human ref short-circuits before the SHA/latest branches.
+    const humanRow = tryResolveHumanRef(db, query);
+    if (humanRow !== undefined)
+        return humanRow.artifact_id;
+    if (HUMAN_REF_RE.test(query)) {
+        throw new CompostError('FILE_NOT_FOUND', `No artifact with id "${query}" in seed "${seed}".`);
+    }
+    const latestMatch = LATEST_REF_RE.exec(query);
+    if (latestMatch !== null) {
+        const kind = latestMatch[1];
+        const target = latestMatch[2];
+        if (target !== seed) {
+            throw new CompostError('INVALID_INPUT', `latest: ref points at seed "${target}" but we resolved seed "${seed}"`);
+        }
+        const row = db
+            .prepare('SELECT artifact_id FROM events WHERE artifact_kind = ? AND action = ? ORDER BY ts DESC, rowid DESC LIMIT 1')
+            .get(kind, 'create');
+        if (row === undefined) {
+            throw new CompostError('FILE_NOT_FOUND', `No "${kind}" artifacts found in seed "${seed}"`);
+        }
+        return row.artifact_id;
+    }
+    if (!ARTIFACT_PREFIX_RE.test(query)) {
+        throw new CompostError('INVALID_INPUT', `Invalid artifact ref "${query}". Expected the id from \`compost create\` (e.g. C-slug, H-001), a SHA256 prefix (8-64 hex chars), or "latest:<kind>=<seed>".`);
+    }
+    if (query.length === 64)
+        return query.toLowerCase();
+    const matches = db
+        .prepare('SELECT DISTINCT artifact_id FROM events WHERE artifact_id LIKE ?')
+        .all(`${query.toLowerCase()}%`);
+    if (matches.length === 0) {
+        throw new CompostError('FILE_NOT_FOUND', `No artifact found matching prefix "${query}" in seed "${seed}"`);
+    }
+    if (matches.length > 1) {
+        throw new CompostError('INVALID_INPUT', `Prefix "${query}" is ambiguous (${matches.length} matches). Use more characters.`);
+    }
+    return matches[0].artifact_id;
+}
+/**
+ * Resolve the seed name for a blame query.
+ *
+ * Precedence:
+ *  1. Explicit `--seed` flag — wins, but errors if a `latest:kind=seed` ref
+ *     embeds a different name.
+ *  2. Seed embedded in the ref (`latest:kind=<seed>`) — used when no flag is
+ *     given; skips the multi-seed singleton check (the ref already disambiguates).
+ *  3. Fall back to `findSingletonSeed`, which errors in multi-seed workspaces.
+ *
+ * The earlier bug: precedence (3) fired before (2) was considered, so
+ * `compost blame latest:ingest_job=Lineage` errored in a multi-seed workspace
+ * even though the ref already named the seed.
+ */
+function resolveSeedForBlame(query, seedFlag, cwd) {
+    const latestMatch = LATEST_REF_RE.exec(query);
+    const seedFromRef = latestMatch !== null ? latestMatch[2] : undefined;
+    if (seedFlag !== undefined && seedFromRef !== undefined && seedFlag !== seedFromRef) {
+        // When the only difference is case AND the flag's exact-cased name is not
+        // a directory entry, the user almost certainly mistyped — surface that
+        // instead of the misleading generic "disagrees" message.
+        //
+        // We readdirSync rather than existsSync because macOS HFS+/APFS is
+        // case-insensitive by default: existsSync('Seeds/lineage') returns true
+        // even when only 'Seeds/Lineage' is on disk. readdir gives us the actual
+        // directory entry names.
+        if (seedFlag.toLowerCase() === seedFromRef.toLowerCase()) {
+            const root = resolve(cwd, 'Seeds');
+            const entries = existsSync(root) ? readdirSync(root) : [];
+            if (!entries.includes(seedFlag)) {
+                throw new CompostError('INVALID_INPUT', `Seed names are case-sensitive; "${seedFlag}" does not exist. Did you mean "${seedFromRef}"?`);
+            }
+        }
+        throw new CompostError('INVALID_INPUT', `--seed "${seedFlag}" disagrees with ref-embedded seed "${seedFromRef}"`);
+    }
+    return seedFlag ?? seedFromRef ?? findSingletonSeed(cwd);
+}
+function findSingletonSeed(cwd) {
+    const root = resolve(cwd, 'Seeds');
+    if (!existsSync(root)) {
+        throw new CompostError('NOT_IN_SEED', `No Seeds/ at ${root}. Pass --seed <name> or run from a directory containing one.`);
+    }
+    const entries = readdirSync(root).filter((e) => !e.startsWith('.') && statSync(join(root, e)).isDirectory());
+    if (entries.length === 0) {
+        throw new CompostError('NOT_IN_SEED', `No seeds found under ${root}`);
+    }
+    if (entries.length > 1) {
+        throw new CompostError('INVALID_INPUT', `Multiple seeds under ${root} (${entries.join(', ')}). Pass --seed <name>.`);
+    }
+    return entries[0];
+}
+export function renderHuman(result) {
+    const lines = [];
+    lines.push(`blame ${result.resolved_artifact_id.slice(0, 12)}… (${result.events.length} events in seed "${result.seed}")`);
+    for (const e of result.events) {
+        const tag = e.actor_type === 'ai'
+            ? `[ai] ${e.model ?? '?'}`
+            : e.actor_type === 'agent'
+                ? `[agent] ${e.agent_name ?? '?'}@${e.agent_version ?? '?'}`
+                : `[researcher] ${e.actor_id}`;
+        lines.push('');
+        lines.push(`event ${e.id}`);
+        lines.push(`  ${e.action.padEnd(8)} ${e.ts}`);
+        lines.push(`  ${tag}`);
+        if (e.parent_event !== null)
+            lines.push(`  parent ${e.parent_event}`);
+        if (e.batch_id !== null)
+            lines.push(`  batch  ${e.batch_id}`);
+        if (e.prompt_hash !== null)
+            lines.push(`  prompt ${e.prompt_hash.slice(0, 12)}…`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=blame.js.map

package/dist/lib/blame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blame.js","sourceRoot":"","sources":["../../src/lib/blame.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAC3D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEzC,OAAO,QAAQ,MAAM,gBAAgB,CAAA;AAErC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAgCjE,MAAM,kBAAkB,GAAG,mBAAmB,CAAA;AAC9C,MAAM,aAAa,GAAG,qBAAqB,CAAA;AAmB3C,MAAM,UAAU,KAAK,CAAC,KAAa,EAAE,OAAqB,EAAE;IAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;IACrC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAC3D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,CAAC,CAAA;IAE7E,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,YAAY,CACpB,gBAAgB,EAChB,uBAAuB,QAAQ,4CAA4C,QAAQ,IAAI,CACxF,CAAA;IACH,CAAC;IAED,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;IAC1E,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,iBAAiB,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAA;QACzD,MAAM,IAAI,GAAG,EAAE;aACZ,OAAO,CAAC,+DAA+D,CAAC;aACxE,GAAG,CAAC,UAAU,CAAe,CAAA;QAChC,OAAO;YACL,cAAc,EAAE,KAAK;YACrB,KAAK;YACL,oBAAoB,EAAE,UAAU;YAChC,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;SAC7B,CAAA;IACH,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAA;IACZ,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,GAAa;IAC/B,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,UAAU,EAAE,GAAG,CAAC,UAAsC;QACtD,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAY;QAC3C,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,QAAQ,EAAE,GAAG,CAAC,QAAQ;KACvB,CAAA;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,EAAqB,EAAE,KAAa,EAAE,IAAY;IAC3E,gFAAgF;IAChF,4EAA4E;IAC5E,MAAM,QAAQ,GAAG,kBAAkB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;IAC9C,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC,WAAW,CAAA;IACvD,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,YAAY,CAAC,gBAAgB,EAAE,wBAAwB,KAAK,cAAc,IAAI,IAAI,CAAC,CAAA;IAC/F,CAAC;IAED,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC7C,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAE,CAAA;QAC5B,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAE,CAAA;QAC9B,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,MAAM,IAAI,YAAY,CACpB,eAAe,EACf,+BAA+B,MAAM,2BAA2B,IAAI,GAAG,CACxE,CAAA;QACH,CAAC;QACD,MAAM,GAAG,GAAG,EAAE;aACX,OAAO,CACN,4GAA4G,CAC7G;aACA,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAwC,CAAA;QAC7D,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,IAAI,YAAY,CAAC,gBAAgB,EAAE,OAAO,IAAI,8BAA8B,IAAI,GAAG,CAAC,CAAA;QAC5F,CAAC;QACD,OAAO,GAAG,CAAC,WAAW,CAAA;IACxB,CAAC;IAED,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,YAAY,CACpB,eAAe,EACf,yBAAyB,KAAK,+HAA+H,CAC9J,CAAA;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC,WAAW,EAAE,CAAA;IAEnD,MAAM,OAAO,GAAG,EAAE;SACf,OAAO,CAAC,kEAAkE,CAAC;SAC3E,GAAG,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,GAAG,CAAmC,CAAA;IACnE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,YAAY,CACpB,gBAAgB,EAChB,sCAAsC,KAAK,cAAc,IAAI,GAAG,CACjE,CAAA;IACH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,YAAY,CACpB,eAAe,EACf,WAAW,KAAK,mBAAmB,OAAO,CAAC,MAAM,iCAAiC,CACnF,CAAA;IACH,CAAC;IACD,OAAO,OAAO,CAAC,CAAC,CAAE,CAAC,WAAW,CAAA;AAChC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,mBAAmB,CAAC,KAAa,EAAE,QAA4B,EAAE,GAAW;IACnF,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC7C,MAAM,WAAW,GAAG,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAErE,IAAI,QAAQ,KAAK,SAAS,IAAI,WAAW,KAAK,SAAS,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;QACpF,0EAA0E;QAC1E,uEAAuE;QACvE,yDAAyD;QACzD,EAAE;QACF,mEAAmE;QACnE,wEAAwE;QACxE,yEAAyE;QACzE,yBAAyB;QACzB,IAAI,QAAQ,CAAC,WAAW,EAAE,KAAK,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC;YACzD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;YAClC,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;YACzD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAChC,MAAM,IAAI,YAAY,CACpB,eAAe,EACf,mCAAmC,QAAQ,mCAAmC,WAAW,IAAI,CAC9F,CAAA;YACH,CAAC;QACH,CAAC;QACD,MAAM,IAAI,YAAY,CACpB,eAAe,EACf,WAAW,QAAQ,uCAAuC,WAAW,GAAG,CACzE,CAAA;IACH,CAAC;IACD,OAAO,QAAQ,IAAI,WAAW,IAAI,iBAAiB,CAAC,GAAG,CAAC,CAAA;AAC1D,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAW;IACpC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IAClC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,YAAY,CACpB,aAAa,EACb,gBAAgB,IAAI,8DAA8D,CACnF,CAAA;IACH,CAAC;IACD,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,CACtC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CACnE,CAAA;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,YAAY,CAAC,aAAa,EAAE,wBAAwB,IAAI,EAAE,CAAC,CAAA;IACvE,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,YAAY,CACpB,eAAe,EACf,wBAAwB,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAC5E,CAAA;IACH,CAAC;IACD,OAAO,OAAO,CAAC,CAAC,CAAE,CAAA;AACpB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAmB;IAC7C,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,CAAC,IAAI,CACR,SAAS,MAAM,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,oBAAoB,MAAM,CAAC,IAAI,IAAI,CAC/G,CAAA;IACD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAC9B,MAAM,GAAG,GACP,CAAC,CAAC,UAAU,KAAK,IAAI;YACnB,CAAC,CAAC,QAAQ,CAAC,CAAC,KAAK,IAAI,GAAG,EAAE;YAC1B,CAAC,CAAC,CAAC,CAAC,UAAU,KAAK,OAAO;gBACxB,CAAC,CAAC,WAAW,CAAC,CAAC,UAAU,IAAI,GAAG,IAAI,CAAC,CAAC,aAAa,IAAI,GAAG,EAAE;gBAC5D,CAAC,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE,CAAA;QACpC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACd,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QAC7C,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,CAAA;QACtB,IAAI,CAAC,CAAC,YAAY,KAAK,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,YAAY,EAAE,CAAC,CAAA;QACrE,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAA;QAC7D,IAAI,CAAC,CAAC,WAAW,KAAK,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAA;IACnF,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}