Skip to content

docs(spec): an expansion reconciles its child set instead of rebuilding it - #36

Open
delchev wants to merge 1 commit into
mainfrom
docs/expansion-reconcile
Open

docs(spec): an expansion reconciles its child set instead of rebuilding it#36
delchev wants to merge 1 commit into
mainfrom
docs/expansion-reconcile

Conversation

@delchev

@delchev delchev commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

Follows intent-specification proposal 0023 — leave this open until that is accepted.

The expansions section said only that "a span change replaces the generated child set". That permits the destructive implementation: delete every row pointing at the master, then recreate the set. The reaction's writes each commit on their own, so an interrupted recreation destroys committed rows — the failure described in the proposal.

The section now states the diff (missing periods added, rows whose period fell out deleted, the rest kept with their identifiers and edits) and carries the normative block in the site's ::: info Normative form. npx vitepress build docs passes.

🤖 Generated with Claude Code

…ng it

A span change is applied as a diff - the missing periods are added, the rows
whose period the span no longer covers are deleted, and the rows it still
covers are kept with their identifiers. Deleting the whole set before
recreating it destroys committed rows whenever the recreation is interrupted.

Follows intent-specification proposal 0023.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
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