TenantAtlas/docs/product/discoveries.md

Discoveries

Status: Active
Last reviewed: 2026-04-30
Use for: Parking implementation findings and follow-up ideas that are not yet part of the active roadmap or candidate queue
Do not use for: Active priority order once an item is already tracked in the roadmap or spec-candidates

Things found during implementation that don't belong in the current spec. Review weekly. Promote to spec-candidates.md or discard.

Items that are already tracked in spec-candidates.md or roadmap.md should not remain here.

Last reviewed: 2026-04-30

---

2026-04-30 — 2026-03-15 architecture hardening cluster moved out of discoveries

• Source: architecture audit
• Observation: The queued execution, tenant-query-canon, findings-enforcement, and Livewire trust-boundary items from the 2026-03-15 audit are now tracked through promoted specs and the roadmap hardening lane. They no longer belong in discoveries.md as open findings.
• Category: documentation
• Priority: low
• Suggested follow-up: Use roadmap.md and spec-candidates.md for current hardening follow-through; keep discoveries.md for new findings that are not yet tracked elsewhere.

---

2026-03-08 — Alert sla_due event type is dead code

• Source: Spec 109 (Review Pack Export)
• Observation: sla_due alert rule event type exists in the schema but no producer dispatches it. Dead code path.
• Category: cleanup
• Priority: low
• Suggested follow-up: Remove or implement. If SLA alerting is a future feature, document the intent; otherwise delete.

---

2026-03-08 — Alert Deliveries header-action exemption needs permanent documentation

• Source: Spec 122 (Empty State Consistency)
• Observation: Alert Deliveries is the first resource with an explicit UX-001 relocation exemption — its CTA exists only in the empty state and does NOT relocate to the header. This needs to remain documented so future developers don't "fix" it.
• Category: documentation
• Priority: low
• Suggested follow-up: Ensure the exemption is captured in the Action Surface Contract guard tests and/or resource-level comments.

---

2026-03-08 — Historical findings backfill for source field

• Source: Spec 101 (Golden Master Baseline Governance)
• Observation: The source field on findings was added but historical findings may not be backfilled. Reporting accuracy depends on this.
• Category: data integrity
• Priority: medium
• Suggested follow-up: One-time migration or backfill job to classify existing findings by source.

---

2026-03-08 — Baseline profile hard-delete deferred

• Source: Spec 101 (Golden Master Baseline Governance)
• Observation: Baseline profiles can only be archived, not hard-deleted, in v1. If archive accumulation becomes a problem, a hard-delete with cascade needs to be built.
• Category: feature gap
• Priority: low
• Suggested follow-up: Monitor archive count. Spec only if it becomes a user-reported issue.

---

2026-03-08 — Drift engine hard-fail when no Inventory Sync exists

• Source: Spec 119 (Baseline Drift Engine Cutover)
• Observation: Currently drift capture does NOT hard-fail when no completed Inventory Sync exists. This was deferred as a "larger product behavior change."
• Category: hardening
• Priority: medium
• Suggested follow-up: Evaluate whether capturing drift without a baseline sync produces misleading results. If so, enforce the prerequisite.

---

2026-03-08 — Performance indexes for system console windowed queries

• Source: Spec 114 (System Console Control Tower)
• Observation: EXPLAIN baselines don't show pressure yet, but windowed queries on operation_runs could become slow at scale. Indexes were explicitly deferred.
• Category: performance
• Priority: low
• Suggested follow-up: Monitor query times. Add indexes proactively if run count exceeds ~100k.

---

Template

## YYYY-MM-DD — Short title
- **Source**: Spec NNN (Name) | chat | audit | coding
- **Observation**:
- **Category**: feature gap | cleanup | hardening | UX polish | performance | documentation | data integrity
- **Priority**: low | medium | high
- **Suggested follow-up**: