@mcptoolshop/claude-guardian 1.1.0

package/dist/budget.d.ts

@@ -0,0 +1,52 @@
+import type { RiskLevel } from './process-monitor.js';
+import type { BudgetData, BudgetLease } from './budget-store.js';
+/** Result of an acquire attempt. */
+export interface AcquireResult {
+    granted: boolean;
+    lease: BudgetLease | null;
+    reason: string;
+    currentCap: number;
+    slotsInUse: number;
+    slotsAvailable: number;
+}
+/** Summary for display in status/banner. */
+export interface BudgetSummary {
+    currentCap: number;
+    baseCap: number;
+    slotsInUse: number;
+    slotsAvailable: number;
+    activeLeases: number;
+    capSetByRisk: RiskLevel | null;
+    okSinceAt: string | null;
+    hysteresisRemainingSeconds: number;
+}
+/** Budget controller — manages cap transitions, leases, TTL expiry. */
+export declare class Budget {
+    private data;
+    constructor(data: BudgetData);
+    /** Current effective cap. */
+    get currentCap(): number;
+    /** Slots currently held by active leases. */
+    get slotsInUse(): number;
+    /** Slots available for new leases. */
+    get slotsAvailable(): number;
+    /**
+     * Adjust cap based on current risk level. Returns true if cap changed.
+     *
+     * Rules:
+     *   - ok: restore to baseCap after hysteresisSeconds sustained ok
+     *   - warn: cap = warnCap (2)
+     *   - critical: cap = criticalCap (1)
+     */
+    adjustCap(riskLevel: RiskLevel, now?: number): boolean;
+    /** Acquire N slots with a TTL. */
+    acquire(n: number, ttlSeconds: number, reason: string): AcquireResult;
+    /** Release a lease by ID. Returns true if found and released. */
+    release(id: string): boolean;
+    /** Expire any leases past their TTL. Returns count of expired leases. */
+    expireLeases(now?: number): number;
+    /** Summary for display. */
+    summarize(now?: number): BudgetSummary;
+    /** Get the raw data for persistence. */
+    getData(): BudgetData;
+}

package/dist/budget.js

@@ -0,0 +1,136 @@
+import { randomUUID } from 'crypto';
+import { BUDGET_THRESHOLDS } from './defaults.js';
+/** Budget controller — manages cap transitions, leases, TTL expiry. */
+export class Budget {
+    data;
+    constructor(data) {
+        // Deep copy to avoid external mutation
+        this.data = JSON.parse(JSON.stringify(data));
+    }
+    /** Current effective cap. */
+    get currentCap() {
+        return this.data.currentCap;
+    }
+    /** Slots currently held by active leases. */
+    get slotsInUse() {
+        return this.data.leases.reduce((sum, l) => sum + l.slots, 0);
+    }
+    /** Slots available for new leases. */
+    get slotsAvailable() {
+        return Math.max(0, this.data.currentCap - this.slotsInUse);
+    }
+    /**
+     * Adjust cap based on current risk level. Returns true if cap changed.
+     *
+     * Rules:
+     *   - ok: restore to baseCap after hysteresisSeconds sustained ok
+     *   - warn: cap = warnCap (2)
+     *   - critical: cap = criticalCap (1)
+     */
+    adjustCap(riskLevel, now = Date.now()) {
+        const oldCap = this.data.currentCap;
+        if (riskLevel === 'critical') {
+            this.data.currentCap = BUDGET_THRESHOLDS.criticalCap;
+            this.data.okSinceAt = null;
+            this.data.capSetByRisk = 'critical';
+        }
+        else if (riskLevel === 'warn') {
+            this.data.currentCap = BUDGET_THRESHOLDS.warnCap;
+            this.data.okSinceAt = null;
+            this.data.capSetByRisk = 'warn';
+        }
+        else {
+            // ok — start or continue hysteresis timer
+            if (this.data.okSinceAt === null) {
+                this.data.okSinceAt = new Date(now).toISOString();
+            }
+            const okDuration = (now - new Date(this.data.okSinceAt).getTime()) / 1000;
+            if (okDuration >= BUDGET_THRESHOLDS.hysteresisSeconds) {
+                this.data.currentCap = this.data.baseCap;
+                this.data.capSetByRisk = null;
+            }
+            // Otherwise cap stays where it is until hysteresis expires
+        }
+        if (this.data.currentCap !== oldCap) {
+            this.data.capChangedAt = new Date(now).toISOString();
+            return true;
+        }
+        return false;
+    }
+    /** Acquire N slots with a TTL. */
+    acquire(n, ttlSeconds, reason) {
+        const base = {
+            currentCap: this.data.currentCap,
+            slotsInUse: this.slotsInUse,
+            slotsAvailable: this.slotsAvailable,
+        };
+        if (n <= 0) {
+            return { granted: false, lease: null, reason: 'Slots must be > 0', ...base };
+        }
+        if (ttlSeconds <= 0) {
+            return { granted: false, lease: null, reason: 'TTL must be > 0', ...base };
+        }
+        if (n > this.slotsAvailable) {
+            return {
+                granted: false,
+                lease: null,
+                reason: `Requested ${n} slots but only ${this.slotsAvailable} available (cap=${this.data.currentCap}, in-use=${this.slotsInUse})`,
+                ...base,
+            };
+        }
+        const now = new Date();
+        const lease = {
+            id: randomUUID().slice(0, 8),
+            slots: n,
+            reason,
+            grantedAt: now.toISOString(),
+            expiresAt: new Date(now.getTime() + ttlSeconds * 1000).toISOString(),
+        };
+        this.data.leases.push(lease);
+        return {
+            granted: true,
+            lease: { ...lease },
+            reason: 'Granted',
+            currentCap: this.data.currentCap,
+            slotsInUse: this.slotsInUse,
+            slotsAvailable: this.slotsAvailable,
+        };
+    }
+    /** Release a lease by ID. Returns true if found and released. */
+    release(id) {
+        const idx = this.data.leases.findIndex(l => l.id === id);
+        if (idx === -1)
+            return false;
+        this.data.leases.splice(idx, 1);
+        return true;
+    }
+    /** Expire any leases past their TTL. Returns count of expired leases. */
+    expireLeases(now = Date.now()) {
+        const before = this.data.leases.length;
+        this.data.leases = this.data.leases.filter(l => new Date(l.expiresAt).getTime() > now);
+        return before - this.data.leases.length;
+    }
+    /** Summary for display. */
+    summarize(now = Date.now()) {
+        let hysteresisRemaining = 0;
+        if (this.data.okSinceAt && this.data.currentCap < this.data.baseCap) {
+            const okDuration = (now - new Date(this.data.okSinceAt).getTime()) / 1000;
+            hysteresisRemaining = Math.max(0, Math.round(BUDGET_THRESHOLDS.hysteresisSeconds - okDuration));
+        }
+        return {
+            currentCap: this.data.currentCap,
+            baseCap: this.data.baseCap,
+            slotsInUse: this.slotsInUse,
+            slotsAvailable: this.slotsAvailable,
+            activeLeases: this.data.leases.length,
+            capSetByRisk: this.data.capSetByRisk,
+            okSinceAt: this.data.okSinceAt,
+            hysteresisRemainingSeconds: hysteresisRemaining,
+        };
+    }
+    /** Get the raw data for persistence. */
+    getData() {
+        return JSON.parse(JSON.stringify(this.data));
+    }
+}
+//# sourceMappingURL=budget.js.map

package/dist/budget.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,387 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { scanLogs, fixLogs, formatPreflightReport, formatFixReport, healthBanner } from './log-manager.js';
+import { generateBundle, formatDoctorReport } from './doctor.js';
+import { Watchdog } from './watchdog.js';
+import { startMcpServer, formatBanner } from './mcp-server.js';
+import { startWatchDaemon } from './watch-daemon.js';
+import { findClaudeProcesses, checkActivitySignals, assessHangRisk, recommendActions } from './process-monitor.js';
+import { readState, isStateFresh, computeAttention } from './state.js';
+import { getDiskFreeGB, bytesToMB, pathExists, dirSize } from './fs-utils.js';
+import { DEFAULT_CONFIG, getClaudeProjectsPath } from './defaults.js';
+import { Budget } from './budget.js';
+import { readBudget, writeBudget, emptyBudget } from './budget-store.js';
+import { GuardianError } from './errors.js';
+import { homedir } from 'os';
+/**
+ * Exit codes:
+ *   0 = success
+ *   1 = user error (bad arguments, missing input)
+ *   2 = runtime error (IO failure, unexpected crash)
+ *   3 = partial success (some actions failed)
+ */
+const program = new Command();
+program
+    .name('claude-guardian')
+    .description('Flight computer for Claude Code — log rotation, watchdog, crash bundles, and MCP self-awareness')
+    .version('1.1.0')
+    .option('--debug', 'Print full stack traces on error', false);
+// ─── preflight ───
+program
+    .command('preflight')
+    .description('Scan Claude logs and report issues. Use --fix to auto-repair.')
+    .option('--fix', 'Automatically rotate/trim/compress oversized logs', false)
+    .option('--aggressive', 'Enable aggressive mode: shorter retention, lower thresholds', false)
+    .option('--max-log-mb <mb>', 'Max project log directory size in MB', String(DEFAULT_CONFIG.maxProjectLogDirMB))
+    .action(async (opts) => {
+    const config = {
+        ...DEFAULT_CONFIG,
+        maxProjectLogDirMB: parseInt(opts.maxLogMb, 10),
+    };
+    console.log('Scanning Claude logs...\n');
+    const result = await scanLogs(config);
+    console.log(formatPreflightReport(result));
+    console.log('\n' + healthBanner(result));
+    if (opts.fix) {
+        console.log('\nApplying fixes...\n');
+        const actions = await fixLogs(config, opts.aggressive);
+        console.log(formatFixReport(actions));
+    }
+    else if (result.actions.length > 0) {
+        console.log('\nRun with --fix to auto-repair issues.');
+    }
+});
+// ─── doctor ───
+program
+    .command('doctor')
+    .description('Generate a diagnostics bundle (zip) with system info, log tails, and action journal.')
+    .option('-o, --out <path>', 'Output path for the zip bundle')
+    .action(async (opts) => {
+    console.log('Generating diagnostics bundle...\n');
+    const bundle = await generateBundle(opts.out);
+    console.log(formatDoctorReport(bundle.summary));
+    console.log(`\nBundle saved: ${bundle.zipPath}`);
+});
+// ─── run ───
+program
+    .command('run')
+    .description('Launch a command with watchdog monitoring. Captures bundles on crash/hang.')
+    .argument('<command...>', 'The command to run (e.g., "claude" or "node server.js")')
+    .option('--auto-restart', 'Automatically restart on crash/hang', DEFAULT_CONFIG.autoRestart)
+    .option('--hang-timeout <seconds>', 'Seconds of inactivity before declaring a hang', String(DEFAULT_CONFIG.hangNoActivitySeconds))
+    .option('--max-log-mb <mb>', 'Max project log directory size in MB', String(DEFAULT_CONFIG.maxProjectLogDirMB))
+    .action(async (commandParts, opts) => {
+    const config = {
+        maxProjectLogDirMB: parseInt(opts.maxLogMb, 10),
+        hangNoActivitySeconds: parseInt(opts.hangTimeout, 10),
+        autoRestart: opts.autoRestart,
+    };
+    // Run preflight first
+    console.log('[guardian] Running preflight check...');
+    const preflight = await scanLogs(config);
+    const banner = healthBanner(preflight);
+    console.log(`[guardian] ${banner}`);
+    if (preflight.diskFreeWarning) {
+        console.log('[guardian] WARNING: Low disk space. Running aggressive log cleanup...');
+        const actions = await fixLogs(config, true);
+        if (actions.length > 0) {
+            console.log(`[guardian] Cleaned up ${actions.length} items.`);
+        }
+    }
+    // Parse command
+    const cmd = commandParts[0];
+    const args = commandParts.slice(1);
+    console.log(`[guardian] Starting: ${commandParts.join(' ')}`);
+    console.log(`[guardian] Auto-restart: ${config.autoRestart}`);
+    console.log(`[guardian] Hang timeout: ${config.hangNoActivitySeconds}s`);
+    console.log('');
+    const watchdog = new Watchdog(cmd, args, config, (event, detail) => {
+        const timestamp = new Date().toISOString().substring(11, 19);
+        switch (event) {
+            case 'started':
+                console.log(`[guardian ${timestamp}] Started: ${detail}`);
+                break;
+            case 'hang-detected':
+                console.error(`[guardian ${timestamp}] HANG DETECTED: ${detail}`);
+                break;
+            case 'crash-detected':
+                console.error(`[guardian ${timestamp}] CRASH DETECTED: ${detail}`);
+                break;
+            case 'bundle-created':
+                console.log(`[guardian ${timestamp}] ${detail}`);
+                break;
+            case 'restarting':
+                console.log(`[guardian ${timestamp}] ${detail}`);
+                break;
+            case 'max-restarts':
+                console.error(`[guardian ${timestamp}] ${detail}`);
+                break;
+            case 'stopped':
+                console.log(`[guardian ${timestamp}] ${detail}`);
+                break;
+        }
+    });
+    // Handle graceful shutdown
+    const shutdown = () => {
+        console.log('\n[guardian] Shutting down...');
+        watchdog.stop();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+    watchdog.start();
+});
+// ─── watch ───
+program
+    .command('watch')
+    .description('Run background daemon: monitor Claude Code processes, track health, persist state for MCP.')
+    .option('--hang-timeout <seconds>', 'Seconds of inactivity before warning', String(DEFAULT_CONFIG.hangNoActivitySeconds))
+    .option('--auto-fix', 'Auto-run preflight fixes when disk is low', false)
+    .option('--verbose', 'Print every poll cycle', false)
+    .action(async (opts) => {
+    await startWatchDaemon({
+        hangTimeoutSeconds: parseInt(opts.hangTimeout, 10),
+        autoFix: opts.autoFix,
+        verbose: opts.verbose,
+    });
+});
+// ─── status ───
+program
+    .command('status')
+    .description('Show current health status: processes, hang risk, disk, logs.')
+    .option('--banner', 'Print a single-line banner (for embedding in prompts)', false)
+    .action(async (opts) => {
+    // Try daemon state first
+    const state = await readState();
+    if (state && isStateFresh(state)) {
+        if (opts.banner) {
+            console.log(formatBanner(state));
+            return;
+        }
+        printFullStatus(state);
+    }
+    else {
+        // No daemon — build a live state snapshot
+        const diskFreeGB = await getDiskFreeGB(homedir());
+        const claudePath = getClaudeProjectsPath();
+        let claudeLogSizeMB = 0;
+        if (await pathExists(claudePath)) {
+            claudeLogSizeMB = bytesToMB(await dirSize(claudePath));
+        }
+        const processes = await findClaudeProcesses();
+        const activity = await checkActivitySignals(processes);
+        const hangRisk = assessHangRisk(processes, activity, diskFreeGB, DEFAULT_CONFIG.hangNoActivitySeconds, 0, // processAgeSeconds — unknown without daemon
+        0);
+        const actions = recommendActions(hangRisk);
+        const liveState = {
+            updatedAt: new Date().toISOString(),
+            daemonRunning: false,
+            daemonPid: null,
+            claudeProcesses: processes,
+            activity,
+            hangRisk,
+            recommendedActions: actions,
+            diskFreeGB: Math.round(diskFreeGB * 100) / 100,
+            claudeLogSizeMB,
+            activeIncident: null,
+            processAgeSeconds: 0,
+            compositeQuietSeconds: 0,
+            budgetSummary: null,
+            attention: computeAttention(hangRisk, null, null),
+        };
+        if (opts.banner) {
+            console.log(formatBanner(liveState));
+            return;
+        }
+        printFullStatus(liveState);
+        // Also show log scan when no daemon
+        console.log('');
+        const result = await scanLogs();
+        console.log(formatPreflightReport(result));
+        console.log('\n' + healthBanner(result));
+    }
+});
+/** Print the full multi-line status from a GuardianState. */
+function printFullStatus(state) {
+    if (state.daemonRunning) {
+        console.log(`[guardian] daemon=active | pid=${state.daemonPid}`);
+    }
+    else {
+        console.log('[guardian] daemon=inactive (run `claude-guardian watch` to enable background monitoring)');
+    }
+    console.log(`[guardian] disk=${state.diskFreeGB}GB | logs=${state.claudeLogSizeMB}MB | risk=${state.hangRisk.level}`);
+    console.log('');
+    if (state.claudeProcesses.length > 0) {
+        console.log(`Claude processes: ${state.claudeProcesses.length}`);
+        for (const p of state.claudeProcesses) {
+            let line = `  PID ${p.pid} (${p.name}): CPU ${p.cpuPercent}% | RAM ${p.memoryMB}MB`;
+            if (p.handleCount != null) {
+                line += ` | handles=${p.handleCount}`;
+            }
+            line += ` | up ${fmtUptime(p.uptimeSeconds)}`;
+            console.log(line);
+        }
+    }
+    else {
+        console.log('Claude processes: none detected');
+    }
+    console.log('');
+    // Signals
+    console.log('Signals:');
+    console.log(`  Log activity: ${state.activity.logLastModifiedSecondsAgo >= 0 ? state.activity.logLastModifiedSecondsAgo + 's ago' : 'unknown'}`);
+    console.log(`  CPU active: ${state.activity.cpuActive ? 'yes' : 'no'}`);
+    if (state.hangRisk.graceRemainingSeconds > 0) {
+        console.log(`  Grace remaining: ${state.hangRisk.graceRemainingSeconds}s`);
+    }
+    console.log(`  Composite quiet: ${state.compositeQuietSeconds}s`);
+    console.log('');
+    console.log(`Hang risk: ${state.hangRisk.level.toUpperCase()}`);
+    if (state.hangRisk.reasons.length > 0) {
+        for (const r of state.hangRisk.reasons) {
+            console.log(`  - ${r}`);
+        }
+    }
+    // Incident
+    if (state.activeIncident) {
+        console.log('');
+        console.log(`Incident: ${state.activeIncident.id} (${state.activeIncident.peakLevel}) — ${state.activeIncident.reason}`);
+        console.log(`  Started: ${state.activeIncident.startedAt}`);
+        console.log(`  Bundle captured: ${state.activeIncident.bundleCaptured ? 'yes' : 'no'}`);
+        if (state.activeIncident.bundlePath) {
+            console.log(`  Bundle: ${state.activeIncident.bundlePath}`);
+        }
+    }
+    // Budget
+    if (state.budgetSummary) {
+        console.log('');
+        const b = state.budgetSummary;
+        console.log(`Budget: cap=${b.currentCap}/${b.baseCap} | in-use=${b.slotsInUse} | available=${b.slotsAvailable}`);
+        if (b.capSetByRisk) {
+            console.log(`  Reduced by: ${b.capSetByRisk}`);
+        }
+        if (b.hysteresisRemainingSeconds > 0) {
+            console.log(`  Recovery in: ${b.hysteresisRemainingSeconds}s`);
+        }
+    }
+    // Attention
+    console.log('');
+    console.log(`Attention: ${state.attention.level.toUpperCase()} — ${state.attention.reason}`);
+    if (state.attention.level !== 'none' && state.attention.recommendedActions.length > 0) {
+        for (const a of state.attention.recommendedActions) {
+            console.log(`  - ${a}`);
+        }
+    }
+}
+function fmtUptime(seconds) {
+    if (seconds < 60)
+        return `${seconds}s`;
+    const mins = Math.floor(seconds / 60);
+    const secs = seconds % 60;
+    if (mins < 60)
+        return `${mins}m ${secs}s`;
+    const hours = Math.floor(mins / 60);
+    const remMins = mins % 60;
+    return `${hours}h ${remMins}m`;
+}
+// ─── budget ───
+const budgetCmd = program
+    .command('budget')
+    .description('View and manage the concurrency budget.');
+budgetCmd
+    .command('show', { isDefault: true })
+    .description('Show current budget: cap, leases, availability.')
+    .action(async () => {
+    const data = await readBudget();
+    if (!data) {
+        console.log('[guardian] No budget state. Start the daemon or run `budget acquire` to initialize.');
+        return;
+    }
+    const budget = new Budget(data);
+    budget.expireLeases();
+    const s = budget.summarize();
+    console.log(`Budget: cap=${s.currentCap}/${s.baseCap} | in-use=${s.slotsInUse} | available=${s.slotsAvailable}`);
+    console.log(`Active leases: ${s.activeLeases}`);
+    if (s.capSetByRisk) {
+        console.log(`Cap reduced by: ${s.capSetByRisk}`);
+    }
+    if (s.hysteresisRemainingSeconds > 0) {
+        console.log(`Recovery in: ${s.hysteresisRemainingSeconds}s`);
+    }
+    // Show individual leases
+    if (data.leases.length > 0) {
+        console.log('');
+        for (const l of data.leases) {
+            const expiresIn = Math.max(0, Math.round((new Date(l.expiresAt).getTime() - Date.now()) / 1000));
+            console.log(`  ${l.id}: ${l.slots} slot(s) — "${l.reason}" (expires in ${expiresIn}s)`);
+        }
+    }
+});
+budgetCmd
+    .command('acquire')
+    .description('Acquire concurrency slots.')
+    .argument('<slots>', 'Number of slots to acquire')
+    .option('--ttl <seconds>', 'Lease time-to-live in seconds', '60')
+    .option('--reason <text>', 'Reason for acquiring', 'manual')
+    .action(async (slotsStr, opts) => {
+    const data = await readBudget() ?? emptyBudget();
+    const budget = new Budget(data);
+    budget.expireLeases();
+    const result = budget.acquire(parseInt(slotsStr, 10), parseInt(opts.ttl, 10), opts.reason);
+    await writeBudget(budget.getData());
+    if (result.granted) {
+        console.log(`Lease granted: ${result.lease.id} (${result.lease.slots} slot(s), TTL ${opts.ttl}s)`);
+        console.log(`Budget: ${result.slotsInUse}/${result.currentCap} in use`);
+    }
+    else {
+        console.error(`Denied: ${result.reason}`);
+        process.exitCode = 1;
+    }
+});
+budgetCmd
+    .command('release')
+    .description('Release a lease by ID.')
+    .argument('<id>', 'Lease ID to release')
+    .action(async (id) => {
+    const data = await readBudget();
+    if (!data) {
+        console.log('[guardian] No budget state.');
+        return;
+    }
+    const budget = new Budget(data);
+    const released = budget.release(id);
+    await writeBudget(budget.getData());
+    console.log(released ? `Lease ${id} released.` : `Lease ${id} not found.`);
+});
+// ─── mcp ───
+program
+    .command('mcp')
+    .description('Start the MCP server on stdio. Register in ~/.claude.json for Claude Code integration.')
+    .action(async () => {
+    await startMcpServer();
+});
+// ─── Global error handler ───
+function handleFatalError(err) {
+    const debug = program.opts().debug;
+    if (err instanceof GuardianError) {
+        console.error(err.toCliText());
+        if (debug && err.cause?.stack) {
+            console.error('\nStack trace:');
+            console.error(err.cause.stack);
+        }
+        process.exit(2);
+    }
+    if (err instanceof Error) {
+        console.error(`[guardian] Error: ${err.message}`);
+        if (debug && err.stack) {
+            console.error('\nStack trace:');
+            console.error(err.stack);
+        }
+        process.exit(2);
+    }
+    console.error(`[guardian] Error: ${String(err)}`);
+    process.exit(2);
+}
+process.on('uncaughtException', handleFatalError);
+process.on('unhandledRejection', handleFatalError);
+program.parseAsync().catch(handleFatalError);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/defaults.d.ts

@@ -0,0 +1,51 @@
+import type { GuardianConfig } from './types.js';
+/** The 3 user-facing knobs with sane defaults. */
+export declare const DEFAULT_CONFIG: GuardianConfig;
+/** Hardcoded thresholds — not user-configurable in v1. */
+export declare const THRESHOLDS: {
+    /** Disk free below this triggers aggressive mode. */
+    readonly diskFreeWarningGB: 5;
+    /** Max single file size before trimming. */
+    readonly maxFileMB: 25;
+    /** How many days of logs to retain during rotation. */
+    readonly retainDays: 7;
+    /** Days before a session transcript is considered stale and eligible for cleanup. */
+    readonly staleSessionDays: 3;
+    /** Tail lines to include in doctor bundle per log file. */
+    readonly doctorTailLines: 500;
+    /** Watchdog poll interval in ms. */
+    readonly watchdogPollMs: 2000;
+    /** Restart backoff schedule in ms. */
+    readonly restartBackoffMs: readonly [2000, 5000, 15000, 60000];
+    /** Max restarts before giving up. */
+    readonly maxRestarts: 5;
+    /** Grace period after first discovering a PID — risk stays ok. */
+    readonly graceWindowSeconds: 60;
+    /** CPU below this % counts as "low" for hang detection. */
+    readonly cpuLowThreshold: 5;
+    /** After warn, escalate to critical after this many additional seconds. */
+    readonly criticalAfterSeconds: 600;
+    /** Rate limit: min seconds between bundles for the same PID. */
+    readonly bundleCooldownSeconds: 300;
+};
+/** Budget thresholds for concurrency control. */
+export declare const BUDGET_THRESHOLDS: {
+    /** Maximum concurrency slots (base cap). */
+    readonly baseCap: 4;
+    /** Cap when risk = warn. */
+    readonly warnCap: 2;
+    /** Cap when risk = critical. */
+    readonly criticalCap: 1;
+    /** Seconds of sustained ok before restoring base cap. */
+    readonly hysteresisSeconds: 60;
+};
+/** Resolve the Claude projects directory. */
+export declare function getClaudeProjectsPath(): string;
+/** Resolve the guardian data directory. */
+export declare function getGuardianDataPath(): string;
+/** Resolve the journal file path. */
+export declare function getJournalPath(): string;
+/** Resolve the archive directory. */
+export declare function getArchivePath(): string;
+/** Resolve the budget file path. */
+export declare function getBudgetPath(): string;