feat: add apply command for declarative config and interactive setup wizard

Apply reads YAML/JSON config files to sync servers, profiles, and projects
to the daemon with create-or-update semantics. Setup provides an interactive
wizard for configuring MCP servers with environment variables.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

src/cli/tests/commands/apply.test.ts

@@ -0,0 +1,166 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { writeFileSync, mkdtempSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { createApplyCommand } from '../../src/commands/apply.js';
+import type { ApiClient } from '../../src/api-client.js';
+
+function mockClient(): ApiClient {
+  return {
+    get: vi.fn(async () => []),
+    post: vi.fn(async () => ({ id: 'new-id', name: 'test' })),
+    put: vi.fn(async () => ({ id: 'existing-id', name: 'test' })),
+    delete: vi.fn(async () => {}),
+  } as unknown as ApiClient;
+}
+
+describe('apply command', () => {
+  let client: ReturnType<typeof mockClient>;
+  let output: string[];
+  let tmpDir: string;
+  const log = (...args: unknown[]) => output.push(args.map(String).join(' '));
+
+  beforeEach(() => {
+    client = mockClient();
+    output = [];
+    tmpDir = mkdtempSync(join(tmpdir(), 'mcpctl-test-'));
+  });
+
+  it('applies servers from YAML file', async () => {
+    const configPath = join(tmpDir, 'config.yaml');
+    writeFileSync(configPath, `
+servers:
+  - name: slack
+    description: Slack MCP server
+    transport: STDIO
+    packageName: "@anthropic/slack-mcp"
+`);
+
+    const cmd = createApplyCommand({ client, log });
+    await cmd.parseAsync([configPath], { from: 'user' });
+
+    expect(client.post).toHaveBeenCalledWith('/api/v1/servers', expect.objectContaining({ name: 'slack' }));
+    expect(output.join('\n')).toContain('Created server: slack');
+
+    rmSync(tmpDir, { recursive: true, force: true });
+  });
+
+  it('applies servers from JSON file', async () => {
+    const configPath = join(tmpDir, 'config.json');
+    writeFileSync(configPath, JSON.stringify({
+      servers: [{ name: 'github', transport: 'STDIO' }],
+    }));
+
+    const cmd = createApplyCommand({ client, log });
+    await cmd.parseAsync([configPath], { from: 'user' });
+
+    expect(client.post).toHaveBeenCalledWith('/api/v1/servers', expect.objectContaining({ name: 'github' }));
+    expect(output.join('\n')).toContain('Created server: github');
+
+    rmSync(tmpDir, { recursive: true, force: true });
+  });
+
+  it('updates existing servers', async () => {
+    vi.mocked(client.get).mockResolvedValue([{ id: 'srv-1', name: 'slack' }]);
+
+    const configPath = join(tmpDir, 'config.yaml');
+    writeFileSync(configPath, `
+servers:
+  - name: slack
+    description: Updated description
+    transport: STDIO
+`);
+
+    const cmd = createApplyCommand({ client, log });
+    await cmd.parseAsync([configPath], { from: 'user' });
+
+    expect(client.put).toHaveBeenCalledWith('/api/v1/servers/srv-1', expect.objectContaining({ name: 'slack' }));
+    expect(output.join('\n')).toContain('Updated server: slack');
+
+    rmSync(tmpDir, { recursive: true, force: true });
+  });
+
+  it('supports dry-run mode', async () => {
+    const configPath = join(tmpDir, 'config.yaml');
+    writeFileSync(configPath, `
+servers:
+  - name: test
+    transport: STDIO
+profiles:
+  - name: default
+    server: test
+`);
+
+    const cmd = createApplyCommand({ client, log });
+    await cmd.parseAsync([configPath, '--dry-run'], { from: 'user' });
+
+    expect(client.post).not.toHaveBeenCalled();
+    expect(output.join('\n')).toContain('Dry run');
+    expect(output.join('\n')).toContain('1 server(s)');
+    expect(output.join('\n')).toContain('1 profile(s)');
+
+    rmSync(tmpDir, { recursive: true, force: true });
+  });
+
+  it('applies profiles with server lookup', async () => {
+    vi.mocked(client.get).mockImplementation(async (url: string) => {
+      if (url === '/api/v1/servers') return [{ id: 'srv-1', name: 'slack' }];
+      return [];
+    });
+
+    const configPath = join(tmpDir, 'config.yaml');
+    writeFileSync(configPath, `
+profiles:
+  - name: default
+    server: slack
+    envOverrides:
+      SLACK_TOKEN: "xoxb-test"
+`);
+
+    const cmd = createApplyCommand({ client, log });
+    await cmd.parseAsync([configPath], { from: 'user' });
+
+    expect(client.post).toHaveBeenCalledWith('/api/v1/profiles', expect.objectContaining({
+      name: 'default',
+      serverId: 'srv-1',
+      envOverrides: { SLACK_TOKEN: 'xoxb-test' },
+    }));
+    expect(output.join('\n')).toContain('Created profile: default');
+
+    rmSync(tmpDir, { recursive: true, force: true });
+  });
+
+  it('skips profiles when server not found', async () => {
+    const configPath = join(tmpDir, 'config.yaml');
+    writeFileSync(configPath, `
+profiles:
+  - name: default
+    server: nonexistent
+`);
+
+    const cmd = createApplyCommand({ client, log });
+    await cmd.parseAsync([configPath], { from: 'user' });
+
+    expect(client.post).not.toHaveBeenCalled();
+    expect(output.join('\n')).toContain("Skipping profile 'default'");
+
+    rmSync(tmpDir, { recursive: true, force: true });
+  });
+
+  it('applies projects', async () => {
+    const configPath = join(tmpDir, 'config.yaml');
+    writeFileSync(configPath, `
+projects:
+  - name: my-project
+    description: A test project
+`);
+
+    const cmd = createApplyCommand({ client, log });
+    await cmd.parseAsync([configPath], { from: 'user' });
+
+    expect(client.post).toHaveBeenCalledWith('/api/v1/projects', expect.objectContaining({ name: 'my-project' }));
+    expect(output.join('\n')).toContain('Created project: my-project');
+
+    rmSync(tmpDir, { recursive: true, force: true });
+  });
+});

src/cli/tests/commands/setup.test.ts

@@ -0,0 +1,141 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { createSetupCommand } from '../../src/commands/setup.js';
+import type { ApiClient } from '../../src/api-client.js';
+import type { SetupPromptDeps } from '../../src/commands/setup.js';
+
+function mockClient(): ApiClient {
+  return {
+    get: vi.fn(async () => []),
+    post: vi.fn(async () => ({ id: 'new-id', name: 'test' })),
+    put: vi.fn(async () => ({})),
+    delete: vi.fn(async () => {}),
+  } as unknown as ApiClient;
+}
+
+function mockPrompt(answers: Record<string, string | boolean>): SetupPromptDeps {
+  const answersQueue = { ...answers };
+  return {
+    input: vi.fn(async (message: string) => {
+      for (const [key, val] of Object.entries(answersQueue)) {
+        if (message.toLowerCase().includes(key.toLowerCase()) && typeof val === 'string') {
+          delete answersQueue[key];
+          return val;
+        }
+      }
+      return '';
+    }),
+    password: vi.fn(async () => 'secret-value'),
+    select: vi.fn(async () => 'STDIO') as SetupPromptDeps['select'],
+    confirm: vi.fn(async (message: string) => {
+      if (message.includes('profile')) return true;
+      if (message.includes('secret')) return false;
+      if (message.includes('another')) return false;
+      return false;
+    }),
+  };
+}
+
+describe('setup command', () => {
+  let client: ReturnType<typeof mockClient>;
+  let output: string[];
+  const log = (...args: unknown[]) => output.push(args.map(String).join(' '));
+
+  beforeEach(() => {
+    client = mockClient();
+    output = [];
+  });
+
+  it('creates server with prompted values', async () => {
+    const prompt = mockPrompt({
+      'transport': 'STDIO',
+      'npm package': '@anthropic/slack-mcp',
+      'docker image': '',
+      'description': 'Slack server',
+      'profile name': 'default',
+      'environment variable name': '',
+    });
+
+    const cmd = createSetupCommand({ client, prompt, log });
+    await cmd.parseAsync(['slack'], { from: 'user' });
+
+    expect(client.post).toHaveBeenCalledWith('/api/v1/servers', expect.objectContaining({
+      name: 'slack',
+      transport: 'STDIO',
+    }));
+    expect(output.join('\n')).toContain("Server 'test' created");
+  });
+
+  it('creates profile with env vars', async () => {
+    vi.mocked(client.post)
+      .mockResolvedValueOnce({ id: 'srv-1', name: 'slack' })  // server create
+      .mockResolvedValueOnce({ id: 'prof-1', name: 'default' }); // profile create
+
+    const prompt = mockPrompt({
+      'transport': 'STDIO',
+      'npm package': '',
+      'docker image': '',
+      'description': '',
+      'profile name': 'default',
+    });
+    // Override confirm to create profile and add one env var
+    let confirmCallCount = 0;
+    vi.mocked(prompt.confirm).mockImplementation(async (msg: string) => {
+      confirmCallCount++;
+      if (msg.includes('profile')) return true;
+      if (msg.includes('secret')) return true;
+      if (msg.includes('another')) return false;
+      return false;
+    });
+    // Override input to provide env var name then empty to stop
+    let inputCallCount = 0;
+    vi.mocked(prompt.input).mockImplementation(async (msg: string) => {
+      inputCallCount++;
+      if (msg.includes('Profile name')) return 'default';
+      if (msg.includes('variable name') && inputCallCount <= 8) return 'API_KEY';
+      if (msg.includes('variable name')) return '';
+      return '';
+    });
+
+    const cmd = createSetupCommand({ client, prompt, log });
+    await cmd.parseAsync(['slack'], { from: 'user' });
+
+    expect(client.post).toHaveBeenCalledTimes(2);
+    const profileCall = vi.mocked(client.post).mock.calls[1];
+    expect(profileCall?.[0]).toBe('/api/v1/profiles');
+    expect(profileCall?.[1]).toEqual(expect.objectContaining({
+      name: 'default',
+      serverId: 'srv-1',
+    }));
+  });
+
+  it('exits if server creation fails', async () => {
+    vi.mocked(client.post).mockRejectedValue(new Error('conflict'));
+
+    const prompt = mockPrompt({
+      'npm package': '',
+      'docker image': '',
+      'description': '',
+    });
+
+    const cmd = createSetupCommand({ client, prompt, log });
+    await cmd.parseAsync(['slack'], { from: 'user' });
+
+    expect(output.join('\n')).toContain('Failed to create server');
+    expect(client.post).toHaveBeenCalledTimes(1); // Only server create, no profile
+  });
+
+  it('skips profile creation when declined', async () => {
+    const prompt = mockPrompt({
+      'npm package': '',
+      'docker image': '',
+      'description': '',
+    });
+    vi.mocked(prompt.confirm).mockResolvedValue(false);
+
+    const cmd = createSetupCommand({ client, prompt, log });
+    await cmd.parseAsync(['test-server'], { from: 'user' });
+
+    expect(client.post).toHaveBeenCalledTimes(1); // Only server create
+    expect(output.join('\n')).toContain('Setup complete');
+  });
+});