Skip to content

Add a static Petri-net lesson under web/ - #3

Merged
cursor[bot] merged 1 commit into
mainfrom
cursor/public-petri-lesson-9227
Oct 20, 2026
Merged

cursor[bot] merged 1 commit into
mainfrom
cursor/public-petri-lesson-9227

Conversation

@kevindadi

Copy link
Copy Markdown
Owner

Summary

Adds a static English lesson at web/ for developers who have not used Petri nets. There is no build step and no backend. The page is a step-through of the nets, not a status dashboard.

It animates:

  • one firing: a token leaves ready and mutex and appears in held
  • AB-BA deadlock: after each thread takes its first lock, both mutex places are empty, no transition is enabled, and main_end has no token
  • data race: UnsafeWrite and UnsafeRead are enabled together in one marking on location L
  • atomicity: AV1, AV2, or AV3, a remote AtomicStore strictly between one thread's load/store interval on the same alias
  • the pipeline MIR → call graph → Petri net → reduce → state graph → detectors
  • where translation (src/translate/), the unipn net library, and the detectors (src/detect/) sit

The coverage matrix and the async todolist are not on this page. README paths src/net and src/analysis are called out as absent; net types, reduction, and StateGraph come from unipn.

GitHub Pages

Pages goes live only after merge. This pull request branch does not publish the site.

After the change is on main, turn the site on under Settings → Pages → Build and deployment:

  • Source: Deploy from a branch
  • Branch: main
  • Folder: /web

The project URL is https://kevindadi.github.io/ConcBugDect-Rust/. Local preview is in web/README.md.

License

MIT, same as the repository. Copyright (c) 2025 Kaiwen Zhang. See web/LICENSE.

What the figures show

One firing, token now in held
AB-BA deadlock marking
Data race, both accesses enabled
AV1 atomicity witness

To show artifacts inline, enable in settings.

Open in Web Open in Cursor 

The web/ site walks through one firing, then deadlock, data race, and atomicity violation, plus where translation, unipn, and the detectors sit.

Co-authored-by: zhangkevin <[email protected]>
@kevindadi
kevindadi marked this pull request as ready for review October 20, 2026 11:22
@cursor
cursor Bot merged commit 08404b8 into main Oct 20, 2026
4 checks passed
@kevindadi
kevindadi deleted the cursor/public-petri-lesson-9227 branch October 20, 2026 11:31
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.

2 participants