open-standards/aac/vocab/LEXICON.md
David Charlot a5152bc0c8
All checks were successful
no-vanity-metrics / Scan committed Markdown for vanity metrics (push) Successful in 4s
standards workspaces build + test / eoc-rs (push) Successful in 1m54s
standards workspaces build + test / jouleclaw-rs (push) Successful in 2m2s
standards workspaces build + test / aac-rs (push) Successful in 58s
standards workspaces build + test / jcp-rs (push) Successful in 1m20s
standards workspaces build + test / arl-rs (push) Successful in 3m21s
standards workspaces build + test / joule-code-rs (push) Successful in 42s
standards workspaces build + test / joulecontract-rs (push) Successful in 33s
standards workspaces build + test / proof-rs (push) Successful in 1m13s
standards workspaces build + test / map-rs (push) Successful in 29s
standards workspaces build + test / mesh-rs (push) Successful in 25s
standards workspaces build + test / joule-ui-rs (push) Successful in 2m28s
standards workspaces build + test / openpay (push) Successful in 1m13s
standards workspaces build + test / sandbox-rs (push) Successful in 2m8s
standards workspaces build + test / jouledesk-rs (push) Successful in 2m32s
standards workspaces build + test / smart-byte-rs (push) Successful in 2m27s
standards workspaces build + test / joulehook-rs (push) Successful in 2m15s
standards workspaces build + test / sense-rs (push) Successful in 2m36s
standards workspaces build + test / macOS energy backend (jcp-energy) (push) Successful in 2m21s
spec(aac): 0.2.0 — language honesty, and timing that belongs to the person
- §4.1 Language honesty: every language states how its core vocabulary was
  obtained (CoreStatus); an absent status reads as GlossOnly; glosses are never
  presented as a language's core. Withdraws the claim that one ~400-word core
  covers ~80% of every language.
- §5.1 Timing belongs to the person: scan rate and dwell are theirs to set;
  automatic adaptation is off unless they opt in; changes are proposed, never
  silent.
- §5.2 Scan-rate floor: max(⌊100·M/65⌋, P95), from at least 10 responses.
  The previous reference set 80% of the mean press, so the highlight had
  usually moved on when the person pressed.
- §5.3 Dwell proposals go both ways, with floors, replacing "should adapt to
  fatigue" (the old reference only ever lengthened the dwell).
- §10 adds C5–C7; §11 says access and vocabulary choices are never a
  prerequisite for starting.
- spec/access_model.md, the lexicon and the ontology agree (new CoreStatus
  class and individuals; scanRateMs, dwellMs, adaptationOptIn; Turtle, SHACL
  and JSON-LD validated with rdflib). New aac-rs/README.md covers testing,
  the static build, and hosting Express under another site.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-09-28 16:26:17 -04:00

29 lines
3.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# AAC lexicon (v1)
The controlled vocabulary of the AAC standard. Terms are stable; their IRIs live in [`v1.ttl`](v1.ttl) under `https://aac.transaction.science/vocab/v1#`.
| Term | Meaning |
|------|---------|
| **Utterance** | The cargo AAC carries: what a non-speaking person means to say, composed by selecting cells. |
| **Board** | A communication surface holding cells, of a given board type. The portable unit a voice travels as. |
| **Board type** | `Grid` \| `VisualScene` \| `Keyboard` \| `Hybrid` \| `QuickAccess`. A rendering + vocabulary-strategy marker. |
| **Cell** | A single selectable target at a fixed grid position, with content and an action. |
| **Position** | `(row, col)`, 0-indexed. Assigned once and **immutable** for the life of the cell — the motor invariant. |
| **Motor stability** | The guarantee that cell positions never move except by explicit edit. Muscle memory is sacred. |
| **Cell content** | `Symbol{id,label}` \| `Text` \| `Photo{ref,label}` \| `Blank`. `Blank` is an addressable reservation of geometry. |
| **Cell action** | What activation does: `Speak` \| `Navigate` \| `Modifier` \| `Backspace` \| `Clear` \| `Predict` \| `SpeakAll` \| `Buffer`. |
| **Symbol** | A pictographic word referenced by source and id — not embedded pixels — so a board stays small and portable. |
| **Access method** | The physical channel of selection: `DirectTouch` \| `EyeGaze` \| `HeadTracking` \| `SwitchScan{n}` \| `Joystick` \| `Bci` \| `PartialVoice` \| `Pointer`. |
| **Motor profile** | The user's physical capabilities (fine motor, sustained press, tremor, target size, reach, side) used to adapt targets and timing. |
| **Scan mode** | The switch-scanning pattern: `Linear` \| `RowColumn` \| `Group` \| `Block` \| inverse. |
| **Dwell** | Selection by sustained gaze, with visible progress feedback and a dwell time the person sets. |
| **Timing proposal** | A change of scan rate or dwell time that a client computes from the person's own responses and offers; it takes effect only when they accept it, or automatically if they opted in. Timing never changes silently. |
| **Core status** | How a language's core vocabulary was obtained: `ValidatedNativeCorpus` (studied in the language) \| `StakeholderValidated` (rated by its speakers) \| `PrimesOnly` (provisional seed) \| `GlossOnly` (glosses of another language's core). Absent means `GlossOnly`. |
| **Vocabulary level** | `Emergent` \| `Transitional` \| `Conventional` \| `Literate` — the user's stage, which selects the prediction tier. |
| **Cascade** | `L0:Cache → L1:Symbol → L2:LocalPredict → … → L9:AdaptiveModel`. The lowest level that closes a request wins. |
| **Offline invariant** | Exactly L0–L2 are offline-capable and carry 95%+ of communication; a network drop never silences a user. |
| **Free invariant** | No cascade level is gated behind payment at the protocol layer. A voice is not a metered good. |
| **Interchange** | Canonical export + one-directional ingest of existing boards. What goes in comes out; no lock-in. |
| **Receipt** | The per-operation energy record (`measured + estimated` µJ, provenance-tagged) — shown for transparency, **never** billed. |
| **Provenance** | `HwShunt` (hardware-measured) \| `ModelBased` (calibrated model) \| `Estimator` (constant). The honesty tag on every reading. |
| **Steward** | Transaction Science: publishes the spec, ships the reference, runs optional services (symbol libraries, voice banking, team coordination). Not the owner — AAC carries no token. |