@geekmidas/cli 0.8.0 → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekmidas/cli",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "CLI tools for building Lambda handlers, server applications, and generating OpenAPI specs",
   "private": false,
   "type": "module",
@@ -50,14 +50,14 @@
     "typescript": "^5.8.2",
     "vitest": "^3.2.4",
     "zod": "~4.1.13",
-    "@geekmidas/testkit": "0.3.1"
+    "@geekmidas/testkit": "0.4.0"
   },
   "peerDependencies": {
-    "@geekmidas/envkit": "~0.1.0",
-    "@geekmidas/logger": "~0.1.0",
-    "@geekmidas/constructs": "~0.2.4",
-    "@geekmidas/telescope": "~0.1.0",
-    "@geekmidas/schema": "~0.0.3"
+    "@geekmidas/constructs": "~0.3.0",
+    "@geekmidas/logger": "~0.3.0",
+    "@geekmidas/envkit": "~0.2.0",
+    "@geekmidas/schema": "~0.1.0",
+    "@geekmidas/telescope": "~0.2.0"
   },
   "peerDependenciesMeta": {
     "@geekmidas/telescope": {

package/src/dev/index.ts

@@ -230,6 +230,7 @@ export function normalizeHooksConfig(
 
 export interface DevOptions {
   port?: number;
+  portExplicit?: boolean;
   enableOpenApi?: boolean;
 }
 
@@ -332,6 +333,7 @@ export async function devCommand(options: DevOptions): Promise<void> {
   const devServer = new DevServer(
     resolved.providers[0] as LegacyProvider,
     options.port || 3000,
+    options.portExplicit ?? false,
     enableOpenApi,
     telescope,
     studio,
@@ -499,6 +501,7 @@ class DevServer {
   constructor(
     private provider: LegacyProvider,
     private requestedPort: number,
+    private portExplicit: boolean,
     private enableOpenApi: boolean,
     private telescope?: NormalizedTelescopeConfig,
     private studio?: NormalizedStudioConfig,
@@ -512,13 +515,26 @@ class DevServer {
       await this.stop();
     }
 
-    // Find an available port
-    this.actualPort = await findAvailablePort(this.requestedPort);
+    // Check port availability
+    if (this.portExplicit) {
+      // Port was explicitly specified - throw if unavailable
+      const available = await isPortAvailable(this.requestedPort);
+      if (!available) {
+        throw new Error(
+          `Port ${this.requestedPort} is already in use. ` +
+            `Either stop the process using that port or omit -p/--port to auto-select an available port.`,
+        );
+      }
+      this.actualPort = this.requestedPort;
+    } else {
+      // Find an available port starting from the default
+      this.actualPort = await findAvailablePort(this.requestedPort);
 
-    if (this.actualPort !== this.requestedPort) {
-      logger.log(
-        `ℹ️  Port ${this.requestedPort} was in use, using port ${this.actualPort} instead`,
-      );
+      if (this.actualPort !== this.requestedPort) {
+        logger.log(
+          `ℹ️  Port ${this.requestedPort} was in use, using port ${this.actualPort} instead`,
+        );
+      }
     }
 
     const serverEntryPath = join(

package/src/index.ts

@@ -111,7 +111,7 @@ program
 program
   .command('dev')
   .description('Start development server with automatic reload')
-  .option('--port <port>', 'Port to run the development server on', '3000')
+  .option('-p, --port <port>', 'Port to run the development server on')
   .option(
     '--enable-openapi',
     'Enable OpenAPI documentation for development server',
@@ -126,6 +126,7 @@ program
 
       await devCommand({
         port: options.port ? Number.parseInt(options.port) : 3000,
+        portExplicit: !!options.port,
         enableOpenApi: options.enableOpenapi ?? true,
       });
     } catch (error) {
@@ -169,22 +170,14 @@ program
 
 program
   .command('openapi')
-  .description(
-    'Generate OpenAPI specification from endpoints (TypeScript by default)',
-  )
-  .option(
-    '--output <path>',
-    'Output file path for the OpenAPI spec',
-    'openapi.ts',
-  )
-  .option('--json', 'Generate JSON instead of TypeScript (legacy)', false)
-  .action(async (options: { output?: string; json?: boolean }) => {
+  .description('Generate OpenAPI specification from endpoints')
+  .action(async () => {
     try {
       const globalOptions = program.opts();
       if (globalOptions.cwd) {
         process.chdir(globalOptions.cwd);
       }
-      await openapiCommand(options);
+      await openapiCommand({});
     } catch (error) {
       console.error('OpenAPI generation failed:', (error as Error).message);
       process.exit(1);