@calliopelabs/cli 3.0.0 → 3.2.0

package/dist/brain/queries.js

@@ -0,0 +1,210 @@
+import { authorizeSessionAction } from '../session-management/index.js';
+import { throwIfCancelled } from '../cancellation.js';
+import { brainStore, BrainAccess } from './access.js';
+import { BrainError, BRAIN_LIMITS, ENTITY_KINDS, } from './types.js';
+export async function queryBrain(cwd, action, input = {}, options = {}) {
+    const store = brainStore(cwd, options);
+    await authorizeSessionAction(cwd, 'read_file', { path: store.project.root, operation: 'brain-' + action, scope: store.scope }, options);
+    const view = store.read(options.signal), access = new BrainAccess(cwd, view.state.sources, options), limit = input.limit ?? 20;
+    if (!Number.isSafeInteger(limit) || limit < 1 || limit > BRAIN_LIMITS.results)
+        throw new BrainError('invalid', 'Result limit must be 1–100.');
+    if (input.kind !== undefined && !ENTITY_KINDS.includes(input.kind))
+        throw new BrainError('invalid', 'Unknown knowledge kind.');
+    if (action === 'status')
+        return {
+            version: 1,
+            scope: store.scope,
+            brainId: view.state.header.id,
+            revision: view.state.revision,
+            events: view.journal.events.length,
+            entities: Object.keys(view.state.entities).length,
+            edges: Object.keys(view.state.edges).length,
+            sources: Object.keys(view.state.sources).length,
+            limits: BRAIN_LIMITS,
+        };
+    if (action === 'history') {
+        // History may contain now-restricted prior records, so require access to all retained evidence.
+        await access.all();
+        return {
+            revision: view.state.revision,
+            events: view.journal.events.slice(-limit).map((e) => ({
+                id: e.id,
+                at: e.at,
+                actor: e.actor,
+                reason: e.reason,
+                hash: e.hash,
+                reverses: e.reverses,
+                changes: e.changes.map((c) => ({
+                    kind: c.kind,
+                    id: c.kind === 'source' ? c.value.id : c.id,
+                })),
+            })),
+        };
+    }
+    const index = await store.index(options.signal);
+    try {
+        if (index.state.revision !== view.state.revision)
+            throw new BrainError('conflict', 'Brain changed during query; retry.');
+        const visible = new Map();
+        const entity = async (id) => {
+            if (!visible.has(id)) {
+                const record = view.state.entities[id];
+                visible.set(id, record && (input.includeRejected || record.state !== 'rejected')
+                    ? await access.visible(record)
+                    : null);
+            }
+            return visible.get(id);
+        };
+        if (action === 'entity') {
+            const record = index.entity(input.query ?? ''), result = await access.record(record);
+            return {
+                entity: result,
+                sources: [...new Set(record.provenance.map((p) => p.sourceId))].map((id) => view.state.sources[id]),
+                index: index.cache,
+                revision: view.state.revision,
+            };
+        }
+        if (action === 'search' || action === 'decisions' || action === 'risks') {
+            const kind = action === 'decisions' ? 'decision' : action === 'risks' ? 'risk' : input.kind;
+            const candidates = action === 'search'
+                ? index.search(input.query ?? '', {
+                    kind,
+                    limit: BRAIN_LIMITS.results,
+                    includeRejected: input.includeRejected,
+                    signal: options.signal,
+                })
+                : Object.values(view.state.entities)
+                    .filter((e) => e.kind === kind && (input.includeRejected || e.state !== 'rejected'))
+                    .sort((a, b) => (a.id < b.id ? -1 : 1));
+            const entities = [];
+            for (const candidate of candidates) {
+                throwIfCancelled(options.signal);
+                const record = await entity(candidate.id);
+                if (record)
+                    entities.push(record);
+                if (entities.length === limit)
+                    break;
+            }
+            return {
+                entities,
+                limit,
+                partial: candidates.length >= limit,
+                index: index.cache,
+                revision: view.state.revision,
+            };
+        }
+        const root = input.from ? index.entity(input.from) : undefined;
+        if (action !== 'graph' && !root)
+            throw new BrainError('invalid', 'Select a starting knowledge entity.');
+        if (root && !(await entity(root.id)))
+            throw new BrainError('policy-denied', 'Starting entity is unavailable under current source policy.');
+        if (action === 'neighbors') {
+            const edges = [];
+            const entities = new Map();
+            for (const e of index.neighbors(root.id, !!input.includeRejected)) {
+                throwIfCancelled(options.signal);
+                const relation = await access.visible(e), other = await entity(e.from === root.id ? e.to : e.from);
+                if (relation && other) {
+                    edges.push(relation);
+                    entities.set(other.id, other);
+                }
+                if (edges.length === limit)
+                    break;
+            }
+            return {
+                entity: await entity(root.id),
+                entities: [...entities.values()],
+                edges,
+                limit,
+                revision: view.state.revision,
+            };
+        }
+        if (action === 'path') {
+            const target = index.entity(input.to ?? ''), depth = input.depth ?? BRAIN_LIMITS.depth;
+            if (!Number.isSafeInteger(depth) ||
+                depth < 0 ||
+                depth > BRAIN_LIMITS.depth ||
+                (input.direction !== undefined && !['out', 'both'].includes(input.direction)))
+                throw new BrainError('invalid', 'Path depth must be 0–16 and direction out or both.');
+            if (!(await entity(target.id)))
+                throw new BrainError('policy-denied', 'Target entity is unavailable under current source policy.');
+            const queue = [{ id: root.id, path: [root.id], edges: [] }], seen = new Set([root.id]);
+            let cursor = 0;
+            while (cursor < queue.length) {
+                throwIfCancelled(options.signal);
+                const next = queue[cursor++];
+                if (next.id === target.id)
+                    return {
+                        found: true,
+                        entities: await Promise.all(next.path.map(entity)),
+                        edges: next.edges,
+                        visited: seen.size,
+                        depth,
+                        revision: view.state.revision,
+                    };
+                if (next.edges.length === depth)
+                    continue;
+                for (const e of index.neighbors(next.id, !!input.includeRejected)) {
+                    if (input.direction === 'out' && e.from !== next.id)
+                        continue;
+                    const id = e.from === next.id ? e.to : e.from;
+                    if (seen.has(id) || !(await entity(id)))
+                        continue;
+                    const relation = await access.visible(e);
+                    if (!relation)
+                        continue;
+                    seen.add(id);
+                    queue.push({ id, path: [...next.path, id], edges: [...next.edges, relation] });
+                    if (seen.size > BRAIN_LIMITS.entities)
+                        throw new BrainError('limit', 'Graph traversal exceeded its entity bound.');
+                }
+            }
+            return {
+                found: false,
+                entities: [],
+                edges: [],
+                visited: seen.size,
+                depth,
+                revision: view.state.revision,
+            };
+        }
+        // A bounded, deterministic neighborhood (or overview) suitable for a terminal graph/HUD.
+        const ids = root
+            ? [
+                root.id,
+                ...index.neighbors(root.id, !!input.includeRejected).flatMap((e) => [e.from, e.to]),
+            ]
+            : Object.keys(view.state.entities).sort(), entities = [];
+        for (const id of new Set(ids)) {
+            const record = await entity(id);
+            if (record)
+                entities.push(record);
+            if (entities.length === limit)
+                break;
+        }
+        const included = new Set(entities.map((e) => e.id)), edges = [];
+        for (const e of Object.values(view.state.edges)) {
+            throwIfCancelled(options.signal);
+            if (included.has(e.from) &&
+                included.has(e.to) &&
+                (input.includeRejected || e.state !== 'rejected')) {
+                const record = await access.visible(e);
+                if (record)
+                    edges.push(record);
+            }
+            if (edges.length === BRAIN_LIMITS.results)
+                break;
+        }
+        return {
+            entities,
+            edges,
+            limit,
+            partial: ids.length > entities.length || edges.length === BRAIN_LIMITS.results,
+            revision: view.state.revision,
+        };
+    }
+    finally {
+        index.close();
+    }
+}
+//# sourceMappingURL=queries.js.map

package/dist/brain/queries.js.map

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

package/dist/brain/run-ingest.d.ts

@@ -0,0 +1,29 @@
+import type { RunStore } from '../orchestration/store.js';
+import { type BrainOptions } from './access.js';
+export interface BrainRunOptions extends BrainOptions {
+    runs?: RunStore;
+}
+/** Ingest verified metadata and executor checks. Worker prose never establishes a passed test. */
+export declare function ingestBrainRun(cwd: string, runId: string, options?: BrainRunOptions): Promise<{
+    journal: import("./types.js").BrainJournal;
+    state: import("./types.js").BrainState;
+    index: 'unchanged';
+    runId: string;
+    entityId: string;
+    imported: number;
+} | {
+    journal: import("./types.js").BrainJournal;
+    state: import("./types.js").BrainState;
+    index: 'current';
+    runId: string;
+    entityId: string;
+    imported: number;
+} | {
+    journal: import("./types.js").BrainJournal;
+    state: import("./types.js").BrainState;
+    index: 'rebuild-required';
+    runId: string;
+    entityId: string;
+    imported: number;
+}>;
+//# sourceMappingURL=run-ingest.d.ts.map

package/dist/brain/run-ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-ingest.d.ts","sourceRoot":"","sources":["../../src/brain/run-ingest.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAG1D,OAAO,EAAiC,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAW/E,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AACD,kGAAkG;AAClG,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB;;;WA6PhE,WAAW;;;;;;;;;;;;;;;;;;GAuBxC"}

package/dist/brain/run-ingest.js

@@ -0,0 +1,200 @@
+import { canonicalJson, digest } from '../approvals/index.js';
+import { authorizeSessionAction } from '../session-management/index.js';
+import { throwIfCancelled } from '../cancellation.js';
+import { inspectExecution } from '../orchestration/coordinator-actions.js';
+import { readCollectedArtifact, checkArtifactSnapshot } from '../orchestration/verification.js';
+import { projectImprovementHistory } from '../improvement/projection.js';
+import { readRunAccounting } from '../orchestration/accounting.js';
+import { brainStore, sanitizeBrainText } from './access.js';
+import { commitBrain } from './actions.js';
+import { recordInput } from './journal.js';
+import { BrainError, BRAIN_LIMITS, } from './types.js';
+/** Ingest verified metadata and executor checks. Worker prose never establishes a passed test. */
+export async function ingestBrainRun(cwd, runId, options = {}) {
+    await authorizeSessionAction(cwd, 'read_file', { path: cwd, operation: 'brain-ingest-run', runId }, options);
+    const current = await inspectExecution(cwd, runId, { ...options, store: options.runs });
+    if (!current.execution?.events.length)
+        throw new BrainError('unavailable', 'Run has no execution events to cite.');
+    if (current.owner?.alive)
+        throw new BrainError('conflict', 'Stop the active coordinator before ingesting a stable run snapshot.');
+    const execution = current.execution, context = current.store.context(execution), prior = brainStore(cwd, options).read(options.signal), changes = [], entities = new Map(), edges = [], sources = new Map();
+    const accounting = readRunAccounting(current.store, execution);
+    const improvement = projectImprovementHistory(current.view.manifest, execution, context, accounting.status === 'available' ? accounting.attribution : undefined);
+    const snapshot = improvement.accounting ? digest(canonicalJson({ execution: execution.state.revision, accounting: improvement.accounting })) : execution.state.revision;
+    // Task resets remove prior artifacts from the active projection, not from history.
+    const artifacts = execution.events.flatMap(({ change }) => change.type === 'artifact' ? [change.artifact] : []);
+    let total = 0;
+    const key = (kind, id) => 'run:' + digest(runId + ':' + snapshot + ':' + kind + ':' + id), event = execution.events.at(-1), root = key('run', runId);
+    const evidence = (id, data, eventId = event.id, path) => {
+        const original = canonicalJson(data), content = sanitizeBrainText(original), sourceId = key('source', id);
+        if (Buffer.byteLength(content) > BRAIN_LIMITS.contentBytes)
+            throw new BrainError('limit', 'Run metadata exceeds one knowledge source.');
+        sources.set(sourceId, {
+            id: sourceId,
+            kind: 'run',
+            name: sanitizeBrainText('Run evidence ' + id),
+            content,
+            originalHash: digest(original),
+            contentHash: digest(content),
+            redacted: original !== content,
+            locator: {
+                runId,
+                eventId,
+                projectKey: current.view.manifest.project.key,
+                ...(path ? { path } : {}),
+            },
+        });
+        return [{ sourceId, basis: 'observed' }];
+    };
+    const add = (id, kind, name, summary, provenance, attributes = {}, proposed = false) => {
+        entities.set(id, {
+            id,
+            kind,
+            name: sanitizeBrainText(name),
+            summary: sanitizeBrainText(summary),
+            provenance,
+            attributes,
+            state: proposed ? 'proposed' : 'accepted',
+            confidence: proposed ? 0.5 : 1,
+        });
+    };
+    const link = (from, to, type, p) => edges.push({
+        id: key('edge', from + ':' + type + ':' + to),
+        from,
+        to,
+        type,
+        state: p.some((p) => p.basis === 'inferred') ? 'proposed' : 'accepted',
+        confidence: 1,
+        provenance: p,
+    });
+    const runEvidence = evidence('run', {
+        runId,
+        manifestHash: current.view.manifest.hash,
+        executionRevision: execution.state.revision,
+        status: execution.state.status,
+        ...(improvement.accounting ? { accounting: improvement.accounting } : {}),
+    });
+    add(root, 'run', runId + '@' + snapshot.slice(0, 12), 'Recorded execution snapshot; status is an executor observation.', runEvidence, { status: execution.state.status, runId, revision: execution.state.revision });
+    for (const agent of context.plan.agents) {
+        throwIfCancelled(options.signal);
+        const id = key('agent', agent.id), p = evidence('agent:' + agent.id, {
+            id: agent.id,
+            role: agent.role,
+            parentId: agent.parentId,
+            preference: agent.preference,
+        });
+        add(id, 'agent', agent.id, agent.role, p, { runId, agentId: agent.id });
+        link(root, id, 'includes_agent', p);
+        if (agent.parentId)
+            link(id, key('agent', agent.parentId), 'reports_to', p);
+    }
+    for (const task of context.plan.tasks) {
+        const id = key('task', task.id), p = evidence('task:' + task.id, {
+            id: task.id,
+            agentId: task.agentId,
+            dependencies: task.dependencies,
+            status: execution.state.tasks[task.id].status,
+        });
+        add(id, 'task', task.id, 'Recorded task assignment and executor status.', p, {
+            runId,
+            taskId: task.id,
+            status: execution.state.tasks[task.id].status,
+        });
+        link(root, id, 'includes_task', p);
+        link(id, key('agent', task.agentId), 'assigned_to', p);
+        for (const dependency of task.dependencies)
+            link(id, key('task', dependency), 'depends_on', p);
+    }
+    for (const artifact of artifacts) {
+        throwIfCancelled(options.signal);
+        total += artifact.bytes;
+        if (total > 64 * 1024 * 1024)
+            throw new BrainError('limit', 'Run evidence exceeds the 64 MiB ingestion bound.');
+        await readCollectedArtifact(current.store, artifact, { ...options, store: options.runs });
+        const path = context.plan.tasks
+            .find((t) => t.id === artifact.taskId)
+            .outputs.find((o) => o.id === artifact.id).path, id = key('artifact', artifact.source.eventId), p = evidence('artifact:' + artifact.source.eventId, artifact, artifact.source.eventId, path);
+        add(id, 'artifact', artifact.id, 'Artifact hash and size verified against retained bytes; its prose is not a test result.', p, { runId, sha256: artifact.sha256, bytes: artifact.bytes });
+        link(key('task', artifact.taskId), id, 'produced', p);
+    }
+    for (const entry of execution.events)
+        if (entry.change.type === 'task_finished') {
+            const c = entry.change;
+            for (const check of c.output.checks) {
+                const artifact = c.output.artifacts.find((a) => a.id === check.artifactId);
+                const path = context.plan.tasks
+                    .find((t) => t.id === c.taskId)
+                    .outputs.find((o) => o.id === check.artifactId)?.path, p = evidence('check:' + entry.id + ':' + check.id, { taskId: c.taskId, check, eventHash: entry.hash }, entry.id, path), id = key('check', entry.id + ':' + check.id);
+                add(id, 'test_evidence', c.taskId + ':' + check.id, `Recorded ${check.kind} check ${check.passed ? 'passed' : 'failed'}.`, p, {
+                    runId,
+                    passed: check.passed,
+                    checkKind: check.kind,
+                    observedHash: check.observedHash,
+                    eventId: entry.id,
+                });
+                link(key('task', c.taskId), id, 'checked_by', p);
+                if (artifact)
+                    link(id, key('artifact', artifact.source.eventId), 'checks', p);
+            }
+        }
+    // Reuse the supervisor's evidence projection, which excludes unreviewed controller drafts.
+    for (const cycle of improvement.cycles) {
+        const id = key('decision', cycle.id), p = evidence('decision:' + cycle.id, {
+            decision: cycle.proposedChange,
+            status: cycle.status,
+            metrics: cycle.metrics,
+            source: cycle.source,
+            ...(improvement.accounting ? { accounting: improvement.accounting } : {}),
+        }, cycle.id).map((p) => ({ ...p, basis: 'inferred' }));
+        add(id, 'decision', 'Improvement ' + cycle.id, cycle.hypothesis.text, p, { runId, cycleId: cycle.id, observedCycleStatus: cycle.status }, true);
+        link(root, id, 'proposes', p);
+        for (const taskId of cycle.targetTaskIds) {
+            const taskKey = key('task', taskId);
+            if (!entities.has(taskKey))
+                add(taskKey, 'task', taskId, 'Proposed child task; it has not been admitted to execution.', p, { runId, taskId, admitted: false }, true);
+            link(id, taskKey, 'targets', p);
+        }
+        if (cycle.parentCycleId)
+            link(id, key('decision', cycle.parentCycleId), 'refines', p);
+    }
+    for (const value of sources.values()) {
+        const old = prior.state.sources[value.id];
+        if (old && canonicalJson(recordInput(old)) !== canonicalJson(value))
+            throw new BrainError('conflict', 'Run source conflicts with retained evidence.');
+        if (!old)
+            changes.push({ kind: 'source', value });
+    }
+    for (const [kind, values] of [
+        ['entity', [...entities.values()]],
+        ['edge', edges],
+    ])
+        for (const value of values) {
+            const old = kind === 'entity' ? prior.state.entities[value.id] : prior.state.edges[value.id];
+            if (old) {
+                if (canonicalJson(recordInput(old)) !== canonicalJson(value))
+                    throw new BrainError('conflict', 'Run snapshot conflicts with a local knowledge correction.');
+            }
+            else
+                changes.push({
+                    kind,
+                    id: value.id,
+                    expected: prior.state.revisions[kind + ':' + value.id] ?? null,
+                    value,
+                });
+        }
+    if (!changes.length)
+        return { ...prior, index: 'unchanged', runId, entityId: root, imported: 0 };
+    const check = () => {
+        if (current.store.read().state.revision !== execution.state.revision)
+            throw new BrainError('conflict', 'Run changed during brain review; ingest its current snapshot.');
+        for (const artifact of artifacts)
+            checkArtifactSnapshot(current.store, artifact);
+    };
+    return {
+        ...(await commitBrain(cwd, changes, 'run', 'Recorded run metadata and executor evidence; improvement hypotheses remain proposals.', prior, options, check)),
+        runId,
+        entityId: root,
+        imported: changes.length,
+    };
+}
+//# sourceMappingURL=run-ingest.js.map

package/dist/brain/run-ingest.js.map

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

package/dist/brain/sqlite.d.ts

@@ -0,0 +1,19 @@
+import { type BrainState, type BrainEntity, type EntityKind } from './types.js';
+export declare class BrainIndex {
+    private readonly db;
+    readonly state: BrainState;
+    readonly cache: 'valid' | 'rebuilt';
+    private constructor();
+    static open(state: BrainState, bytes?: Uint8Array, signal?: AbortSignal): Promise<BrainIndex>;
+    close(): void;
+    export(): Uint8Array;
+    entity(selector: string): BrainEntity;
+    search(query: string, options?: {
+        kind?: EntityKind;
+        limit?: number;
+        includeRejected?: boolean;
+        signal?: AbortSignal;
+    }): BrainEntity[];
+    neighbors(id: string, includeRejected?: boolean): import("./types.js").BrainEdge[];
+}
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/brain/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/brain/sqlite.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AA0LpB,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,QAAQ,CAAC,KAAK,EAAE,UAAU;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS;IAHrC,OAAO,eAIH;IACJ,OAAa,IAAI,CACf,KAAK,EAAE,UAAU,EACjB,KAAK,CAAC,EAAE,UAAU,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAoCrB;IACD,KAAK,IAAI,IAAI,CAEZ;IACD,MAAM,IAAI,UAAU,CAEnB;IACD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CASpC;IACD,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QACP,IAAI,CAAC,EAAE,UAAU,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,MAAM,CAAC,EAAE,WAAW,CAAC;KACjB,GACL,WAAW,EAAE,CAoBf;IACD,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,eAAe,UAAQ,oCAM5C;CACF"}