docs: update README and BACKLOG with recent features by carlos-alm · Pull Request #214 · optave/ops-codegraph-tool · GitHub
Skip to content

docs: update README and BACKLOG with recent features#214

Merged
carlos-alm merged 2 commits into
mainfrom
docs/update-backlog-readme
Mar 2, 2026
Merged

docs: update README and BACKLOG with recent features#214
carlos-alm merged 2 commits into
mainfrom
docs/update-backlog-readme

Conversation

@carlos-alm

Copy link
Copy Markdown
Contributor

Summary

Test plan

  • No code changes — docs only
  • Verified MCP tool count programmatically (26 single-repo, 27 multi-repo)
  • Verified competitor hybrid search claims against their READMEs

Mark backlog items as DONE: streaming/pagination (#207), hybrid
BM25+semantic search (#198), CODEOWNERS (#195), snapshots (#192),
TF-IDF search (subsumed by #198).

Update README: add CODEOWNERS, snapshots, hybrid search, pagination
sections; update MCP tool count to 26/27; add --mode, --ndjson,
--limit, --offset flags; update feature comparison tables with verified
competitor data.
Keep DONE markings for snapshots (PR #192) while incorporating
main's structural changes (ID 30 repositioned, Foundation-aligned
wording update, OWASP moved to Tier 3).

Impact: 99 functions changed, 103 affected
@claude

claude Bot commented Mar 2, 2026

Copy link
Copy Markdown

@carlos-alm carlos-alm merged commit 6914736 into main Mar 2, 2026
15 checks passed
@carlos-alm carlos-alm deleted the docs/update-backlog-readme branch March 2, 2026 01:58
@greptile-apps

greptile-apps Bot commented Mar 2, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

Updated documentation to reflect recent feature additions including CODEOWNERS integration, graph snapshots, hybrid BM25+semantic search, and pagination/NDJSON streaming. Marked 5 backlog items as complete with proper PR references.

Critical Issue:

  • MCP tool count is incorrect throughout README.md — claims 26 single-repo/27 multi-repo but actual code has 24/25 tools

Otherwise:

  • Feature comparison tables updated appropriately
  • New CLI flags documented (--mode, --ndjson, --limit, --offset)
  • BACKLOG.md updates accurate with implementation details
  • Comparison date updated to March 2026

Confidence Score: 2/5

  • Documentation contains factual errors that need correction before merge
  • The MCP tool count is systematically incorrect in 4 locations (26/27 vs actual 24/25), which contradicts the PR's claim of programmatic verification. This is docs-only so no runtime impact, but the inaccuracy should be fixed.
  • README.md needs tool count corrections at lines 58, 103, 150, and 176

Important Files Changed

Filename Overview
README.md MCP tool count incorrect in 4 locations (claims 26/27, actual is 24/25); otherwise comprehensive feature documentation updates
docs/roadmap/BACKLOG.md Correctly marks 5 features as DONE with proper PR references and implementation details

Last reviewed commit: 9144aae

@greptile-apps greptile-apps Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 files reviewed, 4 comments

Edit Code Review Agent Settings | Greptile

Comment thread README.md
```

That's it. No config files, no Docker, no JVM, no API keys, no accounts. The graph is ready to query. Add `codegraph mcp` to your AI agent's config and it has full access to your dependency graph through 24 MCP tools (25 in multi-repo mode).
That's it. No config files, no Docker, no JVM, no API keys, no accounts. The graph is ready to query. Add `codegraph mcp` to your AI agent's config and it has full access to your dependency graph through 26 MCP tools (27 in multi-repo mode).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

MCP tool count is incorrect. The actual code has 24 tools in BASE_TOOLS (25 with list_repos in multi-repo mode), not 26/27.

Suggested change
That's it. No config files, no Docker, no JVM, no API keys, no accounts. The graph is ready to query. Add `codegraph mcp` to your AI agent's config and it has full access to your dependency graph through 26 MCP tools (27 in multi-repo mode).
That's it. No config files, no Docker, no JVM, no API keys, no accounts. The graph is ready to query. Add `codegraph mcp` to your AI agent's config and it has full access to your dependency graph through 24 MCP tools (25 in multi-repo mode).

Comment thread README.md
| **🔬** | **Function-level, not just files** | Traces `handleAuth()` → `validateToken()` → `decryptJWT()` and shows 14 callers across 9 files break if `decryptJWT` changes |
| **🏷️** | **Role classification** | Every symbol auto-tagged as `entry`/`core`/`utility`/`adapter`/`dead`/`leaf` — agents instantly know what they're looking at |
| **🤖** | **Built for AI agents** | 24-tool [MCP server](https://modelcontextprotocol.io/) — AI assistants query your graph directly. Single-repo by default |
| **🤖** | **Built for AI agents** | 26-tool [MCP server](https://modelcontextprotocol.io/) — AI assistants query your graph directly. Single-repo by default |

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same tool count error - should be 24 tools, not 26.

Suggested change
| **🤖** | **Built for AI agents** | 26-tool [MCP server](https://modelcontextprotocol.io/) — AI assistants query your graph directly. Single-repo by default |
| **🤖** | **Built for AI agents** | 24-tool [MCP server](https://modelcontextprotocol.io/) — AI assistants query your graph directly. Single-repo by default |

Comment thread README.md

```bash
codegraph mcp # 24-tool MCP server — AI queries the graph directly
codegraph mcp # 26-tool MCP server — AI queries the graph directly

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tool count should be 24, not 26.

Suggested change
codegraph mcp # 26-tool MCP server — AI queries the graph directly
codegraph mcp # 24-tool MCP server — AI queries the graph directly

Comment thread README.md
| 🧠 | **Semantic search** | Embeddings-powered natural language search with multi-query RRF ranking |
| 👀 | **Watch mode** | Incrementally update the graph as files change |
| 🤖 | **MCP server** | 24-tool MCP server for AI assistants; single-repo by default, opt-in multi-repo |
| 🤖 | **MCP server** | 26-tool MCP server for AI assistants; single-repo by default, opt-in multi-repo |

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tool count should be 24 (25 in multi-repo), not 26 (27 in multi-repo).

Suggested change

Zeeeepa pushed a commit to Zeeeepa/codegraph that referenced this pull request Jun 22, 2026
Mark backlog items as DONE: streaming/pagination (optave#207), hybrid
BM25+semantic search (optave#198), CODEOWNERS (optave#195), snapshots (optave#192),
TF-IDF search (subsumed by optave#198).

Update README: add CODEOWNERS, snapshots, hybrid search, pagination
sections; update MCP tool count to 26/27; add --mode, --ndjson,
--limit, --offset flags; update feature comparison tables with verified
competitor data.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant