Skip to content

Commit 29741ec

Browse files
committed
docs: name the ADR-0085 pointers by field, not by the reserved word (#4409)
The role-word ratchet (ADR-0090 D3) counts occurrences per file, and two doc lines describing `validateSemanticRoles` reintroduced the banned word for a non-permission concept. Name what the rule actually checks instead: `stageField` / `highlightFields` pointers. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Sz61GE1CWCSnGW4qShSEXs
1 parent c14caaa commit 29741ec

2 files changed

Lines changed: 4 additions & 3 deletions

File tree

content/docs/deployment/cli.mdx

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -452,8 +452,9 @@ stopping at the first, so one pass shows the whole hole.
452452
- Missing `manifest.namespace` (required for multi-app hosting)
453453
- No objects defined
454454
- No apps or plugins defined
455-
- Every advisory the rule registry raised (dangling semantic-role pointers,
456-
replay-unsafe seeds, ambiguous flow status, deprecated visibility aliases, …)
455+
- Every advisory the rule registry raised (dangling `stageField` /
456+
`highlightFields` pointers, replay-unsafe seeds, ambiguous flow status,
457+
deprecated visibility aliases, …)
457458

458459
<Callout type="tip">
459460
`os validate`, `os build` and `os lint` share one rule registry, so a config that

content/docs/deployment/validating-metadata.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -346,7 +346,7 @@ author-time rules, from one table — `AUTHORING_RULES` in
346346
| Autonumber `{field}` interpolation ||||
347347
| View references — form targets, view-key collisions (#2554) ||||
348348
| Flow authoring anti-patterns (#1874) ||||
349-
| Advisory: flow trigger wiring, record titles, semantic roles, seed replay/state safety, capability references, liveness, visibility aliases ||||
349+
| Advisory: flow trigger wiring, record titles, semantic field pointers (ADR-0085), seed replay/state safety, capability references, liveness, visibility aliases ||||
350350
| Package docs — flatness, prefixes, links (ADR-0046) ||||
351351
| Undeclared authoring keys — every metadata collection (#3786) and the stack's own top-level keys (#4167) ||||
352352
| Naming, labels, data-model conventions, i18n coverage ||||

0 commit comments

Comments
 (0)