@winspan/claude-forge 0.1.1

package/dist/utils/claude-api.js

@@ -0,0 +1,233 @@
+import Anthropic from '@anthropic-ai/sdk';
+/**
+ * API Key 获取优先级：
+ * 1. 显式传入的 apiKey
+ * 2. 配置文件中的 distill.api_key
+ * 3. 环境变量 ANTHROPIC_AUTH_TOKEN
+ * 4. 环境变量 ANTHROPIC_API_KEY
+ */
+function resolveApiKey(apiKey) {
+    if (apiKey && apiKey !== '')
+        return apiKey;
+    const envToken = process.env.ANTHROPIC_AUTH_TOKEN;
+    if (envToken)
+        return envToken;
+    const envKey = process.env.ANTHROPIC_API_KEY;
+    if (envKey)
+        return envKey;
+    throw new Error('Claude API key not found. Set ANTHROPIC_AUTH_TOKEN, ANTHROPIC_API_KEY, or configure distill.api_key');
+}
+function resolveBaseUrl() {
+    return process.env.ANTHROPIC_BASE_URL || undefined;
+}
+/**
+ * 查询代理支持的模型列表，自动选择最佳 claude-sonnet 模型
+ * 优先级：sonnet > opus > haiku，版本号越新越优先
+ */
+export async function detectBestModel(apiKey, baseUrl) {
+    try {
+        const key = resolveApiKey(apiKey);
+        const base = baseUrl || resolveBaseUrl();
+        if (!base)
+            return null; // 官方 API 不需要检测，用默认值即可
+        const url = `${base.replace(/\/$/, '')}/v1/models`;
+        const res = await fetch(url, {
+            headers: {
+                'Authorization': `Bearer ${key}`,
+                'x-api-key': key,
+                'anthropic-version': '2023-06-01',
+            },
+        });
+        if (!res.ok)
+            return null;
+        const data = await res.json();
+        const models = (data.data || []).map((m) => m.id).filter((id) => id.startsWith('claude-'));
+        // 优先选 sonnet，其次 opus，其次 haiku，版本号字典序降序取第一个
+        for (const tier of ['sonnet', 'opus', 'haiku']) {
+            const candidates = models.filter((m) => m.includes(tier)).sort().reverse();
+            if (candidates.length > 0)
+                return candidates[0];
+        }
+        return models.sort().reverse()[0] || null;
+    }
+    catch {
+        return null;
+    }
+}
+export class ApiTimeoutError extends Error {
+    constructor(timeoutMs) {
+        super(`API 调用超时（${timeoutMs}ms）`);
+        this.name = 'ApiTimeoutError';
+    }
+}
+export class CircuitOpenError extends Error {
+    constructor() {
+        super('熔断器已打开，API 调用被拒绝');
+        this.name = 'CircuitOpenError';
+    }
+}
+var CircuitState;
+(function (CircuitState) {
+    CircuitState["CLOSED"] = "closed";
+    CircuitState["OPEN"] = "open";
+    CircuitState["HALF_OPEN"] = "half_open";
+})(CircuitState || (CircuitState = {}));
+class CircuitBreaker {
+    state = CircuitState.CLOSED;
+    failureCount = 0;
+    lastFailureTime = 0;
+    failureThreshold = 5;
+    resetTimeoutMs = 60_000; // 60s
+    recordSuccess() {
+        this.failureCount = 0;
+        if (this.state === CircuitState.HALF_OPEN) {
+            this.state = CircuitState.CLOSED;
+        }
+    }
+    recordFailure() {
+        this.failureCount++;
+        this.lastFailureTime = Date.now();
+        if (this.failureCount >= this.failureThreshold) {
+            this.state = CircuitState.OPEN;
+        }
+    }
+    canAttempt() {
+        if (this.state === CircuitState.CLOSED)
+            return true;
+        if (this.state === CircuitState.HALF_OPEN)
+            return true;
+        // OPEN 状态：检查是否到达重置时间
+        if (Date.now() - this.lastFailureTime >= this.resetTimeoutMs) {
+            this.state = CircuitState.HALF_OPEN;
+            return true;
+        }
+        return false;
+    }
+    getState() {
+        return this.state;
+    }
+}
+export class ClaudeAPI {
+    client;
+    model;
+    circuitBreaker = new CircuitBreaker();
+    stats = {
+        totalCalls: 0,
+        totalErrors: 0,
+        totalLatencyMs: 0,
+        totalRetries: 0,
+        circuitBreakerTrips: 0,
+        byLabel: {},
+    };
+    constructor(apiKey, model = 'claude-sonnet-4-6', baseUrl) {
+        const resolvedKey = resolveApiKey(apiKey);
+        const baseURL = baseUrl || resolveBaseUrl();
+        this.client = new Anthropic({
+            apiKey: resolvedKey,
+            ...(baseURL ? { baseURL } : {}),
+        });
+        this.model = model;
+    }
+    /**
+     * @param label 调用方标识（用于统计分组），如 'distill' / 'intent' / 'resume'
+     * @param retries 最大重试次数（默认 2），指数退避：1s、2s
+     * @param timeoutMs 单次调用超时（默认 60s）
+     */
+    async complete(prompt, label = 'unknown', retries = 2, timeoutMs = 60_000) {
+        if (!this.circuitBreaker.canAttempt()) {
+            this.stats.circuitBreakerTrips++;
+            throw new CircuitOpenError();
+        }
+        const startMs = Date.now();
+        const bucket = this.stats.byLabel[label] ?? { calls: 0, errors: 0, latencyMs: 0, retries: 0 };
+        this.stats.byLabel[label] = bucket;
+        this.stats.totalCalls++;
+        bucket.calls++;
+        let lastErr;
+        for (let attempt = 0; attempt <= retries; attempt++) {
+            if (attempt > 0) {
+                this.stats.totalRetries++;
+                bucket.retries++;
+                await new Promise(r => setTimeout(r, 1000 * 2 ** (attempt - 1)));
+            }
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeoutMs);
+            try {
+                const apiCall = this.client.messages.create({
+                    model: this.model,
+                    max_tokens: 2048,
+                    messages: [{ role: 'user', content: prompt }],
+                });
+                const timeoutRace = new Promise((_, reject) => setTimeout(() => reject(new ApiTimeoutError(timeoutMs)), timeoutMs));
+                const response = await Promise.race([apiCall, timeoutRace]);
+                clearTimeout(timer);
+                const elapsed = Date.now() - startMs;
+                this.stats.totalLatencyMs += elapsed;
+                bucket.latencyMs += elapsed;
+                this.circuitBreaker.recordSuccess();
+                const textContent = response.content.find((c) => c.type === 'text');
+                return textContent?.text || '';
+            }
+            catch (err) {
+                clearTimeout(timer);
+                lastErr = err;
+                // 超时：不重试
+                if (err instanceof ApiTimeoutError) {
+                    this.stats.totalErrors++;
+                    bucket.errors++;
+                    this.circuitBreaker.recordFailure();
+                    throw err;
+                }
+                // 4xx 客户端错误：不重试
+                const status = err.status;
+                if (status && status >= 400 && status < 500) {
+                    this.stats.totalErrors++;
+                    bucket.errors++;
+                    this.circuitBreaker.recordFailure();
+                    throw err;
+                }
+                // 其他错误（网络、5xx）：继续重试
+            }
+        }
+        this.stats.totalErrors++;
+        bucket.errors++;
+        this.circuitBreaker.recordFailure();
+        throw lastErr;
+    }
+    /** 返回当前累计调用统计（只读快照） */
+    getStats() {
+        return {
+            ...this.stats,
+            byLabel: Object.fromEntries(Object.entries(this.stats.byLabel).map(([k, v]) => [k, { ...v }])),
+        };
+    }
+    /** 格式化统计摘要（供日志输出） */
+    formatStats() {
+        const s = this.stats;
+        if (s.totalCalls === 0)
+            return 'API calls: 0';
+        const avgMs = Math.round(s.totalLatencyMs / (s.totalCalls - s.totalErrors || 1));
+        const lines = [
+            `API calls: ${s.totalCalls} | errors: ${s.totalErrors} | retries: ${s.totalRetries} | circuit trips: ${s.circuitBreakerTrips} | avg latency: ${avgMs}ms`,
+        ];
+        for (const [label, b] of Object.entries(s.byLabel)) {
+            const avg = b.calls > b.errors ? Math.round(b.latencyMs / (b.calls - b.errors)) : 0;
+            lines.push(`  [${label}] calls=${b.calls} errors=${b.errors} retries=${b.retries} avg=${avg}ms`);
+        }
+        return lines.join('\n');
+    }
+}
+/**
+ * 工厂函数：用 distill 配置创建共享 API 实例。
+ * 解决 daemon/index.ts 原来用相同参数创建多次的问题。
+ * 返回 null 而不是抛出，让调用方根据业务决定是否降级。
+ */
+export function createSharedApi(apiKey, model, baseUrl) {
+    try {
+        return new ClaudeAPI(apiKey || undefined, model, baseUrl || undefined);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=claude-api.js.map

package/dist/utils/claude-api.js.map

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

package/dist/utils/formatter.d.ts

@@ -0,0 +1,57 @@
+/**
+ * ForgeFormatter - 统一输出格式化工具
+ *
+ * 负责将系统内部状态格式化为用户友好的展示内容
+ */
+export interface ExecutionCard {
+    intent: string;
+    complexity: string;
+    path: string;
+    plan: string[];
+    estimatedTime?: string;
+    clarifyQuestions?: string[];
+}
+export interface StepProgress {
+    current: number;
+    total: number;
+    message: string;
+}
+export declare class ForgeFormatter {
+    /**
+     * 格式化执行路径卡片
+     */
+    static formatExecutionCard(card: ExecutionCard): string;
+    /**
+     * 格式化步骤进度
+     */
+    static formatStepProgress(step: StepProgress): string;
+    /**
+     * 格式化模块通知（统一标签）
+     */
+    static formatModuleNotification(module: string, content: string): string;
+    /**
+     * 格式化强制确认请求（当编排需要用户回答问题时使用）
+     */
+    static formatClarifyRequest(questions: string[]): string;
+    /**
+     * 包裹为引用块
+     */
+    static wrapInQuote(content: string): string;
+    /**
+     * 合并多个上下文片段（统一分隔符）
+     */
+    static mergeContexts(...parts: (string | null | undefined)[]): string;
+    /**
+     * 格式化 Pipeline 选择提示
+     */
+    static formatPipelineOptions(phases: string[], requirement: string): string;
+    /**
+     * 格式化技能推荐
+     */
+    static formatSkillRecommendation(skillName: string, reason: string): string;
+    /**
+     * 格式化质量门禁结果
+     */
+    static formatQualityGateResult(level: string, summary: string, directive?: string): string;
+}
+//# sourceMappingURL=formatter.d.ts.map

package/dist/utils/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/utils/formatter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,cAAc;IACzB;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM;IAqBvD;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM;IAIrD;;OAEG;IACH,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAcxE;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM;IAKxD;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI3C;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,GAAG,KAAK,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAAG,MAAM;IAMrE;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAsB3E;;OAEG;IACH,MAAM,CAAC,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAI3E;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;CAU3F"}

package/dist/utils/formatter.js

@@ -0,0 +1,109 @@
+/**
+ * ForgeFormatter - 统一输出格式化工具
+ *
+ * 负责将系统内部状态格式化为用户友好的展示内容
+ */
+export class ForgeFormatter {
+    /**
+     * 格式化执行路径卡片
+     */
+    static formatExecutionCard(card) {
+        const lines = [
+            '┏━━━ Forge 执行路径 ━━━',
+            `┃ 🎯 意图：${card.intent}（复杂度：${card.complexity}）`,
+            `┃ 🛤️  路径：${card.path}`,
+            `┃ 📋 计划：${card.plan.join(' → ')}`,
+        ];
+        if (card.estimatedTime) {
+            lines.push(`┃ ⏱️  预估：${card.estimatedTime}`);
+        }
+        if (card.clarifyQuestions && card.clarifyQuestions.length > 0) {
+            lines.push(`┃ ❓ 待确认：${card.clarifyQuestions.join('；')}`);
+        }
+        lines.push('┗━━━━━━━━━━━━━━━━━━━━');
+        return lines.join('\n');
+    }
+    /**
+     * 格式化步骤进度
+     */
+    static formatStepProgress(step) {
+        return `[步骤 ${step.current}/${step.total}] ${step.message}`;
+    }
+    /**
+     * 格式化模块通知（统一标签）
+     */
+    static formatModuleNotification(module, content) {
+        const moduleLabels = {
+            autopilot: 'Forge 自动导航',
+            pipeline: 'Forge 编排指令',
+            quality: 'Forge 质量检查',
+            skill: 'Forge 技能推荐',
+            orchestration: 'Forge 编排策略',
+            knowledge: 'Forge 知识检索',
+        };
+        const label = moduleLabels[module] || `Forge ${module}`;
+        return `[${label}]\n${content}`;
+    }
+    /**
+     * 格式化强制确认请求（当编排需要用户回答问题时使用）
+     */
+    static formatClarifyRequest(questions) {
+        const numbered = questions.map((q, i) => `${i + 1}. ${q}`).join('\n');
+        return `**[Forge 确认请求]** 在继续执行前，请先向用户逐一提出以下问题并等待回答，再开始执行：\n${numbered}`;
+    }
+    /**
+     * 包裹为引用块
+     */
+    static wrapInQuote(content) {
+        return content.split('\n').map(line => `> ${line}`).join('\n');
+    }
+    /**
+     * 合并多个上下文片段（统一分隔符）
+     */
+    static mergeContexts(...parts) {
+        return parts
+            .filter((p) => typeof p === 'string' && p.trim().length > 0)
+            .join('\n\n'); // 模块间双换行
+    }
+    /**
+     * 格式化 Pipeline 选择提示
+     */
+    static formatPipelineOptions(phases, requirement) {
+        const lines = [
+            '',
+            '检测到复杂需求，建议启动编排流程。请选择执行方案：',
+            '',
+            'A. 完整编排（推荐）',
+            `   ${phases.join(' → ')}`,
+            '   预估时间：30-45分钟，质量门禁全程监控',
+            '',
+            'B. 快速编排',
+            '   design → code → test',
+            '   跳过分析和审查，适合紧急修复',
+            '',
+            'C. 手动控制',
+            '   我来逐步指导，不使用自动编排',
+            '',
+            '请回复 A/B/C 或告诉我你的想法',
+        ];
+        return lines.join('\n');
+    }
+    /**
+     * 格式化技能推荐
+     */
+    static formatSkillRecommendation(skillName, reason) {
+        return `💡 推荐技能：${skillName}\n   理由：${reason}`;
+    }
+    /**
+     * 格式化质量门禁结果
+     */
+    static formatQualityGateResult(level, summary, directive) {
+        const emoji = level === 'error' ? '❌' : level === 'warning' ? '⚠️' : '✅';
+        const lines = [`${emoji} ${level.toUpperCase()}: ${summary}`];
+        if (directive) {
+            lines.push('', directive);
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=formatter.js.map

package/dist/utils/formatter.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,25 @@
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3
+}
+export declare function setLogLevel(level: LogLevel): void;
+/**
+ * 设置日志文件路径。rotation 会自动在同目录下按日期命名。
+ * 例如传入 `/home/user/.claude-forge/daemon.log`，
+ * 实际写入 `/home/user/.claude-forge/daemon-2025-07-14.log`
+ */
+export declare function setLogFile(filePath: string): void;
+export declare function setEventsFile(filePath: string): void;
+/**
+ * 写入结构化事件日志（JSONL）
+ */
+export declare function logEvent(project: string, level: 'debug' | 'info' | 'warn' | 'error', event: string, msg: string): void;
+export declare const logger: {
+    debug(msg: string): void;
+    info(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAGA,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACV;AAUD,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAMjD;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAIpD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAC1C,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,IAAI,CAYN;AA0DD,eAAO,MAAM,MAAM;eACN,MAAM,GAAG,IAAI;cAMd,MAAM,GAAG,IAAI;cAMb,MAAM,GAAG,IAAI;eAMZ,MAAM,GAAG,IAAI;CAOzB,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,136 @@
+import fs from 'fs';
+import path from 'path';
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+})(LogLevel || (LogLevel = {}));
+let currentLevel = LogLevel.INFO;
+let logDir = null;
+let logBaseName = 'daemon'; // 不含日期和扩展名
+let eventsFilePath = null;
+/** 当前写入的日志文件日期（YYYY-MM-DD），用于检测跨日 */
+let currentLogDate = '';
+export function setLogLevel(level) {
+    currentLevel = level;
+}
+/**
+ * 设置日志文件路径。rotation 会自动在同目录下按日期命名。
+ * 例如传入 `/home/user/.claude-forge/daemon.log`，
+ * 实际写入 `/home/user/.claude-forge/daemon-2025-07-14.log`
+ */
+export function setLogFile(filePath) {
+    logDir = path.dirname(filePath);
+    logBaseName = path.basename(filePath, path.extname(filePath));
+    if (!fs.existsSync(logDir))
+        fs.mkdirSync(logDir, { recursive: true });
+    // 启动时清理过期日志
+    pruneOldLogs();
+}
+export function setEventsFile(filePath) {
+    eventsFilePath = filePath;
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+}
+/**
+ * 写入结构化事件日志（JSONL）
+ */
+export function logEvent(project, level, event, msg) {
+    if (!eventsFilePath)
+        return;
+    const line = JSON.stringify({
+        ts: new Date().toISOString(),
+        level,
+        project,
+        event,
+        msg,
+    });
+    try {
+        fs.appendFileSync(eventsFilePath, line + '\n');
+    }
+    catch { /* ignore */ }
+}
+function todayStr() {
+    const now = new Date();
+    return now.getFullYear()
+        + '-' + String(now.getMonth() + 1).padStart(2, '0')
+        + '-' + String(now.getDate()).padStart(2, '0');
+}
+function currentLogFilePath() {
+    if (!logDir)
+        return null;
+    const date = todayStr();
+    if (date !== currentLogDate) {
+        currentLogDate = date;
+        // 跨日时清理过期日志
+        pruneOldLogs();
+    }
+    return path.join(logDir, `${logBaseName}-${date}.log`);
+}
+/** 删除超过 7 天的旧日志文件 */
+function pruneOldLogs() {
+    if (!logDir)
+        return;
+    try {
+        const cutoff = Date.now() - 7 * 24 * 60 * 60 * 1000;
+        const files = fs.readdirSync(logDir);
+        for (const f of files) {
+            const match = f.match(new RegExp(`^${logBaseName}-(\\d{4}-\\d{2}-\\d{2})\\.log$`));
+            if (!match)
+                continue;
+            const fileDate = new Date(match[1]).getTime();
+            if (fileDate < cutoff) {
+                fs.unlinkSync(path.join(logDir, f));
+            }
+        }
+    }
+    catch { /* ignore */ }
+}
+function formatMessage(level, msg) {
+    const now = new Date();
+    const ts = now.getFullYear()
+        + '-' + String(now.getMonth() + 1).padStart(2, '0')
+        + '-' + String(now.getDate()).padStart(2, '0')
+        + 'T' + String(now.getHours()).padStart(2, '0')
+        + ':' + String(now.getMinutes()).padStart(2, '0')
+        + ':' + String(now.getSeconds()).padStart(2, '0')
+        + '.' + String(now.getMilliseconds()).padStart(3, '0');
+    return `[${ts}] [${level}] ${msg}`;
+}
+function writeLog(message) {
+    const filePath = currentLogFilePath();
+    if (filePath) {
+        try {
+            fs.appendFileSync(filePath, message + '\n');
+        }
+        catch { /* ignore */ }
+    }
+}
+export const logger = {
+    debug(msg) {
+        if (currentLevel <= LogLevel.DEBUG) {
+            writeLog(formatMessage('DEBUG', msg));
+        }
+    },
+    info(msg) {
+        if (currentLevel <= LogLevel.INFO) {
+            writeLog(formatMessage('INFO', msg));
+        }
+    },
+    warn(msg) {
+        if (currentLevel <= LogLevel.WARN) {
+            writeLog(formatMessage('WARN', msg));
+        }
+    },
+    error(msg) {
+        if (currentLevel <= LogLevel.ERROR) {
+            const formatted = formatMessage('ERROR', msg);
+            console.error(formatted);
+            writeLog(formatted);
+        }
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/mutex-lock.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 基于 Set<string> 的轻量互斥锁。
+ *
+ * 解决问题：DistillTrigger 和 ResumeEngine 各自用 Set<string> 实现互斥，
+ * 代码模式完全一致但分散在两处。提取为可复用工具类。
+ *
+ * Node.js 单线程环境下不存在真正的竞态，此锁防的是同一事件循环中
+ * 同一 key 被重入触发（如定时器和阈值触发同时命中同一项目）。
+ */
+export declare class MutexLock {
+    private readonly locks;
+    private readonly name;
+    constructor(name: string);
+    isLocked(key: string): boolean;
+    /**
+     * 带锁执行：已锁定时跳过并返回 null，否则执行 fn 并在完成后释放锁。
+     * @returns fn 的返回值，或 null（表示被跳过）
+     */
+    runExclusive<T>(key: string, fn: () => Promise<T>): Promise<T | null>;
+    /** 当前持锁的 key 列表（用于调试） */
+    getActiveLocks(): string[];
+}
+//# sourceMappingURL=mutex-lock.d.ts.map

package/dist/utils/mutex-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutex-lock.d.ts","sourceRoot":"","sources":["../../src/utils/mutex-lock.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAChD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,IAAI,EAAE,MAAM;IAIxB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI9B;;;OAGG;IACG,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAc3E,yBAAyB;IACzB,cAAc,IAAI,MAAM,EAAE;CAG3B"}

package/dist/utils/mutex-lock.js

@@ -0,0 +1,42 @@
+import { logger } from './logger.js';
+/**
+ * 基于 Set<string> 的轻量互斥锁。
+ *
+ * 解决问题：DistillTrigger 和 ResumeEngine 各自用 Set<string> 实现互斥，
+ * 代码模式完全一致但分散在两处。提取为可复用工具类。
+ *
+ * Node.js 单线程环境下不存在真正的竞态，此锁防的是同一事件循环中
+ * 同一 key 被重入触发（如定时器和阈值触发同时命中同一项目）。
+ */
+export class MutexLock {
+    locks = new Set();
+    name;
+    constructor(name) {
+        this.name = name;
+    }
+    isLocked(key) {
+        return this.locks.has(key);
+    }
+    /**
+     * 带锁执行：已锁定时跳过并返回 null，否则执行 fn 并在完成后释放锁。
+     * @returns fn 的返回值，或 null（表示被跳过）
+     */
+    async runExclusive(key, fn) {
+        if (this.locks.has(key)) {
+            logger.debug(`[${this.name}] 已跳过（正在运行中），key: ${key}`);
+            return null;
+        }
+        this.locks.add(key);
+        try {
+            return await fn();
+        }
+        finally {
+            this.locks.delete(key);
+        }
+    }
+    /** 当前持锁的 key 列表（用于调试） */
+    getActiveLocks() {
+        return Array.from(this.locks);
+    }
+}
+//# sourceMappingURL=mutex-lock.js.map