@shirayner/ace 0.1.0 → 0.1.1-snapshot.1

package/src/commands/init.js

@@ -1,37 +1,63 @@
 import chalk from 'chalk';
 import inquirer from 'inquirer';
-import { PRESETS, ROLES } from '../core/constants.js';
+import { createRequire } from 'module';
+import { PRESETS, ROLES, COMPONENTS } from '../core/constants.js';
 import { Installer } from '../core/installer.js';
+import {
+  printBanner, sectionHeader, stepDone, stepSkip, stepFail,
+  fileEntry, summaryBox, doneMessage, doneWithErrors, separator,
+  conflictHeader, conflictFile,
+  colors, icons, componentIcons, componentLabels,
+} from '../core/ui.js';
+
+const require = createRequire(import.meta.url);
+const pkg = require('../../package.json');
 
 export async function initCommand(options) {
-  console.log(chalk.bold('\n  ace - AI Coding Environment\n'));
+  // ─── Banner ──────────────────────────────────────────────────────
+  printBanner(pkg.version);
 
   let role = 'fullstack';
   let preset = options.preset;
 
-  // Interactive mode
+  // ─── Interactive prompts ─────────────────────────────────────────
   if (options.interaction !== false) {
     const answers = await inquirer.prompt([
       {
         type: 'list',
         name: 'role',
-        message: 'What is your primary role?',
+        message: `${icons.gear}  Your primary role?`,
         choices: Object.entries(ROLES).map(([key, val]) => ({
-          name: `${val.label} — ${val.description}`,
+          name: `${colors.white(val.label)} ${colors.dim('—')} ${colors.muted(val.description)}`,
           value: key,
+          short: val.label,
         })),
         default: 'fullstack',
+        prefix: colors.brand('?'),
       },
       {
         type: 'list',
         name: 'preset',
-        message: 'Installation scope?',
+        message: `${icons.package}  Installation scope?`,
         choices: [
-          { name: 'Full — All components (rules, skills, hooks, safety guards, memory)', value: 'full' },
-          { name: 'Safe — Core + rules + skills + safety guards + memory', value: 'safe' },
-          { name: 'Minimal — Core + rules + skills only', value: 'minimal' },
+          {
+            name: `${colors.white('Full')} ${colors.dim('—')} ${colors.muted('All components (rules, plugin, hooks, safety guards, memory)')}`,
+            value: 'full',
+            short: 'Full',
+          },
+          {
+            name: `${colors.white('Safe')} ${colors.dim('—')} ${colors.muted('Core + rules + plugin + safety guards + memory')}`,
+            value: 'safe',
+            short: 'Safe',
+          },
+          {
+            name: `${colors.white('Minimal')} ${colors.dim('—')} ${colors.muted('Core + rules + plugin only')}`,
+            value: 'minimal',
+            short: 'Minimal',
+          },
         ],
         default: 'full',
+        prefix: colors.brand('?'),
       },
     ]);
     role = answers.role;
@@ -40,59 +66,150 @@ export async function initCommand(options) {
 
   const components = PRESETS[preset];
   if (!components) {
-    console.error(chalk.red(`Unknown preset: ${preset}. Available: ${Object.keys(PRESETS).join(', ')}`));
+    console.error(colors.error(`  ${icons.cross} Unknown preset: ${preset}. Available: ${Object.keys(PRESETS).join(', ')}`));
     process.exit(1);
   }
 
-  console.log(chalk.dim(`\n  Role: ${ROLES[role].label}`));
-  console.log(chalk.dim(`  Preset: ${preset}`));
-  console.log(chalk.dim(`  Components: ${components.join(', ')}`));
-  if (options.force) console.log(chalk.yellow('  Force mode: existing files will be overwritten'));
-  if (options.dryRun) console.log(chalk.cyan('  Dry-run mode: no changes will be made'));
+  // ─── Config summary ──────────────────────────────────────────────
   console.log();
+  console.log(`  ${colors.dim('│')}  ${colors.dim('Role')}     ${colors.white(ROLES[role].label)}`);
+  console.log(`  ${colors.dim('│')}  ${colors.dim('Preset')}   ${colors.white(preset)}`);
+  console.log(`  ${colors.dim('│')}  ${colors.dim('Scope')}    ${components.map(c => componentLabels[c] || c).join(colors.dim(', '))}`);
+  if (options.force) {
+    console.log(`  ${colors.dim('│')}  ${colors.warning(`${icons.warn} Force mode — existing files will be overwritten`)}`);
+  }
+  if (options.dryRun) {
+    console.log(`  ${colors.dim('│')}  ${colors.accent(`${icons.info} Dry-run mode — no changes will be made`)}`);
+  }
 
+  // ─── Conflict detection & category confirmation ──────────────────
   const installer = new Installer({
     force: options.force,
     dryRun: options.dryRun,
     role,
     components,
+    quiet: true,
   });
 
-  const results = installer.run();
+  let resolutions = {};
 
-  // Wait for async
-  const { installed, skipped, merged, errors } = await results;
+  if (!options.force && options.interaction !== false) {
+    const conflicts = await installer.detectConflicts();
+    const conflictKeys = Object.keys(conflicts);
 
-  // Summary
-  console.log(chalk.bold('\n  Installation Summary\n'));
+    if (conflictKeys.length > 0) {
+      console.log();
+      sectionHeader(icons.warn, 'Existing files detected');
+      console.log(`  ${colors.dim('│')}  ${colors.muted('Some files already exist. Choose how to handle each category:')}`);
+      console.log(`  ${colors.dim('│')}  ${colors.muted(`CLAUDE.md ${icons.arrowR} always smart-merge (append new refs only)`)}`);
+      console.log(`  ${colors.dim('│')}  ${colors.muted(`settings.json ${icons.arrowR} always deep-merge (preserve your settings)`)}`);
 
-  if (installed.length > 0) {
-    console.log(chalk.green(`  Installed (${installed.length}):`));
-    installed.forEach(f => console.log(chalk.green(`    + ${f}`)));
-  }
+      for (const componentName of conflictKeys) {
+        const { files } = conflicts[componentName];
+        const icon = componentIcons[componentName] || icons.file;
+        const label = componentLabels[componentName] || componentName;
+
+        conflictHeader(label, icon, files.length);
+        for (const f of files) {
+          conflictFile(f.replace(/\\/g, '/'));
+        }
+      }
 
-  if (merged.length > 0) {
-    console.log(chalk.blue(`  Merged (${merged.length}):`));
-    merged.forEach(m => {
-      const detail = m.added ? ` (added ${m.added.length} refs)` : '';
-      console.log(chalk.blue(`    ~ ${m.file}${detail}`));
-    });
+      console.log();
+      const conflictAnswers = await inquirer.prompt(
+        conflictKeys.map((componentName) => {
+          const icon = componentIcons[componentName] || icons.file;
+          const label = componentLabels[componentName] || componentName;
+          const count = conflicts[componentName].files.length;
+          return {
+            type: 'list',
+            name: componentName,
+            message: `${icon}  ${label} (${count} files)`,
+            choices: [
+              {
+                name: `${colors.muted('Skip')} ${colors.dim('— keep existing files')}`,
+                value: 'skip',
+                short: 'Skip',
+              },
+              {
+                name: `${colors.warning('Overwrite')} ${colors.dim('— replace with ace templates')}`,
+                value: 'overwrite',
+                short: 'Overwrite',
+              },
+            ],
+            default: 'skip',
+            prefix: colors.brand('?'),
+          };
+        })
+      );
+
+      resolutions = conflictAnswers;
+    }
   }
 
-  if (skipped.length > 0) {
-    console.log(chalk.yellow(`  Skipped (${skipped.length}) — already exist:`));
-    skipped.forEach(f => console.log(chalk.yellow(`    - ${f}`)));
+  // Apply resolutions to installer
+  installer.resolutions = resolutions;
+
+  // ─── Installation ────────────────────────────────────────────────
+  console.log();
+  sectionHeader(icons.rocket, 'Installing components');
+
+  for (const componentName of components) {
+    const component = COMPONENTS[componentName];
+    if (!component) continue;
+
+    const icon = componentIcons[componentName] || icons.file;
+    const label = componentLabels[componentName] || componentName;
+
+    const beforeInstalled = installer.results.installed.length;
+    const beforeMerged = installer.results.merged.length;
+    const beforeSkipped = installer.results.skipped.length;
+
+    try {
+      await installer.installComponent(componentName, component);
+      const newInstalled = installer.results.installed.length - beforeInstalled;
+      const newMerged = installer.results.merged.length - beforeMerged;
+      const newSkipped = installer.results.skipped.length - beforeSkipped;
+
+      const parts = [];
+      if (newInstalled > 0) parts.push(colors.success(`${newInstalled} installed`));
+      if (newMerged > 0) parts.push(colors.blue(`${newMerged} merged`));
+      if (newSkipped > 0) parts.push(colors.muted(`${newSkipped} skipped`));
+      const detail = parts.length > 0 ? ` ${colors.dim('—')} ${parts.join(colors.dim(', '))}` : '';
+
+      stepDone(`${icon}  ${label}${detail}`);
+    } catch (err) {
+      stepFail(`${icon}  ${label} ${colors.dim('—')} ${colors.error(err.message)}`);
+      installer.results.errors.push({ component: componentName, error: err.message });
+    }
   }
 
-  if (errors.length > 0) {
-    console.log(chalk.red(`  Errors (${errors.length}):`));
-    errors.forEach(e => console.log(chalk.red(`    ! ${e.file || e.component}: ${e.error}`)));
+  const { installed, skipped, merged, errors } = installer.results;
+
+  // ─── Detailed file list ──────────────────────────────────────────
+  if (installed.length > 0 || merged.length > 0 || skipped.length > 0) {
+    separator();
+    sectionHeader(icons.file, 'File details');
+    for (const f of installed) fileEntry('install', f.replace(/\\/g, '/'));
+    for (const m of merged) {
+      const detail = m.added ? ` (${m.added.length} refs)` : '';
+      fileEntry('merge', `${m.file.replace(/\\/g, '/')}${detail}`);
+    }
+    for (const f of skipped) fileEntry('skip', f.replace(/\\/g, '/'));
+    for (const e of errors) fileEntry('error', `${(e.file || e.component).replace(/\\/g, '/')}: ${e.error}`);
   }
 
+  // ─── Summary ─────────────────────────────────────────────────────
+  summaryBox({
+    installed: installed.length,
+    merged: merged.length,
+    skipped: skipped.length,
+    errors: errors.length,
+  });
+
   if (errors.length === 0) {
-    console.log(chalk.green.bold('\n  Done! Your AI coding environment is ready.\n'));
-    console.log(chalk.dim('  Run `ace doctor` to verify the installation.'));
+    doneMessage();
   } else {
-    console.log(chalk.yellow('\n  Completed with errors. Run `ace doctor` to diagnose.\n'));
+    doneWithErrors();
   }
 }

package/src/core/constants.js

@@ -94,12 +94,16 @@ export const COMPONENTS = {
     ],
   },
   hookify: {
-    description: 'Safety guard rules (block dangerous ops, protect secrets, require verification)',
+    description: 'Safety guard rules (block dangerous ops, protect secrets, safe git, code quality, require verification)',
     required: false,
     files: [
-      { src: 'hookify/ace.hookify.block-dangerous-ops.local.md', dest: 'ace.hookify.block-dangerous-ops.local.md' },
-      { src: 'hookify/ace.hookify.protect-secrets.local.md', dest: 'ace.hookify.protect-secrets.local.md' },
-      { src: 'hookify/ace.hookify.require-verification.local.md', dest: 'ace.hookify.require-verification.local.md' },
+      { src: 'hookify/ace.hookify.block-dangerous-ops.local.md', dest: 'hooks/ace.hookify.block-dangerous-ops.local.md' },
+      { src: 'hookify/ace.hookify.protect-secrets.local.md', dest: 'hooks/ace.hookify.protect-secrets.local.md' },
+      { src: 'hookify/ace.hookify.safe-git-commands.local.md', dest: 'hooks/ace.hookify.safe-git-commands.local.md' },
+      { src: 'hookify/ace.hookify.code-quality-gate.local.md', dest: 'hooks/ace.hookify.code-quality-gate.local.md' },
+      { src: 'hookify/ace.hookify.require-verification.local.md', dest: 'hooks/ace.hookify.require-verification.local.md' },
+      { src: 'hookify/hookify.dangerous-commands.local.md', dest: 'hooks/hookify.dangerous-commands.local.md' },
+      { src: 'hookify/hookify.sensitive-data.local.md', dest: 'hooks/hookify.sensitive-data.local.md' },
     ],
   },
   memory: {

package/src/core/installer.js

@@ -19,6 +19,76 @@ export class Installer {
     this.role = options.role || 'fullstack';
     this.components = options.components || [];
     this.results = { installed: [], skipped: [], merged: [], errors: [] };
+    // Per-component resolution: { componentName: 'overwrite' | 'skip' }
+    this.resolutions = options.resolutions || {};
+    // Suppress inline console.log when caller handles UI
+    this.quiet = options.quiet || false;
+  }
+
+  /**
+   * Detect conflicts for all components before installation.
+   * Returns: { componentName: { files: [...conflicting dest paths], hasMerge: bool } }
+   */
+  async detectConflicts() {
+    const conflicts = {};
+
+    for (const componentName of this.components) {
+      const component = COMPONENTS[componentName];
+      if (!component) continue;
+
+      // Plugin always overwrites — no conflict prompt needed
+      if (component.isPlugin) continue;
+
+      const conflicting = [];
+      let hasMerge = false;
+
+      // Check rulesDir files
+      if (component.rulesDir) {
+        const srcDir = path.join(this.templatesDir, component.rulesDir);
+        if (await fs.pathExists(srcDir)) {
+          const files = await fs.readdir(srcDir);
+          for (const file of files) {
+            if (!file.endsWith('.md')) continue;
+            const destPath = path.join(this.targetDir, component.rulesDir, file);
+            if (await fs.pathExists(destPath)) {
+              conflicting.push(path.join(component.rulesDir, file));
+            }
+          }
+        }
+      }
+
+      // Check regular files
+      if (component.files) {
+        for (const file of component.files) {
+          const destPath = path.join(this.targetDir, file.dest);
+          if (await fs.pathExists(destPath)) {
+            if (file.merge === 'claude-md' || file.merge === 'settings-json') {
+              hasMerge = true;
+            } else if (file.merge !== 'skip-existing') {
+              conflicting.push(file.dest);
+            }
+          }
+        }
+      }
+
+      // Check conditional files
+      if (component.conditional) {
+        for (const file of component.conditional) {
+          if (file.roles && file.roles.includes(this.role)) {
+            const destPath = path.join(this.targetDir, file.dest);
+            if (await fs.pathExists(destPath)) {
+              conflicting.push(file.dest);
+            }
+          }
+        }
+      }
+
+      if (conflicting.length > 0) {
+        conflicts[componentName] = { files: conflicting, hasMerge };
+      }
+    }
+
+    return conflicts;
   }
 
   async run() {
@@ -51,19 +121,19 @@ export class Installer {
     }
 
     if (component.rulesDir) {
-      await this.installRulesDir(component.rulesDir);
+      await this.installRulesDir(component.rulesDir, name);
     }
 
     if (component.files) {
       for (const file of component.files) {
-        await this.installFile(file);
+        await this.installFile(file, name);
       }
     }
 
     if (component.conditional) {
       for (const file of component.conditional) {
         if (file.roles && file.roles.includes(this.role)) {
-          await this.installFile(file);
+          await this.installFile(file, name);
         }
       }
     }
@@ -91,9 +161,9 @@ export class Installer {
     const destDir = path.join(PLUGIN_CACHE_DIR, version);
 
     if (this.dryRun) {
-      console.log(chalk.cyan(`  [dry-run] Would create marketplace ${MARKETPLACE_NAME}`));
-      console.log(chalk.cyan(`  [dry-run] Would install plugin ${PLUGIN_KEY} v${version} to ${destDir}`));
-      console.log(chalk.cyan(`  [dry-run] Would update ${INSTALLED_PLUGINS_FILE}`));
+      !this.quiet && console.log(chalk.cyan(`  [dry-run] Would create marketplace ${MARKETPLACE_NAME}`));
+      !this.quiet && console.log(chalk.cyan(`  [dry-run] Would install plugin ${PLUGIN_KEY} v${version} to ${destDir}`));
+      !this.quiet && console.log(chalk.cyan(`  [dry-run] Would update ${INSTALLED_PLUGINS_FILE}`));
       this.results.installed.push(`plugin:${PLUGIN_KEY} v${version}`);
       return;
     }
@@ -152,7 +222,7 @@ export class Installer {
     this.results.merged.push({ file: 'plugins/known_marketplaces.json' });
   }
 
-  async installRulesDir(rulesDir) {
+  async installRulesDir(rulesDir, componentName) {
     const srcDir = path.join(this.templatesDir, rulesDir);
     if (!await fs.pathExists(srcDir)) {
       this.results.errors.push({ file: rulesDir, error: 'Rules directory not found' });
@@ -164,11 +234,11 @@ export class Installer {
       await this.installFile({
         src: path.join(rulesDir, file),
         dest: path.join(rulesDir, file),
-      });
+      }, componentName);
     }
   }
 
-  async installFile(fileSpec) {
+  async installFile(fileSpec, componentName) {
     const srcPath = path.join(this.templatesDir, fileSpec.src);
     const destPath = path.join(this.targetDir, fileSpec.dest);
 
@@ -193,12 +263,19 @@ export class Installer {
         await this.mergeSettingsJsonFile(srcPath, destPath, fileSpec);
         return;
       }
-      this.results.skipped.push(fileSpec.dest);
-      return;
+      // Check per-component resolution
+      const resolution = this.resolutions[componentName];
+      if (resolution === 'overwrite') {
+        // fall through to install
+      } else {
+        // default: skip
+        this.results.skipped.push(fileSpec.dest);
+        return;
+      }
     }
 
     if (this.dryRun) {
-      console.log(chalk.cyan(`  [dry-run] Would install: ${fileSpec.dest}`));
+      !this.quiet && console.log(chalk.cyan(`  [dry-run] Would install: ${fileSpec.dest}`));
       this.results.installed.push(fileSpec.dest);
       return;
     }
@@ -228,7 +305,7 @@ export class Installer {
     }
 
     if (this.dryRun) {
-      console.log(chalk.cyan(`  [dry-run] Would install directory: ${dir}`));
+      !this.quiet && console.log(chalk.cyan(`  [dry-run] Would install directory: ${dir}`));
       this.results.installed.push(dir);
       return;
     }
@@ -249,7 +326,7 @@ export class Installer {
     }
 
     if (this.dryRun) {
-      console.log(chalk.cyan(`  [dry-run] Would merge CLAUDE.md, adding ${added.length} references`));
+      !this.quiet && console.log(chalk.cyan(`  [dry-run] Would merge CLAUDE.md, adding ${added.length} references`));
       this.results.merged.push({ file: fileSpec.dest, added });
       return;
     }
@@ -271,7 +348,7 @@ export class Installer {
     }
 
     if (this.dryRun) {
-      console.log(chalk.cyan(`  [dry-run] Would merge settings.json`));
+      !this.quiet && console.log(chalk.cyan(`  [dry-run] Would merge settings.json`));
       this.results.merged.push({ file: fileSpec.dest });
       return;
     }
@@ -297,7 +374,7 @@ export class Installer {
     }
 
     if (this.dryRun) {
-      console.log(chalk.cyan(`  [dry-run] Would install user profile template for role: ${this.role}`));
+      !this.quiet && console.log(chalk.cyan(`  [dry-run] Would install user profile template for role: ${this.role}`));
       this.results.installed.push('memory/user_profile.md');
       return;
     }

package/src/core/ui.js

@@ -0,0 +1,182 @@
+import chalk from 'chalk';
+
+// ─── Icons ───────────────────────────────────────────────────────────
+export const icons = {
+  ace:       '◆',
+  check:     '✔',
+  cross:     '✖',
+  arrow:     '▶',
+  arrowR:    '→',
+  dot:       '●',
+  circle:    '○',
+  warn:      '⚠',
+  info:      'ℹ',
+  skip:      '◇',
+  merge:     '⇄',
+  folder:    '▸',
+  shield:    '🛡',
+  gear:      '⚙',
+  rocket:    '🚀',
+  sparkles:  '✨',
+  package:   '📦',
+  file:      '📄',
+  brain:     '🧠',
+  hook:      '🪝',
+  guard:     '🔒',
+  memory:    '💾',
+  plug:      '🔌',
+};
+
+// ─── Colors ──────────────────────────────────────────────────────────
+export const colors = {
+  brand:    chalk.hex('#7C3AED'),   // vibrant purple
+  accent:   chalk.hex('#06B6D4'),   // cyan
+  success:  chalk.hex('#10B981'),   // emerald
+  warning:  chalk.hex('#F59E0B'),   // amber
+  error:    chalk.hex('#EF4444'),   // red
+  dim:      chalk.hex('#6B7280'),   // gray
+  muted:    chalk.hex('#9CA3AF'),   // light gray
+  white:    chalk.hex('#F9FAFB'),   // near white
+  blue:     chalk.hex('#3B82F6'),   // blue
+};
+
+// ─── ASCII Banner ────────────────────────────────────────────────────
+export function printBanner(version) {
+  const purple = colors.brand;
+  const dim = colors.dim;
+
+  console.log();
+  console.log(purple('    ╔═══╗  ╔═══╗  ╔═══╗'));
+  console.log(purple('    ╠═══╣  ║     ╠═══╝'));
+  console.log(purple('    ║   ║  ╚═══╝  ╚═══╗'));
+  console.log();
+  console.log(`    ${purple.bold('ace')} ${dim(`v${version}`)} ${dim('— AI Coding Environment')}`);
+  console.log();
+}
+
+// ─── Section Header ──────────────────────────────────────────────────
+export function sectionHeader(icon, title) {
+  console.log(`  ${icon}  ${colors.white.bold(title)}`);
+}
+
+// ─── Step indicator ──────────────────────────────────────────────────
+export function stepStart(label) {
+  process.stdout.write(`  ${colors.dim('│')}\n`);
+  process.stdout.write(`  ${colors.brand(icons.dot)}  ${label}\n`);
+}
+
+export function stepDone(label) {
+  process.stdout.write(`  ${colors.success(icons.check)}  ${label}\n`);
+}
+
+export function stepSkip(label) {
+  process.stdout.write(`  ${colors.muted(icons.skip)}  ${colors.muted(label)}\n`);
+}
+
+export function stepWarn(label) {
+  process.stdout.write(`  ${colors.warning(icons.warn)}  ${label}\n`);
+}
+
+export function stepFail(label) {
+  process.stdout.write(`  ${colors.error(icons.cross)}  ${label}\n`);
+}
+
+// ─── File list (compact) ─────────────────────────────────────────────
+export function fileEntry(action, filePath) {
+  const prefix = {
+    install:  `  ${colors.success('+')}`,
+    merge:    `  ${colors.blue('~')}`,
+    skip:     `  ${colors.muted('-')}`,
+    overwrite:`  ${colors.warning('!')}`,
+    error:    `  ${colors.error('✖')}`,
+  };
+  const color = {
+    install:  colors.success,
+    merge:    colors.blue,
+    skip:     colors.muted,
+    overwrite:colors.warning,
+    error:    colors.error,
+  };
+  console.log(`${prefix[action] || '   '} ${(color[action] || colors.dim)(filePath)}`);
+}
+
+// ─── Summary Box ─────────────────────────────────────────────────────
+export function summaryBox(stats) {
+  const { installed, merged, skipped, errors } = stats;
+
+  console.log();
+  console.log(`  ${colors.dim('╭─────────────────────────────────────╮')}`);
+  console.log(`  ${colors.dim('│')}  ${colors.white.bold('Installation Summary')}              ${colors.dim('│')}`);
+  console.log(`  ${colors.dim('├─────────────────────────────────────┤')}`);
+
+  if (installed > 0) {
+    console.log(`  ${colors.dim('│')}  ${colors.success(icons.check)} ${colors.success(`${installed} installed`)}${pad(installed, 'installed')}${colors.dim('│')}`);
+  }
+  if (merged > 0) {
+    console.log(`  ${colors.dim('│')}  ${colors.blue(icons.merge)} ${colors.blue(`${merged} merged`)}${pad(merged, 'merged')}${colors.dim('│')}`);
+  }
+  if (skipped > 0) {
+    console.log(`  ${colors.dim('│')}  ${colors.muted(icons.skip)} ${colors.muted(`${skipped} skipped`)}${pad(skipped, 'skipped')}${colors.dim('│')}`);
+  }
+  if (errors > 0) {
+    console.log(`  ${colors.dim('│')}  ${colors.error(icons.cross)} ${colors.error(`${errors} errors`)}${pad(errors, 'errors')}${colors.dim('│')}`);
+  }
+
+  console.log(`  ${colors.dim('╰─────────────────────────────────────╯')}`);
+}
+
+function pad(count, label) {
+  const text = `${count} ${label}`;
+  const total = 33;
+  const spaces = total - text.length - 4; // 4 = icon + spaces
+  return ' '.repeat(Math.max(1, spaces));
+}
+
+// ─── Final message ───────────────────────────────────────────────────
+export function doneMessage() {
+  console.log();
+  console.log(`  ${icons.rocket} ${colors.success.bold('Your AI coding environment is ready.')}`);
+  console.log(`  ${colors.dim(`Run ${chalk.white('ace doctor')} to verify the installation.`)}`);
+  console.log();
+}
+
+export function doneWithErrors() {
+  console.log();
+  console.log(`  ${icons.warn} ${colors.warning.bold('Completed with errors.')}`);
+  console.log(`  ${colors.dim(`Run ${chalk.white('ace doctor')} to diagnose.`)}`);
+  console.log();
+}
+
+// ─── Separator ───────────────────────────────────────────────────────
+export function separator() {
+  console.log(`  ${colors.dim('│')}`);
+}
+
+// ─── Conflict prompt helpers ─────────────────────────────────────────
+export function conflictHeader(componentName, icon, fileCount) {
+  console.log();
+  console.log(`  ${colors.warning(icons.warn)}  ${icon}  ${colors.white.bold(componentName)} — ${colors.warning(`${fileCount} file(s) already exist`)}`);
+}
+
+export function conflictFile(filePath) {
+  console.log(`       ${colors.dim(icons.arrowR)} ${colors.muted(filePath)}`);
+}
+
+// ─── Component icons ─────────────────────────────────────────────────
+export const componentIcons = {
+  core:    icons.gear,
+  rules:   icons.brain,
+  plugin:  icons.plug,
+  hooks:   icons.hook,
+  hookify: icons.guard,
+  memory:  icons.memory,
+};
+
+export const componentLabels = {
+  core:    'Core Config',
+  rules:   'Rules',
+  plugin:  'Plugin',
+  hooks:   'Hooks',
+  hookify: 'Safety Guards',
+  memory:  'Memory',
+};

package/templates/CLAUDE.md

@@ -15,5 +15,11 @@
 ## 质量控制
 - @~/.claude/rules/ace/memory-policy.md - Memory 质量策略
 
+## Hookify 规则
+- @~/.claude/hooks/ace.hookify.block-dangerous-ops.local.md - 阻止危险操作
+- @~/.claude/hooks/ace.hookify.protect-secrets.local.md - 保护敏感信息
+- @~/.claude/hooks/ace.hookify.safe-git-commands.local.md - Git 安全命令
+- @~/.claude/hooks/ace.hookify.code-quality-gate.local.md - 代码质量门禁
+
 ## 交互规则
 - @~/.claude/rules/ace/interactive-clarify.md - 交互式澄清规则