Honour

Honour is an experimental systems language aimed at Go-like ergonomics with stronger resource and concurrency semantics.

Start Here

• Language authority: GRAMMAR.md, docs/, and docs/adr/.
• Agent/session map: CONTEXT.md.
• Implementation rules: AGENTS.md, .agents/style-guides/Honour, and .agents/style-guides/rust.md.
• Current planning snapshots: docs/work-items/README.md.

Repo Layout

• crates/: Rust compiler, runtime, LSP, driver, and support crates.
• stdlib/: Honour BCL sources embedded by honour-stdlib.
• examples/: Honour examples and comparison workloads.
• tree-sitter-honour/: Tree-sitter grammar and source editor queries.
• editors/zed/: Zed extension wrapper and copied query files.
• site/: Static website source and generated pages.

Common Checks

./scripts/check.ps1

Use targeted tests first when changing one crate; broaden to cargo test when touching shared syntax, resolve/type, codegen, runtime, or driver behaviour.

Use ./scripts/check.ps1 -Full before broad Rust changes. Use ./scripts/check.ps1 -WorkItems when changing docs/work-items; it calls GitHub through gh. Use ./scripts/check.ps1 -Generated only after installing Node dependencies for tree-sitter-honour and site.

Use ./scripts/module-sizes.ps1 to find Rust modules over the local 660-line guide target before planning module cleanup.

Generated And Copied Files

• tree-sitter-honour/src/{parser.c,grammar.json,node-types.json} are generated from tree-sitter-honour/grammar.js.
• site/index.html, site/install.html, and site/getting-started.html are Vite entrypoints with server-side include markers. site/grammar.html and site/public/ are generated by npm --prefix site run build.
• editors/zed/languages/honour/*.scm are copies of tree-sitter-honour/queries/*.scm.

Regenerate or sync deliberately and include the source change in the same commit.

npm --prefix tree-sitter-honour install
npm --prefix tree-sitter-honour run generate
npm --prefix tree-sitter-honour run sync:zed
npm --prefix site install
npm --prefix site run build