@fuzdev/fuz_gitops 0.58.0 → 0.60.0

package/dist/gitops_analyze.task.js

@@ -5,15 +5,16 @@ import { DependencyGraphBuilder } from './dependency_graph.js';
 import { validate_dependency_graph } 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';
 /** @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'])
@@ -26,9 +27,9 @@ export const task = {
     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, {
             log,

package/dist/gitops_constants.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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 declare const GITOPS_MAX_ITERATIONS_DEFAULT = 10;
+/**
+ * Default path to the gitops configuration file.
+ */
+export declare const GITOPS_CONFIG_PATH_DEFAULT = "gitops.config.ts";
+/**
+ * Default number of repos to process concurrently during parallel operations.
+ */
+export declare 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 declare const GITOPS_NPM_WAIT_TIMEOUT_DEFAULT = 600000;
+//# sourceMappingURL=gitops_constants.d.ts.map

package/dist/gitops_constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitops_constants.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/gitops_constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,0BAA0B,qBAAqB,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,+BAA+B,SAAU,CAAC"}

package/dist/gitops_constants.js

@@ -0,0 +1,26 @@
+/**
+ * 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/dist/gitops_plan.task.d.ts

@@ -2,7 +2,7 @@ import type { Task } from '@ryanatkn/gro';
 import { z } from 'zod';
 /** @nodocs */
 export declare const Args: z.ZodObject<{
-    path: z.ZodDefault<z.ZodString>;
+    config: z.ZodDefault<z.ZodString>;
     dir: z.ZodOptional<z.ZodString>;
     format: z.ZodDefault<z.ZodEnum<{
         json: "json";
@@ -20,7 +20,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
  */

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,eAAe,CAAC;AACxC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAYtB,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,eAAe,CAAC;AACxC,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"}

package/dist/gitops_plan.task.js

@@ -3,15 +3,16 @@ import { styleText as st } from 'node:util';
 import { get_gitops_ready } from './gitops_task_helpers.js';
 import { generate_publishing_plan, log_publishing_plan, } from './publishing_plan.js';
 import { format_and_output } 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'])
@@ -27,7 +28,7 @@ export const Args = z.strictObject({
  * Usage:
  *   gro gitops_plan
  *   gro gitops_plan --dir ../repos
- *   gro gitops_plan --path ./custom.config.ts
+ *   gro gitops_plan --config ./custom.config.ts
  *
  * @nodocs
  */
@@ -35,11 +36,11 @@ export const task = {
     summary: 'generate a publishing plan based on changesets',
     Args,
     run: async ({ args, log }) => {
-        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/dist/gitops_publish.task.d.ts

@@ -2,7 +2,7 @@ import type { Task } from '@ryanatkn/gro';
 import { z } from 'zod';
 /** @nodocs */
 export declare const Args: z.ZodObject<{
-    path: z.ZodDefault<z.ZodString>;
+    config: z.ZodDefault<z.ZodString>;
     dir: z.ZodOptional<z.ZodString>;
     peer_strategy: z.ZodDefault<z.ZodEnum<{
         exact: "exact";

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,eAAe,CAAC;AACxC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAatB,cAAc;AACd,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;kBAqCf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,cAAc;AACd,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CA0F3B,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,eAAe,CAAC;AACxC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AActB,cAAc;AACd,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;kBAqCf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,cAAc;AACd,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CA0F3B,CAAC"}

package/dist/gitops_publish.task.js

@@ -5,15 +5,16 @@ import { get_gitops_ready } from './gitops_task_helpers.js';
 import { publish_repos, } from './multi_repo_publisher.js';
 import { generate_publishing_plan, log_publishing_plan } from './publishing_plan.js';
 import { format_and_output } 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'])
@@ -36,7 +37,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' })
@@ -49,10 +50,10 @@ export const task = {
     summary: 'publish all repos in dependency order',
     Args,
     run: async ({ args, log }) => {
-        const { path, dir, peer_strategy, dry_run, format, deploy, plan, max_wait, skip_install, outfile, verbose, } = args;
+        const { config, dir, peer_strategy, dry_run, format, deploy, plan, max_wait, skip_install, outfile, verbose, } = args;
         // Load repos
         const { local_repos: repos } = await get_gitops_ready({
-            path,
+            config,
             dir,
             download: false, // Don't download if missing
             log,

package/dist/gitops_run.task.d.ts

@@ -0,0 +1,14 @@
+import { type Task } from '@ryanatkn/gro';
+import { z } from 'zod';
+export declare const Args: z.ZodObject<{
+    command: z.ZodString;
+    config: z.ZodDefault<z.ZodString>;
+    concurrency: z.ZodDefault<z.ZodNumber>;
+    format: z.ZodDefault<z.ZodEnum<{
+        json: "json";
+        text: "text";
+    }>>;
+}, z.core.$strict>;
+export type Args = z.infer<typeof Args>;
+export declare const task: Task<Args>;
+//# sourceMappingURL=gitops_run.task.d.ts.map

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

@@ -0,0 +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,eAAe,CAAC;AACnD,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,CAoL3B,CAAC"}

package/dist/gitops_run.task.js

@@ -0,0 +1,173 @@
+import { TaskError } 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 const task = {
+    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 = {
+                    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',
+                    exit_code: -1,
+                    stdout: '',
+                    stderr: '',
+                    duration_ms,
+                    error: String(error),
+                };
+            }
+        }, concurrency);
+        const total_duration_ms = performance.now() - start_time;
+        // Process results
+        const successes = [];
+        const failures = [];
+        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/dist/gitops_sync.task.d.ts

@@ -2,7 +2,7 @@ import { type Task } from '@ryanatkn/gro';
 import { z } from 'zod';
 /** @nodocs */
 export declare const Args: z.ZodObject<{
-    path: z.ZodDefault<z.ZodString>;
+    config: z.ZodDefault<z.ZodString>;
     dir: z.ZodOptional<z.ZodString>;
     outdir: z.ZodOptional<z.ZodString>;
     download: z.ZodDefault<z.ZodBoolean>;

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,eAAe,CAAC;AACnD,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAetB,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,CAiE3B,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,eAAe,CAAC;AACnD,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAgBtB,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,CAiE3B,CAAC"}

package/dist/gitops_sync.task.js

@@ -5,21 +5,22 @@ import { format_file } from '@ryanatkn/gro/format_file.js';
 import { basename, resolve } from 'node:path';
 import { print_path } from '@ryanatkn/gro/paths.js';
 import { load_from_env } from '@ryanatkn/gro/env.js';
-import { load_package_json } from '@ryanatkn/gro/package_json.js';
+import { package_json_load } from '@ryanatkn/gro/package_json.js';
 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()
@@ -40,8 +41,8 @@ export const task = {
     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 { local_repos } = await get_gitops_ready({ path, dir, download, log });
+        const { config, dir, outdir = svelte_config.routes_path, download, check } = args;
+        const { local_repos } = await get_gitops_ready({ config, dir, download, log });
         const outfile = resolve(outdir, 'repos.ts');
         // This searches the parent directory for the env var, so we don't use SvelteKit's $env imports
         const token = load_from_env('SECRET_GITHUB_API_TOKEN');
@@ -57,7 +58,7 @@ export const task = {
         log.info('fetching remote repo data');
         const repos_json = await fetch_repo_data(local_repos, token, cache.data, log);
         // TODO should package_json be provided in the Gro task/gen contexts? check if it's always loaded
-        const package_json = await load_package_json();
+        const package_json = await package_json_load();
         const repo_specifier = package_json.name === '@fuzdev/fuz_gitops'
             ? '$lib/repo.svelte.js'
             : '@fuzdev/fuz_gitops/repo.svelte.js';

package/dist/gitops_task_helpers.d.ts

@@ -18,12 +18,14 @@ import { type GitopsConfig } from './gitops_config.js';
 import { type LocalRepo } from './local_repo.js';
 import type { GitOperations, NpmOperations } from './operations.js';
 export interface GetGitopsReadyOptions {
-    path: string;
+    config: string;
     dir?: string;
     download: boolean;
     log?: Logger;
     git_ops?: GitOperations;
     npm_ops?: NpmOperations;
+    parallel?: boolean;
+    concurrency?: number;
 }
 /**
  * Central initialization function for all gitops tasks.
@@ -31,7 +33,7 @@ export interface GetGitopsReadyOptions {
  * Initialization sequence:
  * 1. Loads and normalizes config from `gitops.config.ts`
  * 2. Resolves local repo paths (creates missing with `--download`)
- * 3. Switches branches and pulls latest changes
+ * 3. Switches branches and pulls latest changes (in parallel by default)
  * 4. Auto-installs deps if package.json changed during pull
  *
  * Priority for path resolution:
@@ -41,6 +43,8 @@ export interface GetGitopsReadyOptions {
  *
  * @param options.git_ops for testing (defaults to real git operations)
  * @param options.npm_ops for testing (defaults to real npm operations)
+ * @param options.parallel whether to load repos in parallel (default: true)
+ * @param options.concurrency max concurrent repo loads (default: 5)
  * @returns initialized config and fully loaded repos ready for operations
  * @throws {TaskError} if config loading or repo resolution fails
  */
@@ -51,7 +55,7 @@ export declare const get_gitops_ready: (options: GetGitopsReadyOptions) => Promi
     local_repos: Array<LocalRepo>;
 }>;
 export interface ResolveGitopsPathsOptions {
-    path: string;
+    config: string;
     dir?: string;
     config_repos_dir?: string;
 }

package/dist/gitops_task_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gitops_task_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/gitops_task_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAEpD,OAAO,EAAqB,KAAK,YAAY,EAAC,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAuC,KAAK,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAGrF,OAAO,KAAK,EAAC,aAAa,EAAE,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAElE,MAAM,WAAW,qBAAqB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,OAAO,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,gBAAgB,GAC5B,SAAS,qBAAqB,KAC5B,OAAO,CAAC;IACV,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,YAAY,CAAC;IAC5B,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;CAC9B,CA8BA,CAAC;AAEF,MAAM,WAAW,yBAAyB;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,oBAAoB,GAChC,SAAS,yBAAyB,KAChC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAczC,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAU,aAAa,MAAM,KAAG,OAAO,CAAC,YAAY,CAMpF,CAAC"}
+{"version":3,"file":"gitops_task_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/gitops_task_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAEpD,OAAO,EAAqB,KAAK,YAAY,EAAC,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAuC,KAAK,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAGrF,OAAO,KAAK,EAAC,aAAa,EAAE,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAElE,MAAM,WAAW,qBAAqB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,gBAAgB,GAC5B,SAAS,qBAAqB,KAC5B,OAAO,CAAC;IACV,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,YAAY,CAAC;IAC5B,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;CAC9B,CAqCA,CAAC;AAEF,MAAM,WAAW,yBAAyB;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,oBAAoB,GAChC,SAAS,yBAAyB,KAChC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAczC,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAU,aAAa,MAAM,KAAG,OAAO,CAAC,YAAY,CAMpF,CAAC"}

package/dist/gitops_task_helpers.js

@@ -27,7 +27,7 @@ import { DEFAULT_REPOS_DIR } from './paths.js';
  * Initialization sequence:
  * 1. Loads and normalizes config from `gitops.config.ts`
  * 2. Resolves local repo paths (creates missing with `--download`)
- * 3. Switches branches and pulls latest changes
+ * 3. Switches branches and pulls latest changes (in parallel by default)
  * 4. Auto-installs deps if package.json changed during pull
  *
  * Priority for path resolution:
@@ -37,16 +37,18 @@ import { DEFAULT_REPOS_DIR } from './paths.js';
  *
  * @param options.git_ops for testing (defaults to real git operations)
  * @param options.npm_ops for testing (defaults to real npm operations)
+ * @param options.parallel whether to load repos in parallel (default: true)
+ * @param options.concurrency max concurrent repo loads (default: 5)
  * @returns initialized config and fully loaded repos ready for operations
  * @throws {TaskError} if config loading or repo resolution fails
  */
 export const get_gitops_ready = async (options) => {
-    const { path, dir, download, log, git_ops, npm_ops } = options;
-    const config_path = resolve(path);
+    const { config, dir, download, log, git_ops, npm_ops, parallel, concurrency } = options;
+    const config_path = resolve(config);
     const gitops_config = await import_gitops_config(config_path);
     // Priority: explicit dir arg → config repos_dir → default (two dirs up from config)
     const repos_dir = resolve_gitops_paths({
-        path,
+        config,
         dir,
         config_repos_dir: gitops_config.repos_dir,
     }).repos_dir;
@@ -60,12 +62,19 @@ export const get_gitops_ready = async (options) => {
         log,
         npm_ops,
     });
-    const local_repos = await local_repos_load({ local_repo_paths, log, git_ops, npm_ops });
+    const local_repos = await local_repos_load({
+        local_repo_paths,
+        log,
+        git_ops,
+        npm_ops,
+        parallel,
+        concurrency,
+    });
     return { config_path, repos_dir, gitops_config, local_repos };
 };
 export const resolve_gitops_paths = (options) => {
-    const { path, dir, config_repos_dir } = options;
-    const config_path = resolve(path);
+    const { config, dir, config_repos_dir } = options;
+    const config_path = resolve(config);
     const config_dir = dirname(config_path);
     // Priority: explicit dir arg → config repos_dir → default (parent of config dir)
     const repos_dir = dir !== undefined

package/dist/gitops_validate.task.d.ts

@@ -2,7 +2,7 @@ import type { Task } from '@ryanatkn/gro';
 import { z } from 'zod';
 /** @nodocs */
 export declare const Args: z.ZodObject<{
-    path: z.ZodDefault<z.ZodString>;
+    config: z.ZodDefault<z.ZodString>;
     dir: z.ZodOptional<z.ZodString>;
     verbose: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strict>;

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

@@ -1 +1 @@
-{"version":3,"file":"gitops_validate.task.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/gitops_validate.task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,eAAe,CAAC;AACxC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAUtB,cAAc;AACd,eAAO,MAAM,IAAI;;;;kBAUf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,cAAc;AACd,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CA6N3B,CAAC"}
+{"version":3,"file":"gitops_validate.task.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/gitops_validate.task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,eAAe,CAAC;AACxC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAWtB,cAAc;AACd,eAAO,MAAM,IAAI;;;;kBAUf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,cAAc;AACd,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CA6N3B,CAAC"}

package/dist/gitops_validate.task.js

@@ -6,15 +6,16 @@ import { DependencyGraphBuilder } from './dependency_graph.js';
 import { generate_publishing_plan, log_publishing_plan } from './publishing_plan.js';
 import { publish_repos } from './multi_repo_publisher.js';
 import { log_dependency_analysis } from './log_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(),
     verbose: z.boolean().meta({ description: 'show additional details' }).default(false),
 });
@@ -23,14 +24,14 @@ export const task = {
     Args,
     summary: 'validate gitops configuration by running all read-only commands and checking for issues',
     run: async ({ args, log }) => {
-        const { path, dir, verbose } = args;
+        const { config, dir, verbose } = args;
         log.info(st('cyan', 'Running Gitops Validation Suite'));
         log.info(st('dim', 'This runs all read-only commands and checks for consistency.'));
         const results = [];
         const start_time = Date.now();
         // Load repos once (shared by all commands)
         log.info(st('dim', 'Loading repositories...'));
-        const { local_repos } = await get_gitops_ready({ path, dir, download: false, log });
+        const { local_repos } = await get_gitops_ready({ config, dir, download: false, log });
         log.info(st('dim', `   Found ${local_repos.length} local repos`));
         // 1. Run gitops_analyze
         log.info(st('yellow', 'Running gitops_analyze...'));

package/dist/local_repo.d.ts

@@ -71,11 +71,13 @@ export declare const local_repos_ensure: ({ resolved_config, repos_dir, gitops_c
     log?: Logger;
     npm_ops?: NpmOperations;
 }) => Promise<Array<LocalRepoPath>>;
-export declare const local_repos_load: ({ local_repo_paths, log, git_ops, npm_ops, }: {
+export declare const local_repos_load: ({ local_repo_paths, log, git_ops, npm_ops, parallel, concurrency, }: {
     local_repo_paths: Array<LocalRepoPath>;
     log?: Logger;
     git_ops?: GitOperations;
     npm_ops?: NpmOperations;
+    parallel?: boolean;
+    concurrency?: number;
 }) => Promise<Array<LocalRepo>>;
 export declare const local_repo_locate: ({ repo_config, repos_dir, }: {
     repo_config: GitopsRepoConfig;