Skip to content

Polish cockpit how-question guidance - #167

Open
RicheyWorks wants to merge 1 commit into
mainfrom
feature/cockpit-how-questions-polish-pack
Open

Polish cockpit how-question guidance#167
RicheyWorks wants to merge 1 commit into
mainfrom
feature/cockpit-how-questions-polish-pack

Conversation

@RicheyWorks

Copy link
Copy Markdown
Owner

Summary

  • Polishes /routing-demo.html with dedicated how-question guidance for interpreting routing decisions, reproducing local proof, reading edge cases, strategy-choice effects, and evidence support.
  • Adds a browser-local Copy how-to reviewer explanation action with local/demo boundaries and not-proven limits.
  • Updates docs/REVIEWER_TRUST_MAP.md discoverability for the cockpit how-question guide.
  • Adds/updates guardrail tests for UI text, copied how-to content, trust-map discoverability, local/demo-only boundaries, and no-overclaim limits.

How-question inventory summary

  • Already answered before this sprint: selected strategy/backend, input signal summaries, scenario deltas, degradation/recovery notes, evidence path, copy boundaries, and local/demo limits.
  • Still unclear before this sprint: a dedicated interpretation sequence, reproduction steps, edge-case reading guide framing, strategy-choice effects, evidence-support meaning, and copyable how-to reviewer explanation.
  • This PR fills those gaps while keeping the page static/browser-local and same-origin.

Core scope completed

  • Added How to Interpret This Decision guidance.
  • Added How to Reproduce This Proof steps.
  • Added How to Read Edge Cases guidance.
  • Added browser-local Copy how-to reviewer explanation action/text.
  • Added tests for interpretation text, reproduction steps, edge cases, copy text/action, and safety boundaries.

Stretch scope completed

  • Added How Strategy Choice Matters subsection.
  • Added How Evidence Supports the Decision subsection.
  • Added Cockpit How-Question Guide discoverability in docs/REVIEWER_TRUST_MAP.md.

Tests run

  • mvn -q -Dtest=RoutingDecisionDemoTest,ReviewerTrustMapDocumentationTest,CockpitDiscoverabilityDocumentationTest,EnterpriseReadinessAuditDocumentationTest test - PASS
  • mvn -q test - PASS
  • mvn -q -DskipTests package - PASS
  • mvn -B package - PASS, 1412 tests, 0 failures/errors/skips
  • git diff --check - PASS
  • scripts/smoke/enterprise-lab-workflow.ps1 -Package - PASS
  • Packaged routing-demo.html resource check in target/classes and built JAR - PASS
  • Extracted inline script node --check - PASS
  • Loopback smoke for /routing-demo.html, linked static evidence pages, and /api/routing/compare - PASS
  • Changed-file audits for secrets, unsafe commands, external calls/CDNs/telemetry, upload/share/server-side export/PDF/ZIP behavior, release/signing/registry/cloud/governance mutation commands, overclaims, generated target evidence, and test weakening - PASS

Safety boundaries

  • Static dashboard/docs/tests only.
  • No Java production/API/server/routing code changed.
  • No real routing algorithm, proxy/network, cloud, registry, signing, release, or GitHub settings behavior changed.
  • No external calls, CDNs, analytics, telemetry, upload/share endpoints, or server-side export/PDF/ZIP/file generation added.

Not-proven limits

  • No production traffic proof.
  • No live cloud proof.
  • No real tenant proof.
  • No registry publication proof.
  • No container signing proof.
  • No GitHub settings mutation proof.
  • No production certification, SLA/SLO proof, or production-readiness claim.

Production code changed

  • No.

Runtime behavior changed

  • No routing/API/server behavior changed; static reviewer UI/docs/tests only.

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