@fuzdev/fuz_gitops 0.71.0 → 0.73.0

package/src/lib/publishing_plan_helpers.ts

@@ -7,8 +7,7 @@
  */
 
 import type {LocalRepo} from './local_repo.js';
-import type {BumpType} from './semver.js';
-import {needs_update} from './version_utils.js';
+import {needs_update, required_bump_for_dependency_update, type BumpType} from './version_utils.js';
 import type {DependencyUpdate} from './publishing_plan.js';
 
 /**
@@ -42,7 +41,6 @@ export const calculate_dependency_updates = (
 						current_version,
 						new_version,
 						type: 'dependencies',
-						causes_republish: true,
 					});
 
 					if (breaking_packages.has(dep_name)) {
@@ -67,7 +65,6 @@ export const calculate_dependency_updates = (
 						current_version,
 						new_version,
 						type: 'peerDependencies',
-						causes_republish: true,
 					});
 
 					if (breaking_packages.has(dep_name)) {
@@ -92,7 +89,6 @@ export const calculate_dependency_updates = (
 						current_version,
 						new_version,
 						type: 'devDependencies',
-						causes_republish: false,
 					});
 				}
 			}
@@ -131,17 +127,8 @@ export const get_required_bump_for_dependencies = (
 		breaking_packages.has(update.updated_dependency),
 	);
 
-	const current_version = repo.library.package_json.version || '0.0.0';
-	const [major] = current_version.split('.').map(Number);
-	const is_pre_1_0 = major === 0;
-
-	if (has_breaking_deps) {
-		// Breaking changes propagate
-		// Pre-1.0: use minor for breaking changes
-		// 1.0+: use major for breaking changes
-		return is_pre_1_0 ? 'minor' : 'major';
-	}
-
-	// For non-breaking dependency updates, use patch
-	return 'patch';
+	return required_bump_for_dependency_update(
+		repo.library.package_json.version || '0.0.0',
+		has_breaking_deps,
+	);
 };

package/src/lib/publishing_plan_logging.ts

@@ -182,54 +182,34 @@ export const log_publishing_plan = (
 		const with_escalation = ordered_changes.filter((vc) => vc.needs_bump_escalation);
 		const with_auto_changesets = ordered_changes.filter((vc) => vc.will_generate_changeset);
 
-		// Log each group with diff-style output
-		if (with_changesets.length > 0) {
-			log.info(st('cyan', 'Version Changes (from changesets):'));
-			for (const change of with_changesets) {
-				const idx = ordered_changes.indexOf(change);
+		// A single running counter across all groups so positions read 1..N with no
+		// gaps. (Numbering per-group index would make the first group skip the numbers
+		// that land in a later group, e.g. jump from `[9/12]` to `[11/12]`.)
+		const total = with_changesets.length + with_escalation.length + with_auto_changesets.length;
+		let position = 0;
+		const log_change_group = (
+			title: string,
+			color: 'cyan' | 'yellow',
+			changes: Array<VersionChange>,
+		): void => {
+			if (changes.length === 0) return;
+			log.info(st(color, title));
+			for (const change of changes) {
 				log_version_change_with_diffs(
 					change,
-					idx,
-					ordered_changes.length,
+					position++,
+					total,
 					dependency_updates,
 					breaking_cascades,
 					log,
 				);
 			}
 			log.info('');
-		}
-
-		if (with_escalation.length > 0) {
-			log.info(st('yellow', 'Version Changes (bump escalation):'));
-			for (const change of with_escalation) {
-				const idx = ordered_changes.indexOf(change);
-				log_version_change_with_diffs(
-					change,
-					idx,
-					ordered_changes.length,
-					dependency_updates,
-					breaking_cascades,
-					log,
-				);
-			}
-			log.info('');
-		}
+		};
 
-		if (with_auto_changesets.length > 0) {
-			log.info(st('cyan', 'Version Changes (auto-generated):'));
-			for (const change of with_auto_changesets) {
-				const idx = ordered_changes.indexOf(change);
-				log_version_change_with_diffs(
-					change,
-					idx,
-					ordered_changes.length,
-					dependency_updates,
-					breaking_cascades,
-					log,
-				);
-			}
-			log.info('');
-		}
+		log_change_group('Version Changes (from changesets):', 'cyan', with_changesets);
+		log_change_group('Version Changes (bump escalation):', 'yellow', with_escalation);
+		log_change_group('Version Changes (auto-generated):', 'cyan', with_auto_changesets);
 	} else {
 		log.info(st('dim', 'No packages to publish'));
 		log.info('');

package/src/lib/repo_ops.ts

@@ -83,7 +83,7 @@ export interface RepoPath {
  * Get repo paths from gitops config without full git sync.
  * Lighter weight than `get_gitops_ready()` - just resolves paths.
  *
- * @param config_path - path to `gitops.config.ts` (defaults to `./gitops.config.ts`)
+ * @param config_path - path to the gitops config file (defaults to `gitops.config.ts`)
  * @returns array of repo info with name, path, and url
  */
 export const get_repo_paths = async (config_path?: string): Promise<Array<RepoPath>> => {

package/src/lib/version_utils.ts

@@ -1,6 +1,7 @@
 // TODO: candidate for extraction to `@fuzdev/fuz_util`
 
-import type {BumpType} from './semver.js';
+/** A semver bump kind: `major`, `minor`, or `patch`. */
+export type BumpType = 'major' | 'minor' | 'patch';
 
 export const is_wildcard = (version: string): boolean => {
 	return version === '*';
@@ -100,10 +101,7 @@ export const get_update_prefix = (
  * Pre-1.0: minor bumps are breaking
  * 1.0+: major bumps are breaking
  */
-export const is_breaking_change = (
-	old_version: string,
-	bump_type: 'major' | 'minor' | 'patch',
-): boolean => {
+export const is_breaking_change = (old_version: string, bump_type: BumpType): boolean => {
 	const [major] = old_version.split('.').map(Number);
 	const is_pre_1_0 = major === 0;
 
@@ -116,10 +114,33 @@ export const is_breaking_change = (
 	}
 };
 
-export const detect_bump_type = (
-	old_version: string,
-	new_version: string,
-): 'major' | 'minor' | 'patch' => {
+/**
+ * The bump a package must take when one of its prod/peer dependencies updates.
+ * Pre-1.0: `minor` for a breaking dependency, otherwise `patch`.
+ * 1.0+: `major` for a breaking dependency, otherwise `patch`.
+ *
+ * Single source of truth for the dependency-driven bump rule, shared by the plan
+ * (`get_required_bump_for_dependencies`) and the auto-changeset generator
+ * (`calculate_required_bump`) so the two never drift.
+ *
+ * @param current_version - the package's current version, used to detect the pre-1.0 regime
+ * @param has_breaking_deps - whether any updated dependency is a breaking change
+ */
+export const required_bump_for_dependency_update = (
+	current_version: string,
+	has_breaking_deps: boolean,
+): BumpType => {
+	const [major] = current_version.split('.').map(Number);
+	const is_pre_1_0 = major === 0;
+	if (has_breaking_deps) {
+		// Breaking changes propagate: pre-1.0 uses minor, 1.0+ uses major
+		return is_pre_1_0 ? 'minor' : 'major';
+	}
+	// Non-breaking dependency updates only need a patch
+	return 'patch';
+};
+
+export const detect_bump_type = (old_version: string, new_version: string): BumpType => {
 	const old_parts = old_version.split('.').map(Number);
 	const new_parts = new_version.split('.').map(Number);
 

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`));
-};