@codluv/versionguard 0.5.0 → 0.7.0

package/dist/calver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calver.d.ts","sourceRoot":"","sources":["../src/calver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,MAAM,EACN,YAAY,EAEZ,WAAW,EAEX,gBAAgB,EACjB,MAAM,SAAS,CAAC;AA8BjB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,IAAI,YAAY,CAoBhF;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAE3B;;;;OAIG;IACH,KAAK,CAAC,EAAE,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC;IAE1B;;;;OAIG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAEnB;;;;OAIG;IACH,GAAG,CAAC,EAAE,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC;IAExB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,YAAY,GAAG,kBAAkB,CAoB1E;AAyCD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAKpE;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAqDhF;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,EAC1B,kBAAkB,GAAE,OAAc,EAClC,WAAW,CAAC,EAAE,WAAW,GACxB,gBAAgB,CA6GlB;AAgBD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsB9C;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,YAAY,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAY5F;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,MAAM,CAiBhF;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,MAAM,CAqB7E;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,MAAM,EAAE,CAE5F"}
+{"version":3,"file":"calver.d.ts","sourceRoot":"","sources":["../src/calver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EACV,MAAM,EACN,YAAY,EAEZ,WAAW,EAEX,gBAAgB,EACjB,MAAM,SAAS,CAAC;AA8BjB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,IAAI,YAAY,CAoBhF;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAE3B;;;;OAIG;IACH,KAAK,CAAC,EAAE,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC;IAE1B;;;;OAIG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAEnB;;;;OAIG;IACH,GAAG,CAAC,EAAE,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC;IAExB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,YAAY,GAAG,kBAAkB,CAoB1E;AAyCD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAKpE;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAqDhF;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,EAC1B,kBAAkB,GAAE,OAAc,EAClC,WAAW,CAAC,EAAE,WAAW,GACxB,gBAAgB,CAyGlB;AAgBD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsB9C;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,YAAY,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAY5F;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,MAAM,CAiBhF;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,MAAM,CAqB7E;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,MAAM,EAAE,CAE5F"}

package/dist/changelog.d.ts

@@ -19,6 +19,18 @@ export interface ChangelogValidationResult {
      */
     hasEntryForVersion: boolean;
 }
+/**
+ * Options for changelog structure enforcement.
+ *
+ * @public
+ * @since 0.7.0
+ */
+export interface ChangelogStructureOptions {
+    /** Validate section headers against an allowed list. */
+    enforceStructure?: boolean;
+    /** Allowed section names. Defaults to Keep a Changelog standard sections. */
+    sections?: string[];
+}
 /**
  * Validates a changelog file for release readiness.
  *
@@ -28,19 +40,26 @@ export interface ChangelogValidationResult {
  * The validator checks for a top-level changelog heading, an `[Unreleased]`
  * section, and optionally a dated entry for the requested version.
  *
+ * When `structure.enforceStructure` is `true`, section headers (`### Name`)
+ * are validated against the allowed list and empty sections produce warnings.
+ *
  * @param changelogPath - Path to the changelog file.
  * @param version - Version that must be present in the changelog.
  * @param strict - Whether to require compare links and dated release headings.
  * @param requireEntry - Whether the requested version must already have an entry.
+ * @param structure - Optional structure enforcement options.
  * @returns The result of validating the changelog file.
  * @example
  * ```ts
  * import { validateChangelog } from 'versionguard';
  *
- * const result = validateChangelog('CHANGELOG.md', '1.2.0', true, true);
+ * const result = validateChangelog('CHANGELOG.md', '1.2.0', true, true, {
+ *   enforceStructure: true,
+ *   sections: ['Added', 'Changed', 'Fixed'],
+ * });
  * ```
  */
-export declare function validateChangelog(changelogPath: string, version: string, strict?: boolean, requireEntry?: boolean): ChangelogValidationResult;
+export declare function validateChangelog(changelogPath: string, version: string, strict?: boolean, requireEntry?: boolean, structure?: ChangelogStructureOptions): ChangelogValidationResult;
 /**
  * Gets the most recent released version from a changelog.
  *

package/dist/changelog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../src/changelog.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IACf;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;;OAEG;IACH,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,OAAc,EACtB,YAAY,GAAE,OAAc,GAC3B,yBAAyB,CAgD3B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQrE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAA8C,GACnD,IAAI,CAmBN;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAMjE;AASD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,IAAI,GAAE,MAA8C,GACnD,OAAO,CAoET"}
+{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../src/changelog.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IACf;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;;OAEG;IACH,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAcD;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,OAAc,EACtB,YAAY,GAAE,OAAc,EAC5B,SAAS,CAAC,EAAE,yBAAyB,GACpC,yBAAyB,CAuD3B;AAiCD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQrE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAA8C,GACnD,IAAI,CAmBN;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAMjE;AASD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,IAAI,GAAE,MAA8C,GACnD,OAAO,CAoET"}

package/dist/chunks/{index-CwOyEn5L.js → index-DWiw8Nps.js}

@@ -6,6 +6,17 @@ import { parse as parse$2 } from "smol-toml";
 import * as yaml from "js-yaml";
 import { globSync } from "glob";
 import { fileURLToPath } from "node:url";
+function validateModifier(modifier, schemeRules) {
+  if (!modifier || !schemeRules?.allowedModifiers) return null;
+  const baseModifier = modifier.replace(/[\d.]+$/, "") || modifier;
+  if (!schemeRules.allowedModifiers.includes(baseModifier)) {
+    return {
+      message: `Modifier "${modifier}" is not allowed. Allowed: ${schemeRules.allowedModifiers.join(", ")}`,
+      severity: "error"
+    };
+  }
+  return null;
+}
 const VALID_TOKENS = /* @__PURE__ */ new Set([
   "YYYY",
   "YY",
@@ -200,13 +211,10 @@ function validate$2(version, calverFormat, preventFutureDates = true, schemeRule
       });
     }
   }
-  if (parsed.modifier && schemeRules?.allowedModifiers) {
-    const baseModifier = parsed.modifier.replace(/[\d.]+$/, "") || parsed.modifier;
-    if (!schemeRules.allowedModifiers.includes(baseModifier)) {
-      errors.push({
-        message: `Modifier "${parsed.modifier}" is not allowed. Allowed: ${schemeRules.allowedModifiers.join(", ")}`,
-        severity: "error"
-      });
+  if (parsed.modifier) {
+    const modifierError = validateModifier(parsed.modifier, schemeRules);
+    if (modifierError) {
+      errors.push(modifierError);
     }
   }
   if (schemeRules?.maxNumericSegments) {
@@ -315,7 +323,15 @@ const calver = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProper
   validate: validate$2
 }, Symbol.toStringTag, { value: "Module" }));
 const CHANGELOG_DATE_REGEX = /^\d{4}-\d{2}-\d{2}$/;
-function validateChangelog(changelogPath, version, strict = true, requireEntry = true) {
+const KEEP_A_CHANGELOG_SECTIONS = [
+  "Added",
+  "Changed",
+  "Deprecated",
+  "Removed",
+  "Fixed",
+  "Security"
+];
+function validateChangelog(changelogPath, version, strict = true, requireEntry = true, structure) {
   if (!fs.existsSync(changelogPath)) {
     return {
       valid: !requireEntry,
@@ -352,12 +368,36 @@ function validateChangelog(changelogPath, version, strict = true, requireEntry =
       }
     }
   }
+  if (structure?.enforceStructure) {
+    const allowed = structure.sections ?? KEEP_A_CHANGELOG_SECTIONS;
+    const sectionErrors = validateSections(content, allowed);
+    errors.push(...sectionErrors);
+  }
   return {
     valid: errors.length === 0,
     errors,
     hasEntryForVersion
   };
 }
+function validateSections(content, allowed) {
+  const errors = [];
+  const lines = content.split("\n");
+  for (let i = 0; i < lines.length; i++) {
+    const sectionMatch = lines[i].match(/^### (.+)/);
+    if (!sectionMatch) continue;
+    const sectionName = sectionMatch[1].trim();
+    if (!allowed.includes(sectionName)) {
+      errors.push(
+        `Invalid changelog section "### ${sectionName}" (line ${i + 1}). Allowed: ${allowed.join(", ")}`
+      );
+    }
+    const nextContentLine = lines.slice(i + 1).find((l) => l.trim().length > 0);
+    if (!nextContentLine || nextContentLine.startsWith("#")) {
+      errors.push(`Empty changelog section "### ${sectionName}" (line ${i + 1})`);
+    }
+  }
+  return errors;
+}
 function addVersionEntry(changelogPath, version, date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10)) {
   if (!fs.existsSync(changelogPath)) {
     throw new Error(`Changelog not found: ${changelogPath}`);
@@ -1336,17 +1376,42 @@ function getStructuralErrors(version) {
   });
   return errors;
 }
-function validate$1(version) {
-  const parsed = parse(version);
+function validate$1(version, semverConfig, schemeRules) {
+  let input = version;
+  if (input.startsWith("v") || input.startsWith("V")) {
+    if (semverConfig?.allowVPrefix) {
+      input = input.slice(1);
+    }
+  }
+  const parsed = parse(input);
   if (!parsed) {
     return {
       valid: false,
       errors: getStructuralErrors(version)
     };
   }
+  const errors = [];
+  if (semverConfig && !semverConfig.allowBuildMetadata && parsed.build.length > 0) {
+    errors.push({
+      message: `Build metadata is not allowed: "${parsed.build.join(".")}"`,
+      severity: "error"
+    });
+  }
+  if (semverConfig?.requirePrerelease && parsed.prerelease.length === 0) {
+    errors.push({
+      message: "A prerelease label is required (e.g., 1.2.3-alpha.1)",
+      severity: "error"
+    });
+  }
+  if (parsed.prerelease.length > 0) {
+    const modifierError = validateModifier(parsed.prerelease[0], schemeRules);
+    if (modifierError) {
+      errors.push(modifierError);
+    }
+  }
   return {
-    valid: true,
-    errors: [],
+    valid: errors.filter((e) => e.severity === "error").length === 0,
+    errors,
     version: { type: "semver", version: parsed }
   };
 }
@@ -1527,6 +1592,14 @@ function checkHardcodedVersions(expectedVersion, config, ignorePatterns, cwd = p
   }
   return mismatches;
 }
+const DEFAULT_SEMVER_CONFIG = {
+  allowVPrefix: false,
+  allowBuildMetadata: true,
+  requirePrerelease: false
+};
+function getSemVerConfig(config) {
+  return { ...DEFAULT_SEMVER_CONFIG, ...config.versioning.semver };
+}
 function getCalVerConfig(config) {
   if (!config.versioning.calver) {
     throw new Error('CalVer configuration is required when versioning.type is "calver"');
@@ -1703,6 +1776,11 @@ const DEFAULT_CONFIG = {
       maxNumericSegments: 3,
       allowedModifiers: ["dev", "alpha", "beta", "rc"]
     },
+    semver: {
+      allowVPrefix: false,
+      allowBuildMetadata: true,
+      requirePrerelease: false
+    },
     calver: {
       format: "YYYY.MM.PATCH",
       preventFutureDates: true,
@@ -1729,7 +1807,9 @@ const DEFAULT_CONFIG = {
     enabled: true,
     file: "CHANGELOG.md",
     strict: true,
-    requireEntry: true
+    requireEntry: true,
+    enforceStructure: false,
+    sections: ["Added", "Changed", "Deprecated", "Removed", "Fixed", "Security"]
   },
   git: {
     hooks: {
@@ -1782,8 +1862,16 @@ function initConfig(cwd = process.cwd()) {
 }
 function generateDefaultConfig() {
   return `# VersionGuard Configuration
+# Change "type" to switch between semver and calver — both blocks are always present.
 versioning:
   type: semver
+  semver:
+    allowVPrefix: false
+    allowBuildMetadata: true
+    requirePrerelease: false
+  calver:
+    format: "YYYY.MM.PATCH"
+    preventFutureDates: true
 
 sync:
   files:
@@ -2615,7 +2703,7 @@ function getTagPreflightError(config, cwd, expectedVersion, allowAutoFix = false
     return "Working tree must be clean before creating or validating release tags";
   }
   const version = expectedVersion ?? getPackageVersion(cwd, config.manifest);
-  const versionResult = config.versioning.type === "semver" ? validate$1(version) : validate$2(
+  const versionResult = config.versioning.type === "semver" ? validate$1(version, getSemVerConfig(config), config.versioning.schemeRules) : validate$2(
     version,
     config.versioning.calver?.format ?? "YYYY.MM.PATCH",
     config.versioning.calver?.preventFutureDates ?? true,
@@ -2636,7 +2724,11 @@ function getTagPreflightError(config, cwd, expectedVersion, allowAutoFix = false
     path.join(cwd, config.changelog.file),
     version,
     config.changelog.strict,
-    config.changelog.requireEntry
+    config.changelog.requireEntry,
+    {
+      enforceStructure: config.changelog.enforceStructure,
+      sections: config.changelog.sections
+    }
   );
   if (!changelogResult.valid) {
     return changelogResult.errors[0] ?? "Changelog validation failed";
@@ -2700,7 +2792,7 @@ function suggestTagMessage(version, cwd = process.cwd()) {
 }
 function validateVersion(version, config) {
   if (config.versioning.type === "semver") {
-    return validate$1(version);
+    return validate$1(version, getSemVerConfig(config), config.versioning.schemeRules);
   }
   const calverConfig = getCalVerConfig(config);
   return validate$2(
@@ -2744,7 +2836,11 @@ function validate(config, cwd = process.cwd()) {
       changelogPath,
       version,
       config.changelog.strict,
-      config.changelog.requireEntry
+      config.changelog.requireEntry,
+      {
+        enforceStructure: config.changelog.enforceStructure,
+        sections: config.changelog.sections
+      }
     );
     if (!changelogResult.valid) {
       changelogValid = false;
@@ -2828,6 +2924,7 @@ function isWorktreeClean(cwd) {
   }
 }
 export {
+  validateVersion as $,
   checkHardcodedVersions as A,
   checkHookIntegrity as B,
   checkHooksPathOverride as C,
@@ -2840,21 +2937,21 @@ export {
   JsonVersionSource as J,
   getCalVerConfig as K,
   getLatestTag as L,
-  getTagFeedback as M,
-  getVersionSource as N,
-  initConfig as O,
-  resolveVersionSource as P,
-  semver as Q,
+  getSemVerConfig as M,
+  getTagFeedback as N,
+  getVersionSource as O,
+  initConfig as P,
+  resolveVersionSource as Q,
   RegexVersionSource as R,
-  suggestTagMessage as S,
+  semver as S,
   TomlVersionSource as T,
-  sync as U,
+  suggestTagMessage as U,
   VersionFileSource as V,
-  syncVersion as W,
-  validateChangelog as X,
+  sync as W,
+  syncVersion as X,
   YamlVersionSource as Y,
-  validateTagForPush as Z,
-  validateVersion as _,
+  validateChangelog as Z,
+  validateTagForPush as _,
   installHooks as a,
   getPackageVersion as b,
   createCkmEngine as c,
@@ -2882,4 +2979,4 @@ export {
   canBump as y,
   checkEnforceHooksPolicy as z
 };
-//# sourceMappingURL=index-CwOyEn5L.js.map
+//# sourceMappingURL=index-DWiw8Nps.js.map