chore(env): Cloud Agent 개발 환경을 bun 기반으로 고정한다

[gitgitWi]

왜

Cloud Agent에는 연결된 환경이 없어, 새 에이전트가 매번 bun을 수동 설치하고 의존성을 받아야 한다. 저장소가 pin한 툴체인(bun@1.4.2, Node 22)으로 부팅되는 재현 가능한 환경을 .cursor/에 고정해, 이후 에이전트가 곧바로 dev/build/check/lint/test를 돌릴 수 있게 한다.

흐름

flowchart TD
  subgraph ASIS["AS-IS"]
    A1["새 Cloud Agent 부팅"] --> A2["bun 없음 · 의존성 없음"]
    A2 --> A3["매번 수동 설치"]
  end
  subgraph TOBE["TO-BE"]
    B1["새 Cloud Agent 부팅"] --> B2["install.sh: bun 1.4.2 + bun install"]
    B2 -->|"성공"| B3["astro-dev 터미널 자동 기동 (4321)"]
  end
  style A3 fill:#ffebee,stroke:#c62828,color:#c62828
  style B3 fill:#e8f5e9,stroke:#2e7d32,color:#2e7d32

Loading

효과

flowchart LR
  P["이 PR"] --> O["운영: 재현 가능한 Cloud Agent 부팅 · dev 서버 자동 기동"]
  P --> Q["품질: pin된 bun 1.4.2 · frozen-lockfile로 의존성 고정"]

Loading

범위

flowchart TD
  subgraph IN["이번 PR"]
    I1["포함 — .cursor/environment.json + .cursor/install.sh"]
  end
  subgraph OUT["제외"]
    X1["앱 코드 변경 없음 — 환경 설정만"]
    X2["기존 마크다운 포맷 이슈 4건 — 이 PR 범위 밖"]
  end

Loading

검증

로컬 VM + 드래프트 빌드에서 확인:

$ bun run check   → 54 files, 0 errors / 0 warnings / 0 hints
$ bunx oxlint .   → 통과 (경고·오류 없음)
$ bunx vitest run → 1 파일 / 1 테스트 통과
$ bun run build   → 7 페이지 정적 빌드 성공
$ bash .cursor/install.sh (2회) → 두 번째 실행도 "no changes" (멱등)

astro dev 기동 후 /, /tags/, /tags/astro/ 모두 HTTP 200으로 렌더링 확인.

  

[bolt-new-by-stackblitz]

Run & review this pull request in StackBlitz Codeflow.