22.1 Repos and submodules
Where compiler, pckg, VS Code extension, and corelib actually live in the aggregate repo.
Repos and submodules
The beskid superrepo aggregates submodules—especially compiler, pckg, and beskid_vscode. Corelib is a nested submodule under compiler/corelib (beskid_standard), not a top-level sibling.
Typical layout
Section titled “Typical layout”| Path | What |
|---|---|
compiler/ | CLI, analysis, codegen, runtime, LSP, pckg client crates |
pckg/ | Registry service (Rust), dashboard, publish pipeline |
beskid_vscode/ | Open VSX extension and bundled LSP |
compiler/corelib/beskid_corelib/ | Canonical stdlib Beskid sources (corelib package) |
openspec/ | Normative Standard source and generated catalog |
site/website/ | Public Docs, Book, Standard presentation, and downloads |
Run the repository setup script from the superrepo root. It initializes the required submodules and installs the root pnpm dependencies.
./scripts/setup-environment.shUse Repository setup for prerequisites, focused checks, ownership, and recovery.