Promote org/project/repo/grant out of labs

1d5cc06→main·

Soph·1w ago·7 files·+28 added/-52 removed

Make the control-plane command groups visible in root help instead of
only discoverable via entire labs:

• Drop Hidden: true from the org, project, repo, and grant groups and
  update their doc comments (no more "surfaced via labs").
• Remove the four entries (and their --help lines) from the labs
  experimental-command registry.
• Update root.go registration comments and the CLAUDE.md command layout.

Co-Authored-By: Claude Opus 4.8 (1M context) noreply@anthropic.com

Sessions

01KWYYS6SP7XS2Q16REZ5TKP4VView transcript

Changes

7

• MCLAUDE.md+8/-1

• cmd/entire/cli

• Mgrant.go+4/-5

• Mlabs.go-24

• Morg.go+4/-6

• Mproject.go+4/-6

• Mrepo.go+4/-6

• Mroot.go+4/-4

Command Layout

The visible CLI is organized around five noun groups plus a small set of
top-level verbs. The groups are the canonical home for each verb; legacy
top-level shortcuts remain functional but hidden, and emit a deprecation hint
pointing at the canonical group form. Newer experimental command families are

• --everywhere (revoke every session on the active core, not just the
  current one) and --all-contexts (log out of every saved login)
• doctor: bare runs the scan-and-fix flow, plus trace, logs, bundle
• org: control-plane organization management — create, list, get, delete
• project: control-plane project management — create, list, get, delete
• repo: control-plane repository lifecycle — create, list, get, delete,
  clone, plus the mirror and visibility subtrees. Git content operations
  (log, diff, …) are intentionally out of scope.
• grant: manage access grants and org membership — org, project, and repo
  each support add / list / remove

Experimental command families advertised through entire labs:

MCLAUDE.md+8/-1

// newGrantCmd is the `entire grant` command group: manage access
// grants and org membership on the Entire control plane. Org, project, and
// repo each support add / list / remove.
func newGrantCmd() *cobra.Command {
    cmd := &cobra.Command{
        Use:    "grant",
        Short:  "Manage Entire access grants and org membership",
        Hidden: true,
    }
    addControlPlaneFlags(cmd)
    cmd.AddCommand(newGrantOrgCmd())
}

// newOrgCmd is the `entire org` command group: create, list, get, and
// delete organizations on the Entire control plane.
func newOrgCmd() *cobra.Command {
    cmd := &cobra.Command{
        Use:    "org",
        Short:  "Manage Entire organizations",
        Hidden: true,
    }
    addControlPlaneFlags(cmd)
    cmd.AddCommand(newOrgCreateCmd())
}

// newProjectCmd is the `entire project` command group: create, list,
// get, and delete projects on the Entire control plane.
func newProjectCmd() *cobra.Command {
    cmd := &cobra.Command{
        Use:    "project",
        Short:  "Manage Entire projects",
        Hidden: true,
    }
    addControlPlaneFlags(cmd)
    cmd.AddCommand(newProjectCreateCmd())
}

// newRepoCmd is the `entire repo` command group: control-plane
// repository lifecycle (create, list within a project, get, delete), the
// `mirror` and `visibility` subtrees, plus the `clone` convenience that
// resolves a mirror and shells out to `git clone`.
func newRepoCmd() *cobra.Command {
    cmd := &cobra.Command{
        Use:    "repo",
        Short:  "Manage Entire repositories",
        Hidden: true,
    }
    addControlPlaneFlags(cmd)
    cmd.AddCommand(newRepoCreateCmd())
}

// Top-level lifecycle and standalone commands.
cmd.AddCommand(cliReview.NewCommand(buildReviewDeps()))        // `review`; hidden during maturation
cmd.AddCommand(investigate.NewCommand(buildInvestigateDeps())) // hidden during maturation; runs a multi-agent investigation
cmd.AddCommand(newOrgCmd())                                    // hidden during maturation; control-plane org management
cmd.AddCommand(newProjectCmd())                                // hidden during maturation; control-plane project management
cmd.AddCommand(newRepoCmd())                                   // hidden during maturation; control-plane repo lifecycle
cmd.AddCommand(newGrantCmd())                                  // hidden during maturation; control-plane access grants