How mcpride/susi-the-cat works
Susi is a Rust computer-assisted translation tool for editing Sisulizer .slp projects and scanning/building localized resource files. The main workflow is to open or create a project, scan its sources into a shared translation model, edit and validate translations, then save or export them; the GUI and SlMake-compatible CLI expose that core. Separate capabilities include translation memory, exchange formats, pseudo-translation, and Git-based collaboration. The graph reflects documented capabilities and shown module references; some subsystem-to-runtime links are omitted where sampled source does not establish the call.
Main entry points: model.rs Project model · app.rs GUI state · flow.rs Workflow engine · forge.rs Forge interface
Components 27
User interfaces
- Desktop GUI
apps/susi/src/main.rs - GUI state
apps/susi/src/app.rs - GUI actions
apps/susi/src/actions.rs - Editing dialogs
apps/susi/src/dialogs.rs - CLI entry
apps/susi-cli/src/main.rs - CLI arguments
apps/susi-cli/src/args.rs - CLI tasks
apps/susi-cli/src/tasks.rs
Translation core
- Project model
crates/core/src/model.rs - SLP persistence
crates/core/src/slp.rs - Resource formats
crates/core/src/formats - Scan and build
crates/core/src/ops.rs - Validation
crates/core/src/validate.rs - Translation filters
crates/core/src/filter.rs - Import and export
crates/core/src/exchange.rs - Translation memory
crates/core/src/tm.rs - Statistics
crates/core/src/stats.rs - Pseudo-translation
crates/core/src/pseudo.rs
Git workflow
- Workflow UI
apps/susi/src/workflow_ui.rs - Workflow engine
crates/workflow/src/flow.rs - Git operations
crates/workflow/src/git.rs - Forge interface
crates/workflow/src/forge.rs - GitHub client
crates/workflow/src/github.rs - GitLab client
crates/workflow/src/gitlab.rs
Agent interface
- MCP server
crates/mcp/src/server.rs
Other components
- Translator
- AI agent
- Git hosting service
Connections 26
- Translator → Desktop GUI: uses
README.md - Desktop GUI → GUI state: starts
apps/susi/src/main.rs - GUI state → GUI actions: dispatches
apps/susi/src/app.rs - GUI state → Editing dialogs: uses
apps/susi/src/app.rs - GUI actions → Editing dialogs: opens
apps/susi/src/actions.rs - GUI state → Project model: holds
- Translator → CLI entry: uses
README.md - CLI entry → CLI arguments: parses
- CLI arguments → CLI tasks: selects
apps/susi-cli/src/lib.rs - CLI tasks → Project model: operates on
- Project model → SLP persistence: reads and writes
README.md - Resource formats → Project model: maps resources
crates/core/src/formats/mod.rs - Scan and build → Resource formats: scans and builds
- Scan and build → Project model: updates
- Validation → Project model: checks
crates/core/src/validate.rs - Import and export → Project model: imports and exports
crates/core/src/exchange.rs - Translator → Workflow UI: requests collaboration
README.md - Workflow UI → Workflow engine: runs actions
- Workflow engine → Git operations: uses
crates/workflow/src/flow.rs - Workflow engine → Forge interface: uses
crates/workflow/src/flow.rs - Forge interface → GitHub client: selects client
crates/workflow/src/forge.rs - Forge interface → GitLab client: selects client
crates/workflow/src/forge.rs - GitHub client → Git hosting service: calls API
- GitLab client → Git hosting service: calls API
- AI agent → MCP server: sends requests
README.md - MCP server → CLI tasks: exposes tasks