Skip to content

docs: five reference examples use flags or arguments that do not exist #1402

Closed

Description

@Shashankss1205

All verified by execution; all exit 2.

Doc Documented Actual
reference/cli.md:94 cgc report [--include-java] flag is --java
reference/cli.md:30 cgc index [--force] [--dependency] no --dependency; the real flag --summarize is undocumented
CLI_COMPLETE_REFERENCE.md:56 cgc analyze overrides <class> --file no --file; the arg is a function name, not a class
CLI_COMPLETE_REFERENCE.md:69 cgc find content <text> --case-sensitive no such flag (it is valid on find pattern)
CLI_COMPLETE_REFERENCE.md:116 cgc visualize [query], "Generate link to Neo4j Browser" takes no positional; launches a local UI server
$ cgc report --include-java
│ No such option: --include-java (Possible options: --java) │      EXIT=2
$ cgc analyze overrides area --file foo.py
│ No such option: --file │                                          EXIT=2
$ cgc visualize "MATCH (n) RETURN n"
│ Got unexpected extra argument(s) (MATCH (n) RETURN n) │           EXIT=2

The analyze overrides row is doubly wrong: passing a class name, as documented, returns zero results silently.


Audit environment
Version codegraphcontext 0.5.2 (PyPI)
Commit df3af04
Backend FalkorDB Lite (falkordblite 0.9.0), Python 3.12.3, Linux
Corpus the CodeGraphContext repo itself — 784 files, 23 languages, 5,501 Function nodes

Audit ID U-H8 · severity high · from an end-to-end audit of CGC 0.5.2 (63 findings). Reported with the reproduction as run.

Activity

  1. added
    bugSomething isn't working
    documentationImprovements or additions to documentation
    severity: highWrong graph content, data loss, or a broken workflow with no clear signal
    area: cli/mcpCLI commands, MCP tool contracts, docs
    on Jul 26, 2026
  2. github-actions commented on Jul 26, 2026

    @github-actions
    Contributor

    Hi! 👋 Join our CodeGraphContext Discord channel to collaborate: https://discord.gg/dR4QY32uYQ

  3. moved this from Backlog tasks to In progress in CGC Progress Boardon Jul 26, 2026
  4. moved this from In progress to Done in CGC Progress Boardon Jul 31, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    area: cli/mcpCLI commands, MCP tool contracts, docsbugSomething isn't workingdocumentationImprovements or additions to documentationgood first issueGood for newcomersseverity: highWrong graph content, data loss, or a broken workflow with no clear signal

    Type

    No type

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions