* add repository guidelines and project structure documentation
* update neo4j image version and modify test command to disable specific databases
* implement deduplication helpers and integrate with node operations
* refactor string formatting to use single quotes in node operations
* enhance deduplication helpers with UUID indexing and update resolution logic
* implement exact fact matching (#931)
- Remove the 50-error threshold that allowed type errors to pass
- Require 0 type errors for CI to pass (aiming for full type safety)
- Only check src/ directory (tests have legacy issues to fix separately)
- Update error messages to be clearer about requirements
- Add helpful hint about running pyright locally
This ensures all new code maintains strict type safety and prevents
accumulation of type errors over time.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Merge README-kuzu.md content into main Docker README.md
- Add complete FalkorDB documentation with configuration and gotchas
- Remove editorializing about which database is 'best' or 'recommended'
- Provide equal treatment for all three databases (KuzuDB, Neo4j, FalkorDB)
- Include specific gotchas and troubleshooting for each database
- Add detailed backup/restore procedures for each database type
- Document all environment variables and configuration options
- Remove pros/cons sections and performance comparison editorializing
- Delete redundant README-kuzu.md file
The documentation now provides factual, unbiased instructions for using
any of the three supported graph databases.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add validation for Azure OpenAI API URL to ensure it's not None
- Fix OpenAI embedder config to use 'embedding_model' instead of 'model'
- Remove 'dimensions' parameter from OpenAIEmbedderConfig (not supported)
- Add URL validation for both LLM and embedder Azure configurations
All pyright type checks now pass with 0 errors.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add explicit instructions to always run formatting before commits
- Include both make commands and direct uv commands
- Emphasize this is a required step, not optional
- Place in Development Guidelines section for visibility
This ensures all code contributions maintain consistent style and quality.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Rename docker-compose.yml to docker-compose-neo4j.yml for Neo4j setup
- Rename docker-compose-kuzu.yml to docker-compose.yml (making KuzuDB default)
- Create docker-compose-falkordb.yml for FalkorDB deployment
- Add dedicated config files for each database type:
- config-docker-neo4j.yaml for Neo4j
- config-docker-falkordb.yaml for FalkorDB
- config-docker-kuzu.yaml for KuzuDB
- Create comprehensive Docker README with database comparison
- Update all compose files to use their respective config files
KuzuDB is now the default database for Docker deployments due to:
- No external dependencies required
- Lower resource usage
- Instant startup time
- Simpler deployment
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Update docker-compose-kuzu.yml to use persistent volume by default
- Set KUZU_DB to /data/graphiti.kuzu for persistent storage
- Increase max concurrent queries from 1 to 10 for better performance
- Add dedicated config-docker-kuzu.yaml for Docker deployments
- Create README-kuzu.md with usage instructions and troubleshooting
- Configure volume with local driver for data persistence
The setup now provides:
- Automatic data persistence across container restarts
- No external database dependencies
- Simple backup/restore procedures
- Lower resource usage compared to Neo4j
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add KuzuProviderConfig to schema for KuzuDB configuration
- Update DatabaseDriverFactory to support KuzuDB initialization
- Modify GraphitiService to handle KuzuDB driver instantiation
- Update CLI argument parser to include 'kuzu' option
- Make KuzuDB the default database provider (in-memory by default)
- Add docker-compose-kuzu.yml for standalone KuzuDB deployment
- Fix FalkorDB factory to parse URI into host/port parameters
- Fix EntityNode type access (use labels[0] instead of type)
- Add kuzu dependency to MCP server pyproject.toml
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Update graphiti_mcp_server.py to use correct Graphiti API methods
- Replace non-existent search_nodes with search_ method
- Add new get_episodes tool using EpisodicNode.get_by_group_ids
- Remove problematic search_episodes implementation
- Fix factory imports and client instantiation in factories.py
- Correct import paths for FalkorDriver, Azure clients, Voyage embedder
- Update LLM/Embedder creation to use proper config objects
- Fix Azure OpenAI client instantiation with AsyncAzureOpenAI
- Update NodeResult TypedDict to match actual usage
- Change uuid parameter type to str | None in queue_service
Resolves 20 critical runtime type errors identified by pyright.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Created test_http_integration.py for HTTP/SSE transport testing
- Created test_mcp_transports.py for comprehensive transport tests
- Created test_stdio_simple.py for basic stdio validation
- Fixed all formatting and linting issues in test files
- All unit tests passing (5/5)
- Integration tests verify server connectivity with all transports
Note: Integration test clients have timing issues with MCP SDK,
but server logs confirm proper operation with all transports.
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
- Fixed import formatting in conftest.py
- Added noqa comment for late import required by path setup
- All ruff format and lint checks now pass
- All pytest tests pass successfully
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
- Created isolated pytest.ini configuration for MCP server
- Added conftest.py to prevent loading parent project fixtures
- Added pytest and pytest-asyncio to dev dependencies
- Enabled pytest in CI workflow with proper environment variables
- Fixed asyncio test configuration
Pytest now runs successfully for MCP server tests without interfering
with the root project test configuration.
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
- Deleted unused test_simple_validation.py file
- Removed syntax/import validation tests (handled by linting)
- Added support for streamable HTTP transport mode
- Updated transport options: sse (default), stdio, http
- Fixed server default to SSE as intended
Transport modes now available:
- SSE: Server-Sent Events for web clients (default)
- stdio: Standard I/O for MCP protocol
- http: Streamable HTTP for modern clients
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
- Changed default transport from 'stdio' to 'sse' as intended
- Removed redundant syntax_validation and import_validation tests (handled by linting)
- Clarified test_integration.py is for HTTP/SSE mode testing
- Simplified test_simple_validation.py to only test server startup
The server now correctly defaults to SSE (Server-Sent Events) mode for HTTP
transport, with stdio as an alternative for MCP protocol communication.
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
Replace hardcoded 'fake-key-for-testing' with GitHub Actions secret
to enable proper LLM and embedding functionality in CI tests.
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
- Update default OpenAI embedder from text-embedding-ada-002 to text-embedding-3-small
- Add environment variable support for Neo4j credentials (NEO4J_URI, NEO4J_USER, NEO4J_PASSWORD)
- Add environment variable support for FalkorDB credentials (FALKORDB_URI, FALKORDB_PASSWORD)
- Fixes CI/CD authentication issues where environment variables weren't being recognized
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
- Remove invalid custom_node_types parameter from Graphiti initialization
- Pass entity_types to add_episode method instead of constructor
- Rename custom_types to entity_types in queue_service for clarity
The Graphiti API expects entity_types to be passed to add_episode methods, not the constructor.
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
- Remove pull_request trigger from Docker build workflow
- Add dockerfile path to fix build error
- Update conditional logic for login and push steps
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
The GraphitiService.__init__ was accepting semaphore_limit as a parameter but not storing it as an instance attribute, causing an AttributeError when trying to access self.semaphore_limit in the initialize method.
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
- Added norecursedirs and testpaths to pytest.ini to exclude mcp_server
- Also updated pyproject.toml with additional exclusion patterns
- Root project pytest now only discovers tests in the tests/ directory
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Removed unnecessary blank lines in factories.py
- Fixed formatting to pass CI checks
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Fixed 'Neo4j provider configuration not found' error in CI
- Create default provider configurations when not explicitly provided
- Both Neo4j and FalkorDB now fall back to sensible defaults
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Added norecursedirs = ["mcp_server"] to pytest configuration
- Prevents pytest from recursively discovering tests in mcp_server when running from root
- mcp_server has its own dedicated test suite and GitHub Actions workflow
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
