P3D — Vector Search Reliability Hardening — Design Report

Date: 2026-05-11 Author: Opus 4.7

Status Fields

phase_status=PASS
mode=DESIGN_AND_PROMPT_ONLY
search_boost_behavior=PASS
production_durability_plan=READY
canary_plan=READY
recency_tiebreak=INCLUDED
audit_warning_cleanup=INCLUDED
unified_search_contract=INCLUDED
implementation_allowed=false
no_mutation_performed=true
next_required_action=GPT_REVIEW_HARDENING_IMPLEMENTATION_PROMPT

Top 7 Hardening Decisions

1. Compose build: directive — add to make image rebuild from source. docker compose build = durable deploy.
2. Canary script at /opt/incomex/dot/bin/dot-search-canary — 8 queries, PASS/FAIL per query, runnable after any deploy.
3. Recency tie-break max +0.005 — only when path/title boost > 0, decays 30 days, separate feature flag SEARCH_RECENCY_TIEBREAK.
4. Audit exclusion for ghost noise — empty-id, folder paths, short body (<10 chars) excluded from ghost count.
5. Test template → vector_status='excluded' — single PG write, non-production row.
6. _apply_path_title_boost() accepts collection_name — ready for IU vector, no behavior change now.
7. Force-recreate proof — AC-2 requires canary PASS after docker compose up --force-recreate.

Included vs Deferred

Item	Status
Deployment durability	✅ INCLUDED
Canary test	✅ INCLUDED
Recency tie-break	✅ INCLUDED (conservative)
Audit cleanup	✅ INCLUDED
Unified contract structure	✅ INCLUDED (code param, not IU vector)
IU vector implementation	❌ DEFERRED (Pack 9)
Cron canary schedule	⚠️ INCLUDED as optional (agent decides)

GPT/User Review Required

YES — implementation prompt is DRAFT. Dispatch only after explicit approval.

---

Hardening Design Report | 2026-05-11 | Opus 4.7