Sub 4: runSandman.mjs delegation refactor with CLI mode-selector

Parent Epic

#12065 — Sub 4 of 9. Depends on Sub 3 (unified executeRemCycle() method).

Premise

Currently runSandman.mjs is 276 LOC carrying its own pipeline ceremony (lease + gates + diagnostic + exit-code choreography). After Sub 3 ships orchestrator-owned canonical execution, runSandman.mjs becomes a thin CLI selector delegating to the orchestrator.

Prescription

Refactor ai/scripts/runners/runSandman.mjs to ~30 LOC:

import {orchestratorService} from '...';

const mode = process.argv[2] || 'full';  // 'full' | 'refresh'
const reason = mode === 'refresh' ? 'manual-cli-refresh' : 'manual-cli';

try {
    if (mode === 'refresh') {
        await orchestratorService.refreshGoldenPath({reason});  // Sub 5
    } else {
        await orchestratorService.executeRemCycle({reason, includeGoldenPath: true});  // Sub 3
    }
    process.exit(0);
} catch (e) {
    console.error('❌ REM cycle failed:', e);
    process.exit(1);
}

Delete the 105 lines of pre-pipeline ceremony (lease, gates, diagnostics, exit-code choreography) — all now lives in orchestrator.

Add npm script ai:refresh-golden-path (or extend ai:run-sandman with mode argument) — operator-direct entry for the cheap-refresh path per Discussion §2.9.

Acceptance Criteria

• AC1: runSandman.mjs reduced to thin CLI selector (~30 LOC; no business logic; no lease/gate/diagnostic code)
• AC2: Mode-selector via argv supporting full (default) + refresh
• AC3: Both modes delegate to orchestrator's canonical entry-points (Sub 3 + Sub 5)
• AC4: Exit-code contract preserved (process.exit(0) on success, 1 on failure)
• AC5: npm script for cheap-refresh path (npm run ai:refresh-golden-path OR npm run ai:run-sandman -- refresh)
• AC6: Unit test covering both modes (mocking orchestrator)

Avoided Traps

• ❌ Keep business logic in CLI — defeats SSOT purpose
• ❌ Remove on-demand REM trigger — operator workflow falsifies (per §2.9)
• ❌ Land before Sub 3 (no executeRemCycle to delegate to) OR before Sub 5 (no refreshGoldenPath to delegate to)

Related

• Epic #12065
• Discussion #12062 OQ1 + OQ2 (mode-selector) + OQ6 (minimum-viable-CLI) + §2.9 (split-and-recompose UX)
• Sub 3 (executeRemCycle — input), Sub 5 (refreshGoldenPath — input)