@mandujs/core 0.52.0 → 0.53.1

package/src/client/hooks.ts

@@ -7,10 +7,6 @@ import { useState, useEffect, useCallback, useMemo, useSyncExternalStore } from
 import {
   subscribe,
   getRouterState,
-  getCurrentRoute,
-  getLoaderData,
-  getActionData,
-  getNavigationState,
   navigate,
   submitAction,
   type RouteInfo,

package/src/client/hydrate.ts

@@ -110,7 +110,7 @@ function noopDispose(): Disposer {
  */
 function scheduleLoad(hydrate: () => void): Disposer {
   let cancelled = false;
-  Promise.resolve().then(() => {
+  void Promise.resolve().then(() => {
     if (!cancelled) hydrate();
   });
   return () => {

package/src/client/router.ts

@@ -3,7 +3,7 @@
  * SPA 스타일 네비게이션을 위한 클라이언트 라우터
  */
 
-import type { ReactNode } from "react";
+
 import { startTransition } from "react";
 import {
   getManduData,
@@ -404,12 +404,12 @@ export async function navigate(
 function handlePopState(event: PopStateEvent): void {
   const state = event.state;
 
-  if (state?.routeId) {
-    // Mandu로 방문한 페이지 - 데이터 다시 fetch
-    navigate(window.location.pathname + window.location.search, {
-      replace: true,
-      scroll: false,
-    });
+  if (state?.routeId) {
+    // Mandu로 방문한 페이지 - 데이터 다시 fetch
+    void navigate(window.location.pathname + window.location.search, {
+      replace: true,
+      scroll: false,
+    });
   } else {
     // SPA 네비게이션 이력이 아닌 페이지 — 현재 라우터 상태 유지
     // (getManduRoute()는 SSR 초기값이라 SPA 네비게이션 후에는 stale)
@@ -576,10 +576,10 @@ function handleLinkClick(event: MouseEvent): void {
   // All clear — prevent the default full-page navigation and hand off
   // to the client-side router. `href` preserves the user's original
   // string (relative paths, fragments, query strings) so the router
-  // can normalize as needed.
-  event.preventDefault();
-  navigate(href);
-}
+  // can normalize as needed.
+  event.preventDefault();
+  void navigate(href);
+}
 
 // ========== Prefetch ==========
 
@@ -702,7 +702,7 @@ export async function submitAction(
         actionData: nextActionData,
         loaderData: result._revalidated ? result.loaderData as unknown : undefined,
       };
-  } catch (error) {
+  } catch  {
     if (controller.signal.aborted) return { ok: false };
 
     setRouterStateInternal({

package/src/client/rpc.ts

@@ -50,7 +50,7 @@ export interface RpcClientOptions {
  * const { id } = await api.post({ body: { title: "New" } });
  * ```
  */
-export function createClient<TContract = unknown>(
+export function createClient<_TContract = unknown>(
   path: string,
   options?: RpcClientOptions
 ): RpcMethods {

package/src/client/use-fetch.ts

@@ -228,12 +228,12 @@ export function useFetch<T = unknown>(
     }
   }, [url, method, stableQuery, stableHeaders, stableBody, cacheTime, cacheKey, transform]);
 
-  useEffect(() => {
-    if (!immediate) return;
-    if (data && dedupe) return;
-    fetchData();
-    return () => { abortRef.current?.abort(); };
-  }, [fetchData, immediate, dedupe]);
+  useEffect(() => {
+    if (!immediate) return;
+    if (data && dedupe) return;
+    void fetchData();
+    return () => { abortRef.current?.abort(); };
+  }, [fetchData, immediate, dedupe]);
 
   const mutate = useCallback((updater: T | ((prev: T | null) => T)) => {
     setData(prev => typeof updater === "function" ? (updater as (prev: T | null) => T)(prev) : updater);

package/src/client/use-sse.ts

@@ -210,7 +210,7 @@ export function useSSE(options: UseSSEOptions = {}): UseSSEReturn {
       }
 
       // Start reading in a properly-yielding async loop
-      (async () => {
+      void (async () => {
         const reader = body.getReader();
         const decoder = new TextDecoder();
 
@@ -218,7 +218,7 @@ export function useSSE(options: UseSSEOptions = {}): UseSSEReturn {
           while (true) {
             // Check for abort
             if (controller.signal.aborted) {
-              reader.cancel();
+              await reader.cancel();
               break;
             }
 
@@ -227,7 +227,7 @@ export function useSSE(options: UseSSEOptions = {}): UseSSEReturn {
 
             // Check for abort again (may have been aborted during read)
             if (controller.signal.aborted) {
-              reader.cancel();
+              await reader.cancel();
               break;
             }
 
@@ -342,7 +342,7 @@ export async function readStreamWithYield(
   try {
     while (true) {
       if (signal?.aborted) {
-        reader.cancel();
+        await reader.cancel();
         break;
       }
 
@@ -350,7 +350,7 @@ export async function readStreamWithYield(
       if (done) break;
 
       if (signal?.aborted) {
-        reader.cancel();
+        await reader.cancel();
         break;
       }
 

package/src/config/mcp-status.ts

@@ -7,7 +7,6 @@
  */
 
 import {
-  MCP_SERVER_STATUS,
   type McpServerStatusMetadata,
 } from "./symbols.js";
 

package/src/config/validate.ts

@@ -15,7 +15,7 @@ import { isGuardRuleLike, type GuardRule as CustomGuardRule } from "../guard/def
  * Creates a schema that warns about unknown keys instead of failing
  * This provides the benefits of .strict() while maintaining compatibility
  */
-function strictWithWarnings<T extends z.ZodRawShape>(
+function _strictWithWarnings<T extends z.ZodRawShape>(
   schema: z.ZodObject<T>,
   schemaName: string
 ): z.ZodEffects<z.ZodObject<T>> {

package/src/config/watcher.ts

@@ -150,7 +150,7 @@ export async function watchConfig(
 
     debounceTimer = setTimeout(() => {
       debounceTimer = null;
-      doReload(changedPath);
+      void doReload(changedPath);
     }, debounceMs);
   };
 

package/src/content/collection.ts

@@ -607,9 +607,8 @@ interface RenderedMarkdown {
  * remark/rehype plugin chain; when any piece is missing, falls back
  * to returning a `<pre>` shell so the caller gets a stable API.
  *
- * We go through `Function("return import(...)")` instead of a direct
- * dynamic `import()` so TS doesn't resolve the optional modules
- * during typecheck — they are NOT in `@mandujs/core` deps by design.
+ * We use a variable dynamic import so TS doesn't resolve the optional
+ * modules during typecheck — they are NOT in `@mandujs/core` deps by design.
  *
  * The `options.remarkPlugins` / `options.rehypePlugins` arrays let
  * docs sites add `rehype-slug`, `rehype-autolink-headings`, `shiki`,
@@ -621,15 +620,12 @@ async function renderMarkdownSafe(
 ): Promise<RenderedMarkdown> {
   const { remarkPlugins = [], rehypePlugins = [], silent = false } = options;
 
-  // Passing the module specifier through a Function-wrapped dynamic
-  // import keeps TypeScript from erroring on optional peer deps; if
-  // any module is missing we fall through to the raw-markdown path.
-  const tryImport = async (id: string): Promise<unknown> => {
-    try {
-      return await (Function("x", "return import(x)") as (x: string) => Promise<unknown>)(id);
-    } catch {
-      return null;
-    }
+  const tryImport = async (id: string): Promise<unknown> => {
+    try {
+      return await import(id);
+    } catch {
+      return null;
+    }
   };
 
   const unified = (await tryImport("unified")) as

package/src/content/content-layer.ts

@@ -253,11 +253,11 @@ export class ContentLayer {
   /**
    * 리소스 정리
    */
-  dispose(): void {
-    this.dataStore.dispose();
-    this.watcher?.close();
-  }
-}
+  dispose(): void {
+    this.dataStore.dispose();
+    void this.watcher?.close();
+  }
+}
 
 /**
  * ContentLayer 팩토리

package/src/content/data-store.ts

@@ -131,7 +131,7 @@ export class ContentDataStore {
       }
 
       this.saveTimer = setTimeout(() => {
-        this.save();
+        void this.save();
       }, this.options.saveDebounce);
     }
   }
@@ -217,7 +217,7 @@ export class ContentDataStore {
 
     // 남은 변경사항 저장
     if (this.dirty && this.options.filePath) {
-      this.save();
+      void this.save();
     }
   }
 

package/src/content/loader-context.ts

@@ -13,7 +13,6 @@ import type {
   ContentWatcher,
   ParseDataOptions,
   RenderedContent,
-  ValidationError as ContentValidationError,
 } from "./types";
 import { ValidationError } from "./types";
 import { generateDigest } from "./digest";

package/src/content/loaders/file.ts

@@ -98,7 +98,7 @@ export function file(options: FileLoaderOptions): Loader {
     name: "file",
 
     async load(context: LoaderContext): Promise<void> {
-      const { store, config, logger, parseData, generateDigest } = context;
+      const { store, config, logger, parseData, generateDigest: _generateDigest } = context;
 
       // 절대 경로 계산
       const absolutePath = path.isAbsolute(filePath)

package/src/content/loaders/glob.ts

@@ -12,9 +12,9 @@
 
 import type { Loader, GlobLoaderOptions, ParsedMarkdown } from "./types";
 import type { LoaderContext, DataEntry } from "../types";
-import { LoaderError, ParseError } from "../types";
+import { ParseError } from "../types";
 import { generateFileDigest, combineDigests } from "../digest";
-import { inferParser, MARKDOWN_EXTENSIONS } from "./types";
+import { inferParser } from "./types";
 import * as fs from "fs";
 import * as path from "path";
 
@@ -108,7 +108,7 @@ export function glob(options: GlobLoaderOptions): Loader {
     name: "glob",
 
     async load(context: LoaderContext): Promise<void> {
-      const { store, config, logger, parseData, renderMarkdown, watcher } = context;
+      const { store, config, logger, parseData: _parseData, renderMarkdown: _renderMarkdown, watcher } = context;
 
       // 기본 디렉토리
       const baseDir = base
@@ -181,7 +181,7 @@ async function processFile(
   context: LoaderContext,
   filePath: string,
   id: string,
-  baseDir: string
+  _baseDir: string
 ): Promise<void> {
   const { store, parseData, renderMarkdown, logger } = context;
 

package/src/content/loaders/types.ts

@@ -5,7 +5,7 @@
  */
 
 import type { ZodSchema } from "zod";
-import type { LoaderContext, DataEntry, RenderedContent } from "../types";
+import type { LoaderContext, RenderedContent } from "../types";
 
 /**
  * 로더 인터페이스

package/src/content/meta-store.ts

@@ -102,7 +102,7 @@ export class ContentMetaStore {
    */
   private autoSave(): void {
     if (this.options.autoSave && this.options.filePath) {
-      this.save();
+      void this.save();
     }
   }
 

package/src/content/types.ts

@@ -110,7 +110,7 @@ export interface LoaderContext {
 /**
  * parseData 옵션
  */
-export interface ParseDataOptions<T> {
+export interface ParseDataOptions<_T> {
   /** 엔트리 ID */
   id: string;
   /** 원본 데이터 */

package/src/contract/define.ts

@@ -27,16 +27,15 @@
  * ```
  */
 
-import { z, type ZodType, type ZodObject, type ZodRawShape } from 'zod';
-import {
-  getZodTypeName,
-  getZodInnerType,
-  getZodArrayElementType,
-  getZodObjectShape,
-  getZodEnumValues,
-  getZodChecks,
-  isZodRequired,
-} from './zod-utils';
+import type { ZodType } from 'zod';
+import {
+  getZodTypeName,
+  getZodInnerType,
+  getZodArrayElementType,
+  getZodObjectShape,
+  getZodEnumValues,
+  isZodRequired,
+} from './zod-utils';
 
 // ============================================================================
 // Types
@@ -167,7 +166,7 @@ export function generateApiHandler<T extends ContractDefinition>(
     throw new Error(`Endpoint "${String(endpointName)}" not found in contract`);
   }
 
-  const { method, path, input, output, description } = endpoint;
+  const { method, path, input, description } = endpoint;
 
   return `
 import { Mandu } from '@mandujs/core';
@@ -345,7 +344,7 @@ export function generateOpenAPISpec<T extends ContractDefinition>(
   const paths: Record<string, Record<string, unknown>> = {};
 
   for (const [name, endpoint] of Object.entries(contract.__endpoints)) {
-    const { method, path, input, output, description, tags, errors } = endpoint;
+    const { method, path, input, description, tags, errors } = endpoint;
 
     if (!paths[path]) {
       paths[path] = {};

package/src/contract/index.ts

@@ -37,10 +37,10 @@ export {
   type RpcWireError,
 } from "./rpc";
 
-import type { ContractDefinition, ContractInstance, ContractSchema } from "./schema";
-import type { ContractHandlers, RouteDefinition } from "./handler";
+import type { ContractDefinition, ContractInstance } from "./schema";
+
 import { defineHandler, defineRoute } from "./handler";
-import { createClient, contractFetch, type ClientOptions } from "./client";
+import { createClient, contractFetch } from "./client";
 import { createClientContract } from "./client-safe";
 
 /**

package/src/contract/protection.ts

@@ -102,7 +102,7 @@ export function extractProtectedFields(
       }
       // 민감 필드도 보호 대상
       else if (isSensitiveField(value)) {
-        const meta = getMetadata(value, SENSITIVE_FIELD) as SensitiveFieldMetadata | undefined;
+        const _meta = getMetadata(value, SENSITIVE_FIELD) as SensitiveFieldMetadata | undefined;
         fields.push({
           path: currentPath,
           reason: "Sensitive field - redacted in logs",
@@ -187,7 +187,7 @@ export function extractContractProtectedFields(
 /**
  * 객체에서 경로로 값 가져오기
  */
-function getValueByPath(obj: unknown, path: string): unknown {
+function _getValueByPath(obj: unknown, path: string): unknown {
   const parts = path.split(".");
   let current: unknown = obj;
 

package/src/contract/types.ts

@@ -14,7 +14,7 @@ import type {
 /**
  * Extract inferred type from Zod schema
  */
-type InferZod<T> = T extends z.ZodTypeAny ? z.infer<T> : never;
+type _InferZod<T> = T extends z.ZodTypeAny ? z.infer<T> : never;
 
 /**
  * Extract inferred type from response schema (supports ResponseSchemaWithExamples)

package/src/contract/validator.ts

@@ -19,7 +19,6 @@ import type {
   ContractValidationError,
   ContractValidationIssue,
   MethodRequestSchema,
-  ContractNormalizeMode,
   ResponseSchemaWithExamples,
 } from "./schema";
 import {

package/src/db/__tests__/db.test.ts

@@ -107,13 +107,10 @@ function createFakeCtor(): { Ctor: BunSqlCtor; state: FakeState } {
     return Object.assign(call, methods);
   }
 
-  class FakeBunSql {
-    constructor(config: Record<string, unknown>) {
-      state.ctorCalls.push(config);
-      // Return the callable instance — NOT a class instance. Returning a
-      // non-this value from a constructor replaces the default return.
-      return makeFakeSqlInstance(false) as FakeBunSql;
-    }
+  function FakeBunSql(config: Record<string, unknown>) {
+    state.ctorCalls.push(config);
+    // Return the callable instance — NOT the default constructed object.
+    return makeFakeSqlInstance(false);
   }
 
   return {

package/src/db/migrations/index.ts

@@ -0,0 +1,3 @@
+export * from "./history-table";
+export * from "./lock";
+export * from "./runner";

package/src/db/migrations/lock.ts

@@ -102,11 +102,11 @@ async function acquirePgAdvisoryLock(
   // hash-function reproduction.
   await db`SELECT pg_advisory_lock(hashtext(${lockId})::bigint)`;
 
-  let released = false;
+  let _released = false;
   return {
     async release(): Promise<void> {
-      if (released) return;
-      released = true;
+      if (_released) return;
+      _released = true;
       try {
         await db`SELECT pg_advisory_unlock(hashtext(${lockId})::bigint)`;
       } catch (err) {
@@ -147,11 +147,11 @@ async function acquireMysqlLock(
     );
   }
 
-  let released = false;
+  let _released = false;
   return {
     async release(): Promise<void> {
-      if (released) return;
-      released = true;
+      if (_released) return;
+      _released = true;
       try {
         await db`SELECT RELEASE_LOCK(${lockId})`;
       } catch (err) {
@@ -229,11 +229,11 @@ async function acquireSqliteImmediate(
   // Wait for the previous holder to release.
   await previous;
 
-  let released = false;
+  let _released = false;
   return {
     async release(): Promise<void> {
-      if (released) return;
-      released = true;
+      if (_released) return;
+      _released = true;
       release();
       // If no one queued behind us, drop the entry so the registry
       // doesn't grow unbounded across many apply() cycles.
@@ -245,10 +245,10 @@ async function acquireSqliteImmediate(
 }
 
 function makeNoopLock(): MigrationLock {
-  let released = false;
+  let _released = false;
   return {
     async release(): Promise<void> {
-      released = true;
+      _released = true;
     },
   };
 }

package/src/deploy/cache.ts

@@ -107,6 +107,7 @@ export async function loadDeployIntentCache(
   } catch (err) {
     throw new Error(
       `Deploy intent cache is not valid JSON (${file}): ${(err as Error).message}`,
+      { cause: err },
     );
   }
   return DeployIntentCache.parse(parsed);

package/src/design/__tests__/agents-link.test.ts

@@ -0,0 +1,109 @@
+/**
+ * Issue #245 M5 — AGENTS.md / CLAUDE.md linker tests.
+ */
+
+import { afterEach, beforeEach, describe, expect, it } from "bun:test";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import {
+  buildAgentsDesignBlock,
+  DESIGN_LINK_MARKER_END,
+  DESIGN_LINK_MARKER_START,
+  linkAgentsToDesignMd,
+} from "../agents-link";
+
+describe("buildAgentsDesignBlock", () => {
+  it("contains markers, the canonical heading, and all 8 MCP tools", () => {
+    const block = buildAgentsDesignBlock();
+    expect(block).toContain(DESIGN_LINK_MARKER_START);
+    expect(block).toContain(DESIGN_LINK_MARKER_END);
+    expect(block).toContain("## Design System");
+    for (const tool of [
+      "mandu.design.get",
+      "mandu.design.prompt",
+      "mandu.component.list",
+      "mandu.design.check",
+      "mandu.design.extract",
+      "mandu.design.propose",
+      "mandu.design.patch",
+      "mandu.design.diff_upstream",
+    ]) {
+      expect(block).toContain(tool);
+    }
+  });
+
+  it("respects custom DESIGN.md filename", () => {
+    expect(buildAgentsDesignBlock("Stripe-DESIGN.md")).toContain("Stripe-DESIGN.md");
+  });
+});
+
+describe("linkAgentsToDesignMd", () => {
+  let TEST_DIR: string;
+  beforeEach(async () => {
+    TEST_DIR = await fs.mkdtemp(path.join(os.tmpdir(), "mandu-design-link-"));
+  });
+  afterEach(async () => {
+    await fs.rm(TEST_DIR, { recursive: true, force: true });
+  });
+
+  it("inserts the block at end of an existing AGENTS.md", async () => {
+    await fs.writeFile(path.join(TEST_DIR, "AGENTS.md"), "# Existing\n\nSome notes.\n");
+    const result = await linkAgentsToDesignMd({ rootDir: TEST_DIR });
+    expect(result.changed).toBe(true);
+    expect(result.files.find((f) => f.path.endsWith("AGENTS.md"))?.action).toBe("inserted");
+    const after = await fs.readFile(path.join(TEST_DIR, "AGENTS.md"), "utf8");
+    expect(after).toContain("# Existing");
+    expect(after).toContain("Some notes.");
+    expect(after).toContain("## Design System");
+  });
+
+  it("is idempotent — running twice produces no diff on the second run", async () => {
+    await fs.writeFile(path.join(TEST_DIR, "AGENTS.md"), "# X\n");
+    await linkAgentsToDesignMd({ rootDir: TEST_DIR });
+    const after1 = await fs.readFile(path.join(TEST_DIR, "AGENTS.md"), "utf8");
+    const second = await linkAgentsToDesignMd({ rootDir: TEST_DIR });
+    const after2 = await fs.readFile(path.join(TEST_DIR, "AGENTS.md"), "utf8");
+    expect(after1).toBe(after2);
+    expect(second.files.find((f) => f.path.endsWith("AGENTS.md"))?.action).toBe("unchanged");
+  });
+
+  it("replaces an existing markered block when the body changed", async () => {
+    await fs.writeFile(
+      path.join(TEST_DIR, "AGENTS.md"),
+      `# X\n\n${DESIGN_LINK_MARKER_START}\n\n## Old block\n\n${DESIGN_LINK_MARKER_END}\n`,
+    );
+    await linkAgentsToDesignMd({ rootDir: TEST_DIR });
+    const after = await fs.readFile(path.join(TEST_DIR, "AGENTS.md"), "utf8");
+    expect(after).not.toContain("## Old block");
+    expect(after).toContain("## Design System");
+  });
+
+  it("touches CLAUDE.md too when both exist", async () => {
+    await fs.writeFile(path.join(TEST_DIR, "AGENTS.md"), "# A\n");
+    await fs.writeFile(path.join(TEST_DIR, "CLAUDE.md"), "# C\n");
+    const result = await linkAgentsToDesignMd({ rootDir: TEST_DIR });
+    expect(result.files.filter((f) => f.action === "inserted")).toHaveLength(2);
+    expect(await fs.readFile(path.join(TEST_DIR, "CLAUDE.md"), "utf8")).toContain(
+      "## Design System",
+    );
+  });
+
+  it("creates AGENTS.md when neither file exists and createIfMissing is true", async () => {
+    const result = await linkAgentsToDesignMd({
+      rootDir: TEST_DIR,
+      createIfMissing: true,
+    });
+    expect(result.changed).toBe(true);
+    expect(result.files.find((f) => f.action === "created")).toBeDefined();
+    expect(await fs.readFile(path.join(TEST_DIR, "AGENTS.md"), "utf8")).toContain(
+      "## Design System",
+    );
+  });
+
+  it("is a no-op when neither file exists and createIfMissing is false", async () => {
+    const result = await linkAgentsToDesignMd({ rootDir: TEST_DIR });
+    expect(result.changed).toBe(false);
+    await expect(fs.access(path.join(TEST_DIR, "AGENTS.md"))).rejects.toThrow();
+  });
+});