@aiaiai-pt/martha-cli 0.53.0 → 0.53.1

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to `@aiaiai-pt/martha-cli`. Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). This project adheres to semver — `0.x` releases may include breaking changes between minor versions.
 
+## [0.53.1] — 2026-08-03
+
+### Fixed — `channels install-harness` told a Buzz-less machine to "launch Buzz once"
+
+- The command registers Martha as a runtime *inside* Buzz Desktop, so with no
+  Desktop on the machine there is nothing to register with. It correctly
+  refused and wrote nothing, but the remedy assumed the app was installed and
+  merely unopened. It now probes for the application itself and says which of
+  the two situations it is: **not installed** (with the release link, and a
+  pointer to `martha channels connect buzz`, which needs no Desktop at all) or
+  **installed but never launched** (open it once). Both still name the exact
+  app-data paths so `--app-data` stays actionable.
+
 ## [0.53.0] — 2026-08-02
 
 ### Added — `martha channels`: connect an agent to a channel from either side (#1140)

package/dist/index.js

@@ -11129,7 +11129,7 @@ init_config();
 init_errors();
 
 // src/version.ts
-var CLI_VERSION = "0.53.0";
+var CLI_VERSION = "0.53.1";
 
 // src/commands/sessions.ts
 function relativeTime(iso) {
@@ -14770,6 +14770,40 @@ function buzzAppDataCandidates(platform, env2, home) {
 function chooseAppDataDir(candidates, exists) {
   return candidates.find((c) => exists(c.dir)) ?? null;
 }
+function buzzAppCandidates(platform, env2, home) {
+  if (platform === "darwin") {
+    return ["/Applications/Buzz.app", join3(home, "Applications", "Buzz.app")];
+  }
+  if (platform === "win32") {
+    const base = env2.LOCALAPPDATA ?? join3(home, "AppData", "Local");
+    return [join3(base, "Programs", "Buzz")];
+  }
+  return [
+    "/opt/Buzz",
+    "/usr/bin/buzz-desktop",
+    join3(home, ".local", "bin", "buzz-desktop")
+  ];
+}
+var BUZZ_RELEASES_URL = "https://github.com/block/buzz/releases/latest";
+function missingAppDataMessage(candidates, appInstalled) {
+  const looked = candidates.map((c) => `  ${c.dir}  (${c.build})`).join(`
+`);
+  if (appInstalled) {
+    return `Buzz Desktop is installed but has never been launched — it creates its ` + `data directory on first run.
+
+Looked for:
+${looked}
+` + `Open Buzz Desktop once, then re-run this. Or pass --app-data <dir>.`;
+  }
+  return `Buzz Desktop is not installed on this machine. This command registers ` + `Martha as a runtime INSIDE Desktop, so there is nothing to register with.
+
+` + `Looked for:
+${looked}
+` + `Install it: ${BUZZ_RELEASES_URL}
+
+` + `If you do not want Desktop at all, you do not need this command — run the ` + `adapter yourself instead:
+  martha channels connect buzz --agent <name> --relay <url>`;
+}
 var DEFAULT_BUZZ_KINDS = "9,46010,40007,7";
 function buzzAcpEnv(opts) {
   const env2 = {
@@ -15116,10 +15150,8 @@ function registerChannelCommands(program2) {
     const chosen = opts.appData ? { build: "release", dir: String(opts.appData) } : chooseAppDataDir(buzzAppDataCandidates(process.platform, process.env, homedir()), (d) => existsSync(d));
     if (!chosen) {
       const candidates = buzzAppDataCandidates(process.platform, process.env, homedir());
-      throw new CLIError("No Buzz Desktop app-data directory found.", 3 /* NotFound */, `Looked for:
-${candidates.map((c) => `  ${c.dir}  (${c.build})`).join(`
-`)}
-Launch Buzz Desktop once so it creates one, or pass --app-data <dir>.`);
+      const appInstalled = buzzAppCandidates(process.platform, process.env, homedir()).some((p) => existsSync(p));
+      throw new CLIError(appInstalled ? "Buzz Desktop has no data directory yet." : "Buzz Desktop is not installed.", 3 /* NotFound */, missingAppDataMessage(candidates, appInstalled));
     }
     const dir = join3(chosen.dir, "custom_harnesses");
     const file = join3(dir, `${def.id}.json`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiaiai-pt/martha-cli",
-  "version": "0.53.0",
+  "version": "0.53.1",
   "description": "Terminal-first client for the Martha AI platform",
   "homepage": "https://docs.martha.nomadriver.co",
   "repository": {