Skip to content

docs(cli): map and verify state machines - #134

Open
callumflack wants to merge 1 commit into
mainfrom
callum/cli-state-machine-verification
Open

callumflack wants to merge 1 commit into
mainfrom
callum/cli-state-machine-verification

Conversation

@callumflack

Copy link
Copy Markdown
Member

Map the CLI workflows that retain state across commands, interruptions, and retries. The inventory links each lifecycle to its owner. Eight statecharts cover owner collection, queued exports, builder setup, paid reads, mainnet registration, local server supervision, and hosted provisioning.

Add seven runnable bounded verifiers. Five come from the state-machine audit and two carry forward the existing setup/resume and paid-read proof. Each runs from a public main snapshot with controlled replay fixtures. This PR adds verification and documentation.

The replay shows two current behaviors. Stop during a restart port probe can launch a replacement briefly. A signed Connect API delete during hosted provisioning can remove the tracking row while the create later returns 201. The hosted replay uses a fake provider and in-memory store.

Validation

  • Ran all seven verifier commands against main at a55d0a0. Each produced its expected verdict, including the two counterexamples and their scratch guards.
  • Checked formatting and the staged diff.

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