@fuzdev/fuz_gitops 0.78.1 → 0.79.0

package/dist/preflight_checks.js

@@ -1,144 +1,76 @@
-import { spawn_out } from '@fuzdev/fuz_util/process.ts';
 import { styleText as st } from 'node:util';
-import { default_git_operations, default_npm_operations, default_build_operations, default_changeset_operations } from './operations_defaults.js';
+import { default_npm_operations, default_build_operations } from './operations_defaults.js';
 /**
- * Validates all requirements before publishing can proceed.
+ * Validates the publish-time requirements beyond repo git state:
+ * - every package the plan publishes builds (fail-fast to prevent broken state)
+ * - npm authentication
+ * - npm registry connectivity
  *
- * Performs comprehensive pre-flight validation:
- * - Clean workspaces (100% clean required - no uncommitted changes)
- * - Correct branch (usually main)
- * - Changesets present (unless `skip_changesets`=true)
- * - Builds successful (fail-fast to prevent broken state)
- * - Git remote reachability
- * - NPM authentication with username
- * - NPM registry connectivity
+ * What publishes is the plan's to decide, so preflight reads no changesets: it
+ * builds each package in `version_changes`. Git state — each repo on its
+ * registry branch, clean, idle, in sync with origin or ahead of it, and no live
+ * session in its checkout — is the readiness gate's, which `gitops_publish
+ * --wetrun` runs before the plan's confirmation prompt (`repo_readiness.ts`), so
+ * preflight reads no git.
  *
  * Build validation runs BEFORE any publishing to prevent the scenario where
  * version is bumped but build fails, leaving repo in broken state.
  *
- * @returns result with `ok`=false if any errors, plus warnings and detailed status
+ * @returns result with `ok`=false if any errors, plus warnings
  */
-export const run_preflight_checks = async ({ repos, preflight_options = {}, git_ops = default_git_operations, npm_ops = default_npm_operations, build_ops = default_build_operations, changeset_ops = default_changeset_operations }) => {
-    const { skip_changesets = false, skip_build_validation = false, required_branch = 'main', check_remote = true, estimate_time = true, log } = preflight_options;
+export const run_preflight_checks = async ({ repos, version_changes, log, npm_ops = default_npm_operations, build_ops = default_build_operations }) => {
     const warnings = [];
     const errors = [];
-    const repos_with_changesets = new Set();
-    const repos_without_changesets = new Set();
-    let npm_username;
-    let estimated_duration;
     log?.info(st('cyan', '✅ Running preflight checks...'));
-    // 1. Check clean workspaces - must be 100% clean before publishing
-    log?.info('  Checking workspace cleanliness...');
-    for (const repo of repos) {
-        const clean_result = await git_ops.check_clean_workspace({ cwd: repo.repo_dir });
-        if (!clean_result.ok) {
-            errors.push(`${repo.library.name} failed workspace check: ${clean_result.message}`);
-            continue;
+    // 1. Build every package the plan publishes
+    const repo_by_name = new Map(repos.map((r) => [r.library.name, r]));
+    const repos_to_build = [];
+    for (const change of version_changes) {
+        const repo = repo_by_name.get(change.package_name);
+        if (repo) {
+            repos_to_build.push(repo);
         }
-        if (!clean_result.value) {
-            // Get list of changed files for better error message
-            const files_result = await git_ops.list_uncommitted_files({ cwd: repo.repo_dir });
-            if (files_result.ok) {
-                // No filtering - workspace must be 100% clean
-                const unexpected_files = files_result.value;
-                if (unexpected_files.length > 0) {
-                    errors.push(`${repo.library.name} has uncommitted changes in: ${unexpected_files.slice(0, 3).join(', ')}${unexpected_files.length > 3 ? ` and ${unexpected_files.length - 3} more` : ''}`);
-                }
-            }
-            else {
-                errors.push(`${repo.library.name} has uncommitted changes`);
-            }
-        }
-    }
-    // 2. Check correct branch
-    log?.info(`  Checking branches (expecting ${required_branch})...`);
-    for (const repo of repos) {
-        const branch_result = await git_ops.current_branch_name({ cwd: repo.repo_dir });
-        if (!branch_result.ok) {
-            errors.push(`${repo.library.name} failed branch check: ${branch_result.message}`);
-            continue;
-        }
-        if (branch_result.value !== required_branch) {
-            errors.push(`${repo.library.name} is on branch '${branch_result.value}', expected '${required_branch}'`);
-        }
-    }
-    // 3. Check changesets (unless skipped)
-    if (!skip_changesets) {
-        log?.info('  Checking for changesets...');
-        for (const repo of repos) {
-            const has_result = await changeset_ops.has_changesets({ repo });
-            if (!has_result.ok) {
-                errors.push(`${repo.library.name} failed changeset check: ${has_result.message}`);
-                continue;
-            }
-            if (has_result.value) {
-                repos_with_changesets.add(repo.library.name);
-            }
-            else {
-                repos_without_changesets.add(repo.library.name);
-                warnings.push(`${repo.library.name} has no changesets`);
-            }
-        }
-        if (repos_without_changesets.size > 0) {
-            log?.warn(st('yellow', `  ⚠️  ${repos_without_changesets.size} packages have no changesets`));
+        else {
+            errors.push(`${change.package_name} is in the plan but not among the repos`);
         }
     }
-    // 4. Validate builds for packages with changesets
-    if (!skip_build_validation && repos_with_changesets.size > 0) {
-        log?.info(st('cyan', `  Validating builds for ${repos_with_changesets.size} package(s)...`));
-        const repos_to_build = repos.filter((repo) => repos_with_changesets.has(repo.library.name));
+    if (repos_to_build.length > 0) {
+        log?.info(st('cyan', `  Validating builds for ${repos_to_build.length} package(s)...`));
+        let build_failures = 0;
         for (let i = 0; i < repos_to_build.length; i++) {
             const repo = repos_to_build[i];
             log?.info(st('dim', `    [${i + 1}/${repos_to_build.length}] Building ${repo.library.name}...`));
-            const build_result = await build_ops.build_package({ repo, log });
-            if (!build_result.ok) {
-                errors.push(`${repo.library.name} failed to build: ${build_result.output || build_result.message || 'unknown error'}`);
+            const build_result = await build_ops.build_package({ repo });
+            if (build_result.ok) {
+                log?.info(st('dim', `    ✓ ${repo.library.name} built successfully`));
             }
             else {
-                log?.info(st('dim', `    ✓ ${repo.library.name} built successfully`));
+                build_failures++;
+                errors.push(`${repo.library.name} failed to build: ${build_result.output || build_result.message || 'unknown error'}`);
             }
         }
-        if (errors.some((err) => err.includes('failed to build'))) {
+        if (build_failures > 0) {
             log?.error(st('red', '  ❌ Build validation failed - fix build errors before publishing'));
         }
         else {
             log?.info(st('green', '  ✓ All builds validated successfully'));
         }
     }
-    // 5. Check git remote reachability (skip in tests when check_remote is false)
-    if (check_remote && repos.length > 0) {
-        log?.info('  Checking git remote connectivity...');
-        // Only check first repo to avoid slowing down tests with multiple remote checks
-        const remote_result = await check_git_remote(repos[0].repo_dir);
-        if (!remote_result.ok) {
-            warnings.push(`git remote may not be reachable - ${remote_result.message}`);
-        }
-    }
-    // 6. Check npm authentication with username
+    // 2. Check npm authentication
     log?.info('  Checking npm authentication...');
     const npm_auth_result = await npm_ops.check_auth();
-    if (!npm_auth_result.ok) {
-        errors.push(`npm authentication failed: ${npm_auth_result.message || 'not logged in'}`);
+    if (npm_auth_result.ok) {
+        log?.info(st('dim', `    Logged in as: ${npm_auth_result.username}`));
     }
     else {
-        npm_username = npm_auth_result.username;
-        log?.info(st('dim', `    Logged in as: ${npm_username}`));
+        errors.push(`npm authentication failed: ${npm_auth_result.message || 'not logged in'}`);
     }
-    // 7. Check network connectivity (npm registry)
+    // 3. Check network connectivity (npm registry)
     log?.info('  Checking npm registry connectivity...');
     const registry_result = await npm_ops.check_registry();
     if (!registry_result.ok) {
         warnings.push(`npm registry check failed: ${registry_result.message}`);
     }
-    // 8. Estimate total publish time
-    if (estimate_time) {
-        const packages_to_publish = repos_with_changesets.size;
-        if (packages_to_publish > 0) {
-            // Rough estimate: 30s per package + 10s per package for NPM propagation
-            estimated_duration = packages_to_publish * 40;
-            log?.info(st('dim', `  Estimated publish time: ~${Math.ceil(estimated_duration / 60)} minutes for ${packages_to_publish} package(s)`));
-        }
-    }
     // Report results
     const ok = errors.length === 0;
     if (errors.length > 0) {
@@ -156,26 +88,5 @@ export const run_preflight_checks = async ({ repos, preflight_options = {}, git_
     if (ok) {
         log?.info(st('green', '\n✨ All preflight checks passed!'));
     }
-    return {
-        ok,
-        warnings,
-        errors,
-        repos_with_changesets,
-        repos_without_changesets,
-        estimated_duration,
-        npm_username
-    };
-};
-const check_git_remote = async (cwd) => {
-    try {
-        // Try to fetch refs from remote without downloading objects
-        const result = await spawn_out('git', ['ls-remote', '--heads', 'origin'], { cwd });
-        if (result.stdout || result.stderr) {
-            return { ok: true };
-        }
-        return { ok: false, message: 'No response from git remote' };
-    }
-    catch (error) {
-        return { ok: false, message: String(error) };
-    }
+    return { ok, warnings, errors };
 };

package/dist/publish_steps.d.ts

@@ -8,9 +8,7 @@
  * @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';
+import { type PublishingPlan, type VersionChangeKind } from './publishing_plan.js';
 /** One ordered side-effect a wetrun would perform. */
 export type PublishStep = {
     kind: 'publish';
@@ -18,7 +16,7 @@ export type PublishStep = {
     from: string;
     to: string;
     bump: BumpType;
-    via: PublishStepVia;
+    via: VersionChangeKind;
 } | {
     kind: 'npm_wait';
     repo: string;

package/dist/publish_steps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"publish_steps.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/publish_steps.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,sBAAsB,CAAC;AAG1E,uDAAuD;AACvD,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,gBAAgB,GAAG,YAAY,CAAC;AAE3E,sDAAsD;AACtD,MAAM,MAAM,WAAW,GACpB;IAAE,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;CAAE,GAChG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnD;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;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAErD,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"}
+{"version":3,"file":"publish_steps.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/publish_steps.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAEN,KAAK,cAAc,EAEnB,KAAK,iBAAiB,EACtB,MAAM,sBAAsB,CAAC;AAG9B,sDAAsD;AACtD,MAAM,MAAM,WAAW,GACpB;IACA,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,GAAG,EAAE,iBAAiB,CAAC;CACtB,GACD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnD;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;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAErD,MAAM,WAAW,yBAAyB;IACzC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;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

@@ -7,12 +7,8 @@
  *
  * @module
  */
+import { version_change_kind } from './publishing_plan.js';
 import { UnreachableError } from '@fuzdev/fuz_util/error.ts';
-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.
  *
@@ -36,7 +32,7 @@ export const derive_publish_steps = (plan, options = {}) => {
             from: change.from,
             to: change.to,
             bump: change.bump_type,
-            via: step_via(change)
+            via: version_change_kind(change)
         });
         steps.push({ kind: 'npm_wait', repo, version: change.to });
         changed.add(repo);

package/dist/publishing_event.d.ts

@@ -19,12 +19,9 @@ import { z } from 'zod';
  * failure kind without parsing the message.
  */
 export declare const PublishingErrorCode: z.ZodEnum<{
-    other: "other";
-    build: "build";
     publish: "publish";
+    not_ready: "not_ready";
     network: "network";
-    auth: "auth";
-    dependency: "dependency";
     drift: "drift";
 }>;
 export type PublishingErrorCode = z.infer<typeof PublishingErrorCode>;
@@ -71,12 +68,9 @@ export declare const PublishingEvent: z.ZodDiscriminatedUnion<[z.ZodObject<{
     name: z.ZodString;
     error: z.ZodString;
     code: z.ZodEnum<{
-        other: "other";
-        build: "build";
         publish: "publish";
+        not_ready: "not_ready";
         network: "network";
-        auth: "auth";
-        dependency: "dependency";
         drift: "drift";
     }>;
 }, z.core.$strict>, z.ZodObject<{

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,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAgE1B,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,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;EAY9B,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAgE1B,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

@@ -19,16 +19,17 @@ import { z } from 'zod';
  * failure kind without parsing the message.
  */
 export const PublishingErrorCode = z.enum([
+    // the publish step failed — its cause is in the message, not yet classified further
     'publish',
+    // the published version never appeared on the npm registry within the wait
     'network',
-    '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'
+    // the repo wasn't ready when re-checked right before its `gro publish` (origin moved,
+    // a tracked edit, a live session, …) — aborted before any npm side effect
+    'not_ready'
 ]);
 /** Tallied outcome of a publishing run, derived from its events via `summarize_events`. */
 export const PublishingRunSummary = z.strictObject({

package/dist/publishing_event_handler.d.ts

@@ -4,11 +4,13 @@
  * A `PublishingEventHandler` is anything that can receive a `PublishingEvent`. Handlers
  * compose: `multi_handler` fans out, `masking_handler` redacts secrets then forwards.
  * Emission is best-effort and synchronous — an observability sink must never fail or
- * slow a run. The default sink is `null_handler` (drops everything).
+ * slow a run. The executor always captures events for its result (`capture_handler`)
+ * and forwards them to the caller's sink when one is supplied.
  *
  * @module
  */
 import type { PublishingEvent } from './publishing_event.js';
+import type { WriteStdout } from './output_helpers.js';
 /** A sink for publishing events. */
 export interface PublishingEventHandler {
     emit: (event: PublishingEvent) => void;
@@ -17,24 +19,24 @@ export interface PublishingEventHandler {
 export interface CapturingEventHandler extends PublishingEventHandler {
     readonly events: Array<PublishingEvent>;
 }
-/** Drops every event. The default when no handler is supplied. */
-export declare const null_handler: () => PublishingEventHandler;
 /** Collects events in memory. Used to build the run report and in tests. */
 export declare const capture_handler: () => CapturingEventHandler;
 /**
- * Writes each event as one JSON object per line (JSON-lines) to `process.stdout`.
+ * Writes each event as one JSON object per line (JSON-lines) to stdout.
  * Write failures are swallowed — the stream is observability, not control flow.
+ *
+ * @param write_line - writes one line and its newline; defaults to `process.stdout`
  */
-export declare const stdout_handler: () => PublishingEventHandler;
+export declare const stdout_handler: (write_line?: WriteStdout) => PublishingEventHandler;
 /** Fans an event out to every handler in order. */
 export declare const multi_handler: (handlers: Array<PublishingEventHandler>) => PublishingEventHandler;
 /**
- * Wraps a handler, masking secrets in each event's string fields before forwarding.
+ * Wraps a handler, masking secrets in each event's string fields (`mask_secrets`)
+ * before forwarding.
  *
  * @param inner - the handler to forward masked events to
- * @param mask - the masking function, defaults to `mask_secrets`
  */
-export declare const masking_handler: (inner: PublishingEventHandler, mask?: (event: PublishingEvent) => PublishingEvent) => PublishingEventHandler;
+export declare const masking_handler: (inner: PublishingEventHandler) => PublishingEventHandler;
 /** Redacts known secret shapes from a string. */
 export declare const redact_secrets: (text: string) => string;
 /** Returns a copy of the event with secrets redacted from its string-valued fields. */

package/dist/publishing_event_handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"publishing_event_handler.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/publishing_event_handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,oCAAoC;AACpC,MAAM,WAAW,sBAAsB;IACtC,IAAI,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;CACvC;AAED,oEAAoE;AACpE,MAAM,WAAW,qBAAsB,SAAQ,sBAAsB;IACpE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;CACxC;AAED,kEAAkE;AAClE,eAAO,MAAM,YAAY,QAAO,sBAE9B,CAAC;AAEH,4EAA4E;AAC5E,eAAO,MAAM,eAAe,QAAO,qBAQlC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAO,sBAQhC,CAAC;AAEH,mDAAmD;AACnD,eAAO,MAAM,aAAa,GAAI,UAAU,KAAK,CAAC,sBAAsB,CAAC,KAAG,sBAMtE,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAC3B,OAAO,sBAAsB,EAC7B,OAAM,CAAC,KAAK,EAAE,eAAe,KAAK,eAA8B,KAC9D,sBAID,CAAC;AAWH,iDAAiD;AACjD,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,MACgD,CAAC;AAE/F,uFAAuF;AACvF,eAAO,MAAM,YAAY,GAAI,OAAO,eAAe,KAAG,eAMrD,CAAC"}
+{"version":3,"file":"publishing_event_handler.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/publishing_event_handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAMvD,oCAAoC;AACpC,MAAM,WAAW,sBAAsB;IACtC,IAAI,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;CACvC;AAED,oEAAoE;AACpE,MAAM,WAAW,qBAAsB,SAAQ,sBAAsB;IACpE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;CACxC;AAED,4EAA4E;AAC5E,eAAO,MAAM,eAAe,QAAO,qBAQlC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAC1B,aAAY,WAAuC,KACjD,sBAQD,CAAC;AAEH,mDAAmD;AACnD,eAAO,MAAM,aAAa,GAAI,UAAU,KAAK,CAAC,sBAAsB,CAAC,KAAG,sBAMtE,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,sBAAsB,KAAG,sBAI9D,CAAC;AAWH,iDAAiD;AACjD,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,MACgD,CAAC;AAE/F,uFAAuF;AACvF,eAAO,MAAM,YAAY,GAAI,OAAO,eAAe,KAAG,eAMrD,CAAC"}

package/dist/publishing_event_handler.js

@@ -4,14 +4,14 @@
  * A `PublishingEventHandler` is anything that can receive a `PublishingEvent`. Handlers
  * compose: `multi_handler` fans out, `masking_handler` redacts secrets then forwards.
  * Emission is best-effort and synchronous — an observability sink must never fail or
- * slow a run. The default sink is `null_handler` (drops everything).
+ * slow a run. The executor always captures events for its result (`capture_handler`)
+ * and forwards them to the caller's sink when one is supplied.
  *
  * @module
  */
-/** Drops every event. The default when no handler is supplied. */
-export const null_handler = () => ({
-    emit: () => { }
-});
+const write_process_stdout_line = (line) => {
+    process.stdout.write(line + '\n');
+};
 /** Collects events in memory. Used to build the run report and in tests. */
 export const capture_handler = () => {
     const events = [];
@@ -23,13 +23,15 @@ export const capture_handler = () => {
     };
 };
 /**
- * Writes each event as one JSON object per line (JSON-lines) to `process.stdout`.
+ * Writes each event as one JSON object per line (JSON-lines) to stdout.
  * Write failures are swallowed — the stream is observability, not control flow.
+ *
+ * @param write_line - writes one line and its newline; defaults to `process.stdout`
  */
-export const stdout_handler = () => ({
+export const stdout_handler = (write_line = write_process_stdout_line) => ({
     emit: (event) => {
         try {
-            process.stdout.write(JSON.stringify(event) + '\n');
+            write_line(JSON.stringify(event));
         }
         catch {
             // best-effort: a logging sink must never fail a run
@@ -45,14 +47,14 @@ export const multi_handler = (handlers) => ({
     }
 });
 /**
- * Wraps a handler, masking secrets in each event's string fields before forwarding.
+ * Wraps a handler, masking secrets in each event's string fields (`mask_secrets`)
+ * before forwarding.
  *
  * @param inner - the handler to forward masked events to
- * @param mask - the masking function, defaults to `mask_secrets`
  */
-export const masking_handler = (inner, mask = mask_secrets) => ({
+export const masking_handler = (inner) => ({
     emit: (event) => {
-        inner.emit(mask(event));
+        inner.emit(mask_secrets(event));
     }
 });
 // Minimal redaction rules: npm auth tokens (bare or registry-scoped), `SECRET_*`

package/dist/publishing_plan.d.ts

@@ -2,7 +2,6 @@ import type { Logger } from '@fuzdev/fuz_util/log.ts';
 import { type LocalRepo } from './local_repo.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 {
     package_name: string;
     from: string;
@@ -15,6 +14,19 @@ export interface VersionChange {
     existing_bump?: BumpType;
     required_bump?: BumpType;
 }
+/**
+ * How a version change arises in the plan: from the package's own changesets
+ * (`explicit`), from its changesets with the bump raised to what a breaking
+ * dependency requires (`escalation`), or from a changeset the executor
+ * generates for a dependency update (`auto`).
+ */
+export type VersionChangeKind = 'explicit' | 'escalation' | 'auto';
+/**
+ * Classifies a version change — the one classification the plan's logger,
+ * markdown, and side-effect preview share. A change without changesets of its
+ * own is `auto` even if its bump was raised.
+ */
+export declare const version_change_kind: (change: VersionChange) => VersionChangeKind;
 export interface DependencyUpdate {
     dependent_package: string;
     updated_dependency: string;
@@ -81,7 +93,10 @@ export interface PublishingPlan {
     dependency_updates: Array<DependencyUpdate>;
     breaking_cascades: Map<string, Array<string>>;
     warnings: Array<string>;
+    /** Informational sentences, not warnings: excluded non-npm repos, dev dependency cycles. */
     info: Array<string>;
+    /** Package names with no changesets and no version change — nothing to publish. */
+    no_changes: Array<string>;
     errors: Array<string>;
     verbose_data?: VerboseData;
 }

package/dist/publishing_plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"publishing_plan.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/publishing_plan.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"publishing_plan.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/publishing_plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAGtD,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE9D,OAAO,EACN,KAAK,QAAQ,EAIb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAS3D,MAAM,WAAW,aAAa;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,QAAQ,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,aAAa,CAAC,EAAE,QAAQ,CAAC;IACzB,aAAa,CAAC,EAAE,QAAQ,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,CAAC;AAEnE;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,aAAa,KAAG,iBAC+B,CAAC;AAE5F,MAAM,WAAW,gBAAgB;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,cAAc,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;CAC9D;AAGD,MAAM,WAAW,sBAAsB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,QAAQ,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzE;AAED,MAAM,WAAW,uBAAuB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtC,aAAa,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,SAAS,GAAG,gBAAgB,GAAG,YAAY,GAAG,MAAM,CAAC;IAC7D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACzC,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzE;AAED,MAAM,WAAW,mBAAmB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC3B,iBAAiB,EAAE,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACjD,UAAU,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACpC,kBAAkB,EAAE,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACnD,aAAa,EAAE,mBAAmB,CAAC;IACnC,gBAAgB,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC9B,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,eAAe,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IACtC,kBAAkB,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC5C,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9C,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxB,4FAA4F;IAC5F,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACpB,mFAAmF;IACnF,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1B,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACtB,YAAY,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,mBAAmB,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAcD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GACpC,WAAW,KAAK,CAAC,SAAS,CAAC,EAC3B,UAAS,mBAAwB,KAC/B,OAAO,CAAC,cAAc,CA+IxB,CAAC"}