@fuzdev/fuz_gitops 0.78.0 → 0.79.0

package/src/lib/config_reconcile.ts

@@ -1,94 +0,0 @@
-/**
- * Reconciles repo metadata across multiple gitops configs.
- *
- * The ecosystem keeps several gitops configs — a canonical superset plus
- * narrower per-project subsets. They can't share one source of truth (the
- * superset includes private repos that public configs may not reference), so the
- * same repo is declared independently in each. This check flags when a subset's
- * intrinsic fields drift from the canonical config, or when a subset lists a
- * repo the canonical config doesn't. `repo_dir` is per-config and ignored.
- *
- * @module
- */
-
-import type {GitopsRepoConfig} from './gitops_config.ts';
-
-/** Repo fields that must agree across every config that lists the repo. */
-const INTRINSIC_FIELDS = ['visibility', 'ci', 'archived', 'branch'] as const;
-
-export type IntrinsicField = (typeof INTRINSIC_FIELDS)[number];
-
-export type ConfigDriftKind =
-	/** The repo is in a subset config but absent from the canonical config. */
-	| 'missing_from_canonical'
-	/** An intrinsic field disagrees between the subset and the canonical config. */
-	| 'field_mismatch';
-
-export interface ConfigDrift {
-	repo_url: string;
-	/** Name of the subset config whose entry diverges. */
-	config: string;
-	kind: ConfigDriftKind;
-	/** The field that disagrees, set when `kind` is `'field_mismatch'`. */
-	field?: IntrinsicField;
-	/** The canonical config's value, set when `kind` is `'field_mismatch'`. */
-	canonical_value?: string;
-	/** The subset config's value, set when `kind` is `'field_mismatch'`. */
-	config_value?: string;
-}
-
-export interface NamedRepos {
-	name: string;
-	repos: Array<GitopsRepoConfig>;
-}
-
-const field_value = (repo: GitopsRepoConfig, field: IntrinsicField): string => {
-	switch (field) {
-		case 'visibility':
-			return repo.visibility;
-		case 'ci':
-			return String(repo.ci);
-		case 'archived':
-			return String(repo.archived);
-		case 'branch':
-			return repo.branch;
-	}
-};
-
-/**
- * Compares each subset config against the canonical config. Repos that live only
- * in the canonical config are fine — the subsets are intentional partial views.
- * @returns one `ConfigDrift` per subset entry that is missing from the canonical
- * config or whose intrinsic fields disagree with it
- */
-export const reconcile_configs = (
-	canonical: NamedRepos,
-	subsets: Array<NamedRepos>,
-): Array<ConfigDrift> => {
-	const drift: Array<ConfigDrift> = [];
-	const canonical_by_url = new Map(canonical.repos.map((r) => [r.repo_url, r] as const));
-	for (const subset of subsets) {
-		for (const repo of subset.repos) {
-			const canon = canonical_by_url.get(repo.repo_url);
-			if (!canon) {
-				drift.push({repo_url: repo.repo_url, config: subset.name, kind: 'missing_from_canonical'});
-				continue;
-			}
-			for (const field of INTRINSIC_FIELDS) {
-				const canonical_value = field_value(canon, field);
-				const config_value = field_value(repo, field);
-				if (canonical_value !== config_value) {
-					drift.push({
-						repo_url: repo.repo_url,
-						config: subset.name,
-						kind: 'field_mismatch',
-						field,
-						canonical_value,
-						config_value,
-					});
-				}
-			}
-		}
-	}
-	return drift;
-};

package/src/lib/paths.ts

@@ -1,6 +0,0 @@
-/**
- * Default repos directory relative to gitops config file.
- * Resolves to the parent of the directory with the config
- * (e.g., `~/dev/repo/gitops.config.ts` resolves to `~/dev/`).
- */
-export const DEFAULT_REPOS_DIR = '..';

package/src/lib/repo_ops.ts

@@ -1,216 +0,0 @@
-/**
- * Generic repository operations for scripts that work across repos.
- *
- * Provides lightweight utilities for:
- * - Getting repo paths from gitops config (without full git sync)
- * - Walking files in repos with sensible exclusions
- * - Common exclusion patterns for node/svelte projects
- *
- * For full git sync/clone functionality, use `get_gitops_ready()` from `gitops_task_helpers`.
- *
- * @module
- */
-
-import {existsSync} from 'node:fs';
-import {readdir, stat} from 'node:fs/promises';
-import {join, resolve, dirname} from 'node:path';
-
-import {load_gitops_config} from './gitops_config.ts';
-import {DEFAULT_REPOS_DIR} from './paths.ts';
-import {GITOPS_CONFIG_PATH_DEFAULT} from './gitops_constants.ts';
-
-/** Default directories to exclude from file walking */
-export const DEFAULT_EXCLUDE_DIRS = [
-	'node_modules',
-	'.git',
-	'.gro',
-	'.svelte-kit',
-	'.deno',
-	'.vscode',
-	'.idea',
-	'dist',
-	'build',
-	'coverage',
-	'.cache',
-	'.turbo',
-] as const;
-
-/** Default binary/non-text extensions to exclude from content processing */
-export const DEFAULT_EXCLUDE_EXTENSIONS = [
-	'.png',
-	'.jpg',
-	'.jpeg',
-	'.gif',
-	'.svg',
-	'.ico',
-	'.webp',
-	'.woff',
-	'.woff2',
-	'.ttf',
-	'.eot',
-	'.mp4',
-	'.webm',
-	'.mp3',
-	'.wav',
-	'.ogg',
-	'.zip',
-	'.tar',
-	'.gz',
-	'.lock',
-	'.pdf',
-] as const;
-
-export interface WalkOptions {
-	/** Additional directories to exclude (merged with defaults) */
-	exclude_dirs?: Array<string>;
-	/** Additional extensions to exclude (merged with defaults) */
-	exclude_extensions?: Array<string>;
-	/** Maximum file size in bytes (default: 10MB) */
-	max_file_size?: number;
-	/** Include directories in output (default: false) */
-	include_dirs?: boolean;
-	/** Use only provided exclusions, ignoring defaults */
-	no_defaults?: boolean;
-}
-
-export interface RepoPath {
-	name: string;
-	path: string;
-	url: string;
-}
-
-/**
- * Get repo paths from gitops config without full git sync.
- * Lighter weight than `get_gitops_ready()` - just resolves paths.
- *
- * @param config_path - path to the gitops config file (defaults to `gitops.config.ts`)
- * @returns array of repo info with name, path, and url
- */
-export const get_repo_paths = async (config_path?: string): Promise<Array<RepoPath>> => {
-	const resolved_config_path = resolve(config_path ?? GITOPS_CONFIG_PATH_DEFAULT);
-	const config = await load_gitops_config(resolved_config_path);
-
-	if (!config) {
-		throw new Error(`No gitops config found at ${resolved_config_path}`);
-	}
-
-	const config_dir = dirname(resolved_config_path);
-	const repos_dir = resolve(config_dir, config.repos_dir || DEFAULT_REPOS_DIR);
-
-	const repos: Array<RepoPath> = [];
-
-	for (const repo_config of config.repos) {
-		const url = repo_config.repo_url;
-		const name = url.split('/').at(-1);
-		if (!name) continue;
-
-		const path = repo_config.repo_dir
-			? resolve(config_dir, repo_config.repo_dir)
-			: join(repos_dir, name);
-
-		if (existsSync(path)) {
-			repos.push({name, path, url});
-		}
-	}
-
-	return repos;
-};
-
-/**
- * Check if a path should be excluded based on options.
- */
-export const should_exclude_path = (file_path: string, options?: WalkOptions): boolean => {
-	const exclude_dirs = options?.no_defaults
-		? (options.exclude_dirs ?? [])
-		: [...DEFAULT_EXCLUDE_DIRS, ...(options?.exclude_dirs ?? [])];
-
-	const exclude_extensions = options?.no_defaults
-		? (options.exclude_extensions ?? [])
-		: [...DEFAULT_EXCLUDE_EXTENSIONS, ...(options?.exclude_extensions ?? [])];
-
-	const normalized = file_path.toLowerCase();
-
-	// Check excluded directories
-	for (const dir of exclude_dirs) {
-		// Must match as a full directory component, not a prefix
-		if (normalized.includes(`/${dir}/`) || normalized.endsWith(`/${dir}`)) {
-			return true;
-		}
-	}
-
-	// Check excluded extensions
-	for (const ext of exclude_extensions) {
-		if (normalized.endsWith(ext)) {
-			return true;
-		}
-	}
-
-	return false;
-};
-
-/**
- * Walk files in a directory, respecting common exclusions.
- * Yields absolute paths to files (and optionally directories).
- *
- * @param dir - directory to walk
- * @param options - walk options for exclusions and filtering
- */
-export async function* walk_repo_files(
-	dir: string,
-	options?: WalkOptions,
-): AsyncGenerator<string, void, undefined> {
-	const max_file_size = options?.max_file_size ?? 10 * 1024 * 1024;
-	const include_dirs = options?.include_dirs ?? false;
-
-	async function* walk(current_dir: string): AsyncGenerator<string, void, undefined> {
-		let entries;
-		try {
-			entries = await readdir(current_dir, {withFileTypes: true});
-		} catch {
-			// Skip directories we can't read
-			return;
-		}
-
-		for (const entry of entries) {
-			const full_path = join(current_dir, entry.name);
-
-			if (should_exclude_path(full_path, options)) {
-				continue;
-			}
-
-			if (entry.isDirectory()) {
-				if (include_dirs) {
-					yield full_path;
-				}
-				yield* walk(full_path);
-			} else if (entry.isFile()) {
-				// Check file size
-				try {
-					const file_stat = await stat(full_path);
-					if (file_stat.size <= max_file_size) {
-						yield full_path;
-					}
-				} catch {
-					// Skip files we can't stat
-				}
-			}
-		}
-	}
-
-	yield* walk(dir);
-}
-
-/**
- * Collect all files from `walk_repo_files` into an array.
- * Convenience function for when you need all paths upfront.
- */
-export const collect_repo_files = async (
-	dir: string,
-	options?: WalkOptions,
-): Promise<Array<string>> => {
-	const files: Array<string> = [];
-	for await (const file of walk_repo_files(dir, options)) {
-		files.push(file);
-	}
-	return files;
-};

package/src/lib/resolved_gitops_config.ts

@@ -1,27 +0,0 @@
-import type {GitopsConfig} from './gitops_config.ts';
-import {local_repo_locate, type LocalRepoPath, type LocalRepoMissing} from './local_repo.ts';
-
-export interface ResolvedGitopsConfig {
-	local_repos: Array<LocalRepoPath | LocalRepoMissing> | null;
-	local_repo_paths: Array<LocalRepoPath> | null;
-	local_repos_missing: Array<LocalRepoMissing> | null;
-}
-
-export const resolve_gitops_config = (
-	gitops_config: GitopsConfig,
-	repos_dir: string,
-): ResolvedGitopsConfig => {
-	const local_repos = gitops_config.repos.map((r) =>
-		local_repo_locate({repo_config: r, repos_dir}),
-	);
-
-	const local_repo_paths = local_repos.filter((r) => r.type === 'local_repo_path');
-	const local_repos_missing = local_repos.filter((r) => r.type === 'local_repo_missing');
-
-	const config: ResolvedGitopsConfig = {
-		local_repos: local_repos.length ? local_repos : null,
-		local_repo_paths: local_repo_paths.length ? local_repo_paths : null,
-		local_repos_missing: local_repos_missing.length ? local_repos_missing : null,
-	};
-	return config;
-};