skillhub/cli/test/integration/remove-command.test.ts
dongmucat 9643e4157c test(cli): migrate comprehensive test suite from test/cli-integration-coverage
Migrated 39 test files covering CLI integration and unit testing:
- 6 new integration tests (auth-resolution, concurrency, cross-command, inventory-resilience, multi-registry, version-upgrade-flow)
- Enhanced 7 existing integration tests with comprehensive scenarios
- Updated 2 unit tests with correct exit code expectations

All tests use fake registry approach (no E2E/browser required) and pass lint/build/test checks.
2026-05-13 11:14:20 +08:00

430 lines
14 KiB
TypeScript

import { afterEach, describe, expect, test } from 'bun:test'
import { mkdir, writeFile } from 'node:fs/promises'
import { createTempHome } from '../helpers/temp-env'
import { startFakeRegistry } from '../helpers/fake-registry'
import { runCli } from '../helpers/run-cli'
let registry: Awaited<ReturnType<typeof startFakeRegistry>> | undefined
afterEach(() => {
registry?.stop()
registry = undefined
})
// ---------------------------------------------------------------------------
// Helpers
// ---------------------------------------------------------------------------
/** Write a minimal inventory.json under <home>/.skillhub/ */
async function seedInventory(home: string, items: object[]) {
const dir = `${home}/.skillhub`
await mkdir(dir, { recursive: true })
await writeFile(`${dir}/inventory.json`, JSON.stringify({ items }, null, 2))
}
/** Create the install directory on disk so the remove service finds it. */
async function createInstallDir(path: string) {
await mkdir(path, { recursive: true })
}
/** Build a minimal inventory item with one target. */
function makeItem(opts: {
registry: string
namespace: string
slug: string
agent: string
rootDir: string
installDir: string
}) {
return {
registry: opts.registry,
namespace: opts.namespace,
slug: opts.slug,
version: '1.0.0',
targets: [
{
agent: opts.agent,
rootDir: opts.rootDir,
installDir: opts.installDir,
installedAt: '2026-01-01T00:00:00.000Z'
}
]
}
}
// ---------------------------------------------------------------------------
// P0 — Mutually exclusive flag pairs
// ---------------------------------------------------------------------------
describe('remove command — flag validation (P0)', () => {
test('--all + --agent are mutually exclusive', async () => {
const env = await createTempHome()
const result = await runCli(
['remove', 'my-skill', '--all', '--agent', 'claude-code'],
{ HOME: env.home, USERPROFILE: env.home }
)
expect(result.exitCode).toBe(5) // EXIT.usage
expect(result.stderr).toContain('--all cannot be used with --agent')
})
test('--remote + --agent are mutually exclusive', async () => {
const env = await createTempHome()
const result = await runCli(
['remove', 'my-skill', '--remote', '--agent', 'claude-code'],
{ HOME: env.home, USERPROFILE: env.home }
)
expect(result.exitCode).toBe(5) // EXIT.usage
expect(result.stderr).toContain('--remote cannot be used with --agent or --all')
})
test('--remote + --all are mutually exclusive', async () => {
const env = await createTempHome()
const result = await runCli(
['remove', 'my-skill', '--remote', '--all'],
{ HOME: env.home, USERPROFILE: env.home }
)
expect(result.exitCode).toBe(5) // EXIT.usage
expect(result.stderr).toContain('--remote cannot be used with --agent or --all')
})
test('--remote without --hard in non-interactive mode fails with usage error', async () => {
const env = await createTempHome()
// Bun.spawn with piped stdin is never a TTY — this exercises the non-interactive guard.
const result = await runCli(
['remove', 'my-skill', '--remote'],
{ HOME: env.home, USERPROFILE: env.home }
)
expect(result.exitCode).toBe(5) // EXIT.usage
expect(result.stderr).toContain('non-interactive remote delete requires --hard')
})
test('--remote --hard calls deleteRemote and exits 0', async () => {
const env = await createTempHome()
registry = await startFakeRegistry({
token: 'sk_ok',
user: { handle: 'u1', displayName: 'User One' },
skills: [{ namespace: 'global', slug: 'my-skill' }]
})
// Establish credentials first
await runCli(['login', '--registry', registry.url, '--token', 'sk_ok'], {
HOME: env.home,
USERPROFILE: env.home
})
const result = await runCli(
['remove', 'my-skill', '--remote', '--hard', '--registry', registry.url],
{ HOME: env.home, USERPROFILE: env.home }
)
expect(result.exitCode).toBe(0)
expect(result.stdout).toContain('global/my-skill')
expect(result.stdout).toContain('remote-hard-delete')
expect(registry.received.delete).toEqual({
namespace: 'global',
slug: 'my-skill',
token: expect.any(String)
})
})
})
// ---------------------------------------------------------------------------
// P1 — Happy paths and edge cases
// ---------------------------------------------------------------------------
describe('remove command — local remove (P1)', () => {
test('--json shape for local remove (happy path)', async () => {
const env = await createTempHome()
registry = await startFakeRegistry({ token: 'sk_ok' })
const rootDir = `${env.home}/agents/claude-code`
const installDir = `${rootDir}/skills/my-skill`
await createInstallDir(installDir)
await seedInventory(env.home, [
makeItem({
registry: registry.url,
namespace: 'global',
slug: 'my-skill',
agent: 'claude-code',
rootDir,
installDir
})
])
const result = await runCli(
['remove', 'my-skill', '--registry', registry.url, '--json'],
{ HOME: env.home, USERPROFILE: env.home }
)
expect(result.exitCode).toBe(0)
const parsed = JSON.parse(result.stdout)
expect(parsed).toMatchObject({ ok: true, scope: 'local' })
expect(Array.isArray(parsed.removed)).toBe(true)
})
test('--json shape for --remote --hard', async () => {
const env = await createTempHome()
registry = await startFakeRegistry({
token: 'sk_ok',
user: { handle: 'u1', displayName: 'User One' },
skills: [{ namespace: 'global', slug: 'my-skill' }]
})
await runCli(['login', '--registry', registry.url, '--token', 'sk_ok'], {
HOME: env.home,
USERPROFILE: env.home
})
const result = await runCli(
['remove', 'my-skill', '--remote', '--hard', '--registry', registry.url, '--json'],
{ HOME: env.home, USERPROFILE: env.home }
)
expect(result.exitCode).toBe(0)
const parsed = JSON.parse(result.stdout)
expect(parsed).toMatchObject({
ok: true,
scope: 'remote',
action: 'hard-delete',
namespace: 'global',
slug: 'my-skill'
})
expect(registry.received.delete).toEqual({
namespace: 'global',
slug: 'my-skill',
token: expect.any(String)
})
})
test('stale record branch (existed: false) shows distinct human copy', async () => {
const env = await createTempHome()
registry = await startFakeRegistry({ token: 'sk_ok' })
const rootDir = `${env.home}/agents/claude-code`
// Intentionally do NOT create installDir — simulates stale record
const installDir = `${rootDir}/skills/stale-skill`
await mkdir(rootDir, { recursive: true })
await seedInventory(env.home, [
makeItem({
registry: registry.url,
namespace: 'global',
slug: 'stale-skill',
agent: 'claude-code',
rootDir,
installDir
})
])
const result = await runCli(
['remove', 'stale-skill', '--registry', registry.url],
{ HOME: env.home, USERPROFILE: env.home }
)
expect(result.exitCode).toBe(0)
expect(result.stdout).toContain('directory already missing')
})
test('--agent filter removes only matching agent target', async () => {
const env = await createTempHome()
registry = await startFakeRegistry({ token: 'sk_ok' })
const rootDir = `${env.home}/agents`
const installDirClaude = `${rootDir}/claude-code/skills/shared-skill`
const installDirCursor = `${rootDir}/cursor/skills/shared-skill`
await createInstallDir(installDirClaude)
await createInstallDir(installDirCursor)
// Two targets for the same skill, different agents
await seedInventory(env.home, [
{
registry: registry.url,
namespace: 'global',
slug: 'shared-skill',
version: '1.0.0',
targets: [
{
agent: 'claude-code',
rootDir: `${rootDir}/claude-code`,
installDir: installDirClaude,
installedAt: '2026-01-01T00:00:00.000Z'
},
{
agent: 'cursor',
rootDir: `${rootDir}/cursor`,
installDir: installDirCursor,
installedAt: '2026-01-01T00:00:00.000Z'
}
]
}
])
const result = await runCli(
['remove', 'shared-skill', '--agent', 'claude-code', '--registry', registry.url, '--json'],
{ HOME: env.home, USERPROFILE: env.home }
)
expect(result.exitCode).toBe(0)
const parsed = JSON.parse(result.stdout)
expect(parsed.removed).toHaveLength(1)
expect(parsed.removed[0].agent).toBe('claude-code')
})
test('--all removes all targets for the skill', async () => {
const env = await createTempHome()
registry = await startFakeRegistry({ token: 'sk_ok' })
const rootDir = `${env.home}/agents`
const installDirA = `${rootDir}/claude-code/skills/multi-skill`
const installDirB = `${rootDir}/cursor/skills/multi-skill`
await createInstallDir(installDirA)
await createInstallDir(installDirB)
await seedInventory(env.home, [
{
registry: registry.url,
namespace: 'global',
slug: 'multi-skill',
version: '1.0.0',
targets: [
{
agent: 'claude-code',
rootDir: `${rootDir}/claude-code`,
installDir: installDirA,
installedAt: '2026-01-01T00:00:00.000Z'
},
{
agent: 'cursor',
rootDir: `${rootDir}/cursor`,
installDir: installDirB,
installedAt: '2026-01-01T00:00:00.000Z'
}
]
}
])
const result = await runCli(
['remove', 'multi-skill', '--all', '--registry', registry.url, '--json'],
{ HOME: env.home, USERPROFILE: env.home }
)
expect(result.exitCode).toBe(0)
const parsed = JSON.parse(result.stdout)
expect(parsed.removed).toHaveLength(2)
const agents = parsed.removed.map((r: { agent: string }) => r.agent).sort()
expect(agents).toEqual(['claude-code', 'cursor'])
})
// -------------------------------------------------------------------------
// P1: --remote --hard against a slug that doesn't exist on the server
// -------------------------------------------------------------------------
test('--remote --hard for a nonexistent slug surfaces server 404 as non-zero exit', async () => {
const env = await createTempHome()
registry = await startFakeRegistry({
token: 'sk_ok',
user: { handle: 'u', displayName: 'U' }
// No skills configured → DELETE returns 404.
})
const result = await runCli(
[
'remove', 'never-published',
'--remote', '--hard',
'--namespace', 'global',
'--registry', registry.url,
'--token', 'sk_ok'
],
{ HOME: env.home, USERPROFILE: env.home }
)
expect(result.exitCode).not.toBe(0)
expect(result.stderr.toLowerCase()).toMatch(/404|not found|registry returned 4/)
})
// -------------------------------------------------------------------------
// P1: --agent on a multi-target inventory leaves OTHER agents' targets
// intact in the inventory file (not just in the JSON envelope).
// -------------------------------------------------------------------------
test('--agent removes one target while leaving others in inventory.json', async () => {
const env = await createTempHome()
registry = await startFakeRegistry({ token: 'sk_ok' })
const rootDir = `${env.home}/agents`
const codexDir = `${rootDir}/codex/skills/keep-others`
const claudeDir = `${rootDir}/claude-code/skills/keep-others`
await createInstallDir(codexDir)
await createInstallDir(claudeDir)
await seedInventory(env.home, [
{
registry: registry.url,
namespace: 'global',
slug: 'keep-others',
version: '1.0.0',
targets: [
{ agent: 'codex', rootDir: `${rootDir}/codex`, installDir: codexDir, installedAt: '2026-04-20T00:00:00Z' },
{ agent: 'claude-code', rootDir: `${rootDir}/claude-code`, installDir: claudeDir, installedAt: '2026-04-20T00:00:00Z' }
]
}
])
const result = await runCli(
['remove', 'keep-others', '--agent', 'codex', '--registry', registry.url, '--json'],
{ HOME: env.home, USERPROFILE: env.home }
)
expect(result.exitCode).toBe(0)
const inv = JSON.parse(await Bun.file(`${env.home}/.skillhub/inventory.json`).text()) as {
items: Array<{ slug: string; targets: Array<{ agent: string }> }>
}
const survived = inv.items.find(i => i.slug === 'keep-others')
expect(survived).toBeDefined()
expect(survived!.targets.map(t => t.agent)).toEqual(['claude-code'])
})
// -------------------------------------------------------------------------
// P1: --agent + --namespace together filter precisely so a same-slug skill
// in a different namespace is not collateral damage.
// -------------------------------------------------------------------------
test('--agent + --namespace filters precisely; same slug under different namespace is untouched', async () => {
const env = await createTempHome()
registry = await startFakeRegistry({ token: 'sk_ok' })
const rootDir = `${env.home}/agents`
const aDir = `${rootDir}/codex/skills/dup-slug-A`
const bDir = `${rootDir}/codex/skills/dup-slug-B`
await createInstallDir(aDir)
await createInstallDir(bDir)
await seedInventory(env.home, [
{
registry: registry.url, namespace: 'team-a', slug: 'dup-slug-A', version: '1.0.0',
targets: [{ agent: 'codex', rootDir: `${rootDir}/codex`, installDir: aDir, installedAt: '2026-04-20T00:00:00Z' }]
},
{
registry: registry.url, namespace: 'team-b', slug: 'dup-slug-B', version: '1.0.0',
targets: [{ agent: 'codex', rootDir: `${rootDir}/codex`, installDir: bDir, installedAt: '2026-04-20T00:00:00Z' }]
}
])
// Remove dup-slug-A only — dup-slug-B should survive even though both
// share the codex agent.
const result = await runCli(
['remove', 'dup-slug-A', '--agent', 'codex', '--registry', registry.url],
{ HOME: env.home, USERPROFILE: env.home }
)
expect(result.exitCode).toBe(0)
const inv = JSON.parse(await Bun.file(`${env.home}/.skillhub/inventory.json`).text()) as {
items: Array<{ slug: string }>
}
const slugs = inv.items.map(i => i.slug).sort()
expect(slugs).toEqual(['dup-slug-B'])
})
})