@cardelli/ambit 0.1.5 → 0.2.0

package/esm/cli/commands/status.js

@@ -0,0 +1,331 @@
+// =============================================================================
+// Status Command - Show Network, App, and Router Status
+// =============================================================================
+import { parseArgs } from "../../deps/jsr.io/@std/cli/1.0.28/mod.js";
+import { Table } from "../../deps/jsr.io/@cliffy/table/1.0.0/mod.js";
+import { bold } from "../../lib/cli.js";
+import { checkArgs } from "../../lib/args.js";
+import { createOutput } from "../../lib/output.js";
+import { registerCommand } from "../mod.js";
+import { discoverRouters, findRouterApp, findWorkloadApp, getRouterMachineInfo, getRouterTailscaleInfo, listWorkloadAppsOnNetwork, } from "../../util/discovery.js";
+import { initSession } from "../../util/session.js";
+import { SOCKS_PROXY_PORT } from "../../util/constants.js";
+// =============================================================================
+// Network Status: Single Router Detailed View
+// =============================================================================
+const stageNetworkStatus = async (fly, tailscale, network, org, json) => {
+    const out = createOutput(json);
+    const app = await findRouterApp(fly, org, network);
+    if (!app) {
+        return out.die(`No Router Found for Network '${network}'`);
+    }
+    const machine = await getRouterMachineInfo(fly, app.appName);
+    const ts = await getRouterTailscaleInfo(tailscale, app.appName);
+    const tag = ts?.tags?.[0] ?? null;
+    out.blank()
+        .header("Ambit Status: Network")
+        .blank()
+        .text(`  Network:       ${bold(app.network)}`)
+        .text(`  TLD:           *.${app.network}`)
+        .text(`  Tag:           ${tag ?? "unknown"}`)
+        .blank()
+        .text(`  Router App:    ${app.appName}`)
+        .text(`  Region:        ${machine?.region ?? "unknown"}`)
+        .text(`  Machine State: ${machine?.state ?? "unknown"}`)
+        .text(`  Private IP:    ${machine?.privateIp ?? "unknown"}`)
+        .text(`  SOCKS Proxy:   ${machine?.privateIp
+        ? `socks5://[${machine.privateIp}]:${SOCKS_PROXY_PORT}`
+        : "unknown"}`);
+    if (machine?.subnet) {
+        out.text(`  Subnet:        ${machine.subnet}`);
+    }
+    out.blank();
+    if (ts) {
+        out.text(`  Tailscale IP:  ${ts.ip}`)
+            .text(`  Online:        ${ts.online ? "yes" : "no"}`);
+    }
+    else {
+        out.text("  Tailscale:     Not Found in Tailnet");
+    }
+    // Show workload apps on this network
+    const workloads = await listWorkloadAppsOnNetwork(fly, org, network);
+    if (workloads.length > 0) {
+        out.blank().header("  Apps on Network").blank();
+        for (const w of workloads) {
+            const machines = await fly.machines.list(w.appName);
+            const state = machines[0]?.state ?? "no machines";
+            const region = machines[0]?.region ?? "-";
+            out.text(`    ${w.appName}  ${region}  ${state}`);
+        }
+    }
+    out.blank();
+    out.done({
+        network: app.network,
+        router: app,
+        machine,
+        tag,
+        tailscale: ts,
+    });
+    out.print();
+};
+// =============================================================================
+// Network Status: Summary Table of All Routers
+// =============================================================================
+const stageAllStatus = async (fly, tailscale, org, json) => {
+    const out = createOutput(json);
+    const routers = await discoverRouters(out, fly, tailscale, org);
+    if (routers.length === 0) {
+        out.blank()
+            .text("No Routers Found.")
+            .dim("  Create One with: ambit create <network>")
+            .blank();
+        out.done({ routers: [] });
+        out.print();
+        return;
+    }
+    out.blank().header("Router Status").blank();
+    const rows = routers.map((r) => {
+        const tsStatus = r.tailscale
+            ? (r.tailscale.online ? "online" : "offline")
+            : "not found";
+        return [r.network, r.appName, r.machine?.state ?? "unknown", tsStatus];
+    });
+    const table = new Table()
+        .header(["Network", "App", "State", "Tailscale"])
+        .body(rows)
+        .indent(2)
+        .padding(2);
+    out.text(table.toString());
+    out.blank();
+    out.done({ routers });
+    out.print();
+};
+// =============================================================================
+// Status Network Subcommand
+// =============================================================================
+const statusNetwork = async (argv) => {
+    const opts = { string: ["org"], boolean: ["help", "json"] };
+    const args = parseArgs(argv, opts);
+    checkArgs(args, opts, "ambit status network");
+    if (args.help) {
+        console.log(`
+${bold("ambit status network")} - Show Router and Network Status
+
+${bold("USAGE")}
+  ambit status network [<name>] [--org <org>] [--json]
+
+${bold("OPTIONS")}
+  <name>             Network to show status for (shows all if omitted)
+  --org <org>        Fly.io organization slug
+  --json             Output as JSON
+
+${bold("EXAMPLES")}
+  ambit status network              Show summary of all routers
+  ambit status network browsers     Show detailed status for one network
+`);
+        return;
+    }
+    const network = typeof args._[0] === "string" ? args._[0] : undefined;
+    const prereqOut = createOutput(args.json);
+    const { fly, tailscale, org } = await initSession(prereqOut, {
+        json: args.json,
+        org: args.org,
+    });
+    if (network) {
+        await stageNetworkStatus(fly, tailscale, network, org, args.json);
+    }
+    else {
+        await stageAllStatus(fly, tailscale, org, args.json);
+    }
+};
+// =============================================================================
+// App Status: Detailed App View
+// =============================================================================
+const stageAppStatus = async (fly, tailscale, app, network, org, json) => {
+    const out = createOutput(json);
+    const workload = await findWorkloadApp(fly, org, app, network);
+    if (!workload) {
+        return out.die(`App '${app}' Not Found on Network '${network}'`);
+    }
+    const machines = await fly.machines.list(workload.appName);
+    const ips = await fly.ips.list(workload.appName);
+    const mappedMachines = machines.map((m) => ({
+        id: m.id,
+        region: m.region,
+        state: m.state,
+        privateIp: m.private_ip,
+    }));
+    const mappedIps = ips.map((ip) => ({
+        address: ip.Address,
+        type: ip.Type,
+        network: ip.Network?.Name,
+    }));
+    const router = await findRouterApp(fly, org, network);
+    out.blank()
+        .header(`Ambit Status: ${app}.${network}`)
+        .blank()
+        .text(`  App:           ${bold(app)}`)
+        .text(`  Network:       ${network}`)
+        .text(`  Fly App:       ${workload.appName}`)
+        .blank();
+    if (machines.length === 0) {
+        out.text("  Machines:      None");
+    }
+    else {
+        out.header("  Machines").blank();
+        for (const m of machines) {
+            out.text(`    ${m.id}  ${m.region}  ${m.state}${m.private_ip ? `  ${m.private_ip}` : ""}`);
+        }
+    }
+    out.blank();
+    const flycastIps = ips.filter((ip) => ip.Type === "private_v6");
+    const publicIps = ips.filter((ip) => ip.Type !== "private_v6");
+    if (flycastIps.length > 0) {
+        out.header("  Flycast IPs").blank();
+        for (const ip of flycastIps) {
+            out.text(`    ${ip.Address}  (network: ${ip.Network?.Name ?? "default"})`);
+        }
+        out.blank();
+    }
+    if (publicIps.length > 0) {
+        out.header("  Public IPs (Warning: Ambit Apps Should Not Have Public IPs)")
+            .blank();
+        for (const ip of publicIps) {
+            out.text(`    ${ip.Address}  ${ip.Type}`);
+        }
+        out.blank();
+    }
+    if (router) {
+        const routerMachine = await getRouterMachineInfo(fly, router.appName);
+        const ts = await getRouterTailscaleInfo(tailscale, router.appName);
+        out.header("  Router").blank()
+            .text(`    App:         ${router.appName}`)
+            .text(`    State:       ${routerMachine?.state ?? "unknown"}`)
+            .text(`    Tailscale:   ${ts ? (ts.online ? "online" : "offline") : "not found"}`);
+        if (routerMachine?.privateIp) {
+            out.text(`    SOCKS Proxy: socks5://[${routerMachine.privateIp}]:${SOCKS_PROXY_PORT}`);
+        }
+    }
+    else {
+        out.text("  Router:        Not Found");
+    }
+    out.blank();
+    out.done({
+        app,
+        network,
+        flyAppName: workload.appName,
+        machines: mappedMachines,
+        ips: mappedIps,
+        router,
+    });
+    out.print();
+};
+// =============================================================================
+// Status App Subcommand
+// =============================================================================
+const statusApp = async (argv) => {
+    const opts = { string: ["network", "org"], boolean: ["help", "json"] };
+    const args = parseArgs(argv, opts);
+    checkArgs(args, opts, "ambit status app");
+    if (args.help) {
+        console.log(`
+${bold("ambit status app")} - Show App Status
+
+${bold("USAGE")}
+  ambit status app <app>.<network> [--org <org>] [--json]
+  ambit status app <app> --network <name> [--org <org>] [--json]
+
+${bold("OPTIONS")}
+  --network <name>   Target network (if not using dot syntax)
+  --org <org>        Fly.io organization slug
+  --json             Output as JSON
+
+${bold("EXAMPLES")}
+  ambit status app my-app.browsers
+  ambit status app my-app --network browsers --json
+`);
+        return;
+    }
+    const out = createOutput(args.json);
+    const appArg = args._[0];
+    if (!appArg || typeof appArg !== "string") {
+        return out.die("Missing App Name. Usage: ambit status app <app>.<network>");
+    }
+    let app;
+    let network;
+    if (appArg.includes(".")) {
+        const parts = appArg.split(".");
+        if (parts.length !== 2 || !parts[0] || !parts[1]) {
+            return out.die(`'${appArg}' Should Have Exactly One Dot, Like my-app.my-network`);
+        }
+        app = parts[0];
+        network = parts[1];
+    }
+    else {
+        app = appArg;
+        if (!args.network) {
+            return out.die(`Missing Network. Use: ambit status app ${app}.<network>`);
+        }
+        network = args.network;
+    }
+    const prereqOut = createOutput(args.json);
+    const { fly, tailscale, org } = await initSession(prereqOut, {
+        json: args.json,
+        org: args.org,
+    });
+    await stageAppStatus(fly, tailscale, app, network, org, args.json);
+};
+// =============================================================================
+// Top-Level Help
+// =============================================================================
+const showStatusHelp = () => {
+    console.log(`
+${bold("ambit status")} - Show Network, App, and Router Status
+
+${bold("USAGE")}
+  ambit status [options]
+  ambit status network [<name>] [options]
+  ambit status app <app>.<network> [options]
+
+${bold("SUBCOMMANDS")}
+  network    Show router/network status — default when no subcommand given
+  app        Show a specific app's status
+
+${bold("OPTIONS")}
+  --org <org>        Fly.io organization slug
+  --json             Output as JSON
+
+${bold("EXAMPLES")}
+  ambit status
+  ambit status network
+  ambit status network browsers
+  ambit status app my-app.browsers
+
+Run 'ambit status network --help' or 'ambit status app --help' for details.
+`);
+};
+// =============================================================================
+// Dispatcher
+// =============================================================================
+const status = async (argv) => {
+    const subcommand = typeof argv[0] === "string" ? argv[0] : undefined;
+    if (subcommand === "network")
+        return statusNetwork(argv.slice(1));
+    if (subcommand === "app")
+        return statusApp(argv.slice(1));
+    const args = parseArgs(argv, { boolean: ["help"] });
+    if (args.help) {
+        showStatusHelp();
+        return;
+    }
+    return statusNetwork(argv);
+};
+// =============================================================================
+// Register Command
+// =============================================================================
+registerCommand({
+    name: "status",
+    description: "Show network, app, and router status",
+    usage: "ambit status [network|app] [<name>] [--org <org>] [--json]",
+    run: status,
+});

package/esm/cli/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/cli/mod.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAQD,eAAO,MAAM,eAAe,GAAI,SAAS,OAAO,KAAG,IAElD,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,OAAO,GAAG,SAEnD,CAAC;AAEF,eAAO,MAAM,cAAc,QAAO,OAAO,EAExC,CAAC;AAQF,eAAO,MAAM,QAAQ,QAAO,IA6B3B,CAAC;AAEF,eAAO,MAAM,WAAW,QAAO,IAE9B,CAAC;AAMF,eAAO,MAAM,MAAM,GAAU,MAAM,MAAM,EAAE,KAAG,OAAO,CAAC,IAAI,CAuCzD,CAAC"}

package/esm/{src/cli → cli}/mod.js

@@ -1,10 +1,10 @@
 // =============================================================================
 // CLI Framework - Command Parser and Router
 // =============================================================================
-import * as dntShim from "../../_dnt.shims.js";
-import { parseArgs } from "../../deps/jsr.io/@std/cli/1.0.28/mod.js";
-import { bold, dim } from "../../lib/cli.js";
-import denoConfig from "../../deno.js";
+import * as dntShim from "../_dnt.shims.js";
+import { parseArgs } from "../deps/jsr.io/@std/cli/1.0.28/mod.js";
+import { bold, dim } from "../lib/cli.js";
+import denoConfig from "../deno.js";
 // =============================================================================
 // Commands Registry
 // =============================================================================

package/esm/deno.d.ts

@@ -3,24 +3,6 @@ declare namespace _default {
     let version: string;
     let description: string;
     let license: string;
-    let exports: {
-        ".": string;
-        "./providers/fly": string;
-        "./providers/tailscale": string;
-        "./schemas/config": string;
-        "./schemas/fly": string;
-        "./schemas/tailscale": string;
-        "./lib/cli": string;
-        "./lib/command": string;
-        "./lib/output": string;
-        "./lib/result": string;
-        "./lib/paths": string;
-        "./src/credentials": string;
-        "./src/discovery": string;
-        "./src/guard": string;
-        "./src/resolve": string;
-        "./src/template": string;
-    };
     let tasks: {
         dev: string;
         run: string;
@@ -29,6 +11,10 @@ declare namespace _default {
         "check-versions": string;
         build: string;
     };
+    let exports: {
+        ".": string;
+    };
+    let exclude: string[];
     let imports: {
         "@/": string;
         "@cliffy/table": string;

package/esm/deno.js

@@ -1,26 +1,8 @@
 export default {
     "name": "@cardelli/ambit",
-    "version": "0.1.5",
+    "version": "0.2.0",
     "description": "Deploy apps to the cloud that only you and your AI agents can reach",
     "license": "MIT",
-    "exports": {
-        ".": "./main.ts",
-        "./providers/fly": "./src/providers/fly.ts",
-        "./providers/tailscale": "./src/providers/tailscale.ts",
-        "./schemas/config": "./src/schemas/config.ts",
-        "./schemas/fly": "./src/schemas/fly.ts",
-        "./schemas/tailscale": "./src/schemas/tailscale.ts",
-        "./lib/cli": "./lib/cli.ts",
-        "./lib/command": "./lib/command.ts",
-        "./lib/output": "./lib/output.ts",
-        "./lib/result": "./lib/result.ts",
-        "./lib/paths": "./lib/paths.ts",
-        "./src/credentials": "./src/credentials.ts",
-        "./src/discovery": "./src/discovery.ts",
-        "./src/guard": "./src/guard.ts",
-        "./src/resolve": "./src/resolve.ts",
-        "./src/template": "./src/template.ts"
-    },
     "tasks": {
         "dev": "deno run --watch main.ts",
         "run": "deno run -A main.ts",
@@ -29,6 +11,10 @@ export default {
         "check-versions": "deno run --allow-net --allow-run=git scripts/check-versions.ts",
         "build": "deno run -A scripts/build_npm.ts"
     },
+    "exports": {
+        ".": "./main.ts"
+    },
+    "exclude": ["**/npm/"],
     "imports": {
         "@/": "./",
         "@cliffy/table": "jsr:@cliffy/table@^1.0.0",

package/esm/deps/jsr.io/@std/path/1.1.4/constants.d.ts

@@ -2,7 +2,7 @@
  * The character used to separate entries in the PATH environment variable.
  * On Windows, this is `;`. On all other platforms, this is `:`.
  */
-export declare const DELIMITER: ":" | ";";
+export declare const DELIMITER: ";" | ":";
 /**
  * The character used to separate components of a file path.
  * On Windows, this is `\`. On all other platforms, this is `/`.

package/esm/lib/args.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Validates parsed args against the declared options spec.
+ * Dies with a Title Case error if unknown flags are found.
+ * Pass the same options object you gave to parseArgs.
+ */
+export declare const checkArgs: (args: Record<string, unknown>, opts: {
+    string?: readonly string[] | string[];
+    boolean?: readonly string[] | string[];
+    alias?: Record<string, string | string[]>;
+}, command: string) => void;
+//# sourceMappingURL=args.d.ts.map

package/esm/lib/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/lib/args.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,eAAO,MAAM,SAAS,GACpB,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM;IACJ,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACtC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;CAC3C,EACD,SAAS,MAAM,KACd,IAmBF,CAAC"}

package/esm/lib/args.js

@@ -0,0 +1,28 @@
+// =============================================================================
+// Strict Argument Validation — rejects unknown flags via out.die()
+// =============================================================================
+import { createOutput } from "./output.js";
+/**
+ * Validates parsed args against the declared options spec.
+ * Dies with a Title Case error if unknown flags are found.
+ * Pass the same options object you gave to parseArgs.
+ */
+export const checkArgs = (args, opts, command) => {
+    const known = new Set(["_"]);
+    for (const k of opts.string ?? [])
+        known.add(k);
+    for (const k of opts.boolean ?? [])
+        known.add(k);
+    for (const [k, v] of Object.entries(opts.alias ?? {})) {
+        known.add(k);
+        for (const a of Array.isArray(v) ? v : [v])
+            known.add(a);
+    }
+    const bad = Object.keys(args)
+        .filter((k) => !known.has(k))
+        .map((k) => `--${k}`);
+    if (bad.length > 0) {
+        const out = createOutput(!!args.json);
+        out.die(`Unknown Flag(s): ${bad.join(", ")}. Run '${command} --help' for Usage.`);
+    }
+};

package/esm/lib/cli.d.ts

@@ -1,4 +1,3 @@
-import "../_dnt.polyfills.js";
 export declare const bold: (text: string) => string;
 export declare const dim: (text: string) => string;
 export declare const red: (text: string) => string;

package/esm/lib/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/lib/cli.ts"],"names":[],"mappings":"AAKA,OAAO,sBAAsB,CAAC;AAiB9B,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,KAAG,MAAkC,CAAC;AACvE,eAAO,MAAM,GAAG,GAAI,MAAM,MAAM,KAAG,MAAiC,CAAC;AACrE,eAAO,MAAM,GAAG,GAAI,MAAM,MAAM,KAAG,MAAiC,CAAC;AACrE,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,KAAG,MAAmC,CAAC;AACzE,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,KAAG,MAAoC,CAAC;AAC3E,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,KAAG,MAAkC,CAAC;AACvE,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,KAAG,MAAkC,CAAC;AAMvE,eAAO,MAAM,QAAQ,GAAI,SAAS,MAAM,KAAG,IAE1C,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,KAAG,IAE5C,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,SAAS,MAAM,KAAG,IAE3C,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,KAAG,IAE5C,CAAC;AAMF,eAAO,MAAM,GAAG,GAAI,SAAS,MAAM,KAAG,KAGrC,CAAC;AAQF,qBAAa,OAAO;IAClB,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,OAAO,CAAM;IAErB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAe5B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI7B,IAAI,IAAI,IAAI;IASZ,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK9B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAI5B;AAMD,eAAO,MAAM,MAAM,GAAU,SAAS,MAAM,KAAG,OAAO,CAAC,MAAM,CAW5D,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,SAAS,MAAM,KAAG,OAAO,CAAC,OAAO,CAG9D,CAAC;AAEF,eAAO,MAAM,UAAU,GAAU,SAAS,MAAM,KAAG,OAAO,CAAC,MAAM,CAoChE,CAAC;AAMF,eAAO,MAAM,UAAU,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,OAAO,CAI9D,CAAC;AAMF,eAAO,MAAM,YAAY,QAAO,MAG/B,CAAC;AAEF,eAAO,MAAM,aAAa,QAAO,MAEhC,CAAC;AAEF,eAAO,MAAM,eAAe,QAAa,OAAO,CAAC,IAAI,CAUpD,CAAC;AAMF,eAAO,MAAM,QAAQ,GAAI,SAAQ,MAAU,KAAG,MAM7C,CAAC;AAMF,eAAO,MAAM,aAAa,GAAU,SAAS,MAAM,KAAG,OAAO,CAAC,OAAO,CASpE,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/lib/cli.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,KAAG,MAAkC,CAAC;AACvE,eAAO,MAAM,GAAG,GAAI,MAAM,MAAM,KAAG,MAAiC,CAAC;AACrE,eAAO,MAAM,GAAG,GAAI,MAAM,MAAM,KAAG,MAAiC,CAAC;AACrE,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,KAAG,MAAmC,CAAC;AACzE,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,KAAG,MAAoC,CAAC;AAC3E,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,KAAG,MAAkC,CAAC;AACvE,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,KAAG,MAAkC,CAAC;AAMvE,eAAO,MAAM,QAAQ,GAAI,SAAS,MAAM,KAAG,IAE1C,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,KAAG,IAE5C,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,SAAS,MAAM,KAAG,IAE3C,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,KAAG,IAE5C,CAAC;AAMF,eAAO,MAAM,GAAG,GAAI,SAAS,MAAM,KAAG,KAGrC,CAAC;AAQF,qBAAa,OAAO;IAClB,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,OAAO,CAAM;IAErB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAe5B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI7B,IAAI,IAAI,IAAI;IASZ,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK9B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAI5B;AAMD,eAAO,MAAM,MAAM,GAAU,SAAS,MAAM,KAAG,OAAO,CAAC,MAAM,CAW5D,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,SAAS,MAAM,KAAG,OAAO,CAAC,OAAO,CAG9D,CAAC;AAEF,eAAO,MAAM,UAAU,GAAU,SAAS,MAAM,KAAG,OAAO,CAAC,MAAM,CAoChE,CAAC;AAMF,eAAO,MAAM,UAAU,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,OAAO,CAI9D,CAAC;AAMF,eAAO,MAAM,YAAY,QAAO,MAG/B,CAAC;AAEF,eAAO,MAAM,aAAa,QAAO,MAEhC,CAAC;AAEF,eAAO,MAAM,eAAe,QAAa,OAAO,CAAC,IAAI,CAUpD,CAAC;AAMF,eAAO,MAAM,QAAQ,GAAI,SAAQ,MAAU,KAAG,MAM7C,CAAC;AAMF,eAAO,MAAM,aAAa,GAAU,SAAS,MAAM,KAAG,OAAO,CAAC,OAAO,CASpE,CAAC"}

package/esm/lib/cli.js

@@ -2,7 +2,6 @@
 // CLI Utilities - Colors, Spinner, Status Output
 // =============================================================================
 // ANSI Color Codes
-import "../_dnt.polyfills.js";
 import * as dntShim from "../_dnt.shims.js";
 const RESET = "\x1b[0m";
 const BOLD = "\x1b[1m";

package/esm/lib/command.d.ts

@@ -1,4 +1,3 @@
-import "../_dnt.polyfills.js";
 import { Result } from "./result.js";
 export interface RunOptions {
     interactive?: boolean;
@@ -22,8 +21,6 @@ export declare class CmdResult {
  * When `interactive: true`, inherits all stdio (no capture).
  */
 export declare const runCommand: (args: string[], options?: RunOptions) => Promise<CmdResult>;
-/** Run with spinner, return CmdResult. */
-export declare const runQuiet: (label: string, args: string[], options?: RunOptions) => Promise<CmdResult>;
 /** Run and parse stdout as JSON. */
 export declare const runJson: <T>(args: string[], options?: RunOptions) => Promise<Result<T>>;
 //# sourceMappingURL=command.d.ts.map

package/esm/lib/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/lib/command.ts"],"names":[],"mappings":"AAGA,OAAO,sBAAsB,CAAC;AAK9B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAMrC,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CAC5B;AAMD,qBAAa,SAAS;IAIlB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM;IALzB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;gBAGV,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM;IAKzB,iDAAiD;IACjD,IAAI,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC;IAapB,8BAA8B;IAC9B,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF;AAMD;;;GAGG;AACH,eAAO,MAAM,UAAU,GACrB,MAAM,MAAM,EAAE,EACd,UAAU,UAAU,KACnB,OAAO,CAAC,SAAS,CA2CnB,CAAC;AAMF,0CAA0C;AAC1C,eAAO,MAAM,QAAQ,GACnB,OAAO,MAAM,EACb,MAAM,MAAM,EAAE,EACd,UAAU,UAAU,KACnB,OAAO,CAAC,SAAS,CAOnB,CAAC;AAEF,oCAAoC;AACpC,eAAO,MAAM,OAAO,GAAI,CAAC,EACvB,MAAM,MAAM,EAAE,EACd,UAAU,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAuD,CAAC"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/lib/command.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAMrC,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CAC5B;AAMD,qBAAa,SAAS;IAIlB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM;IALzB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;gBAGV,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM;IAKzB,iDAAiD;IACjD,IAAI,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC;IAapB,8BAA8B;IAC9B,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF;AAMD;;;GAGG;AACH,eAAO,MAAM,UAAU,GACrB,MAAM,MAAM,EAAE,EACd,UAAU,UAAU,KACnB,OAAO,CAAC,SAAS,CA2CnB,CAAC;AAMF,oCAAoC;AACpC,eAAO,MAAM,OAAO,GAAI,CAAC,EACvB,MAAM,MAAM,EAAE,EACd,UAAU,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAuD,CAAC"}

package/esm/lib/command.js

@@ -1,9 +1,7 @@
 // =============================================================================
 // Shell Command Helpers
 // =============================================================================
-import "../_dnt.polyfills.js";
 import { spawn } from "node:child_process";
-import { Spinner } from "./cli.js";
 import { Result } from "./result.js";
 // =============================================================================
 // Command Result
@@ -22,13 +20,13 @@ export class CmdResult {
     /** Parse stdout as JSON, returning Result<T>. */
     json() {
         if (!this.ok) {
-            return Result.err(this.stderr || `Command failed with code ${this.code}`);
+            return Result.err(this.stderr || `Command Failed With Code ${this.code}`);
         }
         try {
             return Result.ok(JSON.parse(this.stdout));
         }
         catch {
-            return Result.err(`Failed to parse JSON: ${this.stdout.slice(0, 100)}`);
+            return Result.err(`Failed To Parse JSON: ${this.stdout.slice(0, 100)}`);
         }
     }
     /** Merged stdout + stderr. */
@@ -84,14 +82,5 @@ export const runCommand = (args, options) => {
 // =============================================================================
 // Wrappers
 // =============================================================================
-/** Run with spinner, return CmdResult. */
-export const runQuiet = (label, args, options) => {
-    const spinner = new Spinner();
-    spinner.start(label);
-    return runCommand(args, options).then((r) => {
-        r.ok ? spinner.success(label) : spinner.fail(label);
-        return r;
-    });
-};
 /** Run and parse stdout as JSON. */
 export const runJson = (args, options) => runCommand(args, options).then((r) => r.json());

package/esm/lib/machine.d.ts

@@ -0,0 +1,11 @@
+import { Result } from "./result.js";
+/** A state machine phase with a transition function. */
+export interface Machine<Phase extends string, Ctx> {
+    /** The terminal phase — when reached, the machine stops. */
+    terminal: Phase;
+    /** Execute the transition for the given phase. Returns the next phase. */
+    transition: (phase: Phase, ctx: Ctx) => Promise<Result<Phase>>;
+}
+/** Run a state machine from an initial phase to its terminal phase. */
+export declare const runMachine: <Phase extends string, Ctx>(machine: Machine<Phase, Ctx>, initial: Phase, ctx: Ctx) => Promise<Result<Phase>>;
+//# sourceMappingURL=machine.d.ts.map

package/esm/lib/machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine.d.ts","sourceRoot":"","sources":["../../src/lib/machine.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,wDAAwD;AACxD,MAAM,WAAW,OAAO,CAAC,KAAK,SAAS,MAAM,EAAE,GAAG;IAChD,4DAA4D;IAC5D,QAAQ,EAAE,KAAK,CAAC;IAChB,0EAA0E;IAC1E,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;CAChE;AAED,uEAAuE;AACvE,eAAO,MAAM,UAAU,GAAU,KAAK,SAAS,MAAM,EAAE,GAAG,EACxD,SAAS,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAC5B,SAAS,KAAK,EACd,KAAK,GAAG,KACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAQvB,CAAC"}

package/esm/lib/machine.js

@@ -0,0 +1,15 @@
+// =============================================================================
+// State Machine - Hydrate → Interpret → Run Pattern
+// =============================================================================
+import { Result } from "./result.js";
+/** Run a state machine from an initial phase to its terminal phase. */
+export const runMachine = async (machine, initial, ctx) => {
+    let phase = initial;
+    while (phase !== machine.terminal) {
+        const result = await machine.transition(phase, ctx);
+        if (!result.ok)
+            return result;
+        phase = result.value;
+    }
+    return Result.ok(phase);
+};

package/esm/lib/output.d.ts

@@ -1,4 +1,3 @@
-import "../_dnt.polyfills.js";
 export type SuccessResult<T> = {
     ok: true;
 } & T;
@@ -13,6 +12,7 @@ export declare class Output<T extends Record<string, unknown>> {
     done(data: T): this;
     fail(error: string, data?: Record<string, unknown>): this;
     print(): void;
+    skip(text: string): this;
     ok(text: string): this;
     err(text: string): this;
     info(text: string): this;
@@ -26,6 +26,7 @@ export declare class Output<T extends Record<string, unknown>> {
         fail(msg: string): void;
         stop(): void;
     };
+    spin<R>(label: string, fn: () => Promise<R>): Promise<R>;
     die(message: string): never;
     isJson(): boolean;
 }

package/esm/lib/output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AAGA,OAAO,sBAAsB,CAAC;AAmB9B,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG,CAAC,CAAC;AAChD,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAMvD,qBAAa,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnD,OAAO,CAAC,MAAM,CAGE;IAChB,OAAO,CAAC,QAAQ,CAAU;gBAEd,QAAQ,EAAE,OAAO;IAS7B,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAMnB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAKzD,KAAK,IAAI,IAAI;IAUb,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKtB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKvB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKvB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK1B,KAAK,IAAI,IAAI;IAKb,OAAO,CACL,OAAO,EAAE,MAAM,GACd;QAAE,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,IAAI,IAAI,CAAA;KAAE;IAiBxE,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK;IAS3B,MAAM,IAAI,OAAO;CAGlB;AAMD,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,QAAQ,EAAE,OAAO,GAChB,MAAM,CAAC,CAAC,CAAC,CAEX"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG,CAAC,CAAC;AAChD,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAMvD,qBAAa,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnD,OAAO,CAAC,MAAM,CAGE;IAChB,OAAO,CAAC,QAAQ,CAAU;gBAEd,QAAQ,EAAE,OAAO;IAS7B,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAMnB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAKzD,KAAK,IAAI,IAAI;IAUb,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKtB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKvB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKvB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK1B,KAAK,IAAI,IAAI;IAKb,OAAO,CACL,OAAO,EAAE,MAAM,GACd;QAAE,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,IAAI,IAAI,CAAA;KAAE;IAiBlE,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAgB9D,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK;IAS3B,MAAM,IAAI,OAAO;CAGlB;AAMD,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,QAAQ,EAAE,OAAO,GAChB,MAAM,CAAC,CAAC,CAAC,CAEX"}