Execute next roadmap PRs with SDD/TDD (tracking)

[erseco]

Tracking issue: execute next roadmap PRs with SDD/TDD

Coordinates the next slice of the Improvement Roadmap Execution Plan, using Specification-Driven Development (spec in each child issue before coding) and Test-Driven Development (failing test first, then minimal implementation, then green), one small reviewable PR per deliverable.

Baseline (already done — do NOT redo)

Verified against main before opening this work:

• Structured CLI output --output table|json|yaml|csv — done (feat: replace ad-hoc --json flag with unified --output table|json|yaml #25, Extend CLI output: CSV, --quiet, --no-color, --verbose/--debug #55). src/py_moodle/cli/output.py exposes OutputFormat + emit() + csv_fields.
• Global CLI flags --quiet/--no-color/--verbose/--debug — done (Extend CLI output: CSV, --quiet, --no-color, --verbose/--debug #55).
• Centralized HTTP timeouts — done (Centralize default HTTP timeouts across session, compatibility, and upload flows #22, Centralize HTTP requests, timeouts, retries, and error handling #39). src/py_moodle/config.py holds the timeout policy; src/py_moodle/http.py applies it.
• Exception clarity (first pass) — done (Improve roadmap troubleshooting docs and clarify session/auth error messages #23).
• MoodleClient facade, typed models, doctor, ensure, dry-run, transport split — done (Add a high-level MoodleClient public API facade #37–Split Moodle transport strategies: webservice, AJAX, HTML #57, Fix flaky Docker-backed integration tests and add Moodle 5.2.1 to CI #62, Fall back to AJAX on a Moodle course-context validation error #64).
• Recipes for the above — already present in docs/recipes.md.

Wave 1 (max 3 concurrent PRs, strictly file-disjoint to avoid CLI/docs conflicts)

• Add --fields support for machine-readable CLI output #66 — Add --fields support for machine-readable CLI output (owns cli/output.py + CLI list commands + new tests)
• Document test layers, shared fixtures, and contributor test commands #67 — Document test layers, shared fixtures, and contributor test commands (owns docs/development.md)
• Add HTML-fixture regression scaffolding for brittle parsing #68 — Add HTML-fixture regression scaffolding for brittle parsing (owns new tests/unit/fixtures/*.html + tests/unit/test_html_fixtures.py)

Wave 2 (after wave 1 merges)

• Recipes: add a --fields recipe once that flag is merged (docs/recipes.md). — Wave 2: redacted HTTP debug tracing, --fields recipe, and roadmap status update #76
• Follow-up reliability/observability: retry support (already done in Centralize HTTP requests, timeouts, retries, and error handling #39), debug tracing (Wave 2: redacted HTTP debug tracing, --fields recipe, and roadmap status update #76 / Subtask 7). Roadmap status refreshed in docs/roadmap-plan.md (Wave 2: redacted HTTP debug tracing, --fields recipe, and roadmap status update #76).

Merge policy

Merge each child PR independently when: CI is green (unit/lint/docs/CodeQL are the reliable gates; integration legs may need reruns due to known infra flakiness), required tests exist, docs updated, and it has been reviewed. Squash-or-merge per repo convention (repo uses merge commits). Close the linked issue and tick this list on each merge.

Wave 3 (done)

• Ship py.typed (PEP 561) now that the typed surface is real (Subtask 14) #78/Ship py.typed (PEP 561) #79 — Ship py.typed (PEP 561), Subtask 14.
• Extend the ensure-style API: ensure_section/label/resource/folder + create_or_update_course (Subtasks 18-20) #77/Extend the ensure-style API: sections + content modules + create_or_update_course #80 — Extend the ensure-style API: ensure_section/ensure_label/ensure_resource/ensure_folder + create_or_update_course, Subtasks 18–20.
• Add redacted HTTP debug tracing to the centralized http layer (Subtask 7) #75/Wave 2: redacted HTTP debug tracing, --fields recipe, and roadmap status update #76 — Redacted HTTP debug tracing (Subtask 7).
• docs: consolidate AGENTS.md to current architecture + roadmap wave-3 status #81 — Consolidate AGENTS.md to the current architecture + roadmap status refresh.

Remaining roadmap items (Subtasks 34–36 CLI polish; Phase E/F backend & extension work) are tracked in docs/roadmap-plan.md and can be picked up as future slices. This tracking issue is complete.

[erseco]

All waves complete: wave 1 (#66/#67/#68), wave 2 (#75/#76 tracing, --fields recipe, roadmap), wave 3 (#77/#80 ensure-* API, #78/#79 py.typed, #81 AGENTS.md consolidation). Remaining roadmap items (CLI polish 34–36, Phase E/F) tracked in docs/roadmap-plan.md.