@cleocode/core 2026.4.31 → 2026.4.35

package/dist/hooks.js

@@ -0,0 +1,136 @@
+/**
+ * Git hook management utilities.
+ *
+ * Extracted from init.ts to enable shared use across init, upgrade, and
+ * doctor/health-check workflows.
+ *
+ * Handles installation, update, and verification of managed git hooks
+ * from the package's templates/git-hooks/ directory.
+ */
+import { existsSync } from 'node:fs';
+import { chmod, copyFile, mkdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { getPackageRoot } from './scaffold.js';
+// ── Constants ────────────────────────────────────────────────────────
+/** Git hooks managed by CLEO. */
+export const MANAGED_HOOKS = ['commit-msg', 'pre-commit', 'pre-push'];
+// ── ensureGitHooks ───────────────────────────────────────────────────
+/**
+ * Install or update managed git hooks from templates/git-hooks/ into .git/hooks/.
+ *
+ * Handles:
+ * - No .git directory (skips gracefully)
+ * - No source templates directory (skips gracefully)
+ * - Hooks already installed (skips unless force)
+ * - Sets executable permissions on installed hooks
+ */
+export async function ensureGitHooks(projectRoot, opts) {
+    const gitDir = join(projectRoot, '.git');
+    const gitHooksDir = join(gitDir, 'hooks');
+    if (!existsSync(gitDir)) {
+        return {
+            action: 'skipped',
+            path: gitHooksDir,
+            details: 'No .git/ directory found, skipping git hook installation',
+        };
+    }
+    const packageRoot = getPackageRoot();
+    const sourceDir = join(packageRoot, 'templates', 'git-hooks');
+    if (!existsSync(sourceDir)) {
+        return {
+            action: 'skipped',
+            path: sourceDir,
+            details: 'templates/git-hooks/ not found in package root, skipping git hook installation',
+        };
+    }
+    await mkdir(gitHooksDir, { recursive: true });
+    const force = opts?.force ?? false;
+    let installedCount = 0;
+    const errors = [];
+    for (const hook of MANAGED_HOOKS) {
+        const sourcePath = join(sourceDir, hook);
+        const destPath = join(gitHooksDir, hook);
+        if (!existsSync(sourcePath)) {
+            continue;
+        }
+        if (existsSync(destPath) && !force) {
+            continue;
+        }
+        try {
+            await copyFile(sourcePath, destPath);
+            await chmod(destPath, 0o755);
+            installedCount++;
+        }
+        catch (err) {
+            errors.push(`Failed to install git hook ${hook}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    if (errors.length > 0) {
+        return {
+            action: 'repaired',
+            path: gitHooksDir,
+            details: `Installed ${installedCount} hook(s) with ${errors.length} error(s): ${errors.join('; ')}`,
+        };
+    }
+    if (installedCount === 0) {
+        return {
+            action: 'skipped',
+            path: gitHooksDir,
+            details: 'All managed hooks already installed',
+        };
+    }
+    return {
+        action: 'created',
+        path: gitHooksDir,
+        details: `Installed ${installedCount} git hooks`,
+    };
+}
+// ── checkGitHooks ────────────────────────────────────────────────────
+/**
+ * Verify managed hooks are installed and current.
+ *
+ * Compares installed hooks in .git/hooks/ against source templates in the
+ * package's templates/git-hooks/ directory. Returns per-hook status including
+ * whether the hook is installed and whether its content matches the source.
+ */
+export async function checkGitHooks(projectRoot) {
+    const gitHooksDir = join(projectRoot, '.git', 'hooks');
+    const packageRoot = getPackageRoot();
+    const sourceDir = join(packageRoot, 'templates', 'git-hooks');
+    const results = [];
+    for (const hook of MANAGED_HOOKS) {
+        const sourcePath = join(sourceDir, hook);
+        const installedPath = join(gitHooksDir, hook);
+        const result = {
+            hook,
+            installed: false,
+            current: false,
+            sourcePath,
+            installedPath,
+        };
+        if (!existsSync(sourcePath)) {
+            // No source template — nothing to compare against
+            results.push(result);
+            continue;
+        }
+        if (!existsSync(installedPath)) {
+            results.push(result);
+            continue;
+        }
+        result.installed = true;
+        try {
+            const [sourceContent, installedContent] = await Promise.all([
+                readFile(sourcePath, 'utf-8'),
+                readFile(installedPath, 'utf-8'),
+            ]);
+            result.current = sourceContent === installedContent;
+        }
+        catch {
+            // If we can't read either file, mark as not current
+            result.current = false;
+        }
+        results.push(result);
+    }
+    return results;
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

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