pubuilder 0.5.0 → 0.7.0

package/dist/publish-jobs.d.ts

@@ -0,0 +1,28 @@
+import type { AgentEvent } from './api';
+import type { BlockSelection } from './types';
+export type PublishStatus = 'idle' | 'running' | 'done' | 'error';
+/**
+ * 한 블록의 퍼블리싱 job 상태. selection에 종속된 로컬 state가 아니라
+ * store에 블록별로 보관되어, 다른 블록을 선택해도 실행 중인 job이 끊기지 않는다.
+ */
+export interface PublishJobState {
+    jobId: string | null;
+    status: PublishStatus;
+    events: AgentEvent[];
+    errorMessage: string | null;
+    errorCode: string | null;
+    serverDown: boolean;
+    /** isAlive/startPublish 왕복 중 로딩 플래그 */
+    checking: boolean;
+    cancelling: boolean;
+    /** 입력값도 블록별로 유지 — 전환 후 돌아와도 그대로 */
+    figmaUrl: string;
+    reply: string;
+}
+export declare const IDLE_PUBLISH_JOB: PublishJobState;
+/**
+ * 블록을 페이지 간에도 고유하게 식별하는 키.
+ * 서로 다른 페이지가 같은 selector를 가질 수 있으므로 pagePath까지 합친다.
+ * '\n'은 selector/pagePath에 나타나지 않아 구분자로 안전하다.
+ */
+export declare function blockKey(sel: BlockSelection): string;

package/dist/server/agent.d.ts

@@ -1,6 +1,31 @@
+/** 충돌 파일 정보: 사용자가 파일 단위로 revert/keep/edit 결정한다 */
+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;
+};
+/** 테스트에서 fs/git 없이 로직만 검증할 수 있도록 주입 가능한 파일 연산 */
+interface SnapshotOps {
+    captureBaseline?: (cwd: string) => string | null;
+    readBaseline?: (cwd: string, ref: string, file: string) => string | null;
+    restoreFile?: (cwd: string, ref: string, file: string) => void;
+    readCurrent?: (cwd: string, file: string) => string;
+    writeFile?: (cwd: string, file: string, content: string) => void;
+}
 export interface AgentEvent {
     type: 'log' | 'tool' | 'error' | 'done';
     text: string;
+    /** tool 이벤트에서 Edit/Write 대상 파일 경로 (touchedFiles 추적용) */
+    file?: string;
 }
 export interface AgentRunOptions {
     prompt: string;
@@ -18,13 +43,20 @@ export interface AgentAdapter {
  */
 export declare function parseAgentLine(line: string): AgentEvent[];
 export declare const claudeAdapter: AgentAdapter;
-/** 동시 실행 1개 제한 (스펙). 이벤트는 저장 후 브로드캐스트 — 늦은 SSE 구독자는 replay */
+/** 이벤트는 저장 후 브로드캐스트 — 늦은 SSE 구독자는 replay */
 export declare class PublishJobManager {
     private readonly adapter;
     private jobs;
-    private active;
     private seq;
-    constructor(adapter: AgentAdapter);
+    private readonly capture;
+    private readonly readBaseline;
+    private readonly restoreFile;
+    private readonly readCurrent;
+    private readonly writeFile;
+    /** suspend 시 파일별 baseline ref를 보관 → resolve의 revert에서 사용 */
+    private pendingBaseline;
+    constructor(adapter: AgentAdapter, opts?: SnapshotOps);
+    private activeCount;
     start(opts: {
         prompt: string;
         cwd: string;
@@ -33,7 +65,24 @@ export declare class PublishJobManager {
     private evictFinishedJobs;
     /** SSE 핸들러가 헤더 전송 전에 job 존재를 확인할 때 사용 (subscribe는 replay 부작용이 있어 분리) */
     has(id: string): boolean;
+    /** job이 편집한 파일 목록 (상대경로, 정렬) */
+    touchedFiles(id: string): string[];
+    /** job 시작 시점 baseline ref */
+    baselineRef(id: string): string | null;
+    /**
+     * 진행 중(running)인 job을 전부 abort하고, 그들이 편집한 파일을 분류한다.
+     * - 자동 롤백: running job만 건드린 파일 → baseline으로 즉시 복원
+     * - 충돌: 완료(finished)된 job도 건드린 파일 → 사용자 해결 대상으로 반환
+     * 파일별 baseline은 그 파일을 건드린 running job 중 가장 이른(seq 최소) job의 것.
+     */
+    suspendRunning(cwd: string): SuspendResult;
+    /**
+     * 충돌 파일에 대한 사용자 결정을 적용한다.
+     * revert → baseline 복원, edit → content로 덮어쓰기, keep → 그대로 둔다.
+     */
+    applyResolutions(cwd: string, resolutions: SuspendResolution[]): void;
     subscribe(id: string, listener: (e: AgentEvent) => void): () => void;
     cancel(id: string): void;
     waitFor(id: string): Promise<void>;
 }
+export {};

package/dist/server/prompt.d.ts

@@ -11,5 +11,7 @@ export interface PublishPromptInput {
         name: string;
         content: string;
     }>;
+    /** 에이전트의 확인 질문에 대한 사용자 후속 답변 */
+    instruction?: string;
 }
 export declare function buildPublishPrompt(input: PublishPromptInput): string;

package/dist/server/snapshot.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 현재 작업 트리 상태를 커밋 오브젝트로 스냅샷하고 그 SHA를 반환한다.
+ * 워킹트리·stash 목록을 건드리지 않는다(`git stash create`).
+ * 트리가 clean이면 'HEAD'(동일 상태), 비-git이거나 실패하면 null(롤백 기능 degrade).
+ */
+export declare function captureBaseline(cwd: string): string | null;
+/** ref 시점의 file 내용. ref에 해당 파일이 없으면(스냅샷 이후 생성된 신규 파일) null. */
+export declare function readBaseline(cwd: string, ref: string, file: string): string | null;
+/** file을 baseline으로 복원한다. baseline에 없던(신규 생성) 파일이면 삭제한다. */
+export declare function restoreFile(cwd: string, ref: string, file: string): void;

package/dist/store.d.ts

@@ -1,3 +1,5 @@
+import type { AgentEvent, SuspendConflict, SuspendResolution } from './api';
+import { type PublishJobState } from './publish-jobs';
 import type { BlockSelection, Granularity } from './types';
 interface PubuilderStore {
     isMapOpen: boolean;
@@ -9,6 +11,11 @@ interface PubuilderStore {
     /** 선택된 블록의 outerHTML 스냅샷 (Phase 3 퍼블리싱 프롬프트용, 20K 상한) */
     selectedOuterHTML: string | null;
     skillDrawerOpen: boolean;
+    /**
+     * 블록별 퍼블리싱 job 상태 (key: blockKey). selection에서 분리되어 있어
+     * 다른 블록을 선택하거나 맵을 닫아도 실행 중인 job이 끊기지 않는다.
+     */
+    publishJobs: Record<string, PublishJobState>;
     openMap: () => void;
     closeMap: () => void;
     openViewer: (path: string) => void;
@@ -17,6 +24,17 @@ interface PubuilderStore {
     setInspectEnabled: (v: boolean) => void;
     setSelectionWithHTML: (s: BlockSelection | null, html: string | null) => void;
     toggleSkillDrawer: () => void;
+    /** 블록 job의 일부 필드를 갱신 (없으면 IDLE에서 시작) */
+    patchPublishJob: (key: string, partial: Partial<PublishJobState>) => void;
+    /** 블록 job의 이벤트 로그에 한 건 추가 */
+    appendPublishEvent: (key: string, event: AgentEvent) => void;
+    /** 일시 종료 후 사용자가 해결해야 하는 충돌 파일들 (없으면 패널 미표시) */
+    suspendConflicts: SuspendConflict[];
+    /** 충돌 파일별 사용자 결정 (file → resolution) */
+    suspendResolutions: Record<string, SuspendResolution>;
+    setSuspendConflicts: (conflicts: SuspendConflict[]) => void;
+    setConflictResolution: (file: string, action: SuspendResolution['action'], content?: string) => void;
+    clearSuspend: () => void;
 }
 export declare const usePubuilderStore: import("zustand").UseBoundStore<import("zustand").StoreApi<PubuilderStore>>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pubuilder",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "In-app IA minimap & block inspector for React — live iframe thumbnails of every page, plus a Next.js route scanner that drafts your ia.config (dev-only)",
   "license": "MIT",
   "author": "taehoon",
@@ -38,7 +38,8 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "CHANGELOG.md"
   ],
   "sideEffects": false,
   "scripts": {