spec(project): 定义 Project Workspace MVP

[hifizz]

背景

基于 codex/feat-agent-observability-evaluation 的 HEAD 48483101ad11bc84b611b615f423577633fedacb，先研究 ThreadChat 如何把现有 Project 从“分支对话容器”扩展为长期 AI 工作空间，再将已经冻结的 MVP 范围转换成可实施的 OpenSpec。

当前产品范围

Project
├── Contract
│   ├── Target
│   └── Instructions
├── Files
├── Artifacts
└── Threads / Messages

本次 MVP 的目标是：

• 用户可以设置 Project Target 和 Instructions；
• Contract 由服务端注入同一 Project 的所有未来生成；
• 用户可以在 Project 级区域上传和管理原始 Files；
• Ready 的 Project Files 在统一预算和权限边界内服务于所有 Thread；
• 用户可以查看整个 Project 中所有持久化 Artifacts，并定位其来源 Thread/Message；
• 列视图与画布共用统一 Project Panel。

OpenSpec Change

Change：add-project-workspace-mvp

路径：openspec/changes/add-project-workspace-mvp/

包含：

• proposal.md：为什么现在做最小 Project Workspace、会改变什么、影响哪些模块；
• design.md：Contract、Project File membership、模型上下文、Project Artifact library、统一 Project Panel、权限与迁移决策；
• specs/project-workspace/spec.md：Project Workspace 的规范性 Requirements 与验收 Scenarios；
• tasks.md：从数据库、Commands/API、上下文装配、UI 到测试与上线校验的实施清单；
• .openspec.yaml：使用仓库默认 spec-driven schema。

关键设计决策

1. Contract 先保存当前 Target/Instructions，不建设历史 Revision；使用 contractVersion 防止旧页面静默覆盖新设置。
2. Contract 是 Project 当前配置，只影响更新后启动的 Generation；不改写历史 Message、Artifact 或冻结 Fork Context。
3. Project File 复用现有 Attachment/R2/解析链路，通过成员关系归属 Project；Agent 不原地改写原始 File。
4. Ready Project Files 默认可供同一 Project 的所有 Thread 使用，但显式 Message Attachments 优先，所有内容受统一预算、检索与截断策略约束。
5. Project Artifacts 区域展示全 Project 的既有 Artifact 和来源，但不会自动把其他 Thread 的 Artifact 注入当前模型上下文。
6. Project Panel 统一承载 Overview、Files、Artifacts，并复用现有 Artifact renderer 和来源定位。
7. Archived Project 的 Workspace 只读；所有查询和上下文装配严格按 owner + project 隔离。

明确不在本次 MVP

• @Artifact、@Message、@Thread；
• Pinned Memory、自动 Memory；
• Outcome 专用工具、实体、发布状态或 Approval Card；
• Artifact Revision、Diff、Fork、Revert；
• File Version、替换或在线编辑；
• Operations Ledger、Activity Feed；
• depends_on、依赖图、Convergence / 汇总对象；
• 完整 Event Sourcing；
• Word、Excel、PPT、代码等新格式解析能力。

以上能力必须在 MVP 使用数据证明必要后，分别建立新的 Research/OpenSpec change。

Research 文档

• docs/project/01-project-workspace-research.md：总体问题空间；
• docs/project/02-dependent-thread-handoff-research.md：较复杂依赖方案的探索记录；
• docs/project/03-reference-and-outcome-preliminary-research.md：Reference + Outcome 收敛过程；
• docs/project/04-project-mvp-scope-and-roadmap.md：当前冻结范围和开发节奏，产品决策以此为准。

验证

• OpenSpec change 的 proposal、design、delta spec、tasks 与 schema metadata 均已生成；
• GitHub Actions OpenSpec 已执行 validate --all --strict 并通过；
• 当前 PR 仍只包含 Research/OpenSpec 规划文档，不包含数据库、API、UI 或业务代码实现；
• 实现阶段需要另行启动 OpenSpec apply workflow。

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
thread-chatbot	Error		Aug 30, 2026 10:36pm

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 27d4f68f-1ba6-4213-9441-f8aaa3f1adcc

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

_{Comment @coderabbitai help to get the list of available commands.}