Skip to content

Commit 1fd900c

Browse files
committed
fix(client,platform-objects,docs): in-system copy says "this system", not "this environment" (cloud#3002 ruling A)
The ai.models() TSDoc and the /ai/models docs row follow the spec's "Models this system offers" and cite the AI model list's record as cloud ADR-0028. permission-sets.mdx says "authored in this system" for the provenance class the spec renamed; authentication.mdx's two bootstrap-status sentences and the set-initial-password sentence name the running system as "this system". The zh-CN, ja-JP and es-ES packageId help values follow the regenerated en value. Claude-Session: https://claude.ai/code/session_01SYEJqDL3NXxrJRBVqaMu9T Co-authored-by: Claude <noreply@anthropic.com>
1 parent 31ce45c commit 1fd900c

8 files changed

Lines changed: 26 additions & 13 deletions

File tree

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
---
2+
'@objectstack/client': patch
3+
'@objectstack/platform-objects': patch
4+
---
5+
6+
Clause-②: no
7+
8+
fix(client,platform-objects): the `ai.models()` TSDoc and the translated permission-set `packageId` help say "this system", as the spec now does
9+
10+
- **What changed.** Inside the running system, published copy names the system the reader is in as "this system", and a permission set made here, not shipped by a package, is "authored in this system". `@objectstack/spec` already says both (`AiModelsResponse.models`, the permission set's `packageId` help text); this follows it in two more places.
11+
- The TSDoc of `client.ai.models()` now reads "Models this system offers in the chat model picker (cloud ADR-0028)". The citation is qualified as `cloud ADR-0028`: the AI service that serves this list is a cloud package, and this repository's ADR-0028 is about metadata naming.
12+
- The zh-CN, ja-JP and es-ES values of the permission set's `packageId` help text in the Setup forms bundle now say 本系统 / このシステム / este sistema where they said 本环境 / この環境 / este entorno, matching the English text "Leave empty for a set authored in this system."
13+
- **Unchanged.** Every method, route, type, form field, key and behaviour. No translation key is added or removed.

‎content/docs/api/plugin-endpoints.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -109,7 +109,7 @@ These are the routes `service-ai` mounts, and the SDK method that reaches each:
109109
| POST | `/ai/chat` | `ai.chat` / `ai.chatStream` | Chat completion — JSON with `stream: false`, otherwise the Vercel UI Message Stream |
110110
| POST | `/ai/chat/stream` | — | Generic-SSE twin of `/ai/chat`: the same completion without the tool loop or persistence |
111111
| POST | `/ai/complete` | `ai.complete` | Text completion |
112-
| GET | `/ai/models` | `ai.models` | Models this environment offers (ADR-0028) |
112+
| GET | `/ai/models` | `ai.models` | Models this system offers (cloud ADR-0028) |
113113
| GET | `/ai/status` | — | Active adapter provenance (console diagnostics) |
114114
| GET | `/ai/effective-model` | — | Resolved model ids and their source (console diagnostics) |
115115
| POST / GET | `/ai/conversations` | `ai.conversations.create` / `.list` | Create / list conversations — the list is newest first and pages by keyset: send the `id` of the last conversation you hold as `cursor`, and read `hasMore` to learn whether another page follows |

‎content/docs/permissions/authentication.mdx‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -249,7 +249,7 @@ console.log('Current user:', session.data.user);
249249
### First-run bootstrap status
250250

251251
`GET /api/v1/auth/bootstrap-status` answers one question — is the admission gate's
252-
bootstrap window open, i.e. does this environment have no **human** user yet? Service
252+
bootstrap window open, i.e. does this system have no **human** user yet? Service
253253
rows (such as the legacy `usr_system` row) do not count.
254254

255255
```typescript
@@ -310,7 +310,7 @@ const response = await fetch('http://localhost:3000/api/v1/auth/reset-password',
310310
signed-in user who has no credential account yet — the account was onboarded
311311
through SSO, through the cloud OAuth provider, or imported with
312312
`passwordPolicy: 'none'`. It gives that user an email/password way in to this
313-
environment without the SSO round-trip.
313+
system without the SSO round-trip.
314314

315315
```typescript
316316
const response = await fetch('http://localhost:3000/api/v1/auth/set-initial-password', {
@@ -1122,7 +1122,7 @@ All endpoints are available under `/api/v1/auth/*`:
11221122
#### Session
11231123

11241124
- `GET /api/v1/auth/get-session` - Get current user session
1125-
- `GET /api/v1/auth/bootstrap-status` - Public, unauthenticated first-run probe: `{ "hasOwner": boolean }`, telling a client whether the admission gate's bootstrap window is still open — i.e. whether this environment has no human user yet ([details](#first-run-bootstrap-status))
1125+
- `GET /api/v1/auth/bootstrap-status` - Public, unauthenticated first-run probe: `{ "hasOwner": boolean }`, telling a client whether the admission gate's bootstrap window is still open — i.e. whether this system has no human user yet ([details](#first-run-bootstrap-status))
11261126

11271127
#### Password Management
11281128

‎content/docs/permissions/permission-sets.mdx‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -366,7 +366,7 @@ or uninstall, and every other `/packages` write verb refuse any other caller
366366
## One authoritative store — the definition (ADR-0094 D1, ADR-0131 D3)
367367

368368
A permission-set **definition** has a single authoritative store: the metadata
369-
layer — a package's declaration, or a definition authored in this environment
369+
layer — a package's declaration, or a definition authored in this system
370370
and saved in `sys_metadata` — served by name from the security catalog.
371371
Nothing mirrors it into a row: the `sys_permission_set` record ADR-0094 kept
372372
as a projection is retired, its object is no longer registered, and no data
@@ -384,14 +384,14 @@ posture, the platform operator. This has three author-visible consequences:
384384
nothing. Clone it to a new name instead (the **Clone** action on the set, or
385385
the clone door below) and edit the clone:
386386
the clone is your organization's own set, and package upgrades keep reaching
387-
the original. Every other set (one created in this environment, a clone, or
387+
the original. Every other set (one authored in this system, a clone, or
388388
one saved into a writable runtime package) is edited in place: the edit
389389
lands on its one stored definition.
390390
- **The API name is immutable after creation.** It is the definition's metadata
391391
identity, and the metadata door addresses the set by it, so there is no
392392
rename. Clone the set to a new name instead.
393-
- **A delete depends on where the definition lives.** A set you created in this
394-
environment is removed. A set that ships with an installed package/app cannot
393+
- **A delete depends on where the definition lives.** A set authored in this
394+
system is removed. A set that ships with an installed package/app cannot
395395
be removed from the environment: its definition stays served from the
396396
package. Uninstall the owning package to remove a packaged set entirely.
397397

@@ -419,7 +419,7 @@ POST /api/v1/security/permission-sets/:name/clone body: { "name": "...", "lab
419419
The clone door copies a set's whole definition under a new machine name. It
420420
reads the source from the security catalog, where every packaged and
421421
environment-authored set lives. It saves the copy through the metadata layer
422-
as a set authored in this environment: no package, and no link back to the set
422+
as a set authored in this system: no package, and no link back to the set
423423
it was copied from, so changes to the source never reach the copy.
424424

425425
- **The body is `{ name, label }`, both required, and nothing else.** `name` is

‎packages/client/src/index.ts‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6699,7 +6699,7 @@ export class ObjectStackClient {
66996699
},
67006700

67016701
/**
6702-
* Models this environment offers in the chat model picker (ADR-0028) —
6702+
* Models this system offers in the chat model picker (cloud ADR-0028) —
67036703
* plan-filtered, with the default flagged. Populate a model picker from
67046704
* this rather than hard-coding ids.
67056705
*/

‎packages/platform-objects/src/apps/translations/es-ES.metadata-forms.generated.ts‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2334,7 +2334,7 @@ export const esESMetadataForms: NonNullable<TranslationData['metadataForms']> =
23342334
},
23352335
packageId: {
23362336
label: "ID de paquete",
2337-
helpText: "El paquete que distribuye este conjunto; un valor que nombra otro paquete se rechaza. Déjalo vacío para un conjunto creado en este entorno."
2337+
helpText: "El paquete que distribuye este conjunto; un valor que nombra otro paquete se rechaza. Déjalo vacío para un conjunto creado en este sistema."
23382338
},
23392339
systemPermissions: {
23402340
label: "Permisos del sistema",

‎packages/platform-objects/src/apps/translations/ja-JP.metadata-forms.generated.ts‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2334,7 +2334,7 @@ export const jaJPMetadataForms: NonNullable<TranslationData['metadataForms']> =
23342334
},
23352335
packageId: {
23362336
label: "所属パッケージ ID",
2337-
helpText: "このセットを同梱しているパッケージです。別のパッケージを指す値は拒否されます。この環境で作成したセットでは空のままにします。"
2337+
helpText: "このセットを同梱しているパッケージです。別のパッケージを指す値は拒否されます。このシステムで作成したセットでは空のままにします。"
23382338
},
23392339
systemPermissions: {
23402340
label: "システム権限",

‎packages/platform-objects/src/apps/translations/zh-CN.metadata-forms.generated.ts‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2334,7 +2334,7 @@ export const zhCNMetadataForms: NonNullable<TranslationData['metadataForms']> =
23342334
},
23352335
packageId: {
23362336
label: "所属包 ID",
2337-
helpText: "分发这个权限集的包;填写其他包的 id 会被拒绝。在本环境中创建的权限集请留空。"
2337+
helpText: "分发这个权限集的包;填写其他包的 id 会被拒绝。在本系统中创建的权限集请留空。"
23382338
},
23392339
systemPermissions: {
23402340
label: "系统权限",

0 commit comments

Comments
 (0)