@lingxiao-office/sdk 1.0.0

package/dist/core/WorktreeService.js

@@ -0,0 +1,335 @@
+import { randomUUID } from 'node:crypto';
+import { existsSync } from 'node:fs';
+import { mkdir, rm } from 'node:fs/promises';
+import { basename, join, resolve } from 'node:path';
+import { spawn } from 'node:child_process';
+import { CONFIG_DIR } from '../config.js';
+import { isWorktreeTerminalStatus, normalizeWorktreeStatus } from './StateSemantics.js';
+const DEFAULT_WORKTREE_ROOT = join(CONFIG_DIR, 'worktrees');
+function getDefaultWorktreeRoot() {
+    return process.env.LINGXIAO_WORKTREE_ROOT || DEFAULT_WORKTREE_ROOT;
+}
+export class WorktreeError extends Error {
+    statusCode;
+    constructor(message, statusCode = 400) {
+        super(message);
+        this.statusCode = statusCode;
+        this.name = 'WorktreeError';
+    }
+}
+function slug(value) {
+    return value.replace(/[^A-Za-z0-9._-]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 80) || 'repo';
+}
+function validateName(value, label) {
+    if (!/^[A-Za-z0-9._/-]{1,120}$/.test(value) || value.includes('..') || value.startsWith('/') || value.endsWith('/')) {
+        throw new WorktreeError(`${label} contains invalid characters`, 400);
+    }
+}
+function validateWorktreeName(value) {
+    if (!/^[A-Za-z0-9._-]{1,80}$/.test(value) || value.includes('..')) {
+        throw new WorktreeError('worktree name contains invalid characters', 400);
+    }
+}
+function validateBranch(value, label) {
+    validateName(value, label);
+    if (value.includes('//') || value.endsWith('.lock') || value.startsWith('-')) {
+        throw new WorktreeError(`${label} is not a valid branch name`, 400);
+    }
+}
+async function runGit(args, cwd) {
+    return new Promise((resolveRun, reject) => {
+        const child = spawn('git', args, { cwd, stdio: ['ignore', 'pipe', 'pipe'] });
+        let stdout = '';
+        let stderr = '';
+        child.stdout.setEncoding('utf8');
+        child.stderr.setEncoding('utf8');
+        child.stdout.on('data', (chunk) => { stdout += chunk; });
+        child.stderr.on('data', (chunk) => { stderr += chunk; });
+        child.on('error', reject);
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolveRun({ stdout: stdout.trim(), stderr: stderr.trim() });
+            }
+            else {
+                reject(new Error((stderr || stdout || `git ${args.join(' ')} exited ${code}`).trim()));
+            }
+        });
+    });
+}
+async function tryGit(args, cwd) {
+    return new Promise((resolveRun) => {
+        const child = spawn('git', args, { cwd, stdio: ['ignore', 'pipe', 'pipe'] });
+        let stdout = '';
+        let stderr = '';
+        child.stdout.setEncoding('utf8');
+        child.stderr.setEncoding('utf8');
+        child.stdout.on('data', (chunk) => { stdout += chunk; });
+        child.stderr.on('data', (chunk) => { stderr += chunk; });
+        child.on('error', (error) => resolveRun({ code: 1, stdout: '', stderr: error instanceof Error ? error.message : String(error) }));
+        child.on('close', (code) => resolveRun({ code: code ?? 1, stdout: stdout.trim(), stderr: stderr.trim() }));
+    });
+}
+function parseCount(value) {
+    const parsed = Number(value.trim());
+    return Number.isFinite(parsed) && parsed >= 0 ? parsed : 0;
+}
+function parseStatus(text, branch) {
+    const modified = [];
+    const untracked = [];
+    const staged = [];
+    const conflicted = [];
+    for (const line of text.split('\n').filter(Boolean)) {
+        const index = line[0] || ' ';
+        const working = line[1] || ' ';
+        const file = line.slice(3);
+        if (line.startsWith('??')) {
+            untracked.push(file);
+            continue;
+        }
+        if (index === 'U' || working === 'U' || (index === 'A' && working === 'A') || (index === 'D' && working === 'D')) {
+            conflicted.push(file);
+            continue;
+        }
+        if (index !== ' ')
+            staged.push(file);
+        if (working !== ' ')
+            modified.push(file);
+    }
+    const total = modified.length + untracked.length + staged.length + conflicted.length;
+    return { modified, untracked, staged, conflicted, total, clean: total === 0, currentBranch: branch };
+}
+export class WorktreeService {
+    db;
+    worktreeRoot;
+    constructor(db, worktreeRoot = getDefaultWorktreeRoot()) {
+        this.db = db;
+        this.worktreeRoot = worktreeRoot;
+    }
+    async isGitRepo(cwd) {
+        try {
+            await runGit(['rev-parse', '--git-dir'], cwd);
+            return true;
+        }
+        catch { /* expected: operation may fail */
+            return false;
+        }
+    }
+    async repoRoot(cwd) {
+        const result = await runGit(['rev-parse', '--show-toplevel'], cwd);
+        return resolve(result.stdout);
+    }
+    async currentBranch(cwd) {
+        try {
+            return (await runGit(['rev-parse', '--abbrev-ref', 'HEAD'], cwd)).stdout || 'HEAD';
+        }
+        catch { /* expected: fallback to default */
+            return 'HEAD';
+        }
+    }
+    async status(path) {
+        const [branch, status] = await Promise.all([
+            this.currentBranch(path),
+            runGit(['status', '--porcelain'], path),
+        ]);
+        return parseStatus(status.stdout, branch);
+    }
+    async listGit(repoRoot) {
+        const root = await this.repoRoot(repoRoot);
+        const result = await runGit(['worktree', 'list', '--porcelain'], root);
+        const entries = [];
+        const blocks = result.stdout.split('\n\n').filter(Boolean);
+        for (const block of blocks) {
+            const lines = block.split('\n');
+            const pathLine = lines.find((line) => line.startsWith('worktree '));
+            if (!pathLine)
+                continue;
+            const branchLine = lines.find((line) => line.startsWith('branch '));
+            entries.push({
+                path: pathLine.replace('worktree ', ''),
+                branch: branchLine ? branchLine.replace('branch refs/heads/', '') : 'HEAD',
+                locked: lines.some((line) => line.startsWith('locked')),
+            });
+        }
+        return entries;
+    }
+    async create(input) {
+        const root = await this.repoRoot(input.repoRoot);
+        const baseBranch = input.baseBranch || await this.currentBranch(root);
+        const name = input.name?.trim() || `lx-${Date.now()}`;
+        validateWorktreeName(name);
+        validateBranch(baseBranch, 'base branch');
+        const branch = input.branch?.trim() || `worktree/${name}`;
+        validateBranch(branch, 'worktree branch');
+        const repoDir = slug(`${basename(root)}-${Buffer.from(root).toString('base64url').slice(0, 12)}`);
+        const baseDir = join(this.worktreeRoot, repoDir);
+        const worktreePath = join(baseDir, name);
+        if (existsSync(worktreePath)) {
+            throw new WorktreeError(`Worktree path already exists: ${worktreePath}`, 409);
+        }
+        await mkdir(baseDir, { recursive: true });
+        const id = randomUUID();
+        const now = Date.now() / 1000;
+        try {
+            await runGit(['worktree', 'add', '-b', branch, worktreePath, baseBranch], root);
+            const record = {
+                id,
+                name,
+                repo_root: root,
+                path: worktreePath,
+                branch,
+                base_branch: baseBranch,
+                session_id: input.sessionId,
+                task_id: input.taskId,
+                status: 'active',
+                created_at: now,
+                updated_at: now,
+            };
+            this.db.upsert(record);
+            return this.view(record);
+        }
+        catch (error) {
+            // C12: 回滚半成品状态——git worktree add 失败后,worktree 目录/分支/git 元数据可能已部分创建。
+            // 不回滚则留下孤儿目录 + 残留分支 + 失效的 git worktree 注册,跨多次失败堆积。
+            // 注意 baseDir 为同一 repo 多 worktree 共享,只清 worktreePath 本身,不碰 baseDir。
+            await runGit(['worktree', 'remove', '--force', worktreePath], root).catch(() => undefined);
+            await runGit(['worktree', 'prune'], root).catch(() => undefined);
+            if (branch !== baseBranch) {
+                await runGit(['branch', '-D', branch], root).catch(() => undefined);
+            }
+            await rm(worktreePath, { recursive: true, force: true }).catch(() => undefined);
+            const record = {
+                id,
+                name,
+                repo_root: root,
+                path: worktreePath,
+                branch,
+                base_branch: baseBranch,
+                session_id: input.sessionId,
+                task_id: input.taskId,
+                status: 'failed',
+                created_at: now,
+                updated_at: now,
+                last_error: error instanceof Error ? error.message : String(error),
+            };
+            this.db.upsert(record);
+            throw error;
+        }
+    }
+    async list(filters) {
+        const repoRoot = filters?.repoRoot ? await this.repoRoot(filters.repoRoot).catch(() => filters.repoRoot) : undefined;
+        const records = this.db.list({ ...filters, repoRoot });
+        return Promise.all(records.map((record) => this.view(record)));
+    }
+    async findByPath(path) {
+        const record = this.db.getByPath(resolve(path));
+        return record ? this.view(record) : null;
+    }
+    async get(id) {
+        const record = this.db.get(id);
+        return record ? this.view(record) : null;
+    }
+    async attachSession(id, sessionId) {
+        const record = this.requireRecord(id);
+        this.db.attachSession(id, sessionId);
+        return this.view({ ...record, session_id: sessionId || undefined, updated_at: Date.now() / 1000 });
+    }
+    async remove(id, options) {
+        const record = this.requireRecord(id);
+        const branch = record.branch;
+        const exists = existsSync(record.path);
+        if (exists) {
+            try {
+                await runGit(['worktree', 'remove', '--force', record.path], record.repo_root);
+            }
+            catch { /* swallowed: unhandled error */
+                await runGit(['worktree', 'prune'], record.repo_root).catch(() => undefined);
+                await rm(record.path, { recursive: true, force: true }).catch(() => undefined);
+            }
+        }
+        let branchDeleted = false;
+        if (!options?.keepBranch && branch && branch !== 'HEAD') {
+            await runGit(['branch', '-D', branch], record.repo_root).then(() => { branchDeleted = true; }).catch(() => undefined);
+        }
+        this.db.updateStatus(id, normalizeWorktreeStatus('removed'), null);
+        return { removed: true, branchDeleted };
+    }
+    async merge(id, options) {
+        const record = this.requireRecord(id);
+        const recordStatus = normalizeWorktreeStatus(record.status);
+        if (recordStatus === 'removed') {
+            throw new WorktreeError(`Worktree ${id} has already been removed.`, 409);
+        }
+        if (recordStatus === 'merged') {
+            throw new WorktreeError(`Worktree ${id} has already been merged.`, 409);
+        }
+        if (recordStatus === 'failed') {
+            throw new WorktreeError(`Worktree ${id} is failed and cannot be merged.`, 409);
+        }
+        if (!existsSync(record.path)) {
+            this.db.updateStatus(id, normalizeWorktreeStatus('failed'), 'Worktree path is missing');
+            throw new WorktreeError(`Worktree path is missing: ${record.path}`, 409);
+        }
+        const worktreeStatus = await this.status(record.path);
+        if (worktreeStatus.currentBranch !== record.branch) {
+            throw new WorktreeError(`Worktree is on "${worktreeStatus.currentBranch}". Expected branch "${record.branch}".`, 409);
+        }
+        if (!worktreeStatus.clean) {
+            this.db.updateStatus(id, normalizeWorktreeStatus('dirty'), null);
+            throw new WorktreeError('Worktree has uncommitted changes. Commit or discard them before merging.', 409);
+        }
+        const rootBranch = await this.currentBranch(record.repo_root);
+        if (rootBranch !== record.base_branch) {
+            throw new WorktreeError(`Main repo is on "${rootBranch}". Switch to base branch "${record.base_branch}" before merging.`, 409);
+        }
+        const rootStatus = await this.status(record.repo_root);
+        if (!rootStatus.clean) {
+            throw new WorktreeError('Main repo has uncommitted changes. Commit/stash them before merging a worktree.', 409);
+        }
+        const args = ['merge', options?.ffOnly === false ? '--no-ff' : '--ff-only', record.branch];
+        const output = await runGit(args, record.repo_root);
+        this.db.updateStatus(id, normalizeWorktreeStatus('merged'), null);
+        let removed = false;
+        if (options?.deleteAfterMerge) {
+            await this.remove(id, { keepBranch: false });
+            removed = true;
+        }
+        return { merged: true, output: [output.stdout, output.stderr].filter(Boolean).join('\n'), removed };
+    }
+    async prune(repoRoot) {
+        const root = await this.repoRoot(repoRoot);
+        await runGit(['worktree', 'prune'], root);
+        return { success: true };
+    }
+    requireRecord(id) {
+        const record = this.db.get(id);
+        if (!record)
+            throw new WorktreeError(`Worktree not found: ${id}`, 404);
+        return record;
+    }
+    async view(record) {
+        const exists = existsSync(record.path);
+        let live;
+        let status = record.status;
+        const terminal = isWorktreeTerminalStatus(record.status);
+        const normalizedStatus = normalizeWorktreeStatus(record.status);
+        if (exists && normalizedStatus !== 'removed' && normalizedStatus !== 'failed') {
+            try {
+                live = await this.status(record.path);
+                if (!terminal) {
+                    status = live.clean ? 'active' : 'dirty';
+                    if (status !== record.status) {
+                        this.db.updateStatus(record.id, normalizeWorktreeStatus(status), null);
+                    }
+                }
+            }
+            catch (error) {
+                if (!terminal) {
+                    this.db.updateStatus(record.id, normalizeWorktreeStatus('failed'), error instanceof Error ? error.message : String(error));
+                    status = 'failed';
+                }
+            }
+        }
+        return { ...record, status, exists, live };
+    }
+}
+//# sourceMappingURL=WorktreeService.js.map

package/dist/core/WorktreeService.js.map

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

package/dist/core/blackboard/BlackboardGraph.d.ts

@@ -0,0 +1,146 @@
+/**
+ * BlackboardGraph — 黑板图的高层 API
+ *
+ * 职责：
+ *   - 节点 CRUD（自动 ID 生成、事件发射）
+ *   - 图查询（BFS 子图、可调度 Intent、矛盾检测）
+ *   - Worker 输出批量写入（事务原子性）
+ *   - Intent 认领/释放生命周期
+ *   - 图裁剪（max_nodes/max_edges 执行）
+ *
+ * 设计原则：
+ *   - 所有持久化委托给 GraphStore
+ *   - 所有变更通过 EventEmitter 广播
+ *   - Fact 节点不可变（只能 supersede，不能 edit）
+ */
+import { GraphStore } from './GraphStore.js';
+import type { EventEmitter } from '../EventEmitter.js';
+import type { GraphNode, GraphEdge, NodeKind, IntentStatus, GraphSnapshot, WorkerGraphOutput, GraphAnalysis } from './types.js';
+export declare class BlackboardGraph {
+    private store;
+    private emitter?;
+    /** sessionId → kind → 下一个序号 */
+    private counters;
+    /**
+     * 非空时，emit() 把事件收集到这里而不立即发射。
+     * 用于在 DB 事务期间缓冲事件，待事务成功提交后再统一发射——
+     * 避免对最终被回滚的写入误发事件，也避免监听器异常回滚事务。
+     */
+    private pendingEvents;
+    constructor(store: GraphStore, emitter?: EventEmitter);
+    private nextId;
+    private nextEdgeId;
+    private emit;
+    /**
+     * 在 DB 事务中缓冲事件，事务成功返回后再统一发射。
+     * - 事务回调内只做 DB 写 + emit（被缓冲），不触达监听器，监听器异常无法回滚事务；
+     * - 仅当事务成功（store.transaction 正常返回）时才发射缓冲事件；
+     * - 单个监听器抛错被 emit() 的 try/catch 兜住，不影响其余事件与已提交的数据。
+     */
+    private withBufferedEvents;
+    private flushOneEvent;
+    addFact(input: Omit<GraphNode, 'id' | 'kind' | 'createdAt'>): GraphNode;
+    addIntent(input: Omit<GraphNode, 'id' | 'kind' | 'createdAt'>): GraphNode;
+    addHint(input: Omit<GraphNode, 'id' | 'kind' | 'createdAt'>): GraphNode;
+    addContract(input: Omit<GraphNode, 'id' | 'kind' | 'createdAt'>): GraphNode;
+    addDesignDoc(input: Omit<GraphNode, 'id' | 'kind' | 'createdAt'>): GraphNode;
+    addReview(input: Omit<GraphNode, 'id' | 'kind' | 'createdAt'>): GraphNode;
+    addVerdict(input: Omit<GraphNode, 'id' | 'kind' | 'createdAt'>): GraphNode;
+    addDecisionLog(input: Omit<GraphNode, 'id' | 'kind' | 'createdAt'>): GraphNode;
+    getActiveContract(sessionId: string, surface: string): GraphNode | null;
+    /**
+     * 返回可解除 contract gate 的黑板证据。
+     *
+     * 正式 contract 节点优先；同时兼容 Leader/Worker 通过 blackboard(write_fact)
+     * 记录的契约事实，避免只有 kind='contract' 才能解锁实现任务。
+     */
+    getContractEvidence(sessionId: string, surface: string): GraphNode | null;
+    setOrigin(sessionId: string, content: string, title?: string): GraphNode;
+    setGoal(sessionId: string, content: string, title?: string): GraphNode;
+    updateIntentStatus(nodeId: string, sessionId: string, status: IntentStatus): void;
+    /**
+     * 直接 patch 节点字段（仅 GraphBridge.onTaskUpdated 等结构化调用方使用）。
+     * 用于把 TaskBoard task:updated 投影到对应 Intent 节点的 title/content/tags/status，
+     * 解决 Leader update_task 修改 description 后 Intent 节点停留在 createTask 快照的问题。
+     */
+    updateNode(nodeId: string, sessionId: string, updates: Partial<Pick<GraphNode, 'title' | 'content' | 'tags' | 'intentStatus' | 'priority' | 'evidence'>>): void;
+    supersedeNode(nodeId: string, sessionId: string, supersededByNodeId: string): void;
+    /**
+     * 写入或更新一个 group 投影节点。
+     * - 若已存在带 `group:<name>` tag 的 hint 节点，则 supersede 旧节点，写入新节点；
+     * - payload.members / payload.leader / payload.workspace 等都序列化进 content。
+     * @returns 新节点
+     */
+    addGroupTag(sessionId: string, name: string, payload: {
+        leader: string;
+        members: string[];
+        workspace?: string;
+        description?: string;
+    }): GraphNode;
+    /**
+     * 释放 group 投影 — 把现存活的 group 节点全部 supersede 到一个 release fact。
+     * Reviewer / DispatcherEngine 看到 `group:<name>` 但 supersededBy 非空就视为已解散。
+     */
+    releaseGroupTag(sessionId: string, name: string, reason?: string): GraphNode | null;
+    /**
+     * 读取当前活跃的 group 投影节点（不含已解散的）。
+     */
+    getActiveGroup(sessionId: string, name: string): GraphNode | null;
+    claimIntent(intentId: string, sessionId: string, workerId: string): boolean;
+    releaseIntent(intentId: string, sessionId: string, workerId: string): void;
+    /**
+     * 写入节点并在超过上限时剪枝（所有 addX 入口的单点限流）。
+     * 覆盖 worker 批量写之外的所有路径：Leader 直接工具（write_fact/declare_intent）、
+     * GraphBridge、collaboration 事件（review/verdict/decision）。未超上限时仅一次 COUNT 查询即返回；
+     * 剪枝失败不阻断写入（addX 仍返回刚插入的节点）。
+     */
+    private normalizeNodeForStorage;
+    private persistNodeAndBound;
+    prune(sessionId: string, maxNodes: number, maxEdges: number): void;
+    getNode(id: string, sessionId: string): GraphNode | null;
+    getNodesByKind(sessionId: string, kind: NodeKind): GraphNode[];
+    getNodesByTag(sessionId: string, tag: string): GraphNode[];
+    addEdge(input: Omit<GraphEdge, 'id' | 'createdAt'>): GraphEdge;
+    getEdgesFrom(sessionId: string, nodeId: string): GraphEdge[];
+    getEdgesTo(sessionId: string, nodeId: string): GraphEdge[];
+    /**
+     * BFS 提取以 centerNodeId 为中心的子图
+     */
+    getSubgraph(sessionId: string, centerNodeId: string, maxDepth?: number): GraphSnapshot;
+    /**
+     * 获取可调度的 Intent(status=open 且无未解决的 depends_on 依赖)。
+     * 委托通用 DagScheduler:把 depends_on 图边聚合成节点视图,保留黑板特殊语义
+     * (依赖源不存在→已解决;非 intent 依赖→已满足)。语义等价于原内联实现。
+     */
+    getDispatchableIntents(sessionId: string): GraphNode[];
+    /**
+     * 检测图中的矛盾（contradicts 边）
+     */
+    getContradictions(sessionId: string): Array<{
+        nodeA: GraphNode;
+        nodeB: GraphNode;
+        edge: GraphEdge;
+    }>;
+    /**
+     * 分析图状态，供 Dispatcher 使用
+     */
+    analyze(sessionId: string): GraphAnalysis;
+    /**
+     * 获取完整快照
+     */
+    /** 轻量计数(COUNT 查询),供 EternalLoop silence-gate 等高频轮询用,避免 getSnapshot 全量物化(#52)。 */
+    getCounts(sessionId: string): {
+        nodes: number;
+        edges: number;
+    };
+    getSnapshot(sessionId: string): GraphSnapshot;
+    /**
+     * 原子批量写入 Worker 输出
+     */
+    applyWorkerOutput(sessionId: string, taskId: string, output: WorkerGraphOutput): void;
+    /**
+     * 原子批量写入 + 自动裁剪
+     */
+    applyWorkerOutputAndPrune(sessionId: string, taskId: string, output: WorkerGraphOutput, maxNodes?: number, maxEdges?: number): void;
+}
+//# sourceMappingURL=BlackboardGraph.d.ts.map

package/dist/core/blackboard/BlackboardGraph.d.ts.map

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