┌─────────────────────────────────────────────────────────────────────┐
│                    INGESTION & ENRICHMENT LAYER                      │
│  Connectors → Chunking → Embeddings → Entity Extraction →           │
│  Entity Resolution → Graph Construction                              │
└──────────────────────────┬──────────────────────────────────────────┘
                           │
┌──────────────────────────▼──────────────────────────────────────────┐
│                    KNOWLEDGE GRAPH (Neo4j)                           │
│  Product → Requirement → Component → TestCase → TestRun →           │
│  Defect → ChangeRequest                                              │
└──────────────────────────┬──────────────────────────────────────────┘
                           │
┌──────────────────────────▼──────────────────────────────────────────┐
│                    RETRIEVAL LAYER                                   │
│  VectorRetriever │ GraphRAGRetriever │ NL2CypherRetriever │ Hybrid  │
└──────────────────────────┬──────────────────────────────────────────┘
                           │
┌──────────────────────────▼──────────────────────────────────────────┐
│                    AGENT LAYER                                       │
│  LangGraph Agent (plan→retrieve→reason→validate→respond)            │
│  Strands Agent (tool-calling with 5 specialized graph tools)        │
└──────────────────────────┬──────────────────────────────────────────┘
                           │
┌──────────────────────────▼──────────────────────────────────────────┐
│                    INTERFACE LAYER                                   │
│  FastAPI REST │ MCP Server (Claude Desktop / Cursor compatible)     │
└─────────────────────────────────────────────────────────────────────┘

cd manufacturing-graphrag
python -m venv .venv
.venv\Scripts\activate          # Windows
pip install -r requirements.txt
python -m spacy download en_core_web_sm
copy .env.example .env          # Edit with your credentials

docker-compose up neo4j -d

set PYTHONPATH=src
python scripts/seed_data.py

# API server
python main.py api

# MCP server (for Claude Desktop)
python main.py mcp

# Both
python main.py all

python scripts/ingest.py path/to/spec.pdf path/to/requirements.csv

# Hybrid GraphRAG query
curl -X POST http://localhost:8000/query \
  -H "Content-Type: application/json" \
  -d '{"question": "What components are affected by the thermal runaway defect?"}'

# LangGraph agent — multi-step reasoning
curl -X POST http://localhost:8000/agent/langgraph \
  -d '{"question": "Trace the full impact chain of DEF-001 and identify all change requests needed"}'

# Strands agent — tool-calling
curl -X POST http://localhost:8000/agent/strands \
  -d '{"question": "Which critical defects are blocking the EV BMS release?"}'

# Defect traceability
curl http://localhost:8000/traceability/defect/DEF-002

(Product)-[:HAS_REQUIREMENT]->(Requirement)
(Component)-[:IMPLEMENTS]->(Requirement)
(TestCase)-[:VALIDATES]->(Requirement)
(TestRun)-[:INSTANCE_OF]->(TestCase)
(TestRun)-[:FOUND_IN]->(Defect)
(Defect)-[:AFFECTS]->(Component)
(Defect)-[:TRIGGERS_CHANGE]->(ChangeRequest)
(ChangeRequest)-[:MODIFIES]->(Component)
(Document)-[:CONTAINS_CHUNK]->(Chunk)
(Chunk)-[:MENTIONS]->(any entity)

set PYTHONPATH=src
pytest tests/ -v