@fuzdev/fuz_gitops 0.78.0 → 0.79.0

package/dist/dependency_graph.js

@@ -1,9 +1,10 @@
 /**
  * Dependency graph data structure and algorithms for multi-repo publishing.
  *
- * Provides `DependencyGraph` class with topological sort (via `@fuzdev/fuz_util/sort.ts`)
- * and cycle detection by dependency type.
- * For validation workflow and publishing order computation, see `graph_validation.ts`.
+ * Provides the `DependencyGraph` class, built from local repos, with topological sort
+ * (via `@fuzdev/fuz_util/sort.ts`), cycle detection by dependency type, and
+ * wildcard-range analysis.
+ * For the publishing order and the analysis workflow, see `graph_validation.ts`.
  *
  * @module
  */
@@ -12,33 +13,31 @@ import { topological_sort as topological_sort_generic } from '@fuzdev/fuz_util/s
 export const DEPENDENCY_TYPE = {
     PROD: 'prod',
     PEER: 'peer',
-    DEV: 'dev',
+    DEV: 'dev'
 };
 export class DependencyGraph {
-    nodes;
-    edges; // pkg -> dependents
-    constructor() {
-        this.nodes = new Map();
-        this.edges = new Map();
-    }
-    init_from_repos(repos) {
-        // First pass: create nodes
+    nodes = new Map();
+    edges = new Map(); // pkg -> dependents
+    /**
+     * Builds the graph from local repos.
+     *
+     * Two passes: first creates nodes, then builds edges (dependents).
+     * Prioritizes prod/peer deps over dev deps when the same package appears in
+     * multiple dependency types (the stronger constraint wins).
+     */
+    constructor(repos) {
+        // first pass: create nodes
         for (const repo of repos) {
             const { library, package_json } = repo;
             const node = {
                 name: library.name,
                 version: package_json.version || '0.0.0',
-                repo,
                 dependencies: new Map(),
-                dependents: new Set(),
-                publishable: !package_json.private,
+                dependents: new Set()
             };
-            // Extract dependencies
             const deps = package_json.dependencies || EMPTY_OBJECT;
             const dev_deps = package_json.devDependencies || EMPTY_OBJECT;
             const peer_deps = package_json.peerDependencies || EMPTY_OBJECT;
-            // Add dependencies, prioritizing prod/peer over dev
-            // (if a package appears in multiple dep types, use the stronger constraint)
             for (const [name, version] of Object.entries(deps)) {
                 node.dependencies.set(name, { type: DEPENDENCY_TYPE.PROD, version });
             }
@@ -46,7 +45,7 @@ export class DependencyGraph {
                 node.dependencies.set(name, { type: DEPENDENCY_TYPE.PEER, version });
             }
             for (const [name, version] of Object.entries(dev_deps)) {
-                // Only add dev deps if not already present as prod/peer
+                // only add dev deps if not already present as prod/peer
                 if (!node.dependencies.has(name)) {
                     node.dependencies.set(name, { type: DEPENDENCY_TYPE.DEV, version });
                 }
@@ -54,12 +53,11 @@ export class DependencyGraph {
             this.nodes.set(library.name, node);
             this.edges.set(library.name, new Set());
         }
-        // Second pass: build edges (dependents)
+        // second pass: build edges (dependents) for internal dependencies
         for (const node of this.nodes.values()) {
             for (const [dep_name] of node.dependencies) {
-                if (this.nodes.has(dep_name)) {
-                    // Internal dependency
-                    const dep_node = this.nodes.get(dep_name);
+                const dep_node = this.nodes.get(dep_name);
+                if (dep_node) {
                     dep_node.dependents.add(node.name);
                     this.edges.get(dep_name).add(node.name);
                 }
@@ -69,13 +67,6 @@ export class DependencyGraph {
     get_node(name) {
         return this.nodes.get(name);
     }
-    get_dependents(name) {
-        return this.edges.get(name) || new Set();
-    }
-    get_dependencies(name) {
-        const node = this.nodes.get(name);
-        return node ? node.dependencies : new Map();
-    }
     /**
      * Computes topological sort order for dependency graph.
      *
@@ -96,7 +87,7 @@ export class DependencyGraph {
                     return false;
                 return this.nodes.has(dep_name);
             })
-                .map(([dep_name]) => dep_name),
+                .map(([dep_name]) => dep_name)
         }));
         const result = topological_sort_generic(items, 'package');
         if (!result.ok) {
@@ -120,6 +111,22 @@ export class DependencyGraph {
         const dev_cycles = this.#find_cycles((spec) => spec.type === DEPENDENCY_TYPE.DEV);
         return { production_cycles, dev_cycles };
     }
+    /**
+     * Reports cycles by type and wildcard (`*`) dependency ranges.
+     * Tolerates cycles: it reports them rather than throwing.
+     */
+    analyze() {
+        const { production_cycles, dev_cycles } = this.detect_cycles_by_type();
+        const wildcard_deps = [];
+        for (const node of this.nodes.values()) {
+            for (const [dep_name, spec] of node.dependencies) {
+                if (spec.version === '*') {
+                    wildcard_deps.push({ pkg: node.name, dep: dep_name, version: spec.version });
+                }
+            }
+        }
+        return { production_cycles, dev_cycles, wildcard_deps };
+    }
     /** DFS cycle detection following only edges that match the filter. */
     #find_cycles(include) {
         const cycles = [];
@@ -165,10 +172,9 @@ export class DependencyGraph {
             version: node.version,
             dependencies: Array.from(node.dependencies.entries()).map(([name, spec]) => ({
                 name,
-                spec,
+                spec
             })),
-            dependents: Array.from(node.dependents),
-            publishable: node.publishable,
+            dependents: Array.from(node.dependents)
         }));
         const edges = [];
         for (const [from, tos] of this.edges) {
@@ -179,52 +185,3 @@ export class DependencyGraph {
         return { nodes, edges };
     }
 }
-/**
- * Builder for creating and analyzing dependency graphs.
- */
-export class DependencyGraphBuilder {
-    /**
-     * Constructs dependency graph from local repos.
-     *
-     * Two-pass algorithm: first creates nodes, then builds edges (dependents).
-     * Prioritizes prod/peer deps over dev deps when same package appears in
-     * multiple dependency types (stronger constraint wins).
-     *
-     * @returns fully initialized dependency graph with all nodes and edges
-     */
-    build_from_repos(repos) {
-        const graph = new DependencyGraph();
-        graph.init_from_repos(repos);
-        return graph;
-    }
-    /**
-     * Computes publishing order using topological sort with dev deps excluded.
-     *
-     * Excludes dev dependencies to break circular dev dependency cycles while
-     * preserving production/peer dependency ordering. This allows patterns like
-     * shared test utilities that depend on each other for development.
-     *
-     * @returns package names in safe publishing order (dependencies before dependents)
-     * @throws {Error} if production/peer cycles detected (cannot be resolved by exclusion)
-     */
-    compute_publishing_order(graph) {
-        return graph.topological_sort(true); // Exclude dev dependencies
-    }
-    analyze(graph) {
-        const { production_cycles, dev_cycles } = graph.detect_cycles_by_type();
-        const wildcard_deps = [];
-        const missing_peers = [];
-        for (const node of graph.nodes.values()) {
-            for (const [dep_name, spec] of node.dependencies) {
-                if (spec.version === '*') {
-                    wildcard_deps.push({ pkg: node.name, dep: dep_name, version: spec.version });
-                }
-                if (spec.type === DEPENDENCY_TYPE.PEER && !graph.nodes.has(dep_name)) {
-                    // External peer dependency
-                    missing_peers.push({ pkg: node.name, dep: dep_name });
-                }
-            }
-        }
-        return { production_cycles, dev_cycles, wildcard_deps, missing_peers };
-    }
-}

package/dist/dependency_updater.d.ts

@@ -19,7 +19,7 @@ export interface UpdatePackageJsonOptions {
  * 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
+ * Uses version strategy to determine prefix (exact, caret, tilde, gte) while preserving
  * existing prefixes when possible.
  *
  * @throws {Error} if file operations or git operations fail

package/dist/dependency_updater.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dependency_updater.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/dependency_updater.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAGpD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,2BAA2B,CAAC;AAMhE,OAAO,KAAK,EAAC,aAAa,EAAE,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAGjE,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;AAElE,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB,GAC/B,MAAM,SAAS,EACf,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,UAAS,wBAA6B,KACpC,OAAO,CAAC,IAAI,CAkId,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,YAAY,CAAC;CACtB;AAED,eAAO,MAAM,gBAAgB,GAC5B,OAAO,KAAK,CAAC,SAAS,CAAC,EACvB,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,UAAS,qBAA0B,KACjC,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAC,CAAC,CAAA;CAAC,CAuDxE,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC/B,MAAM,SAAS,EACf,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAC5B,GAAG,CACL,MAAM,EACN;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,cAAc,GAAG,iBAAiB,GAAG,kBAAkB,CAAA;CAAC,CAkD7F,CAAC"}
+{"version":3,"file":"dependency_updater.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/dependency_updater.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAGtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAMlE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGnE,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;AAElE,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB,GAC/B,MAAM,SAAS,EACf,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,UAAS,wBAA6B,KACpC,OAAO,CAAC,IAAI,CAwId,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,YAAY,CAAC;CACtB;AAED,eAAO,MAAM,gBAAgB,GAC5B,OAAO,KAAK,CAAC,SAAS,CAAC,EACvB,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,UAAS,qBAA0B,KACjC,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAA;CAAE,CAuD5E,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC/B,MAAM,SAAS,EACf,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAC5B,GAAG,CACL,MAAM,EACN;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,cAAc,GAAG,iBAAiB,GAAG,kBAAkB,CAAA;CAAE,CAkD/F,CAAC"}

package/dist/dependency_updater.js

@@ -1,5 +1,5 @@
 import { join } from 'node:path';
-import { create_changeset_for_dependency_updates, create_dependency_updates, } from './changeset_generator.js';
+import { create_changeset_for_dependency_updates, create_dependency_updates } from './changeset_generator.js';
 import { needs_update, get_update_prefix } from './version_utils.js';
 import { default_git_operations, default_fs_operations } from './operations_defaults.js';
 /**
@@ -11,13 +11,13 @@ import { default_git_operations, default_fs_operations } from './operations_defa
  * 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
+ * Uses version strategy to determine prefix (exact, caret, tilde, gte) while preserving
  * existing prefixes when possible.
  *
  * @throws {Error} if file operations or git operations fail
  */
 export const update_package_json = async (repo, updates, options = {}) => {
-    const { strategy = 'caret', published_versions, log, git_ops = default_git_operations, fs_ops = default_fs_operations, } = options;
+    const { strategy = 'caret', published_versions, log, git_ops = default_git_operations, fs_ops = default_fs_operations } = options;
     if (updates.size === 0)
         return;
     const package_json_path = join(repo.repo_dir, 'package.json');
@@ -68,11 +68,12 @@ export const update_package_json = async (repo, updates, options = {}) => {
     // Write updated package.json
     const write_result = await fs_ops.writeFile({
         path: package_json_path,
-        content: JSON.stringify(package_json, null, '\t') + '\n',
+        content: JSON.stringify(package_json, null, '\t') + '\n'
     });
     if (!write_result.ok) {
         throw new Error(`Failed to write package.json: ${write_result.message}`);
     }
+    const staged = [];
     // Create changeset if we have published version info
     if (published_versions && published_versions.size > 0) {
         // Build dependency updates info for changeset
@@ -107,6 +108,7 @@ export const update_package_json = async (repo, updates, options = {}) => {
             if (!add_result.ok) {
                 throw new Error(`Failed to stage changeset: ${add_result.message}`);
             }
+            staged.push(changeset_path);
         }
     }
     // Commit the changes (including both package.json and changeset)
@@ -114,16 +116,19 @@ export const update_package_json = async (repo, updates, options = {}) => {
     if (!add_pkg_result.ok) {
         throw new Error(`Failed to stage package.json: ${add_pkg_result.message}`);
     }
+    staged.push('package.json');
+    // commit only what this staged, so nothing else in the index rides along
     const commit_result = await git_ops.commit({
         message: `update dependencies after publishing`,
-        cwd: repo.repo_dir,
+        files: staged,
+        cwd: repo.repo_dir
     });
     if (!commit_result.ok) {
         throw new Error(`Failed to commit: ${commit_result.message}`);
     }
 };
 export const update_all_repos = async (repos, published, options = {}) => {
-    const { strategy = 'caret', log, git_ops = default_git_operations, fs_ops = default_fs_operations, } = options;
+    const { strategy = 'caret', log, git_ops = default_git_operations, fs_ops = default_fs_operations } = options;
     let updated_count = 0;
     const failed = [];
     for (const repo of repos) {
@@ -178,7 +183,7 @@ export const find_updates_needed = (repo, published) => {
                 updates.set(dep_name, {
                     current: current_version,
                     new: new_version,
-                    type: 'dependencies',
+                    type: 'dependencies'
                 });
             }
         }
@@ -191,7 +196,7 @@ export const find_updates_needed = (repo, published) => {
                 updates.set(dep_name, {
                     current: current_version,
                     new: new_version,
-                    type: 'devDependencies',
+                    type: 'devDependencies'
                 });
             }
         }
@@ -204,7 +209,7 @@ export const find_updates_needed = (repo, published) => {
                 updates.set(dep_name, {
                     current: current_version,
                     new: new_version,
-                    type: 'peerDependencies',
+                    type: 'peerDependencies'
                 });
             }
         }

package/dist/fetch_repo_data.d.ts

@@ -2,18 +2,44 @@ import type { Logger } from '@fuzdev/fuz_util/log.ts';
 import type { FetchValueCache } from '@fuzdev/fuz_util/fetch.ts';
 import type { RepoJson } from './repo.svelte.js';
 import type { LocalRepo } from './local_repo.js';
+/**
+ * Options for `fetch_repo_data`.
+ */
+export interface FetchRepoDataOptions {
+    /** The repos to fetch GitHub metadata for, in order. */
+    local_repos: Array<LocalRepo>;
+    /** GitHub API token, sent with each request. */
+    token?: string;
+    /** Response memoization, from `fuz_util`'s `fetch.ts`. */
+    cache?: FetchValueCache;
+    log?: Logger;
+    /** Milliseconds to wait before each API request. Defaults to `33`. */
+    delay?: number;
+    /** Sent as the `x-github-api-version` header when set. */
+    github_api_version?: string;
+    /** The `fetch` the API requests go through. Defaults to `globalThis.fetch`. */
+    fetch?: typeof globalThis.fetch;
+}
 /**
  * Fetches GitHub metadata (CI status, PRs) for all repos.
  *
- * Fetches sequentially with delay between requests to respect GitHub API rate limits.
- * Uses `await_in_loop` intentionally to avoid parallel requests overwhelming the API.
+ * Fetches sequentially with a delay before each request to respect GitHub API
+ * rate limits. Uses `await_in_loop` intentionally to avoid parallel requests
+ * overwhelming the API. CI status is read for the branch each repo's registry
+ * entry follows (`main` when it names none), and that branch is written to
+ * `RepoJson.branch`.
  *
- * Error handling: Logs fetch failures but continues processing remaining repos.
- * Repos with failed fetches will have `null` for `check_runs` or `pull_requests`.
+ * A repo whose registry entry declares no CI (`ci: false`) isn't asked for
+ * check runs, and one with none on its branch isn't a failure: both leave
+ * `check_runs` `null` without logging. A failed fetch is logged as an error
+ * and leaves `null` for that repo's `check_runs` or `pull_requests`, and the
+ * remaining repos still fetch — except a 401 response or a repo URL without a
+ * GitHub owner, which throw.
  *
- * @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 options - the repos, credentials, cache, and pacing
+ * @returns a `RepoJson` for each repo, in the order given
+ * @throws {Error} on a 401 response (check `SECRET_GITHUB_API_TOKEN`) or a
+ *   repo whose URL has no GitHub owner
  */
-export declare const fetch_repo_data: (resolved_repos: Array<LocalRepo>, token?: string, cache?: FetchValueCache, log?: Logger, delay?: number, github_api_version?: string) => Promise<Array<RepoJson>>;
+export declare const fetch_repo_data: (options: FetchRepoDataOptions) => Promise<Array<RepoJson>>;
 //# sourceMappingURL=fetch_repo_data.d.ts.map

package/dist/fetch_repo_data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch_repo_data.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/fetch_repo_data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAEpD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,2BAA2B,CAAC;AAG/D,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAE/C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,GAC3B,gBAAgB,KAAK,CAAC,SAAS,CAAC,EAChC,QAAQ,MAAM,EACd,QAAQ,eAAe,EACvB,MAAM,MAAM,EACZ,cAAU,EACV,qBAAqB,MAAM,KACzB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAkCzB,CAAC"}
+{"version":3,"file":"fetch_repo_data.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/fetch_repo_data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAOjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,wDAAwD;IACxD,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAC9B,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,+EAA+E;IAC/E,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,eAAe,GAAU,SAAS,oBAAoB,KAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CA+C5F,CAAC"}

package/dist/fetch_repo_data.js

@@ -3,31 +3,51 @@ import { fetch_github_check_runs, fetch_github_pull_requests } from './github.js
 /**
  * Fetches GitHub metadata (CI status, PRs) for all repos.
  *
- * Fetches sequentially with delay between requests to respect GitHub API rate limits.
- * Uses `await_in_loop` intentionally to avoid parallel requests overwhelming the API.
+ * Fetches sequentially with a delay before each request to respect GitHub API
+ * rate limits. Uses `await_in_loop` intentionally to avoid parallel requests
+ * overwhelming the API. CI status is read for the branch each repo's registry
+ * entry follows (`main` when it names none), and that branch is written to
+ * `RepoJson.branch`.
  *
- * Error handling: Logs fetch failures but continues processing remaining repos.
- * Repos with failed fetches will have `null` for `check_runs` or `pull_requests`.
+ * A repo whose registry entry declares no CI (`ci: false`) isn't asked for
+ * check runs, and one with none on its branch isn't a failure: both leave
+ * `check_runs` `null` without logging. A failed fetch is logged as an error
+ * and leaves `null` for that repo's `check_runs` or `pull_requests`, and the
+ * remaining repos still fetch — except a 401 response or a repo URL without a
+ * GitHub owner, which throw.
  *
- * @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 options - the repos, credentials, cache, and pacing
+ * @returns a `RepoJson` for each repo, in the order given
+ * @throws {Error} on a 401 response (check `SECRET_GITHUB_API_TOKEN`) or a
+ *   repo whose URL has no GitHub owner
  */
-export const fetch_repo_data = async (resolved_repos, token, cache, log, delay = 33, github_api_version) => {
+export const fetch_repo_data = async (options) => {
+    const { local_repos, token, cache, log, delay = 33, github_api_version, fetch } = options;
     const repos = [];
-    for (const { library, package_json, repo_config } of resolved_repos) {
+    for (const { library, package_json, entry } of local_repos) {
         const repo_url = library.repo_url;
-        // CI status
-        await wait(delay);
-        const check_runs = await fetch_github_check_runs(library, {
-            cache,
-            log,
-            token,
-            api_version: github_api_version,
-            ref: repo_config.branch,
-        });
-        if (!check_runs)
-            log?.error('failed to fetch CI status: ' + repo_url);
+        const branch = entry.branch ?? 'main';
+        // CI status, for repos the registry says run CI
+        let check_runs = null;
+        if (entry.ci) {
+            await wait(delay);
+            const fetched = await fetch_github_check_runs(library, {
+                cache,
+                log,
+                token,
+                api_version: github_api_version,
+                ref: branch,
+                fetch
+            });
+            if (fetched.ok) {
+                check_runs = fetched.value;
+                if (!check_runs)
+                    log?.debug(`no check runs on \`${branch}\`: ${repo_url}`);
+            }
+            else {
+                log?.error(`failed to fetch CI status (${fetched.status}): ${repo_url}`);
+            }
+        }
         // pull requests
         await wait(delay);
         const pull_requests = await fetch_github_pull_requests(library, {
@@ -35,14 +55,16 @@ export const fetch_repo_data = async (resolved_repos, token, cache, log, delay =
             log,
             token,
             api_version: github_api_version,
+            fetch
         });
         if (!pull_requests)
-            log?.error('failed to fetch issues: ' + repo_url);
+            log?.error('failed to fetch pull requests: ' + repo_url);
         repos.push({
             library_json: library.library_json,
             package_json,
+            branch,
             check_runs,
-            pull_requests,
+            pull_requests
         });
     }
     return repos;

package/dist/fs_fetch_value_cache.d.ts

@@ -14,7 +14,7 @@ export interface FetchCache {
  * cache is cleared (delete file) and starts fresh. This handles format changes.
  *
  * Uses `structuredClone` to track changes - only writes to disk if data modified.
- * Formatted with Prettier before writing for version control friendliness.
+ * Formatted with gro's `format_file` before writing for version control friendliness.
  *
  * @param name - cache filename (without .json extension)
  * @param dir - cache directory (defaults to `.gro/build/fetch/`)

package/dist/fs_fetch_value_cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs_fetch_value_cache.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/fs_fetch_value_cache.ts"],"names":[],"mappings":"AAIA,OAAO,EAAqC,KAAK,eAAe,EAAC,MAAM,2BAA2B,CAAC;AAKnG,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,eAAe,CAAC;IACtB;;OAEG;IACH,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7B;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,2BAA2B,GACvC,MAAM,MAAM,EACZ,YAAgC,KAC9B,OAAO,CAAC,UAAU,CA2BpB,CAAC"}
+{"version":3,"file":"fs_fetch_value_cache.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/fs_fetch_value_cache.ts"],"names":[],"mappings":"AAIA,OAAO,EAGN,KAAK,eAAe,EACpB,MAAM,2BAA2B,CAAC;AAKnC,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,eAAe,CAAC;IACtB;;OAEG;IACH,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7B;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,2BAA2B,GACvC,MAAM,MAAM,EACZ,YAAgC,KAC9B,OAAO,CAAC,UAAU,CA2BpB,CAAC"}

package/dist/fs_fetch_value_cache.js

@@ -11,7 +11,7 @@ import { existsSync } from 'node:fs';
  * cache is cleared (delete file) and starts fresh. This handles format changes.
  *
  * Uses `structuredClone` to track changes - only writes to disk if data modified.
- * Formatted with Prettier before writing for version control friendliness.
+ * Formatted with gro's `format_file` before writing for version control friendliness.
  *
  * @param name - cache filename (without .json extension)
  * @param dir - cache directory (defaults to `.gro/build/fetch/`)
@@ -42,9 +42,9 @@ export const create_fs_fetch_value_cache = async (name, dir = join(paths.build,
                 return false; // no changes to save
             }
             await mkdir(dirname(data_path), { recursive: true });
-            await writeFile(data_path, await format_file(serialize_cache(data), { filepath: data_path }));
+            await writeFile(data_path, format_file(serialize_cache(data), { lang: 'json' }));
             return true;
-        },
+        }
     };
 };
 // TODO this is quick and dirty, but fine because it's only expected to be called during development

package/dist/git_operations.d.ts

@@ -1,59 +1,16 @@
 import type { SpawnOptions } from 'node:child_process';
-import { type GitBranch, type GitOrigin } from '@fuzdev/fuz_util/git.ts';
 /**
  * Adds files to git staging area and throws if anything goes wrong.
  */
 export declare const git_add: (files: string | Array<string>, options?: SpawnOptions) => Promise<void>;
 /**
- * Commits staged changes with a message and throws if anything goes wrong.
+ * Commits `files` alone with a message, leaving anything else staged out of
+ * the commit, and throws if anything goes wrong. `files` must be non-empty:
+ * an empty list would commit the whole index.
  */
-export declare const git_commit: (message: string, options?: SpawnOptions) => Promise<void>;
+export declare const git_commit: (message: string, files: Array<string>, options?: SpawnOptions) => Promise<void>;
 /**
- * Adds files and commits in one operation and throws if anything goes wrong.
+ * Wrapper for gro's `git_current_commit_hash` that reads `HEAD` and throws if null.
  */
-export declare const git_add_and_commit: (files: string | Array<string>, message: string, options?: SpawnOptions) => Promise<void>;
-/**
- * Creates a git tag and throws if anything goes wrong.
- */
-export declare const git_tag: (tag_name: string, message?: string, options?: SpawnOptions) => Promise<void>;
-/**
- * Pushes a tag to origin and throws if anything goes wrong.
- */
-export declare const git_push_tag: (tag_name: string, origin?: GitOrigin, options?: SpawnOptions) => Promise<void>;
-/**
- * Returns `true` if the working tree has any changes — staged, unstaged, or
- * untracked (`git status --porcelain`). Broader than `git_list_uncommitted_files`,
- * which reports only tracked working-tree changes relative to HEAD.
- */
-export declare const git_has_changes: (options?: SpawnOptions) => Promise<boolean>;
-/**
- * Lists uncommitted files in the working tree (`git diff --name-only HEAD`).
- */
-export declare const git_list_uncommitted_files: (options?: SpawnOptions) => Promise<Array<string>>;
-export declare const git_has_file_changed: (from_commit: string, to_commit: string, file_path: string, options?: SpawnOptions) => Promise<boolean>;
-/**
- * Stashes current changes and throws if anything goes wrong.
- */
-export declare const git_stash: (message?: string, options?: SpawnOptions) => Promise<void>;
-/**
- * Applies stashed changes and throws if anything goes wrong.
- */
-export declare const git_stash_pop: (options?: SpawnOptions) => Promise<void>;
-/**
- * Switches to a branch with safety checks and throws if workspace is not clean.
- */
-export declare const git_switch_branch: (branch: GitBranch, pull?: boolean, options?: SpawnOptions) => Promise<void>;
-/**
- * Wrapper for gro's `git_current_branch_name` that throws if null.
- */
-export declare const git_current_branch_name_required: (options?: SpawnOptions) => Promise<string>;
-/**
- * Wrapper for gro's `git_current_commit_hash` that throws if null.
- */
-export declare const git_current_commit_hash_required: (branch?: string, options?: SpawnOptions) => Promise<string>;
-/**
- * Wrapper for gro's `git_check_clean_workspace` that returns a boolean.
- */
-export declare const git_check_clean_workspace_as_boolean: (options?: SpawnOptions) => Promise<boolean>;
-export declare const git_has_remote: (remote?: string, options?: SpawnOptions) => Promise<boolean>;
+export declare const git_current_commit_hash_required: (options?: SpawnOptions) => Promise<string>;
 //# sourceMappingURL=git_operations.d.ts.map

package/dist/git_operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git_operations.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/git_operations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAMN,KAAK,SAAS,EACd,KAAK,SAAS,EACd,MAAM,yBAAyB,CAAC;AAEjC;;GAEG;AACH,eAAO,MAAM,OAAO,GACnB,OAAO,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,EAC7B,UAAU,YAAY,KACpB,OAAO,CAAC,IAAI,CAQd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,GAAU,SAAS,MAAM,EAAE,UAAU,YAAY,KAAG,OAAO,CAAC,IAAI,CAOtF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC9B,OAAO,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,EAC7B,SAAS,MAAM,EACf,UAAU,YAAY,KACpB,OAAO,CAAC,IAAI,CAGd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,GACnB,UAAU,MAAM,EAChB,UAAU,MAAM,EAChB,UAAU,YAAY,KACpB,OAAO,CAAC,IAAI,CASd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,GACxB,UAAU,MAAM,EAChB,SAAQ,SAAiC,EACzC,UAAU,YAAY,KACpB,OAAO,CAAC,IAAI,CAOd,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAU,UAAU,YAAY,KAAG,OAAO,CAAC,OAAO,CAG7E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,GACtC,UAAU,YAAY,KACpB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAQvB,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAChC,aAAa,MAAM,EACnB,WAAW,MAAM,EACjB,WAAW,MAAM,EACjB,UAAU,YAAY,KACpB,OAAO,CAAC,OAAO,CAOjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,GAAU,UAAU,MAAM,EAAE,UAAU,YAAY,KAAG,OAAO,CAAC,IAAI,CAStF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAU,UAAU,YAAY,KAAG,OAAO,CAAC,IAAI,CAOxE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC7B,QAAQ,SAAS,EACjB,OAAM,OAAc,EACpB,UAAU,YAAY,KACpB,OAAO,CAAC,IAAI,CAoBd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gCAAgC,GAAU,UAAU,YAAY,KAAG,OAAO,CAAC,MAAM,CAM7F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gCAAgC,GAC5C,SAAS,MAAM,EACf,UAAU,YAAY,KACpB,OAAO,CAAC,MAAM,CAMhB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oCAAoC,GAChD,UAAU,YAAY,KACpB,OAAO,CAAC,OAAO,CAGjB,CAAC;AAEF,eAAO,MAAM,cAAc,GAC1B,SAAQ,MAAiB,EACzB,UAAU,YAAY,KACpB,OAAO,CAAC,OAAO,CAQjB,CAAC"}
+{"version":3,"file":"git_operations.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/git_operations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD;;GAEG;AACH,eAAO,MAAM,OAAO,GACnB,OAAO,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,EAC7B,UAAU,YAAY,KACpB,OAAO,CAAC,IAAI,CAQd,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GACtB,SAAS,MAAM,EACf,OAAO,KAAK,CAAC,MAAM,CAAC,EACpB,UAAU,YAAY,KACpB,OAAO,CAAC,IAAI,CAcd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gCAAgC,GAAU,UAAU,YAAY,KAAG,OAAO,CAAC,MAAM,CAM7F,CAAC"}