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,235 @@
'use client';
import { CalendarIcon, FileTextIcon, UsersIcon } from 'lucide-react';
import { Badge } from '@kit/ui/badge';
import { Card, CardContent, CardHeader, CardTitle } from '@kit/ui/card';
import { Progress } from '@kit/ui/progress';
import { Separator } from '@kit/ui/separator';
import { Tabs, TabsContent, TabsList, TabsTrigger } from '@kit/ui/tabs';
import { UserStoryDisplay } from '../../../_components/user-story-display';
import type { PRDData } from '../../../_lib/server/prd-page.loader';
interface PRDDetailViewProps {
filename: string;
prd: PRDData;
}
export function PRDDetailView({ filename, prd }: PRDDetailViewProps) {
return (
<div className="space-y-6 p-4">
{/* Header */}
<div className="flex items-center gap-4">
<div>
<div className="flex items-center gap-3">
<FileTextIcon className="h-5 w-5" />
<h1 className="text-2xl font-bold">{prd.introduction.title}</h1>
</div>
<div className="text-muted-foreground flex items-center gap-4 text-sm">
<span className="flex items-center gap-1">
<CalendarIcon className="h-3 w-3" />
Updated {prd.metadata.lastUpdated}
</span>
<span>{filename}</span>
</div>
</div>
</div>
{/* Progress Overview */}
<Card>
<CardHeader>
<CardTitle className="flex items-center gap-2 text-lg">
Progress Overview
</CardTitle>
</CardHeader>
<CardContent className="space-y-4">
<div className="flex items-center justify-between">
<span className="text-sm font-medium">Overall Progress</span>
<span className="text-sm font-medium">{prd.progress.overall}%</span>
</div>
<Progress value={prd.progress.overall} className="h-3" />
<div className="text-muted-foreground flex justify-between text-sm">
<span>
{prd.progress.completed} of {prd.progress.total} user stories
completed
</span>
<span>{prd.progress.total - prd.progress.completed} remaining</span>
</div>
</CardContent>
</Card>
{/* Main Content */}
<Tabs defaultValue="overview" className="space-y-6">
<TabsList className="grid w-full grid-cols-4">
<TabsTrigger value="overview">Overview</TabsTrigger>
<TabsTrigger value="requirements">Requirements</TabsTrigger>
<TabsTrigger value="user-stories">
User Stories ({prd.userStories.length})
</TabsTrigger>
<TabsTrigger value="metadata">Metadata</TabsTrigger>
</TabsList>
<TabsContent value="overview" className="space-y-6">
<Card>
<CardHeader>
<CardTitle>Project Overview</CardTitle>
</CardHeader>
<CardContent className="space-y-4">
<div>
<h4 className="mb-2 font-medium">Description</h4>
<p className="text-muted-foreground">
{prd.introduction.overview}
</p>
</div>
<Separator />
<div>
<h4 className="mb-2 font-medium">Problem Statement</h4>
<p className="text-muted-foreground">
{prd.problemStatement.problem}
</p>
</div>
<Separator />
<div>
<h4 className="mb-2 font-medium">Market Opportunity</h4>
<p className="text-muted-foreground">
{prd.problemStatement.marketOpportunity}
</p>
</div>
</CardContent>
</Card>
</TabsContent>
<TabsContent value="requirements" className="space-y-6">
<div className="grid gap-6 md:grid-cols-2">
<Card>
<CardHeader>
<CardTitle className="flex items-center gap-2">
<UsersIcon className="h-4 w-4" />
Target Users
</CardTitle>
</CardHeader>
<CardContent>
<ul className="space-y-2">
{prd.problemStatement.targetUsers?.map(
(user, index: number) => (
<li key={index} className="flex items-center gap-2">
<span className="text-muted-foreground"></span>
<span>{user}</span>
</li>
),
)}
</ul>
</CardContent>
</Card>
<Card>
<CardHeader>
<CardTitle>Key Features</CardTitle>
</CardHeader>
<CardContent>
<ul className="space-y-2">
{prd.solutionOverview.keyFeatures?.map((feature, index) => (
<li key={index} className="flex items-center gap-2">
<span className="text-muted-foreground"></span>
<span>{feature}</span>
</li>
))}
</ul>
</CardContent>
</Card>
<Card className="md:col-span-2">
<CardHeader>
<CardTitle>Solution Description</CardTitle>
</CardHeader>
<CardContent>
<p className="text-muted-foreground">
{prd.solutionOverview.description}
</p>
</CardContent>
</Card>
<Card className="md:col-span-2">
<CardHeader>
<CardTitle>Success Metrics</CardTitle>
</CardHeader>
<CardContent>
<ul className="space-y-2">
{prd.solutionOverview.successMetrics?.map((metric, index) => (
<li key={index} className="flex items-center gap-2">
<span className="text-muted-foreground"></span>
<span>{metric}</span>
</li>
))}
</ul>
</CardContent>
</Card>
</div>
</TabsContent>
<TabsContent value="user-stories">
<UserStoryDisplay userStories={prd.userStories} />
</TabsContent>
<TabsContent value="metadata" className="space-y-6">
<Card>
<CardHeader>
<CardTitle>Metadata</CardTitle>
</CardHeader>
<CardContent className="space-y-4">
<div className="grid gap-4 md:grid-cols-2">
<div>
<h4 className="mb-1 font-medium">Last Updated</h4>
<p className="text-muted-foreground">
{prd.metadata.lastUpdated}
</p>
</div>
<div>
<h4 className="mb-1 font-medium">Version</h4>
<p className="text-muted-foreground">
{prd.metadata.version}
</p>
</div>
<div>
<h4 className="mb-1 font-medium">Filename</h4>
<p className="text-muted-foreground">{filename}</p>
</div>
<div>
<h4 className="mb-1 font-medium">Total User Stories</h4>
<p className="text-muted-foreground">{prd.progress.total}</p>
</div>
</div>
<Separator />
<div>
<h4 className="mb-2 font-medium">Progress Breakdown</h4>
<div className="grid gap-2 text-sm">
<div className="flex justify-between">
<span>Completed Stories:</span>
<Badge variant="default">{prd.progress.completed}</Badge>
</div>
<div className="flex justify-between">
<span>Remaining Stories:</span>
<Badge variant="secondary">
{prd.progress.total - prd.progress.completed}
</Badge>
</div>
<div className="flex justify-between">
<span>Overall Progress:</span>
<Badge variant="outline">{prd.progress.overall}%</Badge>
</div>
</div>
</div>
</CardContent>
</Card>
</TabsContent>
</Tabs>
</div>
);
}

View File

@@ -0,0 +1,44 @@
import { Metadata } from 'next';
import { notFound } from 'next/navigation';
import { loadPRDPageData } from '../../_lib/server/prd-page.loader';
import { PRDDetailView } from './_components/prd-detail-view';
interface PRDPageProps {
params: Promise<{
filename: string;
}>;
}
export async function generateMetadata({
params,
}: PRDPageProps): Promise<Metadata> {
const { filename } = await params;
try {
const prd = await loadPRDPageData(filename);
return {
title: `${prd.introduction.title} - PRD`,
description: prd.introduction.overview,
};
} catch {
return {
title: 'PRD Not Found',
};
}
}
export default async function PRDPage({ params }: PRDPageProps) {
const { filename } = await params;
try {
const prd = await loadPRDPageData(filename);
return <PRDDetailView filename={filename} prd={prd} />;
} catch (error) {
console.error('Failed to load PRD:', error);
notFound();
}
}

View File

@@ -0,0 +1,125 @@
'use client';
import { useState } from 'react';
import Link from 'next/link';
import { CalendarIcon, FileTextIcon, SearchIcon } from 'lucide-react';
import { Card, CardContent, CardHeader, CardTitle } from '@kit/ui/card';
import { Input } from '@kit/ui/input';
import { Progress } from '@kit/ui/progress';
interface PRDSummary {
filename: string;
title: string;
lastUpdated: string;
progress: number;
totalStories: number;
completedStories: number;
}
interface PRDsListInterfaceProps {
initialPrds: PRDSummary[];
}
export function PRDsListInterface({ initialPrds }: PRDsListInterfaceProps) {
const [searchTerm, setSearchTerm] = useState('');
const filteredPrds = initialPrds.filter(
(prd) =>
prd.title.toLowerCase().includes(searchTerm.toLowerCase()) ||
prd.filename.toLowerCase().includes(searchTerm.toLowerCase()),
);
return (
<div className="space-y-6 p-4">
{/* Header */}
<div className="flex items-center justify-between">
<div>
<div className="flex items-center gap-3">
<FileTextIcon className="h-6 w-6" />
<h1 className="text-2xl font-bold">
Product Requirements Documents
</h1>
</div>
<p className="text-muted-foreground">
Browse and view all PRDs in your project
</p>
</div>
</div>
{/* Search */}
<div className="flex w-full flex-col gap-4">
<div className="relative max-w-md">
<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>
</div>
{/* PRD Grid */}
{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>
</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>
)}
</div>
);
}

View File

@@ -0,0 +1,16 @@
import { Metadata } from 'next';
import { loadPRDs } from '../_lib/server/prd-loader';
import { PRDsListInterface } from './_components/prds-list-interface';
export const metadata: Metadata = {
title: 'PRDs - MCP Server',
description: 'Browse and view all Product Requirements Documents',
};
export default async function PRDsPage() {
// Load PRDs on the server side
const initialPrds = await loadPRDs();
return <PRDsListInterface initialPrds={initialPrds} />;
}