docs: sync documentation with actual codebase state

- Update service count (96→101) and operation count (4,438→4,451)
  verified against default.yaml and provider.go sources
- Fix Next.js version reference (15→16) to match web/package.json
- Document DEVCLOUD_PORT environment variable (implemented but
  previously undocumented in config.go)
- Add environment variable overview table to configuration.md
- Update architecture.md directory structure to reflect actual
  service counts instead of partial enumeration
- Fix pinpoint operation count (91→93)

Author: skyoo2003

CHANGELOG.md

@@ -50,7 +50,7 @@ First public release of DevCloud — a local development companion for cloud-nat
 - Generated files (`internal/generated/**`) include SPDX license headers and are marked `DO NOT EDIT`.
 
 **Web dashboard** (optional, gated on `dashboard.enabled`)
-- Next.js 15 / React 19 / Tailwind UI served statically by the Go server.
+- Next.js 16 / React 19 / Tailwind UI served statically by the Go server.
 - Service status, resource browser, WebSocket-based live API log stream.
 
 **Docker packaging**

README.md

@@ -23,12 +23,13 @@ Today DevCloud targets **AWS**. Our long-term goal is to support the full range
 
 ## Features
 
-- **96 AWS services scaffolded** — 4,438 operations across all major categories (see [services-matrix.md](docs/services-matrix.md))
+- **101 AWS services scaffolded** — 4,451 operations across all major categories (see [services-matrix.md](docs/services-matrix.md))
 - **96% boto3 compatibility** — 671/699 SDK tests pass; works with most boto3 apps
 - **Cross-service integration** — CFN provisioning, DDB Streams → Lambda, EventBridge targets, S3 → Lambda
 - **Smithy-driven codegen** — auto-generate Go interfaces, types, and serializers from Smithy models
 - **Weekly auto-sync** — GitHub Actions keeps generated code up to date with upstream AWS API changes
 - **Single binary, zero-config** — one Docker image, one port (4747), no config file required (embedded defaults)
+- **Environment variable overrides** — `DEVCLOUD_SERVICES`, `DEVCLOUD_DATA_DIR`, `DEVCLOUD_PORT` for quick configuration without YAML
 - **SDK/CLI compatible** — works with the AWS SDK, CLI, Terraform, CDK out of the box
 - **Web dashboard** — real-time monitoring and resource browser
 

changes/v0.1.0.md

@@ -29,7 +29,7 @@ First public release of DevCloud — a local development companion for cloud-nat
 
 **Web dashboard** (optional, gated on `dashboard.enabled`)
 
-- Next.js 15 / React 19 / Tailwind UI served statically by the Go server.
+- Next.js 16 / React 19 / Tailwind UI served statically by the Go server.
 - Service status, resource browser, WebSocket-based live API log stream.
 
 **Docker packaging**

docs/architecture.md

@@ -158,19 +158,8 @@ devcloud/
 │   ├── plugin/             # ServicePlugin interface, Registry
 │   ├── codegen/            # Smithy parser, code generators, templates
 │   ├── config/             # YAML config loading, env overrides
-│   ├── generated/          # Auto-generated code (DO NOT EDIT)
-│   │   ├── s3/
-│   │   ├── sqs/
-│   │   ├── dynamodb/
-│   │   ├── lambda/
-│   │   ├── iam/
-│   │   └── sts/
-│   ├── services/           # Service implementations
-│   │   ├── s3/             # FileSystem + SQLite
-│   │   ├── sqs/            # In-memory queues
-│   │   ├── dynamodb/       # BadgerDB
-│   │   ├── lambda/         # SQLite + filesystem (stub runtime)
-│   │   └── iam/            # SQLite (IAM + STS)
+│   ├── generated/          # Auto-generated code (DO NOT EDIT, 93 services)
+│   ├── services/           # Service implementations (101 services)
 │   ├── dashboard/          # Dashboard REST API + WebSocket
 │   ├── eventbus/           # In-memory event pub/sub
 │   └── storage/            # Shared storage abstractions
@@ -186,11 +175,11 @@ devcloud/
 
 ## Startup Flow
 
-1. Load config from `devcloud.yaml` (or specified path)
+1. Load config from `devcloud.yaml` (or specified path), applying environment variable overrides (`DEVCLOUD_PORT`, `DEVCLOUD_SERVICES`, `DEVCLOUD_DATA_DIR`)
 2. Initialize structured logger (slog)
 3. Create plugin registry
-4. Register service factories (S3, SQS, DynamoDB, IAM, Lambda)
-5. Initialize services in order: S3 → SQS → DynamoDB → IAM → STS → Lambda
+4. Register service factories (101 services)
+5. Initialize services in dependency order (IAM before STS, etc.)
 6. IAM store is shared with STS via plugin config options
 7. Set up event bus, log collector, dashboard API
 8. Create gateway with middleware chain and service router

docs/configuration.md

@@ -8,7 +8,13 @@ To override defaults, provide a YAML file. DevCloud looks for config in this ord
 2. `./devcloud.yaml` in the current working directory (auto-detected)
 3. Embedded defaults (used when neither of the above is present)
 
-Environment variables override YAML values for selected keys (see [Environment Variable Overrides](#environment-variable-overrides)).
+Environment variables override YAML values for selected keys (see [Environment Variable Overrides](#environment-variable-overrides)):
+
+| Variable | Overrides | Description |
+|----------|-----------|-------------|
+| `DEVCLOUD_PORT` | `server.port` | HTTP server port |
+| `DEVCLOUD_SERVICES` | `services.*.enabled` | Comma-separated list of services to enable |
+| `DEVCLOUD_DATA_DIR` | `services.*.data_dir` | Base data directory for all services |
 
 ## Configuration File
 
@@ -92,6 +98,18 @@ logging:
 
 ## Environment Variable Overrides
 
+### `DEVCLOUD_PORT`
+
+Overrides the HTTP server port. Takes precedence over both the YAML `server.port` value and the embedded default.
+
+```bash
+# Run on port 8080 instead of 4747
+DEVCLOUD_PORT=8080 ./dist/devcloud
+
+# With Docker (map the host port accordingly)
+docker run -p 8080:8080 -e DEVCLOUD_PORT=8080 ghcr.io/skyoo2003/devcloud:latest
+```
+
 ### `DEVCLOUD_SERVICES`
 
 Comma-separated list of services to enable. All other services listed in the config file are disabled. Accepts individual service names and tier shortcuts.

docs/roadmap.md

@@ -19,7 +19,7 @@ We pursue this vision through a **phased rollout** to manage scope, architectura
 **Goal**: prove the core thesis on AWS before expanding surface area.
 
 - [x] Core AWS services: S3, SQS, DynamoDB, Lambda, IAM, STS
-- [x] Smithy-based codegen pipeline (96 services, 4,438 operations scaffolded)
+- [x] Smithy-based codegen pipeline (101 services, 4,451 operations scaffolded)
 - [x] Cross-service integration (CFN, DDB Streams → Lambda, EventBridge, S3 → Lambda)
 - [x] boto3 compatibility suite (currently 671/699 passing)
 - [ ] Lift boto3 compatibility to ≥ 95%

docs/services-matrix.md

@@ -1,6 +1,6 @@
 # DevCloud Services Matrix
 
-**Total**: 96 services, 4,438 operations, 96% boto3 compatibility
+**Total**: 101 services, 4,451 operations, 96% boto3 compatibility
 
 _Last updated with each release. For unreleased changes, see [CHANGELOG.md](../CHANGELOG.md)._
 
@@ -21,7 +21,7 @@ DevCloud is a Go-based local cloud environment with AWS API compatibility. This
 |---|---------|-----|----------|
 | 1 | sesv2 | 155 | Business Apps |
 | 2 | appconfig | 97 | Management |
-| 3 | pinpoint | 91 | Business Apps |
+| 3 | pinpoint | 93 | Business Apps |
 | 4 | opensearch | 87 | Analytics |
 | 5 | iot | 82 | IoT |
 | 6 | backup | 82 | Storage |
@@ -97,6 +97,9 @@ for svc in $(ls internal/services/); do
   count=$(grep -c 'case "' internal/services/$svc/provider.go 2>/dev/null || echo 0)
   [ "$count" -gt "0" ] && echo "$count $svc"
 done | sort -rn
+
+# Count total scaffolded services
+awk '/^services:/,/^auth:/' internal/config/default.yaml | grep -cE '^\s+[a-z][a-z0-9_]*:$'
 ```
 
 See [Getting Started](getting-started.md) for installation and [contributing.md](contributing.md) for development setup.