@event4u/agent-config 5.6.1 → 5.8.0

package/CHANGELOG.md

@@ -811,6 +811,114 @@ our recommendation order, not its support status.
 > that forces a new era split (`# Era: 5.5.x`, etc.) — see
 > [`docs/contracts/CHANGELOG-conventions.md § Era splits`](docs/contracts/CHANGELOG-conventions.md).
 
+## [5.8.0](https://github.com/event4u-app/agent-config/compare/5.7.0...5.8.0) (2026-06-02)
+
+### Features
+
+* **profile:** /profile command cluster + overlay contract ([1b7720a](https://github.com/event4u-app/agent-config/commit/1b7720a3ead769056cf7499f7d4951e77fc07823))
+* **profile:** session-profile overlay engine + staleness hook ([cca6ac1](https://github.com/event4u-app/agent-config/commit/cca6ac112d1479e807621c9c846279d949aecc99))
+* **scripts:** add warn-only coverage-diff forcing-function ([dc45926](https://github.com/event4u-app/agent-config/commit/dc4592639f052457099e7ad1857b20b867657ce9))
+* **scripts:** add packages/core path resolver + gate path-integrity check ([c7eddab](https://github.com/event4u-app/agent-config/commit/c7eddabe74c9c34d18f1c545b60b1738cffa4b6c))
+* **dev:** add install:use-dev / install:use-release global switch tasks ([e8a1e23](https://github.com/event4u-app/agent-config/commit/e8a1e23ec85ff0d7c358218130ae8ebe8e95c075))
+* **install:** refuse project-scope self-install into the source repo ([2ad502b](https://github.com/event4u-app/agent-config/commit/2ad502be83236b2c2fa653a10670e518fb80ace7))
+* **pack-fun:** wire EV-grid + P(win) helpers into prediction-pool-optimizer ([001eb1d](https://github.com/event4u-app/agent-config/commit/001eb1de4ba2ceb58a02382f449a59da9334b895))
+* **pack-fun:** add score_ev + pool_winsim helpers for prediction-pool ([06d296b](https://github.com/event4u-app/agent-config/commit/06d296b4355048d82ca969fb5c369cd73dc8d44e))
+* **settings:** install/sync write canonical agents/settings/ + migrate root (ADR-038) ([b4b589e](https://github.com/event4u-app/agent-config/commit/b4b589e77fde1c6d8c07ad2f32b1824bfbfea893))
+* **settings:** canonical settings path → agents/settings/.agent-settings.yml (resolver + readers) ([dc8c96a](https://github.com/event4u-app/agent-config/commit/dc8c96a5f9ca5f56c6e68e8f8771bf62a580afd2))
+* **pack-fun:** answer every pool question + multi-book consensus odds in prediction-pool-optimizer ([8f0e124](https://github.com/event4u-app/agent-config/commit/8f0e1241c1962ef3fe1b818bee4b2db735d099da))
+
+### Bug Fixes
+
+* **hooks:** resolve roadmap-progress regenerator from the package root for global-only consumers ([8539403](https://github.com/event4u-app/agent-config/commit/853940322166cf47d3e055487f6eb884950a3396))
+* **templates:** bump agent_config_version pin to 5.7.0 ([e2a5ae2](https://github.com/event4u-app/agent-config/commit/e2a5ae277c4c3b24d9f1ed42172f8d24f2eae21c))
+* **check-refs:** ref-ignore gitignored .agent-settings.yml in new roadmap ([73a7deb](https://github.com/event4u-app/agent-config/commit/73a7deb56ed9b2da570c5214816f1f4b639c4da1))
+* **templates:** bump agent_config_version pin to 5.7.0 ([411060d](https://github.com/event4u-app/agent-config/commit/411060d15ab1d2720f13af5482a7dc535dfb4fac))
+* **check-refs:** add content-class allowlist to end the reword treadmill ([f6a3b7f](https://github.com/event4u-app/agent-config/commit/f6a3b7f2904c53f6ceb84d6339a1bb7cf75ea8e5))
+
+### Documentation
+
+* **roadmap:** close road-to-self-update Phase 5; spawn doctor global-only follow-up ([307aa87](https://github.com/event4u-app/agent-config/commit/307aa87f75270124f298dba80369061c3367a42c))
+* **profile:** document session profiles + sync command counts ([afa7db1](https://github.com/event4u-app/agent-config/commit/afa7db16b5e55c849eaabcc314051c55685881e7))
+* **adr:** record session-profile overlay decisions (ADR-010 addendum + host audit) ([90838b9](https://github.com/event4u-app/agent-config/commit/90838b9e21f18d5e1f62c7c29550ea1fb7a8cd9f))
+* **adr:** record ADR-039 — .claude/skills/ untracked ([ae00011](https://github.com/event4u-app/agent-config/commit/ae00011a9786632808c8f74f86d68062c12b7b49))
+* **roadmap:** add follow-up for untracking .claude/skills/ ([14855f8](https://github.com/event4u-app/agent-config/commit/14855f8da5c2465cb3391f5659558fe3a22c006d))
+* **roadmap:** complete + archive linter-debt-and-meta-subtraction ([3f1c742](https://github.com/event4u-app/agent-config/commit/3f1c74207f33025b0aaa2f48d421bec396610222))
+
+### Tests
+
+* **profile:** make surface tests independent of the gitignored manifest ([db35420](https://github.com/event4u-app/agent-config/commit/db35420df35d41e83c9d4b02b04f0af24a0fbd76))
+* **profile:** contract tests for the session-profile overlay ([1def905](https://github.com/event4u-app/agent-config/commit/1def9056a1a7bd9a42ecfa7fd53fab6f18c20f87))
+* backfill regression tests for check_skill_requires, settings enum, wizard zero-terminal ([f581f9d](https://github.com/event4u-app/agent-config/commit/f581f9d985b296b7643536e99a7530f46b2afa8e))
+* **settings:** one-liner entrypoint smoke asserts canonical settings path ([21eaf06](https://github.com/event4u-app/agent-config/commit/21eaf062ad230ac09590db9f088f4316f384e4f0))
+* **settings:** update install assertions to canonical agents/settings/ path ([ad2c432](https://github.com/event4u-app/agent-config/commit/ad2c4324ff7ea8eceb1056d96e0810aa4de86835))
+
+### CI
+
+* wire check-gate-paths and check-test-coverage-diff into the pipeline ([d971efb](https://github.com/event4u-app/agent-config/commit/d971efbe1416d4d12ad76724b9bb9504f2bed698))
+* **skill-lint:** drop .claude/** from workflow trigger paths ([b640079](https://github.com/event4u-app/agent-config/commit/b6400794debdf34ca113f67bcb661042dadf7f3b))
+
+### Chores
+
+* **index:** regenerate index + catalog for the profile command cluster ([92ccc91](https://github.com/event4u-app/agent-config/commit/92ccc91157c2781014acba03fdd3ad24c8c05393))
+* **model-tier:** route routine commands and skills to the medium tier ([b0cbd55](https://github.com/event4u-app/agent-config/commit/b0cbd5523652dbeeeb5f5d3fd4e2fbb0ed1c5ed7))
+* **roadmap:** close + archive road-to-session-profile-activation ([d647404](https://github.com/event4u-app/agent-config/commit/d64740461bb61fbaf80eb5f5bcc800fc770e3df0))
+* **roadmap:** close + archive road-to-test-and-gate-integrity ([16f7f8b](https://github.com/event4u-app/agent-config/commit/16f7f8b896d060519cc1624178d38b9691af4bee))
+* **roadmap:** close + archive road-to-claude-skills-untrack ([4010ca7](https://github.com/event4u-app/agent-config/commit/4010ca788621f409395b37b5d48cb2146919d0a2))
+* **claude:** move marketplace skill sources out of .claude/skills ([c0e2d89](https://github.com/event4u-app/agent-config/commit/c0e2d8972b41cc85b44757d7c3b4df8f2b3d3551))
+* **claude:** untrack generated rules/personas/user-types projections ([d03424b](https://github.com/event4u-app/agent-config/commit/d03424b2e43cae9978c7d0fc9a938fe0f1b6e2a8))
+* add a new roadmap for test-and-gate-integrity ([486e7dd](https://github.com/event4u-app/agent-config/commit/486e7ddf07d79ec2a295b726a546567381037356))
+* **meta:** remove dead one-shot roadmap-audit scripts (KC3) ([e0b40a2](https://github.com/event4u-app/agent-config/commit/e0b40a20519e89166db3ab06e70f15e601441dd5))
+
+Tests: 5455 (+80 since 5.7.0)
+
+## [5.7.0](https://github.com/event4u-app/agent-config/compare/5.6.1...5.7.0) (2026-06-01)
+
+### Features
+
+* **settings:** enum-validate value-bearing settings keys in CI ([b6c56d0](https://github.com/event4u-app/agent-config/commit/b6c56d088b1b8cfa549374e864bb3dcc203972fb))
+* **value:** honest eager-vs-thin cost ladder in the value dashboard ([9a806c4](https://github.com/event4u-app/agent-config/commit/9a806c466e171f8a83e743990bc9350192745da5))
+* **fun:** add /tippspiel command + tippspiel-optimizer skill in new pack-fun ([4c8fc65](https://github.com/event4u-app/agent-config/commit/4c8fc65473556ce3635a6fdcad67096c0c15886f))
+* **skills:** add skill-composition graph + co-availability gate (roadmap 3.4) ([6db3afa](https://github.com/event4u-app/agent-config/commit/6db3afa8738331c2e85fb1f75dceb9943b2a2599))
+
+### Bug Fixes
+
+* **install:** hand off global install to the browser wizard with zero terminal prompts ([0fc46e3](https://github.com/event4u-app/agent-config/commit/0fc46e3e29220bcebfe6c97316309502ee2b7ee4))
+* **wizard:** disambiguate the rule-loading / budget / model step ([122244c](https://github.com/event4u-app/agent-config/commit/122244c859b0c9da61e60a58fa220fb6c8f699d1))
+* **cost-report:** recommend the model tier before rule loading ([2545c27](https://github.com/event4u-app/agent-config/commit/2545c277e5cc930a1e493dbf78e3ef3fe11933aa))
+* **condense:** quote frontmatter descriptions in cursor/windsurf rules ([c69c9bb](https://github.com/event4u-app/agent-config/commit/c69c9bbb56bce9c01284db90936fd7b432278ffb))
+* **install:** always overwrite our own deployed files, drop foreign-file gate ([25b593d](https://github.com/event4u-app/agent-config/commit/25b593d96da87e61f29844db088b01a346d07d81))
+* **ci:** mirror memory.cadence into the source loader + TS settings schema ([2a74eff](https://github.com/event4u-app/agent-config/commit/2a74eff244c76830745c9d1e319d6abd5fe1d80b))
+* **memory:** give the visibility-line cadence its own memory.cadence key ([e792390](https://github.com/event4u-app/agent-config/commit/e792390f59b01190769cba1f369bb574c83847bd))
+* **rules:** trim non-destructive description to the 190-char schema cap ([b2a489e](https://github.com/event4u-app/agent-config/commit/b2a489ecf9fcbadf5232417f2503fddbab657fdb))
+* **rules:** make production-branch commits a Hard-Floor opt-in (kernel) ([31f49a9](https://github.com/event4u-app/agent-config/commit/31f49a9af7fc0fb495556e8570e0adbfcb031416))
+* **discovery:** register 'fun' in discovery-manifest schema enum ([7b91f12](https://github.com/event4u-app/agent-config/commit/7b91f12fa4e1e805a121a0fd7c9adb2760f5f122))
+
+### Documentation
+
+* **install:** record ADR-036 + roadmap Phase 6 for the browser-wizard handoff ([f3cc886](https://github.com/event4u-app/agent-config/commit/f3cc886618526b1c705a2a25c1ee98eb4063a188))
+* **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))
+* record cost_profile untangle (ADR-036 + BREAKING_CHANGES + disambiguation) ([efa658a](https://github.com/event4u-app/agent-config/commit/efa658acaef31bb1d1a9ddb565b5093b03f7d62e))
+* **roadmap:** add cost_profile untangle roadmap ([708033c](https://github.com/event4u-app/agent-config/commit/708033cb5649c1d9583ea42a397795cf198b3493))
+
+### Refactoring
+
+* **settings:** rename cost_profile to rule_loading_tier across the suite ([21a31cb](https://github.com/event4u-app/agent-config/commit/21a31cb9746996324e9a49d82ad87084fb605c87))
+* **fun:** English command name + expanded triggers ([62c960e](https://github.com/event4u-app/agent-config/commit/62c960eac79cdbc2883ac4727fe05d651f9497b8))
+
+### Chores
+
+* update agent work ([7ed0cbb](https://github.com/event4u-app/agent-config/commit/7ed0cbbe45e33757f8fa59048d6f9212110da8c1))
+* sync agent-project-settings example pin to package.json (5.6.1) ([194a040](https://github.com/event4u-app/agent-config/commit/194a040628b21c2f61b1096f956f350eed131ec6))
+* regenerate index + catalog after rename ([1c6dc68](https://github.com/event4u-app/agent-config/commit/1c6dc68416570f47bf8578d60c508f0acd185993))
+* regenerate derived trees after merging main ([1f0ad58](https://github.com/event4u-app/agent-config/commit/1f0ad582d9a757acafd470d1fdd32adc362a2a49))
+* regenerate derived trees for the prediction-pool rename ([bb3225f](https://github.com/event4u-app/agent-config/commit/bb3225fa91e78bfa640d33d501175b586cbd7de7))
+* regenerate derived trees for pack-fun ([4125ba5](https://github.com/event4u-app/agent-config/commit/4125ba583cadd25ec29c23999287fc42fcc3d991))
+* update condensation hashes after requires_skills frontmatter ([baf60e5](https://github.com/event4u-app/agent-config/commit/baf60e58328051176a519628dd56f879a5c4dd86))
+* **roadmap:** re-examine lean-buildout disposition — 3.4 built, rest confirmed ([d88b633](https://github.com/event4u-app/agent-config/commit/d88b6332181013dc1757c317453519cadee3f63a))
+* **roadmap:** close + archive lean-buildout roadmap (council-resolved) ([303ca6b](https://github.com/event4u-app/agent-config/commit/303ca6b6346298601fb789d08d003e023ab26ac4))
+
+Tests: 5375 (+0 since 5.6.1)
+
 ## [5.6.1](https://github.com/event4u-app/agent-config/compare/5.6.0...5.6.1) (2026-06-01)
 
 ### Bug Fixes

package/README.md

@@ -4,7 +4,7 @@
 
 [![Smoke](https://github.com/event4u-app/agent-config/actions/workflows/smoke.yml/badge.svg)](https://github.com/event4u-app/agent-config/actions/workflows/smoke.yml) [![Public install smoke (3 OS × 2 Node)](https://github.com/event4u-app/agent-config/actions/workflows/smoke-public-install.yml/badge.svg)](https://github.com/event4u-app/agent-config/actions/workflows/smoke-public-install.yml) [![npm](https://img.shields.io/npm/v/@event4u/agent-config?style=flat-square&label=npm&color=orange)](https://www.npmjs.com/package/@event4u/agent-config)
 
-[![Skills](https://img.shields.io/badge/Skills-222-orange?style=flat-square)](.agent-src/skills/) [![Rules](https://img.shields.io/badge/Rules-79-orange?style=flat-square)](.agent-src/rules/) [![Commands](https://img.shields.io/badge/Commands-145-orange?style=flat-square)](.agent-src/commands/) [![Guidelines](https://img.shields.io/badge/Guidelines-73-orange?style=flat-square)](docs/guidelines/) [![Personas](https://img.shields.io/badge/Personas-24-orange?style=flat-square)](.agent-src/personas/) [![Advisors](https://img.shields.io/badge/Advisors-5-orange?style=flat-square)](.agent-src/personas/advisors/)
+[![Skills](https://img.shields.io/badge/Skills-223-orange?style=flat-square)](.agent-src/skills/) [![Rules](https://img.shields.io/badge/Rules-79-orange?style=flat-square)](.agent-src/rules/) [![Commands](https://img.shields.io/badge/Commands-150-orange?style=flat-square)](.agent-src/commands/) [![Guidelines](https://img.shields.io/badge/Guidelines-73-orange?style=flat-square)](docs/guidelines/) [![Personas](https://img.shields.io/badge/Personas-24-orange?style=flat-square)](.agent-src/personas/) [![Advisors](https://img.shields.io/badge/Advisors-5-orange?style=flat-square)](.agent-src/personas/advisors/)
 
 > **The Universal AI Agent OS for Founders, Content Creators, Consultants, Sales, Finance, and Engineering teams. Bring your own AI provider.**
 
@@ -369,7 +369,7 @@ When a prompt matches a command's purpose ("setze ticket ABC-123 um" → `/imple
 | [**Migration**](docs/MIGRATION.md) | Per-version upgrade steps |
 | [**Showcase**](docs/showcase.md) | More examples & expected behavior |
 
-Browse content: [all 145 commands](.agent-src/commands/) · [skills catalog](docs/skills-catalog.md) · [full catalog](docs/catalog.md) · [`llms.txt`](llms.txt).
+Browse content: [all 150 commands](.agent-src/commands/) · [skills catalog](docs/skills-catalog.md) · [full catalog](docs/catalog.md) · [`llms.txt`](llms.txt).
 
 ---
 

package/config/agent-settings.template.yml

@@ -28,7 +28,7 @@ agent_config_version: ""
 # balanced = kernel + tier-1 auto-rules (default — current behaviour superset).
 # full     = kernel + tier-1 + tier-2 (everything, highest token cost).
 # custom   = ignore profile — every matrix value must be set explicitly.
-cost_profile: __COST_PROFILE__
+rule_loading_tier: __RULE_LOADING_TIER__
 
 # --- Lean projection (experimental, opt-in) ---
 #
@@ -220,7 +220,7 @@ pipelines:
   # Skill improvement pipeline (true, false)
   # true  = after meaningful tasks, propose learning capture and improvements (default)
   # false = silent, no post-task analysis
-  # Included by every cost_profile except `custom`. Flip to false here if you
+  # Included by every rule_loading_tier except `custom`. Flip to false here if you
   # want a silent agent; `custom` profile ignores this default entirely.
   skill_improvement: true
 
@@ -429,6 +429,15 @@ commands:
 # docs/contracts/agent-memory-contract.md for the on-disk shape and
 # .augment/skills/memory-consolidation/ for the four-phase loop.
 memory:
+  # Cadence for the "🧠 Memory: <hits>/<asks>" visibility line emitted
+  # after a memory-consulting step (see docs/contracts/memory-visibility-v1.md).
+  #   always = (default) emit whenever at least one memory type was asked.
+  #   auto   = emit only when ≥ 3 memory types were consulted (less noise
+  #            on shallow-retrieval steps).
+  #   never  = suppress the line entirely.
+  # The legacy `memory.visibility: off` master switch still wins over this.
+  cadence: always
+
   # Inline-review threshold for /memory load.
   # When the unreviewed intake stream contains more than this many
   # entries, /memory load surfaces a top-3 preview block before the

package/config/discovery/packs.yml

@@ -79,6 +79,7 @@
   label: Product Basic
   description: Core PO/PM artefacts (ticket refinement, AC, estimation).
   workspaces: [product]
+  requires_hint: [engineering-base]
   trust_level_default: professional
 
 - id: product-discovery
@@ -163,6 +164,16 @@
     example_workflow: scene-expander
     time_to_first_value_minutes: 12
 
+- id: fun
+  label: Fun
+  description: Non-essential social/fun workflows (prediction-pool tips, etc.).
+  workspaces: [small-business]
+  trust_level_default: experimental
+  onboarding:
+    first_win_doc: FIRST_WIN.md
+    example_workflow: prediction-pool-optimizer
+    time_to_first_value_minutes: 6
+
 - id: meta
   label: Meta
   description: Artefacts that maintain this package (agent-config itself).

package/config/discovery/session-profiles.yml

@@ -0,0 +1,37 @@
+# Session-profile aliases — convenience names for `/profile activate <name>`
+#
+# Each alias maps to a SEED set of pack ids. Activation expands the seed
+# set's transitive `requires_hint` closure from `config/discovery/packs.yml`
+# (so `laravel` pulls in `php` + `engineering-base` automatically).
+#
+# The activatable token for `/profile activate` is EITHER:
+#   - an alias name below (expands to its seed packs + closure), OR
+#   - a raw pack id from packs.yml (expands to its own closure).
+#
+# Multiple tokens union their closures: `/profile activate laravel po`.
+# Only INSTALLED packs are activatable — see scripts/config/session_profiles.py
+# (installed set = the `packs:` block in .agent-settings.yml, or the full
+# vocabulary when no block is present, e.g. the maintainer repo).
+#
+# This file is a runtime modulation of the EXISTING `pack` axis, NOT a new
+# axis — see the ADR-010 addendum (2026-06-02).
+#
+# Lint: scripts/lint_discovery_vocabulary.py treats alias VALUES as pack-id
+# references; every value must be a known pack id.
+
+aliases:
+  # Engineering — the base hygiene surface. Activate a language/framework
+  # pack alongside it (e.g. `/profile activate developer laravel`).
+  developer: [engineering-base]
+
+  # Product owner / PM surface.
+  po: [product-basic, product-discovery]
+
+  # Finance / FP&A surface.
+  finance: [finance-basic]
+
+  # Go-to-market surface.
+  gtm: [gtm-sales, gtm-marketing]
+
+  # Content / marketing creator surface.
+  content: [gtm-marketing]

package/config/discovery/workspaces.yml

@@ -55,7 +55,7 @@
   description: Self-employed / SMB-shaped owner workflows.
   example_roles: [Owner, Freelancer]
   default_packs: [small-business]
-  optional_packs: [ai-video]
+  optional_packs: [ai-video, fun]
 
 - id: construction
   label: Construction

package/config/profiles/balanced.ini

@@ -7,7 +7,7 @@
 ; a shell command can be invoked via scripts/runtime_dispatcher.py.
 ; See docs/customization.md for the full profile description.
 
-cost_profile=balanced
+rule_loading_tier=balanced
 
 ; Chat history (crash recovery) — balanced = phase-level traceability
 chat_history_frequency=per_phase

package/config/profiles/full.ini

@@ -7,7 +7,7 @@
 ; read-only and opt-in per call. See docs/customization.md for the full
 ; profile description.
 
-cost_profile=full
+rule_loading_tier=full
 
 ; Chat history (crash recovery) — full = tool-level traceability + summarize on overflow
 chat_history_frequency=per_tool

package/config/profiles/minimal.ini

@@ -7,7 +7,7 @@
 ; profile description. scripts/install.py merges this file with
 ; config/agent-settings.template.ini to produce the user's .agent-settings.
 
-cost_profile=minimal
+rule_loading_tier=minimal
 
 ; Chat history (crash recovery) — minimal = lightest footprint
 chat_history_frequency=per_turn

package/dist/discovery/deprecation-report.md

@@ -1,6 +1,6 @@
 # Discovery — Deprecation Report
 
-- Generated: `2026-06-01T05:28:53Z`
+- Generated: `2026-06-02T02:48:57Z`
 - Deprecated artefacts: **0**
 
 _None. Tree is clean._