erosolar-cli 1.7.333 → 1.7.334

package/dist/core/hooksSystem.js

@@ -0,0 +1,273 @@
+/**
+ * Hooks System - Event-driven automation for tool execution
+ *
+ * Implements a Claude Code-style hooks system that runs shell commands
+ * in response to tool execution events:
+ *
+ * - beforeToolExecution: Runs before any tool starts
+ * - afterToolExecution: Runs after any tool completes
+ * - beforeFileEdit: Runs before a file is modified
+ * - afterFileEdit: Runs after a file is modified
+ * - beforeBashCommand: Runs before a bash command executes
+ * - afterBashCommand: Runs after a bash command completes
+ *
+ * Hooks are configured in EROSOLAR.md or settings.json
+ */
+import { exec } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { promisify } from 'node:util';
+const execAsync = promisify(exec);
+const DEFAULT_HOOK_TIMEOUT = 30000; // 30 seconds
+/**
+ * Load hooks from EROSOLAR.md or settings.json
+ */
+export function loadHooks(workingDir) {
+    const configs = loadHooksConfigs(workingDir);
+    return configs.flatMap((c) => c.hooks);
+}
+function loadHooksConfigs(workingDir) {
+    const configs = [];
+    // 1. User-level hooks from ~/.erosolar/hooks.json
+    const userHooksPath = join(homedir(), '.erosolar', 'hooks.json');
+    if (existsSync(userHooksPath)) {
+        const hooks = tryLoadHooksJson(userHooksPath);
+        if (hooks.length > 0) {
+            configs.push({ hooks, source: userHooksPath });
+        }
+    }
+    // 2. Project-level hooks from .erosolar/hooks.json
+    const projectHooksPath = join(workingDir, '.erosolar', 'hooks.json');
+    if (existsSync(projectHooksPath)) {
+        const hooks = tryLoadHooksJson(projectHooksPath);
+        if (hooks.length > 0) {
+            configs.push({ hooks, source: projectHooksPath });
+        }
+    }
+    // 3. Parse hooks from EROSOLAR.md YAML frontmatter
+    const memoryPaths = [
+        join(workingDir, 'EROSOLAR.md'),
+        join(workingDir, '.erosolar', 'EROSOLAR.md'),
+    ];
+    for (const memoryPath of memoryPaths) {
+        if (existsSync(memoryPath)) {
+            const hooks = tryParseHooksFromMarkdown(memoryPath);
+            if (hooks.length > 0) {
+                configs.push({ hooks, source: memoryPath });
+            }
+        }
+    }
+    return configs;
+}
+function tryLoadHooksJson(filePath) {
+    try {
+        const content = readFileSync(filePath, 'utf-8');
+        const parsed = JSON.parse(content);
+        if (Array.isArray(parsed)) {
+            return parsed.filter(isValidHook);
+        }
+        if (parsed.hooks && Array.isArray(parsed.hooks)) {
+            return parsed.hooks.filter(isValidHook);
+        }
+        return [];
+    }
+    catch {
+        return [];
+    }
+}
+function tryParseHooksFromMarkdown(filePath) {
+    try {
+        const content = readFileSync(filePath, 'utf-8');
+        // Look for hooks in YAML-like format within the markdown
+        const hooksMatch = content.match(/```(?:yaml|yml)?\nhooks:\s*\n([\s\S]*?)```/);
+        if (!hooksMatch) {
+            return [];
+        }
+        // Simple YAML-like parsing for hooks
+        const hooksYaml = hooksMatch[1] ?? '';
+        const hooks = [];
+        let currentHook = null;
+        let inThenBlock = false;
+        const thenCommands = [];
+        for (const line of hooksYaml.split('\n')) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith('- when:')) {
+                // Save previous hook
+                if (currentHook && currentHook.when) {
+                    if (thenCommands.length > 0) {
+                        currentHook.then = [...thenCommands];
+                    }
+                    if (currentHook.then && currentHook.then.length > 0) {
+                        hooks.push(currentHook);
+                    }
+                }
+                // Start new hook
+                const whenValue = trimmed.replace('- when:', '').trim().replace(/['"]/g, '');
+                currentHook = { when: whenValue };
+                thenCommands.length = 0;
+                inThenBlock = false;
+            }
+            else if (trimmed.startsWith('if:') && currentHook) {
+                currentHook.if = trimmed.replace('if:', '').trim().replace(/['"]/g, '');
+            }
+            else if (trimmed.startsWith('then:')) {
+                inThenBlock = true;
+            }
+            else if (inThenBlock && trimmed.startsWith('- ')) {
+                const cmd = trimmed.slice(2).replace(/['"]/g, '');
+                thenCommands.push(cmd);
+            }
+            else if (trimmed.startsWith('timeout:') && currentHook) {
+                const timeout = parseInt(trimmed.replace('timeout:', '').trim(), 10);
+                if (!isNaN(timeout)) {
+                    currentHook.timeout = timeout;
+                }
+            }
+        }
+        // Save last hook
+        if (currentHook && currentHook.when) {
+            if (thenCommands.length > 0) {
+                currentHook.then = [...thenCommands];
+            }
+            if (currentHook.then && currentHook.then.length > 0) {
+                hooks.push(currentHook);
+            }
+        }
+        return hooks;
+    }
+    catch {
+        return [];
+    }
+}
+function isValidHook(hook) {
+    if (!hook || typeof hook !== 'object') {
+        return false;
+    }
+    const h = hook;
+    const when = h['when'];
+    const then = h['then'];
+    return (typeof when === 'string' &&
+        Array.isArray(then) &&
+        then.length > 0 &&
+        then.every((cmd) => typeof cmd === 'string'));
+}
+/**
+ * Match a condition against context
+ */
+function matchCondition(condition, context) {
+    if (!condition) {
+        return true; // No condition means always match
+    }
+    // Match tool name
+    if (context.tool && context.tool.toLowerCase().includes(condition.toLowerCase())) {
+        return true;
+    }
+    // Match file pattern (simple glob)
+    if (context.file) {
+        if (condition.includes('*')) {
+            const regex = new RegExp('^' + condition.replace(/\./g, '\\.').replace(/\*\*/g, '.*').replace(/\*/g, '[^/]*') + '$');
+            return regex.test(context.file);
+        }
+        return context.file.includes(condition);
+    }
+    // Match command pattern
+    if (context.command && context.command.includes(condition)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Execute a hook's commands
+ */
+async function executeHookCommands(hook, context) {
+    const output = [];
+    const errors = [];
+    let abort = false;
+    const timeout = hook.timeout ?? DEFAULT_HOOK_TIMEOUT;
+    for (const command of hook.then) {
+        // Handle special commands
+        if (command.toLowerCase() === 'abort') {
+            abort = true;
+            continue;
+        }
+        if (command.toLowerCase().startsWith('message:')) {
+            output.push(command.slice(8).trim());
+            continue;
+        }
+        // Execute shell command
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), timeout);
+            const { stdout, stderr } = await execAsync(command, {
+                cwd: context.workingDir,
+                timeout,
+                signal: controller.signal,
+                env: {
+                    ...process.env,
+                    EROSOLAR_TOOL: context.tool ?? '',
+                    EROSOLAR_FILE: context.file ?? '',
+                    EROSOLAR_COMMAND: context.command ?? '',
+                },
+            });
+            clearTimeout(timeoutId);
+            if (stdout.trim()) {
+                output.push(stdout.trim());
+            }
+            if (stderr.trim()) {
+                errors.push(stderr.trim());
+            }
+        }
+        catch (error) {
+            const errMsg = error instanceof Error ? error.message : String(error);
+            errors.push(`Hook command failed: ${command}\n${errMsg}`);
+        }
+    }
+    return { output, errors, abort };
+}
+/**
+ * Run hooks for a specific trigger
+ */
+export async function runHooks(trigger, context, hooks) {
+    const allHooks = hooks ?? loadHooks(context.workingDir);
+    const matchingHooks = allHooks.filter((hook) => hook.when === trigger && matchCondition(hook.if, context));
+    if (matchingHooks.length === 0) {
+        return { triggered: false, output: [], errors: [], abort: false };
+    }
+    const result = {
+        triggered: true,
+        output: [],
+        errors: [],
+        abort: false,
+    };
+    for (const hook of matchingHooks) {
+        const { output, errors, abort } = await executeHookCommands(hook, context);
+        result.output.push(...output);
+        result.errors.push(...errors);
+        if (abort) {
+            result.abort = true;
+            break; // Stop processing if abort is requested
+        }
+    }
+    return result;
+}
+/**
+ * Create a hooks runner bound to a specific working directory
+ */
+export function createHooksRunner(workingDir) {
+    let cachedHooks = null;
+    const getHooks = () => {
+        if (cachedHooks === null) {
+            cachedHooks = loadHooks(workingDir);
+        }
+        return cachedHooks;
+    };
+    return {
+        runBefore: (trigger, context) => runHooks(trigger, { ...context, workingDir }, getHooks()),
+        runAfter: (trigger, context) => runHooks(trigger, { ...context, workingDir }, getHooks()),
+        reload: () => {
+            cachedHooks = null;
+        },
+    };
+}
+//# sourceMappingURL=hooksSystem.js.map

package/dist/core/hooksSystem.js.map

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

package/dist/core/memorySystem.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Memory System - Hierarchical persistent memory for AI context
+ *
+ * Implements a Claude Code-style memory system that loads persistent context
+ * from markdown files at multiple levels:
+ *
+ * 1. Enterprise Policy: /etc/erosolar/EROSOLAR.md (Linux), managed settings
+ * 2. User Memory: ~/.erosolar/EROSOLAR.md
+ * 3. Project Memory: ./EROSOLAR.md or ./.erosolar/EROSOLAR.md
+ *
+ * Supports @imports for including external files recursively (max 5 levels).
+ */
+interface MemorySource {
+    level: 'enterprise' | 'user' | 'project' | 'local';
+    path: string;
+    content: string;
+}
+export interface LoadedMemory {
+    sources: MemorySource[];
+    combinedContent: string;
+    importedPaths: string[];
+}
+/**
+ * Load all memory from the hierarchy
+ */
+export declare function loadMemory(workingDir: string): LoadedMemory;
+/**
+ * Get memory content formatted for system prompt injection
+ */
+export declare function getMemoryForPrompt(workingDir: string): string;
+/**
+ * List all memory file paths and their status
+ */
+export declare function listMemoryPaths(workingDir: string): Array<{
+    level: string;
+    path: string;
+    exists: boolean;
+}>;
+/**
+ * Get the default path for creating a new project memory file
+ */
+export declare function getDefaultProjectMemoryPath(workingDir: string): string;
+/**
+ * Get the user memory path for editing
+ */
+export declare function getUserMemoryEditPath(): string;
+export {};
+//# sourceMappingURL=memorySystem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memorySystem.d.ts","sourceRoot":"","sources":["../../src/core/memorySystem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,UAAU,YAAY;IACpB,KAAK,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAmKD;;GAEG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CA6D3D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAc7D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,CAAC;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC,CAmCD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C"}

package/dist/core/memorySystem.js

@@ -0,0 +1,271 @@
+/**
+ * Memory System - Hierarchical persistent memory for AI context
+ *
+ * Implements a Claude Code-style memory system that loads persistent context
+ * from markdown files at multiple levels:
+ *
+ * 1. Enterprise Policy: /etc/erosolar/EROSOLAR.md (Linux), managed settings
+ * 2. User Memory: ~/.erosolar/EROSOLAR.md
+ * 3. Project Memory: ./EROSOLAR.md or ./.erosolar/EROSOLAR.md
+ *
+ * Supports @imports for including external files recursively (max 5 levels).
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+import { homedir, platform } from 'node:os';
+const MAX_IMPORT_DEPTH = 5;
+const MEMORY_FILE_NAMES = ['EROSOLAR.md', 'CLAUDE.md'];
+const DATA_DIR_NAME = '.erosolar';
+/**
+ * Get the path to the enterprise policy memory file
+ */
+function getEnterprisePolicyPath() {
+    const plat = platform();
+    if (plat === 'darwin') {
+        return '/Library/Application Support/Erosolar/EROSOLAR.md';
+    }
+    if (plat === 'linux') {
+        return '/etc/erosolar/EROSOLAR.md';
+    }
+    if (plat === 'win32') {
+        const programData = process.env['PROGRAMDATA'] || 'C:\\ProgramData';
+        return join(programData, 'Erosolar', 'EROSOLAR.md');
+    }
+    return null;
+}
+/**
+ * Get the path to the user memory file
+ */
+function getUserMemoryPath() {
+    return join(homedir(), DATA_DIR_NAME, 'EROSOLAR.md');
+}
+/**
+ * Find project memory file in the workspace
+ */
+function findProjectMemoryPath(workingDir) {
+    // Check root level first
+    for (const name of MEMORY_FILE_NAMES) {
+        const rootPath = join(workingDir, name);
+        if (existsSync(rootPath)) {
+            return rootPath;
+        }
+    }
+    // Check .erosolar directory
+    for (const name of MEMORY_FILE_NAMES) {
+        const nestedPath = join(workingDir, DATA_DIR_NAME, name);
+        if (existsSync(nestedPath)) {
+            return nestedPath;
+        }
+    }
+    // Check .claude directory for compatibility
+    for (const name of MEMORY_FILE_NAMES) {
+        const claudePath = join(workingDir, '.claude', name);
+        if (existsSync(claudePath)) {
+            return claudePath;
+        }
+    }
+    return null;
+}
+/**
+ * Parse @imports from a memory file content
+ */
+function parseImports(content) {
+    const imports = [];
+    const lines = content.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Match @path/to/file.md or @~/path/to/file.md
+        if (trimmed.startsWith('@') && !trimmed.startsWith('@{')) {
+            const importPath = trimmed.slice(1).trim();
+            if (importPath) {
+                imports.push(importPath);
+            }
+        }
+    }
+    return imports;
+}
+/**
+ * Remove @import lines from content (they're processed, not displayed)
+ */
+function removeImportLines(content) {
+    return content
+        .split('\n')
+        .filter((line) => {
+        const trimmed = line.trim();
+        return !trimmed.startsWith('@') || trimmed.startsWith('@{');
+    })
+        .join('\n')
+        .trim();
+}
+/**
+ * Resolve an import path relative to the source file
+ */
+function resolveImportPath(importPath, sourceDir) {
+    // Handle ~ for home directory
+    if (importPath.startsWith('~/') || importPath.startsWith('~\\')) {
+        return join(homedir(), importPath.slice(2));
+    }
+    // Handle absolute paths
+    if (isAbsolute(importPath)) {
+        return importPath;
+    }
+    // Relative to source file directory
+    return resolve(sourceDir, importPath);
+}
+/**
+ * Load a memory file and process its imports recursively
+ */
+function loadMemoryFileWithImports(filePath, depth, visitedPaths, importedPaths) {
+    if (depth > MAX_IMPORT_DEPTH) {
+        return `<!-- Import depth exceeded (max ${MAX_IMPORT_DEPTH}) for: ${filePath} -->`;
+    }
+    const normalizedPath = resolve(filePath);
+    if (visitedPaths.has(normalizedPath)) {
+        return `<!-- Circular import detected: ${filePath} -->`;
+    }
+    if (!existsSync(filePath)) {
+        return `<!-- Import not found: ${filePath} -->`;
+    }
+    visitedPaths.add(normalizedPath);
+    importedPaths.push(normalizedPath);
+    let content;
+    try {
+        content = readFileSync(filePath, 'utf-8');
+    }
+    catch (error) {
+        return `<!-- Failed to read: ${filePath} -->`;
+    }
+    const sourceDir = dirname(normalizedPath);
+    const imports = parseImports(content);
+    // Process imports and replace with their content
+    let processedContent = removeImportLines(content);
+    for (const importPath of imports) {
+        const resolvedPath = resolveImportPath(importPath, sourceDir);
+        const importedContent = loadMemoryFileWithImports(resolvedPath, depth + 1, visitedPaths, importedPaths);
+        processedContent += '\n\n' + importedContent;
+    }
+    return processedContent.trim();
+}
+/**
+ * Load all memory from the hierarchy
+ */
+export function loadMemory(workingDir) {
+    const sources = [];
+    const allImportedPaths = [];
+    const visitedPaths = new Set();
+    // 1. Enterprise policy (highest priority, but loaded first so it can be overridden)
+    const enterprisePath = getEnterprisePolicyPath();
+    if (enterprisePath && existsSync(enterprisePath)) {
+        const content = loadMemoryFileWithImports(enterprisePath, 0, visitedPaths, allImportedPaths);
+        if (content.trim()) {
+            sources.push({
+                level: 'enterprise',
+                path: enterprisePath,
+                content,
+            });
+        }
+    }
+    // 2. User memory
+    const userPath = getUserMemoryPath();
+    if (existsSync(userPath)) {
+        const content = loadMemoryFileWithImports(userPath, 0, visitedPaths, allImportedPaths);
+        if (content.trim()) {
+            sources.push({
+                level: 'user',
+                path: userPath,
+                content,
+            });
+        }
+    }
+    // 3. Project memory
+    const projectPath = findProjectMemoryPath(workingDir);
+    if (projectPath) {
+        const content = loadMemoryFileWithImports(projectPath, 0, visitedPaths, allImportedPaths);
+        if (content.trim()) {
+            sources.push({
+                level: 'project',
+                path: projectPath,
+                content,
+            });
+        }
+    }
+    // Combine all memory with headers
+    const sections = [];
+    for (const source of sources) {
+        const levelLabel = source.level === 'enterprise'
+            ? 'Enterprise Policy'
+            : source.level === 'user'
+                ? 'User Guidelines'
+                : 'Project Guidelines';
+        sections.push(`## ${levelLabel}\n\n${source.content}`);
+    }
+    return {
+        sources,
+        combinedContent: sections.join('\n\n---\n\n'),
+        importedPaths: allImportedPaths,
+    };
+}
+/**
+ * Get memory content formatted for system prompt injection
+ */
+export function getMemoryForPrompt(workingDir) {
+    const memory = loadMemory(workingDir);
+    if (!memory.combinedContent.trim()) {
+        return '';
+    }
+    return `
+<persistent-memory>
+The following persistent context has been loaded from memory files.
+Follow these guidelines when working in this workspace.
+
+${memory.combinedContent}
+</persistent-memory>
+`;
+}
+/**
+ * List all memory file paths and their status
+ */
+export function listMemoryPaths(workingDir) {
+    const paths = [];
+    const enterprisePath = getEnterprisePolicyPath();
+    if (enterprisePath) {
+        paths.push({
+            level: 'enterprise',
+            path: enterprisePath,
+            exists: existsSync(enterprisePath),
+        });
+    }
+    const userPath = getUserMemoryPath();
+    paths.push({
+        level: 'user',
+        path: userPath,
+        exists: existsSync(userPath),
+    });
+    const projectMemoryLocations = [
+        join(workingDir, 'EROSOLAR.md'),
+        join(workingDir, 'CLAUDE.md'),
+        join(workingDir, DATA_DIR_NAME, 'EROSOLAR.md'),
+        join(workingDir, '.claude', 'CLAUDE.md'),
+    ];
+    for (const path of projectMemoryLocations) {
+        paths.push({
+            level: 'project',
+            path,
+            exists: existsSync(path),
+        });
+    }
+    return paths;
+}
+/**
+ * Get the default path for creating a new project memory file
+ */
+export function getDefaultProjectMemoryPath(workingDir) {
+    return join(workingDir, 'EROSOLAR.md');
+}
+/**
+ * Get the user memory path for editing
+ */
+export function getUserMemoryEditPath() {
+    return getUserMemoryPath();
+}
+//# sourceMappingURL=memorySystem.js.map

package/dist/core/memorySystem.js.map

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

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

@@ -1 +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,CAqEpB"}
+{"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,CAsFpB"}

package/dist/core/toolPreconditions.js

@@ -197,6 +197,20 @@ export function validateToolPreconditions(toolName, args) {
 export function validateAIFlowPatterns(toolName, args, toolHistory) {
     const warnings = [];
     const toolLower = toolName.toLowerCase();
+    // Pattern: Sequential file reads without parallel execution
+    if (toolLower === 'read' || toolLower === 'read_file') {
+        const currentFile = (args['file_path'] || args['path']);
+        // Get recent read operations (last 5 in history)
+        const recentReads = toolHistory
+            .slice(-5)
+            .filter((call) => {
+            const callLower = call.toolName.toLowerCase();
+            return callLower === 'read' || callLower === 'read_file';
+        });
+        // Sequential read optimization warning disabled - too noisy and not actionable
+        // The AI can decide when parallel reads are appropriate without constant reminders
+        void recentReads; // Suppress unused variable warning
+    }
     // Pattern: Edit without prior Read
     if (toolLower === 'edit') {
         const oldString = typeof args['old_string'] === 'string' ? args['old_string'] : undefined;