@carthooks/arcubase-cli 0.1.4 → 0.1.5

package/src/generated/command_registry.generated.ts

@@ -103,6 +103,22 @@ export const adminCommands = [
     "scalarParams": [],
     "responseType": "AppCreateByTenantsRespVO"
   },
+  {
+    "scope": "admin",
+    "module": "app",
+    "functionName": "listApps",
+    "commandPath": [
+      "app",
+      "list-apps"
+    ],
+    "method": "GET",
+    "endpoint": "/apps",
+    "endpointParams": [],
+    "controller": "App.ListApps",
+    "requestType": null,
+    "scalarParams": [],
+    "responseType": "AppListRespVO"
+  },
   {
     "scope": "admin",
     "module": "app",
@@ -3108,88 +3124,6 @@ export const adminCommands = [
       }
     ],
     "responseType": "TenantUsageDailyRespVO"
-  },
-  {
-    "scope": "admin",
-    "module": "workflow",
-    "functionName": "deployEntityWorkflow",
-    "commandPath": [
-      "workflow",
-      "deploy-entity-workflow"
-    ],
-    "method": "POST",
-    "endpoint": "/apps/:app_id/entity/:entity_id/workflow/deploy",
-    "endpointParams": [
-      "app_id",
-      "entity_id"
-    ],
-    "controller": "Entity.WorkflowDeploy",
-    "requestType": "EntityWorkflowDeployReqVO",
-    "scalarParams": [],
-    "responseType": "EntityWorkflowDeployRespVO"
-  },
-  {
-    "scope": "admin",
-    "module": "workflow",
-    "functionName": "getEntityWorkflow",
-    "commandPath": [
-      "workflow",
-      "get-entity-workflow"
-    ],
-    "method": "GET",
-    "endpoint": "/apps/:app_id/entity/:entity_id/workflow",
-    "endpointParams": [
-      "app_id",
-      "entity_id"
-    ],
-    "controller": "Entity.WorkflowGet",
-    "requestType": null,
-    "scalarParams": [
-      {
-        "name": "workingId",
-        "type": "string",
-        "hasDefault": true
-      }
-    ],
-    "responseType": "EntityWorkflowGetRespVO"
-  },
-  {
-    "scope": "admin",
-    "module": "workflow",
-    "functionName": "createEntityWorkflowVersion",
-    "commandPath": [
-      "workflow",
-      "create-entity-workflow-version"
-    ],
-    "method": "POST",
-    "endpoint": "/apps/:app_id/entity/:entity_id/workflow/new",
-    "endpointParams": [
-      "app_id",
-      "entity_id"
-    ],
-    "controller": "Entity.WorkflowNewVersion",
-    "requestType": null,
-    "scalarParams": [],
-    "responseType": "EntityWorkflowNewVersionRespVO"
-  },
-  {
-    "scope": "admin",
-    "module": "workflow",
-    "functionName": "updateEntityWorkflow",
-    "commandPath": [
-      "workflow",
-      "update-entity-workflow"
-    ],
-    "method": "POST",
-    "endpoint": "/apps/:app_id/entity/:entity_id/workflow",
-    "endpointParams": [
-      "app_id",
-      "entity_id"
-    ],
-    "controller": "Entity.WorkflowUpdate",
-    "requestType": "EntityWorkflowUpdateReqVO",
-    "scalarParams": [],
-    "responseType": "EntityWorkflowUpdateRespVO"
   }
 ] as const
 
@@ -4307,10 +4241,10 @@ export const userCommands = [
   },
   {
     "scope": "user",
-    "module": "workflow",
+    "module": "rows",
     "functionName": "putEntityQueryKeeper",
     "commandPath": [
-      "workflow",
+      "rows",
       "put-entity-query-keeper"
     ],
     "method": "POST",
@@ -4326,10 +4260,10 @@ export const userCommands = [
   },
   {
     "scope": "user",
-    "module": "workflow",
+    "module": "rows",
     "functionName": "queryEntity",
     "commandPath": [
-      "workflow",
+      "rows",
       "query-entity"
     ],
     "method": "POST",
@@ -4345,10 +4279,10 @@ export const userCommands = [
   },
   {
     "scope": "user",
-    "module": "workflow",
+    "module": "rows",
     "functionName": "filterEntityQuery",
     "commandPath": [
-      "workflow",
+      "rows",
       "filter-entity-query"
     ],
     "method": "POST",
@@ -4364,10 +4298,10 @@ export const userCommands = [
   },
   {
     "scope": "user",
-    "module": "workflow",
+    "module": "rows",
     "functionName": "queryEntitySelection",
     "commandPath": [
-      "workflow",
+      "rows",
       "query-entity-selection"
     ],
     "method": "POST",
@@ -4384,29 +4318,10 @@ export const userCommands = [
   },
   {
     "scope": "user",
-    "module": "workflow",
-    "functionName": "resolveEntityWorkflow",
-    "commandPath": [
-      "workflow",
-      "resolve-entity-workflow"
-    ],
-    "method": "POST",
-    "endpoint": "/entity/:app_id/:entity_id/resolve-workflow",
-    "endpointParams": [
-      "app_id",
-      "entity_id"
-    ],
-    "controller": "UserAction.EntityResolveWorkflow",
-    "requestType": "EntityResolveWorkflowReqVO",
-    "scalarParams": [],
-    "responseType": "EntityResolveWorkflowRespVO"
-  },
-  {
-    "scope": "user",
-    "module": "workflow",
+    "module": "rows",
     "functionName": "getEntityRow",
     "commandPath": [
-      "workflow",
+      "rows",
       "get-entity-row"
     ],
     "method": "GET",
@@ -4429,10 +4344,10 @@ export const userCommands = [
   },
   {
     "scope": "user",
-    "module": "workflow",
+    "module": "rows",
     "functionName": "deleteEntityRow",
     "commandPath": [
-      "workflow",
+      "rows",
       "delete-entity-row"
     ],
     "method": "POST",
@@ -4448,10 +4363,10 @@ export const userCommands = [
   },
   {
     "scope": "user",
-    "module": "workflow",
+    "module": "rows",
     "functionName": "restoreEntityRow",
     "commandPath": [
-      "workflow",
+      "rows",
       "restore-entity-row"
     ],
     "method": "POST",
@@ -4467,10 +4382,10 @@ export const userCommands = [
   },
   {
     "scope": "user",
-    "module": "workflow",
+    "module": "rows",
     "functionName": "updateEntityRow",
     "commandPath": [
-      "workflow",
+      "rows",
       "update-entity-row"
     ],
     "method": "PUT",
@@ -4487,10 +4402,10 @@ export const userCommands = [
   },
   {
     "scope": "user",
-    "module": "workflow",
+    "module": "rows",
     "functionName": "validateEntityUniq",
     "commandPath": [
-      "workflow",
+      "rows",
       "validate-entity-uniq"
     ],
     "method": "POST",
@@ -4506,10 +4421,10 @@ export const userCommands = [
   },
   {
     "scope": "user",
-    "module": "workflow",
+    "module": "rows",
     "functionName": "insertEntity",
     "commandPath": [
-      "workflow",
+      "rows",
       "insert-entity"
     ],
     "method": "POST",
@@ -4525,10 +4440,10 @@ export const userCommands = [
   },
   {
     "scope": "user",
-    "module": "workflow",
+    "module": "rows",
     "functionName": "prepareEntityInsert",
     "commandPath": [
-      "workflow",
+      "rows",
       "prepare-entity-insert"
     ],
     "method": "POST",
@@ -4544,48 +4459,10 @@ export const userCommands = [
   },
   {
     "scope": "user",
-    "module": "workflow",
-    "functionName": "queryEntityWorkflowApproveUsers",
-    "commandPath": [
-      "workflow",
-      "query-entity-workflow-approve-users"
-    ],
-    "method": "POST",
-    "endpoint": "/entity/:app_id/:entity_id/query-approve-users",
-    "endpointParams": [
-      "app_id",
-      "entity_id"
-    ],
-    "controller": "UserAction.EntityWorkflowApproveUsers",
-    "requestType": null,
-    "scalarParams": [],
-    "responseType": "EntityWorkflowApproveUsersRespVO"
-  },
-  {
-    "scope": "user",
-    "module": "workflow",
-    "functionName": "queryEntityWorkflowNodes",
-    "commandPath": [
-      "workflow",
-      "query-entity-workflow-nodes"
-    ],
-    "method": "POST",
-    "endpoint": "/entity/:app_id/:entity_id/query-workflow-nodes",
-    "endpointParams": [
-      "app_id",
-      "entity_id"
-    ],
-    "controller": "UserAction.EntityWorkflowNodes",
-    "requestType": null,
-    "scalarParams": [],
-    "responseType": "EntityWorkflowNodesRespVO"
-  },
-  {
-    "scope": "user",
-    "module": "workflow",
+    "module": "rows",
     "functionName": "getEntitySubformItems",
     "commandPath": [
-      "workflow",
+      "rows",
       "get-entity-subform-items"
     ],
     "method": "POST",

package/src/generated/type_index.generated.ts

@@ -282,10 +282,6 @@ export const typeIndex = {
     "file": "/opt/arcubase-sdk/types/user-action.ts",
     "dependencies": []
   },
-  "EntityResolveWorkflowReqVO": {
-    "file": "/opt/arcubase-sdk/types/user-action.ts",
-    "dependencies": []
-  },
   "EntitySaveCustomKeysReqVO": {
     "file": "/opt/arcubase-sdk/types/entity.ts",
     "dependencies": [
@@ -344,14 +340,6 @@ export const typeIndex = {
     "file": "/opt/arcubase-sdk/types/common.ts",
     "dependencies": []
   },
-  "EntityWorkflowDeployReqVO": {
-    "file": "/opt/arcubase-sdk/types/workflow.ts",
-    "dependencies": []
-  },
-  "EntityWorkflowUpdateReqVO": {
-    "file": "/opt/arcubase-sdk/types/workflow.ts",
-    "dependencies": []
-  },
   "FetchWidgetsDataReqVO": {
     "file": "/opt/arcubase-sdk/types/user-action.ts",
     "dependencies": []

package/src/generated/zod_registry.generated.ts

@@ -268,8 +268,6 @@ export const EntityQueryOrderVOSchema: z.ZodTypeAny = z.lazy(() => z.object({ "c
 
 export const EntityQueryReqVOSchema: z.ZodTypeAny = z.lazy(() => z.object({ "limit": z.number().optional(), "offset": z.number().optional(), "policy_id": z.string().optional(), "search": z.record(z.string(), z.any()).optional(), "sorts": z.array(EntityQueryOrderVOSchema).optional(), "view_mode": z.string().optional(), "withSubForm": z.boolean().optional() }).strict())
 
-export const EntityResolveWorkflowReqVOSchema: z.ZodTypeAny = z.lazy(() => z.object({ "approve_users": z.array(z.number()).optional(), "closeCurrentTasks": z.boolean().optional(), "node_id": z.number().optional(), "policy_id": z.string().optional(), "record_id": z.number().optional(), "version_id": z.number().optional() }).strict())
-
 export const EntitySaveCustomKeysFieldVOSchema: z.ZodTypeAny = z.lazy(() => z.object({ "id": z.number().optional(), "key": z.string().optional() }).strict())
 
 export const EntitySaveCustomKeysReqVOSchema: z.ZodTypeAny = z.lazy(() => z.array(EntitySaveCustomKeysFieldVOSchema))
@@ -314,34 +312,6 @@ export const EntityValidateUniqFieldVOSchema: z.ZodTypeAny = z.lazy(() => z.obje
 
 export const EntityValidateUniqReqVOSchema: z.ZodTypeAny = z.lazy(() => z.object({ "fields": z.array(EntityValidateUniqFieldVOSchema).optional(), "record_id": z.number().optional() }).strict())
 
-export const ActionBulkUpdateActionSchema: z.ZodTypeAny = z.lazy(() => z.object({ "number_add": z.number().optional(), "number_mul": z.number().optional(), "number_sub": z.number().optional(), "text_append": z.string().optional(), "text_prepend": z.string().optional(), "text_replace": z.string().optional(), "text_search": z.string().optional(), "type": z.string().optional(), "value": z.any().optional() }).strict())
-
-export const ActionBulkUpdateSchema: z.ZodTypeAny = z.lazy(() => z.object({ "action": ActionBulkUpdateActionSchema.optional(), "id": z.number().optional() }).strict())
-
-export const WorkflowActionConfigSchema: z.ZodTypeAny = z.lazy(() => z.object({ "enabled": z.boolean().optional(), "options": z.object({ "comment_required": z.boolean().optional(), "desc": z.string().optional(), "modifiers": z.array(ActionBulkUpdateSchema).optional() }).strict().optional() }).strict())
-
-export const WorkflowVoteTypeSchema: z.ZodTypeAny = z.lazy(() => z.union([z.literal(0), z.literal(1)]))
-
-export const NotificationWebhookConfigSchema: z.ZodTypeAny = z.lazy(() => z.object({ "mode": NotificationPayloadModeSchema.optional(), "template": z.string().optional(), "url": z.string().optional(), "version": z.string().optional() }).strict())
-
-export const WorkflowConfigNodeSchema: z.ZodTypeAny = z.lazy(() => z.object({ "data": z.object({ "actions": z.record(z.string(), WorkflowActionConfigSchema).optional(), "approver_actions": z.array(z.number()).optional(), "approvers": z.array(PermitUserScopeSchema).optional(), "auto_forward": z.boolean().optional(), "cc": z.array(PermitUserScopeSchema).optional(), "fields": z.array(z.number()).optional(), "notify_email": z.boolean().optional(), "notify_email_tmpl": z.object({ "body": z.string().optional(), "subject": z.string().optional() }).strict().optional(), "submit_condition": z.array(z.number()).optional(), "use_cc": z.boolean().optional(), "vote_type": WorkflowVoteTypeSchema.optional(), "webhooks": z.array(NotificationWebhookConfigSchema).optional() }).strict().optional(), "events": z.array(z.number()).optional(), "id": z.string().optional(), "label": z.string().optional(), "mode": z.string().optional(), "position": z.array(z.number()).optional(), "type": z.string().optional() }).strict())
-
-export const WorkflowConfigDiagramSchema: z.ZodTypeAny = z.lazy(() => z.object({ "edges": z.array(z.number()).optional(), "id_seq": z.number().optional(), "nodes": z.array(WorkflowConfigNodeSchema).optional(), "viewport": z.array(z.number()).optional() }).strict())
-
-export const WorkflowAutoApproveRuleSchema: z.ZodTypeAny = z.lazy(() => z.union([z.literal(1), z.literal(2), z.literal(3)]))
-
-export const WorkflowRetractRuleSchema: z.ZodTypeAny = z.lazy(() => z.union([z.literal(1), z.literal(2), z.literal(3)]))
-
-export const WorkflowSLATriggerSchema: z.ZodTypeAny = z.lazy(() => z.object({ "hasUpdateField": z.boolean().optional(), "hasWebhook": z.boolean().optional(), "modifiers": z.array(ActionBulkUpdateSchema).optional(), "time_point": z.number().optional(), "webhook": NotificationWebhookConfigSchema.optional() }).strict())
-
-export const WorkflowSLAConfigSchema: z.ZodTypeAny = z.lazy(() => z.object({ "ddl": z.number().optional(), "enabled": z.boolean().optional(), "id": z.string().optional(), "name": z.string().optional(), "nodes": z.array(z.string()).optional(), "triggers": z.array(WorkflowSLATriggerSchema).optional() }).strict())
-
-export const WorkflowOptionsSchema: z.ZodTypeAny = z.lazy(() => z.object({ "allow_urge": z.boolean().optional(), "allow_view_diagram": z.boolean().optional(), "auto_approve_rule": WorkflowAutoApproveRuleSchema.optional(), "retract_rule": WorkflowRetractRuleSchema.optional(), "sla": z.array(WorkflowSLAConfigSchema).optional() }).strict())
-
-export const EntityWorkflowDeployReqVOSchema: z.ZodTypeAny = z.lazy(() => z.object({ "diagram": WorkflowConfigDiagramSchema.optional(), "id": z.number().optional(), "options": WorkflowOptionsSchema.optional() }).strict())
-
-export const EntityWorkflowUpdateReqVOSchema: z.ZodTypeAny = z.lazy(() => z.object({ "diagram": WorkflowConfigDiagramSchema.optional(), "id": z.number().optional(), "options": WorkflowOptionsSchema.optional() }).strict())
-
 export const EntityUtilsQueryOrderSchema: z.ZodTypeAny = z.lazy(() => z.object({ "column": z.string().optional(), "order": z.string().optional() }).strict())
 
 export const FetchWidgetsDataReqVOSchema: z.ZodTypeAny = z.lazy(() => z.object({ "dashboard_id": z.number().optional(), "ingress_hash_id": z.string().optional(), "ingress_id": z.number().optional(), "querys": z.object({ "search": z.record(z.string(), z.any()).optional(), "sorts": z.array(EntityUtilsQueryOrderSchema).optional() }).strict().optional(), "type": WidgetsTypeCodeSchema.optional() }).strict())
@@ -518,7 +488,6 @@ export const generatedRequestTypes = [
   "EntityQueryLinkToValuesReqVO",
   "EntityQueryRelationReqVO",
   "EntityQueryReqVO",
-  "EntityResolveWorkflowReqVO",
   "EntitySaveCustomKeysReqVO",
   "EntitySaveNameReqVO",
   "EntitySaveReqVO",
@@ -531,8 +500,6 @@ export const generatedRequestTypes = [
   "EntityUpdateReqVO",
   "EntityUpdateSuccessScreenReqVO",
   "EntityValidateUniqReqVO",
-  "EntityWorkflowDeployReqVO",
-  "EntityWorkflowUpdateReqVO",
   "FetchWidgetsDataReqVO",
   "GetOrganizationTreeReqVO",
   "GetOrganizationUsersReqVO",
@@ -648,7 +615,6 @@ export const bodySchemas = {
   "EntityQueryLinkToValuesReqVO": EntityQueryLinkToValuesReqVOSchema,
   "EntityQueryRelationReqVO": EntityQueryRelationReqVOSchema,
   "EntityQueryReqVO": EntityQueryReqVOSchema,
-  "EntityResolveWorkflowReqVO": EntityResolveWorkflowReqVOSchema,
   "EntitySaveCustomKeysReqVO": EntitySaveCustomKeysReqVOSchema,
   "EntitySaveNameReqVO": EntitySaveNameReqVOSchema,
   "EntitySaveReqVO": EntitySaveReqVOSchema,
@@ -661,8 +627,6 @@ export const bodySchemas = {
   "EntityUpdateReqVO": EntityUpdateReqVOSchema,
   "EntityUpdateSuccessScreenReqVO": EntityUpdateSuccessScreenReqVOSchema,
   "EntityValidateUniqReqVO": EntityValidateUniqReqVOSchema,
-  "EntityWorkflowDeployReqVO": EntityWorkflowDeployReqVOSchema,
-  "EntityWorkflowUpdateReqVO": EntityWorkflowUpdateReqVOSchema,
   "FetchWidgetsDataReqVO": FetchWidgetsDataReqVOSchema,
   "GetOrganizationTreeReqVO": GetOrganizationTreeReqVOSchema,
   "GetOrganizationUsersReqVO": GetOrganizationUsersReqVOSchema,

package/src/runtime/command_registry.ts

@@ -3,10 +3,46 @@ import { adminCommands, userCommands } from '../generated/command_registry.gener
 export { adminCommands, userCommands }
 
 export type CommandScope = 'admin' | 'user'
-export type CommandDef = (typeof adminCommands)[number] | (typeof userCommands)[number]
+type GeneratedCommandDef = (typeof adminCommands)[number] | (typeof userCommands)[number]
+
+type CustomCommandDef = {
+  scope: CommandScope
+  module: string
+  functionName: string
+  commandPath: readonly [string, string]
+  method: string
+  endpoint: string
+  endpointParams: readonly string[]
+  controller: string
+  requestType: string | null
+  scalarParams: readonly { name: string; type: string; hasDefault: boolean }[]
+  responseType: string
+}
+
+export type CommandDef = GeneratedCommandDef | CustomCommandDef
+
+const customAdminCommands: readonly CustomCommandDef[] = [
+  {
+    scope: 'admin',
+    module: 'app',
+    functionName: 'inventory',
+    commandPath: ['app', 'inventory'],
+    method: 'GET',
+    endpoint: '/apps',
+    endpointParams: [],
+    controller: 'Runtime.AppInventory',
+    requestType: null,
+    scalarParams: [],
+    responseType: 'AppInventoryRespVO',
+  },
+] as const
+
+const customUserCommands: readonly CustomCommandDef[] = []
 
 export function listCommands(scope: CommandScope): readonly CommandDef[] {
-  return scope === 'admin' ? adminCommands : userCommands
+  return scope === 'admin'
+    ? [...adminCommands, ...customAdminCommands]
+    : [...userCommands, ...customUserCommands]
 }
 
 export function findCommand(scope: CommandScope, moduleName: string, commandName: string): CommandDef | null {

package/src/runtime/execute.ts

@@ -23,10 +23,118 @@ type CustomUploadSummary = {
   data: ReturnType<typeof summarizeUploadResult>
 }
 
+type AppInventoryItem = {
+  id: string
+  name: string
+  entities: Array<{ id: string; name: string }>
+}
+
 function summarizeUploadResult(value: Awaited<ReturnType<typeof uploadLocalFile>>) {
   return value
 }
 
+function parseJSONResponse(raw: string): unknown {
+  if (!raw) return null
+  try {
+    return JSON.parse(raw)
+  } catch {
+    return raw
+  }
+}
+
+function unwrapResponseData(payload: unknown): unknown {
+  return isRecord(payload) && 'data' in payload ? payload.data : payload
+}
+
+function formatUpstreamError(payload: unknown): string {
+  if (typeof payload === 'string') {
+    return payload
+  }
+  if (isRecord(payload) && isRecord(payload.error) && typeof payload.error.message === 'string') {
+    return payload.error.message
+  }
+  return JSON.stringify(payload)
+}
+
+function extractApps(payload: unknown): Array<{ id: string; name: string }> {
+  const data = unwrapResponseData(payload)
+  if (!Array.isArray(data)) return []
+  return data
+    .filter((item): item is Record<string, unknown> => isRecord(item))
+    .filter((item) => item.id !== undefined && typeof item.name === 'string')
+    .map((item) => ({
+      id: String(item.id),
+      name: item.name as string,
+    }))
+}
+
+function extractEntities(payload: unknown): Array<{ id: string; name: string }> {
+  const data = unwrapResponseData(payload)
+  if (!Array.isArray(data)) return []
+  return data
+    .filter((item): item is Record<string, unknown> => isRecord(item))
+    .filter((item) => item.id !== undefined && typeof item.name === 'string')
+    .map((item) => ({
+      id: String(item.id),
+      name: item.name as string,
+    }))
+}
+
+async function executeAppInventory(runtimeEnv: RuntimeEnv, fetchImpl: typeof fetch) {
+  const appsResponse = await fetchImpl(buildURL(runtimeEnv.ARCUBASE_BASE_URL, '/apps'), {
+    method: 'GET',
+    headers: buildRequestHeaders(runtimeEnv),
+  })
+  const appsRaw = await appsResponse.text()
+  const appsPayload = parseJSONResponse(appsRaw)
+  if (!appsResponse.ok) {
+    throw new CLIError('UPSTREAM_REQUEST_FAILED', formatUpstreamError(appsPayload), 1)
+  }
+  if (isRecord(appsPayload) && appsPayload.error) {
+    throw new CLIError('UPSTREAM_BODY_ERROR', formatUpstreamError(appsPayload), 1, {
+      endpoint: '/apps',
+      method: 'GET',
+      upstreamError: appsPayload.error,
+    })
+  }
+  const apps = extractApps(appsPayload)
+  const items: AppInventoryItem[] = []
+  for (const app of apps) {
+    const entitiesResponse = await fetchImpl(buildURL(runtimeEnv.ARCUBASE_BASE_URL, `/apps/${encodeURIComponent(app.id)}/entities`), {
+      method: 'POST',
+      headers: {
+        ...buildRequestHeaders(runtimeEnv),
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify({}),
+    })
+    const entitiesRaw = await entitiesResponse.text()
+    const entitiesPayload = parseJSONResponse(entitiesRaw)
+    if (!entitiesResponse.ok) {
+      throw new CLIError('UPSTREAM_REQUEST_FAILED', formatUpstreamError(entitiesPayload), 1)
+    }
+    if (isRecord(entitiesPayload) && entitiesPayload.error) {
+      throw new CLIError('UPSTREAM_BODY_ERROR', formatUpstreamError(entitiesPayload), 1, {
+        endpoint: `/apps/${app.id}/entities`,
+        method: 'POST',
+        upstreamError: entitiesPayload.error,
+      })
+    }
+    items.push({
+      ...app,
+      entities: extractEntities(entitiesPayload),
+    })
+  }
+  return {
+    kind: 'result',
+    commandPath: ['app', 'inventory'] as const,
+    status: 200,
+    data: {
+      apps: items,
+    },
+  }
+}
+
 export function renderRootHelp(scope: CommandScope): string {
   const binary = scope === 'admin' ? 'arcubase-admin' : 'arcubase'
   const items = listModules(scope).map((item) => `  - ${item}`)
@@ -35,7 +143,7 @@ export function renderRootHelp(scope: CommandScope): string {
     '',
     ...(scope === 'admin'
       ? ['use arcubase-admin for app, entity shell, and schema management', '']
-      : ['use arcubase for row CRUD, search, selection actions, and bulk actions', '']),
+      : ['use arcubase for rows, search, selection actions, and bulk actions', '']),
     'modules:',
     ...items,
     ...(scope === 'user' ? ['','special commands:','  - upload <local-file>'] : []),
@@ -53,7 +161,7 @@ export function renderModuleHelp(scope: CommandScope, moduleName: string): strin
     '',
     ...(scope === 'admin'
       ? ['use arcubase-admin for app, entity shell, and schema management', '']
-      : ['use arcubase for row CRUD, search, selection actions, and bulk actions', '']),
+      : ['use arcubase for rows, search, selection actions, and bulk actions', '']),
     'commands:',
     ...items.map((item) => `  - ${item.commandPath[1]}`),
   ].join('\n')
@@ -61,11 +169,11 @@ export function renderModuleHelp(scope: CommandScope, moduleName: string): strin
 
 function buildUnknownCommandDetails(scope: CommandScope, moduleName: string, commandName: string): { suggestions?: string[]; reason?: string; hint?: string } | undefined {
   const suggestions = findCommandSuggestions(moduleName, commandName).map((item) => `${item.binary} ${item.moduleName} ${item.commandName}`)
-  if (scope === 'admin' && moduleName === 'workflow' && suggestions.some((item) => item.startsWith('arcubase workflow '))) {
+  if (scope === 'admin' && moduleName === 'workflow' && suggestions.some((item) => item.startsWith('arcubase rows '))) {
     return {
       suggestions,
-      reason: `${moduleName} ${commandName} is a row operation, not an arcubase-admin command`,
-      hint: `use: arcubase ${moduleName} ${commandName}`,
+      reason: `${moduleName} ${commandName} is not a valid command group; use arcubase rows for row operations`,
+      hint: `use: arcubase rows ${commandName}`,
     }
   }
   return suggestions.length > 0 ? { suggestions } : undefined
@@ -92,8 +200,15 @@ export function renderCommandHelp(scope: CommandScope, moduleName: string, comma
       ? [
           'next step:',
           '  - switch to arcubase for row operations',
-          '  - row insert: arcubase workflow insert-entity --app-id <app_id> --entity-id <entity_id> --body-file insert.json',
-          '  - row query: arcubase workflow query-entity --app-id <app_id> --entity-id <entity_id> --body-file query.json',
+          '  - row insert: arcubase rows insert-entity --app-id <app_id> --entity-id <entity_id> --body-file insert.json',
+          '  - row query: arcubase rows query-entity --app-id <app_id> --entity-id <entity_id> --body-file query.json',
+        ]
+      : []),
+    ...(scope === 'admin' && moduleName === 'app' && commandName === 'inventory'
+      ? [
+          'purpose:',
+          '  - list all accessible apps and each app entity list in one call sequence',
+          '  - use this before asking the user for app_id',
         ]
       : []),
     ...(docHints.length > 0
@@ -340,7 +455,7 @@ function validateActionSpecificBody(
     return
   }
 
-  if (command.module === 'workflow' && command.functionName === 'queryEntitySelection') {
+  if (command.module === 'rows' && command.functionName === 'queryEntitySelection') {
     const action = flagValue(flags, 'action')
     const selection = body.selection
     if (!isRecord(selection) || typeof selection.type !== 'string') {
@@ -354,7 +469,7 @@ function validateActionSpecificBody(
     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',
+          'selection.type=condition is not supported for action=query; use selection.type=ids or selection.type=all, or use rows query-entity for search conditions',
           command.requestType,
           'body.selection.type',
           scope,
@@ -449,6 +564,9 @@ export async function executeCLI(scope: CommandScope, argv: string[], env?: Runt
   if (!command) {
     throw new CLIError('UNKNOWN_COMMAND', `unknown command: ${moduleName} ${commandName}`, 2, buildUnknownCommandDetails(scope, moduleName, commandName))
   }
+  if (scope === 'admin' && moduleName === 'app' && commandName === 'inventory') {
+    return executeAppInventory(runtimeEnv, fetchImpl)
+  }
 
   const endpoint = normalizeExternalEndpoint(resolveEndpoint(command.endpoint, parsed.flags))
   const scalarQuery = buildScalarQuery(command, parsed.flags)