Home

Zinc

Zinc is the environment-native runtime for Circuitry.

Circuitry defines the reusable work shape: YAML value boundaries, inputs, outputs, and $value references. Zinc runs that shape where the user is, through explicit package surfaces. Packages provide the extension surface and own behavior.

Start here

• Shapes — YAML shapes, Markdown front matter, and executable surface entries.
• Packages — package manifests, neighbors, and package-owned surfaces.
• Package Surfaces — request/response contract.
• Executor — ready waves, reports, and run navigation.
• URI Reference — zinc:// reads for packages and history.
• Configuration — runtime parallelism and packet limits.
• Update — Zinc updates and package updates.

Boundary

Circuitry = reusable YAML value boundaries
Zinc     = environment-native execution + history
Packages = extension surfaces + package-owned meaning

Zinc does not infer a default surface. Executable entries say what they run:

answer:
  surface: openai-responses.responses
  in:
    question: $question
  out:
    answer: $answer

History

Zinc stores package records and run history in ~/.zinc/zinc.db:

runs
steps
packets