Contextfulv0.23.0

Docs / Specification

contract corpus · 00-corpus.md · guide · card

Corpus law — card

Generated by contextful-spec state from the contract’s files and spec/terms/corpus.toml; not authored.

Operations

OperationCoversClausesProved
addressThe three segments of a clause id and what makes each legal.70
anatomyThe section order of a contract file, the lede, clause list and groups of each operation, and the computed kind of a clause.140
registryWhere a spelling is registered, the single owner of an error or a bound, the collision test, the source sites checked against each error, the ratchets the registry records, and the term table with the glossary and first-use rule it drives.150
referenceThe one legal way a statement reaches a fact another clause or a code type owns, and the ban on restatement and literature.60
rationaleWhere an argument lives: the Why line, the record and its anatomy, and the words a contract file cannot carry.100
statePins, verdicts, the coverage floor, the roadmap’s operation claims and each milestone’s acceptance test.340
renderThe generated files, and the vocabulary no authored file carries.70
diagramThe fenced diagram, and the shape every flowchart, sequence and state diagram keeps so a reader sees the parts and what flows between them.140
targetsPer-provider deployment target files, the roles each shape fills, and the page rendered from them.70
guideA non-normative teaching page per contract, and what keeps it from becoming a second home for a rule.60
topicA non-normative page answering one question that spans contracts, the clauses it answers, and the bounds that keep it a route into the contracts.60

Error cases

ErrorWhenClause
SpecMalformedIdA clause id with the wrong shape, contract or operation.corpus.address.malformed-id
SpecDuplicateIdA clause id in two rows.corpus.address.duplicate-id
SpecWordCeilingA contract or contract ADR whose word count differs from its ceiling.corpus.anatomy.word-ceilings
SpecScenarioA scenario naming a foreign clause, or holding no WHEN/THEN sentence or fixture path.corpus.anatomy.bad-scenario
SpecAnatomyA contract file out of its section order, lede, clause list, title or size.corpus.anatomy.bad-anatomy
SpecRegistryA spelling, error or bound out of step with its fragment.corpus.registry.unregistered
SpecRegistryDriftA defining variant out of step with its registry entry, or a refusal whose code site and pin disagree.corpus.registry.drift
SpecTermA term registered twice, naming a missing or foreign clause, glossed out of bounds, or avoided as itself a term.corpus.registry.bad-term
SpecTermFirstUseMore guide first uses of a term without its defining pointer than the ceiling records.corpus.registry.term-first-use
SpecDanglingReferenceA pointer to no clause.corpus.reference.dangling
SpecTypeUnresolvedA type pointer to no struct or enum.corpus.reference.type-unresolved
SpecExternalLinkA link out of the spec, or into references/.corpus.reference.no-literature
SpecUnsettledA malformed unknown, or an appendix heading.corpus.rationale.unsettled-line
SpecRecordAn uncited or missing record, a bad Why, or a record out of anatomy.corpus.rationale.orphan-record
SpecWhyUnscopedMore Why citations naming a contract ADR without a section than the ceiling records.corpus.rationale.why-scoped
SpecProofObligationUnpinnedA clause listed as a proof obligation that does not compute proved.corpus.state.proof-obligation
SpecStalePinA tag recording a statement revision the clause no longer carries.corpus.state.stale-pin
SpecUnwiredMore public items only a performed pin’s test reaches than the recorded ceiling.corpus.state.unwired-ceiling
SpecCoverageRegressionFewer performed pins than the floor.corpus.state.coverage-floor
SpecBrokenPinA pin that names no clause, mismatches its kind, does not resolve, or competes with a second test.corpus.state.bad-pin
SpecRoadmapA roadmap name resolving to nothing, claimed twice, or a milestone missing its reach or acceptance line.corpus.state.roadmap
SpecAcceptanceMissingA milestone with a pinned clause and no acceptance test.corpus.state.acceptance-first
SpecClauseUnownedMore unpinned, unscheduled and unquestioned clauses than the ceiling records.corpus.state.unowned
SpecDeferredBehaviorA behavior clause in a milestone marked Depth: operation.corpus.state.deferred-depth
SpecStaleRenderA generated file differing from regeneration.corpus.render.generated
SpecDatedProseBuild-state words or a date in authored text.corpus.render.dated-prose
SpecCounterfactualFuture or conditional mood in a contract file.corpus.render.counterfactual
SpecBannedWordA banned noun, refused name or provenance link.corpus.render.banned-vocabulary
SpecLocalPathAn absolute path from a local machine.corpus.render.local-path
SpecAsciiDiagramBox-drawing outside a mermaid fence.corpus.diagram.fence
SpecDiagramBoundaryA flowchart node standing for a contract or a boundary instead of a container.corpus.diagram.boundary
SpecDiagramNodeA flowchart node bundling attributes, naming an error or an operation, or over its word bound.corpus.diagram.node
SpecDiagramShapeA table, store, log or queue drawn other than as a cylinder, or a question drawn other than as a decision.corpus.diagram.shape
SpecDiagramEdgeA two-way edge, an unlabelled edge between non-decision nodes, or an edge label over its bound.corpus.diagram.edge
SpecDiagramDecisionA decision node with a long label, an error name, no incoming edge, or exits not each labelled with a distinct outcome.corpus.diagram.decision
SpecDiagramBranchA non-decision node branching on a condition through its edge labels.corpus.diagram.branch
SpecDiagramOrphanA flowchart node no edge reaches, directly or through its subgraph.corpus.diagram.connected
SpecDiagramDuplicateTwo nodes of one flowchart carrying one label.corpus.diagram.unique-label
SpecDiagramLayoutA flowchart without a direction, with a subgraph direction, nested too deep, or over its size.corpus.diagram.layout
SpecDiagramLinkA flowchart node carrying a click link or tooltip.corpus.diagram.no-link
SpecDiagramSequenceA sequence diagram with undeclared or unused participants, or over a size bound.corpus.diagram.sequence
SpecDiagramMessageA sequence message or note over its word bound.corpus.diagram.message
SpecDiagramStateA state diagram without one start, with an unreachable or dead-end state, or a long transition label.corpus.diagram.state
SpecTargetIncompleteA target shape leaving a role unfilled, or a target file without exactly one default shape.corpus.targets.incomplete
SpecTargetCapUnrecordedA capped target shape not recording its backfill and component-connector exclusions.corpus.targets.cap-unrecorded
SpecTargetFunctionProfileA function-class target shape listing a profile other than edge.corpus.targets.function-profile
SpecGuideReachA registered operation its contract’s guide never points into.corpus.guide.reach
SpecGuidePointerDensityA guide paragraph with too many clause pointers or too little prose per pointer.corpus.guide.pointer-density
SpecGuideBoundA guide sentence restating a bound value without the bound’s clause pointer.corpus.guide.bound
SpecGuideA missing or malformed guide, or one restating a rule.corpus.guide.bad-guide
SpecTopicA topic page out of its registry entry, shape or bounds, restating a rule, or leaving an answer unreachable.corpus.topic.bad-topic

Bounds

BoundValueBasisClause
corpus-subject-length40 charschosencorpus.address.subject-segment
corpus-group-clauses30 clauseschosencorpus.anatomy.group-clauses
corpus-operation-clauses30 clauseschosencorpus.anatomy.long-operation
corpus-statement-words40 wordschosencorpus.anatomy.statement-words
corpus-file-lines900 lineschosencorpus.anatomy.file-length
corpus-term-gloss-words25 wordschosencorpus.registry.term
corpus-because-words30 wordschosencorpus.rationale.why-cell
corpus-record-words400 wordschosencorpus.rationale.record-anatomy
corpus-adr-section-words250 wordschosencorpus.rationale.contract-adr
corpus-node-words5 wordschosencorpus.diagram.node
corpus-edge-words5 wordschosencorpus.diagram.edge
corpus-decision-words8 wordschosencorpus.diagram.decision
corpus-chart-edges25 edgeschosencorpus.diagram.layout
corpus-chart-nodes20 nodeschosencorpus.diagram.layout
corpus-subgraph-depth2 levelschosencorpus.diagram.layout
corpus-fragment-depth2 levelschosencorpus.diagram.sequence
corpus-messages15 messageschosencorpus.diagram.sequence
corpus-participants6 participantschosencorpus.diagram.sequence
corpus-self-messages2 messageschosencorpus.diagram.sequence
corpus-message-words8 wordschosencorpus.diagram.message
corpus-note-words12 wordschosencorpus.diagram.message
corpus-transition-words6 wordschosencorpus.diagram.state
corpus-guide-operation-words20 wordschosencorpus.guide.file
corpus-guide-words400 wordschosencorpus.guide.file
corpus-guide-paragraph-pointers3 pointerschosencorpus.guide.pointer-density
corpus-guide-pointer-words8 wordschosencorpus.guide.pointer-density
corpus-topic-words600 wordschosencorpus.topic.file
corpus-topic-pages8 pageschosencorpus.topic.pages
corpus-topic-contract-pointers3 pointerschosencorpus.topic.contract-pointers

Decisions