@mcptoolshop/claude-guardian 1.1.0

package/dist/defaults.js

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

package/dist/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,kDAAkD;AAClD,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,kBAAkB,EAAE,GAAG;IACvB,qBAAqB,EAAE,GAAG;IAC1B,WAAW,EAAE,KAAK;CACnB,CAAC;AAEF,0DAA0D;AAC1D,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,qDAAqD;IACrD,iBAAiB,EAAE,CAAC;IAEpB,4CAA4C;IAC5C,SAAS,EAAE,EAAE;IAEb,uDAAuD;IACvD,UAAU,EAAE,CAAC;IAEb,qFAAqF;IACrF,gBAAgB,EAAE,CAAC;IAEnB,2DAA2D;IAC3D,eAAe,EAAE,GAAG;IAEpB,oCAAoC;IACpC,cAAc,EAAE,IAAI;IAEpB,sCAAsC;IACtC,gBAAgB,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC;IAE5C,qCAAqC;IACrC,WAAW,EAAE,CAAC;IAEd,kEAAkE;IAClE,kBAAkB,EAAE,EAAE;IAEtB,2DAA2D;IAC3D,eAAe,EAAE,CAAC;IAElB,2EAA2E;IAC3E,oBAAoB,EAAE,GAAG;IAEzB,gEAAgE;IAChE,qBAAqB,EAAE,GAAG;CAClB,CAAC;AAEX,iDAAiD;AACjD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,4CAA4C;IAC5C,OAAO,EAAE,CAAC;IACV,4BAA4B;IAC5B,OAAO,EAAE,CAAC;IACV,gCAAgC;IAChC,WAAW,EAAE,CAAC;IACd,yDAAyD;IACzD,iBAAiB,EAAE,EAAE;CACb,CAAC;AAEX,6CAA6C;AAC7C,MAAM,UAAU,qBAAqB;IACnC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAChD,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,kBAAkB,CAAC,CAAC;AAC7C,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,CAAC,mBAAmB,EAAE,EAAE,eAAe,CAAC,CAAC;AACtD,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,CAAC,mBAAmB,EAAE,EAAE,SAAS,CAAC,CAAC;AAChD,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,CAAC,mBAAmB,EAAE,EAAE,aAAa,CAAC,CAAC;AACpD,CAAC"}

package/dist/doctor.d.ts

@@ -0,0 +1,69 @@
+import type { PreflightResult } from './types.js';
+import { type HandleCountResult } from './handle-count.js';
+export interface DoctorBundle {
+    /** Path to the generated zip file. */
+    zipPath: string;
+    /** Summary data included in the bundle. */
+    summary: DoctorSummary;
+}
+export interface DoctorSummary {
+    timestamp: string;
+    system: SystemInfo;
+    claudeProjects: PreflightResult;
+    biggestFiles: Array<{
+        path: string;
+        sizeMB: number;
+    }>;
+    journalEntries: number;
+    recentJournal: Array<{
+        timestamp: string;
+        action: string;
+        detail: string;
+    }>;
+    /** Handle/FD counts for Claude processes at bundle time. */
+    handleCounts: HandleCountResult[];
+    /** Process snapshot at bundle time. */
+    processSnapshot: ProcessSnapshot;
+    /** Reconstructed timeline of events. */
+    timeline: TimelineEvent[];
+}
+/** Snapshot of running Claude processes at bundle time. */
+export interface ProcessSnapshot {
+    timestamp: string;
+    processes: Array<{
+        pid: number;
+        name: string;
+        cpuPercent: number;
+        memoryMB: number;
+        uptimeSeconds: number;
+        handleCount: number | null;
+    }>;
+    activitySignals: {
+        logLastModifiedSecondsAgo: number;
+        cpuActive: boolean;
+        sources: string[];
+    };
+}
+/** A single event in the diagnostic timeline. */
+export interface TimelineEvent {
+    timestamp: string;
+    type: 'risk_change' | 'incident_open' | 'incident_close' | 'bundle_captured' | 'fix_applied' | 'budget_change' | 'journal';
+    detail: string;
+}
+export interface SystemInfo {
+    platform: string;
+    release: string;
+    arch: string;
+    totalMemoryGB: number;
+    freeMemoryGB: number;
+    cpuModel: string;
+    cpuCores: number;
+    diskFreeGB: number;
+    nodeVersion: string;
+}
+/** Collect system information. */
+export declare function collectSystemInfo(diskFreeGB: number): SystemInfo;
+/** Generate a full diagnostics bundle. */
+export declare function generateBundle(outputPath?: string): Promise<DoctorBundle>;
+/** Format a doctor summary as a human-readable report. */
+export declare function formatDoctorReport(summary: DoctorSummary): string;

package/dist/doctor.js

@@ -0,0 +1,294 @@
+import { mkdir, readFile } from 'fs/promises';
+import { join, basename } from 'path';
+import { existsSync, createWriteStream } from 'fs';
+import archiver from 'archiver';
+import { homedir, platform, release, totalmem, freemem, cpus } from 'os';
+import { getClaudeProjectsPath, getGuardianDataPath, THRESHOLDS } from './defaults.js';
+import { listFilesRecursive, getDiskFreeGB, bytesToMB, tailFile, readJournal, pathExists, } from './fs-utils.js';
+import { scanLogs } from './log-manager.js';
+import { findClaudeProcesses, checkActivitySignals } from './process-monitor.js';
+import { getHandleCounts } from './handle-count.js';
+import { readState } from './state.js';
+import { readIncidentLog } from './incident.js';
+/** Collect system information. */
+export function collectSystemInfo(diskFreeGB) {
+    const cpuInfo = cpus();
+    return {
+        platform: platform(),
+        release: release(),
+        arch: process.arch,
+        totalMemoryGB: Math.round((totalmem() / (1024 ** 3)) * 100) / 100,
+        freeMemoryGB: Math.round((freemem() / (1024 ** 3)) * 100) / 100,
+        cpuModel: cpuInfo[0]?.model || 'unknown',
+        cpuCores: cpuInfo.length,
+        diskFreeGB,
+        nodeVersion: process.version,
+    };
+}
+/** Generate a full diagnostics bundle. */
+export async function generateBundle(outputPath) {
+    const dataDir = getGuardianDataPath();
+    if (!existsSync(dataDir)) {
+        await mkdir(dataDir, { recursive: true });
+    }
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const zipPath = outputPath || join(dataDir, `bundle-${timestamp}.zip`);
+    // Collect preflight scan
+    const claudeProjects = await scanLogs();
+    // Collect system info
+    const diskFreeGB = await getDiskFreeGB(homedir());
+    const systemInfo = collectSystemInfo(diskFreeGB);
+    // Find biggest files
+    const claudePath = getClaudeProjectsPath();
+    const biggestFiles = [];
+    if (await pathExists(claudePath)) {
+        const allFiles = await listFilesRecursive(claudePath);
+        const fileSizes = [];
+        for (const f of allFiles) {
+            const { stat } = await import('fs/promises');
+            const s = await stat(f);
+            fileSizes.push({ path: f, sizeMB: bytesToMB(s.size) });
+        }
+        fileSizes.sort((a, b) => b.sizeMB - a.sizeMB);
+        biggestFiles.push(...fileSizes.slice(0, 20));
+    }
+    // Read journal
+    const journal = await readJournal();
+    const recentJournal = journal.slice(-50).map(e => ({
+        timestamp: e.timestamp,
+        action: e.action,
+        detail: e.detail,
+    }));
+    // Collect handle counts for running Claude processes
+    const processes = await findClaudeProcesses();
+    const handleCounts = processes.length > 0
+        ? await getHandleCounts(processes.map(p => p.pid))
+        : [];
+    // Build process snapshot
+    const activity = await checkActivitySignals(processes);
+    const processSnapshot = buildProcessSnapshot(processes, handleCounts, activity);
+    // Build timeline from journal + incidents
+    const timeline = await buildTimeline(journal, recentJournal);
+    const summary = {
+        timestamp: new Date().toISOString(),
+        system: systemInfo,
+        claudeProjects,
+        biggestFiles,
+        journalEntries: journal.length,
+        recentJournal,
+        handleCounts,
+        processSnapshot,
+        timeline,
+    };
+    // Build the zip
+    await createZipBundle(zipPath, summary, claudePath);
+    return { zipPath, summary };
+}
+/** Create the actual zip file with summary + log tails. */
+async function createZipBundle(zipPath, summary, claudePath) {
+    // Ensure parent dir exists
+    const parentDir = join(zipPath, '..');
+    if (!existsSync(parentDir)) {
+        await mkdir(parentDir, { recursive: true });
+    }
+    return new Promise((resolve, reject) => {
+        const output = createWriteStream(zipPath);
+        const archive = archiver('zip', { zlib: { level: 9 } });
+        output.on('close', resolve);
+        archive.on('error', reject);
+        archive.pipe(output);
+        // Add summary.json
+        archive.append(JSON.stringify(summary, null, 2), { name: 'summary.json' });
+        // Add log tails (async — we queue them as promises)
+        const addTails = async () => {
+            if (await pathExists(claudePath)) {
+                const allFiles = await listFilesRecursive(claudePath);
+                // Only tail the biggest files (top 20 by path, to avoid huge bundles)
+                const textFiles = allFiles.filter(f => f.endsWith('.log') || f.endsWith('.jsonl') || f.endsWith('.json') || f.endsWith('.txt')).slice(0, 20);
+                for (const f of textFiles) {
+                    const tail = await tailFile(f, THRESHOLDS.doctorTailLines);
+                    if (tail.length > 0) {
+                        // Use relative path from claude projects dir
+                        const relPath = f.replace(claudePath, '').replace(/^[/\\]/, '');
+                        archive.append(tail, { name: `log-tails/${relPath}` });
+                    }
+                }
+            }
+            // Add journal if it exists
+            const journalPath = join(getGuardianDataPath(), 'journal.jsonl');
+            if (await pathExists(journalPath)) {
+                const journalContent = await readFile(journalPath, 'utf-8');
+                archive.append(journalContent, { name: 'journal.jsonl' });
+            }
+            // Add process snapshot
+            archive.append(JSON.stringify(summary.processSnapshot, null, 2), { name: 'process.json' });
+            // Add timeline
+            archive.append(JSON.stringify(summary.timeline, null, 2), { name: 'timeline.json' });
+            // Add filtered events (journal entries relevant to recent incidents)
+            const events = buildEventLines(summary.recentJournal);
+            if (events.length > 0) {
+                archive.append(events, { name: 'events.jsonl' });
+            }
+            // Add current state if available
+            const statePath = join(getGuardianDataPath(), 'state.json');
+            if (await pathExists(statePath)) {
+                const stateContent = await readFile(statePath, 'utf-8');
+                archive.append(stateContent, { name: 'state.json' });
+            }
+            // Add incidents log if available
+            const incidentsPath = join(getGuardianDataPath(), 'incidents.jsonl');
+            if (await pathExists(incidentsPath)) {
+                const incidentsContent = await readFile(incidentsPath, 'utf-8');
+                archive.append(incidentsContent, { name: 'incidents.jsonl' });
+            }
+            archive.finalize();
+        };
+        addTails().catch(reject);
+    });
+}
+/** Build a process snapshot from current processes and handle counts. */
+function buildProcessSnapshot(processes, handleCounts, activity) {
+    const handleMap = new Map(handleCounts.map(h => [h.pid, h.count]));
+    return {
+        timestamp: new Date().toISOString(),
+        processes: processes.map(p => ({
+            pid: p.pid,
+            name: p.name,
+            cpuPercent: p.cpuPercent,
+            memoryMB: p.memoryMB,
+            uptimeSeconds: p.uptimeSeconds,
+            handleCount: handleMap.get(p.pid) ?? null,
+        })),
+        activitySignals: {
+            logLastModifiedSecondsAgo: activity.logLastModifiedSecondsAgo,
+            cpuActive: activity.cpuActive,
+            sources: activity.sources,
+        },
+    };
+}
+/** Build a chronological timeline from journal and incident history. */
+async function buildTimeline(journal, recentJournal) {
+    const events = [];
+    // Add journal events
+    for (const entry of journal.slice(-100)) {
+        let type = 'journal';
+        if (entry.action === 'auto-bundle' || entry.action === 'bundle') {
+            type = 'bundle_captured';
+        }
+        else if (entry.action.includes('fix') || entry.action.includes('rotate') || entry.action.includes('trim')) {
+            type = 'fix_applied';
+        }
+        events.push({
+            timestamp: entry.timestamp,
+            type,
+            detail: `${entry.action}: ${entry.detail}`,
+        });
+    }
+    // Add incident events
+    const incidents = await readIncidentLog(20);
+    for (const inc of incidents) {
+        events.push({
+            timestamp: inc.startedAt,
+            type: 'incident_open',
+            detail: `Incident ${inc.id} opened (${inc.peakLevel}): ${inc.reason}`,
+        });
+        if (inc.closedAt) {
+            events.push({
+                timestamp: inc.closedAt,
+                type: 'incident_close',
+                detail: `Incident ${inc.id} closed`,
+            });
+        }
+        if (inc.bundleCaptured && inc.bundlePath) {
+            events.push({
+                timestamp: inc.startedAt, // approximate
+                type: 'bundle_captured',
+                detail: `Bundle for incident ${inc.id}: ${inc.bundlePath}`,
+            });
+        }
+    }
+    // Add current state info
+    const state = await readState();
+    if (state) {
+        events.push({
+            timestamp: state.updatedAt,
+            type: 'risk_change',
+            detail: `Current risk: ${state.hangRisk.level} | attention: ${state.attention.level}`,
+        });
+        if (state.budgetSummary && state.budgetSummary.currentCap < state.budgetSummary.baseCap) {
+            events.push({
+                timestamp: state.updatedAt,
+                type: 'budget_change',
+                detail: `Budget cap: ${state.budgetSummary.currentCap}/${state.budgetSummary.baseCap} (reduced by ${state.budgetSummary.capSetByRisk})`,
+            });
+        }
+    }
+    // Sort chronologically
+    events.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+    return events;
+}
+/** Build events.jsonl content from recent journal entries. */
+function buildEventLines(recentJournal) {
+    return recentJournal.map(e => JSON.stringify(e)).join('\n');
+}
+/** Format a doctor summary as a human-readable report. */
+export function formatDoctorReport(summary) {
+    const lines = [];
+    lines.push('=== Claude Guardian Doctor Report ===');
+    lines.push(`Generated: ${summary.timestamp}`);
+    lines.push('');
+    // System
+    lines.push('System:');
+    lines.push(`  Platform: ${summary.system.platform} ${summary.system.release}`);
+    lines.push(`  Arch: ${summary.system.arch}`);
+    lines.push(`  Memory: ${summary.system.freeMemoryGB}GB free / ${summary.system.totalMemoryGB}GB total`);
+    lines.push(`  CPU: ${summary.system.cpuModel} (${summary.system.cpuCores} cores)`);
+    lines.push(`  Disk free: ${Math.round(summary.system.diskFreeGB * 100) / 100}GB`);
+    lines.push(`  Node: ${summary.system.nodeVersion}`);
+    lines.push('');
+    // Claude projects
+    lines.push('Claude Projects:');
+    lines.push(`  Total size: ${summary.claudeProjects.claudeProjectsSizeMB}MB`);
+    lines.push(`  Issues: ${summary.claudeProjects.actions.length}`);
+    lines.push('');
+    // Biggest files
+    if (summary.biggestFiles.length > 0) {
+        lines.push('Biggest files:');
+        for (const f of summary.biggestFiles.slice(0, 10)) {
+            const name = basename(f.path);
+            lines.push(`  ${name}: ${f.sizeMB}MB`);
+        }
+        lines.push('');
+    }
+    // Process snapshot
+    if (summary.processSnapshot.processes.length > 0) {
+        lines.push('Process Snapshot:');
+        for (const p of summary.processSnapshot.processes) {
+            let line = `  PID ${p.pid} (${p.name}): CPU ${p.cpuPercent}% | RAM ${p.memoryMB}MB`;
+            if (p.handleCount != null) {
+                line += ` | handles=${p.handleCount}`;
+            }
+            lines.push(line);
+        }
+        lines.push(`  Activity: log=${summary.processSnapshot.activitySignals.logLastModifiedSecondsAgo}s ago | cpu=${summary.processSnapshot.activitySignals.cpuActive ? 'active' : 'idle'}`);
+        lines.push('');
+    }
+    // Timeline
+    if (summary.timeline.length > 0) {
+        lines.push(`Timeline: ${summary.timeline.length} events`);
+        for (const event of summary.timeline.slice(-10)) {
+            lines.push(`  [${event.timestamp}] ${event.type}: ${event.detail}`);
+        }
+        lines.push('');
+    }
+    // Journal
+    lines.push(`Guardian journal: ${summary.journalEntries} entries`);
+    if (summary.recentJournal.length > 0) {
+        lines.push('Recent actions:');
+        for (const entry of summary.recentJournal.slice(-5)) {
+            lines.push(`  [${entry.timestamp}] ${entry.action}: ${entry.detail}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAa,QAAQ,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,IAAI,CAAC;AACnD,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAEzE,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACvF,OAAO,EACI,kBAAkB,EAAE,aAAa,EAAE,SAAS,EACrD,QAAQ,EAAE,WAAW,EAAE,UAAU,GAClC,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAsB,MAAM,sBAAsB,CAAC;AACrG,OAAO,EAAE,eAAe,EAA0B,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,eAAe,EAAiB,MAAM,eAAe,CAAC;AA6D/D,kCAAkC;AAClC,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,MAAM,OAAO,GAAG,IAAI,EAAE,CAAC;IACvB,OAAO;QACL,QAAQ,EAAE,QAAQ,EAAE;QACpB,OAAO,EAAE,OAAO,EAAE;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG;QACjE,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG;QAC/D,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,SAAS;QACxC,QAAQ,EAAE,OAAO,CAAC,MAAM;QACxB,UAAU;QACV,WAAW,EAAE,OAAO,CAAC,OAAO;KAC7B,CAAC;AACJ,CAAC;AAED,0CAA0C;AAC1C,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAmB;IACtD,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IACtC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,UAAU,IAAI,IAAI,CAAC,OAAO,EAAE,UAAU,SAAS,MAAM,CAAC,CAAC;IAEvE,yBAAyB;IACzB,MAAM,cAAc,GAAG,MAAM,QAAQ,EAAE,CAAC;IAExC,sBAAsB;IACtB,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAEjD,qBAAqB;IACrB,MAAM,UAAU,GAAG,qBAAqB,EAAE,CAAC;IAC3C,MAAM,YAAY,GAA4C,EAAE,CAAC;IACjE,IAAI,MAAM,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,UAAU,CAAC,CAAC;QACtD,MAAM,SAAS,GAA4C,EAAE,CAAC;QAC9D,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YAC7C,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;YACxB,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;QAC9C,YAAY,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,eAAe;IACf,MAAM,OAAO,GAAG,MAAM,WAAW,EAAE,CAAC;IACpC,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACjD,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM;KACjB,CAAC,CAAC,CAAC;IAEJ,qDAAqD;IACrD,MAAM,SAAS,GAAG,MAAM,mBAAmB,EAAE,CAAC;IAC9C,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC;QACvC,CAAC,CAAC,MAAM,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAClD,CAAC,CAAC,EAAE,CAAC;IAEP,yBAAyB;IACzB,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACvD,MAAM,eAAe,GAAG,oBAAoB,CAAC,SAAS,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;IAEhF,0CAA0C;IAC1C,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAE7D,MAAM,OAAO,GAAkB;QAC7B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,MAAM,EAAE,UAAU;QAClB,cAAc;QACd,YAAY;QACZ,cAAc,EAAE,OAAO,CAAC,MAAM;QAC9B,aAAa;QACb,YAAY;QACZ,eAAe;QACf,QAAQ;KACT,CAAC;IAEF,gBAAgB;IAChB,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAEpD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC;AAED,2DAA2D;AAC3D,KAAK,UAAU,eAAe,CAC5B,OAAe,EACf,OAAsB,EACtB,UAAkB;IAElB,2BAA2B;IAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAExD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5B,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAErB,mBAAmB;QACnB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;QAE3E,oDAAoD;QACpD,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;YAC1B,IAAI,MAAM,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBACjC,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,UAAU,CAAC,CAAC;gBACtD,sEAAsE;gBACtE,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACpC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CACxF,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAEf,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;oBAC1B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,eAAe,CAAC,CAAC;oBAC3D,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACpB,6CAA6C;wBAC7C,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;wBAChE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,aAAa,OAAO,EAAE,EAAE,CAAC,CAAC;oBACzD,CAAC;gBACH,CAAC;YACH,CAAC;YAED,2BAA2B;YAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,EAAE,EAAE,eAAe,CAAC,CAAC;YACjE,IAAI,MAAM,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;gBAClC,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;gBAC5D,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;YAC5D,CAAC;YAED,uBAAuB;YACvB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;YAE3F,eAAe;YACf,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;YAErF,qEAAqE;YACrE,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YACtD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;YACnD,CAAC;YAED,iCAAiC;YACjC,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,EAAE,EAAE,YAAY,CAAC,CAAC;YAC5D,IAAI,MAAM,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAChC,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;gBACxD,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;YACvD,CAAC;YAED,iCAAiC;YACjC,MAAM,aAAa,GAAG,IAAI,CAAC,mBAAmB,EAAE,EAAE,iBAAiB,CAAC,CAAC;YACrE,IAAI,MAAM,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;gBACpC,MAAM,gBAAgB,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;gBAChE,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC;YAChE,CAAC;YAED,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,CAAC,CAAC;QAEF,QAAQ,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,yEAAyE;AACzE,SAAS,oBAAoB,CAC3B,SAA0B,EAC1B,YAAiC,EACjC,QAAsF;IAEtF,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnE,OAAO;QACL,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC7B,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,aAAa,EAAE,CAAC,CAAC,aAAa;YAC9B,WAAW,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI;SAC1C,CAAC,CAAC;QACH,eAAe,EAAE;YACf,yBAAyB,EAAE,QAAQ,CAAC,yBAAyB;YAC7D,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO;SAC1B;KACF,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,KAAK,UAAU,aAAa,CAC1B,OAAsF,EACtF,aAA2E;IAE3E,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,qBAAqB;IACrB,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QACxC,IAAI,IAAI,GAA0B,SAAS,CAAC;QAC5C,IAAI,KAAK,CAAC,MAAM,KAAK,aAAa,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAChE,IAAI,GAAG,iBAAiB,CAAC;QAC3B,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5G,IAAI,GAAG,aAAa,CAAC;QACvB,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,IAAI;YACJ,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE;SAC3C,CAAC,CAAC;IACL,CAAC;IAED,sBAAsB;IACtB,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,EAAE,CAAC,CAAC;IAC5C,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC;YACV,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,IAAI,EAAE,eAAe;YACrB,MAAM,EAAE,YAAY,GAAG,CAAC,EAAE,YAAY,GAAG,CAAC,SAAS,MAAM,GAAG,CAAC,MAAM,EAAE;SACtE,CAAC,CAAC;QACH,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC;gBACV,SAAS,EAAE,GAAG,CAAC,QAAQ;gBACvB,IAAI,EAAE,gBAAgB;gBACtB,MAAM,EAAE,YAAY,GAAG,CAAC,EAAE,SAAS;aACpC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC;gBACV,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,cAAc;gBACxC,IAAI,EAAE,iBAAiB;gBACvB,MAAM,EAAE,uBAAuB,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,UAAU,EAAE;aAC3D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAChC,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,CAAC,IAAI,CAAC;YACV,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,iBAAiB,KAAK,CAAC,QAAQ,CAAC,KAAK,iBAAiB,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE;SACtF,CAAC,CAAC;QACH,IAAI,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,aAAa,CAAC,UAAU,GAAG,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;YACxF,MAAM,CAAC,IAAI,CAAC;gBACV,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,IAAI,EAAE,eAAe;gBACrB,MAAM,EAAE,eAAe,KAAK,CAAC,aAAa,CAAC,UAAU,IAAI,KAAK,CAAC,aAAa,CAAC,OAAO,gBAAgB,KAAK,CAAC,aAAa,CAAC,YAAY,GAAG;aACxI,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAEzF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8DAA8D;AAC9D,SAAS,eAAe,CAAC,aAA2E;IAClG,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,kBAAkB,CAAC,OAAsB;IACvD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,cAAc,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,SAAS;IACT,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,eAAe,OAAO,CAAC,MAAM,CAAC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/E,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7C,KAAK,CAAC,IAAI,CAAC,aAAa,OAAO,CAAC,MAAM,CAAC,YAAY,aAAa,OAAO,CAAC,MAAM,CAAC,aAAa,UAAU,CAAC,CAAC;IACxG,KAAK,CAAC,IAAI,CAAC,UAAU,OAAO,CAAC,MAAM,CAAC,QAAQ,KAAK,OAAO,CAAC,MAAM,CAAC,QAAQ,SAAS,CAAC,CAAC;IACnF,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IAClF,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,kBAAkB;IAClB,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC/B,KAAK,CAAC,IAAI,CAAC,iBAAiB,OAAO,CAAC,cAAc,CAAC,oBAAoB,IAAI,CAAC,CAAC;IAC7E,KAAK,CAAC,IAAI,CAAC,aAAa,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACjE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,gBAAgB;IAChB,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;QACzC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,mBAAmB;IACnB,IAAI,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,eAAe,CAAC,SAAS,EAAE,CAAC;YAClD,IAAI,IAAI,GAAG,SAAS,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,UAAU,WAAW,CAAC,CAAC,QAAQ,IAAI,CAAC;YACpF,IAAI,CAAC,CAAC,WAAW,IAAI,IAAI,EAAE,CAAC;gBAC1B,IAAI,IAAI,cAAc,CAAC,CAAC,WAAW,EAAE,CAAC;YACxC,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,mBAAmB,OAAO,CAAC,eAAe,CAAC,eAAe,CAAC,yBAAyB,eAAe,OAAO,CAAC,eAAe,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACvL,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,WAAW;IACX,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,aAAa,OAAO,CAAC,QAAQ,CAAC,MAAM,SAAS,CAAC,CAAC;QAC1D,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,UAAU;IACV,KAAK,CAAC,IAAI,CAAC,qBAAqB,OAAO,CAAC,cAAc,UAAU,CAAC,CAAC;IAClE,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC9B,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Structured error type used across CLI + MCP.
+ * Every guardian error carries a machine-readable code, a human hint, and optionally the root cause.
+ */
+/** Error codes — one per failure mode. */
+export type GuardianErrorCode = 'STATE_CORRUPT' | 'STATE_WRITE_FAILED' | 'BUDGET_CORRUPT' | 'BUDGET_WRITE_FAILED' | 'BUNDLE_FAILED' | 'SCAN_FAILED' | 'FIX_FAILED' | 'PROCESS_SCAN_FAILED' | 'DISK_CHECK_FAILED' | 'UNKNOWN';
+export declare class GuardianError extends Error {
+    /** Machine-readable error code. */
+    readonly code: GuardianErrorCode;
+    /** Human-friendly hint about what to do. */
+    readonly hint: string;
+    /** Original error (if wrapping). */
+    readonly cause?: Error;
+    constructor(code: GuardianErrorCode, message: string, hint: string, cause?: Error);
+    /** Format for MCP tool responses (no stack traces). */
+    toMcpText(): string;
+    /** Format for CLI output. */
+    toCliText(): string;
+}
+/** Wrap any thrown value into a GuardianError. */
+export declare function wrapError(err: unknown, code: GuardianErrorCode, hint: string): GuardianError;

package/dist/errors.js

@@ -0,0 +1,46 @@
+/**
+ * Structured error type used across CLI + MCP.
+ * Every guardian error carries a machine-readable code, a human hint, and optionally the root cause.
+ */
+export class GuardianError extends Error {
+    /** Machine-readable error code. */
+    code;
+    /** Human-friendly hint about what to do. */
+    hint;
+    /** Original error (if wrapping). */
+    cause;
+    constructor(code, message, hint, cause) {
+        super(message);
+        this.name = 'GuardianError';
+        this.code = code;
+        this.hint = hint;
+        this.cause = cause;
+    }
+    /** Format for MCP tool responses (no stack traces). */
+    toMcpText() {
+        const lines = [`Error [${this.code}]: ${this.message}`];
+        lines.push(`Hint: ${this.hint}`);
+        if (this.cause) {
+            lines.push(`Cause: ${this.cause.message}`);
+        }
+        return lines.join('\n');
+    }
+    /** Format for CLI output. */
+    toCliText() {
+        const lines = [`[guardian] Error: ${this.message}`];
+        lines.push(`  Code: ${this.code}`);
+        lines.push(`  Hint: ${this.hint}`);
+        if (this.cause) {
+            lines.push(`  Cause: ${this.cause.message}`);
+        }
+        return lines.join('\n');
+    }
+}
+/** Wrap any thrown value into a GuardianError. */
+export function wrapError(err, code, hint) {
+    if (err instanceof GuardianError)
+        return err;
+    const cause = err instanceof Error ? err : new Error(String(err));
+    return new GuardianError(code, cause.message, hint, cause);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,mCAAmC;IAC1B,IAAI,CAAoB;IACjC,4CAA4C;IACnC,IAAI,CAAS;IACtB,oCAAoC;IAC3B,KAAK,CAAS;IAEvB,YAAY,IAAuB,EAAE,OAAe,EAAE,IAAY,EAAE,KAAa;QAC/E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,uDAAuD;IACvD,SAAS;QACP,MAAM,KAAK,GAAG,CAAC,UAAU,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,6BAA6B;IAC7B,SAAS;QACP,MAAM,KAAK,GAAG,CAAC,qBAAqB,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF;AAED,kDAAkD;AAClD,MAAM,UAAU,SAAS,CAAC,GAAY,EAAE,IAAuB,EAAE,IAAY;IAC3E,IAAI,GAAG,YAAY,aAAa;QAAE,OAAO,GAAG,CAAC;IAC7C,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAClE,OAAO,IAAI,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAC7D,CAAC"}

package/dist/fs-utils.d.ts

@@ -0,0 +1,23 @@
+import type { JournalEntry } from './types.js';
+/** Get size of a file in bytes. Returns 0 if file doesn't exist. */
+export declare function fileSize(filePath: string): Promise<number>;
+/** Get total size of a directory (recursive) in bytes. */
+export declare function dirSize(dirPath: string): Promise<number>;
+/** List all files in a directory recursively. */
+export declare function listFilesRecursive(dirPath: string): Promise<string[]>;
+/** Get disk free space in GB for the drive containing a given path. */
+export declare function getDiskFreeGB(targetPath: string): Promise<number>;
+/** Gzip a file in place (original → original.gz, original deleted). */
+export declare function gzipFile(filePath: string): Promise<string>;
+/** Read the last N lines of a file. */
+export declare function tailFile(filePath: string, lines: number): Promise<string>;
+/** Trim a file to its last N lines. Returns new size in bytes. */
+export declare function trimFileToLines(filePath: string, keepLines: number): Promise<number>;
+/** Append a journal entry. */
+export declare function writeJournalEntry(entry: JournalEntry): Promise<void>;
+/** Read the journal (last N entries). */
+export declare function readJournal(lastN?: number): Promise<JournalEntry[]>;
+/** Bytes to MB, 2 decimal places. */
+export declare function bytesToMB(bytes: number): number;
+/** Check if a path exists. */
+export declare function pathExists(p: string): Promise<boolean>;