@catchdrift/cli 0.2.2 → 0.2.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@catchdrift/cli",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "CLI for Drift — install, check, and manage design system coverage for any React app.",
   "keywords": [
     "design-system",

package/src/commands/init.mjs

@@ -176,7 +176,7 @@ export async function init(argv) {
       }
     } else {
       // shadcn is interactive — user must run it themselves
-      p.log.info(`shadcn/ui requires its own interactive setup:\n  ${pc.bold(chosenFoundation.install)}\n  Run this after catchdrift finishes, then run ${pc.bold('npx catchdrift sync')}`)
+      p.log.info(`shadcn/ui requires its own interactive setup:\n  ${pc.bold(chosenFoundation.install)}\n  Run this after catchdrift finishes, then run ${pc.bold('npx @catchdrift/cli sync')}`)
     }
 
     // ── Figma for fresh users ────────────────────────────────────────────────────
@@ -197,7 +197,7 @@ export async function init(argv) {
     if (wantFigmaFresh) {
       sources.push('figma')
     } else {
-      console.log(pc.dim('  Skipping Figma. Re-run npx catchdrift init later to add it.'))
+      console.log(pc.dim('  Skipping Figma. Re-run npx @catchdrift/cli init later to add it.'))
     }
   }
 
@@ -223,7 +223,7 @@ export async function init(argv) {
           'npm cache is owned by root — Storybook install will fail.\n' +
           pc.bold('  Fix it first by running:\n') +
           `    sudo chown -R $(id -u):$(id -g) ~/.npm\n` +
-          `  Then re-run: ${pc.bold('npx catchdrift init')}`
+          `  Then re-run: ${pc.bold('npx @catchdrift/cli init')}`
         )
       } else {
         console.log(pc.dim('\n  Running npx storybook@latest init — follow the prompts:\n'))
@@ -238,7 +238,7 @@ export async function init(argv) {
             p.log.warn(
               'npm cache permission error.\n' +
               `  Fix: sudo chown -R $(id -u):$(id -g) ~/.npm\n` +
-              `  Then re-run: npx catchdrift init`
+              `  Then re-run: npx @catchdrift/cli init`
             )
           } else {
             p.log.warn('Storybook install failed or was cancelled. Run `npx storybook@latest init` manually when ready.')
@@ -246,7 +246,7 @@ export async function init(argv) {
         }
       }
     } else {
-      p.log.info('Skipping Storybook. Run `npx storybook@latest init` when ready, then re-run `npx catchdrift init`.')
+      p.log.info('Skipping Storybook. Run `npx storybook@latest init` when ready, then re-run `npx @catchdrift/cli init`.')
     }
   }
 
@@ -265,7 +265,7 @@ export async function init(argv) {
           'npm cache is owned by root — Storybook install will fail.\n' +
           pc.bold('  Fix it first:\n') +
           `    sudo chown -R $(id -u):$(id -g) ~/.npm\n` +
-          `  Then re-run: ${pc.bold('npx catchdrift init')}`
+          `  Then re-run: ${pc.bold('npx @catchdrift/cli init')}`
         )
         sources.splice(sources.indexOf('storybook'), 1)
       } else {
@@ -279,7 +279,7 @@ export async function init(argv) {
             p.log.warn(
               'npm cache permission error.\n' +
               `  Fix: sudo chown -R $(id -u):$(id -g) ~/.npm\n` +
-              `  Then re-run: npx catchdrift init`
+              `  Then re-run: npx @catchdrift/cli init`
             )
           } else {
             p.log.warn('Storybook install failed or was cancelled. Run `npx storybook@latest init` manually when ready.')
@@ -290,7 +290,7 @@ export async function init(argv) {
     } else {
       // User declined — remove from sources so the URL step is skipped
       sources.splice(sources.indexOf('storybook'), 1)
-      p.log.info('Skipping Storybook setup. Re-run `npx catchdrift init` after installing it.')
+      p.log.info('Skipping Storybook setup. Re-run `npx @catchdrift/cli init` after installing it.')
     }
   }
 
@@ -590,7 +590,7 @@ ${pc.bold('What was set up:')}
 ${alreadyInstalled ? '' : `
   ${pc.cyan('1.')} Install it:
        ${pc.bold(chosenFoundation.install)}`}
-  ${alreadyInstalled ? pc.cyan('1.') : pc.cyan('2.')} Run: ${pc.bold('npx catchdrift sync')}
+  ${alreadyInstalled ? pc.cyan('1.') : pc.cyan('2.')} Run: ${pc.bold('npx @catchdrift/cli sync')}
        Scans your codebase for imports from ${pc.bold(chosenFoundation.pkg)} and registers them.
   ${alreadyInstalled ? pc.cyan('2.') : pc.cyan('3.')} Run: ${pc.bold('npm run dev')}  →  press ${pc.bold('D')}  →  see live coverage
 
@@ -615,7 +615,7 @@ ${alreadyInstalled ? '' : `
 `)
   } else if (mergedDsPackages?.length) {
     console.log(`
-  ${pc.cyan('1.')} Run: ${pc.bold('npx catchdrift sync')}
+  ${pc.cyan('1.')} Run: ${pc.bold('npx @catchdrift/cli sync')}
        Scans your codebase for imports from ${mergedDsPackages.join(', ')} and registers them.
   ${pc.cyan('2.')} Run: ${pc.bold('npm run dev')}  →  press ${pc.bold('D')}  →  see live coverage
 `)
@@ -624,8 +624,8 @@ ${alreadyInstalled ? '' : `
   ${pc.cyan('1.')} Run: ${pc.bold('npm run dev')}  →  press ${pc.bold('D')}  →  the overlay opens
        Coverage will show 0% until you register your DS components.
   ${pc.cyan('2.')} Add your components to ${pc.bold('drift.config.ts')} or connect a source:
-       • Figma:  re-run ${pc.bold('npx catchdrift init')} and select Figma
-       • npm:    add ${pc.bold('dsPackages')} to drift.config.ts, then run ${pc.bold('npx catchdrift sync')}
+       • Figma:  re-run ${pc.bold('npx @catchdrift/cli init')} and select Figma
+       • npm:    add ${pc.bold('dsPackages')} to drift.config.ts, then run ${pc.bold('npx @catchdrift/cli sync')}
 `)
   }
 
@@ -639,12 +639,12 @@ ${alreadyInstalled ? '' : `
   ${pc.blue('/drift-context')}     Check DS health — run this before starting work
   ${pc.blue('/drift-scaffold')}    Build a new screen using only DS components
   ${pc.blue('/drift-sync')}        Update registry after Figma or Storybook changes
-  ${pc.blue('npx catchdrift check')}   Check coverage before submitting a PR
+  ${pc.blue('npx @catchdrift/cli check')}   Check coverage before submitting a PR
 `)
 
   if (!sources.includes('storybook') && !storybook.found) {
     console.log(`${pc.yellow('Note:')} Storybook isn't set up yet. Run ${pc.bold('npx storybook@latest init')} when ready,`)
-    console.log(`  then re-run ${pc.bold('npx catchdrift init')} to complete the coverage loop.\n`)
+    console.log(`  then re-run ${pc.bold('npx @catchdrift/cli init')} to complete the coverage loop.\n`)
   }
 
   if (!patchedShort) {

package/src/index.mjs

@@ -5,30 +5,30 @@
 
 import pc from 'picocolors'
 
-const VERSION = '0.2.2'
+const VERSION = '0.2.3'
 
 const HELP = `
 ${pc.bold(pc.blue('catchdrift'))} — Design system compliance for teams shipping with AI
 
 ${pc.bold('Usage:')}
-  npx catchdrift init              Install Drift into your React project
-  npx catchdrift sync              Auto-discover DS components from dsPackages
-  npx catchdrift check             Run headless drift scan (requires running app)
-  npx catchdrift status            Show DS coverage snapshot from config
-  npx catchdrift spec              List all .drift-spec.md files
-  npx catchdrift spec validate     Validate specs against implementation
-  npx catchdrift spec show <file>  Show parsed spec details
+  npx @catchdrift/cli init              Install Drift into your React project
+  npx @catchdrift/cli sync              Auto-discover DS components from dsPackages
+  npx @catchdrift/cli check             Run headless drift scan (requires running app)
+  npx @catchdrift/cli status            Show DS coverage snapshot from config
+  npx @catchdrift/cli spec              List all .drift-spec.md files
+  npx @catchdrift/cli spec validate     Validate specs against implementation
+  npx @catchdrift/cli spec show <file>  Show parsed spec details
 
 ${pc.bold('Options:')}
   --help, -h      Show this help
   --version, -v   Show version
 
 ${pc.bold('Examples:')}
-  npx catchdrift init
-  npx catchdrift sync
-  npx catchdrift check --url http://localhost:5173 --threshold 80
-  npx catchdrift status
-  npx catchdrift spec validate
+  npx @catchdrift/cli init
+  npx @catchdrift/cli sync
+  npx @catchdrift/cli check --url http://localhost:5173 --threshold 80
+  npx @catchdrift/cli status
+  npx @catchdrift/cli spec validate
 
 ${pc.dim('Docs: https://catchdrift.ai  ·  GitHub: https://github.com/dyoon92/design-drift')}
 `

package/src/lib/writers.mjs

@@ -62,7 +62,7 @@ export function writeDriftConfig(cwd, { storybookUrl, chromaticUrl, figmaFiles,
     `  threshold: ${threshold},`,
     dsPackagesLine,
     `  components: {`,
-    registry || `    // Auto-populated by \`npx catchdrift sync\` — or add manually:`,
+    registry || `    // Auto-populated by \`npx @catchdrift/cli sync\` — or add manually:`,
     `    // Button: { storyPath: 'primitives-button--primary' },`,
     `  },`,
     `  // approvedGaps: {},`,
@@ -85,7 +85,7 @@ export function writeEnvLocal(cwd, { figmaToken }) {
     if (existing.includes('FIGMA_TOKEN=')) return
     writeFileSync(envPath, existing.trimEnd() + '\n' + line, 'utf8')
   } else {
-    writeFileSync(envPath, `# Drift — Figma token (auto-generated by npx catchdrift init)\n${line}`, 'utf8')
+    writeFileSync(envPath, `# Drift — Figma token (auto-generated by npx @catchdrift/cli init)\n${line}`, 'utf8')
   }
 }