@shogo-ai/cli 1.4.1

package/dist/pkg.d.ts

@@ -0,0 +1,139 @@
+import { StdioOptions } from 'node:child_process';
+
+/**
+ * PlatformPackageManager — centralises Windows vs Unix differences for
+ * package-manager operations (install, exec, prisma, etc.).
+ *
+ * On Windows Bun 1.x's default hardlink backend can leave empty package
+ * directories in `node_modules/` (most visibly under transitive deps
+ * like `whatwg-url` → `webidl-conversions`, which then crashes any
+ * `expo export` / Vite build that imports them). We mitigate by
+ * preferring `npm.cmd` for installs when Node.js is on PATH; if it
+ * isn't (Shogo Desktop ships its own bun but not Node), we fall back
+ * to `bun install --backend=copyfile` which sidesteps the hardlink
+ * path entirely. The trade-off is a slower install vs. a half-broken
+ * `node_modules` that fails downstream commands without explanation.
+ *
+ * Lifted into the SDK from `@shogo/shared-runtime` (was AGPL) under MIT
+ * so the SDK CLI (`bin/shogo.ts`) and userland tooling can use it without
+ * dragging an AGPL runtime dependency into the published `@shogo-ai/sdk`
+ * package. Shogo Technologies, Inc. holds copyright; the file is
+ * dependency-free (only `node:child_process`, `node:fs`, `node:path`).
+ */
+
+interface PkgInstallOptions {
+    timeout?: number;
+    stdio?: StdioOptions;
+    env?: NodeJS.ProcessEnv;
+    /** Attempt --frozen-lockfile first, fall back to plain install (bun only). */
+    frozen?: boolean;
+}
+/** Error thrown when the Windows Node.js prerequisite is missing. */
+declare class NodeMissingError extends Error {
+    readonly code: "NODE_NOT_INSTALLED";
+    constructor();
+}
+/**
+ * True if npm.cmd can be located via PATH or the standard Windows install dir.
+ * Cheap — only a single existsSync + PATH walk — so safe to call from hot paths.
+ * Always returns true on non-Windows (bun is used there).
+ */
+declare function isNodeAvailableOnWindows(pathEnv?: string | undefined): boolean;
+/**
+ * True if a `node` binary is on PATH (Unix-style search). The Shogo
+ * Desktop API process is spawned by Electron with a PATH inherited
+ * from `launchctl`, which on macOS frequently EXCLUDES the user's
+ * shell-managed paths (Homebrew, nvm, asdf). `process.env.PATH` is
+ * what child spawns see when they exec a `#!/usr/bin/env node` shim,
+ * so this is the right thing to check.
+ *
+ * Cached for the lifetime of the process — node-install state doesn't
+ * change between project opens, and re-walking PATH on every spawn
+ * adds up.
+ *
+ * Pass an explicit `pathEnv` only from tests; production callers should
+ * use the default.
+ */
+declare function isNodeAvailableOnUnix(pathEnv?: string | undefined): boolean;
+/** Reset the cached node-availability probe — only used by tests. */
+declare function _resetUnixNodeCache(): void;
+/**
+ * Resolve a `node_modules/.bin/<name>` invocation that works whether
+ * or not a system `node` is on PATH.
+ *
+ * Why this exists: npm publishes its `.bin/<tool>` shims with
+ * `#!/usr/bin/env node` at the top of the underlying JS file. The
+ * kernel reads the shebang and tries to exec `/usr/bin/env node`;
+ * if `node` isn't on PATH the exec fails with `env: node: No such
+ * file or directory` and the spawn exits 127. Shogo Desktop ships
+ * the bundled `bun` runtime but does not bundle Node.js, and many
+ * end-user macOS PATHs (launchctl-default) don't expose any
+ * shell-installed node either — so every `spawn(.bin/vite, ...)`
+ * fails on first use. Observed in main.log:
+ *   [CanvasBuildManager] Build error: env: node: No such file or directory
+ *   [preview-manager] Vite build --watch exited (code=127, signal=null)
+ *
+ * Returns `null` if the shim doesn't exist (caller should treat
+ * this exactly like the historical `existsSync(viteBin)` no-op
+ * path). Otherwise returns `{ cmd, argsPrefix }`:
+ *   - On Windows, or when `node` is on PATH: the shim itself with
+ *     no prefix args (preserves the current behavior — fastest path).
+ *   - When node is missing on Unix: `readlinkSync` resolves the shim
+ *     to its underlying `.../bin/<tool>.js`, and we route through
+ *     the bundled `bun` (`{ cmd: bunBinary, argsPrefix: [jsEntry] }`),
+ *     which executes the JS directly and treats the shebang as a
+ *     comment. Bun's CLI compatibility is a superset of node for
+ *     the bundler tools we ship (vite, expo) — same exit codes,
+ *     same flag parsing.
+ */
+declare function resolveBinInvocation(workspaceDir: string, binName: string): {
+    cmd: string;
+    argsPrefix: string[];
+} | null;
+interface PkgExecOptions {
+    timeout?: number;
+    stdio?: StdioOptions;
+    env?: NodeJS.ProcessEnv;
+    /** Use `bunx --bun` instead of plain `bunx` (needed for some tools). */
+    useBunFlag?: boolean;
+}
+declare class PlatformPackageManager {
+    readonly isWindows: boolean;
+    /** Resolved path to the bun binary — prefers SHOGO_BUN_PATH (set by desktop app) over bare `bun`. */
+    get bunBinary(): string;
+    private shellOpt;
+    private spawnEnv;
+    installSync(cwd: string, opts?: PkgInstallOptions): void;
+    /**
+     * Windows-only fallback path: `bun install [--frozen-lockfile]
+     * --backend=copyfile`. Used when npm.cmd isn't available on PATH
+     * (typically: Shogo Desktop bundles bun but the user didn't install
+     * Node.js separately).
+     *
+     * The `--backend=copyfile` flag forces bun to copy package contents
+     * into `node_modules/` instead of hardlinking from
+     * `~/.bun/install/cache`. Hardlinks are bun's default for speed but
+     * fail in confusing ways on Windows (the destination directory gets
+     * created but ends up empty, and downstream `require('webidl-conversions')`
+     * etc. then crash with MODULE_NOT_FOUND). See bun#10327 / #28653.
+     */
+    private installSyncBunCopyfile;
+    installAsync(cwd: string, opts?: PkgInstallOptions): Promise<void>;
+    private installAsyncWindowsNpm;
+    private installAsyncBunCopyfile;
+    private installAsyncBun;
+    execToolSync(tool: string, args: string[], cwd: string, opts?: PkgExecOptions): string;
+    execToolAsync(tool: string, args: string[], cwd: string, opts?: PkgExecOptions): Promise<string>;
+    prismaGenerate(cwd: string, opts?: PkgExecOptions): void;
+    prismaDbPush(cwd: string, opts?: PkgExecOptions & {
+        acceptDataLoss?: boolean;
+    }): void;
+    prismaGenerateAsync(cwd: string, opts?: PkgExecOptions): Promise<void>;
+    prismaDbPushAsync(cwd: string, opts?: PkgExecOptions & {
+        acceptDataLoss?: boolean;
+    }): Promise<void>;
+}
+/** Singleton — most consumers just need one. */
+declare const pkg: PlatformPackageManager;
+
+export { NodeMissingError, type PkgExecOptions, type PkgInstallOptions, PlatformPackageManager, _resetUnixNodeCache, isNodeAvailableOnUnix, isNodeAvailableOnWindows, pkg, resolveBinInvocation };

package/dist/pkg.js

@@ -0,0 +1,19 @@
+import {
+  NodeMissingError,
+  PlatformPackageManager,
+  _resetUnixNodeCache,
+  isNodeAvailableOnUnix,
+  isNodeAvailableOnWindows,
+  pkg,
+  resolveBinInvocation
+} from "./chunk-UB4RE2UC.js";
+export {
+  NodeMissingError,
+  PlatformPackageManager,
+  _resetUnixNodeCache,
+  isNodeAvailableOnUnix,
+  isNodeAvailableOnWindows,
+  pkg,
+  resolveBinInvocation
+};
+//# sourceMappingURL=pkg.js.map

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@shogo-ai/cli",
+  "version": "1.4.1",
+  "description": "Shogo CLI helpers — deploy/manifest validation and packager for Shogo agents.",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./deploy": {
+      "types": "./dist/deploy.d.ts",
+      "import": "./dist/deploy.js",
+      "require": "./dist/deploy.cjs"
+    },
+    "./pkg": {
+      "types": "./dist/pkg.d.ts",
+      "import": "./dist/pkg.js",
+      "require": "./dist/pkg.cjs"
+    }
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.cjs",
+    "dist/**/*.d.ts",
+    "dist/**/*.d.cts"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "bun --no-env-file test src/"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "tsup": "^8.0.0",
+    "typescript": "^6.0.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "shogo",
+    "cli",
+    "deploy",
+    "agent",
+    "manifest"
+  ],
+  "author": "Shogo Labs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shogo-labs/shogo-ai.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/shogo-labs/shogo-ai/tree/main/packages/cli#readme",
+  "bugs": {
+    "url": "https://github.com/shogo-labs/shogo-ai/issues"
+  }
+}