Function assessStack

scripts/stack-plan.js:285–309

(projectRoot, options = {})

}

function assessStack(projectRoot, options = {}) {
  const root = path.resolve(projectRoot || process.cwd());
  const reports = annotateCurrentHeads(root, options.reports || readReadinessReports(root), options);
  const ordered = orderReports(root, reports, options);
  const blocked = ordered
    .map((report) => ({ report, reasons: blockerReasons(report) }))
    .filter((entry) => entry.reasons.length > 0);
  const status = statusForStack(ordered, blocked);
  const stack = {
    generatedAt: new Date().toISOString(),
    projectRoot: root,
    status,
    ready: status === 'approval-needed',
    reports: ordered,
    blocked,
    nextAction: buildNextAction(status, ordered),
  };
  stack.postApprovalRunbook = buildPostApprovalRunbook(status, ordered);
  stack.approvalCapsule = buildStackApprovalCapsule(root, stack);
  if (stack.approvalCapsule && options.writeReport !== false && options.writeApprovalCapsule !== false) {
    writeApprovalCapsule(root, stack.approvalCapsule);
  }
  stack.reportPath = options.writeReport === false ? null : writeStackPlan(root, stack);
  return stack;
}

function renderStackPlan(stack) {
  const lines = [