@event4u/agent-config 2.26.0 → 3.1.0

package/.agent-src/commands/fix/pr-bot-comments.md

@@ -10,6 +10,18 @@ suggestion:
   eligible: true
   trigger_description: "address the Copilot/Greptile comments, fix the bot review feedback"
   trigger_context: "open PR with bot review comments unresolved"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /fix pr-bot-comments

package/.agent-src/commands/fix/pr-comments.md

@@ -10,6 +10,18 @@ suggestion:
   eligible: true
   trigger_description: "fix all PR review comments, resolve the review feedback"
   trigger_context: "open PR with unresolved comments (bot + human)"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /fix pr-comments

package/.agent-src/commands/fix/pr-developer-comments.md

@@ -10,6 +10,18 @@ suggestion:
   eligible: true
   trigger_description: "fix the human reviewer comments, address the developer feedback"
   trigger_context: "open PR with unresolved human-reviewer comments"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /fix pr-developer-comments

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

@@ -8,6 +8,18 @@ disable-model-invocation: true
 suggestion:
   eligible: false
   rationale: "Package-internal — only the event4u/agent-config repo runs this."
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /fix refs

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

@@ -11,6 +11,18 @@ suggestion:
   trigger_description: "the seeder is broken, foreign key errors in seeders"
   trigger_context: "seeder error output or recent edits in database/seeders/"
 framework: laravel
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /fix seeder

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

@@ -9,6 +9,18 @@ suggestion:
   eligible: true
   trigger_description: "fix CI, fix references, fix the broken seeder, fix PR comments, address bot review"
   trigger_context: "user wants to fix something that has a dedicated sub-command"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /fix

package/.agent-src/commands/ghostwriter/delete.md

@@ -3,17 +3,29 @@ name: ghostwriter:delete
 tier: 2
 cluster: ghostwriter
 sub: delete
-description: Hard-delete a ghostwriter profile at agents/ghostwriter/<slug>.md after a two-step confirmation. No backup, no soft delete — the file is gone after acceptance.
+description: Hard-delete a ghostwriter profile at agents/reference/ghostwriter/<slug>.md after a two-step confirmation. No backup, no soft delete — the file is gone after acceptance.
 disable-model-invocation: true
 suggestion:
   eligible: true
   trigger_description: "delete ghostwriter profile, remove public-figure voice, drop ghostwriter, retire captured profile"
-  trigger_context: "user wants to permanently remove a captured ghostwriter profile from agents/ghostwriter/"
+  trigger_context: "user wants to permanently remove a captured ghostwriter profile from agents/reference/ghostwriter/"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /ghostwriter:delete
 
-Hard-delete a single `agents/ghostwriter/<slug>.md` profile after a
+Hard-delete a single `agents/reference/ghostwriter/<slug>.md` profile after a
 **two-step confirmation**. The file is gone after acceptance — no
 backup, no soft delete, no trash directory. Mirrors the destructive
 posture of `/agents:user:delete`.
@@ -31,7 +43,7 @@ Argument shapes:
 
 | State | Action |
 |---|---|
-| File missing | Abort. Print: *"No profile at `agents/ghostwriter/<slug>.md`. Run `/ghostwriter:list` to see what exists."* |
+| File missing | Abort. Print: *"No profile at `agents/reference/ghostwriter/<slug>.md`. Run `/ghostwriter:list` to see what exists."* |
 | File present, `fictional: true` | Abort. Print: *"`<slug>.md` is a package-side fixture. Delete it via the source tree, not this command."* |
 | File present, real | Proceed to Step 2 |
 
@@ -41,7 +53,7 @@ Show the user **exactly** what is about to disappear, sourced from
 the file's frontmatter (do not render the full profile body):
 
 ```
-About to delete agents/ghostwriter/<slug>.md
+About to delete agents/reference/ghostwriter/<slug>.md
   identity.name:       <name>
   role:                <role_or_title>
   category:            <public_figure_category>
@@ -80,11 +92,11 @@ other input → abort with the same cancel line as Step 3.
 Remove the file. Then print:
 
 ```
-✅  agents/ghostwriter/<slug>.md deleted.
+✅  agents/reference/ghostwriter/<slug>.md deleted.
     /ghostwriter:list now shows N profiles.
 ```
 
-`N` reflects the post-delete count under `agents/ghostwriter/`
+`N` reflects the post-delete count under `agents/reference/ghostwriter/`
 (excluding `README.md`).
 
 ### 6. Stale-warning surface (optional)
@@ -104,7 +116,7 @@ post-write surface in `/ghostwriter:fetch` Step 7. Non-blocking.
   consumer ghostwriter files are gitignored by default.
 - **Do NOT delete package-side fixtures.** `fictional: true` files
   belong to the source tree and are out of scope for this command.
-- **Do NOT delete `agents/ghostwriter/README.md`.** The directory
+- **Do NOT delete `agents/reference/ghostwriter/README.md`.** The directory
   anchor is not a profile.
 - **Do NOT bulk-delete.** One slug per invocation, even when the user
   passes a glob.

package/.agent-src/commands/ghostwriter/fetch.md

@@ -3,18 +3,30 @@ name: ghostwriter:fetch
 tier: 2
 cluster: ghostwriter
 sub: fetch
-description: Build or refresh a public-figure voice profile at agents/ghostwriter/<slug>.md from a URL or bare name; runs the public-figure attestation gate; delegates web-fetch / web-search to the host agent.
+description: Build or refresh a public-figure voice profile under agents/reference/ghostwriter/ from a URL or bare name; runs the public-figure attestation gate; delegates web-fetch/web-search to host.
 disable-model-invocation: true
 suggestion:
   eligible: true
   trigger_description: "fetch public figure writing voice, capture LinkedIn / blog / Substack style, build ghostwriter profile from name, refresh stale profile"
-  trigger_context: "user wants to capture a documented public figure's writing voice from a URL or by name into agents/ghostwriter/<slug>.md"
+  trigger_context: "user wants to capture a documented public figure's writing voice from a URL or by name into agents/reference/ghostwriter/<slug>.md"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /ghostwriter:fetch
 
 Build (or refresh) a ghostwriter profile at
-`agents/ghostwriter/<slug>.md` from one of two inputs:
+`agents/reference/ghostwriter/<slug>.md` from one of two inputs:
 
 | Input | Mode | Host-agent capability used |
 |---|---|---|
@@ -37,7 +49,7 @@ Argument shape: `/ghostwriter:fetch <input> [--force-refresh]`.
   (`alice-walker`). If a slug already exists with a different role,
   ask the user for a discriminator suffix (`alice-walker-novelist`).
 
-Existing `agents/ghostwriter/<slug>.md`?
+Existing `agents/reference/ghostwriter/<slug>.md`?
 
 | State | Action |
 |---|---|
@@ -134,7 +146,7 @@ Body: a single `# Notes` section, empty for fresh fetches.
 
 Print the proposed file content as a fenced markdown block. Ask:
 
-> 1. write — save to `agents/ghostwriter/<slug>.md`
+> 1. write — save to `agents/reference/ghostwriter/<slug>.md`
 > 2. edit — open in IDE first (per `file-editor` skill), save after
 > 3. cancel — discard
 
@@ -142,7 +154,7 @@ Only on choice 1 or 2 (after save) write the file. Print the
 post-write summary:
 
 ```
-✅  agents/ghostwriter/<slug>.md written.
+✅  agents/reference/ghostwriter/<slug>.md written.
     confidence: <low|med|high>  ·  sources: <n>  ·  verification: <fetched|user-asserted>
 ```
 
@@ -157,7 +169,7 @@ per-field changes (numbered options). Bump `last_updated` and
 ### 7. Stale-warning surface (always)
 
 After any write (or no-op accept), if any other profile under
-`agents/ghostwriter/*.md` has `source_provenance.last_fetched_at` >
+`agents/reference/ghostwriter/*.md` has `source_provenance.last_fetched_at` >
 90 days old, print one line per stale profile:
 
 ```

package/.agent-src/commands/ghostwriter/list.md

@@ -3,18 +3,30 @@ name: ghostwriter:list
 tier: 2
 cluster: ghostwriter
 sub: list
-description: List captured ghostwriter profiles under agents/ghostwriter/ as a numbered table with confidence, last-fetched, and stale-warning flags. Read-only.
+description: List captured ghostwriter profiles under agents/reference/ghostwriter/ as a numbered table with confidence, last-fetched, and stale-warning flags. Read-only.
 disable-model-invocation: true
 suggestion:
   eligible: true
   trigger_description: "list ghostwriter profiles, show available public-figure voices, which ghostwriters do I have, ghostwriter inventory"
   trigger_context: "user wants to see which ghostwriter profiles exist locally and which are stale"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /ghostwriter:list
 
 Read-only listing of every consumer-side ghostwriter profile under
-`agents/ghostwriter/`. Numbered, with the fields needed to pick one
+`agents/reference/ghostwriter/`. Numbered, with the fields needed to pick one
 for `/ghostwriter:write` or to spot stale profiles that need a
 re-fetch.
 
@@ -22,12 +34,12 @@ re-fetch.
 
 ### 1. Scan
 
-Enumerate `agents/ghostwriter/*.md`, excluding:
+Enumerate `agents/reference/ghostwriter/*.md`, excluding:
 
 - `README.md` (directory anchor, not a profile).
 - Any file whose frontmatter carries `fictional: true` (package-side
   fixtures are not consumer profiles; they should never appear in
-  `agents/ghostwriter/` — surface a warning if one is found).
+  `agents/reference/ghostwriter/` — surface a warning if one is found).
 
 For each remaining file, read the frontmatter and extract:
 
@@ -48,7 +60,7 @@ For each remaining file, read the frontmatter and extract:
 Empty result → print and exit:
 
 ```
-No ghostwriter profiles found under agents/ghostwriter/.
+No ghostwriter profiles found under agents/reference/ghostwriter/.
 Run /ghostwriter:fetch <url-or-name> to capture one.
 ```
 
@@ -71,10 +83,10 @@ Column widths are illustrative — pick the widest entry per column.
 ### 3. Fixture leak warning (defensive)
 
 If Step 1 encountered a `fictional: true` file under
-`agents/ghostwriter/`, print **after** the table:
+`agents/reference/ghostwriter/`, print **after** the table:
 
 ```
-⚠️  agents/ghostwriter/<file>.md carries `fictional: true` — fixtures
+⚠️  agents/reference/ghostwriter/<file>.md carries `fictional: true` — fixtures
     belong in the package source, not in consumer ghostwriter/. Move
     or delete this file.
 ```

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

@@ -9,11 +9,23 @@ suggestion:
   eligible: true
   trigger_description: "show ghostwriter profile, inspect public-figure voice, view ghostwriter details, what does this profile contain"
   trigger_context: "user wants to inspect a single captured ghostwriter profile before writing with it or deciding to refresh / delete it"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /ghostwriter:show
 
-Read-only render of a single `agents/ghostwriter/<slug>.md` profile.
+Read-only render of a single `agents/reference/ghostwriter/<slug>.md` profile.
 Surfaces every field needed to decide whether to consume the voice
 (`/ghostwriter:write`), refresh it (`/ghostwriter:fetch <slug>
 --force-refresh`), or delete it (`/ghostwriter:delete`).
@@ -36,7 +48,7 @@ Resolution table:
 
 | State | Action |
 |---|---|
-| File missing | Abort. Print: *"No profile at `agents/ghostwriter/<slug>.md`. Run `/ghostwriter:list` to see what exists."* |
+| File missing | Abort. Print: *"No profile at `agents/reference/ghostwriter/<slug>.md`. Run `/ghostwriter:list` to see what exists."* |
 | File present, `fictional: true` | Print a one-line warning before rendering: *"⚠️ This is a package-side fixture, not a real-person profile."* Then render normally. |
 | File present, real | Render (Step 2) |
 

package/.agent-src/commands/ghostwriter/write.md

@@ -9,12 +9,24 @@ suggestion:
   eligible: true
   trigger_description: "draft post in style of public figure, write in someone's voice, ghostwriter draft, LinkedIn post in style of X"
   trigger_context: "user wants to generate a copyable draft in a previously captured public-figure voice with the mandatory disclosure footer"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /ghostwriter:write
 
 Generate a copyable markdown draft in the voice of a captured
-ghostwriter profile under `agents/ghostwriter/<slug>.md`. Implements
+ghostwriter profile under `agents/reference/ghostwriter/<slug>.md`. Implements
 the [`write-engine`](../../../docs/contracts/write-engine.md) contract
 with **mandatory disclosure footer** appended by this command's output
 template (not by the model, no opt-out).
@@ -37,7 +49,7 @@ Argument shapes:
 on) the `aliases:` list of every consumer profile. See
 [`ghostwriter-schema § Aliases`](../../../docs/contracts/ghostwriter-schema.md#aliases).
 
-Scan `agents/ghostwriter/*.md`, excluding `README.md` and any file
+Scan `agents/reference/ghostwriter/*.md`, excluding `README.md` and any file
 with `fictional: true` (fixtures are not consumable from this
 command — they live in the package source as schema examples).
 
@@ -128,7 +140,7 @@ If the selected profile's `source_provenance.last_fetched_at` is
 > 90 days old, print one line **after** the fenced block:
 
 ```
-⚠️  agents/ghostwriter/<slug>.md last fetched YYYY-MM-DD (>90 days). Run /ghostwriter:fetch <slug> --force-refresh.
+⚠️  agents/reference/ghostwriter/<slug>.md last fetched YYYY-MM-DD (>90 days). Run /ghostwriter:fetch <slug> --force-refresh.
 ```
 
 Non-blocking.

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

@@ -9,6 +9,18 @@ suggestion:
   eligible: true
   trigger_description: "fetch a public figure's writing voice, write in someone's style, list ghostwriter profiles, refresh stale profile"
   trigger_context: "user wants to capture or use the public-facing writing voice of a documented public figure for AI-assisted drafting"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /ghostwriter
@@ -80,8 +92,8 @@ Cluster locked in
 
 | Location | Holds | Tracked in git? |
 |---|---|---|
-| `agents/ghostwriter/<slug>.md` (consumer) | Real-person public-figure profiles | **No** — gitignored by default. `--shared` opt-in deferred to v2. |
-| `agents/ghostwriter/README.md` (consumer) | Directory anchor + how-to | Yes |
+| `agents/reference/ghostwriter/<slug>.md` (consumer) | Real-person public-figure profiles | **No** — gitignored by default. `--shared` opt-in deferred to v2. |
+| `agents/reference/ghostwriter/README.md` (consumer) | Directory anchor + how-to | Yes |
 | `.agent-src.uncompressed/ghostwriter/*.md` (package) | `fictional: true` fixtures only | Yes — CI-enforced by `scripts/lint_ghostwriter_source.py` |
 
 Slug = full-name kebab-case with optional `-<discriminator>` suffix

package/.agent-src/commands/grill-me.md

@@ -9,6 +9,18 @@ suggestion:
   eligible: true
   trigger_description: "grill me, grill me on this, grill me on this plan, grill me through this, grill me on the idea, grill me until it's clear, grill me hard"
   trigger_context: "user has a fuzzy plan/idea/feature draft and wants it sharpened interactively rather than reconstructed in one shot"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /grill-me

package/.agent-src/commands/implement-ticket.md

@@ -8,6 +8,18 @@ suggestion:
   eligible: true
   trigger_description: "implement this ticket, setze ticket X um, build PROJ-123"
   trigger_context: "ticket key matching [A-Z]+-[0-9]+ in branch name or prompt"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # implement-ticket

package/.agent-src/commands/install-via-agent.md

@@ -0,0 +1,129 @@
+---
+name: install-via-agent
+tier: 2
+skills: []
+description: Drive `@event4u/agent-config` installer through its JSON agent-mode protocol — turn-by-turn workspace + pack selection without TTY.
+disable-model-invocation: true
+suggestion:
+  eligible: true
+  trigger_description: "install @event4u/agent-config in this project via agent mode, headless install, no TTY"
+  trigger_context: "user wants to install or re-install @event4u/agent-config and the agent should drive the picker (not a human at a terminal)"
+workspaces:
+  - agent-config-maintainer
+  - engineering
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: false
+  removable: true
+---
+
+# /install-via-agent
+
+Drive the `@event4u/agent-config` installer through its **agent-mode**
+protocol — a JSON-over-stdio state machine that lets an LLM agent
+pick workspaces + packs turn-by-turn without a TTY.
+
+Contract: [`docs/contracts/installer-agent-mode.md`](../docs/contracts/installer-agent-mode.md).
+Architecture: [ADR-016](../../docs/decisions/ADR-016-installer-architecture.md) § 4, § 6.
+
+## When to use
+
+- Headless / CI install where no human is at a keyboard.
+- Re-install with a different workspace + pack mix.
+- Demonstrating the protocol for documentation or smoke tests.
+
+For interactive install with a human, run `npx @event4u/agent-config init`
+in a real terminal — the installer auto-detects the TTY and renders
+the `@inquirer/prompts` picker.
+
+## Steps
+
+### 1. Locate the installer
+
+```bash
+which agent-config-installer            # global install
+ls node_modules/.bin/agent-config-installer  # local install
+# OR run from monorepo dev:
+node packages/core/installer/dist/cli.js --version
+```
+
+### 2. Turn 1 — request the first question
+
+```bash
+agent-config-installer init --agent --dry-run
+```
+
+The CLI emits a single JSON line:
+
+```json
+{"status":"question","protocol_version":1,"id":"q1.workspaces", … "next_call":"init --agent --answer q1.workspaces=<value>"}
+```
+
+Parse `choices[]` and pick the workspaces the project needs (multi:
+comma-separated values, e.g. `engineering,product`).
+
+### 3. Turn 2 — answer workspaces, request pack list
+
+Execute the `next_call` substituting `<value>`:
+
+```bash
+agent-config-installer init --agent --dry-run --answer q1.workspaces=engineering
+```
+
+Response:
+
+```json
+{"status":"question","id":"q2.packs", … "next_call":"… --answer q1.workspaces=engineering --answer q2.packs=<value>"}
+```
+
+Pick from `choices[]`. The list is already scoped to the workspaces
+chosen in turn 1.
+
+### 4. Turn 3 — answer packs, possibly confirm auto-added
+
+```bash
+agent-config-installer init --agent --dry-run --answer q1.workspaces=engineering --answer q2.packs=engineering-base,php
+```
+
+Two terminal cases:
+
+- **`done`** — selection complete, no auto-added packs:
+
+  ```json
+  {"status":"done","summary":{"files_written":83,"lockfile_sha256":"…"}}
+  ```
+
+- **`question` (`q3.confirm`)** — `requires_hint` pulled extra packs
+  in. Re-issue with `--answer q3.confirm=yes` to proceed, or
+  `--answer q3.confirm=no` to abort with `aborted_by_agent`.
+
+### 5. Drop `--dry-run` for the real install
+
+Once the agent has confirmed the plan, repeat the final turn
+without `--dry-run`. Files materialize atomically; the lockfile
+lands at `agents/agent-config.lock.yml`. <!-- ref-ignore -->
+
+## Failure modes
+
+- **Exit 2 + `status:"error"`** — `answer_malformed`,
+  `out_of_order`, `unknown_workspace`, `unknown_pack`, or
+  `aborted_by_agent`. Read `reason` and `expected_question_id`,
+  fix the next call, re-issue.
+- **Manifest not found** — pass `--manifest <path>` pointing at
+  `dist/discovery/discovery-manifest.json`.
+- **`protocol_version` mismatch** — abort; do not attempt
+  recovery. Upgrade the agent or pin an older installer.
+
+## Rules
+
+- **One JSON envelope per turn** — never batch.
+- **Re-issue from scratch on doubt** — the installer is stateless;
+  carrying all prior answers in `--answer` flags is the contract.
+- **Do NOT commit `agent-config.lock.yml` blind** — review the
+  lockfile diff before committing per `commit-policy`.

package/.agent-src/commands/jira-ticket.md

@@ -8,6 +8,18 @@ suggestion:
   eligible: true
   trigger_description: "implement the ticket on this branch, work on the Jira ticket from the branch"
   trigger_context: "branch name matching feat/PROJ-123-* or similar"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # jira-ticket

package/.agent-src/commands/judge/on-diff.md

@@ -9,6 +9,18 @@ disable-model-invocation: true
 suggestion:
   eligible: false
   rationale: "Subagent orchestration — overlaps /work and judge skills; keep explicit."
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /judge on-diff

package/.agent-src/commands/judge/solo.md

@@ -9,6 +9,18 @@ disable-model-invocation: true
 suggestion:
   eligible: false
   rationale: "Sibling of /review-changes — eligibility routed there; keep this explicit."
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /judge solo