Repository navigation
Hardening for public integration: per-project ports, compression, OpenAPI, alerts - #12
Merged
Merged
Conversation
…nAPI, alerts - Projects run side by side: every development port lives in infra/dev-ports.env, the generator gives each project its own block, ./dev checks ports before starting and names the holder, readiness checks the process it started, smoke/systemd tests use project-scoped names, and the dev session cookie is per project. - Compression: build-time brotli/gzip for static files (source maps moved out of dist/), on-the-fly compression for API responses from 1 KiB, never for no-store responses or event streams. API responses default to Cache-Control: private, no-cache. ADR 0012. - OpenAPI 3.1 for the integration surface (API keys, service accounts), derived from the response types and tested against live responses; served at /api/v1/openapi.json. - Alert rules with runbooks and promtool unit tests, loaded by the observability stack. - Integration examples (curl, Python, Node.js) run by the system smoke. - GCRA property tests compute slots from the limiter's clock reading (was flaky under load). - ./dev benchmark forwards run.py options; compression is an on-demand benchmark suite. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Owner
Author
|
Validation of
Each generated project ran on its own port block, while another local stack held the blueprint's default ports. In every profile's live smoke, all three API client examples completed runs with a scoped key, the OpenAPI document was served (10 operations), and the revoked key got 401. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Public-release hardening pass (tasks T-0027 to T-0033). Each item is classified with its evidence in
docs/BLUEPRINT_CAPABILITY_MATRIX.md(section Frequently requested).infra/dev-ports.env, generator port blocks,./dev ports, preflight that names port holders, readiness tied to the spawned process, project-scoped smoke/systemd names, per-project session cookie)./dev upfailed with Docker'sport is already allocatedand left a container without ports. After: two generated projects passed./dev test --systemconcurrently while a third stack held the blueprint's default ports.no-store, SSE or already-encoded responses)private, no-cacheAPI default; static caching already existed/api/v1/openapi.json,docs/api/openapi.json)tests/openapi.rs: routes ⇄ spec drift, 401 per operation, live responses conform field for field (mutation-checked)observability)promtool test rulesininfra-verify; threshold and traffic-floor mutations caught./dev test --systemwith a scoped key, revoked afterwardsAlso:
./dev benchmarknow forwards options tobenchmarks/run.py.Validation on
a50fc05: blueprint./dev check29/29 (296 Rust tests), release audit OK.validate-generatedon the three reference profiles is in progress; results follow in a comment.Versioning: this is a MINOR change by
docs/VERSIONING.md(a new generator flag, an additive API and a new config key), so v1.1.0, not v1.0.3. No tag yet.🤖 Generated with Claude Code