@su-record/vibe 3.2.64 → 4.0.1

package/dist/tools/spec/specLifecycle.js

@@ -1,147 +0,0 @@
-/**
- * SPEC lifecycle 규율 — 헤더의 닫힌 집합과 "썩은 앵커" 를 판정한다.
- *
- * 배경: `.vibe/specs/**` 는 VERIFIED 로 확정된 뒤에도 코드가 움직이면 그대로 남는다.
- * 실측(2026-09-02): 29개 중 20개에 Status 줄이 아예 없었고, 남은 9개의 값은 5가지
- * 형태로 갈라져 있었다 (`COMPLETE`, 소문자 `verified`, 후행 공백 …). 템플릿은
- * `DRAFT | APPROVED` 만 선언했으니 선언과 실물이 이미 어긋나 있었다.
- *
- * 두 가지를 고정한다:
- *  - **닫힌 집합** — Status·Class 는 여기 있는 값만 쓸 수 있다. 새 값을 만들려면
- *    이 파일을 고쳐야 하고, 그 순간 리뷰 대상이 된다.
- *  - **Anchors** — VERIFIED 이고 코드에 고정되는 Class 인 SPEC 은 자기가 안착한
- *    경로를 나열해야 한다. 그 경로가 사라지면 게이트가 실패한다. lifecycle 표기만으로는
- *    썩음을 못 잡는다 — 문서는 Status 를 바꾸지 않은 채 늙기 때문이다.
- *
- * 경로 존재 검사는 여기서 하지 않는다. 이 모듈은 순수 함수로 두고(하네스·CWD 무관),
- * 파일시스템 판정은 `scripts/validate-spec-lifecycle.ts` 가 맡는다.
- */
-import path from 'path';
-/** SPEC 이 가질 수 있는 lifecycle 상태 — 이 집합 밖의 값은 게이트가 거부한다 */
-export const SPEC_STATUSES = ['DRAFT', 'APPROVED', 'VERIFIED', 'SUPERSEDED', 'REJECTED'];
-/** SPEC 의 변경 종류 — dsh Agent Note 의 닫힌 6종을 그대로 쓴다 */
-export const SPEC_CLASSES = [
-    'feature',
-    'bug-fix',
-    'simplification',
-    'architecture',
-    'process',
-    'testing',
-];
-/**
- * Anchors 를 요구하는 Class.
- *
- * 코드 경로에 실제로 안착하는 종류만 넣는다. process/testing/simplification 은
- * 규약·워크플로 변경이라 고정할 경로가 없는 경우가 많고, 억지로 요구하면 통과 의식이 된다.
- */
-export const ANCHOR_REQUIRED_CLASSES = ['feature', 'bug-fix', 'architecture'];
-const STATUS_LINE = /^\s*[-*]?\s*\*{0,2}Status\*{0,2}\s*[:：]\s*(.+)$/im;
-const CLASS_LINE = /^\s*[-*]?\s*\*{0,2}Class\*{0,2}\s*[:：]\s*(.+)$/im;
-const ANCHORS_HEADING = /^#{2,4}\s*(?:Anchors|앵커)\s*$/im;
-const LIST_ITEM = /^\s*[-*]\s+(.+)$/;
-/**
- * 분할 SPEC 의 phase 파일은 헤더를 요구하지 않는다 — 헤더는 `_index.md` 한 벌이
- * SSOT 다. phase 파일마다 Status 를 두면 둘이 어긋나는 새 드리프트를 만든다.
- */
-export function isLifecycleExempt(specPath) {
-    return /^phase-\d+-/.test(path.basename(specPath));
-}
-/**
- * 헤더 값에서 첫 토큰만 뽑는다 — `VERIFIED (2026-08-29 — …)` 의 괄호 뒷말은 자유 서술이다.
- *
- * 하이픈은 구분자로 쓰지 않는다: Class `bug-fix` 가 `bug` 로 잘린다.
- */
-function firstToken(value) {
-    return value.trim().split(/[\s(·—]/)[0].trim();
-}
-function parseAnchors(content) {
-    const heading = content.match(ANCHORS_HEADING);
-    if (!heading)
-        return undefined;
-    const level = (heading[0].match(/^#+/) ?? ['#'])[0].length;
-    const after = content.slice((heading.index ?? 0) + heading[0].length);
-    const next = after.search(new RegExp(`^#{1,${level}}\\s`, 'm'));
-    const body = next === -1 ? after : after.slice(0, next);
-    const out = [];
-    for (const line of body.split('\n')) {
-        const m = line.match(LIST_ITEM);
-        if (!m)
-            continue;
-        const code = m[1].match(/`([^`]+)`/);
-        out.push((code ? code[1] : m[1]).trim());
-    }
-    return out;
-}
-/** SPEC 원문에서 lifecycle 헤더를 읽는다 */
-export function parseSpecLifecycle(content) {
-    const status = content.match(STATUS_LINE);
-    const specClass = content.match(CLASS_LINE);
-    return {
-        status: status ? firstToken(status[1]) : undefined,
-        specClass: specClass ? firstToken(specClass[1]).toLowerCase() : undefined,
-        anchors: parseAnchors(content),
-    };
-}
-function checkStatus(header, out) {
-    if (!header.status) {
-        out.push({
-            code: 'no-spec-status',
-            message: `Status 필드가 없다 — lifecycle 을 판정할 수 없다 (${SPEC_STATUSES.join(' | ')}).`,
-        });
-        return;
-    }
-    if (!SPEC_STATUSES.includes(header.status)) {
-        out.push({
-            code: 'invalid-spec-status',
-            message: `Status 값을 알 수 없다: "${header.status}" — ${SPEC_STATUSES.join(' | ')} 중 하나여야 한다.`,
-        });
-    }
-}
-function checkClass(header, out) {
-    if (!header.specClass) {
-        out.push({
-            code: 'no-spec-class',
-            message: `Class 필드가 없다 — Anchors 요구 여부를 판정할 수 없다 (${SPEC_CLASSES.join(' | ')}).`,
-        });
-        return;
-    }
-    if (!SPEC_CLASSES.includes(header.specClass)) {
-        out.push({
-            code: 'invalid-spec-class',
-            message: `Class 값을 알 수 없다: "${header.specClass}" — ${SPEC_CLASSES.join(' | ')} 중 하나여야 한다.`,
-        });
-    }
-}
-/** VERIFIED + 코드성 Class 면 Anchors 절이 있고 비어 있지 않아야 한다 */
-export function anchorsRequired(header) {
-    return header.status === 'VERIFIED'
-        && ANCHOR_REQUIRED_CLASSES.includes(header.specClass ?? '');
-}
-function checkAnchors(header, out) {
-    if (!anchorsRequired(header))
-        return;
-    if (!header.anchors || header.anchors.length === 0) {
-        out.push({
-            code: 'no-anchors',
-            message: `VERIFIED + Class ${header.specClass} 인 SPEC 은 "## Anchors" 절에 안착한 경로를 나열해야 한다 `
-                + '— 경로가 사라지면 게이트가 썩음을 잡는다.',
-        });
-    }
-}
-/**
- * 내용만으로 판정 가능한 lifecycle 검사.
- *
- * @param content SPEC 마크다운 원문
- * @param specPath 파일 경로 — phase 파일 면제 판정에 쓴다
- */
-export function checkSpecLifecycle(content, specPath) {
-    if (specPath && isLifecycleExempt(specPath))
-        return [];
-    const header = parseSpecLifecycle(content);
-    const out = [];
-    checkStatus(header, out);
-    checkClass(header, out);
-    checkAnchors(header, out);
-    return out;
-}
-//# sourceMappingURL=specLifecycle.js.map

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

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

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

@@ -1,56 +0,0 @@
-/**
- * Traceability Matrix - 요구사항 추적 매트릭스 자동 생성
- *
- * 매핑: REQ → SPEC → Feature → Test
- */
-/** 추적 항목 */
-export interface TraceItem {
-    requirementId: string;
-    requirementDesc: string;
-    specSection?: string;
-    specFile?: string;
-    featureScenario?: string;
-    featureFile?: string;
-    testFile?: string;
-    testName?: string;
-    coverage: 'full' | 'partial' | 'none';
-}
-/** 추적 매트릭스 */
-export interface TraceabilityMatrix {
-    featureName: string;
-    items: TraceItem[];
-    summary: TraceSummary;
-    generatedAt: string;
-    status: 'ok' | 'empty';
-    warnings: string[];
-}
-/** 추적 요약 */
-export interface TraceSummary {
-    totalRequirements: number;
-    specCovered: number;
-    featureCovered: number;
-    testCovered: number;
-    coveragePercent: number;
-    uncoveredRequirements: string[];
-    partialRequirements: string[];
-}
-/** 매트릭스 생성 옵션 */
-export interface TraceMatrixOptions {
-    specPath?: string;
-    featurePath?: string;
-    testPath?: string;
-    projectPath?: string;
-}
-/**
- * 추적 매트릭스 생성 (메인 함수)
- */
-export declare function generateTraceabilityMatrix(featureName: string, options?: TraceMatrixOptions): TraceabilityMatrix;
-/**
- * 매트릭스를 Markdown 테이블로 출력
- */
-export declare function formatMatrixAsMarkdown(matrix: TraceabilityMatrix): string;
-/**
- * 매트릭스를 HTML로 출력
- */
-export declare function formatMatrixAsHtml(matrix: TraceabilityMatrix): string;
-//# sourceMappingURL=traceabilityMatrix.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"traceabilityMatrix.d.ts","sourceRoot":"","sources":["../../../src/tools/spec/traceabilityMatrix.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,YAAY;AACZ,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;CACvC;AAED,cAAc;AACd,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,YAAY;AACZ,MAAM,WAAW,YAAY;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,iBAAiB;AACjB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA0CD;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,kBAAuB,GAC/B,kBAAkB,CA+FpB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAiEzE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CA0ErE"}