@winspan/claude-forge 0.6.9 → 0.7.1

package/dist/utils/stage-trace.js

@@ -0,0 +1,125 @@
+/**
+ * Stage 执行透明度追踪
+ * 记录每个 Stage 的决策依据、执行动作、产出结果
+ */
+/**
+ * Stage 追踪日志器
+ * 提供结构化的 Stage 执行记录能力
+ */
+export class StageTraceLogger {
+    traces = [];
+    /** 开始追踪一个 Stage */
+    start(stage, index) {
+        this.traces.push({
+            stage,
+            index,
+            startTs: Date.now(),
+            status: 'running',
+        });
+    }
+    /** 记录决策依据 */
+    recordDecision(stage, basis, reason) {
+        const trace = this.findTrace(stage);
+        if (trace) {
+            trace.decisionBasis = basis;
+            trace.decisionReason = reason;
+        }
+    }
+    /** 记录执行动作 */
+    recordAction(stage, action) {
+        const trace = this.findTrace(stage);
+        if (trace) {
+            trace.executionAction = action;
+        }
+    }
+    /** 记录执行结果 */
+    recordResult(stage, result) {
+        const trace = this.findTrace(stage);
+        if (trace) {
+            trace.executionResult = result;
+        }
+    }
+    /** 标记 Stage 成功完成 */
+    success(stage) {
+        const trace = this.findTrace(stage);
+        if (trace) {
+            trace.status = 'success';
+            trace.endTs = Date.now();
+        }
+    }
+    /** 标记 Stage 降级处理 */
+    fallback(stage, error) {
+        const trace = this.findTrace(stage);
+        if (trace) {
+            trace.status = 'fallback';
+            trace.error = error;
+            trace.endTs = Date.now();
+        }
+    }
+    /** 标记 Stage 失败 */
+    error(stage, error) {
+        const trace = this.findTrace(stage);
+        if (trace) {
+            trace.status = 'error';
+            trace.error = error;
+            trace.endTs = Date.now();
+        }
+    }
+    /** 标记 Stage 跳过 */
+    skip(stage) {
+        const trace = this.findTrace(stage);
+        if (trace) {
+            trace.status = 'skipped';
+            trace.endTs = Date.now();
+        }
+    }
+    /** 获取所有追踪记录 */
+    getTraces() {
+        return this.traces;
+    }
+    /** 获取简明摘要（用户友好） */
+    getSummary() {
+        const lines = [];
+        for (const trace of this.traces) {
+            const duration = trace.endTs ? `${trace.endTs - trace.startTs}ms` : '进行中';
+            const statusIcon = this.getStatusIcon(trace.status);
+            lines.push(`${statusIcon} [${trace.index}] ${trace.stage} (${duration})`);
+            if (trace.decisionReason) {
+                lines.push(`  决策：${trace.decisionReason}`);
+            }
+            if (trace.executionAction) {
+                lines.push(`  动作：${trace.executionAction}`);
+            }
+            if (trace.executionResult?.summary) {
+                lines.push(`  结果：${trace.executionResult.summary}`);
+            }
+            if (trace.error) {
+                lines.push(`  错误：${trace.error}`);
+            }
+        }
+        return lines.join('\n');
+    }
+    /** 获取完整 JSON（调试用） */
+    getJSON() {
+        return JSON.stringify(this.traces, null, 2);
+    }
+    findTrace(stage) {
+        // 从后往前找，支持同名 Stage 多次执行
+        for (let i = this.traces.length - 1; i >= 0; i--) {
+            if (this.traces[i].stage === stage && this.traces[i].status === 'running') {
+                return this.traces[i];
+            }
+        }
+        return undefined;
+    }
+    getStatusIcon(status) {
+        switch (status) {
+            case 'success': return '✓';
+            case 'fallback': return '⚠';
+            case 'error': return '✗';
+            case 'skipped': return '○';
+            case 'running': return '●';
+        }
+    }
+}
+//# sourceMappingURL=stage-trace.js.map

package/dist/utils/stage-trace.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@winspan/claude-forge",
-  "version": "0.6.9",
+  "version": "0.7.1",
   "description": "SDLC intelligent orchestration engine for Claude Code",
   "main": "dist/cli/index.js",
   "type": "module",