@leonardocrdso/modular-monolith-mcp 1.0.0 → 1.0.2

package/build/index.js

@@ -1,4 +1,5 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
+// @bun
 var __create = Object.create;
 var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
@@ -19598,7 +19599,7 @@ var EMPTY_COMPLETION_RESULT = {
 };
 
 // node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
-import process from "node:process";
+import process from "process";
 
 // node_modules/@modelcontextprotocol/sdk/dist/esm/shared/stdio.js
 class ReadBuffer {
@@ -19741,7 +19742,7 @@ var RULES = [
         note: "Business changes affect a single module instead of multiple layers"
       }
     ],
-    source: "Kamil Grzybek — Modular Monolith"
+    source: "Kamil Grzybek \u2014 Modular Monolith"
   },
   {
     id: "vertical-slice-per-module",
@@ -19779,7 +19780,7 @@ models/orders.ts
         note: "Each module has a single business responsibility with all needed layers"
       }
     ],
-    source: "Jimmy Bogard — Vertical Slice Architecture"
+    source: "Jimmy Bogard \u2014 Vertical Slice Architecture"
   },
   {
     id: "standard-module-layout",
@@ -19793,12 +19794,12 @@ models/orders.ts
         language: "typescript",
         code: `// Standard module layout - every module follows this
 // modules/{name}/
-//   {name}.service.ts     — Business logic
-//   {name}.repository.ts  — Data access
-//   {name}.types.ts       — Domain types & interfaces
-//   {name}.validation.ts  — Zod schemas for input
-//   {name}.routes.ts      — API routes (if applicable)
-//   index.ts              — Public API barrel export`
+//   {name}.service.ts     \u2014 Business logic
+//   {name}.repository.ts  \u2014 Data access
+//   {name}.types.ts       \u2014 Domain types & interfaces
+//   {name}.validation.ts  \u2014 Zod schemas for input
+//   {name}.routes.ts      \u2014 API routes (if applicable)
+//   index.ts              \u2014 Public API barrel export`
       },
       {
         label: "Bad",
@@ -19820,7 +19821,7 @@ modules/users/
       {
         principleId: "pick-one-word-per-concept",
         relationship: "extends",
-        note: "Consistent naming across modules — same file names, same patterns"
+        note: "Consistent naming across modules \u2014 same file names, same patterns"
       }
     ]
   },
@@ -19848,7 +19849,7 @@ export type { Order, CreateOrderInput } from "./order.types.js";`
       {
         label: "Bad",
         language: "typescript",
-        code: `// app-bootstrap.ts — Centralizes ALL module wiring
+        code: `// app-bootstrap.ts \u2014 Centralizes ALL module wiring
 import { OrderService } from "./modules/orders/order.service.js";
 import { OrderRepository } from "./modules/orders/order.repository.js";
 import { UserService } from "./modules/users/user.service.js";
@@ -19883,7 +19884,7 @@ const orderService = new OrderService(orderRepo);
       {
         label: "Good",
         language: "typescript",
-        code: `// modules/orders/index.ts — The module's public contract
+        code: `// modules/orders/index.ts \u2014 The module's public contract
 export { orderService } from "./order.service.js";
 export type { Order, CreateOrderInput } from "./order.types.js";
 export type { OrderService } from "./order.service.js";
@@ -19893,7 +19894,7 @@ export type { OrderService } from "./order.service.js";
       {
         label: "Bad",
         language: "typescript",
-        code: `// No index.ts — consumers import directly from internals
+        code: `// No index.ts \u2014 consumers import directly from internals
 import { OrderRepository } from "../orders/order.repository.js";
 import { mapOrderToDTO } from "../orders/internal/mappers.js";`
       }
@@ -19903,7 +19904,7 @@ import { mapOrderToDTO } from "../orders/internal/mappers.js";`
       {
         principleId: "data-abstraction",
         relationship: "reinforces",
-        note: "Public API abstracts module internals — consumers see the interface, not the implementation"
+        note: "Public API abstracts module internals \u2014 consumers see the interface, not the implementation"
       },
       {
         principleId: "interface-segregation-principle",
@@ -19911,7 +19912,7 @@ import { mapOrderToDTO } from "../orders/internal/mappers.js";`
         note: "Module exposes only what consumers need, not everything it contains"
       }
     ],
-    source: "Kamil Grzybek — Modular Monolith"
+    source: "Kamil Grzybek \u2014 Modular Monolith"
   },
   {
     id: "hide-implementation-details",
@@ -19940,7 +19941,7 @@ import type { Order } from "../orders/index.js";`
       {
         principleId: "law-of-demeter",
         relationship: "extends",
-        note: "Don't reach into another module's internals — talk to its public API"
+        note: "Don't reach into another module's internals \u2014 talk to its public API"
       },
       {
         principleId: "avoid-inappropriate-intimacy",
@@ -20000,7 +20001,7 @@ export async function getOrder(id: string): Promise<OrderDTO | null> {
       {
         label: "Good",
         language: "typescript",
-        code: `// Additive change — backwards compatible
+        code: `// Additive change \u2014 backwards compatible
 export interface OrderDTO {
   id: string;
   status: string;
@@ -20012,11 +20013,11 @@ export interface OrderDTO {
       {
         label: "Bad",
         language: "typescript",
-        code: `// Breaking change — renamed field without migration
+        code: `// Breaking change \u2014 renamed field without migration
 export interface OrderDTO {
   id: string;
   status: string;
-  // Was: totalCents, now: amountInCents — breaks all consumers
+  // Was: totalCents, now: amountInCents \u2014 breaks all consumers
   amountInCents: number;
 }`
       }
@@ -20183,7 +20184,7 @@ export class OrderService {
     name: "Anti-Corruption Layer",
     category: "module-communication",
     description: "When integrating with another module or external system whose model differs from yours, introduce an Anti-Corruption Layer (ACL) that translates between the foreign model and your internal model.",
-    rationale: "An ACL prevents foreign concepts from leaking into your module. If the external model changes, only the ACL needs updating — your business logic stays clean.",
+    rationale: "An ACL prevents foreign concepts from leaking into your module. If the external model changes, only the ACL needs updating \u2014 your business logic stays clean.",
     examples: [
       {
         label: "Good",
@@ -20204,10 +20205,10 @@ export function toShippableItem(order: Order): ShippableItem {
       {
         label: "Bad",
         language: "typescript",
-        code: `// Shipping logic uses Order types directly — foreign model leaks in
+        code: `// Shipping logic uses Order types directly \u2014 foreign model leaks in
 export class ShippingService {
   async ship(order: Order) {
-    // Using order.items[0].product.category — deep coupling
+    // Using order.items[0].product.category \u2014 deep coupling
     if (order.items[0].product.category === "fragile") {
       // Shipping knows about product categories
     }
@@ -20223,7 +20224,7 @@ export class ShippingService {
         note: "ACL abstracts the foreign model, exposing only what the module needs"
       }
     ],
-    source: "Eric Evans — Domain-Driven Design"
+    source: "Eric Evans \u2014 Domain-Driven Design"
   },
   {
     id: "separate-module-data",
@@ -20251,10 +20252,10 @@ const order = await orderService.getById(orderId);`
       {
         principleId: "avoid-inappropriate-intimacy",
         relationship: "extends",
-        note: "Data-level intimacy is the deepest form — modules must not access each other's data stores"
+        note: "Data-level intimacy is the deepest form \u2014 modules must not access each other's data stores"
       }
     ],
-    source: "Sam Newman — Building Microservices"
+    source: "Sam Newman \u2014 Building Microservices"
   },
   {
     id: "no-cross-module-joins",
@@ -20293,7 +20294,7 @@ const enriched = pendingOrders.map(order => ({
       {
         principleId: "single-responsibility-principle",
         relationship: "reinforces",
-        note: "Each module manages its own data access — no shared queries"
+        note: "Each module manages its own data access \u2014 no shared queries"
       }
     ]
   },
@@ -20307,7 +20308,7 @@ const enriched = pendingOrders.map(order => ({
       {
         label: "Good",
         language: "prisma",
-        code: `// schema.prisma — Logical separation with comments
+        code: `// schema.prisma \u2014 Logical separation with comments
 // === MODULE: orders ===
 model Order {
   id        String   @id @default(uuid())
@@ -20327,7 +20328,7 @@ model User {
       {
         label: "Bad",
         language: "prisma",
-        code: `// No ownership indication — who owns what?
+        code: `// No ownership indication \u2014 who owns what?
 model Order {
   id     String @id
   user   User   @relation(fields: [userId], references: [id])
@@ -20366,7 +20367,7 @@ export class UserService {
   async deactivate(id: string): Promise<void> { /* ... */ }
 }
 
-// Other modules call the service — never write to user tables directly`
+// Other modules call the service \u2014 never write to user tables directly`
       },
       {
         label: "Bad",
@@ -20400,7 +20401,7 @@ async deactivateUser(userId: string) {
       {
         label: "Bad",
         language: "typescript",
-        code: `// Circular: orders → users → orders
+        code: `// Circular: orders \u2192 users \u2192 orders
 // modules/orders/order.service.ts
 import { userService } from "../users/index.js";
 
@@ -20429,7 +20430,7 @@ eventBus.on("order.created", async ({ userId }) => {
         note: "Break cycles by depending on abstractions (interfaces/events) instead of concrete modules"
       }
     ],
-    source: "Robert C. Martin — Clean Architecture"
+    source: "Robert C. Martin \u2014 Clean Architecture"
   },
   {
     id: "depend-on-abstractions",
@@ -20470,7 +20471,7 @@ export class OrderService {
       {
         principleId: "dependency-inversion-principle",
         relationship: "reinforces",
-        note: "High-level modules should not depend on low-level modules — both depend on abstractions"
+        note: "High-level modules should not depend on low-level modules \u2014 both depend on abstractions"
       },
       {
         principleId: "open-closed-principle",
@@ -20483,15 +20484,15 @@ export class OrderService {
     id: "dependency-direction",
     name: "Dependency Direction",
     category: "dependency-management",
-    description: "Dependencies should flow in one direction: infrastructure → application → domain. Higher-level modules (domain) should never depend on lower-level modules (infrastructure).",
+    description: "Dependencies should flow in one direction: infrastructure \u2192 application \u2192 domain. Higher-level modules (domain) should never depend on lower-level modules (infrastructure).",
     rationale: "Unidirectional dependency flow makes the system predictable. Domain logic stays pure and testable, free from infrastructure concerns.",
     examples: [
       {
         label: "Good",
         language: "text",
         code: `Dependency flow:
-  Routes (infra) → Service (app) → Types/Interfaces (domain)
-  Repository (infra) → implements → RepositoryInterface (domain)
+  Routes (infra) \u2192 Service (app) \u2192 Types/Interfaces (domain)
+  Repository (infra) \u2192 implements \u2192 RepositoryInterface (domain)
 
 Domain layer has ZERO external dependencies.`
       },
@@ -20511,10 +20512,10 @@ export interface Order {
       {
         principleId: "separate-construction-from-use",
         relationship: "complements",
-        note: "Infrastructure is constructed and injected — domain uses abstractions"
+        note: "Infrastructure is constructed and injected \u2014 domain uses abstractions"
       }
     ],
-    source: "Robert C. Martin — Clean Architecture"
+    source: "Robert C. Martin \u2014 Clean Architecture"
   },
   {
     id: "thin-routes",
@@ -20526,7 +20527,7 @@ export interface Order {
       {
         label: "Good",
         language: "typescript",
-        code: `// Thin route: validate → call service → respond
+        code: `// Thin route: validate \u2192 call service \u2192 respond
 app.post("/orders", async (req, res) => {
   const input = createOrderSchema.parse(req.body);
   const order = await orderService.create(input);
@@ -20580,7 +20581,7 @@ app.post("/orders", async (req, res) => {
         label: "Good",
         language: "typescript",
         code: `// modules/orders/order.routes.ts
-// Only calls orderService — belongs to orders module
+// Only calls orderService \u2014 belongs to orders module
 app.get("/orders/:id", async (req, res) => {
   const order = await orderService.getById(req.params.id);
   res.json(order);
@@ -20608,7 +20609,7 @@ app.post("/checkout", async (req, res) => {
       {
         principleId: "single-responsibility-principle",
         relationship: "implements",
-        note: "Each route file has one reason to change — its owning module's requirements"
+        note: "Each route file has one reason to change \u2014 its owning module's requirements"
       }
     ]
   },
@@ -20655,7 +20656,7 @@ export class OrderService {
       {
         principleId: "prefer-exceptions-to-error-codes",
         relationship: "complements",
-        note: "Zod throws on invalid input — clean exception-based validation"
+        note: "Zod throws on invalid input \u2014 clean exception-based validation"
       }
     ]
   },
@@ -20694,10 +20695,10 @@ export class OrderService {
       {
         principleId: "classes-should-be-small",
         relationship: "extends",
-        note: "Like classes, the shared kernel should be small — only the essentials"
+        note: "Like classes, the shared kernel should be small \u2014 only the essentials"
       }
     ],
-    source: "Eric Evans — Domain-Driven Design"
+    source: "Eric Evans \u2014 Domain-Driven Design"
   },
   {
     id: "prefer-duplication-over-coupling",
@@ -20719,7 +20720,7 @@ const emailSchema = z.string().email();
       {
         label: "Bad",
         language: "typescript",
-        code: `// shared/validators.ts — Forces coupling
+        code: `// shared/validators.ts \u2014 Forces coupling
 export const emailSchema = z.string().email().min(5);
 // Change here breaks BOTH orders and users
 // What if orders needs .min(3) but users needs .min(5)?`
@@ -20733,19 +20734,19 @@ export const emailSchema = z.string().email().min(5);
         note: "DRY applies within a module. Across modules, controlled duplication is preferred over coupling"
       }
     ],
-    source: "Sandi Metz — The Wrong Abstraction"
+    source: "Sandi Metz \u2014 The Wrong Abstraction"
   },
   {
     id: "shared-types-only",
     name: "Shared Types Only",
     category: "shared-kernel",
-    description: "The shared kernel should contain only types, interfaces, and constants — never implementations. If you need shared behavior, use dependency injection or events instead of shared code.",
+    description: "The shared kernel should contain only types, interfaces, and constants \u2014 never implementations. If you need shared behavior, use dependency injection or events instead of shared code.",
     rationale: "Types are the safest thing to share because they have no behavior. Shared implementations create coupling and make it hard to reason about which module controls which behavior.",
     examples: [
       {
         label: "Good",
         language: "typescript",
-        code: `// shared/types.ts — Types only, no implementation
+        code: `// shared/types.ts \u2014 Types only, no implementation
 export interface Paginated<T> {
   items: T[];
   total: number;
@@ -20762,7 +20763,7 @@ export interface Result<T, E = Error> {
       {
         label: "Bad",
         language: "typescript",
-        code: `// shared/pagination.ts — Implementation in shared kernel
+        code: `// shared/pagination.ts \u2014 Implementation in shared kernel
 export function paginate<T>(items: T[], page: number, size: number): Paginated<T> {
   const start = (page - 1) * size;
   return {
@@ -20779,7 +20780,7 @@ export function paginate<T>(items: T[], page: number, size: number): Paginated<T
       {
         principleId: "interface-segregation-principle",
         relationship: "reinforces",
-        note: "Share only the minimal interface needed — types are inherently segregated"
+        note: "Share only the minimal interface needed \u2014 types are inherently segregated"
       }
     ]
   },
@@ -21038,7 +21039,7 @@ export class OrderService {
       {
         label: "Good",
         language: "typescript",
-        code: `// Switching from Stripe to PayPal — only payment module changes
+        code: `// Switching from Stripe to PayPal \u2014 only payment module changes
 // modules/payments/paypal-client.ts (new)
 export class PayPalClient implements PaymentGateway {
   async charge(amount: number, currency: string): Promise<PaymentResult> {
@@ -21046,9 +21047,9 @@ export class PayPalClient implements PaymentGateway {
   }
 }
 
-// modules/payments/index.ts — swap the implementation
+// modules/payments/index.ts \u2014 swap the implementation
 export const paymentGateway: PaymentGateway = new PayPalClient();
-// All consumers still use PaymentGateway interface — zero changes needed`
+// All consumers still use PaymentGateway interface \u2014 zero changes needed`
       },
       {
         label: "Bad",
@@ -21077,7 +21078,7 @@ export const paymentGateway: PaymentGateway = new PayPalClient();
       {
         label: "Good",
         language: "text",
-        code: `Phase 1: New features → proper modules
+        code: `Phase 1: New features \u2192 proper modules
 Phase 2: Extract highest-value legacy area into module
 Phase 3: Route traffic to new module, keep legacy as fallback
 Phase 4: Remove legacy code when new module is proven
@@ -21097,10 +21098,10 @@ Phase 5: Repeat for next area`
       {
         principleId: "simple-design-runs-all-tests",
         relationship: "complements",
-        note: "Each migration step must pass all tests — incremental confidence"
+        note: "Each migration step must pass all tests \u2014 incremental confidence"
       }
     ],
-    source: "Martin Fowler — Strangler Fig Application"
+    source: "Martin Fowler \u2014 Strangler Fig Application"
   },
   {
     id: "extract-module-gradually",
@@ -21124,7 +21125,7 @@ Step 5: Now refactor internals safely`
         code: `Step 1: Create modules/orders/
 Step 2: Move files AND refactor AND rename AND add tests
          AND change the database schema AND...
-→ Massive PR, impossible to review, high risk of bugs`
+\u2192 Massive PR, impossible to review, high risk of bugs`
       }
     ],
     tags: ["migration", "extraction", "gradual", "refactoring", "boundary"],
@@ -21158,7 +21159,7 @@ Month 7+:  Extract high-complexity areas into modules
 Day 2: Realize "orders" and "cart" should be one module
 Day 3: Realize "notifications" needs to be split
 Day 4: Rewrite module boundaries AGAIN
-→ More time on architecture than features`
+\u2192 More time on architecture than features`
       }
     ],
     tags: ["migration", "monolith", "start", "premature", "boundaries"],
@@ -21169,7 +21170,7 @@ Day 4: Rewrite module boundaries AGAIN
         note: "Minimal design: don't add module boundaries until they're needed"
       }
     ],
-    source: "Martin Fowler — MonolithFirst"
+    source: "Martin Fowler \u2014 MonolithFirst"
   },
   {
     id: "measure-before-splitting",
@@ -21182,20 +21183,20 @@ Day 4: Rewrite module boundaries AGAIN
         label: "Good",
         language: "text",
         code: `Before splitting, analyze:
-✓ Import graph: which files depend on which?
-✓ Change coupling: which files change together?
-✓ Team ownership: does one team own this area?
-✓ Deployment: does this area need independent deployment?
-✓ Scale: does this area need independent scaling?`
+\u2713 Import graph: which files depend on which?
+\u2713 Change coupling: which files change together?
+\u2713 Team ownership: does one team own this area?
+\u2713 Deployment: does this area need independent deployment?
+\u2713 Scale: does this area need independent scaling?`
       },
       {
         label: "Bad",
         language: "text",
         code: `"Orders feels too big, let's split it into
  order-creation, order-fulfillment, and order-history"
-→ No data to support this split
-→ High communication overhead between new modules
-→ Essentially a distributed monolith`
+\u2192 No data to support this split
+\u2192 High communication overhead between new modules
+\u2192 Essentially a distributed monolith`
       }
     ],
     tags: ["migration", "measure", "coupling", "cohesion", "split", "metrics"],
@@ -21203,7 +21204,7 @@ Day 4: Rewrite module boundaries AGAIN
       {
         principleId: "high-cohesion",
         relationship: "reinforces",
-        note: "Measure cohesion — if a module's parts don't belong together, split is warranted"
+        note: "Measure cohesion \u2014 if a module's parts don't belong together, split is warranted"
       }
     ]
   }
@@ -21263,7 +21264,7 @@ await userService.recordLastOrder(userId);`
   payment.service.ts
   notification.service.ts
   analytics.service.ts
-  # Everything is in "core" — it's a monolith inside a monolith`
+  # Everything is in "core" \u2014 it's a monolith inside a monolith`
       },
       {
         label: "Good",
@@ -21280,7 +21281,7 @@ await userService.recordLastOrder(userId);`
       {
         principleId: "single-responsibility-principle",
         relationship: "reinforces",
-        note: "A god module violates SRP at the module level — multiple reasons to change"
+        note: "A god module violates SRP at the module level \u2014 multiple reasons to change"
       },
       {
         principleId: "classes-should-be-small",
@@ -21303,7 +21304,7 @@ import { userService } from "../users/index.js";
 
 // modules/users/user.service.ts
 import { orderService } from "../orders/index.js";
-// CIRCULAR: orders → users → orders`
+// CIRCULAR: orders \u2192 users \u2192 orders`
       },
       {
         label: "Good",
@@ -21312,7 +21313,7 @@ import { orderService } from "../orders/index.js";
 // modules/orders/order.service.ts
 import { userService } from "../users/index.js"; // OK
 
-// modules/users/user.service.ts — no import from orders
+// modules/users/user.service.ts \u2014 no import from orders
 eventBus.on("order.created", async ({ userId }) => {
   await userService.incrementOrderCount(userId);
 });`
@@ -21371,7 +21372,7 @@ eventBus.on("order.created", async ({ userId }) => {
       {
         principleId: "keep-functions-small",
         relationship: "reinforces",
-        note: "Fat routes are long functions — extract to service"
+        note: "Fat routes are long functions \u2014 extract to service"
       }
     ]
   },
@@ -21388,7 +21389,7 @@ eventBus.on("order.created", async ({ userId }) => {
 export async function getUser(id: string): Promise<PrismaUser> {
   return prisma.user.findUniqueOrThrow({ where: { id } });
 }
-// Consumers now depend on Prisma — internal detail`
+// Consumers now depend on Prisma \u2014 internal detail`
       },
       {
         label: "Good",
@@ -21410,7 +21411,7 @@ export async function getUser(id: string): Promise<UserDTO | null> {
       {
         principleId: "data-abstraction",
         relationship: "reinforces",
-        note: "Proper abstraction hides implementation — leaky abstractions expose it"
+        note: "Proper abstraction hides implementation \u2014 leaky abstractions expose it"
       }
     ]
   },
@@ -21484,9 +21485,9 @@ const orders = await orderService.getReadyToShip();`
         label: "Bad",
         language: "text",
         code: `modules/
-  orders/    → imports from users, payments, inventory, shipping
-  users/     → imports from orders, payments
-  payments/  → imports from orders, users
+  orders/    \u2192 imports from users, payments, inventory, shipping
+  users/     \u2192 imports from orders, payments
+  payments/  \u2192 imports from orders, users
   # Every module depends on every other module
   # Can't change anything without affecting everything`
       },
@@ -21494,9 +21495,9 @@ const orders = await orderService.getReadyToShip();`
         label: "Good",
         language: "text",
         code: `modules/
-  orders/    → depends on: users (read), emits: order.created
-  users/     → depends on: nothing, listens: order.created
-  payments/  → depends on: orders (read), emits: payment.completed
+  orders/    \u2192 depends on: users (read), emits: order.created
+  users/     \u2192 depends on: nothing, listens: order.created
+  payments/  \u2192 depends on: orders (read), emits: payment.completed
   # Clear dependency direction, minimal coupling`
       }
     ],
@@ -21513,7 +21514,7 @@ const orders = await orderService.getReadyToShip();`
     id: "anemic-module",
     name: "Anemic Module",
     category: "module-structure",
-    description: "A module with no real business logic — it's just a pass-through that delegates everything to another module or the database. If a module adds no value, it shouldn't exist.",
+    description: "A module with no real business logic \u2014 it's just a pass-through that delegates everything to another module or the database. If a module adds no value, it shouldn't exist.",
     examples: [
       {
         label: "Bad",
@@ -21548,7 +21549,7 @@ export class UserService {
       {
         principleId: "avoid-feature-envy",
         relationship: "extends",
-        note: "An anemic module envies no one — it has no behavior of its own"
+        note: "An anemic module envies no one \u2014 it has no behavior of its own"
       }
     ]
   },
@@ -21568,7 +21569,7 @@ export class ShippingService {
     const items = await orderService.getItems(orderId);
     const address = await orderService.getShippingAddress(orderId);
     const weight = await orderService.calculateWeight(orderId);
-    // All data comes from orders — does shipping add any value?
+    // All data comes from orders \u2014 does shipping add any value?
   }
 }`
       },
@@ -21610,8 +21611,8 @@ const rate = this.calculateRate(shippable.totalWeightGrams, shippable.destinatio
         language: "text",
         code: `Day 1 of project:
 "Let's create 12 modules based on our initial design"
-→ By month 2, half need to be merged or split
-→ Wasted effort on wrong boundaries`
+\u2192 By month 2, half need to be merged or split
+\u2192 Wasted effort on wrong boundaries`
       },
       {
         label: "Good",
@@ -21628,7 +21629,7 @@ const rate = this.calculateRate(shippable.totalWeightGrams, shippable.destinatio
       {
         principleId: "simple-design-minimal",
         relationship: "reinforces",
-        note: "Don't add structure you don't need yet — minimal classes, minimal modules"
+        note: "Don't add structure you don't need yet \u2014 minimal classes, minimal modules"
       }
     ]
   },
@@ -21719,7 +21720,7 @@ eventBus.emit("orders.order.created", {
 await userModule.init();      // Must be first
 await orderModule.init();     // Depends on users being ready
 await paymentModule.init();   // Depends on orders being ready
-// Swap the order → runtime crash`
+// Swap the order \u2192 runtime crash`
       },
       {
         label: "Good",
@@ -21807,10 +21808,10 @@ export { mapToDTO } from "./internal/mappers.js";
       {
         label: "Good",
         language: "typescript",
-        code: `// modules/orders/index.ts — Clean, consistent boundary
+        code: `// modules/orders/index.ts \u2014 Clean, consistent boundary
 export { orderService } from "./order.service.js";
 export type { OrderDTO, CreateOrderInput } from "./order.types.js";
-// Nothing else exported — boundary is clear and enforced`
+// Nothing else exported \u2014 boundary is clear and enforced`
       }
     ],
     tags: ["anti-pattern", "boundary", "inconsistent", "partial", "leaky"],
@@ -22011,7 +22012,7 @@ function formatRuleAsMarkdown(rule) {
 }
 function formatAntiPatternAsMarkdown(ap) {
   const lines = [
-    `## ⚠ Anti-Pattern: ${ap.name}`,
+    `## \u26A0 Anti-Pattern: ${ap.name}`,
     "",
     `**Category:** ${CATEGORY_LABELS[ap.category]}`,
     `**ID:** \`${ap.id}\``,
@@ -22046,7 +22047,7 @@ function formatExample(example) {
 }
 function formatCleanCodeRef(ref) {
   return [
-    `- **${ref.relationship}** \`${ref.principleId}\` — ${ref.note}`,
+    `- **${ref.relationship}** \`${ref.principleId}\` \u2014 ${ref.note}`,
     `  _Use: search-principle "${ref.principleId}" in clean-code-mcp_`
   ];
 }
@@ -22056,7 +22057,7 @@ function formatRuleList(rules) {
   }
   const lines = [`Found **${rules.length}** rule(s):`, ""];
   for (const rule of rules) {
-    lines.push(`- **${rule.name}** (\`${rule.id}\`) — ${truncateDescription(rule.description)}`);
+    lines.push(`- **${rule.name}** (\`${rule.id}\`) \u2014 ${truncateDescription(rule.description)}`);
   }
   return lines.join(`
 `);
@@ -22528,8 +22529,8 @@ function registerSearchByContextTool(server) {
   });
 }
 // src/modules/module-validation/validate-module.tool.ts
-import { readdir } from "node:fs/promises";
-import { basename } from "node:path";
+import { readdir } from "fs/promises";
+import { basename } from "path";
 var REQUIRED_FILES = [
   { pattern: ".service.", label: "Service (business logic)", rule: "standard-module-layout" },
   { pattern: ".types.", label: "Types (domain models)", rule: "standard-module-layout" },
@@ -22579,7 +22580,7 @@ Make sure the path exists and is accessible.`
       const icon = found ? "PASS" : "FAIL";
       if (found)
         requiredCount++;
-      lines.push(`- [${icon}] ${req.label} — rule: \`${req.rule}\``);
+      lines.push(`- [${icon}] ${req.label} \u2014 rule: \`${req.rule}\``);
     }
     let recommendedCount = 0;
     lines.push("", "## Recommended Files");
@@ -22588,7 +22589,7 @@ Make sure the path exists and is accessible.`
       const icon = found ? "PASS" : "MISSING";
       if (found)
         recommendedCount++;
-      lines.push(`- [${icon}] ${rec.label} — rule: \`${rec.rule}\``);
+      lines.push(`- [${icon}] ${rec.label} \u2014 rule: \`${rec.rule}\``);
     }
     const totalRequired = REQUIRED_FILES.length;
     const totalRecommended = RECOMMENDED_FILES.length;
@@ -22604,8 +22605,8 @@ Make sure the path exists and is accessible.`
   });
 }
 // src/modules/module-validation/check-imports.tool.ts
-import { readdir as readdir2, readFile } from "node:fs/promises";
-import { join, relative, dirname } from "node:path";
+import { readdir as readdir2, readFile } from "fs/promises";
+import { join, relative, dirname } from "path";
 async function walkDir(dir) {
   const files = [];
   const entries = await readdir2(dir, { withFileTypes: true });
@@ -22716,7 +22717,7 @@ Make sure the path exists and contains module directories.`
       resultLines.push(`## Result: ${violations.length} violation(s) found`, "", "The following imports bypass module boundaries by importing internal files directly:", "");
       const grouped = new Map;
       for (const v of violations) {
-        const key = `${v.sourceModule} → ${v.targetModule}`;
+        const key = `${v.sourceModule} \u2192 ${v.targetModule}`;
         const list = grouped.get(key) ?? [];
         list.push(v);
         grouped.set(key, list);
@@ -22753,18 +22754,18 @@ function generateModuleScaffold(moduleName) {
 ## Directory Structure
 \`\`\`
 modules/${moduleName}/
-  ${moduleName}.service.ts      — Business logic (rule: vertical-slice-per-module)
-  ${moduleName}.repository.ts   — Data access layer (rule: separate-module-data)
-  ${moduleName}.types.ts        — Domain types & interfaces (rule: dto-at-boundaries)
-  ${moduleName}.validation.ts   — Zod input schemas (rule: request-validation-at-edge)
-  ${moduleName}.routes.ts       — API route handlers (rule: thin-routes)
-  index.ts                      — Public API barrel (rule: define-public-api)
+  ${moduleName}.service.ts      \u2014 Business logic (rule: vertical-slice-per-module)
+  ${moduleName}.repository.ts   \u2014 Data access layer (rule: separate-module-data)
+  ${moduleName}.types.ts        \u2014 Domain types & interfaces (rule: dto-at-boundaries)
+  ${moduleName}.validation.ts   \u2014 Zod input schemas (rule: request-validation-at-edge)
+  ${moduleName}.routes.ts       \u2014 API route handlers (rule: thin-routes)
+  index.ts                      \u2014 Public API barrel (rule: define-public-api)
 \`\`\`
 
 ## File: index.ts (Public API)
 \`\`\`typescript
-// Rule: define-public-api — Only export what consumers need
-// Rule: hide-implementation-details — Internals stay private
+// Rule: define-public-api \u2014 Only export what consumers need
+// Rule: hide-implementation-details \u2014 Internals stay private
 export { ${moduleName.replace(/-/g, "")}Service } from "./${moduleName}.service.js";
 export type {
   ${pascal},
@@ -22775,7 +22776,7 @@ export type {
 
 ## File: ${moduleName}.types.ts
 \`\`\`typescript
-// Rule: dto-at-boundaries — Public types are DTOs, not internal models
+// Rule: dto-at-boundaries \u2014 Public types are DTOs, not internal models
 export interface ${pascal} {
   id: string;
   createdAt: string;
@@ -22793,8 +22794,8 @@ export interface Update${pascal}Input {
 
 ## File: ${moduleName}.service.ts
 \`\`\`typescript
-// Rule: vertical-slice-per-module — Service contains business logic
-// Rule: self-contained-initialization — Dependencies injected via constructor
+// Rule: vertical-slice-per-module \u2014 Service contains business logic
+// Rule: self-contained-initialization \u2014 Dependencies injected via constructor
 import type { ${pascal}, Create${pascal}Input } from "./${moduleName}.types.js";
 import type { ${pascal}Repository } from "./${moduleName}.repository.js";
 
@@ -22813,8 +22814,8 @@ export class ${pascal}Service {
 
 ## File: ${moduleName}.repository.ts
 \`\`\`typescript
-// Rule: separate-module-data — Only this module accesses its data
-// Rule: depend-on-abstractions — Export interface, not just implementation
+// Rule: separate-module-data \u2014 Only this module accesses its data
+// Rule: depend-on-abstractions \u2014 Export interface, not just implementation
 import type { ${pascal}, Create${pascal}Input } from "./${moduleName}.types.js";
 
 export interface ${pascal}Repository {
@@ -22825,7 +22826,7 @@ export interface ${pascal}Repository {
 
 ## File: ${moduleName}.validation.ts
 \`\`\`typescript
-// Rule: request-validation-at-edge — Validate at the API boundary
+// Rule: request-validation-at-edge \u2014 Validate at the API boundary
 import { z } from "zod";
 
 export const create${pascal}Schema = z.object({
@@ -22839,8 +22840,8 @@ export const update${pascal}Schema = z.object({
 
 ## File: ${moduleName}.routes.ts
 \`\`\`typescript
-// Rule: thin-routes — Validate, call service, respond
-// Rule: one-route-one-module — Routes belong to this module only
+// Rule: thin-routes \u2014 Validate, call service, respond
+// Rule: one-route-one-module \u2014 Routes belong to this module only
 import { ${moduleName.replace(/-/g, "")}Service } from "./index.js";
 import { create${pascal}Schema } from "./${moduleName}.validation.js";
 
@@ -22864,9 +22865,9 @@ import { create${pascal}Schema } from "./${moduleName}.validation.js";
 function generateService(moduleName) {
   const pascal = toPascalCase(moduleName);
   return `// ${moduleName}.service.ts
-// Rule: vertical-slice-per-module — Service contains all business logic for this module
-// Rule: self-contained-initialization — Dependencies injected via constructor
-// Rule: depend-on-abstractions — Depends on repository interface, not implementation
+// Rule: vertical-slice-per-module \u2014 Service contains all business logic for this module
+// Rule: self-contained-initialization \u2014 Dependencies injected via constructor
+// Rule: depend-on-abstractions \u2014 Depends on repository interface, not implementation
 
 import type { ${pascal}, Create${pascal}Input, Update${pascal}Input } from "./${moduleName}.types.js";
 import type { ${pascal}Repository } from "./${moduleName}.repository.js";
@@ -22911,13 +22912,13 @@ export class ${pascal}Service {
 function generateRepository(moduleName) {
   const pascal = toPascalCase(moduleName);
   return `// ${moduleName}.repository.ts
-// Rule: separate-module-data — Only this module accesses its own data
-// Rule: depend-on-abstractions — Export interface for DI and testing
-// Rule: data-ownership-principle — This module owns the lifecycle of its data
+// Rule: separate-module-data \u2014 Only this module accesses its own data
+// Rule: depend-on-abstractions \u2014 Export interface for DI and testing
+// Rule: data-ownership-principle \u2014 This module owns the lifecycle of its data
 
 import type { ${pascal}, Create${pascal}Input, Update${pascal}Input } from "./${moduleName}.types.js";
 
-// Interface — used by service via dependency injection
+// Interface \u2014 used by service via dependency injection
 export interface ${pascal}Repository {
   findById(id: string): Promise<${pascal} | null>;
   findAll(): Promise<${pascal}[]>;
@@ -22926,8 +22927,8 @@ export interface ${pascal}Repository {
   delete(id: string): Promise<void>;
 }
 
-// Implementation — Prisma example (swap for any data source)
-// Rule: hide-implementation-details — Implementation is internal to this module
+// Implementation \u2014 Prisma example (swap for any data source)
+// Rule: hide-implementation-details \u2014 Implementation is internal to this module
 export class Prisma${pascal}Repository implements ${pascal}Repository {
   constructor(private readonly prisma: any) {}
 
@@ -22958,10 +22959,10 @@ export class Prisma${pascal}Repository implements ${pascal}Repository {
 function generateTypes(moduleName) {
   const pascal = toPascalCase(moduleName);
   return `// ${moduleName}.types.ts
-// Rule: dto-at-boundaries — These types are the module's public contract
-// Rule: stable-contracts — Changes here affect consumers; use additive changes
+// Rule: dto-at-boundaries \u2014 These types are the module's public contract
+// Rule: stable-contracts \u2014 Changes here affect consumers; use additive changes
 
-// Main entity DTO — returned by the module's public API
+// Main entity DTO \u2014 returned by the module's public API
 export interface ${pascal} {
   id: string;
   // Add domain-specific fields here
@@ -22972,17 +22973,17 @@ export interface ${pascal} {
 // Input for creating a new entity
 export interface Create${pascal}Input {
   // Add required fields for creation
-  // Rule: Do NOT include id, createdAt, updatedAt — those are generated
+  // Rule: Do NOT include id, createdAt, updatedAt \u2014 those are generated
 }
 
 // Input for updating an existing entity
 export interface Update${pascal}Input {
-  // All fields optional — partial updates
-  // Rule: stable-contracts — New optional fields are backwards-compatible
+  // All fields optional \u2014 partial updates
+  // Rule: stable-contracts \u2014 New optional fields are backwards-compatible
 }
 
-// Lightweight reference type — for cross-module communication
-// Rule: anti-corruption-layer — Other modules use this, not the full entity
+// Lightweight reference type \u2014 for cross-module communication
+// Rule: anti-corruption-layer \u2014 Other modules use this, not the full entity
 export interface ${pascal}Reference {
   id: string;
   // Include only the minimal fields other modules need
@@ -22994,8 +22995,8 @@ export interface ${pascal}Reference {
 function generateValidation(moduleName) {
   const pascal = toPascalCase(moduleName);
   return `// ${moduleName}.validation.ts
-// Rule: request-validation-at-edge — Validate input at the API boundary
-// Rule: one-route-one-module — Validation schemas belong to the module
+// Rule: request-validation-at-edge \u2014 Validate input at the API boundary
+// Rule: one-route-one-module \u2014 Validation schemas belong to the module
 
 import { z } from "zod";
 
@@ -23022,7 +23023,7 @@ export const query${pascal}Schema = z.object({
   // Add module-specific filters
 });
 
-// Infer types from schemas — keeps validation and types in sync
+// Infer types from schemas \u2014 keeps validation and types in sync
 export type Create${pascal}Validated = z.infer<typeof create${pascal}Schema>;
 export type Update${pascal}Validated = z.infer<typeof update${pascal}Schema>;
 export type Query${pascal}Params = z.infer<typeof query${pascal}Schema>;
@@ -23033,10 +23034,10 @@ export type Query${pascal}Params = z.infer<typeof query${pascal}Schema>;
 function generatePublicApi(moduleName) {
   const pascal = toPascalCase(moduleName);
   const camel = toCamelCase(moduleName);
-  return `// index.ts — Public API for the ${moduleName} module
-// Rule: define-public-api — This file IS the module's contract
-// Rule: hide-implementation-details — Only re-export what consumers need
-// Rule: self-contained-initialization — Compose and export ready-to-use instances
+  return `// index.ts \u2014 Public API for the ${moduleName} module
+// Rule: define-public-api \u2014 This file IS the module's contract
+// Rule: hide-implementation-details \u2014 Only re-export what consumers need
+// Rule: self-contained-initialization \u2014 Compose and export ready-to-use instances
 
 import { ${pascal}Service } from "./${moduleName}.service.js";
 import { Prisma${pascal}Repository } from "./${moduleName}.repository.js";
@@ -23049,7 +23050,7 @@ import { Prisma${pascal}Repository } from "./${moduleName}.repository.js";
 // export const ${camel}Service = new ${pascal}Service(repository);
 
 // --- Public Types (the contract) ---
-// Rule: dto-at-boundaries — Export only DTOs, never internal models
+// Rule: dto-at-boundaries \u2014 Export only DTOs, never internal models
 export type {
   ${pascal},
   Create${pascal}Input,
@@ -23073,9 +23074,9 @@ function generateRouteHandler(moduleName) {
   const camel = toCamelCase(moduleName);
   const urlPath = moduleName;
   return `// ${moduleName}.routes.ts
-// Rule: thin-routes — Validate input, call service, return response
-// Rule: one-route-one-module — These routes belong exclusively to the ${moduleName} module
-// Rule: request-validation-at-edge — Zod validation happens here, not in service
+// Rule: thin-routes \u2014 Validate input, call service, return response
+// Rule: one-route-one-module \u2014 These routes belong exclusively to the ${moduleName} module
+// Rule: request-validation-at-edge \u2014 Zod validation happens here, not in service
 
 import { ${camel}Service } from "./index.js";
 import {
@@ -23142,9 +23143,9 @@ export async function delete${pascal}(req: any, res: any) {
 function generateIntegrationClient(moduleName) {
   const pascal = toPascalCase(moduleName);
   return `// ${moduleName}-client.ts
-// Rule: dedicated-client-wrapper — Dedicated wrapper for the ${moduleName} external API
-// Rule: isolated-integration-module — External API details stay within this module
-// Rule: integration-change-isolation — Switching providers only affects this file
+// Rule: dedicated-client-wrapper \u2014 Dedicated wrapper for the ${moduleName} external API
+// Rule: isolated-integration-module \u2014 External API details stay within this module
+// Rule: integration-change-isolation \u2014 Switching providers only affects this file
 
 // --- Internal types (what YOUR code uses) ---
 export interface ${pascal}Request {
@@ -23167,7 +23168,7 @@ export class ${pascal}Client {
   }
 
   async execute(request: ${pascal}Request): Promise<${pascal}Response> {
-    // Rule: anti-corruption-layer — Translate internal model to external format
+    // Rule: anti-corruption-layer \u2014 Translate internal model to external format
     const externalPayload = this.toExternalFormat(request);
 
     const response = await fetch(\`\${this.baseUrl}/endpoint\`, {
@@ -23186,7 +23187,7 @@ export class ${pascal}Client {
     }
 
     const externalResponse = await response.json();
-    // Rule: anti-corruption-layer — Translate external response to internal model
+    // Rule: anti-corruption-layer \u2014 Translate external response to internal model
     return this.toInternalFormat(externalResponse);
   }
 
@@ -23389,7 +23390,7 @@ Please help design this module by addressing:
 - What events should this module listen to?
 
 ### 5. Dependencies
-- Map the dependency graph — which modules does this one depend on?
+- Map the dependency graph \u2014 which modules does this one depend on?
 - Ensure no circular dependencies (rule: \`acyclic-dependency-graph\`)
 - Ensure dependency direction flows correctly (rule: \`dependency-direction\`)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leonardocrdso/modular-monolith-mcp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "MCP server with architectural rules for Modular Monolith — module boundaries, communication patterns, and structural validation",
   "type": "module",
   "main": "build/index.js",
@@ -15,7 +15,7 @@
   "scripts": {
     "dev": "bun run --watch src/index.ts",
     "start": "bun run src/index.ts",
-    "build": "bun build src/index.ts --outdir build --target node",
+    "build": "bun build src/index.ts --outdir build --target bun",
     "prepublishOnly": "bun run build"
   },
   "dependencies": {