chore: tidy completed plans/proposes & refresh stale docs

[HumanBean17]

Tidy completed plans/proposes & refresh stale docs

Bookkeeping PR. Moves all docs whose corresponding PR has merged into the existing completed/ subfolders, and fixes a handful of broken/outdated references in README.md and CODEBASE_REQUIREMENTS.md.

Plans → plans/completed/

File	Implementing PR
PLAN-CLIENT-ROLE-RENAME.md	#33 merged
PLAN-CROSS-SERVICE-RESOLUTION-FLAG.md	#30 merged
PLAN-FEIGN-NOT-AN-EXPOSER.md	#31 merged

Proposes → propose/completed/

File	Status
CLIENT-ROLE-RENAME-PROPOSE.md	#28 merged, plan implemented in #33
CROSS-SERVICE-RESOLUTION-FLAG-PROPOSE.md	#26 merged, plan implemented in #30
FEIGN-NOT-AN-EXPOSER-PROPOSE.md	#25 merged, plan implemented in #31

Active docs left in place (intentional)

• propose/PRODUCT-VISION.md — vision doc, not a feature propose
• propose/RANKING-MICROSERVICE-PROPOSE.md — explicitly deferred (revisit after cross-microservice edges land in production usage)
• propose/REFRESH-CODE-INDEX-AUTO-MODE-PROPOSE.md — active, partner to incremental rebuild
• propose/TIER2-INCREMENTAL-REBUILD-PROPOSE.md — active, ready for planning
• propose/ENHANCED-ROLE-RECOGNITION-PROPOSE.md — active (supertype detection like JpaRepository is not in ast_java.py yet)

Active doc fixes

README.md §6 "Deferred"

• trace_request_flow is shipped — removed from "remaining graph work"
• HTTP_CALLS / ASYNC_CALLS / find_route_callers / brownfield composition layer all shipped — note that explicitly so future readers don't think they're still deferred
• Incremental Kuzu work now points at the active proposes (TIER2-INCREMENTAL-REBUILD-PROPOSE.md, REFRESH-CODE-INDEX-AUTO-MODE-PROPOSE.md)
• get_service_topology is the only truly-not-yet-shipped item from the original list; kept it explicit

CODEBASE_REQUIREMENTS.md A.3 (Capabilities)

• Dropped the stale (version 3) literal — current ONTOLOGY_VERSION is 9
• Fixed reference: plans/PLAN-CAPABILITIES-MODEL.md → plans/completed/PLAN-CAPABILITIES-MODEL.md
• Fixed reference: propose/DEFERRED-CALL-GRAPH-PROPOSE.md (never existed under that name) → propose/completed/CALL-GRAPH-PROPOSE.md
• Tense fix: call-graph layer is shipped, not "deferred"

CODEBASE_REQUIREMENTS.md B.9 (custom edge types)

• Same propose/DEFERRED-CALL-GRAPH-PROPOSE.md → propose/completed/CALL-GRAPH-PROPOSE.md fix
• "planned shape" → "shipped shape" (call-graph PRs landed long ago)

Risk

Zero code change. Tests baseline unchanged: 290 passed, 4 skipped (matches post-PR-H1 master).

Why now

After PR-F1 (#31), PR-G1 (#30), and PR-H1 (#33) all merged in this session, six docs accumulated in the active plans/ and propose/ directories that no longer represent open work. Active vs completed should match reality.

[HumanBean17]

Follow-up: inline Java stubs for @CodebaseRoute / @CodebaseClient / @CodebaseProducer

Good catch — the brownfield annotations beyond @CodebaseRole / @CodebaseCapability were referenced in 4 places but the @interface stubs were never shown inline. Users had to spelunk into tests/fixtures/brownfield_*_stubs/ to know what to copy. Fixed in 6b6f2ea.

Changes

README.md — §5 "Brownfield overrides — Last resort — source stubs" now has three explicit subsections:

§	Annotations	Target	Example shown
3a	@CodebaseRole / @CodebaseCapability / @CodebaseCapabilities	class	LegacyChatService with role + 2 capabilities
3b	@CodebaseRoute / @CodebaseRoutes + CodebaseRouteFrameworkKind / CodebaseRouteKind	method	spring_mvc HTTP endpoint + kafka consumer
3c	@CodebaseClient / @CodebaseClients and @CodebaseProducer / @CodebaseProducers	method	rest_template outbound + kafka_send producer

The route enum values mirror VALID_ROUTE_FRAMEWORKS / VALID_ROUTE_KINDS; the clientKind strings note the valid set (feign_method, rest_template, web_client, kafka_send, stream_bridge_send) and the warn-and-drop behaviour. Stub Java in the doc matches the verbatim sources under tests/fixtures/brownfield_route_stubs/ and tests/fixtures/brownfield_client_stubs/ (still pointed at for full-file copy-paste).

CODEBASE_REQUIREMENTS.md A.2.1 — updated to enumerate all three annotation families (roles, routes, clients/producers) instead of only mentioning role/capability stubs, with cross-links to README §3a / §3b / §3c.

Tests

290 passed, 4 skipped in 54.55s

No code change. Baseline unchanged.

Diff size

 CODEBASE_REQUIREMENTS.md |  21 ++++--
 README.md                | 172 ++++++++++++++++++++++++++++++++++++++++++++---
 2 files changed, 177 insertions(+), 16 deletions(-)