@equinor/fusion-framework-cli-plugin-ai-index 1.0.0

package/dist/esm/command.js

@@ -0,0 +1,82 @@
+import { createCommand, createOption } from 'commander';
+import { loadFusionAIConfig, setupFramework } from '@equinor/fusion-framework-cli-plugin-ai-base';
+import { withOptions as withAiOptions } from '@equinor/fusion-framework-cli-plugin-ai-base/command-options';
+import { embed } from './bin/embed.js';
+import { CommandOptionsSchema } from './command.options.js';
+/**
+ * CLI command: `ai embeddings`
+ *
+ * Document embedding utilities for Large Language Model processing.
+ *
+ * Features:
+ * - Markdown/MDX document chunking with frontmatter extraction
+ * - TypeScript/TSX TSDoc extraction and chunking
+ * - Glob pattern support for file collection
+ * - Git diff-based processing for workflow integration
+ * - Dry-run mode for testing without actual processing
+ * - Configurable file patterns via fusion-ai.config.ts
+ *
+ * Usage:
+ *   $ ffc ai embeddings [options] [glob-patterns...]
+ *
+ * Arguments:
+ *   glob-patterns          Glob patterns to match files (optional when using --diff)
+ *                          Defaults to patterns from fusion-ai.config.ts if not provided
+ *
+ * Options:
+ *   --dry-run              Show what would be processed without actually doing it
+ *   --config <config>      Path to a config file (default: fusion-ai.config)
+ *   --diff                 Process only changed files (workflow mode)
+ *   --base-ref <ref>       Git reference to compare against (default: HEAD~1)
+ *   --clean                Delete all existing documents from the vector store before processing
+ *
+ * AI Options (required):
+ *   --openai-api-key <key>              Azure OpenAI API key (or AZURE_OPENAI_API_KEY env var)
+ *   --openai-api-version <version>      Azure OpenAI API version (default: 2024-02-15-preview)
+ *   --openai-instance <name>            Azure OpenAI instance name (or AZURE_OPENAI_INSTANCE_NAME env var)
+ *   --openai-embedding-deployment <name> Azure OpenAI embedding deployment name (or AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME env var)
+ *   --azure-search-endpoint <url>       Azure Search endpoint URL (or AZURE_SEARCH_ENDPOINT env var)
+ *   --azure-search-api-key <key>        Azure Search API key (or AZURE_SEARCH_API_KEY env var)
+ *   --azure-search-index-name <name>    Azure Search index name (or AZURE_SEARCH_INDEX_NAME env var)
+ *
+ * Examples:
+ *   $ ffc ai embeddings --dry-run ./src
+ *   $ ffc ai embeddings "*.ts" "*.md" "*.mdx"
+ *   $ ffc ai embeddings --diff
+ *   $ ffc ai embeddings --diff --base-ref origin/main
+ *   $ ffc ai embeddings --clean "*.ts"
+ */
+const _command = createCommand('embeddings')
+    .description('Document embedding utilities for Large Language Model processing')
+    .addOption(createOption('--dry-run', 'Show what would be processed without actually doing it').default(false))
+    .addOption(createOption('--config <config>', 'Path to a config file').default('fusion-ai.config'))
+    .addOption(createOption('--diff', 'Process only changed files (workflow mode)').default(false))
+    .addOption(createOption('--base-ref <ref>', 'Git reference to compare against').default('HEAD~1'))
+    .addOption(createOption('--clean', 'Delete all existing documents from the vector store before processing').default(false))
+    .argument('[glob-patterns...]', 'Glob patterns to match files (optional when using --diff)')
+    .action(async (patterns, commandOptions) => {
+    const options = await CommandOptionsSchema.parseAsync(commandOptions);
+    // Load configuration
+    const config = await loadFusionAIConfig(options.config, {
+        baseDir: process.cwd(),
+    });
+    // CLI args take precedence over config patterns
+    const indexConfig = config.index ?? {};
+    const allowedFilePatterns = indexConfig.patterns ?? ['**/*.ts', '**/*.md', '**/*.mdx'];
+    const filePatterns = patterns.length ? patterns : allowedFilePatterns;
+    // Initialize framework
+    const framework = await setupFramework(options);
+    // Execute embeddings bin with framework and options
+    await embed({
+        framework,
+        options,
+        config,
+        filePatterns,
+    });
+});
+export const command = withAiOptions(_command, {
+    includeEmbedding: true,
+    includeSearch: true,
+});
+export default command;
+//# sourceMappingURL=command.js.map

package/dist/esm/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAExD,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAClG,OAAO,EAAE,WAAW,IAAI,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAE5G,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAuB,MAAM,sBAAsB,CAAC;AAGjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,QAAQ,GAAG,aAAa,CAAC,YAAY,CAAC;KACzC,WAAW,CAAC,kEAAkE,CAAC;KAC/E,SAAS,CACR,YAAY,CAAC,WAAW,EAAE,wDAAwD,CAAC,CAAC,OAAO,CACzF,KAAK,CACN,CACF;KACA,SAAS,CAAC,YAAY,CAAC,mBAAmB,EAAE,uBAAuB,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;KACjG,SAAS,CAAC,YAAY,CAAC,QAAQ,EAAE,4CAA4C,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;KAC9F,SAAS,CAAC,YAAY,CAAC,kBAAkB,EAAE,kCAAkC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;KACjG,SAAS,CACR,YAAY,CACV,SAAS,EACT,uEAAuE,CACxE,CAAC,OAAO,CAAC,KAAK,CAAC,CACjB;KACA,QAAQ,CAAC,oBAAoB,EAAE,2DAA2D,CAAC;KAC3F,MAAM,CAAC,KAAK,EAAE,QAAkB,EAAE,cAA8B,EAAE,EAAE;IACnE,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;IAEtE,qBAAqB;IACrB,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAA0B,OAAO,CAAC,MAAM,EAAE;QAC/E,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE;KACvB,CAAC,CAAC;IAEH,gDAAgD;IAChD,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IACvC,MAAM,mBAAmB,GAAG,WAAW,CAAC,QAAQ,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IACvF,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC;IAEtE,uBAAuB;IACvB,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IAEhD,oDAAoD;IACpD,MAAM,KAAK,CAAC;QACV,SAAS;QACT,OAAO;QACP,MAAM;QACN,YAAY;KACb,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,EAAE;IAC7C,gBAAgB,EAAE,IAAI;IACtB,aAAa,EAAE,IAAI;CACpB,CAAC,CAAC;AAEH,eAAe,OAAO,CAAC"}

package/dist/esm/command.options.js

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import { AiOptionsSchema } from '@equinor/fusion-framework-cli-plugin-ai-base/command-options';
+/**
+ * Zod schema for validating command options for the embeddings command.
+ *
+ * This schema extends the base AI options schema with embeddings-specific options,
+ * ensuring type safety and runtime validation of command arguments.
+ *
+ * Note: Some optional AI options become required for the embeddings command
+ * (openaiEmbeddingDeployment, azureSearchEndpoint, azureSearchApiKey, azureSearchIndexName)
+ * because the command uses withAiOptions with includeEmbedding and includeSearch set to true.
+ */
+export const CommandOptionsSchema = AiOptionsSchema.extend({
+    // Override optional AI options to make them required for embeddings command
+    openaiEmbeddingDeployment: z
+        .string({ message: 'Embedding deployment name is required for embeddings command.' })
+        .min(1, 'Embedding deployment name must be a non-empty string.')
+        .describe('Azure OpenAI embedding deployment name'),
+    azureSearchEndpoint: z
+        .string({ message: 'Azure Search endpoint is required for embeddings command.' })
+        .url('Azure Search endpoint must be a valid URL.')
+        .min(1, 'Azure Search endpoint must be a non-empty string.')
+        .describe('Azure Search endpoint URL'),
+    azureSearchApiKey: z
+        .string({ message: 'Azure Search API key is required for embeddings command.' })
+        .min(1, 'Azure Search API key must be a non-empty string.')
+        .describe('Azure Search API key'),
+    azureSearchIndexName: z
+        .string({ message: 'Azure Search index name is required for embeddings command.' })
+        .min(1, 'Azure Search index name must be a non-empty string.')
+        .describe('Azure Search index name'),
+    // Embeddings-specific options
+    dryRun: z
+        .boolean({ message: 'dryRun must be a boolean value.' })
+        .describe('Show what would be processed without actually doing it'),
+    config: z
+        .string({ message: 'Config file path is required and must be a non-empty string.' })
+        .min(1, 'Config file path must be a non-empty string.')
+        .describe('Path to a config file'),
+    diff: z
+        .boolean({ message: 'diff must be a boolean value.' })
+        .describe('Process only changed files (workflow mode)'),
+    baseRef: z.string().min(1).optional().describe('Git reference to compare against'),
+    clean: z
+        .boolean({ message: 'clean must be a boolean value.' })
+        .describe('Delete all existing documents from the vector store before processing'),
+}).describe('Command options for the embeddings command');
+//# sourceMappingURL=command.options.js.map

package/dist/esm/command.options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.options.js","sourceRoot":"","sources":["../../src/command.options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,8DAA8D,CAAC;AAE/F;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,CAAC,MAAM,CAAC;IACzD,4EAA4E;IAC5E,yBAAyB,EAAE,CAAC;SACzB,MAAM,CAAC,EAAE,OAAO,EAAE,+DAA+D,EAAE,CAAC;SACpF,GAAG,CAAC,CAAC,EAAE,uDAAuD,CAAC;SAC/D,QAAQ,CAAC,wCAAwC,CAAC;IACrD,mBAAmB,EAAE,CAAC;SACnB,MAAM,CAAC,EAAE,OAAO,EAAE,2DAA2D,EAAE,CAAC;SAChF,GAAG,CAAC,4CAA4C,CAAC;SACjD,GAAG,CAAC,CAAC,EAAE,mDAAmD,CAAC;SAC3D,QAAQ,CAAC,2BAA2B,CAAC;IACxC,iBAAiB,EAAE,CAAC;SACjB,MAAM,CAAC,EAAE,OAAO,EAAE,0DAA0D,EAAE,CAAC;SAC/E,GAAG,CAAC,CAAC,EAAE,kDAAkD,CAAC;SAC1D,QAAQ,CAAC,sBAAsB,CAAC;IACnC,oBAAoB,EAAE,CAAC;SACpB,MAAM,CAAC,EAAE,OAAO,EAAE,6DAA6D,EAAE,CAAC;SAClF,GAAG,CAAC,CAAC,EAAE,qDAAqD,CAAC;SAC7D,QAAQ,CAAC,yBAAyB,CAAC;IAEtC,8BAA8B;IAC9B,MAAM,EAAE,CAAC;SACN,OAAO,CAAC,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;SACvD,QAAQ,CAAC,wDAAwD,CAAC;IACrE,MAAM,EAAE,CAAC;SACN,MAAM,CAAC,EAAE,OAAO,EAAE,8DAA8D,EAAE,CAAC;SACnF,GAAG,CAAC,CAAC,EAAE,8CAA8C,CAAC;SACtD,QAAQ,CAAC,uBAAuB,CAAC;IACpC,IAAI,EAAE,CAAC;SACJ,OAAO,CAAC,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;SACrD,QAAQ,CAAC,4CAA4C,CAAC;IACzD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAClF,KAAK,EAAE,CAAC;SACL,OAAO,CAAC,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC;SACtD,QAAQ,CAAC,uEAAuE,CAAC;CACrF,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC,CAAC"}

package/dist/esm/config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.js.map

package/dist/esm/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":""}

package/dist/esm/index.js

@@ -0,0 +1,13 @@
+import { registerAiPlugin as registerAiPluginBase } from '@equinor/fusion-framework-cli-plugin-ai-base';
+import { command as embeddingsCommand } from './command.js';
+/**
+ * Registers the AI index plugin command with the CLI program
+ * @param program - The Commander program instance to register commands with
+ */
+export function registerAiPlugin(program) {
+    registerAiPluginBase(program, embeddingsCommand);
+}
+export default registerAiPlugin;
+// Re-export config utilities for convenience
+export { configureFusionAI, } from '@equinor/fusion-framework-cli-plugin-ai-base';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,IAAI,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACxG,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAE5D;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;AACnD,CAAC;AAED,eAAe,gBAAgB,CAAC;AAEhC,6CAA6C;AAC7C,OAAO,EACL,iBAAiB,GAElB,MAAM,8CAA8C,CAAC"}

package/dist/esm/utils/generate-chunk-id.js

@@ -0,0 +1,18 @@
+/**
+ * Generates a unique identifier for a document chunk based on file path
+ * Creates a deterministic, URL-safe hash from the file path for validation and checks
+ * @param filePath - The file path to generate an ID from
+ * @param chunkIndex - Optional chunk index to append for multi-chunk documents
+ * @returns A base64-encoded hash of the file path, optionally suffixed with chunk index
+ */
+export const generateChunkId = (filePath, chunkIndex) => {
+    // Convert file path to base64 and remove non-alphanumeric characters
+    // This creates a stable, URL-safe identifier from the file path
+    // The deterministic nature allows for validation and duplicate detection
+    const pathHash = Buffer.from(filePath)
+        .toString('base64')
+        .replace(/[^a-zA-Z0-9]/g, '');
+    // Append chunk index if provided to distinguish multiple chunks from the same file
+    return chunkIndex ? `${pathHash}-${chunkIndex}` : pathHash;
+};
+//# sourceMappingURL=generate-chunk-id.js.map

package/dist/esm/utils/generate-chunk-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-chunk-id.js","sourceRoot":"","sources":["../../../src/utils/generate-chunk-id.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAgB,EAAE,UAAmB,EAAU,EAAE;IAC/E,qEAAqE;IACrE,gEAAgE;IAChE,yEAAyE;IACzE,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;SACnC,QAAQ,CAAC,QAAQ,CAAC;SAClB,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAChC,mFAAmF;IACnF,OAAO,UAAU,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC7D,CAAC,CAAC"}

package/dist/esm/utils/git/file-changes.js

@@ -0,0 +1,196 @@
+import { join, relative } from 'node:path';
+import { resolveProjectRoot, getGit } from './git-client.js';
+/**
+ * Get list of changed files using git diff with status
+ * @param options - Git diff configuration options
+ * @returns Array of changed files with their status
+ */
+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)}`);
+    }
+};
+/**
+ * Determine the git status of a file, including handling renames
+ * Returns an array of ChangedFile objects - if the file was renamed, returns both old and new paths
+ * @param filePath - Absolute file path to check
+ * @returns Promise resolving to array of changed files (1 or 2 items if renamed)
+ */
+export const getFileStatus = async (filePath) => {
+    const { git, gitRepoPath } = getGit(filePath) ?? {};
+    if (!git || !gitRepoPath) {
+        // Not in a git repository, assume new
+        return [{ filepath: filePath, status: 'new' }];
+    }
+    const gitFilePath = relative(gitRepoPath, filePath);
+    // Normalize path separators for git commands (git uses forward slashes on all platforms)
+    const normalizedGitFilePath = gitFilePath.replace(/\\/g, '/');
+    try {
+        // First check if file is tracked in git at the current path
+        const isTracked = await git
+            .raw(['ls-files', '--error-unmatch', normalizedGitFilePath])
+            .then(() => true)
+            .catch(() => false);
+        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
+        // This is much faster than checking full status or history
+        try {
+            const fileStatusOutput = await git.raw([
+                'status',
+                '--porcelain',
+                '--',
+                normalizedGitFilePath,
+            ]);
+            const trimmed = fileStatusOutput.trim();
+            if (trimmed.length > 0) {
+                // If status shows ??, it's untracked (truly new)
+                if (/^\?\?/.test(trimmed)) {
+                    return [{ filepath: filePath, status: 'new' }];
+                }
+            }
+        }
+        catch {
+            // If status check fails, continue to rename/history checks
+        }
+        // File is not tracked and not explicitly untracked - check if it's a rename
+        // Only do expensive checks if we haven't determined status yet
+        try {
+            // Get full git status to check for renames (only if needed)
+            const statusOutput = await git.raw(['status', '--porcelain']);
+            const lines = statusOutput.split('\n').filter((line) => line.trim() !== '');
+            for (const line of lines) {
+                // Check for rename format: "R100\told.ts\tnew.ts"
+                const renameMatch = line.match(/^R\d+\s+(.+?)\s+(.+)$/);
+                if (renameMatch) {
+                    const [, oldPath, newPath] = renameMatch;
+                    const oldFullPath = join(gitRepoPath, oldPath);
+                    const newFullPath = join(gitRepoPath, newPath);
+                    // Check if the current file is the new path in a rename
+                    if (newFullPath === filePath) {
+                        return [
+                            { filepath: oldFullPath, status: 'removed' },
+                            { filepath: newFullPath, status: 'new' },
+                        ];
+                    }
+                }
+                // Check for copy format: "C100\told.ts\tnew.ts" (similar to rename)
+                const copyMatch = line.match(/^C\d+\s+(.+?)\s+(.+)$/);
+                if (copyMatch) {
+                    const [, , newPath] = copyMatch;
+                    const newFullPath = join(gitRepoPath, newPath);
+                    // For copies, the old file still exists, so only return the new one
+                    if (newFullPath === filePath) {
+                        return [{ filepath: newFullPath, status: 'new' }];
+                    }
+                }
+            }
+        }
+        catch {
+            // If status check fails, continue to history check
+        }
+        // Last resort: check if file content exists in git history (very slow, only if needed)
+        // Use --follow to track renames, limit to 1 commit for performance
+        try {
+            const hasHistory = await git
+                .raw([
+                'log',
+                '--all',
+                '--full-history',
+                '--follow',
+                '--oneline',
+                '-1',
+                '--',
+                normalizedGitFilePath,
+            ])
+                .then((output) => output.trim().length > 0)
+                .catch(() => false);
+            // If file has history but isn't tracked, it might have been moved
+            // For now, treat as 'new' at the new location
+            // Note: We can't easily find the old path without more complex git operations
+            return [{ filepath: filePath, status: hasHistory ? 'modified' : 'new' }];
+        }
+        catch {
+            // If we can't determine, default to 'new'
+            return [{ filepath: filePath, status: 'new' }];
+        }
+    }
+    catch {
+        // If we can't determine status, default to 'new'
+        return [{ filepath: filePath, status: 'new' }];
+    }
+};
+/**
+ * Check if a file path matches any of the changed files
+ * @param filePath - File path to check
+ * @param changedFiles - Array of changed file objects
+ * @returns True if file has changed
+ */
+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

package/dist/esm/utils/git/file-changes.js.map

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

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

@@ -0,0 +1,39 @@
+import { simpleGit } from 'simple-git';
+import { findUpSync } from 'find-up';
+import { dirname, join } from 'node:path';
+import { existsSync } from 'node:fs';
+const gitCache = new Map();
+/**
+ * Resolve the project root (git repository root) for a given file path
+ * @param filePath - File path to resolve from
+ * @returns Project root path or undefined if not in a git repository
+ */
+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;
+};
+/**
+ * Get or create a SimpleGit instance for a given file path
+ * Uses caching to avoid creating multiple instances for the same repository
+ * @param filePath - File path to get git instance for
+ * @returns Git instance and repository path, or undefined if not in a git repository
+ */
+export const getGit = (filePath) => {
+    const gitRepoPath = resolveProjectRoot(filePath);
+    if (gitRepoPath) {
+        if (!gitCache.has(gitRepoPath)) {
+            gitCache.set(gitRepoPath, simpleGit(gitRepoPath));
+        }
+        return {
+            git: gitCache.get(gitRepoPath),
+            gitRepoPath,
+        };
+    }
+    return undefined;
+};
+//# sourceMappingURL=git-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-client.js","sourceRoot":"","sources":["../../../../src/utils/git/git-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAkB,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAqB,CAAC;AAE9C;;;;GAIG;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;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,QAAgB,EACiD,EAAE;IACnE,MAAM,WAAW,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,WAAW,EAAE,CAAC;QAChB,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

@@ -0,0 +1,9 @@
+// Re-export git client utilities
+export { resolveProjectRoot, getGit } from './git-client.js';
+// Re-export metadata functions
+export { extractGitMetadata } from './metadata.js';
+// Re-export file change functions
+export { getChangedFiles, getFileStatus, isFileChanged } from './file-changes.js';
+// Re-export status functions
+export { getGitStatus } from './status.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,41 @@
+import { relative } from 'node:path';
+import { getGit } from './git-client.js';
+/**
+ * Generate a GitHub permalink for a file
+ * @param gitRemoteUrl - Git remote URL
+ * @param filePath - Relative file path from repository root
+ * @param slug - Git reference (branch/tag/commit), defaults to 'main'
+ * @returns GitHub permalink URL or undefined if not a GitHub repository
+ * @internal
+ */
+const generateGithubPermalink = (gitRemoteUrl, filePath, slug) => {
+    const githubMatch = gitRemoteUrl.match(/github\.com[:/]([^/]+)\/([^/.]+)(?:\.git)?$/);
+    if (githubMatch) {
+        const [, owner, repo] = githubMatch;
+        return `https://github.com/${owner}/${repo}/blob/${slug ?? 'main'}/${filePath}`;
+    }
+    return undefined;
+};
+/**
+ * Extract git metadata for a file
+ * @param filePath - Absolute file path
+ * @returns Git metadata or undefined if not in a git repository
+ */
+export const extractGitMetadata = async (filePath) => {
+    const { git, gitRepoPath: gitRepoRoot } = getGit(filePath) ?? {};
+    if (!git || !gitRepoRoot) {
+        return undefined;
+    }
+    const gitFilePath = relative(gitRepoRoot, filePath);
+    const { latest } = await git.log({ file: gitFilePath, maxCount: 1 });
+    const gitRemoteUrl = await git
+        .getConfig('remote.origin.url')
+        .then(({ value }) => value ?? undefined);
+    const git_link = gitRemoteUrl ? generateGithubPermalink(gitRemoteUrl, gitFilePath) : undefined;
+    return {
+        git_link,
+        git_commit_hash: latest?.hash,
+        git_commit_date: latest?.date,
+    };
+};
+//# sourceMappingURL=metadata.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../../src/utils/git/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC;;;;;;;GAOG;AACH,MAAM,uBAAuB,GAAG,CAC9B,YAAoB,EACpB,QAAgB,EAChB,IAAa,EACO,EAAE;IACtB,MAAM,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACtF,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,WAAW,CAAC;QACpC,OAAO,sBAAsB,KAAK,IAAI,IAAI,SAAS,IAAI,IAAI,MAAM,IAAI,QAAQ,EAAE,CAAC;IAClF,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EAAE,QAAgB,EAAoC,EAAE;IAC7F,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACjE,IAAI,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACpD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;IACrE,MAAM,YAAY,GAAG,MAAM,GAAG;SAC3B,SAAS,CAAC,mBAAmB,CAAC;SAC9B,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAC,uBAAuB,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/F,OAAO;QACL,QAAQ;QACR,eAAe,EAAE,MAAM,EAAE,IAAI;QAC7B,eAAe,EAAE,MAAM,EAAE,IAAI;KAC9B,CAAC;AACJ,CAAC,CAAC"}

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

@@ -0,0 +1,34 @@
+import { resolveProjectRoot, getGit } from './git-client.js';
+/**
+ * Get git status information for debugging
+ * @param cwd - Working directory
+ * @returns Git status information
+ */
+export const getGitStatus = async (cwd = process.cwd()) => {
+    const projectRoot = resolveProjectRoot(cwd);
+    if (!projectRoot) {
+        throw new Error('Not in a git repository');
+    }
+    const { git } = getGit(cwd) ?? {};
+    if (!git) {
+        throw new Error('Failed to initialize git client');
+    }
+    try {
+        const branch = await git.revparse(['--abbrev-ref', 'HEAD']);
+        const commit = await git.revparse(['--short', 'HEAD']);
+        const statusResult = await git.status();
+        const stagedFiles = statusResult.staged.length;
+        const unstagedFiles = statusResult.modified.length + statusResult.deleted.length + statusResult.not_added.length;
+        return {
+            branch: branch.trim(),
+            commit: commit.trim(),
+            hasChanges: stagedFiles > 0 || unstagedFiles > 0,
+            stagedFiles,
+            unstagedFiles,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to get git status: ${error instanceof Error ? error.message : String(error)}`);
+    }
+};
+//# sourceMappingURL=status.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../../src/utils/git/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAC/B,MAAc,OAAO,CAAC,GAAG,EAAE,EAO1B,EAAE;IACH,MAAM,WAAW,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC5C,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,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/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/utils/git/types.ts"],"names":[],"mappings":""}

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

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

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

@@ -0,0 +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"}

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

@@ -0,0 +1,72 @@
+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';
+const markdownConfig = {
+    chunkSize: 3000,
+    chunkOverlap: 300,
+    keepSeparator: true,
+    separators: [
+        '\n# ',
+        '\n## ',
+        '\n### ',
+        '\n#### ',
+        '\n##### ',
+        '\n###### ',
+        '\n```',
+        '\n---\n',
+        '\n\n',
+    ],
+};
+/**
+ * Check if a file is a markdown or MDX file
+ * @param filePath - File path to check
+ * @returns True if file has .md or .mdx extension
+ */
+export const isMarkdownFile = (filePath) => {
+    return filePath.endsWith('.md') || filePath.endsWith('.mdx');
+};
+/**
+ * Parse markdown or MDX content into document chunks
+ * @param content - Markdown or MDX content string
+ * @param source - Source file path
+ * @returns Array of markdown documents
+ */
+export const parseMarkdown = async (content, source) => {
+    const { content: markdownContent, data } = grayMatter(content);
+    const markdownAttributes = Object.entries(data).reduce((acc, [key, value]) => {
+        acc[`md_${key}`] = value;
+        return acc;
+    }, {
+        type: 'markdown',
+    });
+    const textSplitter = new RecursiveCharacterTextSplitter(markdownConfig);
+    const chunks = await textSplitter.splitText(markdownContent);
+    return chunks.map((chunk, _index) => ({
+        id: generateChunkId(source, _index),
+        pageContent: chunk,
+        metadata: {
+            source,
+            attributes: markdownAttributes,
+        },
+    }));
+};
+/**
+ * Parse a markdown or MDX file into document chunks
+ * @param file - Source file object
+ * @returns Array of markdown documents with root path metadata
+ */
+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

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../../src/utils/markdown/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAI1E,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,MAAM,cAAc,GAAG;IACrB,SAAS,EAAE,IAAI;IACf,YAAY,EAAE,GAAG;IACjB,aAAa,EAAE,IAAI;IACnB,UAAU,EAAE;QACV,MAAM;QACN,OAAO;QACP,QAAQ;QACR,SAAS;QACT,UAAU;QACV,WAAW;QACX,OAAO;QACP,SAAS;QACT,MAAM;KACP;CACF,CAAC;AAEF;;;;GAIG;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;AAEF;;;;;GAKG;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,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;IAC7D,OAAO,MAAM,CAAC,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,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;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,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"}