consolidation of some of the modules, localization fixes, product advisories work, qa work

docs/modules/unknowns/architecture.md

@@ -1,8 +1,8 @@
-# component_architecture_unknowns.md - **Stella Ops Unknowns** (2025Q4)
+# component_architecture_unknowns.md - **Stella Ops Unknowns** (2025Q4, updated 2026-03-04)
 
 > Unknown component and symbol tracking registry.
 
-> **Scope.** Library architecture for **Unknowns**: tracking unresolved components, symbols, and mappings that Scanner and other analyzers cannot definitively identify.
+> **Scope.** Standalone microservice architecture for **Unknowns**: tracking unresolved components, symbols, and mappings that Scanner and other analyzers cannot definitively identify.
 
 ---
 
@@ -12,9 +12,13 @@
 
 **Boundaries.**
 
-* Unknowns is a **library layer** consumed by Scanner and Signals.
+* Unknowns is a **standalone microservice** with its own HTTP API surface, DbContext, and schema ownership.
+* Unknowns is **independently deployable** and is **not consolidated into Policy** or any other module.
 * Unknowns **does not** guess identities. It records what cannot be determined.
 * All unknowns are **categorized** for actionability.
+* Library layers within Unknowns are consumed by Scanner, Signals, and Platform via ProjectReference.
+
+> **Boundary decision (Sprint 206, 2026-02-25):** Unknowns retains its own `UnknownsDbContext` and schema ownership. No source consolidation into Policy and no DbContext merge. See `docs/implplan/SPRINT_20260225_206_Policy_absorb_unknowns.md` for rationale.
 
 ---
 
@@ -22,10 +26,15 @@
 
 ```
 src/Unknowns/
+ ├─ StellaOps.Unknowns.WebService/         # Standalone Minimal API host
+ │   └─ Endpoints/
+ │       ├─ UnknownsEndpoints.cs            # /api/unknowns (list, detail, hints, history, triage, hot-queue, summary)
+ │       └─ GreyQueueEndpoints.cs           # /api/grey-queue (enqueue, process, resolve, escalate, etc.)
+ ├─ StellaOps.Unknowns.Services/            # Business logic layer
  ├─ __Libraries/
  │   ├─ StellaOps.Unknowns.Core/           # Unknown models, categorization
- │   ├─ StellaOps.Unknowns.Persistence/    # Storage abstractions
- │   └─ StellaOps.Unknowns.Persistence.EfCore/
+ │   ├─ StellaOps.Unknowns.Persistence/    # Storage abstractions + EF DbContext (UnknownsDbContext with DbSet<UnknownEntity>)
+ │   └─ StellaOps.Unknowns.Persistence.EfCore/  # EF Core compiled model
  │
  └─ __Tests/
      ├─ StellaOps.Unknowns.Core.Tests/
@@ -143,3 +152,23 @@ See `src/Unknowns/__Libraries/StellaOps.Unknowns.Core/Schemas/provenance-hint.sc
 
 * Scanner: `../scanner/architecture.md`
 * Signals: `../signals/architecture.md`
+* Policy: `../policy/architecture.md` (Policy references Unknowns via `UnknownsBudgetGate` but does not own Unknowns persistence or source)
+* Boundary decision: `../../implplan/SPRINT_20260225_206_Policy_absorb_unknowns.md`
+
+---
+
+## Advisory Gap Status (2026-03-04 Batch)
+
+Status: implementation delivered in Sprint 304.
+
+- `AttachProvenanceHintsAsync` and `GetWithHighConfidenceHintsAsync` are implemented in active repositories:
+  - `src/Unknowns/__Libraries/StellaOps.Unknowns.Persistence/Postgres/Repositories/PostgresUnknownRepository.cs`
+  - `src/Unknowns/__Libraries/StellaOps.Unknowns.Persistence/EfCore/Repositories/UnknownEfRepository.cs`
+- High-confidence retrieval now applies deterministic ordering (`combined_confidence DESC`, `id ASC`) and tenant scoping.
+- Migration `src/Unknowns/__Libraries/StellaOps.Unknowns.Persistence/Migrations/002_provenance_hints.sql` targets `unknowns.unknown` (aligned with runtime repositories).
+- Active EF runtime path is `src/Unknowns/__Libraries/StellaOps.Unknowns.Persistence/EfCore/**`.
+- Duplicate scaffold path `src/Unknowns/__Libraries/StellaOps.Unknowns.Persistence.EfCore/**` is explicitly marked as non-active/deprecated to prevent behavior drift.
+
+Closure sprint:
+
+- `docs/implplan/SPRINT_20260304_304_Unknowns_provenance_hints_persistence_completion.md`