opensip-cli 0.1.6 → 0.1.7

package/dist/bootstrap/tool-lifecycle.d.ts

@@ -48,8 +48,6 @@
  * one ordered entry point. The driver is intentionally THIN: it sequences the
  * pre-existing helpers, it does not reimplement them.
  */
-import type { CliProgram } from '@opensip-cli/contracts';
-import type { ToolCliContext, ToolRegistry } from '@opensip-cli/core';
 /**
  * Canonical, ordered tool-lifecycle steps (launch, §5.4). The numeric
  * values are the step ordinals used in the JSDoc above and in
@@ -79,24 +77,4 @@ export declare const TOOL_LIFECYCLE_STEPS: {
     /** 10 — Commander dispatches the action body through the mount pipeline. */
     readonly dispatch: 10;
 };
-/**
- * Drive the STARTUP-phase command-mount step (step 8) for every registered
- * tool. By the time this runs, steps 1-4 have already populated `registry`
- * inside {@link bootstrapCli} (provenance no longer matters — bundled and
- * installed tools mount identically). This is the single ordered entry point
- * the composition root calls for step 8, replacing the bare
- * `mountAllToolCommands(...)` call so the lifecycle has one named seam.
- *
- * Kept THIN deliberately: it delegates straight to
- * {@link mountAllToolCommands}, which mounts each tool's declared `commandSpecs`
- * (the one command surface, launch) with per-tool failure isolation. The naming +
- * ordering is the value here, not new logic.
- *
- * @param registry The per-invocation tool registry, already populated by
- *   steps 1-4.
- * @param program The root Commander program (host-owned; passed in since the tool
- *   context no longer carries it, §8).
- * @param ctx The per-invocation handler context handed to each mounted command.
- */
-export declare function mountToolCommands(registry: ToolRegistry, program: CliProgram, ctx: ToolCliContext): void;
 //# sourceMappingURL=tool-lifecycle.d.ts.map

package/dist/bootstrap/tool-lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-lifecycle.d.ts","sourceRoot":"","sources":["../../src/bootstrap/tool-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtE;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB;IAC/B,oDAAoD;;IAEpD,mEAAmE;;IAEnE,0EAA0E;;IAE1E,uEAAuE;;IAEvE,+DAA+D;;IAE/D,sDAAsD;;IAEtD,gFAAgF;;IAEhF,mDAAmD;;IAEnD,0EAA0E;;IAE1E,4EAA4E;;CAEpE,CAAC;AAEX;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,cAAc,GAClB,IAAI,CAEN"}
+{"version":3,"file":"tool-lifecycle.d.ts","sourceRoot":"","sources":["../../src/bootstrap/tool-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB;IAC/B,oDAAoD;;IAEpD,mEAAmE;;IAEnE,0EAA0E;;IAE1E,uEAAuE;;IAEvE,+DAA+D;;IAE/D,sDAAsD;;IAEtD,gFAAgF;;IAEhF,mDAAmD;;IAEnD,0EAA0E;;IAE1E,4EAA4E;;CAEpE,CAAC"}

package/dist/bootstrap/tool-lifecycle.js

@@ -48,7 +48,6 @@
  * one ordered entry point. The driver is intentionally THIN: it sequences the
  * pre-existing helpers, it does not reimplement them.
  */
-import { mountAllToolCommands } from './register-tools.js';
 /**
  * Canonical, ordered tool-lifecycle steps (launch, §5.4). The numeric
  * values are the step ordinals used in the JSDoc above and in
@@ -78,26 +77,4 @@ export const TOOL_LIFECYCLE_STEPS = {
     /** 10 — Commander dispatches the action body through the mount pipeline. */
     dispatch: 10,
 };
-/**
- * Drive the STARTUP-phase command-mount step (step 8) for every registered
- * tool. By the time this runs, steps 1-4 have already populated `registry`
- * inside {@link bootstrapCli} (provenance no longer matters — bundled and
- * installed tools mount identically). This is the single ordered entry point
- * the composition root calls for step 8, replacing the bare
- * `mountAllToolCommands(...)` call so the lifecycle has one named seam.
- *
- * Kept THIN deliberately: it delegates straight to
- * {@link mountAllToolCommands}, which mounts each tool's declared `commandSpecs`
- * (the one command surface, launch) with per-tool failure isolation. The naming +
- * ordering is the value here, not new logic.
- *
- * @param registry The per-invocation tool registry, already populated by
- *   steps 1-4.
- * @param program The root Commander program (host-owned; passed in since the tool
- *   context no longer carries it, §8).
- * @param ctx The per-invocation handler context handed to each mounted command.
- */
-export function mountToolCommands(registry, program, ctx) {
-    mountAllToolCommands(registry, program, ctx);
-}
 //# sourceMappingURL=tool-lifecycle.js.map

package/dist/bootstrap/tool-lifecycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-lifecycle.js","sourceRoot":"","sources":["../../src/bootstrap/tool-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAK3D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,oDAAoD;IACpD,QAAQ,EAAE,CAAC;IACX,mEAAmE;IACnE,MAAM,EAAE,CAAC;IACT,0EAA0E;IAC1E,KAAK,EAAE,CAAC;IACR,uEAAuE;IACvE,MAAM,EAAE,CAAC;IACT,+DAA+D;IAC/D,MAAM,EAAE,CAAC;IACT,sDAAsD;IACtD,KAAK,EAAE,CAAC;IACR,gFAAgF;IAChF,YAAY,EAAE,CAAC;IACf,mDAAmD;IACnD,KAAK,EAAE,CAAC;IACR,0EAA0E;IAC1E,UAAU,EAAE,CAAC;IACb,4EAA4E;IAC5E,QAAQ,EAAE,EAAE;CACJ,CAAC;AAEX;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAsB,EACtB,OAAmB,EACnB,GAAmB;IAEnB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"tool-lifecycle.js","sourceRoot":"","sources":["../../src/bootstrap/tool-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,oDAAoD;IACpD,QAAQ,EAAE,CAAC;IACX,mEAAmE;IACnE,MAAM,EAAE,CAAC;IACT,0EAA0E;IAC1E,KAAK,EAAE,CAAC;IACR,uEAAuE;IACvE,MAAM,EAAE,CAAC;IACT,+DAA+D;IAC/D,MAAM,EAAE,CAAC;IACT,sDAAsD;IACtD,KAAK,EAAE,CAAC;IACR,gFAAgF;IAChF,YAAY,EAAE,CAAC;IACf,mDAAmD;IACnD,KAAK,EAAE,CAAC;IACR,0EAA0E;IAC1E,UAAU,EAAE,CAAC;IACb,4EAA4E;IAC5E,QAAQ,EAAE,EAAE;CACJ,CAAC"}

package/dist/bootstrap/validate-tool.d.ts

@@ -4,11 +4,12 @@
  * an arbitrary npm package and inspects whatever it exports.
  *
  * Verifies the minimal contract the registry depends on: a
- * `metadata.id` string (used for dedupe + listing), a `commands` array,
- * and a command surface — a non-empty `commandSpecs` array (the one command
+ * `metadata.id` string (used for dedupe + listing), and a command surface —
+ * a non-empty `commandSpecs` array (the one command
  * surface as of launch; `register()` was removed). A tool with no `commandSpecs`
- * cannot mount any command, so it fails the shape check. `initialize` and
- * `contributeScope` stay optional per the Tool interface.
+ * cannot mount any command, so it fails the shape check. Lifecycle hooks belong
+ * under `extensionPoints` only — top-level hooks are rejected with an actionable
+ * diagnostic.
  *
  * Ordering vs. the admission gate: this shape check runs AFTER a
  * tool's module is imported. The compatibility gate (`admitTool`) and the
@@ -18,5 +19,10 @@
  * and never reaches `isValidTool`.
  */
 import { type Tool } from '@opensip-cli/core';
+/**
+ * Human-readable rejection reason for an exported `tool` value.
+ * `undefined` means the export satisfies {@link isValidTool}.
+ */
+export declare function toolValidationFailure(value: unknown): string | undefined;
 export declare function isValidTool(value: unknown): value is Tool;
 //# sourceMappingURL=validate-tool.d.ts.map

package/dist/bootstrap/validate-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-tool.d.ts","sourceRoot":"","sources":["../../src/bootstrap/validate-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAuB,KAAK,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEnE,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAkBzD"}
+{"version":3,"file":"validate-tool.d.ts","sourceRoot":"","sources":["../../src/bootstrap/validate-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAuB,KAAK,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAuDnE;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAqBxE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAEzD"}

package/dist/bootstrap/validate-tool.js

@@ -4,11 +4,12 @@
  * an arbitrary npm package and inspects whatever it exports.
  *
  * Verifies the minimal contract the registry depends on: a
- * `metadata.id` string (used for dedupe + listing), a `commands` array,
- * and a command surface — a non-empty `commandSpecs` array (the one command
+ * `metadata.id` string (used for dedupe + listing), and a command surface —
+ * a non-empty `commandSpecs` array (the one command
  * surface as of launch; `register()` was removed). A tool with no `commandSpecs`
- * cannot mount any command, so it fails the shape check. `initialize` and
- * `contributeScope` stay optional per the Tool interface.
+ * cannot mount any command, so it fails the shape check. Lifecycle hooks belong
+ * under `extensionPoints` only — top-level hooks are rejected with an actionable
+ * diagnostic.
  *
  * Ordering vs. the admission gate: this shape check runs AFTER a
  * tool's module is imported. The compatibility gate (`admitTool`) and the
@@ -18,25 +19,78 @@
  * and never reaches `isValidTool`.
  */
 import { validateCommandSpec } from '@opensip-cli/core';
-export function isValidTool(value) {
-    if (typeof value !== 'object' || value === null)
-        return false;
+/** Top-level hook keys removed in the tool-author-simplify contract. */
+const LEGACY_TOP_LEVEL_HOOK_KEYS = [
+    'initialize',
+    'contributeScope',
+    'collectReportData',
+    'sessionReplay',
+    'config',
+    'capabilityRegistrars',
+    'fingerprintStrategy',
+    'scaffoldExamples',
+    'stableExampleIds',
+    'scaffoldConfigBlock',
+];
+function legacyTopLevelHookKeys(candidate) {
+    return LEGACY_TOP_LEVEL_HOOK_KEYS.filter((key) => candidate[key] !== undefined);
+}
+function metadataValidationFailure(metadata) {
+    if (typeof metadata !== 'object' || metadata === null) {
+        return 'tool.metadata is missing or not an object';
+    }
+    if (typeof metadata.id !== 'string') {
+        return 'tool.metadata.id must be a string';
+    }
+    return undefined;
+}
+function commandSpecsValidationFailure(commandSpecs) {
+    if (!Array.isArray(commandSpecs) || commandSpecs.length === 0) {
+        return 'tool.commandSpecs must be a non-empty array (the declarative command surface)';
+    }
+    for (const spec of commandSpecs) {
+        if (!validateCommandSpec(spec)) {
+            return 'tool.commandSpecs contains an invalid CommandSpec';
+        }
+    }
+    return undefined;
+}
+function optionalCommandsValidationFailure(commands) {
+    if (!Array.isArray(commands))
+        return undefined;
+    for (const cmd of commands) {
+        if (typeof cmd !== 'object' || cmd === null) {
+            return 'tool.commands contains a non-object entry';
+        }
+        if (typeof cmd.name !== 'string') {
+            return 'tool.commands entries must include a string name';
+        }
+    }
+    return undefined;
+}
+/**
+ * Human-readable rejection reason for an exported `tool` value.
+ * `undefined` means the export satisfies {@link isValidTool}.
+ */
+export function toolValidationFailure(value) {
+    if (typeof value !== 'object' || value === null) {
+        return 'tool export is not an object';
+    }
     const candidate = value;
-    if (typeof candidate.metadata !== 'object' || candidate.metadata === null)
-        return false;
-    if (typeof candidate.metadata.id !== 'string')
-        return false;
-    if (!Array.isArray(candidate.commands))
-        return false;
-    // A tool must expose a command surface: a non-empty declarative `commandSpecs`
-    // array (the one command surface, launch — `register()` was removed). A tool
-    // with no commandSpecs cannot contribute any command and is rejected.
-    if (!Array.isArray(candidate.commandSpecs) || candidate.commandSpecs.length === 0)
-        return false;
-    for (const spec of candidate.commandSpecs) {
-        if (!validateCommandSpec(spec))
-            return false;
+    const metadataFailure = metadataValidationFailure(candidate.metadata);
+    if (metadataFailure !== undefined)
+        return metadataFailure;
+    const legacy = legacyTopLevelHookKeys(candidate);
+    if (legacy.length > 0) {
+        return (`tool declares deprecated top-level hooks [${legacy.join(', ')}]; ` +
+            'move them under extensionPoints (see opensip tool authoring docs)');
     }
-    return true;
+    const specsFailure = commandSpecsValidationFailure(candidate.commandSpecs);
+    if (specsFailure !== undefined)
+        return specsFailure;
+    return optionalCommandsValidationFailure(candidate.commands);
+}
+export function isValidTool(value) {
+    return toolValidationFailure(value) === undefined;
 }
 //# sourceMappingURL=validate-tool.js.map

package/dist/bootstrap/validate-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate-tool.js","sourceRoot":"","sources":["../../src/bootstrap/validate-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,mBAAmB,EAAa,MAAM,mBAAmB,CAAC;AAEnE,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,SAAS,GAAG,KAIjB,CAAC;IACF,IAAI,OAAO,SAAS,CAAC,QAAQ,KAAK,QAAQ,IAAI,SAAS,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACxF,IAAI,OAAQ,SAAS,CAAC,QAA6B,CAAC,EAAE,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,+EAA+E;IAC/E,6EAA6E;IAC7E,sEAAsE;IACtE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,SAAS,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAChG,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,YAAY,EAAE,CAAC;QAC1C,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;IAC/C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"validate-tool.js","sourceRoot":"","sources":["../../src/bootstrap/validate-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,mBAAmB,EAAa,MAAM,mBAAmB,CAAC;AAEnE,wEAAwE;AACxE,MAAM,0BAA0B,GAAG;IACjC,YAAY;IACZ,iBAAiB;IACjB,mBAAmB;IACnB,eAAe;IACf,QAAQ;IACR,sBAAsB;IACtB,qBAAqB;IACrB,kBAAkB;IAClB,kBAAkB;IAClB,qBAAqB;CACb,CAAC;AAEX,SAAS,sBAAsB,CAAC,SAAkC;IAChE,OAAO,0BAA0B,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC;AAClF,CAAC;AAED,SAAS,yBAAyB,CAAC,QAAiB;IAClD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtD,OAAO,2CAA2C,CAAC;IACrD,CAAC;IACD,IAAI,OAAQ,QAA6B,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC1D,OAAO,mCAAmC,CAAC;IAC7C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,6BAA6B,CAAC,YAAqB;IAC1D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9D,OAAO,+EAA+E,CAAC;IACzF,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,OAAO,mDAAmD,CAAC;QAC7D,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,iCAAiC,CAAC,QAAiB;IAC1D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/C,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC5C,OAAO,2CAA2C,CAAC;QACrD,CAAC;QACD,IAAI,OAAQ,GAA0B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACzD,OAAO,kDAAkD,CAAC;QAC5D,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,8BAA8B,CAAC;IACxC,CAAC;IACD,MAAM,SAAS,GAAG,KAAgC,CAAC;IAEnD,MAAM,eAAe,GAAG,yBAAyB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACtE,IAAI,eAAe,KAAK,SAAS;QAAE,OAAO,eAAe,CAAC;IAE1D,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,CACL,6CAA6C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;YACnE,mEAAmE,CACpE,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,6BAA6B,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IAC3E,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO,YAAY,CAAC;IAEpD,OAAO,iCAAiC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,qBAAqB,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC;AACpD,CAAC"}

package/dist/cli-context.d.ts

@@ -17,10 +17,10 @@
  * `.runtime/datastore.sqlite`.
  */
 import { type Logger, type ToolCliContext } from '@opensip-cli/core';
-import { type LiveViewRegistry } from './bootstrap/live-plane.js';
+import { type LiveViewRegistry } from './bootstrap/io-plane.js';
 import type { CommandResult } from '@opensip-cli/contracts';
 export { buildDatastoreThunk, getCurrentProjectRoot, getOrOpenDatastore, } from './bootstrap/scope-access.js';
-export { createLiveViewRegistry, type LiveViewRegistry } from './bootstrap/live-plane.js';
+export { createLiveViewRegistry, type LiveViewRegistry } from './bootstrap/io-plane.js';
 export interface BuildToolCliContextOptions {
     readonly render: (result: CommandResult) => Promise<void>;
     readonly liveViews: LiveViewRegistry;

package/dist/cli-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-context.d.ts","sourceRoot":"","sources":["../src/cli-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAGL,KAAK,MAAM,EACX,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAWnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAsB5D,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE1F,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE;QAC/B,aAAa,EAAE,OAAO,CAAC;QACvB,UAAU,EAAE,OAAO,CAAC;KACrB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CAChD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,0BAA0B,GAAG,oBAAoB,CA2F1F"}
+{"version":3,"file":"cli-context.d.ts","sourceRoot":"","sources":["../src/cli-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAGL,KAAK,MAAM,EACX,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAW/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAmB5D,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAExF,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE;QAC/B,aAAa,EAAE,OAAO,CAAC;QACvB,UAAU,EAAE,OAAO,CAAC;KACrB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CAChD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,0BAA0B,GAAG,oBAAoB,CAgF1F"}

package/dist/cli-context.js

@@ -18,15 +18,12 @@
  */
 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 { createIoPlane } from './bootstrap/io-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 { createDatastoreResolver, 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.
 //
@@ -40,11 +37,11 @@ const MODULE_TAG = 'cli:context';
 // `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
+// live-view registry lives in `bootstrap/io-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 { createLiveViewRegistry } from './bootstrap/io-plane.js';
 export function buildToolCliContext(opts) {
     const log = opts.logger ?? defaultLogger;
     // Output plane owns the single `process.exitCode` write path + the four
@@ -56,34 +53,16 @@ export function buildToolCliContext(opts) {
     //  - 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 });
+    const projectDatastore = createDatastoreResolver('project-seam', log);
+    const baselineSeams = buildBaselineSeams({ getDatastore: projectDatastore, logger: log });
+    const stateSeams = buildStateSeams({ getDatastore: projectDatastore });
+    const hostPlanes = buildHostPlanes({ getDatastore: projectDatastore, 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;
-            }
-        },
+        getDatastore: createDatastoreResolver('best-effort', log),
         logger: log,
     });
     // Public run seam (display-only timing) + internal action hooks (the mount
@@ -95,7 +74,13 @@ export function buildToolCliContext(opts) {
     // 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 ioPlane = createIoPlane({
+        setExitCode: outputPlane.setExitCode,
+        logger: log,
+        liveViews: opts.liveViews,
+        runPlane,
+        runSession,
+    });
     const ctx = {
         get scope() {
             // The pre-action-hook (or explicit runWithScope in tests) enters the
@@ -105,14 +90,14 @@ export function buildToolCliContext(opts) {
             return readScope();
         },
         render: (result) => opts.render(result),
-        registerLiveView: livePlane.register,
-        renderLive: livePlane.renderLive,
+        registerLiveView: ioPlane.register,
+        renderLive: ioPlane.renderLive,
         maybeOpenReport: opts.maybeOpenReport,
         logger: log,
         setExitCode: outputPlane.setExitCode,
         ...outputPlane.emits, // emitJson / emitEnvelope / emitError / emitRaw
-        deliverSignals: egressPlane.deliverSignals,
-        writeSarif: egressPlane.writeSarif,
+        deliverSignals: ioPlane.deliverSignals,
+        writeSarif: ioPlane.writeSarif,
         // Host baseline/ratchet plane seams (ADR-0036) — persistence + diff + exports.
         saveBaseline: baselineSeams.saveBaseline,
         compareBaseline: baselineSeams.compareBaseline,

package/dist/cli-context.js.map

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

@@ -7,7 +7,28 @@
  *
  * Future: can be made more dynamic by introspecting live CommandSpecs
  * (see completion.ts for precedent).
+ *
+ * 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).
+ * In Phase 0 no tool declares `parent`/`visibility`, so the static catalog below
+ * already satisfies both rules (no nested verb, no internal worker is listed).
+ */
+/**
+ * The command-taxonomy tier an entry point belongs to
+ * (tool-command-surface-taxonomy). `'platform'` = host-owned Tier-1 commands
+ * (`init`, `sessions`, `agent-catalog`, …); `'tool'` = a Tier-2 tool verb
+ * (`fit`, `graph`, `sim`, and their `<tool> <verb>` sub-verbs). `'internal'`
+ * (Tier-3 workers) is part of the union for completeness ONLY — the agent-catalog
+ * NEVER emits an `internal` entry point (its primary surface excludes Tier-3).
  */
+export type CommandTier = 'platform' | 'tool' | 'internal';
 export interface AgentCatalog {
     readonly version: string;
     readonly description: string;
@@ -15,6 +36,14 @@ export interface AgentCatalog {
         readonly command: string;
         readonly description: string;
         readonly examples: readonly string[];
+        /**
+         * Taxonomy tier of this entry point (tool-command-surface-taxonomy). Additive
+         * (optional) so existing consumers of the `entryPoints` shape are unaffected;
+         * present on every entry the catalog ships so an agent sees the predictable
+         * Tier-1/Tier-2 structure. NEVER `'internal'` — Tier-3 is excluded from this
+         * surface by construction (see {@link assertNoInternalEntryPoints}).
+         */
+        readonly tier?: CommandTier;
     }[];
     readonly commonPatterns: readonly {
         readonly name: string;

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

@@ -1 +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"}
+{"version":3,"file":"agent-catalog.d.ts","sourceRoot":"","sources":["../../src/commands/agent-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;AAE3D,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;QACrC;;;;;;WAMG;QACH,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;KAC7B,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;AAkCD,wBAAgB,iBAAiB,IAAI,YAAY,CA8GhD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO;;;;;;;;;;EA8BhE"}

package/dist/commands/agent-catalog.js

@@ -1,45 +1,82 @@
+/**
+ * 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/;
+/**
+ * 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.');
+    }
+}
 export function buildAgentCatalog() {
+    // tool-command-surface-taxonomy Task 1.4: every entry point is annotated with
+    // its taxonomy `tier` so an agent sees the predictable Tier-1/Tier-2 shape, and
+    // NO Tier-3 internal worker is catalogued. The static list below is the
+    // primary surface; `assertNoInternalEntryPoints` guards (by construction)
+    // against a future edit pasting an internal command in (the Phase 4 test
+    // also asserts this).
+    const 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'],
+            tier: 'tool',
+        },
+        {
+            command: 'graph',
+            description: 'Build static call graph + rules. --json yields SignalEnvelope.',
+            examples: ['opensip graph --json', 'opensip graph --sarif out.sarif'],
+            tier: 'tool',
+        },
+        {
+            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',
+            ],
+            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 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',
+            ],
+            tier: 'platform',
+        },
+        {
+            command: 'agent-catalog',
+            description: 'This command. Self-describing catalog for agents (JSON preferred).',
+            examples: ['opensip agent-catalog --json'],
+            tier: 'platform',
+        },
+    ];
+    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: [
-            {
-                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'],
-            },
-        ],
+        entryPoints,
         commonPatterns: [
             {
                 name: 'Inspect latest fit with focus on errors',
@@ -73,6 +110,10 @@ export function buildAgentCatalog() {
             '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 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,

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

@@ -1 +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"}
+{"version":3,"file":"agent-catalog.js","sourceRoot":"","sources":["../../src/commands/agent-catalog.ts"],"names":[],"mappings":"AA6DA;;;;;GAKG;AACH,MAAM,wBAAwB,GAAG,oDAAoD,CAAC;AAEtF;;;;;;;;;GASG;AACH,SAAS,2BAA2B,CAClC,WAAiF;IAEjF,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAC7B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CACzE,CAAC;IACF,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,2CAA2C,MAAM,CAAC,OAAO,2BAA2B;YAClF,4FAA4F,CAC/F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,8EAA8E;IAC9E,gFAAgF;IAChF,wEAAwE;IACxE,0EAA0E;IAC1E,yEAAyE;IACzE,sBAAsB;IACtB,MAAM,WAAW,GAAG;QAClB;YACE,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,qEAAqE;YAClF,QAAQ,EAAE,CAAC,qCAAqC,EAAE,uCAAuC,CAAC;YAC1F,IAAI,EAAE,MAAe;SACtB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,WAAW,EAAE,gEAAgE;YAC7E,QAAQ,EAAE,CAAC,sBAAsB,EAAE,iCAAiC,CAAC;YACrE,IAAI,EAAE,MAAe;SACtB;QACD;YACE,OAAO,EAAE,eAAe;YACxB,WAAW,EAAE,gFAAgF;YAC7F,QAAQ,EAAE;gBACR,6CAA6C;gBAC7C,mDAAmD;aACpD;YACD,IAAI,EAAE,UAAmB;SAC1B;QACD;YACE,OAAO,EAAE,eAAe;YACxB,WAAW,EACT,mFAAmF;gBACnF,8CAA8C;YAChD,QAAQ,EAAE;gBACR,gDAAgD;gBAChD,qFAAqF;gBACrF,gDAAgD;gBAChD,oDAAoD;aACrD;YACD,IAAI,EAAE,UAAmB;SAC1B;QACD;YACE,OAAO,EAAE,eAAe;YACxB,WAAW,EAAE,oEAAoE;YACjF,QAAQ,EAAE,CAAC,8BAA8B,CAAC;YAC1C,IAAI,EAAE,UAAmB;SAC1B;KACF,CAAC;IACF,2BAA2B,CAAC,WAAW,CAAC,CAAC;IACzC,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,WAAW,EACT,oEAAoE;YACpE,kFAAkF;YAClF,oDAAoD;QACtD,WAAW;QACX,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,uEAAuE;YACvE,yFAAyF;gBACvF,2FAA2F;gBAC3F,iFAAiF;YACnF,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/clear.d.ts.map

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

@@ -11,7 +11,6 @@
  * 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) {

package/dist/commands/clear.js.map

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