oh-my-oop 0.2.0

package/dist/prompts/phasePressureTest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phasePressureTest.js","sourceRoot":"","sources":["../../src/prompts/phasePressureTest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,SAAS,GAAG;IAChB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC;AAEF,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,cAAc,CACnB,qBAAqB,EACrB;QACE,KAAK,EAAE,iCAAiC;QACxC,WAAW,EACT,qFAAqF;QACvF,UAAU,EAAE,SAAS;KACtB,EACD,CAAC,EAAE,cAAc,EAAE,eAAe,EAAE,EAAE,EAAE;QACtC,MAAM,MAAM,GAAG,cAAc,IAAI,uCAAuC,CAAC;QACzE,MAAM,GAAG,GAAG,eAAe,IAAI,wCAAwC,CAAC;QACxE,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;4BACJ,aAAa;4BACb,EAAE;4BACF,4DAA4D;4BAC5D,qGAAqG;4BACrG,EAAE;4BACF,SAAS;4BACT,QAAQ;4BACR,MAAM;4BACN,QAAQ;4BACR,EAAE;4BACF,YAAY;4BACZ,QAAQ;4BACR,GAAG;4BACH,QAAQ;4BACR,EAAE;4BACF,sCAAsC;4BACtC,EAAE;4BACF,2CAA2C;4BAC3C,oCAAoC;4BACpC,gDAAgD;4BAChD,iFAAiF;4BACjF,6CAA6C;4BAC7C,EAAE;4BACF,gCAAgC;4BAChC,EAAE;4BACF,sEAAsE;4BACtE,2FAA2F;4BAC3F,4FAA4F;4BAC5F,gFAAgF;4BAChF,mEAAmE;4BACnE,6EAA6E;4BAC7E,4EAA4E;4BAC5E,EAAE;4BACF,UAAU;4BACV,EAAE;4BACF,oDAAoD;4BACpD,wBAAwB;4BACxB,oCAAoC;4BACpC,oCAAoC;4BACpC,EAAE;4BACF,8GAA8G;yBAC/G,CAAC,IAAI,CAAC,IAAI,CAAC;qBACb;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/prompts/rddIntro.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerRddIntro(server: McpServer): void;

package/dist/prompts/rddIntro.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+const argsShape = {
+    project_name: z.string().optional(),
+};
+export function registerRddIntro(server) {
+    server.registerPrompt("rdd-workshop-intro", {
+        title: "RDD Workshop — 시작",
+        description: "RDD(책임 주도 설계) 워크숍 시작 가이드. Wirfs-Brock 5 stereotype 안내와 워크숍 루프.",
+        argsSchema: argsShape,
+    }, ({ project_name }) => {
+        const project = project_name ?? "이 프로젝트";
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: [
+                            `# RDD 워크숍 시작 — ${project}`,
+                            ``,
+                            `당신은 RDD(Responsibility-Driven Design) 기반 객체지향 설계를 돕는 코치입니다.`,
+                            `사용자와 함께 다음 루프를 반복하며 ${project}의 설계를 만들어 가세요:`,
+                            ``,
+                            `**루프:** 유스케이스 → 책임 분해 → CRC 카드 작성 → 협력(메시지) 정의 → 클래스 다이어그램 → 검증 → 다시 위로.`,
+                            ``,
+                            `## Stereotype (Wirfs-Brock 5종)`,
+                            `- **InformationHolder** — 도메인 정보를 알고 제공한다.`,
+                            `- **ServiceProvider** — 구체적인 계산/작업을 수행한다.`,
+                            `- **Structurer** — 다른 객체들의 관계를 유지한다 (예: 컬렉션).`,
+                            `- **Coordinator** — 다른 객체들에게 작업을 위임하고 흐름을 조율한다.`,
+                            `- **Interfacer** — 시스템 경계에서 외부와 통신한다.`,
+                            ``,
+                            `## 진행 원칙 (필수 가드레일)`,
+                            `1. **모든 설계 결정마다 ≥2개의 대안을 트레이드오프와 함께 제시**하세요. 단일 권장안을 내지 마세요. 설계에는 정답이 없다는 것이 조영호님의 핵심 가르침입니다.`,
+                            `2. 대안의 \`pros\`/\`cons\`는 추상적 문장이 아니라 이 프로젝트의 도메인 어휘로 적으세요.`,
+                            `3. 사용자가 선택할 때까지 결정을 강요하지 마세요.`,
+                            `4. 변경 후에는 \`oop_design_compare\`로 Before/After를 보여주세요.`,
+                            `5. 주기적으로 \`oop_design_validate\`로 책임/결합도/테스터빌리티를 검사하되, 항상 권고로만 다루세요. 코드 통제권은 사용자에게 있습니다.`,
+                            ``,
+                            `## 다음 단계`,
+                            `1. \`oop_init\`을 호출해 \`.oop/\` 워크스페이스를 만드세요(아직 없다면).`,
+                            `2. 사용자에게 첫 유스케이스를 물어보고 \`oop_use_case_add\`로 등록하세요.`,
+                            `3. \`oop_propose_responsibilities\`를 호출해 N개 대안을 받아 사용자에게 보여주세요.`,
+                            ``,
+                            `사용자의 첫 유스케이스부터 들어보겠습니다. 어떤 일이 일어나야 하는 시스템인가요?`,
+                        ].join("\n"),
+                    },
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=rddIntro.js.map

package/dist/prompts/rddIntro.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rddIntro.js","sourceRoot":"","sources":["../../src/prompts/rddIntro.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,SAAS,GAAG;IAChB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,MAAM,CAAC,cAAc,CACnB,oBAAoB,EACpB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,gEAAgE;QAC7E,UAAU,EAAE,SAAS;KACtB,EACD,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE;QACnB,MAAM,OAAO,GAAG,YAAY,IAAI,QAAQ,CAAC;QACzC,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;4BACJ,kBAAkB,OAAO,EAAE;4BAC3B,EAAE;4BACF,6DAA6D;4BAC7D,uBAAuB,OAAO,gBAAgB;4BAC9C,EAAE;4BACF,0EAA0E;4BAC1E,EAAE;4BACF,gCAAgC;4BAChC,4CAA4C;4BAC5C,2CAA2C;4BAC3C,+CAA+C;4BAC/C,iDAAiD;4BACjD,uCAAuC;4BACvC,EAAE;4BACF,oBAAoB;4BACpB,+FAA+F;4BAC/F,6DAA6D;4BAC7D,+BAA+B;4BAC/B,wDAAwD;4BACxD,0FAA0F;4BAC1F,EAAE;4BACF,UAAU;4BACV,sDAAsD;4BACtD,qDAAqD;4BACrD,iEAAiE;4BACjE,EAAE;4BACF,+CAA+C;yBAChD,CAAC,IAAI,CAAC,IAAI,CAAC;qBACb;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/prompts/review.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerReview(server: McpServer): void;

package/dist/prompts/review.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+const argsShape = {
+    scope: z.enum(["all", "class"]).optional(),
+    target_id: z.string().optional(),
+};
+export function registerReview(server) {
+    server.registerPrompt("design-review-cho-younghos-lens", {
+        title: "Design Review (조영호 렌즈)",
+        description: "현재 설계를 조영호님의 렌즈(Tell-Don't-Ask, new-ability, 사이드이펙트 격리, 응집/결합/테스터빌리티)로 리뷰합니다.",
+        argsSchema: argsShape,
+    }, ({ scope, target_id }) => {
+        const target = scope === "class" && target_id ? `\`${target_id}\` 클래스에 집중` : "전체 설계 대상";
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: [
+                            `# 설계 리뷰 — 조영호 렌즈 (${target})`,
+                            ``,
+                            `다음 절차를 수행하세요:`,
+                            ``,
+                            `1. \`oop_design_validate\`를 호출하여 findings를 수집합니다.`,
+                            `2. 각 finding에 대해:`,
+                            `   - \`message\`와 \`evidence\`를 사용자에게 친절하게 설명합니다.`,
+                            `   - \`remedies\` 배열을 **모두** 제시합니다 (≥2개). 단일 해결책만 추천하지 마세요.`,
+                            `   - 다음 조영호 렌즈를 한 줄로 적용해 평가하세요:`,
+                            `     - **Tell-Don't-Ask**: 조회 메시지가 줄어드는가?`,
+                            `     - **new-ability**: 단위테스트에서 \`new\`로 생성 가능한가?`,
+                            `     - **사이드이펙트 격리**: 외부 자원 의존이 경계로 모이는가?`,
+                            `     - **응집/결합/테스터빌리티 변화**`,
+                            `3. 사용자가 특정 finding을 깊게 보고 싶다면 \`oop_propose_alternatives\`로 추가 대안을 받으세요.`,
+                            `4. 사용자가 변경을 결정하면, 변경 직전에 의미 있는 \`snapshot_label\`을 붙여 mutating 도구를 호출하세요.`,
+                            `5. 변경 후 \`oop_design_compare({ before: { kind: "history", file: <스냅샷> }, after: { kind: "current" } })\`로 Before/After를 보여주세요.`,
+                            ``,
+                            `**철칙:** 결정은 사용자에게 있고, 검증 결과는 항상 권고입니다. 차단하거나 강요하지 마세요. (조영호님: "코드 통제권은 개발자에게")`,
+                        ].join("\n"),
+                    },
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=review.js.map

package/dist/prompts/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../src/prompts/review.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,SAAS,GAAG;IAChB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC1C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,MAAiB;IAC9C,MAAM,CAAC,cAAc,CACnB,iCAAiC,EACjC;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,+EAA+E;QAC5F,UAAU,EAAE,SAAS;KACtB,EACD,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE;QACvB,MAAM,MAAM,GAAG,KAAK,KAAK,OAAO,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,SAAS,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC;QACxF,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;4BACJ,qBAAqB,MAAM,GAAG;4BAC9B,EAAE;4BACF,eAAe;4BACf,EAAE;4BACF,mDAAmD;4BACnD,mBAAmB;4BACnB,mDAAmD;4BACnD,6DAA6D;4BAC7D,iCAAiC;4BACjC,2CAA2C;4BAC3C,mDAAmD;4BACnD,2CAA2C;4BAC3C,4BAA4B;4BAC5B,0EAA0E;4BAC1E,2EAA2E;4BAC3E,gIAAgI;4BAChI,EAAE;4BACF,gFAAgF;yBACjF,CAAC,IAAI,CAAC,IAAI,CAAC;qBACb;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/prompts/stateMachineIntrospect.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerStateMachineIntrospect(server: McpServer): void;

package/dist/prompts/stateMachineIntrospect.js

@@ -0,0 +1,80 @@
+import { z } from "zod";
+const argsShape = {
+    class_or_code: z.string().optional(),
+};
+export function registerStateMachineIntrospect(server) {
+    server.registerPrompt("state-machine-introspect", {
+        title: "State 패턴 도입 점검",
+        description: "boolean 플래그/when 분기 폭증을 sealed State 패턴으로 풀지 점검하는 2 기준 체크 + 4안 비교. 자동 감지 X, 학생 자가 도달.",
+        argsSchema: argsShape,
+    }, ({ class_or_code }) => {
+        const desc = class_or_code ?? "(클래스/코드 미입력)";
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: [
+                            `# State 패턴 도입 점검`,
+                            ``,
+                            `다음 클래스/코드에 *상태 분기가 폭증*하고 있는지 학생과 함께 점검합니다:`,
+                            ``,
+                            `\`\`\``,
+                            desc,
+                            `\`\`\``,
+                            ``,
+                            `## 1단계 — 분기 폭증 신호 진단 (학생이 직접 답하게)`,
+                            ``,
+                            `1. 상태를 나타내는 *boolean 플래그/enum/문자열*이 몇 개입니까?`,
+                            `2. *같은 데이터를 분기하는* \`when\`/\`if\` 구문이 클래스 안에 몇 군데입니까?`,
+                            `3. *새 상태 1개*를 추가하려면 몇 군데를 수정해야 합니까? (분기 N개 × 메서드 M개)`,
+                            `4. 분기 안에서 *각 상태별 행동이 다른가*, 아니면 *데이터만 다른가*?`,
+                            ``,
+                            `## 2단계 — State 패턴 도입 2 기준 (둘 다 만족할 때만 답)`,
+                            ``,
+                            `**기준 1: 다형성을 활용하는가?** — 각 상태가 *행동에 다르게 응답*해야 한다. 단순히 *데이터만 다르다*면 enum + when 으로 충분.`,
+                            ``,
+                            `**기준 2: Context 의 책임이 있는가?** — State 가 Context(주체 객체)의 *행동을 위임*받는 구조여야 한다. State 가 단순히 *데이터 묶음*이라면 패턴 적용 X.`,
+                            ``,
+                            `두 기준 모두 *Yes* 이면 sealed interface 도입. 한 쪽이라도 *No* 면 다른 안.`,
+                            ``,
+                            `## 3단계 — 4안 비교 (도입 결정 후)`,
+                            ``,
+                            `### 0. 만들지 않는다 — boolean 플래그 유지 + 분기 관찰`,
+                            `- pros: 변경 비용 0. 분기가 더 늘어나기 전까지 통증 관찰.`,
+                            `- cons: *통증이 N×M으로 폭증*하면 마이그레이션 비용 ↑.`,
+                            ``,
+                            `### A. enum + when (exhaustive 강제)`,
+                            `- pros: 케이스 닫힘이 컴파일러 강제. 단순 데이터 차이에 가벼움.`,
+                            `- cons: 행동 차이 표현 한계. enum 상수가 *외부 의존 주입*에 약함.`,
+                            ``,
+                            `### B. sealed interface + 다형성`,
+                            `- pros: 상태별 *고유 행동* 다형성 표현. 분기 N×M 흡수. Context 책임 위임 자연.`,
+                            `- cons: sealed/abstract 계층 도입 비용. *외부 mutation 위험* (private 강제 필요).`,
+                            ``,
+                            `### C. lateinit var state + setter`,
+                            `- pros: *기존 코드 변경 최소*.`,
+                            `- cons: 호출 순서 invariant 부재 — 거의 항상 *잘못된 답*. 학습 차원에서 보여만 주세요.`,
+                            ``,
+                            `## 4단계 — 도입 직후 함정 점검 (sealed 선택 시)`,
+                            ``,
+                            `학생에게 다음 3가지 함정을 *미리* 안내:`,
+                            ``,
+                            `- **외부 mutation**: \`obj.state = NewState()\` 직접 변경 시 전이 룰이 우회됨 → State private + 다음 상태 *메서드가 반환*하게.`,
+                            `- **\`if state is X\` 잔재**: 다형성 도입 후 호출처에서 다시 타입 검사하면 다형성 무효화 → State 메서드로 책임 이동.`,
+                            `- **데이터 차이 없는 sealed**: 멤버 차이 없으면 enum 과 동치 → 진짜 다형성 지점이 있는지 재검토.`,
+                            ``,
+                            `## 진행 원칙`,
+                            ``,
+                            `- *분기 폭증을 학생이 직접 경험한 뒤*에 sealed 권하세요. 처음부터 권하면 *그저 좋다* 함정.`,
+                            `- 두 기준 중 하나라도 만족하지 않으면 sealed 추천하지 마세요.`,
+                            `- 도입 결정은 학생에게.`,
+                        ].join("\n"),
+                    },
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=stateMachineIntrospect.js.map

package/dist/prompts/stateMachineIntrospect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateMachineIntrospect.js","sourceRoot":"","sources":["../../src/prompts/stateMachineIntrospect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,SAAS,GAAG;IAChB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC;AAEF,MAAM,UAAU,8BAA8B,CAAC,MAAiB;IAC9D,MAAM,CAAC,cAAc,CACnB,0BAA0B,EAC1B;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EACT,uFAAuF;QACzF,UAAU,EAAE,SAAS;KACtB,EACD,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE;QACpB,MAAM,IAAI,GAAG,aAAa,IAAI,cAAc,CAAC;QAC7C,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;4BACJ,kBAAkB;4BAClB,EAAE;4BACF,4CAA4C;4BAC5C,EAAE;4BACF,QAAQ;4BACR,IAAI;4BACJ,QAAQ;4BACR,EAAE;4BACF,mCAAmC;4BACnC,EAAE;4BACF,6CAA6C;4BAC7C,uDAAuD;4BACvD,sDAAsD;4BACtD,4CAA4C;4BAC5C,EAAE;4BACF,0CAA0C;4BAC1C,EAAE;4BACF,qFAAqF;4BACrF,EAAE;4BACF,6GAA6G;4BAC7G,EAAE;4BACF,2DAA2D;4BAC3D,EAAE;4BACF,0BAA0B;4BAC1B,EAAE;4BACF,yCAAyC;4BACzC,wCAAwC;4BACxC,uCAAuC;4BACvC,EAAE;4BACF,oCAAoC;4BACpC,0CAA0C;4BAC1C,+CAA+C;4BAC/C,EAAE;4BACF,+BAA+B;4BAC/B,0DAA0D;4BAC1D,qEAAqE;4BACrE,EAAE;4BACF,oCAAoC;4BACpC,wBAAwB;4BACxB,8DAA8D;4BAC9D,EAAE;4BACF,oCAAoC;4BACpC,EAAE;4BACF,0BAA0B;4BAC1B,EAAE;4BACF,sGAAsG;4BACtG,mFAAmF;4BACnF,mEAAmE;4BACnE,EAAE;4BACF,UAAU;4BACV,EAAE;4BACF,4DAA4D;4BAC5D,yCAAyC;4BACzC,gBAAgB;yBACjB,CAAC,IAAI,CAAC,IAAI,CAAC;qBACb;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/prompts/tellDontAskRephrase.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerTellDontAskRephrase(server: McpServer): void;

package/dist/prompts/tellDontAskRephrase.js

@@ -0,0 +1,66 @@
+import { z } from "zod";
+const argsShape = {
+    code_or_description: z.string().optional(),
+};
+export function registerTellDontAskRephrase(server) {
+    server.registerPrompt("tell-dont-ask-rephrase", {
+        title: "Tell-Don't-Ask 다시 쓰기",
+        description: "외부 비교자/외부 getter 사용 코드를 *메시지 호출* 형태로 다시 쓰는 4안 + 진단 질문. 답을 즉시 주지 않고 학생 자가 도달 유도.",
+        argsSchema: argsShape,
+    }, ({ code_or_description }) => {
+        const desc = code_or_description ?? "(코드/설명 미입력)";
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: [
+                            `# Tell-Don't-Ask 다시 쓰기`,
+                            ``,
+                            `다음 코드 또는 협력 흐름이 *외부에서 객체의 데이터를 꺼내 처리*하고 있는지 점검합니다:`,
+                            ``,
+                            `\`\`\``,
+                            desc,
+                            `\`\`\``,
+                            ``,
+                            `## 진단 질문 (학생에게 먼저 묻고, 답을 즉시 주지 마세요)`,
+                            ``,
+                            `1. *데이터를 꺼내는 외부 객체*는 누구입니까? 그 객체에 *자기 행동*과 *자기 데이터*가 있습니까?`,
+                            `2. *꺼내진 데이터의 주인*은 그 처리를 *자기 책임*으로 받을 수 있습니까?`,
+                            `3. 외부 객체가 *사라져도* 같은 결과를 낼 수 있습니까? (있다면 그 객체는 가상 객체일 가능성)`,
+                            `4. 데이터의 *모양*이 아니라 *답해야 할 메시지*가 무엇입니까?`,
+                            ``,
+                            `## 4안 트레이드오프 (학생이 진단 후 함께 본다)`,
+                            ``,
+                            `### 0. 만들지 않는다 — 현 코드 유지 + 통증 관찰`,
+                            `- pros: 변경 비용 0. 추측 기반 변경 회피.`,
+                            `- cons: 통증 누적 시 비용 증가. *책임이 정말 다른 곳에 있는가* 입증되지 않은 경우.`,
+                            ``,
+                            `### A. 일방향 메시지 (\`a.action(b)\`)`,
+                            `- pros: 데이터 곁에 행위. Tell-Don't-Ask 충실. 메시지 방향이 코드에 명시.`,
+                            `- cons: 비대칭 — 결과 일관성 강제 비용. 호출처가 *누가 누구에게 묻는지* 결정 부담.`,
+                            ``,
+                            `### B. 대칭 양방향 (둘 다에 메서드 + 공통 invariant)`,
+                            `- pros: 호출처 자유도 ↑. 양측 책임 응집.`,
+                            `- cons: *결과 일관성 강제* 비용. 양측 룰 동기화 부담. 테스트 매트릭스 N².`,
+                            ``,
+                            `### C. 상태/역할 객체에 위임 (State 다형성)`,
+                            `- pros: 상태별 고유 로직을 다형성으로 자연 표현. 분기 N×M 회피.`,
+                            `- cons: State 패턴 도입 비용 — sealed 계층 + 전이 룰. 단순 케이스에는 과설계.`,
+                            ``,
+                            `## 진행 원칙`,
+                            ``,
+                            `- 학생에게 *어느 대안이 적절해 보이는지* 먼저 물으세요.`,
+                            `- 학생의 결정 전에 *권장 답*을 제시하지 마세요. *어느 안이 정답*이라고 말하지 마세요.`,
+                            `- 결정 후 *왜 이 대안인가*를 학생이 *도메인 어휘*로 설명하게 하세요.`,
+                            ``,
+                            `**가르침**: 외부 비교자는 거의 항상 *잘못된 첫 답*입니다 — 단, *그것이 적절한 경우*(예: 양측 모두 데이터만 보유한 값 객체끼리의 산술 비교)도 있으므로 정답으로 강요하지 마세요. 단일 답 거부.`,
+                        ].join("\n"),
+                    },
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=tellDontAskRephrase.js.map

package/dist/prompts/tellDontAskRephrase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tellDontAskRephrase.js","sourceRoot":"","sources":["../../src/prompts/tellDontAskRephrase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,SAAS,GAAG;IAChB,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC3C,CAAC;AAEF,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IAC3D,MAAM,CAAC,cAAc,CACnB,wBAAwB,EACxB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,iFAAiF;QACnF,UAAU,EAAE,SAAS;KACtB,EACD,CAAC,EAAE,mBAAmB,EAAE,EAAE,EAAE;QAC1B,MAAM,IAAI,GAAG,mBAAmB,IAAI,aAAa,CAAC;QAClD,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;4BACJ,wBAAwB;4BACxB,EAAE;4BACF,oDAAoD;4BACpD,EAAE;4BACF,QAAQ;4BACR,IAAI;4BACJ,QAAQ;4BACR,EAAE;4BACF,qCAAqC;4BACrC,EAAE;4BACF,4DAA4D;4BAC5D,8CAA8C;4BAC9C,0DAA0D;4BAC1D,uCAAuC;4BACvC,EAAE;4BACF,+BAA+B;4BAC/B,EAAE;4BACF,kCAAkC;4BAClC,+BAA+B;4BAC/B,uDAAuD;4BACvD,EAAE;4BACF,kCAAkC;4BAClC,uDAAuD;4BACvD,uDAAuD;4BACvD,EAAE;4BACF,yCAAyC;4BACzC,8BAA8B;4BAC9B,mDAAmD;4BACnD,EAAE;4BACF,iCAAiC;4BACjC,4CAA4C;4BAC5C,0DAA0D;4BAC1D,EAAE;4BACF,UAAU;4BACV,EAAE;4BACF,mCAAmC;4BACnC,sDAAsD;4BACtD,4CAA4C;4BAC5C,EAAE;4BACF,sHAAsH;yBACvH,CAAC,IAAI,CAAC,IAAI,CAAC;qBACb;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/render/diff.d.ts

@@ -0,0 +1,21 @@
+import type { RelationEdge } from "./mermaid.js";
+export interface ParsedDiagram {
+    classes: Set<string>;
+    relations: RelationEdge[];
+}
+export interface DesignDiff {
+    added_classes: string[];
+    removed_classes: string[];
+    kept_classes: string[];
+    added_relations: RelationEdge[];
+    removed_relations: RelationEdge[];
+    changed_relations: Array<{
+        from: string;
+        to: string;
+        before: string;
+        after: string;
+    }>;
+    kept_relations: RelationEdge[];
+}
+export declare function parseMermaid(mermaid: string): ParsedDiagram;
+export declare function diffDiagrams(before: ParsedDiagram, after: ParsedDiagram): DesignDiff;

package/dist/render/diff.js

@@ -0,0 +1,84 @@
+const CLASS_LINE = /^\s*class\s+([A-Za-z_][\w]*)(?::::[a-z]+)?\s*$/;
+const REL_LINE = /^\s*([A-Za-z_][\w]*)\s*-->\s*([A-Za-z_][\w]*)\s*:\s*(.+?)(?:\s*%%.*)?$/;
+export function parseMermaid(mermaid) {
+    const classes = new Set();
+    const relations = [];
+    for (const raw of mermaid.split("\n")) {
+        const line = raw.trim();
+        if (!line || line.startsWith("%%") || line.startsWith("classDef") || line === "classDiagram") {
+            continue;
+        }
+        const m1 = CLASS_LINE.exec(line);
+        if (m1) {
+            classes.add(m1[1]);
+            continue;
+        }
+        const m2 = REL_LINE.exec(line);
+        if (m2) {
+            const from = m2[1];
+            const to = m2[2];
+            const message = m2[3].trim();
+            classes.add(from);
+            classes.add(to);
+            relations.push({ from, to, message });
+        }
+    }
+    return { classes, relations };
+}
+function edgeKey(r) {
+    return `${r.from}->${r.to}`;
+}
+function edgeFullKey(r) {
+    return `${r.from}->${r.to}::${r.message}`;
+}
+export function diffDiagrams(before, after) {
+    const added_classes = [...after.classes].filter((c) => !before.classes.has(c)).sort();
+    const removed_classes = [...before.classes].filter((c) => !after.classes.has(c)).sort();
+    const kept_classes = [...after.classes].filter((c) => before.classes.has(c)).sort();
+    const beforeMap = new Map();
+    for (const r of before.relations)
+        beforeMap.set(edgeKey(r), r);
+    const afterMap = new Map();
+    for (const r of after.relations)
+        afterMap.set(edgeKey(r), r);
+    const added_relations = [];
+    const removed_relations = [];
+    const changed_relations = [];
+    const kept_relations = [];
+    for (const [k, afterR] of afterMap) {
+        const beforeR = beforeMap.get(k);
+        if (!beforeR) {
+            added_relations.push(afterR);
+        }
+        else if (beforeR.message !== afterR.message) {
+            changed_relations.push({
+                from: afterR.from,
+                to: afterR.to,
+                before: beforeR.message,
+                after: afterR.message,
+            });
+        }
+        else {
+            kept_relations.push(afterR);
+        }
+    }
+    for (const [k, beforeR] of beforeMap) {
+        if (!afterMap.has(k))
+            removed_relations.push(beforeR);
+    }
+    const sortRel = (a, b) => edgeFullKey(a).localeCompare(edgeFullKey(b));
+    added_relations.sort(sortRel);
+    removed_relations.sort(sortRel);
+    kept_relations.sort(sortRel);
+    changed_relations.sort((a, b) => `${a.from}->${a.to}`.localeCompare(`${b.from}->${b.to}`));
+    return {
+        added_classes,
+        removed_classes,
+        kept_classes,
+        added_relations,
+        removed_relations,
+        changed_relations,
+        kept_relations,
+    };
+}
+//# sourceMappingURL=diff.js.map

package/dist/render/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/render/diff.ts"],"names":[],"mappings":"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"}

package/dist/render/mermaid.d.ts

@@ -0,0 +1,24 @@
+import type { CrcCard, Collaboration } from "../domain/model.js";
+export interface DiagramInput {
+    classes: CrcCard[];
+    collaborations: Collaboration[];
+}
+export interface RelationEdge {
+    from: string;
+    to: string;
+    message: string;
+}
+export type EdgeAnnotation = "added" | "removed" | "changed" | "kept";
+export interface AnnotatedClass {
+    name: string;
+    annotation?: EdgeAnnotation;
+}
+export interface AnnotatedRelation extends RelationEdge {
+    annotation?: EdgeAnnotation;
+}
+export declare function buildRelations(input: DiagramInput): RelationEdge[];
+export declare function renderClassDiagram(input: DiagramInput): string;
+export declare function renderAnnotated(input: {
+    classes: AnnotatedClass[];
+    relations: AnnotatedRelation[];
+}): string;

package/dist/render/mermaid.js

@@ -0,0 +1,53 @@
+// Mermaid의 classDiagram은 classDef/:::를 v10+에서만 지원한다.
+// GitHub·Notion·다수 IDE 뷰어는 v9 이하라, classDef가 한 줄이라도 들어가면
+// 다이어그램 전체가 "Parse error"로 죽는다(실측: 9.4.0에서 line 2 파싱 실패).
+// → 보편 호환을 위해 classDef/:::를 쓰지 않고, 모든 버전이 지원하는
+//   <<annotation>> 블록(클래스)과 라벨 접미사(관계)로 diff 상태를 표기한다.
+const HEADER_LINES = ["classDiagram"];
+function classDeclLine(c) {
+    if (c.annotation && c.annotation !== "kept") {
+        // <<...>> 주석은 모든 Mermaid 버전이 지원 (classDef 색상 대체)
+        return `  class ${c.name} {\n    <<${c.annotation}>>\n  }`;
+    }
+    return `  class ${c.name}`;
+}
+function relationLine(r) {
+    // 줄 끝 %% 주석은 일부 뷰어에서 라벨로 오파싱된다 → 라벨 접미사로 상태 표기.
+    const suffix = r.annotation && r.annotation !== "kept" ? ` [${r.annotation}]` : "";
+    return `  ${r.from} --> ${r.to} : ${r.message}${suffix}`;
+}
+export function buildRelations(input) {
+    const idToName = new Map(input.classes.map((c) => [c.id, c.name]));
+    const seen = new Set();
+    const edges = [];
+    for (const c of input.collaborations) {
+        const from = idToName.get(c.from) ?? c.from;
+        const to = idToName.get(c.to) ?? c.to;
+        const key = `${from}::${to}::${c.message}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        edges.push({ from, to, message: c.message });
+    }
+    return edges.sort((a, b) => a.from === b.from
+        ? a.to === b.to
+            ? a.message.localeCompare(b.message)
+            : a.to.localeCompare(b.to)
+        : a.from.localeCompare(b.from));
+}
+export function renderClassDiagram(input) {
+    const classes = input.classes
+        .map((c) => ({ name: c.name }))
+        .sort((a, b) => a.name.localeCompare(b.name));
+    const relations = buildRelations(input);
+    return renderAnnotated({ classes, relations });
+}
+export function renderAnnotated(input) {
+    const lines = [...HEADER_LINES];
+    for (const c of input.classes)
+        lines.push(classDeclLine(c));
+    for (const r of input.relations)
+        lines.push(relationLine(r));
+    return lines.join("\n") + "\n";
+}
+//# sourceMappingURL=mermaid.js.map

package/dist/render/mermaid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid.js","sourceRoot":"","sources":["../../src/render/mermaid.ts"],"names":[],"mappings":"AAwBA,qDAAqD;AACrD,yDAAyD;AACzD,0DAA0D;AAC1D,+CAA+C;AAC/C,uDAAuD;AACvD,MAAM,YAAY,GAAG,CAAC,cAAc,CAAC,CAAC;AAEtC,SAAS,aAAa,CAAC,CAAiB;IACtC,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;QAC5C,iDAAiD;QACjD,OAAO,WAAW,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,UAAU,SAAS,CAAC;IAC7D,CAAC;IACD,OAAO,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7B,CAAC;AAED,SAAS,YAAY,CAAC,CAAoB;IACxC,gDAAgD;IAChD,MAAM,MAAM,GACV,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,OAAO,KAAK,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,OAAO,GAAG,MAAM,EAAE,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAmB;IAChD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAU,CAAC,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;QAC5C,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,GAAG,IAAI,KAAK,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACzB,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;QACf,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE;YACb,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC;YACpC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CACjC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAmB;IACpD,MAAM,OAAO,GAAqB,KAAK,CAAC,OAAO;SAC5C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;SAC9B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,MAAM,SAAS,GAAwB,cAAc,CAAC,KAAK,CAAC,CAAC;IAC7D,OAAO,eAAe,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAG/B;IACC,MAAM,KAAK,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACjC,CAAC"}

package/dist/render/sideBySide.d.ts

@@ -0,0 +1,14 @@
+import { type DesignDiff } from "./diff.js";
+export interface SideBySideResult {
+    before_mermaid: string;
+    after_mermaid: string;
+    side_by_side_markdown: string;
+    diff: DesignDiff;
+}
+export declare function annotateBefore(mermaid: string, diff: DesignDiff): string;
+export declare function annotateAfter(mermaid: string, diff: DesignDiff): string;
+export declare function buildSideBySide(beforeMermaid: string, afterMermaid: string, diff: DesignDiff, labels?: {
+    before: string;
+    after: string;
+}): SideBySideResult;
+export declare function renderDiffSummary(diff: DesignDiff): string;

package/dist/render/sideBySide.js

@@ -0,0 +1,91 @@
+import { parseMermaid } from "./diff.js";
+import { renderAnnotated, } from "./mermaid.js";
+export function annotateBefore(mermaid, diff) {
+    const parsed = parseMermaid(mermaid);
+    const removedClasses = new Set(diff.removed_classes);
+    const classes = [...parsed.classes]
+        .sort()
+        .map((name) => ({
+        name,
+        annotation: removedClasses.has(name) ? "removed" : "kept",
+    }));
+    const removedRelKey = (r) => `${r.from}->${r.to}`;
+    const removedSet = new Set(diff.removed_relations.map(removedRelKey));
+    const changedSet = new Set(diff.changed_relations.map(removedRelKey));
+    const relations = parsed.relations
+        .slice()
+        .sort((a, b) => `${a.from}::${a.to}::${a.message}`.localeCompare(`${b.from}::${b.to}::${b.message}`))
+        .map((r) => {
+        const k = removedRelKey(r);
+        if (removedSet.has(k))
+            return { ...r, annotation: "removed" };
+        if (changedSet.has(k))
+            return { ...r, annotation: "changed" };
+        return { ...r, annotation: "kept" };
+    });
+    return renderAnnotated({ classes, relations });
+}
+export function annotateAfter(mermaid, diff) {
+    const parsed = parseMermaid(mermaid);
+    const addedClasses = new Set(diff.added_classes);
+    const classes = [...parsed.classes]
+        .sort()
+        .map((name) => ({
+        name,
+        annotation: addedClasses.has(name) ? "added" : "kept",
+    }));
+    const relKey = (r) => `${r.from}->${r.to}`;
+    const addedSet = new Set(diff.added_relations.map(relKey));
+    const changedSet = new Set(diff.changed_relations.map(relKey));
+    const relations = parsed.relations
+        .slice()
+        .sort((a, b) => `${a.from}::${a.to}::${a.message}`.localeCompare(`${b.from}::${b.to}::${b.message}`))
+        .map((r) => {
+        const k = relKey(r);
+        if (addedSet.has(k))
+            return { ...r, annotation: "added" };
+        if (changedSet.has(k))
+            return { ...r, annotation: "changed" };
+        return { ...r, annotation: "kept" };
+    });
+    return renderAnnotated({ classes, relations });
+}
+const LEGEND = `**범례:** 추가 (added) · 제거 (removed) · 변경 (changed) · 유지 (kept)\n` +
+    `클래스는 \`<<added>>/<<removed>>/<<changed>>\` 주석으로, 관계는 화살표 라벨 뒤 \`[added]/[removed]/[changed]\`로 표기합니다. (구버전 Mermaid 호환을 위해 classDef 색상은 쓰지 않습니다.)\n`;
+export function buildSideBySide(beforeMermaid, afterMermaid, diff, labels = { before: "Before", after: "After" }) {
+    const before_mermaid = annotateBefore(beforeMermaid, diff);
+    const after_mermaid = annotateAfter(afterMermaid, diff);
+    const summary = renderDiffSummary(diff);
+    const md = `${LEGEND}\n` +
+        `## ${labels.before}\n\n` +
+        "```mermaid\n" +
+        before_mermaid +
+        "```\n\n" +
+        `## ${labels.after}\n\n` +
+        "```mermaid\n" +
+        after_mermaid +
+        "```\n\n" +
+        `## 변경 요약\n\n${summary}\n`;
+    return {
+        before_mermaid,
+        after_mermaid,
+        side_by_side_markdown: md,
+        diff,
+    };
+}
+export function renderDiffSummary(diff) {
+    const lines = [];
+    const fmtRel = (r) => `\`${r.from} --> ${r.to} : ${r.message}\``;
+    lines.push(`- **추가된 클래스 (${diff.added_classes.length}):** ${diff.added_classes.length ? diff.added_classes.map((c) => `\`${c}\``).join(", ") : "(없음)"}`);
+    lines.push(`- **제거된 클래스 (${diff.removed_classes.length}):** ${diff.removed_classes.length ? diff.removed_classes.map((c) => `\`${c}\``).join(", ") : "(없음)"}`);
+    lines.push(`- **추가된 관계 (${diff.added_relations.length}):** ${diff.added_relations.length ? diff.added_relations.map(fmtRel).join(", ") : "(없음)"}`);
+    lines.push(`- **제거된 관계 (${diff.removed_relations.length}):** ${diff.removed_relations.length ? diff.removed_relations.map(fmtRel).join(", ") : "(없음)"}`);
+    if (diff.changed_relations.length) {
+        lines.push(`- **메시지가 변경된 관계 (${diff.changed_relations.length}):** ` +
+            diff.changed_relations
+                .map((c) => `\`${c.from} --> ${c.to}\` (\`${c.before}\` → \`${c.after}\`)`)
+                .join(", "));
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=sideBySide.js.map

package/dist/render/sideBySide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sideBySide.js","sourceRoot":"","sources":["../../src/render/sideBySide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,YAAY,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAGL,eAAe,GAChB,MAAM,cAAc,CAAC;AAStB,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,IAAgB;IAC9D,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACrD,MAAM,OAAO,GAAqB,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;SAClD,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACd,IAAI;QACJ,UAAU,EAAE,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;KAC1D,CAAC,CAAC,CAAC;IAEN,MAAM,aAAa,GAAG,CAAC,CAA+B,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;IAChF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;IACtE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;IAEtE,MAAM,SAAS,GAAwB,MAAM,CAAC,SAAS;SACpD,KAAK,EAAE;SACP,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;SACpG,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,SAAkB,EAAE,CAAC;QACvE,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,SAAkB,EAAE,CAAC;QACvE,OAAO,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,MAAe,EAAE,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEL,OAAO,eAAe,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,IAAgB;IAC7D,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACjD,MAAM,OAAO,GAAqB,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;SAClD,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACd,IAAI;QACJ,UAAU,EAAE,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;KACtD,CAAC,CAAC,CAAC;IAEN,MAAM,MAAM,GAAG,CAAC,CAA+B,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;IACzE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAE/D,MAAM,SAAS,GAAwB,MAAM,CAAC,SAAS;SACpD,KAAK,EAAE;SACP,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;SACpG,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,OAAgB,EAAE,CAAC;QACnE,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,SAAkB,EAAE,CAAC;QACvE,OAAO,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,MAAe,EAAE,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEL,OAAO,eAAe,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,MAAM,GAAG,gEAAgE;IAC7E,oJAAoJ,CAAC;AAEvJ,MAAM,UAAU,eAAe,CAC7B,aAAqB,EACrB,YAAoB,EACpB,IAAgB,EAChB,SAA4C,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE;IAEhF,MAAM,cAAc,GAAG,cAAc,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IAC3D,MAAM,aAAa,GAAG,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IAExD,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAExC,MAAM,EAAE,GACN,GAAG,MAAM,IAAI;QACb,MAAM,MAAM,CAAC,MAAM,MAAM;QACzB,cAAc;QACd,cAAc;QACd,SAAS;QACT,MAAM,MAAM,CAAC,KAAK,MAAM;QACxB,cAAc;QACd,aAAa;QACb,SAAS;QACT,eAAe,OAAO,IAAI,CAAC;IAE7B,OAAO;QACL,cAAc;QACd,aAAa;QACb,qBAAqB,EAAE,EAAE;QACzB,IAAI;KACL,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAgB;IAChD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,CAAC,CAAgD,EAAE,EAAE,CAClE,KAAK,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,OAAO,IAAI,CAAC;IAE7C,KAAK,CAAC,IAAI,CACR,gBAAgB,IAAI,CAAC,aAAa,CAAC,MAAM,QACvC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MACrF,EAAE,CACH,CAAC;IACF,KAAK,CAAC,IAAI,CACR,gBAAgB,IAAI,CAAC,eAAe,CAAC,MAAM,QACzC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MACzF,EAAE,CACH,CAAC;IACF,KAAK,CAAC,IAAI,CACR,eAAe,IAAI,CAAC,eAAe,CAAC,MAAM,QACxC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAC9E,EAAE,CACH,CAAC;IACF,KAAK,CAAC,IAAI,CACR,eAAe,IAAI,CAAC,iBAAiB,CAAC,MAAM,QAC1C,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAClF,EAAE,CACH,CAAC;IACF,IAAI,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CACR,oBAAoB,IAAI,CAAC,iBAAiB,CAAC,MAAM,OAAO;YACtD,IAAI,CAAC,iBAAiB;iBACnB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,MAAM,UAAU,CAAC,CAAC,KAAK,KAAK,CAAC;iBAC1E,IAAI,CAAC,IAAI,CAAC,CAChB,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/resources/index.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAllResources(server: McpServer): void;