@@ -0,0 +1,14 @@
+---
+'@objectstack/spec': patch
+---
+
+feat(spec): the flow clone answer declares an optional `noticeCode` beside its English `notice`
+
+Clause-②: yes (widening)
+Metadata-protocol: none
+
+`CloneFlowResponseSchema` (the answer of `POST /api/v1/automation/:name/clone`, "New similar") declared `data: { flow, packageId, notice }`, and `notice` is the server's English sentence with nothing that names it, so a console could only print it verbatim. `data` now also declares `noticeCode?: string`: a stable code naming the `notice` sentence. A client maps a code it knows to its own translated sentence and falls back to `notice` verbatim for a code it does not know, or when the key is absent.
+
+- **Optional.** An answer without `noticeCode` (every server before the one that sends it) still parses; `notice` is still required and keeps its meaning as the English fallback.
+- **The values are the server's.** The schema does not enumerate them; the server that serves the clone door owns the vocabulary.
+- **Not metadata.** This is a REST answer shape, not something a metadata author writes, so the metadata protocol does not move. `@objectstack/client`'s `automation.clone()` returns `CloneFlowResponse['data']`, so its return type gains the optional key with no change to the client package.
@@ -124,7 +124,7 @@ const result = AutomationApiErrorCode.parse(data);
 | **success** | `boolean` | ✅ | Operation success status |
 | **error** | `{ code: Enum<'VALIDATION_ERROR' \| 'INVALID_FIELD' \| 'MISSING_REQUIRED_FIELD' \| …>; declaredCode?: string; message: string; userMessage?: string; … }` | optional | Error details if success is false |
 | **meta** | `{ timestamp: string; duration?: integer; requestId?: string; traceId?: string }` | optional | Response metadata |
-| **data** | `{ flow: object; packageId: string; notice: string }` | ✅ |  |
+| **data** | `{ flow: object; packageId: string; notice: string; noticeCode?: string }` | ✅ |  |
 
 ### Nested Shape: `CloneFlowResponse.error`
 
@@ -156,6 +156,7 @@ const result = AutomationApiErrorCode.parse(data);
 | **flow** | `{ name: string; label: string; description?: string; successMessage?: string; … }` | ✅ | The copy as stored: switched off, in `packageId`, with no lineage. |
 | **packageId** | `string` | ✅ | The package the copy landed in: the one the request named, else the source's paired customization package `<base>.custom`. |
 | **notice** | `string` | ✅ | One line for the administrator, in the server's words: the copy is switched off until someone switches it on, and its references are not re-pointed. |
+| **noticeCode** | `string` | optional | A stable code naming the `notice` sentence beside it, so a client can show that sentence in its own language: a client maps a code it knows to its own translated sentence, and falls back to `notice` verbatim for a code it does not know or when this key is absent (an older server sends none). The values are the server's; `notice` stays the English fallback. |
 
 
 ---
 
@@ -14,6 +14,7 @@ import {
   TriggerFlowResponseSchema,
   ToggleFlowRequestSchema,
   ToggleFlowResponseSchema,
+  CloneFlowResponseSchema,
   ListRunsRequestSchema,
   ListRunsResponseSchema,
   GetRunRequestSchema,
@@ -710,6 +711,58 @@ describe('ToggleFlowResponseSchema', () => {
   });
 });
 
+// ==========================================
+// Clone Flow
+// ==========================================
+
+describe('CloneFlowResponseSchema — `data.noticeCode` names the `notice` sentence', () => {
+  const cloneAnswer = (data: Record<string, unknown>) => ({
+    success: true,
+    data: {
+      flow: {
+        name: 'acme_lead_followup',
+        label: 'Lead Follow-up (ACME)',
+        type: 'autolaunched',
+        status: 'obsolete',
+        nodes: [
+          { id: 'start', type: 'start', label: 'Start' },
+          { id: 'end', type: 'end', label: 'End' },
+        ],
+        edges: [{ id: 'e1', source: 'start', target: 'end' }],
+      },
+      packageId: 'crm.custom',
+      notice: 'The copy is switched off until someone switches it on; its references are not re-pointed.',
+      ...data,
+    },
+  });
+
+  it('accepts a string `noticeCode` beside `notice` and keeps it', () => {
+    const result = CloneFlowResponseSchema.safeParse(cloneAnswer({ noticeCode: 'FLOW_CLONE_DISABLED_COPY' }));
+    expect(result.success).toBe(true);
+    expect(result.data?.data.noticeCode).toBe('FLOW_CLONE_DISABLED_COPY');
+  });
+
+  it('still parses an answer without `noticeCode` (an older server sends none)', () => {
+    const result = CloneFlowResponseSchema.safeParse(cloneAnswer({}));
+    expect(result.success).toBe(true);
+    expect(result.data?.data.noticeCode).toBeUndefined();
+  });
+
+  it('still requires `notice`, the English fallback', () => {
+    const answer = cloneAnswer({ noticeCode: 'FLOW_CLONE_DISABLED_COPY' });
+    delete (answer.data as Record<string, unknown>).notice;
+    const result = CloneFlowResponseSchema.safeParse(answer);
+    expect(result.success).toBe(false);
+    expect(result.error?.issues.map((i) => [i.code, i.path.join('.')])).toEqual([['invalid_type', 'data.notice']]);
+  });
+
+  it('refuses a non-string `noticeCode`, located on the key', () => {
+    const result = CloneFlowResponseSchema.safeParse(cloneAnswer({ noticeCode: 42 }));
+    expect(result.success).toBe(false);
+    expect(result.error?.issues.map((i) => [i.code, i.path.join('.')])).toEqual([['invalid_type', 'data.noticeCode']]);
+  });
+});
+
 // ==========================================
 // List Runs
 // ==========================================
 
@@ -709,7 +709,10 @@ export type CloneFlowRequestParsed = z.infer<typeof CloneFlowRequestSchema>;
  * relabelled and switched off (`status: 'obsolete'`), with no package
  * envelope and no reference to the source (ADR-0126 §9: no clone lineage).
  * `data.packageId` is the package the copy landed in, so a console opens the
- * copy where it lives.
+ * copy where it lives. `data.notice` is the server's English sentence;
+ * `data.noticeCode`, when present, names that sentence by a stable code so a
+ * console can show its own translation, falling back to `notice` for a code it
+ * does not know or when the code is absent.
  */
 export const CloneFlowResponseSchema = lazySchema(() => BaseResponseSchema.extend({
   data: z.object({
@@ -722,6 +725,12 @@ export const CloneFlowResponseSchema = lazySchema(() => BaseResponseSchema.exten
       'One line for the administrator, in the server\'s words: the copy is switched off until '
       + 'someone switches it on, and its references are not re-pointed.',
     ),
+    noticeCode: z.string().optional().describe(
+      'A stable code naming the `notice` sentence beside it, so a client can show that sentence in '
+      + 'its own language: a client maps a code it knows to its own translated sentence, and falls '
+      + 'back to `notice` verbatim for a code it does not know or when this key is absent (an older '
+      + 'server sends none). The values are the server\'s; `notice` stays the English fallback.',
+    ),
   }),
 }));
 export type CloneFlowResponse = z.input<typeof CloneFlowResponseSchema>;