sanjang 0.3.3 → 0.3.5

package/dist/lib/engine/change-report.d.ts

@@ -0,0 +1,27 @@
+import type { ChangeReport, ChangeReportFile, ChangeReportWarning } from "../types.ts";
+type FileCategory = "ui" | "api" | "config" | "test" | "docs" | "other";
+/**
+ * Classify a file path into one of the known categories.
+ * Rules are checked in priority order: test > ui > api > docs > config > other
+ */
+export declare function categorizeFile(filePath: string): FileCategory;
+/**
+ * Detect warnings from a list of categorized files.
+ * Returns deduplicated warnings (one per type).
+ */
+export declare function detectWarnings(files: ChangeReportFile[]): ChangeReportWarning[];
+/**
+ * Build a ChangeReport from raw file list (path + status).
+ * summary and humanDescription are set to null — call generateReportSummary to enrich.
+ */
+export declare function buildChangeReport(rawFiles: {
+    path: string;
+    status: ChangeReportFile["status"];
+}[]): ChangeReport;
+/**
+ * Enrich a ChangeReport with AI-generated category-level descriptions.
+ * Each category gets human-readable bullet points explaining what changed.
+ * Tries `claude -p --model haiku` and falls back to file-based summary.
+ */
+export declare function generateReportSummary(diffStat: string, diff: string, report: ChangeReport): ChangeReport;
+export {};

package/dist/lib/engine/change-report.js

@@ -0,0 +1,233 @@
+import { spawnSync } from "node:child_process";
+import { basename, extname } from "node:path";
+/**
+ * Classify a file path into one of the known categories.
+ * Rules are checked in priority order: test > ui > api > docs > config > other
+ */
+export function categorizeFile(filePath) {
+    const name = basename(filePath);
+    const ext = extname(filePath).toLowerCase();
+    const lower = filePath.toLowerCase();
+    // 1. test
+    if (/\.(test|spec)\.[^.]+$/.test(lower))
+        return "test";
+    if (/[/\\](test|tests|__tests__|__mocks__|fixtures)[/\\]/.test(lower))
+        return "test";
+    if (/^(test|tests|__tests__|__mocks__|fixtures)[/\\]/.test(lower))
+        return "test";
+    // 2. ui
+    const uiExts = new Set([
+        ".css",
+        ".scss",
+        ".less",
+        ".sass",
+        ".styl",
+        ".html",
+        ".htm",
+        ".svg",
+        ".tsx",
+        ".jsx",
+        ".vue",
+        ".svelte",
+    ]);
+    if (uiExts.has(ext))
+        return "ui";
+    if (/[/\\](pages|views|components|layouts|styles|public)[/\\]/.test(lower))
+        return "ui";
+    if (/^(pages|views|components|layouts|styles|public)[/\\]/.test(lower))
+        return "ui";
+    // 3. api
+    if (/[/\\](api|routes|controllers|handlers|middleware|graphql|resolvers|schema)[/\\]/.test(lower))
+        return "api";
+    if (/^(api|routes|controllers|handlers|middleware|graphql|resolvers|schema)[/\\]/.test(lower))
+        return "api";
+    // files named "server" (any extension)
+    if (/[/\\]server\.[^/\\]+$/.test(lower) || /^server\.[^/\\]+$/.test(lower))
+        return "api";
+    // 4. docs
+    if (ext === ".md")
+        return "docs";
+    if (/[/\\]docs[/\\]/.test(lower) || /^docs[/\\]/.test(lower))
+        return "docs";
+    if (/^(README|CHANGELOG|LICENSE|CONTRIBUTING)(\.|$)/i.test(name))
+        return "docs";
+    // 5. config
+    const configPrefixes = [
+        "package",
+        "tsconfig",
+        "jest.config",
+        "vite.config",
+        "next.config",
+        "webpack.config",
+        "biome",
+        ".eslint",
+        ".prettier",
+        ".babel",
+    ];
+    const nameLower = name.toLowerCase();
+    if (configPrefixes.some((p) => nameLower.startsWith(p.toLowerCase())))
+        return "config";
+    if (name.startsWith("."))
+        return "config";
+    if ([".json", ".yaml", ".yml", ".toml"].includes(ext))
+        return "config";
+    // 6. other
+    return "other";
+}
+/**
+ * Detect warnings from a list of categorized files.
+ * Returns deduplicated warnings (one per type).
+ */
+export function detectWarnings(files) {
+    const seen = new Set();
+    const warnings = [];
+    const add = (type, message, file) => {
+        if (seen.has(type))
+            return;
+        seen.add(type);
+        warnings.push({ type, message, file });
+    };
+    for (const f of files) {
+        const p = f.path.toLowerCase();
+        const name = basename(f.path);
+        // env
+        if (/\.env($|\.)/.test(name.toLowerCase())) {
+            add("env", "환경 변수 파일이 변경되었습니다", f.path);
+        }
+        // db
+        if (/migrat|schema|\.sql|prisma/.test(p)) {
+            add("db", "데이터베이스 스키마 또는 마이그레이션이 변경되었습니다", f.path);
+        }
+        // infra
+        if (/dockerfile|docker-compose|\.github\/|deploy\/|[/\\]k8s[/\\]|^k8s[/\\]|terraform|infrastructure/.test(p)) {
+            add("infra", "인프라 설정이 변경되었습니다", f.path);
+        }
+        // config (package manager files)
+        if (/package\.json|package-lock|yarn\.lock|pnpm-lock/.test(p)) {
+            add("config", "패키지 의존성이 변경되었습니다", f.path);
+        }
+        // security
+        if (/auth|security|token|secret|credential|password/.test(p)) {
+            add("security", "보안 관련 파일이 변경되었습니다", f.path);
+        }
+    }
+    return warnings;
+}
+/**
+ * Build a ChangeReport from raw file list (path + status).
+ * summary and humanDescription are set to null — call generateReportSummary to enrich.
+ */
+export function buildChangeReport(rawFiles) {
+    const files = rawFiles.map((f) => ({
+        path: f.path,
+        status: f.status,
+        category: categorizeFile(f.path),
+    }));
+    const byCategory = {};
+    for (const f of files) {
+        const cat = f.category;
+        if (!byCategory[cat])
+            byCategory[cat] = [];
+        byCategory[cat].push(f);
+    }
+    const warnings = detectWarnings(files);
+    // 기본 카테고리 설명 — AI 없이도 즉시 표시
+    const categoryDetails = {};
+    for (const [cat, catFiles] of Object.entries(byCategory)) {
+        categoryDetails[cat] = catFiles.map((f) => {
+            const name = f.path.split("/").pop() || f.path;
+            return f.status === "새 파일" ? `${name} 추가됨` : `${name} 수정됨`;
+        });
+    }
+    return {
+        files,
+        totalCount: files.length,
+        byCategory,
+        warnings,
+        summary: null,
+        humanDescription: null,
+        categoryDetails,
+    };
+}
+/**
+ * Enrich a ChangeReport with AI-generated category-level descriptions.
+ * Each category gets human-readable bullet points explaining what changed.
+ * Tries `claude -p --model haiku` and falls back to file-based summary.
+ */
+export function generateReportSummary(diffStat, diff, report) {
+    const categoryNames = {
+        ui: "화면",
+        api: "서버/API",
+        config: "설정",
+        test: "테스트",
+        docs: "문서",
+        other: "기타",
+    };
+    const categoryList = Object.keys(report.byCategory)
+        .map((cat) => `${categoryNames[cat] || cat}: ${(report.byCategory[cat] ?? []).length}개`)
+        .join(", ");
+    const fallbackSummary = `${categoryList} 변경`;
+    // Build per-category diff sections for the prompt
+    const categoryDiffSections = Object.entries(report.byCategory)
+        .map(([cat, files]) => {
+        const fileList = files.map((f) => `  ${f.status} ${f.path}`).join("\n");
+        return `[${categoryNames[cat] || cat}]\n${fileList}`;
+    })
+        .join("\n\n");
+    const prompt = `너는 비개발자에게 코드 변경사항을 설명하는 도우미야.
+아래 git diff를 분석하고, 카테고리별로 "실제로 뭐가 바뀌었는지"를 설명해.
+
+규칙:
+- 파일명이 아니라 사용자 관점에서 뭐가 바뀌었는지 설명 (예: "로그인 버튼이 보라색으로 바뀌었어요")
+- 각 항목은 한국어, '~했어요/~됐어요' 체, 한 줄
+- 새 파일이면 "추가됐어요", 수정이면 구체적으로 뭐가 바뀌었는지
+
+카테고리별 파일:
+${categoryDiffSections}
+
+diff:
+${diff.slice(0, 4000)}
+
+JSON으로만 응답해 (다른 텍스트 없이):
+{"summary": "전체 한 줄 요약 (30자 이내)", "categories": {"ui": ["설명1", "설명2"], "api": ["설명1"], ...}}
+
+categories의 키는 반드시 다음 중 하나: ${Object.keys(report.byCategory).join(", ")}`;
+    try {
+        const result = spawnSync("claude", ["-p", prompt], {
+            encoding: "utf8",
+            timeout: 30_000,
+        });
+        if (result.status === 0 && result.stdout) {
+            const output = result.stdout.trim();
+            const jsonMatch = output.match(/\{[\s\S]*"summary"[\s\S]*"categories"[\s\S]*\}/);
+            if (jsonMatch) {
+                const parsed = JSON.parse(jsonMatch[0]);
+                if (parsed.summary && parsed.categories) {
+                    return {
+                        ...report,
+                        summary: parsed.summary,
+                        humanDescription: null,
+                        categoryDetails: parsed.categories,
+                    };
+                }
+            }
+        }
+    }
+    catch {
+        // Fall through to fallback
+    }
+    // Fallback: 파일 기반 설명 생성
+    const fallbackDetails = {};
+    for (const [cat, files] of Object.entries(report.byCategory)) {
+        fallbackDetails[cat] = files.map((f) => {
+            const name = f.path.split("/").pop() || f.path;
+            return f.status === "새 파일" ? `${name} 파일이 추가됐어요` : `${name} 파일이 수정됐어요`;
+        });
+    }
+    return {
+        ...report,
+        summary: fallbackSummary,
+        humanDescription: null,
+        categoryDetails: fallbackDetails,
+    };
+}

package/dist/lib/engine/diagnostics.js

@@ -14,9 +14,7 @@ function checkPortConflict(processInfo) {
         name: "port-conflict",
         status: hit ? "error" : "ok",
         detail: hit ? "다른 프로그램과 충돌이 발생했습니다." : "정상.",
-        guide: hit
-            ? '"중지" → "시작"을 눌러보세요. 계속되면 "삭제" 후 다시 만들어보세요.'
-            : null,
+        guide: hit ? '"중지" → "시작"을 눌러보세요. 계속되면 "삭제" 후 다시 만들어보세요.' : null,
     };
 }
 function checkFrontendExit(processInfo) {
@@ -47,9 +45,7 @@ function checkFePort(pg) {
     return {
         name: "fe-status",
         status: output?.length ? "ok" : "warn",
-        detail: output?.length
-            ? "Frontend 서버가 실행 중입니다."
-            : "Frontend 서버가 응답하지 않습니다.",
+        detail: output?.length ? "Frontend 서버가 실행 중입니다." : "Frontend 서버가 응답하지 않습니다.",
         guide: !output?.length ? '"시작" 버튼을 눌러보세요.' : null,
     };
 }

package/dist/lib/engine/main-server.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Main branch dev server manager.
+ * Runs a dev server from the project root for side-by-side comparison preview.
+ */
+import type { SanjangConfig } from "../types.ts";
+interface MainServerState {
+    status: "stopped" | "starting" | "running" | "error";
+    port: number | null;
+    error: string | null;
+}
+export declare function getMainServerState(): MainServerState;
+export declare function getMainServerLogs(): string[];
+export declare function startMainServer(projectRoot: string, config: SanjangConfig, onReady?: (port: number) => void): Promise<void>;
+export declare function stopMainServer(): void;
+export {};

package/dist/lib/engine/main-server.js

@@ -0,0 +1,111 @@
+/**
+ * Main branch dev server manager.
+ * Runs a dev server from the project root for side-by-side comparison preview.
+ */
+import { spawn } from "node:child_process";
+import { createConnection } from "node:net";
+let state = { status: "stopped", port: null, error: null };
+let proc = null;
+let logs = [];
+export function getMainServerState() {
+    return { ...state };
+}
+export function getMainServerLogs() {
+    return [...logs];
+}
+export async function startMainServer(projectRoot, config, onReady) {
+    if (state.status === "running" || state.status === "starting")
+        return;
+    state = { status: "starting", port: null, error: null };
+    logs = [];
+    const basePort = config.dev.port + 100;
+    const cmdParts = config.dev.command.split(/\s+/);
+    const cmd = cmdParts[0];
+    const args = cmdParts.slice(1);
+    if (config.dev.portFlag) {
+        args.push(config.dev.portFlag, String(basePort));
+    }
+    const cwd = config.dev.cwd
+        ? config.dev.cwd.startsWith("/")
+            ? config.dev.cwd
+            : `${projectRoot}/${config.dev.cwd}`
+        : projectRoot;
+    proc = spawn(cmd, args, {
+        cwd,
+        stdio: ["ignore", "pipe", "pipe"],
+        env: { ...process.env, ...config.dev.env, FORCE_COLOR: "0" },
+        shell: true,
+    });
+    proc.stdout?.on("data", (chunk) => {
+        const line = chunk.toString();
+        logs.push(line);
+        if (logs.length > 100)
+            logs.shift();
+    });
+    proc.stderr?.on("data", (chunk) => {
+        const line = chunk.toString();
+        logs.push(line);
+        if (logs.length > 100)
+            logs.shift();
+    });
+    proc.on("close", (code) => {
+        if (state.status !== "stopped") {
+            state = { status: "stopped", port: null, error: code ? `exit ${code}` : null };
+        }
+        proc = null;
+    });
+    proc.on("error", (err) => {
+        state = { status: "error", port: null, error: err.message };
+        proc = null;
+    });
+    const detectedPort = await detectMainPort(logs, basePort, 15_000);
+    if (detectedPort) {
+        state = { status: "running", port: detectedPort, error: null };
+        onReady?.(detectedPort);
+    }
+    else {
+        state = { status: "error", port: null, error: "포트를 감지하지 못했어요" };
+    }
+}
+export function stopMainServer() {
+    state = { status: "stopped", port: null, error: null };
+    if (proc) {
+        proc.kill("SIGTERM");
+        proc = null;
+    }
+    logs = [];
+}
+function detectMainPort(logLines, _fallbackPort, timeoutMs) {
+    return new Promise((resolve) => {
+        const deadline = Date.now() + timeoutMs;
+        const portRe = /https?:\/\/localhost:(\d+)/;
+        function check() {
+            for (const line of logLines) {
+                const match = portRe.exec(line);
+                if (match?.[1]) {
+                    const port = parseInt(match[1], 10);
+                    const sock = createConnection({ port, host: "localhost" });
+                    sock.once("connect", () => {
+                        sock.destroy();
+                        resolve(port);
+                    });
+                    sock.once("error", () => {
+                        sock.destroy();
+                        if (Date.now() < deadline)
+                            setTimeout(check, 1000);
+                        else
+                            resolve(port);
+                    });
+                    return;
+                }
+            }
+            if (Date.now() >= deadline) {
+                resolve(null);
+            }
+            else {
+                setTimeout(check, 1000);
+            }
+        }
+        check();
+    });
+}

package/dist/lib/engine/naming.js

@@ -5,10 +5,19 @@ import { spawnSync } from "node:child_process";
  */
 export function aiSlugify(description) {
     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 });
+        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, "");
+        const slug = (result.stdout ?? "")
+            .trim()
+            .toLowerCase()
+            .replace(/[^a-z0-9-]/g, "")
+            .replace(/^-+|-+$/g, "");
         if (!slug || slug.length > 30)
             return null;
         return slug;

package/dist/lib/engine/pr.js

@@ -27,7 +27,7 @@ export function buildFallbackPrBody({ message, actions, diffStat }) {
 export function buildClaudePrPrompt({ message, diffStat, diff }) {
     return [
         "You are writing a GitHub Pull Request description.",
-        'The author described the change as: "' + message + '"',
+        `The author described the change as: "${message}"`,
         "",
         "Here is the diff stat:",
         diffStat || "(no stat)",

package/dist/lib/engine/process.js

@@ -24,7 +24,10 @@ function detectPortFromStdout(logs, timeoutMs) {
                     const port = parseInt(match[1], 10);
                     // Wait briefly for the port to actually be ready
                     const sock = createConnection({ port, host: "localhost" });
-                    sock.once("connect", () => { sock.destroy(); resolve(port); });
+                    sock.once("connect", () => {
+                        sock.destroy();
+                        resolve(port);
+                    });
                     sock.once("error", () => {
                         sock.destroy();
                         // Port printed but not ready yet, retry

package/dist/lib/engine/self-heal.js

@@ -1,6 +1,6 @@
-import { existsSync, copyFileSync, mkdirSync } from "node:fs";
-import { join, dirname } from "node:path";
 import { execSync } from "node:child_process";
+import { copyFileSync, existsSync, mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
 const PATTERNS = [
     {
         test: /Cannot find module|MODULE_NOT_FOUND/i,
@@ -64,7 +64,12 @@ export function executeHeal(action, campPath, projectRoot, setupCommand, copyFil
             if (!setupCommand)
                 return { action, success: false, detail: "설치 명령이 없습니다." };
             try {
-                execSync(setupCommand, { cwd: campPath, stdio: "pipe", timeout: 120_000, shell: true });
+                execSync(setupCommand, {
+                    cwd: campPath,
+                    stdio: "pipe",
+                    timeout: 120_000,
+                    shell: true,
+                });
                 return { action, success: true };
             }
             catch {
@@ -82,10 +87,16 @@ export function executeHeal(action, campPath, projectRoot, setupCommand, copyFil
                         copyFileSync(src, dst);
                         copied++;
                     }
-                    catch { /* skip */ }
+                    catch {
+                        /* skip */
+                    }
                 }
             }
-            return { action, success: copied > 0, detail: copied > 0 ? `${copied}개 파일 복사됨` : "복사할 파일이 없습니다." };
+            return {
+                action,
+                success: copied > 0,
+                detail: copied > 0 ? `${copied}개 파일 복사됨` : "복사할 파일이 없습니다.",
+            };
         }
         case "restart":
             // Restart is handled by the caller (stop + start)

package/dist/lib/engine/smart-init.js

@@ -32,7 +32,7 @@ export function deepFindEnvFiles(projectRoot, maxDepth = 4) {
 export function detectSetupIssues(projectRoot) {
     const issues = [];
     // 1. Check for env variable references without .env files
-    const hasEnvFile = ENV_PATTERNS.some(f => existsSync(join(projectRoot, f)));
+    const hasEnvFile = ENV_PATTERNS.some((f) => existsSync(join(projectRoot, f)));
     if (!hasEnvFile) {
         const envRefFound = scanForEnvReferences(projectRoot);
         if (envRefFound) {
@@ -52,7 +52,7 @@ export function detectSetupIssues(projectRoot) {
     }
     // 3. Check for missing lockfile
     const lockfiles = ["package-lock.json", "yarn.lock", "pnpm-lock.yaml", "bun.lockb", "bun.lock"];
-    if (!lockfiles.some(f => existsSync(join(projectRoot, f)))) {
+    if (!lockfiles.some((f) => existsSync(join(projectRoot, f)))) {
         issues.push({
             type: "missing-lockfile",
             message: "lockfile이 없습니다. 의존성 설치가 느릴 수 있습니다.",
@@ -97,7 +97,10 @@ function scanForEnvReferences(dir, depth = 0) {
                 continue;
             }
         }
-        if (entry.isDirectory() && !SKIP_DIRS.has(entry.name) && !entry.name.startsWith(".") && entry.name !== "node_modules") {
+        if (entry.isDirectory() &&
+            !SKIP_DIRS.has(entry.name) &&
+            !entry.name.startsWith(".") &&
+            entry.name !== "node_modules") {
             if (scanForEnvReferences(join(dir, entry.name), depth + 1))
                 return true;
         }
@@ -129,9 +132,7 @@ function countTurboApps(root) {
                 if (scripts?.dev)
                     count++;
             }
-            catch {
-                continue;
-            }
+            catch { }
         }
     }
     return count;

package/dist/lib/engine/state.js

@@ -29,7 +29,7 @@ function read() {
 function write(records) {
     ensureDir();
     // Atomic write: write to temp file then rename to prevent corruption
-    const tmp = stateFile() + ".tmp";
+    const tmp = `${stateFile()}.tmp`;
     writeFileSync(tmp, JSON.stringify(records, null, 2), "utf8");
     renameSync(tmp, stateFile());
 }

package/dist/lib/engine/suggest.js

@@ -97,10 +97,7 @@ async function fetchRecentCommits(cwd) {
 export async function suggestTasks(projectRoot) {
     const results = [];
     // gh-dependent fetches — tolerate failure (gh not installed / no repo)
-    const [issues, prs] = await Promise.allSettled([
-        fetchIssues(projectRoot),
-        fetchMyPrs(projectRoot),
-    ]);
+    const [issues, prs] = await Promise.allSettled([fetchIssues(projectRoot), fetchMyPrs(projectRoot)]);
     // PRs first — most actionable ("이어하기")
     if (prs.status === "fulfilled") {
         results.push(...prs.value);

package/dist/lib/engine/warp.d.ts

@@ -15,7 +15,7 @@ export declare function detectWarp(): WarpDetectResult;
  * Opens as a new tab in the existing Warp window (not a new window).
  * The tab title naturally shows the directory name (= camp name).
  */
-export declare function openWarpTab(campName: string, worktreePath: string): WarpOpenResult;
+export declare function openWarpTab(_campName: string, worktreePath: string): WarpOpenResult;
 /**
  * No-op cleanup (launch config removed — using open -a instead).
  */

package/dist/lib/engine/warp.js

@@ -12,7 +12,7 @@ export function detectWarp() {
  * Opens as a new tab in the existing Warp window (not a new window).
  * The tab title naturally shows the directory name (= camp name).
  */
-export function openWarpTab(campName, worktreePath) {
+export function openWarpTab(_campName, worktreePath) {
     const { installed } = detectWarp();
     if (!installed) {
         return { opened: false, terminal: null, path: worktreePath };