@event4u/agent-config 2.2.0 → 2.2.1

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Shared agent configuration \u2014 skills for AI coding tools (Claude Code, Augment, Cursor, Cline, Windsurf, Gemini CLI).",
-    "version": "2.2.0"
+    "version": "2.2.1"
   },
   "plugins": [
     {

package/CHANGELOG.md

@@ -11,7 +11,15 @@ versioning policy is documented in [CONTRIBUTING.md](CONTRIBUTING.md#versioning-
 
 Four roadmaps land in this release.
 
-**Global-First Install (R4)** — `npx @event4u/create-agent-config init`
+**Package consolidation** — the standalone wrapper package
+`@event4u/create-agent-config` is retired. `npx @event4u/agent-config init`
+is now the canonical one-shot entrypoint; the bundle package gains an
+`init` subcommand that delegates to `scripts/install`. `packages/create-agent-config/`
+is removed from the repo, and every doc / template / help string is
+updated to the new command. Existing users running the old wrapper
+should switch — the old package name will stop receiving releases.
+
+**Global-First Install (R4)** — `npx @event4u/agent-config init`
 now defaults to a **global** install (`~/.claude/`, `~/.cursor/`, …)
 when run outside a project, and a **project** install when run inside
 one. A new global lockfile at `~/.config/agent-config/installed.lock`
@@ -335,6 +343,19 @@ our recommendation order, not its support status.
   users" tension without removing any path that an existing user
   might rely on.
 
+## [2.2.1](https://github.com/event4u-app/agent-config/compare/2.2.0...2.2.1) (2026-05-12)
+
+### Documentation
+
+* changelog + ADR-007 note for package consolidation ([1d0d6fb](https://github.com/event4u-app/agent-config/commit/1d0d6fb8882431ee11a6b034f6157ae9f8ccea4d))
+* update install commands to npx @event4u/agent-config init ([b9956c6](https://github.com/event4u-app/agent-config/commit/b9956c6ff827433bff7dc9aa1f40ba3454ef5154))
+
+### Chores
+
+* consolidate npm package into @event4u/agent-config init ([d3188ce](https://github.com/event4u-app/agent-config/commit/d3188ced3edac5b670b68e22f51295ef831471d6))
+
+Tests: 3350 (+0 since 2.2.0)
+
 ## [2.2.0](https://github.com/event4u-app/agent-config/compare/2.1.0...2.2.0) (2026-05-12)
 
 ### Features

package/docs/DISTRIBUTION_CHECKLIST.md

@@ -74,21 +74,22 @@ are not roadmap steps.
 - **Notes:** **Do not submit before the gate.** Premature listing
   produces a bad first impression and is hard to retract.
 
-### npm: `@event4u/create-agent-config`
+### npm: `@event4u/agent-config`
 
 - **Status:** Prepared
 - **Owner:** maintainer
 - **Last Reviewed:** 2026-05-12
-- **Substrate:** [`packages/create-agent-config/`](../packages/create-agent-config/)
-  source is ready; the wrapper clones the repo to a temp dir, runs
-  `scripts/install`, then deletes the temp dir.
+- **Substrate:** root `package.json` — `bin: scripts/agent-config` exposes
+  `init`, `sync`, `validate`, `mcp:render`, `roadmap:progress`, …
 - **Doc anchor:** [`docs/installation.md`](installation.md) §
   "npx one-liner".
-- **Action:** `npm publish --access public` from `packages/create-agent-config/`.
+- **Action:** routine releases auto-publish via `publish-npm.yml` on tag
+  push; manual fallback is `npm publish --access public` after
+  `task npm:login`.
 - **Pre-conditions:** npm registry credentials for the `@event4u`
   scope.
 - **Notes:** Public scope, MIT-licensed. Verify `npx
-  @event4u/create-agent-config init` in an empty directory before
+  @event4u/agent-config init` in an empty directory before
   declaring Live.
 
 ### GitHub repo topics + tagline

package/docs/decisions/ADR-007-agent-discovery-scopes.md

@@ -10,6 +10,14 @@ phase: post-v2.1.0 · simplicity-and-everywhere
 
 # ADR-007 — Agent Discovery Scopes: Global-Default Install Model
 
+> **Note (post-acceptance):** the one-shot installer command was later
+> renamed from `npx @event4u/create-agent-config init` to
+> `npx @event4u/agent-config init` when the standalone wrapper package
+> was retired. References to the old command name below are preserved
+> for historical accuracy; the discovery-scope decision itself is
+> unchanged. See `CHANGELOG.md` → `[Unreleased]` → "Package
+> consolidation".
+
 ## Status
 
 **Accepted** · 2026-05-12 · signed off by Matze after Council Round 3 convergence. Implementation tracked in `agents/roadmaps/road-to-global-first-install.md`.

package/docs/getting-started.md

@@ -10,7 +10,7 @@ Pick one entrypoint:
 
 ```bash
 # Recommended — one-shot, no local dependency
-npx @event4u/create-agent-config init --tools=claude-code,cursor
+npx @event4u/agent-config init --tools=claude-code,cursor
 
 # No-Node fallback — curl | bash entrypoint (downloads a tarball)
 curl -sSL https://raw.githubusercontent.com/event4u-app/agent-config/main/setup.sh | bash

package/docs/installation.md

@@ -5,7 +5,7 @@
 committed to a repo. No Task, no Make, no build tools required.
 
 > **v2.1+** — the installer detects intent. Running `npx
-> @event4u/create-agent-config init` in `~/` or any directory without a
+> @event4u/agent-config init` in `~/` or any directory without a
 > project manifest defaults to **global**. Running it inside a project
 > (`package.json` / `composer.json` / `pyproject.toml` / etc.) defaults
 > to **project**. Pass `--scope=global` or `--scope=project` to override
@@ -13,7 +13,7 @@ committed to a repo. No Task, no Make, no build tools required.
 
 A global install records itself in `~/.config/agent-config/installed.lock`
 (schema_version, agent_config_version, installed_at, tools[]). `npx
-@event4u/create-agent-config update` keeps that manifest in lockstep
+@event4u/agent-config update` keeps that manifest in lockstep
 with the project pin in `.agent-settings.yml`. A version-mismatched
 re-run of `init --scope=global` is refused with exit code 1 until you
 `update` or pass `--force`.
@@ -37,16 +37,16 @@ section below this index is reference material for advanced installs
 
 | Surface | One-liner | Per-IDE page |
 |---|---|---|
-| **Claude Code** | `npx @event4u/create-agent-config init --tools=claude-code` | [`per-ide/claude-code.md`](setup/per-ide/claude-code.md) |
+| **Claude Code** | `npx @event4u/agent-config init --tools=claude-code` | [`per-ide/claude-code.md`](setup/per-ide/claude-code.md) |
 | **Claude Desktop** | (uses `~/.claude/skills/` from Claude Code global install) | [`per-ide/claude-desktop.md`](setup/per-ide/claude-desktop.md) |
-| **Cursor** | `npx @event4u/create-agent-config init --tools=cursor` | [`per-ide/cursor.md`](setup/per-ide/cursor.md) |
-| **Windsurf** | `npx @event4u/create-agent-config init --tools=windsurf` | [`per-ide/windsurf.md`](setup/per-ide/windsurf.md) |
-| **Cline** | `npx @event4u/create-agent-config init --tools=cline` | [`per-ide/cline.md`](setup/per-ide/cline.md) |
-| **Aider** | `npx @event4u/create-agent-config init --tools=aider` | [`per-ide/aider.md`](setup/per-ide/aider.md) |
-| **Codex CLI** | `npx @event4u/create-agent-config init --tools=codex` | [`per-ide/codex.md`](setup/per-ide/codex.md) |
-| **Gemini CLI** | `npx @event4u/create-agent-config init --tools=gemini` | [`per-ide/gemini-cli.md`](setup/per-ide/gemini-cli.md) |
-| **GitHub Copilot** | `npx @event4u/create-agent-config init --tools=copilot` | [`per-ide/copilot.md`](setup/per-ide/copilot.md) |
-| **All surfaces** | `npx @event4u/create-agent-config init` (default) | (each page above applies) |
+| **Cursor** | `npx @event4u/agent-config init --tools=cursor` | [`per-ide/cursor.md`](setup/per-ide/cursor.md) |
+| **Windsurf** | `npx @event4u/agent-config init --tools=windsurf` | [`per-ide/windsurf.md`](setup/per-ide/windsurf.md) |
+| **Cline** | `npx @event4u/agent-config init --tools=cline` | [`per-ide/cline.md`](setup/per-ide/cline.md) |
+| **Aider** | `npx @event4u/agent-config init --tools=aider` | [`per-ide/aider.md`](setup/per-ide/aider.md) |
+| **Codex CLI** | `npx @event4u/agent-config init --tools=codex` | [`per-ide/codex.md`](setup/per-ide/codex.md) |
+| **Gemini CLI** | `npx @event4u/agent-config init --tools=gemini` | [`per-ide/gemini-cli.md`](setup/per-ide/gemini-cli.md) |
+| **GitHub Copilot** | `npx @event4u/agent-config init --tools=copilot` | [`per-ide/copilot.md`](setup/per-ide/copilot.md) |
+| **All surfaces** | `npx @event4u/agent-config init` (default) | (each page above applies) |
 
 Combine surfaces by comma-separating: `--tools=claude-code,cursor,windsurf`.
 
@@ -106,7 +106,7 @@ the per-IDE index above.
 > 2. `scripts/install.py` — bridge files (`.agent-settings.yml`, VSCode /
 >    Augment / Copilot JSON descriptors).
 >
-> `npx @event4u/create-agent-config init` and `setup.sh` (curl-based)
+> `npx @event4u/agent-config init` and `setup.sh` (curl-based)
 > are thin wrappers that delegate to `scripts/install`. Both underlying
 > stages remain callable directly for advanced use; see their `--help`.
 >
@@ -148,23 +148,23 @@ same flags, no extra state.
 
 ```bash
 # Pick tools interactively (TTY checkbox prompt)
-npx @event4u/create-agent-config init
+npx @event4u/agent-config init
 
 # Pick tools explicitly, non-interactive
-npx @event4u/create-agent-config init --tools=claude-code,cursor --yes
+npx @event4u/agent-config init --tools=claude-code,cursor --yes
 
 # Install everything (the default — backward-compatible)
-npx @event4u/create-agent-config init --tools=all --yes
+npx @event4u/agent-config init --tools=all --yes
 
 # Test a specific git ref (branch, tag, sha) instead of the latest npm tag
-npx @event4u/create-agent-config init --ref=main --yes
+npx @event4u/agent-config init --ref=main --yes
 ```
 
-The `@event4u/create-agent-config` package is a thin wrapper: it
-downloads the latest `@event4u/agent-config` tarball into a temp
-directory, runs `bash scripts/install --target <cwd> ...`, and cleans
-up after itself. The project-local payload package
-(`@event4u/agent-config`) is unchanged.
+`npx @event4u/agent-config init` fetches the latest tarball, runs
+`bash scripts/install --target <cwd> …`, and the install script handles
+its own cleanup. The same package exposes every other `agent-config`
+subcommand (`sync`, `validate`, `mcp:render`, `roadmap:progress`, …) —
+see `npx @event4u/agent-config help`.
 
 ### `curl | bash` (no Node required)
 
@@ -202,12 +202,12 @@ The package is versioned with the project. Settings are committed once.
 ### npx (recommended for any project)
 
 ```bash
-npx @event4u/create-agent-config init --tools=claude-code,cursor
+npx @event4u/agent-config init --tools=claude-code,cursor
 ```
 
-The wrapper downloads the latest `@event4u/agent-config` tarball into a
-temp dir, runs `scripts/install` with the selected tools, and cleans up
-afterwards. Nothing is added to `package.json`.
+`npx` fetches the latest `@event4u/agent-config` tarball and runs
+`scripts/install` with the selected tools. Nothing is added to
+`package.json`.
 
 ### Global CLI (one install per machine)
 
@@ -615,7 +615,7 @@ When a new version of the package is published:
 
 ```bash
 # npx (one-shot, recommended) — always uses the latest tarball
-npx @event4u/create-agent-config init --tools=claude-code,cursor
+npx @event4u/agent-config init --tools=claude-code,cursor
 
 # Global CLI
 npm install -g @event4u/agent-config@latest

package/docs/setup/per-ide/aider.md

@@ -11,7 +11,7 @@ from the repo root for project conventions.
 ## Install
 
 ```bash
-npx @event4u/create-agent-config init --tools=aider
+npx @event4u/agent-config init --tools=aider
 ```
 
 Populates:

package/docs/setup/per-ide/claude-code.md

@@ -15,7 +15,7 @@ projects to those paths during install.
 
 ```bash
 # Inside an existing repo:
-npx @event4u/create-agent-config init --tools=claude-code
+npx @event4u/agent-config init --tools=claude-code
 
 # Or with the curl entrypoint:
 curl -sSL https://raw.githubusercontent.com/event4u-app/agent-config/main/setup.sh \

package/docs/setup/per-ide/cline.md

@@ -11,7 +11,7 @@ and `AGENTS.md`.
 ## Install
 
 ```bash
-npx @event4u/create-agent-config init --tools=cline
+npx @event4u/agent-config init --tools=cline
 ```
 
 Populates:
@@ -35,7 +35,7 @@ automatically. Run `/help` in the chat to verify rule loading.
 | Symptom | Fix |
 |---|---|
 | Rules not picked up | Reload VS Code window after `task generate-tools`. |
-| `.clinerules` missing | Re-run `npx @event4u/create-agent-config init --tools=cline`. |
+| `.clinerules` missing | Re-run `npx @event4u/agent-config init --tools=cline`. |
 
 ## Cross-references
 

package/docs/setup/per-ide/codex.md

@@ -11,7 +11,7 @@ repo root for project context.
 ## Install
 
 ```bash
-npx @event4u/create-agent-config init --tools=codex
+npx @event4u/agent-config init --tools=codex
 ```
 
 Populates:

package/docs/setup/per-ide/copilot.md

@@ -13,7 +13,7 @@ falls back to `AGENTS.md` where supported.
 ## Install
 
 ```bash
-npx @event4u/create-agent-config init --tools=copilot
+npx @event4u/agent-config init --tools=copilot
 ```
 
 Populates:
@@ -69,7 +69,7 @@ gh copilot --version             # if you want CLI plugin
 | Symptom | Fix |
 |---|---|
 | Copilot ignores the file | Reload the IDE window after install. |
-| File missing after install | Re-run `npx @event4u/create-agent-config init --tools=copilot`. |
+| File missing after install | Re-run `npx @event4u/agent-config init --tools=copilot`. |
 | Copilot PR review too noisy | See the `copilot-config` skill for suppression patterns. |
 
 ## Cross-references

package/docs/setup/per-ide/cursor.md

@@ -19,7 +19,7 @@ The package ships **both** so you don't have to pick.
 ## Project install
 
 ```bash
-npx @event4u/create-agent-config init --tools=cursor
+npx @event4u/agent-config init --tools=cursor
 ```
 
 This populates:
@@ -32,7 +32,7 @@ This populates:
 Combine surfaces if you use both Cursor and Claude Code:
 
 ```bash
-npx @event4u/create-agent-config init --tools=cursor,claude-code
+npx @event4u/agent-config init --tools=cursor,claude-code
 ```
 
 ## Global install

package/docs/setup/per-ide/gemini-cli.md

@@ -11,7 +11,7 @@ in the package's projection) for project context.
 ## Install
 
 ```bash
-npx @event4u/create-agent-config init --tools=gemini
+npx @event4u/agent-config init --tools=gemini
 ```
 
 Populates:

package/docs/setup/per-ide/windsurf.md

@@ -19,7 +19,7 @@ The package ships **both**.
 ## Project install
 
 ```bash
-npx @event4u/create-agent-config init --tools=windsurf
+npx @event4u/agent-config init --tools=windsurf
 ```
 
 Populates:
@@ -32,7 +32,7 @@ Populates:
 Combine with other surfaces:
 
 ```bash
-npx @event4u/create-agent-config init --tools=windsurf,claude-code,cursor
+npx @event4u/agent-config init --tools=windsurf,claude-code,cursor
 ```
 
 ## Wave-8 frontmatter

package/docs/troubleshooting.md

@@ -34,7 +34,7 @@ bash scripts/install --verbose
 # or, to regenerate everything (overwrites existing bridge files):
 bash scripts/install --force
 # or, for one-shot installs without a local node_modules tree:
-npx @event4u/create-agent-config init --tools=claude-code,cursor
+npx @event4u/agent-config init --tools=claude-code,cursor
 ```
 
 ### Check 2: Does your agent actually read these directories?
@@ -70,7 +70,7 @@ orchestrator explicitly inside the project root:
 
 ```bash
 # One-shot, no local checkout required (recommended)
-npx @event4u/create-agent-config init --tools=claude-code,cursor
+npx @event4u/agent-config init --tools=claude-code,cursor
 
 # When the global CLI is installed
 agent-config install --tools=claude-code,cursor
@@ -84,7 +84,7 @@ When the package version changes, symlinks that pointed to the old
 package path may break. Re-run the installer — it is idempotent:
 
 ```bash
-npx @event4u/create-agent-config init --tools=claude-code,cursor
+npx @event4u/agent-config init --tools=claude-code,cursor
 ```
 
 The installer replaces stale symlinks with fresh ones pointing at the
@@ -99,7 +99,7 @@ and Unix-style symlinks. Recommended setup:
 
 1. **WSL2** (preferred): install Ubuntu or a distribution of your choice,
    clone the project inside the WSL filesystem, and run
-   `npx @event4u/create-agent-config init` from WSL.
+   `npx @event4u/agent-config init` from WSL.
 2. **Git Bash**: works for the basic install, but symlinks require
    Developer Mode (Windows 10 1703+) or admin privileges. Without either,
    Git Bash falls back to copies, which means updates will not propagate

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@event4u/agent-config",
-    "version": "2.2.0",
+    "version": "2.2.1",
     "description": "Shared agent configuration \u2014 skills, rules, commands, guidelines, and templates for AI coding tools",
     "license": "MIT",
     "private": false,

package/scripts/agent-config

@@ -98,6 +98,9 @@ Commands:
                              Flags: --check (read-only) | --to <version> (explicit pin)
   migrate                    One-shot migration off legacy composer / npm install paths
                              Flags: --dry-run (detect only)
+  init                       One-shot project install. Forwards to `scripts/install`
+                             with all args. Entry point for `npx @event4u/agent-config init`.
+                             Flags: --tools=<list> | --ai=<list> | --yes | --force
   global                     Install to user-scope paths (~/.claude/, ~/.cursor/, …)
                              Forwards to `scripts/install --global` (ADR-007).
                              Flags: --tools=<list> | --ai=<list> | --yes | --force
@@ -139,6 +142,7 @@ Examples:
   ./agent-config council:estimate prompt.txt
   ./agent-config council:run prompt.txt --output agents/council-sessions/out.json --confirm
   ./agent-config council:render agents/council-sessions/out.json
+  ./agent-config init --tools=claude-code,cursor --yes
   ./agent-config global --tools=claude-code --yes
   ./agent-config global --ai=cursor,windsurf
   ./agent-config export --list
@@ -545,6 +549,16 @@ cmd_migrate() {
   exec env PYTHONPATH="$PACKAGE_ROOT" python3 -m scripts._cli.cmd_migrate "$@"
 }
 
+# `agent-config init` — project-scope install entry point. Forwards
+# unmodified args to the bash installer. This is the canonical
+# `npx @event4u/agent-config init` consumer entry point (replaces the
+# deprecated @event4u/create-agent-config wrapper package).
+cmd_init() {
+  local script
+  script="$(resolve_script "scripts/install")" || return 1
+  exec bash "$script" "$@"
+}
+
 # `agent-config global` — user-scope install entry point. Forwards to the
 # bash installer with `--global` set (ADR-007). Phase 1.2 of
 # road-to-global-first-install.md. The bash wrapper handles option parsing
@@ -622,6 +636,7 @@ main() {
     council:render)          cmd_council render "$@" ;;
     update)                  cmd_update "$@" ;;
     migrate)                 cmd_migrate "$@" ;;
+    init)                    cmd_init "$@" ;;
     global)                  cmd_global "$@" ;;
     export)                  cmd_export "$@" ;;
     sync)                    cmd_sync "$@" ;;
@@ -646,7 +661,7 @@ main() {
 maybe_pin_reexec() {
   local cmd="${1-}"
   case "$cmd" in
-    help|--help|-h|--version|-V|update|migrate|"") return 0 ;;
+    help|--help|-h|--version|-V|update|migrate|init|"") return 0 ;;
   esac
   if ! command -v python3 >/dev/null 2>&1; then
     return 0

package/scripts/install.py

@@ -107,7 +107,7 @@ def detect_package_root(project_root: Path) -> Path:
 
     fail(
         "Could not find agent-config package. Install via "
-        "`npx @event4u/create-agent-config init` or `npm install --save-dev @event4u/agent-config`."
+        "`npx @event4u/agent-config init` or `npm install -g @event4u/agent-config`."
     )
     return project_root  # unreachable
 
@@ -2355,7 +2355,7 @@ def main(argv: list[str]) -> int:
             print()
             print("  Next steps:")
             print("    • Commit .agent-settings.yml and bridge files to your repo")
-            print("    • New team members run `npx @event4u/create-agent-config init` — done")
+            print("    • New team members run `npx @event4u/agent-config init` — done")
             print("    • Inspect hook coverage: ./agent-config hooks:status")
             print("    • Full walkthrough: https://github.com/event4u-app/agent-config/blob/main/docs/getting-started.md")
             print()

package/templates/agent-config-wrapper.sh

@@ -56,7 +56,7 @@ cat >&2 <<EOF
       - npx @event4u/agent-config@latest (npx not installed)
 
     Install via:
-      npx @event4u/create-agent-config init     # one-shot setup
+      npx @event4u/agent-config init            # one-shot setup
       npm install -g @event4u/agent-config      # global CLI
 EOF
 exit 127

package/templates/consumer-settings/README.md

@@ -28,7 +28,7 @@ instead of copying files via `install.sh`.
 These tools do **not** support plugins yet. Use the classic installer:
 
 ```bash
-npx @event4u/create-agent-config init --tools=cursor,cline,windsurf,augment
+npx @event4u/agent-config init --tools=cursor,cline,windsurf,augment
 ```
 
 ## What the plugin provides

package/templates/marketing-copy.yml

@@ -42,13 +42,14 @@ listing:
     - copilot
     - augment
 
-# npm package metadata (synced into packages/create-agent-config/package.json
-# and any future @event4u/agent-config packages).
+# npm package metadata (synced into the root @event4u/agent-config
+# package.json on release).
 npm:
-  package: "@event4u/create-agent-config"
+  package: "@event4u/agent-config"
   description: >-
-    Zero-config installer for event4u/agent-config — picks tools,
-    runs the install, works in any directory.
+    Shared agent configuration — skills, rules, slash commands, and
+    one-shot installer (`npx @event4u/agent-config init`) for every
+    major AI coding tool.
   keywords:
     - agent
     - claude