propose: JRAG CLI — agent-facing command-line interface

[HumanBean17]

Adds propose/JRAG-CLI-PROPOSE.md.

What this is

Design proposal for the jrag CLI — a named-intent command surface for AI coding agents navigating a Java microservices codebase. Complements (does not replace) the MCP.

Key decisions in this doc

• neighbors removed entirely; every edge traversal gets a named command
• Resolve-first contract: every <query> arg resolves internally — no raw IDs required
• Same repo, new jrag PyPI entry point
• 5 PRs planned: daemon, locate tier, listing tier, traversal tier, orientation + search + packaging

Checklist

• TL;DR is bullets, covers design call + migration shape
• §1 Frame commits to a single ruling sentence
• 8 design principles, each binding and falsifiable
• Use-case re-walk: 20 cases, all mapped to final surface
• §8 "What this does NOT do" table present
• Migration PR count matches TL;DR and section enumeration (5 × PR-JRAG-1…5)
• 23 locked decisions, none left open
• Consistency pass completed
• Appendix A: output envelope JSON schema