Document Control-Plane Commands in README

Claude Code·gtrrz-victor·2mo ago·1hr 22min·2 Checkpoints·2 file changes·+8/-4·38.7K tokens

Tell me what is this branch about

2mo ago·24.3s

Branch promotes 4 control-plane command groups out of labs → make visible in root help.

Commands: org, project, repo, grant.

Changes:

  • labs.go — remove 4 groups from experimentalCommands list + --help hints.
  • root.go — flip 4 groups from Hidden (was "hidden during maturation") to visible.
  • org/project/repo.go — unhide command (drop Hidden: true).
  • grant.go — same unhide.
  • CLAUDE.md — doc update.

Net: these graduate from experimental to first-class visible commands. One commit 1d5cc0607.

check all the documentation, to see if we are leaving behind any references to lab commands

2mo ago·50.7s

Checked all docs. No stale labs references left behind.

Verified:

  • CLAUDE.md / AGENTS.md (symlink → CLAUDE.md) — 4 commands documented as full noun groups; labs section only lists tokens: profile. ✅
  • Command help strings (org/project/repo/grant .go) — no "experimental/labs/hidden/maturation" wording. ✅
  • README.md — never mentioned these commands. ✅ (nothing to update)
  • superpowers specs/plans — mention entire repo mirror as usage, no labs framing. ✅

Only remaining hits = CHANGELOG.md — historical release entries (entire labs review, blame/why labs, etc.). Those are past-tense records, correct to leave.

Branch is documentation-consistent. Nothing to fix.

do we need to add some docs about this new commands now that they will be public ?

2mo ago·38.7s

Bottom line: strictly required — nothing. Recommended — one small README addition.

Why not much is needed:

  • entire agent-help renders live from the cobra tree — it's the documented source of truth, auto-picks up the now-visible commands. No edit needed.
  • entire <cmd> --help works; all 4 have solid Short/Long strings already.
  • CLAUDE.md already documents them as noun groups.

Where a gap exists:

  • README.md "Commands Reference" table (line 241) is the one human-facing curated list. It's a subset — already omits auth, api, dispatch, activity — so it's not exhaustive by design. But since org/project/repo/grant just became public control-plane commands, adding them keeps the table honest.

Recommendation: add 4 rows to that table. Small, matches existing style. Want me to?

Proposed rows:

CommandDescription
entire orgManage Entire organizations (create, list, get, delete)
entire projectManage Entire projects (create, list, get, delete)
entire repoManage Entire repositories (create, list, get, delete, clone, mirror, visibility)
entire grantManage access grants and org membership (org, project, repo)

Say go, I add them.

go

2mo ago·20.4s

Done. 4 rows added after entire login (control-plane cluster, logical spot).

Doc-only change. No code, no tests affected. Want me to mise run fmt && mise run lint? — README-only, so skippable, but say word if you want the commit.

ship it

2mo ago·13.2s

Base directory for this skill: /Users/gtrrz-victor/.claude/skills/ship

Ship Changes

Commit current changes, push to remote, and update the PR.

Step 1: Analyze changes

  1. Run git diff --stat and git diff to understand what changed
  2. Run git status to see untracked files
  3. Run git log --oneline -3 to match the repo's commit message style

Step 2: Commit

  1. Stage only the relevant changed/untracked files by name (never git add -A or git add .)
  2. Write a concise commit message that focuses on the "why" not the "what"
    • If `` is provided, use it as the commit message
    • Otherwise, draft one from the diff
  3. Commit. If hooks fail, diagnose and fix — do NOT use --no-verify

Step 3: Push

  1. Check if the branch tracks a remote: git rev-parse --abbrev-ref --symbolic-full-name @{u}
  2. If not tracking, push with -u origin <branch>
  3. If tracking, just git push
  4. If push is rejected (remote has new commits), pull with rebase first then push

Step 4: Update PR

  1. Find the open PR for the current branch: gh pr view --json number,body,title
  2. If no PR exists, skip this step and inform the user
  3. Compare the current PR body against the new changes:
    • If the changes are within the existing PR scope, update the description to reflect the current state
    • If the changes are additive or a follow-up, add a PR comment summarizing what was just pushed instead
  4. When updating the PR body, preserve the overall structure but refresh the summary bullets and test plan
  5. When adding a comment, keep it concise — bullet points of what changed and why
  6. Before making any PR update (description edit or comment), show the user the exact text you plan to post and ask for their approval. Do NOT post until they confirm.

Rules

  • Never commit files that look like secrets (.env, credentials, tokens)
  • Never force push
  • Always show the user what was committed and the PR URL when done
2mo ago·41.1s

README change is within the PR's existing scope (docs for promoted commands). Proposed: tweak one bullet in the Changes section to mention the README. Exact edit:

Current bullet:

  • Docs & comments: updated the registration comments in root.go and documented the four groups in the CLAUDE.md / AGENTS.md command-layout section.

New bullet:

  • Docs & comments: updated the registration comments in root.go, documented the four groups in the CLAUDE.md / AGENTS.md command-layout section, and added them to the README Commands Reference table.

Rest of the body unchanged. Post this update?

y

2mo ago·26.7s

Shipped.

  • Commit 685e24bbe — "Document promoted control-plane commands in README"
  • Pushed → soph/promote-control-plane-commands-out-of-labs
  • PR #1672 description updated (Docs bullet now names README)
  • URL: https://github.com/entireio/cli/pull/1672

Doc-only. No force push. No secrets.

review PR copilot feedback

2mo ago·2m

Both Copilot comments handled.

Comment 1 — root.go (valid): Fixed in c6eb4a09f. Moved the 4 AddCommand calls into the Noun-groups block — they're noun groups, not standalone verbs. Replied.

Comment 2 — CLAUDE.md/AGENTS.md (wrong): Copilot missed the symlink. AGENTS.md -> CLAUDE.md, so editing CLAUDE.md updates both; PR desc is accurate. Replied explaining, no change.

Pushed. Build passes. lint:go has a pre-existing v1/v2 golangci-lint toolchain mismatch on your machine (not from this diff) — worth a separate fix if CI hits it, but CI likely runs the v2 binary.