@evandu/super-pi 0.1.161 → 0.1.162

package/dist/client/index.html

@@ -8,8 +8,8 @@
     <link rel="alternate icon" href="/favicon.ico" />
     <link rel="apple-touch-icon" href="/favicon.svg" />
     <title>Super Pi</title>
-    <script type="module" crossorigin src="/assets/index-B9tN8KD3.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-BK3ZIqJj.css">
+    <script type="module" crossorigin src="/assets/index-PN2dNRnQ.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-unAm6EaY.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/server/application/project-service.d.ts

@@ -96,6 +96,20 @@ export declare class ProjectService {
     private resources;
     list(workspaceId?: string): Project[];
     get(id: string, workspaceId?: string): Project;
+    /**
+     * THE PROJECT AS A REPORT A HUMAN CAN READ.
+     *
+     * Everything the panel shows in pieces - the objective, the tasks and who did them, the
+     * deliveries and their evidence, the reviews that accepted them, the exceptions and how they
+     * were decided - in one piece of Markdown, in reading order.
+     *
+     * TWO THINGS THIS REPORT REFUSES TO DO. It prints no session handle: a conversation id is a
+     * machine address, and a report full of addresses is not something a person can read or paste
+     * into a weekly note - the session's own title is used instead. And it prints no credential of
+     * any kind: the CONTENT of the tasks, events, reports and exceptions is the report, and a
+     * capability or a token that happens to live in a session profile is not content.
+     */
+    exportReport(id: string, workspaceId?: string): Promise<string>;
     projectForSession(conversationId: string): Project | undefined;
     create(input: CreateProjectInput, initiatorConversationId?: string): Promise<Project>;
     private admission;

package/dist/server/application/project-service.js

@@ -122,6 +122,35 @@ const CACHE_WRITE_WEIGHT = 1.25;
 const tokens = (usage) => usage ? Math.round(usage.input + usage.output + usage.cacheWrite * CACHE_WRITE_WEIGHT + usage.cacheRead * CACHE_READ_WEIGHT) : 0;
 /** The budget a project starts with, and the floor the one-click raise falls back to. */
 const DEFAULT_MAX_TOKENS = 100_000;
+// THE WORDS THE REPORT SPEAKS IN. A reader of the report is a person, not a console, so every
+// state and every role is written the way a person would say it out loud.
+const PROJECT_STATUS_TEXT = {
+    planning: "草稿", active: "进行中", blocked: "已阻塞", awaiting_approval: "等待审批",
+    awaiting_review: "等待复核", completed: "已完成", cancelled: "已取消", failed: "失败",
+};
+const TASK_STATUS_TEXT = {
+    pending: "等待依赖", ready: "待派发", in_progress: "执行中", blocked: "已阻塞",
+    awaiting_review: "待复核", completed: "已完成", failed: "失败", cancelled: "已取消",
+};
+const EVENT_TEXT = {
+    created: "创建项目", started: "启动执行", task_created: "登记任务", dispatched: "派发执行",
+    submitted: "提交交付", reviewed: "复核", review_requested: "启动复核", task_updated: "任务更新", status: "状态变更",
+    budget: "预算变更", report: "进展汇报", escalated: "例外升级", decision: "决定",
+    completed: "项目完成", ready: "依赖就绪",
+};
+const ESCALATION_STATUS_TEXT = { open: "未决", resolved: "已解决", dismissed: "已忽略" };
+const SEVERITY_TEXT = { low: "低", medium: "中", high: "高" };
+const REPORT_KIND_TEXT = {
+    progress: "进展", blocked: "阻塞", delivery: "交付", decision_request: "决策请求", review: "复核",
+};
+/** ONE LINE, ONE MEANING: a value that carries newlines must not break the layout of the report. */
+const oneLine = (value) => value.replace(/\r?\n+/g, " ").trim();
+/** A table cell must not carry a pipe of its own, or the row it sits in falls apart. */
+const cell = (value) => oneLine(value).replace(/\|/g, "\\|");
+/** A long delivery is trimmed, and the trim says so - a silent cut would read as the whole truth. */
+const truncate = (value, limit) => value.length > limit ? `${value.slice(0, limit)}…（已截断）` : value;
+/** A timestamp a person can read at a glance, and a missing one that says so. */
+const moment = (value) => value ? value.replace("T", " ").replace(/\.\d+Z$/, "") : "无";
 /**
  * THE TWO SHAPES A PROJECT CAN HAVE.
  *
@@ -328,6 +357,109 @@ export class ProjectService {
     get(id, workspaceId) {
         return this.projectView(this.raw(id, workspaceId));
     }
+    /**
+     * THE PROJECT AS A REPORT A HUMAN CAN READ.
+     *
+     * Everything the panel shows in pieces - the objective, the tasks and who did them, the
+     * deliveries and their evidence, the reviews that accepted them, the exceptions and how they
+     * were decided - in one piece of Markdown, in reading order.
+     *
+     * TWO THINGS THIS REPORT REFUSES TO DO. It prints no session handle: a conversation id is a
+     * machine address, and a report full of addresses is not something a person can read or paste
+     * into a weekly note - the session's own title is used instead. And it prints no credential of
+     * any kind: the CONTENT of the tasks, events, reports and exceptions is the report, and a
+     * capability or a token that happens to live in a session profile is not content.
+     */
+    async exportReport(id, workspaceId) {
+        const p = workspaceId === undefined ? this.store.project(id) : this.raw(id, workspaceId);
+        if (!p)
+            throw new Error("项目不存在或不属于当前工作区");
+        const store = this.store;
+        /** THE TITLE A PERSON CALLS A SESSION BY. The handle stays out of the report. */
+        const session = (conversationId) => {
+            if (!conversationId)
+                return "系统";
+            return store.conversation(conversationId)?.title ?? "未知会话";
+        };
+        /** THE ROLE A TASK PLAYS, in the words the report uses. */
+        const role = (t) => t.role === "leader" ? "负责人" : t.parentTaskId ? "执行者" : "负责人直属";
+        /** THE ACCEPTANCE OF A TASK, told the truth about what is behind it. */
+        const acceptance = (t) => {
+            if (t.review?.lightweight === true)
+                return "自评交付（轻量项目，无独立复核）";
+            if (!t.review)
+                return "未验收";
+            return oneLine(t.review.summary);
+        };
+        /** THE TIMES A DELIVERY WAS SENT BACK. The current review only holds the last word, so the
+         *  earlier rejections are read back out of the timeline - the event summary carries the exact
+         *  text the reviewer wrote that day. */
+        const reworkNotes = (t) => {
+            const prefix = `退回返工：${t.title}；`;
+            return (p.events ?? []).filter((e) => e.kind === "reviewed" && e.taskId === t.id && e.summary.startsWith(prefix))
+                .map((e) => e.summary.slice(prefix.length).trim());
+        };
+        const lines = [];
+        lines.push(`# ${oneLine(p.title)}`, "", `> ${oneLine(p.objective)}`);
+        if (p.deliverables.length)
+            lines.push(`> 交付物：${p.deliverables.map(oneLine).join("；")}`);
+        if (p.acceptanceCriteria.length)
+            lines.push(`> 验收标准：${p.acceptanceCriteria.map(oneLine).join("；")}`);
+        lines.push("", "## 概览", "");
+        lines.push(`- 状态：${PROJECT_STATUS_TEXT[p.status] ?? p.status}`);
+        lines.push(`- 模式：${lightweight(p) ? "轻量" : "标准"}`);
+        lines.push(`- 风险：${SEVERITY_TEXT[p.risk] ?? p.risk}`);
+        lines.push(`- 创建时间：${moment(p.createdAt)}`);
+        lines.push(`- 最后更新时间：${moment(p.updatedAt)}`);
+        if (p.closedAt)
+            lines.push(`- 完成时间：${moment(p.closedAt)}`);
+        lines.push(`- 预算上限：${p.budget?.maxTokens ?? DEFAULT_MAX_TOKENS} Token`);
+        // THE USAGE IS REPORTED IN THE SAME BILLING-EQUIVALENT UNITS THE BUDGET IS SPENT IN, and the
+        // formula is printed next to the number: a budget nobody can predict is a budget nobody trusts.
+        lines.push(`- 已用等效 Token：${this.resources(p).tokens}（口径：输入 + 输出 + 缓存写入×${CACHE_WRITE_WEIGHT} + 缓存读取×${CACHE_READ_WEIGHT}，取整）`);
+        lines.push(`- 任务：共 ${p.tasks.length} 个，已完成 ${p.tasks.filter((t) => t.status === "completed").length} 个`);
+        lines.push("", "## 交付与验收", "");
+        if (!p.tasks.length)
+            lines.push("无");
+        p.tasks.forEach((t, index) => {
+            lines.push(`### ${index + 1}. ${oneLine(t.title)}`, "");
+            lines.push(`- 角色：${role(t)}`);
+            lines.push(`- 状态：${TASK_STATUS_TEXT[t.status] ?? t.status}`);
+            lines.push(`- 负责人：${t.ownerConversationId ? session(t.ownerConversationId) : "未派发"}`);
+            lines.push(`- 复核者：${t.reviewerConversationId ? session(t.reviewerConversationId) : "无"}`);
+            lines.push(`- 交付内容：${t.output ? truncate(oneLine(t.output), 200) : "无"}`);
+            lines.push(`- 证据：${t.evidenceRefs?.length ? t.evidenceRefs.map(oneLine).join("、") : "无"}`);
+            lines.push(`- 验收结论：${acceptance(t)}`);
+            if (t.review?.evidenceRefs?.length)
+                lines.push(`- 复核证据：${t.review.evidenceRefs.map(oneLine).join("、")}`);
+            const notes = reworkNotes(t);
+            if (notes.length)
+                lines.push(`- 退回意见：${notes.join("；")}`);
+            lines.push("");
+        });
+        lines.push("## 例外与决定", "");
+        if (!p.escalations.length)
+            lines.push("无");
+        else {
+            lines.push("| 例外 | 严重程度 | 状态 | 决定 | 解决时间 |", "| --- | --- | --- | --- | --- |");
+            for (const e of p.escalations) {
+                lines.push(`| ${cell(e.reason)} | ${SEVERITY_TEXT[e.severity] ?? e.severity} | ${ESCALATION_STATUS_TEXT[e.status] ?? e.status} | ${cell(e.decision ?? "无")} | ${e.resolvedAt ? moment(e.resolvedAt) : "无"} |`);
+            }
+        }
+        lines.push("", "## 时间线", "");
+        const events = [...(p.events ?? [])].sort((a, b) => Date.parse(a.createdAt) - Date.parse(b.createdAt));
+        if (!events.length)
+            lines.push("无");
+        for (const e of events)
+            lines.push(`- ${moment(e.createdAt)} · ${EVENT_TEXT[e.kind] ?? e.kind} · ${oneLine(e.summary)} · ${session(e.actorConversationId)}`);
+        lines.push("", "## 最近汇报", "");
+        if (!p.reports.length)
+            lines.push("无");
+        for (const r of p.reports) {
+            lines.push(`- ${REPORT_KIND_TEXT[r.kind] ?? r.kind}：${oneLine(r.progress)} ｜ 偏差：${r.variance ? oneLine(r.variance) : "无"} ｜ 下一步：${r.nextStep ? oneLine(r.nextStep) : "无"} ｜ 风险：${r.risks?.length ? r.risks.map(oneLine).join("、") : "无"}`);
+        }
+        return `${lines.join("\n")}\n`;
+    }
     projectForSession(conversationId) {
         let c = this.store.conversation(conversationId);
         const seen = new Set();
@@ -1092,6 +1224,7 @@ export class ProjectService {
         this.member(p, actor);
         switch (body.action) {
             case "get": return p;
+            case "export": return this.exportReport(id, workspaceId);
             case "start": return this.start(id, workspaceId, actor);
             case "add_task": return this.addTask(id, body, workspaceId, actor);
             case "dispatch": return this.dispatchTask(id, text(body.taskId, "taskId"), workspaceId, actor);

package/dist/server/http-server.js

@@ -1551,6 +1551,15 @@ export function createHttpServer(options) {
                             json(200, { escalations: project.escalations });
                             return;
                         }
+                        // THE REPORT IS MARKDOWN, NOT JSON. It exists so a person can open the URL in a browser
+                        // and read the project, or paste it into a weekly note - a JSON body would need a reader
+                        // to have one, and the whole point is that the reader does not.
+                        if (subresource === "report") {
+                            const markdown = await service.exportReport(projectId, requestedWorkspaceId);
+                            response.writeHead(200, { "content-type": "text/markdown; charset=utf-8", "cache-control": "no-store" });
+                            response.end(markdown);
+                            return;
+                        }
                         json(404, { error: "未知的项目资源" });
                         return;
                     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evandu/super-pi",
-  "version": "0.1.161",
+  "version": "0.1.162",
   "description": "Web control plane and companion for Pi",
   "license": "MIT",
   "type": "module",
@@ -223,7 +223,8 @@
     "scripts/session-report-watchdog.test.mjs",
     "scripts/session-report-tool.test.mjs",
     "scripts/session-stop-subtree.test.mjs",
-    "scripts/awaiting-background-status.test.mjs"
+    "scripts/awaiting-background-status.test.mjs",
+    "scripts/project-lifecycle-e2e.test.mjs"
   ],
   "check:browser": [
     "scripts/interrupt-browser.test.mjs",