@unbrained/pm-cli 2026.7.19 → 2026.7.20

package/dist/cli-bundle/chunks/{chunk-OKWJUL6F.js → chunk-I577UHC7.js}

@@ -1,6 +1,6 @@
 import {
   createStdinTokenResolver
-} from "./chunk-A5EQPNV7.js";
+} from "./chunk-GVT754PX.js";
 import {
   resolveAuthor
 } from "./chunk-YRYYFGV3.js";
@@ -8,20 +8,20 @@ import {
   mutateItem,
   readSettings,
   toItemRecord
-} from "./chunk-RLLOZAM2.js";
+} from "./chunk-IY6VZ3IW.js";
 import {
   EXIT_CODE,
   PmCliError,
   getSettingsPath,
   pathExists,
   resolvePmRoot
-} from "./chunk-WCBB6VI3.js";
+} from "./chunk-7AVEY74G.js";
 
 // dist/cli/commands/append.js
 !(function() {
   try {
     var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "df3bcfb0-4997-5b43-926a-ed7c60f3b7f3");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "88f96ac8-1557-5408-a396-1c46d247a890");
   } catch (e2) {
   }
 })();
@@ -38,6 +38,16 @@ async function runAppend(id, options, global2) {
   const author = resolveAuthor(options.author, settings.author_default);
   const bodyInput = await stdinResolver.resolveValue(options.body, "--body");
   const appended = bodyInput.trim();
+  if (appended.length === 0) {
+    throw new PmCliError("--body text cannot be empty; append requires non-blank content and empty appends would only rewrite updated_at.", EXIT_CODE.USAGE, {
+      code: "append_empty_body",
+      required: "Provide non-empty body text positionally, via --body, or with - for stdin.",
+      examples: [
+        'pm append pm-a1b2 --body "Progress note"',
+        "pm append pm-a1b2 --body -"
+      ]
+    });
+  }
   const result = await mutateItem({
     pmRoot,
     settings,
@@ -47,9 +57,6 @@ async function runAppend(id, options, global2) {
     message: options.message,
     force: options.force,
     mutate(document) {
-      if (appended.length === 0) {
-        return { changedFields: [] };
-      }
       const spacer = document.body.trim().length > 0 ? "\n\n" : "";
       document.body = `${document.body.replace(/\s+$/, "")}${spacer}${appended}
 `;
@@ -58,7 +65,7 @@ async function runAppend(id, options, global2) {
   });
   return {
     item: toItemRecord(result.item),
-    appended: appended.length > 0 ? appended : "",
+    appended,
     changed_fields: result.changedFields
   };
 }
@@ -66,4 +73,4 @@ async function runAppend(id, options, global2) {
 export {
   runAppend
 };
-//# sourceMappingURL=chunk-OKWJUL6F.js.map
+//# sourceMappingURL=chunk-I577UHC7.js.map

package/dist/cli-bundle/chunks/{chunk-OKWJUL6F.js.map → chunk-I577UHC7.js.map}

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../../../cli/commands/append.ts"],
-  "sourcesContent": ["/**\n * @module cli/commands/append\n *\n * Implements the pm append command surface and its agent-facing runtime behavior.\n */\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport { toItemRecord } from \"../../core/item/item-record.js\";\nimport { createStdinTokenResolver } from \"../../core/item/parse.js\";\nimport { mutateItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\n\n/** Documents the append command options payload exchanged by command, SDK, and package integrations. */\nexport interface AppendCommandOptions {\n  /** Value that configures or reports body for this contract. */\n  body: string;\n  /** Value that configures or reports author for this contract. */\n  author?: string;\n  /** Human-readable explanation suitable for logs and agent-facing output. */\n  message?: string;\n  /** Value that configures or reports force for this contract. */\n  force?: boolean;\n}\n\n/** Documents the append result payload exchanged by command, SDK, and package integrations. */\nexport interface AppendResult {\n  /** Value that configures or reports item for this contract. */\n  item: Record<string, unknown>;\n  /** Value that configures or reports appended for this contract. */\n  appended: string;\n  /** Value that configures or reports changed fields for this contract. */\n  changed_fields: string[];\n}\n\n/** Implements run append for the public runtime surface of this module. */\nexport async function runAppend(\n  id: string,\n  options: AppendCommandOptions,\n  global: GlobalOptions,\n): Promise<AppendResult> {\n  if (options.body === undefined) {\n    throw new PmCliError(\"Missing required --body text\", EXIT_CODE.USAGE);\n  }\n  const stdinResolver = createStdinTokenResolver();\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n  const settings = await readSettings(pmRoot);\n  const author = resolveAuthor(options.author, settings.author_default);\n  // options.body is guaranteed defined by the guard above, so resolveValue returns a defined string.\n  const bodyInput = await stdinResolver.resolveValue(options.body, \"--body\");\n  const appended = (bodyInput as string).trim();\n\n  const result = await mutateItem({\n    pmRoot,\n    settings,\n    id,\n    op: \"append\",\n    author,\n    message: options.message,\n    force: options.force,\n    mutate(document) {\n      if (appended.length === 0) {\n        return { changedFields: [] };\n      }\n      const spacer = document.body.trim().length > 0 ? \"\\n\\n\" : \"\";\n      document.body = `${document.body.replace(/\\s+$/, \"\")}${spacer}${appended}\\n`;\n      return { changedFields: [\"body\"] };\n    },\n  });\n\n  return {\n    item: toItemRecord(result.item),\n    appended: appended.length > 0 ? appended : \"\",\n    changed_fields: result.changedFields,\n  };\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,eAAsB,UACpB,IACA,SACAA,SAAqB;AAErB,MAAI,QAAQ,SAAS,QAAW;AAC9B,UAAM,IAAI,WAAW,gCAAgC,UAAU,KAAK;EACtE;AACA,QAAM,gBAAgB,yBAAwB;AAC9C,QAAM,SAAS,cAAc,QAAQ,IAAG,GAAIA,QAAO,IAAI;AACvD,MAAI,CAAE,MAAM,WAAW,gBAAgB,MAAM,CAAC,GAAI;AAChD,UAAM,IAAI,WACR,iCAAiC,MAAM,wBACvC,UAAU,SAAS;EAEvB;AACA,QAAM,WAAW,MAAM,aAAa,MAAM;AAC1C,QAAM,SAAS,cAAc,QAAQ,QAAQ,SAAS,cAAc;AAEpE,QAAM,YAAY,MAAM,cAAc,aAAa,QAAQ,MAAM,QAAQ;AACzE,QAAM,WAAY,UAAqB,KAAI;AAE3C,QAAM,SAAS,MAAM,WAAW;IAC9B;IACA;IACA;IACA,IAAI;IACJ;IACA,SAAS,QAAQ;IACjB,OAAO,QAAQ;IACf,OAAO,UAAQ;AACb,UAAI,SAAS,WAAW,GAAG;AACzB,eAAO,EAAE,eAAe,CAAA,EAAE;MAC5B;AACA,YAAM,SAAS,SAAS,KAAK,KAAI,EAAG,SAAS,IAAI,SAAS;AAC1D,eAAS,OAAO,GAAG,SAAS,KAAK,QAAQ,QAAQ,EAAE,CAAC,GAAG,MAAM,GAAG,QAAQ;;AACxE,aAAO,EAAE,eAAe,CAAC,MAAM,EAAC;IAClC;GACD;AAED,SAAO;IACL,MAAM,aAAa,OAAO,IAAI;IAC9B,UAAU,SAAS,SAAS,IAAI,WAAW;IAC3C,gBAAgB,OAAO;;AAE3B;",
+  "sourcesContent": ["/**\n * @module cli/commands/append\n *\n * Implements the pm append command surface and its agent-facing runtime behavior.\n */\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport { toItemRecord } from \"../../core/item/item-record.js\";\nimport { createStdinTokenResolver } from \"../../core/item/parse.js\";\nimport { mutateItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\n\n/** Documents the append command options payload exchanged by command, SDK, and package integrations. */\nexport interface AppendCommandOptions {\n  /** Value that configures or reports body for this contract. */\n  body: string;\n  /** Value that configures or reports author for this contract. */\n  author?: string;\n  /** Human-readable explanation suitable for logs and agent-facing output. */\n  message?: string;\n  /** Value that configures or reports force for this contract. */\n  force?: boolean;\n}\n\n/** Documents the append result payload exchanged by command, SDK, and package integrations. */\nexport interface AppendResult {\n  /** Value that configures or reports item for this contract. */\n  item: Record<string, unknown>;\n  /** Value that configures or reports appended for this contract. */\n  appended: string;\n  /** Value that configures or reports changed fields for this contract. */\n  changed_fields: string[];\n}\n\n/** Implements run append for the public runtime surface of this module. */\nexport async function runAppend(\n  id: string,\n  options: AppendCommandOptions,\n  global: GlobalOptions,\n): Promise<AppendResult> {\n  if (options.body === undefined) {\n    throw new PmCliError(\"Missing required --body text\", EXIT_CODE.USAGE);\n  }\n  const stdinResolver = createStdinTokenResolver();\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n  const settings = await readSettings(pmRoot);\n  const author = resolveAuthor(options.author, settings.author_default);\n  // options.body is guaranteed defined by the guard above, so resolveValue returns a defined string.\n  const bodyInput = await stdinResolver.resolveValue(options.body, \"--body\");\n  const appended = (bodyInput as string).trim();\n  if (appended.length === 0) {\n    throw new PmCliError(\n      \"--body text cannot be empty; append requires non-blank content and empty appends would only rewrite updated_at.\",\n      EXIT_CODE.USAGE,\n      {\n        code: \"append_empty_body\",\n        required:\n          \"Provide non-empty body text positionally, via --body, or with - for stdin.\",\n        examples: [\n          'pm append pm-a1b2 --body \"Progress note\"',\n          \"pm append pm-a1b2 --body -\",\n        ],\n      },\n    );\n  }\n\n  const result = await mutateItem({\n    pmRoot,\n    settings,\n    id,\n    op: \"append\",\n    author,\n    message: options.message,\n    force: options.force,\n    mutate(document) {\n      const spacer = document.body.trim().length > 0 ? \"\\n\\n\" : \"\";\n      document.body = `${document.body.replace(/\\s+$/, \"\")}${spacer}${appended}\\n`;\n      return { changedFields: [\"body\"] };\n    },\n  });\n\n  return {\n    item: toItemRecord(result.item),\n    appended,\n    changed_fields: result.changedFields,\n  };\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,eAAsB,UACpB,IACA,SACAA,SAAqB;AAErB,MAAI,QAAQ,SAAS,QAAW;AAC9B,UAAM,IAAI,WAAW,gCAAgC,UAAU,KAAK;EACtE;AACA,QAAM,gBAAgB,yBAAwB;AAC9C,QAAM,SAAS,cAAc,QAAQ,IAAG,GAAIA,QAAO,IAAI;AACvD,MAAI,CAAE,MAAM,WAAW,gBAAgB,MAAM,CAAC,GAAI;AAChD,UAAM,IAAI,WACR,iCAAiC,MAAM,wBACvC,UAAU,SAAS;EAEvB;AACA,QAAM,WAAW,MAAM,aAAa,MAAM;AAC1C,QAAM,SAAS,cAAc,QAAQ,QAAQ,SAAS,cAAc;AAEpE,QAAM,YAAY,MAAM,cAAc,aAAa,QAAQ,MAAM,QAAQ;AACzE,QAAM,WAAY,UAAqB,KAAI;AAC3C,MAAI,SAAS,WAAW,GAAG;AACzB,UAAM,IAAI,WACR,mHACA,UAAU,OACV;MACE,MAAM;MACN,UACE;MACF,UAAU;QACR;QACA;;KAEH;EAEL;AAEA,QAAM,SAAS,MAAM,WAAW;IAC9B;IACA;IACA;IACA,IAAI;IACJ;IACA,SAAS,QAAQ;IACjB,OAAO,QAAQ;IACf,OAAO,UAAQ;AACb,YAAM,SAAS,SAAS,KAAK,KAAI,EAAG,SAAS,IAAI,SAAS;AAC1D,eAAS,OAAO,GAAG,SAAS,KAAK,QAAQ,QAAQ,EAAE,CAAC,GAAG,MAAM,GAAG,QAAQ;;AACxE,aAAO,EAAE,eAAe,CAAC,MAAM,EAAC;IAClC;GACD;AAED,SAAO;IACL,MAAM,aAAa,OAAO,IAAI;IAC9B;IACA,gBAAgB,OAAO;;AAE3B;",
   "names": ["global"]
 }

package/dist/cli-bundle/chunks/{chunk-XDWXPG2E.js → chunk-IAQE32BI.js}

@@ -2,7 +2,7 @@ import {
   clearFocusedItem,
   getFocusedItem,
   setFocusedItem
-} from "./chunk-E7KBMWEF.js";
+} from "./chunk-JSLT7WVE.js";
 import {
   buildItemNotFoundError,
   getActiveExtensionRegistrations,
@@ -10,7 +10,7 @@ import {
   normalizeItemId,
   readLocatedItem,
   readSettings
-} from "./chunk-RLLOZAM2.js";
+} from "./chunk-IY6VZ3IW.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -18,7 +18,7 @@ import {
   pathExists,
   resolveItemTypeRegistry,
   resolvePmRoot
-} from "./chunk-WCBB6VI3.js";
+} from "./chunk-7AVEY74G.js";
 
 // dist/cli/commands/focus.js
 !(function() {
@@ -101,4 +101,4 @@ function nonEmptyTitleOrNull(title) {
 export {
   runFocus
 };
-//# sourceMappingURL=chunk-XDWXPG2E.js.map
+//# sourceMappingURL=chunk-IAQE32BI.js.map

package/dist/cli-bundle/chunks/{chunk-66SRNEBK.js → chunk-IJNK6WW2.js}

@@ -1,10 +1,10 @@
 import {
   getActiveExtensionRegistrations
-} from "./chunk-RLLOZAM2.js";
+} from "./chunk-IY6VZ3IW.js";
 import {
   RelationshipGraph,
   createRelationshipKindRegistry
-} from "./chunk-WCBB6VI3.js";
+} from "./chunk-7AVEY74G.js";
 
 // dist/sdk/graph/assembly.js
 !(function() {
@@ -140,4 +140,4 @@ export {
   collectMissingDependencyTargetIds,
   assembleWorkspaceRelationshipGraph
 };
-//# sourceMappingURL=chunk-66SRNEBK.js.map
+//# sourceMappingURL=chunk-IJNK6WW2.js.map