@event4u/agent-config 4.3.0 → 4.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/.agent-src/commands/agents/user/init.md +7 -13
  2. package/.agent-src/commands/agents/user/show.md +4 -4
  3. package/.agent-src/commands/post-as/me.md +6 -6
  4. package/.agent-src/contexts/execution/autonomy-mechanics.md +1 -1
  5. package/.agent-src/contexts/execution/cheap-question-mechanics.md +4 -0
  6. package/.agent-src/templates/agents/agent-project-settings.example.yml +1 -1
  7. package/.claude-plugin/marketplace.json +1 -1
  8. package/CHANGELOG.md +28 -227
  9. package/config/discovery/packs.yml +9 -1
  10. package/config/discovery/workspaces.yml +14 -1
  11. package/dist/cli/agent-config.js +15 -10
  12. package/dist/cli/agent-config.js.map +1 -1
  13. package/dist/cli/commands/uiServe.js +27 -11
  14. package/dist/cli/commands/uiServe.js.map +1 -1
  15. package/dist/cli/registry.js +1 -1
  16. package/dist/cli/registry.js.map +1 -1
  17. package/dist/discovery/deprecation-report.md +1 -1
  18. package/dist/discovery/discovery-manifest.json +51 -8
  19. package/dist/discovery/discovery-manifest.json.sha256 +1 -1
  20. package/dist/discovery/discovery-manifest.summary.md +3 -3
  21. package/dist/discovery/orphan-report.md +1 -1
  22. package/dist/discovery/packs.json +25 -4
  23. package/dist/discovery/trust-report.md +1 -1
  24. package/dist/discovery/workspaces.json +4 -4
  25. package/dist/install/selectedTools.js +52 -0
  26. package/dist/install/selectedTools.js.map +1 -0
  27. package/dist/install/toolDetection.js +104 -0
  28. package/dist/install/toolDetection.js.map +1 -0
  29. package/dist/mcp/registry-manifest.json +3 -3
  30. package/dist/server/app.js +36 -0
  31. package/dist/server/app.js.map +1 -1
  32. package/dist/server/routes/ping.js +17 -0
  33. package/dist/server/routes/ping.js.map +1 -1
  34. package/dist/server/routes/wizard.js +280 -34
  35. package/dist/server/routes/wizard.js.map +1 -1
  36. package/dist/server/serverInfo.js +54 -0
  37. package/dist/server/serverInfo.js.map +1 -0
  38. package/dist/shared/userMd/formAdapter.js +1 -5
  39. package/dist/shared/userMd/formAdapter.js.map +1 -1
  40. package/dist/shared/userMd/schema.js +2 -1
  41. package/dist/shared/userMd/schema.js.map +1 -1
  42. package/dist/ui/assets/index-BAJQeVdX.js +40 -0
  43. package/dist/ui/assets/index-BAJQeVdX.js.map +1 -0
  44. package/dist/ui/assets/index-BbWWuFrF.css +1 -0
  45. package/dist/ui/index.html +2 -2
  46. package/docs/archive/CHANGELOG-pre-4.0.0.md +80 -0
  47. package/docs/archive/CHANGELOG-pre-4.5.0.md +289 -0
  48. package/docs/contracts/agent-user-schema.md +1 -3
  49. package/docs/contracts/discovery-manifest.schema.json +3 -1
  50. package/docs/contracts/gui-wizard.md +103 -8
  51. package/docs/decisions/ADR-013-discovery-frontmatter-contract.md +27 -0
  52. package/docs/decisions/ADR-021-deployment-shape.md +2 -2
  53. package/docs/deploy/connector-setup.md +2 -2
  54. package/docs/deploy/policy-cookbook.md +2 -2
  55. package/docs/examples/agent-user.example.md +0 -1
  56. package/package.json +1 -1
  57. package/scripts/__pycache__/validate_frontmatter.cpython-312.pyc +0 -0
  58. package/scripts/_lib/__pycache__/__init__.cpython-312.pyc +0 -0
  59. package/scripts/_lib/__pycache__/agent_src.cpython-312.pyc +0 -0
  60. package/scripts/build_discovery_manifest.py +4 -0
  61. package/scripts/condense.py +56 -1
  62. package/scripts/condense_memory.py +8 -2
  63. package/scripts/install.py +89 -43
  64. package/scripts/lint_discovery_vocabulary.py +8 -0
  65. package/dist/ui/assets/index-BDAhhpDV.js +0 -40
  66. package/dist/ui/assets/index-BDAhhpDV.js.map +0 -1
  67. package/dist/ui/assets/index-BXZILUxe.css +0 -1
@@ -26,7 +26,7 @@ install:
26
26
 
27
27
  Short interactive interview that creates **`.agent-user.md`** at the
28
28
  project root from the locked v1 schema in
29
- [`docs/contracts/agent-user-schema.md`](../../../../../docs/contracts/agent-user-schema.md).
29
+ [`docs/contracts/agent-user-schema.md`](../../../../../../../../docs/contracts/agent-user-schema.md).
30
30
 
31
31
  Use when:
32
32
 
@@ -81,20 +81,15 @@ Ask in this order. Each answer drives one frontmatter field.
81
81
  `Kurze Rollenbeschreibung (z. B. "founder/engineer", "product manager", "designer")` /
82
82
  `Short role label`
83
83
 
84
- 5. **Style — formality**.
85
- ```
86
- > 1. informal — Du / first-name (default)
87
- > 2. formal — Sie / full name
88
- ```
89
-
90
- 6. **Style — pace**.
84
+ 5. **Style — pace**. (Formality is not asked — the agent always uses
85
+ informal "Du".)
91
86
  ```
92
87
  > 1. pragmatic — balanced (default)
93
88
  > 2. thorough — more verification, longer replies
94
89
  > 3. rapid — shorter replies, fewer caveats
95
90
  ```
96
91
 
97
- 7. **Voice sample** — required.
92
+ 6. **Voice sample** — required.
98
93
  `Paste eine typische Nachricht von dir (1–3 Sätze, im normalen Schreibstil)` /
99
94
  `Paste one typical message of yours (1–3 sentences, your normal style)`
100
95
 
@@ -108,7 +103,7 @@ Before writing, scan the collected `voice_sample` and `role` for:
108
103
  - Health/legal status keywords.
109
104
 
110
105
  Hit → surface the line and ask the user to redact before proceeding.
111
- Per [`agent-user-schema § Explicit exclusions`](../../../../../docs/contracts/agent-user-schema.md#explicit-exclusions).
106
+ Per [`agent-user-schema § Explicit exclusions`](../../../../../../../../docs/contracts/agent-user-schema.md#explicit-exclusions).
112
107
 
113
108
  ### 5. Render and write
114
109
 
@@ -124,7 +119,6 @@ identity:
124
119
  language: "..."
125
120
  role: "..."
126
121
  style:
127
- formality: "..."
128
122
  pace: "...""
129
123
  voice_sample: |
130
124
  ...
@@ -155,7 +149,7 @@ Print the file path and a one-line summary:
155
149
 
156
150
  ```
157
151
  ✅ .agent-user.md written ({n} lines).
158
- identity: {nickname or name} · language: {lang} · role: {role} · style: {formality}/{pace}
152
+ identity: {nickname or name} · language: {lang} · role: {role} · style: {pace}
159
153
  ```
160
154
 
161
155
  Do NOT commit. Do NOT run any other `/agents user` sub-sub-command.
@@ -171,5 +165,5 @@ Do NOT commit. Do NOT run any other `/agents user` sub-sub-command.
171
165
 
172
166
  ## See also
173
167
 
174
- - Schema: [`agent-user-schema`](../../../../../docs/contracts/agent-user-schema.md).
168
+ - Schema: [`agent-user-schema`](../../../../../../../../docs/contracts/agent-user-schema.md).
175
169
  - Parent: [`/agents user`](../user.md).
@@ -26,7 +26,7 @@ install:
26
26
  # /agents user show
27
27
 
28
28
  Read-only render of the project-root `.agent-user.md` per
29
- [`docs/contracts/agent-user-schema.md`](../../../../../docs/contracts/agent-user-schema.md).
29
+ [`docs/contracts/agent-user-schema.md`](../../../../../../../docs/contracts/agent-user-schema.md).
30
30
 
31
31
  Use when:
32
32
 
@@ -55,7 +55,7 @@ Parse the YAML frontmatter and the body (everything after the second
55
55
  `---`). Validate against the locked v1 schema:
56
56
 
57
57
  - `version` is `1`.
58
- - `identity.name`, `language`, `role`, `style.formality`, `style.pace`,
58
+ - `identity.name`, `language`, `role`, `style.pace`,
59
59
  `voice_sample`, `last_updated` are all present.
60
60
  - File is ≤100 lines total.
61
61
 
@@ -73,7 +73,7 @@ Print the persona in this exact shape:
73
73
  Identity : {nickname or name} ({name} if nickname is set)
74
74
  Language : {language}
75
75
  Role : {role}
76
- Style : {formality} · {pace}
76
+ Style : {pace}
77
77
 
78
78
  Voice sample
79
79
  ─────────────
@@ -116,6 +116,6 @@ Do NOT chain to other `/agents user *` commands. Do NOT commit.
116
116
 
117
117
  ## See also
118
118
 
119
- - Schema: [`agent-user-schema`](../../../../../docs/contracts/agent-user-schema.md).
119
+ - Schema: [`agent-user-schema`](../../../../../../../docs/contracts/agent-user-schema.md).
120
120
  - Parent: [`/agents user`](../user.md).
121
121
  - Sibling: [`/agents user init`](init.md), [`/agents user update`](update.md).
@@ -59,13 +59,13 @@ Read the frontmatter:
59
59
  decisions (default-to-nickname when set), **not** appended to the
60
60
  output.
61
61
  - `language` — language of the draft.
62
- - `style.formality`, `style.pace` — mapped into the engine's
63
- fingerprint slot:
62
+ - `style.pace` — mapped into the engine's fingerprint slot. Register is
63
+ always `casual` (the agent addresses the user informally — "Du" — and
64
+ formality is not configurable):
64
65
 
65
66
  | `.agent-user.md` field | Engine fingerprint slot |
66
67
  |---|---|
67
- | `style.formality: informal` | `vocab_register: casual` |
68
- | `style.formality: formal` | `vocab_register: professional` |
68
+ | (always) | `vocab_register: casual` |
69
69
  | `style.pace: rapid` | `sentence_length_avg: 12` |
70
70
  | `style.pace: pragmatic` | `sentence_length_avg: 18` |
71
71
  | `style.pace: thorough` | `sentence_length_avg: 28` |
@@ -84,7 +84,7 @@ Flag form: `--tone=<formal|casual|neutral>`,
84
84
  `--audience=<text>`. Missing flags → interactive prompt, **one
85
85
  question per turn**, in the order Topic → Tone → Length → Channel →
86
86
  Audience. Defaults inherit from the engine's per-channel table and
87
- the formality / pace mapping above.
87
+ the pace mapping above.
88
88
 
89
89
  ### 4. Negative-constraint pass (skipped)
90
90
 
@@ -95,7 +95,7 @@ the formality / pace mapping above.
95
95
 
96
96
  Generate the body as a single fenced markdown block per
97
97
  [`write-engine § 4`](../../../docs/contracts/write-engine.md). Honour
98
- the loaded fingerprint (sentence-length ±25 %, formality, pace),
98
+ the loaded fingerprint (sentence-length ±25 %, pace),
99
99
  ±15 % length tolerance, write in `language`.
100
100
 
101
101
  ### 6. Disclosure footer (omitted — user is the author)
@@ -8,7 +8,7 @@ relevant. Detection logic lives in [`autonomy-detection.md`](autonomy-detection.
8
8
 
9
9
  | Value | Behavior |
10
10
  |---|---|
11
- | `on` | Suppress trivial questions. Act on the obvious next step. Still ask on blocking / critical decisions, and ALWAYS ask on Hard-Floor triggers. |
11
+ | `on` | Suppress trivial questions. Act on the obvious next step. **Never ask "weiter? / shall I continue? / soll ich fortfahren?" between clean batches** — a continuation prompt under `on` is a cheap question, forbidden by [`no-cheap-questions` Iron Law 4](../../rules/no-cheap-questions.md); the persistent setting alone arms that law (see [`cheap-question-mechanics § Iron Law 4`](cheap-question-mechanics.md#iron-law-4--halt-conditions-under-autonomous-mandate)). Still ask on blocking / critical decisions, and ALWAYS ask on Hard-Floor triggers. |
12
12
  | `off` | Ask trivial questions too. Use this if you want the agent to check in on each workflow step. |
13
13
  | `auto` (default) | Same as `off` by default. Flips to `on` for the rest of the conversation as soon as the user expresses the intent "stop asking, just work". See [detection logic](autonomy-detection.md) — match by **intent**, not exact string. The flip never lifts the Hard Floor. |
14
14
 
@@ -20,10 +20,14 @@ THE USER DECIDES WHEN TO STOP.
20
20
 
21
21
  A standing autonomous mandate is active when any of these fire:
22
22
 
23
+ - `personal.autonomy: on` in `.agent-settings.yml` — the **persistent** opt-in. No per-turn phrasing and no roadmap command is required; the durable setting alone arms this Iron Law. Missing key defaults to `on`, so the cloud/headless default arms it too.
24
+ - `auto` mode after the user opted in via a standing "just work" directive (per [`autonomous-execution § opt-in detection`](../../rules/autonomous-execution.md#opt-in-detection--match-by-intent-not-exact-string)).
23
25
  - `/roadmap:process-full` invocation.
24
26
  - `/roadmap:process-phase` invocation.
25
27
  - Explicit "entscheide selbst / decide and don't ask" in the current or a recent un-revoked turn.
26
28
 
29
+ The first two are the common case the persistent setting is *for*: a user who set `autonomy: on` never wants a "weiter? / shall I continue? / soll ich fortfahren?" prompt between clean batches. Treating those as cheap (IL 4) is not optional — it is the contract the setting promises.
30
+
27
31
  ### Halt conditions
28
32
 
29
33
  The only halts named in the invoking command:
@@ -39,7 +39,7 @@ schema_version: 1
39
39
  # CI guard: a release bump of `package.json` must update this value
40
40
  # in lockstep — see scripts/check_template_pin_drift.py (road-to-
41
41
  # portable-runtime-and-update-check P3.3).
42
- agent_config_version: "4.1.0"
42
+ agent_config_version: "4.3.0"
43
43
 
44
44
  # --- Project identity ---
45
45
  project:
@@ -6,7 +6,7 @@
6
6
  },
7
7
  "metadata": {
8
8
  "description": "Shared agent configuration \u2014 skills for AI coding tools (Claude Code, Augment, Cursor, Cline, Windsurf, Gemini CLI).",
9
- "version": "4.3.0",
9
+ "version": "4.6.0",
10
10
  "keywords": [
11
11
  "agent-config",
12
12
  "skills",
package/CHANGELOG.md CHANGED
@@ -786,252 +786,53 @@ our recommendation order, not its support status.
786
786
  users" tension without removing any path that an existing user
787
787
  might rely on.
788
788
 
789
- # Era: 3.2.xcurrent
789
+ # Era: pre-4.5.0archived
790
790
 
791
- > Started at `3.2.0` (2026-05-25). Full entries live inline below.
792
- > The drift test caps this era at 250 lines of entry body; growth past
793
- > that forces a new era split (`# Era: 3.3.x`, etc.) — see
794
- > [`docs/contracts/CHANGELOG-conventions.md § Era splits`](docs/contracts/CHANGELOG-conventions.md).
795
-
796
- ## [4.3.0](https://github.com/event4u-app/agent-config/compare/4.2.0...4.3.0) (2026-05-27)
797
-
798
- ### Features
799
-
800
- * **init:** open the browser wizard directly when the GUI is usable ([aef9c0f](https://github.com/event4u-app/agent-config/commit/aef9c0ff10a06ab1e057bb93dbb8ec908398673e))
801
-
802
- ### Documentation
803
-
804
- * **gui-wizard:** init opens the GUI in the TS CLI, not via install.py ([7a2a29d](https://github.com/event4u-app/agent-config/commit/7a2a29d5878f6177aea0d710bed11e89d4c35c36))
805
-
806
- ### Tests
807
-
808
- * **init:** cover GUI-vs-CLI routing for the install front-end ([2f593a6](https://github.com/event4u-app/agent-config/commit/2f593a6bc52996ebc189aeeb595ca4d513a332e5))
809
-
810
- Tests: 5052 (+0 since 4.2.0)
811
-
812
- ## [4.2.0](https://github.com/event4u-app/agent-config/compare/4.1.0...4.2.0) (2026-05-27)
813
-
814
- ### Features
815
-
816
- * **wizard:** GUI apply streams the real install.py bridge (SSE) ([7d8963d](https://github.com/event4u-app/agent-config/commit/7d8963d7108671a359153c1360cca79b77a1ca5b))
817
- * **install:** wire --apply-payload real-apply + NDJSON; fix GUI-launch drift ([7f1159a](https://github.com/event4u-app/agent-config/commit/7f1159a77b0de6cdafae7e913aae4e3795c2abf0))
818
-
819
- ### Bug Fixes
820
-
821
- * **install:** validate /plan output via InstallPlanWireSchema ([4548ffe](https://github.com/event4u-app/agent-config/commit/4548ffe2275e79b7d901a5a11183f0ff7023b9bd))
822
- * **lint:** allowlist cross-stack noise-segment doc in module-detect-on-the-fly ([49ee5c3](https://github.com/event4u-app/agent-config/commit/49ee5c36cdea06e7b7614b8b84ab5d7560e0d0ec))
823
- * **template:** bump agent-project-settings.example pin to 4.1.0 ([7b918be](https://github.com/event4u-app/agent-config/commit/7b918be7f187c7cb2f597622fcd7a9bf3209fbe2))
824
- * **settings:** add roadmap.skip_pre_run_gate to the settings schema ([2221757](https://github.com/event4u-app/agent-config/commit/2221757d7860c23b6ddd264371ff5e8f56293e67))
825
-
826
- ### Documentation
827
-
828
- * **roadmap:** refresh dashboard after archiving single-install roadmap ([38a6c89](https://github.com/event4u-app/agent-config/commit/38a6c89971429c42823a3a60eff6f595a1010f43))
829
- * **roadmap:** complete + archive road-to-single-install-source-of-truth ([ff06721](https://github.com/event4u-app/agent-config/commit/ff06721390eb09e55d4474b1e9dfd37be8b91cd8))
830
- * **roadmap:** track + complete road-to-single-install-source-of-truth ([2ee7162](https://github.com/event4u-app/agent-config/commit/2ee7162b4a4040eac72096b7cda3fb3f76966561))
831
- * align gui-wizard contract + README init story with the real GUI ([a2864a1](https://github.com/event4u-app/agent-config/commit/a2864a1c337d2e14f6e206e12d002d9793eb360d))
832
-
833
- ### Refactoring
834
-
835
- * **install:** retire the parallel TypeScript apply mirror ([f4a5702](https://github.com/event4u-app/agent-config/commit/f4a5702d7919e95d7c641fe9e2788cfecef48e2c))
836
-
837
- ### Tests
838
-
839
- * **install:** parity, headless, and WIZARD_READY handshake coverage ([ef048c9](https://github.com/event4u-app/agent-config/commit/ef048c935c33f8b63f57d4c70af5af137759c831))
840
-
841
- ### Chores
791
+ > All entries before `4.5.0` live in
792
+ > [`docs/archive/CHANGELOG-pre-4.5.0.md`](docs/archive/CHANGELOG-pre-4.5.0.md).
793
+ > The archive is read-only; git tags remain the canonical
794
+ > source for what shipped. Splitting them out of the main file
795
+ > keeps the active era under the 250-line drift cap enforced by
796
+ > `tests/test_changelog_eras.py`.
842
797
 
843
- * commit leftovers ([c4e3ef1](https://github.com/event4u-app/agent-config/commit/c4e3ef1b727918ff8baf9cf3e8d014148d5182b3))
798
+ # Era: 4.5.x — current
844
799
 
845
- Tests: 5052 (+9 since 4.1.0)
800
+ > Started at `4.5.0`. Full entries live inline below.
801
+ > The drift test caps this era at 250 lines of entry body; growth past
802
+ > that forces a new era split (`# Era: 4.6.x`, etc.) — see
803
+ > [`docs/contracts/CHANGELOG-conventions.md § Era splits`](docs/contracts/CHANGELOG-conventions.md).
846
804
 
847
- ## [4.1.0](https://github.com/event4u-app/agent-config/compare/3.3.0...4.1.0) (2026-05-27)
805
+ ## [4.6.0](https://github.com/event4u-app/agent-config/compare/4.5.0...4.6.0) (2026-05-28)
848
806
 
849
807
  ### Features
850
808
 
851
- * **roadmap:** restore skip_pre_run_gate (default true) to suppress the process-* confirmation ([746b472](https://github.com/event4u-app/agent-config/commit/746b472cc7ebb626114042ba18c91aa93ff36383))
852
- * **adoption-signal:** signal-floor contract + snapshot collector + report rollup ([0a8ad93](https://github.com/event4u-app/agent-config/commit/0a8ad9361f15e25d8ff981d25b666d2b03cbd3a2))
853
- * **mcp-registry:** submission helper + tracking sheet + adoption dashboard ([817d1a5](https://github.com/event4u-app/agent-config/commit/817d1a521e826766646da862900ff54be9f0d0e4))
854
- * **recruit-sessions:** runbook + preflight script + tests ([9c6f50b](https://github.com/event4u-app/agent-config/commit/9c6f50b9a9c55a4c69e7b7ace66bde970ccc6238))
855
- * **ci:** ci-green-floor contract + ci_status.py phantom filter ([d5eb355](https://github.com/event4u-app/agent-config/commit/d5eb35593685b82cd554829c75fe6cdc375cf378))
856
- * **bench-ab:** phase 5 — report renderer + task entries + linter + contract ([c47960f](https://github.com/event4u-app/agent-config/commit/c47960feab0cd8a69f6c5e494eefd2a5346b71b3))
857
- * **bench-ab:** phase 4 — track B task corpus + runner + scoring ([9f389da](https://github.com/event4u-app/agent-config/commit/9f389da0cc6ba74436e5842e54215eece23588d2))
858
- * **bench-ab:** phase 3 — track A behavioural eval A/B ([56473ae](https://github.com/event4u-app/agent-config/commit/56473ae952b897623b1ff67b838a25cc16bef558))
859
- * **bench-ab:** phase 2 — runner extension + baseline cache ([cb20841](https://github.com/event4u-app/agent-config/commit/cb20841a50de1d61afce2c1c7adb20600e0f8cb3))
860
- * **bench-ab:** phase 1 — variant target + clone scaffolding ([296cb68](https://github.com/event4u-app/agent-config/commit/296cb683121e6ad6970527e20b18c09b3b837008))
861
- * **roadmap:** add package-impact benchmark plan ([13ad7b0](https://github.com/event4u-app/agent-config/commit/13ad7b0eea415e42617fdacc3970c5a88fcde217))
862
- * **roadmap:** add skip_pre_run_gate to suppress process-* confirmation ([87f12fa](https://github.com/event4u-app/agent-config/commit/87f12faf748674994e7d9d0f1ea48689103f5664))
863
- * **ci:** lint_role_experiences.py + plain-language surface contract ([9845a1b](https://github.com/event4u-app/agent-config/commit/9845a1bbfd3f1ed66dec5b5c2f9bdf4b788296ff))
864
- * **roles:** add sales/support/leadership + prompts for galabau/content-creator/consultant ([1846c1c](https://github.com/event4u-app/agent-config/commit/1846c1cfbbd37def8f87181292d329b8e901d4aa))
865
- * **workspace:** ship WorkspacePage UI + a11y audit + Playwright suite ([bd469cc](https://github.com/event4u-app/agent-config/commit/bd469cc6d6d9371af96b6bbf2bc58405e0fcfc03))
866
- * **workspace:** add /api/v1/workspace/* server routes ([d6ef98e](https://github.com/event4u-app/agent-config/commit/d6ef98e91d5df42bcb5c999efa3e980e6a0f9e9f))
867
- * **rules:** forbid decorative emojis in git surfaces ([265c3f6](https://github.com/event4u-app/agent-config/commit/265c3f6c78244eb6a56e0c1ba0613f2c0d5f5c29))
868
- * **ci:** skip heavy matrices on release PRs + add release-validation workflow ([26f26b9](https://github.com/event4u-app/agent-config/commit/26f26b97acd85b09fc26b2922e7885643403afe8))
869
- * **rules:** gate unsolicited PR progress comments behind personal.pr_progress_comments ([4183131](https://github.com/event4u-app/agent-config/commit/41831315f12974ba1e326953c7abb98a0f14e7c8))
870
- * **install:** bash bootstrap for the v4 unified setup wizard ([5519441](https://github.com/event4u-app/agent-config/commit/551944156c5c330a1b703e12ffba9bb3612ccdae))
871
- * **install:** wizard conflict UI + recovery + continue + backup screens ([462cfbf](https://github.com/event4u-app/agent-config/commit/462cfbfa77583e50ea4aae167a4c2318ee7f0cb2))
872
- * **install:** wizard state → plan (Phase B2) ([5e73633](https://github.com/event4u-app/agent-config/commit/5e736331710c13d4af8f6ec0283e0b32fe6693f1))
873
- * **install:** unified setup wizard dispatch + install API with SSE progress ([4f932e1](https://github.com/event4u-app/agent-config/commit/4f932e1707645facbf1967cca086a182f6416b19))
874
- * **install:** port AI-tool bridge generators (A6) ([62234bf](https://github.com/event4u-app/agent-config/commit/62234bf89ca2469bd1e854ea3dba3ddc0bb3a7b0))
875
- * **install:** conflict resolution strategies (A5) ([b0f39f8](https://github.com/event4u-app/agent-config/commit/b0f39f827051cd05a838c6a07942678080574d01))
876
- * **install:** atomic write + transaction log + apply pipeline (A4) ([885fc99](https://github.com/event4u-app/agent-config/commit/885fc9949655bec37d73659e954eb76bee3664b4))
877
- * **install:** plan generator with conflict diffing (A3) ([81f3298](https://github.com/event4u-app/agent-config/commit/81f3298c04b8ccd6de5d277bafdf0bc1d7b88110))
878
- * **install:** port project + AI-tool detection (A2) ([0f5c977](https://github.com/event4u-app/agent-config/commit/0f5c97720e188d6e4410f84638979d18289f4aa5))
879
- * **install:** scaffold TS install-engine workspace (A1) ([3a2e41c](https://github.com/event4u-app/agent-config/commit/3a2e41c29f6516db35a75d26167ac460e1aad7e1))
880
- * **ui:** unify shell with 6-tab navigation (Setup, Tasks, Council, Memory, Explain, Workspace) ([5ad6f22](https://github.com/event4u-app/agent-config/commit/5ad6f22abfd4cf29b6f5d4c7e8cfddfd5b126ad7))
881
- * **cli:** wire extended-steps flag through setup command ([4192d8d](https://github.com/event4u-app/agent-config/commit/4192d8d89fbb985559bda6549c526f796c1c9c81))
882
- * **wizard:** expand to 10-step extended flow with ai-tools, packs, modules ([55f88da](https://github.com/event4u-app/agent-config/commit/55f88daf48fa66ff51f892c6ef439f8b1dc0b8be))
883
- * **wizard:** scope-guard + probe + harness-expectations endpoints ([3ced286](https://github.com/event4u-app/agent-config/commit/3ced2864425f9f2eb0906ff5ecd163320d12a174))
884
- * **install:** canonical-channel discipline + scope guard + skill probe ([bbd434c](https://github.com/event4u-app/agent-config/commit/bbd434c4655e96c0c44919ea01ba11b8dd6e4e80))
885
- * **modules:** on-the-fly module detection skill + acknowledge flag ([10d0044](https://github.com/event4u-app/agent-config/commit/10d00441f8a2fe23b1eb98fa0f87cd3bad859b61))
886
- * **wizard:** add modules step to onboarding GUI ([92cc851](https://github.com/event4u-app/agent-config/commit/92cc851f4e57e83e64906202925cfc74f24293a7))
887
- * **skills:** per-module agents/ folder discovery (Phase D) ([c174f73](https://github.com/event4u-app/agent-config/commit/c174f73978f08929cb84f734416c6d4f35d903c7))
888
- * **skills:** generalize module-management + neutrality linter (Phase C) ([c653f39](https://github.com/event4u-app/agent-config/commit/c653f396624835732aa083df7d76ca16876e92d7))
889
- * **install:** detect modules during install + /agents init (Phase B) ([c0e9b6a](https://github.com/event4u-app/agent-config/commit/c0e9b6aa5da93a752271b45383d335930024e82f))
890
- * **modules:** add modules config block + loader (Phase A) ([2bd0bd2](https://github.com/event4u-app/agent-config/commit/2bd0bd20acacc06b6c342ced4e08017145e715a8))
891
-
892
- ### Bug Fixes
893
-
894
- * **ci:** allow agents/.agent-tools.yml at agents/ root ([eadb5fa](https://github.com/event4u-app/agent-config/commit/eadb5fa290c3edbae8763ea1a2fa605fa549f35b))
895
- * **ci:** trim AGENTS.md back under Thin-Root 3000-char hard cap ([1a2530b](https://github.com/event4u-app/agent-config/commit/1a2530b9670fb9088ed1a42d91c007c54975f142))
896
- * **ci:** minimal retirement stub at packages/core/installer/ for the legacy Node-Tests job ([ae37148](https://github.com/event4u-app/agent-config/commit/ae371487c1c8c44ba0aa837ea42ca3bbd9b5cd3b))
897
- * **skill-lint:** mirror agent-handoff trigger_context fix into compressed copy ([b17c4ef](https://github.com/event4u-app/agent-config/commit/b17c4ef8cfde53ddeb7ba764622020203a61b10b))
898
- * **projection:** drop stale .claude/skills/install-via-agent/SKILL.md symlink ([21a6588](https://github.com/event4u-app/agent-config/commit/21a6588b9d9bf71cc322bffabf299585b3493fab))
899
- * **ci:** bump always-rule top-3 concentration ceiling 10_900 → 11_300 ([8a7f301](https://github.com/event4u-app/agent-config/commit/8a7f301935d3bd28306bbdd098071b522eaf6f1b))
900
- * **portability:** rephrase `task sync` → "sync pipeline" in cheap-question-mechanics ([5341087](https://github.com/event4u-app/agent-config/commit/534108756e13a8ddec4bb27d6a3e9ebd7a677aec))
901
- * **ci:** clear v4 install-cutover blockers on PR #244 ([a031da4](https://github.com/event4u-app/agent-config/commit/a031da428c1427ea8080d56cc11c2e3db7efa356))
902
- * **authority:** block execution offers after roadmap/vision artifact save ([d30d441](https://github.com/event4u-app/agent-config/commit/d30d441e27c0820df82102e7afa4a12e4cb45cac))
903
- * **installer:** accept monorepo packs/<pack>/.agent-src.uncompressed/ prefix ([ac0b716](https://github.com/event4u-app/agent-config/commit/ac0b71651512b39c1f207204b1e3b02d33440031))
904
- * **ci:** AGENTS.md size cap + scope_guard bash 5 set -e compatibility ([6018308](https://github.com/event4u-app/agent-config/commit/6018308ec622e29eaab42c35d43b462569a192db))
905
- * **tests:** mirror agent_settings.py into work_engine template copy ([a755bb7](https://github.com/event4u-app/agent-config/commit/a755bb7cc2a0cc8b3f4dcbf2c24ba37ef8738472))
906
- * **adr:** allow council refs in ADR decision-trace blocks ([f069596](https://github.com/event4u-app/agent-config/commit/f069596537c8ebd4ad6f2d828357d29e3a835739))
907
- * **contracts:** align stability frontmatter for v0/design contracts ([f8020e9](https://github.com/event4u-app/agent-config/commit/f8020e94acee9639410a60038357c9db21b9fd2d))
908
- * **tests:** mirror agent_settings.py into work_engine template copy ([029e9c4](https://github.com/event4u-app/agent-config/commit/029e9c4d967974aa7acf25b3331f9bf4e80dcc4d))
909
- * **lint-agents-md:** trim consumer-template Thin-Root bullet ([dc4e8e6](https://github.com/event4u-app/agent-config/commit/dc4e8e6253ba081799e9f4c84c151bb442af75b3))
910
- * **skill-lint:** trim module-management description + add analysis gate ([046ef48](https://github.com/event4u-app/agent-config/commit/046ef48ed7f318875fc6cf84157fe75c432f9608))
911
- * **ci:** skip agents/tmp + allowlist module-aware Laravel-shape examples ([c351758](https://github.com/event4u-app/agent-config/commit/c351758daedc76b2234b7fab8643403b11173e64))
912
- * **check-refs:** mark forward-ref to recruit-sessions/01-galabau-owner with ref-ignore ([dea821a](https://github.com/event4u-app/agent-config/commit/dea821af02dbd335884f95f89b868c55e6338cce))
913
-
914
- ### Performance
915
-
916
- * **ci:** extract windows-lockfile + python-version sweep to path-filtered workflows ([e2d17f0](https://github.com/event4u-app/agent-config/commit/e2d17f071149884505d10e246421d13b67efed58))
809
+ * **wizard:** global-only settings + dedicated Projekt surface ([dc229a9](https://github.com/event4u-app/agent-config/commit/dc229a9a61f0a14527b5c85f0cb7db03fbbc72f8))
810
+ * **install:** deliver Claude hooks via plugin scope ([f76a7d1](https://github.com/event4u-app/agent-config/commit/f76a7d16e09369dacc466fb838463e5f04616480))
917
811
 
918
812
  ### Documentation
919
813
 
920
- * **posture:** record 2026-05 feedback citation against the cancellation wall ([f96b9c7](https://github.com/event4u-app/agent-config/commit/f96b9c7973c8be8d33252ad0330c8bd3126b4341))
921
- * **ci:** wire `task ci:required-checks` + cross-links + archive roadmap ([069833c](https://github.com/event4u-app/agent-config/commit/069833c00cf13e3af34bd0328daecce61ef0ab11))
922
- * **ci:** release-PR gating contract + shape detector + tests ([380e059](https://github.com/event4u-app/agent-config/commit/380e0591dcb661cb3da2e84089bcc1b6fb5cf397))
923
- * **internal:** document new umbrella occupants in AGENTS.md and internal/README.md ([0b1a384](https://github.com/event4u-app/agent-config/commit/0b1a384db1545576208c50accebba92977ded335))
924
- * **roadmap:** mark Phase B3-E3 done + archive road-to-unified-setup ([64162ab](https://github.com/event4u-app/agent-config/commit/64162abda143286d058b432018f0058fc71cca98))
925
- * **roadmap:** mark Phase B0+B1 done on road-to-unified-setup ([098b809](https://github.com/event4u-app/agent-config/commit/098b8096d09449e2b358333691cc50f20ded5a58))
926
- * **roadmap:** mark Phase A (A1-A6) done on road-to-unified-setup ([49a983b](https://github.com/event4u-app/agent-config/commit/49a983bcfc0a2974f41e53dbabed209730eac682))
927
- * **roadmap:** add road-to-unified-setup v4.0.0 plan ([9601a81](https://github.com/event4u-app/agent-config/commit/9601a81fa88c248e9e7a4941ab25a462853953f1))
928
- * distribution-channels + install-scopes + harness-expectations ([1351f51](https://github.com/event4u-app/agent-config/commit/1351f5102aabec85e09d7bc1433aeb265ac706f4))
929
- * **roadmap:** close Phase E - Step 4 Won't do, archive roadmap ([842ef8e](https://github.com/event4u-app/agent-config/commit/842ef8eec2599a1e38b633a88db99afccaaf0f8b))
930
- * **roadmap:** close Phase E for road-to-configurable-modules ([6cd2b56](https://github.com/event4u-app/agent-config/commit/6cd2b56e302b81ec601544bd90a5f51295d98c43))
931
- * **roadmap:** mark configurable-modules Phases A-D complete + regen dashboard ([c4f1682](https://github.com/event4u-app/agent-config/commit/c4f16829f13d4bb4c727be4cd1f77bf90407e015))
932
- * **roadmap:** land 5 new roadmaps + regen progress dashboard ([94c5192](https://github.com/event4u-app/agent-config/commit/94c5192090aa54df2958120224d33869b707bceb))
933
-
934
- ### Refactoring
935
-
936
- * **naming:** rename compress→condense and caveman→telegraph across the suite ([6a72697](https://github.com/event4u-app/agent-config/commit/6a7269713c11dd10ae2b975d921207de2e0e08de))
937
- * relocate .compression-hashes.json + .agent-tools.yml and rewrite path consumers ([6e545c8](https://github.com/event4u-app/agent-config/commit/6e545c8563aff3e0dc9c3c9b80148d4bc83c4337))
938
- * **internal:** move docker/ + schemas/ to internal/ umbrella ([5cf589b](https://github.com/event4u-app/agent-config/commit/5cf589bbefdaedf29e01a8b906f59176d690ed0e))
814
+ * **roadmap:** archive road-to-wizard-sse-hardening (complete) ([e565624](https://github.com/event4u-app/agent-config/commit/e5656240cca738acc5ba2aa3804d9d067820d071))
815
+ * **roadmap:** mark wizard-sse-hardening Phase 1+2 done, sync dashboard ([6df030b](https://github.com/event4u-app/agent-config/commit/6df030b87cb6980c0118168af4e0140551b4678f))
939
816
 
940
817
  ### Tests
941
818
 
942
- * regression coverage for distribution-channels track ([5ddc493](https://github.com/event4u-app/agent-config/commit/5ddc493fac8b05ec297f4b0f1714fb294f402ef7))
819
+ * **wizard:** cover SSE apply endpoint failure paths ([9ffa068](https://github.com/event4u-app/agent-config/commit/9ffa068a898038f2e880f1a28ceb979cb5bb56cf))
943
820
 
944
821
  ### Chores
945
822
 
946
- * **roadmap:** wire ci:status + adoption:* tasks; close out adoption-proof-and-ci-green ([7421b6d](https://github.com/event4u-app/agent-config/commit/7421b6d52fa10e4e327d142717e0ee5f31f86747))
947
- * add new hooks ([75708a5](https://github.com/event4u-app/agent-config/commit/75708a5bbde1380cb1ec54f6bc8aca086073f7a6))
948
- * **roadmap:** close out frictionless-employee-workspace + regen dashboard ([5f1d376](https://github.com/event4u-app/agent-config/commit/5f1d376e741704a7602fefd283b469326ff749f0))
949
- * **roadmaps:** archive road-to-deep-root-restructure (15/15 closed) ([1088332](https://github.com/event4u-app/agent-config/commit/10883323745485cab9ed7aaa3af12789a169549f))
950
- * regenerate packages/core/{README.md,pack.yaml} after the new rule ([1847ae0](https://github.com/event4u-app/agent-config/commit/1847ae0e81cf764ec8dbe7e4dab49bac4d5f8433))
951
- * update gitignor ([cc9a247](https://github.com/event4u-app/agent-config/commit/cc9a247beef83644de525d4f5574bc544b78cbaa))
952
- * **docs:** drop command count from 136 → 135 after install-via-agent removal ([fecba73](https://github.com/event4u-app/agent-config/commit/fecba73b0f5b9c0c4a723a860cad0b0aff0f4a1f))
953
- * **release:** bump to v4.0.0 + CHANGELOG hard-cut entry ([fa538ae](https://github.com/event4u-app/agent-config/commit/fa538ae6a347398925c06b89ebaa1a1809fd7a39))
954
- * **install:** remove legacy TS installer workspace + reference cleanup ([3aa1e93](https://github.com/event4u-app/agent-config/commit/3aa1e93f58f98d6d0feeb1e066674a21eeaf2f40))
955
- * **commands:** harden agent-handoff trigger detection and fenced-output contract ([1be7c7c](https://github.com/event4u-app/agent-config/commit/1be7c7ca813036129449e5020ab9dd78f02d4910))
956
- * **gitignore:** close nested node_modules hole, drop stale tracked entries ([0ad9963](https://github.com/event4u-app/agent-config/commit/0ad9963f705811a2cbbecc2ac591a1f4d2b82d9d))
957
- * **rules:** harden commit-chunking and cheap-question floors ([d824408](https://github.com/event4u-app/agent-config/commit/d824408c021095455eacb5e6d7f8169eafb76808))
958
- * **workspaces:** scope npm workspaces to installer only ([c227f53](https://github.com/event4u-app/agent-config/commit/c227f5350c533a5094f3f5954c4aec67fdf42581))
959
- * **roadmap:** audits + recruit findings placeholder for distribution-channels ([e739618](https://github.com/event4u-app/agent-config/commit/e739618f239f2fa58b26e256c0873e401b0f5f53))
960
- * **generated:** regenerate sync outputs + counts for module-detect-on-the-fly ([ea624f3](https://github.com/event4u-app/agent-config/commit/ea624f348a90c88d214ccf7f9bdfdbd362dfa5ee))
961
- * **generated:** regenerate ownership matrix, catalog, agent index ([796f674](https://github.com/event4u-app/agent-config/commit/796f674a2d29ee4f26438a53fd1e967966111848))
962
- * **template:** bump agent_config_version to 3.3.0 ([76dcbc8](https://github.com/event4u-app/agent-config/commit/76dcbc8549b771bc930fbd15f9e5e819bee0f736))
823
+ * **changelog:** split era 4.1.x pre-4.5.0 ([44f40d6](https://github.com/event4u-app/agent-config/commit/44f40d6b166ed259b274fd91f63b01369f986346))
824
+ * **changelog:** split era 4.1.x → pre-4.5.0 ([69df8cf](https://github.com/event4u-app/agent-config/commit/69df8cf306763dff55c5639ac018e57c7596b461))
963
825
 
964
- ### Other
826
+ Tests: 5064
965
827
 
966
- * Revert "feat(roadmap): add skip_pre_run_gate to suppress process-* confirmation" ([e918d51](https://github.com/event4u-app/agent-config/commit/e918d516140cc0d6d8f432f8207626c81334ad86))
828
+ # Era: pre-4.0.0 archived
967
829
 
968
- Tests: 5043 (+105 since 3.3.0)
969
-
970
- ## [3.3.0](https://github.com/event4u-app/agent-config/compare/3.2.0...3.3.0) (2026-05-25)
971
-
972
- ### Features
973
-
974
- * **scripts:** point bench / eval / mcp tooling at internal/ (ADR-028 phase 1) ([c20b515](https://github.com/event4u-app/agent-config/commit/c20b515dfc80d03244e54af7b50e07d562647799))
975
-
976
- ### Bug Fixes
977
-
978
- * **ci:** repoint bench/ -> internal/bench/ in projected agent-status + condense-memory ([682040b](https://github.com/event4u-app/agent-config/commit/682040b230248bd054767ab10bd1e90ed3a1d0b7))
979
-
980
- ### Documentation
981
-
982
- * **roadmap:** archive road-to-root-layout-cleanup at 100% complete ([948f1a8](https://github.com/event4u-app/agent-config/commit/948f1a8cd9ec63fa831d5abab25aeb3657a0a7d4))
983
- * **adr:** land Phase 2 audit evidence + ADR-029 multi-workspace deferral ([c4dabf1](https://github.com/event4u-app/agent-config/commit/c4dabf1f718fee0d4709d727d1e3eb781f8db62f))
984
- * **adr:** land ADR-028 + root-layout-cleanup roadmap ([7b0fd28](https://github.com/event4u-app/agent-config/commit/7b0fd281288a87f9c218d9fa9d73f01a48a56626))
985
- * repoint bench / mcp-worker paths to internal/ (ADR-028 phase 1) ([85278dd](https://github.com/event4u-app/agent-config/commit/85278dd831d44a187dcfe7684e895bac0ca97ae4))
986
-
987
- ### Chores
988
-
989
- * **root:** move bench/ and workers/ under internal/ (ADR-028 phase 1) ([2a1dd1e](https://github.com/event4u-app/agent-config/commit/2a1dd1e363f9aabb59b6eebf35f64a47609abebb))
990
- * **roadmap:** close changelog-era-auto-split (Phase 4 → ADR-027) ([b10b326](https://github.com/event4u-app/agent-config/commit/b10b32623b42739f0eba12a52173b810169929b6))
991
-
992
- Tests: 4938 (+9 since 3.2.0)
993
-
994
- ## [3.2.0](https://github.com/event4u-app/agent-config/compare/3.1.1...3.2.0) (2026-05-25)
995
-
996
- ### Features
997
-
998
- * **workspace:** GUI bridge + Workspace tab for Phases 4-8 backends ([6911b56](https://github.com/event4u-app/agent-config/commit/6911b56d1e474dace4a250d077ed93f628b029be))
999
- * **workspace:** backend Python modules for Phases 5/6/7/8 ([c890fde](https://github.com/event4u-app/agent-config/commit/c890fde556b24e6b69409a4f0f647cace3779320))
1000
- * **memory:** wire knowledge namespace into hybrid retrieval ([a65ae2c](https://github.com/event4u-app/agent-config/commit/a65ae2c117ac10aff78ac711316b441d2ee2f42c))
1001
- * **knowledge:** implement local knowledge ingestion module ([d842ba3](https://github.com/event4u-app/agent-config/commit/d842ba350f325293f0faafe4698b8bbbe77033f8))
1002
- * **knowledge:** add /knowledge command cluster source files ([9023c17](https://github.com/event4u-app/agent-config/commit/9023c17049ea42769537919df5ca10db1cc785e7))
1003
- * **roadmap:** land road-to-employee-product-and-external-proof + consumer docs ([b2901ad](https://github.com/event4u-app/agent-config/commit/b2901ad516a6bb209b7fadae884563025a090e4d))
1004
- * **roles:** scaffold consultant, content-creator, galabau experiences ([55384df](https://github.com/event4u-app/agent-config/commit/55384df486cba24288f38275435d151c5c7b8762))
1005
-
1006
- ### Bug Fixes
1007
-
1008
- * **knowledge:** use agent-config-maintainer workspace per discovery vocabulary ([75f78ab](https://github.com/event4u-app/agent-config/commit/75f78ab2999ed5fbc261aecf9fadd692588a2498))
1009
- * **check-refs:** mark forward-refs to recruit-sessions with ref-ignore ([147909b](https://github.com/event4u-app/agent-config/commit/147909b4428492ad8332959635573a1ab419d865))
1010
-
1011
- ### Documentation
1012
-
1013
- * **roadmap:** mark Phases 4-8 backend complete + regen progress dashboard ([38b82f9](https://github.com/event4u-app/agent-config/commit/38b82f9928d57c9c7cfabd0b75f3c1284b6e2dcb))
1014
- * **roadmap:** mark Phase 2 done + sync command counts ([4089810](https://github.com/event4u-app/agent-config/commit/4089810f2123a0838e318fb442e975f6f60faf00))
1015
- * **knowledge:** add user guide and update contract for impl reality ([9fbea43](https://github.com/event4u-app/agent-config/commit/9fbea43033471e2daf2ef91342212a3480e24f93))
1016
- * **deploy:** add team-deployment-posture + small-team-recipe + stubs ([0892317](https://github.com/event4u-app/agent-config/commit/08923177dbd62346456a4992b8ab06e0442fb0cf))
1017
- * **contracts:** add 8 contracts for Daily Workspace + role experience ([34f882c](https://github.com/event4u-app/agent-config/commit/34f882c815fa2366956f2f454534bd9f18f79e04))
1018
- * **adr:** add ADR-022..026 for Daily Workspace architecture ([034eb99](https://github.com/event4u-app/agent-config/commit/034eb99569fcf388099b059ae5e8fb0537d902e3))
1019
-
1020
- ### CI
1021
-
1022
- * **visibility:** drop push-trigger ghost-runs from drift workflows ([1704683](https://github.com/event4u-app/agent-config/commit/1704683ff0f08985e750b7cb6c8555812f349914))
1023
-
1024
- ### Chores
1025
-
1026
- * **gitignore:** ignore pnpm-lock.yaml (repo uses npm) ([088fae6](https://github.com/event4u-app/agent-config/commit/088fae6ef8377200185826c31ea8adc0b97573f4))
1027
- * **counts:** sync command count to 136 (analytics cluster added) ([1d56496](https://github.com/event4u-app/agent-config/commit/1d564962bd57aedc6d4ff2ae6b757e45e8a63e2c))
1028
- * **release:** bump agent_config_version in templates to match package.json 3.1.1 ([4864332](https://github.com/event4u-app/agent-config/commit/4864332804fe9979a4f94cb053cdd13c7473ac40))
1029
- * **sync:** regenerate index + catalog for analytics commands ([77cb4fa](https://github.com/event4u-app/agent-config/commit/77cb4fa41d8b2773e7f5ece27f385d7b42862f5f))
1030
- * **sync:** regenerate condensed analytics commands + Claude skill stubs ([41728c4](https://github.com/event4u-app/agent-config/commit/41728c4400c8cabaa8966d2708fbb4f3cef64adb))
1031
- * **knowledge:** regenerate projections + manifests for /knowledge cluster ([f4c5a26](https://github.com/event4u-app/agent-config/commit/f4c5a26bffef0a25918bdde42131354c9dd5295d))
1032
- * **discovery:** add agent-skills and cinematic-ai-video to topics ([5c01d5e](https://github.com/event4u-app/agent-config/commit/5c01d5e152bda559aefd48fd8220f2a3cbd90249))
1033
-
1034
- Tests: 4929 (+90 since 3.1.1)
830
+ > All entries from `3.2.0` and `3.3.0` live in
831
+ > [`docs/archive/CHANGELOG-pre-4.0.0.md`](docs/archive/CHANGELOG-pre-4.0.0.md).
832
+ > The archive is read-only; git tags `3.2.0` and `3.3.0` remain the
833
+ > canonical source for what shipped. Splitting them out of the main
834
+ > file keeps the active era under the 250-line drift cap enforced by
835
+ > `tests/test_changelog_eras.py`.
1035
836
 
1036
837
  # Era: pre-3.2.0 — archived
1037
838
 
@@ -3,6 +3,10 @@
3
3
  # Source of truth: docs/decisions/ADR-013-discovery-frontmatter-contract.md §packs
4
4
  # Amendments require an ADR-013 amendment in the same PR.
5
5
  # `requires_hint` is advisory metadata only; runtime does NOT act on it.
6
+ # `cluster: <language-id>` is advisory too (road-to-wizard-ux-improvements
7
+ # § Phase 4): it groups a framework pack under a language tile in the setup
8
+ # wizard's pack step (e.g. laravel → php, react → typescript). The value must
9
+ # be a known pack id. Like `requires_hint`, the installer does NOT act on it.
6
10
  # Lint: scripts/lint_discovery_vocabulary.py
7
11
 
8
12
  - id: engineering-base
@@ -23,6 +27,7 @@
23
27
  description: Laravel framework patterns; depends on PHP at the artefact level.
24
28
  workspaces: [engineering]
25
29
  requires_hint: [php, engineering-base]
30
+ cluster: php
26
31
  trust_level_default: professional
27
32
 
28
33
  - id: symfony
@@ -30,6 +35,7 @@
30
35
  description: Symfony framework patterns; depends on PHP at the artefact level.
31
36
  workspaces: [engineering]
32
37
  requires_hint: [php, engineering-base]
38
+ cluster: php
33
39
  trust_level_default: professional
34
40
 
35
41
  - id: javascript
@@ -51,6 +57,7 @@
51
57
  description: React framework patterns.
52
58
  workspaces: [engineering]
53
59
  requires_hint: [javascript, engineering-base]
60
+ cluster: typescript
54
61
  trust_level_default: professional
55
62
 
56
63
  - id: nextjs
@@ -58,6 +65,7 @@
58
65
  description: Next.js framework patterns.
59
66
  workspaces: [engineering]
60
67
  requires_hint: [react, typescript, engineering-base]
68
+ cluster: typescript
61
69
  trust_level_default: professional
62
70
 
63
71
  - id: python
@@ -147,7 +155,7 @@
147
155
 
148
156
  - id: ai-video
149
157
  label: AI Video
150
- description: AI video pipeline (per ADR-011, the only heavyweight domain).
158
+ description: AI video pipeline.
151
159
  workspaces: [small-business]
152
160
  trust_level_default: experimental
153
161
  onboarding:
@@ -3,57 +3,70 @@
3
3
  # Source of truth: docs/decisions/ADR-013-discovery-frontmatter-contract.md §workspaces
4
4
  # Amendments require an ADR-013 amendment in the same PR.
5
5
  # Lint: scripts/lint_discovery_vocabulary.py
6
+ #
7
+ # `example_roles` is advisory UI copy only (NOT a closed vocabulary): the
8
+ # wizard shows it under each area as illustrative job titles. The stored
9
+ # `.agent-user.yml` role is the workspace id, not these examples.
6
10
 
7
11
  - id: engineering
8
12
  label: Engineering
9
13
  description: Code, tests, CI, reviews, architecture.
14
+ example_roles: [Developer, CTO, Tech Lead]
10
15
  default_packs: [engineering-base]
11
16
  optional_packs: [php, laravel, symfony, javascript, typescript, react, nextjs, python]
12
17
 
13
18
  - id: product
14
19
  label: Product
15
20
  description: Discovery, roadmaps, prioritisation, AC tightening.
21
+ example_roles: [Product Manager, CPO]
16
22
  default_packs: [product-basic]
17
23
  optional_packs: [product-discovery]
18
24
 
19
25
  - id: finance
20
- label: Finance / CFO
26
+ label: Finance
21
27
  description: Cashflow, forecasting, DCF, board reporting.
28
+ example_roles: [CFO, Controller, Finance Lead]
22
29
  default_packs: [finance-basic]
23
30
  optional_packs: [finance-advanced]
24
31
 
25
32
  - id: founder
26
33
  label: Founder
27
34
  description: Strategy, fundraising, vision, board narrative.
35
+ example_roles: [CEO, Co-Founder]
28
36
  default_packs: [founder-strategy]
29
37
  optional_packs: [finance-basic, gtm-marketing]
30
38
 
31
39
  - id: gtm
32
40
  label: Go-to-Market
33
41
  description: Sales pipeline, marketing, positioning, launch.
42
+ example_roles: [Head of Sales, CMO, Growth Lead]
34
43
  default_packs: [gtm-sales, gtm-marketing]
35
44
  optional_packs: []
36
45
 
37
46
  - id: ops
38
47
  label: Operations
39
48
  description: Hiring, comp, perf, org design, runbooks.
49
+ example_roles: [COO, Head of People, Ops Lead]
40
50
  default_packs: [ops-people]
41
51
  optional_packs: []
42
52
 
43
53
  - id: small-business
44
54
  label: Small Business
45
55
  description: Self-employed / SMB-shaped owner workflows.
56
+ example_roles: [Owner, Freelancer]
46
57
  default_packs: [small-business]
47
58
  optional_packs: [ai-video]
48
59
 
49
60
  - id: construction
50
61
  label: Construction
51
62
  description: Trade-business workflows (planning, quotes).
63
+ example_roles: [Contractor, Site Manager]
52
64
  default_packs: [construction]
53
65
  optional_packs: []
54
66
 
55
67
  - id: agent-config-maintainer
56
68
  label: Maintainer
57
69
  description: Skills/rules/commands that maintain this package.
70
+ example_roles: [Maintainer]
58
71
  default_packs: [meta]
59
72
  optional_packs: []