How samudralaajaykumarrr/failuremesh works
FailureMesh turns known failure mechanisms into bounded experiments and machine-checked evidence. The primary workflow is an engineer invoking the CLI to match a Portable Failure Contract (PFC) against an Architecture Contract (AC), compile and safety-plan an experiment, execute it, and receive a verifier verdict with evidence. Separate CLI branches model duplicate delivery, stale-worker fencing, and two historical incidents. The local corpus register supports manual metadata intake and immutable manifests. The graph follows documented capabilities; wiring for unsampled subsystems is shown only where the README or sampled code supports it.
Main entry points: main.go FailureMesh CLI · corpus.go Corpus command · phase1/run.go Phase 1 flow · pfc2/run.go Duplicate delivery
Components 17
CLI workflow
- FailureMesh CLI
cmd/failuremesh/main.go - PFC and AC
internal/phase1/contracts.go - Versioned PFC contracts
contracts
Failure experiments
- Phase 1 flow
internal/phase1/run.go - Duplicate delivery
internal/pfc2/run.go - Stale-worker fencing
internal/pfc3/run.go - Iceberg reproduction
internal/historical/iceberg16282/model.go - GitHub cascade
internal/historical/githubmay4/model.go - Verifier verdict
internal/phase1/run.go
Evidence and corpus
- Corpus command
cmd/failuremesh/corpus.go - Corpus records
internal/corpus/model.go - Corpus validation
internal/corpus/semantics.go - Corpus store
internal/corpus/store.go - Evidence assessment
internal/evidence/assess.go - Evidence validation
internal/evidence/validate.go
Runtime state
- PostgreSQL
Other components
- Engineer
Connections 20
- Engineer → FailureMesh CLI: invokes
- FailureMesh CLI → PFC and AC: loads and matches
- FailureMesh CLI → Phase 1 flow: compiles, plans, runs
- Phase 1 flow → Verifier verdict: verifies evidence
- Phase 1 flow → PostgreSQL: reads and writes
- FailureMesh CLI → Duplicate delivery: runs PFC 2
- Duplicate delivery → PostgreSQL: reads and writes
- FailureMesh CLI → Stale-worker fencing: runs PFC 3
- Stale-worker fencing → PostgreSQL: reads and writes
- FailureMesh CLI → Iceberg reproduction: runs reproduction
- Iceberg reproduction → PostgreSQL: reads and writes
- FailureMesh CLI → GitHub cascade: runs reproduction
- GitHub cascade → PostgreSQL: reads and writes
- FailureMesh CLI → Corpus command: dispatches corpus
- Corpus command → Corpus records: processes records
- Corpus command → Corpus validation: validates corpus
- Corpus command → Corpus store: publishes and reads
- Corpus validation → Corpus records: checks semantics
- Evidence assessment → Evidence validation: validates inputs
- Versioned PFC contracts → PFC and AC: defines contract