sanjang 0.3.0

package/lib/engine/config-hotfix.ts

@@ -0,0 +1,161 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { deepFindEnvFiles } from "./smart-init.ts";
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+export interface ConfigFix {
+  type: "add-copyfiles" | "update-setup" | "info";
+  description: string;
+  patch: Record<string, unknown>; // the values to add/change
+}
+
+// ---------------------------------------------------------------------------
+// Pattern matchers
+// ---------------------------------------------------------------------------
+
+interface PatternMatcher {
+  test: RegExp;
+  buildFix: (projectRoot: string, match: RegExpMatchArray) => ConfigFix | null;
+}
+
+const PATTERNS: PatternMatcher[] = [
+  {
+    // SvelteKit / Vite: "does not provide an export named 'PUBLIC_*'"
+    test: /does not provide an export named '(PUBLIC_\w+)'/,
+    buildFix(projectRoot: string, _match: RegExpMatchArray): ConfigFix | null {
+      const envFiles = deepFindEnvFiles(projectRoot).filter(
+        (f) => !f.includes("example") && !f.includes("template") && !f.includes(".test"),
+      );
+      if (envFiles.length === 0) return null;
+      return {
+        type: "add-copyfiles",
+        description: `환경변수 참조 오류 — copyFiles에 ${envFiles.join(", ")}을 추가합니다.`,
+        patch: { copyFiles: envFiles },
+      };
+    },
+  },
+  {
+    // Port mismatch: "Port X is in use, trying another one"
+    test: /Port (\d+) is in use/,
+    buildFix(_projectRoot: string, match: RegExpMatchArray): ConfigFix | null {
+      const port = match[1];
+      return {
+        type: "info",
+        description: `포트 ${port}이(가) 이미 사용 중입니다. 다른 캠프가 실행 중인지 확인하세요.`,
+        patch: { _conflictPort: Number(port) },
+      };
+    },
+  },
+  {
+    // Module not found after fresh install → setup command might be wrong
+    test: /Cannot find module '([^']+)'/,
+    buildFix(_projectRoot: string, match: RegExpMatchArray): ConfigFix | null {
+      const moduleName = match[1];
+      return {
+        type: "update-setup",
+        description: `모듈 '${moduleName}'을(를) 찾을 수 없습니다. setup 명령이 올바른지 확인하세요.`,
+        patch: { _missingModule: moduleName },
+      };
+    },
+  },
+];
+
+// ---------------------------------------------------------------------------
+// suggestConfigFix — analyze logs and return a fix, or null
+// ---------------------------------------------------------------------------
+
+export function suggestConfigFix(projectRoot: string, logs: string[]): ConfigFix | null {
+  const combined = logs.join("\n");
+
+  for (const pattern of PATTERNS) {
+    const match = combined.match(pattern.test);
+    if (match) {
+      const fix = pattern.buildFix(projectRoot, match);
+      if (fix) return fix;
+    }
+  }
+
+  return null;
+}
+
+// ---------------------------------------------------------------------------
+// applyConfigFix — modify sanjang.config.js in place
+// ---------------------------------------------------------------------------
+
+const CONFIG_FILE = "sanjang.config.js";
+
+export function applyConfigFix(projectRoot: string, fix: ConfigFix): boolean {
+  const configPath = join(projectRoot, CONFIG_FILE);
+  if (!existsSync(configPath)) return false;
+
+  let content: string;
+  try {
+    content = readFileSync(configPath, "utf8");
+  } catch {
+    return false;
+  }
+
+  switch (fix.type) {
+    case "add-copyfiles": {
+      const newFiles = fix.patch.copyFiles as string[];
+      if (!newFiles || newFiles.length === 0) return false;
+      content = mergeCopyFiles(content, newFiles);
+      break;
+    }
+    case "update-setup": {
+      // Informational — we don't auto-change setup without explicit user input
+      return false;
+    }
+    case "info": {
+      // Purely informational, nothing to write
+      return false;
+    }
+    default:
+      return false;
+  }
+
+  try {
+    writeFileSync(configPath, content, "utf8");
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+/**
+ * Merge new file paths into the existing copyFiles array inside the config
+ * source text.  If copyFiles doesn't exist, insert it before the closing `};`.
+ */
+function mergeCopyFiles(source: string, newFiles: string[]): string {
+  // Try to find existing copyFiles: [...]
+  const copyFilesRe = /copyFiles:\s*\[([^\]]*)\]/;
+  const match = source.match(copyFilesRe);
+
+  if (match) {
+    // Parse existing entries
+    const existing = match[1]!
+      .split(",")
+      .map((s) => s.trim().replace(/^['"]|['"]$/g, ""))
+      .filter(Boolean);
+
+    const merged = [...new Set([...existing, ...newFiles])];
+    const formatted = merged.map((f) => `'${f}'`).join(", ");
+    return source.replace(copyFilesRe, `copyFiles: [${formatted}]`);
+  }
+
+  // No copyFiles field — insert before the last `};`
+  const formatted = newFiles.map((f) => `'${f}'`).join(", ");
+  const insertion = `  copyFiles: [${formatted}],\n`;
+
+  const closingIdx = source.lastIndexOf("};");
+  if (closingIdx === -1) return source; // malformed config, bail
+
+  return source.slice(0, closingIdx) + insertion + source.slice(closingIdx);
+}

package/lib/engine/conflict.ts

@@ -0,0 +1,33 @@
+/**
+ * Conflict detection and Claude-based resolution helpers.
+ */
+
+/**
+ * Parse `git status --porcelain` output to find conflicted files.
+ * Conflict markers: UU (both modified), AA (both added), DD, AU, UA, DU, UD
+ */
+export function parseConflictFiles(statusOutput: string | null | undefined): string[] {
+  if (!statusOutput?.trim()) return [];
+  return statusOutput
+    .trim()
+    .split("\n")
+    .filter((line) => /^(UU|AA|DD|AU|UA|DU|UD)\s/.test(line))
+    .map((line) => line.slice(3).trim());
+}
+
+/**
+ * Build a Claude prompt to resolve merge conflicts.
+ */
+export function buildConflictPrompt(conflictFiles: string[]): string {
+  return [
+    "아래 파일들에 git merge 충돌이 발생했습니다.",
+    "각 파일의 충돌 마커(<<<<<<< ======= >>>>>>>)를 읽고,",
+    "두 버전의 의도를 모두 살려서 충돌을 해결해주세요.",
+    "해결 후 충돌 마커는 완전히 제거해야 합니다.",
+    "",
+    "충돌 파일 목록:",
+    ...conflictFiles.map((f) => `- ${f}`),
+    "",
+    "각 파일을 읽고 수정해주세요.",
+  ].join("\n");
+}

package/lib/engine/diagnostics.ts

@@ -0,0 +1,81 @@
+import { execSync } from "node:child_process";
+
+interface ProcessInfo {
+  feLogs?: string[];
+  feExitCode: number | null;
+}
+
+interface PlaygroundInfo {
+  fePort: number;
+}
+
+interface DiagnosticCheck {
+  name: string;
+  status: string;
+  detail: string;
+  guide: string | null;
+}
+
+function tryExec(cmd: string): string | null {
+  try {
+    return execSync(cmd, { encoding: "utf8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+  } catch {
+    return null;
+  }
+}
+
+function checkPortConflict(processInfo: ProcessInfo): DiagnosticCheck {
+  const combined = (processInfo.feLogs ?? []).join("");
+  const hit = /address already in use/i.test(combined);
+  return {
+    name: "port-conflict",
+    status: hit ? "error" : "ok",
+    detail: hit ? "다른 프로그램과 충돌이 발생했습니다." : "정상.",
+    guide: hit
+      ? '"중지" → "시작"을 눌러보세요. 계속되면 "삭제" 후 다시 만들어보세요.'
+      : null,
+  };
+}
+
+function checkFrontendExit(processInfo: ProcessInfo): DiagnosticCheck {
+  const { feExitCode, feLogs } = processInfo;
+
+  if (feExitCode === null || feExitCode === 0) {
+    return {
+      name: "frontend-exit",
+      status: "ok",
+      detail: feExitCode === 0 ? "Frontend가 정상 종료되었습니다." : "Frontend 프로세스 실행 중.",
+      guide: null,
+    };
+  }
+
+  const tail = (feLogs ?? []).join("").slice(-500);
+  const isModuleError = /MODULE_NOT_FOUND|Cannot find module/i.test(tail);
+  const guide = isModuleError
+    ? '필요한 패키지가 없어요. "처음부터 다시"를 눌러 의존성을 다시 설치해보세요.'
+    : '서버가 에러로 종료됐어요. "처음부터 다시"를 누르거나, "디버그" 버튼으로 로그를 복사해서 Claude에게 물어보세요.';
+  return {
+    name: "frontend-exit",
+    status: "error",
+    detail: `Frontend가 비정상 종료되었습니다 (코드 ${feExitCode}).`,
+    guide,
+  };
+}
+
+function checkFePort(pg: PlaygroundInfo): DiagnosticCheck {
+  const port = pg.fePort;
+  const output = tryExec(`lsof -i :${port} -t`);
+
+  return {
+    name: "fe-status",
+    status: output?.length ? "ok" : "warn",
+    detail: output?.length
+      ? "Frontend 서버가 실행 중입니다."
+      : "Frontend 서버가 응답하지 않습니다.",
+    guide: !output?.length ? '"시작" 버튼을 눌러보세요.' : null,
+  };
+}
+
+export async function buildDiagnostics(pg: PlaygroundInfo, processInfo: ProcessInfo): Promise<DiagnosticCheck[]> {
+  return [checkPortConflict(processInfo), checkFrontendExit(processInfo), checkFePort(pg)];
+}

package/lib/engine/naming.ts

@@ -0,0 +1,93 @@
+import { spawnSync } from "node:child_process";
+
+/**
+ * Generate a short English slug from a task description using AI.
+ * Returns null if AI is unavailable — caller should fallback to slugify().
+ */
+export function aiSlugify(description: string): string | null {
+  try {
+    const result = spawnSync(
+      "claude",
+      ["-p", "--model", "haiku", `Convert this task description to a kebab-case English slug. Rules: 3-5 words, max 30 chars, lowercase, descriptive (not just one word), no explanation, output ONLY the slug.\n\nExample: "로그인 버튼 색상 변경" → "login-button-color-change"\nExample: "대시보드 차트 추가" → "dashboard-chart-add"\n\nTask: "${description}"`],
+      { encoding: "utf8", stdio: "pipe", timeout: 10_000 },
+    );
+    if (result.status !== 0) return null;
+    const slug = (result.stdout ?? "").trim().toLowerCase().replace(/[^a-z0-9-]/g, "").replace(/^-+|-+$/g, "");
+    if (!slug || slug.length > 30) return null;
+    return slug;
+  } catch {
+    return null;
+  }
+}
+
+// Korean → romanized mappings for common dev terms
+const KOREAN_MAP: Record<string, string> = {
+  로그인: "login",
+  버튼: "button",
+  페이지: "page",
+  추가: "add",
+  수정: "fix",
+  삭제: "delete",
+  변경: "change",
+  개선: "improve",
+  색상: "color",
+  대시보드: "dashboard",
+  설정: "settings",
+  사용자: "user",
+  관리: "manage",
+  목록: "list",
+  검색: "search",
+  필터: "filter",
+  정렬: "sort",
+  알림: "notification",
+  권한: "permission",
+  기기: "device",
+  소프트웨어: "software",
+  자산: "asset",
+  구성원: "member",
+  보고서: "report",
+  차트: "chart",
+  테이블: "table",
+  폼: "form",
+  모달: "modal",
+  메뉴: "menu",
+  헤더: "header",
+  푸터: "footer",
+  사이드바: "sidebar",
+  카드: "card",
+  탭: "tab",
+  에러: "error",
+  로딩: "loading",
+  빈: "empty",
+  새: "new",
+  기존: "existing",
+};
+
+/**
+ * Convert a task description (Korean or English) to a kebab-case branch-safe slug.
+ * Max 50 chars.
+ */
+export function slugify(text: string): string {
+  let result: string = text.toLowerCase();
+
+  // Replace known Korean words with English
+  for (const [ko, en] of Object.entries(KOREAN_MAP)) {
+    result = result.replaceAll(ko, en);
+  }
+
+  // Remove remaining non-ASCII (unmapped Korean etc.)
+  result = result.replace(/[^\x00-\x7F]/g, "");
+
+  // Replace non-alphanumeric with hyphens
+  result = result.replace(/[^a-z0-9]+/g, "-");
+
+  // Clean up leading/trailing/double hyphens
+  result = result.replace(/^-+|-+$/g, "").replace(/-{2,}/g, "-");
+
+  // Truncate to 50 chars at word boundary
+  if (result.length > 50) {
+    result = result.slice(0, 50).replace(/-[^-]*$/, "");
+  }
+
+  return result || "camp";
+}

package/lib/engine/ports.ts

@@ -0,0 +1,61 @@
+import { execSync } from "node:child_process";
+import type { Camp, PortAllocation, PortStatus, PortsConfig } from "../types.ts";
+
+const portConfig: PortsConfig = {
+  fe: { base: 3000, slots: 8 },
+  be: { base: 8000, slots: 8 },
+};
+
+export function setPortConfig(config: Partial<PortsConfig>): void {
+  if (config?.fe) portConfig.fe = config.fe;
+  if (config?.be) portConfig.be = config.be;
+}
+
+export function portsForSlot(slot: number): { fePort: number; bePort: number } {
+  return {
+    fePort: portConfig.fe.base + slot,
+    bePort: portConfig.be.base + slot,
+  };
+}
+
+function isPortBusy(port: number): boolean {
+  try {
+    const out = execSync(`lsof -i :${port} -t 2>/dev/null`, { encoding: "utf8" }).trim();
+    return out.length > 0;
+  } catch {
+    return false;
+  }
+}
+
+export function scanPorts(): PortStatus[] {
+  const status: PortStatus[] = [];
+  const maxSlots = Math.max(portConfig.fe.slots, portConfig.be.slots);
+  for (let slot = 0; slot < maxSlots; slot++) {
+    const { fePort, bePort } = portsForSlot(slot);
+    status.push({
+      slot,
+      fePort,
+      feBusy: isPortBusy(fePort),
+      bePort,
+      beBusy: isPortBusy(bePort),
+    });
+  }
+  return status;
+}
+
+export function allocate(existingCamps: Pick<Camp, "slot">[]): PortAllocation {
+  const usedSlots = new Set(existingCamps.map((p) => p.slot));
+  const maxSlots = portConfig.fe.slots;
+
+  for (let slot = 1; slot < maxSlots; slot++) {
+    if (usedSlots.has(slot)) continue;
+    const { fePort, bePort } = portsForSlot(slot);
+    if (!isPortBusy(fePort) && !isPortBusy(bePort)) {
+      return { slot, fePort, bePort };
+    }
+  }
+
+  throw new Error("사용 가능한 포트가 없습니다. 다른 프로그램이 포트를 점유하고 있거나, 캠프를 정리해주세요.");
+}
+
+export function release(_name: string): void {}

package/lib/engine/pr.ts

@@ -0,0 +1,71 @@
+/**
+ * PR body generation helpers.
+ *
+ * buildFallbackPrBody — used when Claude CLI is unavailable.
+ * buildClaudePrPrompt — prompt fed to `claude -p` for a rich PR body.
+ */
+
+interface FallbackPrBodyOptions {
+  message: string;
+  actions: Array<{ description: string }>;
+  diffStat: string;
+}
+
+interface ClaudePrPromptOptions {
+  message: string;
+  diffStat: string;
+  diff: string;
+}
+
+/**
+ * Build a fallback PR body when Claude CLI is unavailable.
+ */
+export function buildFallbackPrBody({ message, actions, diffStat }: FallbackPrBodyOptions): string {
+  const lines: string[] = ["## Summary", "", message];
+
+  if (actions?.length > 0) {
+    lines.push("", "### 작업 내역");
+    for (const a of actions) {
+      lines.push(`- ${a.description}`);
+    }
+  }
+
+  if (diffStat?.trim()) {
+    lines.push("", "### 변경된 파일", "```", diffStat.trim(), "```");
+  }
+
+  lines.push("", "---", "_🏔 산장에서 보냄_");
+  return lines.join("\n");
+}
+
+/**
+ * Build a prompt for Claude to generate a rich PR body from the diff.
+ */
+export function buildClaudePrPrompt({ message, diffStat, diff }: ClaudePrPromptOptions): string {
+  return [
+    "You are writing a GitHub Pull Request description.",
+    'The author described the change as: "' + message + '"',
+    "",
+    "Here is the diff stat:",
+    diffStat || "(no stat)",
+    "",
+    "Here is the full diff (may be truncated):",
+    (diff || "").slice(0, 8000),
+    "",
+    "Write a PR body in this format:",
+    "## Summary",
+    "<2-3 bullet points explaining what changed and why>",
+    "",
+    "## Changes",
+    "<brief description of each modified file/component>",
+    "",
+    "## Test plan",
+    "<how to verify this works>",
+    "",
+    "---",
+    "_🏔 산장에서 보냄_",
+    "",
+    "Write in Korean if the commit message is Korean, English otherwise.",
+    "Be concise. No filler. Just the facts.",
+  ].join("\n");
+}