@carthooks/arcubase-cli 0.1.1 → 0.1.3

package/bundle/arcubase.mjs

@@ -94,6 +94,7 @@ function loadRuntimeEnv(scope, env = process.env) {
     ARCUBASE_BASE_URL: requiredValue(env, scope, "ARCUBASE_BASE_URL"),
     ARCUBASE_TENANT_ID: requiredValue(env, scope, "ARCUBASE_TENANT_ID"),
     ARCUBASE_ACCESS_TOKEN: requiredValue(env, scope, "ARCUBASE_ACCESS_TOKEN"),
+    ARCUBASE_HOST: optionalValue(env, scope, "ARCUBASE_HOST"),
     ARCUBASE_TRACE_ID: optionalValue(env, scope, "ARCUBASE_TRACE_ID"),
     ARCUBASE_SUBJECT_TYPE: optionalValue(env, scope, "ARCUBASE_SUBJECT_TYPE"),
     ARCUBASE_SUBJECT_ID: optionalValue(env, scope, "ARCUBASE_SUBJECT_ID"),
@@ -107,6 +108,9 @@ function buildRequestHeaders(env) {
     Authorization: `Bearer ${env.ARCUBASE_ACCESS_TOKEN}`,
     "X-Tenant-Id": env.ARCUBASE_TENANT_ID
   };
+  if (env.ARCUBASE_HOST && env.ARCUBASE_HOST.trim() !== "") {
+    headers["X-Host"] = env.ARCUBASE_HOST;
+  }
   if (env.ARCUBASE_TRACE_ID) {
     headers["X-Trace-Id"] = env.ARCUBASE_TRACE_ID;
   }
@@ -4734,6 +4738,41 @@ function listModules(scope) {
 function listModuleCommands(scope, moduleName) {
   return listCommands(scope).filter((item) => item.commandPath[0] === moduleName);
 }
+function levenshtein(a, b) {
+  const dp = Array.from({ length: a.length + 1 }, () => new Array(b.length + 1).fill(0));
+  for (let i = 0; i <= a.length; i += 1) dp[i][0] = i;
+  for (let j = 0; j <= b.length; j += 1) dp[0][j] = j;
+  for (let i = 1; i <= a.length; i += 1) {
+    for (let j = 1; j <= b.length; j += 1) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      dp[i][j] = Math.min(
+        dp[i - 1][j] + 1,
+        dp[i][j - 1] + 1,
+        dp[i - 1][j - 1] + cost
+      );
+    }
+  }
+  return dp[a.length][b.length];
+}
+function findCommandSuggestions(moduleName, commandName, limit = 3) {
+  const suggestions = [];
+  for (const scope of ["admin", "user"]) {
+    for (const command of listCommands(scope)) {
+      const [candidateModule, candidateCommand] = command.commandPath;
+      const moduleScore = candidateModule === moduleName ? 0 : levenshtein(candidateModule, moduleName || "");
+      const commandScore = candidateCommand === commandName ? 0 : levenshtein(candidateCommand, commandName || "");
+      const score = commandScore * 3 + moduleScore;
+      suggestions.push({
+        scope,
+        moduleName: candidateModule,
+        commandName: candidateCommand,
+        binary: scope === "admin" ? "arcubase-admin" : "arcubase",
+        score
+      });
+    }
+  }
+  return suggestions.sort((a, b) => a.score - b.score || a.binary.localeCompare(b.binary) || a.moduleName.localeCompare(b.moduleName) || a.commandName.localeCompare(b.commandName)).slice(0, limit);
+}
 
 // src/runtime/body_loader.ts
 import fs from "fs";
@@ -9657,10 +9696,671 @@ var typeIndex = {
   }
 };
 
+// src/runtime/entity_save_schema.ts
+var simpleFieldTypes = [
+  "text",
+  "textarea",
+  "number",
+  "datetime",
+  "boolean",
+  "button",
+  "address",
+  "datasets",
+  "department",
+  "departments",
+  "divider",
+  "file",
+  "image",
+  "location",
+  "member",
+  "members",
+  "signature",
+  "tags",
+  "workflow_status",
+  "mobile"
+];
+var enumFieldTypes = ["select", "selects", "radio", "checkbox", "status"];
+var relationFieldTypes = ["linkto", "relation", "query"];
+var strictFieldTypes = /* @__PURE__ */ new Set([
+  ...simpleFieldTypes,
+  ...enumFieldTypes,
+  ...relationFieldTypes,
+  "formula",
+  "lookup",
+  "relationfield",
+  "rollup",
+  "serialnumber",
+  "subform"
+]);
+var relationTypeSchema = external_exports.union([external_exports.literal("entity"), external_exports.literal("aggregation")]);
+var linkModeSchema = external_exports.union([external_exports.literal("manual"), external_exports.literal("auto")]);
+var linkStructureSchema = external_exports.union([external_exports.literal("single"), external_exports.literal("multiple")]);
+var enumItemSchema = external_exports.object({
+  key: external_exports.union([external_exports.number(), external_exports.string()]).optional(),
+  value: external_exports.string().min(1)
+}).passthrough();
+var statusItemSchema = external_exports.object({
+  key: external_exports.union([external_exports.number(), external_exports.string()]).optional(),
+  code: external_exports.union([external_exports.number(), external_exports.string()]),
+  value: external_exports.string().min(1)
+}).passthrough();
+var sortConfigSchema = external_exports.object({
+  column: external_exports.string().min(1),
+  order: external_exports.union([external_exports.literal("asc"), external_exports.literal("desc")])
+}).strict();
+var relationOptionsSchema = external_exports.object({
+  entity_id: external_exports.number().int().positive(),
+  app_id: external_exports.number().int().positive(),
+  type: relationTypeSchema,
+  show_fields: external_exports.array(external_exports.number().int().positive()).optional(),
+  condition: external_exports.record(external_exports.string(), external_exports.any()).optional(),
+  sorts: external_exports.array(sortConfigSchema).optional(),
+  queryFields: external_exports.array(external_exports.number().int().positive()).optional(),
+  subform_id: external_exports.number().int().positive().optional()
+}).strict();
+var lookupRelationSchema = external_exports.object({
+  local_linkto_field_id: external_exports.number().int().min(1001),
+  target_field_id: external_exports.number().int().min(1001),
+  target_field_type: external_exports.string().min(1)
+}).strict();
+var relationFieldRelationSchema = external_exports.object({
+  app_id: external_exports.number().int().positive(),
+  entity_id: external_exports.number().int().positive(),
+  type: relationTypeSchema.optional(),
+  show_fields: external_exports.array(external_exports.number().int().positive()).optional(),
+  condition: external_exports.record(external_exports.string(), external_exports.any()).optional(),
+  sorts: external_exports.array(sortConfigSchema).optional(),
+  queryFields: external_exports.array(external_exports.number().int().positive()).optional(),
+  subform_id: external_exports.number().int().positive().optional()
+}).strict();
+var formulaSchema = external_exports.object({
+  code: external_exports.string().min(1),
+  jsonlogic: external_exports.record(external_exports.string(), external_exports.any())
+}).strict();
+var serialPartBuildinStringSchema = external_exports.object({
+  mode: external_exports.literal("buildin"),
+  type: external_exports.literal("string"),
+  options: external_exports.object({
+    value: external_exports.string()
+  }).strict()
+}).strict();
+var serialPartBuildinDateSchema = external_exports.object({
+  mode: external_exports.literal("buildin"),
+  type: external_exports.literal("date"),
+  options: external_exports.object({
+    format: external_exports.string().optional(),
+    perdefined: external_exports.boolean().optional(),
+    perdefinedFormat: external_exports.string().optional()
+  }).strict().refine((value) => Boolean(value.format || value.perdefinedFormat), {
+    message: "date serial part requires format or perdefinedFormat"
+  })
+}).strict();
+var serialPartBuildinSerialSchema = external_exports.object({
+  mode: external_exports.literal("buildin"),
+  type: external_exports.literal("serial"),
+  options: external_exports.object({
+    length: external_exports.number().int().min(1),
+    lenfixed: external_exports.boolean().optional(),
+    random: external_exports.boolean().optional(),
+    reset: external_exports.string().optional()
+  }).strict()
+}).strict();
+var serialPartFieldSchema = external_exports.object({
+  mode: external_exports.literal("field"),
+  field_id: external_exports.number().int().min(1001)
+}).passthrough();
+var serialPartSchema = external_exports.union([
+  serialPartBuildinStringSchema,
+  serialPartBuildinDateSchema,
+  serialPartBuildinSerialSchema,
+  serialPartFieldSchema
+]);
+var fieldCommonShape = {
+  id: external_exports.number().int().min(1001),
+  label: external_exports.string().min(1),
+  required: external_exports.boolean(),
+  unique: external_exports.boolean(),
+  editable: external_exports.boolean(),
+  visible: external_exports.boolean(),
+  show_label: external_exports.boolean(),
+  scannable: external_exports.boolean(),
+  default_value_mode: external_exports.number(),
+  description: external_exports.string(),
+  value: external_exports.any(),
+  number_decimal: external_exports.number().int().min(0),
+  depends: external_exports.array(external_exports.number().int().min(1001)),
+  key: external_exports.string(),
+  code_index: external_exports.boolean(),
+  transfers: external_exports.array(external_exports.any()).nullable()
+};
+function isRecord(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function cloneJSON(value) {
+  return JSON.parse(JSON.stringify(value));
+}
+function makeSimpleFieldSchema(type) {
+  return external_exports.object({
+    ...fieldCommonShape,
+    type: external_exports.literal(type),
+    options: external_exports.record(external_exports.string(), external_exports.any()).nullable(),
+    children: external_exports.null()
+  }).strict();
+}
+function makeEnumFieldSchema(type) {
+  const itemSchema = type === "status" ? statusItemSchema : enumItemSchema;
+  return external_exports.object({
+    ...fieldCommonShape,
+    type: external_exports.literal(type),
+    options: external_exports.object({
+      options: external_exports.object({
+        items: external_exports.array(itemSchema).min(1)
+      }).passthrough()
+    }).passthrough(),
+    children: external_exports.null()
+  }).strict();
+}
+var simpleFieldSchemas = simpleFieldTypes.map((type) => makeSimpleFieldSchema(type));
+var enumFieldSchemas = enumFieldTypes.map((type) => makeEnumFieldSchema(type));
+var formulaFieldSchema = external_exports.object({
+  ...fieldCommonShape,
+  type: external_exports.literal("formula"),
+  options: external_exports.object({
+    formula: formulaSchema
+  }).passthrough(),
+  children: external_exports.null()
+}).strict();
+var relationFieldSchemas = relationFieldTypes.map(
+  (type) => external_exports.object({
+    ...fieldCommonShape,
+    type: external_exports.literal(type),
+    options: external_exports.object({
+      relation: relationOptionsSchema,
+      mode: linkModeSchema.optional(),
+      structure: linkStructureSchema.optional(),
+      multiple: external_exports.boolean().optional(),
+      backfill: external_exports.array(external_exports.object({
+        id: external_exports.number().int().min(1001),
+        local_id: external_exports.number().int().min(1001)
+      }).strict()).optional(),
+      addValue: external_exports.boolean().optional(),
+      placeholder: external_exports.string().optional()
+    }).passthrough(),
+    children: external_exports.null()
+  }).strict()
+);
+var lookupFieldSchema = external_exports.object({
+  ...fieldCommonShape,
+  type: external_exports.literal("lookup"),
+  options: external_exports.object({
+    relation: lookupRelationSchema
+  }).passthrough(),
+  children: external_exports.null()
+}).strict();
+var relationFieldFieldSchema = external_exports.object({
+  ...fieldCommonShape,
+  type: external_exports.literal("relationfield"),
+  options: external_exports.object({
+    relation: relationFieldRelationSchema
+  }).passthrough(),
+  children: external_exports.null()
+}).strict();
+var rollupFieldSchema = external_exports.object({
+  ...fieldCommonShape,
+  type: external_exports.literal("rollup"),
+  options: external_exports.object({
+    relation: lookupRelationSchema,
+    aggregation_formula: formulaSchema
+  }).passthrough(),
+  children: external_exports.null()
+}).strict();
+var serialNumberFieldSchema = external_exports.object({
+  ...fieldCommonShape,
+  type: external_exports.literal("serialnumber"),
+  options: external_exports.object({
+    parts: external_exports.array(serialPartSchema).min(1)
+  }).passthrough(),
+  children: external_exports.null()
+}).strict();
+var genericFieldSchema = external_exports.object({
+  ...fieldCommonShape,
+  type: external_exports.string().min(1).refine((value) => !strictFieldTypes.has(value), {
+    message: "known field type must use dedicated schema"
+  }),
+  options: external_exports.record(external_exports.string(), external_exports.any()).nullable(),
+  children: external_exports.null()
+}).strict();
+var baseFieldSchemaVariants = [
+  ...simpleFieldSchemas,
+  ...enumFieldSchemas,
+  ...relationFieldSchemas,
+  formulaFieldSchema,
+  lookupFieldSchema,
+  relationFieldFieldSchema,
+  rollupFieldSchema,
+  serialNumberFieldSchema,
+  genericFieldSchema
+];
+var BaseFieldSchema = external_exports.union(baseFieldSchemaVariants);
+var SubformFieldSchema = external_exports.lazy(
+  () => external_exports.object({
+    ...fieldCommonShape,
+    type: external_exports.literal("subform"),
+    options: external_exports.record(external_exports.string(), external_exports.any()).nullable(),
+    children: external_exports.array(BaseFieldSchema),
+    layout: external_exports.array(external_exports.array(external_exports.number().int().min(1001))).optional()
+  }).strict()
+);
+var FieldVOSchema = external_exports.lazy(
+  () => external_exports.union([
+    SubformFieldSchema,
+    BaseFieldSchema
+  ])
+);
+function normalizeEntitySaveInput(value) {
+  if (!isRecord(value)) {
+    return value;
+  }
+  const entity = cloneJSON(value);
+  if (entity.layout === null) {
+    entity.layout = [];
+  }
+  if (entity.current_serial === null) {
+    delete entity.current_serial;
+  }
+  if (isRecord(entity.options)) {
+    if (entity.options.Buttons === null) {
+      entity.options.Buttons = [];
+    }
+    if (entity.options.CustomActions === null) {
+      entity.options.CustomActions = [];
+    }
+    if (entity.options.FrontendEvents === null) {
+      entity.options.FrontendEvents = [];
+    }
+    if (entity.options.misc === null) {
+      entity.options.misc = {};
+    }
+    if (isRecord(entity.options.TitleFormat)) {
+      if (entity.options.TitleFormat.Fields === null) {
+        entity.options.TitleFormat.Fields = [];
+      }
+      if (entity.options.TitleFormat.Parts === null) {
+        entity.options.TitleFormat.Parts = [];
+      }
+    }
+  }
+  return entity;
+}
+function collectAllFieldIds(fields) {
+  const out = [];
+  for (const field of fields) {
+    out.push(field.id);
+    if (field.type === "subform" && Array.isArray(field.children)) {
+      for (const child of field.children) {
+        out.push(child.id);
+      }
+    }
+  }
+  return out;
+}
+function collectTopLevelFieldIds(fields) {
+  return fields.map((field) => field.id);
+}
+function extractFormulaFieldIds(value) {
+  if (!value || typeof value !== "string") return [];
+  const ids = [...value.matchAll(/:(\d+)\]\]/g)].map((match) => Number(match[1]));
+  return ids.filter((id) => Number.isInteger(id) && id > 0);
+}
+var EntitySaveReqVOBaseSchema = external_exports.object({
+  app_id: external_exports.number().optional(),
+  current_serial: EntitySerialUpdaterVOSchema.optional(),
+  field_id_seq: external_exports.number().int(),
+  fields: external_exports.array(FieldVOSchema),
+  id: external_exports.number().optional(),
+  layout: external_exports.array(external_exports.array(external_exports.number().int().min(1001))).optional(),
+  name: external_exports.string().optional(),
+  options: EntityOptionsSchema.optional(),
+  prototypes: external_exports.array(external_exports.number()).optional(),
+  schema_version: external_exports.number().optional(),
+  workflow_enabled: external_exports.boolean().optional()
+}).strict().superRefine((entity, ctx) => {
+  const fields = entity.fields;
+  const topLevelIds = new Set(collectTopLevelFieldIds(fields));
+  const allIds = collectAllFieldIds(fields);
+  const allIdSet = /* @__PURE__ */ new Set();
+  for (const id of allIds) {
+    if (allIdSet.has(id)) {
+      ctx.addIssue({
+        code: external_exports.ZodIssueCode.custom,
+        path: ["fields"],
+        message: `duplicate field id: ${id}`
+      });
+    }
+    allIdSet.add(id);
+  }
+  const maxFieldId = allIds.length > 0 ? Math.max(...allIds) : 1e3;
+  if (entity.field_id_seq <= maxFieldId) {
+    ctx.addIssue({
+      code: external_exports.ZodIssueCode.custom,
+      path: ["field_id_seq"],
+      message: `field_id_seq must be greater than max field id ${maxFieldId}`
+    });
+  }
+  for (const [rowIndex, row] of (entity.layout ?? []).entries()) {
+    for (const [colIndex, fieldId] of row.entries()) {
+      if (!topLevelIds.has(fieldId)) {
+        ctx.addIssue({
+          code: external_exports.ZodIssueCode.custom,
+          path: ["layout", rowIndex, colIndex],
+          message: `layout references unknown top-level field id ${fieldId}`
+        });
+      }
+    }
+  }
+  for (const [fieldIndex, field] of fields.entries()) {
+    if (field.type !== "subform" && field.children !== null) {
+      ctx.addIssue({
+        code: external_exports.ZodIssueCode.custom,
+        path: ["fields", fieldIndex, "children"],
+        message: "only subform field can define children"
+      });
+    }
+    if (field.type === "subform") {
+      const childIds = new Set((field.children ?? []).map((child) => child.id));
+      for (const [rowIndex, row] of (field.layout ?? []).entries()) {
+        for (const [colIndex, fieldId] of row.entries()) {
+          if (!childIds.has(fieldId)) {
+            ctx.addIssue({
+              code: external_exports.ZodIssueCode.custom,
+              path: ["fields", fieldIndex, "layout", rowIndex, colIndex],
+              message: `subform layout references non-child field id ${fieldId}`
+            });
+          }
+        }
+      }
+    }
+    if (field.type === "lookup" || field.type === "rollup") {
+      const localLinktoFieldId = field.options?.relation?.local_linkto_field_id;
+      if (typeof localLinktoFieldId === "number") {
+        const target = fields.find((item) => item.id === localLinktoFieldId);
+        if (!target || target.type !== "linkto") {
+          ctx.addIssue({
+            code: external_exports.ZodIssueCode.custom,
+            path: ["fields", fieldIndex, "options", "relation", "local_linkto_field_id"],
+            message: "local_linkto_field_id must reference a linkto field"
+          });
+        }
+      }
+    }
+    if (field.type === "formula" || field.type === "rollup") {
+      const formulaCode = field.type === "formula" ? field.options?.formula?.code : field.options?.aggregation_formula?.code;
+      for (const referencedFieldId of extractFormulaFieldIds(formulaCode)) {
+        if (!allIdSet.has(referencedFieldId)) {
+          ctx.addIssue({
+            code: external_exports.ZodIssueCode.custom,
+            path: ["fields", fieldIndex, "options"],
+            message: `formula references unknown field id ${referencedFieldId}`
+          });
+        }
+      }
+    }
+  }
+});
+var EntitySaveReqVOSchemaOverride = external_exports.preprocess(normalizeEntitySaveInput, EntitySaveReqVOBaseSchema);
+var queryOrderSchema = external_exports.object({
+  column: external_exports.string().min(1),
+  order: external_exports.string().min(1)
+}).strict();
+var AppCreateByTenantsReqVOSchemaOverride = external_exports.object({
+  icon_color: external_exports.string().optional(),
+  icon_name: external_exports.string().optional(),
+  name: external_exports.string().min(1).max(20)
+}).strict();
+var EntityQueryReqVOSchemaOverride = external_exports.object({
+  limit: external_exports.number().int().positive().optional(),
+  offset: external_exports.number().int().min(0).optional(),
+  policy_id: external_exports.string().optional(),
+  search: external_exports.record(external_exports.string(), external_exports.any()).optional(),
+  sorts: external_exports.array(queryOrderSchema).optional(),
+  view_mode: external_exports.string().optional(),
+  viewMode: external_exports.never().optional(),
+  withSubForm: external_exports.boolean().optional()
+}).strict();
+var InsertReqVOSchemaOverride = external_exports.object({
+  policy_id: external_exports.string().optional(),
+  fields: external_exports.record(external_exports.string(), external_exports.any())
+}).strict().superRefine((body, ctx) => {
+  for (const key of Object.keys(body.fields ?? {})) {
+    if (!/^\d+$/.test(key)) {
+      ctx.addIssue({
+        code: external_exports.ZodIssueCode.custom,
+        path: ["fields", key],
+        message: "row fields must use numeric field ids as keys"
+      });
+    }
+  }
+});
+var EntityUpdateReqVOSchemaOverride = external_exports.object({
+  changed_fields: external_exports.array(external_exports.number().int().positive()).min(1),
+  data: external_exports.record(external_exports.string(), external_exports.any()),
+  policy_id: external_exports.string().optional(),
+  tags: external_exports.array(external_exports.string()).optional(),
+  fields: external_exports.never().optional()
+}).strict().superRefine((body, ctx) => {
+  const dataFieldIds = /* @__PURE__ */ new Set();
+  for (const key of Object.keys(body.data ?? {})) {
+    if (!/^\d+$/.test(key)) {
+      ctx.addIssue({
+        code: external_exports.ZodIssueCode.custom,
+        path: ["data", key],
+        message: "row data must use numeric field ids as keys"
+      });
+      continue;
+    }
+    dataFieldIds.add(Number(key));
+  }
+  for (const [index, fieldId] of body.changed_fields.entries()) {
+    if (!dataFieldIds.has(fieldId)) {
+      ctx.addIssue({
+        code: external_exports.ZodIssueCode.custom,
+        path: ["changed_fields", index],
+        message: `changed_fields references ${fieldId}, but data does not contain that field id`
+      });
+    }
+  }
+});
+var entitySelectionSortSchema = external_exports.object({
+  column: external_exports.string().min(1),
+  order: external_exports.string().min(1)
+}).strict();
+var entitySelectionIdsSchema = external_exports.object({
+  type: external_exports.literal("ids"),
+  ids: external_exports.array(external_exports.number().int().positive()).min(1),
+  length: external_exports.number().int().positive().optional(),
+  sorts: external_exports.array(entitySelectionSortSchema).optional(),
+  condition: external_exports.record(external_exports.string(), external_exports.any()).optional()
+}).strict().superRefine((selection, ctx) => {
+  if (selection.length !== void 0 && selection.length !== selection.ids.length) {
+    ctx.addIssue({
+      code: external_exports.ZodIssueCode.custom,
+      path: ["length"],
+      message: "length must match ids.length when provided"
+    });
+  }
+});
+var entitySelectionConditionSchema = external_exports.object({
+  type: external_exports.literal("condition"),
+  length: external_exports.number().int().positive(),
+  condition: external_exports.record(external_exports.string(), external_exports.any()).superRefine((condition, ctx) => {
+    if (!Object.keys(condition).length) {
+      ctx.addIssue({
+        code: external_exports.ZodIssueCode.custom,
+        message: "condition selection requires a non-empty condition object"
+      });
+      return;
+    }
+    if (condition.selectAll !== true) {
+      ctx.addIssue({
+        code: external_exports.ZodIssueCode.custom,
+        path: ["selectAll"],
+        message: "condition selection must set selectAll to true"
+      });
+    }
+    const filterKeys = Object.keys(condition).filter((key) => key !== "selectAll");
+    if (filterKeys.length === 0) {
+      return;
+    }
+    const hasSupportedQueryKey = filterKeys.some((key) => key === "q" || key === "tab" || key.startsWith("filter_"));
+    if (!hasSupportedQueryKey) {
+      ctx.addIssue({
+        code: external_exports.ZodIssueCode.custom,
+        message: "condition selection extra keys must use q, tab, or filter_*"
+      });
+    }
+  }),
+  sorts: external_exports.array(entitySelectionSortSchema).optional(),
+  ids: external_exports.array(external_exports.number().int().positive()).optional()
+}).strict();
+var entitySelectionAllSchema = external_exports.object({
+  type: external_exports.literal("all"),
+  length: external_exports.number().int().positive().optional(),
+  ids: external_exports.array(external_exports.number().int().positive()).optional(),
+  condition: external_exports.record(external_exports.string(), external_exports.any()).optional(),
+  sorts: external_exports.array(entitySelectionSortSchema).optional()
+}).strict();
+var entitySelectionSchema = external_exports.union([
+  entitySelectionIdsSchema,
+  entitySelectionConditionSchema,
+  entitySelectionAllSchema
+]);
+var entitySelectionLooseSchema = external_exports.union([
+  entitySelectionSchema,
+  entitySelectionAllSchema
+]);
+var EntitySelectionActionReqVOSchemaOverride = external_exports.lazy(
+  () => external_exports.object({
+    limit: external_exports.number().int().positive().optional(),
+    offset: external_exports.number().int().min(0).optional(),
+    policy_id: external_exports.string().optional(),
+    selection: entitySelectionSchema
+  }).strict()
+);
+var bulkUpdateActionSchema = external_exports.object({
+  type: external_exports.string().min(1),
+  value: external_exports.any().optional(),
+  text_search: external_exports.string().optional(),
+  text_replace: external_exports.string().optional(),
+  text_append: external_exports.string().optional(),
+  text_prepend: external_exports.string().optional(),
+  number_add: external_exports.number().optional(),
+  number_mul: external_exports.number().optional(),
+  number_sub: external_exports.number().optional(),
+  datetime_add: external_exports.number().optional(),
+  datetime_sub: external_exports.number().optional()
+}).strict().superRefine((action, ctx) => {
+  switch (action.type) {
+    case "set":
+      if (!("value" in action)) {
+        ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path: ["value"], message: "set action requires value" });
+      }
+      break;
+    case "text_replace":
+      if (!action.text_search) {
+        ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path: ["text_search"], message: "text_replace requires text_search" });
+      }
+      if (!action.text_replace) {
+        ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path: ["text_replace"], message: "text_replace requires text_replace" });
+      }
+      break;
+    case "text_append":
+      if (!action.text_append) {
+        ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path: ["text_append"], message: "text_append requires text_append" });
+      }
+      break;
+    case "text_prepend":
+      if (!action.text_prepend) {
+        ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path: ["text_prepend"], message: "text_prepend requires text_prepend" });
+      }
+      break;
+    case "number_add":
+      if (typeof action.number_add !== "number") {
+        ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path: ["number_add"], message: "number_add requires number_add" });
+      }
+      break;
+    case "number_sub":
+      if (typeof action.number_sub !== "number") {
+        ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path: ["number_sub"], message: "number_sub requires number_sub" });
+      }
+      break;
+    case "number_mul":
+      if (typeof action.number_mul !== "number") {
+        ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path: ["number_mul"], message: "number_mul requires number_mul" });
+      }
+      break;
+    case "datetime_add":
+      if (typeof action.datetime_add !== "number") {
+        ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path: ["datetime_add"], message: "datetime_add requires datetime_add" });
+      }
+      break;
+    case "datetime_sub":
+      if (typeof action.datetime_sub !== "number") {
+        ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path: ["datetime_sub"], message: "datetime_sub requires datetime_sub" });
+      }
+      break;
+    case "datetime_now":
+    case "formula":
+      break;
+    default:
+      ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path: ["type"], message: `unsupported bulk update action type: ${action.type}` });
+  }
+});
+var EntityBulkUpdateReqVOSchemaOverride = external_exports.object({
+  policy_id: external_exports.string().optional(),
+  selection: entitySelectionSchema,
+  fields: external_exports.array(external_exports.object({
+    id: external_exports.number().int().min(1001),
+    action: bulkUpdateActionSchema
+  }).strict()).min(1)
+}).strict();
+var EntityTagsSelectionReqVOSchemaOverride = external_exports.object({
+  policy_id: external_exports.string(),
+  selection: entitySelectionSchema
+}).strict();
+var EntityTagsBatchReqVOSchemaOverride = external_exports.object({
+  policy_id: external_exports.string(),
+  selection: entitySelectionSchema,
+  tag_names: external_exports.array(external_exports.string().min(1)).min(1)
+}).strict();
+var EntityInvokeBatchOperatorReqVOSchemaOverride = external_exports.object({
+  id: external_exports.string().min(1),
+  data: external_exports.object({
+    action_id: external_exports.string().min(1),
+    policy_id: external_exports.string().optional(),
+    selection: entitySelectionLooseSchema
+  }).strict(),
+  params: external_exports.record(external_exports.string(), external_exports.any()).optional()
+}).strict();
+
 // src/runtime/zod_registry.ts
+var schemaOverrides = {
+  AppCreateByTenantsReqVO: AppCreateByTenantsReqVOSchemaOverride,
+  EntityBulkUpdateReqVO: EntityBulkUpdateReqVOSchemaOverride,
+  "EntityInvokeBatchOperatorReqVO & InvokeRequestVO": EntityInvokeBatchOperatorReqVOSchemaOverride,
+  EntityQueryReqVO: EntityQueryReqVOSchemaOverride,
+  EntitySaveReqVO: EntitySaveReqVOSchemaOverride,
+  EntitySelectionActionReqVO: EntitySelectionActionReqVOSchemaOverride,
+  "{ policy_id: string selection: any }": EntityTagsSelectionReqVOSchemaOverride,
+  "{ policy_id: string selection: any tag_names: string[] }": EntityTagsBatchReqVOSchemaOverride,
+  EntityUpdateReqVO: EntityUpdateReqVOSchemaOverride,
+  InsertReqVO: InsertReqVOSchemaOverride
+};
 function getBodySchema(typeName) {
   const name = String(typeName || "").trim();
   if (!name) return null;
+  if (schemaOverrides[name]) {
+    return schemaOverrides[name];
+  }
   return bodySchemas[name] ?? null;
 }
 function getUnsupportedBodySchemaReason(typeName) {
@@ -9668,6 +10368,60 @@ function getUnsupportedBodySchemaReason(typeName) {
   if (!name) return null;
   return unsupportedBodySchemas[name] ?? null;
 }
+var examplesIndexDocHint = {
+  title: "Examples index",
+  file: "/opt/arcubase-sdk/docs/runtime-reference/examples/README.md"
+};
+var omsExampleDocHint = {
+  title: "OMS example 01",
+  file: "/opt/arcubase-sdk/docs/runtime-reference/examples/oms-01/README.md"
+};
+var docHintIndex = {
+  AppCreateByTenantsReqVO: [
+    { title: "Table lifecycle", file: "/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md" },
+    examplesIndexDocHint,
+    omsExampleDocHint
+  ],
+  AppCreateEntityReqVO: [
+    { title: "Table lifecycle", file: "/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md" },
+    examplesIndexDocHint,
+    omsExampleDocHint
+  ],
+  EntitySaveReqVO: [
+    { title: "Entity schema", file: "/opt/arcubase-sdk/docs/runtime-reference/entity-schema.md" },
+    omsExampleDocHint
+  ],
+  EntityQueryReqVO: [
+    { title: "Row CRUD", file: "/opt/arcubase-sdk/docs/runtime-reference/row-crud.md" },
+    { title: "Search and bulk actions", file: "/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md" },
+    omsExampleDocHint
+  ],
+  EntityUpdateReqVO: [
+    { title: "Row CRUD", file: "/opt/arcubase-sdk/docs/runtime-reference/row-crud.md" },
+    omsExampleDocHint
+  ],
+  EntitySelectionActionReqVO: [
+    { title: "Search and bulk actions", file: "/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md" },
+    omsExampleDocHint
+  ],
+  InsertReqVO: [
+    { title: "Row CRUD", file: "/opt/arcubase-sdk/docs/runtime-reference/row-crud.md" },
+    omsExampleDocHint
+  ],
+  EntityBulkUpdateReqVO: [
+    { title: "Search and bulk actions", file: "/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md" },
+    omsExampleDocHint
+  ],
+  "EntityInvokeBatchOperatorReqVO & InvokeRequestVO": [
+    { title: "Search and bulk actions", file: "/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md" }
+  ],
+  "{ policy_id: string selection: any }": [
+    { title: "Search and bulk actions", file: "/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md" }
+  ],
+  "{ policy_id: string selection: any tag_names: string[] }": [
+    { title: "Search and bulk actions", file: "/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md" }
+  ]
+};
 function getTypeHints(typeName) {
   const name = String(typeName || "").trim();
   if (!name) return [];
@@ -9690,6 +10444,67 @@ function getTypeHints(typeName) {
   }
   return out;
 }
+function getDocHints(typeName) {
+  const name = String(typeName || "").trim();
+  if (!name) return [];
+  return docHintIndex[name] ?? [];
+}
+var commandDocHintIndex = {
+  "admin.app.createAppByTenants": [
+    { title: "Table lifecycle", file: "/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md" },
+    examplesIndexDocHint,
+    omsExampleDocHint
+  ],
+  "admin.app.createEntity": [
+    { title: "Table lifecycle", file: "/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md" },
+    omsExampleDocHint
+  ],
+  "admin.entity.adminGetEntityInfo": [
+    { title: "Table lifecycle", file: "/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md" },
+    omsExampleDocHint
+  ],
+  "admin.entity.adminSaveEntity": [
+    { title: "Entity schema", file: "/opt/arcubase-sdk/docs/runtime-reference/entity-schema.md" },
+    omsExampleDocHint
+  ],
+  "user.workflow.insertEntity": [
+    { title: "Row CRUD", file: "/opt/arcubase-sdk/docs/runtime-reference/row-crud.md" },
+    omsExampleDocHint
+  ],
+  "user.workflow.queryEntity": [
+    { title: "Search and bulk actions", file: "/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md" },
+    omsExampleDocHint
+  ],
+  "user.workflow.getEntityRow": [
+    { title: "Row CRUD", file: "/opt/arcubase-sdk/docs/runtime-reference/row-crud.md" },
+    omsExampleDocHint
+  ],
+  "user.workflow.updateEntityRow": [
+    { title: "Row CRUD", file: "/opt/arcubase-sdk/docs/runtime-reference/row-crud.md" },
+    omsExampleDocHint
+  ],
+  "user.workflow.queryEntitySelection": [
+    { title: "Search and bulk actions", file: "/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md" },
+    omsExampleDocHint
+  ],
+  "user.workflow.deleteEntityRow": [
+    { title: "Row CRUD", file: "/opt/arcubase-sdk/docs/runtime-reference/row-crud.md" },
+    omsExampleDocHint
+  ],
+  "user.workflow.restoreEntityRow": [
+    { title: "Row CRUD", file: "/opt/arcubase-sdk/docs/runtime-reference/row-crud.md" },
+    omsExampleDocHint
+  ],
+  "user.entity.updateEntityBulk": [
+    { title: "Search and bulk actions", file: "/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md" },
+    omsExampleDocHint
+  ]
+};
+function getCommandDocHints(operation) {
+  const key = String(operation || "").trim();
+  if (!key) return [];
+  return commandDocHintIndex[key] ?? [];
+}
 
 // src/runtime/execute.ts
 function renderRootHelp(scope) {
@@ -9704,7 +10519,8 @@ function renderRootHelp(scope) {
 function renderModuleHelp(scope, moduleName) {
   const items = listModuleCommands(scope, moduleName);
   if (items.length === 0) {
-    throw new CLIError("UNKNOWN_MODULE", `unknown module: ${moduleName}`, 2);
+    const suggestions = findCommandSuggestions(moduleName, "").map((item) => `${item.binary} ${item.moduleName} ${item.commandName}`);
+    throw new CLIError("UNKNOWN_MODULE", `unknown module: ${moduleName}`, 2, suggestions.length > 0 ? { suggestions } : void 0);
   }
   return [
     `${scope === "admin" ? "arcubase-admin" : "arcubase"} ${moduleName} <command> [flags]`,
@@ -9716,15 +10532,22 @@ function renderModuleHelp(scope, moduleName) {
 function renderCommandHelp(scope, moduleName, commandName) {
   const command = findCommand(scope, moduleName, commandName);
   if (!command) {
-    throw new CLIError("UNKNOWN_COMMAND", `unknown command: ${moduleName} ${commandName}`, 2);
+    const suggestions = findCommandSuggestions(moduleName, commandName).map((item) => `${item.binary} ${item.moduleName} ${item.commandName}`);
+    throw new CLIError("UNKNOWN_COMMAND", `unknown command: ${moduleName} ${commandName}`, 2, suggestions.length > 0 ? { suggestions } : void 0);
   }
+  const docHints = [
+    ...getCommandDocHints(`${scope}.${command.module}.${command.functionName}`),
+    ...command.requestType ? getDocHints(command.requestType) : []
+  ].filter((item, index, list) => list.findIndex((candidate) => candidate.file === item.file) === index);
   return [
     `${scope === "admin" ? "arcubase-admin" : "arcubase"} ${moduleName} ${commandName}`,
     `method: ${command.method}`,
     `endpoint: ${normalizeExternalEndpoint(command.endpoint)}`,
     command.requestType ? `body: ${command.requestType} via --body-file` : "body: none",
+    "query flags: --query-file",
     command.endpointParams.length ? `path flags: ${command.endpointParams.map((item) => `--${item.replace(/_/g, "-")}`).join(", ")}` : "path flags: none",
-    command.scalarParams.length ? `scalar flags: ${command.scalarParams.map((item) => `--${item.name.replace(/([A-Z])/g, "-$1").toLowerCase()}`).join(", ")}` : "scalar flags: none"
+    command.scalarParams.length ? `scalar flags: ${command.scalarParams.map((item) => `--${item.name.replace(/([A-Z])/g, "-$1").toLowerCase()}`).join(", ")}` : "scalar flags: none",
+    ...docHints.length > 0 ? ["docs:", ...docHints.map((item) => `  - ${item.title}: ${item.file}`)] : []
   ].join("\n");
 }
 function coerceScalar(value, typeText) {
@@ -9768,7 +10591,69 @@ function buildScalarQuery(command, flags) {
   }
   return Object.keys(out).length > 0 ? out : void 0;
 }
-async function executeCLI(scope, argv, env = loadRuntimeEnv(scope), fetchImpl = fetch) {
+function isRecord2(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function throwBodyValidationFailure(message, requestType, path, scope, command) {
+  throw new CLIError("BODY_VALIDATION_FAILED", message, 2, {
+    operation: `${scope}.${command.module}.${command.functionName}`,
+    requestType,
+    issues: [
+      {
+        path,
+        message
+      }
+    ],
+    tsHints: getTypeHints(requestType),
+    docHints: getDocHints(requestType)
+  });
+}
+function validateActionSpecificBody(scope, command, flags, body) {
+  if (!isRecord2(body) || !command.requestType) {
+    return;
+  }
+  if (command.module === "workflow" && command.functionName === "queryEntitySelection") {
+    const action = flagValue(flags, "action");
+    const selection = body.selection;
+    if (!isRecord2(selection) || typeof selection.type !== "string") {
+      return;
+    }
+    const type = selection.type;
+    const condition = isRecord2(selection.condition) ? selection.condition : void 0;
+    const conditionKeys = condition ? Object.keys(condition).filter((key) => key !== "selectAll") : [];
+    if (action === "query") {
+      if (type === "condition") {
+        throwBodyValidationFailure(
+          "selection.type=condition is not supported for action=query; use selection.type=ids or selection.type=all, or use workflow query-entity for search conditions",
+          command.requestType,
+          "body.selection.type",
+          scope,
+          command
+        );
+      }
+      return;
+    }
+    if ((action === "archive" || action === "delete" || action === "batch_print") && type === "all") {
+      throwBodyValidationFailure(
+        `selection.type=all is not supported for action=${action}; use ids or condition`,
+        command.requestType,
+        "body.selection.type",
+        scope,
+        command
+      );
+    }
+    if ((action === "archive" || action === "delete") && type === "condition" && conditionKeys.length === 0) {
+      throwBodyValidationFailure(
+        `selection.condition for action=${action} requires at least one q, tab, or filter_* key in addition to selectAll`,
+        command.requestType,
+        "body.selection.condition",
+        scope,
+        command
+      );
+    }
+  }
+}
+async function executeCLI(scope, argv, env, fetchImpl = fetch) {
   const parsed = parseCLIArgs(argv);
   if (parsed.commandTokens.length === 0) {
     return { kind: "help", text: renderRootHelp(scope) };
@@ -9783,6 +10668,7 @@ async function executeCLI(scope, argv, env = loadRuntimeEnv(scope), fetchImpl =
   if (hasFlag(parsed.flags, "help")) {
     return { kind: "help", text: renderCommandHelp(scope, moduleName, commandName) };
   }
+  const runtimeEnv = env ?? loadRuntimeEnv(scope);
   const command = findCommand(scope, moduleName, commandName);
   if (!command) {
     throw new CLIError("UNKNOWN_COMMAND", `unknown command: ${moduleName} ${commandName}`, 2);
@@ -9792,6 +10678,7 @@ async function executeCLI(scope, argv, env = loadRuntimeEnv(scope), fetchImpl =
   const fileQuery = loadQueryFromFlags(parsed.flags);
   const query = { ...scalarQuery ?? {}, ...fileQuery ?? {} };
   const body = loadBodyFromFlags(parsed.flags);
+  let validatedBody = body;
   if (command.requestType) {
     if (body === void 0) {
       throw new CLIError("MISSING_BODY_FILE", `command requires --body-file for ${command.requestType}`, 2);
@@ -9811,10 +10698,13 @@ async function executeCLI(scope, argv, env = loadRuntimeEnv(scope), fetchImpl =
               path: issue.path.length > 0 ? `body.${issue.path.join(".")}` : "body",
               message: issue.message
             })),
-            tsHints: getTypeHints(command.requestType)
+            tsHints: getTypeHints(command.requestType),
+            docHints: getDocHints(command.requestType)
           }
         );
       }
+      validatedBody = parsedBody.data;
+      validateActionSpecificBody(scope, command, parsed.flags, validatedBody);
     } else {
       const unsupportedReason = getUnsupportedBodySchemaReason(command.requestType);
       if (unsupportedReason) {
@@ -9822,19 +10712,19 @@ async function executeCLI(scope, argv, env = loadRuntimeEnv(scope), fetchImpl =
           operation: `${scope}.${command.module}.${command.functionName}`,
           requestType: command.requestType,
           reason: unsupportedReason,
-          tsHints: getTypeHints(command.requestType)
+          tsHints: getTypeHints(command.requestType),
+          docHints: getDocHints(command.requestType)
         });
       }
     }
   }
-  const headers = buildRequestHeaders(env);
-  const response = await fetchImpl(buildURL(env.ARCUBASE_BASE_URL, endpoint, Object.keys(query).length > 0 ? query : void 0), {
+  const response = await fetchImpl(buildURL(runtimeEnv.ARCUBASE_BASE_URL, endpoint, Object.keys(query).length > 0 ? query : void 0), {
     method: command.method,
     headers: {
-      ...headers,
+      ...buildRequestHeaders(runtimeEnv),
       "Content-Type": "application/json"
     },
-    body: body === void 0 || command.method === "GET" ? void 0 : JSON.stringify(body)
+    body: validatedBody === void 0 || command.method === "GET" ? void 0 : JSON.stringify(validatedBody)
   });
   const raw = await response.text();
   let parsedResponse = raw;
@@ -9845,6 +10735,17 @@ async function executeCLI(scope, argv, env = loadRuntimeEnv(scope), fetchImpl =
   if (!response.ok) {
     throw new CLIError("UPSTREAM_REQUEST_FAILED", typeof parsedResponse === "string" ? parsedResponse : JSON.stringify(parsedResponse), 1);
   }
+  if (parsedResponse && typeof parsedResponse === "object" && "error" in parsedResponse && parsedResponse.error) {
+    const upstreamError = parsedResponse.error;
+    const upstreamMessage = typeof upstreamError === "object" && upstreamError && "message" in upstreamError && typeof upstreamError.message === "string" ? upstreamError.message : typeof upstreamError === "string" ? upstreamError : JSON.stringify(upstreamError);
+    const traceId = typeof parsedResponse.trace_id === "string" ? parsedResponse.trace_id : typeof parsedResponse.request_id === "string" ? parsedResponse.request_id : void 0;
+    throw new CLIError("UPSTREAM_BODY_ERROR", upstreamMessage, 1, {
+      endpoint,
+      method: command.method,
+      traceId,
+      upstreamError
+    });
+  }
   return {
     kind: "result",
     commandPath: command.commandPath,