point agent docs at resolve for identifier lookups

[HumanBean17]

Summary

• PR-RESOLVE-2 (see plans/PLAN-RESOLVE-TOOL.md): agent-facing prose sweep so identifier workflows use resolve first; removes pre-resolve search + describe-per-candidate wording from MCP tool descriptions and docs.
• describe_v2 FQN-collision hint now recommends resolve(identifier=…, hint_kind='symbol') instead of find / search chains.
• Adds test_server_tool_descriptions_no_pre_resolve_fallback and renames the duplicate-FQN hint test.
• No ontology bump; no graph schema changes.

Merge order: resolve (PR-RESOLVE-1) is already on master; this PR stacks on that.

Manual evidence

Sentinel grep (expect no output):

grep -En 'per\.candidate|until.*resolve|promising candidates|search\(query=.*\).*describe' \
  server.py mcp_v2.py docs/AGENT-GUIDE.md README.md AGENTS.md \
  docs/JAVA-CODEBASE-RAG-CLI.md docs/MANUAL-VERIFICATION-CHECKLIST.md \
  docs/skills/java-codebase-explore.md .cursor/rules/project-overview.mdc || true

Pytest:

.venv/bin/ruff check .
.venv/bin/python -m pytest tests/test_mcp_v2.py -v -k 'resolve or describe_by_fqn_duplicate_hint_points_to_resolve or tool_descriptions_no_pre_resolve'
PATH="$(pwd)/.venv/bin:$PATH" .venv/bin/python -m pytest tests -v

Test plan

• Ruff clean
• Sentinel grep reviewed (empty)
• Focused + full tests (full suite: ensure .venv/bin is on PATH for CLI tests)

Made with Cursor