Repository navigation
Agent-Causality 0.3.0
Breaking changes
- capture_tool now requires provenance_recorder when field_sources produces a
non-empty mapping. Callable recorders must return an EventLog, and captured
tool retries without provenance are rejected.
Failure story on the causal DAG
- The failure column shows the failure's visible declared ancestors. Hidden
stretches become dashed filter gaps or stubs with the omitted event count,
and selecting a node lights only its causal ancestors, stopping at a gap. - Gap tooltips report the hidden count, including when the same visible pair
also has a direct causal edge. - Zoom and pan respect the SVG letterbox at every viewport aspect ratio.
- The explorer opens the session that owns the failure event by default.
Capture, CLI, and explorer boundaries
- Invalid replay values fail with usage guidance instead of silently becoming
a string. - EventLog.append must return the stored Event or raise; fail-open logs use the
new AppendWithStatus protocol. - The explorer serves only the vendored explorer/static bundle.
- .env loading moved to sdk/env.py, with inline comment stripping and startup
errors for unreadable files. - Diagnosis scoring moved into core/diagnosis.py and core/metrics.py.
Examples, site, and docs
- Added the payment approval failure example.
- Redesigned the site as a causal-graph landing page, with OpenCode and
LangGraph guides and a mobile menu. - Published the research paper with Google Scholar metadata and added live
PyPI and npm download badges.
Verification and agent tooling
- Added deterministic quick and full verify modes with ephemeral ports and
artifact logs, wired into pre-commit, CI, and agent worktrees. - Added import-boundary, suppression-budget, static-freshness, plugin-copy,
and linked-worktree checks. - Added the worktree spawner, worktree cleanup command, task-scope enforcement,
and advisory pull request review.
Install
pip install agent-causality==0.3.0
npm install @psionic-labs/opencode-agent-causality@0.1.7