spec(project): 定义 Project Workspace MVP

.env.example

@@ -44,6 +44,11 @@ UMAPIS_BASE_URL=https://www.umapis.com/v1
 UMAPIS_API_KEY_CLAUDE=
 UMAPIS_API_KEY_GPT=
 
+# === 私有模型中继（独立固定路由；服务端专用） ===
+# 可填写服务根地址或 /v1 API 根地址；应用会统一规范为 /v1。
+PRIVATE_RELAY_BASE_URL=https://model-relay.internal/v1
+PRIVATE_RELAY_API_KEY=
+
 # === 火山方舟 Coding Plan（OpenAI-compatible） ===
 # 必须使用 Coding Plan 专用的 /api/coding/v3；普通 /api/v3 会产生套餐外费用。
 ARK_CODING_API_KEY=

.github/workflows/project-workspace-ci.yml

@@ -0,0 +1,135 @@
+name: Project Workspace CI
+
+on:
+  push:
+    branches:
+      - codex/research-project-workspace-design
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    services:
+      postgres:
+        image: pgvector/pgvector:pg17
+        env:
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
+          POSTGRES_DB: postgres
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd "pg_isready -U postgres -d postgres"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+    env:
+      DATABASE_URL: postgres://postgres:postgres@localhost:5432/postgres
+      DIRECT_URL: postgres://postgres:postgres@localhost:5432/postgres
+      BETTER_AUTH_SECRET: project-workspace-ci-secret-at-least-32-characters
+      MINIMAX_API_KEY: project-workspace-build-placeholder
+      MINIMAX_BASE_URL: https://example.invalid/v1
+      LLM_MODEL_ID: project-workspace-build-model
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Typecheck
+        run: pnpm typecheck
+
+      - name: Targeted ESLint
+        run: >-
+          pnpm exec eslint
+          app/thread-chat/chat/chat-view.tsx
+          app/thread-chat/core/projections.ts
+          app/thread-chat/core/store.ts
+          app/thread-chat/core/types.ts
+          app/thread-chat/gate-3-harness/mock-v1-runtime.ts
+          app/thread-chat/net/client.ts
+          app/thread-chat/net/commands/conversation-commands.ts
+          app/thread-chat/net/project-file-upload.ts
+          app/thread-chat/orchestration/artifacts/artifact-drawer.tsx
+          app/thread-chat/orchestration/artifacts/project-panel.tsx
+          app/thread-chat/orchestration/artifacts/store-bound-project-panel.tsx
+          app/thread-chat/orchestration/navigation/thread-chat-topbar.tsx
+          app/thread-chat/thread-chat-demo.tsx
+          constants/project-workspace.ts
+          evals/agent/executors/production-harness.ts
+          evals/agent/schema.ts
+          lib/chat/attachment-content-resolver.ts
+          lib/chat/attachment-context-policy.ts
+          lib/chat/project-contract.ts
+          lib/chat/resolve-attachments.ts
+          lib/db/schema.ts
+          lib/thread-chat/application/compile-model-context.ts
+          lib/thread-chat/application/project-mutations.ts
+          lib/thread-chat/application/queries.ts
+          lib/thread-chat/contracts/commands.ts
+          lib/thread-chat/contracts/dto.ts
+          lib/thread-chat/persistence/artifact-repository.ts
+          lib/thread-chat/persistence/mappers.ts
+          lib/thread-chat/persistence/project-file-repository.ts
+          lib/thread-chat/server/handlers.ts
+          lib/thread-chat/streaming/finalize.ts
+          lib/thread-chat/streaming/generation-plan.ts
+          lib/thread-chat/streaming/run-generation.ts
+
+      - name: Verify generated migration is in sync
+        run: pnpm db:generate && git diff --exit-code -- drizzle
+
+      - name: Legacy data migration compatibility
+        run: node --import tsx e2e/thread-chat/project-workspace-migration-compatibility.test.mjs
+
+      - name: Pure project context policies
+        run: node --import tsx e2e/thread-chat/project-workspace-context.test.mjs
+
+      - name: Project panel UI contract
+        run: node e2e/thread-chat/project-panel-ui-contract.test.mjs
+
+      - name: Project panel workspace isolation
+        run: node --import tsx e2e/thread-chat/project-panel-workspace-state.test.mjs
+
+      - name: Project workspace eval harness
+        run: node --import tsx e2e/observability/project-workspace-eval-harness.test.mjs
+
+      - name: Prepare normalized test database
+        run: pnpm db:test:reset && pnpm db:test:migrate
+
+      - name: Project workspace schema and repository acceptance
+        run: node --import tsx e2e/thread-chat/project-workspace-db.test.mjs
+
+      - name: Project workspace API integration
+        run: node --import tsx e2e/thread-chat/project-workspace-api-db.test.mjs
+
+      - name: Project contract generation boundary
+        run: node --import tsx e2e/thread-chat/project-contract-generation-boundary.test.mjs
+
+      - name: Project workspace history stability
+        run: node --import tsx e2e/thread-chat/project-workspace-history-stability.test.mjs
+
+      - name: Project artifact context isolation
+        run: node --import tsx e2e/thread-chat/project-artifact-context-isolation.test.mjs
+
+      - name: Agent eval smoke
+        run: pnpm eval:agent
+
+      - name: Agent eval CI
+        run: pnpm eval:agent:ci
+
+      - name: Production build
+        run: pnpm build
+
+      - name: Validate OpenSpec
+        run: pnpm openspec:validate

app/api/thread-chat/v1/projects/[projectId]/files/[attachmentId]/route.ts

@@ -0,0 +1,11 @@
+import type { RouteContext } from "@/lib/thread-chat/server/route-utils"
+import { handleRemoveProjectFile } from "@/lib/thread-chat/server/handlers"
+
+export const dynamic = "force-dynamic"
+
+type Context = RouteContext<{ projectId: string; attachmentId: string }>
+
+export async function DELETE(request: Request, context: Context) {
+  const { projectId, attachmentId } = await context.params
+  return handleRemoveProjectFile(request, projectId, attachmentId)
+}

app/api/thread-chat/v1/projects/[projectId]/files/route.ts

@@ -0,0 +1,11 @@
+import type { RouteContext } from "@/lib/thread-chat/server/route-utils"
+import { handleAddProjectFile } from "@/lib/thread-chat/server/handlers"
+
+export const dynamic = "force-dynamic"
+
+type Context = RouteContext<{ projectId: string }>
+
+export async function POST(request: Request, context: Context) {
+  const { projectId } = await context.params
+  return handleAddProjectFile(request, projectId)
+}

app/thread-chat/attachment-composer-demo/page.tsx

@@ -0,0 +1,46 @@
+"use client"
+
+import { useCallback, useState } from "react"
+
+import { AttachmentComposerDemo } from "../chat/composer/attachment-composer-demo"
+import type { DemoAttachment } from "../chat/composer/attachment-composer-demo-model"
+
+export default function AttachmentComposerDemoPage() {
+  const [attachments, setAttachments] = useState<DemoAttachment[]>([])
+
+  const handleChange = useCallback((nextAttachments: DemoAttachment[]) => {
+    setAttachments(nextAttachments)
+    console.log("attachments changed", nextAttachments)
+  }, [])
+
+  return (
+    <main className="tc min-h-screen bg-background px-4 py-12 text-foreground sm:px-6">
+      <section className="mx-auto flex w-full max-w-2xl flex-col gap-6">
+        <header className="space-y-2">
+          <p className="text-sm font-medium text-muted-foreground">
+            ThreadChat · Frontend Demo
+          </p>
+          <h1 className="text-2xl font-semibold tracking-tight">
+            Attachment Composer
+          </h1>
+          <p className="max-w-xl text-sm leading-6 text-muted-foreground">
+            通过多选、拖拽或粘贴添加文件。粘贴的纯文本会转换为本地 .txt
+            文件；所有操作仅保留在当前浏览器页面，不会上传或发送消息。
+          </p>
+        </header>
+
+        <AttachmentComposerDemo
+          attachments={attachments}
+          onChange={handleChange}
+        />
+
+        <p
+          data-testid="attachment-count"
+          className="text-xs text-muted-foreground"
+        >
+          当前附件：{attachments.length}
+        </p>
+      </section>
+    </main>
+  )
+}