# Task ID: 93

**Title:** Implement mcpctl create stage Command

**Status:** cancelled

**Dependencies:** 71 ✓

**Priority:** medium

**Description:** Add CLI command to scaffold a new custom stage with boilerplate TypeScript code.

**Details:**

Create `src/cli/src/commands/create-stage.ts`:

```typescript
import { Command } from 'commander';
import { mkdir, writeFile, access } from 'fs/promises';
import { join } from 'path';

const STAGES_DIR = join(process.env.HOME ?? '', '.mcpctl', 'stages');

const STAGE_TEMPLATE = `import type { StageHandler } from 'mcpctl/proxymodel';

/**
 * Custom stage: {{name}}
 * 
 * Modify this handler to transform content as needed.
 * Available in ctx:
 *   - ctx.llm.complete(prompt) - call the configured LLM
 *   - ctx.cache.getOrCompute(key, fn) - cache expensive computations
 *   - ctx.config - stage configuration from proxymodel YAML
 *   - ctx.originalContent - raw content before any stage processing
 *   - ctx.log - structured logging
 */
const handler: StageHandler = async (content, ctx) => {
  // TODO: Implement your transformation
  return { content };
};

export default handler;
`;

export function registerCreateStage(program: Command): void {
  program
    .command('create stage <name>')
    .description('Create a new custom stage')
    .action(async (name: string) => {
      await mkdir(STAGES_DIR, { recursive: true });
      
      const filePath = join(STAGES_DIR, `${name}.ts`);
      
      try {
        await access(filePath);
        console.error(`Stage '${name}' already exists at ${filePath}`);
        process.exit(1);
      } catch {
        // File doesn't exist, good
      }
      
      const code = STAGE_TEMPLATE.replace(/\{\{name\}\}/g, name);
      await writeFile(filePath, code);
      
      console.log(`Created ${filePath}`);
      console.log('Edit the file to implement your stage logic.');
    });
}
```

**Test Strategy:**

CLI test: `mcpctl create stage my-filter` creates file at expected path with correct template. Test error when stage already exists. Verify generated code compiles.