Repository navigation
v1.3.0 — Comprehension Contract fields + Level 1 demonstration
What's new
Comprehension Contract Mirror fields
All six hello-colony agent definitions now carry the four new Mirror sections designed in the Comprehension Contract brainstorm:
comprehension_contract:— trust tier (Observing / Sandboxed / Bounded / Self-Directed), pre-registered policies, audit rate, blast radius ceilingnfrs:— inherited colony NFRs from Constitutional Memory + agent-specific SLO commitmentsvaluation:— four-perspective scoring (self / peer / audit / human)critical_path:insiderelationships:— structural and dynamic critical path flags
Schema v0.2.0
schemas/agent-mirror-v0.2.0.json adds all four new sections. The original v0.1.json is kept intact. Pre-existing sections are now permissive (resolving schema drift accumulated since v1.1.x).
Graduation checklist
examples/hello-colony/graduation-checklists/finance-agent-v1.0-to-v1.1.yaml — the first graduation checklist. The finance agent has an overlap score of 0.24 with equilibrium-agent (watch zone). v1.1 will suppress the accreted self-monitoring capabilities. The checklist carries 3 evidence requirements, 2 approval requirements, and 3 external actions — each pre-classified with blast radius and review regime.
Hello-Colony Live Runtime
cd examples/hello-colony-runtime
pip install -r requirements.txt
python runtime.pyA deterministic Python simulation that demonstrates the pattern working as code. Loads all agent YAML files, validates against v0.2.0 schema, and runs four colony events: bootstrap (5 agents REGISTERED ✓ valid), equilibrium check (0.24 overlap flagged), security patch co-sign (CVE-2026-0441, preauthorised enum match), and graduation query.
Equilibrium Playground
open examples/equilibrium-playground/index.htmlSelf-contained HTML visualisation of the Equilibrium System. D3.js overlap matrix heatmap colour-coded by threshold zone. Threshold sliders, add/remove agent controls, inject-workload button (simulates capability accretion), three live index gauges (Overlap, Concentration, Vitality). No build step.
The pattern now demonstrates what it describes.