@nick848/fet 1.1.10 → 1.1.11

package/README.md

@@ -141,6 +141,7 @@ fet propose my-first-change
 fet tdd --change my-first-change
 fet apply --change my-first-change
 fet test --change my-first-change
+fet visual --change my-first-change
 fet verify --change my-first-change
 fet verify --done --change my-first-change
 fet sync --change my-first-change
@@ -161,6 +162,7 @@ fet continue               # 按需重复，生成下一规划产物
 fet tdd --change my-change # 生成本 change 的 TDD 清单（.fet/tdd-manifest.yaml）
 fet apply --change my-change
 fet test --change my-change
+fet visual --change my-change
 fet verify --change my-change
 fet verify --done --change my-change
 fet sync --change my-change
@@ -172,6 +174,7 @@ fet archive --change my-change
 - `continue`、`apply`、`ff`、`sync` 等命令在未传 `--change` 时，优先使用 FET 记录的 **active change**；若仅有一个打开的 change，会自动选中。
 - `fet apply` 默认要求已运行 `fet tdd`（`openspec/config.yaml` 中 `fet.tdd.mode` 可配置）。
 - `fet verify` 要求本 change 已通过 `fet test`（除非 `fet.tdd.enabled: false` 或 test 被配置为 skip）。
+- 含 Figma 引用的 change 在 `fet verify` 前须通过 `fet visual`（默认 layout-only，一条命令完成清单/截图/布局检查）。
 - 经 FET 执行的 `sync` / `archive` 会先检查是否已 `fet verify --done`。
 - 项目结构变化后运行 `fet update-context`；仅刷新 IDE 占位符提示时运行 `fet fill-context`。
 
@@ -232,7 +235,8 @@ fet init --lang en
 | `fet tdd` | `fet tdd [--change <id>]` | 根据规划产物生成 `openspec/changes/<id>/.fet/tdd-manifest.yaml` 等 TDD 契约。 |
 | `fet apply` | `fet apply [...args] [--change <id>]` | 准备实施指令；需先有 TDD 清单（默认）。 |
 | `fet test` | `fet test [--change <id>] [--plan]` | 按 TDD 清单运行项目 test 脚本并记录绿灯状态。 |
-| `fet verify` | `fet verify --change <id>` | 生成 `.fet/verify-instructions.md`；需先 `fet test` 通过。 |
+| `fet visual` | `fet visual [--change <id>] [--base-url <url>] [--plan]` | layout-only 视觉验收（默认含截图+布局检查；含 Figma 时 verify 前必需）。 |
+| `fet verify` | `fet verify --change <id>` | 生成 `.fet/verify-instructions.md`；需先 `fet test`（及含 Figma 时的 `fet visual`）通过。 |
 | `fet verify --done` | `fet verify --done --change <id>` | 声明手动验证完成，允许后续 `sync` / `archive`。 |
 | `fet verify --auto` | `fet verify --auto [--yes]` | 生成自动验证计划；当前版本不执行项目脚本，`--yes` 会记录计划指纹。 |
 | `fet sync` | `fet sync [...args] [--change <id>]` | FET verify gate 通过后执行 OpenSpec 原生 sync。 |

package/README_en.md

@@ -141,6 +141,7 @@ fet propose my-first-change
 fet tdd --change my-first-change
 fet apply --change my-first-change
 fet test --change my-first-change
+fet visual --change my-first-change
 fet verify --change my-first-change
 fet verify --done --change my-first-change
 fet sync --change my-first-change
@@ -161,6 +162,7 @@ fet continue               # repeat as needed for the next planning artifact
 fet tdd --change my-change
 fet apply --change my-change
 fet test --change my-change
+fet visual --change my-change
 fet verify --change my-change
 fet verify --done --change my-change
 fet sync --change my-change
@@ -230,7 +232,8 @@ Before most commands (except `fet update`), FET checks npm for a newer release (
 | `fet tdd` | `fet tdd [--change <id>]` | Generate per-change TDD manifest under `openspec/changes/<id>/.fet/`. |
 | `fet apply` | `fet apply [...args] [--change <id>]` | Prepare implementation instructions; requires TDD manifest by default. |
 | `fet test` | `fet test [--change <id>] [--plan]` | Run project tests scoped to the TDD manifest; record pass/fail. |
-| `fet verify` | `fet verify --change <id>` | Generate verify instructions; requires `fet test` pass first. |
+| `fet visual` | `fet visual [--change <id>] [--base-url <url>] [--plan]` | Layout-only visual verification (default: manifest + capture + layout check). |
+| `fet verify` | `fet verify --change <id>` | Generate verify instructions; requires `fet test` (and `fet visual` when Figma is referenced). |
 | `fet verify --done` | `fet verify --done --change <id>` | Declare manual verification complete and allow later `sync` / `archive`. |
 | `fet verify --auto` | `fet verify --auto [--yes]` | Generate an automatic verification plan. This version does not run project scripts; `--yes` records the plan fingerprint. |
 | `fet sync` | `fet sync [...args] [--change <id>]` | Run native OpenSpec sync after the FET verify gate passes. |