24 lines
781 B
Markdown
24 lines
781 B
Markdown
# US04-02 — Journal Rename State and Preconditions
|
|
|
|
Epic: [E04](../E04-guarded-renaming.md)
|
|
|
|
As an operator, I want every rename transition journaled durably so interrupted work
|
|
can be diagnosed and recovered without guessing.
|
|
|
|
## Acceptance criteria
|
|
|
|
- Plan and item state machines record preconditions, intent, attempts, outcomes,
|
|
timestamps, fencing tokens, and verification evidence.
|
|
- Journal writes occur before filesystem mutations and terminal transitions are
|
|
idempotent.
|
|
- Startup classifies incomplete transitions as resumable, rollback-safe, or manual.
|
|
|
|
## Automated tests
|
|
|
|
- State-machine tests cover all valid/invalid transitions and repeated recovery.
|
|
- Migration/repository tests prove durable state after process restart.
|
|
|
|
## Dependencies
|
|
|
|
- US04-01, US02-03
|