sanjang 0.3.0

package/lib/types.ts

@@ -0,0 +1,130 @@
+// Central type definitions for Sanjang
+
+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/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "sanjang",
+  "version": "0.3.0",
+  "description": "Local dev environment manager for vibe coders",
+  "type": "module",
+  "bin": {
+    "sanjang": "./bin/sanjang.js"
+  },
+  "scripts": {
+    "start": "node 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/"
+  },
+  "dependencies": {
+    "express": "^4.19.2",
+    "simple-git": "^3.27.0",
+    "user": "^0.0.0",
+    "ws": "^8.18.0"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/paul-sherpas/sanjang.git"
+  },
+  "keywords": [
+    "dev-tools",
+    "worktree",
+    "vibe-coding",
+    "local-dev"
+  ],
+  "files": [
+    "bin/",
+    "lib/",
+    "dashboard/",
+    "templates/"
+  ],
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.10",
+    "@types/express": "^5.0.6",
+    "@types/ws": "^8.18.1",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2"
+  }
+}

package/templates/sanjang.config.js

@@ -0,0 +1,32 @@
+// sanjang.config.js — 산장 설정 파일
+// 'sanjang init' 명령으로 자동 생성되지만, 직접 수정할 수도 있습니다.
+
+export default {
+  // 프론트엔드 개발 서버
+  dev: {
+    command: 'npm run dev',    // 실행 명령
+    port: 3000,                // 기본 포트 (portFlag가 null이면 이 포트로 감지)
+    portFlag: '--port',        // 포트 오버라이드 플래그 (null이면 stdout에서 자동 감지)
+    cwd: '.',                  // worktree 기준 상대 경로
+    env: {},                   // 추가 환경변수
+  },
+
+  // (선택) 설치 명령 — 캠프 생성 시 자동 실행 (캐시 미스 시)
+  // setup: 'npm install',
+
+  // (선택) 복사할 파일 — gitignored 파일을 메인에서 복사
+  // copyFiles: ['.env', '.env.local'],
+
+  // (선택) 백엔드 — 전체 캠프가 공유하는 서버
+  // backend: {
+  //   command: 'npm run start:api',
+  //   port: 8000,
+  //   healthCheck: '/health',
+  // },
+
+  // (선택) 포트 범위 — 캠프별 포트 슬롯 할당
+  // ports: {
+  //   fe: { base: 3000, slots: 8 },
+  //   be: { base: 8000, slots: 8 },
+  // },
+};