# Roadmap — grafeo-langchain

## Phase 1 — Core (current)

> Detail: [todo/phase-1-core.md](todo/phase-1-core.md)

- [ ] Project scaffolding (pyproject.toml, src layout, tooling)
- [ ] `GrafeoGraphStore` — knowledge graph storage
- [ ] `GrafeoGraphVectorStore` — vector + graph retrieval
- [ ] `graph_document.py` — conversion helpers
- [ ] Test suite (graph_store, graph_vector_store, retriever)
- [ ] README with usage examples

## Phase 2 — Polish

> Detail: [todo/phase-2-polish.md](todo/phase-2-polish.md)

- [ ] CI/CD pipeline (GitHub Actions: lint, type-check, test)
- [ ] prek hooks config (`.pre-commit-config.yaml`)
- [ ] Runnable examples in `examples/`
- [ ] PyPI publishing setup
- [ ] Integration tests with real embeddings (optional, marked slow)

## Phase 3 — Advanced

> Detail: [todo/phase-3-advanced.md](todo/phase-3-advanced.md)

- [ ] `langchain-graph-retriever` adapter (Eager/BFS strategies)
- [ ] Async support (`async_similarity_search`, etc.)
- [ ] Batch embedding ingestion for large document sets
- [ ] Graph algorithm integration (PageRank scoring, community detection)
- [ ] LangSmith tracing integration
