pi-lens/dist/clients/runtime-config.js

Real-time code feedback for pi — LSP, linters, formatters, type-checking, structural analysis & booboo

/**
 * Central runtime tuning knobs for pipeline/dispatch behavior.
 * Keep these values in one place so behavior is consistent and easy to tune.
 */
import { toPositiveFinite } from "./env-utils.js";
import { loadPiLensGlobalConfig } from "./lens-config.js";
let _runnerTimeoutFloorCache;
/**
 * Minimum wall-clock budget (ms) for every dispatch runner. Acts as a floor:
 * effective timeout = max(runner.timeoutMs ?? 30_000, runnerTimeoutFloorMs).
 *
 * Resolution order (highest priority first):
 *   1. `dispatch.runnerTimeoutFloorMs` in `~/.pi-lens/config.json`
 *   2. `PI_LENS_RUNNER_TIMEOUT_FLOOR_MS` environment variable
 *   3. 0 (no floor — runner budgets and the 30 s default apply as-is)
 *
 * Lazy + memoized so importing `runtime-config.ts` does not trigger disk IO.
 * The config file is read at most once per process, on first dispatch.
 *
 * @example ~/.pi-lens/config.json
 * ```json
 * { "dispatch": { "runnerTimeoutFloorMs": 180000 } }
 * ```
 *
 * @example env var
 * ```bash
 * PI_LENS_RUNNER_TIMEOUT_FLOOR_MS=180000 pi
 * ```
 */
export function getRunnerTimeoutFloorMs() {
    if (_runnerTimeoutFloorCache !== undefined)
        return _runnerTimeoutFloorCache;
    const config = loadPiLensGlobalConfig();
    const configFloor = toPositiveFinite(config?.dispatch?.runnerTimeoutFloorMs);
    const envFloor = toPositiveFinite(process.env.PI_LENS_RUNNER_TIMEOUT_FLOOR_MS);
    _runnerTimeoutFloorCache = Math.max(configFloor, envFloor, 0);
    return _runnerTimeoutFloorCache;
}
/**
 * Test-only: clear the memoized floor so a subsequent call re-reads the
 * config file and env var. Use after mutating either in a test.
 */
export function _resetRunnerTimeoutFloorCacheForTests() {
    _runnerTimeoutFloorCache = undefined;
}
export const RUNTIME_CONFIG = {
    pipeline: {
        lspMaxFileBytes: 2 * 1024 * 1024,
        lspMaxFileLines: 5000,
        cascadeMaxFiles: 5,
        cascadeMaxDiagnosticsPerFile: 20,
        // Hard cap on how long the pipeline will wait for an LSP client to spawn.
        // Keeps tool_result from blocking the TUI during cold LSP start (e.g.
        // pyright workspace indexing). The LSP server continues spawning in the
        // background; subsequent edits get full diagnostics once it is ready.
        lspSpawnBudgetMs: 5_000,
    },
    dispatch: {
        runnerTimeoutMs: 30_000,
    },
    crashNotice: {
        alwaysShowFirstN: 2,
        showEveryNth: 5,
    },
    reviewGraph: {
        maxFiles: 1_000,
        maxFileBytes: 1 * 1024 * 1024,
    },
    turnEnd: {
        maxLines: 20,
        maxChars: 1000,
    },
};