feat(cli): add --dev flag to target localhost development environment

- Add dev flag to CommonOptions interface
- Update createLatitudeClient to check for dev flag
- Add --dev flag to all CLI commands (init, pull, push, status, checkout)
- When --dev flag is set, CLI connects to localhost:8787 instead of production

Author: geclos

packages/cli/src/commands/checkout.ts

@@ -241,6 +241,10 @@ export function checkout(program: Command): void {
           description:
             'Create a new version/commit with the specified name and checkout to it',
         },
+        {
+          flags: '--dev',
+          description: 'Use localhost development environment',
+        },
       ],
       action: async (command, versionUuid, options) => {
         await command.execute(versionUuid, options)

packages/cli/src/commands/init.ts

@@ -329,6 +329,10 @@ export function init(program: Command): void {
           description: 'Path to initialize the project in',
           defaultValue: '.',
         },
+        {
+          flags: '--dev',
+          description: 'Use localhost development environment',
+        },
       ],
       action: async (command, options) => {
         await command.execute(options)

packages/cli/src/commands/pull.ts

@@ -325,6 +325,10 @@ export function pull(program: Command): void {
           flags: '-y, --yes',
           description: 'Skip confirmation and pull automatically',
         },
+        {
+          flags: '--dev',
+          description: 'Use localhost development environment',
+        },
       ],
       action: async (command, options) => {
         await command.execute(options)

packages/cli/src/commands/push.ts

@@ -300,6 +300,10 @@ export function push(program: Command): void {
           flags: '-y, --yes',
           description: 'Skip confirmation and push automatically',
         },
+        {
+          flags: '--dev',
+          description: 'Use localhost development environment',
+        },
       ],
       action: async (command, options) => {
         await command.execute(options)

packages/cli/src/commands/status.ts

@@ -258,6 +258,10 @@ export function status(program: Command): void {
           description: 'Path to the project',
           defaultValue: '.',
         },
+        {
+          flags: '--dev',
+          description: 'Use localhost development environment',
+        },
       ],
       action: async (command, options) => {
         await command.execute(options)

packages/cli/src/types.ts

@@ -10,6 +10,7 @@ export type CommandHandler = (program: Command) => void
  */
 export interface CommonOptions {
   path: string
+  dev?: boolean
 }
 
 /**

packages/cli/src/utils/baseCommand.ts

@@ -36,10 +36,11 @@ export abstract class BaseCommand {
    */
   abstract execute(...args: any[]): Promise<void>
 
-  protected async setClient() {
+  protected async setClient(options?: CommonOptions) {
     if (!this.client) {
       this.client = this.createLatitudeClient(
         await this.configManager.getApiKey(),
+        options,
       )
     }
 
@@ -57,8 +58,11 @@ export abstract class BaseCommand {
    * Creates a Latitude client with the appropriate configuration
    * Includes optional config for development environments
    */
-  protected createLatitudeClient(apiKey: string): Latitude {
-    if (process.env.NODE_ENV === 'development') {
+  protected createLatitudeClient(
+    apiKey: string,
+    options?: CommonOptions,
+  ): Latitude {
+    if (process.env.NODE_ENV === 'development' || options?.dev) {
       return new Latitude(apiKey, {
         __internal: {
           gateway: {
@@ -83,7 +87,7 @@ export abstract class BaseCommand {
   ): Promise<void> {
     this.setProjectPath(options)
 
-    await this.setClient()
+    await this.setClient(options)
     await this.detectModuleFormat()
     await validateEnvironment(
       this.projectPath,