@evandu/super-pi 0.1.161 → 0.1.163

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-CLV7t20O.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-Wtlj0s4R.css">
   </head>
   <body>
     <div id="root"></div>

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

@@ -1,5 +1,5 @@
 import type { Store } from "../store.js";
-import type { Project, ProjectEscalation, ProjectMode, ProjectReport, ProjectRisk, ProjectTask, SessionProfile } from "../types.js";
+import type { Project, ProjectEscalation, ProjectMode, ProjectReport, ProjectRisk, ProjectSummary, ProjectTask, SessionProfile } from "../types.js";
 import type { SessionOrchestratorService } from "./session-orchestrator-service.js";
 export declare const profile: (value: unknown, label: string) => SessionProfile | undefined;
 export declare const mergeProfile: (taskProfile?: SessionProfile, projectDefault?: SessionProfile) => SessionProfile | undefined;
@@ -95,7 +95,25 @@ export declare class ProjectService {
     private reconcile;
     private resources;
     list(workspaceId?: string): Project[];
+    headline(p: Project): string;
+    private isActorRelated;
+    private projectSummary;
+    listForActor(workspaceId: string, actor: string): ProjectSummary[];
     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.
  *
@@ -302,6 +331,16 @@ export class ProjectService {
                 }
         }
         const coordinatorIds = new Set([p.ownerConversationId, ...p.tasks.filter((t) => t.role === "leader").map((t) => t.ownerConversationId)].filter(Boolean));
+        /* THE MEMORY TREE OF THE PROJECT, AND OF EVERY SESSION IN IT.
+         *
+         * Since 0.1.161 a project opens its OWN memory tree: the leader session is the root of it and
+         * the workers inherit it, so the project's memories never mix with the Boss's chat. That is
+         * invisible from the outside - the client draws a tree of sessions and cannot tell which
+         * memories are behind it. So the server says it outright: the tree each session belongs to,
+         * and whether that tree is the project's own ("project") or the one it shares with the
+         * initiator's conversation ("shared"). The leader is the root of the project's tree, so it is
+         * "project" by the same rule as everybody else - there is no special case for it. */
+        const projectTreeId = p.ownerConversationId ? this.store.conversation(p.ownerConversationId)?.treeId : undefined;
         const sessions = state.conversations.filter((c) => c.workspaceId === p.workspaceId && members.has(c.id)).map((c) => ({
             id: c.id, title: c.title, status: c.status, tokens: tokens(c.usage), contextPercent: c.contextUsage?.percent,
             // THE TREE SKELETON. The client draws the agents of a project as a tree, and the only
@@ -309,6 +348,10 @@ export class ProjectService {
             // verbatim (including the undefined case, which means "this session has no parent in
             // this collection" - i.e. it is a root of the tree).
             parentConversationId: c.parentConversationId,
+            // WHOSE MEMORY THIS SESSION WORKS FROM. The project's own tree is the one the leader
+            // opened; anything else is a session that still shares the initiator's chat memory.
+            memoryTreeId: c.treeId,
+            memoryScope: projectTreeId && c.treeId === projectTreeId ? "project" : "shared",
             role: c.id === p.ownerConversationId ? "项目负责人" : coordinatorIds.has(c.id) ? "分支 Leader" : p.tasks.some((t) => t.reviewerConversationId === c.id) ? "独立复核" : "执行者",
         }));
         const runs = state.subagentRuns.filter((r) => members.has(r.conversationId));
@@ -319,15 +362,198 @@ export class ProjectService {
         const leaderIsWorker = lightweight(p) && p.ownerConversationId !== undefined;
         return { tokens: sessions.reduce((sum, s) => sum + s.tokens, 0) + runs.reduce((sum, r) => sum + tokens(r.usage), 0),
             usageKnown: sessions.length > 0 && sessions.every((s) => Boolean(this.store.conversation(s.id)?.usage)) && runs.every((r) => Boolean(r.usage)),
-            activeWorkers: sessions.filter((s) => (!coordinatorIds.has(s.id) || (leaderIsWorker && s.id === p.ownerConversationId)) && busy(s.status)).length + runs.filter((r) => r.status === "running").length, sessions };
+            activeWorkers: sessions.filter((s) => (!coordinatorIds.has(s.id) || (leaderIsWorker && s.id === p.ownerConversationId)) && busy(s.status)).length + runs.filter((r) => r.status === "running").length,
+            // THE PROJECT'S OWN MEMORY TREE, named once so the client does not have to infer it from
+            // the sessions. Absent only when the project has no leader session yet.
+            memoryTreeId: projectTreeId, sessions };
     }
     list(workspaceId) {
         const scope = this.workspace(workspaceId);
         return this.store.projects().filter((p) => p.workspaceId === scope).map((p) => this.projectView(p));
     }
+    headline(p) {
+        const total = p.tasks.length;
+        const completed = p.tasks.filter((t) => t.status === "completed").length;
+        if (p.status === "completed") {
+            return total > 0 ? `项目已完成（${completed}/${total} 任务已验收）` : "项目已完成";
+        }
+        if (p.status === "cancelled")
+            return "项目已取消";
+        if (p.status === "failed")
+            return "项目失败";
+        const openEscalation = (p.escalations ?? []).find((e) => e.status === "open");
+        if (openEscalation) {
+            return p.status === "awaiting_approval"
+                ? `等待审批：${openEscalation.reason}`
+                : `项目已阻塞：${openEscalation.reason}`;
+        }
+        const blockedTask = p.tasks.find((t) => t.status === "blocked");
+        if (blockedTask) {
+            const reason = blockedTask.blockedReason ? `（${blockedTask.blockedReason}）` : "";
+            return `项目已阻塞：${blockedTask.title}${reason}`;
+        }
+        const inProgressTask = p.tasks.find((t) => t.status === "in_progress");
+        if (inProgressTask) {
+            return `${completed}/${total} 任务完成，正在执行${inProgressTask.title}`;
+        }
+        const reviewTask = p.tasks.find((t) => t.status === "awaiting_review");
+        if (reviewTask) {
+            return `${completed}/${total} 任务完成，正在复核${reviewTask.title}`;
+        }
+        const readyTask = p.tasks.find((t) => t.status === "ready");
+        if (readyTask) {
+            return `${completed}/${total} 任务完成，待派发${readyTask.title}`;
+        }
+        if (total > 0) {
+            return `${completed}/${total} 任务完成，等待前置依赖`;
+        }
+        return "项目规划中，尚未拆解任务";
+    }
+    isActorRelated(p, actor) {
+        if (!actor)
+            return false;
+        if (actor === p.initiatorConversationId)
+            return true;
+        if (actor === p.ownerConversationId)
+            return true;
+        if (p.tasks?.some((t) => t.ownerConversationId === actor || t.reviewerConversationId === actor))
+            return true;
+        if (this.projectForSession(actor)?.id === p.id)
+            return true;
+        return false;
+    }
+    projectSummary(p) {
+        const resources = this.resources(p);
+        return {
+            id: p.id,
+            name: p.title,
+            status: p.status,
+            mode: p.mode ?? "standard",
+            headline: this.headline(p),
+            tasks: {
+                total: p.tasks.length,
+                completed: p.tasks.filter((t) => t.status === "completed").length,
+                inProgress: p.tasks.filter((t) => t.status === "in_progress").length,
+                blocked: p.tasks.filter((t) => t.status === "blocked").length,
+            },
+            activeWorkers: resources.activeWorkers,
+            tokens: resources.tokens,
+            updatedAt: p.updatedAt,
+        };
+    }
+    listForActor(workspaceId, actor) {
+        const scope = this.workspace(workspaceId);
+        return this.store.projects()
+            .filter((p) => p.workspaceId === scope && this.isActorRelated(p, actor))
+            .sort((a, b) => b.updatedAt.localeCompare(a.updatedAt))
+            .map((p) => this.projectSummary(p));
+    }
     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();
@@ -1087,11 +1313,15 @@ export class ProjectService {
             await this.registerTopLevelTasks(project.id, plan, workspaceId, actor);
             return this.get(project.id, workspaceId);
         }
+        if (body.action === "list") {
+            return this.listForActor(workspaceId, actor);
+        }
         const id = text(body.projectId, "projectId");
         const p = this.get(id, workspaceId);
         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/dist/server/types.d.ts

@@ -1033,10 +1033,25 @@ export type Project = {
      * and any orphan left behind by an older layout). Without it the panel can only show a row
      * per session, and the hierarchy - who reported to whom - stays invisible.
      */
+    /**
+     * The project's live sessions, with the tree skeleton and the memory scope attached.
+     *
+     * `parentConversationId` is what lets the client draw a TREE rather than a flat list: a
+     * session whose parent is not in this collection is a ROOT of the tree (the project leader,
+     * and any orphan left behind by an older layout). Without it the panel can only show a row
+     * per session, and the hierarchy - who reported to whom - stays invisible.
+     *
+     * `memoryScope` says whose memory a session works from: "project" for the sessions that live
+     * in the PROJECT'S OWN memory tree (the leader, and every worker that inherited it), "shared"
+     * for a session that still reads the initiator's chat memory. The panel shows it as a small
+     * mark on every agent, because a reader who cannot tell the two apart cannot tell what a
+     * session remembers.
+     */
     resources?: {
         tokens: number;
         usageKnown: boolean;
         activeWorkers: number;
+        memoryTreeId?: string;
         sessions: {
             id: string;
             title: string;
@@ -1045,6 +1060,8 @@ export type Project = {
             tokens: number;
             contextPercent?: number | null;
             parentConversationId?: string;
+            memoryTreeId?: string;
+            memoryScope?: "project" | "shared";
         }[];
     };
     /**
@@ -1063,6 +1080,22 @@ export type Project = {
     updatedAt: string;
     closedAt?: string;
 };
+export type ProjectSummary = {
+    id: string;
+    name: string;
+    status: string;
+    mode: "standard" | "lightweight";
+    headline: string;
+    tasks: {
+        total: number;
+        completed: number;
+        inProgress: number;
+        blocked: number;
+    };
+    activeWorkers: number;
+    tokens: number;
+    updatedAt: string;
+};
 export type AppState = {
     modelFilterRules?: ModelFilterRule[];
     defaultModel?: ModelSelection;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evandu/super-pi",
-  "version": "0.1.161",
+  "version": "0.1.163",
   "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",