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

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

@@ -0,0 +1,258 @@
+// The acceptance checklist page (1.14). Plain script, no framework: the server serves it next to
+// its JSON API (api/info, api/draft, api/try, api/submit).
+(function () {
+  "use strict";
+  var state = { info: null, answers: {}, reviewer: "", saveTimer: null, busy: false };
+  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;
+    }, 6000);
+  }
+
+  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;
+      });
+    });
+  }
+
+  var PIPELINE = { pass: ["流水线：通过", "pass"], fail: ["流水线：没通过", "fail"], unverified: ["流水线：没验证", "unverified"], unknown: ["流水线：没有记录", ""] };
+
+  function answersList() {
+    return Object.keys(state.answers).map(function (id) {
+      return { id: id, mark: state.answers[id].mark, note: state.answers[id].note || "" };
+    });
+  }
+
+  function save() {
+    if (state.info.readOnly) return;
+    clearTimeout(state.saveTimer);
+    state.saveTimer = setTimeout(function () {
+      api("api/draft", "PUT", { answers: answersList(), reviewer: state.reviewer }).catch(function () {});
+    }, 600);
+  }
+
+  function summary() {
+    var items = state.info.items;
+    var c = { pass: 0, fail: 0, skip: 0, open: 0 };
+    var missing = 0;
+    var failedRequired = 0;
+    items.forEach(function (i) {
+      var a = state.answers[i.id];
+      if (!a) c.open++;
+      else c[a.mark]++;
+      if (i.required && (!a || a.mark === "skip")) missing++;
+      if (i.required && a && a.mark === "fail") failedRequired++;
+    });
+    var verdict = failedRequired > 0 ? "不通过" : missing === 0 ? "通过" : null;
+    $("summary").textContent =
+      "共 " + items.length + " 条：通过 " + c.pass + "，不对 " + c.fail + "，先不验 " + c.skip + "，还没看 " + c.open + "。" +
+      (verdict === "通过" ? "可以提交：验收通过。" : verdict === "不通过" ? "提交后结论是“不通过”，不对的地方会转给需求的对话。" : "必须验的都核对完才能提交“通过”。");
+    $("submit").disabled = state.info.readOnly || state.busy || verdict === null;
+    $("submit").textContent = verdict === "不通过" ? "提交：验收不通过" : "提交：验收通过";
+  }
+
+  function renderItem(item, n) {
+    var a = state.answers[item.id];
+    var li = el("li", { className: "item" + (a ? " " + a.mark : "") });
+    var p = PIPELINE[item.pipeline] || PIPELINE.unknown;
+    li.appendChild(
+      el("div", { className: "item-head" }, [
+        el("span", { className: "id", text: n + ". " + item.id }),
+        el("span", { className: "item-title", text: item.title }),
+        item.kind === "criterion" ? el("span", { className: "badge " + p[1], text: p[0] }) : el("span", { className: "badge unverified", text: "请你表态" }),
+        item.required ? null : el("span", { className: "badge", text: "可以以后再说" }),
+      ]),
+    );
+    if (item.details.length) {
+      li.appendChild(
+        el(
+          "ul",
+          { className: "details" },
+          item.details.map(function (d) {
+            return el("li", { text: d });
+          }),
+        ),
+      );
+    }
+    if (item.evidence) li.appendChild(el("div", { className: "evidence", text: "流水线的记录：" + item.evidence }));
+    var labels = item.kind === "decision" ? [["pass", "同意"], ["fail", "不同意"], ["skip", "先不表态"]] : [["pass", "通过"], ["fail", "不对"], ["skip", "先不验"]];
+    var marks = el(
+      "div",
+      { className: "marks" },
+      labels.map(function (l) {
+        return el("button", {
+          className: "btn" + (a && a.mark === l[0] ? " on-" + l[0] : ""),
+          text: l[1],
+          disabled: state.info.readOnly ? "disabled" : null,
+          onclick: function () {
+            var cur = state.answers[item.id];
+            state.answers[item.id] = { mark: l[0], note: cur ? cur.note : "" };
+            save();
+            render();
+          },
+        });
+      }),
+    );
+    if (state.info.readOnly) marks.querySelectorAll("button").forEach(function (b) {
+      b.disabled = true;
+    });
+    li.appendChild(marks);
+    if (a && a.mark === "fail") {
+      var ta = el("textarea", { placeholder: item.kind === "decision" ? "为什么不同意？希望怎样？" : "看到了什么？应该是什么样？（例如：点导出后提示“失败”，应该下载文件）" });
+      ta.value = a.note || "";
+      ta.addEventListener("input", function () {
+        state.answers[item.id].note = ta.value;
+        save();
+      });
+      li.appendChild(ta);
+    }
+    return li;
+  }
+
+  function render() {
+    var list = $("items");
+    list.innerHTML = "";
+    state.info.items.forEach(function (item, i) {
+      list.appendChild(renderItem(item, i + 1));
+    });
+    summary();
+  }
+
+  function showTry(result) {
+    var box = $("try-box");
+    box.hidden = false;
+    box.innerHTML = "";
+    box.appendChild(el("h2", { text: result.ok ? "已经跑起来了" : "没能一键跑起来" }));
+    box.appendChild(el("div", { text: (result.message || "").split("\n")[0] }));
+    var running = (result.services || []).filter(function (s) {
+      return s.running && s.url;
+    });
+    if (running.length) {
+      box.appendChild(
+        el(
+          "ul",
+          { className: "services" },
+          running.map(function (s) {
+            return el("li", {}, [s.name + "：", el("a", { href: s.url, target: "_blank", rel: "noopener", text: s.url })]);
+          }),
+        ),
+      );
+      $("try-stop").hidden = false;
+    }
+    if (result.howTo && result.howTo.length) box.appendChild(el("pre", { className: "howto", text: result.howTo.join("\n") }));
+  }
+
+  function tryIt(stop) {
+    var button = stop ? $("try-stop") : $("try");
+    button.disabled = true;
+    button.textContent = stop ? "正在停止…" : "正在启动，可能要一两分钟…";
+    api("api/try", "POST", { stop: !!stop })
+      .then(function (r) {
+        if (stop) {
+          toast(r.message);
+          $("try-stop").hidden = true;
+          $("try-box").hidden = true;
+        } else showTry(r);
+      })
+      .catch(function (e) {
+        toast(e.message);
+      })
+      .then(function () {
+        button.disabled = false;
+        button.textContent = stop ? "停止试用" : "把它跑起来试用";
+      });
+  }
+
+  function submit() {
+    state.busy = true;
+    summary();
+    api("api/submit", "POST", { answers: answersList(), reviewer: state.reviewer })
+      .then(function (r) {
+        toast(r.message);
+        var done = el("section", { className: "card done" }, [el("h2", { text: "已提交：验收" + r.verdict }), el("div", { text: r.message })]);
+        document.querySelector("main").insertBefore(done, document.querySelector("main").firstChild);
+        window.scrollTo(0, 0);
+      })
+      .catch(function (e) {
+        toast(e.message);
+        state.busy = false;
+        summary();
+      });
+  }
+
+  function start() {
+    api("api/info").then(function (info) {
+      state.info = info;
+      document.title = "验收清单：" + info.title;
+      $("title").textContent = "验收清单：" + info.title;
+      $("project").textContent = info.project + " · " + info.featureDir;
+      $("sub").textContent = [info.reportVerdict ? "流水线结论：" + info.reportVerdict : null, info.accepted ? "上次验收：" + info.accepted : null, info.readOnly ? "只读：可以看，不能提交" : null]
+        .filter(Boolean)
+        .join("　");
+      (info.draft && info.draft.answers ? info.draft.answers : []).forEach(function (a) {
+        state.answers[a.id] = { mark: a.mark, note: a.note || "" };
+      });
+      state.reviewer = (info.draft && info.draft.reviewer) || "";
+      $("reviewer").value = state.reviewer;
+      if (info.notes && info.notes.length) {
+        var n = $("notes");
+        n.hidden = false;
+        n.appendChild(el("h2", { text: "先看一下（来自提测说明）" }));
+        n.appendChild(
+          el(
+            "ul",
+            {},
+            info.notes.map(function (t) {
+              return el("li", { text: t });
+            }),
+          ),
+        );
+      }
+      if (info.readOnly || info.running) $("try").hidden = true;
+      if (!info.items.length) $("items").appendChild(el("li", { className: "item", text: "需求说明里没有找到验收标准（AC-编号）。" }));
+      render();
+    }).catch(function (e) {
+      $("title").textContent = "打不开验收清单";
+      $("sub").textContent = e.message;
+    });
+    $("reviewer").addEventListener("input", function (e) {
+      state.reviewer = e.target.value;
+      save();
+    });
+    $("try").addEventListener("click", function () {
+      tryIt(false);
+    });
+    $("try-stop").addEventListener("click", function () {
+      tryIt(true);
+    });
+    $("submit").addEventListener("click", submit);
+  }
+
+  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 { type Answer, acceptanceFailMessage, acceptanceText, buildChecklist, recordAcceptance, verdictOf } from "./checklist.js";
 import { readIndex } from "./records.js";
 import { readState, statePath } from "./state.js";
 
@@ -203,6 +204,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 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 +307,28 @@ 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;
   return http.createServer((req, res) => {
     opts.onRequest?.();
     handle(req, res).catch((error: Error) => json(res, 500, { ok: false, message: error.message }));
@@ -332,6 +354,11 @@ 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 === "") 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 +427,72 @@ export function createReviewServer(opts: ReviewServerOptions): http.Server {
     }
     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 +623,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 });

package/engine/src/try.ts

@@ -0,0 +1,134 @@
+// `req try <需求> [--stop]` (1.14): runs a finished requirement so the requester can try it,
+// without knowing how to start the project. The project's paseo.json services are started in the
+// requirement's own workspace through Paseo (each on its own port), and the addresses are given
+// with what the handoff note says about test accounts and data. Projects without Paseo-managed
+// services get the start instructions the pipeline wrote down, and the advice to ask the chat.
+import fs from "node:fs";
+import path from "node:path";
+import { section } from "./checklist.js";
+import { DEFAULT_CONFIG, loadConfig, type PipelineConfig } from "./config.js";
+import { defaultConfigPath } from "./locations.js";
+import type { AgentRuntime, ServiceTarget } from "./runtime.js";
+import { isAlive, readState, statePath } from "./state.js";
+
+export interface TryResult {
+  ok: boolean;
+  message: string;
+  services: Array<{ name: string; url: string | null; running: boolean; output: string | null }>;
+  /** How to start it and what test data to use, from handoff.md / service-start.md. */
+  howTo: string[];
+  stopped?: boolean;
+}
+
+function read(file: string): string {
+  try {
+    return fs.readFileSync(file, "utf8");
+  } catch {
+    return "";
+  }
+}
+
+const tidy = (lines: string[]) => lines.map((l) => l.replace(/\s+$/, "")).filter((l, i, all) => l.trim() || (i > 0 && all[i - 1].trim())).slice(0, 40);
+
+/** What the pipeline wrote about running it and the data to use. */
+export function howToTry(featureAbs: string): string[] {
+  const handoff = read(path.join(featureAbs, "handoff.md"));
+  const run = section(handoff, /怎么跑起来|如何运行|启动/);
+  const data = section(handoff, /测试需要的准备|测试数据|账号/);
+  const start = run.length ? run : section(read(path.join(featureAbs, "service-start.md")), /启动方法|怎么启动|启动/);
+  return tidy([...(start.length ? ["怎么跑起来：", ...start] : []), ...(data.length ? ["", "测试需要的准备：", ...data] : [])]);
+}
+
+interface TryRecord {
+  at: string;
+  target: ServiceTarget;
+  names: string[];
+}
+
+const recordFile = (featureAbs: string) => path.join(featureAbs, ".pipeline", "try.json");
+
+export async function tryRequirement(input: { repo: string; featureDir: string; stop?: boolean; runtime: Pick<AgentRuntime, "listServices" | "startServices" | "stopServices">; config: PipelineConfig }): Promise<TryResult> {
+  const featureAbs = path.join(input.repo, input.featureDir);
+  const state = readState(statePath(input.repo, input.featureDir));
+  const howTo = howToTry(featureAbs);
+  if (input.stop) {
+    let rec: TryRecord | null = null;
+    try {
+      rec = JSON.parse(fs.readFileSync(recordFile(featureAbs), "utf8")) as TryRecord;
+    } catch {
+      rec = null;
+    }
+    if (!rec) return { ok: true, message: "没有由试用启动的服务，不用停止。", services: [], howTo, stopped: false };
+    await input.runtime.stopServices(rec.target, rec.names);
+    fs.rmSync(recordFile(featureAbs), { force: true });
+    return { ok: true, message: `已停止试用的服务：${rec.names.join("、")}。`, services: [], howTo, stopped: true };
+  }
+  if (state && state.status === "running" && isAlive(state.pid)) {
+    return { ok: false, message: "流水线还在运行，它会自己启动和停止服务。等开发结束后再试用。", services: [], howTo };
+  }
+  const target: ServiceTarget | null = state?.worktree?.workspaceId ? { workspaceId: state.worktree.workspaceId } : state?.originAgentId ? { agentId: state.originAgentId } : null;
+  const names = target ? await input.runtime.listServices(target).catch(() => null) : null;
+  if (!target || !names || names.length === 0) {
+    return {
+      ok: false,
+      message:
+        "这个项目没有用 Paseo 管理的服务脚本（paseo.json），不能一键启动。可以在这个需求的对话里说\"帮我把它跑起来\"，或按下面的方法启动；以后请开发同事运行 /req-setup 写好 paseo.json，就能一键试用。",
+      services: [],
+      howTo,
+    };
+  }
+  const started = await input.runtime.startServices(target, names, input.config.serviceReadySeconds * 1000);
+  fs.mkdirSync(path.dirname(recordFile(featureAbs)), { recursive: true });
+  fs.writeFileSync(recordFile(featureAbs), JSON.stringify({ at: new Date().toISOString(), target, names } satisfies TryRecord, null, 2));
+  const failed = started.filter((s) => !s.running);
+  const services = started.map((s) => ({ name: s.name, url: s.url, running: s.running, output: s.running ? null : s.output }));
+  const ok = failed.length === 0;
+  const lines = started.map((s) => (s.running ? `- ${s.name}：${s.url ?? "已启动（没有网页地址）"}` : `- ${s.name}：没有启动成功`));
+  return {
+    ok,
+    message: `${ok ? "已启动，可以试用了" : "有服务没有启动成功"}：\n${lines.join("\n")}\n用完后停止：req try ${path.basename(input.featureDir)} --stop（插件里点"停止试用"）。`,
+    services,
+    howTo,
+  };
+}
+
+async function main(argv: string[]): Promise<number> {
+  const stop = argv.includes("--stop");
+  const json = argv.includes("--json");
+  const feature = argv.find((a) => !a.startsWith("--"));
+  if (!feature || argv.includes("--help") || argv.includes("-h")) {
+    console.log("用法：req try <需求> [--stop]\n\n把做好的需求在它自己的工作区里跑起来，给出访问地址和测试数据，方便亲手试用；--stop 停止。");
+    return feature ? 0 : 2;
+  }
+  const { locate } = await import("./api.js");
+  const { repo, featureDir } = locate(process.cwd(), feature);
+  let config: PipelineConfig;
+  try {
+    config = loadConfig(defaultConfigPath(), repo).config;
+  } catch {
+    config = DEFAULT_CONFIG;
+  }
+  const { loadRuntimeFactory } = await import("./runtime-loader.js");
+  const runtime = await (await loadRuntimeFactory())({ config, log: () => undefined });
+  try {
+    const result = await tryRequirement({ repo, featureDir, stop, runtime, config });
+    if (json) console.log(JSON.stringify(result));
+    else {
+      console.log(result.message);
+      if (result.howTo.length) console.log(`\n${result.howTo.join("\n")}`);
+    }
+    return result.ok ? 0 : 1;
+  } finally {
+    await runtime.close().catch(() => undefined);
+  }
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === path.resolve(import.meta.filename)) {
+  main(process.argv.slice(2)).then(
+    (code) => process.exit(code),
+    (error: Error) => {
+      console.error(`没有启动：${error.message}`);
+      process.exit(1);
+    },
+  );
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paseo-req-kit",
-  "version": "1.14.0-beta.2",
+  "version": "1.14.0-beta.3",
   "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) {
+export function useReviewUrl(repo: string, featureDir: string, enabled: boolean, page: "prototype" | "check" = "prototype") {
   const reviewUrl = useRpc(reviewUrlRpc);
   return useQuery({
-    queryKey: ["req", "review-url", repo, featureDir],
-    queryFn: () => reviewUrl({ repo, featureDir }),
+    queryKey: ["req", "review-url", repo, featureDir, page],
+    queryFn: () => reviewUrl({ repo, featureDir, ...(page === "check" ? { 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 { ReviewButton } from "./review";
+import { ChecklistButton, ReviewButton } from "./review";
 import { Badge, Button, Chip, Status, useStyles } from "./ui";
 
 type Theme = PluginHostProps["theme"];
@@ -168,6 +168,8 @@ export function RequirementView({
   if (!d) return <Status theme={theme} loading={query.isPending} error={query.error} />;
   const steps = allSteps ? d.steps : d.steps.slice(-12);
   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;
   return (
     <View style={{ gap: 16 }}>
       <View style={{ gap: 4 }}>
@@ -194,8 +196,9 @@ export function RequirementView({
         {d.attention === "business" ? <Text style={s.muted}>需求方的决定请在发起需求的对话中回答，回答后再继续。</Text> : null}
       </View>
 
-      {actions.length > 0 || d.hasPrototype ? (
+      {actions.length > 0 || d.hasPrototype || canAccept ? (
         <View style={s.row}>
+          {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) => (
             <Button key={a} theme={theme} primary={a !== "stop" && !(a === "approve" && d.hasPrototype)} label={ACTION_TEXT[a].label} onPress={() => setAction(a)} />

package/paseo-plugin/client/nav.ts

@@ -10,3 +10,8 @@ export function setScreenOpener(open: Opener): void {
 export function openReview(input: { repo: string; featureDir: string; title: string }): void {
   opener?.({ screenId: "review", params: { repo: input.repo, featureDir: input.featureDir, title: input.title } });
 }
+
+/** 1.14: the acceptance checklist of a requirement (the same screen, another page). */
+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" } });
+}

package/paseo-plugin/client/review.tsx

@@ -4,12 +4,17 @@ 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 { openReview } from "./nav";
+import { openChecklist, openReview } from "./nav";
 import { Button, Status, useStyles } from "./ui";
 import { canEmbedPages, embeddedPage, reviewUnreachable } from "./web";
 
 type Theme = PluginHostProps["theme"];
 
+/** 1.14: the acceptance checklist, primary while the requirement waits for acceptance. */
+export function ChecklistButton({ theme, repo, featureDir, title, primary }: { theme: Theme; repo: string; featureDir: string; title: string; primary: boolean }) {
+  return <Button theme={theme} primary={primary} label="验收清单（可一键试用）" onPress={() => openChecklist({ 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 })} />;
@@ -19,7 +24,8 @@ export function ReviewScreen({ theme, layout, params }: PluginScreenProps) {
   const s = useStyles(theme, layout.compact);
   const repo = params.repo ?? "";
   const featureDir = params.featureDir ?? "";
-  const review = useReviewUrl(repo, featureDir, true);
+  const page = params.page === "check" ? "check" : "prototype";
+  const review = useReviewUrl(repo, featureDir, true, page);
   if (!review.data) {
     return (
       <View style={[s.screen, { padding: 16 }]}>
@@ -38,17 +44,25 @@ export function ReviewScreen({ theme, layout, params }: PluginScreenProps) {
       </View>
     );
   }
-  const frame = canEmbedPages ? embeddedPage(url, `原型审查：${params.title ?? featureDir}`) : null;
+  const frame = canEmbedPages ? embeddedPage(url, `${page === "check" ? "验收清单" : "原型审查"}：${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}>{readOnly ? "插件设为只读：可以看原型，不能提交意见或确认。" : "点原型上要改的地方提意见，双击文字直接改字；看完在右下角提交或确认方案。"}</Text>
+        <Text style={s.muted}>
+          {page === "check"
+            ? readOnly
+              ? "插件设为只读：可以看清单，不能提交。"
+              : "逐条核对：通过、不对（写下看到了什么）、先不验；需要时点右上角把它跑起来。"
+            : readOnly
+              ? "插件设为只读：可以看原型，不能提交意见或确认。"
+              : "点原型上要改的地方提意见，双击文字直接改字；看完在右下角提交或确认方案。"}
+        </Text>
         <ExternalLink href={url}>在新窗口打开</ExternalLink>
       </View>
       {frame ?? (
         <View style={[s.card, { margin: 12, gap: 8 }]}>
-          <Text style={s.text}>原型审查页在浏览器中打开效果最好（手机上屏幕较小，建议用电脑）。</Text>
-          <ExternalLink href={url}>打开原型审查页</ExternalLink>
+          <Text style={s.text}>{page === "check" ? "验收清单" : "原型审查页"}在浏览器中打开效果最好（手机上屏幕较小，建议用电脑）。</Text>
+          <ExternalLink href={url}>{page === "check" ? "打开验收清单" : "打开原型审查页"}</ExternalLink>
         </View>
       )}
     </View>

package/paseo-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "req-kit-paseo-plugin",
-  "version": "1.14.0-beta.2",
+  "version": "1.14.0-beta.3",
   "private": true,
   "description": "The req-kit plugin for Paseo. Ships inside the paseo-req-kit package; installed with req plugin install.",
   "type": "module",