lumina-rag-knowledge

# Lumina Rag Knowledge ## Overview Use this skill for retrieval, ingestion, and citation work. The repository treats knowledge management as a CLI-driven flow rather than a UI-managed feature. ## Load The Right Reference - Read `references/cli-workflow.md` when updating or using ingestion commands, manifests, or source files. - Read `references/retrieval-contract.md` when changing runtime retrieval, citation formatting, or grounded-answer behavior. ## Preserve The Grounding Contract - Keep answers grounded in indexed sources. - Preserve inline citations and the associated sources list behavior when changing retrieval or response composition. - Avoid adding UI-based mutation flows for knowledge content unless the task explicitly requires a product change. - Prefer updating source content through the CLI and manifest workflows already documented in the repo. ## Change Source Lifecycle Carefully - Preserve stable `externalId` usage when designing repeatable updates. - Keep ingestion, deletion, listing, and sync semantics coherent across CLI commands and model storage. - If a change affects both retrieval logic and general API behavior, coordinate with `lumina-backend-api`. ## Finish With Practical Validation - Run `npm run build` in `server/` after code changes. - Use the existing CLI commands for targeted runtime checks when environment variables and external services are available. - If Pinecone or Gemini credentials are unavailable, state that runtime retrieval was not exercised.