English | 中文
evidence-system is the Evidence System of workflow-self-recursive — an optional, separately deployable, loopback-only data service. It accepts supported OTLP facts from Execution, persists truthful causal and factual projections, and exposes committed state through a versioned read-only query API without controlling execution. Execution continues when Evidence or telemetry is unavailable.
Three modules separate the concerns:
- Observation Admission decides what may become accepted, resolves stable record identity, detects duplicate/conflict, and coordinates the transaction.
- Factual Projection derives owner-scoped causal and factual state with explicit final/lower-bound/unavailable/not-applicable semantics.
- Query & API exposes committed state through the sole external read boundary used by BI and Evolution.
The first release runs as one local Evidence API service and one internal PostgreSQL database. It does not host a UI, proxy a presentation tier, or expose PostgreSQL to consumers.
This repository is part of workflow-self-recursive's architecture-first developer preview for trusted local use by individuals and small teams. Admission, projection, query, automatic retention, and the local deployment are implemented and testable. THERE WILL BE COMPATIBILITY-BREAKING CHANGES.
Python 3.13 and 3.14 are supported; local development defaults to the latest available 3.14 patch. uv owns dependency locking and builds.
make sync # exact dependency environment from uv.lock
make format # rewrite Python formatting
make lint # format check, Ruff lint, and strict mypy
make unit # small tests, no external services
make integration # ephemeral PostgreSQL 18 migration and integration test
make deployment # build and smoke-test the loopback Docker Compose deployment
make build # wheel and sdist in dist/
make check # non-container quality/build gateThe supported Compose deployment publishes the API only on 127.0.0.1:4318; PostgreSQL has no host-published port. Runtime startup never applies migrations implicitly.
Local startup, separated database roles, file-backed secrets, read-only backup, non-overwriting restore, and the exact negative network checks are documented in Evidence local operations.
This repository is normally consumed as a submodule of workflow-self-recursive:
git clone --recurse-submodules https://github.com/firestige/workflow-self-recursive.gitTo clone it standalone:
git clone https://github.com/firestige/wsr-evidence.git