How sudodevstudio/dittoly works
Dittoly is a self-hosted orchestration platform: Super-Modules connect apps, Flows define approved processes, and the engine executes runs using members’ own access or delegated teammate access. The graph follows that workflow and preserves major documented capabilities, including governance, integrations, and larger Super Flows. Some subsystem links are documented in the README; source-level evidence is limited to the supplied excerpts and SOURCE INDEX, so unsampled wiring is not inferred.
Main entry points: engine.ts Run Engine · service.ts Flow Service · jobs.ts Durable Jobs · registry.ts Super-Modules
Components 25
Flow Design
- AI Drafting
src/ai/generate-flow.ts - Flow Service
src/flows/service.ts - Flow Definitions
src/flows/definition.ts - Super Flows
src/plans/service.ts
Run Execution
- Run Engine
src/engine/engine.ts - Durable Jobs
src/engine/jobs.ts - Sandbox Runner
src/sandbox/engine.ts - Egress Policy
src/runtime/egress.ts
Access Governance
- Flow Approvals
src/governance/approvals.ts - Member Identity
src/core/members.ts - Teams
src/core/teams.ts - Delegated Access
src/engine/engine.ts - Audit Trail
src/core/audit.ts
Integrations
- Super-Modules
src/modules/registry.ts - Module Manifests
src/modules/manifest.ts - MCP Gateway
src/mcp/server.ts - Webhooks
src/webhooks/service.ts - External Watches
src/watches/service.ts
Platform Capabilities
- Data Tables
src/tables/service.ts - Marketplace
src/marketplace/service.ts - Git Sync
src/git-sync/service.ts - Insights
src/insights/service.ts - App Export
src/export/service.ts - PostgreSQL Store
src/db/db.ts
Other components
- Member
Connections 28
- Member → AI Drafting: describes process
README.md - AI Drafting → Flow Service: drafts Flow
README.md - Member → Flow Approvals: approves version
README.md - Flow Service → Flow Approvals: requests approval
src/flows/service.ts - Flow Service → Module Manifests: resolves capabilities
src/flows/service.ts - Member → Run Engine: starts approved run
README.md - Run Engine → Durable Jobs: enqueues advance
src/engine/engine.ts - Durable Jobs → Run Engine: dispatches run work
src/engine/engine.ts - Run Engine → Super-Modules: executes module actions
src/engine/engine.ts - Super-Modules → Module Manifests: validates modules
src/modules/registry.ts - Run Engine → Egress Policy: enforces egress
src/engine/engine.ts - Run Engine → Data Tables: reads and writes rows
src/engine/engine.ts - Member → Member Identity: signs in
README.md - Member Identity → Teams: participates in teams
src/core/teams.ts - Run Engine → Delegated Access: handles run access
src/engine/engine.ts - Flow Service → Durable Jobs: enqueues decisions
src/flows/service.ts - MCP Gateway → Run Engine: starts runs
src/mcp/server.ts - Webhooks → Run Engine: triggers runs
src/webhooks/service.ts - External Watches → Run Engine: starts watched flows
src/watches/service.ts - Marketplace → Super-Modules: uses module catalog
src/marketplace/service.ts - Marketplace → Flow Service: uses Flow catalog
src/marketplace/service.ts - Git Sync → Super-Modules: syncs modules
src/git-sync/service.ts - Git Sync → Durable Jobs: queues work
src/git-sync/service.ts - App Export → Flow Definitions: exports Flow apps
- Run Engine → Audit Trail: records run events
src/engine/engine.ts - Member Identity → PostgreSQL Store: stores identities
src/core/members.ts - Flow Service → PostgreSQL Store: stores Flows
src/flows/service.ts - Insights → PostgreSQL Store: reads metrics
src/insights/service.ts