Close Milestone 4 with adapter adoption evidence

SLICE_HISTORY.md

@@ -1,5 +1,50 @@
 # Completed slices
 
+## DocForge2 Milestone 4 adapter SDK and product documentation
+
+### Changed
+
+- Added stable `docforge.adapter_sdk` authoring imports and a conformance helper for deterministic
+  complete and exact complete/incremental primary graph plus Logic equivalence.
+- Added bounded Python, JavaScript, TypeScript, and C++ reference integrations with explicit
+  unsupported-fact reports and optional heavy frontends.
+- Added a closed `.docforge/reference-adapter.toml` contract and fixed read-only reference MCP
+  server.
+- Added immutable project-bound launcher declarations and deterministic Codex, Claude, and OpenClaw
+  configuration generation for custom adapters.
+- Generated CLI and MCP references from live implementation metadata and added race-safe
+  publication plus repository drift checks.
+- Added strict documentation-graph and fresh-wheel adoption gates and dedicated onboarding,
+  authority, descriptor, policy, adapter, legacy/no-AST, rendering, agent-integration, security,
+  recovery/performance, and v1 migration guides.
+
+### Verification
+
+- The executable candidate passed 347 tests and 402 subtests, 142 contract tests and 268 subtests,
+  three accessibility flows, lint, strict types, compilation, dependencies, builds, adoption, and
+  every maintained smoke benchmark.
+- The offline base wheel contained no Tree-sitter distribution and ran a real Python reference
+  build/check and isolated 21-tool MCP retrieval flow. Missing C++ support failed with the exact
+  `docforge[cpp]` remediation.
+- The clean 334-source benchmark produced 1,002 nodes and exact full/incremental graph and Logic
+  evidence, warm zero Python parsing/extraction, and exact corrupt-cache and corrupt-index
+  recovery below every latency, memory, and response gate.
+- Gitleaks found no findings in the Milestone 4 commit range or candidate tree.
+
+### Limits
+
+- The reference integrations publish syntax and local static relationships. They do not claim
+  compiler-resolved calls, types, inheritance, macros, runtime behavior, or semantic ownership.
+- C++ compilation-database commands are inert and never executed.
+- C++ manifest include discovery uses Tree-sitter and makes no zero-warm-parser claim.
+- No WorldForge, ScrapeStation, legacy repository, production binding, language distribution,
+  self-hosting, tag, or release was changed.
+
+### Next gate
+
+Milestone 5 remains directional. Create a new active-slice contract before stabilization,
+versioning, tagging, or publication.
+
 ## DocForge2 Milestone 3 independent projections
 
 ### Changed