Issue #27 Implementation Doc Stub
1. Issue reference
- GitHub issue:
#27 - Issue title:
[Backend][Ingestion] Hybrid index + English canonicalization in ingest endpoint - Issue type:
feature - Milestone:
Backend RAG M3 - Retrieval & Chat Quality
2. Summary
- What this issue changed:
TBD - Why the change was needed: make ingestion produce the hybrid retrieval artifacts needed by the global retrieval pipeline.
3. Initial repo state
- Relevant behavior before implementation: the repo already has an active hybrid retrieval plan and related ops docs, but this issue has not been executed yet.
- Known constraints or gaps at start: canonicalization and hybrid indexing details must stay aligned with the chosen retrieval contract.
4. Plan doc referenced
- Plan doc path:
docs/plans/2026-02-21-global-retrieval-hybrid-rrf-implementation.md - Plan status at implementation start:
Draft / For Review - Was the plan updated during implementation?:
TBD - If yes, what changed in the plan?:
TBD
5. Decisions taken
| Decision | Reason | Alternative rejected |
|---|---|---|
| Stub only | Pre-create the implementation record for the issue. | Starting ingestion changes without a dedicated execution log. |
6. Files changed
| File | Change summary |
|---|---|
docs/implementation/issue-27-hybrid-index-english-canonicalization-ingest-endpoint.md |
Created implementation doc stub. |
7. Migrations / schema changes
- Migration files: none yet
- Schema changes: none yet
- Data backfill or manual steps: none yet
- Rollback notes: not applicable yet
8. API changes
| Surface | Change | Compatibility impact |
|---|---|---|
| None yet | No implementation details recorded yet. | None |
9. Tests added or updated
| Test file or suite | Change |
|---|---|
| None yet | No implementation work has started. |
10. Risks / caveats
- Ingestion and retrieval behavior can drift if the plan doc is not kept current while canonicalization details evolve.
11. Follow-up work
- Update the referenced plan doc if ingestion behavior changes during implementation.
- Record migrations, API changes, and validation evidence when the issue moves forward.
12. Final repo state
- Relevant behavior after implementation: not implemented yet; stub created to reserve the issue record.
- Remaining limitations: ingestion contract, schema, and validation details are pending.
13. Docs updated
| Doc path | Update summary |
|---|---|
docs/implementation/issue-27-hybrid-index-english-canonicalization-ingest-endpoint.md |
Added initial implementation doc stub. |