@carthooks/arcubase-cli 0.1.3 → 0.1.5

package/dist/runtime/zod_registry.js

@@ -42,54 +42,59 @@ const examplesIndexDocHint = {
     title: 'Examples index',
     file: '/opt/arcubase-sdk/docs/runtime-reference/examples/README.md',
 };
-const omsExampleDocHint = {
-    title: 'OMS example 01',
-    file: '/opt/arcubase-sdk/docs/runtime-reference/examples/oms-01/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,
-        omsExampleDocHint,
     ],
     AppCreateEntityReqVO: [
+        appDiscoveryDocHint,
         { 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,
+        examplesIndexDocHint,
     ],
     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,
+        examplesIndexDocHint,
     ],
     EntityUpdateReqVO: [
         { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
-        omsExampleDocHint,
+        { title: 'Uploads', file: '/opt/arcubase-sdk/docs/runtime-reference/uploads.md' },
+        examplesIndexDocHint,
     ],
     EntitySelectionActionReqVO: [
         { title: 'Search and bulk actions', file: '/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md' },
-        omsExampleDocHint,
+        examplesIndexDocHint,
     ],
     InsertReqVO: [
         { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
-        omsExampleDocHint,
+        { title: 'Uploads', file: '/opt/arcubase-sdk/docs/runtime-reference/uploads.md' },
+        examplesIndexDocHint,
     ],
     EntityBulkUpdateReqVO: [
         { title: 'Search and bulk actions', file: '/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md' },
-        omsExampleDocHint,
+        examplesIndexDocHint,
     ],
     'EntityInvokeBatchOperatorReqVO & InvokeRequestVO': [
         { title: 'Search and bulk actions', file: '/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md' },
+        examplesIndexDocHint,
     ],
     '{ policy_id: string selection: any }': [
         { title: 'Search and bulk actions', file: '/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md' },
+        examplesIndexDocHint,
     ],
     '{ 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' },
+        examplesIndexDocHint,
     ],
 };
 export function getTypeHints(typeName) {
@@ -126,53 +131,68 @@ export function getDocHints(typeName) {
 }
 const commandDocHintIndex = {
     'admin.app.createAppByTenants': [
+        appDiscoveryDocHint,
         { title: 'Table lifecycle', file: '/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md' },
         examplesIndexDocHint,
-        omsExampleDocHint,
+    ],
+    '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' },
-        omsExampleDocHint,
+        examplesIndexDocHint,
     ],
     'admin.entity.adminGetEntityInfo': [
+        appDiscoveryDocHint,
         { title: 'Table lifecycle', file: '/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md' },
-        omsExampleDocHint,
+        examplesIndexDocHint,
     ],
     'admin.entity.adminSaveEntity': [
         { title: 'Entity schema', file: '/opt/arcubase-sdk/docs/runtime-reference/entity-schema.md' },
-        omsExampleDocHint,
+        { title: 'Table lifecycle', file: '/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md' },
+        { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
+        examplesIndexDocHint,
     ],
-    'user.workflow.insertEntity': [
+    'user.rows.insertEntity': [
         { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
-        omsExampleDocHint,
+        { title: 'Uploads', file: '/opt/arcubase-sdk/docs/runtime-reference/uploads.md' },
+        examplesIndexDocHint,
     ],
-    'user.workflow.queryEntity': [
+    'user.rows.queryEntity': [
         { title: 'Search and bulk actions', file: '/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md' },
-        omsExampleDocHint,
+        { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
+        examplesIndexDocHint,
     ],
-    'user.workflow.getEntityRow': [
+    'user.rows.getEntityRow': [
         { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
-        omsExampleDocHint,
+        examplesIndexDocHint,
     ],
-    'user.workflow.updateEntityRow': [
+    'user.rows.updateEntityRow': [
         { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
-        omsExampleDocHint,
+        { title: 'Uploads', file: '/opt/arcubase-sdk/docs/runtime-reference/uploads.md' },
+        examplesIndexDocHint,
     ],
-    'user.workflow.queryEntitySelection': [
+    'user.rows.queryEntitySelection': [
         { title: 'Search and bulk actions', file: '/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md' },
-        omsExampleDocHint,
+        examplesIndexDocHint,
     ],
-    'user.workflow.deleteEntityRow': [
+    'user.rows.deleteEntityRow': [
         { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
-        omsExampleDocHint,
+        examplesIndexDocHint,
     ],
-    'user.workflow.restoreEntityRow': [
+    'user.rows.restoreEntityRow': [
         { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
-        omsExampleDocHint,
+        examplesIndexDocHint,
     ],
     'user.entity.updateEntityBulk': [
         { title: 'Search and bulk actions', file: '/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md' },
-        omsExampleDocHint,
+        examplesIndexDocHint,
     ],
 };
 export function getCommandDocHints(operation) {

package/dist/tests/command_registry.test.js

@@ -5,8 +5,15 @@ import { findCommandSuggestions } from '../runtime/command_registry.js';
 test('admin app create-entity command exists', () => {
     assert.ok(adminCommands.some((c) => c.commandPath.join(' ') === 'app create-entity'));
 });
-test('user workflow query-entity command exists', () => {
-    assert.ok(userCommands.some((c) => c.commandPath.join(' ') === 'workflow query-entity'));
+test('admin app list-apps command exists', () => {
+    assert.ok(adminCommands.some((c) => c.commandPath.join(' ') === 'app list-apps'));
+});
+test('admin app inventory command exists', () => {
+    const suggestions = findCommandSuggestions('app', 'inventory', 20);
+    assert.ok(suggestions.some((item) => item.binary === 'arcubase-admin' && item.moduleName === 'app' && item.commandName === 'inventory'));
+});
+test('user rows query-entity command exists', () => {
+    assert.ok(userCommands.some((c) => c.commandPath.join(' ') === 'rows query-entity'));
 });
 test('inline request type keeps full object text instead of truncated brace', () => {
     const command = adminCommands.find((c) => c.commandPath.join(' ') === 'dashboard clone-dashboard');
@@ -21,7 +28,7 @@ test('tag commands no longer emit truncated inline request type', () => {
     assert.match(String(typed.requestType), /^\{\s*policy_id:\s*string.*selection:\s*any.*tag_names:\s*string\[\]\s*\}$/);
     assert.equal(typed.scalarParams.length, 0);
 });
-test('suggestions can point wrong admin delete guess to user workflow delete command', () => {
+test('suggestions can point wrong admin delete guess to user rows delete command', () => {
     const suggestions = findCommandSuggestions('entity', 'admin-delete-entity-row');
-    assert.ok(suggestions.some((item) => item.binary === 'arcubase' && item.moduleName === 'workflow' && item.commandName === 'delete-entity-row'));
+    assert.ok(suggestions.some((item) => item.binary === 'arcubase' && item.moduleName === 'rows' && item.commandName === 'delete-entity-row'));
 });

package/dist/tests/execute_validation.test.js

@@ -60,6 +60,61 @@ test('admin api-prefixed command executes against external root path', async ()
     assert.equal(out.kind, 'result');
     assert.equal(out.data.url, 'https://arcubase.example.com/apps/app_1/entity-shares');
 });
+test('app inventory returns apps with entity lists', async () => {
+    const calls = [];
+    const out = await executeCLI('admin', ['app', 'inventory'], env, async (url, init) => {
+        calls.push(`${init?.method ?? 'GET'} ${String(url)}`);
+        if (String(url) === 'https://arcubase.example.com/apps') {
+            return new Response(JSON.stringify({
+                data: [
+                    { id: 101, name: 'Workspace' },
+                    { id: 102, name: 'CRM' },
+                ],
+            }), { status: 200 });
+        }
+        if (String(url) === 'https://arcubase.example.com/apps/101/entities') {
+            return new Response(JSON.stringify({
+                data: [
+                    { id: 201, name: 'Orders' },
+                    { id: 202, name: 'Customers' },
+                ],
+            }), { status: 200 });
+        }
+        if (String(url) === 'https://arcubase.example.com/apps/102/entities') {
+            return new Response(JSON.stringify({
+                data: [
+                    { id: 203, name: 'Leads' },
+                ],
+            }), { status: 200 });
+        }
+        return new Response('{}', { status: 404 });
+    });
+    assert.equal(out.kind, 'result');
+    assert.deepEqual(out.data, {
+        apps: [
+            {
+                id: '101',
+                name: 'Workspace',
+                entities: [
+                    { id: '201', name: 'Orders' },
+                    { id: '202', name: 'Customers' },
+                ],
+            },
+            {
+                id: '102',
+                name: 'CRM',
+                entities: [
+                    { id: '203', name: 'Leads' },
+                ],
+            },
+        ],
+    });
+    assert.deepEqual(calls, [
+        'GET https://arcubase.example.com/apps',
+        'POST https://arcubase.example.com/apps/101/entities',
+        'POST https://arcubase.example.com/apps/102/entities',
+    ]);
+});
 test('admin save entity treats top-level error body as failure even on http 200', async () => {
     const bodyFile = tempJSONFile({
         id: 2188889845,
@@ -183,7 +238,7 @@ test('delete entity row rejects selection type outside ids', async () => {
         },
     });
     await assert.rejects(async () => {
-        await executeCLI('user', ['workflow', 'delete-entity-row', '--app-id', 'app_1', '--entity-id', 'entity_1', '--body-file', bodyFile], env, async () => new Response('{}', { status: 200 }));
+        await executeCLI('user', ['rows', 'delete-entity-row', '--app-id', 'app_1', '--entity-id', 'entity_1', '--body-file', bodyFile], env, async () => new Response('{}', { status: 200 }));
     }, (error) => {
         assert.ok(error instanceof CLIError);
         assert.equal(error.code, 'BODY_VALIDATION_FAILED');
@@ -228,7 +283,7 @@ test('selection action accepts condition selection with selectAll', async () =>
             ],
         },
     });
-    const out = await executeCLI('user', ['workflow', 'query-entity-selection', '--app-id', 'app_1', '--entity-id', 'entity_1', '--action', 'archive', '--body-file', bodyFile], env, async (_url, init) => new Response(String(init?.body ?? '{}'), { status: 200 }));
+    const out = await executeCLI('user', ['rows', 'query-entity-selection', '--app-id', 'app_1', '--entity-id', 'entity_1', '--action', 'archive', '--body-file', bodyFile], env, async (_url, init) => new Response(String(init?.body ?? '{}'), { status: 200 }));
     assert.equal(out.kind, 'result');
     assert.equal(out.data.selection.type, 'condition');
     assert.equal(out.data.selection.condition.selectAll, true);
@@ -244,7 +299,7 @@ test('selection action accepts condition selection with filter_* keys', async ()
             },
         },
     });
-    const out = await executeCLI('user', ['workflow', 'query-entity-selection', '--app-id', 'app_1', '--entity-id', 'entity_1', '--action', 'archive', '--body-file', bodyFile], env, async (_url, init) => new Response(String(init?.body ?? '{}'), { status: 200 }));
+    const out = await executeCLI('user', ['rows', 'query-entity-selection', '--app-id', 'app_1', '--entity-id', 'entity_1', '--action', 'archive', '--body-file', bodyFile], env, async (_url, init) => new Response(String(init?.body ?? '{}'), { status: 200 }));
     assert.equal(out.kind, 'result');
     assert.equal(out.data.selection.type, 'condition');
     assert.equal(out.data.selection.condition.selectAll, true);
@@ -259,7 +314,7 @@ test('selection action accepts condition selection with selectAll only for batch
             },
         },
     });
-    const out = await executeCLI('user', ['workflow', 'query-entity-selection', '--app-id', 'app_1', '--entity-id', 'entity_1', '--action', 'batch_print', '--body-file', bodyFile], env, async (_url, init) => new Response(String(init?.body ?? '{}'), { status: 200 }));
+    const out = await executeCLI('user', ['rows', 'query-entity-selection', '--app-id', 'app_1', '--entity-id', 'entity_1', '--action', 'batch_print', '--body-file', bodyFile], env, async (_url, init) => new Response(String(init?.body ?? '{}'), { status: 200 }));
     assert.equal(out.kind, 'result');
     assert.equal(out.data.selection.type, 'condition');
     assert.equal(out.data.selection.condition.selectAll, true);
@@ -270,7 +325,7 @@ test('selection action accepts all selection for query-style actions', async ()
             type: 'all',
         },
     });
-    const out = await executeCLI('user', ['workflow', 'query-entity-selection', '--app-id', 'app_1', '--entity-id', 'entity_1', '--action', 'query', '--body-file', bodyFile], env, async (_url, init) => new Response(String(init?.body ?? '{}'), { status: 200 }));
+    const out = await executeCLI('user', ['rows', 'query-entity-selection', '--app-id', 'app_1', '--entity-id', 'entity_1', '--action', 'query', '--body-file', bodyFile], env, async (_url, init) => new Response(String(init?.body ?? '{}'), { status: 200 }));
     assert.equal(out.kind, 'result');
     assert.equal(out.data.selection.type, 'all');
 });
@@ -286,7 +341,7 @@ test('selection action rejects condition selection for query action', async () =
         },
     });
     await assert.rejects(async () => {
-        await executeCLI('user', ['workflow', 'query-entity-selection', '--app-id', 'app_1', '--entity-id', 'entity_1', '--action', 'query', '--body-file', bodyFile], env, async () => new Response('{}', { status: 200 }));
+        await executeCLI('user', ['rows', 'query-entity-selection', '--app-id', 'app_1', '--entity-id', 'entity_1', '--action', 'query', '--body-file', bodyFile], env, async () => new Response('{}', { status: 200 }));
     }, (error) => {
         assert.ok(error instanceof CLIError);
         assert.equal(error.code, 'BODY_VALIDATION_FAILED');
@@ -301,7 +356,7 @@ test('selection action rejects all selection for archive action', async () => {
         },
     });
     await assert.rejects(async () => {
-        await executeCLI('user', ['workflow', 'query-entity-selection', '--app-id', 'app_1', '--entity-id', 'entity_1', '--action', 'archive', '--body-file', bodyFile], env, async () => new Response('{}', { status: 200 }));
+        await executeCLI('user', ['rows', 'query-entity-selection', '--app-id', 'app_1', '--entity-id', 'entity_1', '--action', 'archive', '--body-file', bodyFile], env, async () => new Response('{}', { status: 200 }));
     }, (error) => {
         assert.ok(error instanceof CLIError);
         assert.equal(error.code, 'BODY_VALIDATION_FAILED');
@@ -320,7 +375,7 @@ test('selection action rejects selectAll-only condition for archive action', asy
         },
     });
     await assert.rejects(async () => {
-        await executeCLI('user', ['workflow', 'query-entity-selection', '--app-id', 'app_1', '--entity-id', 'entity_1', '--action', 'archive', '--body-file', bodyFile], env, async () => new Response('{}', { status: 200 }));
+        await executeCLI('user', ['rows', 'query-entity-selection', '--app-id', 'app_1', '--entity-id', 'entity_1', '--action', 'archive', '--body-file', bodyFile], env, async () => new Response('{}', { status: 200 }));
     }, (error) => {
         assert.ok(error instanceof CLIError);
         assert.equal(error.code, 'BODY_VALIDATION_FAILED');
@@ -328,6 +383,159 @@ test('selection action rejects selectAll-only condition for archive action', asy
         return true;
     });
 });
+test('insert entity rejects local file path for file field and points to arcubase upload', async () => {
+    const bodyFile = tempJSONFile({
+        fields: {
+            1001: 'Lead A',
+            1007: './contract.pdf',
+        },
+    });
+    const calls = [];
+    await assert.rejects(async () => {
+        await executeCLI('user', ['rows', 'insert-entity', '--app-id', 'app_1', '--entity-id', 'entity_1', '--body-file', bodyFile], env, async (url, init) => {
+            calls.push({ url: String(url), method: init?.method });
+            if (String(url) === 'https://arcubase.example.com/entity/app_1/entity_1' && init?.method === 'GET') {
+                return new Response(JSON.stringify({
+                    data: {
+                        id: 1,
+                        app_id: 1,
+                        fields: [
+                            { id: 1001, type: 'text', label: 'Lead Name' },
+                            { id: 1007, type: 'file', label: 'Contract File' },
+                        ],
+                    },
+                }), { status: 200 });
+            }
+            return new Response('{}', { status: 200 });
+        });
+    }, (error) => {
+        assert.ok(error instanceof CLIError);
+        assert.equal(error.code, 'BODY_VALIDATION_FAILED');
+        assert.ok((error.details?.issues ?? []).some((item) => item.path === 'body.fields.1007'));
+        assert.match(error.message, /arcubase upload \.\/contract\.pdf/);
+        assert.ok((error.details?.docHints ?? []).some((item) => item.file.endsWith('/docs/runtime-reference/uploads.md')));
+        return true;
+    });
+    assert.deepEqual(calls, [
+        { url: 'https://arcubase.example.com/entity/app_1/entity_1', method: 'GET' },
+    ]);
+});
+test('update row rejects object value for image field and requires upload array', async () => {
+    const bodyFile = tempJSONFile({
+        changed_fields: [1008],
+        data: {
+            1008: {
+                upload_id: 123456,
+                file: 'lead-photo.jpg',
+                file_name: 'lead-photo.jpg',
+                meta: {},
+            },
+        },
+    });
+    await assert.rejects(async () => {
+        await executeCLI('user', ['rows', 'update-entity-row', '--app-id', 'app_1', '--entity-id', 'entity_1', '--row-id', 'row_1', '--body-file', bodyFile], env, async (url, init) => {
+            if (String(url) === 'https://arcubase.example.com/entity/app_1/entity_1' && init?.method === 'GET') {
+                return new Response(JSON.stringify({
+                    data: {
+                        id: 1,
+                        app_id: 1,
+                        fields: [
+                            { id: 1008, type: 'image', label: 'Lead Photo' },
+                        ],
+                    },
+                }), { status: 200 });
+            }
+            return new Response('{}', { status: 200 });
+        });
+    }, (error) => {
+        assert.ok(error instanceof CLIError);
+        assert.equal(error.code, 'BODY_VALIDATION_FAILED');
+        assert.ok((error.details?.issues ?? []).some((item) => item.path === 'body.data.1008'));
+        assert.match(error.message, /must be an array/);
+        assert.match(error.message, /arcubase upload <local-file>/);
+        return true;
+    });
+});
+test('insert entity accepts upload array for file field after schema preflight', async () => {
+    const bodyFile = tempJSONFile({
+        fields: {
+            1001: 'Lead A',
+            1007: [
+                {
+                    upload_id: 123456,
+                    file: 'contract.pdf',
+                    file_name: 'contract.pdf',
+                    meta: {},
+                },
+            ],
+        },
+    });
+    const calls = [];
+    const out = await executeCLI('user', ['rows', 'insert-entity', '--app-id', 'app_1', '--entity-id', 'entity_1', '--body-file', bodyFile], env, async (url, init) => {
+        calls.push({ url: String(url), method: init?.method });
+        if (String(url) === 'https://arcubase.example.com/entity/app_1/entity_1' && init?.method === 'GET') {
+            return new Response(JSON.stringify({
+                data: {
+                    id: 1,
+                    app_id: 1,
+                    fields: [
+                        { id: 1001, type: 'text', label: 'Lead Name' },
+                        { id: 1007, type: 'file', label: 'Contract File' },
+                    ],
+                },
+            }), { status: 200 });
+        }
+        return new Response(String(init?.body ?? '{}'), { status: 200 });
+    });
+    assert.equal(out.kind, 'result');
+    assert.deepEqual(calls, [
+        { url: 'https://arcubase.example.com/entity/app_1/entity_1', method: 'GET' },
+        { url: 'https://arcubase.example.com/entity/app_1/entity_1/insert', method: 'POST' },
+    ]);
+    assert.equal(out.data.fields['1007'][0].upload_id, 123456);
+});
+test('insert entity decorates upload bind failures with actionable guidance', async () => {
+    const bodyFile = tempJSONFile({
+        fields: {
+            1001: 'Lead A',
+            1007: [
+                {
+                    upload_id: 123456,
+                    file: 'contract.pdf',
+                    file_name: 'contract.pdf',
+                    meta: {},
+                },
+            ],
+        },
+    });
+    await assert.rejects(async () => {
+        await executeCLI('user', ['rows', 'insert-entity', '--app-id', 'app_1', '--entity-id', 'entity_1', '--body-file', bodyFile], env, async (url, init) => {
+            if (String(url) === 'https://arcubase.example.com/entity/app_1/entity_1' && init?.method === 'GET') {
+                return new Response(JSON.stringify({
+                    data: {
+                        fields: [{ id: 1007, type: 'file', label: 'Contract File' }],
+                    },
+                }), { status: 200 });
+            }
+            return new Response(JSON.stringify({
+                error: {
+                    message: 'failed to bind upload to assets: Head \"http://test-bucket.test.aliyuncs.com/upload/123456/contract.pdf\": dial tcp: lookup test-bucket.test.aliyuncs.com: no such host',
+                    type: 'system',
+                    key: 'error.system',
+                },
+                trace_id: 'req_upload_bind',
+            }), { status: 200 });
+        });
+    }, (error) => {
+        assert.ok(error instanceof CLIError);
+        assert.equal(error.code, 'UPSTREAM_BODY_ERROR');
+        assert.equal(error.details?.traceId, 'req_upload_bind');
+        assert.equal(error.details?.reason, 'the row payload used a file/image upload entry, but Arcubase could not bind that upload into an asset record');
+        assert.match(error.details?.hint ?? '', /rerun arcubase upload/);
+        assert.ok((error.details?.docHints ?? []).some((item) => item.file.endsWith('/docs/runtime-reference/uploads.md')));
+        return true;
+    });
+});
 test('selection action rejects condition selection without selectAll', async () => {
     const bodyFile = tempJSONFile({
         selection: {
@@ -339,7 +547,7 @@ test('selection action rejects condition selection without selectAll', async ()
         },
     });
     await assert.rejects(async () => {
-        await executeCLI('user', ['workflow', 'query-entity-selection', '--app-id', 'app_1', '--entity-id', 'entity_1', '--action', 'archive', '--body-file', bodyFile], env, async () => new Response('{}', { status: 200 }));
+        await executeCLI('user', ['rows', 'query-entity-selection', '--app-id', 'app_1', '--entity-id', 'entity_1', '--action', 'archive', '--body-file', bodyFile], env, async () => new Response('{}', { status: 200 }));
     }, (error) => {
         assert.ok(error instanceof CLIError);
         assert.equal(error.code, 'BODY_VALIDATION_FAILED');
@@ -359,7 +567,7 @@ test('selection action rejects condition selection that uses text_search instead
         },
     });
     await assert.rejects(async () => {
-        await executeCLI('user', ['workflow', 'query-entity-selection', '--app-id', 'app_1', '--entity-id', 'entity_1', '--action', 'archive', '--body-file', bodyFile], env, async () => new Response('{}', { status: 200 }));
+        await executeCLI('user', ['rows', 'query-entity-selection', '--app-id', 'app_1', '--entity-id', 'entity_1', '--action', 'archive', '--body-file', bodyFile], env, async () => new Response('{}', { status: 200 }));
     }, (error) => {
         assert.ok(error instanceof CLIError);
         assert.equal(error.code, 'BODY_VALIDATION_FAILED');
@@ -451,7 +659,7 @@ test('query entity rejects camelCase viewMode and points to row crud doc', async
         viewMode: 'grid',
     });
     await assert.rejects(async () => {
-        await executeCLI('user', ['workflow', 'query-entity', '--app-id', 'app_1', '--entity-id', 'entity_1', '--body-file', bodyFile], env, async () => new Response('{}', { status: 200 }));
+        await executeCLI('user', ['rows', 'query-entity', '--app-id', 'app_1', '--entity-id', 'entity_1', '--body-file', bodyFile], env, async () => new Response('{}', { status: 200 }));
     }, (error) => {
         assert.ok(error instanceof CLIError);
         assert.equal(error.code, 'BODY_VALIDATION_FAILED');
@@ -471,7 +679,7 @@ test('update entity row rejects fields key', async () => {
         changed_fields: [1002],
     });
     await assert.rejects(async () => {
-        await executeCLI('user', ['workflow', 'update-entity-row', '--app-id', 'app_1', '--entity-id', 'entity_1', '--row-id', 'row_1', '--body-file', bodyFile], env, async () => new Response('{}', { status: 200 }));
+        await executeCLI('user', ['rows', 'update-entity-row', '--app-id', 'app_1', '--entity-id', 'entity_1', '--row-id', 'row_1', '--body-file', bodyFile], env, async () => new Response('{}', { status: 200 }));
     }, (error) => {
         assert.ok(error instanceof CLIError);
         assert.equal(error.code, 'BODY_VALIDATION_FAILED');
@@ -488,7 +696,7 @@ test('update entity row rejects changed_fields that are missing from data', asyn
         changed_fields: [1003],
     });
     await assert.rejects(async () => {
-        await executeCLI('user', ['workflow', 'update-entity-row', '--app-id', 'app_1', '--entity-id', 'entity_1', '--row-id', 'row_1', '--body-file', bodyFile], env, async () => new Response('{}', { status: 200 }));
+        await executeCLI('user', ['rows', 'update-entity-row', '--app-id', 'app_1', '--entity-id', 'entity_1', '--row-id', 'row_1', '--body-file', bodyFile], env, async () => new Response('{}', { status: 200 }));
     }, (error) => {
         assert.ok(error instanceof CLIError);
         assert.equal(error.code, 'BODY_VALIDATION_FAILED');

package/dist/tests/help.test.js

@@ -24,9 +24,10 @@ test('module help prints create-entity command', async () => {
     const out = await executeCLI('admin', ['app', '--help'], env, async () => new Response('{}'));
     assert.equal(out.kind, 'help');
     assert.match(out.text, /create-entity/);
+    assert.match(out.text, /inventory/);
 });
 test('module help does not require runtime env', async () => {
-    const out = await executeCLI('user', ['workflow', '--help'], undefined, async () => new Response('{}'));
+    const out = await executeCLI('user', ['rows', '--help'], undefined, async () => new Response('{}'));
     assert.equal(out.kind, 'help');
     assert.match(out.text, /delete-entity-row/);
 });
@@ -37,19 +38,19 @@ test('command help prints normalized external endpoint', async () => {
     assert.doesNotMatch(out.text, /endpoint: \/api\//);
 });
 test('command help does not require runtime env', async () => {
-    const out = await executeCLI('user', ['workflow', 'delete-entity-row', '--help'], undefined, async () => new Response('{}'));
+    const out = await executeCLI('user', ['rows', 'delete-entity-row', '--help'], undefined, async () => new Response('{}'));
     assert.equal(out.kind, 'help');
     assert.match(out.text, /endpoint: \/entity\/:app_id\/:entity_id\/delete-item/);
 });
 test('command help prints runtime doc hints for request body commands', async () => {
-    const out = await executeCLI('user', ['workflow', 'update-entity-row', '--help'], undefined, async () => new Response('{}'));
+    const out = await executeCLI('user', ['rows', 'update-entity-row', '--help'], undefined, async () => new Response('{}'));
     assert.equal(out.kind, 'help');
     assert.match(out.text, /docs:/);
     assert.match(out.text, /\/opt\/arcubase-sdk\/docs\/runtime-reference\/row-crud\.md/);
-    assert.match(out.text, /\/opt\/arcubase-sdk\/docs\/runtime-reference\/examples\/oms-01\/README\.md/);
+    assert.match(out.text, /\/opt\/arcubase-sdk\/docs\/runtime-reference\/examples\/README\.md/);
 });
 test('command help prints query-file support', async () => {
-    const out = await executeCLI('user', ['workflow', 'query-entity', '--help'], undefined, async () => new Response('{}'));
+    const out = await executeCLI('user', ['rows', 'query-entity', '--help'], undefined, async () => new Response('{}'));
     assert.equal(out.kind, 'help');
     assert.match(out.text, /query flags: --query-file/);
 });
@@ -57,5 +58,27 @@ test('command help without request body can still point to lifecycle and example
     const out = await executeCLI('admin', ['entity', 'admin-get-entity-info', '--help'], undefined, async () => new Response('{}'));
     assert.equal(out.kind, 'help');
     assert.match(out.text, /\/opt\/arcubase-sdk\/docs\/runtime-reference\/table-lifecycle\.md/);
-    assert.match(out.text, /\/opt\/arcubase-sdk\/docs\/runtime-reference\/examples\/oms-01\/README\.md/);
+    assert.match(out.text, /\/opt\/arcubase-sdk\/docs\/runtime-reference\/examples\/README\.md/);
+});
+test('app inventory help explains app discovery purpose', async () => {
+    const out = await executeCLI('admin', ['app', 'inventory', '--help'], undefined, async () => new Response('{}'));
+    assert.equal(out.kind, 'help');
+    assert.match(out.text, /list all accessible apps and each app entity list/);
+    assert.match(out.text, /use this before asking the user for app_id/);
+});
+test('admin-save-entity help prints row-operation next step', async () => {
+    const out = await executeCLI('admin', ['entity', 'admin-save-entity', '--help'], undefined, async () => new Response('{}'));
+    assert.equal(out.kind, 'help');
+    assert.match(out.text, /switch to arcubase for row operations/);
+    assert.match(out.text, /arcubase rows insert-entity/);
+    assert.match(out.text, /arcubase rows query-entity/);
+});
+test('wrong admin workflow command points to arcubase row command', async () => {
+    await assert.rejects(() => executeCLI('admin', ['workflow', 'insert-entity'], env, async () => new Response('{}')), (error) => {
+        assert.equal(error.code, 'UNKNOWN_COMMAND');
+        assert.equal(error.details?.reason, 'workflow insert-entity is not a valid command group; use arcubase rows for row operations');
+        assert.equal(error.details?.hint, 'use: arcubase rows insert-entity');
+        assert.ok((error.details?.suggestions ?? []).includes('arcubase rows insert-entity'));
+        return true;
+    });
 });

package/dist/tests/upload.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=upload.test.d.ts.map

package/dist/tests/upload.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.test.d.ts","sourceRoot":"","sources":["../../src/tests/upload.test.ts"],"names":[],"mappings":""}