Documentation

Core concepts

Moonwire tracks change in recorded evidence, not objective truth. Source systems remain authoritative.

The lineage model

resource version → artifact → artifact → decision / pending action

• Project: tenant boundary selected by an API key.
• Resource: canonical reference to external evidence; content is not required.
• Resource version: immutable opaque identifier, external version, or hash.
• Artifact: persisted answer, memory, report, decision, plan, pending action, or generic output.
• Dependency: edge from an artifact to a specific resource version or another artifact.
• Revalidation: application acknowledgement after recomputation or review.

Status semantics

VALID is safe to use. STALE, REVALIDATE, and BLOCKED are not. Severity is monotonic until explicit revalidation.

Consistency boundary

A resource change, event, durable job, and direct dependent status commit together. Deeper downstream propagation is durable and eventually consistent. The check endpoint also verifies direct version mismatches live.

Read the full invalidation semantics and evidence-change ADR.