chore: change command serve to start

michasdev · michasdev · commit 3991cbfbe6c7 · 2026-04-27T01:29:28.000-03:00
diff --git a/apps/desktop/src/main/mildstack-ipc.ts b/apps/desktop/src/main/mildstack-ipc.ts
@@ -83,14 +83,14 @@ export function registerMildStackIpcHandlers(): void {
         }
     })
 
-    ipcMain.handle('mildstack:serve', async (_event, port: number): Promise<{ success: boolean; error?: string }> => {
+    ipcMain.handle('mildstack:start', async (_event, port: number): Promise<{ success: boolean; error?: string }> => {
         try {
             // --d flag to detach (run in background)
-            await execAsync(`${mildStackExecutable} serve ${port} --d`)
+            await execAsync(`${mildStackExecutable} start ${port} --d`)
             return { success: true }
         } catch (err) {
             const error = parseCliError(err)
-            console.error('[MildStack IPC] serve error:', error)
+            console.error('[MildStack IPC] start error:', error)
             return { success: false, error }
         }
     })
diff --git a/apps/desktop/src/preload/index.d.ts b/apps/desktop/src/preload/index.d.ts
@@ -192,7 +192,7 @@ interface MildStackInstancesResponse {
 
 interface MildStackApi {
   instances(): Promise<MildStackInstancesResponse>
-  serve(port: number): Promise<{ success: boolean; error?: string }>
+  start(port: number): Promise<{ success: boolean; error?: string }>
   stop(port?: number, all?: boolean): Promise<{ success: boolean; error?: string }>
   delete(port?: number, all?: boolean): Promise<{ success: boolean; error?: string }>
   validateInstance(): Promise<{ valid: boolean; error?: string }>
diff --git a/apps/desktop/src/preload/index.ts b/apps/desktop/src/preload/index.ts
@@ -194,7 +194,7 @@ interface MildStackInstancesResponse {
 
 interface MildStackApi {
   instances(): Promise<MildStackInstancesResponse>
-  serve(port: number): Promise<{ success: boolean; error?: string }>
+  start(port: number): Promise<{ success: boolean; error?: string }>
   stop(port?: number, all?: boolean): Promise<{ success: boolean; error?: string }>
   delete(port?: number, all?: boolean): Promise<{ success: boolean; error?: string }>
   validateInstance(): Promise<{ valid: boolean; error?: string }>
@@ -304,7 +304,7 @@ const api: { s3: S3BrowserApi; dynamodb: DynamoDBBrowserApi; sqs: SQSBrowserApi;
   },
   mildstack: {
     instances: () => ipcRenderer.invoke('mildstack:instances'),
-    serve: (port) => ipcRenderer.invoke('mildstack:serve', port),
+    start: (port) => ipcRenderer.invoke('mildstack:start', port),
     stop: (port?, all?) => ipcRenderer.invoke('mildstack:stop', { port, all }),
     delete: (port?, all?) => ipcRenderer.invoke('mildstack:delete', { port, all }),
     validateInstance: () => ipcRenderer.invoke('mildstack:validateInstance')
diff --git a/apps/desktop/src/renderer/src/store/instance-store.ts b/apps/desktop/src/renderer/src/store/instance-store.ts
@@ -87,7 +87,7 @@ export const useInstanceStore = create<InstanceState>((set, get) => ({
     },
 
     serveInstance: async (port: number) => {
-        const result = await window.api.mildstack.serve(port);
+        const result = await window.api.mildstack.start(port);
         if (result.success) {
             // Refresh instances after starting
             await get().fetchInstances();
diff --git a/apps/web/www/content/docs/getting-started/installation.mdx b/apps/web/www/content/docs/getting-started/installation.mdx
@@ -57,7 +57,7 @@ Usage:
   mildstack [command]
 
 Available Commands:
-  serve       Start the shared HTTP runtime
+  start       Start the shared HTTP runtime
   instances   List known instances
   status      Show instance status
   stop        Stop a running instance
diff --git a/apps/web/www/content/docs/getting-started/quick-start.mdx b/apps/web/www/content/docs/getting-started/quick-start.mdx
@@ -9,19 +9,19 @@ description: |
 Launch a MildStack instance with a single command:
 
 ```bash
-mildstack serve
+mildstack start
 ```
 
 By default, the runtime starts on port `4566`. You can specify a different port:
 
 ```bash
-mildstack serve 8080
+mildstack start 8080
 ```
 
 To start the instance in the background (detached mode):
 
 ```bash
-mildstack serve --detach
+mildstack start --detach
 ```
 
 <Callout type="info" title="Ready in milliseconds">
diff --git a/apps/web/www/content/docs/index.mdx b/apps/web/www/content/docs/index.mdx
@@ -23,7 +23,7 @@ MildStack is a free, open-source alternative to LocalStack for local AWS develop
 
 ```bash
 # 1. Start MildStack
-mildstack serve
+mildstack start
 
 # 2. Create an S3 bucket using the AWS CLI
 aws s3 mb s3://my-bucket \
diff --git a/apps/web/www/content/docs/mildstack/mildstack-cli/index.mdx b/apps/web/www/content/docs/mildstack/mildstack-cli/index.mdx
@@ -11,7 +11,7 @@ The MildStack CLI lets you control your local AWS environment directly from the
 
 | Command | Description |
 | --- | --- |
-| `mildstack serve` | Start a new local instance |
+| `mildstack start` | Start a new local instance |
 | `mildstack instances` | List all known instances |
 | `mildstack status` | Show the status of a running instance |
 | `mildstack stop` | Stop a running instance |
@@ -21,16 +21,16 @@ The MildStack CLI lets you control your local AWS environment directly from the
 
 ```bash
 # Start on the default port (4566)
-mildstack serve
+mildstack start
 
 # Start on a specific port
-mildstack serve 8080
+mildstack start 8080
 
 # Start in the background
-mildstack serve --detach
+mildstack start --detach
 ```
 
-When you run `mildstack serve`, the runtime starts an AWS-compatible API server on the specified port. All three services (S3, DynamoDB, SQS) are available immediately.
+When you run `mildstack start`, the runtime starts an AWS-compatible API server on the specified port. All three services (S3, DynamoDB, SQS) are available immediately.
 
 <Callout type="info">
   If port `4566` is already in use, MildStack will automatically try the next available port.
diff --git a/apps/web/www/content/docs/mildstack/mildstack-cli/instances.mdx b/apps/web/www/content/docs/mildstack/mildstack-cli/instances.mdx
@@ -21,10 +21,10 @@ Start instances on different ports:
 
 ```bash
 # Start a "development" instance
-mildstack serve 4566
+mildstack start 4566
 
 # In another terminal, start a "testing" instance
-mildstack serve 8080
+mildstack start 8080
 ```
 
 Each instance is fully independent. Creating a bucket on port `4566` has no effect on port `8080`.
@@ -68,7 +68,7 @@ mildstack stop 4566
 Stopping preserves all data. Restart on the same port to pick up where you left off:
 
 ```bash
-mildstack serve 4566
+mildstack start 4566
 ```
 
 ### Delete an instance (remove data)
@@ -84,14 +84,14 @@ This permanently removes the instance and all of its stored resources.
 Use `--detach` (or `-d`) to start an instance in the background:
 
 ```bash
-mildstack serve 4566 --detach
+mildstack start 4566 --detach
 ```
 
 The command returns immediately after the instance is ready. This is useful for scripts and CI pipelines:
 
 ```bash
 # Start MildStack in the background, run tests, then stop
-mildstack serve 4566 --detach
+mildstack start 4566 --detach
 npm test
 mildstack stop 4566
 ```
diff --git a/apps/web/www/content/docs/mildstack/mildstack-desktop/index.mdx b/apps/web/www/content/docs/mildstack/mildstack-desktop/index.mdx
@@ -58,7 +58,7 @@ Monitor and manage your local SQS queues:
 
 1. **Start a MildStack instance** using the CLI:
    ```bash
-   mildstack serve
+   mildstack start
    ```
 
 2. **Open the Desktop App** — it will automatically detect running instances on your machine.
diff --git a/apps/web/www/content/docs/mildstack/services/index.mdx b/apps/web/www/content/docs/mildstack/services/index.mdx
@@ -56,7 +56,7 @@ All services start automatically when you launch a MildStack instance. There's n
 
 ```bash
 # Start MildStack — all services are available
-mildstack serve
+mildstack start
 ```
 
 ## Benefits of Local Development
diff --git a/core/cmd/mildstack/main.go b/core/cmd/mildstack/main.go
@@ -22,7 +22,7 @@ func main() {
 	if err != nil {
 		panic(err)
 	}
-	// Manager starts with no services; services are wired per-serve call once
+	// Manager starts with no services; services are wired per-start call once
 	// the port (and therefore the instanceId) is known.
 	manager := runtime.NewWithPorts(nil, activePorts)
 
diff --git a/core/cmd/mildstack/main_test.go b/core/cmd/mildstack/main_test.go
@@ -608,7 +608,7 @@ func TestInstanceRegistrarPersistsAndReleasesActiveInstance(t *testing.T) {
 	registrar := instanceRegistrar{manager: manager, storage: storage}
 
 	if err := registrar.Serve(context.Background(), 9090); err != nil {
-		t.Fatalf("serve: %v", err)
+		t.Fatalf("start: %v", err)
 	}
 
 	ports, err := storage.LoadActivePorts()
@@ -664,7 +664,7 @@ func TestInstanceRegistrarServeSkipsDuplicateLoadedPort(t *testing.T) {
 	registrar := instanceRegistrar{manager: manager, storage: storage}
 
 	if err := registrar.Serve(context.Background(), 9090); err != nil {
-		t.Fatalf("serve: %v", err)
+		t.Fatalf("start: %v", err)
 	}
 
 	ports, err := storage.LoadActivePorts()
diff --git a/core/internal/application/runtime/manager.go b/core/internal/application/runtime/manager.go
@@ -122,7 +122,7 @@ func (m *Manager) SetInstanceID(id string) {
 
 // SetServices replaces the manager's service metadata with metadata derived
 // from the provided services. Called when services are wired after the manager
-// is constructed (e.g., when instanceId is resolved from the serve port).
+// is constructed (e.g., when instanceId is resolved from the start port).
 func (m *Manager) SetServices(services []orchestrator.Service) {
 	metadata := make([]orchestrator.Metadata, 0, len(services))
 	for _, service := range services {
diff --git a/core/internal/application/runtime/manager_test.go b/core/internal/application/runtime/manager_test.go
@@ -55,10 +55,10 @@ func TestManagerCopiesMetadataAndTracksMultiplePorts(t *testing.T) {
 	first.metadata.Tags[0] = "changed"
 
 	if err := manager.Serve(context.Background(), 8080); err != nil {
-		t.Fatalf("serve 8080: %v", err)
+		t.Fatalf("start 8080: %v", err)
 	}
 	if err := manager.Serve(context.Background(), 9090); err != nil {
-		t.Fatalf("serve 9090: %v", err)
+		t.Fatalf("start 9090: %v", err)
 	}
 
 	snapshot := manager.Snapshot(context.Background())
@@ -111,7 +111,7 @@ func TestManagerRejectsDuplicatePorts(t *testing.T) {
 	manager := New(nil)
 
 	if err := manager.Serve(context.Background(), 8080); err != nil {
-		t.Fatalf("serve 8080: %v", err)
+		t.Fatalf("start 8080: %v", err)
 	}
 	if err := manager.Serve(context.Background(), 8080); err == nil {
 		t.Fatal("expected duplicate port error")
@@ -141,7 +141,7 @@ func TestManagerInstanceCarriesInstanceID(t *testing.T) {
 	manager := New(nil)
 	manager.SetInstanceID("test-instance-abc")
 	if err := manager.Serve(context.Background(), 8080); err != nil {
-		t.Fatalf("serve 8080: %v", err)
+		t.Fatalf("start 8080: %v", err)
 	}
 
 	snapshot := manager.Snapshot(context.Background())
diff --git a/core/internal/composition/default_root.go b/core/internal/composition/default_root.go
@@ -31,7 +31,7 @@ func defaultRootWithHook(hook orchestrator.StateHook, config DefaultRootConfig)
 	instanceID := strings.TrimSpace(config.InstanceID)
 	// When no instance ID is provided, return a root with no services.
 	// This allows read-only CLI commands (instances, status, stop, delete)
-	// to run without a MILDSTACK_INSTANCE_ID env var. The serve command
+	// to run without a MILDSTACK_INSTANCE_ID env var. The start command
 	// validates the ID before starting a server.
 	if instanceID == "" {
 		return Assemble(nil)
diff --git a/core/internal/delivery/cli/commands_test.go b/core/internal/delivery/cli/commands_test.go
diff --git a/core/internal/delivery/cli/root_test.go b/core/internal/delivery/cli/root_test.go
diff --git a/core/internal/delivery/cli/serve.go b/core/internal/delivery/cli/serve.go
diff --git a/docs/architecture-core.md b/docs/architecture-core.md
diff --git a/docs/component-inventory-core.md b/docs/component-inventory-core.md
diff --git a/docs/development-guide-core.md b/docs/development-guide-core.md
diff --git a/docs/project-overview.md b/docs/project-overview.md
