Architecture of keygraphhq/shannon
keygraphhq/shannon is 135 source files holding 816 symbols across 2 modules, written mainly in TypeScript, Dockerfile, JavaScript. The largest module is apps, with 101 files, and 8 files are entry points into the dependency graph.
How shannon fits together
The command-line entry point apps/cli/src/index.ts loads the commands in apps/cli/src/commands, and apps/cli/src/commands/start.ts handles a scan run. apps/cli/src/docker.ts manages the Docker setup that the scan depends on. The scan work runs in a worker, whose steps are defined in apps/worker/src/temporal/activities.ts and whose pre-run checks are in apps/worker/src/services/preflight.ts. According to the README, the target repository is mounted read-only inside an ephemeral worker container, and results are written to a local workspace.
Largest modules
- apps: 101 files and 13,491 lines of code
- root: 14 files and 791 lines of code
- docs: 8 files and 505 lines of code
- .github: 6 files and 706 lines of code
- .claude: 3 files and 268 lines of code
- sample-reports: 3 files and 2,148 lines of code
Languages
By file count: TypeScript 93 files, Dockerfile 1 file, JavaScript 1 file, Shell 1 file.
More on shannon: summary and FAQ, codebase overview, code health.
Related guide: Best dependency graph tools for monorepos