opensip-cli 0.1.0

package/dist/cli-context.js

@@ -0,0 +1,134 @@
+/**
+ * cli-context — the thin `ToolCliContext` assembler (host-owned-run-timing
+ * Phase 6). `buildToolCliContext` wires together the focused host planes —
+ * output, egress, run, live, baseline, state, host-planes — into the single
+ * coherent context handed to each tool and host command. Each concern's logic
+ * lives in its own `bootstrap/*-plane` (or `*-seams`) module; this file only
+ * composes them and exposes the `scope` getter + the assembled context.
+ *
+ * There is NO module-global bootstrap-handoff bag. The populated registries +
+ * admitted-tool manifests/provenance are captured in the pre-action-hook closure
+ * (`installPreActionHook` is called AFTER `bootstrapCli` in `main()`), the hook
+ * builds + enters the per-run `RunScope`, and from there every per-run read
+ * (project, datastore, manifests, provenance, …) goes through `currentScope()`.
+ *
+ * Lazy datastore: a closure-based thunk caches the open DataStore on first access and
+ * lands on `RunScope.datastore`; paths that never touch it never materialise
+ * `.runtime/datastore.sqlite`.
+ */
+import { logger as defaultLogger, } from '@opensip-cli/core';
+import { buildBaselineSeams } from './bootstrap/baseline-seams.js';
+import { createEgressPlane } from './bootstrap/egress-plane.js';
+import { buildHostPlanes } from './bootstrap/host-planes.js';
+import { createLivePlane } from './bootstrap/live-plane.js';
+import { createOutputPlane } from './bootstrap/output-plane.js';
+import { createRunActionHooks, createRunPlaneFactory, createRunSessionSeam, } from './bootstrap/run-plane.js';
+import { getProjectDatastore, readScope } from './bootstrap/scope-access.js';
+import { buildStateSeams } from './bootstrap/state-seams.js';
+/** Structured-log `module` tag for this composition-root module. */
+const MODULE_TAG = 'cli:context';
+// ---------------------------------------------------------------------------
+// No module-global bootstrap-handoff bag.
+//
+// The registries + admitted-tool manifests/provenance the pre-action hook needs
+// to BUILD the scope are captured in the hook closure (`installPreActionHook` is
+// called AFTER `bootstrapCli` in `main()`; see `PreActionRuntime`). Once the hook
+// calls `enterScope`, ALL per-run state — project, datastore thunk, diagnostics,
+// AND the admitted-tool manifests/provenance (now stamped onto `RunScope`) — is
+// read exclusively via `currentScope()` (ALS). Host commands that surface the
+// admitted set (`plugin list`, `tools list`, `tools uninstall`) read
+// `currentScope()?.toolProvenance` / `?.toolManifests`.
+// ---------------------------------------------------------------------------
+// Per-run scope + datastore readers live in `bootstrap/scope-access.ts`; the
+// live-view registry lives in `bootstrap/live-plane.ts`. Both are re-exported
+// here so existing importers (`main()` + the dynamic-import tests) keep their
+// stable `cli-context.js` entry point while this module focuses on assembly.
+export { buildDatastoreThunk, getCurrentProjectRoot, getOrOpenDatastore, } from './bootstrap/scope-access.js';
+export { createLiveViewRegistry } from './bootstrap/live-plane.js';
+export function buildToolCliContext(opts) {
+    const log = opts.logger ?? defaultLogger;
+    // Output plane owns the single `process.exitCode` write path + the four
+    // `--json` emit seams (launch §5.5). Its `setExitCode` is the one threaded
+    // into egress so the run's exit code has exactly one author.
+    const outputPlane = createOutputPlane({ render: opts.render, logger: log });
+    // Host planes with stable deps only (same lazy datastore resolver):
+    //  - baseline/ratchet persistence + diff + exports (ADR-0036);
+    //  - durable per-tool keyed JSON state (ADR-0042);
+    //  - governance / entitlements / audit (H1-H3);
+    //  - effectful egress (cloud sync + `--report-to` + SARIF file sink).
+    const baselineSeams = buildBaselineSeams({ getDatastore: getProjectDatastore, logger: log });
+    const stateSeams = buildStateSeams({ getDatastore: getProjectDatastore });
+    const hostPlanes = buildHostPlanes({ getDatastore: getProjectDatastore, logger: log });
+    const egressPlane = createEgressPlane({ setExitCode: outputPlane.setExitCode, logger: log });
+    // Host run-lifecycle plane (host-owned-run-timing Phase 1). The FACTORY holds
+    // stable deps only — it must NOT start a lifecycle here. The lifecycle is
+    // created inside the command action (mount-command-spec calls `beginRun()`
+    // after RunScope entry, before the handler) or lazily on first `timing` read.
+    const runPlane = createRunPlaneFactory({
+        // Best-effort datastore resolver via the entered scope thunk (no direct /
+        // global access). Returns undefined when no project/datastore is in scope.
+        getDatastore: () => {
+            try {
+                const thunk = readScope().datastore;
+                return thunk ? thunk() : undefined;
+            }
+            catch (error) {
+                // @swallow-ok no entered scope / no datastore in scope is normal for
+                // non-project commands and tests; degrade to "no datastore" (the run
+                // plane then no-ops). Debug-log for diagnosability.
+                log.debug?.({
+                    evt: 'cli.context.datastore_unavailable',
+                    module: MODULE_TAG,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                return;
+            }
+        },
+        logger: log,
+    });
+    // Public run seam (display-only timing) + internal action hooks (the mount
+    // dispatch reads the hooks via cast). Both bind the run plane factory above;
+    // there is NO public generic-session writer — tools return a contribution and
+    // the action hook persists it.
+    const runSession = createRunSessionSeam(runPlane);
+    const runActionHooks = createRunActionHooks(runPlane);
+    // Live plane binds the per-invocation registry (built in `main()`) to the run
+    // plane so `renderLive` owns the live run lifecycle: it times the TTY
+    // occupancy and persists the renderer's returned `session` contribution.
+    const livePlane = createLivePlane({ liveViews: opts.liveViews, runPlane, runSession });
+    const ctx = {
+        get scope() {
+            // The pre-action-hook (or explicit runWithScope in tests) enters the
+            // RunScope via AsyncLocalStorage before the action body or any reader runs.
+            // `cli.scope` (and currentScope()) surface the identical entered scope.
+            // After Phase 3, readScope() no longer has holder fallbacks.
+            return readScope();
+        },
+        render: (result) => opts.render(result),
+        registerLiveView: livePlane.register,
+        renderLive: livePlane.renderLive,
+        maybeOpenReport: opts.maybeOpenReport,
+        logger: log,
+        setExitCode: outputPlane.setExitCode,
+        ...outputPlane.emits, // emitJson / emitEnvelope / emitError / emitRaw
+        deliverSignals: egressPlane.deliverSignals,
+        writeSarif: egressPlane.writeSarif,
+        // Host baseline/ratchet plane seams (ADR-0036) — persistence + diff + exports.
+        saveBaseline: baselineSeams.saveBaseline,
+        compareBaseline: baselineSeams.compareBaseline,
+        exportBaselineSarif: baselineSeams.exportBaselineSarif,
+        exportBaselineFingerprints: baselineSeams.exportBaselineFingerprints,
+        toolState: stateSeams, // ADR-0042: durable per-tool keyed JSON state
+        runSession, // host-owned; shared with the live plane
+        hostPlanes, // Host-owned governance / entitlements / audit plane (H1-H3)
+        // Internal run-lifecycle hooks (not public ToolCliContext members; the mount
+        // dispatch reads them via cast). beginRun marks the lifecycle start at the
+        // command-action boundary; completeRun persists a returned contribution.
+        ...runActionHooks,
+    };
+    return {
+        ctx,
+        getExitCode: outputPlane.getExitCode,
+    };
+}
+//# sourceMappingURL=cli-context.js.map

package/dist/cli-context.js.map

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

package/dist/commands/agent-catalog.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Structured catalog for AI agents.
+ * Provides stable entry points, recommended patterns (including the new
+ * agent ergonomics like --filter, --raw, --summary-only), and example shapes.
+ * This is intentionally a small, self-contained surface so agents can
+ * bootstrap their usage without parsing --help text or source.
+ *
+ * Future: can be made more dynamic by introspecting live CommandSpecs
+ * (see completion.ts for precedent).
+ */
+export interface AgentCatalog {
+    readonly version: string;
+    readonly description: string;
+    readonly entryPoints: readonly {
+        readonly command: string;
+        readonly description: string;
+        readonly examples: readonly string[];
+    }[];
+    readonly commonPatterns: readonly {
+        readonly name: string;
+        readonly description: string;
+        readonly example: string;
+    }[];
+    readonly outputShapes: {
+        readonly signalEnvelope: string;
+        readonly sessionReplay: string;
+        readonly history: string;
+    };
+    readonly notes: readonly string[];
+}
+export declare function buildAgentCatalog(): AgentCatalog;
+export declare function executeAgentCatalog(opts?: {
+    json?: boolean;
+}): {
+    type: string;
+    catalog: AgentCatalog;
+    title?: undefined;
+    lines?: undefined;
+} | {
+    type: string;
+    title: string;
+    lines: string[];
+    catalog?: undefined;
+};
+//# sourceMappingURL=agent-catalog.d.ts.map

package/dist/commands/agent-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-catalog.d.ts","sourceRoot":"","sources":["../../src/commands/agent-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,SAAS;QAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;KACtC,EAAE,CAAC;IACJ,QAAQ,CAAC,cAAc,EAAE,SAAS;QAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,EAAE,CAAC;IACJ,QAAQ,CAAC,YAAY,EAAE;QACrB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,wBAAgB,iBAAiB,IAAI,YAAY,CA8FhD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO;;;;;;;;;;EA8BhE"}

package/dist/commands/agent-catalog.js

@@ -0,0 +1,115 @@
+export function buildAgentCatalog() {
+    return {
+        version: '1.0.0',
+        description: 'Stable, machine-oriented surface for AI agents using OpenSIP CLI. ' +
+            'Focus on --json paths, sessions for historical results, and composable filters. ' +
+            'Human UX (tables, banners) is preserved unchanged.',
+        entryPoints: [
+            {
+                command: 'fit',
+                description: 'Run fitness checks. Use --json for machine output (SignalEnvelope).',
+                examples: ['opensip fit --recipe default --json', 'opensip fit --check some-check --json'],
+            },
+            {
+                command: 'graph',
+                description: 'Build static call graph + rules. --json yields SignalEnvelope.',
+                examples: ['opensip graph --json', 'opensip graph --sarif out.sarif'],
+            },
+            {
+                command: 'sessions list',
+                description: 'List stored sessions. --summary-only is agent-friendly (omits heavy payloads).',
+                examples: [
+                    'opensip sessions list --json --summary-only',
+                    'opensip sessions list --json --tool fit --limit 5',
+                ],
+            },
+            {
+                command: 'sessions show',
+                description: 'Retrieve a prior run as SessionReplayResult (includes projected SignalEnvelope). ' +
+                    'Supports latest + --tool and rich filtering.',
+                examples: [
+                    'opensip sessions show latest --tool fit --json',
+                    'opensip sessions show latest --tool fit --json --filter errors-only --filter top:20',
+                    'opensip sessions show GRAPH_01... --json --raw',
+                    'opensip sessions show previous --tool graph --json',
+                ],
+            },
+            {
+                command: 'agent-catalog',
+                description: 'This command. Self-describing catalog for agents (JSON preferred).',
+                examples: ['opensip agent-catalog --json'],
+            },
+        ],
+        commonPatterns: [
+            {
+                name: 'Inspect latest fit with focus on errors',
+                description: 'After a fit run, pull only actionable errors (high severity) and limit count.',
+                example: 'opensip sessions show latest --tool fit --json --filter errors-only --filter top:10',
+            },
+            {
+                name: 'Lean session menu for agents',
+                description: 'Get pointers to interesting sessions without downloading full historical payloads.',
+                example: 'opensip sessions list --json --summary-only --tool fit',
+            },
+            {
+                name: 'Minimal raw envelope for token-sensitive agents',
+                description: 'Bypass the standard CommandResult wrapper when you only need the core data.',
+                example: 'opensip sessions show latest --tool graph --json --raw',
+            },
+            {
+                name: 'Relative navigation',
+                description: 'Walk backwards through recent runs of a specific tool without tracking IDs.',
+                example: 'opensip sessions show previous --tool fit --json --filter warnings-only',
+            },
+        ],
+        outputShapes: {
+            signalEnvelope: 'The canonical cross-tool currency (schemaVersion, tool, runId, verdict, units, signals). ' +
+                'Every fit/graph/sim result (live or replayed) carries one. See contracts for full type.',
+            sessionReplay: 'For sessions show: { session: {id,tool,startedAt,completedAt,score,passed,...}, fidelity: "projection", envelope: SignalEnvelope, filtersApplied?, ...counts }',
+            history: 'For sessions list: { type: "history", sessions: HistorySession[] } where each has showCommand + optional summary.',
+        },
+        notes: [
+            'All machine output is under --json. Use --raw on show for the smallest possible payload.',
+            'filtersApplied, originalSignalCount, returnedSignalCount appear when --filter is used.',
+            'The fidelity field on replays is always "projection" (rebuilt from persisted data).',
+            'Human-readable output (no --json) uses the same tables/banners as before — unchanged.',
+            'Dogfood gate requires 0 errors + 0 warnings on fit:ci and graph:ci after any change.',
+            // Hygiene invariant (host-planes-scope-seams-hygiene Phases 2-4): everything runs inside an
+            // entered RunScope; the only sanctioned seams for output, delivery, baselines, toolState,
+            // and hostPlanes (governance/audit/entitlements) are the documented methods on ToolCliContext
+            // (render, emitJson, emitEnvelope, deliverSignals, writeSarif, + the baseline/toolState/hostPlanes
+            // accessors). Direct stdout, the old pre-scope holder, or raw datastore from handlers is
+            // forbidden and caught by ESLint + fitness check + runtime guards. Bootstrap root is exempted.
+            'Only the methods on the ToolCliContext you receive are allowed for emission/state/planes.',
+        ],
+    };
+}
+export function executeAgentCatalog(opts = {}) {
+    const catalog = buildAgentCatalog();
+    if (opts.json) {
+        // Return a result shape that the host can emit cleanly.
+        // Using a plain object here; a proper AgentCatalogResult union member
+        // can be added in Phase 6 wiring for full type safety / parity.
+        return {
+            type: 'agent-catalog',
+            catalog,
+        };
+    }
+    // Human summary (simple, not the full catalog dump).
+    const lines = [
+        'Agent Catalog (use --json for the full machine-readable version)',
+        '',
+        'Primary patterns for agents:',
+        ...catalog.commonPatterns.map((p) => `  • ${p.name}: ${p.example}`),
+        '',
+        'Key entry points: ' + catalog.entryPoints.map((e) => e.command).join(', '),
+        '',
+        'See --json output or the docs for complete shapes and more examples.',
+    ];
+    return {
+        type: 'text-lines',
+        title: 'Agent Catalog',
+        lines,
+    };
+}
+//# sourceMappingURL=agent-catalog.js.map

package/dist/commands/agent-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-catalog.js","sourceRoot":"","sources":["../../src/commands/agent-catalog.ts"],"names":[],"mappings":"AA+BA,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,WAAW,EACT,oEAAoE;YACpE,kFAAkF;YAClF,oDAAoD;QACtD,WAAW,EAAE;YACX;gBACE,OAAO,EAAE,KAAK;gBACd,WAAW,EAAE,qEAAqE;gBAClF,QAAQ,EAAE,CAAC,qCAAqC,EAAE,uCAAuC,CAAC;aAC3F;YACD;gBACE,OAAO,EAAE,OAAO;gBAChB,WAAW,EAAE,gEAAgE;gBAC7E,QAAQ,EAAE,CAAC,sBAAsB,EAAE,iCAAiC,CAAC;aACtE;YACD;gBACE,OAAO,EAAE,eAAe;gBACxB,WAAW,EACT,gFAAgF;gBAClF,QAAQ,EAAE;oBACR,6CAA6C;oBAC7C,mDAAmD;iBACpD;aACF;YACD;gBACE,OAAO,EAAE,eAAe;gBACxB,WAAW,EACT,mFAAmF;oBACnF,8CAA8C;gBAChD,QAAQ,EAAE;oBACR,gDAAgD;oBAChD,qFAAqF;oBACrF,gDAAgD;oBAChD,oDAAoD;iBACrD;aACF;YACD;gBACE,OAAO,EAAE,eAAe;gBACxB,WAAW,EAAE,oEAAoE;gBACjF,QAAQ,EAAE,CAAC,8BAA8B,CAAC;aAC3C;SACF;QACD,cAAc,EAAE;YACd;gBACE,IAAI,EAAE,yCAAyC;gBAC/C,WAAW,EACT,+EAA+E;gBACjF,OAAO,EACL,qFAAqF;aACxF;YACD;gBACE,IAAI,EAAE,8BAA8B;gBACpC,WAAW,EACT,oFAAoF;gBACtF,OAAO,EAAE,wDAAwD;aAClE;YACD;gBACE,IAAI,EAAE,iDAAiD;gBACvD,WAAW,EAAE,6EAA6E;gBAC1F,OAAO,EAAE,wDAAwD;aAClE;YACD;gBACE,IAAI,EAAE,qBAAqB;gBAC3B,WAAW,EAAE,6EAA6E;gBAC1F,OAAO,EAAE,yEAAyE;aACnF;SACF;QACD,YAAY,EAAE;YACZ,cAAc,EACZ,2FAA2F;gBAC3F,yFAAyF;YAC3F,aAAa,EACX,gKAAgK;YAClK,OAAO,EACL,mHAAmH;SACtH;QACD,KAAK,EAAE;YACL,0FAA0F;YAC1F,wFAAwF;YACxF,qFAAqF;YACrF,uFAAuF;YACvF,sFAAsF;YACtF,4FAA4F;YAC5F,0FAA0F;YAC1F,8FAA8F;YAC9F,mGAAmG;YACnG,yFAAyF;YACzF,+FAA+F;YAC/F,2FAA2F;SAC5F;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAA2B,EAAE;IAC/D,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IAEpC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,wDAAwD;QACxD,sEAAsE;QACtE,gEAAgE;QAChE,OAAO;YACL,IAAI,EAAE,eAAe;YACrB,OAAO;SACR,CAAC;IACJ,CAAC;IAED,qDAAqD;IACrD,MAAM,KAAK,GAAa;QACtB,kEAAkE;QAClE,EAAE;QACF,8BAA8B;QAC9B,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;QACnE,EAAE;QACF,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC3E,EAAE;QACF,sEAAsE;KACvE,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/commands/assemble-outcome.d.ts

@@ -0,0 +1,69 @@
+/**
+ * assemble-outcome — the host-owned assembler that STAMPS a {@link CommandOutcome}
+ * onto a handler's pure-domain return (launch, north-star §5.5).
+ *
+ * The single load-bearing rule of the Output plane: **the host assembles, the
+ * handler stays pure domain.** A tool handler returns (or hands the host) its
+ * `SignalEnvelope` / `CommandResult` / a bare JSON document / an error message;
+ * THIS module turns that into the one outer currency by deriving `kind`,
+ * `status`, `exitCode`, the structured `errors`, AND stamping the scope-owned
+ * `diagnostics` snapshot. The handler never constructs a `CommandOutcome` (it
+ * cannot — the diagnostics bus is scope-collected). This keeps every tool,
+ * first-party or external, off the privilege of choosing its own error JSON or
+ * success carrier.
+ *
+ * No stdout here — the builders only read the current scope's diagnostics bus.
+ * {@link renderOutcome} (the sibling) is the one place an outcome reaches a stream.
+ */
+import { type CommandOutcome, type SignalEnvelope } from '@opensip-cli/contracts';
+/** Derive a run outcome's `kind` from the envelope's tool id: `'<tool>.run'`. */
+export declare function kindFromEnvelope(envelope: SignalEnvelope): string;
+/**
+ * Derive a result outcome's `kind` from a `CommandResult`'s discriminant
+ * (`result.type`, e.g. `'history'` → `'history'`), falling back to a neutral
+ * `'command.result'` for bare JSON documents that carry no `type`.
+ */
+export declare function kindFromResult(value: unknown): string;
+/**
+ * Wrap a completed run's {@link SignalEnvelope} as a `status:'ok'` outcome — the
+ * envelope rides UNCHANGED under `.envelope` (the byte-identical inner currency;
+ * the break is purely this new outer wrapper). `status` is `'ok'` for any run
+ * that completed: a failing gate is a successful run with a non-zero `exitCode`,
+ * and the gate verdict is read from `.envelope.verdict`, not the outer status.
+ */
+export declare function outcomeFromEnvelope(envelope: SignalEnvelope, exitCode: number): CommandOutcome;
+/**
+ * Wrap a `CommandResult` (or a bare JSON document) as `.data`. An `ErrorResult`
+ * (`type:'error'`) becomes a `status:'error'` outcome carrying its own
+ * `exitCode` + a structured `errors` entry; everything else is `status:'ok'` with
+ * the supplied `exitCode`.
+ */
+export declare function outcomeFromResult(value: unknown, exitCode: number): CommandOutcome;
+/**
+ * Build a `status:'error'` outcome from a thrown error — the host's error
+ * stamper. A typed {@link ToolError} maps to its canonical exit code
+ * (`mapToolErrorToExitCode`) and contributes its `code`; an untyped error is a
+ * `RUNTIME_ERROR` (exit 1). The actionable `suggestion` comes from the shared
+ * `getErrorSuggestion` rule table — the same diagnosis the legacy
+ * `handleParseError` surfaced.
+ *
+ * @param kind The outcome kind (e.g. `'bootstrap.error'` for a pre-handler
+ *   failure, Phase 3); defaults to `'command.error'`.
+ */
+export declare function outcomeFromError(error: unknown, opts?: {
+    readonly kind?: string;
+}): CommandOutcome;
+/**
+ * Build a `status:'error'` outcome from an already-resolved message + exit code —
+ * the seam tool handlers use when they have a diagnosed failure (the former
+ * `emitJson({ error })` shape) rather than a thrown error to map.
+ */
+export declare function outcomeFromErrorMessage(opts: {
+    readonly message: string;
+    readonly exitCode: number;
+    readonly suggestion?: string;
+    /** Optional machine-readable error category, surfaced as `ErrorDetail.code`. */
+    readonly code?: string;
+    readonly kind?: string;
+}): CommandOutcome;
+//# sourceMappingURL=assemble-outcome.d.ts.map

package/dist/commands/assemble-outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assemble-outcome.d.ts","sourceRoot":"","sources":["../../src/commands/assemble-outcome.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAIL,KAAK,cAAc,EAGnB,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AAgBhC,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGrD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAE9F;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAYlF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,IAAI,GAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GACpC,cAAc,CAgBhB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,cAAc,CAajB"}

package/dist/commands/assemble-outcome.js

@@ -0,0 +1,121 @@
+/**
+ * assemble-outcome — the host-owned assembler that STAMPS a {@link CommandOutcome}
+ * onto a handler's pure-domain return (launch, north-star §5.5).
+ *
+ * The single load-bearing rule of the Output plane: **the host assembles, the
+ * handler stays pure domain.** A tool handler returns (or hands the host) its
+ * `SignalEnvelope` / `CommandResult` / a bare JSON document / an error message;
+ * THIS module turns that into the one outer currency by deriving `kind`,
+ * `status`, `exitCode`, the structured `errors`, AND stamping the scope-owned
+ * `diagnostics` snapshot. The handler never constructs a `CommandOutcome` (it
+ * cannot — the diagnostics bus is scope-collected). This keeps every tool,
+ * first-party or external, off the privilege of choosing its own error JSON or
+ * success carrier.
+ *
+ * No stdout here — the builders only read the current scope's diagnostics bus.
+ * {@link renderOutcome} (the sibling) is the one place an outcome reaches a stream.
+ */
+import { EXIT_CODES, getErrorSuggestion, mapToolErrorToExitCode, } from '@opensip-cli/contracts';
+import { ToolError, currentScope } from '@opensip-cli/core';
+/**
+ * Attach the scope-owned diagnostics snapshot (north-star §5.10) to a freshly
+ * built outcome. The host stamps it here — a handler never assembles diagnostics
+ * (it cannot: the bus is scope-collected). Omitted entirely when no scope is
+ * bound (isolated unit tests) or the bus is empty-and-untraced, keeping the
+ * outcome shape minimal.
+ */
+function withDiagnostics(outcome) {
+    const diagnostics = currentScope()?.diagnostics?.snapshot();
+    if (diagnostics === undefined)
+        return outcome;
+    return { ...outcome, diagnostics };
+}
+/** Derive a run outcome's `kind` from the envelope's tool id: `'<tool>.run'`. */
+export function kindFromEnvelope(envelope) {
+    return `${envelope.tool}.run`;
+}
+/**
+ * Derive a result outcome's `kind` from a `CommandResult`'s discriminant
+ * (`result.type`, e.g. `'history'` → `'history'`), falling back to a neutral
+ * `'command.result'` for bare JSON documents that carry no `type`.
+ */
+export function kindFromResult(value) {
+    const type = value?.type;
+    return typeof type === 'string' ? type : 'command.result';
+}
+/**
+ * Wrap a completed run's {@link SignalEnvelope} as a `status:'ok'` outcome — the
+ * envelope rides UNCHANGED under `.envelope` (the byte-identical inner currency;
+ * the break is purely this new outer wrapper). `status` is `'ok'` for any run
+ * that completed: a failing gate is a successful run with a non-zero `exitCode`,
+ * and the gate verdict is read from `.envelope.verdict`, not the outer status.
+ */
+export function outcomeFromEnvelope(envelope, exitCode) {
+    return withDiagnostics({ kind: kindFromEnvelope(envelope), status: 'ok', exitCode, envelope });
+}
+/**
+ * Wrap a `CommandResult` (or a bare JSON document) as `.data`. An `ErrorResult`
+ * (`type:'error'`) becomes a `status:'error'` outcome carrying its own
+ * `exitCode` + a structured `errors` entry; everything else is `status:'ok'` with
+ * the supplied `exitCode`.
+ */
+export function outcomeFromResult(value, exitCode) {
+    if (value?.type === 'error') {
+        const err = value;
+        return withDiagnostics({
+            kind: 'error',
+            status: 'error',
+            exitCode: err.exitCode,
+            data: value,
+            errors: [{ message: err.message, ...(err.suggestion ? { suggestion: err.suggestion } : {}) }],
+        });
+    }
+    return withDiagnostics({ kind: kindFromResult(value), status: 'ok', exitCode, data: value });
+}
+/**
+ * Build a `status:'error'` outcome from a thrown error — the host's error
+ * stamper. A typed {@link ToolError} maps to its canonical exit code
+ * (`mapToolErrorToExitCode`) and contributes its `code`; an untyped error is a
+ * `RUNTIME_ERROR` (exit 1). The actionable `suggestion` comes from the shared
+ * `getErrorSuggestion` rule table — the same diagnosis the legacy
+ * `handleParseError` surfaced.
+ *
+ * @param kind The outcome kind (e.g. `'bootstrap.error'` for a pre-handler
+ *   failure, Phase 3); defaults to `'command.error'`.
+ */
+export function outcomeFromError(error, opts = {}) {
+    const message = error instanceof Error ? error.message : String(error);
+    const suggestion = getErrorSuggestion(error)?.action;
+    const detail = {
+        message,
+        ...(suggestion ? { suggestion } : {}),
+        ...(error instanceof ToolError ? { code: error.code } : {}),
+    };
+    const exitCode = error instanceof ToolError ? mapToolErrorToExitCode(error) : EXIT_CODES.RUNTIME_ERROR;
+    return withDiagnostics({
+        kind: opts.kind ?? 'command.error',
+        status: 'error',
+        exitCode,
+        errors: [detail],
+    });
+}
+/**
+ * Build a `status:'error'` outcome from an already-resolved message + exit code —
+ * the seam tool handlers use when they have a diagnosed failure (the former
+ * `emitJson({ error })` shape) rather than a thrown error to map.
+ */
+export function outcomeFromErrorMessage(opts) {
+    return withDiagnostics({
+        kind: opts.kind ?? 'command.error',
+        status: 'error',
+        exitCode: opts.exitCode,
+        errors: [
+            {
+                message: opts.message,
+                ...(opts.suggestion ? { suggestion: opts.suggestion } : {}),
+                ...(opts.code ? { code: opts.code } : {}),
+            },
+        ],
+    });
+}
+//# sourceMappingURL=assemble-outcome.js.map

package/dist/commands/assemble-outcome.js.map

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

package/dist/commands/clear.d.ts

@@ -0,0 +1,32 @@
+/**
+ * clear command — clear session data from the project-local SQLite DB.
+ *
+ * Rows in the `sessions` table (and cascaded findings/checks) are
+ * the unit of deletion. The CLI
+ * bootstrap opens the DataStore in `preAction`; this command receives
+ * the constructed repo from its caller.
+ *
+ * Uses Node `readline` for interactive confirmation (Ink's `useInput`
+ * raw-mode requirement is incompatible with prompts on every TTY).
+ * Banners and result lines route through the Ink renderer via the
+ * `clear-done` `CommandResult` shape — no raw ANSI escapes here.
+ */
+import type { ClearDoneResult } from '@opensip-cli/contracts';
+import type { DataStore } from '@opensip-cli/datastore';
+export interface ClearOptions {
+    olderThan?: number;
+    yes: boolean;
+    datastore: DataStore;
+}
+/**
+ * Prompt for confirmation (unless --yes), then delete sessions.
+ * Returns a `ClearDoneResult` that the renderer turns into the banner
+ * + status line. The rendering is `App.tsx`'s `case 'clear-done':`
+ * branch — this function is pure I/O for the prompt only.
+ *
+ * Deletion goes through `SessionRepo` against the project-local
+ * SQLite DB. Cascaded findings/checks are removed by foreign-key
+ * cascade rules in the schema.
+ */
+export declare function executeClear(opts: ClearOptions): Promise<ClearDoneResult>;
+//# sourceMappingURL=clear.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clear.d.ts","sourceRoot":"","sources":["../../src/commands/clear.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,SAAS,CAAC;CACtB;AAYD;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAyC/E"}

package/dist/commands/clear.js

@@ -0,0 +1,73 @@
+/**
+ * clear command — clear session data from the project-local SQLite DB.
+ *
+ * Rows in the `sessions` table (and cascaded findings/checks) are
+ * the unit of deletion. The CLI
+ * bootstrap opens the DataStore in `preAction`; this command receives
+ * the constructed repo from its caller.
+ *
+ * Uses Node `readline` for interactive confirmation (Ink's `useInput`
+ * raw-mode requirement is incompatible with prompts on every TTY).
+ * Banners and result lines route through the Ink renderer via the
+ * `clear-done` `CommandResult` shape — no raw ANSI escapes here.
+ */
+// @fitness-ignore-file only-documented-toolcli-seams -- interactive TTY confirmation: the pre-prompt notes printed before "Continue? (y/n)" are human-readable readline UX, not machine run output through a ToolCliContext seam (mirrors the ESLint exemption for this file). Result lines route through the Ink `clear-done` CommandResult. (Architecture review finding 5.)
+import { createInterface } from 'node:readline';
+import { SessionRepo } from '@opensip-cli/session-store';
+function ask(question) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim().toLowerCase());
+        });
+    });
+}
+/**
+ * Prompt for confirmation (unless --yes), then delete sessions.
+ * Returns a `ClearDoneResult` that the renderer turns into the banner
+ * + status line. The rendering is `App.tsx`'s `case 'clear-done':`
+ * branch — this function is pure I/O for the prompt only.
+ *
+ * Deletion goes through `SessionRepo` against the project-local
+ * SQLite DB. Cascaded findings/checks are removed by foreign-key
+ * cascade rules in the schema.
+ */
+export async function executeClear(opts) {
+    const repo = new SessionRepo(opts.datastore);
+    const sessionCount = repo.count();
+    if (sessionCount === 0) {
+        return { type: 'clear-done', action: 'empty', deletedCount: 0, sessionCount: 0 };
+    }
+    if (!opts.yes) {
+        // Pre-prompt note. Stdout `process.stdout.write` is fine here:
+        // Ink can't own this since it conflicts with `readline.question()`,
+        // and there are no ANSI escapes — just plain text the user reads
+        // before answering. Ink renders the result message after.
+        const dayWord = opts.olderThan === 1 ? 'day' : 'days';
+        const description = opts.olderThan
+            ? `This will delete session data older than ${opts.olderThan} ${dayWord} from the project-local SQLite store.`
+            : 'This will delete ALL session data from the project-local SQLite store.';
+        process.stdout.write(`\n  ${description}\n`);
+        process.stdout.write(`  ${sessionCount} session${sessionCount === 1 ? '' : 's'} currently stored.\n`);
+        process.stdout.write(`  This includes run history and dashboard data.\n\n`);
+        const answer = await ask('  Continue? (y/n) ');
+        if (answer !== 'y') {
+            return { type: 'clear-done', action: 'cancelled', deletedCount: 0, sessionCount };
+        }
+    }
+    let deletedCount;
+    if (opts.olderThan !== undefined && opts.olderThan > 0) {
+        // Wall-time cutoff (N calendar-ish days ago by ms). Not sensitive to
+        // local date boundaries or DST; sessions are purged if their stored
+        // timestamp is older than (now - N*24h). This matches the user-facing
+        // "older than X days" language in the prompt.
+        const cutoff = new Date(Date.now() - opts.olderThan * 24 * 60 * 60 * 1000);
+        deletedCount = repo.purge(cutoff);
+    }
+    else {
+        deletedCount = repo.clearAll();
+    }
+    return { type: 'clear-done', action: 'done', deletedCount, sessionCount };
+}
+//# sourceMappingURL=clear.js.map

package/dist/commands/clear.js.map

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