@lingxiao-office/sdk 1.0.0

package/dist/core/TurnCoordinator.js

@@ -0,0 +1,112 @@
+import { t } from '../i18n.js';
+import { deriveRuntimeWaitGate } from './StateSemantics.js';
+export class TurnCoordinator {
+    classify(state) {
+        const waitGate = deriveRuntimeWaitGate(state);
+        if (waitGate?.kind === 'permission') {
+            const request = state.leader.pendingPermissionRequest;
+            return {
+                kind: 'permission_approval',
+                waiting: true,
+                source: waitGate.source,
+                summary: request?.toolName ? t('turn.waiting_permission_tool', request.toolName) : t('turn.waiting_permission'),
+            };
+        }
+        if (waitGate?.kind === 'review') {
+            return {
+                kind: 'review',
+                waiting: true,
+                source: waitGate.source,
+                summary: t('turn.waiting_review'),
+            };
+        }
+        if (waitGate?.kind === 'ask_user') {
+            return {
+                kind: 'waiting',
+                waiting: true,
+                source: waitGate.source,
+                summary: state.pendingUserGate?.preview
+                    ? t('turn.waiting_user_answer_preview', state.pendingUserGate.preview)
+                    : t('turn.waiting_user_answer'),
+            };
+        }
+        if (waitGate?.kind === 'idle') {
+            return {
+                kind: 'idle',
+                waiting: false,
+                source: waitGate.source,
+                summary: state.pendingUserGate?.preview || t('turn.session_idle_waiting_instruction'),
+            };
+        }
+        if (waitGate?.kind === 'waiting') {
+            return {
+                kind: 'waiting',
+                waiting: true,
+                source: waitGate.source,
+                summary: t('turn.waiting_user_input'),
+            };
+        }
+        const hasActiveWork = state.leader.busy ||
+            state.leader.running ||
+            state.hasRunningWorkers ||
+            state.hasRecoveringTasks ||
+            state.hasDispatchableTasks;
+        if (state.pendingUserInput.kind === 'message' &&
+            hasActiveWork &&
+            !state.leader.waitingForUser) {
+            return {
+                kind: 'user_intervention',
+                waiting: false,
+                source: 'user',
+                summary: state.pendingUserInput.preview
+                    ? t('turn.user_intervention_preview', state.pendingUserInput.preview)
+                    : t('turn.user_intervention'),
+            };
+        }
+        if (state.pendingUserInput.kind === 'message') {
+            return {
+                kind: 'user_input',
+                waiting: false,
+                source: 'user',
+                summary: state.pendingUserInput.preview
+                    ? t('turn.processing_user_input_preview', state.pendingUserInput.preview)
+                    : t('turn.processing_user_input'),
+            };
+        }
+        if (state.hasRunningWorkers) {
+            return {
+                kind: 'worker_report',
+                waiting: false,
+                source: 'worker',
+                summary: t('turn.waiting_workers', state.runningWorkerCount),
+            };
+        }
+        if (state.hasRecoveringTasks) {
+            return {
+                kind: 'worker_recovery',
+                waiting: false,
+                source: 'worker',
+                summary: t('turn.worker_recovery', state.recoveringTaskCount),
+            };
+        }
+        if (state.leader.busy ||
+            (state.leader.running && !state.leader.waitingForUser) ||
+            state.hasDispatchableTasks) {
+            return {
+                kind: 'leader_processing',
+                waiting: false,
+                source: 'leader',
+                summary: state.hasDispatchableTasks
+                    ? t('turn.leader_processing_dispatchable', state.dispatchableTaskCount)
+                    : t('turn.leader_processing_session'),
+            };
+        }
+        return {
+            kind: 'idle',
+            waiting: false,
+            source: 'system',
+            summary: t('turn.session_idle'),
+        };
+    }
+}
+//# sourceMappingURL=TurnCoordinator.js.map

package/dist/core/TurnCoordinator.js.map

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

package/dist/core/UpdateChecker.d.ts

@@ -0,0 +1,32 @@
+/**
+ * UpdateChecker — 启动后自动检查新版本
+ *
+ * 功能：
+ * 1. 服务器启动后延迟 10s 异步检查 GitHub releases
+ * 2. 发现新版本时 emit notification:new 推送到 TUI / WebUI
+ * 3. 每 24h 定期检查
+ * 4. 同版本不重复通知（进程生命周期内）
+ *
+ * 使用 native fetch（Node 18+），不阻塞启动。
+ */
+import { EventEmitter } from './EventEmitter.js';
+export declare class UpdateChecker {
+    private emitter;
+    private getActiveSessionIds;
+    private intervalTimer;
+    private initialTimer;
+    /** 已通知过的版本，避免重复推送 */
+    private notifiedVersions;
+    constructor(emitter: EventEmitter, getActiveSessionIds: () => string[]);
+    /** 启动检查 */
+    start(): void;
+    /** 停止检查 */
+    stop(): void;
+    /** 执行一次版本检查 */
+    private check;
+    /** 异步查询 GitHub releases/latest */
+    private fetchLatestRelease;
+    /** 向所有活跃 session 推送更新通知 */
+    private emitUpdateNotification;
+}
+//# sourceMappingURL=UpdateChecker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UpdateChecker.d.ts","sourceRoot":"","sources":["../../src/core/UpdateChecker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAmCjD,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,mBAAmB,CAAiB;IAC5C,OAAO,CAAC,aAAa,CAA+C;IACpE,OAAO,CAAC,YAAY,CAA8C;IAClE,qBAAqB;IACrB,OAAO,CAAC,gBAAgB,CAA0B;gBAEtC,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,MAAM,EAAE;IAKtE,WAAW;IACX,KAAK,IAAI,IAAI;IAcb,WAAW;IACX,IAAI,IAAI,IAAI;IAWZ,eAAe;YACD,KAAK;IAgBnB,kCAAkC;YACpB,kBAAkB;IAsBhC,2BAA2B;IAC3B,OAAO,CAAC,sBAAsB;CAqB/B"}

package/dist/core/UpdateChecker.js

@@ -0,0 +1,129 @@
+/**
+ * UpdateChecker — 启动后自动检查新版本
+ *
+ * 功能：
+ * 1. 服务器启动后延迟 10s 异步检查 GitHub releases
+ * 2. 发现新版本时 emit notification:new 推送到 TUI / WebUI
+ * 3. 每 24h 定期检查
+ * 4. 同版本不重复通知（进程生命周期内）
+ *
+ * 使用 native fetch（Node 18+），不阻塞启动。
+ */
+import { VERSION } from '../version.js';
+// 基座可配置：产品线可通过 LINGXIAO_RELEASE_REPO 覆盖检查更新的 GitHub 仓库（owner/repo）；
+// 未设置时保持原默认仓库，行为不变。
+const RELEASE_REPO = (process.env.LINGXIAO_RELEASE_REPO || 'hexian2001/lingxiao-coding').trim();
+const GITHUB_API = `https://api.github.com/repos/${RELEASE_REPO}/releases/latest`;
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24 小时
+const INITIAL_DELAY_MS = 10_000; // 启动后 10s
+// ── semver 比较（与 cli_upgrade.ts 保持一致） ──────────────────────────────────
+function parseSemver(v) {
+    const cleaned = v.replace(/^v/, '');
+    const parts = cleaned.split('.').map((s) => parseInt(s, 10) || 0);
+    return [parts[0] || 0, parts[1] || 0, parts[2] || 0];
+}
+function compareVersions(a, b) {
+    const [aMaj, aMin, aPat] = parseSemver(a);
+    const [bMaj, bMin, bPat] = parseSemver(b);
+    if (aMaj !== bMaj)
+        return aMaj - bMaj;
+    if (aMin !== bMin)
+        return aMin - bMin;
+    return aPat - bPat;
+}
+// ── UpdateChecker ─────────────────────────────────────────────────────────────
+export class UpdateChecker {
+    emitter;
+    getActiveSessionIds;
+    intervalTimer = null;
+    initialTimer = null;
+    /** 已通知过的版本，避免重复推送 */
+    notifiedVersions = new Set();
+    constructor(emitter, getActiveSessionIds) {
+        this.emitter = emitter;
+        this.getActiveSessionIds = getActiveSessionIds;
+    }
+    /** 启动检查 */
+    start() {
+        // 延迟首次检查，等待 session 初始化
+        this.initialTimer = setTimeout(() => {
+            this.check().catch(() => { });
+        }, INITIAL_DELAY_MS);
+        this.initialTimer.unref?.();
+        // 定期检查
+        this.intervalTimer = setInterval(() => {
+            this.check().catch(() => { });
+        }, CHECK_INTERVAL_MS);
+        this.intervalTimer.unref?.();
+    }
+    /** 停止检查 */
+    stop() {
+        if (this.initialTimer) {
+            clearTimeout(this.initialTimer);
+            this.initialTimer = null;
+        }
+        if (this.intervalTimer) {
+            clearInterval(this.intervalTimer);
+            this.intervalTimer = null;
+        }
+    }
+    /** 执行一次版本检查 */
+    async check() {
+        let release;
+        try {
+            release = await this.fetchLatestRelease();
+        }
+        catch {
+            return; // 网络不可用或 API 异常，静默跳过
+        }
+        if (compareVersions(release.version, VERSION) <= 0)
+            return; // 已是最新
+        if (this.notifiedVersions.has(release.version))
+            return; // 已通知过
+        this.notifiedVersions.add(release.version);
+        this.emitUpdateNotification(release);
+    }
+    /** 异步查询 GitHub releases/latest */
+    async fetchLatestRelease() {
+        const response = await fetch(GITHUB_API, {
+            headers: { 'User-Agent': 'lingxiao-cli' },
+            signal: AbortSignal.timeout(15000),
+        });
+        if (!response.ok) {
+            throw new Error(`GitHub API returned ${response.status}`);
+        }
+        const data = await response.json();
+        const tag = data.tag_name || '';
+        if (!tag)
+            throw new Error('GitHub API format error');
+        return {
+            tag,
+            version: tag.replace(/^v/, ''),
+            htmlUrl: data.html_url || '',
+            publishedAt: data.published_at || '',
+        };
+    }
+    /** 向所有活跃 session 推送更新通知 */
+    emitUpdateNotification(release) {
+        const notification = {
+            id: `update_available_${release.version}_${Date.now()}`,
+            type: 'update_available',
+            priority: 'important',
+            title: `★ 发现新版本 ${release.tag}`,
+            message: `当前版本 v${VERSION}，最新版本 ${release.tag}。运行 \`lingxiao upgrade\` 升级。`,
+            timestamp: Date.now(),
+            read: false,
+        };
+        const sessionIds = this.getActiveSessionIds();
+        if (sessionIds.length > 0) {
+            for (const sid of sessionIds) {
+                this.emitter.emit('notification:new', { ...notification, sessionId: sid });
+            }
+        }
+        else {
+            // 无活跃 session — TUI 通过本地 emitter 仍可收到
+            this.emitter.emit('notification:new', notification);
+        }
+    }
+}
+//# sourceMappingURL=UpdateChecker.js.map

package/dist/core/UpdateChecker.js.map

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

package/dist/core/UserAgent.d.ts

@@ -0,0 +1,5 @@
+export { DEFAULT_LINGXIAO_USER_AGENT, isValidUserAgent, } from '../version.js';
+export declare function normalizeUserAgent(value: unknown): string;
+export declare function getEffectiveUserAgent(): string;
+export declare function withUserAgentHeader(input: RequestInfo | URL, init?: RequestInit): RequestInit;
+//# sourceMappingURL=UserAgent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UserAgent.d.ts","sourceRoot":"","sources":["../../src/core/UserAgent.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,2BAA2B,EAC3B,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAIvB,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIzD;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAG9C;AAcD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,WAAW,CAK7F"}

package/dist/core/UserAgent.js

@@ -0,0 +1,34 @@
+import { config as runtimeConfig } from '../config.js';
+import { DEFAULT_LINGXIAO_USER_AGENT, isLingxiaoDefaultUserAgent, isValidUserAgent, } from '../version.js';
+export { DEFAULT_LINGXIAO_USER_AGENT, isValidUserAgent, } from '../version.js';
+const USER_AGENT_HEADER = 'User-Agent';
+export function normalizeUserAgent(value) {
+    const raw = typeof value === 'string' ? value.trim() : '';
+    if (!raw || isLingxiaoDefaultUserAgent(raw) || !isValidUserAgent(raw))
+        return DEFAULT_LINGXIAO_USER_AGENT;
+    return raw;
+}
+export function getEffectiveUserAgent() {
+    const configured = runtimeConfig.network?.user_agent;
+    return normalizeUserAgent(configured);
+}
+function mergeHeaders(input, headers) {
+    const next = new Headers();
+    if (typeof Request !== 'undefined' && input instanceof Request) {
+        for (const [key, value] of input.headers.entries())
+            next.set(key, value);
+    }
+    if (headers) {
+        for (const [key, value] of new Headers(headers).entries())
+            next.set(key, value);
+    }
+    next.set(USER_AGENT_HEADER, getEffectiveUserAgent());
+    return next;
+}
+export function withUserAgentHeader(input, init) {
+    return {
+        ...(init || {}),
+        headers: mergeHeaders(input, init?.headers),
+    };
+}
+//# sourceMappingURL=UserAgent.js.map

package/dist/core/UserAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserAgent.js","sourceRoot":"","sources":["../../src/core/UserAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,2BAA2B,EAC3B,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAEvC,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1D,IAAI,CAAC,GAAG,IAAI,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC;QAAE,OAAO,2BAA2B,CAAC;IAC1G,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,MAAM,UAAU,GAAI,aAAmE,CAAC,OAAO,EAAE,UAAU,CAAC;IAC5G,OAAO,kBAAkB,CAAC,UAAU,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,YAAY,CAAC,KAAwB,EAAE,OAAqB;IACnE,MAAM,IAAI,GAAG,IAAI,OAAO,EAAE,CAAC;IAC3B,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,KAAK,YAAY,OAAO,EAAE,CAAC;QAC/D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,qBAAqB,EAAE,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAwB,EAAE,IAAkB;IAC9E,OAAO;QACL,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;QACf,OAAO,EAAE,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC;KAC5C,CAAC;AACJ,CAAC"}

package/dist/core/VerificationPipeline.d.ts

@@ -0,0 +1,47 @@
+import { BuildDiagnosticsCollector } from './BuildDiagnosticsCollector.js';
+import { ChangeImpactResolver } from './ChangeImpactResolver.js';
+import { TestRunnerAdapter } from './TestRunnerAdapter.js';
+type LoggerLike = {
+    debug?: (msg: string, ...args: unknown[]) => void;
+    warn?: (msg: string, ...args: unknown[]) => void;
+};
+export interface VerificationGateConfig {
+    typeCheck: boolean;
+    build: boolean;
+    affectedTests: boolean;
+    fullTests: boolean;
+    selfRepairBudget: number;
+    buildTimeoutMs: number;
+    testTimeoutMs: number;
+}
+export type VerificationGateName = 'typeCheck' | 'build' | 'affectedTests' | 'fullTests';
+export interface GateResult {
+    gate: VerificationGateName;
+    passed: boolean;
+    durationMs: number;
+    diagnostics: string[];
+    totalRun?: number;
+    failedTests?: string[];
+}
+export interface VerificationResult {
+    allPassed: boolean;
+    gates: GateResult[];
+    totalDurationMs: number;
+    affectedTests: string[];
+}
+export interface VerificationPipelineDeps {
+    buildDiagnostics: BuildDiagnosticsCollector;
+    changeImpactResolver: ChangeImpactResolver;
+    testRunner: TestRunnerAdapter;
+    logger?: LoggerLike;
+}
+export declare class VerificationPipeline {
+    private readonly buildDiagnostics;
+    private readonly changeImpactResolver;
+    private readonly testRunner;
+    private readonly logger?;
+    constructor(deps: VerificationPipelineDeps);
+    verify(workingDir: string, changedFiles: string[], config?: Partial<VerificationGateConfig>): Promise<VerificationResult>;
+}
+export {};
+//# sourceMappingURL=VerificationPipeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VerificationPipeline.d.ts","sourceRoot":"","sources":["../../src/core/VerificationPipeline.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAqC,MAAM,gCAAgC,CAAC;AAC9G,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAsB,MAAM,wBAAwB,CAAC;AAE/E,KAAK,UAAU,GAAG;IAChB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAClD,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CAClD,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,OAAO,GAAG,eAAe,GAAG,WAAW,CAAC;AAEzF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACvC,gBAAgB,EAAE,yBAAyB,CAAC;IAC5C,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,UAAU,EAAE,iBAAiB,CAAC;IAC9B,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AA4DD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA4B;IAC7D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAuB;IAC5D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAa;gBAEzB,IAAI,EAAE,wBAAwB;IAOpC,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EAAE,EACtB,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACvC,OAAO,CAAC,kBAAkB,CAAC;CAgF/B"}

package/dist/core/VerificationPipeline.js

@@ -0,0 +1,144 @@
+import { isAbsolute, relative } from 'node:path';
+const DEFAULT_CONFIG = {
+    typeCheck: true,
+    build: true,
+    affectedTests: true,
+    fullTests: false,
+    selfRepairBudget: 3,
+    buildTimeoutMs: 120_000,
+    testTimeoutMs: 120_000,
+};
+function normalizeConfig(config) {
+    return { ...DEFAULT_CONFIG, ...(config ?? {}) };
+}
+function diagnosticToString(diagnostic) {
+    const code = diagnostic.code ? ` [${diagnostic.code}]` : '';
+    return `${diagnostic.file}:${diagnostic.line}:${diagnostic.column}${code} ${diagnostic.message}`;
+}
+function buildResultDiagnostics(results) {
+    return results.flatMap((result) => result.diagnostics.filter((diagnostic) => diagnostic.severity === 'error'))
+        .map(diagnosticToString);
+}
+function failedGate(result) {
+    return {
+        allPassed: false,
+        gates: [result],
+        totalDurationMs: result.durationMs,
+        affectedTests: [],
+    };
+}
+function normalizeChangedFiles(projectRoot, changedFiles) {
+    const seen = new Set();
+    const out = [];
+    for (const file of changedFiles) {
+        const trimmed = file.trim();
+        if (!trimmed)
+            continue;
+        const rel = (isAbsolute(trimmed) ? relative(projectRoot, trimmed) : trimmed).replaceAll('\\', '/');
+        if (!rel || rel.startsWith('..') || seen.has(rel))
+            continue;
+        seen.add(rel);
+        out.push(rel);
+    }
+    return out;
+}
+function testRunToGate(gate, result) {
+    return {
+        gate,
+        passed: result.passed,
+        durationMs: result.durationMs,
+        diagnostics: result.diagnostics,
+        totalRun: result.totalRun,
+        failedTests: result.failedTests,
+    };
+}
+export class VerificationPipeline {
+    buildDiagnostics;
+    changeImpactResolver;
+    testRunner;
+    logger;
+    constructor(deps) {
+        this.buildDiagnostics = deps.buildDiagnostics;
+        this.changeImpactResolver = deps.changeImpactResolver;
+        this.testRunner = deps.testRunner;
+        this.logger = deps.logger;
+    }
+    async verify(workingDir, changedFiles, config) {
+        const cfg = normalizeConfig(config);
+        const start = Date.now();
+        const gates = [];
+        const normalizedChangedFiles = normalizeChangedFiles(workingDir, changedFiles);
+        let affectedTests = [];
+        if (cfg.typeCheck) {
+            const gateStart = Date.now();
+            const quick = await this.buildDiagnostics.quickCheck(workingDir, cfg.buildTimeoutMs);
+            const gate = {
+                gate: 'typeCheck',
+                passed: quick.passed,
+                durationMs: Date.now() - gateStart,
+                diagnostics: quick.diagnostics.map(diagnosticToString),
+            };
+            gates.push(gate);
+            if (!gate.passed) {
+                return { ...failedGate(gate), gates, totalDurationMs: Date.now() - start };
+            }
+        }
+        if (cfg.build) {
+            const gateStart = Date.now();
+            const results = await this.buildDiagnostics.collectAll(workingDir, cfg.buildTimeoutMs);
+            const diagnostics = buildResultDiagnostics(results);
+            const gate = {
+                gate: 'build',
+                passed: diagnostics.length === 0,
+                durationMs: Date.now() - gateStart,
+                diagnostics,
+            };
+            gates.push(gate);
+            if (!gate.passed) {
+                return { ...failedGate(gate), gates, totalDurationMs: Date.now() - start };
+            }
+        }
+        if (cfg.affectedTests && normalizedChangedFiles.length > 0) {
+            try {
+                const impact = await this.changeImpactResolver.resolve(normalizedChangedFiles);
+                affectedTests = impact.affectedTests;
+            }
+            catch (error) {
+                const gate = {
+                    gate: 'affectedTests',
+                    passed: false,
+                    durationMs: Date.now() - start,
+                    diagnostics: [error instanceof Error ? error.message : String(error)],
+                };
+                gates.push(gate);
+                return { ...failedGate(gate), gates, totalDurationMs: Date.now() - start, affectedTests };
+            }
+            if (affectedTests.length > 0) {
+                const result = await this.testRunner.runTests(affectedTests);
+                const gate = testRunToGate('affectedTests', result);
+                gates.push(gate);
+                if (!gate.passed) {
+                    return { ...failedGate(gate), gates, totalDurationMs: Date.now() - start, affectedTests };
+                }
+            }
+            else {
+                this.logger?.debug?.('[VerificationPipeline] no affected tests for changed files', normalizedChangedFiles);
+            }
+        }
+        if (cfg.fullTests) {
+            const result = await this.testRunner.runTests();
+            const gate = testRunToGate('fullTests', result);
+            gates.push(gate);
+            if (!gate.passed) {
+                return { ...failedGate(gate), gates, totalDurationMs: Date.now() - start, affectedTests };
+            }
+        }
+        return {
+            allPassed: true,
+            gates,
+            totalDurationMs: Date.now() - start,
+            affectedTests,
+        };
+    }
+}
+//# sourceMappingURL=VerificationPipeline.js.map

package/dist/core/VerificationPipeline.js.map

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

package/dist/core/WorkNoteManager.d.ts

@@ -0,0 +1,94 @@
+/**
+ * 工作阶段枚举
+ */
+export type WorkNotePhase = 'research' | 'coding' | 'testing' | 'reviewing' | 'other';
+/**
+ * 结构化工作笔记
+ */
+export interface WorkNote {
+    id: string;
+    agentId: string;
+    taskId: string;
+    timestamp: number;
+    phase: WorkNotePhase;
+    summary: string;
+    details?: string;
+    artifacts?: string[];
+    blockers?: string[];
+    nextSteps?: string[];
+    keyFindings?: string[];
+    impactAnalysis?: string;
+}
+/**
+ * 工作笔记管理器
+ * 负责笔记的创建、读取、更新和持久化
+ */
+export declare class WorkNoteManager {
+    /** 内存索引：sessionId → agentId → notes[] */
+    private index;
+    /** 基础目录 */
+    private baseDir;
+    constructor(baseDir?: string);
+    /**
+     * 获取笔记文件路径
+     */
+    private getNotesFilePath;
+    /**
+     * 获取 agents 目录路径
+     */
+    private getAgentsDir;
+    /**
+     * 确保 agent 笔记目录存在
+     */
+    private ensureDirExists;
+    /**
+     * 确保 agents 目录存在
+     */
+    private ensureAgentsDirExists;
+    /**
+     * 从文件加载笔记到内存索引
+     * 文件不存在时视为空，不报错
+     *
+     * @param forceReload 强制重新读盘，忽略内存缓存。
+     *   Why：notes.jsonl 是跨进程追加写的（worker 子进程各自写自己的，Leader/TeamSynchronizer
+     *   持有常驻单例读）。若读路径命中"写一次永久缓存"，常驻读者第一次加载后就再也看不到其他进程
+     *   后续追加的笔记 —— 表现为"明明写了却读不到"。所以所有读路径必须 forceReload，以磁盘为准。
+     *   写路径也 reload，确保 append 前内存数组与磁盘一致（避免并发写丢笔记 / 驱逐基于陈旧计数）。
+     */
+    private loadIntoIndex;
+    /**
+     * 写入工作笔记
+     * 自动截断超长字段，追加写入 JSONL 文件，更新内存索引
+     */
+    writeNote(sessionId: string, input: Omit<WorkNote, 'id' | 'timestamp'>): Promise<WorkNote>;
+    /**
+     * 写入笔记并指定 sessionId（推荐使用此方法）
+     */
+    writeNoteWithSession(sessionId: string, input: Omit<WorkNote, 'id' | 'timestamp'>): Promise<WorkNote>;
+    /**
+     * 从文件系统发现会话中的所有 Agent
+     * 目录不存在时视为空，不报错
+     */
+    private discoverAgents;
+    /**
+     * 重写笔记文件（用于更新操作）
+     */
+    private rewriteNotesFile;
+    /**
+     * 获取指定 Agent 的所有笔记
+     */
+    getAgentNotes(sessionId: string, agentId: string): Promise<WorkNote[]>;
+    /**
+     * 获取指定会话所有 Agent 的笔记
+     */
+    getAllNotes(sessionId: string): Promise<WorkNote[]>;
+    /**
+     * 更新笔记 — 仅允许笔记所有者更新
+     */
+    updateNote(sessionId: string, agentId: string, callerAgentId: string, noteId: string, updates: Partial<Pick<WorkNote, 'details' | 'artifacts' | 'blockers' | 'nextSteps'>>): Promise<WorkNote>;
+    /**
+     * 获取 Agent 的最新笔记
+     */
+    getLatestNote(sessionId: string, agentId: string): Promise<WorkNote | null>;
+}
+//# sourceMappingURL=WorkNoteManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WorkNoteManager.d.ts","sourceRoot":"","sources":["../../src/core/WorkNoteManager.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA8BD;;;GAGG;AACH,qBAAa,eAAe;IAC1B,yCAAyC;IACzC,OAAO,CAAC,KAAK,CAAmD;IAChE,WAAW;IACX,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,CAAC,EAAE,MAAM;IAI5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;YACW,eAAe;IAK7B;;OAEG;YACW,qBAAqB;IAKnC;;;;;;;;;OASG;YACW,aAAa;IAmC3B;;;OAGG;IACG,SAAS,CACb,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,WAAW,CAAC,GACxC,OAAO,CAAC,QAAQ,CAAC;IAIpB;;OAEG;IACG,oBAAoB,CACxB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,WAAW,CAAC,GACxC,OAAO,CAAC,QAAQ,CAAC;IA2DpB;;;OAGG;YACW,cAAc;IAoB5B;;OAEG;YACW,gBAAgB;IAQ9B;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAO5E;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAczD;;OAEG;IACG,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC,CAAC,GACnF,OAAO,CAAC,QAAQ,CAAC;IAgCpB;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;CAIlF"}