@@ -21,7 +21,7 @@ import {
   type ReferenceDocument,
 } from '#sim-cli/contract/reference'
 import { V2_OPERATIONS, type V2OperationName } from '#sim-cli/generated/v2-api'
-import { buildProgram } from '#sim-cli/program'
+import { buildProgram, UNPUBLISHED_GROUPS } from '#sim-cli/program'
 import { calledOperations, operationOf } from '#sim-cli/runtime/called-operations'
 import { camel } from '#sim-cli/runtime/derive'
 import { cursorSlot, flagNameFor } from '#sim-cli/runtime/request'
@@ -58,20 +58,25 @@ interface InventoryCommand extends CommandReference {
    * Absent when every call is admitted or the command calls no known operation.
    */
   mothershipUnavailable?: true
+  /** In a group hidden from `--help` until launch; the worker exposes it only when Sim enables it. */
+  unpublished?: true
 }
 
 function isHiddenCommand(command: Command): boolean {
   return (command as Command & { _hidden?: boolean })._hidden === true
 }
 
-function subcommands(command: Command): Command[] {
+/** Hidden commands stay out, except a whole top-level group that is only unpublished until launch. */
+function subcommands(command: Command, atRoot: boolean): Command[] {
   return command.commands.filter(
-    (child) => child.name() !== HELP_COMMAND && !isHiddenCommand(child)
+    (child) =>
+      child.name() !== HELP_COMMAND &&
+      (!isHiddenCommand(child) || (atRoot && UNPUBLISHED_GROUPS.has(child.name())))
   )
 }
 
 function collectLeaves(command: Command, prefix: string[]): { path: string[]; command: Command }[] {
-  const children = subcommands(command)
+  const children = subcommands(command, prefix.length === 0)
   if (children.length === 0) return [{ path: prefix, command }]
   return children.flatMap((child) => collectLeaves(child, [...prefix, child.name()]))
 }
@@ -150,6 +155,7 @@ const inventory: InventoryCommand[] = collectLeaves(program, []).map(
       options,
       ...reference,
       ...(mothershipRefuses(called) ? { mothershipUnavailable: true as const } : {}),
+      ...(UNPUBLISHED_GROUPS.has(cmdPath[0] ?? '') ? { unpublished: true as const } : {}),
     }
   }
 )
 
@@ -8,6 +8,7 @@ import {
 } from '#sim-cli/contract/reference'
 import { runEmbeddedCli } from '#sim-cli/embed'
 import { V2_OPERATIONS } from '#sim-cli/generated/v2-api'
+import { buildProgram, UNPUBLISHED_GROUPS } from '#sim-cli/program'
 import { cursorSlot } from '#sim-cli/runtime/request'
 
 const ROOT = fileURLToPath(new URL('../../../../', import.meta.url))
@@ -17,6 +18,7 @@ interface InventoryEntry {
   shape?: string
   body?: string
   mothershipUnavailable?: true
+  unpublished?: true
 }
 
 let produced: InventoryEntry[] | undefined
@@ -47,6 +49,19 @@ function document(schema: ReferenceSchema): ReferenceDocument {
 const operation = { method: 'POST', path: '/items/[id]' }
 
 describe('CLI reference producer', () => {
+  it('lists unpublished groups for the worker, marked, while --help keeps hiding them', () => {
+    const commands = inventory()
+    for (const group of UNPUBLISHED_GROUPS) {
+      const members = commands.filter((entry) => entry.path[0] === group)
+      expect(members.length).toBeGreaterThan(0)
+      expect(members.every((entry) => entry.unpublished === true)).toBe(true)
+      expect(buildProgram().helpInformation()).not.toMatch(new RegExp(`^\\s+${group}\\b`, 'm'))
+    }
+    expect(
+      commands.filter((entry) => entry.unpublished && !UNPUBLISHED_GROUPS.has(entry.path[0] ?? ''))
+    ).toEqual([])
+  })
+
   it('publishes creation ids and preserves single/batch row choices from the real API', () => {
     const commands = inventory()
     const find = (path: string) => {
 
@@ -62,8 +62,12 @@ best match rather than repeating similar searches, then run
 === END AGENT COMMAND DISCOVERY ===
 `
 
-/** Executable but unpublished until launch, so kept out of `--help` and `sim cli` search. */
-const UNPUBLISHED_GROUPS: ReadonlySet<string> = new Set(['projects'])
+/**
+ * Executable but unpublished until launch, so kept out of `--help` and `sim cli` search. The
+ * Mothership command inventory still lists them, marked `unpublished`, because the worker routes
+ * to them only when Sim enables the feature for a turn.
+ */
+export const UNPUBLISHED_GROUPS: ReadonlySet<string> = new Set(['projects'])
 
 /** The root's own value-taking options, which consume the token after them. */
 const ROOT_VALUE_FLAGS: ReadonlySet<string> = new Set([
Original file line number	Diff line number	Diff line change
`@@ -21,7 +21,7 @@ import {`
`21`	`21`	`type ReferenceDocument,`
`22`	`22`	`} from '#sim-cli/contract/reference'`
`23`	`23`	`import { V2_OPERATIONS, type V2OperationName } from '#sim-cli/generated/v2-api'`
`24`		`-import { buildProgram } from '#sim-cli/program'`
	`24`	`+import { buildProgram, UNPUBLISHED_GROUPS } from '#sim-cli/program'`
`25`	`25`	`import { calledOperations, operationOf } from '#sim-cli/runtime/called-operations'`
`26`	`26`	`import { camel } from '#sim-cli/runtime/derive'`
`27`	`27`	`import { cursorSlot, flagNameFor } from '#sim-cli/runtime/request'`
`@@ -58,20 +58,25 @@ interface InventoryCommand extends CommandReference {`
`58`	`58`	`* Absent when every call is admitted or the command calls no known operation.`
`59`	`59`	`*/`
`60`	`60`	`mothershipUnavailable?: true`
	`61`	+ /** In a group hidden from `--help` until launch; the worker exposes it only when Sim enables it. */
	`62`	`+ unpublished?: true`
`61`	`63`	`}`
`62`	`64`
`63`	`65`	`function isHiddenCommand(command: Command): boolean {`
`64`	`66`	`return (command as Command & { _hidden?: boolean })._hidden === true`
`65`	`67`	`}`
`66`	`68`
`67`		`-function subcommands(command: Command): Command[] {`
	`69`	`+/** Hidden commands stay out, except a whole top-level group that is only unpublished until launch. */`
	`70`	`+function subcommands(command: Command, atRoot: boolean): Command[] {`
`68`	`71`	`return command.commands.filter(`
`69`		`- (child) => child.name() !== HELP_COMMAND && !isHiddenCommand(child)`
	`72`	`+ (child) =>`
	`73`	`+ child.name() !== HELP_COMMAND &&`
	`74`	`+ (!isHiddenCommand(child) \|\| (atRoot && UNPUBLISHED_GROUPS.has(child.name())))`
`70`	`75`	`)`
`71`	`76`	`}`
`72`	`77`
`73`	`78`	`function collectLeaves(command: Command, prefix: string[]): { path: string[]; command: Command }[] {`
`74`		`- const children = subcommands(command)`
	`79`	`+ const children = subcommands(command, prefix.length === 0)`
`75`	`80`	`if (children.length === 0) return [{ path: prefix, command }]`
`76`	`81`	`return children.flatMap((child) => collectLeaves(child, [...prefix, child.name()]))`
`77`	`82`	`}`
`@@ -150,6 +155,7 @@ const inventory: InventoryCommand[] = collectLeaves(program, []).map(`
`150`	`155`	`options,`
`151`	`156`	`...reference,`
`152`	`157`	`...(mothershipRefuses(called) ? { mothershipUnavailable: true as const } : {}),`
	`158`	`+ ...(UNPUBLISHED_GROUPS.has(cmdPath[0] ?? '') ? { unpublished: true as const } : {}),`
`153`	`159`	`}`
`154`	`160`	`}`
`155`	`161`	`)`