Skip to content

Architecture

Jump to bottom
sarr-io edited this page Jun 9, 2026 · 21 revisions

Architecture

Zinc serves as a governed environment boundary for executing Circuitry 0.6 actions on the local computer.

Responsibility Split

Layer Owns
Circuitry YAML action-shape definitions (circuitry: "0.6"), inputs (takes), steps (does), and outputs (gives).
Zinc Database state (Limbo), input/output collection, REPL shell execution, command interception/policies, package installation, and trace recording.

Unlike old versions, Zinc 0.6 does not execute LLM completions or graph topologies directly. It provides the governed runtime boundary where an agent or user interacts with the system.

Run Flow

  1. Load Shape: Zinc resolves and loads the .circuitry.yaml file.
  2. Validate: The shape is verified against Circuitry 0.6 standards (checks for core fields, flags legacy 0.5 syntax).
  3. Resolve Inputs: Zinc resolves takes inputs via CLI parameters or prompts.
  4. Initialize Trace: A run and doc record are initialized in the Limbo database.
  5. Governed REPL: Zinc starts the governed REPL shell, displaying guidance. Commands are typed, intercepted, evaluated against policy rules, approved, executed, and recorded.
  6. Settle Outputs: On REPL exit, Zinc prompts for and resolves output values (gives).
  7. Complete Trace: The run is marked finished, database transactions commit, and outputs are returned.

Clone this wiki locally