From 464034650c5cd19043eadcc68734d04bacd5f39d Mon Sep 17 00:00:00 2001 From: MT-Mint <798521692@qq.com> Date: Tue, 7 Apr 2026 14:32:25 +0800 Subject: [PATCH] docs(milestone): archive v1.0 roadmap requirements and state --- .planning/MILESTONES.md | 16 +++++ .planning/STATE.md | 10 +-- .planning/milestones/v1.0-REQUIREMENTS.md | 82 +++++++++++++++++++++++ .planning/milestones/v1.0-ROADMAP.md | 57 ++++++++++++++++ 4 files changed, 160 insertions(+), 5 deletions(-) create mode 100644 .planning/MILESTONES.md create mode 100644 .planning/milestones/v1.0-REQUIREMENTS.md create mode 100644 .planning/milestones/v1.0-ROADMAP.md diff --git a/.planning/MILESTONES.md b/.planning/MILESTONES.md new file mode 100644 index 00000000..b4b72e58 --- /dev/null +++ b/.planning/MILESTONES.md @@ -0,0 +1,16 @@ +# Milestones + +## v1.0 milestone (Shipped: 2026-04-07) + +**Phases completed:** 5 phases, 6 plans, 9 tasks + +**Key accomplishments:** + +- 交付了可复现冲突证据链、文件级风险清单与 Titan 重叠决策矩阵，形成“旧视觉+新逻辑”执行输入。 +- 线程路由从 isnew 参数切换为路由单路径语义，并将 skills bootstrap 合同统一到 content_ids。 +- 完成 03-UAT 的关键 gap 收敛：lint 阻塞清零，welcome-and-routing 从 4 失败收敛到 0 失败。 +- 基于 originui 合并基线完成 Phase 3 执行记录，并输出可审计的视觉与回归验证结果。 +- 完成 Phase 4 首轮执行：iframe 通信与导出链路加入前端容错，目标 lint/E2E 验证通过。 +- Phase 5 执行完成：目标 E2E 套件达到“0 失败、可解释 skip”，并形成提交卫生分组建议。 + +--- diff --git a/.planning/STATE.md b/.planning/STATE.md index 6528e693..4a9881f9 100644 --- a/.planning/STATE.md +++ b/.planning/STATE.md @@ -2,13 +2,13 @@ gsd_state_version: 1.0 milestone: v1.0 milestone_name: milestone -status: Ready to plan -last_updated: "2026-04-07T04:32:17.454Z" +status: v1.0 milestone complete +last_updated: "2026-04-07T06:26:30.389Z" progress: total_phases: 5 - completed_phases: 1 - total_plans: 1 - completed_plans: 1 + completed_phases: 5 + total_plans: 6 + completed_plans: 6 percent: 100 --- diff --git a/.planning/milestones/v1.0-REQUIREMENTS.md b/.planning/milestones/v1.0-REQUIREMENTS.md new file mode 100644 index 00000000..dc31ceb3 --- /dev/null +++ b/.planning/milestones/v1.0-REQUIREMENTS.md @@ -0,0 +1,82 @@ +# Requirements Archive: v1.0 milestone + +**Archived:** 2026-04-07 +**Status:** SHIPPED + +For current requirements, see `.planning/REQUIREMENTS.md`. + +--- + +# Requirements: DeerFlow Frontend Merge Recovery + +**Defined:** 2026-04-07 +**Core Value:** Keep the frontend visually familiar while preserving and hardening new-system behavior end to end. + +## v1 Requirements + +### Merge Reconciliation + +- [x] **MERGE-01**: Team can list all merge-overwritten hotspots with file-level evidence and risk classification +- [x] **MERGE-02**: Team can restore required new-system logic removed during merge while avoiding duplicate behavior paths +- [x] **MERGE-03**: Team can identify and reconcile Titan-overlap code paths with explicit keep/replace decisions + +### UI Visual Alignment + +- [ ] **UI-01**: Workspace visual style aligns with legacy baseline for typography, spacing, and component hierarchy +- [ ] **UI-02**: Visual alignment changes do not break chat/thread/artifact interactions +- [ ] **UI-03**: Global style changes remain consistent across main workspace pages + +### New-System Logic Integrity + +- [ ] **LOGIC-01**: iframe communication flow functions correctly for selected skill and parent message events +- [ ] **LOGIC-02**: Markdown download flow works from generation to export trigger in workspace +- [x] **LOGIC-03**: Thread creation/reuse logic remains correct for `thread_id`, `isnew`, and `xclaw_used` combinations +- [x] **LOGIC-04**: Skills bootstrap API contract is explicitly reconciled (`content_id` vs `content_ids`) without silent breakage + +### Quality and Regression Safety + +- [ ] **TEST-01**: E2E tests cover message/history, input/compose, welcome/routing, and artifact/thread reuse flows +- [ ] **TEST-02**: Recovery changes are committed in separable concern groups (style vs logic vs tests) +- [ ] **TEST-03**: Critical conflict files have before/after verification notes for reviewer auditing + +## v2 Requirements + +### Tooling Improvements + +- **TOOL-01**: Add automated conflict hotspot detector for future merges +- **TOOL-02**: Add style-vs-logic diff classifier script for commit preparation + +## Out of Scope + +| Feature | Reason | +|---------|--------| +| New product feature development unrelated to merge recovery | Would dilute stabilization focus | +| Backend architecture refactors not required by frontend recovery | Not necessary for current milestone objective | +| Full design system reimplementation | Too large for recovery scope | + +## Traceability + +| Requirement | Phase | Status | +|-------------|-------|--------| +| MERGE-01 | Phase 1 | Complete | +| MERGE-02 | Phase 1 | Complete | +| MERGE-03 | Phase 1 | Complete | +| LOGIC-03 | Phase 2 | Complete | +| LOGIC-04 | Phase 2 | Complete | +| UI-01 | Phase 3 | Pending | +| UI-02 | Phase 3 | Pending | +| UI-03 | Phase 3 | Pending | +| LOGIC-01 | Phase 4 | Pending | +| LOGIC-02 | Phase 4 | Pending | +| TEST-01 | Phase 5 | Pending | +| TEST-02 | Phase 5 | Pending | +| TEST-03 | Phase 5 | Pending | + +**Coverage:** +- v1 requirements: 13 total +- Mapped to phases: 13 +- Unmapped: 0 + +--- +*Requirements defined: 2026-04-07* +*Last updated: 2026-04-07 after initial definition* diff --git a/.planning/milestones/v1.0-ROADMAP.md b/.planning/milestones/v1.0-ROADMAP.md new file mode 100644 index 00000000..2c7a7558 --- /dev/null +++ b/.planning/milestones/v1.0-ROADMAP.md @@ -0,0 +1,57 @@ +# Roadmap: DeerFlow Frontend Merge Recovery + +**Created:** 2026-04-07 +**Source:** .planning/PROJECT.md + .planning/REQUIREMENTS.md + +## Phase 1: Conflict Inventory and Decision Matrix + +**Goal:** Build an auditable conflict inventory covering merge-overwritten regions, Titan-overlap regions, and keep/replace candidates. + +**Covers:** MERGE-01, MERGE-03 + +- Produce file-level conflict matrix with risk levels +- Mark visual-only, logic-only, and mixed-change files +- Identify Titan-linked hotspots and expected behavior per hotspot + +## Phase 2: Thread and Skills Logic Reconciliation + +**Goal:** Reconcile thread bootstrap/routing and skills API logic so merged behavior is explicit and stable. + +**Covers:** MERGE-02, LOGIC-03, LOGIC-04 + +- Reconcile `thread_id`/`isnew`/`xclaw_used` behavior in chat flow +- Decide and implement skills bootstrap contract direction +- Verify no duplicate or dead logic paths remain + +## Phase 3: Legacy Visual Alignment Pass + +**Goal:** Align workspace visual presentation to legacy baseline without regressing logic. + +**Covers:** UI-01, UI-02, UI-03 + +- Apply visual alignment in layout and component layers +- Keep behavioral code intact while adjusting style semantics +- Validate visual consistency across core workspace views + +## Phase 4: Iframe + Markdown New-System Stabilization + +**Goal:** Keep and harden new-system capabilities for iframe communication and markdown export. + +**Covers:** LOGIC-01, LOGIC-02 + +- Stabilize parent/child messaging and selected-skill event flows +- Stabilize markdown conversion and download triggers +- Validate artifact integration points + +## Phase 5: Test Hardening and Commit Hygiene + +**Goal:** Lock recovery with regression tests and clean commit structure. + +**Covers:** TEST-01, TEST-02, TEST-03 + +- Finalize and run E2E suite for target scenarios +- Split commits into style / logic / tests concern buckets +- Attach reviewer-oriented verification notes for high-risk files + +--- +*Next command:* `/gsd-plan-phase 1`