Schemas

Derived: every schema module a declared `schemas` directory holds, with the first sentence of its module docblock.

This is an index, not the documentation. It says what exists and what each artefact declares about itself. What a process is for, when you would be in it, and what it is not, is authored beside it and reuses these entries rather than restating them — see the auto-docs skill.
ArtefactWhat it declares about itself
archimate
cat-harness/archimate/schemas/archimate.ts		The ArchiMate harness's shapes: what an instance declares, and how an Archi model becomes nodes — the model, each of its views, elements and relationships — with an IRI each.
openapi
cat-harness/openapi/schemas/openapi.ts		The OpenAPI harness's shapes: what an instance declares, what an ingest records, and how an OpenAPI document's OPERATIONS become nodes with IRIs.
actor-reach
cat-harness/schemas/actor-reach.ts		**Network reach is a property of an ACTOR**, and how it composes with the deployment's.
adversarial-checklist
cat-harness/schemas/adversarial-checklist.ts		Per-content-block adversarial checklists for tools, schemas, skills, and processes.
archive-contents
cat-harness/schemas/archive-contents.ts		An archive's entry list, as data — bean twqe.
artifact-store
cat-harness/schemas/artifact-store.ts		Where a large build artifact goes — and why it is never "a GitHub Release".
assistant-package
cat-harness/schemas/assistant-package.ts		Package Manifest — Docker and system dependency declarations.
assistant-types
cat-harness/schemas/assistant-types.ts		Assistant Framework — Schema definitions for the agent skills system.
assistant-workflow
cat-harness/schemas/assistant-workflow.ts		Assistant Workflow — Content lifecycle state machine.
attribution
cat-harness/schemas/attribution.ts		Who wrote a piece of derived content — bean iqim.
avatars
cat-harness/schemas/avatars.ts		An avatar for every declared kind — in and out of the trash, in both schemes.
bean-graph
cat-harness/schemas/bean-graph.ts		The bean graph — what beans/ is, rather than where it happens to be.
bean-note
cat-harness/schemas/bean-note.ts		A BEAN NOTE — one pull request's addendum to a bean, in a file of its own.
bib-attestations
cat-harness/schemas/bib-attestations.ts		BIBLIOGRAPHY ATTESTATIONS — the ONE reader and the ONE writer for a folio's two bibliography judgement ledgers (qou C9 stories B3 and B4).
bib-verification
cat-harness/schemas/bib-verification.ts		Bibliography verification schema — the source ledger.
binary-release
cat-harness/schemas/binary-release.ts		no description in the artefact
blank-avatar
cat-harness/schemas/blank-avatar.ts		The blank avatar on its own, with no node: import, so a browser bundle can use it: the navbar client (the tools layer's scripts/lib/navbar.ts) compares a glyph with it, and importing it from avatars.ts pulled that…
block-kind-node
cat-harness/schemas/block-kind-node.ts		A block kind as a KG node: folio-block-kind/v1, one JSON file per kind in a block-kinds/ graph the OWNING harness declares (bean riit, step 2; sod4 finding #1).
block-kinds
cat-harness/schemas/block-kinds.ts		The block kinds, as a runtime value — in a leaf module so anything can read it.
index.d
cat-harness/schemas/block-qa-schema/dist/index.d.ts		The canonical schemas are schemas/block-qa-schema/schema/block-qa.schema.json (the per-block <block>.qa.json report) and schemas/block-qa-schema/schema/qa-script.schema.json (the per-criterion `<criterion-id>.scri…
index
cat-harness/schemas/block-qa-schema/js/index.ts		The canonical schemas are schemas/block-qa-schema/schema/block-qa.schema.json (the per-block <block>.qa.json report) and schemas/block-qa-schema/schema/qa-script.schema.json (the per-criterion `<criterion-id>.scri…
block-qa
cat-harness/schemas/block-qa.ts		Per-content-block QA report schema.
block-summary
cat-harness/schemas/block-summary.ts		An agent's summary of a library block, kept BESIDE the block — the QA sidecar the owner asked for on 2026-09-24.
board-positions
cat-harness/schemas/board-positions.ts		no description in the artefact
board
cat-harness/schemas/board.ts		A board — the surface a folio's notes and its content are read on together.
builders
cat-harness/schemas/builders.ts		Each builder validates the input against its Zod schema and returns the typed object, providing compile-time AND runtime safety.
built-at-publish
cat-harness/schemas/built-at-publish.ts		Artefacts an instance must NOT commit, because no commit of it can hold them current: they are built when the site is published, and only then.
carried-note
cat-harness/schemas/carried-note.ts		What an actor carries forward, attached to a node of the knowledge graph.
cat-harness
cat-harness/schemas/cat-harness.ts		The CatHarness declaration — what an instance IS, at its root.
change-size
cat-harness/schemas/change-size.ts		The change-size rule: thresholds, basis, and prose/KG versus code weighting.
code-list
cat-harness/schemas/code-list.ts		A code list: a closed set of codes, each with a label, a plain-language definition and a source — authored as a node, published as SKOS.
computation-witness
cat-harness/schemas/computation-witness.ts		computation-witness/v1 — the runtime schema for a folio's <name>.witness.json: the record a computation writes of what it computed, with what, and whether its assertions held.
concern-groups
cat-harness/schemas/concern-groups.ts		The shape of a kind's FROM-WITHIN declaration file when it names concern groups: processes/processes.json, schemas/schemas.json, library/library.json, uml/uml.json, a test directory's code.json (placement PR0c…
constraints
cat-harness/schemas/constraints.ts		These schemas provide runtime validation and are used by the schema generation scripts to produce JSON Schema files.
content-adapter-node
cat-harness/schemas/content-adapter-node.ts		A content adapter's block VOCABULARY as a KG node: folio-content-adapter/v1, one JSON file per adapter in a content-adapters/ graph the owning harness declares (bean riit, step 5).
content-context
cat-harness/schemas/content-context.ts		The @context a content document carries, built from the types it uses.
content-type
cat-harness/schemas/content-type.ts		What a repository IS — the markers it carries, as a resolvable set.
content-types-base
cat-harness/schemas/content-types-base.ts		The content types this layer owns, registered at load time.
contribution-nodes
cat-harness/schemas/contribution-nodes.ts		Contributions as KG nodes: a harness's QA checkers and pipeline-plugin implementations, each a node in a graph of its own (bean riit, step 3b).
contributions
cat-harness/schemas/contributions.ts		Contribution registry — what a folio-assistant *dependency* may add to the root instance.
convention
cat-harness/schemas/convention.ts		A coding convention — context attached to a PROCESS, not loaded everywhere.
decision-methodology-context
cat-harness/schemas/decision-methodology-context.ts		The context an agent provides when asking "which decision methodology fits?" Complements {@link MethodologyFrontMatterSchema} — that schema declares what a methodology IS; this one declares what a decision NEEDS.
decision-request
cat-harness/schemas/decision-request.ts		A decision handed to a person, as a shape rather than as a habit.
declared-nodes
cat-harness/schemas/declared-nodes.ts		The files of every declared directory of one graph typology, across the instances of a checkout: the one scan behind each node graph a harness declares instead of a central table (typologies/, bean dmx1; validators/…
dependency-order
cat-harness/schemas/dependency-order.ts		dependency-order.ts — flatten a dependency hierarchy into ONE ordered list, with the failure policy attached to each step rather than to the runner.
depends-on
cat-harness/schemas/depends-on.ts		depends-on.ts — instance-versioning.md §3.4's record, and the gaps it cannot fill.
detangle-sidecar
cat-harness/schemas/detangle-sidecar.ts		no description in the artefact
detangle
cat-harness/schemas/detangle.ts		no description in the artefact
diff-renderers
cat-harness/schemas/diff-renderers.ts		The diff renderers a reviewer chooses between on the review page.
document-image
cat-harness/schemas/document-image.ts		An image placed on a page of an ingested document — bean d5f1.
document-kind
cat-harness/schemas/document-kind.ts		A document KIND — a named structure of sections that a document authored with a harness follows.
document-structure
cat-harness/schemas/document-structure.ts		structure.json as a BASE with VARIANTS — bean rkqp, owner 2026-09-30 ("A+B", after a measured analysis).
external-schema
cat-harness/schemas/external-schema.ts		A specification this repository DEPENDS ON and does not hold.
extraction
cat-harness/schemas/extraction.ts		What an EXTRACTION produced, and when — provenance for assets pulled out of a container.
figure-description
cat-harness/schemas/figure-description.ts		What a person or agent SAYS a drawn figure shows — bean a8wy, under m4xy.
folio-graph-typology
cat-harness/schemas/folio-graph-typology.ts		The folio graph typology — registered by **core**, not declared by the harness.
formal-ref
cat-harness/schemas/formal-ref.ts		no description in the artefact
formalization-types
cat-harness/schemas/formalization-types.ts		Formalization Pipeline Types — Proof Objects, Glossary, and Test Reports.
front-matter
cat-harness/schemas/front-matter.ts		The one YAML front-matter reader for this repository's self-declaring files.
fsh-guts
cat-harness/schemas/fsh-guts.ts		A node of the trashcan — what fsh-guts/ holds, and what may leave it.
git-corpus
cat-harness/schemas/git-corpus.ts		What files this REPOSITORY contains — asked of git, never of the disk.
glossary-ledger
cat-harness/schemas/glossary-ledger.ts		The swimlane glossary's retirement ledger: its tag and its shape.
graph-typology-node
cat-harness/schemas/graph-typology-node.ts		A GRAPH TYPOLOGY as a node of the knowledge graph, declared by the harness that owns it (bean dmx1).
graph-typology-registry
cat-harness/schemas/graph-typology-registry.ts		The graph-typology registry — **a leaf, and that is its whole job**.
harness-config
cat-harness/schemas/harness-config.ts		Cross-folio dependency schema for folio-assistant instances.
health-report
cat-harness/schemas/health-report.ts		Repository health reports — what the daily sweep under test/health/ wrote.
id-lookup
cat-harness/schemas/id-lookup.ts		A prefix-sharded identifier lookup for nodes a folio REFERENCES but does not hold.
index-config
cat-harness/schemas/index-config.ts		index.config.json — the instantiation root's INDEX (folio-index-config/v1).
index
cat-harness/schemas/index.ts		Re-exports all types, Zod validation schemas, and builder functions.
inline-code
cat-harness/schemas/inline-code.ts		Backtick spans in authored prose, rendered as <code> — bean mylx.
input-trace
cat-harness/schemas/input-trace.ts		The runtime half of the input-site audit — bean f017.
instance-repositories
cat-harness/schemas/instance-repositories.ts		The owner/repo ↔ instance map — DERIVED, never kept by hand (bean 6rmv).
instance-roots
cat-harness/schemas/instance-roots.ts		Instance DISCOVERY: which directories are instances, and which file in a directory is its declaration.
intake
cat-harness/schemas/intake.ts		An intake record — what one capture put into uploads/<doc>/, and where it came from.
interaction
cat-harness/schemas/interaction.ts		How a person wants to be asked — the interaction graph's one node kind.
jsonld-prefixes
cat-harness/schemas/jsonld-prefixes.ts		jsonldPrefixes: the external vocabularies an instance's JSON-LD speaks, as declared data — prefix → namespace IRI (bean folio-assistant-63q4, owner 2026-10-14, "1 3").
jsonld
cat-harness/schemas/jsonld.ts		JSON-LD projection of the content block model.
kg-node
cat-harness/schemas/kg-node.ts		The two labels every knowledge-graph node may carry.
kg-qa
cat-harness/schemas/kg-qa.ts		Knowledge-graph QA sidecars — what is dangling in the process/role/skill graph.
kind-validator
cat-harness/schemas/kind-validator.ts		Resolving a graph typology's **validator** — the one parameter that turns "validate a node" from one case per schema into a lookup.
landing-sticky
cat-harness/schemas/landing-sticky.ts		no description in the artefact
layer-direction
cat-harness/schemas/layer-direction.ts		layer-direction.ts — is this edge pointing the way its layers allow? ONE answer to one question, asked by two tools that used to answer it separately or not at all (bean j79e): - scripts/partition/engine.ts (`check:…
lean-packages
cat-harness/schemas/lean-packages.ts		The lean.ref grammar and the package registry it resolves against.
library-iri
cat-harness/schemas/library-iri.ts		A library entry's ONE IRI — the address of its published JSON-LD.
library-keywords
cat-harness/schemas/library-keywords.ts		library/<slug>/keywords.json — an entry's keywords, read from the LSI index's own log-entropy term weights (issue #2302).
library-nodes
cat-harness/schemas/library-nodes.ts		The JSON-LD nodes a library entry holds: its manifest.jsonld (a SourceDocument), its sections and sheets (doco:Section) and its blocks.
log-entry
cat-harness/schemas/log-entry.ts		The agent activity log — what an agent did, when, and in which process.
materialization-state
cat-harness/schemas/materialization-state.ts		The materialization STATE vocabulary — whether the bytes are here, and how a held copy proves it is unchanged.
memory
cat-harness/schemas/memory.ts		no description in the artefact
merge-queue
cat-harness/schemas/merge-queue.ts		no description in the artefact
merge-review
cat-harness/schemas/merge-review.ts		Agentic pre-merge review and would-have-blocked counterfactual schemas.
methodology
cat-harness/schemas/methodology.ts		A methodology node's front matter — folio-methodology/v1.
model-capabilities
cat-harness/schemas/model-capabilities.ts		Model capabilities and single-model capability refusal schema.
mount-trust
cat-harness/schemas/mount-trust.ts		no description in the artefact
namespaces
cat-harness/schemas/namespaces.ts		The platform's own IRI namespace — a leaf module, imported by nothing.
narrative
cat-harness/schemas/narrative.ts		A generated narrative, and who stands behind it — bean ju0u.
node-kind-index
cat-harness/schemas/node-kind-index.ts		Every node kind a checkout declares, found THROUGH the graph typologies — issue #2195, PR 1.
node-kind-nodes
cat-harness/schemas/node-kind-nodes.ts		The NODES of a node kind, found where its typologies say they are — issue #2195, PR 2.
node-kind
cat-harness/schemas/node-kind.ts		Node kinds with more than one parent, composed by the platform's one resolve-then-walk.
note-anchor
cat-harness/schemas/note-anchor.ts		Where a note is attached, as a three-state answer.
nquads-distribution
cat-harness/schemas/nquads-distribution.ts		Partitioned RDF N-Quads Dataset Distribution & Named Query Manifest Schema.
odrl
cat-harness/schemas/odrl.ts		W3C ODRL 2.2 policies: what an Actor may do, scoped by Process, Task and Role.
panel-chrome
cat-harness/schemas/panel-chrome.ts		What a card's open panel offers — the kind declares, the platform fixes.
pdf-structure
cat-harness/schemas/pdf-structure.ts		structure.json: the structure of an ingested PDF, tagged _schema: pdf-structure/v1.
pinned-terminology
cat-harness/schemas/pinned-terminology.ts		The codes a PUBLISHED IG carries at ONE pinned version — bean 7wou.
po-strings
cat-harness/schemas/po-strings.ts		A minimal gettext reader: (msgctxt, msgid) → msgstr for one .po file.
portable-path
cat-harness/schemas/portable-path.ts		Path segments a checkout can actually create — on every filesystem, not only the one that wrote them.
precision-scalar
cat-harness/schemas/precision-scalar.ts		§S7 — PrecisionScalar envelope for round-tripping high-precision values through witness JSON without going through f64.
process-element-id
cat-harness/schemas/process-element-id.ts		The id a BPMN <process> element declares — Process_CRDM, Process_Editing — as a typed reference (#1168 B8).
property-skills
cat-harness/schemas/property-skills.ts		Which skill edits which declaration property: the "edit skills" column of the harness config panel (issue #1146).
prov-jsonld
cat-harness/schemas/prov-jsonld.ts		PROV activities as PROV-JSONLD — links, not strings (beans jcet, 9y9j).
prov
cat-harness/schemas/prov.ts		W3C PROV-O: the record of a task being performed.
python-deps
cat-harness/schemas/python-deps.ts		The Python packages this repository's scripts need — declared once.
qa-attestations
cat-harness/schemas/qa-attestations.ts		no description in the artefact
qa-record-shapes
cat-harness/schemas/qa-record-shapes.ts		The SHAPES of the record families the harness's qa and lsi graphs hold — qa-witness/v1, qa-results/v1, translation-qa/v1, folio-lsi-index/v1.
qa-report
cat-harness/schemas/qa-report.ts		no description in the artefact
qa-review
cat-harness/schemas/qa-review.ts		QA review — findings, decisions, and the audit notes that justify them.
reader-filter
cat-harness/schemas/reader-filter.ts		The filter a READER applies to a board, which commits nothing.
red-flag
cat-harness/schemas/red-flag.ts		RED FLAG taxonomy, adversarial review sidecar schema, and recorded override path.
ref-window
cat-harness/schemas/ref-window.ts		no description in the artefact
refactor-strategy
cat-harness/schemas/refactor-strategy.ts		Lean proof-refactoring strategy database.
reference-direction
cat-harness/schemas/reference-direction.ts		no description in the artefact
referenced-source
cat-harness/schemas/referenced-source.ts		referenced.json: a library entry that RECORDS a source and holds none of its text, written by scripts/referenced-source.py.
remote-mount
cat-harness/schemas/remote-mount.ts		REMOTE MOUNTS — a harness, and its dependency closure, read from another repository at a pinned commit and laid down as declared directories.
render-log
cat-harness/schemas/render-log.ts		The render log — what was published to the publish branch, when, and why.
render-output
cat-harness/schemas/render-output.ts		The ONE implementation of a Tool output's render hint — bean q2wm, R17.
render-targets
cat-harness/schemas/render-targets.ts		Which render target a content profile validates against — declared as data, resolved at runtime.
rendered-impact
cat-harness/schemas/rendered-impact.ts		What a change does to a RENDERED site: the contract every renderer answers (bean bnjs, issue #971).
repo-full-name
cat-harness/schemas/repo-full-name.ts		owner/name — a forge repository's full name, in its own module so a declaration schema can use it without importing the Tool type table (tool-types.ts imports cat-harness.ts, which would make the cycle).
role-graph
cat-harness/schemas/role-graph.ts		no description in the artefact
run-context
cat-harness/schemas/run-context.ts		Run context — what ONE run ran on, stated once, and cited by digest.
safe-url
cat-harness/schemas/safe-url.ts		Which URL schemes may reach an href, and why the answer is a list.
scenario-overlay
cat-harness/schemas/scenario-overlay.ts		no description in the artefact
script-qa
cat-harness/schemas/script-qa.ts		Per-script QA report schema.
script-table
cat-harness/schemas/script-table.ts		The checkout's script table, read from where each script now lives.
section-verdicts
cat-harness/schemas/section-verdicts.ts		Section verdicts — which ingested sections are not PROSE.
semantic-zoom
cat-harness/schemas/semantic-zoom.ts		When a card stops rendering its words and becomes its avatar.
session-context
cat-harness/schemas/session-context.ts		What a state machine tracks across a SESSION, as opposed to an instance.
session-survey
cat-harness/schemas/session-survey.ts		A PUBLISHED SURVEY of a commit window — so the next session reads it instead of re-deriving it.
site-indexes
cat-harness/schemas/site-indexes.ts		The published index files the site's viewers read — each $schema family typed, so the graph-typology registry names a validator instead of the script that writes it (#1168 B6b, bean dv8v).
site
cat-harness/schemas/site.ts		A published static site, as a graph: what a CDN serves, at which routes.
skill-definitions-dir
cat-harness/schemas/skill-definitions-dir.ts		Where the JSON workflow-skill definitions and the conventions live.
skill-package
cat-harness/schemas/skill-package.ts		The SKILL-FRAMEWORK vocabulary — actors, capabilities, skills, requirements, the package registry and its Docker and remote-package machinery.
skill-topics
cat-harness/schemas/skill-topics.ts		The shape of skills.json, the labelling node that says which subdirectories of a skills directory are TOPICS (bean 9umr).
slides-accessibility
cat-harness/schemas/slides-accessibility.ts		accessibility.json: a slide deck's accessibility report, written by scripts/slides-structure.py beside its structure.json.
source-descriptor
cat-harness/schemas/source-descriptor.ts		no description in the artefact
source-licence
cat-harness/schemas/source-licence.ts		A source's licence, as one record wherever it is written — bean 7bg9.
source-provenance
cat-harness/schemas/source-provenance.ts		WHERE BYTES CAME FROM — the source-side provenance pair, and a signature.
spdx-license-expression
cat-harness/schemas/spdx-license-expression.ts		An SPDX licence expression, checked against the pinned SPDX License List.
spec-template
cat-harness/schemas/spec-template.ts		Spec template schema and validator for platform feature specifications (spec-kit).
staging-preview
cat-harness/schemas/staging-preview.ts		no description in the artefact
staging
cat-harness/schemas/staging.ts		Staging comparison schema — before/after URL pairs for content review.
state-manifest
cat-harness/schemas/state-manifest.ts		The ROOT MANIFEST of a special branch — what the branch is, where it came from, and whether it is the store or a copy.
sticky-contribution
cat-harness/schemas/sticky-contribution.ts		no description in the artefact
subgraph-manifest
cat-harness/schemas/subgraph-manifest.ts		The two files a NAMED SUBGRAPH publishes — index.jsonld (referenced) and index.hydrated.jsonld (dereferenced) — as one schema with two forms.
subgraph-source
cat-harness/schemas/subgraph-source.ts		WHERE A DECLARED SUBGRAPH GETS ITS CONTENT — one concept, several kinds.
substrate-snapshot
cat-harness/schemas/substrate-snapshot.ts		A SUBSTRATE SNAPSHOT: the root declaration of a subscribed Knowledge Graph, cached at the commit the subscription pins.
sweep-mark
cat-harness/schemas/sweep-mark.ts		WHEN A SWEEP STEP WAS LAST RUN — so skipping it leaves a trace.
tabular-csvw
cat-harness/schemas/tabular-csvw.ts		no description in the artefact
tabular-records
cat-harness/schemas/tabular-records.ts		What makes a dataset findable — bean p67i.
term-adjudication
cat-harness/schemas/term-adjudication.ts		What was decided when a minted glossary term and an authorised terminology DISAGREE.
term-mapping
cat-harness/schemas/term-mapping.ts		no description in the artefact
test-fixture-preload
cat-harness/schemas/test-fixture-preload.ts		Point node discovery at the standalone fixture when the checkout holds no vocabulary — the first test preload, ahead of test-preload.ts.
test-plan
cat-harness/schemas/test-plan.ts		no description in the artefact
test-preload
cat-harness/schemas/test-preload.ts		Register core's graph typologies before any test reads a declaration.
test-report
cat-harness/schemas/test-report.ts		A TEST REPORT — the verdicts one run of one plan reached against one system under test.
test-run
cat-harness/schemas/test-run.ts		A TEST RUN — what was measured, with what, and whether it can be redone.
theme-art-intake
cat-harness/schemas/theme-art-intake.ts		Theme art arriving as three files — accepted, or refused with a reason.
theme-by-ref
cat-harness/schemas/theme-by-ref.ts		A theme by REFERENCE — {instance?, themeId} — resolved against the instance that owns it, not only against the platform's own table.
theme
cat-harness/schemas/theme.ts		no description in the artefact
themes
cat-harness/schemas/themes.ts		The themes this instance ships, and the default.
tile-count
cat-harness/schemas/tile-count.ts		no description in the artefact
to-json-schema
cat-harness/schemas/to-json-schema.ts		JSON Schema conversion — one wrapper, because the converter changed under us.
todo-graph
cat-harness/schemas/todo-graph.ts		The todo graph — what todos/ is, rather than where it happens to be.
todo-index
cat-harness/schemas/todo-index.ts		The published todo index — folio-todo-index/v1, described at last.
todo
cat-harness/schemas/todo.ts		A TODO — one human actor's work state, as a knowledge-graph node.
tool-folders
cat-harness/schemas/tool-folders.ts		One Tool per folder: <tools dir>/<id>/<id>.ts, and the loader that reads them.
tool-invocation
cat-harness/schemas/tool-invocation.ts		What happened when a Tool ran, and under whose authority.
tool-profile
cat-harness/schemas/tool-profile.ts		Tool profiles — a named set of tool releases a run selects as one.
tool-release
cat-harness/schemas/tool-release.ts		Tool releases — one external tool at one version, with the digest of the bytes and the runtime THIS release needs.
tool-run
cat-harness/schemas/tool-run.ts		A TOOL RUN RECORD — did the downstream tool run, did it succeed, and over which inputs.
tool-types
cat-harness/schemas/tool-types.ts		The shared I/O type vocabulary Tool ports reference.
tool
cat-harness/schemas/tool.ts		What a Tool is.
translation-tools
cat-harness/schemas/translation-tools.ts		Content-type-specific translation tool registry.
translation
cat-harness/schemas/translation.ts		Translation status, metadata, and node schemas for localized content.
types
cat-harness/schemas/types.ts		ALL types are inferred from Zod schemas in constraints.ts, which is the single source of truth.
url-space
cat-harness/schemas/url-space.ts		Where a published thing is served: one resolver for the site's URL space (bean nbal, the producer half of cat-tools-sthf).
user-story
cat-harness/schemas/user-story.ts		User stories — what a reader acting in a role is trying to do.
validator-node
cat-harness/schemas/validator-node.ts		A VALIDATOR as a node of the knowledge graph (bean riit).
vector-figure
cat-harness/schemas/vector-figure.ts		A DRAWN figure, assembled and rendered — bean ay3x, under m4xy.
vector-labels
cat-harness/schemas/vector-labels.ts		no description in the artefact
version-bump
cat-harness/schemas/version-bump.ts		version-bump.ts — instance-versioning.md §4: what a version MEANS, and what makes it go up.
viewer-nav-qa
cat-harness/schemas/viewer-nav-qa.ts		The viewer-navbar audit — **what the owner's rule looks like as data**.
visualiser-route
cat-harness/schemas/visualiser-route.ts		Where a declared visualiser is published — THE one function every generator and every reader computes a visualiser's URL with.
vocab-mapping-fhir
cat-harness/schemas/vocab-mapping-fhir.ts		FHIR ConceptMap ⇄ vocabulary mapping tables: ι (represent) and π (produce).
vocab-mapping
cat-harness/schemas/vocab-mapping.ts		A vocabulary mapping: one source vocabulary's values carried into a target vocabulary, declared as data rather than written as a line in a generator.
vocabulary-modules
cat-harness/schemas/vocabulary-modules.ts		A typed vocabulary's own module: the code a layer above cat-harness ships so that it, not cat-harness, types its block kinds.
vocabulary
cat-harness/schemas/vocabulary.ts		What each term in the folio namespace MEANS — one brief gloss apiece.
voice-skill
cat-harness/schemas/voice-skill.ts		A VOICE SKILL — a voice as a first-class member of the knowledge graph.
voices
cat-harness/schemas/voices.ts		Voices — named editorial profiles that overlay the base house voice.
waiver
cat-harness/schemas/waiver.ts		A confirmation the owner has given **in advance**, scoped and dated.
webpage
cat-harness/schemas/webpage.ts		webpage — a published documentation page, modelled as a graph node that composes other nodes.
window-stack
cat-harness/schemas/window-stack.ts		Which cards are OPEN on a board, and in what order they stack.
withheld
cat-harness/schemas/withheld.ts		folio-withheld/v1 — what a mounted directory must NOT publish.
fhir-artifact-index
fhir-harness/schemas/fhir-artifact-index.ts		no description in the artefact
ig-artifact-jsonld
fhir-harness/schemas/ig-artifact-jsonld.ts		One FHIR IG artefact as a JSON-LD node — the asset an artefact's thin page renders (kg-viewer rule 3: one IRI per asset, its page a separate resource that loads it).
ig-ast
fhir-harness/schemas/ig-ast.ts		ig-ast.ts — the IG AST's file formats, declared once (bean l0lq).
ig-chrome
fhir-harness/schemas/ig-chrome.ts		ig-chrome.ts — a FHIR IG's published CHROME, as data.
ig-identity
fhir-harness/schemas/ig-identity.ts		An IG's identity, as its own sushi-config.yaml states it — id, canonical, version and publication status — kept beside that IG's artefact index.
ig-menu
fhir-harness/schemas/ig-menu.ts		ig-menu.ts — a FHIR IG's own navigation, as data.
ig-metadata-index
fhir-harness/schemas/ig-metadata-index.ts		no description in the artefact
ig-releases
fhir-harness/schemas/ig-releases.ts		ig-releases.ts — an IG's GitHub releases, recorded as POINTERS to their binary assets (bean b8ip).
adjudication
folio-assistant-core/schemas/adjudication.ts		The adjudication contract — what a judgement is ASKED and what it ANSWERS.
catalogue
folio-assistant-core/schemas/catalogue.ts		A remote catalogue, modelled in the graph without holding it.
changeset
folio-assistant-core/schemas/changeset.ts		A ChangeSet: what changed in a folio between two git refs, block by block.
dublin-core-render
folio-assistant-core/schemas/dublin-core-render.ts		Dublin Core RENDERINGS of a catalogue record: DC XML for a harvester, and JSON-LD bound to DCMI Metadata Terms.
dublin-core
folio-assistant-core/schemas/dublin-core.ts		Qualified Dublin Core, as a graph node.
glossary
folio-assistant-core/schemas/glossary.ts		folio-glossary/v1: a glossary as W3C SKOS.
kg-materialization
folio-assistant-core/schemas/kg-materialization.ts		The record of ONE materialised part of a subscribed Knowledge Graph — a subgraph, or a single asset — copied at the subscription's pin.
library-ref
folio-assistant-core/schemas/library-ref.ts		A reference to an L1 source — in this instance, or in another one.
manifest-fields
folio-assistant-core/schemas/manifest-fields.ts		A block manifest's fields, read from its TEXT: the object literal passed to its builder (`persona({ ...
materialization
folio-assistant-core/schemas/materialization.ts		no description in the artefact
own-namespace
folio-assistant-core/schemas/own-namespace.ts		This instance's own namespaces, derived from its declaration.
public-comment
folio-assistant-core/schemas/public-comment.ts		A comment returned during a PUBLIC REVIEW of a frozen, line-numbered draft: a row of a comment matrix, an online-form response, a passage of a narrative letter, or a GitHub comment from a review-committee member.
recommendation-strength
folio-assistant-core/schemas/recommendation-strength.ts		Does a recommendation block's strength resolve? Bean 55ao.
reference
folio-assistant-core/schemas/reference.ts		folio-reference/v1: one bibliographic reference, as a KG node (bean folio-assistant-63q4).
review-comment
folio-assistant-core/schemas/review-comment.ts		A reviewer's comment on one block of a folio: a todo with more structure and a closed lifecycle.
review-verdict
folio-assistant-core/schemas/review-verdict.ts		A reviewer's VERDICT on one version of one block: "I read this, and here is my judgement".
editor-checker
folio-assistant-sci/schemas/editor-checker.ts		folio-editor-checker/v1: one node per content profile, naming the code the ✍ suggest editor loads for that profile's blocks (bean folio-assistant-4dx7).
mathpaper-vocabulary
folio-assistant-sci/schemas/mathpaper-vocabulary.ts		The mathpaper vocabulary's own code: the seven formal-claim block kinds' types, schemas, builders and constraint rules.

folio-assistant — code under the Apache License 2.0, documentation under CC BY 3.0. Generated schema and API references are rebuilt from source on every push to main.

deployed b08c961 · 2026-10-23T23:11:09Z