@fuzdev/fuz_gitops 0.72.0 → 0.73.0

package/dist/npm_install_helpers.d.ts

@@ -1,23 +0,0 @@
-import type { Logger } from '@fuzdev/fuz_util/log.js';
-import type { LocalRepo } from './local_repo.js';
-import type { GitopsOperations } from './operations.js';
-/**
- * Installs npm dependencies with cache healing on ETARGET errors.
- *
- * **Strategy:**
- * 1. First attempt: regular `npm install`
- * 2. On ETARGET error (stale cache): `npm cache clean --force` then retry
- * 3. On other errors: fail immediately
- *
- * **Why ETARGET errors occur:**
- * After publishing a package and waiting for NPM registry propagation,
- * npm's local cache may still have stale "404" metadata. This healing
- * strategy clears the cache to force fresh metadata fetch.
- *
- * @param repo - the repository to install dependencies for
- * @param ops - gitops operations (for dependency injection)
- * @param log - optional logger
- * @throws Error if install fails (with details about cache healing attempts)
- */
-export declare const install_with_cache_healing: (repo: LocalRepo, ops: GitopsOperations, log?: Logger) => Promise<void>;
-//# sourceMappingURL=npm_install_helpers.d.ts.map

package/dist/npm_install_helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"npm_install_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/npm_install_helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAGpD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,iBAAiB,CAAC;AAmBtD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,0BAA0B,GACtC,MAAM,SAAS,EACf,KAAK,gBAAgB,EACrB,MAAM,MAAM,KACV,OAAO,CAAC,IAAI,CAuCd,CAAC"}

package/dist/npm_install_helpers.js

@@ -1,60 +0,0 @@
-import { styleText as st } from 'node:util';
-/**
- * Checks if an npm install error is caused by stale cache (ETARGET).
- * Detects various error message formats:
- * - "code ETARGET"
- * - "ETARGET"
- * - "notarget"
- * - "No matching version found"
- */
-const is_etarget_error = (message, stderr) => {
-    const combined = `${message} ${stderr}`.toLowerCase();
-    return (combined.includes('etarget') ||
-        combined.includes('notarget') ||
-        combined.includes('no matching version found'));
-};
-/**
- * Installs npm dependencies with cache healing on ETARGET errors.
- *
- * **Strategy:**
- * 1. First attempt: regular `npm install`
- * 2. On ETARGET error (stale cache): `npm cache clean --force` then retry
- * 3. On other errors: fail immediately
- *
- * **Why ETARGET errors occur:**
- * After publishing a package and waiting for NPM registry propagation,
- * npm's local cache may still have stale "404" metadata. This healing
- * strategy clears the cache to force fresh metadata fetch.
- *
- * @param repo - the repository to install dependencies for
- * @param ops - gitops operations (for dependency injection)
- * @param log - optional logger
- * @throws Error if install fails (with details about cache healing attempts)
- */
-export const install_with_cache_healing = async (repo, ops, log) => {
-    // First attempt
-    const install_result = await ops.npm.install({ cwd: repo.repo_dir });
-    if (install_result.ok) {
-        return; // Success
-    }
-    // Check if error is ETARGET (package not found due to stale cache)
-    const stderr = install_result.stderr || '';
-    const message = install_result.message || '';
-    if (!is_etarget_error(message, stderr)) {
-        // Different error - fail immediately without cache healing
-        throw new Error(`Failed to install dependencies in ${repo.library.name}: ${install_result.message}${stderr ? `\n${stderr}` : ''}`);
-    }
-    // ETARGET error - try cache healing
-    log?.warn(st('yellow', `  ⚠️  ETARGET error detected - cleaning npm cache...`));
-    const cache_result = await ops.npm.cache_clean();
-    if (!cache_result.ok) {
-        throw new Error(`Failed to clean npm cache: ${cache_result.message}`);
-    }
-    log?.info('  ✓ Cache cleaned, retrying install...');
-    // Retry install after cache clean
-    const retry_result = await ops.npm.install({ cwd: repo.repo_dir });
-    if (!retry_result.ok) {
-        throw new Error(`Failed to install dependencies after cache clean in ${repo.library.name}: ${retry_result.message}${retry_result.stderr ? `\n${retry_result.stderr}` : ''}`);
-    }
-    log?.info(st('green', `  ✓ Dependencies installed successfully after cache heal`));
-};

package/dist/semver.d.ts

@@ -1,26 +0,0 @@
-/**
- * Semantic Versioning 2.0.0 utilities
- * @see https://semver.org/
- *
- * @module
- */
-export type BumpType = 'major' | 'minor' | 'patch';
-export interface Semver {
-    major: number;
-    minor: number;
-    patch: number;
-    prerelease?: string;
-    build?: string;
-}
-/**
- * Compares two semver versions according to SemVer 2.0.0 spec.
- * Returns -1 if a < b, 0 if a === b, 1 if a > b.
- * Build metadata is ignored in precedence comparison.
- */
-export declare const semver_compare_versions: (a: string, b: string) => number;
-/**
- * Bumps a version according to the specified type.
- * Resets lower version numbers per SemVer spec.
- */
-export declare const semver_bump_version: (version: string, type: BumpType) => string;
-//# sourceMappingURL=semver.d.ts.map

package/dist/semver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"semver.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/semver.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEnD,MAAM,WAAW,MAAM;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAiGD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,MAqB9D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,EAAE,MAAM,QAAQ,KAAG,MAuBrE,CAAC"}

package/dist/semver.js

@@ -1,137 +0,0 @@
-// TODO: candidate for extraction to `@fuzdev/fuz_util`
-/**
- * SemVer 2.0.0 validation regex.
- * @see https://semver.org/#is-there-a-suggested-regular-expression-regex-to-check-a-semver-string
- */
-const SEMVER_REGEX = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
-/**
- * Parses a semver version string.
- * Accepts optional 'v' prefix for convenience.
- */
-const semver_parse = (version) => {
-    // Remove leading 'v' if present (common in git tags)
-    const clean = version.replace(/^v/, '');
-    // Validate the cleaned version
-    if (!SEMVER_REGEX.test(clean)) {
-        throw new Error(`Invalid semver: ${version}`);
-    }
-    const match = SEMVER_REGEX.exec(clean);
-    return {
-        major: parseInt(match[1], 10),
-        minor: parseInt(match[2], 10),
-        patch: parseInt(match[3], 10),
-        prerelease: match[4],
-        build: match[5],
-    };
-};
-const semver_to_string = (semver) => {
-    let version = `${semver.major}.${semver.minor}.${semver.patch}`;
-    if (semver.prerelease) {
-        version += `-${semver.prerelease}`;
-    }
-    if (semver.build) {
-        version += `+${semver.build}`;
-    }
-    return version;
-};
-/**
- * Compares two prerelease versions according to SemVer 2.0.0 spec.
- * Returns -1 if a < b, 0 if a === b, 1 if a > b.
- */
-const semver_compare_prerelease = (a, b) => {
-    // Handle missing prereleases
-    if (!a && !b)
-        return 0;
-    if (!a)
-        return 1; // normal version > prerelease
-    if (!b)
-        return -1; // prerelease < normal version
-    // Split into identifiers
-    const a_parts = a.split('.');
-    const b_parts = b.split('.');
-    // Compare each identifier
-    const min_length = Math.min(a_parts.length, b_parts.length);
-    for (let i = 0; i < min_length; i++) {
-        const a_part = a_parts[i];
-        const b_part = b_parts[i];
-        // Check if numeric
-        const a_is_numeric = /^\d+$/.test(a_part);
-        const b_is_numeric = /^\d+$/.test(b_part);
-        if (a_is_numeric && b_is_numeric) {
-            // Both numeric - compare numerically
-            const a_num = parseInt(a_part, 10);
-            const b_num = parseInt(b_part, 10);
-            if (a_num !== b_num) {
-                return a_num < b_num ? -1 : 1;
-            }
-        }
-        else if (a_is_numeric && !b_is_numeric) {
-            // Numeric identifiers always have lower precedence
-            return -1;
-        }
-        else if (!a_is_numeric && b_is_numeric) {
-            // Numeric identifiers always have lower precedence
-            return 1;
-        }
-        else {
-            // Both alphanumeric - compare lexically
-            const cmp = a_part.localeCompare(b_part);
-            if (cmp !== 0) {
-                return cmp < 0 ? -1 : 1;
-            }
-        }
-    }
-    // All identifiers equal - larger set has higher precedence
-    if (a_parts.length !== b_parts.length) {
-        return a_parts.length < b_parts.length ? -1 : 1;
-    }
-    return 0;
-};
-/**
- * Compares two semver versions according to SemVer 2.0.0 spec.
- * Returns -1 if a < b, 0 if a === b, 1 if a > b.
- * Build metadata is ignored in precedence comparison.
- */
-export const semver_compare_versions = (a, b) => {
-    const v1 = semver_parse(a);
-    const v2 = semver_parse(b);
-    // Compare major
-    if (v1.major !== v2.major) {
-        return v1.major < v2.major ? -1 : 1;
-    }
-    // Compare minor
-    if (v1.minor !== v2.minor) {
-        return v1.minor < v2.minor ? -1 : 1;
-    }
-    // Compare patch
-    if (v1.patch !== v2.patch) {
-        return v1.patch < v2.patch ? -1 : 1;
-    }
-    // Compare prerelease (build metadata is ignored)
-    return semver_compare_prerelease(v1.prerelease, v2.prerelease);
-};
-/**
- * Bumps a version according to the specified type.
- * Resets lower version numbers per SemVer spec.
- */
-export const semver_bump_version = (version, type) => {
-    const semver = semver_parse(version);
-    switch (type) {
-        case 'major':
-            semver.major++;
-            semver.minor = 0;
-            semver.patch = 0;
-            break;
-        case 'minor':
-            semver.minor++;
-            semver.patch = 0;
-            break;
-        case 'patch':
-            semver.patch++;
-            break;
-    }
-    // Remove prerelease and build when bumping
-    semver.prerelease = undefined;
-    semver.build = undefined;
-    return semver_to_string(semver);
-};

package/dist/serialization_types.d.ts

@@ -1,59 +0,0 @@
-/**
- * JSON-serializable types for command output formats.
- *
- * Gitops commands support `--format json` and `--format markdown` output modes
- * in addition to styled terminal output. These types define the JSON schema for:
- * - Dependency graph structures (`SerializedGraph`)
- * - Publishing plan predictions (`SerializedPublishingPlan`)
- *
- * Used by `gitops_analyze`, `gitops_plan`, and `gitops_publish` (dry run) when
- * `--format json` or `--outfile` is specified.
- *
- * @module
- */
-import type { DependencyGraph } from './dependency_graph.js';
-export interface SerializedNode {
-    name: string;
-    version: string;
-    dependencies: Array<{
-        name: string;
-        type: string;
-        version: string;
-    }>;
-    dependents: Array<string>;
-    publishable: boolean;
-}
-export interface SerializedGraph {
-    nodes: Array<SerializedNode>;
-    edges: Array<[string, string]>;
-}
-export interface SerializedPublishingPlan {
-    publishing_order: Array<string>;
-    version_changes: Array<{
-        package_name: string;
-        from: string;
-        to: string;
-        bump_type: string;
-        breaking: boolean;
-        has_changesets: boolean;
-        will_generate_changeset?: boolean;
-        needs_bump_escalation?: boolean;
-        existing_bump?: string;
-        required_bump?: string;
-    }>;
-    dependency_updates: Array<{
-        dependent_package: string;
-        updated_dependency: string;
-        new_version: string;
-        type: string;
-        causes_republish: boolean;
-    }>;
-    breaking_cascades: Record<string, Array<string>>;
-    warnings: Array<string>;
-    errors: Array<string>;
-}
-/**
- * Serializes a dependency graph to a JSON-safe format.
- */
-export declare const serialize_graph: (graph: DependencyGraph) => SerializedGraph;
-//# sourceMappingURL=serialization_types.d.ts.map

package/dist/serialization_types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"serialization_types.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/serialization_types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAC7B,KAAK,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACxC,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,eAAe,EAAE,KAAK,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,OAAO,CAAC;QAClB,cAAc,EAAE,OAAO,CAAC;QACxB,uBAAuB,CAAC,EAAE,OAAO,CAAC;QAClC,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;IACH,kBAAkB,EAAE,KAAK,CAAC;QACzB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,gBAAgB,EAAE,OAAO,CAAC;KAC1B,CAAC,CAAC;IACH,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACjD,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,eAAe,KAAG,eA6BxD,CAAC"}

package/dist/serialization_types.js

@@ -1,42 +0,0 @@
-/**
- * JSON-serializable types for command output formats.
- *
- * Gitops commands support `--format json` and `--format markdown` output modes
- * in addition to styled terminal output. These types define the JSON schema for:
- * - Dependency graph structures (`SerializedGraph`)
- * - Publishing plan predictions (`SerializedPublishingPlan`)
- *
- * Used by `gitops_analyze`, `gitops_plan`, and `gitops_publish` (dry run) when
- * `--format json` or `--outfile` is specified.
- *
- * @module
- */
-/**
- * Serializes a dependency graph to a JSON-safe format.
- */
-export const serialize_graph = (graph) => {
-    const nodes = [];
-    const edges = [];
-    // Serialize nodes
-    for (const node of graph.nodes.values()) {
-        const dependencies = Array.from(node.dependencies, ([dep_name, spec]) => ({
-            name: dep_name,
-            type: spec.type,
-            version: spec.version,
-        }));
-        nodes.push({
-            name: node.name,
-            version: node.version,
-            dependencies,
-            dependents: Array.from(node.dependents),
-            publishable: node.publishable,
-        });
-    }
-    // Serialize edges
-    for (const [from, tos] of graph.edges) {
-        for (const to of tos) {
-            edges.push([from, to]);
-        }
-    }
-    return { nodes, edges };
-};

package/src/lib/npm_install_helpers.ts

@@ -1,85 +0,0 @@
-import type {Logger} from '@fuzdev/fuz_util/log.js';
-import {styleText as st} from 'node:util';
-
-import type {LocalRepo} from './local_repo.js';
-import type {GitopsOperations} from './operations.js';
-
-/**
- * Checks if an npm install error is caused by stale cache (ETARGET).
- * Detects various error message formats:
- * - "code ETARGET"
- * - "ETARGET"
- * - "notarget"
- * - "No matching version found"
- */
-const is_etarget_error = (message: string, stderr: string): boolean => {
-	const combined = `${message} ${stderr}`.toLowerCase();
-	return (
-		combined.includes('etarget') ||
-		combined.includes('notarget') ||
-		combined.includes('no matching version found')
-	);
-};
-
-/**
- * Installs npm dependencies with cache healing on ETARGET errors.
- *
- * **Strategy:**
- * 1. First attempt: regular `npm install`
- * 2. On ETARGET error (stale cache): `npm cache clean --force` then retry
- * 3. On other errors: fail immediately
- *
- * **Why ETARGET errors occur:**
- * After publishing a package and waiting for NPM registry propagation,
- * npm's local cache may still have stale "404" metadata. This healing
- * strategy clears the cache to force fresh metadata fetch.
- *
- * @param repo - the repository to install dependencies for
- * @param ops - gitops operations (for dependency injection)
- * @param log - optional logger
- * @throws Error if install fails (with details about cache healing attempts)
- */
-export const install_with_cache_healing = async (
-	repo: LocalRepo,
-	ops: GitopsOperations,
-	log?: Logger,
-): Promise<void> => {
-	// First attempt
-	const install_result = await ops.npm.install({cwd: repo.repo_dir});
-
-	if (install_result.ok) {
-		return; // Success
-	}
-
-	// Check if error is ETARGET (package not found due to stale cache)
-	const stderr = install_result.stderr || '';
-	const message = install_result.message || '';
-
-	if (!is_etarget_error(message, stderr)) {
-		// Different error - fail immediately without cache healing
-		throw new Error(
-			`Failed to install dependencies in ${repo.library.name}: ${install_result.message}${stderr ? `\n${stderr}` : ''}`,
-		);
-	}
-
-	// ETARGET error - try cache healing
-	log?.warn(st('yellow', `  ⚠️  ETARGET error detected - cleaning npm cache...`));
-
-	const cache_result = await ops.npm.cache_clean();
-	if (!cache_result.ok) {
-		throw new Error(`Failed to clean npm cache: ${cache_result.message}`);
-	}
-
-	log?.info('  ✓ Cache cleaned, retrying install...');
-
-	// Retry install after cache clean
-	const retry_result = await ops.npm.install({cwd: repo.repo_dir});
-
-	if (!retry_result.ok) {
-		throw new Error(
-			`Failed to install dependencies after cache clean in ${repo.library.name}: ${retry_result.message}${retry_result.stderr ? `\n${retry_result.stderr}` : ''}`,
-		);
-	}
-
-	log?.info(st('green', `  ✓ Dependencies installed successfully after cache heal`));
-};

package/src/lib/semver.ts

@@ -1,170 +0,0 @@
-// TODO: candidate for extraction to `@fuzdev/fuz_util`
-
-/**
- * Semantic Versioning 2.0.0 utilities
- * @see https://semver.org/
- *
- * @module
- */
-
-export type BumpType = 'major' | 'minor' | 'patch';
-
-export interface Semver {
-	major: number;
-	minor: number;
-	patch: number;
-	prerelease?: string;
-	build?: string;
-}
-
-/**
- * SemVer 2.0.0 validation regex.
- * @see https://semver.org/#is-there-a-suggested-regular-expression-regex-to-check-a-semver-string
- */
-const SEMVER_REGEX =
-	/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
-
-/**
- * Parses a semver version string.
- * Accepts optional 'v' prefix for convenience.
- */
-const semver_parse = (version: string): Semver => {
-	// Remove leading 'v' if present (common in git tags)
-	const clean = version.replace(/^v/, '');
-
-	// Validate the cleaned version
-	if (!SEMVER_REGEX.test(clean)) {
-		throw new Error(`Invalid semver: ${version}`);
-	}
-
-	const match = SEMVER_REGEX.exec(clean)!;
-	return {
-		major: parseInt(match[1]!, 10),
-		minor: parseInt(match[2]!, 10),
-		patch: parseInt(match[3]!, 10),
-		prerelease: match[4],
-		build: match[5],
-	};
-};
-
-const semver_to_string = (semver: Semver): string => {
-	let version = `${semver.major}.${semver.minor}.${semver.patch}`;
-	if (semver.prerelease) {
-		version += `-${semver.prerelease}`;
-	}
-	if (semver.build) {
-		version += `+${semver.build}`;
-	}
-	return version;
-};
-
-/**
- * Compares two prerelease versions according to SemVer 2.0.0 spec.
- * Returns -1 if a < b, 0 if a === b, 1 if a > b.
- */
-const semver_compare_prerelease = (a: string | undefined, b: string | undefined): number => {
-	// Handle missing prereleases
-	if (!a && !b) return 0;
-	if (!a) return 1; // normal version > prerelease
-	if (!b) return -1; // prerelease < normal version
-
-	// Split into identifiers
-	const a_parts = a.split('.');
-	const b_parts = b.split('.');
-
-	// Compare each identifier
-	const min_length = Math.min(a_parts.length, b_parts.length);
-	for (let i = 0; i < min_length; i++) {
-		const a_part = a_parts[i]!;
-		const b_part = b_parts[i]!;
-
-		// Check if numeric
-		const a_is_numeric = /^\d+$/.test(a_part);
-		const b_is_numeric = /^\d+$/.test(b_part);
-
-		if (a_is_numeric && b_is_numeric) {
-			// Both numeric - compare numerically
-			const a_num = parseInt(a_part, 10);
-			const b_num = parseInt(b_part, 10);
-			if (a_num !== b_num) {
-				return a_num < b_num ? -1 : 1;
-			}
-		} else if (a_is_numeric && !b_is_numeric) {
-			// Numeric identifiers always have lower precedence
-			return -1;
-		} else if (!a_is_numeric && b_is_numeric) {
-			// Numeric identifiers always have lower precedence
-			return 1;
-		} else {
-			// Both alphanumeric - compare lexically
-			const cmp = a_part.localeCompare(b_part);
-			if (cmp !== 0) {
-				return cmp < 0 ? -1 : 1;
-			}
-		}
-	}
-
-	// All identifiers equal - larger set has higher precedence
-	if (a_parts.length !== b_parts.length) {
-		return a_parts.length < b_parts.length ? -1 : 1;
-	}
-
-	return 0;
-};
-
-/**
- * Compares two semver versions according to SemVer 2.0.0 spec.
- * Returns -1 if a < b, 0 if a === b, 1 if a > b.
- * Build metadata is ignored in precedence comparison.
- */
-export const semver_compare_versions = (a: string, b: string): number => {
-	const v1 = semver_parse(a);
-	const v2 = semver_parse(b);
-
-	// Compare major
-	if (v1.major !== v2.major) {
-		return v1.major < v2.major ? -1 : 1;
-	}
-
-	// Compare minor
-	if (v1.minor !== v2.minor) {
-		return v1.minor < v2.minor ? -1 : 1;
-	}
-
-	// Compare patch
-	if (v1.patch !== v2.patch) {
-		return v1.patch < v2.patch ? -1 : 1;
-	}
-
-	// Compare prerelease (build metadata is ignored)
-	return semver_compare_prerelease(v1.prerelease, v2.prerelease);
-};
-
-/**
- * Bumps a version according to the specified type.
- * Resets lower version numbers per SemVer spec.
- */
-export const semver_bump_version = (version: string, type: BumpType): string => {
-	const semver = semver_parse(version);
-
-	switch (type) {
-		case 'major':
-			semver.major++;
-			semver.minor = 0;
-			semver.patch = 0;
-			break;
-		case 'minor':
-			semver.minor++;
-			semver.patch = 0;
-			break;
-		case 'patch':
-			semver.patch++;
-			break;
-	}
-
-	// Remove prerelease and build when bumping
-	semver.prerelease = undefined;
-	semver.build = undefined;
-
-	return semver_to_string(semver);
-};