feat: add Node.js version management and improve error handling

- Introduced a .nvmrc file to specify the Node.js version (22) for the project, ensuring consistent development environments.
- Enhanced error handling in the startServer function to provide clearer messages when the Node.js executable cannot be found, improving debugging experience.
- Updated package.json files across various modules to enforce Node.js version compatibility and ensure consistent dependency versions.

These changes aim to streamline development processes and enhance the application's reliability by enforcing version control and improving error reporting.

libs/dependency-resolver/package.json

@@ -25,12 +25,15 @@
   ],
   "author": "AutoMaker Team",
   "license": "SEE LICENSE IN LICENSE",
+  "engines": {
+    "node": ">=22.0.0 <23.0.0"
+  },
   "dependencies": {
-    "@automaker/types": "^1.0.0"
+    "@automaker/types": "1.0.0"
   },
   "devDependencies": {
-    "@types/node": "^22.10.5",
-    "typescript": "^5.7.3",
-    "vitest": "^4.0.16"
+    "@types/node": "22.19.3",
+    "typescript": "5.9.3",
+    "vitest": "4.0.16"
   }
 }

libs/git-utils/package.json

@@ -18,13 +18,16 @@
   ],
   "author": "AutoMaker Team",
   "license": "SEE LICENSE IN LICENSE",
+  "engines": {
+    "node": ">=22.0.0 <23.0.0"
+  },
   "dependencies": {
-    "@automaker/types": "^1.0.0",
-    "@automaker/utils": "^1.0.0"
+    "@automaker/types": "1.0.0",
+    "@automaker/utils": "1.0.0"
   },
   "devDependencies": {
-    "@types/node": "^22.10.5",
-    "typescript": "^5.7.3",
-    "vitest": "^4.0.16"
+    "@types/node": "22.19.3",
+    "typescript": "5.9.3",
+    "vitest": "4.0.16"
   }
 }

libs/model-resolver/package.json

@@ -18,12 +18,15 @@
   ],
   "author": "AutoMaker Team",
   "license": "SEE LICENSE IN LICENSE",
+  "engines": {
+    "node": ">=22.0.0 <23.0.0"
+  },
   "dependencies": {
-    "@automaker/types": "^1.0.0"
+    "@automaker/types": "1.0.0"
   },
   "devDependencies": {
-    "@types/node": "^22.10.5",
-    "typescript": "^5.7.3",
-    "vitest": "^4.0.16"
+    "@types/node": "22.19.3",
+    "typescript": "5.9.3",
+    "vitest": "4.0.16"
   }
 }

libs/platform/package.json

@@ -17,13 +17,16 @@
   ],
   "author": "AutoMaker Team",
   "license": "SEE LICENSE IN LICENSE",
+  "engines": {
+    "node": ">=22.0.0 <23.0.0"
+  },
   "dependencies": {
-    "@automaker/types": "^1.0.0",
-    "p-limit": "^6.2.0"
+    "@automaker/types": "1.0.0",
+    "p-limit": "6.2.0"
   },
   "devDependencies": {
-    "@types/node": "^22.10.5",
-    "typescript": "^5.7.3",
-    "vitest": "^4.0.16"
+    "@types/node": "22.19.3",
+    "typescript": "5.9.3",
+    "vitest": "4.0.16"
   }
 }

libs/platform/src/secure-fs.ts

@@ -165,17 +165,26 @@ export async function readFile(
   }, `readFile(${filePath})`);
 }
 
+/**
+ * Options for writeFile
+ */
+export interface WriteFileOptions {
+  encoding?: BufferEncoding;
+  mode?: number;
+  flag?: string;
+}
+
 /**
  * Wrapper around fs.writeFile that validates path first
  */
 export async function writeFile(
   filePath: string,
   data: string | Buffer,
-  encoding?: BufferEncoding
+  optionsOrEncoding?: BufferEncoding | WriteFileOptions
 ): Promise<void> {
   const validatedPath = validatePath(filePath);
   return executeWithRetry(
-    () => fs.writeFile(validatedPath, data, encoding),
+    () => fs.writeFile(validatedPath, data, optionsOrEncoding),
     `writeFile(${filePath})`
   );
 }

libs/platform/src/system-paths.ts

@@ -114,13 +114,16 @@ export function getShellPaths(): string[] {
   if (process.platform === 'win32') {
     return [
       process.env.COMSPEC || 'cmd.exe',
+      'cmd.exe',
       'powershell.exe',
+      'pwsh.exe', // PowerShell Core short form
       'C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe',
       'C:\\Program Files\\PowerShell\\7\\pwsh.exe',
+      'C:\\Program Files\\PowerShell\\7-preview\\pwsh.exe', // Preview versions
     ];
   }
 
-  return ['/bin/zsh', '/bin/bash', '/bin/sh'];
+  return ['/bin/zsh', '/bin/bash', '/bin/sh', '/usr/bin/zsh', '/usr/bin/bash'];
 }
 
 // =============================================================================

libs/prompts/package.json

@@ -18,12 +18,15 @@
   ],
   "author": "AutoMaker Team",
   "license": "SEE LICENSE IN LICENSE",
+  "engines": {
+    "node": ">=22.0.0 <23.0.0"
+  },
   "dependencies": {
-    "@automaker/types": "^1.0.0"
+    "@automaker/types": "1.0.0"
   },
   "devDependencies": {
-    "@types/node": "^22.10.5",
-    "typescript": "^5.7.3",
-    "vitest": "^4.0.16"
+    "@types/node": "22.19.3",
+    "typescript": "5.9.3",
+    "vitest": "4.0.16"
   }
 }

libs/prompts/src/defaults.ts

@@ -208,6 +208,9 @@ This feature depends on: {{dependencies}}
 **Verification:**
 {{verificationInstructions}}
 {{/if}}
+
+**CRITICAL - Port Protection:**
+NEVER kill or terminate processes running on ports 3007 or 3008. These are reserved for the Automaker application. Killing these ports will crash Automaker and terminate this session.
 `;
 
 export const DEFAULT_AUTO_MODE_FOLLOW_UP_PROMPT_TEMPLATE = `## Follow-up on Feature Implementation
@@ -299,6 +302,9 @@ You have access to several tools:
 4. Ask questions when requirements are unclear
 5. Guide users toward good software design principles
 
+**CRITICAL - Port Protection:**
+NEVER kill or terminate processes running on ports 3007 or 3008. These are reserved for the Automaker application itself. Killing these ports will crash Automaker and terminate your session.
+
 Remember: You're a collaborative partner in the development process. Be helpful, clear, and thorough.`;
 
 /**

libs/types/package.json

@@ -15,8 +15,11 @@
   ],
   "author": "AutoMaker Team",
   "license": "SEE LICENSE IN LICENSE",
+  "engines": {
+    "node": ">=22.0.0 <23.0.0"
+  },
   "devDependencies": {
-    "@types/node": "^22.10.5",
-    "typescript": "^5.7.3"
+    "@types/node": "22.19.3",
+    "typescript": "5.9.3"
   }
 }

libs/utils/package.json

@@ -17,13 +17,16 @@
   ],
   "author": "AutoMaker Team",
   "license": "SEE LICENSE IN LICENSE",
+  "engines": {
+    "node": ">=22.0.0 <23.0.0"
+  },
   "dependencies": {
-    "@automaker/platform": "^1.0.0",
-    "@automaker/types": "^1.0.0"
+    "@automaker/platform": "1.0.0",
+    "@automaker/types": "1.0.0"
   },
   "devDependencies": {
-    "@types/node": "^22.10.5",
-    "typescript": "^5.7.3",
-    "vitest": "^4.0.16"
+    "@types/node": "22.19.3",
+    "typescript": "5.9.3",
+    "vitest": "4.0.16"
   }
 }