@event4u/agent-config 5.7.0 → 5.9.0

package/.agent-src/commands/prediction-pool.md

@@ -95,17 +95,24 @@ and standing notes — so re-tuning later is fast.
 Resolve the pool URL (`--pool-url` → saved analysis → ask). Then run the
 optimizer skill's **rules pass** against the pool's rule page: exact result
 vs. goal-difference vs. tendency points, bonus questions, joker rules,
-quote/rarity scoring, special rules, deadlines, strategy limits. **No tips
-before the rules are understood** — the whole strategy depends on them.
+quote/rarity scoring, special rules, deadlines, strategy limits. **Enumerate
+every open question as an explicit checklist** (scores AND every bonus /
+award / special question) — that list is the run's contract; each entry must
+reach an answer. **No tips before the rules are understood** — the whole
+strategy depends on them.
 
 ### 4. Run the optimizer + offer the AI-council pass
 
 Run [`prediction-pool-optimizer`](../skills/prediction-pool-optimizer/SKILL.md),
-adapted to the event's sport (football / basketball / …): market odds as
-the primary signal → expected value under the Step-3 rules → participant
-field → tip. Tournament/outright probabilities come from real outright
-odds **or** the skill's executed Poisson helper — **never** a hallucinated
-"I simulated 10,000 runs".
+adapted to the event's sport (football / basketball / …): a **de-vigged
+consensus across the 5–10 biggest publicly-viewable bookmakers**
+(sharp-weighted, never one portal) as the primary signal → expected value
+under the Step-3 rules → participant field → tip. **Answer every entry on the
+Step-3 checklist** — scores AND every bonus / award / special question (top
+scorer, "team of the top scorer", group winners, most cards …); none blank.
+Tournament/outright/award probabilities come from real markets **or** the
+skill's executed Poisson helper — **never** a hallucinated "I simulated
+10,000 runs".
 
 **Offer the AI-council pass (default off).** Unless `--council` is set,
 ask once:
@@ -128,13 +135,19 @@ first per [`ai-council`](../../../core/.agent-src.uncondensed/skills/ai-council/
 
 Present the tips exactly as they would be entered, then **wait**:
 
-| Match | Tip | Prob / EV | Risk | 1-line reason | Odds used |
+| Match | Tip | Prob / EV | Risk | 1-line reason | Books used |
 |---|---|---|---|---|---|
 
-Follow with group standings, the full bracket, and bonus-question answers
-where the event has them. Then ask **whether to enter** and **into which
-pool** (the saved URL, a different one, or none). Do **not** write the
-analysis yet (Step 9) — tips are not yet confirmed.
+Follow with group standings, the full bracket, **and a bonus/special-answer
+table with one row per open question from the Step-3 checklist — every entry
+answered, none blank**:
+
+| Question | Answer | Prob / EV | Risk | 1-line reason | Source (market / model) |
+|---|---|---|---|---|---|
+
+Then ask **whether to enter** and **into which pool** (the saved URL, a
+different one, or none). Do **not** write the analysis yet (Step 9) — tips
+are not yet confirmed.
 
 ### 6. Enter via Playwright (you log in)
 
@@ -189,6 +202,12 @@ file path. No commit. No push.
 - **You log in; the agent never handles credentials.** Headful only.
 - **The agent never submits** unless `--submit` or this-turn authorization.
 - **Rules first.** No tips before the pool's scoring is parsed.
+- **Answer every open question.** Scores AND every bonus / award / special
+  question; a run that ships scorelines only and leaves bonus questions blank
+  is incomplete.
+- **Consensus odds, not one portal.** Build the base from a de-vigged,
+  sharp-weighted consensus across the 5–10 biggest viewable books — never
+  mirror a single bookmaker.
 - **No hallucinated simulation.** Outright odds or executed Poisson code —
   never a claimed-but-unrun Monte-Carlo.
 - **Analysis is written only after tips are confirmed** (Step 9), never

package/.agent-src/commands/profile/activate.md

@@ -0,0 +1,81 @@
+---
+model_tier: medium
+name: profile:activate
+tier: 2
+cluster: profile
+sub: activate
+description: Activate a session profile — surface only the named profile/pack closure plus core artefacts, no persistence
+suggestion:
+  eligible: true
+  trigger_description: "activate the laravel/po/finance profile for this session, switch my surface to X, only show me X commands"
+  trigger_context: "user wants the surfaced commands/skills narrowed to one audience for the current session"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+---
+
+# /profile activate
+
+Activate one or more session profiles / packs. Writes the expanded
+`runtime.active_packs` overlay and re-biases the surfaced set for the rest
+of the session.
+
+## Instructions
+
+### 1. Resolve + write the overlay
+
+Run the helper (it resolves aliases ↔ pack ids, fails fast on a
+not-installed pack, expands the `requires_hint` closure, and writes the
+overlay **atomically**):
+
+```bash
+python3 -m scripts.config.session_profiles activate <name…> --json
+```
+
+- **Exit 0** → parse the JSON: `active_packs`, `closure_added`, `notes`.
+- **Exit 2** (`error:` on stderr) → the token is unknown or the pack is
+  not installed. Surface the error verbatim and stop — do **not** write a
+  partial overlay. Suggest `/profile show` or naming an installed pack.
+
+### 2. Confirm the switch
+
+Announce, using the helper's output:
+
+```
+> profile active: {active_packs}
+> surfaced: {N} commands, {M} skills ({H} hidden behind inactive packs)
+```
+
+Get the counts from `python3 -m scripts.config.session_profiles show --json`.
+
+### 3. Re-bias the surface for the rest of the session
+
+From now until `/profile deactivate` (or a new session), when the user asks
+"what can I do" / you list commands or skills, surface **only** the active
+set. Compute it with:
+
+```bash
+python3 -m scripts.config.session_profiles surface --json
+```
+
+`shown` = surface these; `hidden` = do not list them proactively. Core /
+unscoped artefacts are always in `shown`.
+
+**Execution is NOT gated.** If the user invokes a command/skill that is in
+`hidden`, run it anyway and prepend one line:
+
+```
+> note: `{name}` is from an inactive pack ({packs}); `/profile activate {pack}` to surface it.
+```
+
+## Gotchas
+
+- Never write to `.agent-settings.yml` — the overlay is local-only.
+- Multiple names union: `/profile activate laravel po`.
+- A corrupt overlay is ignored (fail-open) → re-run activate to repair it.
+
+## See also
+
+- [`/profile show`](show.md) · [`/profile deactivate`](deactivate.md)
+- [`docs/contracts/session-profile-overlay.md`](../../../docs/contracts/session-profile-overlay.md)

package/.agent-src/commands/profile/deactivate.md

@@ -0,0 +1,68 @@
+---
+model_tier: medium
+name: profile:deactivate
+tier: 2
+cluster: profile
+sub: deactivate
+description: Deactivate the session profile — clear the overlay (or drop named packs) so the full surface returns
+suggestion:
+  eligible: true
+  trigger_description: "deactivate the profile, clear my session profile, show everything again, reset the surface"
+  trigger_context: "user wants the full command/skill surface back after a profile was active"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+---
+
+# /profile deactivate
+
+Clear the session-profile overlay (or remove only named packs). This is the
+**explicit** deactivation trigger locked in Phase 0 (option a) — there is
+no silent session reset.
+
+## Instructions
+
+### 1. Clear or narrow
+
+- `/profile deactivate` (no args) → clear the whole overlay:
+
+  ```bash
+  python3 -m scripts.config.session_profiles deactivate --json
+  ```
+
+- `/profile deactivate <name…>` → remove only the **named packs** from the
+  active set (never their closure), so a shared dependency survives:
+
+  ```bash
+  python3 -m scripts.config.session_profiles deactivate <name…> --json
+  ```
+
+Parse `active_packs` from the JSON.
+
+### 2. Confirm
+
+```
+> profile cleared — full surface restored.
+```
+
+or, when packs remain:
+
+```
+> active now: {active_packs} — full surface for everything else.
+```
+
+### 3. Restore the full surface
+
+Resume surfacing every command/skill from this point in the session.
+
+## Gotchas
+
+- Deactivation is idempotent — clearing an empty overlay is a no-op.
+- Only named packs are removed: `/profile deactivate laravel` leaves `php`
+  and `engineering-base` active (they are their own entries in the overlay).
+  Removing a pack only ever widens the surface, never hides something.
+
+## See also
+
+- [`/profile activate`](activate.md) · [`/profile show`](show.md)

package/.agent-src/commands/profile/show.md

@@ -0,0 +1,70 @@
+---
+model_tier: medium
+name: profile:show
+tier: 2
+cluster: profile
+sub: show
+description: Show the active session profile — active packs and surfaced/hidden command+skill counts (observability surface)
+suggestion:
+  eligible: true
+  trigger_description: "show my active profile, which packs are active, what's surfaced this session, profile status"
+  trigger_context: "user wants to see the current session-profile state and what it hides"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+---
+
+# /profile show
+
+Observability surface for the session-profile overlay — the diagnostic the
+council required so a "wrong commands in /help" symptom is one command away
+from its cause.
+
+## Instructions
+
+### 1. Read the state
+
+```bash
+python3 -m scripts.config.session_profiles show --json
+```
+
+Fields: `active_packs`, `commands_shown`, `skills_shown`, `hidden_total`.
+
+### 2. Report
+
+- **No overlay** (`active_packs` empty):
+
+  ```
+  > no profile active — full surface (everything shown).
+  ```
+
+- **Overlay active:**
+
+  ```
+  > active packs: {active_packs}
+  > surfaced: {commands_shown} commands, {skills_shown} skills
+  > hidden behind inactive packs: {hidden_total}
+  > clear with /profile deactivate
+  ```
+
+### 3. (Optional) list the split
+
+If the user asks *which* artefacts are hidden, run:
+
+```bash
+python3 -m scripts.config.session_profiles surface --json
+```
+
+and list `hidden[]` (name + packs). Keep it scannable; group by pack if long.
+
+## Gotchas
+
+- `show` never writes — pure read, safe to run anytime.
+- A corrupt overlay reads as empty (fail-open); if `show` reports "no
+  profile" right after an `activate`, the overlay file is malformed —
+  re-run `/profile activate`.
+
+## See also
+
+- [`/profile activate`](activate.md) · [`/profile deactivate`](deactivate.md)

package/.agent-src/commands/profile.md

@@ -0,0 +1,68 @@
+---
+model_tier: medium
+name: profile
+tier: 2
+description: Session-profile orchestrator — activate / deactivate / show the active packs for this session (recommendation-bias surface filter, no persistence)
+cluster: profile
+type: orchestrator
+suggestion:
+  eligible: true
+  trigger_description: "activate a profile for this session, switch to the laravel/po/finance surface, show which packs are active, deactivate the profile"
+  trigger_context: "user wants to narrow the surfaced commands/skills to one audience for the current session without changing committed config"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+---
+
+# /profile
+
+Top-level orchestrator for the `/profile` family. Activates a **session
+profile** — an ephemeral `runtime.active_packs` overlay that biases which
+commands/skills are *surfaced* this session, without persisting anything
+to committed config.
+
+The overlay is a runtime modulation of the existing `pack` axis, **not** a
+fifth axis (ADR-010 addendum, 2026-06-02). It is written to
+`.agent-settings.local.yml` (in `agents/settings/`, gitignored, deepest
+layer), never the committed `.agent-settings.yml`.
+
+## Sub-commands
+
+| Sub-command | Routes to | Purpose |
+|---|---|---|
+| `/profile activate <name…>` | `commands/profile/activate.md` | Surface only the named profile/pack closure + core artefacts |
+| `/profile deactivate [name…]` | `commands/profile/deactivate.md` | Clear the overlay (or drop named packs) → full surface returns |
+| `/profile show` | `commands/profile/show.md` | Active packs + surfaced/hidden counts (observability) |
+
+`<name>` is a session-profile alias (`developer`, `po`, `finance`, `gtm`,
+`content`) from `config/discovery/session-profiles.yml` **or** a raw pack
+id from `config/discovery/packs.yml` (`laravel`, `php`, …). Multiple names
+union their closures: `/profile activate laravel po`.
+
+## Key facts (locked in Phase 0)
+
+- **Recommendation-bias only.** Activation filters the *surfaced* set
+  (`/help` + `<available_skills>`); execution is **never gated** — an
+  inactive-pack command still runs, with a one-line notice.
+- **Explicit deactivation.** The overlay survives an IDE restart; clear it
+  with `/profile deactivate`. A new session emits a staleness *notice*
+  (never a silent reset — the registry-refresh Catch-22, see
+  `agents/settings/contexts/session-host-capability-audit.md`).
+- **Fail-open.** A corrupt overlay is ignored → the full surface returns.
+- **Kill-switch.** Delete `runtime.active_packs` from the local file (or
+  the file itself) to reset.
+
+## Dispatch
+
+1. Parse `/profile <sub-command> [args]`.
+2. Look up the sub-command above; load that file and follow its
+   `## Instructions` verbatim with the remaining args.
+3. Bare `/profile` (no sub-command) → run `/profile show`.
+4. Unknown sub-command → print the table and ask which the user meant.
+
+## See also
+
+- [`mode`](mode.md) — the persist-to-disk precedent this command deliberately avoids.
+- [`docs/decisions/ADR-010-profile-pack-preset-boundary.md`](../../docs/decisions/ADR-010-profile-pack-preset-boundary.md) — axis boundary + overlay addendum.
+- [`docs/contracts/session-profile-overlay.md`](../docs/contracts/session-profile-overlay.md) — overlay schema + surface-filter contract.

package/.agent-src/commands/project-health.md

@@ -1,5 +1,5 @@
 ---
-model_tier: inherit
+model_tier: medium
 name: project-health
 tier: 1
 skills: [quality-tools]

package/.agent-src/commands/quality-fix.md

@@ -1,5 +1,5 @@
 ---
-model_tier: inherit
+model_tier: medium
 name: quality-fix
 tier: 1
 skills: [quality-tools]

package/.agent-src/commands/roadmap/process-full.md

@@ -1,5 +1,5 @@
 ---
-model_tier: inherit
+model_tier: medium
 name: roadmap:process-full
 tier: 2
 cluster: roadmap

package/.agent-src/commands/roadmap/process-phase.md

@@ -1,5 +1,5 @@
 ---
-model_tier: inherit
+model_tier: medium
 name: roadmap:process-phase
 tier: 2
 cluster: roadmap

package/.agent-src/commands/roadmap/process-step.md

@@ -1,5 +1,5 @@
 ---
-model_tier: inherit
+model_tier: medium
 name: roadmap:process-step
 tier: 2
 cluster: roadmap

package/.agent-src/commands/roadmap.md

@@ -1,5 +1,5 @@
 ---
-model_tier: inherit
+model_tier: medium
 name: roadmap
 tier: 1
 description: Roadmap orchestrator — routes to create (authoring) and process-step / process-phase / process-full (autonomous execution).

package/.agent-src/commands/set-cost-profile.md

@@ -1,5 +1,5 @@
 ---
-model_tier: inherit
+model_tier: medium
 name: set-cost-profile
 tier: 1
 description: Change the rule_loading_tier in .agent-settings.yml — shows each profile's meaning and applies the selection

package/.agent-src/commands/skill/preview.md

@@ -1,5 +1,5 @@
 ---
-model_tier: inherit
+model_tier: medium
 name: skill:preview
 tier: 2
 cluster: skill
@@ -46,8 +46,8 @@ plain-language summary. `--format json` is machine-readable.
 
 ### 3. Present the summary
 
-Show the plain-language preview: the skill's execution type (a manual-execution skill
-renders **"instructional only — no automatic execution"**; an assisted-execution skill
+Show the plain-language preview: the skill's execution type (a `manual` skill
+renders **"instructional only — no automatic execution"**; an `assisted` skill
 renders its proposed actions), declared steps, tools, and any file/command
 targets. End on the contract reminder that preview shows *declared intent*, not
 a guarantee of side-effect-freeness.

package/.agent-src/commands/skill.md

@@ -1,5 +1,5 @@
 ---
-model_tier: inherit
+model_tier: medium
 name: skill
 tier: 2
 description: Single-skill orchestrator — routes to preview. Non-destructive "what will this skill do?" before you run it.

package/.agent-src/commands/skills/discover.md

@@ -1,5 +1,5 @@
 ---
-model_tier: inherit
+model_tier: medium
 name: skills:discover
 tier: 2
 cluster: skills

package/.agent-src/commands/skills.md

@@ -1,5 +1,5 @@
 ---
-model_tier: inherit
+model_tier: medium
 name: skills
 tier: 2
 description: Skill discovery orchestrator — routes to discover. Local, explained skill recommendations over the catalog + role shortlists + optional local analytics.

package/.agent-src/commands/sync-agent-settings.md

@@ -1,5 +1,5 @@
 ---
-model_tier: inherit
+model_tier: medium
 name: sync-agent-settings
 tier: 1
 description: Sync `.agent-settings.yml` against the current template + profile — adds new sections/keys, preserves user values, shows a diff before writing

package/.agent-src/commands/sync-gitignore/fix.md

@@ -1,5 +1,5 @@
 ---
-model_tier: inherit
+model_tier: medium
 name: sync-gitignore:fix
 tier: 2
 cluster: sync-gitignore

package/.agent-src/commands/sync-gitignore.md

@@ -1,5 +1,5 @@
 ---
-model_tier: inherit
+model_tier: medium
 name: sync-gitignore
 tier: 1
 cluster: sync-gitignore

package/.agent-src/commands/update-form-request-messages.md

@@ -1,5 +1,5 @@
 ---
-model_tier: inherit
+model_tier: medium
 name: update-form-request-messages
 tier: 2
 framework: laravel

package/.agent-src/skills/check-refs/SKILL.md

@@ -1,5 +1,5 @@
 ---
-model_tier: inherit
+model_tier: medium
 name: check-refs
 description: "Use when verifying cross-references between skills, rules, commands, guidelines, and context documents are not broken after edits, renames, or deletions."
 domain: process

package/.agent-src/skills/finishing-a-development-branch/SKILL.md

@@ -1,5 +1,5 @@
 ---
-model_tier: inherit
+model_tier: medium
 name: finishing-a-development-branch
 description: "Use when the feature is implementation-complete and the next step is 'ship it' — verifies, cleans up, and routes to merge/PR/park/discard — even when the user just says 'I'm done, what now?'."
 domain: process

package/.agent-src/skills/git-workflow/SKILL.md

@@ -1,5 +1,5 @@
 ---
-model_tier: inherit
+model_tier: medium
 name: git-workflow
 description: "Use when working with Git — branch naming, commit messages, PR creation, rebasing, or the code review process — even when the user says 'push this' or 'merge the branch' without naming Git."
 domain: process

package/.agent-src/skills/jira-integration/SKILL.md

@@ -1,5 +1,5 @@
 ---
-model_tier: inherit
+model_tier: medium
 name: jira-integration
 description: "Use when the user says "check Jira", "create ticket", "update issue", or needs JQL queries, ticket transitions, or branch-to-ticket linking."
 domain: process

package/.agent-src/skills/markitdown/SKILL.md

@@ -1,5 +1,5 @@
 ---
-model_tier: inherit
+model_tier: medium
 name: markitdown
 description: "Use when converting PDF, DOCX, XLSX, PPTX, EPUB, images, or audio to Markdown for LLM ingestion via the upstream markitdown-mcp server — 'extract this PDF', 'OCR this image', 'transcribe this audio'."
 status: active