Docs / The model / Grounding

Grounding.

The grounding of one subject, a captured page, an entity, a text or an address: its mentions resolved and its relations suggested as hypotheses a person settles; staged when the subject is given, waiting for a person once the hypotheses are made, committed when every one is settled; the same work on every face

Figure 1Groundingspecified

Grounding is a work at follows scope. The drawing shows its fields and the objects that they point at.

kind: work
scope: follows
key: the subject and the breadth
store: postgres
family: sources

Fields#

field	type	required	note
`subject`	`one of a capture \| an entity \| a text \| an address`	yes	what was grounded
`capture`	`hash`	no	the artefact’s hash, for a capture or an address the record holds a capture of
`text`	`text`	no	the text grounded, cut to 4,000 characters, for a text
`address`	`text`	yes	the page’s address, the entity’s own page, or empty for a text
`platform`	`text`	yes
`breadth`	`one of exact \| similar \| related \| broad`	yes
`entity`	`id`	no	the entity the page became
`hypotheses`	`[id]`	yes
`mentions`	`[id]`	yes
`channels`	`[text]`	yes	the channels that ran: exact keys, names, meaning, thread, neighbourhood
`candidates`	`count`	yes
`made_at`	`time`	yes
`settled_at`	`time`	no
`settled_by`	Caller	no

Routes that use it#

No route takes or returns Grounding directly. The record holds it, and the objects that point at it reach it.