lumina-rag-knowledge

name	lumina-rag-knowledge
description	Manage Lumina's retrieval-augmented generation and knowledge ingestion workflow. Use when editing server/src/services/knowledgeBase.ts, server/src/services/pineconeClient.ts, server/src/scripts/knowledgeCli.ts, server/src/models/KnowledgeSource.ts, files under server/knowledge, manifest-based sync inputs, or debugging grounded answers, retrieval relevance, source lifecycle, and inline citations.

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.