@fuzdev/fuz_gitops 0.78.0 → 0.79.0

package/dist/publishing_plan_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"publishing_plan_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/publishing_plan_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAoD,KAAK,QAAQ,EAAC,MAAM,oBAAoB,CAAC;AACpG,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,GACxC,OAAO,KAAK,CAAC,SAAS,CAAC,EACvB,oBAAoB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACvC,mBAAmB,GAAG,CAAC,MAAM,CAAC,KAC5B;IACF,kBAAkB,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC5C,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;CAwE9C,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,kCAAkC,GAC9C,MAAM,SAAS,EACf,oBAAoB,KAAK,CAAC,gBAAgB,CAAC,EAC3C,mBAAmB,GAAG,CAAC,MAAM,CAAC,KAC5B,QAAQ,GAAG,IAqBb,CAAC"}
+{"version":3,"file":"publishing_plan_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/publishing_plan_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAGN,KAAK,QAAQ,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,GACxC,OAAO,KAAK,CAAC,SAAS,CAAC,EACvB,oBAAoB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACvC,mBAAmB,GAAG,CAAC,MAAM,CAAC,KAC5B;IACF,kBAAkB,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC5C,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;CAwE9C,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,kCAAkC,GAC9C,MAAM,SAAS,EACf,oBAAoB,KAAK,CAAC,gBAAgB,CAAC,EAC3C,mBAAmB,GAAG,CAAC,MAAM,CAAC,KAC5B,QAAQ,GAAG,IAqBb,CAAC"}

package/dist/publishing_plan_helpers.js

@@ -28,7 +28,7 @@ export const calculate_dependency_updates = (repos, predicted_versions, breaking
                         updated_dependency: dep_name,
                         current_version,
                         new_version,
-                        type: 'dependencies',
+                        type: 'dependencies'
                     });
                     if (breaking_packages.has(dep_name)) {
                         const cascades = breaking_cascades.get(dep_name) || [];
@@ -50,7 +50,7 @@ export const calculate_dependency_updates = (repos, predicted_versions, breaking
                         updated_dependency: dep_name,
                         current_version,
                         new_version,
-                        type: 'peerDependencies',
+                        type: 'peerDependencies'
                     });
                     if (breaking_packages.has(dep_name)) {
                         const cascades = breaking_cascades.get(dep_name) || [];
@@ -72,7 +72,7 @@ export const calculate_dependency_updates = (repos, predicted_versions, breaking
                         updated_dependency: dep_name,
                         current_version,
                         new_version,
-                        type: 'devDependencies',
+                        type: 'devDependencies'
                     });
                 }
             }

package/dist/publishing_plan_logging.d.ts

@@ -6,7 +6,7 @@
  * @module
  */
 import type { Logger } from '@fuzdev/fuz_util/log.ts';
-import type { PublishingPlan } from './publishing_plan.js';
+import { type PublishingPlan } from './publishing_plan.js';
 export interface LogPlanOptions {
     verbose?: boolean;
 }

package/dist/publishing_plan_logging.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"publishing_plan_logging.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/publishing_plan_logging.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAGpD,OAAO,KAAK,EACX,cAAc,EAQd,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,cAAc;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AA2GD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC/B,MAAM,cAAc,EACpB,KAAK,MAAM,EACX,UAAS,cAAmB,KAC1B,IA6IF,CAAC"}
+{"version":3,"file":"publishing_plan_logging.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/publishing_plan_logging.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAGtD,OAAO,EAEN,KAAK,cAAc,EAQnB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,cAAc;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AA6GD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC/B,MAAM,cAAc,EACpB,KAAK,MAAM,EACX,UAAS,cAAmB,KAC1B,IAmJF,CAAC"}

package/dist/publishing_plan_logging.js

@@ -6,6 +6,7 @@
  * @module
  */
 import { styleText as st } from 'node:util';
+import { version_change_kind } from './publishing_plan.js';
 const SEPARATOR = '────────────────────────────────────────';
 /**
  * Logs a section header with separators.
@@ -22,7 +23,7 @@ const log_section_header = (title, log) => {
 const format_dep_diff = (dep_name, current, next) => {
     return [
         st('red', `    - "${dep_name}": "${current}"`),
-        st('green', `    + "${dep_name}": "${next}"`),
+        st('green', `    + "${dep_name}": "${next}"`)
     ];
 };
 /**
@@ -45,23 +46,24 @@ const get_updates_for_package = (pkg_name, dependency_updates) => {
 const log_version_change_with_diffs = (change, index, total, dependency_updates, breaking_cascades, log) => {
     const breaking_indicator = change.breaking ? st('red', ' BREAKING') : '';
     const position = st('dim', `[${index + 1}/${total}]`);
+    const kind = version_change_kind(change);
     // Determine scenario label
     let scenario_label = '';
-    if (change.needs_bump_escalation) {
+    if (kind === 'escalation') {
         scenario_label = st('yellow', ` [${change.existing_bump} → ${change.required_bump}]`);
     }
-    else if (change.will_generate_changeset) {
+    else if (kind === 'auto') {
         scenario_label = st('cyan', ' [auto-changeset]');
     }
     // Main version line
     log.info(`${position} ${change.package_name}: ${change.from} → ${st('green', change.to)} ` +
         `(${change.bump_type})${scenario_label}${breaking_indicator}`);
     // Show escalation reason
-    if (change.needs_bump_escalation) {
+    if (kind === 'escalation') {
         log.info(st('dim', `      changesets specify ${change.existing_bump}, dependencies require ${change.required_bump}`));
     }
     // Show trigger reason for auto-changesets
-    if (change.will_generate_changeset) {
+    if (kind === 'auto') {
         // Find what triggered this
         const triggers = [];
         for (const [pkg, affected] of breaking_cascades) {
@@ -93,7 +95,7 @@ const log_version_change_with_diffs = (change, index, total, dependency_updates,
  * dependency-only updates, warnings, and a summary.
  */
 export const log_publishing_plan = (plan, log, options = {}) => {
-    const { publishing_order, version_changes, dependency_updates, breaking_cascades, warnings, info, errors, } = plan;
+    const { publishing_order, version_changes, dependency_updates, breaking_cascades, warnings, info, no_changes, errors } = plan;
     // Errors first (blocking issues)
     if (errors.length > 0) {
         log.error(st('red', 'Errors:'));
@@ -116,14 +118,14 @@ export const log_publishing_plan = (plan, log, options = {}) => {
             const idx_b = publishing_order.indexOf(b.package_name);
             return idx_a - idx_b;
         });
-        // Separate into groups for headers
-        const with_changesets = ordered_changes.filter((vc) => vc.has_changesets && !vc.needs_bump_escalation);
-        const with_escalation = ordered_changes.filter((vc) => vc.needs_bump_escalation);
-        const with_auto_changesets = ordered_changes.filter((vc) => vc.will_generate_changeset);
+        // Separate into groups for headers; each change lands in exactly one
+        const with_changesets = ordered_changes.filter((vc) => version_change_kind(vc) === 'explicit');
+        const with_escalation = ordered_changes.filter((vc) => version_change_kind(vc) === 'escalation');
+        const with_auto_changesets = ordered_changes.filter((vc) => version_change_kind(vc) === 'auto');
         // A single running counter across all groups so positions read 1..N with no
         // gaps. (Numbering per-group index would make the first group skip the numbers
         // that land in a later group, e.g. jump from `[9/12]` to `[11/12]`.)
-        const total = with_changesets.length + with_escalation.length + with_auto_changesets.length;
+        const total = ordered_changes.length;
         let position = 0;
         const log_change_group = (title, color, changes) => {
             if (changes.length === 0)
@@ -174,14 +176,19 @@ export const log_publishing_plan = (plan, log, options = {}) => {
         }
         log.info('');
     }
-    // Info (packages with no changes)
-    if (info.length > 0) {
-        log.info(st('dim', `No changes: ${info.join(', ')}`));
+    // Info sentences, then the packages with nothing to publish
+    for (const line of info) {
+        log.info(st('dim', line));
+    }
+    if (no_changes.length > 0) {
+        log.info(st('dim', `No changes: ${no_changes.join(', ')}`));
+    }
+    if (info.length > 0 || no_changes.length > 0) {
         log.info('');
     }
     // Summary
     const major_count = version_changes.filter((vc) => vc.breaking).length;
-    const auto_count = version_changes.filter((vc) => vc.will_generate_changeset).length;
+    const auto_count = version_changes.filter((vc) => version_change_kind(vc) === 'auto').length;
     log.info(st('cyan', 'Summary:'));
     log.info(`  ${version_changes.length} packages to publish`);
     if (auto_count > 0) {

package/dist/repo.svelte.d.ts

@@ -14,6 +14,11 @@ import { GithubCheckRunsItem, type GithubPullRequest } from './github.js';
 export interface RepoJson {
     library_json: LibraryJson;
     package_json: PackageJson;
+    /**
+     * The branch the repo's registry entry follows, which `check_runs` was
+     * fetched for. `Repo.branch` reads `main` when it's absent.
+     */
+    branch?: string;
     check_runs: GithubCheckRunsItem | null;
     pull_requests: Array<GithubPullRequest> | null;
 }
@@ -27,6 +32,8 @@ export declare class Repo {
     readonly library: Library;
     /** The repo's full `package.json` (with `dependencies`/`devDependencies`). */
     readonly package_json: PackageJson;
+    /** The branch CI status was fetched for and the dashboard links to. */
+    readonly branch: string;
     check_runs: GithubCheckRunsItem | null;
     pull_requests: Array<GithubPullRequest> | null;
     get name(): string;

package/dist/repo.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repo.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/repo.svelte.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,WAAW,EAAE,UAAU,EAAC,MAAM,kCAAkC,CAAC;AAC9E,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,8BAA8B,CAAC;AAC1D,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAC,OAAO,EAAC,MAAM,kCAAkC,CAAC;AAEzD,OAAO,EAAC,mBAAmB,EAAE,KAAK,iBAAiB,EAAC,MAAM,aAAa,CAAC;AAExE;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACxB,YAAY,EAAE,WAAW,CAAC;IAC1B,YAAY,EAAE,WAAW,CAAC;IAC1B,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACvC,aAAa,EAAE,KAAK,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC;CAC/C;AAED;;;;;GAKG;AACH,qBAAa,IAAI;IAChB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;IACnC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACvC,aAAa,EAAE,KAAK,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC;IAG/C,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD,IAAI,SAAS,IAAI,MAAM,CAEtB;IACD,IAAI,QAAQ,IAAI,GAAG,CAElB;IACD,IAAI,YAAY,IAAI,GAAG,GAAG,IAAI,CAE7B;IACD,IAAI,QAAQ,IAAI,GAAG,GAAG,IAAI,CAEzB;IACD,IAAI,QAAQ,IAAI,MAAM,CAErB;IACD,IAAI,OAAO,IAAI,GAAG,GAAG,IAAI,CAExB;IACD,IAAI,aAAa,IAAI,GAAG,GAAG,IAAI,CAE9B;IACD,gGAAgG;IAChG,IAAI,QAAQ,IAAI,OAAO,CAEtB;IACD,IAAI,WAAW,IAAI,UAAU,CAE5B;gBAEW,SAAS,EAAE,QAAQ;CAM/B;AAED,MAAM,WAAW,KAAK;IACrB,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;CACnB;AAED,eAAO,MAAM,aAAa;;;;CAA0B,CAAC;AAErD,eAAO,MAAM,WAAW,GAAI,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,cAAc,MAAM,KAAG,KAMtE,CAAC"}
+{"version":3,"file":"repo.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/repo.svelte.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE1E;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACxB,YAAY,EAAE,WAAW,CAAC;IAC1B,YAAY,EAAE,WAAW,CAAC;IAC1B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACvC,aAAa,EAAE,KAAK,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC;CAC/C;AAED;;;;;GAKG;AACH,qBAAa,IAAI;IAChB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;IACnC,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACvC,aAAa,EAAE,KAAK,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC;IAG/C,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD,IAAI,SAAS,IAAI,MAAM,CAEtB;IACD,IAAI,QAAQ,IAAI,GAAG,CAElB;IACD,IAAI,YAAY,IAAI,GAAG,GAAG,IAAI,CAE7B;IACD,IAAI,QAAQ,IAAI,GAAG,GAAG,IAAI,CAEzB;IACD,IAAI,QAAQ,IAAI,MAAM,CAErB;IACD,IAAI,OAAO,IAAI,GAAG,GAAG,IAAI,CAExB;IACD,IAAI,aAAa,IAAI,GAAG,GAAG,IAAI,CAE9B;IACD,gGAAgG;IAChG,IAAI,QAAQ,IAAI,OAAO,CAEtB;IACD,IAAI,WAAW,IAAI,UAAU,CAE5B;gBAEW,SAAS,EAAE,QAAQ;CAO/B;AAED,MAAM,WAAW,KAAK;IACrB,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;CACnB;AAED,eAAO,MAAM,aAAa;;;;CAA0B,CAAC;AAErD,eAAO,MAAM,WAAW,GAAI,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,cAAc,MAAM,KAAG,KAMtE,CAAC"}

package/dist/repo.svelte.js

@@ -11,6 +11,8 @@ export class Repo {
     library;
     /** The repo's full `package.json` (with `dependencies`/`devDependencies`). */
     package_json;
+    /** The branch CI status was fetched for and the dashboard links to. */
+    branch;
     check_runs;
     pull_requests;
     // Convenience getters delegating to library
@@ -48,6 +50,7 @@ export class Repo {
     constructor(repo_json) {
         this.library = new Library(repo_json.library_json);
         this.package_json = repo_json.package_json;
+        this.branch = repo_json.branch ?? 'main';
         this.check_runs = repo_json.check_runs;
         this.pull_requests = repo_json.pull_requests;
     }

package/dist/repo_readiness.d.ts

@@ -0,0 +1,210 @@
+/**
+ * Whether each configured repo sits where the registry puts it, read from the
+ * entries `repos status --json` reports: the facts `gitops_publish --wetrun`
+ * gates on, the ones `gitops_sync` refuses or warns on, and the at-rest block
+ * the read-only diagnostics print.
+ *
+ * Pure — a report's facts in, problems and their messages out; no git calls.
+ * The facts are decided on the Rust side (`at_rest`, `fetch_error`, a
+ * checkout's `busy`, `needs_human`); this reads them, never re-derives them.
+ *
+ * Three readings:
+ *
+ * - **at rest** (`repo_readiness_at_rest`) — the primary checkout on the
+ *   branch the entry follows, clean (untracked files count), no operation in
+ *   progress, and that branch in sync with its origin upstream as of the
+ *   local remote-tracking refs. What the diagnostics report.
+ * - **ready to publish** (`repo_readiness_for_publish`) — at rest, except
+ *   that the followed branch may be ahead of origin (origin's tip is then an
+ *   ancestor, so the plan misses nothing and the release push is still a
+ *   fast-forward), and also fetched without error (so the relation is
+ *   origin's current word), no other live Claude Code session in the primary
+ *   checkout (the executor commits there), and nothing the entry leaves to a
+ *   person (`needs_human`).
+ * - **ready to generate** (`repo_readiness_for_gen`) — what `gitops_sync`
+ *   needs before it writes the dashboard's site data: the primary checkout
+ *   on its branch, clean, and idle, since the site pairs each repo's local
+ *   tree with origin's CI. The followed branch's relation to origin and a
+ *   failed fetch only warn.
+ *
+ * @module
+ */
+import type { Result } from '@fuzdev/fuz_util/result.ts';
+import type { ReposEntryStatus, ReposFetchFailure, ReposHead, ReposInProgressOp, ReposNeedsHuman, ReposRelation, ReposSession, ReposStatusReport, ReposUncommitted } from './repos_status.js';
+/** One way a repo isn't where the registry puts it, or isn't ready to publish. */
+export type RepoReadinessProblem = {
+    kind: 'unprobed';
+    detail: string;
+} | {
+    kind: 'no_branch';
+} | {
+    kind: 'off_branch';
+    branch: string;
+    head: ReposHead;
+} | {
+    kind: 'dirty';
+    uncommitted: ReposUncommitted;
+} | {
+    kind: 'in_progress';
+    op: ReposInProgressOp | null;
+} | {
+    kind: 'followed';
+    branch: string;
+    relation: ReposRelation | null;
+} | {
+    kind: 'fetch_failed';
+    failure: ReposFetchFailure;
+} | {
+    kind: 'busy';
+    sessions: Array<ReposSession>;
+} | {
+    kind: 'needs_human';
+    reason: ReposNeedsHuman;
+};
+/** A repo's readiness problems, by registry key; `entry` is `null` when the report lacks it. */
+export interface RepoReadiness {
+    key: string;
+    entry: ReposEntryStatus | null;
+    problems: Array<RepoReadinessProblem>;
+}
+/**
+ * The ways an entry's primary checkout isn't at rest where the registry puts
+ * it, from its `at_rest` facts: empty when it is.
+ *
+ * @param entry - the entry as `repos status --json` reported it
+ * @returns the problems, in a fixed order: unprobed alone, else branch, dirt, operation, then the followed branch's relation
+ */
+export declare const repo_readiness_at_rest: (entry: ReposEntryStatus) => Array<RepoReadinessProblem>;
+/**
+ * The ways an entry isn't ready for `gitops_publish --wetrun`: not at rest
+ * (`repo_readiness_at_rest`) other than its followed branch being ahead of
+ * origin, its fetch failed, another live session works in its primary
+ * checkout, or it has a `needs_human` reason. Ahead is ready: origin's tip is
+ * an ancestor of the branch, so the plan misses nothing and `gro publish`'s
+ * push stays a fast-forward, pushing those commits with the release (see
+ * `format_readiness_ahead`). A reason restating
+ * an at-rest problem (the primary's operation or detached HEAD) is left out,
+ * and a `default_branch_*` reason stands in for the followed-branch problem
+ * it explains.
+ *
+ * @param entry - the entry as `repos status --fetch --json` reported it
+ * @returns the problems; empty when the entry is ready
+ */
+export declare const repo_readiness_for_publish: (entry: ReposEntryStatus) => Array<RepoReadinessProblem>;
+/** Options for the messages naming what's wrong and the fix. */
+export interface RepoReadinessFormatOptions {
+    /** The `repos` invocation fixes name; `repos --registry <path>` when the run passed one. */
+    repos_command?: string;
+}
+/**
+ * What a readiness problem says is wrong with the repo keyed `key`, and the
+ * fix, when there is one to name.
+ *
+ * @param key - the repo's registry key
+ * @param problem - one of the repo's readiness problems
+ * @param options - the `repos` invocation fixes name
+ * @returns what's wrong, and the fix
+ */
+export declare const format_repo_readiness_problem: (key: string, problem: RepoReadinessProblem, options?: RepoReadinessFormatOptions) => {
+    what: string;
+    fix: string;
+};
+/**
+ * Checks a `repos status --fetch --json` report on the repos a real publish
+ * reads and writes: every key's entry ready (`repo_readiness_for_publish`),
+ * the report fetched, and busy detection available, since a live session it
+ * can't vouch for may be working in any checkout.
+ *
+ * @param options.report - the report, made with `--fetch`
+ * @param options.keys - the registry keys that must be ready
+ * @returns `ahead`, the ready repos whose followed branch is ahead of origin; and on failure a message naming each repo, what's wrong, and the fix, its `lines`, and every not-ready repo
+ */
+export declare const check_publish_readiness: (options: {
+    report: ReposStatusReport;
+    keys: ReadonlyArray<string>;
+} & RepoReadinessFormatOptions) => Result<{
+    ahead: Array<ReadinessAhead>;
+}, {
+    message: string;
+    lines: Array<string>;
+    not_ready: Array<RepoReadiness>;
+    ahead: Array<ReadinessAhead>;
+}>;
+/**
+ * An entry's problems for `gitops_sync`, split by what they do to the run:
+ * `refused` stops it, `warned` is logged. Off its branch, dirty, or mid-operation
+ * refuses, since the site would show that working tree's modules beside origin's
+ * CI — unless `allow_dirty`, which reads the repo as it sits and warns instead.
+ * A checkout that can't be read, or an entry following no branch (only a
+ * reference follows none, and the config refuses references), always
+ * refuses. The followed branch not in sync
+ * with origin (behind, say: CI is origin's tip, the modules the local tree) and
+ * a failed fetch (the last fetch's view stands) warn. Busy sessions and
+ * `needs_human` reasons don't matter: generating writes nothing in the repo.
+ *
+ * @param entry - the entry as `repos status --json` reported it
+ * @param options.allow_dirty - read a repo off its branch, dirty, or mid-operation as it sits
+ * @returns the problems that refuse, and those that warn
+ */
+export declare const repo_readiness_for_gen: (entry: ReposEntryStatus, options?: {
+    allow_dirty?: boolean;
+}) => {
+    refused: Array<RepoReadinessProblem>;
+    warned: Array<RepoReadinessProblem>;
+};
+/**
+ * Checks a `repos status --json` report on the repos `gitops_sync` generates
+ * the site data from (`repo_readiness_for_gen`).
+ *
+ * @param options.report - the report
+ * @param options.keys - the registry keys whose repos the site data reads
+ * @param options.allow_dirty - read repos off their branch, dirty, or mid-operation as they sit
+ * @param options.now - the current time in unix seconds, for how long ago each repo was fetched (defaults to the clock)
+ * @returns `warnings`, a line per problem that doesn't refuse; and on failure also a message naming each refused repo, what's wrong, and the fix, and its `lines`
+ */
+export declare const check_gen_readiness: (options: {
+    report: ReposStatusReport;
+    keys: ReadonlyArray<string>;
+    allow_dirty?: boolean;
+    now?: number;
+} & RepoReadinessFormatOptions) => Result<{
+    warnings: Array<string>;
+}, {
+    message: string;
+    lines: Array<string>;
+    warnings: Array<string>;
+}>;
+/** A ready repo whose followed branch is ahead of origin: commits a publish pushes. */
+export interface ReadinessAhead {
+    key: string;
+    branch: string;
+    commits: number;
+}
+/**
+ * Says what happens to a ready repo's commits ahead of origin: its release
+ * push carries them when it publishes, else they stay unpushed.
+ *
+ * @param ahead - the repo, its branch, and how many commits it's ahead
+ * @param publishes - whether the plan publishes it
+ * @param options - the `repos` invocation the message names
+ * @returns the line to log
+ */
+export declare const format_readiness_ahead: (ahead: ReadinessAhead, publishes: boolean, options?: RepoReadinessFormatOptions) => string;
+/**
+ * The repos not at rest, for the read-only diagnostics' readiness block.
+ *
+ * @param entries - the entries of the repos a diagnostic reads
+ * @returns each entry with at-rest problems, in the order given
+ */
+export declare const repos_not_at_rest: (entries: ReadonlyArray<ReposEntryStatus>) => Array<RepoReadiness>;
+/**
+ * Formats the diagnostics' readiness block: a header and a line per problem,
+ * saying what each repo not at rest is doing instead — or no lines when every
+ * repo is at rest. Not a failure: the diagnostics read repos as they sit.
+ *
+ * @param not_ready - `repos_not_at_rest`'s result
+ * @param now - the current time in unix seconds, for how long ago each repo was fetched
+ * @returns the block's lines, unindented header first
+ */
+export declare const format_readiness_block: (not_ready: ReadonlyArray<RepoReadiness>, now: number) => Array<string>;
+//# sourceMappingURL=repo_readiness.d.ts.map

package/dist/repo_readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo_readiness.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/repo_readiness.ts"],"names":[],"mappings":"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"}