@knowsuchagency/fulcrum 1.12.1 → 1.13.0

package/bin/fulcrum.js

@@ -935,10 +935,12 @@ var init_errors = __esm(() => {
   ExitCodes = {
     SUCCESS: 0,
     ERROR: 1,
+    GENERAL_ERROR: 1,
     INVALID_ARGS: 2,
     SERVER_UNREACHABLE: 3,
     NOT_FOUND: 4,
-    VALIDATION_ERROR: 5
+    VALIDATION_ERROR: 5,
+    NETWORK_ERROR: 6
   };
   CliError = class CliError extends Error {
     code;
@@ -47082,7 +47084,7 @@ var marketplace_default = `{
       "name": "fulcrum",
       "source": "./",
       "description": "Task orchestration for Claude Code",
-      "version": "1.12.1",
+      "version": "1.13.0",
       "skills": [
         "./skills/fulcrum"
       ],
@@ -47908,7 +47910,7 @@ var notifyCommand = defineCommand({
 });
 
 // cli/src/commands/up.ts
-import { spawn } from "child_process";
+import { spawn as spawn2 } from "child_process";
 import { existsSync as existsSync5 } from "fs";
 import { dirname as dirname3, join as join5 } from "path";
 import { fileURLToPath } from "url";
@@ -48191,11 +48193,86 @@ function installUv() {
     return false;
   return installDependency(dep);
 }
+
+// cli/src/commands/update.ts
+import { spawn, spawnSync as spawnSync3 } from "child_process";
+init_errors();
+
+// shared/semver.ts
+function parseSemver(version) {
+  const cleaned = version.trim().replace(/^v/, "");
+  if (cleaned.length === 0)
+    return null;
+  const [mainAndPre] = cleaned.split("+", 1);
+  const [main, preReleaseRaw] = mainAndPre.split("-", 2);
+  const parts = main.split(".");
+  if (parts.length > 3 || parts.length === 0)
+    return null;
+  if (parts.some((part) => part.length > 1 && part.startsWith("0")))
+    return null;
+  const major = Number(parts[0]);
+  const minor = Number(parts[1] ?? "0");
+  const patch = Number(parts[2] ?? "0");
+  if (!Number.isFinite(major) || !Number.isFinite(minor) || !Number.isFinite(patch))
+    return null;
+  if (major < 0 || minor < 0 || patch < 0)
+    return null;
+  if (preReleaseRaw) {
+    const preReleaseParts = preReleaseRaw.split(".");
+    if (preReleaseParts.some((part) => /^\d+$/.test(part) && part.length > 1 && part.startsWith("0"))) {
+      return null;
+    }
+  }
+  const preRelease = preReleaseRaw ? preReleaseRaw.split(".").map((part) => /^\d+$/.test(part) ? Number(part) : part) : [];
+  return { major, minor, patch, preRelease };
+}
+function compareIdentifiers(a2, b2) {
+  if (typeof a2 === "number" && typeof b2 === "number")
+    return a2 - b2;
+  if (typeof a2 === "number")
+    return -1;
+  if (typeof b2 === "number")
+    return 1;
+  return a2.localeCompare(b2);
+}
+function compareVersions(v1, v2) {
+  const parsed1 = parseSemver(v1);
+  const parsed2 = parseSemver(v2);
+  if (!parsed1 || !parsed2)
+    return 0;
+  if (parsed1.major !== parsed2.major)
+    return parsed1.major - parsed2.major;
+  if (parsed1.minor !== parsed2.minor)
+    return parsed1.minor - parsed2.minor;
+  if (parsed1.patch !== parsed2.patch)
+    return parsed1.patch - parsed2.patch;
+  const pre1 = parsed1.preRelease;
+  const pre2 = parsed2.preRelease;
+  if (pre1.length === 0 && pre2.length === 0)
+    return 0;
+  if (pre1.length === 0)
+    return 1;
+  if (pre2.length === 0)
+    return -1;
+  const maxLen = Math.max(pre1.length, pre2.length);
+  for (let i2 = 0;i2 < maxLen; i2++) {
+    const id1 = pre1[i2];
+    const id2 = pre2[i2];
+    if (id1 === undefined)
+      return -1;
+    if (id2 === undefined)
+      return 1;
+    const diff = compareIdentifiers(id1, id2);
+    if (diff !== 0)
+      return diff;
+  }
+  return 0;
+}
 // package.json
 var package_default = {
   name: "@knowsuchagency/fulcrum",
   private: true,
-  version: "1.12.1",
+  version: "1.13.0",
   description: "Harness Attention. Orchestrate Agents. Ship.",
   license: "PolyForm-Perimeter-1.0.0",
   type: "module",
@@ -48286,6 +48363,168 @@ var package_default = {
   }
 };
 
+// cli/src/commands/update.ts
+var GITHUB_REPO = "knowsuchagency/fulcrum";
+var NPM_PACKAGE = "@knowsuchagency/fulcrum";
+async function fetchLatestVersionFromNpm() {
+  try {
+    const response = await fetch(`https://registry.npmjs.org/${NPM_PACKAGE}/latest`, {
+      headers: { Accept: "application/json" }
+    });
+    if (!response.ok)
+      return null;
+    const data = await response.json();
+    return data.version || null;
+  } catch {
+    return null;
+  }
+}
+async function checkForUpdates() {
+  const currentVersion = package_default.version;
+  const latestVersion = await fetchLatestVersionFromNpm();
+  let updateAvailable = false;
+  if (latestVersion) {
+    updateAvailable = compareVersions(latestVersion, currentVersion) > 0;
+  }
+  return { currentVersion, latestVersion, updateAvailable };
+}
+function isBunAvailable() {
+  try {
+    const result = spawnSync3("bun", ["--version"], { stdio: "pipe" });
+    return result.status === 0;
+  } catch {
+    return false;
+  }
+}
+function getPackageRunner() {
+  if (isBunAvailable()) {
+    return { command: "bunx", execCommand: "bunx" };
+  }
+  return { command: "npx", execCommand: "npx" };
+}
+function stopServer() {
+  const { execCommand } = getPackageRunner();
+  console.log("Stopping current server...");
+  const result = spawnSync3(execCommand, [`${NPM_PACKAGE}@latest`, "down"], {
+    stdio: "inherit",
+    shell: true
+  });
+  if (result.status === 0) {
+    console.log("Server stopped.");
+  } else {
+    console.log("Server was not running (or already stopped).");
+  }
+}
+function installLatestVersion() {
+  const { execCommand, command } = getPackageRunner();
+  console.log(`
+Installing latest version via ${command}...`);
+  const args = command === "bunx" ? ["--bun", `${NPM_PACKAGE}@latest`, "--version"] : ["--yes", "--ignore-scripts", `${NPM_PACKAGE}@latest`, "--version"];
+  const result = spawnSync3(execCommand, args, {
+    stdio: "inherit",
+    shell: true
+  });
+  if (result.status === 0) {
+    console.log("Latest version installed.");
+    return true;
+  }
+  console.error("Failed to install latest version.");
+  return false;
+}
+function startServer() {
+  return new Promise((resolve) => {
+    const { command, execCommand } = getPackageRunner();
+    const args = [`${NPM_PACKAGE}@latest`, "up"];
+    console.log(`
+Starting server: ${command} ${args.join(" ")}
+`);
+    const child = spawn(execCommand, args, {
+      stdio: "inherit",
+      shell: true
+    });
+    child.on("close", (code) => {
+      resolve(code ?? 0);
+    });
+    child.on("error", (err) => {
+      console.error("Failed to start server:", err.message);
+      resolve(1);
+    });
+  });
+}
+async function runUpdate() {
+  stopServer();
+  const installed = installLatestVersion();
+  if (!installed) {
+    console.error(`
+Update failed during installation. Your previous version may still work.`);
+    console.log("Try running: fulcrum up");
+    return 1;
+  }
+  console.log(`
+Starting updated server...`);
+  return await startServer();
+}
+async function handleUpdateCommand(flags) {
+  const checkOnly = flags.check === "true";
+  const { command } = getPackageRunner();
+  if (isJsonOutput()) {
+    const result = await checkForUpdates();
+    output({
+      ...result,
+      updateCommand: "fulcrum update",
+      releaseUrl: `https://github.com/${GITHUB_REPO}/releases/latest`
+    });
+    return;
+  }
+  console.log("Checking for updates...");
+  const { currentVersion, latestVersion, updateAvailable } = await checkForUpdates();
+  if (!latestVersion) {
+    throw new CliError("NETWORK_ERROR", "Could not check for updates. Please check your internet connection.", ExitCodes.NETWORK_ERROR);
+  }
+  console.log(`Current version: ${currentVersion}`);
+  console.log(`Latest version:  ${latestVersion}`);
+  if (!updateAvailable) {
+    console.log(`
+\u2713 You are running the latest version.`);
+    return;
+  }
+  console.log(`
+\u2191 Update available: ${currentVersion} \u2192 ${latestVersion}`);
+  if (checkOnly) {
+    console.log(`
+To update, run: fulcrum update`);
+    console.log(`Or manually: ${command} ${NPM_PACKAGE}@latest up`);
+    return;
+  }
+  console.log(`
+Updating Fulcrum...`);
+  console.log(`This will stop the current server, install the update, and restart.
+`);
+  const exitCode = await runUpdate();
+  if (exitCode !== 0) {
+    throw new CliError("GENERAL_ERROR", "Update failed", ExitCodes.GENERAL_ERROR);
+  }
+  console.log(`
+\u2713 Fulcrum has been updated and restarted.`);
+}
+var updateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: "Check for updates and update Fulcrum to the latest version"
+  },
+  args: {
+    ...globalArgs,
+    check: {
+      type: "boolean",
+      description: "Only check for updates, do not install"
+    }
+  },
+  async run({ args }) {
+    setupJsonOutput(args);
+    await handleUpdateCommand(toFlags(args));
+  }
+});
+
 // cli/src/commands/up.ts
 function getPackageRoot() {
   const currentFile = fileURLToPath(import.meta.url);
@@ -48300,6 +48539,24 @@ function getPackageRoot() {
 }
 async function handleUpCommand(flags) {
   const autoYes = flags.yes === "true" || flags.y === "true";
+  const shouldUpdate = flags.update === "true";
+  if (shouldUpdate) {
+    console.error("Checking for updates...");
+    const { currentVersion, latestVersion, updateAvailable } = await checkForUpdates();
+    if (latestVersion && updateAvailable) {
+      console.error(`Update available: ${currentVersion} \u2192 ${latestVersion}`);
+      console.error("Installing update...");
+      const installed = installLatestVersion();
+      if (!installed) {
+        throw new CliError("UPDATE_FAILED", "Failed to install update", ExitCodes.ERROR);
+      }
+      console.error("Update installed successfully.");
+    } else if (latestVersion) {
+      console.error(`Already on latest version: ${currentVersion}`);
+    } else {
+      console.error("Could not check for updates, continuing with current version.");
+    }
+  }
   if (needsViboraMigration()) {
     const viboraDir = getLegacyViboraDir();
     console.error(`
@@ -48402,7 +48659,7 @@ Found existing Vibora data at ${viboraDir}`);
   const fulcrumDir = getFulcrumDir();
   const debug = flags.debug === "true";
   console.error(`Starting Fulcrum server${debug ? " (debug mode)" : ""}...`);
-  const serverProc = spawn("bun", [serverPath], {
+  const serverProc = spawn2("bun", [serverPath], {
     detached: true,
     stdio: "ignore",
     env: {
@@ -48467,7 +48724,8 @@ var upCommand = defineCommand({
   args: {
     ...globalArgs,
     yes: { type: "boolean", alias: "y", description: "Auto-answer yes to prompts" },
-    host: { type: "boolean", description: "Bind to 0.0.0.0 (expose to network)" }
+    host: { type: "boolean", description: "Bind to 0.0.0.0 (expose to network)" },
+    update: { type: "boolean", description: "Check for and install updates before starting" }
   },
   async run({ args }) {
     setupJsonOutput(args);
@@ -48829,6 +49087,7 @@ var main = defineCommand({
     doctor: doctorCommand,
     dev: devCommand,
     mcp: mcpCommand,
+    update: updateCommand,
     "migrate-from-vibora": migrateFromViboraCommand
   }
 });