550431571c448a5ee4e9e3b565d91ee58d329ae8-PR-114
86%
main: 87%

Ran 04 May 2026 10:54PM UTC

Jobs 1

Files 19

Run time 1min

Badge

Embed ▾

Committed 04 May 2026 10:53PM UTC coverage: 86.064% (-0.07%) from 86.134%

Build # 550431571c448a5ee4e9e3b565d91ee58d329ae8-PR-114

Build Type

Pull #114

github

Committed by

QMalcolm

Commit Message

docs(claude): distinguish domain vs. structural vocabulary in boundary rule

The old rule — "never hardcode concept IDs, type IDs, or field names" —
was correct for domain vocabulary (system-specific names like "fireball"
or "character_level") but was being applied too broadly to structural
vocabulary: the keys the library itself defines to interpret concept
metadata (e.g. "required_count", "preparation_mode", "always_prepared").

This caused two problems:
1. Structural keys were treated as if they should come from config,
   leading to thin indirection layers (mode_field, cap_field, etc.)
   that add failure modes without adding real flexibility.
2. The library accumulated ~20 metadata keys it silently depends on
   without documenting or validating them, because the rule implied
   owning those names was a violation.

The revised rule splits the boundary into two categories and adds a
concrete heuristic: if no realistic second rule system would need a
different value for this name, it is structural vocabulary and the
library owns it. This makes the obligation to document and validate
structural keys explicit, rather than treating them as a grey area.

Pull Request Pull Request #114: docs(claude): distinguish domain vs. structural vocabulary in boundary rule

Coverage Stats

1229 of 1428 relevant lines covered (86.06%)

9931.14 hits per line

Coverage Regressions

Lines	Coverage	∆	File
1	85.71	-4.76%	apps/ttrpg_dev_cli/lib/cli/concept_display.ex

Jobs

ID	Job ID	Ran	Files	Coverage
1	550431571c448a5ee4e9e3b565d91ee58d329ae8-PR-114.1	04 May 2026 10:54PM UTC	19	86.06	GitHub Action Run

TTRPG-Dev / ex_ttrpg_dev / 550431571c448a5ee4e9e3b565d91ee58d329ae8-PR-114
86%
main: 87%

README BADGES
x

Markdown

Textile

RDoc

HTML

Rst

Coverage Regressions

Jobs

Source Files on build 550431571c448a5ee4e9e3b565d91ee58d329ae8-PR-114

TTRPG-Dev / ex_ttrpg_dev / 550431571c448a5ee4e9e3b565d91ee58d329ae8-PR-114 86% main: 87%

README BADGES x

Markdown

Textile

RDoc

HTML

Rst

Coverage Regressions

Jobs

Source Files on build 550431571c448a5ee4e9e3b565d91ee58d329ae8-PR-114

TTRPG-Dev / ex_ttrpg_dev / 550431571c448a5ee4e9e3b565d91ee58d329ae8-PR-114
86%
main: 87%

README BADGES
x