@lingxiao-office/sdk 1.0.0

package/dist/core/ExecutionTraceMemory.js

@@ -0,0 +1,243 @@
+import { randomUUID } from 'node:crypto';
+import { isAbsolute, relative, resolve } from 'node:path';
+function jsonParse(value, fallback) {
+    if (typeof value !== 'string' || !value.trim())
+        return fallback;
+    try {
+        return JSON.parse(value);
+    }
+    catch { /* expected: fallback to default */
+        return fallback;
+    }
+}
+function normalizeProjectRoot(projectRoot) {
+    return resolve(projectRoot);
+}
+function uniqueStrings(values) {
+    const seen = new Set();
+    const out = [];
+    for (const value of values ?? []) {
+        const trimmed = value.trim();
+        if (!trimmed || seen.has(trimmed))
+            continue;
+        seen.add(trimmed);
+        out.push(trimmed);
+    }
+    return out;
+}
+function normalizeFilePath(projectRoot, file) {
+    const trimmed = file.trim();
+    if (!trimmed)
+        return '';
+    const normalized = isAbsolute(trimmed) ? relative(projectRoot, trimmed) : trimmed;
+    return normalized.replace(/\\/g, '/');
+}
+function normalizeFilesChanged(projectRoot, files) {
+    return uniqueStrings((files ?? []).map((file) => normalizeFilePath(projectRoot, file)));
+}
+function percentile(values, p) {
+    if (values.length === 0)
+        return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    const index = Math.min(sorted.length - 1, Math.max(0, Math.ceil((p / 100) * sorted.length) - 1));
+    return sorted[index];
+}
+function roundRate(value) {
+    return Math.round(value * 10_000) / 10_000;
+}
+function stableTaskType(value) {
+    return value?.trim() || 'unknown';
+}
+function stableErrorSignature(value) {
+    const firstLine = value?.split(/\r?\n/).map((line) => line.trim()).find(Boolean);
+    return firstLine || undefined;
+}
+function mapEventRow(row) {
+    return {
+        id: String(row.id),
+        projectRoot: String(row.project_root),
+        sessionId: row.session_id ? String(row.session_id) : undefined,
+        taskId: row.task_id ? String(row.task_id) : undefined,
+        agentId: row.agent_id ? String(row.agent_id) : undefined,
+        agentName: row.agent_name ? String(row.agent_name) : undefined,
+        agentRole: row.agent_role ? String(row.agent_role) : undefined,
+        taskType: stableTaskType(row.task_type ? String(row.task_type) : undefined),
+        status: String(row.status),
+        durationMs: Number(row.duration_ms || 0),
+        filesChanged: jsonParse(row.files_changed, []),
+        errorSignature: row.error_signature ? String(row.error_signature) : undefined,
+        fixPattern: row.fix_pattern ? String(row.fix_pattern) : undefined,
+        verification: jsonParse(row.verification, undefined),
+        metadata: jsonParse(row.metadata, undefined),
+        createdAt: Number(row.created_at || 0),
+    };
+}
+export class ExecutionTraceMemory {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    recordTrace(input) {
+        const projectRoot = normalizeProjectRoot(input.projectRoot);
+        const event = {
+            id: input.id ?? randomUUID(),
+            projectRoot,
+            sessionId: input.sessionId,
+            taskId: input.taskId,
+            agentId: input.agentId,
+            agentName: input.agentName,
+            agentRole: input.agentRole,
+            taskType: stableTaskType(input.taskType),
+            status: input.status,
+            durationMs: Math.max(0, Math.floor(input.durationMs ?? 0)),
+            filesChanged: normalizeFilesChanged(projectRoot, input.filesChanged),
+            errorSignature: stableErrorSignature(input.errorSignature),
+            fixPattern: input.fixPattern?.trim() || undefined,
+            verification: input.verification,
+            metadata: input.metadata,
+            createdAt: input.createdAt ?? Date.now() / 1000,
+        };
+        this.db.getDb().prepare(`INSERT INTO execution_trace_events (
+        id, project_root, session_id, task_id, agent_id, agent_name, agent_role,
+        task_type, status, duration_ms, files_changed, error_signature, fix_pattern,
+        verification, metadata, created_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(event.id, event.projectRoot, event.sessionId ?? null, event.taskId ?? null, event.agentId ?? null, event.agentName ?? null, event.agentRole ?? null, event.taskType, event.status, event.durationMs, JSON.stringify(event.filesChanged), event.errorSignature ?? null, event.fixPattern ?? null, event.verification === undefined ? null : JSON.stringify(event.verification), event.metadata === undefined ? null : JSON.stringify(event.metadata), event.createdAt);
+        return event;
+    }
+    listTraces(projectRoot, options = {}) {
+        const limit = Math.max(1, Math.min(options.limit ?? 1000, 10_000));
+        const rows = this.db.getDb().prepare('SELECT * FROM execution_trace_events WHERE project_root = ? ORDER BY created_at ASC LIMIT ?').all(normalizeProjectRoot(projectRoot), limit);
+        return rows.map(mapEventRow);
+    }
+    rebuildProjectModel(projectRoot) {
+        const normalizedRoot = normalizeProjectRoot(projectRoot);
+        const events = this.listTraces(normalizedRoot, { limit: 10_000 });
+        const rebuiltAt = Date.now() / 1000;
+        const model = {
+            projectRoot: normalizedRoot,
+            rebuiltAt,
+            traceCount: events.length,
+            hotspots: this.buildHotspots(events),
+            fixPatterns: this.buildFixPatterns(events),
+            timingBaselines: this.buildTimingBaselines(events),
+            taskTypeSuccessRates: this.buildTaskTypeSuccessRates(events),
+        };
+        this.db.getDb().prepare(`INSERT INTO execution_project_models (project_root, model_json, rebuilt_at)
+       VALUES (?, ?, ?)
+       ON CONFLICT(project_root) DO UPDATE SET
+         model_json = excluded.model_json,
+         rebuilt_at = excluded.rebuilt_at`).run(normalizedRoot, JSON.stringify(model), rebuiltAt);
+        return model;
+    }
+    getProjectModel(projectRoot) {
+        const normalizedRoot = normalizeProjectRoot(projectRoot);
+        const row = this.db.getDb().prepare('SELECT model_json FROM execution_project_models WHERE project_root = ?').get(normalizedRoot);
+        if (!row?.model_json)
+            return this.rebuildProjectModel(normalizedRoot);
+        const parsed = jsonParse(row.model_json, null);
+        return parsed ?? this.rebuildProjectModel(normalizedRoot);
+    }
+    buildHotspots(events) {
+        const byFile = new Map();
+        for (const event of events) {
+            for (const file of event.filesChanged) {
+                const current = byFile.get(file) ?? {
+                    file,
+                    attempts: 0,
+                    failures: 0,
+                    successes: 0,
+                    failureRate: 0,
+                    lastStatus: event.status,
+                    lastSeenAt: event.createdAt,
+                };
+                current.attempts += 1;
+                if (event.status === 'success')
+                    current.successes += 1;
+                if (event.status === 'failed')
+                    current.failures += 1;
+                current.lastStatus = event.status;
+                current.lastSeenAt = Math.max(current.lastSeenAt, event.createdAt);
+                current.failureRate = roundRate(current.failures / current.attempts);
+                byFile.set(file, current);
+            }
+        }
+        return [...byFile.values()].sort((a, b) => b.failures - a.failures || b.attempts - a.attempts || a.file.localeCompare(b.file));
+    }
+    buildFixPatterns(events) {
+        const byPattern = new Map();
+        for (const event of events) {
+            if (!event.errorSignature || !event.fixPattern)
+                continue;
+            const key = `${event.errorSignature}\n${event.fixPattern}`;
+            const current = byPattern.get(key) ?? {
+                errorSignature: event.errorSignature,
+                fixPattern: event.fixPattern,
+                count: 0,
+                files: [],
+                lastSeenAt: event.createdAt,
+            };
+            current.count += 1;
+            current.files = uniqueStrings([...current.files, ...event.filesChanged]);
+            current.lastSeenAt = Math.max(current.lastSeenAt, event.createdAt);
+            byPattern.set(key, current);
+        }
+        return [...byPattern.values()].sort((a, b) => b.count - a.count || b.lastSeenAt - a.lastSeenAt);
+    }
+    buildTimingBaselines(events) {
+        const byType = new Map();
+        for (const event of events) {
+            const list = byType.get(event.taskType) ?? [];
+            list.push(event.durationMs);
+            byType.set(event.taskType, list);
+        }
+        return [...byType.entries()].map(([taskType, durations]) => ({
+            taskType,
+            count: durations.length,
+            avgMs: Math.round(durations.reduce((sum, value) => sum + value, 0) / durations.length),
+            p50Ms: percentile(durations, 50),
+            p90Ms: percentile(durations, 90),
+        })).sort((a, b) => b.count - a.count || a.taskType.localeCompare(b.taskType));
+    }
+    buildTaskTypeSuccessRates(events) {
+        const byType = new Map();
+        for (const event of events) {
+            const current = byType.get(event.taskType) ?? {
+                taskType: event.taskType,
+                total: 0,
+                successes: 0,
+                failures: 0,
+                successRate: 0,
+            };
+            current.total += 1;
+            if (event.status === 'success')
+                current.successes += 1;
+            if (event.status === 'failed')
+                current.failures += 1;
+            current.successRate = roundRate(current.successes / current.total);
+            byType.set(event.taskType, current);
+        }
+        return [...byType.values()].sort((a, b) => b.total - a.total || a.taskType.localeCompare(b.taskType));
+    }
+}
+export function extractProjectModelEvidence(model, files) {
+    const fileSet = new Set(normalizeFilesChanged(model.projectRoot, files));
+    const matchesScope = (file) => {
+        if (fileSet.size === 0)
+            return true;
+        for (const scope of fileSet) {
+            const prefix = scope.replace(/\/+$/, '');
+            if (file === prefix || file.startsWith(`${prefix}/`))
+                return true;
+        }
+        return false;
+    };
+    const hotspots = model.hotspots.filter((hotspot) => matchesScope(hotspot.file)).slice(0, 8);
+    const fixPatterns = model.fixPatterns.filter((pattern) => pattern.files.some((file) => matchesScope(file))).slice(0, 8);
+    return {
+        hotspots,
+        fixPatterns,
+        timingBaselines: model.timingBaselines.slice(0, 8),
+        taskTypeSuccessRates: model.taskTypeSuccessRates.slice(0, 8),
+    };
+}
+//# sourceMappingURL=ExecutionTraceMemory.js.map

package/dist/core/ExecutionTraceMemory.js.map

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

package/dist/core/FileLock.d.ts

@@ -0,0 +1,108 @@
+/**
+ * 跨进程文件锁 - 参考 Claude Code proper-lockfile
+ *
+ * 特性:
+ * 1. 支持重试和超时
+ * 2. 自动释放
+ * 3. 锁文件自动创建
+ * 4. 异步接口
+ * 5. 读写锁支持（多读者-单写者）
+ *
+ * 注意:
+ * - Linux/macOS 使用 fcntl (fs 模块)
+ * - Windows 需要特殊处理
+ *
+ * P0 #5 修复（2026-05-22）：原实现仅靠 mtime 判定 stale，写入空内容；持锁进程
+ * 长时间不刷新 mtime，5min 后即使仍在合法持有也会被 unlink，导致跨进程互斥失效。
+ * 现已改为：
+ *   1. 锁文件内容写入 { pid, host, acquiredAt } JSON
+ *   2. tryCleanStaleLock 必须先验证记录的 PID 已死（kill -0 失败）才会 unlink
+ *      —— 同主机：直接验证；跨主机：只能依赖 mtime 兜底
+ *   3. 持锁期间启动 heartbeat（默认 60s）刷新 mtime，让 stale 检测更可靠
+ */
+/**
+ * 锁模式
+ */
+export declare enum LockMode {
+    READ = "read",// 共享读锁
+    WRITE = "write"
+}
+/**
+ * 文件锁选项
+ */
+export interface FileLockOptions {
+    timeout: number;
+    retryInterval: number;
+    /** 是否启动 mtime heartbeat 防止合法持锁被误判 stale，默认 true */
+    heartbeat?: boolean;
+    /** heartbeat 间隔（毫秒），默认 60_000 */
+    heartbeatIntervalMs?: number;
+}
+/**
+ * 跨进程文件锁
+ *
+ * 使用 fs 模块的文件锁功能实现跨进程互斥
+ */
+export declare class FileLock {
+    private lockPath;
+    private options;
+    private fd;
+    private locked;
+    private heartbeatTimer;
+    /** 本次持锁的一次性令牌；release 时用它校验锁文件仍属于自己。 */
+    private token;
+    constructor(lockPath: string, options?: Partial<FileLockOptions>);
+    /**
+     * 获取锁
+     */
+    acquire(blocking?: boolean): Promise<boolean>;
+    /**
+     * 释放锁
+     */
+    release(): void;
+    /**
+     * 检查是否持有锁
+     */
+    isLocked(): boolean;
+    /**
+     * 清理锁文件。
+     *
+     * 注意：只通过 release() 释放「本实例持有的锁」（含 token+pid+host 所有权校验），
+     * 不再无条件 unlink——否则当本实例并未持锁、而锁文件已被其他进程合法持有时，
+     * 直接 unlink 会删掉别人的锁，正是要修复的缺陷。
+     */
+    cleanup(): Promise<void>;
+    /**
+     * 启动 mtime heartbeat：每 heartbeatIntervalMs 触摸一次锁文件，
+     * 确保合法持锁期间不会被 mtime 兜底逻辑误判 stale。
+     */
+    private startHeartbeat;
+    private stopHeartbeat;
+}
+/**
+ * 异步文件锁
+ */
+export declare class AsyncFileLock {
+    private lockPath;
+    private options;
+    private locked;
+    private heartbeatTimer;
+    /** 本次持锁的一次性令牌；release 时用它校验锁文件仍属于自己。 */
+    private token;
+    constructor(lockPath: string, options?: Partial<FileLockOptions>);
+    /**
+     * 异步获取锁
+     */
+    acquire(blocking?: boolean): Promise<boolean>;
+    /**
+     * 释放锁
+     */
+    release(): Promise<void>;
+    /**
+     * 检查是否持有锁
+     */
+    isLocked(): boolean;
+    private startHeartbeat;
+    private stopHeartbeat;
+}
+//# sourceMappingURL=FileLock.d.ts.map

package/dist/core/FileLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileLock.d.ts","sourceRoot":"","sources":["../../src/core/FileLock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAyBH;;GAEG;AACH,oBAAY,QAAQ;IAClB,IAAI,SAAS,CAAI,OAAO;IACxB,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iCAAiC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAmJD;;;;GAIG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,EAAE,CAAuB;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAA+C;IACrE,wCAAwC;IACxC,OAAO,CAAC,KAAK,CAAuB;gBAExB,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAKhE;;OAEG;IACG,OAAO,CAAC,QAAQ,UAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IA6DhD;;OAEG;IACH,OAAO,IAAI,IAAI;IAqBf;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,aAAa;CAMtB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAA+C;IACrE,wCAAwC;IACxC,OAAO,CAAC,KAAK,CAAuB;gBAExB,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAKhE;;OAEG;IACG,OAAO,CAAC,QAAQ,UAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAuDhD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,aAAa;CAMtB"}