Changelog

Generated by releaseledger. Manual edits may be overwritten. Update releaseledger entries and rebuild this file instead.

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[v0.2.0] - 2026-07-28

Command catalog and CLI support modules for centralized command registration and version handling (Architecture: CLI structure and errors)
Structured error handling module with typed exceptions for better diagnostics (Architecture: CLI structure and errors)
Launcher module for unified entry point configuration (Architecture: CLI structure and errors)
Modular CLI architecture with dedicated command modules for documents, sources, links, storage, migration, configuration, and schema management (Architecture: CLI structure and errors)

CLI entry point refactored to use modular command groups with canonical singular naming (document, source, link) (Usage: Link documentation to sources)
Upgraded ledgercore dependency from 0.5.0 to 0.6.0 with schema-3 canonical initialization (Architecture: Storage model)
Migrated releaseledger and taskledger storage to unified .ledger/ directory structure (Architecture: Storage model)
Updated README and documentation with new CLI command structure and migration guides (Bootstrap: Setup sequence)

New sources list CLI with filtering, pagination, and compact ids-only output (Usage: Link documentation to sources)
New docs sections --outline compact section listing (Usage: Link documentation to sources)
New links import-map command with directory batch mode, validate-only dry run, and replace-section support (Usage: Link documentation to sources)
New links propose --all-docs --out-dir for auto-generated mapping proposals (Usage: Link documentation to sources)
New coverage command for reviewing link coverage inventory (Usage: Link documentation to sources)
Build context selectors for bootstrap, doc/section, affected, and max-bytes truncation (Usage: Link documentation to sources)

Storage layer rewritten with atomic staged writes, source index separation, and ledgercore integration (Architecture: Storage model)
Read-only CLI commands no longer mutate storage metadata (Architecture: Storage model)
Scan schema bumped to v5 with separate source-index.json and SHA-256 hash verification (Architecture: Scanning algorithm)
Doc index parser now ignores headings inside fenced code blocks (Architecture: Scanning algorithm)
CLI pagination with cursor-based offset, and structured error for invalid cursors (Usage: Link documentation to sources)
Reworked SKILL.md with entry protocol, bootstrap branch, incremental branch, and completion gate (Bootstrap: Setup sequence)
Added CommandState caching for scan, source index, and doc records to reduce redundant I/O (Architecture: Scanning algorithm)
Added test suites for build context selectors, CLI pagination, doc index, links batch, scan incremental, storage read-only, and workflow extras (Usage: Link documentation to sources)
Updated conftest with JSON helpers and storage snapshot hashing (Architecture: Scanning algorithm)