How musubipapi/computah works
Computah is a macOS voice-controlled app that turns speech (or debug-typed commands) into checked actions in the frontmost app. Its documented flow runs from turn capture through accessibility observation, Jev choice, guarded native input, and post-action verification, with checkpoints and bounded recovery. The graph preserves UI, diagnostics, and model-cost capabilities. Several internal implementations are unsampled; those branches use documented behavior or indexed references, and uncertain wiring is omitted.
Main entry points: CommandEngine.swift Command engine · App.swift App coordinator · Voice.swift Voice session · CommandCoordinator.swift Command coordinator
Components 25
Mac app
- App coordinator
Sources/Computah/App.swift - Notch panel
Sources/Computah/UI/NotchPanel.swift - Debug panel
Sources/Computah/UI/DebugPanel.swift - Run history
Sources/Computah/Diagnostics/RunHistory.swift - Jev cost store
Sources/Computah/Diagnostics/JevCostStore.swift - Diagnostic output
Sources/Computah/Diagnostics/DiagnosticOutput.swift
Speech input
- Voice session
Sources/Computah/Voice.swift - Turn identity
Sources/ComputahCore/Language/SpeechTurnIdentity.swift
Accessibility
- AX reader
Sources/ComputahCore/Accessibility/AXReader.swift - Control grouping
Sources/ComputahCore/Accessibility/AXGrouping.swift - Native actions
Sources/ComputahCore/Accessibility/AXActor.swift - App routing
Sources/ComputahCore/AppRouting.swift
Command execution
- Command coordinator
Sources/ComputahCore/Commands/CommandCoordinator.swift - Command engine
Sources/ComputahCore/Commands/CommandEngine.swift - Task workflow
Sources/ComputahCore/Commands/Workflow.swift - Task checkpoint
Sources/ComputahCore/Commands/WorkflowCheckpoint.swift - Bounded recovery
Sources/ComputahCore/Commands/Recovery.swift - Result evidence
Sources/ComputahCore/Commands/VerificationEvidence.swift
Jev language
- Command language
Sources/ComputahCore/Language/CommandLanguage.swift - Jev selector
Sources/ComputahCore/Language/JevChoice.swift - Sensitive text
Sources/ComputahCore/Diagnostics/SensitiveText.swift
Other components
- User
- Deepgram Flux
- TypeSafe Jev
- Frontmost app
Connections 33
- User → Notch panel: toggles listening
- User → Debug panel: types command
Sources/Computah/UI/DebugPanel.swift - Notch panel → App coordinator: controls
Sources/Computah/App.swift - Debug panel → App coordinator: submits command
Sources/Computah/App.swift - App coordinator → Voice session: starts session
Sources/Computah/App.swift - Voice session → Deepgram Flux: streams audio
README.md - Deepgram Flux → Voice session: returns turns
README.md - Voice session → Turn identity: identifies turns
README.md - Voice session → Command coordinator: submits final turn
Sources/Computah/App.swift - App coordinator → Command coordinator: submits command
Sources/Computah/App.swift - Command coordinator → Command engine: prepares action
Sources/ComputahCore/Commands/CommandCoordinator.swift - Command coordinator → Task workflow: runs task
Sources/ComputahCore/Commands/Workflow.swift - Command coordinator → Task checkpoint: retains progress
Sources/ComputahCore/Commands/CommandCoordinator.swift - Task workflow → Task checkpoint: records progress
Sources/ComputahCore/Commands/Workflow.swift - Command engine → AX reader: reads controls
Sources/ComputahCore/Commands/CommandEngine.swift - Command engine → App routing: finds apps
Sources/ComputahCore/Commands/CommandEngine.swift - AX reader → Frontmost app: observes controls
README.md - AX reader → Control grouping: provides snapshot
Sources/ComputahCore/Accessibility/AXReader.swift - Command engine → Control grouping: groups choices
Sources/ComputahCore/Commands/CommandEngine.swift - Command engine → Command language: interprets command
Sources/ComputahCore/Commands/CommandEngine.swift - Command language → Jev selector: asks selector
Sources/ComputahCore/Language/CommandLanguage.swift - Jev selector → TypeSafe Jev: sends judgments
README.md - TypeSafe Jev → Jev selector: returns decisions
README.md - Command language → Sensitive text: protects text
Sources/ComputahCore/Language/CommandLanguage.swift - Command engine → Native actions: performs checked action
Sources/ComputahCore/Commands/CommandEngine.swift - Native actions → Frontmost app: sends input
README.md - Command engine → Bounded recovery: requests reread
Sources/ComputahCore/Commands/CommandEngine.swift - Task workflow → Result evidence: checks outcome
Sources/ComputahCore/Commands/Workflow.swift - Result evidence → AX reader: checks observed state
README.md - App coordinator → Run history: records results
Sources/Computah/App.swift - Debug panel → Jev cost store: shows cost total
Sources/Computah/UI/DebugPanel.swift - App coordinator → Diagnostic output: emits diagnostics
Sources/Computah/Diagnostics/DiagnosticOutput.swift - Run history → Debug panel: supplies review
Sources/Computah/Diagnostics/RunHistory.swift