@winspan/claude-forge 0.6.8 → 0.7.0

package/dist/utils/error-handler.js

@@ -0,0 +1,155 @@
+import { logger } from './logger.js';
+/** 错误类型分类 */
+export var ErrorType;
+(function (ErrorType) {
+    /** 网络错误（可重试） */
+    ErrorType["NETWORK"] = "network";
+    /** 速率限制（可重试，需延迟） */
+    ErrorType["RATE_LIMIT"] = "rate_limit";
+    /** 超时（可重试） */
+    ErrorType["TIMEOUT"] = "timeout";
+    /** 数据库错误（可重试） */
+    ErrorType["DATABASE"] = "database";
+    /** 业务逻辑错误（不可重试） */
+    ErrorType["BUSINESS"] = "business";
+    /** 未知错误 */
+    ErrorType["UNKNOWN"] = "unknown";
+})(ErrorType || (ErrorType = {}));
+/** 默认错误策略 */
+const DEFAULT_STRATEGIES = {
+    [ErrorType.NETWORK]: {
+        retryable: true,
+        maxRetries: 3,
+        retryDelayMs: 1000,
+        exponentialBackoff: true,
+    },
+    [ErrorType.RATE_LIMIT]: {
+        retryable: true,
+        maxRetries: 2,
+        retryDelayMs: 5000,
+        exponentialBackoff: false,
+    },
+    [ErrorType.TIMEOUT]: {
+        retryable: true,
+        maxRetries: 2,
+        retryDelayMs: 2000,
+        exponentialBackoff: true,
+    },
+    [ErrorType.DATABASE]: {
+        retryable: true,
+        maxRetries: 3,
+        retryDelayMs: 500,
+        exponentialBackoff: true,
+    },
+    [ErrorType.BUSINESS]: {
+        retryable: false,
+        maxRetries: 0,
+        retryDelayMs: 0,
+        exponentialBackoff: false,
+    },
+    [ErrorType.UNKNOWN]: {
+        retryable: true,
+        maxRetries: 1,
+        retryDelayMs: 1000,
+        exponentialBackoff: false,
+    },
+};
+/** 错误分类器 */
+export function classifyError(error) {
+    if (!(error instanceof Error))
+        return ErrorType.UNKNOWN;
+    const message = error.message.toLowerCase();
+    const name = error.name.toLowerCase();
+    // 网络错误
+    if (message.includes('network') ||
+        message.includes('econnrefused') ||
+        message.includes('enotfound') ||
+        message.includes('etimedout') ||
+        name.includes('fetch')) {
+        return ErrorType.NETWORK;
+    }
+    // 速率限制
+    if (message.includes('rate limit') ||
+        message.includes('too many requests') ||
+        message.includes('429')) {
+        return ErrorType.RATE_LIMIT;
+    }
+    // 超时
+    if (message.includes('timeout') ||
+        message.includes('timed out') ||
+        name.includes('timeout')) {
+        return ErrorType.TIMEOUT;
+    }
+    // 数据库错误
+    if (message.includes('sqlite') ||
+        message.includes('database') ||
+        message.includes('locked') ||
+        message.includes('busy')) {
+        return ErrorType.DATABASE;
+    }
+    // 业务逻辑错误（明确标记的）
+    if (name.includes('business') || name.includes('validation')) {
+        return ErrorType.BUSINESS;
+    }
+    return ErrorType.UNKNOWN;
+}
+/** 延迟函数 */
+function delay(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/** 重试包装器 */
+export async function withRetry(fn, context, customStrategy) {
+    let lastError;
+    let attempt = 0;
+    while (true) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            const errorType = classifyError(error);
+            const strategy = { ...DEFAULT_STRATEGIES[errorType], ...customStrategy };
+            attempt++;
+            if (!strategy.retryable || attempt > strategy.maxRetries) {
+                logger.error(`[错误处理] ${context} 失败（${errorType}），已达最大重试次数 ${strategy.maxRetries}`);
+                throw error;
+            }
+            const delayMs = strategy.exponentialBackoff
+                ? strategy.retryDelayMs * Math.pow(2, attempt - 1)
+                : strategy.retryDelayMs;
+            logger.warn(`[错误处理] ${context} 失败（${errorType}），${delayMs}ms 后重试（${attempt}/${strategy.maxRetries}）：${error}`);
+            await delay(delayMs);
+        }
+    }
+}
+/** 带降级的执行包装器 */
+export async function withFallback(fn, fallback, context) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        logger.warn(`[错误处理] ${context} 失败，使用降级方案：${error}`);
+        return await fallback();
+    }
+}
+/** 组合：重试 + 降级 */
+export async function withRetryAndFallback(fn, fallback, context, customStrategy) {
+    try {
+        return await withRetry(fn, context, customStrategy);
+    }
+    catch (error) {
+        logger.warn(`[错误处理] ${context} 重试失败，使用降级方案：${error}`);
+        return await fallback();
+    }
+}
+/** 静默错误（仅记录日志，不抛出） */
+export async function withSilentError(fn, context, defaultValue) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        logger.debug(`[错误处理] ${context} 失败（已静默）：${error}`);
+        return defaultValue;
+    }
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/utils/error-handler.js.map

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

package/dist/utils/stage-trace.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Stage 执行透明度追踪
+ * 记录每个 Stage 的决策依据、执行动作、产出结果
+ */
+export interface StageTrace {
+    /** Stage 名称 */
+    stage: string;
+    /** Stage 索引（1-based） */
+    index: number;
+    /** 开始时间戳 */
+    startTs: number;
+    /** 结束时间戳 */
+    endTs?: number;
+    /** 执行状态 */
+    status: 'running' | 'success' | 'fallback' | 'error' | 'skipped';
+    /** 决策依据：使用了哪些规范/规则/上下文 */
+    decisionBasis?: {
+        conventions?: string[];
+        rules?: string[];
+        context?: string[];
+    };
+    /** 决策原因：为什么做这个决定 */
+    decisionReason?: string;
+    /** 执行动作：具体做了什么 */
+    executionAction?: string;
+    /** 执行结果：产出了什么 */
+    executionResult?: {
+        type: 'terminate' | 'continue' | 'skip';
+        artifact?: string;
+        summary?: string;
+    };
+    /** 错误信息（如果失败） */
+    error?: string;
+}
+/**
+ * Stage 追踪日志器
+ * 提供结构化的 Stage 执行记录能力
+ */
+export declare class StageTraceLogger {
+    private traces;
+    /** 开始追踪一个 Stage */
+    start(stage: string, index: number): void;
+    /** 记录决策依据 */
+    recordDecision(stage: string, basis: {
+        conventions?: string[];
+        rules?: string[];
+        context?: string[];
+    }, reason: string): void;
+    /** 记录执行动作 */
+    recordAction(stage: string, action: string): void;
+    /** 记录执行结果 */
+    recordResult(stage: string, result: {
+        type: 'terminate' | 'continue' | 'skip';
+        artifact?: string;
+        summary?: string;
+    }): void;
+    /** 标记 Stage 成功完成 */
+    success(stage: string): void;
+    /** 标记 Stage 降级处理 */
+    fallback(stage: string, error: string): void;
+    /** 标记 Stage 失败 */
+    error(stage: string, error: string): void;
+    /** 标记 Stage 跳过 */
+    skip(stage: string): void;
+    /** 获取所有追踪记录 */
+    getTraces(): StageTrace[];
+    /** 获取简明摘要（用户友好） */
+    getSummary(): string;
+    /** 获取完整 JSON（调试用） */
+    getJSON(): string;
+    private findTrace;
+    private getStatusIcon;
+}
+//# sourceMappingURL=stage-trace.d.ts.map

package/dist/utils/stage-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-trace.d.ts","sourceRoot":"","sources":["../../src/utils/stage-trace.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,eAAe;IACf,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW;IACX,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;IACjE,0BAA0B;IAC1B,aAAa,CAAC,EAAE;QACd,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,oBAAoB;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB;IACjB,eAAe,CAAC,EAAE;QAChB,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,MAAM,CAAC;QACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAoB;IAElC,mBAAmB;IACnB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IASzC,aAAa;IACb,cAAc,CACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,EACvE,MAAM,EAAE,MAAM,GACb,IAAI;IAQP,aAAa;IACb,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAOjD,aAAa;IACb,YAAY,CACV,KAAK,EAAE,MAAM,EACb,MAAM,EAAE;QACN,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,MAAM,CAAC;QACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GACA,IAAI;IAOP,oBAAoB;IACpB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ5B,oBAAoB;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAS5C,kBAAkB;IAClB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IASzC,kBAAkB;IAClB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQzB,eAAe;IACf,SAAS,IAAI,UAAU,EAAE;IAIzB,mBAAmB;IACnB,UAAU,IAAI,MAAM;IAwBpB,qBAAqB;IACrB,OAAO,IAAI,MAAM;IAIjB,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,aAAa;CAStB"}

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.8",
+  "version": "0.7.0",
   "description": "SDLC intelligent orchestration engine for Claude Code",
   "main": "dist/cli/index.js",
   "type": "module",