@groundfloorcloud/cli 0.1.5 → 0.1.6

package/README.md

@@ -23,7 +23,12 @@ Without a global install:
 npx @groundfloorcloud/cli login
 ```
 
-Requires Node.js 20 or later. `gf login` signs in to production
+Requires Node.js 20 or later. `gf` checks npm at most once a day and prints a
+one-line upgrade notice when a newer `@groundfloorcloud/cli` exists. Unknown
+subcommands include the installed vs latest version so a stale binary is not
+read as wrong docs.
+
+`gf login` signs in to production
 (`https://platform.groundfloor.cloud`). Use `--dev` or `--stage` for
 other cells; later commands reuse that session.
 

package/dist/index.js

@@ -2,6 +2,7 @@
 
 // src/index.ts
 import { Command } from "commander";
+import path9 from "path";
 
 // src/auth/store.ts
 import { promises as fs } from "fs";
@@ -62,6 +63,7 @@ async function updateConfig(patch) {
   await writeConfig(next);
   return next;
 }
+var paths = { CONFIG_DIR, AUTH_FILE, CONFIG_FILE };
 
 // src/auth/config.ts
 var CELLS = {
@@ -533,9 +535,9 @@ async function parseError(res) {
   }
   return `${res.status} ${detail}`;
 }
-async function cpGet(apiUrl, path8) {
+async function cpGet(apiUrl, path10) {
   const token = await getValidAccessToken();
-  const res = await fetch(`${apiUrl}${path8}`, {
+  const res = await fetch(`${apiUrl}${path10}`, {
     headers: {
       Authorization: `Bearer ${token}`,
       Accept: "application/json"
@@ -546,9 +548,9 @@ async function cpGet(apiUrl, path8) {
   }
   return await res.json();
 }
-async function cpPostJson(apiUrl, path8, body) {
+async function cpPostJson(apiUrl, path10, body) {
   const token = await getValidAccessToken();
-  const res = await fetch(`${apiUrl}${path8}`, {
+  const res = await fetch(`${apiUrl}${path10}`, {
     method: "POST",
     headers: {
       Authorization: `Bearer ${token}`,
@@ -562,9 +564,9 @@ async function cpPostJson(apiUrl, path8, body) {
   }
   return await res.json();
 }
-async function cpDelete(apiUrl, path8) {
+async function cpDelete(apiUrl, path10) {
   const token = await getValidAccessToken();
-  const res = await fetch(`${apiUrl}${path8}`, {
+  const res = await fetch(`${apiUrl}${path10}`, {
     method: "DELETE",
     headers: { Authorization: `Bearer ${token}`, Accept: "application/json" }
   });
@@ -572,9 +574,9 @@ async function cpDelete(apiUrl, path8) {
     throw new CpError(res.status, await parseError(res));
   }
 }
-async function cpPutJson(apiUrl, path8, body) {
+async function cpPutJson(apiUrl, path10, body) {
   const token = await getValidAccessToken();
-  const res = await fetch(`${apiUrl}${path8}`, {
+  const res = await fetch(`${apiUrl}${path10}`, {
     method: "PUT",
     headers: {
       Authorization: `Bearer ${token}`,
@@ -588,9 +590,9 @@ async function cpPutJson(apiUrl, path8, body) {
   }
   return await res.json();
 }
-async function cpPatchJson(apiUrl, path8, body) {
+async function cpPatchJson(apiUrl, path10, body) {
   const token = await getValidAccessToken();
-  const res = await fetch(`${apiUrl}${path8}`, {
+  const res = await fetch(`${apiUrl}${path10}`, {
     method: "PATCH",
     headers: {
       Authorization: `Bearer ${token}`,
@@ -604,9 +606,9 @@ async function cpPatchJson(apiUrl, path8, body) {
   }
   return await res.json();
 }
-async function cpPutBytes(apiUrl, path8, body, contentType) {
+async function cpPutBytes(apiUrl, path10, body, contentType) {
   const token = await getValidAccessToken();
-  const res = await fetch(`${apiUrl}${path8}`, {
+  const res = await fetch(`${apiUrl}${path10}`, {
     method: "PUT",
     headers: {
       Authorization: `Bearer ${token}`,
@@ -2004,21 +2006,21 @@ function chooseRemoteEntry(relpaths) {
   })[0];
 }
 function flattenFederatedBundlePlan(relpaths) {
-  const paths = relpaths.map(normalizeZipEntryName).filter((name) => name && !name.endsWith("/") && !name.split("/").includes(".."));
-  const pathset = new Set(paths);
+  const paths2 = relpaths.map(normalizeZipEntryName).filter((name) => name && !name.endsWith("/") && !name.split("/").includes(".."));
+  const pathset = new Set(paths2);
   const entry = chooseRemoteEntry([...pathset]);
   if (!entry) return {};
   const promoteDirs = /* @__PURE__ */ new Set();
   const entryDir = parentDir(entry);
   if (entryDir) promoteDirs.add(entryDir);
-  for (const path8 of pathset) {
-    const parent = parentDir(path8);
+  for (const path10 of pathset) {
+    const parent = parentDir(path10);
     if (parent === "assets" || parent.endsWith("/assets") && parent.split("/").length - 1 < 2) {
       promoteDirs.add(parent);
     }
   }
   const destToSrc = {};
-  for (const src of paths) {
+  for (const src of paths2) {
     const parent = parentDir(src);
     if (!promoteDirs.has(parent)) continue;
     const dest = basename(src);
@@ -2393,6 +2395,12 @@ import { promises as fs7 } from "fs";
 import os3 from "os";
 import path7 from "path";
 import AdmZip4 from "adm-zip";
+
+// src/version.ts
+var GF_VERSION = "0.1.6";
+var GF_NPM_PACKAGE = "@groundfloorcloud/cli";
+
+// src/commands/apps-init.ts
 var MAX_KIT_BYTES = 8 * 1024 * 1024;
 function slugify3(input) {
   const slug = input.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
@@ -2465,7 +2473,7 @@ async function downloadKit(url) {
     res = await fetch(url, {
       redirect: "follow",
       signal: AbortSignal.timeout(6e4),
-      headers: { "User-Agent": "groundfloor-cli/0.1.1" }
+      headers: { "User-Agent": `groundfloor-cli/${GF_VERSION}` }
     });
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
@@ -2567,6 +2575,9 @@ async function appsInitCommand(opts) {
   process.stdout.write(
     "Do not wrap src/App.tsx in BrowserRouter (DevShell already has one).\n"
   );
+  process.stdout.write(
+    "MCP: .mcp.json is included (npx @groundfloorcloud/mcp). Cursor on macOS: copy .cursor/mcp.json.example.\n"
+  );
   process.stdout.write("Next:\n");
   for (const step of result.next) {
     process.stdout.write(`  ${step}
@@ -2609,6 +2620,81 @@ async function dataplaneProvisionCommand(opts) {
   }
 }
 
+// src/update-check.ts
+import { promises as fs8 } from "fs";
+import path8 from "path";
+var UPDATE_TTL_MS = 24 * 60 * 60 * 1e3;
+function isNewer(latest, current) {
+  const a = latest.split(".").map((n) => Number.parseInt(n, 10) || 0);
+  const b = current.split(".").map((n) => Number.parseInt(n, 10) || 0);
+  const len = Math.max(a.length, b.length);
+  for (let i = 0; i < len; i += 1) {
+    const lv = a[i] ?? 0;
+    const cv = b[i] ?? 0;
+    if (lv > cv) return true;
+    if (lv < cv) return false;
+  }
+  return false;
+}
+function upgradeNotice(current, latest) {
+  return `gf ${latest} is available (you have ${current}). npm i -g ${GF_NPM_PACKAGE}@latest`;
+}
+function unknownCommandNotice(command, current, latest) {
+  if (latest && isNewer(latest, current)) {
+    return `unknown command '${command}' \u2014 your gf is ${current}, latest is ${latest}. npm i -g ${GF_NPM_PACKAGE}@latest`;
+  }
+  return `unknown command '${command}' \u2014 your gf is ${current}`;
+}
+function parseUnknownCommandName(message) {
+  const match = message.match(/unknown command ['"]([^'"]+)['"]/i);
+  return match?.[1] ?? "that";
+}
+async function fetchNpmLatest(pkg = GF_NPM_PACKAGE) {
+  try {
+    const res = await fetch(`https://registry.npmjs.org/${pkg}/latest`, {
+      headers: { Accept: "application/json" },
+      signal: AbortSignal.timeout(1500)
+    });
+    if (!res.ok) return null;
+    const body = await res.json();
+    return typeof body.version === "string" && body.version.trim() ? body.version.trim() : null;
+  } catch {
+    return null;
+  }
+}
+async function readUpdateCache(file) {
+  try {
+    const raw = await fs8.readFile(file, "utf8");
+    const parsed = JSON.parse(raw);
+    if (typeof parsed.checkedAt !== "number" || typeof parsed.latest !== "string" || !parsed.latest.trim()) {
+      return null;
+    }
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+async function writeUpdateCache(file, cache) {
+  await fs8.mkdir(path8.dirname(file), { recursive: true, mode: 448 });
+  await fs8.writeFile(file, `${JSON.stringify(cache)}
+`, { mode: 384 });
+}
+async function resolveLatest(opts) {
+  const now = opts.now ?? Date.now();
+  const ttl = opts.ttlMs ?? UPDATE_TTL_MS;
+  const cached = await readUpdateCache(opts.cacheFile);
+  if (cached && now - cached.checkedAt < ttl) {
+    return cached.latest;
+  }
+  const fetchLatest = opts.fetchLatest ?? fetchNpmLatest;
+  const latest = await fetchLatest();
+  if (latest) {
+    await writeUpdateCache(opts.cacheFile, { checkedAt: now, latest });
+    return latest;
+  }
+  return cached?.latest ?? null;
+}
+
 // src/index.ts
 function collect(value, previous) {
   return previous.concat([value]);
@@ -2624,7 +2710,7 @@ function run(fn) {
 var program = new Command();
 program.name("gf").description(
   "Groundfloor CLI \u2014 sign in, deploy coderunners, publish Shell apps, and manage workspace resources."
-).version("0.1.5");
+).version(GF_VERSION);
 program.command("login").description(
   "Log in via the browser (production by default; --dev / --stage for other cells)"
 ).option("--dev", "Sign in to Groundfloor dev").option("--stage", "Sign in to Groundfloor stage").option(
@@ -2759,7 +2845,40 @@ program.command("deploy").description(
   "--app-id <id>",
   "Bind newly created coderunner as a helper of this App (optional)"
 ).option("--cpu <cpu>", "CPU request, e.g. 250m").option("--memory <memory>", "Memory request, e.g. 256Mi").option("-e, --env <KEY=VALUE>", "Environment variable (repeatable)", collect, []).option("-m, --message <text>", "Version description").option("--skip-deploy", "Upload a new version but do not deploy it").action((opts) => run(() => deployCommand(opts)));
-program.parseAsync(process.argv).catch((err) => {
+function wireUnknownCommands(root, current, latest) {
+  const walk = (cmd) => {
+    if (cmd.commands.length === 0) return;
+    cmd.exitOverride((err) => {
+      if (err.code === "commander.unknownCommand") {
+        process.stderr.write(
+          `${unknownCommandNotice(parseUnknownCommandName(err.message), current, latest)}
+`
+        );
+        process.exit(1);
+      }
+      throw err;
+    });
+    for (const child of cmd.commands) walk(child);
+  };
+  walk(root);
+}
+async function notifyUpgrade() {
+  if (process.env.GF_SKIP_UPDATE_CHECK === "1") return null;
+  const latest = await resolveLatest({
+    cacheFile: path9.join(paths.CONFIG_DIR, "update-check.json")
+  });
+  if (latest && isNewer(latest, GF_VERSION)) {
+    process.stderr.write(`${upgradeNotice(GF_VERSION, latest)}
+`);
+  }
+  return latest;
+}
+async function main() {
+  const latest = await notifyUpgrade();
+  wireUnknownCommands(program, GF_VERSION, latest);
+  await program.parseAsync(process.argv);
+}
+main().catch((err) => {
   const message = err instanceof Error ? err.message : String(err);
   process.stderr.write(`Error: ${message}
 `);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@groundfloorcloud/cli",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Groundfloor gf CLI — sign in, deploy coderunners, publish Shell apps, and manage secrets, files, and Dataplane.",
   "type": "module",
   "bin": {