@mandujs/mcp 0.36.2 → 0.37.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/package.json +4 -4
- package/src/activity-adapter.ts +23 -23
- package/src/adapters/index.ts +20 -20
- package/src/adapters/monitor-adapter.ts +100 -100
- package/src/adapters/tool-adapter.ts +90 -90
- package/src/executor/index.ts +22 -22
- package/src/executor/tool-executor.ts +148 -148
- package/src/hooks/config-watcher.ts +173 -173
- package/src/hooks/index.ts +23 -23
- package/src/hooks/mcp-hooks.ts +227 -227
- package/src/index.ts +0 -0
- package/src/logging/index.ts +15 -15
- package/src/logging/mcp-transport.ts +134 -134
- package/src/profiles.ts +34 -34
- 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/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/db-provider-supabase.md +300 -300
- 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-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/server.ts +3 -3
- package/src/tools/ate-exemplar.ts +92 -92
- package/src/tools/ate-flakes.ts +90 -90
- package/src/tools/ate-mutate.ts +103 -103
- package/src/tools/ate-mutation-report.ts +64 -64
- package/src/tools/ate-oracle-pending.ts +49 -49
- package/src/tools/ate-oracle-replay.ts +44 -44
- package/src/tools/ate-oracle-verdict.ts +70 -70
- package/src/tools/ate-prompt.ts +146 -146
- package/src/tools/brain.ts +3 -3
- package/src/tools/deploy-plan.ts +378 -378
- package/src/tools/deploy-preview.ts +316 -316
- package/src/tools/design.ts +825 -825
- package/src/tools/docs.ts +350 -350
- package/src/tools/kitchen.ts +109 -23
- package/src/tools/lint.ts +226 -226
- package/src/tools/loop-close.ts +175 -175
- package/src/tools/negotiate.ts +263 -263
- package/src/tools/run-tests.ts +424 -424
- package/src/tools/runtime.ts +1 -1
- package/src/tools/slot-validation.ts +199 -199
- package/src/tx-lock.ts +73 -73
- package/src/utils/runtime-control.ts +52 -52
|
@@ -1,150 +1,150 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: Lift State into Provider for Sibling Access
|
|
3
|
-
impact: HIGH
|
|
4
|
-
impactDescription: Enables state sharing without prop drilling
|
|
5
|
-
tags: composition, state, provider, lift-state
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
## Lift State into Provider for Sibling Access
|
|
9
|
-
|
|
10
|
-
**Impact: HIGH (Enables state sharing without prop drilling)**
|
|
11
|
-
|
|
12
|
-
형제 컴포넌트가 상태를 공유해야 할 때, 상태를 Provider로 끌어올리세요. Provider 경계 내의 모든 컴포넌트가 상태에 접근할 수 있습니다.
|
|
13
|
-
|
|
14
|
-
**Incorrect (prop drilling):**
|
|
15
|
-
|
|
16
|
-
```tsx
|
|
17
|
-
// ❌ 상태를 여러 단계로 전달
|
|
18
|
-
function ChatPage() {
|
|
19
|
-
const [message, setMessage] = useState("");
|
|
20
|
-
const [isTyping, setIsTyping] = useState(false);
|
|
21
|
-
|
|
22
|
-
return (
|
|
23
|
-
<div>
|
|
24
|
-
<MessageList
|
|
25
|
-
isTyping={isTyping}
|
|
26
|
-
typingMessage={message} // prop drilling
|
|
27
|
-
/>
|
|
28
|
-
<Composer
|
|
29
|
-
message={message}
|
|
30
|
-
setMessage={setMessage}
|
|
31
|
-
setIsTyping={setIsTyping}
|
|
32
|
-
/>
|
|
33
|
-
<TypingIndicator isTyping={isTyping} /> // prop drilling
|
|
34
|
-
</div>
|
|
35
|
-
);
|
|
36
|
-
}
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
**Correct (Provider로 끌어올리기):**
|
|
40
|
-
|
|
41
|
-
```tsx
|
|
42
|
-
// ✅ Provider가 상태 관리
|
|
43
|
-
interface ChatContextValue {
|
|
44
|
-
state: { message: string; isTyping: boolean };
|
|
45
|
-
actions: { setMessage: (msg: string) => void; setIsTyping: (val: boolean) => void };
|
|
46
|
-
}
|
|
47
|
-
|
|
48
|
-
const ChatContext = createContext<ChatContextValue | null>(null);
|
|
49
|
-
|
|
50
|
-
function ChatProvider({ children }: { children: React.ReactNode }) {
|
|
51
|
-
const [message, setMessage] = useState("");
|
|
52
|
-
const [isTyping, setIsTyping] = useState(false);
|
|
53
|
-
|
|
54
|
-
return (
|
|
55
|
-
<ChatContext value={{
|
|
56
|
-
state: { message, isTyping },
|
|
57
|
-
actions: { setMessage, setIsTyping },
|
|
58
|
-
}}>
|
|
59
|
-
{children}
|
|
60
|
-
</ChatContext>
|
|
61
|
-
);
|
|
62
|
-
}
|
|
63
|
-
|
|
64
|
-
// 각 컴포넌트가 필요한 것만 가져감
|
|
65
|
-
function MessageList() {
|
|
66
|
-
const { state } = use(ChatContext)!;
|
|
67
|
-
return (
|
|
68
|
-
<div>
|
|
69
|
-
{messages.map(msg => <Message key={msg.id} {...msg} />)}
|
|
70
|
-
{state.isTyping && <TypingPreview text={state.message} />}
|
|
71
|
-
</div>
|
|
72
|
-
);
|
|
73
|
-
}
|
|
74
|
-
|
|
75
|
-
function Composer() {
|
|
76
|
-
const { state, actions } = use(ChatContext)!;
|
|
77
|
-
return (
|
|
78
|
-
<textarea
|
|
79
|
-
value={state.message}
|
|
80
|
-
onChange={(e) => {
|
|
81
|
-
actions.setMessage(e.target.value);
|
|
82
|
-
actions.setIsTyping(e.target.value.length > 0);
|
|
83
|
-
}}
|
|
84
|
-
/>
|
|
85
|
-
);
|
|
86
|
-
}
|
|
87
|
-
|
|
88
|
-
function TypingIndicator() {
|
|
89
|
-
const { state } = use(ChatContext)!;
|
|
90
|
-
if (!state.isTyping) return null;
|
|
91
|
-
return <span>Someone is typing...</span>;
|
|
92
|
-
}
|
|
93
|
-
```
|
|
94
|
-
|
|
95
|
-
**사용:**
|
|
96
|
-
|
|
97
|
-
```tsx
|
|
98
|
-
function ChatPage() {
|
|
99
|
-
return (
|
|
100
|
-
<ChatProvider>
|
|
101
|
-
<div>
|
|
102
|
-
<MessageList /> {/* context에서 상태 읽음 */}
|
|
103
|
-
<Composer /> {/* context에서 상태 수정 */}
|
|
104
|
-
<TypingIndicator /> {/* context에서 상태 읽음 */}
|
|
105
|
-
</div>
|
|
106
|
-
</ChatProvider>
|
|
107
|
-
);
|
|
108
|
-
}
|
|
109
|
-
```
|
|
110
|
-
|
|
111
|
-
## Provider 경계 이해하기
|
|
112
|
-
|
|
113
|
-
Provider 경계 내라면 시각적 위치와 무관하게 상태 접근 가능:
|
|
114
|
-
|
|
115
|
-
```tsx
|
|
116
|
-
<ChatProvider>
|
|
117
|
-
<Dialog>
|
|
118
|
-
{/* Dialog 내부 */}
|
|
119
|
-
<Composer.Frame>
|
|
120
|
-
<Composer.Input />
|
|
121
|
-
</Composer.Frame>
|
|
122
|
-
|
|
123
|
-
{/* Frame 외부지만 Provider 내부! */}
|
|
124
|
-
<MessagePreview /> {/* ✅ context 접근 가능 */}
|
|
125
|
-
|
|
126
|
-
<DialogActions>
|
|
127
|
-
<SendButton /> {/* ✅ context 접근 가능 */}
|
|
128
|
-
</DialogActions>
|
|
129
|
-
</Dialog>
|
|
130
|
-
</ChatProvider>
|
|
131
|
-
```
|
|
132
|
-
|
|
133
|
-
## Mandu Island에서의 적용
|
|
134
|
-
|
|
135
|
-
```tsx
|
|
136
|
-
// app/chat/page.tsx
|
|
137
|
-
import { ChatIsland } from "./client";
|
|
138
|
-
|
|
139
|
-
export default function ChatPage({ data }) {
|
|
140
|
-
return (
|
|
141
|
-
<div>
|
|
142
|
-
<h1>Chat</h1>
|
|
143
|
-
{/* Island 내부에서 Provider로 상태 관리 */}
|
|
144
|
-
<ChatIsland initialMessages={data.messages} />
|
|
145
|
-
</div>
|
|
146
|
-
);
|
|
147
|
-
}
|
|
148
|
-
```
|
|
149
|
-
|
|
150
|
-
Reference: [Lifting State Up](https://react.dev/learn/sharing-state-between-components)
|
|
1
|
+
---
|
|
2
|
+
title: Lift State into Provider for Sibling Access
|
|
3
|
+
impact: HIGH
|
|
4
|
+
impactDescription: Enables state sharing without prop drilling
|
|
5
|
+
tags: composition, state, provider, lift-state
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## Lift State into Provider for Sibling Access
|
|
9
|
+
|
|
10
|
+
**Impact: HIGH (Enables state sharing without prop drilling)**
|
|
11
|
+
|
|
12
|
+
형제 컴포넌트가 상태를 공유해야 할 때, 상태를 Provider로 끌어올리세요. Provider 경계 내의 모든 컴포넌트가 상태에 접근할 수 있습니다.
|
|
13
|
+
|
|
14
|
+
**Incorrect (prop drilling):**
|
|
15
|
+
|
|
16
|
+
```tsx
|
|
17
|
+
// ❌ 상태를 여러 단계로 전달
|
|
18
|
+
function ChatPage() {
|
|
19
|
+
const [message, setMessage] = useState("");
|
|
20
|
+
const [isTyping, setIsTyping] = useState(false);
|
|
21
|
+
|
|
22
|
+
return (
|
|
23
|
+
<div>
|
|
24
|
+
<MessageList
|
|
25
|
+
isTyping={isTyping}
|
|
26
|
+
typingMessage={message} // prop drilling
|
|
27
|
+
/>
|
|
28
|
+
<Composer
|
|
29
|
+
message={message}
|
|
30
|
+
setMessage={setMessage}
|
|
31
|
+
setIsTyping={setIsTyping}
|
|
32
|
+
/>
|
|
33
|
+
<TypingIndicator isTyping={isTyping} /> // prop drilling
|
|
34
|
+
</div>
|
|
35
|
+
);
|
|
36
|
+
}
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
**Correct (Provider로 끌어올리기):**
|
|
40
|
+
|
|
41
|
+
```tsx
|
|
42
|
+
// ✅ Provider가 상태 관리
|
|
43
|
+
interface ChatContextValue {
|
|
44
|
+
state: { message: string; isTyping: boolean };
|
|
45
|
+
actions: { setMessage: (msg: string) => void; setIsTyping: (val: boolean) => void };
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
const ChatContext = createContext<ChatContextValue | null>(null);
|
|
49
|
+
|
|
50
|
+
function ChatProvider({ children }: { children: React.ReactNode }) {
|
|
51
|
+
const [message, setMessage] = useState("");
|
|
52
|
+
const [isTyping, setIsTyping] = useState(false);
|
|
53
|
+
|
|
54
|
+
return (
|
|
55
|
+
<ChatContext value={{
|
|
56
|
+
state: { message, isTyping },
|
|
57
|
+
actions: { setMessage, setIsTyping },
|
|
58
|
+
}}>
|
|
59
|
+
{children}
|
|
60
|
+
</ChatContext>
|
|
61
|
+
);
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
// 각 컴포넌트가 필요한 것만 가져감
|
|
65
|
+
function MessageList() {
|
|
66
|
+
const { state } = use(ChatContext)!;
|
|
67
|
+
return (
|
|
68
|
+
<div>
|
|
69
|
+
{messages.map(msg => <Message key={msg.id} {...msg} />)}
|
|
70
|
+
{state.isTyping && <TypingPreview text={state.message} />}
|
|
71
|
+
</div>
|
|
72
|
+
);
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
function Composer() {
|
|
76
|
+
const { state, actions } = use(ChatContext)!;
|
|
77
|
+
return (
|
|
78
|
+
<textarea
|
|
79
|
+
value={state.message}
|
|
80
|
+
onChange={(e) => {
|
|
81
|
+
actions.setMessage(e.target.value);
|
|
82
|
+
actions.setIsTyping(e.target.value.length > 0);
|
|
83
|
+
}}
|
|
84
|
+
/>
|
|
85
|
+
);
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
function TypingIndicator() {
|
|
89
|
+
const { state } = use(ChatContext)!;
|
|
90
|
+
if (!state.isTyping) return null;
|
|
91
|
+
return <span>Someone is typing...</span>;
|
|
92
|
+
}
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
**사용:**
|
|
96
|
+
|
|
97
|
+
```tsx
|
|
98
|
+
function ChatPage() {
|
|
99
|
+
return (
|
|
100
|
+
<ChatProvider>
|
|
101
|
+
<div>
|
|
102
|
+
<MessageList /> {/* context에서 상태 읽음 */}
|
|
103
|
+
<Composer /> {/* context에서 상태 수정 */}
|
|
104
|
+
<TypingIndicator /> {/* context에서 상태 읽음 */}
|
|
105
|
+
</div>
|
|
106
|
+
</ChatProvider>
|
|
107
|
+
);
|
|
108
|
+
}
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
## Provider 경계 이해하기
|
|
112
|
+
|
|
113
|
+
Provider 경계 내라면 시각적 위치와 무관하게 상태 접근 가능:
|
|
114
|
+
|
|
115
|
+
```tsx
|
|
116
|
+
<ChatProvider>
|
|
117
|
+
<Dialog>
|
|
118
|
+
{/* Dialog 내부 */}
|
|
119
|
+
<Composer.Frame>
|
|
120
|
+
<Composer.Input />
|
|
121
|
+
</Composer.Frame>
|
|
122
|
+
|
|
123
|
+
{/* Frame 외부지만 Provider 내부! */}
|
|
124
|
+
<MessagePreview /> {/* ✅ context 접근 가능 */}
|
|
125
|
+
|
|
126
|
+
<DialogActions>
|
|
127
|
+
<SendButton /> {/* ✅ context 접근 가능 */}
|
|
128
|
+
</DialogActions>
|
|
129
|
+
</Dialog>
|
|
130
|
+
</ChatProvider>
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
## Mandu Island에서의 적용
|
|
134
|
+
|
|
135
|
+
```tsx
|
|
136
|
+
// app/chat/page.tsx
|
|
137
|
+
import { ChatIsland } from "./client";
|
|
138
|
+
|
|
139
|
+
export default function ChatPage({ data }) {
|
|
140
|
+
return (
|
|
141
|
+
<div>
|
|
142
|
+
<h1>Chat</h1>
|
|
143
|
+
{/* Island 내부에서 Provider로 상태 관리 */}
|
|
144
|
+
<ChatIsland initialMessages={data.messages} />
|
|
145
|
+
</div>
|
|
146
|
+
);
|
|
147
|
+
}
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
Reference: [Lifting State Up](https://react.dev/learn/sharing-state-between-components)
|
|
@@ -1,92 +1,92 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: Mandu Deployment
|
|
3
|
-
description: Production deployment patterns for Mandu applications
|
|
4
|
-
metadata:
|
|
5
|
-
version: "1.0.0"
|
|
6
|
-
author: mandu
|
|
7
|
-
globs:
|
|
8
|
-
- "render.yaml"
|
|
9
|
-
- "Dockerfile"
|
|
10
|
-
- "docker-compose.yml"
|
|
11
|
-
- ".github/workflows/*.yml"
|
|
12
|
-
- "bunfig.toml"
|
|
13
|
-
---
|
|
14
|
-
|
|
15
|
-
# Mandu Deployment Skill
|
|
16
|
-
|
|
17
|
-
Mandu 앱을 프로덕션 환경에 안전하고 효율적으로 배포하기 위한 가이드입니다.
|
|
18
|
-
|
|
19
|
-
## 핵심 원칙
|
|
20
|
-
|
|
21
|
-
1. **Bun 네이티브**: Bun 런타임과 번들러를 최대한 활용
|
|
22
|
-
2. **환경 분리**: 개발/스테이징/프로덕션 환경 명확히 구분
|
|
23
|
-
3. **자동화**: CI/CD를 통한 일관된 배포 프로세스
|
|
24
|
-
4. **보안 우선**: 민감 정보는 환경 변수로 관리
|
|
25
|
-
|
|
26
|
-
## 빠른 시작
|
|
27
|
-
|
|
28
|
-
### Render 배포 (권장)
|
|
29
|
-
|
|
30
|
-
```yaml
|
|
31
|
-
# render.yaml
|
|
32
|
-
services:
|
|
33
|
-
- type: web
|
|
34
|
-
name: mandu-app
|
|
35
|
-
runtime: node
|
|
36
|
-
buildCommand: bun install && bun run build
|
|
37
|
-
startCommand: bun run start
|
|
38
|
-
envVars:
|
|
39
|
-
- key: NODE_ENV
|
|
40
|
-
value: production
|
|
41
|
-
- key: BUN_ENV
|
|
42
|
-
value: production
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
### Docker 배포
|
|
46
|
-
|
|
47
|
-
```dockerfile
|
|
48
|
-
FROM oven/bun:1.0
|
|
49
|
-
|
|
50
|
-
WORKDIR /app
|
|
51
|
-
COPY package.json bun.lockb ./
|
|
52
|
-
RUN bun install --frozen-lockfile --production
|
|
53
|
-
|
|
54
|
-
COPY . .
|
|
55
|
-
RUN bun run build
|
|
56
|
-
|
|
57
|
-
EXPOSE 3000
|
|
58
|
-
CMD ["bun", "run", "start"]
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
## 배포 체크리스트
|
|
62
|
-
|
|
63
|
-
### 빌드 준비
|
|
64
|
-
- [ ] `bun run build` 성공 확인
|
|
65
|
-
- [ ] 번들 크기 최적화 (tree-shaking, code-splitting)
|
|
66
|
-
- [ ] 환경 변수 설정 완료
|
|
67
|
-
|
|
68
|
-
### 플랫폼 설정
|
|
69
|
-
- [ ] Render/Docker 설정 파일 작성
|
|
70
|
-
- [ ] 헬스체크 엔드포인트 구현
|
|
71
|
-
- [ ] 로깅 설정 완료
|
|
72
|
-
|
|
73
|
-
### 보안
|
|
74
|
-
- [ ] 민감 정보 환경 변수로 분리
|
|
75
|
-
- [ ] HTTPS 강제 적용
|
|
76
|
-
- [ ] 보안 헤더 설정
|
|
77
|
-
|
|
78
|
-
### 모니터링
|
|
79
|
-
- [ ] 에러 트래킹 설정
|
|
80
|
-
- [ ] 성능 모니터링 구성
|
|
81
|
-
- [ ] 알림 설정
|
|
82
|
-
|
|
83
|
-
## 규칙 카테고리
|
|
84
|
-
|
|
85
|
-
| Category | Description | Rules |
|
|
86
|
-
|----------|-------------|-------|
|
|
87
|
-
| Build | 프로덕션 빌드 최적화 | 2 |
|
|
88
|
-
| Platform | 플랫폼별 배포 설정 | 3 |
|
|
89
|
-
| Container | Docker 컨테이너화 | 2 |
|
|
90
|
-
| CI/CD | 자동화 파이프라인 | 1 |
|
|
91
|
-
|
|
92
|
-
→ 세부 규칙은 `rules/` 폴더 참조
|
|
1
|
+
---
|
|
2
|
+
name: Mandu Deployment
|
|
3
|
+
description: Production deployment patterns for Mandu applications
|
|
4
|
+
metadata:
|
|
5
|
+
version: "1.0.0"
|
|
6
|
+
author: mandu
|
|
7
|
+
globs:
|
|
8
|
+
- "render.yaml"
|
|
9
|
+
- "Dockerfile"
|
|
10
|
+
- "docker-compose.yml"
|
|
11
|
+
- ".github/workflows/*.yml"
|
|
12
|
+
- "bunfig.toml"
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# Mandu Deployment Skill
|
|
16
|
+
|
|
17
|
+
Mandu 앱을 프로덕션 환경에 안전하고 효율적으로 배포하기 위한 가이드입니다.
|
|
18
|
+
|
|
19
|
+
## 핵심 원칙
|
|
20
|
+
|
|
21
|
+
1. **Bun 네이티브**: Bun 런타임과 번들러를 최대한 활용
|
|
22
|
+
2. **환경 분리**: 개발/스테이징/프로덕션 환경 명확히 구분
|
|
23
|
+
3. **자동화**: CI/CD를 통한 일관된 배포 프로세스
|
|
24
|
+
4. **보안 우선**: 민감 정보는 환경 변수로 관리
|
|
25
|
+
|
|
26
|
+
## 빠른 시작
|
|
27
|
+
|
|
28
|
+
### Render 배포 (권장)
|
|
29
|
+
|
|
30
|
+
```yaml
|
|
31
|
+
# render.yaml
|
|
32
|
+
services:
|
|
33
|
+
- type: web
|
|
34
|
+
name: mandu-app
|
|
35
|
+
runtime: node
|
|
36
|
+
buildCommand: bun install && bun run build
|
|
37
|
+
startCommand: bun run start
|
|
38
|
+
envVars:
|
|
39
|
+
- key: NODE_ENV
|
|
40
|
+
value: production
|
|
41
|
+
- key: BUN_ENV
|
|
42
|
+
value: production
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
### Docker 배포
|
|
46
|
+
|
|
47
|
+
```dockerfile
|
|
48
|
+
FROM oven/bun:1.0
|
|
49
|
+
|
|
50
|
+
WORKDIR /app
|
|
51
|
+
COPY package.json bun.lockb ./
|
|
52
|
+
RUN bun install --frozen-lockfile --production
|
|
53
|
+
|
|
54
|
+
COPY . .
|
|
55
|
+
RUN bun run build
|
|
56
|
+
|
|
57
|
+
EXPOSE 3000
|
|
58
|
+
CMD ["bun", "run", "start"]
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
## 배포 체크리스트
|
|
62
|
+
|
|
63
|
+
### 빌드 준비
|
|
64
|
+
- [ ] `bun run build` 성공 확인
|
|
65
|
+
- [ ] 번들 크기 최적화 (tree-shaking, code-splitting)
|
|
66
|
+
- [ ] 환경 변수 설정 완료
|
|
67
|
+
|
|
68
|
+
### 플랫폼 설정
|
|
69
|
+
- [ ] Render/Docker 설정 파일 작성
|
|
70
|
+
- [ ] 헬스체크 엔드포인트 구현
|
|
71
|
+
- [ ] 로깅 설정 완료
|
|
72
|
+
|
|
73
|
+
### 보안
|
|
74
|
+
- [ ] 민감 정보 환경 변수로 분리
|
|
75
|
+
- [ ] HTTPS 강제 적용
|
|
76
|
+
- [ ] 보안 헤더 설정
|
|
77
|
+
|
|
78
|
+
### 모니터링
|
|
79
|
+
- [ ] 에러 트래킹 설정
|
|
80
|
+
- [ ] 성능 모니터링 구성
|
|
81
|
+
- [ ] 알림 설정
|
|
82
|
+
|
|
83
|
+
## 규칙 카테고리
|
|
84
|
+
|
|
85
|
+
| Category | Description | Rules |
|
|
86
|
+
|----------|-------------|-------|
|
|
87
|
+
| Build | 프로덕션 빌드 최적화 | 2 |
|
|
88
|
+
| Platform | 플랫폼별 배포 설정 | 3 |
|
|
89
|
+
| Container | Docker 컨테이너화 | 2 |
|
|
90
|
+
| CI/CD | 자동화 파이프라인 | 1 |
|
|
91
|
+
|
|
92
|
+
→ 세부 규칙은 `rules/` 폴더 참조
|
|
@@ -1,41 +1,41 @@
|
|
|
1
|
-
# Mandu Deployment - Rule Categories
|
|
2
|
-
|
|
3
|
-
## Build
|
|
4
|
-
프로덕션 빌드 최적화 및 번들링 설정
|
|
5
|
-
|
|
6
|
-
| Impact | Description |
|
|
7
|
-
|--------|-------------|
|
|
8
|
-
| CRITICAL | 빌드 실패 시 배포 불가 |
|
|
9
|
-
| HIGH | 번들 크기, 빌드 시간에 큰 영향 |
|
|
10
|
-
|
|
11
|
-
## Platform
|
|
12
|
-
배포 플랫폼별 설정 및 최적화
|
|
13
|
-
|
|
14
|
-
| Impact | Description |
|
|
15
|
-
|--------|-------------|
|
|
16
|
-
| CRITICAL | 플랫폼 호환성 필수 |
|
|
17
|
-
| HIGH | 성능, 비용에 큰 영향 |
|
|
18
|
-
|
|
19
|
-
## Container
|
|
20
|
-
Docker 컨테이너화 및 오케스트레이션
|
|
21
|
-
|
|
22
|
-
| Impact | Description |
|
|
23
|
-
|--------|-------------|
|
|
24
|
-
| HIGH | 일관된 배포 환경 보장 |
|
|
25
|
-
| MEDIUM | 개발/프로덕션 환경 일치 |
|
|
26
|
-
|
|
27
|
-
## CI/CD
|
|
28
|
-
지속적 통합 및 배포 파이프라인
|
|
29
|
-
|
|
30
|
-
| Impact | Description |
|
|
31
|
-
|--------|-------------|
|
|
32
|
-
| HIGH | 자동화된 품질 보증 |
|
|
33
|
-
| MEDIUM | 배포 속도 및 안정성 향상 |
|
|
34
|
-
|
|
35
|
-
## Environment
|
|
36
|
-
환경 변수 및 설정 관리
|
|
37
|
-
|
|
38
|
-
| Impact | Description |
|
|
39
|
-
|--------|-------------|
|
|
40
|
-
| CRITICAL | 보안 민감 정보 보호 |
|
|
41
|
-
| HIGH | 환경별 설정 분리 |
|
|
1
|
+
# Mandu Deployment - Rule Categories
|
|
2
|
+
|
|
3
|
+
## Build
|
|
4
|
+
프로덕션 빌드 최적화 및 번들링 설정
|
|
5
|
+
|
|
6
|
+
| Impact | Description |
|
|
7
|
+
|--------|-------------|
|
|
8
|
+
| CRITICAL | 빌드 실패 시 배포 불가 |
|
|
9
|
+
| HIGH | 번들 크기, 빌드 시간에 큰 영향 |
|
|
10
|
+
|
|
11
|
+
## Platform
|
|
12
|
+
배포 플랫폼별 설정 및 최적화
|
|
13
|
+
|
|
14
|
+
| Impact | Description |
|
|
15
|
+
|--------|-------------|
|
|
16
|
+
| CRITICAL | 플랫폼 호환성 필수 |
|
|
17
|
+
| HIGH | 성능, 비용에 큰 영향 |
|
|
18
|
+
|
|
19
|
+
## Container
|
|
20
|
+
Docker 컨테이너화 및 오케스트레이션
|
|
21
|
+
|
|
22
|
+
| Impact | Description |
|
|
23
|
+
|--------|-------------|
|
|
24
|
+
| HIGH | 일관된 배포 환경 보장 |
|
|
25
|
+
| MEDIUM | 개발/프로덕션 환경 일치 |
|
|
26
|
+
|
|
27
|
+
## CI/CD
|
|
28
|
+
지속적 통합 및 배포 파이프라인
|
|
29
|
+
|
|
30
|
+
| Impact | Description |
|
|
31
|
+
|--------|-------------|
|
|
32
|
+
| HIGH | 자동화된 품질 보증 |
|
|
33
|
+
| MEDIUM | 배포 속도 및 안정성 향상 |
|
|
34
|
+
|
|
35
|
+
## Environment
|
|
36
|
+
환경 변수 및 설정 관리
|
|
37
|
+
|
|
38
|
+
| Impact | Description |
|
|
39
|
+
|--------|-------------|
|
|
40
|
+
| CRITICAL | 보안 민감 정보 보호 |
|
|
41
|
+
| HIGH | 환경별 설정 분리 |
|
|
@@ -1,38 +1,38 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: Rule Title Here
|
|
3
|
-
impact: CRITICAL | HIGH | MEDIUM | LOW
|
|
4
|
-
impactDescription: One-line description of why this matters
|
|
5
|
-
tags: deployment, tag2, tag3
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
## Rule Title Here
|
|
9
|
-
|
|
10
|
-
**Impact: LEVEL (Impact description)**
|
|
11
|
-
|
|
12
|
-
규칙에 대한 간단한 설명.
|
|
13
|
-
|
|
14
|
-
**설정 예시:**
|
|
15
|
-
|
|
16
|
-
```yaml
|
|
17
|
-
# 설정 파일 예시
|
|
18
|
-
key: value
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
**구현 예시:**
|
|
22
|
-
|
|
23
|
-
```typescript
|
|
24
|
-
// 코드 예시
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
## 추가 설정
|
|
28
|
-
|
|
29
|
-
```bash
|
|
30
|
-
# 명령어 예시
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
## 주의사항
|
|
34
|
-
|
|
35
|
-
- 첫 번째 주의사항
|
|
36
|
-
- 두 번째 주의사항
|
|
37
|
-
|
|
38
|
-
Reference: [문서 링크](https://example.com)
|
|
1
|
+
---
|
|
2
|
+
title: Rule Title Here
|
|
3
|
+
impact: CRITICAL | HIGH | MEDIUM | LOW
|
|
4
|
+
impactDescription: One-line description of why this matters
|
|
5
|
+
tags: deployment, tag2, tag3
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## Rule Title Here
|
|
9
|
+
|
|
10
|
+
**Impact: LEVEL (Impact description)**
|
|
11
|
+
|
|
12
|
+
규칙에 대한 간단한 설명.
|
|
13
|
+
|
|
14
|
+
**설정 예시:**
|
|
15
|
+
|
|
16
|
+
```yaml
|
|
17
|
+
# 설정 파일 예시
|
|
18
|
+
key: value
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
**구현 예시:**
|
|
22
|
+
|
|
23
|
+
```typescript
|
|
24
|
+
// 코드 예시
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## 추가 설정
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
# 명령어 예시
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## 주의사항
|
|
34
|
+
|
|
35
|
+
- 첫 번째 주의사항
|
|
36
|
+
- 두 번째 주의사항
|
|
37
|
+
|
|
38
|
+
Reference: [문서 링크](https://example.com)
|
|
@@ -1,13 +1,13 @@
|
|
|
1
|
-
{
|
|
2
|
-
"id": "mandu-deployment",
|
|
3
|
-
"name": "Mandu Deployment",
|
|
4
|
-
"version": "1.0.0",
|
|
5
|
-
"description": "Production deployment patterns for Mandu applications",
|
|
6
|
-
"author": "mandu",
|
|
7
|
-
"references": [
|
|
8
|
-
"https://bun.sh/docs/bundler",
|
|
9
|
-
"https://render.com/docs",
|
|
10
|
-
"https://docs.docker.com/"
|
|
11
|
-
],
|
|
12
|
-
"abstract": "Mandu 앱을 프로덕션 환경에 배포하기 위한 패턴과 가이드. Bun 빌드 최적화, Render/Docker 배포, CI/CD 파이프라인, 환경 설정을 다룹니다."
|
|
13
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"id": "mandu-deployment",
|
|
3
|
+
"name": "Mandu Deployment",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"description": "Production deployment patterns for Mandu applications",
|
|
6
|
+
"author": "mandu",
|
|
7
|
+
"references": [
|
|
8
|
+
"https://bun.sh/docs/bundler",
|
|
9
|
+
"https://render.com/docs",
|
|
10
|
+
"https://docs.docker.com/"
|
|
11
|
+
],
|
|
12
|
+
"abstract": "Mandu 앱을 프로덕션 환경에 배포하기 위한 패턴과 가이드. Bun 빌드 최적화, Render/Docker 배포, CI/CD 파이프라인, 환경 설정을 다룹니다."
|
|
13
|
+
}
|