chief-clancy 0.2.0-beta.3 → 0.3.0

package/README.md

@@ -2,13 +2,13 @@
 
 **Autonomous, board-driven development for Claude Code.**
 
-[![npm](https://img.shields.io/npm/v/chief-clancy?color=cb3837)](https://www.npmjs.com/package/chief-clancy) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE) [![Tests](https://img.shields.io/badge/tests-55%20passing-brightgreen)](./test/) [![GitHub Stars](https://img.shields.io/github/stars/Pushedskydiver/clancy?style=flat)](https://github.com/Pushedskydiver/clancy/stargazers)
+[![npm](https://img.shields.io/npm/v/chief-clancy?style=for-the-badge&color=cb3837)](https://www.npmjs.com/package/chief-clancy) [![License: MIT](https://img.shields.io/badge/License-MIT-blue?style=for-the-badge)](./LICENSE) [![Tests](https://img.shields.io/badge/tests-146%20passing-brightgreen?style=for-the-badge)](docs/TESTING.md) [![GitHub Stars](https://img.shields.io/github/stars/Pushedskydiver/clancy?style=for-the-badge)](https://github.com/Pushedskydiver/clancy/stargazers)
 
 ```bash
 npx chief-clancy
 ```
 
-Works on Mac and Linux. Windows requires [WSL](https://learn.microsoft.com/en-us/windows/wsl/install).
+Works on Mac, Linux, and Windows.
 
 [What it does](#what-it-does) · [Install](#install) · [Commands](#commands) · [Supported boards](#supported-boards) · [Comparison](./COMPARISON.md) · [Roadmap](./ROADMAP.md) · [Contributing](./CONTRIBUTING.md)
 
@@ -101,8 +101,7 @@ You'll be asked: global install (`~/.claude`) or local (`./.claude`). Either wor
 **Prerequisites:**
 
 - [Claude Code](https://claude.ai/code) CLI installed
-- `jq` installed (`brew install jq` or `apt install jq`)
-- `curl` installed (comes with macOS/most Linux)
+- Node.js 22+ (`node -v`)
 - `git` installed (comes with most development environments)
 
 ### Permissions
@@ -114,7 +113,7 @@ claude --dangerously-skip-permissions
 ```
 
 > [!TIP]
-> This is how Clancy is intended to be used — stopping to approve `git commit` and `curl` 50 times defeats the purpose. Only use it on codebases you own and trust.
+> This is how Clancy is intended to be used — stopping to approve `git commit` and `node` 50 times defeats the purpose. Only use it on codebases you own and trust.
 
 ---
 
@@ -168,8 +167,8 @@ npx chief-clancy
 
 ```
 .clancy/
-  clancy-once.sh      — picks up one ticket, implements, commits, merges
-  clancy-afk.sh       — loop runner (board-agnostic)
+  clancy-once.js      — picks up one ticket, implements, commits, merges
+  clancy-afk.js       — loop runner (board-agnostic)
   docs/               — 10 structured docs read before every run
     STACK.md
     INTEGRATIONS.md
@@ -241,9 +240,9 @@ Posts to Slack or Teams when a ticket completes or Clancy hits an error. URL is
 ## How the loop works
 
 ```
-clancy-afk.sh
+clancy-afk.js
   └─ while i < MAX_ITERATIONS:
-       bash clancy-once.sh
+       node clancy-once.js
          1. Preflight checks (credentials, git state, board reachability)
          2. Fetch next ticket from board (maxResults=1)
          3. git checkout $EPIC_BRANCH
@@ -253,7 +252,7 @@ clancy-afk.sh
          7. git checkout $EPIC_BRANCH
          8. git merge --squash feature/{ticket-key}
          9. git commit -m "feat(TICKET): summary"
-        10. git branch -d feature/{ticket-key}
+        10. git branch -D feature/{ticket-key}
         11. Append to .clancy/progress.txt
        if "No tickets found": break
 ```
@@ -294,9 +293,7 @@ Clancy runs Claude with `--dangerously-skip-permissions`, which suppresses all p
     "allow": [
       "Bash(git:*)",
       "Bash(bash:*)",
-      "Bash(curl:*)",
-      "Bash(jq:*)",
-      "Bash(chmod:*)",
+      "Bash(node:*)",
       "Bash(npm:*)",
       "Bash(mkdir:*)",
       "Bash(cat:*)",
@@ -318,7 +315,7 @@ Clancy runs Claude with `--dangerously-skip-permissions`, which suppresses all p
 
 ### Protect your credentials from Claude
 
-Your board tokens and API keys live in `.clancy/.env`. Although Claude doesn't need to read this file during a run (the shell script sources it before invoking Claude), adding it to Claude Code's deny list is good defence-in-depth. Add it to `.claude/settings.json` in your project, or `~/.claude/settings.json` globally:
+Your board tokens and API keys live in `.clancy/.env`. Although Claude doesn't need to read this file during a run (the JS shim loads it before invoking Claude), adding it to Claude Code's deny list is good defence-in-depth. Add it to `.claude/settings.json` in your project, or `~/.claude/settings.json` globally:
 
 ```json
 {
@@ -394,15 +391,7 @@ Run `/clancy:status` to see what Clancy would pick up. If the queue is empty:
 
 ---
 
-**Scripts not executable?**
-
-```bash
-chmod +x .clancy/*.sh
-```
-
----
-
-**`.clancy/clancy-once.sh` not found?**
+**`.clancy/clancy-once.js` not found?**
 
 Re-run `/clancy:init` — it will detect the existing setup and offer to re-scaffold without asking for credentials again.
 
@@ -440,7 +429,7 @@ Removes slash commands from your chosen location. Cleans up the `<!-- clancy:sta
 
 ## Contributing
 
-See [CONTRIBUTING.md](./CONTRIBUTING.md). The most useful contribution is adding a new board — it's a shell script + a JSON entry.
+See [CONTRIBUTING.md](./CONTRIBUTING.md). The most useful contribution is adding a new board — it's a TypeScript module + a JSON entry.
 
 ## License
 

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,227 @@
+#!/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 { 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 _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],
+    ]) {
+        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);
+        }
+    }
+    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));
+        // 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"}