Function createPrReviewPlan

core/codex/native-integrations.js:142–182

(options = {})

}

function createPrReviewPlan(options = {}) {
  const projectRoot = path.resolve(options.projectRoot || process.cwd());
  const prNumber = options.prNumber || options.pr || 'current';
  const repo = options.repo || 'current-repo';
  const risk = options.risk || 'medium';
  const changedFiles = Number(options.changedFiles || 0);

  let decision = 'codex-review';
  const reasons = ['Codex GitHub review is native and reads AGENTS.md review guidance.'];
  if (risk === 'high' || changedFiles > 20) {
    decision = 'combined';
    reasons.push('High-risk or large PRs still need Citadel local review and verification state.');
  } else if (risk === 'local-only') {
    decision = 'local-review';
    reasons.push('The work depends on local state or unpushed changes Codex GitHub review cannot see.');
  }

  const plan = {
    repo,
    prNumber,
    decision,
    risk,
    changedFiles,
    command: decision === 'local-review' ? `/triage pr ${prNumber}` : '@codex review',
    followUpPrompt: decision === 'combined'
      ? `@codex review this PR. Focus on P0/P1 correctness and security issues. Citadel will also run local verification.`
      : `@codex review this PR. Follow the AGENTS.md review guidelines and focus comments on actionable P0/P1 issues.`,
    capturePath: path.join('.planning', 'pr-review', `${slugify(repo)}-${prNumber}.json`),
    reasons,
    improvesOnLocalOnly: [
      'Uses Codex native PR review for GitHub-visible diffs.',
      'Keeps Citadel responsible for merge readiness, local verification, and follow-up state.',
    ],
    createdAt: nowIso(options),
  };

  if (options.write) {
    writeJson(path.join(projectRoot, plan.capturePath), plan);
  }
  return plan;
}

function recordPrReviewResult(options = {}) {
  const projectRoot = path.resolve(options.projectRoot || process.cwd());