@mandujs/core 0.52.0 → 0.53.1

package/src/devtools/worker/redaction-worker.ts

@@ -6,7 +6,7 @@
  * Prevents main thread blocking during large payload processing
  */
 
-import type { RedactPattern, WorkerTask } from '../types';
+import type { RedactPattern } from '../types';
 
 // ============================================================================
 // Worker Message Types
@@ -206,14 +206,18 @@ function handleMessage(request: WorkerRequest): WorkerResponse {
 // Worker 컨텍스트에서만 실행
 interface WorkerSelf {
   postMessage: (message: WorkerResponse) => void;
-  onmessage: ((event: MessageEvent<WorkerRequest>) => void) | null;
+  addEventListener: (
+    type: 'message',
+    listener: (event: MessageEvent<WorkerRequest>) => void
+  ) => void;
 }
 const workerSelf = typeof self !== 'undefined' ? (self as unknown as WorkerSelf) : undefined;
 if (workerSelf && typeof workerSelf.postMessage === 'function') {
-  workerSelf.onmessage = (event: MessageEvent<WorkerRequest>) => {
+  workerSelf.addEventListener('message', (event: MessageEvent<WorkerRequest>) => {
     const response = handleMessage(event.data);
+    // oxlint-disable-next-line require-post-message-target-origin -- Worker.postMessage has no targetOrigin parameter.
     workerSelf.postMessage(response);
-  };
+  });
 }
 
 // ============================================================================

package/src/devtools/worker/worker-manager.ts

@@ -88,8 +88,8 @@ export class WorkerManager {
       }
 
       // 메시지 핸들러 설정
-      this.worker.onmessage = this.handleWorkerMessage.bind(this);
-      this.worker.onerror = this.handleWorkerError.bind(this);
+      this.worker.addEventListener('message', this.handleWorkerMessage.bind(this));
+      this.worker.addEventListener('error', this.handleWorkerError.bind(this));
 
       // Ping 테스트
       const pingResult = await this.sendRequest({ type: 'ping', data: {} });
@@ -117,7 +117,7 @@ export class WorkerManager {
     }
 
     // 대기 중인 요청 모두 reject
-    for (const [id, pending] of this.pendingRequests) {
+    for (const [, pending] of this.pendingRequests) {
       clearTimeout(pending.timeout);
       pending.reject(new Error('Worker terminated'));
     }
@@ -323,6 +323,7 @@ export class WorkerManager {
 
       this.pendingRequests.set(id, { resolve, reject, timeout });
 
+      // oxlint-disable-next-line require-post-message-target-origin -- Worker.postMessage has no targetOrigin parameter.
       this.worker!.postMessage({ id, ...request });
     });
   }

package/src/error/classifier.ts

@@ -54,7 +54,7 @@ export class ErrorClassifier {
   /**
    * ValidationError 처리
    */
-  private createValidationError(error: { errors: unknown[] }): ManduError {
+  private createValidationError(_error: { errors: unknown[] }): ManduError {
     const slotFile = this.findSlotFile();
 
     return {

package/src/error/domains.ts

@@ -5,7 +5,7 @@
  * try-catch에서 instanceof 체크 가능.
  */
 
-import { ErrorCode, ERROR_MESSAGES, ERROR_SUMMARIES } from "./types";
+import { ErrorCode, ERROR_SUMMARIES } from "./types";
 import type { ManduError, RouteContext, ErrorType } from "./types";
 
 /**

package/src/filling/sse.ts

@@ -45,11 +45,11 @@ export class SSEConnection {
           controller.enqueue(this.encoder.encode(chunk));
         }
         this.pending = [];
-      },
-      cancel: () => {
-        this.close();
-      },
-    });
+      },
+      cancel: () => {
+        void this.close();
+      },
+    });
 
     const headers = new Headers(DEFAULT_SSE_HEADERS);
     if (options.headers) {

package/src/generator/generate.ts

@@ -1,4 +1,4 @@
-import type { RoutesManifest, RouteSpec } from "../spec/schema";
+import type { RoutesManifest } from "../spec/schema";
 import { generateApiHandler, generatePageComponent, generateSlotLogic } from "./templates";
 import { generateContractTypeGlue, generateContractTemplate, generateContractTypesIndex } from "./contract-glue";
 import { createHash } from "crypto";
@@ -102,7 +102,7 @@ export interface GeneratedMap {
 async function ensureDir(dirPath: string): Promise<void> {
   try {
     await fs.mkdir(dirPath, { recursive: true });
-  } catch (error) {
+  } catch  {
     // ignore if exists
   }
 }

package/src/guard/analyzer.ts

@@ -63,7 +63,7 @@ const DEFAULT_IMPORT_PATTERN = /^import\s+(\w+)/;
  */
 export function extractImports(content: string): ImportInfo[] {
   const imports: ImportInfo[] = [];
-  const lines = content.split("\n");
+  const _lines = content.split("\n");
 
   // Static imports
   let match: RegExpExecArray | null;

package/src/guard/ast-analyzer.ts

@@ -382,14 +382,14 @@ export function extractImportsAST(content: string): ImportInfo[] {
 
       let namedImports: string[] | undefined;
       let defaultImport: string | undefined;
-      let namespaceImport: string | undefined;
-      let isTypeOnly = false;
+      let _namespaceImport: string | undefined;
+      let _isTypeOnly = false;
 
       // Check for type-only import
       if (is("keyword", "type")) {
         consume("keyword", "type");
         skip();
-        isTypeOnly = true;
+        _isTypeOnly = true;
       }
 
       // Side-effect import: import '...'
@@ -427,7 +427,7 @@ export function extractImportsAST(content: string): ImportInfo[] {
           consume("keyword", "as");
           skip();
           if (is("identifier")) {
-            namespaceImport = consume("identifier")!.value;
+            _namespaceImport = consume("identifier")!.value;
             skip();
           }
         }
@@ -777,7 +777,7 @@ export interface ModuleAnalysis {
   /** Public API 여부 (index 파일) */
   isPublicAPI: boolean;
   /** 순수 타입 모듈 여부 */
-  isTypeOnly: boolean;
+  _isTypeOnly: boolean;
 }
 
 /**
@@ -795,12 +795,12 @@ export function analyzeModuleAST(content: string, filePath: string): ModuleAnaly
   // 타입만 있는 모듈인지 확인
   const hasRuntimeExport = exports.some((e) => e.type !== "type");
   const hasRuntimeImport = imports.some((i) => !i.statement.includes("import type"));
-  const isTypeOnly = !hasRuntimeExport && !hasRuntimeImport && exports.length > 0;
+  const _isTypeOnly = !hasRuntimeExport && !hasRuntimeImport && exports.length > 0;
 
   return {
     imports,
     exports,
     isPublicAPI,
-    isTypeOnly,
+    _isTypeOnly,
   };
 }

package/src/guard/auto-correct.ts

@@ -4,7 +4,7 @@ import { GUARD_RULES } from "./rules";
 import { runGuardCheck } from "./check";
 import { generateRoutes } from "../generator/generate";
 import { beginChange, commitChange, rollbackChange } from "../change";
-import path from "path";
+
 
 export interface AutoCorrectStep {
   ruleId: string;
@@ -51,7 +51,7 @@ export async function runAutoCorrect(
       message: `Auto-correct: ${violations.length} violations`,
       autoGenerated: true,
     });
-  } catch (error) {
+  } catch  {
     // 이미 활성 트랜잭션이 있는 경우 그대로 진행 (사용자가 수동으로 시작한 경우)
     // 다른 오류는 트랜잭션 없이 진행
   }

package/src/guard/config-guard.ts

@@ -12,8 +12,6 @@ import {
   validateLockfile,
   validateWithPolicy,
   detectMode,
-  type ManduLockfile,
-  type LockfileValidationResult,
   type LockfileMode,
 } from "../lockfile";
 import type { ConfigDiff } from "../utils/differ";

package/src/guard/contract-guard.ts

@@ -79,7 +79,7 @@ export interface ContractViolation extends GuardViolation {
  */
 export async function checkMissingContract(
   manifest: RoutesManifest,
-  rootDir: string
+  _rootDir: string
 ): Promise<ContractViolation[]> {
   const violations: ContractViolation[] = [];
 

package/src/guard/decision-memory.ts

@@ -25,8 +25,8 @@
  * ```
  */
 
-import { join, basename, extname } from "path";
-import { mkdir, readdir, readFile, writeFile, stat } from "fs/promises";
+import { join, extname } from "path";
+import { mkdir, readdir, readFile, writeFile } from "fs/promises";
 
 // ═══════════════════════════════════════════════════════════════════════════
 // Types

package/src/guard/design-inline-class.ts

@@ -1,3 +1,4 @@
+import type * as __ManduNodeFsTypes0 from "node:fs";
 /**
  * Guard rule — `DESIGN_INLINE_CLASS` (Issue #245).
  *
@@ -92,7 +93,7 @@ async function pathExists(p: string): Promise<boolean> {
 }
 
 async function* walk(rootDir: string): AsyncIterable<string> {
-  let entries: import("node:fs").Dirent[];
+  let entries: __ManduNodeFsTypes0.Dirent[];
   try {
     entries = await fs.readdir(rootDir, { withFileTypes: true });
   } catch {

package/src/guard/graph.ts

@@ -34,7 +34,7 @@
 
 import { existsSync } from "fs";
 import { relative, resolve, sep, isAbsolute, dirname, extname } from "path";
-import { minimatch } from "minimatch";
+
 import type {
   GuardConfig,
   LayerDefinition,

package/src/guard/healing.ts

@@ -22,18 +22,16 @@
  * ```
  */
 
-import { readFile, writeFile, mkdir, rename, unlink } from "fs/promises";
-import { existsSync } from "fs";
-import { dirname, join, relative, basename, extname, resolve, normalize } from "path";
-import type {
-  Violation,
-  ViolationType,
-  GuardConfig,
-  GuardPreset,
-  LayerDefinition,
-  ViolationReport,
-} from "./types";
-import { generateSmartSuggestions, getDocumentationLink } from "./suggestions";
+import { readFile, writeFile, mkdir, unlink } from "fs/promises";
+import { existsSync } from "fs";
+import { dirname, join, extname, resolve, normalize } from "path";
+import type {
+  Violation,
+  ViolationType,
+  GuardConfig,
+  GuardPreset,
+} from "./types";
+import { getDocumentationLink } from "./suggestions";
 import { checkDirectory } from "./watcher";
 
 // ═══════════════════════════════════════════════════════════════════════════
@@ -326,14 +324,13 @@ function generateHealingOptions(
 /**
  * 레이어 위반 옵션 생성
  */
-function generateLayerViolationOptions(
-  violation: Violation,
-  config: GuardConfig,
-  rootDir: string
-): HealingOption[] {
-  const options: HealingOption[] = [];
-  const { filePath, importPath, importStatement, fromLayer, toLayer, allowedLayers } =
-    violation;
+function generateLayerViolationOptions(
+  violation: Violation,
+  _config: GuardConfig,
+  rootDir: string
+): HealingOption[] {
+  const options: HealingOption[] = [];
+  const { filePath, importPath, importStatement, toLayer, allowedLayers } = violation;
 
   const targetModule = extractModuleName(importPath);
 
@@ -409,17 +406,15 @@ function generateLayerViolationOptions(
 /**
  * 순환 의존 옵션 생성
  */
-function generateCircularDependencyOptions(
-  violation: Violation,
-  config: GuardConfig,
-  rootDir: string
-): HealingOption[] {
-  const options: HealingOption[] = [];
-  const { fromLayer, toLayer, importPath } = violation;
-
-  const targetModule = extractModuleName(importPath);
-
-  // 옵션 1: 공통 코드를 shared로 추출
+function generateCircularDependencyOptions(
+  violation: Violation,
+  _config: GuardConfig,
+  _rootDir: string
+): HealingOption[] {
+  const options: HealingOption[] = [];
+  const { fromLayer, toLayer } = violation;
+
+  // 옵션 1: 공통 코드를 shared로 추출
   options.push({
     label: "공통 코드를 shared로 추출",
     explanation: `${fromLayer}와 ${toLayer}가 공유하는 코드를 shared 레이어로 이동하세요.`,
@@ -446,11 +441,11 @@ function generateCircularDependencyOptions(
 /**
  * Cross-slice 옵션 생성
  */
-function generateCrossSliceOptions(
-  violation: Violation,
-  config: GuardConfig,
-  rootDir: string
-): HealingOption[] {
+function generateCrossSliceOptions(
+  violation: Violation,
+  _config: GuardConfig,
+  _rootDir: string
+): HealingOption[] {
   const options: HealingOption[] = [];
   const { fromLayer, importPath } = violation;
 
@@ -483,11 +478,11 @@ function generateCrossSliceOptions(
 /**
  * 깊은 중첩 옵션 생성
  */
-function generateDeepNestingOptions(
-  violation: Violation,
-  config: GuardConfig,
-  rootDir: string
-): HealingOption[] {
+function generateDeepNestingOptions(
+  violation: Violation,
+  _config: GuardConfig,
+  _rootDir: string
+): HealingOption[] {
   const options: HealingOption[] = [];
   const { filePath, importPath, importStatement } = violation;
 

package/src/guard/negotiation.ts

@@ -23,7 +23,7 @@
 
 import { join, dirname } from "path";
 import { mkdir, writeFile, readdir, stat } from "fs/promises";
-import { searchDecisions, type ArchitectureDecision } from "./decision-memory";
+import { searchDecisions } from "./decision-memory";
 import { getPreset, type GuardPreset, type PresetDefinition } from "./presets";
 
 // ═══════════════════════════════════════════════════════════════════════════
@@ -1176,10 +1176,10 @@ export async function negotiate(
 ): Promise<NegotiationResponse> {
   const {
     intent,
-    requirements = [],
+    requirements: _requirements = [],
     constraints = [],
     preset = "mandu",
-    context,
+    context: _context,
   } = request;
 
   // 1. 카테고리 감지

package/src/guard/reporter.ts

@@ -8,13 +8,10 @@ import type {
   Violation,
   ViolationReport,
   Severity,
-  LayerDefinition,
   GuardPreset,
 } from "./types";
 import {
-  getDocumentationLink,
   toAgentFormat,
-  type AgentViolationFormat,
 } from "./suggestions";
 
 // ═══════════════════════════════════════════════════════════════════════════
@@ -89,7 +86,7 @@ export function formatViolation(
 ): string {
   const icon = getSeverityIcon(violation.severity);
   const color = getSeverityColor(violation.severity);
-  const label = getSeverityLabel(violation.severity);
+  const _label = getSeverityLabel(violation.severity);
 
   const lines: string[] = [
     "",

package/src/guard/semantic-slots.ts

@@ -22,7 +22,7 @@
  */
 
 import { readFile } from "fs/promises";
-import { join, relative, normalize } from "path";
+
 
 // ═══════════════════════════════════════════════════════════════════════════
 // Types
@@ -460,7 +460,7 @@ function safeRegexTest(
 export async function validateSlotConstraints(
   filePath: string,
   constraints: SlotConstraints,
-  rootDir?: string
+  _rootDir?: string
 ): Promise<SemanticSlotValidationResult> {
   const violations: ConstraintViolation[] = [];
   const suggestions: string[] = [];

package/src/guard/suggestions.ts

@@ -80,7 +80,7 @@ interface SuggestionContext {
  * 스마트 제안 생성
  */
 export function generateSmartSuggestions(context: SuggestionContext): string[] {
-  const { type, fromLayer, toLayer, importPath, allowedLayers, layers, preset, slice } = context;
+  const { type } = context;
   const suggestions: string[] = [];
 
   switch (type) {
@@ -153,7 +153,7 @@ function generateLayerViolationSuggestions(context: SuggestionContext): string[]
  * 순환 의존 제안 생성
  */
 function generateCircularDependencySuggestions(context: SuggestionContext): string[] {
-  const { fromLayer, toLayer, importPath } = context;
+  const { fromLayer, toLayer } = context;
   const suggestions: string[] = [];
 
   suggestions.push(

package/src/guard/watcher.ts

@@ -1,3 +1,4 @@
+import type * as __ManduGlobTypes0 from "glob";
 /**
  * Mandu Guard Watcher
  *
@@ -45,9 +46,9 @@ interface WatcherOptions {
 
 const analysisCache = new Map<string, FileAnalysis>();
 
-let globModulePromise: Promise<typeof import("glob")> | null = null;
+let globModulePromise: Promise<typeof __ManduGlobTypes0> | null = null;
 
-async function getGlobModule(): Promise<typeof import("glob")> {
+async function getGlobModule(): Promise<typeof __ManduGlobTypes0> {
   if (!globModulePromise) {
     globModulePromise = import("glob");
   }
@@ -93,7 +94,7 @@ export function createGuardWatcher(options: WatcherOptions): GuardWatcher {
 
   // 레이어 정의 가져오기
   const layers = resolveLayerDefinitions(config);
-  const hierarchy = resolveHierarchy(config);
+  const _hierarchy = resolveHierarchy(config);
 
   // 설정 기본값 적용
   const srcDir = config.srcDir ?? DEFAULT_GUARD_CONFIG.srcDir;
@@ -272,7 +273,7 @@ export function createGuardWatcher(options: WatcherOptions): GuardWatcher {
 
     close(): void {
       if (watcher) {
-        watcher.close();
+        void watcher.close();
         watcher = null;
       }
       clearAnalysisCache();

package/src/index.ts

@@ -94,14 +94,14 @@ export {
 } from "./observability/tracing";
 
 // Consolidated Mandu namespace
-import { ManduFilling, ManduContext, ManduFillingFactory, createSSEConnection } from "./filling";
+import { ManduFillingFactory, createSSEConnection } from "./filling";
 import { createContract, defineHandler, defineRoute, createClient, contractFetch, createClientContract, querySchema, bodySchema, apiError } from "./contract";
 import { defineContract, generateAllFromContract, generateOpenAPISpec } from "./contract/define";
-import { island, isIsland, type IslandComponent, type IslandHydrationStrategy, type ClientIslandDefinition, type CompiledClientIsland } from "./island";
-import { intent, isIntent, getIntentDocs, generateOpenAPIFromIntent } from "./intent";
+import { island, isIsland } from "./island";
+import { intent, isIntent } from "./intent";
 import { initializeHook, reportError, ManduDevTools, getStateManager } from "./devtools";
-import type { ContractDefinition, ContractInstance, ContractSchema } from "./contract";
-import type { ContractHandlers, ClientOptions } from "./contract";
+
+
 
 /**
  * Mandu - Unified Namespace

package/src/intent/index.ts

@@ -22,7 +22,7 @@
  * ```
  */
 
-import { z, type ZodType } from 'zod';
+import { type ZodType } from 'zod';
 import { ManduFillingFactory, type ManduFilling } from '../filling/filling';
 import type { ManduContext } from '../filling/context';
 import { getZodTypeName, getZodObjectShape, getZodArrayElementType } from '../contract/zod-utils';

package/src/kitchen/api/contract-api.ts

@@ -193,7 +193,7 @@ export class ContractPlaygroundAPI {
       }
 
       return Response.json({ valid: true });
-    } catch (e) {
+    } catch  {
       return Response.json(
         { error: "Invalid request body" },
         { status: 400 },

package/src/kitchen/api/file-api.ts

@@ -52,7 +52,7 @@ export class FileAPI {
       const language = detectLanguage(filePath);
 
       return Response.json({ filePath, content, language });
-    } catch (error) {
+    } catch  {
       return Response.json(
         { error: "Failed to read file" },
         { status: 500 },
@@ -84,7 +84,7 @@ export class FileAPI {
     try {
       const diff = await this.getFileDiff(filePath, resolved);
       return Response.json(diff);
-    } catch (error) {
+    } catch  {
       return Response.json(
         { error: "Failed to get diff" },
         { status: 500 },
@@ -100,7 +100,7 @@ export class FileAPI {
     try {
       const changes = await this.getGitStatus();
       return Response.json({ changes });
-    } catch (error) {
+    } catch  {
       return Response.json(
         { error: "Failed to get changes" },
         { status: 500 },

package/src/kitchen/kitchen-handler.ts

@@ -19,9 +19,17 @@ import { eventBus } from "../observability/event-bus";
 import fs from "fs/promises";
 import path from "path";
 
-export const KITCHEN_PREFIX = "/__kitchen";
-
-export interface KitchenOptions {
+export const KITCHEN_PREFIX = "/__kitchen";
+
+function reverseCopy<T>(items: readonly T[]): T[] {
+  const reversed: T[] = [];
+  for (let index = items.length - 1; index >= 0; index -= 1) {
+    reversed.push(items[index] as T);
+  }
+  return reversed;
+}
+
+export interface KitchenOptions {
   rootDir: string;
   manifest: RoutesManifest;
   guardConfig: GuardConfig | null;
@@ -74,9 +82,9 @@ export function recordRequest(entry: RequestEntry): void {
   if (recentRequests.length > MAX_REQUESTS) recentRequests.shift();
 }
 
-export function getRecentRequests(): RequestEntry[] {
-  return [...recentRequests].reverse();
-}
+export function getRecentRequests(): RequestEntry[] {
+  return reverseCopy(recentRequests);
+}
 
 /** Parse a window string like "5m", "30s", "1h" into milliseconds. */
 function parseWindow(input: string): number {
@@ -322,11 +330,11 @@ export class KitchenHandler {
     // Requests API — recent HTTP events from eventBus (fallback: ring buffer)
     if (sub === "/api/requests" && req.method === "GET") {
       const url = new URL(req.url);
-      const limit = Math.min(parseInt(url.searchParams.get("limit") || "100", 10) || 100, 500);
-      const busEvents = eventBus.getRecent(limit, { type: "http" });
-      if (busEvents.length > 0) {
-        return Response.json({ requests: busEvents.slice().reverse() });
-      }
+      const limit = Math.min(parseInt(url.searchParams.get("limit") || "100", 10) || 100, 500);
+      const busEvents = eventBus.getRecent(limit, { type: "http" });
+      if (busEvents.length > 0) {
+        return Response.json({ requests: reverseCopy(busEvents) });
+      }
       return Response.json({ requests: getRecentRequests().slice(0, limit) });
     }
 
@@ -343,11 +351,11 @@ export class KitchenHandler {
     // Activity API — recent MCP events from eventBus (fallback: activity.jsonl)
     if (sub === "/api/activity" && req.method === "GET") {
       const url = new URL(req.url);
-      const limit = Math.min(parseInt(url.searchParams.get("limit") || "100", 10) || 100, 500);
-      const busEvents = eventBus.getRecent(limit, { type: "mcp" });
-      if (busEvents.length > 0) {
-        return Response.json({ events: busEvents.slice().reverse() });
-      }
+      const limit = Math.min(parseInt(url.searchParams.get("limit") || "100", 10) || 100, 500);
+      const busEvents = eventBus.getRecent(limit, { type: "mcp" });
+      if (busEvents.length > 0) {
+        return Response.json({ events: reverseCopy(busEvents) });
+      }
       const events = await this.readRecentActivity();
       return Response.json({ events });
     }
@@ -488,11 +496,11 @@ export class KitchenHandler {
   private async readRecentActivity(): Promise<unknown[]> {
     const logPath = path.join(this.options.rootDir, ".mandu", "activity.jsonl");
     try {
-      const content = await fs.readFile(logPath, "utf-8");
-      const lines = content.trim().split("\n").filter(Boolean);
-      return lines.slice(-50).reverse().map((line) => {
-        try { return JSON.parse(line); } catch { return null; }
-      }).filter(Boolean);
+      const content = await fs.readFile(logPath, "utf-8");
+      const lines = content.trim().split("\n").filter(Boolean);
+      return reverseCopy(lines.slice(-50)).map((line) => {
+        try { return JSON.parse(line); } catch { return null; }
+      }).filter(Boolean);
     } catch { return []; }
   }
 }

package/src/lockfile/validate.ts

@@ -12,7 +12,6 @@ import {
   type LockfileError,
   type LockfileWarning,
   type LockfileMode,
-  type LockfilePolicyOptions,
   DEFAULT_POLICIES,
   LOCKFILE_SCHEMA_VERSION,
   BYPASS_ENV_VAR,

package/src/openapi/generator.ts

@@ -1,3 +1,4 @@
+import type * as __ManduNodeCryptoTypes0 from "node:crypto";
 /**
  * Mandu OpenAPI Generator
  * Contract에서 OpenAPI 3.0 스펙 자동 생성
@@ -893,7 +894,7 @@ function sha256Hex(input: string): string {
   // path (it would turn `hoistSharedSchemas` into an unnecessarily async
   // cascade on the hot path).
   // eslint-disable-next-line @typescript-eslint/no-require-imports
-  const nodeCrypto = require("node:crypto") as typeof import("node:crypto");
+  const nodeCrypto = require("node:crypto") as typeof __ManduNodeCryptoTypes0;
   return nodeCrypto.createHash("sha256").update(input).digest("hex");
 }