v2.0.0
DeepDoc 2.0.0 introduces precise incremental updates (no more full replans on large commits), a commit changelog page, and MDX quality improvements.
Added
- Incremental-only updates —
deepdoc updateno longer triggers a full replan regardless of how many files changed. Deleted files are handled in-place: orphaned buckets are cleaned up, partially-emptied buckets are marked stale and regenerated. Full replan is only triggered by an explicit--forceflag or an engine fingerprint mismatch. - Commit changelog — every
generateandupdaterun appends an entry to.deepdoc/changelog.json(newest-first, capped at 50). Adocs/whats-changed.mdxpage is regenerated automatically after each run, showing date, commit message, pages updated, and files changed per run. Thewhats-changedslug is auto-injected into theStart Herenav section. - Directional navigation — generated pages include prev/next arrows (wired to
findNeighbourfromfumadocs-core) and a "Read first:" callout for pages that have prerequisites (depends_onon the bucket). deepdoc_prereqsfrontmatter — prerequisite slugs are written into MDX frontmatter so the site scaffold can render them as callout links.
Fixed
- MDX
<Accordion>nesting —repair_mdx_component_blocksnow inserts missing</Accordion>tags immediately before</Accordions>rather than appending them at document tail (which produced valid tag counts but invalid nesting). Also strips orphaned</Accordion>that the LLM sometimes emits after</Accordions>.<Accordions type="single">and other attribute variants are now matched correctly. - Stale page cleanup on deletion — deleting source files now immediately removes orphaned
.mdxpages and prunes the ledger rather than waiting for a full reconcile run. - Version warning — the "upgrade recommended" panel now fires only when the docs' major version differs from the installed CLI's major version, and the message correctly says "run
deepdoc generate" rather than "upgrade the CLI" (the CLI is already current; the docs need regenerating).
Changed
ChangeSet.strategyno longer returnsfull_replanfor any number of changed/new/deleted files or endpoint structure changes — all such cases route toincrementalortargeted_replan._handle_deleted_filesis now a first-class pre-step inside_targeted_replan, handling both partial deletions (file removed from bucket's owned list) and full orphan removal (bucket + MDX + ledger entry deleted).