sanjang 0.3.0 → 0.3.2

package/dist/lib/types.d.ts

@@ -0,0 +1,109 @@
+export interface Camp {
+    name: string;
+    branch: string;
+    slot: number;
+    fePort: number;
+    bePort: number;
+    url?: string;
+    status: "stopped" | "starting" | "starting-frontend" | "running" | "setting-up" | "error";
+    description?: string;
+    baseCommit?: string;
+    parentBranch?: string;
+}
+export interface DevConfig {
+    command: string;
+    port: number;
+    portFlag: string | null;
+    cwd: string;
+    env: Record<string, string>;
+}
+export interface BackendConfig {
+    command: string;
+    port: number;
+    healthCheck?: string;
+    cwd?: string;
+    env?: Record<string, string>;
+}
+export interface PortRange {
+    base: number;
+    slots: number;
+}
+export interface PortsConfig {
+    fe: PortRange;
+    be: PortRange;
+}
+export interface SanjangConfig {
+    dev: DevConfig;
+    setup: string | null;
+    copyFiles: string[];
+    backend: BackendConfig | null;
+    ports: PortsConfig;
+    _autoDetected?: boolean;
+}
+export interface PortAllocation {
+    slot: number;
+    fePort: number;
+    bePort: number;
+}
+export interface PortStatus extends PortAllocation {
+    feBusy: boolean;
+    beBusy: boolean;
+}
+export interface CacheValidation {
+    valid: boolean;
+    reason?: string;
+}
+export interface CacheBuildResult {
+    success: boolean;
+    error?: string;
+    duration: number;
+}
+export interface CacheApplyResult {
+    applied: boolean;
+    reason?: string;
+    duration?: number;
+    count?: number;
+}
+export interface LockfileInfo {
+    path: string;
+    name: string;
+}
+export interface DetectedProject {
+    framework: string;
+    dev: DevConfig;
+    setup: string | null;
+    copyFiles: string[];
+    _note?: string;
+}
+export interface DetectedApp {
+    dir: string;
+    framework: string;
+    detected: DetectedProject;
+}
+export interface GenerateConfigResult {
+    created: boolean;
+    framework?: string;
+    configPath?: string;
+    message: string;
+}
+export interface SnapshotInfo {
+    name: string;
+    date: string;
+    message: string;
+}
+export interface DiagnosticsResult {
+    status: string;
+    checks: DiagnosticsCheck[];
+}
+export interface DiagnosticsCheck {
+    name: string;
+    ok: boolean;
+    message: string;
+}
+export type BroadcastMessage = {
+    type: string;
+    name?: string;
+    source?: string;
+    data?: unknown;
+};
+export type EventCallback = (event: BroadcastMessage) => void;

package/dist/lib/types.js

@@ -0,0 +1,2 @@
+// Central type definitions for Sanjang
+export {};

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "sanjang",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Local dev environment manager for vibe coders",
   "type": "module",
   "bin": {
-    "sanjang": "./bin/sanjang.js"
+    "sanjang": "./dist/bin/sanjang.js"
   },
   "scripts": {
     "start": "node bin/sanjang.js",
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build && echo '#!/usr/bin/env node' | cat - dist/bin/sanjang.js > dist/bin/_tmp && mv dist/bin/_tmp dist/bin/sanjang.js",
     "test": "node --experimental-transform-types --test test/**/*.test.ts bin/__tests__/*.test.ts",
     "typecheck": "tsc --noEmit",
     "lint": "npx @biomejs/biome check lib/ test/ bin/"
@@ -15,7 +17,6 @@
   "dependencies": {
     "express": "^4.19.2",
     "simple-git": "^3.27.0",
-    "user": "^0.0.0",
     "ws": "^8.18.0"
   },
   "engines": {
@@ -33,8 +34,7 @@
     "local-dev"
   ],
   "files": [
-    "bin/",
-    "lib/",
+    "dist/",
     "dashboard/",
     "templates/"
   ],

package/bin/__tests__/sanjang.test.ts

@@ -1,42 +0,0 @@
-// Tests for bin/sanjang.js CLI flag parsing logic
-
-import assert from "node:assert/strict";
-import { describe, it } from "node:test";
-
-describe("sanjang CLI flag parsing", () => {
-  it("detects --no-start flag in args array", () => {
-    const args = ["init", "--no-start"];
-    const noStart = args.includes("--no-start");
-    assert.equal(noStart, true);
-  });
-
-  it("does not detect --no-start when absent", () => {
-    const args = ["init"];
-    const noStart = args.includes("--no-start");
-    assert.equal(noStart, false);
-  });
-
-  it("parses --port value correctly", () => {
-    const args = ["init", "--port", "5000"];
-    let port = 4000;
-    for (let i = 0; i < args.length; i++) {
-      if (args[i] === "--port" && args[i + 1]) {
-        port = parseInt(args[i + 1]!);
-        i++;
-      }
-    }
-    assert.equal(port, 5000);
-  });
-
-  it("uses default port 4000 when --port not specified", () => {
-    const args = ["init"];
-    let port = 4000;
-    for (let i = 0; i < args.length; i++) {
-      if (args[i] === "--port" && args[i + 1]) {
-        port = parseInt(args[i + 1]!);
-        i++;
-      }
-    }
-    assert.equal(port, 4000);
-  });
-});

package/bin/sanjang.js

@@ -1,17 +0,0 @@
-#!/usr/bin/env node
-// Shell wrapper — delegates to the TypeScript entry point
-import { fileURLToPath } from 'node:url';
-import { dirname, join } from 'node:path';
-import { execFileSync } from 'node:child_process';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const tsEntry = join(__dirname, 'sanjang.ts');
-
-try {
-  execFileSync(process.execPath, ['--experimental-transform-types', tsEntry, ...process.argv.slice(2)], {
-    stdio: 'inherit',
-    env: { ...process.env, NODE_NO_WARNINGS: '1' },
-  });
-} catch (err) {
-  process.exit(err?.status ?? 1);
-}

package/bin/sanjang.ts

@@ -1,144 +0,0 @@
-import { execSync } from "node:child_process";
-import { existsSync } from "node:fs";
-import { resolve } from "node:path";
-
-const args: string[] = process.argv.slice(2);
-const command: string | undefined = args[0];
-
-// Parse options
-let projectRoot: string = process.cwd();
-let port: number = 4000;
-let force: boolean = false;
-
-for (let i = 0; i < args.length; i++) {
-  if (args[i] === "--project" && args[i + 1]) {
-    projectRoot = resolve(args[i + 1]!);
-    i++;
-  }
-  if (args[i] === "--port" && args[i + 1]) {
-    port = parseInt(args[i + 1]!);
-    i++;
-  }
-  if (args[i] === "--force") {
-    force = true;
-  }
-}
-
-// Find git root
-try {
-  projectRoot = execSync("git rev-parse --show-toplevel", {
-    cwd: projectRoot,
-    encoding: "utf8",
-    stdio: ["pipe", "pipe", "pipe"],
-  }).trim();
-} catch {
-  console.error("⛰ 산장: git 저장소를 찾을 수 없습니다.");
-  console.error("  git 저장소 안에서 실행해주세요.");
-  process.exit(1);
-}
-
-if (command === "init") {
-  const { generateConfig, detectApps } = await import("../lib/config.ts");
-
-  // Detect apps in subdirectories
-  const apps = detectApps(projectRoot);
-  let appDir: string | undefined;
-
-  if (apps.length >= 2) {
-    // Multi-app interview
-    console.log("");
-    console.log("⛰ 여러 앱이 감지되었습니다:");
-    for (let i = 0; i < apps.length; i++) {
-      console.log(`  ${i + 1}) ${apps[i]!.dir}/\t(${apps[i]!.framework})`);
-    }
-    console.log("");
-
-    const { createInterface } = await import("node:readline");
-    const rl = createInterface({ input: process.stdin, output: process.stdout });
-    const answer = await new Promise<string>((resolve) => {
-      rl.question("  어떤 앱을 띄울까요? [번호]: ", resolve);
-    });
-    rl.close();
-
-    const idx = parseInt(answer) - 1;
-    if (idx < 0 || idx >= apps.length || isNaN(idx)) {
-      console.error("⛰ 잘못된 선택입니다.");
-      process.exit(1);
-    }
-    appDir = apps[idx]!.dir;
-    console.log(`  → ${appDir}/ (${apps[idx]!.framework}) 선택됨`);
-  } else if (apps.length === 1) {
-    appDir = apps[0]!.dir;
-  }
-
-  const result = generateConfig(projectRoot, { appDir, force });
-
-  if (result.created) {
-    console.log(`⛰ ${result.message}`);
-    console.log(`  프레임워크: ${result.framework}`);
-    console.log(`  설정 파일: ${result.configPath}`);
-  } else {
-    console.log(`⛰ ${result.message}`);
-  }
-
-  // Add .sanjang to .gitignore if not present
-  const gitignorePath = resolve(projectRoot, ".gitignore");
-  if (existsSync(gitignorePath)) {
-    const { readFileSync, appendFileSync } = await import("node:fs");
-    const content = readFileSync(gitignorePath, "utf8");
-    if (!content.includes(".sanjang")) {
-      appendFileSync(gitignorePath, "\n# Sanjang local dev camps\n.sanjang/\n");
-      console.log("  .gitignore에 .sanjang/ 추가됨");
-    }
-  }
-
-  // Prebuild dependency cache
-  const { loadConfig } = await import("../lib/config.ts");
-  const initConfig = await loadConfig(projectRoot);
-  if (initConfig.setup) {
-    console.log("");
-    console.log("  의존성 캐시를 빌드합니다...");
-    const { buildCache } = await import("../lib/engine/cache.ts");
-    const cacheResult = await buildCache(projectRoot, initConfig, (msg: string) => {
-      console.log(`  ${msg}`);
-    });
-    if (cacheResult.success) {
-      console.log(`  캐시 빌드 완료 ✓ (${(cacheResult.duration / 1000).toFixed(1)}초)`);
-    } else {
-      console.log(`  ⚠️ 캐시 빌드 실패: ${cacheResult.error}`);
-      console.log("  캠프 생성 시 일반 설치를 사용합니다.");
-    }
-  }
-
-  // Auto-start server unless --no-start
-  const noStart = args.includes("--no-start");
-  if (!noStart) {
-    console.log("");
-    console.log("  서버를 시작합니다...");
-    const { startServer } = await import("../lib/server.ts");
-    await startServer(projectRoot, { port });
-  } else {
-    console.log("");
-    console.log("  다음 단계: sanjang 또는 npx sanjang 으로 서버를 시작하세요.");
-  }
-} else if (command === "help" || command === "--help" || command === "-h") {
-  console.log(`
-⛰ 산장 (Sanjang) — 바이브코더를 위한 로컬 개발 환경 매니저
-
-사용법:
-  sanjang              서버 시작 (대시보드: http://localhost:4000)
-  sanjang init         프로젝트 분석 → sanjang.config.js 생성
-  sanjang help         이 도움말
-
-옵션:
-  --port <N>           대시보드 포트 (기본: 4000)
-  --project <path>     프로젝트 경로 (기본: 현재 디렉토리)
-  --force              기존 설정을 덮어쓰고 다시 생성
-
-자세히: https://github.com/paul-sherpas/sanjang
-`);
-} else {
-  // Default: start server
-  const { startServer } = await import("../lib/server.ts");
-  await startServer(projectRoot, { port });
-}

package/lib/config.ts

@@ -1,337 +0,0 @@
-import { existsSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-import { pathToFileURL } from "node:url";
-import type { DetectedApp, DetectedProject, GenerateConfigResult, SanjangConfig } from "./types.ts";
-import { deepFindEnvFiles, detectSetupIssues } from "./engine/smart-init.ts";
-
-const CONFIG_FILE: string = "sanjang.config.js";
-
-const DEFAULTS: SanjangConfig = {
-  dev: {
-    command: "npm run dev",
-    port: 3000,
-    portFlag: "--port",
-    cwd: ".",
-    env: {},
-  },
-  setup: null,
-  copyFiles: [],
-  backend: null,
-  ports: {
-    fe: { base: 3000, slots: 8 },
-    be: { base: 8000, slots: 8 },
-  },
-};
-
-/**
- * Load sanjang.config.js from project root.
- * Returns merged config with defaults.
- */
-export async function loadConfig(projectRoot: string): Promise<SanjangConfig> {
-  const configPath = join(projectRoot, CONFIG_FILE);
-
-  if (!existsSync(configPath)) {
-    console.warn("⚠️ sanjang.config.js를 찾을 수 없습니다. 기본 설정을 사용합니다.");
-    console.warn("  → sanjang init 으로 프로젝트에 맞는 설정을 생성하세요.");
-    return { ...DEFAULTS, _autoDetected: false };
-  }
-
-  try {
-    const mod = await import(pathToFileURL(configPath).href);
-    const userConfig = mod.default || mod;
-    return mergeConfig(userConfig);
-  } catch (err) {
-    console.error(`sanjang.config.js 로드 실패: ${(err as Error).message}`);
-    return { ...DEFAULTS, _autoDetected: false };
-  }
-}
-
-function mergeConfig(user: Record<string, unknown>): SanjangConfig {
-  const config: SanjangConfig = { ...DEFAULTS };
-
-  if (typeof user.dev === "string") {
-    config.dev = { ...DEFAULTS.dev, command: user.dev };
-  } else if (user.dev) {
-    config.dev = { ...DEFAULTS.dev, ...(user.dev as Partial<SanjangConfig["dev"]>) };
-  }
-
-  if (user.setup) config.setup = user.setup as string;
-  if (user.copyFiles) config.copyFiles = user.copyFiles as string[];
-  if (user.backend) config.backend = user.backend as SanjangConfig["backend"];
-  if (user.ports) {
-    const userPorts = user.ports as Partial<SanjangConfig["ports"]>;
-    config.ports = {
-      fe: { ...DEFAULTS.ports.fe, ...userPorts.fe },
-      be: { ...DEFAULTS.ports.be, ...userPorts.be },
-    };
-  }
-
-  return config;
-}
-
-/**
- * Auto-detect project type and generate config.
- */
-export function detectProject(projectRoot: string): DetectedProject {
-  const has = (f: string): boolean => existsSync(join(projectRoot, f));
-  const readJson = (f: string): Record<string, unknown> | null => {
-    try {
-      return JSON.parse(readFileSync(join(projectRoot, f), "utf8")) as Record<string, unknown>;
-    } catch {
-      return null;
-    }
-  };
-
-  // Framework detection
-  if (has("next.config.js") || has("next.config.mjs") || has("next.config.ts")) {
-    return {
-      framework: "Next.js",
-      dev: { command: "npx next dev", port: 3000, portFlag: "-p", cwd: ".", env: {} },
-      setup: has("bun.lockb") ? "bun install" : has("pnpm-lock.yaml") ? "pnpm install" : "npm install",
-      copyFiles: findEnvFiles(projectRoot),
-    };
-  }
-
-  if (has("nuxt.config.js") || has("nuxt.config.ts")) {
-    return {
-      framework: "Nuxt",
-      dev: { command: "npx nuxt dev", port: 3000, portFlag: "--port", cwd: ".", env: {} },
-      setup: detectPackageManager(projectRoot),
-      copyFiles: findEnvFiles(projectRoot),
-    };
-  }
-
-  if (has("svelte.config.js") || has("svelte.config.ts")) {
-    return {
-      framework: "SvelteKit",
-      dev: { command: "npx vite dev", port: 5173, portFlag: "--port", cwd: ".", env: {} },
-      setup: detectPackageManager(projectRoot),
-      copyFiles: findEnvFiles(projectRoot),
-    };
-  }
-
-  if (has("angular.json")) {
-    return {
-      framework: "Angular",
-      dev: { command: "npx ng serve", port: 4200, portFlag: "--port", cwd: ".", env: {} },
-      setup: "npm install",
-      copyFiles: findEnvFiles(projectRoot),
-    };
-  }
-
-  if (has("vite.config.js") || has("vite.config.ts") || has("vite.config.mjs")) {
-    return {
-      framework: "Vite",
-      dev: { command: "npx vite dev", port: 5173, portFlag: "--port", cwd: ".", env: {} },
-      setup: detectPackageManager(projectRoot),
-      copyFiles: findEnvFiles(projectRoot),
-    };
-  }
-
-  // ClojureScript / shadow-cljs (root or common subdirectories)
-  const shadowDirs = [".", "frontend", "client", "web", "app"];
-  for (const dir of shadowDirs) {
-    const prefix = dir === "." ? "" : `${dir}/`;
-    if (has(`${prefix}shadow-cljs.edn`)) {
-      const hasBb = has(`${prefix}bb.edn`);
-      return {
-        framework: "shadow-cljs",
-        dev: { command: hasBb ? "bb dev" : "npx shadow-cljs watch app", port: 3000, portFlag: null, cwd: dir, env: {} },
-        setup: "npm install",
-        copyFiles: findEnvFiles(projectRoot),
-      };
-    }
-  }
-
-  // Monorepo detection
-  if (has("turbo.json")) {
-    const mainApp = detectTurboMainApp(projectRoot);
-    const filter = mainApp ? ` --filter=${mainApp.name}` : "";
-    const port = mainApp?.port ?? 3000;
-    return {
-      framework: "Turborepo",
-      dev: { command: `npx turbo run dev${filter}`, port, portFlag: null, cwd: ".", env: {} },
-      setup: detectPackageManager(projectRoot),
-      copyFiles: findEnvFiles(projectRoot),
-      _note: mainApp
-        ? `Turborepo: filtered to ${mainApp.name} (port ${port}).`
-        : "Turborepo detected. You may need to adjust the dev command to filter a specific app.",
-    };
-  }
-
-  // Fallback: package.json scripts
-  const pkg = readJson("package.json");
-  if ((pkg?.scripts as Record<string, unknown> | undefined)?.dev) {
-    return {
-      framework: "Node.js",
-      dev: { command: "npm run dev", port: 3000, portFlag: "--port", cwd: ".", env: {} },
-      setup: detectPackageManager(projectRoot),
-      copyFiles: findEnvFiles(projectRoot),
-    };
-  }
-
-  return {
-    framework: "unknown",
-    dev: { command: "npm run dev", port: 3000, portFlag: "--port", cwd: ".", env: {} },
-    setup: "npm install",
-    copyFiles: [],
-  };
-}
-
-/**
- * Scan first-level subdirectories for app candidates.
- * Returns array of { dir, framework, detected } sorted by dir name.
- */
-export function detectApps(projectRoot: string): DetectedApp[] {
-  const entries = readdirSync(projectRoot, { withFileTypes: true });
-  const ignore = new Set(["node_modules", ".git", ".sanjang", "dist", "build", ".next", ".nuxt"]);
-
-  const apps: DetectedApp[] = [];
-  for (const entry of entries) {
-    if (!entry.isDirectory()) continue;
-    if (entry.name.startsWith(".") || ignore.has(entry.name)) continue;
-
-    const subPath = join(projectRoot, entry.name);
-    const detected = detectProject(subPath);
-    if (detected.framework === "unknown") continue;
-
-    apps.push({
-      dir: entry.name,
-      framework: detected.framework,
-      detected,
-    });
-  }
-
-  return apps.sort((a, b) => a.dir.localeCompare(b.dir));
-}
-
-interface TurboAppInfo {
-  name: string;
-  port: number;
-}
-
-function detectTurboMainApp(root: string): TurboAppInfo | null {
-  // Scan apps/*/package.json for the main app (has dev script with --port or vite/next)
-  const appDirs = ["apps", "packages"];
-  const candidates: TurboAppInfo[] = [];
-
-  for (const dir of appDirs) {
-    const base = join(root, dir);
-    if (!existsSync(base)) continue;
-    let entries;
-    try { entries = readdirSync(base, { withFileTypes: true }); } catch { continue; }
-    for (const entry of entries) {
-      if (!entry.isDirectory()) continue;
-      // Skip storybook, demo, docs apps
-      if (/storybook|demo|docs|e2e|test/i.test(entry.name)) continue;
-      const pkgPath = join(base, entry.name, "package.json");
-      if (!existsSync(pkgPath)) continue;
-      try {
-        const pkg = JSON.parse(readFileSync(pkgPath, "utf8")) as Record<string, unknown>;
-        const scripts = pkg.scripts as Record<string, string> | undefined;
-        const devScript = scripts?.dev;
-        if (!devScript) continue;
-        const portMatch = devScript.match(/--port\s+(\d+)/);
-        const port = portMatch?.[1] ? parseInt(portMatch[1], 10) : 3000;
-        candidates.push({ name: entry.name, port });
-      } catch { continue; }
-    }
-  }
-
-  // Prefer app with explicit port, then first candidate
-  return candidates.find(c => c.port !== 3000) ?? candidates[0] ?? null;
-}
-
-function detectPackageManager(root: string): string {
-  if (existsSync(join(root, "bun.lockb")) || existsSync(join(root, "bun.lock"))) return "bun install";
-  if (existsSync(join(root, "pnpm-lock.yaml"))) return "pnpm install";
-  if (existsSync(join(root, "yarn.lock"))) return "yarn install";
-  return "npm install";
-}
-
-function findEnvFiles(root: string): string[] {
-  const envFiles = [".env", ".env.local", ".env.development", ".env.development.local"];
-  return envFiles.filter((f) => existsSync(join(root, f)));
-}
-
-export function generateConfig(
-  projectRoot: string,
-  options: { appDir?: string; force?: boolean } = {},
-): GenerateConfigResult {
-  const { appDir, force } = options;
-  const configPath = join(projectRoot, CONFIG_FILE);
-
-  if (existsSync(configPath) && !force) {
-    return { created: false, message: "sanjang.config.js already exists." };
-  }
-
-  // Detect from selected app subdirectory or root
-  const detectRoot = appDir ? join(projectRoot, appDir) : projectRoot;
-  const detected = detectProject(detectRoot);
-
-  // Override cwd and setup for subdirectory apps
-  if (appDir && appDir !== ".") {
-    detected.dev.cwd = appDir;
-    if (detected.setup) {
-      detected.setup = `cd '${appDir.replace(/'/g, "'\\''")}' && ${detected.setup}`;
-    }
-  }
-
-  // Smart env detection — scan entire project tree, not just root
-  detected.copyFiles = deepFindEnvFiles(projectRoot).filter(
-    // Exclude .env.example, .env.test, .env.template
-    (f) => !f.includes("example") && !f.includes("template") && !f.includes(".test"),
-  );
-
-  // Detect potential issues
-  const issues = detectSetupIssues(detectRoot);
-
-  const lines = [
-    "export default {",
-    `  // ${detected.framework} detected`,
-    "",
-    "  // Dev server command",
-    "  dev: {",
-    `    command: '${detected.dev.command}',`,
-    `    port: ${detected.dev.port},`,
-    `    portFlag: ${detected.dev.portFlag ? `'${detected.dev.portFlag}'` : "null"},`,
-    `    cwd: '${detected.dev.cwd}',`,
-    "  },",
-    "",
-  ];
-
-  if (detected.setup) {
-    lines.push(`  // Install dependencies after creating a camp`);
-    lines.push(`  setup: ${JSON.stringify(detected.setup)},`);
-    lines.push("");
-  }
-
-  if (detected.copyFiles.length) {
-    lines.push("  // Copy gitignored files from main repo");
-    lines.push(`  copyFiles: ${JSON.stringify(detected.copyFiles)},`);
-    lines.push("");
-  }
-
-  if (detected._note) {
-    lines.push(`  // NOTE: ${detected._note}`);
-    lines.push("");
-  }
-
-  lines.push("  // (optional) Backend server");
-  lines.push("  // backend: {");
-  lines.push("  //   command: 'npm run start:api',");
-  lines.push("  //   port: 8000,");
-  lines.push("  //   healthCheck: '/health',");
-  lines.push("  // },");
-  lines.push("};");
-  lines.push("");
-
-  writeFileSync(configPath, lines.join("\n"), "utf8");
-
-  return {
-    created: true,
-    framework: detected.framework,
-    configPath,
-    message: `sanjang.config.js created (${detected.framework} detected).`,
-  };
-}