@contractspec/bundle.workspace 1.46.1 → 1.47.0

package/dist/services/verify/verify-service.d.mts

@@ -0,0 +1,60 @@
+import { VerifyConfig, VerifyOptions, VerifyResult } from "./types.mjs";
+import { AnyOperationSpec } from "@contractspec/lib.contracts";
+import { VerificationReport } from "@contractspec/lib.contracts/llm";
+
+//#region src/services/verify/verify-service.d.ts
+
+/**
+ * Verification Service
+ *
+ * Main service for verifying implementations against specs.
+ */
+declare class VerifyService {
+  private config;
+  constructor(config?: Partial<VerifyConfig>);
+  /**
+   * Run verification on an implementation.
+   */
+  verify(spec: AnyOperationSpec, implementationCode: string, options?: VerifyOptions): Promise<VerifyResult>;
+  /**
+   * Run only structure verification (Tier 1).
+   */
+  verifyStructure(spec: AnyOperationSpec, implementationCode: string, implementationPath?: string): VerificationReport;
+  /**
+   * Run only behavior verification (Tier 2).
+   */
+  verifyBehavior(spec: AnyOperationSpec, implementationCode: string, implementationPath?: string): VerificationReport;
+  /**
+   * Run only AI verification (Tier 3).
+   */
+  verifyAI(spec: AnyOperationSpec, implementationCode: string, implementationPath?: string): Promise<VerificationReport>;
+  /**
+   * Quick verification (structure only, fast).
+   */
+  quickVerify(spec: AnyOperationSpec, implementationCode: string): VerificationReport;
+  /**
+   * Format verification result as markdown.
+   */
+  formatAsMarkdown(result: VerifyResult): string;
+  /**
+   * Update configuration.
+   */
+  configure(config: Partial<VerifyConfig>): void;
+  /**
+   * Generate a human-readable summary of verification results.
+   */
+  private generateSummary;
+  /**
+   * Format tier name for display.
+   */
+  private formatTierName;
+}
+/**
+ * Create a new VerifyService instance.
+ */
+declare function createVerifyService(config?: Partial<VerifyConfig>): VerifyService;
+/** Default singleton instance */
+declare const verifyService: VerifyService;
+//#endregion
+export { VerifyService, createVerifyService, verifyService };
+//# sourceMappingURL=verify-service.d.mts.map

package/dist/services/verify/verify-service.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-service.d.mts","names":[],"sources":["../../../src/services/verify/verify-service.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;AAwIU,cAtGG,aAAA,CAsGH;EAGL,QAAA,MAAA;EAYK,WAAA,CAAA,MAAA,CAAA,EAlHY,OAkHZ,CAlHoB,YAkHpB,CAAA;EAGG;;;EAmBR,MAAA,CAAA,IAAA,EAhIK,gBAgIL,EAAA,kBAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EA9HQ,aA8HR,CAAA,EA7HA,OA6HA,CA7HQ,YA6HR,CAAA;EAOsB;;;EAyEA,eAAA,CAAA,IAAA,EApIjB,gBAoIiB,EAAA,kBAAA,EAAA,MAAA,EAAA,kBAAA,CAAA,EAAA,MAAA,CAAA,EAjItB,kBAiIsB;EAuEX;;;EAEb,cAAA,CAAA,IAAA,EA9LO,gBA8LP,EAAA,kBAAA,EAAA,MAAA,EAAA,kBAAA,CAAA,EAAA,MAAA,CAAA,EA3LE,kBA2LF;EAAa;AAKhB;;iBApLU,4EAGL,QAAQ;;;;oBAiBH,+CAEL;;;;2BAOsB;;;;oBAyEP,QAAQ;;;;;;;;;;;;;iBAuEZ,mBAAA,UACL,QAAQ,gBAChB;;cAKU,eAAa"}

package/dist/services/verify/verify-service.mjs

@@ -0,0 +1,204 @@
+import { verifyStructure } from "./structure-verifier.mjs";
+import { verifyBehavior } from "./behavior-verifier.mjs";
+import { createQuickAIReview, verifyWithAI } from "./ai-verifier.mjs";
+
+//#region src/services/verify/verify-service.ts
+const DEFAULT_CONFIG = { verbose: false };
+const TIER_ORDER = [
+	"structure",
+	"behavior",
+	"ai_review"
+];
+/**
+* Verification Service
+*
+* Main service for verifying implementations against specs.
+*/
+var VerifyService = class {
+	config;
+	constructor(config = {}) {
+		this.config = {
+			...DEFAULT_CONFIG,
+			...config
+		};
+	}
+	/**
+	* Run verification on an implementation.
+	*/
+	async verify(spec, implementationCode, options = {}) {
+		const startTime = Date.now();
+		const reports = /* @__PURE__ */ new Map();
+		const allIssues = [];
+		const input = {
+			spec,
+			implementationCode
+		};
+		const tiersToRun = options.tiers ?? ["structure", "behavior"];
+		for (const tier of TIER_ORDER) {
+			if (!tiersToRun.includes(tier)) continue;
+			let report;
+			switch (tier) {
+				case "structure":
+					report = verifyStructure(input);
+					break;
+				case "behavior":
+					report = verifyBehavior(input);
+					break;
+				case "ai_review":
+					if (this.config.aiApiKey) report = await verifyWithAI(input, this.config);
+					else report = createQuickAIReview(input);
+					break;
+				default: continue;
+			}
+			reports.set(tier, report);
+			allIssues.push(...report.issues);
+			if (options.failFast && !report.passed) break;
+		}
+		const reportsArray = Array.from(reports.values());
+		return {
+			passed: reportsArray.every((r) => r.passed),
+			score: reportsArray.length > 0 ? Math.round(reportsArray.reduce((sum, r) => sum + r.score, 0) / reportsArray.length) : 100,
+			reports,
+			allIssues,
+			summary: this.generateSummary(reportsArray, allIssues),
+			duration: Date.now() - startTime
+		};
+	}
+	/**
+	* Run only structure verification (Tier 1).
+	*/
+	verifyStructure(spec, implementationCode, implementationPath) {
+		return verifyStructure({
+			spec,
+			implementationCode,
+			implementationPath
+		});
+	}
+	/**
+	* Run only behavior verification (Tier 2).
+	*/
+	verifyBehavior(spec, implementationCode, implementationPath) {
+		return verifyBehavior({
+			spec,
+			implementationCode,
+			implementationPath
+		});
+	}
+	/**
+	* Run only AI verification (Tier 3).
+	*/
+	async verifyAI(spec, implementationCode, implementationPath) {
+		const input = {
+			spec,
+			implementationCode,
+			implementationPath
+		};
+		if (this.config.aiApiKey) return verifyWithAI(input, this.config);
+		return createQuickAIReview(input);
+	}
+	/**
+	* Quick verification (structure only, fast).
+	*/
+	quickVerify(spec, implementationCode) {
+		return verifyStructure({
+			spec,
+			implementationCode
+		});
+	}
+	/**
+	* Format verification result as markdown.
+	*/
+	formatAsMarkdown(result) {
+		const lines = [];
+		lines.push(`# Verification Report`);
+		lines.push("");
+		lines.push(`**Status:** ${result.passed ? "✓ Passed" : "✗ Failed"}`);
+		lines.push(`**Score:** ${result.score}/100`);
+		lines.push(`**Duration:** ${result.duration}ms`);
+		lines.push("");
+		for (const [tier, report] of result.reports) {
+			lines.push(`## ${this.formatTierName(tier)}`);
+			lines.push("");
+			lines.push(`**Status:** ${report.passed ? "✓ Passed" : "✗ Failed"}`);
+			lines.push(`**Score:** ${report.score}/100`);
+			lines.push("");
+			if (report.issues.length > 0) {
+				lines.push("### Issues");
+				lines.push("");
+				for (const issue of report.issues) {
+					const icon = issue.severity === "error" ? "❌" : issue.severity === "warning" ? "⚠️" : "ℹ️";
+					lines.push(`${icon} **${issue.category}**: ${issue.message}`);
+					if (issue.suggestion) lines.push(`  - Suggestion: ${issue.suggestion}`);
+				}
+				lines.push("");
+			}
+			if (report.coverage.scenarios.total > 0) lines.push(`**Scenarios:** ${report.coverage.scenarios.covered}/${report.coverage.scenarios.total}`);
+			if (report.coverage.errors.total > 0) lines.push(`**Errors handled:** ${report.coverage.errors.handled}/${report.coverage.errors.total}`);
+			lines.push("");
+		}
+		const allSuggestions = Array.from(result.reports.values()).flatMap((r) => r.suggestions);
+		if (allSuggestions.length > 0) {
+			lines.push("## Suggestions");
+			lines.push("");
+			for (const suggestion of allSuggestions.slice(0, 10)) lines.push(`- ${suggestion}`);
+			if (allSuggestions.length > 10) lines.push(`- ... and ${allSuggestions.length - 10} more`);
+			lines.push("");
+		}
+		return lines.join("\n");
+	}
+	/**
+	* Update configuration.
+	*/
+	configure(config) {
+		this.config = {
+			...this.config,
+			...config
+		};
+	}
+	/**
+	* Generate a human-readable summary of verification results.
+	*/
+	generateSummary(reports, allIssues) {
+		const parts = [];
+		const passed = reports.every((r) => r.passed);
+		const avgScore = reports.length > 0 ? Math.round(reports.reduce((sum, r) => sum + r.score, 0) / reports.length) : 100;
+		parts.push(passed ? "✓ Verification passed" : "✗ Verification failed");
+		parts.push(`Score: ${avgScore}/100`);
+		parts.push("");
+		for (const report of reports) {
+			const icon = report.passed ? "✓" : "✗";
+			parts.push(`${icon} ${report.tier}: ${report.score}/100`);
+		}
+		parts.push("");
+		const errors = allIssues.filter((i) => i.severity === "error");
+		const warnings = allIssues.filter((i) => i.severity === "warning");
+		const infos = allIssues.filter((i) => i.severity === "info");
+		if (errors.length > 0) parts.push(`Errors: ${errors.length}`);
+		if (warnings.length > 0) parts.push(`Warnings: ${warnings.length}`);
+		if (infos.length > 0) parts.push(`Info: ${infos.length}`);
+		return parts.join("\n");
+	}
+	/**
+	* Format tier name for display.
+	*/
+	formatTierName(tier) {
+		switch (tier) {
+			case "structure": return "Tier 1: Structure";
+			case "behavior": return "Tier 2: Behavior";
+			case "ai_review": return "Tier 3: AI Review";
+			default: return tier;
+		}
+	}
+};
+/**
+* Create a new VerifyService instance.
+*/
+function createVerifyService(config) {
+	return new VerifyService(config);
+}
+/** Default singleton instance */
+const verifyService = new VerifyService();
+
+//#endregion
+export { VerifyService, createVerifyService, verifyService };
+//# sourceMappingURL=verify-service.mjs.map

package/dist/services/verify/verify-service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-service.mjs","names":[],"sources":["../../../src/services/verify/verify-service.ts"],"sourcesContent":["/**\n * Verification Service\n *\n * Orchestrates tiered verification of implementations against specs.\n * Supports three tiers: structure, behavior, and AI review.\n */\n\nimport type { AnyOperationSpec } from '@contractspec/lib.contracts';\nimport type {\n  VerificationIssue,\n  VerificationReport,\n  VerificationTier,\n} from '@contractspec/lib.contracts/llm';\nimport { verifyStructure } from './structure-verifier';\nimport { verifyBehavior } from './behavior-verifier';\nimport { createQuickAIReview, verifyWithAI } from './ai-verifier';\nimport type {\n  VerifyConfig,\n  VerifyInput,\n  VerifyOptions,\n  VerifyResult,\n} from './types';\n\nconst DEFAULT_CONFIG: VerifyConfig = {\n  verbose: false,\n};\n\nconst TIER_ORDER: VerificationTier[] = ['structure', 'behavior', 'ai_review'];\n\n/**\n * Verification Service\n *\n * Main service for verifying implementations against specs.\n */\nexport class VerifyService {\n  private config: VerifyConfig;\n\n  constructor(config: Partial<VerifyConfig> = {}) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n  }\n\n  /**\n   * Run verification on an implementation.\n   */\n  async verify(\n    spec: AnyOperationSpec,\n    implementationCode: string,\n    options: VerifyOptions = {}\n  ): Promise<VerifyResult> {\n    const startTime = Date.now();\n    const reports = new Map<VerificationTier, VerificationReport>();\n    const allIssues: VerificationIssue[] = [];\n\n    const input: VerifyInput = {\n      spec,\n      implementationCode,\n    };\n\n    // Determine which tiers to run\n    const tiersToRun = options.tiers ?? ['structure', 'behavior'];\n\n    for (const tier of TIER_ORDER) {\n      if (!tiersToRun.includes(tier)) continue;\n\n      let report: VerificationReport;\n\n      switch (tier) {\n        case 'structure':\n          report = verifyStructure(input);\n          break;\n        case 'behavior':\n          report = verifyBehavior(input);\n          break;\n        case 'ai_review':\n          if (this.config.aiApiKey) {\n            report = await verifyWithAI(input, this.config);\n          } else {\n            report = createQuickAIReview(input);\n          }\n          break;\n        default:\n          continue;\n      }\n\n      reports.set(tier, report);\n      allIssues.push(...report.issues);\n\n      // Stop on first failure if failFast is enabled\n      if (options.failFast && !report.passed) {\n        break;\n      }\n    }\n\n    // Calculate combined results\n    const reportsArray = Array.from(reports.values());\n    const passed = reportsArray.every((r) => r.passed);\n    const score =\n      reportsArray.length > 0\n        ? Math.round(\n            reportsArray.reduce((sum, r) => sum + r.score, 0) /\n              reportsArray.length\n          )\n        : 100;\n\n    // Generate summary\n    const summary = this.generateSummary(reportsArray, allIssues);\n\n    return {\n      passed,\n      score,\n      reports,\n      allIssues,\n      summary,\n      duration: Date.now() - startTime,\n    };\n  }\n\n  /**\n   * Run only structure verification (Tier 1).\n   */\n  verifyStructure(\n    spec: AnyOperationSpec,\n    implementationCode: string,\n    implementationPath?: string\n  ): VerificationReport {\n    return verifyStructure({\n      spec,\n      implementationCode,\n      implementationPath,\n    });\n  }\n\n  /**\n   * Run only behavior verification (Tier 2).\n   */\n  verifyBehavior(\n    spec: AnyOperationSpec,\n    implementationCode: string,\n    implementationPath?: string\n  ): VerificationReport {\n    return verifyBehavior({\n      spec,\n      implementationCode,\n      implementationPath,\n    });\n  }\n\n  /**\n   * Run only AI verification (Tier 3).\n   */\n  async verifyAI(\n    spec: AnyOperationSpec,\n    implementationCode: string,\n    implementationPath?: string\n  ): Promise<VerificationReport> {\n    const input: VerifyInput = {\n      spec,\n      implementationCode,\n      implementationPath,\n    };\n\n    if (this.config.aiApiKey) {\n      return verifyWithAI(input, this.config);\n    }\n    return createQuickAIReview(input);\n  }\n\n  /**\n   * Quick verification (structure only, fast).\n   */\n  quickVerify(\n    spec: AnyOperationSpec,\n    implementationCode: string\n  ): VerificationReport {\n    return verifyStructure({ spec, implementationCode });\n  }\n\n  /**\n   * Format verification result as markdown.\n   */\n  formatAsMarkdown(result: VerifyResult): string {\n    const lines: string[] = [];\n\n    // Header\n    lines.push(`# Verification Report`);\n    lines.push('');\n    lines.push(`**Status:** ${result.passed ? '✓ Passed' : '✗ Failed'}`);\n    lines.push(`**Score:** ${result.score}/100`);\n    lines.push(`**Duration:** ${result.duration}ms`);\n    lines.push('');\n\n    // Per-tier details\n    for (const [tier, report] of result.reports) {\n      lines.push(`## ${this.formatTierName(tier)}`);\n      lines.push('');\n      lines.push(`**Status:** ${report.passed ? '✓ Passed' : '✗ Failed'}`);\n      lines.push(`**Score:** ${report.score}/100`);\n      lines.push('');\n\n      if (report.issues.length > 0) {\n        lines.push('### Issues');\n        lines.push('');\n        for (const issue of report.issues) {\n          const icon =\n            issue.severity === 'error'\n              ? '❌'\n              : issue.severity === 'warning'\n                ? '⚠️'\n                : 'ℹ️';\n          lines.push(`${icon} **${issue.category}**: ${issue.message}`);\n          if (issue.suggestion) {\n            lines.push(`  - Suggestion: ${issue.suggestion}`);\n          }\n        }\n        lines.push('');\n      }\n\n      if (report.coverage.scenarios.total > 0) {\n        lines.push(\n          `**Scenarios:** ${report.coverage.scenarios.covered}/${report.coverage.scenarios.total}`\n        );\n      }\n      if (report.coverage.errors.total > 0) {\n        lines.push(\n          `**Errors handled:** ${report.coverage.errors.handled}/${report.coverage.errors.total}`\n        );\n      }\n      lines.push('');\n    }\n\n    // Suggestions\n    const allSuggestions = Array.from(result.reports.values()).flatMap(\n      (r) => r.suggestions\n    );\n\n    if (allSuggestions.length > 0) {\n      lines.push('## Suggestions');\n      lines.push('');\n      for (const suggestion of allSuggestions.slice(0, 10)) {\n        lines.push(`- ${suggestion}`);\n      }\n      if (allSuggestions.length > 10) {\n        lines.push(`- ... and ${allSuggestions.length - 10} more`);\n      }\n      lines.push('');\n    }\n\n    return lines.join('\\n');\n  }\n\n  /**\n   * Update configuration.\n   */\n  configure(config: Partial<VerifyConfig>): void {\n    this.config = { ...this.config, ...config };\n  }\n\n  /**\n   * Generate a human-readable summary of verification results.\n   */\n  private generateSummary(\n    reports: VerificationReport[],\n    allIssues: VerificationIssue[]\n  ): string {\n    const parts: string[] = [];\n\n    // Overall status\n    const passed = reports.every((r) => r.passed);\n    const avgScore =\n      reports.length > 0\n        ? Math.round(\n            reports.reduce((sum, r) => sum + r.score, 0) / reports.length\n          )\n        : 100;\n\n    parts.push(passed ? '✓ Verification passed' : '✗ Verification failed');\n    parts.push(`Score: ${avgScore}/100`);\n    parts.push('');\n\n    // Per-tier summary\n    for (const report of reports) {\n      const icon = report.passed ? '✓' : '✗';\n      parts.push(`${icon} ${report.tier}: ${report.score}/100`);\n    }\n    parts.push('');\n\n    // Issue summary\n    const errors = allIssues.filter((i) => i.severity === 'error');\n    const warnings = allIssues.filter((i) => i.severity === 'warning');\n    const infos = allIssues.filter((i) => i.severity === 'info');\n\n    if (errors.length > 0) {\n      parts.push(`Errors: ${errors.length}`);\n    }\n    if (warnings.length > 0) {\n      parts.push(`Warnings: ${warnings.length}`);\n    }\n    if (infos.length > 0) {\n      parts.push(`Info: ${infos.length}`);\n    }\n\n    return parts.join('\\n');\n  }\n\n  /**\n   * Format tier name for display.\n   */\n  private formatTierName(tier: VerificationTier): string {\n    switch (tier) {\n      case 'structure':\n        return 'Tier 1: Structure';\n      case 'behavior':\n        return 'Tier 2: Behavior';\n      case 'ai_review':\n        return 'Tier 3: AI Review';\n      default:\n        return tier;\n    }\n  }\n}\n\n/**\n * Create a new VerifyService instance.\n */\nexport function createVerifyService(\n  config?: Partial<VerifyConfig>\n): VerifyService {\n  return new VerifyService(config);\n}\n\n/** Default singleton instance */\nexport const verifyService = new VerifyService();\n"],"mappings":"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"}

package/dist/services/versioning/changelog-formatter.d.mts

@@ -0,0 +1,24 @@
+import { ChangelogJsonExport, VersionAnalyzeResult } from "./types.mjs";
+import { ChangelogEntry } from "@contractspec/lib.contracts";
+
+//#region src/services/versioning/changelog-formatter.d.ts
+
+/**
+ * Format entries as Keep a Changelog markdown.
+ *
+ * @see https://keepachangelog.com/
+ */
+declare function formatKeepAChangelog(entries: ChangelogEntry[]): string;
+/**
+ * Format entries as Conventional Changelog markdown.
+ *
+ * @see https://www.conventionalcommits.org/
+ */
+declare function formatConventionalChangelog(entries: ChangelogEntry[]): string;
+/**
+ * Format analysis result as JSON export.
+ */
+declare function formatChangelogJson(analysis: VersionAnalyzeResult, baseline?: string): ChangelogJsonExport;
+//#endregion
+export { formatChangelogJson, formatConventionalChangelog, formatKeepAChangelog };
+//# sourceMappingURL=changelog-formatter.d.mts.map

package/dist/services/versioning/changelog-formatter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog-formatter.d.mts","names":[],"sources":["../../../src/services/versioning/changelog-formatter.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;iBAmBgB,oBAAA,UAA8B;;;;;;iBA4G9B,2BAAA,UAAqC;;;;iBAmDrC,mBAAA,WACJ,0CAET"}

package/dist/services/versioning/changelog-formatter.mjs

@@ -0,0 +1,155 @@
+//#region src/services/versioning/changelog-formatter.ts
+/**
+* Format entries as Keep a Changelog markdown.
+*
+* @see https://keepachangelog.com/
+*/
+function formatKeepAChangelog(entries) {
+	const lines = [
+		"# Changelog",
+		"",
+		"All notable changes to this project will be documented in this file.",
+		"",
+		"The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),",
+		"and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).",
+		""
+	];
+	const sorted = [...entries].sort((a, b) => compareVersionsDescending(a.version, b.version));
+	for (const entry of sorted) {
+		lines.push(`## [${entry.version}] - ${entry.date}`);
+		lines.push("");
+		const added = entry.changes.filter((c) => c.type === "added");
+		const changed = entry.changes.filter((c) => c.type === "changed");
+		const deprecated = entry.changes.filter((c) => c.type === "deprecated");
+		const removed = entry.changes.filter((c) => c.type === "removed");
+		const fixed = entry.changes.filter((c) => c.type === "fixed");
+		const security = entry.changes.filter((c) => c.type === "security");
+		const breaking = entry.breakingChanges ?? entry.changes.filter((c) => c.type === "breaking");
+		if (breaking.length > 0) {
+			lines.push("### ⚠️ Breaking Changes");
+			breaking.forEach((c) => {
+				lines.push(`- ${c.description}${c.path ? ` (${c.path})` : ""}`);
+			});
+			lines.push("");
+		}
+		if (added.length > 0) {
+			lines.push("### Added");
+			added.forEach((c) => {
+				lines.push(`- ${c.description}${c.path ? ` (${c.path})` : ""}`);
+			});
+			lines.push("");
+		}
+		if (changed.length > 0) {
+			lines.push("### Changed");
+			changed.forEach((c) => {
+				lines.push(`- ${c.description}${c.path ? ` (${c.path})` : ""}`);
+			});
+			lines.push("");
+		}
+		if (deprecated.length > 0) {
+			lines.push("### Deprecated");
+			deprecated.forEach((c) => {
+				lines.push(`- ${c.description}${c.path ? ` (${c.path})` : ""}`);
+			});
+			lines.push("");
+		}
+		if (removed.length > 0) {
+			lines.push("### Removed");
+			removed.forEach((c) => {
+				lines.push(`- ${c.description}${c.path ? ` (${c.path})` : ""}`);
+			});
+			lines.push("");
+		}
+		if (fixed.length > 0) {
+			lines.push("### Fixed");
+			fixed.forEach((c) => {
+				lines.push(`- ${c.description}${c.path ? ` (${c.path})` : ""}`);
+			});
+			lines.push("");
+		}
+		if (security.length > 0) {
+			lines.push("### Security");
+			security.forEach((c) => {
+				lines.push(`- ${c.description}${c.path ? ` (${c.path})` : ""}`);
+			});
+			lines.push("");
+		}
+	}
+	return lines.join("\n");
+}
+/**
+* Format entries as Conventional Changelog markdown.
+*
+* @see https://www.conventionalcommits.org/
+*/
+function formatConventionalChangelog(entries) {
+	const lines = ["# Changelog", ""];
+	const sorted = [...entries].sort((a, b) => compareVersionsDescending(a.version, b.version));
+	for (const entry of sorted) {
+		const bumpLabel = entry.bumpType === "major" ? "💥 BREAKING RELEASE" : entry.bumpType === "minor" ? "🚀 Minor Release" : "🔧 Patch Release";
+		lines.push(`## ${entry.version} (${entry.date}) - ${bumpLabel}`);
+		lines.push("");
+		const typeMapping = {
+			added: "feat",
+			changed: "refactor",
+			fixed: "fix",
+			removed: "refactor",
+			deprecated: "deprecate",
+			breaking: "feat!",
+			security: "security"
+		};
+		for (const change of entry.changes) {
+			const type = typeMapping[change.type] ?? "chore";
+			const scope = change.path ? `(${change.path})` : "";
+			const breakingMarker = change.type === "breaking" ? "!" : "";
+			lines.push(`- **${type}${scope}${breakingMarker}**: ${change.description}`);
+		}
+		lines.push("");
+	}
+	return lines.join("\n");
+}
+/**
+* Format analysis result as JSON export.
+*/
+function formatChangelogJson(analysis, baseline) {
+	const specsNeedingBump = analysis.analyses.filter((a) => a.needsBump);
+	const isoDateTime = (/* @__PURE__ */ new Date()).toISOString();
+	const isoDate = isoDateTime.split("T")[0] ?? "";
+	return {
+		generatedAt: isoDateTime,
+		baseline,
+		specs: specsNeedingBump.map((spec) => ({
+			key: spec.specKey,
+			version: spec.suggestedVersion,
+			path: spec.specPath,
+			entries: [{
+				version: spec.suggestedVersion,
+				date: isoDate,
+				bumpType: spec.bumpType,
+				changes: spec.changes,
+				breakingChanges: spec.changes.filter((c) => c.type === "breaking")
+			}]
+		})),
+		libraries: []
+	};
+}
+/**
+* Compare versions in descending order (newest first).
+*/
+function compareVersionsDescending(a, b) {
+	const parseVer = (v) => {
+		return v.split(".").map((p) => parseInt(p, 10) || 0);
+	};
+	const aParts = parseVer(a);
+	const bParts = parseVer(b);
+	for (let i = 0; i < 3; i++) {
+		const aVal = aParts[i] ?? 0;
+		const bVal = bParts[i] ?? 0;
+		if (aVal !== bVal) return bVal - aVal;
+	}
+	return 0;
+}
+
+//#endregion
+export { formatChangelogJson, formatConventionalChangelog, formatKeepAChangelog };
+//# sourceMappingURL=changelog-formatter.mjs.map

package/dist/services/versioning/changelog-formatter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog-formatter.mjs","names":[],"sources":["../../../src/services/versioning/changelog-formatter.ts"],"sourcesContent":["/**\n * Changelog formatters.\n *\n * Format changelog entries as Markdown (Keep a Changelog, Conventional)\n * or JSON for programmatic use.\n */\n\nimport type { ChangelogEntry, ChangeEntry } from '@contractspec/lib.contracts';\nimport type { VersionAnalyzeResult, ChangelogJsonExport } from './types';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Keep a Changelog Format\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Format entries as Keep a Changelog markdown.\n *\n * @see https://keepachangelog.com/\n */\nexport function formatKeepAChangelog(entries: ChangelogEntry[]): string {\n  const lines: string[] = [\n    '# Changelog',\n    '',\n    'All notable changes to this project will be documented in this file.',\n    '',\n    'The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),',\n    'and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).',\n    '',\n  ];\n\n  // Sort entries by version (newest first)\n  const sorted = [...entries].sort((a, b) =>\n    compareVersionsDescending(a.version, b.version)\n  );\n\n  for (const entry of sorted) {\n    lines.push(`## [${entry.version}] - ${entry.date}`);\n    lines.push('');\n\n    // Group changes by type\n    const added = entry.changes.filter((c: ChangeEntry) => c.type === 'added');\n    const changed = entry.changes.filter(\n      (c: ChangeEntry) => c.type === 'changed'\n    );\n    const deprecated = entry.changes.filter(\n      (c: ChangeEntry) => c.type === 'deprecated'\n    );\n    const removed = entry.changes.filter(\n      (c: ChangeEntry) => c.type === 'removed'\n    );\n    const fixed = entry.changes.filter((c: ChangeEntry) => c.type === 'fixed');\n    const security = entry.changes.filter(\n      (c: ChangeEntry) => c.type === 'security'\n    );\n    const breaking =\n      entry.breakingChanges ??\n      entry.changes.filter((c: ChangeEntry) => c.type === 'breaking');\n\n    if (breaking.length > 0) {\n      lines.push('### ⚠️ Breaking Changes');\n      breaking.forEach((c: ChangeEntry) => {\n        lines.push(`- ${c.description}${c.path ? ` (${c.path})` : ''}`);\n      });\n      lines.push('');\n    }\n\n    if (added.length > 0) {\n      lines.push('### Added');\n      added.forEach((c: ChangeEntry) => {\n        lines.push(`- ${c.description}${c.path ? ` (${c.path})` : ''}`);\n      });\n      lines.push('');\n    }\n\n    if (changed.length > 0) {\n      lines.push('### Changed');\n      changed.forEach((c: ChangeEntry) => {\n        lines.push(`- ${c.description}${c.path ? ` (${c.path})` : ''}`);\n      });\n      lines.push('');\n    }\n\n    if (deprecated.length > 0) {\n      lines.push('### Deprecated');\n      deprecated.forEach((c: ChangeEntry) => {\n        lines.push(`- ${c.description}${c.path ? ` (${c.path})` : ''}`);\n      });\n      lines.push('');\n    }\n\n    if (removed.length > 0) {\n      lines.push('### Removed');\n      removed.forEach((c: ChangeEntry) => {\n        lines.push(`- ${c.description}${c.path ? ` (${c.path})` : ''}`);\n      });\n      lines.push('');\n    }\n\n    if (fixed.length > 0) {\n      lines.push('### Fixed');\n      fixed.forEach((c: ChangeEntry) => {\n        lines.push(`- ${c.description}${c.path ? ` (${c.path})` : ''}`);\n      });\n      lines.push('');\n    }\n\n    if (security.length > 0) {\n      lines.push('### Security');\n      security.forEach((c: ChangeEntry) => {\n        lines.push(`- ${c.description}${c.path ? ` (${c.path})` : ''}`);\n      });\n      lines.push('');\n    }\n  }\n\n  return lines.join('\\n');\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Conventional Changelog Format\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Format entries as Conventional Changelog markdown.\n *\n * @see https://www.conventionalcommits.org/\n */\nexport function formatConventionalChangelog(entries: ChangelogEntry[]): string {\n  const lines: string[] = ['# Changelog', ''];\n\n  // Sort entries by version (newest first)\n  const sorted = [...entries].sort((a, b) =>\n    compareVersionsDescending(a.version, b.version)\n  );\n\n  for (const entry of sorted) {\n    const bumpLabel =\n      entry.bumpType === 'major'\n        ? '💥 BREAKING RELEASE'\n        : entry.bumpType === 'minor'\n          ? '🚀 Minor Release'\n          : '🔧 Patch Release';\n\n    lines.push(`## ${entry.version} (${entry.date}) - ${bumpLabel}`);\n    lines.push('');\n\n    // Map change types to conventional commit types\n    const typeMapping: Record<string, string> = {\n      added: 'feat',\n      changed: 'refactor',\n      fixed: 'fix',\n      removed: 'refactor',\n      deprecated: 'deprecate',\n      breaking: 'feat!',\n      security: 'security',\n    };\n\n    for (const change of entry.changes) {\n      const type = typeMapping[change.type] ?? 'chore';\n      const scope = change.path ? `(${change.path})` : '';\n      const breakingMarker = change.type === 'breaking' ? '!' : '';\n      lines.push(\n        `- **${type}${scope}${breakingMarker}**: ${change.description}`\n      );\n    }\n    lines.push('');\n  }\n\n  return lines.join('\\n');\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// JSON Format\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Format analysis result as JSON export.\n */\nexport function formatChangelogJson(\n  analysis: VersionAnalyzeResult,\n  baseline?: string\n): ChangelogJsonExport {\n  const specsNeedingBump = analysis.analyses.filter((a) => a.needsBump);\n\n  const isoDateTime = new Date().toISOString();\n  const isoDate = isoDateTime.split('T')[0] ?? '';\n\n  return {\n    generatedAt: isoDateTime,\n    baseline,\n    specs: specsNeedingBump.map((spec) => ({\n      key: spec.specKey,\n      version: spec.suggestedVersion,\n      path: spec.specPath,\n      entries: [\n        {\n          version: spec.suggestedVersion,\n          date: isoDate,\n          bumpType: spec.bumpType,\n          changes: spec.changes,\n          breakingChanges: spec.changes.filter((c) => c.type === 'breaking'),\n        },\n      ],\n    })),\n    libraries: [], // TODO: Group by library\n  };\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Compare versions in descending order (newest first).\n */\nfunction compareVersionsDescending(a: string, b: string): number {\n  const parseVer = (v: string): number[] => {\n    const parts = v.split('.').map((p) => parseInt(p, 10) || 0);\n    return parts;\n  };\n\n  const aParts = parseVer(a);\n  const bParts = parseVer(b);\n\n  for (let i = 0; i < 3; i++) {\n    const aVal = aParts[i] ?? 0;\n    const bVal = bParts[i] ?? 0;\n    if (aVal !== bVal) {\n      return bVal - aVal; // Descending\n    }\n  }\n\n  return 0;\n}\n"],"mappings":"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"}

package/dist/services/versioning/conventional-commits.d.mts

@@ -0,0 +1,95 @@
+import { ChangeEntry, VersionBumpType } from "@contractspec/lib.contracts";
+
+//#region src/services/versioning/conventional-commits.d.ts
+
+/**
+ * Parsed conventional commit message.
+ */
+interface ConventionalCommit {
+  /** Commit type (feat, fix, chore, etc.) */
+  type: string;
+  /** Optional scope (e.g., auth, api) */
+  scope?: string;
+  /** Whether this is a breaking change */
+  breaking: boolean;
+  /** Commit description */
+  description: string;
+  /** Commit body (optional) */
+  body?: string;
+  /** Breaking change description (if any) */
+  breakingDescription?: string;
+  /** Full original message */
+  raw: string;
+}
+/**
+ * Commit type to bump type mapping.
+ */
+type CommitTypeBumpMap = Record<string, VersionBumpType | null>;
+/**
+ * Default mapping of commit types to version bump types.
+ *
+ * - `feat` → minor (new feature)
+ * - `fix` → patch (bug fix)
+ * - `perf` → patch (performance improvement)
+ * - `refactor` → patch (code refactoring)
+ * - `docs` → null (no version bump)
+ * - `style` → null (no version bump)
+ * - `test` → null (no version bump)
+ * - `chore` → null (no version bump)
+ * - `ci` → null (no version bump)
+ * - `build` → null (no version bump)
+ */
+declare const DEFAULT_COMMIT_TYPE_MAP: CommitTypeBumpMap;
+/**
+ * Parse a conventional commit message.
+ *
+ * @param message - Full commit message (may include body)
+ * @returns Parsed commit or null if not a valid conventional commit
+ */
+declare function parseConventionalCommit(message: string): ConventionalCommit | null;
+/**
+ * Check if a commit message follows conventional commit format.
+ */
+declare function isConventionalCommit(message: string): boolean;
+/**
+ * Determine the version bump type from a conventional commit.
+ *
+ * @param commit - Parsed conventional commit
+ * @param typeMap - Optional custom type-to-bump mapping
+ * @returns Version bump type or null if no bump needed
+ */
+declare function getBumpTypeFromCommit(commit: ConventionalCommit, typeMap?: CommitTypeBumpMap): VersionBumpType | null;
+/**
+ * Determine the highest bump type from multiple commits.
+ *
+ * @param commits - Array of parsed conventional commits
+ * @param typeMap - Optional custom type-to-bump mapping
+ * @returns Highest version bump type or null if no bump needed
+ */
+declare function getHighestBumpType(commits: ConventionalCommit[], typeMap?: CommitTypeBumpMap): VersionBumpType | null;
+/**
+ * Convert a conventional commit to a changelog ChangeEntry.
+ *
+ * @param commit - Parsed conventional commit
+ * @returns ChangeEntry for changelog
+ */
+declare function commitToChangeEntry(commit: ConventionalCommit): ChangeEntry;
+/**
+ * Convert multiple commits to an array of ChangeEntries.
+ */
+declare function commitsToChangeEntries(commits: ConventionalCommit[]): ChangeEntry[];
+/**
+ * Filter commits by scope (for spec-level changes).
+ *
+ * @param commits - Array of parsed conventional commits
+ * @param scope - Scope to filter by (e.g., "auth", "api")
+ * @returns Commits matching the scope
+ */
+declare function filterCommitsByScope(commits: ConventionalCommit[], scope: string): ConventionalCommit[];
+/**
+ * Filter commits that trigger version bumps.
+ */
+declare function filterBumpableCommits(commits: ConventionalCommit[], typeMap?: CommitTypeBumpMap): ConventionalCommit[];
+//#endregion
+export { CommitTypeBumpMap, ConventionalCommit, DEFAULT_COMMIT_TYPE_MAP, commitToChangeEntry, commitsToChangeEntries, filterBumpableCommits, filterCommitsByScope, getBumpTypeFromCommit, getHighestBumpType, isConventionalCommit, parseConventionalCommit };
+//# sourceMappingURL=conventional-commits.d.mts.map

package/dist/services/versioning/conventional-commits.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conventional-commits.d.mts","names":[],"sources":["../../../src/services/versioning/conventional-commits.ts"],"sourcesContent":[],"mappings":";;;;;;;AAwLkB,UAjKD,kBAAA,CAiKC;EAqCF;EAoDA,IAAA,EAAA,MAAA;EAiBA;EAUA,KAAA,CAAA,EAAA,MAAA;EACL;EACA,QAAA,EAAA,OAAA;EACR;EAAkB,WAAA,EAAA,MAAA;;;;;;;;;;;KApQT,iBAAA,GAAoB,eAAe;;;;;;;;;;;;;;;cAoBlC,yBAAyB;;;;;;;iBAyCtB,uBAAA,mBAEb;;;;iBAwCa,oBAAA;;;;;;;;iBAeA,qBAAA,SACN,8BACC,oBACR;;;;;;;;iBAiBa,kBAAA,UACL,gCACA,oBACR;;;;;;;iBAqCa,mBAAA,SAA4B,qBAAqB;;;;iBAoDjD,sBAAA,UACL,uBACR;;;;;;;;iBAea,oBAAA,UACL,sCAER;;;;iBAOa,qBAAA,UACL,gCACA,oBACR"}