@tyroneross/build-loop 0.30.3

package/dist/src/logger.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Internal Logger & Tracer
+ *
+ * Structured logging for the debugger's own operations.
+ * Zero new dependencies. File-only output (never stdout — MCP uses it).
+ *
+ * Key exports:
+ * - traced(op, args, fn) — wrap any async operation with start/end/error/duration
+ * - log(level, op, data) — direct log call
+ * - readLogs(options) — read log entries with filtering
+ * - configureLogger(overrides) — set log dir, min level, etc.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LogEntry {
+    ts: number;
+    level: LogLevel;
+    op: string;
+    dur_ms?: number;
+    args?: Record<string, unknown>;
+    result?: string;
+    error?: {
+        name: string;
+        message: string;
+        stack?: string;
+    };
+}
+export interface LoggerConfig {
+    logDir: string;
+    minLevel: LogLevel;
+    maxFileSize: number;
+    maxRotatedFiles: number;
+    promoteErrors: boolean;
+    promoteSlowMs: number;
+}
+/**
+ * Configure the logger. Call once at startup.
+ */
+export declare function configureLogger(overrides?: Partial<LoggerConfig>): void;
+/**
+ * Write a log entry. Fails silently — broken logging never breaks operations.
+ */
+export declare function log(level: LogLevel, op: string, data?: Partial<Omit<LogEntry, 'ts' | 'level' | 'op'>>): void;
+/**
+ * Wrap an async operation with automatic start/end/error/duration logging.
+ * Returns the function's result unchanged.
+ */
+export declare function traced<T>(op: string, args: Record<string, unknown> | undefined, fn: () => Promise<T>): Promise<T>;
+export interface ReadLogsOptions {
+    since?: number;
+    until?: number;
+    level?: LogLevel;
+    keyword?: string;
+    limit?: number;
+}
+/**
+ * Read log entries from the debugger's operation log.
+ */
+export declare function readLogs(options?: ReadLogsOptions): Promise<LogEntry[]>;
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAYH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,QAAQ,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3D;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AA4BD;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAevE;AAMD;;GAEG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAY5G;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,CAAC,EAC5B,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACzC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAsCZ;AAMD,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAuCjF"}

package/dist/src/logger.js

@@ -0,0 +1,328 @@
+"use strict";
+// SPDX-FileCopyrightText: 2025-2026 Tyrone Ross, Jr <46267523+tyroneross@users.noreply.github.com>
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Internal Logger & Tracer
+ *
+ * Structured logging for the debugger's own operations.
+ * Zero new dependencies. File-only output (never stdout — MCP uses it).
+ *
+ * Key exports:
+ * - traced(op, args, fn) — wrap any async operation with start/end/error/duration
+ * - log(level, op, data) — direct log call
+ * - readLogs(options) — read log entries with filtering
+ * - configureLogger(overrides) — set log dir, min level, etc.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureLogger = configureLogger;
+exports.log = log;
+exports.traced = traced;
+exports.readLogs = readLogs;
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const config_1 = require("./config");
+const storage_1 = require("./traces/storage");
+// ============================================================================
+// STATE
+// ============================================================================
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+let config = {
+    logDir: '',
+    minLevel: 'info',
+    maxFileSize: 10 * 1024 * 1024, // 10MB
+    maxRotatedFiles: 2,
+    promoteErrors: true,
+    promoteSlowMs: 2000,
+};
+let initialized = false;
+// ============================================================================
+// CONFIGURATION
+// ============================================================================
+/**
+ * Configure the logger. Call once at startup.
+ */
+function configureLogger(overrides) {
+    const paths = (0, config_1.getLogPaths)();
+    config = {
+        ...config,
+        logDir: paths.root,
+        ...overrides,
+    };
+    // Read env var for log level
+    const envLevel = process.env.DEBUGGER_LOG_LEVEL;
+    if (envLevel && envLevel in LOG_LEVELS) {
+        config.minLevel = envLevel;
+    }
+    initialized = true;
+}
+// ============================================================================
+// CORE LOGGING
+// ============================================================================
+/**
+ * Write a log entry. Fails silently — broken logging never breaks operations.
+ */
+function log(level, op, data) {
+    if (LOG_LEVELS[level] < LOG_LEVELS[config.minLevel])
+        return;
+    const entry = {
+        ts: Date.now(),
+        level,
+        op,
+        ...data,
+    };
+    // Fire and forget — never await, never throw
+    appendEntry(entry).catch(() => { });
+}
+/**
+ * Wrap an async operation with automatic start/end/error/duration logging.
+ * Returns the function's result unchanged.
+ */
+async function traced(op, args, fn) {
+    const start = Date.now();
+    try {
+        const result = await fn();
+        const dur_ms = Date.now() - start;
+        log('info', op, {
+            dur_ms,
+            args: sanitizeArgs(args),
+            result: summarizeResult(result),
+        });
+        // Promote slow operations
+        if (config.promoteErrors && dur_ms > config.promoteSlowMs) {
+            promoteToTrace(op, dur_ms, args).catch(() => { });
+        }
+        return result;
+    }
+    catch (err) {
+        const dur_ms = Date.now() - start;
+        const errorInfo = err instanceof Error
+            ? { name: err.name, message: err.message, stack: err.stack?.split('\n').slice(0, 4).join('\n') }
+            : { name: 'Unknown', message: String(err) };
+        log('error', op, {
+            dur_ms,
+            args: sanitizeArgs(args),
+            error: errorInfo,
+        });
+        // Promote errors
+        if (config.promoteErrors) {
+            promoteToTrace(op, dur_ms, args, errorInfo).catch(() => { });
+        }
+        throw err;
+    }
+}
+/**
+ * Read log entries from the debugger's operation log.
+ */
+async function readLogs(options = {}) {
+    const { since, until, level, keyword, limit = 50 } = options;
+    const logFile = getOperationsLogPath();
+    try {
+        const content = await promises_1.default.readFile(logFile, 'utf-8');
+        const lines = content.trim().split('\n').filter(Boolean);
+        const entries = [];
+        for (const line of lines) {
+            try {
+                const entry = JSON.parse(line);
+                // Time filter
+                if (since && entry.ts < since)
+                    continue;
+                if (until && entry.ts > until)
+                    continue;
+                // Level filter
+                if (level && LOG_LEVELS[entry.level] < LOG_LEVELS[level])
+                    continue;
+                // Keyword filter
+                if (keyword) {
+                    const kw = keyword.toLowerCase();
+                    const searchable = `${entry.op} ${entry.result || ''} ${entry.error?.message || ''}`.toLowerCase();
+                    if (!searchable.includes(kw))
+                        continue;
+                }
+                entries.push(entry);
+            }
+            catch {
+                // Skip malformed lines
+            }
+        }
+        // Return most recent entries up to limit
+        return entries.slice(-limit);
+    }
+    catch {
+        return [];
+    }
+}
+// ============================================================================
+// FILE I/O
+// ============================================================================
+function getOperationsLogPath() {
+    if (!initialized) {
+        // Lazy init with defaults
+        configureLogger();
+    }
+    return path_1.default.join(config.logDir, 'operations.jsonl');
+}
+function getErrorsLogPath() {
+    return path_1.default.join(config.logDir, 'errors.jsonl');
+}
+/**
+ * Append a log entry to the JSONL file. Handles rotation.
+ */
+async function appendEntry(entry) {
+    try {
+        const logPath = getOperationsLogPath();
+        await promises_1.default.mkdir(path_1.default.dirname(logPath), { recursive: true });
+        const line = JSON.stringify(entry) + '\n';
+        await promises_1.default.appendFile(logPath, line, 'utf-8');
+        // Also write errors to separate file for quick access
+        if (entry.level === 'error') {
+            const errPath = getErrorsLogPath();
+            await promises_1.default.appendFile(errPath, line, 'utf-8');
+        }
+        // Check rotation
+        await rotateIfNeeded(logPath);
+    }
+    catch {
+        // Fail silently — broken logging never breaks operations
+    }
+}
+/**
+ * Rotate log file if it exceeds maxFileSize.
+ */
+async function rotateIfNeeded(logPath) {
+    try {
+        const stat = await promises_1.default.stat(logPath);
+        if (stat.size < config.maxFileSize)
+            return;
+        // Shift existing rotated files
+        for (let i = config.maxRotatedFiles - 1; i >= 1; i--) {
+            const from = `${logPath}.${i}`;
+            const to = `${logPath}.${i + 1}`;
+            try {
+                await promises_1.default.rename(from, to);
+            }
+            catch {
+                // File doesn't exist, skip
+            }
+        }
+        // Rotate current file
+        await promises_1.default.rename(logPath, `${logPath}.1`);
+        // Delete oldest if over limit
+        try {
+            await promises_1.default.unlink(`${logPath}.${config.maxRotatedFiles + 1}`);
+        }
+        catch {
+            // Doesn't exist
+        }
+    }
+    catch {
+        // Rotation failed — not critical
+    }
+}
+// ============================================================================
+// TRACE PROMOTION
+// ============================================================================
+/**
+ * Promote an error or slow operation to a UnifiedTrace for cross-correlation.
+ */
+async function promoteToTrace(op, dur_ms, args, error) {
+    try {
+        const trace = {
+            trace_id: (0, storage_1.generateTraceId)(),
+            source: 'internal',
+            timestamp: Date.now(),
+            duration_ms: dur_ms,
+            severity: error ? 'error' : 'warning',
+            category: 'custom',
+            operation: op,
+            summary: {
+                description: error
+                    ? `${op} failed: ${error.message}`.slice(0, 200)
+                    : `${op} slow: ${dur_ms}ms`.slice(0, 200),
+                highlights: [
+                    { label: 'operation', value: op },
+                    { label: 'duration', value: `${dur_ms}ms` },
+                    ...(args ? [{ label: 'args', value: JSON.stringify(args).slice(0, 100) }] : []),
+                ],
+                ...(error ? {
+                    error: {
+                        type: error.name,
+                        message: error.message.slice(0, 200),
+                        stack_preview: error.stack,
+                    },
+                } : {}),
+                performance: {
+                    duration_ms: dur_ms,
+                    is_slow: dur_ms > config.promoteSlowMs,
+                },
+            },
+            has_full_data: false,
+            tokens_estimated: 50,
+        };
+        await (0, storage_1.storeTrace)(trace);
+    }
+    catch {
+        // Promotion failed — not critical
+    }
+}
+// ============================================================================
+// HELPERS
+// ============================================================================
+/**
+ * Sanitize args for logging — remove large values, truncate strings.
+ */
+function sanitizeArgs(args) {
+    if (!args)
+        return undefined;
+    const sanitized = {};
+    for (const [key, value] of Object.entries(args)) {
+        if (typeof value === 'string') {
+            sanitized[key] = value.length > 200 ? value.slice(0, 200) + '...' : value;
+        }
+        else if (Array.isArray(value)) {
+            sanitized[key] = `[${value.length} items]`;
+        }
+        else if (typeof value === 'object' && value !== null) {
+            sanitized[key] = '{...}';
+        }
+        else {
+            sanitized[key] = value;
+        }
+    }
+    return sanitized;
+}
+/**
+ * Create a brief string summary of a result for the log.
+ */
+function summarizeResult(result) {
+    if (result === undefined || result === null)
+        return 'void';
+    if (typeof result === 'string')
+        return result.slice(0, 100);
+    if (typeof result === 'number' || typeof result === 'boolean')
+        return String(result);
+    if (Array.isArray(result))
+        return `[${result.length} items]`;
+    // Check for MCP-style response
+    if (typeof result === 'object' && result !== null) {
+        const obj = result;
+        if (obj.content && Array.isArray(obj.content)) {
+            const first = obj.content[0];
+            if (first?.text && typeof first.text === 'string') {
+                return first.text.slice(0, 100);
+            }
+        }
+        // Generic object
+        const keys = Object.keys(obj);
+        return `{${keys.slice(0, 3).join(', ')}${keys.length > 3 ? '...' : ''}}`;
+    }
+    return typeof result;
+}
+//# sourceMappingURL=logger.js.map

package/dist/src/logger.js.map

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

package/dist/src/parallel-retrieval.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Parallel Retrieval System
+ *
+ * Runs all 4 retrieval strategies simultaneously using Promise.all.
+ * Significantly faster than sequential execution (~4x speedup).
+ *
+ * Strategies:
+ * - Exact Match (score: 1.0) - Substring matching in symptom
+ * - Tag Match (score: 0.9) - Bidirectional keyword matching on tags
+ * - Fuzzy Match (score: 0.7-0.85) - Jaro-Winkler distance for similar strings
+ * - Category Match (score: 0.6) - Group similar categories
+ */
+import type { Pattern, ParallelSearchResult, ParallelRetrievalResult, MemoryConfig } from './types';
+/**
+ * Execute all retrieval strategies in parallel
+ *
+ * @param query - Search query (symptom description)
+ * @param options - Configuration options
+ * @returns Merged and ranked results from all strategies
+ */
+export declare function parallelSearch(query: string, options?: {
+    threshold?: number;
+    maxResults?: number;
+    memoryConfig?: MemoryConfig;
+}): Promise<ParallelRetrievalResult>;
+/**
+ * Match patterns in parallel
+ *
+ * Scores all patterns simultaneously using Promise.all
+ */
+export declare function parallelPatternMatch(symptom: string, options?: {
+    memoryConfig?: MemoryConfig;
+    threshold?: number;
+    maxResults?: number;
+}): Promise<Pattern[]>;
+/**
+ * Combined parallel search with patterns and incidents
+ *
+ * Runs pattern matching and incident search in parallel,
+ * then merges results with priority to patterns.
+ */
+export declare function parallelMemoryCheck(symptom: string, options?: {
+    threshold?: number;
+    maxResults?: number;
+    memoryConfig?: MemoryConfig;
+}): Promise<{
+    patterns: Pattern[];
+    incidents: ParallelSearchResult[];
+    execution_time_ms: number;
+    parallel_speedup: number;
+}>;
+//# sourceMappingURL=parallel-retrieval.d.ts.map

package/dist/src/parallel-retrieval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-retrieval.d.ts","sourceRoot":"","sources":["../../src/parallel-retrieval.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAEV,OAAO,EACP,oBAAoB,EACpB,uBAAuB,EACvB,YAAY,EACb,MAAM,SAAS,CAAC;AASjB;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,GACA,OAAO,CAAC,uBAAuB,CAAC,CAwDlC;AAkLD;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,YAAY,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACjF,OAAO,CAAC,OAAO,EAAE,CAAC,CAwBpB;AA4ED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,GACA,OAAO,CAAC;IACT,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,SAAS,EAAE,oBAAoB,EAAE,CAAC;IAClC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC,CAiBD"}