vibefast-cli 0.1.3 → 0.2.0

package/dist/core/journal.js

@@ -1,11 +1,33 @@
 import { readFileContent, writeFileContent, exists, ensureDir } from './fsx.js';
 import { dirname } from 'path';
+import { hashFile } from './hash.js';
 export async function readJournal(journalPath) {
     if (!(await exists(journalPath))) {
         return { entries: [] };
     }
     const content = await readFileContent(journalPath);
-    return JSON.parse(content);
+    const journal = JSON.parse(content);
+    // Migrate old format to new format
+    let needsMigration = false;
+    for (const entry of journal.entries) {
+        if (entry.files.length > 0 && typeof entry.files[0] === 'string') {
+            needsMigration = true;
+            // Old format: array of strings
+            const oldFiles = entry.files;
+            // Convert to new format with hashes
+            const newFiles = [];
+            for (const filePath of oldFiles) {
+                const hash = await hashFile(filePath);
+                newFiles.push({ path: filePath, hash });
+            }
+            entry.files = newFiles;
+        }
+    }
+    // Save migrated journal
+    if (needsMigration) {
+        await writeJournal(journalPath, journal);
+    }
+    return journal;
 }
 export async function writeJournal(journalPath, journal) {
     await ensureDir(dirname(journalPath));

package/dist/core/journal.js.map

@@ -1 +1 @@
-{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../src/core/journal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAgB/B,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,WAAmB;IACnD,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACzB,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;IACnD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,WAAmB,EAAE,OAAgB;IACtE,MAAM,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IACtC,MAAM,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACzF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,WAAmB,EAAE,KAAmB;IACrE,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IAC/C,gDAAgD;IAChD,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CACtC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC,CACjE,CAAC;IACF,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,WAAmB,EACnB,OAAe,EACf,MAAwB;IAExB,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IACtF,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CACtC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CACrD,CAAC;IACF,MAAM,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACzC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,WAAmB,EACnB,OAAe,EACf,MAAwB;IAExB,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IAC/C,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC;AACzF,CAAC"}
+{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../src/core/journal.ts"],"names":[],"mappings":"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"}

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

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
-import pkg from '../package.json' assert { type: 'json' };
+import pkg from '../package.json' with { type: 'json' };
 import { addCommand } from './commands/add.js';
 import { removeCommand } from './commands/remove.js';
 import { listCommand } from './commands/list.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,SAAS,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1D,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.3",
+  "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);
+    }
+  });