holycodex 0.16.3 → 0.16.4-dev.77.1

package/README.md

@@ -7,17 +7,31 @@ inspecting, and removing HolyCodex through Codex's native plugin management.
 bunx holycodex install
 bunx holycodex doctor
 bunx holycodex remove
+bunx holycodex upgrade
 ```
 
-Use `--yes` when no interactive terminal is available. `--plan` selects native
-Root and specialist routing only. `--tier` independently selects service
-handling (`standard`, `fast`, or `fast-all`). The canonical plans are `go`,
-`plus-low`, `plus`, `plus-high`, `pro-5x`, and `pro-20x`.
+Use `--yes` when no interactive terminal is available. `--profile` selects
+native Root and specialist routing only. `--tier` independently selects
+service handling (`standard`, `fast`, or `fast-all`). The live profiles are
+`low`, `default`, and `high` (`default` is recommended). Existing serialized
+`plan` state migrates to `profile`; legacy `go` state is reported as requiring
+an explicit replacement. Legacy `plus-low`, `plus`, and `plus-high`
+configuration migrates to `low`, `default`, and `high`; removed Pro profiles
+fail with an explicit replacement requirement.
+
+Live routing uses `gpt-6-astra` for Root/session and `gpt-5.6-luna` for every
+specialist. The exact per-task effort matrix is documented in
+[BEHAVIOR.md](../../docs/BEHAVIOR.md); Sol, Terra, and Go are migration-only
+historical values.
 
 Frontend and Security are selected by default; Work and Computer Use are
 opt-in. Selected capabilities must install and verify or installation fails.
+The interactive installer accepts additional plugin IDs separated by whitespace;
+the repeatable `--add-plugin <id>` option remains available for scripts.
+`upgrade` migrates an existing installation in place; use `--dry-run` to preview
+changes without mutating it.
 Use `--json` for one validated machine-readable envelope. Human output reports
-the version, plan, tier, selected capabilities, and actionable warnings without
+the version, profile, tier, selected capabilities, and actionable warnings without
 printing the internal installation record.
 
 The development entry point is:
@@ -28,6 +42,10 @@ mise exec -- bun packages/cli/src/index.ts install --yes
 
 Command syntax and response contracts are owned by [CLI.md](../../docs/CLI.md).
 
+This package does not expose Intent or Assignment mutation. Root uses the
+separate deterministic `holycodex-agent` CLI for repo-local `.holycodex/`
+work state; it is non-interactive and has no TUI, prompts, or ANSI output.
+
 ## Contribute
 
 Use Bun through `mise`, keep changes within the assigned package seam, and run