@fuzdev/fuz_gitops 0.57.0

package/dist/fs_fetch_value_cache.d.ts

@@ -0,0 +1,24 @@
+import { type FetchValueCache } from '@fuzdev/fuz_util/fetch.js';
+export interface FetchCache {
+    name: string;
+    data: FetchValueCache;
+    /**
+     * @returns true if anything changed, false if no-op
+     */
+    save: () => Promise<boolean>;
+}
+/**
+ * Creates file-system backed cache for belt's fetch.js API responses.
+ *
+ * Cache invalidation strategy: If cache file can't be read or parsed, entire
+ * cache is cleared (delete file) and starts fresh. This handles format changes.
+ *
+ * Uses `structuredClone` to track changes - only writes to disk if data modified.
+ * Formatted with Prettier before writing for version control friendliness.
+ *
+ * @param name cache filename (without .json extension)
+ * @param dir cache directory (defaults to `.gro/build/fetch/`)
+ * @returns cache object with Map-based data and save() method
+ */
+export declare const create_fs_fetch_value_cache: (name: string, dir?: string) => Promise<FetchCache>;
+//# sourceMappingURL=fs_fetch_value_cache.d.ts.map

package/dist/fs_fetch_value_cache.d.ts.map

@@ -0,0 +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"}

package/dist/fs_fetch_value_cache.js

@@ -0,0 +1,61 @@
+import { mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { paths } from '@ryanatkn/gro/paths.js';
+import { format_file } from '@ryanatkn/gro/format_file.js';
+import { deserialize_cache, serialize_cache } from '@fuzdev/fuz_util/fetch.js';
+import { existsSync } from 'node:fs';
+/**
+ * Creates file-system backed cache for belt's fetch.js API responses.
+ *
+ * Cache invalidation strategy: If cache file can't be read or parsed, entire
+ * cache is cleared (delete file) and starts fresh. This handles format changes.
+ *
+ * Uses `structuredClone` to track changes - only writes to disk if data modified.
+ * Formatted with Prettier before writing for version control friendliness.
+ *
+ * @param name cache filename (without .json extension)
+ * @param dir cache directory (defaults to `.gro/build/fetch/`)
+ * @returns cache object with Map-based data and save() method
+ */
+export const create_fs_fetch_value_cache = async (name, dir = join(paths.build, 'fetch')) => {
+    const data_path = join(dir, name + '.json');
+    let data;
+    if (existsSync(data_path)) {
+        try {
+            data = deserialize_cache(await readFile(data_path, 'utf8')); // TODO pass schema to parse so failures invalidate the cache
+        }
+        catch (_err) {
+            // something went wrong, maybe the data format changed, so clear the cache
+            data = new Map();
+            await rm(data_path);
+        }
+    }
+    else {
+        data = new Map();
+    }
+    const initial = structuredClone(data);
+    return {
+        name,
+        data,
+        save: async () => {
+            if (deep_equal_maps(initial, data)) {
+                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 }));
+            return true;
+        },
+    };
+};
+// TODO this is quick and dirty, but fine because it's only expected to be called during development
+const deep_equal_maps = (a, b) => {
+    if (a.size !== b.size) {
+        return false;
+    }
+    for (const [key, value] of a) {
+        if (!b.has(key) || JSON.stringify(b.get(key)) !== JSON.stringify(value)) {
+            return false;
+        }
+    }
+    return true;
+};

package/dist/git_operations.d.ts

@@ -0,0 +1,54 @@
+import type { SpawnOptions } from 'node:child_process';
+import { type GitBranch, type GitOrigin } from '@fuzdev/fuz_util/git.js';
+/**
+ * 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.
+ */
+export declare const git_commit: (message: string, options?: SpawnOptions) => Promise<void>;
+/**
+ * Adds files and commits in one operation and throws if anything goes wrong.
+ */
+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>;
+export declare const git_has_changes: (options?: SpawnOptions) => Promise<boolean>;
+/**
+ * Returns list of changed files compared to HEAD.
+ */
+export declare const git_get_changed_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>;
+//# sourceMappingURL=git_operations.d.ts.map

package/dist/git_operations.d.ts.map

@@ -0,0 +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,CAMd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,GAAU,SAAS,MAAM,EAAE,UAAU,YAAY,KAAG,OAAO,CAAC,IAAI,CAKtF,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,CAOd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,GACxB,UAAU,MAAM,EAChB,SAAQ,SAAiC,EACzC,UAAU,YAAY,KACpB,OAAO,CAAC,IAAI,CAKd,CAAC;AAEF,eAAO,MAAM,eAAe,GAAU,UAAU,YAAY,KAAG,OAAO,CAAC,OAAO,CAG7E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAU,UAAU,YAAY,KAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAQzF,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,CAOtF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAU,UAAU,YAAY,KAAG,OAAO,CAAC,IAAI,CAKxE,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"}

package/dist/git_operations.js

@@ -0,0 +1,144 @@
+import { spawn, spawn_out } 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);
+    if (!result.ok) {
+        throw Error(`git_add failed with code ${result.code}`);
+    }
+};
+/**
+ * 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);
+    if (!result.ok) {
+        throw Error(`git_commit failed with code ${result.code}`);
+    }
+};
+/**
+ * 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 = await spawn('git', args, options);
+    if (!result.ok) {
+        throw Error(`git_tag failed for tag '${tag_name}' with code ${result.code}`);
+    }
+};
+/**
+ * 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);
+    if (!result.ok) {
+        throw Error(`git_push_tag failed for tag '${tag_name}' with code ${result.code}`);
+    }
+};
+export const git_has_changes = async (options) => {
+    const { stdout } = await spawn_out('git', ['status', '--porcelain'], options);
+    return stdout ? stdout.trim().length > 0 : false;
+};
+/**
+ * Returns list of changed files compared to HEAD.
+ */
+export const git_get_changed_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 = await spawn('git', args, options);
+    if (!result.ok) {
+        throw Error(`git_stash failed with code ${result.code}`);
+    }
+};
+/**
+ * Applies stashed changes and throws if anything goes wrong.
+ */
+export const git_stash_pop = async (options) => {
+    const result = await spawn('git', ['stash', 'pop'], options);
+    if (!result.ok) {
+        throw Error(`git_stash_pop failed with code ${result.code}`);
+    }
+};
+/**
+ * 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');
+    }
+    return branch;
+};
+/**
+ * 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);
+    if (!hash) {
+        throw new Error(`Failed to get commit hash for branch: ${branch || 'current'}`);
+    }
+    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

@@ -0,0 +1,91 @@
+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.
+ */
+export interface GithubRepoInfo {
+    owner_name: string | null;
+    repo_name: string;
+}
+/**
+ * @see https://docs.github.com/en/rest/pulls/pulls?apiVersion=2022-11-28#list-pull-requests
+ */
+export declare const GithubPullRequest: z.ZodObject<{
+    number: z.ZodNumber;
+    title: z.ZodString;
+    user: z.ZodObject<{
+        login: z.ZodString;
+    }, z.core.$strip>;
+    draft: z.ZodBoolean;
+}, z.core.$strip>;
+export type GithubPullRequest = z.infer<typeof GithubPullRequest>;
+export declare const GithubPullRequests: z.ZodArray<z.ZodObject<{
+    number: z.ZodNumber;
+    title: z.ZodString;
+    user: z.ZodObject<{
+        login: z.ZodString;
+    }, z.core.$strip>;
+    draft: z.ZodBoolean;
+}, z.core.$strip>>;
+export type GithubPullRequests = z.infer<typeof GithubPullRequests>;
+/**
+ * @see https://docs.github.com/en/rest/pulls/pulls?apiVersion=2022-11-28#list-pull-requests
+ */
+export declare const fetch_github_pull_requests: (repo_info: GithubRepoInfo, options?: {
+    cache?: FetchValueCache;
+    log?: Logger;
+    token?: string;
+    api_version?: string;
+}) => Promise<GithubPullRequests | null>;
+/**
+ * @see https://docs.github.com/en/rest/checks/runs?apiVersion=2022-11-28#list-check-runs-for-a-git-reference
+ */
+export declare const GithubCheckRunsItem: z.ZodObject<{
+    status: z.ZodEnum<{
+        queued: "queued";
+        in_progress: "in_progress";
+        completed: "completed";
+    }>;
+    conclusion: z.ZodNullable<z.ZodEnum<{
+        success: "success";
+        failure: "failure";
+        neutral: "neutral";
+        cancelled: "cancelled";
+        skipped: "skipped";
+        timed_out: "timed_out";
+        action_required: "action_required";
+    }>>;
+}, z.core.$strip>;
+export type GithubCheckRunsItem = z.infer<typeof GithubCheckRunsItem>;
+export declare const GithubCheckRuns: z.ZodObject<{
+    total_count: z.ZodNumber;
+    check_runs: z.ZodArray<z.ZodObject<{
+        status: z.ZodEnum<{
+            queued: "queued";
+            in_progress: "in_progress";
+            completed: "completed";
+        }>;
+        conclusion: z.ZodNullable<z.ZodEnum<{
+            success: "success";
+            failure: "failure";
+            neutral: "neutral";
+            cancelled: "cancelled";
+            skipped: "skipped";
+            timed_out: "timed_out";
+            action_required: "action_required";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type GithubCheckRuns = z.infer<typeof GithubCheckRuns>;
+/**
+ * @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?: {
+    cache?: FetchValueCache;
+    log?: Logger;
+    token?: string;
+    api_version?: string;
+    ref?: string;
+}) => Promise<GithubCheckRunsItem | null>;
+//# sourceMappingURL=github.d.ts.map

package/dist/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/github.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,EAAc,KAAK,eAAe,EAAC,MAAM,2BAA2B,CAAC;AAE5E;;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"}

package/dist/github.js

@@ -0,0 +1,94 @@
+import { z } from 'zod';
+import { fetch_value } from '@fuzdev/fuz_util/fetch.js';
+/**
+ * @see https://docs.github.com/en/rest/pulls/pulls?apiVersion=2022-11-28#list-pull-requests
+ */
+export const GithubPullRequest = z.object({
+    number: z.number(),
+    title: z.string(),
+    user: z.object({
+        login: z.string(),
+    }),
+    draft: z.boolean(),
+});
+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;
+    if (!repo_info.owner_name)
+        throw Error('owner_name is required');
+    const headers = api_version ? new Headers({ 'x-github-api-version': api_version }) : undefined;
+    const url = `https://api.github.com/repos/${repo_info.owner_name}/${repo_info.repo_name}/pulls`;
+    const fetched = await fetch_value(url, {
+        request: { headers },
+        parse: GithubPullRequests.parse,
+        token,
+        cache,
+        log,
+    });
+    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 pull requests - check your SECRET_GITHUB_API_TOKEN');
+        }
+        return null;
+    }
+    return fetched.value;
+};
+/**
+ * @see https://docs.github.com/en/rest/checks/runs?apiVersion=2022-11-28#list-check-runs-for-a-git-reference
+ */
+export const GithubCheckRunsItem = z.object({
+    status: z.enum(['queued', 'in_progress', 'completed']),
+    conclusion: z
+        .enum(['success', 'failure', 'neutral', 'cancelled', 'skipped', 'timed_out', 'action_required'])
+        .nullable(),
+});
+export const GithubCheckRuns = z.object({
+    total_count: z.number(),
+    check_runs: z.array(GithubCheckRunsItem),
+});
+/**
+ * @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;
+    if (!repo_info.owner_name)
+        throw Error('owner_name is required');
+    const headers = api_version ? new Headers({ 'x-github-api-version': api_version }) : undefined;
+    const url = `https://api.github.com/repos/${repo_info.owner_name}/${repo_info.repo_name}/commits/${ref}/check-runs`;
+    const fetched = await fetch_value(url, {
+        request: { headers },
+        parse: (v) => reduce_check_runs(GithubCheckRuns.parse(v).check_runs),
+        token,
+        cache,
+        log,
+    });
+    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 fetched.value;
+};
+const reduce_check_runs = (check_runs) => {
+    if (!check_runs.length)
+        return null;
+    // TODO fix these types and remove the eslint disable, `GithubCheckRunsItem` should maybe have nullable properties?
+    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;
+        }
+        if (!conclusion || conclusion === 'success') {
+            conclusion = check_run.conclusion;
+        }
+    }
+    return { status, conclusion };
+};

package/dist/github_helpers.d.ts

@@ -0,0 +1,10 @@
+import type { GithubPullRequest } from './github.js';
+import type { Repo } from './repo.svelte.js';
+export type FilterPullRequest = (pull_request: GithubPullRequest, repo: Repo) => boolean;
+export interface PullRequestMeta {
+    repo: Repo;
+    pull_request: GithubPullRequest;
+}
+export declare const to_pull_requests: (repos: Array<Repo>, filter_pull_request?: FilterPullRequest) => Array<PullRequestMeta>;
+export declare const to_pull_url: (repo_url: string, pull: GithubPullRequest) => string;
+//# sourceMappingURL=github_helpers.d.ts.map

package/dist/github_helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/github_helpers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,kBAAkB,CAAC;AAE3C,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"}

package/dist/github_helpers.js

@@ -0,0 +1,13 @@
+import { ensure_end } from '@fuzdev/fuz_util/string.js';
+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_url = (repo_url, pull) => ensure_end(repo_url, '/') + 'pull/' + pull.number;

package/dist/gitops_analyze.task.d.ts

@@ -0,0 +1,17 @@
+import type { Task } from '@ryanatkn/gro';
+import { z } from 'zod';
+/** @nodocs */
+export declare const Args: z.ZodObject<{
+    path: z.ZodDefault<z.ZodString>;
+    dir: z.ZodOptional<z.ZodString>;
+    format: z.ZodDefault<z.ZodEnum<{
+        json: "json";
+        stdout: "stdout";
+        markdown: "markdown";
+    }>>;
+    outfile: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type Args = z.infer<typeof Args>;
+/** @nodocs */
+export declare const task: Task<Args>;
+//# sourceMappingURL=gitops_analyze.task.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gitops_analyze.task.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/gitops_analyze.task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,eAAe,CAAC;AACxC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAetB,cAAc;AACd,eAAO,MAAM,IAAI;;;;;;;;;kBAcf,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"}