peaks-loop 4.0.0-beta.9 → 4.0.3

package/dist/cli/index.js

@@ -1,30 +1,75 @@
 import { CommanderError } from 'commander';
 import { createProgram } from './program.js';
-import { getErrorMessage } from '../shared/result.js';
+import { getErrorMessage } from 'peaks-loop-shared/result';
+import { printErrorEnvelope } from './cli-helpers.js';
+const defaultIo = {
+    stdout: (text) => process.stdout.write(`${text}\n`),
+    stderr: (text) => process.stderr.write(`${text}\n`)
+};
+// D-013 wrapper exit-code fix (PART 2): Commander's `--help` short-circuit
+// fires BEFORE `commander.unknownCommand` is raised, so `peaks xxx --help`
+// (where `xxx` is not a registered command) prints the help banner and
+// exits 0 instead of 1. Detect this case BEFORE Commander runs by scanning
+// `process.argv` for a non-option positional token. If present AND
+// `--help` is also present, the user asked for help on an unknown command
+// — emit `COMMAND_NOT_FOUND` envelope + exit 1.
+//
+// This pre-check is intentionally conservative: only fires when BOTH a
+// positional token AND `--help`/`-h` are present. Bare `--help` (no
+// positional) is legitimate help → exit 0. Positional without `--help`
+// is handled by the root `.action()` in `program.ts`.
+//
+// Fix-5 (2026-07-26): skip the pre-check when the first positional token
+// matches a REGISTERED subcommand. `peaks slice --help` is legitimate
+// help on a registered command (slice IS in the program.commands list) —
+// the prior blind pre-check was a false positive that printed
+// `COMMAND_NOT_FOUND` + exit 1 alongside the slice help banner. We
+// still catch true unknowns (`peaks unknown-cmd --help`): `firstPositional`
+// won't be in the registered set, so the pre-check fires and exits 1.
+const argv = process.argv.slice(2);
+const hasHelp = argv.some((arg) => arg === '--help' || arg === '-h');
+const firstPositional = argv.find((arg) => !arg.startsWith('-'));
+if (hasHelp && firstPositional !== undefined) {
+    const program = createProgram();
+    const registered = new Set(program.commands.map((c) => c.name()));
+    if (!registered.has(firstPositional)) {
+        // Defer the check by 0ms so Commander's own help handler runs first
+        // (it will print help text + try to exit 0). We then override.
+        setImmediate(() => {
+            printErrorEnvelope(defaultIo, 'cli', 'COMMAND_NOT_FOUND', `Unknown command: ${firstPositional}. Run \`peaks --help\` for available commands.`, { argv: firstPositional, combinedWithHelp: true }, ['Run `peaks --help` to list available commands.']);
+            process.exit(1);
+        });
+    }
+}
 createProgram().parseAsync(process.argv).catch((error) => {
     if (error instanceof CommanderError && error.code === 'commander.version') {
         return;
     }
-    // exitOverride() also throws for help; suppress those — the text already went
-    // to stdout/stderr, the error envelope confuses newcomers. --help is success
-    // (exit 0); a bad command/option is an error (exit 1).
+    // D-013 wrapper exit-code fix: distinguish "bare `peaks --help` /
+    // `peaks help <cmd>`" (legitimate help, exit 0) from
+    // "`peaks <unknown> --help`" (user typed a non-existent command,
+    // even if they added --help, the command itself is invalid → exit 1).
+    // Commander only emits `commander.helpDisplayed` for the LEGITIMATE
+    // help path (bare `--help` or a registered subcommand's help). For
+    // unknown commands, Commander throws `commander.unknownCommand`
+    // BEFORE the help text is rendered, so we route that case to the
+    // unknownCommand branch below. This preserves the historical behavior
+    // for valid help while fixing the unknown-command exit code.
     if (error instanceof CommanderError) {
         if (error.code === 'commander.help' || error.code === 'commander.helpDisplayed') {
             return;
         }
         if (error.code === 'commander.missingArgument' || error.code === 'commander.unknownCommand' || error.code === 'commander.unknownOption') {
+            // Emit a `COMMAND_NOT_FOUND` JSON envelope for the unknown-command
+            // path. The error text already went to stderr via Commander's
+            // default handler; we add a structured envelope for LLM-side
+            // consumers (Human-NL-Choice-Only: don't tell the human to type
+            // a CLI verb — say what the LLM can coordinate).
+            printErrorEnvelope(defaultIo, 'cli', 'COMMAND_NOT_FOUND', getErrorMessage(error), {}, ['Run `peaks --help` to list available commands.']);
             process.exitCode = 1;
             return;
         }
     }
-    console.error(JSON.stringify({
-        ok: false,
-        command: 'cli',
-        code: 'UNHANDLED_ERROR',
-        message: getErrorMessage(error),
-        data: {},
-        warnings: [],
-        nextActions: []
-    }, null, 2));
+    printErrorEnvelope(defaultIo, 'cli', 'UNHANDLED_ERROR', getErrorMessage(error), {}, []);
     process.exitCode = 1;
 });

package/dist/cli/program.d.ts

@@ -1,5 +1,5 @@
 import { Command } from 'commander';
-import type { ProgramIO } from './cli-helpers.js';
-export { printResult, type ProgramIO } from './cli-helpers.js';
+import { type ProgramIO } from './cli-helpers.js';
+export { printErrorEnvelope, printResult, type ProgramIO } from './cli-helpers.js';
 export declare function __resetBootstrapForTests(): void;
 export declare function createProgram(io?: ProgramIO): Command;

package/dist/cli/program.js

@@ -1,107 +1,41 @@
-import { readdirSync, existsSync } from 'node:fs';
-import { join } from 'node:path';
 import { Command } from 'commander';
-import { skillsDir, repoRoot } from '../shared/paths.js';
-import { CLI_VERSION } from '../shared/version.js';
+import { repoRoot } from 'peaks-loop-shared/paths';
+import { CLI_VERSION } from 'peaks-loop-shared/version';
+import { autoRegisterAllCommands } from './commands/_register.js';
+import { registerSuperCommands } from './commands/_super.js';
 import { registerCoreAndArtifactCommands } from './commands/core-artifact-commands.js';
 import { registerWorkflowCommands } from './commands/workflow-commands.js';
 import { registerCapabilityWorkerConfigAndSCCommands } from './commands/capability-worker-config-sc-commands.js';
-import { registerCodegraphCommands } from './commands/codegraph-commands.js';
-import { registerOpenSpecCommands } from './commands/openspec-commands.js';
-import { registerPerfCommands } from './commands/perf-commands.js';
-import { registerPreferencesCommands } from './commands/preferences-commands.js';
-// Slice #014: peaks progress * CLI surface deleted (replaced by sub-agent
-// dispatch + heartbeat, slice #009 + #010). Sub-agent progress is
-// surfaced via `peaks sub-agent dispatch|heartbeat|share`.
-import { registerProjectCommands } from './commands/project-commands.js';
-import { registerPrdCommands } from './commands/prd-commands.js';
-import { registerRequestCommands } from './commands/request-commands.js';
-import { registerRetrospectiveCommands } from './commands/retrospective-commands.js';
-import { registerScanCommands } from './commands/scan-commands.js';
-import { registerSliceCommands } from './commands/slice-commands.js';
-import { registerSopCommands } from './commands/sop-commands.js';
-// v2.15.0 slice 002 AC-3: feedback-promotion CLI (`peaks feedback promote`
-// + `peaks feedback check-unpromoted`). See
-// `sops/feedback-promotion-sop.md`.
-import { registerFeedbackCommands } from './commands/feedback-commands.js';
-import { registerForkCommands } from './commands/fork-commands.js';
-import { registerImpactCommands } from './commands/impact-commands.js';
-import { registerSmokeCommands } from './commands/smoke-commands.js';
-import { registerReleaseCommands } from './commands/release-commands.js';
-import { registerPrdBlocksCommands } from './commands/prd-blocks-commands.js';
-import { registerUserTouchpointCommands } from './commands/user-touchpoint-commands.js';
-import { registerSliceReviewCommands } from './commands/slice-review-commands.js';
-import { registerQaBusinessReviewCommands } from './commands/qa-business-review-commands.js';
-import { registerSliceIntegrateCommands } from './commands/slice-integrate-commands.js';
-import { registerDocCommands } from './commands/doc-commands.js';
-import { registerLegacyCommands } from './commands/legacy-commands.js';
-import { registerRoleCommands } from './commands/role-commands.js';
-import { registerComplexityCommands } from './commands/complexity-commands.js';
 import { registerSubAgentCommands } from './commands/sub-agent-commands.js';
-import { registerSubAgentDispatchGuard } from './commands/sub-agent-dispatch-guard.js';
-import { registerGateCommands } from './commands/gate-commands.js';
-import { registerHookHandleCommand } from './commands/hook-handle.js';
-import { registerHooksCommands } from './commands/hooks-commands.js';
-import { registerStatusLineCommands } from './commands/statusline-commands.js';
-import { registerUnderstandCommands } from './commands/understand-commands.js';
+import { registerLeaseMetricsCommand } from './commands/lease-metrics-commands.js';
+import { registerLeaseStatsCommand } from './commands/lease-stats-commands.js';
+import { registerContainerCommand } from './commands/container-commands.js';
+import { registerVmCommand } from './commands/vm-commands.js';
+import { registerCronCommand } from './commands/cron-commands.js';
+import { registerCronSchedulerCommand } from './commands/cron-scheduler-commands.js';
 import { registerWorkspaceCommands } from './commands/workspace-commands.js';
-import { registerWorkflowPlanCommands } from './commands/workflow-plan-commands.js';
-import { registerAuditCommands } from './commands/audit-commands.js';
-import { registerFinalReviewCommands } from './commands/final-review-commands.js';
-import { registerClassifyCommands } from './commands/classify-classify-commands.js';
-import { registerContextCommands } from './commands/context-commands.js';
-import { registerContractCommands } from './commands/contract-commands.js';
-import { registerSkillConformanceCommands } from './commands/skill-conformance-commands.js';
-import { registerSkillLoopEngineeringReadinessCommands } from './commands/skill-loop-engineering-readiness-commands.js';
-import { registerLoopCommands } from './commands/loop-commands.js';
-import { registerWorkflowEvalCommands } from './commands/loop-eval-commands.js';
-import { registerEvolutionCommands } from './commands/evolution-commands.js';
-import { registerAssetCommands } from './commands/asset-commands.js';
-import { registerBeeCommands } from './commands/bee-commands.js';
-import { registerAgentCommands } from './commands/agent-commands.js';
-import { registerUpgradeCommands } from './commands/upgrade-commands.js';
-import { registerCodeReviewCommands } from './commands/code-review-commands.js';
-import { registerSecurityAuditCommands } from './commands/security-audit-commands.js';
-import { registerPerfAuditCommands } from './commands/perf-audit-commands.js';
-import { registerVerdictAggregateCommands } from './commands/verdict-aggregate-command.js';
-import { registerLogCommands } from './commands/log-commands.js';
-import { registerQaCommands } from './commands/qa-commands.js';
-import { registerTestCommands } from './commands/test-commands.js';
-import { registerPlaywrightCommands } from './commands/playwright-commands.js';
-import { registerCodeCommands } from './commands/code-commands.js';
-import { registerMutCommands } from './commands/mut-commands.js';
-import { registerFixtureCommands } from './commands/fixture-commands.js';
-import { registerReviewerCommands } from './commands/reviewer-commands.js';
-import { registerObservabilityCommands } from './commands/observability-commands.js';
-// Slice 2026-07-09 add-zcode-adapter (Slice C): `peaks ide model --current` —
-// read-only runtime model probe surfaced via the registered IDE adapter
-// chain. See src/services/ide/current-model-detector.ts.
-import { registerIdeCommands } from './commands/ide-commands.js';
-// Slice 2026-07-01-strategic-compact-cli: peaks compact
-// (suggest | recommend | survival | dry-run | force) — strategic-compact
-// CLI primitives. See src/services/compact/ and
-// src/cli/commands/compact-command.ts.
-import { registerCompactCommands } from './commands/compact-command.js';
-// Slice 2026-07-01-job-m3.1: `peaks job init|status|...` — Job orchestration CLI surface.
-import { registerJobCommands } from './commands/job-commands.js';
-// Slice 2026-07-04-cli-15a: `peaks skill sediment <verb>` + `peaks skill adapter <verb>`
-// — Task 15a 4-verb subset (add-segment / add-bee / list / rebuild-index).
-// 15b / 15c / 15d will extend sediment-commands.ts with the remaining 14 verbs.
-import { registerSedimentCommands } from './commands/sediment-commands.js';
-import { registerAdapterCommands } from './commands/adapter-commands.js';
-// Slice RD-2 S2-a: `peaks runtime *` (detect / list / compact) +
-// `peaks adapter *` (list / register). See src/services/runtime/ and
-// src/services/adapter/adapter-registry.ts. Coexists with the older
-// `peaks skill adapter` surface (slice 2026-07-04-cli-15a) which is
-// for skill materialization, not vendor-adapter registry.
-import { registerRuntimeCommands } from './commands/runtime-commands.js';
-import { registerAdapterS2ACommands } from './commands/adapter-commands-s2a.js';
-// Slice RD-2 S2-b: `peaks polyrepo *` (init / status / dispatch).
-import { registerPolyrepoCommands } from './commands/polyrepo-commands.js';
+import { registerSopCommands } from './commands/sop-commands.js';
 import { registerSkillVisibilityCommand } from './commands/skill-visibility.js';
-import { applyRetention } from '../services/log/retention.js';
+import { applyRetention, cleanupEccCache } from '../services/log/retention.js';
 import { writeLogEntry, maybeWriteStderr } from '../services/log/logger.js';
-export { printResult } from './cli-helpers.js';
+import { printSuperCommandCatalog } from './cli-helpers.js';
+export { printErrorEnvelope, printResult } from './cli-helpers.js';
+// Slice rid-001 (P0-1 envelope closure, fix #4): the prior default
+// `ProgramIO` funneled Commander's `configureOutput().writeErr` callback
+// through raw `console.error`, which bypassed the canonical envelope
+// path and left a `// TODO(g2): legacy console.error without envelope`
+// grace comment. Default io now routes stdout through `process.stdout`
+// and stderr through `process.stderr` (matching the `defaultIo` built
+// in `src/cli/index.ts`). When a caller passes its own `ProgramIO`
+// (vitest, programmatic dispatch) the closure-side `printErrorEnvelope`
+// helper in `src/cli/cli-helpers.ts` mints a real `fail()` envelope,
+// so the canonical shape is preserved end-to-end.
+function defaultStderrSink(text) {
+    process.stderr.write(`${text}\n`);
+}
+function defaultStdoutSink(text) {
+    process.stdout.write(`${text}\n`);
+}
 /**
  * Slice 2026-06-16-cli-logging (G1, G2, G3, G7). One structured
  * `peaks-loop start` entry per CLI invocation, plus a 7-day
@@ -120,6 +54,13 @@ function bootstrapLogger(verbose) {
     catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
         /* best-effort retention sweep; never block the CLI */
     }
+    // Slice 3 (on-demand-ecc): 7-day TTL sweep over ecc-<sha>/ cache dirs.
+    try {
+        cleanupEccCache({ retentionDays: 7, nowMs: Date.now() });
+    }
+    catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
+        /* best-effort ECC retention sweep; never block the CLI */
+    }
     const dateOverride = process.env.PEAKS_LOG_DATE_OVERRIDE;
     const entry = {
         ts: new Date().toISOString(),
@@ -148,7 +89,7 @@ let bootstrapRan = false;
 export function __resetBootstrapForTests() {
     bootstrapRan = false;
 }
-export function createProgram(io = { stdout: (text) => console.log(text), stderr: (text) => console.error(text) }) {
+export function createProgram(io = { stdout: defaultStdoutSink, stderr: defaultStderrSink }) {
     const program = new Command();
     program
         .name('peaks')
@@ -200,6 +141,40 @@ Run peaks (no arguments) for a quickstart. You likely want one of:
         }
     })
         .action(() => {
+        // D-013 wrapper exit-code fix: when the user typed a command token but
+        // it didn't match any registered subcommand, exit non-zero with a JSON
+        // `COMMAND_NOT_FOUND` envelope. Without this check, Commander's root
+        // `.action()` runs whenever no subcommand matches (including unknown
+        // commands) and prints the help banner with exit 0 — which violates
+        // the PRD AC3.9/AC3.10 contract for `peaks agent run/list` and any
+        // other deleted/hidden command.
+        //
+        // Detection: use `program.args` (Commander's parsed argv) for the
+        // first non-option token. If it's present and Commander didn't route
+        // to a subcommand (we got here, so it didn't), the user typed an
+        // unknown command. Exit 1. `program.args` works correctly under both
+        // `parseAsync(['node', 'peaks', ...])` (real CLI) and direct in-process
+        // calls (vitest integration tests), unlike `process.argv` which is
+        // the test runner's argv.
+        //
+        // --help and --version bypass this path entirely (handled below).
+        const firstNonOption = program.args.find((arg) => !arg.startsWith('-'));
+        if (firstNonOption !== undefined) {
+            // Commander reached this `.action()` despite a positional token,
+            // which means the token was NOT routed to any subcommand. This is
+            // the unknown-command path. Emit a JSON envelope + exit 1.
+            io.stdout(JSON.stringify({
+                ok: false,
+                command: 'cli',
+                code: 'COMMAND_NOT_FOUND',
+                message: `Unknown command: ${firstNonOption}. Run \`peaks --help\` for available commands.`,
+                data: { argv: firstNonOption },
+                warnings: [],
+                nextActions: ['Run `peaks --help` to list available commands.']
+            }, null, 2));
+            process.exitCode = 1;
+            return;
+        }
         const opts = program.opts();
         if (opts.V || opts.version) {
             // AC1: write the peaks-loop start log line BEFORE printing the
@@ -212,197 +187,27 @@ Run peaks (no arguments) for a quickstart. You likely want one of:
             io.stdout(CLI_VERSION);
             return;
         }
-        // Count bundled skills by reading the skills dir directly (synchronous so
-        // the quickstart renders instantly — no import/async overhead on startup).
-        let skillCount = 0;
-        const skillsPath = skillsDir;
-        try {
-            if (existsSync(skillsPath)) {
-                skillCount = readdirSync(skillsPath, { withFileTypes: true })
-                    .filter((entry) => entry.isDirectory() && !entry.name.startsWith('.'))
-                    .filter((entry) => existsSync(join(skillsPath, entry.name, 'SKILL.md')))
-                    .length;
-            }
-        }
-        catch { /* disk read is best-effort; zero skills is still truthful */ } // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
-        io.stdout(`Peaks Loop ${CLI_VERSION} · ${skillCount} skills ready
-
- Peaks is a loop-engineering CLI + skill family for Claude Code.
- It turns "don't skip steps" into hard enforcement — gates that block
- advancement in-conversation, un-bypassably.
-
- Before diving into a project, two things worth doing now:
-
- peaks doctor check your environment in one glance
- peaks-sop <<< ask this skill to author your first SOP
-
- Or jump straight in:
- peaks sop init --id my-flow --apply && peaks hooks install
-`);
+        printSuperCommandCatalog(io);
     })
         .exitOverride();
     registerCoreAndArtifactCommands(program, io);
     registerWorkflowCommands(program, io);
     registerCapabilityWorkerConfigAndSCCommands(program, io);
-    registerCodegraphCommands(program, io);
-    registerOpenSpecCommands(program, io);
-    registerPerfCommands(program, io);
-    registerPreferencesCommands(program);
-    registerProjectCommands(program, io);
-    registerPrdCommands(program, io);
-    registerRequestCommands(program, io);
-    registerRetrospectiveCommands(program, io);
-    registerScanCommands(program, io);
-    registerSliceCommands(program, io);
-    registerSopCommands(program, io);
-    // v2.15.0 slice 002 AC-3: feedback promotion CLI.
-    registerFeedbackCommands(program, io);
-    // v2.15.0 follow-up G11: fork sync CLI (status / upstream-check / sync-plan / sync / sync-verify).
-    registerForkCommands(program, io);
-    // v2.15.0 follow-up G13: impact scan CLI (scan / must-check).
-    registerImpactCommands(program, io);
-    // v2.15.0 follow-up G14: smoke regression CLI (define / run / run-and-repair / add-path).
-    registerSmokeCommands(program, io);
-    // v2.15.0 follow-up G15: release / hotfix CLI (plan / canary / promote / watch / done / rollback / hotfix).
-    registerReleaseCommands(program, io);
-    // v2.15.0 follow-up G3: prd 4 必填块 CLI (check-blocks).
-    registerPrdBlocksCommands(program, io);
-    // v2.15.0 follow-up G4: user touchpoint CLI (gate-classify / user-touchpoints / commit-boundary-actions).
-    registerUserTouchpointCommands(program, io);
-    // v2.15.0 follow-up G1: slice business review CLI (review / score / accept / reject).
-    registerSliceReviewCommands(program, io);
-    // v2.15.0 follow-up G5: QA business review CLI (business-review / score / accept / reject).
-    registerQaBusinessReviewCommands(program, io);
-    // v2.15.0 follow-up G6: slice cross-integration verifier (slice-integrate).
-    registerSliceIntegrateCommands(program, io);
-    // v2.15.0 follow-up G7: doc auto-generation (generate-skill / changelog-suggest).
-    registerDocCommands(program, io);
-    // v2.15.0 follow-up G8: legacy code smell detector (legacy-detect).
-    registerLegacyCommands(program, io);
-    // v2.15.0 follow-up G9: lightweight role registry (role list/add/grant/check).
-    registerRoleCommands(program, io);
-    // v2.15.0 follow-up G10: complexity estimator (complexity-estimate).
-    registerComplexityCommands(program, io);
     registerSubAgentCommands(program, io);
-    registerContractCommands(program, io);
-    // Slice #010 G9.5: register the hook-only internal atom. Hidden from
-    // `peaks --help` (no description text); used by `peaks hooks install`
-    // to wire the PreToolUse hook chain.
-    registerSubAgentDispatchGuard(program);
-    registerGateCommands(program, io);
-    registerHookHandleCommand(program, io);
-    registerHooksCommands(program, io);
-    registerStatusLineCommands(program, io);
-    registerUnderstandCommands(program, io);
     registerWorkspaceCommands(program, io);
-    registerWorkflowPlanCommands(program, io);
-    // Slice L2.1: peaks audit * — red-line audit framework.
-    registerAuditCommands(program, io);
-    // Slice 2026-06-25-slice-topology-multipass (Fix M2): peaks prepare-final-review CLI wrapper.
-    registerFinalReviewCommands(program, io);
-    // Slice #2: peaks classify * — L1a task classification + L1b per-level gate sets.
-    registerClassifyCommands(program, io);
-    // Slice #3: peaks context * — L1c context 4-layer loader.
-    registerContextCommands(program, io);
-    // Slice #12: peaks skills:audit-conformance — skill family alignment pass.
-    registerSkillConformanceCommands(program, io);
-    // M6 (2026-07-07 spec §7.5 / §8.4): peaks skill lint --category
-    // loop-engineering-readiness — readiness gate for any new peaks-*
-    // skill that participates in Loop Engineering.
-    registerSkillLoopEngineeringReadinessCommands(program, io);
-    // Slice #13: peaks swarm * — additional subcommands (pipeline /
-    // dispatch / verify / loop) are added inline in workflow-commands.ts
-    // alongside the existing swarm.plan. This avoids the duplicate top-level
-    // command conflict (peaks-loop-when-adding-a-new-subcommand-check-for-existing-top-level-first).
-    // Slice #14: peaks loop * + peaks goal compose — L4 Agent Loop sub-features.
-    registerLoopCommands(program, io);
-    // Slice v3.0.0 loop-eng-native-code-a-b: peaks workflow run|plan|lint
-    // + peaks loop eval. Wraps the existing workflow + loop groups so the
-    // add-a-new-subcommand-check-for-existing-top-level-first rule is honoured.
-    registerWorkflowEvalCommands(program, io);
-    // M4 (2026-07-07 spec): `peaks evolution propose|evaluate|revert|status|mark-keep`
-    // — Darwin-style ratchet CLI surface.
-    registerEvolutionCommands(program, io);
-    // M5 (2026-07-07 spec): `peaks asset crystallize|dispose|status` —
-    // umbrella cross-asset crystallization surface.
-    registerAssetCommands(program, io);
-    // M7 (2026-07-07 spec §7A.2 / §10 RL-9): `peaks bee export|import`
-    // — cross-user share surface for bee_release rows.
-    registerBeeCommands(program, io);
-    // Slice: ECC 64 agents soft-optional (per spec §7.2 line 818).
-    registerAgentCommands(program, io);
-    // Slice: 1.x → 2.0 umbrella (per "one-key completion" + "minimal-user-operation" tenets).
-    registerUpgradeCommands(program, io);
-    // Slice: ocr soft-optional integration (peaks-rd Gate B3 augmentation).
-    registerCodeReviewCommands(program, io);
-    // Slice v2.12.0 Group A Tier 2: `peaks security-audit` (independent security audit skill driver).
-    registerSecurityAuditCommands(program, io);
-    // Slice v2.12.0 Group A Tier 3: `peaks perf-audit` (independent perf audit skill driver).
-    registerPerfAuditCommands(program, io);
-    // Slice v2.13.2 AC-2: `peaks verdict aggregate` (cross-source verdict aggregator CLI surface).
-    registerVerdictAggregateCommands(program, io);
-    // Slice 2026-06-16-cli-logging (G4): `peaks log tail` / `peaks log ls`.
-    registerLogCommands(program, io);
-    // Slice 2026-06-16-playwright-restart-loop (G5 + AC4): `peaks qa run`.
-    registerQaCommands(program, io);
-    // Slice 2026-06-17-2.5.0-sub-fix-B: `peaks test` (user-invoked, smart
-    // fingerprint-cache wrapper around jest/vitest/mocha).
-    registerTestCommands(program, io);
-    // Slice 2026-06-17-2.5.0-sub-fix-C: `peaks playwright start|ls|stop`
-    // (multi-terminal Playwright MCP lifecycle).
-    registerPlaywrightCommands(program, io);
-    // Slice 2 (peaks-code fast mode): `peaks code plan [--fast] <change-id>`
-    // v2.11.0 Group F (D5 + D7): also registers `peaks code should-pause` and
-    // `peaks code post-compact-detect` for runtime-friction probes.
-    registerCodeCommands(program, io);
-    // Plan 2 / Task 6: `peaks mut run|mutants|asserts|report` — mutation
-    // testing + assertion validity scan (spec §4.2 / §7). The
-    // production Stryker invoker is wired here; tests use the
-    // `createMutCommands({ invokeStryker })` factory directly with a
-    // mock to keep @stryker-mutator/core out of the unit-test path.
-    registerMutCommands(program, io);
-    // Slice v2.14.0 G1 AC-1.4: `peaks fixture capture` — fixture-replay
-    // anti-fake-green test suite producer. Sanitizes + checksums the
-    // captured envelope and writes a co-located fixture.meta.json.
-    registerFixtureCommands(program, io);
-    // Slice v2.14.0 G4 AC-4.1: `peaks reviewer run|status` — third-party
-    // reviewer CLI. The reviewer modelFamily MUST differ from the
-    // karpathy-reviewer modelFamily (AC-4.4); see
-    // src/services/reviewer/model-family.ts. The THIRD_PARTY_REVIEW prereq
-    // is wired into src/services/artifacts/artifact-prerequisites.ts.
-    registerReviewerCommands(program, io);
-    // Slice B of v2.11.1: `peaks observability status|slices|fanout|repair-cycles`
-    // (read-only queries over the JSONL metrics emitted from the
-    // peaks request transition hook in Slice A).
-    // Slice 2026-07-09 add-zcode-adapter (C.6): `peaks ide model --current`
-    // (read-only runtime model probe via the registered IDE adapter chain).
-    registerIdeCommands(program, io);
-    registerObservabilityCommands(program, io);
-    // Slice 2026-07-01-strategic-compact-cli: `peaks compact
-    // suggest|recommend|survival|dry-run|force` — strategic-compact CLI
-    // primitives. See src/cli/commands/compact-command.ts.
-    registerCompactCommands(program, io);
-    // Slice 2026-07-01-job-m3.1: `peaks job init|status|...` — Job
-    // orchestration CLI surface. M3.1 wires init + status + 2 stubs;
-    // the remaining 5 subcommands land in M3.2.
-    registerJobCommands(program, io);
-    // Slice 2026-07-04-cli-15a: `peaks skill sediment <verb>` — Task 15a
-    // 4-verb subset. Dispatches to runSediment; remaining verbs land in 15b/15c/15d.
-    registerSedimentCommands(program, io);
-    // Slice 2026-07-04-cli-15a: `peaks skill adapter <verb>` — adapter list / set-active.
-    registerAdapterCommands(program, io);
-    // Slice RD-2 S2-a: `peaks runtime *` (detect / list / compact) +
-    // `peaks adapter *` (list / register). Vendor verbs live ONLY in
-    // src/services/runtime/vendors/<vendor>.ts (AC-1 enforcement).
-    registerRuntimeCommands(program, io);
-    registerAdapterS2ACommands(program, io);
-    // Slice RD-2 S2-b: `peaks polyrepo *` (init / status / dispatch).
-    registerPolyrepoCommands(program, io);
-    // Slice 2026-07-05-peaks-code-to-peaks-code (Task 1): `peaks skill:visibility --list --json`
-    // — read .claude-plugin/marketplace.json and report each skill's
-    // visibility (public vs internal). Used to surface which skills are
-    // user-invocable vs LLM-only internal role skills. See
-    // src/cli/commands/skill-visibility.ts.
+    registerSopCommands(program, io);
+    registerSuperCommands(program, io);
+    registerLeaseMetricsCommand(program, io);
+    registerLeaseStatsCommand(program, io);
+    registerContainerCommand(program, io);
+    registerVmCommand(program, io);
+    registerCronCommand(program, io);
+    registerCronSchedulerCommand(program, io);
+    // Auto-route the remaining 60+ commands after the orchestrators so the
+    // lazy `skill` parent (used by adapter-commands / sediment-commands)
+    // finds the existing `peaks skill` group registered by
+    // registerCoreAndArtifactCommands instead of being created twice.
+    autoRegisterAllCommands(program, io);
     registerSkillVisibilityCommand(program, repoRoot);
     return program;
 }

package/dist/services/24h-mode/decider.d.ts

@@ -0,0 +1,103 @@
+/**
+ * 24h mode B3 trigger evaluation + attempts counter.
+ *
+ * Rid-020a (state-only slice). `fireB3` is the single mutating
+ * primitive: it increments the per-key counter and escalates with a
+ * `B3Escalation` when the count reaches `B3_THRESHOLD` (3). The
+ * counter is **per-key** — AC-T3 mandates B1 and B2 retries do not
+ * share a global counter. The T3/T4 auto-24H_ACTIVE path is encoded
+ * in `isAutoEngageTrigger` (BRAINSTORM is bypassed for these
+ * triggers so an offline-resumed session does not deadlock in
+ * WAITING_USER — proposal §1 T3/T4 exception).
+ */
+import { type DecisionKey, type State } from './state.js';
+import type { AutoCompactMode } from '../code/auto-compact-modes.js';
+export type AttemptsMap = Record<DecisionKey, number>;
+export declare const B3_TRIGGER_REASONS: readonly ["prd_direction_change", "blocker_3_consecutive_slices", "registry_affecting_failure", "destructive_irreversible_op", "any_B1_B2_failure_3x_non_converging", "runtime_or_shared_version_mismatch", "sub-agent_stale_5min_x3"];
+export type B3Reason = (typeof B3_TRIGGER_REASONS)[number];
+export declare class B3Escalation extends Error {
+    readonly reason: B3Reason;
+    readonly attempts: number;
+    constructor(reason: B3Reason, attempts: number);
+}
+/**
+ * Result envelope for `fireB3`. We return a discriminated union
+ * (instead of throwing) so callers can branch on `kind` without
+ * try/catch ceremony. The B3Escalation class is still exported for
+ * backward compatibility with callers that prefer the throw style.
+ */
+export type FireB3Result = {
+    kind: 'continue';
+    reason: B3Reason;
+    attempts: number;
+} | {
+    kind: 'escalate';
+    reason: B3Reason;
+    attempts: number;
+};
+export declare function isB3Reason(value: string): value is B3Reason;
+export declare function isValidReason(value: string): value is DecisionKey;
+export declare function freshAttempts(): AttemptsMap;
+/**
+ * Per AC-T1 (attempts=1 continue, no B3) and AC-T2 (attempts=3
+ * escalate), the 3rd call escalates. The threshold is intentionally
+ * NOT configurable — the proposal pins the constant so QA v3 can
+ * assert it. Returns a FireB3Result instead of throwing so test
+ * code can read the `attempts` field via plain property access
+ * (Error-subclass property access through vitest 4.1.10 matchers
+ * is unreliable; the discriminated union sidesteps that).
+ */
+export declare function fireB3(reason: B3Reason, attempts: AttemptsMap): FireB3Result;
+/**
+ * T3 (runaway recovery) and T4 (offline resume) auto-engage
+ * `24H_ACTIVE` without forcing `USER_CONFIRM` — the deferred
+ * AskUserQuestion fires at the first 10min checkpoint instead, so
+ * a T4 session does not deadlock in `WAITING_USER` while the
+ * user is offline (proposal §1 T3/T4 exception).
+ */
+export declare const AUTO_ENGAGE_TRIGGERS: readonly ["T3", "T4"];
+export type AutoEngageTrigger = (typeof AUTO_ENGAGE_TRIGGERS)[number];
+export declare function isAutoEngageTrigger(t: string): t is AutoEngageTrigger;
+/**
+ * Five trigger conditions (T1-T5) from proposal §1 + companion
+ * trigger-and-decision-autonomy sediment. T1/T2/T5 flow through
+ * BRAINSTORM; T3/T4 auto-engage and skip the gate.
+ */
+export interface TriggerCheck {
+    triggered: boolean;
+    trigger: 'T1' | 'T2' | 'T3' | 'T4' | 'T5' | null;
+    reason: string;
+}
+export declare const T1_KEYWORDS: string[];
+export declare const T2_MIN_SLICES = 30;
+export declare const T2_MIN_WALL_HOURS = 6;
+export declare const T3_MIN_MONOTONIC_GUARDS = 3;
+export declare const T3_MIN_REMAINING_SLICES = 10;
+export declare const T4_SESSION_GAP_HOURS = 4;
+export declare const T5_MIN_ACTIVE_SLICES = 3;
+export declare function checkTriggers(input: {
+    userMessage: string;
+    sliceListSize: number;
+    estimatedWallHours: number;
+    monotonicGuards: number;
+    remainingSlices: number;
+    sessionGapHours: number;
+    activeSlicesAcrossServices: number;
+}): TriggerCheck;
+/**
+ * HANDOFF is reachable via three exit conditions per proposal §1:
+ *   - user abort
+ *   - all-trigger-resolved
+ *   - B3 unresolvable (B3Escalation that the user dismisses)
+ */
+export declare const HANDOFF_EXIT_CONDITIONS: readonly ["user_abort", "all_triggers_resolved", "b3_unresolvable"];
+export type HandoffExitCondition = (typeof HANDOFF_EXIT_CONDITIONS)[number];
+export declare function isHandoffExitCondition(s: string): s is HandoffExitCondition;
+export declare function isHandoffState(s: State): boolean;
+/**
+ * Slice 2026-07-28 (rid-027): resolve the auto-compact mode from
+ * 24h-mode awareness. Returns `'partial'` when the session is
+ * `24H_ACTIVE`, otherwise `'standard'`. This is the CLI-side default;
+ * the explicit `--mode` flag in `peaks compact auto` overrides it.
+ */
+export declare function getAutoCompactMode(projectRoot: string, sessionId: string): AutoCompactMode;