@contractspec/bundle.workspace 1.45.4 → 1.45.6

package/dist/services/versioning/conventional-commits.js

@@ -0,0 +1,184 @@
+//#region src/services/versioning/conventional-commits.ts
+/**
+* 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)
+*/
+const DEFAULT_COMMIT_TYPE_MAP = {
+	feat: "minor",
+	fix: "patch",
+	perf: "patch",
+	refactor: "patch",
+	docs: null,
+	style: null,
+	test: null,
+	chore: null,
+	ci: null,
+	build: null,
+	revert: "patch"
+};
+/**
+* Regex pattern for parsing conventional commit messages.
+*
+* Matches: type(scope)!: description
+* Groups:
+* 1. type
+* 2. scope (optional)
+* 3. breaking indicator (optional !)
+* 4. description
+*/
+const CONVENTIONAL_COMMIT_PATTERN = /^(\w+)(?:\(([^)]+)\))?(!)?\s*:\s*(.+)$/;
+/**
+* Pattern for detecting BREAKING CHANGE in commit body/footer.
+*/
+const BREAKING_CHANGE_PATTERN = /^BREAKING[ -]CHANGE:\s*(.+)$/im;
+/**
+* Parse a conventional commit message.
+*
+* @param message - Full commit message (may include body)
+* @returns Parsed commit or null if not a valid conventional commit
+*/
+function parseConventionalCommit(message) {
+	const lines = message.split("\n");
+	const firstLine = lines[0]?.trim();
+	if (!firstLine) return null;
+	const match = firstLine.match(CONVENTIONAL_COMMIT_PATTERN);
+	if (!match) return null;
+	const [, type, scope, breakingIndicator, description] = match;
+	if (!type || !description) return null;
+	const body = lines.slice(1).join("\n").trim() || void 0;
+	const breakingMatch = body?.match(BREAKING_CHANGE_PATTERN);
+	const breakingDescription = breakingMatch?.[1];
+	return {
+		type: type.toLowerCase(),
+		scope: scope?.toLowerCase(),
+		breaking: !!breakingIndicator || !!breakingMatch,
+		description: description.trim(),
+		body,
+		breakingDescription,
+		raw: message
+	};
+}
+/**
+* Check if a commit message follows conventional commit format.
+*/
+function isConventionalCommit(message) {
+	return parseConventionalCommit(message) !== null;
+}
+/**
+* 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
+*/
+function getBumpTypeFromCommit(commit, typeMap = DEFAULT_COMMIT_TYPE_MAP) {
+	if (commit.breaking) return "major";
+	return typeMap[commit.type] ?? 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
+*/
+function getHighestBumpType(commits, typeMap = DEFAULT_COMMIT_TYPE_MAP) {
+	const bumpOrder = [
+		"major",
+		"minor",
+		"patch"
+	];
+	let highest = null;
+	for (const commit of commits) {
+		const bumpType = getBumpTypeFromCommit(commit, typeMap);
+		if (!bumpType) continue;
+		if (!highest) {
+			highest = bumpType;
+			continue;
+		}
+		const currentIndex = bumpOrder.indexOf(highest);
+		if (bumpOrder.indexOf(bumpType) < currentIndex) highest = bumpType;
+	}
+	return highest;
+}
+/**
+* Convert a conventional commit to a changelog ChangeEntry.
+*
+* @param commit - Parsed conventional commit
+* @returns ChangeEntry for changelog
+*/
+function commitToChangeEntry(commit) {
+	if (commit.breaking) return {
+		type: "breaking",
+		description: commit.breakingDescription ?? commit.description,
+		path: commit.scope
+	};
+	switch (commit.type) {
+		case "feat": return {
+			type: "added",
+			description: commit.description,
+			path: commit.scope
+		};
+		case "fix": return {
+			type: "fixed",
+			description: commit.description,
+			path: commit.scope
+		};
+		case "deprecate": return {
+			type: "deprecated",
+			description: commit.description,
+			path: commit.scope
+		};
+		case "remove": return {
+			type: "removed",
+			description: commit.description,
+			path: commit.scope
+		};
+		case "security": return {
+			type: "security",
+			description: commit.description,
+			path: commit.scope
+		};
+		default: return {
+			type: "changed",
+			description: commit.description,
+			path: commit.scope
+		};
+	}
+}
+/**
+* Convert multiple commits to an array of ChangeEntries.
+*/
+function commitsToChangeEntries(commits) {
+	return commits.map(commitToChangeEntry);
+}
+/**
+* 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
+*/
+function filterCommitsByScope(commits, scope) {
+	return commits.filter((c) => c.scope?.toLowerCase() === scope.toLowerCase());
+}
+/**
+* Filter commits that trigger version bumps.
+*/
+function filterBumpableCommits(commits, typeMap = DEFAULT_COMMIT_TYPE_MAP) {
+	return commits.filter((c) => getBumpTypeFromCommit(c, typeMap) !== null);
+}
+
+//#endregion
+export { DEFAULT_COMMIT_TYPE_MAP, commitToChangeEntry, commitsToChangeEntries, filterBumpableCommits, filterCommitsByScope, getBumpTypeFromCommit, getHighestBumpType, isConventionalCommit, parseConventionalCommit };
+//# sourceMappingURL=conventional-commits.js.map

package/dist/services/versioning/conventional-commits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conventional-commits.js","names":["DEFAULT_COMMIT_TYPE_MAP: CommitTypeBumpMap","bumpOrder: VersionBumpType[]","highest: VersionBumpType | null"],"sources":["../../../src/services/versioning/conventional-commits.ts"],"sourcesContent":["/**\n * Conventional commits parser and utilities.\n *\n * Parses conventional commit messages to determine version bump types\n * and extract change information for changelog generation.\n *\n * Supports:\n * - Standard conventional commits (feat, fix, chore, etc.)\n * - Breaking change detection (BREAKING CHANGE: or !)\n * - Scope extraction for spec-level changes\n *\n * @module versioning/conventional-commits\n */\n\nimport type { VersionBumpType, ChangeEntry } from '@contractspec/lib.contracts';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Parsed conventional commit message.\n */\nexport interface ConventionalCommit {\n  /** Commit type (feat, fix, chore, etc.) */\n  type: string;\n  /** Optional scope (e.g., auth, api) */\n  scope?: string;\n  /** Whether this is a breaking change */\n  breaking: boolean;\n  /** Commit description */\n  description: string;\n  /** Commit body (optional) */\n  body?: string;\n  /** Breaking change description (if any) */\n  breakingDescription?: string;\n  /** Full original message */\n  raw: string;\n}\n\n/**\n * Commit type to bump type mapping.\n */\nexport type CommitTypeBumpMap = Record<string, VersionBumpType | null>;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Constants\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Default mapping of commit types to version bump types.\n *\n * - `feat` → minor (new feature)\n * - `fix` → patch (bug fix)\n * - `perf` → patch (performance improvement)\n * - `refactor` → patch (code refactoring)\n * - `docs` → null (no version bump)\n * - `style` → null (no version bump)\n * - `test` → null (no version bump)\n * - `chore` → null (no version bump)\n * - `ci` → null (no version bump)\n * - `build` → null (no version bump)\n */\nexport const DEFAULT_COMMIT_TYPE_MAP: CommitTypeBumpMap = {\n  feat: 'minor',\n  fix: 'patch',\n  perf: 'patch',\n  refactor: 'patch',\n  docs: null,\n  style: null,\n  test: null,\n  chore: null,\n  ci: null,\n  build: null,\n  revert: 'patch',\n};\n\n/**\n * Regex pattern for parsing conventional commit messages.\n *\n * Matches: type(scope)!: description\n * Groups:\n * 1. type\n * 2. scope (optional)\n * 3. breaking indicator (optional !)\n * 4. description\n */\nconst CONVENTIONAL_COMMIT_PATTERN = /^(\\w+)(?:\\(([^)]+)\\))?(!)?\\s*:\\s*(.+)$/;\n\n/**\n * Pattern for detecting BREAKING CHANGE in commit body/footer.\n */\nconst BREAKING_CHANGE_PATTERN = /^BREAKING[ -]CHANGE:\\s*(.+)$/im;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Parser\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Parse a conventional commit message.\n *\n * @param message - Full commit message (may include body)\n * @returns Parsed commit or null if not a valid conventional commit\n */\nexport function parseConventionalCommit(\n  message: string\n): ConventionalCommit | null {\n  const lines = message.split('\\n');\n  const firstLine = lines[0]?.trim();\n\n  if (!firstLine) {\n    return null;\n  }\n\n  const match = firstLine.match(CONVENTIONAL_COMMIT_PATTERN);\n  if (!match) {\n    return null;\n  }\n\n  const [, type, scope, breakingIndicator, description] = match;\n\n  if (!type || !description) {\n    return null;\n  }\n\n  // Extract body (everything after first line)\n  const body = lines.slice(1).join('\\n').trim() || undefined;\n\n  // Check for breaking change in body\n  const breakingMatch = body?.match(BREAKING_CHANGE_PATTERN);\n  const breakingDescription = breakingMatch?.[1];\n\n  return {\n    type: type.toLowerCase(),\n    scope: scope?.toLowerCase(),\n    breaking: !!breakingIndicator || !!breakingMatch,\n    description: description.trim(),\n    body,\n    breakingDescription,\n    raw: message,\n  };\n}\n\n/**\n * Check if a commit message follows conventional commit format.\n */\nexport function isConventionalCommit(message: string): boolean {\n  return parseConventionalCommit(message) !== null;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Bump Type Determination\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Determine the version bump type from a conventional commit.\n *\n * @param commit - Parsed conventional commit\n * @param typeMap - Optional custom type-to-bump mapping\n * @returns Version bump type or null if no bump needed\n */\nexport function getBumpTypeFromCommit(\n  commit: ConventionalCommit,\n  typeMap: CommitTypeBumpMap = DEFAULT_COMMIT_TYPE_MAP\n): VersionBumpType | null {\n  // Breaking changes always trigger major bump\n  if (commit.breaking) {\n    return 'major';\n  }\n\n  // Use type mapping\n  return typeMap[commit.type] ?? null;\n}\n\n/**\n * Determine the highest bump type from multiple commits.\n *\n * @param commits - Array of parsed conventional commits\n * @param typeMap - Optional custom type-to-bump mapping\n * @returns Highest version bump type or null if no bump needed\n */\nexport function getHighestBumpType(\n  commits: ConventionalCommit[],\n  typeMap: CommitTypeBumpMap = DEFAULT_COMMIT_TYPE_MAP\n): VersionBumpType | null {\n  const bumpOrder: VersionBumpType[] = ['major', 'minor', 'patch'];\n\n  let highest: VersionBumpType | null = null;\n\n  for (const commit of commits) {\n    const bumpType = getBumpTypeFromCommit(commit, typeMap);\n\n    if (!bumpType) continue;\n\n    if (!highest) {\n      highest = bumpType;\n      continue;\n    }\n\n    // Check if this bump is higher precedence\n    const currentIndex = bumpOrder.indexOf(highest);\n    const newIndex = bumpOrder.indexOf(bumpType);\n\n    if (newIndex < currentIndex) {\n      highest = bumpType;\n    }\n  }\n\n  return highest;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Change Entry Conversion\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Convert a conventional commit to a changelog ChangeEntry.\n *\n * @param commit - Parsed conventional commit\n * @returns ChangeEntry for changelog\n */\nexport function commitToChangeEntry(commit: ConventionalCommit): ChangeEntry {\n  if (commit.breaking) {\n    return {\n      type: 'breaking',\n      description: commit.breakingDescription ?? commit.description,\n      path: commit.scope,\n    };\n  }\n\n  switch (commit.type) {\n    case 'feat':\n      return {\n        type: 'added',\n        description: commit.description,\n        path: commit.scope,\n      };\n    case 'fix':\n      return {\n        type: 'fixed',\n        description: commit.description,\n        path: commit.scope,\n      };\n    case 'deprecate':\n      return {\n        type: 'deprecated',\n        description: commit.description,\n        path: commit.scope,\n      };\n    case 'remove':\n      return {\n        type: 'removed',\n        description: commit.description,\n        path: commit.scope,\n      };\n    case 'security':\n      return {\n        type: 'security',\n        description: commit.description,\n        path: commit.scope,\n      };\n    default:\n      return {\n        type: 'changed',\n        description: commit.description,\n        path: commit.scope,\n      };\n  }\n}\n\n/**\n * Convert multiple commits to an array of ChangeEntries.\n */\nexport function commitsToChangeEntries(\n  commits: ConventionalCommit[]\n): ChangeEntry[] {\n  return commits.map(commitToChangeEntry);\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Filtering\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Filter commits by scope (for spec-level changes).\n *\n * @param commits - Array of parsed conventional commits\n * @param scope - Scope to filter by (e.g., \"auth\", \"api\")\n * @returns Commits matching the scope\n */\nexport function filterCommitsByScope(\n  commits: ConventionalCommit[],\n  scope: string\n): ConventionalCommit[] {\n  return commits.filter((c) => c.scope?.toLowerCase() === scope.toLowerCase());\n}\n\n/**\n * Filter commits that trigger version bumps.\n */\nexport function filterBumpableCommits(\n  commits: ConventionalCommit[],\n  typeMap: CommitTypeBumpMap = DEFAULT_COMMIT_TYPE_MAP\n): ConventionalCommit[] {\n  return commits.filter((c) => getBumpTypeFromCommit(c, typeMap) !== null);\n}\n"],"mappings":";;;;;;;;;;;;;;;AA+DA,MAAaA,0BAA6C;CACxD,MAAM;CACN,KAAK;CACL,MAAM;CACN,UAAU;CACV,MAAM;CACN,OAAO;CACP,MAAM;CACN,OAAO;CACP,IAAI;CACJ,OAAO;CACP,QAAQ;CACT;;;;;;;;;;;AAYD,MAAM,8BAA8B;;;;AAKpC,MAAM,0BAA0B;;;;;;;AAYhC,SAAgB,wBACd,SAC2B;CAC3B,MAAM,QAAQ,QAAQ,MAAM,KAAK;CACjC,MAAM,YAAY,MAAM,IAAI,MAAM;AAElC,KAAI,CAAC,UACH,QAAO;CAGT,MAAM,QAAQ,UAAU,MAAM,4BAA4B;AAC1D,KAAI,CAAC,MACH,QAAO;CAGT,MAAM,GAAG,MAAM,OAAO,mBAAmB,eAAe;AAExD,KAAI,CAAC,QAAQ,CAAC,YACZ,QAAO;CAIT,MAAM,OAAO,MAAM,MAAM,EAAE,CAAC,KAAK,KAAK,CAAC,MAAM,IAAI;CAGjD,MAAM,gBAAgB,MAAM,MAAM,wBAAwB;CAC1D,MAAM,sBAAsB,gBAAgB;AAE5C,QAAO;EACL,MAAM,KAAK,aAAa;EACxB,OAAO,OAAO,aAAa;EAC3B,UAAU,CAAC,CAAC,qBAAqB,CAAC,CAAC;EACnC,aAAa,YAAY,MAAM;EAC/B;EACA;EACA,KAAK;EACN;;;;;AAMH,SAAgB,qBAAqB,SAA0B;AAC7D,QAAO,wBAAwB,QAAQ,KAAK;;;;;;;;;AAc9C,SAAgB,sBACd,QACA,UAA6B,yBACL;AAExB,KAAI,OAAO,SACT,QAAO;AAIT,QAAO,QAAQ,OAAO,SAAS;;;;;;;;;AAUjC,SAAgB,mBACd,SACA,UAA6B,yBACL;CACxB,MAAMC,YAA+B;EAAC;EAAS;EAAS;EAAQ;CAEhE,IAAIC,UAAkC;AAEtC,MAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,WAAW,sBAAsB,QAAQ,QAAQ;AAEvD,MAAI,CAAC,SAAU;AAEf,MAAI,CAAC,SAAS;AACZ,aAAU;AACV;;EAIF,MAAM,eAAe,UAAU,QAAQ,QAAQ;AAG/C,MAFiB,UAAU,QAAQ,SAAS,GAE7B,aACb,WAAU;;AAId,QAAO;;;;;;;;AAaT,SAAgB,oBAAoB,QAAyC;AAC3E,KAAI,OAAO,SACT,QAAO;EACL,MAAM;EACN,aAAa,OAAO,uBAAuB,OAAO;EAClD,MAAM,OAAO;EACd;AAGH,SAAQ,OAAO,MAAf;EACE,KAAK,OACH,QAAO;GACL,MAAM;GACN,aAAa,OAAO;GACpB,MAAM,OAAO;GACd;EACH,KAAK,MACH,QAAO;GACL,MAAM;GACN,aAAa,OAAO;GACpB,MAAM,OAAO;GACd;EACH,KAAK,YACH,QAAO;GACL,MAAM;GACN,aAAa,OAAO;GACpB,MAAM,OAAO;GACd;EACH,KAAK,SACH,QAAO;GACL,MAAM;GACN,aAAa,OAAO;GACpB,MAAM,OAAO;GACd;EACH,KAAK,WACH,QAAO;GACL,MAAM;GACN,aAAa,OAAO;GACpB,MAAM,OAAO;GACd;EACH,QACE,QAAO;GACL,MAAM;GACN,aAAa,OAAO;GACpB,MAAM,OAAO;GACd;;;;;;AAOP,SAAgB,uBACd,SACe;AACf,QAAO,QAAQ,IAAI,oBAAoB;;;;;;;;;AAczC,SAAgB,qBACd,SACA,OACsB;AACtB,QAAO,QAAQ,QAAQ,MAAM,EAAE,OAAO,aAAa,KAAK,MAAM,aAAa,CAAC;;;;;AAM9E,SAAgB,sBACd,SACA,UAA6B,yBACP;AACtB,QAAO,QAAQ,QAAQ,MAAM,sBAAsB,GAAG,QAAQ,KAAK,KAAK"}

package/dist/services/versioning/index.d.ts

@@ -1,10 +1,11 @@
-import { ChangeEntry, ChangelogDocBlock, ChangelogEntry, ChangelogGenerateOptions, ChangelogGenerateResult, ChangelogJsonExport, ChangelogTier, LibraryChangelogJson, SpecChangelogJson, SpecVersionAnalysis, VersionAnalyzeOptions, VersionAnalyzeResult, VersionBumpOptions, VersionBumpResult, VersionBumpType } from "./types.js";
-import { analyzeVersions, applyVersionBump, generateChangelogs } from "./versioning-service.js";
+import { ChangeEntry, ChangelogDocBlock, ChangelogEntry, ChangelogGenerateOptions, ChangelogGenerateResult, ChangelogJsonExport, ChangelogTier, LibraryChangelogJson, SpecChangelogJson, SpecVersionAnalysis, VersionAnalyzeOptions, VersionAnalyzeResult, VersionBumpOptions, VersionBumpResult, VersionBumpType, VersioningConfig } from "./types.js";
+import { analyzeVersions, analyzeVersionsFromCommits, applyVersionBump, generateChangelogs } from "./versioning-service.js";
 import { formatChangelogJson, formatConventionalChangelog, formatKeepAChangelog } from "./changelog-formatter.js";
+import { CommitTypeBumpMap, ConventionalCommit, DEFAULT_COMMIT_TYPE_MAP, commitToChangeEntry, commitsToChangeEntries, filterBumpableCommits, filterCommitsByScope, getBumpTypeFromCommit, getHighestBumpType, isConventionalCommit, parseConventionalCommit } from "./conventional-commits.js";
 
 //#region src/services/versioning/index.d.ts
 declare namespace index_d_exports {
-  export { ChangeEntry, ChangelogDocBlock, ChangelogEntry, ChangelogGenerateOptions, ChangelogGenerateResult, ChangelogJsonExport, ChangelogTier, LibraryChangelogJson, SpecChangelogJson, SpecVersionAnalysis, VersionAnalyzeOptions, VersionAnalyzeResult, VersionBumpOptions, VersionBumpResult, VersionBumpType, analyzeVersions, applyVersionBump, formatChangelogJson, formatConventionalChangelog, formatKeepAChangelog, generateChangelogs };
+  export { ChangeEntry, ChangelogDocBlock, ChangelogEntry, ChangelogGenerateOptions, ChangelogGenerateResult, ChangelogJsonExport, ChangelogTier, CommitTypeBumpMap, ConventionalCommit, DEFAULT_COMMIT_TYPE_MAP, LibraryChangelogJson, SpecChangelogJson, SpecVersionAnalysis, VersionAnalyzeOptions, VersionAnalyzeResult, VersionBumpOptions, VersionBumpResult, VersionBumpType, VersioningConfig, analyzeVersions, analyzeVersionsFromCommits, applyVersionBump, commitToChangeEntry, commitsToChangeEntries, filterBumpableCommits, filterCommitsByScope, formatChangelogJson, formatConventionalChangelog, formatKeepAChangelog, generateChangelogs, getBumpTypeFromCommit, getHighestBumpType, isConventionalCommit, parseConventionalCommit };
 }
 //#endregion
 export { index_d_exports };

package/dist/services/versioning/index.js

@@ -1,15 +1,26 @@
 import { __exportAll } from "../../_virtual/rolldown_runtime.js";
 import { formatChangelogJson, formatConventionalChangelog, formatKeepAChangelog } from "./changelog-formatter.js";
-import { analyzeVersions, applyVersionBump, generateChangelogs } from "./versioning-service.js";
+import { DEFAULT_COMMIT_TYPE_MAP, commitToChangeEntry, commitsToChangeEntries, filterBumpableCommits, filterCommitsByScope, getBumpTypeFromCommit, getHighestBumpType, isConventionalCommit, parseConventionalCommit } from "./conventional-commits.js";
+import { analyzeVersions, analyzeVersionsFromCommits, applyVersionBump, generateChangelogs } from "./versioning-service.js";
 
 //#region src/services/versioning/index.ts
 var versioning_exports = /* @__PURE__ */ __exportAll({
+	DEFAULT_COMMIT_TYPE_MAP: () => DEFAULT_COMMIT_TYPE_MAP,
 	analyzeVersions: () => analyzeVersions,
+	analyzeVersionsFromCommits: () => analyzeVersionsFromCommits,
 	applyVersionBump: () => applyVersionBump,
+	commitToChangeEntry: () => commitToChangeEntry,
+	commitsToChangeEntries: () => commitsToChangeEntries,
+	filterBumpableCommits: () => filterBumpableCommits,
+	filterCommitsByScope: () => filterCommitsByScope,
 	formatChangelogJson: () => formatChangelogJson,
 	formatConventionalChangelog: () => formatConventionalChangelog,
 	formatKeepAChangelog: () => formatKeepAChangelog,
-	generateChangelogs: () => generateChangelogs
+	generateChangelogs: () => generateChangelogs,
+	getBumpTypeFromCommit: () => getBumpTypeFromCommit,
+	getHighestBumpType: () => getHighestBumpType,
+	isConventionalCommit: () => isConventionalCommit,
+	parseConventionalCommit: () => parseConventionalCommit
 });
 
 //#endregion

package/dist/services/versioning/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/services/versioning/index.ts"],"sourcesContent":["/**\n * Versioning service module exports.\n *\n * Provides version analysis, version bumping, and changelog generation.\n */\n\nexport * from './types';\nexport {\n  analyzeVersions,\n  applyVersionBump,\n  generateChangelogs,\n} from './versioning-service';\nexport {\n  formatKeepAChangelog,\n  formatConventionalChangelog,\n  formatChangelogJson,\n} from './changelog-formatter';\n"],"mappings":""}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/services/versioning/index.ts"],"sourcesContent":["/**\n * Versioning service module exports.\n *\n * Provides version analysis, version bumping, and changelog generation.\n */\n\nexport * from './types';\nexport {\n  analyzeVersions,\n  applyVersionBump,\n  generateChangelogs,\n  analyzeVersionsFromCommits,\n} from './versioning-service';\nexport {\n  formatKeepAChangelog,\n  formatConventionalChangelog,\n  formatChangelogJson,\n} from './changelog-formatter';\nexport * from './conventional-commits';\n"],"mappings":""}

package/dist/services/versioning/types.d.ts

@@ -1,4 +1,4 @@
-import { ChangeEntry, ChangelogDocBlock, ChangelogEntry as ChangelogEntry$1, ChangelogTier, VersionBumpType } from "@contractspec/lib.contracts";
+import { ChangeEntry as ChangeEntry$1, ChangelogDocBlock, ChangelogEntry as ChangelogEntry$1, ChangelogTier, VersionBumpType as VersionBumpType$1, VersioningConfig } from "@contractspec/lib.contracts";
 
 //#region src/services/versioning/types.d.ts
 
@@ -20,13 +20,15 @@ interface VersionBumpOptions {
   /** Spec file path to bump */
   specPath: string;
   /** Bump type (auto-detected if not specified) */
-  bumpType?: VersionBumpType;
+  bumpType?: VersionBumpType$1;
   /** Change description for changelog entry */
   changeDescription?: string;
   /** Additional change entries */
-  changes?: ChangeEntry[];
+  changes?: ChangeEntry$1[];
   /** Dry run (don't write changes) */
   dryRun?: boolean;
+  /** Versioning config (for changesets integration) */
+  config?: VersioningConfig;
 }
 /** Options for changelog generation */
 interface ChangelogGenerateOptions {
@@ -52,9 +54,9 @@ interface SpecVersionAnalysis {
   /** Suggested new version based on changes */
   suggestedVersion: string;
   /** Suggested bump type */
-  bumpType: VersionBumpType;
+  bumpType: VersionBumpType$1;
   /** Detected changes requiring version bump */
-  changes: ChangeEntry[];
+  changes: ChangeEntry$1[];
   /** Whether breaking changes were detected */
   hasBreaking: boolean;
   /** Whether the spec needs a version bump */
@@ -88,7 +90,7 @@ interface VersionBumpResult {
   /** New version */
   newVersion: string;
   /** Bump type applied */
-  bumpType: VersionBumpType;
+  bumpType: VersionBumpType$1;
   /** Changelog entry created */
   changelogEntry: ChangelogEntry$1;
   /** Error message if failed */
@@ -129,5 +131,5 @@ interface LibraryChangelogJson {
   entries: ChangelogEntry$1[];
 }
 //#endregion
-export { type ChangeEntry, type ChangelogDocBlock, type ChangelogEntry$1 as ChangelogEntry, ChangelogGenerateOptions, ChangelogGenerateResult, ChangelogJsonExport, type ChangelogTier, LibraryChangelogJson, SpecChangelogJson, SpecVersionAnalysis, VersionAnalyzeOptions, VersionAnalyzeResult, VersionBumpOptions, VersionBumpResult, type VersionBumpType };
+export { type ChangeEntry$1 as ChangeEntry, type ChangelogDocBlock, type ChangelogEntry$1 as ChangelogEntry, ChangelogGenerateOptions, ChangelogGenerateResult, ChangelogJsonExport, type ChangelogTier, LibraryChangelogJson, SpecChangelogJson, SpecVersionAnalysis, VersionAnalyzeOptions, VersionAnalyzeResult, VersionBumpOptions, VersionBumpResult, type VersionBumpType$1 as VersionBumpType, type VersioningConfig };
 //# sourceMappingURL=types.d.ts.map

package/dist/services/versioning/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/services/versioning/types.ts"],"sourcesContent":[],"mappings":";;;;AA8GA;AAoBiB,UAtGA,qBAAA,CAsGuB;EAEtB;EAEC,QAAA,CAAA,EAAA,MAAA;EAIX;EAAmB,OAAA,CAAA,EAAA,MAAA;EAMV;EAQA,aAAA,CAAA,EAAA,MAAiB;EAQjB;;;;;;UAtHA,kBAAA;;;;aAIJ;;;;YAID;;;;;UAMK,wBAAA;;;;;;UAMP;;;;;;;UAYO,mBAAA;;;;;;;;;;YAUL;;WAED;;;;;;;UAQM,oBAAA;;YAEL;;;;;;;;;;;;;UAcK,iBAAA;;;;;;;;;;;;YAYL;;kBAEM;;;;;UAMD,uBAAA;;kBAEC;;mBAEC;;;;QAIX;;;;;UAMS,mBAAA;;;SAGR;aACI;;;UAII,iBAAA;;;;WAIN;;;UAIM,oBAAA;;;;WAIN"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/services/versioning/types.ts"],"sourcesContent":[],"mappings":";;;;;AA4DiB,UA9BA,qBAAA,CA8BwB;EAkBxB;EAoBA,QAAA,CAAA,EAAA,MAAA;EAgBA;EAoBA,OAAA,CAAA,EAAA,MAAA;EAEC;EAEC,aAAA,CAAA,EAAA,MAAA;EAIX;EAAmB,OAAA,CAAA,EAAA,MAAA,EAAA;EAMV;EAQA,OAAA,CAAA,EAAA,MAAA,EAAA;AAQjB;;UAxHiB,kBAAA;;;;aAIJ;;;;YAID;;;;WAID;;;UAIM,wBAAA;;;;;;UAMP;;;;;;;UAYO,mBAAA;;;;;;;;;;YAUL;;WAED;;;;;;;UAQM,oBAAA;;YAEL;;;;;;;;;;;;;UAcK,iBAAA;;;;;;;;;;;;YAYL;;kBAEM;;;;;UAMD,uBAAA;;kBAEC;;mBAEC;;;;QAIX;;;;;UAMS,mBAAA;;;SAGR;aACI;;;UAII,iBAAA;;;;WAIN;;;UAIM,oBAAA;;;;WAIN"}

package/dist/services/versioning/versioning-service.d.ts

@@ -2,6 +2,7 @@ import { FsAdapter } from "../../ports/fs.js";
 import { GitAdapter } from "../../ports/git.js";
 import { LoggerAdapter } from "../../ports/logger.js";
 import { ChangelogGenerateOptions, ChangelogGenerateResult, VersionAnalyzeOptions, VersionAnalyzeResult, VersionBumpOptions, VersionBumpResult } from "./types.js";
+import { ChangeEntry, VersionBumpType } from "@contractspec/lib.contracts";
 
 //#region src/services/versioning/versioning-service.d.ts
 
@@ -17,6 +18,47 @@ interface ServiceAdapters {
  * which specs need version bumps based on detected changes.
  */
 declare function analyzeVersions(adapters: ServiceAdapters, options?: VersionAnalyzeOptions): Promise<VersionAnalyzeResult>;
+/**
+ * Options for commit-based version analysis.
+ */
+interface CommitAnalyzeOptions {
+  /** Git ref to compare against (branch, tag, commit) */
+  baseline?: string;
+  /** Workspace root directory */
+  workspaceRoot?: string;
+  /** Include commits matching these paths (glob patterns) */
+  include?: string[];
+  /** Exclude commits matching these paths (glob patterns) */
+  exclude?: string[];
+}
+/**
+ * Result of commit-based version analysis.
+ */
+interface CommitAnalyzeResult {
+  /** Suggested bump type based on commits */
+  suggestedBumpType: VersionBumpType | null;
+  /** Parsed conventional commits */
+  commits: {
+    hash: string;
+    message: string;
+    type: string;
+    scope?: string;
+    breaking: boolean;
+  }[];
+  /** Change entries for changelog */
+  changes: ChangeEntry[];
+  /** Total commits analyzed */
+  totalCommits: number;
+  /** Breaking commits count */
+  breakingCommits: number;
+}
+/**
+ * Analyze version bump based on git commits.
+ *
+ * Parses conventional commits since the baseline and determines
+ * the appropriate version bump type.
+ */
+declare function analyzeVersionsFromCommits(adapters: ServiceAdapters, options?: CommitAnalyzeOptions): Promise<CommitAnalyzeResult>;
 /**
  * Apply a version bump to a spec file.
  *
@@ -28,5 +70,5 @@ declare function applyVersionBump(adapters: ServiceAdapters, options: VersionBum
  */
 declare function generateChangelogs(adapters: ServiceAdapters, options?: ChangelogGenerateOptions): Promise<ChangelogGenerateResult>;
 //#endregion
-export { analyzeVersions, applyVersionBump, generateChangelogs };
+export { analyzeVersions, analyzeVersionsFromCommits, applyVersionBump, generateChangelogs };
 //# sourceMappingURL=versioning-service.d.ts.map

package/dist/services/versioning/versioning-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"versioning-service.d.ts","names":[],"sources":["../../../src/services/versioning/versioning-service.ts"],"sourcesContent":[],"mappings":";;;;;;;UAmCU,eAAA,CAGa;EAaD,EAAA,EAfhB,SAegB;EACV,GAAA,EAfL,UAeK;EACD,MAAA,EAfD,aAeC;;;;AAwGX;;;;AAGG,iBA7GmB,eAAA,CA6GnB,QAAA,EA5GS,eA4GT,EAAA,OAAA,CAAA,EA3GQ,qBA2GR,CAAA,EA1GA,OA0GA,CA1GQ,oBA0GR,CAAA;;AAiGH;;;;AAGG,iBAvGmB,gBAAA,CAuGnB,QAAA,EAtGS,eAsGT,EAAA,OAAA,EArGQ,kBAqGR,CAAA,EApGA,OAoGA,CApGQ,iBAoGR,CAAA;;;;iBAHmB,kBAAA,WACV,2BACD,2BACR,QAAQ"}
+{"version":3,"file":"versioning-service.d.ts","names":[],"sources":["../../../src/services/versioning/versioning-service.ts"],"sourcesContent":[],"mappings":";;;;;;;;UA0CU,eAAA,CAGa;EAaD,EAAA,EAfhB,SAegB;EACV,GAAA,EAfL,UAeK;EACD,MAAA,EAfD,aAeC;;;;AAsGX;AAcA;AAyBA;;AAEW,iBAjJW,eAAA,CAiJX,QAAA,EAhJC,eAgJD,EAAA,OAAA,CAAA,EA/IA,qBA+IA,CAAA,EA9IR,OA8IQ,CA9IA,oBA8IA,CAAA;;;;AAsEW,UA/GL,oBAAA,CA+GqB;EAC1B;EACD,QAAA,CAAA,EAAA,MAAA;EACA;EAAR,aAAA,CAAA,EAAA,MAAA;EAAO;EA6GY,OAAA,CAAA,EAAA,MAAA,EAAA;EACV;EACD,OAAA,CAAA,EAAA,MAAA,EAAA;;;;;UAnNM,mBAAA;;qBAEI;;;;;;;;;;WAUV;;;;;;;;;;;;iBAaW,0BAAA,WACV,2BACD,uBACR,QAAQ;;;;;;iBAqEW,gBAAA,WACV,0BACD,qBACR,QAAQ;;;;iBA6GW,kBAAA,WACV,2BACD,2BACR,QAAQ"}

package/dist/services/versioning/versioning-service.js

@@ -1,4 +1,6 @@
+import { findPackageRoot, getPackageName } from "../../adapters/workspace.js";
 import { formatChangelogJson, formatKeepAChangelog } from "./changelog-formatter.js";
+import { commitsToChangeEntries, getHighestBumpType, parseConventionalCommit } from "./conventional-commits.js";
 import { bumpVersion, determineBumpType } from "@contractspec/lib.contracts";
 
 //#region src/services/versioning/versioning-service.ts
@@ -75,13 +77,66 @@ async function analyzeVersions(adapters, options = {}) {
 	};
 }
 /**
+* Analyze version bump based on git commits.
+*
+* Parses conventional commits since the baseline and determines
+* the appropriate version bump type.
+*/
+async function analyzeVersionsFromCommits(adapters, options = {}) {
+	const { git, logger } = adapters;
+	const baseline = options.baseline ?? "HEAD~10";
+	logger.info("Analyzing commits for version bump...", { baseline });
+	try {
+		const commitLog = await git.log(baseline);
+		const parsedCommits = [];
+		const conventionalCommits = [];
+		for (const commit of commitLog) {
+			const parsed = parseConventionalCommit(commit.message);
+			if (parsed) {
+				parsedCommits.push({
+					hash: commit.hash,
+					message: commit.message,
+					type: parsed.type,
+					scope: parsed.scope,
+					breaking: parsed.breaking
+				});
+				conventionalCommits.push(parsed);
+			}
+		}
+		const suggestedBumpType = getHighestBumpType(conventionalCommits);
+		const changes = commitsToChangeEntries(conventionalCommits);
+		const breakingCommits = parsedCommits.filter((c) => c.breaking).length;
+		logger.info("Commit analysis complete", {
+			totalCommits: parsedCommits.length,
+			breakingCommits,
+			suggestedBumpType
+		});
+		return {
+			suggestedBumpType,
+			commits: parsedCommits,
+			changes,
+			totalCommits: parsedCommits.length,
+			breakingCommits
+		};
+	} catch (error) {
+		logger.warn("Failed to analyze commits", { error: error instanceof Error ? error.message : String(error) });
+		return {
+			suggestedBumpType: null,
+			commits: [],
+			changes: [],
+			totalCommits: 0,
+			breakingCommits: 0
+		};
+	}
+}
+/**
 * Apply a version bump to a spec file.
 *
 * Updates the version in the spec file and creates a changelog entry.
 */
 async function applyVersionBump(adapters, options) {
 	const { fs, logger } = adapters;
-	const { specPath, dryRun = false } = options;
+	const { specPath, dryRun = false, config } = options;
 	logger.info("Applying version bump...", {
 		specPath,
 		bumpType: options.bumpType
@@ -122,6 +177,12 @@ async function applyVersionBump(adapters, options) {
 			previousVersion: meta.version,
 			newVersion
 		});
+		if (config?.integrateWithChangesets) await generateChangeset(adapters, {
+			specPath,
+			bumpType,
+			summary: options.changeDescription ?? `Bump ${meta.key} to ${newVersion}`,
+			dryRun
+		});
 		return {
 			success: true,
 			specPath,
@@ -353,7 +414,88 @@ function specToChangelogEntry(spec) {
 		breakingChanges: spec.changes.filter((c) => c.type === "breaking")
 	};
 }
+/**
+* Generate a changeset file for a spec update.
+*/
+async function generateChangeset(adapters, options) {
+	const { fs, logger } = adapters;
+	const { specPath, bumpType, summary, dryRun } = options;
+	try {
+		const pkgRoot = findPackageRoot(specPath);
+		const pkgName = getPackageName(pkgRoot);
+		if (!pkgName) {
+			logger.warn("Could not determine package name for changeset", { specPath });
+			return;
+		}
+		let currentDir = pkgRoot;
+		let changesetDir = null;
+		while (true) {
+			const candidate = fs.join(currentDir, ".changeset");
+			if (await fs.exists(candidate)) {
+				changesetDir = candidate;
+				break;
+			}
+			const parent = fs.dirname(currentDir);
+			if (parent === currentDir) break;
+			currentDir = parent;
+		}
+		if (!changesetDir) {
+			logger.warn("No .changeset directory found, skipping changeset generation");
+			return;
+		}
+		const fileName = `${generateRandomName()}.md`;
+		const filePath = fs.join(changesetDir, fileName);
+		const content = `---
+"${pkgName}": ${bumpType}
+---
+
+${summary}
+`;
+		if (!dryRun) {
+			await fs.writeFile(filePath, content);
+			logger.info("Generated changeset", { filePath });
+		} else logger.info("Would generate changeset", {
+			filePath,
+			content
+		});
+	} catch (error) {
+		logger.error("Failed to generate changeset", { error: error instanceof Error ? error.message : String(error) });
+	}
+}
+/**
+* Generate a random human-readable-ish name (simplified).
+*/
+function generateRandomName() {
+	const adjectives = [
+		"neat",
+		"calm",
+		"wild",
+		"soft",
+		"bold",
+		"fair",
+		"cool"
+	];
+	const nouns = [
+		"fox",
+		"cat",
+		"dog",
+		"bat",
+		"ant",
+		"elk",
+		"owl"
+	];
+	const verbs = [
+		"run",
+		"fly",
+		"hop",
+		"eat",
+		"nap",
+		"cry",
+		"sing"
+	];
+	return `${adjectives[Math.floor(Math.random() * adjectives.length)]}-${nouns[Math.floor(Math.random() * nouns.length)]}-${verbs[Math.floor(Math.random() * verbs.length)]}-${Math.floor(Math.random() * 1e3)}`;
+}
 
 //#endregion
-export { analyzeVersions, applyVersionBump, generateChangelogs };
+export { analyzeVersions, analyzeVersionsFromCommits, applyVersionBump, generateChangelogs };
 //# sourceMappingURL=versioning-service.js.map