58 lines
1.8 KiB
Markdown
58 lines
1.8 KiB
Markdown
|
# Task ID: 92
|
||
|
|
|
||
|
|
**Title:** Implement mcpctl describe stage Command
|
||
|
|
|
||
|
|
**Status:** cancelled
|
||
|
|
|
||
|
|
**Dependencies:** 79 ✓
|
||
|
|
|
||
|
|
**Priority:** medium
|
||
|
|
|
||
|
|
**Description:** Add CLI command to show detailed information about a specific stage including its source location.
|
||
|
|
|
||
|
|
**Details:**
|
||
|
|
|
||
|
|
Create `src/cli/src/commands/describe-stage.ts`:
|
||
|
|
|
||
|
|
```typescript
|
||
|
|
import { Command } from 'commander';
|
||
|
|
import { listStages, getStage } from 'mcplocal/proxymodel/stage-registry';
|
||
|
|
import { join } from 'path';
|
||
|
|
|
||
|
|
const STAGES_DIR = join(process.env.HOME ?? '', '.mcpctl', 'stages');
|
||
|
|
|
||
|
|
const STAGE_DESCRIPTIONS: Record<string, string> = {
|
||
|
|
'passthrough': 'Returns content unchanged. No processing.',
|
||
|
|
'paginate': 'Splits large content into pages with navigation.',
|
||
|
|
'section-split': 'Splits content on structural boundaries (headers, JSON keys, etc.).',
|
||
|
|
'summarize-tree': 'Recursively summarizes sections with hierarchical navigation.',
|
||
|
|
};
|
||
|
|
|
||
|
|
export function registerDescribeStage(program: Command): void {
|
||
|
|
program
|
||
|
|
.command('describe stage <name>')
|
||
|
|
.description('Show detailed information about a stage')
|
||
|
|
.action(async (name: string) => {
|
||
|
|
const stages = listStages();
|
||
|
|
const stageInfo = stages.find(s => s.name === name);
|
||
|
|
|
||
|
|
if (!stageInfo) {
|
||
|
|
console.error(`Stage '${name}' not found`);
|
||
|
|
process.exit(1);
|
||
|
|
}
|
||
|
|
|
||
|
|
console.log(`Name: ${name}`);
|
||
|
|
console.log(`Source: ${stageInfo.source}`);
|
||
|
|
if (stageInfo.source === 'local') {
|
||
|
|
console.log(`Path: ${join(STAGES_DIR, name + '.ts')}`);
|
||
|
|
}
|
||
|
|
console.log(`Description: ${STAGE_DESCRIPTIONS[name] ?? 'Custom stage'}`);
|
||
|
|
console.log(`Requires LLM: ${requiresLlm(name) ? 'yes' : 'no'}`);
|
||
|
|
});
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
**Test Strategy:**
|
||
|
|
|
||
|
|
CLI test: `mcpctl describe stage passthrough` shows expected output. Test with custom stage, verify path is shown correctly.
|