@fuzdev/fuz_gitops 0.72.0 → 0.74.0

package/dist/operations.d.ts

@@ -38,7 +38,7 @@ import type { FsError } from '@fuzdev/fuz_util/fs.js';
 import type { Logger } from '@fuzdev/fuz_util/log.js';
 import type { LocalRepo } from './local_repo.js';
 import type { ChangesetInfo } from './changeset_reader.js';
-import type { BumpType } from './semver.js';
+import type { BumpType } from './version_utils.js';
 import type { PreflightOptions, PreflightResult } from './preflight_checks.js';
 import type { WaitOptions } from './npm_registry.js';
 /**
@@ -188,7 +188,9 @@ export interface GitOperations {
         message: string;
     }>>;
     /**
-     * Checks if there are any uncommitted changes.
+     * Checks whether the working tree has any changes — staged, unstaged, or
+     * untracked (`git status --porcelain`). Broader than `list_uncommitted_files`,
+     * which reports only tracked working-tree changes relative to HEAD.
      */
     has_changes: (options?: {
         cwd?: string;
@@ -198,11 +200,8 @@ export interface GitOperations {
         message: string;
     }>>;
     /**
-     * Lists uncommitted files in the working tree (`git diff --name-only HEAD`).
-     *
-     * Renamed from `get_changed_files` in 2026-04 because "changed files" collided
-     * with mageguild's `get_changed_files` which diffs two refs. This one reports
-     * uncommitted working-tree changes relative to HEAD.
+     * Lists uncommitted files in the working tree (`git diff --name-only HEAD`),
+     * i.e. working-tree changes relative to HEAD (not a diff between two refs).
      */
     list_uncommitted_files: (options?: {
         cwd?: string;
@@ -314,18 +313,6 @@ export interface NpmOperations {
         message: string;
         timeout?: boolean;
     }>>;
-    /**
-     * Checks if a package version is available on NPM.
-     */
-    check_package_available: (options: {
-        pkg: string;
-        version: string;
-        log?: Logger;
-    }) => Promise<Result<{
-        value: boolean;
-    }, {
-        message: string;
-    }>>;
     /**
      * Checks npm authentication status.
      */
@@ -349,13 +336,6 @@ export interface NpmOperations {
         message: string;
         stderr?: string;
     }>>;
-    /**
-     * Cleans the npm cache.
-     * Uses `npm cache clean --force` to clear stale cache entries.
-     */
-    cache_clean: () => Promise<Result<object, {
-        message: string;
-    }>>;
 }
 /**
  * Preflight validation operations to ensure repos are ready for publishing.

package/dist/operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operations.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/operations.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"operations.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/operations.ts"],"names":[],"mappings":"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"}

package/dist/operations_defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operations_defaults.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/operations_defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA4BH,OAAO,KAAK,EACX,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,MAAM,iBAAiB,CAAC;AA0BzB,eAAO,MAAM,4BAA4B,EAAE,mBAuB1C,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,aA0GpC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,iBAsBxC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,aAqEpC,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,mBAI1C,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,YAuCnC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,eAmBtC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,gBAQvC,CAAC"}
+{"version":3,"file":"operations_defaults.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/operations_defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA4BH,OAAO,KAAK,EACX,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,MAAM,iBAAiB,CAAC;AA0BzB,eAAO,MAAM,4BAA4B,EAAE,mBAuB1C,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,aA4GpC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,iBAsBxC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,aAmDpC,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,mBAI1C,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,YAuCnC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,eAmBtC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,gBAQvC,CAAC"}

package/dist/operations_defaults.js

@@ -12,7 +12,7 @@ import { git_checkout } from '@fuzdev/fuz_util/git.js';
 import { fs_classify_error } from '@fuzdev/fuz_util/fs.js';
 import { EMPTY_OBJECT } from '@fuzdev/fuz_util/object.js';
 import { has_changesets, read_changesets, predict_next_version } from './changeset_reader.js';
-import { wait_for_package, check_package_available } from './npm_registry.js';
+import { wait_for_package } from './npm_registry.js';
 import { run_preflight_checks } from './preflight_checks.js';
 import { git_add, git_commit, git_add_and_commit, git_tag, git_push_tag, git_has_changes, git_list_uncommitted_files, git_has_file_changed, git_stash, git_stash_pop, git_switch_branch, git_current_branch_name_required, git_current_commit_hash_required, git_check_clean_workspace_as_boolean, git_has_remote, } from './git_operations.js';
 /** Wrap an async function that returns a value */
@@ -80,7 +80,9 @@ export const default_git_operations = {
     pull: async (options) => {
         const { origin, branch, cwd } = options ?? EMPTY_OBJECT;
         try {
-            const spawned = await spawn_out('git', ['pull', origin || 'origin', branch || ''], cwd ? { cwd } : undefined);
+            // Omit the branch arg when absent: a trailing `''` makes git pull the remote's
+            // default branch (origin/HEAD) instead of the current branch's upstream.
+            const spawned = await spawn_out('git', ['pull', origin || 'origin', ...(branch ? [branch] : [])], cwd ? { cwd } : undefined);
             if (spawned.result.ok) {
                 return { ok: true };
             }
@@ -181,10 +183,6 @@ export const default_npm_operations = {
             return { ok: false, message: String(error), timeout: true };
         }
     },
-    check_package_available: async (options) => {
-        const { pkg, version, log } = options;
-        return wrap_with_value(() => check_package_available(pkg, version, { log }));
-    },
     check_auth: async () => {
         try {
             const result = await spawn_out('npm', ['whoami']);
@@ -227,20 +225,6 @@ export const default_npm_operations = {
             return { ok: false, message: String(error) };
         }
     },
-    cache_clean: async () => {
-        try {
-            const spawned = await spawn_out('npm', ['cache', 'clean', '--force']);
-            if (spawned.result.ok) {
-                return { ok: true };
-            }
-            else {
-                return { ok: false, message: 'Cache clean failed' };
-            }
-        }
-        catch (error) {
-            return { ok: false, message: String(error) };
-        }
-    },
 };
 export const default_preflight_operations = {
     run_preflight_checks: async (options) => {

package/dist/output_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/output_helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAGpD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAE1D,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC;IAClC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAC1B,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC;IACrC;;OAEG;IACH,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,GAAU,CAAC,EACxC,MAAM,CAAC,EACP,YAAY,gBAAgB,CAAC,CAAC,CAAC,EAC/B,SAAS,aAAa,KACpB,OAAO,CAAC,IAAI,CA6Bd,CAAC"}
+{"version":3,"file":"output_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/output_helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAGpD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAE1D,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC;IAClC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAC1B,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC;IACrC;;OAEG;IACH,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,GAAU,CAAC,EACxC,MAAM,CAAC,EACP,YAAY,gBAAgB,CAAC,CAAC,CAAC,EAC/B,SAAS,aAAa,KACpB,OAAO,CAAC,IAAI,CA8Bd,CAAC"}

package/dist/output_helpers.js

@@ -24,16 +24,17 @@ export const format_and_output = async (data, formatters, options) => {
     }
     // Format data
     const content = format === 'json' ? formatters.json(data) : formatters.markdown(data).join('\n');
-    // Output to file or log
+    // Output to file or stdout
     if (outfile) {
         await writeFile(outfile, content);
         log?.info(`Output written to ${outfile}`);
     }
     else {
-        // Log line by line for better formatting
-        const lines = content.split('\n');
-        for (const line of lines) {
-            log?.info(line);
-        }
+        // Write raw to stdout in one shot. Routing through `log` would prefix every
+        // line with `[taskname]`, corrupting JSON and cluttering markdown — keep the
+        // machine-readable formats unprefixed and pipeable (use `--outfile` for output
+        // fully free of Gro's own preamble).
+        // eslint-disable-next-line no-console
+        console.log(content);
     }
 };

package/dist/paths.d.ts

@@ -1,7 +1,3 @@
-/**
- * Base directory for all gitops-generated files.
- */
-export declare const GITOPS_OUTPUT_DIR = ".gro/fuz_gitops";
 /**
  * Default repos directory relative to gitops config file.
  * Resolves to the parent of the directory with the config

package/dist/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/paths.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,iBAAiB,oBAAoB,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,OAAO,CAAC"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/paths.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,OAAO,CAAC"}

package/dist/paths.js

@@ -1,7 +1,3 @@
-/**
- * Base directory for all gitops-generated files.
- */
-export const GITOPS_OUTPUT_DIR = '.gro/fuz_gitops';
 /**
  * Default repos directory relative to gitops config file.
  * Resolves to the parent of the directory with the config

package/dist/publish_gate.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Pure decision logic for the `gitops_publish` task's interactive gating.
+ *
+ * Extracted from `gitops_publish.task.ts` so the gating table is unit-testable without driving
+ * readline or `process.exit`. The task keeps the IO — prompt, exit, logging — at its edge and
+ * consults these for every branch.
+ *
+ * @module
+ */
+import type { PublishingResult } from './multi_repo_publisher.js';
+import type { PublishingPlan } from './publishing_plan.js';
+/** What the task should do with a generated plan before executing the cascade. */
+export type PublishGate = {
+    action: 'blocked';
+    message: string;
+} | {
+    action: 'confirm';
+} | {
+    action: 'proceed';
+};
+export interface PublishGateOptions {
+    /** A real publish (`--wetrun`); a dry run never prompts. */
+    wetrun: boolean;
+    /** Show the plan and confirm (`plan`); `--no-plan` skips the prompt. */
+    show_plan: boolean;
+    plan: Pick<PublishingPlan, 'errors'>;
+}
+/**
+ * Decides whether a publish run must block, prompt for confirmation, or proceed without
+ * prompting, from the pre-execution inputs.
+ *
+ * - `blocked`: a real publish whose plan has errors — fail loud before prompting. The executor
+ *   enforces this too, so `--no-plan` can't bypass the gate; this branch only avoids prompting
+ *   for (and printing the "this will publish" banner of) a plan that can't run.
+ * - `confirm`: a real publish that shows its plan — the user must confirm interactively.
+ * - `proceed`: a dry run, or a `--no-plan` real publish — no prompt.
+ */
+export declare const decide_publish_gate: (options: PublishGateOptions) => PublishGate;
+/**
+ * Whether a finished run should exit non-zero: an unsuccessful result, or a fatal error thrown
+ * out of the executor.
+ */
+export declare const publish_run_failed: (result: Pick<PublishingResult, "ok">, fatal_error: Error | null) => boolean;
+//# sourceMappingURL=publish_gate.d.ts.map

package/dist/publish_gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish_gate.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/publish_gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAEzD,kFAAkF;AAClF,MAAM,MAAM,WAAW,GACpB;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAC,GACpC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAC,GACnB;IAAC,MAAM,EAAE,SAAS,CAAA;CAAC,CAAC;AAEvB,MAAM,WAAW,kBAAkB;IAClC,4DAA4D;IAC5D,MAAM,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;CACrC;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,kBAAkB,KAAG,WAMjE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC9B,QAAQ,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,EACpC,aAAa,KAAK,GAAG,IAAI,KACvB,OAA6C,CAAC"}

package/dist/publish_gate.js

@@ -0,0 +1,32 @@
+/**
+ * Pure decision logic for the `gitops_publish` task's interactive gating.
+ *
+ * Extracted from `gitops_publish.task.ts` so the gating table is unit-testable without driving
+ * readline or `process.exit`. The task keeps the IO — prompt, exit, logging — at its edge and
+ * consults these for every branch.
+ *
+ * @module
+ */
+/**
+ * Decides whether a publish run must block, prompt for confirmation, or proceed without
+ * prompting, from the pre-execution inputs.
+ *
+ * - `blocked`: a real publish whose plan has errors — fail loud before prompting. The executor
+ *   enforces this too, so `--no-plan` can't bypass the gate; this branch only avoids prompting
+ *   for (and printing the "this will publish" banner of) a plan that can't run.
+ * - `confirm`: a real publish that shows its plan — the user must confirm interactively.
+ * - `proceed`: a dry run, or a `--no-plan` real publish — no prompt.
+ */
+export const decide_publish_gate = (options) => {
+    if (!options.wetrun || !options.show_plan)
+        return { action: 'proceed' };
+    if (options.plan.errors.length > 0) {
+        return { action: 'blocked', message: 'Cannot proceed with publishing due to errors' };
+    }
+    return { action: 'confirm' };
+};
+/**
+ * Whether a finished run should exit non-zero: an unsuccessful result, or a fatal error thrown
+ * out of the executor.
+ */
+export const publish_run_failed = (result, fatal_error) => !result.ok || fatal_error !== null;

package/dist/publish_steps.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Side-effect preview for a publishing plan.
+ *
+ * `derive_publish_steps` linearizes a frozen `PublishingPlan` into the ordered side-effects
+ * a `--wetrun` would perform, mirroring `execute_publishing_plan`'s pass so the preview and
+ * the executor read the same plan data and can't drift. Pure — no side effects.
+ *
+ * @module
+ */
+import type { BumpType } from './version_utils.js';
+import type { PublishingPlan } from './publishing_plan.js';
+/** How a package's version bump arises in the plan. */
+export type PublishStepVia = 'changeset' | 'auto_changeset' | 'escalation';
+/** One ordered side-effect a wetrun would perform. */
+export type PublishStep = {
+    kind: 'publish';
+    repo: string;
+    from: string;
+    to: string;
+    bump: BumpType;
+    via: PublishStepVia;
+} | {
+    kind: 'npm_wait';
+    repo: string;
+    version: string;
+} | {
+    kind: 'dependency_update';
+    dependent: string;
+    dependency: string;
+    to: string;
+    dep_type: 'prod' | 'peer';
+    creates_changeset: boolean;
+} | {
+    kind: 'dev_dep_update';
+    repo: string;
+    dependency: string;
+    to: string;
+} | {
+    kind: 'deploy';
+    repo: string;
+    builds: boolean;
+};
+export interface DerivePublishStepsOptions {
+    /** Include the deploy phase (the publisher only deploys with `--deploy`). */
+    deploy?: boolean;
+}
+/**
+ * Derives the ordered side-effects a wetrun would perform from a frozen plan.
+ *
+ * Reads only `publishing_order`, `version_changes`, and `dependency_updates` — the same data
+ * `execute_publishing_plan` consumes, in the same order — so the preview reflects the real
+ * pass. A dependency is only propagated to its dependents if it actually publishes this run.
+ */
+export declare const derive_publish_steps: (plan: PublishingPlan, options?: DerivePublishStepsOptions) => Array<PublishStep>;
+/**
+ * Formats steps as human-readable lines (one per step) for stdout and markdown output.
+ * Returns a single placeholder line when there are no side effects.
+ */
+export declare const format_publish_steps: (steps: Array<PublishStep>) => Array<string>;
+//# sourceMappingURL=publish_steps.d.ts.map

package/dist/publish_steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish_steps.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/publish_steps.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAC,cAAc,EAAgB,MAAM,sBAAsB,CAAC;AAGxE,uDAAuD;AACvD,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,gBAAgB,GAAG,YAAY,CAAC;AAE3E,sDAAsD;AACtD,MAAM,MAAM,WAAW,GACpB;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,cAAc,CAAA;CAAC,GAC9F;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAC,GACjD;IACA,IAAI,EAAE,mBAAmB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;CAC1B,GACD;IAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAC,GACtE;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAC,CAAC;AAEnD,MAAM,WAAW,yBAAyB;IACzC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AASD;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAChC,MAAM,cAAc,EACpB,UAAS,yBAA8B,KACrC,KAAK,CAAC,WAAW,CAsEnB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,KAAK,CAAC,WAAW,CAAC,KAAG,KAAK,CAAC,MAAM,CAkB5E,CAAC"}

package/dist/publish_steps.js

@@ -0,0 +1,113 @@
+/**
+ * Side-effect preview for a publishing plan.
+ *
+ * `derive_publish_steps` linearizes a frozen `PublishingPlan` into the ordered side-effects
+ * a `--wetrun` would perform, mirroring `execute_publishing_plan`'s pass so the preview and
+ * the executor read the same plan data and can't drift. Pure — no side effects.
+ *
+ * @module
+ */
+import { UnreachableError } from '@fuzdev/fuz_util/error.js';
+const step_via = (change) => change.needs_bump_escalation
+    ? 'escalation'
+    : change.has_changesets
+        ? 'changeset'
+        : 'auto_changeset';
+/**
+ * Derives the ordered side-effects a wetrun would perform from a frozen plan.
+ *
+ * Reads only `publishing_order`, `version_changes`, and `dependency_updates` — the same data
+ * `execute_publishing_plan` consumes, in the same order — so the preview reflects the real
+ * pass. A dependency is only propagated to its dependents if it actually publishes this run.
+ */
+export const derive_publish_steps = (plan, options = {}) => {
+    const { deploy = false } = options;
+    const changes = new Map(plan.version_changes.map((vc) => [vc.package_name, vc]));
+    const steps = [];
+    const changed = new Set(); // for the deploy phase: published + their dependents
+    // Phase 1: one pass over the topological order, mirroring `execute_publishing_plan`.
+    for (const repo of plan.publishing_order) {
+        const change = changes.get(repo);
+        if (!change)
+            continue; // not in the plan = nothing to publish
+        steps.push({
+            kind: 'publish',
+            repo,
+            from: change.from,
+            to: change.to,
+            bump: change.bump_type,
+            via: step_via(change),
+        });
+        steps.push({ kind: 'npm_wait', repo, version: change.to });
+        changed.add(repo);
+        // Prod/peer dependents are rewritten right after this publishes. A dependent that
+        // republishes (has its own plan version change) gets an auto-changeset and republishes in
+        // turn (its rewritten deps are installed + healed by its own `gro publish`); a private
+        // dependent has no version change, so it's an update-only leaf — range rewritten, no
+        // changeset.
+        for (const update of plan.dependency_updates) {
+            if (update.updated_dependency !== repo)
+                continue;
+            if (update.type !== 'dependencies' && update.type !== 'peerDependencies')
+                continue;
+            const republishes = changes.has(update.dependent_package);
+            steps.push({
+                kind: 'dependency_update',
+                dependent: update.dependent_package,
+                dependency: repo,
+                to: change.to,
+                dep_type: update.type === 'peerDependencies' ? 'peer' : 'prod',
+                creates_changeset: republishes,
+            });
+            changed.add(update.dependent_package);
+        }
+    }
+    // Phase 2: dev-dependency updates for deps that published this run — committed without a
+    // changeset (dev-only changes redeploy, they don't republish). No install step: these repos
+    // don't run `gro publish`; gro installs + heals their deps when they next build/deploy/sync.
+    for (const update of plan.dependency_updates) {
+        if (update.type !== 'devDependencies')
+            continue;
+        const dep_change = changes.get(update.updated_dependency);
+        if (!dep_change)
+            continue;
+        steps.push({
+            kind: 'dev_dep_update',
+            repo: update.dependent_package,
+            dependency: update.updated_dependency,
+            to: dep_change.to,
+        });
+        changed.add(update.dependent_package);
+    }
+    // Phase 3: deploy every changed repo (only with --deploy). Each builds fresh.
+    if (deploy) {
+        for (const repo of changed) {
+            steps.push({ kind: 'deploy', repo, builds: true });
+        }
+    }
+    return steps;
+};
+/**
+ * Formats steps as human-readable lines (one per step) for stdout and markdown output.
+ * Returns a single placeholder line when there are no side effects.
+ */
+export const format_publish_steps = (steps) => {
+    if (steps.length === 0)
+        return ['(no side effects — nothing to publish)'];
+    return steps.map((step) => {
+        switch (step.kind) {
+            case 'publish':
+                return `publish   ${step.repo}  ${step.from} → ${step.to}  (${step.bump}, ${step.via})`;
+            case 'npm_wait':
+                return `npm wait  ${step.repo}@${step.version}`;
+            case 'dependency_update':
+                return `update    ${step.dependent} ← ${step.dependency}@${step.to}  (${step.dep_type}${step.creates_changeset ? ', changeset' : ''})`;
+            case 'dev_dep_update':
+                return `dev dep   ${step.repo} ← ${step.dependency}@${step.to}  (no changeset)`;
+            case 'deploy':
+                return `deploy    ${step.repo}${step.builds ? '  (builds)' : ''}`;
+            default:
+                throw new UnreachableError(step);
+        }
+    });
+};

package/dist/publishing_event.d.ts

@@ -25,6 +25,7 @@ export declare const PublishingErrorCode: z.ZodEnum<{
     network: "network";
     auth: "auth";
     dependency: "dependency";
+    drift: "drift";
 }>;
 export type PublishingErrorCode = z.infer<typeof PublishingErrorCode>;
 /** Tallied outcome of a publishing run, derived from its events via `summarize_events`. */
@@ -44,15 +45,6 @@ export declare const PublishingEvent: z.ZodDiscriminatedUnion<[z.ZodObject<{
     event: z.ZodLiteral<"run_started">;
     wetrun: z.ZodBoolean;
     total: z.ZodNumber;
-}, z.core.$strict>, z.ZodObject<{
-    event: z.ZodLiteral<"iteration_started">;
-    iteration: z.ZodNumber;
-    max: z.ZodNumber;
-}, z.core.$strict>, z.ZodObject<{
-    event: z.ZodLiteral<"iteration_finished">;
-    iteration: z.ZodNumber;
-    published_count: z.ZodNumber;
-    converged: z.ZodBoolean;
 }, z.core.$strict>, z.ZodObject<{
     event: z.ZodLiteral<"package_skipped">;
     name: z.ZodString;
@@ -70,6 +62,10 @@ export declare const PublishingEvent: z.ZodDiscriminatedUnion<[z.ZodObject<{
     breaking: z.ZodBoolean;
     commit: z.ZodString;
     tag: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    event: z.ZodLiteral<"npm_waited">;
+    name: z.ZodString;
+    version: z.ZodString;
 }, z.core.$strict>, z.ZodObject<{
     event: z.ZodLiteral<"package_failed">;
     name: z.ZodString;
@@ -81,22 +77,19 @@ export declare const PublishingEvent: z.ZodDiscriminatedUnion<[z.ZodObject<{
         network: "network";
         auth: "auth";
         dependency: "dependency";
+        drift: "drift";
     }>;
 }, z.core.$strict>, z.ZodObject<{
     event: z.ZodLiteral<"dependency_updated">;
     dependent: z.ZodString;
     dependency: z.ZodString;
     version: z.ZodString;
-}, z.core.$strict>, z.ZodObject<{
-    event: z.ZodLiteral<"install_started">;
-    name: z.ZodString;
-}, z.core.$strict>, z.ZodObject<{
-    event: z.ZodLiteral<"install_completed">;
-    name: z.ZodString;
-}, z.core.$strict>, z.ZodObject<{
-    event: z.ZodLiteral<"install_failed">;
-    name: z.ZodString;
-    error: z.ZodString;
+    dep_type: z.ZodEnum<{
+        prod: "prod";
+        peer: "peer";
+        dev: "dev";
+    }>;
+    creates_changeset: z.ZodBoolean;
 }, z.core.$strict>, z.ZodObject<{
     event: z.ZodLiteral<"deploy_started">;
     name: z.ZodString;

package/dist/publishing_event.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"publishing_event.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/publishing_event.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;EAO9B,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE,2FAA2F;AAC3F,eAAO,MAAM,oBAAoB;;;;;;kBAM/B,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BA2E1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,GAC5B,QAAQ,KAAK,CAAC,eAAe,CAAC,EAC9B,UAAU,MAAM,KACd,oBAwBF,CAAC"}
+{"version":3,"file":"publishing_event.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/publishing_event.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;EAW9B,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE,2FAA2F;AAC3F,eAAO,MAAM,oBAAoB;;;;;;kBAM/B,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BA8D1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,GAC5B,QAAQ,KAAK,CAAC,eAAe,CAAC,EAC9B,UAAU,MAAM,KACd,oBAwBF,CAAC"}

package/dist/publishing_event.js

@@ -24,6 +24,10 @@ export const PublishingErrorCode = z.enum([
     'auth',
     'dependency',
     'build',
+    // the real published version diverged from the frozen plan's prediction — an
+    // invariant violation, distinct from an ordinary publish failure (see fail-loud
+    // drift detection in `multi_repo_publisher.ts`)
+    'drift',
     'other',
 ]);
 /** Tallied outcome of a publishing run, derived from its events via `summarize_events`. */
@@ -44,17 +48,6 @@ export const PublishingEvent = z.discriminatedUnion('event', [
         wetrun: z.boolean().meta({ description: 'false means every package_completed is a prediction' }),
         total: z.number(),
     }),
-    z.strictObject({
-        event: z.literal('iteration_started'),
-        iteration: z.number(),
-        max: z.number(),
-    }),
-    z.strictObject({
-        event: z.literal('iteration_finished'),
-        iteration: z.number(),
-        published_count: z.number(),
-        converged: z.boolean(),
-    }),
     z.strictObject({
         event: z.literal('package_skipped'),
         name: z.string(),
@@ -65,12 +58,17 @@ export const PublishingEvent = z.discriminatedUnion('event', [
         name: z.string(),
         old_version: z.string(),
         new_version: z.string(),
-        // mirrors `BumpType` from `semver.ts`; inline so the event schema is self-contained
+        // mirrors `BumpType` from `version_utils.ts`; inline so the event schema is self-contained
         bump_type: z.enum(['major', 'minor', 'patch']),
         breaking: z.boolean(),
         commit: z.string().meta({ description: "'simulated' in a dry run, otherwise the commit hash" }),
         tag: z.string(),
     }),
+    z.strictObject({
+        event: z.literal('npm_waited'),
+        name: z.string(),
+        version: z.string().meta({ description: 'the version waited on after publishing' }),
+    }),
     z.strictObject({
         event: z.literal('package_failed'),
         name: z.string(),
@@ -82,19 +80,12 @@ export const PublishingEvent = z.discriminatedUnion('event', [
         dependent: z.string(),
         dependency: z.string(),
         version: z.string(),
-    }),
-    z.strictObject({
-        event: z.literal('install_started'),
-        name: z.string(),
-    }),
-    z.strictObject({
-        event: z.literal('install_completed'),
-        name: z.string(),
-    }),
-    z.strictObject({
-        event: z.literal('install_failed'),
-        name: z.string(),
-        error: z.string(),
+        // 'prod'/'peer' updates run inline in the publish pass; 'dev' updates run in the later
+        // dev-dependency pass. Lets a consumer reconstruct which side-effect phase this is.
+        dep_type: z.enum(['prod', 'peer', 'dev']),
+        // true when the update creates an auto-changeset (a publishable dependent republishes);
+        // false for dev-dep updates and update-only leaves (private dependents never publish).
+        creates_changeset: z.boolean(),
     }),
     z.strictObject({
         event: z.literal('deploy_started'),

package/dist/publishing_plan.d.ts

@@ -1,6 +1,6 @@
 import type { Logger } from '@fuzdev/fuz_util/log.js';
 import type { LocalRepo } from './local_repo.js';
-import type { BumpType } from './semver.js';
+import { type BumpType } from './version_utils.js';
 import type { ChangesetOperations } from './operations.js';
 export { log_publishing_plan, type LogPlanOptions } from './publishing_plan_logging.js';
 export interface VersionChange {
@@ -21,7 +21,6 @@ export interface DependencyUpdate {
     current_version: string;
     new_version: string;
     type: 'dependencies' | 'devDependencies' | 'peerDependencies';
-    causes_republish: boolean;
 }
 export interface VerboseChangesetDetail {
     package_name: string;