@su-record/vibe 2.5.21 → 2.6.1

package/dist/tools/spec/specGenerator.js

@@ -0,0 +1,426 @@
+/**
+ * SPEC Generator - PRD에서 PTCF 구조 SPEC 자동 생성
+ * v2.6.0: PRD-to-SPEC 자동화
+ *
+ * PTCF: Persona, Task, Context, Format (Gemini 프롬프트 최적화)
+ */
+// ============================================
+// Main Generator
+// ============================================
+/**
+ * PRD에서 SPEC 생성 (메인 함수)
+ */
+export function generateSpec(prd, featureName, options = {}) {
+    const { techStack = [], phaseThreshold = 5, relatedCodePaths = [], designReference, additionalConstraints = [], additionalOutputs = [], } = options;
+    // Phase 분리 결정
+    const shouldSplit = prd.requirements.length > phaseThreshold * 3;
+    const phases = groupRequirementsIntoPhases(prd.requirements, phaseThreshold);
+    if (shouldSplit) {
+        return generateSplitSpec(prd, featureName, phases, options);
+    }
+    return generateSingleSpec(prd, featureName, phases, options);
+}
+/**
+ * 단일 SPEC 파일 생성
+ */
+function generateSingleSpec(prd, featureName, phases, options) {
+    const content = buildSpecContent(prd, featureName, phases, options);
+    return {
+        content,
+        featureName,
+        phaseCount: phases.length,
+        requirementCount: prd.requirements.length,
+        isSplit: false,
+    };
+}
+/**
+ * 분할 SPEC 파일 생성
+ */
+function generateSplitSpec(prd, featureName, phases, options) {
+    const splitFiles = [];
+    // 마스터 SPEC
+    const masterContent = buildMasterSpecContent(prd, featureName, phases, options);
+    splitFiles.push({
+        path: `_index.md`,
+        content: masterContent,
+    });
+    // Phase별 SPEC
+    for (let i = 0; i < phases.length; i++) {
+        const phase = phases[i];
+        const phaseContent = buildPhaseSpecContent(prd, featureName, phase, i + 1, phases.length, options);
+        const phaseName = normalizeFileName(phase.name);
+        splitFiles.push({
+            path: `phase-${i + 1}-${phaseName}.md`,
+            content: phaseContent,
+        });
+    }
+    return {
+        content: masterContent,
+        featureName,
+        phaseCount: phases.length,
+        requirementCount: prd.requirements.length,
+        isSplit: true,
+        splitFiles,
+    };
+}
+// ============================================
+// Content Builders
+// ============================================
+/**
+ * 단일 SPEC 콘텐츠 빌드
+ */
+function buildSpecContent(prd, featureName, phases, options) {
+    const { techStack = [], relatedCodePaths = [], designReference, additionalConstraints = [], additionalOutputs = [] } = options;
+    const now = new Date().toISOString();
+    let content = `---
+status: pending
+currentPhase: 0
+totalPhases: ${phases.length}
+createdAt: ${now}
+lastUpdated: ${now}
+---
+
+# SPEC: ${featureName}
+
+## Persona
+<role>
+Senior developer implementing ${featureName}.
+- Follow existing code patterns and conventions
+- Write testable, maintainable code
+- Consider security and performance implications
+</role>
+
+## Context
+<context>
+### Background
+${prd.description || `Implementation of ${prd.title}`}
+
+### Tech Stack
+${techStack.length > 0 ? techStack.map(t => `- ${t}`).join('\n') : '- (To be determined based on project)'}
+
+### Related Code
+${relatedCodePaths.length > 0 ? relatedCodePaths.map(p => `- \`${p}\``).join('\n') : '- (Analyze existing codebase for patterns)'}
+
+### Design Reference
+${designReference || '- (None specified)'}
+
+### Requirements Source
+- Parsed from PRD: ${prd.requirements.length} requirements
+- Format: ${prd.metadata.format}
+</context>
+
+## Task
+<task>
+`;
+    // Phase별 태스크 추가
+    for (let i = 0; i < phases.length; i++) {
+        const phase = phases[i];
+        content += `### Phase ${i + 1}: ${phase.name}\n`;
+        content += `**Goal**: ${getPhaseGoal(phase)}\n\n`;
+        for (const task of phase.tasks) {
+            content += `1. [ ] ${task}\n`;
+        }
+        content += '\n';
+    }
+    content += `</task>
+
+## Constraints
+<constraints>
+### Must Follow
+- Follow existing code patterns (ES Module, async/await)
+- Maintain backward compatibility
+- TypeScript strict mode compliance
+- No \`any\` type → Use \`unknown\` + type guards
+- Functions ≤30 lines recommended, ≤50 lines max
+- Nesting ≤3 levels
+
+### Error Handling
+- Proper try-catch with meaningful error messages
+- Loading state handling for async operations
+- User-friendly error messages
+
+### Security
+- Input validation for all user inputs
+- Authentication/authorization checks where needed
+- No sensitive data in logs
+${additionalConstraints.map(c => `\n- ${c}`).join('')}
+</constraints>
+
+## Output Format
+<output_format>
+### Files to Create
+${generateFileList(phases, 'create')}
+
+### Files to Modify
+${generateFileList(phases, 'modify')}
+
+### Verification Commands
+- \`npm run build\` (build success)
+- \`npm test\` (tests pass)
+- \`tsc --noEmit\` (type check)
+${additionalOutputs.map(o => `- ${o}`).join('\n')}
+</output_format>
+
+## Acceptance Criteria
+<acceptance>
+`;
+    // 요구사항별 AC 추가
+    for (const req of prd.requirements) {
+        content += `### ${req.id}: ${truncateText(req.description, 60)}\n`;
+        if (req.acceptanceCriteria.length > 0) {
+            for (const ac of req.acceptanceCriteria) {
+                content += `- [ ] ${ac}\n`;
+            }
+        }
+        else {
+            content += `- [ ] ${req.description} - implemented and verified\n`;
+        }
+        content += '\n';
+    }
+    content += `### Build & Test
+- [ ] \`npm run build\` succeeds
+- [ ] All tests pass
+- [ ] No TypeScript errors
+</acceptance>
+`;
+    return content;
+}
+/**
+ * 마스터 SPEC 콘텐츠 빌드 (분할용)
+ */
+function buildMasterSpecContent(prd, featureName, phases, options) {
+    const now = new Date().toISOString();
+    let content = `---
+status: pending
+currentPhase: 0
+totalPhases: ${phases.length}
+createdAt: ${now}
+lastUpdated: ${now}
+isMaster: true
+---
+
+# SPEC: ${featureName} (Master)
+
+## Overview
+- **Feature**: ${prd.title}
+- **Total Phases**: ${phases.length}
+- **Total Requirements**: ${prd.requirements.length}
+- **Format**: Split SPEC (large scope)
+
+## Sub-SPECs
+
+| Order | SPEC File | Description | Status |
+|-------|-----------|-------------|--------|
+`;
+    for (let i = 0; i < phases.length; i++) {
+        const phase = phases[i];
+        const fileName = `phase-${i + 1}-${normalizeFileName(phase.name)}.md`;
+        content += `| ${i + 1} | ${fileName} | ${phase.name} | ⬜ |\n`;
+    }
+    content += `
+## Shared Context
+
+### Tech Stack
+${options.techStack?.map(t => `- ${t}`).join('\n') || '- (See project configuration)'}
+
+### Constraints (Apply to All Phases)
+- Follow existing code patterns
+- TypeScript strict mode
+- No \`any\` type
+- Functions ≤50 lines max
+${options.additionalConstraints?.map(c => `- ${c}`).join('\n') || ''}
+
+## Execution Order
+\`\`\`
+${phases.map((p, i) => `Phase ${i + 1}: ${p.name}`).join(' → ')}
+\`\`\`
+
+## Dependencies
+${generateDependencyList(phases)}
+`;
+    return content;
+}
+/**
+ * Phase별 SPEC 콘텐츠 빌드
+ */
+function buildPhaseSpecContent(prd, featureName, phase, phaseNumber, totalPhases, options) {
+    const now = new Date().toISOString();
+    let content = `---
+status: pending
+phase: ${phaseNumber}
+totalPhases: ${totalPhases}
+masterSpec: _index.md
+createdAt: ${now}
+lastUpdated: ${now}
+---
+
+# SPEC: ${featureName} - Phase ${phaseNumber}: ${phase.name}
+
+## Persona
+<role>
+Developer implementing Phase ${phaseNumber} of ${featureName}.
+- Focus on ${phase.name}
+- Follow project conventions
+- Write testable code
+</role>
+
+## Context
+<context>
+### Phase Goal
+${getPhaseGoal(phase)}
+
+### Requirements (${phase.requirements.length})
+${phase.requirements.map(r => `- ${r.id}: ${truncateText(r.description, 50)}`).join('\n')}
+
+### Dependencies
+${phaseNumber > 1 ? `- Requires Phase ${phaseNumber - 1} completion` : '- No dependencies (first phase)'}
+</context>
+
+## Task
+<task>
+`;
+    for (const task of phase.tasks) {
+        content += `1. [ ] ${task}\n`;
+    }
+    content += `</task>
+
+## Acceptance Criteria
+<acceptance>
+`;
+    for (const req of phase.requirements) {
+        content += `- [ ] ${req.id}: ${truncateText(req.description, 60)}\n`;
+    }
+    content += `- [ ] Phase ${phaseNumber} build succeeds
+- [ ] Phase ${phaseNumber} tests pass
+</acceptance>
+`;
+    return content;
+}
+// ============================================
+// Helper Functions
+// ============================================
+/**
+ * 요구사항을 Phase로 그룹화
+ */
+function groupRequirementsIntoPhases(requirements, threshold) {
+    if (requirements.length <= threshold) {
+        return [{
+                name: 'Implementation',
+                requirements,
+                tasks: requirements.map(r => generateTaskFromRequirement(r)),
+            }];
+    }
+    // 우선순위별 그룹화
+    const high = requirements.filter(r => r.priority === 'high');
+    const medium = requirements.filter(r => r.priority === 'medium');
+    const low = requirements.filter(r => r.priority === 'low');
+    const phases = [];
+    // Phase 1: 설정/기반
+    const setupReqs = requirements.slice(0, Math.ceil(threshold / 2));
+    if (setupReqs.length > 0) {
+        phases.push({
+            name: 'Setup & Foundation',
+            requirements: setupReqs,
+            tasks: setupReqs.map(r => generateTaskFromRequirement(r)),
+        });
+    }
+    // Phase 2+: 핵심 기능 (high priority)
+    if (high.length > 0) {
+        phases.push({
+            name: 'Core Features',
+            requirements: high,
+            tasks: high.map(r => generateTaskFromRequirement(r)),
+        });
+    }
+    // Phase 3+: 중요 기능 (medium priority)
+    const remainingMedium = medium.filter(r => !setupReqs.includes(r));
+    if (remainingMedium.length > 0) {
+        phases.push({
+            name: 'Additional Features',
+            requirements: remainingMedium,
+            tasks: remainingMedium.map(r => generateTaskFromRequirement(r)),
+        });
+    }
+    // Phase 4+: 부가 기능 (low priority)
+    if (low.length > 0) {
+        phases.push({
+            name: 'Enhancements',
+            requirements: low,
+            tasks: low.map(r => generateTaskFromRequirement(r)),
+        });
+    }
+    // 마지막 Phase: 테스트 & 검증
+    phases.push({
+        name: 'Testing & Verification',
+        requirements: [],
+        tasks: [
+            'Write unit tests for all new code',
+            'Write integration tests',
+            'Update documentation',
+            'Final verification and cleanup',
+        ],
+    });
+    return phases;
+}
+/**
+ * 요구사항에서 태스크 생성
+ */
+function generateTaskFromRequirement(req) {
+    const desc = truncateText(req.description, 80);
+    return `${req.id}: ${desc}\n   - Verify: Test coverage for this requirement`;
+}
+/**
+ * Phase 목표 추출
+ */
+function getPhaseGoal(phase) {
+    if (phase.requirements.length === 0) {
+        return phase.name;
+    }
+    const firstReq = phase.requirements[0];
+    return truncateText(firstReq.description, 100);
+}
+/**
+ * 파일 목록 생성
+ */
+function generateFileList(phases, type) {
+    // 실제로는 요구사항을 분석해서 추론해야 하지만, 기본 템플릿 제공
+    if (type === 'create') {
+        return `- (To be determined based on implementation)
+- \`src/[feature]/index.ts\`
+- \`src/[feature]/[feature].test.ts\``;
+    }
+    return `- (Analyze existing codebase)
+- Relevant existing files`;
+}
+/**
+ * 의존성 목록 생성
+ */
+function generateDependencyList(phases) {
+    if (phases.length <= 1) {
+        return '- No inter-phase dependencies';
+    }
+    let deps = '';
+    for (let i = 1; i < phases.length; i++) {
+        deps += `- Phase ${i + 1} depends on Phase ${i}\n`;
+    }
+    return deps;
+}
+/**
+ * 파일명 정규화
+ */
+function normalizeFileName(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '')
+        .slice(0, 30);
+}
+/**
+ * 텍스트 자르기
+ */
+function truncateText(text, maxLength) {
+    if (text.length <= maxLength)
+        return text;
+    return text.slice(0, maxLength - 3) + '...';
+}
+//# sourceMappingURL=specGenerator.js.map

package/dist/tools/spec/specGenerator.js.map

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

package/dist/tools/spec/specVersioning.d.ts

@@ -0,0 +1,77 @@
+/**
+ * SPEC Versioning - SPEC 버전 관리 및 Changelog 자동 생성
+ * v2.6.0: Git 연동 버전 관리
+ */
+/** SPEC 버전 정보 */
+export interface SpecVersion {
+    version: string;
+    date: string;
+    author?: string;
+    changes: ChangeEntry[];
+    gitTag?: string;
+    gitCommit?: string;
+}
+/** 변경 항목 */
+export interface ChangeEntry {
+    type: 'added' | 'changed' | 'removed' | 'fixed';
+    description: string;
+    section?: string;
+    requirementId?: string;
+}
+/** 버전 히스토리 */
+export interface VersionHistory {
+    featureName: string;
+    currentVersion: string;
+    versions: SpecVersion[];
+}
+/** 버전 범프 타입 */
+export type BumpType = 'major' | 'minor' | 'patch';
+/**
+ * SPEC 버전 범프
+ */
+export declare function bumpSpecVersion(specPath: string, bumpType: BumpType, changes: ChangeEntry[]): SpecVersion;
+/**
+ * 버전 추출
+ */
+export declare function extractVersion(content: string): string | null;
+/**
+ * 버전 증가
+ */
+export declare function incrementVersion(version: string, bumpType: BumpType): string;
+/**
+ * Changelog 생성
+ */
+export declare function generateChangelog(history: VersionHistory): string;
+/**
+ * Git 태그 생성
+ */
+export declare function createGitTag(featureName: string, version: string, message?: string): {
+    success: boolean;
+    tag: string;
+    error?: string;
+};
+/**
+ * SPEC 변경사항 감지 (Git diff 기반)
+ */
+export declare function detectSpecChanges(specPath: string, baseRef?: string): ChangeEntry[];
+/**
+ * 최신 SPEC 커밋 조회
+ */
+export declare function getLatestSpecCommit(specPath: string): string | null;
+/**
+ * SPEC 버전 히스토리 로드
+ */
+export declare function loadVersionHistory(specDir: string, featureName: string): VersionHistory;
+/**
+ * SPEC 버전 히스토리 저장
+ */
+export declare function saveVersionHistory(specDir: string, history: VersionHistory): void;
+/**
+ * Baseline 태깅 (릴리즈 준비 완료 표시)
+ */
+export declare function createBaseline(featureName: string, specPath: string): {
+    success: boolean;
+    baselineName: string;
+    error?: string;
+};
+//# sourceMappingURL=specVersioning.d.ts.map

package/dist/tools/spec/specVersioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specVersioning.d.ts","sourceRoot":"","sources":["../../../src/tools/spec/specVersioning.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,iBAAiB;AACjB,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,YAAY;AACZ,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,cAAc;AACd,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,eAAe;AACf,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAMnD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,WAAW,EAAE,GACrB,WAAW,CAgBb;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG7D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAU5E;AA4BD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CA0BjE;AAoBD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAcnD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,MAAiB,GACzB,WAAW,EAAE,CAyCf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOnE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc,CAavF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAGjF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAsB5D"}