GTS Document

• CURIE: gmeow:GTSDocument
• IRI: https://blackcatinformatics.ca/gmeow/GTSDocument
• Category: class
• Defined by: gmeow:slices/gts
• Box roles: ConfigBox role, TBox role (What is this?)

A single-file Graph Transport Substrate artifact (docs/GTS-SPEC.md): a CBOR Sequence of one or more append-only segments carrying an RDF 1.2 graph and any content-addressed binaries it references. A Manifestation in the WEMI sense — the packaged, shippable embodiment. Its composite identity is the ORDERED list of its segments' chain heads (spec §3.1); byte-concatenation of valid documents is a valid document, so a document's segment list grows by append, never by rewrite.

Structure

Subclass of: gmeow:Manifestation

Practical Pattern

Use gmeow:GTSDocument as a specialized kind of gmeow:Manifestation. Add statement metadata or a standpoint when the assertion needs provenance, confidence, or vantage.

Example Snippets

These snippets are generated from canonical slice examples and trimmed to the Turtle blocks where this term appears.

Dist Package

• Source: slices/core/gts/examples/dist-package.ttl
• Examples catalog: open in catalog#example-slices-core-gts-examples-dist-package

@prefix gmeow: <https://blackcatinformatics.ca/gmeow/> .
@prefix ex:    <https://blackcatinformatics.ca/gmeow/examples/> .
@prefix rdfs:  <http://www.w3.org/2000/01/rdf-schema#> .
@prefix xsd:   <http://www.w3.org/2001/XMLSchema#> .



ex:gts-dist-package-001
    a gmeow:GTSDocument ;
    rdfs:label "gmeow.gts — the dist snapshot, with a music extension appended"@en ;
    gmeow:embodies ex:gmeow-ontology-expression-001 ;
    gmeow:contentDigest "blake3:0e2f4b8a3c1d5e7f9a0b2c4d6e8f0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f" .

Common Companion Terms

gmeow:Manifestation, gmeow:GTSProfile, gmeow:GTSSegment

Cross-Cutting Concerns

GTS packaging

External Equivalences

Equivalent or closely aligned targets: dcat

Linkages

Generated from the canonical mapping DSL. SSSOM files are the generated public interchange form for term equivalences.

Term Equivalences

Usage Advice

Use when

• Use to model a whole shippable GTS file as a first-class entity — when you need to talk about the package itself (its segment list, its composite identity, its provenance) rather than the individual frames or the graph it carries.

Avoid when

• Avoid for a single log within the file (use gmeow:GTSSegment) and for the content claims the document carries (those are ordinary quads); the document is the transport envelope, never the truth of its payload.

How to use

• Link its ordered segments with gmeow:gtsSegment and read its composite identity off the segment heads (gmeow:gtsHeadId taken in gmeow:gtsSegmentIndex order); record production and compaction lineage with gmeow:wasGeneratedBy / gmeow:wasDerivedFrom rather than on the segments.

Examples

• ex:bundle a gmeow:GTSDocument; gmeow:gtsSegment ex:seg0.