Skip to content

Commit bdba2da

Browse files
committed
docs: finalize CHANGELOG for v0.1.0 release
Move accumulated Unreleased notes into the [0.1.0] section with the release date (2026-04-18) and reset [Unreleased] to empty. The v0.1.0 section captures the full surface of the initial public release: core runtime, 96 AWS services scaffolded, 671/699 boto3 compatibility, web dashboard, Docker packaging, open-source scaffolding, and the MECE-organized documentation suite.
1 parent 5416acf commit bdba2da

1 file changed

Lines changed: 62 additions & 9 deletions

File tree

CHANGELOG.md

Lines changed: 62 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -6,17 +6,70 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
66

77
## [Unreleased]
88

9+
_Nothing yet._
10+
11+
## [0.1.0] - 2026-04-18
12+
13+
First public release of DevCloud — a local development companion for cloud-native apps. Positioned as an on-ramp to the cloud, not a replacement: iterate locally without cloud bills, then land cleanly on your target CSP.
14+
915
### Added
10-
- `LICENSE` file at repository root (MIT)
11-
- `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md`, `SECURITY.md` community health files
12-
- `CHANGELOG.md` for release tracking
13-
- `.github/FUNDING.yml` placeholder
14-
- GitHub Actions: `lint.yml` (golangci-lint), `stale.yml`, `release-drafter.yml`, `codeql.yml`, `labeler.yml`
15-
- `.github/release-drafter.yml` and `.github/labeler.yml` configuration
1616

17-
## [0.1.0] - TBD
17+
**Core runtime**
18+
- Single-binary HTTP gateway on port **4747** with multi-protocol support (REST-XML, JSON 1.0, JSON 1.1, REST-JSON, Query) and middleware chain (error recovery, body limit, CORS, request ID, structured logging).
19+
- Plugin registry with deterministic service initialization order and graceful shutdown.
20+
- Zero-config startup: server runs with embedded default configuration if `devcloud.yaml` is absent.
21+
- Config loader with `Load()` (strict) and `LoadOrDefault()` (graceful fallback to embedded).
22+
- Environment-variable overrides: `DEVCLOUD_SERVICES` (with `tier1` / `tier2` / `tier3` / `all` shortcuts) and `DEVCLOUD_DATA_DIR`.
23+
24+
**AWS service coverage**
25+
- 96 AWS services scaffolded from official Smithy models via an in-tree code generator.
26+
- Big 6 fully implemented: **S3, SQS, DynamoDB, Lambda, IAM, STS**.
27+
- Integration services: SNS, CloudWatch, CloudWatch Logs, KMS, SecretsManager, SSM, EventBridge, ECR, EC2, ECS, Route53, ACM, CloudFormation, and more.
28+
- Cross-service integrations: CloudFormation provisioning, DynamoDB Streams → Lambda, SQS → Lambda, S3 → Lambda, EventBridge → SQS/SNS/Lambda, SNS → SQS subscriptions.
29+
- **96% boto3 compatibility** (671/699 tests passing against the official AWS SDK test surface).
30+
- Port-aware URL construction in SQS, ECR, and CloudFormation response paths (opts-based, not hardcoded).
31+
32+
**Code generation pipeline**
33+
- Smithy JSON model parser and template-driven Go generator.
34+
- Weekly auto-sync workflow keeps models current with AWS upstream.
35+
- Generated files (`internal/generated/**`) include SPDX license headers and are marked `DO NOT EDIT`.
36+
37+
**Web dashboard** (optional, gated on `dashboard.enabled`)
38+
- Next.js 15 / React 19 / Tailwind UI served statically by the Go server.
39+
- Service status, resource browser, WebSocket-based live API log stream.
40+
41+
**Docker packaging**
42+
- Multi-stage production Dockerfile (Alpine runtime).
43+
- Dockerfile.dev for hot-reload frontend development.
44+
- `docker-compose.yml` wiring backend (port 4747) and Next.js dev server (port 3000).
45+
46+
**Open-source scaffolding**
47+
- Apache License 2.0 with `NOTICE` attribution file.
48+
- Community health files: `CODE_OF_CONDUCT.md` (Contributor Covenant v2.1), `CONTRIBUTING.md`, `GOVERNANCE.md`, `SECURITY.md`, `SUPPORT.md`, `TRADEMARKS.md`.
49+
- GitHub Actions workflows: CI (Go tests, multi-arch amd64 + arm64), CD (Docker build + push to ghcr.io), boto3 compatibility tests, weekly Smithy model sync, golangci-lint, CodeQL, stale bot, release-drafter, PR labeler.
50+
- Issue templates (bug, feature, question), PR template with SPDX and CHANGELOG gates, CODEOWNERS, Dependabot (weekly gomod / npm / github-actions), FUNDING.
51+
- SPDX-License-Identifier headers on all Go sources, enforced by `scripts/add-spdx-header.sh` via pre-commit hook; codegen templates emit the header automatically.
52+
53+
**Documentation**
54+
- `README.md` with on-ramp positioning and Quick Start.
55+
- `docs/` suite: getting-started, configuration, architecture (with multi-CSP vision), roadmap, services-matrix, contributing, FAQ, troubleshooting, per-service references.
56+
- MECE-organized documentation so each topic has a single canonical location.
57+
58+
**Testing**
59+
- Go unit tests for every service package (108 packages, all green).
60+
- Table-driven port-propagation regression tests in SQS, ECR, CloudFormation.
61+
- Python/boto3 compatibility suite under `tests/compatibility/`.
62+
63+
### Known Issues
64+
65+
- `auth.enabled: true` is accepted but SigV4 enforcement is not yet implemented; the server emits a warning at startup to make this visible.
66+
- Lambda function invocation is a stub (accepts registration but does not execute handler code).
67+
- Windows is not in the CI matrix; WSL2 is expected to work.
68+
69+
### Not in Scope for v0.1.0
1870

19-
Initial public release. See [README.md](README.md) for feature summary.
71+
- Multi-CSP support (Azure, GCP) — planned for v2.x; see [docs/roadmap.md](docs/roadmap.md).
72+
- Production deployment scenarios — DevCloud is a local development tool.
2073

21-
[Unreleased]: https://github.com/skyoo2003/devcloud/compare/main...HEAD
74+
[Unreleased]: https://github.com/skyoo2003/devcloud/compare/v0.1.0...HEAD
2275
[0.1.0]: https://github.com/skyoo2003/devcloud/releases/tag/v0.1.0

0 commit comments

Comments
 (0)