@event4u/agent-config 1.13.0 → 1.15.0

package/CHANGELOG.md

@@ -7,6 +7,615 @@ versioning policy is documented in [CONTRIBUTING.md](CONTRIBUTING.md#versioning-
 > Entries before 1.3.3 were reconstructed from git history after the fact.
 > Early releases did not maintain release notes.
 
+## [Unreleased]
+
+Three roadmaps land in this release.
+
+**Universal Execution Engine (R1)** — the `/implement-ticket` runtime is
+renamed and re-shaped into a universal dispatcher. **No user-visible
+behavior change** — the `/implement-ticket` slash command and the
+`./agent-config implement-ticket` CLI are byte-stable, gated by the
+new Golden-Transcript replay harness.
+
+**Prompt-Driven Execution (R2)** — a new `/work` command drives free-form
+prompts through the same `work_engine` dispatcher with a
+confidence-band gate at `refine`. R1 goldens remain byte-equal across
+the R2 changes.
+
+**Product UI Track (R3)** — three new directive sets (`ui`,
+`ui-trivial`, `mixed`) turn UI work from "writes the code" into
+"produces UI that feels designed". An existing-UI audit is enforced
+as a hard gate before any `apply`; design briefs lock microcopy
+verbatim; polish has a 2-round ceiling. Stack-aware dispatch routes
+implementation to `blade-livewire-flux` / `react-shadcn` / `vue` /
+`plain` skill bundles. Happy-path halt budget is 2 (audit pick +
+design sign-off). R1 + R2 goldens stay byte-equal; 12 new GT-U
+baselines pin the R3 contract.
+
+### Features
+
+* **engine:** universal `work_engine` Python module with explicit
+  `version: 1` state schema, `directive_set` envelope (backend / ui-stub
+  / mixed-stub), and `input.kind`-based dispatch ready for prompt-driven
+  and UI directives in R2 / R3.
+* **migration:** `work_engine.migration.v0_to_v1` auto-migrates
+  `.implement-ticket-state.json` → `.work-state.json` on first run;
+  v0 file preserved as `.implement-ticket-state.json.bak`. Idempotent
+  and refuses to overwrite an existing v1 destination.
+* **tests:** Golden-Transcript replay harness with 5 live-captured
+  baseline transcripts (`tests/golden/baseline/GT-{1..5}/`),
+  `CHECKSUMS.txt` SHA-256 manifest, four strict comparators
+  (exit codes, state-snapshot structure, halt-marker shape, delivery
+  report headings) with allow-listed free-text drift on `questions`
+  and `report` bodies. Both pytest (`tests/golden/test_replay.py`) and
+  CLI (`python3 -m tests.golden.harness`) entry points.
+* **command:** `/work` — sibling entrypoint to `/implement-ticket` that
+  drives free-form prompts through the same `work_engine` dispatcher
+  with `input.kind="prompt"`. Backed by the `command-routing` and
+  `refine-prompt` skills.
+* **engine (R2):** prompt resolver (`work_engine.resolvers.prompt`)
+  builds the prompt envelope; `directives/backend/refine.py::_run_prompt`
+  reconstructs acceptance criteria, scores the prompt on five
+  dimensions, and dispatches on the resulting band.
+* **scoring:** deterministic, heuristic-only confidence scorer at
+  `work_engine.scoring.confidence` — single source of truth for the
+  rubric (`goal_clarity`, `scope_boundary`, `ac_evidence`, `stack_data`,
+  `reversibility`) and band thresholds (`high ≥ 0.8`, `medium ≥ 0.5`,
+  `low < 0.5`).
+* **band-action gate:** silent proceed on `high`, assumptions-report
+  halt on `medium`, one-question halt on `low` (per the
+  `ask-when-uncertain` Iron Law).
+* **tests (R2):** four new Golden Transcripts (`GT-P1` high-band happy,
+  `GT-P2` medium-band release, `GT-P3` low-band one-question halt,
+  `GT-P4` UI-intent rejection — superseded by the R3 UI track but kept
+  to pin pre-R3 behaviour) pinned alongside the R1 goldens.
+
+### Changed
+
+* **engine (refactor):** internal Python module renamed
+  `implement_ticket` → `work_engine`. Public CLI surface, slash command,
+  user-facing prompts, halts, and delivery report are unchanged. State
+  filename moves from `.implement-ticket-state.json` to `.work-state.json`
+  with auto-migration.
+* **engine (R2):** `refine` SUCCESS paths now mirror
+  `data["reconstructed_ac"]` into `state.ticket["acceptance_criteria"]`
+  as an independent list copy, so downstream gates (`analyze`, `plan`)
+  read the same AC slot regardless of envelope kind.
+
+### Deprecated
+
+* **`implement_ticket` Python module** — re-export shim retained for
+  backwards compatibility; emits `DeprecationWarning` on import.
+  Internal Python consumers should migrate to `from work_engine import …`.
+  Removal is a separate user-driven decision, not pinned to a release.
+
+### CI
+
+* **freeze-guard:** named `task golden-replay` step in `Taskfile.yml`
+  and a dedicated `Golden Replay` step in `.github/workflows/tests.yml`,
+  both invoked before the main pytest sweep so structural regressions
+  surface first. Freeze-guard workflow rejects baseline edits outside
+  `R1-P1`-tagged commits.
+* **roadmap-progress-check** wired into `task ci` (1.13.0 carry-over).
+
+### Documentation
+
+* **ADR (R1):** [`agents/contexts/adr-work-engine-rename.md`](agents/contexts/adr-work-engine-rename.md)
+  — rationale, scope of the rename, compatibility shim policy, state
+  migration, golden-test contract, tradeoffs, non-goals.
+* **ADR (R2):** [`docs/contracts/adr-prompt-driven-execution.md`](docs/contracts/adr-prompt-driven-execution.md)
+  — naming decision (`/work` over `/do`), confidence-band gate,
+  AC-projection fix, R3 deferral boundary, and golden contract.
+* **flow:** `docs/contracts/implement-ticket-flow.md` gains a "Replay
+  protocol — Strict-Verb comparison" section (R1) and a
+  "Prompt envelopes and confidence bands (R2)" section pinning the
+  band-action mapping to the scorer module.
+* **README + AGENTS.md template:** document `/work` as the sibling
+  entrypoint, the confidence-band rubric, and the
+  `/work` vs. `/implement-ticket` selection rule.
+* **rules:** `scope-control` forbids release / version / deprecation-date
+  language in roadmaps, plans, and ADRs; introduces a `Decline = silence`
+  policy preventing branch-switch and PR proposals from being re-asked
+  on the same task.
+
+### Features (R3 — Product UI Track)
+
+* **directive sets:** `directives/ui/` (`audit → design → apply →
+  review → polish → report`), `directives/ui_trivial/` (provably
+  bounded edits, `MAX_FILES = 1` and `MAX_LINES_CHANGED = 5`), and
+  `directives/mixed/` (`contract → ui → stitch`). Dispatched at the
+  engine boundary on `state.directive_set`; the audit gate is enforced
+  at the dispatcher AND at always-on rule level
+  ([`ui-audit-before-build`](.agent-src/rules/ui-audit-before-build.md))
+  so cloud surfaces and free-form edits cannot bypass it.
+* **stack detection:** `scripts/work_engine/stack/detect.py` reads
+  `composer.json` + `package.json` and labels the frontend as
+  `blade-livewire-flux` / `react-shadcn` / `vue` / `plain`. Cached on
+  `state.stack` against manifest `mtime`; recoverable on parse error
+  (downgrades to `plain`). `apply` / `review` / `polish` route on the
+  label.
+* **audit gate:** `state.ui_audit` must carry `≥ 1 components_found`
+  OR `greenfield = True` with a user-chosen `greenfield_decision` ∈
+  `{scaffold, bare, external_reference}`. Empty dict, `None`, or
+  populated-without-keys is rejected; the dispatcher emits
+  `@agent-directive: existing-ui-audit` and refuses to advance.
+* **design brief lock:** `apply` rejects components carrying
+  `PLACEHOLDER_PATTERNS` (`<placeholder>`, `lorem`, `todo:`, `tbd`,
+  `xxx`); both producer and consumer enforce.
+* **polish ceiling:** hard `POLISH_CEILING = 2` rounds, validated at
+  in-memory state, on-disk schema, AND dispatcher layers. After round
+  2 the engine halts with ship-as-is / abort / hand-off.
+* **token-violation extraction:** polish classifies
+  `kind == "token_violation"` findings against
+  `state.ui_audit.design_tokens`; matched values use the named token,
+  unmatched values repeated > `TOKEN_REPEAT_THRESHOLD = 2` times
+  trigger token extraction before the next round.
+* **trivial-path reclassification:** `directives/ui_trivial/apply.py`
+  flips `state.directive_set = "ui"` when the bounded preconditions
+  fail, restarting the dispatcher at audit. Reclassification is loud
+  and counted in the delivery report.
+* **mixed orchestration:** sentinels `state.contract.contract_confirmed`
+  (UI sub-flow refuses to start without it) and
+  `state.stitch.verdict = "success"` (stitch's success condition;
+  `blocked` / `partial` halts unless `integration_confirmed` flips).
+* **skills:** new `existing-ui-audit`, `react-shadcn-ui`, plus
+  stack-specific apply / review / polish bundles. `fe-design`
+  repositioned as a framework-agnostic reference cited by
+  `directives/ui/design.py`.
+* **tests (R3):** twelve new Golden Transcripts (`GT-U1`..`GT-U4`,
+  `GT-U9`..`GT-U12`) covering high-confidence happy path
+  (1 halt budget), ambiguous (2 halts max), greenfield decisions,
+  trivial-path apply, polish ceiling hit, and mixed orchestration.
+  All R1 + R2 + R3 baselines auto-discovered by `tests/golden/test_replay.py`.
+
+### Documentation (R3)
+
+* **ADR (R3):** [`docs/contracts/adr-product-ui-track.md`](docs/contracts/adr-product-ui-track.md)
+  — audit-as-hard-gate rationale, design-review loop, halt-budget
+  reasoning, trivial-path-and-reclassification, stack-detection
+  strategy, fe-design migration, tradeoffs, non-goals.
+* **flow contract:** [`docs/contracts/ui-track-flow.md`](docs/contracts/ui-track-flow.md)
+  — slot-by-slot wiring for `ui` / `ui-trivial` / `mixed`, the
+  audit-path table (`STRONG_SIMILARITY = 0.7`, `TIE_GAP = 0.05`),
+  design-brief lock + placeholder patterns, stack-dispatch tables,
+  polish ceiling, trivial preconditions, mixed sentinels,
+  idempotency table, declared ambiguities across all eight directives.
+* **extension recipe:** [`docs/contracts/ui-stack-extension.md`](docs/contracts/ui-stack-extension.md)
+  — how to add a new stack (Svelte, SolidJS, Astro, …): label
+  conventions, detector heuristic, three required skills, dispatch
+  wiring, version anchor, Golden fixture, end-to-end verification.
+* **README + AGENTS.md template:** UI track flow table (`ui` /
+  `ui-trivial` / `mixed`), audit-gate property, design-brief lock,
+  polish ceiling, stack-dispatch summary; the pre-R3 "rejected,
+  backend-only" wording is removed.
+* **golden test capture:** [`tests/golden/CAPTURING.md`](tests/golden/CAPTURING.md)
+  — central regeneration recipe, lock policy, when to relock; replaces
+  17 per-baseline `reproduction-notes.md` files (the loadable artefacts
+  — `transcript.json`, `state-snapshots/`, `halt-markers.json`,
+  `exit-codes.json`, `delivery-report.md` — stay).
+
+### Archived (R3)
+
+* **roadmap:** `agents/roadmaps/intent-based-orchestration.md` moved to
+  `agents/roadmaps/archive/`; superseded by R1 + R2 + R3.
+
+**Artefact-Engagement Telemetry** — opt-in, default-off measurement layer
+that records which skills, rules, commands, and guidelines the agent
+consults and applies during a `/implement-ticket` or `/work` run.
+Maintainer-targeted; consumers see no prompts.
+
+### Features
+
+* **telemetry:** `./agent-config telemetry:record` and
+  `./agent-config telemetry:report` CLI scripts + `telemetry/` Python
+  package (boundary, aggregator, renderer, schema). Default-off via
+  `telemetry.artifact_engagement.enabled` in `.agent-settings.yml`.
+* **schema:** `schema_version: 1` JSONL events with `task_id`,
+  `boundary_kind`, `consulted` / `applied` (kind→ids), `ts`,
+  `tokens_estimate`. Aggregator silently skips lines with unknown
+  schema versions.
+* **report:** quartile bucketing on applied/consulted ratio — Essential
+  (top 20 %), Useful (mid 60 %), Retirement Candidates (bottom 20 %) —
+  emitted as Markdown or JSON.
+* **rule:** `artifact-engagement-recording` — fires per phase-step
+  inside `/implement-ticket` and `/work`; no-op under the default-off
+  gate so the recording path costs nothing when disabled.
+* **privacy:** `check_id_redaction` validator enforces a redaction
+  floor (no path separators, no file extensions, no control characters,
+  no whitespace, non-empty) on **both** write and export. Tampered or
+  legacy logs cannot leak through reports — renderer re-validates.
+* **tests:** 36 redaction test cases plus end-to-end CLI coverage
+  in `tests/telemetry/`.
+
+### Documentation
+
+* **ADR:** [`agents/contexts/adr-artifact-engagement.md`](agents/contexts/adr-artifact-engagement.md)
+  — rationale, default-off doctrine, privacy contract, schema
+  versioning, deprecation horizon.
+* **flow:** `docs/contracts/artifact-engagement-flow.md` is the
+  cross-cutting reference for what gets recorded, when, and under
+  which constraints; includes the maintainer hand-audit recipe.
+* **AGENTS.md + README.md:** short *Maintainer telemetry (opt-in)*
+  pointer; consumers see nothing.
+* **`/onboard`:** Step 9 emits a one-screen maintainer-only hint
+  describing the feature; no question, no prompt.
+
+**Context-Aware Command Suggestion** — deterministic, read-only layer
+that surfaces eligible slash commands as numbered options when a
+non-`/`-prefixed user prompt matches their `suggestion.trigger_*`
+frontmatter. **Nothing auto-executes** — the user picks every time;
+the as-is option is always present and always last.
+
+### Features
+
+* **engine:** `scripts/command_suggester/` Python package
+  (`match` / `rank` / `cooldown` / `sanitize` / `render` / `loader`).
+  Heuristic-only scoring (substring + Jaccard token overlap +
+  structural-bonus boosts), per-conversation cooldown keyed on
+  `(command, evidence)`, and a sanitiser that strips fenced + inline
+  code blocks plus the suggester's own previous block shape before
+  scoring.
+* **rule:** `command-suggestion` (always-on) — emits one
+  numbered-options block per turn under the `user-interaction` Iron
+  Law. Subordinate to `scope-control`, `ask-when-uncertain`,
+  `verify-before-complete`, and any active role-mode contract or
+  engine halt; on conflict → silent.
+* **frontmatter:** every command carries
+  `suggestion.eligible` (default `true`) plus a flat
+  `trigger_description` + `trigger_context` pair (linter-validated,
+  ≥ 10 chars each). Locked eligibility table at
+  [`agents/contexts/command-suggestion-eligibility.md`](agents/contexts/command-suggestion-eligibility.md).
+* **settings:** `commands.suggestion` block in
+  `.agent-settings.yml` — `enabled` (global), `blocklist`
+  (per-command), `confidence_floor` (default `0.6`), `cooldown`
+  (default `10m`), `max_options` (default `4`, plus the always-extra
+  as-is option). Per-command overrides via frontmatter.
+* **opt-out paths (3):** global (`enabled: false`), per-command
+  (`blocklist`), per-conversation (`/command-suggestion-off` /
+  `/command-suggestion-on` directives detected by `cooldown.py`).
+* **anti-noise heuristics:** sub-floor suppression, lonely-match
+  guard within `floor + 0.1`, vague-prompt guard (< 6 words +
+  > 2 matches without structural bonus), continuation-phrase guard
+  (`ok`, `weiter`, `continue`, …). Structural bonuses (ticket key,
+  file path) override every suppressor.
+* **tests:** 84 unit cases in `tests/test_command_suggester.py`
+  (matcher, rank, cooldown, sanitiser, render, settings, directive)
+  plus 9 GT-CS goldens in `tests/test_command_suggester_goldens.py`
+  (single-match, tie-break, sub-floor, slash-bypass, as-is pick,
+  cooldown, settings off, clarification-wins, adversarial echo).
+* **no behavioural change to slash invocation:** explicit `/command`
+  bypasses the suggester entirely; per-command halts intact.
+
+### Documentation
+
+* **ADR:** [`docs/contracts/adr-command-suggestion.md`](docs/contracts/adr-command-suggestion.md)
+  — "suggest, never invoke" anchor, eligibility rubric, anti-noise
+  heuristics, hardening list, three opt-out paths.
+* **flow:** [`docs/contracts/command-suggestion-flow.md`](docs/contracts/command-suggestion-flow.md)
+  — scoring breakdown, evidence semantics, subordination order, and
+  hardening tests.
+* **README + AGENTS.md:** short *Context-aware command suggestion*
+  section pointing to the ADR and the flow doc.
+
+**Install-path pruning (relabel only)** — `docs/installation.md`
+reorders install paths by recommendation prominence. Composer + npm
+remain the default; manual / submodule / VS Code Git URL are tagged
+`advanced`; Claude.ai Web Skills UI is tagged `experimental`; Linear
+AI workspace guidance is tagged `staged`. **No installer or shipped
+artefact is removed in 1.15.0** — every path on the page still works
+and is still tested. The labels describe how prominent the path is in
+our recommendation order, not its support status.
+
+### Documentation
+
+* **`docs/installation.md`:** new label table at the top
+  (`(no label)` / `advanced` / `experimental` / `staged`) plus a
+  preamble that calls out the no-removal contract explicitly. Section
+  headers carry their label inline for skim-readers.
+* **rationale:** see R9 in
+  [`agents/roadmaps/archive/road-to-post-pr29-optimize.md`](agents/roadmaps/archive/road-to-post-pr29-optimize.md)
+  — relabelling addresses the "four install paths at zero external
+  users" tension without removing any path that an existing user
+  might rely on.
+
+## [1.15.0](https://github.com/event4u-app/agent-config/compare/1.14.0...1.15.0) (2026-05-02)
+
+### Features
+
+* **governance:** rule-interaction matrix + linter (P2.2) ([cd68591](https://github.com/event4u-app/agent-config/commit/cd6859174d289737b829fe49a4c7f92bd318a290))
+* **rules:** split chat-history into ownership/cadence/visibility (P2.1) ([7b5348d](https://github.com/event4u-app/agent-config/commit/7b5348d2656c12000fca667c2e577c026839aa11))
+* **governance:** command-collapse contract + atomic-command linter (P0.8) ([5f1ebb7](https://github.com/event4u-app/agent-config/commit/5f1ebb72484da28679f7a49fffc5cbb4bd7a07f6))
+* **work_engine:** default state file → .work-state.json + collision-safe backup ([b0f487a](https://github.com/event4u-app/agent-config/commit/b0f487a3f261797320b3726211206f813f2c2c1a))
+* **docs:** public contracts to docs/contracts/ + STABILITY policy + link checker ([7c6ac17](https://github.com/event4u-app/agent-config/commit/7c6ac17609d19505625cb4fa9a76798a403997ad))
+* support capture-only roadmaps in dashboard generator ([c0df2dc](https://github.com/event4u-app/agent-config/commit/c0df2dc3c680a6cfa6c87f2e64868360695fa3ec))
+
+### Bug Fixes
+
+* **rules:** restore Iron Law heading + code blocks in compressed roadmap-progress-sync ([96c633b](https://github.com/event4u-app/agent-config/commit/96c633b583fc17ea560fe1ddf7b915ab5a3be3f3))
+* **ci:** clear check-refs regressions in roadmap files ([56b40f3](https://github.com/event4u-app/agent-config/commit/56b40f397e632337f5f69a507b13aa2b475453c3))
+
+### Performance
+
+* **ci:** smoke GT subset + duration line + nightly full replay (P2.4) ([7b0608d](https://github.com/event4u-app/agent-config/commit/7b0608d3f51bac534f835424860049483ae6004a))
+
+### Documentation
+
+* **ui-track:** 1-page mental model + archive Phase 2 roadmap — P2.10/P2.11 ([d87673d](https://github.com/event4u-app/agent-config/commit/d87673d75ec8cd0136336a1954b356a953b79e4e))
+* **install:** relabel install paths (advanced/experimental/staged) — P2.5 ([66e5389](https://github.com/event4u-app/agent-config/commit/66e53894f3dd12ff0762a56f677e302d1ca726c1))
+* add visible (beta) markers to public-surface contract links ([282b74f](https://github.com/event4u-app/agent-config/commit/282b74fccab2c0ba585271013c5fe61b396aaa09))
+* positioning headline + work_engine vs runtime_dispatcher separation ([ccf833f](https://github.com/event4u-app/agent-config/commit/ccf833f07b34ff2c6c5cf64e8328fb67b7629c4d))
+* **roadmaps:** reviewer feedback + directional → out-of-horizon ([6af0320](https://github.com/event4u-app/agent-config/commit/6af03205537d761a0cbe6c205662c34854deea6a))
+* **rules:** position-agnostic recommendation in user-interaction ([ee57ae0](https://github.com/event4u-app/agent-config/commit/ee57ae0d233b3332f30dfd3d3f67b3954ce153ef))
+* **roadmaps:** retire stale open-questions and placeholder sections ([c1ec177](https://github.com/event4u-app/agent-config/commit/c1ec17782521bb5688260d1873423fbf4d4adc99))
+* **roadmaps:** synthesize decisions from multi-AI review ([4d9dcc1](https://github.com/event4u-app/agent-config/commit/4d9dcc19929fe7d3fa2657509a4b8a2e9a1ee7e2))
+* add capture-only synthesis roadmaps ([d2bdb76](https://github.com/event4u-app/agent-config/commit/d2bdb76ec562d8a00313f49b388083fdad8f1b42))
+
+### Refactoring
+
+* **work_engine:** modularise cli.py into 7 focused modules (P2.3) ([ad92366](https://github.com/event4u-app/agent-config/commit/ad9236681c1537beec3d407bead9b7386c57c73d))
+* **roadmaps:** binary status model — ready (implicit) / draft (hidden) ([2d3d713](https://github.com/event4u-app/agent-config/commit/2d3d713a52ac039c08317817331ba6aaa81fcb12))
+
+### Tests
+
+* **work_engine:** cover default state file + UI-prompt routing + medium-band halt (P0.7) ([e97c499](https://github.com/event4u-app/agent-config/commit/e97c499fa7daaf0478423efbdb34d648b6e400c8))
+
+### Chores
+
+* **generated:** sync compressed projections for chat-history split (P2.1) ([f53a44f](https://github.com/event4u-app/agent-config/commit/f53a44f31fd7d93c28122b945f8059bd112dc854))
+* **generated:** regenerate .windsurfrules after rule edits ([0090392](https://github.com/event4u-app/agent-config/commit/00903924eaf1955ad2049dc03c3c57d9f4ff016e))
+* **roadmaps:** mark Phase 1 progress in road-to-post-pr29-optimize + dashboard ([a2160af](https://github.com/event4u-app/agent-config/commit/a2160afd6e7280bd3d4a71641fb4dba8234edf21))
+* **scripts:** whitelist scripts/mcp_server/ in portability check ([259745e](https://github.com/event4u-app/agent-config/commit/259745e9f52ea0a60e3e92a553a5938b15adc0ca))
+
+### Other
+
+* **readme:** drop redundant 'no runtime deps' bullet — clear 500-line limit ([53b5df4](https://github.com/event4u-app/agent-config/commit/53b5df481122ccbd70ce358a3192643c7fff73b0))
+* **readme:** trim Stability tiers + command-suggestion blocks to clear 500-line limit ([5bb50ba](https://github.com/event4u-app/agent-config/commit/5bb50ba43d8734f5deb02c0b34c9c6e26475c52b))
+* **rules:** trim roadmap-progress-sync to 199 lines (clear CI hard limit) ([12c3a2e](https://github.com/event4u-app/agent-config/commit/12c3a2e1357dfca7ec0bd2f6b507e606ec2de596))
+
+## [1.14.0](https://github.com/event4u-app/agent-config/compare/1.13.0...1.14.0) (2026-05-01)
+
+### Features
+
+* scaffold a11y findings + preview envelope in UI stack skills ([6e72357](https://github.com/event4u-app/agent-config/commit/6e7235708e74dfa629378dc0c09dd3a366c41fb5))
+* **ui-track:** R4 phase 3 — preview envelope render contract ([13906c0](https://github.com/event4u-app/agent-config/commit/13906c0d622de5f1e556be8273a4acdd240acb0a))
+* **r4:** polish termination contract — a11y precedence + one-shot extension ([98cf2d7](https://github.com/event4u-app/agent-config/commit/98cf2d7f43550d391ef3ee03233d2eaa18b8be30))
+* **review:** R4 Phase 1 — a11y gate on ui.review ([ba93534](https://github.com/event4u-app/agent-config/commit/ba93534d3e09f44cac6f06805600a2084465e0b4))
+* **state:** R4 Phase 0 — a11y / preview envelopes on ui_review, ui_audit, ui_polish ([29fe67c](https://github.com/event4u-app/agent-config/commit/29fe67ccef98320e21899816eb2f7ee0910e9e89))
+* **golden:** pin GT-U3..U4, U9..U12 UI track baselines ([52a33c2](https://github.com/event4u-app/agent-config/commit/52a33c23bb0e01752204ab68aa8309d05b68cbd5))
+* **ci:** add Iron Law prominence linter ([2e1cae5](https://github.com/event4u-app/agent-config/commit/2e1cae534cf7e1dc164258fb09dea0859c47fa8d))
+* **chat-history:** native augment hooks via user-level settings ([de9a1b0](https://github.com/event4u-app/agent-config/commit/de9a1b08d279c6ed251a2b762e1fc069c7a9e840))
+* **chat-history:** platform bridges + git-hook fallback ([a1e6574](https://github.com/event4u-app/agent-config/commit/a1e65748148c676b37586bedcbc7c9c4ec520640))
+* **golden:** add GT-U2 ui-improve diff scenario ([ff0b5f8](https://github.com/event4u-app/agent-config/commit/ff0b5f8189c4fb8e257799d5569e69bd09289f79))
+* **work-engine:** add hooks lifecycle + thread diff/file inputs ([53fb358](https://github.com/event4u-app/agent-config/commit/53fb35806b9dea3b7b39431cd7bdb5ac270d7ae1))
+* **work-engine:** add hooks primitives package ([33a4ea8](https://github.com/event4u-app/agent-config/commit/33a4ea8e3aa16a2e4c1e0b191773964fa94708c3))
+* **skills:** reposition UI skills as directive-dispatched executors and reference (R3 Phase 5) ([2b7870d](https://github.com/event4u-app/agent-config/commit/2b7870df80adfc6fe86d1c7cd1c0ef9b36b79c35))
+* **work_engine:** implement mixed directive set (Phase 4) ([f81ac1d](https://github.com/event4u-app/agent-config/commit/f81ac1d0633eee65f2046e2ffe843262a9fa8039))
+* **work-engine:** add state.contract and state.stitch envelopes ([40c8060](https://github.com/event4u-app/agent-config/commit/40c8060135193a360b0c35be9c38ad7c211c69fc))
+* **work_engine:** add shadcn version-mismatch halt + per-stack audit fixtures ([1d73217](https://github.com/event4u-app/agent-config/commit/1d732179153eb8bc32d8f2b84f399e9553580300))
+* add react-shadcn-ui skill ([91e8de2](https://github.com/event4u-app/agent-config/commit/91e8de249f5ed8f4fd2df1e97b09b294e1b2b648))
+* add ui/review + ui/polish directives with token-violation refactor ([9d25234](https://github.com/event4u-app/agent-config/commit/9d25234f907061ad6d841bdf9ca9fd5ea8ae5476))
+* add ui/design + ui/apply directives ([1c5bb28](https://github.com/event4u-app/agent-config/commit/1c5bb28ea0d9e3f60dfcd659563b92cd86f52427))
+* extend work-engine state schema for UI directives ([aa961ad](https://github.com/event4u-app/agent-config/commit/aa961ad10838e69edb6f36e1dedac37f3d94d292))
+* **roadmap-sync:** mandate per-step checkbox flips during autonomous runs ([f1019b0](https://github.com/event4u-app/agent-config/commit/f1019b042789104c439cfe925fd8238a55f94541))
+* **chat-history:** conditional Iron Law for HOOK vs CHECKPOINT path ([ccf42c7](https://github.com/event4u-app/agent-config/commit/ccf42c77b6882e390c877ab2227258ea73eb6b22))
+* **chat-history:** add /chat-history-checkpoint command for CHECKPOINT path ([71c38bf](https://github.com/event4u-app/agent-config/commit/71c38bf9387100a2b25dd4a60c657ff56526ff94))
+* **chat-history:** wire HOOK strategy for Claude Code and Augment CLI ([d280777](https://github.com/event4u-app/agent-config/commit/d2807770c5d8937e7cc4ba8a65c91de4503ccff0))
+* **chat-history:** add hook-append wrapper for platform hooks ([f936e57](https://github.com/event4u-app/agent-config/commit/f936e573bcc613ea7d7fc6bcd90113c5514821a2))
+* **roadmap-sync:** harden rule with Iron Law, pre-send self-check, failure modes ([208728f](https://github.com/event4u-app/agent-config/commit/208728f3e92a6343adca74f8ab8853e9558091b6))
+* **compress:** allow caveman style, enforce structural Iron Law preservation ([7bcbcae](https://github.com/event4u-app/agent-config/commit/7bcbcae1cd4e9341abbf90e67e20baee0f2902c4))
+* **skills:** add md-language-check skill and /check-current-md command ([0aaed82](https://github.com/event4u-app/agent-config/commit/0aaed829908bcb1e891d691db248a06667e9ee53))
+* **work-engine:** implement ui-trivial directive set ([59bb66d](https://github.com/event4u-app/agent-config/commit/59bb66de360c38b186e1462664795ccbddd7ce1e))
+* **rules:** extract Hard Floor into non-destructive-by-default ([dfc80a6](https://github.com/event4u-app/agent-config/commit/dfc80a6ec848d0a5fe7a8997d1e29dab3cf73fb0))
+* **work-engine:** wire ui-trivial directive set with reclassification (R3 P2 S6) ([10d5cb0](https://github.com/event4u-app/agent-config/commit/10d5cb0e76679e3549b502d26f83ca8667a314e9))
+* **directives/ui:** high-confidence vs ambiguous audit branching (R3 Phase 2 Step 4) ([8a5645b](https://github.com/event4u-app/agent-config/commit/8a5645be20b6c9d86f87b7facf84afad7f5901bb))
+* **skills/existing-ui-audit:** hard audit gate for R3 Phase 2 ([7189ef5](https://github.com/event4u-app/agent-config/commit/7189ef558feeabe9556fb68b46550ef1920d2f9a))
+* **directives/ui:** routing-target stub for R3 Phase 1 ([4e83a21](https://github.com/event4u-app/agent-config/commit/4e83a2112ecb8019b927e1a858f31cda43e2929d))
+* **work-engine:** stack detection + intent routing (R3 Phase 1) ([11cc83d](https://github.com/event4u-app/agent-config/commit/11cc83d77a70e387fa0ac0cf2ef8fee9af15e19c))
+* **command-suggester:** engine + rule + settings (Phases 3-6) ([e035618](https://github.com/event4u-app/agent-config/commit/e035618ead1ee96561898048e9ee86378054209b))
+* **commands:** inject suggestion frontmatter into all 75 commands ([470c2f6](https://github.com/event4u-app/agent-config/commit/470c2f61a422518deb999105c1078abfcbf4ee2d))
+* **linter:** validate command suggestion frontmatter block ([e137b70](https://github.com/event4u-app/agent-config/commit/e137b703a40f2a9527fea2e6e68313d073696f11))
+* **commands:** add command-suggestion eligibility audit ([55ccbd6](https://github.com/event4u-app/agent-config/commit/55ccbd6add58de25a7dcc2b7e1518adb0d52e788))
+* **telemetry:** redaction validator and export gate (Phase 5) ([1e2f9f0](https://github.com/event4u-app/agent-config/commit/1e2f9f0e3879ebc5d08449d7146df0d185c6dea1))
+* **telemetry:** wire telemetry:report CLI ([e68bd05](https://github.com/event4u-app/agent-config/commit/e68bd0574f81584fad5b845355e9a7048b082365))
+* **telemetry:** aggregator + report renderer for engagement log ([598f9e1](https://github.com/event4u-app/agent-config/commit/598f9e1d3786be0b4b3ebfbc4edaff60a65d06fc))
+* **telemetry:** add artifact-engagement-recording rule + wire commands ([81ad51f](https://github.com/event4u-app/agent-config/commit/81ad51f88e590ef61339c8b7f463496d92316f60))
+* **telemetry:** recording engine + telemetry:record / telemetry:status CLI ([7327d53](https://github.com/event4u-app/agent-config/commit/7327d5373040a25ab38298660e435b7d86559ea9))
+* **telemetry:** add engagement event schema (Phase 1 step 1+4) ([e8ae569](https://github.com/event4u-app/agent-config/commit/e8ae5692fb2d24fe50f3cabe91af2917b00699b9))
+* **road-to-universal-distribution:** tick 4 mechanically-verifiable acceptance items ([3725039](https://github.com/event4u-app/agent-config/commit/372503936ae4c3621bad0505a868a749837e41c3))
+* **road-to-universal-distribution:** close Phase 6 Steps 1+5, defer 2+3+4 ([12cd983](https://github.com/event4u-app/agent-config/commit/12cd9839ec6011eebaa18bb476afd133538ccd84))
+* **ci:** cloud-release workflow — attach cloud bundles + Linear digest to GitHub Releases ([6299ca7](https://github.com/event4u-app/agent-config/commit/6299ca736f3b5967d98c56c53fe80693a3f15a57))
+* **rules:** harden language-and-tone — chat messages are the only language signal ([51144da](https://github.com/event4u-app/agent-config/commit/51144da3c39eb704038ac7e390b8e7e97fc2ecde))
+* **cloud:** Phase 4 Step 2 — narrow rewrite for cloud-portable prose ([45a2ed1](https://github.com/event4u-app/agent-config/commit/45a2ed16952075e8af10874392bb041b384583b8))
+* **audit:** Phase 4 Step 1 — cloud-action classifier extension ([485acca](https://github.com/event4u-app/agent-config/commit/485acca8cfdbbd4c1839c2c3d9e21cf52925ee37))
+* **linear:** Phase 3 — Linear AI rules digest builder + three-layer split ([3dcbf0a](https://github.com/event4u-app/agent-config/commit/3dcbf0af3c2dca70ef70f18af70a3568516f0147))
+* **rules:** add commit-policy as canonical no-commit-no-ask rule ([fd208ea](https://github.com/event4u-app/agent-config/commit/fd208ea1c0f95aaa58d930c99ff0e51dd27600ed))
+* **rules:** add autonomous-execution rule with intent-based opt-in ([fbff529](https://github.com/event4u-app/agent-config/commit/fbff5299b32606b7f13f06c856a4d4556c908fcb))
+* **commands:** add /commit-in-chunks for autonomous commit splitting ([b53fa7b](https://github.com/event4u-app/agent-config/commit/b53fa7b277a107af8acc6076baf8c985f0fbb901))
+* **cloud:** mark T3-H artifacts cloud-safe (4 noop + 4 degrade) ([0eb7eb3](https://github.com/event4u-app/agent-config/commit/0eb7eb3cdbf590e3ef87f372c3fd09d85aa5cfd5))
+* **cloud:** cloud-safe marker detection + variant rendering ([67bf28b](https://github.com/event4u-app/agent-config/commit/67bf28b8f85384333f5d26807ad92e6d0b456288))
+* **cloud:** cloud-bundle builder with T3-H gating + tests ([f749edc](https://github.com/event4u-app/agent-config/commit/f749edc8c0f16cded153eb24580c4b262a6065ae))
+* **chat-history:** add heartbeat visibility modes (on/off/hybrid) ([70e9925](https://github.com/event4u-app/agent-config/commit/70e99259e1c1888dfabc19c6b0c261301b2d386e))
+* **rules:** add direct-answers iron laws ([f66b89c](https://github.com/event4u-app/agent-config/commit/f66b89cd3143121b5b16f58b6a3705844f99ce0f))
+* **chat-history:** add heartbeat marker for in-band reply observability ([2236bc2](https://github.com/event4u-app/agent-config/commit/2236bc218b3b64106c82726a1604e17234b2d2d3))
+* **chat-history:** enforce ownership with turn-check gate and append refusal ([2be705c](https://github.com/event4u-app/agent-config/commit/2be705cb92c18e786f6d130d04e1edcb1785767e))
+* **commands:** add /work entrypoint and refine-prompt skill (R2-P1, R2-P3) ([a09d748](https://github.com/event4u-app/agent-config/commit/a09d7487d48fe3bd0bfb1d3ae2c188db97103bac))
+* **work_engine:** prompt envelope, confidence scoring, refine dispatch (R2-P2..P4) ([53e6aae](https://github.com/event4u-app/agent-config/commit/53e6aaee756a7de94167b04b46e394d55c15e8f8))
+* **engine:** R1 Phase 7 — close out Universal Execution Engine roadmap ([d461da0](https://github.com/event4u-app/agent-config/commit/d461da06c681ab9bf3ca005627b33a854b1ab017))
+* **rules:** forbid release language in roadmaps + decline-silence policy ([ddae361](https://github.com/event4u-app/agent-config/commit/ddae361669610917f340f9e1f257d07ead2fab99))
+* **ci:** add named Golden Replay check (R1-P6-S3) ([60e873c](https://github.com/event4u-app/agent-config/commit/60e873c8865f4cedcd0dc6abccb8b819aca5500d))
+* **test:** add Golden Transcript replay harness (R1-P6-S1) ([5f219e9](https://github.com/event4u-app/agent-config/commit/5f219e9209451171ebfc8a08639c71864384de92))
+* **cli:** add migrate-state subcommand to agent-config dispatcher (R1 P5 S1) ([2ab5fc8](https://github.com/event4u-app/agent-config/commit/2ab5fc89a6fae5bc835efc73e5bfcc96a2ba975a))
+* **engine:** add per-set kind gate to dispatcher (R1 P4 S5) ([b80a8d0](https://github.com/event4u-app/agent-config/commit/b80a8d0706fa389578372036fc0b8a847ead9b2c))
+* **engine:** add select_directive_set + load_directive_set (R1 P4 S2) ([ffd0ac8](https://github.com/event4u-app/agent-config/commit/ffd0ac82a41661d1a618e1feb36a0be279be19e6))
+* **engine:** add ui/ui-trivial/mixed directive-set stubs (R1 P4 S4) ([73ae862](https://github.com/event4u-app/agent-config/commit/73ae8622710ef02512ca1e734946d811d2425766))
+* **roadmaps:** plan artifact engagement telemetry (R6) ([5d2953b](https://github.com/event4u-app/agent-config/commit/5d2953ba7174567310e1f2e84e88b56b1ab7724f))
+* **cli:** expand agent-config dispatcher with memory/proposal/refine-ticket subcommands ([0d826ac](https://github.com/event4u-app/agent-config/commit/0d826ac466109f9f53c1640b49c5e2243827be0f))
+* **roadmaps:** plan universal execution engine + 4 supporting tracks ([7c777dc](https://github.com/event4u-app/agent-config/commit/7c777dc62e637da31763b99940297e0e2b18e4a7))
+
+### Bug Fixes
+
+* **engine:** round-trip contract/stitch/stack between WorkState and DeliveryState ([c8086ca](https://github.com/event4u-app/agent-config/commit/c8086ca2d9c73f5f6d87a85f58224303f2d3b628))
+* **docs:** clarify stitch + mixed.ui dispatch as @agent-directive emits ([893e5eb](https://github.com/event4u-app/agent-config/commit/893e5ebdddb39b971b9d973dd1b628b2f27503d1))
+* **work-engine:** heartbeat survives state sync; turn-check surfaces drift ([303d04e](https://github.com/event4u-app/agent-config/commit/303d04ebbb896fd82ba0cd5910089fa6079b9f1f))
+* **roadmap-sync:** replace hardcoded `task ci` with project-agnostic phrasing ([272b7b5](https://github.com/event4u-app/agent-config/commit/272b7b554f78a72cdeb4cf278bbdf065a895efa7))
+* **chat-history:** correct suggestion frontmatter to schema-compliant fields ([cf4849d](https://github.com/event4u-app/agent-config/commit/cf4849d4a9e5954d3ff7e10aa4712d7921b0f7c1))
+* **compress:** align compressed code blocks with uncompressed source ([4a495c9](https://github.com/event4u-app/agent-config/commit/4a495c91da13cd9ea858d06b3eabaef31897b5d8))
+* **sync:** handle 3-level nested settings (commands.suggestion.*) and list values ([e8904cd](https://github.com/event4u-app/agent-config/commit/e8904cd35f309cc65807418429f9298af9743390))
+* **roadmap-progress:** Steps = total checkboxes, reorder Open before Done ([ec2c2e6](https://github.com/event4u-app/agent-config/commit/ec2c2e6bce8868fec605181fa35a32fa14a04640))
+* **marketplace:** sync manifest with disk + add reverse-drift linter ([98d5cb3](https://github.com/event4u-app/agent-config/commit/98d5cb3b46e3761e75258141b776d06749fba6f2))
+* **rules:** harden recommendation-consistency — single source + script gate ([ed953db](https://github.com/event4u-app/agent-config/commit/ed953dbe9c795abfe5a8543667ab1a630d9b2b50))
+* **golden:** sandbox-relative ticket paths in transcript cmd ([0265be9](https://github.com/event4u-app/agent-config/commit/0265be9df02bafecfefc0eb7816b55a10cf2e911))
+* **golden:** scrub pytest duration in capture summaries ([a5de45d](https://github.com/event4u-app/agent-config/commit/a5de45d0c0bd5cf850acc0cf2d2d6635e80d398e))
+* **rule:** harden chat-history with iron-law + per_phase cadence ([f1b3e01](https://github.com/event4u-app/agent-config/commit/f1b3e01b4d530496fc82eaca5b1120153ccb3505))
+
+### Documentation
+
+* **readme:** reflow R4 paragraph to satisfy 500-line linter ([712a5e2](https://github.com/event4u-app/agent-config/commit/712a5e234f80d7d95c9240fccca6d8fd1b44fb3e))
+* **readme:** note R4 a11y precedence in UI track ([9c53182](https://github.com/event4u-app/agent-config/commit/9c5318204cd34faa9a931280a76e18b6b1a3fd25))
+* amend UI-track contracts with R4 a11y gate and preview envelope ([cf1ad44](https://github.com/event4u-app/agent-config/commit/cf1ad44ef476166cde97c6ccdf58d3b0928bbf55))
+* **r4:** mark Phase 2 complete; dashboard 51/78 (was 47%) ([8ff7e7f](https://github.com/event4u-app/agent-config/commit/8ff7e7fe001ef0b83d4e32a876f3cd2563083c32))
+* **r4:** mark Phase 1 (review-step a11y gate) complete ([3a0d773](https://github.com/event4u-app/agent-config/commit/3a0d773962336f7836c4932c3cca16e18b7e6f59))
+* **r4:** mark Phase 0 (state-shape extension) complete ([b243fc2](https://github.com/event4u-app/agent-config/commit/b243fc2fb078238d9480f4026b93090124224f23))
+* **r4:** expand visual-review-loop roadmap from stub to 6 phases + 6 ACs ([97dc65f](https://github.com/event4u-app/agent-config/commit/97dc65f06b037d70fe1bb69727bed832b6ca5c5e))
+* **roadmap:** mark R3.1 follow-up goldens (GT-U5..U8) complete ([eff403a](https://github.com/event4u-app/agent-config/commit/eff403a37720871b052bef85472562e636766dc0))
+* **r3.1:** expand follow-up roadmap from stub to 6 phases + 6 ACs ([8b4de92](https://github.com/event4u-app/agent-config/commit/8b4de92c267b9f9426abd4ee5ea4c5e264a58683))
+* **r3:** finalize Product UI track docs ([ecea059](https://github.com/event4u-app/agent-config/commit/ecea059c1d4f7778d48d2d00abacc68ded86c826))
+* **rules:** document distribution manifests and hook registries in docs-sync ([88f8535](https://github.com/event4u-app/agent-config/commit/88f853534c4edf9432232cbdc4d117c306d7ca05))
+* **roadmaps:** add work-engine hooks roadmap, mark P1 complete ([f6a867d](https://github.com/event4u-app/agent-config/commit/f6a867d3a95912a1c4c03c139870587bfe95393b))
+* **roadmap:** close R3 Phase 6 Step 1 + GT-U1 progress ([b80140e](https://github.com/event4u-app/agent-config/commit/b80140ee9f9b6796779dd251ad1a51213480039b))
+* **roadmap:** close R3 Phase 5 — UI skills repositioned ([97dafbc](https://github.com/event4u-app/agent-config/commit/97dafbc22b7142e210d7e742196546ac701ef455))
+* **roadmap:** close R3 Phase 4 — mixed orchestration shipped ([040fb43](https://github.com/event4u-app/agent-config/commit/040fb4314a26e57b408baaa6dbc9f9b297ef70ce))
+* **roadmaps:** close Phase 2 Step 5 of product-UI track ([f4df4f3](https://github.com/event4u-app/agent-config/commit/f4df4f301fa0de9cf6d39910b2e3e9cb1e55737a))
+* mark product UI track phase 3 complete ([8d982af](https://github.com/event4u-app/agent-config/commit/8d982af0bc40f1e4ce1da7f0837ae8c05a13ad19))
+* **roadmaps:** close and archive road-to-stable-chat-history ([41affe3](https://github.com/event4u-app/agent-config/commit/41affe3014d2ccc472bab9e464f380acbf8763f0))
+* **roadmaps:** annotate Phase 5 dogfood steps with synthetic-CLI evidence ([6ce5374](https://github.com/event4u-app/agent-config/commit/6ce5374852658c68b4bcdca330a62ec22ae03462))
+* **roadmaps:** regenerate progress dashboard for chat-history Phases 2-4 ([2d60d42](https://github.com/event4u-app/agent-config/commit/2d60d42c4367f672ffb8409e627c7b183004fe04))
+* **chat-history:** mark Phases 2/3/4 done; refresh count snapshots ([8602aef](https://github.com/event4u-app/agent-config/commit/8602aef13c15a1fde1e2b4dcc5849d6e96e66c6e))
+* **chat-history:** document platform hooks and complete Phase 1 ([1ad00f4](https://github.com/event4u-app/agent-config/commit/1ad00f4158ac2bc18ef77d06e8e2e91cb1392e20))
+* **roadmap:** add road-to-stable-chat-history ([e8b19c3](https://github.com/event4u-app/agent-config/commit/e8b19c3488ba26a7645dc76ed88969f76290d8bd))
+* **command-suggestion:** README + AGENTS + CHANGELOG (Phase 7 Steps 5,7) ([5e411e3](https://github.com/event4u-app/agent-config/commit/5e411e3c2b7ea11fe9bb3bf4a191944babd801bb))
+* **command-suggester:** GT-CS goldens, ADR, flow doc (Phase 7 Steps 1,3,6) ([ed3b476](https://github.com/event4u-app/agent-config/commit/ed3b476802f109ab58ba6ccfd6fd805085d2af46))
+* **command-writing:** document suggestion frontmatter requirements ([c798a48](https://github.com/event4u-app/agent-config/commit/c798a48a87cce5f5658a87da3cd5f01a707de815))
+* **telemetry:** Phase 7 — onboarding hint, AGENTS/README pointer, ADR, changelog ([cc69615](https://github.com/event4u-app/agent-config/commit/cc69615b09331dddd4aad891528cc39dd1bb2549))
+* **roadmap:** mark Phase 6 dogfooding done — Steps 1-3 closed, Step 4 deferred ([d278e58](https://github.com/event4u-app/agent-config/commit/d278e5836ffff34126b0d323a3b4d1e9799453ec))
+* **telemetry:** privacy contract and Phase 5 progress ([a2a9d3e](https://github.com/event4u-app/agent-config/commit/a2a9d3e03d1ac01498218bd65ef19363ac43da4a))
+* **telemetry:** add artifact-engagement-flow context doc ([e98569e](https://github.com/event4u-app/agent-config/commit/e98569efdfe72650dc11f6e0ae583a4e55f53164))
+* **roadmap:** mark Phase 2 of artifact-engagement-telemetry done ([87da655](https://github.com/event4u-app/agent-config/commit/87da6552db02ece055161ccf97a62c66f7498858))
+* **roadmap:** close Phase 1 of artifact-engagement-telemetry ([6275e5c](https://github.com/event4u-app/agent-config/commit/6275e5cfb3f9a61498bcdbd0b71ee9a160798208))
+* **cloud-trigger-fixtures:** add Phase 6 v0 fixture set + methodology ([cafaaa0](https://github.com/event4u-app/agent-config/commit/cafaaa0962ab6e5099d90e57886a52bce0473ec5))
+* **roadmap:** mark Phase 5 Step 4 as deferred after mechanical verification ([f14fa34](https://github.com/event4u-app/agent-config/commit/f14fa34017407029c5462b8b65c513a9f55aaab1))
+* **showcase:** add behavioral examples with file anchors ([dade31a](https://github.com/event4u-app/agent-config/commit/dade31a3de647bd743fdc95c803d18e97b8586f9))
+* **roadmap:** mark Phase 5 Step 3 done — cloud-release workflow ([c94bde2](https://github.com/event4u-app/agent-config/commit/c94bde2164a2152871e16556abdb6ea7fd82cacd))
+* **roadmap:** mark Phase 5 Step 2 done — install paths documented ([401c005](https://github.com/event4u-app/agent-config/commit/401c005a8726c9482db705cb4ab7bc6252708f01))
+* **install:** document four install paths — local, plugin, cloud, Linear ([6df2995](https://github.com/event4u-app/agent-config/commit/6df29950151f3fb316ea1faf3caf781287d5660b))
+* **roadmap:** close Phase 5 Step 1 + Open Question #4 ([2a2b4d6](https://github.com/event4u-app/agent-config/commit/2a2b4d671152d84b8fc5a2428aabfc3ff8fba854))
+* **roadmap:** mark Phase 4 done — Cloud-Aware Documentation Pass ([2e8c7f6](https://github.com/event4u-app/agent-config/commit/2e8c7f629df2ed1471e703aa741cdfe9824f9d10))
+* **roadmap:** mark Phase 2 done + Phase 3 Step 1 done ([9ed6819](https://github.com/event4u-app/agent-config/commit/9ed681972dbdd36e4457196ff969203b28cb8e94))
+* **cloud:** document cloud-bundle pipeline + smoke protocol ([d6c1fcb](https://github.com/event4u-app/agent-config/commit/d6c1fcba68a5e4e695b6009427e66756240dd74d))
+* **roadmap:** road-to-universal-distribution + cloud-compat audit tool ([db80039](https://github.com/event4u-app/agent-config/commit/db800394da5f0bda6fde297fd59d124abeb2af2f))
+* **rules:** promote chat-history Iron Law to three gates with heartbeat ([c638da7](https://github.com/event4u-app/agent-config/commit/c638da7ef55a7685455161124e88ca569e99501b))
+* **rules:** rewrite chat-history rule to mandate turn-check first ([a8f69aa](https://github.com/event4u-app/agent-config/commit/a8f69aa13dc8bdcfacb35898a6e0f7f2915176d5))
+* **roadmap:** archive R2 prompt-driven execution + regenerate dashboard ([32b9022](https://github.com/event4u-app/agent-config/commit/32b90228e6b139683c1bf6f7f296f7d579463a07))
+* **work_engine:** R2 README, AGENTS, ADR, changelog, flow doc (R2-P6) ([a94b44f](https://github.com/event4u-app/agent-config/commit/a94b44f16c3080a5e1e15fa2dd6eba87404103aa))
+* **roadmap:** mark P7-S1 complete (task ci end-to-end green) ([0e29381](https://github.com/event4u-app/agent-config/commit/0e29381ec661a3936e7245f884bf10fd64e0c0f3))
+* **flow:** document Replay protocol — Strict-Verb contract (R1-P6-S5) ([05056c5](https://github.com/event4u-app/agent-config/commit/05056c5c6bb032b048952ffaa024e832d41250a1))
+* **roadmap:** mark P6-S4 complete (CHECKSUMS audit) ([d47e87b](https://github.com/event4u-app/agent-config/commit/d47e87bab805c60310d6739f61b0cb97e527376f))
+* **roadmap:** mark P6-S3 complete; regen dashboard ([228c1d7](https://github.com/event4u-app/agent-config/commit/228c1d71e7f7e60c4769d6cbba0fa1da520b7f4a))
+* **roadmap:** mark P6-S1 + P6-S2 complete; regen dashboard ([69a58bd](https://github.com/event4u-app/agent-config/commit/69a58bde28b187762b6d7fe8abc28266cfcec068))
+* **roadmap:** mark R1 P5 S3 done — Phase 5 complete ([649cd2a](https://github.com/event4u-app/agent-config/commit/649cd2a5b3b159313688d28028893b21e0f25e2c))
+* **command-routing:** document /implement-ticket dispatching to work_engine (R1 P5 S3) ([5d2b2df](https://github.com/event4u-app/agent-config/commit/5d2b2df705ee56f06b59f2a13bfa6dce8344326e))
+* **roadmap:** mark R1 P5 S1+S2 done ([9db66bc](https://github.com/event4u-app/agent-config/commit/9db66bc642fc7169e86aa7b98c71d2b0a99e44aa))
+* **php-patterns:** polymorphism guardrails for discriminator-switch antipattern ([255013a](https://github.com/event4u-app/agent-config/commit/255013a391560e2b1278ac7317d11a3ad7238da9))
+* **learnings:** harden non-duplication gate with mandatory search protocol ([f345809](https://github.com/event4u-app/agent-config/commit/f3458099abb506741fda50a1d9dc3c910836a609))
+* **roadmap:** mark R1 Phase 4 (dispatcher generalization) complete ([756fa7b](https://github.com/event4u-app/agent-config/commit/756fa7b89de01a4f6211d45e725717834cf02e74))
+* **roadmaps:** mark R1 Phase 3 complete (rename + shim + tests) ([7e44967](https://github.com/event4u-app/agent-config/commit/7e44967029906bf8cb4446d79c8ad942be076fd8))
+* remove internal agents/ links from shipped artifacts + roadmap tweaks ([aadebd7](https://github.com/event4u-app/agent-config/commit/aadebd7f53d6afda1fc6ce40f74b0a2215f14410))
+
+### Refactoring
+
+* **rules:** hoist Iron Laws to top and harden chat-history ([a69bc32](https://github.com/event4u-app/agent-config/commit/a69bc32ec4529ebe6558105bab1c52414d423436))
+* **work_engine:** rename UI _phase3_stub to _passthrough ([b67aa7c](https://github.com/event4u-app/agent-config/commit/b67aa7c1a155daa5e1cdb10b3c73669fd32b0c39))
+* **chat-history:** slim rule under 200-line limit; extract handshake details ([6949799](https://github.com/event4u-app/agent-config/commit/69497995deb440fe2d8a3387eddbb2e7e7cf095c))
+* **implement-ticket:** switch wrapper to .work-state.json + work_engine path (R1 P5 S1+S2) ([2f074d4](https://github.com/event4u-app/agent-config/commit/2f074d4f1bc4576b4d6e8571f37b755bc8373af1))
+* **work_engine:** wrap CLI boundary in WorkState v1 (R1 P4 S1) ([5b2b5c3](https://github.com/event4u-app/agent-config/commit/5b2b5c301b7d3368bf0c00ae785e43fbb2a9a31b))
+* **engine:** repackage steps/ → directives/backend/ (R1 P4 S3) ([fb3abca](https://github.com/event4u-app/agent-config/commit/fb3abca243be446aee784caccc64b3d5653dd51c))
+* **engine:** switch internal callers to work_engine (R1 P3 S3) ([c3d1bff](https://github.com/event4u-app/agent-config/commit/c3d1bff90bf663a89f430a1550db1affd34a424c))
+* **engine:** rename implement_ticket → work_engine (R1 P3 S1+S2) ([3fdb78b](https://github.com/event4u-app/agent-config/commit/3fdb78bd558fa9625e7fb8f301adb4fe9d7a07ae))
+* **artifacts:** route shipped artifacts through ./agent-config CLI ([c8158b2](https://github.com/event4u-app/agent-config/commit/c8158b2ac42e17fb302fc658a277abb2129f9a60))
+
+### Tests
+
+* **golden:** pin GT-U13/U14/U15 — a11y polish, a11y ceiling, preview-fail ([05f9eb2](https://github.com/event4u-app/agent-config/commit/05f9eb21aa236a1088f85ab12c93a845355bfc13))
+* **golden:** extend capture/harness for a11y findings and preview envelope ([6c385c4](https://github.com/event4u-app/agent-config/commit/6c385c4f71265a6c962fb067a54f0a558b3c08a0))
+* **golden:** pin GT-U5 mixed flow and GT-U6A/B stack dispatch ([16550b8](https://github.com/event4u-app/agent-config/commit/16550b829cdf5f26532e7d4a51974ad13fbbcfcd))
+* **golden:** drop per-baseline reproduction-notes ([9b3e63b](https://github.com/event4u-app/agent-config/commit/9b3e63beea198fe20cfcedb3560dfa026e5201aa))
+* **golden:** add GT-U1 ui-build happy path + refresh GT-P1..P4 baselines ([15e36e9](https://github.com/event4u-app/agent-config/commit/15e36e94a5fec8623fc9e8f12b438d6e34edb341))
+* **work-engine:** add full-flow integration tests for mixed directive set ([eccfe66](https://github.com/event4u-app/agent-config/commit/eccfe6686abd747c29b1e293254db99a913cf331))
+* **work_engine:** defense-in-depth dispatcher and rule-content gates for ui audit ([8b9ea7b](https://github.com/event4u-app/agent-config/commit/8b9ea7b0ab018aa9879d72c9699e07731562f61f))
+* **chat-history:** automated crash-recovery coverage for hook path ([b86e0a9](https://github.com/event4u-app/agent-config/commit/b86e0a9985c4e3e51181a08cbe07f1175156abb2))
+* **telemetry:** redaction validator coverage (Phase 5) ([dc3e2de](https://github.com/event4u-app/agent-config/commit/dc3e2de49a3f7a49a653b05106393e43f29bbe10))
+* **telemetry:** aggregator + renderer + telemetry:report CLI ([788907a](https://github.com/event4u-app/agent-config/commit/788907ac183ed4c258df850d7502d0a189b22902))
+* **telemetry:** cost-floor invariants for disabled state ([c0da561](https://github.com/event4u-app/agent-config/commit/c0da56193891294a60dea1db22a3b39c072a690b))
+* **telemetry:** boundary, settings, CLI coverage (25 cases) ([781ef0d](https://github.com/event4u-app/agent-config/commit/781ef0d4720aed21e30faf3e24073d8e9a46fe04))
+* **cloud:** regression test asserting T3-H tier stays 0 in shipped sources ([3f0eaac](https://github.com/event4u-app/agent-config/commit/3f0eaacfa5b1a17da7fa1b9d6a26df1ff2bfd4d6))
+* **golden:** capture GT-P1..GT-P4 prompt-driven baselines (R2-P5) ([c3343df](https://github.com/event4u-app/agent-config/commit/c3343dfce7edb4dbd23d6ae80f185ed92367ec61))
+* **engine:** migrate test suite to tests/work_engine/ (R1 P3 S4) ([eb73ae0](https://github.com/event4u-app/agent-config/commit/eb73ae0532bdfe4a8aa92f842d10243adf91cbdd))
+
+### CI
+
+* **consistency:** gate cloud-bundle, linear-digest, marketplace on PRs ([9d855af](https://github.com/event4u-app/agent-config/commit/9d855af5d47592e9e7f0c429f1a7445c736eaa26))
+
+### Chores
+
+* close roadmaps ([bcfaa0f](https://github.com/event4u-app/agent-config/commit/bcfaa0f5d30a8d15d390a15654aaa80cdaccb102))
+* archive road-to-visual-review-loop (R4 complete) ([706bff8](https://github.com/event4u-app/agent-config/commit/706bff8e331cbd29f1456928a1b09536170a5a4b))
+* **roadmap:** sync dashboard after R4 expansion (47%, 2 open) ([a36736f](https://github.com/event4u-app/agent-config/commit/a36736f8f67185d99b2bab9009de8bb186893165))
+* **roadmap:** archive R3.1 — Product UI Track Follow-up Goldens (100%) ([f740abf](https://github.com/event4u-app/agent-config/commit/f740abf33c811e060ecd1df7b8beb6bbd392c232))
+* **roadmap:** sync dashboard after R3.1 progress (89%) ([fcd18b0](https://github.com/event4u-app/agent-config/commit/fcd18b07d03c5407334e4d43fed39d1e0e4ce31a))
+* **roadmap:** mark Universal Distribution AC #2 (quality gates) done ([6c44878](https://github.com/event4u-app/agent-config/commit/6c44878f7e1631234b40027be1d0c4cf8b3fed2d))
+* **roadmap:** complete and archive Product UI track (R3) ([baffc43](https://github.com/event4u-app/agent-config/commit/baffc4375b9bbcf9f6c2ea2d9b7001a895d68437))
+* **roadmap:** mark Phase 7 complete + refresh dashboard ([d03595b](https://github.com/event4u-app/agent-config/commit/d03595b3a41d6bfb39f483f7137c810a94bcf964))
+* **roadmaps:** close Phase 6 of road-to-product-ui-track ([8f61910](https://github.com/event4u-app/agent-config/commit/8f61910ed91adc6a2af318b13672abcb947d424e))
+* **sync:** wire pre-commit marketplace lint into installer ([a163d64](https://github.com/event4u-app/agent-config/commit/a163d64443fe6574ade62be5d074c254b884c155))
+* **marketplace:** list react-shadcn-ui skill ([24788ec](https://github.com/event4u-app/agent-config/commit/24788ec6e02bfad824fe44272649229ccf2cb9de))
+* **roadmaps:** close work-engine-hooks roadmap + regenerate dashboard ([e841ba4](https://github.com/event4u-app/agent-config/commit/e841ba435fa27f35ae843fadf72a69b24ae6b478))
+* **compress:** regenerate compressed siblings + sync tool projections ([a62ba2b](https://github.com/event4u-app/agent-config/commit/a62ba2b61307b424077e08bd7125aa480d6807bc))
+* **docs:** bump skill count to 128 after react-shadcn-ui addition ([305fb28](https://github.com/event4u-app/agent-config/commit/305fb28e7abb7942210cae8599da64cfe0aee53b))
+* **compress:** catchup compressed siblings for work_engine UI + mixed directives ([746f5cc](https://github.com/event4u-app/agent-config/commit/746f5ccb667e067ad312e2a8ccc2025dc66c2c98))
+* **marketplace:** register chat-history-checkpoint and three drifted skills ([505a84b](https://github.com/event4u-app/agent-config/commit/505a84b2f722b92b752eefb1cf8766c6fad27089))
+* **tools:** regenerate multi-agent tool projections ([18ddf84](https://github.com/event4u-app/agent-config/commit/18ddf84edd1e6b19341aa169bb12db40df43d7c1))
+* **rules:** harden language-and-tone Iron Law against momentum slip ([6d613c2](https://github.com/event4u-app/agent-config/commit/6d613c22ba74b34576909698f4ac732ccf882f7f))
+* **roadmap:** mark R3 Phase 1 done in road-to-product-ui-track ([c5dbaec](https://github.com/event4u-app/agent-config/commit/c5dbaec4b7413287f6d87e0c17e1b38050433d9c))
+* **goldens:** recapture baselines for R3 Phase 1 schema bump ([62d9331](https://github.com/event4u-app/agent-config/commit/62d9331ba33b88e0e8e8be305d46d9fbe3dc2e9b))
+* **roadmap:** archive context-aware-command-suggestion roadmap ([6c3dff1](https://github.com/event4u-app/agent-config/commit/6c3dff17cc570fafb865596b24c6845ea0a3d0a4))
+* **generate-tools:** regenerate .windsurfrules after compression alignment ([8b03959](https://github.com/event4u-app/agent-config/commit/8b03959a2668a15d7ba37610c498967663a9b73b))
+* **roadmap:** regen tool projections + close command-suggestion roadmap ([9a58190](https://github.com/event4u-app/agent-config/commit/9a58190bf77db481f7103c91ad6e9dec4020d261))
+* **roadmap:** mark Phase 1+2 of context-aware command suggestion done ([e2adbff](https://github.com/event4u-app/agent-config/commit/e2adbffa54ed26cdb66456885a7915257b338b59))
+* **roadmap:** archive artefact-engagement-telemetry roadmap ([57d3db9](https://github.com/event4u-app/agent-config/commit/57d3db991a5108cdc5f6b8048afcdc366ce00b07))
+* **roadmap:** mark Phase 4 done in artifact-engagement-telemetry ([347ccb6](https://github.com/event4u-app/agent-config/commit/347ccb6993328631306fa9562c58d3f5a4dab02f))
+* **roadmap:** mark Phase 3 done in artifact-engagement-telemetry ([1cdd52a](https://github.com/event4u-app/agent-config/commit/1cdd52a16e4f21d87b4f635619836ae7668425f5))
+* **settings:** wire telemetry.artifact_engagement namespace (Phase 1 step 2+3) ([13aa723](https://github.com/event4u-app/agent-config/commit/13aa7238a5b534354dbe343f81ed00276c502fd9))
+* **sync:** regenerate counts, hashes, and tool projections ([7016ab5](https://github.com/event4u-app/agent-config/commit/7016ab5085b8680e82efbe8df2ec4f94c80f0ea5))
+* **mcp:** add agent-memory MCP server config ([dc9fd65](https://github.com/event4u-app/agent-config/commit/dc9fd659501f9b89577bc2ceba6f7d42ec63b6d2))
+* **taskfile:** wire sync-agent-settings into task sync ([76fd544](https://github.com/event4u-app/agent-config/commit/76fd544d7e80217a0fd359fb9c0c97a27b3a4e71))
+* **rules:** make cli-output-handling task-invocation portable ([08b40a8](https://github.com/event4u-app/agent-config/commit/08b40a883287c82d586ac5300521e2014a3dbd8f))
+* **rules:** add consistency iron law for numbered-option recommendations ([1bc6a65](https://github.com/event4u-app/agent-config/commit/1bc6a6535073d49a31b669fb22ac506ff101a6e6))
+* **rules:** make rtk the default for verbose CLI output ([6d506c7](https://github.com/event4u-app/agent-config/commit/6d506c7037820bb50d4c794100ccd47bd9e119a0))
+* **docs:** bump rule count 46 → 47 after direct-answers add ([0e35f1f](https://github.com/event4u-app/agent-config/commit/0e35f1f2c57dd01fe77353a1da53c6019834db62))
+* **rules:** harden chat-history with no-fake-marker clause ([7d57be8](https://github.com/event4u-app/agent-config/commit/7d57be81278b66cc23d5d6093ff6e06c6aa3948f))
+* **sync:** regenerate chat-history projections after heartbeat update ([583f284](https://github.com/event4u-app/agent-config/commit/583f28466ed19d8a8220441d0e4b11421b6d016c))
+* **sync:** regenerate chat-history projections ([6e0357e](https://github.com/event4u-app/agent-config/commit/6e0357e73c9b0ae5cfe217fcd80507c004fbf58d))
+* **gitignore:** catch dot-prefixed staging variants under tests/golden/ ([6d37549](https://github.com/event4u-app/agent-config/commit/6d37549f47aa90f06bad96901988ac4db1af6973))
+* **tools:** regenerate .windsurfrules after rule edits ([a5a0bfe](https://github.com/event4u-app/agent-config/commit/a5a0bfe1cffbc461692db85e96b4bc292ecdeb21))
+* add mcp for ai ([0dd133a](https://github.com/event4u-app/agent-config/commit/0dd133a92b239764d451b5764e0408a9d84c74dc))
+
+### Other
+
+* R1-P2: state schema v1 + v0 to v1 migration ([e7b1469](https://github.com/event4u-app/agent-config/commit/e7b1469443d9bd2496ab9f61f76c508698ac7516))
+* R1-P2-FIX: scope outer pytest away from golden sandbox ([f2414d8](https://github.com/event4u-app/agent-config/commit/f2414d8e0a5d6a85d96f6a886dbb2a8ef13705fb))
+* R1-P1-LOCK: freeze implement-ticket behavioural baseline ([21a7a96](https://github.com/event4u-app/agent-config/commit/21a7a96e705642a6ea59682d28791e28650446e3))
+* R1-P1: capture sandbox + Golden Transcripts for implement-ticket ([f0073c7](https://github.com/event4u-app/agent-config/commit/f0073c7fcfc6cc6a6080eb69cc4c33e922265fd5))
+
 ## [1.13.0](https://github.com/event4u-app/agent-config/compare/1.12.0...1.13.0) (2026-04-27)
 
 ### Features