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

package/paseo-plugin/client/format.ts

@@ -108,4 +108,5 @@ export const ACTION_TEXT = {
   resume: { label: "继续", confirm: "从中断处继续？需求说明改过的话，只处理变化的部分。" },
   verify: { label: "开始测试验证", confirm: "开始测试验证？选择在哪里验证。" },
   sync: { label: "同步到外部系统", confirm: "把这个需求同步到对接的外部系统：补发没有成功的调用、补建卡片、更新状态。" },
+  reply: { label: "发送回复", confirm: "把回复转给这个需求的对话，由它更新需求说明并继续开发。" },
 } as const;

package/paseo-plugin/client/inbox.tsx

@@ -0,0 +1,173 @@
+// "等你处理" (1.12): everything that is waiting for a person, at the top, each with what to do and
+// how long it has waited. Answers and plan confirmations can be given right here: an answer is
+// passed to the requirement's chat (req reply), the same as typing it there.
+import type { PluginHostProps } from "@getpaseo/plugin/client";
+import { TextInput, useToast } from "@getpaseo/plugin/client/react-native";
+import { useState } from "react";
+import { Text, View } from "react-native";
+import type { Attention, Requirement } from "../shared/contracts";
+import { useAction, usePreferences } from "./data";
+import { facts } from "./format";
+import { Badge, Button, useStyles } from "./ui";
+
+type Theme = PluginHostProps["theme"];
+type Layout = PluginHostProps["layout"];
+
+const KIND: Record<Exclude<Attention, null>, { label: string; tone: "warning" | "danger" | "muted"; todo: string }> = {
+  approval: { label: "确认方案", tone: "warning", todo: "方案已通过审核。看一下“做完后会看到什么”，没问题就确认，开始写代码；要改就写下来。" },
+  business: { label: "回答问题", tone: "warning", todo: "方案审核有问题只有你能决定，回答后开发会接着进行。" },
+  interrupted: { label: "已中断", tone: "danger", todo: "开发中断了，自动处理没能解决。看一下原因，能继续就继续。" },
+  not_completed: { label: "没有完成", tone: "muted", todo: "流水线结束了，但有部分没有做完。完成报告里写了原因和建议。" },
+};
+
+/** Plain waiting time: "等了 3 小时". */
+export function waited(since: string, now = Date.now()): string {
+  const m = (now - Date.parse(since)) / 60_000;
+  if (!Number.isFinite(m) || m < 1) return "刚刚";
+  if (m < 60) return `等了 ${Math.round(m)} 分钟`;
+  if (m < 48 * 60) return `等了 ${Math.round(m / 60)} 小时`;
+  return `等了 ${Math.round(m / 60 / 24)} 天`;
+}
+
+/** Longest-waiting first: the oldest decision is the one holding things up most. */
+export function inboxItems(items: Requirement[]): Requirement[] {
+  return items
+    .filter((r) => r.attention)
+    .sort((a, b) => (a.waiting?.since ?? a.updatedAt).localeCompare(b.waiting?.since ?? b.updatedAt));
+}
+
+function InboxCard({ theme, layout, item, open, readOnly }: { theme: Theme; layout: Layout; item: Requirement; open(): void; readOnly: boolean }) {
+  const s = useStyles(theme, layout.compact);
+  const run = useAction();
+  const toast = useToast();
+  const [writing, setWriting] = useState(item.attention === "business");
+  const [text, setText] = useState("");
+  const kind = KIND[item.attention!];
+  const w = item.waiting;
+  const repo = item.sourceRepo ?? item.repo;
+
+  const act = async (action: "approve" | "resume" | "reply") => {
+    try {
+      const result = await run.mutateAsync({ action, repo, featureDir: item.featureDir, ...(action === "reply" ? { text } : {}) });
+      const first = result.message.split("\n").find((l) => l.trim()) ?? "";
+      if (result.ok) {
+        toast.show(first || "已完成", { variant: "success", durationMs: 4000 });
+        setText("");
+      } else toast.error(first || "没有完成");
+    } catch (error) {
+      toast.error((error as Error).message);
+    }
+  };
+
+  return (
+    <View style={[s.card, { gap: 10, borderLeftWidth: 3, borderLeftColor: kind.tone === "danger" ? theme.colors.statusDanger : kind.tone === "warning" ? theme.colors.statusWarning : theme.colors.border }]}>
+      <View style={[s.row, { justifyContent: "space-between" }]}>
+        <View style={[s.row, { flexShrink: 1 }]}>
+          <Badge theme={theme} tone={kind.tone}>
+            {kind.label}
+          </Badge>
+          <Text style={[s.text, { fontWeight: "600", flexShrink: 1 }]}>{item.title}</Text>
+        </View>
+        <Text style={s.muted}>{waited(w?.since ?? item.updatedAt)}</Text>
+      </View>
+      <Text style={s.muted}>
+        {facts(item)}
+        {w?.card ? ` · 卡片 ${w.card.system} ${w.card.id}${w.card.requester ? `（${w.card.requester}）` : ""}` : ""}
+      </Text>
+      <Text style={s.text}>{kind.todo}</Text>
+
+      {item.attention === "business" && w && w.questions.length > 0 ? (
+        <View style={{ gap: 4 }}>
+          {w.questions.map((q, i) => (
+            <Text key={i} style={s.text}>
+              {i + 1}. {q}
+            </Text>
+          ))}
+        </View>
+      ) : null}
+      {item.attention === "interrupted" && w?.reason ? (
+        <Text style={s.danger} numberOfLines={4}>
+          {w.reason}
+        </Text>
+      ) : null}
+
+      {readOnly ? (
+        <View style={s.row}>
+          <Button theme={theme} label="查看详情" onPress={open} />
+          <Text style={s.muted}>插件设置为只读，请在对话中处理</Text>
+        </View>
+      ) : (
+        <>
+          {writing && w?.canReply ? (
+            <View style={{ gap: 8 }}>
+              <TextInput
+                value={text}
+                onChangeText={setText}
+                multiline
+                placeholder={item.attention === "approval" ? "写下要改的地方，例如：按钮放在右上角" : w.questions.length > 1 ? "按编号回答，例如：1. 只有新订单显示  2. 不需要" : "写下你的回答"}
+                placeholderTextColor={theme.colors.foregroundMuted}
+                style={{
+                  minHeight: 72,
+                  padding: 10,
+                  borderRadius: 8,
+                  borderWidth: 1,
+                  borderColor: theme.colors.border,
+                  backgroundColor: theme.colors.surface0,
+                  color: theme.colors.foreground,
+                  fontSize: 14,
+                  textAlignVertical: "top",
+                }}
+              />
+              {w.card ? <Text style={s.muted}>也可以在卡片的“需求方回复”区回答，效果一样。</Text> : null}
+            </View>
+          ) : null}
+          <View style={s.row}>
+            {item.attention === "approval" ? (
+              <>
+                <Button theme={theme} primary label={run.isPending ? "正在执行…" : "确认方案"} disabled={run.isPending} onPress={() => void act("approve")} />
+                {w?.canReply ? (
+                  writing ? (
+                    <Button theme={theme} label="发送修改意见" disabled={run.isPending || !text.trim()} onPress={() => void act("reply")} />
+                  ) : (
+                    <Button theme={theme} label="提修改意见" onPress={() => setWriting(true)} />
+                  )
+                ) : null}
+              </>
+            ) : null}
+            {item.attention === "business" && w?.canReply ? (
+              <Button theme={theme} primary label={run.isPending ? "正在发送…" : "发送回答"} disabled={run.isPending || !text.trim()} onPress={() => void act("reply")} />
+            ) : null}
+            {item.attention === "interrupted" ? (
+              <Button theme={theme} primary label={run.isPending ? "正在执行…" : "继续"} disabled={run.isPending} onPress={() => void act("resume")} />
+            ) : null}
+            <Button theme={theme} label={item.attention === "approval" ? "看方案和确认预览" : item.attention === "not_completed" ? "看完成报告" : "查看详情"} onPress={open} />
+          </View>
+        </>
+      )}
+    </View>
+  );
+}
+
+export function Inbox({ theme, layout, items, open }: { theme: Theme; layout: Layout; items: Requirement[]; open(item: Requirement): void }) {
+  const s = useStyles(theme, layout.compact);
+  const { readOnly } = usePreferences();
+  const waiting = inboxItems(items);
+  return (
+    <View style={{ gap: 10 }}>
+      <View style={[s.row, { justifyContent: "space-between" }]}>
+        <Text style={[s.title, { fontSize: 16 }]}>等你处理{waiting.length > 0 ? `（${waiting.length}）` : ""}</Text>
+        {waiting.length > 0 ? <Text style={s.muted}>等得最久的在前</Text> : null}
+      </View>
+      {waiting.length === 0 ? (
+        <View style={[s.card, { flexDirection: "row", alignItems: "center", gap: 8 }]}>
+          <Badge theme={theme} tone="success">
+            没有
+          </Badge>
+          <Text style={s.muted}>现在没有需要你处理的事。需要你确认或回答时，会出现在这里。</Text>
+        </View>
+      ) : (
+        waiting.map((item) => <InboxCard key={item.key} theme={theme} layout={layout} item={item} open={() => open(item)} readOnly={readOnly} />)
+      )}
+    </View>
+  );
+}

package/paseo-plugin/client/overview.tsx

@@ -6,6 +6,7 @@ import { Text, View } from "react-native";
 import type { Requirement } from "../shared/contracts";
 import { useRequirements } from "./data";
 import { type Group, GROUP_LABELS, groupOf } from "./format";
+import { Inbox } from "./inbox";
 import { RequirementRow } from "./row";
 import { Button, Chip, Status, useStyles } from "./ui";
 
@@ -19,7 +20,8 @@ export function RequirementGroups({
   layout,
   items,
   open,
-}: Pick<PluginScreenProps, "theme" | "layout"> & { items: Requirement[]; open: OpenRequirement }) {
+  skip = [],
+}: Pick<PluginScreenProps, "theme" | "layout"> & { items: Requirement[]; open: OpenRequirement; skip?: Group[] }) {
   const s = useStyles(theme, layout.compact);
   const [showOther, setShowOther] = useState(false);
   const groups = useMemo(() => {
@@ -29,7 +31,7 @@ export function RequirementGroups({
   }, [items]);
   return (
     <View style={{ gap: 20 }}>
-      {ORDER.filter((g) => groups.has(g)).map((g) => (
+      {ORDER.filter((g) => groups.has(g) && !skip.includes(g)).map((g) => (
         <View key={g} style={{ gap: 8 }}>
           <View style={s.row}>
             <Text style={s.heading}>
@@ -67,6 +69,7 @@ export function OverviewScreen(props: PluginScreenProps & { openScreen: ScreenOp
       <ScrollView contentContainerStyle={s.body}>
         <View style={s.row}>
           <Button theme={theme} label="使用统计" onPress={() => props.openScreen({ screenId: "stats" })} />
+          <Button theme={theme} label="配置" onPress={() => props.openScreen({ screenId: "config" })} />
         </View>
         {projects.length > 1 ? (
           <View style={s.row}>
@@ -82,7 +85,8 @@ export function OverviewScreen(props: PluginScreenProps & { openScreen: ScreenOp
           error={query.error}
           empty={query.data && items.length === 0 ? "这台机器上还没有记录任何需求。在 Paseo 对话中用 /req 开始一个；1.9 之前运行过的需求，在项目目录运行 req index --rebuild。" : null}
         />
-        <RequirementGroups theme={theme} layout={layout} items={shown} open={open} />
+        {query.data && items.length > 0 ? <Inbox theme={theme} layout={layout} items={shown} open={open} /> : null}
+        <RequirementGroups theme={theme} layout={layout} items={shown} open={open} skip={["attention"]} />
       </ScrollView>
     </View>
   );

package/paseo-plugin/index.client.tsx

@@ -1,4 +1,5 @@
 import type { PluginClientContext, PluginScreenProps } from "@getpaseo/plugin/client";
+import { ConfigScreen } from "./client/config";
 import { RequirementScreen } from "./client/detail";
 import { contributeLive } from "./client/live";
 import { OverviewScreen } from "./client/overview";
@@ -14,6 +15,7 @@ export default function contribute(client: PluginClientContext) {
   client.addScreen({ id: "overview", title: "需求", Component: Overview });
   client.addScreen({ id: "requirement", title: (params) => params.title || params.name || "需求", Component: RequirementScreen });
   client.addScreen({ id: "stats", title: "需求统计", Component: StatsScreen });
+  client.addScreen({ id: "config", title: "req-kit 配置", Component: ConfigScreen });
   client.addSidebarHeaderItem({ id: "requirements", title: "需求（req-kit）", Component: RequirementsItem });
   client.addWorkspacePanel({
     id: "requirements",
@@ -40,6 +42,14 @@ export default function contribute(client: PluginClientContext) {
     context: "global",
     onSelect: ({ openScreen: open }) => open({ screenId: "stats" }),
   });
+  client.addCommandCenterItem({
+    id: "open-config",
+    title: "req-kit 配置",
+    icon: "Settings",
+    keywords: ["req", "config", "配置", "设置"],
+    context: "global",
+    onSelect: ({ openScreen: open }) => open({ screenId: "config" }),
+  });
   client.addCommandCenterItem({
     id: "open-panel",
     title: "这个工作区的需求（req-kit）",

package/paseo-plugin/index.server.ts

@@ -1,5 +1,5 @@
 import type { PluginServerContext } from "@getpaseo/plugin/server";
-import { fileRpc, listRpc, modelsRpc, preferences, runRpc, setAgentsRpc, statsRpc, statusRpc, versionRpc } from "./shared/contracts";
+import { configRpc, fileRpc, listRpc, modelsRpc, preferences, runRpc, setAgentsRpc, statsRpc, statusRpc, versionRpc } from "./shared/contracts";
 import { createHandlers } from "./server/handlers";
 import { kitHomeOf, reqApi } from "./server/req";
 
@@ -36,6 +36,7 @@ export default function contribute(server: PluginServerContext) {
   server.handle(statsRpc, (input) => handlers.stats(input));
   server.handle(runRpc, (input) => handlers.run(input));
   server.handle(modelsRpc, () => handlers.models());
+  server.handle(configRpc, (input) => handlers.config(input));
   server.handle(setAgentsRpc, (input) => handlers.setAgents(input));
   return () => {
     unsubscribe();

package/paseo-plugin/package.json

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

package/paseo-plugin/server/handlers.ts

@@ -1,7 +1,7 @@
 // The daemon side: each RPC is one `req api` call. Management actions are refused here too
 // when the plugin is set to read-only, not only hidden in the app.
 import type { RpcInput } from "@getpaseo/plugin";
-import type { fileRpc, KitInfo, ModelsData, Requirement, RequirementDetail, runRpc, setAgentsRpc, statsRpc, StatsSummary, statusRpc } from "../shared/contracts";
+import type { configRpc, ConfigViewData, fileRpc, KitInfo, ModelsData, Requirement, RequirementDetail, runRpc, setAgentsRpc, statsRpc, StatsSummary, statusRpc } from "../shared/contracts";
 import { coalesce, type ReqRunner } from "./req";
 
 export interface Handlers {
@@ -12,6 +12,7 @@ export interface Handlers {
   stats(input: RpcInput<typeof statsRpc>): Promise<StatsSummary>;
   run(input: RpcInput<typeof runRpc>): Promise<{ ok: boolean; message: string }>;
   models(): Promise<ModelsData>;
+  config(input: RpcInput<typeof configRpc>): Promise<ConfigViewData>;
   setAgents(input: RpcInput<typeof setAgentsRpc>): Promise<{ ok: boolean; message: string }>;
 }
 
@@ -37,12 +38,16 @@ export function createHandlers(input: { req: ReqRunner; kitHome: () => string; r
       else if (since) args.push("--since", since);
       return (await req(args)) as StatsSummary;
     },
-    async run({ action, repo, featureDir, verifyEnv }) {
+    async run({ action, repo, featureDir, verifyEnv, text }) {
       if (await input.readOnly()) return { ok: false, message: "插件设置为只读：不能在这里操作需求。可以在插件设置中关闭只读，或在终端用 req 命令。" };
-      const extra = action === "verify" && verifyEnv ? ["--verify-env", verifyEnv] : [];
+      if (action === "reply" && !text?.trim()) return { ok: false, message: "回复是空的" };
+      const extra = action === "verify" && verifyEnv ? ["--verify-env", verifyEnv] : action === "reply" ? [text!.trim()] : [];
       const result = (await req(["run", action, featureDir, "--repo", repo, ...extra], { timeoutMs: 200_000 })) as { ok: boolean; message: string };
       return { ok: result.ok, message: result.message };
     },
+    async config({ repo }) {
+      return (await req(repo ? ["config", "--repo", repo] : ["config", "--machine"])) as ConfigViewData;
+    },
     async models() {
       return (await req(["models"], { timeoutMs: 120_000 })) as ModelsData;
     },

package/paseo-plugin/shared/contracts.ts

@@ -34,6 +34,14 @@ export interface Requirement {
   updatedAt: string;
   usage: Usage | null;
   present: boolean;
+  /** req-kit 1.12+: what a requirement that needs a person is waiting for; absent before. */
+  waiting?: {
+    since: string;
+    questions: string[];
+    reason: string | null;
+    card: { system: string; id: string; url: string | null; requester: string | null } | null;
+    canReply: boolean;
+  } | null;
 }
 
 export interface Step {
@@ -139,7 +147,7 @@ export const statsRpc = defineRpc({
   output: z.custom<StatsSummary>(),
 });
 
-export const ACTIONS = ["approve", "stop", "resume", "verify", "sync"] as const;
+export const ACTIONS = ["approve", "stop", "resume", "verify", "sync", "reply"] as const;
 export type Action = (typeof ACTIONS)[number];
 
 export const runRpc = defineRpc({
@@ -148,10 +156,41 @@ export const runRpc = defineRpc({
     action: z.enum(ACTIONS),
     /** For verify: local | deployed. */
     verifyEnv: z.enum(["local", "deployed"]).optional(),
+    /** For reply (1.12): the answer, passed to the requirement's chat. */
+    text: z.string().max(8000).optional(),
   }),
   output: z.object({ ok: z.boolean(), message: z.string() }),
 });
 
+/** req api config (1.12): every setting, its value in words and which file set it. */
+export type ConfigLayer = "machine" | "team" | "project";
+
+export interface ConfigItemData {
+  key: string;
+  label: string;
+  description: string;
+  display: string;
+  value: unknown;
+  setBy: ConfigLayer[];
+  scope: "any" | "machine" | "machine_team";
+  changed: boolean;
+}
+
+export interface ConfigViewData {
+  sources: Array<{ layer: ConfigLayer; path: string }>;
+  ignored: string[];
+  error: string | null;
+  repo: string | null;
+  groups: Array<{ id: string; title: string; description: string; items: ConfigItemData[] }>;
+}
+
+/** The configuration in a project (repo), or this machine's without a project. */
+export const configRpc = defineRpc({
+  name: "req.config",
+  input: z.object({ repo: z.string().optional() }),
+  output: z.custom<ConfigViewData>(),
+});
+
 /** Agent settings, as req-kit writes them (1.12). */
 export interface AgentProfileData {
   provider?: string;
@@ -184,7 +223,7 @@ const profile = z.record(z.string(), z.unknown());
 
 /** Writes the agents to this machine's req-kit config (refused when the plugin is read-only). */
 export const setAgentsRpc = defineRpc({
-  name: "req.setAgents",
+  name: "req.set-agents",
   input: z.object({ builder: profile, reviewer: profile, fallback: profile.nullable() }),
   output: z.object({ ok: z.boolean(), message: z.string() }),
 });

package/skills/req/playbooks/unattended.md

@@ -81,6 +81,7 @@
 - **回答了问题、写了补充说明**：更新 `alignment.md` 和 `spec.md`，把已回答的问题从 card-ai.md 中删掉（问题编号不要重用，新问题接着往后编），有新问题就加上，更新摘要，再运行 `<publish>`。
 - **需求方修改了卡片描述**：重新读 `card-source.md`，同上更新并发布。
 - **"确认"一行写的不是同意**（例如"修改：…"）：当作修改意见处理，更新后发布，请需求方再次确认。
+- **按自动确认处理**（团队打开了 `autoConfirm`，小改动、没有待答问题的卡片到时没有异议）：与"确认：同意"相同，进入第 6 步，第 6 步中 spec 顶部写 `- 状态：已确认（<日期>，到时没有异议，自动确认）`。
 - **确认：同意**：进入第 6 步。确认时仍有没回答、而且会影响做法的问题：不要启动，在 card-ai.md 中说明还差哪些，发布后等待。
 
 ## 6. 需求方确认后启动开发