Skip to content

feat: request ID response header from BootUI 2.5.0 - #269

Merged
ffroliva merged 10 commits into
release/0.8.0from
feat/0.8.0-a8
Nov 22, 2026
Merged

ffroliva merged 10 commits into
release/0.8.0from
feat/0.8.0-a8

Conversation

@ffroliva

@ffroliva ffroliva commented Nov 21, 2026 •

Copy link
Copy Markdown
Owner

Summary

Ports BootUI 2.5.0's request ID response header (BootUI #1675). Lane A8 of the 0.8.0 plan.

  • X-Sharpit-Request-Id on HTTP responses, on by default as in BootUI, behind BootUI's gates: the
    SHARPIT_HTTP_EXCHANGES_EXPOSE_REQUEST_ID_HEADER property (opt-out), the HTTP Exchanges panel, and the guard's own
    trusted-source decision (guard.is_trusted_source), so the header never trusts more than the guard does.
  • Never on sharpit's own routes, never when sharpit is inactive or capture is detached, never echoing an inbound id; an
    application-set header always wins, including duplicates, and is never overwritten or added to.
  • WebSocket and lifespan scopes pass through untouched; streaming, redirects, mounted sub-applications and error
    responses are covered.
  • The per-request path decides once per application what can be decided once and skips the trust evaluation when the
    header will not be emitted.
  • Deviation rows: docs/reference/matrix-updates/0.8.0-a8.tsv (the header name).

Tests

Behaviour Test Red on the base
The header follows the guard's trusted-source decision tests/fastapi/test_request_id_header.py assertion-level reds on release/0.8.0
Gates, ownership, duplicates, WebSocket and lifespan pass-through tests/fastapi/test_request_id_header.py assertion-level reds on release/0.8.0
The HTTP probe passes the header through tests/fastapi/test_http_probe_api.py request id absent

Capture overhead budget (tests/fastapi/test_capture_overhead.py, alone, -n 0), ten alternating paired runs, all
under 0.200 ms: base 0.077–0.160 ms, branch 0.097–0.162 ms.

567 tests in the parity, request-ID, probe and import-boundary suites pass; ruff and pyright pass.

Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
The capture-overhead test ran ten alternating base/branch pairs at -n 0. Primary capture overhead values (ms):
Base:   0.104, 0.078, 0.093, 0.093, 0.078, 0.077, 0.160, 0.089, 0.090, 0.080
Branch: 0.101, 0.113, 0.114, 0.103, 0.098, 0.162, 0.101, 0.097, 0.104, 0.107
All 20 primary runs passed the 0.200 ms budget. The suspended-path budget also passed in all 20 runs.

Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
The request ID header lane changed skills/sharpit/SKILL.md; the plugin ships a byte-identical copy, pinned by tests/test_agent_plugin.py.

Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
…ader

Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
@ffroliva
ffroliva marked this pull request as ready for review November 22, 2026 00:40
@ffroliva
ffroliva merged commit eff8688 into release/0.8.0 Nov 22, 2026
47 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant