Single-call mutation ergonomics: pm create/update --body-file, pm close -m/-r/-d, --resolution as close reason

.agents/pm/extensions/.managed-extensions.json

@@ -1,26 +1,26 @@
 {
   "version": 1,
-  "updated_at": "2026-06-13T20:20:10.905Z",
+  "updated_at": "2026-06-13T21:22:12.172Z",
   "entries": [
     {
       "name": "pm-changelog",
       "directory": "pm-changelog",
       "scope": "project",
-      "manifest_version": "2026.6.13",
+      "manifest_version": "2026.6.13-1",
       "manifest_entry": "./dist/extension.js",
       "capabilities": [
         "commands",
         "importers",
         "schema"
       ],
       "installed_at": "2026-05-23T20:26:03.509Z",
-      "updated_at": "2026-06-13T19:47:04.792Z",
+      "updated_at": "2026-06-13T21:21:47.904Z",
       "source": {
         "kind": "npm",
         "input": "npm:pm-changelog",
         "location": "package",
         "package": "pm-changelog",
-        "version": "2026.6.13"
+        "version": "2026.6.13-1"
       }
     }
   ]

.agents/pm/extensions/pm-changelog/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 2026.6.13-1 - 2026-06-13
+
+### Fixed
+
+- Prepend merge promotes a stale Unreleased section into the released version instead of duplicating it \(GH \#47\) ([pmc-8ssd](https://github.com/unbraind/pm-changelog/blob/main/.agents/pm/issues/pmc-8ssd.toon))
+
 ## 2026.6.8 - 2026-06-08
 
 ### Fixed

.agents/pm/extensions/pm-changelog/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-changelog",
-  "version": "2026.6.13",
+  "version": "2026.6.13-1",
   "manifest_version": 2,
   "description": "Generate CHANGELOG.md release notes from pm-cli items",
   "author": "@unbraind",

.agents/pm/extensions/pm-changelog/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-changelog",
-  "version": "2026.6.13",
+  "version": "2026.6.13-1",
   "description": "Generate CHANGELOG.md files from pm-cli items for local and CI usage",
   "repository": {
     "type": "git",
@@ -47,7 +47,7 @@
     "build:test": "tsc -p tsconfig.test.json",
     "changelog": "node dist/cli.js --pm-root .agents/pm --mode prepend --output CHANGELOG.md --release-version-from-package --since-previous-tag --until-release-tag --item-url-base https://github.com/unbraind/pm-changelog/blob/main/.agents/pm",
     "changelog:full": "node dist/cli.js --pm-root .agents/pm --mode replace --output CHANGELOG.md --all-release-tags --release-version-from-package --item-url-base https://github.com/unbraind/pm-changelog/blob/main/.agents/pm",
-    "changelog:check": "node dist/cli.js --pm-root .agents/pm --mode replace --output CHANGELOG.md --all-release-tags --release-version-from-package --item-url-base https://github.com/unbraind/pm-changelog/blob/main/.agents/pm --check",
+    "changelog:check": "npm run changelog -- --check",
     "audit:prod": "npm audit --omit=dev",
     "pack:dry-run": "npm pack --dry-run",
     "prepack": "npm run build",

.agents/pm/features/pm-7c48.toon

@@ -0,0 +1,16 @@
+id: pm-7c48
+title: "pm create/update --body-file: load body markdown from a file (GH-214)"
+description: ""
+type: Feature
+status: closed
+priority: 2
+tags[3]: "area:cli",ergonomics,gh-214
+created_at: "2026-06-13T20:54:33.250Z"
+updated_at: "2026-06-13T21:20:48.555Z"
+author: claude-code-agent
+parent: pm-mpbb
+resolution: "Added --body-file <path> to pm create and pm update via new src/core/io/body-file.ts resolveBodyFileContent helper (CLI-only input alias, mutually exclusive with --body, actionable errors for conflict/empty-path/unreadable). Wired into create+update actions before normalize, CREATE/UPDATE_FLAG_CONTRACTS + zsh/fish completion + contracts golden + docs. 100% unit-covered + in-process integration tests."
+comments[1]{created_at,author,text}:
+  "2026-06-13T20:59:26.222Z",claude-code-agent,"Plan: new core helper src/core/io/body-file.ts resolveBodyFileContent(bodyFile, body, readFileImpl?) — reads file (utf8), errors if --body also set (mutually exclusive) or path missing/unreadable. Register --body-file <path> commander option on create+update (direct .option) + add to CREATE_FLAG_CONTRACTS/UPDATE_FLAG_CONTRACTS for completion. Resolve+delete in create/update actions before normalize. CLI-only (no MCP — file paths meaningless over MCP, like history --diff). Mutual-exclusion error mirrors existing guided-error shape."
+close_reason: "Added --body-file <path> to pm create and pm update via new src/core/io/body-file.ts resolveBodyFileContent helper (CLI-only input alias, mutually exclusive with --body, actionable errors for conflict/empty-path/unreadable). Wired into create+update actions before normalize, CREATE/UPDATE_FLAG_CONTRACTS + zsh/fish completion + contracts golden + docs. 100% unit-covered + in-process integration tests."
+body: "Add --body-file <path> to pm create and pm update so agents can supply long markdown bodies (multi-paragraph, code blocks, tables) from a file instead of escaping huge inline --body strings or doing a second pm append call. Mutually exclusive with inline --body. '-' reads from stdin. Reduces round-trips (project management = context management)."

.agents/pm/features/pm-i1mu.toon

@@ -0,0 +1,16 @@
+id: pm-i1mu
+title: "pm close: short aliases -m/-r/-d for --message/--reason/--duplicate-of (GH-226)"
+description: ""
+type: Feature
+status: closed
+priority: 3
+tags[3]: "area:cli",ergonomics,gh-226
+created_at: "2026-06-13T20:54:33.503Z"
+updated_at: "2026-06-13T21:20:48.933Z"
+author: claude-code-agent
+parent: pm-mpbb
+resolution: "Added Commander short aliases on pm close: -m (--message), -r (--reason), -d (--duplicate-of). No semantic change; verified no conflicts. In-process integration test asserts all three parse and apply."
+comments[1]{created_at,author,text}:
+  "2026-06-13T20:59:26.514Z",claude-code-agent,"Plan: add Commander short aliases on close command — -m/--message, -r/--reason, -d/--duplicate-of. No semantic change; -m/-r/-d are unused on close. Verified -d free (close has no --description). Add tests asserting parse."
+close_reason: "Added Commander short aliases on pm close: -m (--message), -r (--reason), -d (--duplicate-of). No semantic change; verified no conflicts. In-process integration test asserts all three parse and apply."
+body: "Agents typing many commands naturally try -m (message), -r (reason), -d (duplicate-of) on pm close; all currently error. Add Commander short aliases consistent with -h/--help. No semantic change."

.agents/pm/history/pm-7c48.jsonl

@@ -0,0 +1,4 @@
+{"ts":"2026-06-13T20:54:33.250Z","author":"claude-code-agent","op":"create","patch":[{"op":"replace","path":"/body","value":"Add --body-file <path> to pm create and pm update so agents can supply long markdown bodies (multi-paragraph, code blocks, tables) from a file instead of escaping huge inline --body strings or doing a second pm append call. Mutually exclusive with inline --body. '-' reads from stdin. Reduces round-trips (project management = context management)."},{"op":"add","path":"/metadata/id","value":"pm-7c48"},{"op":"add","path":"/metadata/title","value":"pm create/update --body-file: load body markdown from a file (GH-214)"},{"op":"add","path":"/metadata/description","value":""},{"op":"add","path":"/metadata/type","value":"Feature"},{"op":"add","path":"/metadata/status","value":"open"},{"op":"add","path":"/metadata/priority","value":2},{"op":"add","path":"/metadata/tags","value":["area:cli","ergonomics","gh-214"]},{"op":"add","path":"/metadata/created_at","value":"2026-06-13T20:54:33.250Z"},{"op":"add","path":"/metadata/updated_at","value":"2026-06-13T20:54:33.250Z"},{"op":"add","path":"/metadata/author","value":"claude-code-agent"},{"op":"add","path":"/metadata/parent","value":"pm-mpbb"}],"before_hash":"3cc22dff72be7b14824654a7a64ea62b04799939b2fee54c1b5f52ca60bf6df0","after_hash":"edf068eef3f59c90d3dea03f19a1922cd6636899c65a97103ec8abd7620197dd","message":""}
+{"ts":"2026-06-13T20:59:25.417Z","author":"claude-code-agent","op":"update","patch":[{"op":"replace","path":"/metadata/updated_at","value":"2026-06-13T20:59:25.417Z"},{"op":"replace","path":"/metadata/status","value":"in_progress"}],"before_hash":"edf068eef3f59c90d3dea03f19a1922cd6636899c65a97103ec8abd7620197dd","after_hash":"51530ecdf1ca1b429e99a52e493395eb41b06c6df0a95b6afcd97d022ff1dbaf"}
+{"ts":"2026-06-13T20:59:26.222Z","author":"claude-code-agent","op":"comment_add","patch":[{"op":"replace","path":"/metadata/updated_at","value":"2026-06-13T20:59:26.222Z"},{"op":"add","path":"/metadata/comments","value":[{"created_at":"2026-06-13T20:59:26.222Z","author":"claude-code-agent","text":"Plan: new core helper src/core/io/body-file.ts resolveBodyFileContent(bodyFile, body, readFileImpl?) — reads file (utf8), errors if --body also set (mutually exclusive) or path missing/unreadable. Register --body-file <path> commander option on create+update (direct .option) + add to CREATE_FLAG_CONTRACTS/UPDATE_FLAG_CONTRACTS for completion. Resolve+delete in create/update actions before normalize. CLI-only (no MCP — file paths meaningless over MCP, like history --diff). Mutual-exclusion error mirrors existing guided-error shape."}]}],"before_hash":"51530ecdf1ca1b429e99a52e493395eb41b06c6df0a95b6afcd97d022ff1dbaf","after_hash":"36e2a2201b3d3c160d360a38a1de3a38bcc61a1eee1b877fae3b760461086700"}
+{"ts":"2026-06-13T21:20:48.555Z","author":"claude-code-agent","op":"close","patch":[{"op":"replace","path":"/metadata/updated_at","value":"2026-06-13T21:20:48.555Z"},{"op":"replace","path":"/metadata/status","value":"closed"},{"op":"add","path":"/metadata/resolution","value":"Added --body-file <path> to pm create and pm update via new src/core/io/body-file.ts resolveBodyFileContent helper (CLI-only input alias, mutually exclusive with --body, actionable errors for conflict/empty-path/unreadable). Wired into create+update actions before normalize, CREATE/UPDATE_FLAG_CONTRACTS + zsh/fish completion + contracts golden + docs. 100% unit-covered + in-process integration tests."},{"op":"add","path":"/metadata/close_reason","value":"Added --body-file <path> to pm create and pm update via new src/core/io/body-file.ts resolveBodyFileContent helper (CLI-only input alias, mutually exclusive with --body, actionable errors for conflict/empty-path/unreadable). Wired into create+update actions before normalize, CREATE/UPDATE_FLAG_CONTRACTS + zsh/fish completion + contracts golden + docs. 100% unit-covered + in-process integration tests."}],"before_hash":"36e2a2201b3d3c160d360a38a1de3a38bcc61a1eee1b877fae3b760461086700","after_hash":"2875fc055c780a4dd5fd365eb80e39613ba5909e892f5e584ec4b90f78de903a","message":"Ship GH-214 --body-file"}