@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.
Files changed (136) hide show
  1. package/README.md +6 -7
  2. package/package.json +3 -2
  3. package/src/adapters/index.ts +20 -20
  4. package/src/adapters/monitor-adapter.ts +100 -100
  5. package/src/adapters/tool-adapter.ts +88 -88
  6. package/src/executor/error-handler.ts +250 -250
  7. package/src/executor/index.ts +22 -22
  8. package/src/executor/tool-executor.ts +148 -148
  9. package/src/hooks/config-watcher.ts +174 -174
  10. package/src/hooks/index.ts +23 -23
  11. package/src/hooks/mcp-hooks.ts +227 -227
  12. package/src/logging/index.ts +15 -15
  13. package/src/logging/mcp-transport.ts +134 -134
  14. package/src/registry/index.ts +13 -13
  15. package/src/registry/mcp-tool-registry.ts +298 -298
  16. package/src/resources/skills/guides.ts +1136 -1136
  17. package/src/resources/skills/index.ts +12 -12
  18. package/src/resources/skills/loader.ts +218 -218
  19. package/src/resources/skills/mandu-composition/SKILL.md +91 -91
  20. package/src/resources/skills/mandu-composition/metadata.json +13 -13
  21. package/src/resources/skills/mandu-composition/rules/_sections.md +26 -26
  22. package/src/resources/skills/mandu-composition/rules/_template.md +77 -77
  23. package/src/resources/skills/mandu-composition/rules/comp-arch-avoid-boolean-props.md +146 -146
  24. package/src/resources/skills/mandu-composition/rules/comp-arch-compound-components.md +164 -164
  25. package/src/resources/skills/mandu-composition/rules/comp-island-event.md +161 -161
  26. package/src/resources/skills/mandu-composition/rules/comp-island-slot-split.md +167 -167
  27. package/src/resources/skills/mandu-composition/rules/comp-pattern-children.md +149 -149
  28. package/src/resources/skills/mandu-composition/rules/comp-state-context-interface.md +148 -148
  29. package/src/resources/skills/mandu-composition/rules/comp-state-lift-state.md +150 -150
  30. package/src/resources/skills/mandu-deployment/SKILL.md +92 -92
  31. package/src/resources/skills/mandu-deployment/_sections.md +41 -41
  32. package/src/resources/skills/mandu-deployment/_template.md +38 -38
  33. package/src/resources/skills/mandu-deployment/metadata.json +13 -13
  34. package/src/resources/skills/mandu-deployment/rules/deploy-build-bun.md +109 -109
  35. package/src/resources/skills/mandu-deployment/rules/deploy-build-output.md +115 -115
  36. package/src/resources/skills/mandu-deployment/rules/deploy-cicd-github.md +219 -219
  37. package/src/resources/skills/mandu-deployment/rules/deploy-docker-bun.md +150 -150
  38. package/src/resources/skills/mandu-deployment/rules/deploy-docker-compose.md +223 -223
  39. package/src/resources/skills/mandu-deployment/rules/deploy-platform-fly.md +152 -152
  40. package/src/resources/skills/mandu-deployment/rules/deploy-platform-render.md +179 -179
  41. package/src/resources/skills/mandu-deployment/rules/deploy-platform-supabase.md +323 -323
  42. package/src/resources/skills/mandu-deployment/rules/deploy-platform-vercel.md +140 -140
  43. package/src/resources/skills/mandu-fs-routes/SKILL.md +82 -82
  44. package/src/resources/skills/mandu-fs-routes/metadata.json +12 -12
  45. package/src/resources/skills/mandu-fs-routes/rules/_sections.md +36 -36
  46. package/src/resources/skills/mandu-fs-routes/rules/_template.md +69 -69
  47. package/src/resources/skills/mandu-fs-routes/rules/routes-api-methods.md +65 -65
  48. package/src/resources/skills/mandu-fs-routes/rules/routes-dynamic-param.md +93 -93
  49. package/src/resources/skills/mandu-fs-routes/rules/routes-naming-page.md +55 -55
  50. package/src/resources/skills/mandu-guard/SKILL.md +129 -129
  51. package/src/resources/skills/mandu-guard/metadata.json +12 -12
  52. package/src/resources/skills/mandu-guard/rules/_sections.md +36 -36
  53. package/src/resources/skills/mandu-guard/rules/_template.md +82 -82
  54. package/src/resources/skills/mandu-guard/rules/guard-config-rules.md +100 -100
  55. package/src/resources/skills/mandu-guard/rules/guard-layer-direction.md +76 -76
  56. package/src/resources/skills/mandu-guard/rules/guard-preset-mandu.md +81 -81
  57. package/src/resources/skills/mandu-guard/rules/guard-validate-import.md +80 -80
  58. package/src/resources/skills/mandu-hydration/SKILL.md +91 -91
  59. package/src/resources/skills/mandu-hydration/metadata.json +12 -12
  60. package/src/resources/skills/mandu-hydration/rules/_sections.md +31 -31
  61. package/src/resources/skills/mandu-hydration/rules/_template.md +72 -72
  62. package/src/resources/skills/mandu-hydration/rules/hydration-data-event.md +109 -109
  63. package/src/resources/skills/mandu-hydration/rules/hydration-directive-use-client.md +55 -55
  64. package/src/resources/skills/mandu-hydration/rules/hydration-island-setup.md +113 -113
  65. package/src/resources/skills/mandu-hydration/rules/hydration-priority-visible.md +68 -68
  66. package/src/resources/skills/mandu-performance/SKILL.md +85 -85
  67. package/src/resources/skills/mandu-performance/metadata.json +14 -14
  68. package/src/resources/skills/mandu-performance/rules/_sections.md +31 -31
  69. package/src/resources/skills/mandu-performance/rules/_template.md +64 -64
  70. package/src/resources/skills/mandu-performance/rules/perf-async-defer-await.md +103 -103
  71. package/src/resources/skills/mandu-performance/rules/perf-async-parallel.md +95 -95
  72. package/src/resources/skills/mandu-performance/rules/perf-bun-file.md +124 -124
  73. package/src/resources/skills/mandu-performance/rules/perf-bun-serve.md +125 -125
  74. package/src/resources/skills/mandu-performance/rules/perf-bundle-imports.md +80 -80
  75. package/src/resources/skills/mandu-performance/rules/perf-bundle-island-lazy.md +145 -145
  76. package/src/resources/skills/mandu-performance/rules/perf-cache-react.md +98 -98
  77. package/src/resources/skills/mandu-performance/rules/perf-render-transitions.md +154 -154
  78. package/src/resources/skills/mandu-security/SKILL.md +87 -87
  79. package/src/resources/skills/mandu-security/metadata.json +13 -13
  80. package/src/resources/skills/mandu-security/rules/_sections.md +31 -31
  81. package/src/resources/skills/mandu-security/rules/_template.md +74 -74
  82. package/src/resources/skills/mandu-security/rules/sec-auth-guard.md +127 -127
  83. package/src/resources/skills/mandu-security/rules/sec-env-management.md +133 -133
  84. package/src/resources/skills/mandu-security/rules/sec-input-validate.md +148 -148
  85. package/src/resources/skills/mandu-security/rules/sec-protect-csrf.md +146 -146
  86. package/src/resources/skills/mandu-security/rules/sec-protect-headers.md +138 -138
  87. package/src/resources/skills/mandu-slot/SKILL.md +85 -85
  88. package/src/resources/skills/mandu-slot/metadata.json +12 -12
  89. package/src/resources/skills/mandu-slot/rules/_sections.md +36 -36
  90. package/src/resources/skills/mandu-slot/rules/_template.md +63 -63
  91. package/src/resources/skills/mandu-slot/rules/slot-basic-structure.md +38 -38
  92. package/src/resources/skills/mandu-slot/rules/slot-ctx-response.md +56 -56
  93. package/src/resources/skills/mandu-slot/rules/slot-guard-auth.md +59 -59
  94. package/src/resources/skills/mandu-slot/rules/slot-http-methods.md +64 -64
  95. package/src/resources/skills/mandu-styling/SKILL.md +154 -154
  96. package/src/resources/skills/mandu-styling/_sections.md +43 -43
  97. package/src/resources/skills/mandu-styling/_template.md +32 -32
  98. package/src/resources/skills/mandu-styling/metadata.json +15 -15
  99. package/src/resources/skills/mandu-styling/rules/style-component-compound.md +235 -235
  100. package/src/resources/skills/mandu-styling/rules/style-component-slots.md +255 -255
  101. package/src/resources/skills/mandu-styling/rules/style-component-tokens.md +205 -205
  102. package/src/resources/skills/mandu-styling/rules/style-island-animations.md +272 -272
  103. package/src/resources/skills/mandu-styling/rules/style-island-scoping.md +167 -167
  104. package/src/resources/skills/mandu-styling/rules/style-island-variants.md +221 -221
  105. package/src/resources/skills/mandu-styling/rules/style-perf-critical.md +209 -209
  106. package/src/resources/skills/mandu-styling/rules/style-perf-purge.md +192 -192
  107. package/src/resources/skills/mandu-styling/rules/style-setup-modules.md +162 -162
  108. package/src/resources/skills/mandu-styling/rules/style-setup-panda.md +164 -164
  109. package/src/resources/skills/mandu-styling/rules/style-setup-tailwind.md +170 -170
  110. package/src/resources/skills/mandu-styling/rules/style-tailwind-v4-gotchas.md +179 -179
  111. package/src/resources/skills/mandu-styling/rules/style-theme-darkmode.md +229 -229
  112. package/src/resources/skills/mandu-testing/SKILL.md +99 -99
  113. package/src/resources/skills/mandu-testing/metadata.json +13 -13
  114. package/src/resources/skills/mandu-testing/rules/_sections.md +26 -26
  115. package/src/resources/skills/mandu-testing/rules/_template.md +65 -65
  116. package/src/resources/skills/mandu-testing/rules/test-component-island.md +195 -195
  117. package/src/resources/skills/mandu-testing/rules/test-e2e-playwright.md +196 -196
  118. package/src/resources/skills/mandu-testing/rules/test-mock-fetch.md +219 -219
  119. package/src/resources/skills/mandu-testing/rules/test-slot-unit.md +192 -192
  120. package/src/resources/skills/mandu-ui/SKILL.md +117 -117
  121. package/src/resources/skills/mandu-ui/_sections.md +23 -23
  122. package/src/resources/skills/mandu-ui/_template.md +32 -32
  123. package/src/resources/skills/mandu-ui/metadata.json +13 -13
  124. package/src/resources/skills/mandu-ui/rules/ui-accessibility-aria.md +232 -232
  125. package/src/resources/skills/mandu-ui/rules/ui-accessibility-focus.md +238 -238
  126. package/src/resources/skills/mandu-ui/rules/ui-composition-patterns.md +259 -259
  127. package/src/resources/skills/mandu-ui/rules/ui-island-integration.md +258 -258
  128. package/src/resources/skills/mandu-ui/rules/ui-radix-patterns.md +213 -213
  129. package/src/resources/skills/mandu-ui/rules/ui-shadcn-setup.md +209 -209
  130. package/src/resources/skills/recipes.ts +932 -932
  131. package/src/tools/ate.ts +129 -0
  132. package/src/tools/index.ts +4 -1
  133. package/src/tools/project.ts +334 -334
  134. package/src/tools/runtime.ts +497 -497
  135. package/src/tools/seo.ts +417 -417
  136. 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
+ }