@documentation-robotics/cli 0.1.0 → 0.1.5

package/dist/integrations/base-manager.js

@@ -0,0 +1,311 @@
+import * as yaml from "yaml";
+import { join, dirname, isAbsolute } from "node:path";
+import { mkdir, readFile as fsReadFile, writeFile as fsWriteFile, rm, copyFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { computeDirectoryHashes, computeFileHash } from "./hash-utils.js";
+import { validateVersionData } from "./types.js";
+import { findProjectRoot } from "../utils/project-paths.js";
+import { getCliVersion as getCliVersionFromUtils } from "../utils/spec-version.js";
+import { getErrorMessage } from "../utils/errors.js";
+class BaseIntegrationManager {
+  /**
+   * Get path to integration source files
+   *
+   * Handles both development (integrations/ in repo) and production (bundled in dist/)
+   * environments by checking for the existence of source directories.
+   *
+   * Development structure:
+   *   /workspace/integrations/{integrationSourceDir}/
+   *
+   * Production structure:
+   *   dist/integrations/{integrationSourceDir}/
+   *
+   * @returns Absolute path to integration source directory
+   * @throws Error if integration source directory cannot be found
+   */
+  getSourceRoot() {
+    const cliDir = dirname(fileURLToPath(import.meta.url)), prodPath = join(cliDir, this.integrationSourceDir);
+    if (existsSync(prodPath))
+      return prodPath;
+    const repoRoot = dirname(dirname(dirname(dirname(cliDir)))), devPath = join(repoRoot, "integrations", this.integrationSourceDir);
+    if (existsSync(devPath))
+      return devPath;
+    throw new Error(`Integration source directory not found for ${this.integrationSourceDir}. Checked: ${prodPath} and ${devPath}`);
+  }
+  /**
+   * Get the absolute path to the target directory
+   *
+   * Resolves the project root and combines it with the relative targetDir.
+   * This method ensures that integration operations work from any directory
+   * within the project, not just from the project root.
+   *
+   * @returns Absolute path to the target directory
+   * @throws Error if project root cannot be found
+   */
+  async getAbsoluteTargetDir() {
+    if (isAbsolute(this.targetDir))
+      return this.targetDir;
+    const projectRoot = await findProjectRoot();
+    if (!projectRoot)
+      throw new Error("Could not find project root. Are you in a Documentation Robotics project? Expected to find 'documentation-robotics' folder in directory hierarchy.");
+    return join(projectRoot, this.targetDir);
+  }
+  /**
+   * Check if integration is already installed
+   *
+   * @returns True if version file exists in target directory
+   */
+  async isInstalled() {
+    const absoluteTargetDir = await this.getAbsoluteTargetDir(), versionFilePath = join(absoluteTargetDir, this.versionFileName);
+    return existsSync(versionFilePath);
+  }
+  /**
+   * Load version file from target directory
+   *
+   * Parses YAML format version file tracking installed version and file hashes.
+   * Validates deserialized data to ensure all required fields are present and correctly typed.
+   *
+   * @returns VersionData if version file exists, null otherwise
+   * @throws Error if version file cannot be parsed or fails validation
+   */
+  async loadVersionFile() {
+    const absoluteTargetDir = await this.getAbsoluteTargetDir(), versionFilePath = join(absoluteTargetDir, this.versionFileName);
+    if (!existsSync(versionFilePath))
+      return null;
+    try {
+      const content = await fsReadFile(versionFilePath, "utf-8"), parsed = yaml.parse(content);
+      return validateVersionData(parsed);
+    } catch (error) {
+      throw new Error(`Failed to parse version file at ${versionFilePath}: ${error}`);
+    }
+  }
+  /**
+   * Check if a component is tracked (DR-owned)
+   *
+   * A component is tracked if its tracked property is not explicitly false.
+   * This handles the implicit default of true for backwards compatibility.
+   *
+   * @param componentName - Component name
+   * @returns True if component should be tracked in version file
+   */
+  isTrackedComponent(componentName) {
+    const config = this.components[componentName];
+    return config ? config.tracked !== !1 : !1;
+  }
+  /**
+   * Update version file with current CLI version and component hashes
+   *
+   * Records the hash of each installed (target) file as the baseline for future
+   * change detection. Using the installed hash — rather than the source hash —
+   * keeps the baseline in sync with what is actually on disk, so files that were
+   * skipped during a previous install (conflict/user-modified) do not generate
+   * false conflict reports on the next upgrade.
+   *
+   * Only DR-owned components (tracked: true) are included in the version file.
+   * User-customizable components (tracked: false) are not tracked to avoid
+   * conflicts with user modifications.
+   *
+   * @param cliVersion - Current CLI version (usually from package.json)
+   * @throws Error if version file cannot be written
+   */
+  async updateVersionFile(cliVersion) {
+    const components = {}, sourceRoot = this.getSourceRoot(), absoluteTargetDir = await this.getAbsoluteTargetDir();
+    try {
+      for (const [componentName] of Object.entries(this.components)) {
+        if (!this.isTrackedComponent(componentName))
+          continue;
+        const config = this.components[componentName], sourceDir = join(sourceRoot, config.source), targetPath = join(absoluteTargetDir, config.target), sourceHashes = existsSync(sourceDir) ? await computeDirectoryHashes(sourceDir, config.prefix) : /* @__PURE__ */ new Map();
+        components[componentName] = {};
+        for (const [filePath, sourceHash] of sourceHashes) {
+          const targetFilePath = join(targetPath, filePath);
+          let targetHash, hashComputeFailed = !1;
+          if (existsSync(targetFilePath))
+            try {
+              targetHash = await computeFileHash(targetFilePath);
+            } catch (error) {
+              hashComputeFailed = !0, console.warn(`\u26A0 Warning: Could not compute hash for ${targetFilePath}: ${getErrorMessage(error)}`);
+            }
+          components[componentName][filePath] = {
+            hash: targetHash ?? sourceHash,
+            modified: hashComputeFailed || targetHash !== void 0 && targetHash !== sourceHash
+          };
+        }
+      }
+      const versionData = {
+        version: cliVersion,
+        installed_at: (/* @__PURE__ */ new Date()).toISOString(),
+        components
+      }, versionFilePath = join(absoluteTargetDir, this.versionFileName);
+      await mkdir(dirname(versionFilePath), { recursive: !0 });
+      const yamlContent = yaml.stringify(versionData);
+      await fsWriteFile(versionFilePath, yamlContent, "utf-8");
+    } catch (error) {
+      throw new Error(`Failed to update version file: ${getErrorMessage(error)}`);
+    }
+  }
+  /**
+   * Detect files present in installation but missing from source
+   *
+   * Compares installed files (from version file) against current source files,
+   * identifying which files no longer exist in source and should be removed.
+   *
+   * @returns Array of obsolete files (empty if none found)
+   */
+  async detectObsoleteFiles() {
+    const versionData = await this.loadVersionFile();
+    if (!versionData)
+      return [];
+    const obsolete = [], sourceRoot = this.getSourceRoot();
+    for (const [componentName, files] of Object.entries(versionData.components)) {
+      if (!this.isTrackedComponent(componentName))
+        continue;
+      const config = this.components[componentName], sourceDir = join(sourceRoot, config.source);
+      for (const filePath of Object.keys(files)) {
+        const sourcePath = join(sourceDir, filePath);
+        existsSync(sourcePath) || obsolete.push({
+          path: filePath,
+          component: componentName
+        });
+      }
+    }
+    return obsolete;
+  }
+  /**
+   * Check for updates to a component's files
+   *
+   * Compares source files against installed files using hashes to detect:
+   * - New files (in source but not installed)
+   * - Modified files (hash changed in source)
+   * - Deleted files (in installation but not in source)
+   * - User-modified files (hash differs from recorded hash)
+   * - Conflicts (user modified, but source also changed)
+   *
+   * @param componentName - Component to check
+   * @param versionData - Current version data from installation
+   * @returns Array of FileChange objects describing all detected changes
+   */
+  async checkUpdates(componentName, versionData) {
+    const changes = [], config = this.components[componentName];
+    if (!config)
+      throw new Error(`Unknown component: ${componentName}`);
+    const sourceRoot = this.getSourceRoot(), sourceDir = join(sourceRoot, config.source), absoluteTargetDir = await this.getAbsoluteTargetDir(), targetPath = join(absoluteTargetDir, config.target), sourceHashes = await computeDirectoryHashes(sourceDir, config.prefix), installedHashes = existsSync(targetPath) ? await computeDirectoryHashes(targetPath, config.prefix) : /* @__PURE__ */ new Map(), recordedHashes = versionData.components[componentName] || {};
+    for (const [filePath, sourceHash] of sourceHashes) {
+      const installedHash = installedHashes.get(filePath), recordedHash = recordedHashes[filePath]?.hash;
+      installedHash ? sourceHash !== recordedHash ? recordedHash ? sourceHash === installedHash || (installedHash !== recordedHash ? changes.push({
+        path: filePath,
+        component: componentName,
+        changeType: "conflict",
+        sourceHash,
+        installedHash
+      }) : changes.push({
+        path: filePath,
+        component: componentName,
+        changeType: "modified",
+        sourceHash,
+        installedHash
+      })) : changes.push({
+        path: filePath,
+        component: componentName,
+        changeType: "modified",
+        sourceHash,
+        installedHash
+      }) : installedHash !== recordedHash && changes.push({
+        path: filePath,
+        component: componentName,
+        changeType: "user-modified",
+        sourceHash,
+        installedHash
+      }) : changes.push({
+        path: filePath,
+        component: componentName,
+        changeType: "added",
+        sourceHash
+      });
+    }
+    for (const [filePath] of Object.entries(recordedHashes))
+      sourceHashes.has(filePath) || changes.push({
+        path: filePath,
+        component: componentName,
+        changeType: "deleted",
+        installedHash: installedHashes.get(filePath)
+      });
+    return changes;
+  }
+  /**
+   * Install or update a component's files
+   *
+   * Copies all files from source to target directory, creating parent
+   * directories as needed. Optionally forces overwrite of user-modified files.
+   *
+   * @param componentName - Component to install
+   * @param force - If true, overwrite user-modified files
+   * @returns Number of files installed/updated
+   * @throws Error if installation fails
+   */
+  async installComponent(componentName, force = !1) {
+    const config = this.components[componentName];
+    if (!config)
+      throw new Error(`Unknown component: ${componentName}`);
+    const sourceRoot = this.getSourceRoot(), sourceDir = join(sourceRoot, config.source), absoluteTargetDir = await this.getAbsoluteTargetDir(), targetPath = join(absoluteTargetDir, config.target), versionData = await this.loadVersionFile(), changes = versionData ? await this.checkUpdates(componentName, versionData) : [];
+    let filesInstalled = 0;
+    const sourceHashes = await computeDirectoryHashes(sourceDir, config.prefix);
+    for (const filePath of sourceHashes.keys()) {
+      const sourcePath = join(sourceDir, filePath), targetFilePath = join(targetPath, filePath), change = changes.find((c) => c.path === filePath);
+      change && !force && (change.changeType === "user-modified" || change.changeType === "conflict") || (await mkdir(dirname(targetFilePath), { recursive: !0 }), await copyFile(sourcePath, targetFilePath), filesInstalled++);
+    }
+    return filesInstalled;
+  }
+  /**
+   * Remove a file from the installation
+   *
+   * @param filePath - Relative path to file to remove
+   * @throws Error if file cannot be deleted
+   */
+  async removeFile(filePath) {
+    const versionData = await this.loadVersionFile();
+    if (!versionData)
+      return;
+    const absoluteTargetDir = await this.getAbsoluteTargetDir();
+    for (const [componentName] of Object.entries(versionData.components)) {
+      const config = this.components[componentName];
+      if (!config)
+        continue;
+      const targetPath = join(absoluteTargetDir, config.target), fullPath = join(targetPath, filePath);
+      if (existsSync(fullPath)) {
+        await rm(fullPath, { force: !0 });
+        return;
+      }
+    }
+  }
+  /**
+   * Remove all obsolete files
+   *
+   * Deletes files that are in the installation but no longer exist in source.
+   *
+   * @returns Number of files removed
+   */
+  async removeObsoleteFiles() {
+    const obsolete = await this.detectObsoleteFiles();
+    let removed = 0;
+    for (const obsoleteFile of obsolete)
+      try {
+        await this.removeFile(obsoleteFile.path), removed++;
+      } catch (error) {
+        console.error(`Failed to remove obsolete file ${obsoleteFile.path}:`, error);
+      }
+    return removed;
+  }
+  /**
+   * Get the current CLI version
+   *
+   * @returns Version string (e.g., "0.1.0")
+   */
+  async getCliVersion() {
+    return getCliVersionFromUtils();
+  }
+}
+export {
+  BaseIntegrationManager
+};
+//# sourceMappingURL=base-manager.js.map

package/dist/integrations/base-manager.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/integrations/base-manager.ts"],
+  "sourcesContent": ["/**\n * Base Integration Manager\n *\n * Abstract base class providing shared logic for integration managers.\n * Handles file operations, version management, change detection, and installation.\n *\n * Subclasses (ClaudeIntegrationManager, CopilotIntegrationManager) must define:\n * - components: Registry of component configurations\n * - targetDir: Installation target directory (.claude or .github)\n * - versionFileName: Version file name (.dr-version or .dr-copilot-version)\n * - integrationSourceDir: Integration directory name (claude_code or github_copilot)\n */\n\nimport * as yaml from \"yaml\";\nimport { join, dirname, isAbsolute } from \"node:path\";\nimport {\n  mkdir,\n  readFile as fsReadFile,\n  writeFile as fsWriteFile,\n  rm,\n  copyFile,\n} from \"node:fs/promises\";\nimport { existsSync } from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\nimport { computeDirectoryHashes, computeFileHash } from \"./hash-utils.js\";\nimport {\n  ComponentConfig,\n  VersionData,\n  FileChange,\n  ObsoleteFile,\n  validateVersionData,\n} from \"./types.js\";\nimport { findProjectRoot } from \"../utils/project-paths.js\";\nimport { getCliVersion as getCliVersionFromUtils } from \"../utils/spec-version.js\";\nimport { getErrorMessage } from \"../utils/errors.js\";\n\n/**\n * Abstract base class for integration managers\n * Provides shared logic for file operations, version management, and update detection\n */\nexport abstract class BaseIntegrationManager {\n  /**\n   * Component registry mapping component names to their configurations\n   * Must be defined by subclasses\n   */\n  protected abstract readonly components: Record<string, ComponentConfig>;\n\n  /**\n   * Target directory for installation (.claude or .github)\n   * Must be defined by subclasses\n   */\n  protected abstract readonly targetDir: string;\n\n  /**\n   * Version file name (.dr-version or .dr-copilot-version)\n   * Must be defined by subclasses\n   */\n  protected abstract readonly versionFileName: string;\n\n  /**\n   * Integration source directory name (claude_code or github_copilot)\n   * Must be defined by subclasses\n   */\n  protected abstract readonly integrationSourceDir: string;\n\n  /**\n   * Get path to integration source files\n   *\n   * Handles both development (integrations/ in repo) and production (bundled in dist/)\n   * environments by checking for the existence of source directories.\n   *\n   * Development structure:\n   *   /workspace/integrations/{integrationSourceDir}/\n   *\n   * Production structure:\n   *   dist/integrations/{integrationSourceDir}/\n   *\n   * @returns Absolute path to integration source directory\n   * @throws Error if integration source directory cannot be found\n   */\n  protected getSourceRoot(): string {\n    // Get the path to the compiled CLI directory\n    // import.meta.url points to the compiled .js file, e.g., dist/integrations/base-manager.js\n    const cliDir = dirname(fileURLToPath(import.meta.url));\n\n    // Production: dist/integrations/{integrationSourceDir}/\n    // The integrations/ directory is in the same dist/ folder as cli.js\n    const prodPath = join(cliDir, this.integrationSourceDir);\n    if (existsSync(prodPath)) {\n      return prodPath;\n    }\n\n    // Development: integrations/{integrationSourceDir}/ relative to repo root\n    // From dist/integrations/base-manager.js, go up 3 levels to repo root\n    const repoRoot = dirname(dirname(dirname(dirname(cliDir))));\n    const devPath = join(repoRoot, \"integrations\", this.integrationSourceDir);\n    if (existsSync(devPath)) {\n      return devPath;\n    }\n\n    throw new Error(\n      `Integration source directory not found for ${this.integrationSourceDir}. ` +\n        `Checked: ${prodPath} and ${devPath}`\n    );\n  }\n\n  /**\n   * Get the absolute path to the target directory\n   *\n   * Resolves the project root and combines it with the relative targetDir.\n   * This method ensures that integration operations work from any directory\n   * within the project, not just from the project root.\n   *\n   * @returns Absolute path to the target directory\n   * @throws Error if project root cannot be found\n   */\n  protected async getAbsoluteTargetDir(): Promise<string> {\n    if (isAbsolute(this.targetDir)) {\n      return this.targetDir;\n    }\n    const projectRoot = await findProjectRoot();\n    if (!projectRoot) {\n      throw new Error(\n        `Could not find project root. Are you in a Documentation Robotics project? ` +\n          `Expected to find 'documentation-robotics' folder in directory hierarchy.`\n      );\n    }\n    return join(projectRoot, this.targetDir);\n  }\n\n  /**\n   * Check if integration is already installed\n   *\n   * @returns True if version file exists in target directory\n   */\n  public async isInstalled(): Promise<boolean> {\n    const absoluteTargetDir = await this.getAbsoluteTargetDir();\n    const versionFilePath = join(absoluteTargetDir, this.versionFileName);\n    return existsSync(versionFilePath);\n  }\n\n  /**\n   * Load version file from target directory\n   *\n   * Parses YAML format version file tracking installed version and file hashes.\n   * Validates deserialized data to ensure all required fields are present and correctly typed.\n   *\n   * @returns VersionData if version file exists, null otherwise\n   * @throws Error if version file cannot be parsed or fails validation\n   */\n  public async loadVersionFile(): Promise<VersionData | null> {\n    const absoluteTargetDir = await this.getAbsoluteTargetDir();\n    const versionFilePath = join(absoluteTargetDir, this.versionFileName);\n\n    if (!existsSync(versionFilePath)) {\n      return null;\n    }\n\n    try {\n      const content = await fsReadFile(versionFilePath, \"utf-8\");\n      const parsed = yaml.parse(content);\n      // Validate deserialized data at boundary to catch corrupted files early\n      return validateVersionData(parsed);\n    } catch (error) {\n      throw new Error(`Failed to parse version file at ${versionFilePath}: ${error}`);\n    }\n  }\n\n  /**\n   * Check if a component is tracked (DR-owned)\n   *\n   * A component is tracked if its tracked property is not explicitly false.\n   * This handles the implicit default of true for backwards compatibility.\n   *\n   * @param componentName - Component name\n   * @returns True if component should be tracked in version file\n   */\n  protected isTrackedComponent(componentName: string): boolean {\n    const config = this.components[componentName];\n    if (!config) {\n      return false;\n    }\n    return config.tracked !== false;\n  }\n\n  /**\n   * Update version file with current CLI version and component hashes\n   *\n   * Records the hash of each installed (target) file as the baseline for future\n   * change detection. Using the installed hash \u2014 rather than the source hash \u2014\n   * keeps the baseline in sync with what is actually on disk, so files that were\n   * skipped during a previous install (conflict/user-modified) do not generate\n   * false conflict reports on the next upgrade.\n   *\n   * Only DR-owned components (tracked: true) are included in the version file.\n   * User-customizable components (tracked: false) are not tracked to avoid\n   * conflicts with user modifications.\n   *\n   * @param cliVersion - Current CLI version (usually from package.json)\n   * @throws Error if version file cannot be written\n   */\n  protected async updateVersionFile(cliVersion: string): Promise<void> {\n    const components: VersionData[\"components\"] = {};\n    const sourceRoot = this.getSourceRoot();\n    const absoluteTargetDir = await this.getAbsoluteTargetDir();\n\n    try {\n      // Compute hashes for all DR-owned component files\n      for (const [componentName] of Object.entries(this.components)) {\n        // Skip non-tracked components (user-customizable)\n        if (!this.isTrackedComponent(componentName)) {\n          continue;\n        }\n\n        const config = this.components[componentName];\n\n        const sourceDir = join(sourceRoot, config.source);\n        const targetPath = join(absoluteTargetDir, config.target);\n\n        // Compute hashes for files in SOURCE directory (DR-owned files only)\n        const sourceHashes = existsSync(sourceDir)\n          ? await computeDirectoryHashes(sourceDir, config.prefix)\n          : new Map<string, string>();\n\n        // Record hashes for installed files\n        components[componentName] = {};\n        for (const [filePath, sourceHash] of sourceHashes) {\n          const targetFilePath = join(targetPath, filePath);\n          let targetHash: string | undefined;\n          let hashComputeFailed = false;\n\n          if (existsSync(targetFilePath)) {\n            try {\n              targetHash = await computeFileHash(targetFilePath);\n            } catch (error) {\n              // If we can't compute hash, record as modified to err on the side of\n              // caution \u2014 prevents silent data loss on next upgrade.\n              hashComputeFailed = true;\n              console.warn(\n                `\u26A0 Warning: Could not compute hash for ${targetFilePath}: ${getErrorMessage(error)}`\n              );\n            }\n          }\n\n          // Record the installed (target) hash as the baseline for change detection.\n          // This keeps the recorded hash in sync with what is actually on disk, so that\n          // files skipped during a previous install (conflict/user-modified) don't\n          // generate false conflict reports on the next upgrade.\n          components[componentName][filePath] = {\n            hash: targetHash ?? sourceHash,\n            modified: hashComputeFailed || (targetHash !== undefined && targetHash !== sourceHash),\n          };\n        }\n      }\n\n      // Create version data structure\n      const versionData: VersionData = {\n        version: cliVersion,\n        installed_at: new Date().toISOString(),\n        components,\n      };\n\n      // Write version file\n      const versionFilePath = join(absoluteTargetDir, this.versionFileName);\n      await mkdir(dirname(versionFilePath), { recursive: true });\n      const yamlContent = yaml.stringify(versionData);\n      await fsWriteFile(versionFilePath, yamlContent, \"utf-8\");\n    } catch (error) {\n      throw new Error(`Failed to update version file: ${getErrorMessage(error)}`);\n    }\n  }\n\n  /**\n   * Detect files present in installation but missing from source\n   *\n   * Compares installed files (from version file) against current source files,\n   * identifying which files no longer exist in source and should be removed.\n   *\n   * @returns Array of obsolete files (empty if none found)\n   */\n  protected async detectObsoleteFiles(): Promise<ObsoleteFile[]> {\n    const versionData = await this.loadVersionFile();\n    if (!versionData) {\n      return []; // No installed version, nothing is obsolete\n    }\n\n    const obsolete: ObsoleteFile[] = [];\n    const sourceRoot = this.getSourceRoot();\n\n    // Check each component and its files\n    for (const [componentName, files] of Object.entries(versionData.components)) {\n      // Only check tracked components\n      if (!this.isTrackedComponent(componentName)) {\n        continue;\n      }\n\n      const config = this.components[componentName];\n      const sourceDir = join(sourceRoot, config.source);\n\n      // Check each installed file against source\n      for (const filePath of Object.keys(files)) {\n        const sourcePath = join(sourceDir, filePath);\n        if (!existsSync(sourcePath)) {\n          obsolete.push({\n            path: filePath,\n            component: componentName,\n          });\n        }\n      }\n    }\n\n    return obsolete;\n  }\n\n  /**\n   * Check for updates to a component's files\n   *\n   * Compares source files against installed files using hashes to detect:\n   * - New files (in source but not installed)\n   * - Modified files (hash changed in source)\n   * - Deleted files (in installation but not in source)\n   * - User-modified files (hash differs from recorded hash)\n   * - Conflicts (user modified, but source also changed)\n   *\n   * @param componentName - Component to check\n   * @param versionData - Current version data from installation\n   * @returns Array of FileChange objects describing all detected changes\n   */\n  protected async checkUpdates(\n    componentName: string,\n    versionData: VersionData\n  ): Promise<FileChange[]> {\n    const changes: FileChange[] = [];\n    const config = this.components[componentName];\n\n    if (!config) {\n      throw new Error(`Unknown component: ${componentName}`);\n    }\n\n    const sourceRoot = this.getSourceRoot();\n    const sourceDir = join(sourceRoot, config.source);\n    const absoluteTargetDir = await this.getAbsoluteTargetDir();\n    const targetPath = join(absoluteTargetDir, config.target);\n\n    // Get hashes from source\n    const sourceHashes = await computeDirectoryHashes(sourceDir, config.prefix);\n\n    // Get hashes from installation (empty map if directory doesn't exist)\n    const installedHashes = existsSync(targetPath)\n      ? await computeDirectoryHashes(targetPath, config.prefix)\n      : new Map<string, string>();\n\n    // Get recorded hashes from version file\n    const recordedHashes = versionData.components[componentName] || {};\n\n    // Check source files\n    for (const [filePath, sourceHash] of sourceHashes) {\n      const installedHash = installedHashes.get(filePath);\n      const recordedEntry = recordedHashes[filePath];\n      const recordedHash = recordedEntry?.hash;\n\n      if (!installedHash) {\n        // File exists in source but not installed\n        changes.push({\n          path: filePath,\n          component: componentName,\n          changeType: \"added\",\n          sourceHash,\n        });\n      } else if (sourceHash !== recordedHash) {\n        // Source file changed (or no baseline exists)\n        if (!recordedHash) {\n          // No baseline recorded (upgrading from version without hash tracking)\n          // Treat as clean upgrade - modified, not conflict\n          changes.push({\n            path: filePath,\n            component: componentName,\n            changeType: \"modified\",\n            sourceHash,\n            installedHash,\n          });\n        } else if (sourceHash === installedHash) {\n          // Source and installed are already in sync; stale recorded hash, no action needed\n        } else if (installedHash !== recordedHash) {\n          // User also modified the file - real conflict\n          changes.push({\n            path: filePath,\n            component: componentName,\n            changeType: \"conflict\",\n            sourceHash,\n            installedHash,\n          });\n        } else {\n          // Only source changed\n          changes.push({\n            path: filePath,\n            component: componentName,\n            changeType: \"modified\",\n            sourceHash,\n            installedHash,\n          });\n        }\n      } else if (installedHash !== recordedHash) {\n        // User modified the file\n        changes.push({\n          path: filePath,\n          component: componentName,\n          changeType: \"user-modified\",\n          sourceHash,\n          installedHash,\n        });\n      }\n    }\n\n    // Check for deleted files (in version but not in source)\n    for (const [filePath] of Object.entries(recordedHashes)) {\n      if (!sourceHashes.has(filePath)) {\n        changes.push({\n          path: filePath,\n          component: componentName,\n          changeType: \"deleted\",\n          installedHash: installedHashes.get(filePath),\n        });\n      }\n    }\n\n    return changes;\n  }\n\n  /**\n   * Install or update a component's files\n   *\n   * Copies all files from source to target directory, creating parent\n   * directories as needed. Optionally forces overwrite of user-modified files.\n   *\n   * @param componentName - Component to install\n   * @param force - If true, overwrite user-modified files\n   * @returns Number of files installed/updated\n   * @throws Error if installation fails\n   */\n  protected async installComponent(componentName: string, force: boolean = false): Promise<number> {\n    const config = this.components[componentName];\n\n    if (!config) {\n      throw new Error(`Unknown component: ${componentName}`);\n    }\n\n    const sourceRoot = this.getSourceRoot();\n    const sourceDir = join(sourceRoot, config.source);\n    const absoluteTargetDir = await this.getAbsoluteTargetDir();\n    const targetPath = join(absoluteTargetDir, config.target);\n    const versionData = await this.loadVersionFile();\n\n    // Get list of changes\n    const changes = versionData ? await this.checkUpdates(componentName, versionData) : [];\n\n    let filesInstalled = 0;\n\n    // Get all source files\n    const sourceHashes = await computeDirectoryHashes(sourceDir, config.prefix);\n\n    // Copy files from source\n    for (const filePath of sourceHashes.keys()) {\n      const sourcePath = join(sourceDir, filePath);\n      const targetFilePath = join(targetPath, filePath);\n\n      // Check for conflicts with user modifications or conflicts\n      const change = changes.find((c) => c.path === filePath);\n      if (change && !force) {\n        // Skip user-modified files unless force is set\n        if (change.changeType === \"user-modified\") {\n          continue;\n        }\n        // Skip conflict files - they require explicit resolution\n        if (change.changeType === \"conflict\") {\n          continue;\n        }\n      }\n\n      // Create parent directories\n      await mkdir(dirname(targetFilePath), { recursive: true });\n\n      // Copy file\n      await copyFile(sourcePath, targetFilePath);\n      filesInstalled++;\n    }\n\n    return filesInstalled;\n  }\n\n  /**\n   * Remove a file from the installation\n   *\n   * @param filePath - Relative path to file to remove\n   * @throws Error if file cannot be deleted\n   */\n  protected async removeFile(filePath: string): Promise<void> {\n    // Find which component this file belongs to\n    const versionData = await this.loadVersionFile();\n    if (!versionData) {\n      return;\n    }\n\n    const absoluteTargetDir = await this.getAbsoluteTargetDir();\n\n    for (const [componentName] of Object.entries(versionData.components)) {\n      const config = this.components[componentName];\n      if (!config) continue;\n\n      const targetPath = join(absoluteTargetDir, config.target);\n      const fullPath = join(targetPath, filePath);\n\n      if (existsSync(fullPath)) {\n        await rm(fullPath, { force: true });\n        return;\n      }\n    }\n  }\n\n  /**\n   * Remove all obsolete files\n   *\n   * Deletes files that are in the installation but no longer exist in source.\n   *\n   * @returns Number of files removed\n   */\n  protected async removeObsoleteFiles(): Promise<number> {\n    const obsolete = await this.detectObsoleteFiles();\n    let removed = 0;\n\n    for (const obsoleteFile of obsolete) {\n      try {\n        await this.removeFile(obsoleteFile.path);\n        removed++;\n      } catch (error) {\n        // Log error but continue removing other files\n        console.error(`Failed to remove obsolete file ${obsoleteFile.path}:`, error);\n      }\n    }\n\n    return removed;\n  }\n\n  /**\n   * Get the current CLI version\n   *\n   * @returns Version string (e.g., \"0.1.0\")\n   */\n  protected async getCliVersion(): Promise<string> {\n    return getCliVersionFromUtils();\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}