chief-clancy 0.2.0 → 0.3.1

package/dist/installer/file-ops/file-ops.d.ts

@@ -0,0 +1,32 @@
+/** Minimal directory-entry shape returned by `readdirSync({ withFileTypes: true })`. */
+export type DirentLike = {
+    name: string;
+    isDirectory(): boolean;
+};
+/**
+ * Compute the SHA-256 hash of a file.
+ *
+ * @param filePath - Absolute path to the file.
+ * @returns The hex-encoded SHA-256 hash string.
+ *
+ * @example
+ * ```ts
+ * const hash = fileHash('/path/to/file.md');
+ * // 'e3b0c44298fc1c149afbf4c8996fb924...'
+ * ```
+ */
+export declare function fileHash(filePath: string): string;
+/**
+ * Recursively copy a directory, throwing if the destination is a symlink.
+ *
+ * @param src - Source directory path.
+ * @param dest - Destination directory path.
+ * @throws If the destination is a symlink.
+ *
+ * @example
+ * ```ts
+ * copyDir('src/commands', '/home/user/.claude/commands/clancy');
+ * ```
+ */
+export declare function copyDir(src: string, dest: string): void;
+//# sourceMappingURL=file-ops.d.ts.map

package/dist/installer/file-ops/file-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-ops.d.ts","sourceRoot":"","sources":["../../../src/installer/file-ops/file-ops.ts"],"names":[],"mappings":"AAgBA,wFAAwF;AACxF,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,IAAI,OAAO,CAAA;CAAE,CAAC;AAElE;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAuBvD"}

package/dist/installer/file-ops/file-ops.js

@@ -0,0 +1,58 @@
+/**
+ * Low-level file system helpers for the installer.
+ *
+ * Provides SHA-256 hashing and recursive directory copying with symlink detection.
+ */
+import { createHash } from 'node:crypto';
+import { copyFileSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Compute the SHA-256 hash of a file.
+ *
+ * @param filePath - Absolute path to the file.
+ * @returns The hex-encoded SHA-256 hash string.
+ *
+ * @example
+ * ```ts
+ * const hash = fileHash('/path/to/file.md');
+ * // 'e3b0c44298fc1c149afbf4c8996fb924...'
+ * ```
+ */
+export function fileHash(filePath) {
+    const content = readFileSync(filePath);
+    return createHash('sha256').update(content).digest('hex');
+}
+/**
+ * Recursively copy a directory, throwing if the destination is a symlink.
+ *
+ * @param src - Source directory path.
+ * @param dest - Destination directory path.
+ * @throws If the destination is a symlink.
+ *
+ * @example
+ * ```ts
+ * copyDir('src/commands', '/home/user/.claude/commands/clancy');
+ * ```
+ */
+export function copyDir(src, dest) {
+    if (existsSync(dest)) {
+        const stat = lstatSync(dest);
+        if (stat.isSymbolicLink()) {
+            throw new Error(`${dest} is a symlink. Remove it first before installing.`);
+        }
+    }
+    mkdirSync(dest, { recursive: true });
+    for (const entry of readdirSync(src, {
+        withFileTypes: true,
+    })) {
+        const s = join(src, entry.name);
+        const d = join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyDir(s, d);
+        }
+        else {
+            copyFileSync(s, d);
+        }
+    }
+}
+//# sourceMappingURL=file-ops.js.map

package/dist/installer/file-ops/file-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-ops.js","sourceRoot":"","sources":["../../../src/installer/file-ops/file-ops.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,YAAY,EACZ,UAAU,EACV,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,GACZ,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAKjC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACvC,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,IAAY;IAC/C,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,mDAAmD,CAC3D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAErC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,EAAE;QACnC,aAAa,EAAE,IAAI;KACpB,CAAiB,EAAE,CAAC;QACnB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/installer/hook-installer/hook-installer.d.ts

@@ -0,0 +1,29 @@
+/** Options for the hook installer. */
+type HookInstallerOptions = {
+    /** The Claude config directory (e.g., `~/.claude` or `./.claude`). */
+    claudeConfigDir: string;
+    /** Path to the directory containing compiled hook JS files. */
+    hooksSourceDir: string;
+};
+/**
+ * Install Clancy hooks into the Claude config directory.
+ *
+ * Copies hook scripts, writes a CommonJS `package.json` to the hooks dir,
+ * and merges hook registrations into `settings.json`.
+ *
+ * Best-effort — never throws. Returns `false` if installation fails.
+ *
+ * @param options - The hook installer options.
+ * @returns `true` if hooks were installed successfully.
+ *
+ * @example
+ * ```ts
+ * installHooks({
+ *   claudeConfigDir: '/home/user/.claude',
+ *   hooksSourceDir: '/path/to/clancy/hooks',
+ * });
+ * ```
+ */
+export declare function installHooks(options: HookInstallerOptions): boolean;
+export {};
+//# sourceMappingURL=hook-installer.d.ts.map

package/dist/installer/hook-installer/hook-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-installer.d.ts","sourceRoot":"","sources":["../../../src/installer/hook-installer/hook-installer.ts"],"names":[],"mappings":"AAkBA,sCAAsC;AACtC,KAAK,oBAAoB,GAAG;IAC1B,sEAAsE;IACtE,eAAe,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAyBF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAmEnE"}

package/dist/installer/hook-installer/hook-installer.js

@@ -0,0 +1,96 @@
+/**
+ * Hook installer for Claude Code settings.
+ *
+ * Copies compiled hook scripts into the Claude config directory and
+ * registers them in `settings.json` without clobbering existing config.
+ */
+import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync, } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Add a hook command to a settings event array if not already registered.
+ *
+ * @param hooks - The hooks record from settings.json.
+ * @param event - The hook event name (e.g., `'SessionStart'`).
+ * @param command - The shell command to register.
+ */
+function registerHook(hooks, event, command) {
+    if (!hooks[event])
+        hooks[event] = [];
+    const already = hooks[event].some((h) => h.hooks && h.hooks.some((hh) => hh.command === command));
+    if (!already) {
+        hooks[event].push({ hooks: [{ type: 'command', command }] });
+    }
+}
+/**
+ * Install Clancy hooks into the Claude config directory.
+ *
+ * Copies hook scripts, writes a CommonJS `package.json` to the hooks dir,
+ * and merges hook registrations into `settings.json`.
+ *
+ * Best-effort — never throws. Returns `false` if installation fails.
+ *
+ * @param options - The hook installer options.
+ * @returns `true` if hooks were installed successfully.
+ *
+ * @example
+ * ```ts
+ * installHooks({
+ *   claudeConfigDir: '/home/user/.claude',
+ *   hooksSourceDir: '/path/to/clancy/hooks',
+ * });
+ * ```
+ */
+export function installHooks(options) {
+    const { claudeConfigDir, hooksSourceDir } = options;
+    const hooksInstallDir = join(claudeConfigDir, 'hooks');
+    const settingsFile = join(claudeConfigDir, 'settings.json');
+    const hookFiles = [
+        'clancy-check-update.js',
+        'clancy-statusline.js',
+        'clancy-context-monitor.js',
+        'clancy-credential-guard.js',
+    ];
+    try {
+        mkdirSync(hooksInstallDir, { recursive: true });
+        for (const f of hookFiles) {
+            copyFileSync(join(hooksSourceDir, f), join(hooksInstallDir, f));
+        }
+        // Force CommonJS resolution for hook files — projects with "type":"module"
+        // in their package.json would otherwise treat .js files as ESM.
+        writeFileSync(join(hooksInstallDir, 'package.json'), JSON.stringify({ type: 'commonjs' }, null, 2) + '\n');
+        // Merge hooks into settings.json without clobbering existing config
+        let settings = {};
+        if (existsSync(settingsFile)) {
+            try {
+                settings = JSON.parse(readFileSync(settingsFile, 'utf8'));
+            }
+            catch {
+                // Ignore parse errors — start fresh
+            }
+        }
+        if (!settings.hooks)
+            settings.hooks = {};
+        const hooks = settings.hooks;
+        const updateScript = join(hooksInstallDir, 'clancy-check-update.js');
+        const statuslineScript = join(hooksInstallDir, 'clancy-statusline.js');
+        const monitorScript = join(hooksInstallDir, 'clancy-context-monitor.js');
+        const guardScript = join(hooksInstallDir, 'clancy-credential-guard.js');
+        registerHook(hooks, 'SessionStart', `node ${JSON.stringify(updateScript)}`);
+        registerHook(hooks, 'PostToolUse', `node ${JSON.stringify(monitorScript)}`);
+        registerHook(hooks, 'PreToolUse', `node ${JSON.stringify(guardScript)}`);
+        // Statusline: registered as top-level key, not inside hooks
+        if (!settings.statusLine) {
+            settings.statusLine = {
+                type: 'command',
+                command: `node ${JSON.stringify(statuslineScript)}`,
+            };
+        }
+        writeFileSync(settingsFile, JSON.stringify(settings, null, 2) + '\n');
+        return true;
+    }
+    catch {
+        // Hook registration is best-effort — don't fail the install
+        return false;
+    }
+}
+//# sourceMappingURL=hook-installer.js.map

package/dist/installer/hook-installer/hook-installer.js.map

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

package/dist/installer/install.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=install.d.ts.map

package/dist/installer/install.d.ts.map

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

package/dist/installer/install.js

@@ -0,0 +1,248 @@
+#!/usr/bin/env node
+/**
+ * Clancy installer — interactive CLI entry point.
+ *
+ * Prompts the user to choose global (~/.claude) or local (./.claude) install,
+ * copies commands and workflows, inlines workflow references for global installs,
+ * detects and backs up user-modified files, and registers hooks in Claude settings.
+ */
+import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync, } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { copyDir } from '../installer/file-ops/file-ops.js';
+import { installHooks } from '../installer/hook-installer/hook-installer.js';
+import { backupModifiedFiles, buildManifest, detectModifiedFiles, } from '../installer/manifest/manifest.js';
+import { ask, choose, closePrompts } from '../installer/prompts/prompts.js';
+import { blue, bold, cyan, dim, green, red } from '../utils/ansi/ansi.js';
+// ---------------------------------------------------------------------------
+// Paths
+// ---------------------------------------------------------------------------
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const require = createRequire(import.meta.url);
+const PKG = require('../../package.json');
+const COMMANDS_SRC = join(__dirname, '..', '..', 'src', 'commands');
+const WORKFLOWS_SRC = join(__dirname, '..', '..', 'src', 'workflows');
+const HOOKS_SRC = join(__dirname, '..', '..', 'hooks');
+const BUNDLE_SRC = join(__dirname, '..', 'bundle');
+const _homeDir = process.env.HOME ?? process.env.USERPROFILE;
+if (!_homeDir) {
+    process.stderr.write('\x1b[31m\n  Error: HOME or USERPROFILE environment variable is not set.\x1b[0m\n');
+    process.exit(1);
+}
+const homeDir = _homeDir;
+const GLOBAL_DEST = join(homeDir, '.claude', 'commands', 'clancy');
+const LOCAL_DEST = join(process.cwd(), '.claude', 'commands', 'clancy');
+const GLOBAL_WORKFLOWS_DEST = join(homeDir, '.claude', 'clancy', 'workflows');
+const LOCAL_WORKFLOWS_DEST = join(process.cwd(), '.claude', 'clancy', 'workflows');
+// ---------------------------------------------------------------------------
+// Banner
+// ---------------------------------------------------------------------------
+/**
+ * Print the Clancy ASCII banner and version info.
+ */
+function printBanner() {
+    console.log('');
+    console.log(blue('  ██████╗██╗      █████╗ ███╗   ██╗ ██████╗██╗   ██╗'));
+    console.log(blue(' ██╔════╝██║     ██╔══██╗████╗  ██║██╔════╝╚██╗ ██╔╝'));
+    console.log(blue(' ██║     ██║     ███████║██╔██╗ ██║██║      ╚████╔╝ '));
+    console.log(blue(' ██║     ██║     ██╔══██║██║╚██╗██║██║       ╚██╔╝  '));
+    console.log(blue(' ╚██████╗███████╗██║  ██║██║ ╚████║╚██████╗   ██║   '));
+    console.log(blue('  ╚═════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝ ╚═════╝   ╚═╝  '));
+    console.log('');
+    console.log('  ' +
+        bold(`v${PKG.version}`) +
+        dim('  Autonomous, board-driven development for Claude Code.'));
+    console.log(dim('  Named after Chief Clancy Wiggum. Built on the Ralph technique by Geoffrey Huntley.'));
+}
+/**
+ * Print the post-install success message with available commands.
+ */
+function printSuccess() {
+    console.log('');
+    console.log(green('  ✓ Clancy installed successfully.'));
+    console.log('');
+    console.log('  Next steps:');
+    console.log(dim('    1. Open a project in Claude Code'));
+    console.log(`    2. Run: ${cyan('/clancy:init')}`);
+    console.log('');
+    console.log('  Commands available:');
+    console.log('');
+    const cmds = [
+        ['/clancy:init', 'Set up Clancy in your project'],
+        ['/clancy:map-codebase', 'Scan codebase with 5 parallel agents'],
+        ['/clancy:run', 'Run Clancy in loop mode'],
+        ['/clancy:once', 'Pick up one ticket and stop'],
+        ['/clancy:dry-run', 'Preview next ticket without making changes'],
+        ['/clancy:status', 'Show next tickets without running'],
+        ['/clancy:review', 'Score next ticket and get recommendations'],
+        ['/clancy:logs', 'Display progress log'],
+        ['/clancy:settings', 'View and change configuration'],
+        ['/clancy:doctor', 'Diagnose your setup'],
+        ['/clancy:update', 'Update Clancy to latest version'],
+        ['/clancy:help', 'Show all commands'],
+    ];
+    for (const [cmd, desc] of cmds) {
+        console.log(`    ${cyan(cmd.padEnd(22))}  ${dim(desc)}`);
+    }
+    console.log('');
+}
+// ---------------------------------------------------------------------------
+// Workflow inlining
+// ---------------------------------------------------------------------------
+/** Regex matching an @-file workflow reference in a command file. */
+const WORKFLOW_REF = /^@\.claude\/clancy\/workflows\/(.+\.md)$/m;
+/**
+ * Inline workflow file content into global command files.
+ *
+ * For global installs, @-file references resolve relative to the project root
+ * (not ~/.claude), so the workflow files won't be found at runtime. This
+ * replaces the @-file reference with the actual workflow content.
+ *
+ * @param commandsDir - The installed commands directory.
+ * @param workflowsDir - The installed workflows directory.
+ */
+function inlineWorkflows(commandsDir, workflowsDir) {
+    for (const file of readdirSync(commandsDir)) {
+        if (!file.endsWith('.md'))
+            continue;
+        const cmdPath = join(commandsDir, file);
+        const content = readFileSync(cmdPath, 'utf8');
+        const match = content.match(WORKFLOW_REF);
+        if (!match)
+            continue;
+        const workflowFile = join(workflowsDir, match[1]);
+        if (!existsSync(workflowFile))
+            continue;
+        const workflowContent = readFileSync(workflowFile, 'utf8');
+        writeFileSync(cmdPath, content.replace(match[0], workflowContent));
+    }
+}
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+async function main() {
+    printBanner();
+    const installChoice = await choose('Where would you like to install?', [
+        `Global  ${dim('(~/.claude)')}   — available in all projects`,
+        `Local   ${dim('(./.claude)')}  — this project only`,
+    ]);
+    let dest;
+    let workflowsDest;
+    if (installChoice === '1' || installChoice.toLowerCase() === 'global') {
+        dest = GLOBAL_DEST;
+        workflowsDest = GLOBAL_WORKFLOWS_DEST;
+    }
+    else if (installChoice === '2' || installChoice.toLowerCase() === 'local') {
+        dest = LOCAL_DEST;
+        workflowsDest = LOCAL_WORKFLOWS_DEST;
+    }
+    else {
+        console.log(red('\n  Invalid choice. Run npx chief-clancy again and enter 1 or 2.'));
+        closePrompts();
+        process.exit(1);
+    }
+    // Validate source directories — guards against corrupted npm package
+    for (const [label, src] of [
+        ['Commands', COMMANDS_SRC],
+        ['Workflows', WORKFLOWS_SRC],
+        ['Runtime bundles', BUNDLE_SRC],
+    ]) {
+        if (!existsSync(src)) {
+            console.error(red(`\n  Error: ${label} source not found: ${src}`));
+            console.error(red('  The npm package may be corrupted. Try: npm cache clean --force'));
+            closePrompts();
+            process.exit(1);
+        }
+    }
+    // Validate individual bundle files exist
+    for (const script of ['clancy-once.js', 'clancy-afk.js']) {
+        if (!existsSync(join(BUNDLE_SRC, script))) {
+            console.error(red(`\n  Error: Bundled script not found: ${script}`));
+            console.error(red('  The npm package may be corrupted. Try: npm cache clean --force'));
+            closePrompts();
+            process.exit(1);
+        }
+    }
+    console.log('');
+    console.log(dim(`  Installing to: ${dest}`));
+    try {
+        const claudeDir = dirname(dirname(dest)); // .claude/
+        const manifestPath = join(claudeDir, 'clancy', 'manifest.json');
+        const workflowsManifestPath = join(claudeDir, 'clancy', 'workflows-manifest.json');
+        const patchesDir = join(claudeDir, 'clancy', 'local-patches');
+        // Handle existing installation
+        if (existsSync(dest) || existsSync(workflowsDest)) {
+            console.log('');
+            const modified = detectModifiedFiles(dest, manifestPath);
+            const modifiedWorkflows = detectModifiedFiles(workflowsDest, workflowsManifestPath);
+            const allModified = [...modified, ...modifiedWorkflows];
+            if (allModified.length > 0) {
+                console.log(blue('  Modified files detected:'));
+                for (const { rel } of allModified) {
+                    console.log(`    ${dim('•')} ${rel}`);
+                }
+                console.log('');
+                console.log(dim('  These will be backed up to .claude/clancy/local-patches/'));
+                console.log(dim('  before overwriting. You can reapply them after the update.'));
+                console.log('');
+            }
+            const overwrite = await ask(blue(`  Commands already exist at ${dest}. Overwrite? [y/N] `));
+            if (!overwrite.trim().toLowerCase().startsWith('y')) {
+                console.log('\n  Aborted. No files changed.');
+                closePrompts();
+                process.exit(0);
+            }
+            if (allModified.length > 0) {
+                backupModifiedFiles(allModified, patchesDir);
+                console.log(green(`\n  ✓ ${allModified.length} modified file(s) backed up to local-patches/`));
+            }
+        }
+        // Copy commands and workflows
+        copyDir(COMMANDS_SRC, dest);
+        copyDir(WORKFLOWS_SRC, workflowsDest);
+        // Inline workflows for global installs
+        if (dest === GLOBAL_DEST) {
+            inlineWorkflows(dest, workflowsDest);
+        }
+        // Write VERSION file
+        writeFileSync(join(dest, 'VERSION'), PKG.version);
+        // Write manifests for future update detection
+        mkdirSync(dirname(manifestPath), { recursive: true });
+        writeFileSync(manifestPath, JSON.stringify(buildManifest(dest), null, 2));
+        writeFileSync(workflowsManifestPath, JSON.stringify(buildManifest(workflowsDest), null, 2));
+        // Copy bundled runtime scripts to .clancy/ in the current project.
+        // Always use cwd — workflows run `node .clancy/clancy-once.js` relative
+        // to the project root, regardless of global vs local install.
+        const clancyProjectDir = join(process.cwd(), '.clancy');
+        mkdirSync(clancyProjectDir, { recursive: true });
+        for (const script of ['clancy-once.js', 'clancy-afk.js']) {
+            copyFileSync(join(BUNDLE_SRC, script), join(clancyProjectDir, script));
+        }
+        // Ensure .clancy is treated as an ESM package so Node runs clancy-*.js as ESM
+        writeFileSync(join(clancyProjectDir, 'package.json'), JSON.stringify({ type: 'module' }, null, 2) + '\n');
+        // Install hooks
+        const claudeConfigDir = dest === GLOBAL_DEST
+            ? join(homeDir, '.claude')
+            : join(process.cwd(), '.claude');
+        installHooks({
+            claudeConfigDir,
+            hooksSourceDir: HOOKS_SRC,
+        });
+        printSuccess();
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(red(`\n  Install failed: ${message}`));
+        closePrompts();
+        process.exit(1);
+    }
+    closePrompts();
+}
+main().catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(red(`\n  Install failed: ${message}`));
+    process.exit(1);
+});
+//# sourceMappingURL=install.js.map

package/dist/installer/install.js.map

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

package/dist/installer/manifest/manifest.d.ts

@@ -0,0 +1,41 @@
+/** A file that has been modified by the user since last install. */
+export type ModifiedFile = {
+    rel: string;
+    absPath: string;
+};
+/**
+ * Build a manifest of installed files with SHA-256 hashes.
+ *
+ * Recursively walks a directory and records the hash of every file.
+ *
+ * @param baseDir - Root directory to scan.
+ * @returns A record mapping relative paths to their SHA-256 hashes.
+ *
+ * @example
+ * ```ts
+ * const manifest = buildManifest('/path/to/.claude/commands/clancy');
+ * // { "init.md": "abc123...", "run.md": "def456..." }
+ * ```
+ */
+export declare function buildManifest(baseDir: string): Record<string, string>;
+/**
+ * Detect files modified by the user since last install.
+ *
+ * Compares current file hashes against the stored manifest to find changes.
+ *
+ * @param baseDir - The installed directory to check.
+ * @param manifestPath - Path to the stored manifest JSON.
+ * @returns Array of modified file records with relative and absolute paths.
+ */
+export declare function detectModifiedFiles(baseDir: string, manifestPath: string): ModifiedFile[];
+/**
+ * Back up modified files to a patches directory.
+ *
+ * Copies each modified file and writes a `backup-meta.json` with metadata.
+ *
+ * @param modified - Array of modified file records.
+ * @param patchesDir - Directory to store backups.
+ * @returns The patches directory path, or `null` if no files were backed up.
+ */
+export declare function backupModifiedFiles(modified: ModifiedFile[], patchesDir: string): string | null;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/installer/manifest/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/installer/manifest/manifest.ts"],"names":[],"mappings":"AAmBA,oEAAoE;AACpE,MAAM,MAAM,YAAY,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoBrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB,YAAY,EAAE,CA0BhB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,YAAY,EAAE,EACxB,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAwBf"}

package/dist/installer/manifest/manifest.js

@@ -0,0 +1,97 @@
+/**
+ * Manifest-based change detection for installed files.
+ *
+ * Tracks SHA-256 hashes of installed files so that user modifications can
+ * be detected and backed up before an update overwrites them.
+ */
+import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync, } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileHash } from '../../installer/file-ops/file-ops.js';
+/**
+ * Build a manifest of installed files with SHA-256 hashes.
+ *
+ * Recursively walks a directory and records the hash of every file.
+ *
+ * @param baseDir - Root directory to scan.
+ * @returns A record mapping relative paths to their SHA-256 hashes.
+ *
+ * @example
+ * ```ts
+ * const manifest = buildManifest('/path/to/.claude/commands/clancy');
+ * // { "init.md": "abc123...", "run.md": "def456..." }
+ * ```
+ */
+export function buildManifest(baseDir) {
+    const manifest = {};
+    function walk(dir, prefix) {
+        for (const entry of readdirSync(dir, {
+            withFileTypes: true,
+        })) {
+            const full = join(dir, entry.name);
+            const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
+            if (entry.isDirectory()) {
+                walk(full, rel);
+            }
+            else {
+                manifest[rel] = fileHash(full);
+            }
+        }
+    }
+    walk(baseDir, '');
+    return manifest;
+}
+/**
+ * Detect files modified by the user since last install.
+ *
+ * Compares current file hashes against the stored manifest to find changes.
+ *
+ * @param baseDir - The installed directory to check.
+ * @param manifestPath - Path to the stored manifest JSON.
+ * @returns Array of modified file records with relative and absolute paths.
+ */
+export function detectModifiedFiles(baseDir, manifestPath) {
+    if (!existsSync(manifestPath))
+        return [];
+    let manifest;
+    try {
+        manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+    }
+    catch {
+        return [];
+    }
+    const modified = [];
+    for (const [rel, hash] of Object.entries(manifest)) {
+        const absPath = join(baseDir, rel);
+        if (!existsSync(absPath))
+            continue;
+        if (fileHash(absPath) !== hash) {
+            modified.push({ rel, absPath });
+        }
+    }
+    return modified;
+}
+/**
+ * Back up modified files to a patches directory.
+ *
+ * Copies each modified file and writes a `backup-meta.json` with metadata.
+ *
+ * @param modified - Array of modified file records.
+ * @param patchesDir - Directory to store backups.
+ * @returns The patches directory path, or `null` if no files were backed up.
+ */
+export function backupModifiedFiles(modified, patchesDir) {
+    if (modified.length === 0)
+        return null;
+    mkdirSync(patchesDir, { recursive: true });
+    for (const { rel, absPath } of modified) {
+        const backupPath = join(patchesDir, rel);
+        mkdirSync(dirname(backupPath), { recursive: true });
+        copyFileSync(absPath, backupPath);
+    }
+    writeFileSync(join(patchesDir, 'backup-meta.json'), JSON.stringify({
+        backed_up: modified.map((m) => m.rel),
+        date: new Date().toISOString(),
+    }, null, 2));
+    return patchesDir;
+}
+//# sourceMappingURL=manifest.js.map