Handbook

Changelog

All notable changes to forge-lcdl are documented here. Versions follow SemVer for the Python package (pyproject.toml).

Updated

Unreleased

Added

  • Handbook remediation: strict YAML frontmatter on docs IA pages (scripts/ensure_handbook_frontmatter.py), README-derived reference pages (messages, transport, math-safe, Granite tests, runtime boundary).
  • Website smoke scripts (forge-lcdl-website/scripts/check-generated-site.py, verify-hosting-target.sh) and CI wiring for handbook builds.
  • Contract JSON task_id / version on every sidecar with audit_contract_docs.py --require-contract-identity + --min-schema-depth L2 alias.
  • Task catalog generator emits schema_depth, has_examples, supports_fake_transport, live_optional columns.
  • Diagram regression coverage (--verify-rendered-diagrams) plus overview pointer for legacy mcp-sidecar filenames (docs/agents/sidecar-overview.md).
  • Contribution templates: MASTER-REMEDIATION-REPORT.md, migration-guides.md, expanded operational/production checklists.

Changed

  • forge-autodoc handbook builds support optional homepage Markdown (handbook_homepage_md_rel) and grouped sidebar ordering (handbook_sidebar_group_order); root README.md emits as repository-readme.html when a docs homepage is set.
  • LCDL handbook generator passes homepage + IA ordering; internal link check fails the build on unresolved .md targets.

Fixed

  • Resolved duplicate handbook slug for MCP sidecar overview (docs/agents/sidecar-overview.md vs MCP-SIDECAR.md).
  • Clarified pw_chunk_classify cookbook output: model JSON uses chunk_results; Ok.value exposes merged chunks.