beads/internal/httpapi
CI Bot b9224acc9b docs(httpapi): close the re-spell and value-narrowing gaps in the Profiles relation
Two compositions of the four conformance rules were reachable and neither
was answered by the text.

First: rule 1 scopes non-conformance to a re-spelling published under a CORE
name, rule 2 permits omitting optional properties, and rule 4 permits declared
extensions whose names this document does not define. Composed, a profile may
omit an optional core member and republish its value under an extension name
— the re-spelling rule 1 exists to forbid, arriving by a legal path. A fifth
rule closes that flank: an omission is not a licence to re-spell.

Second: rule 2 enumerates bounds tightenings and excludes re-typing a member,
but its proviso tests INSTANCES, so narrowing a value schema (say, core
`metadata` from any JSON value to a bounded string) read as both forbidden
schema-level re-typing and permitted instance-level validity. It is neither:
it is a third category, a DEVIATION the profile declares with the same
machinery rule 3 requires for embedded-relation omissions, conformant only if
values failing the narrower schema are omitted entirely rather than coerced,
and only if the declaration says the member may be incomplete.

`Issue.metadata`'s warning against decoding into a string-to-string map is
scoped to clients of THIS document so it no longer reads as contradicting a
profile's declared narrowing; the core warning itself is unchanged.

Description-only: regenerating internal/httpapi/apigen/types.gen.go leaves it
byte-identical (dd0f41b2a8 before and after).
2026-08-01 16:26:39 +00:00
..
apigen feat(httpapi): require Problem.request_id and declare RFC 9457 type 2026-08-01 15:38:01 +00:00
spec docs(httpapi): close the re-spell and value-narrowing gaps in the Profiles relation 2026-08-01 16:26:39 +00:00
claim.go docs: state exactly what the reader role now enforces, and what it does not 2026-07-31 22:56:06 +00:00
claim_test.go docs(ci): stop calling a PR job required, because none of them is 2026-07-31 23:32:28 +00:00
context_test.go feat(serve): bd serve skeleton — lifecycle, mode gate, /healthz, /v0/beads/context (bd-60z) 2026-07-31 10:07:14 +00:00
cursor.go feat(issueops): add the Reader role and wire both front doors through it 2026-07-31 18:37:25 +00:00
doc.go docs: one claim paragraph, defensible sentence by sentence 2026-07-31 23:47:32 +00:00
handlers.go refactor(context): one snapshot-to-fields projection for both context surfaces 2026-07-31 22:35:09 +00:00
pinning.go feat(httpapi): OpenAPI v0 spec, types-only codegen, and the drift gates (bd-ilb) 2026-07-31 08:37:34 +00:00
problem.go feat(httpapi): require Problem.request_id and declare RFC 9457 type 2026-08-01 15:38:01 +00:00
problem_test.go feat(httpapi): OpenAPI v0 spec, types-only codegen, and the drift gates (bd-ilb) 2026-07-31 08:37:34 +00:00
query.go feat(issueops): add the Reader role and wire both front doors through it 2026-07-31 18:37:25 +00:00
reads.go docs(workapi): say where the shared epilogue stops, and what limit 0 does 2026-07-31 23:35:16 +00:00
reads_test.go test(httpapi): pin that a read route times the units of work its reader opens 2026-07-31 20:04:23 +00:00
routes.go feat(issueops): add the Reader role and wire both front doors through it 2026-07-31 18:37:25 +00:00
server.go build(lint): make "no handler builds a filter" a lint failure, not a grep 2026-07-31 18:37:26 +00:00
server_test.go docs(ci): stop calling a PR job required, because none of them is 2026-07-31 23:32:28 +00:00
spec_parity_test.go docs(ci): stop calling a PR job required, because none of them is 2026-07-31 23:32:28 +00:00
wire_bijection_test.go test(httpapi): guard every pinned schema, and untagged fields, in the bijection test (bd-ilb) 2026-07-31 08:56:58 +00:00