@unifan/pi-unifan-zh 1.0.0

package/extensions/review/src/workflow-schemas.ts

@@ -0,0 +1,172 @@
+/**
+ * JSON Schema fragments injected as `outputSchema` on each reviewer and the
+ * gate. Kept in sync with src/schema.ts (used by the legacy spawn pipeline).
+ *
+ * The plugin no longer reads reviewer Markdown text; the workflowScript
+ * receives validated `result.structuredOutput` from pi-subagents.
+ */
+import type { IssueSeverity, IssueCategory, Verdict } from "./types.js";
+
+export type JsonSchema = Record<string, unknown>;
+
+const SEVERITY: IssueSeverity[] = ["blocker", "major", "minor", "nit"];
+const CATEGORY: IssueCategory[] = [
+	"compliance",
+	"bug",
+	"convention",
+	"history",
+	"security",
+	"performance",
+	"docs",
+	"other",
+];
+const VERDICT: Verdict[] = ["approve", "request_changes", "comment"];
+
+/**
+ * Stable JSON Schema describing the structured output of every reviewer.
+ * `status` distinguishes runtime `ok` (tool succeeded) from business
+ * `limited/skipped` (no findings because of missing context, not silence).
+ */
+export const REVIEWER_OUTPUT_SCHEMA: JsonSchema = {
+	type: "object",
+	additionalProperties: false,
+	required: ["status", "issues", "summary", "coverage"],
+	properties: {
+		status: {
+			type: "string",
+			enum: ["ok", "limited", "skipped"],
+			description:
+				"ok = reviewer produced findings normally; limited = could not run some checks (still may have issues); skipped = lane does not apply.",
+		},
+		issues: {
+			type: "array",
+			maxItems: 200,
+			items: {
+				type: "object",
+				additionalProperties: false,
+				required: ["file", "category", "severity", "confidence", "evidence", "fingerprint"],
+				properties: {
+					file: { type: "string", minLength: 1, maxLength: 500 },
+					line: { type: "integer", minimum: 1 },
+					relatedChangedLine: { type: "integer", minimum: 1 },
+					category: { type: "string", enum: CATEGORY },
+					severity: { type: "string", enum: SEVERITY },
+					confidence: { type: "integer", minimum: 1, maximum: 10 },
+					evidence: { type: "string", minLength: 1, maxLength: 280 },
+					fingerprint: {
+						type: "string",
+						minLength: 1,
+						maxLength: 80,
+						description:
+							"Stable id (file:line:category[:short-hash-of-evidence]) so the gate can dedupe across reviewers.",
+					},
+				},
+			},
+		},
+		summary: { type: "string", minLength: 1, maxLength: 2000 },
+		coverage: {
+			type: "object",
+			additionalProperties: false,
+			required: ["filesChecked", "commandsRun", "limitations"],
+			properties: {
+				filesChecked: { type: "array", items: { type: "string" } },
+				commandsRun: { type: "array", items: { type: "string" } },
+				limitations: {
+					type: "array",
+					items: { type: "string" },
+					description: "Plain-language reasons for limited/skipped status.",
+				},
+			},
+		},
+	},
+};
+
+/**
+ * Stable JSON Schema describing the gate's structured output. Adds
+ * `dispositions` so every candidate (kept/dropped/merged) is auditable.
+ */
+export const GATE_OUTPUT_SCHEMA: JsonSchema = {
+	type: "object",
+	additionalProperties: false,
+	required: ["status", "verdict", "issues", "dispositions", "reason"],
+	properties: {
+		status: {
+			type: "string",
+			enum: ["ok", "limited", "skipped"],
+		},
+		verdict: { type: "string", enum: VERDICT },
+		issues: {
+			type: "array",
+			maxItems: 500,
+			items: {
+				type: "object",
+				additionalProperties: false,
+				required: ["file", "category", "severity", "confidence", "evidence", "fingerprint"],
+				properties: {
+					file: { type: "string", minLength: 1, maxLength: 500 },
+					line: { type: "integer", minimum: 1 },
+					relatedChangedLine: { type: "integer", minimum: 1 },
+					category: { type: "string", enum: CATEGORY },
+					severity: { type: "string", enum: SEVERITY },
+					confidence: { type: "integer", minimum: 1, maximum: 10 },
+					evidence: { type: "string", minLength: 1, maxLength: 280 },
+					fingerprint: { type: "string", minLength: 1, maxLength: 80 },
+				},
+			},
+		},
+		dispositions: {
+			type: "array",
+			description:
+				"Per-candidate disposition: kept | dropped | merged. Required for every reviewer candidate so reports can audit threshold/dedupe/verify decisions.",
+			items: {
+				type: "object",
+				additionalProperties: false,
+				required: ["fingerprint", "decision", "originalConfidence", "finalConfidence", "reason"],
+				properties: {
+					fingerprint: { type: "string", minLength: 1, maxLength: 80 },
+					decision: { type: "string", enum: ["kept", "dropped", "merged"] },
+					originalConfidence: { type: "integer", minimum: 1, maximum: 10 },
+					finalConfidence: { type: "integer", minimum: 1, maximum: 10 },
+					sourceReviewers: {
+						type: "array",
+						items: { type: "string" },
+					},
+					reason: { type: "string", minLength: 1, maxLength: 500 },
+				},
+			},
+		},
+		reason: { type: "string", minLength: 1, maxLength: 500 },
+		coverage: {
+			type: "object",
+			additionalProperties: false,
+			properties: {
+				limitations: { type: "array", items: { type: "string" } },
+			},
+		},
+	},
+};
+
+/**
+ * Serialize a JSON Schema as a JS string literal safe to embed in the
+ * generated workflowScript. Avoids escaping mistakes from JSON.stringify +
+ * double-quoting gymnastics.
+ */
+export function serializeSchemaForJs(schema: JsonSchema): string {
+	return JSON.stringify(schema);
+}
+
+/**
+ * Serialize a JSON Schema as a multi-line JS object literal for embedding
+ * directly in the generated workflowScript (v0.7.3). The single-line form
+ * produced 1400+ character lines — the exact spot where the main agent's
+ * copy slipped a character (PR 19291 incident, `"maxLength":80",`).
+ * Multi-line keeps every line short enough to copy reliably.
+ */
+export function serializeSchemaAsObjectLiteral(schema: JsonSchema, indent = "  "): string {
+	const json = JSON.stringify(schema, null, 2);
+	// Indent every line so the literal sits cleanly inside the script body.
+	return json
+		.split("\n")
+		.map((line, i) => (i === 0 ? line : indent + line))
+		.join("\n");
+}

package/extensions/sessions/README.md

@@ -0,0 +1,41 @@
+# 📜 @unifan/pi-sessions-zh (历史会话管理器·中文版)
+
+为 **Pi Coding Agent** 打造的高颜值双栏历史会话选择器与实时预览恢复扩展。
+
+---
+
+## ✨ 核心特性
+
+- **双栏分屏浏览**：左侧会话列表（带 Git 变更统计 `+2 ~3 -1` 与相对时间），右侧毫秒级**实时渲染对话内容**。
+- **对话结构化展示**：支持区分 `◆ 用户`、`● 助手`、`◌ 思考过程`、`▸ 工具调用` 与结果折叠。
+- **全中文交互体验**：界面提示词、相对时间（刚刚/X分钟前/昨天）、操作指引全面中文化。
+- **零负担独立运行**：完全解耦自 `pi-agent-extensions`，不附带任何无用工具，零额外 Token 消耗。
+
+---
+
+## 🚀 安装方式
+
+### 独立单独安装：
+```bash
+pi install D:/program/my/pi-unifan-zh/extensions/sessions
+```
+*(或者推送到 GitHub 后使用 `pi install git:github.com/你的用户名/pi-unifan-zh?path=extensions/sessions`)*
+
+---
+
+## 🎮 使用方法
+
+在 Pi 中直接输入：
+```text
+/sessions
+```
+
+### 快捷键指南：
+- **`↑` / `↓`**：在左侧列表中移动选择会话。
+- **`Enter`**：**一键恢复并切换到所选会话**。
+- **`Tab` 或 `←` / `→`**：在左侧列表与右侧预览窗之间切换焦点。
+- **`t`**：展开 / 折叠工具执行详细输出。
+- **`h`**：展开 / 隐藏模型思考过程（Thinking）。
+- **`PgUp` / `PgDn`** 或 **`Ctrl+U` / `Ctrl+D`**：预览窗上下滚屏翻页。
+- **`Ctrl+T` 或 `Alt+W`**：切换“仅当前工作区会话”与“全部工作区会话”。
+- **`Esc`**：退出选择器，回到当前会话。