From e25e95b3652fedee1385ea271684b8f5d71de1ee Mon Sep 17 00:00:00 2001
From: "aidd-bot[bot]" <290648294+aidd-bot[bot]@users.noreply.github.com>
Date: Wed, 9 Sep 2026 20:18:49 +0000
Subject: [PATCH] chore: release main

---
 .claude-plugin/marketplace.json               | 34 +++++++---
 .release-please-manifest.json                 | 18 ++---
 CHANGELOG.md                                  | 66 +++++++++++++++++++
 cli/CHANGELOG.md                              | 53 +++++++++++++++
 cli/package.json                              |  2 +-
 .../aidd-context/.claude-plugin/plugin.json   |  2 +-
 plugins/aidd-context/CHANGELOG.md             | 12 ++++
 plugins/aidd-dev/.claude-plugin/plugin.json   |  2 +-
 plugins/aidd-dev/CHANGELOG.md                 | 18 +++++
 .../.claude-plugin/plugin.json                |  2 +-
 plugins/aidd-orchestrator/CHANGELOG.md        | 13 ++++
 plugins/aidd-pm/.claude-plugin/plugin.json    |  2 +-
 plugins/aidd-pm/CHANGELOG.md                  | 12 ++++
 .../aidd-refine/.claude-plugin/plugin.json    |  2 +-
 plugins/aidd-refine/CHANGELOG.md              |  7 ++
 .../aidd-telemetry/.claude-plugin/plugin.json |  2 +-
 plugins/aidd-telemetry/CHANGELOG.md           | 31 +++++++++
 plugins/aidd-vcs/.claude-plugin/plugin.json   |  2 +-
 plugins/aidd-vcs/CHANGELOG.md                 |  7 ++
 19 files changed, 261 insertions(+), 26 deletions(-)

diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index b6571ce7d..1e92608d2 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-marketplace.json",
   "name": "aidd-framework",
-  "version": "5.9.0",
+  "version": "5.10.0",
   "description": "Official plugin marketplace for the AI-Driven Development framework",
   "owner": {
     "name": "AI-Driven Dev"
@@ -12,56 +12,72 @@
       "source": "./plugins/aidd-context",
       "description": "Knowledge production: project bootstrap, project init, generation of context artifacts (skills, agents, rules, commands, hooks), mermaid diagrams, learn, discovery",
       "strict": true,
-      "metadata": { "recommended": true }
+      "metadata": {
+        "recommended": true
+      }
     },
     {
       "name": "aidd-dev",
       "source": "./plugins/aidd-dev",
       "description": "Code transformation: plan, implement, assert, audit, review, test, refactor, debug, for-sure. Hosts engineering agents.",
       "strict": true,
-      "metadata": { "recommended": true }
+      "metadata": {
+        "recommended": true
+      }
     },
     {
       "name": "aidd-vcs",
       "source": "./plugins/aidd-vcs",
       "description": "External artifacts: commit, pull-request, release-tag, issue-create",
       "strict": true,
-      "metadata": { "recommended": true }
+      "metadata": {
+        "recommended": true
+      }
     },
     {
       "name": "aidd-pm",
       "source": "./plugins/aidd-pm",
       "description": "Product backlog artifacts, refinement, Product Briefs, Epics, User Stories, Tasks, Spikes, Defects, requirements, and specs.",
       "strict": true,
-      "metadata": { "recommended": true }
+      "metadata": {
+        "recommended": true
+      }
     },
     {
       "name": "aidd-orchestrator",
       "source": "./plugins/aidd-orchestrator",
       "description": "Orchestration: synchronous SDLC pipeline, async issue-to-PR automation, and product backlog.",
       "strict": true,
-      "metadata": { "recommended": true }
+      "metadata": {
+        "recommended": true
+      }
     },
     {
       "name": "aidd-refine",
       "source": "./plugins/aidd-refine",
       "description": "Meta-cognition: refine input through brainstorming, refine output through challenge, blind-spot scanning, and fact-checking.",
       "strict": true,
-      "metadata": { "recommended": true }
+      "metadata": {
+        "recommended": true
+      }
     },
     {
       "name": "aidd-ui",
       "source": "./plugins/aidd-ui",
       "description": "ALPHA, not ready for use. UI and UX concern: design, review, and improve frontend interfaces.",
       "strict": true,
-      "metadata": { "recommended": false }
+      "metadata": {
+        "recommended": false
+      }
     },
     {
       "name": "aidd-telemetry",
       "source": "./plugins/aidd-telemetry",
       "description": "Measurement: journals every session so a unit of work can be tied to what it cost. The hooks record on plain node; its three skills reach the `aidd` CLI to turn it on, answer and check.",
       "strict": true,
-      "metadata": { "recommended": false }
+      "metadata": {
+        "recommended": false
+      }
     }
   ]
 }
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index d676ace43..c54203832 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,12 +1,12 @@
 {
-  ".": "5.9.0",
-  "plugins/aidd-context": "2.7.0",
-  "plugins/aidd-dev": "2.4.1",
-  "plugins/aidd-vcs": "2.3.1",
-  "plugins/aidd-pm": "2.4.2",
-  "plugins/aidd-orchestrator": "2.2.1",
-  "plugins/aidd-refine": "3.0.0",
+  ".": "5.10.0",
+  "plugins/aidd-context": "2.8.0",
+  "plugins/aidd-dev": "2.5.0",
+  "plugins/aidd-vcs": "2.3.2",
+  "plugins/aidd-pm": "2.5.0",
+  "plugins/aidd-orchestrator": "2.3.0",
+  "plugins/aidd-refine": "3.0.1",
   "plugins/aidd-ui": "0.2.1-alpha.0",
-  "plugins/aidd-telemetry": "0.1.0",
-  "cli": "5.2.2"
+  "plugins/aidd-telemetry": "0.2.0",
+  "cli": "5.3.0"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6f6dc97ab..dfa76d7be 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,71 @@
 # Changelog
 
+## [5.10.0](https://github.com/ai-driven-dev/framework/compare/v5.9.0...v5.10.0) (2026-09-09)
+
+
+### Features
+
+* **cli:** a record names the skill its own prompt invoked ([#783](https://github.com/ai-driven-dev/framework/issues/783)) ([7fbe889](https://github.com/ai-driven-dev/framework/commit/7fbe8897cee6ed522d1f52a2124c4109eb101543))
+* **cli:** one shared framework source per machine, user scope and session telemetry ([#795](https://github.com/ai-driven-dev/framework/issues/795)) ([95bdbbc](https://github.com/ai-driven-dev/framework/commit/95bdbbc3328262b72f5fd2b8034bc9630bf02e2f))
+* **cli:** the report answers the same from anywhere, and says how it knows ([#754](https://github.com/ai-driven-dev/framework/issues/754)) ([87af185](https://github.com/ai-driven-dev/framework/commit/87af18511a8dedf5e91f0099adda0bbde80dfbf7))
+* **framework:** measurement that works on five tools, each proven by a session that ran ([#706](https://github.com/ai-driven-dev/framework/issues/706)) ([627408f](https://github.com/ai-driven-dev/framework/commit/627408fba964b30d22b57fc99241083da1e0f294))
+* **framework:** reload OpenCode skills in development ([#742](https://github.com/ai-driven-dev/framework/issues/742)) ([9deab9b](https://github.com/ai-driven-dev/framework/commit/9deab9b195b2cf5945016e45114570d727cc8a27))
+* **orchestrator:** an orchestration says when it is done ([#764](https://github.com/ai-driven-dev/framework/issues/764)) ([feddad9](https://github.com/ai-driven-dev/framework/commit/feddad95e138eedd8be935b8c01b65abe6485b4d))
+* **telemetry:** a flow the tool named is a flow ([#768](https://github.com/ai-driven-dev/framework/issues/768)) ([37a6b2c](https://github.com/ai-driven-dev/framework/commit/37a6b2ce42bd598557baee8e41b8b9d8e98cda2d))
+* **telemetry:** a prompt is an axis, and the only one complete by construction ([#757](https://github.com/ai-driven-dev/framework/issues/757)) ([18ed39b](https://github.com/ai-driven-dev/framework/commit/18ed39ba3fe87fd115e77acf88b1c4e56c6de70d))
+* **telemetry:** a skill says when it is done, because nothing else can ([#756](https://github.com/ai-driven-dev/framework/issues/756)) ([cf66c22](https://github.com/ai-driven-dev/framework/commit/cf66c22856d3b00ad9ecc69582ad7b37f93e4401))
+
+
+### Bug Fixes
+
+* **cli:** a journal states the schema it was written in, and the reader reads it ([#776](https://github.com/ai-driven-dev/framework/issues/776)) ([5788ad8](https://github.com/ai-driven-dev/framework/commit/5788ad885958130cea4b7a2151bbdea75e03522d))
+* **cli:** a repair that repaired nothing says so ([#762](https://github.com/ai-driven-dev/framework/issues/762)) ([dccbef2](https://github.com/ai-driven-dev/framework/commit/dccbef25b43943904ec9a3cee3b5c2056d2cfdd6))
+* **cli:** a step outlives the pause inside it ([#775](https://github.com/ai-driven-dev/framework/issues/775)) ([9f19b94](https://github.com/ai-driven-dev/framework/commit/9f19b9403fb7ee4079f9bd9b2047b71fd0906991))
+* **cli:** a step's extent is only as strong as the evidence that closed it ([#777](https://github.com/ai-driven-dev/framework/issues/777)) ([af683f4](https://github.com/ai-driven-dev/framework/commit/af683f4d9640766e114bc28e28beab9bf7943823))
+* **cli:** activation leaves no permanent drift ([#773](https://github.com/ai-driven-dev/framework/issues/773)) ([462431a](https://github.com/ai-driven-dev/framework/commit/462431ab04e91ac94a8d126fef9d9d5753148ee6))
+* **cli:** an unreadable registry says so instead of crashing ([#787](https://github.com/ai-driven-dev/framework/issues/787)) ([25f0837](https://github.com/ai-driven-dev/framework/commit/25f08379303592e05f8d894099399f4166036e60))
+* **cli:** carry the catalog's recommended field under metadata, where Claude Code does not warn ([#803](https://github.com/ai-driven-dev/framework/issues/803)) ([4531b74](https://github.com/ai-driven-dev/framework/commit/4531b7466a03cd136764540e55f5c867dbdcafb5)), closes [#800](https://github.com/ai-driven-dev/framework/issues/800)
+* **cli:** check says whether the host will load what aidd installed ([#748](https://github.com/ai-driven-dev/framework/issues/748)) ([919aee3](https://github.com/ai-driven-dev/framework/commit/919aee3004c5ad33bb6cca8726a1c26aebc2aad4))
+* **cli:** clean removes the state it wrote ([#765](https://github.com/ai-driven-dev/framework/issues/765)) ([c73e793](https://github.com/ai-driven-dev/framework/commit/c73e7934fb08c49a50e4c63f495ccf294fa92da4))
+* **cli:** the commit trailer survives a hook another tool regenerates, and check says whether it did ([#749](https://github.com/ai-driven-dev/framework/issues/749)) ([5b222a3](https://github.com/ai-driven-dev/framework/commit/5b222a36ccec5c5224ea366f145f49888bd9a8fb))
+* **framework:** a context reference in a form its tool cannot resolve ([#751](https://github.com/ai-driven-dev/framework/issues/751)) ([8a43983](https://github.com/ai-driven-dev/framework/commit/8a43983a5ba87b7b5baa4229be5b628eae6b3b83)), closes [#619](https://github.com/ai-driven-dev/framework/issues/619)
+* **framework:** a test that writes into this repository's own .git ([#753](https://github.com/ai-driven-dev/framework/issues/753)) ([0144ec8](https://github.com/ai-driven-dev/framework/commit/0144ec84efc3382e67be0f9bddbdf9ee1cb5e791))
+* **plugins:** a skill links only inside itself ([#772](https://github.com/ai-driven-dev/framework/issues/772)) ([1efb3d9](https://github.com/ai-driven-dev/framework/commit/1efb3d958897b88c9fde814d6e1e941f8978c519))
+* **telemetry:** a backlog declaration the report can actually read ([#780](https://github.com/ai-driven-dev/framework/issues/780)) ([da524ca](https://github.com/ai-driven-dev/framework/commit/da524ca1acf370cf97b99a1b8c9b8e6c23cfc70e))
+* **telemetry:** a counter says what was measured ([#786](https://github.com/ai-driven-dev/framework/issues/786)) ([1f1ae9e](https://github.com/ai-driven-dev/framework/commit/1f1ae9ee509123d55172cb1983cbe747ed9da5d4))
+* **telemetry:** a re-read stores nothing the same batch already wrote ([#758](https://github.com/ai-driven-dev/framework/issues/758)) ([a65bc81](https://github.com/ai-driven-dev/framework/commit/a65bc81f0987517b0199dd7703770f9bf6a622b6))
+* **telemetry:** a record can predate its journal, and must say so ([#759](https://github.com/ai-driven-dev/framework/issues/759)) ([39a4e84](https://github.com/ai-driven-dev/framework/commit/39a4e84bd5828bf2be1cc6c64831a1682271ad54))
+* **telemetry:** a second export is a second plugin ([#785](https://github.com/ai-driven-dev/framework/issues/785)) ([ba845f8](https://github.com/ai-driven-dev/framework/commit/ba845f86227599038be67fcf9c7736c4722a0502))
+* **telemetry:** a step end names its skill either way ([#767](https://github.com/ai-driven-dev/framework/issues/767)) ([534d3db](https://github.com/ai-driven-dev/framework/commit/534d3db3ba68031cf82eea249b53f53c7a0555fa))
+* **telemetry:** a turn end is a pause for a flow too ([#763](https://github.com/ai-driven-dev/framework/issues/763)) ([ae70de6](https://github.com/ai-driven-dev/framework/commit/ae70de6c2bf7e691cdadd3f4351b80d90cbf400f))
+* **telemetry:** an agent row says who could be named ([#770](https://github.com/ai-driven-dev/framework/issues/770)) ([e4dc167](https://github.com/ai-driven-dev/framework/commit/e4dc16775f48c94f6a266471b0dab3bb466e1347))
+* **telemetry:** an identity names the work it already did ([#761](https://github.com/ai-driven-dev/framework/issues/761)) ([38a5d43](https://github.com/ai-driven-dev/framework/commit/38a5d43501b2b14b3b65ae723cf137ca8931a590))
+
+
+### Miscellaneous
+
+* **ci:** install expect without the runner's third-party apt source ([#808](https://github.com/ai-driven-dev/framework/issues/808)) ([1e8ce3f](https://github.com/ai-driven-dev/framework/commit/1e8ce3fb5e5938dfd17e8a7866aac4ae8004e25a))
+* **deps-dev:** bump @biomejs/biome from 2.5.10 to 2.5.11 in /cli ([#737](https://github.com/ai-driven-dev/framework/issues/737)) ([989ba00](https://github.com/ai-driven-dev/framework/commit/989ba0052cb85f70f2125b25916eb34da4bb727c))
+* **deps-dev:** bump @types/node from 26.2.0 to 26.4.0 in /cli ([#736](https://github.com/ai-driven-dev/framework/issues/736)) ([633d6cd](https://github.com/ai-driven-dev/framework/commit/633d6cd4eeed69b07d641d27077ee91e8002d880))
+* **deps-dev:** bump js-yaml from 5.3.0 to 5.4.1 ([#734](https://github.com/ai-driven-dev/framework/issues/734)) ([07a2364](https://github.com/ai-driven-dev/framework/commit/07a2364e282bc0aee1750250ee5b7594a6a5fe3a))
+* **deps-dev:** bump knip from 6.32.2 to 6.33.0 in /cli ([#740](https://github.com/ai-driven-dev/framework/issues/740)) ([9ed420c](https://github.com/ai-driven-dev/framework/commit/9ed420c7c75a87ead8c3f926e06279c0f39d76a3))
+* **deps-dev:** bump lefthook from 2.1.10 to 2.1.12 ([#735](https://github.com/ai-driven-dev/framework/issues/735)) ([0451c62](https://github.com/ai-driven-dev/framework/commit/0451c62db8c0d5392d8d0bcd81f2b62c2ed87334))
+* **deps-dev:** bump lefthook from 2.1.10 to 2.1.12 in /cli ([#739](https://github.com/ai-driven-dev/framework/issues/739)) ([9040636](https://github.com/ai-driven-dev/framework/commit/904063648eb0ee7dae98425ee39e6519481e9c95))
+* **deps:** bump @inquirer/prompts from 8.6.0 to 8.7.0 in /cli ([#738](https://github.com/ai-driven-dev/framework/issues/738)) ([ee17c8f](https://github.com/ai-driven-dev/framework/commit/ee17c8ff4f17eabdb95b268589d2ddfd43c754fd))
+* **docs:** drop a product brief nothing reads and nothing checks ([#784](https://github.com/ai-driven-dev/framework/issues/784)) ([85cde89](https://github.com/ai-driven-dev/framework/commit/85cde892ab305bbf5a0aabb3869cc2de0c91f6b7))
+* **framework:** refresh the project memory reading list ([#728](https://github.com/ai-driven-dev/framework/issues/728)) ([08965f6](https://github.com/ai-driven-dev/framework/commit/08965f6ba51baa8e53a9a0f055d7e11c45b9347c))
+* **framework:** reshape the memory bank to its own templates ([#732](https://github.com/ai-driven-dev/framework/issues/732)) ([4fb582e](https://github.com/ai-driven-dev/framework/commit/4fb582e2408cb3cd3a90a83ddf6e2cc2f81dfb38))
+
+
+### Documentation
+
+* **telemetry:** a prompt axis says what it cannot name ([#769](https://github.com/ai-driven-dev/framework/issues/769)) ([aee5721](https://github.com/ai-driven-dev/framework/commit/aee5721b32fb12d3a58b762ad8a9d37fe5cd6b02))
+
+
+### Refactoring
+
+* **cli:** a --token travels as an argument, never through the process environment ([#802](https://github.com/ai-driven-dev/framework/issues/802)) ([0affca5](https://github.com/ai-driven-dev/framework/commit/0affca58e2efc0a4bff8c65365317dff8e032b87)), closes [#797](https://github.com/ai-driven-dev/framework/issues/797)
+
 ## [5.9.0](https://github.com/ai-driven-dev/framework/compare/v5.8.1...v5.9.0) (2026-08-28)
 
 
diff --git a/cli/CHANGELOG.md b/cli/CHANGELOG.md
index 4bcc1e21b..94ad83ed1 100644
--- a/cli/CHANGELOG.md
+++ b/cli/CHANGELOG.md
@@ -1,5 +1,58 @@
 # Changelog
 
+## [5.3.0](https://github.com/ai-driven-dev/framework/compare/cli-v5.2.2...cli-v5.3.0) (2026-09-09)
+
+
+### Features
+
+* **cli:** a record names the skill its own prompt invoked ([#783](https://github.com/ai-driven-dev/framework/issues/783)) ([7fbe889](https://github.com/ai-driven-dev/framework/commit/7fbe8897cee6ed522d1f52a2124c4109eb101543))
+* **cli:** one shared framework source per machine, user scope and session telemetry ([#795](https://github.com/ai-driven-dev/framework/issues/795)) ([95bdbbc](https://github.com/ai-driven-dev/framework/commit/95bdbbc3328262b72f5fd2b8034bc9630bf02e2f))
+* **cli:** the report answers the same from anywhere, and says how it knows ([#754](https://github.com/ai-driven-dev/framework/issues/754)) ([87af185](https://github.com/ai-driven-dev/framework/commit/87af18511a8dedf5e91f0099adda0bbde80dfbf7))
+* **framework:** measurement that works on five tools, each proven by a session that ran ([#706](https://github.com/ai-driven-dev/framework/issues/706)) ([627408f](https://github.com/ai-driven-dev/framework/commit/627408fba964b30d22b57fc99241083da1e0f294))
+* **telemetry:** a flow the tool named is a flow ([#768](https://github.com/ai-driven-dev/framework/issues/768)) ([37a6b2c](https://github.com/ai-driven-dev/framework/commit/37a6b2ce42bd598557baee8e41b8b9d8e98cda2d))
+* **telemetry:** a prompt is an axis, and the only one complete by construction ([#757](https://github.com/ai-driven-dev/framework/issues/757)) ([18ed39b](https://github.com/ai-driven-dev/framework/commit/18ed39ba3fe87fd115e77acf88b1c4e56c6de70d))
+* **telemetry:** a skill says when it is done, because nothing else can ([#756](https://github.com/ai-driven-dev/framework/issues/756)) ([cf66c22](https://github.com/ai-driven-dev/framework/commit/cf66c22856d3b00ad9ecc69582ad7b37f93e4401))
+
+
+### Bug Fixes
+
+* **cli:** a journal states the schema it was written in, and the reader reads it ([#776](https://github.com/ai-driven-dev/framework/issues/776)) ([5788ad8](https://github.com/ai-driven-dev/framework/commit/5788ad885958130cea4b7a2151bbdea75e03522d))
+* **cli:** a repair that repaired nothing says so ([#762](https://github.com/ai-driven-dev/framework/issues/762)) ([dccbef2](https://github.com/ai-driven-dev/framework/commit/dccbef25b43943904ec9a3cee3b5c2056d2cfdd6))
+* **cli:** a step outlives the pause inside it ([#775](https://github.com/ai-driven-dev/framework/issues/775)) ([9f19b94](https://github.com/ai-driven-dev/framework/commit/9f19b9403fb7ee4079f9bd9b2047b71fd0906991))
+* **cli:** a step's extent is only as strong as the evidence that closed it ([#777](https://github.com/ai-driven-dev/framework/issues/777)) ([af683f4](https://github.com/ai-driven-dev/framework/commit/af683f4d9640766e114bc28e28beab9bf7943823))
+* **cli:** activation leaves no permanent drift ([#773](https://github.com/ai-driven-dev/framework/issues/773)) ([462431a](https://github.com/ai-driven-dev/framework/commit/462431ab04e91ac94a8d126fef9d9d5753148ee6))
+* **cli:** an unreadable registry says so instead of crashing ([#787](https://github.com/ai-driven-dev/framework/issues/787)) ([25f0837](https://github.com/ai-driven-dev/framework/commit/25f08379303592e05f8d894099399f4166036e60))
+* **cli:** carry the catalog's recommended field under metadata, where Claude Code does not warn ([#803](https://github.com/ai-driven-dev/framework/issues/803)) ([4531b74](https://github.com/ai-driven-dev/framework/commit/4531b7466a03cd136764540e55f5c867dbdcafb5)), closes [#800](https://github.com/ai-driven-dev/framework/issues/800)
+* **cli:** check says whether the host will load what aidd installed ([#748](https://github.com/ai-driven-dev/framework/issues/748)) ([919aee3](https://github.com/ai-driven-dev/framework/commit/919aee3004c5ad33bb6cca8726a1c26aebc2aad4))
+* **cli:** clean removes the state it wrote ([#765](https://github.com/ai-driven-dev/framework/issues/765)) ([c73e793](https://github.com/ai-driven-dev/framework/commit/c73e7934fb08c49a50e4c63f495ccf294fa92da4))
+* **cli:** the commit trailer survives a hook another tool regenerates, and check says whether it did ([#749](https://github.com/ai-driven-dev/framework/issues/749)) ([5b222a3](https://github.com/ai-driven-dev/framework/commit/5b222a36ccec5c5224ea366f145f49888bd9a8fb))
+* **telemetry:** a counter says what was measured ([#786](https://github.com/ai-driven-dev/framework/issues/786)) ([1f1ae9e](https://github.com/ai-driven-dev/framework/commit/1f1ae9ee509123d55172cb1983cbe747ed9da5d4))
+* **telemetry:** a re-read stores nothing the same batch already wrote ([#758](https://github.com/ai-driven-dev/framework/issues/758)) ([a65bc81](https://github.com/ai-driven-dev/framework/commit/a65bc81f0987517b0199dd7703770f9bf6a622b6))
+* **telemetry:** a record can predate its journal, and must say so ([#759](https://github.com/ai-driven-dev/framework/issues/759)) ([39a4e84](https://github.com/ai-driven-dev/framework/commit/39a4e84bd5828bf2be1cc6c64831a1682271ad54))
+* **telemetry:** a step end names its skill either way ([#767](https://github.com/ai-driven-dev/framework/issues/767)) ([534d3db](https://github.com/ai-driven-dev/framework/commit/534d3db3ba68031cf82eea249b53f53c7a0555fa))
+* **telemetry:** a turn end is a pause for a flow too ([#763](https://github.com/ai-driven-dev/framework/issues/763)) ([ae70de6](https://github.com/ai-driven-dev/framework/commit/ae70de6c2bf7e691cdadd3f4351b80d90cbf400f))
+* **telemetry:** an agent row says who could be named ([#770](https://github.com/ai-driven-dev/framework/issues/770)) ([e4dc167](https://github.com/ai-driven-dev/framework/commit/e4dc16775f48c94f6a266471b0dab3bb466e1347))
+* **telemetry:** an identity names the work it already did ([#761](https://github.com/ai-driven-dev/framework/issues/761)) ([38a5d43](https://github.com/ai-driven-dev/framework/commit/38a5d43501b2b14b3b65ae723cf137ca8931a590))
+
+
+### Miscellaneous
+
+* **deps-dev:** bump @biomejs/biome from 2.5.10 to 2.5.11 in /cli ([#737](https://github.com/ai-driven-dev/framework/issues/737)) ([989ba00](https://github.com/ai-driven-dev/framework/commit/989ba0052cb85f70f2125b25916eb34da4bb727c))
+* **deps-dev:** bump @types/node from 26.2.0 to 26.4.0 in /cli ([#736](https://github.com/ai-driven-dev/framework/issues/736)) ([633d6cd](https://github.com/ai-driven-dev/framework/commit/633d6cd4eeed69b07d641d27077ee91e8002d880))
+* **deps-dev:** bump knip from 6.32.2 to 6.33.0 in /cli ([#740](https://github.com/ai-driven-dev/framework/issues/740)) ([9ed420c](https://github.com/ai-driven-dev/framework/commit/9ed420c7c75a87ead8c3f926e06279c0f39d76a3))
+* **deps-dev:** bump lefthook from 2.1.10 to 2.1.12 in /cli ([#739](https://github.com/ai-driven-dev/framework/issues/739)) ([9040636](https://github.com/ai-driven-dev/framework/commit/904063648eb0ee7dae98425ee39e6519481e9c95))
+* **deps:** bump @inquirer/prompts from 8.6.0 to 8.7.0 in /cli ([#738](https://github.com/ai-driven-dev/framework/issues/738)) ([ee17c8f](https://github.com/ai-driven-dev/framework/commit/ee17c8ff4f17eabdb95b268589d2ddfd43c754fd))
+
+
+### Documentation
+
+* **telemetry:** a prompt axis says what it cannot name ([#769](https://github.com/ai-driven-dev/framework/issues/769)) ([aee5721](https://github.com/ai-driven-dev/framework/commit/aee5721b32fb12d3a58b762ad8a9d37fe5cd6b02))
+
+
+### Refactoring
+
+* **cli:** a --token travels as an argument, never through the process environment ([#802](https://github.com/ai-driven-dev/framework/issues/802)) ([0affca5](https://github.com/ai-driven-dev/framework/commit/0affca58e2efc0a4bff8c65365317dff8e032b87)), closes [#797](https://github.com/ai-driven-dev/framework/issues/797)
+
 ## [5.2.2](https://github.com/ai-driven-dev/framework/compare/cli-v5.2.1...cli-v5.2.2) (2026-08-28)
 
 
diff --git a/cli/package.json b/cli/package.json
index 5b8a025ce..c308ca7c4 100644
--- a/cli/package.json
+++ b/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@ai-driven-dev/cli",
-  "version": "5.2.2",
+  "version": "5.3.0",
   "description": "AI-Driven Development CLI — install AI tool configs and plugins from the AIDD marketplace",
   "license": "MIT",
   "keywords": [
diff --git a/plugins/aidd-context/.claude-plugin/plugin.json b/plugins/aidd-context/.claude-plugin/plugin.json
index 180bdf3ed..6b5880a79 100644
--- a/plugins/aidd-context/.claude-plugin/plugin.json
+++ b/plugins/aidd-context/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "aidd-context",
-  "version": "2.7.0",
+  "version": "2.8.0",
   "description": "Knowledge production: project bootstrap, project init, generation of context artifacts (skills, agents, rules, commands, hooks), mermaid diagrams, learn, explore, recipe how-to sheets",
   "author": {
     "name": "AI-Driven Dev",
diff --git a/plugins/aidd-context/CHANGELOG.md b/plugins/aidd-context/CHANGELOG.md
index ff99aeee8..e89a141f1 100644
--- a/plugins/aidd-context/CHANGELOG.md
+++ b/plugins/aidd-context/CHANGELOG.md
@@ -1,5 +1,17 @@
 # Changelog
 
+## [2.8.0](https://github.com/ai-driven-dev/framework/compare/aidd-context-v2.7.0...aidd-context-v2.8.0) (2026-09-09)
+
+
+### Features
+
+* **cli:** one shared framework source per machine, user scope and session telemetry ([#795](https://github.com/ai-driven-dev/framework/issues/795)) ([95bdbbc](https://github.com/ai-driven-dev/framework/commit/95bdbbc3328262b72f5fd2b8034bc9630bf02e2f))
+
+
+### Miscellaneous
+
+* **framework:** reshape the memory bank to its own templates ([#732](https://github.com/ai-driven-dev/framework/issues/732)) ([4fb582e](https://github.com/ai-driven-dev/framework/commit/4fb582e2408cb3cd3a90a83ddf6e2cc2f81dfb38))
+
 ## [2.7.0](https://github.com/ai-driven-dev/framework/compare/aidd-context-v2.6.2...aidd-context-v2.7.0) (2026-08-28)
 
 
diff --git a/plugins/aidd-dev/.claude-plugin/plugin.json b/plugins/aidd-dev/.claude-plugin/plugin.json
index ebf1ac51f..917597521 100644
--- a/plugins/aidd-dev/.claude-plugin/plugin.json
+++ b/plugins/aidd-dev/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "aidd-dev",
-  "version": "2.4.1",
+  "version": "2.5.0",
   "description": "Code transformation: plan, implement, assert, audit, review, test, refactor, debug, for-sure, plus short standalone Browser QA evidence. Hosts engineering agents.",
   "author": {
     "name": "AI-Driven Dev",
diff --git a/plugins/aidd-dev/CHANGELOG.md b/plugins/aidd-dev/CHANGELOG.md
index 541a934fb..d4382fc88 100644
--- a/plugins/aidd-dev/CHANGELOG.md
+++ b/plugins/aidd-dev/CHANGELOG.md
@@ -1,5 +1,23 @@
 # Changelog
 
+## [2.5.0](https://github.com/ai-driven-dev/framework/compare/aidd-dev-v2.4.1...aidd-dev-v2.5.0) (2026-09-09)
+
+
+### Features
+
+* **framework:** measurement that works on five tools, each proven by a session that ran ([#706](https://github.com/ai-driven-dev/framework/issues/706)) ([627408f](https://github.com/ai-driven-dev/framework/commit/627408fba964b30d22b57fc99241083da1e0f294))
+* **telemetry:** a skill says when it is done, because nothing else can ([#756](https://github.com/ai-driven-dev/framework/issues/756)) ([cf66c22](https://github.com/ai-driven-dev/framework/commit/cf66c22856d3b00ad9ecc69582ad7b37f93e4401))
+
+
+### Bug Fixes
+
+* **plugins:** a skill links only inside itself ([#772](https://github.com/ai-driven-dev/framework/issues/772)) ([1efb3d9](https://github.com/ai-driven-dev/framework/commit/1efb3d958897b88c9fde814d6e1e941f8978c519))
+
+
+### Miscellaneous
+
+* back-merge main into next (conflicts) ([#610](https://github.com/ai-driven-dev/framework/issues/610)) ([a923d56](https://github.com/ai-driven-dev/framework/commit/a923d5661bb63cccc53bad7e6744b27cbbdc0a05))
+
 ## [2.4.1](https://github.com/ai-driven-dev/framework/compare/aidd-dev-v2.4.0...aidd-dev-v2.4.1) (2026-08-07)
 
 
diff --git a/plugins/aidd-orchestrator/.claude-plugin/plugin.json b/plugins/aidd-orchestrator/.claude-plugin/plugin.json
index 9f4c14305..e10536d57 100644
--- a/plugins/aidd-orchestrator/.claude-plugin/plugin.json
+++ b/plugins/aidd-orchestrator/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "aidd-orchestrator",
-  "version": "2.2.1",
+  "version": "2.3.0",
   "description": "Orchestrates the synchronous SDLC pipeline, async issue-to-PR automation, and the product backlog.",
   "author": {
     "name": "AI-Driven Dev",
diff --git a/plugins/aidd-orchestrator/CHANGELOG.md b/plugins/aidd-orchestrator/CHANGELOG.md
index 4598cf5d2..c44814685 100644
--- a/plugins/aidd-orchestrator/CHANGELOG.md
+++ b/plugins/aidd-orchestrator/CHANGELOG.md
@@ -1,5 +1,18 @@
 # Changelog
 
+## [2.3.0](https://github.com/ai-driven-dev/framework/compare/aidd-orchestrator-v2.2.1...aidd-orchestrator-v2.3.0) (2026-09-09)
+
+
+### Features
+
+* **framework:** measurement that works on five tools, each proven by a session that ran ([#706](https://github.com/ai-driven-dev/framework/issues/706)) ([627408f](https://github.com/ai-driven-dev/framework/commit/627408fba964b30d22b57fc99241083da1e0f294))
+* **orchestrator:** an orchestration says when it is done ([#764](https://github.com/ai-driven-dev/framework/issues/764)) ([feddad9](https://github.com/ai-driven-dev/framework/commit/feddad95e138eedd8be935b8c01b65abe6485b4d))
+
+
+### Miscellaneous
+
+* back-merge main into next (conflicts) ([#610](https://github.com/ai-driven-dev/framework/issues/610)) ([a923d56](https://github.com/ai-driven-dev/framework/commit/a923d5661bb63cccc53bad7e6744b27cbbdc0a05))
+
 ## [2.2.1](https://github.com/ai-driven-dev/framework/compare/aidd-orchestrator-v2.2.0...aidd-orchestrator-v2.2.1) (2026-08-07)
 
 
diff --git a/plugins/aidd-pm/.claude-plugin/plugin.json b/plugins/aidd-pm/.claude-plugin/plugin.json
index 4f9952563..3847d63ed 100644
--- a/plugins/aidd-pm/.claude-plugin/plugin.json
+++ b/plugins/aidd-pm/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "aidd-pm",
-  "version": "2.4.2",
+  "version": "2.5.0",
   "description": "Product backlog artifacts, refinement, Product Briefs, Epics, User Stories, Tasks, Spikes, Defects, requirements, and specs.",
   "author": {
     "name": "AI-Driven Dev",
diff --git a/plugins/aidd-pm/CHANGELOG.md b/plugins/aidd-pm/CHANGELOG.md
index 5fd3b6906..37bb18094 100644
--- a/plugins/aidd-pm/CHANGELOG.md
+++ b/plugins/aidd-pm/CHANGELOG.md
@@ -1,5 +1,17 @@
 # Changelog
 
+## [2.5.0](https://github.com/ai-driven-dev/framework/compare/aidd-pm-v2.4.2...aidd-pm-v2.5.0) (2026-09-09)
+
+
+### Features
+
+* **framework:** measurement that works on five tools, each proven by a session that ran ([#706](https://github.com/ai-driven-dev/framework/issues/706)) ([627408f](https://github.com/ai-driven-dev/framework/commit/627408fba964b30d22b57fc99241083da1e0f294))
+
+
+### Miscellaneous
+
+* back-merge main into next (conflicts) ([#641](https://github.com/ai-driven-dev/framework/issues/641)) ([7d2d390](https://github.com/ai-driven-dev/framework/commit/7d2d390057c2e93f5160f068d038adf306405a17))
+
 ## [2.4.2](https://github.com/ai-driven-dev/framework/compare/aidd-pm-v2.4.1...aidd-pm-v2.4.2) (2026-08-14)
 
 
diff --git a/plugins/aidd-refine/.claude-plugin/plugin.json b/plugins/aidd-refine/.claude-plugin/plugin.json
index 1833b63e2..b462339b4 100644
--- a/plugins/aidd-refine/.claude-plugin/plugin.json
+++ b/plugins/aidd-refine/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "aidd-refine",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "Meta-cognition: refine input through brainstorming, refine output through challenge, blind-spot scanning, and fact-checking.",
   "author": {
     "name": "AI-Driven Dev",
diff --git a/plugins/aidd-refine/CHANGELOG.md b/plugins/aidd-refine/CHANGELOG.md
index b9fc934b0..8cebd303f 100644
--- a/plugins/aidd-refine/CHANGELOG.md
+++ b/plugins/aidd-refine/CHANGELOG.md
@@ -1,5 +1,12 @@
 # Changelog
 
+## [3.0.1](https://github.com/ai-driven-dev/framework/compare/aidd-refine-v3.0.0...aidd-refine-v3.0.1) (2026-09-09)
+
+
+### Miscellaneous
+
+* back-merge main into next (conflicts) ([#641](https://github.com/ai-driven-dev/framework/issues/641)) ([7d2d390](https://github.com/ai-driven-dev/framework/commit/7d2d390057c2e93f5160f068d038adf306405a17))
+
 ## [3.0.0](https://github.com/ai-driven-dev/framework/compare/aidd-refine-v2.2.4...aidd-refine-v3.0.0) (2026-08-14)
 
 
diff --git a/plugins/aidd-telemetry/.claude-plugin/plugin.json b/plugins/aidd-telemetry/.claude-plugin/plugin.json
index 653b88ed3..47f126bf6 100644
--- a/plugins/aidd-telemetry/.claude-plugin/plugin.json
+++ b/plugins/aidd-telemetry/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "aidd-telemetry",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Measurement. The hooks journal which skill served which task, on plain node with nothing installed; three skills reach the `aidd` CLI to turn it on, answer what a period or a task consumed, and check it is recording. Off unless you turn it on, and it computes no amount.",
   "author": {
     "name": "AI-Driven Dev",
diff --git a/plugins/aidd-telemetry/CHANGELOG.md b/plugins/aidd-telemetry/CHANGELOG.md
index 825c32f0d..8c37726ff 100644
--- a/plugins/aidd-telemetry/CHANGELOG.md
+++ b/plugins/aidd-telemetry/CHANGELOG.md
@@ -1 +1,32 @@
 # Changelog
+
+## [0.2.0](https://github.com/ai-driven-dev/framework/compare/aidd-telemetry-v0.1.0...aidd-telemetry-v0.2.0) (2026-09-09)
+
+
+### Features
+
+* **cli:** one shared framework source per machine, user scope and session telemetry ([#795](https://github.com/ai-driven-dev/framework/issues/795)) ([95bdbbc](https://github.com/ai-driven-dev/framework/commit/95bdbbc3328262b72f5fd2b8034bc9630bf02e2f))
+* **cli:** the report answers the same from anywhere, and says how it knows ([#754](https://github.com/ai-driven-dev/framework/issues/754)) ([87af185](https://github.com/ai-driven-dev/framework/commit/87af18511a8dedf5e91f0099adda0bbde80dfbf7))
+* **framework:** measurement that works on five tools, each proven by a session that ran ([#706](https://github.com/ai-driven-dev/framework/issues/706)) ([627408f](https://github.com/ai-driven-dev/framework/commit/627408fba964b30d22b57fc99241083da1e0f294))
+* **telemetry:** a flow the tool named is a flow ([#768](https://github.com/ai-driven-dev/framework/issues/768)) ([37a6b2c](https://github.com/ai-driven-dev/framework/commit/37a6b2ce42bd598557baee8e41b8b9d8e98cda2d))
+* **telemetry:** a prompt is an axis, and the only one complete by construction ([#757](https://github.com/ai-driven-dev/framework/issues/757)) ([18ed39b](https://github.com/ai-driven-dev/framework/commit/18ed39ba3fe87fd115e77acf88b1c4e56c6de70d))
+* **telemetry:** a skill says when it is done, because nothing else can ([#756](https://github.com/ai-driven-dev/framework/issues/756)) ([cf66c22](https://github.com/ai-driven-dev/framework/commit/cf66c22856d3b00ad9ecc69582ad7b37f93e4401))
+
+
+### Bug Fixes
+
+* **cli:** a journal states the schema it was written in, and the reader reads it ([#776](https://github.com/ai-driven-dev/framework/issues/776)) ([5788ad8](https://github.com/ai-driven-dev/framework/commit/5788ad885958130cea4b7a2151bbdea75e03522d))
+* **cli:** check says whether the host will load what aidd installed ([#748](https://github.com/ai-driven-dev/framework/issues/748)) ([919aee3](https://github.com/ai-driven-dev/framework/commit/919aee3004c5ad33bb6cca8726a1c26aebc2aad4))
+* **cli:** the commit trailer survives a hook another tool regenerates, and check says whether it did ([#749](https://github.com/ai-driven-dev/framework/issues/749)) ([5b222a3](https://github.com/ai-driven-dev/framework/commit/5b222a36ccec5c5224ea366f145f49888bd9a8fb))
+* **plugins:** a skill links only inside itself ([#772](https://github.com/ai-driven-dev/framework/issues/772)) ([1efb3d9](https://github.com/ai-driven-dev/framework/commit/1efb3d958897b88c9fde814d6e1e941f8978c519))
+* **telemetry:** a record can predate its journal, and must say so ([#759](https://github.com/ai-driven-dev/framework/issues/759)) ([39a4e84](https://github.com/ai-driven-dev/framework/commit/39a4e84bd5828bf2be1cc6c64831a1682271ad54))
+* **telemetry:** a second export is a second plugin ([#785](https://github.com/ai-driven-dev/framework/issues/785)) ([ba845f8](https://github.com/ai-driven-dev/framework/commit/ba845f86227599038be67fcf9c7736c4722a0502))
+* **telemetry:** an agent row says who could be named ([#770](https://github.com/ai-driven-dev/framework/issues/770)) ([e4dc167](https://github.com/ai-driven-dev/framework/commit/e4dc16775f48c94f6a266471b0dab3bb466e1347))
+* **telemetry:** an identity names the work it already did ([#761](https://github.com/ai-driven-dev/framework/issues/761)) ([38a5d43](https://github.com/ai-driven-dev/framework/commit/38a5d43501b2b14b3b65ae723cf137ca8931a590))
+
+
+### Documentation
+
+* **telemetry:** a prompt axis says what it cannot name ([#769](https://github.com/ai-driven-dev/framework/issues/769)) ([aee5721](https://github.com/ai-driven-dev/framework/commit/aee5721b32fb12d3a58b762ad8a9d37fe5cd6b02))
+
+## Changelog
diff --git a/plugins/aidd-vcs/.claude-plugin/plugin.json b/plugins/aidd-vcs/.claude-plugin/plugin.json
index db7ac449f..b91bcf8a1 100644
--- a/plugins/aidd-vcs/.claude-plugin/plugin.json
+++ b/plugins/aidd-vcs/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "aidd-vcs",
-  "version": "2.3.1",
+  "version": "2.3.2",
   "description": "External artifacts: repo-init, commit, pull-request, release-tag, issue-create",
   "author": {
     "name": "AI-Driven Dev",
diff --git a/plugins/aidd-vcs/CHANGELOG.md b/plugins/aidd-vcs/CHANGELOG.md
index fc7bd7d0a..2db9253e6 100644
--- a/plugins/aidd-vcs/CHANGELOG.md
+++ b/plugins/aidd-vcs/CHANGELOG.md
@@ -1,5 +1,12 @@
 # Changelog
 
+## [2.3.2](https://github.com/ai-driven-dev/framework/compare/aidd-vcs-v2.3.1...aidd-vcs-v2.3.2) (2026-09-09)
+
+
+### Miscellaneous
+
+* back-merge main into next (conflicts) ([#610](https://github.com/ai-driven-dev/framework/issues/610)) ([a923d56](https://github.com/ai-driven-dev/framework/commit/a923d5661bb63cccc53bad7e6744b27cbbdc0a05))
+
 ## [2.3.1](https://github.com/ai-driven-dev/framework/compare/aidd-vcs-v2.3.0...aidd-vcs-v2.3.1) (2026-08-07)