@lingxiao-office/sdk 1.0.0

package/dist/core/AutonomousFaultPolicy.js

@@ -0,0 +1,108 @@
+export function applyRecoveryAttemptBudget(decision, attempt, maxAttempts) {
+    if (decision.status === 'blocked') {
+        return decision;
+    }
+    if (attempt < maxAttempts) {
+        return decision;
+    }
+    return {
+        ...decision,
+        status: 'blocked',
+        recoveryAction: 'leader_takeover',
+        reason: `recovery budget exhausted after ${attempt} attempts: ${decision.reason}`,
+    };
+}
+function hasPattern(text, patterns) {
+    return patterns.some((pattern) => pattern.test(text));
+}
+export function classifyAutonomousFault(input) {
+    const reason = String(input.reason || '').trim() || 'unknown runtime fault';
+    const normalized = reason.toLowerCase();
+    // rate_limited（Retry-After 超过重试预算可 honor 的上限）：不可重试，需外部冷却。
+    // 挂到 waiting_external，由 Leader 在 cooldown 到期后再驱动，而非 worker 空转烧 token。
+    if (input.llmErrorKind === 'rate_limited') {
+        return {
+            category: 'external_blocking',
+            recoveryAction: 'waiting_external',
+            status: 'blocked',
+            reason,
+        };
+    }
+    if (hasPattern(normalized, [
+        /invalid api key/,
+        /unauthorized/,
+        /forbidden/,
+        /permission/,
+        /approval/,
+        /ask_user/,
+        /missing user input/,
+        /credential/,
+        /auth/,
+        /not configured/,
+        /missing required/,
+        /requires external/,
+        /model .*not found/,
+        /模型 .*未找到/,
+        /缺少 api key/,
+        /缺少 baseurl/,
+        /enoent/,
+        /spawn .* enoent/,
+    ]) ||
+        input.faultClass === 'external_agent_auth' ||
+        input.faultClass === 'external_agent_config') {
+        return {
+            category: 'external_blocking',
+            recoveryAction: 'waiting_external',
+            status: 'blocked',
+            reason,
+        };
+    }
+    if (input.llmErrorKind === 'connect_timeout' ||
+        input.llmErrorKind === 'request_timeout' ||
+        input.llmErrorKind === 'stream_timeout' ||
+        input.llmErrorKind === 'network_error' ||
+        (input.llmErrorKind === 'provider_error' && hasPattern(normalized, [/429/, /rate limit/, /retry after/, /temporar/, /unavailable/])) ||
+        hasPattern(normalized, [
+            /429/,
+            /rate limit/,
+            /retry after/,
+            /temporar/,
+            /network/,
+            /timed out/,
+            /socket hang up/,
+            /econn/,
+            /enotfound/,
+            /eai_again/,
+        ]) ||
+        input.faultClass === 'external_agent_timeout') {
+        return {
+            category: 'external_retryable',
+            recoveryAction: 'worker_restart',
+            status: 'recovering',
+            reason,
+        };
+    }
+    const faultClass = input.faultClass;
+    if (faultClass === 'worker_heartbeat_timeout' ||
+        faultClass === 'worker_max_runtime' ||
+        faultClass === 'worker_health_runaway' ||
+        faultClass === 'worker_crashed' ||
+        faultClass === 'worker_exit' ||
+        faultClass === 'worker_stopped' ||
+        faultClass === 'external_agent_crashed' ||
+        faultClass === 'external_agent_protocol') {
+        return {
+            category: 'internal_recoverable',
+            recoveryAction: 'worker_redispatch',
+            status: 'recovering',
+            reason,
+        };
+    }
+    return {
+        category: 'internal_recoverable',
+        recoveryAction: 'leader_takeover',
+        status: 'recovering',
+        reason,
+    };
+}
+//# sourceMappingURL=AutonomousFaultPolicy.js.map

package/dist/core/AutonomousFaultPolicy.js.map

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

package/dist/core/BaselineAlertMonitor.d.ts

@@ -0,0 +1,25 @@
+/**
+ * BaselineAlertMonitor — P2: 执行指标偏离检测与告警。
+ *
+ * 对比当前执行指标与基线，检测偏离并通过 EventEmitter 发送告警事件。
+ * 告警条件：
+ *   - 执行时间 > baseline.p90Duration * 1.5 → slow_execution
+ *   - token 消耗 > baseline.avgTokens * 2 → token_bloat
+ *   - 成功率连续 3 次低于 baseline.successRate * 0.5 → success_rate_drop
+ */
+import { EventEmitter } from 'node:events';
+import type { ExecutionMetric, Baseline } from './PerformanceBaselineTracker.js';
+export interface DeviationAlert {
+    type: 'slow_execution' | 'token_bloat' | 'success_rate_drop';
+    taskType: string;
+    role: string;
+    currentValue: number;
+    baselineValue: number;
+    message: string;
+}
+export declare class BaselineAlertMonitor extends EventEmitter {
+    private readonly recentResults;
+    checkDeviation(metric: ExecutionMetric, baseline: Baseline): DeviationAlert | null;
+    emitAlert(alert: DeviationAlert): void;
+}
+//# sourceMappingURL=BaselineAlertMonitor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BaselineAlertMonitor.d.ts","sourceRoot":"","sources":["../../src/core/BaselineAlertMonitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAEjF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,gBAAgB,GAAG,aAAa,GAAG,mBAAmB,CAAC;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAOD,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgC;IAE9D,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,GAAG,cAAc,GAAG,IAAI;IAkDlF,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;CAGvC"}

package/dist/core/BaselineAlertMonitor.js

@@ -0,0 +1,66 @@
+/**
+ * BaselineAlertMonitor — P2: 执行指标偏离检测与告警。
+ *
+ * 对比当前执行指标与基线，检测偏离并通过 EventEmitter 发送告警事件。
+ * 告警条件：
+ *   - 执行时间 > baseline.p90Duration * 1.5 → slow_execution
+ *   - token 消耗 > baseline.avgTokens * 2 → token_bloat
+ *   - 成功率连续 3 次低于 baseline.successRate * 0.5 → success_rate_drop
+ */
+import { EventEmitter } from 'node:events';
+const SLOW_EXECUTION_FACTOR = 1.5;
+const TOKEN_BLOAT_FACTOR = 2.0;
+const SUCCESS_RATE_DROP_FACTOR = 0.5;
+const SUCCESS_RATE_CONSECUTIVE_THRESHOLD = 3;
+export class BaselineAlertMonitor extends EventEmitter {
+    recentResults = new Map();
+    checkDeviation(metric, baseline) {
+        const key = `${metric.taskType}:${metric.role}`;
+        // Check slow execution
+        if (metric.durationMs > baseline.p90Duration * SLOW_EXECUTION_FACTOR) {
+            return {
+                type: 'slow_execution',
+                taskType: metric.taskType,
+                role: metric.role,
+                currentValue: metric.durationMs,
+                baselineValue: baseline.p90Duration,
+                message: `Execution ${metric.durationMs}ms > baseline p90 ${baseline.p90Duration}ms × ${SLOW_EXECUTION_FACTOR}`,
+            };
+        }
+        // Check token bloat
+        if (metric.tokenUsage > baseline.avgTokens * TOKEN_BLOAT_FACTOR) {
+            return {
+                type: 'token_bloat',
+                taskType: metric.taskType,
+                role: metric.role,
+                currentValue: metric.tokenUsage,
+                baselineValue: baseline.avgTokens,
+                message: `Token usage ${metric.tokenUsage} > baseline avg ${Math.round(baseline.avgTokens)} × ${TOKEN_BLOAT_FACTOR}`,
+            };
+        }
+        // Check success rate drop (consecutive)
+        const results = this.recentResults.get(key) ?? [];
+        results.push(metric.success);
+        if (results.length > SUCCESS_RATE_CONSECUTIVE_THRESHOLD)
+            results.shift();
+        this.recentResults.set(key, results);
+        if (results.length >= SUCCESS_RATE_CONSECUTIVE_THRESHOLD) {
+            const recentSuccessRate = results.filter(Boolean).length / results.length;
+            if (recentSuccessRate < baseline.successRate * SUCCESS_RATE_DROP_FACTOR) {
+                return {
+                    type: 'success_rate_drop',
+                    taskType: metric.taskType,
+                    role: metric.role,
+                    currentValue: recentSuccessRate,
+                    baselineValue: baseline.successRate,
+                    message: `Success rate ${recentSuccessRate.toFixed(2)} < baseline ${baseline.successRate.toFixed(2)} × ${SUCCESS_RATE_DROP_FACTOR} for ${SUCCESS_RATE_CONSECUTIVE_THRESHOLD} consecutive tasks`,
+                };
+            }
+        }
+        return null;
+    }
+    emitAlert(alert) {
+        this.emit('eternal:baseline_alert', alert);
+    }
+}
+//# sourceMappingURL=BaselineAlertMonitor.js.map

package/dist/core/BaselineAlertMonitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaselineAlertMonitor.js","sourceRoot":"","sources":["../../src/core/BaselineAlertMonitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAY3C,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAC/B,MAAM,wBAAwB,GAAG,GAAG,CAAC;AACrC,MAAM,kCAAkC,GAAG,CAAC,CAAC;AAE7C,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IACnC,aAAa,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE9D,cAAc,CAAC,MAAuB,EAAE,QAAkB;QACxD,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAEhD,uBAAuB;QACvB,IAAI,MAAM,CAAC,UAAU,GAAG,QAAQ,CAAC,WAAW,GAAG,qBAAqB,EAAE,CAAC;YACrE,OAAO;gBACL,IAAI,EAAE,gBAAgB;gBACtB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,YAAY,EAAE,MAAM,CAAC,UAAU;gBAC/B,aAAa,EAAE,QAAQ,CAAC,WAAW;gBACnC,OAAO,EAAE,aAAa,MAAM,CAAC,UAAU,qBAAqB,QAAQ,CAAC,WAAW,QAAQ,qBAAqB,EAAE;aAChH,CAAC;QACJ,CAAC;QAED,oBAAoB;QACpB,IAAI,MAAM,CAAC,UAAU,GAAG,QAAQ,CAAC,SAAS,GAAG,kBAAkB,EAAE,CAAC;YAChE,OAAO;gBACL,IAAI,EAAE,aAAa;gBACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,YAAY,EAAE,MAAM,CAAC,UAAU;gBAC/B,aAAa,EAAE,QAAQ,CAAC,SAAS;gBACjC,OAAO,EAAE,eAAe,MAAM,CAAC,UAAU,mBAAmB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,kBAAkB,EAAE;aACrH,CAAC;QACJ,CAAC;QAED,wCAAwC;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7B,IAAI,OAAO,CAAC,MAAM,GAAG,kCAAkC;YAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QACzE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAErC,IAAI,OAAO,CAAC,MAAM,IAAI,kCAAkC,EAAE,CAAC;YACzD,MAAM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAC1E,IAAI,iBAAiB,GAAG,QAAQ,CAAC,WAAW,GAAG,wBAAwB,EAAE,CAAC;gBACxE,OAAO;oBACL,IAAI,EAAE,mBAAmB;oBACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,YAAY,EAAE,iBAAiB;oBAC/B,aAAa,EAAE,QAAQ,CAAC,WAAW;oBACnC,OAAO,EAAE,gBAAgB,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,wBAAwB,QAAQ,kCAAkC,oBAAoB;iBAChM,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,CAAC,KAAqB;QAC7B,IAAI,CAAC,IAAI,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/core/BootstrapDoctor.d.ts

@@ -0,0 +1,36 @@
+/**
+ * BootstrapDoctor - 确定性安装与初始化检查
+ *
+ * 5.1: 暴露明确的 ready/not-ready 结果
+ * 5.2: 验证 config, database latest-schema init, bundled skills sync, CLI availability
+ */
+export interface BootstrapCheck {
+    name: string;
+    status: 'ok' | 'warning' | 'error';
+    message: string;
+    remediation?: string;
+}
+export interface BootstrapReport {
+    ready: boolean;
+    checks: BootstrapCheck[];
+    summary: string;
+}
+export interface BootstrapOptions {
+    workspace?: string;
+    verbose?: boolean;
+    repair?: boolean;
+}
+/**
+ * 运行完整的 bootstrap 检查
+ */
+export declare function runBootstrapDoctor(options?: BootstrapOptions): BootstrapReport;
+/**
+ * 格式化报告为字符串
+ */
+export declare function formatBootstrapReport(report: BootstrapReport): string;
+declare const _default: {
+    runBootstrapDoctor: typeof runBootstrapDoctor;
+    formatBootstrapReport: typeof formatBootstrapReport;
+};
+export default _default;
+//# sourceMappingURL=BootstrapDoctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BootstrapDoctor.d.ts","sourceRoot":"","sources":["../../src/core/BootstrapDoctor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAqOD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,gBAAqB,GAAG,eAAe,CA6BlF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CA4BrE;;;;;AAED,wBAGE"}

package/dist/core/BootstrapDoctor.js

@@ -0,0 +1,288 @@
+/**
+ * BootstrapDoctor - 确定性安装与初始化检查
+ *
+ * 5.1: 暴露明确的 ready/not-ready 结果
+ * 5.2: 验证 config, database latest-schema init, bundled skills sync, CLI availability
+ */
+import { existsSync, accessSync, constants, readFileSync, mkdirSync } from 'fs';
+import { dirname, join, resolve } from 'path';
+import { fileURLToPath } from 'url';
+import { CONFIG_DIR, SETTINGS_FILE, config } from '../config.js';
+import { commandExists } from '../utils/platform.js';
+import { getBundledSkillsDir, getGlobalSkillsDir, syncBundledSkillsToGlobalDir, } from './BundledSkillRegistry.js';
+const INIT_HINT = 'Run: lingxiao init';
+const SKILLS_HINT = 'Run: lingxiao init to sync bundled skills';
+const REQUIRED_NODE_MAJOR = 24;
+const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
+function resolveWorkspacePath(options = {}) {
+    return resolve(options.workspace || process.cwd());
+}
+/**
+ * 检查 Node.js 版本
+ */
+function checkNodeVersion() {
+    const nodeVersion = process.version;
+    const major = parseInt(nodeVersion.slice(1).split('.')[0], 10);
+    if (major < REQUIRED_NODE_MAJOR) {
+        return {
+            name: 'node_version',
+            status: 'error',
+            message: `Node.js ${nodeVersion} is too old (requires >= ${REQUIRED_NODE_MAJOR})`,
+            remediation: `Upgrade Node.js to version ${REQUIRED_NODE_MAJOR} or higher`,
+        };
+    }
+    return {
+        name: 'node_version',
+        status: 'ok',
+        message: `Node.js ${nodeVersion}`,
+    };
+}
+/**
+ * 检查配置文件
+ */
+function checkConfig() {
+    if (!existsSync(CONFIG_DIR)) {
+        return {
+            name: 'config',
+            status: 'error',
+            message: `Config directory does not exist: ${CONFIG_DIR}`,
+            remediation: INIT_HINT,
+        };
+    }
+    if (!existsSync(SETTINGS_FILE)) {
+        return {
+            name: 'config',
+            status: 'error',
+            message: `Settings file does not exist: ${SETTINGS_FILE}`,
+            remediation: INIT_HINT,
+        };
+    }
+    try {
+        const settings = JSON.parse(readFileSync(SETTINGS_FILE, 'utf-8'));
+        if (!settings.initialized) {
+            return {
+                name: 'config',
+                status: 'error',
+                message: 'Settings file exists but not marked as initialized',
+                remediation: 'Run lingxiao init to complete initialization',
+            };
+        }
+        // v3: 检查 model_providers 中是否有可用模型
+        const llm = settings.llm || {};
+        const modelProviders = llm.model_providers || {};
+        const totalModels = Object.values(modelProviders)
+            .reduce((sum, arr) => sum + (Array.isArray(arr) ? arr.length : 0), 0);
+        const leaderModel = llm.leader_model || '';
+        if (totalModels === 0 || !leaderModel) {
+            return {
+                name: 'config',
+                status: 'error',
+                message: 'No models configured in model_providers',
+                remediation: 'Add at least one model entry to llm.model_providers in settings.json',
+            };
+        }
+        return {
+            name: 'config',
+            status: 'ok',
+            message: 'Configuration is valid',
+        };
+    }
+    catch (error) {
+        return {
+            name: 'config',
+            status: 'error',
+            message: `Failed to parse settings file: ${error}`,
+            remediation: 'Delete settings file and run lingxiao init again',
+        };
+    }
+}
+/**
+ * 检查数据库
+ */
+function checkDatabase(options = {}) {
+    // 实际 DB 路径来自全局 config（~/.lingxiao/data.db），不是 workspace/.lingxiao/
+    const dbPath = config.paths?.db_path || join(CONFIG_DIR, 'data.db');
+    if (!existsSync(dbPath)) {
+        return {
+            name: 'database',
+            status: 'warning',
+            message: `Database file does not exist: ${dbPath}`,
+            remediation: 'Database will be created automatically on first run',
+        };
+    }
+    try {
+        accessSync(dbPath, constants.R_OK | constants.W_OK);
+        return {
+            name: 'database',
+            status: 'ok',
+            message: `Database is accessible: ${dbPath}`,
+        };
+    }
+    catch (error) {
+        return {
+            name: 'database',
+            status: 'error',
+            message: `Database file not accessible: ${error}`,
+            remediation: 'Check file permissions or delete the database file to recreate',
+        };
+    }
+}
+/**
+ * 检查 bundled skills
+ */
+function checkBundledSkills(options = {}) {
+    if (options.repair) {
+        try {
+            const result = syncBundledSkillsToGlobalDir({ workspace: resolveWorkspacePath(options) });
+            return {
+                name: 'bundled_skills',
+                status: 'ok',
+                message: `Bundled skills synced (copied=${result.copied.length}, skipped=${result.skipped.length}, removed=${result.removed.length})`,
+            };
+        }
+        catch (error) {
+            return {
+                name: 'bundled_skills',
+                status: 'warning',
+                message: `Failed to sync bundled skills: ${error instanceof Error ? error.message : String(error)}`,
+                remediation: SKILLS_HINT,
+            };
+        }
+    }
+    const bundledSkillsDir = getBundledSkillsDir();
+    const globalSkillsDir = getGlobalSkillsDir();
+    if (!existsSync(bundledSkillsDir)) {
+        return {
+            name: 'bundled_skills',
+            status: 'warning',
+            message: `Bundled skills directory does not exist: ${bundledSkillsDir}`,
+            remediation: SKILLS_HINT,
+        };
+    }
+    if (!existsSync(globalSkillsDir)) {
+        return {
+            name: 'global_skills_dir',
+            status: 'warning',
+            message: `Global skills directory does not exist: ${globalSkillsDir}`,
+            remediation: SKILLS_HINT,
+        };
+    }
+    return {
+        name: 'bundled_skills',
+        status: 'ok',
+        message: 'Bundled skills are available',
+    };
+}
+/**
+ * 检查 CLI 可用性
+ */
+function checkCLI(_options = {}) {
+    const localCliPath = resolve(MODULE_DIR, '../cli.js');
+    const packagedCliPath = resolve(MODULE_DIR, '../../dist/cli.js');
+    if (!existsSync(localCliPath) && !existsSync(packagedCliPath) && !commandExists('lingxiao')) {
+        return {
+            name: 'cli_entry',
+            status: 'error',
+            message: 'No executable LingXiao CLI entry was found',
+            remediation: 'Install the package first, then run: lingxiao init',
+        };
+    }
+    return {
+        name: 'cli',
+        status: 'ok',
+        message: 'CLI entry is available',
+    };
+}
+/**
+ * 检查日志目录
+ */
+function checkLogDirectory(_options = {}) {
+    const logDir = join(CONFIG_DIR, 'logs');
+    if (!existsSync(logDir)) {
+        try {
+            mkdirSync(logDir, { recursive: true });
+            return {
+                name: 'log_dir',
+                status: 'ok',
+                message: `Created log directory: ${logDir}`,
+            };
+        }
+        catch (error) {
+            return {
+                name: 'log_dir',
+                status: 'warning',
+                message: `Failed to create log directory: ${error}`,
+                remediation: 'Create the log directory manually or check permissions',
+            };
+        }
+    }
+    return {
+        name: 'log_dir',
+        status: 'ok',
+        message: `Log directory exists: ${logDir}`,
+    };
+}
+/**
+ * 运行完整的 bootstrap 检查
+ */
+export function runBootstrapDoctor(options = {}) {
+    const checks = [
+        checkNodeVersion(),
+        checkConfig(),
+        checkDatabase(options),
+        checkBundledSkills(options),
+        checkCLI(options),
+        checkLogDirectory(options),
+    ];
+    const errors = checks.filter(c => c.status === 'error');
+    const warnings = checks.filter(c => c.status === 'warning');
+    const ready = errors.length === 0;
+    let summary;
+    if (ready && warnings.length === 0) {
+        summary = 'All checks passed. System is ready.';
+    }
+    else if (ready) {
+        summary = `System is ready with ${warnings.length} warning(s).`;
+    }
+    else {
+        summary = `System is NOT ready. ${errors.length} error(s) found.`;
+    }
+    return {
+        ready,
+        checks,
+        summary,
+    };
+}
+/**
+ * 格式化报告为字符串
+ */
+export function formatBootstrapReport(report) {
+    const lines = [];
+    lines.push('');
+    lines.push('╔════════════════════════════════════════════════════════════╗');
+    lines.push(report.ready
+        ? '║  ✅ Bootstrap Check: READY                                 ║'
+        : '║  ❌ Bootstrap Check: NOT READY                             ║');
+    lines.push('╠════════════════════════════════════════════════════════════╣');
+    for (const check of report.checks) {
+        const icon = check.status === 'ok' ? '✅'
+            : check.status === 'warning' ? '⚠️'
+                : '❌';
+        const msg = check.message.length > 30 ? check.message.slice(0, 27) + '...' : check.message;
+        lines.push(`║ ${icon} ${check.name.padEnd(20)} ${msg.padEnd(30)} ║`);
+        if (check.remediation && check.status !== 'ok') {
+            const rem = check.remediation.length > 48 ? check.remediation.slice(0, 45) + '...' : check.remediation;
+            lines.push(`║    → ${rem.padEnd(48)} ║`);
+        }
+    }
+    lines.push('╠════════════════════════════════════════════════════════════╣');
+    lines.push(`║ ${report.summary.padEnd(58)} ║`);
+    lines.push('╚════════════════════════════════════════════════════════════╝');
+    lines.push('');
+    return lines.join('\n');
+}
+export default {
+    runBootstrapDoctor,
+    formatBootstrapReport,
+};
+//# sourceMappingURL=BootstrapDoctor.js.map

package/dist/core/BootstrapDoctor.js.map

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

package/dist/core/BrowserProvider.d.ts

@@ -0,0 +1,59 @@
+import type { Browser } from 'playwright';
+export interface BrowserProxyConfig {
+    server: string;
+    username?: string;
+    password?: string;
+    bypass?: string;
+}
+export interface BrowserHealth {
+    platform: NodeJS.Platform;
+    playwrightVersion?: string;
+    expectedExecutablePath?: string;
+    resolvedExecutablePath?: string;
+    resolvedExecutableSource?: BrowserExecutableSource;
+    playwrightCliExists: boolean;
+    executableExists: boolean;
+    canLaunch?: boolean;
+    installCommand: string;
+    installDepsCommand?: string;
+    detectedCandidates: BrowserExecutableCandidate[];
+    diagnostics: string[];
+}
+export interface BrowserLaunchResult {
+    browser: Browser;
+    proxy?: BrowserProxyConfig;
+    executablePath?: string;
+    executableSource?: BrowserExecutableSource;
+}
+export type BrowserExecutableSource = 'settings.paths.chrome_path' | `env.${string}` | 'playwright' | 'system.path' | 'system.command';
+export interface BrowserExecutableCandidate {
+    source: BrowserExecutableSource;
+    path: string;
+    exists: boolean;
+}
+export declare function isBrowserSkipped(env?: NodeJS.ProcessEnv): boolean;
+export declare function buildPlaywrightInstallCommands(options?: {
+    nodeExecPath?: string;
+    playwrightCli?: string;
+    platform?: NodeJS.Platform;
+}): {
+    installCommand: string;
+    installDepsCommand?: string;
+};
+export declare function createBrowserMissingDiagnostics(executableExists: boolean, playwrightCliExists?: boolean): string[];
+export declare function createBrowserSkippedError(): Error;
+export declare function readBrowserDaemonFlag(): boolean;
+export declare function readBrowserIdleMs(defaultMs: number): number;
+export declare function resolveBrowserProxy(): BrowserProxyConfig | undefined;
+export declare function browserProxyChanged(prev: BrowserProxyConfig | undefined, next: BrowserProxyConfig | undefined): boolean;
+export declare function _resetChromePathCacheForTesting(): void;
+export declare function ensureBrowserInstalled(): Promise<void>;
+export declare function checkBrowserHealth(options?: {
+    launch?: boolean;
+}): Promise<BrowserHealth>;
+export declare function launchManagedChromium(options?: {
+    proxy?: BrowserProxyConfig;
+    extraArgs?: string[];
+    log?: boolean;
+}): Promise<BrowserLaunchResult>;
+//# sourceMappingURL=BrowserProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserProvider.d.ts","sourceRoot":"","sources":["../../src/core/BrowserProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,YAAY,CAAC;AAqCzD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,wBAAwB,CAAC,EAAE,uBAAuB,CAAC;IACnD,mBAAmB,EAAE,OAAO,CAAC;IAC7B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,0BAA0B,EAAE,CAAC;IACjD,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;CAC5C;AAED,MAAM,MAAM,uBAAuB,GAC/B,4BAA4B,GAC5B,OAAO,MAAM,EAAE,GACf,YAAY,GACZ,aAAa,GACb,gBAAgB,CAAC;AAErB,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,uBAAuB,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AAqDD,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAE9E;AAED,wBAAgB,8BAA8B,CAAC,OAAO,CAAC,EAAE;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;CAC5B,GAAG;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,CAU1D;AAOD,wBAAgB,+BAA+B,CAAC,gBAAgB,EAAE,OAAO,EAAE,mBAAmB,UAAO,GAAG,MAAM,EAAE,CAK/G;AAED,wBAAgB,yBAAyB,IAAI,KAAK,CAEjD;AAED,wBAAgB,qBAAqB,IAAI,OAAO,CAK/C;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAM3D;AA6BD,wBAAgB,mBAAmB,IAAI,kBAAkB,GAAG,SAAS,CAEpE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,GAAG,SAAS,EAAE,IAAI,EAAE,kBAAkB,GAAG,SAAS,GAAG,OAAO,CAOvH;AAqKD,wBAAgB,+BAA+B,IAAI,IAAI,CAGtD;AA8HD,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAW5D;AAED,wBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CA4C/F;AAgBD,wBAAsB,qBAAqB,CAAC,OAAO,CAAC,EAAE;IACpD,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAyB/B"}