feat(ship): variant E orchestration: one program per review pass and Step 14.5 audit, the review child starts at Step 9, a metered dispatch:docs role, and the driver's record headings (GSTA-167)

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>

lib/ship-budget-cli.ts

@@ -145,7 +145,7 @@ export function decide(l: Ledger, step: string, next: Next, call: number | null,
   }
   const threshold = startThreshold ? DELEGATE_START_CALL : DELEGATE_SEGMENT_CALL;
   const above = aboveFloor(call, p.floor);
-  const boundary = (startThreshold ? next.step === '1' : next.step === '7' || next.step === '12');
+  const boundary = (startThreshold ? next.step === '1' : next.step in SEGMENTS && next.step !== '1');
   const to = l.parent ? l.parent.to : SEGMENTS[next.step]!;
   const small = boundary && !startThreshold ? keepsSmallRun(loadCalibration(l.calibration), { runtimeLines, from: next.step, to, call }) : null;
   const wants = boundary && !small && (above === null ? !startThreshold && l.delegate !== 'measured' : above >= threshold);

lib/ship-budget.ts

@@ -28,7 +28,8 @@ import { BIN_DIR, runScriptSync } from './script-invocation';
 import { SMALL_DIFF_LINES, type Role } from './review-depth';
 
 export const SHIP_STEPS = ['0.9', '1', '2', '3', '4', '5', '6', '6.5', '7', '8', '9', '10', '11', '11.5', '12', '13', '14', '14.5', '15', '16', '17', '18', '19', '20', '21', '22'] as const;
-export const DISPATCH_ROLES = ['specialist', 'red-team', 'adversarial-native', 'outside-voice', 'fix-check'] as const satisfies readonly Role[];
+/** Reviewer roles plus `docs`, the Step 14.5 documentation audit: each is one reader priced and reconciled the same way. */
+export const DISPATCH_ROLES = ['specialist', 'red-team', 'adversarial-native', 'outside-voice', 'fix-check', 'docs'] as const satisfies readonly (Role | 'docs')[];
 type MissingRole = Exclude<Role, typeof DISPATCH_ROLES[number]>;
 const ROLES_COMPLETE: [MissingRole] extends [never] ? true : never = true;
 void ROLES_COMPLETE;
@@ -40,8 +41,8 @@ export const DELEGATE_START_CALL = 100_000;
 export const DELEGATE_SEGMENT_CALL = 150_000;
 /** Handoffs between the root run and the deepest child; a run at this depth continues instead of handing off. */
 export const MAX_CHAIN_DEPTH = 3;
-/** Segment boundaries (before Step 7, before Step 12) and the last step each segment runs. */
-export const SEGMENTS: Record<string, string> = { '1': '22', '7': '11.5', '12': '22' };
+/** Segment boundaries (before Step 9, before Step 12) and the last step each segment runs: Steps 7-8 stay with the parent, so the review child reads only what dispatch needs. */
+export const SEGMENTS: Record<string, string> = { '1': '22', '9': '11.5', '12': '22' };
 export const DEFAULT_TAIL = 2_000_000;
 const DIFF_REVIEW_STEP: Record<string, string> = { review: '9', 'review-fix-check': '9', 'design-review-lite': '9', 'adversarial-review': '11', 'codex-review': '11' };
 

lib/ship-preflight.ts

@@ -99,7 +99,7 @@ function merge(cwd: string, base: string, r: Report): boolean {
       && !(outputs.length && matchesAny(outputs, e.path)) && classifyPath(e.path, cwd) === 'code' && !DATA_PATH.test(e.path));
     runtime = String(counted.reduce((n, e) => n + e.lines, 0));
   } catch { /* unknown */ }
-  r.add(`RUNTIME_LINES: ${runtime} (gstack-ship-budget check --runtime-lines at the Step 7 and 12 boundaries)`);
+  r.add(`RUNTIME_LINES: ${runtime} (gstack-ship-budget check --runtime-lines at the Step 9 and 12 boundaries)`);
   return true;
 }