@mutmutco/cli 0.11.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +23 -7
  2. package/dist/index.cjs +1024 -128
  3. package/package.json +2 -2
package/README.md CHANGED
@@ -2,7 +2,9 @@
2
2
 
3
3
  The command-line engine for MMI Future org tooling. It delivers the org spine, reads and claims GitHub Project work, records saga continuity notes, and exposes the model-agnostic commands used by the MMI plugin and non-Claude agents.
4
4
 
5
- This package is published from [mutmutco/MMI-Hub](https://github.com/mutmutco/MMI-Hub) and its version matches the MMI Hub plugin version.
5
+ This package is published from [mutmutco/MMI-Hub](https://github.com/mutmutco/MMI-Hub) and its version matches the MMI Hub Claude Code and Codex plugin versions (the release train bumps all of them in lockstep).
6
+
7
+ 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.
6
8
 
7
9
  ## Install
8
10
 
@@ -25,12 +27,26 @@ mmi-cli doctor --json
25
27
 
26
28
  ## Main Commands
27
29
 
28
- - `mmi-cli doctor` checks GitHub auth, repo config, CLI availability, and stale plugin/cache state.
29
- - `mmi-cli board read` lists assigned and claimable GitHub Project work.
30
- - `mmi-cli board claim <owner/repo#number>` claims one issue by moving its Project status to `In Progress`.
31
- - `mmi-cli issue create` creates typed, prioritized GitHub issues and queues related-issue discovery.
32
- - `mmi-cli saga note`, `mmi-cli saga show`, and `mmi-cli saga health` write and inspect session continuity.
33
30
  - `mmi-cli rules sync` delivers the org-owned `AGENTS.md`, `CLAUDE.md`, and Claude settings files.
31
+ - `mmi-cli docs sync` refreshes repo-owned `README.md` and `architecture.md` without clobbering dirty files.
32
+ - `mmi-cli saga note`, `saga show`, `saga health`, `saga session`, `saga capture`, and `saga head-update` write and inspect session continuity.
33
+ - `mmi-cli kb get` and `kb list` read the MM KB source (`kb list [prefix]` lists document paths, optionally under a prefix).
34
+ - `mmi-cli northstar push|pull|list|delete|graduate` manages North Star, the per-user plan/SSOT store.
35
+ `northstar graduate <slug> --merged-pr <url-or-number> --org-visible` marks a built-and-merged plan for
36
+ KB curation without echoing the plan body.
37
+ `mmi-cli plan` remains a compatibility alias.
38
+ - `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.
39
+ - `mmi-cli project list|get|resolve|set` reads the DDB org registry — a project's identity + board coords + deploy coordinates (`resolve` reads deploy coords, which are OIDC-gated; `set` is master-only).
40
+ - `mmi-cli registry org` reads org-level constants from the registry (`ORG#config`).
41
+ - `mmi-cli oauth plan|verify` prints a repo's canonical Google OAuth URI set (read from the registry) and verifies the client is port-agnostic.
42
+ - `mmi-cli issue create` creates typed, prioritized GitHub issues (priority sets the board field, not a label) and queues related-issue discovery.
43
+ - `mmi-cli pr create` and `pr merge` create PRs and land them with branch/worktree cleanup; `mmi-cli gc` dry-runs cleanup of merged/closed PR branches + stale tracking refs.
44
+ - `mmi-cli board read|claim|show|move|done|backfill-priority` reads and moves GitHub Project work.
45
+ - `mmi-cli stage`, `stage start`, `stage stop`, `stage run`, and `port-range <repo>` manage the local gitignored stage and its port block; `stage-live` explains that remote rc/live move only via `/rcand` · `/release` · `/hotfix`.
46
+ - `mmi-cli rc`, `release`, and `hotfix` render guarded train plans; the train triggers the Hub's central tenant deployer, so product repos carry no deploy file.
47
+ - `mmi-cli bootstrap`, `bootstrap verify`, and `bootstrap apply` plan, audit, and seed repo onboarding.
48
+ - `mmi-cli access audit` checks collaborator roles and train-branch allowlists.
49
+ - `mmi-cli doctor` checks GitHub auth, repo config, CLI availability, the per-project plugin install record, and stale plugin/cache state, auto-repairing the safe gaps.
34
50
 
35
51
  Run `mmi-cli --help` or `mmi-cli <command> --help` for the full command reference.
36
52
 
@@ -43,4 +59,4 @@ node cli/dist/index.cjs --version
43
59
  node cli/dist/index.cjs doctor --json
44
60
  ```
45
61
 
46
- The Claude plugin also ships its own `bin/mmi-cli` launcher, so plugin-enabled Bash sessions can use the bundled command even without a global npm install.
62
+ The Claude Code plugin also ships its own `bin/mmi-cli` launcher, so plugin-enabled Bash sessions can use the bundled command even without a global npm install. Codex and other non-Claude surfaces use the standalone npm package or this repo-local fallback.