How jasonkerama-dev/ampersand works
Ampersand combines a browser-based graph IDE with a C++ DataGraph compiler. The main workflow is to edit a graph on the canvas, save it through the API, and compile it to receive execution results. The compiler’s documented stages include graph ordering, bounded lifecycle evaluation, arena and immutable-memory rules, and termination checks. The source excerpts show the API’s graph serialization and compiler invocation; compiler internals and some browser interactions are described in the README rather than excerpted here.
Main entry points: CanvasController.php Canvas API · Project.php Projects · main.cpp C++ compiler · canvas.blade.php Canvas view
Components 18
Canvas IDE
- Canvas view
resources/views/canvas.blade.php - Canvas editor
public/canvas.js
Web API
- Web routes
routes/web.php - Canvas API
app/Http/Controllers/CanvasController.php
Graph persistence
- Projects
app/Models/Project.php - Function nodes
app/Models/FnNode.php - Variables
app/Models/Variable.php - Immutables
app/Models/Immutable.php - Graph connections
app/Models/Connection.php - Application database
database/migrations - User accounts
app/Models/User.php
Compiler engine
- C++ compiler
compiler/main.cpp - Compile results
compiler/main.cpp - Graph ordering
compiler/main.cpp - Lifecycle engine
compiler/main.cpp - Memory arena
compiler/main.cpp - WORM semantics
compiler/main.cpp
Other components
- IDE user
Connections 20
- IDE user → Canvas view: opens IDE
README.md - Canvas view → Canvas editor: hosts editor
README.md - Canvas editor → Web routes: calls API
- Web routes → Canvas API: routes requests
routes/web.php - Canvas API → Projects: loads and saves
app/Http/Controllers/CanvasController.php - Canvas API → Function nodes: saves nodes
app/Http/Controllers/CanvasController.php - Canvas API → Variables: saves nodes
app/Http/Controllers/CanvasController.php - Canvas API → Immutables: saves nodes
app/Http/Controllers/CanvasController.php - Canvas API → Graph connections: saves edges
app/Http/Controllers/CanvasController.php - Projects → Function nodes: has many
app/Models/Project.php - Projects → Variables: has many
app/Models/Project.php - Projects → Immutables: has many
app/Models/Project.php - Projects → Graph connections: has many
app/Models/Project.php - Canvas API → C++ compiler: invokes compiler
app/Http/Controllers/CanvasController.php - C++ compiler → Graph ordering: orders graph
README.md - C++ compiler → Lifecycle engine: evaluates cycles
README.md - Lifecycle engine → Memory arena: uses arena
README.md - Lifecycle engine → WORM semantics: enforces writes
README.md - C++ compiler → Compile results: returns results
compiler/main.cpp - Canvas API → Compile results: returns JSON
app/Http/Controllers/CanvasController.php