@contractspec/bundle.workspace 1.46.1 → 1.47.0

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

@@ -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.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conventional-commits.mjs","names":[],"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,MAAa,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,MAAM,YAA+B;EAAC;EAAS;EAAS;EAAQ;CAEhE,IAAI,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.mts

@@ -0,0 +1,12 @@
+import { ChangeEntry, ChangelogDocBlock, ChangelogEntry, ChangelogGenerateOptions, ChangelogGenerateResult, ChangelogJsonExport, ChangelogTier, LibraryChangelogJson, SpecChangelogJson, SpecVersionAnalysis, VersionAnalyzeOptions, VersionAnalyzeResult, VersionBumpOptions, VersionBumpResult, VersionBumpType, VersioningConfig } from "./types.mjs";
+import { analyzeVersions, analyzeVersionsFromCommits, applyVersionBump, generateChangelogs } from "./versioning-service.mjs";
+import { formatChangelogJson, formatConventionalChangelog, formatKeepAChangelog } from "./changelog-formatter.mjs";
+import { CommitTypeBumpMap, ConventionalCommit, DEFAULT_COMMIT_TYPE_MAP, commitToChangeEntry, commitsToChangeEntries, filterBumpableCommits, filterCommitsByScope, getBumpTypeFromCommit, getHighestBumpType, isConventionalCommit, parseConventionalCommit } from "./conventional-commits.mjs";
+
+//#region src/services/versioning/index.d.ts
+declare namespace index_d_exports {
+  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 };
+//# sourceMappingURL=index.d.mts.map

package/dist/services/versioning/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/services/versioning/index.ts"],"sourcesContent":[],"mappings":""}

package/dist/services/versioning/index.mjs

@@ -0,0 +1,28 @@
+import { __exportAll } from "../../_virtual/rolldown_runtime.mjs";
+import { formatChangelogJson, formatConventionalChangelog, formatKeepAChangelog } from "./changelog-formatter.mjs";
+import { DEFAULT_COMMIT_TYPE_MAP, commitToChangeEntry, commitsToChangeEntries, filterBumpableCommits, filterCommitsByScope, getBumpTypeFromCommit, getHighestBumpType, isConventionalCommit, parseConventionalCommit } from "./conventional-commits.mjs";
+import { analyzeVersions, analyzeVersionsFromCommits, applyVersionBump, generateChangelogs } from "./versioning-service.mjs";
+
+//#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,
+	getBumpTypeFromCommit: () => getBumpTypeFromCommit,
+	getHighestBumpType: () => getHighestBumpType,
+	isConventionalCommit: () => isConventionalCommit,
+	parseConventionalCommit: () => parseConventionalCommit
+});
+
+//#endregion
+export { versioning_exports };
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","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.mts

@@ -0,0 +1,135 @@
+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
+
+/** Options for version analysis */
+interface VersionAnalyzeOptions {
+  /** Git ref to compare against (branch, tag, commit) */
+  baseline?: string;
+  /** Glob pattern for spec discovery */
+  pattern?: string;
+  /** Workspace root directory */
+  workspaceRoot?: string;
+  /** Include paths (glob patterns) */
+  include?: string[];
+  /** Exclude paths (glob patterns) */
+  exclude?: string[];
+}
+/** Options for version bump */
+interface VersionBumpOptions {
+  /** Spec file path to bump */
+  specPath: string;
+  /** Bump type (auto-detected if not specified) */
+  bumpType?: VersionBumpType$1;
+  /** Change description for changelog entry */
+  changeDescription?: string;
+  /** Additional change entries */
+  changes?: ChangeEntry$1[];
+  /** Dry run (don't write changes) */
+  dryRun?: boolean;
+  /** Versioning config (for changesets integration) */
+  config?: VersioningConfig;
+}
+/** Options for changelog generation */
+interface ChangelogGenerateOptions {
+  /** Git ref to compare against */
+  baseline?: string;
+  /** Workspace root directory */
+  workspaceRoot?: string;
+  /** Changelog tiers to generate */
+  tiers?: ChangelogTier[];
+  /** Output format */
+  format?: 'keep-a-changelog' | 'conventional' | 'custom';
+  /** Custom template (for 'custom' format) */
+  template?: string;
+}
+/** Result of version analysis for a single spec */
+interface SpecVersionAnalysis {
+  /** Path to the spec file */
+  specPath: string;
+  /** Spec key (e.g., "auth.login") */
+  specKey: string;
+  /** Current version in the spec */
+  currentVersion: string;
+  /** Suggested new version based on changes */
+  suggestedVersion: string;
+  /** Suggested bump type */
+  bumpType: VersionBumpType$1;
+  /** Detected changes requiring version bump */
+  changes: ChangeEntry$1[];
+  /** Whether breaking changes were detected */
+  hasBreaking: boolean;
+  /** Whether the spec needs a version bump */
+  needsBump: boolean;
+}
+/** Aggregated version analysis result */
+interface VersionAnalyzeResult {
+  /** Individual spec analyses */
+  analyses: SpecVersionAnalysis[];
+  /** Total specs analyzed */
+  totalSpecs: number;
+  /** Specs needing version bump */
+  specsNeedingBump: number;
+  /** Total breaking changes across all specs */
+  totalBreaking: number;
+  /** Total non-breaking changes */
+  totalNonBreaking: number;
+  /** Git baseline used for comparison */
+  baseline?: string;
+}
+/** Result of version bump operation */
+interface VersionBumpResult {
+  /** Whether the bump was successful */
+  success: boolean;
+  /** Path to the updated spec file */
+  specPath: string;
+  /** Spec key */
+  specKey: string;
+  /** Previous version */
+  previousVersion: string;
+  /** New version */
+  newVersion: string;
+  /** Bump type applied */
+  bumpType: VersionBumpType$1;
+  /** Changelog entry created */
+  changelogEntry: ChangelogEntry$1;
+  /** Error message if failed */
+  error?: string;
+}
+/** Result of changelog generation */
+interface ChangelogGenerateResult {
+  /** Per-spec DocBlock entries */
+  specChangelogs: ChangelogDocBlock[];
+  /** Library-level markdown by package path */
+  libraryMarkdown: Map<string, string>;
+  /** Monorepo-level markdown */
+  monorepoMarkdown: string;
+  /** JSON format for programmatic use */
+  json: ChangelogJsonExport;
+  /** Total entries generated */
+  totalEntries: number;
+}
+/** JSON export format for changelogs */
+interface ChangelogJsonExport {
+  generatedAt: string;
+  baseline?: string;
+  specs: SpecChangelogJson[];
+  libraries: LibraryChangelogJson[];
+}
+/** Spec-level changelog in JSON format */
+interface SpecChangelogJson {
+  key: string;
+  version: string;
+  path: string;
+  entries: ChangelogEntry$1[];
+}
+/** Library-level changelog in JSON format */
+interface LibraryChangelogJson {
+  name: string;
+  path: string;
+  version: string;
+  entries: ChangelogEntry$1[];
+}
+//#endregion
+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.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","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.mts

@@ -0,0 +1,74 @@
+import { FsAdapter } from "../../ports/fs.mjs";
+import { GitAdapter } from "../../ports/git.mjs";
+import { LoggerAdapter } from "../../ports/logger.mjs";
+import { ChangelogGenerateOptions, ChangelogGenerateResult, VersionAnalyzeOptions, VersionAnalyzeResult, VersionBumpOptions, VersionBumpResult } from "./types.mjs";
+import { ChangeEntry, VersionBumpType } from "@contractspec/lib.contracts";
+
+//#region src/services/versioning/versioning-service.d.ts
+
+interface ServiceAdapters {
+  fs: FsAdapter;
+  git: GitAdapter;
+  logger: LoggerAdapter;
+}
+/**
+ * Analyze specs and suggest version bumps based on changes.
+ *
+ * Compares the current state against a baseline (git ref) and determines
+ * 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.
+ *
+ * Updates the version in the spec file and creates a changelog entry.
+ */
+declare function applyVersionBump(adapters: ServiceAdapters, options: VersionBumpOptions): Promise<VersionBumpResult>;
+/**
+ * Generate changelogs at all configured tiers.
+ */
+declare function generateChangelogs(adapters: ServiceAdapters, options?: ChangelogGenerateOptions): Promise<ChangelogGenerateResult>;
+//#endregion
+export { analyzeVersions, analyzeVersionsFromCommits, applyVersionBump, generateChangelogs };
+//# sourceMappingURL=versioning-service.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"versioning-service.d.mts","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"}