Skip to the page
The Comprise Index What Comprise is Comprise Connect

Comprise OES · edition 0.7.0 · revised 13 Nov 2026

Comprise OES

Every item of this volume as a card: its fields as the volume holds them. The app's fabula density adds facets, live examples and the local graph.

S · Structure

sections (99)

S:section/root Comprise OES

Comprise OES is the MiniCOSM for companies

id
S:section/root
type
section
summary
Comprise OES is the MiniCOSM for companies: the format of a Holotype, one company described in plain-text .cosm files that are at once a file system and a relational database.
level
1
parts
S:section/contents, S:section/how-to-read-this, S:section/1, S:section/2, S:section/3, S:section/4, S:section/5, S:section/6, S:section/7, S:section/8, S:section/9, S:section/10, S:section/11, S:section/12, S:section/13, S:section/14, S:section/colophon
mentions
S:section/14, S:section/13.3, S:section/2.5, S:section/2.3, S:section/6, T:term/checks
anchor
comprise-oes
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1-L33"],"confidence":1,"state":"known"}

read it at short

S:section/how-to-read-this How to read this

The words a person reads on screen come first

id
S:section/how-to-read-this
type
section
summary
The words a person reads on screen come first; they are the product's, and this text borrows them.
level
2
parent
S:section/root
mentions
S:section/5, T:term/concern, T:term/relationship, T:term/outside-organization, T:term/open-question
anchor
how-to-read-this
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L51-L86"],"confidence":1,"state":"known"}

read it at short

S:section/1 The map

A Holotype is a file system that is also a relational database

id
S:section/1
type
section
summary
A Holotype is a file system that is also a relational database.
number
1
level
2
parent
S:section/root
mentions
S:section/6, T:term/concern, T:term/group, T:term/kind, T:term/item, T:term/relationship, T:term/outside-organization, T:term/open-question, T:term/checks, T:term/the-local-database, T:term/export-for-agents, T:term/renderer
anchor
sec-1
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L87-L126"],"confidence":1,"state":"known"}

read it at short

S:section/2 The volume

The volume: Layout, The catalog: holotype.cosm, The declaration: oes: comprise/1, Module files

id
S:section/2
type
section
summary
The volume: Layout, The catalog: holotype.cosm, The declaration: oes: comprise/1, Module files
number
2
level
2
parent
S:section/root
parts
S:section/2.1, S:section/2.2, S:section/2.3, S:section/2.4, S:section/2.5, S:section/2.6, S:section/2.7, S:section/2.8
anchor
sec-2
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L127-L128"],"confidence":1,"state":"known"}

read it at short

S:section/2.1 Layout

A module folder's letter is read case-insensitively (p/ loads as P/)

id
S:section/2.1
type
section
summary
A module folder's letter is read case-insensitively (p/ loads as P/); a writer must write the capital.
number
2.1
level
3
parent
S:section/2
mentions
S:section/12, T:term/concern
anchor
sec-2-1
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L129-L152"],"confidence":1,"state":"known"}

read it at short

S:section/2.3 The declaration: oes: comprise/1

A Holotype says which MiniCOSM it is written in with one line in its catalog

id
S:section/2.3
type
section
summary
A Holotype says which MiniCOSM it is written in with one line in its catalog:
number
2.3
level
3
parent
S:section/2
mentions
T:term/checks
anchor
sec-2-3
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L179-L202"],"confidence":1,"state":"known"}

read it at short

S:section/2.4 Module files

A module file is a .cosm file anywhere under atoms/<concern>/<letter>/, at any depth

id
S:section/2.4
type
section
summary
A module file is a .cosm file anywhere under atoms/<concern>/<letter>/, at any depth (R/reflections/*.cosm is legal).
number
2.4
level
3
parent
S:section/2
mentions
S:section/6.4.2, T:term/kind, T:term/item, T:term/concern
anchor
sec-2-4
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L203-L227"],"confidence":1,"state":"known"}

read it at short

S:section/2.5 Reading a file

UTF-8, with or without a byte-order mark; CRLF and LF read the same

id
S:section/2.5
type
section
summary
UTF-8, with or without a byte-order mark; CRLF and LF read the same.
number
2.5
level
3
parent
S:section/2
mentions
T:term/checks
anchor
sec-2-5
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L228-L236"],"confidence":1,"state":"known"}

read it at short

S:section/2.6 E: people are never in a file

atoms/<concern>/E/ holds a README saying where the people are, or a none.cosm with module

id
S:section/2.6
type
section
summary
atoms/<concern>/E/ holds a README saying where the people are, or a none.cosm with module: none and a reason.
number
2.6
level
3
parent
S:section/2
mentions
S:section/13.3, T:term/concern, T:term/the-local-database, T:term/checks, T:term/item
anchor
sec-2-6
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L237-L243"],"confidence":1,"state":"known"}

read it at short

S:section/2.7 Other folders

vendors/ (3.5) and snapshots/ (10) are read-only to the app

id
S:section/2.7
type
section
summary
vendors/ (3.5) and snapshots/ (10) are read-only to the app.
number
2.7
level
3
parent
S:section/2
mentions
T:term/item, T:term/checks
anchor
sec-2-7
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L244-L250"],"confidence":1,"state":"known"}

read it at short

S:section/2.8 The local database

store.sqlite, one per Holotype

id
S:section/2.8
type
section
summary
store.sqlite, one per Holotype.
number
2.8
level
3
parent
S:section/2
mentions
T:term/kind, T:term/standing
anchor
sec-2-8
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L251-L266"],"confidence":1,"state":"known"}

read it at short

S:section/3 Concerns and relationships

Concerns and relationships: Concerns (atoms), Relationships (bonds), Outside organizations (stubs), Groups

id
S:section/3
type
section
summary
Concerns and relationships: Concerns (atoms), Relationships (bonds), Outside organizations (stubs), Groups
number
3
level
2
parent
S:section/root
parts
S:section/3.1, S:section/3.2, S:section/3.3, S:section/3.4, S:section/3.5
anchor
sec-3
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L267-L268"],"confidence":1,"state":"known"}

read it at short

S:section/3.1 Concerns (atoms)

A concern is one bounded whole, described on its own

id
S:section/3.1
type
section
summary
A concern is one bounded whole, described on its own.
number
3.1
level
3
parent
S:section/3
mentions
T:term/relationship
anchor
sec-3-1
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L269-L292"],"confidence":1,"state":"known"}

read it at short

S:section/3.2 Relationships (bonds)

A relationship is a typed, dated, sourced tie between two concerns

id
S:section/3.2
type
section
summary
A relationship is a typed, dated, sourced tie between two concerns, or between a concern and an outside organization, a group or a vendor-published atom.
number
3.2
level
3
parent
S:section/3
mentions
S:section/9.3, T:term/concern, T:term/group, T:term/item, T:term/kind, T:term/outside-organization
anchor
sec-3-2
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L293-L341"],"confidence":1,"state":"known"}

read it at short

S:section/3.3 Outside organizations (stubs)

An outside organization is one the Holotype names but does not model

id
S:section/3.3
type
section
summary
An outside organization is one the Holotype names but does not model: a bank, a platform, a supplier, a former company.
number
3.3
level
3
parent
S:section/3
mentions
T:term/item, T:term/kind, T:term/concern, T:term/relationship
anchor
sec-3-3
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L342-L355"],"confidence":1,"state":"known"}

read it at short

S:section/3.4 Groups

A group (atom group) is a named set of concerns

id
S:section/3.4
type
section
summary
A group (atom group) is a named set of concerns ("the group", a reporting segment), declared in the catalog's groups:.
number
3.4
level
3
parent
S:section/3
mentions
T:term/concern, T:term/relationship
anchor
sec-3-4
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L356-L361"],"confidence":1,"state":"known"}

read it at short

S:section/3.5 Vendor-published atoms

A vendor may publish one of its concerns at https://<domain>/.well-known/comprise/<slug>/

id
S:section/3.5
type
section
summary
A vendor may publish one of its concerns at https://<domain>/.well-known/comprise/<slug>/: its public files, a manifest of hashes, an attestation and the public keys (python -m core publish).
number
3.5
level
3
parent
S:section/3
mentions
S:section/6.4.5, T:term/concern, T:term/relationship, T:term/outside-organization, T:term/item
anchor
sec-3-5
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L362-L377"],"confidence":1,"state":"known"}

read it at short

S:section/4 The envelope

Every item carries the same envelope: the system columns of every table

id
S:section/4
type
section
summary
Every item carries the same envelope: the system columns of every table.
number
4
level
2
parent
S:section/root
parts
S:section/4.1, S:section/4.2, S:section/4.3
mentions
S:section/8, S:section/5, T:term/item, T:term/concern, T:term/kind, T:term/open-question, T:term/the-local-database, T:term/group
anchor
sec-4
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L378-L406"],"confidence":1,"state":"known"}

read it at short

S:section/4.1 P is different

Items in P (chapter P) carry COSM's identity instead

id
S:section/4.1
type
section
summary
Items in P (chapter P) carry COSM's identity instead: confidence and sources at the top level rather than a provenance block, owner required (P's identity-min), consensus optional, and kind on the brand.
number
4.1
level
3
parent
S:section/4
mentions
T:term/item, T:term/checks
anchor
sec-4-1
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L407-L414"],"confidence":1,"state":"known"}

read it at short

S:section/4.2 Visibility

A hidden item is absent, not refused

id
S:section/4.2
type
section
summary
A hidden item is absent, not refused: lists leave it out, its page answers as one that does not exist, renderers never draw it, and a reference to it from a visible item keeps the id but gains no name.
number
4.2
level
3
parent
S:section/4
mentions
T:term/concern, T:term/item, T:term/renderer
anchor
sec-4-2
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L415-L428"],"confidence":1,"state":"known"}

read it at short

S:section/4.3 Provenance

Sources or it didn't happen

id
S:section/4.3
type
section
summary
Sources or it didn't happen.
number
4.3
level
3
parent
S:section/4
mentions
T:term/item
anchor
sec-4-3
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L429-L445"],"confidence":1,"state":"known"}

read it at short

S:section/5 The eight modules

Every concern has the eight modules, C · O · M · P · R…

id
S:section/5
type
section
summary
Every concern has the eight modules, C · O · M · P · R · I · S · E.
number
5
level
2
parent
S:section/root
parts
S:section/chapter-c-corporation, S:section/chapter-o-organizations, S:section/chapter-m-markets, S:section/chapter-p-products-the-product-tree, S:section/chapter-r-representations-and-reflections, S:section/chapter-i-inventories, S:section/chapter-s-stacks, S:section/chapter-e-employees
mentions
S:section/7, S:section/9, T:term/concern, T:term/kind
anchor
sec-5
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L446-L454"],"confidence":1,"state":"known"}

read it at short

S:section/chapter-o-organizations Chapter O · Organizations

Roles, teams, seats and who decides

id
S:section/chapter-o-organizations
type
section
summary
Roles, teams, seats and who decides.
level
3
parent
S:section/5
mentions
T:term/kind
anchor
chapter-o-organizations
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L480-L492"],"confidence":1,"state":"known"}

read it at short

S:section/chapter-m-markets Chapter M · Markets

Chapter M · Markets, in The eight modules

id
S:section/chapter-m-markets
type
section
summary
Chapter M · Markets, in The eight modules
level
3
parent
S:section/5
mentions
T:term/kind
anchor
chapter-m-markets
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L493-L508"],"confidence":1,"state":"known"}

read it at short

S:section/chapter-p-products-the-product-tree Chapter P · Products: the product tree

What it offers, and why that matters

id
S:section/chapter-p-products-the-product-tree
type
section
summary
What it offers, and why that matters.
level
3
parent
S:section/5
parts
S:section/P.1, S:section/P.2, S:section/P.3, S:section/P.4, S:section/P.5, S:section/P.6, S:section/P.7, S:section/P.8, S:section/P.9, S:section/P.10, S:section/P.11, S:section/P.12
mentions
S:section/14
anchor
chapter-p-products-the-product-tree
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L509-L516"],"confidence":1,"state":"known"}

read it at short

S:section/P.3 The nine questions (aspects)

Every item answers nine questions

id
S:section/P.3
type
section
summary
Every item answers nine questions.
number
P.3
level
4
parent
S:section/chapter-p-products-the-product-tree
parts
S:section/P.3.1, S:section/P.3.2, S:section/P.3.3, S:section/P.3.4, S:section/P.3.5, S:section/P.3.6, S:section/P.3.7, S:section/P.3.8, S:section/P.3.9
mentions
T:term/item, T:term/concern
anchor
p-3-the-nine-questions-aspects
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L561-L576"],"confidence":1,"state":"known"}

read it at short

S:section/P.3.1 identity

identity, in The nine questions (aspects)

id
S:section/P.3.1
type
section
summary
identity, in The nine questions (aspects)
number
P.3.1
level
5
parent
S:section/P.3
mentions
T:term/kind, T:term/item
anchor
p-3-1-identity
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L577-L592"],"confidence":1,"state":"known"}

read it at short

S:section/P.3.2 flow

flow, in The nine questions (aspects)

id
S:section/P.3.2
type
section
summary
flow, in The nine questions (aspects)
number
P.3.2
level
5
parent
S:section/P.3
mentions
T:term/item
anchor
p-3-2-flow
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L593-L604"],"confidence":1,"state":"known"}

read it at short

S:section/P.3.3 substrate

substrate, in The nine questions (aspects)

id
S:section/P.3.3
type
section
summary
substrate, in The nine questions (aspects)
number
P.3.3
level
5
parent
S:section/P.3
anchor
p-3-3-substrate
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L605-L614"],"confidence":1,"state":"known"}

read it at short

S:section/P.3.4 rules

A rule is written as "<actor> <aim> <object>" under must, may or must-not

id
S:section/P.3.4
type
section
summary
A rule is written as "<actor> <aim> <object>" under must, may or must-not.
number
P.3.4
level
5
parent
S:section/P.3
anchor
p-3-4-rules
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L615-L628"],"confidence":1,"state":"known"}

read it at short

S:section/P.3.5 principles

principles, in The nine questions (aspects)

id
S:section/P.3.5
type
section
summary
principles, in The nine questions (aspects)
number
P.3.5
level
5
parent
S:section/P.3
mentions
T:term/item
anchor
p-3-5-principles
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L629-L638"],"confidence":1,"state":"known"}

read it at short

S:section/P.3.6 economics

Every offering has a price, none, or an open question (rule 3)

id
S:section/P.3.6
type
section
summary
Every offering has a price, none, or an open question (rule 3).
number
P.3.6
level
5
parent
S:section/P.3
mentions
T:term/open-question
anchor
p-3-6-economics
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L639-L649"],"confidence":1,"state":"known"}

read it at short

S:section/P.3.7 vocabulary

vocabulary, in The nine questions (aspects)

id
S:section/P.3.7
type
section
summary
vocabulary, in The nine questions (aspects)
number
P.3.7
level
5
parent
S:section/P.3
mentions
T:term/item
anchor
p-3-7-vocabulary
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L650-L658"],"confidence":1,"state":"known"}

read it at short

S:section/P.3.8 affect

Offerings must declare affect; other items may

id
S:section/P.3.8
type
section
summary
Offerings must declare affect; other items may.
number
P.3.8
level
5
parent
S:section/P.3
mentions
T:term/item
anchor
p-3-8-affect
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L659-L670"],"confidence":1,"state":"known"}

read it at short

S:section/P.5.1 Relations

Six relations

id
S:section/P.5.1
type
section
summary
Six relations.
number
P.5.1
level
5
parent
S:section/P.5
mentions
T:term/item
anchor
p-5-1-relations
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L699-L716"],"confidence":1,"state":"known"}

read it at short

S:section/P.5.2 Externals

In a Holotype, P declares no externals of its own

id
S:section/P.5.2
type
section
summary
In a Holotype, P declares no externals of its own.
number
P.5.2
level
5
parent
S:section/P.5
mentions
T:term/kind, T:term/concern
anchor
p-5-2-externals
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L717-L731"],"confidence":1,"state":"known"}

read it at short

S:section/P.5.3 Inheritance

Three aspects flow down the tree; six do not

id
S:section/P.5.3
type
section
summary
Three aspects flow down the tree; six do not.
number
P.5.3
level
5
parent
S:section/P.5
mentions
S:section/13.3, T:term/item
anchor
p-5-3-inheritance
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L732-L747"],"confidence":1,"state":"known"}

read it at short

S:section/P.11 (withdrawn)

Chapter P.11 was withdrawn in edition 0.5.4

id
S:section/P.11
type
section
summary
Chapter P.11 was withdrawn in edition 0.5.4; its content, where it survives, is in the Changes appendix (section 14).
number
P.11
level
4
parent
S:section/chapter-p-products-the-product-tree
mentions
S:section/14
anchor
p-11-withdrawn
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L888-L891"],"confidence":1,"state":"known"}

read it at short

S:section/P.12 (withdrawn)

Chapter P.12 was withdrawn in edition 0.5.4

id
S:section/P.12
type
section
summary
Chapter P.12 was withdrawn in edition 0.5.4; its content, where it survives, is in the Changes appendix (section 14).
number
P.12
level
4
parent
S:section/chapter-p-products-the-product-tree
mentions
S:section/14
anchor
p-12-withdrawn
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L892-L895"],"confidence":1,"state":"known"}

read it at short

S:section/chapter-r-representations-and-reflections Chapter R · Representations and reflections

Chapter R · Representations and reflections, in The eight modules

id
S:section/chapter-r-representations-and-reflections
type
section
summary
Chapter R · Representations and reflections, in The eight modules
level
3
parent
S:section/5
mentions
T:term/kind, T:term/concern, T:term/item
anchor
chapter-r-representations-and-reflections
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L896-L908"],"confidence":1,"state":"known"}

read it at short

S:section/chapter-i-inventories Chapter I · Inventories

SKUs a feed brings in live in the local database, not the files

id
S:section/chapter-i-inventories
type
section
summary
SKUs a feed brings in live in the local database, not the files; a mapping row may name one (section 7.4).
level
3
parent
S:section/5
mentions
S:section/7.4, T:term/kind, T:term/item, T:term/the-local-database
anchor
chapter-i-inventories
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L909-L926"],"confidence":1,"state":"known"}

read it at short

S:section/chapter-s-stacks Chapter S · Stacks

A codebase may point at a fabulac, the fabula of a folder of source code

id
S:section/chapter-s-stacks
type
section
summary
A codebase may point at a fabulac, the fabula of a folder of source code, as MacroCOSM OES (https://macro.cosmoes.org/), its section 18.4.7, defines it, in its fabula field: the path of a .fabulac.cosm file inside the Holotype, relative to its root and written with /, conventionally under codebases/ (fabula: codebases/firefox.fabulac.cosm).
level
3
parent
S:section/5
mentions
S:section/7, T:term/kind, T:term/item
anchor
chapter-s-stacks
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L927-L955"],"confidence":1,"state":"known"}

read it at short

S:section/6 Paths

Every concern, module, kind, item and field has a path

id
S:section/6
type
section
summary
Every concern, module, kind, item and field has a path: its id respelled as a location.
number
6
level
2
parent
S:section/root
parts
S:section/6.1, S:section/6.2, S:section/6.3, S:section/6.4, S:section/6.5, S:section/6.6, S:section/6.7
mentions
T:term/concern, T:term/kind, T:term/item
anchor
sec-6
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L976-L986"],"confidence":1,"state":"known"}

read it at short

S:section/6.2 Grammar

A kind segment must be a kind of that module in the manifest

id
S:section/6.2
type
section
summary
A kind segment must be a kind of that module in the manifest; brand is accepted in P (6.4.1).
number
6.2
level
3
parent
S:section/6
mentions
T:term/kind, T:term/item, T:term/concern
anchor
sec-6-2
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L999-L1017"],"confidence":1,"state":"known"}

read it at short

S:section/6.3 From an id to a path, and back

The module and kind levels have no id; the path is their only name

id
S:section/6.3
type
section
summary
The module and kind levels have no id; the path is their only name.
number
6.3
level
3
parent
S:section/6
mentions
T:term/concern, T:term/group, T:term/kind, T:term/item
anchor
sec-6-3
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1018-L1033"],"confidence":1,"state":"known"}

read it at short

S:section/6.4 Edge cases, settled

Edge cases, settled: P's brand item, Kinds that share a file, Relationships, Outside organizations

id
S:section/6.4
type
section
summary
Edge cases, settled: P's brand item, Kinds that share a file, Relationships, Outside organizations
number
6.4
level
3
parent
S:section/6
parts
S:section/6.4.1, S:section/6.4.2, S:section/6.4.3, S:section/6.4.4, S:section/6.4.5, S:section/6.4.6, S:section/6.4.7, S:section/6.4.8
anchor
sec-6-4
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1034-L1035"],"confidence":1,"state":"known"}

read it at short

S:section/6.4.2 Kinds that share a file

The kind level is a table, not a file

id
S:section/6.4.2
type
section
summary
The kind level is a table, not a file.
number
6.4.2
level
4
parent
S:section/6.4
mentions
T:term/kind, T:term/item
anchor
sec-6-4-2
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1050-L1055"],"confidence":1,"state":"known"}

read it at short

S:section/6.4.4 Outside organizations

An outside organization is an ordinary item of C: mozilla-corporation/C/counterparty/google

id
S:section/6.4.4
type
section
summary
An outside organization is an ordinary item of C: mozilla-corporation/C/counterparty/google.
number
6.4.4
level
4
parent
S:section/6.4
mentions
T:term/outside-organization, T:term/item
anchor
sec-6-4-4
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1069-L1073"],"confidence":1,"state":"known"}

read it at short

S:section/6.4.5 Vendor-published atoms

A vendor-published atom's path is its id, vendor/<domain>/<slug>, and nothing below it

id
S:section/6.4.5
type
section
summary
A vendor-published atom's path is its id, vendor/<domain>/<slug>, and nothing below it.
number
6.4.5
level
4
parent
S:section/6.4
mentions
T:term/item, T:term/concern
anchor
sec-6-4-5
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1074-L1081"],"confidence":1,"state":"known"}

read it at short

S:section/6.4.7 The qualified form

For use outside one install, a path is qualified with the MiniCOSM and the Holotype

id
S:section/6.4.7
type
section
summary
For use outside one install, a path is qualified with the MiniCOSM and the Holotype:
number
6.4.7
level
4
parent
S:section/6.4
anchor
sec-6-4-7
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1100-L1116"],"confidence":1,"state":"known"}

read it at short

S:section/6.4.8 Case, characters and what has no path

Ids and paths are case-sensitive and keep their case: meadow/O/role/Founder

id
S:section/6.4.8
type
section
summary
Ids and paths are case-sensitive and keep their case: meadow/O/role/Founder.
number
6.4.8
level
4
parent
S:section/6.4
mentions
S:section/13.3, T:term/item, T:term/checks, T:term/group
anchor
sec-6-4-8
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1117-L1130"],"confidence":1,"state":"known"}

read it at short

S:section/6.6 Scope and safety

A path to something the reader may not see answers exactly as its id would

id
S:section/6.6
type
section
summary
A path to something the reader may not see answers exactly as its id would: the same 404, no name, no link.
number
6.6
level
3
parent
S:section/6
mentions
T:term/checks, T:term/kind
anchor
sec-6-6
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1146-L1157"],"confidence":1,"state":"known"}

read it at short

S:section/6.7 Examples

Every example in this document resolves on the reference implementation's sample Holotypes

id
S:section/6.7
type
section
summary
Every example in this document resolves on the reference implementation's sample Holotypes.
number
6.7
level
3
parent
S:section/6
mentions
T:term/concern, T:term/item, T:term/relationship, T:term/outside-organization, T:term/open-question
anchor
sec-6-7
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1158-L1189"],"confidence":1,"state":"known"}

read it at short

S:section/7.2 Where references are checked

The envelope's reference fields (section 4) and each kind's reference fields

id
S:section/7.2
type
section
summary
The envelope's reference fields (section 4) and each kind's reference fields (section 5) are checked as references: each value must be an id string of one of the forms above that resolves, or a sentinel, or an open question.
number
7.2
level
3
parent
S:section/7
mentions
S:section/4, S:section/5, T:term/kind, T:term/open-question
anchor
sec-7-2
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1210-L1215"],"confidence":1,"state":"known"}

read it at short

S:section/7.3 Resolution

A bare id resolves in its own concern's module

id
S:section/7.3
type
section
summary
A bare id resolves in its own concern's module; a qualified id in the named concern; atom/<slug> to the concern; vendor/… to the fetched vendor.
number
7.3
level
3
parent
S:section/7
mentions
T:term/concern
anchor
sec-7-3
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1216-L1226"],"confidence":1,"state":"known"}

read it at short

S:section/7.4 Scope

A reference to an item the reader may not see stays as the id…

id
S:section/7.4
type
section
summary
A reference to an item the reader may not see stays as the id with no name (4.2).
number
7.4
level
3
parent
S:section/7
mentions
T:term/item
anchor
sec-7-4
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1227-L1231"],"confidence":1,"state":"known"}

read it at short

S:section/7.5 Named relations

The cross-module relations have names (owner, holds, serves, sold-through, priced-by, maps-to or entitles, listed-on, runs-on…

id
S:section/7.5
type
section
summary
The cross-module relations have names (owner, holds, serves, sold-through, priced-by, maps-to or entitles, listed-on, runs-on, presents, about, bound-by, shared-with, feeds, attributed-to, at, twin, counterparty, licensed-by, requires-credential, member-of).
number
7.5
level
3
parent
S:section/7
mentions
T:term/checks
anchor
sec-7-5
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1232-L1240"],"confidence":1,"state":"known"}

read it at short

S:section/9.3 The fourteen rules

Each rule reports one of: pass, fail, unverifiable, finding

id
S:section/9.3
type
section
summary
Each rule reports one of: pass, fail, unverifiable, finding.
number
9.3
level
3
parent
S:section/9
mentions
T:term/checks, T:term/item, T:term/kind, T:term/relationship, T:term/concern, T:term/outside-organization, T:term/group, T:term/the-local-database
anchor
sec-9-3
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1326-L1350"],"confidence":1,"state":"known"}

read it at short

S:section/9.4 The verdict

ok: no error and no failed rule

id
S:section/9.4
type
section
summary
ok: no error and no failed rule.
number
9.4
level
3
parent
S:section/9
anchor
sec-9-4
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1351-L1357"],"confidence":1,"state":"known"}

read it at short

S:section/10 Versions

A saved version (snapshot) is an immutable copy of the model files at a moment

id
S:section/10
type
section
summary
A saved version (snapshot) is an immutable copy of the model files at a moment, at snapshots/<stamp>/: the catalog, everything under atoms/, the fabulacs under codebases/, the bindings and the fetched vendors; never the local database, the people file, feed payloads or scan runs.
number
10
level
2
parent
S:section/root
mentions
T:term/concern, T:term/item, T:term/checks, T:term/standing, T:term/open-question
anchor
sec-10
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1358-L1379"],"confidence":1,"state":"known"}

read it at short

S:section/11.3 The isotype: a view, default-deny

The isotype (comprise-isotype/0) is a separate document with a fixed schema

id
S:section/11.3
type
section
summary
The isotype (comprise-isotype/0) is a separate document with a fixed schema, computed from the Holotype by rules, one rule per field.
number
11.3
level
3
parent
S:section/11
mentions
S:section/14.7, T:term/relationship, T:term/concern, T:term/item, T:term/standing
anchor
sec-11-3
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1409-L1483"],"confidence":1,"state":"known"}

read it at short

S:section/11.4 The outside chart: comprise-paratype/0

An outsider's isotype of a subject, at third-party standing and never the subject's word

id
S:section/11.4
type
section
summary
An outsider's isotype of a subject, at third-party standing and never the subject's word.
number
11.4
level
3
parent
S:section/11
mentions
T:term/standing, T:term/kind
anchor
sec-11-4
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1484-L1523"],"confidence":1,"state":"known"}

read it at short

S:section/11.5 The sealed package: a cryptotype

The owner's encrypted package of a Holotype, or of a program's projection of it

id
S:section/11.5
type
section
summary
The owner's encrypted package of a Holotype, or of a program's projection of it, handed with a key to a chosen party.
number
11.5
level
3
parent
S:section/11
mentions
T:term/kind, T:term/item, T:term/standing
anchor
sec-11-5
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1524-L1560"],"confidence":1,"state":"known"}

read it at short

S:section/13.3 What the checks verify, and what they do not

the load, the oes: declaration included (2.3); the id grammar; kinds per module

id
S:section/13.3
type
section
summary
the load, the oes: declaration included (2.3); the id grammar; kinds per module; the envelope's closed lists, required fields and provenance; owners are roles; every reference resolves (with the exceptions in 7.3); relationship kinds and bases; aims; a codebase's fabulac; P's per-item checks, releases included, and seven conditions; the fourteen rules.
number
13.3
level
3
parent
S:section/13
mentions
T:term/kind, T:term/relationship, T:term/checks, T:term/item, T:term/concern
anchor
sec-13-3
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1618-L1633"],"confidence":1,"state":"known"}

read it at short

S:section/13.4 (withdrawn)

Section 13.4 was withdrawn in edition 0.5.4

id
S:section/13.4
type
section
summary
Section 13.4 was withdrawn in edition 0.5.4; its content, where it survives, is in the Changes appendix (section 14).
number
13.4
level
3
parent
S:section/13
mentions
S:section/14
anchor
sec-13-4
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1634-L1639"],"confidence":1,"state":"known"}

read it at short

S:section/14 Changes

Newest first

id
S:section/14
type
section
summary
Newest first.
number
14
level
2
parent
S:section/root
mentions
S:section/8, S:section/10, S:section/2.8, S:section/12, S:section/11, S:section/13.4, S:section/4, S:section/11.4, S:section/11.5, S:section/11.3, S:section/3, S:section/6, T:term/item, T:term/checks, T:term/kind, T:term/concern, T:term/standing, T:term/group, T:term/renderer, T:term/relationship, T:term/open-question, T:term/outside-organization, T:term/the-local-database
anchor
sec-14
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1640-L1768"],"confidence":1,"state":"known"}

read it at short

S:section/colophon Colophon

Comprise OES — Copyright © 2026 Graham Smith

id
S:section/colophon
type
section
summary
Comprise OES — Copyright © 2026 Graham Smith.
level
2
parent
S:section/root
anchor
colophon
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1769-L1771"],"confidence":1,"state":"known"}

read it at short

decisions (32)

S:decision/1 Entailment

A release is an entailment made by rule

id
S:decision/1
type
decision
summary
(11.3).
number
1
in
S:section/14
edition
0.7.0
dated
2026-11-13
about
T:term/item
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1647-L1650"],"confidence":1,"state":"known"}
  1. Entailment (11.3). A release is an entailment made by rule: the Holotype entails its isotype, and what is projected holds by construction. The line built by rule from an item's summary and its public children is offers[].entailed, seeks[].entailed and open_to[].entailed, and the move that writes it is entailment; told and telling, their earlier spellings, are read for good and never written (11.3, 13.1).

S:decision/2 Beside the Index, the Allograph Registry

Beside the Index, the Allograph Registry

id
S:decision/2
type
decision
summary
(11.3).
number
2
in
S:section/14
edition
0.7.0
dated
2026-11-13
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1651-L1654"],"confidence":1,"state":"known"}
  1. Beside the Index, the Allograph Registry (11.3). Comprise Connect also serves Ascribe's registry, with the Index's accounts, passkeys and rate limits. A company listed on the Index may own an agent listed there and may attest work a person or an agent did for it, by a statement signed with the key that signs its current isotype; the registry names the company by its Index handle and holds nothing of its Holotype.

S:decision/3 Stewardship

The colophon licenses the text under CC BY 4.0 and makes the OWFa 1.0 promise…

id
S:decision/3
type
decision
summary
The colophon licenses the text under CC BY 4.0 and makes the OWFa 1.0 promise for it; the names of the family are not licensed, and the author holds them for now.
number
3
in
S:section/14
edition
0.7.0
dated
2026-11-13
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1655-L1656"],"confidence":1,"state":"known"}
  1. Stewardship. The colophon licenses the text under CC BY 4.0 and makes the OWFa 1.0 promise for it; the names of the family are not licensed, and the author holds them for now.

S:decision/4 Where Comprise OES stands

Where Comprise OES stands

id
S:decision/4
type
decision
summary
The lead says there are two MiniCOSMs, Comprise OES and Ascribe, both written in MacroCOSM OES, an OES: the shared grammar and its core, which holds the formats built into every reader, the densities and the dialectic; Thym is named the transcognition language that connects OESes (the lead and 11.3).
number
4
in
S:section/14
edition
0.6.0
dated
2026-11-06
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1660-L1663"],"confidence":1,"state":"known"}
  1. Where Comprise OES stands. The lead says there are two MiniCOSMs, Comprise OES and Ascribe, both written in MacroCOSM OES, an OES: the shared grammar and its core, which holds the formats built into every reader, the densities and the dialectic; Thym is named the transcognition language that connects OESes (the lead and 11.3). The status paragraph names the steward.

S:decision/5 Elicitation is the dialectic

Elicitation is the dialectic

id
S:decision/5
type
decision
summary
(section 8).
number
5
in
S:section/14
edition
0.6.0
dated
2026-11-06
about
S:section/8
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1664-L1670"],"confidence":1,"state":"known"}
  1. Elicitation is the dialectic (section 8). The question banks are the dialectic banks of the manifest, each kept in a file of Comprise OES's own that the bank names in from:. A sitting is a session of the dialectic, written as a D:session record in the catalog's new sessions: (2.2) beside the source the catalog already declares for it, its id still spelled elicit-<date>-<hex>; ask, check and commit, "I don't know" and who is asked are said against the core's primitive. Provenance written before, {mode: dialectic, sources: [elicit-…]}, stays valid as written. Sessions join the catalog entries that have no path (6.4.8).

S:decision/6 S:codebase gains fabula

S:codebase gains fabula

id
S:decision/6
type
decision
summary
(chapter S): an optional path to a fabulac inside the Holotype, by convention under codebases/ (2.1, 2.7), checked by codebase-fabula (9.2, 13.3), its atem line shown beside the codebase.
number
6
in
S:section/14
edition
0.6.0
dated
2026-11-06
about
S:section/10
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1671-L1673"],"confidence":1,"state":"known"}
  1. S:codebase gains fabula (chapter S): an optional path to a fabulac inside the Holotype, by convention under codebases/ (2.1, 2.7), checked by codebase-fabula (9.2, 13.3), its atem line shown beside the codebase. Comprise OES reads a fabulac and never builds one. A saved version copies codebases/ (section 10).

S:decision/7 P:release is resolved

P:release is resolved

id
S:decision/7
type
decision
summary
The first edition recorded a disagreement: P:release declared in the schema and rejected by P's checks as an unknown kind.
number
7
in
S:section/14
edition
0.6.0
dated
2026-11-06
about
T:term/checks, T:term/kind, T:term/item
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1674-L1677"],"confidence":1,"state":"known"}
  1. P:release is resolved. The first edition recorded a disagreement: P:release declared in the schema and rejected by P's checks as an unknown kind. In this edition P's checks know release, a kind outside the levels: no parts, in no item's parts, naming its unit, its visibility its unit's (P.2, P.3.1; in P.9, type, orphan and the new release). The reference implementation's checks were corrected.

S:decision/8 access is described

access is described

id
S:decision/8
type
decision
summary
(chapter E): one row per person per concern holding a level, and for a steward the modules; it holds no personal data and is not sealed.
number
8
in
S:section/14
edition
0.6.0
dated
2026-11-06
about
S:section/2.8, T:term/concern
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1678-L1680"],"confidence":1,"state":"known"}
  1. access is described (chapter E): one row per person per concern holding a level, and for a steward the modules; it holds no personal data and is not sealed. Section 2.8 says it is the people tables' personal fields that are sealed.

S:decision/9 The isotype's schema line

The isotype's schema line

id
S:decision/9
type
decision
summary
(11.3) names its optional keys, program and trace among them; an outside chart still requires both (11.4).
number
9
in
S:section/14
edition
0.6.0
dated
2026-11-06
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1681-L1682"],"confidence":1,"state":"known"}
  1. The isotype's schema line (11.3) names its optional keys, program and trace among them; an outside chart still requires both (11.4).

S:decision/10 Words

Section 12 names the reserved tellings for one audience as shorts

id
S:decision/10
type
decision
summary
Section 12 names the reserved tellings for one audience as shorts; the trade's word for them is dropped.
number
10
in
S:section/14
edition
0.6.0
dated
2026-11-06
about
S:section/12
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1683"],"confidence":1,"state":"known"}
  1. Words. Section 12 names the reserved tellings for one audience as shorts; the trade's word for them is dropped.

S:decision/11 Edition 0.5.4 · 2026-11-03, second revision

Edition 0.5.4 · 2026-11-03, second revision

id
S:decision/11
type
decision
summary
Rules the reference implementation keeps and this text had not stated are written in: the logo file served script-free (2.1); a sample's names and mark (2.2); team members named by account id (2.8); standing and its proven levels (section 11); fees and promoted entries (11.3); the holder's handle, the monthly limit and what agreement counts and never means (11.4); a reduced copy's record, what a withdrawal cannot recall, and a finder's words to an owner (11.5); reading, never writing, through another system's tool (13.1).
number
11
in
S:section/14
edition
0.5.4
dated
2026-11-03
about
S:section/11, T:term/standing
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1685-L1689"],"confidence":1,"state":"known"}

Edition 0.5.4 · 2026-11-03, second revision. Rules the reference implementation keeps and this text had not stated are written in: the logo file served script-free (2.1); a sample's names and mark (2.2); team members named by account id (2.8); standing and its proven levels (section 11); fees and promoted entries (11.3); the holder's handle, the monthly limit and what agreement counts and never means (11.4); a reduced copy's record, what a withdrawal cannot recall, and a finder's words to an owner (11.5); reading, never writing, through another system's tool (13.1).

S:decision/12 Edition 0.5.4 · 2026-11-03

Edition 0.5.4 · 2026-11-03

id
S:decision/12
type
decision
summary
The canonical edition, published at https://comprise.cosmoes.org/.
number
12
in
S:section/14
edition
0.5.4
dated
2026-11-03
about
S:section/13.4, S:section/4, S:section/14, T:term/kind, T:term/group, T:term/renderer, T:term/item
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1691-L1703"],"confidence":1,"state":"known"}

Edition 0.5.4 · 2026-11-03. The canonical edition, published at https://comprise.cosmoes.org/. The name carries no number: Comprise OES, describing the comprise/1 MiniCOSM; the dated introduction gives way to the status line and the lead. Comprise, the product, is named as the reference implementation in place of its code, and "the code wins" gives way to this appendix's rule. Chapter P.11 (what COSM 0.3 described and the implementation did not build), chapter P.12 (where COSM 0.3's text and the implementation disagreed) and section 13.4 (where the code wins) are withdrawn: P.11's and P.12's substance is recorded in the entry for 2026-10-20 below, 13.4's rules stand in their own sections, and its rule for at: site/… is folded into section 4. The not built markers are withdrawn and each gap is stated where it falls as reserved for a later edition (SQL views per kind, groups as perspectives, the substrate and rules views, the resolution of P:release, a globally unique Holotype name and a resolver for qualified paths, further opt-in isotype fields, style-profile renderers). The manifest's rules, formerly among the decisions of 2026-10-20, are folded into "How to read this". Status passages, decision and slice references, repository paths, pointers to planning documents and the item counts of the sample Holotypes are removed; the cross-references to Thym and to the overview are their cosmoes.org homes. Section 14, "Decisions in this version", becomes this appendix.

S:decision/13 Edition 1 · 2026-11-03, the outside chart and the sealed package

Edition 1 · 2026-11-03, the outside chart and the sealed package

id
S:decision/13
type
decision
summary
Section 11.4, the outside chart (comprise-paratype/0), and section 11.5, the sealed package (a cryptotype: a Thym package in its encrypted form), are added, and section 11.3 gains what a release may also carry and the dial, a release as a program's projection.
number
13
in
S:section/14
edition
1
dated
2026-11-03
about
S:section/11.4, S:section/11.5, S:section/11.3
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1705-L1709"],"confidence":1,"state":"known"}

Edition 1 · 2026-11-03, the outside chart and the sealed package. Section 11.4, the outside chart (comprise-paratype/0), and section 11.5, the sealed package (a cryptotype: a Thym package in its encrypted form), are added, and section 11.3 gains what a release may also carry and the dial, a release as a program's projection. They write down rulings made on 2026-11-02; Comprise 0.3.0, the reference implementation that carries them, shipped on 2026-11-04.

S:decision/14 One document

One document

id
S:decision/14
type
decision
summary
The product tree is chapter P and the other seven modules are chapters of the same shape.
number
14
in
S:section/14
edition
1
dated
2026-10-20
about
S:section/10, S:section/3, T:term/checks, T:term/concern, T:term/relationship, T:term/open-question
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1713-L1723"],"confidence":1,"state":"known"}
  1. One document. The product tree is chapter P and the other seven modules are chapters of the same shape. COSM 0.3's normative text survives in chapter P. What COSM 0.3 described beyond the description of a tree is not part of the format: simulation (units as queues, aggregates by min-cut, role variance as jitter, rule gates, affect probes, scenarios); whatif, harmonize, propose, rank, uat, qa and hooks (the findings in doc.cosm keep harmonize's words); depersonalize (the no-humans checks find, a person fixes); export to JSON-LD, Turtle, OWL, SHACL, ArchiMate and CSV, and import; save, put, remove, where, upstream, downstream, glossary, capacity and cost as an API (the app's editor writes through the checks); sketch, the tree written back as shorthand (expand is kept). The Remote Assistance Protocol is replaced by grants in the catalog, proposals a person accepts and the audit; the State Library (history, diff, at, attest) by saved and signed versions (section 10); firms within firms by concerns and relationships (section 3). COSM 0.3's own open questions (mattering shares, an affect scale, product internals) are not taken up.

S:decision/15 Where COSM 0.3's text and this edition differ, this edition holds

Where COSM 0.3's text and this edition differ, this edition holds

id
S:decision/15
type
decision
summary
The tree's version is 0.3 (the brand and restricted added), and P files say cosm: 0.3.
number
15
in
S:section/14
edition
1
dated
2026-10-20
about
T:term/item, T:term/checks
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1724-L1732"],"confidence":1,"state":"known"}
  1. Where COSM 0.3's text and this edition differ, this edition holds. The tree's version is 0.3 (the brand and restricted added), and P files say cosm: 0.3. rule-syntax is a warning when the actor is not a role (an external may also be an actor) and an error only for a rule with no aim. no-humans is a warning for a pronoun and a note for a name-like pair; outside P, a pronoun in name or summary is a warning and a pointer to E:person from an unrestricted item an error. term-resolves and no-weakening are not checked. role-exists covers the owner only. Rule-consistency compares a must and a must-not with the same text. Flow balance is always within 10%. The equilibrium conditions are seven. A saved version is always taken and records the verdict; only signing is refused. Any *.cosm under P is read; brand.cosm, nodes.cosm and doc.cosm are the convention. P:release is declared in the schema and rejected by P's checks: a disagreement recorded, not resolved.

S:decision/16 Paths are a pure respelling of ids

Paths are a pure respelling of ids

id
S:decision/16
type
decision
summary
(section 6): no lookup, no index; every item of the sample Holotypes round-trips.
number
16
in
S:section/14
edition
1
dated
2026-10-20
about
S:section/6, T:term/item
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1733-L1734"],"confidence":1,"state":"known"}
  1. Paths are a pure respelling of ids (section 6): no lookup, no index; every item of the sample Holotypes round-trips.

S:decision/17 The brand's path is <concern>/P/brand/<slug>

The brand's path is <concern>/P/brand/<slug>

id
S:decision/17
type
decision
summary
, mapping to P:<slug>; one-to-one because P:brand/<slug> is never a valid id.
number
17
in
S:section/14
edition
1
dated
2026-10-20
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1735-L1736"],"confidence":1,"state":"known"}
  1. The brand's path is <concern>/P/brand/<slug>, mapping to P:<slug>; one-to-one because P:brand/<slug> is never a valid id. <concern>/P/<slug> is not a path.

S:decision/18 The kind level is a table, never a file

The kind level is a table, never a file

id
S:decision/18
type
decision
summary
Neither ids nor paths name files; the file is metadata.
number
18
in
S:section/14
edition
1
dated
2026-10-20
about
T:term/kind
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1737"],"confidence":1,"state":"known"}
  1. The kind level is a table, never a file. Neither ids nor paths name files; the file is metadata.

S:decision/19 A relationship has one path per copy

A relationship has one path per copy

id
S:decision/19
type
decision
summary
, each in its own concern; the copy in the from concern is the one to cite.
number
19
in
S:section/14
edition
1
dated
2026-10-20
about
T:term/relationship, T:term/concern
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1738"],"confidence":1,"state":"known"}
  1. A relationship has one path per copy, each in its own concern; the copy in the from concern is the one to cite.

S:decision/20 Outside organizations are ordinary C items

Outside organizations are ordinary C items

id
S:decision/20
type
decision
summary
Their global id is a field, not part of a path.
number
20
in
S:section/14
edition
1
dated
2026-10-20
about
T:term/outside-organization, T:term/item
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1739"],"confidence":1,"state":"known"}
  1. Outside organizations are ordinary C items. Their global id is a field, not part of a path.

S:decision/21 A vendor-published atom is addressed only as a whole

A vendor-published atom is addressed only as a whole

id
S:decision/21
type
decision
summary
, vendor/<domain>/<slug>, which is also its id.
number
21
in
S:section/14
edition
1
dated
2026-10-20
about
T:term/item, T:term/concern
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1740-L1742"],"confidence":1,"state":"known"}
  1. A vendor-published atom is addressed only as a whole, vendor/<domain>/<slug>, which is also its id. Its items are addressed in the vendor's own Holotype by the qualified form. The case of the second segment keeps it apart from a concern called vendor.

S:decision/22 Fields use the checks' own field paths

Fields use the checks' own field paths

id
S:decision/22
type
decision
summary
after #: keys by ., list positions by [n] from zero.
number
22
in
S:section/14
edition
1
dated
2026-10-20
about
T:term/checks, T:term/item, T:term/open-question
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1743-L1744"],"confidence":1,"state":"known"}
  1. Fields use the checks' own field paths after #: keys by ., list positions by [n] from zero. Fields only follow items. An open question on a whole item is the item's path.

S:decision/23 The qualified form is oes:comprise/<holotype>/<path>

, with the Holotype's id slug and no version

id
S:decision/23
type
decision
summary
, with the Holotype's id slug and no version.
number
23
in
S:section/14
edition
1
dated
2026-10-20
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1745-L1747"],"confidence":1,"state":"known"}
  1. The qualified form is oes:comprise/<holotype>/<path>, with the Holotype's id slug and no version. A path keeps its meaning across versions of a MiniCOSM; a change of meaning is a new MiniCOSM. A globally unique Holotype name is reserved for a later edition.

S:decision/24 Case is kept and significant

Case is kept and significant

id
S:decision/24
type
decision
summary
A slug's characters are [A-Za-z0-9._@-], with no trailing dot.
number
24
in
S:section/14
edition
1
dated
2026-10-20
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1748-L1749"],"confidence":1,"state":"known"}
  1. Case is kept and significant. A slug's characters are [A-Za-z0-9._@-], with no trailing dot. An id outside them has no path. A warning for such ids, and for ids that differ only in case, is not specified as a check.

S:decision/25 One spelling

One spelling

id
S:decision/25
type
decision
summary
A reader refuses a malformed path rather than normalizing it: no trailing slash, no .., no %.
number
25
in
S:section/14
edition
1
dated
2026-10-20
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1750"],"confidence":1,"state":"known"}
  1. One spelling. A reader refuses a malformed path rather than normalizing it: no trailing slash, no .., no %.

S:decision/26 The catalog's entries have no path

The catalog's entries have no path

id
S:decision/26
type
decision
summary
(sources, grants, groups, attestations).
number
26
in
S:section/14
edition
1
dated
2026-10-20
about
T:term/group
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1751"],"confidence":1,"state":"known"}
  1. The catalog's entries have no path (sources, grants, groups, attestations).

S:decision/27 When a catalog has both oes: and comprise:, oes: decides

When a catalog has both oes: and comprise:, oes: decides

id
S:decision/27
type
decision
summary
An unknown version of a known MiniCOSM is refused like an unknown MiniCOSM.
number
27
in
S:section/14
edition
1
dated
2026-10-20
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1752-L1754"],"confidence":1,"state":"known"}
  1. When a catalog has both oes: and comprise:, oes: decides. An unknown version of a known MiniCOSM is refused like an unknown MiniCOSM. A new catalog carries the declaration as its first line, so a person or a tool sees it without parsing the file.

S:decision/28 P files keep cosm: 0.3

P files keep cosm: 0.3

id
S:decision/28
type
decision
summary
It is the product tree's format version, read by P's checks, and says nothing about the MiniCOSM.
number
28
in
S:section/14
edition
1
dated
2026-10-20
about
T:term/checks
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1755-L1756"],"confidence":1,"state":"known"}
  1. P files keep cosm: 0.3. It is the product tree's format version, read by P's checks, and says nothing about the MiniCOSM.

S:decision/29 The manifest is a .cosm file outside every Holotype

The manifest is a .cosm file outside every Holotype

id
S:decision/29
type
decision
summary
A Holotype names its MiniCOSM by the declaration only and never embeds the manifest.
number
29
in
S:section/14
edition
1
dated
2026-10-20
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1757-L1759"],"confidence":1,"state":"known"}
  1. The manifest is a .cosm file outside every Holotype. A Holotype names its MiniCOSM by the declaration only and never embeds the manifest. The word manifest has two senses in Comprise: this declaration of a language, and the hash list of a saved version, a backup or a published atom; they never meet on screen.

S:decision/30 The manifest's fields per kind are the schema's reference fields, exactly

The manifest's fields per kind are the schema's reference fields, exactly

id
S:decision/30
type
decision
summary
, plus the fields a check reads.
number
30
in
S:section/14
edition
1
dated
2026-10-20
about
T:term/kind, T:term/the-local-database
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1760-L1761"],"confidence":1,"state":"known"}
  1. The manifest's fields per kind are the schema's reference fields, exactly, plus the fields a check reads. Every other field is open. P lists its nine aspects. E's kinds are marked as stored in the local database.

S:decision/31 An absent visibility outside P reads as internal

An absent visibility outside P reads as internal

id
S:decision/31
type
decision
summary
: visible to every signed-in reader, never public.
number
31
in
S:section/14
edition
1
dated
2026-10-20
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1762"],"confidence":1,"state":"known"}
  1. An absent visibility outside P reads as internal: visible to every signed-in reader, never public.

S:decision/32 Words

The text says concern, item, relationship, open question, outside organization and kind

id
S:decision/32
type
decision
summary
The text says concern, item, relationship, open question, outside organization and kind, with the model's term in parentheses where exactness needs it.
number
32
in
S:section/14
edition
1
dated
2026-10-20
about
T:term/concern, T:term/item, T:term/relationship, T:term/open-question, T:term/outside-organization, T:term/kind
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1763-L1765"],"confidence":1,"state":"known"}
  1. Words. The text says concern, item, relationship, open question, outside organization and kind, with the model's term in parentheses where exactness needs it. Ids, file names and check names keep the model's words, because they are the format.

T · Terms

terms (15)

T:term/item item

item, called node in the files

id
T:term/item
type
term
summary
node
defined_in
S:section/how-to-read-this
in_the_files
node
example
<Module>:<kind>/<slug>
convention
glossary
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L63"],"confidence":1,"state":"known"}

T:term/kind kind

kind, called type in the files

id
T:term/kind
type
term
summary
type
defined_in
S:section/how-to-read-this
in_the_files
type
example
type:
convention
glossary
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L63"],"confidence":1,"state":"known"}

T:term/checks checks

lint, equilibrium rules

id
T:term/checks
type
term
summary
lint, equilibrium rules
defined_in
S:section/how-to-read-this
in_the_files
lint, equilibrium rules
example
python -m core lint
convention
glossary
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L66"],"confidence":1,"state":"known"}

T:term/saved-version-signed-version saved version, signed version

saved version, signed version, called snapshot, attestation in the files

id
T:term/saved-version-signed-version
type
term
summary
snapshot, attestation
defined_in
S:section/how-to-read-this
in_the_files
snapshot, attestation
example
snapshots/<stamp>/
convention
glossary
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L67"],"confidence":1,"state":"known"}

T:term/the-local-database the local database

the local database, called store in the files

id
T:term/the-local-database
type
term
summary
store
defined_in
S:section/how-to-read-this
in_the_files
store
example
store.sqlite
convention
glossary
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L68"],"confidence":1,"state":"known"}

T:term/export-for-agents export for agents

export for agents, called pack in the files

id
T:term/export-for-agents
type
term
summary
pack
defined_in
S:section/how-to-read-this
in_the_files
pack
example
CONTEXT.md
convention
glossary
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L69"],"confidence":1,"state":"known"}

T:term/concern concern

one bounded whole, described on its own

id
T:term/concern
type
term
summary
A concern is one bounded whole, described on its own.
defined_in
S:section/3.1
convention
sentence
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L271"],"confidence":1,"state":"known"}
in_the_files
atom

T:term/relationship relationship

a typed, dated, sourced tie between two concerns

id
T:term/relationship
type
term
summary
A relationship is a typed, dated, sourced tie between two concerns, or between a concern and an outside organization, a group or a vendor-published atom.
defined_in
S:section/3.2
convention
sentence
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L295"],"confidence":1,"state":"known"}
in_the_files
bond

T:term/outside-organization outside organization

one the Holotype names but does not model

id
T:term/outside-organization
type
term
summary
An outside organization is one the Holotype names but does not model: a bank, a platform, a supplier, a former company.
defined_in
S:section/3.3
convention
sentence
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L344"],"confidence":1,"state":"known"}
in_the_files
stub

T:term/group group

a named set of concerns ("the group", a reporting segment), declared in the catalog's groups

id
T:term/group
type
term
summary
A group (atom group) is a named set of concerns ("the group", a reporting segment), declared in the catalog's groups:.
defined_in
S:section/3.4
convention
sentence
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L358"],"confidence":1,"state":"known"}

T:term/open-question open question

a value nobody has yet given, written where the value would go

id
T:term/open-question
type
term
summary
An open question (pending) is a value nobody has yet given, written where the value would go:
defined_in
S:section/8
convention
sentence
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1243"],"confidence":1,"state":"known"}
in_the_files
pending

T:term/ok ok

no error and no failed rule

id
T:term/ok
type
term
summary
no error and no failed rule.
defined_in
S:section/9.4
convention
bullet
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1353"],"confidence":1,"state":"known"}

T:term/attest-allowed ATTEST: allowed

ok, and no rule unverifiable

id
T:term/attest-allowed
type
term
summary
ok, and no rule unverifiable.
defined_in
S:section/9.4
convention
bullet
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1354"],"confidence":1,"state":"known"}

T:term/standing Standing

whether the people keeping a Holotype speak for its subject, and to what proven level

id
T:term/standing
type
term
summary
Standing is whether the people keeping a Holotype speak for its subject, and to what proven level: the domain, the legal entity, the person acting for it.
defined_in
S:section/11
convention
sentence
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1385"],"confidence":1,"state":"known"}

T:term/renderer renderer

turns a Holotype into another form

id
T:term/renderer
type
term
summary
A renderer turns a Holotype into another form.
defined_in
S:section/12
convention
sentence
provenance
{"mode":"derived","sources":["specs/comprise-oes.md#L1563"],"confidence":1,"state":"known"}

The canonical edition is comprise.cosmoes.org; this copy was refreshed 13 Nov 2026.