@fuzdev/fuz_gitops 0.78.1 → 0.79.0

package/src/lib/repos_status_load.ts

@@ -0,0 +1,173 @@
+/**
+ * Reads fleet git state from the Rust `repos` binary: runs
+ * `repos status <keys…> --json` through the injected `ReposOperations` and
+ * parses what it printed with the `repos_status.ts` mirror.
+ *
+ * Parsing is pure (`parse_repos_status_output`): the format version is read
+ * first, so a binary and npm package out of step fail with both versions and
+ * the install command rather than a schema error; then the document is parsed
+ * strictly as a report or, when it carries `error`, as an error document,
+ * whose kind maps to a message saying what to change.
+ *
+ * @module
+ */
+
+import type { Result } from '@fuzdev/fuz_util/result.ts';
+import { z } from 'zod';
+
+import {
+	REPOS_STATUS_FORMAT_VERSION,
+	ReposStatusErrorReport,
+	ReposStatusReport,
+	type ReposStatusErrorBody
+} from './repos_status.ts';
+import type { ReposCommandOutput, ReposOperations } from './operations.ts';
+
+/**
+ * How to install the `repos` binary, run in a `fuz_repos` checkout. The npm
+ * package doesn't carry the binary, so the two are installed separately.
+ */
+export const REPOS_INSTALL_COMMAND = 'cargo install --path crates/fuz_repos --locked';
+
+/**
+ * The `repos` invocation a suggested fix names: `repos`, or `repos --registry
+ * <path>` when the run passed one, the path POSIX-shell-quoted when it needs it.
+ *
+ * @param registry - the run's `--registry`, if any
+ * @returns the command prefix, ready for a subcommand
+ */
+export const to_repos_command = (registry: string | undefined): string =>
+	registry === undefined ? 'repos' : `repos --registry ${shell_quote(registry)}`;
+
+const shell_quote = (arg: string): string =>
+	/^[\w@%+=:,./-]+$/.test(arg) ? arg : `'${arg.replaceAll("'", `'\\''`)}'`;
+
+/**
+ * Why `repos status` gave no report: a message saying what to change, and the
+ * error document when `repos` printed one.
+ */
+export interface ReposStatusLoadFailure {
+	message: string;
+	error?: ReposStatusErrorBody;
+}
+
+/**
+ * Parses what `repos status --json` printed into its report, or a message
+ * saying what went wrong and what to change.
+ *
+ * @param output - the command's stdout, stderr, and exit code
+ * @returns the report, or a message naming the error document's kind and hint, a format version mismatch, or output that isn't a status document; an error document rides along as `error`
+ */
+export const parse_repos_status_output = (
+	output: ReposCommandOutput
+): Result<{ report: ReposStatusReport }, ReposStatusLoadFailure> => {
+	const { stdout, stderr, exit_code } = output;
+
+	let json: unknown;
+	try {
+		json = JSON.parse(stdout);
+	} catch {
+		// exit 1 is a fatal I/O error, which may print no JSON
+		const detail = stderr.trim() || stdout.trim() || 'no output';
+		return {
+			ok: false,
+			message: `\`repos status --json\` exited ${exit_code} without a JSON document: ${detail}`
+		};
+	}
+
+	if (typeof json !== 'object' || json === null || Array.isArray(json)) {
+		return { ok: false, message: '`repos status --json` printed JSON that is not a document' };
+	}
+
+	const version = 'version' in json ? json.version : undefined;
+	if (version !== REPOS_STATUS_FORMAT_VERSION) {
+		const fix =
+			typeof version === 'number' && version > REPOS_STATUS_FORMAT_VERSION
+				? "upgrade @fuzdev/fuz_gitops to match the binary, or install the binary from a fuz_repos checkout at this package's version"
+				: "install the binary from a fuz_repos checkout at this package's version";
+		return {
+			ok: false,
+			message:
+				`the \`repos\` binary prints status format ${JSON.stringify(version ?? null)}, ` +
+				`but this @fuzdev/fuz_gitops parses format ${REPOS_STATUS_FORMAT_VERSION}: ` +
+				`${fix} (\`${REPOS_INSTALL_COMMAND}\`) — the npm package and the binary are installed separately`
+		};
+	}
+
+	if ('error' in json) {
+		const parsed = ReposStatusErrorReport.safeParse(json);
+		if (!parsed.success) {
+			return {
+				ok: false,
+				message: `\`repos status --json\` printed an error document this package can't parse:\n${z.prettifyError(parsed.error)}`
+			};
+		}
+		return {
+			ok: false,
+			message: format_repos_status_error(parsed.data.error),
+			error: parsed.data.error
+		};
+	}
+
+	const parsed = ReposStatusReport.safeParse(json);
+	if (!parsed.success) {
+		return {
+			ok: false,
+			message: `\`repos status --json\` printed a report this package can't parse:\n${z.prettifyError(parsed.error)}`
+		};
+	}
+	return { ok: true, report: parsed.data };
+};
+
+const format_repos_status_error = (error: ReposStatusErrorBody): string => {
+	switch (error.kind) {
+		case 'unknown_entry': {
+			const suggestions = error.suggestions.length
+				? ` — did you mean ${error.suggestions.map((s) => `\`${s}\``).join(', ')}?`
+				: '';
+			return `the gitops config lists \`${error.name}\`, which the registry (repos.toml) doesn't name${suggestions}`;
+		}
+		case 'registry_not_found':
+			return (
+				`${error.message}: the gitops tasks read repo state from a repos.toml registry — ` +
+				`run inside its workspace, or pass \`--registry <path>\``
+			);
+		default: {
+			const hint = error.hint ? `\n  hint: ${error.hint}` : '';
+			return `\`repos status\` failed (${error.kind}): ${error.message}${hint}`;
+		}
+	}
+};
+
+/**
+ * Runs `repos status <keys…> --json` and parses its report.
+ *
+ * @param options.keys - the registry keys to report on; must not be empty, since no targets means every entry
+ * @param options.registry - a `repos.toml` to use instead of the one found walking up from the cwd
+ * @param options.fetch - fetch each entry from origin first (`--fetch`), which writes remote-tracking refs and nothing else
+ * @param options.repos_ops - the `repos` runner
+ * @returns the report, or a message saying what went wrong and what to change
+ */
+export const load_repos_status = async (options: {
+	keys: Array<string>;
+	registry?: string;
+	fetch?: boolean;
+	repos_ops: ReposOperations;
+}): Promise<Result<{ report: ReposStatusReport }, ReposStatusLoadFailure>> => {
+	const { keys, registry, fetch, repos_ops } = options;
+	if (keys.length === 0) {
+		// `repos status` with no targets reports every entry
+		return { ok: false, message: 'no registry keys to report on' };
+	}
+	const ran = await repos_ops.status(fetch ? { keys, registry, fetch } : { keys, registry });
+	if (!ran.ok) {
+		return {
+			ok: false,
+			message:
+				ran.kind === 'not_found'
+					? `the \`repos\` binary was not found on PATH: install it from a fuz_repos checkout with \`${REPOS_INSTALL_COMMAND}\` — the npm package doesn't carry it`
+					: `\`repos status\` didn't run: ${ran.message}`
+		};
+	}
+	return parse_repos_status_output(ran.output);
+};

package/dist/config_reconcile.d.ts

@@ -1,46 +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.js';
-/** Repo fields that must agree across every config that lists the repo. */
-declare const INTRINSIC_FIELDS: readonly ["visibility", "ci", "archived", "branch"];
-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>;
-}
-/**
- * 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 declare const reconcile_configs: (canonical: NamedRepos, subsets: Array<NamedRepos>) => Array<ConfigDrift>;
-export {};
-//# sourceMappingURL=config_reconcile.d.ts.map

package/dist/config_reconcile.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config_reconcile.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/config_reconcile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,2EAA2E;AAC3E,QAAA,MAAM,gBAAgB,qDAAsD,CAAC;AAE7E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,MAAM,MAAM,eAAe;AAC1B,2EAA2E;AACzE,wBAAwB;AAC1B,gFAAgF;GAC9E,gBAAgB,CAAC;AAEpB,MAAM,WAAW,WAAW;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,eAAe,CAAC;IACtB,uEAAuE;IACvE,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;CAC/B;AAeD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC7B,WAAW,UAAU,EACrB,SAAS,KAAK,CAAC,UAAU,CAAC,KACxB,KAAK,CAAC,WAAW,CA+BnB,CAAC"}

package/dist/config_reconcile.js

@@ -1,64 +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
- */
-/** Repo fields that must agree across every config that lists the repo. */
-const INTRINSIC_FIELDS = ['visibility', 'ci', 'archived', 'branch'];
-const field_value = (repo, field) => {
-    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, subsets) => {
-    const drift = [];
-    const canonical_by_url = new Map(canonical.repos.map((r) => [r.repo_url, r]));
-    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/dist/paths.d.ts

@@ -1,7 +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 declare const DEFAULT_REPOS_DIR = "..";
-//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/paths.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,OAAO,CAAC"}

package/dist/paths.js

@@ -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/dist/repo_ops.d.ts

@@ -1,59 +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
- */
-/** Default directories to exclude from file walking */
-export declare const DEFAULT_EXCLUDE_DIRS: readonly ["node_modules", ".git", ".gro", ".svelte-kit", ".deno", ".vscode", ".idea", "dist", "build", "coverage", ".cache", ".turbo"];
-/** Default binary/non-text extensions to exclude from content processing */
-export declare const DEFAULT_EXCLUDE_EXTENSIONS: readonly [".png", ".jpg", ".jpeg", ".gif", ".svg", ".ico", ".webp", ".woff", ".woff2", ".ttf", ".eot", ".mp4", ".webm", ".mp3", ".wav", ".ogg", ".zip", ".tar", ".gz", ".lock", ".pdf"];
-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 declare const get_repo_paths: (config_path?: string) => Promise<Array<RepoPath>>;
-/**
- * Check if a path should be excluded based on options.
- */
-export declare const should_exclude_path: (file_path: string, options?: WalkOptions) => boolean;
-/**
- * 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 declare function walk_repo_files(dir: string, options?: WalkOptions): AsyncGenerator<string, void, undefined>;
-/**
- * Collect all files from `walk_repo_files` into an array.
- * Convenience function for when you need all paths upfront.
- */
-export declare const collect_repo_files: (dir: string, options?: WalkOptions) => Promise<Array<string>>;
-//# sourceMappingURL=repo_ops.d.ts.map

package/dist/repo_ops.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"repo_ops.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/repo_ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,uDAAuD;AACvD,eAAO,MAAM,oBAAoB,wIAavB,CAAC;AAEX,4EAA4E;AAC5E,eAAO,MAAM,0BAA0B,yLAsB7B,CAAC;AAEX,MAAM,WAAW,WAAW;IAC3B,+DAA+D;IAC/D,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,8DAA8D;IAC9D,kBAAkB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACnC,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sDAAsD;IACtD,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAU,cAAc,MAAM,KAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CA4BlF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,WAAW,MAAM,EAAE,UAAU,WAAW,KAAG,OA2B9E,CAAC;AAEF;;;;;;GAMG;AACH,wBAAuB,eAAe,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,WAAW,GACnB,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAwCzC;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC9B,KAAK,MAAM,EACX,UAAU,WAAW,KACnB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAMvB,CAAC"}

package/dist/repo_ops.js

@@ -1,170 +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.js';
-import { DEFAULT_REPOS_DIR } from './paths.js';
-import { GITOPS_CONFIG_PATH_DEFAULT } from './gitops_constants.js';
-/** 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'
-];
-/** 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'
-];
-/**
- * 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) => {
-    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 = [];
-    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, options) => {
-    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, options) {
-    const max_file_size = options?.max_file_size ?? 10 * 1024 * 1024;
-    const include_dirs = options?.include_dirs ?? false;
-    async function* walk(current_dir) {
-        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, options) => {
-    const files = [];
-    for await (const file of walk_repo_files(dir, options)) {
-        files.push(file);
-    }
-    return files;
-};

package/dist/resolved_gitops_config.d.ts

@@ -1,9 +0,0 @@
-import type { GitopsConfig } from './gitops_config.js';
-import { type LocalRepoPath, type LocalRepoMissing } from './local_repo.js';
-export interface ResolvedGitopsConfig {
-    local_repos: Array<LocalRepoPath | LocalRepoMissing> | null;
-    local_repo_paths: Array<LocalRepoPath> | null;
-    local_repos_missing: Array<LocalRepoMissing> | null;
-}
-export declare const resolve_gitops_config: (gitops_config: GitopsConfig, repos_dir: string) => ResolvedGitopsConfig;
-//# sourceMappingURL=resolved_gitops_config.d.ts.map

package/dist/resolved_gitops_config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolved_gitops_config.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/resolved_gitops_config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAqB,KAAK,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE/F,MAAM,WAAW,oBAAoB;IACpC,WAAW,EAAE,KAAK,CAAC,aAAa,GAAG,gBAAgB,CAAC,GAAG,IAAI,CAAC;IAC5D,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IAC9C,mBAAmB,EAAE,KAAK,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;CACpD;AAED,eAAO,MAAM,qBAAqB,GACjC,eAAe,YAAY,EAC3B,WAAW,MAAM,KACf,oBAcF,CAAC"}

package/dist/resolved_gitops_config.js

@@ -1,12 +0,0 @@
-import { local_repo_locate } from './local_repo.js';
-export const resolve_gitops_config = (gitops_config, repos_dir) => {
-    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 = {
-        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;
-};

package/src/lib/config_reconcile.ts

@@ -1,98 +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 = '..';