pubuilder 0.5.0 → 0.7.0

package/CHANGELOG.md

@@ -0,0 +1,90 @@
+# Changelog
+
+이 프로젝트의 주요 변경 사항을 기록합니다.
+형식은 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/)를 따르며,
+버전은 [Semantic Versioning](https://semver.org/lang/ko/)을 따릅니다.
+(0.x 단계이므로 breaking change는 minor 버전으로 올립니다.)
+
+## [0.7.0] - 2026-07-15
+
+### Added
+
+- **블록별 동시 퍼블리싱** — 여러 블록을 동시에 퍼블리싱할 수 있고(서버 상한 3개),
+  다른 블록을 선택하거나 미니맵을 닫아도 실행 중인 job이 끊기지 않는다. job 상태를
+  selection 종속 로컬 state에서 store(블록키별)로 승격.
+- **"일시 종료"** — 진행 중인 모든 퍼블리싱 job을 강제 종료하고, 각 job이 편집한
+  파일을 job 시작 시점(git stash 스냅샷)으로 되돌린다. 완료 job·사용자 편집과 겹치는
+  파일은 파일 단위 충돌 GUI(이전으로/현재 유지/편집)로 해결한다.
+
+### Fixed
+
+- 미니맵 캔버스의 "React Flow" 워터마크 제거(`hideAttribution`) + 우측 하단
+  줌/핏 컨트롤러(`<Controls>`) 복원.
+
+## [0.6.0] - 2026-07-15
+
+### Added
+
+- **퍼블리싱 완료 후 AI 후속 답변(이어가기)** — 퍼블리싱이 끝난 뒤 AI에게 후속 지시를
+  보내 중단·확인 대기 중인 작업을 현재 작업 트리에서 이어서 완료하도록 함
+  (완료 상태의 답변 textarea, ⌘/Ctrl+Enter 전송).
+
+### Changed
+
+- **스킬함 진입점을 퍼블리싱 패널로 이동** — 미니맵/뷰어 헤더의 🧰 스킬함 버튼을
+  제거하고 퍼블리싱 패널 상단으로 옮김.
+- 스킬함 드로어 UI 개편 — 안내문, 섹션 헤더(Figma 연결 / AI 작업 스킬),
+  상태 배지, 스킬 소스 설명 추가.
+
+## [0.5.0] - 2026-07-15
+
+### ⚠️ Breaking Changes
+
+- `defineIA` 헬퍼의 import 경로가 `pubuilder`에서 **`pubuilder/config`**로 바뀌었습니다.
+  `"use client"` React 번들 없이 config만 로드할 수 있도록 별도 서브패스 export로 분리했습니다.
+
+  ```diff
+  - import { defineIA } from 'pubuilder'
+  + import { defineIA } from 'pubuilder/config'
+  ```
+
+  `pubuilder scan`이 생성하는 `ia.config.ts` 템플릿도 새 경로를 사용합니다.
+
+### Fixed
+
+- 에이전트 spawn 시 `--setting-sources`를 격리해 스킬 화이트리스트가 실효성을 갖도록 수정.
+- 컴패니언 서버: 종료 잡 상한 유지, publish 요청 바디 검증, 캐시 파일명 정규화.
+
+### Changed
+
+- 상대경로 import에 `.js` 확장자를 명시(NodeNext ESM 해석).
+- 데모(playground)를 음악 플랫폼(wavbor)에서 AI 에이전트 플랫폼(NIMBUS)으로 교체.
+
+## [0.4.0] - 2026-07-14
+
+### Added
+
+- **AI 퍼블리싱 기능** — 미니맵에서 Figma 시안을 코드로 퍼블리싱하는 워크플로우.
+  - 컴패니언 HTTP 서버: 스킬 레지스트리(스캔/토글/업로드/삭제), Figma 토큰 로드·저장,
+    Figma 노드 JSON·PNG fetch, 퍼블리싱 잡 매니저, SSE 로그 스트리밍.
+  - 퍼블리싱 패널 UI: Figma URL 입력·실행·SSE 로그·중단.
+  - 스킬함 드로어: 스킬 목록/토글/업로드/삭제, 토큰 설정.
+  - CLI `serve`/`dev` 서브커맨드 — 컴패니언 서버 기동 및 dev 래퍼.
+
+### Changed
+
+- 패키지명을 `pubmap`에서 **`pubuilder`**로 전면 개명(npm이 `pubmap`을 거부).
+
+## [0.3.0] - 2026-07-13
+
+### Added
+
+- 최초 npm 공개 배포.
+- `pubuilder scan` CLI — Next.js 라우트를 스캔해 `ia.config.ts` 생성/병합.
+- `PageMap` 미니맵 컴포넌트 — 화면설계서(IA) 기반 페이지 트리를 iframe 썸네일로 렌더링.
+
+[0.7.0]: https://www.npmjs.com/package/pubuilder/v/0.7.0
+[0.6.0]: https://www.npmjs.com/package/pubuilder/v/0.6.0
+[0.5.0]: https://www.npmjs.com/package/pubuilder/v/0.5.0
+[0.4.0]: https://www.npmjs.com/package/pubuilder/v/0.4.0
+[0.3.0]: https://www.npmjs.com/package/pubuilder/v/0.3.0

package/dist/api.d.ts

@@ -15,6 +15,21 @@ export interface TokenStatus {
     configured: boolean;
     masked: string | null;
 }
+/** 일시 종료 시 롤백이 완료 job/사용자 편집과 겹치는 파일 */
+export interface SuspendConflict {
+    file: string;
+    baseline: string;
+    current: string;
+}
+export interface SuspendResult {
+    autoReverted: string[];
+    conflicts: SuspendConflict[];
+}
+export type SuspendResolution = {
+    file: string;
+    action: 'revert' | 'keep' | 'edit';
+    content?: string;
+};
 /** 서버 에러 응답의 code(server/errors.ts 계약)를 UI 분기용으로 실어 나르는 에러 */
 export declare class ApiError extends Error {
     readonly code?: string | undefined;
@@ -36,10 +51,15 @@ export declare class PubuilderApi {
         selection: BlockSelection;
         outerHTML: string;
         figmaUrl: string;
+        instruction?: string;
     }): Promise<{
         jobId: string;
     }>;
     cancelPublish(jobId: string): Promise<void>;
+    /** 진행 중 job 전체 kill + 파일 자동롤백/충돌 분류 */
+    suspendPublish(): Promise<SuspendResult>;
+    /** 충돌 파일 결정(revert/keep/edit) 적용 */
+    resolveSuspend(resolutions: SuspendResolution[]): Promise<void>;
     /** SSE 구독 — 반환값 호출로 해제 */
     subscribePublish(jobId: string, onEvent: (e: AgentEvent) => void): () => void;
 }