@nick848/fet 1.1.9 → 1.1.11

package/README.md

@@ -138,7 +138,10 @@ fet graph handoff  # 生成 IDE 交接说明
 ```sh
 fet propose my-first-change
 # 或在 Cursor/Codex 中按提示逐步执行 fet continue
+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
@@ -156,7 +159,10 @@ fet archive --change my-first-change
 ```sh
 fet new my-change          # 或 fet propose my-change
 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
@@ -166,6 +172,9 @@ 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`。
 
@@ -223,8 +232,11 @@ fet init --lang en
 | `fet new` | `fet new <change-id>` | 创建新的 OpenSpec change。 |
 | `fet continue` | `fet continue [...args] [--change <id>]` | 通过 FET 执行 OpenSpec 原生 continue。 |
 | `fet ff` | `fet ff [...args] [--change <id>]` | 通过 FET 执行 OpenSpec 原生 ff。 |
-| `fet apply` | `fet apply [...args] [--change <id>]` | 通过 FET 执行 OpenSpec 原生 apply，并同步 FET 状态。 |
-| `fet verify` | `fet verify --change <id>` | 生成 `.fet/verify-instructions.md` 手动验证指令。 |
+| `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 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

@@ -138,7 +138,10 @@ When setup looks healthy, drive your first OpenSpec change. Simple path example:
 ```sh
 fet propose my-first-change
 # or use fet continue step by step from your IDE handoff
+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
@@ -156,7 +159,10 @@ After first-time setup, a typical loop is:
 ```sh
 fet new my-change          # or fet propose my-change
 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
@@ -223,8 +229,11 @@ Before most commands (except `fet update`), FET checks npm for a newer release (
 | `fet new` | `fet new <change-id>` | Create a new OpenSpec change. |
 | `fet continue` | `fet continue [...args] [--change <id>]` | Run native OpenSpec continue through FET. |
 | `fet ff` | `fet ff [...args] [--change <id>]` | Run native OpenSpec ff through FET. |
-| `fet apply` | `fet apply [...args] [--change <id>]` | Run native OpenSpec apply through FET and update FET state. |
-| `fet verify` | `fet verify --change <id>` | Generate `.fet/verify-instructions.md` for manual verification. |
+| `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 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. |