@aiaiai-pt/martha-cli 0.66.1 → 0.68.1

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 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.68.1] — 2026-11-03
+
+### Fixed
+
+- `martha prompts create -f <file>` accepts `content` again. 0.68.0 refused `content` on every prompt write so that `prompts update` would stop dropping it silently, but the create route requires `content`, so no prompt could be created from a file. The refusal now applies to `update` only.
+
+## [0.68.0] — 2026-11-02
+
+### Added
+
+- `martha prompts version <name> -f <file> [-m <summary>] [--promote [environment]]` creates a new version of a prompt from the file's `content` (the server's `POST /prompts/{name}/versions`) and can promote it in the same step. Until now the CLI had no way to change a prompt's text.
+
+### Fixed
+
+- `martha prompts promote <name>` sends the version and environment the server requires (`--version`, default the newest; `--environment`, default `production`). It used to send `{}`, which the server rejects.
+- `martha prompts update -f <file>` refuses a file with `content` and points at `prompts version`. The update route only changes metadata, so the content was silently dropped while the CLI printed "Updated (v1)".
+
+## [0.67.0] — 2026-11-02
+
+### Added
+
+- `martha tasks note <id> <text>` posts a human-lane note to a task's activity log through the existing `POST /api/admin/tasks/{id}/activity` (entry type comment, author set by the server). Empty or whitespace-only text is refused before any request. `--json` prints the created entry (#2377).
+
 ## [0.66.1] — 2026-11-01
 
 ### Fixed

package/dist/index.js

@@ -11149,7 +11149,7 @@ ${items.length} ${config.typeNamePlural}`));
       throw new CLIError("Missing required field: name", 4 /* Validation */);
     }
     if (config.normalizeBody)
-      body = config.normalizeBody(body);
+      body = config.normalizeBody(body, "create");
     const result = await ctx.api.post(config.apiPath, body);
     if (isJson()) {
       console.log(JSON.stringify(result, null, 2));
@@ -11164,7 +11164,7 @@ ${items.length} ${config.typeNamePlural}`));
       throw new CLIError(`File name '${body.name}' does not match argument '${name}'`, 4 /* Validation */);
     }
     if (config.normalizeBody)
-      body = config.normalizeBody(body);
+      body = config.normalizeBody(body, "update");
     const result = await ctx.api.put(`${config.apiPath}/${encodeURIComponent(name)}`, body);
     config.verifyUpdateResult?.(body, result);
     if (isJson()) {
@@ -11244,7 +11244,7 @@ init_config();
 init_errors();
 
 // src/version.ts
-var CLI_VERSION = "0.66.1";
+var CLI_VERSION = "0.68.1";
 
 // src/commands/sessions.ts
 function relativeTime(iso) {
@@ -17710,7 +17710,32 @@ var workflowsConfig = {
 };
 
 // src/commands/prompts.ts
+init_errors();
 var API_PATH2 = "/api/admin/definitions/prompts";
+var ENVIRONMENTS = ["production", "staging"];
+function promptVersionBody(file, changeSummary) {
+  const content = typeof file.content === "string" ? file.content : "";
+  if (!content.trim()) {
+    throw new CLIError("The file has no `content` to version", 4 /* Validation */, "A prompt version is the whole prompt text: put it under `content:`.");
+  }
+  return changeSummary ? { content, change_summary: changeSummary } : { content };
+}
+function promptPromoteBody(version, environment = "production") {
+  if (!Number.isInteger(version) || version < 1) {
+    throw new CLIError(`Invalid version '${version}'`, 4 /* Validation */);
+  }
+  if (!ENVIRONMENTS.includes(environment)) {
+    throw new CLIError(`Invalid environment '${environment}'`, 4 /* Validation */, `Use one of: ${ENVIRONMENTS.join(", ")}`);
+  }
+  return { version, environment };
+}
+function latestVersionNumber(data) {
+  const rows = (Array.isArray(data) ? data : data?.items) ?? [];
+  const nums = rows.map((r) => Number(r.version)).filter((n) => Number.isInteger(n) && n > 0);
+  if (!nums.length)
+    throw new CLIError("The prompt has no versions", 1 /* Error */);
+  return Math.max(...nums);
+}
 var promptsConfig = {
   typeName: "prompt",
   typeNamePlural: "prompts",
@@ -17792,16 +17817,43 @@ var promptsConfig = {
       params.is_protected = "true";
     return params;
   },
+  normalizeBody: (body, action) => {
+    if (action === "update" && "content" in body) {
+      throw new CLIError("`prompts update` changes metadata only and the server ignores `content`; change the text with " + "`martha prompts version <name> -f <file> --promote`", 4 /* Validation */);
+    }
+    return body;
+  },
   extraCommands: (parentCmd, getCtx, isJson) => {
-    parentCmd.command("promote <name>").description("Promote staging version to production").action(async (name) => {
+    const promote = async (ctx, name, version, environment) => ctx.api.post(`${API_PATH2}/${encodeURIComponent(name)}/promote`, promptPromoteBody(version, environment));
+    parentCmd.command("version <name>").description("Create a new version of a prompt from a file's `content` (optionally promote it)").requiredOption("-f, --file <path>", "YAML or JSON file with a `content` field").option("-m, --summary <text>", "What changed in this version").option("--promote [environment]", "Promote the new version (default: production)").action(async (name, opts) => {
+      const ctx = getCtx();
+      const body = promptVersionBody(loadDefinitionFile(opts.file), opts.summary);
+      const created = await ctx.api.post(`${API_PATH2}/${encodeURIComponent(name)}/versions`, body);
+      const version = Number(created.version);
+      let promoted;
+      if (opts.promote) {
+        const env = typeof opts.promote === "string" ? opts.promote : "production";
+        promoted = await promote(ctx, name, version, env);
+      }
+      if (isJson()) {
+        console.log(JSON.stringify({ version: created, promoted }, null, 2));
+        return;
+      }
+      console.log(`Created '${name}' version ${version}`);
+      if (opts.promote) {
+        const env = typeof opts.promote === "string" ? opts.promote : "production";
+        console.log(`Promoted '${name}' version ${version} → ${env}`);
+      }
+    });
+    parentCmd.command("promote <name>").description("Promote a version (default: the newest) to an environment (default: production)").option("--version <n>", "Version number to promote", (v) => Number(v)).option("--environment <env>", "production | staging", "production").action(async (name, opts) => {
       const ctx = getCtx();
-      const result = await ctx.api.post(`${API_PATH2}/${encodeURIComponent(name)}/promote`, {});
+      const version = opts.version ?? latestVersionNumber(await ctx.api.get(`${API_PATH2}/${encodeURIComponent(name)}/versions`));
+      const result = await promote(ctx, name, version, opts.environment);
       if (isJson()) {
         console.log(JSON.stringify(result, null, 2));
         return;
       }
-      const prodVer = result.production_version_number ?? result.version;
-      console.log(`Promoted '${name}' staging → production (version ${prodVer})`);
+      console.log(`Promoted '${name}' version ${version} → ${opts.environment}`);
     });
     parentCmd.command("linked-collections <name>").description("List collections using this prompt as an extra prompt").action(async (name) => {
       const ctx = getCtx();
@@ -19269,6 +19321,13 @@ var priorityColor = (priority) => {
       return priority;
   }
 };
+function buildNoteBody(text) {
+  const content = text.trim();
+  if (!content) {
+    throw new CLIError("Note text must not be empty", 4 /* Validation */);
+  }
+  return { content };
+}
 function registerTaskCommands(program) {
   const cmd = program.command("tasks").description("Manage agent tasks");
   function getCtx() {
@@ -19425,6 +19484,15 @@ ${source_default.red("Error:")}`);
     }
     console.log(`Cancelled task ${id}`);
   });
+  cmd.command("note <id> <text>").description("Add a note to a task's activity log (human lane)").action(async (id, text) => {
+    const ctx = getCtx();
+    const entry = await ctx.api.post(`/api/admin/tasks/${encodeURIComponent(id)}/activity`, buildNoteBody(text));
+    if (isJson()) {
+      console.log(JSON.stringify(entry, null, 2));
+      return;
+    }
+    console.log(`Noted task ${id} (entry ${entry.id ?? "?"})`);
+  });
   cmd.command("poll").description("Poll for open tasks available for claiming").option("--agent <id>", "Filter by agent definition ID (human tokens only; ignored under agent auth)").option("--team <name>", "Poll a team's queue (name or UUID)").option("--limit <n>", "Max results", "10").action(async (opts) => {
     const ctx = getCtx();
     const limitN = parseInt(opts.limit, 10);

package/package.json

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