Skip to content

docs: clarify planning and change detection - #31

Merged
kvlonge merged 1 commit into
mainfrom
docs/change-awareness
Sep 9, 2026
Merged

kvlonge merged 1 commit into
mainfrom
docs/change-awareness

Conversation

@kvlonge

@kvlonge kvlonge commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

Why

Planning and change-detection documentation had become centred on “pruning” and --changes-only, even though direct mode no longer supports changed-only execution. That mixed the general planning contract with virtual-environment behavior and made normal direct planning harder to understand.

Changes

  • rewrite the planning overview around selection, plan evidence, change reasons, cascades, incremental actions, coherence, and recorded state
  • state clearly that direct mode executes its selected scope without stale filtering
  • move substantive --changes-only, stale-driven execution, configuration precedence, and run_despite_unchanged guidance to Virtual Environments → Building
  • distinguish direct warehouse facts from VDE-scoped state
  • update source freshness, project configuration, CLI, homepage, and comparison references to match the boundary
  • remove “pruning” language outside the janitor cleanup documentation

Verification

  • reviewed behavior against current SQLBuild direct and virtual planners
  • checked all internal Markdown routes
  • git diff --check
  • public-repository hygiene scan

@kvlonge
kvlonge enabled auto-merge (squash) September 9, 2026 09:58
@kvlonge
kvlonge merged commit 86a9473 into main Sep 9, 2026
3 checks passed
@kvlonge
kvlonge deleted the docs/change-awareness branch September 9, 2026 09:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant