Teach consumer agents the live MCP loop and skip unchanged Workbench compiles

[ds-code-t]

Summary

Consumer AI agents now isolate failures in a paused headless Workbench worker, then run one bounded diagnostic mvn test. The GUI is not the 2.1.9 agent path.

• AGENT-GUIDE (source docs/consumer-agent-guide.md) starts with a tool chooser: live headless MCP (mcp .) → one diagnostic mvn test → edit real consumer source. No GUI, ui ., or attach.json in that chooser. Generated .pickleball trees are documented as read-only reference / compiled overlay, not a sandbox.
• Workbench sync fingerprints Java sources, resources, build files, and dependency artifacts separately. Unchanged inputs skip the wrapper; feature/config/data-only changes run process-test-resources (or Gradle processTestResources) without test-compile / testClasses. -DskipTests is preserved. Live Gherkin buffer edits still never require sync.
• MCP diagnostic readers workbench_diagnostic_catalog, workbench_diagnostic_run, and workbench_diagnostic_summary return sparse JSON only (no events/traces/PNGs).
• Documented AI confirmation pkb_runvars include pkb_reportingmode=diagnostic, pkb_loglevel=warn, and pkb_reportretention=failed. Human PickleballTests defaults (pretty, @all) are unchanged.

Functionality-change coverage

• I reviewed AGENTS.md and the relevant feature-map entry.
• Framework implementation is complete.
• Focused framework tests were added or updated.
• Maven consumer scenarios and supporting resources were added or updated when applicable.
• README or canonical documentation was updated when behavior changed.
• docs/agent/feature-map.md remains accurate.
• docs/agent/repository-index.md is current.
• Backward compatibility was preserved, or the breaking change is documented.

Validation

• python3 scripts/verify_agent_contract.py
• python3 scripts/refresh_agent_index.py --check
• python3 scripts/sync_consumer_guidance.py --check
• ./gradlew :pickleball-workbench:test
• ./gradlew publishToMavenLocal
• Focused consumer PickleballGuidanceChecks via @diagnostic-reporting (not @all)

Not run: full ./gradlew test root suite and consumer @all. This change is Workbench sync/MCP plus exported agent guidance; focused Workbench tests and the diagnostic-reporting consumer checks cover the touched surfaces.

Branch: cursor/consumer-agent-live-loop-303c into 2.1.9.