docs: replace vague provenance prose with recorded facts

This commit is contained in:
Turtle
2026-08-09 15:35:02 +08:00
parent 8c124f84b6
commit 9704749b01
380 changed files with 946 additions and 874 deletions

View File

@@ -363,7 +363,7 @@ export class WorkspaceRegistry extends Service {
/**
* Complete the one mutation explicitly named by durable state. Unexplained
* order/table divergence still reaches {@link validateStoredState} and
* fails loud; this path never infers provenance from shape alone.
* fails loud; this path never guesses which operation created a row from its shape alone.
*/
private async recoverPendingMutation(): Promise<void> {
const state = this.requireState()
@@ -608,7 +608,7 @@ export class WorkspaceRegistry extends Service {
private enqueueOperation<T>(operation: () => Promise<T>): Promise<T> {
const result = this.operationTail.then(async () => {
// A committed delete may leave only its marker cleanup pending. Retry
// recovery before another create/delete can overwrite that provenance.
// recovery before another create/delete can overwrite that pending operation record.
await this.recoverPendingMutation()
return await operation()
})