@hubblecommerce/overmind-core 0.1.6 → 0.1.8

package/dist/src/utils/repomix-search.d.ts

@@ -7,6 +7,7 @@ interface SearchMatch {
     lineNumber: number;
     line: string;
     matchedText: string;
+    filePath: string | null;
 }
 interface SearchResult {
     matches: SearchMatch[];
@@ -16,6 +17,12 @@ interface SearchOptions {
     ignoreCase?: boolean;
     contextLines?: number;
 }
+interface DirectoryStructureOptions {
+    /** Subtree root path to start from (e.g. "app/components"). Default: root */
+    path?: string;
+    /** How many levels deep to return. Default: 1 (top-level only) */
+    depth?: number;
+}
 /**
  * Search a repomix XML string for lines matching a pattern.
  * Returns matching lines with optional context.
@@ -27,5 +34,10 @@ export declare function searchRepomix(xml: string, pattern: string, options?: Se
  * Returns null if the file is not found.
  */
 export declare function getRepomixFile(xml: string, filePath: string): string | null;
+/**
+ * Extract the directory structure from repomix XML.
+ * Returns an indented tree filtered by optional path and depth.
+ */
+export declare function getRepomixDirectoryStructure(xml: string, options?: DirectoryStructureOptions): string | null;
 export {};
 //# sourceMappingURL=repomix-search.d.ts.map

package/dist/src/utils/repomix-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repomix-search.d.ts","sourceRoot":"","sources":["../../../src/utils/repomix-search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,UAAU,WAAW;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,YAAY;IAClB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,UAAU,aAAa;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAsED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,CASjG;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ3E"}
+{"version":3,"file":"repomix-search.d.ts","sourceRoot":"","sources":["../../../src/utils/repomix-search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,UAAU,WAAW;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,UAAU,YAAY;IAClB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,UAAU,aAAa;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,yBAAyB;IAC/B,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAmGD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,CASjG;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ3E;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,MAAM,GAAG,IAAI,CA0D5G"}

package/dist/src/utils/repomix-search.js

@@ -13,8 +13,26 @@ function createRegexPattern(pattern, ignoreCase) {
         throw new Error(`Invalid regular expression pattern: ${pattern}. ${error instanceof Error ? error.message : String(error)}`);
     }
 }
+const FILE_TAG_REGEX = /^<file\s+path="([^"]+)"/;
+/**
+ * Build a lookup: for each line index, find the file path it belongs to
+ * by scanning for `<file path="...">` tags.
+ */
+function buildFilePathIndex(lines) {
+    const index = new Array(lines.length).fill('');
+    let currentPath = '';
+    for (let i = 0; i < lines.length; i++) {
+        const tagMatch = lines[i].match(FILE_TAG_REGEX);
+        if (tagMatch) {
+            currentPath = tagMatch[1];
+        }
+        index[i] = currentPath;
+    }
+    return index;
+}
 function searchInLines(lines, pattern, ignoreCase) {
     const regex = createRegexPattern(pattern, ignoreCase);
+    const filePathIndex = buildFilePathIndex(lines);
     const matches = [];
     for (let i = 0; i < lines.length; i++) {
         const line = lines[i];
@@ -24,6 +42,7 @@ function searchInLines(lines, pattern, ignoreCase) {
                 lineNumber: i + 1,
                 line,
                 matchedText: match[0],
+                filePath: filePathIndex[i] || null,
             });
         }
     }
@@ -35,10 +54,18 @@ function formatSearchResults(lines, matches, beforeLines, afterLines) {
     }
     const resultLines = [];
     const addedLines = new Set();
+    let lastFilePath = null;
     for (const match of matches) {
         const start = Math.max(0, match.lineNumber - 1 - beforeLines);
         const end = Math.min(lines.length - 1, match.lineNumber - 1 + afterLines);
-        if (resultLines.length > 0 && start > Math.min(...addedLines) + 1) {
+        // Add file path header when entering a different file
+        if (match.filePath && match.filePath !== lastFilePath) {
+            if (resultLines.length > 0)
+                resultLines.push('');
+            resultLines.push(`=== ${match.filePath} ===`);
+            lastFilePath = match.filePath;
+        }
+        else if (resultLines.length > 0 && start > Math.min(...addedLines) + 1) {
             resultLines.push('--');
         }
         for (let i = start; i <= end; i++) {
@@ -78,3 +105,57 @@ export function getRepomixFile(xml, filePath) {
         return null;
     return match[1];
 }
+/**
+ * Extract the directory structure from repomix XML.
+ * Returns an indented tree filtered by optional path and depth.
+ */
+export function getRepomixDirectoryStructure(xml, options) {
+    const match = xml.match(/<directory_structure>\n?([\s\S]*?)\n?<\/directory_structure>/);
+    if (!match?.[1])
+        return null;
+    const fullTree = match[1];
+    const lines = fullTree.split('\n');
+    const targetPath = options?.path?.replace(/\/$/, '') ?? '';
+    const maxDepth = options?.depth ?? 1;
+    const getDepth = (line) => {
+        const leadingSpaces = line.match(/^( *)/)?.[1].length ?? 0;
+        return leadingSpaces / 2;
+    };
+    // Build full paths from indented tree using a stack
+    const pathStack = [];
+    if (!targetPath) {
+        return lines
+            .filter(line => line.trim() && getDepth(line) < maxDepth)
+            .join('\n');
+    }
+    // Find the subtree starting at targetPath
+    let inSubtree = false;
+    let subtreeBaseDepth = 0;
+    const result = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        const depth = getDepth(line);
+        // Maintain path stack: trim to current depth, then push
+        pathStack.length = depth;
+        pathStack.push(trimmed.replace(/\/$/, ''));
+        const fullPath = pathStack.join('/');
+        if (!inSubtree) {
+            if (fullPath === targetPath) {
+                inSubtree = true;
+                subtreeBaseDepth = depth + 1;
+                result.push(trimmed);
+            }
+            continue;
+        }
+        if (depth < subtreeBaseDepth) {
+            break;
+        }
+        const relativeDepth = depth - subtreeBaseDepth;
+        if (relativeDepth < maxDepth) {
+            result.push('  '.repeat(relativeDepth) + trimmed);
+        }
+    }
+    return result.length > 0 ? result.join('\n') : null;
+}

package/dist/src/utils/repomix-search.test.js

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import { searchRepomix, getRepomixFile } from './repomix-search.js';
+import { searchRepomix, getRepomixFile, getRepomixDirectoryStructure } from './repomix-search.js';
 const SAMPLE_XML = `<file path="src/index.ts">
 import { App } from './app';
 
@@ -25,12 +25,46 @@ export function login(username: string, password: string) {
     });
 }
 </file>`;
+const SAMPLE_XML_WITH_STRUCTURE = `<directory_structure>
+app/
+  components/
+    Header.vue
+    Footer.vue
+  pages/
+    index.vue
+    about.vue
+  middleware/
+    auth.ts
+config/
+  app.config.ts
+package.json
+README.md
+</directory_structure>
+
+<files>
+<file path="app/components/Header.vue">
+<template><header></header></template>
+</file>
+</files>`;
 describe('searchRepomix', () => {
     it('returns matching lines with file context', () => {
         const results = searchRepomix(SAMPLE_XML, 'auth');
         expect(results.matches.length).toBeGreaterThan(0);
         expect(results.matches.some(m => m.line.includes('auth'))).toBe(true);
     });
+    it('enriches each match with its file path', () => {
+        const results = searchRepomix(SAMPLE_XML, 'auth');
+        const readmeMatch = results.matches.find(m => m.line.includes('authentication'));
+        expect(readmeMatch?.filePath).toBe('README.md');
+        const loginMatch = results.matches.find(m => m.line.includes('/api/auth/login'));
+        expect(loginMatch?.filePath).toBe('src/auth/login.ts');
+    });
+    it('includes file path headers in formatted output when file changes', () => {
+        const results = searchRepomix(SAMPLE_XML, 'auth');
+        const output = results.formattedOutput.join('\n');
+        expect(output).toContain('=== README.md ===');
+        expect(output).toContain('=== src/auth/login.ts ===');
+    });
     it('returns empty matches for non-existent pattern', () => {
         const results = searchRepomix(SAMPLE_XML, 'nonexistent_xyz_pattern');
         expect(results.matches).toHaveLength(0);
@@ -73,3 +107,36 @@ describe('getRepomixFile', () => {
         expect(content).toContain("import { App }");
     });
 });
+describe('getRepomixDirectoryStructure', () => {
+    it('returns top-level entries by default (depth 1)', () => {
+        const result = getRepomixDirectoryStructure(SAMPLE_XML_WITH_STRUCTURE);
+        expect(result).toContain('app/');
+        expect(result).toContain('config/');
+        expect(result).toContain('package.json');
+        expect(result).not.toContain('Header.vue');
+        expect(result).not.toContain('pages/');
+    });
+    it('returns deeper entries when depth is increased', () => {
+        const result = getRepomixDirectoryStructure(SAMPLE_XML_WITH_STRUCTURE, { depth: 2 });
+        expect(result).toContain('app/');
+        expect(result).toContain('components/');
+        expect(result).toContain('pages/');
+        expect(result).not.toContain('Header.vue');
+    });
+    it('returns a subtree when path is specified', () => {
+        const result = getRepomixDirectoryStructure(SAMPLE_XML_WITH_STRUCTURE, { path: 'app/components', depth: 1 });
+        expect(result).toContain('components/');
+        expect(result).toContain('Header.vue');
+        expect(result).toContain('Footer.vue');
+        expect(result).not.toContain('pages/');
+        expect(result).not.toContain('config/');
+    });
+    it('returns null when directory_structure section is missing', () => {
+        const result = getRepomixDirectoryStructure('<file path="test.ts">code</file>');
+        expect(result).toBeNull();
+    });
+    it('returns null when path does not exist in tree', () => {
+        const result = getRepomixDirectoryStructure(SAMPLE_XML_WITH_STRUCTURE, { path: 'nonexistent' });
+        expect(result).toBeNull();
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hubblecommerce/overmind-core",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "type": "module",
   "description": "Shared infrastructure package for the Overmind AI agent system",
   "main": "./dist/src/index.js",