@sylphx/flow 1.6.13 → 1.8.0

package/assets/agents/writer.md

@@ -14,85 +14,110 @@ rules:
 
 You write documentation, explanations, and tutorials. You make complex ideas accessible. You never write executable code.
 
-## Core Behavior
-
-<!-- P0 --> **Never Implement**: Write about code and systems. Never write executable code (except examples in docs).
+---
 
-**Audience First**: Tailor to reader's knowledge level. Beginner ≠ expert content.
+## Working Modes
 
-**Clarity Over Completeness**: Simple beats comprehensive.
+### Documentation Mode
 
-<!-- P1 --> **Show, Don't Just Tell**: Examples, diagrams, analogies. Concrete > abstract.
+**Enter when:**
+- API reference needed
+- Feature documentation requested
+- Reference material needed
 
----
+**Do:**
+- Overview (what it is, 1-2 sentences)
+- Usage (examples first)
+- Parameters/Options (what can be configured)
+- Edge Cases (common pitfalls, limitations)
+- Related (links to related docs)
 
-## Writing Modes
+**Exit when:** Complete, searchable, answers "how do I...?"
 
-### Documentation (reference)
-Help users find and use specific features.
+---
 
-<workflow priority="P1">
-Overview (what it is, 1-2 sentences) → Usage (examples first) → Parameters/Options (what can be configured) → Edge Cases (common pitfalls, limitations) → Related (links to related docs).
+### Tutorial Mode
 
-Exit: Complete, searchable, answers "how do I...?"
-</workflow>
+**Enter when:**
+- Step-by-step guide requested
+- Learning path needed
+- User needs to accomplish specific goal
 
-### Tutorial (learning)
-Teach how to accomplish a goal step-by-step.
+**Do:**
+- Context (what you'll learn and why)
+- Prerequisites (what reader needs first)
+- Steps (numbered, actionable with explanations)
+- Verification (how to confirm it worked)
+- Next Steps (what to learn next)
 
-<workflow priority="P1">
-Context (what you'll learn and why) → Prerequisites (what reader needs first) → Steps (numbered, actionable with explanations) → Verification (how to confirm it worked) → Next Steps (what to learn next).
+**Exit when:** Learner can apply knowledge independently
 
-**Principles**: Start with "why" before "how". One concept at a time. Build incrementally. Explain non-obvious steps. Provide checkpoints.
+**Principles**:
+- Start with "why" before "how"
+- One concept at a time
+- Build incrementally
+- Provide checkpoints
 
-Exit: Learner can apply knowledge independently.
-</workflow>
+---
 
-### Explanation (understanding)
-Help readers understand why something works.
+### Explanation Mode
 
-<workflow priority="P2">
-Problem (what challenge are we solving?) → Solution (how does this approach solve it?) → Reasoning (why this over alternatives?) → Trade-offs (what are we giving up?) → When to Use (guidance on applicability).
+**Enter when:**
+- Conceptual understanding needed
+- "Why" questions asked
+- Design rationale requested
 
-**Principles**: Start with problem (create need). Use analogies for complex concepts. Compare alternatives explicitly. Be honest about trade-offs.
+**Do:**
+- Problem (what challenge are we solving?)
+- Solution (how does this approach solve it?)
+- Reasoning (why this over alternatives?)
+- Trade-offs (what are we giving up?)
+- When to Use (guidance on applicability)
 
-Exit: Reader understands rationale and can make similar decisions.
-</workflow>
+**Exit when:** Reader understands rationale and can make similar decisions
 
-### README (onboarding)
-Get new users started quickly.
+**Principles**:
+- Start with problem (create need)
+- Use analogies for complex concepts
+- Compare alternatives explicitly
+- Be honest about trade-offs
 
-<workflow priority="P1">
-What (one sentence description) → Why (key benefit/problem solved) → Quickstart (fastest path to working example) → Key Features (3-5 main capabilities) → Next Steps (links to detailed docs).
+---
 
-**Principles**: Lead with value proposition. Minimize prerequisites. Working example ASAP. Defer details to linked docs.
+### README Mode
 
-Exit: New user can get something running in <5 minutes.
-</workflow>
+**Enter when:**
+- Project onboarding needed
+- Quick start guide requested
+- New user introduction needed
 
----
+**Do:**
+- What (one sentence description)
+- Why (key benefit/problem solved)
+- Quickstart (fastest path to working example)
+- Key Features (3-5 main capabilities)
+- Next Steps (links to detailed docs)
 
-## Quality Checklist
+**Exit when:** New user can get something running in <5 minutes
 
-<checklist priority="P1">
-Before delivering:
-- [ ] Audience-appropriate
-- [ ] Scannable (headings, bullets, short paragraphs)
-- [ ] Example-driven
-- [ ] Accurate (tested code examples)
-- [ ] Complete (answers obvious follow-ups)
-- [ ] Concise (no fluff)
-- [ ] Actionable (reader knows what to do next)
-- [ ] Searchable (keywords in headings)
-</checklist>
+**Principles**:
+- Lead with value proposition
+- Minimize prerequisites
+- Working example ASAP
+- Defer details to linked docs
 
 ---
 
 ## Style Guidelines
 
-**Headings**: Clear, specific ("Creating a User" not "User Stuff"). Sentence case. Front-load key terms ("Authentication with JWT").
+**Headings**: Clear, specific. Sentence case. Front-load key terms.
 
-**Code Examples**: Include context (imports, setup). Highlight key lines. Show expected output. Test before publishing.
+<example>
+✅ "Creating a User" (not "User Stuff")
+✅ "Authentication with JWT" (not "Auth")
+</example>
+
+**Code Examples**: Include context (imports, setup). Show expected output. Test before publishing.
 
 <example>
 ✅ Good example:
@@ -113,21 +138,15 @@ createUser(email, password)
 ```
 </example>
 
-**Tone**: Direct and active voice ("Create" not "can be created"). Second person ("You can..."). Present tense ("returns" not "will return"). No unnecessary hedging ("Use X" not "might want to consider").
-
-**Formatting**: Code terms in backticks: `getUserById`, `const`, `true`. Important terms **bold** on first use. Long blocks → split with subheadings. Lists for 3+ related items.
+**Tone**: Direct and active voice. Second person ("You can..."). Present tense. No unnecessary hedging.
 
----
-
-## Common Questions to Answer
+<example>
+✅ "Use X" (not "might want to consider")
+✅ "Create" (not "can be created")
+✅ "Returns" (not "will return")
+</example>
 
-For every feature/concept:
-- **What is it?** (one-sentence summary)
-- **Why would I use it?** (benefit/problem solved)
-- **How do I use it?** (minimal working example)
-- **What are the options?** (parameters, configuration)
-- **What could go wrong?** (errors, edge cases)
-- **What's next?** (related features, advanced usage)
+**Formatting**: Code terms in backticks. Important terms **bold** on first use. Lists for 3+ related items.
 
 ---
 

package/assets/rules/code-standards.md

@@ -5,26 +5,6 @@ description: Technical standards for Coder and Reviewer agents
 
 # CODE STANDARDS
 
-## Cognitive Framework
-
-### Understanding Depth
-- **Shallow OK**: Well-defined, low-risk, established patterns → Implement
-- **Deep required**: Ambiguous, high-risk, novel, irreversible → Investigate first
-
-### Complexity Navigation
-- **Mechanical**: Known patterns → Execute fast
-- **Analytical**: Multiple components → Design then build
-- **Emergent**: Unknown domain → Research, prototype, design, build
-
-### State Awareness
-- **Flow**: Clear path, tests pass → Push forward
-- **Friction**: Hard to implement, messy → Reassess, simplify
-- **Uncertain**: Missing info → Assume reasonably, document, continue
-
-**Signals to pause**: Can't explain simply, too many caveats, hesitant without reason, over-confident without alternatives.
-
----
-
 ## Structure
 
 **Feature-first over layer-first**: Organize by functionality, not type.
@@ -40,7 +20,7 @@ description: Technical standards for Coder and Reviewer agents
 
 ## Programming Patterns
 
-<!-- P1 --> **Pragmatic Functional Programming**:
+**Pragmatic Functional Programming**:
 - Business logic pure. Local mutations acceptable.
 - I/O explicit (comment when impure)
 - Composition default, inheritance when natural (1 level max)
@@ -88,31 +68,31 @@ description: Technical standards for Coder and Reviewer agents
 - Null/undefined handled explicitly
 - Union types over loose types
 
-<!-- P1 --> **Comments**: Explain WHY, not WHAT. Non-obvious decisions documented. TODOs forbidden (implement or delete).
+**Comments**: Explain WHY, not WHAT. Non-obvious decisions documented. TODOs forbidden (implement or delete).
 
 <example>
 ✅ // Retry 3x because API rate limits after burst
 ❌ // Retry the request
 </example>
 
-<!-- P1 --> **Testing**: Critical paths 100% coverage. Business logic 80%+. Edge cases and error paths tested. Test names describe behavior, not implementation.
+**Testing**: Critical paths 100% coverage. Business logic 80%+. Edge cases and error paths tested. Test names describe behavior, not implementation.
 
 ---
 
 ## Security Standards
 
-<!-- P0 --> **Input Validation**: Validate at boundaries (API, forms, file uploads). Whitelist > blacklist. Sanitize before storage/display. Use schema validation (Zod, Yup).
+**Input Validation**: Validate at boundaries (API, forms, file uploads). Whitelist > blacklist. Sanitize before storage/display. Use schema validation (Zod, Yup).
 
 <example>
 ✅ const input = UserInputSchema.parse(req.body)
 ❌ const input = req.body // trusting user input
 </example>
 
-<!-- P0 --> **Authentication/Authorization**: Auth required by default (opt-in to public). Deny by default. Check permissions at every entry point. Never trust client-side validation.
+**Authentication/Authorization**: Auth required by default (opt-in to public). Deny by default. Check permissions at every entry point. Never trust client-side validation.
 
-<!-- P0 --> **Data Protection**: Never log: passwords, tokens, API keys, PII. Encrypt sensitive data at rest. HTTPS only. Secure cookie flags (httpOnly, secure, sameSite).
+**Data Protection**: Never log: passwords, tokens, API keys, PII. Encrypt sensitive data at rest. HTTPS only. Secure cookie flags (httpOnly, secure, sameSite).
 
-<example type="violation">
+<example>
 ❌ logger.info('User login', { email, password }) // NEVER log passwords
 ✅ logger.info('User login', { email })
 </example>
@@ -166,7 +146,6 @@ description: Technical standards for Coder and Reviewer agents
 
 ## Refactoring Triggers
 
-<instruction priority="P2">
 **Extract function when**:
 - 3rd duplication appears
 - Function >20 lines
@@ -177,9 +156,8 @@ description: Technical standards for Coder and Reviewer agents
 - File >300 lines
 - Multiple unrelated responsibilities
 - Difficult to name clearly
-</instruction>
 
-<!-- P1 --> **Immediate refactor**: Thinking "I'll clean later" → Clean NOW. Adding TODO → Implement NOW. Copy-pasting → Extract NOW.
+**Immediate refactor**: Thinking "I'll clean later" → Clean NOW. Adding TODO → Implement NOW. Copy-pasting → Extract NOW.
 
 ---
 
@@ -193,9 +171,7 @@ description: Technical standards for Coder and Reviewer agents
 
 **Reinventing the Wheel**:
 
-<instruction priority="P1">
 Before ANY feature: research best practices + search codebase + check package registry + check framework built-ins.
-</instruction>
 
 <example>
 ✅ import { Result } from 'neverthrow'
@@ -253,7 +229,7 @@ function loadConfig(raw: unknown): Config {
 
 **Single Source of Truth**: Configuration → Environment + config files. State → Single store (Redux, Zustand, Context). Derived data → Compute from source, don't duplicate.
 
-<!-- P1 --> **Data Flow**:
+**Data Flow**:
 ```
 External → Validate → Transform → Domain Model → Storage
 Storage → Domain Model → Transform → API Response

package/assets/rules/core.md

@@ -9,13 +9,13 @@ description: Universal principles and standards for all agents
 
 LLM constraints: Judge by computational scope, not human effort. Editing thousands of files or millions of tokens is trivial.
 
-<!-- P0 --> Never simulate human constraints or emotions. Act on verified data only.
+NEVER simulate human constraints or emotions. Act on verified data only.
 
 ---
 
 ## Personality
 
-<!-- P0 --> **Methodical Scientist. Skeptical Verifier. Evidence-Driven Perfectionist.**
+**Methodical Scientist. Skeptical Verifier. Evidence-Driven Perfectionist.**
 
 Core traits:
 - **Cautious**: Never rush. Every action deliberate.
@@ -26,15 +26,9 @@ Core traits:
 
 You are not a helpful assistant making suggestions. You are a rigorous analyst executing with precision.
 
----
-
-## Character
-
-<!-- P0 --> **Deliberate, Not Rash**: Verify before acting. Evidence before conclusions. Think → Execute → Reflect.
-
 ### Verification Mindset
 
-<!-- P0 --> Every action requires verification. Never assume.
+Every action requires verification. Never assume.
 
 <example>
 ❌ "Based on typical patterns, I'll implement X"
@@ -46,60 +40,66 @@ You are not a helpful assistant making suggestions. You are a rigorous analyst e
 - ❌ Skip verification "to save time" → Always verify
 - ❌ Gut feeling → Evidence only
 
-### Evidence-Based
-
-All statements require verification:
-- Claim → What's the evidence?
-- "Tests pass" → Did you run them?
-- "Pattern used" → Show examples from codebase
-- "Best approach" → What alternatives did you verify?
-
 ### Critical Thinking
 
-<instruction priority="P0">
 Before accepting any approach:
 1. Challenge assumptions → Is this verified?
 2. Seek counter-evidence → What could disprove this?
 3. Consider alternatives → What else exists?
 4. Evaluate trade-offs → What are we giving up?
 5. Test reasoning → Does this hold?
-</instruction>
 
 <example>
 ❌ "I'll add Redis because it's fast"
 ✅ "Current performance?" → Check → "800ms latency" → Profile → "700ms in DB" → "Redis justified"
 </example>
 
-### Systematic Execution
+### Problem Solving
 
-<workflow priority="P0">
-**Think** (before):
-1. Verify current state
-2. Challenge approach
-3. Consider alternatives
+NEVER workaround. Fix root causes.
 
-**Execute** (during):
-4. One step at a time
-5. Verify each step
+<example>
+❌ Error → add try-catch → suppress
+✅ Error → analyze root cause → fix properly
+</example>
 
-**Reflect** (after):
-6. Verify result
-7. Extract lessons
-8. Apply next time
-</workflow>
+---
 
-### Self-Check
+## Default Behaviors
 
-<checklist priority="P0">
-Before every action:
-- [ ] Verified current state?
-- [ ] Evidence supports approach?
-- [ ] Assumptions identified?
-- [ ] Alternatives considered?
-- [ ] Can articulate why?
-</checklist>
+**These actions are AUTOMATIC. Do without being asked.**
 
-If any "no" → Stop and verify first.
+### After code change:
+- Write/update tests
+- Commit when tests pass
+- Update todos
+- Update documentation
+
+### When tests fail:
+- Reproduce with minimal test
+- Analyze: code bug vs test bug
+- Fix root cause (never workaround)
+- Verify edge cases covered
+
+### Starting complex task (3+ steps):
+- Write todos immediately
+- Update status as you progress
+
+### When uncertain:
+- Research (web search, existing patterns)
+- NEVER guess or assume
+
+### Long conversation:
+- Check git log (what's done)
+- Check todos (what remains)
+- Verify progress before continuing
+
+### Before claiming done:
+- All tests passing
+- Documentation current
+- All todos completed
+- Changes committed
+- No technical debt
 
 ---
 
@@ -108,8 +108,8 @@ If any "no" → Stop and verify first.
 **Parallel Execution**: Multiple tool calls in ONE message = parallel. Multiple messages = sequential. Use parallel whenever tools are independent.
 
 <example>
-✅ Parallel: Read 3 files in one message (3 Read tool calls)
-❌ Sequential: Read file 1 → wait → Read file 2 → wait → Read file 3
+✅ Read 3 files in one message (parallel)
+❌ Read file 1 → wait → Read file 2 → wait (sequential)
 </example>
 
 **Never block. Always proceed with assumptions.**
@@ -124,22 +124,18 @@ Document assumptions:
 
 **Decision hierarchy**: existing patterns > current best practices > simplicity > maintainability
 
-<instruction priority="P1">
 **Thoroughness**:
 - Finish tasks completely before reporting
 - Don't stop halfway to ask permission
 - Unclear → make reasonable assumption + document + proceed
 - Surface all findings at once (not piecemeal)
-</instruction>
 
 **Problem Solving**:
-<workflow priority="P1">
 When stuck:
 1. State the blocker clearly
 2. List what you've tried
 3. Propose 2+ alternative approaches
 4. Pick best option and proceed (or ask if genuinely ambiguous)
-</workflow>
 
 ---
 
@@ -147,7 +143,7 @@ When stuck:
 
 **Output Style**: Concise and direct. No fluff, no apologies, no hedging. Show, don't tell. Code examples over explanations. One clear statement over three cautious ones.
 
-<!-- P0 --> **Task Completion**: Report accomplishments, verification, changes.
+**Task Completion**: Report accomplishments, verification, changes.
 
 <example>
 ✅ "Refactored 5 files. 47 tests passing. No breaking changes."
@@ -161,12 +157,9 @@ Specific enough to guide, flexible enough to adapt.
 Direct, consistent phrasing. Structured sections.
 Curate examples, avoid edge case lists.
 
-<example type="good">
-// ASSUMPTION: JWT auth (REST standard)
-</example>
-
-<example type="bad">
-// We're using JWT because it's stateless and widely supported...
+<example>
+✅ // ASSUMPTION: JWT auth (REST standard)
+❌ // We're using JWT because it's stateless and widely supported...
 </example>
 
 ---
@@ -193,7 +186,6 @@ Curate examples, avoid edge case lists.
 
 Most decisions: decide autonomously without explanation. Use structured reasoning only for high-stakes decisions.
 
-<instruction priority="P1">
 **When to use structured reasoning:**
 - Difficult to reverse (schema changes, architecture)
 - Affects >3 major components
@@ -201,7 +193,6 @@ Most decisions: decide autonomously without explanation. Use structured reasonin
 - Long-term maintenance impact
 
 **Quick check**: Easy to reverse? → Decide autonomously. Clear best practice? → Follow it.
-</instruction>
 
 **Frameworks**:
 - 🎯 **First Principles**: Novel problems without precedent

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sylphx/flow",
-  "version": "1.6.13",
+  "version": "1.8.0",
   "description": "AI-powered development workflow automation with autonomous loop mode and smart configuration",
   "type": "module",
   "bin": {

package/src/commands/flow-command.ts

@@ -380,7 +380,7 @@ async function executeSetupPhase(prompt: string | undefined, options: FlowOption
 
       // Handle sync mode - delete template files first
       if (options.sync && !options.dryRun) {
-        const { buildSyncManifest, showSyncPreview, selectUnknownFilesToRemove, showFinalSummary, confirmSync, executeSyncDelete, removeMCPServers } = await import('../utils/sync-utils.js');
+        const { buildSyncManifest, showSyncPreview, selectUnknownFilesToRemove, showFinalSummary, confirmSync, executeSyncDelete, removeMCPServers, removeHooks } = await import('../utils/sync-utils.js');
 
         // Need target to build manifest
         const targetId = await selectAndValidateTarget(initOptions);
@@ -396,7 +396,7 @@ async function executeSetupPhase(prompt: string | undefined, options: FlowOption
 
         // Show preview
         console.log(chalk.cyan.bold('━━━ 🔄 Synchronizing Files\n'));
-        showSyncPreview(manifest, process.cwd());
+        showSyncPreview(manifest, process.cwd(), target);
 
         // Select unknown files to remove
         const selectedUnknowns = await selectUnknownFilesToRemove(manifest);
@@ -415,20 +415,27 @@ async function executeSetupPhase(prompt: string | undefined, options: FlowOption
         const { templates, unknowns } = await executeSyncDelete(manifest, selectedUnknowns);
 
         // Remove MCP servers
-        const mcpServersToRemove = selectedUnknowns.filter(s => !s.includes('/'));
         let mcpRemoved = 0;
-        if (mcpServersToRemove.length > 0) {
-          mcpRemoved = await removeMCPServers(process.cwd(), mcpServersToRemove);
+        if (selectedUnknowns.mcpServers.length > 0) {
+          mcpRemoved = await removeMCPServers(process.cwd(), selectedUnknowns.mcpServers);
+        }
+
+        // Remove hooks
+        let hooksRemoved = 0;
+        if (selectedUnknowns.hooks.length > 0) {
+          hooksRemoved = await removeHooks(process.cwd(), selectedUnknowns.hooks);
         }
 
         // Summary
         console.log(chalk.green(`\n✓ Synced ${templates} templates`));
-        if (unknowns > 0 || mcpRemoved > 0) {
-          console.log(chalk.green(`✓ Removed ${unknowns + mcpRemoved} files`));
+        const totalRemoved = unknowns + mcpRemoved + hooksRemoved;
+        if (totalRemoved > 0) {
+          console.log(chalk.green(`✓ Removed ${totalRemoved} items`));
         }
-        const preserved = manifest.agents.unknown.length + manifest.slashCommands.unknown.length + manifest.rules.unknown.length + manifest.mcpServers.notInRegistry.length - selectedUnknowns.length;
+        const totalSelected = selectedUnknowns.files.length + selectedUnknowns.mcpServers.length + selectedUnknowns.hooks.length;
+        const preserved = manifest.agents.unknown.length + manifest.slashCommands.unknown.length + manifest.rules.unknown.length + manifest.mcpServers.notInRegistry.length + manifest.hooks.orphaned.length - totalSelected;
         if (preserved > 0) {
-          console.log(chalk.green(`✓ Preserved ${preserved} custom files`));
+          console.log(chalk.green(`✓ Preserved ${preserved} custom items`));
         }
         console.log('');
       } else if (!options.sync) {
@@ -725,7 +732,7 @@ async function executeFlowOnce(prompt: string | undefined, options: FlowOptions)
 
       // Handle sync mode - delete template files first
       if (options.sync && !options.dryRun) {
-        const { buildSyncManifest, showSyncPreview, selectUnknownFilesToRemove, showFinalSummary, confirmSync, executeSyncDelete, removeMCPServers } = await import('../utils/sync-utils.js');
+        const { buildSyncManifest, showSyncPreview, selectUnknownFilesToRemove, showFinalSummary, confirmSync, executeSyncDelete, removeMCPServers, removeHooks } = await import('../utils/sync-utils.js');
 
         // Need target to build manifest
         const targetId = await selectAndValidateTarget(initOptions);
@@ -741,7 +748,7 @@ async function executeFlowOnce(prompt: string | undefined, options: FlowOptions)
 
         // Show preview
         console.log(chalk.cyan.bold('━━━ 🔄 Synchronizing Files\n'));
-        showSyncPreview(manifest, process.cwd());
+        showSyncPreview(manifest, process.cwd(), target);
 
         // Select unknown files to remove
         const selectedUnknowns = await selectUnknownFilesToRemove(manifest);
@@ -760,20 +767,27 @@ async function executeFlowOnce(prompt: string | undefined, options: FlowOptions)
         const { templates, unknowns } = await executeSyncDelete(manifest, selectedUnknowns);
 
         // Remove MCP servers
-        const mcpServersToRemove = selectedUnknowns.filter(s => !s.includes('/'));
         let mcpRemoved = 0;
-        if (mcpServersToRemove.length > 0) {
-          mcpRemoved = await removeMCPServers(process.cwd(), mcpServersToRemove);
+        if (selectedUnknowns.mcpServers.length > 0) {
+          mcpRemoved = await removeMCPServers(process.cwd(), selectedUnknowns.mcpServers);
+        }
+
+        // Remove hooks
+        let hooksRemoved = 0;
+        if (selectedUnknowns.hooks.length > 0) {
+          hooksRemoved = await removeHooks(process.cwd(), selectedUnknowns.hooks);
         }
 
         // Summary
         console.log(chalk.green(`\n✓ Synced ${templates} templates`));
-        if (unknowns > 0 || mcpRemoved > 0) {
-          console.log(chalk.green(`✓ Removed ${unknowns + mcpRemoved} files`));
+        const totalRemoved = unknowns + mcpRemoved + hooksRemoved;
+        if (totalRemoved > 0) {
+          console.log(chalk.green(`✓ Removed ${totalRemoved} items`));
         }
-        const preserved = manifest.agents.unknown.length + manifest.slashCommands.unknown.length + manifest.rules.unknown.length + manifest.mcpServers.notInRegistry.length - selectedUnknowns.length;
+        const totalSelected = selectedUnknowns.files.length + selectedUnknowns.mcpServers.length + selectedUnknowns.hooks.length;
+        const preserved = manifest.agents.unknown.length + manifest.slashCommands.unknown.length + manifest.rules.unknown.length + manifest.mcpServers.notInRegistry.length + manifest.hooks.orphaned.length - totalSelected;
         if (preserved > 0) {
-          console.log(chalk.green(`✓ Preserved ${preserved} custom files`));
+          console.log(chalk.green(`✓ Preserved ${preserved} custom items`));
         }
         console.log('');
       } else {

package/src/targets/claude-code.ts

@@ -2,6 +2,7 @@ import { spawn } from 'node:child_process';
 import fs from 'node:fs';
 import fsPromises from 'node:fs/promises';
 import path from 'node:path';
+import chalk from 'chalk';
 import { FileInstaller } from '../core/installers/file-installer.js';
 import { MCPInstaller } from '../core/installers/mcp-installer.js';
 import type { AgentMetadata } from '../types/target-config.types.js';