opensip-cli 0.1.0

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

@@ -0,0 +1,313 @@
+/**
+ * mount-command-spec — the host-owned layer that turns a declarative
+ * {@link CommandSpec} (core, Phase 0) into a wired Commander command.
+ *
+ * Generalizes {@link mountResultCommand}: it mounts ANY command (tool or host)
+ * from its typed spec — translating each `OptionSpec`/`ArgSpec` into Commander
+ * wiring, applying the shared common flags (ADR-0021), and owning the uniform
+ * `parse → handler → dispatch output → map error → exit` pipeline. Tools never
+ * touch Commander; they export specs and the host mounts them (north-star §5.4).
+ *
+ * The single output-dispatch seam — {@link dispatchOutput} — wraps every machine
+ * output in a `CommandOutcome` serialized through the one `renderOutcome` seam.
+ * The wrap lives in the host emit seams this delegates to (`emitCommandResult`,
+ * `ctx.emitEnvelope`), so the handler contract stayed byte-identical (§5.5).
+ */
+import { applyCommonFlags, mapToolErrorToExitCode, } from '@opensip-cli/contracts';
+import { ToolError, currentScope, } from '@opensip-cli/core';
+import { Option } from 'commander';
+import { emitCommandResult } from './mount-result-command.js';
+/**
+ * Mount a declarative {@link CommandSpec} onto `program` as a fully wired
+ * Commander command.
+ *
+ * Steps (mirroring each tool's former hand-rolled `register()` body, now
+ * host-owned and uniform):
+ *   1. `program.command(name)` + description + aliases.
+ *   2. `applyCommonFlags(cmd, spec.commonFlags)` — the ADR-0021 registry flags.
+ *      `cwd` (the only computed default) is seeded with `process.cwd()`.
+ *   3. Each {@link OptionSpec} → a Commander `Option` (value vs boolean,
+ *      `negatable` `--no-` form, `default` / `arrayDefault`, `choices`,
+ *      `parse` argParser, `variadic`, `required` mandatory).
+ *   4. Each {@link ArgSpec} → `cmd.argument(...)` (variadic / optional bracketing).
+ *   5. `cmd.action(...)` → run `spec.handler(opts, ctx)` → {@link dispatchOutput}
+ *      → on a thrown {@link ToolError}, `mapToolErrorToExitCode` → `ctx.setExitCode`.
+ *
+ * @param program The root Commander program (the entry layer's `CliProgram`).
+ * @param spec    The declarative command surface the tool/host exported.
+ * @param ctx     The per-invocation host context (render/envelope/live-view
+ *                emitters, exit-code setter) — today's `ToolCliContext`.
+ */
+export function mountCommandSpec(program, spec, ctx) {
+    const cmd = program.command(spec.name).description(spec.description);
+    if (spec.aliases !== undefined && spec.aliases.length > 0) {
+        cmd.aliases([...spec.aliases]);
+    }
+    // ADR-0021 common flags. `cwd` is the only flag with a computed (per-
+    // invocation) default; the registry leaves it to the caller, so seed it here.
+    const seedsCwd = spec.commonFlags.includes('cwd');
+    applyCommonFlags(cmd, spec.commonFlags, seedsCwd ? { cwd: process.cwd() } : undefined);
+    for (const optionSpec of spec.options ?? []) {
+        cmd.addOption(buildOption(optionSpec, spec.name));
+    }
+    for (const argSpec of spec.args ?? []) {
+        cmd.argument(formatArgUsage(argSpec), argSpec.description);
+    }
+    // Action body: parse → handler → dispatch → map error → exit. Commander
+    // passes positional args first, then the parsed-opts object, then the
+    // Command. We forward the parsed opts (which carry both common + spec flags)
+    // and the trailing positional args to the handler and the dispatch seam.
+    //
+    // Positionals ride on the opts object under the `_args` key — the same
+    // convention the `live-view` dispatch arm already uses (`{ ...opts, _args }`).
+    // This lets a `raw-stream`/`signal-envelope`/`command-result` handler that
+    // declares `args` read its positionals (`opts._args`) without a separate
+    // handler-arity contract: graph's `[paths...]`, `<name>`, `<specPath>` all
+    // flow through here. Commands with no declared `args` get an empty array.
+    cmd.action(async (...actionArgs) => {
+        const { opts, positionals } = splitActionArgs(actionArgs);
+        const optsWithArgs = { ...opts, _args: positionals };
+        // Lifecycle diagnostics (§5.10): bracket the handler with `execute` events so
+        // every CommandOutcome carries a record that this command ran. Scope-bound via
+        // the pre-action hook's enterScope; a no-op when no scope is present (tests).
+        const diagnostics = currentScope()?.diagnostics;
+        diagnostics?.event('execute', 'debug', `command '${spec.name}' started`);
+        // Host run lifecycle (host-owned-run-timing): mark the start boundary at the
+        // command-action entry — after RunScope is entered, before the tool handler
+        // runs. The hooks ride on the host ctx (not the public ToolCliContext type);
+        // read via cast, like `runSession` below. No-op for host commands whose
+        // leaner context carries no run plane.
+        const runHooks = ctx;
+        runHooks.beginRun?.();
+        try {
+            const result = await spec.handler(optsWithArgs, ctx);
+            diagnostics?.event('execute', 'debug', `command '${spec.name}' completed`);
+            // Static-path completion: if the handler returned a ToolRunCompletion with
+            // a session contribution, the host freezes the lifecycle and persists it.
+            // A plain CommandResult (no session) is a no-op — there is no tool-side
+            // generic-session writer. The live-view path persists after renderLive.
+            runHooks.completeRun?.(result);
+            await dispatchOutput(result, spec, optsWithArgs, positionals, ctx);
+        }
+        catch (error) {
+            if (error instanceof ToolError) {
+                diagnostics?.event('execute', 'error', `command '${spec.name}' failed: ${error.message}`);
+                ctx.setExitCode(mapToolErrorToExitCode(error));
+                return;
+            }
+            throw error;
+        }
+    });
+}
+/**
+ * The SINGLE output-dispatch seam. The launch `CommandOutcome` wrap is LANDED:
+ * the host emit seams this delegates to (`emitCommandResult`, `ctx.emitEnvelope`)
+ * now build a `CommandOutcome` and serialize it through the one `renderOutcome`
+ * seam. The handler contract and the mounter above stayed byte-identical — all
+ * the outer-shape change landed in those seams (north-star §5.5), so the handler
+ * keeps returning its pure-domain `CommandResult` / `SignalEnvelope`.
+ *
+ * Routes the handler's return value by the command's declared
+ * {@link CommandSpec.output} mode:
+ *   - `command-result`  — the existing `emitCommandResult` seam (json
+ *                         short-circuit / `ctx.render`), shared verbatim with
+ *                         {@link mountResultCommand}.
+ *   - `signal-envelope` — the run-envelope machine-output path: `--json` emits
+ *                         through `ctx.emitEnvelope` (the shared ADR-0011
+ *                         formatter), otherwise `ctx.render`.
+ *   - `raw-stream`      — explicit raw output (no Ink): the handler already
+ *                         wrote its file + line; the host renders nothing.
+ *   - `live-view`       — the interactive Ink path: `ctx.renderLive(key, args)`
+ *                         against the tool's registered renderer.
+ *
+ * @throws {Error} When a command declares `signal-envelope` / `live-view` output
+ *   but the mount context provides no `emitEnvelope` / `renderLive` emitter — a
+ *   mis-declared host spec fails loudly here rather than silently no-op'ing.
+ */
+export async function dispatchOutput(result, spec, opts, positionals, ctx) {
+    const jsonRequested = opts.json === true;
+    switch (spec.output) {
+        case 'command-result': {
+            await emitCommandResult(result, {
+                render: (r) => ctx.render(r),
+                jsonRequested,
+            });
+            return;
+        }
+        case 'signal-envelope': {
+            if (jsonRequested) {
+                if (ctx.emitEnvelope === undefined) {
+                    throw new Error(`mountCommandSpec: command '${spec.name}' declares output 'signal-envelope' ` +
+                        'but the mount context provides no emitEnvelope (host commands are ' +
+                        "'command-result' / 'raw-stream' only).");
+                }
+                ctx.emitEnvelope(result);
+            }
+            else {
+                await ctx.render(result);
+            }
+            return;
+        }
+        case 'raw-stream': {
+            // The handler is responsible for its own stdout / file IO (a documented
+            // exception: completion scripts, baseline/SARIF exports). Nothing to
+            // render — the host does not touch the stream.
+            return;
+        }
+        case 'live-view': {
+            // Dispatch to the tool's registered Ink renderer, keyed by the command
+            // NAME (the tool registers its renderer under that key in its setup
+            // hook — sim under 'sim', graph under 'graph'). The host forwards the
+            // parsed opts + trailing positionals as the args payload; the handler's
+            // return value is unused for this mode (the Ink app owns rendering).
+            if (ctx.renderLive === undefined) {
+                throw new Error(`mountCommandSpec: command '${spec.name}' declares output 'live-view' ` +
+                    'but the mount context provides no renderLive (host commands are ' +
+                    "'command-result' / 'raw-stream' only).");
+            }
+            // Thread the host-owned runSession (via LiveViewContext) so the live
+            // renderer receives the *same* timer the static path used. Only full
+            // ToolCliContext (tool live-view commands) will have runSession; lean
+            // host contexts won't reach here.
+            const liveContext = ctx.runSession
+                ? { runSession: ctx.runSession }
+                : undefined;
+            await ctx.renderLive(spec.name, { ...opts, _args: positionals }, liveContext);
+            return;
+        }
+    }
+}
+/**
+ * Build a Commander {@link Option} from an {@link OptionSpec}, covering every
+ * shape in the first-party flag corpus: boolean / value, negatable `--no-`,
+ * literal `default` and repeatable `arrayDefault`, `choices`, the pure `parse`
+ * argParser, variadic, and `required` (mandatory).
+ *
+ * @throws {Error} When the spec marks a boolean (valueless) option `required`
+ *   — only value options can be made mandatory.
+ */
+function buildOption(spec, commandName) {
+    const valuePlaceholder = resolveValuePlaceholder(spec);
+    const flags = valuePlaceholder === undefined ? spec.flag : `${spec.flag} ${valuePlaceholder}`;
+    const option = new Option(flags, spec.description);
+    if (spec.choices !== undefined && spec.choices.length > 0) {
+        option.choices([...spec.choices]);
+    }
+    if (spec.parse !== undefined) {
+        // Commander's argParser is `(value, previous) => next` — exactly the
+        // declared `OptionSpec.parse` reducer shape (Number coercion, repeatable
+        // accumulation, validated ints).
+        option.argParser(spec.parse);
+    }
+    // `arrayDefault` (repeatable accumulators) wins over a scalar `default`;
+    // Commander uses it as the seed the `parse` reducer accumulates onto.
+    if (spec.arrayDefault !== undefined) {
+        option.default([...spec.arrayDefault]);
+    }
+    else if (spec.default !== undefined) {
+        option.default(spec.default);
+    }
+    if (spec.required === true) {
+        if (valuePlaceholder === undefined) {
+            throw new Error(`mountCommandSpec: command '${commandName}' option '${spec.flag}' is required but takes no value; ` +
+                'only value options can be required.');
+        }
+        option.makeOptionMandatory(true);
+    }
+    return option;
+}
+/**
+ * Resolve the value placeholder for an option, applying variadic `...` when
+ * declared. Returns `undefined` for a boolean / negatable flag (no value).
+ */
+function resolveValuePlaceholder(spec) {
+    if (spec.negatable === true)
+        return undefined;
+    if (spec.value === undefined)
+        return undefined;
+    if (spec.variadic === true && !spec.value.includes('...')) {
+        // Inject the variadic ellipsis inside the existing bracket pair, e.g.
+        // `<slug>` → `<slug...>`, `[path]` → `[path...]`.
+        return spec.value.replace(/([>\]])$/, '...$1');
+    }
+    return spec.value;
+}
+/**
+ * Format an {@link ArgSpec} into Commander argument-usage syntax: `<name>`
+ * (required), `[name]` (optional), with `...` appended for variadic.
+ */
+function formatArgUsage(spec) {
+    const inner = spec.variadic === true ? `${spec.name}...` : spec.name;
+    return spec.optional === true ? `[${inner}]` : `<${inner}>`;
+}
+/**
+ * Best-effort guard: does `x` look like a Commander `Command` instance?
+ * Used defensively in splitActionArgs so we never treat the Command object
+ * as the parsed opts (which would silently give every handler a weird
+ * `opts` bag containing Commander internals and produce very confusing bugs).
+ */
+function isLikelyCommanderCommand(x) {
+    if (!x || typeof x !== 'object')
+        return false;
+    const c = x;
+    // Commander Command instances have these characteristic members.
+    return (typeof c.name === 'function' ||
+        typeof c.opts === 'function' ||
+        typeof c.command === 'function' ||
+        (typeof c.constructor === 'function' && /Command/i.test(c.constructor.name || '')));
+}
+/**
+ * Split a Commander action callback's variadic arguments into the parsed-opts
+ * object and the trailing positional args.
+ *
+ * Commander calls `action((...positionalArgs, optsObject, command))`: the
+ * declared positionals come first, then the parsed-options object, then the
+ * `Command` instance. We locate the opts object by scanning left from the
+ * slot before the final Command for the rightmost plain (non-array, non-Command)
+ * object. Everything before that index is treated as positionals.
+ *
+ * This scan is robust: positionals (typically strings/paths for variadics) are
+ * never inspected for "object-ness" during the search, so a defensive walk
+ * cannot accidentally eat legitimate leading positionals when an intermediate
+ * value looks unusual (future Commander arity change, wrappers, etc.).
+ *
+ * If no plausible opts object is found, we treat the entire prefix before the
+ * Command as positionals and opts as {} (fail-closed paranoia below still applies).
+ *
+ * @throws {Error} On the defensive, normally-unreachable path where no opts object
+ *   can be located among the action arguments (surfaced loudly so tests/CI catch it).
+ */
+function splitActionArgs(actionArgs) {
+    if (actionArgs.length === 0) {
+        return { opts: {}, positionals: [] };
+    }
+    const lastIdx = actionArgs.length - 1;
+    // The final argument is (per Commander contract) the Command instance.
+    if (!isLikelyCommanderCommand(actionArgs[lastIdx])) {
+        // Extremely unexpected — log via throw so tests/CI surface it loudly.
+        throw new Error('mountCommandSpec: splitActionArgs could not locate Commander Command as the final action argument. ' +
+            'This indicates an incompatible Commander version or a wrapped dispatch. ' +
+            'Please report this with your Commander version.');
+    }
+    // Scan left from the slot immediately before the Command. The first (rightmost)
+    // plain non-array non-Command object we encounter is the parsed opts.
+    for (let i = lastIdx - 1; i >= 0; i--) {
+        const v = actionArgs[i];
+        if (v && typeof v === 'object' && !Array.isArray(v) && !isLikelyCommanderCommand(v)) {
+            const opts = v;
+            const positionals = actionArgs.slice(0, i);
+            // Extra paranoia: if what we selected smells like Command, refuse.
+            if (isLikelyCommanderCommand(opts)) {
+                throw new Error('mountCommandSpec: splitActionArgs selected a Commander Command as the parsed opts. ' +
+                    'Refusing to dispatch — this is a bug in argument splitting.');
+            }
+            return { opts, positionals };
+        }
+    }
+    // No plain opts object found before the Command (defensive). All prior args
+    // become positionals; the handler will see a bare {} for opts (still better
+    // than handing it a Command or corrupting _args).
+    const positionals = actionArgs.slice(0, lastIdx);
+    return { opts: {}, positionals };
+}
+//# sourceMappingURL=mount-command-spec.js.map

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

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

package/dist/commands/mount-result-command.d.ts

@@ -0,0 +1,71 @@
+/**
+ * mount-result-command — action-body helper for CLI-owned subcommands
+ * that produce a `CommandResult`.
+ *
+ * Centralizes the per-subcommand boilerplate every result-producing
+ * action body would otherwise repeat:
+ *
+ *   - Run the supplied handler (sync or async).
+ *   - If `--json` was set, emit the result as JSON to stdout and bail
+ *     before Ink starts. Bypassing the renderer keeps `--json`
+ *     contract-faithful: machine consumers should never see ANSI
+ *     escapes or Ink's whitespace adjustments.
+ *   - Otherwise route the result through the renderer the dispatcher
+ *     wired into the context.
+ *
+ * Two shapes are exposed:
+ *
+ *   - `mountResultCommand(cmd, handler)` — opts-only handler. Used by
+ *     `init`, `sessions list`, `plugin list`, `plugin sync`.
+ *   - `mountResultCommandWithArg(cmd, handler)` — single-positional-arg
+ *     handler. Used by `plugin add` / `plugin remove`.
+ *
+ * Phase 5 of the Layer 5 plan introduces this helper; Phase 6 routes
+ * `clear` and `configure` through it (eliminating the last raw-ANSI
+ * bypasses).
+ */
+import type { CliCommandsContext } from './shared.js';
+import type { CommandResult } from '@opensip-cli/contracts';
+import type { Command } from 'commander';
+export type CommandHandler<TOpts> = (opts: TOpts) => CommandResult | Promise<CommandResult>;
+export interface MountResultCommandOptions<TOpts> {
+    readonly ctx: CliCommandsContext;
+    /**
+     * Pull the `--json` flag value out of the parsed Commander options.
+     * The `--json` flag itself is the caller's responsibility — they
+     * declare it on their `Command` before mounting. The mount helper
+     * doesn't add the flag so each subcommand can keep its own help text.
+     */
+    readonly jsonFlag?: (opts: TOpts) => boolean | undefined;
+}
+/**
+ * Mount a result-producing handler as the action body of `cmd`.
+ * The handler returns a `CommandResult`; `mountResultCommand` handles
+ * the `--json` short-circuit and the Ink render dispatch.
+ */
+export declare function mountResultCommand<TOpts>(cmd: Command, handler: CommandHandler<TOpts>, opts: MountResultCommandOptions<TOpts>): void;
+export type CommandHandlerWithArg<TArg, TOpts> = (arg: TArg, opts: TOpts) => CommandResult | Promise<CommandResult>;
+/**
+ * Same as `mountResultCommand` but for commands that take exactly one
+ * positional argument (e.g. `plugin add <package>`). Commander passes
+ * the positional arg before the parsed opts.
+ */
+export declare function mountResultCommandWithArg<TArg, TOpts>(cmd: Command, handler: CommandHandlerWithArg<TArg, TOpts>, opts: MountResultCommandOptions<TOpts>): void;
+/**
+ * The shared `command-result` dispatch seam, extracted so the declarative
+ * `mountCommandSpec` (the `output: 'command-result'` arm of `dispatchOutput`) and
+ * the imperative `mountResultCommand` route a `CommandResult` through ONE point
+ * instead of duplicating the json-short-circuit / `render` decision.
+ *
+ * launch (§5.5): the result is wrapped in a `CommandOutcome` (`.data`, or
+ * `.errors` for an `ErrorResult`) and serialized through the single
+ * `renderOutcome` seam. `--json` emits the whole outcome; human mode renders the
+ * inner result through the supplied renderer — byte-identical to the prior human
+ * output. Machine consumers must never see ANSI escapes, so the JSON path never
+ * renders.
+ */
+export declare function emitCommandResult(result: CommandResult, opts: {
+    readonly render: (result: CommandResult) => Promise<void>;
+    readonly jsonRequested: boolean;
+}): Promise<void>;
+//# sourceMappingURL=mount-result-command.d.ts.map

package/dist/commands/mount-result-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount-result-command.d.ts","sourceRoot":"","sources":["../../src/commands/mount-result-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,MAAM,cAAc,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,KAAK,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5F,MAAM,WAAW,yBAAyB,CAAC,KAAK;IAC9C,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,GAAG,SAAS,CAAC;CAC1D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EACtC,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,EAC9B,IAAI,EAAE,yBAAyB,CAAC,KAAK,CAAC,GACrC,IAAI,CAKN;AAED,MAAM,MAAM,qBAAqB,CAAC,IAAI,EAAE,KAAK,IAAI,CAC/C,GAAG,EAAE,IAAI,EACT,IAAI,EAAE,KAAK,KACR,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,KAAK,EACnD,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,qBAAqB,CAAC,IAAI,EAAE,KAAK,CAAC,EAC3C,IAAI,EAAE,yBAAyB,CAAC,KAAK,CAAC,GACrC,IAAI,CAKN;AAaD;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE;IACJ,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC,GACA,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/dist/commands/mount-result-command.js

@@ -0,0 +1,76 @@
+/**
+ * mount-result-command — action-body helper for CLI-owned subcommands
+ * that produce a `CommandResult`.
+ *
+ * Centralizes the per-subcommand boilerplate every result-producing
+ * action body would otherwise repeat:
+ *
+ *   - Run the supplied handler (sync or async).
+ *   - If `--json` was set, emit the result as JSON to stdout and bail
+ *     before Ink starts. Bypassing the renderer keeps `--json`
+ *     contract-faithful: machine consumers should never see ANSI
+ *     escapes or Ink's whitespace adjustments.
+ *   - Otherwise route the result through the renderer the dispatcher
+ *     wired into the context.
+ *
+ * Two shapes are exposed:
+ *
+ *   - `mountResultCommand(cmd, handler)` — opts-only handler. Used by
+ *     `init`, `sessions list`, `plugin list`, `plugin sync`.
+ *   - `mountResultCommandWithArg(cmd, handler)` — single-positional-arg
+ *     handler. Used by `plugin add` / `plugin remove`.
+ *
+ * Phase 5 of the Layer 5 plan introduces this helper; Phase 6 routes
+ * `clear` and `configure` through it (eliminating the last raw-ANSI
+ * bypasses).
+ */
+import { outcomeFromResult } from './assemble-outcome.js';
+import { renderOutcome } from './render-outcome.js';
+/**
+ * Mount a result-producing handler as the action body of `cmd`.
+ * The handler returns a `CommandResult`; `mountResultCommand` handles
+ * the `--json` short-circuit and the Ink render dispatch.
+ */
+export function mountResultCommand(cmd, handler, opts) {
+    cmd.action(async (parsedOpts) => {
+        const result = await handler(parsedOpts);
+        await emit(result, opts, parsedOpts);
+    });
+}
+/**
+ * Same as `mountResultCommand` but for commands that take exactly one
+ * positional argument (e.g. `plugin add <package>`). Commander passes
+ * the positional arg before the parsed opts.
+ */
+export function mountResultCommandWithArg(cmd, handler, opts) {
+    cmd.action(async (arg, parsedOpts) => {
+        const result = await handler(arg, parsedOpts);
+        await emit(result, opts, parsedOpts);
+    });
+}
+async function emit(result, opts, parsedOpts) {
+    await emitCommandResult(result, {
+        render: opts.ctx.render,
+        jsonRequested: opts.jsonFlag?.(parsedOpts) ?? false,
+    });
+}
+/**
+ * The shared `command-result` dispatch seam, extracted so the declarative
+ * `mountCommandSpec` (the `output: 'command-result'` arm of `dispatchOutput`) and
+ * the imperative `mountResultCommand` route a `CommandResult` through ONE point
+ * instead of duplicating the json-short-circuit / `render` decision.
+ *
+ * launch (§5.5): the result is wrapped in a `CommandOutcome` (`.data`, or
+ * `.errors` for an `ErrorResult`) and serialized through the single
+ * `renderOutcome` seam. `--json` emits the whole outcome; human mode renders the
+ * inner result through the supplied renderer — byte-identical to the prior human
+ * output. Machine consumers must never see ANSI escapes, so the JSON path never
+ * renders.
+ */
+export async function emitCommandResult(result, opts) {
+    await renderOutcome(outcomeFromResult(result, 0), {
+        jsonRequested: opts.jsonRequested,
+        render: opts.render,
+    });
+}
+//# sourceMappingURL=mount-result-command.js.map

package/dist/commands/mount-result-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount-result-command.js","sourceRoot":"","sources":["../../src/commands/mount-result-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAmBpD;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAY,EACZ,OAA8B,EAC9B,IAAsC;IAEtC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,UAAiB,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;QACzC,MAAM,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC;AAOD;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,GAAY,EACZ,OAA2C,EAC3C,IAAsC;IAEtC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,GAAS,EAAE,UAAiB,EAAE,EAAE;QAChD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAC9C,MAAM,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,IAAI,CACjB,MAAqB,EACrB,IAAsC,EACtC,UAAiB;IAEjB,MAAM,iBAAiB,CAAC,MAAM,EAAE;QAC9B,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM;QACvB,aAAa,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK;KACpD,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAqB,EACrB,IAGC;IAED,MAAM,aAAa,CAAC,iBAAiB,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE;QAChD,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/plugin/config-edit.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview YAML-driven edits to `plugins.<domain>` in
+ * `opensip-cli.config.yml`.
+ *
+ * Extracted from `commands/plugin.ts` to keep that module focused on
+ * Commander wiring + the npm install/uninstall flows. The Document API
+ * round-trips comments, ordering, and whitespace; a malformed document
+ * fails closed so the caller surfaces a clear error.
+ */
+/**
+ * Edit the project's `plugins.<domain>` list. Returns true when the
+ * file was changed.
+ *
+ * @throws Error when the YAML document is malformed or its root is not
+ *   a mapping. The caller surfaces a "your config is broken" message.
+ */
+export declare function editPluginList(configPath: string, domain: string, name: string, op: 'add' | 'remove'): boolean;
+export declare function addToConfigPluginList(configPath: string, domain: string, name: string): boolean;
+export declare function removeFromConfigPluginList(configPath: string, domain: string, name: string): boolean;
+//# sourceMappingURL=config-edit.d.ts.map

package/dist/commands/plugin/config-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-edit.d.ts","sourceRoot":"","sources":["../../../src/commands/plugin/config-edit.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAcH;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,KAAK,GAAG,QAAQ,GACnB,OAAO,CAwCT;AAuDD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/F;AAED,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,OAAO,CAET"}

package/dist/commands/plugin/config-edit.js

@@ -0,0 +1,102 @@
+// @fitness-ignore-file silent-early-returns -- config-edit helpers (editPluginList/appendToPluginList/removeFromPluginList) return boolean as their documented "did I modify?" contract: false means "no-op / idempotent (already present, already absent, nothing to remove)"; explicit idempotency signals, not silent failures.
+// @fitness-ignore-file unbounded-memory -- reads opensip-cli.config.yml; bounded by configuration shape.
+/**
+ * @fileoverview YAML-driven edits to `plugins.<domain>` in
+ * `opensip-cli.config.yml`.
+ *
+ * Extracted from `commands/plugin.ts` to keep that module focused on
+ * Commander wiring + the npm install/uninstall flows. The Document API
+ * round-trips comments, ordering, and whitespace; a malformed document
+ * fails closed so the caller surfaces a clear error.
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { parseDocument, isMap, isScalar, isSeq, } from 'yaml';
+/**
+ * Edit the project's `plugins.<domain>` list. Returns true when the
+ * file was changed.
+ *
+ * @throws Error when the YAML document is malformed or its root is not
+ *   a mapping. The caller surfaces a "your config is broken" message.
+ */
+export function editPluginList(configPath, domain, name, op) {
+    if (!existsSync(configPath)) {
+        if (op === 'remove')
+            return false;
+        // No config to edit — write a minimal one.
+        writeFileSync(configPath, `plugins:\n  ${domain}:\n    - "${name}"\n`, 'utf8');
+        return true;
+    }
+    const text = readFileSync(configPath, 'utf8');
+    const doc = parseDocument(text);
+    if (doc.errors.length > 0) {
+        const first = doc.errors[0]?.message ?? 'unknown YAML error';
+        throw new Error(`Cannot edit plugins.${domain} in ${configPath}: ${first}. ` +
+            `Fix the syntax error and re-run.`);
+    }
+    const root = doc.contents;
+    if (root === null) {
+        if (op === 'remove')
+            return false;
+        // Empty doc — write a fresh `plugins:` map.
+        writeFileSync(configPath, `plugins:\n  ${domain}:\n    - "${name}"\n`, 'utf8');
+        return true;
+    }
+    // The top-level node must be a YAML map. A scalar / sequence at
+    // the root means the file isn't an opensip-cli config — refuse
+    // to edit rather than reformat the whole thing.
+    if (!isMap(root)) {
+        throw new Error(`Cannot edit plugins.${domain} in ${configPath}: top-level node is not a mapping. ` +
+            `opensip-cli.config.yml must start with a YAML map.`);
+    }
+    if (op === 'add') {
+        return appendToPluginList(doc, root, domain, name, configPath);
+    }
+    return removeFromPluginList(doc, root, domain, name, configPath);
+}
+function appendToPluginList(doc, root, domain, name, configPath) {
+    let plugins = root.get('plugins');
+    if (!isMap(plugins)) {
+        plugins = doc.createNode({});
+        root.set('plugins', plugins);
+    }
+    const pluginsMap = plugins;
+    let list = pluginsMap.get(domain);
+    if (!isSeq(list)) {
+        list = doc.createNode([]);
+        pluginsMap.set(domain, list);
+    }
+    const seq = list;
+    // Idempotent — first occurrence wins.
+    for (const item of seq.items) {
+        const value = isScalar(item) ? item.value : item;
+        if (value === name)
+            return false;
+    }
+    seq.add(name);
+    writeFileSync(configPath, doc.toString(), 'utf8');
+    return true;
+}
+function removeFromPluginList(doc, root, domain, name, configPath) {
+    const plugins = root.get('plugins');
+    if (!isMap(plugins))
+        return false;
+    const list = plugins.get(domain);
+    if (!isSeq(list))
+        return false;
+    const before = list.items.length;
+    list.items = list.items.filter((item) => {
+        const value = isScalar(item) ? item.value : item;
+        return value !== name;
+    });
+    if (list.items.length === before)
+        return false;
+    writeFileSync(configPath, doc.toString(), 'utf8');
+    return true;
+}
+export function addToConfigPluginList(configPath, domain, name) {
+    return editPluginList(configPath, domain, name, 'add');
+}
+export function removeFromConfigPluginList(configPath, domain, name) {
+    return editPluginList(configPath, domain, name, 'remove');
+}
+//# sourceMappingURL=config-edit.js.map

package/dist/commands/plugin/config-edit.js.map

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