3.9 KiB
3.9 KiB
| phase | slug | status | nyquist_compliant | wave_0_complete | created |
|---|---|---|---|---|---|
| 1 | current-engine-boundaries | draft | false | false | 2026-05-21 |
Phase 1 — Validation Strategy
Per-phase validation contract for feedback sampling during execution.
Test Infrastructure
| Property | Value |
|---|---|
| Framework | shell assertions + Xcode build smoke |
| Config file | none — current repo has no dedicated XCTest target for this phase |
| Quick run command | test -f .planning/phases/01-current-engine-boundaries/01-reflowable-audit.md |
| Full suite command | xcodebuild -workspace ReadViewDemo/ReadViewDemo.xcworkspace -scheme ReadViewDemo -destination 'platform=iOS Simulator,name=iPhone 15' build |
| Estimated runtime | ~60 seconds |
Sampling Rate
- After every task commit: Run
test -f .planning/phases/01-current-engine-boundaries/01-reflowable-audit.mdor the matching strategy-doc existence/source assertions for the touched artifact. - After every plan wave: Run
xcodebuild -workspace ReadViewDemo/ReadViewDemo.xcworkspace -scheme ReadViewDemo -destination 'platform=iOS Simulator,name=iPhone 15' build. - Before
$gsd-verify-work: Build smoke must be green and both phase documents must exist. - Max feedback latency: 60 seconds
Per-Task Verification Map
| Task ID | Plan | Wave | Requirement | Threat Ref | Secure Behavior | Test Type | Automated Command | File Exists | Status |
|---|---|---|---|---|---|---|---|---|---|
| 01-01-01 | 01 | 1 | COMP-02 | — | 审计文档准确区分 .textReflowable 与 WKWebView 路径 |
source | `rg -n "textReflowable | webFixedLayout | webInteractive |
| 01-01-02 | 01 | 1 | COMP-02 | — | 审计文档列出真实调用链与关键源码入口 | source | `rg -n "RDURLReaderController | RDEPUBReaderController | RDEPUBTextBookBuilder |
| 01-02-01 | 02 | 2 | COMP-02 | — | 策略文档明确固定版式/交互式 EPUB 继续走 WKWebView |
source | `rg -n "WKWebView | webFixedLayout | webInteractive" .planning/phases/01-current-engine-boundaries/01-refactor-entry-strategy.md` |
| 01-02-02 | 02 | 2 | COMP-02 | — | 策略文档明确 RDReaderView 不修改且采用旧引擎直接演进 |
source | `rg -n "RDReaderView | 直接重构 | 不修改" .planning/phases/01-current-engine-boundaries/01-refactor-entry-strategy.md` |
Status: ⬜ pending · ✅ green · ❌ red · ⚠️ flaky
Wave 0 Requirements
- No new test target required for Phase 1 documentation work.
- Executor must confirm
ReadViewDemo/ReadViewDemo.xcworkspaceandReadViewDemoscheme still open/build before closing the phase.
Manual-Only Verifications
| Behavior | Requirement | Why Manual | Test Instructions |
|---|---|---|---|
| Audit conclusions match the actual repo structure | COMP-02 | 需要阅读源码与文档交叉确认，纯自动化难以判断“结论是否误导” | 打开 01-reflowable-audit.md，逐项对照源码路径和 reading-profile 分流逻辑。 |
| Refactor entry strategy is actionable for Phase 2/3 | COMP-02 | 需要判断切入顺序是否真的减少风险 | 阅读 01-refactor-entry-strategy.md，确认触点、保留边界、后续 phase 依赖关系清晰。 |
Validation Sign-Off
- All tasks have
<automated>verify or Wave 0 dependencies - Sampling continuity: no 3 consecutive tasks without automated verify
- Wave 0 covers all MISSING references
- No watch-mode flags
- Feedback latency < 60s
nyquist_compliant: trueset in frontmatter
Approval: pending