repowiseyc-software/qm

Architecture of yc-software/qm

yc-software/qm is 2,486 source files holding 17,000 symbols across 16 modules, written mainly in TypeScript, JavaScript, Rust. The largest module is test, with 835 files, and 13 files are entry points into the dependency graph.

How qm fits together

Input arrives from the web UI or from the optional Slack plugin, and both talk to the core over its HTTP API. The core in src/core handles identity, policy and scheduling, and src/core/orchestrator.ts is one of its central files. src/agent/agent-tools.ts defines the small fixed tool set the agent can call, and one of those tools, execute, runs commands in the scope's isolated sandbox. src/sessions/postgres-session-store.ts stores session history and other durable state in Postgres. The cli directory holds the qm command, which validates and deploys a deployment directory that carries the company-specific configuration.

Largest modules

  • test: 835 files and 203,303 lines of code
  • src: 605 files and 124,437 lines of code
  • plugins: 532 files and 94,142 lines of code
  • cli: 114 files and 42,745 lines of code
  • scripts: 62 files and 8,681 lines of code
  • desktop: 51 files and 11,449 lines of code
  • deploy: 15 files and 764 lines of code
  • skills-seed: 6 files and 791 lines of code

Languages

By file count: TypeScript 2,130 files, JavaScript 48 files, Rust 16 files, Dockerfile 13 files, Shell 13 files, Python 5 files.

Documentation

Repowise documents qm in 1,430 pages generated from the source, 55 of them written explanations of the repository and its modules.

More on qm: summary and FAQ, codebase overview, code health.

Related guide: Best dependency graph tools for monorepos