Harden SDK hook context and capability diagnostics

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

@@ -1,26 +1,26 @@
 {
   "version": 1,
-  "updated_at": "2026-06-03T05:16:56.741Z",
+  "updated_at": "2026-06-03T11:58:31.758Z",
   "entries": [
     {
       "name": "pm-changelog",
       "directory": "pm-changelog",
       "scope": "project",
-      "manifest_version": "2026.6.2",
+      "manifest_version": "2026.6.3",
       "manifest_entry": "./dist/extension.js",
       "capabilities": [
         "commands",
         "importers",
         "schema"
       ],
       "installed_at": "2026-05-23T20:26:03.509Z",
-      "updated_at": "2026-06-02T15:30:41.832Z",
+      "updated_at": "2026-06-03T11:16:39.097Z",
       "source": {
         "kind": "npm",
         "input": "npm:pm-changelog",
         "location": "package",
         "package": "pm-changelog",
-        "version": "2026.6.2"
+        "version": "2026.6.3"
       }
     }
   ]

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

@@ -1,5 +1,21 @@
 # Changelog
 
+## 2026.6.3 - 2026-06-03
+
+### Added
+
+- Opt-in changelog enhancements ([pmc-emx6](https://github.com/unbraind/pm-changelog/blob/main/.agents/pm/features/pmc-emx6.toon))
+- Add --changelog-json structured document output ([pmc-gl6b](https://github.com/unbraind/pm-changelog/blob/main/.agents/pm/tasks/pmc-gl6b.toon))
+- Add --limit and --since-version release windowing ([pmc-xtwa](https://github.com/unbraind/pm-changelog/blob/main/.agents/pm/tasks/pmc-xtwa.toon))
+- Add --contributors per-release contributor list ([pmc-imsu](https://github.com/unbraind/pm-changelog/blob/main/.agents/pm/tasks/pmc-imsu.toon))
+- Add --conventional Conventional-Commits heading mapping ([pmc-91hn](https://github.com/unbraind/pm-changelog/blob/main/.agents/pm/tasks/pmc-91hn.toon))
+- Add --section-by type\|status\|label within-release grouping ([pmc-qro6](https://github.com/unbraind/pm-changelog/blob/main/.agents/pm/tasks/pmc-qro6.toon))
+
+### Fixed
+
+- Zero-regression guarantee for pm-changelog enhancements ([pmc-1w1r](https://github.com/unbraind/pm-changelog/blob/main/.agents/pm/decisions/pmc-1w1r.toon))
+- Fix changelog export format validation and metadata ([pmc-55cp](https://github.com/unbraind/pm-changelog/blob/main/.agents/pm/issues/pmc-55cp.toon))
+
 ## 2026.6.1 - 2026-06-01
 
 ### Fixed

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

@@ -25,6 +25,21 @@ npm install --save-dev pm-changelog @unbrained/pm-cli
 npx pm-changelog --mode prepend --output CHANGELOG.md
 ```
 
+## Opt-in extras
+
+These flags are strictly additive — omitting them keeps output byte-for-byte identical to the default:
+
+```bash
+npx pm-changelog --stdout --section-by type      # group by type/status/label instead of categories
+npx pm-changelog --stdout --conventional         # Features / Bug Fixes / ... headings
+npx pm-changelog --stdout --contributors         # per-release contributor list
+npx pm-changelog --all-release-tags --limit 10   # keep only the newest N releases
+npx pm-changelog --all-release-tags --since-version 2.0.0
+npx pm-changelog --all-release-tags --changelog-json > changelog.json
+```
+
+See [Usage](docs/usage.md#opt-in-enhancements) for details.
+
 ## Docs
 
 - [Docs index](docs/README.md)