@clearlydev/nx-archweave 0.0.0-stage → 0.1.1

package/dist/generators/add-review/generator.js

@@ -0,0 +1,921 @@
+// ../template-engine/dist/environment/package-manager.js
+var LOCKFILES = [
+  ["yarn", ["yarn.lock"]],
+  ["bun", ["bun.lock", "bun.lockb"]],
+  ["npm", ["package-lock.json"]]
+];
+function detectWorkspacePackageManager(exists, read = () => void 0) {
+  if (exists("pnpm-lock.yaml") || exists("pnpm-workspace.yaml"))
+    return "pnpm";
+  const found = LOCKFILES.filter(([, files]) => files.some((file) => exists(file))).map(([pm]) => pm);
+  if (found.length <= 1)
+    return found[0] ?? null;
+  const declared = /"packageManager"\s*:\s*"(npm|yarn|bun)@/.exec(read("package.json") ?? "")?.[1];
+  const named = found.find((pm) => pm === declared);
+  if (named)
+    return named;
+  return found.includes("npm") ? "npm" : found[0];
+}
+
+// ../review-policy/dist/modes/review-modes.js
+var REVIEW_MODES = {
+  fast: {
+    mode: "fast",
+    promptStyle: "fast-condensed",
+    includesCorrectnessSecurity: true,
+    includesOverEngineering: false
+  },
+  standard: {
+    mode: "standard",
+    promptStyle: "sectioned",
+    includesCorrectnessSecurity: true,
+    includesOverEngineering: false
+  },
+  thorough: {
+    mode: "thorough",
+    promptStyle: "sectioned",
+    includesCorrectnessSecurity: true,
+    includesOverEngineering: true
+  }
+};
+
+// ../review-policy/dist/verdict-gate/findings-block.js
+var FINDINGS_MARKER = "<!-- archweave-findings-v1 -->";
+var FINDINGS_SCHEMA_ID = "archweave/findings@1";
+
+// ../review-policy/dist/prompts/prompt-shared.js
+function renderFindingSchemaInstruction(locale, priorities) {
+  const intro = locale === "en" ? "For every finding, fill in every field of this schema:" : "\uBAA8\uB4E0 finding\uC5D0 \uB300\uD574 \uC544\uB798 \uC2A4\uD0A4\uB9C8\uC758 \uBAA8\uB4E0 \uD544\uB4DC\uB97C \uCC44\uC6B0\uC138\uC694:";
+  return [
+    intro,
+    `- priority: ${priorities.join(" | ")}`,
+    "- category: kebab-case category name",
+    "- title: one-line summary",
+    "- file: path of the affected file",
+    "- lineRange: { start, end? }",
+    "- evidence: what in the code proves the problem",
+    "- impact: what goes wrong and for whom",
+    "- reproductionCondition: the exact input/state that triggers it",
+    "- recommendation: the concrete fix",
+    "- confidence: confirmed | plausible"
+  ].join("\n");
+}
+function renderFindingsBlockInstruction(locale) {
+  const lines = locale === "en" ? [
+    "At the END of the top-level summary comment, append the machine-readable findings block:",
+    `the literal marker line ${FINDINGS_MARKER}, then a fenced \`\`\`json block containing`,
+    `{ "schema": "${FINDINGS_SCHEMA_ID}", "findings": [ ... ] } with one entry per finding,`,
+    "using exactly the finding schema above. If there are no findings, still append the block with an empty findings array."
+  ] : [
+    "top-level \uC694\uC57D \uCF54\uBA58\uD2B8\uC758 \uB9E8 \uB05D\uC5D0 \uAE30\uACC4 \uD310\uB3C5\uC6A9 findings \uBE14\uB85D\uC744 \uB367\uBD99\uC774\uC138\uC694:",
+    `\uB9AC\uD130\uB7F4 \uB9C8\uCEE4 \uC904 ${FINDINGS_MARKER} \uB2E4\uC74C\uC5D0 fenced \`\`\`json \uBE14\uB85D\uC73C\uB85C`,
+    `{ "schema": "${FINDINGS_SCHEMA_ID}", "findings": [ ... ] }\uB97C, finding\uB9C8\uB2E4 \uD55C \uC6D0\uC18C\uC529, \uC704 finding \uC2A4\uD0A4\uB9C8 \uADF8\uB300\uB85C \uC791\uC131\uD558\uC138\uC694.`,
+    "finding\uC774 \uC5C6\uC5B4\uB3C4 \uBE48 \uBC30\uC5F4\uB85C \uBE14\uB85D\uC744 \uBC18\uB4DC\uC2DC \uD3EC\uD568\uD558\uC138\uC694."
+  ];
+  return lines.join("\n");
+}
+function renderDedupInstruction(locale) {
+  return locale === "en" ? "If multiple findings share the same root cause, merge them into a single finding instead of reporting duplicates." : "\uAC19\uC740 \uC6D0\uC778\uC5D0\uC11C \uB098\uC628 finding\uC774 \uC5EC\uB7EC \uAC1C\uB77C\uBA74 \uC911\uBCF5 \uBCF4\uACE0\uD558\uC9C0 \uB9D0\uACE0 \uD558\uB098\uC758 finding\uC73C\uB85C \uD569\uCCD0\uC11C \uBCF4\uACE0\uD558\uC138\uC694.";
+}
+
+// ../review-policy/dist/prompts/correctness-security-prompt.js
+var CORRECTNESS_SECURITY_PRIORITIES = ["P0", "P1", "P2", "Nit"];
+var FAST_PRIORITIES = ["P0", "P1", "P2"];
+function buildCorrectnessSecurityPrompt(locale, style = "sectioned") {
+  if (style === "fast-condensed") {
+    const fastBody = locale === "en" ? [
+      "You are a code reviewer focused on correctness and security.",
+      "",
+      "Review the provided diff and report only the most critical problems. Skip minor style and taste remarks entirely \u2014 report nothing below P2.",
+      "",
+      `Only report findings with priority ${FAST_PRIORITIES.join(", ")}. Do NOT report P3 (over-engineering) findings \u2014 they are out of scope here.`
+    ] : [
+      "\uB2F9\uC2E0\uC740 \uC815\uD655\uC131(correctness)\uACFC \uBCF4\uC548(security)\uC5D0 \uC9D1\uC911\uD558\uB294 \uCF54\uB4DC \uB9AC\uBDF0\uC5B4\uC785\uB2C8\uB2E4.",
+      "",
+      "\uC8FC\uC5B4\uC9C4 diff\uC5D0\uC11C \uAC00\uC7A5 \uCE58\uBA85\uC801\uC778 \uBB38\uC81C\uB9CC \uBCF4\uACE0\uD558\uC138\uC694. \uC0AC\uC18C\uD55C \uC2A4\uD0C0\uC77C\xB7\uCDE8\uD5A5 \uC9C0\uC801\uC740 \uC644\uC804\uD788 \uC0DD\uB7B5\uD558\uACE0, P2 \uBBF8\uB9CC\uC740 \uBCF4\uACE0\uD558\uC9C0 \uB9C8\uC138\uC694.",
+      "",
+      `\uC6B0\uC120\uC21C\uC704 ${FAST_PRIORITIES.join(", ")}\uC5D0 \uD574\uB2F9\uD558\uB294 finding\uB9CC \uBCF4\uACE0\uD558\uC138\uC694. P3(\uACFC\uC789 \uC124\uACC4)\uB294 \uBCF4\uACE0\uD558\uC9C0 \uB9C8\uC138\uC694 \u2014 \uC774 \uB9AC\uBDF0\uC758 \uBC94\uC704 \uBC16\uC785\uB2C8\uB2E4.`
+    ];
+    return [...fastBody, "", renderFindingSchemaInstruction(locale, FAST_PRIORITIES), "", renderDedupInstruction(locale)].join("\n");
+  }
+  const body = locale === "en" ? [
+    "You are a code reviewer focused on correctness and security.",
+    "",
+    'Review the provided diff and report findings in two explicitly separated top-level sections: "Correctness" and "Security". Never mix the two.',
+    "",
+    `Only report findings with priority ${CORRECTNESS_SECURITY_PRIORITIES.join(", ")}. Do NOT report P3 (over-engineering) findings \u2014 they are covered by a separate reviewer and are out of scope here.`
+  ] : [
+    "\uB2F9\uC2E0\uC740 \uC815\uD655\uC131(correctness)\uACFC \uBCF4\uC548(security)\uC5D0 \uC9D1\uC911\uD558\uB294 \uCF54\uB4DC \uB9AC\uBDF0\uC5B4\uC785\uB2C8\uB2E4.",
+    "",
+    '\uC8FC\uC5B4\uC9C4 diff\uB97C \uB9AC\uBDF0\uD558\uACE0, finding\uC744 "Correctness"\uC640 "Security" \uB450 \uAC1C\uC758 \uCD5C\uC0C1\uC704 \uC139\uC158\uC73C\uB85C \uBD84\uB9AC\uD574 \uBCF4\uACE0\uD558\uC138\uC694. \uB450 \uC139\uC158\uC744 \uC808\uB300 \uC11E\uC9C0 \uB9C8\uC138\uC694.',
+    "",
+    `\uC6B0\uC120\uC21C\uC704 ${CORRECTNESS_SECURITY_PRIORITIES.join(", ")}\uC5D0 \uD574\uB2F9\uD558\uB294 finding\uB9CC \uBCF4\uACE0\uD558\uC138\uC694. P3\uB294 \uBCF4\uACE0\uD558\uC9C0 \uB9C8\uC138\uC694 \u2014 P3(\uACFC\uC789 \uC124\uACC4)\uB294 \uBCC4\uB3C4\uC758 \uB9AC\uBDF0\uC5B4\uAC00 \uB2F4\uB2F9\uD558\uBBC0\uB85C \uC774 \uB9AC\uBDF0\uC758 \uBC94\uC704 \uBC16\uC785\uB2C8\uB2E4.`
+  ];
+  return [...body, "", renderFindingSchemaInstruction(locale, CORRECTNESS_SECURITY_PRIORITIES), "", renderDedupInstruction(locale)].join("\n");
+}
+
+// ../review-policy/dist/prompts/over-engineering-prompt.js
+var OVER_ENGINEERING_PRIORITIES = ["P3"];
+function buildOverEngineeringPrompt(locale) {
+  const body = locale === "en" ? [
+    "You are a code reviewer focused exclusively on over-engineering.",
+    "",
+    "Review the provided diff and report findings with priority P3 only. Do NOT report P0, P1, P2, or Nit findings \u2014 correctness and security are covered by a separate reviewer.",
+    "",
+    'Report your findings in their own top-level section titled "Over-engineering"; never mix them into correctness or security sections.'
+  ] : [
+    "\uB2F9\uC2E0\uC740 \uACFC\uC789 \uC124\uACC4(over-engineering)\uB9CC\uC744 \uC804\uB2F4\uD558\uB294 \uCF54\uB4DC \uB9AC\uBDF0\uC5B4\uC785\uB2C8\uB2E4.",
+    "",
+    "\uC8FC\uC5B4\uC9C4 diff\uB97C \uB9AC\uBDF0\uD558\uACE0 \uC6B0\uC120\uC21C\uC704 P3\uB9CC \uBCF4\uACE0\uD558\uC138\uC694. P0, P1, P2, Nit\uC740 \uBCF4\uACE0\uD558\uC9C0 \uB9C8\uC138\uC694 \u2014 \uC815\uD655\uC131\uACFC \uBCF4\uC548\uC740 \uBCC4\uB3C4\uC758 \uB9AC\uBDF0\uC5B4\uAC00 \uB2F4\uB2F9\uD569\uB2C8\uB2E4.",
+    "",
+    'finding\uC740 "Over-engineering"\uC774\uB77C\uB294 \uBCC4\uB3C4\uC758 \uCD5C\uC0C1\uC704 \uC139\uC158\uC73C\uB85C \uBCF4\uACE0\uD558\uACE0, correctness/security \uC139\uC158\uACFC \uC808\uB300 \uC11E\uC9C0 \uB9C8\uC138\uC694.'
+  ];
+  return [...body, "", renderFindingSchemaInstruction(locale, OVER_ENGINEERING_PRIORITIES), "", renderDedupInstruction(locale)].join("\n");
+}
+
+// ../review-policy/dist/verdict-gate/verdict-gate.js
+var ROUND_MARKER = "<!-- archweave-review-round -->";
+
+// ../template-engine/dist/review/config-snippet.js
+function buildReviewConfigSnippet(input) {
+  return {
+    enabled: true,
+    provider: input.provider,
+    mode: input.mode,
+    locale: input.locale,
+    maxRounds: input.maxRounds,
+    blockingPriorities: ["P0", "P1"]
+  };
+}
+
+// ../template-engine/dist/review/workflow-skeleton.js
+function indentBlock(text, spaces) {
+  const pad = " ".repeat(spaces);
+  return text.split("\n").map((line) => line.length === 0 ? line : pad + line).join("\n");
+}
+function renderTriggerBlock() {
+  return ["on:", "  pull_request:", "    types: [opened, synchronize, ready_for_review, reopened]"].join("\n");
+}
+function renderConcurrencyBlock() {
+  return [
+    "concurrency:",
+    "  group: archweave-review-${{ github.event.pull_request.number }}",
+    "  cancel-in-progress: false"
+  ].join("\n");
+}
+function renderPermissionsBlock() {
+  return ["permissions:", "  contents: read", "  pull-requests: write", "  id-token: write"].join("\n");
+}
+function renderSecretGateStep(secretName) {
+  return [
+    "- name: Check review secret",
+    "  id: secret-gate",
+    "  env:",
+    `    REVIEW_SECRET: \${{ secrets.${secretName} }}`,
+    "  run: |",
+    '    if [ -z "$REVIEW_SECRET" ]; then',
+    `      echo "AI review is not active: register the ${secretName} secret to enable it."`,
+    '      echo "enabled=false" >> "$GITHUB_OUTPUT"',
+    "    else",
+    '      echo "enabled=true" >> "$GITHUB_OUTPUT"',
+    "    fi"
+  ].join("\n");
+}
+function renderRoundGateStep(maxRounds) {
+  return [
+    "- name: Check review round limit",
+    "  id: round-gate",
+    "  if: steps.secret-gate.outputs.enabled == 'true'",
+    "  env:",
+    "    GH_TOKEN: ${{ github.token }}",
+    "  run: |",
+    `    counts=$(gh api "repos/\${{ github.repository }}/issues/\${{ github.event.pull_request.number }}/comments" --paginate --jq '[([.[] | select(.body | contains("${ROUND_MARKER}"))] | length), ([.[].id] | max // 0)]' | jq -s -r '[(map(.[0]) | add // 0), (map(.[1]) | max // 0)] | @tsv')`,
+    `    rounds=$(printf '%s' "$counts" | cut -f1)`,
+    `    echo "last-comment-id=$(printf '%s' "$counts" | cut -f2)" >> "$GITHUB_OUTPUT"`,
+    `    if [ "$rounds" -ge ${maxRounds} ]; then`,
+    `      echo "Automated review round limit (${maxRounds}) reached for this PR; skipping."`,
+    '      echo "allowed=false" >> "$GITHUB_OUTPUT"',
+    "    else",
+    '      echo "allowed=true" >> "$GITHUB_OUTPUT"',
+    "    fi"
+  ].join("\n");
+}
+function renderVerdictGateStep(maxRounds, locale) {
+  return [
+    "- name: Compute review verdict",
+    "  if: steps.secret-gate.outputs.enabled == 'true' && steps.round-gate.outputs.allowed == 'true'",
+    "  env:",
+    "    GH_TOKEN: ${{ github.token }}",
+    "    GITHUB_REPOSITORY: ${{ github.repository }}",
+    "    ARCHWEAVE_PR_NUMBER: ${{ github.event.pull_request.number }}",
+    `    ARCHWEAVE_MAX_ROUNDS: '${maxRounds}'`,
+    `    ARCHWEAVE_LOCALE: '${locale}'`,
+    "    ARCHWEAVE_HEAD_SHA: ${{ github.event.pull_request.head.sha }}",
+    "    ARCHWEAVE_ROUND_AFTER_ID: ${{ steps.round-gate.outputs.last-comment-id }}",
+    "  run: |",
+    "    if [ -x node_modules/.bin/archweave-review-verdict ]; then",
+    "      node_modules/.bin/archweave-review-verdict",
+    "    else",
+    '      echo "nx-archweave is not installed in this workspace - skipping the verdict gate."',
+    "    fi"
+  ].join("\n");
+}
+var SETUP_NODE_VERSION = "22";
+var SETUP_PNPM_VERSION = "10";
+var SETUP_BUN_ACTION = "oven-sh/setup-bun@v2";
+var INSTALL_LINES = {
+  pnpm: ["    pnpm install --frozen-lockfile"],
+  npm: ["    npm ci"],
+  yarn: [
+    "    corepack enable yarn",
+    '    if [ "$(yarn --version | cut -d. -f1)" -ge 2 ]; then yarn install --immutable; else yarn install --frozen-lockfile; fi'
+  ],
+  bun: ["    bun install --frozen-lockfile"]
+};
+function renderWorkspaceSetupSteps(packageManager) {
+  const gate = "  if: steps.secret-gate.outputs.enabled == 'true' && steps.round-gate.outputs.allowed == 'true'";
+  const steps = [];
+  if (packageManager === "pnpm") {
+    steps.push(["- name: Set up pnpm", gate, "  uses: pnpm/action-setup@v4", "  with:", `    version: ${SETUP_PNPM_VERSION}`].join("\n"));
+  }
+  if (packageManager === "bun") {
+    steps.push(["- name: Set up bun", gate, `  uses: ${SETUP_BUN_ACTION}`].join("\n"));
+  }
+  steps.push([
+    "- name: Set up Node",
+    gate,
+    "  uses: actions/setup-node@v4",
+    "  with:",
+    `    node-version: ${SETUP_NODE_VERSION}`,
+    // yarn: no setup-node cache — it would query the runner's global yarn 1 even in a
+    // berry project. Corepack (shipped with Node) provides the project's own yarn below.
+    // bun: setup-node has no bun cache. Node is still set up — nx and the verdict bin
+    // run on it.
+    ...packageManager === "yarn" || packageManager === "bun" ? [] : [`    cache: ${packageManager}`]
+  ].join("\n"));
+  steps.push([
+    "- name: Install workspace dependencies",
+    gate,
+    "  run: |",
+    ...INSTALL_LINES[packageManager]
+  ].join("\n"));
+  return steps.join("\n\n");
+}
+
+// ../template-engine/dist/review/claude/claude-provider.js
+var SECRET_NAME = "CLAUDE_CODE_OAUTH_TOKEN";
+var ALLOWED_TOOLS = "mcp__github_inline_comment__create_inline_comment,Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*)";
+function renderWorkflowInstructions(locale) {
+  const lines = locale === "en" ? [
+    "Review the diff of this pull request using `gh pr diff` and `gh pr view`.",
+    "Post specific findings as inline comments and exactly one top-level summary comment.",
+    `Always include the literal marker ${ROUND_MARKER} in the top-level summary comment.`,
+    "If there are no findings that require action, post exactly one top-level comment saying so (and still include the marker).",
+    "Do not modify any code, and never approve or merge the pull request.",
+    "Write summaries and explanations in English; keep file names, function names, and identifiers verbatim."
+  ] : [
+    "\uC774 pull request\uC758 diff\uB97C `gh pr diff`\uC640 `gh pr view`\uB85C \uD655\uC778\uD558\uACE0 \uB9AC\uBDF0\uD558\uC138\uC694.",
+    "\uAD6C\uCCB4\uC801 \uC9C0\uC801\uC740 inline comment\uB85C, \uC804\uCCB4 \uC694\uC57D\uC740 \uC815\uD655\uD788 \uD55C \uAC1C\uC758 top-level comment\uB85C \uAC8C\uC2DC\uD558\uC138\uC694.",
+    `top-level \uC694\uC57D \uCF54\uBA58\uD2B8\uC5D0\uB294 \uBC18\uB4DC\uC2DC \uB9AC\uD130\uB7F4 \uB9C8\uCEE4 ${ROUND_MARKER}\uB97C \uD3EC\uD568\uD558\uC138\uC694.`,
+    '\uC870\uCE58\uAC00 \uD544\uC694\uD55C \uBB38\uC81C\uAC00 \uC5C6\uC73C\uBA74 "\uC870\uCE58\uAC00 \uD544\uC694\uD55C \uBB38\uC81C\uB97C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4."\uB77C\uB294 top-level comment\uB97C \uC815\uD655\uD788 \uD55C \uAC1C \uAC8C\uC2DC\uD558\uC138\uC694(\uC774\uB54C\uB3C4 \uB9C8\uCEE4\uB294 \uD3EC\uD568).',
+    "\uCF54\uB4DC\uB97C \uC218\uC815\uD558\uC9C0 \uB9C8\uC138\uC694(Do not modify any code). PR\uC744 \uC2B9\uC778\uD558\uAC70\uB098 \uBCD1\uD569\uD558\uC9C0 \uB9C8\uC138\uC694(never approve or merge).",
+    "\uC694\uC57D\uACFC \uC124\uBA85\uC740 \uD55C\uAD6D\uC5B4\uB85C \uC4F0\uB418, \uD30C\uC77C\uBA85\xB7\uD568\uC218\uBA85\xB7\uC2DD\uBCC4\uC790\uB294 \uC6D0\uBB38 \uADF8\uB300\uB85C \uC720\uC9C0\uD558\uC138\uC694."
+  ];
+  return lines.join("\n");
+}
+function composePrompt(input) {
+  const mode = REVIEW_MODES[input.mode];
+  const sections = [renderWorkflowInstructions(input.locale), buildCorrectnessSecurityPrompt(input.locale, mode.promptStyle)];
+  if (mode.includesOverEngineering) {
+    sections.push(buildOverEngineeringPrompt(input.locale));
+  }
+  sections.push(renderFindingsBlockInstruction(input.locale));
+  return sections.join("\n\n---\n\n");
+}
+function buildWorkflowYaml(input) {
+  const steps = [
+    renderSecretGateStep(SECRET_NAME),
+    renderRoundGateStep(input.maxRounds),
+    [
+      "- name: Checkout repository",
+      "  if: steps.secret-gate.outputs.enabled == 'true' && steps.round-gate.outputs.allowed == 'true'",
+      "  uses: actions/checkout@v4",
+      "  with:",
+      "    fetch-depth: 1"
+    ].join("\n"),
+    [
+      "- name: Run Claude review",
+      "  if: steps.secret-gate.outputs.enabled == 'true' && steps.round-gate.outputs.allowed == 'true'",
+      "  uses: anthropics/claude-code-action@v1",
+      "  with:",
+      `    claude_code_oauth_token: \${{ secrets.${SECRET_NAME} }}`,
+      "    prompt: |",
+      indentBlock(composePrompt(input), 6),
+      "    claude_args: |",
+      `      --allowedTools "${ALLOWED_TOOLS}"`
+    ].join("\n"),
+    renderWorkspaceSetupSteps(input.packageManager),
+    renderVerdictGateStep(input.maxRounds, input.locale)
+  ];
+  return [
+    "name: Claude Code Review",
+    "",
+    renderTriggerBlock(),
+    "",
+    renderConcurrencyBlock(),
+    "",
+    renderPermissionsBlock(),
+    "",
+    "jobs:",
+    "  review:",
+    "    runs-on: ubuntu-latest",
+    "    steps:",
+    indentBlock(steps.join("\n\n"), 6),
+    ""
+  ].join("\n");
+}
+var claudeProvider = {
+  id: "claude",
+  workflowFileName: ".github/workflows/claude-code-review.yml",
+  requiredSecretName: SECRET_NAME,
+  buildWorkflowYaml
+};
+
+// ../template-engine/dist/review/cursor/cursor-provider.js
+var SECRET_NAME2 = "CURSOR_API_KEY";
+var PROMPT_HEREDOC_DELIMITER = "ARCHWEAVE_CURSOR_REVIEW_PROMPT";
+function renderWorkflowInstructions2(locale) {
+  const lines = locale === "en" ? [
+    "Review the diff of this pull request using `gh pr diff` and `gh pr view`.",
+    "Post specific findings as inline comments and exactly one top-level summary comment.",
+    `Always include the literal marker ${ROUND_MARKER} in the top-level summary comment.`,
+    "If there are no findings that require action, post exactly one top-level comment saying so (and still include the marker).",
+    "Do not modify any code, and never approve or merge the pull request.",
+    "Write summaries and explanations in English; keep file names, function names, and identifiers verbatim."
+  ] : [
+    "\uC774 pull request\uC758 diff\uB97C `gh pr diff`\uC640 `gh pr view`\uB85C \uD655\uC778\uD558\uACE0 \uB9AC\uBDF0\uD558\uC138\uC694.",
+    "\uAD6C\uCCB4\uC801 \uC9C0\uC801\uC740 inline comment\uB85C, \uC804\uCCB4 \uC694\uC57D\uC740 \uC815\uD655\uD788 \uD55C \uAC1C\uC758 top-level comment\uB85C \uAC8C\uC2DC\uD558\uC138\uC694.",
+    `top-level \uC694\uC57D \uCF54\uBA58\uD2B8\uC5D0\uB294 \uBC18\uB4DC\uC2DC \uB9AC\uD130\uB7F4 \uB9C8\uCEE4 ${ROUND_MARKER}\uB97C \uD3EC\uD568\uD558\uC138\uC694.`,
+    '\uC870\uCE58\uAC00 \uD544\uC694\uD55C \uBB38\uC81C\uAC00 \uC5C6\uC73C\uBA74 "\uC870\uCE58\uAC00 \uD544\uC694\uD55C \uBB38\uC81C\uB97C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4."\uB77C\uB294 top-level comment\uB97C \uC815\uD655\uD788 \uD55C \uAC1C \uAC8C\uC2DC\uD558\uC138\uC694(\uC774\uB54C\uB3C4 \uB9C8\uCEE4\uB294 \uD3EC\uD568).',
+    "\uCF54\uB4DC\uB97C \uC218\uC815\uD558\uC9C0 \uB9C8\uC138\uC694(Do not modify any code). PR\uC744 \uC2B9\uC778\uD558\uAC70\uB098 \uBCD1\uD569\uD558\uC9C0 \uB9C8\uC138\uC694(never approve or merge).",
+    "\uC694\uC57D\uACFC \uC124\uBA85\uC740 \uD55C\uAD6D\uC5B4\uB85C \uC4F0\uB418, \uD30C\uC77C\uBA85\xB7\uD568\uC218\uBA85\xB7\uC2DD\uBCC4\uC790\uB294 \uC6D0\uBB38 \uADF8\uB300\uB85C \uC720\uC9C0\uD558\uC138\uC694."
+  ];
+  return lines.join("\n");
+}
+function composePrompt2(input) {
+  const mode = REVIEW_MODES[input.mode];
+  const sections = [renderWorkflowInstructions2(input.locale), buildCorrectnessSecurityPrompt(input.locale, mode.promptStyle)];
+  if (mode.includesOverEngineering) {
+    sections.push(buildOverEngineeringPrompt(input.locale));
+  }
+  sections.push(renderFindingsBlockInstruction(input.locale));
+  return sections.join("\n\n---\n\n");
+}
+function buildWorkflowYaml2(input) {
+  const gateCondition = "steps.secret-gate.outputs.enabled == 'true' && steps.round-gate.outputs.allowed == 'true'";
+  const steps = [
+    renderSecretGateStep(SECRET_NAME2),
+    renderRoundGateStep(input.maxRounds),
+    [
+      "- name: Checkout repository",
+      `  if: ${gateCondition}`,
+      "  uses: actions/checkout@v4",
+      "  with:",
+      "    fetch-depth: 1"
+    ].join("\n"),
+    [
+      "- name: Install cursor-agent CLI",
+      `  if: ${gateCondition}`,
+      "  run: |",
+      "    curl https://cursor.com/install -fsS | bash",
+      '    echo "$HOME/.cursor/bin" >> "$GITHUB_PATH"'
+    ].join("\n"),
+    [
+      "- name: Run Cursor review",
+      `  if: ${gateCondition}`,
+      "  env:",
+      `    CURSOR_API_KEY: \${{ secrets.${SECRET_NAME2} }}`,
+      "    GH_TOKEN: ${{ github.token }}",
+      "  run: |",
+      `    agent -p "$(cat <<'${PROMPT_HEREDOC_DELIMITER}'`,
+      indentBlock(composePrompt2(input), 4),
+      `    ${PROMPT_HEREDOC_DELIMITER}`,
+      '    )"'
+    ].join("\n"),
+    renderWorkspaceSetupSteps(input.packageManager),
+    renderVerdictGateStep(input.maxRounds, input.locale)
+  ];
+  return [
+    "name: Cursor Code Review",
+    "",
+    renderTriggerBlock(),
+    "",
+    renderConcurrencyBlock(),
+    "",
+    renderPermissionsBlock(),
+    "",
+    "jobs:",
+    "  review:",
+    "    runs-on: ubuntu-latest",
+    "    steps:",
+    indentBlock(steps.join("\n\n"), 6),
+    ""
+  ].join("\n");
+}
+var cursorProvider = {
+  id: "cursor",
+  workflowFileName: ".github/workflows/cursor-code-review.yml",
+  requiredSecretName: SECRET_NAME2,
+  buildWorkflowYaml: buildWorkflowYaml2
+};
+
+// ../template-engine/dist/review/gemini/gemini-provider.js
+var SECRET_NAME3 = "GEMINI_API_KEY";
+function renderWorkflowInstructions3(locale) {
+  const lines = locale === "en" ? [
+    "Review the diff of this pull request using `gh pr diff` and `gh pr view`.",
+    "Post specific findings as inline comments and exactly one top-level summary comment.",
+    `Always include the literal marker ${ROUND_MARKER} in the top-level summary comment.`,
+    "If there are no findings that require action, post exactly one top-level comment saying so (and still include the marker).",
+    "Do not modify any code, and never approve or merge the pull request.",
+    "Write summaries and explanations in English; keep file names, function names, and identifiers verbatim."
+  ] : [
+    "\uC774 pull request\uC758 diff\uB97C `gh pr diff`\uC640 `gh pr view`\uB85C \uD655\uC778\uD558\uACE0 \uB9AC\uBDF0\uD558\uC138\uC694.",
+    "\uAD6C\uCCB4\uC801 \uC9C0\uC801\uC740 inline comment\uB85C, \uC804\uCCB4 \uC694\uC57D\uC740 \uC815\uD655\uD788 \uD55C \uAC1C\uC758 top-level comment\uB85C \uAC8C\uC2DC\uD558\uC138\uC694.",
+    `top-level \uC694\uC57D \uCF54\uBA58\uD2B8\uC5D0\uB294 \uBC18\uB4DC\uC2DC \uB9AC\uD130\uB7F4 \uB9C8\uCEE4 ${ROUND_MARKER}\uB97C \uD3EC\uD568\uD558\uC138\uC694.`,
+    '\uC870\uCE58\uAC00 \uD544\uC694\uD55C \uBB38\uC81C\uAC00 \uC5C6\uC73C\uBA74 "\uC870\uCE58\uAC00 \uD544\uC694\uD55C \uBB38\uC81C\uB97C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4."\uB77C\uB294 top-level comment\uB97C \uC815\uD655\uD788 \uD55C \uAC1C \uAC8C\uC2DC\uD558\uC138\uC694(\uC774\uB54C\uB3C4 \uB9C8\uCEE4\uB294 \uD3EC\uD568).',
+    "\uCF54\uB4DC\uB97C \uC218\uC815\uD558\uC9C0 \uB9C8\uC138\uC694(Do not modify any code). PR\uC744 \uC2B9\uC778\uD558\uAC70\uB098 \uBCD1\uD569\uD558\uC9C0 \uB9C8\uC138\uC694(never approve or merge).",
+    "\uC694\uC57D\uACFC \uC124\uBA85\uC740 \uD55C\uAD6D\uC5B4\uB85C \uC4F0\uB418, \uD30C\uC77C\uBA85\xB7\uD568\uC218\uBA85\xB7\uC2DD\uBCC4\uC790\uB294 \uC6D0\uBB38 \uADF8\uB300\uB85C \uC720\uC9C0\uD558\uC138\uC694."
+  ];
+  return lines.join("\n");
+}
+function composePrompt3(input) {
+  const mode = REVIEW_MODES[input.mode];
+  const sections = [renderWorkflowInstructions3(input.locale), buildCorrectnessSecurityPrompt(input.locale, mode.promptStyle)];
+  if (mode.includesOverEngineering) {
+    sections.push(buildOverEngineeringPrompt(input.locale));
+  }
+  sections.push(renderFindingsBlockInstruction(input.locale));
+  return sections.join("\n\n---\n\n");
+}
+function buildWorkflowYaml3(input) {
+  const steps = [
+    renderSecretGateStep(SECRET_NAME3),
+    renderRoundGateStep(input.maxRounds),
+    [
+      "- name: Checkout repository",
+      "  if: steps.secret-gate.outputs.enabled == 'true' && steps.round-gate.outputs.allowed == 'true'",
+      "  uses: actions/checkout@v4",
+      "  with:",
+      "    fetch-depth: 1"
+    ].join("\n"),
+    [
+      "- name: Run Gemini review",
+      "  if: steps.secret-gate.outputs.enabled == 'true' && steps.round-gate.outputs.allowed == 'true'",
+      "  uses: google-github-actions/run-gemini-cli@v0",
+      "  env:",
+      "    GITHUB_TOKEN: ${{ github.token }}",
+      "  with:",
+      `    gemini_api_key: \${{ secrets.${SECRET_NAME3} }}`,
+      "    prompt: |",
+      indentBlock(composePrompt3(input), 6)
+    ].join("\n"),
+    renderWorkspaceSetupSteps(input.packageManager),
+    renderVerdictGateStep(input.maxRounds, input.locale)
+  ];
+  return [
+    "name: Gemini Code Review",
+    "",
+    renderTriggerBlock(),
+    "",
+    renderConcurrencyBlock(),
+    "",
+    renderPermissionsBlock(),
+    "",
+    "jobs:",
+    "  review:",
+    "    runs-on: ubuntu-latest",
+    "    steps:",
+    indentBlock(steps.join("\n\n"), 6),
+    ""
+  ].join("\n");
+}
+var geminiProvider = {
+  id: "gemini",
+  workflowFileName: ".github/workflows/gemini-code-review.yml",
+  requiredSecretName: SECRET_NAME3,
+  buildWorkflowYaml: buildWorkflowYaml3
+};
+
+// ../template-engine/dist/review/gpt/gpt-provider.js
+var SECRET_NAME4 = "OPENAI_API_KEY";
+function renderWorkflowInstructions4(locale) {
+  const lines = locale === "en" ? [
+    "Review ONLY the changes introduced by this pull request. The base and head commits are already fetched under fixed ref names: run `git diff origin/pr-base...origin/pr-head` (and `git log origin/pr-base..origin/pr-head` for commit context) \u2014 this sandboxed step has no network access, so do not attempt to run `gh` or reach the GitHub API.",
+    "Write your entire response as a single message: report specific findings, then close with one overall summary.",
+    `Always include the literal marker ${ROUND_MARKER} in your message.`,
+    "If there are no findings that require action, write exactly one message saying so (and still include the marker).",
+    "Do not modify any code, and never approve or merge the pull request.",
+    "Write summaries and explanations in English; keep file names, function names, and identifiers verbatim."
+  ] : [
+    "\uC774 pull request\uAC00 \uB3C4\uC785\uD55C \uBCC0\uACBD \uC0AC\uD56D\uB9CC \uB9AC\uBDF0\uD558\uC138\uC694. base/head \uCEE4\uBC0B\uC740 \uACE0\uC815 ref \uC774\uB984\uC73C\uB85C \uC774\uBBF8 fetch\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4: `git diff origin/pr-base...origin/pr-head`\uB85C \uBE44\uAD50\uD558\uACE0, \uCEE4\uBC0B \uB9E5\uB77D\uC740 `git log origin/pr-base..origin/pr-head`\uB85C \uD655\uC778\uD558\uC138\uC694(\uC774 \uC0CC\uB4DC\uBC15\uC2A4 \uC2A4\uD15D\uC740 \uB124\uD2B8\uC6CC\uD06C\uAC00 \uC5C6\uC73C\uBBC0\uB85C `gh`\uB098 GitHub API\uB97C \uD638\uCD9C\uD558\uC9C0 \uB9C8\uC138\uC694).",
+    "\uC804\uCCB4 \uC751\uB2F5\uC744 \uD558\uB098\uC758 \uBA54\uC2DC\uC9C0\uB85C \uC791\uC131\uD558\uC138\uC694: \uAD6C\uCCB4\uC801 \uC9C0\uC801\uC744 \uC801\uC740 \uB4A4 \uB9C8\uC9C0\uB9C9\uC5D0 \uC804\uCCB4 \uC694\uC57D\uC744 \uD55C \uBC88 \uB354 \uB0A8\uAE30\uC138\uC694.",
+    `\uBA54\uC2DC\uC9C0\uC5D0\uB294 \uBC18\uB4DC\uC2DC \uB9AC\uD130\uB7F4 \uB9C8\uCEE4 ${ROUND_MARKER}\uB97C \uD3EC\uD568\uD558\uC138\uC694.`,
+    '\uC870\uCE58\uAC00 \uD544\uC694\uD55C \uBB38\uC81C\uAC00 \uC5C6\uC73C\uBA74 "\uC870\uCE58\uAC00 \uD544\uC694\uD55C \uBB38\uC81C\uB97C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4."\uB77C\uB294 \uBA54\uC2DC\uC9C0\uB97C \uC815\uD655\uD788 \uD55C \uAC1C \uC791\uC131\uD558\uC138\uC694(\uC774\uB54C\uB3C4 \uB9C8\uCEE4\uB294 \uD3EC\uD568).',
+    "\uCF54\uB4DC\uB97C \uC218\uC815\uD558\uC9C0 \uB9C8\uC138\uC694(Do not modify any code). PR\uC744 \uC2B9\uC778\uD558\uAC70\uB098 \uBCD1\uD569\uD558\uC9C0 \uB9C8\uC138\uC694(never approve or merge).",
+    "\uC694\uC57D\uACFC \uC124\uBA85\uC740 \uD55C\uAD6D\uC5B4\uB85C \uC4F0\uB418, \uD30C\uC77C\uBA85\xB7\uD568\uC218\uBA85\xB7\uC2DD\uBCC4\uC790\uB294 \uC6D0\uBB38 \uADF8\uB300\uB85C \uC720\uC9C0\uD558\uC138\uC694."
+  ];
+  return lines.join("\n");
+}
+function composePrompt4(input) {
+  const mode = REVIEW_MODES[input.mode];
+  const sections = [renderWorkflowInstructions4(input.locale), buildCorrectnessSecurityPrompt(input.locale, mode.promptStyle)];
+  if (mode.includesOverEngineering) {
+    sections.push(buildOverEngineeringPrompt(input.locale));
+  }
+  sections.push(renderFindingsBlockInstruction(input.locale));
+  return sections.join("\n\n---\n\n");
+}
+function buildWorkflowYaml4(input) {
+  const gateCondition = "steps.secret-gate.outputs.enabled == 'true' && steps.round-gate.outputs.allowed == 'true'";
+  const steps = [
+    renderSecretGateStep(SECRET_NAME4),
+    renderRoundGateStep(input.maxRounds),
+    [
+      "- name: Checkout repository",
+      `  if: ${gateCondition}`,
+      "  uses: actions/checkout@v4",
+      "  with:",
+      "    ref: refs/pull/${{ github.event.pull_request.number }}/merge",
+      "    fetch-depth: 1",
+      "    persist-credentials: false"
+    ].join("\n"),
+    [
+      "- name: Fetch base and head refs for the PR",
+      `  if: ${gateCondition}`,
+      "  env:",
+      "    PR_BASE_REF: ${{ github.event.pull_request.base.ref }}",
+      "    PR_NUMBER: ${{ github.event.pull_request.number }}",
+      "  run: |",
+      "    # Explicit destinations: the sandboxed review step has no network, so both sides",
+      "    # of the diff must survive as stable local refs (FETCH_HEAD alone is ambiguous).",
+      "    git fetch --no-tags origin \\",
+      '      "+refs/heads/$PR_BASE_REF:refs/remotes/origin/pr-base" \\',
+      '      "+refs/pull/$PR_NUMBER/head:refs/remotes/origin/pr-head"'
+    ].join("\n"),
+    [
+      "- name: Run Codex review",
+      "  id: codex-review",
+      `  if: ${gateCondition}`,
+      "  uses: openai/codex-action@v1",
+      "  with:",
+      `    openai-api-key: \${{ secrets.${SECRET_NAME4} }}`,
+      '    permission-profile: ":read-only"',
+      "    prompt: |",
+      indentBlock(composePrompt4(input), 6)
+    ].join("\n"),
+    [
+      "- name: Post review comment",
+      `  if: ${gateCondition}`,
+      "  env:",
+      "    GH_TOKEN: ${{ github.token }}",
+      "    PR_NUMBER: ${{ github.event.pull_request.number }}",
+      "    REVIEW_BODY: ${{ steps.codex-review.outputs.final-message }}",
+      "  run: |",
+      '    printf %s "$REVIEW_BODY" | gh pr comment "$PR_NUMBER" --body-file -'
+    ].join("\n"),
+    renderWorkspaceSetupSteps(input.packageManager),
+    renderVerdictGateStep(input.maxRounds, input.locale)
+  ];
+  return [
+    "name: GPT Code Review",
+    "",
+    renderTriggerBlock(),
+    "",
+    renderConcurrencyBlock(),
+    "",
+    renderPermissionsBlock(),
+    "",
+    "jobs:",
+    "  review:",
+    "    runs-on: ubuntu-latest",
+    "    steps:",
+    indentBlock(steps.join("\n\n"), 6),
+    ""
+  ].join("\n");
+}
+var gptProvider = {
+  id: "gpt",
+  workflowFileName: ".github/workflows/gpt-code-review.yml",
+  requiredSecretName: SECRET_NAME4,
+  buildWorkflowYaml: buildWorkflowYaml4
+};
+
+// ../template-engine/dist/review/provider.js
+var REVIEW_PROVIDERS = {
+  claude: claudeProvider,
+  gemini: geminiProvider,
+  gpt: gptProvider,
+  cursor: cursorProvider
+};
+
+// ../template-engine/dist/review/compose-review-setup.js
+function composeReviewSetup(input) {
+  if (!input.enabled)
+    return null;
+  const provider = REVIEW_PROVIDERS[input.provider];
+  return {
+    workflowFilePath: provider.workflowFileName,
+    workflowYaml: provider.buildWorkflowYaml(input),
+    requiredSecretName: provider.requiredSecretName,
+    configSnippet: buildReviewConfigSnippet(input)
+  };
+}
+
+// ../template-engine/dist/review/conflict.js
+function judgeReviewFileConflict(existing, generated) {
+  if (existing === null)
+    return { kind: "create" };
+  if (existing === generated)
+    return { kind: "unchanged" };
+  return { kind: "merge-proposal", existing, generated };
+}
+
+// src/generators/shared/dry-run.ts
+function resolveDryRun(options) {
+  return process.env["NX_DRY_RUN"] === "true" || (options.dryRun ?? false);
+}
+
+// src/generators/shared/toolkit-config-file.ts
+function detectIndent(raw) {
+  for (const line of raw.split("\n")) {
+    const match = /^(\t+| +)/.exec(line);
+    if (match) return match[1];
+  }
+  return "  ";
+}
+function recordedChoice(config, key, allowed) {
+  const value = config?.[key];
+  return typeof value === "string" && allowed.includes(value) ? value : void 0;
+}
+var RECORDED_PACKAGE_MANAGERS = ["pnpm", "npm", "yarn", "bun"];
+function workspacePackageManager(exists, read, config) {
+  return detectWorkspacePackageManager(exists, read) ?? recordedChoice(config, "packageManager", RECORDED_PACKAGE_MANAGERS) ?? null;
+}
+function treePackageManager(tree, config) {
+  return workspacePackageManager((p) => tree.exists(p), (p) => tree.read(p, "utf-8"), config);
+}
+
+// src/generators/add-review/render.ts
+function renderLineDiff(existing, generated) {
+  const a = existing.split("\n");
+  const b = generated.split("\n");
+  const m = a.length;
+  const n = b.length;
+  const lcs = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+  for (let i2 = m - 1; i2 >= 0; i2--) {
+    for (let j2 = n - 1; j2 >= 0; j2--) {
+      lcs[i2][j2] = a[i2] === b[j2] ? lcs[i2 + 1][j2 + 1] + 1 : Math.max(lcs[i2 + 1][j2], lcs[i2][j2 + 1]);
+    }
+  }
+  const out = ["--- existing", "+++ generated"];
+  let i = 0;
+  let j = 0;
+  while (i < m && j < n) {
+    if (a[i] === b[j]) {
+      out.push(`  ${a[i]}`);
+      i++;
+      j++;
+    } else if (lcs[i + 1][j] >= lcs[i][j + 1]) {
+      out.push(`- ${a[i]}`);
+      i++;
+    } else {
+      out.push(`+ ${b[j]}`);
+      j++;
+    }
+  }
+  while (i < m) out.push(`- ${a[i++]}`);
+  while (j < n) out.push(`+ ${b[j++]}`);
+  return out.join("\n");
+}
+var WORKFLOW_ACTION_LINES = {
+  created: "created",
+  overwritten: "overwritten with the generated version (per --onConflict=overwrite)",
+  unchanged: "unchanged (already matches the generated version)",
+  proposed: "NOT written \u2014 differs from the generated version (merge proposal below)",
+  skipped: "left as-is (per --onConflict=skip)",
+  alternate: "generated alongside the existing file",
+  aborted: "NOT written"
+};
+var CONFIG_ACTION_LINES = {
+  created: "created with the review field",
+  updated: "review field updated",
+  unchanged: "review field unchanged",
+  "not-updated": "NOT updated \u2014 kept consistent with the workflow file that is actually in effect",
+  aborted: "NOT updated"
+};
+function renderAddReviewReport(report) {
+  const lines = [];
+  if (report.packageManagerNote !== void 0) {
+    lines.push(`Note: ${report.packageManagerNote}`);
+  }
+  if (report.workflowAction === "aborted") {
+    lines.push("add-review aborted \u2014 nothing was written.");
+    lines.push(`  toolkit.config.json: ${report.configError ?? "unusable"}`);
+    lines.push("  Fix the config file manually, then rerun the generator.");
+    return lines.join("\n");
+  }
+  if (report.dryRun) {
+    lines.push("add-review dry-run \u2014 no files were written.");
+    lines.push("");
+    lines.push("Generated workflow YAML:");
+    lines.push(report.workflowYaml ?? "");
+    lines.push("");
+    lines.push("toolkit.config.json review field:");
+    lines.push(report.configSnippetJson ?? "");
+    lines.push("");
+    lines.push("Effective decision:");
+  }
+  lines.push(`  ${report.workflowPath}: ${WORKFLOW_ACTION_LINES[report.workflowAction]}`);
+  lines.push(`  toolkit.config.json: ${CONFIG_ACTION_LINES[report.configAction]}`);
+  if (report.workflowAction === "proposed" && report.diff) {
+    lines.push("");
+    lines.push(report.diff);
+    lines.push("");
+    lines.push("To resolve, rerun with one of:");
+    lines.push("  --onConflict=overwrite            replace the existing file with the generated version");
+    lines.push("  --onConflict=skip                 keep the existing file");
+    lines.push("  --onConflict=alternate-filename   write the generated version alongside it");
+  }
+  if (report.workflowAction === "alternate") {
+    lines.push("");
+    lines.push("  Review the generated file, then replace the main workflow file with it yourself;");
+    lines.push("  the config stays pointing at the workflow that is actually in effect until you do.");
+  }
+  lines.push("");
+  lines.push(`Note: the review workflow stays green-skipped until you register the ${report.requiredSecretName} secret.`);
+  lines.push("Note: this workflow runs with elevated permissions only after it is merged to the default branch \u2014");
+  lines.push("merging is the first real validation.");
+  return lines.join("\n");
+}
+
+// src/generators/add-review/generator.ts
+var CONFIG_PATH = "toolkit.config.json";
+function deriveAltWorkflowPath(mainWorkflowPath) {
+  return mainWorkflowPath.replace(/\.yml$/, ".archweave.yml");
+}
+function readConfig(tree) {
+  const raw = tree.read(CONFIG_PATH, "utf-8");
+  if (raw === null) return { raw: null, parsed: null, error: null };
+  try {
+    const parsed = JSON.parse(raw);
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+      return { raw, parsed: null, error: `${CONFIG_PATH} must contain a top-level JSON object` };
+    }
+    return { raw, parsed, error: null };
+  } catch {
+    return { raw, parsed: null, error: `${CONFIG_PATH} is not valid JSON` };
+  }
+}
+function resolveLocale(option, config) {
+  if (option) return option;
+  const fromConfig = config.parsed?.["locale"];
+  return fromConfig === "ko" || fromConfig === "en" ? fromConfig : "en";
+}
+function deepEqual(a, b) {
+  if (a === b) return true;
+  if (typeof a !== "object" || typeof b !== "object" || a === null || b === null) return false;
+  if (Array.isArray(a) || Array.isArray(b)) {
+    return Array.isArray(a) && Array.isArray(b) && a.length === b.length && a.every((value, index) => deepEqual(value, b[index]));
+  }
+  const aKeys = Object.keys(a).sort();
+  const bKeys = Object.keys(b).sort();
+  if (aKeys.length !== bKeys.length || aKeys.some((key, index) => key !== bKeys[index])) return false;
+  return aKeys.every((key) => deepEqual(a[key], b[key]));
+}
+var PROVIDERS = ["claude", "gemini", "gpt", "cursor"];
+var MODES = ["fast", "standard", "thorough"];
+function recordedReview(config) {
+  const review = config?.["review"];
+  if (typeof review !== "object" || review === null || Array.isArray(review)) return {};
+  const record = review;
+  const pick = (value, allowed) => typeof value === "string" && allowed.includes(value) ? value : void 0;
+  const rounds = record["maxRounds"];
+  return {
+    provider: pick(record["provider"], PROVIDERS),
+    mode: pick(record["mode"], MODES),
+    maxRounds: rounds === 1 || rounds === 2 || rounds === 3 || rounds === 4 || rounds === 5 ? rounds : void 0
+  };
+}
+function runAddReview(tree, options) {
+  const config = readConfig(tree);
+  const detectedPm = treePackageManager(tree, config.parsed);
+  const packageManager = options.packageManager ?? detectedPm ?? "pnpm";
+  const packageManagerNote = options.packageManager === void 0 && detectedPm === null ? "the package manager could not be detected (no pnpm, yarn, bun or npm lockfile) \u2014 the workflow was rendered for pnpm; re-run with --packageManager=npm|yarn|bun if that is wrong." : void 0;
+  const recorded = recordedReview(config.parsed);
+  const plan = composeReviewSetup({
+    enabled: true,
+    provider: options.provider ?? recorded.provider ?? "claude",
+    mode: options.mode ?? recorded.mode ?? "standard",
+    locale: resolveLocale(options.locale, config),
+    maxRounds: options.maxRounds ?? recorded.maxRounds ?? 3,
+    packageManager
+  });
+  if (plan === null) throw new Error("unreachable: add-review always composes with enabled: true");
+  if (config.error !== null) {
+    return {
+      dryRun: options.dryRun ?? false,
+      workflowPath: plan.workflowFilePath,
+      workflowAction: "aborted",
+      configAction: "aborted",
+      requiredSecretName: plan.requiredSecretName,
+      diff: null,
+      workflowYaml: null,
+      configSnippetJson: null,
+      configError: config.error
+    };
+  }
+  const existing = tree.read(plan.workflowFilePath, "utf-8");
+  const verdict = judgeReviewFileConflict(existing, plan.workflowYaml);
+  let workflowAction;
+  let workflowPath = plan.workflowFilePath;
+  let writeWorkflowTo = null;
+  let diff = null;
+  let mainFileMatchesOptions;
+  if (verdict.kind === "create") {
+    workflowAction = "created";
+    writeWorkflowTo = plan.workflowFilePath;
+    mainFileMatchesOptions = true;
+  } else if (verdict.kind === "unchanged") {
+    workflowAction = "unchanged";
+    mainFileMatchesOptions = true;
+  } else {
+    switch (options.onConflict) {
+      case "overwrite":
+        workflowAction = "overwritten";
+        writeWorkflowTo = plan.workflowFilePath;
+        mainFileMatchesOptions = true;
+        break;
+      case "skip":
+        workflowAction = "skipped";
+        mainFileMatchesOptions = false;
+        break;
+      case "alternate-filename": {
+        const altWorkflowPath = deriveAltWorkflowPath(plan.workflowFilePath);
+        workflowAction = "alternate";
+        workflowPath = altWorkflowPath;
+        writeWorkflowTo = altWorkflowPath;
+        mainFileMatchesOptions = false;
+        break;
+      }
+      default:
+        workflowAction = "proposed";
+        diff = renderLineDiff(verdict.existing, verdict.generated);
+        mainFileMatchesOptions = false;
+    }
+  }
+  let configAction;
+  let newConfigContent = null;
+  if (!mainFileMatchesOptions) {
+    configAction = "not-updated";
+  } else {
+    const existingReview = config.parsed?.["review"];
+    if (deepEqual(existingReview, plan.configSnippet)) {
+      configAction = "unchanged";
+    } else {
+      configAction = config.raw === null ? "created" : "updated";
+      const indent = config.raw === null ? "  " : detectIndent(config.raw);
+      const trailingNewline = config.raw === null || config.raw.endsWith("\n");
+      const body = JSON.stringify({ ...config.parsed ?? {}, review: plan.configSnippet }, null, indent);
+      newConfigContent = trailingNewline ? `${body}
+` : body;
+    }
+  }
+  const dryRun = options.dryRun ?? false;
+  if (!dryRun) {
+    if (writeWorkflowTo !== null) tree.write(writeWorkflowTo, plan.workflowYaml);
+    if (newConfigContent !== null) tree.write(CONFIG_PATH, newConfigContent);
+  }
+  return {
+    dryRun,
+    workflowPath,
+    workflowAction,
+    configAction,
+    requiredSecretName: plan.requiredSecretName,
+    diff,
+    workflowYaml: dryRun ? plan.workflowYaml : null,
+    configSnippetJson: dryRun ? JSON.stringify(plan.configSnippet, null, 2) : null,
+    configError: null,
+    ...packageManagerNote !== void 0 ? { packageManagerNote } : {}
+  };
+}
+async function addReviewGenerator(tree, options) {
+  console.log(renderAddReviewReport(runAddReview(tree, { ...options, dryRun: resolveDryRun(options) })));
+}
+var generator_default = addReviewGenerator;
+export {
+  addReviewGenerator,
+  generator_default as default,
+  recordedReview,
+  runAddReview
+};