DocForge2/CHANGELOG.md

Changelog

Notable changes in the DocForge product line are recorded here. Historical milestone evidence remains in docs/MILESTONE_*_BASELINE.md and docs/MILESTONE_*_CLOSEOUT.md.

Unreleased

DocForge 1.4.0 release candidate

Version 1.4.0 is frozen as an additive successor release. The annotated tag and Forgejo release do not exist yet; Milestone 5 remains active until the final documentation-bearing commit passes the fresh-clone gate and publication is verified.

Added:

• One authoritative version shared by package metadata, Python, CLI, generic MCP, reference MCP, viewer manager, generated client bindings, and release checks.
• Public adapter SDK and complete graph-plus-Logic conformance checks.
• Base Python and optional JavaScript, TypeScript, and C++ reference adapters.
• Task-shaped retrieval, generation diffs, generated client configuration, doctor checks, and bounded response continuation.
• Independent manual, portable-graph, and live-viewer projections with immutable packages, receipts, policy enforcement, and accessibility gates.
• Maintained compatibility, migration, concurrency, recovery, representative-task, fresh-wheel, artifact-reproducibility, secret-scan, and benchmark gates.
• MIT licensing and Forgejo repository metadata.

Changed:

• Warm graph reads use generation-bound SQLite state without reparsing canonical project sources.
• Incremental adapters use bounded extraction caches while retaining a complete-build equivalence oracle.
• Generated client configuration is bound to the exact DocForge version.
• Derived publication uses durable atomic replacement and fails closed on malformed, foreign, stale, oversized, or incompatible state.
• Generic canonical application uses project-owned locking, compare-and-swap publication, and exact-hash proposal checks while preserving raced source data.

Compatibility:

• The docforge distribution and Python package, docforge CLI, docforge-mcp, MCP tool names, legacy one-method adapters, generic projects, and descriptor schema version 1 remain supported.
• Version 1.4.0 rebuilds disposable version-1 indexes as version 3 without rewriting canonical source or active proposal bytes.
• The base wheel has no Tree-sitter dependency. Optional language extras remain explicit.

Release channels:

• The intended release channel is the public Forgejo repository and its release artifacts.
• PyPI publication is not planned because the docforge name is occupied by an unrelated project.

1.0.0 - 2026-07-25

The first stable release established the project-scoped graph, generic Markdown/TOML adapter, SQLite index, project-bound CLI and MCP server, reviewable exact-hash changesets, declared manual rendering, visualization, and the original versioned compatibility surface.