How hyper-forge/ghidora works
Ghidora is a cross-runtime monorepo task orchestrator. A user invokes the TypeScript CLI, which loads workspace configuration, discovers packages and task dependencies, builds or reuses a workspace graph, then schedules tasks and launches package processes. Local and optional cloud caches support task execution; a graph server provides a task-graph view. The Rust/WASM core supplies deterministic hashing and terminal/UI functions. Several subsystem links come from the README or SOURCE INDEX; unsampled implementation details are not inferred.
Main entry points: main.ts Ghidora CLI · graph-core.ts Graph assembly · checkForUpdates.ts Update checker · cloud-cache.ts Cloud task cache
Components 20
CLI and runtime
- Ghidora CLI
apps/ghidora/src/main.ts - Runtime helpers
apps/ghidora/src/utils/helper.ts - Config and types
apps/ghidora/src/datatypes/validateDataTypes.ts - Update checker
apps/ghidora/src/updates/checkForUpdates.ts - CLI help
apps/ghidora/src/utils/ghidoraHelp.ts
Workspace orchestration
- Workspace starters
apps/ghidora/src/orchestrator/starters.ts - Workspace discovery
apps/ghidora/src/orchestrator/discover.ts - Graph assembly
apps/ghidora/src/orchestrator/graph-core.ts - Task dependencies
apps/ghidora/src/orchestrator/graph.ts - Plan execution
apps/ghidora/src/orchestrator/executePlan.ts - Graph server
apps/ghidora/src/orchestrator/graph-server.ts
Task caching
- Graph cache
apps/ghidora/src/orchestrator/graph-cache.ts - Local task cache
apps/ghidora/src/orchestrator/cache.ts - Cloud task cache
apps/ghidora/src/orchestrator/cloud-cache.ts
Rust WASM core
- Hash functions
apps/ghidora-core/src/crypto.rs - Templates and graph UI
apps/ghidora-core/src/config.rs - Terminal UI
apps/ghidora-core/src/cli.rs
Other components
- CLI user
- Cloud cache service
- Package registry
Connections 20
- CLI user → Ghidora CLI: invokes
README.md - Ghidora CLI → Workspace starters: initializes workspace
apps/ghidora/src/main.ts - Ghidora CLI → Runtime helpers: uses runtime helpers
apps/ghidora/src/main.ts - Ghidora CLI → Config and types: uses config types
apps/ghidora/src/main.ts - Ghidora CLI → Workspace discovery: builds workspace graph
apps/ghidora/src/main.ts - Ghidora CLI → Graph assembly: builds full graph
apps/ghidora/src/main.ts - Ghidora CLI → Graph cache: reads graph cache
apps/ghidora/src/main.ts - Ghidora CLI → Task dependencies: uses task graph
apps/ghidora/src/main.ts - Ghidora CLI → Plan execution: dispatches plan
apps/ghidora/src/main.ts - Ghidora CLI → Local task cache: uses task cache
apps/ghidora/src/main.ts - Ghidora CLI → Cloud task cache: restores cloud cache
apps/ghidora/src/main.ts - Ghidora CLI → Graph server: uses graph server
apps/ghidora/src/main.ts - Ghidora CLI → Update checker: checks updates
apps/ghidora/src/main.ts - Ghidora CLI → CLI help: uses help
apps/ghidora/src/main.ts - Graph assembly → Workspace discovery: uses discovery
apps/ghidora/src/orchestrator/graph-core.ts - Graph assembly → Task dependencies: uses task graph
apps/ghidora/src/orchestrator/graph-core.ts - Cloud task cache → Cloud cache service: fetches and uploads
apps/ghidora/src/orchestrator/cloud-cache.ts - Update checker → Package registry: checks latest version
apps/ghidora/src/updates/checkForUpdates.ts - Hash functions → Terminal UI: exported by core
apps/ghidora-core/src/lib.rs - Templates and graph UI → Terminal UI: exported by core
apps/ghidora-core/src/lib.rs