feat(cli): add resource mkdir commands

Author: TheodoreSpeaks

packages/sim-cli/README.md

@@ -161,14 +161,16 @@ Each folder-backed resource has the same path commands:
 
 ```bash
 sim tables folders ls --parent /Reports
+sim tables mkdir /Reports/Quarterly
 sim tables folders create /Reports/Quarterly
 sim tables folders mv /Reports/Quarterly /Archive/Quarterly
 sim tables folders delete /Archive/Quarterly --recursive false --yes
 ```
 
-Replace `tables` with `files`, `workflows`, or `knowledge`. Paths are canonical,
-start with `/`, and use `/` for root. A slash that belongs to a folder name is
-percent-encoded as `%2F` rather than treated as a separator.
+`mkdir` is the concise form of `folders create`. Replace `tables` with `files`,
+`workflows`, or `knowledge`. Paths are canonical, start with `/`, and use `/` for
+root. A slash that belongs to a folder name is percent-encoded as `%2F` rather
+than treated as a separator.
 
 ### List inputs
 

packages/sim-cli/src/commands/protocol/index.ts

@@ -2,7 +2,7 @@ import { Command } from 'commander'
 import { attachFileDownload } from './files-download.js'
 import { attachFileUpload } from './files-upload.js'
 import { attachKnowledgeDocumentUpload } from './knowledge-document-upload.js'
-import { attachResourceList } from './resource-ls.js'
+import { attachResourceDirectoryCommands } from './resource-directory.js'
 import { attachTableImport } from './tables-import.js'
 
 function group(program: Command, name: string): Command {
@@ -18,31 +18,35 @@ export function attachProtocolCommands(program: Command): void {
   const files = group(program, 'files')
   attachFileUpload(files)
   attachFileDownload(files)
-  attachResourceList(files, {
+  attachResourceDirectoryCommands(files, {
     kind: 'file',
     resources: 'listFiles',
     folders: 'listFileFolders',
+    createFolder: 'createFileFolder',
   })
 
   const knowledge = group(program, 'knowledge')
   attachKnowledgeDocumentUpload(group(knowledge, 'documents'))
-  attachResourceList(knowledge, {
+  attachResourceDirectoryCommands(knowledge, {
     kind: 'knowledge',
     resources: 'listKnowledgeBases',
     folders: 'listKnowledgeFolders',
+    createFolder: 'createKnowledgeFolder',
   })
 
   const tables = group(program, 'tables')
   attachTableImport(tables)
-  attachResourceList(tables, {
+  attachResourceDirectoryCommands(tables, {
     kind: 'table',
     resources: 'listTables',
     folders: 'listTableFolders',
+    createFolder: 'createTableFolder',
   })
 
-  attachResourceList(group(program, 'workflows'), {
+  attachResourceDirectoryCommands(group(program, 'workflows'), {
     kind: 'workflow',
     resources: 'listWorkflows',
     folders: 'listWorkflowFolders',
+    createFolder: 'createWorkflowFolder',
   })
 }

…rc/commands/protocol/resource-ls.test.ts …ands/protocol/resource-directory.test.tspackages/sim-cli/src/commands/protocol/resource-ls.test.ts renamed to packages/sim-cli/src/commands/protocol/resource-directory.test.ts packages/sim-cli/src/commands/protocol/resource-ls.test.ts renamed to packages/sim-cli/src/commands/protocol/resource-directory.test.ts

@@ -34,11 +34,12 @@ beforeEach(() => {
   output.format = 'json'
 })
 
-describe('resource ls', () => {
-  it('is available for every folder-backed resource', () => {
+describe('resource directory', () => {
+  it('makes ls and mkdir available for every folder-backed resource', () => {
     for (const resource of ['files', 'knowledge', 'tables', 'workflows']) {
       const group = program().commands.find((command) => command.name() === resource)
       expect(group?.commands.some((command) => command.name() === 'ls')).toBe(true)
+      expect(group?.commands.some((command) => command.name() === 'mkdir')).toBe(true)
     }
   })
 
@@ -124,4 +125,26 @@ describe('resource ls', () => {
       },
     ])
   })
+
+  it('creates a folder through the generated resource operation', async () => {
+    mockRequest.mockResolvedValue({
+      data: {
+        folder: {
+          name: 'Quarterly',
+          path: '/Reports/Quarterly',
+          parentPath: '/Reports',
+          createdAt: '2026-08-04T00:00:00.000Z',
+          updatedAt: '2026-08-04T00:00:00.000Z',
+        },
+      },
+    })
+    vi.spyOn(console, 'log').mockImplementation(() => {})
+
+    await program().parseAsync(['node', 'sim', 'table', 'mkdir', '/Reports/Quarterly'])
+
+    expect(mockRequest).toHaveBeenCalledWith('/api/v2/tables/folders', {
+      method: 'POST',
+      body: { workspaceId: 'ws_local', path: '/Reports/Quarterly' },
+    })
+  })
 })

…cli/src/commands/protocol/resource-ls.ts …/commands/protocol/resource-directory.tspackages/sim-cli/src/commands/protocol/resource-ls.ts renamed to packages/sim-cli/src/commands/protocol/resource-directory.ts packages/sim-cli/src/commands/protocol/resource-ls.ts renamed to packages/sim-cli/src/commands/protocol/resource-directory.ts

@@ -15,6 +15,7 @@ import {
 import { SimApiError, type SimClient, type V2Page } from '../../http/client.js'
 import { type Column, printList, text, timestamp } from '../../output/render.js'
 import { DEFAULT_LIMIT } from '../../runtime/options.js'
+import { renderResult } from '../../runtime/result.js'
 
 type FolderListOperation =
   | 'listFileFolders'
@@ -43,14 +44,30 @@ interface DirectoryEntry {
 }
 
 type ResourceDirectoryConfig =
-  | { kind: 'file'; resources: 'listFiles'; folders: 'listFileFolders' }
+  | {
+      kind: 'file'
+      resources: 'listFiles'
+      folders: 'listFileFolders'
+      createFolder: 'createFileFolder'
+    }
   | {
       kind: 'knowledge'
       resources: 'listKnowledgeBases'
       folders: 'listKnowledgeFolders'
+      createFolder: 'createKnowledgeFolder'
+    }
+  | {
+      kind: 'table'
+      resources: 'listTables'
+      folders: 'listTableFolders'
+      createFolder: 'createTableFolder'
+    }
+  | {
+      kind: 'workflow'
+      resources: 'listWorkflows'
+      folders: 'listWorkflowFolders'
+      createFolder: 'createWorkflowFolder'
     }
-  | { kind: 'table'; resources: 'listTables'; folders: 'listTableFolders' }
-  | { kind: 'workflow'; resources: 'listWorkflows'; folders: 'listWorkflowFolders' }
 
 interface ListOptions {
   folder: string
@@ -141,7 +158,10 @@ function entriesFor(
   )
 }
 
-export function attachResourceList(group: Command, config: ResourceDirectoryConfig): void {
+export function attachResourceDirectoryCommands(
+  group: Command,
+  config: ResourceDirectoryConfig
+): void {
   group
     .command('ls')
     .description(`List ${config.kind} resources and child folders together`)
@@ -168,4 +188,17 @@ export function attachResourceList(group: Command, config: ResourceDirectoryConf
       const entries = entriesFor(config, folders, resources)
       printList(profile.output, entries.slice(0, limit), COLUMNS)
     })
+
+  group
+    .command('mkdir <path>')
+    .description(`Create a ${config.kind} directory at a canonical path`)
+    .action(async (path: string, _options: Record<string, never>, command: Command) => {
+      const { client, profile } = clientFrom(command)
+      const operation = V2_OPERATIONS[config.createFolder]
+      const result = await client.request<{ data?: unknown }>(operation.path, {
+        method: operation.method,
+        body: { workspaceId: client.requireWorkspace(), path },
+      })
+      renderResult(config.createFolder, profile.output, result.data ?? result, {})
+    })
 }