@gram 2
doc portal-reference-records-guide
t Records and fields
d Current record types, field multiplicity and stable identifiers.
view document
::rich
# Records and fields

## Current type vocabulary

The current grammar names these record types: knowledge (`K`), decision (`D`), evidence (`E`), context (`C`), history (`H`), goal (`G`), task (`T`), blocker (`B`), requirement (`R`), risk (`X`), assumption (`A`), metric (`M`), event (`V`), artifact (`F`), person (`P`), agent (`AG`), project (`PR`), system (`SYS`), service (`SVC`), component (`CMP`), source (`SRC`), run (`RUN`), asset (`ASSET`), and relation (`REL`). These identifiers describe data; they do not impose workflow or access policy.

## Fields

Use `t` for the one-line title; `d` for description; `x` for status; `p` for priority; `owner` for responsibility; repeatable `tag` and `source` values for classification/provenance; and `ref` for a URI or asset path. Metric records use literal `value`, `unit`, and optional `observed`. Task records may use `due`; event records may use `at`. Dates and quantities remain source strings.

Common statuses include open, active, blocked, completed, accepted and superseded. New status text is retained rather than silently mapped. A task checklist is still task records with status; there is no separate checkbox syntax.

## IDs and references

Every record has a unique stable ID within its document, distinct from the document ID. Renaming a title does not change that identity. A local link target is a same-document ID; `document-id/entity-id` addresses a record in another document.

## Valid example

```text
@gram 2
doc launch-notes
t Launch notes
T review
t Review the export
x active
d Compare the regenerated file with the source artifact.
M export-count
t Exported records
value 14
unit records
observed 2026-10-12T09:00:00Z
```

The number, date, and status in this example remain literal field values. Core parses and preserves them; the consuming view decides how to display recognized forms.
::end

SRC format-language
t .gram language specification
ref https://github.com/clab-one/thegram-format/blob/main/spec/language.md
SRC format-rich
t Current rich document specification
ref https://github.com/clab-one/thegram-format/blob/main/spec/rich-document.md
SRC format-history6
t Current History/6 specification
ref https://github.com/clab-one/thegram-format/blob/main/spec/source-history-render.md

@gram-history 6
@rev 0 2026-10-12T13:11:21.823Z - 43c8d00dcdce40d4455c012c79459aea784b8d757ef8b660cafa70b3189fd06a
@rev 1 2026-10-12T13:11:21.823Z portal-reference-contracts agent=developer-doc-generator req=portal-reference-records-guide-3e5a41213ae3a228dd29dc99 dig=e6ca095e1724bc35 kind=SourceImported e51a7d0cd238d3db18a7df5f0f396426ff376904a0e0826c65380615dbe8f8f7
@@ 42 1 0
@@ 44 0 2
t .gram language specification

@@ 45 1 0
@@ 47 0 1
t Current History/6 specification
@rev 2 2026-10-12T13:39:13.076Z portal-reference-finalize agent=developer-doc-generator req=portal-reference-records-guide-dbd5a0ee261d9f5b8e45c78d dig=014c175dd4d2feaf kind=SourceImported 1d43cfa1f95b146bf9969f9d073f7deb5dab06881b8076dde048843b2cdec446
@@ 4 2 1
::body
@@ 45 3 0