docs: product-level README, AGENTS.md split into code/reading parts, add CLAUDE.md, move task briefs to docs/tasks
- README.md is now the product/repo front door (architecture, repo map, local dev, test tiers, delivery flow, doc map). Engine positioning, VedAstro/Codex setup and the oracle/benchmark command reference move verbatim to docs/engine/README.md, docs/engine/vedastro-gateway.md and docs/benchmark/README.md. Capability badges realigned with the registry (91/78/8/0); tests/test_readme_badges.py was red on staging. - AGENTS.md: Part A (environment truth, delivery, worktrees, record placement, bug workflow, growth freeze, frontend red lines, privacy, pre-work check, test tiers) and Part B (reading-rigor constraints). GitHub issue-tracker/triage boilerplate removed: GitHub is a read-only mirror. All strings locked by tests/ are preserved. - CLAUDE.md added: roles, three working modes, task-brief sections, acceptance criteria, session discipline; imports AGENTS.md. - 50 tracked TASK-*/PROGRESS-* files and 3 never-committed briefs move to docs/tasks/ with an index; REPO_LAYOUT.md merged into README. Docs-only change (no gated path touched). Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0193vBv6w5MV2cifdTUu9H5P
This commit is contained in:
Jesse_Chen
co-authored by
Claude Fable 5.1
Claude Fable 5.1
parent
af411f590a
commit
8db71aaf81
@@ -0,0 +1,103 @@
|
||||
# PROGRESS · 拆分首页巨石组件·第一批（2026-09-01）
|
||||
|
||||
工作树：`.worktrees/home-split-20260901`
|
||||
分支：`codex/home-split-20260901`（跟踪 `origin/staging`）
|
||||
基线：`origin/staging` @ `85589005`（任务书提交；产品代码与 P2a `ce6a8a7e` 相同）
|
||||
|
||||
不要写成 `PROGRESS.md`。本轮未提交、未推送。
|
||||
|
||||
## 度量
|
||||
|
||||
| 项 | 拆前 `85589005` | 拆后 | 说明 |
|
||||
| --- | ---: | ---: | --- |
|
||||
| `frontend/src/app/page.tsx` 行数 | 4766 | 3505 | 目标 ≤3000，未达标 |
|
||||
| `useState(` | 26 | 26 | 见下方 overlay 说明 |
|
||||
| `useEffect(` | 20 | 20 | 拉取/重试 effect 仍在 Home |
|
||||
| `/` 路由 | `○ Static` | `○ Static` | webpack `next build` |
|
||||
| 首屏 JS gzip -9 | 500262 B = 488.5 KB | 501315 B = 489.6 KB | +1053 B / **+0.21%**（±2% 内） |
|
||||
| 前端测试 | 2427 | 2427 | fail=0 skipped=0（见验证） |
|
||||
|
||||
未达标原因：聊天主链路（composer / transcript / `send` / 停止与恢复 / 引导对话）按任务书本批不动。抽走的是 helpers + 星盘库/合盘面板 + starter/每日星语。剩余约 505 行要等第二批。
|
||||
|
||||
`useState` 未下降：`otherProfileDraft` / `editingChartId` / `otherChartRelationship` / `editingSelfChart` 仍留在 `Home`。`AccountDialogOverlay` 在关闭时 `return null`，把独占 state 下移进面板会在关弹窗时丢掉未保存草稿，属于行为变化，本轮禁止。handlers（`saveOtherChart` 等）已随 JSX 进面板，state 经显式 props 传入。
|
||||
|
||||
## 任务 0 · 孤儿契约测试
|
||||
|
||||
`tests/test_supabase_user_data_contract.py` 对齐现状源码（性质保留：浏览器不直写 `profiles` / `chat_sessions`，账户 PATCH 仍拒数组，合盘仍走 `postPython("/api/chart")`）。任务书写的三处之外，同一文件里还有过期 token，一并换成现码并在上方注释原值：
|
||||
|
||||
- 首页不再 `.from("profiles")` / `.from("chat_sessions")`，锁 `fetch("/api/account"` / `fetch("/api/sessions"`
|
||||
- 账户 PATCH：`accountProfilePatchSchema.safeParse` + `z.object({`（`account-profile-patch.ts`）
|
||||
- 文案「添加其他人的星盘」
|
||||
- 合盘：`postPython("/api/chart", selfPayload)` / `partnerPayload`
|
||||
- 用户消息：`messages: questionAlreadyPresent ? preservedMessages : [...preservedMessages, { role: "user", text: question }]`
|
||||
- 中断路径：源码已无 `await persistSession(interruptedSession)`；停止文案「正在停止回答并申请退回本次点数…」
|
||||
|
||||
搬家后该文件改读 `_home_surface()`（`page.tsx` + 抽出文件拼接），正则/token 未改。
|
||||
|
||||
`scripts/run_quality_gate.py` 的 `CORE_PYTEST_TARGETS` 已列入此文件，注释写明前端搬家轮必须带着它跑。
|
||||
|
||||
`pytest tests/test_supabase_user_data_contract.py tests/test_daily_and_rectification_entrypoints.py -q` → 12 passed。
|
||||
|
||||
## 任务 1–3 · 搬家
|
||||
|
||||
新文件（实现从 `page.tsx` 原样搬出，加 `export`）：
|
||||
|
||||
| 文件 | 行 | 内容 |
|
||||
| --- | ---: | --- |
|
||||
| `frontend/src/lib/home-types.ts` | 254 | 类型、空资料、themes、storage 键常量 |
|
||||
| `frontend/src/lib/home-profile.ts` | 323 | 地点/资料/标签/`readProfile`/`upsertSelfChart` |
|
||||
| `frontend/src/lib/home-cloud-sync.ts` | 499 | 云端 fetch、登录跳转、每日星语读写 |
|
||||
| `frontend/src/components/birth-location-fields.tsx` | 40 | `BirthLocationFields` |
|
||||
| `frontend/src/components/profile-fields.tsx` | 38 | `ProfileFields` |
|
||||
| `frontend/src/components/onboarding-chat-message.tsx` | 28 | `OnboardingChatMessage` |
|
||||
| `frontend/src/components/chart-library-panel.tsx` | 269 | 星盘库 + 合盘卡/历史/他人表单 |
|
||||
| `frontend/src/components/starter-home.tsx` | 159 | starter hero / 每日星语 / 生时入口 / 主题卡 |
|
||||
|
||||
`page.tsx` 仍 `"use client"`、`import "@/app/site-styles"`、`const BirthTimeRectification = dynamic(...)`。新组件未 import 全局样式。无 context/store、无手写 `useCallback`/`useMemo`、未重开 React Compiler。
|
||||
|
||||
本人星盘表单仍 `onSubmit={saveProfile}`（面板 prop 名就是 `saveProfile`）。starter 回调 prop 保持原标识符：`startDailyStarlanguageConsultation`、`openRectificationFromHomepage`、`startSuggestedConsultation`。
|
||||
|
||||
## 合同测试路径（同一 token，只换读取面）
|
||||
|
||||
共用拼接件 `frontend/tests/home-surface.ts`：`page.tsx` + 上表抽出文件。Python 侧 `_home_surface()` / 显式 concat 同理。
|
||||
|
||||
| 测试 | 原路径 | 新路径 |
|
||||
| --- | --- | --- |
|
||||
| `birth-place-picker.test.ts` | `src/app/page.tsx` | `homeSurface`（`BirthPlacePicker` 在 `birth-location-fields.tsx`） |
|
||||
| `birth-time-consultation-consent.test.ts` | `page.tsx` | `homeSurface`（`readProfile` 在 `home-profile.ts`） |
|
||||
| `character-remaining-contract.test.ts` | `page.tsx` | `homeSurface`（姓名字数 `aria-describedby` 在 `profile-fields.tsx`） |
|
||||
| `chart-library-other-profile.test.ts` | `page.tsx` | `homeSurface` |
|
||||
| `chat-navigation-a11y-contract.test.ts` | `page.tsx` | `homeSurface` |
|
||||
| `chat-session-authority.test.ts` | `page.tsx` | `homeSurface` |
|
||||
| `chat-session-url.test.ts` | `page.tsx` | `homeSurface` |
|
||||
| `chat-session-write.test.ts` | `page.tsx` | `homeSurface`（`fetch("/api/sessions"` 在 `home-cloud-sync.ts`） |
|
||||
| `composer-isolation-contract.test.ts` | `page.tsx` | `homeSurface`（`pendingConsultationStorageKey` 在 `home-types.ts`） |
|
||||
| `consultation-entrypoint.test.ts` | `page.tsx` | `homeSurface`（starter 卡在 `starter-home.tsx`） |
|
||||
| `consultation-recovery.test.ts` | `page.tsx` | `homeSurface` |
|
||||
| `daily-starlanguage.test.ts` | `page.tsx` | `homeSurface` |
|
||||
| `membership-page.test.ts`（home 段） | `page.tsx` | `homeSurface`（`LoginRedirectError` 在 `home-cloud-sync.ts`） |
|
||||
| `onboarding-presentation.test.ts` | `page.tsx` | `homeSurface` |
|
||||
| `rectification-agentic-entry.test.ts` | `page.tsx` | `homeSurface` |
|
||||
| `settings-mvp-contract.test.ts` `renderProfile` | `page.tsx` 切片 | `homeSurface`（切片标记仍在 `page.tsx`） |
|
||||
| `settings-mvp-contract.test.ts` 星盘库表单 | `page.tsx` 的 `renderChartLibrary`→`renderGeneral` 切片 | `chart-library-panel.tsx`（切片里只剩 `<ChartLibraryPanel />`，token 已搬走） |
|
||||
| `starter-questions.test.ts` | `page.tsx` | `homeSurface` |
|
||||
| `tests/test_supabase_user_data_contract.py` | `PAGE.read_text()` | `_home_surface()` |
|
||||
| `tests/test_daily_and_rectification_entrypoints.py` | `PAGE` | `PAGE` + `starter-home.tsx` + `home-cloud-sync.ts` |
|
||||
| `tests/test_birth_time_journey_contract.py` 网页引导条 | `page.tsx` | `page.tsx` + `home-profile.ts`（`reported_birth_time` / `active_birth_time`） |
|
||||
|
||||
未改断言语义。锁聊天主链路、且 token 仍在 `page.tsx` 的测试继续只读 `page.tsx`（如 `site-style-isolation-contract`、composer/sidebar 壳、`rectification-lazy-loading`）。
|
||||
|
||||
## 验证
|
||||
|
||||
- `./node_modules/.bin/tsc --noEmit`：通过。
|
||||
- `npm test`：2427 条。并发下 2 条 Docker 库测 flake（`admin-database` / `model-configuration-security`，`database migration failed` / `Connection terminated unexpectedly`）。`--test-concurrency=1` 重跑这 8 条：pass 8 fail 0。与产品搬家无关。skipped=0。
|
||||
- `./node_modules/.bin/next build --webpack`：`┌ ○ /`。本树 `node_modules` 仍是指向 `session-url-20260901` 的符号链接，默认 Turbopack 会拒。gzip 口径：预渲染 `index.html` 引用的 `/_next/static/**.js` 去重后 `gzipSync` level 9。基线用同 SHA 干净 worktree 同口径对照。
|
||||
- 行为抽查：无登录态，未在浏览器点星盘库增删改、合盘、starter 入口、每日星语。由合同测试覆盖。
|
||||
|
||||
## 明确未做 / 未修
|
||||
|
||||
- 聊天主链路第二批再拆。
|
||||
- popstate 回默认会话未走 `selectSession`（任务书决策 4）。
|
||||
- `tests/test_session_management_entrypoints.py::test_archiving_never_calls_the_delete_endpoint` 仍锁已删除的 `setArchivedSessionIds`（P2a 遗留，不在 `CORE_PYTEST_TARGETS`，本轮不顺手修）。
|
||||
- `tests/test_birth_time_journey_contract.py::test_web_onboarding_uses_the_deterministic_free_journey` 在 mastra 断言 `'entry_mode: entryMode'` 上仍红（与搬家无关、不在 quick gate）；本轮只补了 `page.tsx` 侧 token 路径。
|
||||
- 未改 `.gitea/workflows/**`。未提升 `main`。
|
||||
Reference in New Issue
Block a user