@fuzdev/fuz_gitops 0.78.0 → 0.79.0

package/dist/repos_status_load.js

@@ -0,0 +1,131 @@
+/**
+ * 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 { z } from 'zod';
+import { REPOS_STATUS_FORMAT_VERSION, ReposStatusErrorReport, ReposStatusReport } from './repos_status.js';
+/**
+ * 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) => registry === undefined ? 'repos' : `repos --registry ${shell_quote(registry)}`;
+const shell_quote = (arg) => /^[\w@%+=:,./-]+$/.test(arg) ? arg : `'${arg.replaceAll("'", `'\\''`)}'`;
+/**
+ * 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) => {
+    const { stdout, stderr, exit_code } = output;
+    let json;
+    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) => {
+    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) => {
+    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/version_utils.js

@@ -134,7 +134,7 @@ export const compare_bump_types = (a, b) => {
     const order = {
         major: 3,
         minor: 2,
-        patch: 1,
+        patch: 1
     };
     return order[a] - order[b];
 };

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@fuzdev/fuz_gitops",
-  "version": "0.78.0",
+  "version": "0.79.0",
   "description": "a tool for managing many repos",
   "glyph": "🪄",
   "logo": "logo.svg",
   "logo_alt": "a friendly blue spider facing you",
   "license": "MIT",
   "homepage": "https://gitops.fuz.dev/",
-  "repository": "https://github.com/fuzdev/fuz_gitops",
+  "repository": "https://github.com/fuzdev/fuz_repos",
   "author": {
     "name": "Ryan Atkinson",
     "email": "mail@ryanatkn.com",
     "url": "https://www.ryanatkn.com/"
   },
-  "bugs": "https://github.com/fuzdev/fuz_gitops/issues",
+  "bugs": "https://github.com/fuzdev/fuz_repos/issues",
   "funding": "https://www.ryanatkn.com/funding",
   "scripts": {
     "start": "gro dev",
@@ -39,19 +39,19 @@
   },
   "devDependencies": {
     "@changesets/changelog-git": "^0.2.1",
-    "@fuzdev/blake3_wasm": "^0.1.1",
-    "@fuzdev/fuz_code": "^0.46.1",
-    "@fuzdev/fuz_css": "^0.63.2",
-    "@fuzdev/fuz_ui": "^0.205.1",
-    "@fuzdev/fuz_util": "^0.65.2",
-    "@fuzdev/gro": "^0.205.1",
-    "@fuzdev/mdz": "^0.1.0",
-    "@ryanatkn/eslint-config": "^0.12.1",
+    "@fuzdev/blake3-wasm": "^0.2.0",
+    "@fuzdev/fuz_code": "^0.48.0",
+    "@fuzdev/fuz_css": "^0.64.0",
+    "@fuzdev/fuz_ui": "^0.208.0",
+    "@fuzdev/fuz_util": "^0.69.0",
+    "@fuzdev/gro": "^0.212.0",
+    "@fuzdev/mdz": "^0.3.0",
+    "@ryanatkn/eslint-config": "^0.12.2",
     "@sveltejs/acorn-typescript": "^1.0.9",
     "@sveltejs/adapter-static": "^3.0.10",
     "@sveltejs/kit": "^2.63.0",
     "@sveltejs/package": "^2.5.7",
-    "@sveltejs/vite-plugin-svelte": "^7.1.2",
+    "@sveltejs/vite-plugin-svelte": "^6.2.4",
     "@types/estree": "^1.0.8",
     "@types/node": "^24.10.1",
     "@webref/css": "^8.2.0",
@@ -59,37 +59,18 @@
     "eslint-plugin-svelte": "^3.13.1",
     "esm-env": "^1.2.2",
     "magic-string": "^0.30.21",
-    "prettier": "^3.7.4",
-    "prettier-plugin-svelte": "^3.5.1",
     "svelte": "^5.56.2",
     "svelte-check": "^4.6.0",
-    "svelte-docinfo": "^0.5.1",
+    "svelte-docinfo": "^0.7.0",
     "svelte2tsx": "^0.7.52",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.48.1",
-    "vite": "^8.0.16",
-    "vitest": "^4.0.15",
+    "vite": "^7.3.6",
+    "vitest": "^5.0.0",
     "zimmerframe": "^1.1.4",
     "zod": "^4.3.6"
   },
-  "prettier": {
-    "plugins": [
-      "prettier-plugin-svelte"
-    ],
-    "useTabs": true,
-    "printWidth": 100,
-    "singleQuote": true,
-    "bracketSpacing": false,
-    "overrides": [
-      {
-        "files": "package.json",
-        "options": {
-          "useTabs": false
-        }
-      }
-    ]
-  },
   "sideEffects": [
     "**/*.css"
   ],

package/src/lib/cargo_toml.ts

@@ -1,6 +1,6 @@
-import {existsSync} from 'node:fs';
-import {readFile} from 'node:fs/promises';
-import {join} from 'node:path';
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
 
 /**
  * The handful of identity fields gitops reads from a Rust repo's `Cargo.toml`

package/src/lib/changeset_generator.ts

@@ -7,17 +7,17 @@
  * @module
  */
 
-import {join} from 'node:path';
-import type {Logger} from '@fuzdev/fuz_util/log.ts';
-import type {LocalRepo} from './local_repo.ts';
-import type {PublishedVersion} from './multi_repo_publisher.ts';
+import { join } from 'node:path';
+import type { Logger } from '@fuzdev/fuz_util/log.ts';
+import type { LocalRepo } from './local_repo.ts';
+import type { PublishedVersion } from './multi_repo_publisher.ts';
 import {
 	strip_version_prefix,
 	required_bump_for_dependency_update,
-	type BumpType,
+	type BumpType
 } from './version_utils.ts';
-import type {FsOperations} from './operations.ts';
-import {default_fs_operations} from './operations_defaults.ts';
+import type { FsOperations } from './operations.ts';
+import { default_fs_operations } from './operations_defaults.ts';
 
 export interface DependencyVersionChange {
 	package_name: string;
@@ -34,14 +34,14 @@ export interface DependencyVersionChange {
 export const create_changeset_for_dependency_updates = async (
 	repo: LocalRepo,
 	updates: Array<DependencyVersionChange>,
-	options: {log?: Logger; fs_ops?: FsOperations} = {},
+	options: { log?: Logger; fs_ops?: FsOperations } = {}
 ): Promise<string> => {
-	const {log, fs_ops = default_fs_operations} = options;
+	const { log, fs_ops = default_fs_operations } = options;
 	const changesets_dir = join(repo.repo_dir, '.changeset');
 
 	// Ensure .changeset directory exists
-	if (!(await fs_ops.exists({path: changesets_dir}))) {
-		const mkdir_result = await fs_ops.mkdir({path: changesets_dir, recursive: true});
+	if (!(await fs_ops.exists({ path: changesets_dir }))) {
+		const mkdir_result = await fs_ops.mkdir({ path: changesets_dir, recursive: true });
 		if (!mkdir_result.ok) {
 			throw new Error(`Failed to create .changeset directory: ${mkdir_result.message}`);
 		}
@@ -60,7 +60,7 @@ export const create_changeset_for_dependency_updates = async (
 	const content = generate_changeset_content(repo.library.name, updates, required_bump);
 
 	// Write the changeset file
-	const write_result = await fs_ops.writeFile({path: filepath, content});
+	const write_result = await fs_ops.writeFile({ path: filepath, content });
 	if (!write_result.ok) {
 		throw new Error(`Failed to write changeset file: ${write_result.message}`);
 	}
@@ -72,11 +72,11 @@ export const create_changeset_for_dependency_updates = async (
 
 const calculate_required_bump = (
 	repo: LocalRepo,
-	updates: Array<DependencyVersionChange>,
+	updates: Array<DependencyVersionChange>
 ): BumpType =>
 	required_bump_for_dependency_update(
 		repo.package_json.version || '0.0.0',
-		updates.some((u) => u.breaking),
+		updates.some((u) => u.breaking)
 	);
 
 /**
@@ -94,7 +94,7 @@ const calculate_required_bump = (
 export const generate_changeset_content = (
 	package_name: string,
 	updates: Array<DependencyVersionChange>,
-	bump_type: 'major' | 'minor' | 'patch',
+	bump_type: 'major' | 'minor' | 'patch'
 ): string => {
 	// Group updates by type
 	const breaking_updates = updates.filter((u) => u.breaking);
@@ -112,7 +112,7 @@ export const generate_changeset_content = (
 		lines.push('Breaking dependency changes:');
 		for (const update of breaking_updates) {
 			lines.push(
-				`- ${update.package_name}: ${update.from_version} → ${update.to_version} (${update.bump_type})`,
+				`- ${update.package_name}: ${update.from_version} → ${update.to_version} (${update.bump_type})`
 			);
 		}
 		lines.push('');
@@ -126,7 +126,7 @@ export const generate_changeset_content = (
 		}
 		for (const update of regular_updates) {
 			lines.push(
-				`- ${update.package_name}: ${update.from_version} → ${update.to_version} (${update.bump_type})`,
+				`- ${update.package_name}: ${update.from_version} → ${update.to_version} (${update.bump_type})`
 			);
 		}
 		lines.push('');
@@ -137,7 +137,7 @@ export const generate_changeset_content = (
 
 export const create_dependency_updates = (
 	dependencies: Map<string, string>,
-	published_versions: Map<string, PublishedVersion>,
+	published_versions: Map<string, PublishedVersion>
 ): Array<DependencyVersionChange> => {
 	const updates: Array<DependencyVersionChange> = [];
 
@@ -152,7 +152,7 @@ export const create_dependency_updates = (
 				from_version: clean_current,
 				to_version: published.new_version,
 				bump_type: published.bump_type,
-				breaking: published.breaking,
+				breaking: published.breaking
 			});
 		}
 	}

package/src/lib/changeset_reader.ts

@@ -7,17 +7,17 @@
  * @module
  */
 
-import type {Logger} from '@fuzdev/fuz_util/log.ts';
-import {existsSync} from 'node:fs';
-import {readdir, readFile} from 'node:fs/promises';
-import {join} from 'node:path';
+import type { Logger } from '@fuzdev/fuz_util/log.ts';
+import { existsSync } from 'node:fs';
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
 
-import type {LocalRepo} from './local_repo.ts';
-import {compare_bump_types, calculate_next_version, type BumpType} from './version_utils.ts';
+import type { LocalRepo } from './local_repo.ts';
+import { compare_bump_types, calculate_next_version, type BumpType } from './version_utils.ts';
 
 export interface ChangesetInfo {
 	filename: string;
-	packages: Array<{name: string; bump_type: BumpType}>;
+	packages: Array<{ name: string; bump_type: BumpType }>;
 	summary: string;
 }
 
@@ -44,7 +44,7 @@ export interface ChangesetInfo {
  */
 export const parse_changeset_content = (
 	content: string,
-	filename = 'changeset.md',
+	filename = 'changeset.md'
 ): ChangesetInfo | null => {
 	// Match frontmatter between --- markers
 	const frontmatter_match = /^---\s*\n([\s\S]*?)\n---\s*\n([\s\S]*)/.exec(content);
@@ -56,7 +56,7 @@ export const parse_changeset_content = (
 	const summary = frontmatter_match[2]!.trim();
 
 	// Parse package entries
-	const packages: Array<{name: string; bump_type: BumpType}> = [];
+	const packages: Array<{ name: string; bump_type: BumpType }> = [];
 
 	// Match lines like: "package-name": patch
 	// or: '@scope/package': minor
@@ -67,7 +67,7 @@ export const parse_changeset_content = (
 	while ((match = package_regex.exec(frontmatter)) !== null) {
 		packages.push({
 			name: match[1]!,
-			bump_type: match[2]! as BumpType,
+			bump_type: match[2]! as BumpType
 		});
 	}
 
@@ -78,13 +78,13 @@ export const parse_changeset_content = (
 	return {
 		filename,
 		packages,
-		summary,
+		summary
 	};
 };
 
 export const parse_changeset_file = async (
 	filepath: string,
-	log?: Logger,
+	log?: Logger
 ): Promise<ChangesetInfo | null> => {
 	try {
 		const content = await readFile(filepath, 'utf8');
@@ -105,7 +105,7 @@ export const parse_changeset_file = async (
 
 export const read_changesets = async (
 	repo: LocalRepo,
-	log?: Logger,
+	log?: Logger
 ): Promise<Array<ChangesetInfo>> => {
 	const changesets_dir = join(repo.repo_dir, '.changeset');
 
@@ -141,7 +141,7 @@ export const read_changesets = async (
  */
 export const determine_bump_from_changesets = (
 	changesets: Array<ChangesetInfo>,
-	package_name: string,
+	package_name: string
 ): BumpType | null => {
 	let highest_bump: BumpType | null = null;
 
@@ -195,8 +195,8 @@ export const has_changesets = async (repo: LocalRepo): Promise<boolean> => {
  */
 export const predict_next_version = async (
 	repo: LocalRepo,
-	log?: Logger,
-): Promise<{version: string; bump_type: BumpType} | null> => {
+	log?: Logger
+): Promise<{ version: string; bump_type: BumpType } | null> => {
 	const changesets = await read_changesets(repo, log);
 	if (changesets.length === 0) {
 		return null;
@@ -211,11 +211,11 @@ export const predict_next_version = async (
 	const next_version = calculate_next_version(current_version, bump_type);
 
 	log?.debug(
-		`  Predicted ${repo.library.name}: ${current_version} → ${next_version} (${bump_type})`,
+		`  Predicted ${repo.library.name}: ${current_version} → ${next_version} (${bump_type})`
 	);
 
 	return {
 		version: next_version,
-		bump_type,
+		bump_type
 	};
 };

package/src/lib/ci_reconcile.ts

@@ -2,20 +2,18 @@
  * Reconciles each repo's declared `ci` flag against whether it actually has
  * GitHub Actions workflow files on disk.
  *
- * The gitops config derives `ci` from visibility (on for public repos, off for
- * private) with per-repo overrides; this check catches drift between that
- * declaration and reality —
+ * The registry (`repos.toml`) derives `ci` from visibility (on for public repos,
+ * off for private) with per-repo overrides; this check catches drift between
+ * that declaration and reality —
  * a repo that claims CI but ships no workflow, or one that disclaims CI yet
- * still carries one. Repos that aren't checked out locally can't be judged, so
- * the caller marks them uncheckable and they're skipped. Archived repos are
- * frozen on their host, so their CI state is intentionally left alone and they're
- * skipped too.
+ * still carries one. Archived repos are frozen on their host, so their CI state
+ * is intentionally left alone and they're skipped.
  *
  * @module
  */
 
-import {existsSync, readdirSync} from 'node:fs';
-import {join} from 'node:path';
+import { existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
 
 /** How a repo's declared `ci` diverges from its workflow files on disk. */
 export type CiDriftKind =
@@ -34,12 +32,10 @@ export interface CiDrift {
 
 export interface CiReconcileInput {
 	repo_url: string;
-	/** The declared/derived `ci` value from the gitops config. */
+	/** The declared/derived `ci` value from the registry. */
 	ci: boolean;
 	/** Whether the repo has at least one workflow file on disk. */
 	has_workflows: boolean;
-	/** Whether the repo is checked out locally; uncheckable repos are skipped. */
-	checkable: boolean;
 	/** Whether the repo is archived (frozen) on its host; archived repos are skipped. */
 	archived: boolean;
 }
@@ -51,12 +47,12 @@ export interface CiReconcileInput {
 export const reconcile_ci = (repos: Array<CiReconcileInput>): Array<CiDrift> => {
 	const drift: Array<CiDrift> = [];
 	for (const repo of repos) {
-		if (!repo.checkable || repo.archived) continue;
-		const {repo_url, ci, has_workflows} = repo;
+		if (repo.archived) continue;
+		const { repo_url, ci, has_workflows } = repo;
 		if (ci && !has_workflows) {
-			drift.push({repo_url, ci, has_workflows, kind: 'missing_ci'});
+			drift.push({ repo_url, ci, has_workflows, kind: 'missing_ci' });
 		} else if (!ci && has_workflows) {
-			drift.push({repo_url, ci, has_workflows, kind: 'stray_ci'});
+			drift.push({ repo_url, ci, has_workflows, kind: 'stray_ci' });
 		}
 	}
 	return drift;