{ "$comment": [ "Contract-conformance declarations. Every entry here is a declared-unconsumed", "surface: a capability that exists, that no client reaches, and that is", "deliberately left that way. It must match reality exactly -- a missing entry", "is an undeclared finding and an entry that is no longer true is a stale one,", "and both fail a -strict run. See docs/prds/contract-conformance-audit.md.", "", "Managed by tools/contractaudit, an ADVISORY report that task check does not", "run. Reasons state the consequence, not 'TODO': this file is the only place", "the debt is legible." ], "surfaces": { "proto/state/v1/state.proto": { "StateStoreService/ListCaptures": { "reason": "Superseded by StreamCaptures. The remote adapter's ListCaptures method (staterpc/client.go) calls StreamCaptures, not this unary RPC, so no production client reaches it. The server keeps it implemented as a compatibility surface for callers of the raw proto.", "tracker": "archie-core-8cda.4" }, "StateStoreService/ListUndispatchedCaptures": { "reason": "Superseded by StreamUndispatchedCaptures, on the same terms as ListCaptures: the remote adapter's ListUndispatchedCaptures calls the streaming variant, leaving this unary RPC reachable only through the raw proto.", "tracker": "archie-core-8cda.4" } } }, "blindSpots": [ { "surface": "internal/webui", "reason": "Extraction is textual, which is why this report is not gated. A path counts as a consumer only when it is the first argument of a call in code, so a bare constant, a dead array, an object property, or a commented-out call does not count; the calling function need not be named, so a rename is survivable. Limits: a path passed as any argument other than the first is not seen (accepting a comma would start crediting array elements); a request inside a template-literal interpolation is not seen; a path built from a bare /api fragment is reported as unparsable rather than silently contributing nothing; and a route is credited to every HTTP verb, so a route whose specific verb has no caller reads as consumed. Routes whose consumer is outside the dashboard (the asset mount, the health probes, the capture-intake webhook) are excluded from this surface by design: they have different consumers and are not part of the dashboard API contract." }, { "surface": "proto/state/v1/state.proto", "reason": "Consumption is derived by scanning adapter bodies for calls through the generated client, so an RPC reached only through runtime-loaded code (Yaegi) or reflection would read as unconsumed. The scan also keys on the generated client field being named 'client'; renaming that field would report every RPC as unconsumed. No such path exists today." }, { "surface": "proto/gateway/v1/chat.proto", "reason": "As above. Note that gatewayrpc is served by archie-gateway and consumed by archied and archie-ui; a consumer living outside this repository would be invisible here." } ] }