opensip-cli 0.1.14 → 0.1.15

package/dist/commands/agent-catalog.js

@@ -1,205 +1,14 @@
 /**
- * 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.
+ * `agent-catalog` command adapter.
  *
- * Command taxonomy (tool-command-surface-taxonomy):
- * - Entry points are keyed by the PUBLIC command path. A `parent`-nested tool
- *   verb (the `<tool> <verb>` grammar enabled by `CommandSpec.parent` — e.g.
- *   `graph export`, `fit list`) is catalogued UNDER its tool's entry point
- *   (the `<tool> <verb>` form), NOT as a separate root entry point.
- * - Tier-3 `visibility: 'internal'` commands (`*-run-worker`, `*-shard-worker`,
- *   `*-equivalence-check`) are NEVER catalogued here — the agent-catalog
- *   primary surface excludes internal workers (the host-owned tiering pass
- *   formalized in Phase 1 filters them when this surface becomes spec-derived).
+ * The catalog projection (`buildAgentCatalog` + its `AgentCatalog` / `CommandTier`
+ * types) was re-homed into `@opensip-cli/contracts` (ADR-0084) so
+ * `@opensip-cli/mcp` can serve the same surface without importing the
+ * composition root. This module re-exports it for existing call sites/tests and
+ * keeps the host rendering wrapper (`executeAgentCatalog`).
  */
-/**
- * Internal (Tier-3) command-name shapes the agent-catalog must NEVER surface:
- * the IPC/CI workers and the equivalence gate. The guard checks both the name
- * shape AND an explicit `tier: 'internal'` so a future edit can't slip one in by
- * either route. This is the by-construction complement to the Phase 4 test.
- */
-const INTERNAL_COMMAND_NAME_RE = /(?:-run-worker|-shard-worker|-equivalence-check)\b/;
-function compareCodePoint(left, right) {
-    if (left < right)
-        return -1;
-    if (left > right)
-        return 1;
-    return 0;
-}
-/**
- * Throw if any entry point is a Tier-3 internal command (by name shape or by an
- * explicit `tier: 'internal'`). Called at catalog-build time so a regression that
- * pastes an internal command into `entryPoints` fails loudly the first time the
- * catalog is built, not silently at the agent boundary.
- *
- * @throws {Error} When an entry point is a Tier-3 internal command — by an
- *   explicit `tier: 'internal'` or by an internal command-name shape
- *   (`*-run-worker` / `*-shard-worker` / `*-equivalence-check`).
- */
-function assertNoInternalEntryPoints(entryPoints) {
-    const leaked = entryPoints.find((e) => e.tier === 'internal' || INTERNAL_COMMAND_NAME_RE.test(e.command));
-    if (leaked !== undefined) {
-        throw new Error(`agent-catalog: Tier-3 internal command '${leaked.command}' must not appear in the ` +
-            'agent-catalog primary surface (tool-command-surface-taxonomy). Remove it from entryPoints.');
-    }
-}
-const TOOL_ENTRY_OVERLAYS = {
-    fitness: {
-        description: 'Run fitness checks. Use --json for machine output (SignalEnvelope). Agent recipes: agent-fast, agent-risk, agent-final.',
-        examples: [
-            'opensip fit --recipe agent-fast --json --filter errors-only',
-            'opensip fit --changed --include-impacted --json',
-            'opensip fit --recipe agent-final --gate-compare',
-        ],
-    },
-    graph: {
-        description: 'Build static call graph + rules. --json yields SignalEnvelope. Use graph impact for change-aware blast radius.',
-        examples: [
-            'opensip graph --json',
-            'opensip graph impact --changed --json --top 20',
-            'opensip graph --recipe agent-risk --json --filter high-impact',
-        ],
-    },
-    sim: {
-        description: 'Run simulation scenarios. Use --json for machine output (SignalEnvelope).',
-        examples: ['opensip sim --json', 'opensip sim --scenario default --json'],
-    },
-    yagni: {
-        description: 'Run YAGNI reduction audit detectors. Advisory findings; --json yields SignalEnvelope.',
-        examples: ['opensip yagni --json', 'opensip yagni --json packages/yagni/engine'],
-    },
-};
-const PLATFORM_ENTRY_POINTS = [
-    {
-        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 fitness --limit 5',
-        ],
-        tier: 'platform',
-    },
-    {
-        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 fitness --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',
-        ],
-        tier: 'platform',
-    },
-    {
-        command: 'agent-catalog',
-        description: 'This command. Self-describing catalog for agents (JSON preferred).',
-        examples: ['opensip agent-catalog --json'],
-        tier: 'platform',
-    },
-];
-function publicPrimaryCommand(tool, internalCommands) {
-    return (tool.commandSpecs ?? []).find((spec) => spec.parent === undefined &&
-        spec.visibility !== 'internal' &&
-        !internalCommands.has(spec.name) &&
-        !INTERNAL_COMMAND_NAME_RE.test(spec.name));
-}
-function entryPointForTool(tool, internalCommands) {
-    const primary = publicPrimaryCommand(tool, internalCommands);
-    if (primary === undefined)
-        return undefined;
-    const overlay = TOOL_ENTRY_OVERLAYS[primary.name] ?? TOOL_ENTRY_OVERLAYS[tool.metadata.name];
-    return {
-        command: primary.name,
-        description: overlay?.description ??
-            `${primary.description} Use --json when available for machine output.`,
-        examples: overlay?.examples ?? [`opensip ${primary.name} --json`],
-        tier: 'tool',
-    };
-}
-function deriveToolEntryPoints(tools, internalCommands) {
-    return (tools?.list() ?? [])
-        .map((tool) => entryPointForTool(tool, internalCommands))
-        .filter((entry) => entry !== undefined)
-        .sort((a, b) => compareCodePoint(a.command, b.command));
-}
-export function buildAgentCatalog(input = {}) {
-    const entryPoints = [
-        ...deriveToolEntryPoints(input.tools, input.internalCommands ?? new Set()),
-        ...PLATFORM_ENTRY_POINTS,
-    ];
-    assertNoInternalEntryPoints(entryPoints);
-    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,
-        commonPatterns: [
-            {
-                name: 'Read latest result first (read-latest-result)',
-                description: 'When the user says a tool already reported findings, inspect the latest stored result before re-running.',
-                example: 'opensip sessions show latest --tool fit --json --filter errors-only --filter top:20',
-            },
-            {
-                name: 'Agent edit loop',
-                description: 'Fast check → impact analysis → changed-only fit → final gate.',
-                example: 'opensip fit --recipe agent-fast --json && opensip graph impact --changed --json && opensip fit --changed --include-impacted --json',
-            },
-            {
-                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: [
-            'Agent recipes (when present): fit agent-fast / agent-risk / agent-final; graph agent-risk / agent-final.',
-            'Live runs support --filter/--top/--raw on fit/graph/sim --json (same engine as sessions show).',
-            'graph impact answers changed→impacted without a separate git diff dance.',
-            '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.',
-            // Uniform tool-primary surface (host-guaranteed; decorateToolPrimary).
-            'Every tool primary (fit/graph/sim/yagni and any third-party tool) accepts `<tool> --version` ' +
-                '(prints the TOOL version, e.g. `fit 0.1.6`; distinct from `opensip --version`, the CLI), ' +
-                'plus the guaranteed baseline flags --cwd, --json, --config, --quiet, --verbose.',
-            '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, writeArtifact, 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.',
-        ],
-    };
-}
+import { buildAgentCatalog } from '@opensip-cli/contracts';
+export { buildAgentCatalog } from '@opensip-cli/contracts';
 export function executeAgentCatalog(opts = {}) {
     const catalog = buildAgentCatalog({
         tools: opts.tools,

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

@@ -1 +1 @@
-{"version":3,"file":"agent-catalog.js","sourceRoot":"","sources":["../../src/commands/agent-catalog.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-catalog.js","sourceRoot":"","sources":["../../src/commands/agent-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAI3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,MAAM,UAAU,mBAAmB,CACjC,OAII,EAAE;IAEN,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;KACxC,CAAC,CAAC;IAEH,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-opts.d.ts

@@ -0,0 +1,13 @@
+import { type OptionSpec } from '@opensip-cli/core';
+export interface AssembleOptsInput {
+    readonly options: readonly OptionSpec[] | undefined;
+    readonly suppliedValues?: Readonly<Record<string, unknown>>;
+}
+export interface AssembledOpts {
+    readonly opts: Record<string, unknown>;
+    readonly knownKeys: ReadonlySet<string>;
+}
+export declare function optionKey(spec: OptionSpec): string;
+export declare function assembleOptsFromSpec(input: AssembleOptsInput): AssembledOpts;
+export declare function optionDefaultValue(spec: OptionSpec): unknown;
+//# sourceMappingURL=assemble-opts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assemble-opts.d.ts","sourceRoot":"","sources":["../../src/commands/assemble-opts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIxE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACzC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAQlD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,GAAG,aAAa,CAe5E;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAK5D"}

package/dist/commands/assemble-opts.js

@@ -0,0 +1,85 @@
+import { ConfigurationError } from '@opensip-cli/core';
+const NO_PREVIOUS_VALUE = undefined;
+export function optionKey(spec) {
+    const long = spec.flag
+        .split(',')
+        .map((part) => part.trim())
+        .find((part) => part.startsWith('--'));
+    const token = long ?? spec.flag.trim().split(/\s+/)[0] ?? '';
+    const withoutPrefix = token.replace(/^--no-/, '').replace(/^--/, '');
+    return withoutPrefix.replace(/-([a-z0-9])/g, (_, c) => c.toUpperCase());
+}
+export function assembleOptsFromSpec(input) {
+    const supplied = input.suppliedValues ?? {};
+    const opts = {};
+    const knownKeys = new Set();
+    for (const spec of input.options ?? []) {
+        const key = optionKey(spec);
+        knownKeys.add(key);
+        const value = parseOptionValue(spec, initialOptionValue(spec, supplied, key));
+        validateChoices(key, spec, value);
+        validateRequired(key, spec, value);
+        assignIfPresent(opts, key, value);
+    }
+    return { opts, knownKeys };
+}
+export function optionDefaultValue(spec) {
+    if (spec.arrayDefault !== undefined)
+        return [...spec.arrayDefault];
+    if (spec.default !== undefined)
+        return spec.default;
+    if (spec.negatable === true)
+        return true;
+    return undefined;
+}
+function initialOptionValue(spec, supplied, key) {
+    return Object.prototype.hasOwnProperty.call(supplied, key)
+        ? supplied[key]
+        : optionDefaultValue(spec);
+}
+function parseOptionValue(spec, value) {
+    if (value === undefined || spec.parse === undefined)
+        return value;
+    if (!Array.isArray(value))
+        return spec.parse(stringifyOptionValue(value), NO_PREVIOUS_VALUE);
+    let previous = spec.arrayDefault === undefined ? undefined : [...spec.arrayDefault];
+    for (const item of value) {
+        previous = spec.parse(stringifyOptionValue(item), previous);
+    }
+    return previous;
+}
+function validateChoices(key, spec, value) {
+    if (value === undefined || spec.choices === undefined || spec.choices.length === 0)
+        return;
+    const values = Array.isArray(value) ? value : [value];
+    for (const candidate of values) {
+        const text = stringifyOptionValue(candidate);
+        if (!spec.choices.includes(text)) {
+            throw new ConfigurationError(`Invalid value for option '${key}': ${text}. Expected one of: ${spec.choices.join(', ')}`, { code: 'CONFIG.SUITE.OPTION_CHOICE' });
+        }
+    }
+}
+function validateRequired(key, spec, value) {
+    if (spec.required !== true || (value !== undefined && value !== ''))
+        return;
+    throw new ConfigurationError(`Missing required option '${key}'.`, {
+        code: 'CONFIG.SUITE.OPTION_REQUIRED',
+    });
+}
+function assignIfPresent(opts, key, value) {
+    if (value !== undefined)
+        opts[key] = value;
+}
+function stringifyOptionValue(value) {
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') {
+        return String(value);
+    }
+    if (value === null)
+        return 'null';
+    throw new ConfigurationError(`Invalid non-scalar value for option parsing.`, {
+        code: 'CONFIG.SUITE.OPTION_VALUE_TYPE',
+    });
+}
+//# sourceMappingURL=assemble-opts.js.map

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

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

package/dist/commands/history.d.ts

@@ -1,15 +1,11 @@
 /**
  * history command — show run history.
+ *
+ * The read-only list projection was re-homed into `@opensip-cli/session-store`
+ * (ADR-0084) so `@opensip-cli/mcp` can list runs without importing the
+ * composition root. This module is now a thin adapter: it re-exports the
+ * extracted function under the historical `showHistory` name so the command
+ * registration + tests are unchanged.
  */
-import type { HistoryResult } from '@opensip-cli/contracts';
-import type { ToolRegistry, ToolShortId } from '@opensip-cli/core';
-import type { DataStore } from '@opensip-cli/datastore';
-export interface ShowHistoryOptions {
-    readonly tool?: ToolShortId;
-    readonly limit?: number;
-    readonly summaryOnly?: boolean;
-    /** When set, session list displays canonical tool names. */
-    readonly registry?: ToolRegistry;
-}
-export declare function showHistory(datastore: DataStore, opts?: ShowHistoryOptions): HistoryResult;
+export { listSessionSummaries as showHistory, type ListSessionSummariesOptions as ShowHistoryOptions, } from '@opensip-cli/session-store';
 //# sourceMappingURL=history.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/commands/history.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAiC,MAAM,wBAAwB,CAAC;AAC3F,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;CAClC;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,GAAE,kBAAuB,GAAG,aAAa,CAS9F"}
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/commands/history.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,oBAAoB,IAAI,WAAW,EACnC,KAAK,2BAA2B,IAAI,kBAAkB,GACvD,MAAM,4BAA4B,CAAC"}

package/dist/commands/history.js

@@ -1,43 +1,11 @@
 /**
  * history command — show run history.
+ *
+ * The read-only list projection was re-homed into `@opensip-cli/session-store`
+ * (ADR-0084) so `@opensip-cli/mcp` can list runs without importing the
+ * composition root. This module is now a thin adapter: it re-exports the
+ * extracted function under the historical `showHistory` name so the command
+ * registration + tests are unchanged.
  */
-import { buildToolIdentityIndex } from '@opensip-cli/core';
-import { SessionRepo } from '@opensip-cli/session-store';
-export function showHistory(datastore, opts = {}) {
-    const repo = new SessionRepo(datastore);
-    const identityIndex = opts.registry === undefined ? undefined : buildToolIdentityIndex(opts.registry);
-    const sessions = repo.list(opts).map((s) => toHistorySession(s, opts.summaryOnly, identityIndex));
-    return {
-        type: 'history',
-        sessions,
-    };
-}
-function toHistorySession(session, summaryOnly = false, identityIndex) {
-    const summary = sessionSummary(session.payload);
-    const { payload, tool, ...rest } = session;
-    const displayTool = identityIndex === undefined ? tool : identityIndex.canonicalForStoredTool(tool);
-    return {
-        ...rest,
-        tool: displayTool,
-        ...(summaryOnly ? {} : { payload }),
-        ...(summary === undefined ? {} : { summary }),
-        showCommand: `opensip sessions show ${session.id} --json`,
-    };
-}
-function sessionSummary(payload) {
-    if (payload === null || typeof payload !== 'object')
-        return undefined;
-    const summary = payload.summary;
-    if (summary === null || typeof summary !== 'object')
-        return undefined;
-    const { total, passed, failed, errors, warnings } = summary;
-    if (typeof total !== 'number' ||
-        typeof passed !== 'number' ||
-        typeof failed !== 'number' ||
-        typeof errors !== 'number' ||
-        typeof warnings !== 'number') {
-        return undefined;
-    }
-    return { total, passed, failed, errors, warnings };
-}
+export { listSessionSummaries as showHistory, } from '@opensip-cli/session-store';
 //# sourceMappingURL=history.js.map

package/dist/commands/history.js.map

@@ -1 +1 @@
-{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/commands/history.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAczD,MAAM,UAAU,WAAW,CAAC,SAAoB,EAAE,OAA2B,EAAE;IAC7E,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,aAAa,GACjB,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;IAClG,OAAO;QACL,IAAI,EAAE,SAAS;QACf,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CACvB,OAAsB,EACtB,WAAW,GAAG,KAAK,EACnB,aAAyD;IAEzD,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAC3C,MAAM,WAAW,GACf,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAClF,OAAO;QACL,GAAG,IAAI;QACP,IAAI,EAAE,WAAW;QACjB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;QACnC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;QAC7C,WAAW,EAAE,yBAAyB,OAAO,CAAC,EAAE,SAAS;KAC1D,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,OAAgB;IACtC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACtE,MAAM,OAAO,GAAI,OAAiC,CAAC,OAAO,CAAC;IAC3D,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACtE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAkC,CAAC;IACvF,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,MAAM,KAAK,QAAQ;QAC1B,OAAO,MAAM,KAAK,QAAQ;QAC1B,OAAO,MAAM,KAAK,QAAQ;QAC1B,OAAO,QAAQ,KAAK,QAAQ,EAC5B,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACrD,CAAC"}
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/commands/history.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,oBAAoB,IAAI,WAAW,GAEpC,MAAM,4BAA4B,CAAC"}

package/dist/commands/host-subcommand-groups.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host-subcommand-groups.d.ts","sourceRoot":"","sources":["../../src/commands/host-subcommand-groups.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAG5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,YAAY,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,8BAA8B,CAAC;AAEtC;iDACiD;AACjD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;CACtC;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAA6C,CAAC;AAElG,gEAAgE;AAChE,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,kBAAkB,GAAG,SAAS,mBAAmB,EAAE,CAkBjG;AAsBD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;CACxE;AAED,qFAAqF;AACrF,wBAAgB,yBAAyB,IAAI,oBAAoB,CAMhE"}
+{"version":3,"file":"host-subcommand-groups.d.ts","sourceRoot":"","sources":["../../src/commands/host-subcommand-groups.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAI5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,YAAY,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,8BAA8B,CAAC;AAEtC;iDACiD;AACjD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;CACtC;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAK1C,CAAC;AAEX,gEAAgE;AAChE,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,kBAAkB,GAAG,SAAS,mBAAmB,EAAE,CAuBjG;AAsBD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;CACxE;AAED,qFAAqF;AACrF,wBAAgB,yBAAyB,IAAI,oBAAoB,CAMhE"}

package/dist/commands/host-subcommand-groups.js

@@ -19,6 +19,7 @@
  */
 import { buildConfigGroupLeaves } from './host-subcommand-config.js';
 import { buildSessionsGroupLeaves } from './host-subcommand-sessions.js';
+import { buildSuiteGroupLeaves } from './suite/suite-command-specs.js';
 import { buildToolsGroupLeaves } from './tools/index.js';
 export { effectiveCwd } from './host-subcommand-shared.js';
 export { buildToolPluginLeaves, buildToolPluginGroups, mountToolPluginGroups, } from './host-subcommand-plugins.js';
@@ -28,7 +29,12 @@ export { buildToolPluginLeaves, buildToolPluginGroups, mountToolPluginGroups, }
  * This is the FINITE, NAMED set the Phase 7 `command-surface-parity` guardrail
  * allow-lists as documented host exceptions. Every other host command IS a spec.
  */
-export const HOST_SUBCOMMAND_GROUPS = ['config', 'sessions', 'tools'];
+export const HOST_SUBCOMMAND_GROUPS = [
+    'config',
+    'sessions',
+    'suite',
+    'tools',
+];
 /** Build the subcommand-group parents with their leaf specs. */
 export function buildHostSubcommandGroups(ctx) {
     return [
@@ -42,6 +48,11 @@ export function buildHostSubcommandGroups(ctx) {
             description: 'Manage session data',
             leaves: buildSessionsGroupLeaves(ctx),
         },
+        {
+            name: 'suite',
+            description: 'Run configured tool suites',
+            leaves: buildSuiteGroupLeaves(ctx),
+        },
         {
             name: 'tools',
             description: 'Manage whole Tool plugins (list, validate, install, uninstall)',

package/dist/commands/host-subcommand-groups.js.map

@@ -1 +1 @@
-{"version":3,"file":"host-subcommand-groups.js","sourceRoot":"","sources":["../../src/commands/host-subcommand-groups.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAKzD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,GAEtB,MAAM,8BAA8B,CAAC;AAUtC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAsB,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAU,CAAC;AAElG,gEAAgE;AAChE,MAAM,UAAU,yBAAyB,CAAC,GAAuB;IAC/D,OAAO;QACL;YACE,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,6CAA6C;YAC1D,MAAM,EAAE,sBAAsB,CAAC,GAAG,CAAC;SACpC;QACD;YACE,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,qBAAqB;YAClC,MAAM,EAAE,wBAAwB,CAAC,GAAG,CAAC;SACtC;QACD;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,gEAAgE;YAC7E,MAAM,EAAE,qBAAqB,CAAC,GAAG,CAAC;SACnC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,aAAa,GAAuB;IACxC,WAAW,EAAE,GAAG,EAAE;QAChB,uDAAuD;IACzD,CAAC;IACD,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;IAC/B,QAAQ,EAAE,GAAG,EAAE;QACb,uDAAuD;IACzD,CAAC;IACD,OAAO,EAAE,GAAG,EAAE;QACZ,uDAAuD;IACzD,CAAC;IACD,SAAS,EAAE,GAAG,EAAE;QACd,uDAAuD;IACzD,CAAC;IACD,aAAa,EAAE,EAAE;IACjB,aAAa,EAAE,EAAE;IACjB,8HAA8H;IAC9H,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS;CAC3B,CAAC;AAMF,qFAAqF;AACrF,MAAM,UAAU,yBAAyB;IACvC,MAAM,gBAAgB,GAAsC,EAAE,CAAC;IAC/D,KAAK,MAAM,KAAK,IAAI,yBAAyB,CAAC,aAAa,CAAC,EAAE,CAAC;QAC7D,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"host-subcommand-groups.js","sourceRoot":"","sources":["../../src/commands/host-subcommand-groups.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAKzD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,GAEtB,MAAM,8BAA8B,CAAC;AAUtC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAsB;IACvD,QAAQ;IACR,UAAU;IACV,OAAO;IACP,OAAO;CACC,CAAC;AAEX,gEAAgE;AAChE,MAAM,UAAU,yBAAyB,CAAC,GAAuB;IAC/D,OAAO;QACL;YACE,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,6CAA6C;YAC1D,MAAM,EAAE,sBAAsB,CAAC,GAAG,CAAC;SACpC;QACD;YACE,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,qBAAqB;YAClC,MAAM,EAAE,wBAAwB,CAAC,GAAG,CAAC;SACtC;QACD;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,4BAA4B;YACzC,MAAM,EAAE,qBAAqB,CAAC,GAAG,CAAC;SACnC;QACD;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,gEAAgE;YAC7E,MAAM,EAAE,qBAAqB,CAAC,GAAG,CAAC;SACnC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,aAAa,GAAuB;IACxC,WAAW,EAAE,GAAG,EAAE;QAChB,uDAAuD;IACzD,CAAC;IACD,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;IAC/B,QAAQ,EAAE,GAAG,EAAE;QACb,uDAAuD;IACzD,CAAC;IACD,OAAO,EAAE,GAAG,EAAE;QACZ,uDAAuD;IACzD,CAAC;IACD,SAAS,EAAE,GAAG,EAAE;QACd,uDAAuD;IACzD,CAAC;IACD,aAAa,EAAE,EAAE;IACjB,aAAa,EAAE,EAAE;IACjB,8HAA8H;IAC9H,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS;CAC3B,CAAC;AAMF,qFAAqF;AACrF,MAAM,UAAU,yBAAyB;IACvC,MAAM,gBAAgB,GAAsC,EAAE,CAAC;IAC/D,KAAK,MAAM,KAAK,IAAI,yBAAyB,CAAC,aAAa,CAAC,EAAE,CAAC;QAC7D,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC9B,CAAC"}

package/dist/commands/mount-command-spec-wiring.d.ts

@@ -6,6 +6,7 @@
  */
 import { Option } from 'commander';
 import type { ArgSpec, OptionSpec } from '@opensip-cli/core';
+export { optionKey } from './assemble-opts.js';
 /**
  * Build a Commander {@link Option} from an {@link OptionSpec}, covering every
  * shape in the first-party flag corpus: boolean / value, negatable `--no-`,

package/dist/commands/mount-command-spec-wiring.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mount-command-spec-wiring.d.ts","sourceRoot":"","sources":["../../src/commands/mount-command-spec-wiring.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE7D;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CA+BzE;AAiBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAGpD"}
+{"version":3,"file":"mount-command-spec-wiring.d.ts","sourceRoot":"","sources":["../../src/commands/mount-command-spec-wiring.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAInC,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CA8BzE;AAiBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAGpD"}

package/dist/commands/mount-command-spec-wiring.js

@@ -5,6 +5,8 @@
  * independently from the host-owned command lifecycle.
  */
 import { Option } from 'commander';
+import { optionDefaultValue } from './assemble-opts.js';
+export { optionKey } from './assemble-opts.js';
 /**
  * Build a Commander {@link Option} from an {@link OptionSpec}, covering every
  * shape in the first-party flag corpus: boolean / value, negatable `--no-`,
@@ -29,11 +31,9 @@ export function buildOption(spec, commandName) {
     }
     // `arrayDefault` (repeatable accumulators) wins over a scalar `default`;
     // Commander uses it as the seed the `parse` reducer accumulates onto.
-    if (spec.arrayDefault !== undefined) {
-        option.default([...spec.arrayDefault]);
-    }
-    else if (spec.default !== undefined) {
-        option.default(spec.default);
+    const defaultValue = optionDefaultValue(spec);
+    if (defaultValue !== undefined) {
+        option.default(defaultValue);
     }
     if (spec.required === true) {
         if (valuePlaceholder === undefined) {

package/dist/commands/mount-command-spec-wiring.js.map

@@ -1 +1 @@
-{"version":3,"file":"mount-command-spec-wiring.js","sourceRoot":"","sources":["../../src/commands/mount-command-spec-wiring.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAInC;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,IAAgB,EAAE,WAAmB;IAC/D,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,gBAAgB,EAAE,CAAC;IAC9F,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAEnD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,qEAAqE;QACrE,yEAAyE;QACzE,iCAAiC;QACjC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,yEAAyE;IACzE,sEAAsE;IACtE,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IACzC,CAAC;SAAM,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACtC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC3B,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,8BAA8B,WAAW,aAAa,IAAI,CAAC,IAAI,oCAAoC;gBACjG,qCAAqC,CACxC,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,uBAAuB,CAAC,IAAgB;IAC/C,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC9C,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC/C,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,sEAAsE;QACtE,oDAAoD;QACpD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IACrE,OAAO,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"mount-command-spec-wiring.js","sourceRoot":"","sources":["../../src/commands/mount-command-spec-wiring.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAIxD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,IAAgB,EAAE,WAAmB;IAC/D,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,gBAAgB,EAAE,CAAC;IAC9F,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAEnD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,qEAAqE;QACrE,yEAAyE;QACzE,iCAAiC;QACjC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,yEAAyE;IACzE,sEAAsE;IACtE,MAAM,YAAY,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC3B,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,8BAA8B,WAAW,aAAa,IAAI,CAAC,IAAI,oCAAoC;gBACjG,qCAAqC,CACxC,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,uBAAuB,CAAC,IAAgB;IAC/C,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC9C,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC/C,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,sEAAsE;QACtE,oDAAoD;QACpD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IACrE,OAAO,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC;AAC9D,CAAC"}

package/dist/commands/session-show.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-show.d.ts","sourceRoot":"","sources":["../../src/commands/session-show.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGnE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAChD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,kGAAkG;IAClG,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC9C,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5C;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACpD,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC;CACzD;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoGvF"}
+{"version":3,"file":"session-show.d.ts","sourceRoot":"","sources":["../../src/commands/session-show.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGnE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAChD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,kGAAkG;IAClG,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC9C,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5C;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACpD,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC;CACzD;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgEvF"}

package/dist/commands/session-show.js

@@ -1,6 +1,6 @@
-import { applyAgentFilters, EXIT_CODES } from '@opensip-cli/contracts';
+import { EXIT_CODES } from '@opensip-cli/contracts';
 import { buildToolIdentityIndex, currentScope, SystemError } from '@opensip-cli/core';
-import { resolveSession } from '@opensip-cli/session-store';
+import { resolveAndReplaySession } from '@opensip-cli/session-store';
 import { SessionReplayRegistry } from '../session-replay-registry.js';
 export async function executeSessionShow(opts) {
     const scope = currentScope();
@@ -15,42 +15,23 @@ export async function executeSessionShow(opts) {
     }
     const registry = opts.registry ?? currentScope()?.tools;
     const identityIndex = registry === undefined ? undefined : buildToolIdentityIndex(registry);
-    const resolved = resolveSession(datastore, {
+    const replayRegistry = opts.replayRegistry ?? SessionReplayRegistry.empty();
+    // Resolve + replay + filter via the session-store read core (ADR-0084). The
+    // per-tool replay closure is injected from the host's replay registry (which
+    // carries the external-isolation gate); identity display + emission stay here.
+    const outcome = await resolveAndReplaySession(datastore, {
         ref: opts.ref,
         tool: opts.tool,
+        replayFor: (tool) => replayRegistry.get(tool)?.replaySession,
+        ...(opts.filters === undefined ? {} : { filters: opts.filters }),
     });
-    if (!resolved.ok) {
-        await emitSessionShowError(opts, resolved.reason, resolved.detail);
+    if (!outcome.ok) {
+        await emitSessionShowError(opts, outcome.reason, outcome.detail);
         return;
     }
-    const contribution = (opts.replayRegistry ?? SessionReplayRegistry.empty()).get(resolved.session.tool);
-    if (contribution === undefined) {
-        await emitSessionShowError(opts, 'replay-unavailable', `session replay is not available for ${resolved.session.tool}`);
-        return;
-    }
-    let replay;
-    try {
-        // ADR-0054 M4-F: replaySession may be ASYNC — a BUNDLED tool resolves
-        // synchronously (in-host closure); an EXTERNAL tool forks a hook worker (its
-        // runtime never runs in-host). Await covers both.
-        replay = await contribution.replaySession(resolved.session);
-    }
-    catch (error) {
-        // @handles — a corrupt/legacy stored payload is surfaced to the caller as a
-        // structured `decode-error` outcome (not swallowed); see emitSessionShowError.
-        await emitSessionShowError(opts, 'decode-error', error instanceof Error ? error.message : String(error));
-        return;
-    }
-    // Apply agent filters (Phase 1) *after* tool replay but before host emission.
-    // This keeps per-tool replays pure while enabling token-efficient, focused
-    // historical results for agents. The resulting envelope remains a valid
-    // (possibly filtered) SignalEnvelope.
-    const originalSignalCount = replay.envelope.signals.length;
-    const filteredReplay = opts.filters?.length
-        ? applyFiltersToReplay(resolved.session, replay, opts.filters)
-        : replay;
+    const { session, replay: filteredReplay, originalSignalCount } = outcome;
     if (opts.json === true) {
-        const jsonPayload = sessionShowJson(resolved.session, filteredReplay, opts.filters, originalSignalCount, identityIndex);
+        const jsonPayload = sessionShowJson(session, filteredReplay, opts.filters, originalSignalCount, identityIndex);
         if (opts.raw) {
             // Raw mode for agents: emit the core payload directly (bypassing the
             // standard CommandOutcome {kind, status, data, ...} wrapper). This gives
@@ -66,19 +47,11 @@ export async function executeSessionShow(opts) {
         opts.emitJson(jsonPayload);
         return;
     }
-    await opts.render(sessionReplayResult(resolved.session, filteredReplay, opts.filters, originalSignalCount, identityIndex));
+    await opts.render(sessionReplayResult(session, filteredReplay, opts.filters, originalSignalCount, identityIndex));
 }
 function canonicalToolForDisplay(tool, identityIndex) {
     return identityIndex === undefined ? tool : identityIndex.canonicalForStoredTool(tool);
 }
-/** Apply shared agent filters to a replay envelope (ADR-0085). */
-function applyFiltersToReplay(_session, replay, filters) {
-    const filtered = applyAgentFilters(replay.envelope, filters);
-    return {
-        ...replay,
-        envelope: filtered.envelope,
-    };
-}
 function agentFilterMeta(returnedSignalCount, filters, originalSignalCount) {
     if (!filters?.length || originalSignalCount == null)
         return {};