Claude sub-agents, PRD, MCP improvements (#359)

1. Added Claude Code sub-agents
2. Added PRD tool to MCP Server
3. Added MCP Server UI to Dev Tools
4. Improved MCP Server Database Tool
5. Updated dependencies
This commit is contained in:
Giancarlo Buomprisco
2025-09-25 12:03:53 +08:00
committed by GitHub
parent 02e2502dcc
commit 2b8572baaa
62 changed files with 5661 additions and 1231 deletions

View File

@@ -0,0 +1,13 @@
import { loadPRDs } from '../_lib/server/prd-loader';
import { McpServerTabs } from './mcp-server-tabs';
import { PRDManagerClient } from './prd-manager-client';
export async function McpServerInterface() {
const initialPrds = await loadPRDs();
return (
<McpServerTabs
prdManagerContent={<PRDManagerClient initialPrds={initialPrds} />}
/>
);
}

View File

@@ -0,0 +1,53 @@
'use client';
import { DatabaseIcon, FileTextIcon } from 'lucide-react';
import { Tabs, TabsContent, TabsList, TabsTrigger } from '@kit/ui/tabs';
interface McpServerTabsProps {
prdManagerContent: React.ReactNode;
databaseToolsContent?: React.ReactNode;
}
export function McpServerTabs({
prdManagerContent,
databaseToolsContent,
}: McpServerTabsProps) {
return (
<div className="h-full">
<Tabs defaultValue="database-tools" className="flex h-full flex-col">
<TabsList className="grid w-full grid-cols-2">
<TabsTrigger
value="database-tools"
className="flex items-center gap-2"
>
<DatabaseIcon className="h-4 w-4" />
Database Tools
</TabsTrigger>
<TabsTrigger value="prd-manager" className="flex items-center gap-2">
<FileTextIcon className="h-4 w-4" />
PRD Manager
</TabsTrigger>
</TabsList>
<TabsContent value="database-tools" className="flex-1 space-y-4">
{databaseToolsContent || (
<div className="flex h-full items-center justify-center">
<div className="text-center">
<DatabaseIcon className="text-muted-foreground mx-auto h-12 w-12" />
<h3 className="mt-4 text-lg font-semibold">Database Tools</h3>
<p className="text-muted-foreground">
Explore database schemas, tables, functions, and enums
</p>
</div>
</div>
)}
</TabsContent>
<TabsContent value="prd-manager" className="flex-1 space-y-4">
{prdManagerContent}
</TabsContent>
</Tabs>
</div>
);
}

View File

@@ -0,0 +1,188 @@
'use client';
import { useState } from 'react';
import Link from 'next/link';
import { CalendarIcon, FileTextIcon, PlusIcon, SearchIcon } from 'lucide-react';
import { Button } from '@kit/ui/button';
import { Card, CardContent, CardHeader, CardTitle } from '@kit/ui/card';
import {
Dialog,
DialogClose,
DialogContent,
DialogHeader,
DialogTitle,
} from '@kit/ui/dialog';
import { Input } from '@kit/ui/input';
import { Progress } from '@kit/ui/progress';
import type { CreatePRDData } from '../_lib/schemas/create-prd.schema';
import { createPRDAction } from '../_lib/server/prd-server-actions';
import { CreatePRDForm } from './create-prd-form';
interface PRDSummary {
filename: string;
title: string;
lastUpdated: string;
progress: number;
totalStories: number;
completedStories: number;
}
interface PRDManagerClientProps {
initialPrds: PRDSummary[];
}
export function PRDManagerClient({ initialPrds }: PRDManagerClientProps) {
const [prds, setPrds] = useState<PRDSummary[]>(initialPrds);
const [searchTerm, setSearchTerm] = useState('');
const [showCreateForm, setShowCreateForm] = useState(false);
const handleCreatePRD = async (data: CreatePRDData) => {
const result = await createPRDAction(data);
if (result.success && result.data) {
const newPRD: PRDSummary = {
filename: result.data.filename,
title: result.data.title,
lastUpdated: result.data.lastUpdated,
progress: result.data.progress,
totalStories: result.data.totalStories,
completedStories: result.data.completedStories,
};
setPrds((prev) => [...prev, newPRD]);
setShowCreateForm(false);
// Note: In a production app, you might want to trigger a router.refresh()
// to reload the server component and get the most up-to-date data
} else {
// Error handling will be managed by the form component via the action result
throw new Error(result.error || 'Failed to create PRD');
}
};
const filteredPrds = prds.filter(
(prd) =>
prd.title.toLowerCase().includes(searchTerm.toLowerCase()) ||
prd.filename.toLowerCase().includes(searchTerm.toLowerCase()),
);
return (
<div className="space-y-6">
{/* Header with search and create button */}
<div className="flex w-full flex-col gap-4 sm:flex-row sm:items-center sm:justify-between">
<div className="relative flex-1">
<SearchIcon className="text-muted-foreground absolute top-1/2 left-3 h-4 w-4 -translate-y-1/2" />
<Input
placeholder="Search PRDs by title or filename..."
value={searchTerm}
onChange={(e) => setSearchTerm(e.target.value)}
className="pl-10"
/>
</div>
<Button
onClick={() => setShowCreateForm(true)}
className="flex items-center gap-2"
>
<PlusIcon className="h-4 w-4" />
Create New PRD
</Button>
</div>
{/* PRD List */}
{filteredPrds.length === 0 ? (
<Card>
<CardContent className="flex h-32 items-center justify-center">
<div className="text-center">
<FileTextIcon className="text-muted-foreground mx-auto h-8 w-8" />
<p className="text-muted-foreground mt-2">
{searchTerm ? 'No PRDs match your search' : 'No PRDs found'}
</p>
{!searchTerm && (
<Button
variant="link"
onClick={() => setShowCreateForm(true)}
className="mt-2"
>
Create your first PRD
</Button>
)}
</div>
</CardContent>
</Card>
) : (
<div className="grid gap-4 md:grid-cols-2 lg:grid-cols-3">
{filteredPrds.map((prd) => (
<Link
key={prd.filename}
href={`/mcp-server/prds/${prd.filename}`}
className="block"
>
<Card className="cursor-pointer transition-shadow hover:shadow-md">
<CardHeader className="pb-3">
<CardTitle className="flex items-start gap-2 text-sm">
<FileTextIcon className="text-muted-foreground mt-0.5 h-4 w-4" />
<span className="line-clamp-2">{prd.title}</span>
</CardTitle>
</CardHeader>
<CardContent className="space-y-3">
{/* Progress */}
<div className="space-y-2">
<div className="text-muted-foreground flex justify-between text-xs">
<span>Progress</span>
<span>
{prd.completedStories}/{prd.totalStories} stories
</span>
</div>
<Progress value={prd.progress} className="h-2" />
<div className="text-right text-xs font-medium">
{prd.progress}%
</div>
</div>
{/* Metadata */}
<div className="text-muted-foreground flex items-center gap-1 text-xs">
<CalendarIcon className="h-3 w-3" />
<span>Updated {prd.lastUpdated}</span>
</div>
{/* Filename */}
<div className="text-muted-foreground text-xs">
{prd.filename}
</div>
</CardContent>
</Card>
</Link>
))}
</div>
)}
{/* Create PRD Form Modal */}
{showCreateForm && (
<Dialog open={showCreateForm} onOpenChange={setShowCreateForm}>
<DialogContent className="max-w-4xl overflow-y-hidden">
<DialogHeader>
<DialogTitle>Create New PRD</DialogTitle>
</DialogHeader>
<div
className="overflow-y-auto p-0.5"
style={{
maxHeight: '800px',
}}
>
<CreatePRDForm onSubmit={handleCreatePRD} />
</div>
</DialogContent>
</Dialog>
)}
</div>
);
}

View File

@@ -0,0 +1,172 @@
'use client';
import {
CheckCircleIcon,
CircleIcon,
ClockIcon,
EyeIcon,
PlayIcon,
XCircleIcon,
} from 'lucide-react';
import { Badge } from '@kit/ui/badge';
import { Card, CardContent, CardHeader, CardTitle } from '@kit/ui/card';
import { Separator } from '@kit/ui/separator';
import { cn } from '@kit/ui/utils';
interface CustomPhase {
id: string;
name: string;
description: string;
color: string;
order: number;
userStoryIds: string[];
}
interface UserStory {
id: string;
title: string;
userStory: string;
businessValue: string;
acceptanceCriteria: string[];
priority: 'P0' | 'P1' | 'P2' | 'P3';
status:
| 'not_started'
| 'research'
| 'in_progress'
| 'review'
| 'completed'
| 'blocked';
notes?: string;
estimatedComplexity?: string;
dependencies?: string[];
completedAt?: string;
}
interface UserStoryDisplayReadOnlyProps {
userStories: UserStory[];
customPhases?: CustomPhase[];
}
const priorityLabels = {
P0: { label: 'Critical', color: 'destructive' as const },
P1: { label: 'High', color: 'default' as const },
P2: { label: 'Medium', color: 'secondary' as const },
P3: { label: 'Low', color: 'outline' as const },
};
const statusIcons = {
not_started: CircleIcon,
research: EyeIcon,
in_progress: PlayIcon,
review: ClockIcon,
completed: CheckCircleIcon,
blocked: XCircleIcon,
};
const statusLabels = {
not_started: 'Not Started',
research: 'Research',
in_progress: 'In Progress',
review: 'Review',
completed: 'Completed',
blocked: 'Blocked',
};
const statusColors = {
not_started: 'text-muted-foreground',
research: 'text-blue-600',
in_progress: 'text-yellow-600',
review: 'text-purple-600',
completed: 'text-green-600',
blocked: 'text-red-600',
};
export function UserStoryDisplay({
userStories,
}: UserStoryDisplayReadOnlyProps) {
const renderUserStory = (story: UserStory) => {
return (
<Card key={story.id}>
<CardHeader className="pb-3">
<CardTitle className="flex items-start gap-4 text-sm">
<span className="line-clamp-2">
{story.id} - {story.title}
</span>
<div className="flex items-center gap-2">
<Badge className={statusColors[story.status]} variant={'outline'}>
{statusLabels[story.status]}
</Badge>
</div>
</CardTitle>
</CardHeader>
<CardContent className="space-y-3">
<p className="text-muted-foreground line-clamp-2 text-sm">
{story.businessValue}
</p>
<div className="flex items-center justify-between text-xs">
<span className="text-muted-foreground">
{story.acceptanceCriteria.length} criteria
</span>
</div>
{/* Acceptance Criteria */}
{story.acceptanceCriteria.length > 0 && (
<div className="space-y-1">
<h5 className="text-xs font-medium">Acceptance Criteria:</h5>
<ul className="space-y-1">
{story.acceptanceCriteria.map((criterion, index) => (
<li key={index} className="flex items-start gap-1 text-xs">
<span className="text-muted-foreground"></span>
<span className="text-muted-foreground line-clamp-1">
{criterion}
</span>
</li>
))}
</ul>
</div>
)}
</CardContent>
</Card>
);
};
return (
<div className="space-y-6">
{/* Header */}
<div>
<h3 className="text-lg font-semibold">User Stories</h3>
<p className="text-muted-foreground text-sm">
View user stories and track progress
</p>
</div>
<div className="flex flex-col gap-4">
{userStories.map(renderUserStory)}
</div>
<div>
<Separator />
</div>
<div>
{userStories.length === 0 && (
<Card>
<CardContent className="flex h-32 items-center justify-center">
<div className="text-center">
<CircleIcon className="text-muted-foreground mx-auto h-8 w-8" />
<p className="text-muted-foreground mt-2">
No user stories yet
</p>
</div>
</CardContent>
</Card>
)}
</div>
</div>
);
}