{"id":30805530,"url":"https://github.com/aaronsb/semantic-petri-net","last_synced_at":"2025-09-06T00:58:48.043Z","repository":{"id":298372438,"uuid":"999733016","full_name":"aaronsb/semantic-petri-net","owner":"aaronsb","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-10T19:19:50.000Z","size":28,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-10T19:59:31.616Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aaronsb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-10T17:45:50.000Z","updated_at":"2025-06-10T19:19:54.000Z","dependencies_parsed_at":"2025-06-10T20:09:44.868Z","dependency_job_id":null,"html_url":"https://github.com/aaronsb/semantic-petri-net","commit_stats":null,"previous_names":["aaronsb/semantic-petri-net"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/aaronsb/semantic-petri-net","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronsb%2Fsemantic-petri-net","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronsb%2Fsemantic-petri-net/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronsb%2Fsemantic-petri-net/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronsb%2Fsemantic-petri-net/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aaronsb","download_url":"https://codeload.github.com/aaronsb/semantic-petri-net/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronsb%2Fsemantic-petri-net/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273842828,"owners_count":25177921,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-05T02:00:09.113Z","response_time":402,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-09-06T00:58:45.491Z","updated_at":"2025-09-06T00:58:48.018Z","avatar_url":"https://github.com/aaronsb.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Semantic Petri Net Pattern Discovery\n\nThis repository documents the discovery of Petri net patterns while building the Targetprocess MCP Server, and demonstrates why traditional AI agents struggle with enterprise workflows.\n\n## Overview\n\nWhile building a Model Context Protocol (MCP) server for Targetprocess, we discovered that semantic hints and multi-entry workflows naturally align with Petri net theory. This explains why FSM-based AI agents fail at complex workflows - they're using the wrong computational model.\n\n## Repository Contents\n\n### 📄 Research Paper\n- [`paper.md`](paper.md) - Main research paper documenting our journey from API wrapper to Petri net patterns\n\n### 🧪 Workflow Navigator Simulators\n- [`simulator/`](simulator/) - Comparison of FSM vs Petri net navigation approaches\n  - [`simulator/README.md`](simulator/README.md) - Overview of the simulators\n  - [`simulator/test-methodology.md`](simulator/test-methodology.md) - Experimental design and hypotheses\n  - [`simulator/test-harness-explanation.md`](simulator/test-harness-explanation.md) - How the test simulation works\n  - [`simulator/claude-testing-guide.md`](simulator/claude-testing-guide.md) - Guide for testing with Claude\n\n### 📊 Test Results\n- [`simulator/test-results.json`](simulator/test-results.json) - Performance comparison data showing 6.75x efficiency gain\n\n### 🔧 Implementation\n- [`simulator/fsm-navigator/`](simulator/fsm-navigator/) - Traditional FSM approach (JavaScript)\n- [`simulator/petri-navigator/`](simulator/petri-navigator/) - Petri net approach with SNAKES (Python)\n\n## Key Findings\n\n1. **Semantic hints pattern** reduces navigation complexity by 80-90%\n2. **Multi-entry workflows** eliminate hierarchical navigation overhead\n3. **Petri net patterns** naturally emerge when building workflow tools\n4. **FSM limitations** are architectural, not implementation-specific\n\n## Quick Start\n\nTo run the comparison test:\n\n```bash\ncd simulator\n./setup.sh        # Install dependencies\n./run-test.sh     # Run performance comparison\n```\n\n## Development Guidelines\n\nSee [`CLAUDE.md`](CLAUDE.md) for project-specific instructions on maintaining research integrity and grounding claims in actual implementation experience.\n\n## License\n\nGPL-3.0 License - see [`LICENSE`](LICENSE) for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faaronsb%2Fsemantic-petri-net","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faaronsb%2Fsemantic-petri-net","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faaronsb%2Fsemantic-petri-net/lists"}