@moneysiren/app 0.1.0-alpha.9

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

@@ -0,0 +1,7 @@
+import type { Theme } from "./theme.js";
+export declare function renderHomeScreen(input: {
+    version: string;
+    theme: Theme;
+}): string;
+export declare function renderHelpScreen(version: string): string;
+//# sourceMappingURL=home.d.ts.map

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

@@ -0,0 +1,124 @@
+export function renderHomeScreen(input) {
+    const { theme, version } = input;
+    return [
+        `${theme.brand("MoneySiren")} ${theme.muted(version)}`,
+        "Local-first cloud/SaaS usage, status, and expected billing.",
+        "",
+        theme.heading("Slash commands"),
+        `  ${theme.command("/help")}                 Show CLI usage and slash guide`,
+        `  ${theme.command("/version")}              Print the installed CLI version`,
+        `  ${theme.command("/doctor")}               Check local readiness without printing secrets`,
+        `  ${theme.command("/install")}              Choose CLI, web dashboard, and HUD components`,
+        `  ${theme.command("/modes")}                Show the CLI, web, and desktop modes`,
+        `  ${theme.command("/start")}                Start the installed dashboard runtime`,
+        `  ${theme.command("/hud")}                  Start the installed runtime and open HUD`,
+        `  ${theme.command("/status")}               Show managed web, HUD, and local API runtime status`,
+        `  ${theme.command("/stop")}                 Stop managed web, HUD, and local API runtimes`,
+        `  ${theme.command("/init")}                 Create local SQLite storage`,
+        `  ${theme.command("/dashboard")}            Check the local dashboard API`,
+        `  ${theme.command("/dashboard check")}      Same as /dashboard`,
+        `  ${theme.command("/summary json")}         Print sanitized local summary JSON`,
+        `  ${theme.command("/notify dry-run")}       Preview a sanitized notification digest`,
+        `  ${theme.command("/notify prefs")}         List local notification defaults`,
+        `  ${theme.command("/desktop status")}       Check local runtime status`,
+        `  ${theme.command("/theme preview")}        Preview the active CLI image-reference theme`,
+        `  ${theme.command("/sync mock")}            Sync fake local review snapshots`,
+        `  ${theme.command("/sync aws")}             Sync AWS Cost Explorer snapshots`,
+        `  ${theme.command("/sync openai")}          Sync OpenAI usage/cost snapshots`,
+        `  ${theme.command("/sync supabase")}        Sync Supabase usage/health snapshots`,
+        `  ${theme.command("/sync cloudflare")}      Sync Cloudflare billing/usage snapshots`,
+        `  ${theme.command("/report ko")}            Render the Korean daily report`,
+        `  ${theme.command("/quit")}                 Exit the slash prompt`,
+        "",
+        theme.heading("Classic CLI"),
+        "  msiren start",
+        "  msiren hud",
+        "  msiren status",
+        "  msiren stop",
+        "  msiren install --all",
+        "",
+        theme.heading("Full command"),
+        "  moneysiren doctor",
+        "  moneysiren install",
+        "  moneysiren install --status",
+        "  moneysiren modes",
+        "  moneysiren init",
+        "  moneysiren serve [--port <port>]",
+        "  moneysiren stop [--web|--hud|--api|--all]",
+        "  moneysiren restart [--port <port>] [--open|--no-open] [--hud]",
+        "  moneysiren open",
+        "  moneysiren sync --provider mock",
+        "  moneysiren summary --json",
+        "  moneysiren notify once --dry-run",
+        "  moneysiren notify prefs list",
+        "  moneysiren desktop status",
+        "  moneysiren report daily --lang ko",
+        "  moneysiren dashboard check",
+        "  moneysiren theme preview",
+        "  moneysiren theme image-prompt",
+        "  moneysiren theme image-generate",
+        "",
+        theme.warning("Security"),
+        "  Home/help does not call provider APIs, read secret values, create .env, or enable telemetry.",
+    ].join("\n");
+}
+export function renderHelpScreen(version) {
+    return `MoneySiren ${version}
+
+Local-first cloud/SaaS usage, status, and expected billing dashboard.
+
+Short command:
+  msiren start
+  msiren hud
+  msiren install --all
+
+Usage:
+  moneysiren
+  moneysiren --help
+  moneysiren --version
+  moneysiren init
+  moneysiren install [--status|--all|--cli|--web|--hud|--no-cli|--no-web|--no-hud]
+  moneysiren doctor
+  moneysiren modes
+  moneysiren start [--port <port>] [--open|--no-open] [--hud]
+  moneysiren hud [--port <port>]
+  moneysiren status
+  moneysiren stop [--web|--hud|--api|--all]
+  moneysiren restart [--port <port>] [--open|--no-open] [--hud]
+  moneysiren dashboard check [--url <local-dashboard-url>]
+  moneysiren serve [--port <port>]
+  moneysiren open
+  moneysiren theme preview
+  moneysiren theme image-prompt
+  moneysiren theme image-generate [--out <png> --theme-out <json> --model <model>]
+  moneysiren sync --provider <mock|aws|openai|supabase|cloudflare>
+  moneysiren summary --json
+  moneysiren notify once --dry-run
+  moneysiren notify prefs list
+  moneysiren desktop status
+  moneysiren report daily --lang ko [--send slack]
+
+Slash commands:
+  moneysiren /help
+  moneysiren /version
+  moneysiren /doctor
+  moneysiren /install
+  moneysiren /modes
+  moneysiren /start
+  moneysiren /hud
+  moneysiren /status
+  moneysiren /stop [--web|--hud|--api|--all]
+  moneysiren /init
+  moneysiren /dashboard
+  moneysiren /dashboard check
+  moneysiren /summary json
+  moneysiren /notify dry-run
+  moneysiren /notify prefs
+  moneysiren /desktop status
+  moneysiren /theme <preview|image-prompt|image-generate>
+  moneysiren /sync <mock|aws|openai|supabase|cloudflare>
+  moneysiren /report ko
+  moneysiren /quit
+`;
+}
+//# sourceMappingURL=home.js.map

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

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { runCli } from "./cli.js";
+const result = await runCli(process.argv.slice(2), {
+    cwd: process.cwd(),
+    env: process.env,
+    stdin: process.stdin,
+    output: process.stdout,
+    stdinIsTTY: process.stdin.isTTY,
+    stdoutIsTTY: process.stdout.isTTY,
+    stdout: (line) => console.log(line),
+    stderr: (line) => console.error(line),
+});
+process.exitCode = result.exitCode;
+//# sourceMappingURL=index.js.map

package/dist/apps/cli/src/install-profile.d.ts

@@ -0,0 +1,35 @@
+export declare const INSTALL_SURFACES: readonly ["cli", "web", "hud"];
+export declare const DEFAULT_INSTALL_SURFACES: readonly InstallSurface[];
+export type InstallSurface = (typeof INSTALL_SURFACES)[number];
+export type InstallProfileSource = "cli" | "postinstall";
+export interface InstallProfile {
+    version: 1;
+    selectedSurfaces: readonly InstallSurface[];
+    recommendedDefault: boolean;
+    localOnly: true;
+    secretsReturned: false;
+    source: InstallProfileSource;
+    installedAt: string;
+    updatedAt: string;
+}
+export interface InstallProfileFileOptions {
+    env?: Record<string, string | undefined>;
+    now?: () => Date;
+    path?: string;
+    platform?: NodeJS.Platform;
+}
+export declare function resolveInstallProfilePath(options?: InstallProfileFileOptions): string;
+export declare function readInstallProfileFile(options?: InstallProfileFileOptions): Promise<InstallProfile | null>;
+export declare function writeInstallProfileFile(input: {
+    selectedSurfaces: readonly InstallSurface[];
+    source: InstallProfileSource;
+    recommendedDefault?: boolean;
+}, options?: InstallProfileFileOptions): Promise<InstallProfile>;
+export declare function parseInstallProfile(value: unknown): InstallProfile | null;
+export declare function parseInstallSurfaces(value: unknown): readonly InstallSurface[];
+export declare function normalizeInstallSurfaces(values: readonly InstallSurface[]): readonly InstallSurface[];
+export declare function isRecommendedInstallSelection(values: readonly InstallSurface[]): boolean;
+export declare function formatInstallSurfaces(values: readonly InstallSurface[]): string;
+export declare function installSurfaceLabel(surface: InstallSurface): string;
+export declare function isInstallSurface(value: unknown): value is InstallSurface;
+//# sourceMappingURL=install-profile.d.ts.map

package/dist/apps/cli/src/install-profile.js

@@ -0,0 +1,124 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, isAbsolute, join, posix, win32 } from "node:path";
+export const INSTALL_SURFACES = ["cli", "web", "hud"];
+export const DEFAULT_INSTALL_SURFACES = INSTALL_SURFACES;
+const INSTALL_PROFILE_ENV_KEY = "MONEYSIREN_INSTALL_PROFILE_PATH";
+export function resolveInstallProfilePath(options = {}) {
+    if (options.path !== undefined && options.path.trim().length > 0) {
+        return resolveInstallPath(options.path, process.cwd());
+    }
+    const env = options.env ?? process.env;
+    const configuredPath = env[INSTALL_PROFILE_ENV_KEY];
+    if (configuredPath !== undefined && configuredPath.trim().length > 0) {
+        return resolveInstallPath(configuredPath, process.cwd());
+    }
+    return defaultInstallProfilePath(env, options.platform ?? process.platform);
+}
+export async function readInstallProfileFile(options = {}) {
+    try {
+        return parseInstallProfile(JSON.parse(await readFile(resolveInstallProfilePath(options), "utf8")));
+    }
+    catch {
+        return null;
+    }
+}
+export async function writeInstallProfileFile(input, options = {}) {
+    const existing = await readInstallProfileFile(options);
+    const now = (options.now ?? (() => new Date()))().toISOString();
+    const profile = {
+        version: 1,
+        selectedSurfaces: normalizeInstallSurfaces(input.selectedSurfaces),
+        recommendedDefault: input.recommendedDefault ?? isRecommendedInstallSelection(input.selectedSurfaces),
+        localOnly: true,
+        secretsReturned: false,
+        source: input.source,
+        installedAt: existing?.installedAt ?? now,
+        updatedAt: now,
+    };
+    const path = resolveInstallProfilePath(options);
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, `${JSON.stringify(profile, null, 2)}\n`, "utf8");
+    return profile;
+}
+export function parseInstallProfile(value) {
+    if (!isRecord(value) || value.version !== 1) {
+        return null;
+    }
+    const selectedSurfaces = parseInstallSurfaces(value.selectedSurfaces);
+    if (selectedSurfaces.length === 0) {
+        return null;
+    }
+    return {
+        version: 1,
+        selectedSurfaces,
+        recommendedDefault: typeof value.recommendedDefault === "boolean"
+            ? value.recommendedDefault
+            : isRecommendedInstallSelection(selectedSurfaces),
+        localOnly: true,
+        secretsReturned: false,
+        source: value.source === "postinstall" ? "postinstall" : "cli",
+        installedAt: typeof value.installedAt === "string" ? value.installedAt : "",
+        updatedAt: typeof value.updatedAt === "string" ? value.updatedAt : "",
+    };
+}
+export function parseInstallSurfaces(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return normalizeInstallSurfaces(value.filter(isInstallSurface));
+}
+export function normalizeInstallSurfaces(values) {
+    const selected = new Set(values);
+    return INSTALL_SURFACES.filter((surface) => selected.has(surface));
+}
+export function isRecommendedInstallSelection(values) {
+    const selected = normalizeInstallSurfaces(values);
+    return selected.length === INSTALL_SURFACES.length &&
+        INSTALL_SURFACES.every((surface, index) => selected[index] === surface);
+}
+export function formatInstallSurfaces(values) {
+    return normalizeInstallSurfaces(values).map(installSurfaceLabel).join(", ");
+}
+export function installSurfaceLabel(surface) {
+    if (surface === "cli") {
+        return "CLI";
+    }
+    if (surface === "web") {
+        return "Web dashboard";
+    }
+    return "HUD";
+}
+export function isInstallSurface(value) {
+    return typeof value === "string" && INSTALL_SURFACES.includes(value);
+}
+function defaultInstallProfilePath(env, platform) {
+    if (platform === "darwin") {
+        return joinForPlatform(platform, resolveHomeDirectory(env), "Library", "Application Support", "MoneySiren", "install-profile.json");
+    }
+    if (platform === "win32") {
+        return joinForPlatform(platform, resolveWindowsAppDataDirectory(env), "MoneySiren", "install-profile.json");
+    }
+    const configHome = trimToNull(env.XDG_CONFIG_HOME) ?? joinForPlatform(platform, resolveHomeDirectory(env), ".config");
+    return joinForPlatform(platform, configHome, "moneysiren", "install-profile.json");
+}
+function resolveInstallPath(path, cwd) {
+    return isAbsolute(path) ? path : join(cwd, path);
+}
+function resolveWindowsAppDataDirectory(env) {
+    return trimToNull(env.APPDATA) ?? win32.join(resolveHomeDirectory(env), "AppData", "Roaming");
+}
+function resolveHomeDirectory(env) {
+    return trimToNull(env.HOME) ?? trimToNull(env.USERPROFILE) ?? homedir();
+}
+function trimToNull(value) {
+    const trimmed = value?.trim();
+    return trimmed === undefined || trimmed.length === 0 ? null : trimmed;
+}
+function joinForPlatform(platform, ...segments) {
+    return platform === "win32" ? win32.join(...segments) : posix.join(...segments);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=install-profile.js.map

package/dist/apps/cli/src/install-selector.d.ts

@@ -0,0 +1,10 @@
+import { type InstallSurface } from "./install-profile.js";
+export interface InstallSelectionPromptOptions {
+    stdin: NodeJS.ReadableStream;
+    output: NodeJS.WritableStream;
+}
+export declare function promptForInstallSurfaces(options: InstallSelectionPromptOptions): Promise<readonly InstallSurface[]>;
+export declare function parseInstallSurfaceSelection(input: string): readonly InstallSurface[] | null;
+export declare function formatInstallSelectionLine(selectedSurfaces: readonly InstallSurface[]): string;
+export declare function installSelectionHelp(): string;
+//# sourceMappingURL=install-selector.d.ts.map

package/dist/apps/cli/src/install-selector.js

@@ -0,0 +1,66 @@
+import { createInterface } from "node:readline/promises";
+import { DEFAULT_INSTALL_SURFACES, INSTALL_SURFACES, formatInstallSurfaces, installSurfaceLabel, isInstallSurface, normalizeInstallSurfaces, } from "./install-profile.js";
+export async function promptForInstallSurfaces(options) {
+    options.output.write([
+        "MoneySiren setup",
+        "Recommended default: CLI, Web dashboard, HUD",
+        "Select components to enable after npm install:",
+        "  1. CLI",
+        "  2. Web dashboard",
+        "  3. HUD",
+        "",
+    ].join("\n"));
+    options.output.write("\n");
+    const readline = createInterface({
+        input: options.stdin,
+        output: options.output,
+    });
+    try {
+        const answer = await readline.question("Choose components [1,2,3] (Enter = all recommended): ");
+        const selected = parseInstallSurfaceSelection(answer);
+        if (selected === null) {
+            options.output.write("Invalid selection. Using recommended default: CLI, Web dashboard, HUD\n");
+            return DEFAULT_INSTALL_SURFACES;
+        }
+        return selected;
+    }
+    finally {
+        readline.close();
+    }
+}
+export function parseInstallSurfaceSelection(input) {
+    const trimmed = input.trim().toLowerCase();
+    if (trimmed.length === 0 || trimmed === "all" || trimmed === "recommended") {
+        return DEFAULT_INSTALL_SURFACES;
+    }
+    const selected = trimmed
+        .split(/[\s,;]+/)
+        .filter((token) => token.length > 0)
+        .map(selectionTokenToSurface);
+    if (selected.some((surface) => surface === null)) {
+        return null;
+    }
+    const normalized = normalizeInstallSurfaces(selected.filter((surface) => surface !== null));
+    return normalized.length === 0 ? null : normalized;
+}
+export function formatInstallSelectionLine(selectedSurfaces) {
+    return `Selected components: ${formatInstallSurfaces(selectedSurfaces)}`;
+}
+export function installSelectionHelp() {
+    return INSTALL_SURFACES
+        .map((surface, index) => `  ${index + 1}. ${installSurfaceLabel(surface)}`)
+        .join("\n");
+}
+function selectionTokenToSurface(token) {
+    if (token === "1") {
+        return "cli";
+    }
+    if (token === "2") {
+        return "web";
+    }
+    if (token === "3") {
+        return "hud";
+    }
+    return isInstallSurface(token) ? token : null;
+}
+//# sourceMappingURL=install-selector.js.map

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

@@ -0,0 +1,3 @@
+import type { CliExecutionContext } from "./cli.js";
+export declare function runSlashPrompt(context: CliExecutionContext, execute: (args: readonly string[]) => Promise<number>): Promise<number>;
+//# sourceMappingURL=interactive.d.ts.map

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

@@ -0,0 +1,32 @@
+import { createInterface } from "node:readline/promises";
+import { isSlashQuit, parseSlashInput } from "./slash.js";
+export async function runSlashPrompt(context, execute) {
+    if (context.stdin === undefined || context.output === undefined) {
+        return 0;
+    }
+    const prompt = context.theme.command("moneysiren> ");
+    const readline = createInterface({
+        input: context.stdin,
+        output: context.output,
+        terminal: false,
+        historySize: 0,
+    });
+    context.stdout("Slash prompt ready. Type /help for commands or /quit to exit.");
+    try {
+        let lastExitCode = 0;
+        while (true) {
+            const args = parseSlashInput(await readline.question(prompt));
+            if (args.length === 0) {
+                continue;
+            }
+            lastExitCode = await execute(args);
+            if (isSlashQuit(args)) {
+                return lastExitCode;
+            }
+        }
+    }
+    finally {
+        readline.close();
+    }
+}
+//# sourceMappingURL=interactive.js.map

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

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=postinstall.d.ts.map

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

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+import { DEFAULT_INSTALL_SURFACES, writeInstallProfileFile } from "./install-profile.js";
+import { formatInstallSelectionLine, promptForInstallSurfaces } from "./install-selector.js";
+const selectedSurfaces = await selectSurfaces();
+try {
+    const profile = await writeInstallProfileFile({
+        selectedSurfaces,
+        source: "postinstall",
+        recommendedDefault: selectedSurfaces.length === DEFAULT_INSTALL_SURFACES.length,
+    });
+    console.log("MoneySiren setup profile saved.");
+    console.log(formatInstallSelectionLine(profile.selectedSurfaces));
+    console.log("Run `msiren install --status` to review, `msiren install` to change it, or `msiren start` after installing release assets.");
+}
+catch (error) {
+    console.warn(`MoneySiren setup profile skipped: ${error instanceof Error ? error.message : String(error)}`);
+}
+async function selectSurfaces() {
+    if (isTruthy(process.env.MONEYSIREN_SKIP_POSTINSTALL)) {
+        return DEFAULT_INSTALL_SURFACES;
+    }
+    if (!shouldPrompt()) {
+        return DEFAULT_INSTALL_SURFACES;
+    }
+    return promptForInstallSurfaces({
+        stdin: process.stdin,
+        output: process.stdout,
+    });
+}
+function shouldPrompt() {
+    return Boolean(process.stdin.isTTY) &&
+        Boolean(process.stdout.isTTY) &&
+        !isTruthy(process.env.CI);
+}
+function isTruthy(value) {
+    if (value === undefined) {
+        return false;
+    }
+    const normalized = value.trim().toLowerCase();
+    return normalized.length > 0 && normalized !== "0" && normalized !== "false" && normalized !== "no";
+}
+//# sourceMappingURL=postinstall.js.map

package/dist/apps/cli/src/release-installer.d.ts

@@ -0,0 +1,57 @@
+import type { InstallSurface } from "./install-profile.js";
+export declare const DEFAULT_RELEASE_REPOSITORY = "ztwz11/moneysiren";
+export declare const DEFAULT_RELEASE_TAG = "v0.1.0-alpha.9";
+export interface ReleaseInstallOptions {
+    env?: Record<string, string | undefined>;
+    fetchImpl: typeof fetch;
+    installDir?: string;
+    now?: () => Date;
+    platform?: NodeJS.Platform;
+    repository?: string;
+    selectedSurfaces: readonly InstallSurface[];
+    signatureVerifier?: ReleaseAssetSignatureVerifier;
+    tag?: string;
+    trustedWindowsSignerThumbprints?: readonly string[];
+}
+export interface ReleaseInstallResult {
+    repository: string;
+    tag: string;
+    installDir: string;
+    releaseUrl: string;
+    assets: readonly InstalledReleaseAsset[];
+}
+export interface InstalledReleaseAsset {
+    surface: Exclude<InstallSurface, "cli">;
+    name: string;
+    path: string;
+    size: number;
+    sha256: string;
+    checksumVerified: boolean;
+    signatureVerified: boolean;
+    signatureStatus: string;
+}
+export interface ReleaseAssetSignatureVerifier {
+    verify(input: ReleaseAssetSignatureVerificationInput): Promise<ReleaseAssetSignatureVerificationResult>;
+}
+export interface ReleaseAssetSignatureVerificationInput {
+    assetName: string;
+    env: Record<string, string | undefined>;
+    expectedSignerThumbprints?: readonly string[];
+    path: string;
+    platform: NodeJS.Platform;
+    surface: Exclude<InstallSurface, "cli">;
+    tag: string;
+}
+export interface ReleaseAssetSignatureVerificationResult {
+    verified: boolean;
+    status: string;
+    message: string;
+}
+export declare function installReleaseAssets(options: ReleaseInstallOptions): Promise<ReleaseInstallResult>;
+export declare function resolveReleaseInstallDir(input?: {
+    env?: Record<string, string | undefined>;
+    installDir?: string;
+    platform?: NodeJS.Platform;
+    tag?: string;
+}): string;
+//# sourceMappingURL=release-installer.d.ts.map