@fuzdev/fuz_gitops 0.72.0 → 0.74.0

package/src/lib/repo.svelte.ts

@@ -1,17 +1,22 @@
 import {create_context} from '@fuzdev/fuz_ui/context_helpers.js';
 import type {LibraryJson, SourceJson} from '@fuzdev/fuz_util/library_json.js';
+import type {PkgJson} from '@fuzdev/fuz_util/pkg_json.js';
 import type {PackageJson} from '@fuzdev/fuz_util/package_json.js';
 import type {Url} from '@fuzdev/fuz_util/url.js';
 import {Library} from '@fuzdev/fuz_ui/library.svelte.js';
-import type {Module} from '@fuzdev/fuz_ui/module.svelte.js';
 
 import {GithubCheckRunsItem, type GithubPullRequest} from './github.js';
 
 /**
  * Serialized repo data as stored in `repos.ts` (JSON).
+ *
+ * `package_json` is the repo's full `package.json`, carried alongside
+ * `library_json` because gitops reads `dependencies`/`devDependencies` for the
+ * publishing cascade — fields the curated `LibraryJson.pkg_json` omits.
  */
 export interface RepoJson {
 	library_json: LibraryJson;
+	package_json: PackageJson;
 	check_runs: GithubCheckRunsItem | null;
 	pull_requests: Array<GithubPullRequest> | null;
 }
@@ -24,6 +29,8 @@ export interface RepoJson {
  */
 export class Repo {
 	readonly library: Library;
+	/** The repo's full `package.json` (with `dependencies`/`devDependencies`). */
+	readonly package_json: PackageJson;
 	check_runs: GithubCheckRunsItem | null;
 	pull_requests: Array<GithubPullRequest> | null;
 
@@ -37,9 +44,6 @@ export class Repo {
 	get repo_url(): Url {
 		return this.library.repo_url;
 	}
-	get owner_name(): string | null {
-		return this.library.owner_name;
-	}
 	get homepage_url(): Url | null {
 		return this.library.homepage_url;
 	}
@@ -49,30 +53,23 @@ export class Repo {
 	get logo_alt(): string {
 		return this.library.logo_alt;
 	}
-	get published(): boolean {
-		return this.library.published;
-	}
 	get npm_url(): Url | null {
 		return this.library.npm_url;
 	}
 	get changelog_url(): Url | null {
 		return this.library.changelog_url;
 	}
-	get package_json(): PackageJson {
-		return this.library.package_json;
+	/** Curated package identity, delegating to `library`. Distinct from the full `package_json`. */
+	get pkg_json(): PkgJson {
+		return this.library.pkg_json;
 	}
 	get source_json(): SourceJson {
 		return this.library.source_json;
 	}
-	get modules(): Array<Module> {
-		return this.library.modules;
-	}
-	get org_url(): string | null {
-		return this.library.org_url;
-	}
 
 	constructor(repo_json: RepoJson) {
 		this.library = new Library(repo_json.library_json);
+		this.package_json = repo_json.package_json;
 		this.check_runs = repo_json.check_runs;
 		this.pull_requests = repo_json.pull_requests;
 	}

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