@angelmsger/fx 0.0.0-stage → 0.11.0

package/dist/adapters/git/contribution-system-git.js

@@ -0,0 +1,107 @@
+// Contributions prepare objects through a private index. Publishing the branch
+// is separate so recovery metadata can be durable before any ref is moved.
+import { promises as fs } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { DevkitError } from '../../domain/errors.js';
+import { captureContribution, readContributionBase } from './contribution-capture.js';
+import { assertObjectId, runContributionGit } from './contribution-command.js';
+export class ContributionSystemGit {
+    process;
+    constructor(process) {
+        this.process = process;
+    }
+    capture(input) {
+        return captureContribution(this.process, input);
+    }
+    async prepare(input) {
+        if (!/^fx\/contribution\/[a-zA-Z0-9_-]+$/.test(input.branch))
+            throw new DevkitError('usage', 'SOURCE_BRANCH_INVALID', 'Use a managed contribution branch', {
+                nextSteps: ['fx source push --new'],
+            });
+        assertObjectId(input.parent);
+        if (input.expectedHead !== null)
+            assertObjectId(input.expectedHead);
+        const current = await this.capture(input.snapshot);
+        if (current.fingerprint !== input.snapshot.fingerprint)
+            throw new DevkitError('conflict', 'SOURCE_SNAPSHOT_CHANGED', 'Selected source files or HEAD changed after planning', { nextSteps: ['Re-run the same fx source push command to plan the current source state.'] });
+        const temporary = await fs.mkdtemp(path.join(tmpdir(), 'fx-contribution-index-'));
+        const index = path.join(temporary, 'index');
+        try {
+            return await writeCandidate({ process: this.process, input, current, index });
+        }
+        finally {
+            await fs.rm(temporary, { recursive: true, force: true });
+        }
+    }
+    async inspect(input) {
+        const git = (args, allowAbsent = false) => runContributionGit({ process: this.process, dir: input.dir, args, allowAbsent });
+        const sha = (await git(['rev-parse', '--verify', '--quiet', '--end-of-options', `${input.ref}^{commit}`], true)).trim();
+        if (!sha)
+            return null;
+        assertObjectId(sha);
+        const [tree, parents = ''] = (await git(['show', '-s', '--no-notes', '--format=%T%n%P', sha, '--']))
+            .trim()
+            .split('\n');
+        assertObjectId(tree ?? '');
+        const lineage = parents.split(' ').filter(Boolean);
+        for (const parent of lineage)
+            assertObjectId(parent);
+        return { sha, tree: tree, parents: lineage };
+    }
+    readBase(input) {
+        return readContributionBase({ ...input, process: this.process });
+    }
+    async publish(input) {
+        if (!/^fx\/contribution\/[a-zA-Z0-9_-]+$/.test(input.branch))
+            throw new DevkitError('usage', 'SOURCE_BRANCH_INVALID', 'Use a managed contribution branch', {
+                nextSteps: ['fx source push --new'],
+            });
+        assertObjectId(input.commit);
+        if (input.expectedHead !== null)
+            assertObjectId(input.expectedHead);
+        const git = (args) => runContributionGit({ process: this.process, dir: input.dir, args });
+        const worktrees = await git(['worktree', 'list', '--porcelain']);
+        if (worktrees.split('\n').includes(`branch refs/heads/${input.branch}`))
+            throw new DevkitError('conflict', 'SOURCE_BRANCH_CHECKED_OUT', 'The contribution branch is checked out; choose a new contribution', {
+                nextSteps: [
+                    `git -C ${input.dir} worktree list`,
+                    'Check out another branch there, or run fx source push --new.',
+                ],
+            });
+        if ((await this.inspect({ dir: input.dir, ref: `refs/heads/${input.branch}` }))?.sha ===
+            input.commit)
+            return;
+        await git([
+            'update-ref',
+            `refs/heads/${input.branch}`,
+            input.commit,
+            input.expectedHead ?? '0'.repeat(input.commit.length),
+        ]);
+    }
+}
+async function writeCandidate({ process, input, current, index, }) {
+    const git = (args, text) => runContributionGit({
+        process,
+        dir: current.dir,
+        args,
+        index,
+        ...(text === undefined ? {} : { input: text }),
+    });
+    await git(['read-tree', current.base]);
+    for (const file of current.files) {
+        const blob = file.content === null
+            ? '0'.repeat(input.parent.length)
+            : (await git(['hash-object', '-w', '--stdin', '--no-filters'], file.content)).trim();
+        assertObjectId(blob);
+        await git(['update-index', '-z', '--index-info'], `${file.content === null ? '0' : file.mode} ${blob}\t${file.path}\0`);
+    }
+    const tree = (await git(['write-tree'])).trim();
+    assertObjectId(tree);
+    if (tree !== current.tree)
+        throw new DevkitError('conflict', 'SOURCE_TREE_MISMATCH', 'Constructed tree differs from the preview', { nextSteps: ['Re-run the same fx source push command with --dry-run and review the plan.'] });
+    const commit = (await git(['-c', 'commit.gpgSign=false', 'commit-tree', tree, '-p', input.parent], input.message)).trim();
+    assertObjectId(commit);
+    return { commit, tree };
+}
+//# sourceMappingURL=contribution-system-git.js.map

package/dist/adapters/git/contribution-system-git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution-system-git.js","sourceRoot":"","sources":["../../../src/adapters/git/contribution-system-git.ts"],"names":[],"mappings":"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"}

package/dist/adapters/git/contribution-transport.js

@@ -0,0 +1,148 @@
+// Routing inspection records all effective source remotes and unsafe overrides.
+// A push names one commit/ref, disables tag following and never uses force.
+import { createHash } from 'node:crypto';
+import { DevkitError } from '../../domain/errors.js';
+import { assertObjectId, runContributionGit } from './contribution-command.js';
+export class ContributionGitTransport {
+    process;
+    constructor(process) {
+        this.process = process;
+    }
+    async inspect({ dir }) {
+        const read = async (args) => {
+            const text = await runContributionGit({
+                process: this.process,
+                dir,
+                args: ['config', '-z', ...args],
+                allowAbsent: true,
+            });
+            return text.split('\0').filter(Boolean);
+        };
+        const originUrls = await read(['--get-all', 'remote.origin.url']);
+        const configuredPush = await read(['--get-all', 'remote.origin.pushurl']);
+        const upstreamUrls = await read(['--get-all', 'remote.upstream.url']);
+        const mirror = await read(['--type=bool', '--get', 'remote.origin.mirror']);
+        const receivePack = await read(['--get-all', 'remote.origin.receivepack']);
+        const rewrites = await read(['--get-regexp', '^url\\..*\\.(insteadof|pushinsteadof)$']);
+        const values = {
+            originUrls,
+            pushUrls: configuredPush.length ? configuredPush : originUrls,
+            upstreamUrls,
+            hasRewrite: rewrites.length > 0,
+            isMirror: mirror.includes('true'),
+            receivePack: receivePack.length ? receivePack.join('\n') : null,
+        };
+        const fingerprint = createHash('sha256')
+            .update(JSON.stringify({ ...values, rewrites }))
+            .digest('hex');
+        return { ...values, fingerprint };
+    }
+    async upstream(input) {
+        const text = await runContributionGit({
+            process: this.process,
+            dir: input.dir,
+            args: ['ls-remote', '--symref', 'upstream', 'HEAD'],
+            network: true,
+        });
+        const branch = /^ref: refs\/heads\/(.+)\tHEAD$/m.exec(text)?.[1];
+        const sha = /^([0-9a-f]+)\tHEAD$/m.exec(text)?.[1];
+        if (!branch || !sha)
+            throw new DevkitError('config', 'SOURCE_BASE_UNVERIFIED', 'The upstream did not identify its default branch', {
+                nextSteps: [
+                    `git -C ${input.dir} ls-remote --symref upstream HEAD`,
+                    'Give the upstream repository a default branch, then retry.',
+                ],
+            });
+        assertObjectId(sha);
+        return { sha, branch };
+    }
+    async fetch(input) {
+        const current = await this.inspect(input);
+        if (current.fingerprint !== input.settings.fingerprint ||
+            current.upstreamUrls.length !== 1 ||
+            current.hasRewrite)
+            throw new DevkitError('conflict', 'SOURCE_REMOTE_CHANGED', 'Upstream routing changed after planning', {
+                nextSteps: [
+                    `git -C ${input.dir} remote -v`,
+                    'Restore the planned upstream routing, or re-run fx source push to plan again.',
+                ],
+            });
+        await runContributionGit({
+            process: this.process,
+            dir: input.dir,
+            args: ['check-ref-format', `refs/heads/${input.branch}`],
+        });
+        await runContributionGit({
+            process: this.process,
+            dir: input.dir,
+            args: [
+                'fetch',
+                '--no-tags',
+                '--no-recurse-submodules',
+                'upstream',
+                `refs/heads/${input.branch}:refs/remotes/upstream/${input.branch}`,
+            ],
+            network: true,
+        });
+    }
+    async head(input) {
+        await this.assertCurrent(input);
+        const text = await runContributionGit({
+            process: this.process,
+            dir: input.dir,
+            args: ['ls-remote', '--heads', 'origin', `refs/heads/${input.branch}`],
+            network: true,
+        });
+        if (!text.trim())
+            return null;
+        const lines = text.trim().split('\n');
+        const [sha, ref] = lines[0].split('\t');
+        if (lines.length !== 1 || ref !== `refs/heads/${input.branch}` || !sha)
+            throw new DevkitError('parse', 'SOURCE_REMOTE_HEAD_INVALID', 'The remote did not return one exact branch identity', {
+                nextSteps: [
+                    `git -C ${input.dir} ls-remote --heads origin refs/heads/${input.branch}`,
+                    'Remove the duplicate or mismatched remote branch, then retry.',
+                ],
+            });
+        assertObjectId(sha);
+        return sha;
+    }
+    async push(input) {
+        assertObjectId(input.commit);
+        await this.assertCurrent(input);
+        await runContributionGit({
+            process: this.process,
+            dir: input.dir,
+            args: [
+                '-c',
+                'push.followTags=false',
+                'push',
+                '--porcelain',
+                '--no-follow-tags',
+                '--recurse-submodules=no',
+                'origin',
+                `${input.commit}:refs/heads/${input.branch}`,
+            ],
+            network: true,
+        });
+    }
+    async assertCurrent(input) {
+        if (!/^fx\/contribution\/[a-zA-Z0-9_-]+$/.test(input.branch) ||
+            input.branch === input.remote.targetBranch)
+            throw new DevkitError('usage', 'SOURCE_BRANCH_INVALID', 'Use a dedicated contribution branch', { nextSteps: ['fx source push --new'] });
+        const settings = await this.inspect(input);
+        if (settings.fingerprint !== input.remote.fingerprint ||
+            settings.pushUrls.length !== 1 ||
+            settings.pushUrls[0] !== input.remote.url ||
+            settings.hasRewrite ||
+            settings.isMirror ||
+            settings.receivePack !== null)
+            throw new DevkitError('conflict', 'SOURCE_REMOTE_CHANGED', 'Source remote routing changed after verification', {
+                nextSteps: [
+                    `git -C ${input.dir} remote -v`,
+                    'Restore the verified push routing, or re-run fx source push to plan again.',
+                ],
+            });
+    }
+}
+//# sourceMappingURL=contribution-transport.js.map

package/dist/adapters/git/contribution-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution-transport.js","sourceRoot":"","sources":["../../../src/adapters/git/contribution-transport.ts"],"names":[],"mappings":"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"}

package/dist/adapters/git/contribution-tree.js

@@ -0,0 +1,73 @@
+// Candidate tree identities are computed in memory with Git's object encoding.
+// Preview and unchanged detection therefore need no temporary index or objects.
+import { createHash } from 'node:crypto';
+import { DevkitError } from '../../domain/errors.js';
+export function computeContributionTree(input) {
+    const root = new Map();
+    const algorithm = input.objectLength === 64 ? 'sha256' : 'sha1';
+    for (const entry of input.entries)
+        put(root, entry.path.split('/'), entry);
+    for (const file of input.files.filter((file) => file.content === null))
+        put(root, file.path.split('/'), null);
+    for (const file of input.files.filter((file) => file.content !== null)) {
+        const bytes = Buffer.from(file.content, 'utf8');
+        put(root, file.path.split('/'), { mode: file.mode, oid: hashObject('blob', bytes, algorithm) });
+    }
+    return hashTree(root, algorithm);
+}
+function put(root, segments, value) {
+    const [name, ...rest] = segments;
+    if (!name)
+        throw new DevkitError('conflict', 'SOURCE_TREE_INVALID', 'The source tree has an invalid path', {
+            nextSteps: [
+                'Drop the malformed path from the selection and re-run fx source push --dry-run.',
+            ],
+        });
+    if (rest.length === 0) {
+        if (value === null)
+            root.delete(name);
+        else {
+            if (root.get(name) instanceof Map)
+                throw new DevkitError('conflict', 'SOURCE_TREE_CONFLICT', 'Select all descendants before replacing a directory', { nextSteps: [`Select every file under ${name} as well, then retry.`] });
+            root.set(name, value);
+        }
+        return;
+    }
+    const existing = root.get(name);
+    if (existing !== undefined && !(existing instanceof Map))
+        throw new DevkitError('conflict', 'SOURCE_TREE_CONFLICT', 'A candidate file conflicts with a parent file', {
+            nextSteps: [`Drop the paths nested under the file ${name} from the selection, then retry.`],
+        });
+    const child = existing ?? new Map();
+    put(child, rest, value);
+    if (child.size > 0)
+        root.set(name, child);
+    else
+        root.delete(name);
+}
+function hashTree(tree, algorithm) {
+    const entries = [...tree.entries()].sort(([a, av], [b, bv]) => Buffer.compare(Buffer.from(a + (av instanceof Map ? '/' : '')), Buffer.from(b + (bv instanceof Map ? '/' : ''))));
+    const parts = [];
+    for (const [name, value] of entries) {
+        const mode = value instanceof Map ? '40000' : value.mode;
+        const oid = value instanceof Map ? hashTree(value, algorithm) : value.oid;
+        parts.push(Buffer.from(`${mode} ${name}\0`), Buffer.from(oid, 'hex'));
+    }
+    return hashObject('tree', Buffer.concat(parts), algorithm);
+}
+function hashObject(kind, bytes, algorithm) {
+    return createHash(algorithm).update(`${kind} ${bytes.length}\0`).update(bytes).digest('hex');
+}
+export function parseContributionTree(text) {
+    return text
+        .split('\0')
+        .filter(Boolean)
+        .map((entry) => {
+        const tab = entry.indexOf('\t');
+        const [mode, , oid] = entry.slice(0, tab).split(' ');
+        if (tab < 0 || !mode || !oid)
+            throw new DevkitError('parse', 'SOURCE_TREE_INVALID', 'Git returned an invalid tree entry', { nextSteps: ['Check the source repository with git fsck, then re-run fx source push.'] });
+        return { path: entry.slice(tab + 1), mode, oid };
+    });
+}
+//# sourceMappingURL=contribution-tree.js.map

package/dist/adapters/git/contribution-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution-tree.js","sourceRoot":"","sources":["../../../src/adapters/git/contribution-tree.ts"],"names":[],"mappings":"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"}

package/dist/adapters/git/system-git.js

@@ -0,0 +1,170 @@
+// Git transport and checkout operations with structured failure recovery.
+import path from 'node:path';
+import { DevkitError } from '../../domain/errors.js';
+import { shellLine } from '../../domain/shell.js';
+import { parseAheadBehind, parsePorcelainStatus, parseRemotes, } from '../../domain/workspace/state.js';
+export class SystemGit {
+    process;
+    constructor(process) {
+        this.process = process;
+    }
+    async clone(request) {
+        const vector = [
+            'clone',
+            '--quiet',
+            '--origin',
+            'upstream',
+            '--branch',
+            request.branch,
+            request.upstream,
+            request.dir,
+        ];
+        const result = await this.git(vector);
+        if (result.code !== 0) {
+            throw new DevkitError(gitFailureCategory(result.stderr), 'GIT_CLONE_FAILED', `git clone ${request.upstream} failed: ${lastLine(result.stderr)}`, {
+                hint: gitFailureHint(result.stderr),
+                nextSteps: [
+                    shellLine(['git', 'ls-remote', '--heads', request.upstream, request.branch]),
+                    shellLine(['git', ...vector]),
+                ],
+            });
+        }
+        if (request.origin !== undefined)
+            await this.addRemote(request.dir, 'origin', request.origin);
+    }
+    async fetch(dir, remote) {
+        const result = await this.git(['-C', dir, 'fetch', '--quiet', '--prune', remote]);
+        if (result.code !== 0) {
+            throw new DevkitError(gitFailureCategory(result.stderr), 'GIT_FETCH_FAILED', `git fetch ${remote} in ${dir} failed: ${lastLine(result.stderr)}`, {
+                hint: 'The remote may be unreachable, or the remote name may be wrong.',
+                nextSteps: ['fx status', `git -C ${dir} remote -v`],
+            });
+        }
+    }
+    async fastForward(dir, remote, branch) {
+        const state = await this.status(dir);
+        const onBranch = state.branch === branch && !state.dirty;
+        const ref = onBranch ? 'HEAD' : branch;
+        const before = await this.revParse(dir, ref);
+        const result = onBranch
+            ? await this.git(['-C', dir, 'merge', '--ff-only', '--quiet', `${remote}/${branch}`])
+            : await this.git(['-C', dir, 'fetch', '--quiet', remote, `${branch}:${branch}`]);
+        if (result.code !== 0) {
+            if (/not possible to fast-forward|non-fast-forward/i.test(result.stderr))
+                return 'diverged';
+            throw new DevkitError(gitFailureCategory(result.stderr), 'GIT_FAST_FORWARD_FAILED', `Could not update ${branch}: ${lastLine(result.stderr)}`, {
+                hint: gitFailureHint(result.stderr),
+                nextSteps: [
+                    shellLine(['git', '-C', dir, 'status']),
+                    shellLine(['git', '-C', dir, 'ls-remote', '--heads', remote, branch]),
+                ],
+            });
+        }
+        const after = await this.revParse(dir, ref);
+        return before === after ? 'up_to_date' : 'updated';
+    }
+    async status(dir, compareTo) {
+        const result = await this.git([
+            '-C',
+            dir,
+            'status',
+            '--porcelain=v2',
+            '--branch',
+            '--untracked-files=all',
+        ]);
+        if (result.code !== 0) {
+            throw new DevkitError('conflict', 'NOT_A_CHECKOUT', `${dir} is not a git checkout: ${lastLine(result.stderr)}`, {
+                nextSteps: ['fx status'],
+            });
+        }
+        const state = parsePorcelainStatus(result.stdout);
+        if (compareTo === undefined)
+            return state;
+        const counted = await this.git([
+            '-C',
+            dir,
+            'rev-list',
+            '--left-right',
+            '--count',
+            `HEAD...${compareTo}`,
+        ]);
+        return counted.code === 0 ? { ...state, ...parseAheadBehind(counted.stdout) } : state;
+    }
+    async toplevel(dir) {
+        const result = await this.git(['-C', dir, 'rev-parse', '--show-toplevel']);
+        return result.code === 0 ? path.normalize(result.stdout.trim()) : undefined;
+    }
+    async remotes(dir, signal) {
+        const result = await this.git(['-C', dir, 'remote', '-v'], { signal });
+        return result.code === 0 ? parseRemotes(result.stdout) : {};
+    }
+    async remoteHead(dir, remote, signal) {
+        const ref = `refs/remotes/${remote}/HEAD`;
+        const result = await this.git(['-C', dir, 'symbolic-ref', '--short', ref], { signal });
+        if (result.code !== 0)
+            return undefined;
+        return result.stdout.trim().replace(new RegExp(`^${remote}/`), '') || undefined;
+    }
+    async addRemote(dir, name, url) {
+        const result = await this.git(['-C', dir, 'remote', 'add', name, url]);
+        if (result.code !== 0) {
+            throw new DevkitError('conflict', 'GIT_REMOTE_ADD_FAILED', `Could not add remote ${name} in ${dir}: ${lastLine(result.stderr)}`, {
+                nextSteps: [`git -C ${dir} remote -v`],
+            });
+        }
+    }
+    async askRemoteHead(dir, remote, timeoutMs, signal) {
+        const ask = (symref) => this.git(['-C', dir, 'ls-remote', '--quiet', ...(symref ? ['--symref'] : []), remote, 'HEAD'], { timeoutMs, signal });
+        // A git too old for --symref answers with usage (129); the branch is then unknown.
+        let result = await ask(true);
+        if (result.code === 129)
+            result = await ask(false);
+        const sha = /^([0-9a-f]{40,64})\tHEAD$/m.exec(result.stdout)?.[1];
+        if (result.code !== 0 || sha === undefined)
+            return undefined;
+        return { sha, branch: /^ref: refs\/heads\/(\S+)\tHEAD$/m.exec(result.stdout)?.[1] };
+    }
+    sha(dir, ref, signal) {
+        return this.revParse(dir, ref, signal);
+    }
+    async revParse(dir, ref, signal) {
+        const result = await this.git(['-C', dir, 'rev-parse', '--verify', '--quiet', ref], { signal });
+        return result.code === 0 ? result.stdout.trim() : undefined;
+    }
+    async git(args, options = {}) {
+        const result = await this.process.run(['git', ...args], {
+            ...options,
+            env: { ...options.env, LC_ALL: 'C' },
+        });
+        if (result.code === 127) {
+            throw new DevkitError('config', 'TOOL_MISSING', 'git is not installed or not on PATH', {
+                nextSteps: ['fx can git'],
+            });
+        }
+        return result;
+    }
+}
+function lastLine(text) {
+    const lines = text.trim().split('\n');
+    return lines[lines.length - 1] ?? '';
+}
+function gitFailureCategory(stderr) {
+    if (/remote branch .*not found|couldn't find remote ref|not something we can merge|repository .* does not exist/i.test(stderr))
+        return 'not_found';
+    if (/permission denied|authentication failed|could not read username|access denied/i.test(stderr))
+        return 'auth';
+    if (/could not resolve|unable to access|connection|timed out|network|could not read from remote/i.test(stderr))
+        return 'network';
+    return 'conflict';
+}
+function gitFailureHint(stderr) {
+    const category = gitFailureCategory(stderr);
+    if (category === 'not_found')
+        return 'Verify the configured branch still exists on the remote.';
+    if (category === 'auth')
+        return 'Verify Git transport credentials and repository access; API login is separate.';
+    if (category === 'network')
+        return 'Check Git transport connectivity and retry after it is restored.';
+    return 'Inspect Git diagnostics and local checkout state before retrying; no divergence was inferred.';
+}
+//# sourceMappingURL=system-git.js.map

package/dist/adapters/git/system-git.js.map

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

package/dist/adapters/github/gh.js

@@ -0,0 +1,103 @@
+// gh, the GitHub CLI, serves two providers: the github code host and GitHub Actions
+// ci. This is the one place that runs it. gh reports a failed request as an HTTP
+// status on stderr, so a failure is translated into the family's exit categories and
+// classified by the same `queryFailed` every companion's failures go through.
+import { stderrReason } from '../../domain/toolchain/stderr.js';
+import { EXIT, toolMissing } from '../family/cli.js';
+export const BINARY = 'gh';
+export const DEFAULT_HOSTNAME = 'github.com';
+// gh signs in per host, so the step is per host too: a binding names its host through
+// `hostname` (see `recipeVars`), the same host from both providers is planned once, and
+// two hosts are two steps. Only the active account of that host is checked, the one gh
+// will use.
+export const GH_RECIPES = [
+    {
+        id: 'login-{hostname}',
+        tool: BINARY,
+        perEnv: false,
+        kind: 'run',
+        phase: 'authenticate',
+        title: 'Log in to GitHub at {hostname}',
+        instructions: 'Signs gh in through the browser or with a token. fx reads repositories and Actions runs with that sign-in; private repositories need the repo scope gh asks for by default.',
+        run: ['auth', 'login', '--hostname', '{hostname}'],
+        verify: { command: ['auth', 'status', '--active', '--hostname', '{hostname}'] },
+    },
+];
+// gh's own [HOST/]OWNER/NAME. Left without a host, gh would pick one from GH_HOST or
+// its configuration, so a bare OWNER/NAME is spelled out as github.com's.
+export function qualifiedRepository(repository) {
+    const parts = repository.split('/');
+    if (parts.length > 2)
+        return { hostname: parts[0] ?? DEFAULT_HOSTNAME, repository };
+    return { hostname: DEFAULT_HOSTNAME, repository: `${DEFAULT_HOSTNAME}/${repository}` };
+}
+export class GhCli {
+    process;
+    constructor(process) {
+        this.process = process;
+    }
+    async call(args, options = {}) {
+        const result = await this.process.run([BINARY, ...args], {
+            timeoutMs: options.timeoutMs,
+            diagnostic: { phase: `${BINARY} ${args.slice(0, 2).join(' ')}`.trim() },
+        });
+        if (result.notStarted === true || result.code === EXIT.missing_binary)
+            throw toolMissing(BINARY);
+        if (result.code === 0)
+            return { code: 0, stdout: result.stdout, data: parse(result.stdout), error: undefined };
+        const status = httpStatus(result.stderr);
+        const message = stderrReason(result.stderr, result.code).replace(/^gh: /, '');
+        return {
+            code: exitOf(result.code, status, message),
+            stdout: result.stdout,
+            data: undefined,
+            error: { message, ...(status === undefined ? {} : { http_status: status }) },
+        };
+    }
+}
+// `--paginate --jq` prints one JSON value per line. A line that does not parse makes
+// the whole answer unreadable rather than shorter.
+export function jsonLines(text) {
+    const values = [];
+    for (const line of text.split('\n')) {
+        if (line.trim() === '')
+            continue;
+        const value = parse(line);
+        if (value === undefined)
+            return undefined;
+        values.push(value);
+    }
+    return values;
+}
+// `gh api` ends its message with "(HTTP 404)"; other commands open it with "HTTP 404:".
+function httpStatus(stderr) {
+    const match = /\(HTTP (\d{3})\)|^HTTP (\d{3}):/m.exec(stderr);
+    const status = match?.[1] ?? match?.[2];
+    return status === undefined ? undefined : Number(status);
+}
+// gh's own exit 4 means it holds no credential at all. Any other failure is a plain
+// failure: gh's remaining codes (cancelled, pending checks) would read as categories.
+function exitOf(code, status, message) {
+    if (code === 4 || status === 401)
+        return EXIT.auth;
+    if (status === 429 || (status === 403 && /rate limit/i.test(message)))
+        return EXIT.rate_limit;
+    if (status === 403)
+        return EXIT.permission;
+    if (status === 404)
+        return EXIT.not_found;
+    if (status !== undefined && status >= 500)
+        return EXIT.server;
+    if (/error connecting to/i.test(message))
+        return EXIT.network;
+    return 1;
+}
+function parse(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=gh.js.map