@fuzdev/fuz_gitops 0.68.0 → 0.70.0

package/dist/git_operations.js

@@ -1,22 +1,22 @@
-import { spawn, spawn_out } from '@fuzdev/fuz_util/process.js';
+import { spawn_out, spawn_result_to_message } from '@fuzdev/fuz_util/process.js';
 import { git_check_clean_workspace as gro_git_check_clean_workspace, git_checkout as gro_git_checkout, git_pull as gro_git_pull, git_current_branch_name as gro_git_current_branch_name, git_current_commit_hash as gro_git_current_commit_hash, } from '@fuzdev/fuz_util/git.js';
 /**
  * Adds files to git staging area and throws if anything goes wrong.
  */
 export const git_add = async (files, options) => {
     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() : ''}`);
     }
 };
 /**
  * Commits staged changes with a message and throws if anything goes wrong.
  */
 export const git_commit = async (message, options) => {
-    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() : ''}`);
     }
 };
 /**
@@ -31,18 +31,18 @@ export const git_add_and_commit = async (files, message, options) => {
  */
 export const git_tag = async (tag_name, message, options) => {
     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() : ''}`);
     }
 };
 /**
  * Pushes a tag to origin and throws if anything goes wrong.
  */
 export const git_push_tag = async (tag_name, origin = 'origin', options) => {
-    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() : ''}`);
     }
 };
 export const git_has_changes = async (options) => {
@@ -50,9 +50,9 @@ export const git_has_changes = async (options) => {
     return stdout ? stdout.trim().length > 0 : false;
 };
 /**
- * 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) => {
+export const git_list_uncommitted_files = async (options) => {
     const { stdout } = await spawn_out('git', ['diff', '--name-only', 'HEAD'], options);
     if (!stdout)
         return [];
@@ -70,18 +70,18 @@ export const git_has_file_changed = async (from_commit, to_commit, file_path, op
  */
 export const git_stash = async (message, options) => {
     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() : ''}`);
     }
 };
 /**
  * Applies stashed changes and throws if anything goes wrong.
  */
 export const git_stash_pop = async (options) => {
-    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() : ''}`);
     }
 };
 /**
@@ -106,7 +106,7 @@ export const git_switch_branch = async (branch, pull = true, options) => {
     }
 };
 /**
- * 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) => {
     const branch = await gro_git_current_branch_name(options);
@@ -116,7 +116,7 @@ export const git_current_branch_name_required = async (options) => {
     return branch;
 };
 /**
- * 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, options) => {
     const hash = await gro_git_current_commit_hash(branch, options);
@@ -126,7 +126,7 @@ export const git_current_commit_hash_required = async (branch, options) => {
     return hash;
 };
 /**
- * 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) => {
     const error = await gro_git_check_clean_workspace(options);

package/dist/github.d.ts

@@ -2,7 +2,7 @@ import type { Logger } from '@fuzdev/fuz_util/log.js';
 import { z } from 'zod';
 import { 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;

package/dist/github.js

@@ -82,7 +82,6 @@ const reduce_check_runs = (check_runs) => {
     let status;
     let 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/dist/gitops_analyze.task.d.ts

@@ -5,8 +5,8 @@ export declare const Args: z.ZodObject<{
     config: z.ZodDefault<z.ZodString>;
     dir: z.ZodOptional<z.ZodString>;
     format: z.ZodDefault<z.ZodEnum<{
-        json: "json";
         stdout: "stdout";
+        json: "json";
         markdown: "markdown";
     }>>;
     outfile: z.ZodOptional<z.ZodString>;

package/dist/gitops_plan.task.d.ts

@@ -5,8 +5,8 @@ export declare const Args: z.ZodObject<{
     config: z.ZodDefault<z.ZodString>;
     dir: z.ZodOptional<z.ZodString>;
     format: z.ZodDefault<z.ZodEnum<{
-        json: "json";
         stdout: "stdout";
+        json: "json";
         markdown: "markdown";
     }>>;
     outfile: z.ZodOptional<z.ZodString>;
@@ -18,9 +18,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/dist/gitops_plan.task.js

@@ -26,9 +26,9 @@ export const Args = z.strictObject({
  * 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/dist/gitops_publish.task.d.ts

@@ -11,8 +11,8 @@ export declare const Args: z.ZodObject<{
     }>>;
     wetrun: z.ZodDefault<z.ZodBoolean>;
     format: z.ZodDefault<z.ZodEnum<{
-        json: "json";
         stdout: "stdout";
+        json: "json";
         markdown: "markdown";
     }>>;
     deploy: z.ZodDefault<z.ZodBoolean>;

package/dist/gitops_run.task.d.ts

@@ -5,8 +5,8 @@ export declare const Args: z.ZodObject<{
     config: z.ZodDefault<z.ZodString>;
     concurrency: z.ZodDefault<z.ZodNumber>;
     format: z.ZodDefault<z.ZodEnum<{
-        json: "json";
         text: "text";
+        json: "json";
     }>>;
 }, z.core.$strict>;
 export type Args = z.infer<typeof Args>;

package/dist/gitops_run.task.js

@@ -25,7 +25,7 @@ export const task = {
     summary: 'run a shell command across all repos in parallel',
     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);
         if (repos.length === 0) {
@@ -50,7 +50,7 @@ export const task = {
                     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/dist/gitops_task_helpers.d.ts

@@ -36,17 +36,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/dist/gitops_task_helpers.js

@@ -30,17 +30,17 @@ import { DEFAULT_REPOS_DIR } from './paths.js';
  * 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/dist/graph_validation.d.ts

@@ -24,13 +24,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 declare const validate_dependency_graph: (repos: Array<LocalRepo>, options?: {
     log?: Logger;

package/dist/graph_validation.js

@@ -17,13 +17,13 @@ import { styleText as st } from 'node:util';
 import { DependencyGraph, DependencyGraphBuilder } from './dependency_graph.js';
 /**
  * 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, options = {}) => {
     const { log, throw_on_prod_cycles = true, log_cycles = true, log_order = true } = options;

package/dist/local_repo.d.ts

@@ -5,8 +5,8 @@ import type { GitOperations, NpmOperations } from './operations.js';
 import type { GitopsConfig, GitopsRepoConfig } from './gitops_config.js';
 import type { ResolvedGitopsConfig } from './resolved_gitops_config.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;
@@ -48,14 +48,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 declare const local_repo_load: ({ local_repo_path, log: _log, git_ops, npm_ops, }: {
     local_repo_path: LocalRepoPath;

package/dist/local_repo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local_repo.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/local_repo.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAC,OAAO,EAAC,MAAM,kCAAkC,CAAC;AAIzD,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAGpD,OAAO,KAAK,EAAC,aAAa,EAAE,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAGlE,OAAO,KAAK,EAAC,YAAY,EAAE,gBAAgB,EAAC,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,6BAA6B,CAAC;AAGtE;;;GAGG;AACH,MAAM,WAAW,SAAS;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,WAAW,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,gBAAgB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,gBAAgB,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,GAAU,mDAKnC;IACF,eAAe,EAAE,aAAa,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,OAAO,CAAC,EAAE,aAAa,CAAC;CACxB,KAAG,OAAO,CAAC,SAAS,CAiJpB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAU,wEAOtC;IACF,eAAe,EAAE,oBAAoB,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,YAAY,CAAC;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,CAAC;CACxB,KAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAkC/B,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAU,qEAOpC;IACF,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,KAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CA2C3B,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,6BAG/B;IACF,WAAW,EAAE,gBAAgB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CAClB,KAAG,aAAa,GAAG,gBAoBnB,CAAC"}
+{"version":3,"file":"local_repo.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/local_repo.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAC,OAAO,EAAC,MAAM,kCAAkC,CAAC;AAKzD,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAGpD,OAAO,KAAK,EAAC,aAAa,EAAE,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAGlE,OAAO,KAAK,EAAC,YAAY,EAAE,gBAAgB,EAAC,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,6BAA6B,CAAC;AAGtE;;;GAGG;AACH,MAAM,WAAW,SAAS;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,WAAW,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,gBAAgB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,gBAAgB,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,GAAU,mDAKnC;IACF,eAAe,EAAE,aAAa,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,OAAO,CAAC,EAAE,aAAa,CAAC;CACxB,KAAG,OAAO,CAAC,SAAS,CAuIpB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAU,wEAOtC;IACF,eAAe,EAAE,oBAAoB,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,YAAY,CAAC;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,CAAC;CACxB,KAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAkC/B,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAU,qEAOpC;IACF,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,KAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CA2C3B,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,6BAG/B;IACF,WAAW,EAAE,gBAAgB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CAClB,KAAG,aAAa,GAAG,gBAoBnB,CAAC"}

package/dist/local_repo.js

@@ -3,7 +3,8 @@ 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 { spawn } from '@fuzdev/fuz_util/process.js';
+import { library_load_from_repo } from '@fuzdev/gro/library_load.js';
+import { spawn_out } from '@fuzdev/fuz_util/process.js';
 import { map_concurrent_settled } from '@fuzdev/fuz_util/async.js';
 import { default_git_operations, default_npm_operations } from './operations_defaults.js';
 import { GITOPS_CONCURRENCY_DEFAULT } from './gitops_constants.js';
@@ -15,14 +16,14 @@ import { GITOPS_CONCURRENCY_DEFAULT } from './gitops_constants.js';
  * 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, log: _log, git_ops = default_git_operations, npm_ops = default_npm_operations, }) => {
     const { repo_config, repo_dir, repo_name, repo_git_ssh_url } = local_repo_path;
@@ -96,23 +97,15 @@ export const local_repo_load = async ({ local_repo_path, log: _log, git_ops = de
             }
         }
     }
-    // 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`);
-    }
-    const library_module = await import(library_path);
-    const { library_json } = library_module;
-    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`);
+    // Load library metadata via svelte-docinfo analysis (cached under `.gro/library.json`).
+    let library_json;
+    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}`);
+        throw new TaskError(`Failed to load library metadata for repo "${repo_name}" in ${repo_dir}: ${message}`);
     }
     const library = new Library(library_json);
     const local_repo = {
@@ -169,7 +162,7 @@ export const local_repos_load = async ({ local_repo_paths, log, git_ops = defaul
         // Sequential loading (original behavior)
         const loaded = [];
         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;
     }
@@ -227,14 +220,17 @@ const download_repos = async ({ repos_dir, local_repos_missing, log, npm_ops = d
     const resolved = [];
     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/dist/multi_repo_publisher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"multi_repo_publisher.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/multi_repo_publisher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAKpD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAsB,KAAK,eAAe,EAAC,MAAM,yBAAyB,CAAC;AAIlF,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,iBAAiB,CAAC;AAUtD,MAAM,WAAW,iBAAiB;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,CAAC,EAAE,eAAe,CAAC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,gBAAgB,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACnC,MAAM,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAC,CAAC,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,aAAa,GACzB,OAAO,KAAK,CAAC,SAAS,CAAC,EACvB,SAAS,iBAAiB,KACxB,OAAO,CAAC,gBAAgB,CAqU1B,CAAC"}
+{"version":3,"file":"multi_repo_publisher.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/multi_repo_publisher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAKpD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAsB,KAAK,eAAe,EAAC,MAAM,yBAAyB,CAAC;AAIlF,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,iBAAiB,CAAC;AAQtD,MAAM,WAAW,iBAAiB;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,CAAC,EAAE,eAAe,CAAC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,gBAAgB,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACnC,MAAM,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAC,CAAC,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,aAAa,GACzB,OAAO,KAAK,CAAC,SAAS,CAAC,EACvB,SAAS,iBAAiB,KACxB,OAAO,CAAC,gBAAgB,CAqU1B,CAAC"}

package/dist/multi_repo_publisher.js

@@ -254,7 +254,7 @@ export const publish_repos = async (repos, options) => {
                 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) {
                     log?.info(st('green', `  ✅ Deployed ${repo.library.name}`));
@@ -291,11 +291,11 @@ export const publish_repos = async (repos, options) => {
     };
 };
 /**
- * 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)
  */
@@ -329,7 +329,7 @@ const publish_single_repo = async (repo, options, ops = default_gitops_operation
     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) {
         throw new Error(`Failed to publish ${repo.library.name}: ${publish_result.message}`);

package/dist/npm_install_helpers.d.ts

@@ -14,9 +14,9 @@ import type { GitopsOperations } from './operations.js';
  * 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 declare const install_with_cache_healing: (repo: LocalRepo, ops: GitopsOperations, log?: Logger) => Promise<void>;

package/dist/npm_install_helpers.js

@@ -26,9 +26,9 @@ const is_etarget_error = (message, stderr) => {
  * 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 (repo, ops, log) => {

package/dist/npm_registry.d.ts

@@ -22,10 +22,10 @@ export declare const check_package_available: (pkg: string, version: string, opt
  * 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 declare const wait_for_package: (pkg: string, version: string, options?: WaitOptions) => Promise<void>;

package/dist/npm_registry.js

@@ -27,10 +27,10 @@ export const check_package_available = async (pkg, version, options = {}) => {
  * 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 (pkg, version, options = {}) => {
@@ -46,7 +46,6 @@ export const wait_for_package = async (pkg, version, options = {}) => {
             throw new Error(`Timeout waiting for ${pkg}@${version} after ${timeout}ms`);
         }
         // 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;
@@ -58,7 +57,7 @@ export const wait_for_package = async (pkg, version, options = {}) => {
         // 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);
     }