@fuzdev/fuz_gitops 0.78.0 → 0.79.0

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

@@ -7,16 +7,16 @@ export const GithubPullRequest = z.object({
     number: z.number(),
     title: z.string(),
     user: z.object({
-        login: z.string(),
+        login: z.string()
     }),
-    draft: z.boolean(),
+    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;
+    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;
@@ -27,6 +27,7 @@ export const fetch_github_pull_requests = async (repo_info, options = {}) => {
         token,
         cache,
         log,
+        fetch
     });
     if (!fetched.ok) {
         // TODO @many this is messy but I think it's the main case we need to worry about?
@@ -44,17 +45,24 @@ 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(),
+        .nullable()
 });
 export const GithubCheckRuns = z.object({
     total_count: z.number(),
-    check_runs: z.array(GithubCheckRunsItem),
+    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;
@@ -65,15 +73,16 @@ export const fetch_github_check_runs = async (repo_info, options = {}) => {
         token,
         cache,
         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,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"}
+{"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,EAAC,IAAI,EAAC,MAAM,aAAa,CAAC;AACtC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAgBtB,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_wildcard_dependencies, format_dev_cycles, format_production_cycles } from './log_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,53 +12,66 @@ 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),
     markdown: (data) => format_markdown(data.graph, data.analysis, data.publishing_order),
-    stdout: (data, log) => format_stdout(data.graph, data.analysis, data.publishing_order, log),
+    stdout: (data, log) => format_stdout(data.graph, data.analysis, data.publishing_order, log)
 });
 // Helper to calculate common statistics
 const calculate_stats = (graph) => {
@@ -70,7 +83,7 @@ const format_json = (graph, analysis, publishing_order) => {
     const output = {
         graph: graph.toJSON(),
         analysis,
-        publishing_order,
+        publishing_order
     };
     return JSON.stringify(output, null, 2);
 };

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

package/dist/gitops_config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gitops_config.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/gitops_config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,yBAAyB,CAAC;AAGjD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,yBAAyB,CAAC;AAIvD,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAChC,WAAW,EAAE,YAAY,KACrB,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC/B,KAAK,CAAC,EAAE,KAAK,CAAC,GAAG,GAAG,mBAAmB,CAAC,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAChC;;;;;;OAMG;IACH,QAAQ,EAAE,GAAG,CAAC;IAEd;;;;;;;;;;;OAWG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;IAElB;;OAEG;IACH,UAAU,EAAE,oBAAoB,CAAC;IAEjC;;;OAGG;IACH,EAAE,EAAE,OAAO,CAAC;IAEZ;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,EAAE,GAAG,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,kEAAkE;IAClE,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,oFAAoF;IACpF,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,iFAAiF;IACjF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,0BAA0B,QAAO,YAG5C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAAI,YAAY,eAAe,KAAG,YAUrE,CAAC;AAwBF,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,kBAAkB,CAAC;CACvD;AAED,eAAO,MAAM,kBAAkB,GAAU,aAAa,MAAM,KAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAazF,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,CAC3C,aAAa,EAAE,GAAG,EAClB,WAAW,EAAE,MAAM,KACf,OAAO,CAAC,aAAa,IAAI,kBAS7B,CAAC"}
+{"version":3,"file":"gitops_config.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/gitops_config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,iCAAiC;AACjC,eAAO,MAAM,YAAY;;kBAIvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,yDAAyD;AACzD,MAAM,MAAM,kBAAkB,GAAG,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AAE5E,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,kBAAkB,CAAC;CACpD;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,kCAAkC,GAC9C,SAAS,aAAa,CAAC,gBAAgB,CAAC,EACxC,iBAAiB,OAAO,KACtB,KAAK,CAAC,gBAAgB,CACgD,CAAC;AAE1E;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAU,aAAa,MAAM,KAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAwBzF,CAAC;AAKF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,KAAK,OAAO,EAAE,aAAa,MAAM,KAAG,YAwBvE,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,CAC3C,aAAa,EAAE,GAAG,EAClB,WAAW,EAAE,MAAM,KACf,OAAO,CAAC,aAAa,IAAI,kBAS7B,CAAC"}