feat(framework): measurement that works on five tools, each proven by a session that ran

.claude-plugin/marketplace.json

@@ -55,6 +55,13 @@
       "description": "ALPHA, not ready for use. UI and UX concern: design, review, and improve frontend interfaces.",
       "strict": true,
       "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. Ships hooks only, and carries no measurement itself.",
+      "strict": true,
+      "recommended": false
     }
   ]
 }

.claude/settings.json

@@ -1,18 +1,5 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-settings.json",
-  "extraKnownMarketplaces": {
-    "aidd-framework": {
-      "source": { "source": "directory", "path": "." }
-    }
-  },
-  "enabledPlugins": {
-    "aidd-context@aidd-framework": true,
-    "aidd-dev@aidd-framework": true,
-    "aidd-vcs@aidd-framework": true,
-    "aidd-pm@aidd-framework": true,
-    "aidd-orchestrator@aidd-framework": true,
-    "aidd-refine@aidd-framework": true
-  },
   "hooks": {
     "WorktreeCreate": [
       {
@@ -24,5 +11,21 @@
         ]
       }
     ]
+  },
+  "enabledPlugins": {
+    "aidd-context@aidd-framework": true,
+    "aidd-dev@aidd-framework": true,
+    "aidd-vcs@aidd-framework": true,
+    "aidd-pm@aidd-framework": true,
+    "aidd-orchestrator@aidd-framework": true,
+    "aidd-refine@aidd-framework": true
+  },
+  "extraKnownMarketplaces": {
+    "aidd-framework": {
+      "source": {
+        "source": "directory",
+        "path": "."
+      }
+    }
   }
 }

.github/workflows/cli-ci.yml

@@ -13,10 +13,18 @@ on:
     paths:
       - "cli/**"
       - "kanban/**"
+      # The plugin ships the hooks and skills these jobs exercise, and the Windows job
+      # exists for them in particular - without this, changing any of it runs nothing.
+      - "plugins/aidd-telemetry/**"
+      - "scripts/__tests__/**"
   pull_request:
     paths:
       - "cli/**"
       - "kanban/**"
+      # The plugin ships the hooks and skills these jobs exercise, and the Windows job
+      # exists for them in particular - without this, changing any of it runs nothing.
+      - "plugins/aidd-telemetry/**"
+      - "scripts/__tests__/**"
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
@@ -140,3 +148,61 @@ jobs:
       - run: cd kanban && pnpm typecheck
       - run: cd kanban && pnpm lint
       - run: cd kanban && pnpm test
+
+  windows:
+    # Runs under bash (Git Bash, bundled on windows-latest) so every command is the one the
+    # Linux jobs run, not a PowerShell rewrite of it.
+    name: cli / Windows
+    runs-on: windows-latest
+    defaults:
+      run:
+        shell: bash
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - name: Install pnpm
+        run: |
+          corepack enable
+          corepack prepare pnpm@latest --activate
+      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+        with:
+          node-version: "22"
+
+      # The chain end to end, on the platform where a home directory, a line ending and an
+      # absolute path all resolve differently than they do on the Linux jobs above.
+      - name: Chain - switch telemetry on
+        run: node plugins/aidd-telemetry/skills/00-init/scripts/telemetry-switch.cjs on
+      - name: Chain - journal a captured payload
+        run: |
+          # The fixture's own cwd is a path from whatever machine captured it - rewritten to
+          # this checkout's real path so getRepoRoot resolves a repository that exists here.
+          node -e "const p=require('./scripts/__tests__/fixtures/claude-code-session-start.json'); p.cwd=process.cwd(); require('fs').writeFileSync('payload.json', JSON.stringify(p));"
+          node plugins/aidd-telemetry/hooks/journal.cjs session-start < payload.json
+          node plugins/aidd-telemetry/hooks/journal.cjs turn-end < payload.json
+      - name: Chain - the journal stays private and git add -A still works
+        run: |
+          git add -A
+          git status --porcelain >/dev/null
+      - name: Chain - read it back
+        run: |
+          node plugins/aidd-telemetry/skills/01-cost/scripts/telemetry-report.cjs read
+          node plugins/aidd-telemetry/skills/01-cost/scripts/telemetry-report.cjs report
+      - name: Chain - diagnose
+        run: node plugins/aidd-telemetry/skills/02-check/scripts/telemetry-check.cjs
+
+      - name: Plugin suite
+        run: node --test "scripts/__tests__/*.test.js"
+
+      - run: cd kanban && pnpm install --frozen-lockfile
+      - run: cd cli && pnpm install --frozen-lockfile
+      - run: cd cli && pnpm test:unit
+      - run: cd cli && pnpm test:integration
+      - name: cli e2e
+        run: |
+          cd cli
+          pnpm build
+          pnpm exec vitest run --project=e2e \
+            --exclude "tests/e2e/persona.e2e.test.ts" \
+            --exclude "tests/e2e/telemetry-multi-tool.e2e.test.ts"
+        # persona.e2e.test.ts hardcodes /usr/bin/expect for TTY emulation, which windows-latest
+        # does not carry. telemetry-multi-tool.e2e.test.ts puts a `#!/bin/sh` stand-in binary
+        # with no extension on PATH; Windows resolves an executable by PATHEXT, never a shebang.

.gitignore

@@ -32,6 +32,22 @@ coverage/
 .claude/settings.local.json
 .claude/worktrees/
 
+# AIDD CLI's own local state (install manifest, auth): machine-local, never
+# part of the project's own tracked content. config.json is the exception:
+# it is the committed telemetry switch (see .aidd/config.json and
+# aidd_docs/tasks/2026_08/2026_08_20_telemetry-export-enable/phase-1.md),
+# tracked so a fresh clone inherits the project's decision.
+.aidd/*
+!.aidd/config.json
+
+# AIDD run-journal records: where they land once .aidd/config.json turns
+# telemetry on (see plugins/aidd-telemetry/hooks/journal.js) - this
+# directory being committed is a location, not a permission. The records it
+# holds never are.
+aidd_docs/runs/*
+!aidd_docs/runs/.gitkeep
+!aidd_docs/runs/README.md
+
 # SpecStory captures (may contain transcripts / secrets)
 .specstory/
 

.release-please-manifest.json

@@ -7,5 +7,6 @@
   "plugins/aidd-orchestrator": "2.2.1",
   "plugins/aidd-refine": "3.0.0",
   "plugins/aidd-ui": "0.2.1-alpha.0",
+  "plugins/aidd-telemetry": "0.1.0",
   "cli": "5.2.1"
 }

README.md

@@ -11,7 +11,7 @@ Unify **engineering teams** around **standardized workflows** and **shared best
 🧱 **IDE agnostic** · 🏗️ **Legacy systems** · 🌱 **Token-optimized** · 🇫🇷 **Made in France**
 
 <p>
-  <!--counts:start--><kbd>7 plugins</kbd> · <kbd>47 skills</kbd> · <kbd>2 agents</kbd><!--counts:end-->
+  <!--counts:start--><kbd>8 plugins</kbd> · <kbd>50 skills</kbd> · <kbd>2 agents</kbd><!--counts:end-->
 </p>
 
 [![Open Source](https://img.shields.io/badge/Open_Source-Yes-yellow?logo=open-source-initiative&logoColor=white)](https://opensource.org/)
@@ -57,7 +57,7 @@ Why not just write your own commands? → [FAQ](docs/FAQ.md#-why-aidd-instead-of
 
 ### Claude Code
 
-Installs the 6 stable plugins (`aidd-ui` is 🚧 alpha, install separately — see [Plugins](#-plugins)).
+Installs the 6 stable plugins (`aidd-ui` and `aidd-telemetry` are 🚧 alpha, install separately — see [Plugins](#-plugins)).
 
 **In the session** (slash commands)
 
@@ -213,7 +213,7 @@ flowchart TD
 
 ## 🧩 Plugins
 
-Seven plugins covering the whole SDLC — **install all of them**; they work together. (`aidd-ui` is 🚧 **alpha**, off the curated path.)
+Eight plugins covering the whole SDLC — **install all of them**; they work together. (`aidd-ui` and `aidd-telemetry` are 🚧 **alpha**, off the curated path.)
 
 <table>
 <tr>
@@ -284,7 +284,15 @@ Synchronous feature flow, async issue-to-PR automation, and product backlog.
 UI / UX design — smoke-test only, not ready for use.
 
 </td>
-<td width="33%" valign="top"></td>
+<td width="33%" valign="top">
+
+### 📈 [aidd-telemetry](plugins/aidd-telemetry/README.md) 🚧
+
+`3 skills` · **alpha**
+
+Answers what a piece of work cost — tokens, models, and which skill spent them. Off unless you turn it on, and nothing leaves your machine.
+
+</td>
 <td width="33%" valign="top"></td>
 </tr>
 </table>

aidd_docs/memory/testing.md

@@ -6,12 +6,16 @@
 
 ## Testing Strategy
 
-- No unit test runner configured at framework level
+- The CLI runs vitest in three projects: `unit`, `integration`, `e2e` (`cli/`, ~2,600 tests)
+- The plugins' own scripts run under `node --test`, in `scripts/__tests__/`, reaching their subject by path rather than by import
 - Skills are validated by running each action's `## Test` end-to-end against a real environment
 - Framework correctness validated by running actual skills against a real project (integration)
 
 ## Test Execution Process
 
+- **While working, run `pnpm test:changed`** — it runs only the specs a change can break: vitest resolves the CLI's import graph, and the plugin specs are selected by the paths their own text names. Minutes become seconds, and nothing that could break is skipped
+- Before declaring work done, run the full suites: `cd cli && pnpm test:unit && pnpm test:integration && pnpm test:e2e`, plus `node --test "scripts/__tests__/*.test.js"`
+- Run biome through `rtk proxy` (`rtk proxy npx biome check src/ tests/`): the plain call's output is filtered and reports "no issues" while errors are pending
 - Each action declares a `## Test` (a command to run, an artifact check, or an observable side-effect) that must pass before the next action runs
 - `scripts/build-dist-verification.md` documents how to verify the build output