@forgedesk/cli 2.0.0

package/README.md

@@ -0,0 +1,27 @@
+# @forgedesk/cli
+
+Node wrapper for the Forge Python CLI.
+
+## Requirements
+
+- Python 3.14+ free-threaded runtime (`forge-framework`)
+- Node.js 18+
+
+## Install
+
+```bash
+npm install -D @forgedesk/cli
+```
+
+## Usage
+
+```bash
+npx forge create my-app --template react
+npx forge dev
+npx forge build
+npx forge package --result-format json
+npx forge sign --result-format json
+```
+
+If the Python Forge package is missing, the wrapper attempts to install `forge-framework` with `pip` unless `FORGE_SKIP_AUTO_INSTALL=1` is set.
+The wrapper is intended to run against the same free-threaded Forge runtime used by the main framework.

package/bin/forge.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+
+function pythonLaunchers() {
+  if (process.platform === "win32") {
+    return [
+      { command: "py", args: ["-3"] },
+      { command: "python", args: [] },
+    ];
+  }
+  return [
+    { command: process.env.FORGE_PYTHON || "python3", args: [] },
+    { command: "python", args: [] },
+  ];
+}
+
+function run(command, args) {
+  const child = spawnSync(command, args, { stdio: "inherit" });
+  return child.status ?? 1;
+}
+
+function ensurePythonForge() {
+  for (const launcher of pythonLaunchers()) {
+    const probe = spawnSync(launcher.command, [...launcher.args, "-m", "forge_cli.main", "--help"], {
+      stdio: "ignore",
+    });
+    if (probe.status === 0) {
+      return launcher;
+    }
+  }
+
+  if (process.env.FORGE_SKIP_AUTO_INSTALL === "1") {
+    return null;
+  }
+
+  for (const launcher of pythonLaunchers()) {
+    const install = spawnSync(
+      launcher.command,
+      [...launcher.args, "-m", "pip", "install", "forge-framework"],
+      { stdio: "inherit" },
+    );
+    if (install.status === 0) {
+      return launcher;
+    }
+  }
+  return null;
+}
+
+const argv = process.argv.slice(2);
+
+const launcher = ensurePythonForge();
+if (!launcher) {
+  console.error("\x1b[1;31m✖\x1b[0m \x1b[1mForge CLI is unavailable.\x1b[0m\n\x1b[33mInstall Python 3.14+ and run:\x1b[0m \x1b[36mpython -m pip install forge-framework\x1b[0m");
+  process.exit(1);
+}
+
+process.exit(run(launcher.command, [...launcher.args, "-m", "forge_cli.main", ...argv]));

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@forgedesk/cli",
+  "version": "2.0.0",
+  "description": "Node wrapper for the Forge Python CLI",
+  "license": "MIT",
+  "homepage": "https://forge-framework.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/swadhinbiswas/Forge.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/swadhinbiswas/Forge/issues"
+  },
+  "type": "module",
+  "bin": {
+    "forge": "./bin/forge.js"
+  },
+  "files": [
+    "bin/forge.js",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "forge",
+    "cli",
+    "desktop",
+    "python"
+  ]
+}