Document the 1.4.0 release candidate

CHANGELOG.md

@@ -0,0 +1,57 @@
+# 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.