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.

graph TD
    A["CLI Entrypoint (cmd)"] --> B["core/workspace"]
    A --> C["core/config"]
    A --> D["modules/task"]
    A --> E["modules/verify"]
    A --> F["modules/exec"]
    D --> G["modules/gitops"]
    E --> H["core/ast"]
    style A fill:#0d1117,stroke:#58a6ff,stroke-width:2px
    style B fill:#161b22,stroke:#3fb950,stroke-width:1px
    style C fill:#161b22,stroke:#3fb950,stroke-width:1px
    style D fill:#161b22,stroke:#d29922,stroke-width:1px
    style E fill:#161b22,stroke:#d29922,stroke-width:1px
    style F fill:#161b22,stroke:#d29922,stroke-width:1px

---

Core Packages

Core Substrate Packages

• core/workspace: Workspace context, umbrella discovery, hemisphere detection (yin/yang), and multi-repo isolation.
• core/config: Global (~/.nomos/data/ecosystem.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.

---

Module Packages

Substrate Modules Reference

• 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.