opencode-bridge 2.9.0-beta

package/dist/reliability/proactive-heartbeat.js

@@ -0,0 +1,147 @@
+import fs from 'node:fs';
+import path from 'node:path';
+const DEFAULT_PROMPT = 'Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.';
+export function createProactiveHeartbeatRunner(options) {
+    const logger = options.logger ?? console;
+    const checklistPath = options.checklistPath ?? path.join(process.cwd(), 'HEARTBEAT.md');
+    const sessionStatePath = options.sessionStatePath ?? path.join(process.cwd(), 'memory', 'heartbeat-session.json');
+    const sessionTitle = options.sessionTitle?.trim() || 'Bridge Heartbeat Monitor';
+    const prompt = options.prompt?.trim() || DEFAULT_PROMPT;
+    const intervalMs = options.intervalMs > 0 ? options.intervalMs : 30 * 60 * 1000;
+    const agent = options.agent?.trim();
+    const directory = options.directory?.trim();
+    let timer = null;
+    let running = false;
+    let closed = false;
+    const runNow = async () => {
+        if (!options.enabled || closed) {
+            return;
+        }
+        if (running) {
+            logger.info('[Heartbeat] proactive tick skipped: previous run still active');
+            return;
+        }
+        running = true;
+        try {
+            if (!fs.existsSync(checklistPath)) {
+                logger.warn(`[Heartbeat] checklist not found, continue with prompt contract: ${checklistPath}`);
+            }
+            const sessionId = await ensureSessionId();
+            const response = await options.client.sendMessage(sessionId, prompt, {
+                ...(agent ? { agent } : {}),
+                ...(directory ? { directory } : {}),
+            });
+            const text = extractText(response.parts).trim();
+            if (isHeartbeatOk(text)) {
+                logger.info('[Heartbeat] proactive heartbeat ack: HEARTBEAT_OK');
+                return;
+            }
+            const alert = text || 'Heartbeat run completed without HEARTBEAT_OK marker.';
+            logger.warn(`[Heartbeat] proactive alert: ${alert.slice(0, 300)}`);
+            if (options.notifyAlert) {
+                await options.notifyAlert(alert);
+            }
+        }
+        catch (error) {
+            logger.error('[Heartbeat] proactive heartbeat failed:', error);
+            if (options.notifyAlert) {
+                const message = error instanceof Error ? error.message : String(error);
+                await options.notifyAlert(`Heartbeat proactive run failed: ${message}`);
+            }
+        }
+        finally {
+            running = false;
+        }
+    };
+    return {
+        start: () => {
+            if (!options.enabled || closed || timer) {
+                return;
+            }
+            timer = setInterval(() => {
+                void runNow();
+            }, intervalMs);
+            logger.info(`[Heartbeat] proactive runner started (intervalMs=${intervalMs})`);
+        },
+        stop: async () => {
+            closed = true;
+            if (timer) {
+                clearInterval(timer);
+                timer = null;
+            }
+            while (running) {
+                await wait(50);
+            }
+            logger.info('[Heartbeat] proactive runner stopped');
+        },
+        runNow,
+    };
+    async function ensureSessionId() {
+        const state = readSessionState(sessionStatePath);
+        if (state?.sessionId) {
+            const exists = await options.client.getSessionById(state.sessionId, directory ? { directory } : undefined);
+            if (exists) {
+                return state.sessionId;
+            }
+        }
+        const created = await options.client.createSession(sessionTitle, directory);
+        const nextState = {
+            sessionId: created.id,
+            updatedAtMs: Date.now(),
+        };
+        writeSessionState(sessionStatePath, nextState);
+        return created.id;
+    }
+}
+function extractText(parts) {
+    const fragments = [];
+    for (const part of parts) {
+        if (!part || typeof part !== 'object') {
+            continue;
+        }
+        const record = part;
+        if (typeof record.text === 'string' && record.text.trim()) {
+            fragments.push(record.text.trim());
+        }
+    }
+    return fragments.join('\n').trim();
+}
+function isHeartbeatOk(text) {
+    return /^HEARTBEAT_OK(\b|$)/i.test(text.trim());
+}
+function readSessionState(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return null;
+    }
+    try {
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        const sessionId = typeof parsed.sessionId === 'string' ? parsed.sessionId.trim() : '';
+        if (!sessionId) {
+            return null;
+        }
+        return {
+            sessionId,
+            updatedAtMs: typeof parsed.updatedAtMs === 'number' ? parsed.updatedAtMs : 0,
+        };
+    }
+    catch (error) {
+        console.error('[proactive-heartbeat] readSessionState failed:', error instanceof Error ? error.message : String(error));
+        return null;
+    }
+}
+function writeSessionState(filePath, state) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const tmpPath = `${filePath}.${process.pid}.tmp`;
+    fs.writeFileSync(tmpPath, `${JSON.stringify(state, null, 2)}\n`, 'utf-8');
+    fs.renameSync(tmpPath, filePath);
+}
+async function wait(ms) {
+    await new Promise(resolve => {
+        setTimeout(resolve, ms);
+    });
+}
+//# sourceMappingURL=proactive-heartbeat.js.map

package/dist/reliability/proactive-heartbeat.js.map

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

package/dist/reliability/process-check-job.d.ts

@@ -0,0 +1,73 @@
+import { type ProcessGuardResult, type ProcessGuardStatus } from './process-guard.js';
+import { type CronScheduler } from './scheduler.js';
+type ProcessAliveChecker = (pid: number) => Promise<boolean>;
+type OpenCodeInstanceChecker = (options: {
+    pidFilePath: string;
+    host: string;
+    port: number;
+    timeoutMs?: number;
+    processKeywords?: string[];
+}) => Promise<ProcessGuardResult>;
+export type BridgeProcessStatus = 'ok' | 'not-running' | 'stale-pid';
+export interface ProcessConsistencyStatus {
+    opencodeStatus: ProcessGuardStatus;
+    bridgeStatus: BridgeProcessStatus;
+    stalePidCleaned: boolean;
+    details: string;
+}
+export interface StaleLockCleanupResult {
+    cleanedPaths: string[];
+    skippedPaths: string[];
+}
+export interface BudgetResetResult {
+    previous: number;
+    current: number;
+    maxBudget: number;
+}
+export interface RepairBudgetState {
+    maxBudget: number;
+    remaining: number;
+    lastUpdatedAtMs: number;
+    lastResetAtMs: number;
+}
+export interface ProcessCheckJobRunner {
+    checkProcessConsistency: () => Promise<ProcessConsistencyStatus>;
+    cleanupStaleLocks: () => Promise<StaleLockCleanupResult>;
+    resetBudget: () => Promise<BudgetResetResult>;
+}
+interface ProcessCheckJobAuditEvent {
+    action: string;
+    result: 'success' | 'failed';
+    metadata?: Record<string, unknown>;
+}
+type ProcessCheckJobAuditLogger = (event: ProcessCheckJobAuditEvent) => Promise<void>;
+export interface ProcessCheckJobRunnerOptions {
+    bridgePidFilePath: string;
+    opencodePidFilePath: string;
+    opencodeHost: string;
+    opencodePort: number;
+    repairBudgetState: RepairBudgetState;
+    staleLockPaths: string[];
+    staleLockMs?: number;
+    opencodeProbeTimeoutMs?: number;
+    processKeywords?: string[];
+    now?: () => number;
+    isProcessAlive?: ProcessAliveChecker;
+    checkOpenCodeSingleInstance?: OpenCodeInstanceChecker;
+    auditLog?: ProcessCheckJobAuditLogger;
+}
+export interface ProcessCheckJobCronExpressions {
+    processConsistencyCheck: string;
+    staleLockCleanup: string;
+    budgetReset: string;
+}
+export interface RegisterProcessCheckJobsOptions {
+    runner: ProcessCheckJobRunner;
+    cronExpressions?: Partial<ProcessCheckJobCronExpressions>;
+    timezone?: string;
+}
+export declare function createRepairBudgetState(maxBudget: number, now?: () => number): RepairBudgetState;
+export declare function createProcessCheckJobRunner(options: ProcessCheckJobRunnerOptions): ProcessCheckJobRunner;
+export declare function registerProcessCheckJobs(scheduler: CronScheduler, options: RegisterProcessCheckJobsOptions): void;
+export {};
+//# sourceMappingURL=process-check-job.d.ts.map

package/dist/reliability/process-check-job.d.ts.map

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

package/dist/reliability/process-check-job.js

@@ -0,0 +1,254 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { reliabilityConfig } from '../config.js';
+import { auditLogger, generateIncidentId } from './audit-log.js';
+import { checkOpenCodeSingleInstance, } from './process-guard.js';
+const DEFAULT_CRON_EXPRESSIONS = {
+    processConsistencyCheck: '*/30 * * * * *',
+    staleLockCleanup: '0 */5 * * * *',
+    budgetReset: '0 0 * * *',
+};
+const DEFAULT_STALE_LOCK_MS = 10 * 60 * 1000;
+const DEFAULT_AUDIT_PATH = path.resolve(process.cwd(), 'logs', 'reliability-audit.jsonl');
+const missingPidNoticePaths = new Set();
+function isErrnoException(error) {
+    return typeof error === 'object' && error !== null && 'code' in error;
+}
+export function createRepairBudgetState(maxBudget, now = Date.now) {
+    const safeMaxBudget = Number.isFinite(maxBudget) && maxBudget > 0
+        ? Math.floor(maxBudget)
+        : reliabilityConfig.repairBudget;
+    const ts = now();
+    return {
+        maxBudget: safeMaxBudget,
+        remaining: safeMaxBudget,
+        lastUpdatedAtMs: ts,
+        lastResetAtMs: ts,
+    };
+}
+const createAuditLogger = () => {
+    const logger = auditLogger(DEFAULT_AUDIT_PATH, true);
+    return async (event) => {
+        const auditEvent = {
+            incidentId: generateIncidentId(),
+            classification: 'system',
+            decision: 'update',
+            action: event.action,
+            result: event.result,
+            timestamp: new Date().toISOString(),
+            ...(event.metadata ? { metadata: event.metadata } : {}),
+        };
+        await logger.log(auditEvent);
+    };
+};
+async function readPidFile(pidFilePath) {
+    try {
+        const raw = (await fs.readFile(pidFilePath, 'utf-8')).trim();
+        const pid = Number.parseInt(raw, 10);
+        return Number.isNaN(pid) ? null : pid;
+    }
+    catch (error) {
+        if (isErrnoException(error) && error.code === 'ENOENT') {
+            if (!missingPidNoticePaths.has(pidFilePath)) {
+                missingPidNoticePaths.add(pidFilePath);
+                console.info(`[process-check-job] bridge pid file not found, fallback to foreground mode detection: ${pidFilePath}`);
+            }
+            return null;
+        }
+        console.error('[process-check-job] readPidFile failed:', error instanceof Error ? error.message : String(error));
+        return null;
+    }
+}
+async function removeFileIfExists(filePath) {
+    try {
+        await fs.rm(filePath, { force: true });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function resolveLockPath(targetPath) {
+    return targetPath.endsWith('.lock') ? targetPath : `${targetPath}.lock`;
+}
+export function createProcessCheckJobRunner(options) {
+    const getNow = options.now ?? Date.now;
+    const staleLockMs = options.staleLockMs ?? DEFAULT_STALE_LOCK_MS;
+    const isProcessAlive = options.isProcessAlive ?? (async (pid) => {
+        try {
+            process.kill(pid, 0);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    });
+    const checkSingleInstance = options.checkOpenCodeSingleInstance ?? checkOpenCodeSingleInstance;
+    const auditLog = options.auditLog ?? createAuditLogger();
+    return {
+        checkProcessConsistency: async () => {
+            const opencode = await checkSingleInstance({
+                pidFilePath: options.opencodePidFilePath,
+                host: options.opencodeHost,
+                port: options.opencodePort,
+                timeoutMs: options.opencodeProbeTimeoutMs,
+                processKeywords: options.processKeywords,
+            });
+            let bridgeStatus = 'not-running';
+            let stalePidCleaned = false;
+            const bridgePid = await readPidFile(options.bridgePidFilePath);
+            if (bridgePid === null) {
+                // 前台运行模式通常不会写 bridge.pid，此时当前进程即为 bridge 本体。
+                bridgeStatus = 'ok';
+            }
+            else {
+                const alive = await isProcessAlive(bridgePid);
+                if (alive) {
+                    bridgeStatus = 'ok';
+                }
+                else {
+                    bridgeStatus = 'stale-pid';
+                    stalePidCleaned = await removeFileIfExists(options.bridgePidFilePath);
+                    await auditLog({
+                        action: 'bridge.pid.cleaned',
+                        result: stalePidCleaned ? 'success' : 'failed',
+                        metadata: {
+                            pidFilePath: options.bridgePidFilePath,
+                            pid: bridgePid,
+                        },
+                    });
+                }
+            }
+            const details = [
+                `opencode=${opencode.status}`,
+                `bridge=${bridgeStatus}`,
+                `runningPids=${opencode.runningPids.join(',') || 'none'}`,
+            ].join(' ');
+            await auditLog({
+                action: 'process.consistency.check',
+                result: 'success',
+                metadata: {
+                    opencodeStatus: opencode.status,
+                    bridgeStatus,
+                    stalePidCleaned,
+                    opencodePidFromFile: opencode.pidFromFile,
+                    opencodeConflictPids: opencode.conflictPids,
+                    opencodeProbeReason: opencode.probeReason,
+                },
+            });
+            if (opencode.status === 'single-instance-violation') {
+                await auditLog({
+                    action: 'opencode.single_instance_violation',
+                    result: 'failed',
+                    metadata: {
+                        pidFromFile: opencode.pidFromFile,
+                        runningPids: opencode.runningPids,
+                        conflictPids: opencode.conflictPids,
+                    },
+                });
+            }
+            return {
+                opencodeStatus: opencode.status,
+                bridgeStatus,
+                stalePidCleaned,
+                details,
+            };
+        },
+        cleanupStaleLocks: async () => {
+            const cleanedPaths = [];
+            const skippedPaths = [];
+            for (const lockTargetPath of options.staleLockPaths) {
+                const lockPath = resolveLockPath(lockTargetPath);
+                try {
+                    const stat = await fs.stat(lockPath);
+                    const ageMs = getNow() - stat.mtimeMs;
+                    if (ageMs <= staleLockMs) {
+                        skippedPaths.push(lockPath);
+                        continue;
+                    }
+                    await fs.rm(lockPath, { recursive: true, force: true });
+                    cleanedPaths.push(lockPath);
+                    await auditLog({
+                        action: 'lock.stale.cleaned',
+                        result: 'success',
+                        metadata: {
+                            lockPath,
+                            ageMs,
+                            staleLockMs,
+                        },
+                    });
+                }
+                catch (error) {
+                    console.error('[process-check-job] cleanupStaleLocks failed:', error instanceof Error ? error.message : String(error));
+                    skippedPaths.push(lockPath);
+                }
+            }
+            await auditLog({
+                action: 'lock.cleanup.completed',
+                result: 'success',
+                metadata: {
+                    cleanedCount: cleanedPaths.length,
+                    skippedCount: skippedPaths.length,
+                },
+            });
+            return {
+                cleanedPaths,
+                skippedPaths,
+            };
+        },
+        resetBudget: async () => {
+            const previous = options.repairBudgetState.remaining;
+            options.repairBudgetState.remaining = options.repairBudgetState.maxBudget;
+            options.repairBudgetState.lastResetAtMs = getNow();
+            options.repairBudgetState.lastUpdatedAtMs = options.repairBudgetState.lastResetAtMs;
+            await auditLog({
+                action: 'rescue.budget.reset',
+                result: 'success',
+                metadata: {
+                    previous,
+                    current: options.repairBudgetState.remaining,
+                    maxBudget: options.repairBudgetState.maxBudget,
+                },
+            });
+            return {
+                previous,
+                current: options.repairBudgetState.remaining,
+                maxBudget: options.repairBudgetState.maxBudget,
+            };
+        },
+    };
+}
+export function registerProcessCheckJobs(scheduler, options) {
+    const cronExpressions = {
+        ...DEFAULT_CRON_EXPRESSIONS,
+        ...options.cronExpressions,
+    };
+    scheduler.registerJob({
+        id: 'process-consistency-check',
+        cronExpression: cronExpressions.processConsistencyCheck,
+        timezone: options.timezone,
+        waitForCompletion: true,
+        run: async () => {
+            await options.runner.checkProcessConsistency();
+        },
+    });
+    scheduler.registerJob({
+        id: 'stale-lock-cleanup',
+        cronExpression: cronExpressions.staleLockCleanup,
+        timezone: options.timezone,
+        waitForCompletion: true,
+        run: async () => {
+            await options.runner.cleanupStaleLocks();
+        },
+    });
+    scheduler.registerJob({
+        id: 'budget-reset',
+        cronExpression: cronExpressions.budgetReset,
+        timezone: options.timezone,
+        waitForCompletion: true,
+        run: async () => {
+            await options.runner.resetBudget();
+        },
+    });
+}
+//# sourceMappingURL=process-check-job.js.map

package/dist/reliability/process-check-job.js.map

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

package/dist/reliability/process-guard.d.ts

@@ -0,0 +1,53 @@
+export interface OpenCodeProcessInfo {
+    pid: number;
+    command: string;
+}
+type ProcessAliveChecker = (pid: number) => Promise<boolean>;
+type ProcessListProvider = () => Promise<OpenCodeProcessInfo[]>;
+type PortProbe = (host: string, port: number, timeoutMs: number) => Promise<PortProbeResult>;
+export interface PortProbeResult {
+    isOpen: boolean;
+    reason: string;
+}
+export interface ProcessGuardOptions {
+    pidFilePath: string;
+    host: string;
+    port: number;
+    timeoutMs?: number;
+    processKeywords?: string[];
+    processAliveChecker?: ProcessAliveChecker;
+    processListProvider?: ProcessListProvider;
+    portProbe?: PortProbe;
+}
+export type ProcessGuardStatus = 'ok' | 'not-running' | 'single-instance-violation';
+export interface ProcessGuardResult {
+    status: ProcessGuardStatus;
+    pidFromFile: number | null;
+    pidAlive: boolean;
+    portOpen: boolean;
+    probeReason: string;
+    runningPids: number[];
+    conflictPids: number[];
+}
+export interface RescueLockOptions {
+    lockTargetPath: string;
+    staleMs?: number;
+    updateMs?: number;
+    now?: () => number;
+}
+export interface RescueLockBusyResult {
+    ok: false;
+    code: 'lock-busy';
+    lockPath: string;
+}
+export interface RescueLockSuccessResult {
+    ok: true;
+    lockPath: string;
+    release: () => Promise<void>;
+}
+export type RescueLockAcquireResult = RescueLockBusyResult | RescueLockSuccessResult;
+export declare function checkOpenCodeSingleInstance(options: ProcessGuardOptions): Promise<ProcessGuardResult>;
+export declare function acquireRescueLock(options: RescueLockOptions): Promise<RescueLockAcquireResult>;
+export declare function probeTcpPort(host: string, port: number, timeoutMs?: number): Promise<PortProbeResult>;
+export {};
+//# sourceMappingURL=process-guard.d.ts.map

package/dist/reliability/process-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-guard.d.ts","sourceRoot":"","sources":["../../src/reliability/process-guard.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,KAAK,mBAAmB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAC7D,KAAK,mBAAmB,GAAG,MAAM,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAChE,KAAK,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;AAE7F,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,aAAa,GAAG,2BAA2B,CAAC;AAEpF,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,IAAI,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,MAAM,MAAM,uBAAuB,GAAG,oBAAoB,GAAG,uBAAuB,CAAC;AAErF,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAyD7B;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAiDpG;AAwED,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,SAAS,SAAO,GACf,OAAO,CAAC,eAAe,CAAC,CA6B1B"}