paseo-req-kit 1.14.0-beta.2 → 1.14.0-beta.4

package/engine/src/review-assets/code.js

@@ -0,0 +1,402 @@
+// The code review page (1.14). Plain script, no framework: the server serves it next to its JSON
+// API (api/info, api/draft, api/submit). Everything shown is set with textContent.
+(function () {
+  "use strict";
+  var state = { info: null, comments: [], decisions: {}, reviewer: "", reviewers: "", note: "", saveTimer: null, busy: false, open: null };
+  var $ = function (id) {
+    return document.getElementById(id);
+  };
+
+  function el(tag, attrs, children) {
+    var node = document.createElement(tag);
+    Object.keys(attrs || {}).forEach(function (k) {
+      if (attrs[k] === null || attrs[k] === undefined) return;
+      if (k === "text") node.textContent = attrs[k];
+      else if (k === "className") node.className = attrs[k];
+      else if (k.indexOf("on") === 0) node.addEventListener(k.slice(2), attrs[k]);
+      else node.setAttribute(k, attrs[k]);
+    });
+    (children || []).forEach(function (c) {
+      if (c) node.appendChild(typeof c === "string" ? document.createTextNode(c) : c);
+    });
+    return node;
+  }
+
+  function toast(text) {
+    var t = $("toast");
+    t.textContent = text;
+    t.hidden = false;
+    clearTimeout(toast.timer);
+    toast.timer = setTimeout(function () {
+      t.hidden = true;
+    }, 8000);
+  }
+
+  function api(pathname, method, body) {
+    return fetch(pathname, { method: method || "GET", headers: body ? { "content-type": "application/json" } : {}, body: body ? JSON.stringify(body) : undefined }).then(function (r) {
+      return r.json().then(function (data) {
+        if (!r.ok && data && data.message) throw new Error(data.message);
+        return data;
+      });
+    });
+  }
+
+  function reviewersList() {
+    return state.reviewers
+      .split(/[,，、\s]+/)
+      .map(function (s) {
+        return s.trim();
+      })
+      .filter(Boolean);
+  }
+
+  function save() {
+    if (state.info.readOnly) return;
+    clearTimeout(state.saveTimer);
+    state.saveTimer = setTimeout(function () {
+      api("api/draft", "PUT", { comments: state.comments, decisions: state.decisions, reviewer: state.reviewer, reviewers: state.reviewers, note: state.note }).catch(function () {});
+    }, 600);
+    count();
+  }
+
+  function fixes() {
+    return Object.keys(state.decisions)
+      .filter(function (id) {
+        return state.decisions[id].mark === "fix";
+      })
+      .map(function (id) {
+        return { id: id, note: state.decisions[id].note || "" };
+      });
+  }
+
+  function count() {
+    var comments = state.comments.filter(function (c) {
+      return c.text.trim();
+    }).length;
+    var fix = fixes().length;
+    var total = comments + fix + (state.note.trim() ? 1 : 0);
+    $("count").textContent = "代码行上的意见 " + comments + " 条，AI 意见标为要改 " + fix + " 条";
+    var blocked = state.info.readOnly || state.info.running || state.busy;
+    $("changes").disabled = blocked || total === 0;
+    $("changes").textContent = total ? "退回修改（" + total + " 条意见）" : "退回修改";
+    $("approve").disabled = blocked;
+  }
+
+  var SEVERITY_CLASS = { "阻塞": "danger", "重要": "warn", "建议": "", "待核实": "" };
+  var STATUS_TEXT = { fixed: "已修复", rejected: "修复时判为不成立", wontfix: "决定不修复", open: "未处理" };
+
+  function findingNode(f, compact) {
+    var d = state.decisions[f.id] || {};
+    var note = el("input", { className: "note-input", placeholder: "补充一句（可不填）", value: d.note || "", hidden: d.mark === "fix" ? null : "" });
+    note.addEventListener("input", function (e) {
+      state.decisions[f.id] = { mark: "fix", note: e.target.value };
+      save();
+    });
+    function mark(m) {
+      return function () {
+        var cur = state.decisions[f.id] && state.decisions[f.id].mark;
+        if (cur === m) delete state.decisions[f.id];
+        else state.decisions[f.id] = { mark: m, note: (state.decisions[f.id] && state.decisions[f.id].note) || "" };
+        render();
+        save();
+      };
+    }
+    var where = f.file ? f.file + (f.line ? ":" + f.line : "") : "";
+    return el("div", { className: "finding " + (SEVERITY_CLASS[f.severity] || "") + (d.mark ? " decided-" + d.mark : "") }, [
+      el("div", { className: "finding-head" }, [
+        el("span", { className: "badge " + (SEVERITY_CLASS[f.severity] || ""), text: "AI · " + f.severity }),
+        el("b", { text: f.id }),
+        f.status !== "open" ? el("span", { className: "badge " + (f.status === "fixed" ? "ok" : ""), text: STATUS_TEXT[f.status] }) : null,
+        !compact && where ? el("a", { href: "#", className: "where", text: where, onclick: function (e) {
+          e.preventDefault();
+          jump(f.file, f.line);
+        } }) : null,
+      ]),
+      el("div", { className: "finding-text", text: f.title }),
+      f.suggestion ? el("div", { className: "muted small", text: "建议：" + f.suggestion }) : null,
+      state.info.readOnly
+        ? null
+        : el("div", { className: "marks" }, [
+            el("button", { className: "btn small" + (d.mark === "fix" ? " on-fix" : ""), text: "要改", onclick: mark("fix") }),
+            el("button", { className: "btn small" + (d.mark === "ok" ? " on-ok" : ""), text: "不用改", onclick: mark("ok") }),
+          ]),
+      note,
+    ]);
+  }
+
+  function jump(file, line) {
+    var target = document.querySelector('[data-file="' + CSS.escape(file) + '"]' + (line ? '[data-n="' + line + '"]' : ""));
+    if (!target) target = document.querySelector('[data-file-head="' + CSS.escape(file) + '"]');
+    if (target) {
+      var box = target.closest(".file");
+      if (box && box.classList.contains("folded")) box.classList.remove("folded");
+      target.scrollIntoView({ block: "center", behavior: "smooth" });
+      target.classList.add("flash");
+      setTimeout(function () {
+        target.classList.remove("flash");
+      }, 1600);
+    }
+  }
+
+  function commentBox(file, line) {
+    var existing = state.comments.find(function (c) {
+      return c.file === file && c.line === line;
+    });
+    if (!existing) {
+      existing = { file: file, line: line, text: "" };
+      state.comments.push(existing);
+    }
+    var ta = el("textarea", { rows: "2", placeholder: "这一行哪里不对、应该怎么改" });
+    ta.value = existing.text;
+    ta.addEventListener("input", function (e) {
+      existing.text = e.target.value;
+      save();
+    });
+    var remove = el("button", { className: "btn small", text: "删除", onclick: function () {
+      state.comments = state.comments.filter(function (c) {
+        return c !== existing;
+      });
+      state.open = null;
+      render();
+      save();
+    } });
+    return el("tr", { className: "comment-row" }, [el("td", { colspan: "3" }, [el("div", { className: "comment" }, [el("div", { className: "muted small", text: "你的意见（" + file + ":" + line + "）" }), ta, state.info.readOnly ? null : remove])])]);
+  }
+
+  function renderFile(f, findingsByFile) {
+    var mine = findingsByFile[f.path] || [];
+    var owners = (state.info.reviewers.byFile || {})[f.path] || [];
+    var head = el("div", { className: "file-head", "data-file-head": f.path, onclick: function () {
+      box.classList.toggle("folded");
+    } }, [
+      el("span", { className: "path", text: f.path + (f.oldPath ? "（原 " + f.oldPath + "）" : "") }),
+      el("span", { className: "badge", text: { added: "新增", deleted: "删除", modified: "修改", renamed: "改名" }[f.status] }),
+      el("span", { className: "plus", text: "+" + f.additions }),
+      el("span", { className: "minus", text: "−" + f.deletions }),
+      f.doc ? el("span", { className: "badge", text: "需求文档" }) : null,
+      mine.length ? el("span", { className: "badge warn", text: "AI 意见 " + mine.length }) : null,
+      owners.length ? el("span", { className: "muted small", text: "负责人 " + owners.join(" ") }) : null,
+    ]);
+    var body = el("div", { className: "file-body" });
+    var unplaced = mine.filter(function (x) {
+      return !x.line || !f.hunks.some(function (h) {
+        return h.lines.some(function (l) {
+          return l.n === x.line;
+        });
+      });
+    });
+    unplaced.forEach(function (x) {
+      body.appendChild(findingNode(x, true));
+    });
+    if (f.binary) body.appendChild(el("div", { className: "muted pad", text: "二进制文件，不显示内容。" }));
+    f.hunks.forEach(function (h) {
+      var table = el("table", { className: "diff" });
+      table.appendChild(el("tr", { className: "hunk" }, [el("td", { colspan: "3", text: h.header })]));
+      h.lines.forEach(function (l) {
+        var line = l.n || l.o;
+        var row = el("tr", { className: "line " + (l.t === "+" ? "add" : l.t === "-" ? "del" : ""), "data-file": f.path, "data-n": l.n || "", title: state.info.readOnly ? "" : "点这一行写意见" }, [
+          el("td", { className: "num", text: l.o === null ? "" : String(l.o) }),
+          el("td", { className: "num", text: l.n === null ? "" : String(l.n) }),
+          el("td", { className: "code", text: (l.t === " " ? " " : l.t) + " " + l.s }),
+        ]);
+        if (!state.info.readOnly) {
+          row.addEventListener("click", function () {
+            state.open = f.path + ":" + line;
+            render();
+          });
+        }
+        table.appendChild(row);
+        mine
+          .filter(function (x) {
+            return x.line && l.n === x.line;
+          })
+          .forEach(function (x) {
+            table.appendChild(el("tr", { className: "finding-row" }, [el("td", { colspan: "3" }, [findingNode(x, true)])]));
+          });
+        var hasComment = state.comments.some(function (c) {
+          return c.file === f.path && c.line === line;
+        });
+        if (hasComment || state.open === f.path + ":" + line) table.appendChild(commentBox(f.path, line));
+      });
+      body.appendChild(table);
+    });
+    if (f.truncated) body.appendChild(el("div", { className: "muted pad", text: "改动太多，只显示了一部分。完整改动请在开发工具里看。" }));
+    var box = el("section", { className: "file" + (f.doc && !mine.length ? " folded" : ""), id: "file-" + f.path }, [head, body]);
+    return box;
+  }
+
+  function render() {
+    var info = state.info;
+    var byFile = {};
+    info.findings.forEach(function (x) {
+      if (x.file && info.files.some(function (f) {
+        return f.path === x.file;
+      })) (byFile[x.file] = byFile[x.file] || []).push(x);
+    });
+    var folded = {};
+    document.querySelectorAll(".file").forEach(function (n) {
+      folded[n.id] = n.classList.contains("folded");
+    });
+    var diffs = $("diffs");
+    var y = window.scrollY;
+    diffs.textContent = "";
+    if (!info.files.length) diffs.appendChild(el("div", { className: "card muted", text: info.base.commit ? "没有找到改动。" : "找不到这个需求是从哪个提交开始的，没法列出改动。" }));
+    info.files.forEach(function (f) {
+      var node = renderFile(f, byFile);
+      if (node.id in folded) node.classList.toggle("folded", folded[node.id]);
+      diffs.appendChild(node);
+    });
+    // The AI findings not on a changed file: listed at the top.
+    var ai = $("ai");
+    ai.textContent = "";
+    var elsewhere = info.findings.filter(function (x) {
+      return !byFile[x.file] || byFile[x.file].indexOf(x) < 0;
+    });
+    if (info.findings.length) {
+      ai.hidden = false;
+      var open = info.findings.filter(function (x) {
+        return x.status === "open";
+      }).length;
+      ai.appendChild(el("h2", { text: "AI 评审意见（" + info.findings.length + " 条，未处理 " + open + " 条）" }));
+      ai.appendChild(el("p", { className: "muted small", text: "在代码旁边也能看到。阻塞、重要的未处理意见建议标为要改；拿不准的请开发同事看一下。" }));
+      info.findings.forEach(function (x) {
+        if (elsewhere.indexOf(x) >= 0 || x.severity === "阻塞" || x.severity === "重要") ai.appendChild(findingNode(x, false));
+      });
+    } else if (info.rounds.length) {
+      ai.hidden = false;
+      ai.appendChild(el("h2", { text: "AI 评审" }));
+      ai.appendChild(el("p", { className: "muted", text: "AI 评审没有留下结构化的意见，详细内容见 code-review.md。" }));
+    }
+    var nav = $("files");
+    nav.textContent = "";
+    nav.appendChild(el("div", { className: "nav-title", text: "改动的文件（" + info.files.length + "）" }));
+    info.files.forEach(function (f) {
+      nav.appendChild(el("a", { href: "#", className: f.doc ? "doc" : "", onclick: function (e) {
+        e.preventDefault();
+        jump(f.path, null);
+      } }, [el("span", { text: f.path }), (byFile[f.path] || []).length ? el("span", { className: "badge warn", text: String(byFile[f.path].length) }) : null]));
+    });
+    window.scrollTo(0, y);
+    count();
+  }
+
+  function submit(verdict) {
+    if (state.busy) return;
+    var text = verdict === "approve" ? "确认评审通过？会记入 code-review.md 并提交。" : "确认退回修改？流水线会按这些意见修改（需求说明不变），改完再评审、再验证。";
+    if (!window.confirm(text)) return;
+    state.busy = true;
+    count();
+    api("api/submit", "POST", {
+      verdict: verdict,
+      reviewer: state.reviewer,
+      reviewers: reviewersList(),
+      comments: state.comments.filter(function (c) {
+        return c.text.trim();
+      }),
+      fix: fixes(),
+      note: state.note,
+    })
+      .then(function (r) {
+        toast(r.message);
+        return load();
+      })
+      .catch(function (e) {
+        toast(e.message);
+      })
+      .then(function () {
+        state.busy = false;
+        count();
+      });
+  }
+
+  function load() {
+    return api("api/info").then(function (info) {
+      state.info = info;
+      $("project").textContent = info.featureDir;
+      $("title").textContent = "代码审查：" + info.title;
+      var adds = 0,
+        dels = 0;
+      info.files.forEach(function (f) {
+        if (!f.doc) {
+          adds += f.additions;
+          dels += f.deletions;
+        }
+      });
+      var last = info.rounds.length ? info.rounds[info.rounds.length - 1] : null;
+      $("sub").textContent =
+        (info.branch ? "分支 " + info.branch : "") +
+        (info.base.ref ? "，相对 " + info.base.ref : "") +
+        "：改了 " + info.files.filter(function (f) {
+          return !f.doc;
+        }).length + " 个代码文件（+" + adds + " −" + dels + "）" +
+        (last ? "；AI 评审 " + info.rounds.length + " 轮，最后一轮" + (last.verdict === "pass" ? "通过" : "需要修改") : "");
+      var banner = $("status");
+      banner.hidden = true;
+      banner.className = "banner";
+      if (info.running) {
+        banner.hidden = false;
+        banner.textContent = "流水线正在运行，改动还会变化。可以先看，结束后再提交评审。";
+      } else if (info.human) {
+        banner.hidden = false;
+        var h = info.human;
+        if (h.status === "approved") {
+          banner.className = "banner " + (h.stale ? "warn" : "ok");
+          banner.textContent = (h.stale ? "评审通过后代码又有改动，需要重新评审。" : "已评审通过") + "（" + h.reviewer + "，" + h.at.slice(0, 10) + (h.reviewers.length ? "，审核人 " + h.reviewers.join(" ") : "") + "）";
+        } else {
+          banner.className = "banner warn";
+          banner.textContent = "上次退回了 " + h.items.length + " 条意见（" + h.reviewer + "，" + h.at.slice(0, 10) + "）" + (h.consumedAttempt ? "，第 " + h.consumedAttempt + " 次尝试在处理" : "，还没开始修改");
+        }
+      }
+      var sum = $("summary");
+      sum.textContent = "";
+      if (info.summary.length) {
+        sum.hidden = false;
+        sum.appendChild(el("h2", { text: "这次改了什么（来自提测说明）" }));
+        info.summary.forEach(function (l) {
+          sum.appendChild(el("div", { text: l.replace(/^\s*[-*]\s+/, "• ") }));
+        });
+      }
+      var d = info.draft || {};
+      state.comments = Array.isArray(d.comments) ? d.comments : [];
+      state.decisions = d.decisions && typeof d.decisions === "object" ? d.decisions : {};
+      state.reviewer = d.reviewer || "";
+      state.reviewers = typeof d.reviewers === "string" ? d.reviewers : info.reviewers.suggested.join(", ");
+      state.note = d.note || "";
+      $("reviewer").value = state.reviewer;
+      $("reviewers").value = state.reviewers;
+      $("reviewers").title = info.reviewers.source ? "默认取自 " + info.reviewers.source + "，可以改" : "项目里没有 CODEOWNERS，请填写";
+      $("note").value = state.note;
+      if (info.readOnly) ["reviewer", "reviewers", "note"].forEach(function (id) {
+        $(id).disabled = true;
+      });
+      render();
+    });
+  }
+
+  function start() {
+    load().catch(function (e) {
+      $("title").textContent = "打不开代码审查页";
+      $("sub").textContent = e.message;
+    });
+    $("reviewer").addEventListener("input", function (e) {
+      state.reviewer = e.target.value;
+      save();
+    });
+    $("reviewers").addEventListener("input", function (e) {
+      state.reviewers = e.target.value;
+      save();
+    });
+    $("note").addEventListener("input", function (e) {
+      state.note = e.target.value;
+      save();
+    });
+    $("changes").addEventListener("click", function () {
+      submit("changes");
+    });
+    $("approve").addEventListener("click", function () {
+      submit("approve");
+    });
+  }
+
+  start();
+})();

package/engine/src/review.ts

@@ -15,6 +15,8 @@ import os from "node:os";
 import http from "node:http";
 import path from "node:path";
 import { ENGINE_DIR, KIT_ROOT, kitHome, kitVersion } from "./locations.js";
+import { buildCodeReview, recordHumanReview, startReviewFix, type Submission } from "./code-review.js";
+import { type Answer, acceptanceFailMessage, acceptanceText, buildChecklist, recordAcceptance, verdictOf } from "./checklist.js";
 import { readIndex } from "./records.js";
 import { readState, statePath } from "./state.js";
 
@@ -203,6 +205,10 @@ export interface ReviewServerOptions {
   env?: NodeJS.ProcessEnv;
   /** Runs `req approve|reply …` in the requirement's checkout; tests replace it. */
   run?: (command: "approve" | "reply", repo: string, featureDir: string, extra: string[]) => { ok: boolean; message: string };
+  /** 1.14: `req review-fix <需求>` after the code review page asked for changes; tests replace it. */
+  codeFix?: (repo: string, featureDir: string) => { ok: boolean; message: string };
+  /** 1.14: `req try <需求> --json [--stop]` for the checklist page's "试用" button; tests replace it. */
+  tryRun?: (repo: string, featureDir: string, stop: boolean) => { ok: boolean; message: string; services?: unknown[]; howTo?: string[] };
   onRequest?: () => void;
 }
 
@@ -304,9 +310,29 @@ function defaultRun(command: "approve" | "reply", repo: string, featureDir: stri
   return { ok: r.status === 0, message: r.error ? r.error.message : `${r.stdout ?? ""}${r.stderr ?? ""}`.trim() };
 }
 
+function defaultTry(repo: string, featureDir: string, stop: boolean) {
+  const env = { ...process.env };
+  delete env.PASEO_AGENT_ID;
+  delete env.PASEO_AGENT_CWD;
+  const r = spawnSync(process.execPath, [path.join(KIT_ROOT, "bin", "req.mjs"), "try", featureDir, "--json", ...(stop ? ["--stop"] : [])], {
+    cwd: repo,
+    env,
+    encoding: "utf8",
+    timeout: 300_000,
+    windowsHide: true,
+  });
+  try {
+    return JSON.parse((r.stdout ?? "").trim().split("\n").at(-1) ?? "") as { ok: boolean; message: string; services?: unknown[]; howTo?: string[] };
+  } catch {
+    return { ok: false, message: r.error ? r.error.message : `${r.stdout ?? ""}${r.stderr ?? ""}`.trim() || "没有启动" };
+  }
+}
+
 export function createReviewServer(opts: ReviewServerOptions): http.Server {
   const env = opts.env ?? process.env;
   const run = opts.run ?? defaultRun;
+  const tryRun = opts.tryRun ?? defaultTry;
+  const codeFixRun = opts.codeFix ?? startReviewFix;
   return http.createServer((req, res) => {
     opts.onRequest?.();
     handle(req, res).catch((error: Error) => json(res, 500, { ok: false, message: error.message }));
@@ -332,6 +358,16 @@ export function createReviewServer(opts: ReviewServerOptions): http.Server {
       res.writeHead(301, { location: `${url.pathname}/` });
       return res.end();
     }
+    if (rest === "check") {
+      res.writeHead(301, { location: `${url.pathname}/` });
+      return res.end();
+    }
+    if (rest.startsWith("check/")) return handleChecklist(req, res, rest.slice("check/".length), entry, featureAbs, full);
+    if (rest === "code") {
+      res.writeHead(301, { location: `${url.pathname}/` });
+      return res.end();
+    }
+    if (rest.startsWith("code/")) return handleCodeReview(req, res, rest.slice("code/".length), entry, featureAbs, full);
     if (rest === "") return sendFile(res, path.join(ASSETS, "app.html"));
     if (rest === "app.js" || rest === "app.css") return sendFile(res, path.join(ASSETS, rest));
     if (rest.startsWith("proto/cur/")) return sendFile(res, inside(prototypeDir, rest.slice("proto/cur/".length)), PROTOTYPE_CSP);
@@ -400,6 +436,129 @@ export function createReviewServer(opts: ReviewServerOptions): http.Server {
     }
     return send(res, 404, "没有这个页面");
   }
+
+  // 1.14: the code review page, /r/<token>/f/<key>/code/…
+  async function handleCodeReview(req: http.IncomingMessage, res: http.ServerResponse, rest: string, entry: { repo: string; featureDir: string }, featureAbs: string, full: boolean) {
+    const draftFile = path.join(featureAbs, ".pipeline", "code-review", "draft.json");
+    if (rest === "") return sendFile(res, path.join(ASSETS, "code.html"));
+    if (rest === "code.js" || rest === "code.css") return sendFile(res, path.join(ASSETS, rest));
+    if (rest === "api/info" && req.method === "GET") {
+      let draft: unknown = null;
+      try {
+        draft = JSON.parse(fs.readFileSync(draftFile, "utf8"));
+      } catch {
+        draft = null;
+      }
+      return json(res, 200, { ...buildCodeReview(entry.repo, entry.featureDir), readOnly: !full, draft });
+    }
+    if (rest === "api/draft" && req.method === "PUT") {
+      if (!full) return json(res, 403, { ok: false, message: "这是只读链接" });
+      const body = await readBody(req);
+      if (!body || typeof body !== "object") return json(res, 400, { ok: false, message: "格式不对" });
+      fs.mkdirSync(path.dirname(draftFile), { recursive: true });
+      fs.writeFileSync(draftFile, JSON.stringify({ ...(body as object), savedAt: new Date().toISOString() }, null, 2));
+      return json(res, 200, { ok: true });
+    }
+    if (rest === "api/submit" && req.method === "POST") {
+      if (!full) return json(res, 403, { ok: false, message: "这是只读链接，不能提交" });
+      const body = (await readBody(req)) as Partial<Submission> | null;
+      const verdict = body?.verdict === "approve" ? "approve" : body?.verdict === "changes" ? "changes" : null;
+      if (!verdict) return json(res, 400, { ok: false, message: "请选择评审通过或退回修改" });
+      const data = buildCodeReview(entry.repo, entry.featureDir);
+      if (data.running) return json(res, 409, { ok: false, message: "流水线正在运行，等它结束后再提交评审。" });
+      const sub: Submission = {
+        verdict,
+        reviewer: typeof body?.reviewer === "string" ? body.reviewer : "",
+        reviewers: Array.isArray(body?.reviewers) ? body.reviewers.filter((r): r is string => typeof r === "string") : [],
+        comments: (Array.isArray(body?.comments) ? body.comments : []).filter((c) => c && typeof c.text === "string").map((c) => ({ file: typeof c.file === "string" ? c.file : null, line: typeof c.line === "number" ? c.line : null, text: c.text })),
+        fix: (Array.isArray(body?.fix) ? body.fix : []).filter((f) => f && typeof f.id === "string").map((f) => ({ id: f.id, note: typeof f.note === "string" ? f.note : undefined })),
+        note: typeof body?.note === "string" ? body.note : "",
+      };
+      if (verdict === "changes" && sub.comments.length === 0 && sub.fix.length === 0 && !sub.note.trim()) {
+        return json(res, 400, { ok: false, message: "退回修改需要至少一条意见：在代码行上写意见，或把 AI 的意见标为\"要改\"。" });
+      }
+      const { review, committed } = recordHumanReview(entry.repo, entry.featureDir, sub);
+      if (verdict === "approve") {
+        return json(res, 200, { ok: true, verdict, committed, message: `已记录：评审通过${committed ? "，已写入 code-review.md 并提交" : ""}。${review.reviewers.length ? `审核人：${review.reviewers.join("、")}。` : ""}合并请求接入后会用这些审核人。` });
+      }
+      const started = codeFixRun(entry.repo, entry.featureDir);
+      return json(res, 200, {
+        ok: true,
+        verdict,
+        committed,
+        message: started.ok
+          ? `已记录 ${review.items.length} 条修改意见，流水线开始按意见修改（需求说明不变，从方案设计开始只处理这些意见），进展会发回需求的对话。`
+          : `已记录 ${review.items.length} 条修改意见，但没能开始修改：${started.message.split("\n")[0]}。可以在需求的对话里说"按代码评审意见修改"，或执行 req review-fix ${path.basename(entry.featureDir)}。`,
+      });
+    }
+    return send(res, 404, "没有这个页面");
+  }
+
+  // 1.14: the acceptance checklist, /r/<token>/f/<key>/check/…
+  async function handleChecklist(req: http.IncomingMessage, res: http.ServerResponse, rest: string, entry: { repo: string; featureDir: string; key: string; project: string }, featureAbs: string, full: boolean) {
+    const checkDir = path.join(featureAbs, ".pipeline", "check");
+    if (rest === "") return sendFile(res, path.join(ASSETS, "check.html"));
+    if (rest === "check.js" || rest === "check.css") return sendFile(res, path.join(ASSETS, rest));
+    if (rest === "api/info" && req.method === "GET") {
+      const state = readState(statePath(entry.repo, entry.featureDir));
+      let draft: unknown = { answers: [], reviewer: "" };
+      try {
+        draft = JSON.parse(fs.readFileSync(path.join(checkDir, "draft.json"), "utf8"));
+      } catch {
+        /* none yet */
+      }
+      const acceptance = fs.existsSync(path.join(featureAbs, "acceptance.md")) ? fs.readFileSync(path.join(featureAbs, "acceptance.md"), "utf8") : "";
+      return json(res, 200, {
+        ...buildChecklist(featureAbs),
+        project: entry.project,
+        featureDir: entry.featureDir,
+        readOnly: !full,
+        running: state?.status === "running",
+        accepted: /^[-*]\s*验收结论[:：]\s*(.+)$/m.exec(acceptance)?.[1]?.trim() ?? null,
+        draft,
+      });
+    }
+    if (rest === "api/draft" && req.method === "PUT") {
+      if (!full) return json(res, 403, { ok: false, message: "这是只读链接" });
+      const body = (await readBody(req)) as { answers?: unknown; reviewer?: unknown } | null;
+      if (!body || !Array.isArray(body.answers)) return json(res, 400, { ok: false, message: "格式不对" });
+      fs.mkdirSync(checkDir, { recursive: true });
+      fs.writeFileSync(path.join(checkDir, "draft.json"), JSON.stringify({ answers: body.answers, reviewer: typeof body.reviewer === "string" ? body.reviewer : "", savedAt: new Date().toISOString() }, null, 2));
+      return json(res, 200, { ok: true });
+    }
+    if (rest === "api/try" && req.method === "POST") {
+      if (!full) return json(res, 403, { ok: false, message: "这是只读链接" });
+      const body = (await readBody(req)) as { stop?: boolean } | null;
+      return json(res, 200, tryRun(entry.repo, entry.featureDir, body?.stop === true));
+    }
+    if (rest === "api/submit" && req.method === "POST") {
+      if (!full) return json(res, 403, { ok: false, message: "这是只读链接，不能提交" });
+      const body = (await readBody(req)) as { answers?: Answer[]; reviewer?: string } | null;
+      const answers = (Array.isArray(body?.answers) ? body.answers : []).filter((a) => a && typeof a.id === "string" && ["pass", "fail", "skip"].includes(a.mark));
+      const list = buildChecklist(featureAbs);
+      const v = verdictOf(list, answers);
+      if (v.verdict === "通过" && v.missing.length > 0) {
+        return json(res, 400, { ok: false, message: `还有 ${v.missing.length} 条必须验的没有核对（${v.missing.map((i) => i.id).join("、")}）。核对完，或者有不对的标"不对"后再提交。` });
+      }
+      const file = path.join(featureAbs, "acceptance.md");
+      const previous = fs.existsSync(file) ? fs.readFileSync(file, "utf8") : undefined;
+      const reviewer = body?.reviewer?.trim() || "需求方（验收页）";
+      const text = acceptanceText(list, answers, { verdict: v.verdict, reviewer: reviewer.slice(0, 60), date: new Date().toISOString().slice(0, 10), previous });
+      const { committed } = recordAcceptance(entry.repo, entry.featureDir, text);
+      fs.rmSync(path.join(checkDir, "draft.json"), { force: true });
+      if (v.verdict === "通过") {
+        return json(res, 200, { ok: true, verdict: v.verdict, committed, message: `已记录：验收通过${committed ? "，验收记录已提交" : ""}。下一步请开发同事审阅代码并合并。` });
+      }
+      const told = run("reply", entry.repo, entry.featureDir, ["--acceptance", acceptanceFailMessage(entry.featureDir, list, answers)]);
+      return json(res, 200, {
+        ok: true,
+        verdict: v.verdict,
+        committed,
+        message: told.ok ? "已记录：验收不通过。不对的地方已经转给这个需求的对话，它会和你确定怎么处理。" : `已记录：验收不通过，但没能转给需求的对话（${told.message.split("\n")[0]}）。请在需求的对话里说"验收不通过"。`,
+      });
+    }
+    return send(res, 404, "没有这个页面");
+  }
 }
 
 // ---------------------------------------------------------------------------
@@ -530,7 +689,7 @@ async function serve(env: NodeJS.ProcessEnv): Promise<void> {
 // ---------------------------------------------------------------------------
 // req review <需求> [--no-open] [--read-only]
 
-function openBrowser(url: string) {
+export function openBrowser(url: string) {
   const [cmd, args] = process.platform === "darwin" ? ["open", [url]] : process.platform === "win32" ? ["cmd", ["/c", "start", "", url]] : ["xdg-open", [url]];
   try {
     const child = spawn(cmd, args as string[], { stdio: "ignore", detached: true, windowsHide: true });
@@ -548,7 +707,23 @@ async function main(argv: string[]): Promise<number> {
   }
   const open = !argv.includes("--no-open");
   const readOnly = argv.includes("--read-only");
-  const feature = argv.find((a) => !a.startsWith("--"));
+  // 1.14: --page code opens the code review page of the same server.
+  const pageAt = argv.indexOf("--page");
+  const page = pageAt >= 0 ? argv[pageAt + 1] : null;
+  const feature = argv.find((a, i) => !a.startsWith("--") && !(pageAt >= 0 && i === pageAt + 1));
+  if (page === "code" && feature && !argv.includes("--help")) {
+    const { locate } = await import("./api.js");
+    const { repo, featureDir } = locate(process.cwd(), feature);
+    const key = keyOf(repo, featureDir);
+    if (!key) {
+      console.error(`${featureDir} 不在本机的需求列表中，先运行一次 req index --rebuild`);
+      return 1;
+    }
+    const url = `${reviewUrl(await ensureReviewServer(), key, readOnly)}code/`;
+    console.log(`代码审查页：${url}`);
+    if (open) openBrowser(url);
+    return 0;
+  }
   if (!feature || argv.includes("--help") || argv.includes("-h")) {
     console.log("用法：req review <需求> [--no-open] [--read-only]\n\n在浏览器中打开这个需求的原型审查页：点选要改的地方、直接改文字，然后提交修改意见或确认方案。");
     return feature ? 0 : 2;