graphcoder 0.0.0 → 0.0.106

package/README.md

@@ -1,3 +1,29 @@
 # graphcoder
 
-Placeholder package reserving the `graphcoder` name. The real CLI release is coming soon.
+The Graphcoder CLI.
+
+## Install
+
+```sh
+bun add -g graphcoder
+# or
+npm install -g graphcoder
+# or
+pnpm add -g graphcoder
+```
+
+Pin a specific version:
+
+```sh
+bun add -g graphcoder@0.0.107
+```
+
+The platform binary ships in a per-machine package (`graphcoder-darwin-arm64`,
+`graphcoder-linux-x64`, …) selected automatically via `os`/`cpu`, so only the
+binary for your platform is downloaded.
+
+## Run
+
+```sh
+graphcoder doctor
+```

package/bin/graphcoder.js

@@ -1,4 +1,122 @@
 #!/usr/bin/env node
-// Placeholder release. The real Graphcoder CLI is not published yet.
-console.error("graphcoder: this is a placeholder release. A real version is coming soon.");
-process.exit(1);
+"use strict";
+
+// Umbrella launcher for the `graphcoder` npm package.
+//
+// The real binary ships in a per-platform package (graphcoder-<target>) listed
+// under optionalDependencies. The package manager installs only the one whose
+// "os"/"cpu" match the current machine; this shim resolves it and execs the
+// bundled SEA binary, passing through argv/stdio/exit code and signals.
+//
+// Authored as a plain-CJS template under lib/install/npm/. The release pipeline
+// stamps the matching version into package.json's version + optionalDependencies
+// before publishing. Keep this file dependency-free: it runs from the published
+// package with nothing but Node's stdlib available.
+
+const { spawn } = require("node:child_process");
+const path = require("node:path");
+
+// Maps Node's process.platform/process.arch to a Graphcoder release target id.
+// The target ids are also the per-platform package name suffixes
+// (graphcoder-<target>) and match RELEASE_TARGET_IDS in @graphcoder/install.
+function detectTarget(platform, arch) {
+	const normalizedArch = arch === "arm64" ? "arm64" : "x64";
+	if (platform === "darwin") return normalizedArch === "arm64" ? "darwin-arm64" : "darwin-x64";
+	if (platform === "linux") return normalizedArch === "arm64" ? "linux-arm64" : "linux-x64";
+	// Windows on arm64 is not a published target yet.
+	if (platform === "win32") return normalizedArch === "arm64" ? null : "windows-x64";
+	return null;
+}
+
+function exeNameForPlatform(platform) {
+	return platform === "win32" ? "graphcoder.exe" : "graphcoder";
+}
+
+// Resolves the absolute path to the platform binary, or returns a structured
+// reason when it can't (so callers can print actionable guidance). Exported for
+// tests; see lib/install/npm/graphcoder.test.ts.
+function resolveBinary(opts) {
+	const platform = opts.platform;
+	const arch = opts.arch;
+	const requireResolve = opts.requireResolve;
+
+	const target = detectTarget(platform, arch);
+	if (target === null) {
+		return { ok: false, reason: "unsupported", platform, arch };
+	}
+
+	const pkg = "graphcoder-" + target;
+	let pkgJsonPath;
+	try {
+		pkgJsonPath = requireResolve(pkg + "/package.json");
+	} catch (_err) {
+		return { ok: false, reason: "missing", pkg, target };
+	}
+	const binaryPath = path.join(path.dirname(pkgJsonPath), exeNameForPlatform(platform));
+	return { ok: true, pkg, target, binaryPath };
+}
+
+function fail(message) {
+	process.stderr.write("graphcoder: " + message + "\n");
+	process.exit(1);
+}
+
+function main() {
+	const resolution = resolveBinary({
+		platform: process.platform,
+		arch: process.arch,
+		requireResolve: require.resolve,
+	});
+
+	if (!resolution.ok) {
+		if (resolution.reason === "unsupported") {
+			fail(
+				"unsupported platform " +
+					resolution.platform +
+					"-" +
+					resolution.arch +
+					". Supported: darwin-arm64, darwin-x64, linux-x64, linux-arm64, windows-x64.",
+			);
+		}
+		fail(
+			"the platform package '" +
+				resolution.pkg +
+				"' is not installed.\n" +
+				"This usually means optional dependencies were skipped during install.\n" +
+				"Reinstall without --no-optional (e.g. `bun add -g graphcoder` or `npm i -g graphcoder`).",
+		);
+		return;
+	}
+
+	const child = spawn(resolution.binaryPath, process.argv.slice(2), { stdio: "inherit" });
+
+	child.on("error", (err) => {
+		fail("failed to launch binary at " + resolution.binaryPath + ": " + err.message);
+	});
+
+	// Forward termination signals so Ctrl-C and friends reach the real process.
+	const forward = (signal) => {
+		try {
+			child.kill(signal);
+		} catch (_err) {
+			// child may have already exited; ignore.
+		}
+	};
+	process.on("SIGINT", () => forward("SIGINT"));
+	process.on("SIGTERM", () => forward("SIGTERM"));
+
+	child.on("exit", (code, signal) => {
+		if (signal) {
+			// Re-raise the signal so our exit status reflects how the child died.
+			process.kill(process.pid, signal);
+			return;
+		}
+		process.exit(code === null ? 1 : code);
+	});
+}
+
+module.exports = { detectTarget, exeNameForPlatform, resolveBinary };
+
+if (require.main === module) {
+	main();
+}

package/package.json

@@ -1,13 +1,21 @@
 {
   "name": "graphcoder",
-  "version": "0.0.0",
-  "description": "Graphcoder CLI (placeholder — reserving the name; real release coming soon).",
+  "version": "0.0.106",
+  "description": "Graphcoder CLI — install with your package manager (bun add -g graphcoder).",
   "license": "UNLICENSED",
+  "homepage": "https://graphcoder.ai",
   "bin": {
     "graphcoder": "bin/graphcoder.js"
   },
   "files": [
     "bin",
     "README.md"
-  ]
+  ],
+  "optionalDependencies": {
+    "graphcoder-darwin-arm64": "0.0.106",
+    "graphcoder-darwin-x64": "0.0.106",
+    "graphcoder-linux-x64": "0.0.106",
+    "graphcoder-linux-arm64": "0.0.106",
+    "graphcoder-windows-x64": "0.0.106"
+  }
 }