@headways/cli 1.0.0 → 1.1.0

package/dist/index.js

@@ -18,52 +18,6 @@ import {
 import "dotenv/config";
 import { program } from "commander";
 
-// package.json
-var package_default = {
-  name: "@headways/cli",
-  version: "1.0.0",
-  type: "module",
-  description: "Headways CLI \u2014 authoring, sync, and runtime SDK",
-  license: "MIT",
-  files: [
-    "dist",
-    "LICENSE",
-    "README.md"
-  ],
-  bin: {
-    headways: "./dist/index.js"
-  },
-  publishConfig: {
-    access: "public"
-  },
-  scripts: {
-    build: "tsup",
-    dev: "tsx src/index.ts",
-    test: "vitest run",
-    "test:unit": "vitest run",
-    "type-check": "tsc -p tsconfig.json --noEmit",
-    prepublishOnly: "pnpm build"
-  },
-  dependencies: {
-    "@headways/db": "workspace:*",
-    "@modelcontextprotocol/sdk": "^1.15.0",
-    chalk: "^5.3.0",
-    commander: "^12.1.0",
-    dotenv: "^16.4.7",
-    "node-fetch": "^3.3.2",
-    yaml: "^2.5.1",
-    zod: "^3.25.28"
-  },
-  devDependencies: {
-    "@headways/config": "workspace:*",
-    "@types/node": "^22.16.5",
-    tsup: "^8.5.1",
-    tsx: "^4.21.0",
-    typescript: "^5.8.3",
-    vitest: "^3.2.4"
-  }
-};
-
 // src/commands/auth.ts
 import "commander";
 import * as http from "http";
@@ -366,6 +320,7 @@ import "commander";
 import * as fs2 from "fs/promises";
 import * as path2 from "path";
 import { watch, existsSync } from "fs";
+import * as YAML from "yaml";
 var RESERVED_TOP_LEVEL = /* @__PURE__ */ new Set([
   "SKILL.md",
   "headways.yaml",
@@ -426,12 +381,32 @@ async function readSkillDir(dir) {
     const items = parseConnectionsYaml(connectionsYaml);
     if (items.length > 0) connections = items;
   }
+  let capabilities;
+  if (capabilitiesYaml) {
+    try {
+      capabilities = YAML.parse(capabilitiesYaml);
+    } catch (err) {
+      throw new Error(
+        `Failed to parse capabilities.yaml: ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+  }
+  let hooks;
+  if (hooksYaml) {
+    try {
+      hooks = YAML.parse(hooksYaml);
+    } catch (err) {
+      throw new Error(
+        `Failed to parse hooks.yaml: ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+  }
   const extraFiles = await collectExtraFiles(dir);
   return {
     body,
     headline,
-    capabilities: capabilitiesYaml ?? void 0,
-    hooks: hooksYaml ?? void 0,
+    capabilities,
+    hooks,
     connections,
     files: Object.keys(extraFiles).length > 0 ? extraFiles : void 0
   };
@@ -1115,12 +1090,125 @@ function getInstalledSkills() {
   }
 }
 
+// src/commands/upgrade.ts
+import { chmodSync, renameSync, unlinkSync as unlinkSync2, writeFileSync as writeFileSync2 } from "fs";
+import { delimiter, basename as basename3, dirname, join as join6 } from "path";
+import { existsSync as existsSync5, statSync as statSync2 } from "fs";
+import "commander";
+var GCS_BASE = "https://storage.googleapis.com/headways-releases/cli";
+var NPM_PACKAGE = "@headways/cli";
+function registerUpgradeCommand(program2) {
+  program2.command("upgrade").description("Upgrade the Headways CLI to the latest version").option("--force", "Reinstall even if already on the latest version").action(async (opts) => {
+    warnIfShadowed();
+    const mode = detectInstallMode();
+    if (mode.kind === "npm") {
+      console.log(
+        `This binary was installed via npm. Upgrade with:
+
+  npm i -g ${NPM_PACKAGE}@latest
+`
+      );
+      return;
+    }
+    if (mode.kind === "unknown") {
+      console.error(
+        `Could not determine how this CLI was installed (execPath: ${process.execPath}).
+If installed via npm:    npm i -g ${NPM_PACKAGE}@latest
+If installed via desktop: re-run the Install step from the Headways app.`
+      );
+      process.exitCode = 1;
+      return;
+    }
+    await selfUpdate(mode.binPath, opts.force ?? false);
+  });
+}
+function detectInstallMode() {
+  const exec = process.execPath;
+  const execName = basename3(exec).toLowerCase();
+  if (execName === "node" || execName === "bun" || execName.startsWith("node")) {
+    return { kind: "npm" };
+  }
+  if (execName === "headways" || execName.startsWith("headways")) {
+    return { kind: "standalone", binPath: exec };
+  }
+  return { kind: "unknown" };
+}
+function detectTriple() {
+  if (process.platform !== "darwin") return null;
+  if (process.arch === "arm64") return "aarch64-apple-darwin";
+  if (process.arch === "x64") return "x86_64-apple-darwin";
+  return null;
+}
+async function selfUpdate(binPath, force) {
+  const triple = detectTriple();
+  if (!triple) {
+    console.error(
+      `No prebuilt binary for ${process.platform}/${process.arch}. Standalone binaries are macOS-only; on other platforms use: npm i -g ${NPM_PACKAGE}@latest`
+    );
+    process.exitCode = 1;
+    return;
+  }
+  console.log(`Checking for updates\u2026 (current: ${"1.1.0"})`);
+  const latestRes = await fetch(`${GCS_BASE}/latest.txt`);
+  if (!latestRes.ok) {
+    console.error(`Failed to fetch latest version: ${latestRes.status} ${latestRes.statusText}`);
+    process.exitCode = 1;
+    return;
+  }
+  const latest = (await latestRes.text()).trim();
+  if (latest === "1.1.0" && !force) {
+    console.log(`Already on the latest version (${latest}).`);
+    return;
+  }
+  console.log(`Downloading ${latest} for ${triple}\u2026`);
+  const binRes = await fetch(`${GCS_BASE}/${latest}/headways-${triple}`);
+  if (!binRes.ok) {
+    console.error(`Failed to download binary: ${binRes.status} ${binRes.statusText}`);
+    process.exitCode = 1;
+    return;
+  }
+  const bin = Buffer.from(await binRes.arrayBuffer());
+  const tmpPath = join6(dirname(binPath), `.headways.upgrade.${process.pid}`);
+  writeFileSync2(tmpPath, bin);
+  try {
+    chmodSync(tmpPath, 493);
+    renameSync(tmpPath, binPath);
+  } catch (e) {
+    try {
+      unlinkSync2(tmpPath);
+    } catch {
+    }
+    throw e;
+  }
+  console.log(`Upgraded to ${latest} \u2192 ${binPath}`);
+}
+function warnIfShadowed() {
+  const exec = process.execPath;
+  const pathDirs = (process.env.PATH ?? "").split(delimiter).filter(Boolean);
+  const found = [];
+  for (const dir of pathDirs) {
+    const candidate = join6(dir, "headways");
+    try {
+      if (existsSync5(candidate) && statSync2(candidate).isFile()) {
+        found.push(candidate);
+      }
+    } catch {
+    }
+  }
+  if (found.length > 0 && found[0] !== exec) {
+    console.error(
+      `note: another 'headways' is earlier on PATH at ${found[0]} \u2014 running upgrade here won't change which binary your shell picks.`
+    );
+  }
+}
+
 // src/index.ts
-program.name("headways").description("Headways CLI \u2014 skill authoring + Claude Code runtime helpers").version(package_default.version);
+program.name("headways").description("Headways CLI \u2014 skill authoring + Claude Code runtime helpers").version("1.1.0");
 registerAuthCommands(program);
 registerSkillsCommands(program);
 registerConnectionsCommands(program);
 registerEmitCommand(program);
 registerSkillRunCommands(program);
 registerPrimeCommand(program);
+registerUpgradeCommand(program);
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@headways/cli",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "type": "module",
   "description": "Headways CLI — authoring, sync, and runtime SDK",
   "license": "MIT",