@nolrm/contextkit 0.13.4 → 0.13.7

package/lib/integrations/claude-integration.js

@@ -164,155 +164,215 @@ Follow the code style standards auto-loaded via CLAUDE.md (from code-style.md).
     await this.writeGeneratedFile('.claude/rules/contextkit-code-style.md', codeStyleRule);
 
     // Slash commands — thin wrappers that delegate to .contextkit/commands/
-    await this.writeGeneratedFile('.claude/commands/analyze.md', `# Analyze Project
+    await this.writeGeneratedFile(
+      '.claude/commands/analyze.md',
+      `# Analyze Project
 
 Read \`.contextkit/commands/analyze.md\` and execute the analysis workflow for this project.
 
 Scan the codebase structure, detect frameworks and patterns, then generate customized standards files in \`.contextkit/standards/\`.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.claude/commands/review.md', `# Code Review
+    await this.writeGeneratedFile(
+      '.claude/commands/review.md',
+      `# Code Review
 
 Read \`.contextkit/commands/review.md\` and execute the review workflow.
 
 Review current changes for correctness, standards compliance, and potential issues.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.claude/commands/fix.md', `# Fix Bug
+    await this.writeGeneratedFile(
+      '.claude/commands/fix.md',
+      `# Fix Bug
 
 Read \`.contextkit/commands/fix.md\` and execute the bug fix workflow.
 
 Diagnose the root cause, implement the minimal fix, and add a regression test.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.claude/commands/refactor.md', `# Refactor
+    await this.writeGeneratedFile(
+      '.claude/commands/refactor.md',
+      `# Refactor
 
 Read \`.contextkit/commands/refactor.md\` and execute the refactoring workflow.
 
 Improve code structure without changing behavior, keeping tests green at every step.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.claude/commands/test.md', `# Run Tests
+    await this.writeGeneratedFile(
+      '.claude/commands/test.md',
+      `# Run Tests
 
 Read \`.contextkit/commands/run-tests.md\` and execute the testing workflow.
 
 Generate or run tests for the specified code, covering happy paths, edge cases, and errors.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.claude/commands/doc.md', `# Add Documentation
+    await this.writeGeneratedFile(
+      '.claude/commands/doc.md',
+      `# Add Documentation
 
 Read \`.contextkit/commands/add-documentation.md\` and execute the documentation workflow.
 
 Add inline docs, README sections, and usage examples for the specified code.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.claude/commands/spec.md', `# Spec
+    await this.writeGeneratedFile(
+      '.claude/commands/spec.md',
+      `# Spec
 
 Read \`.contextkit/commands/spec.md\` and execute the spec workflow.
 
 Write a component spec (MD-first) before any code is created. Scaffold the spec file colocated with the component and wait for review before coding begins.
-`);
+`
+    );
 
     // Squad slash commands
-    await this.writeGeneratedFile('.claude/commands/squad.md', `# Squad — Kickoff (start here)
+    await this.writeGeneratedFile(
+      '.claude/commands/squad.md',
+      `# Squad — Kickoff (start here)
 
 Read \`.contextkit/commands/squad.md\` and execute the squad kickoff workflow.
 
 Create the handoff file and write the PO spec for the given task. Pass the user's task description as the input.
 
 After kickoff, run \`/squad-auto\` to auto-run the full pipeline hands-free, or step through manually with \`/squad-architect\` → \`/squad-dev\` → \`/squad-test\` → \`/squad-review\` → \`/squad-doc\`.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.claude/commands/squad-architect.md', `# Squad — Architect (manual step 1/4)
+    await this.writeGeneratedFile(
+      '.claude/commands/squad-architect.md',
+      `# Squad — Architect (manual step 1/4)
 
 Read \`.contextkit/commands/squad-architect.md\` and execute the architect workflow.
 
 Read the PO spec from the handoff file, design the technical approach, and write the implementation plan. Use \`/squad-auto\` instead to run all steps automatically.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.claude/commands/squad-dev.md', `# Squad — Dev (manual step 2/4)
+    await this.writeGeneratedFile(
+      '.claude/commands/squad-dev.md',
+      `# Squad — Dev (manual step 2/4)
 
 Read \`.contextkit/commands/squad-dev.md\` and execute the dev workflow.
 
 Follow the architect's plan to implement the code changes. Use \`/squad-auto\` instead to run all steps automatically.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.claude/commands/squad-test.md', `# Squad — Test (manual step 3/4)
+    await this.writeGeneratedFile(
+      '.claude/commands/squad-test.md',
+      `# Squad — Test (manual step 3/4)
 
 Read \`.contextkit/commands/squad-test.md\` and execute the test workflow.
 
 Write and run tests against the PO's acceptance criteria. Use \`/squad-auto\` instead to run all steps automatically.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.claude/commands/squad-review.md', `# Squad — Review (manual step 4/4)
+    await this.writeGeneratedFile(
+      '.claude/commands/squad-review.md',
+      `# Squad — Review (manual step 4/4)
 
 Read \`.contextkit/commands/squad-review.md\` and execute the review workflow.
 
 Review the full handoff (spec, plan, implementation, tests) and write the final verdict. Use \`/squad-auto\` instead to run all steps automatically.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.claude/commands/squad-auto.md', `# Squad Auto — Full Pipeline (recommended)
+    await this.writeGeneratedFile(
+      '.claude/commands/squad-auto.md',
+      `# Squad Auto — Full Pipeline (recommended)
 
 Read \`.contextkit/commands/squad-auto.md\` and execute the pipeline runner workflow.
 
 Run after \`/squad\` kickoff. Automatically runs architect → dev → test → review for all tasks sequentially, hands-free.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.claude/commands/squad-auto-parallel.md', `# Squad Auto — Parallel Agents (batch, fastest)
+    await this.writeGeneratedFile(
+      '.claude/commands/squad-auto-parallel.md',
+      `# Squad Auto — Parallel Agents (batch, fastest)
 
 Read \`.contextkit/commands/squad-auto-parallel.md\` and execute the parallel pipeline workflow.
 
 Spawn one subagent per task per phase using the Task tool, so all tasks progress simultaneously instead of sequentially. Use this after \`/squad\` batch kickoff for faster execution on multi-task batches.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.claude/commands/squad-reset.md', `# Squad — Reset
+    await this.writeGeneratedFile(
+      '.claude/commands/squad-reset.md',
+      `# Squad — Reset
 
 Read \`.contextkit/commands/squad-reset.md\` and execute the reset workflow.
 
 Delete the current squad state (.contextkit/squad/) so you can start fresh. Use when the squad folder is in a mixed or stuck state.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.claude/commands/squad-doc.md', `# Squad — Doc (manual step 5/5)
+    await this.writeGeneratedFile(
+      '.claude/commands/squad-doc.md',
+      `# Squad — Doc (manual step 5/5)
 
 Read \`.contextkit/commands/squad-doc.md\` and execute the doc workflow.
 
 After review passes, create or update companion .md files for every new/modified code file in this task. Use \`/squad-auto\` instead to run all steps automatically.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.claude/commands/ck.md', `# ContextKit Health Check
+    await this.writeGeneratedFile(
+      '.claude/commands/ck.md',
+      `# ContextKit Health Check
 
 Read \`.contextkit/commands/health-check.md\` and execute the health check workflow.
 
 Check project setup, standards status, and integrations. Report what needs attention.
-`);
+`
+    );
 
     // Doc family slash commands
-    await this.writeGeneratedFile('.claude/commands/doc-arch.md', `# Doc — Architecture (Level 1)
+    await this.writeGeneratedFile(
+      '.claude/commands/doc-arch.md',
+      `# Doc — Architecture (Level 1)
 
 Read \`.contextkit/commands/doc-arch.md\` and execute the architecture documentation workflow.
 
 Detect the project stack, then generate or update \`docs/architecture.md\` with system boundaries, key flows, and stack-appropriate artifacts (Mermaid diagrams, component trees, service maps).
 
 Pass an optional PR number to scope to that PR's changes.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.claude/commands/doc-feature.md', `# Doc — Feature (Level 2)
+    await this.writeGeneratedFile(
+      '.claude/commands/doc-feature.md',
+      `# Doc — Feature (Level 2)
 
 Read \`.contextkit/commands/doc-feature.md\` and execute the feature documentation workflow.
 
 Detect the project stack, identify the target feature from the argument or current branch, then generate or update \`docs/features/<name>.md\` with purpose, components/modules, data flow, and user flows.
 
 Pass a feature name, directory path, or PR number to scope the documentation.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.claude/commands/doc-component.md', `# Doc — Component (Level 3)
+    await this.writeGeneratedFile(
+      '.claude/commands/doc-component.md',
+      `# Doc — Component (Level 3)
 
 Read \`.contextkit/commands/doc-component.md\` and execute the component documentation workflow.
 
 Detect the project stack, read the target file or directory, then create or update a colocated \`<name>.md\` with API/props, usage examples, behavior, and edge cases.
 
 Pass a file path or directory to target. Omit to infer from current context.
-`);
+`
+    );
   }
 
   showUsage() {
@@ -339,7 +399,9 @@ Pass a file path or directory to target. Omit to infer from current context.
     console.log(chalk.dim('    /squad-test        — Write and run tests'));
     console.log(chalk.dim('    /squad-review      — Review and write verdict'));
     console.log(chalk.dim('    /squad-auto             — Auto-run full pipeline (recommended)'));
-    console.log(chalk.dim('    /squad-auto-parallel    — Auto-run pipeline in parallel (batch, fastest)'));
+    console.log(
+      chalk.dim('    /squad-auto-parallel    — Auto-run pipeline in parallel (batch, fastest)')
+    );
     console.log(chalk.dim('    /squad-doc              — Document changes after review passes'));
     console.log(chalk.dim(''));
     console.log(chalk.dim('  Health check:'));

package/lib/integrations/continue-integration.js

@@ -7,10 +7,7 @@ class ContinueIntegration extends BaseIntegration {
     super();
     this.name = 'continue';
     this.displayName = 'Continue';
-    this.generatedFiles = [
-      '.continue/rules/contextkit-standards.md',
-      '.continue/config.yaml',
-    ];
+    this.generatedFiles = ['.continue/rules/contextkit-standards.md', '.continue/config.yaml'];
     this.bridgeFiles = [];
     this.platformDir = '.continue/rules';
   }
@@ -75,7 +72,10 @@ context:
 `;
 
     // Only write config.yaml if neither config.yaml nor config.json exists
-    if (!await fs.pathExists('.continue/config.yaml') && !await fs.pathExists('.continue/config.json')) {
+    if (
+      !(await fs.pathExists('.continue/config.yaml')) &&
+      !(await fs.pathExists('.continue/config.json'))
+    ) {
       await this.writeGeneratedFile('.continue/config.yaml', configYaml);
     } else if (await fs.pathExists('.continue/config.yaml')) {
       // Update existing yaml

package/lib/integrations/copilot-integration.js

@@ -49,7 +49,7 @@ ${this.getStandardsBlock()}
 
     // Add copilot instruction reference
     settings['github.copilot.chat.codeGeneration.instructions'] = [
-      { file: '.github/copilot-instructions.md' }
+      { file: '.github/copilot-instructions.md' },
     ];
     settings['contextKit.standardsPath'] = '.contextkit/standards';
     settings['contextKit.templatesPath'] = '.contextkit/templates';

package/lib/integrations/cursor-integration.js

@@ -159,104 +159,146 @@ Reference: @.contextkit/standards/architecture.md
     await this.writeGeneratedFile('.cursor/rules/contextkit-api.mdc', apiRule);
 
     // Cursor prompts — reusable slash commands in Cursor Chat
-    await this.writeGeneratedFile('.cursor/prompts/analyze.md', `# Analyze Project
+    await this.writeGeneratedFile(
+      '.cursor/prompts/analyze.md',
+      `# Analyze Project
 
 Read \`.contextkit/commands/analyze.md\` and execute the analysis workflow for this project.
 
 Scan the codebase structure, detect frameworks and patterns, then generate customized standards files in \`.contextkit/standards/\`.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.cursor/prompts/review.md', `# Code Review
+    await this.writeGeneratedFile(
+      '.cursor/prompts/review.md',
+      `# Code Review
 
 Read \`.contextkit/commands/review.md\` and execute the review workflow.
 
 Review current changes for correctness, standards compliance, and potential issues. Flag bugs, security concerns, and standards violations.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.cursor/prompts/fix.md', `# Fix Bug
+    await this.writeGeneratedFile(
+      '.cursor/prompts/fix.md',
+      `# Fix Bug
 
 Read \`.contextkit/commands/fix.md\` and execute the bug fix workflow.
 
 Diagnose the root cause, implement the minimal fix, and add a regression test.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.cursor/prompts/refactor.md', `# Refactor
+    await this.writeGeneratedFile(
+      '.cursor/prompts/refactor.md',
+      `# Refactor
 
 Read \`.contextkit/commands/refactor.md\` and execute the refactoring workflow.
 
 Improve code structure without changing behavior, keeping tests green at every step.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.cursor/prompts/test.md', `# Run Tests
+    await this.writeGeneratedFile(
+      '.cursor/prompts/test.md',
+      `# Run Tests
 
 Read \`.contextkit/commands/run-tests.md\` and execute the testing workflow.
 
 Generate or run tests for the specified code, covering happy paths, edge cases, and errors.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.cursor/prompts/doc.md', `# Add Documentation
+    await this.writeGeneratedFile(
+      '.cursor/prompts/doc.md',
+      `# Add Documentation
 
 Read \`.contextkit/commands/add-documentation.md\` and execute the documentation workflow.
 
 Add inline docs, README sections, and usage examples for the specified code.
-`);
+`
+    );
 
     // Squad prompts
-    await this.writeGeneratedFile('.cursor/prompts/squad.md', `# Squad — Kickoff
+    await this.writeGeneratedFile(
+      '.cursor/prompts/squad.md',
+      `# Squad — Kickoff
 
 Read \`.contextkit/commands/squad.md\` and execute the squad kickoff workflow.
 
 Create the handoff file and write the PO spec for the given task. Pass the user's task description as the input.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.cursor/prompts/squad-architect.md', `# Squad — Architect
+    await this.writeGeneratedFile(
+      '.cursor/prompts/squad-architect.md',
+      `# Squad — Architect
 
 Read \`.contextkit/commands/squad-architect.md\` and execute the architect workflow.
 
 Read the PO spec from the handoff file, design the technical approach, and write the implementation plan.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.cursor/prompts/squad-dev.md', `# Squad — Dev
+    await this.writeGeneratedFile(
+      '.cursor/prompts/squad-dev.md',
+      `# Squad — Dev
 
 Read \`.contextkit/commands/squad-dev.md\` and execute the dev workflow.
 
 Follow the architect's plan to implement the code changes.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.cursor/prompts/squad-test.md', `# Squad — Test
+    await this.writeGeneratedFile(
+      '.cursor/prompts/squad-test.md',
+      `# Squad — Test
 
 Read \`.contextkit/commands/squad-test.md\` and execute the test workflow.
 
 Write and run tests against the PO's acceptance criteria.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.cursor/prompts/squad-review.md', `# Squad — Review
+    await this.writeGeneratedFile(
+      '.cursor/prompts/squad-review.md',
+      `# Squad — Review
 
 Read \`.contextkit/commands/squad-review.md\` and execute the review workflow.
 
 Review the full handoff (spec, plan, implementation, tests) and write the final verdict.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.cursor/prompts/squad-auto.md', `# Squad Auto — Full Pipeline (recommended)
+    await this.writeGeneratedFile(
+      '.cursor/prompts/squad-auto.md',
+      `# Squad Auto — Full Pipeline (recommended)
 
 Read \`.contextkit/commands/squad-auto.md\` and execute the pipeline runner workflow.
 
 Run after kickoff. Automatically runs architect → dev → test → review for all tasks sequentially, hands-free.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.cursor/prompts/spec.md', `# Spec
+    await this.writeGeneratedFile(
+      '.cursor/prompts/spec.md',
+      `# Spec
 
 Read \`.contextkit/commands/spec.md\` and execute the spec workflow.
 
 Write a component spec (MD-first) before any code is created. Scaffold the spec file colocated with the component and wait for review before coding begins.
-`);
+`
+    );
 
-    await this.writeGeneratedFile('.cursor/prompts/ck.md', `# ContextKit Health Check
+    await this.writeGeneratedFile(
+      '.cursor/prompts/ck.md',
+      `# ContextKit Health Check
 
 Read \`.contextkit/commands/health-check.md\` and execute the health check workflow.
 
 Check project setup, standards status, and integrations. Report what needs attention.
-`);
+`
+    );
   }
 
   showUsage() {

package/lib/integrations/gemini-integration.js

@@ -1,5 +1,4 @@
 const chalk = require('chalk');
-const fs = require('fs-extra');
 const BaseIntegration = require('./base-integration');
 
 class GeminiIntegration extends BaseIntegration {
@@ -32,18 +31,21 @@ Before writing code, check the relevant standards files above. Always follow the
 
     // Gemini settings
     const settings = {
-      "description": "ContextKit - Context Engineering",
-      "contextFiles": [
-        ".contextkit/standards/code-style.md",
-        ".contextkit/standards/testing.md",
-        ".contextkit/standards/architecture.md",
-        ".contextkit/standards/ai-guidelines.md",
-        ".contextkit/standards/glossary.md",
-        ".contextkit/product/mission-lite.md"
-      ]
+      description: 'ContextKit - Context Engineering',
+      contextFiles: [
+        '.contextkit/standards/code-style.md',
+        '.contextkit/standards/testing.md',
+        '.contextkit/standards/architecture.md',
+        '.contextkit/standards/ai-guidelines.md',
+        '.contextkit/standards/glossary.md',
+        '.contextkit/product/mission-lite.md',
+      ],
     };
 
-    await this.writeGeneratedFile('.gemini/settings.json', JSON.stringify(settings, null, 2) + '\n');
+    await this.writeGeneratedFile(
+      '.gemini/settings.json',
+      JSON.stringify(settings, null, 2) + '\n'
+    );
   }
 
   showUsage() {

package/lib/integrations/index.js

@@ -29,7 +29,17 @@ function getIntegration(name) {
 
 function getAllIntegrationNames() {
   // Return unique names (exclude aliases like vscode)
-  return ['claude', 'cursor', 'copilot', 'codex', 'opencode', 'gemini', 'aider', 'continue', 'windsurf'];
+  return [
+    'claude',
+    'cursor',
+    'copilot',
+    'codex',
+    'opencode',
+    'gemini',
+    'aider',
+    'continue',
+    'windsurf',
+  ];
 }
 
 module.exports = { getIntegration, getAllIntegrationNames, INTEGRATIONS };

package/lib/utils/banner.js

@@ -19,26 +19,29 @@ const LINES = [
 function hslToRgb(h, s, l) {
   s /= 100;
   l /= 100;
-  const k = n => (n + h / 30) % 12;
+  const k = (n) => (n + h / 30) % 12;
   const a = s * Math.min(l, 1 - l);
-  const f = n => l - a * Math.max(-1, Math.min(k(n) - 3, Math.min(9 - k(n), 1)));
+  const f = (n) => l - a * Math.max(-1, Math.min(k(n) - 3, Math.min(9 - k(n), 1)));
   return [Math.round(f(0) * 255), Math.round(f(8) * 255), Math.round(f(4) * 255)];
 }
 
 // ── Banner ─────────────────────────────────────────────────────────────────
 
 function printBanner() {
-  const maxLen = Math.max(...LINES.map(l => l.length));
+  const maxLen = Math.max(...LINES.map((l) => l.length));
 
   console.log('');
-  LINES.forEach(line => {
-    const colored = line.split('').map((char, i) => {
-      if (char === ' ') return ' ';
-      // Cycle hues 20–290°: warm red → yellow → green → cyan → blue
-      const hue = (i / maxLen) * 270 + 20;
-      const [r, g, b] = hslToRgb(hue, 100, 65);
-      return chalk.rgb(r, g, b)(char);
-    }).join('');
+  LINES.forEach((line) => {
+    const colored = line
+      .split('')
+      .map((char, i) => {
+        if (char === ' ') return ' ';
+        // Cycle hues 20–290°: warm red → yellow → green → cyan → blue
+        const hue = (i / maxLen) * 270 + 20;
+        const [r, g, b] = hslToRgb(hue, 100, 65);
+        return chalk.rgb(r, g, b)(char);
+      })
+      .join('');
     console.log(colored);
   });
   console.log('');

package/lib/utils/download.js

@@ -19,8 +19,8 @@ class DownloadManager {
         responseType: 'stream',
         timeout: this.timeout,
         headers: {
-          'User-Agent': 'contextkit-cli/1.0.0'
-        }
+          'User-Agent': 'contextkit-cli/1.0.0',
+        },
       });
 
       const writer = fs.createWriteStream(outputPath);
@@ -30,11 +30,10 @@ class DownloadManager {
         writer.on('finish', resolve);
         writer.on('error', reject);
       });
-
     } catch (error) {
       if (retryCount < this.retries) {
         console.log(`Retrying download (${retryCount + 1}/${this.retries})...`);
-        await new Promise(resolve => setTimeout(resolve, 1000 * (retryCount + 1)));
+        await new Promise((resolve) => setTimeout(resolve, 1000 * (retryCount + 1)));
         return this.downloadFile(url, outputPath, retryCount + 1);
       }
       throw new Error(`Failed to download ${url}: ${error.message}`);

package/lib/utils/git-hooks.js

@@ -40,7 +40,6 @@ class GitHooksManager {
       }
 
       console.log(chalk.green('✅ Git hooks setup complete'));
-
     } catch (error) {
       console.log(chalk.red('❌ Git hooks setup failed:'), error.message);
       throw error;
@@ -87,7 +86,7 @@ class GitHooksManager {
 
       await fs.writeJson('package.json', pkg, { spaces: 2 });
       console.log(chalk.green('✅ Added prepare script to package.json'));
-    } catch (error) {
+    } catch {
       console.log(chalk.yellow('⚠️  Could not update package.json prepare script'));
     }
   }
@@ -138,7 +137,7 @@ class GitHooksManager {
     try {
       execSync('git config --unset core.hooksPath', { stdio: 'pipe' });
       console.log(chalk.green('✅ Removed core.hooksPath config'));
-    } catch (error) {
+    } catch {
       // Already unset, that's fine
     }
 
@@ -167,7 +166,7 @@ class GitHooksManager {
       }
 
       await fs.writeJson('package.json', pkg, { spaces: 2 });
-    } catch (error) {
+    } catch {
       // Best effort
     }
   }

package/lib/utils/migrations.js

@@ -11,12 +11,14 @@ class MigrationRunner {
    * @param {string} configPath - path to config.yml
    */
   async run(currentVersion, configPath) {
-    const from = (currentVersion === undefined || currentVersion === null) ? 0 : currentVersion;
+    const from = currentVersion === undefined || currentVersion === null ? 0 : currentVersion;
 
     if (from > CURRENT_FORMAT_VERSION) {
-      console.log(chalk.yellow(
-        `⚠️  .contextkit/ format version (${from}) is newer than this version of ContextKit (${CURRENT_FORMAT_VERSION}). Skipping migration.`
-      ));
+      console.log(
+        chalk.yellow(
+          `⚠️  .contextkit/ format version (${from}) is newer than this version of ContextKit (${CURRENT_FORMAT_VERSION}). Skipping migration.`
+        )
+      );
       return;
     }