@event4u/agent-config 5.9.0 → 5.10.1
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.
- package/.claude-plugin/marketplace.json +1 -1
- package/CHANGELOG.md +38 -234
- package/README.md +13 -6
- package/config/agent-settings.template.yml +17 -0
- package/config/gitignore-block.txt +7 -0
- package/dist/cli/registry.js +1 -0
- package/dist/cli/registry.js.map +1 -1
- package/dist/discovery/deprecation-report.md +1 -1
- package/dist/discovery/discovery-manifest.json +1 -1
- package/dist/discovery/discovery-manifest.json.sha256 +1 -1
- package/dist/discovery/discovery-manifest.summary.md +1 -1
- package/dist/discovery/orphan-report.md +1 -1
- package/dist/discovery/packs.json +1 -1
- package/dist/discovery/trust-report.md +1 -1
- package/dist/discovery/workspaces.json +1 -1
- package/dist/mcp/registry-manifest.json +1 -1
- package/dist/server/schemas/settings.js +4 -0
- package/dist/server/schemas/settings.js.map +1 -1
- package/dist/ui/assets/index-DcAWIwwY.js +40 -0
- package/dist/ui/assets/index-DcAWIwwY.js.map +1 -0
- package/dist/ui/index.html +1 -1
- package/docs/archive/CHANGELOG-pre-5.9.0.md +270 -0
- package/docs/decisions/ADR-040-execution-model-projection-time-filtering.md +244 -0
- package/docs/decisions/INDEX.md +1 -0
- package/docs/distribution/registries.md +1 -0
- package/docs/profiles.md +8 -0
- package/docs/wizard.md +25 -8
- package/package.json +1 -1
- package/scripts/__pycache__/validate_frontmatter.cpython-312.pyc +0 -0
- package/scripts/_cli/cmd_refresh.py +7 -1
- package/scripts/_cli/cmd_upgrade.py +31 -1
- package/scripts/_dispatch.bash +11 -0
- package/scripts/_lib/__pycache__/__init__.cpython-312.pyc +0 -0
- package/scripts/_lib/__pycache__/agent_src.cpython-312.pyc +0 -0
- package/scripts/_lib/cli_wrapper.py +64 -0
- package/scripts/ai-video/lib/probe-audio.sh +20 -5
- package/scripts/hook_manifest.yaml +16 -7
- package/scripts/profile_use.py +125 -0
- package/scripts/wrapper_freshness_hook.py +86 -0
- package/dist/ui/assets/index-5lFqAKL0.js +0 -40
- package/dist/ui/assets/index-5lFqAKL0.js.map +0 -1
package/dist/ui/index.html
CHANGED
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
|
6
6
|
<meta name="robots" content="noindex" />
|
|
7
7
|
<title>agent-config</title>
|
|
8
|
-
<script type="module" crossorigin src="/assets/index-
|
|
8
|
+
<script type="module" crossorigin src="/assets/index-DcAWIwwY.js"></script>
|
|
9
9
|
<link rel="stylesheet" crossorigin href="/assets/index-BbWWuFrF.css">
|
|
10
10
|
</head>
|
|
11
11
|
<body>
|
|
@@ -0,0 +1,270 @@
|
|
|
1
|
+
# Changelog Archive — pre-5.9.0
|
|
2
|
+
|
|
3
|
+
> Frozen snapshot of `event4u/agent-config` changelog entries
|
|
4
|
+
> released before `5.9.0`, split out of the main
|
|
5
|
+
> [`CHANGELOG.md`](../../CHANGELOG.md) by `scripts/release.py`
|
|
6
|
+
> once the active era's body crossed the drift cap enforced by
|
|
7
|
+
> `tests/test_changelog_eras.py`.
|
|
8
|
+
>
|
|
9
|
+
> **Read-only.** New entries land in `CHANGELOG.md`. Entries
|
|
10
|
+
> here are not amended — git tags remain the canonical source
|
|
11
|
+
> for what shipped.
|
|
12
|
+
>
|
|
13
|
+
> Entry shape follows
|
|
14
|
+
> [`../contracts/CHANGELOG-conventions.md`](../contracts/CHANGELOG-conventions.md).
|
|
15
|
+
|
|
16
|
+
## [5.9.0](https://github.com/event4u-app/agent-config/compare/5.8.0...5.9.0) (2026-06-02)
|
|
17
|
+
|
|
18
|
+
### Features
|
|
19
|
+
|
|
20
|
+
* **doctor:** runnable global-only report without a project lockfile ([4c4f20b](https://github.com/event4u-app/agent-config/commit/4c4f20b82eb472ff6b6d84ebac889832ce1329f0))
|
|
21
|
+
* **ci:** release-published drift gate (catch npm lagging main) ([7f4e125](https://github.com/event4u-app/agent-config/commit/7f4e125dd48d0233d33ce8cbb219731a0b501497))
|
|
22
|
+
|
|
23
|
+
### Bug Fixes
|
|
24
|
+
|
|
25
|
+
* **release:** anchor --resume to package.json, auto-delete merged branch ([f2db736](https://github.com/event4u-app/agent-config/commit/f2db736c7259845fe204af1ffd293e7f5341a58d))
|
|
26
|
+
|
|
27
|
+
### Chores
|
|
28
|
+
|
|
29
|
+
* **roadmap:** close + archive doctor-global-only-readiness ([3d3aaf7](https://github.com/event4u-app/agent-config/commit/3d3aaf739464b9e6613175f352b09a153bdbec90))
|
|
30
|
+
|
|
31
|
+
Tests: 5480 (+25 since 5.8.0)
|
|
32
|
+
|
|
33
|
+
## [5.8.0](https://github.com/event4u-app/agent-config/compare/5.7.0...5.8.0) (2026-06-02)
|
|
34
|
+
|
|
35
|
+
### Features
|
|
36
|
+
|
|
37
|
+
* **profile:** /profile command cluster + overlay contract ([1b7720a](https://github.com/event4u-app/agent-config/commit/1b7720a3ead769056cf7499f7d4951e77fc07823))
|
|
38
|
+
* **profile:** session-profile overlay engine + staleness hook ([cca6ac1](https://github.com/event4u-app/agent-config/commit/cca6ac112d1479e807621c9c846279d949aecc99))
|
|
39
|
+
* **scripts:** add warn-only coverage-diff forcing-function ([dc45926](https://github.com/event4u-app/agent-config/commit/dc4592639f052457099e7ad1857b20b867657ce9))
|
|
40
|
+
* **scripts:** add packages/core path resolver + gate path-integrity check ([c7eddab](https://github.com/event4u-app/agent-config/commit/c7eddabe74c9c34d18f1c545b60b1738cffa4b6c))
|
|
41
|
+
* **dev:** add install:use-dev / install:use-release global switch tasks ([e8a1e23](https://github.com/event4u-app/agent-config/commit/e8a1e23ec85ff0d7c358218130ae8ebe8e95c075))
|
|
42
|
+
* **install:** refuse project-scope self-install into the source repo ([2ad502b](https://github.com/event4u-app/agent-config/commit/2ad502be83236b2c2fa653a10670e518fb80ace7))
|
|
43
|
+
* **pack-fun:** wire EV-grid + P(win) helpers into prediction-pool-optimizer ([001eb1d](https://github.com/event4u-app/agent-config/commit/001eb1de4ba2ceb58a02382f449a59da9334b895))
|
|
44
|
+
* **pack-fun:** add score_ev + pool_winsim helpers for prediction-pool ([06d296b](https://github.com/event4u-app/agent-config/commit/06d296b4355048d82ca969fb5c369cd73dc8d44e))
|
|
45
|
+
* **settings:** install/sync write canonical agents/settings/ + migrate root (ADR-038) ([b4b589e](https://github.com/event4u-app/agent-config/commit/b4b589e77fde1c6d8c07ad2f32b1824bfbfea893))
|
|
46
|
+
* **settings:** canonical settings path → agents/settings/.agent-settings.yml (resolver + readers) ([dc8c96a](https://github.com/event4u-app/agent-config/commit/dc8c96a5f9ca5f56c6e68e8f8771bf62a580afd2))
|
|
47
|
+
* **pack-fun:** answer every pool question + multi-book consensus odds in prediction-pool-optimizer ([8f0e124](https://github.com/event4u-app/agent-config/commit/8f0e1241c1962ef3fe1b818bee4b2db735d099da))
|
|
48
|
+
|
|
49
|
+
### Bug Fixes
|
|
50
|
+
|
|
51
|
+
* **hooks:** resolve roadmap-progress regenerator from the package root for global-only consumers ([8539403](https://github.com/event4u-app/agent-config/commit/853940322166cf47d3e055487f6eb884950a3396))
|
|
52
|
+
* **templates:** bump agent_config_version pin to 5.7.0 ([e2a5ae2](https://github.com/event4u-app/agent-config/commit/e2a5ae277c4c3b24d9f1ed42172f8d24f2eae21c))
|
|
53
|
+
* **check-refs:** ref-ignore gitignored .agent-settings.yml in new roadmap ([73a7deb](https://github.com/event4u-app/agent-config/commit/73a7deb56ed9b2da570c5214816f1f4b639c4da1))
|
|
54
|
+
* **templates:** bump agent_config_version pin to 5.7.0 ([411060d](https://github.com/event4u-app/agent-config/commit/411060d15ab1d2720f13af5482a7dc535dfb4fac))
|
|
55
|
+
* **check-refs:** add content-class allowlist to end the reword treadmill ([f6a3b7f](https://github.com/event4u-app/agent-config/commit/f6a3b7f2904c53f6ceb84d6339a1bb7cf75ea8e5))
|
|
56
|
+
|
|
57
|
+
### Documentation
|
|
58
|
+
|
|
59
|
+
* **roadmap:** close road-to-self-update Phase 5; spawn doctor global-only follow-up ([307aa87](https://github.com/event4u-app/agent-config/commit/307aa87f75270124f298dba80369061c3367a42c))
|
|
60
|
+
* **profile:** document session profiles + sync command counts ([afa7db1](https://github.com/event4u-app/agent-config/commit/afa7db16b5e55c849eaabcc314051c55685881e7))
|
|
61
|
+
* **adr:** record session-profile overlay decisions (ADR-010 addendum + host audit) ([90838b9](https://github.com/event4u-app/agent-config/commit/90838b9e21f18d5e1f62c7c29550ea1fb7a8cd9f))
|
|
62
|
+
* **adr:** record ADR-039 — .claude/skills/ untracked ([ae00011](https://github.com/event4u-app/agent-config/commit/ae00011a9786632808c8f74f86d68062c12b7b49))
|
|
63
|
+
* **roadmap:** add follow-up for untracking .claude/skills/ ([14855f8](https://github.com/event4u-app/agent-config/commit/14855f8da5c2465cb3391f5659558fe3a22c006d))
|
|
64
|
+
* **roadmap:** complete + archive linter-debt-and-meta-subtraction ([3f1c742](https://github.com/event4u-app/agent-config/commit/3f1c74207f33025b0aaa2f48d421bec396610222))
|
|
65
|
+
|
|
66
|
+
### Tests
|
|
67
|
+
|
|
68
|
+
* **profile:** make surface tests independent of the gitignored manifest ([db35420](https://github.com/event4u-app/agent-config/commit/db35420df35d41e83c9d4b02b04f0af24a0fbd76))
|
|
69
|
+
* **profile:** contract tests for the session-profile overlay ([1def905](https://github.com/event4u-app/agent-config/commit/1def9056a1a7bd9a42ecfa7fd53fab6f18c20f87))
|
|
70
|
+
* backfill regression tests for check_skill_requires, settings enum, wizard zero-terminal ([f581f9d](https://github.com/event4u-app/agent-config/commit/f581f9d985b296b7643536e99a7530f46b2afa8e))
|
|
71
|
+
* **settings:** one-liner entrypoint smoke asserts canonical settings path ([21eaf06](https://github.com/event4u-app/agent-config/commit/21eaf062ad230ac09590db9f088f4316f384e4f0))
|
|
72
|
+
* **settings:** update install assertions to canonical agents/settings/ path ([ad2c432](https://github.com/event4u-app/agent-config/commit/ad2c4324ff7ea8eceb1056d96e0810aa4de86835))
|
|
73
|
+
|
|
74
|
+
### CI
|
|
75
|
+
|
|
76
|
+
* wire check-gate-paths and check-test-coverage-diff into the pipeline ([d971efb](https://github.com/event4u-app/agent-config/commit/d971efbe1416d4d12ad76724b9bb9504f2bed698))
|
|
77
|
+
* **skill-lint:** drop .claude/** from workflow trigger paths ([b640079](https://github.com/event4u-app/agent-config/commit/b6400794debdf34ca113f67bcb661042dadf7f3b))
|
|
78
|
+
|
|
79
|
+
### Chores
|
|
80
|
+
|
|
81
|
+
* **index:** regenerate index + catalog for the profile command cluster ([92ccc91](https://github.com/event4u-app/agent-config/commit/92ccc91157c2781014acba03fdd3ad24c8c05393))
|
|
82
|
+
* **model-tier:** route routine commands and skills to the medium tier ([b0cbd55](https://github.com/event4u-app/agent-config/commit/b0cbd5523652dbeeeb5f5d3fd4e2fbb0ed1c5ed7))
|
|
83
|
+
* **roadmap:** close + archive road-to-session-profile-activation ([d647404](https://github.com/event4u-app/agent-config/commit/d64740461bb61fbaf80eb5f5bcc800fc770e3df0))
|
|
84
|
+
* **roadmap:** close + archive road-to-test-and-gate-integrity ([16f7f8b](https://github.com/event4u-app/agent-config/commit/16f7f8b896d060519cc1624178d38b9691af4bee))
|
|
85
|
+
* **roadmap:** close + archive road-to-claude-skills-untrack ([4010ca7](https://github.com/event4u-app/agent-config/commit/4010ca788621f409395b37b5d48cb2146919d0a2))
|
|
86
|
+
* **claude:** move marketplace skill sources out of .claude/skills ([c0e2d89](https://github.com/event4u-app/agent-config/commit/c0e2d8972b41cc85b44757d7c3b4df8f2b3d3551))
|
|
87
|
+
* **claude:** untrack generated rules/personas/user-types projections ([d03424b](https://github.com/event4u-app/agent-config/commit/d03424b2e43cae9978c7d0fc9a938fe0f1b6e2a8))
|
|
88
|
+
* add a new roadmap for test-and-gate-integrity ([486e7dd](https://github.com/event4u-app/agent-config/commit/486e7ddf07d79ec2a295b726a546567381037356))
|
|
89
|
+
* **meta:** remove dead one-shot roadmap-audit scripts (KC3) ([e0b40a2](https://github.com/event4u-app/agent-config/commit/e0b40a20519e89166db3ab06e70f15e601441dd5))
|
|
90
|
+
|
|
91
|
+
Tests: 5455 (+80 since 5.7.0)
|
|
92
|
+
|
|
93
|
+
## [5.7.0](https://github.com/event4u-app/agent-config/compare/5.6.1...5.7.0) (2026-06-01)
|
|
94
|
+
|
|
95
|
+
### Features
|
|
96
|
+
|
|
97
|
+
* **settings:** enum-validate value-bearing settings keys in CI ([b6c56d0](https://github.com/event4u-app/agent-config/commit/b6c56d088b1b8cfa549374e864bb3dcc203972fb))
|
|
98
|
+
* **value:** honest eager-vs-thin cost ladder in the value dashboard ([9a806c4](https://github.com/event4u-app/agent-config/commit/9a806c466e171f8a83e743990bc9350192745da5))
|
|
99
|
+
* **fun:** add /tippspiel command + tippspiel-optimizer skill in new pack-fun ([4c8fc65](https://github.com/event4u-app/agent-config/commit/4c8fc65473556ce3635a6fdcad67096c0c15886f))
|
|
100
|
+
* **skills:** add skill-composition graph + co-availability gate (roadmap 3.4) ([6db3afa](https://github.com/event4u-app/agent-config/commit/6db3afa8738331c2e85fb1f75dceb9943b2a2599))
|
|
101
|
+
|
|
102
|
+
### Bug Fixes
|
|
103
|
+
|
|
104
|
+
* **install:** hand off global install to the browser wizard with zero terminal prompts ([0fc46e3](https://github.com/event4u-app/agent-config/commit/0fc46e3e29220bcebfe6c97316309502ee2b7ee4))
|
|
105
|
+
* **wizard:** disambiguate the rule-loading / budget / model step ([122244c](https://github.com/event4u-app/agent-config/commit/122244c859b0c9da61e60a58fa220fb6c8f699d1))
|
|
106
|
+
* **cost-report:** recommend the model tier before rule loading ([2545c27](https://github.com/event4u-app/agent-config/commit/2545c277e5cc930a1e493dbf78e3ef3fe11933aa))
|
|
107
|
+
* **condense:** quote frontmatter descriptions in cursor/windsurf rules ([c69c9bb](https://github.com/event4u-app/agent-config/commit/c69c9bbb56bce9c01284db90936fd7b432278ffb))
|
|
108
|
+
* **install:** always overwrite our own deployed files, drop foreign-file gate ([25b593d](https://github.com/event4u-app/agent-config/commit/25b593d96da87e61f29844db088b01a346d07d81))
|
|
109
|
+
* **ci:** mirror memory.cadence into the source loader + TS settings schema ([2a74eff](https://github.com/event4u-app/agent-config/commit/2a74eff244c76830745c9d1e319d6abd5fe1d80b))
|
|
110
|
+
* **memory:** give the visibility-line cadence its own memory.cadence key ([e792390](https://github.com/event4u-app/agent-config/commit/e792390f59b01190769cba1f369bb574c83847bd))
|
|
111
|
+
* **rules:** trim non-destructive description to the 190-char schema cap ([b2a489e](https://github.com/event4u-app/agent-config/commit/b2a489ecf9fcbadf5232417f2503fddbab657fdb))
|
|
112
|
+
* **rules:** make production-branch commits a Hard-Floor opt-in (kernel) ([31f49a9](https://github.com/event4u-app/agent-config/commit/31f49a9af7fc0fb495556e8570e0adbfcb031416))
|
|
113
|
+
* **discovery:** register 'fun' in discovery-manifest schema enum ([7b91f12](https://github.com/event4u-app/agent-config/commit/7b91f12fa4e1e805a121a0fd7c9adb2760f5f122))
|
|
114
|
+
|
|
115
|
+
### Documentation
|
|
116
|
+
|
|
117
|
+
* **install:** record ADR-036 + roadmap Phase 6 for the browser-wizard handoff ([f3cc886](https://github.com/event4u-app/agent-config/commit/f3cc886618526b1c705a2a25c1ee98eb4063a188))
|
|
118
|
+
* **roadmap:** close + archive cost_profile untangle (phases 0-7; 4 items cancelled-with-follow-up) ([296b0da](https://github.com/event4u-app/agent-config/commit/296b0da47fc0ceed399438e4c5cb5801df0ea1b7))
|
|
119
|
+
* record cost_profile untangle (ADR-036 + BREAKING_CHANGES + disambiguation) ([efa658a](https://github.com/event4u-app/agent-config/commit/efa658acaef31bb1d1a9ddb565b5093b03f7d62e))
|
|
120
|
+
* **roadmap:** add cost_profile untangle roadmap ([708033c](https://github.com/event4u-app/agent-config/commit/708033cb5649c1d9583ea42a397795cf198b3493))
|
|
121
|
+
|
|
122
|
+
### Refactoring
|
|
123
|
+
|
|
124
|
+
* **settings:** rename cost_profile to rule_loading_tier across the suite ([21a31cb](https://github.com/event4u-app/agent-config/commit/21a31cb9746996324e9a49d82ad87084fb605c87))
|
|
125
|
+
* **fun:** English command name + expanded triggers ([62c960e](https://github.com/event4u-app/agent-config/commit/62c960eac79cdbc2883ac4727fe05d651f9497b8))
|
|
126
|
+
|
|
127
|
+
### Chores
|
|
128
|
+
|
|
129
|
+
* update agent work ([7ed0cbb](https://github.com/event4u-app/agent-config/commit/7ed0cbbe45e33757f8fa59048d6f9212110da8c1))
|
|
130
|
+
* sync agent-project-settings example pin to package.json (5.6.1) ([194a040](https://github.com/event4u-app/agent-config/commit/194a040628b21c2f61b1096f956f350eed131ec6))
|
|
131
|
+
* regenerate index + catalog after rename ([1c6dc68](https://github.com/event4u-app/agent-config/commit/1c6dc68416570f47bf8578d60c508f0acd185993))
|
|
132
|
+
* regenerate derived trees after merging main ([1f0ad58](https://github.com/event4u-app/agent-config/commit/1f0ad582d9a757acafd470d1fdd32adc362a2a49))
|
|
133
|
+
* regenerate derived trees for the prediction-pool rename ([bb3225f](https://github.com/event4u-app/agent-config/commit/bb3225fa91e78bfa640d33d501175b586cbd7de7))
|
|
134
|
+
* regenerate derived trees for pack-fun ([4125ba5](https://github.com/event4u-app/agent-config/commit/4125ba583cadd25ec29c23999287fc42fcc3d991))
|
|
135
|
+
* update condensation hashes after requires_skills frontmatter ([baf60e5](https://github.com/event4u-app/agent-config/commit/baf60e58328051176a519628dd56f879a5c4dd86))
|
|
136
|
+
* **roadmap:** re-examine lean-buildout disposition — 3.4 built, rest confirmed ([d88b633](https://github.com/event4u-app/agent-config/commit/d88b6332181013dc1757c317453519cadee3f63a))
|
|
137
|
+
* **roadmap:** close + archive lean-buildout roadmap (council-resolved) ([303ca6b](https://github.com/event4u-app/agent-config/commit/303ca6b6346298601fb789d08d003e023ab26ac4))
|
|
138
|
+
|
|
139
|
+
Tests: 5375 (+0 since 5.6.1)
|
|
140
|
+
|
|
141
|
+
## [5.6.1](https://github.com/event4u-app/agent-config/compare/5.6.0...5.6.1) (2026-06-01)
|
|
142
|
+
|
|
143
|
+
### Bug Fixes
|
|
144
|
+
|
|
145
|
+
* **mcp:** send bearer auth in post-deploy smoke probe ([9d12489](https://github.com/event4u-app/agent-config/commit/9d124894b03e5e962e8014171f965ce9367de58d))
|
|
146
|
+
* correct gzip kwarg in pack_mcp_content (condenselevel -> compresslevel) ([6d27677](https://github.com/event4u-app/agent-config/commit/6d2767736d6d20327a5853875fd4e9cb172babcc))
|
|
147
|
+
|
|
148
|
+
Tests: 5375 (+0 since 5.6.0)
|
|
149
|
+
|
|
150
|
+
## [5.6.0](https://github.com/event4u-app/agent-config/compare/5.5.0...5.6.0) (2026-05-31)
|
|
151
|
+
|
|
152
|
+
### Features
|
|
153
|
+
|
|
154
|
+
* **ai-video:** add /image command cluster (analyse/create/verify) ([9d53c81](https://github.com/event4u-app/agent-config/commit/9d53c81e3aed3549c4135a641e306a32fa224a68))
|
|
155
|
+
* **ai-video:** add image-analyser + image-creator character-fidelity skills ([b76a4db](https://github.com/event4u-app/agent-config/commit/b76a4db19d537ad5443f2c920c4701a49d08e584))
|
|
156
|
+
* **ai-video:** extend from-song + song-to-script + adapters; add media-sync-ground-truth rule ([dab9f0f](https://github.com/event4u-app/agent-config/commit/dab9f0f41e0d4b93eef423541269d54408bf36f4))
|
|
157
|
+
* **kernel:** kernel-budget soak — trim commit-policy + scope-control, fences byte-identical (Phase 1) ([b0547f0](https://github.com/event4u-app/agent-config/commit/b0547f0207df6e057e2ff97283391ddad88fd2e3))
|
|
158
|
+
* **schema:** tighten description caps + warning window (Phase 2.1); record 3.2 as obviated ([c65d3ae](https://github.com/event4u-app/agent-config/commit/c65d3ae8b569eb3507b83c31967231e64a31a742))
|
|
159
|
+
* **projection:** thin rule-layer projection behind a flag — measured -35,845 GPT tok (Phase 3.1) ([d786363](https://github.com/event4u-app/agent-config/commit/d7863635ee342ab61210ed14b95eeb1fface9582))
|
|
160
|
+
* **value:** drop the € comparison from the value dashboard — tokens only ([33f6fc8](https://github.com/event4u-app/agent-config/commit/33f6fc81e934ca426e5a4c82c37f41624228a636))
|
|
161
|
+
* **bench:** drop the monetary cost comparison — report tokens only ([1a2d3ad](https://github.com/event4u-app/agent-config/commit/1a2d3ad6a177122f0249bb903b3d7d74d62676e1))
|
|
162
|
+
* **audit:** unified audit:tokens analyzer + budget CI gate (Phase 0B.2/0B.4/1.3/1.4) ([c27061f](https://github.com/event4u-app/agent-config/commit/c27061fd47be600d79a5b0a8484a4061f9cdadfd))
|
|
163
|
+
* **safety:** trigger-coverage MUST-LOAD floor + thin-projection kill-switch (Phase 2) ([b210e0b](https://github.com/event4u-app/agent-config/commit/b210e0b9f402e26c813d6fd45e85fdad42876c1d))
|
|
164
|
+
* **budget:** add real-tokenizer measurement alongside chars (Phase 0B.1) ([1602d7f](https://github.com/event4u-app/agent-config/commit/1602d7f2f41a3d6b1069ad675583262542c970cf))
|
|
165
|
+
|
|
166
|
+
### Bug Fixes
|
|
167
|
+
|
|
168
|
+
* **ai-video:** add workspaces + packs to media-sync-ground-truth rule ([cebe846](https://github.com/event4u-app/agent-config/commit/cebe8465d5cc1b07c8426b91ab52c0fb07e79f5b))
|
|
169
|
+
* sync command count to 145 in README badge + browse lines ([7a881e2](https://github.com/event4u-app/agent-config/commit/7a881e243fe73faad725050d684af682445c4eda))
|
|
170
|
+
* **kernel:** restore 2nd 'Iron Law' mention in commit-policy (obligation-baseline regression from #310) ([693c287](https://github.com/event4u-app/agent-config/commit/693c28791cbe124942835c3b309ca72921ee13f5))
|
|
171
|
+
* **tools:** repoint audit_auto_rules + audit_command_surface to packages/core (Phase 2.3) ([fae234c](https://github.com/event4u-app/agent-config/commit/fae234cfda21372adb493b259a47e8a9a00a0036))
|
|
172
|
+
* **schema:** rule description cap 160 -> 190 (smoke gate treats over-cap as FAIL) ([72f05e0](https://github.com/event4u-app/agent-config/commit/72f05e02cca4e196e514d8f4f573ac9890f52583))
|
|
173
|
+
* **kernel:** repoint iron_law_sha to packages/core layout (Iron-Law SHA gate was broken) ([aab5755](https://github.com/event4u-app/agent-config/commit/aab57558f7047fc21d0107dbab5aa3b49ebe4e2f))
|
|
174
|
+
* **schema:** add lean_projection.mode to the settings schema (template-parity gate) ([51ed03e](https://github.com/event4u-app/agent-config/commit/51ed03ec9e74d4573b7da43a6b45804535986690))
|
|
175
|
+
* **bench:** repoint bench_runner SKILLS_DIR to .agent-src for packages/core layout ([e183527](https://github.com/event4u-app/agent-config/commit/e183527c0efa4e3fe7dfb6a9df2c1e21534925a8))
|
|
176
|
+
|
|
177
|
+
### Performance
|
|
178
|
+
|
|
179
|
+
* **projection:** minimal thin entries — measured saving 35,845 -> 45,182 GPT tok (77%) ([b1aabe0](https://github.com/event4u-app/agent-config/commit/b1aabe05a9e68aa87a8396f3276530d480582dbe))
|
|
180
|
+
|
|
181
|
+
### Documentation
|
|
182
|
+
|
|
183
|
+
* **roadmap:** honest dispositions for remaining build-out items ([68e8bb5](https://github.com/event4u-app/agent-config/commit/68e8bb5ab3ec95c516707d9b8e0f2bfd6f7c5ec9))
|
|
184
|
+
* **roadmap:** land Phase 0+2 of road-to-lean-initial-context; spawn build-out follow-up ([8b0bec2](https://github.com/event4u-app/agent-config/commit/8b0bec2efab7128fa4c45d186e3feea4ebd632f8))
|
|
185
|
+
|
|
186
|
+
### Chores
|
|
187
|
+
|
|
188
|
+
* update reports ([eb52977](https://github.com/event4u-app/agent-config/commit/eb52977cf398f6691e55fc063ba9f1b4f63f03b9))
|
|
189
|
+
* regenerate index + catalog for image skills + /image cluster ([f71f024](https://github.com/event4u-app/agent-config/commit/f71f024dba491ff36c071d9fd25d372e39b0c9c2))
|
|
190
|
+
* regenerate derived (router, marketplace, manifests, counts, command-surface) ([2fcc321](https://github.com/event4u-app/agent-config/commit/2fcc3214451bec3114dee0d55d7f03c0f3392ca0))
|
|
191
|
+
* archive road-to-character-image-fidelity (complete) ([ef16067](https://github.com/event4u-app/agent-config/commit/ef16067c0636a0c8279922bbb160531efb477ddb))
|
|
192
|
+
* track linter-debt roadmap + command-surface report (unrelated to lean-context) ([a52a604](https://github.com/event4u-app/agent-config/commit/a52a6048a55805e5a25b9dc68fd1e98091ba0fec))
|
|
193
|
+
* **router:** regenerate stale dist/router.json from source ([af782fe](https://github.com/event4u-app/agent-config/commit/af782fe179d7ba573ec916e48ac0b9e3752cf6f5))
|
|
194
|
+
|
|
195
|
+
Tests: 5375 (+39 since 5.5.0)
|
|
196
|
+
|
|
197
|
+
## [5.5.0](https://github.com/event4u-app/agent-config/compare/5.4.1...5.5.0) (2026-05-31)
|
|
198
|
+
|
|
199
|
+
### Features
|
|
200
|
+
|
|
201
|
+
* /skill:preview — non-destructive skill dry-run ([03ce5fc](https://github.com/event4u-app/agent-config/commit/03ce5fc757f9b42226083627ad7380dd0d895ef7))
|
|
202
|
+
* cross-repo retrieval + linked-projects:list (ADR-032 Option A) ([894e2e8](https://github.com/event4u-app/agent-config/commit/894e2e88c2a7e6744eb45a90907c634953aec0ec))
|
|
203
|
+
* /skills:discover — local, explained skill recommender ([d887c56](https://github.com/event4u-app/agent-config/commit/d887c561514b019f2ae1a3eca068087f4ffee351))
|
|
204
|
+
* meta-layer concept-surface audit tool + zero-cut evidence ([b4a7f3e](https://github.com/event4u-app/agent-config/commit/b4a7f3e5e87ab0c5aa4a820784fba09d8306284a))
|
|
205
|
+
* **video:** add /video:from-song music-video command + register in cluster ([05752df](https://github.com/event4u-app/agent-config/commit/05752dfd0837759923bf02f3731fecfb81dec9e7))
|
|
206
|
+
* **ai-video:** add probe-audio.sh hybrid audio segmentation ([41b4f8d](https://github.com/event4u-app/agent-config/commit/41b4f8dd57d1352df49bdc31bc81ea8e7e04f550))
|
|
207
|
+
|
|
208
|
+
### Bug Fixes
|
|
209
|
+
|
|
210
|
+
* classify command-cluster files as commands, not skills ([0fd25da](https://github.com/event4u-app/agent-config/commit/0fd25dad8f75cfb7021512e2905b23b24fea88c1))
|
|
211
|
+
* **ai-video:** portability + regenerate stale derived for from-song ([9d728b8](https://github.com/event4u-app/agent-config/commit/9d728b88687a6c27dfa647dd233fb4412f7e8d5a))
|
|
212
|
+
|
|
213
|
+
### Documentation
|
|
214
|
+
|
|
215
|
+
* reword execution-type mentions to dodge check-refs false positive ([dc84ed0](https://github.com/event4u-app/agent-config/commit/dc84ed01d3aa6845a1e15674ed1ec3ff3bbfb9ce))
|
|
216
|
+
* add discoverable BREAKING_CHANGES.md + major-bump rationale ([385b8a2](https://github.com/event4u-app/agent-config/commit/385b8a225b764cfe09a7e31640184140de4e07d9))
|
|
217
|
+
* **roadmap:** avoid check-refs false-positive on pack name ([bd02ef0](https://github.com/event4u-app/agent-config/commit/bd02ef0b07d27653dbec4971b984d1d12b75ac5e))
|
|
218
|
+
* **roadmap:** /video:from-song implementation roadmap + dashboard ([e4899c2](https://github.com/event4u-app/agent-config/commit/e4899c2c4f57b77bc62aa9187d4aa768ea6885f6))
|
|
219
|
+
|
|
220
|
+
### Tests
|
|
221
|
+
|
|
222
|
+
* **ai-video:** cover probe-audio segmentation + from-song registration ([9a58807](https://github.com/event4u-app/agent-config/commit/9a588071de1601337e6e65dc9b940b0a36dcfd42))
|
|
223
|
+
|
|
224
|
+
### Chores
|
|
225
|
+
|
|
226
|
+
* archive road-to-leaner-core-and-discovery (all phases complete) ([6b6b191](https://github.com/event4u-app/agent-config/commit/6b6b191f3b9ff328b9b7f3d6aa6eaf718e471934))
|
|
227
|
+
* regenerate core pack manifest with skill/skill:preview commands ([9bd88c9](https://github.com/event4u-app/agent-config/commit/9bd88c9b7b18bdd16ef2c77066aa485d96fc2b2f))
|
|
228
|
+
* register skills/skill/knowledge clusters + regen outputs ([1156566](https://github.com/event4u-app/agent-config/commit/1156566ad82647c596e47483d57b3fcb71f9a275))
|
|
229
|
+
* bump command count 135 -> 136 in README badge + browse lines ([82c27c3](https://github.com/event4u-app/agent-config/commit/82c27c3383f53d29735784bae5fb86a151c19e39))
|
|
230
|
+
* **ai-video:** regenerate manifests, counts, condensation hashes ([fe4dc28](https://github.com/event4u-app/agent-config/commit/fe4dc280437f209b31190a5117848feb92290015))
|
|
231
|
+
|
|
232
|
+
Tests: 5336 (+65 since 5.4.1)
|
|
233
|
+
|
|
234
|
+
## [5.4.1](https://github.com/event4u-app/agent-config/compare/5.4.0...5.4.1) (2026-05-30)
|
|
235
|
+
|
|
236
|
+
### Documentation
|
|
237
|
+
|
|
238
|
+
* **roadmap:** add road-to-leaner-core-and-discovery ([abf7074](https://github.com/event4u-app/agent-config/commit/abf7074913247a13c6c79b5be8c2ef49aba44aa4))
|
|
239
|
+
|
|
240
|
+
### Tests
|
|
241
|
+
|
|
242
|
+
* **condense:** assert new PATH-fallback hook command shape ([3e72789](https://github.com/event4u-app/agent-config/commit/3e727898e4ca4f66a3a7d414e48067950f6845e3))
|
|
243
|
+
|
|
244
|
+
Tests: 5271 (+22 since 5.4.0)
|
|
245
|
+
|
|
246
|
+
## [5.4.0](https://github.com/event4u-app/agent-config/compare/5.3.0...5.4.0) (2026-05-30)
|
|
247
|
+
|
|
248
|
+
### Features
|
|
249
|
+
|
|
250
|
+
* **backfill:** migrate 354 tags to model_tier + rename coverage gate ([e9fc491](https://github.com/event4u-app/agent-config/commit/e9fc49137bc360a25cad675a18f655be9f6fab94))
|
|
251
|
+
* **schema:** replace recommended_model with vendor-neutral model_tier ([f6fc281](https://github.com/event4u-app/agent-config/commit/f6fc281c1e9adf6a51327433375d8e7d8d3e0a96))
|
|
252
|
+
* **rule:** make model-recommendation tier-aware, suggestion-only off-Claude ([31d70b9](https://github.com/event4u-app/agent-config/commit/31d70b9bfbdd283742d546e6484400b595ec0174))
|
|
253
|
+
* **generator:** map model_tier → native Claude model (single owned mapping) ([029c0d0](https://github.com/event4u-app/agent-config/commit/029c0d0f4c6cb2cb6b17f8c63652ef2cfe24a99e))
|
|
254
|
+
* **backfill:** tag every skill + command with recommended_model + coverage gate ([acf7553](https://github.com/event4u-app/agent-config/commit/acf7553c8c975584228cfa32fb7320e1c095e174))
|
|
255
|
+
* **rule:** rewrite model-recommendation to act on recommended_model ([46b7acd](https://github.com/event4u-app/agent-config/commit/46b7acd9e180979e454416acf939ca554075fd55))
|
|
256
|
+
* **generator:** project recommended_model to native Claude model: key ([4f6d213](https://github.com/event4u-app/agent-config/commit/4f6d213a263f360ad0c63b64bbbd9a53ea4a36ea))
|
|
257
|
+
* **schema:** add recommended_model frontmatter field for skills + commands ([2fa81a3](https://github.com/event4u-app/agent-config/commit/2fa81a38fb4fd0b52e23ca537374b4d0277da5d6))
|
|
258
|
+
|
|
259
|
+
### Documentation
|
|
260
|
+
|
|
261
|
+
* **roadmap:** close + archive model-capability-tiers roadmap with evidence ([c52ba67](https://github.com/event4u-app/agent-config/commit/c52ba676c406cb7127470a01f13a12db56d9a7c1))
|
|
262
|
+
* **adr:** ADR-035 — vendor-neutral model capability tiers (supersedes ADR-034) ([efe656b](https://github.com/event4u-app/agent-config/commit/efe656b3d7d83dac910fc3e890bdfa8d9fd0a53b))
|
|
263
|
+
* **roadmap:** close + archive per-skill-model-autoswitch roadmap with evidence ([5150b64](https://github.com/event4u-app/agent-config/commit/5150b640b205141557196e40d70f7c23a0b2530c))
|
|
264
|
+
* **adr:** ADR-034 — per-skill model recommendation transport (Option A) ([9c18179](https://github.com/event4u-app/agent-config/commit/9c181790f7257841b4bf7aac6bf40d3c0adb6357))
|
|
265
|
+
|
|
266
|
+
### Chores
|
|
267
|
+
|
|
268
|
+
* update readme ([47cba5b](https://github.com/event4u-app/agent-config/commit/47cba5b5d7222b1c1b925041c30b82c06b815a10))
|
|
269
|
+
|
|
270
|
+
Tests: 5249 (+13 since 5.3.0)
|
|
@@ -0,0 +1,244 @@
|
|
|
1
|
+
---
|
|
2
|
+
adr: 040
|
|
3
|
+
status: accepted
|
|
4
|
+
date: 2026-06-02
|
|
5
|
+
decision: execution-model-projection-time-filtering
|
|
6
|
+
supersedes: —
|
|
7
|
+
superseded_by: —
|
|
8
|
+
phase: v6.0.0 · experience-first rebuild
|
|
9
|
+
type: forward-looking
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# ADR-040 — Pack-scoped surfacing is projection-time filtering, not a runtime resolver
|
|
13
|
+
|
|
14
|
+
## Status
|
|
15
|
+
|
|
16
|
+
**Accepted** · 2026-06-02. Authored as Phase 0 / Step 1 of
|
|
17
|
+
[`road-to-6.0.0-a-positioning-and-validation`](../../agents/roadmaps/road-to-6.0.0-a-positioning-and-validation.md),
|
|
18
|
+
the de-risking front of the experience-first rebuild. It makes the single
|
|
19
|
+
architectural decision the rest of the rebuild
|
|
20
|
+
([`road-to-6.0.0-b-pack-scoped-projection`](../../agents/roadmaps/road-to-6.0.0-b-pack-scoped-projection.md))
|
|
21
|
+
hinges on, **before** any migration code is written. Builds on
|
|
22
|
+
[`ADR-010`](ADR-010-profile-pack-preset-boundary.md) (profile / pack / preset
|
|
23
|
+
boundary), [`ADR-020`](ADR-020-global-only-consumer-scope.md) (global-only
|
|
24
|
+
consumer scope), and [`ADR-016`](ADR-016-installer-architecture.md) (installer
|
|
25
|
+
architecture).
|
|
26
|
+
|
|
27
|
+
## Context
|
|
28
|
+
|
|
29
|
+
The external 5.7.0 product review (`agents/tmp/feedback-6.0.0-part1.*`) and the
|
|
30
|
+
first draft of the rebuild plan both described pack-scoped surfacing as a
|
|
31
|
+
**"runtime resolver"** that decides "at runtime" which skills/commands a host
|
|
32
|
+
tool sees. For a package whose entire job is to **project files** into each
|
|
33
|
+
tool's native config tree (`.claude/`, `.cursor/`, `.augment/`, …), that framing
|
|
34
|
+
is architecturally incoherent:
|
|
35
|
+
|
|
36
|
+
- `agent-config` ships no agent loop, no LLM dispatcher, no daemon, and no
|
|
37
|
+
request interception. The host tool (Claude Code, Augment, Cursor, Cline,
|
|
38
|
+
Windsurf, Gemini CLI, Copilot) owns the runtime; the package is a **content
|
|
39
|
+
layer** (README "What `agent-config` is — and what it isn't").
|
|
40
|
+
- The only mechanism the package controls is **what gets written where** during
|
|
41
|
+
release (`scripts/build_discovery_manifest.py`) and install / sync
|
|
42
|
+
(`scripts/install.py` projection of `.agent-src/` into each tool tree).
|
|
43
|
+
- A literal runtime resolver would require a long-lived process between the host
|
|
44
|
+
tool and the filesystem — exactly the "agent runtime" the package explicitly
|
|
45
|
+
is **not** (and which `README.md` lists as out of scope).
|
|
46
|
+
|
|
47
|
+
The AI council (claude-sonnet-4-5 + gpt-4o, 2 rounds + peer-review, 2026-06-02)
|
|
48
|
+
named this the "single most damaging ambiguity" in the rebuild and converged on
|
|
49
|
+
decoding "runtime resolver" as **projection-time filtering**.
|
|
50
|
+
|
|
51
|
+
Today the projection writes the **full** artefact set regardless of the active
|
|
52
|
+
profile or packs. Profiles (`ADR-010`, six seed profiles) and packs (surface
|
|
53
|
+
caps: commands ≤12, skills ≤15, personas ≤4) already exist as **selection
|
|
54
|
+
metadata**, but nothing yet filters the projected output by them. That gap is
|
|
55
|
+
what 6.0.0-B closes — and this ADR fixes the mechanism it must use.
|
|
56
|
+
|
|
57
|
+
## Decision
|
|
58
|
+
|
|
59
|
+
**Pack-scoped surfacing is implemented as projection-time filtering. There is no
|
|
60
|
+
runtime resolver in 6.0.0.**
|
|
61
|
+
|
|
62
|
+
Concretely, answering the four questions the roadmap requires:
|
|
63
|
+
|
|
64
|
+
### Where the filtering runs
|
|
65
|
+
|
|
66
|
+
In the **Node build / install projection** and in an explicit
|
|
67
|
+
**`agent-config use --profile=<id>`** switch. The projector
|
|
68
|
+
(`scripts/install.py` + the discovery/manifest layer) becomes
|
|
69
|
+
profile-and-pack-aware: it writes only the active profile + enabled packs'
|
|
70
|
+
artefacts into the tool trees. The filter is a **build-time set operation** over
|
|
71
|
+
the trusted source (`.agent-src/` → projected tree), not a request-time hook.
|
|
72
|
+
|
|
73
|
+
### How it integrates with host tools
|
|
74
|
+
|
|
75
|
+
**Zero integration.** Host tools keep reading the static files in their native
|
|
76
|
+
config directories exactly as they do today. They never learn that a profile
|
|
77
|
+
exists. The behavioural change is entirely upstream of the host tool: a
|
|
78
|
+
narrower set of files lands in `.claude/`/`.cursor/`/`.augment/`. No plugin API,
|
|
79
|
+
no hook, no interception, no protocol change on the host side.
|
|
80
|
+
|
|
81
|
+
### When projection happens
|
|
82
|
+
|
|
83
|
+
At two moments, both explicit and user-initiated:
|
|
84
|
+
|
|
85
|
+
1. **Install / sync** — `agent-config init`, `upgrade`, `refresh`, `sync` write
|
|
86
|
+
the projected set for the currently-selected profile + packs.
|
|
87
|
+
2. **Profile / pack switch** — `agent-config use --profile=<id>` (wired in
|
|
88
|
+
6.0.0-A / Step 8) re-runs the projection for the new selection and rewrites
|
|
89
|
+
the tool trees.
|
|
90
|
+
|
|
91
|
+
There is **no** mid-session, per-request, or background re-projection. The set a
|
|
92
|
+
host tool reads is fixed between explicit switches.
|
|
93
|
+
|
|
94
|
+
### What `agent-config use` does in 6.0.0-A (no behavioural change)
|
|
95
|
+
|
|
96
|
+
The AI council (2026-06-02) flagged a sequencing trap: `use --profile=<id>` is
|
|
97
|
+
wired in 6.0.0-A (Step 8), but filtering does not land until 6.0.0-B. To avoid a
|
|
98
|
+
silent no-op that "succeeds but does nothing", the contract for 6.0.0-A is
|
|
99
|
+
explicit:
|
|
100
|
+
|
|
101
|
+
- `use --profile=<id>` **writes** `profile:` into `.agent-settings.yml` and
|
|
102
|
+
re-runs the projection — but the projection still writes the **legacy-all**
|
|
103
|
+
(full) set, because filtering ships later. It is **not** a silent no-op: it
|
|
104
|
+
changes persisted selection state and prints what it set, plus a one-line note
|
|
105
|
+
that surface-narrowing activates in 6.0.0-B.
|
|
106
|
+
- It MUST reject an unknown profile id (validate against the six seed profiles)
|
|
107
|
+
rather than write garbage.
|
|
108
|
+
- It does **not** change which artefacts a host tool sees in 6.0.0-A. The
|
|
109
|
+
"no projection-behaviour change" acceptance criterion holds: `use` moves the
|
|
110
|
+
*setting*, not the *set*.
|
|
111
|
+
|
|
112
|
+
### Staleness and re-projection hygiene
|
|
113
|
+
|
|
114
|
+
The projected set is a snapshot taken at the last explicit projection
|
|
115
|
+
(install / sync / `use`). If upstream packs change (a surface cap moves, a pack
|
|
116
|
+
is deprecated) **after** projection, the tool trees are stale until the next
|
|
117
|
+
explicit `sync` / `use`. This is **accepted, not auto-corrected**: there is no
|
|
118
|
+
background watcher. `agent-config validate` already performs drift detection on
|
|
119
|
+
the manifest and is the surface that flags a stale projection; `sync` re-applies
|
|
120
|
+
the current selection. Auto-detection beyond `validate` is out of scope.
|
|
121
|
+
|
|
122
|
+
### Switching back / undo
|
|
123
|
+
|
|
124
|
+
The per-user undo for a profile switch is another explicit `use`:
|
|
125
|
+
`agent-config use --profile=<previous-id>` re-projects the prior selection. The
|
|
126
|
+
switch persists the *new* selection in `.agent-settings.yml`; the previous value
|
|
127
|
+
is recoverable from VCS / settings history. A dedicated `--rollback` flag is not
|
|
128
|
+
required in 6.0.0-A (the setting is the single source of truth and re-projection
|
|
129
|
+
is idempotent), but is noted as a possible 6.0.0-B affordance if field use shows
|
|
130
|
+
it is needed. (This per-user undo is distinct from the *release-level*
|
|
131
|
+
rollback criteria for the 6.1.0 default-flip — see the validation-gate note.)
|
|
132
|
+
|
|
133
|
+
### How a user sees the active selection
|
|
134
|
+
|
|
135
|
+
The active profile lives in `.agent-settings.yml` (`profile:`), and
|
|
136
|
+
`agent-config validate` / the Settings GUI surface it. `use` echoes the
|
|
137
|
+
resulting selection on every switch. No new per-tool-tree state file is
|
|
138
|
+
introduced — `.agent-settings.yml` stays the single source of truth for "which
|
|
139
|
+
experience is active".
|
|
140
|
+
|
|
141
|
+
### Trust boundary
|
|
142
|
+
|
|
143
|
+
The **projector writes**; **host tools read**. The projector
|
|
144
|
+
(`scripts/install.py` and friends, run under the global install per `ADR-020`)
|
|
145
|
+
is the only writer of `.claude/`/`.cursor/`/`.augment/`. Host tools treat those
|
|
146
|
+
trees as read-only inputs. The trusted root remains `.agent-src.uncondensed/` →
|
|
147
|
+
`.agent-src/`; the projection is a deterministic, re-runnable function of
|
|
148
|
+
(trusted source, active profile, enabled packs). This preserves the existing
|
|
149
|
+
trust model (`ADR-018`) — no new write surface, no new privileged process.
|
|
150
|
+
|
|
151
|
+
### Runtime resolver is scoped OUT of 6.0.0 (conditional)
|
|
152
|
+
|
|
153
|
+
A **true** runtime resolver — mid-session pack switching, the host tool querying
|
|
154
|
+
a live process for "which skills apply right now" — is explicitly **out of scope
|
|
155
|
+
for all of 6.0.0**. It is recorded as a **conditional** later possibility, gated
|
|
156
|
+
on evidence that users actually want mid-session switching (telemetry or
|
|
157
|
+
recruit-session signal). If it ever ships, it is a separate ADR and lives at the
|
|
158
|
+
tail of [`road-to-6.0.0-c-governance-and-evals`](../../agents/roadmaps/road-to-6.0.0-c-governance-and-evals.md)
|
|
159
|
+
or later — never silently as part of the projection work.
|
|
160
|
+
|
|
161
|
+
### Supersedes the README "skill-resolver out of scope" line
|
|
162
|
+
|
|
163
|
+
`README.md` ("What `agent-config` is — and what it isn't") lists **"Opinionated
|
|
164
|
+
skill-resolver algorithm"** in the *Out of scope* column. That line predates the
|
|
165
|
+
profile/pack axis. The AI council (2026-06-02) converged that the line must be
|
|
166
|
+
**refined, not blanket-removed** — there are two distinct things, and only one
|
|
167
|
+
moves:
|
|
168
|
+
|
|
169
|
+
- **Out of scope (unchanged):** an *opinionated, automatic* resolver that ranks
|
|
170
|
+
or curates skills *for* the user without their choice (ML-based curation,
|
|
171
|
+
relevance scoring, "the algorithm decides"). The package still does not do
|
|
172
|
+
this.
|
|
173
|
+
- **In scope (the refinement):** *user-driven* projection-time **filtering** —
|
|
174
|
+
the user picks a profile + packs, and the projector writes that subset. This
|
|
175
|
+
is a deterministic set operation governed by an explicit user choice, not an
|
|
176
|
+
opinionated runtime ranking.
|
|
177
|
+
|
|
178
|
+
So this ADR supersedes the *reading* of that line that says "we will never
|
|
179
|
+
select a subset of skills", while preserving the rejection of an automatic
|
|
180
|
+
resolver. The README NOT-table is updated in Phase 1 to draw exactly this
|
|
181
|
+
distinction (and a *runtime* resolver remains out of scope per above).
|
|
182
|
+
|
|
183
|
+
## Consequences
|
|
184
|
+
|
|
185
|
+
**Positive**
|
|
186
|
+
|
|
187
|
+
- The rebuild has one unambiguous mechanism to build against. 6.0.0-B
|
|
188
|
+
enhances the projector; it does not invent a daemon.
|
|
189
|
+
- No host-tool integration work, no protocol negotiation, no new runtime
|
|
190
|
+
process — the cheapest possible implementation of "focused command set".
|
|
191
|
+
- Deterministic and testable: the projected set is a pure function of
|
|
192
|
+
(source, profile, packs); existing determinism checks
|
|
193
|
+
(`check_discovery_determinism.py`) extend naturally.
|
|
194
|
+
- The trust boundary (`ADR-018`, `ADR-020`) is unchanged — no new attack
|
|
195
|
+
surface.
|
|
196
|
+
|
|
197
|
+
**Negative / costs**
|
|
198
|
+
|
|
199
|
+
- Switching profiles requires an explicit `agent-config use` + re-projection;
|
|
200
|
+
it is not instantaneous mid-session. Accepted: the council judged mid-session
|
|
201
|
+
switching an unvalidated want.
|
|
202
|
+
- The projector gains profile/pack-awareness complexity (the set filter, the
|
|
203
|
+
legacy-all default, the staged rollout flag). Contained to the build layer.
|
|
204
|
+
- Users who expected a "smart resolver" may be underwhelmed; mitigated by honest
|
|
205
|
+
positioning (Phase 1) that frames **explicit switching as a feature**
|
|
206
|
+
(predictable, inspectable, reproducible) rather than a limitation, and by the
|
|
207
|
+
conditional runtime-resolver escape hatch.
|
|
208
|
+
|
|
209
|
+
**Neutral**
|
|
210
|
+
|
|
211
|
+
- 6.0.0-A ships **no** projection-behaviour change — only this decision, the
|
|
212
|
+
positioning rewrite, and the `use` seam. The behavioural flip is 6.0.0-B,
|
|
213
|
+
staged and opt-in (legacy-all default) per the validation-gate note
|
|
214
|
+
([Phase 0 / Step 2](../../agents/roadmaps/road-to-6.0.0-a-positioning-and-validation.md)).
|
|
215
|
+
|
|
216
|
+
## Alternatives considered
|
|
217
|
+
|
|
218
|
+
1. **Literal runtime resolver (rejected).** A long-lived process between host
|
|
219
|
+
tool and filesystem. Incoherent for a content-layer package; would make
|
|
220
|
+
`agent-config` an agent runtime it explicitly is not; requires per-host
|
|
221
|
+
integration the package has no surface for. Rejected as architecturally
|
|
222
|
+
wrong, not merely expensive.
|
|
223
|
+
2. **Host-tool plugin/hook that filters at read time (rejected).** Push the
|
|
224
|
+
filter into each tool via its plugin API. Multiplies per-tool integration
|
|
225
|
+
cost across 7+ tools, couples the package to every tool's plugin lifecycle,
|
|
226
|
+
and breaks tools without a plugin surface. Rejected.
|
|
227
|
+
3. **Ship full set, document "ignore what you don't need" (rejected).** The
|
|
228
|
+
status quo. Fails the core perception problem the rebuild exists to fix
|
|
229
|
+
("520 artefacts, where do I start?"). Rejected — it is the problem.
|
|
230
|
+
4. **Projection-time filtering (accepted).** Filter the projected set by profile
|
|
231
|
+
+ packs in the build/install layer; host tools read a pre-filtered static
|
|
232
|
+
set. Cheapest, deterministic, zero host integration, preserves the trust
|
|
233
|
+
boundary.
|
|
234
|
+
|
|
235
|
+
## References
|
|
236
|
+
|
|
237
|
+
- [`road-to-6.0.0-a-positioning-and-validation`](../../agents/roadmaps/road-to-6.0.0-a-positioning-and-validation.md) — this roadmap (Phase 0 / Step 1).
|
|
238
|
+
- [`road-to-6.0.0-b-pack-scoped-projection`](../../agents/roadmaps/road-to-6.0.0-b-pack-scoped-projection.md) — consumes this decision.
|
|
239
|
+
- [`ADR-010`](ADR-010-profile-pack-preset-boundary.md) — profile / pack / preset boundary.
|
|
240
|
+
- [`ADR-016`](ADR-016-installer-architecture.md) — installer architecture (the projector).
|
|
241
|
+
- [`ADR-018`](ADR-018-trust-and-safety-layer.md) — trust boundary this ADR preserves.
|
|
242
|
+
- [`ADR-020`](ADR-020-global-only-consumer-scope.md) — global-only consumer scope (where the projector runs).
|
|
243
|
+
- [`profile-system`](../contracts/profile-system.md) — the six seed profiles and pack surface caps.
|
|
244
|
+
- `README.md` § "What `agent-config` is — and what it isn't" — the superseded "skill-resolver out of scope" line.
|
package/docs/decisions/INDEX.md
CHANGED
|
@@ -43,6 +43,7 @@ _Auto-generated by `scripts/adr/regenerate_index.py`. Do not edit._
|
|
|
43
43
|
| [ADR-037](ADR-037-cost-profile-untangle.md) | Cost Profile Untangle | accepted | 2026-06-01 | — |
|
|
44
44
|
| [ADR-038](ADR-038-canonical-settings-path.md) | Canonical Settings Path | — | — | — |
|
|
45
45
|
| [ADR-039](ADR-039-claude-skills-untracked.md) | Claude Skills Untracked | accepted | 2026-06-01 | — |
|
|
46
|
+
| [ADR-040](ADR-040-execution-model-projection-time-filtering.md) | Execution Model Projection Time Filtering | accepted | 2026-06-02 | — |
|
|
46
47
|
|
|
47
48
|
## Unnumbered (legacy)
|
|
48
49
|
|
|
@@ -40,6 +40,7 @@ No bespoke `BREAKING_CHANGES.md` is maintained — the changelog is the authorit
|
|
|
40
40
|
| 1 | `punkpeye/awesome-mcp-servers` | <https://github.com/punkpeye/awesome-mcp-servers> | One-line entry under the agent-tooling section, links to `README.md` hero anchor | ⬜ open | — |
|
|
41
41
|
| 2 | `mcp.so` | <https://mcp.so/> | Submit via the directory form; same one-line shape | ⬜ open | — |
|
|
42
42
|
| 3 | `mcpservers.org` | <https://mcpservers.org/> | Submit via the directory form; same one-line shape (verify URL current at submission time) | ⬜ open | — |
|
|
43
|
+
| 4 | `glama.ai` | <https://glama.ai/> | Submit via the Glama claim flow; same one-line shape — repo `https://github.com/event4u-app/agent-config`, tags `agent-governance`, `mcp`, `skills` | ⬜ open (human-owner: maintainer submits via the Glama claim flow) | — |
|
|
43
44
|
|
|
44
45
|
## Submission template
|
|
45
46
|
|
package/docs/profiles.md
CHANGED
|
@@ -9,6 +9,14 @@ and the exact commands and skills wired into the profile YAML at
|
|
|
9
9
|
The summary table at the top of [`README.md`](../README.md) is the
|
|
10
10
|
one-page index; the prose below is the deep version.
|
|
11
11
|
|
|
12
|
+
**Switching experience.** `agent-config setup` writes `profile.id` on first run
|
|
13
|
+
(it is the wizard's first question). To switch later, run
|
|
14
|
+
`agent-config use --profile=<id>` (one of `developer` · `content_creator` ·
|
|
15
|
+
`founder` · `agency` · `finance` · `ops`). In 6.0.0-A this records the choice
|
|
16
|
+
only; pack-scoped surfacing (projection-time filtering,
|
|
17
|
+
[`ADR-040`](decisions/ADR-040-execution-model-projection-time-filtering.md))
|
|
18
|
+
activates in 6.0.0-B behind a staged, opt-in rollout.
|
|
19
|
+
|
|
12
20
|
<a id="profile-developer"></a>
|
|
13
21
|
## 👩💻 `developer` — IC engineer
|
|
14
22
|
|
package/docs/wizard.md
CHANGED
|
@@ -27,17 +27,34 @@ agent-config settings
|
|
|
27
27
|
Both commands share the same SPA and the same backend; the URL hash
|
|
28
28
|
selects which surface renders.
|
|
29
29
|
|
|
30
|
-
## The
|
|
30
|
+
## The steps
|
|
31
|
+
|
|
32
|
+
The **first substantive question is "which experience?"** — profile selection
|
|
33
|
+
leads the flow (the cost / rule tier is a secondary knob further down).
|
|
31
34
|
|
|
32
35
|
| # | Title | What it asks |
|
|
33
36
|
|---|---|---|
|
|
34
|
-
| 1 |
|
|
35
|
-
| 2 |
|
|
36
|
-
| 3 |
|
|
37
|
-
| 4 |
|
|
38
|
-
| 5 |
|
|
39
|
-
| 6 |
|
|
40
|
-
| 7 |
|
|
37
|
+
| 1 | Welcome | `personal.user_name`, language |
|
|
38
|
+
| 2 | Experience | `profile.id` — which experience (developer · content_creator · founder · agency · finance · ops) |
|
|
39
|
+
| 3 | Identity | `personal.ide`, `personal.open_edited_files` |
|
|
40
|
+
| 4 | Personality | `personal.autonomy`, `personal.minimal_output`, `personal.play_by_play` |
|
|
41
|
+
| 5 | Cost & rules | `rule_loading_tier`, `cost.budgets`, `model.auto_switch` (secondary to the experience choice) |
|
|
42
|
+
| 6 | Roadmap & quality | `roadmap.quality_cadence`, `roadmap.dashboard_regen_cadence`, `quality.*` |
|
|
43
|
+
| 7 | Memory | `memory.review_threshold`, redaction patterns |
|
|
44
|
+
| 8 | `.agent-user.yml` | Optional long-form persona / preferences |
|
|
45
|
+
| 9 | Review | Read-only diff of every change, plus a `Finish` button |
|
|
46
|
+
|
|
47
|
+
> **Experience selection is perception-only in 6.0.0-A.** It writes `profile.id`
|
|
48
|
+
> to `.agent-settings.yml` and selects the README entry-path / persona
|
|
49
|
+
> pre-selection — it does **not** yet narrow what gets projected into the tool
|
|
50
|
+
> trees. Pack-scoped surfacing (projection-time filtering,
|
|
51
|
+
> [`ADR-040`](decisions/ADR-040-execution-model-projection-time-filtering.md))
|
|
52
|
+
> ships in 6.0.0-B behind a staged, opt-in rollout. Switch experiences any time
|
|
53
|
+
> with `agent-config use --profile=<id>`.
|
|
54
|
+
|
|
55
|
+
The extended install flow (`agent-config setup` on a fresh global install)
|
|
56
|
+
inserts the **AI tools → roles → packs** lead between Experience and Identity;
|
|
57
|
+
the canonical settings steps above stay in the same order.
|
|
41
58
|
|
|
42
59
|
Each step posts its partial state to `POST /api/v1/wizard/state` on
|
|
43
60
|
transition, so closing the browser mid-flight is safe — re-opening
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@event4u/agent-config",
|
|
3
|
-
"version": "5.
|
|
3
|
+
"version": "5.10.1",
|
|
4
4
|
"description": "Universal AI Agent OS \u2014 audited skills, governance rules, commands, and templates for AI coding tools (Claude Code, Cursor, Windsurf, Copilot).",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"private": false,
|
|
Binary file
|