@fuzdev/fuz_gitops 0.72.0 → 0.74.0

package/README.md

@@ -14,8 +14,8 @@ fuz_gitops is alternative to the monorepo pattern that more loosely couples repo
 With fuz_gitops you can:
 
 - dynamically compose repos
-- fetch metadata about collections of repos and import it as typesafe JSON (using
-  [Gro's public package patterns](https://github.com/fuzdev/gro/blob/main/src/docs/gro_plugin_sveltekit_app.md#well_known_package_json))
+- fetch metadata about collections of repos and import it as typesafe JSON (using fuz_ui's
+  [vite_plugin_pkg_json](https://ui.fuz.dev/docs/vite_plugin_pkg_json))
 - publish a generated docs website for your collections of repos
 - import its components to view and interact with repo collection metadata
 - publish metadata about your collections of repos to the web for other users and tools
@@ -96,12 +96,19 @@ gro gitops_sync --download    # clone missing repos first
 ### Diagnostic commands (read-only)
 
 ```bash
-gro gitops_validate   # run all validation checks (analyze + plan + dry run)
-gro gitops_analyze    # analyze dependency graph and detect cycles
-gro gitops_plan       # generate publishing plan showing version changes and cascades
-gro gitops_publish    # simulate publishing without side effects (dry run default)
+gro gitops_validate           # run all validation checks (analyze + plan + dry run)
+gro gitops_analyze            # analyze dependency graph and detect cycles
+gro gitops_plan               # generate publishing plan showing version changes and cascades
+gro gitops_publish            # simulate publishing without side effects (dry run default)
+gro gitops_publish --preview  # show the ordered side-effects a --wetrun would perform
 ```
 
+These read each repo's working tree exactly as it sits on disk — no branch
+switching, pulling, or installing — so they're safe to run with feature
+branches checked out and uncommitted changes. Pass `--sync` to refresh repos
+(switch to the configured branch, pull, install) before running, or run
+`gro gitops_sync` first.
+
 ### Publishing packages
 
 ```bash
@@ -119,8 +126,8 @@ gro gitops_publish --wetrun --no-plan  # skip plan confirmation
 - ./docs/troubleshooting.md - Common errors and
   debugging tips
 
-Getting started as a dev? Start with [Gro](https://github.com/grogarden/gro)
-and the [Fuz template](https://github.com/fuz-dev/fuz_template).
+Getting started as a dev? Start with [Gro](https://github.com/fuzdev/gro)
+and the [Fuz template](https://github.com/fuzdev/fuz_template).
 
 TODO
 

package/dist/PageHeader.svelte

@@ -1,5 +1,5 @@
 <script lang="ts">
-	import type {PackageJson} from '@fuzdev/fuz_util/package_json.js';
+	import type {PkgJson} from '@fuzdev/fuz_util/pkg_json.js';
 	import Breadcrumb from '@fuzdev/fuz_ui/Breadcrumb.svelte';
 	import type {Snippet} from 'svelte';
 	import type {SvelteHTMLElements} from 'svelte/elements';
@@ -11,7 +11,7 @@
 		nav,
 		children,
 	}: {
-		repo: {package_json: PackageJson} | {url: string; package_json: null};
+		repo: {pkg_json: PkgJson} | {url: string; pkg_json: null};
 		nav_attrs?: SvelteHTMLElements['nav'];
 		attrs?: SvelteHTMLElements['header'];
 		nav?: Snippet;
@@ -24,7 +24,7 @@
 	{#if nav}
 		{@render nav()}
 	{:else}
-		<nav {...nav_attrs}><Breadcrumb>{repo.package_json?.glyph}</Breadcrumb></nav>
+		<nav {...nav_attrs}><Breadcrumb>{repo.pkg_json?.glyph}</Breadcrumb></nav>
 	{/if}
 </header>
 

package/dist/PageHeader.svelte.d.ts

@@ -1,12 +1,12 @@
-import type { PackageJson } from '@fuzdev/fuz_util/package_json.js';
+import type { PkgJson } from '@fuzdev/fuz_util/pkg_json.js';
 import type { Snippet } from 'svelte';
 import type { SvelteHTMLElements } from 'svelte/elements';
 type $$ComponentProps = {
     repo: {
-        package_json: PackageJson;
+        pkg_json: PkgJson;
     } | {
         url: string;
-        package_json: null;
+        pkg_json: null;
     };
     nav_attrs?: SvelteHTMLElements['nav'];
     attrs?: SvelteHTMLElements['header'];

package/dist/PageHeader.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PageHeader.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/PageHeader.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAElE,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAEvD,KAAK,gBAAgB,GAAI;IACxB,IAAI,EAAE;QAAC,YAAY,EAAE,WAAW,CAAA;KAAC,GAAG;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,IAAI,CAAA;KAAC,CAAC;IACtE,SAAS,CAAC,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACrC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AA6BH,QAAA,MAAM,UAAU,sDAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}
+{"version":3,"file":"PageHeader.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/PageHeader.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,8BAA8B,CAAC;AAE1D,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAEvD,KAAK,gBAAgB,GAAI;IACxB,IAAI,EAAE;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAC,GAAG;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,IAAI,CAAA;KAAC,CAAC;IAC1D,SAAS,CAAC,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACrC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AA6BH,QAAA,MAAM,UAAU,sDAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}

package/dist/changeset_generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"changeset_generator.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/changeset_generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,2BAA2B,CAAC;AAEhE,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAGlD,MAAM,WAAW,uBAAuB;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IACvC,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,eAAO,MAAM,uCAAuC,GACnD,MAAM,SAAS,EACf,SAAS,KAAK,CAAC,uBAAuB,CAAC,EACvC,UAAS;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,YAAY,CAAA;CAAM,KACjD,OAAO,CAAC,MAAM,CAiChB,CAAC;AAwBF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,0BAA0B,GACtC,cAAc,MAAM,EACpB,SAAS,KAAK,CAAC,uBAAuB,CAAC,EACvC,WAAW,OAAO,GAAG,OAAO,GAAG,OAAO,KACpC,MAsCF,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACrC,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,oBAAoB,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,KAC/C,KAAK,CAAC,uBAAuB,CAoB/B,CAAC"}
+{"version":3,"file":"changeset_generator.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/changeset_generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,2BAA2B,CAAC;AAMhE,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAGlD,MAAM,WAAW,uBAAuB;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IACvC,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,eAAO,MAAM,uCAAuC,GACnD,MAAM,SAAS,EACf,SAAS,KAAK,CAAC,uBAAuB,CAAC,EACvC,UAAS;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,YAAY,CAAA;CAAM,KACjD,OAAO,CAAC,MAAM,CAiChB,CAAC;AAWF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,0BAA0B,GACtC,cAAc,MAAM,EACpB,SAAS,KAAK,CAAC,uBAAuB,CAAC,EACvC,WAAW,OAAO,GAAG,OAAO,GAAG,OAAO,KACpC,MAsCF,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACrC,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,oBAAoB,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,KAC/C,KAAK,CAAC,uBAAuB,CAoB/B,CAAC"}

package/dist/changeset_generator.js

@@ -7,7 +7,7 @@
  * @module
  */
 import { join } from 'node:path';
-import { strip_version_prefix } from './version_utils.js';
+import { strip_version_prefix, required_bump_for_dependency_update, } from './version_utils.js';
 import { default_fs_operations } from './operations_defaults.js';
 /**
  * Creates a changeset file for dependency updates.
@@ -40,21 +40,7 @@ export const create_changeset_for_dependency_updates = async (repo, updates, opt
     log?.info(`  Created changeset: ${filename}`);
     return filepath;
 };
-const calculate_required_bump = (repo, updates) => {
-    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';
-};
+const calculate_required_bump = (repo, updates) => required_bump_for_dependency_update(repo.package_json.version || '0.0.0', updates.some((u) => u.breaking));
 /**
  * Generates markdown changeset content for dependency updates.
  *

package/dist/changeset_reader.d.ts

@@ -8,7 +8,7 @@
  */
 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';
 export interface ChangesetInfo {
     filename: string;
     packages: Array<{

package/dist/changeset_reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"changeset_reader.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/changeset_reader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAKpD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,aAAa,CAAC;AAG1C,MAAM,WAAW,aAAa;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,QAAQ,CAAA;KAAC,CAAC,CAAC;IACrD,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,uBAAuB,GACnC,SAAS,MAAM,EACf,iBAAyB,KACvB,aAAa,GAAG,IAmClB,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAChC,UAAU,MAAM,EAChB,MAAM,MAAM,KACV,OAAO,CAAC,aAAa,GAAG,IAAI,CAgB9B,CAAC;AAEF,eAAO,MAAM,eAAe,GAC3B,MAAM,SAAS,EACf,MAAM,MAAM,KACV,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAsB9B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,8BAA8B,GAC1C,YAAY,KAAK,CAAC,aAAa,CAAC,EAChC,cAAc,MAAM,KAClB,QAAQ,GAAG,IAcb,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GAAU,MAAM,SAAS,KAAG,OAAO,CAAC,OAAO,CAarE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAChC,MAAM,SAAS,EACf,MAAM,MAAM,KACV,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,QAAQ,CAAA;CAAC,GAAG,IAAI,CAsBvD,CAAC"}
+{"version":3,"file":"changeset_reader.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/changeset_reader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAKpD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAA6C,KAAK,QAAQ,EAAC,MAAM,oBAAoB,CAAC;AAE7F,MAAM,WAAW,aAAa;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,QAAQ,CAAA;KAAC,CAAC,CAAC;IACrD,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,uBAAuB,GACnC,SAAS,MAAM,EACf,iBAAyB,KACvB,aAAa,GAAG,IAmClB,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAChC,UAAU,MAAM,EAChB,MAAM,MAAM,KACV,OAAO,CAAC,aAAa,GAAG,IAAI,CAgB9B,CAAC;AAEF,eAAO,MAAM,eAAe,GAC3B,MAAM,SAAS,EACf,MAAM,MAAM,KACV,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAsB9B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,8BAA8B,GAC1C,YAAY,KAAK,CAAC,aAAa,CAAC,EAChC,cAAc,MAAM,KAClB,QAAQ,GAAG,IAcb,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GAAU,MAAM,SAAS,KAAG,OAAO,CAAC,OAAO,CAarE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAChC,MAAM,SAAS,EACf,MAAM,MAAM,KACV,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,QAAQ,CAAA;CAAC,GAAG,IAAI,CAsBvD,CAAC"}

package/dist/changeset_reader.js

@@ -161,7 +161,7 @@ export const predict_next_version = async (repo, log) => {
     if (!bump_type) {
         return null;
     }
-    const current_version = repo.library.package_json.version || '0.0.0';
+    const current_version = repo.package_json.version || '0.0.0';
     const next_version = calculate_next_version(current_version, bump_type);
     log?.debug(`  Predicted ${repo.library.name}: ${current_version} → ${next_version} (${bump_type})`);
     return {

package/dist/dependency_graph.d.ts.map

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

package/dist/dependency_graph.js

@@ -24,19 +24,19 @@ export class DependencyGraph {
     init_from_repos(repos) {
         // First pass: create nodes
         for (const repo of repos) {
-            const { library } = repo;
+            const { library, package_json } = repo;
             const node = {
                 name: library.name,
-                version: library.package_json.version || '0.0.0',
+                version: package_json.version || '0.0.0',
                 repo,
                 dependencies: new Map(),
                 dependents: new Set(),
-                publishable: !!library.package_json.private === false, // eslint-disable-line @typescript-eslint/no-unnecessary-boolean-literal-compare
+                publishable: !package_json.private,
             };
             // Extract dependencies
-            const deps = library.package_json.dependencies || EMPTY_OBJECT;
-            const dev_deps = library.package_json.devDependencies || EMPTY_OBJECT;
-            const peer_deps = library.package_json.peerDependencies || EMPTY_OBJECT;
+            const deps = package_json.dependencies || EMPTY_OBJECT;
+            const dev_deps = package_json.devDependencies || EMPTY_OBJECT;
+            const peer_deps = package_json.peerDependencies || EMPTY_OBJECT;
             // Add dependencies, prioritizing prod/peer over dev
             // (if a package appears in multiple dep types, use the stronger constraint)
             for (const [name, version] of Object.entries(deps)) {

package/dist/fetch_repo_data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch_repo_data.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/fetch_repo_data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAEpD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,2BAA2B,CAAC;AAG/D,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAE/C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,GAC3B,gBAAgB,KAAK,CAAC,SAAS,CAAC,EAChC,QAAQ,MAAM,EACd,QAAQ,eAAe,EACvB,MAAM,MAAM,EACZ,cAAU,EACV,qBAAqB,MAAM,KACzB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAiCzB,CAAC"}
+{"version":3,"file":"fetch_repo_data.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/fetch_repo_data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAEpD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,2BAA2B,CAAC;AAG/D,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAE/C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,GAC3B,gBAAgB,KAAK,CAAC,SAAS,CAAC,EAChC,QAAQ,MAAM,EACd,QAAQ,eAAe,EACvB,MAAM,MAAM,EACZ,cAAU,EACV,qBAAqB,MAAM,KACzB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAkCzB,CAAC"}

package/dist/fetch_repo_data.js

@@ -15,7 +15,7 @@ import { fetch_github_check_runs, fetch_github_pull_requests } from './github.js
  */
 export const fetch_repo_data = async (resolved_repos, token, cache, log, delay = 33, github_api_version) => {
     const repos = [];
-    for (const { library, library_json, repo_config } of resolved_repos) {
+    for (const { library, package_json, repo_config } of resolved_repos) {
         const repo_url = library.repo_url;
         // CI status
         await wait(delay);
@@ -39,7 +39,8 @@ export const fetch_repo_data = async (resolved_repos, token, cache, log, delay =
         if (!pull_requests)
             log?.error('failed to fetch issues: ' + repo_url);
         repos.push({
-            library_json,
+            library_json: library.library_json,
+            package_json,
             check_runs,
             pull_requests,
         });

package/dist/git_operations.d.ts

@@ -20,6 +20,11 @@ export declare const git_tag: (tag_name: string, message?: string, options?: Spa
  * Pushes a tag to origin and throws if anything goes wrong.
  */
 export declare const git_push_tag: (tag_name: string, origin?: GitOrigin, options?: SpawnOptions) => Promise<void>;
+/**
+ * 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 declare const git_has_changes: (options?: SpawnOptions) => Promise<boolean>;
 /**
  * Lists uncommitted files in the working tree (`git diff --name-only HEAD`).

package/dist/git_operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git_operations.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/git_operations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAMN,KAAK,SAAS,EACd,KAAK,SAAS,EACd,MAAM,yBAAyB,CAAC;AAEjC;;GAEG;AACH,eAAO,MAAM,OAAO,GACnB,OAAO,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,EAC7B,UAAU,YAAY,KACpB,OAAO,CAAC,IAAI,CAQd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,GAAU,SAAS,MAAM,EAAE,UAAU,YAAY,KAAG,OAAO,CAAC,IAAI,CAOtF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC9B,OAAO,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,EAC7B,SAAS,MAAM,EACf,UAAU,YAAY,KACpB,OAAO,CAAC,IAAI,CAGd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,GACnB,UAAU,MAAM,EAChB,UAAU,MAAM,EAChB,UAAU,YAAY,KACpB,OAAO,CAAC,IAAI,CASd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,GACxB,UAAU,MAAM,EAChB,SAAQ,SAAiC,EACzC,UAAU,YAAY,KACpB,OAAO,CAAC,IAAI,CAOd,CAAC;AAEF,eAAO,MAAM,eAAe,GAAU,UAAU,YAAY,KAAG,OAAO,CAAC,OAAO,CAG7E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,GACtC,UAAU,YAAY,KACpB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAQvB,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAChC,aAAa,MAAM,EACnB,WAAW,MAAM,EACjB,WAAW,MAAM,EACjB,UAAU,YAAY,KACpB,OAAO,CAAC,OAAO,CAOjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,GAAU,UAAU,MAAM,EAAE,UAAU,YAAY,KAAG,OAAO,CAAC,IAAI,CAStF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAU,UAAU,YAAY,KAAG,OAAO,CAAC,IAAI,CAOxE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC7B,QAAQ,SAAS,EACjB,OAAM,OAAc,EACpB,UAAU,YAAY,KACpB,OAAO,CAAC,IAAI,CAoBd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gCAAgC,GAAU,UAAU,YAAY,KAAG,OAAO,CAAC,MAAM,CAM7F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gCAAgC,GAC5C,SAAS,MAAM,EACf,UAAU,YAAY,KACpB,OAAO,CAAC,MAAM,CAMhB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oCAAoC,GAChD,UAAU,YAAY,KACpB,OAAO,CAAC,OAAO,CAGjB,CAAC;AAEF,eAAO,MAAM,cAAc,GAC1B,SAAQ,MAAiB,EACzB,UAAU,YAAY,KACpB,OAAO,CAAC,OAAO,CAQjB,CAAC"}
+{"version":3,"file":"git_operations.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/git_operations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAMN,KAAK,SAAS,EACd,KAAK,SAAS,EACd,MAAM,yBAAyB,CAAC;AAEjC;;GAEG;AACH,eAAO,MAAM,OAAO,GACnB,OAAO,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,EAC7B,UAAU,YAAY,KACpB,OAAO,CAAC,IAAI,CAQd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,GAAU,SAAS,MAAM,EAAE,UAAU,YAAY,KAAG,OAAO,CAAC,IAAI,CAOtF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC9B,OAAO,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,EAC7B,SAAS,MAAM,EACf,UAAU,YAAY,KACpB,OAAO,CAAC,IAAI,CAGd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,GACnB,UAAU,MAAM,EAChB,UAAU,MAAM,EAChB,UAAU,YAAY,KACpB,OAAO,CAAC,IAAI,CASd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,GACxB,UAAU,MAAM,EAChB,SAAQ,SAAiC,EACzC,UAAU,YAAY,KACpB,OAAO,CAAC,IAAI,CAOd,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAU,UAAU,YAAY,KAAG,OAAO,CAAC,OAAO,CAG7E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,GACtC,UAAU,YAAY,KACpB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAQvB,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAChC,aAAa,MAAM,EACnB,WAAW,MAAM,EACjB,WAAW,MAAM,EACjB,UAAU,YAAY,KACpB,OAAO,CAAC,OAAO,CAOjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,GAAU,UAAU,MAAM,EAAE,UAAU,YAAY,KAAG,OAAO,CAAC,IAAI,CAStF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAU,UAAU,YAAY,KAAG,OAAO,CAAC,IAAI,CAOxE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC7B,QAAQ,SAAS,EACjB,OAAM,OAAc,EACpB,UAAU,YAAY,KACpB,OAAO,CAAC,IAAI,CAoBd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gCAAgC,GAAU,UAAU,YAAY,KAAG,OAAO,CAAC,MAAM,CAM7F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gCAAgC,GAC5C,SAAS,MAAM,EACf,UAAU,YAAY,KACpB,OAAO,CAAC,MAAM,CAMhB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oCAAoC,GAChD,UAAU,YAAY,KACpB,OAAO,CAAC,OAAO,CAGjB,CAAC;AAEF,eAAO,MAAM,cAAc,GAC1B,SAAQ,MAAiB,EACzB,UAAU,YAAY,KACpB,OAAO,CAAC,OAAO,CAQjB,CAAC"}

package/dist/git_operations.js

@@ -45,6 +45,11 @@ export const git_push_tag = async (tag_name, origin = 'origin', options) => {
         throw Error(`git_push_tag failed for tag '${tag_name}' with ${spawn_result_to_message(result)}${stderr ? ': ' + stderr.trim() : ''}`);
     }
 };
+/**
+ * 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) => {
     const { stdout } = await spawn_out('git', ['status', '--porcelain'], options);
     return stdout ? stdout.trim().length > 0 : false;

package/dist/gitops_analyze.task.d.ts

@@ -10,6 +10,7 @@ export declare const Args: z.ZodObject<{
         markdown: "markdown";
     }>>;
     outfile: z.ZodOptional<z.ZodString>;
+    sync: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strict>;
 export type Args = z.infer<typeof Args>;
 /** @nodocs */

package/dist/gitops_analyze.task.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gitops_analyze.task.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/gitops_analyze.task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,aAAa,CAAC;AACtC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAgBtB,cAAc;AACd,eAAO,MAAM,IAAI;;;;;;;;;kBAcf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,cAAc;AACd,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CAkC3B,CAAC"}
+{"version":3,"file":"gitops_analyze.task.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/gitops_analyze.task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,aAAa,CAAC;AACtC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAgBtB,cAAc;AACd,eAAO,MAAM,IAAI;;;;;;;;;;kBAqBf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,cAAc;AACd,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CAsB3B,CAAC"}

package/dist/gitops_analyze.task.js

@@ -1,8 +1,7 @@
 import { z } from 'zod';
 import { styleText as st } from 'node:util';
 import { get_gitops_ready } from './gitops_task_helpers.js';
-import { DependencyGraphBuilder } from './dependency_graph.js';
-import { validate_dependency_graph } from './graph_validation.js';
+import { analyze_repos } from './graph_validation.js';
 import { format_wildcard_dependencies, format_dev_cycles, format_production_cycles, } from './log_helpers.js';
 import { format_and_output } from './output_helpers.js';
 import { GITOPS_CONFIG_PATH_DEFAULT } from './gitops_constants.js';
@@ -21,27 +20,23 @@ 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),
 });
 /** @nodocs */
 export const task = {
     Args,
     summary: 'analyze dependency structure and relationships across repos',
     run: async ({ args, log }) => {
-        const { config, dir, format, outfile } = args;
-        // Get repos ready (without downloading)
-        const { local_repos } = await get_gitops_ready({ config, dir, download: false, 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;
+        const { config, dir, format, outfile, sync } = args;
+        // 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 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 = {
             repos: local_repos,

package/dist/gitops_plan.task.d.ts

@@ -11,6 +11,7 @@ export declare const Args: z.ZodObject<{
     }>>;
     outfile: z.ZodOptional<z.ZodString>;
     verbose: z.ZodDefault<z.ZodBoolean>;
+    sync: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strict>;
 export type Args = z.infer<typeof Args>;
 /**

package/dist/gitops_plan.task.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gitops_plan.task.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/gitops_plan.task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,aAAa,CAAC;AACtC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAatB,cAAc;AACd,eAAO,MAAM,IAAI;;;;;;;;;;kBAef,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CAkC3B,CAAC"}
+{"version":3,"file":"gitops_plan.task.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/gitops_plan.task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,aAAa,CAAC;AACtC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAatB,cAAc;AACd,eAAO,MAAM,IAAI;;;;;;;;;;;kBAsBf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CAmC3B,CAAC"}

package/dist/gitops_plan.task.js

@@ -20,6 +20,12 @@ 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),
 });
 /**
  * Generate a publishing plan showing what would happen during multi-repo publishing.
@@ -36,13 +42,14 @@ export const task = {
     summary: 'generate a publishing plan based on changesets',
     Args,
     run: async ({ args, log }) => {
-        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,
         });
         if (local_repos.length === 0) {

package/dist/gitops_publish.task.d.ts

@@ -17,12 +17,12 @@ export declare const Args: z.ZodObject<{
     }>>;
     deploy: z.ZodDefault<z.ZodBoolean>;
     plan: z.ZodDefault<z.ZodBoolean>;
-    'no-plan': z.ZodDefault<z.ZodBoolean>;
     max_wait: z.ZodDefault<z.ZodNumber>;
-    skip_install: z.ZodDefault<z.ZodBoolean>;
     emit_json: z.ZodDefault<z.ZodBoolean>;
     outfile: z.ZodOptional<z.ZodString>;
     verbose: z.ZodDefault<z.ZodBoolean>;
+    sync: z.ZodDefault<z.ZodBoolean>;
+    preview: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strict>;
 export type Args = z.infer<typeof Args>;
 /** @nodocs */

package/dist/gitops_publish.task.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gitops_publish.task.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/gitops_publish.task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,aAAa,CAAC;AACtC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAetB,cAAc;AACd,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;kBAsCf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,cAAc;AACd,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CA+F3B,CAAC"}
+{"version":3,"file":"gitops_publish.task.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/gitops_publish.task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAiBtB,cAAc;AACd,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;kBA4Cf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,cAAc;AACd,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CAiH3B,CAAC"}

package/dist/gitops_publish.task.js

@@ -2,9 +2,11 @@ import { z } from 'zod';
 import { createInterface } from 'node:readline/promises';
 import { styleText as st } from 'node:util';
 import { get_gitops_ready } from './gitops_task_helpers.js';
-import { publish_repos, } from './multi_repo_publisher.js';
+import { execute_publishing_plan, } from './multi_repo_publisher.js';
 import { stdout_handler } from './publishing_event_handler.js';
 import { generate_publishing_plan, log_publishing_plan } from './publishing_plan.js';
+import { derive_publish_steps, format_publish_steps } from './publish_steps.js';
+import { decide_publish_gate, publish_run_failed } from './publish_gate.js';
 import { format_and_output } from './output_helpers.js';
 import { GITOPS_CONFIG_PATH_DEFAULT, GITOPS_NPM_WAIT_TIMEOUT_DEFAULT } from './gitops_constants.js';
 /** @nodocs */
@@ -27,47 +29,64 @@ export const Args = z.strictObject({
         .meta({ description: 'output format' })
         .default('stdout'),
     deploy: z.boolean().meta({ description: 'deploy all repos after publishing' }).default(false),
-    plan: z.boolean().meta({ description: 'dual of no-plan' }).default(true),
-    'no-plan': z
+    plan: z
         .boolean()
-        .meta({ description: 'skip plan confirmation before publishing' })
-        .default(false),
+        .meta({ description: 'show the plan and confirm before publishing; --no-plan to skip' })
+        .default(true),
     max_wait: z
         .number()
         .meta({ description: 'max time to wait for npm propagation in ms' })
         .default(GITOPS_NPM_WAIT_TIMEOUT_DEFAULT),
-    skip_install: z
-        .boolean()
-        .meta({ description: 'skip npm install after dependency updates' })
-        .default(false),
     emit_json: z
         .boolean()
         .meta({ description: 'stream structured publishing events as JSON-lines to stdout' })
         .default(false),
     outfile: z.string().meta({ description: 'write output to file instead of logging' }).optional(),
     verbose: z.boolean().meta({ description: 'show additional details in plan output' }).default(false),
+    sync: z
+        .boolean()
+        .meta({
+        description: 'sync repos (switch branch, pull, install) before the dry run instead of reading the working tree as-is; always on for --wetrun',
+    })
+        .default(false),
+    preview: z
+        .boolean()
+        .meta({ description: 'show the ordered side-effects a --wetrun would perform' })
+        .default(false),
 });
 /** @nodocs */
 export const task = {
     summary: 'publish all repos in dependency order',
     Args,
     run: async ({ args, log }) => {
-        const { config, dir, peer_strategy, wetrun, format, deploy, plan, max_wait, skip_install, emit_json, outfile, verbose, } = args;
-        // Load repos
+        const { config, dir, peer_strategy, wetrun, format, deploy, plan, max_wait, emit_json, outfile, verbose, sync, preview, } = args;
+        // Load repos. A dry run reads the working tree as-is unless `--sync`;
+        // a real publish (`--wetrun`) always syncs so preflight sees the canonical branches.
         const { local_repos: repos } = await get_gitops_ready({
             config,
             dir,
             download: false, // Don't download if missing
+            sync: sync || wetrun,
             log,
         });
-        // Show plan if requested (skip for dry runs)
-        if (plan && wetrun) {
+        // Generate the plan once; the executor consumes this exact plan (no second pass).
+        const publishing_plan = await generate_publishing_plan(repos, { verbose });
+        const preview_steps = preview ? derive_publish_steps(publishing_plan, { deploy }) : null;
+        // Decide whether to show the plan + confirm, block, or proceed (the decision table lives
+        // in `decide_publish_gate`; readline + exit stay here at the edge).
+        const gate = decide_publish_gate({ wetrun, show_plan: plan, plan: publishing_plan });
+        // A real publish that shows its plan prints it first — including before a `blocked` throw,
+        // so the operator sees the errors that blocked it.
+        if (gate.action !== 'proceed') {
             log.info(st('cyan', 'Publishing Plan'));
-            const plan_result = await generate_publishing_plan(repos, { log, verbose });
-            log_publishing_plan(plan_result, log, { verbose });
-            if (plan_result.errors.length > 0) {
-                throw new Error('Cannot proceed with publishing due to errors');
-            }
+            log_publishing_plan(publishing_plan, log, { verbose });
+        }
+        if (gate.action === 'blocked') {
+            throw new Error(gate.message);
+        }
+        else if (gate.action === 'confirm') {
+            if (preview_steps)
+                log_preview(preview_steps, log);
             // Ask for confirmation
             log.info(st('yellow', '⚠️  This will publish the packages shown above.'));
             process.stdout.write('Continue with publishing? (y/n): ');
@@ -77,14 +96,18 @@ export const task = {
                 process.exit(0);
             }
         }
+        else if (preview_steps && format === 'stdout') {
+            // proceed (dry run or --no-plan): only render to stdout for the human format;
+            // json/markdown carry the preview in their structured output, so logging here too
+            // would corrupt that stream.
+            log_preview(preview_steps, log);
+        }
         // Publishing options
         const options = {
             wetrun,
-            update_deps: true, // Always update dependencies
             version_strategy: peer_strategy,
             deploy,
             max_wait,
-            skip_install,
             log,
             // Live JSON-lines stream when requested; events also surface on the result.
             events: emit_json ? stdout_handler() : undefined,
@@ -93,7 +116,7 @@ export const task = {
         let result;
         let fatal_error = null;
         try {
-            result = await publish_repos(repos, options);
+            result = await execute_publishing_plan(repos, publishing_plan, options);
         }
         catch (error) {
             // Construct a failure result for fatal errors so output can still be generated
@@ -106,33 +129,42 @@ export const task = {
                 duration: 0,
                 events: [],
                 summary: { total: 0, published: 0, failed: 1, skipped: 0, duration: 0 },
+                plan_errors: publishing_plan.errors,
+                plan_warnings: publishing_plan.warnings,
             };
         }
         // Format and output result (always runs, even on fatal errors)
-        // Note: stdout format is handled by publish_repos function's logging
+        // Note: stdout format is handled by the executor's logging
         if (format !== 'stdout') {
-            await format_and_output({ result, fatal_error }, create_publish_formatters(), {
+            await format_and_output({ result, fatal_error, preview_steps }, create_publish_formatters(), {
                 format,
                 outfile,
                 log,
             });
         }
         // Exit with error if failed
-        if (!result.ok || fatal_error) {
+        if (publish_run_failed(result, fatal_error)) {
             process.exit(1);
         }
     },
 };
 const create_publish_formatters = () => ({
-    json: (data) => JSON.stringify(data.result, null, 2),
-    markdown: (data) => format_result_markdown(data.result, data.fatal_error),
+    json: (data) => JSON.stringify(data.preview_steps ? { ...data.result, preview: data.preview_steps } : data.result, null, 2),
+    markdown: (data) => format_result_markdown(data.result, data.fatal_error, data.preview_steps),
     stdout: () => {
-        // stdout format is handled by publish_repos function's logging
+        // stdout format is handled by the executor's logging
         // This should never be called due to early return in task
     },
 });
+/** Logs the ordered side-effect preview to stdout. */
+const log_preview = (steps, log) => {
+    log.info(st('cyan', '\nSide-effect preview (what a real publish would perform):'));
+    for (const line of format_publish_steps(steps)) {
+        log.info(st('dim', `  ${line}`));
+    }
+};
 // Format the publishing result as markdown
-const format_result_markdown = (result, fatal_error) => {
+const format_result_markdown = (result, fatal_error, preview_steps) => {
     const lines = [];
     lines.push('# Publishing Result');
     lines.push('');
@@ -168,6 +200,29 @@ const format_result_markdown = (result, fatal_error) => {
             lines.push(`- \`${name}\`: ${error.message}`);
         }
     }
+    if (result.plan_warnings.length > 0) {
+        lines.push('');
+        lines.push('## Plan Warnings');
+        lines.push('');
+        for (const warning of result.plan_warnings)
+            lines.push(`- ${warning}`);
+    }
+    if (result.plan_errors.length > 0) {
+        lines.push('');
+        lines.push('## Plan Errors');
+        lines.push('');
+        for (const plan_error of result.plan_errors)
+            lines.push(`- ${plan_error}`);
+    }
+    if (preview_steps) {
+        lines.push('');
+        lines.push('## Side-Effect Preview');
+        lines.push('');
+        lines.push('```');
+        for (const line of format_publish_steps(preview_steps))
+            lines.push(line);
+        lines.push('```');
+    }
     return lines;
 };
 /**

package/dist/gitops_run.task.d.ts

@@ -1,13 +1,14 @@
 import { type Task } from '@fuzdev/gro';
 import { z } from 'zod';
 export declare const Args: z.ZodObject<{
-    command: z.ZodString;
+    _: z.ZodDefault<z.ZodArray<z.ZodString>>;
     config: z.ZodDefault<z.ZodString>;
     concurrency: z.ZodDefault<z.ZodNumber>;
     format: z.ZodDefault<z.ZodEnum<{
         text: "text";
         json: "json";
     }>>;
+    outfile: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type Args = z.infer<typeof Args>;
 export declare const task: Task<Args>;

package/dist/gitops_run.task.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gitops_run.task.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/gitops_run.task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,IAAI,EAAC,MAAM,aAAa,CAAC;AACjD,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAStB,eAAO,MAAM,IAAI;;;;;;;;kBAaf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAaxC,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CAgL3B,CAAC"}
+{"version":3,"file":"gitops_run.task.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/gitops_run.task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,IAAI,EAAC,MAAM,aAAa,CAAC;AACjD,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAUtB,eAAO,MAAM,IAAI;;;;;;;;;kBAmBf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAaxC,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CAyM3B,CAAC"}