@fuzdev/fuz_gitops 0.72.0 → 0.74.0

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

package/dist/gitops_task_helpers.d.ts

@@ -28,6 +28,14 @@ export interface GetGitopsReadyOptions {
     npm_ops?: NpmOperations;
     parallel?: boolean;
     concurrency?: number;
+    /**
+     * Sync each repo's working tree to its configured branch before loading
+     * (switch branch, pull, install). When `false`, repos load exactly as they
+     * sit on disk — the safe default for read-only diagnostics. Defaults to `true`.
+     */
+    sync?: boolean;
+    /** When syncing, tolerate uncommitted changes instead of throwing. Defaults to `false`. */
+    allow_dirty?: boolean;
 }
 /**
  * Central initialization function for all gitops tasks.
@@ -35,8 +43,12 @@ 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 (in parallel by default)
- * 4. Auto-installs deps if `package.json` changed during pull
+ * 3. If `sync`, switches branches and pulls latest changes (in parallel by default)
+ * 4. If `sync`, auto-installs deps if `package.json` changed during pull
+ *
+ * With `sync: false` (the default for read-only diagnostics), steps 3-4 are
+ * skipped and repos are loaded exactly as checked out — no branch switch, pull,
+ * install, or clean-workspace check.
  *
  * Priority for path resolution:
  * - `dir` argument (explicit override)
@@ -47,6 +59,8 @@ export interface GetGitopsReadyOptions {
  * @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)
+ * @param options.sync - sync working trees before loading (default: true)
+ * @param options.allow_dirty - when syncing, tolerate uncommitted changes (default: false)
  * @returns initialized config and fully loaded repos ready for operations
  * @throws {TaskError} if config loading or repo resolution fails
  */

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;;;;;;;;;;;;;;;;GAgBG;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"}
+{"version":3,"file":"gitops_task_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/gitops_task_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;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;IACrB;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,2FAA2F;IAC3F,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;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,CAwCA,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

@@ -29,8 +29,12 @@ 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 (in parallel by default)
- * 4. Auto-installs deps if `package.json` changed during pull
+ * 3. If `sync`, switches branches and pulls latest changes (in parallel by default)
+ * 4. If `sync`, auto-installs deps if `package.json` changed during pull
+ *
+ * With `sync: false` (the default for read-only diagnostics), steps 3-4 are
+ * skipped and repos are loaded exactly as checked out — no branch switch, pull,
+ * install, or clean-workspace check.
  *
  * Priority for path resolution:
  * - `dir` argument (explicit override)
@@ -41,11 +45,13 @@ import { DEFAULT_REPOS_DIR } from './paths.js';
  * @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)
+ * @param options.sync - sync working trees before loading (default: true)
+ * @param options.allow_dirty - when syncing, tolerate uncommitted changes (default: false)
  * @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 { config, dir, download, log, git_ops, npm_ops, parallel, concurrency } = options;
+    const { config, dir, download, log, git_ops, npm_ops, parallel, concurrency, sync, allow_dirty } = 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)
@@ -71,6 +77,8 @@ export const get_gitops_ready = async (options) => {
         npm_ops,
         parallel,
         concurrency,
+        sync,
+        allow_dirty,
     });
     return { config_path, repos_dir, gitops_config, local_repos };
 };

package/dist/gitops_validate.task.d.ts

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

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,aAAa,CAAC;AACtC,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"}
+{"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,aAAa,CAAC;AACtC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AActB,cAAc;AACd,eAAO,MAAM,IAAI;;;;;kBAiBf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,cAAc;AACd,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CA2N3B,CAAC"}

package/dist/gitops_validate.task.js

@@ -1,10 +1,9 @@
 import { z } from 'zod';
 import { styleText as st } from 'node:util';
 import { get_gitops_ready } from './gitops_task_helpers.js';
-import { validate_dependency_graph } from './graph_validation.js';
-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 { analyze_repos } from './graph_validation.js';
+import { generate_publishing_plan, log_publishing_plan, } from './publishing_plan.js';
+import { execute_publishing_plan } from './multi_repo_publisher.js';
 import { log_dependency_analysis } from './log_helpers.js';
 import { GITOPS_CONFIG_PATH_DEFAULT } from './gitops_constants.js';
 /** @nodocs */
@@ -18,34 +17,33 @@ export const Args = z.strictObject({
         .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),
+    sync: z
+        .boolean()
+        .meta({
+        description: 'sync repos (switch branch, pull, install) before validating instead of reading the working tree as-is',
+    })
+        .default(false),
 });
 /** @nodocs */
 export const task = {
     Args,
     summary: 'validate gitops configuration by running all read-only commands and checking for issues',
     run: async ({ args, log }) => {
-        const { config, dir, verbose } = args;
+        const { config, dir, verbose, sync } = 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)
+        // Load repos once (shared by all commands); read the working tree as-is unless `--sync`
         log.info(st('dim', 'Loading repositories...'));
-        const { local_repos } = await get_gitops_ready({ config, dir, download: false, log });
+        const { local_repos } = await get_gitops_ready({ config, dir, download: false, sync, log });
         log.info(st('dim', `   Found ${local_repos.length} local repos`));
         // 1. Run gitops_analyze
         log.info(st('yellow', 'Running gitops_analyze...'));
         const analyze_start = Date.now();
         try {
-            // Build dependency graph and validate (but don't throw on cycles for analyze)
-            const { graph } = validate_dependency_graph(local_repos, {
-                throw_on_prod_cycles: false, // Analyze should report, not throw
-                log_cycles: false, // We'll collect our own statistics
-                log_order: false,
-            });
-            // Perform additional analysis
-            const builder = new DependencyGraphBuilder();
-            const analysis = builder.analyze(graph);
+            // Build dependency graph and analyze cycles/wildcards (tolerating cycles)
+            const { analysis } = analyze_repos(local_repos);
             const analyze_duration = Date.now() - analyze_start;
             // Collect warnings, info, and errors
             const warning_details = [];
@@ -86,11 +84,13 @@ export const task = {
             });
             log.error(st('red', `  ✗ gitops_analyze failed: ${error}`));
         }
-        // 2. Run gitops_plan
+        // 2. Run gitops_plan (generated once here and reused by the dry run below)
+        let publishing_plan;
         log.info(st('yellow', 'Running gitops_plan...'));
         const plan_start = Date.now();
         try {
-            const plan = await generate_publishing_plan(local_repos, { log: undefined, verbose });
+            const plan = await generate_publishing_plan(local_repos, { verbose });
+            publishing_plan = plan;
             const plan_duration = Date.now() - plan_start;
             const warnings = plan.warnings.length;
             const errors = plan.errors.length;
@@ -129,10 +129,10 @@ export const task = {
         try {
             const options = {
                 wetrun: false,
-                update_deps: true,
                 log: undefined, // Silent for validation
             };
-            const result = await publish_repos(local_repos, options);
+            // Reuse the plan from step 2 (regenerate only if that step failed to produce one).
+            const result = await execute_publishing_plan(local_repos, publishing_plan ?? (await generate_publishing_plan(local_repos, { verbose })), options);
             const dry_duration = Date.now() - dry_start;
             // Dry run doesn't have warnings/errors in the same format
             // We'll just check if it succeeded

package/dist/graph_validation.d.ts

@@ -13,7 +13,7 @@
  * @module
  */
 import type { Logger } from '@fuzdev/fuz_util/log.js';
-import { DependencyGraph } from './dependency_graph.js';
+import { DependencyGraph, DependencyGraphBuilder } from './dependency_graph.js';
 import type { LocalRepo } from './local_repo.js';
 export interface GraphValidationResult {
     graph: DependencyGraph;
@@ -38,4 +38,19 @@ export declare const validate_dependency_graph: (repos: Array<LocalRepo>, option
     log_cycles?: boolean;
     log_order?: boolean;
 }) => GraphValidationResult;
+/** Cycles, wildcard deps, and missing peers produced by `DependencyGraphBuilder.analyze`. */
+export type DependencyAnalysis = ReturnType<DependencyGraphBuilder['analyze']>;
+export interface RepoAnalysis {
+    graph: DependencyGraph;
+    analysis: DependencyAnalysis;
+    /** Topological publishing order, or `null` when prod/peer cycles prevent ordering. */
+    publishing_order: Array<string> | null;
+}
+/**
+ * Builds the dependency graph and runs cycle/wildcard analysis, tolerating cycles
+ * (reports rather than throws). The shared core of `gitops_analyze` and
+ * `gitops_validate`, which format the result themselves — so this stays silent
+ * (no `log`) to avoid emitting a redundant "Analyzing dependencies" line.
+ */
+export declare const analyze_repos: (repos: Array<LocalRepo>) => RepoAnalysis;
 //# sourceMappingURL=graph_validation.d.ts.map

package/dist/graph_validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph_validation.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/graph_validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAIpD,OAAO,EAAC,eAAe,EAAyB,MAAM,uBAAuB,CAAC;AAC9E,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAE/C,MAAM,WAAW,qBAAqB;IACrC,KAAK,EAAE,eAAe,CAAC;IACvB,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,iBAAiB,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACxC,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,GACrC,OAAO,KAAK,CAAC,SAAS,CAAC,EACvB,UAAS;IACR,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACf,KACJ,qBA8DF,CAAC"}
+{"version":3,"file":"graph_validation.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/graph_validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAIpD,OAAO,EAAC,eAAe,EAAE,sBAAsB,EAAC,MAAM,uBAAuB,CAAC;AAC9E,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAE/C,MAAM,WAAW,qBAAqB;IACrC,KAAK,EAAE,eAAe,CAAC;IACvB,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,iBAAiB,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACxC,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,GACrC,OAAO,KAAK,CAAC,SAAS,CAAC,EACvB,UAAS;IACR,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACf,KACJ,qBA8DF,CAAC;AAEF,6FAA6F;AAC7F,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,CAAC;AAE/E,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,sFAAsF;IACtF,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CACvC;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,KAAK,CAAC,SAAS,CAAC,KAAG,YAQvD,CAAC"}

package/dist/graph_validation.js

@@ -79,3 +79,18 @@ export const validate_dependency_graph = (repos, options = {}) => {
         sort_error,
     };
 };
+/**
+ * Builds the dependency graph and runs cycle/wildcard analysis, tolerating cycles
+ * (reports rather than throws). The shared core of `gitops_analyze` and
+ * `gitops_validate`, which format the result themselves — so this stays silent
+ * (no `log`) to avoid emitting a redundant "Analyzing dependencies" line.
+ */
+export const analyze_repos = (repos) => {
+    const { graph, publishing_order: order } = validate_dependency_graph(repos, {
+        throw_on_prod_cycles: false, // report, don't throw
+        log_cycles: false, // callers format their own cycle output
+        log_order: false,
+    });
+    const analysis = new DependencyGraphBuilder().analyze(graph);
+    return { graph, analysis, publishing_order: order.length > 0 ? order : null };
+};

package/dist/local_repo.d.ts

@@ -1,4 +1,4 @@
-import type { LibraryJson } from '@fuzdev/fuz_util/library_json.js';
+import type { PackageJson } from '@fuzdev/fuz_util/package_json.js';
 import { Library } from '@fuzdev/fuz_ui/library.svelte.js';
 import type { Logger } from '@fuzdev/fuz_util/log.js';
 import type { GitOperations, NpmOperations } from './operations.js';
@@ -10,7 +10,8 @@ import type { ResolvedGitopsConfig } from './resolved_gitops_config.js';
  */
 export interface LocalRepo {
     library: Library;
-    library_json: LibraryJson;
+    /** The repo's full `package.json` (with `dependencies`/`devDependencies`). */
+    package_json: PackageJson;
     repo_dir: string;
     repo_git_ssh_url: string;
     repo_config: GitopsRepoConfig;
@@ -41,27 +42,37 @@ export interface LocalRepoMissing {
     repo_config: GitopsRepoConfig;
 }
 /**
- * Loads repo data with automatic syncing and dependency management.
+ * Loads repo data, optionally syncing the working tree first.
  *
- * Workflow:
+ * When `sync` is `false` (the default for read-only diagnostics like
+ * `gitops_analyze`/`gitops_plan`), the repo is loaded exactly as it sits on
+ * disk — no branch switch, pull, install, or clean-workspace check. This makes
+ * those commands safe to run on an active workspace with uncommitted changes or
+ * feature branches checked out.
+ *
+ * When `sync` is `true` (used by `gitops_sync`), the working tree is brought in
+ * line with the configured branch first:
  * 1. Records current commit hash (for detecting changes)
- * 2. Switches to target branch if needed (requires clean workspace)
+ * 2. Switches to target branch if needed (requires clean workspace unless `allow_dirty`)
  * 3. Pulls latest changes from remote (skipped for local-only repos)
- * 4. Validates workspace is clean after pull
+ * 4. Validates workspace is clean after pull (skipped if `allow_dirty`)
  * 5. Auto-installs dependencies if `package.json` changed
+ *
+ * Either way it then:
  * 6. Loads `library_json` via `library_load_from_repo` (svelte-docinfo analysis)
  * 7. Creates `Library` and extracts dependency maps
  *
- * This ensures repos are always in sync with their configured branch
- * before being used by gitops commands.
- *
- * @throws {TaskError} if workspace dirty, branch switch fails, install fails, or analysis fails
+ * @param sync - sync the working tree to the configured branch before loading (default `true`)
+ * @param allow_dirty - when syncing, tolerate uncommitted changes instead of throwing (default `false`)
+ * @throws {TaskError} if syncing fails (dirty workspace, branch switch, install) or analysis fails
  */
-export declare const local_repo_load: ({ local_repo_path, log: _log, git_ops, npm_ops, }: {
+export declare const local_repo_load: ({ local_repo_path, log: _log, git_ops, npm_ops, sync, allow_dirty, }: {
     local_repo_path: LocalRepoPath;
     log?: Logger;
     git_ops?: GitOperations;
     npm_ops?: NpmOperations;
+    sync?: boolean;
+    allow_dirty?: boolean;
 }) => Promise<LocalRepo>;
 export declare const local_repos_ensure: ({ resolved_config, repos_dir, gitops_config, download, log, npm_ops, }: {
     resolved_config: ResolvedGitopsConfig;
@@ -71,13 +82,15 @@ 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, parallel, concurrency, }: {
+export declare const local_repos_load: ({ local_repo_paths, log, git_ops, npm_ops, parallel, concurrency, sync, allow_dirty, }: {
     local_repo_paths: Array<LocalRepoPath>;
     log?: Logger;
     git_ops?: GitOperations;
     npm_ops?: NpmOperations;
     parallel?: boolean;
     concurrency?: number;
+    sync?: boolean;
+    allow_dirty?: boolean;
 }) => Promise<Array<LocalRepo>>;
 export declare const local_repo_locate: ({ repo_config, repos_dir, }: {
     repo_config: GitopsRepoConfig;

package/dist/local_repo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local_repo.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/local_repo.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAC,OAAO,EAAC,MAAM,kCAAkC,CAAC;AAKzD,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAGpD,OAAO,KAAK,EAAC,aAAa,EAAE,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAGlE,OAAO,KAAK,EAAC,YAAY,EAAE,gBAAgB,EAAC,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,6BAA6B,CAAC;AAGtE;;;GAGG;AACH,MAAM,WAAW,SAAS;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,WAAW,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,gBAAgB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,gBAAgB,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,GAAU,mDAKnC;IACF,eAAe,EAAE,aAAa,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,OAAO,CAAC,EAAE,aAAa,CAAC;CACxB,KAAG,OAAO,CAAC,SAAS,CAuIpB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAU,wEAOtC;IACF,eAAe,EAAE,oBAAoB,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,YAAY,CAAC;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,CAAC;CACxB,KAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAkC/B,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAU,qEAOpC;IACF,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IACvC,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,KAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CA2C3B,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,6BAG/B;IACF,WAAW,EAAE,gBAAgB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CAClB,KAAG,aAAa,GAAG,gBAoBnB,CAAC"}
+{"version":3,"file":"local_repo.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/local_repo.ts"],"names":[],"mappings":"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"}