fix(spec): stageField describe states only what the parse refuses; changeset names platform-objects and metadata-core; FLS contract fixture declares kind

Claude-Session: https://claude.ai/code/session_017qmjVjz61scwQFLfspdBX6
Co-authored-by: Claude <noreply@anthropic.com>

Author: claude

.changeset/23809-select-option-kind.md

@@ -1,5 +1,7 @@
 ---
 '@objectstack/spec': minor
+'@objectstack/platform-objects': patch
+'@objectstack/metadata-core': patch
 ---
 
 feat(spec)!: a select option declares its lifecycle `kind` (`open` / `won` / `lost`), and every option of an object's `stageField` must declare it
@@ -24,4 +26,9 @@ No conversion makes this edit, because which option ends a record's life success
 
 The Studio object designer's options repeater offers `kind`; the field form's options repeater lists it.
 
+The other packages follow the new key:
+
+- **`@objectstack/platform-objects`.** The metadata-form translation bundles (`./metadata-translations`) carry the options repeater's new `kind` row, with its label and help text in zh-CN, ja-JP and es-ES.
+- **`@objectstack/metadata-core`.** The published contract fixture `FLS_CONTRACT_OBJECT` (`@objectstack/metadata-core/testing`) names `salary_grade` as its `stageField`, so its two options now declare `kind: 'open'` and the fixture still parses through `ObjectSchema`.
+
 <!-- adr-0087: registered stage-field-option-kind-required -->

packages/metadata-core/src/object-schema-fls-contract.ts

@@ -132,7 +132,10 @@ export const FLS_CONTRACT_OBJECT = {
         salary_grade: {
             type: 'select',
             label: 'Salary Grade',
-            options: [{ value: 'band_a', label: 'Band A' }, { value: 'band_b', label: 'Band B' }],
+            // `kind` on both: the object names this field its `stageField`, and
+            // `ObjectSchema` requires every stage option to declare one. A salary
+            // band is a step on no road to an end, so both are `open`.
+            options: [{ value: 'band_a', label: 'Band A', kind: 'open' }, { value: 'band_b', label: 'Band B', kind: 'open' }],
             requiredPermissions: ['view_compensation'],
         },
         bonus_formula: {

packages/metadata-core/src/object-schema-fls-references.test.ts

@@ -707,3 +707,10 @@ describe('[ADR-0106] the shared contract table, driven through the bare projecti
         });
     }
 });
+
+describe('the published contract fixture is an object the spec accepts', () => {
+    it('`FLS_CONTRACT_OBJECT` parses through `ObjectSchema` (its stage field declares every option\'s `kind`, #23809)', () => {
+        const parsed = ObjectSchema.safeParse(FLS_CONTRACT_OBJECT);
+        expect(parsed.success, JSON.stringify(parsed.error?.issues)).toBe(true);
+    });
+});

packages/spec/src/data/object.zod.ts

@@ -2885,13 +2885,16 @@ const ObjectSchemaBase = strictObject(
    * path/stepper today; kanban default grouping, list badges and report
    * bucketing are natural future consumers.
    *
-   * [#23809] The named field is a single-value `select` / `radio` whose inline
-   * options EACH declare their lifecycle `kind` (`open` / `won` / `lost`), so
-   * those consumers tell the steps from the two ends by declaration, not by
-   * the value's spelling. Refused at parse otherwise — see
-   * `refuseStageFieldWithoutKinds`.
+   * [#23809] When the named field carries options, it must be a single-value
+   * `select` / `radio` whose inline options EACH declare their lifecycle `kind`
+   * (`open` / `won` / `lost`), so those consumers tell the steps from the two
+   * ends by declaration, not by the value's spelling. The parse refuses such a
+   * field with an option lacking `kind`, a `picklist`-backed one, and a
+   * multi-value one (see `refuseStageFieldWithoutKinds`). Not judged here:
+   * `false`, a name that resolves to no declared field (the lint
+   * `semantic-roles` rule reports it), and a field with no options at all.
    */
-  stageField: z.union([z.string(), z.literal(false)]).optional().describe("[ADR-0085] Lifecycle stage field (linear/ordered), or false to declare the status field non-linear and suppress stage heuristics. Absent = heuristic detection allowed. The named field is a single-value `select` / `radio` with inline `options`, and every option declares its `kind` ('open' / 'won' / 'lost'); refused otherwise."),
+  stageField: z.union([z.string(), z.literal(false)]).optional().describe("[ADR-0085] Lifecycle stage field (linear/ordered), or false to declare the status field non-linear and suppress stage heuristics. Absent = heuristic detection allowed. When the named field carries options, it must be a single-value `select` / `radio` with inline `options`, each declaring its `kind` ('open' / 'won' / 'lost'); a picklist-backed or multi-value stage field is refused. A name that resolves to no declared field, or a field with no options, is not judged at parse."),
 
   /**
    * Cross-renderer EDIT-INTERACTION intent: whether a record of this object is