sdd-tool 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,240 @@
+/**
+ * 공통 타입 정의
+ */
+/**
+ * 스펙 문서 구조
+ */
+interface Spec {
+    id: string;
+    title: string;
+    status: SpecStatus;
+    requirements: Requirement[];
+    scenarios: Scenario[];
+    dependencies: string[];
+    metadata: SpecMetadata;
+}
+type SpecStatus = 'draft' | 'approved' | 'implemented';
+interface SpecMetadata {
+    created?: string;
+    updated?: string;
+    author?: string;
+}
+/**
+ * 요구사항 (RFC 2119)
+ */
+interface Requirement {
+    id: string;
+    level: RequirementLevel;
+    description: string;
+}
+type RequirementLevel = 'SHALL' | 'MUST' | 'SHOULD' | 'MAY';
+/**
+ * 시나리오 (GIVEN-WHEN-THEN)
+ */
+interface Scenario {
+    name: string;
+    given: string[];
+    when: string;
+    then: string[];
+}
+/**
+ * Constitution 원칙
+ */
+interface Principle {
+    id: string;
+    title: string;
+    description: string;
+    level: PrincipleLevel;
+}
+type PrincipleLevel = 'core' | 'technical' | 'forbidden';
+interface Constitution {
+    projectName: string;
+    principles: Principle[];
+    technicalStack?: string[];
+    constraints?: string[];
+}
+/**
+ * 변경 제안
+ */
+interface Proposal {
+    id: string;
+    title: string;
+    rationale: string;
+    affectedSpecs: string[];
+    deltas: Delta[];
+    status: ProposalStatus;
+    createdAt: string;
+}
+type ProposalStatus = 'draft' | 'review' | 'approved' | 'applied' | 'archived';
+/**
+ * 델타 (변경사항)
+ */
+interface Delta {
+    type: DeltaType;
+    target: string;
+    before?: string;
+    after?: string;
+}
+type DeltaType = 'ADDED' | 'MODIFIED' | 'REMOVED';
+/**
+ * 검증 결과
+ */
+interface ValidationResult {
+    valid: boolean;
+    errors: SpecValidationError[];
+    warnings: SpecValidationWarning[];
+}
+interface SpecValidationError {
+    code: string;
+    message: string;
+    location?: Location;
+}
+interface SpecValidationWarning {
+    code: string;
+    message: string;
+    location?: Location;
+}
+interface Location {
+    file?: string;
+    line?: number;
+    column?: number;
+}
+/**
+ * 분석 결과
+ */
+interface AnalysisResult {
+    scale: Scale;
+    recommendation: WorkflowRecommendation;
+    confidence: number;
+    rationale: string;
+    alternatives: string[];
+}
+type Scale = 'small' | 'medium' | 'large';
+type WorkflowRecommendation = 'direct' | 'change' | 'new';
+/**
+ * Result 타입 (에러 처리용)
+ */
+type Result<T, E = Error> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: E;
+};
+/**
+ * 성공 결과 생성 헬퍼
+ */
+declare function success<T>(data: T): Result<T, never>;
+/**
+ * 실패 결과 생성 헬퍼
+ */
+declare function failure<E>(error: E): Result<never, E>;
+
+/**
+ * 에러 코드 정의
+ */
+/**
+ * CLI 종료 코드
+ */
+declare const ExitCode: {
+    readonly SUCCESS: 0;
+    readonly GENERAL_ERROR: 1;
+    readonly VALIDATION_FAILED: 2;
+    readonly CONSTITUTION_VIOLATION: 3;
+    readonly FILE_SYSTEM_ERROR: 4;
+    readonly USER_CANCELLED: 5;
+};
+type ExitCode = (typeof ExitCode)[keyof typeof ExitCode];
+/**
+ * 에러 코드
+ */
+declare const ErrorCode: {
+    readonly UNKNOWN: "E001";
+    readonly INVALID_ARGUMENT: "E002";
+    readonly NOT_INITIALIZED: "E003";
+    readonly FILE_NOT_FOUND: "E101";
+    readonly FILE_READ_ERROR: "E102";
+    readonly FILE_WRITE_ERROR: "E103";
+    readonly DIRECTORY_NOT_FOUND: "E104";
+    readonly DIRECTORY_EXISTS: "E105";
+    readonly SPEC_PARSE_ERROR: "E201";
+    readonly SPEC_INVALID_FORMAT: "E202";
+    readonly SPEC_MISSING_REQUIRED: "E203";
+    readonly RFC2119_VIOLATION: "E204";
+    readonly GWT_INVALID_FORMAT: "E205";
+    readonly CONSTITUTION_NOT_FOUND: "E301";
+    readonly CONSTITUTION_PARSE_ERROR: "E302";
+    readonly CONSTITUTION_VIOLATION: "E303";
+    readonly PROPOSAL_NOT_FOUND: "E401";
+    readonly PROPOSAL_INVALID: "E402";
+    readonly DELTA_CONFLICT: "E403";
+    readonly ARCHIVE_FAILED: "E404";
+    readonly ANALYSIS_FAILED: "E501";
+    readonly INSUFFICIENT_DATA: "E502";
+};
+type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];
+
+/**
+ * 에러 메시지 정의
+ */
+
+/**
+ * 에러 코드별 메시지 템플릿
+ */
+declare const ErrorMessages: Record<ErrorCode, string>;
+/**
+ * 메시지 템플릿에 인자를 적용
+ */
+declare function formatMessage(code: ErrorCode, ...args: string[]): string;
+
+/**
+ * 에러 기본 클래스
+ */
+
+/**
+ * SDD 도구의 기본 에러 클래스
+ */
+declare class SddError extends Error {
+    readonly code: ErrorCode;
+    readonly exitCode: ExitCode;
+    constructor(code: ErrorCode, message?: string, exitCode?: ExitCode);
+    /**
+     * 사용자 친화적 메시지
+     */
+    toUserMessage(): string;
+}
+/**
+ * 파일 시스템 에러
+ */
+declare class FileSystemError extends SddError {
+    readonly path: string;
+    constructor(code: ErrorCode, path: string);
+}
+/**
+ * 스펙 검증 에러
+ */
+declare class ValidationError extends SddError {
+    readonly details: string;
+    constructor(code: ErrorCode, details: string);
+}
+/**
+ * Constitution 위반 에러
+ */
+declare class ConstitutionError extends SddError {
+    readonly principle: string;
+    constructor(principle: string);
+}
+/**
+ * 사용자 취소 에러
+ */
+declare class UserCancelledError extends SddError {
+    constructor(message?: string);
+}
+/**
+ * 변경 워크플로우 에러
+ */
+declare class ChangeError extends SddError {
+    constructor(message: string);
+}
+
+export { type AnalysisResult, ChangeError, type Constitution, ConstitutionError, type Delta, type DeltaType, ErrorCode, ErrorMessages, ExitCode, FileSystemError, type Location, type Principle, type PrincipleLevel, type Proposal, type ProposalStatus, type Requirement, type RequirementLevel, type Result, type Scale, type Scenario, SddError, type Spec, type SpecMetadata, type SpecStatus, type SpecValidationError, type SpecValidationWarning, UserCancelledError, ValidationError, type ValidationResult, type WorkflowRecommendation, failure, formatMessage, success };

package/dist/index.js

@@ -0,0 +1,160 @@
+// src/types/index.ts
+function success(data) {
+  return { success: true, data };
+}
+function failure(error) {
+  return { success: false, error };
+}
+
+// src/errors/codes.ts
+var ExitCode = {
+  SUCCESS: 0,
+  GENERAL_ERROR: 1,
+  VALIDATION_FAILED: 2,
+  CONSTITUTION_VIOLATION: 3,
+  FILE_SYSTEM_ERROR: 4,
+  USER_CANCELLED: 5
+};
+var ErrorCode = {
+  // 일반 에러 (E0xx)
+  UNKNOWN: "E001",
+  INVALID_ARGUMENT: "E002",
+  NOT_INITIALIZED: "E003",
+  // 파일 시스템 에러 (E1xx)
+  FILE_NOT_FOUND: "E101",
+  FILE_READ_ERROR: "E102",
+  FILE_WRITE_ERROR: "E103",
+  DIRECTORY_NOT_FOUND: "E104",
+  DIRECTORY_EXISTS: "E105",
+  // 스펙 검증 에러 (E2xx)
+  SPEC_PARSE_ERROR: "E201",
+  SPEC_INVALID_FORMAT: "E202",
+  SPEC_MISSING_REQUIRED: "E203",
+  RFC2119_VIOLATION: "E204",
+  GWT_INVALID_FORMAT: "E205",
+  // Constitution 에러 (E3xx)
+  CONSTITUTION_NOT_FOUND: "E301",
+  CONSTITUTION_PARSE_ERROR: "E302",
+  CONSTITUTION_VIOLATION: "E303",
+  // 변경 워크플로우 에러 (E4xx)
+  PROPOSAL_NOT_FOUND: "E401",
+  PROPOSAL_INVALID: "E402",
+  DELTA_CONFLICT: "E403",
+  ARCHIVE_FAILED: "E404",
+  // 분석 에러 (E5xx)
+  ANALYSIS_FAILED: "E501",
+  INSUFFICIENT_DATA: "E502"
+};
+
+// src/errors/messages.ts
+var ErrorMessages = {
+  // 일반 에러
+  [ErrorCode.UNKNOWN]: "\uC54C \uC218 \uC5C6\uB294 \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4",
+  [ErrorCode.INVALID_ARGUMENT]: "\uC798\uBABB\uB41C \uC778\uC790\uC785\uB2C8\uB2E4: {0}",
+  [ErrorCode.NOT_INITIALIZED]: "SDD \uD504\uB85C\uC81D\uD2B8\uAC00 \uCD08\uAE30\uD654\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. `sdd init`\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694",
+  // 파일 시스템 에러
+  [ErrorCode.FILE_NOT_FOUND]: "\uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: {0}",
+  [ErrorCode.FILE_READ_ERROR]: "\uD30C\uC77C \uC77D\uAE30 \uC2E4\uD328: {0}",
+  [ErrorCode.FILE_WRITE_ERROR]: "\uD30C\uC77C \uC4F0\uAE30 \uC2E4\uD328: {0}",
+  [ErrorCode.DIRECTORY_NOT_FOUND]: "\uB514\uB809\uD1A0\uB9AC\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: {0}",
+  [ErrorCode.DIRECTORY_EXISTS]: "\uB514\uB809\uD1A0\uB9AC\uAC00 \uC774\uBBF8 \uC874\uC7AC\uD569\uB2C8\uB2E4: {0}",
+  // 스펙 검증 에러
+  [ErrorCode.SPEC_PARSE_ERROR]: "\uC2A4\uD399 \uD30C\uC2F1 \uC2E4\uD328: {0}",
+  [ErrorCode.SPEC_INVALID_FORMAT]: "\uC798\uBABB\uB41C \uC2A4\uD399 \uD615\uC2DD: {0}",
+  [ErrorCode.SPEC_MISSING_REQUIRED]: "\uD544\uC218 \uD544\uB4DC \uB204\uB77D: {0}",
+  [ErrorCode.RFC2119_VIOLATION]: "RFC 2119 \uD615\uC2DD \uC704\uBC18: {0}",
+  [ErrorCode.GWT_INVALID_FORMAT]: "GIVEN-WHEN-THEN \uD615\uC2DD \uC704\uBC18: {0}",
+  // Constitution 에러
+  [ErrorCode.CONSTITUTION_NOT_FOUND]: "constitution.md\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4",
+  [ErrorCode.CONSTITUTION_PARSE_ERROR]: "Constitution \uD30C\uC2F1 \uC2E4\uD328: {0}",
+  [ErrorCode.CONSTITUTION_VIOLATION]: "Constitution \uC6D0\uCE59 \uC704\uBC18: {0}",
+  // 변경 워크플로우 에러
+  [ErrorCode.PROPOSAL_NOT_FOUND]: "\uC81C\uC548\uC11C\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: {0}",
+  [ErrorCode.PROPOSAL_INVALID]: "\uC798\uBABB\uB41C \uC81C\uC548\uC11C \uD615\uC2DD: {0}",
+  [ErrorCode.DELTA_CONFLICT]: "\uB378\uD0C0 \uCDA9\uB3CC: {0}",
+  [ErrorCode.ARCHIVE_FAILED]: "\uC544\uCE74\uC774\uBE0C \uC2E4\uD328: {0}",
+  // 분석 에러
+  [ErrorCode.ANALYSIS_FAILED]: "\uBD84\uC11D \uC2E4\uD328: {0}",
+  [ErrorCode.INSUFFICIENT_DATA]: "\uBD84\uC11D\uC5D0 \uD544\uC694\uD55C \uB370\uC774\uD130 \uBD80\uC871: {0}"
+};
+function formatMessage(code, ...args) {
+  let message = ErrorMessages[code];
+  args.forEach((arg, index) => {
+    message = message.replace(`{${index}}`, arg);
+  });
+  return message;
+}
+
+// src/errors/base.ts
+var SddError = class extends Error {
+  code;
+  exitCode;
+  constructor(code, message, exitCode = ExitCode.GENERAL_ERROR) {
+    super(message ?? formatMessage(code));
+    this.name = "SddError";
+    this.code = code;
+    this.exitCode = exitCode;
+    Error.captureStackTrace?.(this, this.constructor);
+  }
+  /**
+   * 사용자 친화적 메시지
+   */
+  toUserMessage() {
+    return `[${this.code}] ${this.message}`;
+  }
+};
+var FileSystemError = class extends SddError {
+  path;
+  constructor(code, path) {
+    super(code, formatMessage(code, path), ExitCode.FILE_SYSTEM_ERROR);
+    this.name = "FileSystemError";
+    this.path = path;
+  }
+};
+var ValidationError = class extends SddError {
+  details;
+  constructor(code, details) {
+    super(code, formatMessage(code, details), ExitCode.VALIDATION_FAILED);
+    this.name = "ValidationError";
+    this.details = details;
+  }
+};
+var ConstitutionError = class extends SddError {
+  principle;
+  constructor(principle) {
+    super(
+      ErrorCode.CONSTITUTION_VIOLATION,
+      formatMessage(ErrorCode.CONSTITUTION_VIOLATION, principle),
+      ExitCode.CONSTITUTION_VIOLATION
+    );
+    this.name = "ConstitutionError";
+    this.principle = principle;
+  }
+};
+var UserCancelledError = class extends SddError {
+  constructor(message = "\uC0AC\uC6A9\uC790\uAC00 \uC791\uC5C5\uC744 \uCDE8\uC18C\uD588\uC2B5\uB2C8\uB2E4") {
+    super(ErrorCode.UNKNOWN, message, ExitCode.USER_CANCELLED);
+    this.name = "UserCancelledError";
+  }
+};
+var ChangeError = class extends SddError {
+  constructor(message) {
+    super(ErrorCode.UNKNOWN, message, ExitCode.GENERAL_ERROR);
+    this.name = "ChangeError";
+  }
+};
+export {
+  ChangeError,
+  ConstitutionError,
+  ErrorCode,
+  ErrorMessages,
+  ExitCode,
+  FileSystemError,
+  SddError,
+  UserCancelledError,
+  ValidationError,
+  failure,
+  formatMessage,
+  success
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types/index.ts","../src/errors/codes.ts","../src/errors/messages.ts","../src/errors/base.ts"],"sourcesContent":["/**\r\n * 공통 타입 정의\r\n */\r\n\r\n// ============================================================\r\n// 스펙 관련 타입\r\n// ============================================================\r\n\r\n/**\r\n * 스펙 문서 구조\r\n */\r\nexport interface Spec {\r\n  id: string;\r\n  title: string;\r\n  status: SpecStatus;\r\n  requirements: Requirement[];\r\n  scenarios: Scenario[];\r\n  dependencies: string[];\r\n  metadata: SpecMetadata;\r\n}\r\n\r\nexport type SpecStatus = 'draft' | 'approved' | 'implemented';\r\n\r\nexport interface SpecMetadata {\r\n  created?: string;\r\n  updated?: string;\r\n  author?: string;\r\n}\r\n\r\n/**\r\n * 요구사항 (RFC 2119)\r\n */\r\nexport interface Requirement {\r\n  id: string;\r\n  level: RequirementLevel;\r\n  description: string;\r\n}\r\n\r\nexport type RequirementLevel = 'SHALL' | 'MUST' | 'SHOULD' | 'MAY';\r\n\r\n/**\r\n * 시나리오 (GIVEN-WHEN-THEN)\r\n */\r\nexport interface Scenario {\r\n  name: string;\r\n  given: string[];\r\n  when: string;\r\n  then: string[];\r\n}\r\n\r\n// ============================================================\r\n// Constitution 관련 타입\r\n// ============================================================\r\n\r\n/**\r\n * Constitution 원칙\r\n */\r\nexport interface Principle {\r\n  id: string;\r\n  title: string;\r\n  description: string;\r\n  level: PrincipleLevel;\r\n}\r\n\r\nexport type PrincipleLevel = 'core' | 'technical' | 'forbidden';\r\n\r\nexport interface Constitution {\r\n  projectName: string;\r\n  principles: Principle[];\r\n  technicalStack?: string[];\r\n  constraints?: string[];\r\n}\r\n\r\n// ============================================================\r\n// 변경 워크플로우 관련 타입\r\n// ============================================================\r\n\r\n/**\r\n * 변경 제안\r\n */\r\nexport interface Proposal {\r\n  id: string;\r\n  title: string;\r\n  rationale: string;\r\n  affectedSpecs: string[];\r\n  deltas: Delta[];\r\n  status: ProposalStatus;\r\n  createdAt: string;\r\n}\r\n\r\nexport type ProposalStatus = 'draft' | 'review' | 'approved' | 'applied' | 'archived';\r\n\r\n/**\r\n * 델타 (변경사항)\r\n */\r\nexport interface Delta {\r\n  type: DeltaType;\r\n  target: string;\r\n  before?: string;\r\n  after?: string;\r\n}\r\n\r\nexport type DeltaType = 'ADDED' | 'MODIFIED' | 'REMOVED';\r\n\r\n// ============================================================\r\n// 검증 관련 타입\r\n// ============================================================\r\n\r\n/**\r\n * 검증 결과\r\n */\r\nexport interface ValidationResult {\r\n  valid: boolean;\r\n  errors: SpecValidationError[];\r\n  warnings: SpecValidationWarning[];\r\n}\r\n\r\nexport interface SpecValidationError {\r\n  code: string;\r\n  message: string;\r\n  location?: Location;\r\n}\r\n\r\nexport interface SpecValidationWarning {\r\n  code: string;\r\n  message: string;\r\n  location?: Location;\r\n}\r\n\r\nexport interface Location {\r\n  file?: string;\r\n  line?: number;\r\n  column?: number;\r\n}\r\n\r\n// ============================================================\r\n// 분석 관련 타입\r\n// ============================================================\r\n\r\n/**\r\n * 분석 결과\r\n */\r\nexport interface AnalysisResult {\r\n  scale: Scale;\r\n  recommendation: WorkflowRecommendation;\r\n  confidence: number;\r\n  rationale: string;\r\n  alternatives: string[];\r\n}\r\n\r\nexport type Scale = 'small' | 'medium' | 'large';\r\nexport type WorkflowRecommendation = 'direct' | 'change' | 'new';\r\n\r\n// ============================================================\r\n// 유틸리티 타입\r\n// ============================================================\r\n\r\n/**\r\n * Result 타입 (에러 처리용)\r\n */\r\nexport type Result<T, E = Error> =\r\n  | { success: true; data: T }\r\n  | { success: false; error: E };\r\n\r\n/**\r\n * 성공 결과 생성 헬퍼\r\n */\r\nexport function success<T>(data: T): Result<T, never> {\r\n  return { success: true, data };\r\n}\r\n\r\n/**\r\n * 실패 결과 생성 헬퍼\r\n */\r\nexport function failure<E>(error: E): Result<never, E> {\r\n  return { success: false, error };\r\n}\r\n","/**\r\n * 에러 코드 정의\r\n */\r\n\r\n/**\r\n * CLI 종료 코드\r\n */\r\nexport const ExitCode = {\r\n  SUCCESS: 0,\r\n  GENERAL_ERROR: 1,\r\n  VALIDATION_FAILED: 2,\r\n  CONSTITUTION_VIOLATION: 3,\r\n  FILE_SYSTEM_ERROR: 4,\r\n  USER_CANCELLED: 5,\r\n} as const;\r\n\r\nexport type ExitCode = (typeof ExitCode)[keyof typeof ExitCode];\r\n\r\n/**\r\n * 에러 코드\r\n */\r\nexport const ErrorCode = {\r\n  // 일반 에러 (E0xx)\r\n  UNKNOWN: 'E001',\r\n  INVALID_ARGUMENT: 'E002',\r\n  NOT_INITIALIZED: 'E003',\r\n\r\n  // 파일 시스템 에러 (E1xx)\r\n  FILE_NOT_FOUND: 'E101',\r\n  FILE_READ_ERROR: 'E102',\r\n  FILE_WRITE_ERROR: 'E103',\r\n  DIRECTORY_NOT_FOUND: 'E104',\r\n  DIRECTORY_EXISTS: 'E105',\r\n\r\n  // 스펙 검증 에러 (E2xx)\r\n  SPEC_PARSE_ERROR: 'E201',\r\n  SPEC_INVALID_FORMAT: 'E202',\r\n  SPEC_MISSING_REQUIRED: 'E203',\r\n  RFC2119_VIOLATION: 'E204',\r\n  GWT_INVALID_FORMAT: 'E205',\r\n\r\n  // Constitution 에러 (E3xx)\r\n  CONSTITUTION_NOT_FOUND: 'E301',\r\n  CONSTITUTION_PARSE_ERROR: 'E302',\r\n  CONSTITUTION_VIOLATION: 'E303',\r\n\r\n  // 변경 워크플로우 에러 (E4xx)\r\n  PROPOSAL_NOT_FOUND: 'E401',\r\n  PROPOSAL_INVALID: 'E402',\r\n  DELTA_CONFLICT: 'E403',\r\n  ARCHIVE_FAILED: 'E404',\r\n\r\n  // 분석 에러 (E5xx)\r\n  ANALYSIS_FAILED: 'E501',\r\n  INSUFFICIENT_DATA: 'E502',\r\n} as const;\r\n\r\nexport type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];\r\n","/**\r\n * 에러 메시지 정의\r\n */\r\nimport { ErrorCode } from './codes.js';\r\n\r\n/**\r\n * 에러 코드별 메시지 템플릿\r\n */\r\nexport const ErrorMessages: Record<ErrorCode, string> = {\r\n  // 일반 에러\r\n  [ErrorCode.UNKNOWN]: '알 수 없는 오류가 발생했습니다',\r\n  [ErrorCode.INVALID_ARGUMENT]: '잘못된 인자입니다: {0}',\r\n  [ErrorCode.NOT_INITIALIZED]: 'SDD 프로젝트가 초기화되지 않았습니다. `sdd init`을 먼저 실행하세요',\r\n\r\n  // 파일 시스템 에러\r\n  [ErrorCode.FILE_NOT_FOUND]: '파일을 찾을 수 없습니다: {0}',\r\n  [ErrorCode.FILE_READ_ERROR]: '파일 읽기 실패: {0}',\r\n  [ErrorCode.FILE_WRITE_ERROR]: '파일 쓰기 실패: {0}',\r\n  [ErrorCode.DIRECTORY_NOT_FOUND]: '디렉토리를 찾을 수 없습니다: {0}',\r\n  [ErrorCode.DIRECTORY_EXISTS]: '디렉토리가 이미 존재합니다: {0}',\r\n\r\n  // 스펙 검증 에러\r\n  [ErrorCode.SPEC_PARSE_ERROR]: '스펙 파싱 실패: {0}',\r\n  [ErrorCode.SPEC_INVALID_FORMAT]: '잘못된 스펙 형식: {0}',\r\n  [ErrorCode.SPEC_MISSING_REQUIRED]: '필수 필드 누락: {0}',\r\n  [ErrorCode.RFC2119_VIOLATION]: 'RFC 2119 형식 위반: {0}',\r\n  [ErrorCode.GWT_INVALID_FORMAT]: 'GIVEN-WHEN-THEN 형식 위반: {0}',\r\n\r\n  // Constitution 에러\r\n  [ErrorCode.CONSTITUTION_NOT_FOUND]: 'constitution.md를 찾을 수 없습니다',\r\n  [ErrorCode.CONSTITUTION_PARSE_ERROR]: 'Constitution 파싱 실패: {0}',\r\n  [ErrorCode.CONSTITUTION_VIOLATION]: 'Constitution 원칙 위반: {0}',\r\n\r\n  // 변경 워크플로우 에러\r\n  [ErrorCode.PROPOSAL_NOT_FOUND]: '제안서를 찾을 수 없습니다: {0}',\r\n  [ErrorCode.PROPOSAL_INVALID]: '잘못된 제안서 형식: {0}',\r\n  [ErrorCode.DELTA_CONFLICT]: '델타 충돌: {0}',\r\n  [ErrorCode.ARCHIVE_FAILED]: '아카이브 실패: {0}',\r\n\r\n  // 분석 에러\r\n  [ErrorCode.ANALYSIS_FAILED]: '분석 실패: {0}',\r\n  [ErrorCode.INSUFFICIENT_DATA]: '분석에 필요한 데이터 부족: {0}',\r\n};\r\n\r\n/**\r\n * 메시지 템플릿에 인자를 적용\r\n */\r\nexport function formatMessage(code: ErrorCode, ...args: string[]): string {\r\n  let message = ErrorMessages[code];\r\n  args.forEach((arg, index) => {\r\n    message = message.replace(`{${index}}`, arg);\r\n  });\r\n  return message;\r\n}\r\n","/**\r\n * 에러 기본 클래스\r\n */\r\nimport { ErrorCode, ExitCode } from './codes.js';\r\nimport { formatMessage } from './messages.js';\r\n\r\n/**\r\n * SDD 도구의 기본 에러 클래스\r\n */\r\nexport class SddError extends Error {\r\n  readonly code: ErrorCode;\r\n  readonly exitCode: ExitCode;\r\n\r\n  constructor(\r\n    code: ErrorCode,\r\n    message?: string,\r\n    exitCode: ExitCode = ExitCode.GENERAL_ERROR\r\n  ) {\r\n    super(message ?? formatMessage(code));\r\n    this.name = 'SddError';\r\n    this.code = code;\r\n    this.exitCode = exitCode;\r\n    Error.captureStackTrace?.(this, this.constructor);\r\n  }\r\n\r\n  /**\r\n   * 사용자 친화적 메시지\r\n   */\r\n  toUserMessage(): string {\r\n    return `[${this.code}] ${this.message}`;\r\n  }\r\n}\r\n\r\n/**\r\n * 파일 시스템 에러\r\n */\r\nexport class FileSystemError extends SddError {\r\n  readonly path: string;\r\n\r\n  constructor(code: ErrorCode, path: string) {\r\n    super(code, formatMessage(code, path), ExitCode.FILE_SYSTEM_ERROR);\r\n    this.name = 'FileSystemError';\r\n    this.path = path;\r\n  }\r\n}\r\n\r\n/**\r\n * 스펙 검증 에러\r\n */\r\nexport class ValidationError extends SddError {\r\n  readonly details: string;\r\n\r\n  constructor(code: ErrorCode, details: string) {\r\n    super(code, formatMessage(code, details), ExitCode.VALIDATION_FAILED);\r\n    this.name = 'ValidationError';\r\n    this.details = details;\r\n  }\r\n}\r\n\r\n/**\r\n * Constitution 위반 에러\r\n */\r\nexport class ConstitutionError extends SddError {\r\n  readonly principle: string;\r\n\r\n  constructor(principle: string) {\r\n    super(\r\n      ErrorCode.CONSTITUTION_VIOLATION,\r\n      formatMessage(ErrorCode.CONSTITUTION_VIOLATION, principle),\r\n      ExitCode.CONSTITUTION_VIOLATION\r\n    );\r\n    this.name = 'ConstitutionError';\r\n    this.principle = principle;\r\n  }\r\n}\r\n\r\n/**\r\n * 사용자 취소 에러\r\n */\r\nexport class UserCancelledError extends SddError {\r\n  constructor(message = '사용자가 작업을 취소했습니다') {\r\n    super(ErrorCode.UNKNOWN, message, ExitCode.USER_CANCELLED);\r\n    this.name = 'UserCancelledError';\r\n  }\r\n}\r\n\r\n/**\r\n * 변경 워크플로우 에러\r\n */\r\nexport class ChangeError extends SddError {\r\n  constructor(message: string) {\r\n    super(ErrorCode.UNKNOWN, message, ExitCode.GENERAL_ERROR);\r\n    this.name = 'ChangeError';\r\n  }\r\n}\r\n"],"mappings":";AAuKO,SAAS,QAAW,MAA2B;AACpD,SAAO,EAAE,SAAS,MAAM,KAAK;AAC/B;AAKO,SAAS,QAAW,OAA4B;AACrD,SAAO,EAAE,SAAS,OAAO,MAAM;AACjC;;;ACzKO,IAAM,WAAW;AAAA,EACtB,SAAS;AAAA,EACT,eAAe;AAAA,EACf,mBAAmB;AAAA,EACnB,wBAAwB;AAAA,EACxB,mBAAmB;AAAA,EACnB,gBAAgB;AAClB;AAOO,IAAM,YAAY;AAAA;AAAA,EAEvB,SAAS;AAAA,EACT,kBAAkB;AAAA,EAClB,iBAAiB;AAAA;AAAA,EAGjB,gBAAgB;AAAA,EAChB,iBAAiB;AAAA,EACjB,kBAAkB;AAAA,EAClB,qBAAqB;AAAA,EACrB,kBAAkB;AAAA;AAAA,EAGlB,kBAAkB;AAAA,EAClB,qBAAqB;AAAA,EACrB,uBAAuB;AAAA,EACvB,mBAAmB;AAAA,EACnB,oBAAoB;AAAA;AAAA,EAGpB,wBAAwB;AAAA,EACxB,0BAA0B;AAAA,EAC1B,wBAAwB;AAAA;AAAA,EAGxB,oBAAoB;AAAA,EACpB,kBAAkB;AAAA,EAClB,gBAAgB;AAAA,EAChB,gBAAgB;AAAA;AAAA,EAGhB,iBAAiB;AAAA,EACjB,mBAAmB;AACrB;;;AC/CO,IAAM,gBAA2C;AAAA;AAAA,EAEtD,CAAC,UAAU,OAAO,GAAG;AAAA,EACrB,CAAC,UAAU,gBAAgB,GAAG;AAAA,EAC9B,CAAC,UAAU,eAAe,GAAG;AAAA;AAAA,EAG7B,CAAC,UAAU,cAAc,GAAG;AAAA,EAC5B,CAAC,UAAU,eAAe,GAAG;AAAA,EAC7B,CAAC,UAAU,gBAAgB,GAAG;AAAA,EAC9B,CAAC,UAAU,mBAAmB,GAAG;AAAA,EACjC,CAAC,UAAU,gBAAgB,GAAG;AAAA;AAAA,EAG9B,CAAC,UAAU,gBAAgB,GAAG;AAAA,EAC9B,CAAC,UAAU,mBAAmB,GAAG;AAAA,EACjC,CAAC,UAAU,qBAAqB,GAAG;AAAA,EACnC,CAAC,UAAU,iBAAiB,GAAG;AAAA,EAC/B,CAAC,UAAU,kBAAkB,GAAG;AAAA;AAAA,EAGhC,CAAC,UAAU,sBAAsB,GAAG;AAAA,EACpC,CAAC,UAAU,wBAAwB,GAAG;AAAA,EACtC,CAAC,UAAU,sBAAsB,GAAG;AAAA;AAAA,EAGpC,CAAC,UAAU,kBAAkB,GAAG;AAAA,EAChC,CAAC,UAAU,gBAAgB,GAAG;AAAA,EAC9B,CAAC,UAAU,cAAc,GAAG;AAAA,EAC5B,CAAC,UAAU,cAAc,GAAG;AAAA;AAAA,EAG5B,CAAC,UAAU,eAAe,GAAG;AAAA,EAC7B,CAAC,UAAU,iBAAiB,GAAG;AACjC;AAKO,SAAS,cAAc,SAAoB,MAAwB;AACxE,MAAI,UAAU,cAAc,IAAI;AAChC,OAAK,QAAQ,CAAC,KAAK,UAAU;AAC3B,cAAU,QAAQ,QAAQ,IAAI,KAAK,KAAK,GAAG;AAAA,EAC7C,CAAC;AACD,SAAO;AACT;;;AC5CO,IAAM,WAAN,cAAuB,MAAM;AAAA,EACzB;AAAA,EACA;AAAA,EAET,YACE,MACA,SACA,WAAqB,SAAS,eAC9B;AACA,UAAM,WAAW,cAAc,IAAI,CAAC;AACpC,SAAK,OAAO;AACZ,SAAK,OAAO;AACZ,SAAK,WAAW;AAChB,UAAM,oBAAoB,MAAM,KAAK,WAAW;AAAA,EAClD;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAwB;AACtB,WAAO,IAAI,KAAK,IAAI,KAAK,KAAK,OAAO;AAAA,EACvC;AACF;AAKO,IAAM,kBAAN,cAA8B,SAAS;AAAA,EACnC;AAAA,EAET,YAAY,MAAiB,MAAc;AACzC,UAAM,MAAM,cAAc,MAAM,IAAI,GAAG,SAAS,iBAAiB;AACjE,SAAK,OAAO;AACZ,SAAK,OAAO;AAAA,EACd;AACF;AAKO,IAAM,kBAAN,cAA8B,SAAS;AAAA,EACnC;AAAA,EAET,YAAY,MAAiB,SAAiB;AAC5C,UAAM,MAAM,cAAc,MAAM,OAAO,GAAG,SAAS,iBAAiB;AACpE,SAAK,OAAO;AACZ,SAAK,UAAU;AAAA,EACjB;AACF;AAKO,IAAM,oBAAN,cAAgC,SAAS;AAAA,EACrC;AAAA,EAET,YAAY,WAAmB;AAC7B;AAAA,MACE,UAAU;AAAA,MACV,cAAc,UAAU,wBAAwB,SAAS;AAAA,MACzD,SAAS;AAAA,IACX;AACA,SAAK,OAAO;AACZ,SAAK,YAAY;AAAA,EACnB;AACF;AAKO,IAAM,qBAAN,cAAiC,SAAS;AAAA,EAC/C,YAAY,UAAU,oFAAmB;AACvC,UAAM,UAAU,SAAS,SAAS,SAAS,cAAc;AACzD,SAAK,OAAO;AAAA,EACd;AACF;AAKO,IAAM,cAAN,cAA0B,SAAS;AAAA,EACxC,YAAY,SAAiB;AAC3B,UAAM,UAAU,SAAS,SAAS,SAAS,aAAa;AACxD,SAAK,OAAO;AAAA,EACd;AACF;","names":[]}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "sdd-tool",
+  "version": "0.1.0",
+  "description": "Unified Spec-Driven Development CLI - AI-first specification workflow",
+  "type": "module",
+  "bin": {
+    "sdd": "bin/sdd.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build && npm run test:run"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JakeB-5/sdd-tool.git"
+  },
+  "homepage": "https://github.com/JakeB-5/sdd-tool#readme",
+  "bugs": {
+    "url": "https://github.com/JakeB-5/sdd-tool/issues"
+  },
+  "author": "JakeB-5",
+  "dependencies": {
+    "commander": "^12.1.0",
+    "zod": "^3.23.8",
+    "chalk": "^5.3.0",
+    "gray-matter": "^4.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.10",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8",
+    "tsup": "^8.3.5",
+    "@vitest/coverage-v8": "^2.1.8",
+    "eslint": "^9.16.0",
+    "@typescript-eslint/eslint-plugin": "^8.18.0",
+    "@typescript-eslint/parser": "^8.18.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "packageManager": "pnpm@9.15.1",
+  "files": [
+    "dist",
+    "bin",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "sdd",
+    "spec-driven-development",
+    "specification",
+    "cli",
+    "ai",
+    "workflow",
+    "rfc2119",
+    "given-when-then",
+    "bdd"
+  ],
+  "license": "MIT"
+}

package/templates/agents.md

@@ -0,0 +1,62 @@
+# AGENTS.md
+
+> AI 에이전트 워크플로우 지침서
+
+---
+
+## 프로젝트 개요
+
+**프로젝트**: {{PROJECT_NAME}}
+**설명**: {{PROJECT_DESCRIPTION}}
+
+---
+
+## 디렉토리 구조
+
+```
+.sdd/
+├── constitution.md    # 프로젝트 헌법
+├── specs/             # 스펙 문서
+│   └── <feature>/
+│       └── spec.md
+├── changes/           # 변경 제안
+│   └── <id>/
+│       ├── proposal.md
+│       └── delta.md
+└── templates/         # 템플릿
+```
+
+---
+
+## 워크플로우
+
+### 신규 기능
+
+1. `/sdd:new` - 스펙 초안 작성
+2. `/sdd:plan` - 구현 계획 수립
+3. `/sdd:tasks` - 작업 분해
+4. 구현 및 테스트
+5. 리뷰 및 머지
+
+### 변경 제안
+
+1. `/sdd:change` - 제안서 작성
+2. `/sdd:impact` - 영향도 분석
+3. 리뷰 및 승인
+4. `/sdd:apply` - 변경 적용
+5. `/sdd:archive` - 아카이브
+
+---
+
+## 컨벤션
+
+- 모든 스펙은 RFC 2119 키워드 사용
+- 모든 요구사항은 GIVEN-WHEN-THEN 시나리오 포함
+- 변경 시 반드시 영향도 분석 수행
+
+---
+
+## 참조
+
+- [Constitution](./constitution.md)
+- [Specs](./specs/)

package/templates/constitution.md

@@ -0,0 +1,43 @@
+# Constitution: {{PROJECT_NAME}}
+
+> 프로젝트의 근본 원칙과 제약 조건
+
+---
+
+## 핵심 원칙
+
+### 1. 명세 우선 (Spec First)
+
+코드보다 명세가 먼저다. 모든 구현은 승인된 명세에 기반한다.
+
+### 2. 명확성 (Clarity)
+
+모호함을 피하고 RFC 2119 키워드를 사용하여 요구사항을 명확히 한다.
+
+### 3. 검증 가능성 (Verifiability)
+
+모든 요구사항은 GIVEN-WHEN-THEN 시나리오로 검증 가능해야 한다.
+
+---
+
+## 기술 스택
+
+- 언어: {{LANGUAGE}}
+- 런타임: {{RUNTIME}}
+- 테스트: {{TEST_FRAMEWORK}}
+
+---
+
+## 금지 사항
+
+- 승인되지 않은 의존성 추가 금지
+- 명세 없는 기능 구현 금지
+- 테스트 없는 코드 머지 금지
+
+---
+
+## 변경 기록
+
+| 날짜 | 변경 내용 | 작성자 |
+|------|----------|--------|
+| {{DATE}} | 초기 작성 | - |

package/templates/proposal.md

@@ -0,0 +1,71 @@
+---
+id: CHG-{{ID}}
+status: draft
+created: {{DATE}}
+---
+
+# 변경 제안: {{TITLE}}
+
+> 변경 목적 및 배경 설명
+
+---
+
+## 배경
+
+왜 이 변경이 필요한가?
+
+---
+
+## 영향 범위
+
+### 영향받는 스펙
+
+- `specs/{{SPEC_PATH}}`
+
+### 변경 유형
+
+- [ ] 신규 추가 (ADDED)
+- [ ] 수정 (MODIFIED)
+- [ ] 삭제 (REMOVED)
+
+---
+
+## 변경 내용
+
+### ADDED
+
+(새로 추가되는 내용)
+
+### MODIFIED
+
+(수정되는 내용)
+
+#### Before
+
+```markdown
+기존 내용
+```
+
+#### After
+
+```markdown
+변경된 내용
+```
+
+### REMOVED
+
+(삭제되는 내용)
+
+---
+
+## 리스크 평가
+
+- 영향도: 낮음/중간/높음
+- 복잡도: 낮음/중간/높음
+
+---
+
+## 검토자
+
+- [ ] @reviewer1
+- [ ] @reviewer2