@nick848/fet 1.1.5 → 1.1.7

package/README.md

@@ -13,6 +13,7 @@ FET 是一个围绕 OpenSpec 构建的前端开发工作流编排 CLI。它不
 - 统一语言：默认使用中文输出交互信息和生成产物，可通过 `--lang <language>` 切换。
 - 保护关键阶段：在 `sync` / `archive` 前检查 FET verify 状态，降低未验证变更被合入或归档的风险。
 - 可选代码图：可接入 GitNexus，在大范围扫描前优先提供结构化代码上下文。
+- Figma 守卫：当 change 产物含 Figma 链接时，自动写入停止协议并让 IDE 在理解失败时先问用户，不猜测样式（无需额外命令）。
 
 ## 基本原理
 
@@ -114,7 +115,7 @@ fet init --lang en
 |------|------|------|
 | `fet init` | `fet init [--yes] [--lang <language>]` | 初始化 FET 和 OpenSpec；生成上下文、状态、Cursor 集成和 Codex 工作流指南。 |
 | `fet update-context` | `fet update-context [--yes]` | 重新扫描项目并更新 `AGENTS.md` 与 `openspec/config.yaml` 的 FET 托管区域。 |
-| `fet fill-context` | `fet fill-context [--yes]` | 刷新 IDE 交接命令，引导 AI 替换 `AGENTS.md` 占位符。 |
+| `fet fill-context` | `fet fill-context [--yes]` | 刷新 IDE 交接命令；自动识别小程序工程并写入包体积/2MB 约束，引导 AI 补齐其余 `AGENTS.md` 占位符。 |
 | `fet doctor` | `fet doctor [--fix-lock]` | 诊断 OpenSpec、FET 状态、上下文文件、工具集成和锁文件。 |
 | `fet explore` | `fet explore [...args] [--change <id>]` | 通过 FET 执行 OpenSpec 原生 explore，保留交互式需求澄清。 |
 | `fet propose` | `fet propose <change-id-or-description>` | 创建 OpenSpec change，并生成第一个 ready 规划产物；后续产物用 `continue` 逐步推进。 |
@@ -176,13 +177,18 @@ FET 可能创建或更新：
 - `CLAUDE.md`
 - `.cursor/skills/fet-*/SKILL.md`
 - `.cursor/rules/fet-context.mdc`
+- `.cursor/rules/fet-figma-stop.mdc`
 - `.cursor/rules/karpathy-guidelines.mdc`
 - `.codex/fet/context.md`
+- `.codex/fet/figma-stop.md`
 - `.codex/fet/karpathy-guidelines.md`
+- `openspec/changes/<change-id>/.fet/figma-stop.md`（change 含 Figma 链接时自动写入）
 - `.codex/fet/commands/*.md`
 - `$CODEX_HOME/prompts/fet-*.md`
 
-FET 只拥有明确标记的托管区域。托管区域之外的用户内容应被保留。`fet init` 还会向 `.gitignore` 添加 FET 本地状态块，避免把锁文件和本地状态误提交。
+FET 只拥有明确标记的托管区域。托管区域之外的用户内容应被保留。
+
+**团队与 Git**：`openspec/fet-state.json`、锁文件等是否纳入版本库由团队自行决定。`fet init` 不再自动修改 `.gitignore`。常见做法：（1）提交共享状态并约定每人只改自己负责的 change，减少 `activeChangeId` 冲突；（2）仅在本机用 `.git/info/exclude` 排除锁文件与日志，仓库 `.gitignore` 保持团队统一；（3）整包状态不入库，由每人本地维护（适合无协作场景）。可参考 `src/templates/gitignore.ts` 中的规则片段自行合并。
 
 ## 安全边界
 

package/README_en.md

@@ -13,6 +13,7 @@ FET is a frontend development workflow orchestration CLI built around OpenSpec.
 - Unifies language: Chinese is the default for interaction messages and generated artifacts; use `--lang <language>` to switch.
 - Guards critical stages: checks FET verification state before `sync` / `archive`.
 - Supports optional code graphs: integrates with GitNexus so AI tools can prefer structured code context before broad repository scans.
+- Figma guard: when a change references Figma, FET writes a stop protocol so the IDE asks the user instead of guessing styles when design input is unclear (no extra commands).
 
 ## How It Works
 
@@ -178,13 +179,18 @@ FET may create or update:
 - `CLAUDE.md`
 - `.cursor/skills/fet-*/SKILL.md`
 - `.cursor/rules/fet-context.mdc`
+- `.cursor/rules/fet-figma-stop.mdc`
 - `.cursor/rules/karpathy-guidelines.mdc`
 - `.codex/fet/context.md`
+- `.codex/fet/figma-stop.md`
 - `.codex/fet/karpathy-guidelines.md`
+- `openspec/changes/<change-id>/.fet/figma-stop.md` (written when the change references Figma)
 - `.codex/fet/commands/*.md`
 - `$CODEX_HOME/prompts/fet-*.md`
 
-FET only owns explicitly marked managed regions. User content outside those regions should be preserved. During `fet init`, FET also adds a managed `.gitignore` block for local workflow state.
+FET only owns explicitly marked managed regions. User content outside those regions should be preserved.
+
+**Git and teams**: Whether to commit `openspec/fet-state.json`, lock files, and related paths is a team policy. `fet init` no longer edits `.gitignore` automatically. Common options: (1) commit shared state and coordinate who owns each change to avoid `activeChangeId` conflicts; (2) use per-machine `.git/info/exclude` for locks and journals while keeping a shared `.gitignore`; (3) keep all FET state local when collaboration on state is not needed. See `src/templates/gitignore.ts` for a reference ignore block you can merge manually.
 
 ## Safety Model