@su-record/vibe 2.7.18 → 2.7.20

package/dist/infra/lib/InteractiveCheckpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InteractiveCheckpoint.d.ts","sourceRoot":"","sources":["../../../src/infra/lib/InteractiveCheckpoint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,cAAc,GACtB,sBAAsB,GACtB,qBAAqB,GACrB,sBAAsB,GACtB,qBAAqB,GACrB,cAAc,CAAC;AAEnB,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,sBAAsB;IACtB,IAAI,EAAE,cAAc,CAAC;IACrB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe;IACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,IAAI,EAAE,cAAc,CAAC;IACrB,0BAA0B;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,oDAAoD;AACpD,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,MAAM,EAAE,EACtB,WAAW,EAAE,MAAM,GAClB,UAAU,CAoBZ;AAED,iEAAiE;AACjE,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GACnF,UAAU,CA4BZ;AAED,gDAAgD;AAChD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAA;CAAE,CAAC,EACtE,cAAc,EAAE,MAAM,GACrB,UAAU,CAuBZ;AAED,8CAA8C;AAC9C,wBAAgB,4BAA4B,CAC1C,eAAe,EAAE,MAAM,EACvB,kBAAkB,EAAE,MAAM,EAAE,EAC5B,SAAS,EAAE,MAAM,GAChB,UAAU,CA4BZ;AAED,uCAAuC;AACvC,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,GAChF,UAAU,CAyBZ;AAED,kDAAkD;AAClD,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAkB/D;AAED,8CAA8C;AAC9C,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,MAAM,GAClB,gBAAgB,CAclB;AAED,yDAAyD;AACzD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,gBAAgB,CAO9E;AAED,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAEhE;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAC1B,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,gBAAgB,GACvB,iBAAiB,CAKnB"}

package/dist/infra/lib/InteractiveCheckpoint.js

@@ -0,0 +1,179 @@
+/**
+ * InteractiveCheckpoint — Phase 전환 시 의사결정 게이트
+ *
+ * /vibe.run 워크플로우에서 주요 지점에 체크포인트를 삽입하여
+ * 사용자가 방향을 확인/수정할 수 있도록 함
+ */
+/** Create a requirements confirmation checkpoint */
+export function createRequirementsCheckpoint(requirements, featureName) {
+    const summary = [
+        `Feature: ${featureName}`,
+        '',
+        'Requirements:',
+        ...requirements.map((r, i) => `  ${i + 1}. ${r}`),
+    ].join('\n');
+    return {
+        type: 'requirements_confirm',
+        title: 'Requirements Confirmation',
+        summary,
+        options: [
+            { key: 'a', label: 'Confirm', description: 'Proceed with these requirements as stated.' },
+            { key: 'b', label: 'Revise', description: 'Modify or clarify requirements before proceeding.' },
+            { key: 'c', label: 'Abort', description: 'Cancel this workflow.' },
+        ],
+        defaultOption: 'a',
+        metadata: { featureName, requirementCount: requirements.length },
+    };
+}
+/** Create an architecture choice checkpoint with 3 approaches */
+export function createArchitectureCheckpoint(options) {
+    const labels = ['Minimal', 'Clean', 'Pragmatic'];
+    const descriptions = ['Fastest path, minimal scope', 'Balanced design and speed', 'Comprehensive, thorough'];
+    const checkpointOptions = options.slice(0, 3).map((opt, i) => ({
+        key: String.fromCharCode(97 + i),
+        label: `${labels[i] ?? opt.approach} (${opt.effort})`,
+        description: [
+            opt.approach,
+            `Pros: ${opt.pros.join(', ')}`,
+            `Cons: ${opt.cons.join(', ')}`,
+            descriptions[i] ?? '',
+        ].filter(Boolean).join(' | '),
+    }));
+    const summary = options
+        .slice(0, 3)
+        .map((opt, i) => `${labels[i] ?? opt.approach}: ${opt.approach} [${opt.effort}]`)
+        .join('\n');
+    return {
+        type: 'architecture_choice',
+        title: 'Architecture Approach',
+        summary,
+        options: checkpointOptions,
+        defaultOption: 'b',
+        metadata: { approachCount: options.length },
+    };
+}
+/** Create an implementation scope checkpoint */
+export function createScopeCheckpoint(files, estimatedLines) {
+    const actionIcon = { create: '+', modify: '~', delete: '-' };
+    const fileLines = files.map(f => `  [${actionIcon[f.action] ?? '?'}] ${f.path}`);
+    const summary = [
+        `Estimated lines of change: ${estimatedLines}`,
+        '',
+        'Files:',
+        ...fileLines,
+    ].join('\n');
+    return {
+        type: 'implementation_scope',
+        title: 'Implementation Scope Approval',
+        summary,
+        options: [
+            { key: 'a', label: 'Approve', description: 'Proceed with the listed scope.' },
+            { key: 'b', label: 'Narrow', description: 'Reduce scope before implementation.' },
+            { key: 'c', label: 'Abort', description: 'Cancel implementation.' },
+        ],
+        defaultOption: 'a',
+        metadata: { fileCount: files.length, estimatedLines },
+    };
+}
+/** Create a verification result checkpoint */
+export function createVerificationCheckpoint(achievementRate, failedRequirements, iteration) {
+    const ratePercent = Math.round(achievementRate * 100);
+    const passedCount = failedRequirements.length === 0
+        ? 'all'
+        : `some`;
+    const failedLines = failedRequirements.length > 0
+        ? ['', 'Failed requirements:', ...failedRequirements.map(r => `  - ${r}`)]
+        : ['', 'All requirements passed.'];
+    const summary = [
+        `Iteration: ${iteration}`,
+        `Achievement rate: ${ratePercent}%  (${passedCount} requirements met)`,
+        ...failedLines,
+    ].join('\n');
+    return {
+        type: 'verification_result',
+        title: 'Verification Result Review',
+        summary,
+        options: [
+            { key: 'a', label: 'Continue fixing', description: 'Run another fix iteration.' },
+            { key: 'b', label: 'Accept as-is', description: 'Accept current state and move on.' },
+            { key: 'c', label: 'Abort', description: 'Stop the workflow.' },
+        ],
+        defaultOption: failedRequirements.length === 0 ? 'b' : 'a',
+        metadata: { achievementRate, failedCount: failedRequirements.length, iteration },
+    };
+}
+/** Create a fix strategy checkpoint */
+export function createFixStrategyCheckpoint(issues) {
+    const criticalCount = issues.filter(i => i.severity === 'critical').length;
+    const warningCount = issues.filter(i => i.severity === 'warning').length;
+    const infoCount = issues.filter(i => i.severity === 'info').length;
+    const issueLines = issues.map(i => `  [${i.severity.toUpperCase()}] ${i.description}`);
+    const summary = [
+        `Issues: ${criticalCount} critical, ${warningCount} warning, ${infoCount} info`,
+        '',
+        ...issueLines,
+    ].join('\n');
+    return {
+        type: 'fix_strategy',
+        title: 'Fix Strategy Selection',
+        summary,
+        options: [
+            { key: 'a', label: 'Fix all', description: 'Address every issue (critical, warning, info).' },
+            { key: 'b', label: 'Critical only', description: 'Fix only critical issues and skip the rest.' },
+            { key: 'c', label: 'Accept as-is', description: 'Skip all fixes and proceed.' },
+        ],
+        defaultOption: criticalCount > 0 ? 'a' : 'c',
+        metadata: { criticalCount, warningCount, infoCount },
+    };
+}
+/** Format a checkpoint as readable prompt text */
+export function formatCheckpoint(checkpoint) {
+    const divider = '─'.repeat(50);
+    const optionLines = checkpoint.options.map(opt => `  ${opt.key}) ${opt.label}\n     ${opt.description}`);
+    return [
+        divider,
+        `CHECKPOINT: ${checkpoint.title}`,
+        divider,
+        checkpoint.summary,
+        '',
+        'Options:',
+        ...optionLines,
+        '',
+        `Default: ${checkpoint.defaultOption}`,
+        divider,
+    ].join('\n');
+}
+/** Resolve a checkpoint with user's choice */
+export function resolveCheckpoint(checkpoint, selectedKey) {
+    const validKeys = checkpoint.options.map(o => o.key);
+    if (!validKeys.includes(selectedKey)) {
+        throw new Error(`Invalid option key "${selectedKey}". Valid keys: ${validKeys.join(', ')}`);
+    }
+    return {
+        type: checkpoint.type,
+        selectedOption: selectedKey,
+        timestamp: new Date().toISOString(),
+        autoResolved: false,
+    };
+}
+/** Auto-resolve a checkpoint using the default option */
+export function autoResolveCheckpoint(checkpoint) {
+    return {
+        type: checkpoint.type,
+        selectedOption: checkpoint.defaultOption,
+        timestamp: new Date().toISOString(),
+        autoResolved: true,
+    };
+}
+/** Create a new checkpoint history for a feature */
+export function createHistory(feature) {
+    return { feature, results: [] };
+}
+/** Append a result to history (immutable — returns new history) */
+export function addToHistory(history, result) {
+    return {
+        feature: history.feature,
+        results: [...history.results, result],
+    };
+}
+//# sourceMappingURL=InteractiveCheckpoint.js.map

package/dist/infra/lib/InteractiveCheckpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InteractiveCheckpoint.js","sourceRoot":"","sources":["../../../src/infra/lib/InteractiveCheckpoint.ts"],"names":[],"mappings":"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"}

package/dist/infra/lib/IterationTracker.d.ts

@@ -1,7 +1,44 @@
 /**
  * Iteration Tracker for ULTRAWORK/Ralph Loop
  * 작업 진행 상황을 추적하고 표시
+ *
+ * Also provides disk-based progress persistence (merged from ProgressTracker).
  */
+import { LoopBreaker } from './LoopBreaker.js';
+export interface PhaseInfo {
+    id: number;
+    name: string;
+    status: 'pending' | 'in_progress' | 'completed' | 'blocked';
+    startedAt?: string;
+    completedAt?: string;
+    blockers?: string[];
+}
+export interface ProgressState {
+    feature: string;
+    spec: string;
+    status: 'pending' | 'in_progress' | 'blocked' | 'completed';
+    currentPhase: number;
+    totalPhases: number;
+    phases: PhaseInfo[];
+    completedTasks: string[];
+    pendingTasks: string[];
+    blockers: string[];
+    lastCommit?: string;
+    lastUpdated: string;
+    startedAt: string;
+    sessionCount: number;
+}
+export declare function getProgressPath(projectRoot: string): string;
+export declare function loadProgress(projectRoot: string): ProgressState | null;
+export declare function saveProgress(projectRoot: string, progress: ProgressState): void;
+export declare function initProgress(projectRoot: string, feature: string, spec: string, phases: string[]): ProgressState;
+export declare function updatePhase(projectRoot: string, phaseNumber: number, status: PhaseInfo['status'], blockers?: string[]): ProgressState | null;
+export declare function completeTask(projectRoot: string, task: string): ProgressState | null;
+export declare function recordCommit(projectRoot: string, commitHash: string): ProgressState | null;
+export declare function incrementSession(projectRoot: string): ProgressState | null;
+export declare function formatProgressState(progress: ProgressState): string;
+export declare function getProgressSummary(projectRoot: string): string | null;
+export declare function writeProgressText(projectRoot: string): void;
 export interface PhaseProgress {
     phaseNumber: number;
     phaseName: string;
@@ -29,14 +66,17 @@ export interface IterationState {
 export declare function startIteration(featureName: string, phaseNames: string[], isUltrawork?: boolean, maxRetries?: number, pipelineEnabled?: boolean): IterationState;
 /**
  * Phase 시작
+ * Records an iteration with LoopBreaker; returns null if the loop limit is hit.
  */
 export declare function startPhase(phaseNumber: number): PhaseProgress | null;
 /**
  * Phase 완료
+ * Resets the consecutive error counter in LoopBreaker on success.
  */
 export declare function completePhase(phaseNumber: number): PhaseProgress | null;
 /**
  * Phase 실패 (재시도 가능)
+ * Records an error with LoopBreaker; forces canRetry=false when the error limit is hit.
  */
 export declare function failPhase(phaseNumber: number, error: string): {
     canRetry: boolean;
@@ -50,6 +90,10 @@ export declare function completeIteration(): IterationState | null;
  * 현재 상태 조회
  */
 export declare function getCurrentState(): IterationState | null;
+/**
+ * Returns the current LoopBreaker instance for external inspection.
+ */
+export declare function getIterationLoopBreaker(): LoopBreaker;
 /**
  * 진행 상황 포맷팅 (터미널 출력용)
  */

package/dist/infra/lib/IterationTracker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IterationTracker.d.ts","sourceRoot":"","sources":["../../../src/infra/lib/IterationTracker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;IACxE,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,sBAAsB;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAKD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAAE,EACpB,WAAW,GAAE,OAAe,EAC5B,UAAU,GAAE,MAAU,EACtB,eAAe,GAAE,OAAe,GAC/B,cAAc,CAkBhB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAWpE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAUvE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAAG,IAAI,CAahH;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,IAAI,CAQzD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,cAAc,GAAG,IAAI,CAEvD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,GAAE,cAA8B,GAAG,MAAM,CAwB5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAMpG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEpF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAgBrE;AAgBD;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAalH;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAkB/D"}
+{"version":3,"file":"IterationTracker.d.ts","sourceRoot":"","sources":["../../../src/infra/lib/IterationTracker.ts"],"names":[],"mappings":"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"}

package/dist/infra/lib/IterationTracker.js

@@ -1,13 +1,252 @@
 /**
  * Iteration Tracker for ULTRAWORK/Ralph Loop
  * 작업 진행 상황을 추적하고 표시
+ *
+ * Also provides disk-based progress persistence (merged from ProgressTracker).
  */
+import fs from 'fs';
+import path from 'path';
+import { LoopBreaker } from './LoopBreaker.js';
+const DEFAULT_PROGRESS = {
+    feature: '',
+    spec: '',
+    status: 'pending',
+    currentPhase: 0,
+    totalPhases: 0,
+    phases: [],
+    completedTasks: [],
+    pendingTasks: [],
+    blockers: [],
+    lastUpdated: new Date().toISOString(),
+    startedAt: new Date().toISOString(),
+    sessionCount: 0,
+};
+export function getProgressPath(projectRoot) {
+    return path.join(projectRoot, '.claude', 'vibe', 'progress.json');
+}
+export function loadProgress(projectRoot) {
+    const progressPath = getProgressPath(projectRoot);
+    try {
+        if (fs.existsSync(progressPath)) {
+            const content = fs.readFileSync(progressPath, 'utf-8');
+            return JSON.parse(content);
+        }
+    }
+    catch {
+        // Ignore parse errors
+    }
+    return null;
+}
+export function saveProgress(projectRoot, progress) {
+    const progressPath = getProgressPath(projectRoot);
+    const coreDir = path.dirname(progressPath);
+    if (!fs.existsSync(coreDir)) {
+        fs.mkdirSync(coreDir, { recursive: true });
+    }
+    progress.lastUpdated = new Date().toISOString();
+    fs.writeFileSync(progressPath, JSON.stringify(progress, null, 2));
+}
+export function initProgress(projectRoot, feature, spec, phases) {
+    const progress = {
+        ...DEFAULT_PROGRESS,
+        feature,
+        spec,
+        status: 'in_progress',
+        currentPhase: 1,
+        totalPhases: phases.length,
+        phases: phases.map((name, idx) => ({
+            id: idx + 1,
+            name,
+            status: idx === 0 ? 'in_progress' : 'pending',
+            startedAt: idx === 0 ? new Date().toISOString() : undefined,
+        })),
+        pendingTasks: phases.slice(1),
+        startedAt: new Date().toISOString(),
+        sessionCount: 1,
+    };
+    saveProgress(projectRoot, progress);
+    return progress;
+}
+export function updatePhase(projectRoot, phaseNumber, status, blockers) {
+    const progress = loadProgress(projectRoot);
+    if (!progress)
+        return null;
+    const phase = progress.phases.find(p => p.id === phaseNumber);
+    if (phase) {
+        phase.status = status;
+        if (status === 'in_progress') {
+            phase.startedAt = new Date().toISOString();
+            progress.currentPhase = phaseNumber;
+        }
+        else if (status === 'completed') {
+            phase.completedAt = new Date().toISOString();
+            progress.completedTasks.push(phase.name);
+            progress.pendingTasks = progress.pendingTasks.filter(t => t !== phase.name);
+            const nextPhase = progress.phases.find(p => p.id === phaseNumber + 1);
+            if (nextPhase) {
+                nextPhase.status = 'in_progress';
+                nextPhase.startedAt = new Date().toISOString();
+                progress.currentPhase = nextPhase.id;
+            }
+            else {
+                progress.status = 'completed';
+            }
+        }
+        else if (status === 'blocked') {
+            phase.blockers = blockers;
+            progress.blockers = blockers || [];
+            progress.status = 'blocked';
+        }
+    }
+    saveProgress(projectRoot, progress);
+    return progress;
+}
+export function completeTask(projectRoot, task) {
+    const progress = loadProgress(projectRoot);
+    if (!progress)
+        return null;
+    if (!progress.completedTasks.includes(task)) {
+        progress.completedTasks.push(task);
+    }
+    progress.pendingTasks = progress.pendingTasks.filter(t => t !== task);
+    saveProgress(projectRoot, progress);
+    return progress;
+}
+export function recordCommit(projectRoot, commitHash) {
+    const progress = loadProgress(projectRoot);
+    if (!progress)
+        return null;
+    progress.lastCommit = commitHash;
+    saveProgress(projectRoot, progress);
+    return progress;
+}
+export function incrementSession(projectRoot) {
+    const progress = loadProgress(projectRoot);
+    if (!progress)
+        return null;
+    progress.sessionCount++;
+    saveProgress(projectRoot, progress);
+    return progress;
+}
+export function formatProgressState(progress) {
+    const lines = [];
+    const statusIcon = {
+        pending: '⏳',
+        in_progress: '🔨',
+        blocked: '🚫',
+        completed: '✅',
+    }[progress.status];
+    lines.push(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
+    lines.push(`${statusIcon} Feature: ${progress.feature}`);
+    lines.push(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
+    lines.push(`Status: ${progress.status.toUpperCase()}`);
+    lines.push(`Phase: ${progress.currentPhase}/${progress.totalPhases}`);
+    lines.push(`Sessions: ${progress.sessionCount}`);
+    lines.push(``);
+    lines.push(`Phases:`);
+    for (const phase of progress.phases) {
+        const icon = {
+            pending: '○',
+            in_progress: '●',
+            completed: '✓',
+            blocked: '✗',
+        }[phase.status];
+        lines.push(`  ${icon} ${phase.id}. ${phase.name}`);
+    }
+    if (progress.completedTasks.length > 0) {
+        lines.push(``);
+        lines.push(`Completed: ${progress.completedTasks.length} tasks`);
+    }
+    if (progress.blockers.length > 0) {
+        lines.push(``);
+        lines.push(`Blockers:`);
+        for (const blocker of progress.blockers) {
+            lines.push(`  - ${blocker}`);
+        }
+    }
+    if (progress.lastCommit) {
+        lines.push(``);
+        lines.push(`Last commit: ${progress.lastCommit}`);
+    }
+    lines.push(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
+    return lines.join('\n');
+}
+export function getProgressSummary(projectRoot) {
+    const progress = loadProgress(projectRoot);
+    if (!progress || progress.status === 'completed')
+        return null;
+    const currentPhase = progress.phases.find(p => p.id === progress.currentPhase);
+    const phaseName = currentPhase?.name || 'Unknown';
+    return `Active feature: "${progress.feature}" - Phase ${progress.currentPhase}/${progress.totalPhases} (${phaseName})`;
+}
+export function writeProgressText(projectRoot) {
+    const progress = loadProgress(projectRoot);
+    if (!progress)
+        return;
+    const progressTextPath = path.join(projectRoot, '.claude', 'vibe', 'claude-progress.txt');
+    const lines = [];
+    lines.push(`# Progress: ${progress.feature}`);
+    lines.push(`Updated: ${new Date().toISOString()}`);
+    lines.push(`Status: ${progress.status.toUpperCase()}`);
+    lines.push(`Session: ${progress.sessionCount}`);
+    lines.push('');
+    lines.push('## Phases');
+    for (const phase of progress.phases) {
+        const icon = { pending: '[ ]', in_progress: '[>]', completed: '[x]', blocked: '[!]' }[phase.status];
+        lines.push(`${icon} Phase ${phase.id}: ${phase.name}`);
+        if (phase.blockers?.length) {
+            for (const b of phase.blockers) {
+                lines.push(`    BLOCKED: ${b}`);
+            }
+        }
+    }
+    if (progress.completedTasks.length > 0) {
+        lines.push('');
+        lines.push('## Completed');
+        for (const task of progress.completedTasks) {
+            lines.push(`- ${task}`);
+        }
+    }
+    if (progress.pendingTasks.length > 0) {
+        lines.push('');
+        lines.push('## Remaining');
+        for (const task of progress.pendingTasks) {
+            lines.push(`- ${task}`);
+        }
+    }
+    if (progress.blockers.length > 0) {
+        lines.push('');
+        lines.push('## Blockers');
+        for (const blocker of progress.blockers) {
+            lines.push(`- ${blocker}`);
+        }
+    }
+    if (progress.lastCommit) {
+        lines.push('');
+        lines.push(`## Last Commit: ${progress.lastCommit}`);
+    }
+    const coreDir = path.dirname(progressTextPath);
+    if (!fs.existsSync(coreDir)) {
+        fs.mkdirSync(coreDir, { recursive: true });
+    }
+    fs.writeFileSync(progressTextPath, lines.join('\n') + '\n');
+}
 // 전역 상태 (세션 내 유지)
 let currentState = null;
+// Module-level LoopBreaker instance (lazy init per startIteration call)
+let _loopBreaker = null;
+function getLoopBreaker() {
+    if (!_loopBreaker) {
+        _loopBreaker = new LoopBreaker();
+    }
+    return _loopBreaker;
+}
 /**
  * 새 작업 시작
  */
 export function startIteration(featureName, phaseNames, isUltrawork = false, maxRetries = 3, pipelineEnabled = false) {
+    // Reset LoopBreaker for the new iteration
+    _loopBreaker = new LoopBreaker();
     currentState = {
         featureName,
         totalPhases: phaseNames.length,
@@ -27,11 +266,16 @@ export function startIteration(featureName, phaseNames, isUltrawork = false, max
 }
 /**
  * Phase 시작
+ * Records an iteration with LoopBreaker; returns null if the loop limit is hit.
  */
 export function startPhase(phaseNumber) {
     if (!currentState || phaseNumber < 1 || phaseNumber > currentState.totalPhases) {
         return null;
     }
+    const breakResult = getLoopBreaker().recordIteration();
+    if (breakResult.shouldBreak) {
+        return null;
+    }
     const phase = currentState.phases[phaseNumber - 1];
     phase.status = 'in_progress';
     phase.startTime = new Date();
@@ -40,11 +284,13 @@ export function startPhase(phaseNumber) {
 }
 /**
  * Phase 완료
+ * Resets the consecutive error counter in LoopBreaker on success.
  */
 export function completePhase(phaseNumber) {
     if (!currentState || phaseNumber < 1 || phaseNumber > currentState.totalPhases) {
         return null;
     }
+    getLoopBreaker().recordSuccess();
     const phase = currentState.phases[phaseNumber - 1];
     phase.status = 'completed';
     phase.endTime = new Date();
@@ -52,15 +298,18 @@ export function completePhase(phaseNumber) {
 }
 /**
  * Phase 실패 (재시도 가능)
+ * Records an error with LoopBreaker; forces canRetry=false when the error limit is hit.
  */
 export function failPhase(phaseNumber, error) {
     if (!currentState || phaseNumber < 1 || phaseNumber > currentState.totalPhases) {
         return null;
     }
+    const breakResult = getLoopBreaker().recordError();
     const phase = currentState.phases[phaseNumber - 1];
     phase.retryCount += 1;
     phase.error = error;
-    const canRetry = phase.retryCount < currentState.maxRetries;
+    const withinRetries = phase.retryCount < currentState.maxRetries;
+    const canRetry = withinRetries && !breakResult.shouldBreak;
     phase.status = canRetry ? 'retrying' : 'failed';
     return { canRetry, phase };
 }
@@ -81,6 +330,12 @@ export function completeIteration() {
 export function getCurrentState() {
     return currentState;
 }
+/**
+ * Returns the current LoopBreaker instance for external inspection.
+ */
+export function getIterationLoopBreaker() {
+    return getLoopBreaker();
+}
 /**
  * 진행 상황 포맷팅 (터미널 출력용)
  */
@@ -108,10 +363,10 @@ export function formatProgress(state = currentState) {
  * Phase 시작 배너
  */
 export function formatPhaseStart(phaseNumber, phaseName, totalPhases) {
-    return `
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🏔️ BOULDER ROLLING... Phase ${phaseNumber}/${totalPhases}
-   ${phaseName}
+    return `
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🏔️ BOULDER ROLLING... Phase ${phaseNumber}/${totalPhases}
+   ${phaseName}
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`.trim();
 }
 /**
@@ -129,13 +384,13 @@ export function formatIterationComplete(state) {
         : 0;
     const totalRetries = state.phases.reduce((sum, p) => sum + p.retryCount, 0);
     const retryInfo = totalRetries > 0 ? ` (${totalRetries} retries)` : '';
-    return `
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🎉 BOULDER REACHED THE TOP!
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-Feature: ${state.featureName}
-Phases:  ${state.totalPhases}/${state.totalPhases} complete${retryInfo}
-Time:    ${duration}s
+    return `
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎉 BOULDER REACHED THE TOP!
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Feature: ${state.featureName}
+Phases:  ${state.totalPhases}/${state.totalPhases} complete${retryInfo}
+Time:    ${duration}s
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`.trim();
 }
 /**