openfeel 1.3.1 → 1.3.3

package/dist/core/view/entry.js

@@ -81,31 +81,55 @@ export function addReviewEntry(projectPath, opts) {
     if (!['high', 'medium', 'low'].includes(priority)) {
         return { review: null, error: { code: 'invalidPriority', priority } };
     }
-    // opId 格式校验（用 lastIndexOf 分割，兼容含点 stageId）
-    const dotIdx = opts.opId.lastIndexOf('.');
-    if (dotIdx === -1) {
-        return { review: null, error: { code: 'invalidOpId', opId: opts.opId } };
+    // 自动修复必须绑定具体 op（addAutoFixReview 需要 op 才能推进）
+    if (opts.autoFixDetail && !opts.opId) {
+        return { review: null, error: { code: 'autoFixRequiresOp', opId: opts.opId } };
     }
-    const rawStageId = opts.opId.substring(0, dotIdx);
-    const opLocalId = opts.opId.substring(dotIdx + 1);
-    // REV-009：短名前缀归一化 + 双键回退（单点实现，禁第二套校验）
-    const stageId = normalizeStageId(rawStageId) ?? rawStageId;
     const data = mgr.getData();
-    const stage = data ? (data.stages[stageId] ?? data.stages[rawStageId]) : undefined;
-    if (!data || !stage) {
-        return { review: null, error: { code: 'stageNotFound', opId: opts.opId, stage: stageId } };
+    let opId;
+    /** 阶段级 REV 的显式归属（op 级为 undefined，向后兼容） */
+    let reviewStage;
+    if (opts.opId) {
+        // op 级：原路径（用 lastIndexOf 分割，兼容含点 stageId）
+        const dotIdx = opts.opId.lastIndexOf('.');
+        if (dotIdx === -1) {
+            return { review: null, error: { code: 'invalidOpId', opId: opts.opId } };
+        }
+        const rawStageId = opts.opId.substring(0, dotIdx);
+        const opLocalId = opts.opId.substring(dotIdx + 1);
+        // REV-009：短名前缀归一化 + 双键回退（单点实现，禁第二套校验）
+        const stageId = normalizeStageId(rawStageId) ?? rawStageId;
+        const stage = data ? (data.stages[stageId] ?? data.stages[rawStageId]) : undefined;
+        if (!data || !stage) {
+            return { review: null, error: { code: 'stageNotFound', opId: opts.opId, stage: stageId } };
+        }
+        if (!stage.ops[opLocalId]) {
+            return { review: null, error: { code: 'opNotFound', opId: opts.opId, op: opLocalId, stage: stageId } };
+        }
+        opId = opts.opId;
     }
-    if (!stage.ops[opLocalId]) {
-        return { review: null, error: { code: 'opNotFound', opId: opts.opId, op: opLocalId, stage: stageId } };
+    else if (opts.stageId) {
+        // 阶段级：**必须绕过** lastIndexOf('.') 的 op 解析（stage id 自身含点，如 v0.0.1-stage-01）
+        const stageId = normalizeStageId(opts.stageId) ?? opts.stageId;
+        const stage = data ? (data.stages[stageId] ?? data.stages[opts.stageId]) : undefined;
+        if (!data || !stage) {
+            return { review: null, error: { code: 'stageNotFound', opId: opts.stageId, stage: stageId } };
+        }
+        opId = stageId;
+        reviewStage = stageId;
+    }
+    else {
+        return { review: null, error: { code: 'invalidTarget', opId: opts.opId, stageId: opts.stageId } };
     }
     // REV ID 由单点按「既有最大序号 + 1」分配（T13），两入口不得自行生成
     const revId = generateReviewId(projectPath);
     const review = {
         id: revId,
-        op: opts.opId,
+        op: opId,
+        ...(reviewStage === undefined ? {} : { stage: reviewStage }),
         status: 'open',
         priority: priority,
-        title: opts.title || opts.opId,
+        title: opts.title || opId,
         filed_by: opts.filedBy ?? 'cli',
         filed_at: new Date().toISOString(),
         canAutoFix: !!opts.autoFixDetail,
@@ -113,7 +137,7 @@ export function addReviewEntry(projectPath, opts) {
         blocking: opts.blocking ?? true,
     };
     if (opts.autoFixDetail) {
-        mgr.addAutoFixReview(review, opts.opId);
+        mgr.addAutoFixReview(review, opId);
     }
     else {
         mgr.addReview(review);

package/dist/core/view/entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../../src/core/view/entry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../../src/core/view/entry.ts"],"names":[],"mappings":"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"}

package/dist/core/workspace/structure.d.ts

@@ -3,7 +3,27 @@
  */
 export declare function ensureDir(path: string): void;
 /**
- * 创建 .openfeel/ 完整目录结构
+ * 核心必需目录（init 时创建；被 flow / plan / kb / dev 模板直接依赖）。
+ * v1.3.3 P2-4：由 10 个固定目录瘦身为 4 核心 + 6 惰性，降低冷启动前置开销。
+ */
+export declare const CORE_WORKSPACE_DIRS: readonly ["plan", "kb", "dev", "log"];
+/**
+ * 惰性目录：首次使用时按需 `mkdir -p`（写路径已有/新增 `ensureLazyDir` 兜底）。
+ * 不参与 init 冷启动；缺失不视为工作区损坏。
+ */
+export declare const LAZY_WORKSPACE_DIRS: readonly ["code_review", "bugs", "users", "tmp", "manual", "update_conflicts"];
+/**
+ * 惰性目录清单（导出供 lint / 文档 / 测试复用）。
+ */
+export declare const WORKSPACE_LAZY_DIRS: readonly string[];
+/**
+ * 按需确保 `.openfeel/{name}` 惰性目录存在（幂等；仅接受 LAZY_WORKSPACE_DIRS 内的名字）。
+ * 供写路径在首次落盘前调用；未知目录名直接忽略（防御，不建任意目录）。
+ */
+export declare function ensureLazyDir(projectPath: string, name: string): void;
+/**
+ * 创建 .openfeel/ 目录结构（核心必需 + dev 子目录；惰性目录不建）。
+ * @returns 本次新建的目录相对路径列表（既有目录不重复计入）
  */
 export declare function createWorkspace(projectPath: string): string[];
 //# sourceMappingURL=structure.d.ts.map

package/dist/core/workspace/structure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../../src/core/workspace/structure.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI5C;AAuBD;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CA8B7D"}
+{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../../src/core/workspace/structure.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI5C;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,uCAAwC,CAAC;AAEzE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,gFAOtB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAAwB,CAAC;AAS1E;;;GAGG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAKrE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CA8B7D"}

package/dist/core/workspace/structure.js

@@ -1,6 +1,6 @@
 /**
  * 工作区目录创建
- * 负责创建项目下的 .openfeel/ 完整目录结构。
+ * 负责创建项目下的 .openfeel/ 目录结构（v1.3.3 P2-4：核心必需 + 其余惰性）。
  */
 import { mkdirSync, existsSync } from 'node:fs';
 import { resolve } from 'node:path';
@@ -12,19 +12,27 @@ export function ensureDir(path) {
         mkdirSync(path, { recursive: true });
     }
 }
-/** .openfeel/ 下的子目录清单 */
-const WORKSPACE_DIRS = [
-    'plan',
-    'kb',
-    'dev',
-    'log',
+/**
+ * 核心必需目录（init 时创建；被 flow / plan / kb / dev 模板直接依赖）。
+ * v1.3.3 P2-4：由 10 个固定目录瘦身为 4 核心 + 6 惰性，降低冷启动前置开销。
+ */
+export const CORE_WORKSPACE_DIRS = ['plan', 'kb', 'dev', 'log'];
+/**
+ * 惰性目录：首次使用时按需 `mkdir -p`（写路径已有/新增 `ensureLazyDir` 兜底）。
+ * 不参与 init 冷启动；缺失不视为工作区损坏。
+ */
+export const LAZY_WORKSPACE_DIRS = [
     'code_review',
     'bugs',
     'users',
     'tmp',
     'manual',
-    'update_conflicts', // 新增：update 冲突文件目录
+    'update_conflicts',
 ];
+/**
+ * 惰性目录清单（导出供 lint / 文档 / 测试复用）。
+ */
+export const WORKSPACE_LAZY_DIRS = LAZY_WORKSPACE_DIRS;
 /**
  * dev/ 下的子目录清单
  * - `note`：团队共享开发笔记
@@ -32,7 +40,18 @@ const WORKSPACE_DIRS = [
  */
 const DEV_SUB_DIRS = ['note', 'current_archive'];
 /**
- * 创建 .openfeel/ 完整目录结构
+ * 按需确保 `.openfeel/{name}` 惰性目录存在（幂等；仅接受 LAZY_WORKSPACE_DIRS 内的名字）。
+ * 供写路径在首次落盘前调用；未知目录名直接忽略（防御，不建任意目录）。
+ */
+export function ensureLazyDir(projectPath, name) {
+    if (!LAZY_WORKSPACE_DIRS.includes(name)) {
+        return;
+    }
+    ensureDir(resolve(projectPath, '.openfeel', name));
+}
+/**
+ * 创建 .openfeel/ 目录结构（核心必需 + dev 子目录；惰性目录不建）。
+ * @returns 本次新建的目录相对路径列表（既有目录不重复计入）
  */
 export function createWorkspace(projectPath) {
     const base = resolve(projectPath, '.openfeel');
@@ -42,8 +61,8 @@ export function createWorkspace(projectPath) {
         mkdirSync(base, { recursive: true });
         created.push('.openfeel/');
     }
-    // 创建子目录
-    for (const dir of WORKSPACE_DIRS) {
+    // 创建核心子目录
+    for (const dir of CORE_WORKSPACE_DIRS) {
         const fullPath = resolve(base, dir);
         if (!existsSync(fullPath)) {
             mkdirSync(fullPath, { recursive: true });

package/dist/core/workspace/structure.js.map

@@ -1 +1 @@
-{"version":3,"file":"structure.js","sourceRoot":"","sources":["../../../src/core/workspace/structure.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;AACH,CAAC;AAED,yBAAyB;AACzB,MAAM,cAAc,GAAG;IACrB,MAAM;IACN,IAAI;IACJ,KAAK;IACL,KAAK;IACL,aAAa;IACb,MAAM;IACN,OAAO;IACP,KAAK;IACL,QAAQ;IACR,kBAAkB,EAAG,mBAAmB;CACzC,CAAC;AAEF;;;;GAIG;AACH,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAEjD;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,UAAU;IACV,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC7B,CAAC;IAED,QAAQ;IACR,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,eAAe;IACf,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrC,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,iBAAiB,MAAM,GAAG,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"structure.js","sourceRoot":"","sources":["../../../src/core/workspace/structure.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAEzE;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,aAAa;IACb,MAAM;IACN,OAAO;IACP,KAAK;IACL,QAAQ;IACR,kBAAkB;CACV,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAsB,mBAAmB,CAAC;AAE1E;;;;GAIG;AACH,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAEjD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB,EAAE,IAAY;IAC7D,IAAI,CAAE,mBAAyC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/D,OAAO;IACT,CAAC;IACD,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,UAAU;IACV,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC7B,CAAC;IAED,UAAU;IACV,KAAK,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,eAAe;IACf,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrC,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,iBAAiB,MAAM,GAAG,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dsh/ADAPTER.md

@@ -1,6 +1,6 @@
 # DSH 适配器
 
-> ✅ 已实现（OpenFeel v1.3.0 / DSH 0.2.0-rc.2）。
+> ✅ 已实现（OpenFeel v1.3.2 / DSH 0.2.0-rc.2+；硬门禁依赖 `ctx.tools.guard`，缺失时降级为提示）。
 
 - **安装（推荐，单包）**：`npm i -g openfeel@latest` → `openfeel setup --tools dsh`
   （写入 DSH profile 的 `link:<openfeelRoot>/dsh` 依赖与 `dsh.profile.bundles`，按需 `pnpm install`），
@@ -15,7 +15,7 @@
 - **契约**：CLI 的 `--json` 出口以 [`docs/json-contract.md`](https://github.com/Liuary/OpenFeel/blob/master/docs/json-contract.md) 为**单一权威**
   （v1.3.0 起仍 40 个成功出口）；本适配器只消费、不重实现。
 - **升级**：`npm i -g openfeel@latest` → 重启 DSH。适配器版本要求见 `package.json`
-  的 `openfeel.requiresCli`（≥1.3.0）。
+  的 `openfeel.requiresCli`（≥1.3.2）。
 
 ## 设计边界
 
@@ -28,11 +28,23 @@ OpenFeel 采用「核心层 + 适配器层」架构（`claude/`、`kilo/`、`.op
 - **不解析**中文文本：优先消费 `--json`；失败读 `error.kind` / `error.code` / `error.detail`。
 - **不 shadow** 既有能力：DSH 已有的 `subagent` / `workflow` / `todo_write` 照常使用；
   `feel_next` 只给「该谁做」，实际派发交给 DSH。
+- **写入门禁**（v1.3.3）：用 DSH `ctx.tools.guard()` 同步拒绝 `edit` / `write` / `apply_patch` /
+  `str_replace_editor`；`.openfeel/**` 流程产物任意阶段可写（flow.json / `status.md` 除外）。
+  v1.3.3 起按**风险分层**：
+  - **bootstrap 例外**：工作区无 `.openfeel/` 时，全部目标为「新增文件」（`apply_patch` 还要求全部为
+    `*** Add File:`）→ 放行并提示补账本；已存在文件、`.openfeel/**`、Update/Delete/Move 仍拒绝；
+  - **doc/note 不绑相位**：`docs/**` 与 `.md/.mdx/.txt/.rst/.adoc` 在无活跃阶段或非 `exec_running`
+    相位也可写；**混合目标从严**（任一源码 → 按源码规则）；
+  - 源码（`src/**` 等）仍要求 `exec_running`；`pwsh` / `bash` 默认不守，是显式逃生通道；
+  - `enforce=always`（默认）对非 OpenFeel 工作区也拦截，可用 `project` / `off` opt-out。
+- **审查归属**（v1.3.3）：REV 可挂 op（`stageId.op-xxx`）或挂 stage（`op = stageId`，无 op 的 fast 场景）；
+  stage 级 REV 参与 blocking 门，但**不参与** `flow attempt` / `flow retry`。
 
 ## 目录
 
 | 路径 | 内容 |
 |---|---|
+| `lib/guard.js` | 写入门禁：`enforce`、`.openfeel/**` 产物区、bootstrap 新增放行、doc/note 分层、apply_patch 目标解析 |
 | [`ACTION-GUIDE.md`](ACTION-GUIDE.md) | **给 OpenFeel 本体的操作指南**：剩余 5 项待办、验收标准、边界约定 |
 | `lib/index.js` | 插件入口（`name` / `inject` / `apply` / `normalizeConfig`） |
 | `lib/adapters/cli.js` | CLI 执行器：可执行文件解析、UTF-8/无色/无日志、退出码与 envelope 语义 |
@@ -42,7 +54,7 @@ OpenFeel 采用「核心层 + 适配器层」架构（`claude/`、`kilo/`、`.op
 | `lib/tools/shared.js` | 输出封装、参数编译、渲染 |
 | `lib/surface/command.js` | `/feel` 人类命令 |
 | `lib/surface/prompt.js` | `<feel_mode>` 系统提示段 |
-| `test/` | 契约 / 行为 / 真实注册表 三套验证（42 + 77 + 10 = 129 断言） |
+| `test/` | 契约 / 行为 / 门禁 / 真实注册表 四套验证（42 + 83 + 46 + 10 = 181 断言） |
 | `docs/compat/` | OpenFeel v1.2.1 逆向兼容性契约（6 份；仅供回归参照，权威以 [docs/json-contract.md](https://github.com/Liuary/OpenFeel/blob/master/docs/json-contract.md) 为准） |
 
 ## 验证
@@ -50,7 +62,8 @@ OpenFeel 采用「核心层 + 适配器层」架构（`claude/`、`kilo/`、`.op
 ```bash
 cd dsh
 node test/contract.js      # 42 — DSH schema 契约（真实 assertSupportedJsonSchema）
-node test/verify.js        # 77 — 行为（真实 CLI + 真实 .openfeel 副本）
+node test/verify.js        # 83 — 行为（真实 CLI + 真实 .openfeel 副本）
+node test/guard.js         # 46 — 写入门禁（fake ToolExecution + 临时工作区）
 node test/integration.js   # 10 — 真实 cordis + 真实 ToolRuntime 挂载
 ```
 

package/dsh/README.md

@@ -73,9 +73,13 @@ Windows 上的 `openfeel.cmd` 垫片。
         commandPrefix: []        # 从源码跑时：[node, <repo>/bin/openfeel.js]
         timeoutMs: 120000        # 单次调用超时
         log: false               # 是否写 ~/.openfeel/cli/logs/（默认关闭，只读沙箱更安全）
-        autoPrompt: true         # 是否注入 Feel 纪律系统提示段
+        autoPrompt: true         # 是否注入系统提示段
         language: zh-CN          # 提示段语言：zh-CN | en
         cwd: null                # 兜底工作目录（默认取会话工作区）
+        activation: auto         # auto=项目→完整纪律/非项目→bootstrap；always=完整纪律；off=不注入
+        enforce: always          # always=所有工作区守门禁；project=仅项目；off=完全不注册 guard
+        allowGeneral: true       # general 需求 in_progress 且无阶段时放行源码写入
+        # mutatingTools 默认 [edit, write, apply_patch, str_replace_editor]；pwsh 默认不守
 ```
 
 `normalizeConfig` 对非法值做安全回落（如 `timeoutMs: -5` → `120000`）。
@@ -184,24 +188,48 @@ provider 桥接层会把「只有 description、没有 type」的节点转成 `t
 
 段落正文每次装配时探测 `.openfeel/` 是否存在，因此提示会随工作区状态变化。
 
+`activation`：
+
+- `auto`（默认）：已初始化 → 完整 `<feel_mode>`；未初始化 → 短 bootstrap（只读可进行；写文件按 `enforce` 说明）。
+- `always`：所有工作区都注入完整 `<feel_mode>`（未初始化时 `detected:false`，不会误报已初始化）。
+- `off`：不注入任何提示（写入门禁仍可独立开启）。
+
+---
+
+## 6.5 写入门禁（v1.3.3）
+
+适配器在 `apply()` 中用 DSH 的 `ctx.tools.guard()` 注册同步守卫（`dsh/lib/guard.js`）：
+
+- **只守** `edit` / `write` / `apply_patch` / `str_replace_editor`。`feel_*`、`pwsh`、`read`、`todo_write` 等不受影响。
+- `.openfeel/**` 是**流程产物区**：plan / scheme / review 产物在任意阶段可写；但 `.openfeel/flow.json` 与 `.openfeel/**/status.md` **始终拒绝**（用 `feel_*`）。受保护路径按**会话工作区 `<cwd>`** 判定；执行阶段仍可编辑其他项目的 `.openfeel/`（不做跨项目全局保护）。
+- **v1.3.3 风险分层**——源码（`src/**` 等）仍要求存在 `exec_running` 阶段；**doc/note**（`docs/**` 与 `.md/.mdx/.txt/.rst/.adoc`）在无活跃阶段或非 `exec_running` 相位也放行；**混合目标从严**（任一源码 → 按源码规则）。
+- **bootstrap 例外（v1.3.3）**：无 `.openfeel/` 时，全部目标为**新增文件**（`apply_patch` 须全部 `*** Add File:`）→ 放行并提示补账本；已存在文件、`.openfeel/**`、Update/Delete/Move 仍拒绝（`enforce=always` 下）。`project`/`off` 放行。
+- `apply_patch` 解析所有 patch 头（`*** Update/Add/Delete File:`、`*** Move to:`、`---/+++`）；全部目标在 `.openfeel/**` 才内部放行，混合/无头保守拒绝。
+- `enforce=off` **完全不注册 guard**（连 flow.json/status.md 也不拦）。
+- `ctx.tools.guard` 缺失时记警告并降级；`ctx.effect` 负责 disposer，避免 HMR 累积。
+
+**逃生通道**：`pwsh` / `bash` 默认不守，仍可直接写盘；`enforce=always` 对非 OpenFeel 工作区较激进，可用 `project` / `off` opt-out。
+
 ---
 
 ## 7. 验证
 
-三套测试，全部本地可跑：
+四套测试，全部本地可跑：
 
 ```powershell
 cd plugin
 node test/contract.js       # DSH 契约：schema 子集、无 type:null、参数契约（42 项）
-node test/verify.js         # 行为：真实 CLI + 真实 .openfeel 副本（77 项）
+node test/verify.js         # 行为：真实 CLI + 真实 .openfeel 副本（83 项）
+node test/guard.js          # 写入门禁：fake ToolExecution + 临时工作区（36 项）
 node test/integration.js    # 真实注册表：真 cordis + 真 ToolRuntime 挂载（10 项）
 ```
 
 - `contract.js` 用宿主 asar 提取出的**真实** `assertSupportedJsonSchema`。
 - `verify.js` 对真实 OpenFeel 项目做只读校验，**所有写操作只打在 `os.tmpdir()` 副本上**，并断言原项目 `revision` 未被改动。
+- `guard.js` 覆盖 `off/project/always`、`.openfeel/**` 产物、`exec_running`、general 需求、apply_patch 混合/无头/Move 同块、受保护路径、bootstrap 文案等 36 条。
 - `integration.js` 构造真实 Cordis 上下文 + 真实 `ToolRuntime`，调用适配器 `apply()`，断言 13 个工具真的完成注册与投影。
 
-依赖提取：三套测试默认读 `%TEMP%\dsh-asar\dsh\node_modules\@deepseek-ai`（从宿主
+依赖提取：`contract.js` / `integration.js` 默认读 `%TEMP%\dsh-asar\dsh\node_modules\@deepseek-ai`（从宿主
 `app.asar` 解出的包）。缺失时 `contract.js` / `integration.js` 会跳过并说明。
 
 ---
@@ -215,6 +243,7 @@ dsh/                               # OpenFeel 仓库内的一等适配器目录
 ├── cordis.patch.yml       # 一行 insert：id=openfeel-feel, name=openfeel-dsh
 ├── lib/
 │   ├── index.js           # 插件入口：name / inject / apply / normalizeConfig
+│   ├── guard.js           # 写入门禁：enforce / .openfeel 产物区 / exec_running
 │   ├── adapters/
 │   │   ├── cli.js         # CLI 执行器：可执行文件解析、UTF-8/无色/无日志、退出码语义
 │   │   ├── workspace.js   # 会话工作区 = 项目根（与 CLI 一致，**不回溯**）
@@ -229,6 +258,7 @@ dsh/                               # OpenFeel 仓库内的一等适配器目录
 └── test/
     ├── contract.js        # DSH schema 契约
     ├── verify.js          # 行为验证（真实 CLI）
+    ├── guard.js           # 写入门禁矩阵（fake ToolExecution）
     └── integration.js     # 真实注册表挂载
 ```
 
@@ -245,7 +275,7 @@ dsh/                               # OpenFeel 仓库内的一等适配器目录
    在深层子目录返回空态可证 CLI 从不回溯）。判定项目以 `.openfeel/flow.json` 或
    `config.yaml` 为标记；`~/.openfeel/`（`openfeel setup` 的**全局家目录**）不含这些标记，
    因此不会被误判为项目。未命中项目时工具返回 `refusal` 并提示 `openfeel init`，
-   提示段则**完全不注入**。
+   提示段注入**短 bootstrap**（`activation=auto`）而非完整 Feel 纪律；`enforce=always` 时写文件也会被门禁拒绝。
    > 若需要 monorepo（子目录里工作），那应作为 OpenFeel CLI 的能力
    > （如 `openfeel project resolve --json`）由各适配器共享，而不是每个 harness 各写一套回溯。
 3. **CLI 契约（v1.3.0）**：`flow next --json` 提供调度决策；`flow status --json` 的
@@ -262,3 +292,9 @@ dsh/                               # OpenFeel 仓库内的一等适配器目录
 6. **超时**：默认单次 120s。超大 `flow.json`（数百 KB）的 `flow status` 可能接近上限。
 7. **不替代 agent 委派**：`feel_next` 给出负责 Agent 与 `[HANDOFF: agent]` 标记，实际派发
    由 DSH 的 `subagent` / `workflow` 完成——DSH 没有 OpenFeel 的 `Task` 语义。
+8. **硬门禁只覆盖文件修改工具**：`edit` / `write` / `apply_patch` / `str_replace_editor`；
+   `pwsh` / `bash` 默认不守，仍可直接写盘（显式逃生通道）。若需要 shell 级策略，属于后续
+   `guardShell` 的独立设计。
+9. **默认 `enforce=always` 较激进**：所有工作区（含非 OpenFeel）都会拦截文件写入，直到
+   `openfeel init` 或用户把 profile 的 `enforce` 改为 `project` / `off`。适合“OpenFeel 必须启用”
+   的机器；普通试用建议 `project`。

package/dsh/cordis.patch.yml

@@ -24,3 +24,17 @@
         autoPrompt: true
         # 系统提示段语言：zh-CN | en
         language: zh-CN
+        # 未初始化工作区的提示策略：
+        #   auto   = 已初始化→完整 Feel 纪律；未初始化→短 bootstrap（默认）
+        #   always = 所有工作区都注入完整 Feel 纪律
+        #   off    = 不注入任何提示
+        activation: auto
+        # 写入门禁（ctx.tools.guard）：
+        #   always  = 所有工作区都拦截（默认；无 .openfeel 时也会拒绝写文件）
+        #   project = 仅当会话工作区本身是 OpenFeel 项目时拦截
+        #   off     = 完全不注册 guard（含 flow.json/status.md 也不拦）
+        enforce: always
+        # general 需求在 in_progress 且无阶段时，允许源码写入（需求级例外）。
+        allowGeneral: true
+        # mutatingTools 默认：[edit, write, apply_patch, str_replace_editor]。
+        # 需要时显式覆盖；pwsh/bash 默认不守（显式逃生通道）。

package/dsh/lib/adapters/dashboard.js

@@ -191,7 +191,7 @@ export async function readSnapshot(cli, options = {}) {
       /** 相位标签由 `flow next` 下发；无权威值时退化为相位名（不维护本地映射）。 */
       phaseLabel: typeof next?.phaseLabel === 'string' ? next.phaseLabel : focusPhase,
       status: focusStage?.status ?? '',
-      deps: Array.isArray(focusStage?.deps) ? focusStage.deps : [],
+      deps: Array.isArray(focusStage?.deps) ? [...focusStage.deps] : [],
       ops: focusStage?.ops ?? {},
       checkpoint: CHECKPOINT_OF_PHASE[focusPhase] ?? '',
       /** 负责该相位的 Agent（CLI 权威字段；无 flow next 时为 unknown）。 */
@@ -229,7 +229,7 @@ export async function readSnapshot(cli, options = {}) {
       id: stage.id ?? stage.name ?? '',
       phase: stage.phase ?? '',
       status: stage.status ?? '',
-      deps: Array.isArray(stage.deps) ? stage.deps : [],
+      deps: Array.isArray(stage.deps) ? [...stage.deps] : [],
       workflowMode: stage.workflowMode ?? stage.workflow_mode ?? null,
       requirementId: stage.requirementId ?? null,
       reviewTier: stage.reviewTier ?? null,