{ "id": "glossary/inference/contracts/contract", "mentions": [ { "context": "Working session on what the contract import reads and what it leaves to the note…", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.md" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L9", "kind": "recognised", "line": 9, "passages": 26, "surface": "contract import", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "The page of an interface whose contract the build imported. Same shell as the en…", "file": { "href": "../../../../specs/screens/pages/api-page/index.html", "label": "screens/pages/api-page.md" }, "href": "../../../../specs/screens/pages/api-page/index.html#L8", "kind": "recognised", "line": 8, "passages": 19, "surface": "contract", "title": "API page", "type": "screen", "typeLabel": "Screen" }, { "context": "…ock of the API page of an API whose contract the build imported. It shows the co…", "file": { "href": "../../../../specs/viewers/contract-viewer/index.html", "label": "viewers/contract-viewer.md" }, "href": "../../../../specs/viewers/contract-viewer/index.html#L8", "kind": "recognised", "line": 8, "passages": 18, "surface": "contract", "title": "Contract viewer", "type": "screen", "typeLabel": "Screen" }, { "context": "… note that names an API with an imported contract, in its api attribute or throu…", "file": { "href": "../../../../specs/rules/contracts/operation-unmatched/index.html", "label": "rules/contracts/operation-unmatched.rule.md" }, "href": "../../../../specs/rules/contracts/operation-unmatched/index.html#L8", "kind": "recognised", "line": 8, "passages": 10, "surface": "imported contract", "title": "Operation unmatched", "type": "rule", "typeLabel": "Business rule" }, { "context": "Contracts: an API note declares its contract, the build imports the operations, …", "file": { "href": "../../../../briefs/framing/2026/2026-05-07-roadmap-outline/roadmap-outline/index.html", "label": "framing/2026/2026-05-07-roadmap-outline/roadmap-outline.md" }, "href": "../../../../briefs/framing/2026/2026-05-07-roadmap-outline/roadmap-outline/index.html#L14", "kind": "recognised", "line": 14, "passages": 9, "surface": "Contracts", "title": "Roadmap outline", "type": "document", "typeLabel": "Document" }, { "context": "… to the operation imported from the contract of its API on three rungs, tried in…", "file": { "href": "../../../../specs/rules/engine/operation-matching/index.html", "label": "rules/engine/operation-matching.rule.md" }, "href": "../../../../specs/rules/engine/operation-matching/index.html#L9", "kind": "recognised", "line": 9, "passages": 5, "surface": "contract", "title": "Operation matching", "type": "rule", "typeLabel": "Business rule" }, { "context": "An API note that declares a contract gets one operation per operation of the con…", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.md" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L13", "kind": "recognised", "line": 13, "passages": 26, "surface": "contract", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "… one operation per operation of the contract; the operation matching rule attach…", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.md" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L13", "kind": "recognised", "line": 13, "passages": 26, "surface": "contract", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "…e about keeps the properties of the contract only and is reported by the operati…", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.md" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L14", "kind": "recognised", "line": 14, "passages": 26, "surface": "contract", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "The contract file lives next to its note, under contracts/, and the fingerprint …", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.md" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L15", "kind": "recognised", "line": 15, "passages": 26, "surface": "contract", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "A contract that cannot be fetched or parsed yields the contract unreachable find…", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.md" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L16", "kind": "recognised", "line": 16, "passages": 26, "surface": "contract", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "…not be fetched or parsed yields the contract unreachable finding; the note keeps…", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.md" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L16", "kind": "recognised", "line": 16, "passages": 26, "surface": "contract", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "…the specification named for OpenAPI contracts is not used: it weighs more than t…", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.md" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L20", "kind": "recognised", "line": 20, "passages": 26, "surface": "contracts", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "…e page budget, expects to fetch the contract over the network and offers to call…", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.md" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L20", "kind": "recognised", "line": 20, "passages": 26, "surface": "contract", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "… to call the API from the page. The contract of an API is shown by a purpose-bui…", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.md" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L20", "kind": "recognised", "line": 20, "passages": 26, "surface": "contract", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "…endered from a JSON fragment of the contract, loaded on demand. The schemas of t…", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.md" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L20", "kind": "recognised", "line": 20, "passages": 26, "surface": "contract", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "…oaded on demand. The schemas of the contract become candidate objects, listed on…", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.md" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L20", "kind": "recognised", "line": 20, "passages": 26, "surface": "contract", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "… scope. The question is what the contract import reads, and what it leaves to th…", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.vtt" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L1", "kind": "recognised", "line": 1, "location": "00:01:12", "passages": 26, "surface": "contract import", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "…rations by hand. When it declares a contract, the build reads the contract and p…", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.vtt" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L2", "kind": "recognised", "line": 2, "location": "00:04:22", "passages": 26, "surface": "contract", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "…res a contract, the build reads the contract and produces one operation per oper…", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.vtt" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L2", "kind": "recognised", "line": 2, "location": "00:04:22", "passages": 26, "surface": "contract", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "…peration matching rule attaches the contract operation to the note that names th…", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.vtt" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L4", "kind": "recognised", "line": 4, "location": "00:11:47", "passages": 26, "surface": "contract", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "…able on the api page comes from the contract, and each row links to the note whe…", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.vtt" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L5", "kind": "recognised", "line": 5, "location": "00:16:57", "passages": 26, "surface": "contract", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "… the api with the properties of the contract only, and the operation unmatched c…", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.vtt" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L6", "kind": "recognised", "line": 6, "location": "00:21:17", "passages": 26, "surface": "contract", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "From the integrator's side, the contract file lives next to the note. Relative p…", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.vtt" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L7", "kind": "recognised", "line": 7, "location": "00:26:02", "passages": 26, "surface": "contract", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "…t to the note. Relative path, under contracts, and the fingerprint cache keeps t…", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.vtt" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L7", "kind": "recognised", "line": 7, "location": "00:26:02", "passages": 26, "surface": "contracts", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "… an interactive console for openapi contracts. It weighs more than the page budg…", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.vtt" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L8", "kind": "recognised", "line": 8, "location": "00:31:32", "passages": 26, "surface": "contracts", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "…he disk. A console that fetches the contract over the network breaks that on the…", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.vtt" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L9", "kind": "recognised", "line": 9, "location": "00:35:32", "passages": 26, "surface": "contract", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "…endered from a json fragment of the contract, loaded on demand, under the page b…", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.vtt" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L11", "kind": "recognised", "line": 11, "location": "00:42:17", "passages": 26, "surface": "contract", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "One more thing for the record: a contract that cannot be fetched or parsed yield…", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.vtt" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L13", "kind": "recognised", "line": 13, "location": "00:48:52", "passages": 26, "surface": "contract", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "…not be fetched or parsed yields the contract unreachable finding and the note ke…", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.vtt" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L13", "kind": "recognised", "line": 13, "location": "00:48:52", "passages": 26, "surface": "contract", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "…gs, not failures. That closes the scope of the contract import for this version.", "file": { "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html", "label": "meetings/2026/2026-06-18-contract-import-scope/contract-import-scope.vtt" }, "href": "../../../../briefs/meetings/2026/2026-06-18-contract-import-scope/contract-import-scope/index.html#L14", "kind": "recognised", "line": 14, "location": "00:53:12", "passages": 26, "surface": "contract import", "title": "Contract import scope review", "type": "meeting", "typeLabel": "Meeting" }, { "context": "…erface, a table matches them to the contract and states the gaps between the con…", "file": { "href": "../../../../specs/screens/pages/api-page/index.html", "label": "screens/pages/api-page.md" }, "href": "../../../../specs/screens/pages/api-page/index.html#L8", "kind": "recognised", "line": 8, "passages": 19, "surface": "contract", "title": "API page", "type": "screen", "typeLabel": "Screen" }, { "context": "…act and states the gaps between the contract and the notes, the contract stands …", "file": { "href": "../../../../specs/screens/pages/api-page/index.html", "label": "screens/pages/api-page.md" }, "href": "../../../../specs/screens/pages/api-page/index.html#L8", "kind": "recognised", "line": 8, "passages": 19, "surface": "contract", "title": "API page", "type": "screen", "typeLabel": "Screen" }, { "context": "…een the contract and the notes, the contract stands in a block of its own, shown…", "file": { "href": "../../../../specs/screens/pages/api-page/index.html", "label": "screens/pages/api-page.md" }, "href": "../../../../specs/screens/pages/api-page/index.html#L8", "kind": "recognised", "line": 8, "passages": 19, "surface": "contract", "title": "API page", "type": "screen", "typeLabel": "Screen" }, { "context": "…elated pages. An API without an imported contract keeps the generic entity page.", "file": { "href": "../../../../specs/screens/pages/api-page/index.html", "label": "screens/pages/api-page.md" }, "href": "../../../../specs/screens/pages/api-page/index.html#L8", "kind": "recognised", "line": 8, "passages": 19, "surface": "imported contract", "title": "API page", "type": "screen", "typeLabel": "Screen" }, { "context": "…isted under it, in the order of the contract as its reader lists it, the paths s…", "file": { "href": "../../../../specs/screens/pages/api-page/index.html", "label": "screens/pages/api-page.md" }, "href": "../../../../specs/screens/pages/api-page/index.html#L12", "kind": "recognised", "line": 12, "passages": 19, "surface": "contract", "title": "API page", "type": "screen", "typeLabel": "Screen" }, { "context": "…Operations\", led by \"Matched to the contract by operation name.\" One row per ope…", "file": { "href": "../../../../specs/screens/pages/api-page/index.html", "label": "screens/pages/api-page.md" }, "href": "../../../../specs/screens/pages/api-page/index.html#L14", "kind": "recognised", "line": 14, "passages": 19, "surface": "contract", "title": "API page", "type": "screen", "typeLabel": "Screen" }, { "context": "…ched to a note, in the order of the contract, the same as the tree: the method a…", "file": { "href": "../../../../specs/screens/pages/api-page/index.html", "label": "screens/pages/api-page.md" }, "href": "../../../../specs/screens/pages/api-page/index.html#L14", "kind": "recognised", "line": 14, "passages": 19, "surface": "contract", "title": "API page", "type": "screen", "typeLabel": "Screen" }, { "context": "…table holds a gap: an operation the contract declares that no note describes, un…", "file": { "href": "../../../../specs/screens/pages/api-page/index.html", "label": "screens/pages/api-page.md" }, "href": "../../../../specs/screens/pages/api-page/index.html#L14", "kind": "recognised", "line": 14, "passages": 19, "surface": "contract", "title": "API page", "type": "screen", "typeLabel": "Screen" }, { "context": "…s, unlinked, marked \"present in the contract, without a page\"; and an operation …", "file": { "href": "../../../../specs/screens/pages/api-page/index.html", "label": "screens/pages/api-page.md" }, "href": "../../../../specs/screens/pages/api-page/index.html#L14", "kind": "recognised", "line": 14, "passages": 19, "surface": "contract", "title": "API page", "type": "screen", "typeLabel": "Screen" }, { "context": "… a page\"; and an operation note the contract does not declare, the notes the ope…", "file": { "href": "../../../../specs/screens/pages/api-page/index.html", "label": "screens/pages/api-page.md" }, "href": "../../../../specs/screens/pages/api-page/index.html#L14", "kind": "recognised", "line": 14, "passages": 19, "surface": "contract", "title": "API page", "type": "screen", "typeLabel": "Screen" }, { "context": "… marked \"described, absent from the contract\". The rows are text in the served p…", "file": { "href": "../../../../specs/screens/pages/api-page/index.html", "label": "screens/pages/api-page.md" }, "href": "../../../../specs/screens/pages/api-page/index.html#L14", "kind": "recognised", "line": 14, "passages": 19, "surface": "contract", "title": "API page", "type": "screen", "typeLabel": "Screen" }, { "context": "… The rows are text in the served page; a contract without any operation says so.", "file": { "href": "../../../../specs/screens/pages/api-page/index.html", "label": "screens/pages/api-page.md" }, "href": "../../../../specs/screens/pages/api-page/index.html#L14", "kind": "recognised", "line": 14, "passages": 19, "surface": "contract", "title": "API page", "type": "screen", "typeLabel": "Screen" }, { "context": "\"Interface contract\" follows as a card: on its first line the format the import …", "file": { "href": "../../../../specs/screens/pages/api-page/index.html", "label": "screens/pages/api-page.md" }, "href": "../../../../specs/screens/pages/api-page/index.html#L16", "kind": "recognised", "line": 16, "passages": 19, "surface": "Interface contract", "title": "API page", "type": "screen", "typeLabel": "Screen" }, { "context": "…N days ago\", the last change of the contract file relative to the build, from th…", "file": { "href": "../../../../specs/screens/pages/api-page/index.html", "label": "screens/pages/api-page.md" }, "href": "../../../../specs/screens/pages/api-page/index.html#L16", "kind": "recognised", "line": 16, "passages": 19, "surface": "contract", "title": "API page", "type": "screen", "typeLabel": "Screen" }, { "context": "…d into the text: the page shows the contract, it does not duplicate it; at the f…", "file": { "href": "../../../../specs/screens/pages/api-page/index.html", "label": "screens/pages/api-page.md" }, "href": "../../../../specs/screens/pages/api-page/index.html#L16", "kind": "recognised", "line": 16, "passages": 19, "surface": "contract", "title": "API page", "type": "screen", "typeLabel": "Screen" }, { "context": "…e that the operations come from the contract, not from the header. \"Related page…", "file": { "href": "../../../../specs/screens/pages/api-page/index.html", "label": "screens/pages/api-page.md" }, "href": "../../../../specs/screens/pages/api-page/index.html#L18", "kind": "recognised", "line": 18, "passages": 19, "surface": "contract", "title": "API page", "type": "screen", "typeLabel": "Screen" }, { "context": "Download the contract → the declared URL or the copy next to the page", "file": { "href": "../../../../specs/screens/pages/api-page/index.html", "label": "screens/pages/api-page.md" }, "href": "../../../../specs/screens/pages/api-page/index.html#L28", "kind": "recognised", "line": 28, "passages": 19, "surface": "contract", "title": "API page", "type": "screen", "typeLabel": "Screen" }, { "context": "Read the contract → contract viewer, open in the page", "file": { "href": "../../../../specs/screens/pages/api-page/index.html", "label": "screens/pages/api-page.md" }, "href": "../../../../specs/screens/pages/api-page/index.html#L29", "kind": "recognised", "line": 29, "passages": 19, "surface": "contract", "title": "API page", "type": "screen", "typeLabel": "Screen" }, { "context": "…ct the build imported. It shows the contract next to the note without copying an…", "file": { "href": "../../../../specs/viewers/contract-viewer/index.html", "label": "viewers/contract-viewer.md" }, "href": "../../../../specs/viewers/contract-viewer/index.html#L8", "kind": "recognised", "line": 8, "passages": 18, "surface": "contract", "title": "Contract viewer", "type": "screen", "typeLabel": "Screen" }, { "context": "…rkdown: what the model knows of the contract stands in the served HTML, and the …", "file": { "href": "../../../../specs/viewers/contract-viewer/index.html", "label": "viewers/contract-viewer.md" }, "href": "../../../../specs/viewers/contract-viewer/index.html#L8", "kind": "recognised", "line": 8, "passages": 18, "surface": "contract", "title": "Contract viewer", "type": "screen", "typeLabel": "Screen" }, { "context": "…f the file, under the heading \"Interface contract\". Its first line gives the for…", "file": { "href": "../../../../specs/viewers/contract-viewer/index.html", "label": "viewers/contract-viewer.md" }, "href": "../../../../specs/viewers/contract-viewer/index.html#L12", "kind": "recognised", "line": 12, "passages": 18, "surface": "Interface contract", "title": "Contract viewer", "type": "screen", "typeLabel": "Screen" }, { "context": "…ote names and, at its end, when the contract last changed relative to the build,…", "file": { "href": "../../../../specs/viewers/contract-viewer/index.html", "label": "viewers/contract-viewer.md" }, "href": "../../../../specs/viewers/contract-viewer/index.html#L12", "kind": "recognised", "line": 12, "passages": 18, "surface": "contract", "title": "Contract viewer", "type": "screen", "typeLabel": "Screen" }, { "context": "…he instant of the import only for a contract fetched from a URL. Its last line i…", "file": { "href": "../../../../specs/viewers/contract-viewer/index.html", "label": "viewers/contract-viewer.md" }, "href": "../../../../specs/viewers/contract-viewer/index.html#L12", "kind": "recognised", "line": 12, "passages": 18, "surface": "contract", "title": "Contract viewer", "type": "screen", "typeLabel": "Screen" }, { "context": "…last line is the link \"Download the contract\": the URL declared in the note when…", "file": { "href": "../../../../specs/viewers/contract-viewer/index.html", "label": "viewers/contract-viewer.md" }, "href": "../../../../specs/viewers/contract-viewer/index.html#L12", "kind": "recognised", "line": 12, "passages": 18, "surface": "contract", "title": "Contract viewer", "type": "screen", "typeLabel": "Screen" }, { "context": "…e URL declared in the note when the contract is remote, or the copy of the file …", "file": { "href": "../../../../specs/viewers/contract-viewer/index.html", "label": "viewers/contract-viewer.md" }, "href": "../../../../specs/viewers/contract-viewer/index.html#L12", "kind": "recognised", "line": 12, "passages": 18, "surface": "contract", "title": "Contract viewer", "type": "screen", "typeLabel": "Screen" }, { "context": "…and its callers, the operations the contract declares without a note and the not…", "file": { "href": "../../../../specs/viewers/contract-viewer/index.html", "label": "viewers/contract-viewer.md" }, "href": "../../../../specs/viewers/contract-viewer/index.html#L14", "kind": "recognised", "line": 14, "passages": 18, "surface": "contract", "title": "Contract viewer", "type": "screen", "typeLabel": "Screen" }, { "context": "…es without a note and the notes the contract does not declare in italics, the ot…", "file": { "href": "../../../../specs/viewers/contract-viewer/index.html", "label": "viewers/contract-viewer.md" }, "href": "../../../../specs/viewers/contract-viewer/index.html#L14", "kind": "recognised", "line": 14, "passages": 18, "surface": "contract", "title": "Contract viewer", "type": "screen", "typeLabel": "Screen" }, { "context": "…e page. Served, it holds one link, \"Contract data (JSON)\", to the view of the co…", "file": { "href": "../../../../specs/viewers/contract-viewer/index.html", "label": "viewers/contract-viewer.md" }, "href": "../../../../specs/viewers/contract-viewer/index.html#L16", "kind": "recognised", "line": 16, "passages": 18, "surface": "Contract", "title": "Contract viewer", "type": "screen", "typeLabel": "Screen" }, { "context": "…ct data (JSON)\", to the view of the contract the build wrote next to the fragmen…", "file": { "href": "../../../../specs/viewers/contract-viewer/index.html", "label": "viewers/contract-viewer.md" }, "href": "../../../../specs/viewers/contract-viewer/index.html#L16", "kind": "recognised", "line": 16, "passages": 18, "surface": "contract", "title": "Contract viewer", "type": "screen", "typeLabel": "Screen" }, { "context": "…tches that view, once, \"Loading the contract…\" standing in the meantime, and ope…", "file": { "href": "../../../../specs/viewers/contract-viewer/index.html", "label": "viewers/contract-viewer.md" }, "href": "../../../../specs/viewers/contract-viewer/index.html#L16", "kind": "recognised", "line": 16, "passages": 18, "surface": "contract", "title": "Contract viewer", "type": "screen", "typeLabel": "Screen" }, { "context": "…every operation in the order of the contract behind a disclosure button, its sig…", "file": { "href": "../../../../specs/viewers/contract-viewer/index.html", "label": "viewers/contract-viewer.md" }, "href": "../../../../specs/viewers/contract-viewer/index.html#L16", "kind": "recognised", "line": 16, "passages": 18, "surface": "contract", "title": "Contract viewer", "type": "screen", "typeLabel": "Screen" }, { "context": "…nature (method and path for an HTTP contract, operation, port and binding for a …", "file": { "href": "../../../../specs/viewers/contract-viewer/index.html", "label": "viewers/contract-viewer.md" }, "href": "../../../../specs/viewers/contract-viewer/index.html#L16", "kind": "recognised", "line": 16, "passages": 18, "surface": "contract", "title": "Contract viewer", "type": "screen", "typeLabel": "Screen" }, { "context": "…d into the text: the page shows the contract, it does not duplicate it. When the…", "file": { "href": "../../../../specs/viewers/contract-viewer/index.html", "label": "viewers/contract-viewer.md" }, "href": "../../../../specs/viewers/contract-viewer/index.html#L16", "kind": "recognised", "line": 16, "passages": 18, "surface": "contract", "title": "Contract viewer", "type": "screen", "typeLabel": "Screen" }, { "context": "…onent renders an OpenAPI and a WSDL contract: the plugins that import them produ…", "file": { "href": "../../../../specs/viewers/contract-viewer/index.html", "label": "viewers/contract-viewer.md" }, "href": "../../../../specs/viewers/contract-viewer/index.html#L18", "kind": "recognised", "line": 18, "passages": 18, "surface": "contract", "title": "Contract viewer", "type": "screen", "typeLabel": "Screen" }, { "context": "Download the contract → the declared URL or the copy next to the page", "file": { "href": "../../../../specs/viewers/contract-viewer/index.html", "label": "viewers/contract-viewer.md" }, "href": "../../../../specs/viewers/contract-viewer/index.html#L27", "kind": "recognised", "line": 27, "passages": 18, "surface": "contract", "title": "Contract viewer", "type": "screen", "typeLabel": "Screen" }, { "context": "…ng attaches to an operation of that contract. One of two things is true: the ope…", "file": { "href": "../../../../specs/rules/contracts/operation-unmatched/index.html", "label": "rules/contracts/operation-unmatched.rule.md" }, "href": "../../../../specs/rules/contracts/operation-unmatched/index.html#L8", "kind": "recognised", "line": 8, "passages": 10, "surface": "contract", "title": "Operation unmatched", "type": "rule", "typeLabel": "Business rule" }, { "context": "… the operation disappeared from the contract and the note describes something th…", "file": { "href": "../../../../specs/rules/contracts/operation-unmatched/index.html", "label": "rules/contracts/operation-unmatched.rule.md" }, "href": "../../../../specs/rules/contracts/operation-unmatched/index.html#L8", "kind": "recognised", "line": 8, "passages": 10, "surface": "contract", "title": "Operation unmatched", "type": "rule", "typeLabel": "Business rule" }, { "context": "…exists, or the note is ahead of the contract and describes an operation the next…", "file": { "href": "../../../../specs/rules/contracts/operation-unmatched/index.html", "label": "rules/contracts/operation-unmatched.rule.md" }, "href": "../../../../specs/rules/contracts/operation-unmatched/index.html#L8", "kind": "recognised", "line": 8, "passages": 10, "surface": "contract", "title": "Operation unmatched", "type": "rule", "typeLabel": "Business rule" }, { "context": "… the operation_id to come until the contract catches up. A note that names no AP…", "file": { "href": "../../../../specs/rules/contracts/operation-unmatched/index.html", "label": "rules/contracts/operation-unmatched.rule.md" }, "href": "../../../../specs/rules/contracts/operation-unmatched/index.html#L8", "kind": "recognised", "line": 8, "passages": 10, "surface": "contract", "title": "Operation unmatched", "type": "rule", "typeLabel": "Business rule" }, { "context": "…ported: it is a candidate for every contract of its source and may describe an A…", "file": { "href": "../../../../specs/rules/contracts/operation-unmatched/index.html", "label": "rules/contracts/operation-unmatched.rule.md" }, "href": "../../../../specs/rules/contracts/operation-unmatched/index.html#L8", "kind": "recognised", "line": 8, "passages": 10, "surface": "contract", "title": "Operation unmatched", "type": "rule", "typeLabel": "Business rule" }, { "context": "…e and may describe an API without a contract. A note taken in an ambiguity is re…", "file": { "href": "../../../../specs/rules/contracts/operation-unmatched/index.html", "label": "rules/contracts/operation-unmatched.rule.md" }, "href": "../../../../specs/rules/contracts/operation-unmatched/index.html#L8", "kind": "recognised", "line": 8, "passages": 10, "surface": "contract", "title": "Operation unmatched", "type": "rule", "typeLabel": "Business rule" }, { "context": "…viewer lists every operation of the contract and flags the ones no note describe…", "file": { "href": "../../../../specs/rules/contracts/operation-unmatched/index.html", "label": "rules/contracts/operation-unmatched.rule.md" }, "href": "../../../../specs/rules/contracts/operation-unmatched/index.html#L10", "kind": "recognised", "line": 10, "passages": 10, "surface": "contract", "title": "Operation unmatched", "type": "rule", "typeLabel": "Business rule" }, { "context": "…an API: what the notes say that the contract does not, and what the contract dec…", "file": { "href": "../../../../specs/rules/contracts/operation-unmatched/index.html", "label": "rules/contracts/operation-unmatched.rule.md" }, "href": "../../../../specs/rules/contracts/operation-unmatched/index.html#L10", "kind": "recognised", "line": 10, "passages": 10, "surface": "contract", "title": "Operation unmatched", "type": "rule", "typeLabel": "Business rule" }, { "context": "…hat the contract does not, and what the contract declares that the notes do not.", "file": { "href": "../../../../specs/rules/contracts/operation-unmatched/index.html", "label": "rules/contracts/operation-unmatched.rule.md" }, "href": "../../../../specs/rules/contracts/operation-unmatched/index.html#L10", "kind": "recognised", "line": 10, "passages": 10, "surface": "contract", "title": "Operation unmatched", "type": "rule", "typeLabel": "Business rule" }, { "context": "Contracts: an API note declares its contract, the build imports the operations, …", "file": { "href": "../../../../briefs/framing/2026/2026-05-07-roadmap-outline/roadmap-outline/index.html", "label": "framing/2026/2026-05-07-roadmap-outline/roadmap-outline.md" }, "href": "../../../../briefs/framing/2026/2026-05-07-roadmap-outline/roadmap-outline/index.html#L14", "kind": "recognised", "line": 14, "passages": 9, "surface": "contract", "title": "Roadmap outline", "type": "document", "typeLabel": "Document" }, { "context": "…it names, and a purpose-built viewer renders the contract under the page budget.", "file": { "href": "../../../../briefs/framing/2026/2026-05-07-roadmap-outline/roadmap-outline/index.html", "label": "framing/2026/2026-05-07-roadmap-outline/roadmap-outline.md" }, "href": "../../../../briefs/framing/2026/2026-05-07-roadmap-outline/roadmap-outline/index.html#L14", "kind": "recognised", "line": 14, "passages": 9, "surface": "contract", "title": "Roadmap outline", "type": "document", "typeLabel": "Document" }, { "context": "3 · CONTRACTS The operations an API really exposes An API note declares its co…", "file": { "href": "../../../../briefs/framing/2026/2026-05-07-roadmap-outline/roadmap-outline/index.html", "label": "framing/2026/2026-05-07-roadmap-outline/roadmap-outline.pdf" }, "href": "../../../../briefs/framing/2026/2026-05-07-roadmap-outline/roadmap-outline/index.html#L4", "kind": "recognised", "line": 4, "location": "page 4", "passages": 9, "surface": "CONTRACTS", "title": "Roadmap outline", "type": "document", "typeLabel": "Document" }, { "context": "…y exposes An API note declares its contract; the build imports the operations. …", "file": { "href": "../../../../briefs/framing/2026/2026-05-07-roadmap-outline/roadmap-outline/index.html", "label": "framing/2026/2026-05-07-roadmap-outline/roadmap-outline.pdf" }, "href": "../../../../briefs/framing/2026/2026-05-07-roadmap-outline/roadmap-outline/index.html#L4", "kind": "recognised", "line": 4, "location": "page 4", "passages": 9, "surface": "contract", "title": "Roadmap outline", "type": "document", "typeLabel": "Document" }, { "context": "… A purpose-built viewer renders the contract under the page budget. Roadmap out…", "file": { "href": "../../../../briefs/framing/2026/2026-05-07-roadmap-outline/roadmap-outline/index.html", "label": "framing/2026/2026-05-07-roadmap-outline/roadmap-outline.pdf" }, "href": "../../../../briefs/framing/2026/2026-05-07-roadmap-outline/roadmap-outline/index.html#L4", "kind": "recognised", "line": 4, "location": "page 4", "passages": 9, "surface": "contract", "title": "Roadmap outline", "type": "document", "typeLabel": "Document" }, { "context": "3 · CONTRACTS The operations an API really exposes An API note declares its co…", "file": { "href": "../../../../briefs/framing/2026/2026-05-07-roadmap-outline/roadmap-outline/index.html", "label": "framing/2026/2026-05-07-roadmap-outline/roadmap-outline.pptx" }, "href": "../../../../briefs/framing/2026/2026-05-07-roadmap-outline/roadmap-outline/index.html#L4", "kind": "recognised", "line": 4, "location": "slide 4", "passages": 9, "surface": "CONTRACTS", "title": "Roadmap outline", "type": "document", "typeLabel": "Document" }, { "context": "…y exposes An API note declares its contract; the build imports the operations. …", "file": { "href": "../../../../briefs/framing/2026/2026-05-07-roadmap-outline/roadmap-outline/index.html", "label": "framing/2026/2026-05-07-roadmap-outline/roadmap-outline.pptx" }, "href": "../../../../briefs/framing/2026/2026-05-07-roadmap-outline/roadmap-outline/index.html#L4", "kind": "recognised", "line": 4, "location": "slide 4", "passages": 9, "surface": "contract", "title": "Roadmap outline", "type": "document", "typeLabel": "Document" }, { "context": "… A purpose-built viewer renders the contract under the page budget. Roadmap out…", "file": { "href": "../../../../briefs/framing/2026/2026-05-07-roadmap-outline/roadmap-outline/index.html", "label": "framing/2026/2026-05-07-roadmap-outline/roadmap-outline.pptx" }, "href": "../../../../briefs/framing/2026/2026-05-07-roadmap-outline/roadmap-outline/index.html#L4", "kind": "recognised", "line": 4, "location": "slide 4", "passages": 9, "surface": "contract", "title": "Roadmap outline", "type": "document", "typeLabel": "Document" }, { "context": "…nst the operation identifier of the contract; the method and path pair (or port …", "file": { "href": "../../../../specs/rules/engine/operation-matching/index.html", "label": "rules/engine/operation-matching.rule.md" }, "href": "../../../../specs/rules/engine/operation-matching/index.html#L9", "kind": "recognised", "line": 9, "passages": 5, "surface": "contract", "title": "Operation matching", "type": "rule", "typeLabel": "Business rule" }, { "context": "… names none is a candidate for every API of its source that declares a contract.", "file": { "href": "../../../../specs/rules/engine/operation-matching/index.html", "label": "rules/engine/operation-matching.rule.md" }, "href": "../../../../specs/rules/engine/operation-matching/index.html#L9", "kind": "recognised", "line": 9, "passages": 5, "surface": "contract", "title": "Operation matching", "type": "rule", "typeLabel": "Business rule" }, { "context": "…ontmatter, takes the properties the contract declares (method, path, summary, st…", "file": { "href": "../../../../specs/rules/engine/operation-matching/index.html", "label": "rules/engine/operation-matching.rule.md" }, "href": "../../../../specs/rules/engine/operation-matching/index.html#L11", "kind": "recognised", "line": 11, "passages": 5, "surface": "contract", "title": "Operation matching", "type": "rule", "typeLabel": "Business rule" }, { "context": "…hen it does not set them, lists the contract as a representation next to its own…", "file": { "href": "../../../../specs/rules/engine/operation-matching/index.html", "label": "rules/engine/operation-matching.rule.md" }, "href": "../../../../specs/rules/engine/operation-matching/index.html#L11", "kind": "recognised", "line": 11, "passages": 5, "surface": "contract", "title": "Operation matching", "type": "rule", "typeLabel": "Business rule" }, { "context": "…ponent with a typed view model, the contract between the generator and a theme. …", "file": { "href": "../../../../briefs/meetings/2026/2026-08-27-theme-override-model/theme-override-model/index.html", "label": "meetings/2026/2026-08-27-theme-override-model/theme-override-model.md" }, "href": "../../../../briefs/meetings/2026/2026-08-27-theme-override-model/theme-override-model/index.html#L14", "kind": "recognised", "line": 14, "passages": 4, "surface": "contract", "title": "Theme override model", "type": "meeting", "typeLabel": "Meeting" }, { "context": "…t. The view model of a slot is the contract between the generator and a theme. …", "file": { "href": "../../../../briefs/meetings/2026/2026-08-27-theme-override-model/theme-override-model/index.html", "label": "meetings/2026/2026-08-27-theme-override-model/theme-override-model.pdf" }, "href": "../../../../briefs/meetings/2026/2026-08-27-theme-override-model/theme-override-model/index.html#L4", "kind": "recognised", "line": 4, "location": "page 4", "passages": 4, "surface": "contract", "title": "Theme override model", "type": "meeting", "typeLabel": "Meeting" }, { "context": "…t. The view model of a slot is the contract between the generator and a theme. …", "file": { "href": "../../../../briefs/meetings/2026/2026-08-27-theme-override-model/theme-override-model/index.html", "label": "meetings/2026/2026-08-27-theme-override-model/theme-override-model.pptx" }, "href": "../../../../briefs/meetings/2026/2026-08-27-theme-override-model/theme-override-model/index.html#L4", "kind": "recognised", "line": 4, "location": "slide 4", "passages": 4, "surface": "contract", "title": "Theme override model", "type": "meeting", "typeLabel": "Meeting" }, { "context": "…ed view model. The view model is the contract between the generator and a theme.", "file": { "href": "../../../../briefs/meetings/2026/2026-08-27-theme-override-model/theme-override-model/index.html", "label": "meetings/2026/2026-08-27-theme-override-model/theme-override-model.vtt" }, "href": "../../../../briefs/meetings/2026/2026-08-27-theme-override-model/theme-override-model/index.html#L4", "kind": "recognised", "line": 4, "location": "00:15:00", "passages": 4, "surface": "contract", "title": "Theme override model", "type": "meeting", "typeLabel": "Meeting" }, { "context": "…: a method and a path in an OpenAPI contract, a port and an operation name in a …", "file": { "href": "../operation/index.html", "label": "inference/contracts/operation.md" }, "href": "../operation/index.html#L7", "kind": "recognised", "line": 7, "passages": 4, "surface": "contract", "title": "Operation", "type": "term", "typeLabel": "Term" }, { "context": "…ports every operation of a declared contract as an endpoint entity with the prop…", "file": { "href": "../operation/index.html", "label": "inference/contracts/operation.md" }, "href": "../operation/index.html#L7", "kind": "recognised", "line": 7, "passages": 4, "surface": "contract", "title": "Operation", "type": "term", "typeLabel": "Term" }, { "context": "…oint entity with the properties the contract states. An author who has business …", "file": { "href": "../operation/index.html", "label": "inference/contracts/operation.md" }, "href": "../operation/index.html#L7", "kind": "recognised", "line": 7, "passages": 4, "surface": "contract", "title": "Operation", "type": "term", "typeLabel": "Term" }, { "context": "…ion, showing its own markdown, the properties of the contract and its own links.", "file": { "href": "../operation/index.html", "label": "inference/contracts/operation.md" }, "href": "../operation/index.html#L7", "kind": "recognised", "line": 7, "passages": 4, "surface": "contract", "title": "Operation", "type": "term", "typeLabel": "Term" }, { "context": "… check family of the APIs and their contracts: W-CONTRACT-UNREACHABLE, a contrac…", "file": { "href": "../../../quality/checks/contract-checks/index.html", "label": "quality/checks/contract-checks.md" }, "href": "../../../quality/checks/contract-checks/index.html#L7", "kind": "recognised", "line": 7, "passages": 4, "surface": "contracts", "title": "Contract checks", "type": "term", "typeLabel": "Term" }, { "context": "…ontracts: W-CONTRACT-UNREACHABLE, a contract the contract import could not fetch…", "file": { "href": "../../../quality/checks/contract-checks/index.html", "label": "quality/checks/contract-checks.md" }, "href": "../../../quality/checks/contract-checks/index.html#L7", "kind": "recognised", "line": 7, "passages": 4, "surface": "contract", "title": "Contract checks", "type": "term", "typeLabel": "Term" }, { "context": "…RACT-UNREACHABLE, a contract the contract import could not fetch, read or parse;…", "file": { "href": "../../../quality/checks/contract-checks/index.html", "label": "quality/checks/contract-checks.md" }, "href": "../../../quality/checks/contract-checks/index.html#L7", "kind": "recognised", "line": 7, "passages": 4, "surface": "contract import", "title": "Contract checks", "type": "term", "typeLabel": "Term" }, { "context": "… check family of the APIs and their contracts: W-CONTRACT-UNREACHABLE, a contrac…", "file": { "href": "../../../quality/checks/contract-checks/index.html", "label": "quality/checks/contract-checks.md" }, "href": "../../../quality/checks/contract-checks/index.html#L7", "kind": "written", "line": 7, "passages": 4, "surface": "contracts", "title": "Contract checks", "type": "term", "typeLabel": "Term" }, { "context": "…e command line of this version; the contract, an OpenAPI 3.1 document kept next …", "file": { "href": "../../../../specs/api/model-query/index.html", "label": "api/model-query.md" }, "href": "../../../../specs/api/model-query/index.html#L10", "kind": "recognised", "line": 10, "passages": 4, "surface": "contract", "title": "Model query API", "type": "api", "typeLabel": "API" }, { "context": "… today, keeps the properties of the contract only, and a note the contract does …", "file": { "href": "../../../../specs/api/model-query/index.html", "label": "api/model-query.md" }, "href": "../../../../specs/api/model-query/index.html#L10", "kind": "recognised", "line": 10, "passages": 4, "surface": "contract", "title": "Model query API", "type": "api", "typeLabel": "API" }, { "context": "…f the contract only, and a note the contract does not declare yet, suggest links…", "file": { "href": "../../../../specs/api/model-query/index.html", "label": "api/model-query.md" }, "href": "../../../../specs/api/model-query/index.html#L10", "kind": "recognised", "line": 10, "passages": 4, "surface": "contract", "title": "Model query API", "type": "api", "typeLabel": "API" }, { "context": "…ext version. The API page states both gaps and shows the contract in its viewer.", "file": { "href": "../../../../specs/api/model-query/index.html", "label": "api/model-query.md" }, "href": "../../../../specs/api/model-query/index.html#L10", "kind": "recognised", "line": 10, "passages": 4, "surface": "contract", "title": "Model query API", "type": "api", "typeLabel": "API" }, { "context": "…es of the last build: the objects a contract names without a note and the expres…", "file": { "href": "../../../../specs/api/operations/suggest-links/index.html", "label": "api/operations/suggest-links.md" }, "href": "../../../../specs/api/operations/suggest-links/index.html#L8", "kind": "recognised", "line": 8, "passages": 4, "surface": "contract", "title": "Suggest links", "type": "endpoint", "typeLabel": "Operation" }, { "context": "…tion yet: this note is ahead of its contract, which the operation unmatched rule…", "file": { "href": "../../../../specs/api/operations/suggest-links/index.html", "label": "api/operations/suggest-links.md" }, "href": "../../../../specs/api/operations/suggest-links/index.html#L8", "kind": "recognised", "line": 8, "passages": 4, "surface": "contract", "title": "Suggest links", "type": "endpoint", "typeLabel": "Operation" }, { "context": "…on unmatched rule reports until the contract catches up, and the API page lists …", "file": { "href": "../../../../specs/api/operations/suggest-links/index.html", "label": "api/operations/suggest-links.md" }, "href": "../../../../specs/api/operations/suggest-links/index.html#L8", "kind": "recognised", "line": 8, "passages": 4, "surface": "contract", "title": "Suggest links", "type": "endpoint", "typeLabel": "Operation" }, { "context": "…, and the API page lists it among the gaps, described, absent from the contract.", "file": { "href": "../../../../specs/api/operations/suggest-links/index.html", "label": "api/operations/suggest-links.md" }, "href": "../../../../specs/api/operations/suggest-links/index.html#L8", "kind": "recognised", "line": 8, "passages": 4, "surface": "contract", "title": "Suggest links", "type": "endpoint", "typeLabel": "Operation" }, { "context": "The contract of an API is shown by a viewer the tool builds itself, rather than …", "file": { "href": "../../../../specs/decisions/publication/purpose-built-contract-viewer/index.html", "label": "decisions/publication/purpose-built-contract-viewer.md" }, "href": "../../../../specs/decisions/publication/purpose-built-contract-viewer/index.html#L8", "kind": "recognised", "line": 8, "passages": 4, "surface": "contract", "title": "Purpose-built contract viewer", "type": "decision", "typeLabel": "Decision" }, { "context": "…ecification first named for OpenAPI contracts. That console weighs more than the…", "file": { "href": "../../../../specs/decisions/publication/purpose-built-contract-viewer/index.html", "label": "decisions/publication/purpose-built-contract-viewer.md" }, "href": "../../../../specs/decisions/publication/purpose-built-contract-viewer/index.html#L8", "kind": "recognised", "line": 8, "passages": 4, "surface": "contracts", "title": "Purpose-built contract viewer", "type": "decision", "typeLabel": "Decision" }, { "context": "…ew the build writes from the cached contract: the operations with their paramete…", "file": { "href": "../../../../specs/decisions/publication/purpose-built-contract-viewer/index.html", "label": "decisions/publication/purpose-built-contract-viewer.md" }, "href": "../../../../specs/decisions/publication/purpose-built-contract-viewer/index.html#L10", "kind": "recognised", "line": 10, "passages": 4, "surface": "contract", "title": "Purpose-built contract viewer", "type": "decision", "typeLabel": "Decision" }, { "context": "…a explorer, read-only. The original contract stays downloadable at its URL or fr…", "file": { "href": "../../../../specs/decisions/publication/purpose-built-contract-viewer/index.html", "label": "decisions/publication/purpose-built-contract-viewer.md" }, "href": "../../../../specs/decisions/publication/purpose-built-contract-viewer/index.html#L10", "kind": "recognised", "line": 10, "passages": 4, "surface": "contract", "title": "Purpose-built contract viewer", "type": "decision", "typeLabel": "Decision" }, { "context": "…ins on the typed entities: the contract importers read the contract each API not…", "file": { "href": "../../../../specs/processes/ingestion/build-pipeline/index.html", "label": "processes/ingestion/build-pipeline.md" }, "href": "../../../../specs/processes/ingestion/build-pipeline/index.html#L18", "kind": "recognised", "line": 18, "passages": 4, "surface": "contract importers", "title": "Build pipeline", "type": "process", "typeLabel": "Process" }, { "context": "…es: the contract importers read the contract each API note declares and add its …", "file": { "href": "../../../../specs/processes/ingestion/build-pipeline/index.html", "label": "processes/ingestion/build-pipeline.md" }, "href": "../../../../specs/processes/ingestion/build-pipeline/index.html#L18", "kind": "recognised", "line": 18, "passages": 4, "surface": "contract", "title": "Build pipeline", "type": "process", "typeLabel": "Process" }, { "context": "…their exposes links, the candidate objects and one contract record per contract.", "file": { "href": "../../../../specs/processes/ingestion/build-pipeline/index.html", "label": "processes/ingestion/build-pipeline.md" }, "href": "../../../../specs/processes/ingestion/build-pipeline/index.html#L18", "kind": "recognised", "line": 18, "passages": 4, "surface": "contract", "title": "Build pipeline", "type": "process", "typeLabel": "Process" }, { "context": "…their exposes links, the candidate objects and one contract record per contract.", "file": { "href": "../../../../specs/processes/ingestion/build-pipeline/index.html", "label": "processes/ingestion/build-pipeline.md" }, "href": "../../../../specs/processes/ingestion/build-pipeline/index.html#L18", "kind": "recognised", "line": 18, "passages": 4, "surface": "contract", "title": "Build pipeline", "type": "process", "typeLabel": "Process" }, { "context": "Contract unreachable. The page of an interface whose declared contract the build…", "file": { "href": "../../../../specs/screens/pages/edge-cases/index.html", "label": "screens/pages/edge-cases.md" }, "href": "../../../../specs/screens/pages/edge-cases/index.html#L21", "kind": "recognised", "line": 21, "passages": 4, "surface": "Contract", "title": "Edge cases", "type": "screen", "typeLabel": "Screen" }, { "context": "…page of an interface whose declared contract the build could not read, the findi…", "file": { "href": "../../../../specs/screens/pages/edge-cases/index.html", "label": "screens/pages/edge-cases.md" }, "href": "../../../../specs/screens/pages/edge-cases/index.html#L21", "kind": "recognised", "line": 21, "passages": 4, "surface": "contract", "title": "Edge cases", "type": "screen", "typeLabel": "Screen" }, { "context": "…ts title with the same notice: \"The contract of this interface could not be read…", "file": { "href": "../../../../specs/screens/pages/edge-cases/index.html", "label": "screens/pages/edge-cases.md" }, "href": "../../../../specs/screens/pages/edge-cases/index.html#L21", "kind": "recognised", "line": 21, "passages": 4, "surface": "contract", "title": "Edge cases", "type": "screen", "typeLabel": "Screen" }, { "context": "…like any page.\", the exit \"Open the contract address\" when the declared location…", "file": { "href": "../../../../specs/screens/pages/edge-cases/index.html", "label": "screens/pages/edge-cases.md" }, "href": "../../../../specs/screens/pages/edge-cases/index.html#L21", "kind": "recognised", "line": 21, "passages": 4, "surface": "contract", "title": "Edge cases", "type": "screen", "typeLabel": "Screen" }, { "context": "Contract", "file": { "href": "../../../../specs/screens/pages/entity-page/index.html", "label": "screens/pages/entity-page.md" }, "href": "../../../../specs/screens/pages/entity-page/index.html#L33", "kind": "recognised", "line": 33, "passages": 4, "surface": "Contract", "title": "Entity page", "type": "screen", "typeLabel": "Screen" }, { "context": "The page of an API whose contract the build imported is the API page: the same s…", "file": { "href": "../../../../specs/screens/pages/entity-page/index.html", "label": "screens/pages/entity-page.md" }, "href": "../../../../specs/screens/pages/entity-page/index.html#L35", "kind": "recognised", "line": 35, "passages": 4, "surface": "contract", "title": "Entity page", "type": "screen", "typeLabel": "Screen" }, { "context": "…the operations table matched to the contract and the contract block with the con…", "file": { "href": "../../../../specs/screens/pages/entity-page/index.html", "label": "screens/pages/entity-page.md" }, "href": "../../../../specs/screens/pages/entity-page/index.html#L35", "kind": "recognised", "line": 35, "passages": 4, "surface": "contract", "title": "Entity page", "type": "screen", "typeLabel": "Screen" }, { "context": "…ble matched to the contract and the contract block with the contract viewer afte…", "file": { "href": "../../../../specs/screens/pages/entity-page/index.html", "label": "screens/pages/entity-page.md" }, "href": "../../../../specs/screens/pages/entity-page/index.html#L35", "kind": "recognised", "line": 35, "passages": 4, "surface": "contract", "title": "Entity page", "type": "screen", "typeLabel": "Screen" }, { "context": "…objects it gives access to, and the contract that describes it, which the contra…", "file": { "href": "../../../ingestion/typing/api/index.html", "label": "ingestion/typing/api.md" }, "href": "../../../ingestion/typing/api/index.html#L6", "kind": "recognised", "line": 6, "passages": 3, "surface": "contract", "title": "API", "type": "term", "typeLabel": "Term" }, { "context": "…act that describes it, which the contract import turns into operations. The page…", "file": { "href": "../../../ingestion/typing/api/index.html", "label": "ingestion/typing/api.md" }, "href": "../../../ingestion/typing/api/index.html#L6", "kind": "recognised", "line": 6, "passages": 3, "surface": "contract import", "title": "API", "type": "term", "typeLabel": "Term" }, { "context": "…objects it gives access to, and the contract that describes it, which the contra…", "file": { "href": "../../../ingestion/typing/api/index.html", "label": "ingestion/typing/api.md" }, "href": "../../../ingestion/typing/api/index.html#L6", "kind": "written", "line": 6, "passages": 3, "surface": "contract", "title": "API", "type": "term", "typeLabel": "Term" }, { "context": "… the same operation imported from a contract, or one note matches several operat…", "file": { "href": "../../../../specs/rules/contracts/ambiguous-operation/index.html", "label": "rules/contracts/ambiguous-operation.rule.md" }, "href": "../../../../specs/rules/contracts/ambiguous-operation/index.html#L7", "kind": "recognised", "line": 7, "passages": 3, "surface": "contract", "title": "Ambiguous operation", "type": "rule", "typeLabel": "Business rule" }, { "context": "…e entity with the properties of the contract only, and the other notes and opera…", "file": { "href": "../../../../specs/rules/contracts/ambiguous-operation/index.html", "label": "rules/contracts/ambiguous-operation.rule.md" }, "href": "../../../../specs/rules/contracts/ambiguous-operation/index.html#L7", "kind": "recognised", "line": 7, "passages": 3, "surface": "contract", "title": "Ambiguous operation", "type": "rule", "typeLabel": "Business rule" }, { "context": "…at names no API and matches several contracts of its source names its API in the…", "file": { "href": "../../../../specs/rules/contracts/ambiguous-operation/index.html", "label": "rules/contracts/ambiguous-operation.rule.md" }, "href": "../../../../specs/rules/contracts/ambiguous-operation/index.html#L7", "kind": "recognised", "line": 7, "passages": 3, "surface": "contracts", "title": "Ambiguous operation", "type": "rule", "typeLabel": "Business rule" }, { "context": "The contract an API note declares in its contract attribute, a URL or a path rel…", "file": { "href": "../../../../specs/rules/contracts/unreachable-contract/index.html", "label": "rules/contracts/unreachable-contract.rule.md" }, "href": "../../../../specs/rules/contracts/unreachable-contract/index.html#L7", "kind": "recognised", "line": 7, "passages": 3, "surface": "contract", "title": "Unreachable contract", "type": "rule", "typeLabel": "Business rule" }, { "context": "…tions until a later build reads the contract. A project whose contracts must be …", "file": { "href": "../../../../specs/rules/contracts/unreachable-contract/index.html", "label": "rules/contracts/unreachable-contract.rule.md" }, "href": "../../../../specs/rules/contracts/unreachable-contract/index.html#L7", "kind": "recognised", "line": 7, "passages": 3, "surface": "contract", "title": "Unreachable contract", "type": "rule", "typeLabel": "Business rule" }, { "context": "…reads the contract. A project whose contracts must be present raises the severit…", "file": { "href": "../../../../specs/rules/contracts/unreachable-contract/index.html", "label": "rules/contracts/unreachable-contract.rule.md" }, "href": "../../../../specs/rules/contracts/unreachable-contract/index.html#L7", "kind": "recognised", "line": 7, "passages": 3, "surface": "contracts", "title": "Unreachable contract", "type": "rule", "typeLabel": "Business rule" }, { "context": "… reading and conversion, typing, contract import, dictionary, scan, links, combi…", "file": { "href": "../../../ingestion/pipeline/pipeline/index.html", "label": "ingestion/pipeline/pipeline.md" }, "href": "../../../ingestion/pipeline/pipeline/index.html#L6", "kind": "recognised", "line": 6, "passages": 2, "surface": "contract import", "title": "Pipeline", "type": "term", "typeLabel": "Term" }, { "context": "… reading and conversion, typing, contract import, dictionary, scan, links, combi…", "file": { "href": "../../../ingestion/pipeline/pipeline/index.html", "label": "ingestion/pipeline/pipeline.md" }, "href": "../../../ingestion/pipeline/pipeline/index.html#L6", "kind": "written", "line": 6, "passages": 2, "surface": "contract import", "title": "Pipeline", "type": "term", "typeLabel": "Term" }, { "context": "…converted even when it moves, and a contract by the SHA-256 of its text. The clo…", "file": { "href": "../../../ingestion/sources/fingerprint-cache/index.html", "label": "ingestion/sources/fingerprint-cache.md" }, "href": "../../../ingestion/sources/fingerprint-cache/index.html#L6", "kind": "recognised", "line": 6, "passages": 2, "surface": "contract", "title": "Fingerprint cache", "type": "term", "typeLabel": "Term" }, { "context": "…converted even when it moves, and a contract by the SHA-256 of its text. The clo…", "file": { "href": "../../../ingestion/sources/fingerprint-cache/index.html", "label": "ingestion/sources/fingerprint-cache.md" }, "href": "../../../ingestion/sources/fingerprint-cache/index.html#L6", "kind": "written", "line": 6, "passages": 2, "surface": "contract", "title": "Fingerprint cache", "type": "term", "typeLabel": "Term" }, { "context": "… (a source of entities such as a contract import), inferenceMethods (a method th…", "file": { "href": "../../../quality/plugins/contribution-point/index.html", "label": "quality/plugins/contribution-point.md" }, "href": "../../../quality/plugins/contribution-point/index.html#L6", "kind": "recognised", "line": 6, "passages": 2, "surface": "contract import", "title": "Contribution point", "type": "term", "typeLabel": "Term" }, { "context": "… (a source of entities such as a contract import), inferenceMethods (a method th…", "file": { "href": "../../../quality/plugins/contribution-point/index.html", "label": "quality/plugins/contribution-point.md" }, "href": "../../../quality/plugins/contribution-point/index.html#L6", "kind": "written", "line": 6, "passages": 2, "surface": "contract import", "title": "Contribution point", "type": "term", "typeLabel": "Term" }, { "context": "…cross sources were resolved and the contracts imported; entities, one object per…", "file": { "href": "../../../../specs/api/canonical-model/index.html", "label": "api/canonical-model.md" }, "href": "../../../../specs/api/canonical-model/index.html#L9", "kind": "recognised", "line": 9, "passages": 2, "surface": "contracts", "title": "Canonical model", "type": "api", "typeLabel": "API" }, { "context": "…xpressions, the schemas of the imported contracts and the pairs of twin resource…", "file": { "href": "../../../../specs/api/canonical-model/index.html", "label": "api/canonical-model.md" }, "href": "../../../../specs/api/canonical-model/index.html#L9", "kind": "recognised", "line": 9, "passages": 2, "surface": "imported contracts", "title": "Canonical model", "type": "api", "typeLabel": "API" }, { "context": "…s, sources of entities such as contract importers, inference methods, checks, pr…", "file": { "href": "../../../../specs/api/plugin-api/index.html", "label": "api/plugin-api.md" }, "href": "../../../../specs/api/plugin-api/index.html#L9", "kind": "recognised", "line": 9, "passages": 2, "surface": "contract importers", "title": "Plugin API", "type": "api", "typeLabel": "API" }, { "context": "…e, which is a JSON schema and not a contract the build imports, so this note dec…", "file": { "href": "../../../../specs/api/plugin-api/index.html", "label": "api/plugin-api.md" }, "href": "../../../../specs/api/plugin-api/index.html#L9", "kind": "recognised", "line": 9, "passages": 2, "surface": "contract", "title": "Plugin API", "type": "api", "typeLabel": "API" }, { "context": "…produced from it, a transcript, the contract an operation was imported from. A n…", "file": { "href": "../../../../specs/objects/ingestion/representation/index.html", "label": "objects/ingestion/representation.md" }, "href": "../../../../specs/objects/ingestion/representation/index.html#L6", "kind": "recognised", "line": 6, "passages": 2, "surface": "contract", "title": "Representation", "type": "business_object", "typeLabel": "Business object" }, { "context": "…eration matched by a note lists the contract as a representation next to the not…", "file": { "href": "../../../../specs/objects/ingestion/representation/index.html", "label": "objects/ingestion/representation.md" }, "href": "../../../../specs/objects/ingestion/representation/index.html#L6", "kind": "recognised", "line": 6, "passages": 2, "surface": "contract", "title": "Representation", "type": "business_object", "typeLabel": "Business object" }, { "context": "… is built once per build, after typing and contract import, and before the scan.", "file": { "href": "../../recognition/dictionary/index.html", "label": "inference/recognition/dictionary.md" }, "href": "../../recognition/dictionary/index.html#L6", "kind": "recognised", "line": 6, "surface": "contract import", "title": "Dictionary", "type": "term", "typeLabel": "Term" }, { "context": "…produced from it, a transcript, the contract an operation was imported from. A n…", "file": { "href": "../../../ingestion/sources/representation/index.html", "label": "ingestion/sources/representation.md" }, "href": "../../../ingestion/sources/representation/index.html#L6", "kind": "recognised", "line": 6, "surface": "contract", "title": "Representation", "type": "term", "typeLabel": "Term" }, { "context": "…with a typed view model that is the contract between the build and a theme: Shel…", "file": { "href": "../../../publication/site/slot/index.html", "label": "publication/site/slot.md" }, "href": "../../../publication/site/slot/index.html#L6", "kind": "recognised", "line": 6, "surface": "contract", "title": "Slot", "type": "term", "typeLabel": "Term" }, { "context": "…ngs per severity and per check, the contracts imported) and every finding, sorte…", "file": { "href": "../../../quality/findings/build-log/index.html", "label": "quality/findings/build-log.md" }, "href": "../../../quality/findings/build-log/index.html#L6", "kind": "recognised", "line": 6, "surface": "contracts", "title": "Build log", "type": "term", "typeLabel": "Term" }, { "context": "… a source of entities such as a contract importer, an inference method, a check,…", "file": { "href": "../../../quality/plugins/plugin/index.html", "label": "quality/plugins/plugin.md" }, "href": "../../../quality/plugins/plugin/index.html#L6", "kind": "recognised", "line": 6, "surface": "contract importer", "title": "Plugin", "type": "term", "typeLabel": "Term" }, { "context": "…shows them. Declared by the OpenAPI contract of the model query API; nothing of …", "file": { "href": "../../../../specs/api/operations/get-entity/index.html", "label": "api/operations/get-entity.md" }, "href": "../../../../specs/api/operations/get-entity/index.html#L11", "kind": "recognised", "line": 11, "surface": "contract", "title": "Get an entity", "type": "endpoint", "typeLabel": "Operation" }, { "context": "…peration is declared by the OpenAPI contract of the model query API and exists n…", "file": { "href": "../../../../specs/api/operations/list-entities/index.html", "label": "api/operations/list-entities.md" }, "href": "../../../../specs/api/operations/list-entities/index.html#L11", "kind": "recognised", "line": 11, "surface": "contract", "title": "List the entities", "type": "endpoint", "typeLabel": "Operation" }, { "context": "…arch index. Declared by the OpenAPI contract of the model query API; the static …", "file": { "href": "../../../../specs/api/operations/search-model/index.html", "label": "api/operations/search-model.md" }, "href": "../../../../specs/api/operations/search-model/index.html#L11", "kind": "recognised", "line": 11, "surface": "contract", "title": "Search the model", "type": "endpoint", "typeLabel": "Operation" }, { "context": "…with a typed view model that is the contract between the generator and a theme; …", "file": { "href": "../../../../specs/decisions/publication/slots-islands-and-layers/index.html", "label": "decisions/publication/slots-islands-and-layers.md" }, "href": "../../../../specs/decisions/publication/slots-islands-and-layers/index.html#L8", "kind": "recognised", "line": 8, "surface": "contract", "title": "Slots, islands and layers", "type": "decision", "typeLabel": "Decision" }, { "context": "…lication threshold; a schema an imported contract names, offered as an object wi…", "file": { "href": "../../../../specs/objects/inference/candidate/index.html", "label": "objects/inference/candidate.md" }, "href": "../../../../specs/objects/inference/candidate/index.html#L6", "kind": "recognised", "line": 6, "surface": "imported contract", "title": "Candidate", "type": "business_object", "typeLabel": "Business object" }, { "context": "…e log carries the same figures, the contracts imported and every finding. The on…", "file": { "href": "../../../../specs/objects/ingestion/build/index.html", "label": "objects/ingestion/build.md" }, "href": "../../../../specs/objects/ingestion/build/index.html#L6", "kind": "recognised", "line": 6, "surface": "contracts", "title": "Build", "type": "business_object", "typeLabel": "Business object" }, { "context": "…ment, a slide deck, a transcript, a contract. A resource carries its path, commi…", "file": { "href": "../../../../specs/objects/ingestion/resource/index.html", "label": "objects/ingestion/resource.md" }, "href": "../../../../specs/objects/ingestion/resource/index.html#L6", "kind": "recognised", "line": 6, "surface": "contract", "title": "Resource", "type": "business_object", "typeLabel": "Business object" }, { "context": "…ever does. The release guide is the contract; the one decision that stays human …", "file": { "href": "../../../../specs/processes/quality/release/index.html", "label": "processes/quality/release.md" }, "href": "../../../../specs/processes/quality/release/index.html#L7", "kind": "recognised", "line": 7, "surface": "contract", "title": "Release", "type": "process", "typeLabel": "Process" }, { "context": "…arry no timecode, an API page whose contract could not be fetched, the states of…", "file": { "href": "../../../../specs/screens/pages/gallery-index/index.html", "label": "screens/pages/gallery-index.md" }, "href": "../../../../specs/screens/pages/gallery-index/index.html#L13", "kind": "recognised", "line": 13, "surface": "contract", "title": "Gallery index", "type": "screen", "typeLabel": "Screen" } ] }