@mutmutco/cli 2.67.0 → 3.0.0

package/README.md

@@ -1,10 +1,10 @@
 # @mutmutco/cli
 
-The command-line engine for MMI Future org tooling. It delivers the org spine, reads and claims GitHub Project work, and exposes the model-agnostic commands used by the MMI plugin and non-Claude agents.
+The command-line engine for MMI Future org tooling. It delivers the org-managed `.gitignore` block, reads and claims GitHub Project work, and exposes the model-agnostic commands used by the MMI plugin and non-Claude agents. (Personal agent guides — `AGENTS.md` / `CLAUDE.md` — are developer-owned and gitignored; the CLI does not deliver, overwrite, or fan them out — the whole-spine fanout is retired.)
 
 This package is published from [mutmutco/MMI-Hub](https://github.com/mutmutco/MMI-Hub) and its version matches the MMI Hub Claude Code, Codex, Cursor, and OpenCode distribution versions (the release train bumps all of them in lockstep).
 
-The CLI carries the org **Hub endpoint** intrinsically (override with the `MMI_HUB_URL` env var), so a product repo needs **no committed `.mmi/config.json`** to reach the Hub — board coords, deploy coordinates, OAuth, and the secrets layout are all discovered from the Hub registry at runtime.
+The CLI carries the org **Hub endpoint** intrinsically (override with the `MMI_HUB_URL` env var), so a product repo needs **no committed control-plane config** to reach the Hub — board coords, deploy coordinates, OAuth, and the secrets layout are all discovered from the Hub registry at runtime.
 
 ## Install
 
@@ -27,20 +27,8 @@ mmi-cli doctor --json
 
 ## Main Commands
 
-- `mmi-cli rules sync` delivers the org-owned `AGENTS.md`, `CLAUDE.md`, and Claude settings files.
-- `mmi-cli docs sync` refreshes repo-owned `README.md` and `architecture.md` without clobbering dirty files.
-- `mmi-cli handoff open|list|accept|cancel|decline` records explicit same-login, same-repo session handoffs bound to North Star slugs; SessionStart offers open handoffs alongside saga HEAD.
-- `mmi-cli coop open|start|invite|join|say|wait|pending|deliver|end|watch` drives cross-repo agent coordination (#1920); `open` lists Hub open sessions by human categories, `start` accepts topic/target metadata and returns a session code, `invite` posts a visible invite with optional Slack DM, and `wait` uses the bounded `1m`, `2m`, `3m`, `5m`, `10m`, `30m` schedule.
-- `mmi-cli overlord [--3|--4|--5|--6] <task>`, `overlord status`, `overlord send <target> <message>`, and `overlord stop` coordinate the multi-Fugu Overlord workflow with one Ultra servant, explicit servant-count bounds, OpenCode/Fugu setup preflight, native shell/profile checks, session-backed mailbox redirects, JSON event journals, and exact-owned stop safety.
-- `mmi-cli northstar push|pull|list|status|sync|delete|graduate` manages North Star, the per-user plan/SSOT store.
-  `northstar push` accepts `--body-file <path|->` to write and push in one step (or push an existing
-  `plans/<slug>.md`). It is async by default — it queues a durable background push and prints a "queued" line,
-  which is the expected success path. `northstar pull`/`show` auto-resolve a unique cross-project slug when
-  manual `list` shows plans from other repos. `northstar status` shows pending/conflicted pushes; `northstar sync`
-  (or `push --wait`) gives durable server confirmation. Never treat a queued push as failure.
-  `northstar graduate <slug> --merged-pr <url-or-number> --org-visible` marks a built-and-merged plan for
-  KB curation without echoing the plan body.
-  `mmi-cli plan` remains a compatibility alias.
+- `mmi-cli rules gitignore [--write]` verifies (or heals) this repo's org-managed `.gitignore` block. The retired `rules sync` no longer exists — personal agent guides (`AGENTS.md` / `CLAUDE.md`) are developer-owned and gitignored, never org-delivered.
+- `mmi-cli bootstrap org-ruleset` drift-checks the codified org no-agent-files push ruleset (`mmi-no-agent-files-org`) against the live org config; read-only, never mutates.
 - `mmi-cli secrets where|list|get|set|edit|rm|use|grant|revoke` manages two-tier project/org secrets without logging values; `where` prints the vault layout + well-known keys, and values move over TLS in the request body — never an argument.
 - `mmi-cli project list|get|resolve|doctor|heal|readiness|set` reads and repairs Hub-owned v2 readiness state. `doctor --json` diagnoses central deploy/secrets readiness, `heal --apply` fixes only registry-owned defaults, and `readiness --update-issue` updates the repo's v2 readiness issue; `set` is master-only and supports explicit field unsets.
 - `mmi-cli registry org` reads org-level constants from the registry (`ORG#config`).
@@ -59,7 +47,7 @@ mmi-cli doctor --json
 
 Hub API calls do not send the raw GitHub token on every request. The CLI exchanges it at `/auth/session`
 for a Hub-issued session credential, caches that credential outside repo-tracked files, and uses it for
-saga, North Star, registry, secrets, train-authority, and tenant-control calls until it nears expiry.
+registry, secrets, train-authority, and tenant-control calls until it nears expiry.
 The cache is bound to the current local GitHub token fingerprint, so switching `gh auth` users forces a
 new Hub session instead of reusing the previous user's bearer credential.