1.0.0 - 2026-08-25
Fixed
- Bind the reviewed zero-mutant embedded UI handler to its exact standalone
source identity.
Changed
-
Exclude intentional nested modules from root local-proxy archives so local,
bootstrap, CI, and public module checksums describe the same source
boundary. -
Track the pinned documentation-tool lockfile so clean CI checkouts install
the exact validated cspell dependency. -
Reconcile standalone dependency checksums against deterministic current
module archives so CI, local verification, and release consumers resolve
identical content. -
Harden standalone documentation validation with deterministic spelling and
link checks, package-specific documentation gates, and repository-local
contributor guidance.
Documentation
- Correct stale package, standalone, and authoritative-source links in public
documentation.
Fixed
- Enforce exact fleet capacity, runtime accumulation, rejection aggregation,
deterministic ordering, and telemetry saturation boundaries under mutation
verification. - Validate structured data-plane results through an explicit terminal-outcome
whitelist, preserving fail-closed cancellation and lifecycle-state handling
without redundant status conditions. - Strengthen command-orchestration verification around desired-state target
alternatives, caller-supplied metadata, and every nonterminal dispatch
outcome.
Documentation
-
Replace obsolete standalone-repository links and workflow claims with
monorepo-canonical targets and current release guidance. -
Link the package README to the repository-wide Golib documentation portal.
-
Replace the invalid GitHub package URL with a portable repository-relative
link toqueue.
Compatibility
- Added a pinned module export baseline so incompatible public API changes
fail the canonical repository gate.
Changed
-
Publish the module from its standalone
github.com/faustbrian/go-queue-control-planeidentity while preserving its documented API and behavior. -
Require each CLI connection credential independently, with mutation-precise
regression coverage for every missing environment value. -
Replace obsolete owned-module pseudo-version pins with the monorepo's local
v0.0.0source-proxy coordinates; release tooling continues to emit exact
v1.0.0dependency versions. -
New durable command identifiers are lowercase ULIDs. The PostgreSQL upgrade
preserves historical UUID command identifiers while changing command and
reference columns to text so existing audit history remains addressable. -
Require owned sibling modules at local
v0.0.0; clean external consumers
pin each module to an exact main pseudo-version. -
Upgraded the resolved gRPC dependency to 1.82.1 and refreshed owned-module
checksums after the shared telemetry dependency update. -
Align indirect dependency metadata with the resolved graph so clean
consumers and CI obtain reproducible module metadata. -
Refresh owned-module checksums against the final consolidated archives.
-
Made the documented idempotency example unambiguously synthetic so strict
secret scanning does not mistake it for a credential. -
Normalized standalone module metadata against the canonical owned dependency
graph, including complete checksums for clean consumer resolution. -
Refreshed the canonical authentication checksum after its test archive
changed, preserving isolated module verification. -
Refreshed owned authentication, authorization, and PostgreSQL checksums after
their API compatibility baselines were normalized to module boundaries. -
Pinned the completed
queuedead-letter v1 contracts, stable operational
failure codes, retention negotiation, and bounded Redis/Valkey redrive
lineage used by rolling worker fleets. -
Strengthened the deterministic local and hosted quality gate with module
checksum verification, Staticcheck, strict golangci-lint, advisory NilAway,
and exact per-package statement coverage. -
Added a global CLI
--output humanmode while retaining compact JSON as the
stable default and keeping terminal control characters escaped.
Added
- Fixed-label bounded alert telemetry export for up to 12,000 validated alerts
without tenant, resource, or error-derived metric labels. - Attachment disposition on privileged payload and diagnostics responses.
- Real Redis and Valkey concurrent retry/delete evidence proving exactly one
truthful winner for a contested failed record. - PostgreSQL child-process death evidence during authorization and live
dispatcher execution, preserving zero or durably auditable state. - Allocation-budgeted maximum-payload, 10,000-worker reconnect-storm, and
backend-outage dispatch benchmarks in the local and hosted smoke gate. - Distinct durable
unsupported,timed_out, andpartialcommand outcomes
soqueueacknowledgements cannot be flattened into a clean failure. - Restart-safe
pending,dispatched, andacknowledgedcommand boundaries,
transition timestamps, pre-dispatch cancellation, and fault-injected
PostgreSQL recovery evidence. - Durable bounded command deadlines, authentication methods, required
capabilities, and worker/protocol acknowledgement snapshots. - Durable opaque command identifiers distinct from caller-owned idempotency keys,
including migration backfill and end-to-end result propagation. - Separate record-list, record-inspection, payload-view, and audit-view
permissions with exact tenant and object scope. - Truthful CLI retention status derived from negotiated worker capabilities,
with unknown numeric limits represented explicitly. - Independently authorized diagnostics visibility with fail-closed masking
across the HTTP API, typed client, and CLI. - Fail-closed chained audit persistence before every privileged payload or
diagnostics backend read. - Public administrative command, result, permission, and validation contracts.
- Durable PostgreSQL command, desired-state, and tamper-evident audit storage.
- Bounded worker fleet and rolling-protocol compatibility models.
- Authenticated and authorized HTTP API with health, readiness, version,
capability, command, audit, worker, and Kubernetes workload surfaces. - Typed Go client and administrative CLI.
- Narrow namespace-scoped Kubernetes Deployment visibility and scaling.
- Hardened server and CLI container targets for amd64 and arm64.
- Deterministic Go quality, race, coverage, fuzz-smoke, and container CI gates.
- Real PostgreSQL 16, 17, and 18 migration, persistence, idempotency, tenant
isolation, audit verification, and retention integration gates. - Reproducible 10,000-worker and 100,000-audit-event load benchmarks with a
documented development baseline and CI smoke execution. - Maximum 1,000-worker authenticated HTTP response benchmark with every worker
advertising the bounded 256-queue limit. - Maximum-page queue and failure/dead-letter conversion benchmarks in the
hosted load smoke gate. - Pinned
govulnchecksource scanning against the canonical Go vulnerability
database in local and hosted quality workflows. - BuildKit SBOM and maximal provenance attestations on the multi-platform OCI
artifact produced by CI. - Semver-tagged GHCR publication and keyless Sigstore signing for both server
and CLI images, with immediate workflow-identity verification. - Targeted goroutine-leak assertions for graceful and forced HTTP server
shutdown paths. - Pinned mutation testing with 100% coverage and efficacy across all current
public command, authorization, desired-state, dispatch, and orchestration
mutants. - Migration-only server mode for one-shot production schema Jobs that exit
before loading serving dependencies. - Isolated PostgreSQL 18 disaster-recovery gate using native dump and restore
with repository-level verification of the recovered state. - Pinned semantic API-diff gate against a reviewed full-module export baseline
in both CI and release quality. - Reproducible standalone archives for six operating-system and architecture
targets with signed checksums and GitHub Release publication. - Optional secure OTLP runtime wiring for HTTP and bounded control-command
telemetry with explicit lifecycle ownership and trusted-context policy. - One-shot production audit retention with strict per-tenant policies, legal
holds, pre/post verification, bounded batches, and real PostgreSQL coverage. - Real Chromium security coverage for exact-origin CORS, automatic preflight,
cookie-backed CSRF, credential admission, and defensive response headers. - Real Chromium command-envelope coverage for every public mutation and each
action-specific selection, replay, and scale field. - Mutation scope excludes installed browser dependencies and test-server code,
keeping release efficacy measurements limited to owned production decisions. - Server and CLI container builds now include the imported data-plane adapter
and embedded UI packages in their restricted build context. - Newest-first tenant command history with bounded opaque-cursor pagination
across PostgreSQL, the authenticated API, typed client, and CLI. - Safe bounded terminal-command retention after verified audit cleanup, while
preserving active commands and current desired-state references. - Tenant-scoped
queuemanagement adaptation for every control action,
bounded bulk retry, protocol deadlines, and structured terminal outcomes. - Authenticated failure and dead-letter list and inspect APIs, typed client,
and CLI with bounded search/sort pagination and privileged payload viewing. - Authenticated bounded queue-status API, typed client, CLI, and application
capability wiring with explicit unsupported-measurement representation. - Optional production worker and queue-status composition through a strict
tenant-to-HTTPS management document and separate bounded per-tenant
bearer-token files. - Optional production tenant command dispatch through the same authenticated
queuemanagement endpoints, with protocol-v1 translation, a bounded
acknowledgement deadline, and structured terminal outcomes. - Optional production failure and dead-letter reads through the same tenant
management client, with validated hidden lists and least-privilege payload
inspection. - Pinned native Valkey failed-attempt and dead-letter reads through the
authenticated management transport, including hidden lists and explicitly
authorized payload inspection. - Pinned native Valkey retry, bounded bulk retry, delete, and record-purge
enforcement with atomic active-failure redrive and structured ambiguity
outcomes. - Pinned native Valkey allowlisted replay with durable reject-or-replace
duplicate handling, plus source and destination authorization before command
acceptance. - Pinned native Redis Streams failure and dead-letter reads plus retry,
bounded bulk retry, allowlisted replay, delete, and record-purge dispatch
through authenticatedqueuecontracts without native client access. - Authenticated
queueHTTP integration coverage for managed pause, resume,
status, and duplicate command enforcement, plus older, current, newer,
partitioned, and reconnecting protocol observations. - Pinned Redis 6.2.22 and Valkey 9.1.0 CI services proving real backend status,
pause, and resume throughqueueand authenticated management HTTP. - The real Valkey gate creates a failed delivery, dispatches replay, rejects a
duplicate, preserves the source, and consumes the destination through a
second publicqueueworker. - Published
queueRedis Streams and Valkey Streams status providers, with
honest backend-version capability reporting, are pinned for the production
worker and queue-status transport. - Pinned
queueretention capability negotiation, including exact-count
reporting through Redis Streams and rolling-version HTTP integration. - Authenticated tenant desired-state reads, a typed tenant-bound
queue
reader, and native queue-owned pause, resume, drain, and terminate
convergence through the pinned data-plane lifecycle. - Bounded alert-input evaluation for queue wait, failures, stale workers, dead
letters, and failed or unknown control commands. - Optional embedded same-origin operator console for current worker, queue,
failure, dead-letter, audit, command-history, and audited mutation workflows,
with ephemeral credentials and Chromium end-to-end coverage. - Architecture, API, CLI, deployment, security, operations, compatibility,
Horizon migration, troubleshooting, contribution, and release documentation. - Protocol/failure, crash-boundary, administrative threat, scale, Horizon
ownership, and release-gate hardening matrices with executable evidence.
Fixed
- Return an authentication-scheme challenge with rejected administrative
credentials so invalid API keys remain a401response instead of being
misclassified as authentication infrastructure unavailability.
Security
- Blocked HTTP redirects in the typed administrative client so bearer tokens
and custom API-key headers cannot be forwarded to another origin. - Added exhaustive deployed permission scope, ambiguous request-framing,
hostile-value XSS, and keyboard accessibility regression coverage. - Added failure injection for duplicate sensitive mutations, control endpoint
loss during ordinary delivery, telemetry shutdown, PostgreSQL saturation,
and 10,000-worker stale/reconnect storms. - Added real PostgreSQL process-death injection across command, desired-state,
admission-audit, dispatch, acknowledgement, result, and completion-audit
writes to prove atomic rollback and honest recovery state. - Added exact-origin CORS, strict preflight, CSRF checks, defensive response
headers, request bounds, process-local rate limiting, and secret-safe errors. - Aligned the shipped CLI with the server's static API-key authentication and
allowed those headers through approved browser preflights. - Moved rate-limit admission behind authentication so valid administrative
requests are isolated by stable subject instead of shared source address. - Canonicalized persisted timestamps to UTC so idempotent responses and audit
hashes do not depend on database session or caller timezone offsets.
Known gaps
- Native queue purge remains unavailable because
queueintentionally
exposes only failure/dead-letter record purge for these stream backends. - Production alert collection/export, desired-state cleanup, historical UI
charts, retention reconfiguration, and deployment-specific ingress and
PostgreSQL capacity tests remain intentionally external or incomplete.
Release integrity
- Source commit:
aeb31eca0a4c85f1c4de6b28ca7f2ffed0c8f271 - Exact-head CI: https://github.com/faustbrian/go-queue-control-plane/actions/runs/32923263038
- Release dry-run: urn:sha256:09c20e30fa6e0af52dace431c1b65ce2d1bc6921d5764b45277b87306f9441f0
- Assets include a CycloneDX SBOM, SLSA v1 in-toto provenance, and SSH-signed checksums.
Verify the checksum attestation with:
ssh-keygen -Y verify -f ALLOWED_SIGNERS -I brian@cline.sh -n golib-release -s SHA256SUMS.sig < SHA256SUMS