@ggcode-cli/ggcode 1.0.7 → 1.1.0

package/README.md

@@ -0,0 +1,62 @@
+# @ggcode-cli/ggcode
+
+`@ggcode-cli/ggcode` is a thin npm wrapper for the `ggcode` terminal agent.
+
+It does not bundle the native binary in the package. Instead, the wrapper downloads the latest
+`ggcode` GitHub Release for your platform on install or first run, caches it locally, and then
+launches it for you.
+
+## Install
+
+For normal CLI usage, install it globally:
+
+```bash
+npm install -g @ggcode-cli/ggcode
+```
+
+Then run:
+
+```bash
+ggcode
+```
+
+If you install it locally, use `npx ggcode` or `./node_modules/.bin/ggcode`.
+
+## What it does
+
+- Detects your platform and architecture
+- Downloads the latest matching `ggcode` binary from GitHub Releases
+- Verifies the downloaded archive with `checksums.txt`
+- Extracts and caches the binary for reuse
+
+## Pin a specific ggcode release
+
+By default, the wrapper always resolves the latest `ggcode` release.
+
+If you need to pin a specific release, set `GGCODE_INSTALL_VERSION`:
+
+```bash
+GGCODE_INSTALL_VERSION=vX.Y.Z ggcode
+```
+
+or:
+
+```bash
+GGCODE_INSTALL_VERSION=X.Y.Z ggcode
+```
+
+## Supported platforms
+
+- macOS
+- Linux
+- Windows
+
+Supported architectures:
+
+- x86_64 / amd64
+- arm64
+
+## Project links
+
+- Repository: https://github.com/topcheer/ggcode
+- Issues: https://github.com/topcheer/ggcode/issues

package/bin/ggcode.js

@@ -1,11 +1,10 @@
 #!/usr/bin/env node
 
 const { spawnSync } = require("child_process");
-const pkg = require("../package.json");
 const { ensureInstalled } = require("../lib/install");
 
 async function main() {
-  const binary = await ensureInstalled(process.env.GGCODE_INSTALL_VERSION, pkg.version, true);
+  const binary = await ensureInstalled(process.env.GGCODE_INSTALL_VERSION, true);
   const result = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
   if (result.error) {
     throw result.error;

package/lib/install.js

@@ -10,9 +10,8 @@ const REPO = "ggcode";
 const BINARY = process.platform === "win32" ? "ggcode.exe" : "ggcode";
 
 function normalizeVersion(version) {
-  const envVersion = process.env.GGCODE_INSTALL_VERSION;
-  const selected = (envVersion || version || "").trim();
-  if (!selected || selected === "latest" || selected.startsWith("0.0.0-")) {
+  const selected = (version || "").trim();
+  if (!selected || selected === "latest") {
     return "latest";
   }
   return selected.startsWith("v") ? selected : `v${selected}`;
@@ -66,8 +65,9 @@ function binaryPath(version, target) {
   return path.join(installRoot(version, target), target.binaryName);
 }
 
-async function ensureInstalled(version, packageVersion, quiet) {
-  const resolvedVersion = normalizeVersion(version || packageVersion);
+async function ensureInstalled(version, quiet) {
+  const requestedVersion = normalizeVersion(version);
+  const resolvedVersion = await resolveReleaseVersion(requestedVersion);
   const target = resolveTarget();
   const dest = binaryPath(resolvedVersion, target);
   if (fs.existsSync(dest)) {
@@ -106,6 +106,19 @@ async function ensureInstalled(version, packageVersion, quiet) {
   return dest;
 }
 
+async function resolveReleaseVersion(version) {
+  if (version !== "latest") {
+    return version;
+  }
+
+  const latestURL = await resolveFinalURL(`https://github.com/${OWNER}/${REPO}/releases/latest`);
+  const match = latestURL.match(/\/releases\/tag\/([^/?#]+)/);
+  if (!match) {
+    throw new Error(`Could not resolve latest ggcode release from ${latestURL}`);
+  }
+  return decodeURIComponent(match[1]);
+}
+
 function verifyChecksum(assetName, archive, checksumsText) {
   const lines = checksumsText.split(/\r?\n/);
   let expected = null;
@@ -179,8 +192,32 @@ function downloadBuffer(url) {
   });
 }
 
+function resolveFinalURL(url) {
+  return new Promise((resolve, reject) => {
+    const get = (target) => {
+      https
+        .get(target, (res) => {
+          if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+            res.resume();
+            get(new URL(res.headers.location, target).toString());
+            return;
+          }
+          if (res.statusCode !== 200) {
+            reject(new Error(`${target} returned ${res.statusCode}`));
+            return;
+          }
+          res.resume();
+          resolve(target);
+        })
+        .on("error", reject);
+    };
+    get(url);
+  });
+}
+
 module.exports = {
   ensureInstalled,
   normalizeVersion,
+  resolveReleaseVersion,
   resolveTarget,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggcode-cli/ggcode",
-  "version": "1.0.7",
+  "version": "1.1.0",
   "description": "Thin npm wrapper that installs the ggcode GitHub Release binary",
   "license": "MIT",
   "repository": {

package/scripts/postinstall.js

@@ -1,9 +1,8 @@
 #!/usr/bin/env node
 
-const pkg = require("../package.json");
 const { ensureInstalled } = require("../lib/install");
 
-ensureInstalled(process.env.GGCODE_INSTALL_VERSION, pkg.version, false).catch((err) => {
+ensureInstalled(process.env.GGCODE_INSTALL_VERSION, false).catch((err) => {
   console.warn(`ggcode postinstall warning: ${err.message}`);
   console.warn("The wrapper will try again on first run.");
 });