Back to Plate

cut-evidence-primary-nav

docs/plans/2026-05-28-cut-evidence-primary-nav.md

53.0.89.5 KB
Original Source

cut-evidence-primary-nav

Objective: Cut evidence.html from the primary benchmarks/editor/docs/perf/index.html navigation while preserving it as a generated raw audit footer link.

Completion threshold:

  • index.html primary list has exactly two cards: rich-text.html and slate-v2-internals.html.
  • evidence.html remains generated/reachable as a footer audit link.
  • Benchmark docs generation/checks pass.
  • Served /index.html proves the new shape.

Verification surface:

  • benchmarks/editor/benchmarks/render-perf-index.mjs
  • benchmarks/editor/docs/perf/index.html
  • cd benchmarks/editor && npm run check
  • HTTP smoke proof against http://127.0.0.1:8765/index.html

Constraints:

  • Do not delete evidence.html.
  • Do not change benchmark data or editor rows.
  • No PR/commit/branch requested.

Boundaries:

  • Source of truth: user accepted the cut-visible-nav recommendation.
  • Allowed edit scope: perf docs index generator, generated index, and this plan.
  • Browser surface: static docs server at http://127.0.0.1:8765/.
  • Tracker sync: N/A.
  • Non-goals: no benchmark schema, adapter, or runtime changes.

Blocked condition:

  • Block only if generation/checks fail after targeted repair or the static server is unavailable. Neither happened.

Task state:

  • task_type: generated docs navigation cleanup
  • task_complexity: micro
  • current_phase: closeout
  • current_phase_status: complete
  • next_phase: final response
  • goal_status: ready to close

Current verdict:

  • verdict: complete
  • confidence: high
  • next owner: user
  • reason: generated docs and served route proof satisfy the requested cut.

Completion rule:

  • Close the active goal only after this plan passes the autogoal completion checker.

Start Gates:

GateAppliesEvidence
Skill analysis before editsyesAutogoal used for measurable generated docs output.
Active goal checked or createdyesActive goal created for cutting Evidence Kit from primary nav.
Source of truth read before editsyesExisting generator and generated index inspected.
Tracker comments and attachments readnoN/A: no tracker target.
Video transcript evidence requirednoN/A: no video.
docs/solutions checked for non-trivial existing-code worknoN/A: micro generated-docs cleanup.
TDD decision before behavior change or bug fixyesNo TDD; static generator/check proof fits this change.
Branch decision for code-changing taskyesNo branch action requested.
Release artifact decisionyesNo release artifact; benchmark docs only.
Browser tool decision for browser surfaceyesBrowser connector not exposed; HTTP served proof used as waiver.
PR expectation decisionyesNo PR requested.
Tracker sync expectation decisionyesNo tracker sync requested.

Work Checklist:

  • Objective includes outcome, completion threshold, verification surface, constraints, boundaries, and blocked condition.
  • Task source classified with source type, id/link, title, task type, acceptance criteria, caveats, likely files/routes/packages, browser surface, and root-cause layer.
  • Required video or screen-recording evidence is cached/read as normalized <video-transcripts> XML, or marked N/A with reason.
  • Nearby repo instructions and implementation patterns read before edits.
  • Implementation fixes the right ownership boundary, or the narrower choice is recorded with reason.
  • Release artifact requirement recorded: N/A, benchmark docs only.
  • Final handoff shape decided: concise URL/check summary.
  • Branch handling recorded for code-changing work: N/A, no branch requested.
  • Local-env-rot retry policy recorded: N/A, no install corruption signal.
  • Workspace authority recorded: verification runs in benchmarks/editor.
  • High-risk note recorded: low risk static docs generator change.
  • Review/autoreview target selected: N/A, micro docs generator cleanup.
  • Agent-native review decision recorded: N/A, no agent surfaces changed.

Completion Gates:

GateAppliesRequired actionEvidence
Named verification thresholdyesRun docs/package checks and route proof.npm run check passed; served /index.html proof passed.
Bug reproduced before fixnoN/A: not a bug fix.N/A.
Targeted behavior verificationyesProve only two primary cards and footer audit link remains.HTTP proof found primaryCards: 2, primaryHasEvidence: false, footerHasEvidence: true.
TypeScript or typed config changednoN/A.JS syntax check covered by package check.
Package exports or file layout changednoN/A.No barrels.
Package manifests, lockfile, or install graph changednoN/A.No manifest change this pass.
Agent rules or skills changednoN/A.No sync.
Workspace authority proofyesVerify in benchmark package/static server.Commands ran in /Users/zbeyens/git/plate-2/benchmarks/editor and route proof hit 127.0.0.1:8765.
Browser surface changedyesRoute proof or browser proof.Browser connector unavailable; HTTP route proof passed.
Browser final proofyesRecord exact caveat.No screenshot/console capture; static served HTML assertion passed.
CI-controlled template output changednoN/A.No templates.
Package behavior or public API changednoN/A.No changeset.
Registry-only component work changednoN/A.No changelog.
Docs or content changedyesVerify generated docs.npm run docs:index, npm run docs:index:check, and npm run check passed.
High-risk mini gatenoN/A.Low-risk static nav cleanup.
Agent-native review for agent/tooling changesnoN/A.No agent surfaces.
Local install corruption suspectednoN/A.No reinstall.
Autoreview for non-trivial implementation changesnoN/A.Micro cleanup.
PR create or updatenoN/A.No PR.
PR proof image hostingnoN/A.No PR.
Tracker sync-backnoN/A.No tracker.
Final handoff contractyesFill final handoff fields.Final handoff fields completed below.
Final lintyesRun scoped formatter/check.npx biome check benchmarks/render-perf-index.mjs --fix passed.
Goal plan completeyesRun autogoal checker.To run after this update.

Phase / pass table:

PhaseStatusEvidenceNext
Intake and source readcompleteGenerator and index inspected.implementation
ImplementationcompleteGenerator changed to footer-only evidence link.verification
VerificationcompleteFormatter, docs index check, full package check, and served route proof passed.closeout
PR / tracker synccompleteN/A.final response
CloseoutcompletePlan ready for autogoal checker.final response

Findings:

  • The generated index made Evidence Kit a peer page, which is too noisy for the main benchmark entrypoint.

Decisions and tradeoffs:

  • Keep evidence.html as a raw audit footer link instead of deleting it.

Implementation notes:

  • Changed the generated index.html template to render two primary list items and a footer link for Evidence Kit.

Review fixes:

  • None.

Error attempts:

Error / failed attemptCountNext different moveResolution
Browser connector unavailable1Use HTTP route proof.Route proof passed.

Verification evidence:

  • npx biome check benchmarks/render-perf-index.mjs --fix passed in benchmarks/editor.
  • npm run docs:index passed in benchmarks/editor.
  • npm run docs:index:check passed in benchmarks/editor.
  • node --check benchmarks/render-perf-index.mjs passed in benchmarks/editor.
  • npm run check passed in benchmarks/editor.
  • Served proof for http://127.0.0.1:8765/index.html: status 200, title present, primary cards 2, primary rich-text link true, primary internals link true, primary evidence link false, footer evidence link true.

Final handoff contract:

  • PR line: N/A.
  • Issue / tracker line: N/A.
  • Confidence line: High; generated docs and route proof passed.
  • Flow table:
    • Reproduced: N/A.
    • Verified: npm run check and served index assertion passed.
  • Browser check: Browser connector unavailable; static HTTP assertion used.
  • Outcome: index.html now has only two primary navigation cards, with Evidence Kit in the footer.
  • Caveat: No screenshot or console capture.
  • Design:
    • Chosen boundary: generated index template.
    • Why not quick patch: generated HTML would be overwritten.
    • Why not broader change: preserving raw Evidence Kit output is still useful.
  • Verified: see verification evidence above.

Final handoff / sync:

  • PR: N/A.
  • Issue / tracker: N/A.
  • Browser proof: route-level HTTP proof passed.
  • Caveats: static HTML proof only.

Timeline:

  • 2026-05-28T15:45Z Created goal and inspected generator/index.
  • 2026-05-28T15:46Z Moved Evidence Kit from primary card to footer audit link.
  • 2026-05-28T15:47Z Regenerated docs and verified package plus served route.

Reboot status:

QuestionAnswer
Where am I?Closeout
Where am I going?Final response
What is the goal?Remove Evidence Kit from primary nav while preserving raw audit access.
What have I learned?The generator owns the page, so the template is the right boundary.
What have I done?Changed the generator, regenerated docs, and verified checks/routes.

Open risks:

  • None for the requested cut; browser proof is route-level rather than screenshot-level.