Home

Zinc Wiki

Zinc is a local runtime and governed execution shell for Circuitry 0.6 action-shapes.

Zinc loads portable Circuitry actions, prepares inputs, runs a governed REPL loop where environment commands are validated against policy, saves approvals/traces to a Limbo database, and returns outputs.

Wiki Pages

• Architecture: The runtime model, responsibility split, and execution flow.
• Project Layout: Workspace layout (.zinc/, state/zinc.db, tmp/).
• Configuration: Interception modes (inspect, open, build) and access scopes (project, home, system).
• Graphs: Circuitry 0.6 action-shape format (takes, does, gives).
• Runtime: Limbo database state engine, schema, and trace persistence.
• Tools: The governed REPL shell, command interception, and stock policy configs.
• Packages: Package manifests (zinc.pkg.yaml), scripts, and shape resolution.
• Sessions: Trace logs, run histories, and the zinc:// URI scheme.

Vocabulary

Term	Meaning
shape	YAML source declaring an action card (takes, does, gives)
run	An execution instance of a shape
action	An environment command executed during a run
policy	Rules matching command patterns to decisions (allow/confirm/deny)
approval	A recorded decision allowing specific commands under a policy
workspace	A local folder containing a .zinc/ directory
Limbo	The Rust-native, SQLite-compatible SQL database engine used by Zinc