opensip-cli 0.1.0

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

@@ -0,0 +1,331 @@
+/**
+ * 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` / `plugin` / `report` /
+ * `completion` / `uninstall`) are NOT tool plugins — they don't ride on a
+ * `Tool.commandSpecs` and aren't discovered. But making them mount via the same
+ * `mountCommandSpec` means the Phase 7 `command-surface-parity` guardrail sees
+ * ONE uniform command surface: there is no second, more-privileged
+ * raw-Commander path for "blessed" CLI-owned commands.
+ *
+ * Each spec's handler closes over the per-invocation {@link CliCommandsContext}
+ * (render / setExitCode / datastore thunk / pluginLayouts) — the same data the
+ * former `register-*.ts` registrars threaded in. The handler signature's `TCtx`
+ * is `CliCommandsContext`; 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 two action-less subcommand GROUPS (`sessions`, `plugin`) and their leaf
+ * specs live in `host-subcommand-groups.ts` (a leaf module that lets
+ * `completion.ts` source its sub-subcommand names without a module cycle). This
+ * module assembles the TOP-LEVEL specs and mounts the whole surface.
+ *
+ * Specs are built per-invocation (inside 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.
+ */
+import { EXIT_CODES } from '@opensip-cli/contracts';
+import { ConfigurationError, defineCommand } from '@opensip-cli/core';
+import { composeAndWriteReport } from '../report-compose.js';
+import { executeAgentCatalog } from './agent-catalog.js';
+import { assembleCompletionInventory, printCompletionScript, } from './completion.js';
+import { executeConfigure } from './configure.js';
+import { buildHostSubcommandGroups } from './host-subcommand-groups.js';
+import { executeInit } from './init.js';
+import { mountCommandSpec } from './mount-command-spec.js';
+import { executeUninstall } from './uninstall.js';
+/** Shared `output` mode for the host commands that return a renderable result. */
+const COMMAND_RESULT = 'command-result';
+function buildInitSpec(ctx) {
+    return defineCommand({
+        name: 'init',
+        description: 'Scaffold opensip-cli.config.yml + example checks/scenarios for your project',
+        // `--cwd` here matches the registry text ("Target directory"); `--json` /
+        // `--debug` match the registry too, so they ride the common-flag path.
+        commonFlags: ['cwd', 'json', 'debug'],
+        options: [
+            {
+                flag: '--language',
+                value: '<list>',
+                description: 'Language list (typescript|rust|python|go|java|cpp), repeatable or comma-separated. Default: detect from filesystem markers.',
+                arrayDefault: [],
+                parse: (val, prev) => [...prev, val],
+            },
+            {
+                flag: '--keep',
+                description: 'Re-scaffold example files. Preserve any custom files in opensip-cli/.',
+                default: false,
+            },
+            {
+                flag: '--remove',
+                description: 'Delete opensip-cli/ entirely, then scaffold fresh.',
+                default: false,
+            },
+        ],
+        scope: 'project',
+        output: COMMAND_RESULT,
+        handler: (rawOpts) => {
+            const opts = rawOpts;
+            // `cwdExplicit` is stashed on opts by the pre-action hook (the single
+            // source for "was --cwd typed on the CLI?"); the former register-init
+            // recomputed `cmd.getOptionValueSource('cwd') === 'cli'` on its own
+            // Commander command — identical, since the hook's actionCommand IS init.
+            const result = executeInit({
+                ...opts,
+                cwdExplicit: opts.cwdExplicit === true,
+                toolScaffolds: ctx.toolScaffolds,
+            });
+            // Exit 2 for any non-success path the user can act on: ambiguous-language
+            // detection, partial-state refusal, mutex flag error, inside-existing-
+            // project refusal.
+            if (result.ambiguousLanguageError ||
+                result.partialStateError ||
+                result.insideExistingProject) {
+                ctx.setExitCode(EXIT_CODES.CONFIGURATION_ERROR);
+            }
+            return result;
+        },
+    });
+}
+// ---------------------------------------------------------------------------
+// configure
+// ---------------------------------------------------------------------------
+function buildConfigureSpec() {
+    return defineCommand({
+        name: 'configure',
+        description: 'Set up OpenSIP Cloud API key',
+        commonFlags: ['json', 'debug'],
+        scope: 'none',
+        output: COMMAND_RESULT,
+        handler: () => executeConfigure(),
+    });
+}
+// ---------------------------------------------------------------------------
+// report (CLI-owned composition root)
+// ---------------------------------------------------------------------------
+function buildReportSpec() {
+    return defineCommand({
+        name: 'report',
+        description: 'Generate the cross-tool HTML report and open it in your browser',
+        commonFlags: ['json'],
+        options: [
+            {
+                flag: '--no-open',
+                description: 'Write the report but do not launch a browser',
+                negatable: true,
+            },
+        ],
+        scope: 'project',
+        output: COMMAND_RESULT,
+        handler: (rawOpts) => {
+            const opts = rawOpts;
+            // Commander stores `--no-open` as `opts.open === false`; default true.
+            // In `--json` mode we never launch a browser (machine-output contract).
+            return composeAndWriteReport({ open: opts.open && !opts.json });
+        },
+    });
+}
+// ---------------------------------------------------------------------------
+// completion
+// ---------------------------------------------------------------------------
+function buildCompletionSpec(ctx) {
+    return defineCommand({
+        name: 'completion',
+        description: 'Print a shell-completion script (bash | zsh | fish)',
+        commonFlags: [],
+        // Empty description: the former `.command('completion <shell>')` declared
+        // the positional inline with no help text — no "Arguments:" block. Keeping
+        // it empty preserves the byte-identical --help.
+        args: [{ name: 'shell', description: '' }],
+        scope: 'none',
+        // The handler writes the completion script straight to stdout (no Ink) and
+        // owns its own exit-code decision — the documented raw-stream exception.
+        output: 'raw-stream',
+        rawStreamReason: 'completion-script',
+        handler: (rawOpts) => {
+            const opts = rawOpts;
+            const shell = opts._args[0];
+            const normalized = shell.toLowerCase();
+            if (normalized !== 'bash' && normalized !== 'zsh' && normalized !== 'fish') {
+                process.stderr.write(`Unsupported shell: ${shell}. Expected one of: bash, zsh, fish.\n`);
+                ctx.setExitCode(EXIT_CODES.CONFIGURATION_ERROR);
+                return;
+            }
+            // Derive the completion surface from the live specs: the tool commands
+            // (supplied by the composition root via `ctx.toolCommandSpecs`), the
+            // top-level host commands, and the action-less groups. Single source of
+            // truth — the emitted script tracks the real command surface.
+            //
+            // The host surface is read via {@link buildHostCompletionSurface}, NOT
+            // `buildTopLevelHostSpecs`: that assembly includes `buildCompletionSpec`,
+            // so calling it from this handler would form a `buildCompletionSpec →
+            // buildTopLevelHostSpecs → buildCompletionSpec` call cycle. The surface
+            // helper derives the same `SpecLike` views WITHOUT rebuilding the
+            // completion spec (it contributes a static, options-free descriptor for
+            // itself), keeping the dependency one-directional.
+            const host = buildHostCompletionSurface(ctx);
+            const inventory = assembleCompletionInventory({
+                toolSpecs: ctx.toolCommandSpecs ?? [],
+                hostSpecs: host.specs,
+                groups: host.groups,
+            });
+            printCompletionScript(normalized, inventory);
+        },
+    });
+}
+function buildUninstallSpec() {
+    return defineCommand({
+        name: 'uninstall',
+        description: 'Remove user-level config at ~/.opensip-cli/ (cloud API key, defaults). Use --project to remove project-local state instead.',
+        commonFlags: [],
+        options: [
+            { flag: '-y, --yes', description: 'Skip confirmation prompt', default: false },
+            {
+                flag: '--dry-run',
+                description: 'Print what would be removed; take no action',
+                default: false,
+            },
+            {
+                flag: '--user',
+                description: 'Remove user-level config at ~/.opensip-cli/ (default mode)',
+                default: false,
+            },
+            {
+                flag: '--project',
+                value: '[path]',
+                description: 'Remove project-local runtime state at [path] (defaults to cwd). User content + config preserved unless --purge.',
+            },
+            {
+                flag: '--purge',
+                description: 'With --project, also remove user-authored content and opensip-cli.config.yml (DESTRUCTIVE)',
+                default: false,
+            },
+            { flag: '--json', description: 'Output structured JSON', default: false },
+        ],
+        scope: 'project',
+        output: COMMAND_RESULT,
+        handler: (rawOpts) => {
+            const opts = rawOpts;
+            if (opts.user === true && opts.project !== undefined) {
+                throw new ConfigurationError('uninstall: --user and --project are mutually exclusive.');
+            }
+            // Commander passes `true` when the flag is present without a value, a
+            // string when given a value, or undefined when omitted.
+            let project;
+            if (opts.project === true)
+                project = true;
+            else if (typeof opts.project === 'string')
+                project = opts.project;
+            return executeUninstall({
+                yes: opts.yes,
+                dryRun: opts.dryRun,
+                project,
+                purge: opts.purge,
+                projectContext: opts.projectContext,
+            });
+        },
+    });
+}
+// ---------------------------------------------------------------------------
+// agent-catalog (agent-first discovery surface)
+// ---------------------------------------------------------------------------
+function buildAgentCatalogSpec() {
+    return defineCommand({
+        name: 'agent-catalog',
+        description: 'Structured catalog of agent-friendly commands, patterns, and output shapes (JSON preferred). ' +
+            'Primary surface for AI agents to bootstrap usage of sessions, filtering, and historical results.',
+        commonFlags: ['json'],
+        scope: 'none',
+        output: COMMAND_RESULT,
+        handler: (rawOpts) => {
+            const opts = rawOpts;
+            return executeAgentCatalog({ json: opts.json });
+        },
+    });
+}
+// ---------------------------------------------------------------------------
+// Assembly + mount
+// ---------------------------------------------------------------------------
+/**
+ * The `completion` command's own completion surface — a static, options-free
+ * `SpecLike`. The command declares `commonFlags: []` and no options (only a
+ * positional `<shell>` arg, which is not a flag), so this descriptor is an
+ * exact, drift-free stand-in for it in the inventory. Hand-declaring it here
+ * (rather than calling `buildCompletionSpec`) is what keeps the completion
+ * handler from depending back on its own builder — breaking the
+ * `buildCompletionSpec → buildTopLevelHostSpecs → buildCompletionSpec` cycle at
+ * the root rather than suppressing it.
+ */
+const COMPLETION_SELF_SPEC = { name: 'completion', commonFlags: [] };
+/**
+ * The top-level host specs EXCEPT `completion`. The shared leaf both
+ * {@link buildTopLevelHostSpecs} (which splices the completion spec back in at
+ * its canonical position) and {@link buildHostCompletionSurface} depend on. It
+ * calls neither {@link buildCompletionSpec} nor `buildTopLevelHostSpecs`, so
+ * neither caller can form a call cycle back through the completion handler.
+ */
+function buildNonCompletionHostSpecs(ctx) {
+    return [
+        buildInitSpec(ctx),
+        buildReportSpec(),
+        buildConfigureSpec(),
+        buildAgentCatalogSpec(),
+        buildUninstallSpec(),
+    ];
+}
+/**
+ * The host portion of the completion inventory: the `SpecLike` views of every
+ * top-level host command and the action-less groups. The completion command's
+ * own surface is the static {@link COMPLETION_SELF_SPEC} stand-in; every OTHER
+ * host command is read from its live spec (so its flags can't drift). Consumed
+ * by the `completion` handler INSTEAD of {@link buildTopLevelHostSpecs}, so the
+ * handler never depends back on {@link buildCompletionSpec}.
+ *
+ * Order is irrelevant here — the inventory subcommand list is sorted — so the
+ * static completion descriptor is simply appended.
+ */
+function buildHostCompletionSurface(ctx) {
+    return {
+        specs: [...buildNonCompletionHostSpecs(ctx), COMPLETION_SELF_SPEC],
+        groups: buildHostSubcommandGroups(ctx),
+    };
+}
+/**
+ * Build the top-level (non-grouped) host command specs. Exported so tests can
+ * inspect the host command surface that the host mounts (single source). The
+ * `completion` spec keeps its canonical position (after `configure`, before
+ * `uninstall`) so the mounted command order — and thus `--help` ordering — is
+ * byte-identical to before the cycle-breaking split.
+ */
+export function buildTopLevelHostSpecs(ctx) {
+    return [
+        buildInitSpec(ctx),
+        buildReportSpec(),
+        buildConfigureSpec(),
+        buildAgentCatalogSpec(),
+        buildCompletionSpec(ctx),
+        buildUninstallSpec(),
+    ];
+}
+/**
+ * Mount every host command onto `program` through the shared `mountCommandSpec`
+ * plane. Top-level specs mount directly; each subcommand group becomes a raw
+ * action-less parent (the documented exception) onto which its leaf specs mount
+ * via the same `mountCommandSpec`.
+ */
+export function mountHostCommands(program, ctx) {
+    for (const spec of buildTopLevelHostSpecs(ctx)) {
+        mountCommandSpec(program, spec, ctx);
+    }
+    for (const group of buildHostSubcommandGroups(ctx)) {
+        const parent = program.command(group.name).description(group.description);
+        for (const leaf of group.leaves) {
+            mountCommandSpec(parent, leaf, ctx);
+        }
+    }
+}
+//# sourceMappingURL=host-command-specs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"host-command-specs.js","sourceRoot":"","sources":["../../src/commands/host-command-specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAuB,MAAM,mBAAmB,CAAC;AAE3F,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,GAItB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAiB,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAKlD,kFAAkF;AAClF,MAAM,cAAc,GAAG,gBAAyB,CAAC;AAYjD,SAAS,aAAa,CAAC,GAAuB;IAC5C,OAAO,aAAa,CAA8B;QAChD,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,6EAA6E;QAC1F,0EAA0E;QAC1E,uEAAuE;QACvE,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC;QACrC,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,YAAY;gBAClB,KAAK,EAAE,QAAQ;gBACf,WAAW,EACT,6HAA6H;gBAC/H,YAAY,EAAE,EAAE;gBAChB,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,GAAI,IAAiB,EAAE,GAAG,CAAC;aACnD;YACD;gBACE,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uEAAuE;gBACpF,OAAO,EAAE,KAAK;aACf;YACD;gBACE,IAAI,EAAE,UAAU;gBAChB,WAAW,EAAE,oDAAoD;gBACjE,OAAO,EAAE,KAAK;aACf;SACF;QACD,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,cAAc;QACtB,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;YACnB,MAAM,IAAI,GAAG,OAAmB,CAAC;YACjC,sEAAsE;YACtE,sEAAsE;YACtE,oEAAoE;YACpE,yEAAyE;YACzE,MAAM,MAAM,GAAG,WAAW,CAAC;gBACzB,GAAG,IAAI;gBACP,WAAW,EAAE,IAAI,CAAC,WAAW,KAAK,IAAI;gBACtC,aAAa,EAAE,GAAG,CAAC,aAAa;aACjC,CAAC,CAAC;YACH,0EAA0E;YAC1E,uEAAuE;YACvE,mBAAmB;YACnB,IACE,MAAM,CAAC,sBAAsB;gBAC7B,MAAM,CAAC,iBAAiB;gBACxB,MAAM,CAAC,qBAAqB,EAC5B,CAAC;gBACD,GAAG,CAAC,WAAW,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;YAClD,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,SAAS,kBAAkB;IACzB,OAAO,aAAa,CAA8B;QAChD,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,8BAA8B;QAC3C,WAAW,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;QAC9B,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,cAAc;QACtB,OAAO,EAAE,GAAG,EAAE,CAAC,gBAAgB,EAAE;KAClC,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,sCAAsC;AACtC,8EAA8E;AAE9E,SAAS,eAAe;IACtB,OAAO,aAAa,CAA8B;QAChD,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,iEAAiE;QAC9E,WAAW,EAAE,CAAC,MAAM,CAAC;QACrB,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,WAAW;gBACjB,WAAW,EAAE,8CAA8C;gBAC3D,SAAS,EAAE,IAAI;aAChB;SACF;QACD,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,cAAc;QACtB,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;YACnB,MAAM,IAAI,GAAG,OAA2C,CAAC;YACzD,uEAAuE;YACvE,wEAAwE;YACxE,OAAO,qBAAqB,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,SAAS,mBAAmB,CAAC,GAAuB;IAClD,OAAO,aAAa,CAA8B;QAChD,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,qDAAqD;QAClE,WAAW,EAAE,EAAE;QACf,0EAA0E;QAC1E,2EAA2E;QAC3E,gDAAgD;QAChD,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;QAC1C,KAAK,EAAE,MAAM;QACb,2EAA2E;QAC3E,yEAAyE;QACzE,MAAM,EAAE,YAAY;QACpB,eAAe,EAAE,mBAAmB;QACpC,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;YACnB,MAAM,IAAI,GAAG,OAA8B,CAAC;YAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC5B,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YACvC,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,KAAK,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;gBAC3E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,KAAK,uCAAuC,CAAC,CAAC;gBACzF,GAAG,CAAC,WAAW,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;gBAChD,OAAO;YACT,CAAC;YACD,uEAAuE;YACvE,qEAAqE;YACrE,wEAAwE;YACxE,8DAA8D;YAC9D,EAAE;YACF,uEAAuE;YACvE,0EAA0E;YAC1E,sEAAsE;YACtE,wEAAwE;YACxE,kEAAkE;YAClE,wEAAwE;YACxE,mDAAmD;YACnD,MAAM,IAAI,GAAG,0BAA0B,CAAC,GAAG,CAAC,CAAC;YAC7C,MAAM,SAAS,GAAG,2BAA2B,CAAC;gBAC5C,SAAS,EAAE,GAAG,CAAC,gBAAgB,IAAI,EAAE;gBACrC,SAAS,EAAE,IAAI,CAAC,KAAK;gBACrB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;YACH,qBAAqB,CAAC,UAA0B,EAAE,SAAS,CAAC,CAAC;QAC/D,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAgBD,SAAS,kBAAkB;IACzB,OAAO,aAAa,CAA8B;QAChD,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,6HAA6H;QAC/H,WAAW,EAAE,EAAE;QACf,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,0BAA0B,EAAE,OAAO,EAAE,KAAK,EAAE;YAC9E;gBACE,IAAI,EAAE,WAAW;gBACjB,WAAW,EAAE,6CAA6C;gBAC1D,OAAO,EAAE,KAAK;aACf;YACD;gBACE,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4DAA4D;gBACzE,OAAO,EAAE,KAAK;aACf;YACD;gBACE,IAAI,EAAE,WAAW;gBACjB,KAAK,EAAE,QAAQ;gBACf,WAAW,EACT,iHAAiH;aACpH;YACD;gBACE,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,4FAA4F;gBAC9F,OAAO,EAAE,KAAK;aACf;YACD,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE,OAAO,EAAE,KAAK,EAAE;SAC1E;QACD,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,cAAc;QACtB,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;YACnB,MAAM,IAAI,GAAG,OAAwB,CAAC;YACtC,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBACrD,MAAM,IAAI,kBAAkB,CAAC,yDAAyD,CAAC,CAAC;YAC1F,CAAC;YACD,sEAAsE;YACtE,wDAAwD;YACxD,IAAI,OAAkC,CAAC;YACvC,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI;gBAAE,OAAO,GAAG,IAAI,CAAC;iBACrC,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ;gBAAE,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAClE,OAAO,gBAAgB,CAAC;gBACtB,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO;gBACP,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,cAAc,EAAE,IAAI,CAAC,cAAc;aACpC,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,gDAAgD;AAChD,8EAA8E;AAE9E,SAAS,qBAAqB;IAC5B,OAAO,aAAa,CAA8B;QAChD,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,+FAA+F;YAC/F,kGAAkG;QACpG,WAAW,EAAE,CAAC,MAAM,CAAC;QACrB,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,cAAc;QACtB,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;YACnB,MAAM,IAAI,GAAG,OAA6B,CAAC;YAC3C,OAAO,mBAAmB,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,oBAAoB,GAAa,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;AAE/E;;;;;;GAMG;AACH,SAAS,2BAA2B,CAAC,GAAuB;IAC1D,OAAO;QACL,aAAa,CAAC,GAAG,CAAC;QAClB,eAAe,EAAE;QACjB,kBAAkB,EAAE;QACpB,qBAAqB,EAAE;QACvB,kBAAkB,EAAE;KACrB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,0BAA0B,CAAC,GAAuB;IAIzD,OAAO;QACL,KAAK,EAAE,CAAC,GAAG,2BAA2B,CAAC,GAAG,CAAC,EAAE,oBAAoB,CAAC;QAClE,MAAM,EAAE,yBAAyB,CAAC,GAAG,CAAC;KACvC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAuB;IAC5D,OAAO;QACL,aAAa,CAAC,GAAG,CAAC;QAClB,eAAe,EAAE;QACjB,kBAAkB,EAAE;QACpB,qBAAqB,EAAE;QACvB,mBAAmB,CAAC,GAAG,CAAC;QACxB,kBAAkB,EAAE;KACrB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAmB,EAAE,GAAuB;IAC5E,KAAK,MAAM,IAAI,IAAI,sBAAsB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IACvC,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,yBAAyB,CAAC,GAAG,CAAC,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC1E,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YAChC,gBAAgB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,69 @@
+/**
+ * host-subcommand-groups — the action-less Commander subcommand GROUPS
+ * (`sessions`, `plugin`) and their leaf {@link CommandSpec}s (launch
+ * Phase 6).
+ *
+ * Split out of `host-command-specs.ts` for ONE reason: to break a module cycle.
+ * The completion-script generator (`completion.ts`) sources its `plugin` /
+ * `sessions` sub-subcommand NAME lists from the live leaf specs (single source —
+ * Phase 6 Task 6.2), so it must import the group inventory. The
+ * `host-command-specs.ts` module, in turn, imports `printCompletionScript` from
+ * `completion.ts` for the `completion` command's handler. Housing the GROUP
+ * 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`, `plugin list|add|remove|sync`) ARE specs.
+ */
+import { type CommandSpec, type ProjectContext } from '@opensip-cli/core';
+import type { CliCommandsContext } from './shared.js';
+/** 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;
+/** One subcommand-group parent: a raw action-less `program.command(name)`
+ *  shell + the leaf specs that mount onto it. */
+export interface HostSubcommandGroup {
+    readonly name: string;
+    readonly description: string;
+    readonly leaves: readonly HostSpec[];
+}
+/**
+ * The action-less Commander subcommand GROUPS that legitimately cannot be a
+ * single {@link CommandSpec} — they have no action body, only sub-subcommands.
+ * 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 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.
+ */
+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). */
+export declare function buildHostCommandInventory(): HostCommandInventory;
+//# sourceMappingURL=host-subcommand-groups.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"host-subcommand-groups.d.ts","sourceRoot":"","sources":["../../src/commands/host-subcommand-groups.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,cAAc,EAEpB,MAAM,mBAAmB,CAAC;AAQ3B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGtD,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;AAuTD;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;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,kBAAkB,GAAG,SAAS,mBAAmB,EAAE,CAuBjG;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"}