vibefast-cli 0.1.4 → 0.2.0

package/dist/core/prompt.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Prompt user for input
+ * Returns empty string in non-interactive environments (CI/CD)
+ */
+export declare function promptUser(question: string): string;
+/**
+ * Prompt user for yes/no confirmation
+ * Returns defaultValue in non-interactive environments
+ */
+export declare function promptYesNo(question: string, defaultYes?: boolean): boolean;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/core/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/core/prompt.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiBnD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,UAAQ,GAAG,OAAO,CAUzE"}

package/dist/core/prompt.js

@@ -0,0 +1,34 @@
+import readlineSync from 'readline-sync';
+/**
+ * Prompt user for input
+ * Returns empty string in non-interactive environments (CI/CD)
+ */
+export function promptUser(question) {
+    // Check if we're in a non-interactive environment
+    if (!process.stdin.isTTY) {
+        return '';
+    }
+    // Check for CI environment variables
+    const isCI = process.env.CI === 'true' ||
+        process.env.GITHUB_ACTIONS === 'true' ||
+        process.env.GITLAB_CI === 'true' ||
+        process.env.CIRCLECI === 'true';
+    if (isCI) {
+        return '';
+    }
+    return readlineSync.question(question);
+}
+/**
+ * Prompt user for yes/no confirmation
+ * Returns defaultValue in non-interactive environments
+ */
+export function promptYesNo(question, defaultYes = false) {
+    const answer = promptUser(question);
+    // Empty answer (non-interactive or just pressed enter)
+    if (answer === '') {
+        return defaultYes;
+    }
+    const normalized = answer.toLowerCase().trim();
+    return normalized === 'y' || normalized === 'yes';
+}
+//# sourceMappingURL=prompt.js.map

package/dist/core/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/core/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,eAAe,CAAC;AAEzC;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,kDAAkD;IAClD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,qCAAqC;IACrC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,MAAM;QACzB,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,MAAM;QACrC,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,MAAM;QAChC,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,CAAC;IAE7C,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,UAAU,GAAG,KAAK;IAC9D,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAEpC,uDAAuD;IACvD,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;QAClB,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAC/C,OAAO,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,KAAK,CAAC;AACpD,CAAC"}

package/dist/index.js

@@ -8,6 +8,8 @@ import { doctorCommand } from './commands/doctor.js';
 import { loginCommand } from './commands/login.js';
 import { devicesCommand } from './commands/devices.js';
 import { logoutCommand } from './commands/logout.js';
+import { statusCommand } from './commands/status.js';
+import { checklistCommand } from './commands/checklist.js';
 const program = new Command();
 program
     .name('vf')
@@ -20,5 +22,7 @@ program.addCommand(doctorCommand);
 program.addCommand(listCommand);
 program.addCommand(addCommand);
 program.addCommand(removeCommand);
+program.addCommand(statusCommand);
+program.addCommand(checklistCommand);
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,IAAI,CAAC;KACV,WAAW,CAAC,oDAAoD,CAAC;KACjE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC;AAEnC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAC/B,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAElC,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,IAAI,CAAC;KACV,WAAW,CAAC,oDAAoD,CAAC;KACjE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC;AAEnC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAC/B,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;AAErC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibefast-cli",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "CLI for installing VibeFast features into your monorepo",
   "type": "module",
   "bin": {
@@ -24,10 +24,12 @@
   "dependencies": {
     "commander": "^12.0.0",
     "picocolors": "^1.0.0",
+    "readline-sync": "^1.4.10",
     "yauzl": "^2.10.0"
   },
   "devDependencies": {
     "@types/node": "^20.11.0",
+    "@types/readline-sync": "^1.4.8",
     "@types/yauzl": "^2.10.3",
     "tsx": "^4.7.0",
     "typescript": "^5.3.3",

package/src/commands/add.ts

@@ -4,20 +4,42 @@ import { getPaths } from '../core/paths.js';
 import { validateSignature, validateTarget } from '../core/validate.js';
 import { getToken, getDeviceInfo } from '../core/auth.js';
 import { fetchRecipe, downloadZip } from '../core/http.js';
-import { addEntry, getEntry } from '../core/journal.js';
+import { addEntry, getEntry, FileEntry } from '../core/journal.js';
 import { copyTree, readFileContent } from '../core/fsx.js';
 import { insertNavLinkNative, insertNavLinkWeb } from '../core/codemod.js';
 import { join, resolve } from 'path';
 import { ensureWithinBase } from '../core/pathGuard.js';
 import { extractZipSafe } from '../core/archive.js';
+import { hashFiles } from '../core/hash.js';
+import { promptYesNo } from '../core/prompt.js';
 
 interface RecipeManifest {
   name: string;
   version: string;
   description: string;
   copy: Array<{ from: string; to: string }>;
-  nav: { href: string; label: string };
+  nav?: { href: string; label: string };
   target: 'native' | 'web';
+  dependencies?: {
+    expo?: string[];
+    npm?: string[];
+  };
+  env?: Array<{
+    key: string;
+    description: string;
+    example: string;
+    link?: string;
+  }>;
+  manualSteps?: Array<{
+    title: string;
+    description: string;
+    link?: string;
+    file?: string;
+    content?: string;
+  }>;
+  postInstall?: {
+    message?: string;
+  };
 }
 
 export const addCommand = new Command('add')
@@ -25,7 +47,8 @@ export const addCommand = new Command('add')
   .argument('<feature>', 'Feature name to install')
   .option('--target <target>', 'Target platform (native or web)', 'native')
   .option('--dry-run', 'Preview changes without applying')
-  .option('--force', 'Overwrite existing files')
+  .option('--force', 'Overwrite existing files without asking')
+  .option('--yes', 'Answer yes to all prompts (for automation)')
   .action(async (feature: string, options) => {
     try {
       const paths = getPaths();
@@ -66,10 +89,76 @@ export const addCommand = new Command('add')
       });
 
       if (!response.ok || (!response.signedUrl && !response.zipData)) {
-        log.error(`Failed to fetch recipe: ${response.error || 'Unknown error'}`);
-        if (response.message) {
-          log.plain(`  ${response.message}`);
+        const error = response.error || 'Unknown error';
+        const message = response.message || '';
+        
+        log.plain('');
+        log.error('Failed to fetch recipe');
+        log.plain('');
+        
+        // User-friendly error messages
+        if (error.includes('Invalid') || error.includes('token') || error.includes('license')) {
+          log.plain('❌ Invalid or expired license key');
+          log.plain('');
+          log.info('Your license key may be:');
+          log.plain('  • Incorrect or mistyped');
+          log.plain('  • Expired');
+          log.plain('  • Revoked');
+          log.plain('');
+          log.info('To fix this:');
+          log.plain('  1. Check your license key from your purchase receipt');
+          log.plain('  2. Run: vf logout');
+          log.plain('  3. Run: vf login --token YOUR_CORRECT_TOKEN');
+          log.plain('');
+          log.info('Need help? Contact support@vibefast.pro');
+        } else if (error.includes('Device limit') || error.includes('device') || message.includes('device')) {
+          log.plain('❌ Device limit reached');
+          log.plain('');
+          log.info('You have reached the maximum number of devices for your license');
+          log.plain('');
+          log.info('To fix this:');
+          log.plain('  1. Run: vf devices');
+          log.plain('  2. Deactivate an unused device: vf devices --deactivate <device-id>');
+          log.plain('  3. Try again: vf add ' + feature);
+          log.plain('');
+          if (message) {
+            log.plain(`Details: ${message}`);
+            log.plain('');
+          }
+        } else if (error.includes('Network') || error.includes('connect')) {
+          log.plain('❌ Network error');
+          log.plain('');
+          log.info('Could not connect to VibeFast servers');
+          log.plain('');
+          log.info('Please check:');
+          log.plain('  • Your internet connection');
+          log.plain('  • Firewall settings');
+          log.plain('  • VPN configuration');
+          log.plain('');
+          if (message) {
+            log.plain(`Details: ${message}`);
+            log.plain('');
+          }
+        } else if (error.includes('not found') || error.includes('404')) {
+          log.plain('❌ Feature not found');
+          log.plain('');
+          log.info(`The feature "${feature}" does not exist or is not available for ${target}`);
+          log.plain('');
+          log.info('To see available features:');
+          log.plain('  vf list');
+          log.plain('');
+        } else {
+          // Generic error
+          log.plain(`❌ ${error}`);
+          if (message) {
+            log.plain('');
+            log.plain(`Details: ${message}`);
+          }
+          log.plain('');
+          log.info('If this problem persists, contact support@vibefast.pro');
         }
+        
+        log.plain('');
         process.exit(1);
       }
 
@@ -96,8 +185,11 @@ export const addCommand = new Command('add')
 
       log.info(`Installing ${manifest.name} v${manifest.version}...`);
 
-      // Copy files
+      // Copy files with interactive confirmation
       const copiedFiles: string[] = [];
+      const allConflicts: string[] = [];
+      const allSkipped: string[] = [];
+      
       for (const copySpec of manifest.copy) {
         const srcPath = ensureWithinBase(
           extractRoot,
@@ -111,11 +203,35 @@ export const addCommand = new Command('add')
         );
         
         log.info(`Copying ${copySpec.from} → ${copySpec.to}`);
-        const files = await copyTree(srcPath, destPath, {
+        const result = await copyTree(srcPath, destPath, {
           dryRun: options.dryRun,
           force: options.force,
+          interactive: !options.force && !options.dryRun && !options.yes,
         });
-        copiedFiles.push(...files);
+        
+        copiedFiles.push(...result.files);
+        allConflicts.push(...result.conflicts);
+        allSkipped.push(...result.skipped);
+      }
+      
+      // Show conflict warnings in dry-run mode
+      if (options.dryRun && allConflicts.length > 0) {
+        log.plain('');
+        log.warn(`⚠ ${allConflicts.length} file(s) will be overwritten:`);
+        allConflicts.slice(0, 5).forEach(f => {
+          const relativePath = f.replace(paths.cwd + '/', '');
+          log.plain(`  • ${relativePath}`);
+        });
+        if (allConflicts.length > 5) {
+          log.plain(`  ... and ${allConflicts.length - 5} more`);
+        }
+        log.warn('⚠ Make sure you have committed your changes to Git!');
+        log.plain('');
+      }
+      
+      // Show skipped files
+      if (allSkipped.length > 0) {
+        log.info(`ℹ Skipped ${allSkipped.length} file(s) (you chose not to overwrite)`);
       }
 
       // Add watermark if provided
@@ -149,29 +265,131 @@ export const addCommand = new Command('add')
         }
       }
 
-      // Update journal
+      // Hash files and update journal
       if (!options.dryRun) {
+        log.info('Computing file hashes...');
+        const fileHashes = await hashFiles(copiedFiles, { showProgress: copiedFiles.length > 20 });
+        
+        const fileEntries: FileEntry[] = Array.from(fileHashes.entries()).map(([path, hash]) => ({
+          path,
+          hash,
+        }));
+        
         await addEntry(paths.journalFile, {
           feature: manifest.name,
           target: manifest.target,
-          files: copiedFiles,
+          files: fileEntries,
           insertedNav: navInserted,
           navHref,
           navLabel,
           ts: Date.now(),
+          manifest: {
+            version: manifest.version,
+            manualSteps: manifest.manualSteps,
+            env: manifest.env,
+          },
         });
       }
 
       log.success(`${manifest.name} installed successfully!`);
       log.info(`Files added: ${copiedFiles.length}`);
       
+      // Show required packages
+      if (manifest.dependencies) {
+        log.plain('');
+        log.warn('⚠ This feature requires additional packages');
+        log.plain('');
+        
+        if (manifest.target === 'native' && manifest.dependencies.expo) {
+          const packages = manifest.dependencies.expo;
+          
+          log.info('📦 Required packages:');
+          packages.forEach(pkg => {
+            log.plain(`  • ${pkg}`);
+          });
+          log.plain('');
+          
+          log.info('Install with:');
+          log.plain(`  npx expo install ${packages.join(' ')}`);
+          log.plain('');
+          log.info('💡 Expo will automatically pick compatible versions');
+          
+        } else if (manifest.target === 'web' && manifest.dependencies.npm) {
+          const packages = manifest.dependencies.npm;
+          
+          log.info('📦 Required packages:');
+          packages.forEach(pkg => {
+            log.plain(`  • ${pkg}`);
+          });
+          log.plain('');
+          
+          log.info('Install with:');
+          log.plain(`  pnpm add ${packages.join(' ')}`);
+          log.plain('  OR');
+          log.plain(`  yarn add ${packages.join(' ')}`);
+          log.plain(`  OR`);
+          log.plain(`  npm install ${packages.join(' ')}`);
+        }
+        
+        log.plain('');
+      }
+      
+      // Show manual steps
+      if (manifest.manualSteps && !options.dryRun) {
+        log.plain('');
+        log.warn('⚠ MANUAL STEPS REQUIRED:');
+        log.plain('');
+        log.plain('This feature requires some manual configuration:');
+        log.plain('');
+        
+        manifest.manualSteps.forEach((step, index) => {
+          log.plain(`Step ${index + 1}: ${step.title}`);
+          log.plain(`  ${step.description}`);
+          if (step.link) {
+            log.plain(`  🔗 ${step.link}`);
+          }
+          if (step.file) {
+            log.plain(`  📝 File: ${step.file}`);
+          }
+          if (step.content) {
+            log.plain(`  Add: ${step.content}`);
+          }
+          log.plain('');
+        });
+        
+        log.info(`💡 Run 'vf checklist ${manifest.name}' to see these steps again`);
+        log.plain('');
+      }
+      
+      // Show environment variables
+      if (manifest.env && !options.dryRun) {
+        log.plain('');
+        log.warn('⚠ REQUIRED ENVIRONMENT VARIABLES:');
+        log.plain('');
+        
+        manifest.env.forEach(envVar => {
+          log.plain(`  ${envVar.key}`);
+          log.plain(`    ${envVar.description}`);
+          log.plain(`    Example: ${envVar.example}`);
+          if (envVar.link) {
+            log.plain(`    Get it: ${envVar.link}`);
+          }
+          log.plain('');
+        });
+        
+        log.info('Add these to your .env file');
+        log.plain('');
+      }
+      
+      // Post-install message
+      if (manifest.postInstall?.message && !options.dryRun) {
+        log.plain('');
+        log.info(manifest.postInstall.message);
+      }
+      
       if (options.dryRun) {
+        log.plain('');
         log.warn('This was a dry run. Run without --dry-run to apply changes.');
-      } else {
-        log.info('Next steps:');
-        log.plain(`  1. Review the changes in your repo`);
-        log.plain(`  2. Run your dev server to test`);
-        log.plain(`  3. Navigate to the new feature`);
       }
     } catch (error: any) {
       log.error(`Installation failed: ${error.message}`);

package/src/commands/checklist.ts

@@ -0,0 +1,71 @@
+import { Command } from 'commander';
+import { log } from '../core/log.js';
+import { getPaths } from '../core/paths.js';
+import { getEntry } from '../core/journal.js';
+
+export const checklistCommand = new Command('checklist')
+  .description('Show manual setup steps for an installed feature')
+  .argument('<feature>', 'Feature name')
+  .option('--target <target>', 'Target platform (native or web)', 'native')
+  .action(async (feature: string, options) => {
+    try {
+      const paths = getPaths();
+      const target = options.target as 'native' | 'web';
+      
+      // Check if feature is installed
+      const entry = await getEntry(paths.journalFile, feature, target);
+      if (!entry) {
+        log.error(`${feature} is not installed for ${target}`);
+        log.info('Run "vf status" to see installed features');
+        process.exit(1);
+      }
+      
+      // Check if feature has manual steps
+      if (!entry.manifest?.manualSteps || entry.manifest.manualSteps.length === 0) {
+        log.info(`${feature} has no manual setup steps`);
+        log.success('This feature is ready to use!');
+        return;
+      }
+      
+      // Display manual steps
+      log.info(`Manual setup steps for ${feature}:`);
+      log.plain('');
+      
+      entry.manifest.manualSteps.forEach((step: any, index: number) => {
+        log.plain(`Step ${index + 1}: ${step.title}`);
+        log.plain(`  ${step.description}`);
+        if (step.link) {
+          log.plain(`  🔗 ${step.link}`);
+        }
+        if (step.file) {
+          log.plain(`  📝 File: ${step.file}`);
+        }
+        if (step.content) {
+          log.plain(`  Add: ${step.content}`);
+        }
+        log.plain('');
+      });
+      
+      // Display environment variables if any
+      if (entry.manifest.env && entry.manifest.env.length > 0) {
+        log.warn('⚠ REQUIRED ENVIRONMENT VARIABLES:');
+        log.plain('');
+        
+        entry.manifest.env.forEach((envVar: any) => {
+          log.plain(`  ${envVar.key}`);
+          log.plain(`    ${envVar.description}`);
+          log.plain(`    Example: ${envVar.example}`);
+          if (envVar.link) {
+            log.plain(`    Get it: ${envVar.link}`);
+          }
+          log.plain('');
+        });
+        
+        log.info('Add these to your .env file');
+      }
+      
+    } catch (error: any) {
+      log.error(`Failed to show checklist: ${error.message}`);
+      process.exit(1);
+    }
+  });

package/src/commands/remove.ts

@@ -2,15 +2,19 @@ import { Command } from 'commander';
 import { log } from '../core/log.js';
 import { getPaths } from '../core/paths.js';
 import { validateSignature, validateTarget } from '../core/validate.js';
-import { getEntry, removeEntry } from '../core/journal.js';
+import { getEntry, removeEntry, FileEntry } from '../core/journal.js';
 import { deleteFile } from '../core/fsx.js';
 import { removeNavLinkNative, removeNavLinkWeb } from '../core/codemod.js';
+import { hashFile } from '../core/hash.js';
+import { promptYesNo } from '../core/prompt.js';
 
 export const removeCommand = new Command('remove')
   .description('Remove a VibeFast feature from your project')
   .argument('<feature>', 'Feature name to remove')
   .option('--target <target>', 'Target platform (native or web)', 'native')
   .option('--dry-run', 'Preview changes without applying')
+  .option('--force', 'Skip modification check')
+  .option('--yes', 'Answer yes to all prompts')
   .action(async (feature: string, options) => {
     try {
       const paths = getPaths();
@@ -35,8 +39,99 @@ export const removeCommand = new Command('remove')
 
       log.info(`Removing ${feature} from ${target}...`);
 
+      // Check for modifications (unless --force)
+      if (!options.force && !options.dryRun) {
+        log.info('Checking for file modifications...');
+        
+        const modifiedFiles: Array<{ path: string; status: 'modified' | 'deleted' }> = [];
+        
+        // Get file paths from entry
+        const filePaths = Array.isArray(entry.files) && entry.files.length > 0
+          ? typeof entry.files[0] === 'string'
+            ? entry.files as string[]
+            : (entry.files as FileEntry[]).map(f => f.path)
+          : [];
+        
+        const fileHashes = Array.isArray(entry.files) && entry.files.length > 0 && typeof entry.files[0] !== 'string'
+          ? new Map((entry.files as FileEntry[]).map(f => [f.path, f.hash]))
+          : new Map<string, string>();
+        
+        for (const filePath of filePaths) {
+          const originalHash = fileHashes.get(filePath);
+          
+          // Skip if we don't have original hash (old journal format)
+          if (!originalHash) continue;
+          
+          const currentHash = await hashFile(filePath);
+          
+          if (currentHash === '') {
+            // File was deleted by user
+            modifiedFiles.push({ path: filePath, status: 'deleted' });
+          } else if (currentHash !== originalHash) {
+            // File was modified by user
+            modifiedFiles.push({ path: filePath, status: 'modified' });
+          }
+        }
+        
+        // Warn about modifications
+        if (modifiedFiles.length > 0) {
+          log.plain('');
+          log.warn('⚠ WARNING: The following files were changed:');
+          log.plain('');
+          
+          const modified = modifiedFiles.filter(f => f.status === 'modified');
+          const deleted = modifiedFiles.filter(f => f.status === 'deleted');
+          
+          if (modified.length > 0) {
+            log.plain('  Modified by you:');
+            modified.slice(0, 10).forEach(f => {
+              const relativePath = f.path.replace(paths.cwd + '/', '');
+              log.plain(`    • ${relativePath}`);
+            });
+            if (modified.length > 10) {
+              log.plain(`    ... and ${modified.length - 10} more`);
+            }
+          }
+          
+          if (deleted.length > 0) {
+            log.plain('');
+            log.plain('  Already deleted:');
+            deleted.slice(0, 5).forEach(f => {
+              const relativePath = f.path.replace(paths.cwd + '/', '');
+              log.plain(`    • ${relativePath}`);
+            });
+            if (deleted.length > 5) {
+              log.plain(`    ... and ${deleted.length - 5} more`);
+            }
+          }
+          
+          log.plain('');
+          log.warn('⚠ Your changes will be LOST if you continue!');
+          log.info('💡 Make sure you have committed to Git.');
+          log.plain('');
+          
+          if (!options.yes) {
+            const shouldContinue = promptYesNo(
+              'Continue with removal? (y/N): ',
+              false
+            );
+            
+            if (!shouldContinue) {
+              log.info('Removal cancelled');
+              return;
+            }
+          }
+        }
+      }
+
       // Delete files
-      for (const file of entry.files) {
+      const filePaths = Array.isArray(entry.files) && entry.files.length > 0
+        ? typeof entry.files[0] === 'string'
+          ? entry.files as string[]
+          : (entry.files as FileEntry[]).map(f => f.path)
+        : [];
+      
+      for (const file of filePaths) {
         log.info(`Deleting ${file}`);
         if (!options.dryRun) {
           await deleteFile(file);
@@ -66,7 +161,14 @@ export const removeCommand = new Command('remove')
       }
 
       log.success(`${feature} removed successfully!`);
-      log.info(`Files deleted: ${entry.files.length}`);
+      
+      const fileCount = Array.isArray(entry.files) && entry.files.length > 0
+        ? typeof entry.files[0] === 'string'
+          ? entry.files.length
+          : (entry.files as FileEntry[]).length
+        : 0;
+      
+      log.info(`Files deleted: ${fileCount}`);
       
       if (options.dryRun) {
         log.warn('This was a dry run. Run without --dry-run to apply changes.');

package/src/commands/status.ts

@@ -0,0 +1,47 @@
+import { Command } from 'commander';
+import { log } from '../core/log.js';
+import { getPaths } from '../core/paths.js';
+import { readJournal, FileEntry } from '../core/journal.js';
+
+export const statusCommand = new Command('status')
+  .description('Show installed features and their status')
+  .action(async () => {
+    try {
+      const paths = getPaths();
+      const journal = await readJournal(paths.journalFile);
+      
+      if (journal.entries.length === 0) {
+        log.info('No features installed yet');
+        log.info('Run "vf list" to see available features');
+        return;
+      }
+      
+      log.info('Installed features:');
+      log.plain('');
+      
+      for (const entry of journal.entries) {
+        const version = entry.manifest?.version || 'unknown';
+        const fileCount = Array.isArray(entry.files) && entry.files.length > 0
+          ? typeof entry.files[0] === 'string'
+            ? entry.files.length
+            : (entry.files as FileEntry[]).length
+          : 0;
+        
+        log.plain(`  ✓ ${entry.feature} (v${version}) - ${entry.target}`);
+        log.plain(`    Files: ${fileCount}`);
+        log.plain(`    Installed: ${new Date(entry.ts).toLocaleDateString()}`);
+        
+        if (entry.manifest?.manualSteps && entry.manifest.manualSteps.length > 0) {
+          log.plain(`    ⚠ Has manual setup steps (run: vf checklist ${entry.feature})`);
+        }
+        
+        log.plain('');
+      }
+      
+      log.info(`Total: ${journal.entries.length} feature(s) installed`);
+      
+    } catch (error: any) {
+      log.error(`Failed to show status: ${error.message}`);
+      process.exit(1);
+    }
+  });