Technology & execution narrative

Does the architecture do what the thesis says?

One continuous document: the three layers and why the boundaries exist, what each layer can and cannot state, how a single agricultural event travels from source record to external reliance, what breaks when it breaks, and what is genuinely built today.


Single document · read top to bottomTwo repositories, pinned refsMaturity stated per layer, not as a count
I · The layered model

What the system is

An agricultural technology already knows something happened: a device measured, an intervention occurred, a model ran, or an operator recorded an event. AgEvidence does not ask that company to replace its application. The Python SDK lets it express that evidence in a common form.

A small Rust trust layer handles the narrow deterministic problem: canonical representation, identity, digests, receipts and verification. It should not know whether a buyer approves a claim or whether a scientific model is valid.

The Rails Evidence Plane handles the changing institutional problem: programs, requirements, evaluations, gaps, human review, determinations, statements, sharing, permissions and history.

This lens asks whether those boundaries are real, whether the second integration reuses more than the first, and whether verification can remain meaningful outside the hosted product.

The three-layer model

There are three questions in one evidence chain.

Representation: can the source system express what it knows in a portable form? Python owns this developer-facing problem.

Integrity: can another implementation establish that the object, lineage and declared transformations are intact? Rust owns this deterministic problem.

Interpretation and operation: is the evidence sufficient for a particular intended use, who reviewed it, what changed and what can be shared? Rails owns this mutable institutional problem.

The architecture is valuable only if those questions remain separable.

Evidence reliance
Commercial Evidence PlaneRails
  • Evaluation against program requirements
  • Programs and requirement profiles
  • Review and reviewer judgment
  • Determinations
  • Sharing and statements
  • Operational support and history
Developer LayerPython
  • Evidence primitives
  • Adapters for existing systems
  • Normalization
  • Fixtures
  • Validation
  • Developer workflows
Trust KernelRust
  • Canonical representation
  • Stable identifier
  • Cryptographic digest
  • Signature / receipt
  • Deterministic verification
Source events

Rust trust layer

The Rust layer should be deliberately boring.

It should canonicalize evidence, derive or check stable identifiers, hash records, verify receipt relationships and provide deterministic validation without needing customer workflow state. It is the portion of the system that another party should be able to inspect or invoke without trusting the commercial application.

Production maturity matters here. A working path is not the same as a finished trust boundary. Canonicalization, signature handling, bundle verification and trust material should be hardened until independent reconstruction produces the same result.

Python SDK

The Python SDK is the adoption surface.

A developer should be able to map existing records into a small set of evidence primitives, validate them locally, create manifests and bundles, use source-adapter tooling and hand deterministic verification to the trust layer without creating a Rails account first.

The SDK succeeds when developers get useful evidence quickly and when new customers require fewer new core semantics than previous customers.

Canonical evidence primitives

The primitives are not an attempt to model all of agriculture.

They are the smallest cross-domain objects needed to preserve factual identity and provenance: source records, observations, intervention events, model runs and operational events. Method-specific requirements, jurisdiction rules and customer workflows should live outside the core unless repeated evidence shows that a new concept is genuinely cross-domain.

Every new core object is therefore a potential failure of the thin-waist hypothesis and should be treated as change control, not routine feature work.

Rails Evidence Plane

The Evidence Plane is where evidence becomes operationally consequential.

A workspace declares a purpose and program profile. Requirements define what is needed. Evidence records are attached. Evaluations surface pass, fail, gap, conflict or review states. Humans can review evidence and record determinations. Statements and artifacts communicate bounded conclusions. Sharing, permissions, history and API access make those conclusions usable outside the originating team.

Rails is intentionally mutable because institutions are mutable.

What remains commercial

Anything that must be universal to reduce integration friction belongs as low and open as practical. Anything that requires ongoing institutional responsibility can remain commercial.

Compatibility, schemas, test vectors and portable verification should not be artificial tollbooths. Maintained profiles, evaluation operations, human review, controlled sharing, enterprise API commitments, retention, policy updates and support are legitimate commercial surfaces because someone must continuously operate them.

II · The distinctions that carry the design

Integrity versus sufficiency

A cryptographically intact evidence object can still be scientifically wrong, out of domain, incomplete for a method or unacceptable to a buyer.

Integrity answers whether the declared object and lineage are intact. Sufficiency answers whether enough appropriate evidence exists for a particular purpose. The first can be deterministic. The second is contextual and often requires method-specific rules or human judgment.

Keeping them separate is what allows the trust layer to remain portable.

Evidence versus claim

Evidence should survive claims.

If a buyer’s policy changes tomorrow, the historical observation should not be rewritten. If a methodology changes, the old evidence should be re-evaluated against the new profile. If a reviewer changes a determination, the new judgment should supersede rather than erase the previous one.

That requires separate objects for evidence, evaluation, review, determination and statement.

End-to-end trace

The target full-system demonstration begins with a source event and ends outside the product.

Create a source record. Map an observation or event through the SDK. Verify the canonical object. Ingest it into the Evidence Plane. Evaluate it against a declared profile. Surface a missing item. Resolve or qualify it through review. Issue a versioned artifact. Export the package. Verify the integrity references outside the hosted interface.

That path would demonstrate the architecture more clearly than a dashboard tour.

Real-world eventSource

Something happened in a paddock, a feedlot, a lab or a machine.

RepresentationPython SDK

How do we represent what happened?

IntegrityRust core

Can we deterministically verify the integrity of that representation?

InterpretationRails evidence plane

Given a purpose, what does this evidence mean?

ReviewRails + humans

A named reviewer resolves what the software cannot.

DeterminationRails

Ready, conditionally ready, or not ready — with qualifications.

Reliance artifactPortable

Target: a package that can leave the platform and be checked independently.

External userBuyer · auditor · program · investor · verifier

Someone acts on it without redoing the work.

Failure boundaries

The system should fail in the layer that owns the error.

Malformed representation should fail at the SDK and schema boundary. Changed content should fail integrity checks. Missing evidence should remain a gap in evaluation. Scientific uncertainty should remain uncertainty, not a validation error. A changed program should create a new evaluation. A changed judgment should create a new determination. A network outage should not rewrite historical evidence.

Local failure is a design goal.

III · What exists today

Why integrations must get cheaper

The infrastructure thesis fails if every customer becomes a software project.

The first deployment can contain learning. The second should reuse primitives, fixtures, adapter patterns, program structures and deployment procedures. The third should reuse more. Measure new core code, unique connector work, profile reuse, founder hours, deployment hours and time to first useful artifact.

Declining marginal implementation work is the technical form of venture scalability.

Rust trust kernel + Python SDKhttps://github.com/meronrudy/athian-evidence-bazaar/tree/fcd7cf96f724db7b24602a0778de55247e2da532

Read at the pinned ref fcd7cf96f724db7b24602a0778de55247e2da532. Every count cited in this narrative is read there.

git clone https://github.com/meronrudy/athian-evidence-bazaar && git -C athian-evidence-bazaar checkout fcd7cf96f724db7b24602a0778de55247e2da532
Rails Evidence Planehttps://github.com/meronrudy/AgEvidence/tree/9125c60c958409d753e9bb3c4867697eaf8f6387

Read at the pinned commit 9125c60c958409d753e9bb3c4867697eaf8f6387. The commercial plane: requirements, review, determinations, statements and history.

git clone https://github.com/meronrudy/AgEvidence && git -C AgEvidence checkout 9125c60c958409d753e9bb3c4867697eaf8f6387
Where the open questions live

This document argues a position. It is not the place where the position is tested. The analytical review environment holds every load-bearing claim with its status, the evidence held, the evidence missing, its falsifier and the next decisive test.

Test the technical claims in Independent review

AgEvidence is easiest to understand technically as a separation of responsibilities.

An agricultural technology already knows something happened: a device measured, an intervention occurred, a model ran, or an operator recorded an event. AgEvidence does not ask that company to replace its application. The Python SDK lets it express that evidence in a common form.

A small Rust trust layer handles the narrow deterministic problem: canonical representation, identity, digests, receipts and verification. It should not know whether a buyer approves a claim or whether a scientific model is valid.

The Rails Evidence Plane handles the changing institutional problem: programs, requirements, evaluations, gaps, human review, determinations, statements, sharing, permissions and history.

This lens asks whether those boundaries are real, whether the second integration reuses more than the first, and whether verification can remain meaningful outside the hosted product.