@bhimudev/gnanai 0.4.0

package/dist/utils/update-config-ci.js

@@ -0,0 +1,72 @@
+import fs from "fs-extra";
+import { logger } from "./logger.js";
+/**
+ * Build the CI/CD section content for archai.config.md.
+ */
+function buildCISection(result) {
+    if (result.provider === "none") {
+        return `## CI/CD\n\nNo CI provider detected. Run \`archai setup --ci\` after configuring your CI pipeline.\n`;
+    }
+    const config = result.config;
+    return `## CI/CD\n\n**CI Provider:** ${config.provider}\n**Auth Method:** ${config.authMethod}\n**Timeout:** ${config.timeout}\n**Detected Via:** ${result.detectedVia}\n`;
+}
+/**
+ * Update archai.config.md with a CI/CD section.
+ * If the section already exists, replaces it. Otherwise inserts before ## Notes.
+ */
+export async function updateConfigWithCI(result) {
+    const configPath = "archai.config.md";
+    if (!(await fs.pathExists(configPath))) {
+        logger.warn("archai.config.md not found. Run `archai init` first.");
+        return;
+    }
+    let content = await fs.readFile(configPath, "utf-8");
+    const ciSection = buildCISection(result);
+    // Strategy 1: Replace existing ## CI/CD section
+    const sectionRegex = /## CI\/CD[\s\S]*?(?=\n---\n|\n## |$)/;
+    if (sectionRegex.test(content)) {
+        content = content.replace(sectionRegex, ciSection.trimEnd());
+        logger.debug("Replaced existing CI/CD section");
+    }
+    else {
+        // Strategy 2: Replace the setup --ci placeholder
+        const placeholderRegex = /\[Run.*archai setup --ci.*to auto-configure\]/;
+        if (placeholderRegex.test(content)) {
+            // Replace the entire CI/CD section header + placeholder
+            const fullPlaceholderRegex = /## CI\/CD[\s\S]*?\[Run.*archai setup --ci.*to auto-configure\]/;
+            if (fullPlaceholderRegex.test(content)) {
+                content = content.replace(fullPlaceholderRegex, ciSection.trimEnd());
+            }
+            else {
+                content = content.replace(placeholderRegex, ciSection.trimEnd());
+            }
+            logger.debug("Replaced CI/CD placeholder");
+        }
+        else {
+            // Strategy 3: Insert before ## Notes
+            const notesIndex = content.indexOf("## Notes");
+            if (notesIndex !== -1) {
+                const beforeNotes = content.lastIndexOf("---", notesIndex);
+                if (beforeNotes !== -1) {
+                    content = content.slice(0, beforeNotes) +
+                        "---\n\n" + ciSection + "\n" +
+                        content.slice(beforeNotes);
+                }
+                else {
+                    content = content.slice(0, notesIndex) +
+                        ciSection + "\n---\n\n" +
+                        content.slice(notesIndex);
+                }
+            }
+            else {
+                // Append at end
+                if (!content.endsWith("\n"))
+                    content += "\n";
+                content += "\n---\n\n" + ciSection;
+            }
+            logger.debug("Inserted new CI/CD section");
+        }
+    }
+    await fs.writeFile(configPath, content);
+}
+//# sourceMappingURL=update-config-ci.js.map

package/dist/utils/update-config-ci.js.map

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

package/dist/utils/update-config-git.d.ts

@@ -0,0 +1,18 @@
+import type { GitConfig, GitPatterns } from '../types/index.js';
+/**
+ * Update archai.config.md with a Git Configuration section.
+ * If the section already exists, replaces it. Otherwise inserts before ## Notes.
+ */
+export declare function updateConfigWithGit(gitConfig: GitConfig): Promise<void>;
+/**
+ * Update archai.config.md with a Git Conventions section.
+ * Returns true if the section was written, false if skipped.
+ *
+ * Behavior:
+ * - force=true (setup): always replaces existing section
+ * - force=false (update): only writes if section is missing or contains placeholder text
+ */
+export declare function updateConfigWithGitConventions(patterns: GitPatterns, options?: {
+    force?: boolean;
+}): Promise<boolean>;
+//# sourceMappingURL=update-config-git.d.ts.map

package/dist/utils/update-config-git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-config-git.d.ts","sourceRoot":"","sources":["../../src/utils/update-config-git.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAmD7E;AAwBD;;;;;;;GAOG;AACH,wBAAsB,8BAA8B,CAClD,QAAQ,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5B,OAAO,CAAC,OAAO,CAAC,CAiElB"}

package/dist/utils/update-config-git.js

@@ -0,0 +1,146 @@
+import fs from 'fs-extra';
+import { logger } from './logger.js';
+/**
+ * Update archai.config.md with a Git Configuration section.
+ * If the section already exists, replaces it. Otherwise inserts before ## Notes.
+ */
+export async function updateConfigWithGit(gitConfig) {
+    const configPath = 'archai.config.md';
+    if (!await fs.pathExists(configPath)) {
+        logger.warn('archai.config.md not found. Run `archai init` first.');
+        return;
+    }
+    let content = await fs.readFile(configPath, 'utf-8');
+    const remoteDisplay = gitConfig.remote && gitConfig.remoteUrl
+        ? `${gitConfig.remote} (${gitConfig.remoteUrl})`
+        : 'none configured';
+    const gitSection = `## Git Configuration
+
+**Default Branch:** ${gitConfig.defaultBranch}
+**Remote:** ${remoteDisplay}
+**Branch Convention:** ${gitConfig.branchConvention}
+`;
+    // Check if section already exists
+    const sectionRegex = /## Git Configuration\n[\s\S]*?(?=\n## |\n---\n## |$)/;
+    if (sectionRegex.test(content)) {
+        // Replace existing section
+        content = content.replace(sectionRegex, gitSection.trimEnd());
+        logger.debug('Replaced existing Git Configuration section');
+    }
+    else {
+        // Insert before ## Notes section, or before the final ---\n\n## Notes
+        const notesIndex = content.indexOf('## Notes');
+        if (notesIndex !== -1) {
+            // Find the --- before ## Notes
+            const beforeNotes = content.lastIndexOf('---', notesIndex);
+            if (beforeNotes !== -1) {
+                content = content.slice(0, beforeNotes) +
+                    '---\n\n' + gitSection + '\n' +
+                    content.slice(beforeNotes);
+            }
+            else {
+                content = content.slice(0, notesIndex) +
+                    gitSection + '\n---\n\n' +
+                    content.slice(notesIndex);
+            }
+        }
+        else {
+            // Append at end
+            if (!content.endsWith('\n'))
+                content += '\n';
+            content += '\n---\n\n' + gitSection;
+        }
+        logger.debug('Inserted new Git Configuration section');
+    }
+    await fs.writeFile(configPath, content);
+}
+/**
+ * Build the markdown section content for Git Conventions.
+ */
+function buildGitConventionsSection(patterns) {
+    const prefixList = patterns.detectedPrefixes.length > 0
+        ? patterns.detectedPrefixes.join(', ')
+        : 'none';
+    const prPlatform = patterns.prPlatform || 'none';
+    const usesPRs = patterns.usesPullRequests ? 'Yes' : 'No';
+    return `## Git Conventions
+
+**Branch Convention:** ${patterns.agentBranchConvention}
+**Target Branch:** ${patterns.targetBranch}
+**Merge Strategy:** ${patterns.mergeStrategy}
+**Uses PRs/MRs:** ${usesPRs}
+**PR Platform:** ${prPlatform}
+**Detected Prefixes:** ${prefixList}
+**Branches Analyzed:** ${patterns.branchesAnalyzed}
+**Merge Commits Analyzed:** ${patterns.mergeCommitsAnalyzed}`;
+}
+/**
+ * Update archai.config.md with a Git Conventions section.
+ * Returns true if the section was written, false if skipped.
+ *
+ * Behavior:
+ * - force=true (setup): always replaces existing section
+ * - force=false (update): only writes if section is missing or contains placeholder text
+ */
+export async function updateConfigWithGitConventions(patterns, options) {
+    const configPath = 'archai.config.md';
+    const force = options?.force ?? false;
+    if (!await fs.pathExists(configPath)) {
+        logger.warn('archai.config.md not found. Run archai init first.');
+        return false;
+    }
+    let content = await fs.readFile(configPath, 'utf-8');
+    const sectionRegex = /## Git Conventions\n[\s\S]*?(?=\n---\n|\n## |$)/;
+    const existingSection = content.match(sectionRegex);
+    if (existingSection) {
+        // Section exists
+        const sectionContent = existingSection[0];
+        const isPlaceholder = /\[Run.*archai setup.*to auto-configure\]/.test(sectionContent);
+        if (!force && !isPlaceholder) {
+            // Non-force mode and section has real content -- preserve user edits
+            logger.debug('Git Conventions section already configured, skipping');
+            return false;
+        }
+        // Replace existing section
+        const newSection = buildGitConventionsSection(patterns);
+        content = content.replace(sectionRegex, newSection.trimEnd());
+        logger.debug('Replaced existing Git Conventions section');
+    }
+    else {
+        // Section does not exist -- insert it
+        const newSection = buildGitConventionsSection(patterns);
+        // Find insertion point: before ## CI/CD, ## MCP Servers, or ## Notes
+        let insertBefore = -1;
+        for (const marker of ['## CI/CD', '## MCP Servers', '## Notes']) {
+            const idx = content.indexOf(marker);
+            if (idx !== -1) {
+                insertBefore = idx;
+                break;
+            }
+        }
+        if (insertBefore !== -1) {
+            // Find the --- before the insertion point
+            const beforeSep = content.lastIndexOf('---', insertBefore);
+            if (beforeSep !== -1) {
+                content = content.slice(0, beforeSep) +
+                    '---\n' + newSection + '\n\n' +
+                    content.slice(beforeSep);
+            }
+            else {
+                content = content.slice(0, insertBefore) +
+                    newSection + '\n\n---\n\n' +
+                    content.slice(insertBefore);
+            }
+        }
+        else {
+            // Append at end
+            if (!content.endsWith('\n'))
+                content += '\n';
+            content += '\n---\n' + newSection + '\n';
+        }
+        logger.debug('Inserted new Git Conventions section');
+    }
+    await fs.writeFile(configPath, content);
+    return true;
+}
+//# sourceMappingURL=update-config-git.js.map

package/dist/utils/update-config-git.js.map

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

package/dist/utils/update-config-mcp.d.ts

@@ -0,0 +1,7 @@
+import type { McpConfig } from '../types/index.js';
+/**
+ * Update archai.config.md with MCP server configuration.
+ * Replaces the existing MCP section or [TODO] placeholder.
+ */
+export declare function updateConfigWithMcp(config: McpConfig): Promise<void>;
+//# sourceMappingURL=update-config-mcp.d.ts.map

package/dist/utils/update-config-mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-config-mcp.d.ts","sourceRoot":"","sources":["../../src/utils/update-config-mcp.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CA+D1E"}

package/dist/utils/update-config-mcp.js

@@ -0,0 +1,98 @@
+import fs from 'fs-extra';
+import { logger } from './logger.js';
+/**
+ * Update archai.config.md with MCP server configuration.
+ * Replaces the existing MCP section or [TODO] placeholder.
+ */
+export async function updateConfigWithMcp(config) {
+    const configPath = 'archai.config.md';
+    if (!await fs.pathExists(configPath)) {
+        logger.warn('archai.config.md not found. Run `archai init` first.');
+        return;
+    }
+    let content = await fs.readFile(configPath, 'utf-8');
+    const mcpSection = buildMcpSection(config);
+    // Try to replace existing MCP section
+    // Match "## MCP Servers & Skills" up to the next "---" separator or end of file
+    const sectionRegex = /## MCP Servers & Skills[\s\S]*?(?=\n---\n|$)/;
+    if (sectionRegex.test(content)) {
+        content = content.replace(sectionRegex, mcpSection.trimEnd());
+        logger.debug('Replaced existing MCP Servers & Skills section');
+    }
+    else {
+        // Try to find and replace [TODO: Configure MCP servers if needed]
+        const todoIndex = content.indexOf('[TODO: Configure MCP servers if needed]');
+        if (todoIndex !== -1) {
+            content = content.replace('[TODO: Configure MCP servers if needed]', mcpSection.trimEnd());
+            logger.debug('Replaced MCP TODO placeholder');
+        }
+        else {
+            // Try to find the archai setup --mcp placeholder
+            const setupPlaceholder = content.indexOf('[Run `archai setup --mcp` to auto-configure]');
+            if (setupPlaceholder !== -1) {
+                // Find the section header before it
+                const headerBefore = content.lastIndexOf('## MCP Servers & Skills', setupPlaceholder);
+                if (headerBefore !== -1) {
+                    // Replace from header to just after the placeholder line
+                    const placeholderEnd = content.indexOf('\n', setupPlaceholder);
+                    const endIndex = placeholderEnd !== -1 ? placeholderEnd : content.length;
+                    // Also capture any comment block between header and placeholder
+                    content = content.slice(0, headerBefore) + mcpSection.trimEnd() + content.slice(endIndex);
+                    logger.debug('Replaced MCP setup placeholder section');
+                }
+            }
+            else {
+                // Insert before ## Notes or append
+                const notesIndex = content.indexOf('## Notes');
+                if (notesIndex !== -1) {
+                    const beforeNotes = content.lastIndexOf('---', notesIndex);
+                    if (beforeNotes !== -1) {
+                        content = content.slice(0, beforeNotes) +
+                            '---\n\n' + mcpSection + '\n' +
+                            content.slice(beforeNotes);
+                    }
+                    else {
+                        content = content.slice(0, notesIndex) +
+                            mcpSection + '\n---\n\n' +
+                            content.slice(notesIndex);
+                    }
+                }
+                else {
+                    if (!content.endsWith('\n'))
+                        content += '\n';
+                    content += '\n---\n\n' + mcpSection;
+                }
+                logger.debug('Inserted new MCP Servers & Skills section');
+            }
+        }
+    }
+    await fs.writeFile(configPath, content);
+}
+/**
+ * Build the MCP section markdown string.
+ */
+function buildMcpSection(config) {
+    const lines = ['## MCP Servers & Skills', ''];
+    if (config.taskManager) {
+        const tm = config.taskManager;
+        lines.push(`### Task Manager: ${tm.provider}`);
+        lines.push(`- **Provider:** ${tm.provider}`);
+        lines.push(`- **Board:** ${tm.board.name} (ID: ${tm.board.id})`);
+        lines.push(`- **Mapping:** Epic → ${tm.mapping.epic}, Task → ${tm.mapping.task}, Subtask → ${tm.mapping.subtask}`);
+        lines.push(`- **Status Flow:** ${tm.mapping.statuses.join(' → ')}`);
+        lines.push('');
+    }
+    if (config.otherServers.length > 0) {
+        lines.push('### Other MCP Servers');
+        for (const server of config.otherServers) {
+            lines.push(`- ${server.name} (${server.status})`);
+        }
+        lines.push('');
+    }
+    if (!config.taskManager && config.otherServers.length === 0) {
+        lines.push('[No MCP servers configured. Run `archai setup --mcp` to detect and configure.]');
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=update-config-mcp.js.map

package/dist/utils/update-config-mcp.js.map

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

package/dist/utils/validate-config.d.ts

@@ -0,0 +1,3 @@
+import type { ValidationResult } from '../types/index.js';
+export declare function validateConfig(): Promise<ValidationResult>;
+//# sourceMappingURL=validate-config.d.ts.map

package/dist/utils/validate-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-config.d.ts","sourceRoot":"","sources":["../../src/utils/validate-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAsB,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE9E,wBAAsB,cAAc,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAuChE"}

package/dist/utils/validate-config.js

@@ -0,0 +1,109 @@
+import fs from 'fs-extra';
+export async function validateConfig() {
+    const errors = [];
+    // Read config file
+    let configContent;
+    try {
+        configContent = await fs.readFile('archai.config.md', 'utf-8');
+    }
+    catch {
+        return {
+            valid: false,
+            errors: ['Could not read archai.config.md'],
+            config: {},
+        };
+    }
+    // Parse markdown config
+    const config = parseMarkdownConfig(configContent);
+    // Validate required fields
+    if (!config.projectName || config.projectName === '[TODO') {
+        errors.push('Project name is required');
+    }
+    if (!config.projectType || config.projectType.includes('[TODO')) {
+        errors.push('Project type is required (edit archai.config.md)');
+    }
+    if (!config.languages || config.languages.includes('[TODO')) {
+        errors.push('Languages are required (edit archai.config.md)');
+    }
+    // Parse specialists from markdown
+    config.specialists = parseSpecialists(configContent);
+    return {
+        valid: errors.length === 0,
+        errors,
+        config,
+    };
+}
+function parseMarkdownConfig(content) {
+    const config = {
+        projectName: '',
+        projectType: '',
+        languages: '',
+        frameworks: '',
+        testing: '',
+        packageManager: '',
+        specialists: [],
+        rawContent: content,
+    };
+    // Extract values using regex patterns
+    const nameMatch = content.match(/\*\*Name:\*\*\s*(.+)/);
+    if (nameMatch)
+        config.projectName = nameMatch[1].trim();
+    const typeMatch = content.match(/\*\*Type:\*\*\s*(.+)/);
+    if (typeMatch)
+        config.projectType = typeMatch[1].trim();
+    const langMatch = content.match(/\*\*Languages:\*\*\s*(.+)/);
+    if (langMatch)
+        config.languages = langMatch[1].trim();
+    const frameworkMatch = content.match(/\*\*Frameworks:\*\*\s*(.+)/);
+    if (frameworkMatch)
+        config.frameworks = frameworkMatch[1].trim();
+    const testMatch = content.match(/\*\*Testing:\*\*\s*(.+)/);
+    if (testMatch)
+        config.testing = testMatch[1].trim();
+    const pmMatch = content.match(/\*\*Package Manager:\*\*\s*(.+)/);
+    if (pmMatch)
+        config.packageManager = pmMatch[1].trim();
+    return config;
+}
+function parseSpecialists(content) {
+    const specialists = [];
+    // Find the Specialists section - look for the header and capture until next ## header or ---
+    const specialistsSection = content.match(/## Specialists to Generate[\s\S]*?(?=\n---|\n## [A-Z]|$)/);
+    if (!specialistsSection)
+        return specialists;
+    const sectionContent = specialistsSection[0];
+    // Match each specialist (### 1. Name, ### 2. Name, etc.)
+    // Use a more flexible pattern that captures until next ### or end of section
+    const specialistPattern = /###\s*\d+\.\s*([^\n]+)\n([\s\S]*?)(?=\n###\s*\d+\.|\n---|\n## |$)/g;
+    const specialistMatches = sectionContent.matchAll(specialistPattern);
+    for (const match of specialistMatches) {
+        const name = match[1].trim();
+        const details = match[2];
+        // Skip placeholder entries
+        if (name.includes('[TODO') || name.includes('[Add more'))
+            continue;
+        // Extract focus
+        const focusMatch = details.match(/\*\*Focus:\*\*\s*(.+)/);
+        const focus = focusMatch ? focusMatch[1].trim() : '';
+        // Skip if focus is empty or placeholder
+        if (!focus || focus.includes('['))
+            continue;
+        // Extract key concerns
+        const key_concerns = [];
+        const concernsMatch = details.match(/\*\*Key Concerns:\*\*([\s\S]*?)(?=\n\n|\n###|\n---|$)/);
+        if (concernsMatch) {
+            const concernLines = concernsMatch[1].match(/^-\s*(.+)/gm);
+            if (concernLines) {
+                concernLines.forEach(line => {
+                    const concern = line.replace(/^-\s*/, '').trim();
+                    if (concern && !concern.includes('[')) {
+                        key_concerns.push(concern);
+                    }
+                });
+            }
+        }
+        specialists.push({ name, focus, key_concerns });
+    }
+    return specialists;
+}
+//# sourceMappingURL=validate-config.js.map

package/dist/utils/validate-config.js.map

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

package/dist/utils/version-tracker.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Schema version for the version.json file format.
+ */
+export declare const CURRENT_SCHEMA_VERSION = 1;
+/**
+ * Default filename for the version tracking file.
+ */
+export declare const VERSION_FILE = "version.json";
+/**
+ * Record of a single tracked file.
+ */
+export interface FileRecord {
+    baseHash: string | null;
+    isGenerated: boolean;
+}
+/**
+ * Complete version tracking data.
+ */
+export interface VersionFile {
+    schemaVersion: number;
+    archai: string;
+    installedAt: string;
+    lastUpdated: string;
+    files: Record<string, FileRecord>;
+    expectedFiles: string[];
+}
+/**
+ * Get the version file path for a given .claude directory.
+ */
+export declare function getVersionFilePath(claudeDir: string): string;
+/**
+ * Load version file from disk.
+ * Returns null if file doesn't exist or is invalid.
+ */
+export declare function loadVersionFile(claudeDir: string): Promise<VersionFile | null>;
+/**
+ * Save version file to disk.
+ */
+export declare function saveVersionFile(claudeDir: string, data: VersionFile): Promise<boolean>;
+/**
+ * Create a new version file with initial values.
+ */
+export declare function createVersionFile(archaiVersion: string, files?: Record<string, FileRecord>, expectedFiles?: string[]): VersionFile;
+/**
+ * Update the version file with a new archai version.
+ */
+export declare function updateVersionInfo(versionFile: VersionFile, archaiVersion: string): VersionFile;
+/**
+ * Update or add a file hash in the version data.
+ * Normalizes path separators for cross-platform compatibility.
+ */
+export declare function updateFileHash(versionFile: VersionFile, filePath: string, hash: string | null, isGenerated?: boolean): VersionFile;
+/**
+ * Mark a file as generated (will not be modified by updates).
+ */
+export declare function markAsGenerated(versionFile: VersionFile, filePath: string): VersionFile;
+/**
+ * Remove a file from tracking.
+ */
+export declare function removeFile(versionFile: VersionFile, filePath: string): VersionFile;
+/**
+ * Get the file record for a specific path.
+ */
+export declare function getFileRecord(versionFile: VersionFile, filePath: string): FileRecord | null;
+/**
+ * Get the base hash for a file.
+ */
+export declare function getBaseHash(versionFile: VersionFile, filePath: string): string | null;
+/**
+ * Check if a file is marked as generated.
+ */
+export declare function isFileGenerated(versionFile: VersionFile, filePath: string): boolean;
+/**
+ * Get list of all tracked files.
+ */
+export declare function getTrackedFiles(versionFile: VersionFile): string[];
+/**
+ * Get list of expected files (files archai should manage).
+ */
+export declare function getExpectedFiles(versionFile: VersionFile): string[];
+/**
+ * Update the expected files list.
+ */
+export declare function setExpectedFiles(versionFile: VersionFile, expectedFiles: string[]): VersionFile;
+/**
+ * Add a file to the expected files list.
+ */
+export declare function addExpectedFile(versionFile: VersionFile, filePath: string): VersionFile;
+/**
+ * Remove a file from the expected files list.
+ */
+export declare function removeExpectedFile(versionFile: VersionFile, filePath: string): VersionFile;
+/**
+ * Get files that are expected but not tracked.
+ */
+export declare function getMissingFiles(versionFile: VersionFile): string[];
+/**
+ * Get files that are tracked but not expected (orphaned).
+ */
+export declare function getOrphanedFiles(versionFile: VersionFile): string[];
+/**
+ * Get all generated files.
+ */
+export declare function getGeneratedFiles(versionFile: VersionFile): string[];
+/**
+ * Check if version file exists for a given .claude directory.
+ */
+export declare function versionFileExists(claudeDir: string): Promise<boolean>;
+/**
+ * Normalize a file path for cross-platform consistency.
+ * Uses forward slashes and removes leading ./
+ */
+export declare function normalizePath(filePath: string): string;
+/**
+ * Bulk update multiple file hashes.
+ */
+export declare function bulkUpdateFileHashes(versionFile: VersionFile, updates: Array<{
+    path: string;
+    hash: string | null;
+    isGenerated?: boolean;
+}>): VersionFile;
+/**
+ * Create version data from a fresh install.
+ */
+export declare function createFromInstall(archaiVersion: string, installedFiles: Array<{
+    path: string;
+    hash: string | null;
+    isGenerated?: boolean;
+}>): VersionFile;
+//# sourceMappingURL=version-tracker.d.ts.map

package/dist/utils/version-tracker.d.ts.map

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