@xenonbyte/da-vinci-workflow 0.1.19 → 0.1.21

package/docs/zh-CN/pencil-rendering-workflow.md

@@ -65,6 +65,14 @@ Da Vinci 现在要求自治运行使用这组 session wrapper：
 
 Da Vinci 不会假设 live MCP 编辑已经被自动刷盘。
 
+## Continue 恢复规则
+
+从已有工件恢复时：
+
+- 选路先看当前工件和 checkpoint 真相
+- 只把 checkpoint 邻近的 `Context Delta` 当作辅助恢复信息
+- 如果 Context Delta 与当前工件或 checkpoint 真相冲突，忽略冲突条目并先记录冲突，再继续执行
+
 ## 持久化规则
 
 Da Vinci 不把 headless interactive `save()` 当作权威持久化真相。
@@ -229,6 +237,14 @@ da-vinci audit --mode completion --change <change-id> <project-path>
 
 这个审计现在还会检查 `.da-vinci/state/pencil-session.json`，要求它记录的 hash 与最新持久化 `.pen` 一致。
 
+Context Delta 相关审计期望都是告警级：
+
+- checkpoint 邻近工件缺少有效 Context Delta -> `WARN`
+- Context Delta 字段不完整 -> `WARN`
+- Context Delta 状态与当前 checkpoint 不一致 -> `WARN`
+- 这种不一致可能是 checkpoint 状态过期，也可能是 Context Delta 记录过期
+- 这些告警用于提升续跑质量，但不会单独形成 completion 阶段的硬阻断
+
 ## 推荐命令链
 
 典型自治流程：

package/docs/zh-CN/prompt-entrypoints.md

@@ -59,9 +59,16 @@
 
 - 当前工件状态判断
 - 缺失或薄弱工件
+- 可用时补充最近 checkpoint 的 Context Delta（仅在与当前工件一致时）
 - 一条主继续提示词
 - 必要时的保守继续版本
 
+继续规则优先级：
+
+- 先根据工件和 checkpoint 真相决定路由
+- Context Delta 只用于恢复和解释，不用于覆盖选路
+- 如果 Context Delta 与当前工件冲突，选路时忽略冲突内容并标记冲突
+
 ## 默认推荐流程
 
 推荐顺序：

package/docs/zh-CN/prompt-presets/README.md

@@ -116,5 +116,7 @@ $da-vinci use continue for this existing overhaul-from-code workflow.
 
 Use the existing Da Vinci artifacts.
 Detect whether the workflow should return to breakdown, continue with design, generate tasks, continue implementation, or verify drift.
+Determine routing from artifact and checkpoint truth first, then use contextual checkpoint deltas only as auxiliary recovery notes.
+If a contextual delta conflicts with current artifacts, ignore that delta and record the conflict before continuing.
 Prefer the artifact-backed next safe stage instead of restarting the overhaul from scratch.
 ```

package/docs/zh-CN/prompt-presets/desktop-app.md

@@ -75,6 +75,8 @@ $da-vinci use continue for this existing overhaul-from-code desktop workflow.
 
 Use the existing Da Vinci artifacts.
 Detect whether the workflow should return to breakdown, continue with design, generate tasks, continue implementation, or verify drift.
+Determine routing from artifact and checkpoint truth first, then use contextual checkpoint deltas only as auxiliary recovery notes.
+If a contextual delta conflicts with current artifacts, ignore that delta and record the conflict before continuing.
 Prefer the artifact-backed next safe stage instead of restarting the overhaul from scratch.
 ```
 
@@ -187,6 +189,7 @@ $da-vinci use continue for this existing desktop-product redesign workflow.
 
 Use the existing Da Vinci artifacts in this project.
 Do not restart discovery unless an artifact is missing or clearly wrong.
+选路先以当前工件和 checkpoint 真相为准，再把 Context Delta 作为辅助恢复信息；如果 Context Delta 与工件冲突，忽略冲突条目并记录冲突后继续。
 把登记的项目内 Pencil 源保持在 `.da-vinci/designs/` 下，作为设计真相源。如果继续这一轮会做 Pencil 编辑，必须先执行 `da-vinci pencil-session begin --project <project-path> --pen <path>`，发生实质性 live edit 后再执行 `da-vinci pencil-session persist --project <project-path> --pen <path> ...`；只有 session wrapper 不可用时，才退回 `write-pen + check-pen-sync` 这条底层链路。
 If the redesign is complex, continue from the approved anchor surfaces instead of restarting broad scaffolding.
 如果 Pencil MCP 可用，且这一轮继续做了新的 Pencil 写入，就重新运行 MCP runtime gate，并把最新结果记录到 `pencil-design.md`。

package/docs/zh-CN/prompt-presets/mobile-app.md

@@ -75,6 +75,8 @@ $da-vinci use continue for this existing overhaul-from-code mobile workflow.
 
 Use the existing Da Vinci artifacts.
 Detect whether the workflow should return to breakdown, continue with design, generate tasks, continue implementation, or verify drift.
+Determine routing from artifact and checkpoint truth first, then use contextual checkpoint deltas only as auxiliary recovery notes.
+If a contextual delta conflicts with current artifacts, ignore that delta and record the conflict before continuing.
 Prefer the artifact-backed next safe stage instead of restarting the overhaul from scratch.
 ```
 
@@ -195,6 +197,7 @@ $da-vinci use continue for this existing mobile-app redesign workflow.
 
 Use the existing Da Vinci artifacts in this project.
 Do not restart discovery unless an artifact is missing or clearly wrong.
+选路先以当前工件和 checkpoint 真相为准，再把 Context Delta 作为辅助恢复信息；如果 Context Delta 与工件冲突，忽略冲突条目并记录冲突后继续。
 把登记的项目内 Pencil 源保持在 `.da-vinci/designs/` 下，作为设计真相源。如果继续这一轮会做 Pencil 编辑，必须先执行 `da-vinci pencil-session begin --project <project-path> --pen <path>`，发生实质性 live edit 后再执行 `da-vinci pencil-session persist --project <project-path> --pen <path> ...`；只有 session wrapper 不可用时，才退回 `write-pen + check-pen-sync` 这条底层链路。
 If the redesign is complex, keep the anchor-first flow until the design checkpoint passes.
 如果 Pencil MCP 可用，且这一轮继续做了新的 Pencil 写入，就重新运行 MCP runtime gate，并把最新结果记录到 `pencil-design.md`。

package/docs/zh-CN/prompt-presets/tablet-app.md

@@ -75,6 +75,8 @@ $da-vinci use continue for this existing overhaul-from-code tablet workflow.
 
 Use the existing Da Vinci artifacts.
 Detect whether the workflow should return to breakdown, continue with design, generate tasks, continue implementation, or verify drift.
+Determine routing from artifact and checkpoint truth first, then use contextual checkpoint deltas only as auxiliary recovery notes.
+If a contextual delta conflicts with current artifacts, ignore that delta and record the conflict before continuing.
 Prefer the artifact-backed next safe stage instead of restarting the overhaul from scratch.
 ```
 
@@ -187,6 +189,7 @@ $da-vinci use continue for this existing tablet-product redesign workflow.
 
 Use the existing Da Vinci artifacts in this project.
 Do not restart discovery unless an artifact is missing or clearly wrong.
+选路先以当前工件和 checkpoint 真相为准，再把 Context Delta 作为辅助恢复信息；如果 Context Delta 与工件冲突，忽略冲突条目并记录冲突后继续。
 把登记的项目内 Pencil 源保持在 `.da-vinci/designs/` 下，作为设计真相源。如果继续这一轮会做 Pencil 编辑，必须先执行 `da-vinci pencil-session begin --project <project-path> --pen <path>`，发生实质性 live edit 后再执行 `da-vinci pencil-session persist --project <project-path> --pen <path> ...`；只有 session wrapper 不可用时，才退回 `write-pen + check-pen-sync` 这条底层链路。
 If the redesign is complex, continue from the approved anchor surfaces instead of restarting broad scaffolding.
 如果 Pencil MCP 可用，且这一轮继续做了新的 Pencil 写入，就重新运行 MCP runtime gate，并把最新结果记录到 `pencil-design.md`。

package/docs/zh-CN/prompt-presets/web-app.md

@@ -75,6 +75,8 @@ $da-vinci use continue for this existing overhaul-from-code web workflow.
 
 Use the existing Da Vinci artifacts.
 Detect whether the workflow should return to breakdown, continue with design, generate tasks, continue implementation, or verify drift.
+Determine routing from artifact and checkpoint truth first, then use contextual checkpoint deltas only as auxiliary recovery notes.
+If a contextual delta conflicts with current artifacts, ignore that delta and record the conflict before continuing.
 Prefer the artifact-backed next safe stage instead of restarting the overhaul from scratch.
 ```
 
@@ -188,6 +190,7 @@ $da-vinci use continue for this existing web-product redesign workflow.
 
 Use the existing Da Vinci artifacts in this project.
 Do not restart discovery unless an artifact is missing or clearly wrong.
+选路先以当前工件和 checkpoint 真相为准，再把 Context Delta 作为辅助恢复信息；如果 Context Delta 与工件冲突，忽略冲突条目并记录冲突后继续。
 把登记的项目内 Pencil 源保持在 `.da-vinci/designs/` 下，作为设计真相源。如果继续这一轮会做 Pencil 编辑，必须先执行 `da-vinci pencil-session begin --project <project-path> --pen <path>`，发生实质性 live edit 后再执行 `da-vinci pencil-session persist --project <project-path> --pen <path> ...`；只有 session wrapper 不可用时，才退回 `write-pen + check-pen-sync` 这条底层链路。
 If the redesign is complex, continue from the approved anchor surfaces instead of restarting broad scaffolding.
 如果 Pencil MCP 可用，且这一轮继续做了新的 Pencil 写入，就重新运行 MCP runtime gate，并把最新结果记录到 `pencil-design.md`。

package/docs/zh-CN/visual-adapters.md

@@ -48,33 +48,14 @@ visual adapter 也不能替代按 form factor 执行的 layout hygiene 规则。
 
 ```md
 ## Visual Assist
-- Preferred adapters:
-  - frontend-skill
-  - ui-ux-pro-max
-- Design-supervisor reviewers:
-  - frontend-skill
-  - ui-ux-pro-max
-- Design-supervisor review mode:
-  - screenshot-and-theme
-- Design-supervisor review inputs:
-  - screenshots
-  - pencil variables
-  - visual thesis
-  - content plan
-  - interaction thesis
-- Scope:
-  - visual contract refinement
-  - page composition
-  - hierarchy and spacing
-  - motion guidance
-  - anchor-surface composition
-  - Pencil design refinement
-- Fallback:
-  - native-da-vinci
-- Require Adapter:
-  - false
-- Require Supervisor Review:
-  - false
+- Preferred adapters: frontend-skill, ui-ux-pro-max
+- Design-supervisor reviewers: frontend-skill, ui-ux-pro-max
+- Design-supervisor review mode: screenshot-and-theme
+- Design-supervisor review inputs: screenshots, pencil variables, visual thesis, content plan, interaction thesis
+- Scope: visual contract refinement, page composition, hierarchy and spacing, motion guidance, anchor-surface composition, Pencil design refinement
+- Fallback: native-da-vinci
+- Require Adapter: false
+- Require Supervisor Review: false
 ```
 
 只有当你希望“本地没有对应 adapter 就必须停下”时，才把 `Require Adapter` 设成 `true`。
@@ -85,32 +66,14 @@ visual adapter 也不能替代按 form factor 执行的 layout hygiene 规则。
 
 ```md
 ## Visual Assist
-- Preferred adapters:
-  - ui-ux-pro-max
-  - frontend-skill
-- Design-supervisor reviewers:
-  - frontend-skill
-  - ui-ux-pro-max
-- Design-supervisor review mode:
-  - screenshot-and-theme
-- Design-supervisor review inputs:
-  - screenshots
-  - pencil variables
-  - visual thesis
-  - content plan
-  - interaction thesis
-- Scope:
-  - visual contract refinement
-  - page composition
-  - hierarchy and spacing
-  - anchor-surface composition
-  - Pencil design refinement
-- Fallback:
-  - native-da-vinci
-- Require Adapter:
-  - false
-- Require Supervisor Review:
-  - false
+- Preferred adapters: ui-ux-pro-max, frontend-skill
+- Design-supervisor reviewers: frontend-skill, ui-ux-pro-max
+- Design-supervisor review mode: screenshot-and-theme
+- Design-supervisor review inputs: screenshots, pencil variables, visual thesis, content plan, interaction thesis
+- Scope: visual contract refinement, page composition, hierarchy and spacing, anchor-surface composition, Pencil design refinement
+- Fallback: native-da-vinci
+- Require Adapter: false
+- Require Supervisor Review: false
 ```
 
 适用场景：
@@ -122,33 +85,14 @@ visual adapter 也不能替代按 form factor 执行的 layout hygiene 规则。
 
 ```md
 ## Visual Assist
-- Preferred adapters:
-  - frontend-skill
-  - ui-ux-pro-max
-- Design-supervisor reviewers:
-  - frontend-skill
-  - ui-ux-pro-max
-- Design-supervisor review mode:
-  - screenshot-and-theme
-- Design-supervisor review inputs:
-  - screenshots
-  - pencil variables
-  - visual thesis
-  - content plan
-  - interaction thesis
-- Scope:
-  - visual contract refinement
-  - page composition
-  - hierarchy and spacing
-  - motion guidance
-  - anchor-surface composition
-  - Pencil design refinement
-- Fallback:
-  - native-da-vinci
-- Require Adapter:
-  - true
-- Require Supervisor Review:
-  - false
+- Preferred adapters: frontend-skill, ui-ux-pro-max
+- Design-supervisor reviewers: frontend-skill, ui-ux-pro-max
+- Design-supervisor review mode: screenshot-and-theme
+- Design-supervisor review inputs: screenshots, pencil variables, visual thesis, content plan, interaction thesis
+- Scope: visual contract refinement, page composition, hierarchy and spacing, motion guidance, anchor-surface composition, Pencil design refinement
+- Fallback: native-da-vinci
+- Require Adapter: true
+- Require Supervisor Review: false
 ```
 
 适用场景：

package/docs/zh-CN/visual-assist-presets/desktop-app.md

@@ -18,20 +18,10 @@
 
 ```md
 ## Visual Assist
-- Preferred adapters:
-  - ui-ux-pro-max
-  - frontend-skill
-- Scope:
-  - visual contract refinement
-  - workspace composition
-  - hierarchy and spacing
-  - motion guidance
-  - anchor-surface composition
-  - Pencil design refinement
-- Fallback:
-  - native-da-vinci
-- Require Adapter:
-  - false
+- Preferred adapters: ui-ux-pro-max, frontend-skill
+- Scope: visual contract refinement, workspace composition, hierarchy and spacing, motion guidance, anchor-surface composition, Pencil design refinement
+- Fallback: native-da-vinci
+- Require Adapter: false
 ```
 
 ### 变体 2：reviewer 建议性审查
@@ -43,33 +33,14 @@
 
 ```md
 ## Visual Assist
-- Preferred adapters:
-  - ui-ux-pro-max
-  - frontend-skill
-- Design-supervisor reviewers:
-  - frontend-skill
-  - ui-ux-pro-max
-- Design-supervisor review mode:
-  - screenshot-and-theme
-- Design-supervisor review inputs:
-  - screenshots
-  - pencil variables
-  - visual thesis
-  - content plan
-  - interaction thesis
-- Scope:
-  - visual contract refinement
-  - workspace composition
-  - hierarchy and spacing
-  - motion guidance
-  - anchor-surface composition
-  - Pencil design refinement
-- Fallback:
-  - native-da-vinci
-- Require Adapter:
-  - false
-- Require Supervisor Review:
-  - false
+- Preferred adapters: ui-ux-pro-max, frontend-skill
+- Design-supervisor reviewers: frontend-skill, ui-ux-pro-max
+- Design-supervisor review mode: screenshot-and-theme
+- Design-supervisor review inputs: screenshots, pencil variables, visual thesis, content plan, interaction thesis
+- Scope: visual contract refinement, workspace composition, hierarchy and spacing, motion guidance, anchor-surface composition, Pencil design refinement
+- Fallback: native-da-vinci
+- Require Adapter: false
+- Require Supervisor Review: false
 ```
 
 ### 变体 3：reviewer 硬签字
@@ -82,33 +53,14 @@
 
 ```md
 ## Visual Assist
-- Preferred adapters:
-  - frontend-skill
-  - ui-ux-pro-max
-- Design-supervisor reviewers:
-  - frontend-skill
-  - ui-ux-pro-max
-- Design-supervisor review mode:
-  - screenshot-and-theme
-- Design-supervisor review inputs:
-  - screenshots
-  - pencil variables
-  - visual thesis
-  - content plan
-  - interaction thesis
-- Scope:
-  - visual contract refinement
-  - workspace composition
-  - hierarchy and spacing
-  - motion guidance
-  - anchor-surface composition
-  - Pencil design refinement
-- Fallback:
-  - native-da-vinci
-- Require Adapter:
-  - true
-- Require Supervisor Review:
-  - true
+- Preferred adapters: frontend-skill, ui-ux-pro-max
+- Design-supervisor reviewers: frontend-skill, ui-ux-pro-max
+- Design-supervisor review mode: screenshot-and-theme
+- Design-supervisor review inputs: screenshots, pencil variables, visual thesis, content plan, interaction thesis
+- Scope: visual contract refinement, workspace composition, hierarchy and spacing, motion guidance, anchor-surface composition, Pencil design refinement
+- Fallback: native-da-vinci
+- Require Adapter: true
+- Require Supervisor Review: true
 ```
 
 通用说明：

package/docs/zh-CN/visual-assist-presets/mobile-app.md

@@ -17,20 +17,10 @@
 
 ```md
 ## Visual Assist
-- Preferred adapters:
-  - ui-ux-pro-max
-  - frontend-skill
-- Scope:
-  - visual contract refinement
-  - mobile page composition
-  - hierarchy and spacing
-  - touch-first motion guidance
-  - anchor-surface composition
-  - Pencil design refinement
-- Fallback:
-  - native-da-vinci
-- Require Adapter:
-  - false
+- Preferred adapters: ui-ux-pro-max, frontend-skill
+- Scope: visual contract refinement, mobile page composition, hierarchy and spacing, touch-first motion guidance, anchor-surface composition, Pencil design refinement
+- Fallback: native-da-vinci
+- Require Adapter: false
 ```
 
 ### 变体 2：reviewer 建议性审查
@@ -43,33 +33,14 @@
 
 ```md
 ## Visual Assist
-- Preferred adapters:
-  - ui-ux-pro-max
-  - frontend-skill
-- Design-supervisor reviewers:
-  - frontend-skill
-  - ui-ux-pro-max
-- Design-supervisor review mode:
-  - screenshot-and-theme
-- Design-supervisor review inputs:
-  - screenshots
-  - pencil variables
-  - visual thesis
-  - content plan
-  - interaction thesis
-- Scope:
-  - visual contract refinement
-  - mobile page composition
-  - hierarchy and spacing
-  - touch-first motion guidance
-  - anchor-surface composition
-  - Pencil design refinement
-- Fallback:
-  - native-da-vinci
-- Require Adapter:
-  - false
-- Require Supervisor Review:
-  - false
+- Preferred adapters: ui-ux-pro-max, frontend-skill
+- Design-supervisor reviewers: frontend-skill, ui-ux-pro-max
+- Design-supervisor review mode: screenshot-and-theme
+- Design-supervisor review inputs: screenshots, pencil variables, visual thesis, content plan, interaction thesis
+- Scope: visual contract refinement, mobile page composition, hierarchy and spacing, touch-first motion guidance, anchor-surface composition, Pencil design refinement
+- Fallback: native-da-vinci
+- Require Adapter: false
+- Require Supervisor Review: false
 ```
 
 ### 变体 3：reviewer 硬签字
@@ -82,33 +53,14 @@
 
 ```md
 ## Visual Assist
-- Preferred adapters:
-  - frontend-skill
-  - ui-ux-pro-max
-- Design-supervisor reviewers:
-  - frontend-skill
-  - ui-ux-pro-max
-- Design-supervisor review mode:
-  - screenshot-and-theme
-- Design-supervisor review inputs:
-  - screenshots
-  - pencil variables
-  - visual thesis
-  - content plan
-  - interaction thesis
-- Scope:
-  - visual contract refinement
-  - mobile page composition
-  - hierarchy and spacing
-  - touch-first motion guidance
-  - anchor-surface composition
-  - Pencil design refinement
-- Fallback:
-  - native-da-vinci
-- Require Adapter:
-  - true
-- Require Supervisor Review:
-  - true
+- Preferred adapters: frontend-skill, ui-ux-pro-max
+- Design-supervisor reviewers: frontend-skill, ui-ux-pro-max
+- Design-supervisor review mode: screenshot-and-theme
+- Design-supervisor review inputs: screenshots, pencil variables, visual thesis, content plan, interaction thesis
+- Scope: visual contract refinement, mobile page composition, hierarchy and spacing, touch-first motion guidance, anchor-surface composition, Pencil design refinement
+- Fallback: native-da-vinci
+- Require Adapter: true
+- Require Supervisor Review: true
 ```
 
 通用说明：

package/docs/zh-CN/visual-assist-presets/tablet-app.md

@@ -17,20 +17,10 @@
 
 ```md
 ## Visual Assist
-- Preferred adapters:
-  - ui-ux-pro-max
-  - frontend-skill
-- Scope:
-  - visual contract refinement
-  - tablet page composition
-  - hierarchy and spacing
-  - touch-aware motion guidance
-  - anchor-surface composition
-  - Pencil design refinement
-- Fallback:
-  - native-da-vinci
-- Require Adapter:
-  - false
+- Preferred adapters: ui-ux-pro-max, frontend-skill
+- Scope: visual contract refinement, tablet page composition, hierarchy and spacing, touch-aware motion guidance, anchor-surface composition, Pencil design refinement
+- Fallback: native-da-vinci
+- Require Adapter: false
 ```
 
 ### 变体 2：reviewer 建议性审查
@@ -42,33 +32,14 @@
 
 ```md
 ## Visual Assist
-- Preferred adapters:
-  - ui-ux-pro-max
-  - frontend-skill
-- Design-supervisor reviewers:
-  - frontend-skill
-  - ui-ux-pro-max
-- Design-supervisor review mode:
-  - screenshot-and-theme
-- Design-supervisor review inputs:
-  - screenshots
-  - pencil variables
-  - visual thesis
-  - content plan
-  - interaction thesis
-- Scope:
-  - visual contract refinement
-  - tablet page composition
-  - hierarchy and spacing
-  - touch-aware motion guidance
-  - anchor-surface composition
-  - Pencil design refinement
-- Fallback:
-  - native-da-vinci
-- Require Adapter:
-  - false
-- Require Supervisor Review:
-  - false
+- Preferred adapters: ui-ux-pro-max, frontend-skill
+- Design-supervisor reviewers: frontend-skill, ui-ux-pro-max
+- Design-supervisor review mode: screenshot-and-theme
+- Design-supervisor review inputs: screenshots, pencil variables, visual thesis, content plan, interaction thesis
+- Scope: visual contract refinement, tablet page composition, hierarchy and spacing, touch-aware motion guidance, anchor-surface composition, Pencil design refinement
+- Fallback: native-da-vinci
+- Require Adapter: false
+- Require Supervisor Review: false
 ```
 
 ### 变体 3：reviewer 硬签字
@@ -81,33 +52,14 @@
 
 ```md
 ## Visual Assist
-- Preferred adapters:
-  - frontend-skill
-  - ui-ux-pro-max
-- Design-supervisor reviewers:
-  - frontend-skill
-  - ui-ux-pro-max
-- Design-supervisor review mode:
-  - screenshot-and-theme
-- Design-supervisor review inputs:
-  - screenshots
-  - pencil variables
-  - visual thesis
-  - content plan
-  - interaction thesis
-- Scope:
-  - visual contract refinement
-  - tablet page composition
-  - hierarchy and spacing
-  - touch-aware motion guidance
-  - anchor-surface composition
-  - Pencil design refinement
-- Fallback:
-  - native-da-vinci
-- Require Adapter:
-  - true
-- Require Supervisor Review:
-  - true
+- Preferred adapters: frontend-skill, ui-ux-pro-max
+- Design-supervisor reviewers: frontend-skill, ui-ux-pro-max
+- Design-supervisor review mode: screenshot-and-theme
+- Design-supervisor review inputs: screenshots, pencil variables, visual thesis, content plan, interaction thesis
+- Scope: visual contract refinement, tablet page composition, hierarchy and spacing, touch-aware motion guidance, anchor-surface composition, Pencil design refinement
+- Fallback: native-da-vinci
+- Require Adapter: true
+- Require Supervisor Review: true
 ```
 
 通用说明：