orchestrata_ultimate.governance

Reference › orchestrata_ultimate › governance

Orchestrata Governance — policy engine, escalation, audit, constitutional enforcement.

The governance package is the policy engine of Orchestrata, built over Prolog. It decides whether an agent may do what it is about to do, records the decision, trips a safe mode when violations come too fast, and escalates contested cases. Rules are Prolog files (constitution, ethics, resources, agents, PAM, completion and policy layers); the Python code asks them questions through one bridge and turns the answers into typed results. The hand-written story is the curated governance page.

How messages and intents meet it:

• At runtime the kernel pipeline holds a PrologGate. submit_intent calls may_execute for HUMAN before an intent is routed to the first volk, and approval calls may_complete before a task is closed.
• The kernel dispatcher and policy_evaluator evaluate routing policy for a sender, recipient and message type, using the loader and strict flag from here. The postman has its own authority checks in postman governance.
• Going the other way, handler sends an escalation CXP packet to each authority through a route callback.

Parts, by role:

• Decision core: policy_engine runs the pipeline of safe mode, cache, constitutional, ethical, policy_layers and Prolog; prolog_client, verdict and volk_facts support it; resource_access and dynamic_policy are specialised users of the client.
• Evidence and safeguards: cache, audit, monitoring, violations and safe_mode.
• Shared definitions: types, interfaces, exceptions, constants and _strict, which makes errors deny by default.
• Escalation: the escalation_handler subpackage and the event-publishing wrapper event_emitting_policy_engine.

Entry points are PolicyEngine.evaluate and PrologGate.may_execute and may_complete. Start reading at policy_engine, then prolog_client.

Curated narrative

The hand-written story of this package: orchestrata_ultimate.governance.

28 modules, 6,865 lines of code.

Subpackages

Modules

Dependency diagram