@mandujs/mcp 0.38.12 → 0.39.0-beta.1

package/src/logging/mcp-transport.ts

@@ -1,134 +1,134 @@
-/**
- * MCP LogTransport Integration
- *
- * DNA-008 로깅 시스템과 MCP ActivityMonitor 통합
- */
-
-import {
-  attachLogTransport,
-  detachLogTransport,
-  type LogTransport,
-  type LogTransportRecord,
-} from "@mandujs/core";
-import { monitorEventToRecord, type MonitorEvent } from "../adapters/monitor-adapter.js";
-
-/**
- * MCP 로깅 Transport ID
- */
-export const MCP_TRANSPORT_ID = "mcp-activity";
-
-/**
- * MCP Activity Transport 옵션
- */
-export interface McpTransportOptions {
-  /** 로그 파일 경로 (선택) */
-  logFile?: string;
-  /** 콘솔 출력 여부 */
-  consoleOutput?: boolean;
-  /** 커스텀 핸들러 */
-  onRecord?: (record: LogTransportRecord) => void;
-}
-
-/**
- * MCP Activity Transport 생성
- *
- * ActivityMonitor의 이벤트를 DNA-008 TransportRegistry로 전달
- */
-export function createMcpActivityTransport(
-  options: McpTransportOptions = {}
-): LogTransport {
-  const { consoleOutput = false, onRecord } = options;
-
-  return (record: LogTransportRecord) => {
-    // MCP 관련 로그만 처리
-    const source = record.meta?.source;
-    if (source !== "mcp" && source !== "tool" && source !== "watch") {
-      return;
-    }
-
-    // 커스텀 핸들러
-    if (onRecord) {
-      onRecord(record);
-    }
-
-    // 콘솔 출력
-    if (consoleOutput) {
-      const prefix = `[MCP:${source}]`;
-      const msg = record.error?.message || (record.meta?.message as string) || "";
-
-      switch (record.level) {
-        case "error":
-          console.error(prefix, msg, record.meta);
-          break;
-        case "warn":
-          console.warn(prefix, msg, record.meta);
-          break;
-        default:
-          console.log(prefix, msg, record.meta);
-      }
-    }
-  };
-}
-
-/**
- * MCP 로깅 설정
- *
- * @example
- * ```ts
- * setupMcpLogging({
- *   consoleOutput: true,
- *   onRecord: (record) => {
- *     // 커스텀 처리
- *   },
- * });
- * ```
- */
-export function setupMcpLogging(options: McpTransportOptions = {}): void {
-  const transport = createMcpActivityTransport(options);
-  attachLogTransport(MCP_TRANSPORT_ID, transport, { minLevel: "info" });
-}
-
-/**
- * MCP 로깅 해제
- */
-export function teardownMcpLogging(): void {
-  detachLogTransport(MCP_TRANSPORT_ID);
-}
-
-/**
- * MonitorEvent를 DNA-008 시스템으로 전송
- *
- * ActivityMonitor에서 이 함수를 호출하여 로그 통합
- */
-export function dispatchMonitorEvent(event: MonitorEvent): void {
-  const _record = monitorEventToRecord(event);
-
-  // 직접 transport로 전달하지 않고,
-  // 다른 transport들도 받을 수 있도록 registry를 통해 dispatch
-  // (transportRegistry.dispatch는 core에서 export 필요)
-
-  // 임시: 콘솔 출력
-  if (event.severity === "error") {
-    console.error(`[MCP:${event.source}] ${event.message || event.type}`, event.data);
-  }
-}
-
-/**
- * MCP 로그 레코드 생성 헬퍼
- */
-export function createMcpLogRecord(
-  level: "debug" | "info" | "warn" | "error",
-  source: "mcp" | "tool" | "watch",
-  message: string,
-  data?: Record<string, unknown>
-): LogTransportRecord {
-  return {
-    timestamp: new Date().toISOString(),
-    level,
-    meta: {
-      source,
-      message,
-      ...data,
-    },
-  };
-}
+/**
+ * MCP LogTransport Integration
+ *
+ * DNA-008 로깅 시스템과 MCP ActivityMonitor 통합
+ */
+
+import {
+  attachLogTransport,
+  detachLogTransport,
+  type LogTransport,
+  type LogTransportRecord,
+} from "@mandujs/core/compat/logging/index";
+import { monitorEventToRecord, type MonitorEvent } from "../adapters/monitor-adapter.js";
+
+/**
+ * MCP 로깅 Transport ID
+ */
+export const MCP_TRANSPORT_ID = "mcp-activity";
+
+/**
+ * MCP Activity Transport 옵션
+ */
+export interface McpTransportOptions {
+  /** 로그 파일 경로 (선택) */
+  logFile?: string;
+  /** 콘솔 출력 여부 */
+  consoleOutput?: boolean;
+  /** 커스텀 핸들러 */
+  onRecord?: (record: LogTransportRecord) => void;
+}
+
+/**
+ * MCP Activity Transport 생성
+ *
+ * ActivityMonitor의 이벤트를 DNA-008 TransportRegistry로 전달
+ */
+export function createMcpActivityTransport(
+  options: McpTransportOptions = {}
+): LogTransport {
+  const { consoleOutput = false, onRecord } = options;
+
+  return (record: LogTransportRecord) => {
+    // MCP 관련 로그만 처리
+    const source = record.meta?.source;
+    if (source !== "mcp" && source !== "tool" && source !== "watch") {
+      return;
+    }
+
+    // 커스텀 핸들러
+    if (onRecord) {
+      onRecord(record);
+    }
+
+    // 콘솔 출력
+    if (consoleOutput) {
+      const prefix = `[MCP:${source}]`;
+      const msg = record.error?.message || (record.meta?.message as string) || "";
+
+      switch (record.level) {
+        case "error":
+          console.error(prefix, msg, record.meta);
+          break;
+        case "warn":
+          console.warn(prefix, msg, record.meta);
+          break;
+        default:
+          console.log(prefix, msg, record.meta);
+      }
+    }
+  };
+}
+
+/**
+ * MCP 로깅 설정
+ *
+ * @example
+ * ```ts
+ * setupMcpLogging({
+ *   consoleOutput: true,
+ *   onRecord: (record) => {
+ *     // 커스텀 처리
+ *   },
+ * });
+ * ```
+ */
+export function setupMcpLogging(options: McpTransportOptions = {}): void {
+  const transport = createMcpActivityTransport(options);
+  attachLogTransport(MCP_TRANSPORT_ID, transport, { minLevel: "info" });
+}
+
+/**
+ * MCP 로깅 해제
+ */
+export function teardownMcpLogging(): void {
+  detachLogTransport(MCP_TRANSPORT_ID);
+}
+
+/**
+ * MonitorEvent를 DNA-008 시스템으로 전송
+ *
+ * ActivityMonitor에서 이 함수를 호출하여 로그 통합
+ */
+export function dispatchMonitorEvent(event: MonitorEvent): void {
+  const _record = monitorEventToRecord(event);
+
+  // 직접 transport로 전달하지 않고,
+  // 다른 transport들도 받을 수 있도록 registry를 통해 dispatch
+  // (transportRegistry.dispatch는 core에서 export 필요)
+
+  // 임시: 콘솔 출력
+  if (event.severity === "error") {
+    console.error(`[MCP:${event.source}] ${event.message || event.type}`, event.data);
+  }
+}
+
+/**
+ * MCP 로그 레코드 생성 헬퍼
+ */
+export function createMcpLogRecord(
+  level: "debug" | "info" | "warn" | "error",
+  source: "mcp" | "tool" | "watch",
+  message: string,
+  data?: Record<string, unknown>
+): LogTransportRecord {
+  return {
+    timestamp: new Date().toISOString(),
+    level,
+    meta: {
+      source,
+      message,
+      ...data,
+    },
+  };
+}

package/src/new-resources.ts

@@ -8,8 +8,8 @@ import type { Resource } from "@modelcontextprotocol/sdk/types.js";
 import path from "path";
 import { readConfig, readJsonFile } from "./utils/project.js";
 import { loadManduConfig, loadManifest } from "@mandujs/core";
-import { eventBus } from "@mandujs/core/observability";
-import { computeAgentStats } from "@mandujs/core/kitchen";
+import { eventBus } from "@mandujs/core/compat/observability/index";
+import { computeAgentStats } from "@mandujs/core/compat/kitchen/index";
 import { getDevServerState } from "./tools/project.js";
 
 export const manduResourceDefinitions: Resource[] = [

package/src/profiles.ts

@@ -3,42 +3,15 @@
  *
  * Controls how many tool categories are exposed to AI agents.
  * - agent-core: Canonical agent workflow plus docs grounding (default)
- * - agent-full: Agent workflow plus Mandu domain tools
+ * - agent-full: Deprecated compatibility alias of agent-core
  * - internal: All categories, no filtering
  */
 
 export type McpProfile = "agent-core" | "agent-full" | "internal";
 
 export const PROFILE_CATEGORIES: Record<McpProfile, string[] | null> = {
-  "agent-core": ["agent", "docs"],
-  "agent-full": [
-    // Official agent loop
-    "agent",
-    "docs",
-    // Code generation / scaffolding
-    "spec",
-    "generate",
-    "composite",
-    // Domain primitives
-    "slot",
-    "slot-validation",
-    "hydration",
-    "contract",
-    "design",
-    "seo",
-    // Quality / validation
-    "guard",
-    "lint",
-    "run-tests",
-    "ate",
-    // Deploy
-    "deploy-plan",
-    "deploy-preview",
-    // AI refactor
-    "refactor-barrel",
-    "refactor-routes",
-    "refactor-contract",
-  ],
+  "agent-core": ["agent", "docs"],
+  "agent-full": ["agent", "docs"],
   internal: null,
 };
 
@@ -53,8 +26,24 @@ export const PROFILE_CATEGORIES: Record<McpProfile, string[] | null> = {
  * `profile-coverage.test.ts` fails CI if a new category is left unclassified,
  * preventing silent default-profile bloat over time.
  */
-export const EXPERT_ONLY_CATEGORIES: ReadonlySet<string> = new Set([
-  // Transactional state / framework internals
+export const EXPERT_ONLY_CATEGORIES: ReadonlySet<string> = new Set([
+  // Low-level action handlers. Agent-facing clients use mandu.agent.*.
+  "spec",
+  "generate",
+  "composite",
+  "slot",
+  "slot-validation",
+  "hydration",
+  "contract",
+  "design",
+  "seo",
+  "guard",
+  "lint",
+  "run-tests",
+  "refactor-barrel",
+  "refactor-routes",
+  "refactor-contract",
+  // Transactional state / framework internals
   "transaction",
   "history",
   "decisions",
@@ -66,28 +55,10 @@ export const EXPERT_ONLY_CATEGORIES: ReadonlySet<string> = new Set([
   "resource",
   // Devtools / kitchen
   "kitchen",
-  "component",
-  // Agent loop internal helpers (used by mandu.agent.*, not by agents directly)
-  "ai-brief",
-  "loop-close",
-  // Specialized ATE phases (core "ate" is exposed in agent-full)
-  "ate-phase5",
-  "ate-context",
-  "ate-run",
-  "ate-flakes",
-  "ate-prompt",
-  "ate-exemplar",
-  "ate-save",
-  "ate-boundary-probe",
-  "ate-recall",
-  "ate-remember",
-  "ate-coverage",
-  "ate-mutate",
-  "ate-mutation-report",
-  "ate-oracle-pending",
-  "ate-oracle-verdict",
-  "ate-oracle-replay",
-]);
+  "component",
+  // Agent loop internal helpers (used by mandu.agent.*, not by agents directly)
+  "ai-brief",
+]);
 
 /**
  * Returns allowed category names for a profile, or null if all categories are allowed.

package/src/prompts.ts

@@ -48,10 +48,10 @@ Follow these steps using Mandu MCP tools:
 1. Read current route manifest: Resource mandu://routes
 2. Read project config: Resource mandu://config
 3. Negotiate the feature spec: Tool mandu.negotiate
-4. Generate scaffold: Tool mandu.negotiate.scaffold
-5. If client interactivity needed, create island: Tool mandu_create_island
-   Use @mandujs/core/client with wrapComponent(Component) or island({ setup, render })
-6. If data requirements exist, create slot: Tool mandu_create_slot
+4. Generate scaffold: Tool mandu.negotiate.scaffold
+5. If client interactivity needed, create island: Tool mandu_create_island
+   Use @mandujs/core/client with wrapComponent(Component) or island({ setup, render })
+6. If data requirements exist, create slot: Tool mandu_create_slot
    Slots are server-side data loaders that run before render
 7. If API is exposed, define contract: Tool mandu_create_contract
    Contracts are Zod schemas for validation and OpenAPI generation

package/src/registry/index.ts

@@ -1,13 +1,13 @@
-/**
- * MCP Registry
- *
- * 도구 레지스트리 및 관련 유틸리티
- */
-
-export {
-  McpToolRegistry,
-  mcpToolRegistry,
-  type ToolRegistration,
-  type RegistryEvent,
-  type RegistryDump,
-} from "./mcp-tool-registry.js";
+/**
+ * MCP Registry
+ *
+ * 도구 레지스트리 및 관련 유틸리티
+ */
+
+export {
+  McpToolRegistry,
+  mcpToolRegistry,
+  type ToolRegistration,
+  type RegistryEvent,
+  type RegistryDump,
+} from "./mcp-tool-registry.js";