paseo-req-kit 1.14.0-beta.3 → 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,7 @@ 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";
@@ -204,6 +205,8 @@ 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;
@@ -329,6 +332,7 @@ 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 }));
@@ -359,6 +363,11 @@ export function createReviewServer(opts: ReviewServerOptions): http.Server {
       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);
@@ -428,6 +437,63 @@ 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");
@@ -641,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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paseo-req-kit",
-  "version": "1.14.0-beta.3",
+  "version": "1.14.0-beta.4",
   "description": "req-kit: a requirement-development workflow for Paseo. /req aligns a requirement in chat; the engine runs design, implementation, review and verification as Paseo agents.",
   "type": "module",
   "license": "MIT",

package/paseo-plugin/client/data.ts

@@ -74,11 +74,11 @@ export function useConfigView(repo: string | null) {
 }
 
 /** The prototype review page's address (1.13); it stays valid while its server runs. */
-export function useReviewUrl(repo: string, featureDir: string, enabled: boolean, page: "prototype" | "check" = "prototype") {
+export function useReviewUrl(repo: string, featureDir: string, enabled: boolean, page: "prototype" | "check" | "code" = "prototype") {
   const reviewUrl = useRpc(reviewUrlRpc);
   return useQuery({
     queryKey: ["req", "review-url", repo, featureDir, page],
-    queryFn: () => reviewUrl({ repo, featureDir, ...(page === "check" ? { page } : {}) }),
+    queryFn: () => reviewUrl({ repo, featureDir, ...(page !== "prototype" ? { page } : {}) }),
     enabled: enabled && Boolean(repo && featureDir),
     retry: false,
   });

package/paseo-plugin/client/detail.tsx

@@ -9,7 +9,7 @@ import type { Action, RequirementDetail, Step } from "../shared/contracts";
 import { useAction, useDocument, usePreferences, useRequirement, useRequirements } from "./data";
 import { ACTION_TEXT, actionsFor, ago, ATTENTION_LABELS, facts, FILE_LABELS, minutes, tokens } from "./format";
 import { Markdown, tsvToMarkdown } from "./markdown";
-import { ChecklistButton, ReviewButton } from "./review";
+import { ChecklistButton, CodeReviewButton, ReviewButton } from "./review";
 import { Badge, Button, Chip, Status, useStyles } from "./ui";
 
 type Theme = PluginHostProps["theme"];
@@ -170,6 +170,10 @@ export function RequirementView({
   const actions = readOnly ? [] : actionsFor(d);
   // 1.14: finished (it has a report) and not running: the requester can try it and accept it.
   const canAccept = d.files.includes("report.md") && !d.running;
+  // 1.14: code written and reviewed by the AI: a person can review it too.
+  const canReviewCode = (d.files.includes("code-review.md") || d.files.includes("implementation.md")) && !d.running;
+  const hr = d.humanReview ?? null;
+  const reviewLabel = !hr ? "代码审查" : hr.status === "approved" ? (hr.stale ? "代码审查（有新改动，需重新评审）" : "代码审查（已通过）") : "代码审查（已退回修改）";
   return (
     <View style={{ gap: 16 }}>
       <View style={{ gap: 4 }}>
@@ -196,8 +200,9 @@ export function RequirementView({
         {d.attention === "business" ? <Text style={s.muted}>需求方的决定请在发起需求的对话中回答，回答后再继续。</Text> : null}
       </View>
 
-      {actions.length > 0 || d.hasPrototype || canAccept ? (
+      {actions.length > 0 || d.hasPrototype || canAccept || canReviewCode ? (
         <View style={s.row}>
+          {canReviewCode ? <CodeReviewButton theme={theme} repo={d.sourceRepo ?? d.repo} featureDir={d.featureDir} title={d.title} label={reviewLabel} primary={!!hr && hr.stale} /> : null}
           {canAccept ? <ChecklistButton theme={theme} repo={d.sourceRepo ?? d.repo} featureDir={d.featureDir} title={d.title} primary={d.stage.startsWith("待验收") || d.stage === "验收未通过"} /> : null}
           {d.hasPrototype ? <ReviewButton theme={theme} repo={d.sourceRepo ?? d.repo} featureDir={d.featureDir} title={d.title} waiting={d.attention === "approval"} /> : null}
           {actions.map((a) => (

package/paseo-plugin/client/nav.ts

@@ -15,3 +15,8 @@ export function openReview(input: { repo: string; featureDir: string; title: str
 export function openChecklist(input: { repo: string; featureDir: string; title: string }): void {
   opener?.({ screenId: "review", params: { repo: input.repo, featureDir: input.featureDir, title: input.title, page: "check" } });
 }
+
+/** 1.14: the code review page of a requirement (the same screen, another page). */
+export function openCodeReview(input: { repo: string; featureDir: string; title: string }): void {
+  opener?.({ screenId: "review", params: { repo: input.repo, featureDir: input.featureDir, title: input.title, page: "code" } });
+}

package/paseo-plugin/client/review.tsx

@@ -4,7 +4,7 @@ import type { PluginHostProps, PluginScreenProps } from "@getpaseo/plugin/client
 import { ExternalLink } from "@getpaseo/plugin/client/ui";
 import { Text, View } from "react-native";
 import { useReviewUrl } from "./data";
-import { openChecklist, openReview } from "./nav";
+import { openChecklist, openCodeReview, openReview } from "./nav";
 import { Button, Status, useStyles } from "./ui";
 import { canEmbedPages, embeddedPage, reviewUnreachable } from "./web";
 
@@ -15,6 +15,11 @@ export function ChecklistButton({ theme, repo, featureDir, title, primary }: { t
   return <Button theme={theme} primary={primary} label="验收清单（可一键试用）" onPress={() => openChecklist({ repo, featureDir, title })} />;
 }
 
+/** 1.14: the code review page: AI findings next to the code, the person's comments, pass or send back. */
+export function CodeReviewButton({ theme, repo, featureDir, title, primary, label }: { theme: Theme; repo: string; featureDir: string; title: string; primary: boolean; label: string }) {
+  return <Button theme={theme} primary={primary} label={label} onPress={() => openCodeReview({ repo, featureDir, title })} />;
+}
+
 /** The button on a requirement with a prototype: primary while the design waits for confirmation. */
 export function ReviewButton({ theme, repo, featureDir, title, waiting }: { theme: Theme; repo: string; featureDir: string; title: string; waiting: boolean }) {
   return <Button theme={theme} primary={waiting} label={waiting ? "审查原型并确认方案" : "审查原型"} onPress={() => openReview({ repo, featureDir, title })} />;
@@ -24,7 +29,7 @@ export function ReviewScreen({ theme, layout, params }: PluginScreenProps) {
   const s = useStyles(theme, layout.compact);
   const repo = params.repo ?? "";
   const featureDir = params.featureDir ?? "";
-  const page = params.page === "check" ? "check" : "prototype";
+  const page = params.page === "check" ? "check" : params.page === "code" ? "code" : "prototype";
   const review = useReviewUrl(repo, featureDir, true, page);
   if (!review.data) {
     return (
@@ -44,12 +49,17 @@ export function ReviewScreen({ theme, layout, params }: PluginScreenProps) {
       </View>
     );
   }
-  const frame = canEmbedPages ? embeddedPage(url, `${page === "check" ? "验收清单" : "原型审查"}：${params.title ?? featureDir}`) : null;
+  const name = page === "check" ? "验收清单" : page === "code" ? "代码审查" : "原型审查";
+  const frame = canEmbedPages ? embeddedPage(url, `${name}：${params.title ?? featureDir}`) : null;
   return (
     <View style={[s.screen, { gap: 6 }]}>
       <View style={[s.row, { paddingHorizontal: 12, paddingTop: 8, justifyContent: "space-between" }]}>
         <Text style={s.muted}>
-          {page === "check"
+          {page === "code"
+            ? readOnly
+              ? "插件设为只读：可以看改动和 AI 意见，不能提交评审。"
+              : "点代码行写意见，AI 的意见标要改或不用改；看完在底部退回修改或评审通过。"
+            : page === "check"
             ? readOnly
               ? "插件设为只读：可以看清单，不能提交。"
               : "逐条核对：通过、不对（写下看到了什么）、先不验；需要时点右上角把它跑起来。"
@@ -61,8 +71,8 @@ export function ReviewScreen({ theme, layout, params }: PluginScreenProps) {
       </View>
       {frame ?? (
         <View style={[s.card, { margin: 12, gap: 8 }]}>
-          <Text style={s.text}>{page === "check" ? "验收清单" : "原型审查页"}在浏览器中打开效果最好（手机上屏幕较小，建议用电脑）。</Text>
-          <ExternalLink href={url}>{page === "check" ? "打开验收清单" : "打开原型审查页"}</ExternalLink>
+          <Text style={s.text}>{page === "prototype" ? "原型审查页" : name}在浏览器中打开效果最好（手机上屏幕较小，建议用电脑）。</Text>
+          <ExternalLink href={url}>{page === "prototype" ? "打开原型审查页" : `打开${name}`}</ExternalLink>
         </View>
       )}
     </View>