[OpenSpec] vector-rag

[github-actions]

⚠️ OpenSpec-managed issue — this content is automatically synced
from the openspec/ directory. Manual edits will be overwritten on next sync.

Artifacts

• ✅ Metadata
• ✅ Proposal
• ✅ Specs
• ✅ Design
• ✅ Tasks
• 🔲 Plan
• 🔲 Review

Specs

• 📄 agent-tool-governance
• 📄 vector-rag

Tasks

• 0.1 File/confirm the OpenRegister change implementing the public vector facade
• 1.1 Add a small Hermiq-side resolver (SPDX docblock, @spec tags) that probes
• 2.1 Re-point the semantic/hybrid branch of retrieveContext(): facade
• 2.2 Keep the empty-views gate in front of ALL modes (searchScoped()
• 2.3 Fallback tiers: facade absent / unavailable / throwing → the existing
• 2.4 Confirm the consuming loop needs no change for entity_type: file rows
• 3.1 search(): when embedTexts() is available, rank the RESOLVED set by
• 3.2 Descriptor embedding cache keyed on hash(descriptor ids) + embedding model
• 3.3 No backend ⇒ the existing substring path unchanged (same method, same cap).
• 4.1 Surface the current retrieval tier (vector-live / keyword-degraded, with
• 5.1 Unit tests (php:8.3-cli, the CI way): handler — semantic routes to the
• 5.2 Fresh containerized PHPUnit run vs. the current baseline — report both
• 5.3 Live-verify (AFTER the OR facade change lands): on a dev instance with an
• 5.4 openspec validate vector-rag --strict; phpcs/psalm/phpstan clean; hydra

Design

See design.md for technical design details.

---

Synced from openspec/changes/vector-rag by OpenSpec workflow
App: hermiq