Skip to content

Add TLA+ formal model checked on the Oracle runner - #42

Merged
sloik merged 1 commit into
mainfrom
formal/tla-oracle
Nov 13, 2026
Merged

sloik merged 1 commit into
mainfrom
formal/tla-oracle

Conversation

@sloik

@sloik sloik commented Nov 13, 2026

Copy link
Copy Markdown
Owner

Adds a TLA+ formal model of this library's public semantics, checked by TLC on the shared Oracle ARM64 runner.

What's in it

  • formal/*.tla and *.cfg: a finite model with named laws and invariants. formal/README.md maps each invariant to the Swift API it abstracts and states the model's limits.
  • formal/*.<mutant>.cfg: seeded bugs, each of which a named invariant must catch. run_tlc.sh fails if any mutant passes, so the invariants are shown to be able to fail.
  • .github/workflows/oracle-tla.yml: runs formal/run_tlc.sh on [self-hosted, Linux, ARM64, oracle, swift-tla, FunctionalAPI].
    • It runs only on pushes to main and on manual dispatch.
    • A root-owned job-start guard on the host rejects every other ref, event, fork or repo before any step runs.
    • There is no pull_request trigger, and the hosted macOS Swift CI is unchanged.

TLC run on Oracle (this branch)

PASS  FunctionalAPILaws.cfg  (336 distinct states found)
PASS  FunctionalAPILaws.compose_swapped.cfg  (mutant caught by ComposeOrder)
PASS  FunctionalAPILaws.flip_noop.cfg  (mutant caught by FlipSwapsArguments)
TLC summary: 3 passed, 0 failed

After merge

The merge push runs the Oracle job. If it doesn't run, use Actions → Oracle TLA verification → Run workflow on main.

Part of SPEC-ARGO-188 (owner request 2026-11-13). Runner runbook: Argo _System/oracle/swift-tla/README.md.

https://claude.ai/code/session_01HynYeNc83VZiXQP71aaZQ1

formal/ holds a finite TLA+ model of the library's public semantics, seeded
mutants that must be caught, and run_tlc.sh. oracle-tla.yml runs it on the
self-hosted Oracle ARM64 runner only on main pushes and manual dispatch.

Claude-Session: https://claude.ai/code/session_01HynYeNc83VZiXQP71aaZQ1
@sloik
sloik merged commit 0218542 into main Nov 13, 2026
2 checks passed
@sloik
sloik deleted the formal/tla-oracle branch November 13, 2026 12:48
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