zinkee 0.1.12 → 0.1.17

package/src/utils/examples.ts

@@ -1,10 +1,3 @@
-import { AutomationsApi } from "../api/automations.js";
-import { SchemasApi, type ApiSchema, type ApiSchemaField } from "../api/schemas.js";
-import { ApiClient } from "../client.js";
-import { defaultConfigPath, readRuntimeConfig } from "../config.js";
-import type { NormalizedUuidOrSlug } from "../parsers/selectors.js";
-import { resolveRuntimeContext } from "../runtime-context.js";
-import type { RuntimeOverrides } from "../types.js";
 import {
   getSchemaFieldTypeDefinitions,
   resolveSchemaFieldType,
@@ -17,12 +10,6 @@ export interface CommandExample {
   response?: string;
 }
 
-export interface ExampleContextOptions {
-  enabled?: boolean;
-  configPath?: string;
-  overrides?: RuntimeOverrides;
-}
-
 export function buildCommandExample(example: CommandExample): CommandExample {
   return {
     command: example.command,
@@ -411,11 +398,11 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
     {
       description: "Patch formula field (formula text).",
       command:
-        `zinkee --json schemas fields update contacts formula-total --raw '{"type":"FormulaField","config":{"formulaText":"amount * 1.10","uiFormatKind":"number","status":"ACTIVE","numberFormatOptions":{"format":"number","decimals":2,"thousandsSeparator":true},"conditionalFormatting":[]}}'`,
+        `zinkee --json schemas fields update contacts formula-total --raw '{"type":"FormulaField","config":{"formulaText":"c52efe3f-2825-4c60-a7e3-34dd4c1ce043 * 1.10","uiFormatKind":"number","status":"ACTIVE","numberFormatOptions":{"format":"number","decimals":2,"thousandsSeparator":true},"conditionalFormatting":[]}}'`,
       raw: `{
   "type": "FormulaField",
   "config": {
-    "formulaText": "amount * 1.10",
+    "formulaText": "c52efe3f-2825-4c60-a7e3-34dd4c1ce043 * 1.10",
     "uiFormatKind": "number",
     "status": "ACTIVE",
     "numberFormatOptions": {
@@ -623,9 +610,9 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
     },
     {
       description:
-        "Create a record mixing text, option, number, date and reference fields. Structured values go through --set-json.",
+        "Create a record mixing text, option, number, date, reference and member fields. ReferenceField values must match the target's current targetDisplayField (read it from the target record before writing).",
       command:
-        `zinkee --json records create contacts --set contact-name="Grace Hopper" --set contact-email=grace@example.com --set-json status=2 --set-json amount=1999.99 --set due-date=2026-06-01T09:00:00Z --set customer-ref=8ad602a1-f6e3-43f6-9ab2-f1c5afc99621 --set owner=6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d`,
+        `zinkee --json records create contacts --set contact-name="Grace Hopper" --set contact-email=grace@example.com --set status=2 --set amount=1999.99 --set due-date=2026-06-01T09:00:00Z --set customer-ref="CUST-12" --set owner=6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d`,
       raw: `{
   "values": {
     "contact-name": "Grace Hopper",
@@ -633,7 +620,7 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
     "status": 2,
     "amount": 1999.99,
     "due-date": "2026-06-01T09:00:00Z",
-    "customer-ref": "8ad602a1-f6e3-43f6-9ab2-f1c5afc99621",
+    "customer-ref": "CUST-12",
     "owner": "6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d"
   }
 }`,
@@ -664,7 +651,7 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
     {
       description: "Patch multiple typed values at once.",
       command:
-        'zinkee --json records update contacts 550e8400-e29b-41d4-a716-446655440000 --set-json status=3 --set-json amount=2500.00 --set due-date=2026-07-01T09:00:00Z --set owner=6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d',
+        'zinkee --json records update contacts 550e8400-e29b-41d4-a716-446655440000 --set status=3 --set amount=2500.00 --set due-date=2026-07-01T09:00:00Z --set owner=6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d',
       raw: `{
   "set": {
     "status": 3,
@@ -1398,9 +1385,9 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
 }`,
     },
     {
-      description: "Create a bar CHART widget with a time-serie x-axis and two y-axis series.",
+      description: "Create a bars CHART widget with a time-serie x-axis and two y-axis series.",
       command:
-        `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type CHART --name "Revenue by month" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":8,"h":6}' --chart-type bar --x-axis-field due-date --x-axis-date-format MONTH --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#4B9CD3","axisType":"BAR"}' --y-axis-serie '{"typeCalc":"COUNT","fieldCalc":"id","color":"#E57373","axisType":"LINE"}' --legend '{"position":"bottom"}'`,
+        `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type CHART --name "Revenue by month" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":8,"h":6}' --chart-type bars --x-axis-field due-date --x-axis-date-format MONTH --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#4B9CD3","axisType":"PRIMARY"}' --y-axis-serie '{"typeCalc":"COUNT","fieldCalc":"id","color":"#E57373","axisType":"SECONDARY"}' --legend '{"position":"bottom"}'`,
       raw: `{
   "type": "CHART",
   "source": {
@@ -1412,7 +1399,7 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
   },
   "presentation": { "name": "Revenue by month" },
   "chart": {
-    "chartType": "bar",
+    "chartType": "bars",
     "xAxisFieldId": "due-date",
     "xAxisDateFormat": "MONTH",
     "xAxisAsTimeSerie": true,
@@ -1421,13 +1408,13 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
         "typeCalc": "SUM",
         "fieldCalc": "amount",
         "color": "#4B9CD3",
-        "axisType": "BAR"
+        "axisType": "PRIMARY"
       },
       {
         "typeCalc": "COUNT",
         "fieldCalc": "id",
         "color": "#E57373",
-        "axisType": "LINE"
+        "axisType": "SECONDARY"
       }
     ],
     "legend": { "position": "bottom" }
@@ -1582,12 +1569,12 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
 }`,
     },
     {
-      description: "Replace the chart series with a weekly line.",
+      description: "Replace the chart series with weekly lines.",
       command:
-        `zinkee --json displays widgets update 0f6f062f-1478-4df2-96a1-c495d037d260 22222222-2222-4222-a222-222222222222 --chart-type line --x-axis-field due-date --x-axis-date-format WEEK --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#2E7D32","axisType":"LINE"}'`,
+        `zinkee --json displays widgets update 0f6f062f-1478-4df2-96a1-c495d037d260 22222222-2222-4222-a222-222222222222 --chart-type lines --x-axis-field due-date --x-axis-date-format WEEK --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#2E7D32","axisType":"PRIMARY"}'`,
       raw: `{
   "chart": {
-    "chartType": "line",
+    "chartType": "lines",
     "xAxisFieldId": "due-date",
     "xAxisDateFormat": "WEEK",
     "xAxisAsTimeSerie": true,
@@ -1596,7 +1583,7 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
         "typeCalc": "SUM",
         "fieldCalc": "amount",
         "color": "#2E7D32",
-        "axisType": "LINE"
+        "axisType": "PRIMARY"
       }
     ]
   }
@@ -1932,7 +1919,7 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
       "required": false,
       "system": false,
       "config": {
-        "formulaText": "amount * 1.21",
+        "formulaText": "c52efe3f-2825-4c60-a7e3-34dd4c1ce043 * 1.21",
         "uiFormatKind": "number",
         "status": "ACTIVE",
         "defaultValue": null,
@@ -1947,12 +1934,12 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
     {
       "id": "6d7e8f90-1234-5678-9abc-def012345678",
       "type": "FormulaField",
-      "slug": "formula-deadline",
-      "label": "Computed Deadline",
+      "slug": "formula-period",
+      "label": "Formula Period",
       "required": false,
       "system": false,
       "config": {
-        "formulaText": "addDays(startDate, 7)",
+        "formulaText": "date_format(d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90, \"AAAA-MM\")",
         "uiFormatKind": "date",
         "status": "ACTIVE",
         "defaultValue": null,
@@ -2234,6 +2221,17 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
       response: `{
   "recordId": "550e8400-e29b-41d4-a716-446655440000",
   "deleted": true
+}`,
+    },
+  ]),
+  "records clear": buildCommandExamples([
+    {
+      description:
+        "Delete every record from a schema's table. Heritage rules (CASCADE / SET NULL) propagate to child schemas asynchronously via the CDC pipeline.",
+      command: "zinkee --json records clear contacts",
+      response: `{
+  "schemaId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+  "cleared": true
 }`,
     },
   ]),
@@ -3353,7 +3351,7 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
       description:
         "Add a search-records action whose condition pulls its value from the trigger payload using --condition-json.",
       command:
-        `zinkee --json automations actions add automation-1 --type search_records --name "Find duplicates" --target-schema followups --condition-json '{"field":"email","comparator":"eq","values":[{"rawValue":null,"source":{"type":"TRIGGER","id":"payload_value"}}]}'`,
+        `zinkee --json automations actions add automation-1 --type search_records --name "Find duplicates" --target-schema followups --condition-json '{"field":"email","comparator":"eq","values":[{"rawValue":null,"source":{"type":"TRIGGER","id":"f1e1d000-0000-0000-0000-000000000005"}}]}'`,
       raw: `{
   "type": "search_records",
   "name": "Find duplicates",
@@ -3368,7 +3366,7 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
             "rawValue": null,
             "source": {
               "type": "TRIGGER",
-              "id": "payload_value"
+              "id": "f1e1d000-0000-0000-0000-000000000005"
             }
           }
         ]
@@ -3694,539 +3692,9 @@ export function getCommandExamples(
   return specificExamples[commandName] ?? fallbackExamples(commandName);
 }
 
-interface ExampleAutomationContext {
-  automationsApi: AutomationsApi;
-  schemasApi: SchemasApi;
-}
-
-interface SchemaFieldReference {
-  schemaId: string;
-  schemaRef: string;
-  fieldId: string;
-  fieldRef: string;
-}
-
-interface AutomationActionReference {
-  automationId: string;
-  actionId: string;
-}
-
-function selector(value: string): NormalizedUuidOrSlug {
-  return {
-    kind: "uuid",
-    value,
-  };
-}
-
-async function createExampleAutomationContext(
-  options: ExampleContextOptions = {},
-): Promise<ExampleAutomationContext | null> {
-  if (options.enabled !== true) {
-    return null;
-  }
-
-  try {
-    const config = readRuntimeConfig(options.configPath ?? defaultConfigPath);
-    const runtime = resolveRuntimeContext(config, options.overrides);
-
-    if (!runtime.baseUrl) {
-      return null;
-    }
-
-    const client = new ApiClient({
-      baseUrl: runtime.baseUrl,
-      apiKey: runtime.apiKey,
-    });
-
-    return {
-      automationsApi: new AutomationsApi(client),
-      schemasApi: new SchemasApi(client),
-    };
-  } catch {
-    return null;
-  }
-}
-
-function referenceValue(value: { slug?: string; id?: string }): string | undefined {
-  return value.slug ?? value.id;
-}
-
-function pickExampleField(fields: readonly ApiSchemaField[]): ApiSchemaField | undefined {
-  return fields.find((field) => !field.required || field.slug || field.id) ?? fields[0];
-}
-
-async function findSchemaFieldReference(
-  context: ExampleAutomationContext,
-): Promise<SchemaFieldReference | null> {
-  const schemas = await context.schemasApi.listSchemas();
-
-  for (const schema of schemas) {
-    if (typeof schema.id !== "string") {
-      continue;
-    }
-
-    const fullSchema = await context.schemasApi.getSchema(selector(schema.id));
-    const fields = Array.isArray(fullSchema.fields) ? fullSchema.fields : [];
-    const field = pickExampleField(fields);
-    const schemaRef = referenceValue(schema);
-    const fieldRef = field ? referenceValue(field) : undefined;
-    const fieldId = typeof field?.id === "string" ? field.id : undefined;
-
-    if (!schemaRef || !fieldRef || !fieldId) {
-      continue;
-    }
-
-    return {
-      schemaId: schema.id,
-      schemaRef,
-      fieldId,
-      fieldRef,
-    };
-  }
-
-  return null;
-}
-
-async function findAutomationId(context: ExampleAutomationContext): Promise<string | null> {
-  const automations = await context.automationsApi.listAutomations();
-  const first = automations.find((automation) => typeof automation.id === "string");
-  return typeof first?.id === "string" ? first.id : null;
-}
-
-async function findAutomationWithAction(
-  context: ExampleAutomationContext,
-): Promise<AutomationActionReference | null> {
-  const automations = await context.automationsApi.listAutomations();
-
-  for (const automation of automations) {
-    if (typeof automation.id !== "string") {
-      continue;
-    }
-
-    const actions = await context.automationsApi.listActions(selector(automation.id));
-    const firstAction = actions.find((action) => typeof action.id === "string");
-
-    if (typeof firstAction?.id === "string") {
-      return {
-        automationId: automation.id,
-        actionId: firstAction.id,
-      };
-    }
-  }
-
-  return null;
-}
-
-async function buildDynamicAutomationExamples(
-  commandName: string,
-  options: ExampleContextOptions = {},
-): Promise<readonly CommandExample[]> {
-  const context = await createExampleAutomationContext(options);
-
-  if (!context) {
-    return [];
-  }
-
-  const schemaField = await findSchemaFieldReference(context);
-  const automationId = await findAutomationId(context);
-  const automationWithAction = await findAutomationWithAction(context);
-  const plugins = await context.automationsApi.listPlugins();
-  const pluginId = typeof plugins[0]?.id === "string" ? plugins[0].id : undefined;
-  const connections = await context.automationsApi.listConnections();
-  const connectionId = typeof connections[0]?.id === "string" ? connections[0].id : undefined;
-
-  switch (commandName) {
-    case "automations create":
-      if (!schemaField) {
-        return [];
-      }
-      return buildCommandExamples([
-        {
-          description:
-            "Create a scheduled automation with a six-field cron expression. This is the safest first example because it does not depend on workspace schemas.",
-          command:
-            'zinkee --json automations create --name "Nightly invoice sync" --trigger-type scheduled --cron "0 15 10 * * 1"',
-          raw: `{
-  "name": "Nightly invoice sync",
-  "trigger": {
-    "type": "scheduled",
-    "config": {
-      "cronExpression": "0 15 10 * * 1"
-    }
-  }
-}`,
-          response: `{
-  "automationId": "d2df2478-2513-4ecb-a2aa-2cea8c3d614a",
-  "webhookEndpoint": null
-}`,
-        },
-        {
-          description:
-            `Create a record-created automation using a real schema reference from this workspace (${schemaField.schemaRef}), with an 'is not empty' condition on ${schemaField.fieldRef}.`,
-          command: `zinkee --json automations create --name "Record created demo" --trigger-type record_created --trigger-schema ${schemaField.schemaRef} --condition-json '{"field":"${schemaField.fieldRef}","comparator":"ine","values":[{"rawValue":"","source":null}]}'`,
-          raw: `{
-  "name": "Record created demo",
-  "trigger": {
-    "type": "record_created",
-    "config": {
-      "schemaId": "${schemaField.schemaRef}",
-      "conditions": [
-        {
-          "field": "${schemaField.fieldRef}",
-          "comparator": "ine",
-          "values": [{"rawValue": "", "source": null}]
-        }
-      ]
-    }
-  }
-}`,
-        },
-        {
-          description:
-            `Create a record-changed automation watching ${schemaField.fieldRef} on ${schemaField.schemaRef}, with an 'is not empty' condition on that field.`,
-          command: `zinkee --json automations create --name "Record changed demo" --trigger-type record_changed --trigger-schema ${schemaField.schemaRef} --trigger-field ${schemaField.fieldRef} --condition-json '{"field":"${schemaField.fieldRef}","comparator":"ine","values":[{"rawValue":"","source":null}]}'`,
-          raw: `{
-  "name": "Record changed demo",
-  "trigger": {
-    "type": "record_changed",
-    "config": {
-      "schemaId": "${schemaField.schemaRef}",
-      "fieldIds": ["${schemaField.fieldRef}"],
-      "conditions": [
-        {
-          "field": "${schemaField.fieldRef}",
-          "comparator": "ine",
-          "values": [{"rawValue": "", "source": null}]
-        }
-      ]
-    }
-  }
-}`,
-        },
-      ]);
-    case "automations trigger set":
-      if (!automationId || !schemaField) {
-        return [];
-      }
-      return buildCommandExamples([
-        {
-          description: "Replace the trigger with a scheduled trigger on a real automation from this workspace.",
-          command: `zinkee --json automations trigger set ${automationId} --trigger-type scheduled --cron "0 15 10 * * 1"`,
-          raw: `{
-  "type": "scheduled",
-  "config": {
-    "cronExpression": "0 15 10 * * 1"
-  }
-}`,
-        },
-        {
-          description:
-            `Replace the trigger with a record-created trigger on ${schemaField.schemaRef}, with an 'is not empty' condition on ${schemaField.fieldRef}.`,
-          command: `zinkee --json automations trigger set ${automationId} --trigger-type record_created --trigger-schema ${schemaField.schemaRef} --condition-json '{"field":"${schemaField.fieldRef}","comparator":"ine","values":[{"rawValue":"","source":null}]}'`,
-          raw: `{
-  "type": "record_created",
-  "config": {
-    "schemaId": "${schemaField.schemaRef}",
-    "conditions": [
-      {
-        "field": "${schemaField.fieldRef}",
-        "comparator": "ine",
-        "values": [{"rawValue": "", "source": null}]
-      }
-    ]
-  }
-}`,
-        },
-        {
-          description:
-            `Replace the trigger with a record-changed trigger watching ${schemaField.fieldRef} on ${schemaField.schemaRef}.`,
-          command: `zinkee --json automations trigger set ${automationId} --trigger-type record_changed --trigger-schema ${schemaField.schemaRef} --trigger-field ${schemaField.fieldRef} --condition-json '{"field":"${schemaField.fieldRef}","comparator":"ine","values":[{"rawValue":"","source":null}]}'`,
-          raw: `{
-  "type": "record_changed",
-  "config": {
-    "schemaId": "${schemaField.schemaRef}",
-    "fieldIds": ["${schemaField.fieldRef}"],
-    "conditions": [
-      {
-        "field": "${schemaField.fieldRef}",
-        "comparator": "ine",
-        "values": [{"rawValue": "", "source": null}]
-      }
-    ]
-  }
-}`,
-        },
-      ]);
-    case "automations actions add":
-      if (!automationId || !schemaField) {
-        return [];
-      }
-      return buildCommandExamples([
-        {
-          description:
-            `Add a create-record action with literal and trigger-based mappings targeting ${schemaField.schemaRef}.`,
-          command: `zinkee --json automations actions add ${automationId} --type create_record --name "Create follow-up order" --target-schema ${schemaField.schemaRef} --map ${schemaField.fieldRef}=pending --map-json owner='{"rawValue":null,"source":{"type":"TRIGGER","id":"payload_value"}}'`,
-          raw: `{
-  "type": "create_record",
-  "name": "Create follow-up order",
-  "config": {
-    "targetSchemaId": "${schemaField.schemaRef}",
-    "fieldMapping": {
-      "${schemaField.fieldRef}": {
-        "rawValue": "pending",
-        "source": null
-      },
-      "owner": {
-        "rawValue": null,
-        "source": {
-          "type": "TRIGGER",
-          "id": "payload_value"
-        }
-      }
-    }
-  }
-}`,
-        },
-        {
-          description:
-            `Add an update-record action that targets the trigger record on ${schemaField.schemaRef}.`,
-          command: `zinkee --json automations actions add ${automationId} --type update_record --name "Mark record as processed" --target-schema ${schemaField.schemaRef} --use-trigger-record --map ${schemaField.fieldRef}=processed`,
-          raw: `{
-  "type": "update_record",
-  "name": "Mark record as processed",
-  "config": {
-    "targetSchemaId": "${schemaField.schemaRef}",
-    "fieldMapping": {
-      "${schemaField.fieldRef}": {
-        "rawValue": "processed",
-        "source": null
-      }
-    },
-    "useTriggerRecord": true
-  }
-}`,
-        },
-        {
-          description: `Add a search-records action with a trigger-based condition on ${schemaField.schemaRef}.`,
-          command: `zinkee --json automations actions add ${automationId} --type search_records --name "Find duplicates" --target-schema ${schemaField.schemaRef} --condition-json '{"field":"${schemaField.fieldRef}","comparator":"eq","values":[{"rawValue":null,"source":{"type":"TRIGGER","id":"payload_value"}}]}'`,
-          raw: `{
-  "type": "search_records",
-  "name": "Find duplicates",
-  "config": {
-    "targetSchemaId": "${schemaField.schemaRef}",
-    "conditions": [
-      {
-        "field": "${schemaField.fieldRef}",
-        "comparator": "eq",
-        "values": [
-          {
-            "rawValue": null,
-            "source": {
-              "type": "TRIGGER",
-              "id": "payload_value"
-            }
-          }
-        ]
-      }
-    ]
-  }
-}`,
-        },
-        ...(connectionId
-          ? buildCommandExamples([
-              {
-                description: `Add an HTTP request action authenticated through a stored connection (${connectionId}).`,
-                command: `zinkee --json automations actions add ${automationId} --type http_request --name "Notify external ERP" --method POST --url https://example.com/integrations/order-status --header X-Demo=codex --content-type application/json --timeout-ms 5000 --auth-mode STORED --connection ${connectionId}`,
-                raw: `{
-  "type": "http_request",
-  "name": "Notify external ERP",
-  "config": {
-    "method": "POST",
-    "url": "https://example.com/integrations/order-status",
-    "headers": {
-      "X-Demo": "codex"
-    },
-    "contentType": "application/json",
-    "timeoutMs": 5000,
-    "authMode": "STORED",
-    "connectionId": "${connectionId}"
-  }
-}`,
-              },
-            ])
-          : buildCommandExamples([
-              {
-                description: "Add an HTTP request action through the generic --type path.",
-                command: `zinkee --json automations actions add ${automationId} --type http_request --name "Notify external ERP" --method POST --url https://example.com/integrations/order-status --content-type application/json`,
-                raw: `{
-  "type": "http_request",
-  "name": "Notify external ERP",
-  "config": {
-    "method": "POST",
-    "url": "https://example.com/integrations/order-status",
-    "contentType": "application/json"
-  }
-}`,
-              },
-            ])),
-        ...(pluginId
-          ? buildCommandExamples([
-              {
-                description: `Add an execute-plugin action using an active plugin from this workspace (${pluginId}).`,
-                command: `zinkee --json automations actions add ${automationId} --type execute_plugin --name "Run billing plugin" --plugin ${pluginId} --arg mode=safe --arg-json steps='["one","two"]'`,
-                raw: `{
-  "type": "execute_plugin",
-  "name": "Run billing plugin",
-  "config": {
-    "pluginId": "${pluginId}",
-    "pluginArgs": {
-      "mode": "safe",
-      "steps": ["one", "two"]
-    }
-  }
-}`,
-              },
-            ])
-          : []),
-      ]);
-    case "automations actions update":
-      if (!automationWithAction || !schemaField) {
-        return [];
-      }
-      return buildCommandExamples([
-        {
-          description: "Update a record action on a real automation/action pair using the trigger record.",
-          command: `zinkee --json automations actions update ${automationWithAction.automationId} ${automationWithAction.actionId} --type update_record --name "Update trigger record" --target-schema ${schemaField.schemaRef} --map ${schemaField.fieldRef}=ready --use-trigger-record`,
-          raw: `{
-  "type": "update_record",
-  "name": "Update trigger record",
-  "config": {
-    "targetSchemaId": "${schemaField.schemaRef}",
-    "fieldMapping": {
-      "${schemaField.fieldRef}": {
-        "rawValue": "ready",
-        "source": null
-      }
-    },
-    "useTriggerRecord": true
-  }
-}`,
-          response: `{
-  "id": "${automationWithAction.actionId}",
-  "type": "update_record",
-  "name": "Update trigger record",
-  "config": {
-    "targetSchemaId": "${schemaField.schemaRef}",
-    "fieldMapping": {
-      "${schemaField.fieldRef}": {
-        "rawValue": "ready",
-        "source": null
-      }
-    },
-    "useTriggerRecord": true
-  }
-}`,
-        },
-      ]);
-    case "automations flow set":
-      if (!automationWithAction) {
-        return [];
-      }
-      return buildCommandExamples([
-        {
-          description: "Set flow entry actions using a real automation/action pair from this workspace.",
-          command: `zinkee --json automations flow set ${automationWithAction.automationId} --entry ${automationWithAction.actionId}`,
-          raw: `{
-  "entryActionIds": ["${automationWithAction.actionId}"],
-  "transitions": []
-}`,
-        },
-      ]);
-    case "automations connections create":
-      return buildCommandExamples([
-        {
-          description: "Create a stored workspace connection for HTTP request actions.",
-          command:
-            'zinkee --json automations connections create --name "ERP API Key" --type api_key --scope workspace --config \'{"headerName":"Authorization"}\' --secret apiKey=super-secret --active',
-          raw: `{
-  "name": "ERP API Key",
-  "type": "api_key",
-  "scope": "workspace",
-  "config": {
-    "headerName": "Authorization"
-  },
-  "secret": {
-    "apiKey": "super-secret"
-  },
-  "active": true
-}`,
-          response: `{
-  "id": "4fc20b5c-9353-4991-b68e-1027cb674ed4",
-  "name": "ERP API Key",
-  "type": "api_key",
-  "scope": "workspace",
-  "ownerMemberId": "6c8a3e0d-7b1f-4c98-a2e9-8b9a2e3f5b14",
-  "active": true,
-  "config": {
-    "headerName": "Authorization"
-  },
-  "createdAt": "2026-04-21T09:00:00Z",
-  "updatedAt": "2026-04-21T09:00:00Z",
-  "createdBy": "developer@zinkee.com",
-  "updatedBy": "developer@zinkee.com"
-}`,
-        },
-      ]);
-    case "automations connections update":
-      if (!connectionId) {
-        return [];
-      }
-      return buildCommandExamples([
-        {
-          description: "Patch an existing stored connection from this workspace.",
-          command: `zinkee --json automations connections update ${connectionId} --raw '{"set":{"name":"ERP API Key Updated","config":{"headerName":"Authorization"}}}'`,
-          raw: `{
-  "set": {
-    "name": "ERP API Key Updated",
-    "config": {
-      "headerName": "Authorization"
-    }
-  }
-}`,
-          response: `{
-  "id": "${connectionId}",
-  "name": "ERP API Key Updated",
-  "type": "api_key",
-  "scope": "workspace",
-  "ownerMemberId": "6c8a3e0d-7b1f-4c98-a2e9-8b9a2e3f5b14",
-  "active": true,
-  "config": {
-    "headerName": "Authorization"
-  },
-  "createdAt": "2026-04-21T09:00:00Z",
-  "updatedAt": "2026-04-21T10:15:00Z",
-  "createdBy": "developer@zinkee.com",
-  "updatedBy": "developer@zinkee.com"
-}`,
-        },
-      ]);
-    default:
-      return [];
-  }
-}
-
-export async function getResolvedCommandExamples(
+export function getResolvedCommandExamples(
   commandName: string,
   filters: { type?: string } = {},
-  options: ExampleContextOptions = {},
-): Promise<readonly CommandExample[]> {
-  const dynamicExamples = commandName.startsWith("automations")
-    ? await buildDynamicAutomationExamples(commandName, options)
-    : [];
-
-  if (dynamicExamples.length > 0) {
-    return dynamicExamples;
-  }
-
+): readonly CommandExample[] {
   return getCommandExamples(commandName, filters);
 }