How sunniie/nexcanvas-drawio works
NexCanvas turns a brief or repository into an evidence-backed semantic diagram model, builds an editable Draw.io artifact, and checks its rendered quality before postflight seals delivery hashes. The README documents additional repository-sync, asset, extension, conformance, benchmark, and stable-contract capabilities. Pipeline and builder excerpts support some stage wiring; other subsystem links are limited to documented responsibilities because their implementations were not sampled.
Main entry points: pipeline.py Stage pipeline · builder.py Draw.io builder · rendering.py Rendering · cli.py CLI
Components 24
Diagram workflow
- CLI
src/nexcanvas/cli.py - Stage pipeline
src/nexcanvas/pipeline.py - Project state
src/nexcanvas/project.py - Geometry and routing
src/nexcanvas/layout.py - Draw.io builder
src/nexcanvas/builder.py - Editable Draw.io
Semantic modeling
- Intent and routing
src/nexcanvas/intents.py - Layout planning
src/nexcanvas/planning.py - Semantic model
src/nexcanvas/model_v3.py - Model contracts
src/nexcanvas/contracts.py
Quality and rendering
- Diagram QA
src/nexcanvas/quality.py - Collision QA
src/nexcanvas/geometry.py - Rendering
src/nexcanvas/rendering.py - Visual inspection
src/nexcanvas/visual.py - Delivery postflight
src/nexcanvas/postflight.py
Supporting capabilities
- Repository analysis
src/nexcanvas/repository_analysis.py - Evidence verification
src/nexcanvas/repository.py - Semantic sync
src/nexcanvas/semantic_sync.py - Asset management
src/nexcanvas/assets.py - Trusted extensions
src/nexcanvas/extensions.py - Agent conformance
src/nexcanvas/conformance.py - Visual benchmarks
src/nexcanvas/benchmarks.py
Other components
- Engineer or agent
- Draw.io Desktop
Connections 30
- Engineer or agent → CLI: requests diagram
- CLI → Stage pipeline: runs stages
- Stage pipeline → Project state: tracks state
- Stage pipeline → Intent and routing: resolves view
- Stage pipeline → Layout planning: brainstorms layout
- Stage pipeline → Geometry and routing: places elements
- Stage pipeline → Draw.io builder: builds artifact
- Stage pipeline → Diagram QA: checks model
- Stage pipeline → Collision QA: checks collisions
- Stage pipeline → Rendering: renders preview
- Stage pipeline → Visual inspection: reviews preview
- Stage pipeline → Delivery postflight: seals delivery
- Intent and routing → Semantic model: sets view intent
- Layout planning → Geometry and routing: selects composition
- Geometry and routing → Draw.io builder: provides geometry
- Draw.io builder → Asset management: embeds local assets
- Draw.io builder → Editable Draw.io: writes XML
- Draw.io builder → Trusted extensions: loads adapters
- Stage pipeline → Model contracts: validates contracts
- CLI → Repository analysis: analyzes repository
- Repository analysis → Evidence verification: pins source facts
- Repository analysis → Semantic sync: projects semantic changes
- Semantic sync → Semantic model: merges semantics
- Evidence verification → Model contracts: verifies evidence
- Rendering → Editable Draw.io: reads diagram
- Rendering → Draw.io Desktop: renders through
- Rendering → Visual inspection: produces preview
- Visual inspection → Delivery postflight: provides review
- Agent conformance → Trusted extensions: supports host adapters
- Visual benchmarks → Diagram QA: gates quality