erosolar-cli 1.7.195 → 1.7.196

package/dist/core/sessionStore.js

@@ -0,0 +1,188 @@
+import { randomUUID } from 'node:crypto';
+import { mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const dataRoot = process.env['EROSOLAR_DATA_DIR']?.trim() || join(homedir(), '.erosolar');
+const sessionsDir = join(dataRoot, 'sessions');
+const indexPath = join(sessionsDir, 'index.json');
+export function listSessions(profile) {
+    const index = readIndex();
+    const entries = Object.values(index.entries);
+    const filtered = profile ? entries.filter((entry) => entry.profile === profile) : entries;
+    return filtered.sort((a, b) => {
+        const aTime = Date.parse(a.updatedAt ?? '') || 0;
+        const bTime = Date.parse(b.updatedAt ?? '') || 0;
+        return bTime - aTime;
+    });
+}
+export function saveSessionSnapshot(options) {
+    ensureDirectory();
+    if (!Array.isArray(options.messages)) {
+        throw new Error('Session snapshots must include the entire message history array.');
+    }
+    const index = readIndex();
+    const now = new Date().toISOString();
+    const existingId = options.id ?? null;
+    const summaryId = existingId && index.entries[existingId] ? existingId : randomUUID();
+    const previous = index.entries[summaryId];
+    const summary = {
+        id: summaryId,
+        title: sanitizeTitle(options.title) ?? previous?.title ?? buildDefaultTitle(options.messages),
+        profile: options.profile,
+        provider: options.provider,
+        model: options.model,
+        workspaceRoot: options.workspaceRoot ?? previous?.workspaceRoot ?? undefined,
+        createdAt: previous?.createdAt ?? now,
+        updatedAt: now,
+        messageCount: options.messages.length,
+    };
+    const payload = {
+        ...summary,
+        messages: options.messages,
+    };
+    writeFileSync(getSessionPath(summaryId), JSON.stringify(payload, null, 2), 'utf8');
+    index.entries[summaryId] = summary;
+    writeIndex(index);
+    return summary;
+}
+export function loadSessionById(id) {
+    if (!id) {
+        return null;
+    }
+    try {
+        const raw = readFileSync(getSessionPath(id), 'utf8');
+        const parsed = JSON.parse(raw);
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+export function deleteSession(id) {
+    if (!id) {
+        return false;
+    }
+    const index = readIndex();
+    if (!index.entries[id]) {
+        return false;
+    }
+    try {
+        rmSync(getSessionPath(id), { force: true });
+    }
+    catch {
+        // ignore
+    }
+    delete index.entries[id];
+    writeIndex(index);
+    return true;
+}
+export function saveAutosaveSnapshot(profile, options) {
+    ensureDirectory();
+    const payload = {
+        id: `autosave-${profile}`,
+        profile,
+        provider: options.provider,
+        model: options.model,
+        workspaceRoot: options.workspaceRoot ?? undefined,
+        createdAt: new Date().toISOString(),
+        updatedAt: new Date().toISOString(),
+        title: sanitizeTitle(options.title) ?? buildDefaultTitle(options.messages),
+        messageCount: options.messages.length,
+        messages: options.messages,
+    };
+    writeFileSync(getAutosavePath(profile), JSON.stringify(payload, null, 2), 'utf8');
+}
+export function loadAutosaveSnapshot(profile) {
+    try {
+        const raw = readFileSync(getAutosavePath(profile), 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export function clearAutosaveSnapshot(profile) {
+    try {
+        rmSync(getAutosavePath(profile), { force: true });
+    }
+    catch {
+        // ignore
+    }
+}
+function readIndex() {
+    ensureDirectory();
+    try {
+        const raw = readFileSync(indexPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object' || typeof parsed.entries !== 'object') {
+            return { entries: {} };
+        }
+        return { entries: { ...parsed.entries } };
+    }
+    catch {
+        return { entries: {} };
+    }
+}
+function writeIndex(index) {
+    ensureDirectory();
+    writeFileSync(indexPath, JSON.stringify(index, null, 2), 'utf8');
+}
+function ensureDirectory() {
+    mkdirSync(sessionsDir, { recursive: true });
+}
+function getSessionPath(id) {
+    return join(sessionsDir, `${id}.json`);
+}
+function getAutosavePath(profile) {
+    return join(sessionsDir, `${profile}-autosave.json`);
+}
+function sanitizeTitle(value) {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const trimmed = value.trim();
+    if (!trimmed) {
+        return null;
+    }
+    return trimmed.slice(0, 160);
+}
+function buildDefaultTitle(messages) {
+    for (const message of messages) {
+        if (message.role !== 'user') {
+            continue;
+        }
+        const condensed = message.content.trim().replace(/\s+/g, ' ');
+        if (condensed) {
+            return condensed.slice(0, 160);
+        }
+    }
+    return `Session ${new Date().toLocaleString()}`;
+}
+function pruneOrphans() {
+    try {
+        ensureDirectory();
+        const index = readIndex();
+        const known = new Set(Object.keys(index.entries));
+        for (const file of readdirSync(sessionsDir)) {
+            if (!file.endsWith('.json')) {
+                continue;
+            }
+            if (file === 'index.json' || file.includes('-autosave')) {
+                continue;
+            }
+            const id = file.slice(0, -5);
+            if (!known.has(id)) {
+                const candidate = join(sessionsDir, file);
+                const stats = statSync(candidate);
+                if (stats.isFile()) {
+                    rmSync(candidate, { force: true });
+                }
+            }
+        }
+    }
+    catch {
+        // best-effort cleanup
+    }
+}
+pruneOrphans();
+//# sourceMappingURL=sessionStore.js.map

package/dist/core/sessionStore.js.map

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

package/dist/core/testUtils.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Comprehensive test utilities for tool validation and AI flow testing
+ * Provides type-safe testing patterns for erosolar-cli software engineering
+ */
+import type { ToolCallRequest, ToolResponse, JSONSchemaObject, Result, ToolSuccessResponse, ToolErrorResponse, ToolWarningResponse } from './types.js';
+import { validateToolPreconditions, validateAIFlowPatterns } from './toolPreconditions.js';
+/**
+ * Test utilities for tool validation and AI flow testing
+ */
+export declare namespace ToolTestUtils {
+    /**
+     * Creates a mock tool call for testing
+     */
+    function createMockToolCall(name: string, args?: Record<string, unknown>): ToolCallRequest;
+    /**
+     * Creates a mock successful tool response
+     */
+    function createMockSuccessResponse(content: string, metadata?: ToolSuccessResponse['metadata']): ToolSuccessResponse;
+    /**
+     * Creates a mock error tool response
+     */
+    function createMockErrorResponse(code: string, message: string, recoverable?: boolean): ToolErrorResponse;
+    /**
+     * Creates a mock warning tool response
+     */
+    function createMockWarningResponse(content: string, warnings: ToolWarningResponse['warnings']): ToolWarningResponse;
+    /**
+     * Validates tool arguments against schema with detailed error reporting
+     */
+    function validateToolArgs(toolName: string, schema: JSONSchemaObject | undefined, args: Record<string, unknown>): Result<void, string[]>;
+    /**
+     * Tests AI flow patterns with tool history simulation
+     */
+    function testAIFlowPatterns(toolName: string, args: Record<string, unknown>, toolHistory: Array<{
+        toolName: string;
+        args: Record<string, unknown>;
+        timestamp: number;
+    }>): {
+        preflightWarnings: ReturnType<typeof validateToolPreconditions>;
+        aiFlowWarnings: ReturnType<typeof validateAIFlowPatterns>;
+    };
+    /**
+     * Type-safe assertion for tool responses
+     */
+    function assertToolSuccess(response: ToolResponse): asserts response is ToolSuccessResponse;
+    /**
+     * Type-safe assertion for tool errors
+     */
+    function assertToolError(response: ToolResponse): asserts response is ToolErrorResponse;
+    /**
+     * Type-safe assertion for tool warnings
+     */
+    function assertToolWarning(response: ToolResponse): asserts response is ToolWarningResponse;
+    /**
+     * Creates a test suite for tool validation
+     */
+    function createToolTestSuite(toolName: string, schema: JSONSchemaObject | undefined): {
+        /**
+         * Test valid arguments
+         */
+        testValidArgs(args: Record<string, unknown>): void;
+        /**
+         * Test invalid arguments
+         */
+        testInvalidArgs(args: Record<string, unknown>, expectedErrors: string[]): void;
+        /**
+         * Test required arguments
+         */
+        testRequiredArgs(requiredArgs: string[]): void;
+    };
+    /**
+     * Performance testing utilities
+     */
+    namespace Performance {
+        /**
+         * Measures tool execution time
+         */
+        function measureExecutionTime<T>(fn: () => Promise<T> | T): Promise<{
+            result: T;
+            executionTime: number;
+        }>;
+        /**
+         * Runs performance benchmark
+         */
+        function benchmark(fn: () => Promise<unknown> | unknown, iterations?: number): Promise<{
+            averageTime: number;
+            minTime: number;
+            maxTime: number;
+            totalTime: number;
+        }>;
+    }
+    /**
+     * AI flow testing utilities
+     */
+    namespace AIFlow {
+        /**
+         * Simulates a complete AI flow with tool history
+         */
+        function simulateAIFlow(flow: Array<{
+            toolName: string;
+            args: Record<string, unknown>;
+        }>): Array<{
+            toolName: string;
+            args: Record<string, unknown>;
+            warnings: ReturnType<typeof validateAIFlowPatterns>;
+        }>;
+        /**
+         * Tests for common AI flow anti-patterns
+         */
+        function detectAntiPatterns(flow: Array<{
+            toolName: string;
+            args: Record<string, unknown>;
+        }>): {
+            sequentialReads: boolean;
+            editWithoutRead: boolean;
+            multipleValidations: boolean;
+            inefficientGitOps: boolean;
+        };
+    }
+}
+//# sourceMappingURL=testUtils.d.ts.map

package/dist/core/testUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testUtils.d.ts","sourceRoot":"","sources":["../../src/core/testUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,MAAM,EACN,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAE3F;;GAEG;AACH,yBAAiB,aAAa,CAAC;IAC7B;;OAEG;IACH,SAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,eAAe,CAMjB;IAED;;OAEG;IACH,SAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,mBAAmB,CAAC,UAAU,CAAC,GACzC,mBAAmB,CAUrB;IAED;;OAEG;IACH,SAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,WAAW,UAAQ,GAClB,iBAAiB,CAUnB;IAED;;OAEG;IACH,SAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,mBAAmB,CAAC,UAAU,CAAC,GACxC,mBAAmB,CAMrB;IAED;;OAEG;IACH,SAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,gBAAgB,GAAG,SAAS,EACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAUxB;IAED;;OAEG;IACH,SAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,GACzF;QACD,iBAAiB,EAAE,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;QAChE,cAAc,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;KAC3D,CAKA;IAED;;OAEG;IACH,SAAgB,iBAAiB,CAC/B,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,QAAQ,IAAI,mBAAmB,CAIzC;IAED;;OAEG;IACH,SAAgB,eAAe,CAC7B,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,QAAQ,IAAI,iBAAiB,CAIvC;IAED;;OAEG;IACH,SAAgB,iBAAiB,CAC/B,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,QAAQ,IAAI,mBAAmB,CAIzC;IAED;;OAEG;IACH,SAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,gBAAgB,GAAG,SAAS;QAGlC;;WAEG;4BACiB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;QAOlD;;WAEG;8BACmB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,kBAAkB,MAAM,EAAE,GAAG,IAAI;QAe9E;;WAEG;uCAC4B,MAAM,EAAE,GAAG,IAAI;MASjD;IAED;;OAEG;IACH,UAAiB,WAAW,CAAC;QAC3B;;WAEG;QACH,SAAsB,oBAAoB,CAAC,CAAC,EAC1C,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GACvB,OAAO,CAAC;YAAE,MAAM,EAAE,CAAC,CAAC;YAAC,aAAa,EAAE,MAAM,CAAA;SAAE,CAAC,CAK/C;QAED;;WAEG;QACH,SAAsB,SAAS,CAC7B,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,EACpC,UAAU,SAAM,GACf,OAAO,CAAC;YACT,WAAW,EAAE,MAAM,CAAC;YACpB,OAAO,EAAE,MAAM,CAAC;YAChB,OAAO,EAAE,MAAM,CAAC;YAChB,SAAS,EAAE,MAAM,CAAC;SACnB,CAAC,CAgBD;KACF;IAED;;OAEG;IACH,UAAiB,MAAM,CAAC;QACtB;;WAEG;QACH,SAAgB,cAAc,CAC5B,IAAI,EAAE,KAAK,CAAC;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,CAAC,GAC/D,KAAK,CAAC;YACP,QAAQ,EAAE,MAAM,CAAC;YACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC9B,QAAQ,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;SACrD,CAAC,CAsBD;QAED;;WAEG;QACH,SAAgB,kBAAkB,CAChC,IAAI,EAAE,KAAK,CAAC;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,CAAC,GAC/D;YACD,eAAe,EAAE,OAAO,CAAC;YACzB,eAAe,EAAE,OAAO,CAAC;YACzB,mBAAmB,EAAE,OAAO,CAAC;YAC7B,iBAAiB,EAAE,OAAO,CAAC;SAC5B,CAiBA;KACF;CACF"}

package/dist/core/testUtils.js

@@ -0,0 +1,235 @@
+/**
+ * Comprehensive test utilities for tool validation and AI flow testing
+ * Provides type-safe testing patterns for erosolar-cli software engineering
+ */
+import { validateToolArguments, ToolArgumentValidationError } from './schemaValidator.js';
+import { validateToolPreconditions, validateAIFlowPatterns } from './toolPreconditions.js';
+/**
+ * Test utilities for tool validation and AI flow testing
+ */
+export var ToolTestUtils;
+(function (ToolTestUtils) {
+    /**
+     * Creates a mock tool call for testing
+     */
+    function createMockToolCall(name, args = {}) {
+        return {
+            id: `test-${Date.now()}-${Math.random().toString(36).substring(2)}`,
+            name,
+            arguments: args
+        };
+    }
+    ToolTestUtils.createMockToolCall = createMockToolCall;
+    /**
+     * Creates a mock successful tool response
+     */
+    function createMockSuccessResponse(content, metadata) {
+        return {
+            type: 'success',
+            content,
+            metadata: {
+                timestamp: Date.now(),
+                toolName: 'test-tool',
+                ...metadata
+            }
+        };
+    }
+    ToolTestUtils.createMockSuccessResponse = createMockSuccessResponse;
+    /**
+     * Creates a mock error tool response
+     */
+    function createMockErrorResponse(code, message, recoverable = false) {
+        return {
+            type: 'error',
+            error: {
+                code,
+                message,
+                recoverable,
+                toolName: 'test-tool'
+            }
+        };
+    }
+    ToolTestUtils.createMockErrorResponse = createMockErrorResponse;
+    /**
+     * Creates a mock warning tool response
+     */
+    function createMockWarningResponse(content, warnings) {
+        return {
+            type: 'warning',
+            content,
+            warnings
+        };
+    }
+    ToolTestUtils.createMockWarningResponse = createMockWarningResponse;
+    /**
+     * Validates tool arguments against schema with detailed error reporting
+     */
+    function validateToolArgs(toolName, schema, args) {
+        try {
+            validateToolArguments(toolName, schema, args);
+            return { ok: true, value: undefined };
+        }
+        catch (error) {
+            if (error instanceof ToolArgumentValidationError) {
+                return { ok: false, error: [...error.issues] };
+            }
+            return { ok: false, error: [String(error)] };
+        }
+    }
+    ToolTestUtils.validateToolArgs = validateToolArgs;
+    /**
+     * Tests AI flow patterns with tool history simulation
+     */
+    function testAIFlowPatterns(toolName, args, toolHistory) {
+        return {
+            preflightWarnings: validateToolPreconditions(toolName, args),
+            aiFlowWarnings: validateAIFlowPatterns(toolName, args, toolHistory)
+        };
+    }
+    ToolTestUtils.testAIFlowPatterns = testAIFlowPatterns;
+    /**
+     * Type-safe assertion for tool responses
+     */
+    function assertToolSuccess(response) {
+        if (response.type !== 'success') {
+            throw new Error(`Expected success response, got ${response.type}`);
+        }
+    }
+    ToolTestUtils.assertToolSuccess = assertToolSuccess;
+    /**
+     * Type-safe assertion for tool errors
+     */
+    function assertToolError(response) {
+        if (response.type !== 'error') {
+            throw new Error(`Expected error response, got ${response.type}`);
+        }
+    }
+    ToolTestUtils.assertToolError = assertToolError;
+    /**
+     * Type-safe assertion for tool warnings
+     */
+    function assertToolWarning(response) {
+        if (response.type !== 'warning') {
+            throw new Error(`Expected warning response, got ${response.type}`);
+        }
+    }
+    ToolTestUtils.assertToolWarning = assertToolWarning;
+    /**
+     * Creates a test suite for tool validation
+     */
+    function createToolTestSuite(toolName, schema) {
+        return {
+            /**
+             * Test valid arguments
+             */
+            testValidArgs(args) {
+                const result = validateToolArgs(toolName, schema, args);
+                if (!result.ok) {
+                    throw new Error(`Expected valid arguments: ${result.error.join(', ')}`);
+                }
+            },
+            /**
+             * Test invalid arguments
+             */
+            testInvalidArgs(args, expectedErrors) {
+                const result = validateToolArgs(toolName, schema, args);
+                if (result.ok) {
+                    throw new Error('Expected invalid arguments');
+                }
+                const missingErrors = expectedErrors.filter(expected => !result.error.some(actual => actual.includes(expected)));
+                if (missingErrors.length > 0) {
+                    throw new Error(`Missing expected errors: ${missingErrors.join(', ')}`);
+                }
+            },
+            /**
+             * Test required arguments
+             */
+            testRequiredArgs(requiredArgs) {
+                for (const arg of requiredArgs) {
+                    const result = validateToolArgs(toolName, schema, {});
+                    if (result.ok || !result.error.some(e => e.includes(arg))) {
+                        throw new Error(`Expected missing required argument: ${arg}`);
+                    }
+                }
+            }
+        };
+    }
+    ToolTestUtils.createToolTestSuite = createToolTestSuite;
+    /**
+     * Performance testing utilities
+     */
+    let Performance;
+    (function (Performance) {
+        /**
+         * Measures tool execution time
+         */
+        async function measureExecutionTime(fn) {
+            const start = performance.now();
+            const result = await fn();
+            const executionTime = performance.now() - start;
+            return { result, executionTime };
+        }
+        Performance.measureExecutionTime = measureExecutionTime;
+        /**
+         * Runs performance benchmark
+         */
+        async function benchmark(fn, iterations = 100) {
+            const times = [];
+            for (let i = 0; i < iterations; i++) {
+                const start = performance.now();
+                await fn();
+                const end = performance.now();
+                times.push(end - start);
+            }
+            const totalTime = times.reduce((sum, time) => sum + time, 0);
+            const averageTime = totalTime / iterations;
+            const minTime = Math.min(...times);
+            const maxTime = Math.max(...times);
+            return { averageTime, minTime, maxTime, totalTime };
+        }
+        Performance.benchmark = benchmark;
+    })(Performance = ToolTestUtils.Performance || (ToolTestUtils.Performance = {}));
+    /**
+     * AI flow testing utilities
+     */
+    let AIFlow;
+    (function (AIFlow) {
+        /**
+         * Simulates a complete AI flow with tool history
+         */
+        function simulateAIFlow(flow) {
+            const toolHistory = [];
+            const results = [];
+            for (const step of flow) {
+                const warnings = validateAIFlowPatterns(step.toolName, step.args, toolHistory);
+                results.push({
+                    toolName: step.toolName,
+                    args: step.args,
+                    warnings
+                });
+                // Add to history for next iteration
+                toolHistory.push({
+                    toolName: step.toolName,
+                    args: step.args,
+                    timestamp: Date.now()
+                });
+            }
+            return results;
+        }
+        AIFlow.simulateAIFlow = simulateAIFlow;
+        /**
+         * Tests for common AI flow anti-patterns
+         */
+        function detectAntiPatterns(flow) {
+            const toolNames = flow.map(step => step.toolName);
+            return {
+                sequentialReads: toolNames.filter(name => name.includes('read') || name.includes('Read')).length > 1,
+                editWithoutRead: toolNames.includes('Edit') && !toolNames.some(name => name.includes('read') || name.includes('Read')),
+                multipleValidations: toolNames.filter(name => name.includes('test') || name.includes('validate') || name.includes('check')).length > 1,
+                inefficientGitOps: toolNames.filter(name => name.includes('git') || name.includes('Git')).length > 2
+            };
+        }
+        AIFlow.detectAntiPatterns = detectAntiPatterns;
+    })(AIFlow = ToolTestUtils.AIFlow || (ToolTestUtils.AIFlow = {}));
+})(ToolTestUtils || (ToolTestUtils = {}));
+//# sourceMappingURL=testUtils.js.map

package/dist/core/testUtils.js.map

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

package/dist/core/toolPreconditions.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Pre-flight validation patterns for AI flow design.
+ * Catches common tool usage failures before execution and provides actionable guidance.
+ */
+export interface PreflightWarning {
+    readonly code: string;
+    readonly message: string;
+    readonly severity: 'critical' | 'warning' | 'info';
+    readonly suggestion: string;
+}
+export declare const AI_FLOW_VALIDATION_PATTERNS: {
+    readonly EDIT_LONG_SINGLE_LINE: RegExp;
+    readonly EDIT_PLACEHOLDER_PATTERNS: readonly [RegExp, RegExp, RegExp, RegExp];
+    readonly EDIT_FUNCTION_SIGNATURE: RegExp;
+    readonly SEARCH_OVERLY_BROAD: readonly [RegExp, RegExp, RegExp, RegExp];
+    readonly GIT_REDUNDANT_STATUS: RegExp;
+    readonly GIT_INEFFICIENT_CHAIN: RegExp;
+    readonly NPM_INCOMPLETE_PUBLISH: RegExp;
+    readonly CONTEXT_REDUNDANT_SNAPSHOT: RegExp;
+    readonly VALIDATION_EARLY_RUN: RegExp;
+};
+/**
+ * Validate tool preconditions before execution to prevent common AI flow failures.
+ *
+ * This function implements the critical AI flow design principle: validate before execute.
+ * It catches common patterns that lead to tool failures and provides actionable guidance.
+ *
+ * @param toolName - Name of the tool being called
+ * @param args - Tool arguments
+ * @returns Array of pre-flight warnings (empty if all validations pass)
+ */
+export declare function validateToolPreconditions(toolName: string, args: Record<string, unknown>): PreflightWarning[];
+/**
+ * Enhanced AI flow validation for TypeScript software engineering
+ * Provides comprehensive validation of AI tool usage patterns
+ */
+export declare function validateAIFlowPatterns(toolName: string, args: Record<string, unknown>, toolHistory: readonly {
+    toolName: string;
+    args: Record<string, unknown>;
+}[]): PreflightWarning[];
+//# sourceMappingURL=toolPreconditions.d.ts.map

package/dist/core/toolPreconditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolPreconditions.d.ts","sourceRoot":"","sources":["../../src/core/toolPreconditions.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAGD,eAAO,MAAM,2BAA2B;;;;;;;;;;CA+B9B,CAAC;AAEX;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,gBAAgB,EAAE,CAsKpB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,EAAE,SAAS;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,EAAE,GAC1E,gBAAgB,EAAE,CAsGpB"}