@mysten-incubation/devstack 0.0.1 → 0.1.0

package/dist/substrate/versioned-doc-sync.mjs

@@ -0,0 +1,94 @@
+import { atomicWriteJsonSync } from "./runtime/atomic-write.mjs";
+import { decodeJsonText, decodeJsonTextSync } from "./runtime/runtime-decode.mjs";
+import { Effect } from "effect";
+import { existsSync, readFileSync } from "node:fs";
+//#region src/substrate/versioned-doc-sync.ts
+/**
+* Read + decode a versioned cross-process document from disk.
+*
+*  - Missing file (`!existsSync`) → returns the caller-supplied
+*    `whenAbsent` default. This is the "no peer has ever written yet"
+*    path; the caller decides whether that's an empty document or a
+*    failure.
+*  - Read failure (any `node:fs` error other than ENOENT) → `mkIo`.
+*  - JSON-parse OR Schema-decode failure → `mkCorrupt` with the raw
+*    bytes echoed so callers can log the offending content.
+*
+*  The decode runs through `decodeJsonText`, so the on-disk JSON is
+*  parsed and Schema-validated in one envelope. No atomicity, fsync, or
+*  lock-ordering concerns at the read site — this is pure read-and-
+*  validate.
+*/
+const readVersionedDocumentSync = (path, schema, errors, whenAbsent) => Effect.gen(function* () {
+	if (!existsSync(path)) return whenAbsent;
+	const raw = yield* Effect.try({
+		try: () => readFileSync(path, "utf8"),
+		catch: (cause) => errors.mkIo({
+			path,
+			cause
+		})
+	});
+	return yield* decodeJsonText(schema, raw, {
+		source: path,
+		mkError: (issue) => errors.mkCorrupt({
+			path,
+			raw,
+			cause: issue.cause ?? issue
+		})
+	});
+});
+/**
+* Sync parse-or-null variant of `readVersionedDocumentSync`. Decodes a
+* raw JSON body against `schema`; returns `null` on parse or decode
+* failure. Use this when a malformed body should be treated the same as
+* a missing body (e.g. half-written reservation by a crashed creator,
+* stack-lock body interrupted mid-write) — the call site swaps a
+* try/catch around `decodeJsonTextSync` for one helper call.
+*
+* `source` is purely a diagnostic label for the synthesized error
+* inside `decodeJsonTextSync`'s throw; it is consumed by the catch and
+* discarded along with the error. The caller does not need to thread a
+* typed error constructor — the contract here is "null means
+* unreadable/malformed; the caller decides what to do next".
+*/
+const parseVersionedDocumentBodyOrNull = (raw, schema, source) => {
+	try {
+		return decodeJsonTextSync(schema, raw, {
+			source,
+			mkError: (issue) => issue
+		});
+	} catch {
+		return null;
+	}
+};
+/**
+* Write a versioned cross-process document atomically.
+*
+* Routes through the canonical `atomicWriteJsonSync` primitive — the
+* NFS-safe mkdir-parent → O_EXCL temp → write → fsync → rename dance
+* with one owner of the tempfile cleanup. The version stamp lives in
+* the caller-supplied `value` (every versioned-doc schema carries a
+* literal `version` field via `versionedDocSchema`); this helper does
+* NOT inject a version — it just ensures the typed write envelope
+* (Effect.try → mkIo) is consistent across cross-process sites.
+*
+* No Schema-encode step here: matching `atomicWriteJsonSync`'s contract,
+* cross-process docs are `Schema.Struct` of primitives that round-trip
+* cleanly through plain `JSON.stringify`. The `value` is typed as a
+* generic `D` so the caller's document interface (`RosterDocument`,
+* `ContainerClaimDocument`, ...) is what gets serialized.
+*
+* This is the SYNC surface — used by callers that hold `stack.lock`
+* and must keep their critical section non-yielding.
+*/
+const writeVersionedDocumentSync = (path, value, errors) => Effect.try({
+	try: () => atomicWriteJsonSync(path, value),
+	catch: (cause) => errors.mkIo({
+		path,
+		cause
+	})
+});
+//#endregion
+export { parseVersionedDocumentBodyOrNull, readVersionedDocumentSync, writeVersionedDocumentSync };
+
+//# sourceMappingURL=versioned-doc-sync.mjs.map

package/dist/substrate/versioned-doc-sync.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioned-doc-sync.mjs","names":[],"sources":["../../src/substrate/versioned-doc-sync.ts"],"sourcesContent":["// Versioned cross-process document — read / write envelope helpers.\n//\n// Three cross-process modules (`runtime/cross-process/{roster,\n// snapshot-reservation, stack-lock}.ts`) historically re-implemented the\n// same `Effect.try(readFileSync) → decodeJsonText → mkIoError|\n// mkCorruptError` envelope and the same `Effect.try(atomicWriteJsonSync)\n// → mkIoError` envelope, each with a different typed-error pair. This\n// file centralizes both envelopes around the versioned-doc schemas\n// constructed via `versionedDocSchema` (the sibling file). The caller\n// supplies the error constructors so its typed error channel is\n// preserved end-to-end; nothing about NFS-safe atomicity, fsync\n// ordering, or version-stamp handling moves out of the underlying\n// primitives.\n//\n// Lives at substrate L0+ — depends on `effect`, `node:fs`, the\n// runtime-decode helpers, and the canonical atomic-write primitive.\n// Kept as a sibling of `versioned-doc-schema.ts` rather than absorbed\n// into it so the schema constructor remains pure-Schema (callable from\n// any L0 declaration site such as `substrate/cross-process.ts`); only\n// callers that actually round-trip a versioned doc to disk pay the\n// fs/runtime-decode import cost.\n\nimport { existsSync, readFileSync } from 'node:fs';\n\nimport { Effect, Schema } from 'effect';\n\nimport { atomicWriteJsonSync } from './runtime/atomic-write.ts';\nimport { decodeJsonText, decodeJsonTextSync } from './runtime/runtime-decode.ts';\n\n/** Constructor pair the caller supplies so its typed error channel is\n *  preserved through the envelope. `mkIo` wraps any node:fs / disk\n *  failure (read OR write); `mkCorrupt` wraps any JSON-parse / Schema-\n *  decode failure (read only). Both helpers thread the on-disk `path`\n *  and — for `mkCorrupt` — the raw bytes that failed to decode so\n *  diagnostics can echo what was actually on disk. */\nexport interface VersionedDocErrors<IoErr, CorruptErr> {\n\treadonly mkIo: (input: { readonly path: string; readonly cause: unknown }) => IoErr;\n\treadonly mkCorrupt: (input: {\n\t\treadonly path: string;\n\t\treadonly raw: string;\n\t\treadonly cause: unknown;\n\t}) => CorruptErr;\n}\n\n/** Constructor for the IO-only case (write path — no decode failure\n *  mode). Split into its own interface so `writeVersionedDocumentSync`\n *  callers don't have to supply a `mkCorrupt` they would never invoke. */\nexport interface VersionedDocIoError<IoErr> {\n\treadonly mkIo: (input: { readonly path: string; readonly cause: unknown }) => IoErr;\n}\n\n/**\n * Read + decode a versioned cross-process document from disk.\n *\n *  - Missing file (`!existsSync`) → returns the caller-supplied\n *    `whenAbsent` default. This is the \"no peer has ever written yet\"\n *    path; the caller decides whether that's an empty document or a\n *    failure.\n *  - Read failure (any `node:fs` error other than ENOENT) → `mkIo`.\n *  - JSON-parse OR Schema-decode failure → `mkCorrupt` with the raw\n *    bytes echoed so callers can log the offending content.\n *\n *  The decode runs through `decodeJsonText`, so the on-disk JSON is\n *  parsed and Schema-validated in one envelope. No atomicity, fsync, or\n *  lock-ordering concerns at the read site — this is pure read-and-\n *  validate.\n */\nexport const readVersionedDocumentSync = <\n\tS extends Schema.Decoder<unknown>,\n\tIoErr,\n\tCorruptErr,\n>(\n\tpath: string,\n\tschema: S,\n\terrors: VersionedDocErrors<IoErr, CorruptErr>,\n\twhenAbsent: S['Type'],\n): Effect.Effect<S['Type'], IoErr | CorruptErr> =>\n\tEffect.gen(function* () {\n\t\tif (!existsSync(path)) return whenAbsent;\n\t\tconst raw = yield* Effect.try({\n\t\t\ttry: () => readFileSync(path, 'utf8'),\n\t\t\tcatch: (cause) => errors.mkIo({ path, cause }),\n\t\t});\n\t\treturn yield* decodeJsonText(schema, raw, {\n\t\t\tsource: path,\n\t\t\tmkError: (issue) => errors.mkCorrupt({ path, raw, cause: issue.cause ?? issue }),\n\t\t});\n\t});\n\n/**\n * Sync parse-or-null variant of `readVersionedDocumentSync`. Decodes a\n * raw JSON body against `schema`; returns `null` on parse or decode\n * failure. Use this when a malformed body should be treated the same as\n * a missing body (e.g. half-written reservation by a crashed creator,\n * stack-lock body interrupted mid-write) — the call site swaps a\n * try/catch around `decodeJsonTextSync` for one helper call.\n *\n * `source` is purely a diagnostic label for the synthesized error\n * inside `decodeJsonTextSync`'s throw; it is consumed by the catch and\n * discarded along with the error. The caller does not need to thread a\n * typed error constructor — the contract here is \"null means\n * unreadable/malformed; the caller decides what to do next\".\n */\nexport const parseVersionedDocumentBodyOrNull = <S extends Schema.Decoder<unknown>>(\n\traw: string,\n\tschema: S,\n\tsource: string,\n): S['Type'] | null => {\n\ttry {\n\t\treturn decodeJsonTextSync(schema, raw, {\n\t\t\tsource,\n\t\t\tmkError: (issue) => issue,\n\t\t});\n\t} catch {\n\t\treturn null;\n\t}\n};\n\n/**\n * Write a versioned cross-process document atomically.\n *\n * Routes through the canonical `atomicWriteJsonSync` primitive — the\n * NFS-safe mkdir-parent → O_EXCL temp → write → fsync → rename dance\n * with one owner of the tempfile cleanup. The version stamp lives in\n * the caller-supplied `value` (every versioned-doc schema carries a\n * literal `version` field via `versionedDocSchema`); this helper does\n * NOT inject a version — it just ensures the typed write envelope\n * (Effect.try → mkIo) is consistent across cross-process sites.\n *\n * No Schema-encode step here: matching `atomicWriteJsonSync`'s contract,\n * cross-process docs are `Schema.Struct` of primitives that round-trip\n * cleanly through plain `JSON.stringify`. The `value` is typed as a\n * generic `D` so the caller's document interface (`RosterDocument`,\n * `ContainerClaimDocument`, ...) is what gets serialized.\n *\n * This is the SYNC surface — used by callers that hold `stack.lock`\n * and must keep their critical section non-yielding.\n */\nexport const writeVersionedDocumentSync = <D, IoErr>(\n\tpath: string,\n\tvalue: D,\n\terrors: VersionedDocIoError<IoErr>,\n): Effect.Effect<void, IoErr> =>\n\tEffect.try({\n\t\ttry: () => atomicWriteJsonSync(path, value),\n\t\tcatch: (cause) => errors.mkIo({ path, cause }),\n\t});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAmEA,MAAa,6BAKZ,MACA,QACA,QACA,eAEA,OAAO,IAAI,aAAa;AACvB,KAAI,CAAC,WAAW,KAAK,CAAE,QAAO;CAC9B,MAAM,MAAM,OAAO,OAAO,IAAI;EAC7B,WAAW,aAAa,MAAM,OAAO;EACrC,QAAQ,UAAU,OAAO,KAAK;GAAE;GAAM;GAAO,CAAC;EAC9C,CAAC;AACF,QAAO,OAAO,eAAe,QAAQ,KAAK;EACzC,QAAQ;EACR,UAAU,UAAU,OAAO,UAAU;GAAE;GAAM;GAAK,OAAO,MAAM,SAAS;GAAO,CAAC;EAChF,CAAC;EACD;;;;;;;;;;;;;;;AAgBH,MAAa,oCACZ,KACA,QACA,WACsB;AACtB,KAAI;AACH,SAAO,mBAAmB,QAAQ,KAAK;GACtC;GACA,UAAU,UAAU;GACpB,CAAC;SACK;AACP,SAAO;;;;;;;;;;;;;;;;;;;;;;;AAwBT,MAAa,8BACZ,MACA,OACA,WAEA,OAAO,IAAI;CACV,WAAW,oBAAoB,MAAM,MAAM;CAC3C,QAAQ,UAAU,OAAO,KAAK;EAAE;EAAM;EAAO,CAAC;CAC9C,CAAC"}

package/dist/surfaces/cli/command-tree.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"command-tree.mjs","names":[],"sources":["../../../src/surfaces/cli/command-tree.ts"],"sourcesContent":["import { ENV_VARS } from './flags.ts';\nimport { exitCodeTable } from './sysexits.ts';\n\nexport type CommandLifecycle = 'attached' | 'live-aware' | 'one-shot' | 'offline';\n\nexport interface CommandOption {\n\treadonly name: string;\n\treadonly value?: string;\n\treadonly description: string;\n}\n\nexport interface CommandNode {\n\treadonly name: string;\n\treadonly summary: string;\n\treadonly usage: string;\n\treadonly lifecycle: CommandLifecycle;\n\treadonly sideEffects: 'none' | 'read' | 'write' | 'destructive';\n\treadonly requiresDocker: boolean;\n\treadonly description?: string;\n\treadonly arguments?: ReadonlyArray<string>;\n\treadonly options?: ReadonlyArray<CommandOption>;\n\treadonly subcommands?: ReadonlyArray<CommandNode>;\n}\n\nconst identityOptions = [\n\t{ name: 'json', description: 'Emit JSON envelope output.' },\n\t{ name: 'app', value: 'name', description: 'Override app name.' },\n\t{ name: 'stack', value: 'name', description: 'Override stack name.' },\n\t{ name: 'state-dir', value: 'path', description: 'Override state directory.' },\n\t{ name: 'verbose', description: 'Enable more verbose logging.' },\n] as const satisfies ReadonlyArray<CommandOption>;\n\nconst configOptions = [\n\t...identityOptions,\n\t{ name: 'config', value: 'path', description: 'Override devstack.config.ts path.' },\n\t{ name: 'network', value: 'name', description: 'Override network before config import.' },\n] as const satisfies ReadonlyArray<CommandOption>;\n\nconst confirmOptions = [\n\t...identityOptions,\n\t{ name: 'yes', description: 'Assume yes on prompts.' },\n\t{ name: 'no-input', description: 'Forbid prompts.' },\n] as const satisfies ReadonlyArray<CommandOption>;\n\nconst globalMaintenanceOptions = [\n\t{ name: 'json', description: 'Emit JSON envelope output.' },\n\t{ name: 'state-dir', value: 'path', description: 'Override state directory.' },\n\t{ name: 'verbose', description: 'Enable more verbose logging.' },\n] as const satisfies ReadonlyArray<CommandOption>;\n\nconst commands = [\n\t{\n\t\tname: 'up',\n\t\tsummary: 'Boot a stack and stay attached until interrupted.',\n\t\tusage: 'devstack up [options]',\n\t\tlifecycle: 'attached',\n\t\tsideEffects: 'write',\n\t\trequiresDocker: true,\n\t\tdescription: 'Starts the supervisor and renders the attached operator surface.',\n\t\toptions: [\n\t\t\t...configOptions,\n\t\t\t{\n\t\t\t\tname: 'renderer',\n\t\t\t\tvalue: 'tui|plain|silent',\n\t\t\t\tdescription: 'Select the attached renderer.',\n\t\t\t},\n\t\t],\n\t},\n\t{\n\t\tname: 'apply',\n\t\tsummary: 'Reconcile through a live supervisor when present; otherwise run one-shot setup.',\n\t\tusage: 'devstack apply [options]',\n\t\tlifecycle: 'live-aware',\n\t\tsideEffects: 'write',\n\t\trequiresDocker: true,\n\t\toptions: configOptions,\n\t},\n\t{\n\t\tname: 'status',\n\t\tsummary: 'Show the persisted stack projection.',\n\t\tusage: 'devstack status [options]',\n\t\tlifecycle: 'offline',\n\t\tsideEffects: 'read',\n\t\trequiresDocker: false,\n\t\toptions: identityOptions,\n\t},\n\t{\n\t\tname: 'doctor',\n\t\tsummary: 'Run host and stack preflight checks.',\n\t\tusage: 'devstack doctor [options]',\n\t\tlifecycle: 'offline',\n\t\tsideEffects: 'read',\n\t\trequiresDocker: true,\n\t\toptions: identityOptions,\n\t},\n\t{\n\t\tname: 'config',\n\t\tsummary: 'Print resolved config inputs.',\n\t\tusage: 'devstack config [options]',\n\t\tlifecycle: 'offline',\n\t\tsideEffects: 'read',\n\t\trequiresDocker: false,\n\t\toptions: configOptions,\n\t},\n\t{\n\t\tname: 'schema',\n\t\tsummary: 'Emit the CLI schema.',\n\t\tusage: 'devstack schema --json',\n\t\tlifecycle: 'offline',\n\t\tsideEffects: 'none',\n\t\trequiresDocker: false,\n\t\toptions: [{ name: 'json', description: 'Emit JSON schema output.' }],\n\t},\n\t{\n\t\tname: 'snapshot',\n\t\tsummary: 'Capture, restore, list, or delete stack snapshots.',\n\t\tusage: 'devstack snapshot <command> [options]',\n\t\tlifecycle: 'offline',\n\t\tsideEffects: 'write',\n\t\trequiresDocker: true,\n\t\tsubcommands: [\n\t\t\t{\n\t\t\t\tname: 'save',\n\t\t\t\tsummary: 'Capture a snapshot through a one-shot stack boot.',\n\t\t\t\tusage: 'devstack snapshot save [name] [options]',\n\t\t\t\tlifecycle: 'one-shot',\n\t\t\t\tsideEffects: 'write',\n\t\t\t\trequiresDocker: true,\n\t\t\t\targuments: ['name'],\n\t\t\t\toptions: [\n\t\t\t\t\t...configOptions,\n\t\t\t\t\t{ name: 'name', value: 'name', description: 'Human-readable snapshot name.' },\n\t\t\t\t],\n\t\t\t},\n\t\t\t{\n\t\t\t\tname: 'restore',\n\t\t\t\tsummary: 'Restore a snapshot by name or id.',\n\t\t\t\tusage: 'devstack snapshot restore <name-or-id> [options]',\n\t\t\t\tlifecycle: 'offline',\n\t\t\t\tsideEffects: 'destructive',\n\t\t\t\trequiresDocker: true,\n\t\t\t\targuments: ['name-or-id'],\n\t\t\t\toptions: confirmOptions,\n\t\t\t},\n\t\t\t{\n\t\t\t\tname: 'list',\n\t\t\t\tsummary: 'List snapshots for the selected stack.',\n\t\t\t\tusage: 'devstack snapshot list [options]',\n\t\t\t\tlifecycle: 'offline',\n\t\t\t\tsideEffects: 'read',\n\t\t\t\trequiresDocker: false,\n\t\t\t\toptions: identityOptions,\n\t\t\t},\n\t\t\t{\n\t\t\t\tname: 'delete',\n\t\t\t\tsummary: 'Delete a snapshot by name or id.',\n\t\t\t\tusage: 'devstack snapshot delete <name-or-id> [options]',\n\t\t\t\tlifecycle: 'offline',\n\t\t\t\tsideEffects: 'destructive',\n\t\t\t\trequiresDocker: false,\n\t\t\t\targuments: ['name-or-id'],\n\t\t\t\toptions: confirmOptions,\n\t\t\t},\n\t\t],\n\t},\n\t{\n\t\tname: 'prune',\n\t\tsummary: 'Inventory and prune devstack-labelled Docker resources.',\n\t\tusage: 'devstack prune [--list | --dry-run | --all --yes] [options]',\n\t\tlifecycle: 'offline',\n\t\tsideEffects: 'destructive',\n\t\trequiresDocker: true,\n\t\toptions: [\n\t\t\t...globalMaintenanceOptions,\n\t\t\t{ name: 'list', description: 'List resource groups without pruning.' },\n\t\t\t{ name: 'all', description: 'Prune every idle non-shared resource group.' },\n\t\t\t{ name: 'no-containers', description: 'Do not remove containers.' },\n\t\t\t{ name: 'no-networks', description: 'Do not remove networks.' },\n\t\t\t{ name: 'no-volumes', description: 'Do not remove volumes.' },\n\t\t\t{ name: 'include-images', description: 'Also remove devstack-labelled images.' },\n\t\t\t{ name: 'dry-run', description: 'Skip mutating effects.' },\n\t\t\t{ name: 'yes', description: 'Assume yes on prompts.' },\n\t\t\t{ name: 'no-input', description: 'Forbid prompts.' },\n\t\t],\n\t},\n\t{\n\t\tname: 'wipe',\n\t\tsummary: 'Destroy all state for the selected stack.',\n\t\tusage: 'devstack wipe [--dry-run] [--yes] [options]',\n\t\tlifecycle: 'offline',\n\t\tsideEffects: 'destructive',\n\t\trequiresDocker: true,\n\t\toptions: [\n\t\t\t...identityOptions,\n\t\t\t{ name: 'dry-run', description: 'Skip mutating effects.' },\n\t\t\t{ name: 'yes', description: 'Assume yes on prompts.' },\n\t\t\t{ name: 'no-input', description: 'Forbid prompts.' },\n\t\t],\n\t},\n] as const satisfies ReadonlyArray<CommandNode>;\n\nexport const COMMAND_TREE: CommandNode = {\n\tname: 'devstack',\n\tsummary: 'Sui development stack CLI.',\n\tusage: 'devstack <command> [options]',\n\tlifecycle: 'offline',\n\tsideEffects: 'none',\n\trequiresDocker: false,\n\tdescription: 'Boot, inspect, snapshot, and manage local Sui development stacks.',\n\tsubcommands: commands,\n};\n\nexport type Verb = (typeof commands)[number]['name'];\n\nexport const VERBS: ReadonlyArray<Verb> = commands.map((command) => command.name);\n\nexport const isVerb = (value: string): value is Verb =>\n\t(VERBS as ReadonlyArray<string>).includes(value);\n\nconst findSubcommand = (node: CommandNode, name: string): CommandNode | undefined =>\n\tnode.subcommands?.find((candidate) => candidate.name === name);\n\nexport const findCommandNode = (path: ReadonlyArray<string>): CommandNode | null => {\n\tlet current: CommandNode = COMMAND_TREE;\n\tfor (const segment of path) {\n\t\tconst next = findSubcommand(current, segment);\n\t\tif (next === undefined) return null;\n\t\tcurrent = next;\n\t}\n\treturn current;\n};\n\nconst formatOption = (option: CommandOption): string =>\n\t`--${option.name}${option.value ? ` <${option.value}>` : ''}`;\n\nconst pad = (values: ReadonlyArray<string>): number =>\n\tvalues.reduce((max, value) => Math.max(max, value.length), 0);\n\nconst pushCommandRows = (\n\tlines: Array<string>,\n\ttitle: string,\n\tcommandsToRender: ReadonlyArray<CommandNode>,\n) => {\n\tif (commandsToRender.length === 0) return;\n\tconst names = commandsToRender.map((command) => command.name);\n\tconst width = pad(names);\n\tlines.push('', `${title}:`);\n\tfor (const command of commandsToRender) {\n\t\tlines.push(`  ${command.name.padEnd(width, ' ')}  ${command.summary}`);\n\t}\n};\n\nconst pushOptionRows = (\n\tlines: Array<string>,\n\ttitle: string,\n\toptions: ReadonlyArray<CommandOption>,\n) => {\n\tif (options.length === 0) return;\n\tconst rendered = options.map(formatOption);\n\tconst width = pad(rendered);\n\tlines.push('', `${title}:`);\n\tfor (let i = 0; i < options.length; i += 1) {\n\t\tlines.push(`  ${rendered[i]!.padEnd(width, ' ')}  ${options[i]!.description}`);\n\t}\n};\n\nexport const formatCommandHelp = (path: ReadonlyArray<string>): string => {\n\tconst node = findCommandNode(path) ?? COMMAND_TREE;\n\tconst lines: Array<string> = [\n\t\tpath.length === 0\n\t\t\t? 'devstack - Sui development stack CLI'\n\t\t\t: `${path.join(' ')} - ${node.summary}`,\n\t\t'',\n\t\t`Usage: ${node.usage}`,\n\t];\n\tif (node.description !== undefined) lines.push('', node.description);\n\tif (node.arguments !== undefined && node.arguments.length > 0) {\n\t\tlines.push('', `Arguments: ${node.arguments.join(', ')}`);\n\t}\n\tpushCommandRows(lines, path.length === 0 ? 'Commands' : 'Subcommands', node.subcommands ?? []);\n\tpushOptionRows(lines, 'Options', node.options ?? []);\n\treturn lines.join('\\n');\n};\n\nexport const commandSchema = () => ({\n\tschemaVersion: 1,\n\tverbs: VERBS,\n\tcommands: COMMAND_TREE,\n\texitCodes: exitCodeTable,\n\tenvVars: Object.values(ENV_VARS),\n});\n"],"mappings":"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"}
+{"version":3,"file":"command-tree.mjs","names":[],"sources":["../../../src/surfaces/cli/command-tree.ts"],"sourcesContent":["import { ENV_VARS } from './flags.ts';\nimport { exitCodeTable } from './sysexits.ts';\n\nexport type CommandLifecycle = 'attached' | 'live-aware' | 'one-shot' | 'offline';\n\nexport interface CommandOption {\n\treadonly name: string;\n\treadonly value?: string;\n\treadonly description: string;\n}\n\nexport interface CommandNode {\n\treadonly name: string;\n\treadonly summary: string;\n\treadonly usage: string;\n\treadonly lifecycle: CommandLifecycle;\n\treadonly sideEffects: 'none' | 'read' | 'write' | 'destructive';\n\treadonly requiresDocker: boolean;\n\treadonly description?: string;\n\treadonly arguments?: ReadonlyArray<string>;\n\treadonly options?: ReadonlyArray<CommandOption>;\n\treadonly subcommands?: ReadonlyArray<CommandNode>;\n}\n\nconst identityOptions = [\n\t{ name: 'json', description: 'Emit JSON envelope output.' },\n\t{ name: 'app', value: 'name', description: 'Override app name.' },\n\t{ name: 'stack', value: 'name', description: 'Override stack name.' },\n\t{ name: 'state-dir', value: 'path', description: 'Override state directory.' },\n\t{ name: 'verbose', description: 'Enable more verbose logging.' },\n] as const satisfies ReadonlyArray<CommandOption>;\n\nconst configOptions = [\n\t...identityOptions,\n\t{ name: 'config', value: 'path', description: 'Override devstack.config.ts path.' },\n\t{ name: 'network', value: 'name', description: 'Override network before config import.' },\n] as const satisfies ReadonlyArray<CommandOption>;\n\nconst confirmOptions = [\n\t...identityOptions,\n\t{ name: 'yes', description: 'Assume yes on prompts.' },\n\t{ name: 'no-input', description: 'Forbid prompts.' },\n] as const satisfies ReadonlyArray<CommandOption>;\n\nconst globalMaintenanceOptions = [\n\t{ name: 'json', description: 'Emit JSON envelope output.' },\n\t{ name: 'state-dir', value: 'path', description: 'Override state directory.' },\n\t{ name: 'verbose', description: 'Enable more verbose logging.' },\n] as const satisfies ReadonlyArray<CommandOption>;\n\nconst commands = [\n\t{\n\t\tname: 'up',\n\t\tsummary: 'Boot a stack and stay attached until interrupted.',\n\t\tusage: 'devstack up [options]',\n\t\tlifecycle: 'attached',\n\t\tsideEffects: 'write',\n\t\trequiresDocker: true,\n\t\tdescription: 'Starts the supervisor and renders the attached operator surface.',\n\t\toptions: [\n\t\t\t...configOptions,\n\t\t\t{\n\t\t\t\tname: 'renderer',\n\t\t\t\tvalue: 'tui|plain|silent',\n\t\t\t\tdescription: 'Select the attached renderer.',\n\t\t\t},\n\t\t],\n\t},\n\t{\n\t\tname: 'apply',\n\t\tsummary: 'Reconcile through a live supervisor when present; otherwise run one-shot setup.',\n\t\tusage: 'devstack apply [options]',\n\t\tlifecycle: 'live-aware',\n\t\tsideEffects: 'write',\n\t\trequiresDocker: true,\n\t\toptions: configOptions,\n\t},\n\t{\n\t\tname: 'status',\n\t\tsummary: 'Show the persisted stack projection.',\n\t\tusage: 'devstack status [options]',\n\t\tlifecycle: 'offline',\n\t\tsideEffects: 'read',\n\t\trequiresDocker: false,\n\t\toptions: identityOptions,\n\t},\n\t{\n\t\tname: 'doctor',\n\t\tsummary: 'Run host and stack preflight checks.',\n\t\tusage: 'devstack doctor [options]',\n\t\tlifecycle: 'offline',\n\t\tsideEffects: 'read',\n\t\trequiresDocker: true,\n\t\toptions: identityOptions,\n\t},\n\t{\n\t\tname: 'config',\n\t\tsummary: 'Print resolved config inputs.',\n\t\tusage: 'devstack config [options]',\n\t\tlifecycle: 'offline',\n\t\tsideEffects: 'read',\n\t\trequiresDocker: false,\n\t\toptions: configOptions,\n\t},\n\t{\n\t\tname: 'schema',\n\t\tsummary: 'Emit the CLI schema.',\n\t\tusage: 'devstack schema --json',\n\t\tlifecycle: 'offline',\n\t\tsideEffects: 'none',\n\t\trequiresDocker: false,\n\t\toptions: [{ name: 'json', description: 'Emit JSON schema output.' }],\n\t},\n\t{\n\t\tname: 'snapshot',\n\t\tsummary: 'Capture, restore, list, or delete stack snapshots.',\n\t\tusage: 'devstack snapshot <command> [options]',\n\t\tlifecycle: 'offline',\n\t\tsideEffects: 'write',\n\t\trequiresDocker: true,\n\t\tsubcommands: [\n\t\t\t{\n\t\t\t\tname: 'save',\n\t\t\t\tsummary: 'Capture a snapshot through a one-shot stack boot.',\n\t\t\t\tusage: 'devstack snapshot save [name] [options]',\n\t\t\t\tlifecycle: 'one-shot',\n\t\t\t\tsideEffects: 'write',\n\t\t\t\trequiresDocker: true,\n\t\t\t\targuments: ['name'],\n\t\t\t\toptions: [\n\t\t\t\t\t...configOptions,\n\t\t\t\t\t{ name: 'name', value: 'name', description: 'Human-readable snapshot name.' },\n\t\t\t\t],\n\t\t\t},\n\t\t\t{\n\t\t\t\tname: 'restore',\n\t\t\t\tsummary: 'Restore a snapshot by name or id.',\n\t\t\t\tusage: 'devstack snapshot restore <name-or-id> [options]',\n\t\t\t\tlifecycle: 'offline',\n\t\t\t\tsideEffects: 'destructive',\n\t\t\t\trequiresDocker: true,\n\t\t\t\targuments: ['name-or-id'],\n\t\t\t\toptions: confirmOptions,\n\t\t\t},\n\t\t\t{\n\t\t\t\tname: 'list',\n\t\t\t\tsummary: 'List snapshots for the selected stack.',\n\t\t\t\tusage: 'devstack snapshot list [options]',\n\t\t\t\tlifecycle: 'offline',\n\t\t\t\tsideEffects: 'read',\n\t\t\t\trequiresDocker: false,\n\t\t\t\toptions: identityOptions,\n\t\t\t},\n\t\t\t{\n\t\t\t\tname: 'delete',\n\t\t\t\tsummary: 'Delete a snapshot by name or id.',\n\t\t\t\tusage: 'devstack snapshot delete <name-or-id> [options]',\n\t\t\t\tlifecycle: 'offline',\n\t\t\t\tsideEffects: 'destructive',\n\t\t\t\trequiresDocker: false,\n\t\t\t\targuments: ['name-or-id'],\n\t\t\t\toptions: confirmOptions,\n\t\t\t},\n\t\t],\n\t},\n\t{\n\t\tname: 'prune',\n\t\tsummary: 'Inventory and prune devstack-labelled Docker resources.',\n\t\tusage: 'devstack prune [--list | --dry-run | --all --yes] [options]',\n\t\tlifecycle: 'offline',\n\t\tsideEffects: 'destructive',\n\t\trequiresDocker: true,\n\t\toptions: [\n\t\t\t...globalMaintenanceOptions,\n\t\t\t{ name: 'list', description: 'List resource groups without pruning.' },\n\t\t\t{ name: 'all', description: 'Prune every idle non-shared resource group.' },\n\t\t\t{ name: 'no-containers', description: 'Do not remove containers.' },\n\t\t\t{ name: 'no-networks', description: 'Do not remove networks.' },\n\t\t\t{ name: 'no-volumes', description: 'Do not remove volumes.' },\n\t\t\t{ name: 'include-images', description: 'Also remove devstack-labelled images.' },\n\t\t\t{ name: 'dry-run', description: 'Skip mutating effects.' },\n\t\t\t{ name: 'yes', description: 'Assume yes on prompts.' },\n\t\t\t{ name: 'no-input', description: 'Forbid prompts.' },\n\t\t],\n\t},\n\t{\n\t\tname: 'wipe',\n\t\tsummary: 'Destroy all state for the selected stack.',\n\t\tusage: 'devstack wipe [--dry-run] [--yes] [options]',\n\t\tlifecycle: 'offline',\n\t\tsideEffects: 'destructive',\n\t\trequiresDocker: true,\n\t\toptions: [\n\t\t\t...identityOptions,\n\t\t\t{ name: 'dry-run', description: 'Skip mutating effects.' },\n\t\t\t{ name: 'yes', description: 'Assume yes on prompts.' },\n\t\t\t{ name: 'no-input', description: 'Forbid prompts.' },\n\t\t],\n\t},\n] as const satisfies ReadonlyArray<CommandNode>;\n\nexport const COMMAND_TREE: CommandNode = {\n\tname: 'devstack',\n\tsummary: 'Sui development stack CLI.',\n\tusage: 'devstack <command> [options]',\n\tlifecycle: 'offline',\n\tsideEffects: 'none',\n\trequiresDocker: false,\n\tdescription: 'Boot, inspect, snapshot, and manage local Sui development stacks.',\n\tsubcommands: commands,\n};\n\nexport type Verb = (typeof commands)[number]['name'];\n\nexport const VERBS: ReadonlyArray<Verb> = commands.map((command) => command.name);\n\nexport const commandSchema = () => ({\n\tschemaVersion: 1,\n\tverbs: VERBS,\n\tcommands: COMMAND_TREE,\n\texitCodes: exitCodeTable,\n\tenvVars: Object.values(ENV_VARS),\n});\n"],"mappings":";;;AAwBA,MAAM,kBAAkB;CACvB;EAAE,MAAM;EAAQ,aAAa;EAA8B;CAC3D;EAAE,MAAM;EAAO,OAAO;EAAQ,aAAa;EAAsB;CACjE;EAAE,MAAM;EAAS,OAAO;EAAQ,aAAa;EAAwB;CACrE;EAAE,MAAM;EAAa,OAAO;EAAQ,aAAa;EAA6B;CAC9E;EAAE,MAAM;EAAW,aAAa;EAAgC;CAChE;AAED,MAAM,gBAAgB;CACrB,GAAG;CACH;EAAE,MAAM;EAAU,OAAO;EAAQ,aAAa;EAAqC;CACnF;EAAE,MAAM;EAAW,OAAO;EAAQ,aAAa;EAA0C;CACzF;AAED,MAAM,iBAAiB;CACtB,GAAG;CACH;EAAE,MAAM;EAAO,aAAa;EAA0B;CACtD;EAAE,MAAM;EAAY,aAAa;EAAmB;CACpD;AAED,MAAM,2BAA2B;CAChC;EAAE,MAAM;EAAQ,aAAa;EAA8B;CAC3D;EAAE,MAAM;EAAa,OAAO;EAAQ,aAAa;EAA6B;CAC9E;EAAE,MAAM;EAAW,aAAa;EAAgC;CAChE;AAED,MAAM,WAAW;CAChB;EACC,MAAM;EACN,SAAS;EACT,OAAO;EACP,WAAW;EACX,aAAa;EACb,gBAAgB;EAChB,aAAa;EACb,SAAS,CACR,GAAG,eACH;GACC,MAAM;GACN,OAAO;GACP,aAAa;GACb,CACD;EACD;CACD;EACC,MAAM;EACN,SAAS;EACT,OAAO;EACP,WAAW;EACX,aAAa;EACb,gBAAgB;EAChB,SAAS;EACT;CACD;EACC,MAAM;EACN,SAAS;EACT,OAAO;EACP,WAAW;EACX,aAAa;EACb,gBAAgB;EAChB,SAAS;EACT;CACD;EACC,MAAM;EACN,SAAS;EACT,OAAO;EACP,WAAW;EACX,aAAa;EACb,gBAAgB;EAChB,SAAS;EACT;CACD;EACC,MAAM;EACN,SAAS;EACT,OAAO;EACP,WAAW;EACX,aAAa;EACb,gBAAgB;EAChB,SAAS;EACT;CACD;EACC,MAAM;EACN,SAAS;EACT,OAAO;EACP,WAAW;EACX,aAAa;EACb,gBAAgB;EAChB,SAAS,CAAC;GAAE,MAAM;GAAQ,aAAa;GAA4B,CAAC;EACpE;CACD;EACC,MAAM;EACN,SAAS;EACT,OAAO;EACP,WAAW;EACX,aAAa;EACb,gBAAgB;EAChB,aAAa;GACZ;IACC,MAAM;IACN,SAAS;IACT,OAAO;IACP,WAAW;IACX,aAAa;IACb,gBAAgB;IAChB,WAAW,CAAC,OAAO;IACnB,SAAS,CACR,GAAG,eACH;KAAE,MAAM;KAAQ,OAAO;KAAQ,aAAa;KAAiC,CAC7E;IACD;GACD;IACC,MAAM;IACN,SAAS;IACT,OAAO;IACP,WAAW;IACX,aAAa;IACb,gBAAgB;IAChB,WAAW,CAAC,aAAa;IACzB,SAAS;IACT;GACD;IACC,MAAM;IACN,SAAS;IACT,OAAO;IACP,WAAW;IACX,aAAa;IACb,gBAAgB;IAChB,SAAS;IACT;GACD;IACC,MAAM;IACN,SAAS;IACT,OAAO;IACP,WAAW;IACX,aAAa;IACb,gBAAgB;IAChB,WAAW,CAAC,aAAa;IACzB,SAAS;IACT;GACD;EACD;CACD;EACC,MAAM;EACN,SAAS;EACT,OAAO;EACP,WAAW;EACX,aAAa;EACb,gBAAgB;EAChB,SAAS;GACR,GAAG;GACH;IAAE,MAAM;IAAQ,aAAa;IAAyC;GACtE;IAAE,MAAM;IAAO,aAAa;IAA+C;GAC3E;IAAE,MAAM;IAAiB,aAAa;IAA6B;GACnE;IAAE,MAAM;IAAe,aAAa;IAA2B;GAC/D;IAAE,MAAM;IAAc,aAAa;IAA0B;GAC7D;IAAE,MAAM;IAAkB,aAAa;IAAyC;GAChF;IAAE,MAAM;IAAW,aAAa;IAA0B;GAC1D;IAAE,MAAM;IAAO,aAAa;IAA0B;GACtD;IAAE,MAAM;IAAY,aAAa;IAAmB;GACpD;EACD;CACD;EACC,MAAM;EACN,SAAS;EACT,OAAO;EACP,WAAW;EACX,aAAa;EACb,gBAAgB;EAChB,SAAS;GACR,GAAG;GACH;IAAE,MAAM;IAAW,aAAa;IAA0B;GAC1D;IAAE,MAAM;IAAO,aAAa;IAA0B;GACtD;IAAE,MAAM;IAAY,aAAa;IAAmB;GACpD;EACD;CACD;AAED,MAAa,eAA4B;CACxC,MAAM;CACN,SAAS;CACT,OAAO;CACP,WAAW;CACX,aAAa;CACb,gBAAgB;CAChB,aAAa;CACb,aAAa;CACb;AAID,MAAa,QAA6B,SAAS,KAAK,YAAY,QAAQ,KAAK;AAEjF,MAAa,uBAAuB;CACnC,eAAe;CACf,OAAO;CACP,UAAU;CACV,WAAW;CACX,SAAS,OAAO,OAAO,SAAS;CAChC"}

package/dist/surfaces/cli/commands/index.mjs

@@ -0,0 +1,9 @@
+import "./config.mjs";
+import "./doctor.mjs";
+import "./prune.mjs";
+import "./confirm.mjs";
+import "./snapshot.mjs";
+import "./status.mjs";
+import "./wipe.mjs";
+import "./supervisor-presence.mjs";
+export {};

package/dist/surfaces/cli/commands/prune-picker-entry.mjs

@@ -0,0 +1,13 @@
+import { Effect } from "effect";
+//#region src/surfaces/cli/commands/prune-picker-entry.ts
+const selectPruneTargets = (inventory, resources) => {
+	if (inventory.groups.length === 0) return Effect.succeed({
+		groupKeys: [],
+		resources
+	});
+	return Effect.promise(() => import("./prune-picker.mjs")).pipe(Effect.flatMap((mod) => mod.selectPruneTargets(inventory, resources)));
+};
+//#endregion
+export { selectPruneTargets };
+
+//# sourceMappingURL=prune-picker-entry.mjs.map

package/dist/surfaces/cli/commands/prune-picker-entry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune-picker-entry.mjs","names":[],"sources":["../../../../src/surfaces/cli/commands/prune-picker-entry.ts"],"sourcesContent":["// Lazy seam for the ink/react-based prune-picker UI.\n//\n// `cli/prune-direct.ts` is on every `devstack` CLI invocation path, so\n// the picker entry MUST NOT eagerly pull `ink` + `react` (~ several MB\n// of cold-start cost). Mirrors the `surfaces/tui/index.ts:dynamic\n// import('./mount-ink.tsx')` lazy-import pattern.\n\nimport { Effect } from 'effect';\n\nimport type { PruneInventory, PruneResourceScope, PruneTargetSelection } from './prune.ts';\n\nexport const selectPruneTargets = (\n\tinventory: PruneInventory,\n\tresources: PruneResourceScope,\n): Effect.Effect<PruneTargetSelection> => {\n\tif (inventory.groups.length === 0) return Effect.succeed({ groupKeys: [], resources });\n\treturn Effect.promise(() => import('./prune-picker.tsx')).pipe(\n\t\tEffect.flatMap((mod) => mod.selectPruneTargets(inventory, resources)),\n\t);\n};\n"],"mappings":";;AAWA,MAAa,sBACZ,WACA,cACyC;AACzC,KAAI,UAAU,OAAO,WAAW,EAAG,QAAO,OAAO,QAAQ;EAAE,WAAW,EAAE;EAAE;EAAW,CAAC;AACtF,QAAO,OAAO,cAAc,OAAO,sBAAsB,CAAC,KACzD,OAAO,SAAS,QAAQ,IAAI,mBAAmB,WAAW,UAAU,CAAC,CACrE"}

package/dist/surfaces/cli/commands/prune-picker.mjs

@@ -1,4 +1,4 @@
-import { defaultPruneSelection, groupResourceCountForResources, hasPruneResources, summarizePruneGroups, summarizePruneGroupsForResources } from "./prune.mjs";
+import { appsWithLiveSiblings, defaultPruneSelection, groupResourceCountForResources, hasPruneResources, summarizePruneGroups, summarizePruneGroupsForResources } from "./prune.mjs";
 import { Effect } from "effect";
 import { Box, Text, render, useApp, useInput } from "ink";
 import React, { useEffect, useMemo, useState } from "react";
@@ -47,7 +47,8 @@ const PrunePicker = ({ inventory, resources: initialResources, onSubmit, onQuit
 		inventory,
 		rows
 	]);
-	const selectable = (row) => !row.live;
+	const pinned = useMemo(() => appsWithLiveSiblings(inventory), [inventory]);
+	const selectable = (row) => !row.live && !(row.sharedKind === "per-app-shared" && pinned.has(row.app));
 	const move = (dir) => {
 		if (rows.length === 0) return;
 		let next = cursor;

package/dist/surfaces/cli/commands/prune-picker.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"prune-picker.mjs","names":[],"sources":["../../../../src/surfaces/cli/commands/prune-picker.tsx"],"sourcesContent":["import { Box, Text, render, useApp, useInput } from 'ink';\nimport React, { useEffect, useMemo, useState } from 'react';\nimport { Effect } from 'effect';\n\nimport {\n\tdefaultPruneSelection,\n\tgroupResourceCountForResources,\n\thasPruneResources,\n\tsummarizePruneGroups,\n\tsummarizePruneGroupsForResources,\n\ttype PruneGroup,\n\ttype PruneInventory,\n\ttype PruneResourceScope,\n\ttype PruneTargetSelection,\n} from './prune.ts';\n\nexport const selectPruneTargets = (\n\tinventory: PruneInventory,\n\tresources: PruneResourceScope,\n): Effect.Effect<PruneTargetSelection> => {\n\tif (inventory.groups.length === 0) return Effect.succeed({ groupKeys: [], resources });\n\treturn Effect.callback<PruneTargetSelection>((resume) => {\n\t\tconst instance = renderPrunePicker({\n\t\t\tinventory,\n\t\t\tresources,\n\t\t\tonSubmit: (selection) => {\n\t\t\t\tinstance.unmount();\n\t\t\t\tresume(Effect.succeed(selection));\n\t\t\t},\n\t\t\tonQuit: () => {\n\t\t\t\tinstance.unmount();\n\t\t\t\tresume(Effect.succeed({ groupKeys: [], resources }));\n\t\t\t},\n\t\t});\n\t});\n};\n\nconst renderPrunePicker = (props: PrunePickerProps) => {\n\treturn render(React.createElement(PrunePicker, props), { exitOnCtrlC: false });\n};\n\ninterface PrunePickerProps {\n\treadonly inventory: PruneInventory;\n\treadonly resources: PruneResourceScope;\n\treadonly onSubmit: (selection: PruneTargetSelection) => void;\n\treadonly onQuit: () => void;\n}\n\nconst PrunePicker = ({\n\tinventory,\n\tresources: initialResources,\n\tonSubmit,\n\tonQuit,\n}: PrunePickerProps): React.JSX.Element => {\n\tconst app = useApp();\n\tconst rows = inventory.groups;\n\tconst [cursor, setCursor] = useState(0);\n\tconst [resources, setResources] = useState<PruneResourceScope>(initialResources);\n\tconst [selected, setSelected] = useState<ReadonlySet<string>>(\n\t\t() => new Set(defaultPruneSelection(inventory, initialResources)),\n\t);\n\tconst [confirming, setConfirming] = useState(false);\n\n\tuseEffect(() => {\n\t\tconst first = rows.findIndex((row) => !row.live);\n\t\tsetCursor(first >= 0 ? first : 0);\n\t\tsetResources(initialResources);\n\t\tsetSelected(new Set(defaultPruneSelection(inventory, initialResources)));\n\t}, [initialResources, inventory, rows]);\n\n\tconst selectable = (row: PruneGroup): boolean => !row.live;\n\n\tconst move = (dir: 1 | -1): void => {\n\t\tif (rows.length === 0) return;\n\t\tlet next = cursor;\n\t\tfor (let i = 0; i < rows.length; i += 1) {\n\t\t\tnext = (next + dir + rows.length) % rows.length;\n\t\t\tconst row = rows[next];\n\t\t\tif (row !== undefined && selectable(row)) {\n\t\t\t\tsetCursor(next);\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\t};\n\n\tconst toggle = (): void => {\n\t\tconst row = rows[cursor];\n\t\tif (row === undefined || !selectable(row)) return;\n\t\tconst next = new Set(selected);\n\t\tif (next.has(row.key)) next.delete(row.key);\n\t\telse next.add(row.key);\n\t\tsetSelected(next);\n\t};\n\n\tconst selectAll = (): void => {\n\t\tsetSelected(\n\t\t\tnew Set(\n\t\t\t\trows\n\t\t\t\t\t.filter((row) => selectable(row) && groupResourceCountForResources(row, resources) > 0)\n\t\t\t\t\t.map((row) => row.key),\n\t\t\t),\n\t\t);\n\t};\n\n\tconst toggleResource = (name: keyof PruneResourceScope): void => {\n\t\tsetResources((current) => ({ ...current, [name]: !current[name] }));\n\t};\n\n\tuseInput((input, key) => {\n\t\tif (confirming) {\n\t\t\tif (input === 'y' || input === 'Y') {\n\t\t\t\tapp.exit();\n\t\t\t\tonSubmit({ groupKeys: [...selected], resources });\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (input === 'n' || input === 'N' || key.escape || key.return) {\n\t\t\t\tsetConfirming(false);\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\t\tif (input === 'q' || input === 'Q' || (key.ctrl && input === 'c')) {\n\t\t\tapp.exit();\n\t\t\tonQuit();\n\t\t\treturn;\n\t\t}\n\t\tif (key.upArrow || input === 'k') {\n\t\t\tmove(-1);\n\t\t\treturn;\n\t\t}\n\t\tif (key.downArrow || input === 'j') {\n\t\t\tmove(1);\n\t\t\treturn;\n\t\t}\n\t\tif (input === ' ') {\n\t\t\ttoggle();\n\t\t\treturn;\n\t\t}\n\t\tif (input === '1') {\n\t\t\ttoggleResource('containers');\n\t\t\treturn;\n\t\t}\n\t\tif (input === '2') {\n\t\t\ttoggleResource('networks');\n\t\t\treturn;\n\t\t}\n\t\tif (input === '3') {\n\t\t\ttoggleResource('volumes');\n\t\t\treturn;\n\t\t}\n\t\tif (input === '4' || input === 'i' || input === 'I') {\n\t\t\ttoggleResource('images');\n\t\t\treturn;\n\t\t}\n\t\tif (input === 'a' || input === 'A') {\n\t\t\tselectAll();\n\t\t\treturn;\n\t\t}\n\t\tif (input === 'n' || input === 'N') {\n\t\t\tsetSelected(new Set());\n\t\t\treturn;\n\t\t}\n\t\tif (\n\t\t\tkey.return &&\n\t\t\tselected.size > 0 &&\n\t\t\thasPruneResources(resources) &&\n\t\t\tselectedResourceCount(rows, selected, resources) > 0\n\t\t) {\n\t\t\tsetConfirming(true);\n\t\t}\n\t});\n\n\tconst selectedRows = useMemo(() => rows.filter((row) => selected.has(row.key)), [rows, selected]);\n\tconst selectedTotals = useMemo(\n\t\t() => summarizePruneGroupsForResources(selectedRows, resources),\n\t\t[selectedRows, resources],\n\t);\n\tconst idleTotals = summarizePruneGroupsForResources(\n\t\trows.filter((row) => !row.live),\n\t\tresources,\n\t);\n\tconst allIdleTotals = summarizePruneGroups(rows.filter((row) => !row.live));\n\tconst effectiveSelectedCount =\n\t\tselectedTotals.containers +\n\t\tselectedTotals.networks +\n\t\tselectedTotals.volumes +\n\t\tselectedTotals.images;\n\n\treturn (\n\t\t<Box flexDirection=\"column\">\n\t\t\t<Box paddingX={1} borderStyle=\"round\" borderColor=\"gray\">\n\t\t\t\t<Text bold>devstack prune</Text>\n\t\t\t\t<Text dimColor>\n\t\t\t\t\t{' '}\n\t\t\t\t\t{rows.length} group(s), {idleTotals.containers} container(s), {idleTotals.networks}{' '}\n\t\t\t\t\tnetwork(s), {idleTotals.volumes} volume(s), {idleTotals.images} image(s)\n\t\t\t\t</Text>\n\t\t\t</Box>\n\t\t\t<ResourceScopeRow resources={resources} totals={allIdleTotals} />\n\t\t\t<Box flexDirection=\"column\" paddingX={1}>\n\t\t\t\t{rows.map((row, index) => (\n\t\t\t\t\t<PruneRow\n\t\t\t\t\t\tkey={row.key}\n\t\t\t\t\t\trow={row}\n\t\t\t\t\t\tresources={resources}\n\t\t\t\t\t\tfocused={index === cursor}\n\t\t\t\t\t\tchecked={selected.has(row.key)}\n\t\t\t\t\t/>\n\t\t\t\t))}\n\t\t\t</Box>\n\t\t\t{confirming ? (\n\t\t\t\t<Box paddingX={1} marginTop={1} flexDirection=\"column\">\n\t\t\t\t\t<Text>\n\t\t\t\t\t\tWill remove {selectedRows.length} group(s): {selectedTotals.containers} container(s),{' '}\n\t\t\t\t\t\t{selectedTotals.networks} network(s), {selectedTotals.volumes} volume(s),{' '}\n\t\t\t\t\t\t{selectedTotals.images} image(s).\n\t\t\t\t\t</Text>\n\t\t\t\t\t<Text color=\"yellow\">Proceed? [y/N]</Text>\n\t\t\t\t</Box>\n\t\t\t) : (\n\t\t\t\t<Box paddingX={1} marginTop={1} flexDirection=\"column\">\n\t\t\t\t\t{!hasPruneResources(resources) ? (\n\t\t\t\t\t\t<Text color=\"yellow\">Enable at least one resource type.</Text>\n\t\t\t\t\t) : selected.size > 0 && effectiveSelectedCount === 0 ? (\n\t\t\t\t\t\t<Text color=\"yellow\">Selected groups have no enabled resource types.</Text>\n\t\t\t\t\t) : null}\n\t\t\t\t\t<Text dimColor>\n\t\t\t\t\t\t[space] toggle row [1-4] resources [a] all [n] none [enter] prune selected [q]uit\n\t\t\t\t\t</Text>\n\t\t\t\t</Box>\n\t\t\t)}\n\t\t</Box>\n\t);\n};\n\nconst selectedResourceCount = (\n\trows: ReadonlyArray<PruneGroup>,\n\tselected: ReadonlySet<string>,\n\tresources: PruneResourceScope,\n): number =>\n\trows\n\t\t.filter((row) => selected.has(row.key))\n\t\t.reduce((total, row) => total + groupResourceCountForResources(row, resources), 0);\n\nconst ResourceScopeRow = ({\n\tresources,\n\ttotals,\n}: {\n\treadonly resources: PruneResourceScope;\n\treadonly totals: ReturnType<typeof summarizePruneGroups>;\n}): React.JSX.Element => (\n\t<Box paddingX={1}>\n\t\t<Text dimColor>resources </Text>\n\t\t<ResourceToggle\n\t\t\tactive={resources.containers}\n\t\t\tindex=\"1\"\n\t\t\tlabel=\"containers\"\n\t\t\tcount={totals.containers}\n\t\t/>\n\t\t<Text> </Text>\n\t\t<ResourceToggle\n\t\t\tactive={resources.networks}\n\t\t\tindex=\"2\"\n\t\t\tlabel=\"networks\"\n\t\t\tcount={totals.networks}\n\t\t/>\n\t\t<Text> </Text>\n\t\t<ResourceToggle active={resources.volumes} index=\"3\" label=\"volumes\" count={totals.volumes} />\n\t\t<Text> </Text>\n\t\t<ResourceToggle active={resources.images} index=\"4\" label=\"images\" count={totals.images} />\n\t</Box>\n);\n\nconst ResourceToggle = ({\n\tactive,\n\tindex,\n\tlabel,\n\tcount,\n}: {\n\treadonly active: boolean;\n\treadonly index: string;\n\treadonly label: string;\n\treadonly count: number;\n}): React.JSX.Element => (\n\t<Text color={active ? 'green' : 'gray'}>\n\t\t{index}:{active ? '[x]' : '[ ]'} {label}({count})\n\t</Text>\n);\n\nconst PruneRow = ({\n\trow,\n\tresources,\n\tfocused,\n\tchecked,\n}: {\n\treadonly row: PruneGroup;\n\treadonly resources: PruneResourceScope;\n\treadonly focused: boolean;\n\treadonly checked: boolean;\n}): React.JSX.Element => {\n\tconst cursor = focused ? '>' : ' ';\n\tconst box = row.live ? '[-]' : checked ? '[x]' : '[ ]';\n\tconst state = row.live ? `live pid ${row.livePids.join(',')}` : row.shared ? 'shared' : 'idle';\n\tconst color = row.live ? 'red' : focused ? 'cyan' : row.shared ? 'yellow' : undefined;\n\tconst running = row.runningContainers > 0 ? `, ${row.runningContainers} running` : '';\n\treturn (\n\t\t<Box>\n\t\t\t<Text color={color} bold={focused || row.shared}>\n\t\t\t\t{cursor} {box} {row.app}/{row.stack}{' '}\n\t\t\t</Text>\n\t\t\t<Text dimColor>\n\t\t\t\t{state}\n\t\t\t\t{running}{' '}\n\t\t\t</Text>\n\t\t\t<ResourceCount active={resources.containers} count={row.containers} label=\"ctr\" />\n\t\t\t<Text dimColor>, </Text>\n\t\t\t<ResourceCount active={resources.networks} count={row.networks} label=\"net\" />\n\t\t\t<Text dimColor>, </Text>\n\t\t\t<ResourceCount active={resources.volumes} count={row.volumes} label=\"vol\" />\n\t\t\t<Text dimColor>, </Text>\n\t\t\t<ResourceCount active={resources.images} count={row.images} label=\"img\" />\n\t\t</Box>\n\t);\n};\n\nconst ResourceCount = ({\n\tactive,\n\tcount,\n\tlabel,\n}: {\n\treadonly active: boolean;\n\treadonly count: number;\n\treadonly label: string;\n}): React.JSX.Element => (\n\t<Text color={active ? undefined : 'gray'}>\n\t\t{count} {label}\n\t</Text>\n);\n"],"mappings":"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"}
+{"version":3,"file":"prune-picker.mjs","names":[],"sources":["../../../../src/surfaces/cli/commands/prune-picker.tsx"],"sourcesContent":["import { Box, Text, render, useApp, useInput } from 'ink';\nimport React, { useEffect, useMemo, useState } from 'react';\nimport { Effect } from 'effect';\n\nimport {\n\tappsWithLiveSiblings,\n\tdefaultPruneSelection,\n\tgroupResourceCountForResources,\n\thasPruneResources,\n\tsummarizePruneGroups,\n\tsummarizePruneGroupsForResources,\n\ttype PruneGroup,\n\ttype PruneInventory,\n\ttype PruneResourceScope,\n\ttype PruneTargetSelection,\n} from './prune.ts';\n\nexport const selectPruneTargets = (\n\tinventory: PruneInventory,\n\tresources: PruneResourceScope,\n): Effect.Effect<PruneTargetSelection> => {\n\tif (inventory.groups.length === 0) return Effect.succeed({ groupKeys: [], resources });\n\treturn Effect.callback<PruneTargetSelection>((resume) => {\n\t\tconst instance = renderPrunePicker({\n\t\t\tinventory,\n\t\t\tresources,\n\t\t\tonSubmit: (selection) => {\n\t\t\t\tinstance.unmount();\n\t\t\t\tresume(Effect.succeed(selection));\n\t\t\t},\n\t\t\tonQuit: () => {\n\t\t\t\tinstance.unmount();\n\t\t\t\tresume(Effect.succeed({ groupKeys: [], resources }));\n\t\t\t},\n\t\t});\n\t});\n};\n\nconst renderPrunePicker = (props: PrunePickerProps) => {\n\treturn render(React.createElement(PrunePicker, props), { exitOnCtrlC: false });\n};\n\ninterface PrunePickerProps {\n\treadonly inventory: PruneInventory;\n\treadonly resources: PruneResourceScope;\n\treadonly onSubmit: (selection: PruneTargetSelection) => void;\n\treadonly onQuit: () => void;\n}\n\nconst PrunePicker = ({\n\tinventory,\n\tresources: initialResources,\n\tonSubmit,\n\tonQuit,\n}: PrunePickerProps): React.JSX.Element => {\n\tconst app = useApp();\n\tconst rows = inventory.groups;\n\tconst [cursor, setCursor] = useState(0);\n\tconst [resources, setResources] = useState<PruneResourceScope>(initialResources);\n\tconst [selected, setSelected] = useState<ReadonlySet<string>>(\n\t\t() => new Set(defaultPruneSelection(inventory, initialResources)),\n\t);\n\tconst [confirming, setConfirming] = useState(false);\n\n\tuseEffect(() => {\n\t\tconst first = rows.findIndex((row) => !row.live);\n\t\tsetCursor(first >= 0 ? first : 0);\n\t\tsetResources(initialResources);\n\t\tsetSelected(new Set(defaultPruneSelection(inventory, initialResources)));\n\t}, [initialResources, inventory, rows]);\n\n\t// Apps with a live non-shared sibling pin their `per-app-shared`\n\t// group (shared chain-build cache &c.). The default `selected` set\n\t// already excludes these via `defaultPruneSelection`; mirroring the\n\t// predicate here keeps manual toggle / select-all from re-adding a\n\t// pinned shared group, matching the orchestrator's enforcement.\n\tconst pinned = useMemo(() => appsWithLiveSiblings(inventory), [inventory]);\n\n\tconst selectable = (row: PruneGroup): boolean =>\n\t\t!row.live && !(row.sharedKind === 'per-app-shared' && pinned.has(row.app));\n\n\tconst move = (dir: 1 | -1): void => {\n\t\tif (rows.length === 0) return;\n\t\tlet next = cursor;\n\t\tfor (let i = 0; i < rows.length; i += 1) {\n\t\t\tnext = (next + dir + rows.length) % rows.length;\n\t\t\tconst row = rows[next];\n\t\t\tif (row !== undefined && selectable(row)) {\n\t\t\t\tsetCursor(next);\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\t};\n\n\tconst toggle = (): void => {\n\t\tconst row = rows[cursor];\n\t\tif (row === undefined || !selectable(row)) return;\n\t\tconst next = new Set(selected);\n\t\tif (next.has(row.key)) next.delete(row.key);\n\t\telse next.add(row.key);\n\t\tsetSelected(next);\n\t};\n\n\tconst selectAll = (): void => {\n\t\tsetSelected(\n\t\t\tnew Set(\n\t\t\t\trows\n\t\t\t\t\t.filter((row) => selectable(row) && groupResourceCountForResources(row, resources) > 0)\n\t\t\t\t\t.map((row) => row.key),\n\t\t\t),\n\t\t);\n\t};\n\n\tconst toggleResource = (name: keyof PruneResourceScope): void => {\n\t\tsetResources((current) => ({ ...current, [name]: !current[name] }));\n\t};\n\n\tuseInput((input, key) => {\n\t\tif (confirming) {\n\t\t\tif (input === 'y' || input === 'Y') {\n\t\t\t\tapp.exit();\n\t\t\t\tonSubmit({ groupKeys: [...selected], resources });\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (input === 'n' || input === 'N' || key.escape || key.return) {\n\t\t\t\tsetConfirming(false);\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\t\tif (input === 'q' || input === 'Q' || (key.ctrl && input === 'c')) {\n\t\t\tapp.exit();\n\t\t\tonQuit();\n\t\t\treturn;\n\t\t}\n\t\tif (key.upArrow || input === 'k') {\n\t\t\tmove(-1);\n\t\t\treturn;\n\t\t}\n\t\tif (key.downArrow || input === 'j') {\n\t\t\tmove(1);\n\t\t\treturn;\n\t\t}\n\t\tif (input === ' ') {\n\t\t\ttoggle();\n\t\t\treturn;\n\t\t}\n\t\tif (input === '1') {\n\t\t\ttoggleResource('containers');\n\t\t\treturn;\n\t\t}\n\t\tif (input === '2') {\n\t\t\ttoggleResource('networks');\n\t\t\treturn;\n\t\t}\n\t\tif (input === '3') {\n\t\t\ttoggleResource('volumes');\n\t\t\treturn;\n\t\t}\n\t\tif (input === '4' || input === 'i' || input === 'I') {\n\t\t\ttoggleResource('images');\n\t\t\treturn;\n\t\t}\n\t\tif (input === 'a' || input === 'A') {\n\t\t\tselectAll();\n\t\t\treturn;\n\t\t}\n\t\tif (input === 'n' || input === 'N') {\n\t\t\tsetSelected(new Set());\n\t\t\treturn;\n\t\t}\n\t\tif (\n\t\t\tkey.return &&\n\t\t\tselected.size > 0 &&\n\t\t\thasPruneResources(resources) &&\n\t\t\tselectedResourceCount(rows, selected, resources) > 0\n\t\t) {\n\t\t\tsetConfirming(true);\n\t\t}\n\t});\n\n\tconst selectedRows = useMemo(() => rows.filter((row) => selected.has(row.key)), [rows, selected]);\n\tconst selectedTotals = useMemo(\n\t\t() => summarizePruneGroupsForResources(selectedRows, resources),\n\t\t[selectedRows, resources],\n\t);\n\tconst idleTotals = summarizePruneGroupsForResources(\n\t\trows.filter((row) => !row.live),\n\t\tresources,\n\t);\n\tconst allIdleTotals = summarizePruneGroups(rows.filter((row) => !row.live));\n\tconst effectiveSelectedCount =\n\t\tselectedTotals.containers +\n\t\tselectedTotals.networks +\n\t\tselectedTotals.volumes +\n\t\tselectedTotals.images;\n\n\treturn (\n\t\t<Box flexDirection=\"column\">\n\t\t\t<Box paddingX={1} borderStyle=\"round\" borderColor=\"gray\">\n\t\t\t\t<Text bold>devstack prune</Text>\n\t\t\t\t<Text dimColor>\n\t\t\t\t\t{' '}\n\t\t\t\t\t{rows.length} group(s), {idleTotals.containers} container(s), {idleTotals.networks}{' '}\n\t\t\t\t\tnetwork(s), {idleTotals.volumes} volume(s), {idleTotals.images} image(s)\n\t\t\t\t</Text>\n\t\t\t</Box>\n\t\t\t<ResourceScopeRow resources={resources} totals={allIdleTotals} />\n\t\t\t<Box flexDirection=\"column\" paddingX={1}>\n\t\t\t\t{rows.map((row, index) => (\n\t\t\t\t\t<PruneRow\n\t\t\t\t\t\tkey={row.key}\n\t\t\t\t\t\trow={row}\n\t\t\t\t\t\tresources={resources}\n\t\t\t\t\t\tfocused={index === cursor}\n\t\t\t\t\t\tchecked={selected.has(row.key)}\n\t\t\t\t\t/>\n\t\t\t\t))}\n\t\t\t</Box>\n\t\t\t{confirming ? (\n\t\t\t\t<Box paddingX={1} marginTop={1} flexDirection=\"column\">\n\t\t\t\t\t<Text>\n\t\t\t\t\t\tWill remove {selectedRows.length} group(s): {selectedTotals.containers} container(s),{' '}\n\t\t\t\t\t\t{selectedTotals.networks} network(s), {selectedTotals.volumes} volume(s),{' '}\n\t\t\t\t\t\t{selectedTotals.images} image(s).\n\t\t\t\t\t</Text>\n\t\t\t\t\t<Text color=\"yellow\">Proceed? [y/N]</Text>\n\t\t\t\t</Box>\n\t\t\t) : (\n\t\t\t\t<Box paddingX={1} marginTop={1} flexDirection=\"column\">\n\t\t\t\t\t{!hasPruneResources(resources) ? (\n\t\t\t\t\t\t<Text color=\"yellow\">Enable at least one resource type.</Text>\n\t\t\t\t\t) : selected.size > 0 && effectiveSelectedCount === 0 ? (\n\t\t\t\t\t\t<Text color=\"yellow\">Selected groups have no enabled resource types.</Text>\n\t\t\t\t\t) : null}\n\t\t\t\t\t<Text dimColor>\n\t\t\t\t\t\t[space] toggle row [1-4] resources [a] all [n] none [enter] prune selected [q]uit\n\t\t\t\t\t</Text>\n\t\t\t\t</Box>\n\t\t\t)}\n\t\t</Box>\n\t);\n};\n\nconst selectedResourceCount = (\n\trows: ReadonlyArray<PruneGroup>,\n\tselected: ReadonlySet<string>,\n\tresources: PruneResourceScope,\n): number =>\n\trows\n\t\t.filter((row) => selected.has(row.key))\n\t\t.reduce((total, row) => total + groupResourceCountForResources(row, resources), 0);\n\nconst ResourceScopeRow = ({\n\tresources,\n\ttotals,\n}: {\n\treadonly resources: PruneResourceScope;\n\treadonly totals: ReturnType<typeof summarizePruneGroups>;\n}): React.JSX.Element => (\n\t<Box paddingX={1}>\n\t\t<Text dimColor>resources </Text>\n\t\t<ResourceToggle\n\t\t\tactive={resources.containers}\n\t\t\tindex=\"1\"\n\t\t\tlabel=\"containers\"\n\t\t\tcount={totals.containers}\n\t\t/>\n\t\t<Text> </Text>\n\t\t<ResourceToggle\n\t\t\tactive={resources.networks}\n\t\t\tindex=\"2\"\n\t\t\tlabel=\"networks\"\n\t\t\tcount={totals.networks}\n\t\t/>\n\t\t<Text> </Text>\n\t\t<ResourceToggle active={resources.volumes} index=\"3\" label=\"volumes\" count={totals.volumes} />\n\t\t<Text> </Text>\n\t\t<ResourceToggle active={resources.images} index=\"4\" label=\"images\" count={totals.images} />\n\t</Box>\n);\n\nconst ResourceToggle = ({\n\tactive,\n\tindex,\n\tlabel,\n\tcount,\n}: {\n\treadonly active: boolean;\n\treadonly index: string;\n\treadonly label: string;\n\treadonly count: number;\n}): React.JSX.Element => (\n\t<Text color={active ? 'green' : 'gray'}>\n\t\t{index}:{active ? '[x]' : '[ ]'} {label}({count})\n\t</Text>\n);\n\nconst PruneRow = ({\n\trow,\n\tresources,\n\tfocused,\n\tchecked,\n}: {\n\treadonly row: PruneGroup;\n\treadonly resources: PruneResourceScope;\n\treadonly focused: boolean;\n\treadonly checked: boolean;\n}): React.JSX.Element => {\n\tconst cursor = focused ? '>' : ' ';\n\tconst box = row.live ? '[-]' : checked ? '[x]' : '[ ]';\n\tconst state = row.live ? `live pid ${row.livePids.join(',')}` : row.shared ? 'shared' : 'idle';\n\tconst color = row.live ? 'red' : focused ? 'cyan' : row.shared ? 'yellow' : undefined;\n\tconst running = row.runningContainers > 0 ? `, ${row.runningContainers} running` : '';\n\treturn (\n\t\t<Box>\n\t\t\t<Text color={color} bold={focused || row.shared}>\n\t\t\t\t{cursor} {box} {row.app}/{row.stack}{' '}\n\t\t\t</Text>\n\t\t\t<Text dimColor>\n\t\t\t\t{state}\n\t\t\t\t{running}{' '}\n\t\t\t</Text>\n\t\t\t<ResourceCount active={resources.containers} count={row.containers} label=\"ctr\" />\n\t\t\t<Text dimColor>, </Text>\n\t\t\t<ResourceCount active={resources.networks} count={row.networks} label=\"net\" />\n\t\t\t<Text dimColor>, </Text>\n\t\t\t<ResourceCount active={resources.volumes} count={row.volumes} label=\"vol\" />\n\t\t\t<Text dimColor>, </Text>\n\t\t\t<ResourceCount active={resources.images} count={row.images} label=\"img\" />\n\t\t</Box>\n\t);\n};\n\nconst ResourceCount = ({\n\tactive,\n\tcount,\n\tlabel,\n}: {\n\treadonly active: boolean;\n\treadonly count: number;\n\treadonly label: string;\n}): React.JSX.Element => (\n\t<Text color={active ? undefined : 'gray'}>\n\t\t{count} {label}\n\t</Text>\n);\n"],"mappings":"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"}

package/dist/surfaces/cli/commands/prune.mjs

@@ -1,14 +1,11 @@
 import { CliConfirmRequiredError, CliInternalError, CliUsageError, isCliError } from "../errors.mjs";
 import { emitSuccess } from "../output.mjs";
-import "../../../orchestrators/router/cleanup.mjs";
+import { DEFAULT_LIFECYCLE_PRUNE_RESOURCES, defaultLifecyclePruneSelection, lifecyclePruneAppsWithLiveSiblings } from "../../../orchestrators/lifecycle-prune/index.mjs";
 import { Effect } from "effect";
 //#region src/surfaces/cli/commands/prune.ts
-const DEFAULT_PRUNE_RESOURCES = {
-	containers: true,
-	networks: true,
-	volumes: true,
-	images: false
-};
+/** L4 mirror of the orchestrator's default resource scope. Re-export
+*  rather than redefine so the default never drifts between layers. */
+const DEFAULT_PRUNE_RESOURCES = DEFAULT_LIFECYCLE_PRUNE_RESOURCES;
 const summarizePruneGroups = (groups) => {
 	let liveGroups = 0;
 	let sharedGroups = 0;
@@ -50,8 +47,16 @@ const summarizePruneGroupsForResources = (groups, resources) => {
 };
 const hasPruneResources = (resources) => resources.containers || resources.networks || resources.volumes || resources.images;
 const groupResourceCountForResources = (group, resources) => (resources.containers ? group.containers : 0) + (resources.networks ? group.networks : 0) + (resources.volumes ? group.volumes : 0) + (resources.images ? group.images : 0);
-const isAutoPrunableSharedGroup = (group) => group.app === "devstack-router" && group.stack.startsWith("devstack-router-");
-const defaultPruneSelection = (inventory, resources = DEFAULT_PRUNE_RESOURCES) => inventory.groups.filter((group) => !group.live && (!group.shared || isAutoPrunableSharedGroup(group)) && groupResourceCountForResources(group, resources) > 0).map((group) => group.key);
+/** L4 mirror — defers to the orchestrator's pinning predicate so the
+*  shared-resource rule lives in exactly one place. Exported so the
+*  interactive picker enforces the same per-app-shared pinning rule
+*  the default selection already obeys (manual toggle / select-all must
+*  not add a `per-app-shared` group pinned by a live sibling). */
+const appsWithLiveSiblings = (inventory) => lifecyclePruneAppsWithLiveSiblings(inventory);
+/** Delegates to the orchestrator's `defaultLifecyclePruneSelection`.
+*  The L4 shape mirrors the L3 shape field-for-field; the surface
+*  never reimplements the shared/per-app/router policy. */
+const defaultPruneSelection = (inventory, resources = DEFAULT_PRUNE_RESOURCES) => defaultLifecyclePruneSelection(inventory, resources);
 const requireBulkConfirm = (verb, ctx) => {
 	if (ctx.flags.dryRun) return Effect.void;
 	if (ctx.flags.confirm.assumeYes) return Effect.void;
@@ -67,20 +72,30 @@ const requireInteractive = (ctx) => {
 		hint: "use --list, --dry-run, or --all --yes in non-interactive shells"
 	}));
 };
-const formatGroupLine = (group) => {
-	const state = group.live && group.livePids.length > 0 ? `live pid ${group.livePids.join(",")}` : group.live ? "live" : group.shared ? "shared" : "idle";
+const formatGroupLine = (group, pinnedApps) => {
+	const state = group.live && group.livePids.length > 0 ? `live pid ${group.livePids.join(",")}` : group.live ? "live" : group.sharedKind === "per-app-shared" ? pinnedApps.has(group.app) ? "shared (pinned by live sibling)" : "shared (auto)" : group.shared ? group.autoPrunable ? "shared (auto)" : "shared" : "idle";
 	const running = group.runningContainers > 0 ? `, ${group.runningContainers} running` : "";
 	const images = group.images > 0 ? `, ${group.images} image(s)` : "";
 	return `  ${group.app}/${group.stack}  ${state}  ${group.containers} container(s)${running}, ${group.networks} network(s), ${group.volumes} volume(s)${images}`;
 };
 const inventoryLines = (inventory) => {
 	if (inventory.groups.length === 0) return ["(no devstack-labelled Docker resources)"];
-	return [`devstack prune inventory: ${inventory.totals.groups} group(s), ${inventory.totals.containers} container(s), ${inventory.totals.networks} network(s), ${inventory.totals.volumes} volume(s), ${inventory.totals.images} image(s)`, ...inventory.groups.map(formatGroupLine)];
+	const pinned = appsWithLiveSiblings(inventory);
+	return [`devstack prune inventory: ${inventory.totals.groups} group(s), ${inventory.totals.containers} container(s), ${inventory.totals.networks} network(s), ${inventory.totals.volumes} volume(s), ${inventory.totals.images} image(s)`, ...inventory.groups.map((g) => formatGroupLine(g, pinned))];
 };
-const completedLine = (summary, dryRun) => {
+const completedLines = (summary, dryRun) => {
 	const prefix = dryRun ? "[dry-run] would prune" : "prune completed";
 	const skippedNetworks = summary.networksSkipped > 0 ? `, ${summary.networksSkipped} network(s) still in use` : "";
-	return `${prefix}: ${summary.selectedGroups} group(s), ${summary.containersRemoved} container(s), ${summary.networksRemoved} network(s), ${summary.volumesRemoved} volume(s), ${summary.imagesRemoved} image(s), ${summary.skippedLiveGroups} live group(s) skipped${skippedNetworks}`;
+	const lines = [`${prefix}: ${summary.selectedGroups} group(s), ${summary.containersRemoved} container(s), ${summary.networksRemoved} network(s), ${summary.volumesRemoved} volume(s), ${summary.imagesRemoved} image(s), ${summary.skippedLiveGroups} live group(s) skipped${skippedNetworks}`];
+	if (summary.foreignNetworkHolders.length > 0) {
+		lines.push("foreign network holders:");
+		for (const h of summary.foreignNetworkHolders) lines.push(`  ${h.network} held by ${h.container.name} (${h.container.id.slice(0, 12)})`);
+	}
+	if (summary.staleNetworkEndpoints.length > 0) {
+		lines.push("stale endpoints (Docker engine bug — restart Docker Desktop to reclaim these networks):");
+		for (const ep of summary.staleNetworkEndpoints) lines.push(`  ${ep.network}: phantom endpoint "${ep.name}" (${ep.id.slice(0, 12)})`);
+	}
+	return lines;
 };
 const mapUnknownPruneError = (cause) => isCliError(cause) ? Effect.fail(cause) : Effect.fail(new CliInternalError({
 	message: "prune failed",
@@ -144,7 +159,9 @@ const runPrune = (deps, ctx, options = {
 						networksRemoved: 0,
 						networksSkipped: 0,
 						volumesRemoved: 0,
-						imagesRemoved: 0
+						imagesRemoved: 0,
+						foreignNetworkHolders: [],
+						staleNetworkEndpoints: []
 					}
 				}
 			},
@@ -168,11 +185,11 @@ const runPrune = (deps, ctx, options = {
 			selection: selected,
 			outcome
 		},
-		humanLines: [completedLine(outcome.summary, ctx.flags.dryRun)]
+		humanLines: completedLines(outcome.summary, ctx.flags.dryRun)
 	});
 	return { exitCode: 0 };
 }).pipe(Effect.withSpan("cli.prune"));
 //#endregion
-export { defaultPruneSelection, groupResourceCountForResources, hasPruneResources, runPrune, summarizePruneGroups, summarizePruneGroupsForResources };
+export { DEFAULT_PRUNE_RESOURCES, appsWithLiveSiblings, defaultPruneSelection, groupResourceCountForResources, hasPruneResources, runPrune, summarizePruneGroups, summarizePruneGroupsForResources };
 
 //# sourceMappingURL=prune.mjs.map

package/dist/surfaces/cli/commands/prune.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"prune.mjs","names":[],"sources":["../../../../src/surfaces/cli/commands/prune.ts"],"sourcesContent":["// CLI verb: `devstack prune` — cross-stack Docker cleanup.\n//\n// The rewrite initially wired this command to snapshot-catalog prune\n// only. That path can report success while leaving ordinary stale\n// containers, networks, and volumes untouched. This command owns the\n// operator surface; production injects a Docker-label inventory and\n// remover that understand both current labels and pre-rewrite labels.\n\nimport { Effect } from 'effect';\n\nimport {\n\tROUTER_CONTAINER_NAME_PREFIX,\n\tROUTER_SHARED_APP,\n} from '../../../orchestrators/router/cleanup.ts';\nimport {\n\ttype CliError,\n\tCliConfirmRequiredError,\n\tCliInternalError,\n\tCliUsageError,\n\tisCliError,\n} from '../errors.ts';\nimport { emitSuccess } from '../output.ts';\nimport type { CommandContext, CommandResult } from './index.ts';\n\nexport interface PruneGroup {\n\treadonly key: string;\n\treadonly app: string;\n\treadonly stack: string;\n\treadonly live: boolean;\n\treadonly livePids: ReadonlyArray<number>;\n\treadonly shared: boolean;\n\treadonly containers: number;\n\treadonly runningContainers: number;\n\treadonly networks: number;\n\treadonly volumes: number;\n\treadonly images: number;\n}\n\nexport interface PruneTotals {\n\treadonly groups: number;\n\treadonly liveGroups: number;\n\treadonly sharedGroups: number;\n\treadonly containers: number;\n\treadonly runningContainers: number;\n\treadonly networks: number;\n\treadonly volumes: number;\n\treadonly images: number;\n}\n\nexport interface PruneInventory {\n\treadonly groups: ReadonlyArray<PruneGroup>;\n\treadonly totals: PruneTotals;\n}\n\nexport interface PruneResourceScope {\n\treadonly containers: boolean;\n\treadonly networks: boolean;\n\treadonly volumes: boolean;\n\treadonly images: boolean;\n}\n\nexport interface PruneTargetSelection {\n\treadonly groupKeys: ReadonlyArray<string>;\n\treadonly resources: PruneResourceScope;\n}\n\nexport interface PruneSelection extends PruneTargetSelection {\n\treadonly dryRun: boolean;\n}\n\nexport interface PruneSummary {\n\treadonly inspectedGroups: number;\n\treadonly selectedGroups: number;\n\treadonly skippedLiveGroups: number;\n\treadonly containersRemoved: number;\n\treadonly networksRemoved: number;\n\treadonly networksSkipped: number;\n\treadonly volumesRemoved: number;\n\treadonly imagesRemoved: number;\n}\n\nexport type PruneOutcome = { readonly kind: 'completed'; readonly summary: PruneSummary };\n\nexport interface PruneDeps {\n\treadonly inventory: () => Effect.Effect<PruneInventory, unknown>;\n\treadonly prune: (selection: PruneSelection) => Effect.Effect<PruneOutcome, unknown>;\n\treadonly select: (\n\t\tinventory: PruneInventory,\n\t\tresources: PruneResourceScope,\n\t) => Effect.Effect<PruneTargetSelection, unknown>;\n}\n\nexport interface PruneRunOptions {\n\treadonly mode: 'auto' | 'list' | 'all';\n\treadonly resources: PruneResourceScope;\n}\n\nexport const DEFAULT_PRUNE_RESOURCES: PruneResourceScope = {\n\tcontainers: true,\n\tnetworks: true,\n\tvolumes: true,\n\timages: false,\n};\n\nexport const summarizePruneGroups = (groups: ReadonlyArray<PruneGroup>): PruneTotals => {\n\tlet liveGroups = 0;\n\tlet sharedGroups = 0;\n\tlet containers = 0;\n\tlet runningContainers = 0;\n\tlet networks = 0;\n\tlet volumes = 0;\n\tlet images = 0;\n\tfor (const group of groups) {\n\t\tif (group.live) liveGroups += 1;\n\t\tif (group.shared) sharedGroups += 1;\n\t\tcontainers += group.containers;\n\t\trunningContainers += group.runningContainers;\n\t\tnetworks += group.networks;\n\t\tvolumes += group.volumes;\n\t\timages += group.images;\n\t}\n\treturn {\n\t\tgroups: groups.length,\n\t\tliveGroups,\n\t\tsharedGroups,\n\t\tcontainers,\n\t\trunningContainers,\n\t\tnetworks,\n\t\tvolumes,\n\t\timages,\n\t};\n};\n\nexport const summarizePruneGroupsForResources = (\n\tgroups: ReadonlyArray<PruneGroup>,\n\tresources: PruneResourceScope,\n): PruneTotals => {\n\tconst totals = summarizePruneGroups(groups);\n\treturn {\n\t\t...totals,\n\t\tcontainers: resources.containers ? totals.containers : 0,\n\t\trunningContainers: resources.containers ? totals.runningContainers : 0,\n\t\tnetworks: resources.networks ? totals.networks : 0,\n\t\tvolumes: resources.volumes ? totals.volumes : 0,\n\t\timages: resources.images ? totals.images : 0,\n\t};\n};\n\nexport const hasPruneResources = (resources: PruneResourceScope): boolean =>\n\tresources.containers || resources.networks || resources.volumes || resources.images;\n\nexport const groupResourceCountForResources = (\n\tgroup: PruneGroup,\n\tresources: PruneResourceScope,\n): number =>\n\t(resources.containers ? group.containers : 0) +\n\t(resources.networks ? group.networks : 0) +\n\t(resources.volumes ? group.volumes : 0) +\n\t(resources.images ? group.images : 0);\n\nconst isAutoPrunableSharedGroup = (group: PruneGroup): boolean =>\n\tgroup.app === ROUTER_SHARED_APP && group.stack.startsWith(ROUTER_CONTAINER_NAME_PREFIX);\n\nexport const defaultPruneSelection = (\n\tinventory: PruneInventory,\n\tresources: PruneResourceScope = DEFAULT_PRUNE_RESOURCES,\n): ReadonlyArray<string> =>\n\tinventory.groups\n\t\t.filter(\n\t\t\t(group) =>\n\t\t\t\t!group.live &&\n\t\t\t\t(!group.shared || isAutoPrunableSharedGroup(group)) &&\n\t\t\t\tgroupResourceCountForResources(group, resources) > 0,\n\t\t)\n\t\t.map((group) => group.key);\n\nconst requireBulkConfirm = (verb: string, ctx: CommandContext): Effect.Effect<void, CliError> => {\n\tif (ctx.flags.dryRun) return Effect.void;\n\tif (ctx.flags.confirm.assumeYes) return Effect.void;\n\treturn Effect.fail(\n\t\tnew CliConfirmRequiredError({\n\t\t\tverb,\n\t\t\thint: 'rerun with --yes for non-interactive bulk prune, or omit --all in a TTY to pick rows interactively',\n\t\t}),\n\t);\n};\n\nconst requireInteractive = (ctx: CommandContext): Effect.Effect<void, CliError> => {\n\tif (ctx.flags.confirm.stdinIsTty && !ctx.flags.confirm.forbidPrompt) return Effect.void;\n\treturn Effect.fail(\n\t\tnew CliConfirmRequiredError({\n\t\t\tverb: 'prune',\n\t\t\thint: 'use --list, --dry-run, or --all --yes in non-interactive shells',\n\t\t}),\n\t);\n};\n\nconst formatGroupLine = (group: PruneGroup): string => {\n\tconst state =\n\t\tgroup.live && group.livePids.length > 0\n\t\t\t? `live pid ${group.livePids.join(',')}`\n\t\t\t: group.live\n\t\t\t\t? 'live'\n\t\t\t\t: group.shared\n\t\t\t\t\t? 'shared'\n\t\t\t\t\t: 'idle';\n\tconst running = group.runningContainers > 0 ? `, ${group.runningContainers} running` : '';\n\tconst images = group.images > 0 ? `, ${group.images} image(s)` : '';\n\treturn `  ${group.app}/${group.stack}  ${state}  ${group.containers} container(s)${running}, ${group.networks} network(s), ${group.volumes} volume(s)${images}`;\n};\n\nconst inventoryLines = (inventory: PruneInventory): ReadonlyArray<string> => {\n\tif (inventory.groups.length === 0) return ['(no devstack-labelled Docker resources)'];\n\treturn [\n\t\t`devstack prune inventory: ${inventory.totals.groups} group(s), ${inventory.totals.containers} container(s), ${inventory.totals.networks} network(s), ${inventory.totals.volumes} volume(s), ${inventory.totals.images} image(s)`,\n\t\t...inventory.groups.map(formatGroupLine),\n\t];\n};\n\nconst completedLine = (summary: PruneSummary, dryRun: boolean): string => {\n\tconst prefix = dryRun ? '[dry-run] would prune' : 'prune completed';\n\tconst skippedNetworks =\n\t\tsummary.networksSkipped > 0 ? `, ${summary.networksSkipped} network(s) still in use` : '';\n\treturn `${prefix}: ${summary.selectedGroups} group(s), ${summary.containersRemoved} container(s), ${summary.networksRemoved} network(s), ${summary.volumesRemoved} volume(s), ${summary.imagesRemoved} image(s), ${summary.skippedLiveGroups} live group(s) skipped${skippedNetworks}`;\n};\n\nconst mapUnknownPruneError = (cause: unknown): Effect.Effect<never, CliError> =>\n\tisCliError(cause)\n\t\t? Effect.fail(cause)\n\t\t: Effect.fail(new CliInternalError({ message: 'prune failed', cause }));\n\nexport const runPrune = (\n\tdeps: PruneDeps,\n\tctx: CommandContext,\n\toptions: PruneRunOptions = { mode: 'auto', resources: DEFAULT_PRUNE_RESOURCES },\n): Effect.Effect<CommandResult, CliError> =>\n\tEffect.gen(function* () {\n\t\tconst started = Date.now();\n\t\tconst inventory = yield* deps.inventory().pipe(Effect.catch(mapUnknownPruneError));\n\n\t\tif (options.mode === 'list') {\n\t\t\tyield* emitSuccess(ctx.io, ctx.flags.outputMode, {\n\t\t\t\tcommand: 'prune',\n\t\t\t\telapsedMs: Date.now() - started,\n\t\t\t\tdryRun: true,\n\t\t\t\tdata: { mode: 'list' as const, inventory },\n\t\t\t\thumanLines: inventoryLines(inventory),\n\t\t\t});\n\t\t\treturn { exitCode: 0 } as CommandResult;\n\t\t}\n\n\t\tif (!hasPruneResources(options.resources)) {\n\t\t\treturn yield* Effect.fail(\n\t\t\t\tnew CliUsageError({\n\t\t\t\t\tmessage: 'prune requires at least one resource type',\n\t\t\t\t\thint: 'enable containers, networks, volumes, or images',\n\t\t\t\t}),\n\t\t\t);\n\t\t}\n\n\t\tlet selected: PruneTargetSelection;\n\t\tif (ctx.flags.dryRun || options.mode === 'all' || ctx.flags.confirm.assumeYes) {\n\t\t\tyield* requireBulkConfirm('prune', ctx);\n\t\t\tselected = {\n\t\t\t\tgroupKeys: defaultPruneSelection(inventory, options.resources),\n\t\t\t\tresources: options.resources,\n\t\t\t};\n\t\t} else {\n\t\t\tyield* requireInteractive(ctx);\n\t\t\tselected = yield* deps\n\t\t\t\t.select(inventory, options.resources)\n\t\t\t\t.pipe(Effect.catch(mapUnknownPruneError));\n\t\t}\n\n\t\tif (!hasPruneResources(selected.resources)) {\n\t\t\treturn yield* Effect.fail(\n\t\t\t\tnew CliUsageError({\n\t\t\t\t\tmessage: 'prune requires at least one selected resource type',\n\t\t\t\t\thint: 'toggle at least one resource type before confirming',\n\t\t\t\t}),\n\t\t\t);\n\t\t}\n\n\t\tif (selected.groupKeys.length === 0) {\n\t\t\tyield* emitSuccess(ctx.io, ctx.flags.outputMode, {\n\t\t\t\tcommand: 'prune',\n\t\t\t\telapsedMs: Date.now() - started,\n\t\t\t\tdryRun: ctx.flags.dryRun,\n\t\t\t\tdata: {\n\t\t\t\t\tmode: options.mode,\n\t\t\t\t\tdryRun: ctx.flags.dryRun,\n\t\t\t\t\tinventory,\n\t\t\t\t\tselection: selected,\n\t\t\t\t\toutcome: {\n\t\t\t\t\t\tkind: 'completed' as const,\n\t\t\t\t\t\tsummary: {\n\t\t\t\t\t\t\tinspectedGroups: inventory.groups.length,\n\t\t\t\t\t\t\tselectedGroups: 0,\n\t\t\t\t\t\t\tskippedLiveGroups: inventory.totals.liveGroups,\n\t\t\t\t\t\t\tcontainersRemoved: 0,\n\t\t\t\t\t\t\tnetworksRemoved: 0,\n\t\t\t\t\t\t\tnetworksSkipped: 0,\n\t\t\t\t\t\t\tvolumesRemoved: 0,\n\t\t\t\t\t\t\timagesRemoved: 0,\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\thumanLines: ['prune: no idle resource groups selected'],\n\t\t\t});\n\t\t\treturn { exitCode: 0 } as CommandResult;\n\t\t}\n\n\t\tconst outcome = yield* deps\n\t\t\t.prune({\n\t\t\t\tgroupKeys: selected.groupKeys,\n\t\t\t\tresources: selected.resources,\n\t\t\t\tdryRun: ctx.flags.dryRun,\n\t\t\t})\n\t\t\t.pipe(Effect.catch(mapUnknownPruneError));\n\n\t\tyield* emitSuccess(ctx.io, ctx.flags.outputMode, {\n\t\t\tcommand: 'prune',\n\t\t\telapsedMs: Date.now() - started,\n\t\t\tdryRun: ctx.flags.dryRun,\n\t\t\tdata: {\n\t\t\t\tmode: options.mode,\n\t\t\t\tdryRun: ctx.flags.dryRun,\n\t\t\t\tinventory,\n\t\t\t\tselection: selected,\n\t\t\t\toutcome,\n\t\t\t},\n\t\t\thumanLines: [completedLine(outcome.summary, ctx.flags.dryRun)],\n\t\t});\n\t\treturn { exitCode: 0 } as CommandResult;\n\t}).pipe(Effect.withSpan('cli.prune'));\n"],"mappings":"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"}
+{"version":3,"file":"prune.mjs","names":[],"sources":["../../../../src/surfaces/cli/commands/prune.ts"],"sourcesContent":["// CLI verb: `devstack prune` — cross-stack Docker cleanup.\n//\n// The rewrite initially wired this command to snapshot-catalog prune\n// only. That path can report success while leaving ordinary stale\n// containers, networks, and volumes untouched. This command owns the\n// operator surface; production injects a Docker-label inventory and\n// remover that understand both current labels and pre-rewrite labels.\n\nimport { Effect } from 'effect';\n\nimport {\n\tdefaultLifecyclePruneSelection,\n\tDEFAULT_LIFECYCLE_PRUNE_RESOURCES,\n\tlifecyclePruneAppsWithLiveSiblings,\n\ttype SharedGroupKind,\n} from '../../../orchestrators/lifecycle-prune/index.ts';\nimport {\n\ttype CliError,\n\tCliConfirmRequiredError,\n\tCliInternalError,\n\tCliUsageError,\n\tisCliError,\n} from '../errors.ts';\nimport { emitSuccess } from '../output.ts';\nimport type { CommandContext, CommandResult } from './index.ts';\n\nexport interface PruneGroup {\n\treadonly key: string;\n\treadonly app: string;\n\treadonly stack: string;\n\treadonly live: boolean;\n\treadonly livePids: ReadonlyArray<number>;\n\treadonly shared: boolean;\n\t/** Discriminator for shared groups — mirrored from the L3 orchestrator\n\t *  shape so surfaces never re-derive the `_per-app_` / router-singleton\n\t *  predicate. `null` for normal groups. */\n\treadonly sharedKind: SharedGroupKind | null;\n\t/** True when the group represents a router-shared resource set that\n\t *  is auto-prunable in non-interactive flows (`devstack prune --all`).\n\t *  Computed by the lifecycle-prune orchestrator; surfaces never\n\t *  recompute the router-stack naming predicate. */\n\treadonly autoPrunable: boolean;\n\treadonly containers: number;\n\treadonly runningContainers: number;\n\treadonly networks: number;\n\treadonly volumes: number;\n\treadonly images: number;\n}\n\nexport interface PruneTotals {\n\treadonly groups: number;\n\treadonly liveGroups: number;\n\treadonly sharedGroups: number;\n\treadonly containers: number;\n\treadonly runningContainers: number;\n\treadonly networks: number;\n\treadonly volumes: number;\n\treadonly images: number;\n}\n\nexport interface PruneInventory {\n\treadonly groups: ReadonlyArray<PruneGroup>;\n\treadonly totals: PruneTotals;\n}\n\nexport interface PruneResourceScope {\n\treadonly containers: boolean;\n\treadonly networks: boolean;\n\treadonly volumes: boolean;\n\treadonly images: boolean;\n}\n\nexport interface PruneTargetSelection {\n\treadonly groupKeys: ReadonlyArray<string>;\n\treadonly resources: PruneResourceScope;\n}\n\nexport interface PruneSelection extends PruneTargetSelection {\n\treadonly dryRun: boolean;\n}\n\n/** One non-devstack container still holding a network that prune\n *  could not remove. Surfaced so the operator can investigate the\n *  external holder (typically a test fixture, a sibling project's\n *  container, or a manually-attached debugging container). */\nexport interface PruneForeignNetworkHolder {\n\treadonly network: string;\n\treadonly container: { readonly id: string; readonly name: string };\n}\n\n/** Endpoint Docker still tracks on a network even though the owning\n *  container is gone and no CLI/API path can remove it. Docker engine\n *  bug — only a daemon restart reclaims the network. */\nexport interface PruneStaleNetworkEndpoint {\n\treadonly network: string;\n\treadonly name: string;\n\treadonly id: string;\n}\n\nexport interface PruneSummary {\n\treadonly inspectedGroups: number;\n\treadonly selectedGroups: number;\n\treadonly skippedLiveGroups: number;\n\treadonly containersRemoved: number;\n\treadonly networksRemoved: number;\n\treadonly networksSkipped: number;\n\treadonly volumesRemoved: number;\n\treadonly imagesRemoved: number;\n\t/** Foreign holders surviving network removal. Empty when every\n\t *  network came down cleanly or no network removal was attempted. */\n\treadonly foreignNetworkHolders: ReadonlyArray<PruneForeignNetworkHolder>;\n\t/** Stale phantom endpoints requiring a Docker daemon restart to\n\t *  reclaim. Empty in the happy path. */\n\treadonly staleNetworkEndpoints: ReadonlyArray<PruneStaleNetworkEndpoint>;\n}\n\nexport type PruneOutcome = { readonly kind: 'completed'; readonly summary: PruneSummary };\n\nexport interface PruneDeps {\n\treadonly inventory: () => Effect.Effect<PruneInventory, unknown>;\n\treadonly prune: (selection: PruneSelection) => Effect.Effect<PruneOutcome, unknown>;\n\treadonly select: (\n\t\tinventory: PruneInventory,\n\t\tresources: PruneResourceScope,\n\t) => Effect.Effect<PruneTargetSelection, unknown>;\n}\n\nexport interface PruneRunOptions {\n\treadonly mode: 'auto' | 'list' | 'all';\n\treadonly resources: PruneResourceScope;\n}\n\n/** L4 mirror of the orchestrator's default resource scope. Re-export\n *  rather than redefine so the default never drifts between layers. */\nexport const DEFAULT_PRUNE_RESOURCES: PruneResourceScope = DEFAULT_LIFECYCLE_PRUNE_RESOURCES;\n\nexport const summarizePruneGroups = (groups: ReadonlyArray<PruneGroup>): PruneTotals => {\n\tlet liveGroups = 0;\n\tlet sharedGroups = 0;\n\tlet containers = 0;\n\tlet runningContainers = 0;\n\tlet networks = 0;\n\tlet volumes = 0;\n\tlet images = 0;\n\tfor (const group of groups) {\n\t\tif (group.live) liveGroups += 1;\n\t\tif (group.shared) sharedGroups += 1;\n\t\tcontainers += group.containers;\n\t\trunningContainers += group.runningContainers;\n\t\tnetworks += group.networks;\n\t\tvolumes += group.volumes;\n\t\timages += group.images;\n\t}\n\treturn {\n\t\tgroups: groups.length,\n\t\tliveGroups,\n\t\tsharedGroups,\n\t\tcontainers,\n\t\trunningContainers,\n\t\tnetworks,\n\t\tvolumes,\n\t\timages,\n\t};\n};\n\nexport const summarizePruneGroupsForResources = (\n\tgroups: ReadonlyArray<PruneGroup>,\n\tresources: PruneResourceScope,\n): PruneTotals => {\n\tconst totals = summarizePruneGroups(groups);\n\treturn {\n\t\t...totals,\n\t\tcontainers: resources.containers ? totals.containers : 0,\n\t\trunningContainers: resources.containers ? totals.runningContainers : 0,\n\t\tnetworks: resources.networks ? totals.networks : 0,\n\t\tvolumes: resources.volumes ? totals.volumes : 0,\n\t\timages: resources.images ? totals.images : 0,\n\t};\n};\n\nexport const hasPruneResources = (resources: PruneResourceScope): boolean =>\n\tresources.containers || resources.networks || resources.volumes || resources.images;\n\nexport const groupResourceCountForResources = (\n\tgroup: PruneGroup,\n\tresources: PruneResourceScope,\n): number =>\n\t(resources.containers ? group.containers : 0) +\n\t(resources.networks ? group.networks : 0) +\n\t(resources.volumes ? group.volumes : 0) +\n\t(resources.images ? group.images : 0);\n\n/** L4 mirror — defers to the orchestrator's pinning predicate so the\n *  shared-resource rule lives in exactly one place. Exported so the\n *  interactive picker enforces the same per-app-shared pinning rule\n *  the default selection already obeys (manual toggle / select-all must\n *  not add a `per-app-shared` group pinned by a live sibling). */\nexport const appsWithLiveSiblings = (inventory: PruneInventory): ReadonlySet<string> =>\n\tlifecyclePruneAppsWithLiveSiblings(inventory);\n\n/** Delegates to the orchestrator's `defaultLifecyclePruneSelection`.\n *  The L4 shape mirrors the L3 shape field-for-field; the surface\n *  never reimplements the shared/per-app/router policy. */\nexport const defaultPruneSelection = (\n\tinventory: PruneInventory,\n\tresources: PruneResourceScope = DEFAULT_PRUNE_RESOURCES,\n): ReadonlyArray<string> => defaultLifecyclePruneSelection(inventory, resources);\n\nconst requireBulkConfirm = (verb: string, ctx: CommandContext): Effect.Effect<void, CliError> => {\n\tif (ctx.flags.dryRun) return Effect.void;\n\tif (ctx.flags.confirm.assumeYes) return Effect.void;\n\treturn Effect.fail(\n\t\tnew CliConfirmRequiredError({\n\t\t\tverb,\n\t\t\thint: 'rerun with --yes for non-interactive bulk prune, or omit --all in a TTY to pick rows interactively',\n\t\t}),\n\t);\n};\n\nconst requireInteractive = (ctx: CommandContext): Effect.Effect<void, CliError> => {\n\tif (ctx.flags.confirm.stdinIsTty && !ctx.flags.confirm.forbidPrompt) return Effect.void;\n\treturn Effect.fail(\n\t\tnew CliConfirmRequiredError({\n\t\t\tverb: 'prune',\n\t\t\thint: 'use --list, --dry-run, or --all --yes in non-interactive shells',\n\t\t}),\n\t);\n};\n\nconst formatGroupLine = (group: PruneGroup, pinnedApps: ReadonlySet<string>): string => {\n\tconst state =\n\t\tgroup.live && group.livePids.length > 0\n\t\t\t? `live pid ${group.livePids.join(',')}`\n\t\t\t: group.live\n\t\t\t\t? 'live'\n\t\t\t\t: group.sharedKind === 'per-app-shared'\n\t\t\t\t\t? pinnedApps.has(group.app)\n\t\t\t\t\t\t? 'shared (pinned by live sibling)'\n\t\t\t\t\t\t: 'shared (auto)'\n\t\t\t\t\t: group.shared\n\t\t\t\t\t\t? group.autoPrunable\n\t\t\t\t\t\t\t? 'shared (auto)'\n\t\t\t\t\t\t\t: 'shared'\n\t\t\t\t\t\t: 'idle';\n\tconst running = group.runningContainers > 0 ? `, ${group.runningContainers} running` : '';\n\tconst images = group.images > 0 ? `, ${group.images} image(s)` : '';\n\treturn `  ${group.app}/${group.stack}  ${state}  ${group.containers} container(s)${running}, ${group.networks} network(s), ${group.volumes} volume(s)${images}`;\n};\n\nconst inventoryLines = (inventory: PruneInventory): ReadonlyArray<string> => {\n\tif (inventory.groups.length === 0) return ['(no devstack-labelled Docker resources)'];\n\tconst pinned = appsWithLiveSiblings(inventory);\n\treturn [\n\t\t`devstack prune inventory: ${inventory.totals.groups} group(s), ${inventory.totals.containers} container(s), ${inventory.totals.networks} network(s), ${inventory.totals.volumes} volume(s), ${inventory.totals.images} image(s)`,\n\t\t...inventory.groups.map((g) => formatGroupLine(g, pinned)),\n\t];\n};\n\nconst completedLines = (summary: PruneSummary, dryRun: boolean): ReadonlyArray<string> => {\n\tconst prefix = dryRun ? '[dry-run] would prune' : 'prune completed';\n\tconst skippedNetworks =\n\t\tsummary.networksSkipped > 0 ? `, ${summary.networksSkipped} network(s) still in use` : '';\n\tconst head = `${prefix}: ${summary.selectedGroups} group(s), ${summary.containersRemoved} container(s), ${summary.networksRemoved} network(s), ${summary.volumesRemoved} volume(s), ${summary.imagesRemoved} image(s), ${summary.skippedLiveGroups} live group(s) skipped${skippedNetworks}`;\n\tconst lines: Array<string> = [head];\n\tif (summary.foreignNetworkHolders.length > 0) {\n\t\tlines.push('foreign network holders:');\n\t\tfor (const h of summary.foreignNetworkHolders) {\n\t\t\tlines.push(`  ${h.network} held by ${h.container.name} (${h.container.id.slice(0, 12)})`);\n\t\t}\n\t}\n\tif (summary.staleNetworkEndpoints.length > 0) {\n\t\tlines.push(\n\t\t\t'stale endpoints (Docker engine bug — restart Docker Desktop to reclaim these networks):',\n\t\t);\n\t\tfor (const ep of summary.staleNetworkEndpoints) {\n\t\t\tlines.push(`  ${ep.network}: phantom endpoint \"${ep.name}\" (${ep.id.slice(0, 12)})`);\n\t\t}\n\t}\n\treturn lines;\n};\n\nconst mapUnknownPruneError = (cause: unknown): Effect.Effect<never, CliError> =>\n\tisCliError(cause)\n\t\t? Effect.fail(cause)\n\t\t: Effect.fail(new CliInternalError({ message: 'prune failed', cause }));\n\nexport const runPrune = (\n\tdeps: PruneDeps,\n\tctx: CommandContext,\n\toptions: PruneRunOptions = { mode: 'auto', resources: DEFAULT_PRUNE_RESOURCES },\n): Effect.Effect<CommandResult, CliError> =>\n\tEffect.gen(function* () {\n\t\tconst started = Date.now();\n\t\tconst inventory = yield* deps.inventory().pipe(Effect.catch(mapUnknownPruneError));\n\n\t\tif (options.mode === 'list') {\n\t\t\tyield* emitSuccess(ctx.io, ctx.flags.outputMode, {\n\t\t\t\tcommand: 'prune',\n\t\t\t\telapsedMs: Date.now() - started,\n\t\t\t\tdryRun: true,\n\t\t\t\tdata: { mode: 'list' as const, inventory },\n\t\t\t\thumanLines: inventoryLines(inventory),\n\t\t\t});\n\t\t\treturn { exitCode: 0 } as CommandResult;\n\t\t}\n\n\t\tif (!hasPruneResources(options.resources)) {\n\t\t\treturn yield* Effect.fail(\n\t\t\t\tnew CliUsageError({\n\t\t\t\t\tmessage: 'prune requires at least one resource type',\n\t\t\t\t\thint: 'enable containers, networks, volumes, or images',\n\t\t\t\t}),\n\t\t\t);\n\t\t}\n\n\t\tlet selected: PruneTargetSelection;\n\t\tif (ctx.flags.dryRun || options.mode === 'all' || ctx.flags.confirm.assumeYes) {\n\t\t\tyield* requireBulkConfirm('prune', ctx);\n\t\t\tselected = {\n\t\t\t\tgroupKeys: defaultPruneSelection(inventory, options.resources),\n\t\t\t\tresources: options.resources,\n\t\t\t};\n\t\t} else {\n\t\t\tyield* requireInteractive(ctx);\n\t\t\tselected = yield* deps\n\t\t\t\t.select(inventory, options.resources)\n\t\t\t\t.pipe(Effect.catch(mapUnknownPruneError));\n\t\t}\n\n\t\tif (!hasPruneResources(selected.resources)) {\n\t\t\treturn yield* Effect.fail(\n\t\t\t\tnew CliUsageError({\n\t\t\t\t\tmessage: 'prune requires at least one selected resource type',\n\t\t\t\t\thint: 'toggle at least one resource type before confirming',\n\t\t\t\t}),\n\t\t\t);\n\t\t}\n\n\t\tif (selected.groupKeys.length === 0) {\n\t\t\tyield* emitSuccess(ctx.io, ctx.flags.outputMode, {\n\t\t\t\tcommand: 'prune',\n\t\t\t\telapsedMs: Date.now() - started,\n\t\t\t\tdryRun: ctx.flags.dryRun,\n\t\t\t\tdata: {\n\t\t\t\t\tmode: options.mode,\n\t\t\t\t\tdryRun: ctx.flags.dryRun,\n\t\t\t\t\tinventory,\n\t\t\t\t\tselection: selected,\n\t\t\t\t\toutcome: {\n\t\t\t\t\t\tkind: 'completed' as const,\n\t\t\t\t\t\tsummary: {\n\t\t\t\t\t\t\tinspectedGroups: inventory.groups.length,\n\t\t\t\t\t\t\tselectedGroups: 0,\n\t\t\t\t\t\t\tskippedLiveGroups: inventory.totals.liveGroups,\n\t\t\t\t\t\t\tcontainersRemoved: 0,\n\t\t\t\t\t\t\tnetworksRemoved: 0,\n\t\t\t\t\t\t\tnetworksSkipped: 0,\n\t\t\t\t\t\t\tvolumesRemoved: 0,\n\t\t\t\t\t\t\timagesRemoved: 0,\n\t\t\t\t\t\t\tforeignNetworkHolders: [],\n\t\t\t\t\t\t\tstaleNetworkEndpoints: [],\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\thumanLines: ['prune: no idle resource groups selected'],\n\t\t\t});\n\t\t\treturn { exitCode: 0 } as CommandResult;\n\t\t}\n\n\t\tconst outcome = yield* deps\n\t\t\t.prune({\n\t\t\t\tgroupKeys: selected.groupKeys,\n\t\t\t\tresources: selected.resources,\n\t\t\t\tdryRun: ctx.flags.dryRun,\n\t\t\t})\n\t\t\t.pipe(Effect.catch(mapUnknownPruneError));\n\n\t\tyield* emitSuccess(ctx.io, ctx.flags.outputMode, {\n\t\t\tcommand: 'prune',\n\t\t\telapsedMs: Date.now() - started,\n\t\t\tdryRun: ctx.flags.dryRun,\n\t\t\tdata: {\n\t\t\t\tmode: options.mode,\n\t\t\t\tdryRun: ctx.flags.dryRun,\n\t\t\t\tinventory,\n\t\t\t\tselection: selected,\n\t\t\t\toutcome,\n\t\t\t},\n\t\t\thumanLines: completedLines(outcome.summary, ctx.flags.dryRun),\n\t\t});\n\t\treturn { exitCode: 0 } as CommandResult;\n\t}).pipe(Effect.withSpan('cli.prune'));\n"],"mappings":"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"}

package/dist/surfaces/cli/commands/status.mjs

@@ -66,7 +66,7 @@ const runStatus = (deps, ctx) => Effect.gen(function* () {
 	const started = Date.now();
 	const app = ctx.flags.app ?? "";
 	const stack = ctx.flags.stack ?? "";
-	const data = buildStatusPayload(yield* deps.reader.readState(app, stack));
+	const data = buildStatusPayload(yield* deps.reader.readState());
 	const elapsedMs = Date.now() - started;
 	const humanLines = [];
 	if (!data.present) humanLines.push(`status: no state present for ${app || "(no app)"} / ${stack || "(no stack)"}`);
@@ -90,6 +90,6 @@ const runStatus = (deps, ctx) => Effect.gen(function* () {
 	return { exitCode: 0 };
 }).pipe(Effect.withSpan("cli.status"));
 //#endregion
-export { runStatus };
+export { buildStatusPayload, runStatus };
 
 //# sourceMappingURL=status.mjs.map

package/dist/surfaces/cli/commands/status.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"status.mjs","names":[],"sources":["../../../../src/surfaces/cli/commands/status.ts"],"sourcesContent":["// CLI verb: `devstack status` — observational read of stack state.\n//\n// Architecture (distilled/20-cli.md § Subcommands § Lifecycle):\n//   \"status — observational read of stack state, manifest, and (if\n//    present) fork meta.\"\n//\n// Surface invariant: status MUST tolerate missing/malformed state\n// files. It describes what IS, not what should be. The architecture\n// explicitly calls this out — throwing on a stack that hasn't been\n// brought up would be a regression.\n\nimport { Effect } from 'effect';\n\nimport type { SubscribableState } from '../../../substrate/projection.ts';\nimport type { CliError } from '../errors.ts';\nimport { emitSuccess } from '../output.ts';\nimport type { CommandContext, CommandResult } from './index.ts';\n\n/** Pure projection: `SubscribableState` → JSON-safe status blob.\n *  Never leaks substrate types. */\nexport const buildStatusPayload = (state: SubscribableState | null) => {\n\tif (state === null) {\n\t\treturn {\n\t\t\tpresent: false as const,\n\t\t\tidentity: null,\n\t\t\tcycle: null,\n\t\t\trowCount: 0,\n\t\t\tendpointCount: 0,\n\t\t\taccountCount: 0,\n\t\t\tpackageCount: 0,\n\t\t\terrorCount: 0,\n\t\t};\n\t}\n\treturn {\n\t\tpresent: true as const,\n\t\tidentity: { ...state.identity },\n\t\tcycle: { ...state.cycle },\n\t\trowCount: state.rows.length,\n\t\tendpointCount: state.endpoints.length,\n\t\taccountCount: state.accounts.length,\n\t\tpackageCount: state.packages.length,\n\t\terrorCount: state.errors.length,\n\t\trows: state.rows.map((r) => ({\n\t\t\tkey: r.key as string,\n\t\t\trole: r.role,\n\t\t\tstatus: r.status,\n\t\t\tphase: r.phase,\n\t\t\tlastErrorTag: r.lastError?.tag ?? null,\n\t\t})),\n\t\tendpoints: state.endpoints.map((e) => ({\n\t\t\tendpointKey: e.endpointKey as string,\n\t\t\tname: e.name,\n\t\t\turl: e.displayUrl ?? e.url,\n\t\t})),\n\t\taccounts: state.accounts.map((account) => ({\n\t\t\tkey: account.key,\n\t\t\trowKey: account.rowKey,\n\t\t\tname: account.name,\n\t\t\taddress: account.address,\n\t\t\tscheme: account.scheme,\n\t\t\tsource: account.source,\n\t\t\tfunding: { ...account.funding },\n\t\t\twalletVisible: account.walletVisible,\n\t\t})),\n\t\tpackages: state.packages.map((pkg) => ({\n\t\t\tkey: pkg.key,\n\t\t\trowKey: pkg.rowKey,\n\t\t\tname: pkg.name,\n\t\t\tkind: pkg.kind,\n\t\t\tpackageId: pkg.packageId,\n\t\t\tupgradeCapId: pkg.upgradeCapId,\n\t\t\tmvrPlaceholder: pkg.mvrPlaceholder,\n\t\t\tsourcePath: pkg.sourcePath,\n\t\t})),\n\t};\n};\n\n/**\n * Status reader interface. The dispatcher wires this to the\n * substrate's projection ref via a thin reader; tests pass a stub.\n * The CLI never calls engine methods directly — it reads the same\n * projection any peer surface (TUI, programmable API) sees.\n */\nexport interface StatusReader {\n\t/** Resolve current projection for `(app, stack)`. Returns `null`\n\t *  if no state has been written yet — that is a normal, tolerated\n\t *  state for a freshly-defined stack. */\n\treadonly readState: (app: string, stack: string) => Effect.Effect<SubscribableState | null>;\n}\n\nexport interface StatusDeps {\n\treadonly reader: StatusReader;\n}\n\n/**\n * Run `devstack status`. Tolerant of missing state. Always succeeds\n * (returns ok=true) unless the projection read itself raises (which\n * the reader contractually swallows for missing files).\n */\nexport const runStatus = (\n\tdeps: StatusDeps,\n\tctx: CommandContext,\n): Effect.Effect<CommandResult, CliError> =>\n\tEffect.gen(function* () {\n\t\tconst started = Date.now();\n\t\t// Resolve `(app, stack)` from flags. The dispatcher seeds these\n\t\t// from the precedence chain; if both are absent we still render\n\t\t// (the projection reader returns `null`).\n\t\tconst app = ctx.flags.app ?? '';\n\t\tconst stack = ctx.flags.stack ?? '';\n\t\tconst state = yield* deps.reader.readState(app, stack);\n\t\tconst data = buildStatusPayload(state);\n\t\tconst elapsedMs = Date.now() - started;\n\n\t\tconst humanLines: Array<string> = [];\n\t\tif (!data.present) {\n\t\t\thumanLines.push(\n\t\t\t\t`status: no state present for ${app || '(no app)'} / ${stack || '(no stack)'}`,\n\t\t\t);\n\t\t} else {\n\t\t\thumanLines.push(`app:     ${data.identity!.app}`);\n\t\t\thumanLines.push(`stack:   ${data.identity!.stack}`);\n\t\t\thumanLines.push(`network: ${data.identity!.network}`);\n\t\t\thumanLines.push(`cycle:   #${data.cycle!.id} ${data.cycle!.phase}`);\n\t\t\thumanLines.push(`rows:    ${data.rowCount}`);\n\t\t\thumanLines.push(`endpoints: ${data.endpointCount}`);\n\t\t\thumanLines.push(`accounts: ${data.accountCount}`);\n\t\t\thumanLines.push(`packages: ${data.packageCount}`);\n\t\t\thumanLines.push(`errors:  ${data.errorCount}`);\n\t\t}\n\n\t\tyield* emitSuccess(ctx.io, ctx.flags.outputMode, {\n\t\t\tcommand: 'status',\n\t\t\telapsedMs,\n\t\t\tdata,\n\t\t\thumanLines,\n\t\t});\n\t\treturn { exitCode: 0 } as CommandResult;\n\t}).pipe(Effect.withSpan('cli.status'));\n"],"mappings":";;;;;AAoBA,MAAa,sBAAsB,UAAoC;AACtE,KAAI,UAAU,KACb,QAAO;EACN,SAAS;EACT,UAAU;EACV,OAAO;EACP,UAAU;EACV,eAAe;EACf,cAAc;EACd,cAAc;EACd,YAAY;EACZ;AAEF,QAAO;EACN,SAAS;EACT,UAAU,EAAE,GAAG,MAAM,UAAU;EAC/B,OAAO,EAAE,GAAG,MAAM,OAAO;EACzB,UAAU,MAAM,KAAK;EACrB,eAAe,MAAM,UAAU;EAC/B,cAAc,MAAM,SAAS;EAC7B,cAAc,MAAM,SAAS;EAC7B,YAAY,MAAM,OAAO;EACzB,MAAM,MAAM,KAAK,KAAK,OAAO;GAC5B,KAAK,EAAE;GACP,MAAM,EAAE;GACR,QAAQ,EAAE;GACV,OAAO,EAAE;GACT,cAAc,EAAE,WAAW,OAAO;GAClC,EAAE;EACH,WAAW,MAAM,UAAU,KAAK,OAAO;GACtC,aAAa,EAAE;GACf,MAAM,EAAE;GACR,KAAK,EAAE,cAAc,EAAE;GACvB,EAAE;EACH,UAAU,MAAM,SAAS,KAAK,aAAa;GAC1C,KAAK,QAAQ;GACb,QAAQ,QAAQ;GAChB,MAAM,QAAQ;GACd,SAAS,QAAQ;GACjB,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB,SAAS,EAAE,GAAG,QAAQ,SAAS;GAC/B,eAAe,QAAQ;GACvB,EAAE;EACH,UAAU,MAAM,SAAS,KAAK,SAAS;GACtC,KAAK,IAAI;GACT,QAAQ,IAAI;GACZ,MAAM,IAAI;GACV,MAAM,IAAI;GACV,WAAW,IAAI;GACf,cAAc,IAAI;GAClB,gBAAgB,IAAI;GACpB,YAAY,IAAI;GAChB,EAAE;EACH;;;;;;;AAyBF,MAAa,aACZ,MACA,QAEA,OAAO,IAAI,aAAa;CACvB,MAAM,UAAU,KAAK,KAAK;CAI1B,MAAM,MAAM,IAAI,MAAM,OAAO;CAC7B,MAAM,QAAQ,IAAI,MAAM,SAAS;CAEjC,MAAM,OAAO,mBAAmB,OADX,KAAK,OAAO,UAAU,KAAK,MAAM,CAChB;CACtC,MAAM,YAAY,KAAK,KAAK,GAAG;CAE/B,MAAM,aAA4B,EAAE;AACpC,KAAI,CAAC,KAAK,QACT,YAAW,KACV,gCAAgC,OAAO,WAAW,KAAK,SAAS,eAChE;MACK;AACN,aAAW,KAAK,YAAY,KAAK,SAAU,MAAM;AACjD,aAAW,KAAK,YAAY,KAAK,SAAU,QAAQ;AACnD,aAAW,KAAK,YAAY,KAAK,SAAU,UAAU;AACrD,aAAW,KAAK,aAAa,KAAK,MAAO,GAAG,GAAG,KAAK,MAAO,QAAQ;AACnE,aAAW,KAAK,YAAY,KAAK,WAAW;AAC5C,aAAW,KAAK,cAAc,KAAK,gBAAgB;AACnD,aAAW,KAAK,aAAa,KAAK,eAAe;AACjD,aAAW,KAAK,aAAa,KAAK,eAAe;AACjD,aAAW,KAAK,YAAY,KAAK,aAAa;;AAG/C,QAAO,YAAY,IAAI,IAAI,IAAI,MAAM,YAAY;EAChD,SAAS;EACT;EACA;EACA;EACA,CAAC;AACF,QAAO,EAAE,UAAU,GAAG;EACrB,CAAC,KAAK,OAAO,SAAS,aAAa,CAAC"}
+{"version":3,"file":"status.mjs","names":[],"sources":["../../../../src/surfaces/cli/commands/status.ts"],"sourcesContent":["// CLI verb: `devstack status` — observational read of stack state.\n//\n// Architecture (distilled/20-cli.md § Subcommands § Lifecycle):\n//   \"status — observational read of stack state, manifest, and (if\n//    present) fork meta.\"\n//\n// Surface invariant: status MUST tolerate missing/malformed state\n// files. It describes what IS, not what should be. The architecture\n// explicitly calls this out — throwing on a stack that hasn't been\n// brought up would be a regression.\n\nimport { Effect } from 'effect';\n\nimport type { SubscribableState } from '../../../substrate/projection.ts';\nimport type { CliError } from '../errors.ts';\nimport { emitSuccess } from '../output.ts';\nimport type { CommandContext, CommandResult } from './index.ts';\n\n/** Pure projection: `SubscribableState` → JSON-safe status blob.\n *  Never leaks substrate types. */\nexport const buildStatusPayload = (state: SubscribableState | null) => {\n\tif (state === null) {\n\t\treturn {\n\t\t\tpresent: false as const,\n\t\t\tidentity: null,\n\t\t\tcycle: null,\n\t\t\trowCount: 0,\n\t\t\tendpointCount: 0,\n\t\t\taccountCount: 0,\n\t\t\tpackageCount: 0,\n\t\t\terrorCount: 0,\n\t\t};\n\t}\n\treturn {\n\t\tpresent: true as const,\n\t\tidentity: { ...state.identity },\n\t\tcycle: { ...state.cycle },\n\t\trowCount: state.rows.length,\n\t\tendpointCount: state.endpoints.length,\n\t\taccountCount: state.accounts.length,\n\t\tpackageCount: state.packages.length,\n\t\terrorCount: state.errors.length,\n\t\trows: state.rows.map((r) => ({\n\t\t\tkey: r.key as string,\n\t\t\trole: r.role,\n\t\t\tstatus: r.status,\n\t\t\tphase: r.phase,\n\t\t\tlastErrorTag: r.lastError?.tag ?? null,\n\t\t})),\n\t\tendpoints: state.endpoints.map((e) => ({\n\t\t\tendpointKey: e.endpointKey as string,\n\t\t\tname: e.name,\n\t\t\turl: e.displayUrl ?? e.url,\n\t\t})),\n\t\taccounts: state.accounts.map((account) => ({\n\t\t\tkey: account.key,\n\t\t\trowKey: account.rowKey,\n\t\t\tname: account.name,\n\t\t\taddress: account.address,\n\t\t\tscheme: account.scheme,\n\t\t\tsource: account.source,\n\t\t\tfunding: { ...account.funding },\n\t\t\twalletVisible: account.walletVisible,\n\t\t})),\n\t\tpackages: state.packages.map((pkg) => ({\n\t\t\tkey: pkg.key,\n\t\t\trowKey: pkg.rowKey,\n\t\t\tname: pkg.name,\n\t\t\tkind: pkg.kind,\n\t\t\tpackageId: pkg.packageId,\n\t\t\tupgradeCapId: pkg.upgradeCapId,\n\t\t\tmvrPlaceholder: pkg.mvrPlaceholder,\n\t\t\tsourcePath: pkg.sourcePath,\n\t\t})),\n\t};\n};\n\n/**\n * Status reader interface. The dispatcher wires this to the\n * substrate's projection ref via a thin reader; tests pass a stub.\n * The CLI never calls engine methods directly — it reads the same\n * projection any peer surface (TUI, programmable API) sees.\n */\nexport interface StatusReader {\n\t/** Resolve the current projection. Identity is resolved from argv\n\t *  upstream and baked into the reader at wiring time, so this takes no\n\t *  `(app, stack)` params. Returns `null` if no state has been written\n\t *  yet — a normal, tolerated state for a freshly-defined stack. */\n\treadonly readState: () => Effect.Effect<SubscribableState | null>;\n}\n\nexport interface StatusDeps {\n\treadonly reader: StatusReader;\n}\n\n/**\n * Run `devstack status`. Tolerant of missing state. Always succeeds\n * (returns ok=true) unless the projection read itself raises (which\n * the reader contractually swallows for missing files).\n */\nexport const runStatus = (\n\tdeps: StatusDeps,\n\tctx: CommandContext,\n): Effect.Effect<CommandResult, CliError> =>\n\tEffect.gen(function* () {\n\t\tconst started = Date.now();\n\t\t// `(app, stack)` are read ONLY for the human-readable status line\n\t\t// label below. The reader's identity is resolved from argv upstream\n\t\t// and baked in at wiring time, so it takes no params.\n\t\tconst app = ctx.flags.app ?? '';\n\t\tconst stack = ctx.flags.stack ?? '';\n\t\tconst state = yield* deps.reader.readState();\n\t\tconst data = buildStatusPayload(state);\n\t\tconst elapsedMs = Date.now() - started;\n\n\t\tconst humanLines: Array<string> = [];\n\t\tif (!data.present) {\n\t\t\thumanLines.push(\n\t\t\t\t`status: no state present for ${app || '(no app)'} / ${stack || '(no stack)'}`,\n\t\t\t);\n\t\t} else {\n\t\t\thumanLines.push(`app:     ${data.identity!.app}`);\n\t\t\thumanLines.push(`stack:   ${data.identity!.stack}`);\n\t\t\thumanLines.push(`network: ${data.identity!.network}`);\n\t\t\thumanLines.push(`cycle:   #${data.cycle!.id} ${data.cycle!.phase}`);\n\t\t\thumanLines.push(`rows:    ${data.rowCount}`);\n\t\t\thumanLines.push(`endpoints: ${data.endpointCount}`);\n\t\t\thumanLines.push(`accounts: ${data.accountCount}`);\n\t\t\thumanLines.push(`packages: ${data.packageCount}`);\n\t\t\thumanLines.push(`errors:  ${data.errorCount}`);\n\t\t}\n\n\t\tyield* emitSuccess(ctx.io, ctx.flags.outputMode, {\n\t\t\tcommand: 'status',\n\t\t\telapsedMs,\n\t\t\tdata,\n\t\t\thumanLines,\n\t\t});\n\t\treturn { exitCode: 0 } as CommandResult;\n\t}).pipe(Effect.withSpan('cli.status'));\n"],"mappings":";;;;;AAoBA,MAAa,sBAAsB,UAAoC;AACtE,KAAI,UAAU,KACb,QAAO;EACN,SAAS;EACT,UAAU;EACV,OAAO;EACP,UAAU;EACV,eAAe;EACf,cAAc;EACd,cAAc;EACd,YAAY;EACZ;AAEF,QAAO;EACN,SAAS;EACT,UAAU,EAAE,GAAG,MAAM,UAAU;EAC/B,OAAO,EAAE,GAAG,MAAM,OAAO;EACzB,UAAU,MAAM,KAAK;EACrB,eAAe,MAAM,UAAU;EAC/B,cAAc,MAAM,SAAS;EAC7B,cAAc,MAAM,SAAS;EAC7B,YAAY,MAAM,OAAO;EACzB,MAAM,MAAM,KAAK,KAAK,OAAO;GAC5B,KAAK,EAAE;GACP,MAAM,EAAE;GACR,QAAQ,EAAE;GACV,OAAO,EAAE;GACT,cAAc,EAAE,WAAW,OAAO;GAClC,EAAE;EACH,WAAW,MAAM,UAAU,KAAK,OAAO;GACtC,aAAa,EAAE;GACf,MAAM,EAAE;GACR,KAAK,EAAE,cAAc,EAAE;GACvB,EAAE;EACH,UAAU,MAAM,SAAS,KAAK,aAAa;GAC1C,KAAK,QAAQ;GACb,QAAQ,QAAQ;GAChB,MAAM,QAAQ;GACd,SAAS,QAAQ;GACjB,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB,SAAS,EAAE,GAAG,QAAQ,SAAS;GAC/B,eAAe,QAAQ;GACvB,EAAE;EACH,UAAU,MAAM,SAAS,KAAK,SAAS;GACtC,KAAK,IAAI;GACT,QAAQ,IAAI;GACZ,MAAM,IAAI;GACV,MAAM,IAAI;GACV,WAAW,IAAI;GACf,cAAc,IAAI;GAClB,gBAAgB,IAAI;GACpB,YAAY,IAAI;GAChB,EAAE;EACH;;;;;;;AA0BF,MAAa,aACZ,MACA,QAEA,OAAO,IAAI,aAAa;CACvB,MAAM,UAAU,KAAK,KAAK;CAI1B,MAAM,MAAM,IAAI,MAAM,OAAO;CAC7B,MAAM,QAAQ,IAAI,MAAM,SAAS;CAEjC,MAAM,OAAO,mBAAmB,OADX,KAAK,OAAO,WAAW,CACN;CACtC,MAAM,YAAY,KAAK,KAAK,GAAG;CAE/B,MAAM,aAA4B,EAAE;AACpC,KAAI,CAAC,KAAK,QACT,YAAW,KACV,gCAAgC,OAAO,WAAW,KAAK,SAAS,eAChE;MACK;AACN,aAAW,KAAK,YAAY,KAAK,SAAU,MAAM;AACjD,aAAW,KAAK,YAAY,KAAK,SAAU,QAAQ;AACnD,aAAW,KAAK,YAAY,KAAK,SAAU,UAAU;AACrD,aAAW,KAAK,aAAa,KAAK,MAAO,GAAG,GAAG,KAAK,MAAO,QAAQ;AACnE,aAAW,KAAK,YAAY,KAAK,WAAW;AAC5C,aAAW,KAAK,cAAc,KAAK,gBAAgB;AACnD,aAAW,KAAK,aAAa,KAAK,eAAe;AACjD,aAAW,KAAK,aAAa,KAAK,eAAe;AACjD,aAAW,KAAK,YAAY,KAAK,aAAa;;AAG/C,QAAO,YAAY,IAAI,IAAI,IAAI,MAAM,YAAY;EAChD,SAAS;EACT;EACA;EACA;EACA,CAAC;AACF,QAAO,EAAE,UAAU,GAAG;EACrB,CAAC,KAAK,OAAO,SAAS,aAAa,CAAC"}

package/dist/surfaces/cli/commands/supervisor-presence.mjs

@@ -1,5 +1,6 @@
-import { checkHolderLiveness } from "../../../substrate/runtime/cross-process/liveness.mjs";
+import { LivenessProbeScope, layerLivenessProbeScope } from "../../../substrate/runtime/cross-process/liveness.mjs";
 import { readRoster } from "../../../substrate/runtime/cross-process/roster.mjs";
+import "../../../substrate/runtime/cross-process/index.mjs";
 import { Effect } from "effect";
 //#region src/surfaces/cli/commands/supervisor-presence.ts
 /**
@@ -16,7 +17,8 @@ const probeSupervisorPresence = (rosterFile) => Effect.gen(function* () {
 		version: 1,
 		holders: []
 	})));
-	for (const holder of doc.holders) if ((yield* checkHolderLiveness(holder).pipe(Effect.catch(() => Effect.succeed("alive")))) === "alive") return {
+	const probe = yield* LivenessProbeScope;
+	for (const holder of doc.holders) if ((yield* probe.probeHolderLiveness(holder).pipe(Effect.catch(() => Effect.succeed("alive")))) === "alive") return {
 		live: true,
 		pid: holder.pid,
 		hostname: holder.hostname
@@ -26,7 +28,7 @@ const probeSupervisorPresence = (rosterFile) => Effect.gen(function* () {
 		pid: null,
 		hostname: null
 	};
-});
+}).pipe(Effect.provide(layerLivenessProbeScope));
 //#endregion
 export { probeSupervisorPresence };
 

package/dist/surfaces/cli/commands/supervisor-presence.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"supervisor-presence.mjs","names":[],"sources":["../../../../src/surfaces/cli/commands/supervisor-presence.ts"],"sourcesContent":["// Detect whether a supervisor is currently live for a given stack.\n//\n// The CLI uses this to decide whether a verb should publish via the\n// cross-process command channel (live supervisor: publish + await ack)\n// or use its direct/offline fallback.\n//\n// Detection reads the existing `roster.json` (architecture § Cross-\n// process safety protocol § Roster) and walks holders. A same-host\n// holder with a live PID + matching start-time → supervisor live.\n// Foreign-host holders are conservatively treated as live (NFS-safe\n// default; matches `liveness.ts` discipline).\n\nimport { Effect } from 'effect';\n\nimport {\n\tcheckHolderLiveness,\n\treadRoster,\n\ttype RosterError,\n} from '../../../substrate/runtime/cross-process/index.ts';\n\nexport interface SupervisorPresence {\n\treadonly live: boolean;\n\treadonly pid: number | null;\n\treadonly hostname: string | null;\n}\n\n/**\n * Read `rosterFile` and report whether at least one live holder\n * remains. Returns `{ live: false, pid: null }` when the roster is\n * missing OR all holders are dead-by-liveness-check.\n *\n * Tolerates corrupt rosters: a malformed file is treated as \"no\n * live supervisor\" — the worst case is the CLI refusing a publish\n * the user could have buffered.\n */\nexport const probeSupervisorPresence = (\n\trosterFile: string,\n): Effect.Effect<SupervisorPresence, RosterError> =>\n\tEffect.gen(function* () {\n\t\tconst doc = yield* readRoster(rosterFile).pipe(\n\t\t\tEffect.catchTag('RosterCorruptError', () =>\n\t\t\t\tEffect.succeed({ version: 1 as const, holders: [] }),\n\t\t\t),\n\t\t);\n\t\tfor (const holder of doc.holders) {\n\t\t\tconst liveness = yield* checkHolderLiveness(holder).pipe(\n\t\t\t\tEffect.catch(() => Effect.succeed('alive' as const)),\n\t\t\t);\n\t\t\tif (liveness === 'alive') {\n\t\t\t\treturn { live: true, pid: holder.pid, hostname: holder.hostname };\n\t\t\t}\n\t\t}\n\t\treturn { live: false, pid: null, hostname: null };\n\t});\n"],"mappings":";;;;;;;;;;;;;AAmCA,MAAa,2BACZ,eAEA,OAAO,IAAI,aAAa;CACvB,MAAM,MAAM,OAAO,WAAW,WAAW,CAAC,KACzC,OAAO,SAAS,4BACf,OAAO,QAAQ;EAAE,SAAS;EAAY,SAAS,EAAE;EAAE,CAAC,CACpD,CACD;AACD,MAAK,MAAM,UAAU,IAAI,QAIxB,MAAI,OAHoB,oBAAoB,OAAO,CAAC,KACnD,OAAO,YAAY,OAAO,QAAQ,QAAiB,CAAC,CACpD,MACgB,QAChB,QAAO;EAAE,MAAM;EAAM,KAAK,OAAO;EAAK,UAAU,OAAO;EAAU;AAGnE,QAAO;EAAE,MAAM;EAAO,KAAK;EAAM,UAAU;EAAM;EAChD"}
+{"version":3,"file":"supervisor-presence.mjs","names":[],"sources":["../../../../src/surfaces/cli/commands/supervisor-presence.ts"],"sourcesContent":["// Detect whether a supervisor is currently live for a given stack.\n//\n// The CLI uses this to decide whether a verb should publish via the\n// cross-process command channel (live supervisor: publish + await ack)\n// or use its direct/offline fallback.\n//\n// Detection reads the existing `roster.json` (architecture § Cross-\n// process safety protocol § Roster) and walks holders. A same-host\n// holder with a live PID + matching start-time → supervisor live.\n// Foreign-host holders are conservatively treated as live (NFS-safe\n// default; matches `liveness.ts` discipline).\n\nimport { Effect } from 'effect';\n\nimport {\n\tlayerLivenessProbeScope,\n\tLivenessProbeScope,\n\treadRoster,\n\ttype RosterError,\n} from '../../../substrate/runtime/cross-process/index.ts';\n\nexport interface SupervisorPresence {\n\treadonly live: boolean;\n\treadonly pid: number | null;\n\treadonly hostname: string | null;\n}\n\n/**\n * Read `rosterFile` and report whether at least one live holder\n * remains. Returns `{ live: false, pid: null }` when the roster is\n * missing OR all holders are dead-by-liveness-check.\n *\n * Tolerates corrupt rosters: a malformed file is treated as \"no\n * live supervisor\" — the worst case is the CLI refusing a publish\n * the user could have buffered.\n */\nexport const probeSupervisorPresence = (\n\trosterFile: string,\n): Effect.Effect<SupervisorPresence, RosterError> =>\n\t// Yield a fresh `LivenessProbeScope` so a corrupted-roster edge case\n\t// with multiple holders sharing one pid forks `ps`/`tasklist` once.\n\tEffect.gen(function* () {\n\t\tconst doc = yield* readRoster(rosterFile).pipe(\n\t\t\tEffect.catchTag('RosterCorruptError', () =>\n\t\t\t\tEffect.succeed({ version: 1 as const, holders: [] }),\n\t\t\t),\n\t\t);\n\t\tconst probe = yield* LivenessProbeScope;\n\t\tfor (const holder of doc.holders) {\n\t\t\tconst liveness = yield* probe\n\t\t\t\t.probeHolderLiveness(holder)\n\t\t\t\t.pipe(Effect.catch(() => Effect.succeed('alive' as const)));\n\t\t\tif (liveness === 'alive') {\n\t\t\t\treturn { live: true, pid: holder.pid, hostname: holder.hostname };\n\t\t\t}\n\t\t}\n\t\treturn { live: false, pid: null, hostname: null };\n\t}).pipe(Effect.provide(layerLivenessProbeScope));\n"],"mappings":";;;;;;;;;;;;;;AAoCA,MAAa,2BACZ,eAIA,OAAO,IAAI,aAAa;CACvB,MAAM,MAAM,OAAO,WAAW,WAAW,CAAC,KACzC,OAAO,SAAS,4BACf,OAAO,QAAQ;EAAE,SAAS;EAAY,SAAS,EAAE;EAAE,CAAC,CACpD,CACD;CACD,MAAM,QAAQ,OAAO;AACrB,MAAK,MAAM,UAAU,IAAI,QAIxB,MAAI,OAHoB,MACtB,oBAAoB,OAAO,CAC3B,KAAK,OAAO,YAAY,OAAO,QAAQ,QAAiB,CAAC,CAAC,MAC3C,QAChB,QAAO;EAAE,MAAM;EAAM,KAAK,OAAO;EAAK,UAAU,OAAO;EAAU;AAGnE,QAAO;EAAE,MAAM;EAAO,KAAK;EAAM,UAAU;EAAM;EAChD,CAAC,KAAK,OAAO,QAAQ,wBAAwB,CAAC"}