@fuzdev/fuz_gitops 0.78.1 → 0.79.0

package/dist/operations.d.ts

@@ -2,7 +2,8 @@
  * Operations interfaces for dependency injection.
  *
  * This is the core pattern enabling testability without mocks.
- * All side effects (git, npm, fs, process) are abstracted into interfaces.
+ * All side effects (git, npm, fs, process, build, and the `repos` binary) are
+ * abstracted into interfaces.
  *
  * **Design principles:**
  * - All operations accept a single `options` object parameter
@@ -14,22 +15,29 @@
  * **Production usage:**
  * ```typescript
  * import {default_gitops_operations} from './operations_defaults.js';
- * const result = await ops.git.current_branch_name({cwd: '/path'});
+ * const ops = default_gitops_operations;
+ * const result = await ops.git.current_commit_hash({cwd: '/path'});
  * if (!result.ok) {
  *   throw new TaskError(result.message);
  * }
- * const branch = result.value;
+ * const commit = result.value;
  * ```
  *
  * **Test usage:**
  * ```typescript
- * const mock_ops = create_mock_operations();
- * const result = await publish_repos(repos, {...options, ops: mock_ops});
+ * import {create_mock_gitops_ops} from './test_helpers.js';
+ * const ops = create_mock_gitops_ops({
+ *   changeset: {has_changesets: async () => ({ok: true, value: false})}
+ * });
+ * const result = await publish_repos(repos, {...options, ops});
  * // Assert on result without any real git/npm calls
  * ```
  *
- * See `operations_defaults.ts` for real implementations.
- * See test files (`*.test.ts`) for mock implementations.
+ * See `operations_defaults.ts` for real implementations, and the test-side mock
+ * factories: `create_mock_gitops_ops` in `src/test/test_helpers.ts` (plain
+ * objects with per-group overrides) and `create_fixture_gitops_ops` in
+ * `src/test/fixtures/mock_operations.ts` (a fixture's changesets over
+ * `create_mock_gitops_ops`, its fs empty).
  *
  * @module
  */
@@ -39,7 +47,7 @@ import type { Logger } from '@fuzdev/fuz_util/log.ts';
 import type { LocalRepo } from './local_repo.js';
 import type { ChangesetInfo } from './changeset_reader.js';
 import type { BumpType } from './version_utils.js';
-import type { PreflightOptions, PreflightResult } from './preflight_checks.js';
+import type { PreflightResult, RunPreflightChecksOptions } from './preflight_checks.js';
 import type { WaitOptions } from './npm_registry.js';
 /**
  * Changeset operations for reading and predicting versions from `.changeset/*.md` files.
@@ -84,81 +92,22 @@ export interface ChangesetOperations {
     }> | null>;
 }
 /**
- * Git operations for branch management, commits, tags, and workspace state.
- * All operations return `Result` instead of throwing errors.
+ * Git operations the publishing executor authors with: staging and committing
+ * dependency updates and auto-changesets, and reading the commit it published.
+ * All operations return `Result` instead of throwing errors. Where each repo
+ * sits (branch, dirt, relation to origin) is `ReposOperations`'s to report.
  */
 export interface GitOperations {
-    /**
-     * Gets the current branch name.
-     */
-    current_branch_name: (options?: {
-        cwd?: string;
-    }) => Promise<Result<{
-        value: string;
-    }, {
-        message: string;
-    }>>;
     /**
      * Gets the current commit hash.
      */
     current_commit_hash: (options?: {
-        branch?: string;
         cwd?: string;
     }) => Promise<Result<{
         value: string;
     }, {
         message: string;
     }>>;
-    /**
-     * Checks if the workspace is clean (no uncommitted changes).
-     */
-    check_clean_workspace: (options?: {
-        cwd?: string;
-    }) => Promise<Result<{
-        value: boolean;
-    }, {
-        message: string;
-    }>>;
-    /**
-     * Checks out a branch.
-     */
-    checkout: (options: {
-        branch: string;
-        cwd?: string;
-    }) => Promise<Result<object, {
-        message: string;
-    }>>;
-    /**
-     * Pulls changes from remote.
-     */
-    pull: (options?: {
-        origin?: string;
-        branch?: string;
-        cwd?: string;
-    }) => Promise<Result<object, {
-        message: string;
-    }>>;
-    /**
-     * Switches to a branch, optionally pulling.
-     */
-    switch_branch: (options: {
-        branch: string;
-        pull?: boolean;
-        cwd?: string;
-    }) => Promise<Result<object, {
-        message: string;
-    }>>;
-    /**
-     * Checks if a remote exists.
-     */
-    has_remote: (options?: {
-        remote?: string;
-        cwd?: string;
-    }) => Promise<Result<{
-        value: boolean;
-    }, {
-        message: string;
-    }>>;
     /**
      * Stages files for commit.
      */
@@ -169,115 +118,76 @@ export interface GitOperations {
         message: string;
     }>>;
     /**
-     * Creates a commit.
+     * Commits `files` alone (`git commit -- <files>`), leaving anything else
+     * staged out of the commit; `files` must be non-empty.
      */
     commit: (options: {
         message: string;
+        files: Array<string>;
         cwd?: string;
     }) => Promise<Result<object, {
         message: string;
     }>>;
+}
+/**
+ * Process operations for the commands the publishing executor runs in a repo
+ * (`gro publish`, `gro deploy`).
+ */
+export interface ProcessOperations {
     /**
-     * Stages files and creates a commit.
-     */
-    add_and_commit: (options: {
-        files: string | Array<string>;
-        message: string;
-        cwd?: string;
-    }) => Promise<Result<object, {
-        message: string;
-    }>>;
-    /**
-     * Checks whether the working tree has any changes — staged, unstaged, or
-     * untracked (`git status --porcelain`). Broader than `list_uncommitted_files`,
-     * which reports only tracked working-tree changes relative to HEAD.
-     */
-    has_changes: (options?: {
-        cwd?: string;
-    }) => Promise<Result<{
-        value: boolean;
-    }, {
-        message: string;
-    }>>;
-    /**
-     * Lists uncommitted files in the working tree (`git diff --name-only HEAD`),
-     * i.e. working-tree changes relative to HEAD (not a diff between two refs).
-     */
-    list_uncommitted_files: (options?: {
-        cwd?: string;
-    }) => Promise<Result<{
-        value: Array<string>;
-    }, {
-        message: string;
-    }>>;
-    /**
-     * Creates a git tag.
-     */
-    tag: (options: {
-        tag_name: string;
-        message?: string;
-        cwd?: string;
-    }) => Promise<Result<object, {
-        message: string;
-    }>>;
-    /**
-     * Pushes a tag to remote.
-     */
-    push_tag: (options: {
-        tag_name: string;
-        origin?: string;
-        cwd?: string;
-    }) => Promise<Result<object, {
-        message: string;
-    }>>;
-    /**
-     * Stashes uncommitted changes.
-     */
-    stash: (options?: {
-        message?: string;
-        cwd?: string;
-    }) => Promise<Result<object, {
-        message: string;
-    }>>;
-    /**
-     * Pops the most recent stash.
+     * Runs a command in the foreground and waits for it to exit: stdin is the
+     * terminal's, so a prompt (npm's 2FA one-time password) can be answered, and
+     * the child's output shows live — its stdout on ours, or on our stderr when
+     * `stdout` says so, and its stderr on ours. A failure carries the end of
+     * what the child wrote to stderr, bounded in lines and characters.
      */
-    stash_pop: (options?: {
+    run_interactive: (options: {
+        cmd: string;
+        args: Array<string>;
         cwd?: string;
+        /**
+         * Where the child's stdout goes: our stdout, or our stderr when our stdout
+         * carries a machine-readable stream (JSON-lines events, a JSON or markdown
+         * report) the child's output would corrupt.
+         *
+         * @default 'stdout'
+         */
+        stdout?: 'stdout' | 'stderr';
     }) => Promise<Result<object, {
         message: string;
-    }>>;
-    /**
-     * Checks if a specific file changed between two commits.
-     */
-    has_file_changed: (options: {
-        from_commit: string;
-        to_commit: string;
-        file_path: string;
-        cwd?: string;
-    }) => Promise<Result<{
-        value: boolean;
-    }, {
-        message: string;
+        stderr_tail?: string;
     }>>;
 }
 /**
- * Process spawning operations for running shell commands.
+ * What a `repos` command printed and how it exited, unparsed.
  */
-export interface ProcessOperations {
+export interface ReposCommandOutput {
+    stdout: string;
+    stderr: string;
+    /** `0` for a report, `2` for an error document, `1` for a fatal I/O error (maybe no JSON). */
+    exit_code: number;
+}
+/**
+ * Operations running the Rust `repos` binary, which owns fleet git state.
+ * Parsing its output is `repos_status_load.ts`'s, not the runner's.
+ */
+export interface ReposOperations {
     /**
-     * Spawns a child process and waits for completion.
+     * Runs `repos [--registry <path>] status [--fetch] <keys…> --json` in the
+     * process's cwd and returns what it printed, whatever its exit code. With
+     * `fetch`, `repos` fetches each entry from origin first, which writes
+     * remote-tracking refs and nothing else. Fails only when the binary didn't
+     * run to an exit: `not_found` when it isn't on `PATH`.
      */
-    spawn: (options: {
-        cmd: string;
-        args: Array<string>;
-        cwd?: string;
+    status: (options: {
+        keys: Array<string>;
+        registry?: string;
+        fetch?: boolean;
     }) => Promise<Result<{
-        stdout?: string;
-        stderr?: string;
+        output: ReposCommandOutput;
     }, {
+        kind: 'not_found' | 'failed';
         message: string;
-        stderr?: string;
     }>>;
 }
 /**
@@ -289,7 +199,6 @@ export interface BuildOperations {
      */
     build_package: (options: {
         repo: LocalRepo;
-        log?: Logger;
     }) => Promise<Result<object, {
         message: string;
         output?: string;
@@ -311,7 +220,6 @@ export interface NpmOperations {
         log?: Logger;
     }) => Promise<Result<object, {
         message: string;
-        timeout?: boolean;
     }>>;
     /**
      * Checks npm authentication status.
@@ -327,32 +235,17 @@ export interface NpmOperations {
     check_registry: () => Promise<Result<object, {
         message: string;
     }>>;
-    /**
-     * Installs npm dependencies.
-     */
-    install: (options?: {
-        cwd?: string;
-    }) => Promise<Result<object, {
-        message: string;
-        stderr?: string;
-    }>>;
 }
 /**
- * Preflight validation operations to ensure repos are ready for publishing.
- * Validates workspace state, branches, builds, and npm authentication.
+ * Preflight validation operations run before publishing: building every
+ * package the plan publishes, and npm authentication. Repo git state is the
+ * readiness gate's, before preflight (see `repo_readiness.ts`).
  */
 export interface PreflightOperations {
     /**
      * Runs preflight validation checks before publishing.
      */
-    run_preflight_checks: (options: {
-        repos: Array<LocalRepo>;
-        preflight_options: PreflightOptions;
-        git_ops?: GitOperations;
-        npm_ops?: NpmOperations;
-        build_ops?: BuildOperations;
-        changeset_ops?: ChangesetOperations;
-    }) => Promise<PreflightResult>;
+    run_preflight_checks: (options: RunPreflightChecksOptions) => Promise<PreflightResult>;
 }
 /**
  * File system operations for reading and writing files.
@@ -404,5 +297,7 @@ export interface GitopsOperations {
     preflight: PreflightOperations;
     fs: FsOperations;
     build: BuildOperations;
+    /** `repos status`, for the executor's re-check of each repo right before its publish. */
+    repos: ReposOperations;
 }
 //# sourceMappingURL=operations.d.ts.map

package/dist/operations.d.ts.map

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

package/dist/operations.js

@@ -2,7 +2,8 @@
  * Operations interfaces for dependency injection.
  *
  * This is the core pattern enabling testability without mocks.
- * All side effects (git, npm, fs, process) are abstracted into interfaces.
+ * All side effects (git, npm, fs, process, build, and the `repos` binary) are
+ * abstracted into interfaces.
  *
  * **Design principles:**
  * - All operations accept a single `options` object parameter
@@ -14,22 +15,29 @@
  * **Production usage:**
  * ```typescript
  * import {default_gitops_operations} from './operations_defaults.js';
- * const result = await ops.git.current_branch_name({cwd: '/path'});
+ * const ops = default_gitops_operations;
+ * const result = await ops.git.current_commit_hash({cwd: '/path'});
  * if (!result.ok) {
  *   throw new TaskError(result.message);
  * }
- * const branch = result.value;
+ * const commit = result.value;
  * ```
  *
  * **Test usage:**
  * ```typescript
- * const mock_ops = create_mock_operations();
- * const result = await publish_repos(repos, {...options, ops: mock_ops});
+ * import {create_mock_gitops_ops} from './test_helpers.js';
+ * const ops = create_mock_gitops_ops({
+ *   changeset: {has_changesets: async () => ({ok: true, value: false})}
+ * });
+ * const result = await publish_repos(repos, {...options, ops});
  * // Assert on result without any real git/npm calls
  * ```
  *
- * See `operations_defaults.ts` for real implementations.
- * See test files (`*.test.ts`) for mock implementations.
+ * See `operations_defaults.ts` for real implementations, and the test-side mock
+ * factories: `create_mock_gitops_ops` in `src/test/test_helpers.ts` (plain
+ * objects with per-group overrides) and `create_fixture_gitops_ops` in
+ * `src/test/fixtures/mock_operations.ts` (a fixture's changesets over
+ * `create_mock_gitops_ops`, its fs empty).
  *
  * @module
  */

package/dist/operations_defaults.d.ts

@@ -1,15 +1,30 @@
 /**
  * Production implementations of operations interfaces.
  *
- * Provides real git, npm, fs, and build operations for production use.
+ * Provides real git, npm, fs, build, and `repos` operations for production use.
  * For interface definitions and dependency injection pattern, see `operations.ts`.
  *
  * @module
  */
-import type { ChangesetOperations, GitOperations, ProcessOperations, NpmOperations, PreflightOperations, FsOperations, BuildOperations, GitopsOperations } from './operations.js';
+import type { ChangesetOperations, GitOperations, ProcessOperations, NpmOperations, PreflightOperations, FsOperations, BuildOperations, GitopsOperations, ReposOperations } from './operations.js';
 export declare const default_changeset_operations: ChangesetOperations;
 export declare const default_git_operations: GitOperations;
+/** The most lines of a child's stderr a failure carries. */
+export declare const OUTPUT_TAIL_MAX_LINES = 20;
+/** The most characters of a child's stderr a failure carries. */
+export declare const OUTPUT_TAIL_MAX_CHARS = 4096;
+/**
+ * The end of a process's output, for a failure message: its last lines, then
+ * its last characters, with terminal escape sequences stripped and trailing
+ * whitespace trimmed.
+ *
+ * @param text - the output, or as much of its end as was kept
+ * @param max_lines - the most lines to keep
+ * @param max_chars - the most characters to keep, applied after `max_lines`
+ */
+export declare const output_tail: (text: string, max_lines?: number, max_chars?: number) => string;
 export declare const default_process_operations: ProcessOperations;
+export declare const default_repos_operations: ReposOperations;
 export declare const default_npm_operations: NpmOperations;
 export declare const default_preflight_operations: PreflightOperations;
 export declare const default_fs_operations: FsOperations;

package/dist/operations_defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operations_defaults.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/operations_defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA4BH,OAAO,KAAK,EACX,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,MAAM,iBAAiB,CAAC;AA0BzB,eAAO,MAAM,4BAA4B,EAAE,mBAuB1C,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,aA8GpC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,iBAsBxC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,aAmDpC,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,mBAI1C,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,YAuCnC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,eAmBtC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,gBAQvC,CAAC"}
+{"version":3,"file":"operations_defaults.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/operations_defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,OAAO,KAAK,EACX,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,MAAM,iBAAiB,CAAC;AA0BzB,eAAO,MAAM,4BAA4B,EAAE,mBAuB1C,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,aAepC,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,iEAAiE;AACjE,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,GACvB,MAAM,MAAM,EACZ,YAAW,MAA8B,EACzC,YAAW,MAA8B,KACvC,MAUF,CAAC;AAKF,eAAO,MAAM,0BAA0B,EAAE,iBA+BxC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,eA6BtC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,aAyCpC,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,mBAI1C,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,YAuCnC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,eAkBtC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,gBASvC,CAAC"}