opensip-cli 0.1.10 → 0.1.12

package/dist/commands/host-command-specs.js

@@ -1,34 +1,10 @@
 /**
- * host-command-specs — the CLI-owned (host) commands expressed as declarative
- * {@link CommandSpec}s, mounted through the SAME `mountCommandSpec` plane the
- * tools use (launch Phase 6).
- *
- * Host commands (`init` / `configure` / `sessions` / `report` / `completion` /
- * `uninstall` / `tools`) are NOT tool plugins — they don't ride on a
- * `Tool.commandSpecs` and aren't discovered. Mounting them via the same
- * `mountCommandSpec` means the Phase 7 `command-surface-parity` guardrail sees
- * ONE uniform command surface: no second, more-privileged raw-Commander path for
- * "blessed" CLI-owned commands. The pack-management `plugin {add,list,remove,
- * sync}` ops are host-owned too, but mount UNDER each pack-supporting tool
- * primary (`opensip fit plugin …`) via {@link mountToolPluginGroups} — there is
- * no top-level `opensip plugin`.
- *
- * Each spec's handler closes over the per-invocation {@link CliCommandsContext}
- * (render / setExitCode / datastore thunk / pluginLayouts). The mount layer only
- * reaches for `render` / `setExitCode` (the `command-result` + thrown-`ToolError`
- * arms) — the `signal-envelope` / `live-view` arms are never exercised by a host
- * command, so `CliCommandsContext` is a valid (leaner) `CommandMountContext`.
- *
- * The action-less subcommand GROUPS (`sessions`, `tools`) + the domain-bound
- * per-tool `plugin` group leaves (and {@link mountToolPluginGroups}) live in
- * `host-subcommand-groups.ts` (a leaf module that lets `completion.ts` source its
- * sub-subcommand names without a cycle). This module assembles the TOP-LEVEL
- * specs and mounts the whole surface.
- *
- * Specs are built per-invocation (in the builders below, not at module load) so
- * the `--cwd` defaults that resolve to `process.cwd()` are evaluated fresh each
- * run — byte-identical to the former `.option(spec, desc, process.cwd())`
- * registrars.
+ * host-command-specs — CLI-owned commands as declarative {@link CommandSpec}s,
+ * mounted via the same `mountCommandSpec` plane as tools (Phase 6/7 parity).
+ * Host commands (`init`, `configure`, `sessions`, `report`, `completion`,
+ * `uninstall`, `tools`) are not tool plugins. Action-less groups and per-tool
+ * `plugin` leaves live in `host-subcommand-groups.ts`; this module assembles
+ * top-level specs. Built per-invocation so `--cwd` defaults stay fresh.
  */
 import { EXIT_CODES } from '@opensip-cli/contracts';
 import { ConfigurationError, defineCommand } from '@opensip-cli/core';
@@ -306,8 +282,9 @@ function buildHostCompletionSurface(ctx) {
     return {
         specs: [...buildNonCompletionHostSpecs(ctx), COMPLETION_SELF_SPEC],
         groups: buildHostSubcommandGroups(ctx),
-        toolPluginGroups: buildToolPluginGroups(ctx).map((g) => ({
-            toolVerb: g.toolVerb,
+        toolPluginGroups: buildToolPluginGroups(ctx, ctx.tools).map((g) => ({
+            parentVerb: g.parentVerb,
+            parentAliases: g.parentAliases,
             leaves: g.leaves.map((l) => ({ name: l.name })),
         })),
     };
@@ -352,6 +329,6 @@ export function mountHostCommands(program, ctx) {
             mountCommandSpec(parent, leaf, ctx);
         }
     }
-    mountToolPluginGroups(program, ctx);
+    mountToolPluginGroups(program, ctx, ctx.tools);
 }
 //# sourceMappingURL=host-command-specs.js.map

package/dist/commands/host-command-specs.js.map

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

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

@@ -13,61 +13,15 @@
  * leaves + inventory here (a module that imports NEITHER `completion.ts` nor
  * `host-command-specs.ts`) lets both depend on this leaf module without a cycle.
  *
- * The two parents are action-less GROUPS — a parent with no action body is not
- * a single mountable `CommandSpec`, so it stays a raw `program.command(name)`
- * shell (the FINITE, NAMED documented exceptions for the Phase 7
- * `command-surface-parity` guardrail's allow-list, see {@link HOST_SUBCOMMAND_GROUPS}).
- * Their LEAVES (`sessions list|purge`, `tools list|install|…`) ARE specs.
- *
- * The PACK-management `plugin {add,list,remove,sync}` ops are NO LONGER a
- * top-level group: they mount as a `plugin` group UNDER each pack-supporting
- * tool primary (`opensip fit plugin …`, `opensip sim plugin …`) via
- * `mountToolPluginGroups`, with the domain pre-bound from the tool (no
- * `--domain` flag). Whole Tool plugins remain `opensip tools …`.
+ * Leaf specs are split across `host-subcommand-sessions.ts` and
+ * `host-subcommand-plugins.ts` to stay under the file-length-limit; this module
+ * remains the cycle-free assembly + inventory surface.
  */
-import { type CommandSpec, type ProjectContext } from '@opensip-cli/core';
+import { type HostSpec } from './host-subcommand-shared.js';
 import type { CliCommandsContext } from './shared.js';
-import type { CliProgram } from '@opensip-cli/contracts';
-/** A host command spec — handler receives the {@link CliCommandsContext}. */
-export type HostSpec = CommandSpec<unknown, CliCommandsContext>;
-/** Prefer the discovered project root; fall back to literal cwd; finally process.cwd(). */
-export declare function effectiveCwd(opts: {
-    cwd?: string;
-    projectContext?: ProjectContext;
-}): string;
-/**
- * Build the four domain-bound `plugin` leaf specs for ONE pack-supporting tool
- * (`add`/`list`/`remove`/`sync`, all scoped to `domain`). Shared by the mount
- * path (`mountToolPluginGroups`), the command-scope index, and the completion
- * inventory so the three derive the SAME leaves.
- */
-export declare function buildToolPluginLeaves(ctx: CliCommandsContext, domain: string): readonly HostSpec[];
-/** One pack-supporting tool's `plugin` group: the tool's primary verb + the
- *  action-less `plugin` parent + the four domain-bound leaves. */
-export interface ToolPluginGroup {
-    /** The tool primary verb the `plugin` group mounts under (`fit`/`sim`). */
-    readonly toolVerb: string;
-    /** The plugin domain (== `toolVerb` for the pack-supporting tools). */
-    readonly domain: string;
-    readonly description: string;
-    readonly leaves: readonly HostSpec[];
-}
-/**
- * Derive the per-tool `plugin` groups from the host's contributed
- * `pluginLayouts` — one group per pack-supporting domain (fit/sim). A tool with
- * no `pluginLayout` (e.g. `graph`) contributes none, so it gets no `plugin`
- * group. The single source the mount path + scope index + completion all read.
- */
-export declare function buildToolPluginGroups(ctx: CliCommandsContext): readonly ToolPluginGroup[];
-/**
- * Mount each per-tool `plugin` group UNDER its pack-supporting tool primary
- * (`opensip fit plugin …`), domain pre-bound from the tool. The host derives the
- * groups from the contributed `pluginLayouts` (fit/sim; graph has none, so no
- * group). The tool primary must already be mounted — it is, because the
- * composition root mounts tools before the host commands; a domain whose primary
- * is absent (isolated host-only tests) is skipped (nowhere to hang it).
- */
-export declare function mountToolPluginGroups(program: CliProgram, ctx: CliCommandsContext): void;
+export type { HostSpec } from './host-subcommand-shared.js';
+export { effectiveCwd } from './host-subcommand-shared.js';
+export { buildToolPluginLeaves, buildToolPluginGroups, mountToolPluginGroups, type ToolPluginGroup, } from './host-subcommand-plugins.js';
 /** One subcommand-group parent: a raw action-less `program.command(name)`
  *  shell + the leaf specs that mount onto it. */
 export interface HostSubcommandGroup {
@@ -82,27 +36,9 @@ export interface HostSubcommandGroup {
  * allow-lists as documented host exceptions. Every other host command IS a spec.
  */
 export declare const HOST_SUBCOMMAND_GROUPS: readonly string[];
-/**
- * Build the subcommand-group parents with their leaf specs. The mounter turns
- * each into a raw parent `program.command(name)` plus `mountCommandSpec(parent,
- * leaf)` for each leaf.
- */
+/** Build the subcommand-group parents with their leaf specs. */
 export declare function buildHostSubcommandGroups(ctx: CliCommandsContext): readonly HostSubcommandGroup[];
-/**
- * The host subcommand-group NAME inventory derived from the live leaf specs —
- * the single source the shell-completion script (`completion.ts`) reads for the
- * `plugin` / `sessions` sub-subcommand names instead of a second hand-maintained
- * list (Phase 6 Task 6.2).
- *
- * NOTE: only the NAME lists are sourced here — the curated per-command flag
- * subsets the completion script offers stay in `completion.ts`, since
- * exhaustively deriving every declared flag would change the emitted script. The
- * common flags themselves already derive from the shared ADR-0021 registry (the
- * same registry the specs' `commonFlags` resolve through), so that half is
- * already single-sourced.
- */
 export interface HostCommandInventory {
-    /** Sub-subcommand names per group (`{ sessions: ['list','purge'], plugin: [...] }`). */
     readonly groupSubcommands: Readonly<Record<string, readonly string[]>>;
 }
 /** Build the host subcommand-group name inventory (single source for completion). */

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":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EAKL,KAAK,WAAW,EAEhB,KAAK,cAAc,EAEpB,MAAM,mBAAmB,CAAC;AAS3B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGzD,6EAA6E;AAC7E,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;AAWhE,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,cAAc,CAAA;CAAE,GAAG,MAAM,CAE5F;AAyVD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,kBAAkB,EACvB,MAAM,EAAE,MAAM,GACb,SAAS,QAAQ,EAAE,CAOrB;AAED;kEACkE;AAClE,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;CACtC;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,kBAAkB,GAAG,SAAS,eAAe,EAAE,CAOzF;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,kBAAkB,GAAG,IAAI,CASxF;AAMD;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,EAAmC,CAAC;AAExF;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,kBAAkB,GAAG,SAAS,mBAAmB,EAAE,CAajG;AA4BD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,oBAAoB;IACnC,wFAAwF;IACxF,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;AAGH,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,EAAmC,CAAC;AAExF,gEAAgE;AAChE,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,kBAAkB,GAAG,SAAS,mBAAmB,EAAE,CAajG;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

@@ -1,4 +1,3 @@
-// @fitness-ignore-file file-length-limit -- deliberate single cycle-free leaf module: it houses BOTH host subcommand groups' leaf specs (sessions + tools) AND the per-tool `plugin` group leaves + the completion inventory together specifically because it must import neither completion.ts nor host-command-specs.ts (see header — splitting would reintroduce the module cycle this file exists to break). Cohesive by design; grew past the 400-line soft limit with the per-leaf CommandSpec builders.
 /**
  * host-subcommand-groups — the action-less Commander subcommand GROUPS
  * (`sessions`, `tools`) and their leaf {@link CommandSpec}s, PLUS the
@@ -14,394 +13,14 @@
  * leaves + inventory here (a module that imports NEITHER `completion.ts` nor
  * `host-command-specs.ts`) lets both depend on this leaf module without a cycle.
  *
- * The two parents are action-less GROUPS — a parent with no action body is not
- * a single mountable `CommandSpec`, so it stays a raw `program.command(name)`
- * shell (the FINITE, NAMED documented exceptions for the Phase 7
- * `command-surface-parity` guardrail's allow-list, see {@link HOST_SUBCOMMAND_GROUPS}).
- * Their LEAVES (`sessions list|purge`, `tools list|install|…`) ARE specs.
- *
- * The PACK-management `plugin {add,list,remove,sync}` ops are NO LONGER a
- * top-level group: they mount as a `plugin` group UNDER each pack-supporting
- * tool primary (`opensip fit plugin …`, `opensip sim plugin …`) via
- * `mountToolPluginGroups`, with the domain pre-bound from the tool (no
- * `--domain` flag). Whole Tool plugins remain `opensip tools …`.
+ * Leaf specs are split across `host-subcommand-sessions.ts` and
+ * `host-subcommand-plugins.ts` to stay under the file-length-limit; this module
+ * remains the cycle-free assembly + inventory surface.
  */
-import { EXIT_CODES } from '@opensip-cli/contracts';
-import { currentScope, defineCommand, registeredToolShortIds, } from '@opensip-cli/core';
-import { executeClear } from './clear.js';
-import { showHistory } from './history.js';
-import { mountCommandSpec } from './mount-command-spec.js';
-import { pluginAdd, pluginList, pluginRemove, pluginSync } from './plugin.js';
-import { executeSessionShow } from './session-show.js';
+import { buildSessionsGroupLeaves } from './host-subcommand-sessions.js';
 import { buildToolsGroupLeaves } from './tools/index.js';
-/** Every grouped leaf needs the entered project scope (datastore / project
- *  context). Named once so the discriminant isn't restated per spec. */
-const PROJECT_SCOPE = 'project';
-/** The `command-result` output mode, named once (the leaves all share it). */
-const COMMAND_RESULT = 'command-result';
-const RAW_STREAM = 'raw-stream';
-/** Prefer the discovered project root; fall back to literal cwd; finally process.cwd(). */
-export function effectiveCwd(opts) {
-    return opts.projectContext?.projectRoot ?? opts.cwd ?? process.cwd();
-}
-// ---------------------------------------------------------------------------
-// sessions list / purge
-// ---------------------------------------------------------------------------
-/**
- * Validate a user-supplied `--tool` filter against the live tool registry (M3).
- *
- * The session/persistence discriminant is the OPEN `ToolShortId`, so a
- * registered third-party tool's id is a legitimate filter — the former static
- * `choices: ['fit','graph','sim']` Commander enum re-closed that set and denied
- * third-party tools session-list parity. Membership is therefore validated at
- * RUNTIME against the per-run `ToolRegistry` (always entered for host commands)
- * rather than a compile-time enum. Returns `undefined` (valid) or an error
- * detail the caller emits.
- */
-function validateToolFilter(tool) {
-    if (tool === undefined)
-        return undefined;
-    const registry = currentScope()?.tools;
-    // No registry (isolated tests): fall back to accepting any non-empty id — the
-    // datastore simply returns rows for that discriminant (empty when none).
-    if (registry === undefined)
-        return undefined;
-    // Membership against the registry's session short ids (the set the
-    // `isRegisteredToolId` guard reads); used directly here so the unknown-id
-    // branch keeps `tool` typed as the original string for the message below.
-    const known = registeredToolShortIds(registry);
-    if (known.has(tool))
-        return undefined;
-    const knownList = [...known].sort();
-    return {
-        code: 'unknown-tool',
-        message: `unknown tool '${tool}'` +
-            (knownList.length > 0 ? `; registered tools: ${knownList.join(', ')}` : ''),
-    };
-}
-function buildSessionsListSpec(ctx) {
-    return defineCommand({
-        name: 'list',
-        description: 'List stored sessions',
-        commonFlags: ['json'],
-        options: [
-            {
-                flag: '--tool',
-                value: '<name>',
-                description: 'Filter to one tool (any registered tool id)',
-            },
-            {
-                flag: '--limit',
-                value: '<n>',
-                description: 'Maximum sessions to return',
-                parse: parsePositiveInt,
-            },
-            {
-                flag: '--summary-only',
-                description: 'Omit heavy per-session payloads (agent friendly; showCommand and lightweight summary remain). ' +
-                    'Pairs well with --json for lean "menu" of historical results.',
-            },
-        ],
-        scope: PROJECT_SCOPE,
-        output: COMMAND_RESULT,
-        handler: (rawOpts) => {
-            const opts = rawOpts;
-            const invalid = validateToolFilter(opts.tool);
-            if (invalid) {
-                ctx.setExitCode(EXIT_CODES.CONFIGURATION_ERROR);
-                return {
-                    type: 'error',
-                    message: invalid.message,
-                    exitCode: EXIT_CODES.CONFIGURATION_ERROR,
-                };
-            }
-            return showHistory(ctx.datastore(), {
-                tool: opts.tool,
-                limit: opts.limit,
-                summaryOnly: !!opts.summaryOnly,
-            });
-        },
-    });
-}
-function buildSessionsShowSpec(ctx) {
-    return defineCommand({
-        name: 'show',
-        description: 'Display a stored session result',
-        commonFlags: ['json'],
-        args: [{ name: 'ref', description: 'Session id, or latest with --tool' }],
-        options: [
-            {
-                flag: '--tool',
-                value: '<name>',
-                description: 'Tool for latest, or an optional id sanity check (any registered tool id)',
-            },
-            {
-                flag: '--filter',
-                value: '<type>',
-                description: 'Filter replayed signals (repeatable): errors-only | warnings-only | top:<n>. ' +
-                    'Composable, e.g. --filter errors-only --filter top:20. Agent ergonomics for historical results.',
-                arrayDefault: [],
-                parse: (val, prev) => [...prev, val],
-            },
-            {
-                flag: '--raw',
-                description: 'With --json: emit the inner payload (session + envelope + metadata) without the outer CommandResult wrapper. ' +
-                    'Ideal for agents that want the smallest possible response.',
-            },
-        ],
-        scope: PROJECT_SCOPE,
-        output: RAW_STREAM,
-        rawStreamReason: 'session-replay',
-        handler: async (rawOpts) => {
-            const opts = rawOpts;
-            const ref = opts._args[0];
-            const invalid = validateToolFilter(opts.tool);
-            if (invalid) {
-                if (opts.json === true) {
-                    ctx.emitError({
-                        message: invalid.message,
-                        exitCode: EXIT_CODES.CONFIGURATION_ERROR,
-                        code: invalid.code,
-                    });
-                    return;
-                }
-                ctx.setExitCode(EXIT_CODES.CONFIGURATION_ERROR);
-                await ctx.render({
-                    type: 'error',
-                    message: invalid.message,
-                    exitCode: EXIT_CODES.CONFIGURATION_ERROR,
-                });
-                return;
-            }
-            const filters = normalizeFilterOption(opts.filter);
-            await executeSessionShow({
-                replayRegistry: ctx.sessionReplayRegistry,
-                ref,
-                tool: opts.tool,
-                json: opts.json,
-                filters,
-                raw: opts.raw,
-                render: ctx.render,
-                emitJson: ctx.emitJson,
-                emitRaw: ctx.emitRaw,
-                emitError: ctx.emitError,
-                setExitCode: ctx.setExitCode,
-            });
-        },
-    });
-}
-/**
- * Normalize the repeatable `--filter` option (Commander yields a string for one
- * occurrence, a string[] for many, undefined for none) into a uniform
- * `string[] | undefined` for `executeSessionShow`.
- */
-function normalizeFilterOption(filter) {
-    if (Array.isArray(filter))
-        return filter;
-    if (filter)
-        return [filter];
-    return undefined;
-}
-/**
- * Validating coercion for `sessions list --limit <n>`.
- *
- * @throws {Error} When the raw value is not a positive integer.
- */
-function parsePositiveInt(raw) {
-    const n = Number.parseInt(raw, 10);
-    if (Number.isNaN(n) || n <= 0) {
-        throw new Error(`Invalid --limit value: '${raw}'. Must be a positive integer.`);
-    }
-    return n;
-}
-/**
- * Validating coercion for `sessions purge --older-than <days>` — identical to
- * the former inline argParser. A named declaration (not an inline lambda) so the
- * `@throws` contract below is documented.
- *
- * @throws {Error} When the raw value is not a non-negative integer.
- */
-function parseOlderThanDays(raw) {
-    const n = Number.parseInt(raw, 10);
-    if (Number.isNaN(n) || n < 0) {
-        throw new Error(`Invalid --older-than value: '${raw}'. Must be a non-negative integer.`);
-    }
-    return n;
-}
-function buildSessionsPurgeSpec(ctx) {
-    return defineCommand({
-        name: 'purge',
-        description: 'Delete session rows from the project-local SQLite store (opensip-cli/.runtime/datastore.sqlite)',
-        commonFlags: ['json'],
-        options: [
-            {
-                flag: '--older-than',
-                value: '<days>',
-                description: 'Only delete sessions older than N days',
-                // Pure validating coercion — identical to the former inline argParser.
-                parse: parseOlderThanDays,
-            },
-            { flag: '-y, --yes', description: 'Skip confirmation prompt', default: false },
-        ],
-        scope: PROJECT_SCOPE,
-        output: COMMAND_RESULT,
-        handler: (rawOpts) => {
-            const opts = rawOpts;
-            return executeClear({
-                olderThan: opts.olderThan,
-                yes: opts.yes,
-                datastore: ctx.datastore(),
-            });
-        },
-    });
-}
-// ---------------------------------------------------------------------------
-// <tool> plugin {list,add,remove,sync} — DOMAIN-BOUND extension-pack ops
-// ---------------------------------------------------------------------------
-//
-// The pack ops are mounted UNDER each pack-supporting tool primary
-// (`opensip fit plugin …`, `opensip sim plugin …`) by `mountToolPluginGroups`,
-// with the `domain` PRE-BOUND from that tool. There is no top-level
-// `opensip plugin` command and no `--domain`/`--type` flag: the tool the
-// subcommand hangs off of IS the domain. Whole Tool plugins are managed by
-// `opensip tools …`, never here.
-/** The shared `--cwd <path>` option for the plugin leaves. Its description is
- *  "Project root" (NOT the registry's "Target directory"), so it is declared as
- *  a per-command OptionSpec rather than the `cwd` common flag — preserving the
- *  byte-identical help text. The default resolves per-invocation (the builders
- *  run on each `registerCliCommands` call). */
-function pluginCwdOption() {
-    return {
-        flag: '--cwd',
-        value: '<path>',
-        description: 'Project root',
-        default: process.cwd(),
-    };
-}
-/** The single-domain layout view passed to the pure plugin commands so a
- *  bound `<tool> plugin …` op only ever touches its own domain. Resolved from
- *  the host's contributed `pluginLayouts` (so the domain is a real layout, not
- *  an arbitrary string); falls back to a minimal layout if the tool's full
- *  layout is somehow absent. */
-function boundLayouts(ctx, domain) {
-    const match = ctx.pluginLayouts.find((l) => l.domain === domain);
-    return match ? [match] : [{ domain, userSubdirs: [] }];
-}
-function buildPluginListSpec(ctx, domain) {
-    return defineCommand({
-        name: 'list',
-        description: `List installed ${domain} packs`,
-        commonFlags: ['json'],
-        options: [pluginCwdOption()],
-        scope: PROJECT_SCOPE,
-        output: COMMAND_RESULT,
-        handler: (rawOpts) => {
-            const opts = rawOpts;
-            // Per-run admitted-tool provenance is on the entered RunScope (stamped by
-            // the bootstrap); read it here and pass it into the pure `pluginList`,
-            // scoped to this tool's own domain.
-            return pluginList(effectiveCwd(opts), boundLayouts(ctx, domain), currentScope()?.toolProvenance ?? []);
-        },
-    });
-}
-function buildPluginAddSpec(ctx, domain) {
-    return defineCommand({
-        name: 'add',
-        description: `Install a ${domain} pack and record it in opensip-cli.config.yml`,
-        commonFlags: ['json'],
-        options: [pluginCwdOption()],
-        // Empty description: the former `.command('add <package>')` declared the
-        // positional inline with no help text, so Commander rendered no "Arguments:"
-        // block. Keeping it empty preserves the byte-identical --help.
-        args: [{ name: 'package', description: '' }],
-        scope: PROJECT_SCOPE,
-        output: COMMAND_RESULT,
-        handler: (rawOpts) => {
-            const opts = rawOpts;
-            const packageName = opts._args[0];
-            // Domain is bound from the tool primary — no `--domain` flag.
-            return pluginAdd(packageName, effectiveCwd(opts), domain, boundLayouts(ctx, domain));
-        },
-    });
-}
-function buildPluginRemoveSpec(ctx, domain) {
-    return defineCommand({
-        name: 'remove',
-        description: `Uninstall a ${domain} pack and remove it from opensip-cli.config.yml`,
-        commonFlags: ['json'],
-        options: [pluginCwdOption()],
-        // Empty description — see the plugin-add note above (byte-identical --help).
-        args: [{ name: 'package', description: '' }],
-        scope: PROJECT_SCOPE,
-        output: COMMAND_RESULT,
-        handler: (rawOpts) => {
-            const opts = rawOpts;
-            const packageName = opts._args[0];
-            return pluginRemove(packageName, effectiveCwd(opts), domain, boundLayouts(ctx, domain));
-        },
-    });
-}
-function buildPluginSyncSpec(ctx, domain) {
-    return defineCommand({
-        name: 'sync',
-        description: `Install every ${domain} pack declared in opensip-cli.config.yml (post-clone bootstrap)`,
-        commonFlags: ['json'],
-        options: [pluginCwdOption()],
-        scope: PROJECT_SCOPE,
-        output: COMMAND_RESULT,
-        handler: (rawOpts) => {
-            const opts = rawOpts;
-            return pluginSync(effectiveCwd(opts), domain, boundLayouts(ctx, domain));
-        },
-    });
-}
-/**
- * Build the four domain-bound `plugin` leaf specs for ONE pack-supporting tool
- * (`add`/`list`/`remove`/`sync`, all scoped to `domain`). Shared by the mount
- * path (`mountToolPluginGroups`), the command-scope index, and the completion
- * inventory so the three derive the SAME leaves.
- */
-export function buildToolPluginLeaves(ctx, domain) {
-    return [
-        buildPluginListSpec(ctx, domain),
-        buildPluginAddSpec(ctx, domain),
-        buildPluginRemoveSpec(ctx, domain),
-        buildPluginSyncSpec(ctx, domain),
-    ];
-}
-/**
- * Derive the per-tool `plugin` groups from the host's contributed
- * `pluginLayouts` — one group per pack-supporting domain (fit/sim). A tool with
- * no `pluginLayout` (e.g. `graph`) contributes none, so it gets no `plugin`
- * group. The single source the mount path + scope index + completion all read.
- */
-export function buildToolPluginGroups(ctx) {
-    return ctx.pluginLayouts.map((layout) => ({
-        toolVerb: layout.domain,
-        domain: layout.domain,
-        description: `Manage ${layout.domain} extension packs (add, list, remove, sync)`,
-        leaves: buildToolPluginLeaves(ctx, layout.domain),
-    }));
-}
-/**
- * Mount each per-tool `plugin` group UNDER its pack-supporting tool primary
- * (`opensip fit plugin …`), domain pre-bound from the tool. The host derives the
- * groups from the contributed `pluginLayouts` (fit/sim; graph has none, so no
- * group). The tool primary must already be mounted — it is, because the
- * composition root mounts tools before the host commands; a domain whose primary
- * is absent (isolated host-only tests) is skipped (nowhere to hang it).
- */
-export function mountToolPluginGroups(program, ctx) {
-    for (const group of buildToolPluginGroups(ctx)) {
-        const primary = program.commands.find((c) => c.name() === group.toolVerb);
-        if (primary === undefined)
-            continue; // no tool primary mounted (host-only tests)
-        const parent = primary.command('plugin').description(group.description);
-        for (const leaf of group.leaves) {
-            mountCommandSpec(parent, leaf, ctx);
-        }
-    }
-}
+export { effectiveCwd } from './host-subcommand-shared.js';
+export { buildToolPluginLeaves, buildToolPluginGroups, mountToolPluginGroups, } from './host-subcommand-plugins.js';
 /**
  * The action-less Commander subcommand GROUPS that legitimately cannot be a
  * single {@link CommandSpec} — they have no action body, only sub-subcommands.
@@ -409,17 +28,13 @@ export function mountToolPluginGroups(program, ctx) {
  * allow-lists as documented host exceptions. Every other host command IS a spec.
  */
 export const HOST_SUBCOMMAND_GROUPS = ['sessions', 'tools'];
-/**
- * Build the subcommand-group parents with their leaf specs. The mounter turns
- * each into a raw parent `program.command(name)` plus `mountCommandSpec(parent,
- * leaf)` for each leaf.
- */
+/** Build the subcommand-group parents with their leaf specs. */
 export function buildHostSubcommandGroups(ctx) {
     return [
         {
             name: 'sessions',
             description: 'Manage session data',
-            leaves: [buildSessionsListSpec(ctx), buildSessionsShowSpec(ctx), buildSessionsPurgeSpec(ctx)],
+            leaves: buildSessionsGroupLeaves(ctx),
         },
         {
             name: 'tools',
@@ -428,12 +43,6 @@ export function buildHostSubcommandGroups(ctx) {
         },
     ];
 }
-/**
- * A no-op {@link CliCommandsContext} used purely to BUILD the group leaf specs
- * so their `name` can be read for the completion-script sub-subcommand
- * inventory. The handlers are never invoked here — we only inspect the static
- * declarations — so the render/datastore/exit members are inert stubs.
- */
 const INVENTORY_CTX = {
     setExitCode: () => {
         /* inert — inventory builds never dispatch a handler */
@@ -450,7 +59,7 @@ const INVENTORY_CTX = {
     },
     pluginLayouts: [],
     toolScaffolds: [],
-    // eslint-disable-next-line unicorn/no-useless-undefined -- explicit no-store sentinel matching the `datastore` thunk contract (returns `unknown`; consumers cast to `DataStore | undefined`).
+    // eslint-disable-next-line unicorn/no-useless-undefined -- explicit no-store sentinel matching the `datastore` thunk contract
     datastore: () => undefined,
 };
 /** Build the host subcommand-group name inventory (single source for completion). */