openfeel 1.5.3 → 1.5.4

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.4**（批次：日志摘要 + 快照 revision/stale + 指标 + 闸门滥用提示） — ① `flow log` 追加阶段摘要（最近转换 / 失败 / resume）；② `feel_status`/`feel_next` 返回快照 `revision`/`stale`；③ `flow metrics` 观测日志体积；④ `plan_pending` >10 分钟提示空转。无 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;AAuBpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8nF1D;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,OAAO,EAAE,iBAAiB,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAE9G"}

package/dist/commands/flow.js

@@ -471,6 +471,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
@@ -1416,6 +1428,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