@mandujs/mcp 0.13.0 → 0.16.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.
- package/README.md +6 -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 +129 -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
|
@@ -1,83 +1,83 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Watcher Warning Injection for Mutation Tools
|
|
3
|
-
*
|
|
4
|
-
* Mutation 도구(write_slot, add_route, generate 등) 실행 후
|
|
5
|
-
* watcher 경고를 자동으로 응답에 포함시킨다.
|
|
6
|
-
*
|
|
7
|
-
* MCP notification이 Claude Code에 전달되지 않는 문제를 해결.
|
|
8
|
-
*/
|
|
9
|
-
|
|
10
|
-
import { getWatcher } from "../../../core/src/index.js";
|
|
11
|
-
|
|
12
|
-
const MUTATION_TOOLS = new Set([
|
|
13
|
-
"mandu_write_slot",
|
|
14
|
-
"mandu_add_route",
|
|
15
|
-
"mandu_update_route",
|
|
16
|
-
"mandu_delete_route",
|
|
17
|
-
"mandu_generate",
|
|
18
|
-
"mandu_build",
|
|
19
|
-
"mandu_commit",
|
|
20
|
-
"mandu_add_client_slot",
|
|
21
|
-
"mandu_set_hydration",
|
|
22
|
-
"mandu_create_contract",
|
|
23
|
-
"mandu_update_route_contract",
|
|
24
|
-
"mandu_sync_contract_slot",
|
|
25
|
-
]);
|
|
26
|
-
|
|
27
|
-
/** watcher debounce(300ms) + 여유분 */
|
|
28
|
-
const WARNING_WAIT_MS = 400;
|
|
29
|
-
|
|
30
|
-
type ToolHandler = (args: Record<string, unknown>) => Promise<unknown>;
|
|
31
|
-
|
|
32
|
-
/**
|
|
33
|
-
* Mutation 도구 핸들러를 감싸서, 실행 후 발생한 watcher 경고를
|
|
34
|
-
* 응답 객체의 `_warnings` 필드에 자동 포함시킨다.
|
|
35
|
-
*/
|
|
36
|
-
export function applyWarningInjection(
|
|
37
|
-
handlers: Record<string, ToolHandler>
|
|
38
|
-
): Record<string, ToolHandler> {
|
|
39
|
-
const wrapped: Record<string, ToolHandler> = {};
|
|
40
|
-
|
|
41
|
-
for (const [name, handler] of Object.entries(handlers)) {
|
|
42
|
-
if (MUTATION_TOOLS.has(name)) {
|
|
43
|
-
wrapped[name] = wrapWithWarnings(handler);
|
|
44
|
-
} else {
|
|
45
|
-
wrapped[name] = handler;
|
|
46
|
-
}
|
|
47
|
-
}
|
|
48
|
-
|
|
49
|
-
return wrapped;
|
|
50
|
-
}
|
|
51
|
-
|
|
52
|
-
function wrapWithWarnings(handler: ToolHandler): ToolHandler {
|
|
53
|
-
return async (args: Record<string, unknown>) => {
|
|
54
|
-
const watcher = getWatcher();
|
|
55
|
-
const beforeCount = watcher?.getRecentWarnings(100).length ?? 0;
|
|
56
|
-
|
|
57
|
-
const result = await handler(args);
|
|
58
|
-
|
|
59
|
-
// watcher debounce 대기
|
|
60
|
-
await new Promise((resolve) => setTimeout(resolve, WARNING_WAIT_MS));
|
|
61
|
-
|
|
62
|
-
const allWarnings = watcher?.getRecentWarnings(100) ?? [];
|
|
63
|
-
const newWarnings = allWarnings.slice(beforeCount);
|
|
64
|
-
|
|
65
|
-
if (
|
|
66
|
-
newWarnings.length > 0 &&
|
|
67
|
-
typeof result === "object" &&
|
|
68
|
-
result !== null
|
|
69
|
-
) {
|
|
70
|
-
return {
|
|
71
|
-
...(result as Record<string, unknown>),
|
|
72
|
-
_warnings: newWarnings.map((w) => ({
|
|
73
|
-
ruleId: w.ruleId,
|
|
74
|
-
file: w.file,
|
|
75
|
-
message: w.message,
|
|
76
|
-
level: w.level ?? "warn",
|
|
77
|
-
})),
|
|
78
|
-
};
|
|
79
|
-
}
|
|
80
|
-
|
|
81
|
-
return result;
|
|
82
|
-
};
|
|
83
|
-
}
|
|
1
|
+
/**
|
|
2
|
+
* Watcher Warning Injection for Mutation Tools
|
|
3
|
+
*
|
|
4
|
+
* Mutation 도구(write_slot, add_route, generate 등) 실행 후
|
|
5
|
+
* watcher 경고를 자동으로 응답에 포함시킨다.
|
|
6
|
+
*
|
|
7
|
+
* MCP notification이 Claude Code에 전달되지 않는 문제를 해결.
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
import { getWatcher } from "../../../core/src/index.js";
|
|
11
|
+
|
|
12
|
+
const MUTATION_TOOLS = new Set([
|
|
13
|
+
"mandu_write_slot",
|
|
14
|
+
"mandu_add_route",
|
|
15
|
+
"mandu_update_route",
|
|
16
|
+
"mandu_delete_route",
|
|
17
|
+
"mandu_generate",
|
|
18
|
+
"mandu_build",
|
|
19
|
+
"mandu_commit",
|
|
20
|
+
"mandu_add_client_slot",
|
|
21
|
+
"mandu_set_hydration",
|
|
22
|
+
"mandu_create_contract",
|
|
23
|
+
"mandu_update_route_contract",
|
|
24
|
+
"mandu_sync_contract_slot",
|
|
25
|
+
]);
|
|
26
|
+
|
|
27
|
+
/** watcher debounce(300ms) + 여유분 */
|
|
28
|
+
const WARNING_WAIT_MS = 400;
|
|
29
|
+
|
|
30
|
+
type ToolHandler = (args: Record<string, unknown>) => Promise<unknown>;
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* Mutation 도구 핸들러를 감싸서, 실행 후 발생한 watcher 경고를
|
|
34
|
+
* 응답 객체의 `_warnings` 필드에 자동 포함시킨다.
|
|
35
|
+
*/
|
|
36
|
+
export function applyWarningInjection(
|
|
37
|
+
handlers: Record<string, ToolHandler>
|
|
38
|
+
): Record<string, ToolHandler> {
|
|
39
|
+
const wrapped: Record<string, ToolHandler> = {};
|
|
40
|
+
|
|
41
|
+
for (const [name, handler] of Object.entries(handlers)) {
|
|
42
|
+
if (MUTATION_TOOLS.has(name)) {
|
|
43
|
+
wrapped[name] = wrapWithWarnings(handler);
|
|
44
|
+
} else {
|
|
45
|
+
wrapped[name] = handler;
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
return wrapped;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
function wrapWithWarnings(handler: ToolHandler): ToolHandler {
|
|
53
|
+
return async (args: Record<string, unknown>) => {
|
|
54
|
+
const watcher = getWatcher();
|
|
55
|
+
const beforeCount = watcher?.getRecentWarnings(100).length ?? 0;
|
|
56
|
+
|
|
57
|
+
const result = await handler(args);
|
|
58
|
+
|
|
59
|
+
// watcher debounce 대기
|
|
60
|
+
await new Promise((resolve) => setTimeout(resolve, WARNING_WAIT_MS));
|
|
61
|
+
|
|
62
|
+
const allWarnings = watcher?.getRecentWarnings(100) ?? [];
|
|
63
|
+
const newWarnings = allWarnings.slice(beforeCount);
|
|
64
|
+
|
|
65
|
+
if (
|
|
66
|
+
newWarnings.length > 0 &&
|
|
67
|
+
typeof result === "object" &&
|
|
68
|
+
result !== null
|
|
69
|
+
) {
|
|
70
|
+
return {
|
|
71
|
+
...(result as Record<string, unknown>),
|
|
72
|
+
_warnings: newWarnings.map((w) => ({
|
|
73
|
+
ruleId: w.ruleId,
|
|
74
|
+
file: w.file,
|
|
75
|
+
message: w.message,
|
|
76
|
+
level: w.level ?? "warn",
|
|
77
|
+
})),
|
|
78
|
+
};
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
return result;
|
|
82
|
+
};
|
|
83
|
+
}
|