All notable changes to Codevira MCP will be documented here.
The format follows Keep a Changelog. This project adheres to Semantic Versioning.
search_decisions()accepts optionalsession_idparameter to scope results to a specific session — backwards compatible, defaults toNonelogs.retention_daysconfig option — auto-delete session logs older than N days on everywrite_session_log()call (0= keep forever, default)tests/test_search.py— 9 tests covering log cleanup logic andsession_idfilter behaviour
- Global MCP Client Guide: Added explicit documentation in
README.mdandFAQ.mdexplaining how to configure uniquely named servers (e.g.,codevira-project-a) to prevent cross-project roadmap contamination when using global clients like Google Antigravity or Claude Desktop. - Gitignore Safeguard: Added
.codevira/to the default project.gitignoreto prevent auto-generated configuration and database files from being accidentally committed to public repositories.
Core MCP Server — 26 tools across 5 modules
get_node,get_impact,list_nodes,add_node,update_node,refresh_graph,refresh_index— context graph toolsget_roadmap,get_full_roadmap,get_phase,update_next_action,update_phase_status,add_phase,complete_phase,defer_phase— roadmap toolslist_open_changesets,get_changeset,start_changeset,complete_changeset,update_changeset_progress— changeset toolssearch_codebase,search_decisions,get_history,write_session_log— search and session toolsget_signature,get_code— Python AST code reader toolsget_playbook— curated task rule lookup
Indexer
- ChromaDB + sentence-transformers semantic code index
- Python AST chunker with function/class-level granularity
- Auto-generated context graph stubs from imports and docstrings
- Incremental indexing (only changed files since last build)
--full,--status,--watch,--generate-graph,--bootstrap-roadmapCLI flags- Config-driven via
.agents/config.yaml(watched_dirs, language, file_extensions, collection_name)
Agent System
- Seven agent persona definitions: Orchestrator, Planner, Developer, Reviewer, Tester, Builder, Documenter
- Session protocol (
PROTOCOL.md) with mandatory start/end steps - 16 engineering rules files covering coding standards, testing, API design, git governance, and more
Developer Experience
roadmap.yamlauto-stub on firstget_roadmap()call — zero setup required- Git post-commit hook for auto-reindex on every commit
config.example.yamltemplate for quick project setup- Graph node schema reference (
graph/_schema.yaml)
Documentation
- Full README with quickstart, tool reference, agent personas, language support table
PROTOCOL.md— session protocol for AI agentsFAQ.md— setup, usage, architecture, and troubleshootingROADMAP.md— public project roadmap with versioned milestonesCONTRIBUTING.md— contribution guide including AI-assisted workflowCODE_OF_CONDUCT.md,SECURITY.md- GitHub issue templates (bug report, feature request) and PR template
Language Support
- Full support: Python (AST chunking, get_signature, get_code, auto graph stubs)
- Partial support: TypeScript, Go, Rust (regex chunking; all non-AST tools work)