opensip-cli 0.1.0

package/dist/commands/completion.d.ts

@@ -0,0 +1,90 @@
+/**
+ * @fileoverview Shell-completion script generator.
+ *
+ * Emits a sourceable completion script for bash, zsh, or fish that the
+ * user drops into their shell init (or pipes directly into their
+ * current shell to try it out).
+ *
+ * Usage:
+ *   opensip completion bash >> ~/.bashrc
+ *   opensip completion zsh  >> ~/.zshrc
+ *   opensip completion fish > ~/.config/fish/completions/opensip.fish
+ *
+ * The emitted scripts are static — the user's shell sources them once, so
+ * they complete fixed subcommand / flag names rather than querying the CLI
+ * per keystroke (fast, portable, no version skew). What is NOT static is
+ * how those names are produced: the subcommand list and each command's
+ * flags are DERIVED from the live `CommandSpec`s at generation time (see
+ * {@link CompletionInventory} / the `completion` command handler), so the
+ * script can never drift from the real command surface the way a
+ * hand-maintained flag list does. If dynamic value completion (e.g.
+ * matching existing check slugs) is ever needed, that's an additive change
+ * that can query `opensip fit --list` at completion time.
+ */
+import { type CommonFlagKey } from '@opensip-cli/contracts';
+export type Shell = 'bash' | 'zsh' | 'fish';
+/**
+ * Internal/machine-facing command names never offered in shell completion.
+ * These are spawned by the host (sharded build, off-process engine workers,
+ * machine exports), never typed by a user. Single source for both the
+ * inventory builder and the drift test.
+ */
+export declare const INTERNAL_COMMANDS: ReadonlySet<string>;
+/**
+ * The derived completion surface, assembled from the live `CommandSpec`s by
+ * {@link assembleCompletionInventory}. Everything the emitted script needs to
+ * know about the command surface lives here — there are no hand-maintained
+ * flag lists anymore.
+ */
+export interface CompletionInventory {
+    /** User-facing top-level command names (incl. aliases + `help`). */
+    readonly subcommands: readonly string[];
+    /** Per-command long-flag list, keyed by command name (and alias). */
+    readonly commandFlags: Readonly<Record<string, readonly string[]>>;
+    /** Sub-subcommand names for the action-less groups (`plugin`, `sessions`). */
+    readonly groupSubcommands: Readonly<Record<string, readonly string[]>>;
+}
+/** Minimal structural view of a `CommandSpec` this module needs to read. */
+export interface SpecLike {
+    readonly name: string;
+    readonly aliases?: readonly string[];
+    readonly commonFlags: readonly CommonFlagKey[];
+    readonly options?: readonly {
+        readonly flag: string;
+    }[];
+}
+/** One action-less group (`plugin` / `sessions`) and its leaf command names. */
+export interface GroupLike {
+    readonly name: string;
+    readonly leaves: readonly {
+        readonly name: string;
+    }[];
+}
+/**
+ * Extract the canonical long `--flag` from a Commander flag string —
+ * `'-y, --yes'` → `'--yes'`, `'--no-cache'` → `'--no-cache'`,
+ * `'--resolution'` → `'--resolution'`. Returns `undefined` for a short-only
+ * flag (none exist in the current surface, but the caller filters defensively).
+ */
+export declare function extractLongFlag(flags: string): string | undefined;
+/**
+ * The long flags a single command exposes: its resolved {@link CommonFlagKey}
+ * common flags + its option long forms + Commander's built-in `--help`. Pure —
+ * the single place a spec's flag surface is turned into completion candidates.
+ */
+export declare function specLongFlags(spec: SpecLike): readonly string[];
+/**
+ * Assemble the completion inventory from the live specs. Pure: callers pass
+ * the tool command specs (from the populated `ToolRegistry`), the top-level
+ * host specs, and the action-less groups; this turns them into the flag /
+ * subcommand maps the script builders consume. Internal worker commands are
+ * filtered out ({@link INTERNAL_COMMANDS}).
+ */
+export declare function assembleCompletionInventory(input: {
+    readonly toolSpecs: readonly SpecLike[];
+    readonly hostSpecs: readonly SpecLike[];
+    readonly groups: readonly GroupLike[];
+}): CompletionInventory;
+export declare function buildCompletionScript(shell: Shell, inventory: CompletionInventory): string;
+export declare function printCompletionScript(shell: Shell, inventory: CompletionInventory, write?: (s: string) => void): void;
+//# sourceMappingURL=completion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEzE,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAOhD,CAAC;AAEH;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,qEAAqE;IACrE,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IACnE,8EAA8E;IAC9E,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;CACxE;AAED,4EAA4E;AAC5E,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,SAAS,aAAa,EAAE,CAAC;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACzD;AAED,gFAAgF;AAChF,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACvD;AA0BD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGjE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,MAAM,EAAE,CAQ/D;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;CACvC,GAAG,mBAAmB,CA2BtB;AA6GD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,mBAAmB,GAAG,MAAM,CAY1F;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,mBAAmB,EAC9B,KAAK,GAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAqC,GAC1D,IAAI,CAEN"}

package/dist/commands/completion.js

@@ -0,0 +1,233 @@
+/**
+ * @fileoverview Shell-completion script generator.
+ *
+ * Emits a sourceable completion script for bash, zsh, or fish that the
+ * user drops into their shell init (or pipes directly into their
+ * current shell to try it out).
+ *
+ * Usage:
+ *   opensip completion bash >> ~/.bashrc
+ *   opensip completion zsh  >> ~/.zshrc
+ *   opensip completion fish > ~/.config/fish/completions/opensip.fish
+ *
+ * The emitted scripts are static — the user's shell sources them once, so
+ * they complete fixed subcommand / flag names rather than querying the CLI
+ * per keystroke (fast, portable, no version skew). What is NOT static is
+ * how those names are produced: the subcommand list and each command's
+ * flags are DERIVED from the live `CommandSpec`s at generation time (see
+ * {@link CompletionInventory} / the `completion` command handler), so the
+ * script can never drift from the real command surface the way a
+ * hand-maintained flag list does. If dynamic value completion (e.g.
+ * matching existing check slugs) is ever needed, that's an additive change
+ * that can query `opensip fit --list` at completion time.
+ */
+// @fitness-ignore-file only-documented-toolcli-seams -- the `completion <shell>` command's whole purpose is to write a sourceable shell-completion script to stdout for the user to pipe/redirect; that script IS its output, not run findings through a ToolCliContext seam (mirrors the ESLint exemption for this file). See architecture review finding 5 (interactive host commands legitimately need a narrow TTY/script seam outside the run data path).
+import { commonFlags } from '@opensip-cli/contracts';
+/**
+ * Internal/machine-facing command names never offered in shell completion.
+ * These are spawned by the host (sharded build, off-process engine workers,
+ * machine exports), never typed by a user. Single source for both the
+ * inventory builder and the drift test.
+ */
+export const INTERNAL_COMMANDS = new Set([
+    'graph-shard-worker',
+    'catalog-export',
+    'sarif-export',
+    'fit-run-worker',
+    'sim-run-worker',
+    'graph-run-worker',
+]);
+/** Long `--flag` form of each registry spec (short alias + arg placeholder
+ *  stripped). Precomputed by mapping the registry entries, so completion's
+ *  common-flag list derives from the one ADR-0021 registry rather than
+ *  re-listing flag names that can drift. Dot-access stays null-safe. */
+const LONG_FLAGS = Object.fromEntries(Object.entries(commonFlags).map(([key, spec]) => {
+    const match = /--[a-z][a-z-]*/.exec(spec.flags);
+    return [key, match ? match[0] : spec.flags];
+}));
+/** Flags every command implicitly carries — the `*)` fallback when a typed
+ *  subcommand has no derived entry. Derived from the ADR-0021 registry (plus
+ *  Commander's built-in `--help`/`--version`) so it can't drift. */
+const COMMON_FLAGS = [
+    LONG_FLAGS.cwd,
+    LONG_FLAGS.json,
+    LONG_FLAGS.verbose,
+    LONG_FLAGS.quiet,
+    LONG_FLAGS.debug,
+    '--help',
+    '--version',
+];
+/**
+ * Extract the canonical long `--flag` from a Commander flag string —
+ * `'-y, --yes'` → `'--yes'`, `'--no-cache'` → `'--no-cache'`,
+ * `'--resolution'` → `'--resolution'`. Returns `undefined` for a short-only
+ * flag (none exist in the current surface, but the caller filters defensively).
+ */
+export function extractLongFlag(flags) {
+    const match = /--[a-z][a-z-]*/.exec(flags);
+    return match ? match[0] : undefined;
+}
+/**
+ * The long flags a single command exposes: its resolved {@link CommonFlagKey}
+ * common flags + its option long forms + Commander's built-in `--help`. Pure —
+ * the single place a spec's flag surface is turned into completion candidates.
+ */
+export function specLongFlags(spec) {
+    // LONG_FLAGS is a total `Record<CommonFlagKey, string>`, so the common-flag
+    // lookup never yields undefined; only the option extraction can.
+    const common = spec.commonFlags.map((k) => LONG_FLAGS[k]);
+    const opts = (spec.options ?? [])
+        .map((o) => extractLongFlag(o.flag))
+        .filter((f) => f !== undefined);
+    return [...new Set([...common, ...opts, '--help'])];
+}
+/**
+ * Assemble the completion inventory from the live specs. Pure: callers pass
+ * the tool command specs (from the populated `ToolRegistry`), the top-level
+ * host specs, and the action-less groups; this turns them into the flag /
+ * subcommand maps the script builders consume. Internal worker commands are
+ * filtered out ({@link INTERNAL_COMMANDS}).
+ */
+export function assembleCompletionInventory(input) {
+    const commandFlags = {};
+    const subcommands = [];
+    for (const spec of [...input.toolSpecs, ...input.hostSpecs]) {
+        if (INTERNAL_COMMANDS.has(spec.name))
+            continue;
+        const flags = specLongFlags(spec);
+        for (const name of [spec.name, ...(spec.aliases ?? [])]) {
+            subcommands.push(name);
+            commandFlags[name] = flags;
+        }
+    }
+    const groupSubcommands = {};
+    for (const group of input.groups) {
+        subcommands.push(group.name);
+        groupSubcommands[group.name] = group.leaves.map((l) => l.name);
+    }
+    // `help` is a Commander built-in the script also surfaces.
+    subcommands.push('help');
+    return {
+        subcommands: [...new Set(subcommands)].sort(),
+        commandFlags,
+        groupSubcommands,
+    };
+}
+// ---------------------------------------------------------------------------
+// bash
+// ---------------------------------------------------------------------------
+function bashScript(inv) {
+    const subs = inv.subcommands.join(' ');
+    const commonFlagList = COMMON_FLAGS.join(' ');
+    const arms = [];
+    for (const [name, subsList] of Object.entries(inv.groupSubcommands)) {
+        arms.push(`    ${name}) COMPREPLY=($(compgen -W "${subsList.join(' ')}" -- "\${cur}")) ;;`);
+    }
+    for (const [name, flags] of Object.entries(inv.commandFlags)) {
+        if (name in inv.groupSubcommands)
+            continue;
+        arms.push(`    ${name}) COMPREPLY=($(compgen -W "${flags.join(' ')}" -- "\${cur}")) ;;`);
+    }
+    arms.push(`    *) COMPREPLY=($(compgen -W "${commonFlagList}" -- "\${cur}")) ;;`);
+    return `# bash completion for opensip
+# Source this file from ~/.bashrc or /etc/bash_completion.d/
+
+_opensip() {
+  local cur prev words cword
+  COMPREPLY=()
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  prev="\${COMP_WORDS[COMP_CWORD-1]}"
+
+  # First word: subcommand
+  if [ "\${COMP_CWORD}" -eq 1 ]; then
+    COMPREPLY=($(compgen -W "${subs}" -- "\${cur}"))
+    return 0
+  fi
+
+  # Subcommand-specific flags (derived from the live command specs)
+  case "\${COMP_WORDS[1]}" in
+${arms.join('\n')}
+  esac
+  return 0
+}
+
+complete -F _opensip opensip
+`;
+}
+// ---------------------------------------------------------------------------
+// zsh
+// ---------------------------------------------------------------------------
+function zshScript(inv) {
+    const subs = inv.subcommands.join(' ');
+    const commonFlagList = COMMON_FLAGS.join(' ');
+    const arms = [];
+    for (const [name, subsList] of Object.entries(inv.groupSubcommands)) {
+        arms.push(`    ${name}) _values '${name} subcommand' ${subsList.join(' ')} ;;`);
+    }
+    for (const [name, flags] of Object.entries(inv.commandFlags)) {
+        if (name in inv.groupSubcommands)
+            continue;
+        arms.push(`    ${name}) _values 'flag' ${flags.join(' ')} ;;`);
+    }
+    arms.push(`    *) _values 'flag' ${commonFlagList} ;;`);
+    return `#compdef opensip
+# zsh completion for opensip
+# Source this file from your fpath (e.g. ~/.zsh/completions/_opensip).
+
+_opensip() {
+  local -a subcommands
+  subcommands=(${subs})
+
+  if (( CURRENT == 2 )); then
+    _describe 'subcommand' subcommands
+    return
+  fi
+
+  case "\${words[2]}" in
+${arms.join('\n')}
+  esac
+}
+
+compdef _opensip opensip
+`;
+}
+// ---------------------------------------------------------------------------
+// fish
+// ---------------------------------------------------------------------------
+function fishScript(inv) {
+    const subs = inv.subcommands.join(' ');
+    const lines = [
+        '# fish completion for opensip',
+        '# Drop this at ~/.config/fish/completions/opensip.fish',
+        '',
+        `complete -c opensip -f -n "__fish_use_subcommand" -a "${subs}" -d "opensip subcommand"`,
+    ];
+    for (const [name, flags] of Object.entries(inv.commandFlags)) {
+        if (name in inv.groupSubcommands)
+            continue;
+        for (const flag of flags) {
+            lines.push(`complete -c opensip -n "__fish_seen_subcommand_from ${name}" -l "${flag.replace(/^--/, '')}"`);
+        }
+    }
+    return lines.join('\n') + '\n';
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export function buildCompletionScript(shell, inventory) {
+    switch (shell) {
+        case 'bash': {
+            return bashScript(inventory);
+        }
+        case 'zsh': {
+            return zshScript(inventory);
+        }
+        case 'fish': {
+            return fishScript(inventory);
+        }
+    }
+}
+export function printCompletionScript(shell, inventory, write = (s) => process.stdout.write(s)) {
+    write(buildCompletionScript(shell, inventory));
+}
+//# sourceMappingURL=completion.js.map

package/dist/commands/completion.js.map

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

package/dist/commands/configure.d.ts

@@ -0,0 +1,32 @@
+/**
+ * configure command — set up OpenSIP Cloud API key.
+ *
+ * Prompts via `readline` (Ink can't own a prompt loop without raw mode);
+ * banners and result lines route through Ink via the `configure-done`
+ * `CommandResult`. No `console.log` and no raw ANSI escapes here.
+ *
+ * The actual config I/O (read/write `~/.opensip-cli/config.yml`,
+ * resolve the API key from flag → env → config) lives in
+ * `@opensip-cli/config` (relocated there in ADR-0023) so the
+ * pre-action hook and this command both read it through the config
+ * layer. This file is the prompt+UX wrapper around those primitives.
+ * Audit 2026-05-23 M3.
+ */
+import type { ConfigureDoneResult } from '@opensip-cli/contracts';
+export { resolveApiKey } from '@opensip-cli/config';
+/**
+ * Test a freshly-entered key against the cloud entitlement endpoint — the
+ * configure flow's documented "test the key" step (audit P2-2). Prints the
+ * outcome; best-effort, never throws (checkEntitlement returns `entitled:
+ * false` on an invalid key, an unreachable endpoint, or a non-entitled plan).
+ * The key is saved regardless, so offline setup still works. Returns whether
+ * the key verified as entitled.
+ */
+export declare function verifyConfiguredKey(key: string): Promise<boolean>;
+/**
+ * Run the interactive configure flow. Returns a `ConfigureDoneResult`;
+ * the caller renders it through Ink, including any "current key" hint
+ * the user saw at the prompt.
+ */
+export declare function executeConfigure(): Promise<ConfigureDoneResult>;
+//# sourceMappingURL=configure.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../../src/commands/configure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAWH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAIlE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAqBpD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAevE;AAMD;;;;GAIG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CA2BrE"}

package/dist/commands/configure.js

@@ -0,0 +1,94 @@
+/**
+ * configure command — set up OpenSIP Cloud API key.
+ *
+ * Prompts via `readline` (Ink can't own a prompt loop without raw mode);
+ * banners and result lines route through Ink via the `configure-done`
+ * `CommandResult`. No `console.log` and no raw ANSI escapes here.
+ *
+ * The actual config I/O (read/write `~/.opensip-cli/config.yml`,
+ * resolve the API key from flag → env → config) lives in
+ * `@opensip-cli/config` (relocated there in ADR-0023) so the
+ * pre-action hook and this command both read it through the config
+ * layer. This file is the prompt+UX wrapper around those primitives.
+ * Audit 2026-05-23 M3.
+ */
+// @fitness-ignore-file only-documented-toolcli-seams -- interactive TTY prompts: readline prompt text + masked-key verification UX, not machine run output through a ToolCliContext seam (mirrors the ESLint exemption for this file). Result lines route through the Ink `configure-done` CommandResult. (Architecture review finding 5: host UX commands have a narrow sanctioned exemption.)
+import { join } from 'node:path';
+import { createInterface } from 'node:readline';
+import { GLOBAL_CONFIG_PATH, readGlobalConfig, writeGlobalConfig } from '@opensip-cli/config';
+import { resolveUserPaths } from '@opensip-cli/core';
+import { checkEntitlement, DEFAULT_CLOUD_ENDPOINT } from '@opensip-cli/output';
+// Re-export `resolveApiKey` from the config layer so existing command-side
+// imports (and tests) can continue to consume it through the same name.
+export { resolveApiKey } from '@opensip-cli/config';
+// ---------------------------------------------------------------------------
+// Interactive prompt
+// ---------------------------------------------------------------------------
+function prompt(question) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+function maskKey(key) {
+    if (key.length <= 8)
+        return key;
+    return `${key.slice(0, 4)}...${key.slice(-4)}`;
+}
+/**
+ * Test a freshly-entered key against the cloud entitlement endpoint — the
+ * configure flow's documented "test the key" step (audit P2-2). Prints the
+ * outcome; best-effort, never throws (checkEntitlement returns `entitled:
+ * false` on an invalid key, an unreachable endpoint, or a non-entitled plan).
+ * The key is saved regardless, so offline setup still works. Returns whether
+ * the key verified as entitled.
+ */
+export async function verifyConfiguredKey(key) {
+    process.stdout.write('Verifying key with OpenSIP Cloud...\n');
+    const { entitled } = await checkEntitlement({
+        apiKey: key,
+        endpoint: DEFAULT_CLOUD_ENDPOINT,
+        now: Date.now(),
+        cacheDir: join(resolveUserPaths().userHomeDir, 'cache'),
+    });
+    process.stdout.write(entitled
+        ? '✓ API key verified — entitled to OpenSIP Cloud storage.\n'
+        : '⚠ Could not verify the key (invalid, not entitled, or cloud unreachable).\n' +
+            '  Saved anyway; cloud sync will retry on your next run.\n');
+    return entitled;
+}
+// ---------------------------------------------------------------------------
+// executeConfigure
+// ---------------------------------------------------------------------------
+/**
+ * Run the interactive configure flow. Returns a `ConfigureDoneResult`;
+ * the caller renders it through Ink, including any "current key" hint
+ * the user saw at the prompt.
+ */
+export async function executeConfigure() {
+    const existing = readGlobalConfig();
+    if (existing.apiKey) {
+        // Pre-prompt informational line. Plain text only — Ink renders the
+        // outcome line. We emit this here because the prompt and the
+        // current-key hint share the same readline session UX.
+        process.stdout.write(`Current API key: ${maskKey(existing.apiKey)}\n`);
+    }
+    const key = await prompt('Enter your OpenSIP Cloud API key: ');
+    if (!key) {
+        return { type: 'configure-done', action: 'cancelled', configPath: GLOBAL_CONFIG_PATH };
+    }
+    existing.apiKey = key;
+    writeGlobalConfig(existing);
+    // Test the key against the cloud entitlement endpoint (documented step 4).
+    await verifyConfiguredKey(key);
+    return {
+        type: 'configure-done',
+        action: 'saved',
+        configPath: GLOBAL_CONFIG_PATH,
+        maskedKey: maskKey(key),
+    };
+}
+//# sourceMappingURL=configure.js.map

package/dist/commands/configure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure.js","sourceRoot":"","sources":["../../src/commands/configure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,gYAAgY;AAEhY,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAI/E,2EAA2E;AAC3E,wEAAwE;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,SAAS,MAAM,CAAC,QAAgB;IAC9B,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;YAC/B,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,OAAO,CAAC,GAAW;IAC1B,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC;IAChC,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACjD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAW;IACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC9D,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,gBAAgB,CAAC;QAC1C,MAAM,EAAE,GAAG;QACX,QAAQ,EAAE,sBAAsB;QAChC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE;QACf,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC;KACxD,CAAC,CAAC;IACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,QAAQ;QACN,CAAC,CAAC,2DAA2D;QAC7D,CAAC,CAAC,6EAA6E;YAC3E,2DAA2D,CAClE,CAAC;IACF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;IAEpC,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpB,mEAAmE;QACnE,6DAA6D;QAC7D,uDAAuD;QACvD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,oCAAoC,CAAC,CAAC;IAC/D,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACzF,CAAC;IAED,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC;IACtB,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAE5B,2EAA2E;IAC3E,MAAM,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAE/B,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,MAAM,EAAE,OAAO;QACf,UAAU,EAAE,kBAAkB;QAC9B,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC;KACxB,CAAC;AACJ,CAAC"}

package/dist/commands/history.d.ts

@@ -0,0 +1,18 @@
+/**
+ * history command — show run history.
+ *
+ * Backed by SessionRepo over the project-local SQLite DataStore.
+ * The CLI bootstrap opens the DataStore in `preAction`; this command
+ * receives the constructed repo from its caller.
+ */
+import type { HistoryResult } from '@opensip-cli/contracts';
+import type { ToolShortId } from '@opensip-cli/core';
+import type { DataStore } from '@opensip-cli/datastore';
+export interface ShowHistoryOptions {
+    readonly tool?: ToolShortId;
+    readonly limit?: number;
+    /** Agent ergonomics: drop the heavy per-session payload (keep showCommand + lightweight summary). */
+    readonly summaryOnly?: boolean;
+}
+export declare function showHistory(datastore: DataStore, opts?: ShowHistoryOptions): HistoryResult;
+//# sourceMappingURL=history.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/commands/history.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAiC,MAAM,wBAAwB,CAAC;AAC3F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,qGAAqG;IACrG,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,GAAE,kBAAuB,GAAG,aAAa,CAO9F"}

package/dist/commands/history.js

@@ -0,0 +1,48 @@
+/**
+ * history command — show run history.
+ *
+ * Backed by SessionRepo over the project-local SQLite DataStore.
+ * The CLI bootstrap opens the DataStore in `preAction`; this command
+ * receives the constructed repo from its caller.
+ */
+import { SessionRepo } from '@opensip-cli/session-store';
+export function showHistory(datastore, opts = {}) {
+    const repo = new SessionRepo(datastore);
+    const sessions = repo.list(opts).map((s) => toHistorySession(s, opts.summaryOnly));
+    return {
+        type: 'history',
+        sessions,
+    };
+}
+function toHistorySession(session, summaryOnly = false) {
+    const summary = sessionSummary(session.payload);
+    // In summary-only mode, drop the (potentially large) tool-owned payload for
+    // agent "menu" use cases — the lightweight summary (if present) + showCommand
+    // remain. `payload` is `readonly?`, so we omit it by spreading `rest` (without
+    // payload) and adding `payload` back only when NOT summary-only — no mutation /
+    // delete (which would need an `any` cast to bypass readonly).
+    const { payload, ...rest } = session;
+    return {
+        ...rest,
+        ...(summaryOnly ? {} : { payload }),
+        ...(summary === undefined ? {} : { summary }),
+        showCommand: `opensip sessions show ${session.id} --json`,
+    };
+}
+function sessionSummary(payload) {
+    if (payload === null || typeof payload !== 'object')
+        return undefined;
+    const summary = payload.summary;
+    if (summary === null || typeof summary !== 'object')
+        return undefined;
+    const { total, passed, failed, errors, warnings } = summary;
+    if (typeof total !== 'number' ||
+        typeof passed !== 'number' ||
+        typeof failed !== 'number' ||
+        typeof errors !== 'number' ||
+        typeof warnings !== 'number') {
+        return undefined;
+    }
+    return { total, passed, failed, errors, warnings };
+}
+//# sourceMappingURL=history.js.map

package/dist/commands/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/commands/history.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAazD,MAAM,UAAU,WAAW,CAAC,SAAoB,EAAE,OAA2B,EAAE;IAC7E,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IACnF,OAAO;QACL,IAAI,EAAE,SAAS;QACf,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAsB,EAAE,WAAW,GAAG,KAAK;IACnE,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,4EAA4E;IAC5E,8EAA8E;IAC9E,+EAA+E;IAC/E,gFAAgF;IAChF,8DAA8D;IAC9D,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IACrC,OAAO;QACL,GAAG,IAAI;QACP,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;QACnC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;QAC7C,WAAW,EAAE,yBAAyB,OAAO,CAAC,EAAE,SAAS;KAC1D,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,OAAgB;IACtC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACtE,MAAM,OAAO,GAAI,OAAiC,CAAC,OAAO,CAAC;IAC3D,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACtE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAkC,CAAC;IACvF,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,MAAM,KAAK,QAAQ;QAC1B,OAAO,MAAM,KAAK,QAAQ;QAC1B,OAAO,MAAM,KAAK,QAAQ;QAC1B,OAAO,QAAQ,KAAK,QAAQ,EAC5B,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACrD,CAAC"}

package/dist/commands/host-command-specs.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 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 { type HostSpec } from './host-subcommand-groups.js';
+import type { CliCommandsContext } from './shared.js';
+import type { CliProgram } from '@opensip-cli/contracts';
+/**
+ * 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 declare function buildTopLevelHostSpecs(ctx: CliCommandsContext): readonly HostSpec[];
+/**
+ * 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 declare function mountHostCommands(program: CliProgram, ctx: CliCommandsContext): void;
+//# sourceMappingURL=host-command-specs.d.ts.map

package/dist/commands/host-command-specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-command-specs.d.ts","sourceRoot":"","sources":["../../src/commands/host-command-specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAgBH,OAAO,EAA6B,KAAK,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAKvF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,wBAAwB,CAAC;AAiTtE;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,kBAAkB,GAAG,SAAS,QAAQ,EAAE,CASnF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,kBAAkB,GAAG,IAAI,CAUpF"}