@su-record/vibe 2.7.18 → 2.7.20

package/dist/cli/setup/Provisioner.js

@@ -153,48 +153,48 @@ export class Provisioner {
         const stateSection = details.stateManagement.length > 0
             ? details.stateManagement.join(', ')
             : 'N/A';
-        return `# [Feature Name] SPEC
-
-## Overview
-<!-- Brief description of the feature -->
-
-## Tech Stack
-${stackList}
-
-### Infrastructure
-- **Databases**: ${dbSection}
-- **State Management**: ${stateSection}
-
-## Problem Statement
-<!-- What problem does this solve? -->
-
-## Proposed Solution
-<!-- High-level approach -->
-
-## Requirements
-
-### Functional
-1. <!-- Requirement 1 -->
-
-### Non-Functional
-1. <!-- Performance, security, accessibility -->
-
-## API Design
-<!-- Endpoints, request/response schemas -->
-
-## Data Model
-<!-- Schema changes, migrations -->
-
-## Test Strategy
-- Unit tests: <!-- scope -->
-- Integration tests: <!-- scope -->
-- E2E tests: <!-- scope -->
-
-## Acceptance Criteria
-- [ ] <!-- Criterion 1 -->
-
-## References
-<!-- Links to relevant docs, designs, PRs -->
+        return `# [Feature Name] SPEC
+
+## Overview
+<!-- Brief description of the feature -->
+
+## Tech Stack
+${stackList}
+
+### Infrastructure
+- **Databases**: ${dbSection}
+- **State Management**: ${stateSection}
+
+## Problem Statement
+<!-- What problem does this solve? -->
+
+## Proposed Solution
+<!-- High-level approach -->
+
+## Requirements
+
+### Functional
+1. <!-- Requirement 1 -->
+
+### Non-Functional
+1. <!-- Performance, security, accessibility -->
+
+## API Design
+<!-- Endpoints, request/response schemas -->
+
+## Data Model
+<!-- Schema changes, migrations -->
+
+## Test Strategy
+- Unit tests: <!-- scope -->
+- Integration tests: <!-- scope -->
+- E2E tests: <!-- scope -->
+
+## Acceptance Criteria
+- [ ] <!-- Criterion 1 -->
+
+## References
+<!-- Links to relevant docs, designs, PRs -->
 `;
     }
 }

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

@@ -0,0 +1,48 @@
+/**
+ * AutomationLevel — 자동화 레벨 시스템
+ *
+ * L0: Manual — 모든 단계에서 사용자 확인
+ * L1: Guided — AI 제안, 사용자 결정
+ * L2: Semi-auto — 기본값, 주요 지점에서 확인
+ * L3: Auto — 자동 진행, 체크포인트만 확인 (ultrawork)
+ * L4: Full-auto — 완전 자동, 달성률 기반 반복 (ralph)
+ */
+export type AutomationLevelNumber = 0 | 1 | 2 | 3 | 4;
+export interface AutomationLevel {
+    level: AutomationLevelNumber;
+    name: string;
+    description: string;
+    /** Whether to auto-advance between phases */
+    autoAdvance: boolean;
+    /** Whether to auto-retry on failure */
+    autoRetry: boolean;
+    /** Max retries (0 = no retry) */
+    maxRetries: number;
+    /** Whether to require user confirmation at checkpoints */
+    requireCheckpoints: boolean;
+    /** Whether to use parallel agents */
+    parallelAgents: boolean;
+}
+export type AutomationAction = 'phase_advance' | 'architecture_choice' | 'implementation_scope' | 'fix_strategy' | 'retry' | 'destructive';
+export interface TrustScore {
+    score: number;
+    level: AutomationLevelNumber;
+    consecutiveSuccesses: number;
+    consecutiveFailures: number;
+    totalActions: number;
+}
+export declare const AUTOMATION_LEVELS: Record<AutomationLevelNumber, AutomationLevel>;
+/** Magic keyword → level mapping */
+export declare const KEYWORD_LEVEL_MAP: Record<string, AutomationLevelNumber>;
+/** Detect automation level from user input text */
+export declare function detectAutomationLevel(input: string): AutomationLevel;
+/** Get level by number */
+export declare function getAutomationLevel(level: AutomationLevelNumber): AutomationLevel;
+/** Check if a specific action needs user confirmation at the given level */
+export declare function needsConfirmation(level: AutomationLevelNumber, action: AutomationAction): boolean;
+export declare function createTrustScore(): TrustScore;
+export declare function recordTrustSuccess(trust: TrustScore): TrustScore;
+export declare function recordTrustFailure(trust: TrustScore): TrustScore;
+/** Get recommended level based on trust score */
+export declare function getRecommendedLevel(trust: TrustScore): AutomationLevelNumber;
+//# sourceMappingURL=AutomationLevel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AutomationLevel.d.ts","sourceRoot":"","sources":["../../../src/infra/lib/AutomationLevel.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,qBAAqB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,WAAW,EAAE,OAAO,CAAC;IACrB,uCAAuC;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,kBAAkB,EAAE,OAAO,CAAC;IAC5B,qCAAqC;IACrC,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,MAAM,gBAAgB,GACxB,eAAe,GACf,qBAAqB,GACrB,sBAAsB,GACtB,cAAc,GACd,OAAO,GACP,aAAa,CAAC;AAElB,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,qBAAqB,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,qBAAqB,EAAE,eAAe,CAmD5E,CAAC;AAEF,oCAAoC;AACpC,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CASnE,CAAC;AA2BF,mDAAmD;AACnD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CASpE;AAED,0BAA0B;AAC1B,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,GAAG,eAAe,CAEhF;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,qBAAqB,EAC5B,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAET;AAED,wBAAgB,gBAAgB,IAAI,UAAU,CAQ7C;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAahE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAahE;AAED,iDAAiD;AACjD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,qBAAqB,CAE5E"}

package/dist/infra/lib/AutomationLevel.js

@@ -0,0 +1,157 @@
+/**
+ * AutomationLevel — 자동화 레벨 시스템
+ *
+ * L0: Manual — 모든 단계에서 사용자 확인
+ * L1: Guided — AI 제안, 사용자 결정
+ * L2: Semi-auto — 기본값, 주요 지점에서 확인
+ * L3: Auto — 자동 진행, 체크포인트만 확인 (ultrawork)
+ * L4: Full-auto — 완전 자동, 달성률 기반 반복 (ralph)
+ */
+export const AUTOMATION_LEVELS = {
+    0: {
+        level: 0,
+        name: 'Manual',
+        description: 'Every step requires user confirmation',
+        autoAdvance: false,
+        autoRetry: false,
+        maxRetries: 0,
+        requireCheckpoints: true,
+        parallelAgents: false,
+    },
+    1: {
+        level: 1,
+        name: 'Guided',
+        description: 'AI suggests, user decides',
+        autoAdvance: false,
+        autoRetry: false,
+        maxRetries: 0,
+        requireCheckpoints: true,
+        parallelAgents: false,
+    },
+    2: {
+        level: 2,
+        name: 'Semi-auto',
+        description: 'Auto-execute with key checkpoints',
+        autoAdvance: true,
+        autoRetry: true,
+        maxRetries: 2,
+        requireCheckpoints: true,
+        parallelAgents: false,
+    },
+    3: {
+        level: 3,
+        name: 'Auto',
+        description: 'Auto-advance, checkpoint-only review',
+        autoAdvance: true,
+        autoRetry: true,
+        maxRetries: 3,
+        requireCheckpoints: true,
+        parallelAgents: true,
+    },
+    4: {
+        level: 4,
+        name: 'Full-auto',
+        description: 'Fully autonomous, metric-driven iteration',
+        autoAdvance: true,
+        autoRetry: true,
+        maxRetries: 5,
+        requireCheckpoints: false,
+        parallelAgents: true,
+    },
+};
+/** Magic keyword → level mapping */
+export const KEYWORD_LEVEL_MAP = {
+    manual: 0,
+    guided: 1,
+    quick: 2,
+    ultrawork: 3,
+    ulw: 3,
+    ralph: 4,
+    ralplan: 4,
+    verify: 1,
+};
+const CONFIRMATION_MATRIX = {
+    destructive: [0, 1, 2, 3],
+    phase_advance: [0, 1],
+    architecture_choice: [0, 1, 2],
+    implementation_scope: [0, 1, 2],
+    fix_strategy: [0, 1],
+    retry: [0],
+};
+const TRUST_SCORE_DEFAULTS = {
+    INITIAL: 50,
+    SUCCESS_DELTA: 5,
+    FAILURE_DELTA: 15,
+    MAX: 100,
+    MIN: 0,
+};
+const TRUST_LEVEL_THRESHOLDS = [
+    { max: 20, level: 0 },
+    { max: 40, level: 1 },
+    { max: 60, level: 2 },
+    { max: 80, level: 3 },
+    { max: 100, level: 4 },
+];
+/** Detect automation level from user input text */
+export function detectAutomationLevel(input) {
+    const lower = input.toLowerCase();
+    for (const [keyword, levelNum] of Object.entries(KEYWORD_LEVEL_MAP)) {
+        const pattern = new RegExp(`\\b${keyword}\\b`);
+        if (pattern.test(lower)) {
+            return AUTOMATION_LEVELS[levelNum];
+        }
+    }
+    return AUTOMATION_LEVELS[2];
+}
+/** Get level by number */
+export function getAutomationLevel(level) {
+    return AUTOMATION_LEVELS[level];
+}
+/** Check if a specific action needs user confirmation at the given level */
+export function needsConfirmation(level, action) {
+    return CONFIRMATION_MATRIX[action].includes(level);
+}
+export function createTrustScore() {
+    return {
+        score: TRUST_SCORE_DEFAULTS.INITIAL,
+        level: 2,
+        consecutiveSuccesses: 0,
+        consecutiveFailures: 0,
+        totalActions: 0,
+    };
+}
+export function recordTrustSuccess(trust) {
+    const score = Math.min(TRUST_SCORE_DEFAULTS.MAX, trust.score + TRUST_SCORE_DEFAULTS.SUCCESS_DELTA);
+    const updated = {
+        score,
+        level: scorToLevel(score),
+        consecutiveSuccesses: trust.consecutiveSuccesses + 1,
+        consecutiveFailures: 0,
+        totalActions: trust.totalActions + 1,
+    };
+    return updated;
+}
+export function recordTrustFailure(trust) {
+    const score = Math.max(TRUST_SCORE_DEFAULTS.MIN, trust.score - TRUST_SCORE_DEFAULTS.FAILURE_DELTA);
+    const updated = {
+        score,
+        level: scorToLevel(score),
+        consecutiveSuccesses: 0,
+        consecutiveFailures: trust.consecutiveFailures + 1,
+        totalActions: trust.totalActions + 1,
+    };
+    return updated;
+}
+/** Get recommended level based on trust score */
+export function getRecommendedLevel(trust) {
+    return scorToLevel(trust.score);
+}
+function scorToLevel(score) {
+    for (const { max, level } of TRUST_LEVEL_THRESHOLDS) {
+        if (score <= max) {
+            return level;
+        }
+    }
+    return 4;
+}
+//# sourceMappingURL=AutomationLevel.js.map

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

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

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

@@ -0,0 +1,81 @@
+/**
+ * DecisionTracer — AI decision audit trail
+ *
+ * All data is stored locally only (JSONL).
+ * File: ~/.vibe/analytics/decisions.jsonl
+ */
+export interface DecisionRecord {
+    /** Schema version */
+    v: 1;
+    /** ISO 8601 timestamp */
+    ts: string;
+    /** Decision category */
+    category: DecisionCategory;
+    /** What was decided */
+    decision: string;
+    /** Why this was chosen (rationale) */
+    rationale: string;
+    /** What alternatives were considered */
+    alternatives: string[];
+    /** Context that informed the decision */
+    context: DecisionContext;
+    /** Outcome (filled later via updateOutcome) */
+    outcome?: DecisionOutcome;
+    /** Unique decision ID */
+    id: string;
+}
+export type DecisionCategory = 'architecture' | 'implementation' | 'fix_strategy' | 'verification' | 'retry' | 'scope_change' | 'tool_selection';
+export interface DecisionContext {
+    /** Feature/SPEC being worked on */
+    feature?: string;
+    /** Current phase */
+    phase?: string;
+    /** Related file paths */
+    files: string[];
+    /** Automation level at time of decision */
+    automationLevel?: number;
+}
+export interface DecisionOutcome {
+    /** Whether the decision led to success */
+    success: boolean;
+    /** Impact description */
+    impact: string;
+    /** Timestamp of outcome recording */
+    recordedAt: string;
+}
+export interface DecisionInput {
+    category: DecisionCategory;
+    decision: string;
+    rationale: string;
+    alternatives?: string[];
+    context?: Partial<DecisionContext>;
+}
+export interface FeatureSummary {
+    feature: string;
+    totalDecisions: number;
+    byCategory: Record<string, number>;
+    successRate: number | null;
+    decisions: DecisionRecord[];
+}
+export declare class DecisionTracer {
+    private readonly logPath;
+    private readonly enabled;
+    constructor(analyticsDir: string, enabled?: boolean);
+    /** Record a new decision */
+    record(input: DecisionInput): DecisionRecord;
+    /** Update outcome for a previous decision */
+    updateOutcome(decisionId: string, outcome: Omit<DecisionOutcome, 'recordedAt'>): boolean;
+    /** Read all decisions */
+    readAll(): DecisionRecord[];
+    /** Query decisions by category */
+    queryByCategory(category: DecisionCategory): DecisionRecord[];
+    /** Query decisions by feature */
+    queryByFeature(feature: string): DecisionRecord[];
+    /** Get recent decisions (last N) */
+    getRecent(count: number): DecisionRecord[];
+    /** Summarize decisions for a feature */
+    summarizeFeature(feature: string): FeatureSummary;
+    /** Get log path */
+    getLogPath(): string;
+}
+//# sourceMappingURL=DecisionTracer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DecisionTracer.d.ts","sourceRoot":"","sources":["../../../src/infra/lib/DecisionTracer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,CAAC,EAAE,CAAC,CAAC;IACL,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,wBAAwB;IACxB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,yCAAyC;IACzC,OAAO,EAAE,eAAe,CAAC;IACzB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,MAAM,gBAAgB,GACxB,cAAc,GACd,gBAAgB,GAChB,cAAc,GACd,cAAc,GACd,OAAO,GACP,cAAc,GACd,gBAAgB,CAAC;AAErB,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAuCD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,YAAY,EAAE,MAAM,EAAE,OAAO,UAAO;IAShD,4BAA4B;IAC5B,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc;IAY5C,6CAA6C;IAC7C,aAAa,CACX,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,GAC3C,OAAO;IAqBV,yBAAyB;IACzB,OAAO,IAAI,cAAc,EAAE;IAU3B,kCAAkC;IAClC,eAAe,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,EAAE;IAI7D,iCAAiC;IACjC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE;IAIjD,oCAAoC;IACpC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE;IAK1C,wCAAwC;IACxC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc;IAiBjD,mBAAmB;IACnB,UAAU,IAAI,MAAM;CAGrB"}

package/dist/infra/lib/DecisionTracer.js

@@ -0,0 +1,135 @@
+/**
+ * DecisionTracer — AI decision audit trail
+ *
+ * All data is stored locally only (JSONL).
+ * File: ~/.vibe/analytics/decisions.jsonl
+ */
+import fs from 'fs';
+import path from 'path';
+import crypto from 'crypto';
+function buildRecord(input) {
+    return {
+        v: 1,
+        id: crypto.randomUUID(),
+        ts: new Date().toISOString(),
+        category: input.category,
+        decision: input.decision,
+        rationale: input.rationale,
+        alternatives: input.alternatives ?? [],
+        context: {
+            files: [],
+            ...input.context,
+        },
+    };
+}
+function parseLines(content) {
+    return content
+        .trim()
+        .split('\n')
+        .filter(line => line.trim().length > 0)
+        .flatMap(line => {
+        try {
+            return [JSON.parse(line)];
+        }
+        catch {
+            return [];
+        }
+    });
+}
+function computeSuccessRate(decisions) {
+    const withOutcome = decisions.filter(d => d.outcome !== undefined);
+    if (withOutcome.length === 0)
+        return null;
+    const successes = withOutcome.filter(d => d.outcome.success).length;
+    return successes / withOutcome.length;
+}
+export class DecisionTracer {
+    logPath;
+    enabled;
+    constructor(analyticsDir, enabled = true) {
+        this.logPath = path.join(analyticsDir, 'decisions.jsonl');
+        this.enabled = enabled;
+        if (enabled) {
+            fs.mkdirSync(analyticsDir, { recursive: true });
+        }
+    }
+    /** Record a new decision */
+    record(input) {
+        const record = buildRecord(input);
+        if (this.enabled) {
+            try {
+                fs.appendFileSync(this.logPath, JSON.stringify(record) + '\n');
+            }
+            catch {
+                // Silent fail — tracing should never break the tool
+            }
+        }
+        return record;
+    }
+    /** Update outcome for a previous decision */
+    updateOutcome(decisionId, outcome) {
+        if (!this.enabled)
+            return false;
+        const records = this.readAll();
+        const index = records.findIndex(r => r.id === decisionId);
+        if (index === -1)
+            return false;
+        records[index] = {
+            ...records[index],
+            outcome: { ...outcome, recordedAt: new Date().toISOString() },
+        };
+        try {
+            const content = records.map(r => JSON.stringify(r)).join('\n') + '\n';
+            fs.writeFileSync(this.logPath, content);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Read all decisions */
+    readAll() {
+        if (!fs.existsSync(this.logPath))
+            return [];
+        try {
+            const content = fs.readFileSync(this.logPath, 'utf-8');
+            return parseLines(content);
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Query decisions by category */
+    queryByCategory(category) {
+        return this.readAll().filter(r => r.category === category);
+    }
+    /** Query decisions by feature */
+    queryByFeature(feature) {
+        return this.readAll().filter(r => r.context.feature === feature);
+    }
+    /** Get recent decisions (last N) */
+    getRecent(count) {
+        const all = this.readAll();
+        return all.slice(Math.max(0, all.length - count));
+    }
+    /** Summarize decisions for a feature */
+    summarizeFeature(feature) {
+        const decisions = this.queryByFeature(feature);
+        const byCategory = {};
+        for (const d of decisions) {
+            byCategory[d.category] = (byCategory[d.category] ?? 0) + 1;
+        }
+        return {
+            feature,
+            totalDecisions: decisions.length,
+            byCategory,
+            successRate: computeSuccessRate(decisions),
+            decisions,
+        };
+    }
+    /** Get log path */
+    getLogPath() {
+        return this.logPath;
+    }
+}
+//# sourceMappingURL=DecisionTracer.js.map

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

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

package/dist/infra/lib/DeepInit.js

@@ -216,30 +216,30 @@ export function generateNavigationHeader(dir, rootPath) {
  * Describe DeepInit workflow
  */
 export function describeDeepInitWorkflow() {
-    return `
-## DeepInit Workflow
-
-Hierarchical AI-readable documentation generation:
-
-\`\`\`
-project/
-├── AGENTS.md              ← Root documentation
-├── src/
-│   ├── AGENTS.md          ← <!-- Parent: ../AGENTS.md -->
-│   ├── components/
-│   │   └── AGENTS.md      ← <!-- Parent: ../AGENTS.md -->
-│   └── services/
-│       └── AGENTS.md      ← <!-- Parent: ../AGENTS.md -->
-└── tests/
-    └── AGENTS.md          ← <!-- Parent: ../AGENTS.md -->
-\`\`\`
-
-Features:
-- Parent references for navigation
-- Auto-detected purpose and conventions
-- Preserved manual notes on regeneration
-- Entry point identification
-- Child module linking
+    return `
+## DeepInit Workflow
+
+Hierarchical AI-readable documentation generation:
+
+\`\`\`
+project/
+├── AGENTS.md              ← Root documentation
+├── src/
+│   ├── AGENTS.md          ← <!-- Parent: ../AGENTS.md -->
+│   ├── components/
+│   │   └── AGENTS.md      ← <!-- Parent: ../AGENTS.md -->
+│   └── services/
+│       └── AGENTS.md      ← <!-- Parent: ../AGENTS.md -->
+└── tests/
+    └── AGENTS.md          ← <!-- Parent: ../AGENTS.md -->
+\`\`\`
+
+Features:
+- Parent references for navigation
+- Auto-detected purpose and conventions
+- Preserved manual notes on regeneration
+- Entry point identification
+- Child module linking
 `.trim();
 }
 //# sourceMappingURL=DeepInit.js.map

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

@@ -0,0 +1,75 @@
+/**
+ * InteractiveCheckpoint — Phase 전환 시 의사결정 게이트
+ *
+ * /vibe.run 워크플로우에서 주요 지점에 체크포인트를 삽입하여
+ * 사용자가 방향을 확인/수정할 수 있도록 함
+ */
+export type CheckpointType = 'requirements_confirm' | 'architecture_choice' | 'implementation_scope' | 'verification_result' | 'fix_strategy';
+export interface CheckpointOption {
+    /** Option key (e.g., 'a', 'b', 'c') */
+    key: string;
+    /** Option label */
+    label: string;
+    /** Detailed description */
+    description: string;
+}
+export interface Checkpoint {
+    /** Checkpoint type */
+    type: CheckpointType;
+    /** Title displayed to user */
+    title: string;
+    /** Context/summary shown to user */
+    summary: string;
+    /** Available options */
+    options: CheckpointOption[];
+    /** Default option key (if user doesn't choose) */
+    defaultOption: string;
+    /** Metadata */
+    metadata: Record<string, unknown>;
+}
+export interface CheckpointResult {
+    /** Which checkpoint was resolved */
+    type: CheckpointType;
+    /** Selected option key */
+    selectedOption: string;
+    /** Timestamp */
+    timestamp: string;
+    /** Whether this was auto-resolved (at high automation levels) */
+    autoResolved: boolean;
+}
+export interface CheckpointHistory {
+    feature: string;
+    results: CheckpointResult[];
+}
+/** Create a requirements confirmation checkpoint */
+export declare function createRequirementsCheckpoint(requirements: string[], featureName: string): Checkpoint;
+/** Create an architecture choice checkpoint with 3 approaches */
+export declare function createArchitectureCheckpoint(options: Array<{
+    approach: string;
+    pros: string[];
+    cons: string[];
+    effort: string;
+}>): Checkpoint;
+/** Create an implementation scope checkpoint */
+export declare function createScopeCheckpoint(files: Array<{
+    path: string;
+    action: 'create' | 'modify' | 'delete';
+}>, estimatedLines: number): Checkpoint;
+/** Create a verification result checkpoint */
+export declare function createVerificationCheckpoint(achievementRate: number, failedRequirements: string[], iteration: number): Checkpoint;
+/** Create a fix strategy checkpoint */
+export declare function createFixStrategyCheckpoint(issues: Array<{
+    severity: 'critical' | 'warning' | 'info';
+    description: string;
+}>): Checkpoint;
+/** Format a checkpoint as readable prompt text */
+export declare function formatCheckpoint(checkpoint: Checkpoint): string;
+/** Resolve a checkpoint with user's choice */
+export declare function resolveCheckpoint(checkpoint: Checkpoint, selectedKey: string): CheckpointResult;
+/** Auto-resolve a checkpoint using the default option */
+export declare function autoResolveCheckpoint(checkpoint: Checkpoint): CheckpointResult;
+/** Create a new checkpoint history for a feature */
+export declare function createHistory(feature: string): CheckpointHistory;
+/** Append a result to history (immutable — returns new history) */
+export declare function addToHistory(history: CheckpointHistory, result: CheckpointResult): CheckpointHistory;
+//# sourceMappingURL=InteractiveCheckpoint.d.ts.map