feat: CLI-first expansion — 10 subcommands + CommonJS require() parsing

[murilloimparavel]

Summary

Exposes all 22 MCP tool functions as direct CLI subcommands, enabling CLI-first workflows without requiring the MCP server. Also adds CommonJS require() parsing for JavaScript codebases that use dynamic imports.

New CLI subcommands

Command	Description
query <pattern> <target>	Query relationships (callers_of, callees_of, imports_of, etc.)
impact [--files] [--depth]	Analyze blast radius of changed files
search <query> [--kind]	Search code entities by name/keyword
flows [--sort] [--limit]	List execution flows by criticality
flow [--id | --name]	Get details of a single execution flow
communities [--sort]	List detected code communities
community [--id | --name]	Get details of a single community
architecture	Architecture overview from community structure
large-functions [--min-lines]	Find functions/classes exceeding line threshold
refactor <mode>	Rename preview, dead code detection, suggestions

CLI post-processing (fixes #93)

build and update commands now run the same post-processing as the MCP tool:

• Signature computation
• FTS5 index rebuild
• Execution flow detection
• Community detection

CommonJS require() parsing

Three new methods in parser.py:

• _js_get_require_target(): extracts module paths from require(), path.join(), path.resolve(), template literals, dynamic import()
• _extract_js_require_constructs(): creates IMPORTS_FROM edges for CommonJS patterns
• _collect_js_require_names(): populates import map for call resolution

Results on test monorepo (14.5K files):

• IMPORTS_FROM edges increased 4x (525 → 2,075)
• Flows detected: 1,185
• Communities: 605

CLI UX improvements

• Updated banner and docstring with all new commands
• "Graph not built" warning when DB is missing
• Argparse validation: flow/community require --id or --name
• Argparse validation: refactor rename requires --old-name/--new-name
• DELEGATED_COMMANDS set skips redundant GraphStore creation

Test plan

• 29/29 CLI functional tests passing (all patterns, edge cases, empty args)
• Full rebuild: 8,352 nodes, 50,259 edges, 1,185 flows, 605 communities
• CommonJS require() — no regression on ESM import handling
• Empty require('') and require() handled gracefully (no crash, no empty edges)
• Depth-limited recursion (max_depth=50) prevents stack overflow
• bin/crg repos, bin/crg --version, bin/crg --help work without --repo

🤖 Generated with Claude Code

[Jay-Gajera]

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

🤖 Generated with Claude Code