@fuzdev/fuz_gitops 0.57.0 → 0.59.0

package/dist/local_repo.js

@@ -4,7 +4,9 @@ import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { TaskError } from '@ryanatkn/gro';
 import { spawn } from '@fuzdev/fuz_util/process.js';
+import { map_concurrent_settled } from '@fuzdev/fuz_util/async.js';
 import { default_git_operations, default_npm_operations } from './operations_defaults.js';
+import { GITOPS_CONCURRENCY_DEFAULT } from './gitops_constants.js';
 /**
  * Loads repo data with automatic syncing and dependency management.
  *
@@ -162,10 +164,39 @@ export const local_repos_ensure = async ({ resolved_config, repos_dir, gitops_co
     }
     return local_repo_paths;
 };
-export const local_repos_load = async ({ local_repo_paths, log, git_ops = default_git_operations, npm_ops = default_npm_operations, }) => {
+export const local_repos_load = async ({ local_repo_paths, log, git_ops = default_git_operations, npm_ops = default_npm_operations, parallel = true, concurrency = GITOPS_CONCURRENCY_DEFAULT, }) => {
+    if (!parallel) {
+        // Sequential loading (original behavior)
+        const loaded = [];
+        for (const local_repo_path of local_repo_paths) {
+            loaded.push(await local_repo_load({ local_repo_path, log, git_ops, npm_ops })); // eslint-disable-line no-await-in-loop
+        }
+        return loaded;
+    }
+    // Parallel loading with concurrency limit
+    const results = await map_concurrent_settled(local_repo_paths, async (local_repo_path) => {
+        return local_repo_load({ local_repo_path, log, git_ops, npm_ops });
+    }, concurrency);
+    // Check for failures and collect successes
     const loaded = [];
-    for (const local_repo_path of local_repo_paths) {
-        loaded.push(await local_repo_load({ local_repo_path, log, git_ops, npm_ops })); // eslint-disable-line no-await-in-loop
+    const errors = [];
+    for (let i = 0; i < results.length; i++) {
+        const result = results[i];
+        if (result.status === 'fulfilled') {
+            loaded.push(result.value);
+        }
+        else {
+            const repo_path = local_repo_paths[i];
+            errors.push({
+                repo_name: repo_path.repo_name,
+                error: String(result.reason),
+            });
+        }
+    }
+    // If any repos failed to load, throw with details
+    if (errors.length > 0) {
+        const error_details = errors.map((e) => `  ${e.repo_name}: ${e.error}`).join('\n');
+        throw new TaskError(`Failed to load ${errors.length} repos:\n${error_details}`);
     }
     return loaded;
 };

package/dist/multi_repo_publisher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"multi_repo_publisher.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/multi_repo_publisher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAKpD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAsB,KAAK,eAAe,EAAC,MAAM,yBAAyB,CAAC;AAIlF,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,iBAAiB,CAAC;AAOtD,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,CAAC,EAAE,eAAe,CAAC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,gBAAgB,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACnC,MAAM,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAC,CAAC,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,aAAa,GACzB,OAAO,KAAK,CAAC,SAAS,CAAC,EACvB,SAAS,iBAAiB,KACxB,OAAO,CAAC,gBAAgB,CAmU1B,CAAC"}
+{"version":3,"file":"multi_repo_publisher.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/multi_repo_publisher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAKpD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAsB,KAAK,eAAe,EAAC,MAAM,yBAAyB,CAAC;AAIlF,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,iBAAiB,CAAC;AAUtD,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,CAAC,EAAE,eAAe,CAAC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,gBAAgB,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACnC,MAAM,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAC,CAAC,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,aAAa,GACzB,OAAO,KAAK,CAAC,SAAS,CAAC,EACvB,SAAS,iBAAiB,KACxB,OAAO,CAAC,gBAAgB,CAqU1B,CAAC"}

package/dist/multi_repo_publisher.js

@@ -6,7 +6,7 @@ import { validate_dependency_graph } from './graph_validation.js';
 import {} from './preflight_checks.js';
 import { needs_update, is_breaking_change, detect_bump_type } from './version_utils.js';
 import { default_gitops_operations } from './operations_defaults.js';
-import { MAX_ITERATIONS } from './constants.js';
+import { GITOPS_MAX_ITERATIONS_DEFAULT, GITOPS_NPM_WAIT_TIMEOUT_DEFAULT, } from './gitops_constants.js';
 import { install_with_cache_healing } from './npm_install_helpers.js';
 export const publish_repos = async (repos, options) => {
     const start_time = Date.now();
@@ -47,9 +47,9 @@ export const publish_repos = async (repos, options) => {
     // This handles transitive dependency updates (auto-generated changesets)
     let iteration = 0;
     let converged = false;
-    while (!converged && iteration < MAX_ITERATIONS) {
+    while (!converged && iteration < GITOPS_MAX_ITERATIONS_DEFAULT) {
         iteration++;
-        log?.info(st('cyan', `\n🚀 Publishing iteration ${iteration}/${MAX_ITERATIONS}...\n`));
+        log?.info(st('cyan', `\n🚀 Publishing iteration ${iteration}/${GITOPS_MAX_ITERATIONS_DEFAULT}...\n`));
         // Track if any packages were published in this iteration
         let published_in_iteration = false;
         let published_count = 0;
@@ -108,7 +108,7 @@ export const publish_repos = async (repos, options) => {
                             max_attempts: 30,
                             initial_delay: 1000,
                             max_delay: 60000,
-                            timeout: options.max_wait || 600000, // 10 minutes default
+                            timeout: options.max_wait ?? GITOPS_NPM_WAIT_TIMEOUT_DEFAULT,
                         },
                         log,
                     });
@@ -186,11 +186,11 @@ export const publish_repos = async (repos, options) => {
             converged = true;
             log?.info(st('green', `\n✓ Converged after ${iteration} iteration(s) - no new changesets\n`));
         }
-        else if (iteration === MAX_ITERATIONS) {
+        else if (iteration === GITOPS_MAX_ITERATIONS_DEFAULT) {
             // Count packages that still have changesets (not yet published)
             const pending_count = order.length - published.size;
             const estimated_iterations = Math.ceil(pending_count / 2); // Rough estimate
-            log?.warn(st('yellow', `\n⚠️  Reached maximum iterations (${MAX_ITERATIONS}) without full convergence\n` +
+            log?.warn(st('yellow', `\n⚠️  Reached maximum iterations (${GITOPS_MAX_ITERATIONS_DEFAULT}) without full convergence\n` +
                 `    ${pending_count} package(s) may still have changesets to process\n` +
                 `    Estimated ${estimated_iterations} more iteration(s) needed - run 'gro gitops_publish' again\n`));
         }

package/dist/publishing_plan.js

@@ -2,7 +2,7 @@ import { styleText as st } from 'node:util';
 import { validate_dependency_graph } from './graph_validation.js';
 import { is_breaking_change, compare_bump_types, calculate_next_version } from './version_utils.js';
 import { default_changeset_operations } from './operations_defaults.js';
-import { MAX_ITERATIONS } from './constants.js';
+import { GITOPS_MAX_ITERATIONS_DEFAULT } from './gitops_constants.js';
 import { calculate_dependency_updates, get_required_bump_for_dependencies, } from './publishing_plan_helpers.js';
 // Re-export logging functions
 export { log_publishing_plan } from './publishing_plan_logging.js';
@@ -128,7 +128,7 @@ export const generate_publishing_plan = async (repos, options = {}) => {
     // Loop until no new version changes are discovered
     let iteration = 0;
     let changed = true;
-    while (changed && iteration < MAX_ITERATIONS) {
+    while (changed && iteration < GITOPS_MAX_ITERATIONS_DEFAULT) {
         changed = false;
         iteration++;
         // Verbose iteration tracking
@@ -241,7 +241,7 @@ export const generate_publishing_plan = async (repos, options = {}) => {
         }
     }
     // Check if we hit iteration limit without convergence
-    if (iteration === MAX_ITERATIONS && changed) {
+    if (iteration === GITOPS_MAX_ITERATIONS_DEFAULT && changed) {
         // Calculate how many packages still need processing
         const pending_packages = [];
         // Recalculate one more time to see what's pending
@@ -262,7 +262,7 @@ export const generate_publishing_plan = async (repos, options = {}) => {
         // Add warning with diagnostics
         const pending_count = pending_packages.length;
         const estimated_iterations = Math.ceil(pending_count / 2); // Rough estimate
-        warnings.push(`Reached maximum iterations (${MAX_ITERATIONS}) without full convergence - ` +
+        warnings.push(`Reached maximum iterations (${GITOPS_MAX_ITERATIONS_DEFAULT}) without full convergence - ` +
             `${pending_count} package(s) may still need processing: ${pending_packages.join(', ')}. ` +
             `Estimated ${estimated_iterations} more iteration(s) needed.`);
     }

package/dist/repo_ops.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repo_ops.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/repo_ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,uDAAuD;AACvD,eAAO,MAAM,oBAAoB,wIAavB,CAAC;AAEX,4EAA4E;AAC5E,eAAO,MAAM,0BAA0B,yLAsB7B,CAAC;AAEX,MAAM,WAAW,WAAW;IAC3B,+DAA+D;IAC/D,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,8DAA8D;IAC9D,kBAAkB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACnC,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sDAAsD;IACtD,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAU,cAAc,MAAM,KAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CA4BlF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,WAAW,MAAM,EAAE,UAAU,WAAW,KAAG,OA2B9E,CAAC;AAEF;;;;;;GAMG;AACH,wBAAuB,eAAe,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,WAAW,GACnB,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAwCzC;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC9B,KAAK,MAAM,EACX,UAAU,WAAW,KACnB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAMvB,CAAC"}
+{"version":3,"file":"repo_ops.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/repo_ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,uDAAuD;AACvD,eAAO,MAAM,oBAAoB,wIAavB,CAAC;AAEX,4EAA4E;AAC5E,eAAO,MAAM,0BAA0B,yLAsB7B,CAAC;AAEX,MAAM,WAAW,WAAW;IAC3B,+DAA+D;IAC/D,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,8DAA8D;IAC9D,kBAAkB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACnC,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sDAAsD;IACtD,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAU,cAAc,MAAM,KAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CA4BlF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,WAAW,MAAM,EAAE,UAAU,WAAW,KAAG,OA2B9E,CAAC;AAEF;;;;;;GAMG;AACH,wBAAuB,eAAe,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,WAAW,GACnB,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAwCzC;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC9B,KAAK,MAAM,EACX,UAAU,WAAW,KACnB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAMvB,CAAC"}

package/dist/repo_ops.js

@@ -13,6 +13,7 @@ import { readdir, stat } from 'node:fs/promises';
 import { join, resolve, dirname } from 'node:path';
 import { load_gitops_config } from './gitops_config.js';
 import { DEFAULT_REPOS_DIR } from './paths.js';
+import { GITOPS_CONFIG_PATH_DEFAULT } from './gitops_constants.js';
 /** Default directories to exclude from file walking */
 export const DEFAULT_EXCLUDE_DIRS = [
     'node_modules',
@@ -60,7 +61,7 @@ export const DEFAULT_EXCLUDE_EXTENSIONS = [
  * @returns Array of repo info with name, path, and url
  */
 export const get_repo_paths = async (config_path) => {
-    const resolved_config_path = resolve(config_path ?? 'gitops.config.ts');
+    const resolved_config_path = resolve(config_path ?? GITOPS_CONFIG_PATH_DEFAULT);
     const config = await load_gitops_config(resolved_config_path);
     if (!config) {
         throw new Error(`No gitops config found at ${resolved_config_path}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_gitops",
-  "version": "0.57.0",
+  "version": "0.59.0",
   "description": "a tool for managing many repos",
   "glyph": "🪄",
   "logo": "logo.svg",
@@ -40,27 +40,27 @@
   },
   "devDependencies": {
     "@changesets/changelog-git": "^0.2.1",
-    "@fuzdev/fuz_code": "^0.37.0",
-    "@fuzdev/fuz_css": "^0.40.0",
-    "@fuzdev/fuz_ui": "^0.169.0",
-    "@fuzdev/fuz_util": "^0.42.0",
+    "@fuzdev/fuz_code": "^0.38.0",
+    "@fuzdev/fuz_css": "^0.42.1",
+    "@fuzdev/fuz_ui": "^0.172.0",
+    "@fuzdev/fuz_util": "^0.44.1",
     "@ryanatkn/eslint-config": "^0.9.0",
-    "@ryanatkn/gro": "^0.181.0",
+    "@ryanatkn/gro": "^0.182.0",
     "@sveltejs/adapter-static": "^3.0.10",
-    "@sveltejs/kit": "^2.49.0",
+    "@sveltejs/kit": "^2.49.1",
     "@sveltejs/package": "^2.5.7",
     "@sveltejs/vite-plugin-svelte": "^6.2.1",
     "@types/node": "^24.10.1",
     "eslint": "^9.39.1",
-    "eslint-plugin-svelte": "^3.13.0",
+    "eslint-plugin-svelte": "^3.13.1",
     "prettier": "^3.6.2",
     "prettier-plugin-svelte": "^3.4.0",
-    "svelte": "^5.45.2",
+    "svelte": "^5.45.6",
     "svelte-check": "^4.3.4",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.48.0",
-    "vitest": "^4.0.14"
+    "typescript-eslint": "^8.48.1",
+    "vitest": "^4.0.15"
   },
   "prettier": {
     "plugins": [

package/src/lib/fetch_repo_data.ts

@@ -18,7 +18,7 @@ import type {LocalRepo} from './local_repo.js';
  * Repos with failed fetches will have `null` for check_runs or pull_requests.
  *
  * @param delay milliseconds between API requests (default: 33ms)
- * @param cache optional cache from belt's fetch.js for response memoization
+ * @param cache optional cache from fuz_util's fetch.js for response memoization
  * @returns array of Repo objects with GitHub metadata attached
  */
 export const fetch_repo_data = async (

package/src/lib/fs_fetch_value_cache.ts

@@ -17,7 +17,7 @@ export interface FetchCache {
 }
 
 /**
- * Creates file-system backed cache for belt's fetch.js API responses.
+ * Creates file-system backed cache for fuz_util's fetch.js API responses.
  *
  * Cache invalidation strategy: If cache file can't be read or parsed, entire
  * cache is cleared (delete file) and starts fresh. This handles format changes.

package/src/lib/gitops_analyze.task.ts

@@ -13,16 +13,17 @@ import {
 	format_production_cycles,
 } from './log_helpers.js';
 import {format_and_output, type OutputFormatters} from './output_helpers.js';
+import {GITOPS_CONFIG_PATH_DEFAULT} from './gitops_constants.js';
 
 /** @nodocs */
 export const Args = z.strictObject({
-	path: z
+	config: z
 		.string()
 		.meta({description: 'path to the gitops config file, absolute or relative to the cwd'})
-		.default('gitops.config.ts'),
+		.default(GITOPS_CONFIG_PATH_DEFAULT),
 	dir: z
 		.string()
-		.meta({description: 'path containing the repos, defaults to the parent of the `path` dir'})
+		.meta({description: 'path containing the repos, defaults to the parent of the config dir'})
 		.optional(),
 	format: z
 		.enum(['stdout', 'json', 'markdown'])
@@ -37,10 +38,10 @@ export const task: Task<Args> = {
 	Args,
 	summary: 'analyze dependency structure and relationships across repos',
 	run: async ({args, log}) => {
-		const {path, dir, format, outfile} = args;
+		const {config, dir, format, outfile} = args;
 
 		// Get repos ready (without downloading)
-		const {local_repos} = await get_gitops_ready({path, dir, download: false, log});
+		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, {

package/src/lib/gitops_constants.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared constants for gitops tasks and operations.
+ *
+ * Naming convention: GITOPS_{NAME}_DEFAULT for user-facing defaults.
+ */
+
+/**
+ * Maximum number of iterations for fixed-point iteration during publishing.
+ * Used in both plan generation and actual publishing to resolve transitive dependency cascades.
+ *
+ * In practice, most repos converge in 2-3 iterations.
+ * Deep dependency chains may require more iterations.
+ */
+export const GITOPS_MAX_ITERATIONS_DEFAULT = 10;
+
+/**
+ * Default path to the gitops configuration file.
+ */
+export const GITOPS_CONFIG_PATH_DEFAULT = 'gitops.config.ts';
+
+/**
+ * Default number of repos to process concurrently during parallel operations.
+ */
+export const GITOPS_CONCURRENCY_DEFAULT = 5;
+
+/**
+ * Default timeout in milliseconds for waiting on NPM package propagation (10 minutes).
+ * NPM's CDN uses eventual consistency, so published packages may not be immediately available.
+ */
+export const GITOPS_NPM_WAIT_TIMEOUT_DEFAULT = 600_000; // 10 minutes

package/src/lib/gitops_plan.task.ts

@@ -10,16 +10,17 @@ import {
 	type LogPlanOptions,
 } from './publishing_plan.js';
 import {format_and_output, type OutputFormatters} from './output_helpers.js';
+import {GITOPS_CONFIG_PATH_DEFAULT} from './gitops_constants.js';
 
 /** @nodocs */
 export const Args = z.strictObject({
-	path: z
+	config: z
 		.string()
 		.meta({description: 'path to the gitops config file, absolute or relative to the cwd'})
-		.default('gitops.config.ts'),
+		.default(GITOPS_CONFIG_PATH_DEFAULT),
 	dir: z
 		.string()
-		.meta({description: 'path containing the repos, defaults to the parent of the `path` dir'})
+		.meta({description: 'path containing the repos, defaults to the parent of the config dir'})
 		.optional(),
 	format: z
 		.enum(['stdout', 'json', 'markdown'])
@@ -37,7 +38,7 @@ export type Args = z.infer<typeof Args>;
  * Usage:
  *   gro gitops_plan
  *   gro gitops_plan --dir ../repos
- *   gro gitops_plan --path ./custom.config.ts
+ *   gro gitops_plan --config ./custom.config.ts
  *
  * @nodocs
  */
@@ -45,13 +46,13 @@ export const task: Task<Args> = {
 	summary: 'generate a publishing plan based on changesets',
 	Args,
 	run: async ({args, log}): Promise<void> => {
-		const {dir, path, format, outfile, verbose} = args;
+		const {dir, config, format, outfile, verbose} = args;
 
 		log.info(st('cyan', 'Generating multi-repo publishing plan...'));
 
 		// Load local repos
 		const {local_repos} = await get_gitops_ready({
-			path,
+			config,
 			dir,
 			download: false, // Don't download if missing
 			log,

package/src/lib/gitops_publish.task.ts

@@ -11,16 +11,17 @@ import {
 } from './multi_repo_publisher.js';
 import {generate_publishing_plan, log_publishing_plan} from './publishing_plan.js';
 import {format_and_output, type OutputFormatters} from './output_helpers.js';
+import {GITOPS_CONFIG_PATH_DEFAULT, GITOPS_NPM_WAIT_TIMEOUT_DEFAULT} from './gitops_constants.js';
 
 /** @nodocs */
 export const Args = z.strictObject({
-	path: z
+	config: z
 		.string()
 		.meta({description: 'path to the gitops config file, absolute or relative to the cwd'})
-		.default('gitops.config.ts'),
+		.default(GITOPS_CONFIG_PATH_DEFAULT),
 	dir: z
 		.string()
-		.meta({description: 'path containing the repos, defaults to the parent of the `path` dir'})
+		.meta({description: 'path containing the repos, defaults to the parent of the config dir'})
 		.optional(),
 	peer_strategy: z
 		.enum(['exact', 'caret', 'tilde'])
@@ -43,7 +44,7 @@ export const Args = z.strictObject({
 	max_wait: z
 		.number()
 		.meta({description: 'max time to wait for npm propagation in ms'})
-		.default(600000), // 10 minutes
+		.default(GITOPS_NPM_WAIT_TIMEOUT_DEFAULT),
 	skip_install: z
 		.boolean()
 		.meta({description: 'skip npm install after dependency updates'})
@@ -59,7 +60,7 @@ export const task: Task<Args> = {
 	Args,
 	run: async ({args, log}): Promise<void> => {
 		const {
-			path,
+			config,
 			dir,
 			peer_strategy,
 			dry_run,
@@ -74,7 +75,7 @@ export const task: Task<Args> = {
 
 		// Load repos
 		const {local_repos: repos} = await get_gitops_ready({
-			path,
+			config,
 			dir,
 			download: false, // Don't download if missing
 			log,

package/src/lib/gitops_run.task.ts

@@ -0,0 +1,218 @@
+import {TaskError, type Task} from '@ryanatkn/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 {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'}),
+	config: z
+		.string()
+		.meta({description: 'path to the gitops config file'})
+		.default(GITOPS_CONFIG_PATH_DEFAULT),
+	concurrency: z
+		.number()
+		.int()
+		.min(1)
+		.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'),
+});
+export type Args = z.infer<typeof Args>;
+
+interface RunResult {
+	repo_name: string;
+	repo_dir: string;
+	status: 'success' | 'failure';
+	exit_code: number;
+	stdout: string;
+	stderr: string;
+	duration_ms: number;
+	error?: string;
+}
+
+export const task: Task<Args> = {
+	Args,
+	summary: 'run a shell command across all repos in parallel',
+	run: async ({args, log}) => {
+		const {command, config, concurrency, format} = args;
+
+		// Get repo paths (lightweight, no library.ts loading needed)
+		const config_path = resolve(config);
+		const repos = await get_repo_paths(config_path);
+
+		if (repos.length === 0) {
+			throw new TaskError('No repos found in config');
+		}
+
+		log.info(
+			`Running ${st('cyan', command)} across ${repos.length} repos (concurrency: ${concurrency})`,
+		);
+
+		const start_time = performance.now();
+
+		// Run command in parallel across all repos
+		const results = await map_concurrent_settled(
+			repos,
+			async (repo) => {
+				const repo_start = performance.now();
+				const repo_name = repo.name;
+				const repo_dir = repo.path;
+
+				try {
+					// Parse command into cmd + args for spawn
+					// For now, we use shell mode to support pipes/redirects/etc
+					const spawned = await spawn_out('sh', ['-c', command], {
+						cwd: repo_dir,
+					});
+
+					const duration_ms = performance.now() - repo_start;
+					const success = spawned.result.ok;
+
+					const result: RunResult = {
+						repo_name,
+						repo_dir,
+						status: success ? 'success' : 'failure',
+						exit_code: spawned.result.code ?? 0,
+						stdout: spawned.stdout || '',
+						stderr: spawned.stderr || '',
+						duration_ms,
+					};
+
+					return result;
+				} catch (error) {
+					const duration_ms = performance.now() - repo_start;
+					return {
+						repo_name,
+						repo_dir,
+						status: 'failure' as const,
+						exit_code: -1,
+						stdout: '',
+						stderr: '',
+						duration_ms,
+						error: String(error),
+					};
+				}
+			},
+			concurrency,
+		);
+
+		const total_duration_ms = performance.now() - start_time;
+
+		// Process results
+		const successes: Array<RunResult> = [];
+		const failures: Array<RunResult> = [];
+
+		for (const result of results) {
+			if (result.status === 'fulfilled') {
+				const run_result = result.value;
+				if (run_result.status === 'success') {
+					successes.push(run_result);
+				} else {
+					failures.push(run_result);
+				}
+			} else {
+				// This shouldn't happen since we catch errors in the task fn
+				// but handle it anyway
+				failures.push({
+					repo_name: 'unknown',
+					repo_dir: 'unknown',
+					status: 'failure',
+					exit_code: -1,
+					stdout: '',
+					stderr: '',
+					duration_ms: 0,
+					error: String(result.reason),
+				});
+			}
+		}
+
+		// Output results based on format
+		if (format === 'json') {
+			const json_output = {
+				command,
+				concurrency,
+				repos: [...successes, ...failures],
+				summary: {
+					total: repos.length,
+					success: successes.length,
+					failure: failures.length,
+					duration_ms: Math.round(total_duration_ms),
+				},
+			};
+			// eslint-disable-next-line no-console
+			console.log(JSON.stringify(json_output, null, 2));
+		} else {
+			// Text format
+			log.info(''); // blank line
+
+			// Show successes
+			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})`)}`));
+				}
+			}
+
+			// Show failures with details
+			if (failures.length > 0) {
+				log.info(''); // blank line
+				log.error(st('red', `✗ ${failures.length} failed:`));
+				for (const result of failures) {
+					const duration = `${Math.round(result.duration_ms)}ms`;
+					log.error(st('gray', `  ${result.repo_name} ${st('blue', `(${duration})`)}`));
+
+					if (result.error) {
+						log.error(st('gray', `    Error: ${result.error}`));
+					} else if (result.exit_code !== 0) {
+						log.error(st('gray', `    Exit code: ${result.exit_code}`));
+					}
+
+					if (result.stderr) {
+						// Show first few lines of stderr
+						const stderr_lines = result.stderr.trim().split('\n');
+						const preview_lines = stderr_lines.slice(0, 3);
+						for (const line of preview_lines) {
+							log.error(st('gray', `    ${line}`));
+						}
+						if (stderr_lines.length > 3) {
+							log.error(st('gray', `    ... (${stderr_lines.length - 3} more lines)`));
+						}
+					}
+				}
+			}
+
+			// Summary
+			log.info(''); // blank line
+			const total = repos.length;
+			const success_rate = ((successes.length / total) * 100).toFixed(0);
+			const duration = `${Math.round(total_duration_ms)}ms`;
+
+			if (failures.length === 0) {
+				log.info(
+					st(
+						'green',
+						`✓ All ${total} repos succeeded in ${duration} (${success_rate}% success rate)`,
+					),
+				);
+			} else {
+				log.info(
+					st(
+						'yellow',
+						`⚠ ${successes.length}/${total} repos succeeded in ${duration} (${success_rate}% success rate)`,
+					),
+				);
+			}
+		}
+
+		// Exit with error if any failures (so CI fails)
+		if (failures.length > 0) {
+			throw new TaskError(`${failures.length} repos failed`);
+		}
+	},
+};

package/src/lib/gitops_sync.task.ts

@@ -11,18 +11,19 @@ import {existsSync} from 'node:fs';
 import {fetch_repo_data} from './fetch_repo_data.js';
 import {create_fs_fetch_value_cache} from './fs_fetch_value_cache.js';
 import {get_gitops_ready} from './gitops_task_helpers.js';
+import {GITOPS_CONFIG_PATH_DEFAULT} from './gitops_constants.js';
 
 // TODO add flag to ignore or invalidate cache -- no-cache? clean?
 
 /** @nodocs */
 export const Args = z.strictObject({
-	path: z
+	config: z
 		.string()
 		.meta({description: 'path to the gitops config file, absolute or relative to the cwd'})
-		.default('gitops.config.ts'),
+		.default(GITOPS_CONFIG_PATH_DEFAULT),
 	dir: z
 		.string()
-		.meta({description: 'path containing the repos, defaults to the parent of the `path` dir'})
+		.meta({description: 'path containing the repos, defaults to the parent of the config dir'})
 		.optional(),
 	outdir: z
 		.string()
@@ -45,9 +46,9 @@ export const task: Task<Args> = {
 	Args,
 	summary: 'syncs local repos and generates UI data from repo metadata',
 	run: async ({args, log, svelte_config, invoke_task}) => {
-		const {path, dir, outdir = svelte_config.routes_path, download, check} = args;
+		const {config, dir, outdir = svelte_config.routes_path, download, check} = args;
 
-		const {local_repos} = await get_gitops_ready({path, dir, download, log});
+		const {local_repos} = await get_gitops_ready({config, dir, download, log});
 
 		const outfile = resolve(outdir, 'repos.ts');