@fuzdev/fuz_gitops 0.72.0 → 0.73.0

package/dist/publishing_plan.js

@@ -1,6 +1,6 @@
 import { styleText as st } from 'node:util';
 import { validate_dependency_graph } from './graph_validation.js';
-import { is_breaking_change, compare_bump_types, calculate_next_version } from './version_utils.js';
+import { is_breaking_change, compare_bump_types, calculate_next_version, } from './version_utils.js';
 import { default_changeset_operations } from './operations_defaults.js';
 import { GITOPS_MAX_ITERATIONS_DEFAULT } from './gitops_constants.js';
 import { calculate_dependency_updates, get_required_bump_for_dependencies, } from './publishing_plan_helpers.js';
@@ -70,6 +70,17 @@ export const generate_publishing_plan = async (repos, options = {}) => {
         const repo = repos.find((r) => r.library.name === pkg_name);
         if (!repo)
             continue;
+        // Private packages never publish — exclude them from version changes entirely (no
+        // publish step, npm-wait, bump escalation, or auto-changeset). They keep their slot in
+        // the topological order. Flag a private package that carries a changeset, since that
+        // changeset can't be published.
+        if (repo.library.package_json.private) {
+            const private_has_changesets = await ops.has_changesets({ repo });
+            if (private_has_changesets.ok && private_has_changesets.value) {
+                warnings.push(`${pkg_name} is private — its changeset(s) will not be published`);
+            }
+            continue;
+        }
         // Check for changesets
         const has_result = await ops.has_changesets({ repo });
         if (!has_result.ok) {
@@ -140,6 +151,10 @@ export const generate_publishing_plan = async (repos, options = {}) => {
         // Process packages to check for bump escalation and auto-generated changesets
         for (const repo of repos) {
             const pkg_name = repo.library.name;
+            // Private packages are excluded from version changes (they never publish), so they
+            // never escalate or auto-generate a changeset.
+            if (repo.library.package_json.private)
+                continue;
             // Get required bump from dependencies
             const required_bump = get_required_bump_for_dependencies(repo, dependency_updates, breaking_packages);
             // Find triggering dependency for verbose output
@@ -248,6 +263,8 @@ export const generate_publishing_plan = async (repos, options = {}) => {
         const { dependency_updates: pending_updates } = calculate_dependency_updates(repos, predicted_versions, breaking_packages);
         for (const repo of repos) {
             const pkg_name = repo.library.name;
+            if (repo.library.package_json.private)
+                continue; // private packages never publish
             const required_bump = get_required_bump_for_dependencies(repo, pending_updates, breaking_packages);
             // Check if this package would need processing
             const existing_entry = version_changes.find((vc) => vc.package_name === pkg_name);

package/dist/publishing_plan_helpers.d.ts

@@ -6,7 +6,7 @@
  * @module
  */
 import type { LocalRepo } from './local_repo.js';
-import type { BumpType } from './semver.js';
+import { type BumpType } from './version_utils.js';
 import type { DependencyUpdate } from './publishing_plan.js';
 /**
  * Calculates all dependency updates between packages based on predicted versions.

package/dist/publishing_plan_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"publishing_plan_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/publishing_plan_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,GACxC,OAAO,KAAK,CAAC,SAAS,CAAC,EACvB,oBAAoB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACvC,mBAAmB,GAAG,CAAC,MAAM,CAAC,KAC5B;IACF,kBAAkB,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC5C,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;CA2E9C,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,kCAAkC,GAC9C,MAAM,SAAS,EACf,oBAAoB,KAAK,CAAC,gBAAgB,CAAC,EAC3C,mBAAmB,GAAG,CAAC,MAAM,CAAC,KAC5B,QAAQ,GAAG,IA8Bb,CAAC"}
+{"version":3,"file":"publishing_plan_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/publishing_plan_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAoD,KAAK,QAAQ,EAAC,MAAM,oBAAoB,CAAC;AACpG,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,GACxC,OAAO,KAAK,CAAC,SAAS,CAAC,EACvB,oBAAoB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACvC,mBAAmB,GAAG,CAAC,MAAM,CAAC,KAC5B;IACF,kBAAkB,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC5C,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;CAwE9C,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,kCAAkC,GAC9C,MAAM,SAAS,EACf,oBAAoB,KAAK,CAAC,gBAAgB,CAAC,EAC3C,mBAAmB,GAAG,CAAC,MAAM,CAAC,KAC5B,QAAQ,GAAG,IAqBb,CAAC"}

package/dist/publishing_plan_helpers.js

@@ -5,7 +5,7 @@
  *
  * @module
  */
-import { needs_update } from './version_utils.js';
+import { needs_update, required_bump_for_dependency_update } from './version_utils.js';
 /**
  * Calculates all dependency updates between packages based on predicted versions.
  *
@@ -29,7 +29,6 @@ export const calculate_dependency_updates = (repos, predicted_versions, breaking
                         current_version,
                         new_version,
                         type: 'dependencies',
-                        causes_republish: true,
                     });
                     if (breaking_packages.has(dep_name)) {
                         const cascades = breaking_cascades.get(dep_name) || [];
@@ -52,7 +51,6 @@ export const calculate_dependency_updates = (repos, predicted_versions, breaking
                         current_version,
                         new_version,
                         type: 'peerDependencies',
-                        causes_republish: true,
                     });
                     if (breaking_packages.has(dep_name)) {
                         const cascades = breaking_cascades.get(dep_name) || [];
@@ -75,7 +73,6 @@ export const calculate_dependency_updates = (repos, predicted_versions, breaking
                         current_version,
                         new_version,
                         type: 'devDependencies',
-                        causes_republish: false,
                     });
                 }
             }
@@ -100,15 +97,5 @@ export const get_required_bump_for_dependencies = (repo, dependency_updates, bre
     }
     // Check if any of these dependencies have breaking changes
     const has_breaking_deps = relevant_updates.some((update) => 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/dist/publishing_plan_logging.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"publishing_plan_logging.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/publishing_plan_logging.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAGpD,OAAO,KAAK,EACX,cAAc,EAQd,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,cAAc;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AA2GD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC/B,MAAM,cAAc,EACpB,KAAK,MAAM,EACX,UAAS,cAAmB,KAC1B,IAiKF,CAAC"}
+{"version":3,"file":"publishing_plan_logging.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/publishing_plan_logging.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAGpD,OAAO,KAAK,EACX,cAAc,EAQd,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,cAAc;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AA2GD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC/B,MAAM,cAAc,EACpB,KAAK,MAAM,EACX,UAAS,cAAmB,KAC1B,IA6IF,CAAC"}

package/dist/publishing_plan_logging.js

@@ -120,31 +120,23 @@ export const log_publishing_plan = (plan, log, options = {}) => {
         const with_changesets = ordered_changes.filter((vc) => vc.has_changesets && !vc.needs_bump_escalation);
         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);
-                log_version_change_with_diffs(change, idx, ordered_changes.length, dependency_updates, breaking_cascades, log);
+        // 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, color, changes) => {
+            if (changes.length === 0)
+                return;
+            log.info(st(color, title));
+            for (const change of changes) {
+                log_version_change_with_diffs(change, 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'));

package/dist/version_utils.d.ts

@@ -1,4 +1,5 @@
-import type { BumpType } from './semver.js';
+/** A semver bump kind: `major`, `minor`, or `patch`. */
+export type BumpType = 'major' | 'minor' | 'patch';
 export declare const is_wildcard: (version: string) => boolean;
 /**
  * Strips version prefix (^, ~, >=, <=, etc) from a version string.
@@ -47,8 +48,21 @@ export declare const get_update_prefix: (current_version: string, default_strate
  * Pre-1.0: minor bumps are breaking
  * 1.0+: major bumps are breaking
  */
-export declare const is_breaking_change: (old_version: string, bump_type: "major" | "minor" | "patch") => boolean;
-export declare const detect_bump_type: (old_version: string, new_version: string) => "major" | "minor" | "patch";
+export declare const is_breaking_change: (old_version: string, bump_type: BumpType) => boolean;
+/**
+ * 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 declare const required_bump_for_dependency_update: (current_version: string, has_breaking_deps: boolean) => BumpType;
+export declare const detect_bump_type: (old_version: string, new_version: string) => BumpType;
 /**
  * Compares bump types. Returns positive if a > b, negative if a < b, 0 if equal.
  */

package/dist/version_utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version_utils.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/version_utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,aAAa,CAAC;AAE1C,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,KAAG,OAE7C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAS,MAAM,KAAG,MAEtD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,MAAM,KAAG,MAGpD,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,gCAAgC,GAAI,SAAS,MAAM,KAAG,MAWlE,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,EAAE,aAAa,MAAM,KAAG,OASnE,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,GAC7B,iBAAiB,MAAM,EACvB,mBAAkB,GAAG,GAAG,GAAG,GAAG,EAAE,GAAG,IAAU,KAC3C,MAcF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC9B,aAAa,MAAM,EACnB,WAAW,OAAO,GAAG,OAAO,GAAG,OAAO,KACpC,OAWF,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC5B,aAAa,MAAM,EACnB,aAAa,MAAM,KACjB,OAAO,GAAG,OAAO,GAAG,OAOtB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,GAAG,QAAQ,EAAE,GAAG,QAAQ,KAAG,MAO7D,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,iBAAiB,MAAM,EAAE,WAAW,QAAQ,KAAG,MAkBrF,CAAC"}
+{"version":3,"file":"version_utils.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/version_utils.ts"],"names":[],"mappings":"AAEA,wDAAwD;AACxD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEnD,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,KAAG,OAE7C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAS,MAAM,KAAG,MAEtD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,MAAM,KAAG,MAGpD,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,gCAAgC,GAAI,SAAS,MAAM,KAAG,MAWlE,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,EAAE,aAAa,MAAM,KAAG,OASnE,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,GAC7B,iBAAiB,MAAM,EACvB,mBAAkB,GAAG,GAAG,GAAG,GAAG,EAAE,GAAG,IAAU,KAC3C,MAcF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,aAAa,MAAM,EAAE,WAAW,QAAQ,KAAG,OAW7E,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mCAAmC,GAC/C,iBAAiB,MAAM,EACvB,mBAAmB,OAAO,KACxB,QASF,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,aAAa,MAAM,EAAE,aAAa,MAAM,KAAG,QAO3E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,GAAG,QAAQ,EAAE,GAAG,QAAQ,KAAG,MAO7D,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,iBAAiB,MAAM,EAAE,WAAW,QAAQ,KAAG,MAkBrF,CAAC"}

package/dist/version_utils.js

@@ -96,6 +96,28 @@ export const is_breaking_change = (old_version, bump_type) => {
         return bump_type === 'major';
     }
 };
+/**
+ * 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, has_breaking_deps) => {
+    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, new_version) => {
     const old_parts = old_version.split('.').map(Number);
     const new_parts = new_version.split('.').map(Number);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_gitops",
-  "version": "0.72.0",
+  "version": "0.73.0",
   "description": "a tool for managing many repos",
   "glyph": "🪄",
   "logo": "logo.svg",
@@ -42,10 +42,9 @@
     "@fuzdev/blake3_wasm": "^0.1.1",
     "@fuzdev/fuz_code": "^0.45.1",
     "@fuzdev/fuz_css": "^0.61.1",
-    "@fuzdev/fuz_ui": "^0.198.0",
-    "@fuzdev/fuz_util": "^0.63.1",
-    "@fuzdev/gro": "^0.200.0",
-    "@jridgewell/trace-mapping": "^0.3.31",
+    "@fuzdev/fuz_ui": "^0.198.1",
+    "@fuzdev/fuz_util": "^0.63.2",
+    "@fuzdev/gro": "^0.202.0",
     "@ryanatkn/eslint-config": "^0.12.1",
     "@sveltejs/acorn-typescript": "^1.0.9",
     "@sveltejs/adapter-static": "^3.0.10",
@@ -63,7 +62,7 @@
     "prettier-plugin-svelte": "^3.5.1",
     "svelte": "^5.56.0",
     "svelte-check": "^4.4.6",
-    "svelte-docinfo": "^0.2.1",
+    "svelte-docinfo": "^0.4.0",
     "svelte2tsx": "^0.7.52",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",

package/src/lib/changeset_generator.ts

@@ -11,7 +11,11 @@ import {join} from 'node:path';
 import type {Logger} from '@fuzdev/fuz_util/log.js';
 import type {LocalRepo} from './local_repo.js';
 import type {PublishedVersion} from './multi_repo_publisher.js';
-import {strip_version_prefix} from './version_utils.js';
+import {
+	strip_version_prefix,
+	required_bump_for_dependency_update,
+	type BumpType,
+} from './version_utils.js';
 import type {FsOperations} from './operations.js';
 import {default_fs_operations} from './operations_defaults.js';
 
@@ -69,24 +73,11 @@ export const create_changeset_for_dependency_updates = async (
 const calculate_required_bump = (
 	repo: LocalRepo,
 	updates: Array<DependencyVersionChange>,
-): 'major' | 'minor' | 'patch' => {
-	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;
-
-	// Check if any dependency had breaking changes
-	const has_breaking = updates.some((u) => u.breaking);
-
-	if (has_breaking) {
-		// 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, always use patch
-	return 'patch';
-};
+): BumpType =>
+	required_bump_for_dependency_update(
+		repo.library.package_json.version || '0.0.0',
+		updates.some((u) => u.breaking),
+	);
 
 /**
  * Generates markdown changeset content for dependency updates.

package/src/lib/changeset_reader.ts

@@ -13,8 +13,7 @@ import {readdir, readFile} from 'node:fs/promises';
 import {join} from 'node:path';
 
 import type {LocalRepo} from './local_repo.js';
-import type {BumpType} from './semver.js';
-import {compare_bump_types, calculate_next_version} from './version_utils.js';
+import {compare_bump_types, calculate_next_version, type BumpType} from './version_utils.js';
 
 export interface ChangesetInfo {
 	filename: string;

package/src/lib/dependency_graph.ts

@@ -66,7 +66,7 @@ export class DependencyGraph {
 				repo,
 				dependencies: new Map(),
 				dependents: new Set(),
-				publishable: !!library.package_json.private === false, // eslint-disable-line @typescript-eslint/no-unnecessary-boolean-literal-compare
+				publishable: !library.package_json.private,
 			};
 
 			// Extract dependencies

package/src/lib/git_operations.ts

@@ -84,6 +84,11 @@ export const git_push_tag = async (
 	}
 };
 
+/**
+ * Returns `true` if the working tree has any changes — staged, unstaged, or
+ * untracked (`git status --porcelain`). Broader than `git_list_uncommitted_files`,
+ * which reports only tracked working-tree changes relative to HEAD.
+ */
 export const git_has_changes = async (options?: SpawnOptions): Promise<boolean> => {
 	const {stdout} = await spawn_out('git', ['status', '--porcelain'], options);
 	return stdout ? stdout.trim().length > 0 : false;

package/src/lib/gitops_analyze.task.ts

@@ -4,9 +4,9 @@ import {styleText as st} from 'node:util';
 import type {Logger} from '@fuzdev/fuz_util/log.js';
 
 import {get_gitops_ready} from './gitops_task_helpers.js';
-import {type DependencyGraph, DependencyGraphBuilder} from './dependency_graph.js';
+import type {DependencyGraph} from './dependency_graph.js';
 import type {LocalRepo} from './local_repo.js';
-import {validate_dependency_graph} from './graph_validation.js';
+import {analyze_repos, type DependencyAnalysis} from './graph_validation.js';
 import {
 	format_wildcard_dependencies,
 	format_dev_cycles,
@@ -30,6 +30,13 @@ export const Args = z.strictObject({
 		.meta({description: 'output format'})
 		.default('stdout'),
 	outfile: z.string().meta({description: 'write output to file instead of logging'}).optional(),
+	sync: z
+		.boolean()
+		.meta({
+			description:
+				'sync repos (switch branch, pull, install) before analyzing instead of reading the working tree as-is',
+		})
+		.default(false),
 });
 export type Args = z.infer<typeof Args>;
 
@@ -38,25 +45,13 @@ export const task: Task<Args> = {
 	Args,
 	summary: 'analyze dependency structure and relationships across repos',
 	run: async ({args, log}) => {
-		const {config, dir, format, outfile} = args;
+		const {config, dir, format, outfile, sync} = args;
 
-		// Get repos ready (without downloading)
-		const {local_repos} = await get_gitops_ready({config, dir, download: false, log});
+		// Get repos ready (without downloading); read the working tree as-is unless `--sync`
+		const {local_repos} = await get_gitops_ready({config, dir, download: false, sync, log});
 
-		// Build dependency graph and validate (but don't throw on cycles for analyze)
-		const {graph, publishing_order: order} = validate_dependency_graph(local_repos, {
-			log,
-			throw_on_prod_cycles: false, // Analyze should report, not throw
-			log_cycles: false, // We'll show cycles in our formatted output
-			log_order: false, // We'll show order in our formatted output
-		});
-
-		// Perform additional analysis
-		const builder = new DependencyGraphBuilder();
-		const analysis = builder.analyze(graph);
-
-		// Publishing order (may be null if prod cycles exist)
-		const publishing_order = order.length > 0 ? order : null;
+		// Build the dependency graph and analyze cycles/wildcards (tolerating cycles)
+		const {graph, analysis, publishing_order} = analyze_repos(local_repos);
 
 		// Format and output using output_helpers
 		const data = {
@@ -74,7 +69,7 @@ export const task: Task<Args> = {
 interface AnalysisData {
 	repos: Array<LocalRepo>;
 	graph: DependencyGraph;
-	analysis: ReturnType<DependencyGraphBuilder['analyze']>;
+	analysis: DependencyAnalysis;
 	publishing_order: Array<string> | null;
 }
 
@@ -102,7 +97,7 @@ const calculate_stats = (graph: DependencyGraph) => {
 
 const format_json = (
 	graph: DependencyGraph,
-	analysis: ReturnType<DependencyGraphBuilder['analyze']>,
+	analysis: DependencyAnalysis,
 	publishing_order: Array<string> | null,
 ): string => {
 	const output = {
@@ -116,7 +111,7 @@ const format_json = (
 const format_markdown = (
 	repos: Array<LocalRepo>,
 	graph: DependencyGraph,
-	analysis: ReturnType<DependencyGraphBuilder['analyze']>,
+	analysis: DependencyAnalysis,
 	publishing_order: Array<string> | null,
 ): Array<string> => {
 	const lines: Array<string> = ['# Dependency Analysis'];
@@ -192,7 +187,7 @@ const format_markdown = (
 const format_stdout = (
 	repos: Array<LocalRepo>,
 	graph: DependencyGraph,
-	analysis: ReturnType<DependencyGraphBuilder['analyze']>,
+	analysis: DependencyAnalysis,
 	publishing_order: Array<string> | null,
 	log: Logger,
 ): void => {

package/src/lib/gitops_plan.task.ts

@@ -28,6 +28,13 @@ export const Args = z.strictObject({
 		.default('stdout'),
 	outfile: z.string().meta({description: 'write output to file instead of logging'}).optional(),
 	verbose: z.boolean().meta({description: 'show additional details'}).default(false),
+	sync: z
+		.boolean()
+		.meta({
+			description:
+				'sync repos (switch branch, pull, install) before planning instead of reading the working tree as-is',
+		})
+		.default(false),
 });
 export type Args = z.infer<typeof Args>;
 
@@ -46,15 +53,16 @@ export const task: Task<Args> = {
 	summary: 'generate a publishing plan based on changesets',
 	Args,
 	run: async ({args, log}): Promise<void> => {
-		const {dir, config, format, outfile, verbose} = args;
+		const {dir, config, format, outfile, verbose, sync} = args;
 
 		log.info(st('cyan', 'Generating multi-repo publishing plan...'));
 
-		// Load local repos
+		// Load local repos; read the working tree as-is unless `--sync`
 		const {local_repos} = await get_gitops_ready({
 			config,
 			dir,
 			download: false, // Don't download if missing
+			sync,
 			log,
 		});