@openhint/hintbook-data-analyst

The official HINT vocabulary for data & bi analysts. The assistant queries declared sources and columns only; it never invents data, columns, freshness, or metric definitions.

Measured performance and retrieval results live in the core benchmark report.

hint.yml
_.hint
sales/
├── _.hint
└── artifact.md.hint
warehouse/
└── _.hint
shared/policy.hint

Installation

hint add @openhint/hintbook-data-analyst
hint apply

Vocabulary

| Sources | table, column, grain, freshness, quality | | Semantics | metric, formula, dimension, filter, unit, caveat, owner | | Delivery | question, dashboard, report | | Shared core | never, source, term, assumption, risk, decision, openquestion, checklist, style, example, good, bad, read, res, notes |

Natural plurals and long forms are included as keyword synonyms; profession search synonyms are declared in keywords/hintbook.json. Full reference: docs/keywords.md.

Output and framing

| Command | Result | | --- | --- | | hint <path> | Scoped profession knowledge only. | | hint --prompt <path> | Role header, scoped knowledge, verification footer. | | hint --standalone <path> | Prompt plus the complete tag glossary. |

Verifiable surfaces: metric. These names are stable artifact identifiers and must appear verbatim.

Deterministic emit

The markdown pack emits reviewable analytics artifact structure without a model. A SQL pack emits reviewable view/check skeletons. Run hint emit <path> and gate CI with hint emit --check. Prose that templates cannot derive remains a marked hole.

Example

# table sales

Declared context for the analytics artifact.

# never Invented details

The assistant queries declared sources and columns only; it never invents data, columns, freshness, or metric definitions.

License

MIT