Skip to content

Commit 5f62d15

Browse files
docs(skills): spell the per-set lock without the reserved word
`check:role-word` (ADR-0090 D3) refused the new teaching's wording in `rules/security.md` and `SKILL.md`; the choice rule now says "permission set". The security.md ceiling row follows the landed count (2956). Claude-Session: https://claude.ai/code/session_01JQwxbakp4nDuCkULsj7Fyr Co-authored-by: Claude <noreply@anthropic.com>
1 parent 30ff9f4 commit 5f62d15

3 files changed

Lines changed: 9 additions & 9 deletions

File tree

‎scripts/check-skills-token-ratchet.mjs‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -552,16 +552,16 @@ export const CEILINGS = new Map([
552552
// 2026-10-24 (project decision list item 9), verbatim and untranslated, the
553553
// line for item 8 of the same message elided:
554554
// 「9. 技能文档 security.md 的 token 上限 2543 → 2563 … 同意」.
555-
// 2563 -> 2957 (#26179): the field permission row condition `when` — the
555+
// 2563 -> 2956 (#26179): the field permission row condition `when` — the
556556
// choice rule (a lock for everyone is a validation; a lock that depends on
557557
// who edits is `when` on that set's field entries), one example and the
558558
// four boundaries — which the file did not teach, so an author locked the
559-
// fields for every user. +396 tokens on a landed 2561, 2 absorbed by
560-
// headroom, ceiling +394. The file carries no duplicated passage to cut
559+
// fields for every user. +395 tokens on a landed 2561, 2 absorbed by
560+
// headroom, ceiling +393. The file carries no duplicated passage to cut
561561
// first (measured: no sentence repeats in the file). Maintainer ruling
562562
// 2026-10-27 on the decision card 「skills 修复卡的教学和 eval 都撞 token 天
563563
// 花板,怎么付?」, tap A, verbatim and untranslated: 「A:先削重复,余额按实测提高」.
564-
['skills/objectstack-data/rules/security.md', 2957],
564+
['skills/objectstack-data/rules/security.md', 2956],
565565
// 3024 -> 3109 (2026-08-31 app-repo-principles raise, see the block above).
566566
// Severity Levels listed the three values and left the CHOICE unstated: a
567567
// block rests on a judgement a person made, so a machine-inferred signal — a

‎skills/objectstack-data/SKILL.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -218,8 +218,8 @@ export const Invoice = ObjectSchema.create({
218218

219219
- Use `visibleWhen` to hide irrelevant fields in ObjectUI forms.
220220
- Use `readonlyWhen` for state-locked fields; the ObjectQL write path ignores
221-
incoming changes when the predicate is `TRUE` (for everyone; per role →
222-
field permission `when`, rules/security.md).
221+
incoming changes when the predicate is `TRUE` (for everyone; per permission
222+
set → field permission `when`, rules/security.md).
223223
- **`readonly: true` governs the end-user surface, not trusted system writers.**
224224
A non-system write (REST/UI, and any `runAs:'user'` flow — the default) has
225225
the field **stripped** from any non-system write; the write reports

‎skills/objectstack-data/rules/security.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -124,8 +124,8 @@ A set's `fields` entry (`'OBJECT.FIELD': { readable, editable }`) may carry
124124

125125
- Locked for **everyone** at that stage → a [validation rule](./validation.md)
126126
on the object (`readonlyWhen` likewise strips the write for everyone).
127-
- Locked for **some roles** only → `when` on the field entries of each set
128-
that loses the edit; the other sets keep their grant.
127+
- Locked for **some permission sets** only → `when` on the field entries of
128+
each set that loses the edit; the other sets keep their grant.
129129

130130
```typescript
131131
// finance may not change the contract's legal terms after approval
@@ -137,7 +137,7 @@ fields: {
137137
- **Edit vote only.** Reads are row-blind; `readable: false` beside `when` is
138138
refused at parse time.
139139
- **Same object.** Fields of the entry's object vs a literal or `current_user.*`;
140-
no relation reach (refused at `os validate` / publish, never dropped).
140+
no relation reach (refused at `os validate` / publish).
141141
- **Pre-image.** An update is judged on the stored row, so a write cannot unlock
142142
itself by moving `status` back; an insert on the row as sent.
143143
- **Locks, never grants.** On unmatched rows the entry is absent; another held

0 commit comments

Comments
 (0)