create-healix 1.3.0 → 1.3.2

package/bin/create-healix.js

@@ -11,10 +11,13 @@ Usage: create-healix [project-name] [options]
 Options:
   --help, -h        Show this help
   --port <n>        Healix API port (default: 4000; avoid 3000 which is common for app servers)
+  --skip-install    Scaffold files only; do NOT run npm install (run it yourself)
+  --yes, -y         Accept defaults without prompting
 
 Examples:
   npx create-healix my-app
   npx create-healix my-app --port 4001
+  npx create-healix my-app --skip-install   # then: cd my-app && npm install
 `);
   process.exit(0);
 }
@@ -22,6 +25,7 @@ Examples:
 let projectName = args.find(a => !a.startsWith('--') && isNaN(Number(a)));
 const portIdx = args.indexOf('--port');
 const apiPort = portIdx !== -1 && args[portIdx + 1] ? parseInt(args[portIdx + 1], 10) : 4000;
+const skipInstall = args.includes('--skip-install');
 
 if (!projectName) {
   const response = await prompts({
@@ -40,7 +44,7 @@ if (!projectName) {
 }
 
 try {
-  scaffold(projectName, process.cwd(), { apiPort });
+  scaffold(projectName, process.cwd(), { apiPort, skipInstall });
 } catch (err) {
   console.error(`Error: ${err.message}`);
   process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-healix",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "Scaffold a healix WDIO project with MCP integration ready out of the box",
   "type": "module",
   "bin": {
@@ -17,7 +17,7 @@
   },
   "dependencies": {
     "prompts": "^2.4.2",
-    "wdio-healix-service": "^0.2.0"
+    "wdio-healix-service": "^0.3.0"
   },
   "engines": {
     "node": ">=18"

package/src/scaffold.js

@@ -73,18 +73,29 @@ export function scaffold(projectName, targetDir, options = {}) {
   mergeWorkspaceMcp(path.join(workspaceDir, '.mcp.json'), apiPort);
 
   console.log(`\n✓ Project created: ${projectDir}`);
-  console.log('\nInstalling dependencies...\n');
 
-  try {
-    execSync('npm install', { cwd: projectDir, stdio: 'inherit' });
-    console.log('\n✓ Dependencies installed');
-  } catch {
-    console.warn('\n⚠ npm install failed — run it manually inside the project directory');
+  // Install is the slow part (large WDIO + sharp tree). --skip-install lets callers
+  // (and agent tool-runners with short timeouts) scaffold instantly and install
+  // themselves. On failure we surface the real error LOUDLY — a silently-swallowed
+  // install leaves a broken project that looks fine.
+  if (options.skipInstall) {
+    console.log('\n⏭  Skipped dependency install (--skip-install).');
+    console.log(`   Finish setup with:  cd ${projectName} && npm install\n`);
+  } else {
+    console.log('\nInstalling dependencies (this can take a few minutes)...\n');
+    try {
+      execSync('npm install', { cwd: projectDir, stdio: 'inherit' });
+      console.log('\n✓ Dependencies installed');
+    } catch (e) {
+      console.error(`\n⚠ npm install FAILED: ${e.message}`);
+      console.error(`   The project files are written, but node_modules is incomplete.`);
+      console.error(`   Run it manually:  cd ${projectName} && npm install\n`);
+    }
   }
 
   console.log(`
 Done! Next steps:
-  cd ${projectName}
+  cd ${projectName}${options.skipInstall ? '\n  npm install' : ''}
   npm run session:web
 `);
 }