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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Juan Reina
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# cli
+
+Node/TypeScript CLI engine. Subcommand router, JSON output by default, job-queue runner that drives the harness loops. Every interface (CLI, web, plugin) calls this — there is exactly one mutation path.
+
+See [ROADMAP.md § Tech stack](../ROADMAP.md#tech-stack) and [§ Interfaces](../ROADMAP.md#interfaces--cli--local-nextjs-web).

package/bin/compost.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { run } from '../dist/index.js'
+
+run().catch((err) => {
+  process.stderr.write(`compost: ${err?.message ?? String(err)}\n`)
+  process.exit(1)
+})

package/dist/commands/_stub.d.ts

@@ -0,0 +1,9 @@
+export interface StubInfo {
+    command: string;
+    issue?: number;
+}
+/** Prefix a command's description so `--help` clearly flags it as not built yet
+ * (instead of reading like a working command). */
+export declare function stubDescription(text: string, issue?: number): string;
+export declare function stubAction(info: StubInfo): (...rest: unknown[]) => never;
+//# sourceMappingURL=_stub.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_stub.d.ts","sourceRoot":"","sources":["../../src/commands/_stub.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;kDACkD;AAClD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,KAAK,CAqBxE"}

package/dist/commands/_stub.js

@@ -0,0 +1,27 @@
+import { emit, getOutputOpts } from '../output.js';
+/** Prefix a command's description so `--help` clearly flags it as not built yet
+ * (instead of reading like a working command). */
+export function stubDescription(text, issue) {
+    return `[not implemented yet${issue !== undefined ? ` · #${issue}` : ''}] ${text}`;
+}
+export function stubAction(info) {
+    return (...rest) => {
+        const cmd = rest[rest.length - 1];
+        const out = getOutputOpts(cmd);
+        const positional = rest.slice(0, Math.max(0, rest.length - 2));
+        if (out.human) {
+            const ref = info.issue !== undefined ? ` (tracked in #${info.issue})` : '';
+            process.stderr.write(`\`compost ${info.command}\` is not implemented yet${ref}.\n`);
+        }
+        else {
+            emit({
+                status: 'not_implemented',
+                command: info.command,
+                ...(info.issue !== undefined ? { issue: info.issue } : {}),
+                ...(positional.length > 0 ? { args: positional } : {}),
+            }, out);
+        }
+        process.exit(1);
+    };
+}
+//# sourceMappingURL=_stub.js.map

package/dist/commands/_stub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_stub.js","sourceRoot":"","sources":["../../src/commands/_stub.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAOlD;kDACkD;AAClD,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,KAAc;IAC1D,OAAO,uBAAuB,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE,CAAA;AACpF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAc;IACvC,OAAO,CAAC,GAAG,IAAe,EAAE,EAAE;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAY,CAAA;QAC5C,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;QAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAA;QAC9D,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;YACd,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,iBAAiB,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;YAC1E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,OAAO,4BAA4B,GAAG,KAAK,CAAC,CAAA;QACrF,CAAC;aAAM,CAAC;YACN,IAAI,CACF;gBACE,MAAM,EAAE,iBAAiB;gBACzB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1D,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvD,EACD,GAAG,CACJ,CAAA;QACH,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC,CAAA;AACH,CAAC"}

package/dist/commands/blame.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"blame.d.ts","sourceRoot":"","sources":["../../src/commands/blame.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAUxC,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8BpD"}

package/dist/commands/blame.js

@@ -0,0 +1,31 @@
+import { isCompostError } from '../errors.js';
+import { blame, renderHuman } from '../lib/blame.js';
+import { emit, emitError, getOutputOpts } from '../output.js';
+export function registerBlame(program) {
+    program
+        .command('blame')
+        .description('Print the lineage chain (three-actor events) for an artifact')
+        .argument('<artifact-ref>', 'Id from `compost create` (C-slug / H-NNN / T-slug), SHA256 prefix (min 8 chars), or `latest:<kind>=<seed>`')
+        .option('--seed <name>', 'Scope the lookup to a single seed (default: the only seed under ./Seeds)')
+        .action((artifactRef, flags, cmd) => {
+        const out = getOutputOpts(cmd);
+        try {
+            const opts = {};
+            if (flags.seed !== undefined)
+                opts.seed = flags.seed;
+            const result = blame(artifactRef, opts);
+            if (out.human) {
+                process.stdout.write(`${renderHuman(result)}\n`);
+                return;
+            }
+            emit(result, out);
+        }
+        catch (err) {
+            if (isCompostError(err)) {
+                emitError(err, out);
+            }
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=blame.js.map

package/dist/commands/blame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blame.js","sourceRoot":"","sources":["../../src/commands/blame.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAM7D,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,8DAA8D,CAAC;SAC3E,QAAQ,CACP,gBAAgB,EAChB,4GAA4G,CAC7G;SACA,MAAM,CACL,eAAe,EACf,0EAA0E,CAC3E;SACA,MAAM,CAAC,CAAC,WAAmB,EAAE,KAAiB,EAAE,GAAY,EAAE,EAAE;QAC/D,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;QAC9B,IAAI,CAAC;YACH,MAAM,IAAI,GAAsB,EAAE,CAAA;YAClC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;gBAAE,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;YACpD,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;YACvC,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;gBAChD,OAAM;YACR,CAAC;YACD,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxB,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;YACrB,CAAC;YACD,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/commands/chat.d.ts

@@ -0,0 +1,8 @@
+import type { Command } from 'commander';
+import type { Answer } from 'compost-retrieval';
+/** Parse a model's answer JSON, tolerating a ```json fence (some local models
+ * emit one despite the schema). Unparseable output → insufficient evidence
+ * rather than a crash — important now that chat defaults to a local model. */
+export declare function parseAnswer(text: string): Answer;
+export declare function registerChat(program: Command): void;
+//# sourceMappingURL=chat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/commands/chat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC,OAAO,KAAK,EAAE,MAAM,EAAS,MAAM,mBAAmB,CAAA;AAgBtD;;8EAE8E;AAC9E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA2BhD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+DnD"}

package/dist/commands/chat.js

@@ -0,0 +1,99 @@
+import { isCompostError } from '../errors.js';
+import { ANSWER_JSON_SCHEMA } from '../lib/answerSchema.js';
+import { chat } from '../lib/chat.js';
+import { loadConfig } from '../lib/config.js';
+import { resolveSeedPath } from '../lib/seedResolve.js';
+import { LLMAdapter } from '../llm/adapter.js';
+import { emit, emitError, getOutputOpts } from '../output.js';
+/** Parse a model's answer JSON, tolerating a ```json fence (some local models
+ * emit one despite the schema). Unparseable output → insufficient evidence
+ * rather than a crash — important now that chat defaults to a local model. */
+export function parseAnswer(text) {
+    const trimmed = text.trim();
+    // Local models vary: bare JSON, a ```json fence, or JSON wrapped in prose.
+    // Try each strategy; the last extracts the outermost {...} object.
+    const candidates = [
+        trimmed,
+        trimmed
+            .replace(/^```(?:json)?\s*/i, '')
+            .replace(/\s*```$/i, '')
+            .trim(),
+        trimmed.match(/\{[\s\S]*\}/)?.[0] ?? '',
+    ];
+    for (const c of candidates) {
+        if (!c)
+            continue;
+        try {
+            const v = JSON.parse(c);
+            // Require an object — a bare primitive (e.g. `null`, `42`) is not an Answer.
+            if (v !== null && typeof v === 'object' && !Array.isArray(v))
+                return v;
+        }
+        catch {
+            // try the next strategy
+        }
+    }
+    return {
+        answer: 'The model returned an answer that could not be parsed.',
+        claims: [],
+        insufficient_evidence: true,
+    };
+}
+export function registerChat(program) {
+    program
+        .command('chat')
+        .description('RAG-grounded chat with the seed — answers carry citations')
+        .argument('<question>', 'The question to ask the seed')
+        .option('--seed <name>', 'Seed (default: the only seed under ./Seeds)')
+        .option('--chat-id <id>', 'Conversation id for persistence', 'default')
+        .option('--task <name>', "LLM task to answer with — local by default; use 'synthesis' for cloud quality (needs an API key)", 'quick_chat')
+        .action(async (question, flags, cmd) => {
+        const out = getOutputOpts(cmd);
+        try {
+            const seedPath = resolveSeedPath(process.cwd(), flags.seed);
+            const seedName = seedPath.split('/').pop() ?? 'seed';
+            const config = loadConfig(seedPath);
+            const adapter = new LLMAdapter(config);
+            const answerFn = async (q, context) => {
+                const contextText = context
+                    .map((c) => `[${c.metadata.session}:${c.id}] ${c.text}`)
+                    .join('\n');
+                const messages = [
+                    {
+                        role: 'system',
+                        content: 'Answer ONLY from the provided context. Every claim must cite a real utterance_id with a verbatim quote. If the context is insufficient, set insufficient_evidence=true. Respond as JSON matching the answer schema.',
+                    },
+                    { role: 'user', content: `Context:\n${contextText}\n\nQuestion: ${q}` },
+                ];
+                // Local task by default (no API key); override with --task synthesis.
+                const resp = await adapter.chat(flags.task ?? 'quick_chat', messages, {
+                    schema: ANSWER_JSON_SCHEMA,
+                });
+                return parseAnswer(resp.text);
+            };
+            const result = await chat(seedPath, question, {
+                answerFn,
+                seed: seedName,
+                ...(flags.chatId !== undefined ? { chatId: flags.chatId } : {}),
+            });
+            if (out.human) {
+                process.stdout.write(`${result.answer || '(no answer — insufficient evidence)'}\n`);
+                for (const c of result.citations) {
+                    process.stdout.write(`  — ${c.utterance_id}: "${c.quote}" (${c.confidence})\n`);
+                }
+            }
+            else {
+                emit({ answer: result.answer, citations: result.citations, retrieved: result.retrieved }, out);
+            }
+            // Insufficient evidence is never returned silently.
+            if (result.insufficient_evidence)
+                process.exit(3);
+        }
+        catch (err) {
+            if (isCompostError(err))
+                emitError(err, out);
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=chat.js.map

package/dist/commands/chat.js.map

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

package/dist/commands/code.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../src/commands/code.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AA+BxC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8CnD"}

package/dist/commands/code.js

@@ -0,0 +1,70 @@
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { isCompostError } from '../errors.js';
+import { resolveSeedPath } from '../lib/seedResolve.js';
+import { suggestThemesOnce } from '../loops/synthesis.js';
+import { emit, emitError, getOutputOpts } from '../output.js';
+function loadEmbeddedHighlights(seedPath) {
+    const dir = join(seedPath, 'highlights');
+    if (!existsSync(dir))
+        return [];
+    const out = [];
+    for (const f of readdirSync(dir)) {
+        if (!f.endsWith('.json'))
+            continue;
+        try {
+            const j = JSON.parse(readFileSync(join(dir, f), 'utf8'));
+            if (typeof j.id === 'string' && Array.isArray(j.vector))
+                out.push({ id: j.id, vector: j.vector });
+        }
+        catch {
+            // skip malformed
+        }
+    }
+    return out;
+}
+export function registerCode(program) {
+    program
+        .command('code')
+        .description('Suggest (default) codes by clustering highlights; --apply emits them as drafts')
+        .option('--seed <name>', 'Seed (default: the only seed under ./Seeds)')
+        .option('--apply', 'Emit the suggested codes as AI [draft] events')
+        .option('--threshold <n>', 'Cosine clustering threshold', '0.75')
+        .action((flags, cmd) => {
+        const out = getOutputOpts(cmd);
+        try {
+            const seedPath = resolveSeedPath(process.cwd(), flags.seed);
+            const highlights = loadEmbeddedHighlights(seedPath);
+            // suggestThemesOnce emits the AI code drafts; with --apply we run it,
+            // otherwise we report what it *would* suggest (dry preview).
+            if (flags.apply === true) {
+                const suggestions = suggestThemesOnce(seedPath, highlights, {
+                    threshold: Number(flags.threshold ?? 0.75),
+                });
+                emit({
+                    status: 'ok',
+                    command: 'code',
+                    applied: true,
+                    suggested: suggestions.length,
+                    suggestions,
+                }, out);
+            }
+            else {
+                // dry preview: cluster without emitting (re-run with apply to persist)
+                emit({
+                    status: 'ok',
+                    command: 'code',
+                    applied: false,
+                    embedded_highlights: highlights.length,
+                    note: 'run with --apply to emit code drafts',
+                }, out);
+            }
+        }
+        catch (err) {
+            if (isCompostError(err))
+                emitError(err, out);
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=code.js.map

package/dist/commands/code.js.map

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

package/dist/commands/config.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAgCxC,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8DrD"}

package/dist/commands/config.js

@@ -0,0 +1,76 @@
+import { CompostError, isCompostError } from '../errors.js';
+import { getConfigValue, loadConfig, saveConfig, setConfigValue, } from '../lib/config.js';
+import { resolveSeedPath } from '../lib/seedResolve.js';
+import { emit, emitError, getOutputOpts } from '../output.js';
+const VALID_TYPES = ['string', 'bool', 'int', 'float', 'json'];
+function validateType(t) {
+    if (t === undefined)
+        return 'string';
+    if (VALID_TYPES.includes(t))
+        return t;
+    throw new CompostError('INVALID_INPUT', `--type must be one of ${VALID_TYPES.join('|')}; got "${t}"`);
+}
+export function registerConfig(program) {
+    const cfg = program.command('config').description('Read or write values in .compost/config.toml');
+    cfg
+        .command('get')
+        .description('Read a dotted key from config.toml')
+        .argument('<key>')
+        .option('--seed <name>', 'Target seed (defaults to the only seed under ./Seeds)')
+        .action((key, flags, cmd) => {
+        const out = getOutputOpts(cmd);
+        try {
+            const seedPath = resolveSeedPath(process.cwd(), flags.seed);
+            const config = loadConfig(seedPath);
+            const value = getConfigValue(config.raw, key);
+            emit({ status: 'ok', command: 'config get', key, value: value ?? null }, out);
+        }
+        catch (err) {
+            if (isCompostError(err))
+                emitError(err, out);
+            throw err;
+        }
+    });
+    cfg
+        .command('set')
+        .description('Write a dotted key into config.toml (default type: string)')
+        .argument('<key>')
+        .argument('<value>')
+        .option('--seed <name>', 'Target seed (defaults to the only seed under ./Seeds)')
+        .option('--type <type>', 'Value type: string (default) | bool | int | float | json. Strings need no flag; agents writing non-string values should pass --type explicitly.')
+        .action((key, value, flags, cmd) => {
+        const out = getOutputOpts(cmd);
+        try {
+            const type = validateType(flags.type);
+            const seedPath = resolveSeedPath(process.cwd(), flags.seed);
+            const config = loadConfig(seedPath);
+            setConfigValue(config.raw, key, value, type);
+            saveConfig(seedPath, config.raw);
+            const written = getConfigValue(config.raw, key);
+            emit({ status: 'ok', command: 'config set', key, type, value: written }, out);
+        }
+        catch (err) {
+            if (isCompostError(err))
+                emitError(err, out);
+            throw err;
+        }
+    });
+    cfg
+        .command('show')
+        .description('Pretty-print the entire config.toml')
+        .option('--seed <name>', 'Target seed (defaults to the only seed under ./Seeds)')
+        .action((flags, cmd) => {
+        const out = getOutputOpts(cmd);
+        try {
+            const seedPath = resolveSeedPath(process.cwd(), flags.seed);
+            const config = loadConfig(seedPath);
+            emit({ status: 'ok', command: 'config show', config: config.raw }, out);
+        }
+        catch (err) {
+            if (isCompostError(err))
+                emitError(err, out);
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,EAEL,cAAc,EACd,UAAU,EACV,UAAU,EACV,cAAc,GACf,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAU7D,MAAM,WAAW,GAA+B,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;AAE1F,SAAS,YAAY,CAAC,CAAqB;IACzC,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAA;IACpC,IAAK,WAAiC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,CAAoB,CAAA;IAC/E,MAAM,IAAI,YAAY,CACpB,eAAe,EACf,yBAAyB,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAC7D,CAAA;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,8CAA8C,CAAC,CAAA;IAEjG,GAAG;SACA,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,oCAAoC,CAAC;SACjD,QAAQ,CAAC,OAAO,CAAC;SACjB,MAAM,CAAC,eAAe,EAAE,uDAAuD,CAAC;SAChF,MAAM,CAAC,CAAC,GAAW,EAAE,KAAkB,EAAE,GAAY,EAAE,EAAE;QACxD,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;QAC9B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;YAC3D,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;YACnC,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;YAC7C,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,IAAI,IAAI,EAAE,EAAE,GAAG,CAAC,CAAA;QAC/E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,cAAc,CAAC,GAAG,CAAC;gBAAE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;YAC5C,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC,CAAC,CAAA;IAEJ,GAAG;SACA,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,4DAA4D,CAAC;SACzE,QAAQ,CAAC,OAAO,CAAC;SACjB,QAAQ,CAAC,SAAS,CAAC;SACnB,MAAM,CAAC,eAAe,EAAE,uDAAuD,CAAC;SAChF,MAAM,CACL,eAAe,EACf,iJAAiJ,CAClJ;SACA,MAAM,CAAC,CAAC,GAAW,EAAE,KAAa,EAAE,KAAqB,EAAE,GAAY,EAAE,EAAE;QAC1E,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;QAC9B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YACrC,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;YAC3D,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;YACnC,cAAc,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA;YAC5C,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;YAChC,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;YAC/C,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,GAAG,CAAC,CAAA;QAC/E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,cAAc,CAAC,GAAG,CAAC;gBAAE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;YAC5C,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC,CAAC,CAAA;IAEJ,GAAG;SACA,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,qCAAqC,CAAC;SAClD,MAAM,CAAC,eAAe,EAAE,uDAAuD,CAAC;SAChF,MAAM,CAAC,CAAC,KAAkB,EAAE,GAAY,EAAE,EAAE;QAC3C,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;QAC9B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;YAC3D,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;YACnC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAA;QACzE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,cAAc,CAAC,GAAG,CAAC;gBAAE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;YAC5C,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/commands/create.d.ts

@@ -0,0 +1,20 @@
+import type { Command } from 'commander';
+import type { Author } from '../lib/events.js';
+interface CommonFlags {
+    seed?: string;
+    ai?: boolean;
+    actorId?: string;
+    model?: string;
+    promptHash?: string;
+}
+/**
+ * Resolve the author from flags. Direct CLI use = researcher (a human ran it).
+ * The MCP wrapper passes `--ai --actor-id claude-code:<ver>:<sha>` so the
+ * artifact lands as an un-endorsed AI [draft]. Exported for tests — it is the
+ * fail-fast gate that keeps a missing --model/--prompt-hash from orphaning a
+ * .md (#165).
+ */
+export declare function resolveAuthor(flags: CommonFlags): Author;
+export declare function registerCreate(program: Command): void;
+export {};
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AASxC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAI9C,UAAU,WAAW;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,EAAE,CAAC,EAAE,OAAO,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CA8BxD;AAgDD,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+ErD"}

package/dist/commands/create.js

@@ -0,0 +1,148 @@
+import { CompostError, isCompostError } from '../errors.js';
+import { createCode, createHighlight, createTheme, defaultResearcherId, } from '../lib/artifacts.js';
+import { resolveSeedPath } from '../lib/seedResolve.js';
+import { emit, emitError, getOutputOpts } from '../output.js';
+/**
+ * Resolve the author from flags. Direct CLI use = researcher (a human ran it).
+ * The MCP wrapper passes `--ai --actor-id claude-code:<ver>:<sha>` so the
+ * artifact lands as an un-endorsed AI [draft]. Exported for tests — it is the
+ * fail-fast gate that keeps a missing --model/--prompt-hash from orphaning a
+ * .md (#165).
+ */
+export function resolveAuthor(flags) {
+    if (flags.ai === true) {
+        // AI-authored events MUST record actor_id, model, and a prompt_hash (the
+        // events schema requires model + prompt_hash for actor_type=ai). Validate
+        // up front and name the missing flag — the create funcs write the markdown,
+        // so a late schema failure would orphan a .md with no event (#165).
+        const missing = [];
+        if (flags.actorId === undefined)
+            missing.push('--actor-id');
+        if (flags.model === undefined)
+            missing.push('--model');
+        if (flags.promptHash === undefined)
+            missing.push('--prompt-hash');
+        if (missing.length > 0) {
+            throw new CompostError('INVALID_INPUT', `--ai requires ${missing.join(', ')} (AI-authored artifacts record the actor, model, and prompt hash for provenance; e.g. --actor-id claude-code:0.1.0:abc12345)`);
+        }
+        if (!/^[a-f0-9]{64}$/.test(flags.promptHash)) {
+            throw new CompostError('INVALID_INPUT', `--prompt-hash must be a 64-char sha256 hex (sha256 of prompt+model+temp+ctx); got ${JSON.stringify(flags.promptHash)}`);
+        }
+        return {
+            actorType: 'ai',
+            actorId: flags.actorId,
+            model: flags.model,
+            promptHash: flags.promptHash,
+        };
+    }
+    return { actorType: 'researcher', actorId: flags.actorId ?? defaultResearcherId() };
+}
+function emitCreated(kind, created, cmd) {
+    const out = getOutputOpts(cmd);
+    emit({
+        status: 'ok',
+        command: `create ${kind}`,
+        id: created.id,
+        artifact_id: created.artifact_id,
+        path: created.path,
+        event_id: created.event_id,
+    }, out);
+}
+function addAuthorFlags(c) {
+    return c
+        .option('--seed <name>', 'Seed (default: the only seed under ./Seeds)')
+        .option('--ai', 'Mark the artifact as AI-authored (lands as [draft] until endorsed)')
+        .option('--actor-id <id>', 'Actor id (required with --ai; e.g. claude-code:0.1.0:abc12345)')
+        .option('--model <model>', 'Model that produced the suggestion (required with --ai)')
+        .option('--prompt-hash <sha>', 'sha256(prompt+model+temp+ctx), 64-char hex (required with --ai)');
+}
+export function registerCreate(program) {
+    const create = program
+        .command('create')
+        .description('Create a highlight, code, or theme (writes markdown + emits a provenance event)');
+    addAuthorFlags(create
+        .command('highlight')
+        .description('Create a highlight anchored to an utterance span')
+        .requiredOption('--session <id>', 'Session id (e.g. S001)')
+        .requiredOption('--utterance <id>', 'Utterance id (e.g. U-0002)')
+        .requiredOption('--span <start,end>', 'Char span into the utterance text, e.g. 0,16')
+        .requiredOption('--text <quote>', 'The highlighted verbatim text')).action((flags, cmd) => {
+        try {
+            const seedPath = resolveSeedPath(process.cwd(), flags.seed);
+            const span = parseSpan(flags.span);
+            const created = createHighlight(seedPath, {
+                sessionId: flags.session,
+                utteranceId: flags.utterance,
+                span,
+                text: flags.text,
+                author: resolveAuthor(flags),
+            });
+            emitCreated('highlight', created, cmd);
+        }
+        catch (err) {
+            if (isCompostError(err))
+                emitError(err, getOutputOpts(cmd));
+            throw err;
+        }
+    });
+    addAuthorFlags(create
+        .command('code')
+        .description('Create a code with a definition and optional evidence highlights')
+        .requiredOption('--name <name>', 'Code name (slugified for the id, e.g. distrust-of-automation)')
+        .requiredOption('--definition <text>', 'What this code captures')
+        .option('--evidence <ids>', 'Comma-separated highlight ids (e.g. H-001,H-002)')).action((flags, cmd) => {
+        try {
+            const seedPath = resolveSeedPath(process.cwd(), flags.seed);
+            const created = createCode(seedPath, {
+                name: flags.name,
+                definition: flags.definition,
+                evidence: parseList(flags.evidence),
+                author: resolveAuthor(flags),
+            });
+            emitCreated('code', created, cmd);
+        }
+        catch (err) {
+            if (isCompostError(err))
+                emitError(err, getOutputOpts(cmd));
+            throw err;
+        }
+    });
+    addAuthorFlags(create
+        .command('theme')
+        .description('Create a theme grouping codes under a summary')
+        .requiredOption('--name <name>', 'Theme name (slugified for the id)')
+        .requiredOption('--summary <text>', 'The theme statement')
+        .option('--codes <ids>', 'Comma-separated code ids (e.g. C-distrust,C-override)')).action((flags, cmd) => {
+        try {
+            const seedPath = resolveSeedPath(process.cwd(), flags.seed);
+            const created = createTheme(seedPath, {
+                name: flags.name,
+                summary: flags.summary,
+                codes: parseList(flags.codes),
+                author: resolveAuthor(flags),
+            });
+            emitCreated('theme', created, cmd);
+        }
+        catch (err) {
+            if (isCompostError(err))
+                emitError(err, getOutputOpts(cmd));
+            throw err;
+        }
+    });
+}
+function parseSpan(s) {
+    const parts = s.split(',').map((p) => Number.parseInt(p.trim(), 10));
+    if (parts.length !== 2 || parts.some((n) => !Number.isInteger(n) || n < 0)) {
+        throw new CompostError('INVALID_INPUT', `--span must be "start,end" non-negative ints; got ${JSON.stringify(s)}`);
+    }
+    return [parts[0], parts[1]];
+}
+function parseList(s) {
+    if (s === undefined || s.trim() === '')
+        return [];
+    return s
+        .split(',')
+        .map((x) => x.trim())
+        .filter((x) => x.length > 0);
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,EAEL,UAAU,EACV,eAAe,EACf,WAAW,EACX,mBAAmB,GACpB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAU7D;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,KAAkB;IAC9C,IAAI,KAAK,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;QACtB,yEAAyE;QACzE,0EAA0E;QAC1E,4EAA4E;QAC5E,oEAAoE;QACpE,MAAM,OAAO,GAAa,EAAE,CAAA;QAC5B,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QAC3D,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACtD,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;QACjE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,YAAY,CACpB,eAAe,EACf,iBAAiB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,8HAA8H,CAClK,CAAA;QACH,CAAC;QACD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,UAAoB,CAAC,EAAE,CAAC;YACvD,MAAM,IAAI,YAAY,CACpB,eAAe,EACf,qFAAqF,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CACxH,CAAA;QACH,CAAC;QACD,OAAO;YACL,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,KAAK,CAAC,OAAiB;YAChC,KAAK,EAAE,KAAK,CAAC,KAAe;YAC5B,UAAU,EAAE,KAAK,CAAC,UAAoB;SACvC,CAAA;IACH,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,mBAAmB,EAAE,EAAE,CAAA;AACrF,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,OAAwB,EAAE,GAAY;IACvE,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;IAC9B,IAAI,CACF;QACE,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,UAAU,IAAI,EAAE;QACzB,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,EACD,GAAG,CACJ,CAAA;AACH,CAAC;AAqBD,SAAS,cAAc,CAAC,CAAU;IAChC,OAAO,CAAC;SACL,MAAM,CAAC,eAAe,EAAE,6CAA6C,CAAC;SACtE,MAAM,CAAC,MAAM,EAAE,oEAAoE,CAAC;SACpF,MAAM,CAAC,iBAAiB,EAAE,gEAAgE,CAAC;SAC3F,MAAM,CAAC,iBAAiB,EAAE,yDAAyD,CAAC;SACpF,MAAM,CACL,qBAAqB,EACrB,iEAAiE,CAClE,CAAA;AACL,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,MAAM,MAAM,GAAG,OAAO;SACnB,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,iFAAiF,CAAC,CAAA;IAEjG,cAAc,CACZ,MAAM;SACH,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,kDAAkD,CAAC;SAC/D,cAAc,CAAC,gBAAgB,EAAE,wBAAwB,CAAC;SAC1D,cAAc,CAAC,kBAAkB,EAAE,4BAA4B,CAAC;SAChE,cAAc,CAAC,oBAAoB,EAAE,8CAA8C,CAAC;SACpF,cAAc,CAAC,gBAAgB,EAAE,+BAA+B,CAAC,CACrE,CAAC,MAAM,CAAC,CAAC,KAAqB,EAAE,GAAY,EAAE,EAAE;QAC/C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;YAC3D,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAClC,MAAM,OAAO,GAAG,eAAe,CAAC,QAAQ,EAAE;gBACxC,SAAS,EAAE,KAAK,CAAC,OAAO;gBACxB,WAAW,EAAE,KAAK,CAAC,SAAS;gBAC5B,IAAI;gBACJ,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC;aAC7B,CAAC,CAAA;YACF,WAAW,CAAC,WAAW,EAAE,OAAO,EAAE,GAAG,CAAC,CAAA;QACxC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,cAAc,CAAC,GAAG,CAAC;gBAAE,SAAS,CAAC,GAAG,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAA;YAC3D,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,cAAc,CACZ,MAAM;SACH,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,kEAAkE,CAAC;SAC/E,cAAc,CACb,eAAe,EACf,+DAA+D,CAChE;SACA,cAAc,CAAC,qBAAqB,EAAE,yBAAyB,CAAC;SAChE,MAAM,CAAC,kBAAkB,EAAE,kDAAkD,CAAC,CAClF,CAAC,MAAM,CAAC,CAAC,KAAgB,EAAE,GAAY,EAAE,EAAE;QAC1C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;YAC3D,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,EAAE;gBACnC,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,QAAQ,EAAE,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC;gBACnC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC;aAC7B,CAAC,CAAA;YACF,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAA;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,cAAc,CAAC,GAAG,CAAC;gBAAE,SAAS,CAAC,GAAG,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAA;YAC3D,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,cAAc,CACZ,MAAM;SACH,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,+CAA+C,CAAC;SAC5D,cAAc,CAAC,eAAe,EAAE,mCAAmC,CAAC;SACpE,cAAc,CAAC,kBAAkB,EAAE,qBAAqB,CAAC;SACzD,MAAM,CAAC,eAAe,EAAE,uDAAuD,CAAC,CACpF,CAAC,MAAM,CAAC,CAAC,KAAiB,EAAE,GAAY,EAAE,EAAE;QAC3C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;YAC3D,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,EAAE;gBACpC,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC;gBAC7B,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC;aAC7B,CAAC,CAAA;YACF,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAA;QACpC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,cAAc,CAAC,GAAG,CAAC;gBAAE,SAAS,CAAC,GAAG,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAA;YAC3D,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,CAAS;IAC1B,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;IACpE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,YAAY,CACpB,eAAe,EACf,qDAAqD,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CACzE,CAAA;IACH,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,CAAC,CAAW,EAAE,KAAK,CAAC,CAAC,CAAW,CAAC,CAAA;AACjD,CAAC;AAED,SAAS,SAAS,CAAC,CAAqB;IACtC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,CAAA;IACjD,OAAO,CAAC;SACL,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;AAChC,CAAC"}

package/dist/commands/endorse.d.ts

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

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

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