@fuzdev/fuz_gitops 0.78.1 → 0.79.0

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,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,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"}

package/dist/git_operations.js

@@ -1,5 +1,5 @@
 import { spawn_out, spawn_result_to_message } from '@fuzdev/fuz_util/process.ts';
-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.ts';
+import { git_current_commit_hash as gro_git_current_commit_hash } from '@fuzdev/fuz_util/git.ts';
 /**
  * Adds files to git staging area and throws if anything goes wrong.
  */
@@ -11,139 +11,26 @@ export const git_add = async (files, options) => {
     }
 };
 /**
- * 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 const git_commit = async (message, options) => {
-    const { result, stderr } = await spawn_out('git', ['commit', '-m', message], options);
-    if (!result.ok) {
-        throw Error(`git_commit failed with ${spawn_result_to_message(result)}${stderr ? ': ' + stderr.trim() : ''}`);
+export const git_commit = async (message, files, options) => {
+    if (files.length === 0) {
+        throw Error('git_commit needs at least one file: an empty list would commit the whole index');
     }
-};
-/**
- * Adds files and commits in one operation and throws if anything goes wrong.
- */
-export const git_add_and_commit = async (files, message, options) => {
-    await git_add(files, options);
-    await git_commit(message, options);
-};
-/**
- * Creates a git tag and throws if anything goes wrong.
- */
-export const git_tag = async (tag_name, message, options) => {
-    const args = message ? ['tag', '-a', tag_name, '-m', message] : ['tag', tag_name];
-    const { result, stderr } = await spawn_out('git', args, options);
+    const { result, stderr } = await spawn_out('git', ['commit', '-m', message, '--', ...files], options);
     if (!result.ok) {
-        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, stderr } = await spawn_out('git', ['push', origin, tag_name], options);
-    if (!result.ok) {
-        throw Error(`git_push_tag failed for tag '${tag_name}' with ${spawn_result_to_message(result)}${stderr ? ': ' + stderr.trim() : ''}`);
-    }
-};
-/**
- * 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 const git_has_changes = async (options) => {
-    const { stdout } = await spawn_out('git', ['status', '--porcelain'], options);
-    return stdout ? stdout.trim().length > 0 : false;
-};
-/**
- * Lists uncommitted files in the working tree (`git diff --name-only HEAD`).
- */
-export const git_list_uncommitted_files = async (options) => {
-    const { stdout } = await spawn_out('git', ['diff', '--name-only', 'HEAD'], options);
-    if (!stdout)
-        return [];
-    return stdout
-        .split('\n')
-        .map((f) => f.trim())
-        .filter(Boolean);
-};
-export const git_has_file_changed = async (from_commit, to_commit, file_path, options) => {
-    const { stdout } = await spawn_out('git', ['diff', '--name-only', from_commit, to_commit, '--', file_path], options);
-    return stdout ? stdout.trim().length > 0 : false;
-};
-/**
- * Stashes current changes and throws if anything goes wrong.
- */
-export const git_stash = async (message, options) => {
-    const args = message ? ['stash', 'push', '-m', message] : ['stash', 'push'];
-    const { result, stderr } = await spawn_out('git', args, options);
-    if (!result.ok) {
-        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, stderr } = await spawn_out('git', ['stash', 'pop'], options);
-    if (!result.ok) {
-        throw Error(`git_stash_pop failed with ${spawn_result_to_message(result)}${stderr ? ': ' + stderr.trim() : ''}`);
-    }
-};
-/**
- * Switches to a branch with safety checks and throws if workspace is not clean.
- */
-export const git_switch_branch = async (branch, pull = true, options) => {
-    // Check if workspace is clean first
-    const error = await gro_git_check_clean_workspace(options);
-    if (error) {
-        throw Error(`Cannot switch branch: ${error}`);
-    }
-    // Checkout the branch
-    await gro_git_checkout(branch, options);
-    // Pull latest changes if requested
-    if (pull) {
-        await gro_git_pull(undefined, undefined, options);
-    }
-    // Verify workspace is still clean
-    const error_after = await gro_git_check_clean_workspace(options);
-    if (error_after) {
-        throw Error(`Workspace unclean after switching to ${branch}: ${error_after}`);
-    }
-};
-/**
- * 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);
-    if (!branch) {
-        throw new Error('Failed to get current branch name');
+        throw Error(`git_commit failed with ${spawn_result_to_message(result)}${stderr ? ': ' + stderr.trim() : ''}`);
     }
-    return branch;
 };
 /**
- * Wrapper for gro's `git_current_commit_hash` that throws if null.
+ * Wrapper for gro's `git_current_commit_hash` that reads `HEAD` and throws if null.
  */
-export const git_current_commit_hash_required = async (branch, options) => {
-    const hash = await gro_git_current_commit_hash(branch, options);
+export const git_current_commit_hash_required = async (options) => {
+    const hash = await gro_git_current_commit_hash(undefined, options);
     if (!hash) {
-        throw new Error(`Failed to get commit hash for branch: ${branch || 'current'}`);
+        throw new Error('Failed to get the current commit hash');
     }
     return hash;
 };
-/**
- * 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);
-    return error === null;
-};
-export const git_has_remote = async (remote = 'origin', options) => {
-    const { stdout } = await spawn_out('git', ['remote'], options);
-    if (!stdout)
-        return false;
-    const remotes = stdout
-        .split('\n')
-        .map((r) => r.trim())
-        .filter(Boolean);
-    return remotes.includes(remote);
-};

package/dist/github.d.ts

@@ -1,8 +1,9 @@
 import type { Logger } from '@fuzdev/fuz_util/log.ts';
 import { z } from 'zod';
 import { type FetchValueCache } from '@fuzdev/fuz_util/fetch.ts';
+import type { Result } from '@fuzdev/fuz_util/result.ts';
 /**
- * Minimal interface for GitHub API calls - works with both `Pkg` and `Repo`.
+ * Minimal interface for GitHub API calls, satisfied structurally by fuz_ui's `Library`.
  */
 export interface GithubRepoInfo {
     owner_name: string | null;
@@ -37,6 +38,7 @@ export declare const fetch_github_pull_requests: (repo_info: GithubRepoInfo, opt
     log?: Logger;
     token?: string;
     api_version?: string;
+    fetch?: typeof globalThis.fetch;
 }) => Promise<GithubPullRequests | null>;
 /**
  * @see https://docs.github.com/en/rest/checks/runs?apiVersion=2022-11-28#list-check-runs-for-a-git-reference
@@ -79,6 +81,13 @@ export declare const GithubCheckRuns: z.ZodObject<{
 }, z.core.$strip>;
 export type GithubCheckRuns = z.infer<typeof GithubCheckRuns>;
 /**
+ * Fetches the check runs on `ref` and reduces them to one overall status and
+ * conclusion.
+ *
+ * @param repo_info - the repo's GitHub owner and name
+ * @param options - the cache, logger, token, API version, ref (`main` by default), and `fetch`
+ * @returns the reduced check runs, `null` for a ref with none (a repo without CI, or a commit CI skipped), or a failure when the request or its parse failed
+ * @throws {Error} on a 401 response (check `SECRET_GITHUB_API_TOKEN`) or a repo without an owner
  * @see https://docs.github.com/en/rest/checks/runs?apiVersion=2022-11-28#list-check-runs-for-a-git-reference
  */
 export declare const fetch_github_check_runs: (repo_info: GithubRepoInfo, options?: {
@@ -87,5 +96,11 @@ export declare const fetch_github_check_runs: (repo_info: GithubRepoInfo, option
     token?: string;
     api_version?: string;
     ref?: string;
-}) => Promise<GithubCheckRunsItem | null>;
+    fetch?: typeof globalThis.fetch;
+}) => Promise<Result<{
+    value: GithubCheckRunsItem | null;
+}, {
+    status: number;
+    message: string;
+}>>;
 //# sourceMappingURL=github.d.ts.map

package/dist/github.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"github.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/github.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAe,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;iBAO5B,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAClE,eAAO,MAAM,kBAAkB;;;;;;;kBAA6B,CAAC;AAC7D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,0BAA0B,GACtC,WAAW,cAAc,EACzB,UAAS;IACR,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CAChB,KACJ,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAsBnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;iBAK9B,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACtE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;iBAG1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,uBAAuB,GACnC,WAAW,cAAc,EACzB,UAAS;IACR,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACR,KACJ,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAoBpC,CAAC"}
+{"version":3,"file":"github.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/github.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAe,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;iBAO5B,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAClE,eAAO,MAAM,kBAAkB;;;;;;;kBAA6B,CAAC;AAC7D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,0BAA0B,GACtC,WAAW,cAAc,EACzB,UAAS;IACR,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAC3B,KACJ,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAuBnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;iBAK9B,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACtE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;iBAG1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,GACnC,WAAW,cAAc,EACzB,UAAS;IACR,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAC3B,KACJ,OAAO,CAAC,MAAM,CAAC;IAAE,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAA;CAAE,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAqB5F,CAAC"}

package/dist/github.js

@@ -16,7 +16,7 @@ export const GithubPullRequests = z.array(GithubPullRequest);
  * @see https://docs.github.com/en/rest/pulls/pulls?apiVersion=2022-11-28#list-pull-requests
  */
 export const fetch_github_pull_requests = async (repo_info, options = {}) => {
-    const { cache, log, token, api_version } = options;
+    const { cache, log, token, api_version, fetch } = options;
     if (!repo_info.owner_name)
         throw Error('owner_name is required');
     const headers = api_version ? new Headers({ 'x-github-api-version': api_version }) : undefined;
@@ -26,7 +26,8 @@ export const fetch_github_pull_requests = async (repo_info, options = {}) => {
         parse: GithubPullRequests.parse,
         token,
         cache,
-        log
+        log,
+        fetch
     });
     if (!fetched.ok) {
         // TODO @many this is messy but I think it's the main case we need to worry about?
@@ -51,10 +52,17 @@ export const GithubCheckRuns = z.object({
     check_runs: z.array(GithubCheckRunsItem)
 });
 /**
+ * Fetches the check runs on `ref` and reduces them to one overall status and
+ * conclusion.
+ *
+ * @param repo_info - the repo's GitHub owner and name
+ * @param options - the cache, logger, token, API version, ref (`main` by default), and `fetch`
+ * @returns the reduced check runs, `null` for a ref with none (a repo without CI, or a commit CI skipped), or a failure when the request or its parse failed
+ * @throws {Error} on a 401 response (check `SECRET_GITHUB_API_TOKEN`) or a repo without an owner
  * @see https://docs.github.com/en/rest/checks/runs?apiVersion=2022-11-28#list-check-runs-for-a-git-reference
  */
 export const fetch_github_check_runs = async (repo_info, options = {}) => {
-    const { cache, log, token, api_version, ref = 'main' } = options;
+    const { cache, log, token, api_version, ref = 'main', fetch } = options;
     if (!repo_info.owner_name)
         throw Error('owner_name is required');
     const headers = api_version ? new Headers({ 'x-github-api-version': api_version }) : undefined;
@@ -64,16 +72,17 @@ export const fetch_github_check_runs = async (repo_info, options = {}) => {
         parse: (v) => reduce_check_runs(GithubCheckRuns.parse(v).check_runs),
         token,
         cache,
-        log
+        log,
+        fetch
     });
     if (!fetched.ok) {
         // TODO @many this is messy but I think it's the main case we need to worry about?
         if (fetched.status === 401) {
             throw Error('401 response fetching github CI status - check your SECRET_GITHUB_API_TOKEN');
         }
-        return null;
+        return { ok: false, status: fetched.status, message: fetched.message };
     }
-    return fetched.value;
+    return { ok: true, value: fetched.value };
 };
 const reduce_check_runs = (check_runs) => {
     if (!check_runs.length)

package/dist/github_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"github_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/github_helpers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,MAAM,MAAM,iBAAiB,GAAG,CAAC,YAAY,EAAE,iBAAiB,EAAE,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC;AAEzF,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,IAAI,CAAC;IACX,YAAY,EAAE,iBAAiB,CAAC;CAChC;AAED,eAAO,MAAM,gBAAgB,GAC5B,OAAO,KAAK,CAAC,IAAI,CAAC,EAClB,sBAAsB,iBAAiB,KACrC,KAAK,CAAC,eAAe,CAYI,CAAC;AAE7B,eAAO,MAAM,WAAW,GAAI,UAAU,MAAM,EAAE,MAAM,iBAAiB,KAAG,MACtB,CAAC"}
+{"version":3,"file":"github_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/github_helpers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,MAAM,MAAM,iBAAiB,GAAG,CAAC,YAAY,EAAE,iBAAiB,EAAE,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC;AAEzF,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,IAAI,CAAC;IACX,YAAY,EAAE,iBAAiB,CAAC;CAChC;AAED,eAAO,MAAM,gBAAgB,GAC5B,OAAO,KAAK,CAAC,IAAI,CAAC,EAClB,sBAAsB,iBAAiB,KACrC,KAAK,CAAC,eAAe,CAKtB,CAAC;AAEH,eAAO,MAAM,WAAW,GAAI,UAAU,MAAM,EAAE,MAAM,iBAAiB,KAAG,MACtB,CAAC"}

package/dist/github_helpers.js

@@ -1,13 +1,5 @@
 import { ensure_end } from '@fuzdev/fuz_util/string.ts';
-export const to_pull_requests = (repos, filter_pull_request) => repos
-    .flatMap((repo) => {
-    if (!repo.pull_requests)
-        return null;
-    // TODO hacky, figure out the data structure
-    return repo.pull_requests.map((pull_request) => repo.package_json.homepage &&
-        (!filter_pull_request || filter_pull_request(pull_request, repo))
-        ? { repo, pull_request }
-        : null);
-})
-    .filter((v) => v !== null);
+export const to_pull_requests = (repos, filter_pull_request) => repos.flatMap((repo) => (repo.pull_requests ?? [])
+    .filter((pull_request) => !filter_pull_request || filter_pull_request(pull_request, repo))
+    .map((pull_request) => ({ repo, pull_request })));
 export const to_pull_url = (repo_url, pull) => ensure_end(repo_url, '/') + 'pull/' + pull.number;

package/dist/gitops_analyze.task.d.ts

@@ -1,18 +1,40 @@
 import type { Task } from '@fuzdev/gro';
 import { z } from 'zod';
+import type { Logger } from '@fuzdev/fuz_util/log.ts';
+import { type ResolveGitopsReposOptions } from './gitops_task_helpers.js';
+import { type LocalRepo } from './local_repo.js';
 /** @nodocs */
 export declare const Args: z.ZodObject<{
     config: z.ZodDefault<z.ZodString>;
-    dir: z.ZodOptional<z.ZodString>;
+    registry: z.ZodOptional<z.ZodString>;
     format: z.ZodDefault<z.ZodEnum<{
         stdout: "stdout";
         json: "json";
         markdown: "markdown";
     }>>;
     outfile: z.ZodOptional<z.ZodString>;
-    sync: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strict>;
 export type Args = z.infer<typeof Args>;
 /** @nodocs */
 export declare const task: Task<Args>;
+/**
+ * The side effects `run_gitops_analyze` reaches through, injectable for tests.
+ *
+ * @nodocs
+ */
+export interface GitopsAnalyzeDeps {
+    /** Loads the configured repos as they sit (`get_gitops_ready`). */
+    load_repos: (options: ResolveGitopsReposOptions) => Promise<{
+        local_repos: Array<LocalRepo>;
+    }>;
+}
+/**
+ * Runs `gro gitops_analyze`: loads the repos as they sit, logs the readiness
+ * block, and outputs the dependency analysis. Under `--format json` or
+ * `markdown` without `--outfile`, the log goes to stderr and stdout carries
+ * the document alone (`route_human_output`).
+ *
+ * @nodocs
+ */
+export declare const run_gitops_analyze: (args: Args, log: Logger, deps?: Partial<GitopsAnalyzeDeps>) => Promise<void>;
 //# sourceMappingURL=gitops_analyze.task.d.ts.map

package/dist/gitops_analyze.task.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gitops_analyze.task.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/gitops_analyze.task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB,cAAc;AACd,eAAO,MAAM,IAAI;;;;;;;;;;kBAqBf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,cAAc;AACd,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CAkC3B,CAAC"}
+{"version":3,"file":"gitops_analyze.task.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/gitops_analyze.task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EAGN,KAAK,yBAAyB,EAC9B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAe9D,cAAc;AACd,eAAO,MAAM,IAAI;;;;;;;;;kBAiBf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,cAAc;AACd,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CAM3B,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IACjC,mEAAmE;IACnE,UAAU,EAAE,CAAC,OAAO,EAAE,yBAAyB,KAAK,OAAO,CAAC;QAAE,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAA;KAAE,CAAC,CAAC;CAC/F;AAMD;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAC9B,MAAM,IAAI,EACV,KAAK,MAAM,EACX,OAAM,OAAO,CAAC,iBAAiB,CAAM,KACnC,OAAO,CAAC,IAAI,CAiCd,CAAC"}

package/dist/gitops_analyze.task.js

@@ -1,10 +1,10 @@
 import { z } from 'zod';
 import { styleText as st } from 'node:util';
-import { get_gitops_ready } from './gitops_task_helpers.js';
+import { get_gitops_ready, log_readiness_block } from './gitops_task_helpers.js';
 import { repo_is_npm } from './local_repo.js';
 import { analyze_repos } from './graph_validation.js';
 import { format_wildcard_dependencies, format_dev_cycles, format_production_cycles } from './log_helpers.js';
-import { format_and_output } from './output_helpers.js';
+import { format_and_output, output_is_machine, route_human_output } from './output_helpers.js';
 import { GITOPS_CONFIG_PATH_DEFAULT } from './gitops_constants.js';
 /** @nodocs */
 export const Args = z.strictObject({
@@ -12,48 +12,61 @@ export const Args = z.strictObject({
         .string()
         .meta({ description: 'path to the gitops config file, absolute or relative to the cwd' })
         .default(GITOPS_CONFIG_PATH_DEFAULT),
-    dir: z
+    registry: z
         .string()
-        .meta({ description: 'path containing the repos, defaults to the parent of the config dir' })
+        .meta({
+        description: 'path to the repos.toml registry, when `repos` would not find it walking up from the cwd'
+    })
         .optional(),
     format: z
         .enum(['stdout', 'json', 'markdown'])
         .meta({ description: 'output format' })
         .default('stdout'),
-    outfile: z.string().meta({ description: 'write output to file instead of logging' }).optional(),
-    sync: z
-        .boolean()
-        .meta({
-        description: 'sync repos (switch branch, pull, install) before analyzing instead of reading the working tree as-is'
-    })
-        .default(false)
+    outfile: z.string().meta({ description: 'write output to file instead of logging' }).optional()
 });
 /** @nodocs */
 export const task = {
     Args,
     summary: 'analyze dependency structure and relationships across repos',
     run: async ({ args, log }) => {
-        const { config, dir, format, outfile, sync } = args;
-        // Get repos ready (without downloading); read the working tree as-is unless `--sync`
-        const { local_repos } = await get_gitops_ready({ config, dir, download: false, sync, log });
-        // Only npm packages form the dependency graph; note any non-npm repos (e.g. cargo)
-        // that are excluded so the omission isn't silent.
-        const non_npm_repos = local_repos.filter((r) => !repo_is_npm(r));
-        if (non_npm_repos.length > 0) {
-            log.info(st('dim', `excluding ${non_npm_repos.length} non-npm repo(s) from analysis (dashboard-only): ` +
-                non_npm_repos.map((r) => r.library.name).join(', ')));
-        }
-        // Build the dependency graph and analyze cycles/wildcards (tolerating cycles)
-        const { graph, analysis, publishing_order } = analyze_repos(local_repos);
-        // Format and output using output_helpers
-        const data = {
-            graph,
-            analysis,
-            publishing_order
-        };
-        await format_and_output(data, create_formatters(), { format, outfile, log });
+        await run_gitops_analyze(args, log);
     }
 };
+const default_gitops_analyze_deps = {
+    load_repos: get_gitops_ready
+};
+/**
+ * Runs `gro gitops_analyze`: loads the repos as they sit, logs the readiness
+ * block, and outputs the dependency analysis. Under `--format json` or
+ * `markdown` without `--outfile`, the log goes to stderr and stdout carries
+ * the document alone (`route_human_output`).
+ *
+ * @nodocs
+ */
+export const run_gitops_analyze = async (args, log, deps = {}) => {
+    const { load_repos } = { ...default_gitops_analyze_deps, ...deps };
+    const { config, registry, format, outfile } = args;
+    const write_stdout = route_human_output(log, output_is_machine(format, outfile));
+    // Read the working trees as they sit, and say which aren't at rest
+    const { local_repos } = await load_repos({ config, registry, log });
+    log_readiness_block(local_repos, log);
+    // Only npm packages form the dependency graph; note any non-npm repos (e.g. cargo)
+    // that are excluded so the omission isn't silent.
+    const non_npm_repos = local_repos.filter((r) => !repo_is_npm(r));
+    if (non_npm_repos.length > 0) {
+        log.info(st('dim', `excluding ${non_npm_repos.length} non-npm repo(s) from analysis (dashboard-only): ` +
+            non_npm_repos.map((r) => r.library.name).join(', ')));
+    }
+    // Build the dependency graph and analyze cycles/wildcards (tolerating cycles)
+    const { graph, analysis, publishing_order } = analyze_repos(local_repos);
+    // Format and output using output_helpers
+    const data = {
+        graph,
+        analysis,
+        publishing_order
+    };
+    await format_and_output(data, create_formatters(), { format, outfile, log, write_stdout });
+};
 // Create formatters for output_helpers
 const create_formatters = () => ({
     json: (data) => format_json(data.graph, data.analysis, data.publishing_order),

package/dist/gitops_config.d.ts

@@ -1,92 +1,47 @@
 /**
- * Configuration types and normalization for gitops multi-repo management.
+ * The gitops config: which repos a project's gitops tasks work over, as a flat
+ * list of `repos.toml` registry keys.
  *
- * Two-phase configuration system:
- * - `RawGitopsConfig` - User-friendly format with optional fields and flexible types
- * - `GitopsConfig` - Internal format with required fields and strict types
- *
- * This allows users to provide minimal configs (e.g., just URLs as strings) while
- * the system works with normalized configs internally for type safety.
+ * Every other fact about a repo — its dir, URL, branch, visibility, `ci`, and
+ * `archived` — comes from the registry, through `repos status --json`, so the
+ * config declares nothing that could drift from it.
  *
  * @module
  */
-import type { Url } from '@fuzdev/fuz_util/url.ts';
-import type { GitBranch } from '@fuzdev/fuz_util/git.ts';
-export interface GitopsConfig {
-    repos: Array<GitopsRepoConfig>;
-    repos_dir: string;
-}
-export type CreateGitopsConfig = (base_config: GitopsConfig) => RawGitopsConfig | Promise<RawGitopsConfig>;
-export interface RawGitopsConfig {
-    repos?: Array<Url | RawGitopsRepoConfig>;
-    repos_dir?: string;
+import { z } from 'zod';
+import type { ReposEntryStatus } from './repos_status.js';
+/** A project's gitops config. */
+export declare const GitopsConfig: z.ZodObject<{
+    repos: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type GitopsConfig = z.infer<typeof GitopsConfig>;
+/** A config module's default export in function form. */
+export type CreateGitopsConfig = () => GitopsConfig | Promise<GitopsConfig>;
+export interface GitopsConfigModule {
+    readonly default: GitopsConfig | CreateGitopsConfig;
 }
 /**
- * Visibility of a repo on its host, mirroring the host's own model
- * (e.g. GitHub's `visibility` field). Named to avoid confusion with the npm
- * `package.json` `private` flag, which is a separate publishing concern.
+ * The private repos a public host package must not publish. `gitops_sync` writes
+ * every configured repo's GitHub metadata into the host project's generated
+ * `repos.json` — a public site's data when the host package is public — so a
+ * private repo in that config would leak. Empty when the host is private.
+ *
+ * @param entries - the configured repos' registry entries
+ * @param host_is_private - whether the host `package.json` sets `private: true`
  */
-export type GitopsRepoVisibility = 'public' | 'private';
-export interface GitopsRepoConfig {
-    /**
-     * The HTTPS URL to the repo. Does not include a `.git` suffix.
-     * @example
-     * ```ts
-     * 'https://github.com/fuzdev/fuz_ui'
-     * ```
-     */
-    repo_url: Url;
-    /**
-     * Relative or absolute path to the repo's local directory.
-     * If `null`, the directory is inferred from the URL and cwd.
-     * @example
-     * ```ts
-     * 'relative/path/to/repo'
-     * ```
-     * @example
-     * ```ts
-     * '/absolute/path/to/repo'
-     * ```
-     */
-    repo_dir: string | null;
-    /**
-     * The branch name to use when fetching the repo. Defaults to `main`.
-     */
-    branch: GitBranch;
-    /**
-     * Visibility of the repo on its host. Defaults to `'public'`.
-     */
-    visibility: GitopsRepoVisibility;
-    /**
-     * Whether the repo runs CI. Defaults to `true` for public repos and `false`
-     * for private repos, unless set explicitly.
-     */
-    ci: boolean;
-    /**
-     * Whether the repo is archived (read-only) on its host. Defaults to `false`.
-     */
-    archived: boolean;
-}
-export interface RawGitopsRepoConfig {
-    repo_url: Url;
-    repo_dir?: string | null;
-    branch?: GitBranch;
-    /** Visibility of the repo on its host. Defaults to `'public'`. */
-    visibility?: GitopsRepoVisibility;
-    /** Whether the repo runs CI. Defaults to `true` for public, `false` for private. */
-    ci?: boolean;
-    /** Whether the repo is archived (read-only) on its host. Defaults to `false`. */
-    archived?: boolean;
-}
-export declare const create_empty_gitops_config: () => GitopsConfig;
+export declare const gitops_config_leaked_private_repos: (entries: ReadonlyArray<ReposEntryStatus>, host_is_private: boolean) => Array<ReposEntryStatus>;
 /**
- * Transforms a `RawGitopsConfig` to the more strict `GitopsConfig`.
- * This allows users to provide a more relaxed config.
+ * Loads a gitops config module and validates it.
+ *
+ * @returns the config, or `null` when no file exists at `config_path`
+ * @throws {Error} if the module's default export isn't a valid config
  */
-export declare const normalize_gitops_config: (raw_config: RawGitopsConfig) => GitopsConfig;
-export interface GitopsConfigModule {
-    readonly default: RawGitopsConfig | CreateGitopsConfig;
-}
 export declare const load_gitops_config: (config_path: string) => Promise<GitopsConfig | null>;
+/**
+ * Validates a loaded config value: registry keys, each listed once.
+ *
+ * @throws {Error} naming the config and what's wrong with it
+ */
+export declare const parse_gitops_config: (raw: unknown, config_path: string) => GitopsConfig;
 export declare const validate_gitops_config_module: (config_module: any, config_path: string) => asserts config_module is GitopsConfigModule;
 //# sourceMappingURL=gitops_config.d.ts.map