docs(spec): state the measured dependsOn spelling facts in the option-description docblock#15055

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
zhuangjianguo merged 4 commits into from
Sep 3, 2026
+17 −10
Merged

docs(spec): state the measured dependsOn spelling facts in the option-description docblock #15055

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
9300bca
docs(spec): state the measured dependsOn spelling facts in the option…
claude Sep 3, 2026
5a1e6e9
docs(spec): align the option-shape comments with the 2026-09-02 casca…
claude Sep 3, 2026
e302c17
docs(permissions): re-anchor the system-context census citation after…
claude Sep 3, 2026
daf2fd3
Merge remote-tracking branch 'origin/main' into claude/issue-13916-op…
claude Sep 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion content/docs/permissions/system-context.mdx
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -196,7 +196,7 @@ assuming `isSystem` covers it is a documented source of bugs.
| "It suppresses triggers / record-change automation" | **No.** Only `skipTriggers` does. A bare `{ isSystem: true }` on a seed write re-fired automation on freshly seeded rows and wedged first boot | `metadata-protocol/src/seed-loader.ts:1971` (rationale at `:1881`–`1883`, #3760), `flow.zod.ts:702` |
| "It skips the state machine" | **No.** That is `skipStateMachine`, carried by seed replay and by `treatAsHistorical` imports | `objectql/src/engine.ts` FSM gate; see [State Machine](/docs/protocol/objectql/state-machine) |
| "It skips validation rules" | **No.** Field shape, `format`, `script` and the rest still run. The `readonly` strip runs *before* validation precisely so a discarded value is not judged | `objectql/src/engine.ts:10008`–`10025` |
| "It preserves a supplied `updated_at` / `updated_by`" | **No.** That is `preserveAudit`, a separate opt-in — and an UPDATE-path exemption only | `field.zod.ts:1537` (#3493 / #6640) |
| "It preserves a supplied `updated_at` / `updated_by`" | **No.** That is `preserveAudit`, a separate opt-in — and an UPDATE-path exemption only | `field.zod.ts:1540` (#3493 / #6640) |
| "It stamps `created_by`" | **No.** Audit stamping reads `userId` from the context. A user-less system write stamps nothing — that is today's behaviour, not an error | `runtime-identity.ts:280`–`281` |
| "It bypasses every guard" | **No.** The last-admin guard applies to **every** context, `isSystem` included — the deprovision path that actually locks an org out is the system one | `last-admin-guard.ts:299` |
| "A client can request it" | **No.** Never settable from inbound HTTP or from an action body | `rest-server.ts:1520`, `:1549`; `domains/actions.ts:404` |
Expand Down
16 changes: 10 additions & 6 deletions packages/spec/src/data/field-rows-option-description.test.ts
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -21,8 +21,10 @@
* `recordToOption` produces the same key for fetched options — while
* `SelectOptionSchema` refused it. The object-definition authoring form has
* offered a `description` input all along; the declaration makes the offer
* honest. Per the same inherited ruling, `dependsOn` is deliberately NOT
* declared (the canonical `depends_on` already exists at the field level).
* honest. Per the same inherited ruling the option shape declares
* `description` and no cascade key of its own; the cascade key lives on
* `FieldSchema` as the camelCase `dependsOn`, which objectui mirrors
* (maintainer ruling 2026-09-02 on objectui#6153).
*
* The ruling's capability expansion STOPS at these keys: the four inert
* rich-text editor keys (`toolbar`/`preview`/`minHeight`/`maxHeight`) stay
Expand DownExpand Up@@ -200,10 +202,12 @@ describe('SelectOptionSchema accepts `description` (objectui#6153, inherited rul
// this shape by #5016's option C, and #13671 re-measured that reading for
// the FIELD-option surface and kept it (section 3). It stays an
// unrecognized_keys refusal until someone rules otherwise — what #13671
// changed is the OFFER, not this door. `dependsOn`: the inherited #6153
// ruling resolves it objectui-side (the widget reads the canonical
// field-level `depends_on`); declaring a camelCase twin here is
// explicitly not licensed.
// changed is the OFFER, not this door. `dependsOn`: this option shape
// carries no cascade key of its own, per the inherited #6140 / #6153
// ruling. The cascade key is `FieldSchema`'s camelCase `dependsOn`,
// which refuses the snake_case `depends_on` with a rename hint, and
// objectui mirrors that spelling (maintainer ruling 2026-09-02 on
// objectui#6153).
for (const [key, value] of [['icon', 'circle-dot'], ['dependsOn', 'country']] as const) {
const result = SelectOptionSchema.safeParse({ label: 'Open', value: 'open', [key]: value });
expect(result.success, `\`${key}\` unexpectedly parsed — an unruled accepted-set expansion`).toBe(false);
Expand Down
9 changes: 6 additions & 3 deletions packages/spec/src/data/field.zod.ts
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -279,9 +279,12 @@ export const SelectOptionSchema = lazySchema(() => strictObject({
* author could legally write. The object-definition authoring form
* (`object.form.ts` options repeater) has offered a `description` input all
* along; this declaration is what makes that offer honest. Per the same
* inherited ruling, `dependsOn` is NOT declared here — the canonical
* spelling `depends_on` already exists at the field level, and a camelCase
* twin would be a second spelling for a declared concept.
* inherited ruling this option shape declares `description` and no cascade
* key of its own — `field-rows-option-description.test.ts` pins that
* refusal. The cascade key this package declares is the camelCase
* `dependsOn`, the `FieldSchema` member below; objectui mirrors that
* spelling on its own metadata type (maintainer ruling 2026-09-02 on
* objectui#6153).
*/
description: z.string().optional().describe('Optional secondary/help text for this option. Lookup option search matches it in addition to the label; renderers may show it as supporting text.'),
color: z.string().optional().describe('Color code for badges/charts'),
Expand Down
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
docs(spec): state the measured dependsOn spelling facts in the option-description docblock#15055

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

zhuangjianguo
merged 4 commits into

from

Sep 3, 2026

+17

−10

 Merged


docs(spec): state the measured dependsOn spelling facts in the option-description docblock
#15055
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


4 commits


Select commit
Hold shift + click to select a range
9300bca

docs(spec): state the measured dependsOn spelling facts in the option…


claude Sep 3, 2026
5a1e6e9

docs(spec): align the option-shape comments with the 2026-09-02 casca…


claude Sep 3, 2026
e302c17

docs(permissions): re-anchor the system-context census citation after…


claude Sep 3, 2026
daf2fd3

Merge remote-tracking branch 'origin/main' into claude/issue-13916-op…


claude Sep 3, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


2 changes: 1 addition & 1 deletion
content/docs/permissions/system-context.mdx

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -196,7 +196,7 @@ assuming `isSystem` covers it is a documented source of bugs.
| "It suppresses triggers / record-change automation" | **No.** Only `skipTriggers` does. A bare `{ isSystem: true }` on a seed write re-fired automation on freshly seeded rows and wedged first boot | `metadata-protocol/src/seed-loader.ts:1971` (rationale at `:1881`–`1883`, #3760), `flow.zod.ts:702` |
| "It skips the state machine" | **No.** That is `skipStateMachine`, carried by seed replay and by `treatAsHistorical` imports | `objectql/src/engine.ts` FSM gate; see [State Machine](/docs/protocol/objectql/state-machine) |
| "It skips validation rules" | **No.** Field shape, `format`, `script` and the rest still run. The `readonly` strip runs *before* validation precisely so a discarded value is not judged | `objectql/src/engine.ts:10008`–`10025` |
| "It preserves a supplied `updated_at` / `updated_by`" | **No.** That is `preserveAudit`, a separate opt-in — and an UPDATE-path exemption only | `field.zod.ts:1537` (#3493 / #6640) |
| "It preserves a supplied `updated_at` / `updated_by`" | **No.** That is `preserveAudit`, a separate opt-in — and an UPDATE-path exemption only | `field.zod.ts:1540` (#3493 / #6640) |
| "It stamps `created_by`" | **No.** Audit stamping reads `userId` from the context. A user-less system write stamps nothing — that is today's behaviour, not an error | `runtime-identity.ts:280`–`281` |
| "It bypasses every guard" | **No.** The last-admin guard applies to **every** context, `isSystem` included — the deprovision path that actually locks an org out is the system one | `last-admin-guard.ts:299` |
| "A client can request it" | **No.** Never settable from inbound HTTP or from an action body | `rest-server.ts:1520`, `:1549`; `domains/actions.ts:404` |
Expand Down

16 changes: 10 additions & 6 deletions
packages/spec/src/data/field-rows-option-description.test.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -21,8 +21,10 @@
 * `recordToOption` produces the same key for fetched options — while
 * `SelectOptionSchema` refused it. The object-definition authoring form has
 * offered a `description` input all along; the declaration makes the offer
 * honest. Per the same inherited ruling, `dependsOn` is deliberately NOT
 * declared (the canonical `depends_on` already exists at the field level).
 * honest. Per the same inherited ruling the option shape declares
 * `description` and no cascade key of its own; the cascade key lives on
 * `FieldSchema` as the camelCase `dependsOn`, which objectui mirrors
 * (maintainer ruling 2026-09-02 on objectui#6153).
 *
 * The ruling's capability expansion STOPS at these keys: the four inert
 * rich-text editor keys (`toolbar`/`preview`/`minHeight`/`maxHeight`) stay
Expand DownExpand Up@@ -200,10 +202,12 @@ describe('SelectOptionSchema accepts `description` (objectui#6153, inherited rul
 // this shape by #5016's option C, and #13671 re-measured that reading for
 // the FIELD-option surface and kept it (section 3). It stays an
 // unrecognized_keys refusal until someone rules otherwise — what #13671
 // changed is the OFFER, not this door. `dependsOn`: the inherited #6153
 // ruling resolves it objectui-side (the widget reads the canonical
 // field-level `depends_on`); declaring a camelCase twin here is
 // explicitly not licensed.
 // changed is the OFFER, not this door. `dependsOn`: this option shape
 // carries no cascade key of its own, per the inherited #6140 / #6153
 // ruling. The cascade key is `FieldSchema`'s camelCase `dependsOn`,
 // which refuses the snake_case `depends_on` with a rename hint, and
 // objectui mirrors that spelling (maintainer ruling 2026-09-02 on
 // objectui#6153).
 for (const [key, value] of [['icon', 'circle-dot'], ['dependsOn', 'country']] as const) {
 const result = SelectOptionSchema.safeParse({ label: 'Open', value: 'open', [key]: value });
 expect(result.success, `\`${key}\` unexpectedly parsed — an unruled accepted-set expansion`).toBe(false);
Expand Down

9 changes: 6 additions & 3 deletions
packages/spec/src/data/field.zod.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -279,9 +279,12 @@ export const SelectOptionSchema = lazySchema(() => strictObject({
 * author could legally write. The object-definition authoring form
 * (`object.form.ts` options repeater) has offered a `description` input all
 * along; this declaration is what makes that offer honest. Per the same
 * inherited ruling, `dependsOn` is NOT declared here — the canonical
 * spelling `depends_on` already exists at the field level, and a camelCase
 * twin would be a second spelling for a declared concept.
 * inherited ruling this option shape declares `description` and no cascade
 * key of its own — `field-rows-option-description.test.ts` pins that
 * refusal. The cascade key this package declares is the camelCase
 * `dependsOn`, the `FieldSchema` member below; objectui mirrors that
 * spelling on its own metadata type (maintainer ruling 2026-09-02 on
 * objectui#6153).
 */
 description: z.string().optional().describe('Optional secondary/help text for this option. Lookup option search matches it in addition to the label; renderers may show it as supporting text.'),
 color: z.string().optional().describe('Color code for badges/charts'),
Expand Down
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
docs(spec): state the measured dependsOn spelling facts in the option-description docblock#15055

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

zhuangjianguo
merged 4 commits into

from

Sep 3, 2026

+17

−10

 Merged


docs(spec): state the measured dependsOn spelling facts in the option-description docblock
#15055
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


4 commits


Select commit
Hold shift + click to select a range
9300bca

docs(spec): state the measured dependsOn spelling facts in the option…


claude Sep 3, 2026
5a1e6e9

docs(spec): align the option-shape comments with the 2026-09-02 casca…


claude Sep 3, 2026
e302c17

docs(permissions): re-anchor the system-context census citation after…


claude Sep 3, 2026
daf2fd3

Merge remote-tracking branch 'origin/main' into claude/issue-13916-op…


claude Sep 3, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


2 changes: 1 addition & 1 deletion
content/docs/permissions/system-context.mdx

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -196,7 +196,7 @@ assuming `isSystem` covers it is a documented source of bugs.
| "It suppresses triggers / record-change automation" | **No.** Only `skipTriggers` does. A bare `{ isSystem: true }` on a seed write re-fired automation on freshly seeded rows and wedged first boot | `metadata-protocol/src/seed-loader.ts:1971` (rationale at `:1881`–`1883`, #3760), `flow.zod.ts:702` |
| "It skips the state machine" | **No.** That is `skipStateMachine`, carried by seed replay and by `treatAsHistorical` imports | `objectql/src/engine.ts` FSM gate; see [State Machine](/docs/protocol/objectql/state-machine) |
| "It skips validation rules" | **No.** Field shape, `format`, `script` and the rest still run. The `readonly` strip runs *before* validation precisely so a discarded value is not judged | `objectql/src/engine.ts:10008`–`10025` |
| "It preserves a supplied `updated_at` / `updated_by`" | **No.** That is `preserveAudit`, a separate opt-in — and an UPDATE-path exemption only | `field.zod.ts:1537` (#3493 / #6640) |
| "It preserves a supplied `updated_at` / `updated_by`" | **No.** That is `preserveAudit`, a separate opt-in — and an UPDATE-path exemption only | `field.zod.ts:1540` (#3493 / #6640) |
| "It stamps `created_by`" | **No.** Audit stamping reads `userId` from the context. A user-less system write stamps nothing — that is today's behaviour, not an error | `runtime-identity.ts:280`–`281` |
| "It bypasses every guard" | **No.** The last-admin guard applies to **every** context, `isSystem` included — the deprovision path that actually locks an org out is the system one | `last-admin-guard.ts:299` |
| "A client can request it" | **No.** Never settable from inbound HTTP or from an action body | `rest-server.ts:1520`, `:1549`; `domains/actions.ts:404` |
Expand Down

16 changes: 10 additions & 6 deletions
packages/spec/src/data/field-rows-option-description.test.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -21,8 +21,10 @@
 * `recordToOption` produces the same key for fetched options — while
 * `SelectOptionSchema` refused it. The object-definition authoring form has
 * offered a `description` input all along; the declaration makes the offer
 * honest. Per the same inherited ruling, `dependsOn` is deliberately NOT
 * declared (the canonical `depends_on` already exists at the field level).
 * honest. Per the same inherited ruling the option shape declares
 * `description` and no cascade key of its own; the cascade key lives on
 * `FieldSchema` as the camelCase `dependsOn`, which objectui mirrors
 * (maintainer ruling 2026-09-02 on objectui#6153).
 *
 * The ruling's capability expansion STOPS at these keys: the four inert
 * rich-text editor keys (`toolbar`/`preview`/`minHeight`/`maxHeight`) stay
Expand DownExpand Up@@ -200,10 +202,12 @@ describe('SelectOptionSchema accepts `description` (objectui#6153, inherited rul
 // this shape by #5016's option C, and #13671 re-measured that reading for
 // the FIELD-option surface and kept it (section 3). It stays an
 // unrecognized_keys refusal until someone rules otherwise — what #13671
 // changed is the OFFER, not this door. `dependsOn`: the inherited #6153
 // ruling resolves it objectui-side (the widget reads the canonical
 // field-level `depends_on`); declaring a camelCase twin here is
 // explicitly not licensed.
 // changed is the OFFER, not this door. `dependsOn`: this option shape
 // carries no cascade key of its own, per the inherited #6140 / #6153
 // ruling. The cascade key is `FieldSchema`'s camelCase `dependsOn`,
 // which refuses the snake_case `depends_on` with a rename hint, and
 // objectui mirrors that spelling (maintainer ruling 2026-09-02 on
 // objectui#6153).
 for (const [key, value] of [['icon', 'circle-dot'], ['dependsOn', 'country']] as const) {
 const result = SelectOptionSchema.safeParse({ label: 'Open', value: 'open', [key]: value });
 expect(result.success, `\`${key}\` unexpectedly parsed — an unruled accepted-set expansion`).toBe(false);
Expand Down

9 changes: 6 additions & 3 deletions
packages/spec/src/data/field.zod.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -279,9 +279,12 @@ export const SelectOptionSchema = lazySchema(() => strictObject({
 * author could legally write. The object-definition authoring form
 * (`object.form.ts` options repeater) has offered a `description` input all
 * along; this declaration is what makes that offer honest. Per the same
 * inherited ruling, `dependsOn` is NOT declared here — the canonical
 * spelling `depends_on` already exists at the field level, and a camelCase
 * twin would be a second spelling for a declared concept.
 * inherited ruling this option shape declares `description` and no cascade
 * key of its own — `field-rows-option-description.test.ts` pins that
 * refusal. The cascade key this package declares is the camelCase
 * `dependsOn`, the `FieldSchema` member below; objectui mirrors that
 * spelling on its own metadata type (maintainer ruling 2026-09-02 on
 * objectui#6153).
 */
 description: z.string().optional().describe('Optional secondary/help text for this option. Lookup option search matches it in addition to the label; renderers may show it as supporting text.'),
 color: z.string().optional().describe('Color code for badges/charts'),
Expand Down
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
docs(spec): state the measured dependsOn spelling facts in the option-description docblock#15055

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

zhuangjianguo
merged 4 commits into

from

Sep 3, 2026

+17

−10

 Merged


docs(spec): state the measured dependsOn spelling facts in the option-description docblock
#15055
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


4 commits


Select commit
Hold shift + click to select a range
9300bca

docs(spec): state the measured dependsOn spelling facts in the option…


claude Sep 3, 2026
5a1e6e9

docs(spec): align the option-shape comments with the 2026-09-02 casca…


claude Sep 3, 2026
e302c17

docs(permissions): re-anchor the system-context census citation after…


claude Sep 3, 2026
daf2fd3

Merge remote-tracking branch 'origin/main' into claude/issue-13916-op…


claude Sep 3, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


2 changes: 1 addition & 1 deletion
content/docs/permissions/system-context.mdx

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -196,7 +196,7 @@ assuming `isSystem` covers it is a documented source of bugs.
| "It suppresses triggers / record-change automation" | **No.** Only `skipTriggers` does. A bare `{ isSystem: true }` on a seed write re-fired automation on freshly seeded rows and wedged first boot | `metadata-protocol/src/seed-loader.ts:1971` (rationale at `:1881`–`1883`, #3760), `flow.zod.ts:702` |
| "It skips the state machine" | **No.** That is `skipStateMachine`, carried by seed replay and by `treatAsHistorical` imports | `objectql/src/engine.ts` FSM gate; see [State Machine](/docs/protocol/objectql/state-machine) |
| "It skips validation rules" | **No.** Field shape, `format`, `script` and the rest still run. The `readonly` strip runs *before* validation precisely so a discarded value is not judged | `objectql/src/engine.ts:10008`–`10025` |
| "It preserves a supplied `updated_at` / `updated_by`" | **No.** That is `preserveAudit`, a separate opt-in — and an UPDATE-path exemption only | `field.zod.ts:1537` (#3493 / #6640) |
| "It preserves a supplied `updated_at` / `updated_by`" | **No.** That is `preserveAudit`, a separate opt-in — and an UPDATE-path exemption only | `field.zod.ts:1540` (#3493 / #6640) |
| "It stamps `created_by`" | **No.** Audit stamping reads `userId` from the context. A user-less system write stamps nothing — that is today's behaviour, not an error | `runtime-identity.ts:280`–`281` |
| "It bypasses every guard" | **No.** The last-admin guard applies to **every** context, `isSystem` included — the deprovision path that actually locks an org out is the system one | `last-admin-guard.ts:299` |
| "A client can request it" | **No.** Never settable from inbound HTTP or from an action body | `rest-server.ts:1520`, `:1549`; `domains/actions.ts:404` |
Expand Down

16 changes: 10 additions & 6 deletions
packages/spec/src/data/field-rows-option-description.test.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -21,8 +21,10 @@
 * `recordToOption` produces the same key for fetched options — while
 * `SelectOptionSchema` refused it. The object-definition authoring form has
 * offered a `description` input all along; the declaration makes the offer
 * honest. Per the same inherited ruling, `dependsOn` is deliberately NOT
 * declared (the canonical `depends_on` already exists at the field level).
 * honest. Per the same inherited ruling the option shape declares
 * `description` and no cascade key of its own; the cascade key lives on
 * `FieldSchema` as the camelCase `dependsOn`, which objectui mirrors
 * (maintainer ruling 2026-09-02 on objectui#6153).
 *
 * The ruling's capability expansion STOPS at these keys: the four inert
 * rich-text editor keys (`toolbar`/`preview`/`minHeight`/`maxHeight`) stay
Expand DownExpand Up@@ -200,10 +202,12 @@ describe('SelectOptionSchema accepts `description` (objectui#6153, inherited rul
 // this shape by #5016's option C, and #13671 re-measured that reading for
 // the FIELD-option surface and kept it (section 3). It stays an
 // unrecognized_keys refusal until someone rules otherwise — what #13671
 // changed is the OFFER, not this door. `dependsOn`: the inherited #6153
 // ruling resolves it objectui-side (the widget reads the canonical
 // field-level `depends_on`); declaring a camelCase twin here is
 // explicitly not licensed.
 // changed is the OFFER, not this door. `dependsOn`: this option shape
 // carries no cascade key of its own, per the inherited #6140 / #6153
 // ruling. The cascade key is `FieldSchema`'s camelCase `dependsOn`,
 // which refuses the snake_case `depends_on` with a rename hint, and
 // objectui mirrors that spelling (maintainer ruling 2026-09-02 on
 // objectui#6153).
 for (const [key, value] of [['icon', 'circle-dot'], ['dependsOn', 'country']] as const) {
 const result = SelectOptionSchema.safeParse({ label: 'Open', value: 'open', [key]: value });
 expect(result.success, `\`${key}\` unexpectedly parsed — an unruled accepted-set expansion`).toBe(false);
Expand Down

9 changes: 6 additions & 3 deletions
packages/spec/src/data/field.zod.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -279,9 +279,12 @@ export const SelectOptionSchema = lazySchema(() => strictObject({
 * author could legally write. The object-definition authoring form
 * (`object.form.ts` options repeater) has offered a `description` input all
 * along; this declaration is what makes that offer honest. Per the same
 * inherited ruling, `dependsOn` is NOT declared here — the canonical
 * spelling `depends_on` already exists at the field level, and a camelCase
 * twin would be a second spelling for a declared concept.
 * inherited ruling this option shape declares `description` and no cascade
 * key of its own — `field-rows-option-description.test.ts` pins that
 * refusal. The cascade key this package declares is the camelCase
 * `dependsOn`, the `FieldSchema` member below; objectui mirrors that
 * spelling on its own metadata type (maintainer ruling 2026-09-02 on
 * objectui#6153).
 */
 description: z.string().optional().describe('Optional secondary/help text for this option. Lookup option search matches it in addition to the label; renderers may show it as supporting text.'),
 color: z.string().optional().describe('Color code for badges/charts'),
Expand Down
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
docs(spec): state the measured dependsOn spelling facts in the option-description docblock#15055

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

zhuangjianguo
merged 4 commits into

from

Sep 3, 2026

+17

−10

 Merged


docs(spec): state the measured dependsOn spelling facts in the option-description docblock
#15055
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


4 commits


Select commit
Hold shift + click to select a range
9300bca

docs(spec): state the measured dependsOn spelling facts in the option…


claude Sep 3, 2026
5a1e6e9

docs(spec): align the option-shape comments with the 2026-09-02 casca…


claude Sep 3, 2026
e302c17

docs(permissions): re-anchor the system-context census citation after…


claude Sep 3, 2026
daf2fd3

Merge remote-tracking branch 'origin/main' into claude/issue-13916-op…


claude Sep 3, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


2 changes: 1 addition & 1 deletion
content/docs/permissions/system-context.mdx

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -196,7 +196,7 @@ assuming `isSystem` covers it is a documented source of bugs.
| "It suppresses triggers / record-change automation" | **No.** Only `skipTriggers` does. A bare `{ isSystem: true }` on a seed write re-fired automation on freshly seeded rows and wedged first boot | `metadata-protocol/src/seed-loader.ts:1971` (rationale at `:1881`–`1883`, #3760), `flow.zod.ts:702` |
| "It skips the state machine" | **No.** That is `skipStateMachine`, carried by seed replay and by `treatAsHistorical` imports | `objectql/src/engine.ts` FSM gate; see [State Machine](/docs/protocol/objectql/state-machine) |
| "It skips validation rules" | **No.** Field shape, `format`, `script` and the rest still run. The `readonly` strip runs *before* validation precisely so a discarded value is not judged | `objectql/src/engine.ts:10008`–`10025` |
| "It preserves a supplied `updated_at` / `updated_by`" | **No.** That is `preserveAudit`, a separate opt-in — and an UPDATE-path exemption only | `field.zod.ts:1537` (#3493 / #6640) |
| "It preserves a supplied `updated_at` / `updated_by`" | **No.** That is `preserveAudit`, a separate opt-in — and an UPDATE-path exemption only | `field.zod.ts:1540` (#3493 / #6640) |
| "It stamps `created_by`" | **No.** Audit stamping reads `userId` from the context. A user-less system write stamps nothing — that is today's behaviour, not an error | `runtime-identity.ts:280`–`281` |
| "It bypasses every guard" | **No.** The last-admin guard applies to **every** context, `isSystem` included — the deprovision path that actually locks an org out is the system one | `last-admin-guard.ts:299` |
| "A client can request it" | **No.** Never settable from inbound HTTP or from an action body | `rest-server.ts:1520`, `:1549`; `domains/actions.ts:404` |
Expand Down

16 changes: 10 additions & 6 deletions
packages/spec/src/data/field-rows-option-description.test.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -21,8 +21,10 @@
 * `recordToOption` produces the same key for fetched options — while
 * `SelectOptionSchema` refused it. The object-definition authoring form has
 * offered a `description` input all along; the declaration makes the offer
 * honest. Per the same inherited ruling, `dependsOn` is deliberately NOT
 * declared (the canonical `depends_on` already exists at the field level).
 * honest. Per the same inherited ruling the option shape declares
 * `description` and no cascade key of its own; the cascade key lives on
 * `FieldSchema` as the camelCase `dependsOn`, which objectui mirrors
 * (maintainer ruling 2026-09-02 on objectui#6153).
 *
 * The ruling's capability expansion STOPS at these keys: the four inert
 * rich-text editor keys (`toolbar`/`preview`/`minHeight`/`maxHeight`) stay
Expand DownExpand Up@@ -200,10 +202,12 @@ describe('SelectOptionSchema accepts `description` (objectui#6153, inherited rul
 // this shape by #5016's option C, and #13671 re-measured that reading for
 // the FIELD-option surface and kept it (section 3). It stays an
 // unrecognized_keys refusal until someone rules otherwise — what #13671
 // changed is the OFFER, not this door. `dependsOn`: the inherited #6153
 // ruling resolves it objectui-side (the widget reads the canonical
 // field-level `depends_on`); declaring a camelCase twin here is
 // explicitly not licensed.
 // changed is the OFFER, not this door. `dependsOn`: this option shape
 // carries no cascade key of its own, per the inherited #6140 / #6153
 // ruling. The cascade key is `FieldSchema`'s camelCase `dependsOn`,
 // which refuses the snake_case `depends_on` with a rename hint, and
 // objectui mirrors that spelling (maintainer ruling 2026-09-02 on
 // objectui#6153).
 for (const [key, value] of [['icon', 'circle-dot'], ['dependsOn', 'country']] as const) {
 const result = SelectOptionSchema.safeParse({ label: 'Open', value: 'open', [key]: value });
 expect(result.success, `\`${key}\` unexpectedly parsed — an unruled accepted-set expansion`).toBe(false);
Expand Down

9 changes: 6 additions & 3 deletions
packages/spec/src/data/field.zod.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -279,9 +279,12 @@ export const SelectOptionSchema = lazySchema(() => strictObject({
 * author could legally write. The object-definition authoring form
 * (`object.form.ts` options repeater) has offered a `description` input all
 * along; this declaration is what makes that offer honest. Per the same
 * inherited ruling, `dependsOn` is NOT declared here — the canonical
 * spelling `depends_on` already exists at the field level, and a camelCase
 * twin would be a second spelling for a declared concept.
 * inherited ruling this option shape declares `description` and no cascade
 * key of its own — `field-rows-option-description.test.ts` pins that
 * refusal. The cascade key this package declares is the camelCase
 * `dependsOn`, the `FieldSchema` member below; objectui mirrors that
 * spelling on its own metadata type (maintainer ruling 2026-09-02 on
 * objectui#6153).
 */
 description: z.string().optional().describe('Optional secondary/help text for this option. Lookup option search matches it in addition to the label; renderers may show it as supporting text.'),
 color: z.string().optional().describe('Color code for badges/charts'),
Expand Down
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
docs(spec): state the measured dependsOn spelling facts in the option-description docblock#15055

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

zhuangjianguo
merged 4 commits into

from

Sep 3, 2026

+17

−10

 Merged


docs(spec): state the measured dependsOn spelling facts in the option-description docblock
#15055
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


4 commits


Select commit
Hold shift + click to select a range
9300bca

docs(spec): state the measured dependsOn spelling facts in the option…


claude Sep 3, 2026
5a1e6e9

docs(spec): align the option-shape comments with the 2026-09-02 casca…


claude Sep 3, 2026
e302c17

docs(permissions): re-anchor the system-context census citation after…


claude Sep 3, 2026
daf2fd3

Merge remote-tracking branch 'origin/main' into claude/issue-13916-op…


claude Sep 3, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


2 changes: 1 addition & 1 deletion
content/docs/permissions/system-context.mdx

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -196,7 +196,7 @@ assuming `isSystem` covers it is a documented source of bugs.
| "It suppresses triggers / record-change automation" | **No.** Only `skipTriggers` does. A bare `{ isSystem: true }` on a seed write re-fired automation on freshly seeded rows and wedged first boot | `metadata-protocol/src/seed-loader.ts:1971` (rationale at `:1881`–`1883`, #3760), `flow.zod.ts:702` |
| "It skips the state machine" | **No.** That is `skipStateMachine`, carried by seed replay and by `treatAsHistorical` imports | `objectql/src/engine.ts` FSM gate; see [State Machine](/docs/protocol/objectql/state-machine) |
| "It skips validation rules" | **No.** Field shape, `format`, `script` and the rest still run. The `readonly` strip runs *before* validation precisely so a discarded value is not judged | `objectql/src/engine.ts:10008`–`10025` |
| "It preserves a supplied `updated_at` / `updated_by`" | **No.** That is `preserveAudit`, a separate opt-in — and an UPDATE-path exemption only | `field.zod.ts:1537` (#3493 / #6640) |
| "It preserves a supplied `updated_at` / `updated_by`" | **No.** That is `preserveAudit`, a separate opt-in — and an UPDATE-path exemption only | `field.zod.ts:1540` (#3493 / #6640) |
| "It stamps `created_by`" | **No.** Audit stamping reads `userId` from the context. A user-less system write stamps nothing — that is today's behaviour, not an error | `runtime-identity.ts:280`–`281` |
| "It bypasses every guard" | **No.** The last-admin guard applies to **every** context, `isSystem` included — the deprovision path that actually locks an org out is the system one | `last-admin-guard.ts:299` |
| "A client can request it" | **No.** Never settable from inbound HTTP or from an action body | `rest-server.ts:1520`, `:1549`; `domains/actions.ts:404` |
Expand Down

16 changes: 10 additions & 6 deletions
packages/spec/src/data/field-rows-option-description.test.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -21,8 +21,10 @@
 * `recordToOption` produces the same key for fetched options — while
 * `SelectOptionSchema` refused it. The object-definition authoring form has
 * offered a `description` input all along; the declaration makes the offer
 * honest. Per the same inherited ruling, `dependsOn` is deliberately NOT
 * declared (the canonical `depends_on` already exists at the field level).
 * honest. Per the same inherited ruling the option shape declares
 * `description` and no cascade key of its own; the cascade key lives on
 * `FieldSchema` as the camelCase `dependsOn`, which objectui mirrors
 * (maintainer ruling 2026-09-02 on objectui#6153).
 *
 * The ruling's capability expansion STOPS at these keys: the four inert
 * rich-text editor keys (`toolbar`/`preview`/`minHeight`/`maxHeight`) stay
Expand DownExpand Up@@ -200,10 +202,12 @@ describe('SelectOptionSchema accepts `description` (objectui#6153, inherited rul
 // this shape by #5016's option C, and #13671 re-measured that reading for
 // the FIELD-option surface and kept it (section 3). It stays an
 // unrecognized_keys refusal until someone rules otherwise — what #13671
 // changed is the OFFER, not this door. `dependsOn`: the inherited #6153
 // ruling resolves it objectui-side (the widget reads the canonical
 // field-level `depends_on`); declaring a camelCase twin here is
 // explicitly not licensed.
 // changed is the OFFER, not this door. `dependsOn`: this option shape
 // carries no cascade key of its own, per the inherited #6140 / #6153
 // ruling. The cascade key is `FieldSchema`'s camelCase `dependsOn`,
 // which refuses the snake_case `depends_on` with a rename hint, and
 // objectui mirrors that spelling (maintainer ruling 2026-09-02 on
 // objectui#6153).
 for (const [key, value] of [['icon', 'circle-dot'], ['dependsOn', 'country']] as const) {
 const result = SelectOptionSchema.safeParse({ label: 'Open', value: 'open', [key]: value });
 expect(result.success, `\`${key}\` unexpectedly parsed — an unruled accepted-set expansion`).toBe(false);
Expand Down

9 changes: 6 additions & 3 deletions
packages/spec/src/data/field.zod.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -279,9 +279,12 @@ export const SelectOptionSchema = lazySchema(() => strictObject({
 * author could legally write. The object-definition authoring form
 * (`object.form.ts` options repeater) has offered a `description` input all
 * along; this declaration is what makes that offer honest. Per the same
 * inherited ruling, `dependsOn` is NOT declared here — the canonical
 * spelling `depends_on` already exists at the field level, and a camelCase
 * twin would be a second spelling for a declared concept.
 * inherited ruling this option shape declares `description` and no cascade
 * key of its own — `field-rows-option-description.test.ts` pins that
 * refusal. The cascade key this package declares is the camelCase
 * `dependsOn`, the `FieldSchema` member below; objectui mirrors that
 * spelling on its own metadata type (maintainer ruling 2026-09-02 on
 * objectui#6153).
 */
 description: z.string().optional().describe('Optional secondary/help text for this option. Lookup option search matches it in addition to the label; renderers may show it as supporting text.'),
 color: z.string().optional().describe('Color code for badges/charts'),
Expand Down
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
docs(spec): state the measured dependsOn spelling facts in the option-description docblock#15055

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

zhuangjianguo
merged 4 commits into

from

Sep 3, 2026

+17

−10

 Merged


docs(spec): state the measured dependsOn spelling facts in the option-description docblock
#15055
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


4 commits


Select commit
Hold shift + click to select a range
9300bca

docs(spec): state the measured dependsOn spelling facts in the option…


claude Sep 3, 2026
5a1e6e9

docs(spec): align the option-shape comments with the 2026-09-02 casca…


claude Sep 3, 2026
e302c17

docs(permissions): re-anchor the system-context census citation after…


claude Sep 3, 2026
daf2fd3

Merge remote-tracking branch 'origin/main' into claude/issue-13916-op…


claude Sep 3, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


2 changes: 1 addition & 1 deletion
content/docs/permissions/system-context.mdx

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -196,7 +196,7 @@ assuming `isSystem` covers it is a documented source of bugs.
| "It suppresses triggers / record-change automation" | **No.** Only `skipTriggers` does. A bare `{ isSystem: true }` on a seed write re-fired automation on freshly seeded rows and wedged first boot | `metadata-protocol/src/seed-loader.ts:1971` (rationale at `:1881`–`1883`, #3760), `flow.zod.ts:702` |
| "It skips the state machine" | **No.** That is `skipStateMachine`, carried by seed replay and by `treatAsHistorical` imports | `objectql/src/engine.ts` FSM gate; see [State Machine](/docs/protocol/objectql/state-machine) |
| "It skips validation rules" | **No.** Field shape, `format`, `script` and the rest still run. The `readonly` strip runs *before* validation precisely so a discarded value is not judged | `objectql/src/engine.ts:10008`–`10025` |
| "It preserves a supplied `updated_at` / `updated_by`" | **No.** That is `preserveAudit`, a separate opt-in — and an UPDATE-path exemption only | `field.zod.ts:1537` (#3493 / #6640) |
| "It preserves a supplied `updated_at` / `updated_by`" | **No.** That is `preserveAudit`, a separate opt-in — and an UPDATE-path exemption only | `field.zod.ts:1540` (#3493 / #6640) |
| "It stamps `created_by`" | **No.** Audit stamping reads `userId` from the context. A user-less system write stamps nothing — that is today's behaviour, not an error | `runtime-identity.ts:280`–`281` |
| "It bypasses every guard" | **No.** The last-admin guard applies to **every** context, `isSystem` included — the deprovision path that actually locks an org out is the system one | `last-admin-guard.ts:299` |
| "A client can request it" | **No.** Never settable from inbound HTTP or from an action body | `rest-server.ts:1520`, `:1549`; `domains/actions.ts:404` |
Expand Down

16 changes: 10 additions & 6 deletions
packages/spec/src/data/field-rows-option-description.test.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -21,8 +21,10 @@
 * `recordToOption` produces the same key for fetched options — while
 * `SelectOptionSchema` refused it. The object-definition authoring form has
 * offered a `description` input all along; the declaration makes the offer
 * honest. Per the same inherited ruling, `dependsOn` is deliberately NOT
 * declared (the canonical `depends_on` already exists at the field level).
 * honest. Per the same inherited ruling the option shape declares
 * `description` and no cascade key of its own; the cascade key lives on
 * `FieldSchema` as the camelCase `dependsOn`, which objectui mirrors
 * (maintainer ruling 2026-09-02 on objectui#6153).
 *
 * The ruling's capability expansion STOPS at these keys: the four inert
 * rich-text editor keys (`toolbar`/`preview`/`minHeight`/`maxHeight`) stay
Expand DownExpand Up@@ -200,10 +202,12 @@ describe('SelectOptionSchema accepts `description` (objectui#6153, inherited rul
 // this shape by #5016's option C, and #13671 re-measured that reading for
 // the FIELD-option surface and kept it (section 3). It stays an
 // unrecognized_keys refusal until someone rules otherwise — what #13671
 // changed is the OFFER, not this door. `dependsOn`: the inherited #6153
 // ruling resolves it objectui-side (the widget reads the canonical
 // field-level `depends_on`); declaring a camelCase twin here is
 // explicitly not licensed.
 // changed is the OFFER, not this door. `dependsOn`: this option shape
 // carries no cascade key of its own, per the inherited #6140 / #6153
 // ruling. The cascade key is `FieldSchema`'s camelCase `dependsOn`,
 // which refuses the snake_case `depends_on` with a rename hint, and
 // objectui mirrors that spelling (maintainer ruling 2026-09-02 on
 // objectui#6153).
 for (const [key, value] of [['icon', 'circle-dot'], ['dependsOn', 'country']] as const) {
 const result = SelectOptionSchema.safeParse({ label: 'Open', value: 'open', [key]: value });
 expect(result.success, `\`${key}\` unexpectedly parsed — an unruled accepted-set expansion`).toBe(false);
Expand Down

9 changes: 6 additions & 3 deletions
packages/spec/src/data/field.zod.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -279,9 +279,12 @@ export const SelectOptionSchema = lazySchema(() => strictObject({
 * author could legally write. The object-definition authoring form
 * (`object.form.ts` options repeater) has offered a `description` input all
 * along; this declaration is what makes that offer honest. Per the same
 * inherited ruling, `dependsOn` is NOT declared here — the canonical
 * spelling `depends_on` already exists at the field level, and a camelCase
 * twin would be a second spelling for a declared concept.
 * inherited ruling this option shape declares `description` and no cascade
 * key of its own — `field-rows-option-description.test.ts` pins that
 * refusal. The cascade key this package declares is the camelCase
 * `dependsOn`, the `FieldSchema` member below; objectui mirrors that
 * spelling on its own metadata type (maintainer ruling 2026-09-02 on
 * objectui#6153).
 */
 description: z.string().optional().describe('Optional secondary/help text for this option. Lookup option search matches it in addition to the label; renderers may show it as supporting text.'),
 color: z.string().optional().describe('Color code for badges/charts'),
Expand Down
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
docs(spec): state the measured dependsOn spelling facts in the option-description docblock#15055

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

zhuangjianguo
merged 4 commits into

from

Sep 3, 2026

+17

−10

 Merged


docs(spec): state the measured dependsOn spelling facts in the option-description docblock
#15055
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


4 commits


Select commit
Hold shift + click to select a range
9300bca

docs(spec): state the measured dependsOn spelling facts in the option…


claude Sep 3, 2026
5a1e6e9

docs(spec): align the option-shape comments with the 2026-09-02 casca…


claude Sep 3, 2026
e302c17

docs(permissions): re-anchor the system-context census citation after…


claude Sep 3, 2026
daf2fd3

Merge remote-tracking branch 'origin/main' into claude/issue-13916-op…


claude Sep 3, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


2 changes: 1 addition & 1 deletion
content/docs/permissions/system-context.mdx

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -196,7 +196,7 @@ assuming `isSystem` covers it is a documented source of bugs.
| "It suppresses triggers / record-change automation" | **No.** Only `skipTriggers` does. A bare `{ isSystem: true }` on a seed write re-fired automation on freshly seeded rows and wedged first boot | `metadata-protocol/src/seed-loader.ts:1971` (rationale at `:1881`–`1883`, #3760), `flow.zod.ts:702` |
| "It skips the state machine" | **No.** That is `skipStateMachine`, carried by seed replay and by `treatAsHistorical` imports | `objectql/src/engine.ts` FSM gate; see [State Machine](/docs/protocol/objectql/state-machine) |
| "It skips validation rules" | **No.** Field shape, `format`, `script` and the rest still run. The `readonly` strip runs *before* validation precisely so a discarded value is not judged | `objectql/src/engine.ts:10008`–`10025` |
| "It preserves a supplied `updated_at` / `updated_by`" | **No.** That is `preserveAudit`, a separate opt-in — and an UPDATE-path exemption only | `field.zod.ts:1537` (#3493 / #6640) |
| "It preserves a supplied `updated_at` / `updated_by`" | **No.** That is `preserveAudit`, a separate opt-in — and an UPDATE-path exemption only | `field.zod.ts:1540` (#3493 / #6640) |
| "It stamps `created_by`" | **No.** Audit stamping reads `userId` from the context. A user-less system write stamps nothing — that is today's behaviour, not an error | `runtime-identity.ts:280`–`281` |
| "It bypasses every guard" | **No.** The last-admin guard applies to **every** context, `isSystem` included — the deprovision path that actually locks an org out is the system one | `last-admin-guard.ts:299` |
| "A client can request it" | **No.** Never settable from inbound HTTP or from an action body | `rest-server.ts:1520`, `:1549`; `domains/actions.ts:404` |
Expand Down

16 changes: 10 additions & 6 deletions
packages/spec/src/data/field-rows-option-description.test.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -21,8 +21,10 @@
 * `recordToOption` produces the same key for fetched options — while
 * `SelectOptionSchema` refused it. The object-definition authoring form has
 * offered a `description` input all along; the declaration makes the offer
 * honest. Per the same inherited ruling, `dependsOn` is deliberately NOT
 * declared (the canonical `depends_on` already exists at the field level).
 * honest. Per the same inherited ruling the option shape declares
 * `description` and no cascade key of its own; the cascade key lives on
 * `FieldSchema` as the camelCase `dependsOn`, which objectui mirrors
 * (maintainer ruling 2026-09-02 on objectui#6153).
 *
 * The ruling's capability expansion STOPS at these keys: the four inert
 * rich-text editor keys (`toolbar`/`preview`/`minHeight`/`maxHeight`) stay
Expand DownExpand Up@@ -200,10 +202,12 @@ describe('SelectOptionSchema accepts `description` (objectui#6153, inherited rul
 // this shape by #5016's option C, and #13671 re-measured that reading for
 // the FIELD-option surface and kept it (section 3). It stays an
 // unrecognized_keys refusal until someone rules otherwise — what #13671
 // changed is the OFFER, not this door. `dependsOn`: the inherited #6153
 // ruling resolves it objectui-side (the widget reads the canonical
 // field-level `depends_on`); declaring a camelCase twin here is
 // explicitly not licensed.
 // changed is the OFFER, not this door. `dependsOn`: this option shape
 // carries no cascade key of its own, per the inherited #6140 / #6153
 // ruling. The cascade key is `FieldSchema`'s camelCase `dependsOn`,
 // which refuses the snake_case `depends_on` with a rename hint, and
 // objectui mirrors that spelling (maintainer ruling 2026-09-02 on
 // objectui#6153).
 for (const [key, value] of [['icon', 'circle-dot'], ['dependsOn', 'country']] as const) {
 const result = SelectOptionSchema.safeParse({ label: 'Open', value: 'open', [key]: value });
 expect(result.success, `\`${key}\` unexpectedly parsed — an unruled accepted-set expansion`).toBe(false);
Expand Down

9 changes: 6 additions & 3 deletions
packages/spec/src/data/field.zod.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -279,9 +279,12 @@ export const SelectOptionSchema = lazySchema(() => strictObject({
 * author could legally write. The object-definition authoring form
 * (`object.form.ts` options repeater) has offered a `description` input all
 * along; this declaration is what makes that offer honest. Per the same
 * inherited ruling, `dependsOn` is NOT declared here — the canonical
 * spelling `depends_on` already exists at the field level, and a camelCase
 * twin would be a second spelling for a declared concept.
 * inherited ruling this option shape declares `description` and no cascade
 * key of its own — `field-rows-option-description.test.ts` pins that
 * refusal. The cascade key this package declares is the camelCase
 * `dependsOn`, the `FieldSchema` member below; objectui mirrors that
 * spelling on its own metadata type (maintainer ruling 2026-09-02 on
 * objectui#6153).
 */
 description: z.string().optional().describe('Optional secondary/help text for this option. Lookup option search matches it in addition to the label; renderers may show it as supporting text.'),
 color: z.string().optional().describe('Color code for badges/charts'),
Expand Down
Loading