@carthooks/arcubase-cli 0.1.7 → 0.1.9

package/dist/runtime/command_registry.d.ts

@@ -1,33 +1,15 @@
 import { adminCommands, userCommands } from '../generated/command_registry.generated.js';
 export { adminCommands, userCommands };
 export type CommandScope = 'admin' | 'user';
-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;
+export type CommandDef = (typeof adminCommands)[number] | (typeof userCommands)[number];
 export declare function listCommands(scope: CommandScope): readonly CommandDef[];
-export declare function findCommand(scope: CommandScope, moduleName: string, commandName: string): CommandDef | null;
+export declare function findCommand(scope: CommandScope, moduleName: string, commandName?: string | null): CommandDef | null;
 export declare function listModules(scope: CommandScope): string[];
 export declare function listModuleCommands(scope: CommandScope, moduleName: string): readonly CommandDef[];
 export type CommandSuggestion = {
     scope: CommandScope;
     moduleName: string;
-    commandName: string;
+    commandName: string | null;
     binary: 'arcubase-admin' | 'arcubase';
     score: number;
 };

package/dist/runtime/command_registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command_registry.d.ts","sourceRoot":"","sources":["../../src/runtime/command_registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAA;AAExF,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,CAAA;AAEtC,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,CAAA;AAC3C,KAAK,mBAAmB,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAEzF,KAAK,gBAAgB,GAAG;IACtB,KAAK,EAAE,YAAY,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,YAAY,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;IAC5E,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,mBAAmB,GAAG,gBAAgB,CAAA;AAoB/D,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,UAAU,EAAE,CAIvE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAE3G;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,EAAE,CAEzD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,UAAU,EAAE,CAEjG;AAmBD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,YAAY,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAAA;IACrC,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,iBAAiB,EAAE,CAoB9G"}
+{"version":3,"file":"command_registry.d.ts","sourceRoot":"","sources":["../../src/runtime/command_registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAA;AAExF,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,CAAA;AAEtC,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,CAAA;AAC3C,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvF,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,UAAU,EAAE,CAEvE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,UAAU,GAAG,IAAI,CAUnH;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,EAAE,CAEzD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,UAAU,EAAE,CAEjG;AAmBD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,YAAY,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAAA;IACrC,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,iBAAiB,EAAE,CA0B9G"}

package/dist/runtime/command_registry.js

@@ -1,28 +1,18 @@
 import { adminCommands, userCommands } from '../generated/command_registry.generated.js';
 export { adminCommands, userCommands };
-const customAdminCommands = [
-    {
-        scope: 'admin',
-        module: 'app',
-        functionName: 'inventory',
-        commandPath: ['app', 'inventory'],
-        method: 'GET',
-        endpoint: '/apps',
-        endpointParams: [],
-        controller: 'Runtime.AppInventory',
-        requestType: null,
-        scalarParams: [],
-        responseType: 'AppInventoryRespVO',
-    },
-];
-const customUserCommands = [];
 export function listCommands(scope) {
-    return scope === 'admin'
-        ? [...adminCommands, ...customAdminCommands]
-        : [...userCommands, ...customUserCommands];
+    return scope === 'admin' ? adminCommands : userCommands;
 }
 export function findCommand(scope, moduleName, commandName) {
-    return listCommands(scope).find((item) => item.commandPath[0] === moduleName && item.commandPath[1] === commandName) ?? null;
+    return listCommands(scope).find((item) => {
+        if (item.commandPath[0] !== moduleName) {
+            return false;
+        }
+        if (item.commandPath.length === 1) {
+            return !commandName;
+        }
+        return item.commandPath[1] === commandName;
+    }) ?? null;
 }
 export function listModules(scope) {
     return [...new Set(listCommands(scope).map((item) => item.commandPath[0]))].sort();
@@ -48,9 +38,10 @@ export 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 candidateModule = command.commandPath[0];
+            const candidateCommand = command.commandPath.length > 1 ? command.commandPath[1] ?? null : null;
             const moduleScore = candidateModule === moduleName ? 0 : levenshtein(candidateModule, moduleName || '');
-            const commandScore = candidateCommand === commandName ? 0 : levenshtein(candidateCommand, commandName || '');
+            const commandScore = candidateCommand === commandName ? 0 : levenshtein(candidateCommand ?? '', commandName || '');
             const score = commandScore * 3 + moduleScore;
             suggestions.push({
                 scope,
@@ -62,6 +53,9 @@ export function findCommandSuggestions(moduleName, commandName, limit = 3) {
         }
     }
     return suggestions
-        .sort((a, b) => a.score - b.score || a.binary.localeCompare(b.binary) || a.moduleName.localeCompare(b.moduleName) || a.commandName.localeCompare(b.commandName))
+        .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);
 }

package/dist/runtime/execute.d.ts

@@ -2,16 +2,16 @@ import { type RuntimeEnv } from './env.js';
 import { type CommandScope } from './command_registry.js';
 export type CommandExecutionSummary = {
     scope: CommandScope;
-    commandPath: readonly [string, string];
+    commandPath: readonly string[];
     method: string;
     endpoint: string;
     requestType: string | null;
     pathFlags: readonly string[];
-    scalarFlags: readonly string[];
+    queryFlags: readonly string[];
 };
 export declare function renderRootHelp(scope: CommandScope): string;
 export declare function renderModuleHelp(scope: CommandScope, moduleName: string): string;
-export declare function renderCommandHelp(scope: CommandScope, moduleName: string, commandName: string): string;
+export declare function renderCommandHelp(scope: CommandScope, moduleName: string, commandName?: string): string;
 export declare function summarizeCommand(scope: CommandScope, moduleName: string, commandName: string): CommandExecutionSummary;
 export declare function executeCLI(scope: CommandScope, argv: string[], env?: RuntimeEnv, fetchImpl?: typeof fetch): Promise<any>;
 //# sourceMappingURL=execute.d.ts.map

package/dist/runtime/execute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/runtime/execute.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAA;AAG1D,OAAO,EAAwE,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAK/H,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,YAAY,CAAA;IACnB,WAAW,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;CAC/B,CAAA;AAwHD,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAa1D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAehF;AAcD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAoCtG;AA8RD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,uBAAuB,CActH;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,SAAS,GAAE,OAAO,KAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CA+JrI"}
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/runtime/execute.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAA;AAG1D,OAAO,EAAwE,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAK/H,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,YAAY,CAAA;IACnB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CAC9B,CAAA;AAYD,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAa1D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAkBhF;AAOD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CA8BvG;AAoSD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,uBAAuB,CActH;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,SAAS,GAAE,OAAO,KAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAiKrI"}

package/dist/runtime/execute.js

@@ -9,115 +9,15 @@ import { renderUploadHelp, uploadLocalFile } from './upload.js';
 function summarizeUploadResult(value) {
     return value;
 }
-function parseJSONResponse(raw) {
-    if (!raw)
-        return null;
-    try {
-        return JSON.parse(raw);
-    }
-    catch {
-        return raw;
-    }
-}
-function unwrapResponseData(payload) {
-    return isRecord(payload) && 'data' in payload ? payload.data : payload;
-}
-function formatUpstreamError(payload) {
-    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) {
-    const data = unwrapResponseData(payload);
-    if (!Array.isArray(data))
-        return [];
-    return data
-        .filter((item) => isRecord(item))
-        .filter((item) => item.id !== undefined && typeof item.name === 'string')
-        .map((item) => ({
-        id: String(item.id),
-        name: item.name,
-    }));
-}
-function extractEntities(payload) {
-    const data = unwrapResponseData(payload);
-    if (!Array.isArray(data))
-        return [];
-    return data
-        .filter((item) => isRecord(item))
-        .filter((item) => item.id !== undefined && typeof item.name === 'string')
-        .map((item) => ({
-        id: String(item.id),
-        name: item.name,
-    }));
-}
-async function executeAppInventory(runtimeEnv, fetchImpl) {
-    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 = [];
-    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'],
-        status: 200,
-        data: {
-            apps: items,
-        },
-    };
-}
 export function renderRootHelp(scope) {
     const binary = scope === 'admin' ? 'arcubase-admin' : 'arcubase';
     const items = listModules(scope).map((item) => `  - ${item}`);
     return [
-        `${binary} <module> <command> [flags]`,
+        `${binary} <command> [subcommand] [flags]`,
         '',
         ...(scope === 'admin'
-            ? ['use arcubase-admin for app, entity shell, and schema management', '']
-            : ['use arcubase for rows, search, selection actions, and bulk actions', '']),
+            ? ['use arcubase-admin for app, table, access-rule, and workflow management', '']
+            : ['use arcubase for entry, table, row, upload, profile, and workflow actions', '']),
         'modules:',
         ...items,
         ...(scope === 'user' ? ['', 'special commands:', '  - upload <local-file>'] : []),
@@ -126,60 +26,50 @@ export function renderRootHelp(scope) {
 export function renderModuleHelp(scope, moduleName) {
     const items = listModuleCommands(scope, moduleName);
     if (items.length === 0) {
-        const suggestions = findCommandSuggestions(moduleName, '').map((item) => `${item.binary} ${item.moduleName} ${item.commandName}`);
+        const suggestions = findCommandSuggestions(moduleName, '').map((item) => `${item.binary} ${item.moduleName}${item.commandName ? ` ${item.commandName}` : ''}`);
         throw new CLIError('UNKNOWN_MODULE', `unknown module: ${moduleName}`, 2, suggestions.length > 0 ? { suggestions } : undefined);
     }
+    if (items.length === 1 && items[0].commandPath.length === 1) {
+        return renderCommandHelp(scope, moduleName);
+    }
     return [
         `${scope === 'admin' ? 'arcubase-admin' : 'arcubase'} ${moduleName} <command> [flags]`,
         '',
         ...(scope === 'admin'
-            ? ['use arcubase-admin for app, entity shell, and schema management', '']
-            : ['use arcubase for rows, search, selection actions, and bulk actions', '']),
+            ? ['use arcubase-admin for app, table, access-rule, and workflow management', '']
+            : ['use arcubase for entry, table, row, upload, profile, and workflow actions', '']),
         'commands:',
-        ...items.map((item) => `  - ${item.commandPath[1]}`),
+        ...items.filter((item) => item.commandPath.length > 1).map((item) => `  - ${item.commandPath[1]}`),
     ].join('\n');
 }
 function buildUnknownCommandDetails(scope, moduleName, commandName) {
-    const suggestions = findCommandSuggestions(moduleName, commandName).map((item) => `${item.binary} ${item.moduleName} ${item.commandName}`);
-    if (scope === 'admin' && moduleName === 'workflow' && suggestions.some((item) => item.startsWith('arcubase rows '))) {
-        return {
-            suggestions,
-            reason: `${moduleName} ${commandName} is not a valid command group; use arcubase rows for row operations`,
-            hint: `use: arcubase rows ${commandName}`,
-        };
-    }
+    const suggestions = findCommandSuggestions(moduleName, commandName).map((item) => `${item.binary} ${item.moduleName}${item.commandName ? ` ${item.commandName}` : ''}`);
     return suggestions.length > 0 ? { suggestions } : undefined;
 }
 export function renderCommandHelp(scope, moduleName, commandName) {
     const command = findCommand(scope, moduleName, commandName);
     if (!command) {
-        throw new CLIError('UNKNOWN_COMMAND', `unknown command: ${moduleName} ${commandName}`, 2, buildUnknownCommandDetails(scope, moduleName, commandName));
+        throw new CLIError('UNKNOWN_COMMAND', `unknown command: ${moduleName}${commandName ? ` ${commandName}` : ''}`, 2, buildUnknownCommandDetails(scope, moduleName, commandName ?? ''));
     }
     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);
+    const pathFlags = command.pathParams.filter((item) => !getFixedValue(item)).map((item) => `--${item.flag}`);
+    const queryFlags = command.queryParams.filter((item) => !getFixedValue(item)).map((item) => `--${item.flag}`);
     return [
-        `${scope === 'admin' ? 'arcubase-admin' : 'arcubase'} ${moduleName} ${commandName}`,
+        `${scope === 'admin' ? 'arcubase-admin' : 'arcubase'} ${command.commandPath.join(' ')}`,
         `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',
-        ...(scope === 'admin' && moduleName === 'entity' && commandName === 'admin-save-entity'
+        command.requestType ? `body: ${command.requestType} via --body-file or --body-json` : 'body: none',
+        queryFlags.length ? `query flags: ${queryFlags.join(', ')}, --query-file` : 'query flags: --query-file',
+        pathFlags.length ? `path flags: ${pathFlags.join(', ')}` : 'path flags: none',
+        ...(scope === 'admin' && command.commandPath[0] === 'table' && command.commandPath[1] === 'update-schema'
             ? [
                 'next step:',
                 '  - switch to arcubase for row operations',
-                '  - 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',
+                '  - row create: arcubase row create --app-id <app_id> --table-id <table_id> --body-file insert.json',
+                '  - row query: arcubase row query --app-id <app_id> --table-id <table_id> --body-file query.json',
             ]
             : []),
         ...(docHints.length > 0
@@ -205,15 +95,21 @@ function coerceScalar(value, typeText) {
     }
     return value;
 }
-function resolveEndpoint(endpoint, flags) {
-    let resolved = endpoint;
-    for (const placeholder of [...endpoint.matchAll(/:([A-Za-z0-9_]+)/g)].map((match) => match[1])) {
-        const flagName = placeholder.replace(/_/g, '-');
-        const value = flagValue(flags, flagName);
+function getFixedValue(value) {
+    if (!('fixedValue' in value)) {
+        return undefined;
+    }
+    const fixedValue = value.fixedValue;
+    return typeof fixedValue === 'string' ? fixedValue : undefined;
+}
+function resolveEndpoint(command, flags) {
+    let resolved = command.endpoint;
+    for (const mapping of command.pathParams) {
+        const value = getFixedValue(mapping) ?? flagValue(flags, mapping.flag);
         if (!value) {
-            throw new CLIError('MISSING_PATH_FLAG', `missing required flag --${flagName}`, 2);
+            throw new CLIError('MISSING_PATH_FLAG', `missing required flag --${mapping.flag}`, 2);
         }
-        resolved = resolved.replace(`:${placeholder}`, encodeURIComponent(value));
+        resolved = resolved.replace(`:${mapping.param}`, encodeURIComponent(value));
     }
     return resolved;
 }
@@ -222,12 +118,11 @@ function buildScalarQuery(command, flags) {
         return undefined;
     }
     const out = {};
-    for (const scalar of command.scalarParams) {
-        const flagName = scalar.name.replace(/([A-Z])/g, '-$1').toLowerCase();
-        const value = flagValue(flags, flagName);
+    for (const scalar of command.queryParams) {
+        const value = getFixedValue(scalar) ?? flagValue(flags, scalar.flag);
         if (value === undefined)
             continue;
-        out[scalar.name] = coerceScalar(value, scalar.type);
+        out[scalar.key] = coerceScalar(value, scalar.type);
     }
     return Object.keys(out).length > 0 ? out : undefined;
 }
@@ -249,7 +144,7 @@ function extractEntityFields(payload) {
     }));
 }
 async function fetchEntityFields(runtimeEnv, appId, entityId, fetchImpl) {
-    const response = await fetchImpl(buildURL(runtimeEnv.ARCUBASE_BASE_URL, `/entity/${encodeURIComponent(appId)}/${encodeURIComponent(entityId)}`), {
+    const response = await fetchImpl(buildURL(runtimeEnv.ARCUBASE_BASE_URL, `/api/entity/${encodeURIComponent(appId)}/${encodeURIComponent(entityId)}`), {
         method: 'GET',
         headers: buildRequestHeaders(runtimeEnv),
     });
@@ -272,7 +167,7 @@ async function fetchEntityFields(runtimeEnv, appId, entityId, fetchImpl) {
                 ? upstreamError
                 : JSON.stringify(upstreamError);
         throw new CLIError('UPSTREAM_BODY_ERROR', upstreamMessage, 1, {
-            endpoint: `/entity/${appId}/${entityId}`,
+            endpoint: `/api/entity/${appId}/${entityId}`,
             method: 'GET',
             upstreamError,
         });
@@ -304,7 +199,7 @@ async function validateFileFieldPayloads(scope, command, runtimeEnv, flags, body
         return;
     }
     const appId = flagValue(flags, 'app-id');
-    const entityId = flagValue(flags, 'entity-id');
+    const entityId = flagValue(flags, 'table-id');
     if (!appId || !entityId) {
         return;
     }
@@ -392,7 +287,7 @@ function validateActionSpecificBody(scope, command, flags, body) {
     if (!isRecord(body) || !command.requestType) {
         return;
     }
-    if (command.module === 'rows' && command.functionName === 'queryEntitySelection') {
+    if (command.commandPath[0] === 'row' && command.commandPath[1] === 'selection-action') {
         const action = flagValue(flags, 'action');
         const selection = body.selection;
         if (!isRecord(selection) || typeof selection.type !== 'string') {
@@ -403,7 +298,7 @@ function validateActionSpecificBody(scope, command, flags, body) {
         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 rows query-entity for search conditions', command.requestType, 'body.selection.type', scope, command);
+                throwBodyValidationFailure('selection.type=condition is not supported for action=query; use selection.type=ids or selection.type=all, or use row query for search conditions', command.requestType, 'body.selection.type', scope, command);
             }
             return;
         }
@@ -424,10 +319,10 @@ export function summarizeCommand(scope, moduleName, commandName) {
         scope,
         commandPath: command.commandPath,
         method: command.method,
-        endpoint: normalizeExternalEndpoint(command.endpoint),
+        endpoint: command.endpoint,
         requestType: command.requestType,
-        pathFlags: command.endpointParams,
-        scalarFlags: command.scalarParams.map((item) => item.name.replace(/([A-Z])/g, '-$1').toLowerCase()),
+        pathFlags: command.pathParams.filter((item) => !getFixedValue(item)).map((item) => item.flag),
+        queryFlags: command.queryParams.filter((item) => !getFixedValue(item)).map((item) => item.flag),
     };
 }
 export async function executeCLI(scope, argv, env, fetchImpl = fetch) {
@@ -459,7 +354,8 @@ export async function executeCLI(scope, argv, env, fetchImpl = fetch) {
     if (!moduleName) {
         return { kind: 'help', text: renderRootHelp(scope) };
     }
-    if (!commandName) {
+    const singleTokenCommand = !commandName ? findCommand(scope, moduleName) : null;
+    if (!commandName && !singleTokenCommand) {
         return { kind: 'help', text: renderModuleHelp(scope, moduleName) };
     }
     if (hasFlag(parsed.flags, 'help')) {
@@ -468,20 +364,20 @@ export async function executeCLI(scope, argv, env, fetchImpl = fetch) {
     const runtimeEnv = env ?? loadRuntimeEnv(scope);
     const command = findCommand(scope, moduleName, commandName);
     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);
+        throw new CLIError('UNKNOWN_COMMAND', `unknown command: ${moduleName}${commandName ? ` ${commandName}` : ''}`, 2, buildUnknownCommandDetails(scope, moduleName, commandName ?? ''));
     }
-    const endpoint = normalizeExternalEndpoint(resolveEndpoint(command.endpoint, parsed.flags));
+    const endpoint = resolveEndpoint(command, parsed.flags);
     const scalarQuery = buildScalarQuery(command, parsed.flags);
     const fileQuery = loadQueryFromFlags(parsed.flags);
     const query = { ...(scalarQuery ?? {}), ...(fileQuery ?? {}) };
     const body = loadBodyFromFlags(parsed.flags);
     let validatedBody = body;
+    if (!command.requestType && body !== undefined) {
+        throw new CLIError('BODY_JSON_NOT_SUPPORTED', `command does not accept a request body: ${moduleName} ${commandName}`, 2);
+    }
     if (command.requestType) {
         if (body === undefined) {
-            throw new CLIError('MISSING_BODY_FILE', `command requires --body-file for ${command.requestType}`, 2);
+            throw new CLIError('MISSING_BODY_FILE', `command requires --body-file or --body-json for ${command.requestType}`, 2);
         }
         const schema = getBodySchema(command.requestType);
         if (schema) {

package/dist/runtime/http.js

@@ -18,7 +18,7 @@ export function normalizeExternalEndpoint(endpoint) {
     return trimmed;
 }
 export function buildURL(baseURL, endpoint, query) {
-    const url = new URL(normalizeExternalEndpoint(endpoint), baseURL.endsWith('/') ? baseURL : `${baseURL}/`);
+    const url = new URL(endpoint, baseURL.endsWith('/') ? baseURL : `${baseURL}/`);
     if (query) {
         for (const [key, value] of Object.entries(query)) {
             if (value === undefined || value === null)

package/dist/runtime/upload.js

@@ -33,7 +33,7 @@ function requireTokenPayload(payload) {
                 ? upstreamError
                 : JSON.stringify(upstreamError);
         throw new CLIError('UPSTREAM_BODY_ERROR', message, 1, {
-            endpoint: '/upload/token',
+            endpoint: '/api/upload/token',
             method: 'POST',
             traceId: typeof payload.trace_id === 'string' ? payload.trace_id : undefined,
             upstreamError,
@@ -74,7 +74,7 @@ export function renderUploadHelp() {
 export async function uploadLocalFile(env, sourcePath, options, fetchImpl = fetch) {
     const { absolutePath, bytes } = readUploadSource(sourcePath);
     const filename = (options.filename && options.filename.trim()) || path.basename(absolutePath);
-    const tokenResponse = await fetchImpl(buildURL(env.ARCUBASE_BASE_URL, '/upload/token'), {
+    const tokenResponse = await fetchImpl(buildURL(env.ARCUBASE_BASE_URL, '/api/upload/token'), {
         method: 'POST',
         headers: {
             ...buildRequestHeaders(env),
@@ -88,7 +88,7 @@ export async function uploadLocalFile(env, sourcePath, options, fetchImpl = fetc
     const tokenParsed = parseJSONResponse(tokenRaw);
     if (!tokenResponse.ok) {
         throw new CLIError('UPLOAD_TOKEN_REQUEST_FAILED', typeof tokenParsed === 'string' ? tokenParsed : JSON.stringify(tokenParsed), 1, {
-            endpoint: '/upload/token',
+            endpoint: '/api/upload/token',
             method: 'POST',
         });
     }

package/dist/runtime/zod_registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zod_registry.d.ts","sourceRoot":"","sources":["../../src/runtime/zod_registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AA6BrC,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAOjE;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI9E;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAQ9D;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAgED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE,CAqBhE;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CAI9D;AAqED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE,CAItE"}
+{"version":3,"file":"zod_registry.d.ts","sourceRoot":"","sources":["../../src/runtime/zod_registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AA6BrC,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAOjE;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI9E;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAQ9D;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAyDD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE,CAqBhE;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CAI9D;AA0DD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE,CAItE"}

package/dist/runtime/zod_registry.js

@@ -42,18 +42,12 @@ const examplesIndexDocHint = {
     title: 'Examples index',
     file: '/opt/arcubase-sdk/docs/runtime-reference/examples/README.md',
 };
-const appDiscoveryDocHint = {
-    title: 'App discovery',
-    file: '/opt/arcubase-sdk/docs/runtime-reference/app-discovery.md',
-};
 const docHintIndex = {
     AppCreateByTenantsReqVO: [
-        appDiscoveryDocHint,
         { title: 'Table lifecycle', file: '/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md' },
         examplesIndexDocHint,
     ],
     AppCreateEntityReqVO: [
-        appDiscoveryDocHint,
         { title: 'Table lifecycle', file: '/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md' },
         examplesIndexDocHint,
     ],
@@ -131,25 +125,14 @@ export function getDocHints(typeName) {
 }
 const commandDocHintIndex = {
     'admin.app.createAppByTenants': [
-        appDiscoveryDocHint,
         { title: 'Table lifecycle', file: '/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md' },
         examplesIndexDocHint,
     ],
-    'admin.app.listApps': [
-        appDiscoveryDocHint,
-        examplesIndexDocHint,
-    ],
-    'admin.app.inventory': [
-        appDiscoveryDocHint,
-        examplesIndexDocHint,
-    ],
     'admin.app.createEntity': [
-        appDiscoveryDocHint,
         { title: 'Table lifecycle', file: '/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md' },
         examplesIndexDocHint,
     ],
     'admin.entity.adminGetEntityInfo': [
-        appDiscoveryDocHint,
         { title: 'Table lifecycle', file: '/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md' },
         examplesIndexDocHint,
     ],
@@ -159,34 +142,34 @@ const commandDocHintIndex = {
         { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
         examplesIndexDocHint,
     ],
-    'user.rows.insertEntity': [
+    'user.workflow.insertEntity': [
         { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
         { title: 'Uploads', file: '/opt/arcubase-sdk/docs/runtime-reference/uploads.md' },
         examplesIndexDocHint,
     ],
-    'user.rows.queryEntity': [
+    'user.workflow.queryEntity': [
         { title: 'Search and bulk actions', file: '/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md' },
         { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
         examplesIndexDocHint,
     ],
-    'user.rows.getEntityRow': [
+    'user.workflow.getEntityRow': [
         { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
         examplesIndexDocHint,
     ],
-    'user.rows.updateEntityRow': [
+    'user.workflow.updateEntityRow': [
         { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
         { title: 'Uploads', file: '/opt/arcubase-sdk/docs/runtime-reference/uploads.md' },
         examplesIndexDocHint,
     ],
-    'user.rows.queryEntitySelection': [
+    'user.workflow.queryEntitySelection': [
         { title: 'Search and bulk actions', file: '/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md' },
         examplesIndexDocHint,
     ],
-    'user.rows.deleteEntityRow': [
+    'user.workflow.deleteEntityRow': [
         { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
         examplesIndexDocHint,
     ],
-    'user.rows.restoreEntityRow': [
+    'user.workflow.restoreEntityRow': [
         { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
         examplesIndexDocHint,
     ],