@fuzdev/fuz_gitops 0.72.0 → 0.73.0

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

@@ -41,27 +41,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 +81,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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"}

package/dist/local_repo.js

@@ -9,91 +9,108 @@ 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.
+ * 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 const local_repo_load = async ({ local_repo_path, log: _log, git_ops = default_git_operations, npm_ops = default_npm_operations, }) => {
+export const local_repo_load = async ({ local_repo_path, log: _log, git_ops = default_git_operations, npm_ops = default_npm_operations, sync = true, allow_dirty = false, }) => {
     const { repo_config, repo_dir, repo_name, repo_git_ssh_url } = local_repo_path;
-    // Record commit hash before any changes
-    const commit_before_result = await git_ops.current_commit_hash({ cwd: repo_dir });
-    if (!commit_before_result.ok) {
-        throw new TaskError(`Failed to get commit hash in ${repo_dir}: ${commit_before_result.message}`);
-    }
-    const commit_before = commit_before_result.value;
-    // Switch to target branch if needed
-    const branch_result = await git_ops.current_branch_name({ cwd: repo_dir });
-    if (!branch_result.ok) {
-        throw new TaskError(`Failed to get current branch in ${repo_dir}: ${branch_result.message}`);
-    }
-    const switched_branches = branch_result.value !== repo_config.branch;
-    if (switched_branches) {
-        const clean_result = await git_ops.check_clean_workspace({ cwd: repo_dir });
-        if (!clean_result.ok) {
-            throw new TaskError(`Failed to check workspace in ${repo_dir}: ${clean_result.message}`);
+    if (sync) {
+        // Record commit hash before any changes
+        const commit_before_result = await git_ops.current_commit_hash({ cwd: repo_dir });
+        if (!commit_before_result.ok) {
+            throw new TaskError(`Failed to get commit hash in ${repo_dir}: ${commit_before_result.message}`);
         }
-        if (!clean_result.value) {
-            throw new TaskError(`Repo ${repo_dir} is not on branch "${repo_config.branch}" and the workspace is unclean, blocking switch`);
+        const commit_before = commit_before_result.value;
+        // Switch to target branch if needed
+        const branch_result = await git_ops.current_branch_name({ cwd: repo_dir });
+        if (!branch_result.ok) {
+            throw new TaskError(`Failed to get current branch in ${repo_dir}: ${branch_result.message}`);
         }
-        const checkout_result = await git_ops.checkout({ branch: repo_config.branch, cwd: repo_dir });
-        if (!checkout_result.ok) {
-            throw new TaskError(`Failed to checkout branch "${repo_config.branch}" in ${repo_dir}: ${checkout_result.message}`);
+        const switched_branches = branch_result.value !== repo_config.branch;
+        if (switched_branches) {
+            // Guard the switch on a clean workspace unless the caller opts into `allow_dirty`,
+            // in which case we let `git checkout` itself fail loudly if it can't proceed.
+            if (!allow_dirty) {
+                const clean_result = await git_ops.check_clean_workspace({ cwd: repo_dir });
+                if (!clean_result.ok) {
+                    throw new TaskError(`Failed to check workspace in ${repo_dir}: ${clean_result.message}`);
+                }
+                if (!clean_result.value) {
+                    throw new TaskError(`Repo ${repo_dir} is not on branch "${repo_config.branch}" and the workspace is unclean, blocking switch`);
+                }
+            }
+            const checkout_result = await git_ops.checkout({ branch: repo_config.branch, cwd: repo_dir });
+            if (!checkout_result.ok) {
+                throw new TaskError(`Failed to checkout branch "${repo_config.branch}" in ${repo_dir}: ${checkout_result.message}`);
+            }
         }
-    }
-    // Only pull if remote exists (skip for local-only repos, test fixtures)
-    const origin_result = await git_ops.has_remote({ remote: 'origin', cwd: repo_dir });
-    if (!origin_result.ok) {
-        throw new TaskError(`Failed to check for remote in ${repo_dir}: ${origin_result.message}`);
-    }
-    if (origin_result.value) {
-        const pull_result = await git_ops.pull({ cwd: repo_dir });
-        if (!pull_result.ok) {
-            throw new TaskError(`Failed to pull in ${repo_dir}: ${pull_result.message}`);
+        // Only pull if remote exists (skip for local-only repos, test fixtures)
+        const origin_result = await git_ops.has_remote({ remote: 'origin', cwd: repo_dir });
+        if (!origin_result.ok) {
+            throw new TaskError(`Failed to check for remote in ${repo_dir}: ${origin_result.message}`);
         }
-    }
-    // Check clean workspace after pull to ensure we're in a good state
-    const clean_after_result = await git_ops.check_clean_workspace({ cwd: repo_dir });
-    if (!clean_after_result.ok) {
-        throw new TaskError(`Failed to check workspace in ${repo_dir}: ${clean_after_result.message}`);
-    }
-    if (!clean_after_result.value) {
-        throw new TaskError(`Workspace ${repo_dir} is unclean after pulling branch "${repo_config.branch}"`);
-    }
-    // Record commit hash after pull
-    const commit_after_result = await git_ops.current_commit_hash({ cwd: repo_dir });
-    if (!commit_after_result.ok) {
-        throw new TaskError(`Failed to get commit hash in ${repo_dir}: ${commit_after_result.message}`);
-    }
-    const commit_after = commit_after_result.value;
-    // Track if we got new commits
-    const got_new_commits = commit_before !== commit_after;
-    // Only install if package.json changed
-    if (got_new_commits) {
-        const changed_result = await git_ops.has_file_changed({
-            from_commit: commit_before,
-            to_commit: commit_after,
-            file_path: 'package.json',
-            cwd: repo_dir,
-        });
-        if (!changed_result.ok) {
-            throw new TaskError(`Failed to check if package.json changed in ${repo_dir}: ${changed_result.message}`);
-        }
-        if (changed_result.value) {
-            const install_result = await npm_ops.install({ cwd: repo_dir });
-            if (!install_result.ok) {
-                throw new TaskError(`Failed to install dependencies in ${repo_dir}: ${install_result.message}${install_result.stderr ? `\n${install_result.stderr}` : ''}`);
+        if (origin_result.value) {
+            const pull_result = await git_ops.pull({ cwd: repo_dir });
+            if (!pull_result.ok) {
+                throw new TaskError(`Failed to pull in ${repo_dir}: ${pull_result.message}`);
+            }
+        }
+        // Check clean workspace after pull to ensure we're in a good state
+        // (skipped when `allow_dirty`, since uncommitted changes are expected then)
+        if (!allow_dirty) {
+            const clean_after_result = await git_ops.check_clean_workspace({ cwd: repo_dir });
+            if (!clean_after_result.ok) {
+                throw new TaskError(`Failed to check workspace in ${repo_dir}: ${clean_after_result.message}`);
+            }
+            if (!clean_after_result.value) {
+                throw new TaskError(`Workspace ${repo_dir} is unclean after pulling branch "${repo_config.branch}"`);
+            }
+        }
+        // Record commit hash after pull
+        const commit_after_result = await git_ops.current_commit_hash({ cwd: repo_dir });
+        if (!commit_after_result.ok) {
+            throw new TaskError(`Failed to get commit hash in ${repo_dir}: ${commit_after_result.message}`);
+        }
+        const commit_after = commit_after_result.value;
+        // Track if we got new commits
+        const got_new_commits = commit_before !== commit_after;
+        // Only install if package.json changed
+        if (got_new_commits) {
+            const changed_result = await git_ops.has_file_changed({
+                from_commit: commit_before,
+                to_commit: commit_after,
+                file_path: 'package.json',
+                cwd: repo_dir,
+            });
+            if (!changed_result.ok) {
+                throw new TaskError(`Failed to check if package.json changed in ${repo_dir}: ${changed_result.message}`);
+            }
+            if (changed_result.value) {
+                const install_result = await npm_ops.install({ cwd: repo_dir });
+                if (!install_result.ok) {
+                    throw new TaskError(`Failed to install dependencies in ${repo_dir}: ${install_result.message}${install_result.stderr ? `\n${install_result.stderr}` : ''}`);
+                }
             }
         }
     }
@@ -157,18 +174,18 @@ 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, parallel = true, concurrency = GITOPS_CONCURRENCY_DEFAULT, }) => {
+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, sync = true, allow_dirty = false, }) => {
     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 }));
+            loaded.push(await local_repo_load({ local_repo_path, log, git_ops, npm_ops, sync, allow_dirty }));
         }
         return loaded;
     }
     // Parallel loading with concurrency limit
     const results = await map_concurrent_settled(local_repo_paths, concurrency, async (local_repo_path) => {
-        return local_repo_load({ local_repo_path, log, git_ops, npm_ops });
+        return local_repo_load({ local_repo_path, log, git_ops, npm_ops, sync, allow_dirty });
     });
     // Check for failures and collect successes
     const loaded = [];

package/dist/log_helpers.d.ts

@@ -35,9 +35,4 @@ export declare const log_production_cycles: (analysis: ReturnType<DependencyGrap
  * Convenience function that calls all three logging functions in order.
  */
 export declare const log_dependency_analysis: (analysis: ReturnType<DependencyGraphBuilder["analyze"]>, log: Logger, indent?: string) => void;
-/**
- * Logs a simple bulleted list with a header.
- * Common pattern for warnings, info messages, and other lists.
- */
-export declare const log_list: (items: Array<string>, header: string, color: "cyan" | "yellow" | "red" | "dim", log: Logger, log_method?: "info" | "warn" | "error") => void;
 //# sourceMappingURL=log_helpers.d.ts.map

package/dist/log_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/log_helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAGpD,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,uBAAuB,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GACxC,UAAU,UAAU,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,KACrD,KAAK,CAAC,MAAM,CASd,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC7B,UAAU,UAAU,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,KACrD,KAAK,CAAC,MAAM,CAcd,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GACpC,UAAU,UAAU,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,KACrD,KAAK,CAAC,MAAM,CAcd,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GACrC,UAAU,UAAU,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,EACvD,KAAK,MAAM,EACX,eAAW,KACT,IAKF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAC1B,UAAU,UAAU,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,EACvD,KAAK,MAAM,EACX,eAAW,KACT,IAKF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GACjC,UAAU,UAAU,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,EACvD,KAAK,MAAM,EACX,eAAW,KACT,IAKF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GACnC,UAAU,UAAU,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,EACvD,KAAK,MAAM,EACX,eAAW,KACT,IAIF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,QAAQ,GACpB,OAAO,KAAK,CAAC,MAAM,CAAC,EACpB,QAAQ,MAAM,EACd,OAAO,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,KAAK,EACxC,KAAK,MAAM,EACX,aAAY,MAAM,GAAG,MAAM,GAAG,OAAgB,KAC5C,IAWF,CAAC"}
+{"version":3,"file":"log_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/log_helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAGpD,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,uBAAuB,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GACxC,UAAU,UAAU,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,KACrD,KAAK,CAAC,MAAM,CAYd,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC7B,UAAU,UAAU,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,KACrD,KAAK,CAAC,MAAM,CAed,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GACpC,UAAU,UAAU,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,KACrD,KAAK,CAAC,MAAM,CAed,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GACrC,UAAU,UAAU,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,EACvD,KAAK,MAAM,EACX,eAAW,KACT,IAKF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAC1B,UAAU,UAAU,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,EACvD,KAAK,MAAM,EACX,eAAW,KACT,IAKF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GACjC,UAAU,UAAU,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,EACvD,KAAK,MAAM,EACX,eAAW,KACT,IAKF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GACnC,UAAU,UAAU,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,EACvD,KAAK,MAAM,EACX,eAAW,KACT,IAIF,CAAC"}

package/dist/log_helpers.js

@@ -7,7 +7,10 @@ export const format_wildcard_dependencies = (analysis) => {
     if (analysis.wildcard_deps.length === 0)
         return [];
     const lines = [];
-    lines.push(st('yellow', `\n⚠️  Found ${analysis.wildcard_deps.length} wildcard dependencies:`));
+    // Blank separator as its own line so the logger prefixes it correctly; embedding
+    // a leading `\n` in the header would leave the header line unprefixed.
+    lines.push('');
+    lines.push(st('yellow', `⚠️  Found ${analysis.wildcard_deps.length} wildcard dependencies:`));
     for (const { pkg, dep, version } of analysis.wildcard_deps) {
         lines.push(`  ${pkg} → ${dep} ${st('red', version)}`);
     }
@@ -21,7 +24,8 @@ export const format_dev_cycles = (analysis) => {
     if (analysis.dev_cycles.length === 0)
         return [];
     const lines = [];
-    lines.push(st('dim', `\nℹ️  Found ${analysis.dev_cycles.length} dev circular dependencies (normal, non-blocking):`));
+    lines.push('');
+    lines.push(st('dim', `ℹ️  Found ${analysis.dev_cycles.length} dev circular dependencies (normal, non-blocking):`));
     for (const cycle of analysis.dev_cycles) {
         lines.push(st('dim', `  ${cycle.join(' → ')}`));
     }
@@ -35,7 +39,8 @@ export const format_production_cycles = (analysis) => {
     if (analysis.production_cycles.length === 0)
         return [];
     const lines = [];
-    lines.push(st('red', `\n❌ Found ${analysis.production_cycles.length} production/peer circular dependencies (blocks publishing):`));
+    lines.push('');
+    lines.push(st('red', `❌ Found ${analysis.production_cycles.length} production/peer circular dependencies (blocks publishing):`));
     for (const cycle of analysis.production_cycles) {
         lines.push(`  ${st('red', cycle.join(' → '))}`);
     }
@@ -80,19 +85,3 @@ export const log_dependency_analysis = (analysis, log, indent = '') => {
     log_production_cycles(analysis, log, indent);
     log_dev_cycles(analysis, log, indent);
 };
-/**
- * Logs a simple bulleted list with a header.
- * Common pattern for warnings, info messages, and other lists.
- */
-export const log_list = (items, header, color, log, log_method = 'info') => {
-    if (items.length === 0)
-        return;
-    // Only add newline prefix if header is non-empty
-    const formatted_header = header ? `\n${header}` : '';
-    if (formatted_header) {
-        log[log_method](st(color, formatted_header));
-    }
-    for (const item of items) {
-        log[log_method](st(color, `  • ${item}`));
-    }
-};