fix: types/type-spec.schema.yaml enforced against real type-spec frontmatter, doc-pull-through.md docs/-page count corrected (closes #105)
CI / verify (push) Failing after 45s
Release / release (push) Successful in 38s

Files changed:
- CHANGES.md
- VERSION
- instructions/dev/doc-pull-through.md
- tools/CONTRACT.md
- tools/chemenu/commands/docs_verify.py
- tools/chemenu/tests/test_docs_verify.py
- types/type-spec.md
- types/type-spec.schema.yaml
This commit is contained in:
2026-09-15 19:45:33 +02:00
parent 6eb3f84256
commit 55f65c1ab1
8 changed files with 161 additions and 7 deletions
+27
View File
@@ -69,6 +69,33 @@ properties:
items:
type: string
pattern: "^[a-z][a-z0-9_]*$"
capture_fields:
type: array
description: >-
Frontmatter fields on instances of this type that are fixed at capture
time and never correctable afterwards except by re-capturing the source
(e.g. `fidelity`, `authority` for a source page). `raw accept`,
`new source` and `touch --set` read this instead of a hardcoded field
list. Omit for types with no capture-time fields.
items:
type: string
pattern: "^[a-z][a-z0-9_]*$"
root:
type: string
description: >-
Which root a `base_dir:` resolves against - `kb` (the default, so
omitting this field is equivalent to `kb`) for a page this instance
writes, or `repo` for a type whose artifacts are legitimately not
knowledge (e.g. `instruction`).
enum: [kb, repo]
guidance:
type: string
description: >-
Repo-relative path to a `types/type-guidance.md`-shaped document
holding this type's stack-owned authoring prose. Meaningful only on a
`root: kb` type-spec; omit for a type an instance writes entirely for
itself.
pattern: "^types/.*\\.md$"
required:
- type
- name