-
-
Notifications
You must be signed in to change notification settings - Fork 0
Releases: spcent/plumego
Plumego v1.0.0 — Release Notes
Released: May 15, 2026
Tag: v1.0.0
Tag SHA: 6a99c5e0bc61c12378bcdab5a6a7c4d756b9fa96
Plumego v1.0.0 is the first stable release of a small Go HTTP toolkit built on
the standard library. The stable surface is intentionally narrow: nine root
packages that keep net/http compatibility at their centre, with optional
extension families for product capabilities added on top.
Installation
go get github.com/spcent/plumego@v1.0.0
Requires Go 1.26+. See reference/standard-service
for the canonical application layout.
Stable Roots (GA)
The following nine packages are general availability for v1. Their APIs are
frozen for the entire v1.x series — signatures, package names, and behaviour
will not change without a major version bump:
| Package | Role |
|---|---|
core |
App construction, route registration, middleware attachment, server lifecycle. |
router |
Route matching, path params, groups, metadata, reverse URL generation. |
contract |
Response writers, structured error builders, request metadata, transport binding. |
middleware |
Transport-only middleware composition and first-party packages. |
security |
Auth, JWT, password, security headers, input safety, abuse guards. |
store |
Stable storage contracts and in-memory primitives (cache, KV, file, DB, idempotency). |
health |
Health and readiness models for app and dependency status. |
log |
Minimal logging interfaces and a default logger. |
metrics |
Minimal metrics contracts (counters, gauges, timings, collectors). |
Extension Families
Beta (production-ready with minor caveats)
APIs are stable across the cited release refs. Breaking changes require a
deprecation notice in the same PR:
x/gateway— reverse proxy, load balancing, rewrite rules, edge transportx/observability— Prometheus / OpenTelemetry exporter, tracer, collector wiringx/rest— resource controller and CRUD route conventionsx/websocket— WebSocket hub and explicit route registration
Beta evidence (release refs, API snapshots, owner sign-off) is recorded in
docs/evidence/extension/.
Experimental (APIs may change)
All remaining x/* extensions ship at experimental status. Their APIs may
change in any minor version without notice. Do not treat them as stable in
production services without explicit project-level stabilization:
x/ai, x/data, x/fileapi, x/frontend, x/messaging, x/openapi,
x/resilience, x/rpc, x/tenant, x/validate, and their sub-packages.
CLI Tool
cmd/plumego ships as a command-line tool (scaffolding, validation, codegen,
dev server). It is not a Go import surface. For v1.0.0, use a source
checkout for CLI installation; go install via the module tag resolves the root
but is not advertised due to the nested module structure.
Compatibility Notes
- No breaking changes from the
v1.0.0-rc.1observation window. middleware/httpmetrics.Observeris retained as a compatibility alias for
metrics.HTTPObserver. It is registered inspecs/deprecation-inventory.yaml
and will follow the standard deprecation cycle (not removed within v1).x/*compatibility helpers remain extension-scoped and are not covered by the
stable-root compatibility guarantee.reference/workerfleetis not part of the canonical v1 reference surface.
Quality Gates
All CI quality gates passed for the v1.0.0 tag
(GitHub Actions run 25922384589):
| Gate | Result |
|---|---|
go-quality-gates |
passed — stable-module coverage 87.2% |
go-submodule-quality-gates (cmd/plumego) |
passed |
website-quality-gates |
passed |
v1-release-readiness |
passed |
The internal decision record and full evidence trail are in
docs/release/v1.0.0.md.
Full Stability Policy
See docs/reference/extension-stability-policy.md
for the complete tier definitions, SemVer expectations, and extension promotion
criteria.
What's Next
Post-v1 maintenance and minor improvements are tracked in the v1.1.0 lane.
See docs/release/roadmap.md for the current roadmap.