npm - @mandujs/mcp - Versions diffs - 0.13.0 → 0.17.0 - Mend

@mandujs/mcp 0.13.0 → 0.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (136) hide show

package/README.md +102 -7
package/package.json +3 -2
package/src/adapters/index.ts +20 -20
package/src/adapters/monitor-adapter.ts +100 -100
package/src/adapters/tool-adapter.ts +88 -88
package/src/executor/error-handler.ts +250 -250
package/src/executor/index.ts +22 -22
package/src/executor/tool-executor.ts +148 -148
package/src/hooks/config-watcher.ts +174 -174
package/src/hooks/index.ts +23 -23
package/src/hooks/mcp-hooks.ts +227 -227
package/src/logging/index.ts +15 -15
package/src/logging/mcp-transport.ts +134 -134
package/src/registry/index.ts +13 -13
package/src/registry/mcp-tool-registry.ts +298 -298
package/src/resources/skills/guides.ts +1136 -1136
package/src/resources/skills/index.ts +12 -12
package/src/resources/skills/loader.ts +218 -218
package/src/resources/skills/mandu-composition/SKILL.md +91 -91
package/src/resources/skills/mandu-composition/metadata.json +13 -13
package/src/resources/skills/mandu-composition/rules/_sections.md +26 -26
package/src/resources/skills/mandu-composition/rules/_template.md +77 -77
package/src/resources/skills/mandu-composition/rules/comp-arch-avoid-boolean-props.md +146 -146
package/src/resources/skills/mandu-composition/rules/comp-arch-compound-components.md +164 -164
package/src/resources/skills/mandu-composition/rules/comp-island-event.md +161 -161
package/src/resources/skills/mandu-composition/rules/comp-island-slot-split.md +167 -167
package/src/resources/skills/mandu-composition/rules/comp-pattern-children.md +149 -149
package/src/resources/skills/mandu-composition/rules/comp-state-context-interface.md +148 -148
package/src/resources/skills/mandu-composition/rules/comp-state-lift-state.md +150 -150
package/src/resources/skills/mandu-deployment/SKILL.md +92 -92
package/src/resources/skills/mandu-deployment/_sections.md +41 -41
package/src/resources/skills/mandu-deployment/_template.md +38 -38
package/src/resources/skills/mandu-deployment/metadata.json +13 -13
package/src/resources/skills/mandu-deployment/rules/deploy-build-bun.md +109 -109
package/src/resources/skills/mandu-deployment/rules/deploy-build-output.md +115 -115
package/src/resources/skills/mandu-deployment/rules/deploy-cicd-github.md +219 -219
package/src/resources/skills/mandu-deployment/rules/deploy-docker-bun.md +150 -150
package/src/resources/skills/mandu-deployment/rules/deploy-docker-compose.md +223 -223
package/src/resources/skills/mandu-deployment/rules/deploy-platform-fly.md +152 -152
package/src/resources/skills/mandu-deployment/rules/deploy-platform-render.md +179 -179
package/src/resources/skills/mandu-deployment/rules/deploy-platform-supabase.md +323 -323
package/src/resources/skills/mandu-deployment/rules/deploy-platform-vercel.md +140 -140
package/src/resources/skills/mandu-fs-routes/SKILL.md +82 -82
package/src/resources/skills/mandu-fs-routes/metadata.json +12 -12
package/src/resources/skills/mandu-fs-routes/rules/_sections.md +36 -36
package/src/resources/skills/mandu-fs-routes/rules/_template.md +69 -69
package/src/resources/skills/mandu-fs-routes/rules/routes-api-methods.md +65 -65
package/src/resources/skills/mandu-fs-routes/rules/routes-dynamic-param.md +93 -93
package/src/resources/skills/mandu-fs-routes/rules/routes-naming-page.md +55 -55
package/src/resources/skills/mandu-guard/SKILL.md +129 -129
package/src/resources/skills/mandu-guard/metadata.json +12 -12
package/src/resources/skills/mandu-guard/rules/_sections.md +36 -36
package/src/resources/skills/mandu-guard/rules/_template.md +82 -82
package/src/resources/skills/mandu-guard/rules/guard-config-rules.md +100 -100
package/src/resources/skills/mandu-guard/rules/guard-layer-direction.md +76 -76
package/src/resources/skills/mandu-guard/rules/guard-preset-mandu.md +81 -81
package/src/resources/skills/mandu-guard/rules/guard-validate-import.md +80 -80
package/src/resources/skills/mandu-hydration/SKILL.md +91 -91
package/src/resources/skills/mandu-hydration/metadata.json +12 -12
package/src/resources/skills/mandu-hydration/rules/_sections.md +31 -31
package/src/resources/skills/mandu-hydration/rules/_template.md +72 -72
package/src/resources/skills/mandu-hydration/rules/hydration-data-event.md +109 -109
package/src/resources/skills/mandu-hydration/rules/hydration-directive-use-client.md +55 -55
package/src/resources/skills/mandu-hydration/rules/hydration-island-setup.md +113 -113
package/src/resources/skills/mandu-hydration/rules/hydration-priority-visible.md +68 -68
package/src/resources/skills/mandu-performance/SKILL.md +85 -85
package/src/resources/skills/mandu-performance/metadata.json +14 -14
package/src/resources/skills/mandu-performance/rules/_sections.md +31 -31
package/src/resources/skills/mandu-performance/rules/_template.md +64 -64
package/src/resources/skills/mandu-performance/rules/perf-async-defer-await.md +103 -103
package/src/resources/skills/mandu-performance/rules/perf-async-parallel.md +95 -95
package/src/resources/skills/mandu-performance/rules/perf-bun-file.md +124 -124
package/src/resources/skills/mandu-performance/rules/perf-bun-serve.md +125 -125
package/src/resources/skills/mandu-performance/rules/perf-bundle-imports.md +80 -80
package/src/resources/skills/mandu-performance/rules/perf-bundle-island-lazy.md +145 -145
package/src/resources/skills/mandu-performance/rules/perf-cache-react.md +98 -98
package/src/resources/skills/mandu-performance/rules/perf-render-transitions.md +154 -154
package/src/resources/skills/mandu-security/SKILL.md +87 -87
package/src/resources/skills/mandu-security/metadata.json +13 -13
package/src/resources/skills/mandu-security/rules/_sections.md +31 -31
package/src/resources/skills/mandu-security/rules/_template.md +74 -74
package/src/resources/skills/mandu-security/rules/sec-auth-guard.md +127 -127
package/src/resources/skills/mandu-security/rules/sec-env-management.md +133 -133
package/src/resources/skills/mandu-security/rules/sec-input-validate.md +148 -148
package/src/resources/skills/mandu-security/rules/sec-protect-csrf.md +146 -146
package/src/resources/skills/mandu-security/rules/sec-protect-headers.md +138 -138
package/src/resources/skills/mandu-slot/SKILL.md +85 -85
package/src/resources/skills/mandu-slot/metadata.json +12 -12
package/src/resources/skills/mandu-slot/rules/_sections.md +36 -36
package/src/resources/skills/mandu-slot/rules/_template.md +63 -63
package/src/resources/skills/mandu-slot/rules/slot-basic-structure.md +38 -38
package/src/resources/skills/mandu-slot/rules/slot-ctx-response.md +56 -56
package/src/resources/skills/mandu-slot/rules/slot-guard-auth.md +59 -59
package/src/resources/skills/mandu-slot/rules/slot-http-methods.md +64 -64
package/src/resources/skills/mandu-styling/SKILL.md +154 -154
package/src/resources/skills/mandu-styling/_sections.md +43 -43
package/src/resources/skills/mandu-styling/_template.md +32 -32
package/src/resources/skills/mandu-styling/metadata.json +15 -15
package/src/resources/skills/mandu-styling/rules/style-component-compound.md +235 -235
package/src/resources/skills/mandu-styling/rules/style-component-slots.md +255 -255
package/src/resources/skills/mandu-styling/rules/style-component-tokens.md +205 -205
package/src/resources/skills/mandu-styling/rules/style-island-animations.md +272 -272
package/src/resources/skills/mandu-styling/rules/style-island-scoping.md +167 -167
package/src/resources/skills/mandu-styling/rules/style-island-variants.md +221 -221
package/src/resources/skills/mandu-styling/rules/style-perf-critical.md +209 -209
package/src/resources/skills/mandu-styling/rules/style-perf-purge.md +192 -192
package/src/resources/skills/mandu-styling/rules/style-setup-modules.md +162 -162
package/src/resources/skills/mandu-styling/rules/style-setup-panda.md +164 -164
package/src/resources/skills/mandu-styling/rules/style-setup-tailwind.md +170 -170
package/src/resources/skills/mandu-styling/rules/style-tailwind-v4-gotchas.md +179 -179
package/src/resources/skills/mandu-styling/rules/style-theme-darkmode.md +229 -229
package/src/resources/skills/mandu-testing/SKILL.md +99 -99
package/src/resources/skills/mandu-testing/metadata.json +13 -13
package/src/resources/skills/mandu-testing/rules/_sections.md +26 -26
package/src/resources/skills/mandu-testing/rules/_template.md +65 -65
package/src/resources/skills/mandu-testing/rules/test-component-island.md +195 -195
package/src/resources/skills/mandu-testing/rules/test-e2e-playwright.md +196 -196
package/src/resources/skills/mandu-testing/rules/test-mock-fetch.md +219 -219
package/src/resources/skills/mandu-testing/rules/test-slot-unit.md +192 -192
package/src/resources/skills/mandu-ui/SKILL.md +117 -117
package/src/resources/skills/mandu-ui/_sections.md +23 -23
package/src/resources/skills/mandu-ui/_template.md +32 -32
package/src/resources/skills/mandu-ui/metadata.json +13 -13
package/src/resources/skills/mandu-ui/rules/ui-accessibility-aria.md +232 -232
package/src/resources/skills/mandu-ui/rules/ui-accessibility-focus.md +238 -238
package/src/resources/skills/mandu-ui/rules/ui-composition-patterns.md +259 -259
package/src/resources/skills/mandu-ui/rules/ui-island-integration.md +258 -258
package/src/resources/skills/mandu-ui/rules/ui-radix-patterns.md +213 -213
package/src/resources/skills/mandu-ui/rules/ui-shadcn-setup.md +209 -209
package/src/resources/skills/recipes.ts +932 -932
package/src/tools/ate.ts +219 -0
package/src/tools/index.ts +4 -1
package/src/tools/project.ts +334 -334
package/src/tools/runtime.ts +497 -497
package/src/tools/seo.ts +417 -417
package/src/utils/withWarnings.ts +83 -83

package/src/resources/skills/mandu-ui/rules/ui-island-integration.md CHANGED Viewed

@@ -1,258 +1,258 @@
----
-title: UI Library Island Integration
-impact: MEDIUM
-impactDescription: Proper integration of UI components with Island architecture
-tags: ui, island, integration, client
----
-## UI Library Island Integration
-**Impact: MEDIUM (Proper integration of UI components with Island architecture)**
-UI 라이브러리 컴포넌트를 Mandu Island 아키텍처에 올바르게 통합하세요.
-## "use client" 경계
-```tsx
-// components/ui/button.tsx
-// shadcn/ui 컴포넌트는 이미 클라이언트 컴포넌트
-"use client";
-import { cn } from "@/lib/utils";
-// ...
-```
-```tsx
-// app/dashboard/page.tsx (서버 컴포넌트)
-import { Card, CardHeader, CardTitle, CardContent } from "@/components/ui/card";
-import { DashboardActionsIsland } from "./client";
-export default function DashboardPage() {
-  return (
-    <div>
-      {/* Card는 서버에서 렌더링 (정적 마크업) */}
-      <Card>
-        <CardHeader>
-          <CardTitle>Dashboard</CardTitle>
-        </CardHeader>
-        <CardContent>
-          {/* 인터랙티브 부분만 Island */}
-          <DashboardActionsIsland />
-        </CardContent>
-      </Card>
-    </div>
-  );
-}
-```
-## 서버 데이터 → Island 전달
-```tsx
-// app/users/page.tsx
-import { UserTableIsland } from "./client";
-import { getUsers } from "@/lib/db";
-export default async function UsersPage() {
-  const users = await getUsers();
-  return (
-    <div>
-      <h1>Users</h1>
-      {/* 초기 데이터를 props로 전달 */}
-      <UserTableIsland initialUsers={users} />
-    </div>
-  );
-}
-```
-```tsx
-// app/users/client.tsx
-"use client";
-import { useState } from "react";
-import {
-  Table,
-  TableBody,
-  TableCell,
-  TableHead,
-  TableHeader,
-  TableRow,
-} from "@/components/ui/table";
-import { Button } from "@/components/ui/button";
-export function UserTableIsland({ initialUsers }) {
-  const [users, setUsers] = useState(initialUsers);
-  const handleDelete = async (id: string) => {
-    await fetch(`/api/users/${id}`, { method: "DELETE" });
-    setUsers(users.filter(u => u.id !== id));
-  };
-  return (
-    <Table>
-      <TableHeader>
-        <TableRow>
-          <TableHead>Name</TableHead>
-          <TableHead>Email</TableHead>
-          <TableHead>Actions</TableHead>
-        </TableRow>
-      </TableHeader>
-      <TableBody>
-        {users.map(user => (
-          <TableRow key={user.id}>
-            <TableCell>{user.name}</TableCell>
-            <TableCell>{user.email}</TableCell>
-            <TableCell>
-              <Button
-                variant="destructive"
-                size="sm"
-                onClick={() => handleDelete(user.id)}
-              >
-                Delete
-              </Button>
-            </TableCell>
-          </TableRow>
-        ))}
-      </TableBody>
-    </Table>
-  );
-}
-```
-## Dialog/Modal Island 패턴
-```tsx
-// app/users/client.tsx
-"use client";
-import { useState } from "react";
-import { Button } from "@/components/ui/button";
-import {
-  Dialog,
-  DialogContent,
-  DialogHeader,
-  DialogTitle,
-  DialogTrigger,
-} from "@/components/ui/dialog";
-export function CreateUserIsland() {
-  const [open, setOpen] = useState(false);
-  const handleSubmit = async (data: FormData) => {
-    await fetch("/api/users", {
-      method: "POST",
-      body: data,
-    });
-    setOpen(false);
-  };
-  return (
-    <Dialog open={open} onOpenChange={setOpen}>
-      <DialogTrigger asChild>
-        <Button>Add User</Button>
-      </DialogTrigger>
-      <DialogContent>
-        <DialogHeader>
-          <DialogTitle>Create New User</DialogTitle>
-        </DialogHeader>
-        <form action={handleSubmit}>
-          {/* Form fields */}
-        </form>
-      </DialogContent>
-    </Dialog>
-  );
-}
-```
-## Toast Island
-```tsx
-// app/layout.tsx
-import { Toaster } from "@/components/ui/toaster";
-export default function RootLayout({ children }) {
-  return (
-    <html>
-      <body>
-        {children}
-        {/* Toast는 전역 Island */}
-        <Toaster />
-      </body>
-    </html>
-  );
-}
-```
-```tsx
-// app/form/client.tsx
-"use client";
-import { useToast } from "@/components/ui/use-toast";
-export function FormIsland() {
-  const { toast } = useToast();
-  const handleSubmit = async () => {
-    try {
-      await submitForm();
-      toast({
-        title: "Success",
-        description: "Form submitted successfully",
-      });
-    } catch {
-      toast({
-        title: "Error",
-        description: "Something went wrong",
-        variant: "destructive",
-      });
-    }
-  };
-  // ...
-}
-```
-## Island 간 UI 상태 공유
-```tsx
-// app/sidebar/client.tsx
-"use client";
-import { useIslandEvent } from "@mandujs/core/client";
-export function SidebarIsland() {
-  const [isOpen, setIsOpen] = useState(true);
-  useIslandEvent("toggle-sidebar", () => {
-    setIsOpen(prev => !prev);
-  });
-  return (
-    <aside className={cn(isOpen ? "w-64" : "w-0", "transition-all")}>
-      {/* Sidebar content */}
-    </aside>
-  );
-}
-```
-```tsx
-// app/header/client.tsx
-"use client";
-import { useIslandEvent } from "@mandujs/core/client";
-import { Button } from "@/components/ui/button";
-export function HeaderIsland() {
-  const { emit } = useIslandEvent("toggle-sidebar");
-  return (
-    <header>
-      <Button variant="ghost" size="icon" onClick={() => emit({})}>
-        <MenuIcon />
-      </Button>
-    </header>
-  );
-}
-```
-Reference: [React Server Components](https://react.dev/reference/rsc/server-components)
+---
+title: UI Library Island Integration
+impact: MEDIUM
+impactDescription: Proper integration of UI components with Island architecture
+tags: ui, island, integration, client
+---
+## UI Library Island Integration
+**Impact: MEDIUM (Proper integration of UI components with Island architecture)**
+UI 라이브러리 컴포넌트를 Mandu Island 아키텍처에 올바르게 통합하세요.
+## "use client" 경계
+```tsx
+// components/ui/button.tsx
+// shadcn/ui 컴포넌트는 이미 클라이언트 컴포넌트
+"use client";
+import { cn } from "@/lib/utils";
+// ...
+```
+```tsx
+// app/dashboard/page.tsx (서버 컴포넌트)
+import { Card, CardHeader, CardTitle, CardContent } from "@/components/ui/card";
+import { DashboardActionsIsland } from "./client";
+export default function DashboardPage() {
+  return (
+    <div>
+      {/* Card는 서버에서 렌더링 (정적 마크업) */}
+      <Card>
+        <CardHeader>
+          <CardTitle>Dashboard</CardTitle>
+        </CardHeader>
+        <CardContent>
+          {/* 인터랙티브 부분만 Island */}
+          <DashboardActionsIsland />
+        </CardContent>
+      </Card>
+    </div>
+  );
+}
+```
+## 서버 데이터 → Island 전달
+```tsx
+// app/users/page.tsx
+import { UserTableIsland } from "./client";
+import { getUsers } from "@/lib/db";
+export default async function UsersPage() {
+  const users = await getUsers();
+  return (
+    <div>
+      <h1>Users</h1>
+      {/* 초기 데이터를 props로 전달 */}
+      <UserTableIsland initialUsers={users} />
+    </div>
+  );
+}
+```
+```tsx
+// app/users/client.tsx
+"use client";
+import { useState } from "react";
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from "@/components/ui/table";
+import { Button } from "@/components/ui/button";
+export function UserTableIsland({ initialUsers }) {
+  const [users, setUsers] = useState(initialUsers);
+  const handleDelete = async (id: string) => {
+    await fetch(`/api/users/${id}`, { method: "DELETE" });
+    setUsers(users.filter(u => u.id !== id));
+  };
+  return (
+    <Table>
+      <TableHeader>
+        <TableRow>
+          <TableHead>Name</TableHead>
+          <TableHead>Email</TableHead>
+          <TableHead>Actions</TableHead>
+        </TableRow>
+      </TableHeader>
+      <TableBody>
+        {users.map(user => (
+          <TableRow key={user.id}>
+            <TableCell>{user.name}</TableCell>
+            <TableCell>{user.email}</TableCell>
+            <TableCell>
+              <Button
+                variant="destructive"
+                size="sm"
+                onClick={() => handleDelete(user.id)}
+              >
+                Delete
+              </Button>
+            </TableCell>
+          </TableRow>
+        ))}
+      </TableBody>
+    </Table>
+  );
+}
+```
+## Dialog/Modal Island 패턴
+```tsx
+// app/users/client.tsx
+"use client";
+import { useState } from "react";
+import { Button } from "@/components/ui/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogHeader,
+  DialogTitle,
+  DialogTrigger,
+} from "@/components/ui/dialog";
+export function CreateUserIsland() {
+  const [open, setOpen] = useState(false);
+  const handleSubmit = async (data: FormData) => {
+    await fetch("/api/users", {
+      method: "POST",
+      body: data,
+    });
+    setOpen(false);
+  };
+  return (
+    <Dialog open={open} onOpenChange={setOpen}>
+      <DialogTrigger asChild>
+        <Button>Add User</Button>
+      </DialogTrigger>
+      <DialogContent>
+        <DialogHeader>
+          <DialogTitle>Create New User</DialogTitle>
+        </DialogHeader>
+        <form action={handleSubmit}>
+          {/* Form fields */}
+        </form>
+      </DialogContent>
+    </Dialog>
+  );
+}
+```
+## Toast Island
+```tsx
+// app/layout.tsx
+import { Toaster } from "@/components/ui/toaster";
+export default function RootLayout({ children }) {
+  return (
+    <html>
+      <body>
+        {children}
+        {/* Toast는 전역 Island */}
+        <Toaster />
+      </body>
+    </html>
+  );
+}
+```
+```tsx
+// app/form/client.tsx
+"use client";
+import { useToast } from "@/components/ui/use-toast";
+export function FormIsland() {
+  const { toast } = useToast();
+  const handleSubmit = async () => {
+    try {
+      await submitForm();
+      toast({
+        title: "Success",
+        description: "Form submitted successfully",
+      });
+    } catch {
+      toast({
+        title: "Error",
+        description: "Something went wrong",
+        variant: "destructive",
+      });
+    }
+  };
+  // ...
+}
+```
+## Island 간 UI 상태 공유
+```tsx
+// app/sidebar/client.tsx
+"use client";
+import { useIslandEvent } from "@mandujs/core/client";
+export function SidebarIsland() {
+  const [isOpen, setIsOpen] = useState(true);
+  useIslandEvent("toggle-sidebar", () => {
+    setIsOpen(prev => !prev);
+  });
+  return (
+    <aside className={cn(isOpen ? "w-64" : "w-0", "transition-all")}>
+      {/* Sidebar content */}
+    </aside>
+  );
+}
+```
+```tsx
+// app/header/client.tsx
+"use client";
+import { useIslandEvent } from "@mandujs/core/client";
+import { Button } from "@/components/ui/button";
+export function HeaderIsland() {
+  const { emit } = useIslandEvent("toggle-sidebar");
+  return (
+    <header>
+      <Button variant="ghost" size="icon" onClick={() => emit({})}>
+        <MenuIcon />
+      </Button>
+    </header>
+  );
+}
+```
+Reference: [React Server Components](https://react.dev/reference/rsc/server-components)