Nomos Substrate Go API Reference

The compiled Nomos engine (nomos) is written in Go, acting as the deterministic Substrate Core in the Dual-Core Architecture.

Core Packages

core/workspace: Workspace context, umbrella discovery, hemisphere detection (yin/yang), and multi-repo isolation.
core/config: Global (~/.nomos/data/config.yaml) and project-level settings resolution with strict schema validation.
core/state: Phase discipline state machine (PLAN, EDIT, REVIEW), lock tokens, and SQLite database schemas.
core/ast: AST inspection, symbol extraction, import boundary verification, and OOP anti-pattern scanner.

modules/task: SQLite-backed DAG task engine, batch rollup, cycle clustering, and Cognitive Load Index (CLI) scoring.
modules/verify: 36 deterministic Definition of Done (DoD) quality gates (TDD, AST, dead code, magic strings).
modules/exec: Execution substrate, agent tier boundaries, and phase discipline guards.
modules/gitops: Transient Git worktree lifecycle management, atomic two-phase commit (2PC), and branch synchronization.