@event4u/agent-config 2.1.0 → 2.2.1

package/scripts/agent-config

@@ -98,6 +98,22 @@ 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
+  export                     Eject a tool's canonical content into a chosen path
+                             (real file, no symlink). Idempotent; --force overrides
+                             content drift. See `./agent-config export --list`.
+                             Flags: --tool=<id> | --output=<path> | --force | --list
+  sync                       Replay agents/installed-tools.lock — re-installs any
+                             tool whose bridge marker is missing locally (ADR-008).
+                             Flags: --dry-run | --force | --project=<path>
+  validate                   Read-only drift detection on the manifest
+                             (marker missing, scope divergence, version drift).
+                             Exits 1 on drift. Flags: --quiet | --skip-version-check
   help                       Show this help
   --version, -V              Print package version
 
@@ -126,6 +142,15 @@ 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
+  ./agent-config export --tool=agents-md --output=AGENTS.md
+  ./agent-config export --tool=copilot-instructions --output=.github/copilot-instructions.md
+  ./agent-config sync --dry-run
+  ./agent-config sync
+  ./agent-config validate
 
 All commands operate on the CURRENT DIRECTORY (your project root).
 The CLI is strictly consumer-facing. Maintainer tasks live in Taskfile.yml.
@@ -524,6 +549,53 @@ 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
+# and forwards to `scripts/install.py --global`, where `install_global()`
+# currently scaffolds the per-tool anchor paths from USER_SCOPE_PATHS.
+# Concrete writes land in Phase 1.5 (export) and Phase 1.6 (lockfile).
+cmd_global() {
+  local script
+  script="$(resolve_script "scripts/install")" || return 1
+  exec bash "$script" --global "$@"
+}
+
+# `agent-config export` — write a tool's canonical content into a
+# user-chosen path. ADR-007 D3 / Phase 1.5 of
+# road-to-global-first-install.md. Replaces the rejected symlink-bridge.
+# See scripts/_cli/cmd_export.py for the registry and idempotency logic.
+cmd_export() {
+  require_python3
+  exec env PYTHONPATH="$PACKAGE_ROOT" python3 -m scripts._cli.cmd_export "$@"
+}
+
+# `agent-config sync` — replay agents/installed-tools.lock (ADR-008
+# Phase 3.3). Re-installs any tool whose bridge marker is missing on
+# disk. Typical onboarding flow: clone → `./agent-config sync` → done.
+cmd_sync() {
+  require_python3
+  exec env PYTHONPATH="$PACKAGE_ROOT" python3 -m scripts._cli.cmd_sync "$@"
+}
+
+# `agent-config validate` — read-only drift detection (ADR-008 Phase 3.4).
+# Surfaces marker-missing, scope-divergence, and version-drift; exits 1 on
+# any drift. Never edits the manifest or re-runs the installer.
+cmd_validate() {
+  require_python3
+  exec env PYTHONPATH="$PACKAGE_ROOT" python3 -m scripts._cli.cmd_validate "$@"
+}
+
 main() {
   local cmd="${1-}"
   [[ $# -gt 0 ]] && shift || true
@@ -564,6 +636,11 @@ main() {
     council:render)          cmd_council render "$@" ;;
     update)                  cmd_update "$@" ;;
     migrate)                 cmd_migrate "$@" ;;
+    init)                    cmd_init "$@" ;;
+    global)                  cmd_global "$@" ;;
+    export)                  cmd_export "$@" ;;
+    sync)                    cmd_sync "$@" ;;
+    validate)                cmd_validate "$@" ;;
     help|--help|-h|"")        usage ;;
     --version|-V)            print_version ;;
     *)
@@ -584,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

@@ -17,7 +17,10 @@
 #   --profile <name>  Cost profile for bridges (minimal|balanced|full)
 #   --tools <list>    Comma-separated tool IDs to install (default: all).
 #                     Valid: claude-code,claude-desktop,cursor,windsurf,
-#                            cline,gemini-cli,copilot,augment,aider,codex,all
+#                            cline,gemini-cli,copilot,augment,aider,codex,
+#                            roocode,continue,kilocode,zed,jetbrains,kiro,all
+#   --ai <list>       Alias for --tools (same IDs). When both are passed
+#                     the comma-separated values are unioned.
 #   --list-tools      Print supported tool IDs with descriptions, then exit
 #   --yes, -y         Non-interactive mode: do not prompt (default for non-TTY)
 #   --force           Overwrite existing bridge files
@@ -26,12 +29,22 @@
 #   --quiet           Suppress non-error output
 #   --skip-sync       Skip payload sync (install.sh)
 #   --skip-bridges    Skip bridge files (install.py)
+#   --global          Install to user-scope paths (~/.claude/, ~/.cursor/, …)
+#                     instead of project-locally. Implies --skip-sync (the
+#                     payload sync stage is project-only). See ADR-007.
+#   --scope <mode>    Override scope detection: auto | project | global | prompt.
+#                     auto   = honor multi-signal detection (Phase 1.3)
+#                     project = force project-local install
+#                     global = force user-scope install (same as --global)
+#                     prompt = always show the 3-option chooser
+#   --custom-path <d> Use <d> as the project root when prompted; rejected with
+#                     --scope=global / --global.
 #   --help, -h        Show this help
 #
 # Examples:
 #   bash scripts/install                                # everything (default)
 #   bash scripts/install --tools=claude-code,cursor     # only those two
-#   bash scripts/install --tools=cursor --yes           # CI-friendly
+#   bash scripts/install --ai=cursor --yes              # alias form (CI-friendly)
 #   bash scripts/install --list-tools                   # show catalog
 
 set -uo pipefail
@@ -53,12 +66,15 @@ QUIET=false
 SKIP_SYNC=false
 SKIP_BRIDGES=false
 LIST_TOOLS=false
+GLOBAL=false
+SCOPE=""
+CUSTOM_PATH=""
 
 # Single source of truth for valid tool IDs (also referenced by install.sh / install.py).
-VALID_TOOLS="claude-code claude-desktop cursor windsurf cline gemini-cli copilot augment aider codex all"
+VALID_TOOLS="claude-code claude-desktop cursor windsurf cline gemini-cli copilot augment aider codex roocode continue kilocode zed jetbrains kiro all"
 
 show_help() {
-    sed -n '3,29p' "${BASH_SOURCE[0]}" | sed 's/^# \{0,1\}//'
+    sed -n '3,48p' "${BASH_SOURCE[0]}" | sed 's/^# \{0,1\}//'
 }
 
 list_tools() {
@@ -66,19 +82,26 @@ list_tools() {
 Supported --tools IDs (default: all):
 
   claude-code      .claude/rules, .claude/skills, .claude/commands, .claude/settings.json
-  claude-desktop   ~/Library/Application Support/Claude/ (global, see Phase 4 docs)
+  claude-desktop   .claude-desktop/agent-config.md marker (global-scope tool — see ADR-007)
   cursor           .cursor/rules, .cursor/commands (legacy .cursorrules also written)
   windsurf         .windsurf/rules, .windsurf/workflows (legacy .windsurfrules also written)
   cline            .clinerules/ symlinks
   gemini-cli       GEMINI.md, .gemini/settings.json
   copilot          .github/copilot-instructions.md, .vscode/settings.json
   augment          .augment/ payload + settings (substrate — recommended for every install)
-  aider            AGENTS.md (Linux Foundation cross-tool contract; always written)
-  codex            AGENTS.md (same as aider — no extra action)
+  aider            .aider/agent-config.md marker (wire via `read:` in .aider.conf.yml)
+  codex            .codex/agent-config.md marker (Codex reads AGENTS.md directly)
+  roocode          .roo/rules/agent-config.md marker (Roo Code auto-discovery)
+  continue         .continue/rules/agent-config.md marker (Continue.dev auto-discovery)
+  kilocode         .kilocode/rules/agent-config.md marker (Kilo Code auto-discovery)
+  zed              .zed/agent-config.md marker (Zed reads .rules at project root)
+  jetbrains        .jetbrains/agent-config.md marker (JetBrains AI Assistant)
+  kiro             .kiro/steering/agent-config.md marker (Kiro auto-discovery)
   all              every ID above (the default; backward-compatible)
 
 Examples:
   --tools=claude-code,cursor       project-local install for those two surfaces
+  --ai=cursor                      alias for --tools=cursor
   --tools=all                      equivalent to omitting the flag
 EOF
 }
@@ -110,8 +133,10 @@ while [[ $# -gt 0 ]]; do
         --target=*)      TARGET_DIR="${1#*=}"; shift ;;
         --profile)       PROFILE="$2"; shift 2 ;;
         --profile=*)     PROFILE="${1#*=}"; shift ;;
-        --tools)         TOOLS="$2"; TOOLS_EXPLICIT=true; shift 2 ;;
-        --tools=*)       TOOLS="${1#*=}"; TOOLS_EXPLICIT=true; shift ;;
+        --tools)         TOOLS="${TOOLS:+$TOOLS,}$2"; TOOLS_EXPLICIT=true; shift 2 ;;
+        --tools=*)       TOOLS="${TOOLS:+$TOOLS,}${1#*=}"; TOOLS_EXPLICIT=true; shift ;;
+        --ai)            TOOLS="${TOOLS:+$TOOLS,}$2"; TOOLS_EXPLICIT=true; shift 2 ;;
+        --ai=*)          TOOLS="${TOOLS:+$TOOLS,}${1#*=}"; TOOLS_EXPLICIT=true; shift ;;
         --list-tools)    LIST_TOOLS=true; shift ;;
         --yes|-y)        YES=true; shift ;;
         --force)         FORCE=true; shift ;;
@@ -120,6 +145,11 @@ while [[ $# -gt 0 ]]; do
         --quiet)         QUIET=true; shift ;;
         --skip-sync)     SKIP_SYNC=true; shift ;;
         --skip-bridges)  SKIP_BRIDGES=true; shift ;;
+        --global)        GLOBAL=true; SKIP_SYNC=true; shift ;;
+        --scope)         SCOPE="$2"; shift 2 ;;
+        --scope=*)       SCOPE="${1#*=}"; shift ;;
+        --custom-path)   CUSTOM_PATH="$2"; shift 2 ;;
+        --custom-path=*) CUSTOM_PATH="${1#*=}"; shift ;;
         --help|-h)       show_help; exit 0 ;;
         *)               err "Unknown argument: $1"; show_help >&2; exit 1 ;;
     esac
@@ -138,7 +168,7 @@ fi
 # Otherwise we fall through to the backward-compatible "all" default.
 prompt_tools() {
     local choice picked tool i=0
-    local -a menu=(claude-code claude-desktop cursor windsurf cline gemini-cli copilot augment aider codex)
+    local -a menu=(claude-code claude-desktop cursor windsurf cline gemini-cli copilot augment aider codex roocode continue kilocode zed jetbrains kiro)
     echo ""
     echo "  📦 Pick the tools to install (comma-separated numbers, blank = all):"
     for tool in "${menu[@]}"; do
@@ -263,6 +293,9 @@ run_bridges() {
     [[ -n "$PROFILE" ]] && args+=(--profile="$PROFILE")
     $FORCE && args+=(--force)
     $QUIET && args+=(--quiet)
+    $GLOBAL && args+=(--global)
+    [[ -n "$SCOPE" ]] && args+=(--scope="$SCOPE")
+    [[ -n "$CUSTOM_PATH" ]] && args+=(--custom-path="$CUSTOM_PATH")
     args+=(--tools="$TOOLS")
     "$python_bin" "$INSTALL_PY" "${args[@]}"
 }