Static validator for ConcIR (Concurrency Intermediate Representation) — a
statement-level, verification-oriented concurrency IR. Reads a ConcIR JSON
file, runs nine validation passes, and emits a structured diagnostic report.
The downstream cir2cvn translator builds a CVN (Concurrency Verification Net)
from a validated program for state-space exploration.
ConcIR is language-neutral. A program is a set of modules; names are ConcIR
FQNs (module::entity), not backend crate paths. Function bodies are a
flattened CFG: a list of statements. Non-control ops fall through to the
next statement; goto / branch / switch / return / select are
statement kinds that transfer control.
cargo build --release
./target/release/cir examples/producer_consumer.jsonOutput is a JSON ValidationReport:
{
"valid": true,
"diagnostics": []
}If there are errors, valid is false, diagnostics contains all diagnostic
items, and the process exits with exit code 1.
Alongside the static validator, the repository ships a non-LLM backend: a bounded reference interpreter, a colored Petri-net translation, finite-state exploration with safety / deadlock / EF / AG EF properties, structured diagnostics, and a deterministic patch-and-repair loop.
cargo build --release
./target/release/concir-backend explore examples/producer_consumer.json
./target/release/concir-backend explore examples/lockorder_bug.json examples/lockorder_contract.json
./target/release/concir-backend repair examples/lockorder_bug.json examples/lockorder_contract.json| Document | Contents |
|---|---|
doc/backend-design.md |
Operational semantics, Petri nets, contracts, diagnostics, staged plan |
doc/backend-usage.md |
Commands, support matrix, model boundaries, migration |
| Document | Contents |
|---|---|
doc/syntax/ |
Prose grammar, split by top-level construct |
doc/syntax/dataflow.md |
Names, dst, expressions, call vs spawn (ConcIR 3.5) |
doc/ebnf.md |
ISO EBNF abstract syntax |
doc/error_codes.md |
Validation error reference (E0xx–E9xx) and diagnostic output format |
doc/todo.md |
Roadmap: modeling scope, call semantics, modular generation |
skills/ |
Agent skill for generating ConcIR; ./skills/install.sh installs it into Cursor / Claude Code / Codex / OpenCode |
src/
main.rs Entry: read JSON → deserialize → validate → emit report
lib.rs Module declarations
ast.rs IR types (Program, Module, Stmt, Op)
env.rs Per-function name environment
expr.rs Expression parser and type checker
fqn.rs Identifier and FQN rules
typedef.rs Module-level named types
diagnostic.rs Diagnostic types (Diagnostic, ValidationReport)
validate/
mod.rs Validation entry: chains the 9 passes
structure.rs E0xx Structural validity
names.rs E1xx Name resolution and module contracts
types.rs E2xx Type checking (parser-backed)
compat.rs E3xx Resource–operation compatibility
protection.rs E7xx Protection mapping
concurrency.rs E4xx Handle pairing, scope statement
locks.rs E5xx Lock safety (E309 includes expr r-values; E803 requires_held)
interface.rs E8xx Function may_block / locks; imported signatures; bound (E960/E961)
control.rs E6xx Control flow
dataflow.rs E9xx Name env, unified dst, call vs spawn
export/
dot.rs Graphviz DOT from statements / calls / control edges
doc/
syntax/ ConcIR grammar (one page per top-level construct)
ebnf.md ISO EBNF abstract syntax
error_codes.md Error code reference and diagnostic format
todo.md Roadmap
examples/
producer_consumer.json Producer–consumer
async_workers.json Async tasks + semaphore + Channel
with_summary.json Body-less function call chain
state_machine.json State machine + Switch
complex_rwlock.json RwLock + Condvar combined example
skills/
generate-concir/ Agent skill (SKILL.md) for ConcIR generation
install.sh Copy or link the skill into a coding agent
skills/ is the portable source. It is not a client-specific hidden
directory. To make Cursor, Claude Code, Codex, or OpenCode load the
generator skill:
./skills/install.shSee skills/README.md for --scope user, individual
targets, and uninstall.