@muhaven/mcp 0.2.9 → 0.4.0

package/dist/broker.d.cts

@@ -1,3 +1,30 @@
+/**
+ * `muhaven-broker start` / `muhaven-broker update` — install a
+ * DASHBOARD-minted Scoped session key onto the broker daemon in one shot.
+ *
+ * Wave 5 Option D OPEN-D (2026-05-24). Replaces the manual last mile after
+ * a dashboard mint / revoke:
+ *
+ *   start  — bring the daemon UP on a provided key (daemon NOT running).
+ *   update — ROTATE the key on a (possibly) running daemon: stop → swap →
+ *            restart → REUSE the existing JWT (a key rotation must not
+ *            force a device-code re-login).
+ *
+ * Both resolve the key via the shared precedence (`--session` flag >
+ * interactive masked prompt > error — see `session-input.ts`). Both
+ * REQUIRE a key (unlike `setup`, which self-mints on the fresh-install
+ * path). The key is injected ONLY into the spawned daemon's child env
+ * (**Option B** — operator decision 2026-05-24); it never touches disk,
+ * so the daemon (`loadBrokerConfig`) and the keystore stay unchanged.
+ *
+ * The orchestrator is pure-ish: all IO (broker IPC, daemon spawn, stop,
+ * login, prompts) is injected via `BringUpDeps` so the decision tree is
+ * unit-testable without spawning real processes — mirrors the
+ * `runSetup` / `runStop` style.
+ */
+
+type BringUpMode = 'start' | 'update';
+
 /**
  * `muhaven-broker` CLI subcommand router.
  *
@@ -8,6 +35,7 @@
  *   doctor         → environment + keystore capability report
  *   --help, -h     → usage
  */
+
 interface LoginFlags {
     noLaunchBrowser: boolean;
     brokerEndpoint?: string;
@@ -43,6 +71,8 @@ declare function runSetup(argv: readonly string[]): Promise<number>;
  * Wire `runStop` against the real BrokerClient + Node's process.kill.
  */
 declare function runStop(): Promise<number>;
+/** Wire `muhaven-broker start` / `update` against the real cli helpers. */
+declare function runStartOrUpdate(mode: BringUpMode, argv: readonly string[]): Promise<number>;
 declare function runCli(argv: readonly string[]): Promise<number>;
 
-export { getBrokerPackageVersion, parseLoginFlags, runCli, runDoctor, runLogin, runLogout, runSetup, runStop };
+export { getBrokerPackageVersion, parseLoginFlags, runCli, runDoctor, runLogin, runLogout, runSetup, runStartOrUpdate, runStop };

package/dist/broker.d.ts

@@ -1,3 +1,30 @@
+/**
+ * `muhaven-broker start` / `muhaven-broker update` — install a
+ * DASHBOARD-minted Scoped session key onto the broker daemon in one shot.
+ *
+ * Wave 5 Option D OPEN-D (2026-05-24). Replaces the manual last mile after
+ * a dashboard mint / revoke:
+ *
+ *   start  — bring the daemon UP on a provided key (daemon NOT running).
+ *   update — ROTATE the key on a (possibly) running daemon: stop → swap →
+ *            restart → REUSE the existing JWT (a key rotation must not
+ *            force a device-code re-login).
+ *
+ * Both resolve the key via the shared precedence (`--session` flag >
+ * interactive masked prompt > error — see `session-input.ts`). Both
+ * REQUIRE a key (unlike `setup`, which self-mints on the fresh-install
+ * path). The key is injected ONLY into the spawned daemon's child env
+ * (**Option B** — operator decision 2026-05-24); it never touches disk,
+ * so the daemon (`loadBrokerConfig`) and the keystore stay unchanged.
+ *
+ * The orchestrator is pure-ish: all IO (broker IPC, daemon spawn, stop,
+ * login, prompts) is injected via `BringUpDeps` so the decision tree is
+ * unit-testable without spawning real processes — mirrors the
+ * `runSetup` / `runStop` style.
+ */
+
+type BringUpMode = 'start' | 'update';
+
 /**
  * `muhaven-broker` CLI subcommand router.
  *
@@ -8,6 +35,7 @@
  *   doctor         → environment + keystore capability report
  *   --help, -h     → usage
  */
+
 interface LoginFlags {
     noLaunchBrowser: boolean;
     brokerEndpoint?: string;
@@ -43,6 +71,8 @@ declare function runSetup(argv: readonly string[]): Promise<number>;
  * Wire `runStop` against the real BrokerClient + Node's process.kill.
  */
 declare function runStop(): Promise<number>;
+/** Wire `muhaven-broker start` / `update` against the real cli helpers. */
+declare function runStartOrUpdate(mode: BringUpMode, argv: readonly string[]): Promise<number>;
 declare function runCli(argv: readonly string[]): Promise<number>;
 
-export { getBrokerPackageVersion, parseLoginFlags, runCli, runDoctor, runLogin, runLogout, runSetup, runStop };
+export { getBrokerPackageVersion, parseLoginFlags, runCli, runDoctor, runLogin, runLogout, runSetup, runStartOrUpdate, runStop };