openfeel 1.5.3 → 1.5.5

package/README.md

@@ -10,7 +10,7 @@
 
 OpenFeel 是一个 TypeScript CLI 工具，为 AI Agent 开发提供端到端的流程治理。核心理念：**「提示词瘦身，流程入工具」** —— Agent 不靠读长文本理解流程，而是通过 `flow.json` 获取当前状态和下一步指令。
 
-> 📦 **最新版本 v1.5.3**（批次：派发契约 + 恢复包 + 结构化交接 + 同步去重） — ① `feel_next.dispatch` 统一派发信封（子 agent 禁读状态文件、返回 ≤10 行）；② `feel_status.recovery` 一次拿到 lastTransition / 交接摘要 / nextAction；③ 交接摘要采用 `done/next/block` 固定键；④ 状态未变时 `dev sync` 不重写 dev_last。发布节奏改为**批次发布**（小功能合并，不再单功能发版）。版本能力概览见 [docs/VERSIONS.md](docs/VERSIONS.md)。
+> 📦 **最新版本 v1.5.5**（批次：preflight 账本 + 适配器补闸 + 禁止 shell 写状态 + 审查独立性） — ① `flow next`/`flow status` 记录 preflight，写命令校验 10 分钟窗口；② DSH 适配器默认 strict，`feel_status`/`feel_next` 返回 `preflight`；③ 提示段禁止 shell 写状态命令、要求独立审查（自审标 `self-review`）。无 JSON 契约变更；批次发布。版本能力概览见 [docs/VERSIONS.md](docs/VERSIONS.md)。
 
 > 📌 本项目基于 [AI_Prompt](https://github.com/Liuary/AI_Prompt) 开发，参考了 [OpenSpec](https://github.com/Fission-AI/OpenSpec) 等工具的设计思路。
 

package/dist/commands/flow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../../src/commands/flow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuBpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAimF1D;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,OAAO,EAAE,iBAAiB,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAE9G"}
+{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../../src/commands/flow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2oF1D;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,OAAO,EAAE,iBAAiB,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAE9G"}

package/dist/commands/flow.js

@@ -12,6 +12,7 @@ import { addReviewEntry } from '../core/view/entry.js';
 import { failCli, failInternal, failRefusal, handleAddStageError, handleConcurrentConflict } from './shared/errors.js';
 import { withSchemaVersion, isJsonMode, emitJson } from './shared/json-output.js'; // JSON 契约助手（stage-95 op-001/op-002）
 import { t, getCliLang } from '../core/i18n.js';
+import { preflightGate, recordPreflight } from '../core/preflight.js';
 import { getDevStatus, isSyncNodePhase, syncDevStatus } from '../core/dev-status.js';
 import { ARCHIVE_SCHEMA_VERSION } from '../core/flow-archive/archive-file.js';
 import { listArchivableCandidates, listBlockingOpenRevsForVersion, splitForArchive } from '../core/flow-archive/grouping.js';
@@ -32,6 +33,8 @@ export function registerFlowCommand(program) {
         .action((options) => {
         const lang = getCliLang(process.cwd());
         const mgr = createManager();
+        if (mgr.isLoaded())
+            recordPreflight(process.cwd());
         // B1-1：--json 分支须为首行输出且纯 JSON 单文档（不打印标题/颜色/提示行）
         if (options.json) {
             console.log(JSON.stringify(buildStatusJson(mgr), null, 2));
@@ -158,6 +161,7 @@ export function registerFlowCommand(program) {
             return;
         }
         const data = mgr.getData();
+        recordPreflight(process.cwd());
         const rawStage = data.pipeline.current.stage || '';
         // 双键回退（与 core resolveCurrentPhase / advanceStagePhase 同范式）：归一化键优先，其次原始键
         const normalized = rawStage ? (normalizeStageId(rawStage) ?? rawStage) : '';
@@ -471,6 +475,18 @@ export function registerFlowCommand(program) {
             return;
         }
         console.log(store.summary(lang));
+        // v1.5.4：观测代理指标（人类输出；--json 键集不变）
+        const mgr = new FlowManager(process.cwd());
+        if (mgr.isLoaded()) {
+            const logStats = mgr.getLogStats();
+            const data = mgr.getData();
+            const active = data ? Object.values(data.stages).filter((stage) => stage.phase !== 'done').length : 0;
+            const en = lang === 'en';
+            console.log('');
+            console.log(en ? '── Observability ──' : '── 观测指标 ──');
+            console.log(`  ${en ? 'flow.log' : 'flow.log'}: ${logStats.entries} entries / ${logStats.bytes} bytes`);
+            console.log(`  ${en ? 'active stages' : '活跃阶段'}: ${active}`);
+        }
     });
     // flow phases — 自描述：列出全部合法 phase 与运行时转移表
     flow
@@ -908,6 +924,17 @@ export function registerFlowCommand(program) {
             failCli({ code: 'NO_INIT', message, detail: null, stderrLines: [message] });
             return;
         }
+        // v1.5.5：先读状态再写状态（strict 拒绝；warn 仅 TTY 提示）
+        const preflight = preflightGate(process.cwd(), t('flow.preflightRequiredTmpl', lang));
+        if (!preflight.ok) {
+            failCli({
+                code: 'INVALID_ARGUMENT',
+                message: preflight.message,
+                detail: { reason: 'preflight-required', hint: 'openfeel flow next --json' },
+                stderrLines: [preflight.message],
+            });
+            return;
+        }
         // REV-005：命令层归一化（短名 → 全名），与 plan.ts / flow.ts 其它 stage 解析点同范式
         const stageArg = normalizeStageId(options.stage) ?? options.stage;
         // P1-4：双开关**显式**组合不一致 → 显式告警（仅「auto + auto_advance=disabled」这一静默无效组合；
@@ -1416,6 +1443,22 @@ export function registerFlowCommand(program) {
             }
             console.log('');
         }
+        // v1.5.4：阶段摘要（从最近 200 条日志派生；人类输出，不改 --json 契约）
+        const activeStage = data.pipeline.current.stage
+            || Object.entries(data.stages).find(([, stage]) => stage.phase !== 'done')?.[0]
+            || '';
+        if (activeStage !== '') {
+            const s = mgr.getStageLogSummary(activeStage);
+            const en = lang === 'en';
+            console.log(en ? `── Stage summary: ${activeStage} ──` : `── 阶段摘要：${activeStage} ──`);
+            if (s.lastTransition !== null) {
+                console.log(`  ${en ? 'last transition' : '最近转换'}: ${s.lastTransition.from} → ${s.lastTransition.to} @ ${s.lastTransition.time}`);
+            }
+            if (s.lastError !== null) {
+                console.log(`  ${en ? 'last failure' : '最近失败'}: ${s.lastError.phase} @ ${s.lastError.time}`);
+            }
+            console.log(`  ${en ? 'resume count' : 'resume 次数'}: ${s.resumeCount}`);
+        }
     });
     // flow review — 审查子命令组
     const reviewCmd = flow