@margay/ccl-core 1.5.1-alpha.5 → 1.5.1-alpha.7

package/QUICKSTART.md

@@ -7,13 +7,15 @@ from an npm package or source checkout. For the full feature map, see [README.md
 ## 1. Install
 
 ```bash
-npm install -g @margay/ccl-core
-margay --version
-# Prints the installed version; npm uses the published default tag.
+npm install -g @margay/ccl-core@1.5.1-alpha.6
+ccl --version
+# Expected: 1.5.1-alpha.6 (CCL); the latest tag is unchanged.
 ```
 
-Starting with `1.4.5-rc.10`, the package registers both `ccl` and `margay` for the
-same CLI. The `1.4.5-rc.9` package registers only `margay`.
+Starting with `1.5.1-alpha.6`, this package provides only `ccl`. Upgrade older
+dual-entry CCL packages before installing the independent `@margay/cli`, which
+will provide `margay` on the 1.8 cleanhouse line. Existing CCL scripts should use
+`ccl`; old documentation using the former alias refers to that same CCL command.
 See [CLI installation and upgrades](docs/cli-installation.md) for local
 versus global installation and migration of older launchers.
 
@@ -27,7 +29,7 @@ node dist/cli.js --version
 
 ## Local analytics on the upgraded workstation
 
-Use `margay analytics status` to inspect collection and `margay analytics gate status` to inspect the analysis feature. Collection starts disabled and requires an authorized local website account to upload; installing this build does not change your login or connect production events. See [viewing events and controlling switches](docs/local-analytics-quickstart.md).
+Use `ccl analytics status` to inspect collection and `ccl analytics gate status` to inspect the analysis feature. Collection starts disabled and requires an authorized local website account to upload; installing this build does not change your login or connect production events. See [viewing events and controlling switches](docs/local-analytics-quickstart.md).
 
 ## 2. Choose Authentication
 
@@ -66,7 +68,7 @@ saved session. To sign out from a shell, use `node dist/cli.js logout`.
 These existing TUI paths remain available:
 
 ```text
-margay
+ccl
 /gateway login <GATEWAY_URL> <GATEWAY_TOKEN>
 /gateway register <GATEWAY_URL> <INVITE_CODE> [username] [email] [phone]
 /gateway register --invite <INVITE_CODE>
@@ -87,7 +89,7 @@ status meanings, storage prerequisites, and troubleshooting.
 ### Interactive account login
 
 ```text
-margay
+ccl
 /login
 ```
 
@@ -99,7 +101,7 @@ may still be used by compatible channels, but are not created by this command.
 
 ```bash
 export ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY>
-margay --model "<available-model-id>"
+ccl --model "<available-model-id>"
 ```
 
 Do not paste real keys into docs, shell history examples, bug reports, or shared
@@ -110,23 +112,23 @@ screenshots.
 Interactive:
 
 ```bash
-margay
-margay --model deepseek-v4-pro
-margay --cwd /path/to/project
+ccl
+ccl --model deepseek-v4-pro
+ccl --cwd /path/to/project
 ```
 
 One-shot:
 
 ```bash
-margay -p "explain this error" < error.log
-margay -p "summarize the current repository" --max-turns 20
-margay -p "return JSON" --output-format json
+ccl -p "explain this error" < error.log
+ccl -p "summarize the current repository" --max-turns 20
+ccl -p "return JSON" --output-format json
 ```
 
 Streaming automation:
 
 ```bash
-margay -p "run a compact audit" --output-format stream-json --verbose
+ccl -p "run a compact audit" --output-format stream-json --verbose
 ```
 
 ## 4. Useful First Slash Commands
@@ -155,13 +157,13 @@ Run slash commands inside the interactive TUI.
 ## 5. Common CLI Options
 
 ```bash
-margay --help
-margay -p "task" --model "<available-model-id>" --effort high
-margay -p "task" --allowedTools "Bash(git:*) Edit"
-margay -p "task" --disallowedTools "Bash(rm:*)"
-margay --bare -p "minimal startup task"
-margay --resume <SESSION_ID>
-margay --continue
+ccl --help
+ccl -p "task" --model "<available-model-id>" --effort high
+ccl -p "task" --allowedTools "Bash(git:*) Edit"
+ccl -p "task" --disallowedTools "Bash(rm:*)"
+ccl --bare -p "minimal startup task"
+ccl --resume <SESSION_ID>
+ccl --continue
 ```
 
 Important safety options:
@@ -176,10 +178,10 @@ Important safety options:
 ## 6. Workflows
 
 ```bash
-margay workflow validate <name-or-path>
-margay workflow run <name-or-path> --json
-margay workflow run <name-or-path> --dry-run
-margay workflow generate "produce a release audit workflow"
+ccl workflow validate <name-or-path>
+ccl workflow run <name-or-path> --json
+ccl workflow run <name-or-path> --dry-run
+ccl workflow generate "produce a release audit workflow"
 ```
 
 Inside CCL:

package/README.md

@@ -18,7 +18,7 @@ The analytics commands support opt-in event upload, funnel/retention/path/experi
 
 ## Requirements
 
-- Node.js 20 or newer.
+- Node.js 22.19.0 or newer.
 - At least one authentication path:
   - Margay website account or gateway token for gateway-routed models.
   - Existing external-service OAuth credentials for compatible subscription-backed channels; `/login` signs in to Margay.
@@ -27,14 +27,16 @@ The analytics commands support opt-in event upload, funnel/retention/path/experi
 ## Install
 
 ```bash
-npm install -g @margay/ccl-core
-margay --version
-# Prints the installed version; npm uses the published default tag.
+npm install -g @margay/ccl-core@1.5.1-alpha.6
+ccl --version
+# Expected: 1.5.1-alpha.6 (CCL); the latest tag is unchanged.
 ```
 
-Starting with `1.4.5-rc.10`, the package registers both `ccl` and `margay` for the
-same CLI. The `1.4.5-rc.9` package registers only `margay`.
-For installation scope, dual-entry verification and old
+Starting with `1.5.1-alpha.6`, this package provides only `ccl`. Upgrade older
+dual-entry CCL packages before installing the independent `@margay/cli`, which
+will provide `margay` on the 1.8 cleanhouse line. Existing CCL scripts should use
+`ccl`; old documentation using the former alias refers to that same CCL command.
+For installation scope, command ownership and old
 launcher migration, see [CLI installation and upgrades](docs/cli-installation.md).
 
 From a source checkout:
@@ -48,18 +50,18 @@ node dist/cli.js --version
 ## Start A Session
 
 ```bash
-margay
-margay "review the current git diff"
-margay --model deepseek-v4-pro
-margay --cwd /path/to/project
+ccl
+ccl "review the current git diff"
+ccl --model deepseek-v4-pro
+ccl --cwd /path/to/project
 ```
 
 Use `--print` for scripts and pipelines:
 
 ```bash
-margay -p "explain this stack trace" < error.log
-margay -p "return JSON only" --output-format json
-margay -p "stream events" --output-format stream-json --verbose
+ccl -p "explain this stack trace" < error.log
+ccl -p "return JSON only" --output-format json
+ccl -p "stream events" --output-format stream-json --verbose
 ```
 
 ## Authentication
@@ -69,7 +71,7 @@ configuration.
 
 | Channel | Use For | Setup |
 |---|---|---|
-| Margay website account | Shared Margay identity and gateway-routed models | `margay login`, or `/login` / `/gateway login` in the TUI |
+| Margay website account | Shared Margay identity and gateway-routed models | `ccl login`, or `/login` / `/gateway login` in the TUI |
 | Manual Margay gateway | Existing gateway tokens or invite codes | `/gateway login <url> <token>` or `/gateway register <url> <invite>` |
 | Existing external-service OAuth credentials | Compatible external-service channels | Legacy credential compatibility; `/login` and first-launch onboarding use Margay website authorization |
 | Messages API key | Direct API use | Set `ANTHROPIC_API_KEY=<key>` or pass `--api-key <key>` |
@@ -126,7 +128,7 @@ recovery, see [docs/gateway-quickstart.md](./docs/gateway-quickstart.md).
 
 ## CLI Surface
 
-`margay --help` is the exact runtime source for command-line behavior. The current
+`ccl --help` is the exact runtime source for command-line behavior. The current
 top-level commands are:
 
 | Command | Purpose |
@@ -242,8 +244,8 @@ Useful controls:
 For one-off runs:
 
 ```bash
-margay -p "summarize this diff" --model "<available-model-id>"
-margay -p "generate a migration plan" --model "<available-model-id>" --effort high
+ccl -p "summarize this diff" --model "<available-model-id>"
+ccl -p "generate a migration plan" --model "<available-model-id>" --effort high
 ```
 
 Capability pools use explicit `cost-first ranking` and `quality-first ranking`
@@ -266,11 +268,11 @@ The `workflow` command and `/workflows` slash command run multi-step task
 automation.
 
 ```bash
-margay workflow run <name-or-path>
-margay workflow run <name-or-path> --params '{"out":"report.md"}' --json
-margay workflow run <name-or-path> --dry-run
-margay workflow validate <name-or-path>
-margay workflow generate "create a regression audit workflow"
+ccl workflow run <name-or-path>
+ccl workflow run <name-or-path> --params '{"out":"report.md"}' --json
+ccl workflow run <name-or-path> --dry-run
+ccl workflow validate <name-or-path>
+ccl workflow generate "create a regression audit workflow"
 ```
 
 Inside the TUI:
@@ -369,12 +371,12 @@ Config locations:
 
 | Symptom | Check |
 |---|---|
-| `margay` cannot authenticate | Run `/doctor`, `/gateway doctor`, or `/login` |
+| `ccl` cannot authenticate | Run `/doctor`, `/gateway doctor`, or `/login` |
 | Gateway status differs between shells | Check exported `CCL_GATEWAY_URL` and `CCL_GATEWAY_KEY` versus `~/.ccl/gateway.json` |
 | A model name fails | Run `/model` or query the gateway's model list |
 | `--print` runs too long | Set `--max-turns`, `--max-budget-usd`, or `CCL_PRINT_MAX_TURNS` |
 | Tool permission prompts block automation | Use `--allowedTools`, `--disallowedTools`, `--permission-mode`, or the SDK `canUseTool` callback |
-| MCP servers behave unexpectedly | Run `margay doctor` from a trusted directory and inspect `--mcp-config` inputs |
+| MCP servers behave unexpectedly | Run `ccl doctor` from a trusted directory and inspect `--mcp-config` inputs |
 
 ## Source Of Truth
 
@@ -392,6 +394,6 @@ The current authoritative documentation set is:
 
 ### Project instructions
 
-Margay automatically loads `CCL.md`, `.ccl/CCL.md`, `CCL.local.md`, and `.ccl/rules/**/*.md`, respecting the existing scope, exclusions, and conditional rules. Project and local instructions are included by default.
+CCL automatically loads `CCL.md`, `.ccl/CCL.md`, `CCL.local.md`, and `.ccl/rules/**/*.md`, respecting the existing scope, exclusions, and conditional rules. Project and local instructions are included by default.
 
 `CLAUDE.md`, `CLAUDE.local.md`, `.ccl/CLAUDE.md`, and `.claude/rules/` are not discovered automatically, even when no CCL file exists. To share a document deliberately, import it from `CCL.md` with `@CLAUDE.md`; normal import permissions still apply. Explicit file reads and existing conversation history remain available.