@baseworks/organization 0.2.0

package/src/__tests__/cli-env.test.ts

@@ -0,0 +1,158 @@
+/// <reference types="vitest/globals" />
+import { beforeAll, afterEach, afterAll, describe, it, expect } from 'vitest'
+import { run, mocks, server } from './helpers.js'
+
+beforeAll(() => server.listen({ onUnhandledRequest: 'warn' }))
+afterEach(() => server.resetHandlers())
+afterAll(() => server.close())
+
+const ORG_SLUG  = 'dotlabs'
+const WS_SLUG   = 'staging'
+const PROJ_SLUG = 'api'
+const OPT       = ['--org', ORG_SLUG, '--ws', WS_SLUG, '--proj', PROJ_SLUG]
+const BASE      = `/v1/orgs/${ORG_SLUG}/workspaces/${WS_SLUG}/projects/${PROJ_SLUG}/envs`
+
+const ENV = {
+  id:        '019f08dd-5555-7db6-956d-f323dfadba50',
+  shortId:   'ev1abc',
+  slug:      'production',
+  name:      'Production',
+  isDefault: true,
+  createdAt: 1782507760630,
+  updatedAt: 1782507760630,
+}
+
+const ENV2 = {
+  id:        '019f08de-6666-7db6-956d-f323dfadba50',
+  shortId:   'ev2xyz',
+  slug:      'preview',
+  name:      'Preview',
+  isDefault: false,
+  createdAt: 1782507760630,
+  updatedAt: 1782507760630,
+}
+
+// ── list ─────────────────────────────────────────────────────────────────────
+
+describe('flect env (list)', () => {
+  it('default columns: ID → SLUG → NAME → DEFAULT', async () => {
+    mocks.mockGet(BASE, { envs: [ENV, ENV2] })
+    const r = await run(['env', ...OPT])
+    expect(r.exitCode).toBe(0)
+    expect(r.stdout).toContain('ev1abc')
+    expect(r.stdout).toContain('production')
+    expect(r.stdout).toContain('Production')
+    expect(r.stdout.indexOf('ID')).toBeLessThan(r.stdout.indexOf('SLUG'))
+    expect(r.stdout.indexOf('SLUG')).toBeLessThan(r.stdout.indexOf('NAME'))
+  })
+
+  it('does not show full UUID in default view', async () => {
+    mocks.mockGet(BASE, { envs: [ENV] })
+    const r = await run(['env', ...OPT])
+    expect(r.stdout).not.toContain(ENV.id)
+  })
+
+  it('-o wide adds FULL ID column', async () => {
+    mocks.mockGet(BASE, { envs: [ENV] })
+    const r = await run(['env', '-o', 'wide', ...OPT])
+    expect(r.exitCode).toBe(0)
+    expect(r.stdout).toContain('FULL ID')
+    expect(r.stdout).toContain(ENV.id)
+  })
+
+  it('-o json returns raw JSON array', async () => {
+    mocks.mockGet(BASE, { envs: [ENV] })
+    const r = await run(['env', '-o', 'json', ...OPT])
+    const parsed = JSON.parse(r.stdout)
+    expect(Array.isArray(parsed)).toBe(true)
+    expect(parsed[0].shortId).toBe('ev1abc')
+  })
+})
+
+// ── create ───────────────────────────────────────────────────────────────────
+
+describe('flect env create', () => {
+  it('sends only name when no slug given', async () => {
+    const captured = mocks.mockPostCapture(BASE, { env: ENV })
+    const r = await run(['env', 'create', '--name', 'Production', ...OPT])
+    expect(r.exitCode).toBe(0)
+    const body = captured.body as Record<string, unknown>
+    expect(body.name).toBe('Production')
+    expect(body.slug).toBeUndefined()
+  })
+
+  it('sends explicit slug when provided', async () => {
+    const captured = mocks.mockPostCapture(BASE, { env: ENV })
+    await run(['env', 'create', '--name', 'Production', '--slug', 'production', ...OPT])
+    expect((captured.body as Record<string, unknown>).slug).toBe('production')
+  })
+
+  it('shows shortId in output, not full UUID', async () => {
+    mocks.mockPost(BASE, { env: ENV })
+    const r = await run(['env', 'create', '--name', 'Production', ...OPT])
+    expect(r.stdout).toContain('ev1abc')
+    expect(r.stdout).not.toContain(ENV.id)
+  })
+})
+
+// ── get ───────────────────────────────────────────────────────────────────────
+
+describe('flect env get', () => {
+  it('works with slug', async () => {
+    mocks.mockGet(`${BASE}/production`, { env: ENV })
+    const r = await run(['env', 'get', 'production', ...OPT])
+    expect(r.exitCode).toBe(0)
+    expect(r.stdout).toContain('Production')
+  })
+
+  it('works with shortId', async () => {
+    mocks.mockGet(`${BASE}/ev1abc`, { env: ENV })
+    const r = await run(['env', 'get', 'ev1abc', ...OPT])
+    expect(r.exitCode).toBe(0)
+    expect(r.stdout).toContain('Production')
+  })
+
+  it('id field shows shortId, full_id field shows UUID', async () => {
+    mocks.mockGet(`${BASE}/production`, { env: ENV })
+    const r = await run(['env', 'get', 'production', ...OPT])
+    const lines  = r.stdout.split('\n')
+    const idLine = lines.find(l => /^\s+id\s/.test(l))
+    expect(idLine).toContain('ev1abc')
+    expect(idLine).not.toContain(ENV.id)
+  })
+})
+
+// ── update ────────────────────────────────────────────────────────────────────
+
+describe('flect env update', () => {
+  it('works with slug', async () => {
+    const captured = mocks.mockPatchCapture(`${BASE}/production`, { env: { ...ENV, name: 'Production v2' } })
+    const r = await run(['env', 'update', 'production', '--name', 'Production v2', ...OPT])
+    expect(r.exitCode).toBe(0)
+    expect((captured.body as Record<string, unknown>).name).toBe('Production v2')
+  })
+
+  it('works with shortId', async () => {
+    const captured = mocks.mockPatchCapture(`${BASE}/ev1abc`, { env: { ...ENV, name: 'Production v2' } })
+    const r = await run(['env', 'update', 'ev1abc', '--name', 'Production v2', ...OPT])
+    expect(r.exitCode).toBe(0)
+    expect((captured.body as Record<string, unknown>).name).toBe('Production v2')
+  })
+})
+
+// ── delete ────────────────────────────────────────────────────────────────────
+
+describe('flect env delete', () => {
+  it('works with slug', async () => {
+    mocks.mockDelete(`${BASE}/production`)
+    const r = await run(['env', 'delete', 'production', ...OPT])
+    expect(r.exitCode).toBe(0)
+    expect(r.stdout).toContain('production')
+  })
+
+  it('works with shortId', async () => {
+    mocks.mockDelete(`${BASE}/ev1abc`)
+    const r = await run(['env', 'delete', 'ev1abc', ...OPT])
+    expect(r.exitCode).toBe(0)
+  })
+})

package/src/__tests__/cli-org.test.ts

@@ -0,0 +1,154 @@
+/// <reference types="vitest/globals" />
+import { beforeAll, afterEach, afterAll, describe, it, expect } from 'vitest'
+import { run, mocks, server } from './helpers.js'
+
+beforeAll(() => server.listen({ onUnhandledRequest: 'warn' }))
+afterEach(() => server.resetHandlers())
+afterAll(() => server.close())
+
+const ORG = {
+  id:        '019f05bd-ebf7-7db6-956d-f323dfadba50',
+  shortId:   'n2shs8',
+  slug:      'dotlabs',
+  name:      'Dotlabs',
+  metadata:  null,
+  createdAt: 1782507760630,
+  updatedAt: 1782507760630,
+}
+
+const ORG2 = {
+  id:        '019f05bc-8f7c-716d-8530-3a3683ea2411',
+  shortId:   'kf5wnb',
+  slug:      'acme',
+  name:      'Acme Inc',
+  metadata:  null,
+  createdAt: 1782507671419,
+  updatedAt: 1782507671419,
+}
+
+// ── list ─────────────────────────────────────────────────────────────────────
+
+describe('flect org (list)', () => {
+  it('default columns: ID (shortId) → SLUG → NAME', async () => {
+    mocks.mockGet('/v1/orgs', { orgs: [ORG, ORG2] })
+    const r = await run(['org'])
+    expect(r.exitCode).toBe(0)
+    expect(r.stdout).toContain('n2shs8')
+    expect(r.stdout).toContain('dotlabs')
+    expect(r.stdout).toContain('Dotlabs')
+    expect(r.stdout.indexOf('ID')).toBeLessThan(r.stdout.indexOf('SLUG'))
+    expect(r.stdout.indexOf('SLUG')).toBeLessThan(r.stdout.indexOf('NAME'))
+  })
+
+  it('does not show full UUID in default view', async () => {
+    mocks.mockGet('/v1/orgs', { orgs: [ORG] })
+    const r = await run(['org'])
+    expect(r.stdout).not.toContain(ORG.id)
+  })
+
+  it('-o wide adds CREATED and FULL ID columns', async () => {
+    mocks.mockGet('/v1/orgs', { orgs: [ORG] })
+    const r = await run(['org', '-o', 'wide'])
+    expect(r.exitCode).toBe(0)
+    expect(r.stdout).toContain('CREATED')
+    expect(r.stdout).toContain('FULL ID')
+    expect(r.stdout).toContain(ORG.id)
+  })
+
+  it('-o json returns raw JSON array', async () => {
+    mocks.mockGet('/v1/orgs', { orgs: [ORG] })
+    const r = await run(['org', '-o', 'json'])
+    expect(r.exitCode).toBe(0)
+    const parsed = JSON.parse(r.stdout)
+    expect(Array.isArray(parsed)).toBe(true)
+    expect(parsed[0].shortId).toBe('n2shs8')
+  })
+})
+
+// ── create ───────────────────────────────────────────────────────────────────
+
+describe('flect org create', () => {
+  it('sends only name when no slug given (API generates slug from name)', async () => {
+    const captured = mocks.mockPostCapture('/v1/orgs', { org: { ...ORG, slug: 'my-org', shortId: 'abc123' } })
+    const r = await run(['org', 'create', '--name', 'My Org'])
+    expect(r.exitCode).toBe(0)
+    const body = captured.body as Record<string, unknown>
+    expect(body.name).toBe('My Org')
+    expect(body.slug).toBeUndefined()
+  })
+
+  it('sends explicit slug when provided', async () => {
+    const captured = mocks.mockPostCapture('/v1/orgs', { org: ORG })
+    await run(['org', 'create', '--name', 'Dotlabs', '--slug', 'dotlabs'])
+    expect((captured.body as Record<string, unknown>).slug).toBe('dotlabs')
+  })
+
+  it('shows shortId (not full UUID) in output', async () => {
+    mocks.mockPost('/v1/orgs', { org: ORG })
+    const r = await run(['org', 'create', '--name', 'Dotlabs'])
+    expect(r.stdout).toContain('n2shs8')
+    expect(r.stdout).not.toContain(ORG.id)
+  })
+})
+
+// ── get ───────────────────────────────────────────────────────────────────────
+
+describe('flect org get', () => {
+  it('works with slug', async () => {
+    mocks.mockGet('/v1/orgs/dotlabs', { org: ORG })
+    const r = await run(['org', 'get', 'dotlabs'])
+    expect(r.exitCode).toBe(0)
+    expect(r.stdout).toContain('Dotlabs')
+  })
+
+  it('works with shortId', async () => {
+    mocks.mockGet('/v1/orgs/n2shs8', { org: ORG })
+    const r = await run(['org', 'get', 'n2shs8'])
+    expect(r.exitCode).toBe(0)
+    expect(r.stdout).toContain('Dotlabs')
+  })
+
+  it('id field shows shortId, full_id field shows UUID', async () => {
+    mocks.mockGet('/v1/orgs/dotlabs', { org: ORG })
+    const r = await run(['org', 'get', 'dotlabs'])
+    const lines = r.stdout.split('\n')
+    const idLine = lines.find(l => /^\s+id\s/.test(l))
+    expect(idLine).toContain('n2shs8')
+    expect(idLine).not.toContain(ORG.id)
+  })
+})
+
+// ── update ────────────────────────────────────────────────────────────────────
+
+describe('flect org update', () => {
+  it('works with slug', async () => {
+    const captured = mocks.mockPatchCapture('/v1/orgs/dotlabs', { org: { ...ORG, name: 'Dotlabs HQ' } })
+    const r = await run(['org', 'update', 'dotlabs', '--name', 'Dotlabs HQ'])
+    expect(r.exitCode).toBe(0)
+    expect((captured.body as Record<string, unknown>).name).toBe('Dotlabs HQ')
+  })
+
+  it('works with shortId', async () => {
+    const captured = mocks.mockPatchCapture('/v1/orgs/n2shs8', { org: { ...ORG, name: 'Dotlabs HQ' } })
+    const r = await run(['org', 'update', 'n2shs8', '--name', 'Dotlabs HQ'])
+    expect(r.exitCode).toBe(0)
+    expect((captured.body as Record<string, unknown>).name).toBe('Dotlabs HQ')
+  })
+})
+
+// ── delete ────────────────────────────────────────────────────────────────────
+
+describe('flect org delete', () => {
+  it('works with slug', async () => {
+    mocks.mockDelete('/v1/orgs/dotlabs')
+    const r = await run(['org', 'delete', 'dotlabs'])
+    expect(r.exitCode).toBe(0)
+    expect(r.stdout).toContain('dotlabs')
+  })
+
+  it('works with shortId', async () => {
+    mocks.mockDelete('/v1/orgs/n2shs8')
+    const r = await run(['org', 'delete', 'n2shs8'])
+    expect(r.exitCode).toBe(0)
+  })
+})

package/src/__tests__/cli-proj.test.ts

@@ -0,0 +1,157 @@
+/// <reference types="vitest/globals" />
+import { beforeAll, afterEach, afterAll, describe, it, expect } from 'vitest'
+import { run, mocks, server } from './helpers.js'
+
+beforeAll(() => server.listen({ onUnhandledRequest: 'warn' }))
+afterEach(() => server.resetHandlers())
+afterAll(() => server.close())
+
+const ORG_SLUG = 'dotlabs'
+const WS_SLUG  = 'staging'
+const OPT      = ['--org', ORG_SLUG, '--ws', WS_SLUG]
+const BASE     = `/v1/orgs/${ORG_SLUG}/workspaces/${WS_SLUG}/projects`
+
+const PROJ = {
+  id:        '019f07cc-3333-7db6-956d-f323dfadba50',
+  shortId:   'pj9abc',
+  slug:      'api',
+  name:      'API',
+  isDefault: true,
+  createdAt: 1782507760630,
+  updatedAt: 1782507760630,
+}
+
+const PROJ2 = {
+  id:        '019f07cd-4444-7db6-956d-f323dfadba50',
+  shortId:   'pjxyz1',
+  slug:      'web',
+  name:      'Web',
+  isDefault: false,
+  createdAt: 1782507760630,
+  updatedAt: 1782507760630,
+}
+
+// ── list ─────────────────────────────────────────────────────────────────────
+
+describe('flect proj (list)', () => {
+  it('default columns: ID → SLUG → NAME → DEFAULT', async () => {
+    mocks.mockGet(BASE, { projects: [PROJ, PROJ2] })
+    const r = await run(['proj', ...OPT])
+    expect(r.exitCode).toBe(0)
+    expect(r.stdout).toContain('pj9abc')
+    expect(r.stdout).toContain('api')
+    expect(r.stdout).toContain('API')
+    expect(r.stdout.indexOf('ID')).toBeLessThan(r.stdout.indexOf('SLUG'))
+    expect(r.stdout.indexOf('SLUG')).toBeLessThan(r.stdout.indexOf('NAME'))
+  })
+
+  it('does not show full UUID in default view', async () => {
+    mocks.mockGet(BASE, { projects: [PROJ] })
+    const r = await run(['proj', ...OPT])
+    expect(r.stdout).not.toContain(PROJ.id)
+  })
+
+  it('-o wide adds FULL ID column', async () => {
+    mocks.mockGet(BASE, { projects: [PROJ] })
+    const r = await run(['proj', '-o', 'wide', ...OPT])
+    expect(r.exitCode).toBe(0)
+    expect(r.stdout).toContain('FULL ID')
+    expect(r.stdout).toContain(PROJ.id)
+  })
+
+  it('-o json returns raw JSON array', async () => {
+    mocks.mockGet(BASE, { projects: [PROJ] })
+    const r = await run(['proj', '-o', 'json', ...OPT])
+    const parsed = JSON.parse(r.stdout)
+    expect(Array.isArray(parsed)).toBe(true)
+    expect(parsed[0].shortId).toBe('pj9abc')
+  })
+})
+
+// ── create ───────────────────────────────────────────────────────────────────
+
+describe('flect proj create', () => {
+  it('sends only name when no slug given', async () => {
+    const captured = mocks.mockPostCapture(BASE, { project: PROJ })
+    const r = await run(['proj', 'create', '--name', 'API', ...OPT])
+    expect(r.exitCode).toBe(0)
+    const body = captured.body as Record<string, unknown>
+    expect(body.name).toBe('API')
+    expect(body.slug).toBeUndefined()
+  })
+
+  it('sends explicit slug when provided', async () => {
+    const captured = mocks.mockPostCapture(BASE, { project: PROJ })
+    await run(['proj', 'create', '--name', 'API', '--slug', 'api', ...OPT])
+    expect((captured.body as Record<string, unknown>).slug).toBe('api')
+  })
+
+  it('shows shortId in output, not full UUID', async () => {
+    mocks.mockPost(BASE, { project: PROJ })
+    const r = await run(['proj', 'create', '--name', 'API', ...OPT])
+    expect(r.stdout).toContain('pj9abc')
+    expect(r.stdout).not.toContain(PROJ.id)
+  })
+})
+
+// ── get ───────────────────────────────────────────────────────────────────────
+
+describe('flect proj get', () => {
+  it('works with slug', async () => {
+    mocks.mockGet(`${BASE}/api`, { project: PROJ })
+    const r = await run(['proj', 'get', 'api', ...OPT])
+    expect(r.exitCode).toBe(0)
+    expect(r.stdout).toContain('API')
+  })
+
+  it('works with shortId', async () => {
+    mocks.mockGet(`${BASE}/pj9abc`, { project: PROJ })
+    const r = await run(['proj', 'get', 'pj9abc', ...OPT])
+    expect(r.exitCode).toBe(0)
+    expect(r.stdout).toContain('API')
+  })
+
+  it('id field shows shortId, full_id field shows UUID', async () => {
+    mocks.mockGet(`${BASE}/api`, { project: PROJ })
+    const r = await run(['proj', 'get', 'api', ...OPT])
+    const lines  = r.stdout.split('\n')
+    const idLine = lines.find(l => /^\s+id\s/.test(l))
+    expect(idLine).toContain('pj9abc')
+    expect(idLine).not.toContain(PROJ.id)
+  })
+})
+
+// ── update ────────────────────────────────────────────────────────────────────
+
+describe('flect proj update', () => {
+  it('works with slug', async () => {
+    const captured = mocks.mockPatchCapture(`${BASE}/api`, { project: { ...PROJ, name: 'API v2' } })
+    const r = await run(['proj', 'update', 'api', '--name', 'API v2', ...OPT])
+    expect(r.exitCode).toBe(0)
+    expect((captured.body as Record<string, unknown>).name).toBe('API v2')
+  })
+
+  it('works with shortId', async () => {
+    const captured = mocks.mockPatchCapture(`${BASE}/pj9abc`, { project: { ...PROJ, name: 'API v2' } })
+    const r = await run(['proj', 'update', 'pj9abc', '--name', 'API v2', ...OPT])
+    expect(r.exitCode).toBe(0)
+    expect((captured.body as Record<string, unknown>).name).toBe('API v2')
+  })
+})
+
+// ── delete ────────────────────────────────────────────────────────────────────
+
+describe('flect proj delete', () => {
+  it('works with slug', async () => {
+    mocks.mockDelete(`${BASE}/api`)
+    const r = await run(['proj', 'delete', 'api', ...OPT])
+    expect(r.exitCode).toBe(0)
+    expect(r.stdout).toContain('api')
+  })
+
+  it('works with shortId', async () => {
+    mocks.mockDelete(`${BASE}/pj9abc`)
+    const r = await run(['proj', 'delete', 'pj9abc', ...OPT])
+    expect(r.exitCode).toBe(0)
+  })
+})

package/src/__tests__/cli-ws.test.ts

@@ -0,0 +1,156 @@
+/// <reference types="vitest/globals" />
+import { beforeAll, afterEach, afterAll, describe, it, expect } from 'vitest'
+import { run, mocks, server } from './helpers.js'
+
+beforeAll(() => server.listen({ onUnhandledRequest: 'warn' }))
+afterEach(() => server.resetHandlers())
+afterAll(() => server.close())
+
+// --org flag ile active org'u override ediyoruz (context boş olduğu için)
+const ORG_SLUG = 'dotlabs'
+const OPT      = ['--org', ORG_SLUG]
+
+const WS = {
+  id:        '019f06aa-1111-7db6-956d-f323dfadba50',
+  shortId:   'ws1234',
+  slug:      'staging',
+  name:      'Staging',
+  isDefault: true,
+  createdAt: 1782507760630,
+  updatedAt: 1782507760630,
+}
+
+const WS2 = {
+  id:        '019f06ab-2222-7db6-956d-f323dfadba50',
+  shortId:   'ws5678',
+  slug:      'production',
+  name:      'Production',
+  isDefault: false,
+  createdAt: 1782507760630,
+  updatedAt: 1782507760630,
+}
+
+// ── list ─────────────────────────────────────────────────────────────────────
+
+describe('flect ws (list)', () => {
+  it('default columns: ID → SLUG → NAME → DEFAULT', async () => {
+    mocks.mockGet(`/v1/orgs/${ORG_SLUG}/workspaces`, { workspaces: [WS, WS2] })
+    const r = await run(['ws', ...OPT])
+    expect(r.exitCode).toBe(0)
+    expect(r.stdout).toContain('ws1234')
+    expect(r.stdout).toContain('staging')
+    expect(r.stdout).toContain('Staging')
+    expect(r.stdout.indexOf('ID')).toBeLessThan(r.stdout.indexOf('SLUG'))
+    expect(r.stdout.indexOf('SLUG')).toBeLessThan(r.stdout.indexOf('NAME'))
+  })
+
+  it('does not show full UUID in default view', async () => {
+    mocks.mockGet(`/v1/orgs/${ORG_SLUG}/workspaces`, { workspaces: [WS] })
+    const r = await run(['ws', ...OPT])
+    expect(r.stdout).not.toContain(WS.id)
+  })
+
+  it('-o wide adds FULL ID column', async () => {
+    mocks.mockGet(`/v1/orgs/${ORG_SLUG}/workspaces`, { workspaces: [WS] })
+    const r = await run(['ws', '-o', 'wide', ...OPT])
+    expect(r.exitCode).toBe(0)
+    expect(r.stdout).toContain('FULL ID')
+    expect(r.stdout).toContain(WS.id)
+  })
+
+  it('-o json returns raw JSON array', async () => {
+    mocks.mockGet(`/v1/orgs/${ORG_SLUG}/workspaces`, { workspaces: [WS] })
+    const r = await run(['ws', '-o', 'json', ...OPT])
+    const parsed = JSON.parse(r.stdout)
+    expect(Array.isArray(parsed)).toBe(true)
+    expect(parsed[0].shortId).toBe('ws1234')
+  })
+})
+
+// ── create ───────────────────────────────────────────────────────────────────
+
+describe('flect ws create', () => {
+  it('sends only name when no slug given', async () => {
+    const captured = mocks.mockPostCapture(`/v1/orgs/${ORG_SLUG}/workspaces`, { workspace: WS })
+    const r = await run(['ws', 'create', '--name', 'Staging', ...OPT])
+    expect(r.exitCode).toBe(0)
+    const body = captured.body as Record<string, unknown>
+    expect(body.name).toBe('Staging')
+    expect(body.slug).toBeUndefined()
+  })
+
+  it('sends explicit slug when provided', async () => {
+    const captured = mocks.mockPostCapture(`/v1/orgs/${ORG_SLUG}/workspaces`, { workspace: WS })
+    await run(['ws', 'create', '--name', 'Staging', '--slug', 'staging', ...OPT])
+    expect((captured.body as Record<string, unknown>).slug).toBe('staging')
+  })
+
+  it('shows shortId in output, not full UUID', async () => {
+    mocks.mockPost(`/v1/orgs/${ORG_SLUG}/workspaces`, { workspace: WS })
+    const r = await run(['ws', 'create', '--name', 'Staging', ...OPT])
+    expect(r.stdout).toContain('ws1234')
+    expect(r.stdout).not.toContain(WS.id)
+  })
+})
+
+// ── get ───────────────────────────────────────────────────────────────────────
+
+describe('flect ws get', () => {
+  it('works with slug', async () => {
+    mocks.mockGet(`/v1/orgs/${ORG_SLUG}/workspaces/staging`, { workspace: WS })
+    const r = await run(['ws', 'get', 'staging', ...OPT])
+    expect(r.exitCode).toBe(0)
+    expect(r.stdout).toContain('Staging')
+  })
+
+  it('works with shortId', async () => {
+    mocks.mockGet(`/v1/orgs/${ORG_SLUG}/workspaces/ws1234`, { workspace: WS })
+    const r = await run(['ws', 'get', 'ws1234', ...OPT])
+    expect(r.exitCode).toBe(0)
+    expect(r.stdout).toContain('Staging')
+  })
+
+  it('id field shows shortId, full_id field shows UUID', async () => {
+    mocks.mockGet(`/v1/orgs/${ORG_SLUG}/workspaces/staging`, { workspace: WS })
+    const r = await run(['ws', 'get', 'staging', ...OPT])
+    const lines  = r.stdout.split('\n')
+    const idLine = lines.find(l => /^\s+id\s/.test(l))
+    expect(idLine).toContain('ws1234')
+    expect(idLine).not.toContain(WS.id)
+  })
+})
+
+// ── update ────────────────────────────────────────────────────────────────────
+
+describe('flect ws update', () => {
+  it('works with slug', async () => {
+    const captured = mocks.mockPatchCapture(`/v1/orgs/${ORG_SLUG}/workspaces/staging`, { workspace: { ...WS, name: 'Staging Env' } })
+    const r = await run(['ws', 'update', 'staging', '--name', 'Staging Env', ...OPT])
+    expect(r.exitCode).toBe(0)
+    expect((captured.body as Record<string, unknown>).name).toBe('Staging Env')
+  })
+
+  it('works with shortId', async () => {
+    const captured = mocks.mockPatchCapture(`/v1/orgs/${ORG_SLUG}/workspaces/ws1234`, { workspace: { ...WS, name: 'Staging Env' } })
+    const r = await run(['ws', 'update', 'ws1234', '--name', 'Staging Env', ...OPT])
+    expect(r.exitCode).toBe(0)
+    expect((captured.body as Record<string, unknown>).name).toBe('Staging Env')
+  })
+})
+
+// ── delete ────────────────────────────────────────────────────────────────────
+
+describe('flect ws delete', () => {
+  it('works with slug', async () => {
+    mocks.mockDelete(`/v1/orgs/${ORG_SLUG}/workspaces/staging`)
+    const r = await run(['ws', 'delete', 'staging', ...OPT])
+    expect(r.exitCode).toBe(0)
+    expect(r.stdout).toContain('staging')
+  })
+
+  it('works with shortId', async () => {
+    mocks.mockDelete(`/v1/orgs/${ORG_SLUG}/workspaces/ws1234`)
+    const r = await run(['ws', 'delete', 'ws1234', ...OPT])
+    expect(r.exitCode).toBe(0)
+  })
+})

package/src/__tests__/helpers.ts

@@ -0,0 +1,29 @@
+import { Command }                                                          from 'commander'
+import { buildOrgCommand, buildWsCommand, buildProjCommand, buildEnvCommand, addGlobalCommands } from '../cli.js'
+import { createApiClient }                                                  from '@baseworks/cli/client'
+import { createContextManager }                                             from '@baseworks/cli/context'
+import { runCommand, createMocks, server }                                  from '@baseworks/cli/testing'
+
+export { runCommand, server }
+
+export const TEST_BASE = 'http://flect.test'
+
+export const mocks = createMocks(TEST_BASE)
+
+export function makeProgram(token = 'test-token') {
+  const ctx  = createContextManager('org-test')
+  const http = createApiClient(() => token, () => TEST_BASE)
+  const deps = { http, ctx, appBase: TEST_BASE, cliName: 'flect' }
+
+  const program = new Command('flect').exitOverride().enablePositionalOptions()
+  addGlobalCommands(program, deps)
+  program.addCommand(buildOrgCommand(deps))
+  program.addCommand(buildWsCommand(deps))
+  program.addCommand(buildProjCommand(deps))
+  program.addCommand(buildEnvCommand(deps))
+  return program
+}
+
+export function run(args: string[]) {
+  return runCommand(makeProgram(), args)
+}