How alouetter/alavette-form works
Alavette Form is a local-first Windows document production workbench. Its main workflow prepares a DOCX and supporting materials, configures a work mode, scene and template, checks risks and completeness, executes formatting, then produces documents and reports for human review. The graph also preserves the assistant’s provider-backed content generation and approved document-job path, plus material-package storage. Some subsystems are represented from README descriptions and indexed references; unsampled implementation details and uncertain links are omitted.
Main entry points: workbench Workbench UI · production_execution.py Production Execution · main.py Application Entry · workers.py Assistant UI
Components 22
Document Workbench
- Application Entry
main.py - CLI Runner
src/cli_runner.py - Workbench UI
src/ui/panels/workbench - Scene Config
src/config/scene.py - Template Config
src/config/template.py
Document Production
- Document Preflight
src/config/object_preflight_evidence.py - Execution Session
src/ui/panels/workbench/execution_session_controller.py - Production Execution
src/services/production_execution.py - Formatting Pipeline
src/pipeline/runner.py - Paragraph Styling
src/modules/basic/paragraph_style.py - Change Reporting
src/report_writer.py - DOCX and Reports
src/services/production_runtime
Materials
- Material Packages
src/domain/materials/model.py - Material Repository
src/infrastructure/materials/repository.py - Content Artifacts
src/services/material_content/artifact_repository.py
Assistant
- Assistant UI
src/assistant/ui/workers.py - Content Generation
src/assistant/application/content_generation_service.py - Provider Turn Runtime
src/assistant/runtime/turn_runner.py - Provider Router
src/assistant/runtime/providers/router.py - Document Job
src/assistant/application/document_job_controller.py
Other components
- User
- Human Review
Connections 21
- User → Application Entry: starts
README.md - Application Entry → CLI Runner: dispatches CLI
main.py - Application Entry → Workbench UI: opens GUI
main.py - User → Workbench UI: prepares document
README.md - Workbench UI → Scene Config: selects scene
README.md - Workbench UI → Template Config: selects template
README.md - Workbench UI → Document Preflight: checks risks
README.md - Workbench UI → Execution Session: starts execution
src/ui/panels/workbench/execution_session_controller.py - Execution Session → Production Execution: runs request
src/ui/panels/workbench/execution_session_controller.py - Production Execution → Formatting Pipeline: executes formatting
- Formatting Pipeline → Paragraph Styling: applies styles
- Production Execution → Change Reporting: writes reports
- Production Execution → DOCX and Reports: produces files
README.md - DOCX and Reports → Human Review: reviewed by
README.md - Material Repository → Material Packages: uses domain
src/infrastructure/materials/repository.py - Content Artifacts → Material Packages: stores compiled materials
- Assistant UI → Content Generation: runs generation
src/assistant/ui/workers.py - Content Generation → Provider Turn Runtime: uses turn runtime
src/assistant/application/content_generation_service.py - Provider Turn Runtime → Provider Router: routes provider
- Assistant UI → Document Job: runs document job
src/assistant/ui/workers.py - Document Job → Production Execution: executes approved plan