erosolar-cli 1.7.195 → 1.7.197

package/dist/utils/errorUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorUtils.d.ts","sourceRoot":"","sources":["../../src/utils/errorUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAcD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,YAAY,EACtB,IAAI,CAAC,EAAE,MAAM,GACZ,YAAY,CAWd;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,CAkBpF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOxD;AAED,wBAAsB,SAAS,CAAC,CAAC,EAC/B,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,UAAU,GAAE,MAAU,EACtB,OAAO,GAAE,MAAa,GACrB,OAAO,CAAC,CAAC,CAAC,CAkBZ"}

package/dist/utils/errorUtils.js

@@ -0,0 +1,66 @@
+/**
+ * Enhanced error utilities for better debugging and error reporting
+ */
+// Centralized configuration for retryable error patterns
+const RETRYABLE_ERROR_PATTERNS = [
+    'timeout',
+    'network',
+    'rate limit',
+    'too many requests',
+    'service unavailable',
+    'gateway timeout',
+    'bad gateway',
+    'internal server error',
+];
+export function createErrorDetails(error, context, code) {
+    const message = error instanceof Error ? error.message : String(error);
+    const stack = error instanceof Error ? error.stack : undefined;
+    return {
+        message,
+        code,
+        context,
+        stack,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function formatErrorForLogging(error, context) {
+    const details = createErrorDetails(error, context);
+    const parts = [
+        `[${details.timestamp}]`,
+        details.code ? `[${details.code}]` : '',
+        details.message,
+    ];
+    if (details.context && Object.keys(details.context).length > 0) {
+        parts.push(`Context: ${JSON.stringify(details.context)}`);
+    }
+    if (details.stack) {
+        parts.push(`Stack: ${details.stack}`);
+    }
+    return parts.filter(Boolean).join(' ');
+}
+export function isRetryableError(error) {
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    const message = error.message.toLowerCase();
+    return RETRYABLE_ERROR_PATTERNS.some(pattern => message.includes(pattern));
+}
+export async function withRetry(operation, maxRetries = 3, delayMs = 1000) {
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            // Don't retry if we've exhausted attempts or error is not retryable
+            if (attempt === maxRetries || !isRetryableError(error)) {
+                throw error;
+            }
+            // Exponential backoff
+            const backoffDelay = delayMs * Math.pow(2, attempt);
+            await new Promise(resolve => setTimeout(resolve, backoffDelay));
+        }
+    }
+    // This should never be reached due to the throw above, but TypeScript needs it
+    throw new Error('Retry logic failed unexpectedly');
+}
+//# sourceMappingURL=errorUtils.js.map

package/dist/utils/errorUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorUtils.js","sourceRoot":"","sources":["../../src/utils/errorUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,yDAAyD;AACzD,MAAM,wBAAwB,GAAG;IAC/B,SAAS;IACT,SAAS;IACT,YAAY;IACZ,mBAAmB;IACnB,qBAAqB;IACrB,iBAAiB;IACjB,aAAa;IACb,uBAAuB;CACf,CAAC;AAEX,MAAM,UAAU,kBAAkB,CAChC,KAAc,EACd,OAAsB,EACtB,IAAa;IAEb,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAE/D,OAAO;QACL,OAAO;QACP,IAAI;QACJ,OAAO;QACP,KAAK;QACL,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAc,EAAE,OAAsB;IAC1E,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAEnD,MAAM,KAAK,GAAG;QACZ,IAAI,OAAO,CAAC,SAAS,GAAG;QACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE;QACvC,OAAO,CAAC,OAAO;KAChB,CAAC;IAEF,IAAI,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,UAAU,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IAC5C,OAAO,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,SAA2B,EAC3B,aAAqB,CAAC,EACtB,UAAkB,IAAI;IAEtB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,oEAAoE;YACpE,IAAI,OAAO,KAAK,UAAU,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvD,MAAM,KAAK,CAAC;YACd,CAAC;YAED,sBAAsB;YACtB,MAAM,YAAY,GAAG,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACpD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,+EAA+E;IAC/E,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;AACrD,CAAC"}

package/dist/utils/planFormatter.d.ts

@@ -0,0 +1,34 @@
+export type PlanStatus = 'pending' | 'in_progress' | 'completed';
+export interface PlanItem {
+    step: string;
+    status?: PlanStatus;
+}
+export type NormalizedPlanItem = PlanItem & {
+    status: PlanStatus;
+};
+export type PlanInput = Array<PlanItem | string | number | boolean | null | undefined>;
+export interface PlanFormatOptions {
+    heading?: string;
+    bullet?: string;
+    width?: number;
+    statusSymbols?: Partial<Record<PlanStatus, string>>;
+}
+/**
+ * Format a structured plan for display with compact tree-like layout.
+ */
+export declare function formatPlan(plan: PlanInput, options?: PlanFormatOptions): string;
+export declare function formatPlan(plan: unknown, options?: PlanFormatOptions): string;
+/**
+ * Normalize plan input into a typed list of steps with default statuses.
+ */
+export declare function normalizePlanItems(plan: PlanInput): NormalizedPlanItem[];
+export declare function normalizePlanItems(plan: unknown): NormalizedPlanItem[];
+/**
+ * Wrap plan text with a prefix, preserving indentation for continuations.
+ */
+export declare function wrapPlanText(text: string, prefix: string, width?: number): string[];
+/**
+ * Determine the available plan width using the terminal size if available.
+ */
+export declare function resolvePlanWidth(padding?: number): number | undefined;
+//# sourceMappingURL=planFormatter.d.ts.map

package/dist/utils/planFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planFormatter.d.ts","sourceRoot":"","sources":["../../src/utils/planFormatter.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;AAEjE,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AACnE,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAEvF,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC;AACjF,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC;AAuB/E;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,kBAAkB,EAAE,CAAC;AAC1E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,EAAE,CAAC;AAyCxE;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAanF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,MAAU,GAAG,MAAM,GAAG,SAAS,CASxE"}

package/dist/utils/planFormatter.js

@@ -0,0 +1,140 @@
+const ANSI_REGEX = /\u001B\[[0-9;]*m/g;
+const DEFAULT_WIDTH = 78;
+const MIN_WIDTH = 42;
+const MAX_WIDTH = 100;
+export function formatPlan(plan, options = {}) {
+    const width = clampWidth(options.width);
+    const heading = (options.heading ?? 'Updated Plan').trim() || 'Updated Plan';
+    const bullet = (options.bullet ?? '•').trim() || '•';
+    const items = normalizePlanItems(plan);
+    const lines = [`${bullet} ${heading}`];
+    if (!items.length) {
+        lines.push('  (no steps provided)');
+        return lines.join('\n');
+    }
+    const statusSymbols = buildStatusSymbols(options.statusSymbols);
+    items.forEach((item, index) => {
+        const prefix = `${index === 0 ? '  └ ' : '    '}${statusSymbols[item.status]} `;
+        lines.push(...wrapPlanText(item.step, prefix, width));
+    });
+    return lines.join('\n');
+}
+export function normalizePlanItems(plan) {
+    if (!Array.isArray(plan)) {
+        return [];
+    }
+    const items = [];
+    for (const entry of plan) {
+        if (entry === null || entry === undefined) {
+            continue;
+        }
+        if (typeof entry === 'string' || typeof entry === 'number' || typeof entry === 'boolean') {
+            const step = String(entry).trim();
+            if (!step) {
+                continue;
+            }
+            items.push({ step, status: 'pending' });
+            continue;
+        }
+        if (typeof entry === 'object') {
+            const rawStep = entry.step;
+            const step = typeof rawStep === 'string'
+                ? rawStep.trim()
+                : typeof rawStep === 'number' || typeof rawStep === 'boolean'
+                    ? String(rawStep).trim()
+                    : '';
+            if (!step) {
+                continue;
+            }
+            const status = normalizeStatus(entry.status);
+            items.push({ step, status });
+        }
+    }
+    return items;
+}
+/**
+ * Wrap plan text with a prefix, preserving indentation for continuations.
+ */
+export function wrapPlanText(text, prefix, width) {
+    const normalizedWidth = clampWidth(width);
+    const cleanPrefix = prefix ?? '';
+    const prefixLength = visibleLength(cleanPrefix);
+    const available = Math.max(12, normalizedWidth - prefixLength);
+    const wrapped = wrapText(text, available);
+    if (!wrapped.length) {
+        return [cleanPrefix.trimEnd()];
+    }
+    const indent = ' '.repeat(prefixLength);
+    return wrapped.map((line, index) => (index === 0 ? `${cleanPrefix}${line}` : `${indent}${line}`));
+}
+/**
+ * Determine the available plan width using the terminal size if available.
+ */
+export function resolvePlanWidth(padding = 4) {
+    if (typeof process !== 'undefined' &&
+        typeof process.stdout?.columns === 'number' &&
+        Number.isFinite(process.stdout.columns)) {
+        return Math.max(0, process.stdout.columns - padding);
+    }
+    return undefined;
+}
+function buildStatusSymbols(overrides) {
+    return {
+        pending: overrides?.pending?.trim() || '□',
+        in_progress: overrides?.in_progress?.trim() || '◐',
+        completed: overrides?.completed?.trim() || '✔',
+    };
+}
+function normalizeStatus(status) {
+    if (typeof status !== 'string') {
+        return 'pending';
+    }
+    const normalized = status.trim().toLowerCase().replace(/[\s-]+/g, '_');
+    if (normalized === 'completed' || normalized === 'complete' || normalized === 'done') {
+        return 'completed';
+    }
+    if (normalized === 'in_progress' || normalized === 'inprogress') {
+        return 'in_progress';
+    }
+    return 'pending';
+}
+function wrapText(text, width) {
+    const normalized = (text || '').trim();
+    if (!normalized) {
+        return [];
+    }
+    const words = normalized.split(/\s+/);
+    const lines = [];
+    let current = words.shift() ?? '';
+    for (const word of words) {
+        const candidate = `${current} ${word}`;
+        if (visibleLength(candidate) > width && current) {
+            lines.push(current);
+            current = word;
+        }
+        else {
+            current = candidate;
+        }
+    }
+    if (current) {
+        lines.push(current);
+    }
+    return lines;
+}
+function clampWidth(width) {
+    if (typeof width !== 'number' || !Number.isFinite(width)) {
+        return DEFAULT_WIDTH;
+    }
+    const normalized = Math.floor(width);
+    if (normalized < MIN_WIDTH) {
+        return MIN_WIDTH;
+    }
+    if (normalized > MAX_WIDTH) {
+        return MAX_WIDTH;
+    }
+    return normalized;
+}
+function visibleLength(value) {
+    return value.replace(ANSI_REGEX, '').length;
+}
+//# sourceMappingURL=planFormatter.js.map

package/dist/utils/planFormatter.js.map

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

package/dist/workspace.d.ts

@@ -0,0 +1,8 @@
+export interface WorkspaceCaptureOptions {
+    treeDepth?: number;
+    maxEntries?: number;
+    docExcerptLimit?: number;
+}
+export declare function resolveWorkspaceCaptureOptions(env?: NodeJS.ProcessEnv): WorkspaceCaptureOptions;
+export declare function buildWorkspaceContext(root: string, options?: WorkspaceCaptureOptions): string | null;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,8BAA8B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,uBAAuB,CAM5G;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,uBAA4B,GAAG,MAAM,GAAG,IAAI,CAiDxG"}

package/dist/workspace.js

@@ -0,0 +1,107 @@
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { safeWorkspaceContext, validateWorkspaceOptions } from './workspace.validator.js';
+const PRIORITY_DOCS = ['README.md']; // Removed package.json to save context
+const IGNORED_DIRS = new Set([
+    '.git', 'node_modules', 'dist', '.erosolar', 'build', 'coverage', '.next', 'out',
+    '__pycache__', '.pytest_cache', '.mypy_cache', 'venv', '.venv', 'env',
+    'target', 'bin', 'obj', '.idea', '.vscode', '.DS_Store'
+]);
+const DEFAULT_TREE_DEPTH = 1; // Reduced from 2 to 1 for critical context savings
+const DEFAULT_MAX_ENTRIES = 30; // Further reduced from 50 to 30 - emergency reduction
+const DEFAULT_DOC_LIMIT = 200; // Further reduced from 300 to 200 - emergency reduction
+export function resolveWorkspaceCaptureOptions(env = process.env) {
+    return {
+        treeDepth: parsePositiveInt(env['EROSOLAR_CONTEXT_TREE_DEPTH']),
+        maxEntries: parsePositiveInt(env['EROSOLAR_CONTEXT_MAX_ENTRIES']),
+        docExcerptLimit: parsePositiveInt(env['EROSOLAR_CONTEXT_DOC_LIMIT']),
+    };
+}
+export function buildWorkspaceContext(root, options = {}) {
+    // CRITICAL: Validate options BEFORE building context
+    const optionsValidation = validateWorkspaceOptions(options);
+    if (!optionsValidation.valid) {
+        console.error('[Workspace Context] Invalid options:', optionsValidation.errors);
+        throw new Error(`Invalid workspace options: ${optionsValidation.errors.join(', ')}`);
+    }
+    // Log warnings if any
+    if (optionsValidation.warnings.length > 0) {
+        console.warn('[Workspace Context] Warnings:', optionsValidation.warnings);
+    }
+    const treeDepth = options.treeDepth ?? DEFAULT_TREE_DEPTH;
+    const maxEntries = options.maxEntries ?? DEFAULT_MAX_ENTRIES;
+    const docLimit = options.docExcerptLimit ?? DEFAULT_DOC_LIMIT;
+    try {
+        const treeLines = formatFileTree(root, treeDepth, maxEntries);
+        const docSnippets = capturePriorityDocs(root, docLimit);
+        // REMOVED: Rulebook duplication - rulebooks are already in system prompt
+        const sections = [`cwd: ${root}`, 'files:', ...treeLines];
+        if (docSnippets.length) {
+            sections.push(docSnippets.join('\n\n'));
+        }
+        // REMOVED: Rulebook duplication
+        // if (rulebooks.length) {
+        //   sections.push(rulebooks.join('\n\n'));
+        // }
+        const rawContent = sections.filter((section) => section.trim().length > 0).join('\n');
+        // CRITICAL: Validate and enforce limits on final output
+        const safe = safeWorkspaceContext(rawContent, {
+            truncate: true, // Auto-truncate if too large
+            throwOnError: false // Don't throw, just truncate
+        });
+        // Log stats for monitoring
+        if (process.env['DEBUG_CONTEXT']) {
+            console.log('[Workspace Context] Stats:', safe.stats);
+        }
+        return safe.content;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return `Workspace context unavailable (${message}).`;
+    }
+}
+function capturePriorityDocs(root, docLimit) {
+    return PRIORITY_DOCS.filter((name) => existsSync(join(root, name))).map((name) => {
+        try {
+            const content = readFileSync(join(root, name), 'utf8');
+            // Safety: Hard limit to prevent context explosion
+            const safeLimit = Math.min(docLimit, 300);
+            const snippet = content.length > safeLimit ? `${content.slice(0, safeLimit)}\n...` : content;
+            return `--- ${name} ---\n${snippet.trim()}`;
+        }
+        catch {
+            return `--- ${name} ---\n[Could not read file]`;
+        }
+    });
+}
+function formatFileTree(root, maxDepth, maxEntries) {
+    const lines = [];
+    const walk = (dir, depth, prefix) => {
+        if (depth > maxDepth || lines.length >= maxEntries) {
+            return;
+        }
+        const entries = readdirSync(dir, { withFileTypes: true })
+            .filter((entry) => !IGNORED_DIRS.has(entry.name))
+            .sort((a, b) => a.name.localeCompare(b.name));
+        for (const entry of entries) {
+            if (lines.length >= maxEntries) {
+                break;
+            }
+            const isDir = entry.isDirectory();
+            lines.push(`${prefix}${entry.name}${isDir ? '/' : ''}`);
+            if (isDir && depth < maxDepth) {
+                walk(join(dir, entry.name), depth + 1, `${prefix}  `);
+            }
+        }
+    };
+    walk(root, 0, '');
+    return lines;
+}
+function parsePositiveInt(raw) {
+    if (!raw) {
+        return undefined;
+    }
+    const value = Number.parseInt(raw, 10);
+    return Number.isFinite(value) && value > 0 ? value : undefined;
+}
+//# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

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

package/dist/workspace.validator.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Workspace Context Validator - Enforces strict safety limits
+ *
+ * CRITICAL: Prevents context explosion by validating all workspace context
+ * before it's sent to the LLM. Multiple safety layers ensure we never
+ * exceed token limits.
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    stats: ContextStats;
+}
+export interface ContextStats {
+    totalChars: number;
+    totalLines: number;
+    estimatedTokens: number;
+    fileEntries: number;
+    docChars: number;
+}
+export interface WorkspaceContextSafe {
+    content: string;
+    stats: ContextStats;
+}
+/**
+ * Validate workspace context options BEFORE building context
+ */
+export declare function validateWorkspaceOptions(options: {
+    treeDepth?: number;
+    maxEntries?: number;
+    docExcerptLimit?: number;
+}): ValidationResult;
+/**
+ * Validate workspace context AFTER building - CRITICAL SAFETY CHECK
+ * This is the final line of defense against context explosion
+ */
+export declare function validateWorkspaceContext(content: string): ValidationResult;
+/**
+ * Safe truncation - if content exceeds limits, truncate intelligently
+ */
+export declare function truncateWorkspaceContext(content: string): WorkspaceContextSafe;
+/**
+ * Validate and enforce limits in a single call - RECOMMENDED USAGE
+ */
+export declare function safeWorkspaceContext(content: string | null, options?: {
+    truncate?: boolean;
+    throwOnError?: boolean;
+}): WorkspaceContextSafe;
+//# sourceMappingURL=workspace.validator.d.ts.map

package/dist/workspace.validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.validator.d.ts","sourceRoot":"","sources":["../src/workspace.validator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,YAAY,CAAC;CACrB;AASD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,gBAAgB,CAuDnB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAuE1E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CA2C9E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GACvD,oBAAoB,CAiDtB"}

package/dist/workspace.validator.js

@@ -0,0 +1,214 @@
+/**
+ * Workspace Context Validator - Enforces strict safety limits
+ *
+ * CRITICAL: Prevents context explosion by validating all workspace context
+ * before it's sent to the LLM. Multiple safety layers ensure we never
+ * exceed token limits.
+ */
+import { ContextOverflowError, ResourceLimitError } from './core/errors/errorTypes.js';
+// ABSOLUTE MAXIMUM LIMITS - Never exceed these under any circumstances
+const ABSOLUTE_MAX_CHARS = 5000; // ~1,250 tokens (4 chars per token)
+const ABSOLUTE_MAX_LINES = 100; // Maximum lines in any context
+const ABSOLUTE_MAX_FILE_ENTRIES = 50; // Maximum files in tree
+const ABSOLUTE_MAX_DOC_CHARS = 300; // Maximum chars per priority doc
+const WARNING_THRESHOLD = 0.7; // Warn at 70% of max
+/**
+ * Estimate token count (rough: 1 token ≈ 4 characters)
+ */
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Validate workspace context options BEFORE building context
+ */
+export function validateWorkspaceOptions(options) {
+    const errors = [];
+    const warnings = [];
+    // Validate tree depth
+    if (options.treeDepth !== undefined) {
+        if (options.treeDepth < 0) {
+            errors.push('treeDepth cannot be negative');
+        }
+        if (options.treeDepth > 2) {
+            errors.push(`treeDepth ${options.treeDepth} exceeds maximum of 2`);
+        }
+        if (options.treeDepth > 1) {
+            warnings.push('treeDepth > 1 can significantly increase context size');
+        }
+    }
+    // Validate max entries
+    if (options.maxEntries !== undefined) {
+        if (options.maxEntries < 0) {
+            errors.push('maxEntries cannot be negative');
+        }
+        if (options.maxEntries > ABSOLUTE_MAX_FILE_ENTRIES) {
+            errors.push(`maxEntries ${options.maxEntries} exceeds maximum of ${ABSOLUTE_MAX_FILE_ENTRIES}`);
+        }
+        if (options.maxEntries > 40) {
+            warnings.push('maxEntries > 40 may use significant context');
+        }
+    }
+    // Validate doc excerpt limit
+    if (options.docExcerptLimit !== undefined) {
+        if (options.docExcerptLimit < 0) {
+            errors.push('docExcerptLimit cannot be negative');
+        }
+        if (options.docExcerptLimit > ABSOLUTE_MAX_DOC_CHARS) {
+            errors.push(`docExcerptLimit ${options.docExcerptLimit} exceeds maximum of ${ABSOLUTE_MAX_DOC_CHARS}`);
+        }
+        if (options.docExcerptLimit > 250) {
+            warnings.push('docExcerptLimit > 250 may use significant context');
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        stats: {
+            totalChars: 0,
+            totalLines: 0,
+            estimatedTokens: 0,
+            fileEntries: options.maxEntries ?? 0,
+            docChars: options.docExcerptLimit ?? 0,
+        },
+    };
+}
+/**
+ * Validate workspace context AFTER building - CRITICAL SAFETY CHECK
+ * This is the final line of defense against context explosion
+ */
+export function validateWorkspaceContext(content) {
+    const errors = [];
+    const warnings = [];
+    // Count basic metrics
+    const totalChars = content.length;
+    const lines = content.split('\n');
+    const totalLines = lines.length;
+    const estimatedTokens = estimateTokens(content);
+    // Count file entries (lines that look like file paths)
+    const fileEntries = lines.filter(line => line.trim() && !line.startsWith('---') && !line.startsWith('cwd:')).length;
+    // Count chars in priority docs section
+    const docMatch = content.match(/--- .* ---[\s\S]*?(?=\n\n|$)/g);
+    const docChars = docMatch ? docMatch.join('').length : 0;
+    const stats = {
+        totalChars,
+        totalLines,
+        estimatedTokens,
+        fileEntries,
+        docChars,
+    };
+    // CRITICAL: Check absolute maximum character limit
+    if (totalChars > ABSOLUTE_MAX_CHARS) {
+        const error = new ContextOverflowError(totalChars, ABSOLUTE_MAX_CHARS, 'chars', true);
+        errors.push(`Context exceeds ABSOLUTE maximum: ${error.message}`);
+    }
+    // CRITICAL: Check absolute maximum line limit
+    if (totalLines > ABSOLUTE_MAX_LINES) {
+        const error = new ContextOverflowError(totalLines, ABSOLUTE_MAX_LINES, 'lines', true);
+        errors.push(`Context exceeds ABSOLUTE maximum: ${error.message}`);
+    }
+    // CRITICAL: Check absolute maximum file entries
+    if (fileEntries > ABSOLUTE_MAX_FILE_ENTRIES) {
+        const error = new ResourceLimitError('file entries', fileEntries, ABSOLUTE_MAX_FILE_ENTRIES, false);
+        errors.push(`Context exceeds ABSOLUTE maximum: ${error.message}`);
+    }
+    // WARNING: Approaching limits
+    if (totalChars > ABSOLUTE_MAX_CHARS * WARNING_THRESHOLD) {
+        warnings.push(`Context size ${totalChars} chars is ${Math.round(totalChars / ABSOLUTE_MAX_CHARS * 100)}% of maximum. ` +
+            `Consider reducing treeDepth, maxEntries, or docExcerptLimit.`);
+    }
+    if (estimatedTokens > 1000) {
+        warnings.push(`Estimated ${estimatedTokens} tokens in workspace context. This is high and may impact performance.`);
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        stats,
+    };
+}
+/**
+ * Safe truncation - if content exceeds limits, truncate intelligently
+ */
+export function truncateWorkspaceContext(content) {
+    const validation = validateWorkspaceContext(content);
+    // If valid, return as-is
+    if (validation.valid) {
+        return {
+            content,
+            stats: validation.stats,
+        };
+    }
+    // CRITICAL: Content exceeds limits, must truncate
+    const lines = content.split('\n');
+    const truncatedLines = [];
+    let charCount = 0;
+    // Keep up to absolute maximums
+    for (const line of lines) {
+        if (truncatedLines.length >= ABSOLUTE_MAX_LINES) {
+            break;
+        }
+        if (charCount + line.length > ABSOLUTE_MAX_CHARS) {
+            break;
+        }
+        truncatedLines.push(line);
+        charCount += line.length + 1; // +1 for newline
+    }
+    // Add truncation notice
+    if (truncatedLines.length < lines.length) {
+        truncatedLines.push('');
+        truncatedLines.push('[Workspace context truncated to prevent context overflow]');
+        truncatedLines.push(`[Showing ${truncatedLines.length} of ${lines.length} lines]`);
+    }
+    const truncatedContent = truncatedLines.join('\n');
+    const stats = validateWorkspaceContext(truncatedContent).stats;
+    return {
+        content: truncatedContent,
+        stats,
+    };
+}
+/**
+ * Validate and enforce limits in a single call - RECOMMENDED USAGE
+ */
+export function safeWorkspaceContext(content, options) {
+    const { truncate = true, throwOnError = false } = options ?? {};
+    if (!content) {
+        return {
+            content: '',
+            stats: {
+                totalChars: 0,
+                totalLines: 0,
+                estimatedTokens: 0,
+                fileEntries: 0,
+                docChars: 0,
+            },
+        };
+    }
+    const validation = validateWorkspaceContext(content);
+    // Log warnings to console
+    if (validation.warnings.length > 0) {
+        console.warn('[Workspace Context Validator] Warnings:');
+        for (const warning of validation.warnings) {
+            console.warn(`  - ${warning}`);
+        }
+    }
+    // Handle errors
+    if (!validation.valid) {
+        console.error('[Workspace Context Validator] CRITICAL ERRORS:');
+        for (const error of validation.errors) {
+            console.error(`  - ${error}`);
+        }
+        if (throwOnError) {
+            throw new Error(`Workspace context validation failed:\n${validation.errors.join('\n')}`);
+        }
+        if (truncate) {
+            console.warn('[Workspace Context Validator] Auto-truncating to safe limits...');
+            return truncateWorkspaceContext(content);
+        }
+    }
+    return {
+        content,
+        stats: validation.stats,
+    };
+}
+//# sourceMappingURL=workspace.validator.js.map