@moneysiren/cli 0.1.0-alpha.1 → 0.1.0-alpha.2

package/README.md

@@ -67,7 +67,7 @@ Install the generated tarball into a temporary project:
 mkdir -p /tmp/moneysiren-alpha-review
 cd /tmp/moneysiren-alpha-review
 npm init -y
-npm install /path/to/moneysiren-cli-0.1.0-alpha.1.tgz
+npm install /path/to/moneysiren-cli-0.1.0-alpha.2.tgz
 npm exec moneysiren
 npm exec moneysiren -- --version
 npm exec moneysiren -- /version
@@ -83,7 +83,7 @@ PowerShell equivalent for the temporary project:
 New-Item -ItemType Directory -Force -Path $env:TEMP\moneysiren-alpha-review
 Set-Location $env:TEMP\moneysiren-alpha-review
 npm init -y
-npm install C:\path\to\moneysiren-cli-0.1.0-alpha.1.tgz
+npm install C:\path\to\moneysiren-cli-0.1.0-alpha.2.tgz
 npm exec moneysiren
 npm exec moneysiren -- --version
 npm exec moneysiren -- modes

package/dist/apps/cli/src/cli.d.ts

@@ -1,4 +1,5 @@
 import { type CliLocalRuntimeAdapter } from "./runtime-adapter.js";
+import type { CliDesktopRuntimeAdapter } from "./desktop-runtime.js";
 import { type Theme } from "./theme.js";
 import type { SlackReportTransport } from "../../../packages/report/src/index.js";
 import type { AwsCostExplorerClientAdapter } from "../../../packages/connectors/aws/src/index.js";
@@ -23,6 +24,7 @@ export interface CliRuntime {
     liveClients?: CliLiveClients;
     fetch?: typeof fetch;
     localRuntime?: CliLocalRuntimeAdapter;
+    desktopRuntime?: CliDesktopRuntimeAdapter;
     openUrl?: (url: string) => Promise<void> | void;
 }
 export interface CliLiveClients {
@@ -46,6 +48,7 @@ export interface CliExecutionContext {
     interactive: boolean;
     theme: Theme;
     localRuntime?: CliLocalRuntimeAdapter;
+    desktopRuntime?: CliDesktopRuntimeAdapter;
 }
 export interface CliResult {
     exitCode: number;

package/dist/apps/cli/src/cli.js

@@ -5,7 +5,7 @@ import { runInstallCommand } from "./commands/install.js";
 import { runModesCommand } from "./commands/modes.js";
 import { runNotifyCommand } from "./commands/notify.js";
 import { runReportCommand } from "./commands/report.js";
-import { runDesktopCommand, runOpenCommand, runServeCommand } from "./commands/runtime.js";
+import { runDesktopCommand, runHudCommand, runOpenCommand, runServeCommand, runStartCommand } from "./commands/runtime.js";
 import { runSummaryCommand } from "./commands/summary.js";
 import { runSyncCommand } from "./commands/sync.js";
 import { runThemeCommand } from "./commands/theme.js";
@@ -61,6 +61,7 @@ export async function runCli(args, runtime = {}) {
         }),
         theme,
         ...(runtime.localRuntime === undefined ? {} : { localRuntime: runtime.localRuntime }),
+        ...(runtime.desktopRuntime === undefined ? {} : { desktopRuntime: runtime.desktopRuntime }),
     };
     context.stdin = runtime.stdin ?? process.stdin;
     context.output = runtime.output ?? process.stdout;
@@ -130,6 +131,12 @@ async function dispatchCommand(args, context) {
     if (command === "serve") {
         return runServeCommand(rest, context);
     }
+    if (command === "start") {
+        return runStartCommand(rest, context);
+    }
+    if (command === "hud") {
+        return runHudCommand(rest, context);
+    }
     if (command === "open") {
         return runOpenCommand(rest, context);
     }
@@ -152,7 +159,7 @@ async function dispatchCommand(args, context) {
         return runThemeCommand(rest, context);
     }
     context.stderr(`Unknown command: ${command}`);
-    context.stderr("Run `moneysiren --help` for usage.");
+    context.stderr("Run `msiren --help` or `moneysiren --help` for usage.");
     return 1;
 }
 async function dispatchSlashCommand(args, context) {

package/dist/apps/cli/src/commands/modes.js

@@ -17,28 +17,30 @@ export async function runModesCommand(args, context) {
     context.stdout(`Platform: ${platformLabel()}`);
     context.stdout(`Install profile: ${formatInstallSurfaces(selectedSurfaces)}${profile === null ? " (recommended default)" : ""}`);
     context.stdout("npm install: npm install -g @moneysiren/cli@alpha");
+    context.stdout("Short command: msiren");
     context.stdout(`Runtime lock: ${runtimeLockHint()}`);
     context.stdout("");
     context.stdout("1. CLI automation");
     context.stdout(`   Status: ${surfaceStatus("cli", selectedSurfaces)} from the npm CLI package`);
-    context.stdout("   Try: moneysiren doctor");
-    context.stdout("   Try: moneysiren sync --provider mock");
+    context.stdout("   Try: msiren doctor");
+    context.stdout("   Try: msiren sync --provider mock");
     context.stdout("");
     context.stdout("2. Local web dashboard/runtime");
     context.stdout(`   Status: ${surfaceStatus("web", selectedSurfaces)} GitHub Release web runtime archive is installed by the CLI`);
-    context.stdout("   Install: moneysiren install --web");
-    context.stdout("   Try: moneysiren serve [--port <port>]");
-    context.stdout("   Try: moneysiren dashboard check");
-    context.stdout("   Note: the npm CLI starts the local API; full dashboard runtime ships as a release asset.");
+    context.stdout("   Install: msiren install --web");
+    context.stdout("   Try: msiren start");
+    context.stdout("   Try: msiren dashboard check");
+    context.stdout("   Note: msiren start runs the installed GitHub Release web runtime.");
     context.stdout("");
     context.stdout("3. Desktop tray/notifier");
     context.stdout(`   Status: ${surfaceStatus("hud", selectedSurfaces)} Windows/macOS target is the thin Tauri tray shell from GitHub Releases`);
-    context.stdout("   Install: moneysiren install --hud");
-    context.stdout("   Try: moneysiren desktop status");
-    context.stdout("   Try: moneysiren notify once --dry-run");
+    context.stdout("   Install: msiren install --hud");
+    context.stdout("   Try: msiren hud");
+    context.stdout("   Try: msiren desktop status");
+    context.stdout("   Try: msiren notify once --dry-run");
     context.stdout("");
-    context.stdout("Install recommended set: moneysiren install --all");
-    context.stdout("Change selection only: moneysiren install --profile-only");
+    context.stdout("Install recommended set: msiren install --all");
+    context.stdout("Change selection only: msiren install --profile-only");
     return 0;
 }
 function surfaceStatus(surface, selectedSurfaces) {

package/dist/apps/cli/src/commands/runtime.d.ts

@@ -1,5 +1,7 @@
 import type { CliExecutionContext } from "../cli.js";
 export declare function runServeCommand(args: readonly string[], context: CliExecutionContext): Promise<number>;
+export declare function runStartCommand(args: readonly string[], context: CliExecutionContext): Promise<number>;
+export declare function runHudCommand(args: readonly string[], context: CliExecutionContext): Promise<number>;
 export declare function runOpenCommand(args: readonly string[], context: CliExecutionContext): Promise<number>;
 export declare function runDesktopCommand(args: readonly string[], context: CliExecutionContext): Promise<number>;
 //# sourceMappingURL=runtime.d.ts.map

package/dist/apps/cli/src/commands/runtime.js

@@ -1,5 +1,8 @@
+import { createFallbackDesktopRuntimeAdapter, } from "../desktop-runtime.js";
 import { createFallbackLocalRuntimeAdapter, } from "../runtime-adapter.js";
 const SERVE_USAGE = "Usage: moneysiren serve [--port <port>]";
+const START_USAGE = "Usage: msiren start [--port <port>] [--open|--no-open] [--hud]";
+const HUD_USAGE = "Usage: msiren hud [--port <port>]";
 const OPEN_USAGE = "Usage: moneysiren open";
 const DESKTOP_USAGE = "Usage: moneysiren desktop status";
 export async function runServeCommand(args, context) {
@@ -18,6 +21,62 @@ export async function runServeCommand(args, context) {
     });
     return writeStartRuntimeResult(context, result, "MoneySiren local runtime");
 }
+export async function runStartCommand(args, context) {
+    if (args.includes("--help") || args.includes("-h")) {
+        context.stdout(START_USAGE);
+        return 0;
+    }
+    const parsed = parseStartArgs(args);
+    if (parsed === undefined) {
+        context.stderr(START_USAGE);
+        return 1;
+    }
+    const adapter = desktopRuntimeAdapter(context);
+    const web = await adapter.startWebRuntime({
+        openBrowser: parsed.openBrowser,
+        ...(parsed.port === undefined ? {} : { port: parsed.port }),
+    });
+    const webExitCode = writeDesktopRuntimeResult(context, web, "MoneySiren dashboard runtime");
+    if (webExitCode !== 0) {
+        return webExitCode;
+    }
+    if (web.status !== "unavailable" && parsed.openBrowser) {
+        await context.openUrl(web.dashboardUrl);
+        context.stdout(`Dashboard URL: ${web.dashboardUrl}`);
+    }
+    if (!parsed.launchHud) {
+        context.stdout("HUD: run `msiren hud` to open the floating desktop widget.");
+        return 0;
+    }
+    const hud = await adapter.startHud({
+        ...(parsed.port === undefined ? {} : { port: parsed.port }),
+    });
+    return writeDesktopShellResult(context, hud, "MoneySiren HUD");
+}
+export async function runHudCommand(args, context) {
+    if (args.includes("--help") || args.includes("-h")) {
+        context.stdout(HUD_USAGE);
+        return 0;
+    }
+    const parsed = parseHudArgs(args);
+    if (parsed === undefined) {
+        context.stderr(HUD_USAGE);
+        return 1;
+    }
+    const adapter = desktopRuntimeAdapter(context);
+    const web = await adapter.startWebRuntime({
+        openBrowser: false,
+        ...(parsed.port === undefined ? {} : { port: parsed.port }),
+    });
+    const webExitCode = writeDesktopRuntimeResult(context, web, "MoneySiren dashboard runtime");
+    if (webExitCode !== 0) {
+        return webExitCode;
+    }
+    const hud = await adapter.startHud({
+        ...(parsed.port === undefined ? {} : { port: parsed.port }),
+    });
+    return writeDesktopShellResult(context, hud, "MoneySiren HUD");
+}
 export async function runOpenCommand(args, context) {
     if (args.includes("--help") || args.includes("-h")) {
         context.stdout(OPEN_USAGE);
@@ -81,6 +140,9 @@ export async function runDesktopCommand(args, context) {
 function runtimeAdapter(context) {
     return context.localRuntime ?? createFallbackLocalRuntimeAdapter(context);
 }
+function desktopRuntimeAdapter(context) {
+    return context.desktopRuntime ?? createFallbackDesktopRuntimeAdapter(context);
+}
 async function findHealthyRuntime(adapter) {
     const runtime = await adapter.findRuntime();
     if (runtime === null) {
@@ -103,6 +165,45 @@ function writeStartRuntimeResult(context, result, heading) {
     }
     return 1;
 }
+function writeDesktopRuntimeResult(context, result, heading) {
+    if (result.status !== "unavailable") {
+        context.stdout(heading);
+        context.stdout(`Runtime: ${result.status}`);
+        context.stdout(`Dashboard URL: ${result.dashboardUrl}`);
+        if (result.pid !== undefined) {
+            context.stdout(`PID: ${result.pid}`);
+        }
+        for (const note of result.notes) {
+            context.stdout(`Note: ${note}`);
+        }
+        return 0;
+    }
+    context.stderr(`${heading}: unavailable`);
+    context.stderr(result.reason);
+    for (const line of result.guidance) {
+        context.stderr(line);
+    }
+    return 1;
+}
+function writeDesktopShellResult(context, result, heading) {
+    if (result.status !== "unavailable") {
+        context.stdout(heading);
+        context.stdout(`Desktop shell: ${result.status}`);
+        if (result.pid !== undefined) {
+            context.stdout(`PID: ${result.pid}`);
+        }
+        for (const note of result.notes) {
+            context.stdout(`Note: ${note}`);
+        }
+        return 0;
+    }
+    context.stderr(`${heading}: unavailable`);
+    context.stderr(result.reason);
+    for (const line of result.guidance) {
+        context.stderr(line);
+    }
+    return 1;
+}
 function parseServeArgs(args) {
     let port;
     for (let index = 0; index < args.length; index += 1) {
@@ -127,6 +228,72 @@ function parseServeArgs(args) {
     }
     return Number.isSafeInteger(port) && port > 0 && port <= 65_535 ? { port } : undefined;
 }
+function parseStartArgs(args) {
+    let launchHud = false;
+    let openBrowser = true;
+    let port;
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "--hud") {
+            launchHud = true;
+            continue;
+        }
+        if (arg === "--open") {
+            openBrowser = true;
+            continue;
+        }
+        if (arg === "--no-open") {
+            openBrowser = false;
+            continue;
+        }
+        if (arg === "--port") {
+            const value = args[index + 1];
+            if (value === undefined || value.startsWith("--")) {
+                return undefined;
+            }
+            port = parsePort(value);
+            index += 1;
+            continue;
+        }
+        if (arg?.startsWith("--port=")) {
+            port = parsePort(arg.slice("--port=".length));
+            continue;
+        }
+        return undefined;
+    }
+    if (port !== undefined && (!Number.isSafeInteger(port) || port <= 0 || port > 65_535)) {
+        return undefined;
+    }
+    return {
+        launchHud,
+        openBrowser,
+        ...(port === undefined ? {} : { port }),
+    };
+}
+function parseHudArgs(args) {
+    let port;
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "--port") {
+            const value = args[index + 1];
+            if (value === undefined || value.startsWith("--")) {
+                return undefined;
+            }
+            port = parsePort(value);
+            index += 1;
+            continue;
+        }
+        if (arg?.startsWith("--port=")) {
+            port = parsePort(arg.slice("--port=".length));
+            continue;
+        }
+        return undefined;
+    }
+    if (port !== undefined && (!Number.isSafeInteger(port) || port <= 0 || port > 65_535)) {
+        return undefined;
+    }
+    return port === undefined ? {} : { port };
+}
 function parsePort(value) {
     return Number.parseInt(value, 10);
 }

package/dist/apps/cli/src/desktop-runtime.d.ts

@@ -0,0 +1,31 @@
+import type { CliExecutionContext } from "./cli.js";
+export interface StartWebRuntimeOptions {
+    openBrowser: boolean;
+    port?: number;
+}
+export interface StartHudOptions {
+    port?: number;
+}
+export type DesktopRuntimeResult = {
+    status: "running" | "started";
+    dashboardUrl: string;
+    pid?: number;
+    notes: readonly string[];
+} | DesktopRuntimeUnavailableResult;
+export type DesktopShellResult = {
+    status: "opened" | "started";
+    executablePath: string;
+    pid?: number;
+    notes: readonly string[];
+} | DesktopRuntimeUnavailableResult;
+export interface DesktopRuntimeUnavailableResult {
+    status: "unavailable";
+    reason: string;
+    guidance: readonly string[];
+}
+export interface CliDesktopRuntimeAdapter {
+    startWebRuntime(options: StartWebRuntimeOptions): Promise<DesktopRuntimeResult>;
+    startHud(options: StartHudOptions): Promise<DesktopShellResult>;
+}
+export declare function createFallbackDesktopRuntimeAdapter(context: CliExecutionContext): CliDesktopRuntimeAdapter;
+//# sourceMappingURL=desktop-runtime.d.ts.map