@fuzdev/fuz_gitops 0.78.0 → 0.78.1

package/src/lib/gitops_analyze.task.ts

@@ -1,42 +1,42 @@
-import type {Task} from '@fuzdev/gro';
-import {z} from 'zod';
-import {styleText as st} from 'node:util';
-import type {Logger} from '@fuzdev/fuz_util/log.ts';
+import type { Task } from '@fuzdev/gro';
+import { z } from 'zod';
+import { styleText as st } from 'node:util';
+import type { Logger } from '@fuzdev/fuz_util/log.ts';
 
-import {get_gitops_ready} from './gitops_task_helpers.ts';
-import type {DependencyGraph} from './dependency_graph.ts';
-import {repo_is_npm} from './local_repo.ts';
-import {analyze_repos, type DependencyAnalysis} from './graph_validation.ts';
+import { get_gitops_ready } from './gitops_task_helpers.ts';
+import type { DependencyGraph } from './dependency_graph.ts';
+import { repo_is_npm } from './local_repo.ts';
+import { analyze_repos, type DependencyAnalysis } from './graph_validation.ts';
 import {
 	format_wildcard_dependencies,
 	format_dev_cycles,
-	format_production_cycles,
+	format_production_cycles
 } from './log_helpers.ts';
-import {format_and_output, type OutputFormatters} from './output_helpers.ts';
-import {GITOPS_CONFIG_PATH_DEFAULT} from './gitops_constants.ts';
+import { format_and_output, type OutputFormatters } from './output_helpers.ts';
+import { GITOPS_CONFIG_PATH_DEFAULT } from './gitops_constants.ts';
 
 /** @nodocs */
 export const Args = z.strictObject({
 	config: z
 		.string()
-		.meta({description: 'path to the gitops config file, absolute or relative to the cwd'})
+		.meta({ description: 'path to the gitops config file, absolute or relative to the cwd' })
 		.default(GITOPS_CONFIG_PATH_DEFAULT),
 	dir: z
 		.string()
-		.meta({description: 'path containing the repos, defaults to the parent of the config dir'})
+		.meta({ description: 'path containing the repos, defaults to the parent of the config dir' })
 		.optional(),
 	format: z
 		.enum(['stdout', 'json', 'markdown'])
-		.meta({description: 'output format'})
+		.meta({ description: 'output format' })
 		.default('stdout'),
-	outfile: z.string().meta({description: 'write output to file instead of logging'}).optional(),
+	outfile: z.string().meta({ description: 'write output to file instead of logging' }).optional(),
 	sync: z
 		.boolean()
 		.meta({
 			description:
-				'sync repos (switch branch, pull, install) before analyzing instead of reading the working tree as-is',
+				'sync repos (switch branch, pull, install) before analyzing instead of reading the working tree as-is'
 		})
-		.default(false),
+		.default(false)
 });
 export type Args = z.infer<typeof Args>;
 
@@ -44,11 +44,11 @@ export type Args = z.infer<typeof Args>;
 export const task: Task<Args> = {
 	Args,
 	summary: 'analyze dependency structure and relationships across repos',
-	run: async ({args, log}) => {
-		const {config, dir, format, outfile, sync} = args;
+	run: async ({ args, log }) => {
+		const { config, dir, format, outfile, sync } = args;
 
 		// Get repos ready (without downloading); read the working tree as-is unless `--sync`
-		const {local_repos} = await get_gitops_ready({config, dir, download: false, sync, log});
+		const { local_repos } = await get_gitops_ready({ config, dir, download: false, sync, log });
 
 		// Only npm packages form the dependency graph; note any non-npm repos (e.g. cargo)
 		// that are excluded so the omission isn't silent.
@@ -58,23 +58,23 @@ export const task: Task<Args> = {
 				st(
 					'dim',
 					`excluding ${non_npm_repos.length} non-npm repo(s) from analysis (dashboard-only): ` +
-						non_npm_repos.map((r) => r.library.name).join(', '),
-				),
+						non_npm_repos.map((r) => r.library.name).join(', ')
+				)
 			);
 		}
 
 		// Build the dependency graph and analyze cycles/wildcards (tolerating cycles)
-		const {graph, analysis, publishing_order} = analyze_repos(local_repos);
+		const { graph, analysis, publishing_order } = analyze_repos(local_repos);
 
 		// Format and output using output_helpers
 		const data = {
 			graph,
 			analysis,
-			publishing_order,
+			publishing_order
 		};
 
-		await format_and_output(data, create_formatters(), {format, outfile, log});
-	},
+		await format_and_output(data, create_formatters(), { format, outfile, log });
+	}
 };
 
 // Data type for analysis output
@@ -88,32 +88,32 @@ interface AnalysisData {
 const create_formatters = (): OutputFormatters<AnalysisData> => ({
 	json: (data) => format_json(data.graph, data.analysis, data.publishing_order),
 	markdown: (data) => format_markdown(data.graph, data.analysis, data.publishing_order),
-	stdout: (data, log) => format_stdout(data.graph, data.analysis, data.publishing_order, log),
+	stdout: (data, log) => format_stdout(data.graph, data.analysis, data.publishing_order, log)
 });
 
 // Helper to calculate common statistics
 const calculate_stats = (graph: DependencyGraph) => {
 	const total_deps = Array.from(graph.nodes.values()).reduce(
 		(sum, node) => sum + node.dependencies.size,
-		0,
+		0
 	);
 	const internal_deps = Array.from(graph.nodes.values()).reduce(
 		(sum, node) =>
 			sum + Array.from(node.dependencies.keys()).filter((name) => graph.nodes.has(name)).length,
-		0,
+		0
 	);
-	return {total_deps, internal_deps};
+	return { total_deps, internal_deps };
 };
 
 const format_json = (
 	graph: DependencyGraph,
 	analysis: DependencyAnalysis,
-	publishing_order: Array<string> | null,
+	publishing_order: Array<string> | null
 ): string => {
 	const output = {
 		graph: graph.toJSON(),
 		analysis,
-		publishing_order,
+		publishing_order
 	};
 	return JSON.stringify(output, null, 2);
 };
@@ -121,12 +121,12 @@ const format_json = (
 const format_markdown = (
 	graph: DependencyGraph,
 	analysis: DependencyAnalysis,
-	publishing_order: Array<string> | null,
+	publishing_order: Array<string> | null
 ): Array<string> => {
 	const lines: Array<string> = ['# Dependency Analysis'];
 
 	// Summary stats
-	const {total_deps, internal_deps} = calculate_stats(graph);
+	const { total_deps, internal_deps } = calculate_stats(graph);
 
 	lines.push('', '## Summary', '');
 	lines.push(`- **Total packages**: ${graph.nodes.size}`);
@@ -170,7 +170,7 @@ const format_markdown = (
 		lines.push('', '## ⚠️ Wildcard Dependencies', '');
 		lines.push('| Package | Dependency | Version |');
 		lines.push('|---------|------------|---------|');
-		for (const {pkg, dep, version} of analysis.wildcard_deps) {
+		for (const { pkg, dep, version } of analysis.wildcard_deps) {
 			lines.push(`| \`${pkg}\` | \`${dep}\` | \`${version}\` |`);
 		}
 	}
@@ -179,7 +179,7 @@ const format_markdown = (
 	lines.push('', '## Internal Dependencies', '');
 	for (const node of graph.nodes.values()) {
 		const internal_deps = Array.from(node.dependencies.entries()).filter(([name]) =>
-			graph.nodes.has(name),
+			graph.nodes.has(name)
 		);
 		if (internal_deps.length > 0) {
 			lines.push(`- **${node.name}**`);
@@ -197,7 +197,7 @@ const format_stdout = (
 	graph: DependencyGraph,
 	analysis: DependencyAnalysis,
 	publishing_order: Array<string> | null,
-	log: Logger,
+	log: Logger
 ): void => {
 	log.info(st('cyan', `📊 Analyzing ${graph.nodes.size} repositories...`));
 
@@ -216,14 +216,14 @@ const format_stdout = (
 	log.info(st('yellow', 'Dependency relationships:'));
 	for (const node of graph.nodes.values()) {
 		const internal_deps = Array.from(node.dependencies.entries()).filter(([name]) =>
-			graph.nodes.has(name),
+			graph.nodes.has(name)
 		);
 		if (internal_deps.length > 0) {
 			log.info(`  ${st('cyan', node.name)}`);
 			for (const [dep_name, spec] of internal_deps) {
 				const type_color = spec.type === 'peer' ? 'magenta' : spec.type === 'dev' ? 'dim' : 'white';
 				log.info(
-					`    ${st(type_color, '→')} ${dep_name} ${st('dim', `(${spec.type}: ${spec.version})`)}`,
+					`    ${st(type_color, '→')} ${dep_name} ${st('dim', `(${spec.type}: ${spec.version})`)}`
 				);
 			}
 		}
@@ -252,7 +252,7 @@ const format_stdout = (
 	}
 
 	// Summary
-	const {total_deps, internal_deps} = calculate_stats(graph);
+	const { total_deps, internal_deps } = calculate_stats(graph);
 
 	log.info('');
 	log.info(st('cyan', 'Summary:'));

package/src/lib/gitops_config.ts

@@ -11,12 +11,12 @@
  * @module
  */
 
-import type {Url} from '@fuzdev/fuz_util/url.ts';
-import {existsSync} from 'node:fs';
-import {strip_end} from '@fuzdev/fuz_util/string.ts';
-import type {GitBranch} from '@fuzdev/fuz_util/git.ts';
+import type { Url } from '@fuzdev/fuz_util/url.ts';
+import { existsSync } from 'node:fs';
+import { strip_end } from '@fuzdev/fuz_util/string.ts';
+import type { GitBranch } from '@fuzdev/fuz_util/git.ts';
 
-import {DEFAULT_REPOS_DIR} from './paths.ts';
+import { DEFAULT_REPOS_DIR } from './paths.ts';
 
 export interface GitopsConfig {
 	repos: Array<GitopsRepoConfig>;
@@ -24,7 +24,7 @@ export interface GitopsConfig {
 }
 
 export type CreateGitopsConfig = (
-	base_config: GitopsConfig,
+	base_config: GitopsConfig
 ) => RawGitopsConfig | Promise<RawGitopsConfig>;
 
 export interface RawGitopsConfig {
@@ -99,7 +99,7 @@ export interface RawGitopsRepoConfig {
 
 export const create_empty_gitops_config = (): GitopsConfig => ({
 	repos: [],
-	repos_dir: DEFAULT_REPOS_DIR,
+	repos_dir: DEFAULT_REPOS_DIR
 });
 
 /**
@@ -110,11 +110,11 @@ export const normalize_gitops_config = (raw_config: RawGitopsConfig): GitopsConf
 	const empty_config = create_empty_gitops_config();
 	// All of the raw config properties are optional,
 	// so fall back to the empty values when `undefined`.
-	const {repos, repos_dir} = raw_config;
+	const { repos, repos_dir } = raw_config;
 	return {
 		repos: repos ? repos.map((r) => parse_fuz_repo_config(r)) : empty_config.repos,
 		// Default to two dirs up from config if not specified
-		repos_dir: repos_dir ?? DEFAULT_REPOS_DIR,
+		repos_dir: repos_dir ?? DEFAULT_REPOS_DIR
 	};
 };
 
@@ -126,7 +126,7 @@ const parse_fuz_repo_config = (r: Url | RawGitopsRepoConfig): GitopsRepoConfig =
 			branch: 'main' as GitBranch, // TODO @zts use flavored for GitBranch
 			visibility: 'public',
 			ci: true,
-			archived: false,
+			archived: false
 		};
 	}
 	const visibility = r.visibility ?? 'public';
@@ -136,7 +136,7 @@ const parse_fuz_repo_config = (r: Url | RawGitopsRepoConfig): GitopsRepoConfig =
 		branch: r.branch ?? ('main' as GitBranch), // TODO @zts use flavored for GitBranch
 		visibility,
 		ci: r.ci ?? visibility === 'public',
-		archived: r.archived ?? false,
+		archived: r.archived ?? false
 	};
 };
 
@@ -155,20 +155,20 @@ export const load_gitops_config = async (config_path: string): Promise<GitopsCon
 	return normalize_gitops_config(
 		typeof config_module.default === 'function'
 			? await config_module.default(create_empty_gitops_config())
-			: config_module.default,
+			: config_module.default
 	);
 };
 
 export const validate_gitops_config_module: (
 	config_module: any,
-	config_path: string,
+	config_path: string
 ) => asserts config_module is GitopsConfigModule = (config_module, config_path) => {
 	const config = config_module.default;
 	if (!config) {
 		throw Error(`Invalid Fuz config module at ${config_path}: expected a default export`);
 	} else if (!(typeof config === 'function' || typeof config === 'object')) {
 		throw Error(
-			`Invalid Fuz config module at ${config_path}: the default export must be a function or object`,
+			`Invalid Fuz config module at ${config_path}: the default export must be a function or object`
 		);
 	}
 };

package/src/lib/gitops_plan.task.ts

@@ -1,40 +1,40 @@
-import type {Task} from '@fuzdev/gro';
-import {z} from 'zod';
-import {styleText as st} from 'node:util';
+import type { Task } from '@fuzdev/gro';
+import { z } from 'zod';
+import { styleText as st } from 'node:util';
 
-import {get_gitops_ready} from './gitops_task_helpers.ts';
+import { get_gitops_ready } from './gitops_task_helpers.ts';
 import {
 	generate_publishing_plan,
 	log_publishing_plan,
 	type PublishingPlan,
-	type LogPlanOptions,
+	type LogPlanOptions
 } from './publishing_plan.ts';
-import {format_and_output, type OutputFormatters} from './output_helpers.ts';
-import {GITOPS_CONFIG_PATH_DEFAULT} from './gitops_constants.ts';
+import { format_and_output, type OutputFormatters } from './output_helpers.ts';
+import { GITOPS_CONFIG_PATH_DEFAULT } from './gitops_constants.ts';
 
 /** @nodocs */
 export const Args = z.strictObject({
 	config: z
 		.string()
-		.meta({description: 'path to the gitops config file, absolute or relative to the cwd'})
+		.meta({ description: 'path to the gitops config file, absolute or relative to the cwd' })
 		.default(GITOPS_CONFIG_PATH_DEFAULT),
 	dir: z
 		.string()
-		.meta({description: 'path containing the repos, defaults to the parent of the config dir'})
+		.meta({ description: 'path containing the repos, defaults to the parent of the config dir' })
 		.optional(),
 	format: z
 		.enum(['stdout', 'json', 'markdown'])
-		.meta({description: 'output format'})
+		.meta({ description: 'output format' })
 		.default('stdout'),
-	outfile: z.string().meta({description: 'write output to file instead of logging'}).optional(),
-	verbose: z.boolean().meta({description: 'show additional details'}).default(false),
+	outfile: z.string().meta({ description: 'write output to file instead of logging' }).optional(),
+	verbose: z.boolean().meta({ description: 'show additional details' }).default(false),
 	sync: z
 		.boolean()
 		.meta({
 			description:
-				'sync repos (switch branch, pull, install) before planning instead of reading the working tree as-is',
+				'sync repos (switch branch, pull, install) before planning instead of reading the working tree as-is'
 		})
-		.default(false),
+		.default(false)
 });
 export type Args = z.infer<typeof Args>;
 
@@ -52,18 +52,18 @@ export type Args = z.infer<typeof Args>;
 export const task: Task<Args> = {
 	summary: 'generate a publishing plan based on changesets',
 	Args,
-	run: async ({args, log}): Promise<void> => {
-		const {dir, config, format, outfile, verbose, sync} = args;
+	run: async ({ args, log }): Promise<void> => {
+		const { dir, config, format, outfile, verbose, sync } = args;
 
 		log.info(st('cyan', 'Generating multi-repo publishing plan...'));
 
 		// Load local repos; read the working tree as-is unless `--sync`
-		const {local_repos} = await get_gitops_ready({
+		const { local_repos } = await get_gitops_ready({
 			config,
 			dir,
 			download: false, // Don't download if missing
 			sync,
-			log,
+			log
 		});
 
 		if (local_repos.length === 0) {
@@ -74,20 +74,20 @@ export const task: Task<Args> = {
 		log.info(`  Found ${local_repos.length} local repos`);
 
 		// Generate publishing plan
-		const plan = await generate_publishing_plan(local_repos, {log, verbose});
+		const plan = await generate_publishing_plan(local_repos, { log, verbose });
 
 		// Format and output using output_helpers
-		await format_and_output(plan, create_plan_formatters({verbose}), {format, outfile, log});
+		await format_and_output(plan, create_plan_formatters({ verbose }), { format, outfile, log });
 
 		// Exit with error if there are blocking issues
 		if (plan.errors.length > 0) {
 			throw new Error('Publishing plan found errors that would block publishing');
 		}
-	},
+	}
 };
 
 const create_plan_formatters = (
-	options: LogPlanOptions = {},
+	options: LogPlanOptions = {}
 ): OutputFormatters<PublishingPlan> => ({
 	json: (plan) => {
 		const output = {
@@ -97,12 +97,12 @@ const create_plan_formatters = (
 			breaking_cascades: Object.fromEntries(plan.breaking_cascades),
 			warnings: plan.warnings,
 			info: plan.info,
-			errors: plan.errors,
+			errors: plan.errors
 		};
 		return JSON.stringify(output, null, 2);
 	},
 	markdown: (plan) => format_plan_as_markdown(plan),
-	stdout: (plan, log) => log_publishing_plan(plan, log, options),
+	stdout: (plan, log) => log_publishing_plan(plan, log, options)
 });
 
 const format_plan_as_markdown = (plan: PublishingPlan): Array<string> => {
@@ -114,7 +114,7 @@ const format_plan_as_markdown = (plan: PublishingPlan): Array<string> => {
 		breaking_cascades,
 		warnings,
 		info,
-		errors,
+		errors
 	} = plan;
 
 	lines.push('# Publishing Plan');
@@ -141,7 +141,7 @@ const format_plan_as_markdown = (plan: PublishingPlan): Array<string> => {
 	// Version changes
 	if (version_changes.length > 0) {
 		const with_changesets = version_changes.filter(
-			(vc) => vc.has_changesets && !vc.needs_bump_escalation,
+			(vc) => vc.has_changesets && !vc.needs_bump_escalation
 		);
 		const with_escalation = version_changes.filter((vc) => vc.needs_bump_escalation);
 		const with_auto_changesets = version_changes.filter((vc) => vc.will_generate_changeset);
@@ -154,7 +154,7 @@ const format_plan_as_markdown = (plan: PublishingPlan): Array<string> => {
 			for (const change of with_changesets) {
 				const is_major = change.bump_type === 'major' ? '💥 Yes' : 'No';
 				lines.push(
-					`| \`${change.package_name}\` | ${change.from} | ${change.to} | ${change.bump_type} | ${is_major} |`,
+					`| \`${change.package_name}\` | ${change.from} | ${change.to} | ${change.bump_type} | ${is_major} |`
 				);
 			}
 			lines.push('');
@@ -168,12 +168,12 @@ const format_plan_as_markdown = (plan: PublishingPlan): Array<string> => {
 			for (const change of with_escalation) {
 				const is_major = change.bump_type === 'major' ? '💥 Yes' : 'No';
 				lines.push(
-					`| \`${change.package_name}\` | ${change.from} | ${change.to} | ${change.existing_bump} | ${change.required_bump} | ${is_major} |`,
+					`| \`${change.package_name}\` | ${change.from} | ${change.to} | ${change.existing_bump} | ${change.required_bump} | ${is_major} |`
 				);
 			}
 			lines.push('');
 			lines.push(
-				'> ⬆️ These packages have changesets, but dependencies require a larger version bump.',
+				'> ⬆️ These packages have changesets, but dependencies require a larger version bump.'
 			);
 			lines.push('');
 		}
@@ -186,7 +186,7 @@ const format_plan_as_markdown = (plan: PublishingPlan): Array<string> => {
 			for (const change of with_auto_changesets) {
 				const is_major = change.bump_type === 'major' ? '💥 Yes' : 'No';
 				lines.push(
-					`| \`${change.package_name}\` | ${change.from} | ${change.to} | ${change.bump_type} | ${is_major} |`,
+					`| \`${change.package_name}\` | ${change.from} | ${change.to} | ${change.bump_type} | ${is_major} |`
 				);
 			}
 			lines.push('');
@@ -234,7 +234,7 @@ const format_plan_as_markdown = (plan: PublishingPlan): Array<string> => {
 							? 'peer'
 							: 'dev';
 				lines.push(
-					`- "${update.updated_dependency}": "${update.current_version}"  # ${type_label}`,
+					`- "${update.updated_dependency}": "${update.current_version}"  # ${type_label}`
 				);
 				lines.push(`+ "${update.updated_dependency}": "${update.new_version}"  # ${type_label}`);
 			}