ai.newnal.mydata.provenance

The provenance of one MyData record. One provenance record per subject record, holding the latest state only: its record key is `<subject collection NSID>:<subject record key>`. It is written in the same commit as its subject and deleted together with it. It is not a MyData category or section and is not part of the assembled payload. Provenance does not decide access rights or visibility.

Details · record, key any
Kindrecord
Record keyany
Authoritymydata.newnal.ai
Commit rev3n2lk5rjzfw23
Indexed

Record

record · key any

Properties

agent

string · uri

A URI for whoever wrote this version of the subject record: the DID of a person, service or agent, or, for a client without a DID, a URI that identifies that client.

URIs of the evidence for the value: the AT-URI of an archive record, an attestation record of the issuing institution, the identifier of a verifiable credential, and so on.

itemsstring · uri

A URI pointing at one piece of evidence.

fields

array

The keys of the subject record's data that this provenance describes. When absent, it describes the whole subject record.

itemsstring

The name of one key directly under the subject record's data.

method

string

How the value of the subject record was obtained: user_stated (entered or said by the user), inferred (inferred by a service or agent), imported (taken from an external service or file), issued (issued by an institution), observed (measured or observed by a device or service).

  • knownValues: user_stated | inferred | imported | issued | observed

recordedAt

string · datetime

When this version of the subject record was written. Not the time the subject record was first created (_meta.createdAt), nor the time the value actually occurred or was observed.

subject

requiredref

The AT-URI and CID of the subject record this provenance describes. If the CID is not the subject record's current CID, this provenance describes an earlier version and the provenance of the current version is unknown.

Reference

#recordRef

object

A reference to one version of one record (AT-URI and CID). Same shape and same stored value as com.atproto.repo.strongRef; defined in this document so that it resolves with the documents this repository publishes alone.

Properties

cid

requiredstring · cid

The CID of the version of the subject record this provenance describes.

uri

requiredstring · at-uri

The AT-URI of the subject record.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • ILLI's provenance note for a My Data record written in a parent's name: who entered it, from which source, and why. Written by the acting admin into their own repo in the family sphere; the My Data record itself stays generic.

  • network.attested.proof

    record not from the namespace authority

    A remote attestation proof: a standalone record in the attestor's repository that binds, via a canonical attestation CID, to a subject record living elsewhere. Referenced from the subject's `signatures` array via com.atproto.repo.strongRef. The `cid` is computed from the subject record (signatures stripped) with this record's metadata (cid/signature/signatures stripped, `repository` = subject's repo DID added) inserted as $sig, DAG-CBOR + SHA-256 + CIDv1. Verifiers recompute that CID and require

  • A service attestation proving a FreeMix record existed with specific content at a specific time. Created by the FreeMix attestor service in its own repo as an independent witness.

  • A single durable memory belonging to the user. Deliberately one generic type: specialising into fact/preference/project/event types is premature until real requirements demand it. Retrieval-specific state (BM25 scores, vector ids, index cursors, caches) MUST NOT be stored here — it is derived data owned by whichever memory engine indexes this record. Consumers MUST preserve properties they do not recognise: an implementation that rewrites a record after dropping unknown fields destroys data writ

  • An append-only attestation that a policy-selected auditor observed an app.matakite.* record create, update, or delete, or intentionally voided an unrepresentable event. The auditor repository establishes observation chronology for clients that trust its DID; source-record createdAt and Jetstream time_us remain provenance rather than trusted time.