@mandujs/cli 0.15.3 → 0.15.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mandujs/cli",
-  "version": "0.15.3",
+  "version": "0.15.4",
   "description": "Agent-Native Fullstack Framework - 에이전트가 코딩해도 아키텍처가 무너지지 않는 개발 OS",
   "type": "module",
   "main": "./src/main.ts",

package/src/util/lockfile.ts

@@ -8,6 +8,54 @@ import {
   type LockfileValidationResult,
 } from "@mandujs/core";
 
+/**
+ * Lockfile command templates for consistent messaging
+ */
+export const LOCKFILE_COMMANDS = {
+  update: "mandu lock",
+  diff: "mandu lock --diff",
+  safeDev: "mandu lock && mandu dev --watch",
+} as const;
+
+/**
+ * Formatted lockfile guidance lines with alternative commands
+ */
+export const LOCKFILE_GUIDE_LINES = {
+  update: `${LOCKFILE_COMMANDS.update}  (or bunx mandu lock)`,
+  diff: `${LOCKFILE_COMMANDS.diff}  (or bunx mandu lock --diff)`,
+  safeDev: `${LOCKFILE_COMMANDS.safeDev}  (or bun run dev:safe)`,
+} as const;
+
+/**
+ * Returns formatted lockfile guidance lines for display
+ *
+ * @returns Array of guidance messages with Korean labels
+ *
+ * @example
+ * ```typescript
+ * const lines = getLockfileGuidanceLines();
+ * lines.forEach(line => console.log(`   ↳ ${line}`));
+ * // Output:
+ * //    ↳ lock 갱신: mandu lock  (or bunx mandu lock)
+ * //    ↳ 변경 확인: mandu lock --diff  (or bunx mandu lock --diff)
+ * //    ↳ 안정 실행: mandu lock && mandu dev --watch  (or bun run dev:safe)
+ * ```
+ */
+export function getLockfileGuidanceLines(): string[] {
+  return [
+    `lock 갱신: ${LOCKFILE_GUIDE_LINES.update}`,
+    `변경 확인: ${LOCKFILE_GUIDE_LINES.diff}`,
+    `안정 실행: ${LOCKFILE_GUIDE_LINES.safeDev}`,
+  ];
+}
+
+/**
+ * Validates runtime lockfile against current config
+ *
+ * @param config - Mandu configuration object
+ * @param rootDir - Project root directory
+ * @returns Validation result with lockfile, action, and bypass status
+ */
 export async function validateRuntimeLockfile(config: Record<string, unknown>, rootDir: string) {
   const lockfile = await readLockfile(rootDir);
 
@@ -30,17 +78,22 @@ export async function validateRuntimeLockfile(config: Record<string, unknown>, r
   return { lockfile, lockResult, action, bypassed };
 }
 
+/**
+ * Handles blocked server start due to lockfile mismatch
+ *
+ * Exits process with error code 1 if action is "block"
+ *
+ * @param action - Policy action from lockfile validation
+ * @param lockResult - Validation result with details
+ */
 export function handleBlockedLockfile(action: "pass" | "warn" | "error" | "block", lockResult: LockfileValidationResult | null): void {
   if (action !== "block") return;
 
+  const guidance = getLockfileGuidanceLines();
   console.error("🛑 서버 시작 차단: Lockfile 불일치");
-  console.error("   설정이 변경되었습니다. 의도한 변경이라면 아래 중 하나를 실행하세요:");
-  console.error("   $ mandu lock");
-  console.error("   $ bunx mandu lock");
-  console.error("");
-  console.error("   변경 사항 확인:");
-  console.error("   $ mandu lock --diff");
-  console.error("   $ bunx mandu lock --diff");
+  console.error("   설정이 변경되었습니다. 의도한 변경이라면 아래를 실행하세요:");
+  console.error(`   ↳ ${guidance[0]}`);
+  console.error(`   ↳ ${guidance[1]}`);
   if (lockResult) {
     console.error("");
     console.error(formatValidationResult(lockResult));
@@ -48,6 +101,14 @@ export function handleBlockedLockfile(action: "pass" | "warn" | "error" | "block
   process.exit(1);
 }
 
+/**
+ * Prints runtime lockfile validation status
+ *
+ * @param action - Policy action from lockfile validation
+ * @param bypassed - Whether validation was bypassed
+ * @param lockfile - Lockfile data (null if not found)
+ * @param lockResult - Validation result with hash and validity
+ */
 export function printRuntimeLockfileStatus(
   action: "pass" | "warn" | "error" | "block",
   bypassed: boolean,
@@ -56,11 +117,12 @@ export function printRuntimeLockfileStatus(
 ): void {
   if (action === "warn") {
     console.log(`⚠️  ${formatPolicyAction(action, bypassed)}`);
-    console.log(`   ↳ lock 갱신: mandu lock  (or bunx mandu lock)`);
-    console.log(`   ↳ 변경 확인: mandu lock --diff  (or bunx mandu lock --diff)`);
+    for (const line of getLockfileGuidanceLines()) {
+      console.log(`   ↳ ${line}`);
+    }
   } else if (lockfile && lockResult?.valid) {
     console.log(`🔒 설정 무결성 확인됨 (${lockResult.currentHash?.slice(0, 8)})`);
   } else if (!lockfile) {
-    console.log(`💡 Lockfile 없음 - 'mandu lock' 또는 'bunx mandu lock'으로 생성 권장`);
+    console.log(`💡 Lockfile 없음 - '${LOCKFILE_COMMANDS.update}'으로 생성 권장`);
   }
 }

package/templates/realtime-chat/src/client/features/chat/use-realtime-chat.ts

@@ -7,7 +7,7 @@ import {
   openChatStream,
   sendChatMessage,
   type ChatStreamConnectionState,
-} from "./chat-api";
+} from "@/client/features/chat/chat-api";
 
 export function useRealtimeChat() {
   const [messages, setMessages] = useState<ChatMessage[]>([]);