@fuzdev/fuz_gitops 0.72.0 → 0.73.0

package/README.md

@@ -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/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.library.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/dependency_graph.js

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

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"}

package/dist/gitops_run.task.js

@@ -2,12 +2,15 @@ import { TaskError } from '@fuzdev/gro';
 import { z } from 'zod';
 import { map_concurrent_settled } from '@fuzdev/fuz_util/async.js';
 import { spawn_out } from '@fuzdev/fuz_util/process.js';
+import { writeFile } from 'node:fs/promises';
 import { styleText as st } from 'node:util';
 import { resolve } from 'node:path';
 import { get_repo_paths } from './repo_ops.js';
 import { GITOPS_CONCURRENCY_DEFAULT, GITOPS_CONFIG_PATH_DEFAULT } from './gitops_constants.js';
 export const Args = z.strictObject({
-    command: z.string().meta({ description: 'shell command to run in each repo' }),
+    // Positional rest args (gro convention) so `gro gitops_run "npm test"` works;
+    // joined with spaces and passed to `sh -c`, so quote commands that contain flags.
+    _: z.array(z.string()).meta({ description: 'shell command to run in each repo' }).default([]),
     config: z
         .string()
         .meta({ description: 'path to the gitops config file' })
@@ -19,12 +22,20 @@ export const Args = z.strictObject({
         .meta({ description: 'maximum number of repos to run in parallel' })
         .default(GITOPS_CONCURRENCY_DEFAULT),
     format: z.enum(['text', 'json']).meta({ description: 'output format' }).default('text'),
+    outfile: z
+        .string()
+        .meta({ description: 'with --format json, write clean JSON to this file instead of stdout' })
+        .optional(),
 });
 export const task = {
     Args,
     summary: 'run a shell command across all repos in parallel',
     run: async ({ args, log }) => {
-        const { command, config, concurrency, format } = args;
+        const { _, config, concurrency, format, outfile } = args;
+        const command = _.join(' ').trim();
+        if (!command) {
+            throw new TaskError('No command provided, e.g. `gro gitops_run "npm test"`');
+        }
         // Get repo paths (lightweight, no library-metadata loading needed)
         const config_path = resolve(config);
         const repos = await get_repo_paths(config_path);
@@ -113,18 +124,40 @@ export const task = {
                     duration_ms: Math.round(total_duration_ms),
                 },
             };
-            // eslint-disable-next-line no-console
-            console.log(JSON.stringify(json_output, null, 2));
+            const json = JSON.stringify(json_output, null, 2);
+            if (outfile) {
+                // Clean machine-readable output, free of gro's logging prefixes.
+                await writeFile(outfile, json);
+                log.info(`wrote JSON output to ${outfile}`);
+            }
+            else {
+                // eslint-disable-next-line no-console
+                console.log(json);
+            }
         }
         else {
             // Text format
             log.info(''); // blank line
-            // Show successes
+            // Show successes, including the command's output so read-only commands
+            // (`git rev-parse`, `cat package.json`, …) are useful without `--format json`.
             if (successes.length > 0) {
                 log.info(st('green', `✓ ${successes.length} succeeded:`));
                 for (const result of successes) {
-                    const duration = `${Math.round(result.duration_ms)}ms`;
-                    log.info(st('gray', `  ${result.repo_name} ${st('blue', `(${duration})`)}`));
+                    const duration = st('blue', `(${Math.round(result.duration_ms)}ms)`);
+                    const label = st('gray', `  ${result.repo_name}`);
+                    const out = result.stdout.trim();
+                    const out_lines = out ? out.split('\n') : [];
+                    if (out_lines.length <= 1) {
+                        // single-line (or empty) output inline after the repo name
+                        log.info(out ? `${label} ${out} ${duration}` : `${label} ${duration}`);
+                    }
+                    else {
+                        // multi-line output indented under the repo
+                        log.info(`${label} ${duration}`);
+                        for (const line of out_lines) {
+                            log.info(st('gray', `    ${line}`));
+                        }
+                    }
                 }
             }
             // Show failures with details

package/dist/gitops_sync.task.d.ts

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

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

@@ -1 +1 @@
-{"version":3,"file":"gitops_sync.task.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/gitops_sync.task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,IAAI,EAAC,MAAM,aAAa,CAAC;AACjD,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAiBtB,cAAc;AACd,eAAO,MAAM,IAAI;;;;;;kBAkBf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CAqF3B,CAAC"}
+{"version":3,"file":"gitops_sync.task.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/gitops_sync.task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,IAAI,EAAC,MAAM,aAAa,CAAC;AACjD,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAiBtB,cAAc;AACd,eAAO,MAAM,IAAI;;;;;;;kBAyBf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CA6F3B,CAAC"}

package/dist/gitops_sync.task.js

@@ -32,6 +32,12 @@ export const Args = z.strictObject({
         .boolean()
         .meta({ description: 'check repos are ready without fetching remote data' })
         .default(false),
+    allow_dirty: z
+        .boolean()
+        .meta({
+        description: 'sync (switch branch, pull) tolerating uncommitted changes instead of failing on a dirty workspace',
+    })
+        .default(false),
 });
 /**
  * This is a task not a `.gen.` file because it makes network calls.
@@ -42,8 +48,16 @@ export const task = {
     Args,
     summary: 'syncs local repos and generates UI data from repo metadata',
     run: async ({ args, log, svelte_config, invoke_task }) => {
-        const { config, dir, outdir = svelte_config.routes_path, download, check } = args;
-        const { local_repos } = await get_gitops_ready({ config, dir, download, log });
+        const { config, dir, outdir = svelte_config.routes_path, download, check, allow_dirty } = args;
+        // `gitops_sync` is the task whose job is to mutate working trees, so it always syncs.
+        const { local_repos } = await get_gitops_ready({
+            config,
+            dir,
+            download,
+            sync: true,
+            allow_dirty,
+            log,
+        });
         const outfile_json = resolve(outdir, 'repos.json');
         const outfile_ts = resolve(outdir, 'repos.ts');
         // This searches the parent directory for the env var, so we don't use SvelteKit's $env imports