@bhimudev/gnanai 0.4.0

package/dist/utils/version-tracker.js

@@ -0,0 +1,298 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { logger } from './logger.js';
+/**
+ * Schema version for the version.json file format.
+ */
+export const CURRENT_SCHEMA_VERSION = 1;
+/**
+ * Default filename for the version tracking file.
+ */
+export const VERSION_FILE = 'version.json';
+/**
+ * Get the version file path for a given .claude directory.
+ */
+export function getVersionFilePath(claudeDir) {
+    return path.join(claudeDir, VERSION_FILE);
+}
+/**
+ * Load version file from disk.
+ * Returns null if file doesn't exist or is invalid.
+ */
+export async function loadVersionFile(claudeDir) {
+    const filePath = getVersionFilePath(claudeDir);
+    try {
+        if (!await fs.pathExists(filePath)) {
+            logger.debug(`Version file not found: ${filePath}`);
+            return null;
+        }
+        const data = await fs.readJson(filePath);
+        // Validate schema version
+        if (typeof data.schemaVersion !== 'number') {
+            logger.debug('Invalid version file: missing schemaVersion');
+            return null;
+        }
+        // Handle schema version upgrades here if needed
+        if (data.schemaVersion > CURRENT_SCHEMA_VERSION) {
+            logger.warn(`Version file has newer schema (${data.schemaVersion}) than supported (${CURRENT_SCHEMA_VERSION})`);
+        }
+        // Ensure required fields exist
+        if (!data.files) {
+            data.files = {};
+        }
+        if (!data.expectedFiles) {
+            data.expectedFiles = [];
+        }
+        return data;
+    }
+    catch (error) {
+        logger.debug(`Failed to load version file: ${filePath}`, error);
+        return null;
+    }
+}
+/**
+ * Save version file to disk.
+ */
+export async function saveVersionFile(claudeDir, data) {
+    const filePath = getVersionFilePath(claudeDir);
+    try {
+        await fs.ensureDir(path.dirname(filePath));
+        await fs.writeJson(filePath, data, { spaces: 2 });
+        logger.debug(`Saved version file: ${filePath}`);
+        return true;
+    }
+    catch (error) {
+        logger.debug(`Failed to save version file: ${filePath}`, error);
+        return false;
+    }
+}
+/**
+ * Create a new version file with initial values.
+ */
+export function createVersionFile(archaiVersion, files = {}, expectedFiles = []) {
+    const now = new Date().toISOString();
+    return {
+        schemaVersion: CURRENT_SCHEMA_VERSION,
+        archai: archaiVersion,
+        installedAt: now,
+        lastUpdated: now,
+        files,
+        expectedFiles,
+    };
+}
+/**
+ * Update the version file with a new archai version.
+ */
+export function updateVersionInfo(versionFile, archaiVersion) {
+    return {
+        ...versionFile,
+        archai: archaiVersion,
+        lastUpdated: new Date().toISOString(),
+    };
+}
+/**
+ * Update or add a file hash in the version data.
+ * Normalizes path separators for cross-platform compatibility.
+ */
+export function updateFileHash(versionFile, filePath, hash, isGenerated = false) {
+    const normalizedPath = normalizePath(filePath);
+    return {
+        ...versionFile,
+        lastUpdated: new Date().toISOString(),
+        files: {
+            ...versionFile.files,
+            [normalizedPath]: {
+                baseHash: hash,
+                isGenerated,
+            },
+        },
+    };
+}
+/**
+ * Mark a file as generated (will not be modified by updates).
+ */
+export function markAsGenerated(versionFile, filePath) {
+    const normalizedPath = normalizePath(filePath);
+    const existing = versionFile.files[normalizedPath];
+    return {
+        ...versionFile,
+        lastUpdated: new Date().toISOString(),
+        files: {
+            ...versionFile.files,
+            [normalizedPath]: {
+                baseHash: existing?.baseHash ?? null,
+                isGenerated: true,
+            },
+        },
+    };
+}
+/**
+ * Remove a file from tracking.
+ */
+export function removeFile(versionFile, filePath) {
+    const normalizedPath = normalizePath(filePath);
+    const { [normalizedPath]: _, ...remainingFiles } = versionFile.files;
+    return {
+        ...versionFile,
+        lastUpdated: new Date().toISOString(),
+        files: remainingFiles,
+    };
+}
+/**
+ * Get the file record for a specific path.
+ */
+export function getFileRecord(versionFile, filePath) {
+    const normalizedPath = normalizePath(filePath);
+    return versionFile.files[normalizedPath] ?? null;
+}
+/**
+ * Get the base hash for a file.
+ */
+export function getBaseHash(versionFile, filePath) {
+    const record = getFileRecord(versionFile, filePath);
+    return record?.baseHash ?? null;
+}
+/**
+ * Check if a file is marked as generated.
+ */
+export function isFileGenerated(versionFile, filePath) {
+    const record = getFileRecord(versionFile, filePath);
+    return record?.isGenerated ?? false;
+}
+/**
+ * Get list of all tracked files.
+ */
+export function getTrackedFiles(versionFile) {
+    return Object.keys(versionFile.files);
+}
+/**
+ * Get list of expected files (files archai should manage).
+ */
+export function getExpectedFiles(versionFile) {
+    return [...versionFile.expectedFiles];
+}
+/**
+ * Update the expected files list.
+ */
+export function setExpectedFiles(versionFile, expectedFiles) {
+    return {
+        ...versionFile,
+        lastUpdated: new Date().toISOString(),
+        expectedFiles: expectedFiles.map(normalizePath),
+    };
+}
+/**
+ * Add a file to the expected files list.
+ */
+export function addExpectedFile(versionFile, filePath) {
+    const normalizedPath = normalizePath(filePath);
+    if (versionFile.expectedFiles.includes(normalizedPath)) {
+        return versionFile;
+    }
+    return {
+        ...versionFile,
+        lastUpdated: new Date().toISOString(),
+        expectedFiles: [...versionFile.expectedFiles, normalizedPath],
+    };
+}
+/**
+ * Remove a file from the expected files list.
+ */
+export function removeExpectedFile(versionFile, filePath) {
+    const normalizedPath = normalizePath(filePath);
+    return {
+        ...versionFile,
+        lastUpdated: new Date().toISOString(),
+        expectedFiles: versionFile.expectedFiles.filter(f => f !== normalizedPath),
+    };
+}
+/**
+ * Get files that are expected but not tracked.
+ */
+export function getMissingFiles(versionFile) {
+    const trackedSet = new Set(Object.keys(versionFile.files));
+    return versionFile.expectedFiles.filter(f => !trackedSet.has(f));
+}
+/**
+ * Get files that are tracked but not expected (orphaned).
+ */
+export function getOrphanedFiles(versionFile) {
+    const expectedSet = new Set(versionFile.expectedFiles);
+    return Object.keys(versionFile.files).filter(f => {
+        // Generated files are not expected to be in expectedFiles
+        if (versionFile.files[f].isGenerated) {
+            return false;
+        }
+        return !expectedSet.has(f);
+    });
+}
+/**
+ * Get all generated files.
+ */
+export function getGeneratedFiles(versionFile) {
+    return Object.entries(versionFile.files)
+        .filter(([_, record]) => record.isGenerated)
+        .map(([path, _]) => path);
+}
+/**
+ * Check if version file exists for a given .claude directory.
+ */
+export async function versionFileExists(claudeDir) {
+    const filePath = getVersionFilePath(claudeDir);
+    return fs.pathExists(filePath);
+}
+/**
+ * Normalize a file path for cross-platform consistency.
+ * Uses forward slashes and removes leading ./
+ */
+export function normalizePath(filePath) {
+    return filePath
+        .replace(/\\/g, '/')
+        .replace(/^\.\//, '');
+}
+/**
+ * Bulk update multiple file hashes.
+ */
+export function bulkUpdateFileHashes(versionFile, updates) {
+    const newFiles = { ...versionFile.files };
+    for (const update of updates) {
+        const normalizedPath = normalizePath(update.path);
+        newFiles[normalizedPath] = {
+            baseHash: update.hash,
+            isGenerated: update.isGenerated ?? false,
+        };
+    }
+    return {
+        ...versionFile,
+        lastUpdated: new Date().toISOString(),
+        files: newFiles,
+    };
+}
+/**
+ * Create version data from a fresh install.
+ */
+export function createFromInstall(archaiVersion, installedFiles) {
+    const files = {};
+    const expectedFiles = [];
+    for (const file of installedFiles) {
+        const normalizedPath = normalizePath(file.path);
+        files[normalizedPath] = {
+            baseHash: file.hash,
+            isGenerated: file.isGenerated ?? false,
+        };
+        // Non-generated files are expected
+        if (!file.isGenerated) {
+            expectedFiles.push(normalizedPath);
+        }
+    }
+    const now = new Date().toISOString();
+    return {
+        schemaVersion: CURRENT_SCHEMA_VERSION,
+        archai: archaiVersion,
+        installedAt: now,
+        lastUpdated: now,
+        files,
+        expectedFiles,
+    };
+}
+//# sourceMappingURL=version-tracker.js.map

package/dist/utils/version-tracker.js.map

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

package/dist/utils/worktree.d.ts

@@ -0,0 +1,68 @@
+import { isWorktree } from './detect-git.js';
+import type { WorktreeInfo } from '../types/index.js';
+/**
+ * Options for bootstrapping a worktree's .claude/ directory.
+ */
+interface BootstrapOptions {
+    taskId: string;
+    description: string;
+    branchName: string;
+}
+/**
+ * Sanitize a string for use in branch names and directory names.
+ * @internal Exported for direct testability.
+ */
+export declare function sanitize(input: string): string;
+/**
+ * Bootstrap a worktree's .claude/ directory with junctions, links, and fresh dirs.
+ *
+ * @param worktreePath - Absolute path to the new worktree root
+ * @param mainClaudeDir - Absolute path to the main worktree's .claude/ dir
+ * @param options - Task metadata for context file generation
+ */
+export declare function bootstrapWorktree(worktreePath: string, mainClaudeDir: string, options: BootstrapOptions): Promise<void>;
+/**
+ * Create a new git worktree for a task, with bootstrapped .claude/ directory.
+ *
+ * @param taskId - The task identifier (e.g., 'WORKTREE-001')
+ * @param description - Human-readable description (e.g., 'core worktree utilities')
+ * @returns WorktreeInfo for the created worktree
+ */
+export declare function createWorktree(taskId: string, description: string): Promise<WorktreeInfo>;
+/**
+ * Remove a worktree, cleaning up junctions/links BEFORE calling git worktree remove.
+ *
+ * @param worktreePath - Absolute path to the worktree to remove
+ * @param force - Whether to pass --force to git worktree remove
+ */
+export declare function removeWorktree(worktreePath: string, force?: boolean): Promise<void>;
+/**
+ * List all git worktrees in the current repository.
+ *
+ * @returns Array of WorktreeInfo objects
+ */
+export declare function listWorktrees(): Promise<WorktreeInfo[]>;
+/**
+ * Check if the current directory is inside a linked git worktree.
+ * Re-export of isWorktree from detect-git.ts for convenience.
+ */
+export declare const isInsideWorktree: typeof isWorktree;
+/**
+ * Get the main worktree (repo root) path from inside a linked worktree.
+ * Returns null if .git is a directory (main worktree), missing, or has unexpected format.
+ */
+export declare function getMainWorktreePath(): Promise<string | null>;
+/**
+ * Prune stale worktree entries from git's tracking.
+ *
+ * @returns Array of pruned entry descriptions from git output
+ */
+export declare function pruneWorktrees(): Promise<string[]>;
+/**
+ * Detect worktrees whose paths no longer exist on disk.
+ *
+ * @returns Array of stale WorktreeInfo objects
+ */
+export declare function detectStaleWorktrees(): Promise<WorktreeInfo[]>;
+export {};
+//# sourceMappingURL=worktree.d.ts.map

package/dist/utils/worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../src/utils/worktree.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAWtD;;GAEG;AACH,UAAU,gBAAgB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AA+BD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAS9C;AAwBD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CA0Df;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAkE/F;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAyGhG;AAED;;;;GAIG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAoE7D;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,mBAAa,CAAC;AAE3C;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuBlE;AAED;;;;GAIG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAexD;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAGpE"}