@ngosangns/ns-bridge 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 ngosangns
+Copyright (c) 2025-2026 Mike O'Brien (pi-provider-kiro)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,39 @@
-# Temporary Holding Version
+# @ngosangns/ns-bridge
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+CLI for the [ns-bridge](https://github.com/ngosangns/ns-bridge) providers. It installs host packages and refreshes model catalogs in its own process, so Pi and OMP only read the files those commands write.
+
+```bash
+npm install -g @ngosangns/ns-bridge
+ns-bridge help
+```
+
+## Commands
+
+Mutating commands preview. `--apply` runs them. `--dry-run` is the default.
+
+```bash
+ns-bridge install [pi|omp|dsh|all] [--apply] [--profile <name>]
+ns-bridge update [pi|omp|dsh|all] [--apply] [--profile <name>]
+ns-bridge uninstall [pi|omp|dsh|all] [--apply] [--profile <name>]
+ns-bridge models list [kiro|devin|grok|all]
+ns-bridge models refresh [kiro|devin|grok|all] [--apply]
+ns-bridge status
+```
+
+| Host | Install | Update | Uninstall |
+| --- | --- | --- | --- |
+| pi | `pi install npm:@ngosangns/ns-pi-provider` | `pi update --extension npm:@ngosangns/ns-pi-provider` | `pi uninstall npm:@ngosangns/ns-pi-provider` |
+| omp | `omp plugin install ns-omp-provider ns-omp-provider-kiro` | `omp plugin upgrade ns-omp-provider ns-omp-provider-kiro` | `omp plugin uninstall ns-omp-provider ns-omp-provider-kiro` |
+| dsh | `dsh plugin --profile <name> add ns-dsh-llm-kiro ns-dsh-llm-devin ns-dsh-llm-grok` | `dsh plugin --profile <name> update …` | `dsh plugin --profile <name> remove …` |
+
+DSH requires `--profile`. Profile `desktop` is refused: the Electron app owns it. `install` and `update` without `--profile` skip DSH and still preview Pi and OMP.
+
+`models list` and `status` read the catalog files and do not import the provider cores:
+
+- Kiro: `~/.ns-kiro-provider-models-cache.json`
+- Devin: `$NS_DEVIN_MODEL_CACHE`, or `$XDG_DATA_HOME/ns-devin-provider/models.json`
+- Grok: `~/.pi/agent/cache/ns-pi-provider/grok.models.json`
+
+`models refresh --apply` writes those files from the bundled refresh. A missing file is reported as missing. The command does not print the in-memory fallback list.
+
+Pi, OMP, and DSH read those files while they run. They do not refresh them.

package/dist/catalog.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Read the catalog files the hosts already use. This module does not import
+ * the vendor cores, so `ns-bridge status` and `models list` stay off the network.
+ */
+export type Vendor = "kiro" | "devin" | "grok";
+export interface CatalogPaths {
+    kiro: string;
+    devin: string;
+    grok: string;
+}
+export interface CatalogGroup {
+    label: string;
+    ids: string[];
+    fetchedAt?: number;
+}
+export interface CatalogReport {
+    vendor: Vendor;
+    path: string;
+    state: "missing" | "unreadable" | "ready";
+    groups: CatalogGroup[];
+}
+export declare function parseVendors(target: string | undefined): Vendor[] | {
+    error: string;
+};
+/** Same files the provider packages write. Overrides match those packages. */
+export declare function catalogPaths(env?: NodeJS.ProcessEnv, home?: string): CatalogPaths;
+export declare function readCatalogs(paths: CatalogPaths, vendors?: readonly Vendor[]): CatalogReport[];
+export declare function formatCatalog(report: CatalogReport, mode: "list" | "status", now?: number): string[];

package/dist/catalog.js

@@ -0,0 +1,142 @@
+/**
+ * Read the catalog files the hosts already use. This module does not import
+ * the vendor cores, so `ns-bridge status` and `models list` stay off the network.
+ */
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const VENDORS = ["kiro", "devin", "grok"];
+export function parseVendors(target) {
+    if (!target || target === "all")
+        return [...VENDORS];
+    if (target === "kiro" || target === "devin" || target === "grok")
+        return [target];
+    return { error: `unknown vendor ${target} (expected kiro, devin, grok, or all)` };
+}
+/** Same files the provider packages write. Overrides match those packages. */
+export function catalogPaths(env = process.env, home = homedir()) {
+    const dataHome = env.XDG_DATA_HOME ?? join(home, ".local", "share");
+    return {
+        kiro: join(home, ".ns-kiro-provider-models-cache.json"),
+        devin: env.NS_DEVIN_MODEL_CACHE ?? join(dataHome, "ns-devin-provider", "models.json"),
+        grok: join(home, ".pi", "agent", "cache", "ns-pi-provider", "grok.models.json"),
+    };
+}
+export function readCatalogs(paths, vendors = VENDORS) {
+    return vendors.map((vendor) => readOne(vendor, paths[vendor]));
+}
+function readOne(vendor, path) {
+    let raw;
+    try {
+        raw = readFileSync(path, "utf8");
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ENOENT")
+            return { vendor, path, state: "missing", groups: [] };
+        return { vendor, path, state: "unreadable", groups: [] };
+    }
+    const groups = vendor === "kiro" ? parseKiro(raw) : parseModelList(raw, vendor);
+    if (!groups)
+        return { vendor, path, state: "unreadable", groups: [] };
+    return { vendor, path, state: "ready", groups };
+}
+function parseKiro(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+    if (!isRecord(parsed) || !isRecord(parsed.regions))
+        return undefined;
+    const groups = [];
+    for (const [region, entry] of Object.entries(parsed.regions)) {
+        if (!isRecord(entry) || !Array.isArray(entry.models))
+            return undefined;
+        const ids = idsFrom(entry.models);
+        if (ids.length === 0)
+            continue;
+        groups.push({
+            label: region,
+            ids,
+            ...(typeof entry.fetchedAt === "number" ? { fetchedAt: entry.fetchedAt } : {}),
+        });
+    }
+    return groups;
+}
+function parseModelList(raw, label) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+    if (!isRecord(parsed) || !Array.isArray(parsed.models))
+        return undefined;
+    return [
+        {
+            label,
+            ids: idsFrom(parsed.models),
+            ...(typeof parsed.fetchedAt === "number" ? { fetchedAt: parsed.fetchedAt } : {}),
+        },
+    ];
+}
+function idsFrom(models) {
+    const ids = [];
+    for (const entry of models) {
+        if (!isRecord(entry) || typeof entry.id !== "string" || entry.id.length === 0)
+            continue;
+        ids.push(entry.id);
+    }
+    return ids;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function formatCatalog(report, mode, now = Date.now()) {
+    if (report.state === "missing")
+        return [`${report.vendor}  no cache file  ${report.path}`];
+    if (report.state === "unreadable")
+        return [`${report.vendor}  unreadable cache  ${report.path}`];
+    const ids = report.groups.flatMap((group) => group.ids);
+    const fetched = report.groups.find((group) => group.fetchedAt !== undefined)?.fetchedAt;
+    const when = fetched === undefined ? "" : `  fetched ${age(fetched, now)}`;
+    if (mode === "status") {
+        const lines = [`${report.vendor}  ${ids.length} model(s)${when}  ${report.path}`];
+        for (const group of report.groups) {
+            const shown = group.ids.slice(0, 8);
+            const extra = group.ids.length - shown.length;
+            const body = extra > 0 ? `${shown.join(", ")}, … (${extra} more)` : shown.join(", ");
+            const prefix = report.vendor === "kiro" ? `${group.label}: ` : "";
+            if (body)
+                lines.push(`  ${prefix}${body}`);
+        }
+        return lines;
+    }
+    const lines = [`${report.vendor}  ${report.path}${when}`];
+    for (const group of report.groups) {
+        if (report.vendor === "kiro") {
+            const regionWhen = group.fetchedAt === undefined ? "" : `  fetched ${age(group.fetchedAt, now)}`;
+            lines.push(`  ${group.label}${regionWhen}`);
+        }
+        for (const id of group.ids)
+            lines.push(report.vendor === "kiro" ? `    ${id}` : `  ${id}`);
+    }
+    return lines;
+}
+function age(fetchedAt, now) {
+    const seconds = Math.max(0, Math.round((now - fetchedAt) / 1000));
+    if (seconds < 60)
+        return `${seconds}s ago`;
+    const minutes = Math.round(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m ago`;
+    const hours = Math.round(minutes / 60);
+    if (hours < 48)
+        return `${hours}h ago`;
+    return `${Math.round(hours / 24)}d ago`;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `ns-bridge` command dispatcher.
+ *
+ * Mutating commands print the host argv and exit 0. `--apply` runs them.
+ * That matches the OKF tools in ns-docs: a preview is the default, and a write
+ * is an explicit flag.
+ */
+import { type CatalogPaths } from "./catalog.js";
+import { type ModelRefresh } from "./refresh.js";
+export interface CommandResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+}
+export type Runner = (argv: string[]) => Promise<CommandResult>;
+export interface RunOptions {
+    log?: (line: string) => void;
+    err?: (line: string) => void;
+    runner?: Runner;
+    refreshers?: ModelRefresh;
+    paths?: CatalogPaths;
+    now?: number;
+}
+export declare function spawnRunner(): Runner;
+export declare function run(argv: readonly string[], options?: RunOptions): Promise<number>;

package/dist/cli.js

@@ -0,0 +1,238 @@
+/**
+ * `ns-bridge` command dispatcher.
+ *
+ * Mutating commands print the host argv and exit 0. `--apply` runs them.
+ * That matches the OKF tools in ns-docs: a preview is the default, and a write
+ * is an explicit flag.
+ */
+import { spawn } from "node:child_process";
+import { catalogPaths, formatCatalog, parseVendors, readCatalogs } from "./catalog.js";
+import { formatCommand, parseHosts, planHostCommands } from "./hosts.js";
+import { defaultModelRefresh, refreshLine } from "./refresh.js";
+const HELP = `ns-bridge — install, update, and refresh providers outside Pi, OMP, and DSH.
+
+Mutating commands preview and do not spawn. Pass --apply to run them.
+--dry-run is the default.
+
+Usage:
+  ns-bridge install [pi|omp|dsh|all] [--apply] [--profile <name>]
+  ns-bridge update [pi|omp|dsh|all] [--apply] [--profile <name>]
+  ns-bridge uninstall [pi|omp|dsh|all] [--apply] [--profile <name>]
+  ns-bridge models list [kiro|devin|grok|all]
+  ns-bridge models refresh [kiro|devin|grok|all] [--apply]
+  ns-bridge status
+  ns-bridge help
+
+Hosts:
+  pi   pi install npm:@ngosangns/ns-pi-provider
+       pi update --extension npm:@ngosangns/ns-pi-provider
+       pi uninstall npm:@ngosangns/ns-pi-provider
+  omp  omp plugin install ns-omp-provider ns-omp-provider-kiro
+       omp plugin upgrade ns-omp-provider ns-omp-provider-kiro
+       omp plugin uninstall ns-omp-provider ns-omp-provider-kiro
+  dsh  dsh plugin --profile <name> add ns-dsh-llm-kiro ns-dsh-llm-devin ns-dsh-llm-grok
+       dsh plugin --profile <name> update …
+       dsh plugin --profile <name> remove …
+
+DSH requires --profile. Profile "desktop" is refused: the Electron app owns it.
+install/update without --profile skips DSH and still previews Pi and OMP.
+These commands install the npm packages. A local Pi path stays until that install runs.
+
+Model catalogs are files the hosts read. Providers do not refresh them.
+This command writes those files:
+  ns-bridge models refresh --apply
+`;
+export function spawnRunner() {
+    return (argv) => new Promise((resolve) => {
+        const [command, ...args] = argv;
+        if (!command) {
+            resolve({ code: 127, stdout: "", stderr: "empty command" });
+            return;
+        }
+        const child = spawn(command, args, { stdio: ["ignore", "pipe", "pipe"] });
+        let stdout = "";
+        let stderr = "";
+        let settled = false;
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(result);
+        };
+        child.stdout?.on("data", (chunk) => {
+            stdout += String(chunk);
+        });
+        child.stderr?.on("data", (chunk) => {
+            stderr += String(chunk);
+        });
+        child.on("error", (error) => {
+            finish({ code: 127, stdout, stderr: `${stderr}${error.message}` });
+        });
+        child.on("close", (code) => {
+            finish({ code: code ?? 1, stdout, stderr });
+        });
+    });
+}
+export async function run(argv, options = {}) {
+    const log = options.log ?? ((line) => console.log(line));
+    const err = options.err ?? ((line) => console.error(line));
+    const parsed = parseArgs(argv);
+    if ("error" in parsed) {
+        err(parsed.error);
+        err("run ns-bridge help");
+        return 1;
+    }
+    if (parsed.help || parsed.positionals.length === 0) {
+        log(HELP.trimEnd());
+        return 0;
+    }
+    const [command, target, extra] = parsed.positionals;
+    if (command === "help") {
+        log(HELP.trimEnd());
+        return 0;
+    }
+    if (command === "status") {
+        if (target) {
+            err(`status takes no arguments (got ${target})`);
+            return 1;
+        }
+        return printCatalogs(log, options, ["kiro", "devin", "grok"], "status");
+    }
+    if (command === "models") {
+        if (target !== "list" && target !== "refresh") {
+            err("usage: ns-bridge models list|refresh [kiro|devin|grok|all]");
+            return 1;
+        }
+        const vendors = parseVendors(extra);
+        if ("error" in vendors) {
+            err(vendors.error);
+            return 1;
+        }
+        if (parsed.positionals.length > 3) {
+            err(`unexpected argument ${parsed.positionals[3]}`);
+            return 1;
+        }
+        if (target === "list")
+            return printCatalogs(log, options, vendors, "list");
+        return refreshModels(log, err, parsed.apply, vendors, options);
+    }
+    if (command === "install" || command === "update" || command === "uninstall") {
+        if (parsed.positionals.length > 2) {
+            err(`unexpected argument ${extra}`);
+            return 1;
+        }
+        return runHost(command, target, parsed, log, err, options);
+    }
+    err(`unknown command ${command}`);
+    err("run ns-bridge help");
+    return 1;
+}
+function printCatalogs(log, options, vendors, mode) {
+    const paths = options.paths ?? catalogPaths();
+    const now = options.now ?? Date.now();
+    for (const report of readCatalogs(paths, vendors)) {
+        for (const line of formatCatalog(report, mode, now))
+            log(line);
+    }
+    return 0;
+}
+async function refreshModels(log, err, apply, vendors, options) {
+    if (!apply) {
+        log("# dry-run (pass --apply to run)");
+        for (const vendor of vendors)
+            log(`refresh ${vendor}`);
+        return 0;
+    }
+    const refreshers = options.refreshers ?? (await defaultModelRefresh());
+    for (const vendor of vendors) {
+        try {
+            log(refreshLine(vendor, await refreshers[vendor]()));
+        }
+        catch (error) {
+            err(`${vendor}: ${error instanceof Error ? error.message : String(error)}`);
+            return 1;
+        }
+    }
+    return 0;
+}
+async function runHost(action, target, parsed, log, err, options) {
+    const hosts = parseHosts(target);
+    if ("error" in hosts) {
+        err(hosts.error);
+        return 1;
+    }
+    const plan = planHostCommands(action, hosts, parsed.profile);
+    if (plan.error) {
+        err(plan.error);
+        return 1;
+    }
+    if (!parsed.apply) {
+        log("# dry-run (pass --apply to run)");
+        for (const argv of plan.commands)
+            log(formatCommand(argv));
+        if (plan.skipDsh)
+            log("# dsh skipped: pass --profile <name>");
+        return 0;
+    }
+    const runner = options.runner ?? spawnRunner();
+    for (const argv of plan.commands) {
+        log(formatCommand(argv));
+        const result = await runner(argv);
+        if (result.stdout.trim())
+            log(result.stdout.trimEnd());
+        if (result.code !== 0) {
+            if (result.stderr.trim())
+                err(result.stderr.trimEnd());
+            err(`${formatCommand(argv)} exited ${result.code}`);
+            return 2;
+        }
+    }
+    if (plan.skipDsh)
+        log("# dsh skipped: pass --profile <name>");
+    return 0;
+}
+function parseArgs(argv) {
+    const positionals = [];
+    let apply = false;
+    let profile;
+    let help = false;
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index] ?? "";
+        if (arg === "--") {
+            positionals.push(...argv.slice(index + 1));
+            break;
+        }
+        if (arg === "--help" || arg === "-h") {
+            help = true;
+            continue;
+        }
+        if (arg === "--apply") {
+            apply = true;
+            continue;
+        }
+        if (arg === "--dry-run") {
+            apply = false;
+            continue;
+        }
+        if (arg === "--profile") {
+            const value = argv[index + 1];
+            if (!value || value.startsWith("-"))
+                return { error: "--profile needs a name" };
+            profile = value;
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--profile=")) {
+            const value = arg.slice("--profile=".length);
+            if (!value)
+                return { error: "--profile needs a name" };
+            profile = value;
+            continue;
+        }
+        if (arg.startsWith("-"))
+            return { error: `unknown flag ${arg}` };
+        positionals.push(arg);
+    }
+    return { positionals, apply, profile, help };
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/hosts.d.ts

@@ -0,0 +1,22 @@
+/** Host package commands. Mutating commands are previews until `--apply`. */
+export declare const PI_SOURCE = "npm:@ngosangns/ns-pi-provider";
+export declare const OMP_PACKAGES: readonly ["ns-omp-provider", "ns-omp-provider-kiro"];
+export declare const DSH_PACKAGES: readonly ["ns-dsh-llm-kiro", "ns-dsh-llm-devin", "ns-dsh-llm-grok"];
+export type Host = "pi" | "omp" | "dsh";
+export type HostAction = "install" | "update" | "uninstall";
+export interface HostPlan {
+    commands: string[][];
+    /** `install all` has no profile, so DSH is left out of the preview. */
+    skipDsh: boolean;
+    error?: string;
+}
+export declare function parseHosts(target: string | undefined): Host[] | {
+    error: string;
+};
+/** Quote one argv element the way a shell would show it. */
+export declare function formatCommand(argv: readonly string[]): string;
+/**
+ * The commands `ns-bridge` would run. DSH always needs `--profile`.
+ * Profile `desktop` is refused: the Electron app owns that profile.
+ */
+export declare function planHostCommands(action: HostAction, hosts: readonly Host[], profile: string | undefined): HostPlan;

package/dist/hosts.js

@@ -0,0 +1,65 @@
+/** Host package commands. Mutating commands are previews until `--apply`. */
+export const PI_SOURCE = "npm:@ngosangns/ns-pi-provider";
+export const OMP_PACKAGES = ["ns-omp-provider", "ns-omp-provider-kiro"];
+export const DSH_PACKAGES = ["ns-dsh-llm-kiro", "ns-dsh-llm-devin", "ns-dsh-llm-grok"];
+const HOSTS = ["pi", "omp", "dsh"];
+export function parseHosts(target) {
+    if (!target || target === "all")
+        return [...HOSTS];
+    if (target === "pi" || target === "omp" || target === "dsh")
+        return [target];
+    return { error: `unknown host ${target} (expected pi, omp, dsh, or all)` };
+}
+/** Quote one argv element the way a shell would show it. */
+export function formatCommand(argv) {
+    return argv.map(quoteArg).join(" ");
+}
+function quoteArg(arg) {
+    if (arg.length === 0)
+        return "''";
+    if (/^[A-Za-z0-9_@./:=+-]+$/.test(arg))
+        return arg;
+    return `'${arg.replaceAll("'", `'\\''`)}'`;
+}
+/**
+ * The commands `ns-bridge` would run. DSH always needs `--profile`.
+ * Profile `desktop` is refused: the Electron app owns that profile.
+ */
+export function planHostCommands(action, hosts, profile) {
+    const wantsDsh = hosts.includes("dsh");
+    if (wantsDsh && profile?.toLowerCase() === "desktop") {
+        return {
+            commands: [],
+            skipDsh: false,
+            error: 'profile "desktop" is managed by the DSH Electron app; pass another profile name',
+        };
+    }
+    if (wantsDsh && !profile) {
+        if (hosts.length === 1) {
+            return { commands: [], skipDsh: false, error: "dsh needs --profile <name>" };
+        }
+    }
+    const commands = [];
+    for (const host of hosts) {
+        if (host === "dsh" && !profile)
+            continue;
+        commands.push(commandFor(action, host, profile));
+    }
+    return { commands, skipDsh: wantsDsh && !profile };
+}
+function commandFor(action, host, profile) {
+    if (host === "pi") {
+        if (action === "install")
+            return ["pi", "install", PI_SOURCE];
+        if (action === "update")
+            return ["pi", "update", "--extension", PI_SOURCE];
+        return ["pi", "uninstall", PI_SOURCE];
+    }
+    if (host === "omp") {
+        const verb = action === "update" ? "upgrade" : action === "uninstall" ? "uninstall" : "install";
+        return ["omp", "plugin", verb, ...OMP_PACKAGES];
+    }
+    const verb = action === "update" ? "update" : action === "uninstall" ? "remove" : "add";
+    return ["dsh", "plugin", "--profile", profile ?? "", verb, ...DSH_PACKAGES];
+}
+//# sourceMappingURL=hosts.js.map

package/dist/hosts.js.map

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

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/main.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { run } from "./cli.js";
+const code = await run(process.argv.slice(2));
+process.exit(code);
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}