@fuzdev/fuz_gitops 0.67.0 → 0.69.0

package/dist/operations_defaults.js

@@ -6,15 +6,15 @@
  *
  * @module
  */
-import { spawn, spawn_out } from '@fuzdev/fuz_util/process.js';
-import { readFile, writeFile, mkdir } from 'node:fs/promises';
-import { existsSync } from 'node:fs';
+import { spawn_out } from '@fuzdev/fuz_util/process.js';
+import { readFile, writeFile, mkdir, stat } from 'node:fs/promises';
 import { git_checkout } from '@fuzdev/fuz_util/git.js';
+import { fs_classify_error } from '@fuzdev/fuz_util/fs.js';
 import { EMPTY_OBJECT } from '@fuzdev/fuz_util/object.js';
 import { has_changesets, read_changesets, predict_next_version } from './changeset_reader.js';
 import { wait_for_package, check_package_available } from './npm_registry.js';
 import { run_preflight_checks } from './preflight_checks.js';
-import { git_add, git_commit, git_add_and_commit, git_tag, git_push_tag, git_has_changes, git_get_changed_files, git_has_file_changed, git_stash, git_stash_pop, git_switch_branch, git_current_branch_name_required, git_current_commit_hash_required, git_check_clean_workspace_as_boolean, git_has_remote, } from './git_operations.js';
+import { git_add, git_commit, git_add_and_commit, git_tag, git_push_tag, git_has_changes, git_list_uncommitted_files, git_has_file_changed, git_stash, git_stash_pop, git_switch_branch, git_current_branch_name_required, git_current_commit_hash_required, git_check_clean_workspace_as_boolean, git_has_remote, } from './git_operations.js';
 /** Wrap an async function that returns a value */
 const wrap_with_value = async (fn) => {
     try {
@@ -79,7 +79,18 @@ export const default_git_operations = {
     },
     pull: async (options) => {
         const { origin, branch, cwd } = options ?? EMPTY_OBJECT;
-        return wrap_void(() => spawn('git', ['pull', origin || 'origin', branch || ''], cwd ? { cwd } : undefined));
+        try {
+            const spawned = await spawn_out('git', ['pull', origin || 'origin', branch || ''], cwd ? { cwd } : undefined);
+            if (spawned.result.ok) {
+                return { ok: true };
+            }
+            else {
+                return { ok: false, message: spawned.stderr || 'Pull failed' };
+            }
+        }
+        catch (error) {
+            return { ok: false, message: String(error) };
+        }
     },
     switch_branch: async (options) => {
         const { branch, pull, cwd } = options;
@@ -106,9 +117,9 @@ export const default_git_operations = {
         const { cwd } = options ?? EMPTY_OBJECT;
         return wrap_with_value(() => git_has_changes(cwd ? { cwd } : undefined));
     },
-    get_changed_files: async (options) => {
+    list_uncommitted_files: async (options) => {
         const { cwd } = options ?? EMPTY_OBJECT;
-        return wrap_with_value(() => git_get_changed_files(cwd ? { cwd } : undefined));
+        return wrap_with_value(() => git_list_uncommitted_files(cwd ? { cwd } : undefined));
     },
     // Tagging
     tag: async (options) => {
@@ -136,9 +147,9 @@ export const default_git_operations = {
 };
 export const default_process_operations = {
     spawn: async (options) => {
-        const { cmd, args, spawn_options } = options;
+        const { cmd, args, cwd } = options;
         try {
-            const spawned = await spawn_out(cmd, args, spawn_options);
+            const spawned = await spawn_out(cmd, args, cwd ? { cwd } : undefined);
             if (spawned.result.ok) {
                 return {
                     ok: true,
@@ -239,18 +250,42 @@ export const default_preflight_operations = {
 export const default_fs_operations = {
     readFile: async (options) => {
         const { path, encoding } = options;
-        return wrap_with_value(() => readFile(path, encoding));
+        try {
+            const value = await readFile(path, encoding);
+            return { ok: true, value };
+        }
+        catch (error) {
+            return { ok: false, ...fs_classify_error(error) };
+        }
     },
     writeFile: async (options) => {
         const { path, content } = options;
-        return wrap_void(() => writeFile(path, content));
+        try {
+            await writeFile(path, content);
+            return { ok: true };
+        }
+        catch (error) {
+            return { ok: false, ...fs_classify_error(error) };
+        }
     },
     mkdir: async (options) => {
         const { path, recursive } = options;
-        return wrap_void(() => mkdir(path, { recursive }));
+        try {
+            await mkdir(path, { recursive });
+            return { ok: true };
+        }
+        catch (error) {
+            return { ok: false, ...fs_classify_error(error) };
+        }
     },
-    exists: (options) => {
-        return existsSync(options.path);
+    exists: async (options) => {
+        try {
+            await stat(options.path);
+            return true;
+        }
+        catch {
+            return false;
+        }
     },
 };
 export const default_build_operations = {

package/dist/output_helpers.d.ts

@@ -17,11 +17,11 @@ export interface OutputFormatters<T> {
  * Formats data and outputs to file or stdout based on options.
  *
  * Supports three formats:
- * - stdout: Uses logger for colored/styled output (cannot use with --outfile)
+ * - stdout: Uses logger for colored/styled output (cannot use with `--outfile`)
  * - json: Stringified JSON
  * - markdown: Formatted markdown text
  *
- * @throws {Error} if stdout format used with outfile, or if logger missing for stdout
+ * @throws {Error} if stdout format used with `outfile`, or if logger missing for stdout
  */
 export declare const format_and_output: <T>(data: T, formatters: OutputFormatters<T>, options: OutputOptions) => Promise<void>;
 //# sourceMappingURL=output_helpers.d.ts.map

package/dist/output_helpers.js

@@ -3,11 +3,11 @@ import { writeFile } from 'node:fs/promises';
  * Formats data and outputs to file or stdout based on options.
  *
  * Supports three formats:
- * - stdout: Uses logger for colored/styled output (cannot use with --outfile)
+ * - stdout: Uses logger for colored/styled output (cannot use with `--outfile`)
  * - json: Stringified JSON
  * - markdown: Formatted markdown text
  *
- * @throws {Error} if stdout format used with outfile, or if logger missing for stdout
+ * @throws {Error} if stdout format used with `outfile`, or if logger missing for stdout
  */
 export const format_and_output = async (data, formatters, options) => {
     const { format, outfile, log } = options;

package/dist/paths.d.ts

@@ -5,7 +5,7 @@ export declare const GITOPS_OUTPUT_DIR = ".gro/fuz_gitops";
 /**
  * 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/).
+ * (e.g., `~/dev/repo/gitops.config.ts` resolves to `~/dev/`).
  */
 export declare const DEFAULT_REPOS_DIR = "..";
 //# sourceMappingURL=paths.d.ts.map

package/dist/paths.js

@@ -5,6 +5,6 @@ export const GITOPS_OUTPUT_DIR = '.gro/fuz_gitops';
 /**
  * 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/).
+ * (e.g., `~/dev/repo/gitops.config.ts` resolves to `~/dev/`).
  */
 export const DEFAULT_REPOS_DIR = '..';

package/dist/preflight_checks.d.ts

@@ -32,7 +32,7 @@ export interface RunPreflightChecksOptions {
  * Performs comprehensive pre-flight validation:
  * - Clean workspaces (100% clean required - no uncommitted changes)
  * - Correct branch (usually main)
- * - Changesets present (unless skip_changesets=true)
+ * - Changesets present (unless `skip_changesets`=true)
  * - Builds successful (fail-fast to prevent broken state)
  * - Git remote reachability
  * - NPM authentication with username
@@ -41,7 +41,7 @@ export interface RunPreflightChecksOptions {
  * Build validation runs BEFORE any publishing to prevent the scenario where
  * version is bumped but build fails, leaving repo in broken state.
  *
- * @returns result with ok=false if any errors, plus warnings and detailed status
+ * @returns result with `ok`=false if any errors, plus warnings and detailed status
  */
 export declare const run_preflight_checks: ({ repos, preflight_options, git_ops, npm_ops, build_ops, changeset_ops, }: RunPreflightChecksOptions) => Promise<PreflightResult>;
 //# sourceMappingURL=preflight_checks.d.ts.map

package/dist/preflight_checks.js

@@ -7,7 +7,7 @@ import { default_git_operations, default_npm_operations, default_build_operation
  * Performs comprehensive pre-flight validation:
  * - Clean workspaces (100% clean required - no uncommitted changes)
  * - Correct branch (usually main)
- * - Changesets present (unless skip_changesets=true)
+ * - Changesets present (unless `skip_changesets`=true)
  * - Builds successful (fail-fast to prevent broken state)
  * - Git remote reachability
  * - NPM authentication with username
@@ -16,7 +16,7 @@ import { default_git_operations, default_npm_operations, default_build_operation
  * Build validation runs BEFORE any publishing to prevent the scenario where
  * version is bumped but build fails, leaving repo in broken state.
  *
- * @returns result with ok=false if any errors, plus warnings and detailed status
+ * @returns result with `ok`=false if any errors, plus warnings and detailed status
  */
 export const run_preflight_checks = async ({ repos, preflight_options = {}, git_ops = default_git_operations, npm_ops = default_npm_operations, build_ops = default_build_operations, changeset_ops = default_changeset_operations, }) => {
     const { skip_changesets = false, skip_build_validation = false, required_branch = 'main', check_remote = true, estimate_time = true, log, } = preflight_options;
@@ -30,14 +30,14 @@ export const run_preflight_checks = async ({ repos, preflight_options = {}, git_
     // 1. Check clean workspaces - must be 100% clean before publishing
     log?.info('  Checking workspace cleanliness...');
     for (const repo of repos) {
-        const clean_result = await git_ops.check_clean_workspace({ cwd: repo.repo_dir }); // eslint-disable-line no-await-in-loop
+        const clean_result = await git_ops.check_clean_workspace({ cwd: repo.repo_dir });
         if (!clean_result.ok) {
             errors.push(`${repo.library.name} failed workspace check: ${clean_result.message}`);
             continue;
         }
         if (!clean_result.value) {
             // Get list of changed files for better error message
-            const files_result = await git_ops.get_changed_files({ cwd: repo.repo_dir }); // eslint-disable-line no-await-in-loop
+            const files_result = await git_ops.list_uncommitted_files({ cwd: repo.repo_dir });
             if (files_result.ok) {
                 // No filtering - workspace must be 100% clean
                 const unexpected_files = files_result.value;
@@ -53,7 +53,7 @@ export const run_preflight_checks = async ({ repos, preflight_options = {}, git_
     // 2. Check correct branch
     log?.info(`  Checking branches (expecting ${required_branch})...`);
     for (const repo of repos) {
-        const branch_result = await git_ops.current_branch_name({ cwd: repo.repo_dir }); // eslint-disable-line no-await-in-loop
+        const branch_result = await git_ops.current_branch_name({ cwd: repo.repo_dir });
         if (!branch_result.ok) {
             errors.push(`${repo.library.name} failed branch check: ${branch_result.message}`);
             continue;
@@ -66,7 +66,7 @@ export const run_preflight_checks = async ({ repos, preflight_options = {}, git_
     if (!skip_changesets) {
         log?.info('  Checking for changesets...');
         for (const repo of repos) {
-            const has_result = await changeset_ops.has_changesets({ repo }); // eslint-disable-line no-await-in-loop
+            const has_result = await changeset_ops.has_changesets({ repo });
             if (!has_result.ok) {
                 errors.push(`${repo.library.name} failed changeset check: ${has_result.message}`);
                 continue;
@@ -90,7 +90,7 @@ export const run_preflight_checks = async ({ repos, preflight_options = {}, git_
         for (let i = 0; i < repos_to_build.length; i++) {
             const repo = repos_to_build[i];
             log?.info(st('dim', `    [${i + 1}/${repos_to_build.length}] Building ${repo.library.name}...`));
-            const build_result = await build_ops.build_package({ repo, log }); // eslint-disable-line no-await-in-loop
+            const build_result = await build_ops.build_package({ repo, log });
             if (!build_result.ok) {
                 errors.push(`${repo.library.name} failed to build: ${build_result.output || build_result.message || 'unknown error'}`);
             }

package/dist/publishing_plan.js

@@ -71,14 +71,14 @@ export const generate_publishing_plan = async (repos, options = {}) => {
         if (!repo)
             continue;
         // Check for changesets
-        const has_result = await ops.has_changesets({ repo }); // eslint-disable-line no-await-in-loop
+        const has_result = await ops.has_changesets({ repo });
         if (!has_result.ok) {
             errors.push(`Failed to check changesets for ${pkg_name}: ${has_result.message}`);
             continue;
         }
         if (has_result.value) {
             // Predict version from changesets
-            const prediction = await ops.predict_next_version({ repo, log }); // eslint-disable-line no-await-in-loop
+            const prediction = await ops.predict_next_version({ repo, log });
             if (!prediction) {
                 // No changesets found - this shouldn't happen since has_changesets returned true
                 continue;
@@ -89,7 +89,7 @@ export const generate_publishing_plan = async (repos, options = {}) => {
             }
             // Capture changeset details for verbose output
             if (verbose) {
-                const changesets_result = await ops.read_changesets({ repo, log }); // eslint-disable-line no-await-in-loop
+                const changesets_result = await ops.read_changesets({ repo, log });
                 if (changesets_result.ok) {
                     const files = changesets_result.value
                         .filter((cs) => cs.packages.some((p) => p.name === pkg_name))
@@ -272,7 +272,7 @@ export const generate_publishing_plan = async (repos, options = {}) => {
     for (const repo of repos) {
         const has_version_change = version_changes.some((vc) => vc.package_name === repo.library.name);
         if (!has_version_change) {
-            const has_result = await ops.has_changesets({ repo }); // eslint-disable-line no-await-in-loop
+            const has_result = await ops.has_changesets({ repo });
             if (has_result.ok && !has_result.value) {
                 info.push(repo.library.name);
             }

package/dist/publishing_plan_helpers.d.ts

@@ -1,7 +1,7 @@
 /**
  * Helper functions for publishing plan calculations.
  *
- * Extracted from publishing_plan.ts to reduce file size.
+ * Extracted from `publishing_plan.ts` to reduce file size.
  *
  * @module
  */

package/dist/publishing_plan_helpers.js

@@ -1,7 +1,7 @@
 /**
  * Helper functions for publishing plan calculations.
  *
- * Extracted from publishing_plan.ts to reduce file size.
+ * Extracted from `publishing_plan.ts` to reduce file size.
  *
  * @module
  */

package/dist/repo.svelte.d.ts

@@ -6,7 +6,7 @@ import { Library } from '@fuzdev/fuz_ui/library.svelte.js';
 import type { Module } from '@fuzdev/fuz_ui/module.svelte.js';
 import { GithubCheckRunsItem, type GithubPullRequest } from './github.js';
 /**
- * Serialized repo data as stored in repos.ts (JSON).
+ * Serialized repo data as stored in `repos.ts` (JSON).
  */
 export interface RepoJson {
     library_json: LibraryJson;
@@ -14,9 +14,9 @@ export interface RepoJson {
     pull_requests: Array<GithubPullRequest> | null;
 }
 /**
- * Runtime repo with Library composition for package metadata.
+ * Runtime repo with `Library` composition for package metadata.
  *
- * Wraps a Library instance and adds GitHub-specific data (CI status, PRs).
+ * Wraps a `Library` instance and adds GitHub-specific data (CI status, PRs).
  * Convenience getters delegate to `this.library.*` for common properties.
  */
 export declare class Repo {

package/dist/repo.svelte.js

@@ -2,9 +2,9 @@ import { create_context } from '@fuzdev/fuz_ui/context_helpers.js';
 import { Library } from '@fuzdev/fuz_ui/library.svelte.js';
 import { GithubCheckRunsItem } from './github.js';
 /**
- * Runtime repo with Library composition for package metadata.
+ * Runtime repo with `Library` composition for package metadata.
  *
- * Wraps a Library instance and adds GitHub-specific data (CI status, PRs).
+ * Wraps a `Library` instance and adds GitHub-specific data (CI status, PRs).
  * Convenience getters delegate to `this.library.*` for common properties.
  */
 export class Repo {

package/dist/repo_ops.d.ts

@@ -6,7 +6,7 @@
  * - 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.
+ * For full git sync/clone functionality, use `get_gitops_ready()` from `gitops_task_helpers`.
  *
  * @module
  */
@@ -35,8 +35,8 @@ export interface RepoPath {
  * Get repo paths from gitops config without full git sync.
  * Lighter weight than `get_gitops_ready()` - just resolves paths.
  *
- * @param config_path Path to gitops.config.ts (defaults to ./gitops.config.ts)
- * @returns Array of repo info with name, path, and url
+ * @param config_path - path to `gitops.config.ts` (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>>;
 /**
@@ -47,12 +47,12 @@ export declare const should_exclude_path: (file_path: string, options?: WalkOpti
  * 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
+ * @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.
+ * 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>>;

package/dist/repo_ops.js

@@ -6,7 +6,7 @@
  * - 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.
+ * For full git sync/clone functionality, use `get_gitops_ready()` from `gitops_task_helpers`.
  *
  * @module
  */
@@ -59,8 +59,8 @@ export const DEFAULT_EXCLUDE_EXTENSIONS = [
  * Get repo paths from gitops config without full git sync.
  * Lighter weight than `get_gitops_ready()` - just resolves paths.
  *
- * @param config_path Path to gitops.config.ts (defaults to ./gitops.config.ts)
- * @returns Array of repo info with name, path, and url
+ * @param config_path - path to `gitops.config.ts` (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);
@@ -115,8 +115,8 @@ export const should_exclude_path = (file_path, options) => {
  * 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
+ * @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;
@@ -144,7 +144,7 @@ export async function* walk_repo_files(dir, options) {
             else if (entry.isFile()) {
                 // Check file size
                 try {
-                    const file_stat = await stat(full_path); // eslint-disable-line no-await-in-loop
+                    const file_stat = await stat(full_path);
                     if (file_stat.size <= max_file_size) {
                         yield full_path;
                     }
@@ -158,7 +158,7 @@ export async function* walk_repo_files(dir, options) {
     yield* walk(dir);
 }
 /**
- * Collect all files from walk_repo_files into an array.
+ * 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) => {

package/dist/version_utils.d.ts

@@ -12,7 +12,7 @@ export declare const get_version_prefix: (version: string) => string;
  * Normalizes version string for comparison.
  *
  * Strips prefixes (^, ~, >=) to get bare version number.
- * Handles wildcards as-is. Used by needs_update to compare versions.
+ * Handles wildcards as-is. Used by `needs_update` to compare versions.
  *
  * @example
  * ```ts
@@ -39,7 +39,7 @@ export declare const needs_update: (current: string, new_version: string) => boo
  *
  * This preserves user intent while handling wildcard replacements sensibly.
  *
- * @param default_strategy prefix to use when no existing prefix found
+ * @param default_strategy - prefix to use when no existing prefix found
  */
 export declare const get_update_prefix: (current_version: string, default_strategy?: "^" | "~" | "" | ">=") => string;
 /**

package/dist/version_utils.js

@@ -19,7 +19,7 @@ export const get_version_prefix = (version) => {
  * Normalizes version string for comparison.
  *
  * Strips prefixes (^, ~, >=) to get bare version number.
- * Handles wildcards as-is. Used by needs_update to compare versions.
+ * Handles wildcards as-is. Used by `needs_update` to compare versions.
  *
  * @example
  * ```ts
@@ -64,7 +64,7 @@ export const needs_update = (current, new_version) => {
  *
  * This preserves user intent while handling wildcard replacements sensibly.
  *
- * @param default_strategy prefix to use when no existing prefix found
+ * @param default_strategy - prefix to use when no existing prefix found
  */
 export const get_update_prefix = (current_version, default_strategy = '^') => {
     // Use caret for wildcard replacements

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_gitops",
-  "version": "0.67.0",
+  "version": "0.69.0",
   "description": "a tool for managing many repos",
   "glyph": "🪄",
   "logo": "logo.svg",
@@ -29,25 +29,26 @@
     "node": ">=22.15"
   },
   "peerDependencies": {
-    "@fuzdev/fuz_css": ">=0.53.0",
-    "@fuzdev/fuz_ui": ">=0.184.0",
-    "@fuzdev/fuz_util": ">=0.52.0",
-    "@fuzdev/gro": ">=0.195.0",
+    "@fuzdev/fuz_css": ">=0.56.0",
+    "@fuzdev/fuz_ui": ">=0.190.0",
+    "@fuzdev/fuz_util": ">=0.57.0",
+    "@fuzdev/gro": ">=0.197.0",
     "@sveltejs/kit": "^2",
     "svelte": "^5",
-    "zod": "^4.1.13"
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@changesets/changelog-git": "^0.2.1",
     "@fuzdev/fuz_code": "^0.45.1",
-    "@fuzdev/fuz_css": "^0.53.0",
-    "@fuzdev/fuz_ui": "^0.185.0",
-    "@fuzdev/fuz_util": "^0.52.0",
-    "@fuzdev/gro": "^0.195.0",
+    "@fuzdev/fuz_css": "^0.58.0",
+    "@fuzdev/fuz_ui": "^0.191.4",
+    "@fuzdev/fuz_util": "^0.57.0",
+    "@fuzdev/gro": "^0.198.0",
     "@jridgewell/trace-mapping": "^0.3.31",
-    "@ryanatkn/eslint-config": "^0.9.0",
+    "@ryanatkn/eslint-config": "^0.11.0",
+    "@sveltejs/acorn-typescript": "^1.0.9",
     "@sveltejs/adapter-static": "^3.0.10",
-    "@sveltejs/kit": "^2.50.1",
+    "@sveltejs/kit": "^2.57.0",
     "@sveltejs/package": "^2.5.7",
     "@sveltejs/vite-plugin-svelte": "^6.2.4",
     "@types/estree": "^1.0.8",
@@ -58,13 +59,14 @@
     "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.55.2",
+    "svelte-check": "^4.4.5",
+    "svelte2tsx": "^0.7.52",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.48.1",
+    "vite": "^7.3.1",
     "vitest": "^4.0.15",
     "zimmerframe": "^1.1.4",
     "zod": "^4.3.6"

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) {