Skip to content

SESSION_NOTES.md

Latest commit

 

History

History
34 lines (20 loc) · 2.01 KB

SESSION_NOTES.md

File metadata and controls

34 lines (20 loc) · 2.01 KB

Session notes

Brief log of what was decided or shipped in working sessions.

2026-04-16

GitHub issues triage

  • Listed open issues on jmjava/documentation-generator. Many M4/M5 items are still open on GitHub while their bodies say completed in PR #27; worth closing or refreshing those issues when convenient.
  • Still meaningful open work includes: #36 (validation), #35 (anchor auto-detection), #34 (test discovery), #37 (docs/dogfood), #1 (Manim scene gap), #16/#17 (Playwright visual source + admin), M5 MCP/chat/agents, #45 (Ollama follow-ups).

Issue #36 — Validation extensions for playwright_test (shipped)

Implemented validator support for visual_map entries with type: playwright_test:

  • playwright_test_context — reports segment, test id, visual source, recording path, and artifact paths when known.
  • playwright_test_trace — fails on test_status / outcome in events JSON; scans small JSON inside trace.zip for fatalError markers.
  • playwright_test_events — when narration anchors exist (anchors or events with narration_anchor), compares anchor count to action entries in the events timeline file.
  • playwright_test_speed — warns (non–pre-push blocking) when sync_map.json speed_segments[].factor is outside configured bounds; --pre-push treats this as a soft check like OCR/freeze.
  • playwright_test_sync_duration — ensures last narration_t in sync_map anchors does not exceed narration audio duration plus max_drift_sec.

Config: optional playwright_test: block with min_speed_factor / max_speed_factor (defaults 0.25 and 4.0).

Files: src/docgen/config.py, src/docgen/validate.py, tests/test_validate_playwright.py, tests/test_config.py (plus indentation fix in an existing test).

Commit: 7809591 on main — pushed to origin/main.

Misc

  • gh issue view failed locally with a GraphQL Projects (classic) deprecation error; gh api repos/.../issues/N worked for reading issue bodies.