org.hypercerts.context.attachment

hypercerts.org

Documentation

An attachment providing commentary, context, evidence, or documentary material related to a hypercert record (e.g. an activity, project, claim, or evaluation).

main record

An attachment providing commentary, context, evidence, or documentary material related to a hypercert record (e.g. an activity, project, claim, or evaluation).

Record Key tid Timestamp-based ID

Properties

contentType string Optional

The type of attachment. Values beyond the known set are permitted.

maxLength: 64 bytes
Known values: report, audit, evidence, testimonial, methodology
createdAt string datetime Required

Client-declared timestamp when this record was originally created.

location ref com.atproto.repo.strongRef Optional

A strong reference to the location where this attachment's subject matter occurred. The record referenced must conform with the lexicon app.certified.location.

shortDescription string Optional

Short summary of this attachment, suitable for previews and list views. Rich text annotations may be provided via `shortDescriptionFacets`.

maxLength: 3000 bytesmaxGraphemes: 300 graphemes
shortDescriptionFacets array of ref app.bsky.richtext.facet Optional

Rich text annotations for `shortDescription` (mentions, URLs, hashtags, etc).

subjects array of ref com.atproto.repo.strongRef Optional

References to the subject(s) the attachment is connected to—this may be an activity claim, outcome claim, measurement, evaluation, or even another attachment. This is optional as the attachment can exist before the claim is recorded.

maxLength: 100 items
tags array of ref com.atproto.repo.strongRef Optional

References to org.hypercerts.vocab.tag records classifying this record. All listed tags apply simultaneously (logical AND); the array carries no ordering, weighting, negation, inheritance, or rule logic, and never will — any future expression logic must arrive as a new field and must never reinterpret this one.

maxLength: 20 items
title string Required

Display title for this attachment (e.g. 'Impact Assessment Report', 'Audit Findings')

maxLength: 256 bytes
View raw schema 
{
  "description": "An attachment providing commentary, context, evidence, or documentary material related to a hypercert record (e.g. an activity, project, claim, or evaluation).",
  "key": "tid",
  "record": {
    "properties": {
      "content": {
        "description": "The files, documents, or external references included in this attachment record.",
        "items": {
          "refs": [
            "org.hypercerts.defs#uri",
            "org.hypercerts.defs#smallBlob"
          ],
          "type": "union"
        },
        "maxLength": 100,
        "type": "array"
      },
      "contentType": {
        "description": "The type of attachment. Values beyond the known set are permitted.",
        "knownValues": [
          "report",
          "audit",
          "evidence",
          "testimonial",
          "methodology"
        ],
        "maxLength": 64,
        "type": "string"
      },
      "createdAt": {
        "description": "Client-declared timestamp when this record was originally created.",
        "format": "datetime",
        "type": "string"
      },
      "description": {
        "description": "Long-form description of the attachment. An inline string for plain text or markdown, a Leaflet linear document for rich-text content, or a strong reference to an external description record.",
        "refs": [
          "org.hypercerts.defs#descriptionString",
          "pub.leaflet.pages.linearDocument",
          "com.atproto.repo.strongRef"
        ],
        "type": "union"
      },
      "location": {
        "description": "A strong reference to the location where this attachment's subject matter occurred. The record referenced must conform with the lexicon app.certified.location.",
        "ref": "com.atproto.repo.strongRef",
        "type": "ref"
      },
      "shortDescription": {
        "description": "Short summary of this attachment, suitable for previews and list views. Rich text annotations may be provided via `shortDescriptionFacets`.",
        "maxGraphemes": 300,
        "maxLength": 3000,
        "type": "string"
      },
      "shortDescriptionFacets": {
        "description": "Rich text annotations for `shortDescription` (mentions, URLs, hashtags, etc).",
        "items": {
          "ref": "app.bsky.richtext.facet",
          "type": "ref"
        },
        "type": "array"
      },
      "signatures": {
        "description": "Optional cryptographic signatures attesting to this record's content.",
        "ref": "app.certified.signature.defs#list",
        "type": "ref"
      },
      "subjects": {
        "description": "References to the subject(s) the attachment is connected to—this may be an activity claim, outcome claim, measurement, evaluation, or even another attachment. This is optional as the attachment can exist before the claim is recorded.",
        "items": {
          "ref": "com.atproto.repo.strongRef",
          "type": "ref"
        },
        "maxLength": 100,
        "type": "array"
      },
      "tags": {
        "description": "References to org.hypercerts.vocab.tag records classifying this record. All listed tags apply simultaneously (logical AND); the array carries no ordering, weighting, negation, inheritance, or rule logic, and never will — any future expression logic must arrive as a new field and must never reinterpret this one.",
        "items": {
          "ref": "com.atproto.repo.strongRef",
          "type": "ref"
        },
        "maxLength": 20,
        "type": "array"
      },
      "title": {
        "description": "Display title for this attachment (e.g. 'Impact Assessment Report', 'Audit Findings')",
        "maxLength": 256,
        "type": "string"
      }
    },
    "required": [
      "title",
      "createdAt"
    ],
    "type": "object"
  },
  "type": "record"
}

Lexicon Garden

@