@fuzdev/fuz_gitops 0.68.0 → 0.70.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_gitops",
-  "version": "0.68.0",
+  "version": "0.70.0",
   "description": "a tool for managing many repos",
   "glyph": "🪄",
   "logo": "logo.svg",
@@ -26,29 +26,30 @@
   },
   "type": "module",
   "engines": {
-    "node": ">=22.15"
+    "node": ">=24.14"
   },
   "peerDependencies": {
-    "@fuzdev/fuz_css": ">=0.56.0",
-    "@fuzdev/fuz_ui": ">=0.190.0",
-    "@fuzdev/fuz_util": ">=0.54.0",
-    "@fuzdev/gro": ">=0.197.0",
+    "@fuzdev/fuz_css": ">=0.61.0",
+    "@fuzdev/fuz_ui": ">=0.196.0",
+    "@fuzdev/fuz_util": ">=0.63.0",
+    "@fuzdev/gro": ">=0.200.0",
     "@sveltejs/kit": "^2",
     "svelte": "^5",
     "zod": "^4.3.6"
   },
   "devDependencies": {
     "@changesets/changelog-git": "^0.2.1",
+    "@fuzdev/blake3_wasm": "^0.1.1",
     "@fuzdev/fuz_code": "^0.45.1",
-    "@fuzdev/fuz_css": "^0.56.0",
-    "@fuzdev/fuz_ui": "^0.190.0",
-    "@fuzdev/fuz_util": "^0.54.0",
-    "@fuzdev/gro": "^0.197.0",
+    "@fuzdev/fuz_css": "^0.61.0",
+    "@fuzdev/fuz_ui": "^0.196.0",
+    "@fuzdev/fuz_util": "^0.63.0",
+    "@fuzdev/gro": "^0.200.0",
     "@jridgewell/trace-mapping": "^0.3.31",
-    "@ryanatkn/eslint-config": "^0.10.1",
+    "@ryanatkn/eslint-config": "^0.12.1",
     "@sveltejs/acorn-typescript": "^1.0.9",
     "@sveltejs/adapter-static": "^3.0.10",
-    "@sveltejs/kit": "^2.50.1",
+    "@sveltejs/kit": "^2.61.1",
     "@sveltejs/package": "^2.5.7",
     "@sveltejs/vite-plugin-svelte": "^6.2.4",
     "@types/estree": "^1.0.8",
@@ -59,10 +60,11 @@
     "esm-env": "^1.2.2",
     "magic-string": "^0.30.21",
     "prettier": "^3.7.4",
-    "prettier-plugin-svelte": "^3.4.1",
-    "svelte": "^5.49.1",
-    "svelte-check": "^4.3.6",
-    "svelte2tsx": "^0.7.47",
+    "prettier-plugin-svelte": "^3.5.1",
+    "svelte": "^5.56.0",
+    "svelte-check": "^4.4.6",
+    "svelte-docinfo": "^0.2.0",
+    "svelte2tsx": "^0.7.52",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.48.1",

package/src/lib/changeset_generator.ts

@@ -36,7 +36,7 @@ export const create_changeset_for_dependency_updates = async (
 	const changesets_dir = join(repo.repo_dir, '.changeset');
 
 	// Ensure .changeset directory exists
-	if (!fs_ops.exists({path: changesets_dir})) {
+	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}`);
@@ -95,10 +95,10 @@ const calculate_required_bump = (
  * and categorized list of breaking vs regular updates. Output format
  * matches changesets CLI for consistency.
  *
- * @param package_name package receiving the dependency updates
- * @param updates list of dependency changes with version info
- * @param bump_type required bump type (calculated from breaking changes)
- * @returns markdown content ready to write to .changeset/*.md file
+ * @param package_name - package receiving the dependency updates
+ * @param updates - list of dependency changes with version info
+ * @param bump_type - required bump type (calculated from breaking changes)
+ * @returns markdown content ready to write to `.changeset/*.md` file
  */
 export const generate_changeset_content = (
 	package_name: string,

package/src/lib/changeset_reader.ts

@@ -30,15 +30,17 @@ export interface ChangesetInfo {
  * Returns null if format is invalid or no packages found.
  *
  * Expected format:
+ * ```
  * ---
  * "package-name": patch
  * "@scope/package": minor
  * ---
  *
  * Summary of changes
+ * ```
  *
- * @param content changeset markdown with YAML frontmatter
- * @param filename optional filename for error reporting context
+ * @param content - changeset markdown with YAML frontmatter
+ * @param filename - optional filename for error reporting context
  * @returns parsed changeset info or null if invalid format
  */
 export const parse_changeset_content = (
@@ -116,7 +118,7 @@ export const read_changesets = async (
 
 		for (const file of changeset_files) {
 			const filepath = join(changesets_dir, file);
-			const changeset = await parse_changeset_file(filepath, log); // eslint-disable-line no-await-in-loop
+			const changeset = await parse_changeset_file(filepath, log);
 			if (changeset) {
 				changesets.push(changeset);
 			}
@@ -161,8 +163,8 @@ export const determine_bump_from_changesets = (
  * Checks if a repo has any changeset files (excluding README.md).
  *
  * Used by preflight checks and publishing workflow to determine which packages
- * need to be published. Returns false if .changeset directory doesn't exist
- * or contains only README.md.
+ * need to be published. Returns false if `.changeset` directory doesn't exist
+ * or contains only `README.md`.
  *
  * @returns true if repo has unpublished changesets
  */

package/src/lib/dependency_graph.ts

@@ -127,8 +127,8 @@ export class DependencyGraph {
 	 * Delegates to `@fuzdev/fuz_util/sort.js` for the sorting algorithm.
 	 * Throws if cycles detected.
 	 *
-	 * @param exclude_dev if true, excludes dev dependencies to break cycles.
-	 *   Publishing uses exclude_dev=true to handle circular dev deps.
+	 * @param exclude_dev - if true, excludes dev dependencies to break cycles
+	 *   Publishing uses `exclude_dev`=true to handle circular dev deps.
 	 * @returns array of package names in dependency order (dependencies before dependents)
 	 * @throws {Error} if circular dependencies detected in included dependency types
 	 */
@@ -158,7 +158,7 @@ export class DependencyGraph {
 	 * Uses DFS traversal with recursion stack to identify back edges.
 	 * Deduplicates cycles using sorted cycle keys.
 	 *
-	 * @returns object with production_cycles (errors) and dev_cycles (info)
+	 * @returns object with `production_cycles` (errors) and `dev_cycles` (info)
 	 */
 	detect_cycles_by_type(): {
 		production_cycles: Array<Array<string>>;

package/src/lib/dependency_updater.ts

@@ -22,13 +22,13 @@ export interface UpdatePackageJsonOptions {
 }
 
 /**
- * Updates package.json dependencies and creates changeset if needed.
+ * Updates `package.json` dependencies and creates changeset if needed.
  *
  * Workflow:
  * 1. Updates all dependency types (dependencies, devDependencies, peerDependencies)
- * 2. Writes updated package.json with tabs formatting
- * 3. Creates auto-changeset if published_versions provided (for transitive updates)
- * 4. Commits both package.json and changeset with standard message
+ * 2. Writes updated `package.json` with tabs formatting
+ * 3. Creates auto-changeset if `published_versions` provided (for transitive updates)
+ * 4. Commits both `package.json` and changeset with standard message
  *
  * Uses version strategy to determine prefix (exact, caret, tilde) while preserving
  * existing prefixes when possible.
@@ -226,7 +226,7 @@ export const update_all_repos = async (
 		if (updates.size === 0) continue;
 
 		try {
-			await update_package_json(repo, updates, {strategy, log, git_ops, fs_ops}); // eslint-disable-line no-await-in-loop
+			await update_package_json(repo, updates, {strategy, log, git_ops, fs_ops});
 			updated_count++;
 			log?.info(`    Updated ${updates.size} dependencies in ${repo.library.name}`);
 		} catch (error) {

package/src/lib/fetch_repo_data.ts

@@ -6,8 +6,6 @@ import {fetch_github_check_runs, fetch_github_pull_requests} from './github.js';
 import type {RepoJson} from './repo.svelte.js';
 import type {LocalRepo} from './local_repo.js';
 
-/* eslint-disable no-await-in-loop */
-
 /**
  * Fetches GitHub metadata (CI status, PRs) for all repos.
  *
@@ -15,11 +13,11 @@ import type {LocalRepo} from './local_repo.js';
  * Uses `await_in_loop` intentionally to avoid parallel requests overwhelming the API.
  *
  * Error handling: Logs fetch failures but continues processing remaining repos.
- * Repos with failed fetches will have `null` for check_runs or pull_requests.
+ * Repos with failed fetches will have `null` for `check_runs` or `pull_requests`.
  *
- * @param delay milliseconds between API requests (default: 33ms)
- * @param cache optional cache from fuz_util's fetch.js for response memoization
- * @returns array of Repo objects with GitHub metadata attached
+ * @param delay - milliseconds between API requests (default: 33ms)
+ * @param cache - optional cache from `fuz_util`'s `fetch.js` for response memoization
+ * @returns array of `Repo` objects with GitHub metadata attached
  */
 export const fetch_repo_data = async (
 	resolved_repos: Array<LocalRepo>,

package/src/lib/fs_fetch_value_cache.ts

@@ -17,7 +17,7 @@ export interface FetchCache {
 }
 
 /**
- * Creates file-system backed cache for fuz_util's fetch.js API responses.
+ * Creates file-system backed cache for `fuz_util`'s `fetch.js` API responses.
  *
  * Cache invalidation strategy: If cache file can't be read or parsed, entire
  * cache is cleared (delete file) and starts fresh. This handles format changes.
@@ -25,9 +25,9 @@ export interface FetchCache {
  * Uses `structuredClone` to track changes - only writes to disk if data modified.
  * Formatted with Prettier before writing for version control friendliness.
  *
- * @param name cache filename (without .json extension)
- * @param dir cache directory (defaults to `.gro/build/fetch/`)
- * @returns cache object with Map-based data and save() method
+ * @param name - cache filename (without .json extension)
+ * @param dir - cache directory (defaults to `.gro/build/fetch/`)
+ * @returns cache object with Map-based data and `save()` method
  */
 export const create_fs_fetch_value_cache = async (
 	name: string,

package/src/lib/git_operations.ts

@@ -1,4 +1,4 @@
-import {spawn, spawn_out} from '@fuzdev/fuz_util/process.js';
+import {spawn_out, spawn_result_to_message} from '@fuzdev/fuz_util/process.js';
 import type {SpawnOptions} from 'node:child_process';
 import {
 	git_check_clean_workspace as gro_git_check_clean_workspace,
@@ -18,9 +18,11 @@ export const git_add = async (
 	options?: SpawnOptions,
 ): Promise<void> => {
 	const file_list = Array.isArray(files) ? files : [files];
-	const result = await spawn('git', ['add', ...file_list], options);
+	const {result, stderr} = await spawn_out('git', ['add', ...file_list], options);
 	if (!result.ok) {
-		throw Error(`git_add failed with code ${result.code}`);
+		throw Error(
+			`git_add failed with ${spawn_result_to_message(result)}${stderr ? ': ' + stderr.trim() : ''}`,
+		);
 	}
 };
 
@@ -28,9 +30,11 @@ export const git_add = async (
  * Commits staged changes with a message and throws if anything goes wrong.
  */
 export const git_commit = async (message: string, options?: SpawnOptions): Promise<void> => {
-	const result = await spawn('git', ['commit', '-m', message], options);
+	const {result, stderr} = await spawn_out('git', ['commit', '-m', message], options);
 	if (!result.ok) {
-		throw Error(`git_commit failed with code ${result.code}`);
+		throw Error(
+			`git_commit failed with ${spawn_result_to_message(result)}${stderr ? ': ' + stderr.trim() : ''}`,
+		);
 	}
 };
 
@@ -56,9 +60,11 @@ export const git_tag = async (
 ): Promise<void> => {
 	const args = message ? ['tag', '-a', tag_name, '-m', message] : ['tag', tag_name];
 
-	const result = await spawn('git', args, options);
+	const {result, stderr} = await spawn_out('git', args, options);
 	if (!result.ok) {
-		throw Error(`git_tag failed for tag '${tag_name}' with code ${result.code}`);
+		throw Error(
+			`git_tag failed for tag '${tag_name}' with ${spawn_result_to_message(result)}${stderr ? ': ' + stderr.trim() : ''}`,
+		);
 	}
 };
 
@@ -70,9 +76,11 @@ export const git_push_tag = async (
 	origin: GitOrigin = 'origin' as GitOrigin,
 	options?: SpawnOptions,
 ): Promise<void> => {
-	const result = await spawn('git', ['push', origin, tag_name], options);
+	const {result, stderr} = await spawn_out('git', ['push', origin, tag_name], options);
 	if (!result.ok) {
-		throw Error(`git_push_tag failed for tag '${tag_name}' with code ${result.code}`);
+		throw Error(
+			`git_push_tag failed for tag '${tag_name}' with ${spawn_result_to_message(result)}${stderr ? ': ' + stderr.trim() : ''}`,
+		);
 	}
 };
 
@@ -82,9 +90,11 @@ export const git_has_changes = async (options?: SpawnOptions): Promise<boolean>
 };
 
 /**
- * Returns list of changed files compared to HEAD.
+ * Lists uncommitted files in the working tree (`git diff --name-only HEAD`).
  */
-export const git_get_changed_files = async (options?: SpawnOptions): Promise<Array<string>> => {
+export const git_list_uncommitted_files = async (
+	options?: SpawnOptions,
+): Promise<Array<string>> => {
 	const {stdout} = await spawn_out('git', ['diff', '--name-only', 'HEAD'], options);
 	if (!stdout) return [];
 
@@ -114,9 +124,11 @@ export const git_has_file_changed = async (
 export const git_stash = async (message?: string, options?: SpawnOptions): Promise<void> => {
 	const args = message ? ['stash', 'push', '-m', message] : ['stash', 'push'];
 
-	const result = await spawn('git', args, options);
+	const {result, stderr} = await spawn_out('git', args, options);
 	if (!result.ok) {
-		throw Error(`git_stash failed with code ${result.code}`);
+		throw Error(
+			`git_stash failed with ${spawn_result_to_message(result)}${stderr ? ': ' + stderr.trim() : ''}`,
+		);
 	}
 };
 
@@ -124,9 +136,11 @@ export const git_stash = async (message?: string, options?: SpawnOptions): Promi
  * Applies stashed changes and throws if anything goes wrong.
  */
 export const git_stash_pop = async (options?: SpawnOptions): Promise<void> => {
-	const result = await spawn('git', ['stash', 'pop'], options);
+	const {result, stderr} = await spawn_out('git', ['stash', 'pop'], options);
 	if (!result.ok) {
-		throw Error(`git_stash_pop failed with code ${result.code}`);
+		throw Error(
+			`git_stash_pop failed with ${spawn_result_to_message(result)}${stderr ? ': ' + stderr.trim() : ''}`,
+		);
 	}
 };
 
@@ -160,7 +174,7 @@ export const git_switch_branch = async (
 };
 
 /**
- * Wrapper for gro's git_current_branch_name that throws if null.
+ * Wrapper for gro's `git_current_branch_name` that throws if null.
  */
 export const git_current_branch_name_required = async (options?: SpawnOptions): Promise<string> => {
 	const branch = await gro_git_current_branch_name(options);
@@ -171,7 +185,7 @@ export const git_current_branch_name_required = async (options?: SpawnOptions):
 };
 
 /**
- * Wrapper for gro's git_current_commit_hash that throws if null.
+ * Wrapper for gro's `git_current_commit_hash` that throws if null.
  */
 export const git_current_commit_hash_required = async (
 	branch?: string,
@@ -185,7 +199,7 @@ export const git_current_commit_hash_required = async (
 };
 
 /**
- * Wrapper for gro's git_check_clean_workspace that returns a boolean.
+ * Wrapper for gro's `git_check_clean_workspace` that returns a boolean.
  */
 export const git_check_clean_workspace_as_boolean = async (
 	options?: SpawnOptions,

package/src/lib/github.ts

@@ -3,7 +3,7 @@ import {z} from 'zod';
 import {fetch_value, type FetchValueCache} from '@fuzdev/fuz_util/fetch.js';
 
 /**
- * Minimal interface for GitHub API calls - works with both Pkg and Repo.
+ * Minimal interface for GitHub API calls - works with both `Pkg` and `Repo`.
  */
 export interface GithubRepoInfo {
 	owner_name: string | null;
@@ -116,7 +116,6 @@ const reduce_check_runs = (check_runs: Array<GithubCheckRunsItem>): GithubCheckR
 	let status!: GithubCheckRunsItem['status'];
 	let conclusion!: GithubCheckRunsItem['conclusion'];
 	for (const check_run of check_runs) {
-		// eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
 		if (!status || status === 'completed') {
 			status = check_run.status;
 		}

package/src/lib/gitops_plan.task.ts

@@ -36,9 +36,9 @@ export type Args = z.infer<typeof Args>;
  * Shows version changes, dependency updates, and breaking change cascades.
  *
  * Usage:
- *   gro gitops_plan
- *   gro gitops_plan --dir ../repos
- *   gro gitops_plan --config ./custom.config.ts
+ *   `gro gitops_plan`
+ *   `gro gitops_plan --dir ../repos`
+ *   `gro gitops_plan --config ./custom.config.ts`
  *
  * @nodocs
  */

package/src/lib/gitops_run.task.ts

@@ -41,7 +41,7 @@ export const task: Task<Args> = {
 	run: async ({args, log}) => {
 		const {command, config, concurrency, format} = args;
 
-		// Get repo paths (lightweight, no library.ts loading needed)
+		// Get repo paths (lightweight, no library-metadata loading needed)
 		const config_path = resolve(config);
 		const repos = await get_repo_paths(config_path);
 
@@ -75,7 +75,7 @@ export const task: Task<Args> = {
 					repo_name,
 					repo_dir,
 					status: success ? 'success' : 'failure',
-					exit_code: spawned.result.code ?? 0,
+					exit_code: spawned.result.kind === 'exited' ? spawned.result.code : 0,
 					stdout: spawned.stdout || '',
 					stderr: spawned.stderr || '',
 					duration_ms,

package/src/lib/gitops_task_helpers.ts

@@ -46,17 +46,17 @@ export interface GetGitopsReadyOptions {
  * 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
+ * 4. Auto-installs deps if `package.json` changed during pull
  *
  * Priority for path resolution:
  * - `dir` argument (explicit override)
  * - Config `repos_dir` setting
  * - `DEFAULT_REPOS_DIR` constant
  *
- * @param options.git_ops for testing (defaults to real git operations)
- * @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.git_ops - for testing (defaults to real git operations)
+ * @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)
  * @returns initialized config and fully loaded repos ready for operations
  * @throws {TaskError} if config loading or repo resolution fails
  */

package/src/lib/graph_validation.ts

@@ -30,13 +30,13 @@ export interface GraphValidationResult {
 
 /**
  * Shared utility for building dependency graph, detecting cycles, and computing publishing order.
- * This centralizes logic that was duplicated across multi_repo_publisher, publishing_plan, and gitops_analyze.
+ * This centralizes logic that was duplicated across `multi_repo_publisher`, `publishing_plan`, and `gitops_analyze`.
  *
- * @param options.throw_on_prod_cycles whether to throw an error if production cycles are detected (default: true)
- * @param options.log_cycles whether to log cycle information (default: true)
- * @param options.log_order whether to log publishing order (default: true)
+ * @param options.throw_on_prod_cycles - whether to throw an error if production cycles are detected (default: true)
+ * @param options.log_cycles - whether to log cycle information (default: true)
+ * @param options.log_order - whether to log publishing order (default: true)
  * @returns graph validation result with graph, publishing order, and detected cycles
- * @throws {TaskError} if production cycles detected and throw_on_prod_cycles is true
+ * @throws {TaskError} if production cycles detected and `throw_on_prod_cycles` is true
  */
 export const validate_dependency_graph = (
 	repos: Array<LocalRepo>,

package/src/lib/local_repo.ts

@@ -4,8 +4,9 @@ import {Library} from '@fuzdev/fuz_ui/library.svelte.js';
 import {existsSync} from 'node:fs';
 import {join} from 'node:path';
 import {TaskError} from '@fuzdev/gro';
+import {library_load_from_repo} from '@fuzdev/gro/library_load.js';
 import type {Logger} from '@fuzdev/fuz_util/log.js';
-import {spawn} from '@fuzdev/fuz_util/process.js';
+import {spawn_out} from '@fuzdev/fuz_util/process.js';
 import {map_concurrent_settled} from '@fuzdev/fuz_util/async.js';
 import type {GitOperations, NpmOperations} from './operations.js';
 import {default_git_operations, default_npm_operations} from './operations_defaults.js';
@@ -15,8 +16,8 @@ import type {ResolvedGitopsConfig} from './resolved_gitops_config.js';
 import {GITOPS_CONCURRENCY_DEFAULT} from './gitops_constants.js';
 
 /**
- * Fully loaded local repo with Library and extracted dependency data.
- * Does not extend LocalRepoPath - Library is source of truth for name/repo_url/etc.
+ * Fully loaded local repo with `Library` and extracted dependency data.
+ * Does not extend `LocalRepoPath` - `Library` is source of truth for name/repo_url/etc.
  */
 export interface LocalRepo {
 	library: Library;
@@ -61,14 +62,14 @@ export interface LocalRepoMissing {
  * 2. Switches to target branch if needed (requires clean workspace)
  * 3. Pulls latest changes from remote (skipped for local-only repos)
  * 4. Validates workspace is clean after pull
- * 5. Auto-installs dependencies if package.json changed
- * 6. Imports library_json from src/routes/library.ts
- * 7. Creates Library and extracts dependency maps
+ * 5. Auto-installs dependencies if `package.json` changed
+ * 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 library.ts missing
+ * @throws {TaskError} if workspace dirty, branch switch fails, install fails, or analysis fails
  */
 export const local_repo_load = async ({
 	local_repo_path,
@@ -179,27 +180,17 @@ export const local_repo_load = async ({
 		}
 	}
 
-	// Validate and load library.ts
-	const library_path = join(repo_dir, 'src/routes/library.ts');
-	if (!existsSync(library_path)) {
-		throw new TaskError(
-			`Repo "${repo_name}" is missing src/routes/library.ts\n` +
-				`This file is required for fuz_gitops. To fix:\n` +
-				`  1. Create src/routes/library.gen.ts with:\n` +
-				`     import {library_gen} from '@fuzdev/fuz_ui/library_gen.js';\n` +
-				`     export const gen = library_gen();\n` +
-				`  2. Run: cd ${repo_dir} && gro gen`,
+	// Load library metadata via svelte-docinfo analysis (cached under `.gro/library.json`).
+	let library_json: LibraryJson;
+	try {
+		library_json = await library_load_from_repo(repo_dir, {log: _log});
+	} catch (err) {
+		const message = err instanceof Error ? err.message : String(err);
+		_log?.warn(
+			`Failed to load library metadata for repo "${repo_name}" in ${repo_dir}: ${message}`,
 		);
-	}
-
-	const library_module = await import(library_path);
-	const {library_json} = library_module as {library_json: LibraryJson | undefined};
-	if (!library_json) {
 		throw new TaskError(
-			`Repo "${repo_name}" has invalid src/routes/library.ts - missing library_json export\n` +
-				`The file must export a library_json object. To fix:\n` +
-				`  1. Ensure src/routes/library.gen.ts uses library_gen from @fuzdev/fuz_ui\n` +
-				`  2. Run: cd ${repo_dir} && gro gen`,
+			`Failed to load library metadata for repo "${repo_name}" in ${repo_dir}: ${message}`,
 		);
 	}
 	const library = new Library(library_json);
@@ -296,7 +287,7 @@ export const local_repos_load = async ({
 		// Sequential loading (original behavior)
 		const loaded: Array<LocalRepo> = [];
 		for (const local_repo_path of local_repo_paths) {
-			loaded.push(await local_repo_load({local_repo_path, log, git_ops, npm_ops})); // eslint-disable-line no-await-in-loop
+			loaded.push(await local_repo_load({local_repo_path, log, git_ops, npm_ops}));
 		}
 		return loaded;
 	}
@@ -383,14 +374,21 @@ const download_repos = async ({
 	const resolved: Array<LocalRepoPath> = [];
 	for (const {repo_config, repo_git_ssh_url} of local_repos_missing) {
 		log?.info(`cloning repo ${repo_git_ssh_url} to ${repos_dir}`);
-		await spawn('git', ['clone', repo_git_ssh_url], {cwd: repos_dir}); // eslint-disable-line no-await-in-loop
+		const clone_result = await spawn_out('git', ['clone', repo_git_ssh_url], {cwd: repos_dir});
+		if (!clone_result.result.ok) {
+			throw new TaskError(
+				`Failed to clone repo ${repo_git_ssh_url} to ${repos_dir}${clone_result.stderr ? ': ' + clone_result.stderr.trim() : ''}`,
+			);
+		}
 		const local_repo = local_repo_locate({repo_config, repos_dir});
 		if (local_repo.type === 'local_repo_missing') {
-			throw new TaskError(`Failed to clone repo ${repo_git_ssh_url} to ${repos_dir}`);
+			throw new TaskError(
+				`Failed to clone repo ${repo_git_ssh_url} to ${repos_dir}: directory not found after clone`,
+			);
 		}
 		// Always install dependencies after cloning
 		log?.info(`installing dependencies for newly cloned repo ${local_repo.repo_dir}`);
-		const install_result = await npm_ops.install({cwd: local_repo.repo_dir}); // eslint-disable-line no-await-in-loop
+		const install_result = await npm_ops.install({cwd: local_repo.repo_dir});
 		if (!install_result.ok) {
 			throw new TaskError(
 				`Failed to install dependencies in ${local_repo.repo_dir}: ${install_result.message}${install_result.stderr ? `\n${install_result.stderr}` : ''}`,

package/src/lib/multi_repo_publisher.ts

@@ -16,8 +16,6 @@ import {
 } from './gitops_constants.js';
 import {install_with_cache_healing} from './npm_install_helpers.js';
 
-/* eslint-disable no-await-in-loop */
-
 export interface PublishingOptions {
 	wetrun: boolean;
 	update_deps: boolean;
@@ -337,7 +335,7 @@ export const publish_repos = async (
 				const deploy_result = await ops.process.spawn({
 					cmd: 'gro',
 					args: ['deploy', '--no-build'],
-					spawn_options: {cwd: repo.repo_dir},
+					cwd: repo.repo_dir,
 				});
 
 				if (deploy_result.ok) {
@@ -377,11 +375,11 @@ export const publish_repos = async (
 };
 
 /**
- * Publishes a single repo using gro publish.
+ * Publishes a single repo using `gro publish`.
  *
  * Dry run mode: Predicts version from changesets without side effects.
  * Real mode: Runs `gro publish --no-build` (builds already validated in preflight),
- * reads new version from package.json, and returns metadata.
+ * reads new version from `package.json`, and returns metadata.
  *
  * @throws {Error} if changeset prediction fails (dry run) or publish fails (real)
  */
@@ -426,7 +424,7 @@ const publish_single_repo = async (
 	const publish_result = await ops.process.spawn({
 		cmd: 'gro',
 		args: ['publish', '--no-build'],
-		spawn_options: {cwd: repo.repo_dir},
+		cwd: repo.repo_dir,
 	});
 
 	if (!publish_result.ok) {

package/src/lib/npm_install_helpers.ts

@@ -34,9 +34,9 @@ const is_etarget_error = (message: string, stderr: string): boolean => {
  * npm's local cache may still have stale "404" metadata. This healing
  * strategy clears the cache to force fresh metadata fetch.
  *
- * @param repo - The repository to install dependencies for
- * @param ops - Gitops operations (for dependency injection)
- * @param log - Optional logger
+ * @param repo - the repository to install dependencies for
+ * @param ops - gitops operations (for dependency injection)
+ * @param log - optional logger
  * @throws Error if install fails (with details about cache healing attempts)
  */
 export const install_with_cache_healing = async (

package/src/lib/npm_registry.ts

@@ -48,10 +48,10 @@ export const check_package_available = async (
  * Critical for multi-repo publishing: ensures published packages are available
  * before updating dependent packages.
  *
- * @param options.max_attempts max poll attempts (default 30)
- * @param options.initial_delay starting delay in ms (default 1000)
- * @param options.max_delay max delay between attempts (default 60000)
- * @param options.timeout total timeout in ms (default 300000 = 5min)
+ * @param options.max_attempts - max poll attempts (default 30)
+ * @param options.initial_delay - starting delay in ms (default 1000)
+ * @param options.max_delay - max delay between attempts (default 60000)
+ * @param options.timeout - total timeout in ms (default 300000 = 5min)
  * @throws {Error} if timeout reached or max attempts exceeded
  */
 export const wait_for_package = async (
@@ -80,7 +80,7 @@ export const wait_for_package = async (
 		}
 
 		// Check if package is available
-		// eslint-disable-next-line no-await-in-loop
+
 		if (await check_package_available(pkg, version, {log})) {
 			log?.info(st('green', `    ✓ ${pkg}@${version} is now available on NPM`));
 			return;
@@ -94,7 +94,7 @@ export const wait_for_package = async (
 		// Wait with exponential backoff + jitter
 		const jitter = Math.random() * delay * 0.1; // 10% jitter
 		const actual_delay = Math.min(delay + jitter, max_delay);
-		await wait(actual_delay); // eslint-disable-line no-await-in-loop
+		await wait(actual_delay);
 
 		// Exponential backoff
 		delay = Math.min(delay * 1.5, max_delay);