docs(adr): 0123 pool-emission-quality gate (proposed, amends 0119) #1506

Merged
chris merged 2 commits from docs/adr-0123-pool-quality-gate into main 2026-11-14 15:45:32 +01:00
Owner

ADR 0123 (proposed)

Implements the owner requirement verbatim: weak pool faces stay recognized and marked, but never mint automatic suggestions — manual assignment via the similarity-sorted picker is untouched.

Semantics (demotion, not deletion): two new v6-scoped settings — pool_min_confidence (detector confidence) and pool_min_quality (V138 crop quality: 0.7·sharpness + 0.3·exposure — the 'verschwommen' signal, already computed, 100 % coverage). A gated pool face stays a full partition member (clusters, densifies, marked in the UI, re-proposable) but cannot be claimed by any card; an all-gated group mints nothing. Emission-scoped → no cache/contract/wire change, no recluster prerequisite.

Evidence carried in the ADR: the hard-drop variant was measured (CV probe, best 0122 cell) and rejected — wrong B-cards −29 % at −24 % correct; demotion costs nothing in correctness, only review-channel volume. Defaults ship NULL (off) with the probe knee (0.60 / 0.25) documented as the recommended starting point.

Implementation scope: feed gains additive qualityScore (ADR 0119 pattern), _emit_group_candidates gains an optional emission-eligibility predicate (v6 only, v1–v5 byte-identical), V189 columns + admin UI fields (!1503 pattern), settings threading per V188. 0119 gains the cross-link sentence.

Follow-up implementation PRs will follow per the ADR's test plan.

## ADR 0123 (proposed) Implements the owner requirement verbatim: **weak pool faces stay recognized and marked, but never mint automatic suggestions** — manual assignment via the similarity-sorted picker is untouched. **Semantics (demotion, not deletion):** two new v6-scoped settings — `pool_min_confidence` (detector confidence) and `pool_min_quality` (V138 crop quality: 0.7·sharpness + 0.3·exposure — the 'verschwommen' signal, already computed, 100 % coverage). A gated pool face **stays a full partition member** (clusters, densifies, marked in the UI, re-proposable) but **cannot be claimed by any card**; an all-gated group mints nothing. Emission-scoped → no cache/contract/wire change, no recluster prerequisite. **Evidence carried in the ADR:** the hard-drop variant was measured (CV probe, best 0122 cell) and rejected — wrong B-cards −29 % at −24 % correct; demotion costs nothing in correctness, only review-channel volume. Defaults ship NULL (off) with the probe knee (0.60 / 0.25) documented as the recommended starting point. **Implementation scope:** feed gains additive `qualityScore` (ADR 0119 pattern), `_emit_group_candidates` gains an optional emission-eligibility predicate (v6 only, v1–v5 byte-identical), V189 columns + admin UI fields (!1503 pattern), settings threading per V188. 0119 gains the cross-link sentence. Follow-up implementation PRs will follow per the ADR's test plan.
docs(adr): 0123 pool-emission-quality gate (proposed, amends 0119) — weak pool faces recognized+marked but never mint auto suggestions; 0119 cross-link amended
All checks were successful
Wiki Sync / Sync wiki from docs (push) Has been skipped
Build and Deploy / Detect changed services and test scopes (push) Successful in 3s
Build and Deploy / Run scoped PR tests (push) Has been skipped
Build and Deploy / Smoke API and media worker (push) Has been skipped
Build and Deploy / Smoke web (push) Has been skipped
Build and Deploy / Smoke ML worker (push) Has been skipped
Build and Deploy / Smoke people worker (push) Has been skipped
Build and Deploy / Build postgres image (push) Has been skipped
Build and Deploy / Build Android CI image (push) Has been skipped
Build and Deploy / Build plants worker image (push) Has been skipped
Build and Deploy / Build converter worker image (push) Has been skipped
Build and Deploy / Android unit tests and debug APK (push) Has been skipped
Build and Deploy / Deploy postgres (push) Has been skipped
Build and Deploy / Build API image (push) Has been skipped
Build and Deploy / Build media worker image (push) Has been skipped
Build and Deploy / Build ML worker image (push) Has been skipped
Build and Deploy / Build people worker image (push) Has been skipped
Build and Deploy / Build web image (push) Has been skipped
Build and Deploy / Deploy API (push) Has been skipped
Build and Deploy / Deploy web (push) Has been skipped
Build and Deploy / Deploy media worker (push) Has been skipped
Build and Deploy / Deploy ML worker (push) Has been skipped
Build and Deploy / Deploy plants worker (push) Has been skipped
Build and Deploy / Deploy people worker (push) Has been skipped
Build and Deploy / Deploy converter worker (push) Has been skipped
Build and Deploy / Deploy review instance (push) Has been skipped
Build and Deploy / Clean Docker build artifacts (push) Has been skipped
2c53d48009
docs(adr): 0119 gains the ADR 0123 pool-gate amendment sentence (V6 cross-link)
All checks were successful
Wiki Sync / Sync wiki from docs (push) Has been skipped
Build and Deploy / Detect changed services and test scopes (push) Successful in 3s
Build and Deploy / Run scoped PR tests (push) Has been skipped
Build and Deploy / Smoke API and media worker (push) Has been skipped
Build and Deploy / Smoke web (push) Has been skipped
Build and Deploy / Smoke ML worker (push) Has been skipped
Build and Deploy / Smoke people worker (push) Has been skipped
Build and Deploy / Build postgres image (push) Has been skipped
Build and Deploy / Build Android CI image (push) Has been skipped
Build and Deploy / Build plants worker image (push) Has been skipped
Build and Deploy / Build converter worker image (push) Has been skipped
Build and Deploy / Android unit tests and debug APK (push) Has been skipped
Build and Deploy / Deploy postgres (push) Has been skipped
Build and Deploy / Build API image (push) Has been skipped
Build and Deploy / Build media worker image (push) Has been skipped
Build and Deploy / Build ML worker image (push) Has been skipped
Build and Deploy / Build people worker image (push) Has been skipped
Build and Deploy / Build web image (push) Has been skipped
Build and Deploy / Deploy API (push) Has been skipped
Build and Deploy / Deploy web (push) Has been skipped
Build and Deploy / Deploy media worker (push) Has been skipped
Build and Deploy / Deploy ML worker (push) Has been skipped
Build and Deploy / Deploy plants worker (push) Has been skipped
Build and Deploy / Deploy people worker (push) Has been skipped
Build and Deploy / Deploy converter worker (push) Has been skipped
Build and Deploy / Deploy review instance (push) Has been skipped
Build and Deploy / Clean Docker build artifacts (push) Has been skipped
b4b3a0a4b6
chris merged commit 7e38721bda into main 2026-11-14 15:45:32 +01:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
chris/memories!1506
No description provided.