OpenAgents. AssuranceSpec open design

Observer.

Proof-design for software built by agents. Observer turns an accepted product spec into a reviewed proof design, compiles it into an immutable verification manifest, and runs it through real QA tools — so when the checks go green, the green means what it claims.

Built on AssuranceSpec, a framework-neutral standard for committed verification intent. In development at OpenAgents — designed in the open, dogfooded on our own desktop app before anyone else's code.

Open the MVP Observatory trace Read the AssuranceSpec design Observer product plan

THE FAILURE MODE — A PASSING SUITE IS NOT PROOF

false_green_fixture_assert
The test asserts the fixture

It proves the mock behaves like the mock — not that the product behaves like the spec.

FALSE GREEN
false_green_api_mirror
The test mirrors the implementation

Written after the code, it inherits the code's assumptions — including the wrong ones.

FALSE GREEN
false_green_mocked_seam
The real seam is never exercised

Both sides of a client–server or renderer–host boundary are faked, so integration defects pass clean.

FALSE GREEN
false_green_coverage_theater
Coverage stands in for behavior

Line coverage measures execution, not correctness — activity dressed up as evidence.

FALSE GREEN
false_green_round_up
Everything rounds up to green

Skipped, stale, flaky, and inconclusive results quietly disappear into a passing summary.

FALSE GREEN

Teams cannot reliably answer, criterion by criterion, whether the exact release artifact behaves as designed. Evidence links help you find the test — they cannot tell you it was the right test. A link is not a verdict.

HOW IT WORKS — SPECS BOUND TO REAL SYSTEM BYTES

Product Speccommits intent The durable what/why, with stable acceptance-criterion IDs. It indexes evidence; it never grades it. 01
Assurance Speccommits proof design A separately reviewed companion mapping every criterion to risk-appropriate oracles, real seams, environment tiers, and falsifiers — admitted before the implementation can bias what the tests say. 02
Observerplans, reviews, compiles Typed semantic planning proposes obligations; human review admits them; deterministic compilation makes no clock, network, or model calls — identical inputs yield byte-identical output. 03
Assurance Manifestimmutable verification graph The compiled lockfile of resolved verification units and dependency gates, bound to exact bytes: spec revisions, document digests, intent digests, environment profiles, adapter locks. No mutable status lives inside it. 04
Executionnative tools + QA Swarm Your existing test frameworks, browsers, devices, property suites, and formal checkers run the manifest — one universal runner is explicitly a non-goal. Swarm agents explore beyond it and distill findings into deterministic regressions. 05
Assurance Receiptsexact observed evidence Every run records provenance — spec, source, command, target, seed, adapter, and artifact digests — with a typed verdict. Receipts feed the evidence index by reference; they never revise the spec. CONFIRMEDREFUTEDINCONCLUSIVE 06

WHAT KEEPS THE PROOF HONEST

oracle.falsifier_required
Every required oracle names a falsifier

The intended candidate must pass and a known-bad candidate must be refuted. An oracle that accepts both is ruled unsound.

LAW
seam.real_both_sides
Seams are exercised for real

A declared cross-process or client–server boundary drives both real sides, or cites a qualifying end-to-end receipt. Mock-only rows do not satisfy it.

LAW
gate.planned_red_is_honest
Planned red is honest red

Checks designed before the code can be red without blocking trunk. Once activated, required negative or unknown states block their gate.

LAW
status.nothing_rounds_up
Nothing rounds up to green

Skipped, stale, flaky, unavailable, and inconclusive results stay visible as exactly what they are.

LAW
coverage.advisory_only
Coverage is advisory

Criterion traceability, execution evidence, and explored frontier are separate ledgers. Line coverage never stands in for behavior.

LAW
authority.contained
Authority is contained

No green manifest or run grants merge, deploy, spend, or public-claim authority. Release decisions stay separately owned.

LAW

DOGFOOD — OUR OWN SYSTEMS FIRST, IN THE OPEN

subject binding — first dogfood target · docs/assurance, public repository
product_spec: docs/mvp/openagents-codex-workroom-mvp.product-spec.md
format:       ProductSpec 0.1
revision:     6
sha256:       fba7963334eb736582003e7d903d0e57164e7fecb2c158c302af7fb23e3f6ef1
criteria:     CW-AC-01 … CW-AC-18
assurance:    revision 2 · reviewed and admitted · 18/18 obligations designed
evidence:     18 CONFIRMED · 18 falsifiers REFUTED · 18 sensitivity receipts

That binding is real, quoted from the repository — Observer's first subject is the OpenAgents Desktop MVP spec itself. The design documents, format tooling, and generated first proposal are public in docs/assurance.

STATUS — REPORTED THE WAY OBSERVER WOULD REPORT IT

packages/assurance-spec
AssuranceSpec format tooling

Bounded proposal profile — parser, serializer, structural validator, and CLI — implemented and tested in the open repository.

REAL TODAY
docs/mvp · assurance-spec.md
First admitted Assurance Spec

Revision 2 is reviewed and admitted: all 18 candidate oracles confirmed, all 18 falsifiers refuted, with 18 sensitivity receipts and a green Desktop gate.

REAL TODAY
spec → proposal
Deterministic proposal generation

A coverage skeleton from the exact spec bytes — no semantic proof inference is claimed.

REAL TODAY
planner · admission
Semantic planning and review flow

Review annotations and exact-digest admission are implemented. Rich semantic planning remains reviewable proposal work, never compiler output or self-admitted policy.

IN DESIGN
compiler · manifest
Deterministic manifest compiler

Exact-digest bindings and byte-stable compilation are implemented with golden-byte and stale-input regression coverage.

REAL TODAY
adapters · receipts
Native adapters and normalized receipts

The narrow native Bun-test adapter and normalized eight-axis receipts are implemented. Browser, device, resilience, accessibility, and formal adapters remain planned.

REAL TODAY · NARROW
qa-swarm
QA Swarm execution and exploration

Sharded manifest runs within declared budgets; undistillable exploration stays inconclusive instead of disappearing.

PLANNED
observatory
First public Observatory trace

The Desktop MVP now has a reviewed public-safe criterion trace. It reports the current missing proof honestly; multi-project hosting remains planned.

REAL TODAY

This page holds itself to the standard it describes: planned surfaces stay visibly unbuilt, and nothing here is a public product promise. Public claims live only in the product-promise registry.

WHAT'S COMING

FIRST — LOCAL & OPEN SOURCE

The proof contract, free

  • validate product specs, assurance specs, and environment profiles
  • compile deterministic assurance manifests
  • run obligations through your own native test tools
  • local JSON/HTML evidence reports
  • bring-your-own model for proposal and exploration
  • no OpenAgents account required

Existing tests are imported before anything is generated — Observer rebuilds the harness around a proof-design control file; it does not discard the harnesses that already work.

LATER — HOSTED

Managed evidence, when it earns it

  • managed browser, OS, and device matrices
  • parallel QA Swarm exploration
  • retained encrypted evidence and trends
  • opt-in shareable evidence pages

The paid service sells managed environments, compute, and evidence retention. It does not hold the basic proof contract hostage.