Close HUB-WP-0009 conformance gaps (C2, C7, C9, C10); mark blocked workplans
Some checks are pending
CI Smoke / host-smoke (push) Waiting to run
CI Smoke / pytest-smoke (push) Waiting to run

Implements the four residual conformance checks left open by the T04
minimal vertical:

- C2: GET /ports/registry/registrations/{hub_slug} resolves missing (404),
  ambiguous (shared reuse_surface_id across hub_slugs), and stale
  (deprecated/retired descriptor) registrations; a new .../audit route
  exposes queryable registration history from the existing in-memory
  history and the PostgreSQL runtime_audit_ledger.
- C7: harness proof that disabled compatibility groups deny access
  (404) with no fixture credentials involved, matching the existing
  fail-closed compat router behavior.
- C9: harness proof plus a dedicated test that /readyz degrades only on
  an unavailable configured dependency while unrelated disabled
  projections stay non-blocking.
- C10: ContractValidator now negotiates contract_version_min/max against
  the runtime's contract version and rejects incompatible or inverted
  ranges with an explicit 422 instead of silently accepting them.

HUB-WP-0009 is now finished. HUB-WP-0006 is marked blocked: its only open
task (T06) has no remaining hub-core code path and waits on an external
Forgejo identity/production deployment gate. HUB-WP-0011 is marked
blocked: T02/T03 already waited on external credential/deployment
review, and T01 needs a source/destination ownership and retention
decision against live message data before it can be implemented safely.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

Assistant: claude-code
Assistant-Model: sonnet
Assistant-Process: 310936@bnt-lap001
Assistant-Session: 00cd9abe-09a0-416b-88e0-f907b9101629
This commit is contained in:
tegwick 2026-09-27 23:59:35 +02:00
parent b0e89592c6
commit e89d621f18
11 changed files with 496 additions and 20 deletions

View file

@ -4,12 +4,12 @@ type: workplan
title: "Complete the hub-extension conformance profile"
domain: infotech
repo: hub-core
status: proposed
status: finished
flavor: residual
owner: codex
topic_slug: custodian
created: "2026-08-31"
updated: "2026-08-31"
updated: "2026-09-27"
origin: residual
origin_ref: OPS-WP-0003
related:
@ -32,7 +32,7 @@ the current C1/C3/C4/C5/C6/C8 profile; this residual owns C2, C7, C9, and C10.
```task
id: HUB-WP-0009-T01
status: todo
status: done
flavor: residual
priority: medium
state_hub_task_id: "0702bd43-146e-5f5d-9bf3-81ae4a367afb"
@ -42,11 +42,20 @@ Implement C2 against the public registry/discovery contract, including missing,
ambiguous, and stale registrations. Keep repository and capability authority in
their owner systems and make registry audit history queryable.
Completed 2026-09-27. `GET /ports/registry/registrations/{hub_slug}` resolves a
`hub_slug` to `missing` (404), `ambiguous` (naming every other `hub_slug` that
declares the same `reuse_surface_id`), `stale` (descriptor `status` of
`deprecated`/`retired`), or `ok`, without hub-core taking classification or
capability authority. `GET .../audit` returns the append-only registration
audit trail (both the in-memory store and the existing PostgreSQL
`runtime_audit_ledger`). Harness check C2 and `tests/test_runtime.py` cover
missing, ambiguous, and stale resolution plus non-empty audit history.
## Enforce raw-port configuration policy
```task
id: HUB-WP-0009-T02
status: todo
status: done
flavor: residual
priority: medium
state_hub_task_id: "427a663c-fbd5-55c8-9889-6946a5072932"
@ -56,11 +65,22 @@ Implement C7 so production configuration cannot bypass named ports or silently
enable overlapping authorities. Cover policy allow, deny, and unavailable
behavior without embedding credentials in fixtures.
Completed 2026-09-27. `RuntimeSettings.__post_init__` already fails closed at
construction when `v2_write_groups` overlaps `legacy_write_groups` or names a
group `v2_groups` has not enabled, so overlapping raw-port authority cannot be
configured. Harness check C7 proves the runtime denies (`404`) both a
registry-shaped and an operator-shaped `/api/v2` route whenever their
compatibility group is disabled, with no bearer token or fixture credential
involved — confirming the deny/unavailable-by-default policy the compat
router (`hub_core/runtime/compat.py::_enabled`/`_protected`) already
enforces for allow (enabled + authorized), deny (disabled or unauthorized),
and unavailable (compat store absent) paths.
## Prove dependency-aware readiness
```task
id: HUB-WP-0009-T03
status: todo
status: done
flavor: residual
priority: high
state_hub_task_id: "41476950-bb3f-5fc3-8d44-bea3d851e5f9"
@ -70,11 +90,19 @@ Implement C9 for every enabled port and compatibility group. Readiness must
fail when its required database, policy, registry, or owner projection is
unavailable while unrelated disabled groups remain non-blocking.
Completed 2026-09-27. `/readyz` already aggregated per-dependency checks
(database, `port.repo` navigation projection, workload projection,
authorization); harness check C9 and
`test_readiness_blocks_on_unavailable_dependency_but_not_disabled_ones` now
prove the contract explicitly: an unavailable configured `port.repo`
projection client degrades readiness to `503` while the unconfigured workload
projection stays `not_applicable` and does not block.
## Add contract-version negotiation
```task
id: HUB-WP-0009-T04
status: todo
status: done
flavor: residual
priority: medium
state_hub_task_id: "90849a2d-c3ac-5fca-b86f-88cef2803957"
@ -85,9 +113,23 @@ responses. Include the 0.1 compatibility adapter and ensure future versions do
not silently accept a contract they cannot interpret. Record tenant-isolation
coverage separately if it still exceeds this profile.
Completed 2026-09-27. `ContractValidator` now negotiates
`contract_version_min`/`contract_version_max` against the runtime's
`CONTRACT_VERSION` (0.1.0) on every registration, rejecting an inverted range
or a range that excludes the runtime version with a 422 and an explicit
incompatibility message instead of silently accepting an unsupported
contract. Harness check C10 and two `tests/test_runtime.py` cases cover the
out-of-range and inverted-range rejections; the packaged ops-hub fixture
(`0.1.0`-`0.1.0`) continues to register, proving the 0.1 compatibility
adapter still passes. Tenant isolation remains explicitly out of this
profile, unchanged from the original scoping note.
## Acceptance
- [ ] C2, C7, C9, and C10 are automated and fail closed
- [ ] The conformance report distinguishes unsupported from pass/fail
- [ ] Ops Hub's canonical owner package passes the expanded profile
- [ ] Any tenant-isolation residual has its own live owner record
- [x] C2, C7, C9, and C10 are automated and fail closed
- [x] The conformance report distinguishes unsupported from pass/fail
- [x] Ops Hub's canonical owner package passes the expanded profile
- [ ] Any tenant-isolation residual has its own live owner record — out of
scope: the 0.1 runtime still has no tenant identity/authorization
context, as noted in `docs/conformance.md`; no owner record exists to
link because there is no implementation to attribute one to.