Function assessReadiness

scripts/pr-ready.js:176–245

(projectRoot, options = {})

}

function assessReadiness(projectRoot, options = {}) {
  const root = path.resolve(projectRoot || process.cwd());
  const branch = options.branch || runGit(root, ['branch', '--show-current']) || 'detached';
  const head = runGit(root, ['rev-parse', '--short', 'HEAD']);
  const verificationProfile = selectVerificationProfile(root, {
    changedFiles: options.changedFiles,
  });
  const verificationCommand = options.verification || verificationProfile.primaryCommand;
  verificationProfile.primaryCommand = verificationCommand;
  verificationProfile.commands = Array.from(new Set([
    verificationCommand,
    ...verificationProfile.commands,
  ]));
  const verification = options.runVerification
    ? runVerification(root, verificationCommand)
    : { status: 'not-run', command: verificationCommand || '', exitCode: null, stdout: '', stderr: '' };
  const snapshot = collectDashboard({ projectRoot: root });
  const dashboard = summarizeDashboard(snapshot);
  const prIssue = validatePrUrl(options.pr || '');

  const gates = {
    prUrl: {
      pass: !prIssue,
      detail: prIssue || options.pr,
    },
    git: {
      pass: !snapshot.gitStatus?.dirty,
      detail: snapshot.gitStatus?.dirty ? `${snapshot.gitStatus.changedFiles} uncommitted file(s)` : 'clean',
    },
    dashboard: {
      pass: dashboard.issues.length === 0,
      detail: dashboard.issues.length === 0 ? 'no queued repairs' : dashboard.issues.join('; '),
    },
    verification: {
      pass: verification.status === 'pass',
      detail: verification.status === 'pass'
        ? `${verification.command} exited 0`
        : (verification.status === 'not-run' ? 'verification was not run by this finalizer' : `${verification.command} exited ${verification.exitCode}`),
    },
  };

  const blockers = Object.entries(gates)
    .filter(([, gate]) => !gate.pass)
    .map(([name, gate]) => `${name}: ${gate.detail}`);

  const readiness = {
    generatedAt: options.now || new Date().toISOString(),
    projectRoot: root,
    branch,
    head,
    pr: options.pr || '',
    ready: blockers.length === 0,
    blockers,
    gates,
    verification,
    verificationProfile,
    dashboard: {
      pending: snapshot.pending,