openfeel 1.3.5 → 1.5.1

package/dsh/lib/adapters/dashboard.js

@@ -349,6 +349,7 @@ export function planNextStep(snapshot) {
       legalNextPhases: [],
       suggestedCommand: focus.suggestedCommand ?? null,
       guards,
+      statusSync: snapshot.statusSync ?? null,
       adapterHints: [],
       cli: focus.suggestedCommand ?? (allDone ? 'openfeel flow status' : 'openfeel plan stage list'),
       toolCall: null,
@@ -365,6 +366,10 @@ export function planNextStep(snapshot) {
   if (phase === 'review_failed' || phase === 'test_failed') {
     adapterHints.push('失败回环：决定「重试 / 回退重定方案 / 请求人工介入」，并把结论记入 REV 条目。');
   }
+  // v1.5.0：状态记录到期只提示，不阻塞；CLI advance 会在节点自动同步。
+  if (snapshot.statusSync?.due === true) {
+    adapterHints.push('状态记录已超过 30 分钟：更新交接摘要（仅 Feel）后运行 `openfeel dev sync`；CLI 在节点/到期时会自动同步。');
+  }
 
   const cliCommand = typeof focus.suggestedCommand === 'string' && focus.suggestedCommand !== ''
     ? focus.suggestedCommand
@@ -382,6 +387,7 @@ export function planNextStep(snapshot) {
     legalNextPhases: nextPhases,
     suggestedCommand: focus.suggestedCommand ?? null,
     guards,
+    statusSync: snapshot.statusSync ?? null,
     adapterHints,
     cli: cliCommand,
     toolCall: nextPhases.length === 0

package/dsh/lib/adapters/dev-status.js

@@ -0,0 +1,40 @@
+/**
+ * dev 状态同步（v1.5.0，适配器侧只读）
+ *
+ * 与 CLI `openfeel dev status` 同源：读 `.openfeel/dev/.sync.json` 判断是否到期；
+ * 只读，不写盘。用于 feel_next / feel_status 暴露 statusSync.due。
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+/** 默认同步间隔（分钟） */
+export const DEFAULT_SYNC_INTERVAL_MINUTES = 30;
+
+/**
+ * 读取状态同步快照（缺失/损坏 → due=true 且 lastSync=null）。
+ * @param {string} projectRoot
+ * @param {number} [now]
+ * @returns {{ due: boolean, lastSync: string|null, intervalMinutes: number }}
+ */
+export function readStatusSync(projectRoot, now = Date.now()) {
+  const file = join(projectRoot, '.openfeel', 'dev', '.sync.json');
+  let lastSync = null;
+  let intervalMinutes = DEFAULT_SYNC_INTERVAL_MINUTES;
+  try {
+    if (existsSync(file)) {
+      const raw = JSON.parse(readFileSync(file, 'utf-8'));
+      if (typeof raw.last_sync === 'string') lastSync = raw.last_sync;
+      if (typeof raw.interval_minutes === 'number' && raw.interval_minutes > 0) {
+        intervalMinutes = raw.interval_minutes;
+      }
+    }
+  } catch {
+    /* 损坏 → 视为到期 */
+  }
+  let due = true;
+  if (lastSync !== null) {
+    const last = Date.parse(lastSync);
+    due = !Number.isFinite(last) || now - last >= intervalMinutes * 60_000;
+  }
+  return { due, lastSync, intervalMinutes };
+}

package/dsh/lib/guard.js

@@ -14,7 +14,7 @@
  * @module openfeel-dsh/guard
  */
 
-import { existsSync, readFileSync, statSync } from 'node:fs';
+import { appendFileSync, existsSync, mkdirSync, readFileSync, statSync } from 'node:fs';
 import { basename, extname, join, resolve } from 'node:path';
 
 import { isProjectWorkspace, OPENFEEL_DIR } from './adapters/workspace.js';
@@ -43,6 +43,25 @@ export function normalizeForComparison(value, platform = process.platform) {
 /** 文档/笔记类扩展名（写门禁按产物类型分层：doc/note 不绑相位）。 */
 export const DOC_EXTENSIONS = Object.freeze(['.md', '.mdx', '.txt', '.rst', '.adoc']);
 
+/**
+ * 静态展示资源扩展名（v1.4.0；与 doc 同层：任意相位可写，不要求活跃阶段）。
+ * 依据：反馈 `openfeel-write-gate-friction-2026-10-30.md` —— UI 微调无执行语义。
+ */
+export const PRESENTATIONAL_EXTENSIONS = Object.freeze([
+  '.css', '.scss', '.html', '.svg', '.png', '.jpg', '.jpeg', '.webp',
+]);
+
+/**
+ * 源码扩展名（v1.4.0）：`assets/**` / `public/**` 的目录豁免**不得**覆盖这些扩展名，
+ * 保证「源码仍严格要求 exec_running」这条底线（`assets/gen.ts` 仍是源码）。
+ */
+export const SOURCE_EXTENSIONS = Object.freeze([
+  '.rs', '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.py',
+  '.go', '.java', '.rb', '.c', '.cc', '.cpp', '.h', '.hpp', '.cs',
+  '.php', '.swift', '.kt', '.kts', '.scala', '.sh', '.bash', '.ps1',
+  '.lua', '.dart', '.ex', '.exs',
+]);
+
 /**
  * 是否为文档/笔记类目标（P0-4）：扩展名命中，或位于**工作区根级 `docs/`** 下。
  * v1.3.3 复核：`docs` 必须直接位于会话工作区下（`src/docs/x.ts` 不算文档，防源码借名绕过相位门）。
@@ -69,6 +88,77 @@ function isUnderWorkspace(absolute, cwd) {
   return absolute === cwd || absolute.startsWith(`${cwd}\\`) || absolute.startsWith(`${cwd}/`);
 }
 
+/**
+ * 是否为**静态展示资源**（v1.4.0；与 doc 同层豁免）。
+ *
+ * 命中条件（任一）：
+ * - 扩展名 ∈ `PRESENTATIONAL_EXTENSIONS`（css/scss/html/svg/png/jpg/jpeg/webp）；
+ * - 路径任一段为 `assets` 或 `public`（支持 `crates/cli/assets/index.html` 这类嵌套资产目录）。
+ *
+ * 源码扩展名（`.rs/.ts/.js/.py` 等）不在此列；混合目标仍按源码规则从严。
+ * @param {string} absolute 已归一化绝对路径
+ * @returns {boolean}
+ */
+export function isPresentationalAssetPath(absolute) {
+  const ext = extname(absolute).toLowerCase();
+  if (PRESENTATIONAL_EXTENSIONS.includes(ext)) return true;
+  // 目录豁免不覆盖源码扩展名（`assets/gen.ts` 仍按源码门禁）。
+  if (SOURCE_EXTENSIONS.includes(ext)) return false;
+  const segments = absolute.split(/[\\/]/);
+  return segments.includes('assets') || segments.includes('public');
+}
+
+/** doc + 静态展示资源合并豁免判据（v1.4.0）。 */
+function isExemptPath(absolute, cwd) {
+  return isDocPath(absolute, cwd) || isPresentationalAssetPath(absolute);
+}
+
+/**
+ * 写入门禁审计（v1.4.0）：豁免放行时追加 JSONL 到 `.openfeel/log/guard-audit.jsonl`。
+ * best-effort：任何写失败都吞掉，不影响放行结果。
+ * @param {string} cwd 已归一化工作区
+ * @param {{ tool: string, reason: 'doc-asset'|'chore', phase: string, paths: string[] }} event
+ */
+function recordGuardAudit(cwd, event) {
+  try {
+    const logDir = join(cwd, '.openfeel', 'log');
+    if (!existsSync(logDir)) {
+      mkdirSync(logDir, { recursive: true });
+    }
+    const entry = {
+      time: new Date().toISOString(),
+      event: 'guard_allow',
+      tool: event.tool,
+      reason: event.reason,
+      phase: event.phase,
+      paths: event.paths,
+    };
+    appendFileSync(join(logDir, 'guard-audit.jsonl'), `${JSON.stringify(entry)}\n`, 'utf-8');
+  } catch {
+    /* 审计写失败不阻塞放行 */
+  }
+}
+
+/**
+ * 读取 chore 写窗口（v1.4.0；`.openfeel/chore.json`）。
+ * 仅当文件存在、JSON 合法且 `expires_at` 未过期时返回对象，否则 null。
+ * @param {string} cwd 已归一化工作区
+ * @returns {{ id?: string, note?: string, expires_at?: string } | null}
+ */
+function readActiveChore(cwd) {
+  try {
+    const chorePath = join(cwd, '.openfeel', 'chore.json');
+    if (!existsSync(chorePath)) return null;
+    const raw = JSON.parse(readFileSync(chorePath, 'utf-8'));
+    if (typeof raw !== 'object' || raw === null) return null;
+    const expiresAt = typeof raw.expires_at === 'string' ? Date.parse(raw.expires_at) : NaN;
+    if (!Number.isFinite(expiresAt) || expiresAt <= Date.now()) return null;
+    return raw;
+  } catch {
+    return null;
+  }
+}
+
 /** flow.json 读取缓存（path → { mtimeMs, size, value }）。 */
 const flowCache = new Map();
 
@@ -340,7 +430,8 @@ export function createOpenFeelGuard(options = {}) {
     }
 
     const targets = rawTargets.map((target) => normalizeTarget(resolvedCwd, target));
-    const allDoc = targets.every((target) => isDocPath(target, normalizedCwd));
+    // doc + 静态展示资源合并豁免（v1.4.0）；混合目标须**全部**命中豁免才放行
+    const allExempt = targets.every((target) => isExemptPath(target, normalizedCwd));
 
     // 受保护路径：guard 启用时始终拒绝（enforce=off 已提前返回）。
     if (targets.some((target) => isProtectedPath(target, normalizedCwd))) {
@@ -394,8 +485,17 @@ export function createOpenFeelGuard(options = {}) {
     const active = activeStages(flow.value);
     if (active.length === 0) {
       if (allowGeneral && hasGeneralRequirement(flow.value)) return undefined;
-      // P0-4：doc/note 类产物不要求活跃阶段（收口后仍可写文档）；混合目标从严。
-      if (allDoc) return undefined;
+      // v1.4.0 chore 通道：仅在**无活跃阶段**时生效；受保护路径已在上方拒绝。
+      const chore = readActiveChore(normalizedCwd);
+      if (chore !== null) {
+        recordGuardAudit(normalizedCwd, { tool: name, reason: 'chore', phase: 'done', paths: targets });
+        return undefined;
+      }
+      // P0-4/v1.4.0：doc/note 与静态展示资源不要求活跃阶段（收口后仍可写）；混合目标从严。
+      if (allExempt) {
+        recordGuardAudit(normalizedCwd, { tool: name, reason: 'doc-asset', phase: 'done', paths: targets });
+        return undefined;
+      }
       return t(
         'OpenFeel 写入门禁：当前无活跃阶段，不能修改源码/文档。请先 feel_req add → claim → feel_stage add 建立阶段。',
         'OpenFeel write guard: no active stage, so source/docs are read-only. Create a stage via feel_req add → claim → feel_stage add.',
@@ -403,8 +503,14 @@ export function createOpenFeelGuard(options = {}) {
     }
 
     if (active.some((stage) => stage.phase === 'exec_running')) return undefined;
-    // P0-4：非 exec 相位仍允许 doc/note（研究记录、设计文档等）；代码仍严格。
-    if (allDoc) return undefined;
+    // P0-4/v1.4.0：非 exec 相位仍允许 doc/note 与静态展示资源（研究记录、设计文档、UI 资源等）；源码仍严格。
+    if (allExempt) {
+      const phases = active
+        .map((stage) => `${stage.id ?? '(unknown)'}=${stage.phase ?? '(unknown)'}`)
+        .join(', ');
+      recordGuardAudit(normalizedCwd, { tool: name, reason: 'doc-asset', phase: phases, paths: targets });
+      return undefined;
+    }
 
     const summary = active
       .map((stage) => `${stage.id ?? '(unknown)'}=${stage.phase ?? '(unknown)'}`)

package/dsh/lib/surface/prompt.js

@@ -141,6 +141,11 @@ Feel（你）只做编排、决策与门禁判断。
 - **归档判据不可协商**：版本归档要求该版本**全部阶段 done** 且**无 blocking open REV**，没有 force 覆盖。归档由 CLI 执行，调度侧只提示不代劳。
 - **不主动读归档**：常规调度不要读 \`.openfeel/flow-archive/**\`（防上下文污染）；需要历史时用 \`feel_archive action=show\`。
 
+## 状态与记录（v1.5.0）
+- **只有 Feel 写状态**：\`dev_last*\`、\`dev/current.md\`、\`status.md\`、\`flow.json\` 只由 Feel 更新；**子 agent 一律不读不写**（上下文由派发 prompt / 交接文档提供）。
+- **日志不强制**：不写流水账；\`flow.json.log\` 由 CLI 自动维护（仅保留最近 200 条）。跨会话信息用一条 ≤5 行交接摘要。
+- **更新节点**：开始 / 转折 / 结束，或 \`statusSync.due=true\`（默认 30 分钟）时更新一次交接摘要，随后运行 \`openfeel dev sync\`（CLI 在节点/到期时也会自动同步）。
+
 ## 三种工作流模式
 - \`full\`：plan → plan_review → scheme → exec → review → test → archive，六道关全走。
 - \`fast\`：跳过 \`scheme_*\` 与 \`test_*\`；**计划审查与代码审查各保留一轮**（fast 不等于免审）。
@@ -196,6 +201,11 @@ planner / schemer / executor / reviewer / feel-tester / archiver. **The authorit
 - **Archive criteria are not negotiable**: a version archive requires every stage of that version to be \`done\` AND no blocking open REV; there is no force override. The CLI performs the archive; you only prompt.
 - **Do not read archives during normal scheduling**: avoid \`.openfeel/flow-archive/**\`; use \`feel_archive action=show\` on demand.
 
+## State & records (v1.5.0)
+- **Only Feel writes state**: \`dev_last*\`, \`dev/current.md\`, \`status.md\`, \`flow.json\` are updated by Feel only; **subagents never read or write them** (context comes from the dispatch prompt / handoff docs).
+- **No mandatory logs**: do not keep a per-step diary; \`flow.json.log\` is maintained by the CLI (last 200 entries only). For cross-session info, write a <=5-line handoff summary.
+- **Update nodes**: start / turning point / end, or when \`statusSync.due=true\` (default 30 min) — update the handoff summary once, then run \`openfeel dev sync\` (the CLI also auto-syncs on nodes/expiry).
+
 ## The three workflow modes
 - \`full\`: plan → plan_review → scheme → exec → review → test → archive (all six gates).
 - \`fast\`: skips \`scheme_*\` and \`test_*\`; **plan review and code review each keep one round** (fast is not review-free).

package/dsh/lib/tools/index.js

@@ -13,6 +13,7 @@
 
 import { FeelError } from '../adapters/cli.js';
 import { legalNextPhases, planNextStep, readSnapshot } from '../adapters/dashboard.js';
+import { readStatusSync } from '../adapters/dev-status.js';
 import { resolveWorkspace } from '../adapters/workspace.js';
 import {
   boolean,
@@ -152,6 +153,7 @@ export function createTools(context) {
           withRequirements: args.with_requirements === true,
         });
         snapshot.project.root = resolved.cwd;
+        snapshot.statusSync = readStatusSync(resolved.cwd);
         const focus = snapshot.focus;
         return {
           data: snapshot,
@@ -182,6 +184,7 @@ export function createTools(context) {
       return envelope('next', async () => {
         const snapshot = await readSnapshot(cli, { cwd: resolved.cwd, signal: exec.signal });
         snapshot.project.root = resolved.cwd;
+        snapshot.statusSync = readStatusSync(resolved.cwd);
         const plan = planNextStep(snapshot);
         return {
           data: plan,

package/dsh/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openfeel-dsh",
-  "version": "1.3.5",
+  "version": "1.5.1",
   "description": "OpenFeel × DSH — Feel 模式适配器：把 OpenFeel 的流水线、需求分发、版本归档与知识库接入 DeepSeek Harness",
   "type": "module",
   "private": true,
@@ -32,7 +32,7 @@
   },
   "openfeel": {
     "adapter": "dsh",
-    "requiresCli": ">=1.3.5"
+    "requiresCli": ">=1.5.1"
   },
   "keywords": [
     "openfeel",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openfeel",
-  "version": "1.3.5",
+  "version": "1.5.1",
   "description": "AI Agent 开发流程治理 CLI 工具",
   "type": "module",
   "private": false,