@forgeone/cli 1.0.0

package/README.md

@@ -0,0 +1,67 @@
+# @forgeone/cli
+
+> **AI-native developer framework** — scaffold, lint, scan, and ship production-grade services without touching Go.
+
+## Install
+
+```sh
+npm install -g @forgeone/cli
+# or run without installing
+npx @forgeone/cli new my-app --template ts-service
+```
+
+No Go installation required. The right pre-compiled binary is pulled automatically for your platform.
+
+## Quick start
+
+```sh
+# Scaffold a new TypeScript/NestJS service
+forge new my-app --template ts-service
+cd my-app && npm install && npm run dev
+
+# Or initialise the current directory (like git init / npm init)
+mkdir my-app && cd my-app
+forge init
+
+# List all available templates
+forge new --list
+```
+
+## Supported platforms
+
+| Platform | Package |
+|---|---|
+| Linux x64 | `@forgeone/cli-linux-x64` |
+| Linux arm64 | `@forgeone/cli-linux-arm64` |
+| macOS x64 | `@forgeone/cli-darwin-x64` |
+| macOS arm64 (Apple Silicon) | `@forgeone/cli-darwin-arm64` |
+| Windows x64 | `@forgeone/cli-win32-x64` |
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `forge new <template> <name>` | Scaffold a new project in a new directory |
+| `forge init [path]` | Initialise an existing directory as a Forge project |
+| `forge lint` | Run Forge hygiene linting |
+| `forge scan secrets` | Scan for leaked secrets |
+| `forge scan security` | Run SAST security scan |
+| `forge doctor` | Health-check the current project |
+| `forge ship` | Production readiness gate |
+| `forge eval` | Run AI eval scenarios |
+
+Run `forge --help` for the full command reference.
+
+## Building from source
+
+```sh
+git clone https://github.com/teragrid/forge
+cd forge
+go build -o dist/forge ./cmd/forge
+```
+
+Requires Go 1.24+.
+
+## License
+
+Apache-2.0 — see [LICENSE](https://github.com/teragrid/forge/blob/main/LICENSE).

package/bin/forge.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+// bin/forge.js — @forgeone/cli platform wrapper
+//
+// Resolves the pre-compiled Go binary for the current platform from the
+// matching optional dependency package, then execs it transparently.
+//
+// Pattern used by: esbuild, @biomejs/biome, turbo, prisma, oxc-parser.
+// No Go installation required on the user's machine.
+
+"use strict";
+
+const { execFileSync } = require("child_process");
+const path = require("path");
+const fs = require("fs");
+
+// ── Platform → optional-dependency mapping ──────────────────────────────────
+
+const PLATFORM_PACKAGES = {
+  "linux-x64":    ["@forgeone/cli-linux-x64",    "forge"],
+  "linux-arm64":  ["@forgeone/cli-linux-arm64",  "forge"],
+  "darwin-x64":   ["@forgeone/cli-darwin-x64",   "forge"],
+  "darwin-arm64": ["@forgeone/cli-darwin-arm64",  "forge"],
+  "win32-x64":    ["@forgeone/cli-win32-x64",    "forge.exe"],
+};
+
+// ── Resolve binary path ──────────────────────────────────────────────────────
+
+function resolveBinary() {
+  const platform = `${process.platform}-${process.arch}`;
+  const entry = PLATFORM_PACKAGES[platform];
+
+  if (!entry) {
+    fatal(
+      `Unsupported platform: ${platform}\n` +
+      `Supported: ${Object.keys(PLATFORM_PACKAGES).join(", ")}\n` +
+      `You can build from source: https://github.com/teragrid/forge#building-from-source`
+    );
+  }
+
+  const [pkgName, binaryName] = entry;
+
+  // Walk up from this file to find the package inside node_modules.
+  // Works whether @forge/cli is installed globally, locally, or via npx.
+  let dir = __dirname;
+  for (let i = 0; i < 5; i++) {
+    dir = path.dirname(dir);
+    const candidate = path.join(dir, "node_modules", pkgName, "bin", binaryName);
+    if (fs.existsSync(candidate)) {
+      return candidate;
+    }
+  }
+
+  fatal(
+    `Could not find the ${pkgName} package.\n` +
+    `This usually means the optional dependency was skipped during install.\n` +
+    `Try: npm install --include=optional\n` +
+    `Or install directly: npm install ${pkgName}`
+  );
+}
+
+// ── Execute ──────────────────────────────────────────────────────────────────
+
+function main() {
+  const binary = resolveBinary();
+
+  // Make sure the binary is executable (npm may strip the bit on unpack).
+  try {
+    fs.chmodSync(binary, 0o755);
+  } catch (_) {
+    // Best-effort; Windows doesn't need it.
+  }
+
+  try {
+    execFileSync(binary, process.argv.slice(2), { stdio: "inherit" });
+  } catch (err) {
+    // execFileSync throws when the child exits non-zero.
+    // Mirror the child's exit code so shell pipelines work correctly.
+    process.exit(err.status ?? 1);
+  }
+}
+
+// ── Helpers ──────────────────────────────────────────────────────────────────
+
+function fatal(msg) {
+  process.stderr.write(`\n[forge] ERROR: ${msg}\n\n`);
+  process.exit(1);
+}
+
+main();

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@forgeone/cli",
+  "version": "1.0.0",
+  "description": "Forge CLI — AI-native developer framework. Scaffold, lint, scan, ship.",
+  "keywords": [
+    "forge",
+    "scaffold",
+    "cli",
+    "ai",
+    "developer-tools",
+    "devex"
+  ],
+  "homepage": "https://forgeframework.dev",
+  "bugs": {
+    "url": "https://github.com/teragrid/forge/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/teragrid/forge.git",
+    "directory": "packages/cli"
+  },
+  "license": "Apache-2.0",
+  "bin": {
+    "forge": "bin/forge.js"
+  },
+  "scripts": {
+    "postinstall": "node bin/forge.js --version 2>/dev/null || true"
+  },
+  "files": [
+    "bin/forge.js",
+    "README.md"
+  ],
+  "optionalDependencies": {
+    "@forgeone/cli-linux-x64": "1.0.0",
+    "@forgeone/cli-linux-arm64": "1.0.0",
+    "@forgeone/cli-darwin-x64": "1.0.0",
+    "@forgeone/cli-darwin-arm64": "1.0.0",
+    "@forgeone/cli-win32-x64": "1.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}