Comprise OES 1
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 (96)
S:section/root Comprise OES 1
The code in core/ is the reference reader and writer
- id
- S:section/root
- type
- section
- summary
- Normative.
- 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
- mentions
- S:section/13.4, S:section/2.5, S:section/2.3, S:section/6
- anchor
- comprise-oes-1
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1-L16"],"confidence":1,"state":"known"}
S:section/contents Contents
Contents, in Comprise OES 1
- id
- S:section/contents
- type
- section
- summary
- Contents, in Comprise OES 1
- level
- 2
- parent
- S:section/root
- mentions
- T:term/concern, T:term/relationship, T:term/open-question, T:term/checks, T:term/renderer
- anchor
- contents
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L17-L33"],"confidence":1,"state":"known"}
S:section/how-to-read-this How to read this
The words a person reads on screen come first (they are MO.md's)
- id
- S:section/how-to-read-this
- type
- section
- summary
- The words a person reads on screen come first (they are MO.md's).
- level
- 2
- parent
- S:section/root
- mentions
- T:term/concern, T:term/relationship, T:term/outside-organization, T:term/open-question
- anchor
- how-to-read-this
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L34-L64"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L65-L104"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L105-L106"],"confidence":1,"state":"known"}
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
- T:term/concern
- anchor
- sec-2-1
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L107-L126"],"confidence":1,"state":"known"}
S:section/2.2 The catalog: holotype.cosm
One YAML mapping
- id
- S:section/2.2
- type
- section
- summary
- One YAML mapping.
- number
- 2.2
- level
- 3
- parent
- S:section/2
- mentions
- T:term/concern, T:term/renderer, T:term/item, T:term/checks, T:term/group, T:term/relationship, T:term/the-local-database
- anchor
- sec-2-2
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L127-L149"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L150-L176"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L177-L201"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L202-L210"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L211-L217"],"confidence":1,"state":"known"}
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/checks
- anchor
- sec-2-7
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L218-L223"],"confidence":1,"state":"known"}
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
- anchor
- sec-2-8
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L224-L237"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L238-L239"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L240-L263"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L264-L312"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L313-L326"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L327-L332"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L333-L348"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L349-L377"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L378-L385"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L386-L399"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L400-L416"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L417-L425"],"confidence":1,"state":"known"}
S:section/chapter-c-corporation Chapter C · Corporation
The legal body: ownership, contracts, filings, money
- id
- S:section/chapter-c-corporation
- type
- section
- summary
- The legal body: ownership, contracts, filings, money.
- level
- 3
- parent
- S:section/5
- mentions
- T:term/kind, T:term/concern, T:term/relationship, T:term/item, T:term/outside-organization
- anchor
- chapter-c-corporation
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L426-L450"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L451-L463"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L464-L479"],"confidence":1,"state":"known"}
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
- anchor
- chapter-p-products-the-product-tree
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L480-L485"],"confidence":1,"state":"known"}
S:section/P.1 What P describes
P describes what a concern offers as a tree under its brand
- id
- S:section/P.1
- type
- section
- summary
- P describes what a concern offers as a tree under its brand: the whole it sells under one face.
- number
- P.1
- level
- 4
- parent
- S:section/chapter-p-products-the-product-tree
- mentions
- T:term/concern, T:term/item, T:term/kind
- anchor
- p-1-what-p-describes
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L486-L495"],"confidence":1,"state":"known"}
S:section/P.2 Levels (strata)
Five levels
- id
- S:section/P.2
- type
- section
- summary
- Five levels.
- number
- P.2
- level
- 4
- parent
- S:section/chapter-p-products-the-product-tree
- mentions
- T:term/item, T:term/kind, T:term/checks
- anchor
- p-2-levels-strata
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L496-L525"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L526-L541"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L542-L557"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L558-L569"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L570-L579"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L580-L593"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L594-L603"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L604-L614"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L615-L623"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L624-L635"],"confidence":1,"state":"known"}
S:section/P.3.9 mattering
The aspect the rest exist for
- id
- S:section/P.3.9
- type
- section
- summary
- The aspect the rest exist for.
- number
- P.3.9
- level
- 5
- parent
- S:section/P.3
- mentions
- T:term/item, T:term/open-question
- anchor
- p-3-9-mattering
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L636-L652"],"confidence":1,"state":"known"}
S:section/P.4 Roles, not people
People never appear in P
- id
- S:section/P.4
- type
- section
- summary
- People never appear in P.
- number
- P.4
- level
- 4
- parent
- S:section/chapter-p-products-the-product-tree
- mentions
- T:term/checks, T:term/item
- anchor
- p-4-roles-not-people
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L653-L661"],"confidence":1,"state":"known"}
S:section/P.5 Relations and inheritance
Relations and inheritance: Relations, Externals, Inheritance
- id
- S:section/P.5
- type
- section
- summary
- Relations and inheritance: Relations, Externals, Inheritance
- number
- P.5
- level
- 4
- parent
- S:section/chapter-p-products-the-product-tree
- parts
- S:section/P.5.1, S:section/P.5.2, S:section/P.5.3
- anchor
- p-5-relations-and-inheritance
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L662-L663"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L664-L681"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L682-L696"],"confidence":1,"state":"known"}
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
- T:term/item
- anchor
- p-5-3-inheritance
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L697-L712"],"confidence":1,"state":"known"}
S:section/P.6 The sketch (shorthand)
For whiteboards, interviews and chat
- id
- S:section/P.6
- type
- section
- summary
- For whiteboards, interviews and chat.
- number
- P.6
- level
- 4
- parent
- S:section/chapter-p-products-the-product-tree
- mentions
- T:term/item, T:term/open-question, T:term/kind
- anchor
- p-6-the-sketch-shorthand
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L713-L744"],"confidence":1,"state":"known"}
S:section/P.7 The files of P
cosm: 0.3 heads each file
- id
- S:section/P.7
- type
- section
- summary
- cosm: 0.3 heads each file.
- number
- P.7
- level
- 4
- parent
- S:section/chapter-p-products-the-product-tree
- mentions
- T:term/item, T:term/kind, T:term/concern
- anchor
- p-7-the-files-of-p
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L745-L765"],"confidence":1,"state":"known"}
S:section/P.8 Drawings
Every drawing is a view over the same items, never drawn by hand
- id
- S:section/P.8
- type
- section
- summary
- Every drawing is a view over the same items, never drawn by hand.
- number
- P.8
- level
- 4
- parent
- S:section/chapter-p-products-the-product-tree
- mentions
- S:section/12, T:term/item, T:term/renderer
- anchor
- p-8-drawings
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L766-L793"],"confidence":1,"state":"known"}
S:section/P.9 P's checks
Two levels
- id
- S:section/P.9
- type
- section
- summary
- Two levels.
- number
- P.9
- level
- 4
- parent
- S:section/chapter-p-products-the-product-tree
- mentions
- S:section/9, T:term/checks, T:term/kind, T:term/item, T:term/concern, T:term/open-question
- anchor
- p-9-p-s-checks
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L794-L843"],"confidence":1,"state":"known"}
S:section/P.10 How P renders for an audience
The internal rendering holds everything
- id
- S:section/P.10
- type
- section
- summary
- The internal rendering holds everything.
- number
- P.10
- level
- 4
- parent
- S:section/chapter-p-products-the-product-tree
- mentions
- T:term/open-question, T:term/checks, T:term/item
- anchor
- p-10-how-p-renders-for-an-audience
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L844-L851"],"confidence":1,"state":"known"}
S:section/P.11 What COSM 0.3 described that Comprise OES 1 does not build
Kept as the map of where P can go
- id
- S:section/P.11
- type
- section
- summary
- Kept as the map of where P can go.
- number
- P.11
- level
- 4
- parent
- S:section/chapter-p-products-the-product-tree
- mentions
- S:section/10, S:section/3, T:term/checks, T:term/open-question, T:term/concern, T:term/relationship
- anchor
- p-11-what-cosm-0-3-described-that-comprise-oes-1
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L852-L867"],"confidence":1,"state":"known"}
S:section/P.12 Where COSM 0.3's text and the code disagree
The code wins in every row
- id
- S:section/P.12
- type
- section
- summary
- The code wins in every row.
- number
- P.12
- level
- 4
- parent
- S:section/chapter-p-products-the-product-tree
- mentions
- S:section/10, T:term/item, T:term/checks, T:term/kind
- anchor
- p-12-where-cosm-0-3-s-text-and-the-code-disagree
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L868-L886"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L887-L899"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L900-L917"],"confidence":1,"state":"known"}
S:section/chapter-s-stacks Chapter S · Stacks
Chapter S · Stacks, in The eight modules
- id
- S:section/chapter-s-stacks
- type
- section
- summary
- Chapter S · Stacks, in The eight modules
- level
- 3
- parent
- S:section/5
- mentions
- T:term/kind
- anchor
- chapter-s-stacks
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L918-L931"],"confidence":1,"state":"known"}
S:section/chapter-e-employees Chapter E · Employees
The people: counted here, never named
- id
- S:section/chapter-e-employees
- type
- section
- summary
- The people: counted here, never named.
- level
- 3
- parent
- S:section/5
- mentions
- T:term/kind, T:term/the-local-database
- anchor
- chapter-e-employees
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L932-L951"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L952-L962"],"confidence":1,"state":"known"}
S:section/6.1 Properties
A respelling
- id
- S:section/6.1
- type
- section
- summary
- A respelling.
- number
- 6.1
- level
- 3
- parent
- S:section/6
- mentions
- T:term/item, T:term/concern
- anchor
- sec-6-1
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L963-L974"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L975-L993"],"confidence":1,"state":"known"}
S:section/6.3 From an id to a path, and back
The module and kind levels have no id today; the path is their only name
- id
- S:section/6.3
- type
- section
- summary
- The module and kind levels have no id today; 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":["defaults/cosm/chapters/comprise-oes.md#L994-L1009"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L1010-L1011"],"confidence":1,"state":"known"}
S:section/6.4.1 P's brand item
The brand's id has no kind: P:<slug>
- id
- S:section/6.4.1
- type
- section
- summary
- The brand's id has no kind: P:<slug>.
- number
- 6.4.1
- level
- 4
- parent
- S:section/6.4
- mentions
- T:term/kind, T:term/checks, T:term/item, T:term/concern
- anchor
- sec-6-4-1
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1012-L1025"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L1026-L1031"],"confidence":1,"state":"known"}
S:section/6.4.3 Relationships
A relationship between two concerns is written in both (3.2), with one id
- id
- S:section/6.4.3
- type
- section
- summary
- A relationship between two concerns is written in both (3.2), with one id.
- number
- 6.4.3
- level
- 4
- parent
- S:section/6.4
- mentions
- T:term/relationship, T:term/concern, T:term/outside-organization
- anchor
- sec-6-4-3
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1032-L1044"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L1045-L1049"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L1050-L1057"],"confidence":1,"state":"known"}
S:section/6.4.6 Fields
The field path is the one the checks already write for open questions
- id
- S:section/6.4.6
- type
- section
- summary
- # and a field path name a field of an item.
- number
- 6.4.6
- level
- 4
- parent
- S:section/6.4
- mentions
- T:term/item, T:term/checks, T:term/open-question
- anchor
- sec-6-4-6
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1058-L1075"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L1076-L1092"],"confidence":1,"state":"known"}
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
- T:term/item, T:term/checks, T:term/group
- anchor
- sec-6-4-8
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1093-L1106"],"confidence":1,"state":"known"}
S:section/6.5 Where paths are accepted
Beside ids, never instead of them
- id
- S:section/6.5
- type
- section
- summary
- Beside ids, never instead of them:
- number
- 6.5
- level
- 3
- parent
- S:section/6
- mentions
- T:term/concern, T:term/item, T:term/open-question, T:term/kind
- anchor
- sec-6-5
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1107-L1124"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L1125-L1136"],"confidence":1,"state":"known"}
S:section/6.7 Examples
Every example in this document resolves on the fixtures
- id
- S:section/6.7
- type
- section
- summary
- Every example in this document resolves on the fixtures; the read-only script that checks them prints each with its id.
- number
- 6.7
- level
- 3
- parent
- S:section/6
- mentions
- T:term/checks, 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":["defaults/cosm/chapters/comprise-oes.md#L1137-L1168"],"confidence":1,"state":"known"}
S:section/7 References
A reference is an id written in a field: a foreign key
- id
- S:section/7
- type
- section
- summary
- A reference is an id written in a field: a foreign key.
- number
- 7
- level
- 2
- parent
- S:section/root
- parts
- S:section/7.1, S:section/7.2, S:section/7.3, S:section/7.4, S:section/7.5
- anchor
- sec-7
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1169-L1172"],"confidence":1,"state":"known"}
S:section/7.1 Forms
An item's own id is written bare in its concern's files
- id
- S:section/7.1
- type
- section
- summary
- An item's own id is written bare in its concern's files; an item id that names another concern is an error (id-atom).
- number
- 7.1
- level
- 3
- parent
- S:section/7
- mentions
- S:section/8, T:term/item, T:term/concern, T:term/open-question
- anchor
- sec-7-1
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1173-L1188"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L1189-L1194"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L1195-L1205"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L1206-L1210"],"confidence":1,"state":"known"}
S:section/7.5 Named relations
plan/comprise-model.md names the cross-module relations (owner, holds, serves, sold-through, priced-by, maps-to or entitles, listed-on, runs-on…
- id
- S:section/7.5
- type
- section
- summary
- plan/comprise-model.md names the cross-module relations (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":["defaults/cosm/chapters/comprise-oes.md#L1211-L1219"],"confidence":1,"state":"known"}
S:section/8 Open questions
An open question (pending) is a value nobody has yet given
- id
- S:section/8
- type
- section
- summary
- An open question (pending) is a value nobody has yet given, written where the value would go:
- number
- 8
- level
- 2
- parent
- S:section/root
- mentions
- T:term/item, T:term/checks
- anchor
- sec-8
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1220-L1242"],"confidence":1,"state":"known"}
S:section/9 Checks
The checks (lint) are the constraints of the database, run on the whole Holotype
- id
- S:section/9
- type
- section
- summary
- The checks (lint) are the constraints of the database, run on the whole Holotype: python -m core lint <dir>.
- number
- 9
- level
- 2
- parent
- S:section/root
- parts
- S:section/9.1, S:section/9.2, S:section/9.3, S:section/9.4
- mentions
- T:term/checks
- anchor
- sec-9
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1243-L1247"],"confidence":1,"state":"known"}
S:section/9.1 What runs
What runs, in Checks
- id
- S:section/9.1
- type
- section
- summary
- What runs, in Checks
- number
- 9.1
- level
- 3
- parent
- S:section/9
- mentions
- S:section/4, S:section/7, T:term/item, T:term/checks, T:term/concern
- anchor
- sec-9-1
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1248-L1255"],"confidence":1,"state":"known"}
S:section/9.2 The envelope's checks
The envelope's checks, in Checks
- id
- S:section/9.2
- type
- section
- summary
- The envelope's checks, in Checks
- number
- 9.2
- level
- 3
- parent
- S:section/9
- mentions
- S:section/7.3, S:section/3.2, T:term/concern, T:term/kind, T:term/item
- anchor
- sec-9-2
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1256-L1274"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L1275-L1299"],"confidence":1,"state":"known"}
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":["defaults/cosm/chapters/comprise-oes.md#L1300-L1306"],"confidence":1,"state":"known"}
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 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/the-local-database, T:term/concern, T:term/item, T:term/checks, T:term/open-question
- anchor
- sec-10
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1307-L1327"],"confidence":1,"state":"known"}
S:section/11 The private/public split
Two formats, not one format with a setting
- id
- S:section/11
- type
- section
- summary
- Two formats, not one format with a setting.
- number
- 11
- level
- 2
- parent
- S:section/root
- parts
- S:section/11.1, S:section/11.2, S:section/11.3
- anchor
- sec-11
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1328-L1332"],"confidence":1,"state":"known"}
S:section/11.1 The private side
The files stay on the subject's machine
- id
- S:section/11.1
- type
- section
- summary
- The files stay on the subject's machine.
- number
- 11.1
- level
- 3
- parent
- S:section/11
- mentions
- T:term/the-local-database, T:term/item
- anchor
- sec-11-1
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1333-L1343"],"confidence":1,"state":"known"}
S:section/11.2 Renderings for an audience
Renderings for an audience, in The private/public split
- id
- S:section/11.2
- type
- section
- summary
- Renderings for an audience, in The private/public split
- number
- 11.2
- level
- 3
- parent
- S:section/11
- mentions
- T:term/open-question, T:term/checks, T:term/item
- anchor
- sec-11-2
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1344-L1352"],"confidence":1,"state":"known"}
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
- T:term/relationship, T:term/concern, T:term/item
- anchor
- sec-11-3
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1353-L1393"],"confidence":1,"state":"known"}
S:section/12 Renderers
A renderer turns a Holotype into another form
- id
- S:section/12
- type
- section
- summary
- A renderer turns a Holotype into another form.
- number
- 12
- level
- 2
- parent
- S:section/root
- mentions
- T:term/item, T:term/concern, T:term/kind, T:term/relationship
- anchor
- sec-12
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1394-L1418"],"confidence":1,"state":"known"}
S:section/13 Conformance
Conformance: A reader must, A writer must, What the checks verify
- id
- S:section/13
- type
- section
- summary
- Conformance: A reader must, A writer must, What the checks verify
- number
- 13
- level
- 2
- parent
- S:section/root
- parts
- S:section/13.1, S:section/13.2, S:section/13.3, S:section/13.4
- anchor
- sec-13
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1419-L1420"],"confidence":1,"state":"known"}
S:section/13.1 A reader must
A reader must, in Conformance
- id
- S:section/13.1
- type
- section
- summary
- A reader must, in Conformance
- number
- 13.1
- level
- 3
- parent
- S:section/13
- mentions
- S:section/7, S:section/6, T:term/concern, T:term/kind, T:term/item, T:term/the-local-database
- anchor
- sec-13-1
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1421-L1434"],"confidence":1,"state":"known"}
S:section/13.2 A writer must
A writer must, in Conformance
- id
- S:section/13.2
- type
- section
- summary
- A writer must, in Conformance
- number
- 13.2
- level
- 3
- parent
- S:section/13
- mentions
- T:term/concern, T:term/kind, T:term/item, T:term/the-local-database, T:term/open-question, T:term/checks
- anchor
- sec-13-2
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1435-L1445"],"confidence":1,"state":"known"}
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; P's per-item checks 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":["defaults/cosm/chapters/comprise-oes.md#L1446-L1460"],"confidence":1,"state":"known"}
S:section/13.4 Where the code wins
Besides chapter P.12
- id
- S:section/13.4
- type
- section
- summary
- Besides chapter P.12:
- number
- 13.4
- level
- 3
- parent
- S:section/13
- mentions
- S:section/6, S:section/8, S:section/5, S:section/4, S:section/1, T:term/kind, T:term/item
- anchor
- sec-13-4
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1461-L1475"],"confidence":1,"state":"known"}
S:section/14 Decisions in this version
Made by the writer of slice 30b, 2026-10-20, without asking, as the brief required
- id
- S:section/14
- type
- section
- summary
- Made by the writer of slice 30b, 2026-10-20, without asking, as the brief required.
- number
- 14
- level
- 2
- parent
- S:section/root
- mentions
- T:term/item, T:term/kind, T:term/relationship, T:term/concern, T:term/outside-organization, T:term/checks, T:term/open-question, T:term/group
- anchor
- sec-14
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1476-L1518"],"confidence":1,"state":"known"}
decisions (19)
S:decision/1 The spec is one document
The spec is one document
- id
- S:decision/1
- type
- decision
- summary
- , with the product tree as chapter P and the other seven modules as chapters of the same shape.
- number
- 1
- in
- S:section/14
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1481-L1482"],"confidence":1,"state":"known"}
- The spec is one document, with the product tree as chapter P and the other seven modules as chapters of the same shape. COSM 0.3's normative text survives in chapter P; its unbuilt API is a table (P.11).
S:decision/2 Paths are a pure respelling of ids
Paths are a pure respelling of ids
- id
- S:decision/2
- type
- decision
- summary
- No lookup, no index.
- number
- 2
- in
- S:section/14
- about
- T:term/item
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1483"],"confidence":1,"state":"known"}
- Paths are a pure respelling of ids. No lookup, no index. Checked: all 1,227 items of the six fixtures round-trip.
S:decision/3 The brand's path is <concern>/P/brand/<slug>
The brand's path is <concern>/P/brand/<slug>
- id
- S:decision/3
- type
- decision
- summary
- , mapping to P:<slug>.
- number
- 3
- in
- S:section/14
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1484-L1485"],"confidence":1,"state":"known"}
- The brand's path is
<concern>/P/brand/<slug>, mapping toP:<slug>. One-to-one becauseP:brand/<slug>is never a valid id.<concern>/P/<slug>is not a path.
S:decision/4 The kind level is a table, never a file
The kind level is a table, never a file
- id
- S:decision/4
- type
- decision
- summary
- Neither ids nor paths name files; the file is metadata.
- number
- 4
- in
- S:section/14
- about
- T:term/kind
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1486"],"confidence":1,"state":"known"}
- The kind level is a table, never a file. Neither ids nor paths name files; the file is metadata.
S:decision/5 A relationship has one path per copy
A relationship has one path per copy
- id
- S:decision/5
- type
- decision
- summary
- , each in its own concern; cite the copy in the from concern.
- number
- 5
- in
- S:section/14
- about
- T:term/relationship, T:term/concern
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1487"],"confidence":1,"state":"known"}
- A relationship has one path per copy, each in its own concern; cite the copy in the
fromconcern.
S:decision/6 Outside organizations are ordinary C items
Outside organizations are ordinary C items
- id
- S:decision/6
- type
- decision
- summary
- Their global id is a field, not part of a path.
- number
- 6
- in
- S:section/14
- about
- T:term/outside-organization, T:term/item
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1488"],"confidence":1,"state":"known"}
- Outside organizations are ordinary C items. Their global id is a field, not part of a path.
S:decision/7 A vendor-published atom is addressed only as a whole
A vendor-published atom is addressed only as a whole
- id
- S:decision/7
- type
- decision
- summary
- , vendor/<domain>/<slug>, which is also its id.
- number
- 7
- in
- S:section/14
- about
- T:term/item, T:term/concern
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1489-L1491"],"confidence":1,"state":"known"}
- 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 calledvendor.
S:decision/8 Fields use the checks' own field paths
Fields use the checks' own field paths
- id
- S:decision/8
- type
- decision
- summary
- after #: keys by ., list positions by [n] from zero.
- number
- 8
- in
- S:section/14
- about
- T:term/checks, T:term/item, T:term/open-question
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1492-L1493"],"confidence":1,"state":"known"}
- 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/9 The qualified form is oes:comprise/<holotype>/<path>
, with the Holotype's id slug and no version
- id
- S:decision/9
- type
- decision
- summary
- , with the Holotype's id slug and no version.
- number
- 9
- in
- S:section/14
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1494-L1495"],"confidence":1,"state":"known"}
- The qualified form is
oes:comprise/<holotype>/<path>, with the Holotype's id slug and no version. A path must keep its meaning across versions; a change of meaning is a new MiniCOSM. A globally unique Holotype name is not built.
S:decision/10 Case is kept and significant
Case is kept and significant
- id
- S:decision/10
- type
- decision
- summary
- The slug's characters are the ones the tooling already reads ([A-Za-z0-9._@-], no trailing dot).
- number
- 10
- in
- S:section/14
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1496-L1498"],"confidence":1,"state":"known"}
- Case is kept and significant. The slug's characters are the ones the tooling already reads (
[A-Za-z0-9._@-], no trailing dot). An id outside them has no path; a warning for it, and for ids that differ only in case, is proposed and not built (slice 30c did not add it), and not specified as a check here.
S:decision/11 One spelling
One spelling
- id
- S:decision/11
- type
- decision
- summary
- A reader refuses a malformed path rather than normalizing it: no trailing slash, no .., no %.
- number
- 11
- in
- S:section/14
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1499"],"confidence":1,"state":"known"}
- One spelling. A reader refuses a malformed path rather than normalizing it: no trailing slash, no
.., no%.
S:decision/12 The catalog's entries have no path
The catalog's entries have no path
- id
- S:decision/12
- type
- decision
- summary
- in version 1 (sources, grants, groups, attestations).
- number
- 12
- in
- S:section/14
- about
- T:term/group
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1500"],"confidence":1,"state":"known"}
- The catalog's entries have no path in version 1 (sources, grants, groups, attestations).
S:decision/13 When a catalog has both oes: and comprise:, oes: decides
When a catalog has both oes: and comprise:, oes: decides
- id
- S:decision/13
- type
- decision
- summary
- An unknown version of a known MiniCOSM is refused like an unknown MiniCOSM.
- number
- 13
- in
- S:section/14
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1501-L1503"],"confidence":1,"state":"known"}
- When a catalog has both
oes:andcomprise:,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/14 P files keep cosm: 0.3
P files keep cosm: 0.3
- id
- S:decision/14
- type
- decision
- summary
- It is the product tree's format version, read by P's checks, and says nothing about the MiniCOSM.
- number
- 14
- in
- S:section/14
- about
- T:term/checks
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1504-L1505"],"confidence":1,"state":"known"}
- 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/15 The manifest is a .cosm file outside every Holotype
The manifest is a .cosm file outside every Holotype
- id
- S:decision/15
- type
- decision
- summary
- , beside this spec.
- number
- 15
- in
- S:section/14
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1506-L1508"],"confidence":1,"state":"known"}
- The manifest is a
.cosmfile outside every Holotype, beside this spec. 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 bundle or a published atom. They never meet on screen.
S:decision/16 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/16
- type
- decision
- summary
- , plus the fields a check reads.
- number
- 16
- in
- S:section/14
- about
- T:term/kind
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1509-L1511"],"confidence":1,"state":"known"}
- The manifest's fields per kind are the schema's reference fields, exactly, plus the fields a check reads. Every other field is open, as the schema says. P lists its nine aspects. E's kinds are marked as stored in the local database.
S:decision/17 An absent visibility outside P reads as internal
An absent visibility outside P reads as internal
- id
- S:decision/17
- type
- decision
- summary
- : visible to every signed-in reader, never public.
- number
- 17
- in
- S:section/14
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1512-L1513"],"confidence":1,"state":"known"}
- An absent visibility outside P reads as
internal: visible to every signed-in reader, never public. This is what the code does; the spec states it.
S:decision/18 P:release stays declared and is marked as rejected by P's checks
P:release stays declared and is marked as rejected by P's checks
- id
- S:decision/18
- type
- decision
- summary
- The disagreement is listed, not resolved: fixing it is a code change (the schema or cosm.py), outside this slice.
- number
- 18
- in
- S:section/14
- about
- T:term/checks
- provenance
{"mode":"derived","sources":["defaults/cosm/chapters/comprise-oes.md#L1514-L1515"],"confidence":1,"state":"known"}
P:releasestays declared and is marked as rejected by P's checks. The disagreement is listed, not resolved: fixing it is a code change (the schema or cosm.py), outside this slice.
S:decision/19 Words
The spec says concern, item, relationship, open question, outside organization and kind
- id
- S:decision/19
- type
- decision
- summary
- The spec says concern, item, relationship, open question, outside organization and kind, with the model's term in parentheses where exactness needs it.
- number
- 19
- in
- S:section/14
- 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":["defaults/cosm/chapters/comprise-oes.md#L1516-L1518"],"confidence":1,"state":"known"}
- Words. The spec 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 (14)
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":["defaults/cosm/chapters/comprise-oes.md#L45"],"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":["defaults/cosm/chapters/comprise-oes.md#L45"],"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":["defaults/cosm/chapters/comprise-oes.md#L48"],"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":["defaults/cosm/chapters/comprise-oes.md#L49"],"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":["defaults/cosm/chapters/comprise-oes.md#L50"],"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":["defaults/cosm/chapters/comprise-oes.md#L51"],"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":["defaults/cosm/chapters/comprise-oes.md#L242"],"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":["defaults/cosm/chapters/comprise-oes.md#L266"],"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":["defaults/cosm/chapters/comprise-oes.md#L315"],"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":["defaults/cosm/chapters/comprise-oes.md#L329"],"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":["defaults/cosm/chapters/comprise-oes.md#L1222"],"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":["defaults/cosm/chapters/comprise-oes.md#L1302"],"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":["defaults/cosm/chapters/comprise-oes.md#L1303"],"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":["defaults/cosm/chapters/comprise-oes.md#L1396"],"confidence":1,"state":"known"}