Skip to content

feat: ArgentMunch MVP index/query/health + benchmark#1

Merged
webdevtodayjason merged 2 commits intomainfrom
codex/mvp-index-health
Mar 5, 2026
Merged

feat: ArgentMunch MVP index/query/health + benchmark#1
webdevtodayjason merged 2 commits intomainfrom
codex/mvp-index-health

Conversation

@webdevtodayjason
Copy link
Copy Markdown
Contributor

Summary

Implements ArgentMunch MVP with:

  • CLI index command (local repo path)
  • CLI symbol query command
  • /health HTTP endpoint + health server
  • Benchmark script and baseline report
  • Tests and quickstart docs

Changes

  • src/jcodemunch_mcp/cli.py (new)
  • src/jcodemunch_mcp/health_server.py (new)
  • tests/test_mvp.py (new)
  • scripts/benchmark_mvp.py (new)
  • docs/MVP_STATUS.md (new)
  • docs/benchmarks/mvp-baseline.md (new)
  • README.md (updated quickstart/examples)
  • pyproject.toml (added argentmunch entry point)

Validation

  • python -m pytest -q → 203 passed
  • argentmunch index . --no-ai → indexed 37 files/358 symbols successfully
  • argentmunch query local/argentmunch "search_symbols" → returns 4 symbol hits (2.6ms)
  • curl http://localhost:9120/health → valid JSON health payload (all 5 required fields present)

Benchmark (MVP baseline)

  • Broad search (index): 59,738 → 441 tokens (99.3%, 135x)
  • Specific lookup (save_index): 59,738 → 286 tokens (99.5%, 209x)
  • Cross-cutting (parse file): 59,738 → 531 tokens (99.1%, 113x)

Residual Risks

  1. Upstream license file not detected; legal review pending (LICENSE_CHECK.md)
  2. Python 3.14 tested only; 3.10-3.13 not verified
  3. /health endpoint is unauthenticated (local-safe, prod hardening needed)
  4. CLI indexes local folders only (remote indexing still MCP-server path)
  5. AI summaries not included in benchmark path

Follow-up Issues (required)

  • Prod hardening: auth/security for health endpoint
  • Legal gate: upstream licensing verification + attribution policy

Merge Gate

Do not merge until legal review issue has explicit decision status.

…chmark, tests

- Add argentmunch CLI entry point with index, query, list, health, serve commands
- Add HTTP /health endpoint (JSON, 200/503)
- Add benchmark script comparing brute-force vs symbol query tokens
- Add 17 tests covering index/query/health/CLI workflows
- Update README with working quickstart examples
- Add docs/MVP_STATUS.md with delivered/gaps/next phase
- Add docs/benchmarks/mvp-baseline.md (99%+ token savings)
- Register argentmunch CLI in pyproject.toml
@webdevtodayjason webdevtodayjason merged commit b0cd3ca into main Mar 5, 2026
3 checks passed
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