Skip to content

Commit 4fba503

Browse files
os-warrenclaude
andauthored
docs(spec): state the publish/install bound on Seed.locale (#19698)
Fixes #17011 Clause-②: no Three wording edits, their regenerated reference pages, and a changeset. ⛔ No code behaviour change on any path. ## The card's title is the thing NOT to implement The card says `Seed.locale` is silently inert on three publish/install paths. The director seat ruled that premise **false** — one-class self-adjudication, comment 5615361502, option **A — 不扩散** — and ordered a correction to the wording, not to the wiring. Quoted verbatim rather than translated: > 今天已是「有边界的声明 + 运行时点名警告」,不是静默失效 … `content/docs/data-modeling/seed-data.mdx:226` 已白纸黑字声明这三条路装全部数据并警告 ⇒ 无违约、非缺陷 and 「无代码行为变更、无 changeset 破坏性条目」. ## The three edits **1. `packages/spec/src/data/seed.zod.ts` — `SeedSchema.locale`.** The `.describe()` now reads: > Applicable locales (BCP-47 tags); omitted applies to every locale. The publish and install paths do not filter by locale — they load every dataset and warn Its TSDoc gains a paragraph naming the bound, why it is the contract rather than an unfinished path, and the ruling. **2. `content/docs/data-modeling/seed-data.mdx`.** The warn callout that already declared this behaviour for the embedding-host case gains a paragraph naming the three paths explicitly and citing the ruling. **3. `packages/spec/liveness/seed.json`.** The `locale` row's note ended 「Filed as its own card」. It now cites the ruling, records that what was owed was wording and not wiring, and states the one reading that would reopen it. Plus `content/docs/references/**` — four pages regenerated by `pnpm --filter @objectstack/spec gen:docs`. Auto-generated, not hand-edited; the whole diff is that one describe line in the four pages that embed `SeedSchema`. ⚠️ **A line-number drift worth recording, not a missing target.** Triage and the dispatch both anchor the docs paragraph at `:226`. At this branch's base that line is the *info* callout; the warn callout carrying the quoted text is at `:234`. The quoted text matches verbatim, so the anchor is the text and the target is present — the number moved by 8 lines since the triage reading at `ae19f5e`. ## The ruling's load-bearing premise was re-derived, not inherited The ruling rests on one measurement: zero real seed data using `locale` repo-wide. Re-derived here with an independent instrument, anchored to `1f53b0b685`, reach **this repo, whole tree**: - **Structural.** A balanced-paren scan of every `defineSeed(...)` call site: **49 sites across 9 files**. The `examples/` apps hold **24** of them — real first-party seed data — and **none declares `locale`**. The scan is **self-lit**: the same pass does find the two `locale`-declaring call sites on the docs page, so the zero is a reading and not a dead instrument. - **Textual, both axes, one probe shape.** An array-literal probe finds `locale` in **7** files and the sibling axis `env` in **35**. None of the 7 is seed data: the #16595 changeset, the docs page that teaches the key, the loader, the producer, two test files and the liveness ledger. - **Non-`defineSeed` authoring surfaces.** Zero seed-shaped JSON/YAML artifacts in the tree, zero YAML `locale:` sequences. The single `locale` token inside `examples/app-showcase/src/data/seed/index.ts` is a comment about pinyin search recall at `:111`, not a scope key — and that same unscoped dataset deliberately mixes a CJK-named account in with English ones. ⇒ the premise reproduces, so the three edits proceed. ⚠️ **The ruling's own confidence gap stayed open and is not claimed otherwise.** cloud, hotcrm and external customer apps are out of reach from this repo; they were **not measured** here. A measured use of `locale`-scoped seed data in any of them reopens the decision. ⚠️ **One qualification on the control, reported because it reads differently than the thread implies.** The `env` control is lit — the probe does reach authored seed declarations, which is exactly what triage claimed for it. But `env`'s footprint is tests and docs: of the same 24 real `examples/` datasets, **zero** declare `env` either. So the control proves the instrument works; it does not show a sibling axis in heavy first-party use. This strengthens option A rather than weakening it, and it is not a contradiction of the ruling — only of a wider reading someone might take from "23 files". ## ⛔ Deliberately not done - ⛔ The three call sites still pass no `locale`. That is option B; it was not ruled. It would give one concept two sources of truth and would silently stop loading a dataset that loads today. - ⛔ `warnOnUnresolvedLocaleScope` is untouched and still warns. Turning it into a refusal is option C; also not ruled — 「在零使用下买不到安全,只买到一次破坏性变更」. - ⛔ Reconciling rows already written under a different locale is #16596 and is not addressed here. - ⛔ No label, assignee, ready-flip, auto-merge or enqueue from this branch; `content/docs/releases/` untouched. ## Changeset — measured, not assumed `npm pack --dry-run --json` on `packages/spec`, 277 files in the tarball, with controls in both directions: | path | ships? | |---|---| | `packages/spec/src/data/seed.zod.ts` | **yes** — `src/**/*.zod.ts` | | `packages/spec/liveness/seed.json` | **yes** — `liveness` | | `content/docs/data-modeling/seed-data.mdx` | no — not inside any package | | `packages/spec/src/data/seed.test.ts` (negative control) | no — filter is real | | `packages/spec/src/data/seed-loader.zod.ts` (positive control) | yes — the glob is live | ⇒ this PR **does publish**, so a `patch` changeset for `@objectstack/spec` is owed and included. `skip-changeset` would be wrong here. Not breaking, so no ADR-0087 marker is owed. ## Verification Run against `@objectstack/spec`, exit codes captured before any pipe. | what | verdict | |---|---| | `pnpm --filter @objectstack/spec build` | `command-exit 0` | | `pnpm --filter @objectstack/spec test` | `command-exit 0` — 513 files, 14973 passed, 1 todo | | `pnpm --filter @objectstack/spec typecheck` | `command-exit 0` — test layer compiles, 142 pinned signatures held | | `check:generated` (15 artifacts) | 1 stale (`content/docs/references/**`), regenerated with `--fix`, re-checked green by the same run | | 11 derived gate families incl. `check:nul-bytes`, `check:spec-docblock-symbol-anchors`, `check:empty-changeset`, `check:changeset-no-major`, `check:adr-0087-registration`, `check:doc-frontmatter`, `check:keyed-text-bounds`, `check:comment-mask-*`, `check:affected-docs` | all `exit 0` | | 11 more incl. `check:issue-citations`, `check:pm-prior-rulings`, `check:doc-anchors`, `check:doc-authoring`, `check:docs-spec-enumerations`, `check:published-files`, `check:llms-txt`, `check:variant-docs` | all `exit 0` | | `check:docs-transcript-drift` | **NOT MEASURED** at the time this body was written — `exit 3 PREREQUISITE NOT MET`, needs `@objectstack/lint` built, which was queued behind another agent's hold on the shared verify lock. Its own output states this is neither a pass nor a finding. The reading is reported in the dispatch report comment on #17011. | **Lint, as a proven narrowing rather than a skipped run.** ① Population: `eslint.config.mjs` lints `**/*.{ts,tsx,mts,cts,js,jsx,mjs,cjs}` and declares no block for `.md`, `.mdx` or `.json`, so exactly one file in this diff is in the linted population. ② Count, from `--format json`: 1 file linted, 0 errors, 0 warnings, exit 0. ③ Invariance: this repo's config **never enables type-aware linting for any file** — its own header says so and records a measured positive control — so this diff cannot move the verdict on a file it did not touch. Read at `HEAD` = `fd9435b3ba`. Repo-wide sweeps (`pnpm lint` and the rest of the derived farm) are CI's run, not owed here. ## Acceptance notes Observations from this pass, ⛔ none filed and none fixed here — they are not in the three filing classes: - `noted, not filed:` the `.describe()` is now two sentences and long enough that the generated reference tables render it as one wide cell. Cosmetic only; the four pages read fine. Carrier: the next PR to touch `SeedSchema`'s describe. - `noted, not filed:` the dispatch's file surface characterises `packages/spec`'s `files[]` as carrying "a bare `README.md` and `src/**/*.zod.ts`". The manifest has ten entries, and `liveness` is one of them — which is why the ledger edit publishes too. Partial characterisation in a dispatch note, not a repo defect. Carrier: none. - `noted, not filed:` `examples/` first-party seed data declares neither `locale` nor `env` on any of its 24 datasets, so the repo ships no worked example of either axis outside docs and tests. An observation about coverage, not a defect or a contract violation. Carrier: whoever next extends the example apps. --- _Generated by [Claude Code](https://claude.ai/code/session_01UDXER3sdqfeVYpEWZs5mZx)_ --------- Co-authored-by: Claude <noreply@anthropic.com>
1 parent 1d41aa8 commit 4fba503

8 files changed

Lines changed: 41 additions & 6 deletions

File tree

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
---
2+
"@objectstack/spec": patch
3+
---
4+
5+
`Seed.locale` now states its own bound: the publish and install paths do not filter by locale — they load every dataset and warn. Wording only; ⛔ no behaviour changed.
6+
7+
The loader evaluates this axis against `SeedLoaderConfig.locale`, which only the boot path supplies (`AppPlugin` reads the app's declared `i18n.defaultLocale`, #16595). Three publish/install-time request builders — package apply, draft publish and marketplace install — are handed no stack config and pass no locale, so a `locale`-scoped dataset reaching one of them is loaded for **every** locale and `warnOnUnresolvedLocaleScope` names each one it let through. That was already the published contract: `content/docs/data-modeling/seed-data.mdx` declared it verbatim for the embedding-host case. What it was not was discoverable from the key itself — an author reading `SeedSchema.locale` had no way to learn where the axis stops, and the ledger row's note still ended with a to-do.
8+
9+
- **The `.describe()` and TSDoc carry the bound.** Both ship to consumers — `src/**/*.zod.ts` and `dist` are in this package's `files[]`, measured with `npm pack --dry-run` — so the sentence reaches an author's editor rather than only a docs page they may never open.
10+
- **The liveness ledger row records a DECISION, not a to-do.** `packages/spec/liveness/seed.json`'s `locale` note ended 「Filed as its own card」. That card was ruled 2026-09-10 (option A 「不扩散」 — publish and install are locale-neutral acts, 「无违约、非缺陷」, because the docs page had already declared this bound and the runtime warns by name). The note now cites the ruling and states what would reopen it.
11+
- **⛔ Deliberately not done.** Making the three call sites pass a locale, and turning the warning into a refusal, were both explicitly not ruled. The first would give one concept two sources of truth — the app's declared locale versus the platform default — and would silently stop loading a dataset that loads today; the second would turn a succeeding published path into a failing one. Neither buys safety while measured usage is zero.
12+
13+
⚠️ **The reading this rests on, and its reach.** Real first-party seed data using `locale`, measured repo-wide 2026-09-22 against `1f53b0b685`: **zero**. A structural scan of all 49 `defineSeed` call sites found 24 in real app data under `examples/` and none declaring the key; the scan is self-lit, because the same pass does find the two `locale`-declaring call sites on the docs page. That reach is **this repo only** — cloud, hotcrm and external customer apps stay unmeasured. A measured use of `locale`-scoped seed data in any of them reopens the decision.

‎content/docs/data-modeling/seed-data.mdx‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -238,6 +238,16 @@ operator's job — to switch locales cleanly, start from a fresh database.
238238
and the loader warns naming each locale-scoped dataset it let through, so a
239239
scope that is not taking effect is one log line to diagnose rather than a
240240
silent no-op.
241+
242+
**Publishing and installing are locale-neutral acts, by decision.** Applying
243+
a package, publishing a draft and installing from the marketplace each build
244+
their own seed-load request and pass no locale, so a `locale`-scoped dataset
245+
reaching one of those paths loads for every market and is named in that
246+
warning. This is the declared bound of the axis rather than an unfinished
247+
path — a package is assembled once for every market, and selecting a market
248+
is what happens when it is opened, on the boot path above. Ruled
249+
2026-09-10 on
250+
[#17011](https://github.com/objectstack-ai/objectstack/issues/17011#issuecomment-5615361502).
241251
</Callout>
242252

243253
---

‎content/docs/references/api/package-api.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -609,7 +609,7 @@ Structured plugin permission grants (ADR-0025 §3.2)
609609
| **externalId** | `string \| string[]` | optional (default: `"name"`) | Field (or composite list of fields) matched for the uniqueness check |
610610
| **mode** | `Enum<'insert' \| 'update' \| 'upsert' \| 'replace' \| 'ignore'>` | optional (default: `"upsert"`) | Conflict resolution strategy |
611611
| **env** | `Enum<'prod' \| 'dev' \| 'test'>[]` | optional (default: `["prod","dev","test"]`) | Applicable environments |
612-
| **locale** | `string[]` | optional | Applicable locales (BCP-47 tags); omitted applies to every locale |
612+
| **locale** | `string[]` | optional | Applicable locales (BCP-47 tags); omitted applies to every locale. The publish and install paths do not filter by locale — they load every dataset and warn |
613613
| **records** | `Record<string, any>[]` | ✅ | Data records |
614614
| **_lock** | `Enum<'none' \| 'no-overlay' \| 'no-delete' \| 'full'>` | optional | Item-level lock — controls overlay & delete (ADR-0010). |
615615
| **_lockReason** | `string` | optional | Human-readable reason shown when a write is refused by _lock. |

‎content/docs/references/data/seed-loader.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -229,7 +229,7 @@ Seed loader request with datasets and configuration
229229
| **externalId** | `string \| string[]` | optional (default: `"name"`) | Field (or composite list of fields) matched for the uniqueness check |
230230
| **mode** | `Enum<'insert' \| 'update' \| 'upsert' \| 'replace' \| 'ignore'>` | optional (default: `"upsert"`) | Conflict resolution strategy |
231231
| **env** | `Enum<'prod' \| 'dev' \| 'test'>[]` | optional (default: `["prod","dev","test"]`) | Applicable environments |
232-
| **locale** | `string[]` | optional | Applicable locales (BCP-47 tags); omitted applies to every locale |
232+
| **locale** | `string[]` | optional | Applicable locales (BCP-47 tags); omitted applies to every locale. The publish and install paths do not filter by locale — they load every dataset and warn |
233233
| **records** | `Record<string, any>[]` | ✅ | Data records |
234234
| **_lock** | `Enum<'none' \| 'no-overlay' \| 'no-delete' \| 'full'>` | optional | Item-level lock — controls overlay & delete (ADR-0010). |
235235
| **_lockReason** | `string` | optional | Human-readable reason shown when a write is refused by _lock. |

‎content/docs/references/data/seed.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ const result = SeedSchema.parse(data);
3131
| **externalId** | `string \| string[]` | optional (default: `"name"`) | Field (or composite list of fields) matched for the uniqueness check |
3232
| **mode** | `Enum<'insert' \| 'update' \| 'upsert' \| 'replace' \| 'ignore'>` | optional (default: `"upsert"`) | Conflict resolution strategy |
3333
| **env** | `Enum<'prod' \| 'dev' \| 'test'>[]` | optional (default: `["prod","dev","test"]`) | Applicable environments |
34-
| **locale** | `string[]` | optional | Applicable locales (BCP-47 tags); omitted applies to every locale |
34+
| **locale** | `string[]` | optional | Applicable locales (BCP-47 tags); omitted applies to every locale. The publish and install paths do not filter by locale — they load every dataset and warn |
3535
| **records** | `Record<string, any>[]` | ✅ | Data records |
3636
| **_lock** | `Enum<'none' \| 'no-overlay' \| 'no-delete' \| 'full'>` | optional | Item-level lock — controls overlay & delete (ADR-0010). |
3737
| **_lockReason** | `string` | optional | Human-readable reason shown when a write is refused by _lock. |

‎content/docs/references/kernel/manifest.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -88,7 +88,7 @@ Structured plugin permission grants (ADR-0025 §3.2)
8888
| **externalId** | `string \| string[]` | optional (default: `"name"`) | Field (or composite list of fields) matched for the uniqueness check |
8989
| **mode** | `Enum<'insert' \| 'update' \| 'upsert' \| 'replace' \| 'ignore'>` | optional (default: `"upsert"`) | Conflict resolution strategy |
9090
| **env** | `Enum<'prod' \| 'dev' \| 'test'>[]` | optional (default: `["prod","dev","test"]`) | Applicable environments |
91-
| **locale** | `string[]` | optional | Applicable locales (BCP-47 tags); omitted applies to every locale |
91+
| **locale** | `string[]` | optional | Applicable locales (BCP-47 tags); omitted applies to every locale. The publish and install paths do not filter by locale — they load every dataset and warn |
9292
| **records** | `Record<string, any>[]` | ✅ | Data records |
9393
| **_lock** | `Enum<'none' \| 'no-overlay' \| 'no-delete' \| 'full'>` | optional | Item-level lock — controls overlay & delete (ADR-0010). |
9494
| **_lockReason** | `string` | optional | Human-readable reason shown when a write is refused by _lock. |

‎packages/spec/liveness/seed.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@
3434
"evidenceScope": "in-repo",
3535
"evidence": "packages/metadata-protocol/src/seed-loader.ts#datasetAllowsLocale (`const declared = dataset.locale` — the one read of the key; absence is the unrestricted spelling, because locales have no enumerable universe to default to the way `env` does); packages/metadata-protocol/src/seed-loader.ts#filterByLocale (drops the datasets it excludes, and always NAMES what it dropped)",
3636
"producer": "packages/runtime/src/app-plugin.ts#resolveSeedLocale (AppPlugin resolves the load-time locale ITSELF off the app's declared `i18n.defaultLocale` — the same ENVELOPE key, read the same way `loadTranslations` reads it for `setDefaultLocale` — and threads it into all THREE `SeedLoaderRequest`s this plugin builds: the inline boot seed, the per-org replayer registered for tenant provisioning, and the dev hot-reload seeder. A blank or undeclared `defaultLocale` sends NO `locale` key rather than an `'en'` default, because absence is the loader's unrestricted spelling and a default would have turned a wiring change into a data change)",
37-
"note": "FLIPPED experimental → live 2026-09-09 by #16595, which supplied the missing PRODUCER. The consumer half (#16510 / PR #16592) was always closed and tested; what was missing was the second input the effect depends on, `SeedLoaderConfig.locale`, which no first-party call site passed — so `filterByLocale` returned its input on its first line and `dataset.locale` was never read at all on the default boot path. That is the same shape `Seed.env` was in before framework#4704, which is why this row was recorded as `experimental` instead of published `live` on a correct-but-insufficient consumer pointer (#4837). EVIDENCE FOR THE FLIP, and it is a NEGATIVE leg rather than a green suite: `packages/runtime/src/app-plugin.seed-locale-producer.test.ts` asserts on the rows that reach the engine, not on the request object, and an ablation that neutralises `resolveSeedLocale` (returning `undefined`) turns 5 of its 7 cases red in the inert direction — a `locale: ['zh-CN']` dataset loads on an `en` stack. All three of this plugin's call sites go red, so the pin covers each one. ⚠️ WHAT THIS `live` ASSERTS, AND WHAT IT DOES NOT — read this before citing the row. It ASSERTS the ledger's own criterion and nothing wider: authoring `locale` changes runtime behaviour, on the boot path a `defineStack()` app actually boots through, and the `producer` field names the code that makes that true. ⛔ It does NOT assert that every path which can reach `SeedLoaderService.load()` supplies a locale — three do not, they are named below, and a reader who takes `live` as \"the axis is honoured everywhere\" is reading something this row does not say. That is the distinction between this row and the #4837 specimen one entry up: `Seed.env` was `live` while ZERO of six call sites supplied it, so authoring the key changed nothing anywhere and the verdict was false in the only sense the criterion has. Here it is true, and bounded, and the bound is written down. ⚠️ THE SCOPE OF THIS `live`, stated rather than left to be discovered: this repo has SIX request builders, the same six the `env` row one entry up enumerates. #16595 wired the THREE in `packages/runtime/src/app-plugin.ts` — the default boot path, which is what makes authoring `locale` change runtime behaviour and therefore what makes this row `live`. The other three are publish/install-time paths and still pass no locale: packages/runtime/src/domains/packages.ts#applyPublishedSeeds (package apply), packages/metadata-protocol/src/protocol.ts#applySeedBodies (draft publish) and packages/cloud-connection/src/marketplace-install-local-plugin.ts#runInlineSeed (marketplace install). None of the three is handed the stack config, and none passes `env` either, so this is the SAME frontier the `live` `env` row already sits behind rather than a new one — but `env` crosses it because `resolveEnvConfig` can read an ambient `NODE_ENV` inside `load()`, and a locale has no ambient source, so it cannot be closed the same way. Filed as its own card. ⚠️ AND THEREFORE `SeedLoaderService#warnOnUnresolvedLocaleScope` STAYS (the judgement #16595 was asked to make, decided with its reason recorded here rather than deleted silently): it is not a signpost for an unwired state that has now gone away. It is the live diagnostic for the three call sites above, for any embedding host that builds its own request, and for a stack that declares no `i18n` block — all of which still reach `load()` with locale-scoped datasets and no `config.locale`. Deleting it would make exactly those paths silently inert, which is the property this row spent a release being. REPOINTED while flipping: the pre-flip text of this note named four call sites (the three in app-plugin.ts plus draft publish) and called the `protocol.ts` one unconfirmed. Re-derived against `main` at bb7d91f19f: the `protocol.ts` site is REAL — the earlier negative came from grepping `seedLoader.load`, and that call site names its local `loader` — and the enumeration was short by two (package apply, marketplace install). The full set is the six named above, found by scanning `SeedLoaderRequestSchema` rather than a variable name."
37+
"note": "FLIPPED experimental → live 2026-09-09 by #16595, which supplied the missing PRODUCER. The consumer half (#16510 / PR #16592) was always closed and tested; what was missing was the second input the effect depends on, `SeedLoaderConfig.locale`, which no first-party call site passed — so `filterByLocale` returned its input on its first line and `dataset.locale` was never read at all on the default boot path. That is the same shape `Seed.env` was in before framework#4704, which is why this row was recorded as `experimental` instead of published `live` on a correct-but-insufficient consumer pointer (#4837). EVIDENCE FOR THE FLIP, and it is a NEGATIVE leg rather than a green suite: `packages/runtime/src/app-plugin.seed-locale-producer.test.ts` asserts on the rows that reach the engine, not on the request object, and an ablation that neutralises `resolveSeedLocale` (returning `undefined`) turns 5 of its 7 cases red in the inert direction — a `locale: ['zh-CN']` dataset loads on an `en` stack. All three of this plugin's call sites go red, so the pin covers each one. ⚠️ WHAT THIS `live` ASSERTS, AND WHAT IT DOES NOT — read this before citing the row. It ASSERTS the ledger's own criterion and nothing wider: authoring `locale` changes runtime behaviour, on the boot path a `defineStack()` app actually boots through, and the `producer` field names the code that makes that true. ⛔ It does NOT assert that every path which can reach `SeedLoaderService.load()` supplies a locale — three do not, they are named below, and a reader who takes `live` as \"the axis is honoured everywhere\" is reading something this row does not say. That is the distinction between this row and the #4837 specimen one entry up: `Seed.env` was `live` while ZERO of six call sites supplied it, so authoring the key changed nothing anywhere and the verdict was false in the only sense the criterion has. Here it is true, and bounded, and the bound is written down. ⚠️ THE SCOPE OF THIS `live`, stated rather than left to be discovered: this repo has SIX request builders, the same six the `env` row one entry up enumerates. #16595 wired the THREE in `packages/runtime/src/app-plugin.ts` — the default boot path, which is what makes authoring `locale` change runtime behaviour and therefore what makes this row `live`. The other three are publish/install-time paths and still pass no locale: packages/runtime/src/domains/packages.ts#applyPublishedSeeds (package apply), packages/metadata-protocol/src/protocol.ts#applySeedBodies (draft publish) and packages/cloud-connection/src/marketplace-install-local-plugin.ts#runInlineSeed (marketplace install). None of the three is handed the stack config, and none passes `env` either, so this is the SAME frontier the `live` `env` row already sits behind rather than a new one — but `env` crosses it because `resolveEnvConfig` can read an ambient `NODE_ENV` inside `load()`, and a locale has no ambient source, so it cannot be closed the same way. RULED 2026-09-10 on #17011 (director seat, one-class self-adjudication, option A 「不扩散」): publish and install are locale-neutral acts, so this bound is the CONTRACT rather than an open defect — 「无违约、非缺陷」, because `content/docs/data-modeling/seed-data.mdx` already declared that these three paths load every dataset and warn. What the ruling ordered was wording, not wiring: `SeedSchema.locale`'s describe and that docs page now state the bound, and ⛔ no behaviour changed on the three sites — making them pass a locale (option B) and turning the warning into a refusal (option C) were both explicitly ⛔ not ruled. So this line is a DECISION, not a to-do. ⚠️ THE RULING'S LOAD-BEARING PREMISE, and the one thing that reopens it: real first-party seed data using `locale`, measured repo-wide, is ZERO — re-derived 2026-09-22 against 1f53b0b685 by a structural scan of all 49 `defineSeed` call sites (24 of them real app data in `examples/`, none declaring `locale`), self-lit because the same scan does find the two `locale`-declaring call sites on the docs page. That reach is THIS repo only; cloud / hotcrm / external customer apps stay unmeasured. A measured use of `locale`-scoped seed data in any of them reopens this as option B. ⚠️ AND THEREFORE `SeedLoaderService#warnOnUnresolvedLocaleScope` STAYS (the judgement #16595 was asked to make, decided with its reason recorded here rather than deleted silently): it is not a signpost for an unwired state that has now gone away. It is the live diagnostic for the three call sites above, for any embedding host that builds its own request, and for a stack that declares no `i18n` block — all of which still reach `load()` with locale-scoped datasets and no `config.locale`. Deleting it would make exactly those paths silently inert, which is the property this row spent a release being. REPOINTED while flipping: the pre-flip text of this note named four call sites (the three in app-plugin.ts plus draft publish) and called the `protocol.ts` one unconfirmed. Re-derived against `main` at bb7d91f19f: the `protocol.ts` site is REAL — the earlier negative came from grepping `seedLoader.load`, and that call site names its local `loader` — and the enumeration was short by two (package apply, marketplace install). The full set is the six named above, found by scanning `SeedLoaderRequestSchema` rather than a variable name."
3838
},
3939
"records": {
4040
"status": "live",

‎packages/spec/src/data/seed.zod.ts‎

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -118,9 +118,21 @@ export const SeedSchema = lazySchema(() => strictObject({
118118
*
119119
* The platform translates nothing. This is the axis that SELECTS between
120120
* record sets the app authored itself.
121+
*
122+
* **Publishing and installing are locale-neutral acts — this axis is scoped
123+
* to the boot path, by decision.** The loader evaluates it against
124+
* `SeedLoaderConfig.locale`, which only the boot path supplies (AppPlugin
125+
* reads the app's declared `i18n.defaultLocale`). Package apply, draft
126+
* publish and marketplace install each build their own load request and pass
127+
* no locale, so a `locale`-scoped dataset reaching one of them is loaded for
128+
* **every** locale and the loader warns naming each dataset it let through.
129+
* That bound is the contract, not an unfinished path: a package is assembled
130+
* once for every market, and selecting a market is what happens when it is
131+
* opened. Ruled on #17011 (2026-09-10), which also kept the warning rather
132+
* than turning those paths into a refusal.
121133
*/
122134
locale: z.array(LocaleSchema).min(1).optional()
123-
.describe('Applicable locales (BCP-47 tags); omitted applies to every locale'),
135+
.describe('Applicable locales (BCP-47 tags); omitted applies to every locale. The publish and install paths do not filter by locale — they load every dataset and warn'),
124136

125137
/**
126138
* The Payload

0 commit comments

Comments
 (0)