@chief-clancy/terminal 0.1.0

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/hook-installer/index.d.ts

@@ -0,0 +1,2 @@
+export { installHooks } from './hook-installer.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/installer/hook-installer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,2 @@
+export { installHooks } from './hook-installer.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/installer/hook-installer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,3 @@
+export type { InstallMode, InstallPaths, RunInstallOptions, } from './install.js';
+export { parseEnabledRoles, parseInstallFlag, resolveInstallPaths, runInstall, validateSources, } from './install.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/installer/install/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,YAAY,EACZ,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACV,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/installer/install/index.js

@@ -0,0 +1,2 @@
+export { parseEnabledRoles, parseInstallFlag, resolveInstallPaths, runInstall, validateSources, } from './install.js';
+//# sourceMappingURL=index.js.map

package/dist/installer/install/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/installer/install/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACV,eAAe,GAChB,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,124 @@
+/**
+ * Installer orchestrator — decomposed pipeline for `npx chief-clancy`.
+ *
+ * Coordinates all installer modules (file-ops, manifest, role-filter,
+ * hook-installer, prompts, ui) into a single installation flow.
+ * Pure helpers are exported for testing; pipeline steps are boundary functions.
+ */
+import type { EnvFileSystem } from '@chief-clancy/core';
+/** The install target — global (`~/.claude`) or local (`./.claude`). */
+export type InstallMode = 'global' | 'local';
+/** Source directories within the npm package. */
+type InstallSources = {
+    readonly rolesDir: string;
+    readonly hooksDir: string;
+    readonly bundleDir: string;
+    readonly agentsDir: string;
+};
+/** All resolved destination paths for an installation. */
+export type InstallPaths = {
+    readonly commandsDest: string;
+    readonly workflowsDest: string;
+    readonly claudeConfigDir: string;
+    readonly manifestPath: string;
+    readonly workflowsManifestPath: string;
+    readonly patchesDir: string;
+    readonly clancyProjectDir: string;
+};
+/**
+ * File system operations the orchestrator performs directly.
+ *
+ * `mkdir` must be idempotent (recursive, ignoring EEXIST) — the pipeline
+ * calls it unconditionally on paths that may already exist during updates.
+ */
+type InstallerFs = {
+    readonly exists: (path: string) => boolean;
+    readonly readFile: (path: string) => string;
+    readonly writeFile: (path: string, content: string) => void;
+    /** Create a directory recursively (must not throw on existing dirs). */
+    readonly mkdir: (path: string) => void;
+    readonly copyFile: (src: string, dest: string) => void;
+    /** Throw if the given path is a symlink. Swallow ENOENT. */
+    readonly rejectSymlink: (path: string) => void;
+};
+/**
+ * Prompt API used by the orchestrator.
+ *
+ * Only `ask` is called by {@link runInstall}. The caller owns the prompt
+ * lifecycle — create before calling `runInstall`, close after it returns.
+ */
+type InstallerPrompts = {
+    readonly ask: (label: string) => Promise<string>;
+};
+/** Options for {@link runInstall}. */
+export type RunInstallOptions = {
+    readonly mode: InstallMode;
+    readonly paths: InstallPaths;
+    readonly sources: InstallSources;
+    readonly version: string;
+    readonly nonInteractive: boolean;
+    readonly prompts: InstallerPrompts;
+    readonly fs: InstallerFs;
+    readonly cwd: string;
+    readonly now?: () => string;
+};
+/**
+ * Parse `--global` / `--local` from CLI arguments.
+ *
+ * When present the installer runs non-interactively — no prompts are shown.
+ * Used by the `/clancy:update` workflow for unattended updates.
+ *
+ * @param args - CLI arguments (typically `process.argv.slice(2)`).
+ * @returns The install mode, or `null` if no flag was provided.
+ */
+export declare function parseInstallFlag(args: readonly string[]): InstallMode | null;
+/**
+ * Compute all destination paths for an installation.
+ *
+ * Global installs target `~/.claude`; local installs target `<cwd>/.claude`.
+ * The `.clancy/` project directory always resolves to `cwd` regardless of
+ * mode — runtime scripts run relative to the project root.
+ *
+ * @param mode - Global or local install target.
+ * @param homeDir - The user's home directory.
+ * @param cwd - The current working directory.
+ * @returns All resolved destination paths.
+ */
+export declare function resolveInstallPaths(mode: InstallMode, homeDir: string, cwd: string): InstallPaths;
+/**
+ * Parse enabled optional roles from the project's `.clancy/.env` file.
+ *
+ * Returns `null` when no `.clancy/.env` exists (first install — install all
+ * roles as a safe default). Returns an empty set when the file exists but
+ * `CLANCY_ROLES` is unset or empty, so optional roles are truly opt-in.
+ *
+ * @param projectRoot - The project root containing `.clancy/`.
+ * @param fs - File system operations (injected for testability).
+ * @returns A set of enabled role names, or `null` for first install.
+ */
+export declare function parseEnabledRoles(projectRoot: string, fs: EnvFileSystem): ReadonlySet<string> | null;
+/**
+ * Validate that all required source directories and files exist.
+ *
+ * Guards against a corrupted npm package. Throws on the first missing path.
+ * `agentsDir` is intentionally not validated — the verification gate prompt
+ * is read best-effort in {@link registerHooks} and skipped if missing.
+ *
+ * @param sources - The source directories to check.
+ * @param exists - File existence check (injected for testability).
+ * @returns Nothing — throws on the first missing path.
+ */
+export declare function validateSources(sources: InstallSources, exists: (path: string) => boolean): void;
+/**
+ * Run the full installation pipeline.
+ *
+ * Validates sources, handles existing installations (detect modified, prompt,
+ * backup), copies role files, writes metadata, sets up the project runtime
+ * directory, and registers hooks. Returns normally on success or user abort.
+ *
+ * @param options - All dependencies and configuration for the install.
+ * @returns Resolves on success or user abort.
+ */
+export declare function runInstall(options: RunInstallOptions): Promise<void>;
+export {};
+//# sourceMappingURL=install.d.ts.map

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

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

package/dist/installer/install/install.js

@@ -0,0 +1,255 @@
+import { dirname, join } from 'node:path';
+import { inlineWorkflows } 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 { copyRoleFiles } from '../../installer/role-filter/role-filter.js';
+import { printSuccess } from '../../installer/ui/ui.js';
+import { blue, dim, green } from '../../shared/ansi/index.js';
+import { loadClancyEnv } from '@chief-clancy/core';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Bundled runtime scripts that are copied to `.clancy/` in the project. */
+const BUNDLE_SCRIPTS = ['clancy-implement.js', 'clancy-autopilot.js'];
+// ---------------------------------------------------------------------------
+// Pure functions
+// ---------------------------------------------------------------------------
+/**
+ * Parse `--global` / `--local` from CLI arguments.
+ *
+ * When present the installer runs non-interactively — no prompts are shown.
+ * Used by the `/clancy:update` workflow for unattended updates.
+ *
+ * @param args - CLI arguments (typically `process.argv.slice(2)`).
+ * @returns The install mode, or `null` if no flag was provided.
+ */
+export function parseInstallFlag(args) {
+    if (args.includes('--global'))
+        return 'global';
+    if (args.includes('--local'))
+        return 'local';
+    return null;
+}
+/**
+ * Compute all destination paths for an installation.
+ *
+ * Global installs target `~/.claude`; local installs target `<cwd>/.claude`.
+ * The `.clancy/` project directory always resolves to `cwd` regardless of
+ * mode — runtime scripts run relative to the project root.
+ *
+ * @param mode - Global or local install target.
+ * @param homeDir - The user's home directory.
+ * @param cwd - The current working directory.
+ * @returns All resolved destination paths.
+ */
+export function resolveInstallPaths(mode, homeDir, cwd) {
+    const baseDir = mode === 'global' ? join(homeDir, '.claude') : join(cwd, '.claude');
+    return {
+        commandsDest: join(baseDir, 'commands', 'clancy'),
+        workflowsDest: join(baseDir, 'clancy', 'workflows'),
+        claudeConfigDir: baseDir,
+        manifestPath: join(baseDir, 'clancy', 'manifest.json'),
+        workflowsManifestPath: join(baseDir, 'clancy', 'workflows-manifest.json'),
+        patchesDir: join(baseDir, 'clancy', 'local-patches'),
+        clancyProjectDir: join(cwd, '.clancy'),
+    };
+}
+/**
+ * Parse enabled optional roles from the project's `.clancy/.env` file.
+ *
+ * Returns `null` when no `.clancy/.env` exists (first install — install all
+ * roles as a safe default). Returns an empty set when the file exists but
+ * `CLANCY_ROLES` is unset or empty, so optional roles are truly opt-in.
+ *
+ * @param projectRoot - The project root containing `.clancy/`.
+ * @param fs - File system operations (injected for testability).
+ * @returns A set of enabled role names, or `null` for first install.
+ */
+export function parseEnabledRoles(projectRoot, fs) {
+    const env = loadClancyEnv(projectRoot, fs);
+    if (!env)
+        return null;
+    const roles = env.CLANCY_ROLES;
+    if (!roles)
+        return new Set();
+    const normalised = roles
+        .split(',')
+        .map((r) => r.trim().toLowerCase())
+        .filter(Boolean);
+    return new Set(normalised);
+}
+/** Throw if a required path does not exist. */
+function requirePath(label, path, exists) {
+    if (!exists(path)) {
+        throw new Error(`${label} not found: ${path}`);
+    }
+}
+/**
+ * Validate that all required source directories and files exist.
+ *
+ * Guards against a corrupted npm package. Throws on the first missing path.
+ * `agentsDir` is intentionally not validated — the verification gate prompt
+ * is read best-effort in {@link registerHooks} and skipped if missing.
+ *
+ * @param sources - The source directories to check.
+ * @param exists - File existence check (injected for testability).
+ * @returns Nothing — throws on the first missing path.
+ */
+export function validateSources(sources, exists) {
+    requirePath('Roles source', sources.rolesDir, exists);
+    requirePath('Hooks source', sources.hooksDir, exists);
+    requirePath('Runtime bundles source', sources.bundleDir, exists);
+    BUNDLE_SCRIPTS.forEach((script) => {
+        requirePath(`Bundled script ${script}`, join(sources.bundleDir, script), exists);
+    });
+}
+// ---------------------------------------------------------------------------
+// Pipeline steps
+// ---------------------------------------------------------------------------
+/** Print a list of modified files the user should know about. */
+function printModifiedFiles(modified) {
+    console.log(blue('  Modified files detected:'));
+    modified.forEach(({ rel }) => console.log(`    ${dim('•')} ${rel}`));
+    console.log('');
+    console.log(dim('  These will be backed up before overwriting.'));
+    console.log('');
+}
+/** Back up modified files and log the result. */
+function backupAndReport(modified, patchesDir) {
+    const backedUp = backupModifiedFiles(modified, patchesDir);
+    const message = backedUp
+        ? green('\n  ✓ Modified files backed up to local-patches/')
+        : dim('\n  No files needed backup (removed before copy).');
+    console.log(message);
+}
+/** Confirm overwrite — auto-accepts in non-interactive mode. */
+async function confirmOverwrite(nonInteractive, prompts) {
+    if (nonInteractive) {
+        console.log(dim('  Auto-overwriting (non-interactive mode).'));
+        return true;
+    }
+    const answer = await prompts.ask(blue(`  Overwrite existing installation? [y/N] `));
+    return answer.trim().toLowerCase().startsWith('y');
+}
+/** Detect modified files, prompt for overwrite, and back up if needed. */
+async function handleExistingInstall(options) {
+    const { paths, nonInteractive, prompts, exists } = options;
+    const hasExisting = exists(paths.commandsDest) || exists(paths.workflowsDest);
+    if (!hasExisting)
+        return true;
+    const cmdModified = detectModifiedFiles(paths.commandsDest, paths.manifestPath);
+    const wfModified = detectModifiedFiles(paths.workflowsDest, paths.workflowsManifestPath);
+    const allModified = [...cmdModified, ...wfModified];
+    if (allModified.length > 0)
+        printModifiedFiles(allModified);
+    const confirmed = await confirmOverwrite(nonInteractive, prompts);
+    if (!confirmed)
+        return false;
+    if (allModified.length > 0)
+        backupAndReport(allModified, paths.patchesDir);
+    return true;
+}
+/** Copy role files, inline workflows, and write manifests. */
+function installContent(options) {
+    const { mode, paths, sources, version, enabledRoles, fs } = options;
+    copyRoleFiles({
+        rolesDir: sources.rolesDir,
+        subdir: 'commands',
+        dest: paths.commandsDest,
+        enabledRoles,
+    });
+    copyRoleFiles({
+        rolesDir: sources.rolesDir,
+        subdir: 'workflows',
+        dest: paths.workflowsDest,
+        enabledRoles,
+    });
+    if (mode === 'global') {
+        inlineWorkflows(paths.commandsDest, paths.workflowsDest);
+    }
+    const versionPath = join(paths.commandsDest, 'VERSION');
+    fs.rejectSymlink(versionPath);
+    fs.writeFile(versionPath, version);
+    fs.mkdir(dirname(paths.manifestPath));
+    const cmdManifest = JSON.stringify(buildManifest(paths.commandsDest), null, 2);
+    const wfManifest = JSON.stringify(buildManifest(paths.workflowsDest), null, 2);
+    fs.rejectSymlink(paths.manifestPath);
+    fs.rejectSymlink(paths.workflowsManifestPath);
+    fs.writeFile(paths.manifestPath, cmdManifest);
+    fs.writeFile(paths.workflowsManifestPath, wfManifest);
+}
+/** Copy runtime bundles and write project-level metadata. */
+function setupProjectRuntime(options) {
+    const { paths, sources, version, fs } = options;
+    fs.rejectSymlink(paths.clancyProjectDir);
+    fs.mkdir(paths.clancyProjectDir);
+    BUNDLE_SCRIPTS.forEach((script) => {
+        const dest = join(paths.clancyProjectDir, script);
+        fs.rejectSymlink(dest);
+        fs.copyFile(join(sources.bundleDir, script), dest);
+    });
+    const pkgJsonPath = join(paths.clancyProjectDir, 'package.json');
+    fs.rejectSymlink(pkgJsonPath);
+    fs.writeFile(pkgJsonPath, JSON.stringify({ type: 'module' }, null, 2) + '\n');
+    const versionJsonPath = join(paths.clancyProjectDir, 'version.json');
+    const versionMeta = { version, installedAt: options.now() };
+    fs.rejectSymlink(versionJsonPath);
+    fs.writeFile(versionJsonPath, JSON.stringify(versionMeta, null, 2) + '\n');
+}
+/** Register Clancy hooks in Claude's settings.json. */
+function registerHooks(options) {
+    const { paths, sources, fs } = options;
+    const gatePromptPath = join(sources.agentsDir, 'verification-gate.md');
+    const verificationGatePrompt = fs.exists(gatePromptPath)
+        ? fs.readFile(gatePromptPath)
+        : undefined;
+    const success = installHooks({
+        claudeConfigDir: paths.claudeConfigDir,
+        hooksSourceDir: sources.hooksDir,
+        verificationGatePrompt,
+    });
+    if (!success) {
+        console.log(dim('  Warning: hooks could not be installed. Configure manually.'));
+    }
+}
+// ---------------------------------------------------------------------------
+// Main pipeline
+// ---------------------------------------------------------------------------
+/**
+ * Run the full installation pipeline.
+ *
+ * Validates sources, handles existing installations (detect modified, prompt,
+ * backup), copies role files, writes metadata, sets up the project runtime
+ * directory, and registers hooks. Returns normally on success or user abort.
+ *
+ * @param options - All dependencies and configuration for the install.
+ * @returns Resolves on success or user abort.
+ */
+export async function runInstall(options) {
+    const { mode, paths, sources, version, nonInteractive, prompts, fs, cwd } = options;
+    const now = options.now ?? (() => new Date().toISOString());
+    validateSources(sources, fs.exists);
+    console.log('');
+    console.log(dim(`  Installing to: ${paths.commandsDest}`));
+    const shouldContinue = await handleExistingInstall({
+        paths,
+        nonInteractive,
+        prompts,
+        exists: fs.exists,
+    });
+    if (!shouldContinue) {
+        console.log('\n  Aborted. No files changed.');
+        return;
+    }
+    const enabledRoles = mode === 'global'
+        ? null
+        : parseEnabledRoles(cwd, {
+            exists: fs.exists,
+            readFile: fs.readFile,
+        });
+    installContent({ mode, paths, sources, version, enabledRoles, fs });
+    setupProjectRuntime({ paths, sources, version, fs, now });
+    registerHooks({ paths, sources, fs });
+    printSuccess(enabledRoles);
+}
+//# sourceMappingURL=install.js.map

package/dist/installer/install/install.js.map

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

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

@@ -0,0 +1,2 @@
+export { backupModifiedFiles, buildManifest, detectModifiedFiles, } from './manifest.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/installer/manifest/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,mBAAmB,GACpB,MAAM,eAAe,CAAC"}

package/dist/installer/manifest/index.js

@@ -0,0 +1,2 @@
+export { backupModifiedFiles, buildManifest, detectModifiedFiles, } from './manifest.js';
+//# sourceMappingURL=index.js.map

package/dist/installer/manifest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/installer/manifest/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,mBAAmB,GACpB,MAAM,eAAe,CAAC"}

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

@@ -0,0 +1,46 @@
+/**
+ * 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.
+ */
+/** A file that has been modified by the user since last install. */
+type ModifiedFile = {
+    readonly rel: string;
+    readonly absPath: string;
+};
+/**
+ * Build a manifest of installed files with SHA-256 hashes.
+ *
+ * Recursively walks a directory and records the hash of every file.
+ * Symlinks and non-file entries are skipped.
+ *
+ * @param baseDir - Root directory to scan.
+ * @returns A record mapping relative paths to their SHA-256 hashes.
+ */
+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.
+ * Manifest keys containing path traversal sequences are rejected.
+ *
+ * @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): readonly ModifiedFile[];
+/**
+ * Back up modified files to a patches directory.
+ *
+ * Copies each modified file and writes a `backup-meta.json` with metadata.
+ * Files that vanish between detection and backup are silently skipped.
+ * Paths that escape the patches directory are rejected.
+ *
+ * @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: readonly ModifiedFile[], patchesDir: string): string | null;
+export {};
+//# 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":"AAAA;;;;;GAKG;AAeH,oEAAoE;AACpE,KAAK,YAAY,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAqDvE;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAErE;AAsDD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB,SAAS,YAAY,EAAE,CASzB;AA6BD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,YAAY,EAAE,EACjC,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAsBf"}