@equinor/fusion-framework-cli-plugin-ai-index 3.0.6 → 3.0.8

package/dist/esm/utils/git/get-changed-files.js

@@ -0,0 +1,87 @@
+import { resolveProjectRoot } from './resolve-project-root.js';
+import { getGit } from './get-git.js';
+/**
+ * Returns a list of files changed between `baseRef` and HEAD.
+ *
+ * Parses the output of `git diff --name-status` to classify each file as
+ * `'new'`, `'modified'`, or `'removed'`. Renames are expanded into a
+ * `'removed'` entry for the old path and a `'new'` entry for the new path.
+ *
+ * @param options - Configuration controlling the diff reference and working directory.
+ * @returns Array of changed files with their status.
+ * @throws {Error} If the working directory is not inside a git repository.
+ */
+export const getChangedFiles = async (options) => {
+    const { diff, baseRef = 'HEAD~1', cwd = process.cwd() } = options;
+    // Skip git entirely when diff mode wasn't requested
+    if (!diff) {
+        return [];
+    }
+    const projectRoot = resolveProjectRoot(cwd);
+    // Diff mode requires a git repository to resolve the project root against
+    if (!projectRoot) {
+        throw new Error('Not in a git repository. Cannot use --diff option.');
+    }
+    const { git } = getGit(cwd) ?? {};
+    // Cannot proceed without a working git client
+    if (!git) {
+        throw new Error('Failed to initialize git client');
+    }
+    try {
+        // Get changes since baseRef with status (A=added, M=modified, D=deleted)
+        try {
+            const diffResult = await git.diff([`${baseRef}`, '--name-status']);
+            // Drop blank lines left by the trailing newline in git's output
+            const lines = diffResult.split('\n').filter((line) => line.trim() !== '');
+            const changedFiles = [];
+            // Classify each changed line by its git status code
+            for (const line of lines) {
+                // Match status and file path
+                // Format: "A\tfile.ts" or "M\tfile.ts" or "D\tfile.ts"
+                // Also handle renames: "R100\told.ts\tnew.ts"
+                const renameMatch = line.match(/^R\d*\s+(.+?)\s+(.+)$/);
+                // Expand a detected rename into a removed old-path entry and a new-path entry
+                if (renameMatch) {
+                    const [, oldFile, newFile] = renameMatch;
+                    // Add both the removed old file and the new file
+                    changedFiles.push({ filepath: `${projectRoot}/${oldFile}`, status: 'removed' });
+                    changedFiles.push({ filepath: `${projectRoot}/${newFile}`, status: 'new' });
+                    // Rename already handled above; skip the add/modify/delete matching below
+                    continue;
+                }
+                const match = line.match(/^([AMD])\s+(.+)$/);
+                // Only lines matching the single-letter add/modify/delete status format are actionable
+                if (match) {
+                    const [, gitStatus, file] = match;
+                    const fullPath = `${projectRoot}/${file}`;
+                    let status;
+                    // Map git's single-letter status codes to our ChangedFile status values
+                    if (gitStatus === 'A') {
+                        status = 'new';
+                    }
+                    else if (gitStatus === 'M') {
+                        status = 'modified';
+                    }
+                    else if (gitStatus === 'D') {
+                        status = 'removed';
+                    }
+                    else {
+                        // Skip unknown statuses (C=copied, etc.)
+                        continue;
+                    }
+                    changedFiles.push({ filepath: fullPath, status });
+                }
+            }
+            return changedFiles;
+        }
+        catch {
+            // Handle case where baseRef doesn't exist (e.g., first commit)
+            console.warn(`⚠️  Warning: Git reference '${baseRef}' not found. Processing all files.`);
+            return [];
+        }
+    }
+    catch (error) {
+        throw new Error(`Git diff failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+};
+//# sourceMappingURL=get-changed-files.js.map

package/dist/esm/utils/git/get-changed-files.js.map

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

package/dist/esm/utils/git/{file-changes.js → get-file-status.js}

@@ -1,80 +1,5 @@
 import { join, relative } from 'node:path';
-import { resolveProjectRoot, getGit } from './git-client.js';
-/**
- * Returns a list of files changed between `baseRef` and HEAD.
- *
- * Parses the output of `git diff --name-status` to classify each file as
- * `'new'`, `'modified'`, or `'removed'`. Renames are expanded into a
- * `'removed'` entry for the old path and a `'new'` entry for the new path.
- *
- * @param options - Configuration controlling the diff reference and working directory.
- * @returns Array of changed files with their status.
- * @throws {Error} If the working directory is not inside a git repository.
- */
-export const getChangedFiles = async (options) => {
-    const { diff, baseRef = 'HEAD~1', cwd = process.cwd() } = options;
-    if (!diff) {
-        return [];
-    }
-    const projectRoot = resolveProjectRoot(cwd);
-    if (!projectRoot) {
-        throw new Error('Not in a git repository. Cannot use --diff option.');
-    }
-    const { git } = getGit(cwd) ?? {};
-    if (!git) {
-        throw new Error('Failed to initialize git client');
-    }
-    try {
-        // Get changes since baseRef with status (A=added, M=modified, D=deleted)
-        try {
-            const diffResult = await git.diff([`${baseRef}`, '--name-status']);
-            const lines = diffResult.split('\n').filter((line) => line.trim() !== '');
-            const changedFiles = [];
-            for (const line of lines) {
-                // Match status and file path
-                // Format: "A\tfile.ts" or "M\tfile.ts" or "D\tfile.ts"
-                // Also handle renames: "R100\told.ts\tnew.ts"
-                const renameMatch = line.match(/^R\d*\s+(.+?)\s+(.+)$/);
-                if (renameMatch) {
-                    const [, oldFile, newFile] = renameMatch;
-                    // Add both the removed old file and the new file
-                    changedFiles.push({ filepath: `${projectRoot}/${oldFile}`, status: 'removed' });
-                    changedFiles.push({ filepath: `${projectRoot}/${newFile}`, status: 'new' });
-                    continue;
-                }
-                const match = line.match(/^([AMD])\s+(.+)$/);
-                if (match) {
-                    const [, gitStatus, file] = match;
-                    const fullPath = `${projectRoot}/${file}`;
-                    let status;
-                    if (gitStatus === 'A') {
-                        status = 'new';
-                    }
-                    else if (gitStatus === 'M') {
-                        status = 'modified';
-                    }
-                    else if (gitStatus === 'D') {
-                        status = 'removed';
-                    }
-                    else {
-                        // Skip unknown statuses (C=copied, etc.)
-                        continue;
-                    }
-                    changedFiles.push({ filepath: fullPath, status });
-                }
-            }
-            return changedFiles;
-        }
-        catch {
-            // Handle case where baseRef doesn't exist (e.g., first commit)
-            console.warn(`⚠️  Warning: Git reference '${baseRef}' not found. Processing all files.`);
-            return [];
-        }
-    }
-    catch (error) {
-        throw new Error(`Git diff failed: ${error instanceof Error ? error.message : String(error)}`);
-    }
-};
+import { getGit } from './get-git.js';
 /**
  * Determines the git change status of a single file.
  *
@@ -88,8 +13,8 @@ export const getChangedFiles = async (options) => {
  */
 export const getFileStatus = async (filePath) => {
     const { git, gitRepoPath } = getGit(filePath) ?? {};
+    // Not in a git repository, assume new
     if (!git || !gitRepoPath) {
-        // Not in a git repository, assume new
         return [{ filepath: filePath, status: 'new' }];
     }
     const gitFilePath = relative(gitRepoPath, filePath);
@@ -101,8 +26,8 @@ export const getFileStatus = async (filePath) => {
             .raw(['ls-files', '--error-unmatch', normalizedGitFilePath])
             .then(() => true)
             .catch(() => false);
+        // File is tracked at this path, it's modified
         if (isTracked) {
-            // File is tracked at this path, it's modified
             return [{ filepath: filePath, status: 'modified' }];
         }
         // File is not tracked - quickly check if it's explicitly untracked
@@ -115,6 +40,7 @@ export const getFileStatus = async (filePath) => {
                 normalizedGitFilePath,
             ]);
             const trimmed = fileStatusOutput.trim();
+            // Only inspect porcelain output when git actually reported something for this path
             if (trimmed.length > 0) {
                 // If status shows ??, it's untracked (truly new)
                 if (/^\?\?/.test(trimmed)) {
@@ -130,10 +56,13 @@ export const getFileStatus = async (filePath) => {
         try {
             // Get full git status to check for renames (only if needed)
             const statusOutput = await git.raw(['status', '--porcelain']);
+            // Drop blank lines left by the trailing newline in git's output
             const lines = statusOutput.split('\n').filter((line) => line.trim() !== '');
+            // Scan every status line for a rename or copy that produced this file
             for (const line of lines) {
                 // Check for rename format: "R100\told.ts\tnew.ts"
                 const renameMatch = line.match(/^R\d+\s+(.+?)\s+(.+)$/);
+                // A rename line resolves this file only if it matches the new path
                 if (renameMatch) {
                     const [, oldPath, newPath] = renameMatch;
                     const oldFullPath = join(gitRepoPath, oldPath);
@@ -148,6 +77,7 @@ export const getFileStatus = async (filePath) => {
                 }
                 // Check for copy format: "C100\told.ts\tnew.ts" (similar to rename)
                 const copyMatch = line.match(/^C\d+\s+(.+?)\s+(.+)$/);
+                // A copy line resolves this file only if it matches the new path
                 if (copyMatch) {
                     const [, , newPath] = copyMatch;
                     const newFullPath = join(gitRepoPath, newPath);
@@ -192,20 +122,4 @@ export const getFileStatus = async (filePath) => {
         return [{ filepath: filePath, status: 'new' }];
     }
 };
-/**
- * Checks whether a file path appears in a list of changed files.
- *
- * When the changed-files list is empty (no diff filtering active), every
- * file is considered changed so that all files are processed.
- *
- * @param filePath - Absolute file path to look up.
- * @param changedFiles - Array of {@link ChangedFile} entries to search.
- * @returns `true` if the file has changed or if diff filtering is disabled.
- */
-export const isFileChanged = (filePath, changedFiles) => {
-    if (changedFiles.length === 0) {
-        return true; // If no diff filtering, process all files
-    }
-    return changedFiles.some((file) => file.filepath === filePath);
-};
-//# sourceMappingURL=file-changes.js.map
+//# sourceMappingURL=get-file-status.js.map

package/dist/esm/utils/git/get-file-status.js.map

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

package/dist/esm/utils/git/{status.js → get-git-status.js}

@@ -1,4 +1,5 @@
-import { resolveProjectRoot, getGit } from './git-client.js';
+import { resolveProjectRoot } from './resolve-project-root.js';
+import { getGit } from './get-git.js';
 /**
  * Retrieves a summary of the current git working-tree status.
  *
@@ -12,10 +13,12 @@ import { resolveProjectRoot, getGit } from './git-client.js';
  */
 export const getGitStatus = async (cwd = process.cwd()) => {
     const projectRoot = resolveProjectRoot(cwd);
+    // Status can only be reported when cwd is inside a git repository
     if (!projectRoot) {
         throw new Error('Not in a git repository');
     }
     const { git } = getGit(cwd) ?? {};
+    // Fail fast if the git client could not be created for this repository
     if (!git) {
         throw new Error('Failed to initialize git client');
     }
@@ -37,4 +40,4 @@ export const getGitStatus = async (cwd = process.cwd()) => {
         throw new Error(`Failed to get git status: ${error instanceof Error ? error.message : String(error)}`);
     }
 };
-//# sourceMappingURL=status.js.map
+//# sourceMappingURL=get-git-status.js.map

package/dist/esm/utils/git/get-git-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-git-status.js","sourceRoot":"","sources":["../../../../src/utils/git/get-git-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAC/B,GAAG,GAAW,OAAO,CAAC,GAAG,EAAE,EAO1B,EAAE;IACH,MAAM,WAAW,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC5C,kEAAkE;IAClE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IAClC,uEAAuE;IACvE,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;QAEvD,MAAM,YAAY,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC;QACxC,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC;QAC/C,MAAM,aAAa,GACjB,YAAY,CAAC,QAAQ,CAAC,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC;QAE7F,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;YACrB,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;YACrB,UAAU,EAAE,WAAW,GAAG,CAAC,IAAI,aAAa,GAAG,CAAC;YAChD,WAAW;YACX,aAAa;SACd,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,6BAA6B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACtF,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}

package/dist/esm/utils/git/get-git.js

@@ -0,0 +1,30 @@
+import { simpleGit } from 'simple-git';
+import { resolveProjectRoot } from './resolve-project-root.js';
+const gitCache = new Map();
+/**
+ * Returns a cached `SimpleGit` instance scoped to the repository that
+ * contains `filePath`.
+ *
+ * Instances are cached by repository root to avoid repeatedly spawning
+ * new git processes for the same repo.
+ *
+ * @param filePath - Absolute file path to locate the repository for.
+ * @returns An object containing the git client and the repository root path,
+ *   or `undefined` when `filePath` is not inside a git repository.
+ */
+export const getGit = (filePath) => {
+    const gitRepoPath = resolveProjectRoot(filePath);
+    // Only build/cache a client when the file is inside a git repository
+    if (gitRepoPath) {
+        // Reuse an existing client for this repo root instead of spawning a new one
+        if (!gitCache.has(gitRepoPath)) {
+            gitCache.set(gitRepoPath, simpleGit(gitRepoPath));
+        }
+        return {
+            git: gitCache.get(gitRepoPath),
+            gitRepoPath,
+        };
+    }
+    return undefined;
+};
+//# sourceMappingURL=get-git.js.map

package/dist/esm/utils/git/get-git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-git.js","sourceRoot":"","sources":["../../../../src/utils/git/get-git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAkB,MAAM,YAAY,CAAC;AAEvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAqB,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,QAAgB,EACiD,EAAE;IACnE,MAAM,WAAW,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACjD,qEAAqE;IACrE,IAAI,WAAW,EAAE,CAAC;QAChB,4EAA4E;QAC5E,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YAC/B,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,OAAO;YACL,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC;YAC9B,WAAW;SACZ,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC"}

package/dist/esm/utils/git/index.js

@@ -1,9 +1,12 @@
 // Re-export git client utilities
-export { resolveProjectRoot, getGit } from './git-client.js';
+export { resolveProjectRoot } from './resolve-project-root.js';
+export { getGit } from './get-git.js';
 // Re-export metadata functions
-export { extractGitMetadata } from './metadata.js';
+export { extractGitMetadata } from './extract-git-metadata.js';
 // Re-export file change functions
-export { getChangedFiles, getFileStatus, isFileChanged } from './file-changes.js';
+export { getChangedFiles } from './get-changed-files.js';
+export { getFileStatus } from './get-file-status.js';
+export { isFileChanged } from './is-file-changed.js';
 // Re-export status functions
-export { getGitStatus } from './status.js';
+export { getGitStatus } from './get-git-status.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/utils/git/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/git/index.ts"],"names":[],"mappings":"AAQA,iCAAiC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE7D,+BAA+B;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,kCAAkC;AAClC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElF,6BAA6B;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/git/index.ts"],"names":[],"mappings":"AAQA,iCAAiC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,+BAA+B;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,kCAAkC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,6BAA6B;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/esm/utils/git/is-file-changed.js

@@ -0,0 +1,19 @@
+/**
+ * Checks whether a file path appears in a list of changed files.
+ *
+ * When the changed-files list is empty (no diff filtering active), every
+ * file is considered changed so that all files are processed.
+ *
+ * @param filePath - Absolute file path to look up.
+ * @param changedFiles - Array of {@link ChangedFile} entries to search.
+ * @returns `true` if the file has changed or if diff filtering is disabled.
+ */
+export const isFileChanged = (filePath, changedFiles) => {
+    // If no diff filtering, process all files
+    if (changedFiles.length === 0) {
+        return true;
+    }
+    // A file is considered changed when its path matches any entry in the list
+    return changedFiles.some((file) => file.filepath === filePath);
+};
+//# sourceMappingURL=is-file-changed.js.map

package/dist/esm/utils/git/is-file-changed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-file-changed.js","sourceRoot":"","sources":["../../../../src/utils/git/is-file-changed.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAgB,EAAE,YAA2B,EAAW,EAAE;IACtF,0CAA0C;IAC1C,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2EAA2E;IAC3E,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;AACjE,CAAC,CAAC"}

package/dist/esm/utils/git/resolve-project-root.js

@@ -0,0 +1,22 @@
+import { dirname, join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { findUpSync } from 'find-up';
+/**
+ * Resolves the git repository root for a given file path.
+ *
+ * Walks up the directory tree looking for a `.git` directory or file
+ * (to support worktrees) and returns the enclosing directory.
+ *
+ * @param filePath - Absolute file or directory path to resolve from.
+ * @returns Absolute path to the repository root, or `undefined` if not inside a git repo.
+ */
+export const resolveProjectRoot = (filePath) => {
+    // if we are in the root of the git repository, return the root
+    if (existsSync(join(filePath, '.git'))) {
+        return filePath;
+    }
+    const gitRepoPath = findUpSync('.git', { cwd: dirname(filePath), type: 'both' });
+    const projectRoot = gitRepoPath?.replace(/\.git$/, '');
+    return projectRoot;
+};
+//# sourceMappingURL=resolve-project-root.js.map

package/dist/esm/utils/git/resolve-project-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-project-root.js","sourceRoot":"","sources":["../../../../src/utils/git/resolve-project-root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,QAAgB,EAAsB,EAAE;IACzE,+DAA+D;IAC/D,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;QACvC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACjF,MAAM,WAAW,GAAG,WAAW,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACvD,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC"}

package/dist/esm/utils/markdown/index.js

@@ -1,3 +1,5 @@
 // Re-export parser functions
-export { isMarkdownFile, parseMarkdown, parseMarkdownFile } from './parser.js';
+export { isMarkdownFile } from './is-markdown-file.js';
+export { parseMarkdown } from './parse-markdown.js';
+export { parseMarkdownFile } from './parse-markdown-file.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/utils/markdown/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/markdown/index.ts"],"names":[],"mappings":"AAGA,6BAA6B;AAC7B,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/markdown/index.ts"],"names":[],"mappings":"AAGA,6BAA6B;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/esm/utils/markdown/is-markdown-file.js

@@ -0,0 +1,10 @@
+/**
+ * Checks whether a file path has a Markdown (`.md`) or MDX (`.mdx`) extension.
+ *
+ * @param filePath - Absolute or relative file path.
+ * @returns `true` when the extension is `.md` or `.mdx`.
+ */
+export const isMarkdownFile = (filePath) => {
+    return filePath.endsWith('.md') || filePath.endsWith('.mdx');
+};
+//# sourceMappingURL=is-markdown-file.js.map

package/dist/esm/utils/markdown/is-markdown-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-markdown-file.js","sourceRoot":"","sources":["../../../../src/utils/markdown/is-markdown-file.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAgB,EAAW,EAAE;IAC1D,OAAO,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC/D,CAAC,CAAC"}

package/dist/esm/utils/markdown/parse-markdown-file.js

@@ -0,0 +1,29 @@
+import { readFileSync } from 'node:fs';
+import { assert } from 'node:console';
+import { isMarkdownFile } from './is-markdown-file.js';
+import { parseMarkdown } from './parse-markdown.js';
+/**
+ * Reads a Markdown or MDX file from disk and parses it into chunked documents.
+ *
+ * Delegates to {@link parseMarkdown} after reading the file content, then
+ * enriches each resulting document with the `rootPath` from the source file.
+ *
+ * @template T - Additional frontmatter attributes.
+ * @param file - Source file descriptor with path and optional project root.
+ * @returns Array of Markdown documents with root-path metadata.
+ * @throws {AssertionError} If the file does not have a `.md` or `.mdx` extension.
+ */
+export const parseMarkdownFile = async (file) => {
+    assert(isMarkdownFile(file.path), `File ${file.path} is not a markdown or MDX file`);
+    const content = readFileSync(file.path, 'utf8');
+    const result = await parseMarkdown(content, file.relativePath ?? file.path);
+    // Enrich each parsed chunk with the file's project root for downstream path resolution
+    return result.map((document) => ({
+        ...document,
+        metadata: {
+            ...document.metadata,
+            rootPath: file.projectRoot,
+        },
+    }));
+};
+//# sourceMappingURL=parse-markdown-file.js.map

package/dist/esm/utils/markdown/parse-markdown-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-markdown-file.js","sourceRoot":"","sources":["../../../../src/utils/markdown/parse-markdown-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAItC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EAGpC,IAAgB,EACgB,EAAE;IAClC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,IAAI,CAAC,IAAI,gCAAgC,CAAC,CAAC;IACrF,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAI,OAAO,EAAE,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/E,uFAAuF;IACvF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC/B,GAAG,QAAQ;QACX,QAAQ,EAAE;YACR,GAAG,QAAQ,CAAC,QAAQ;YACpB,QAAQ,EAAE,IAAI,CAAC,WAAW;SAC3B;KACF,CAAC,CAAC,CAAC;AACN,CAAC,CAAC"}

package/dist/esm/utils/markdown/{parser.js → parse-markdown.js}

@@ -1,5 +1,3 @@
-import { readFileSync } from 'node:fs';
-import { assert } from 'node:console';
 import { default as grayMatter } from 'gray-matter';
 import { RecursiveCharacterTextSplitter } from '@langchain/textsplitters';
 import { generateChunkId } from '../generate-chunk-id.js';
@@ -21,15 +19,6 @@ const markdownConfig = {
     ],
     keepSeparator: true,
 };
-/**
- * Checks whether a file path has a Markdown (`.md`) or MDX (`.mdx`) extension.
- *
- * @param filePath - Absolute or relative file path.
- * @returns `true` when the extension is `.md` or `.mdx`.
- */
-export const isMarkdownFile = (filePath) => {
-    return filePath.endsWith('.md') || filePath.endsWith('.mdx');
-};
 /**
  * Validates that a text chunk contains meaningful content.
  *
@@ -41,6 +30,7 @@ export const isMarkdownFile = (filePath) => {
  */
 const isValidChunk = (chunk) => {
     const trimmed = chunk.trim();
+    // Skip empty or whitespace-only chunks
     if (!trimmed)
         return false;
     // Skip chunks that are only code fence markers
@@ -62,6 +52,7 @@ const isValidChunk = (chunk) => {
  */
 export const parseMarkdown = async (content, source) => {
     const { content: markdownContent, data } = grayMatter(content);
+    // Prefix each frontmatter key with `md_` to namespace it in the document metadata
     const markdownAttributes = Object.entries(data).reduce((acc, [key, value]) => {
         acc[`md_${key}`] = value;
         return acc;
@@ -72,41 +63,21 @@ export const parseMarkdown = async (content, source) => {
     const chunks = await textSplitter.splitText(markdownContent);
     // Filter out empty chunks and chunks that are just code fence markers
     const validChunks = chunks.filter((chunk) => {
+        // Discard invalid chunks; keep everything else
         if (!isValidChunk(chunk)) {
             return false;
         }
         return true;
     });
-    return validChunks.map((chunk, _index) => ({
+    return (validChunks
+        // Wrap each valid chunk into a vector-store-ready document
+        .map((chunk, _index) => ({
         id: generateChunkId(source, _index),
         pageContent: chunk,
         metadata: {
             source,
             attributes: markdownAttributes,
         },
-    }));
-};
-/**
- * Reads a Markdown or MDX file from disk and parses it into chunked documents.
- *
- * Delegates to {@link parseMarkdown} after reading the file content, then
- * enriches each resulting document with the `rootPath` from the source file.
- *
- * @template T - Additional frontmatter attributes.
- * @param file - Source file descriptor with path and optional project root.
- * @returns Array of Markdown documents with root-path metadata.
- * @throws {AssertionError} If the file does not have a `.md` or `.mdx` extension.
- */
-export const parseMarkdownFile = async (file) => {
-    assert(isMarkdownFile(file.path), `File ${file.path} is not a markdown or MDX file`);
-    const content = readFileSync(file.path, 'utf8');
-    const result = await parseMarkdown(content, file.relativePath ?? file.path);
-    return result.map((document) => ({
-        ...document,
-        metadata: {
-            ...document.metadata,
-            rootPath: file.projectRoot,
-        },
-    }));
+    })));
 };
-//# sourceMappingURL=parser.js.map
+//# sourceMappingURL=parse-markdown.js.map

package/dist/esm/utils/markdown/parse-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-markdown.js","sourceRoot":"","sources":["../../../../src/utils/markdown/parse-markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAG1E,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,MAAM,cAAc,GAAG;IACrB,SAAS,EAAE,IAAI;IACf,YAAY,EAAE,GAAG;IACjB,UAAU,EAAE;QACV,MAAM;QACN,OAAO;QACP,QAAQ;QACR,SAAS;QACT,UAAU;QACV,WAAW;QACX,OAAO;QACP,SAAS;QACT,SAAS;QACT,MAAM;QACN,IAAI;KACL;IACD,aAAa,EAAE,IAAI;CACpB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,YAAY,GAAG,CAAC,KAAa,EAAW,EAAE;IAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,uCAAuC;IACvC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,+CAA+C;IAC/C,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAChD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAChC,OAAe,EACf,MAAc,EACkB,EAAE;IAClC,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAC/D,kFAAkF;IAClF,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CACpD,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACpB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC;QACzB,OAAO,GAAG,CAAC;IACb,CAAC,EACD;QACE,IAAI,EAAE,UAAU;KACU,CAC7B,CAAC;IACF,MAAM,YAAY,GAAG,IAAI,8BAA8B,CAAC,cAAc,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IAE7D,sEAAsE;IACtE,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QAC1C,+CAA+C;QAC/C,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,OAAO,CACL,WAAW;QACT,2DAA2D;SAC1D,GAAG,CACF,CAAC,KAAK,EAAE,MAAM,EAAuB,EAAE,CAAC,CAAC;QACvC,EAAE,EAAE,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC;QACnC,WAAW,EAAE,KAAK;QAClB,QAAQ,EAAE;YACR,MAAM;YACN,UAAU,EAAE,kBAAuD;SACpE;KACF,CAAC,CACH,CACJ,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/utils/{embedding-dimensions.js → resolve-embedding-dimensions.js}

@@ -25,8 +25,10 @@ const KNOWN_MODEL_DIMENSIONS = new Map([
  */
 export function resolveEmbeddingDimensions(model, configDimensions) {
     const known = KNOWN_MODEL_DIMENSIONS.get(model);
+    // Known models resolve directly from the lookup map.
     if (known !== undefined)
         return known;
+    // Unknown models fall back to an explicit dimensions override from config.
     if (configDimensions !== undefined)
         return configDimensions;
     const knownModels = [...KNOWN_MODEL_DIMENSIONS.keys()].join(', ');
@@ -34,4 +36,4 @@ export function resolveEmbeddingDimensions(model, configDimensions) {
         `Known models: ${knownModels}. ` +
         'For custom models, set `index.embedding.dimensions` in the config.');
 }
-//# sourceMappingURL=embedding-dimensions.js.map
+//# sourceMappingURL=resolve-embedding-dimensions.js.map

package/dist/esm/utils/resolve-embedding-dimensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-embedding-dimensions.js","sourceRoot":"","sources":["../../../src/utils/resolve-embedding-dimensions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,sBAAsB,GAAgC,IAAI,GAAG,CAAC;IAClE,CAAC,wBAAwB,EAAE,IAAI,CAAC;IAChC,CAAC,wBAAwB,EAAE,IAAI,CAAC;IAChC,CAAC,wBAAwB,EAAE,IAAI,CAAC;CACjC,CAAC,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAAa,EAAE,gBAAyB;IACjF,MAAM,KAAK,GAAG,sBAAsB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChD,qDAAqD;IACrD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAEtC,2EAA2E;IAC3E,IAAI,gBAAgB,KAAK,SAAS;QAAE,OAAO,gBAAgB,CAAC;IAE5D,MAAM,WAAW,GAAG,CAAC,GAAG,sBAAsB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,IAAI,KAAK,CACb,4BAA4B,KAAK,KAAK;QACpC,iBAAiB,WAAW,IAAI;QAChC,oEAAoE,CACvE,CAAC;AACJ,CAAC"}

package/dist/esm/utils/{package-resolver.js → resolve-package.js}

@@ -23,8 +23,10 @@ const packageMap = new Map();
 export async function resolvePackage(filePath) {
     // Check cache: iterate through known package directories
     for (const packageRoot of packageMap.keys()) {
+        // A cached package root that is a prefix of filePath is the closest known package.
         if (filePath.startsWith(packageRoot)) {
             const packageJson = packageMap.get(packageRoot);
+            // Guard: satisfies TypeScript's strict Map#get return type despite the key check above.
             if (packageJson) {
                 return packageJson;
             }
@@ -34,6 +36,7 @@ export async function resolvePackage(filePath) {
     // readPackageUp expects a directory path, not a file path
     const dirPath = dirname(filePath);
     const result = await readPackageUp({ cwd: dirPath, normalize: false });
+    // Cache the resolved package.json so future lookups under the same root are free.
     if (result) {
         // Cache using the package directory (where package.json is located)
         const packageDir = dirname(result.path);
@@ -41,4 +44,4 @@ export async function resolvePackage(filePath) {
     }
     return result?.packageJson;
 }
-//# sourceMappingURL=package-resolver.js.map
+//# sourceMappingURL=resolve-package.js.map

package/dist/esm/utils/resolve-package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-package.js","sourceRoot":"","sources":["../../../src/utils/resolve-package.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAoB,MAAM,iBAAiB,CAAC;AAElE;;;GAGG;AACH,MAAM,UAAU,GAAG,IAAI,GAAG,EAAuB,CAAC;AAElD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,yDAAyD;IACzD,KAAK,MAAM,WAAW,IAAI,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5C,mFAAmF;QACnF,IAAI,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YACrC,MAAM,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAChD,wFAAwF;YACxF,IAAI,WAAW,EAAE,CAAC;gBAChB,OAAO,WAAW,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,0DAA0D;IAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAEvE,kFAAkF;IAClF,IAAI,MAAM,EAAE,CAAC;QACX,oEAAoE;QACpE,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxC,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,MAAM,EAAE,WAAW,CAAC;AAC7B,CAAC"}

package/dist/esm/utils/ts-doc/create-typescript-document.js

@@ -0,0 +1,27 @@
+import { generateChunkId } from '../generate-chunk-id.js';
+/**
+ * Creates a TypescriptDocument from the given parameters.
+ * @param sourceFile - The source file containing the node.
+ * @param pageContent - The content of the document.
+ * @param tsKind - The TypeScript node kind name.
+ * @param tsName - The name of the TypeScript node.
+ * @param options - Optional parsing configuration.
+ * @returns A TypeScript document with metadata.
+ */
+export const createTypescriptDocument = (sourceFile, pageContent, tsKind, tsName, options) => {
+    const source = sourceFile.getFilePath().replace(/^\/+/, '');
+    return {
+        id: generateChunkId(source),
+        pageContent,
+        metadata: {
+            source,
+            ...(options?.projectRoot && { rootPath: options.projectRoot }),
+            attributes: {
+                type: 'tsdoc',
+                ts_kind: tsKind,
+                ts_name: tsName,
+            },
+        },
+    };
+};
+//# sourceMappingURL=create-typescript-document.js.map

package/dist/esm/utils/ts-doc/create-typescript-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-typescript-document.js","sourceRoot":"","sources":["../../../../src/utils/ts-doc/create-typescript-document.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,UAA6B,EAC7B,WAAmB,EACnB,MAAc,EACd,MAAc,EACd,OAA2B,EACP,EAAE;IACtB,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5D,OAAO;QACL,EAAE,EAAE,eAAe,CAAC,MAAM,CAAC;QAC3B,WAAW;QACX,QAAQ,EAAE;YACR,MAAM;YACN,GAAG,CAAC,OAAO,EAAE,WAAW,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;YAC9D,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,MAAM;gBACf,OAAO,EAAE,MAAM;aAChB;SACF;KACF,CAAC;AACJ,CAAC,CAAC"}