@mandujs/core 0.9.46 → 0.10.0

package/src/index.ts

@@ -14,6 +14,8 @@ export * from "./brain";
 export * from "./watcher";
 export * from "./router";
 export * from "./config";
+export * from "./lockfile";
+export * from "./utils";
 export * from "./seo";
 export * from "./island";
 export * from "./intent";

package/src/lockfile/generate.ts

@@ -0,0 +1,259 @@
+/**
+ * Mandu Lockfile 생성 🔐
+ *
+ * 설정 파일에서 lockfile 생성
+ */
+
+import { computeConfigHash, normalizeForHash } from "../utils/hasher.js";
+import {
+  type ManduLockfile,
+  type LockfileGenerateOptions,
+  LOCKFILE_SCHEMA_VERSION,
+} from "./types.js";
+
+// ============================================
+// Lockfile 생성
+// ============================================
+
+/**
+ * 설정에서 Lockfile 생성
+ *
+ * @example
+ * ```typescript
+ * const config = await loadConfig();
+ * const lockfile = generateLockfile(config, {
+ *   manduVersion: "0.9.46",
+ *   includeSnapshot: true,
+ * });
+ * ```
+ */
+export function generateLockfile(
+  config: Record<string, unknown>,
+  options: LockfileGenerateOptions = {},
+  mcpConfig?: Record<string, unknown> | null
+): ManduLockfile {
+  const {
+    manduVersion = getManduVersion(),
+    environment = detectEnvironment(),
+    includeSnapshot = false,
+    includeMcpServerHashes = true,
+  } = options;
+
+  // 설정 해시 계산
+  const configHash = computeConfigHash(config);
+
+  // MCP 설정 해시 (있는 경우)
+  const { mcpHashSource, mcpServers } = resolveMcpSources(config, mcpConfig);
+  let mcpConfigHash: string | undefined;
+  let mcpServerHashes: ManduLockfile["mcpServers"];
+
+  if (mcpHashSource && Object.keys(mcpHashSource).length > 0) {
+    mcpConfigHash = computeConfigHash(mcpHashSource);
+
+    if (includeMcpServerHashes && mcpServers) {
+      mcpServerHashes = {};
+      for (const [name, serverConfig] of Object.entries(mcpServers)) {
+        mcpServerHashes[name] = {
+          hash: computeConfigHash(serverConfig),
+          version: extractServerVersion(serverConfig),
+        };
+      }
+    }
+  }
+
+  // Lockfile 생성
+  const lockfile: ManduLockfile = {
+    schemaVersion: LOCKFILE_SCHEMA_VERSION,
+    manduVersion,
+    configHash,
+    generatedAt: new Date().toISOString(),
+    environment,
+  };
+
+  // 선택적 필드 추가
+  if (mcpConfigHash) {
+    lockfile.mcpConfigHash = mcpConfigHash;
+  }
+
+  if (mcpServerHashes) {
+    lockfile.mcpServers = mcpServerHashes;
+  }
+
+  if (includeSnapshot) {
+    const normalized = normalizeForHash(config);
+    const snapshotConfig =
+      normalized && typeof normalized === "object"
+        ? (normalized as Record<string, unknown>)
+        : {};
+
+    if (mcpServers) {
+      const normalizedMcp = normalizeForHash(mcpServers);
+      if (normalizedMcp !== undefined) {
+        snapshotConfig.mcpServers = normalizedMcp;
+      }
+    }
+
+    lockfile.snapshot = {
+      config: snapshotConfig,
+      environment: environment ?? "development",
+    };
+  }
+
+  return lockfile;
+}
+
+/**
+ * MCP 설정에서 별도 Lockfile 데이터 생성
+ */
+export function generateMcpLockData(
+  mcpConfig: Record<string, unknown>
+): { hash: string; servers: ManduLockfile["mcpServers"] } {
+  const { mcpHashSource, mcpServers } = resolveMcpSources({}, mcpConfig);
+  const hash = mcpHashSource ? computeConfigHash(mcpHashSource) : computeConfigHash(mcpConfig);
+  const servers: ManduLockfile["mcpServers"] = {};
+
+  if (mcpServers) {
+    for (const [name, serverConfig] of Object.entries(mcpServers)) {
+      servers[name] = {
+        hash: computeConfigHash(serverConfig),
+        version: extractServerVersion(serverConfig),
+      };
+    }
+  }
+
+  return { hash, servers };
+}
+
+// ============================================
+// 유틸리티
+// ============================================
+
+/**
+ * mandu 버전 가져오기
+ */
+function getManduVersion(): string {
+  // 실제 구현에서는 package.json에서 읽거나 빌드 시 주입
+  try {
+    // @ts-ignore - 빌드 시 주입되는 값
+    if (typeof __MANDU_VERSION__ !== "undefined") {
+      // @ts-ignore
+      return __MANDU_VERSION__;
+    }
+  } catch {
+    // ignore
+  }
+
+  // 기본값
+  return "0.0.0";
+}
+
+/**
+ * 현재 환경 감지
+ */
+function detectEnvironment(): "development" | "production" | "ci" {
+  // CI 환경 감지
+  if (
+    process.env.CI === "true" ||
+    process.env.GITHUB_ACTIONS === "true" ||
+    process.env.GITLAB_CI === "true" ||
+    process.env.JENKINS_URL
+  ) {
+    return "ci";
+  }
+
+  // NODE_ENV 기반
+  if (process.env.NODE_ENV === "production") {
+    return "production";
+  }
+
+  return "development";
+}
+
+/**
+ * 서버 설정에서 버전 추출
+ */
+function extractServerVersion(
+  serverConfig: unknown
+): string | undefined {
+  if (typeof serverConfig !== "object" || serverConfig === null) {
+    return undefined;
+  }
+
+  const config = serverConfig as Record<string, unknown>;
+
+  // version 필드 직접 확인
+  if (typeof config.version === "string") {
+    return config.version;
+  }
+
+  // args에서 버전 패턴 추출 시도 (예: @package/name@1.2.3)
+  if (Array.isArray(config.args)) {
+    for (const arg of config.args) {
+      if (typeof arg === "string") {
+        const match = arg.match(/@[\w-]+\/[\w-]+@([\d.]+)/);
+        if (match) {
+          return match[1];
+        }
+      }
+    }
+  }
+
+  return undefined;
+}
+
+// ============================================
+// 해시 재계산
+// ============================================
+
+/**
+ * 현재 설정의 해시만 빠르게 계산
+ */
+export function computeCurrentHashes(
+  config: Record<string, unknown>,
+  mcpConfig?: Record<string, unknown> | null
+): { configHash: string; mcpConfigHash?: string } {
+  const configHash = computeConfigHash(config);
+
+  const { mcpHashSource } = resolveMcpSources(config, mcpConfig);
+  const mcpConfigHash = mcpHashSource && Object.keys(mcpHashSource).length > 0
+    ? computeConfigHash(mcpHashSource)
+    : undefined;
+
+  return { configHash, mcpConfigHash };
+}
+
+// ============================================
+// MCP 설정 해석
+// ============================================
+
+export function resolveMcpSources(
+  config: Record<string, unknown>,
+  mcpConfig?: Record<string, unknown> | null
+): {
+  mcpHashSource?: Record<string, unknown>;
+  mcpServers?: Record<string, unknown>;
+} {
+  if (mcpConfig && typeof mcpConfig === "object") {
+    const mcpServers = (mcpConfig as Record<string, unknown>).mcpServers;
+    if (mcpServers && typeof mcpServers === "object" && !Array.isArray(mcpServers)) {
+      return {
+        mcpHashSource: mcpConfig,
+        mcpServers: mcpServers as Record<string, unknown>,
+      };
+    }
+    return {
+      mcpHashSource: mcpConfig,
+      mcpServers: mcpConfig,
+    };
+  }
+
+  const configServers = config.mcpServers as Record<string, unknown> | undefined;
+  if (configServers && typeof configServers === "object") {
+    return {
+      mcpHashSource: configServers,
+      mcpServers: configServers,
+    };
+  }
+
+  return {};
+}

package/src/lockfile/index.ts

@@ -0,0 +1,186 @@
+/**
+ * Mandu Lockfile I/O 📁
+ *
+ * Lockfile 읽기/쓰기 및 공개 API
+ */
+
+import { mkdir } from "node:fs/promises";
+import path from "node:path";
+import {
+  type ManduLockfile,
+  type LockfileError,
+  LOCKFILE_PATH,
+  LOCKFILE_DIR,
+  LOCKFILE_SCHEMA_VERSION,
+} from "./types.js";
+
+// ============================================
+// 읽기
+// ============================================
+
+/**
+ * Lockfile 읽기
+ *
+ * @param projectRoot 프로젝트 루트 디렉토리
+ * @returns Lockfile 또는 null (없는 경우)
+ * @throws 파싱 오류 시
+ *
+ * @example
+ * ```typescript
+ * const lockfile = await readLockfile(process.cwd());
+ * if (lockfile) {
+ *   console.log(`Config hash: ${lockfile.configHash}`);
+ * }
+ * ```
+ */
+export async function readLockfile(
+  projectRoot: string
+): Promise<ManduLockfile | null> {
+  const lockfilePath = path.join(projectRoot, LOCKFILE_PATH);
+
+  try {
+    const file = Bun.file(lockfilePath);
+    const exists = await file.exists();
+
+    if (!exists) {
+      return null;
+    }
+
+    const content = await file.text();
+    const data = JSON.parse(content) as ManduLockfile;
+
+    // 스키마 버전 체크
+    if (data.schemaVersion !== LOCKFILE_SCHEMA_VERSION) {
+      console.warn(
+        `[Mandu] Lockfile schema version mismatch: expected ${LOCKFILE_SCHEMA_VERSION}, got ${data.schemaVersion}`
+      );
+    }
+
+    return data;
+  } catch (error) {
+    if (error instanceof SyntaxError) {
+      throw new Error(
+        `Failed to parse lockfile at ${lockfilePath}: ${error.message}`
+      );
+    }
+    throw error;
+  }
+}
+
+/**
+ * MCP 설정 읽기 (.mcp.json)
+ */
+export async function readMcpConfig(
+  projectRoot: string
+): Promise<Record<string, unknown> | null> {
+  const mcpPath = path.join(projectRoot, ".mcp.json");
+
+  try {
+    const file = Bun.file(mcpPath);
+    const exists = await file.exists();
+    if (!exists) return null;
+
+    const content = await file.text();
+    const data = JSON.parse(content) as Record<string, unknown>;
+    return data ?? null;
+  } catch (error) {
+    if (error instanceof SyntaxError) {
+      throw new Error(`Failed to parse .mcp.json at ${mcpPath}: ${error.message}`);
+    }
+    throw error;
+  }
+}
+
+/**
+ * Lockfile 존재 여부 확인
+ */
+export async function lockfileExists(projectRoot: string): Promise<boolean> {
+  const lockfilePath = path.join(projectRoot, LOCKFILE_PATH);
+  const file = Bun.file(lockfilePath);
+  return file.exists();
+}
+
+// ============================================
+// 쓰기
+// ============================================
+
+/**
+ * Lockfile 쓰기
+ *
+ * @param projectRoot 프로젝트 루트 디렉토리
+ * @param lockfile Lockfile 데이터
+ *
+ * @example
+ * ```typescript
+ * const lockfile = generateLockfile(config);
+ * await writeLockfile(process.cwd(), lockfile);
+ * ```
+ */
+export async function writeLockfile(
+  projectRoot: string,
+  lockfile: ManduLockfile
+): Promise<void> {
+  const lockfileDir = path.join(projectRoot, LOCKFILE_DIR);
+  const lockfilePath = path.join(projectRoot, LOCKFILE_PATH);
+
+  // 디렉토리 생성
+  await mkdir(lockfileDir, { recursive: true });
+
+  // JSON 포맷팅 (가독성)
+  const content = JSON.stringify(lockfile, null, 2);
+
+  // 쓰기
+  await Bun.write(lockfilePath, content);
+}
+
+/**
+ * Lockfile 삭제
+ */
+export async function deleteLockfile(projectRoot: string): Promise<boolean> {
+  const lockfilePath = path.join(projectRoot, LOCKFILE_PATH);
+
+  try {
+    const file = Bun.file(lockfilePath);
+    const exists = await file.exists();
+
+    if (!exists) {
+      return false;
+    }
+
+    const { unlink } = await import("node:fs/promises");
+    await unlink(lockfilePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// ============================================
+// 유틸리티
+// ============================================
+
+/**
+ * Lockfile 경로 가져오기
+ */
+export function getLockfilePath(projectRoot: string): string {
+  return path.join(projectRoot, LOCKFILE_PATH);
+}
+
+/**
+ * Lockfile 오류 생성 헬퍼
+ */
+export function createLockfileError(
+  code: LockfileError["code"],
+  message: string,
+  details?: Record<string, unknown>
+): LockfileError {
+  return { code, message, details };
+}
+
+// ============================================
+// Re-exports
+// ============================================
+
+export * from "./types.js";
+export * from "./generate.js";
+export * from "./validate.js";