package governance import ( "os" "strings" "testing" ) func TestStateMachineContractSeparatesDimensionsAndReservedStates(t *testing.T) { content, err := os.ReadFile("../../docs/STATE_MACHINE.md") if err != nil { t.Fatalf("read state machine contract: %v", err) } text := string(content) for _, required := range []string{ "## State dimensions", "### Job", "pending | running | retry | completed | failed | cancelled", "### Scope policy", "unset | internal | external | blocked", "historical compatibility value: both", "### Source change", "### Review", "### Content", "### Ingest", "### Processing", "### Retrieval", "### Release", "## Reserved future values", "rolling_back", "must not be persisted before R4", } { if !strings.Contains(text, required) { t.Fatalf("state machine contract is missing %q", required) } } }