@angelmsger/fx 0.0.0-stage → 0.11.0

package/dist/adapters/code-host/bitbucket-cli/pull-request.js

@@ -0,0 +1,114 @@
+// PR creation preserves exact description bytes in a private temporary file.
+// Remote responses must identify the requested source and destination before use.
+import { promises as fs } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { scanBoundary } from '../../../domain/boundary/scan.js';
+import { DevkitError } from '../../../domain/errors.js';
+import { EXIT, objectOf, stringAt } from '../../family/cli.js';
+import { callContribution, contributionFailed } from './contribution-call.js';
+import { resolvePullRequestId } from './pull-request-reference.js';
+export async function readContributionPullRequest({ cli, input, }) {
+    const id = await resolvePullRequestId({ cli, input });
+    const call = await callContribution({
+        cli,
+        args: ['pr', 'get', `${input.repo.project}/${input.repo.name}/${id}`, '--scope', 'summary'],
+    });
+    if (call.code === EXIT.not_found)
+        return null;
+    if (call.code !== 0)
+        throw contributionFailed(call);
+    const result = decodePullRequest(call.data);
+    if (result.id !== id ||
+        result.target.repo.project !== input.repo.project ||
+        result.target.repo.name !== input.repo.name)
+        throw invalidResponse();
+    return result;
+}
+export async function createContributionPullRequest({ cli, input, }) {
+    if (scanBoundary({ text: `${input.title}\n${input.description}`, policy: 'manifest' }).length)
+        throw new DevkitError('usage', 'SOURCE_CONTENT_SENSITIVE', 'The PR text contains protected content', {
+            nextSteps: [
+                'Remove credentials, personal names and email addresses from --title and --message, then retry.',
+            ],
+        });
+    const directory = await fs.mkdtemp(path.join(tmpdir(), 'fx-contribution-pr-'));
+    const file = path.join(directory, 'description.md');
+    try {
+        await fs.writeFile(file, input.description, { mode: 0o600 });
+        const args = [
+            'pr',
+            'create',
+            '--repo',
+            `${input.target.repo.project}/${input.target.repo.name}`,
+            '--source-repo',
+            `${input.source.repo.project}/${input.source.repo.name}`,
+            '--source',
+            input.source.branch,
+            '--target',
+            input.target.branch,
+            '--title',
+            input.title,
+            '--description-file',
+            file,
+        ];
+        if (input.allowWrites)
+            args.push('--allow-writes');
+        const call = await callContribution({ cli, args });
+        if (call.code !== 0)
+            throw contributionFailed(call);
+        const result = decodePullRequest(call.data);
+        if (result.state !== 'open' ||
+            !sameBranch(result.source, input.source) ||
+            !sameBranch(result.target, input.target))
+            throw invalidResponse();
+        return result;
+    }
+    finally {
+        await fs.rm(directory, { recursive: true, force: true });
+    }
+}
+function decodePullRequest(value) {
+    const data = objectOf(value);
+    const id = data?.['id'];
+    const url = data && stringAt(data, 'url');
+    const state = data && stringAt(data, 'state')?.toLowerCase();
+    if (!data ||
+        typeof id !== 'number' ||
+        !Number.isSafeInteger(id) ||
+        id < 1 ||
+        !url ||
+        !/^https?:\/\//.test(url))
+        throw invalidResponse();
+    if (state !== 'open' && state !== 'merged' && state !== 'declined' && state !== 'superseded')
+        throw invalidResponse();
+    return {
+        id: String(id),
+        url,
+        state,
+        source: decodeBranch(data['source']),
+        target: decodeBranch(data['destination']),
+    };
+}
+function decodeBranch(value) {
+    const data = objectOf(value);
+    const branch = data && stringAt(data, 'branch');
+    const repository = data && stringAt(data, 'repository');
+    const segments = repository?.split('/');
+    if (!branch || !segments || segments.length !== 2 || !segments[0] || !segments[1])
+        throw invalidResponse();
+    return { branch, repo: { project: segments[0], name: segments[1] } };
+}
+function sameBranch(a, b) {
+    return a.branch === b.branch && a.repo.project === b.repo.project && a.repo.name === b.repo.name;
+}
+function invalidResponse() {
+    return new DevkitError('server', 'SOURCE_PR_RESPONSE_INVALID', 'The companion did not return the expected pull request identity', {
+        hint: 'Creation may have succeeded; inspect the remote before attempting another create.',
+        nextSteps: [
+            'Inspect the known PR in the code host.',
+            'Associate its verified ID with --pr instead of blindly retrying creation.',
+        ],
+    });
+}
+//# sourceMappingURL=pull-request.js.map

package/dist/adapters/code-host/bitbucket-cli/pull-request.js.map

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

package/dist/adapters/code-host/bitbucket-cli/recipes.js

@@ -0,0 +1,17 @@
+// The one step Bitbucket needs: an access token, with the scopes fx uses named
+// in the instructions and the page that issues one linked.
+export const BITBUCKET_RECIPES = [
+    {
+        id: 'credential',
+        tool: 'bitbucket-cli',
+        perEnv: false,
+        kind: 'run',
+        phase: 'authenticate',
+        title: 'Store a Bitbucket access token',
+        open: '{web}/plugins/servlet/access-tokens/manage',
+        instructions: 'Create an HTTP access token with Project read and Repository read (add Repository write to open pull requests), then paste it when asked. Run `bitbucket-cli config init` first if the server URL is not set yet.',
+        run: ['auth', 'login'],
+        verify: { command: ['auth', 'status'], json: { path: 'configured', equals: true } },
+    },
+];
+//# sourceMappingURL=recipes.js.map

package/dist/adapters/code-host/bitbucket-cli/recipes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.js","sourceRoot":"","sources":["../../../../src/adapters/code-host/bitbucket-cli/recipes.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,2DAA2D;AAI3D,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACvD;QACE,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,cAAc;QACrB,KAAK,EAAE,gCAAgC;QACvC,IAAI,EAAE,4CAA4C;QAClD,YAAY,EACV,mNAAmN;QACrN,GAAG,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;QACtB,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;KACpF;CACF,CAAC"}

package/dist/adapters/code-host/bitbucket-cli/repository-identity.js

@@ -0,0 +1,51 @@
+// Native normalized repository records supply clone identity and fork evidence.
+// Older companions omit parentage; that absence remains unknown to the caller.
+import { DevkitError } from '../../../domain/errors.js';
+import { objectOf, stringAt } from '../../family/cli.js';
+import { callContribution, contributionFailed } from './contribution-call.js';
+export async function readRepositoryIdentity({ cli, ref, branches, }) {
+    const call = await callContribution({ cli, args: ['repo', 'get', `${ref.project}/${ref.name}`] });
+    if (call.code !== 0)
+        throw contributionFailed(call);
+    const data = objectOf(call.data);
+    if (!data)
+        throw invalidIdentity();
+    const identity = decodeRepoRef(data);
+    if (identity.project.toLowerCase() !== ref.project.toLowerCase() || identity.name !== ref.name)
+        throw invalidIdentity();
+    const cloneUrls = [stringAt(data, 'clone_ssh'), stringAt(data, 'clone_https')].filter((url) => url !== undefined);
+    const defaultBranch = stringAt(data, 'default_branch') ??
+        stringAt(data, 'main_branch') ??
+        (await branches()).find((branch) => branch.default)?.name;
+    if (cloneUrls.length === 0 || !defaultBranch)
+        throw invalidIdentity();
+    const parent = decodeParent(data);
+    return {
+        ref: identity,
+        cloneUrls,
+        defaultBranch,
+        personalOwner: identity.project.startsWith('~') ? identity.project.slice(1) : null,
+        parent,
+    };
+}
+function decodeParent(data) {
+    if (!('parent' in data))
+        return undefined;
+    if (data['parent'] === null)
+        return null;
+    const parent = objectOf(data['parent']);
+    if (!parent)
+        throw invalidIdentity();
+    return decodeRepoRef(parent);
+}
+export function decodeRepoRef(data) {
+    const project = stringAt(data, 'workspace');
+    const name = stringAt(data, 'slug');
+    if (!project || !name)
+        throw invalidIdentity();
+    return { project, name };
+}
+function invalidIdentity() {
+    return new DevkitError('config', 'SOURCE_IDENTITY_UNVERIFIED', 'The companion did not return a complete matching repository identity', { nextSteps: ['fx doctor', 'Update the code-host companion and verify repository access.'] });
+}
+//# sourceMappingURL=repository-identity.js.map

package/dist/adapters/code-host/bitbucket-cli/repository-identity.js.map

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

package/dist/adapters/code-host/github/provider.js

@@ -0,0 +1,207 @@
+// GitHub as the code host, through gh. Branches, ranges, commits and files come from
+// the REST API by way of `gh api`, so gh holds the credential and fx never sees it.
+// Pull requests are not wired yet: contribution workflows report this host as
+// unsupported instead of half-working.
+import { DevkitError } from '../../../domain/errors.js';
+import { repoUrl } from '../../../domain/workspace/ref.js';
+import { EXIT, objectOf, queryFailed, stringAt, unreadableError } from '../../family/cli.js';
+import { BINARY, DEFAULT_HOSTNAME, GH_RECIPES, GhCli, jsonLines, } from '../../github/gh.js';
+const QUERY = { timeoutMs: 15_000 };
+// The fields of a commit the release check reads, so a commit's diff never crosses the pipe.
+const COMMIT = '{sha, author: .commit.author.name, date: .commit.committer.date, message: .commit.message, parents: [.parents[].sha]}';
+export class GitHubCodeHost {
+    vars;
+    supportsContributions = false;
+    gh;
+    constructor(deps, vars) {
+        this.vars = vars;
+        this.gh = new GhCli(deps.process);
+    }
+    async repositoryIdentity(_ref) {
+        throw contributionUnsupported();
+    }
+    async pullRequest(_input) {
+        throw contributionUnsupported();
+    }
+    async createPullRequest(_input) {
+        throw contributionUnsupported();
+    }
+    async whoami() {
+        const call = await this.api('user', ['--jq', '.login'], { timeoutMs: 5000 });
+        const user = call.stdout.trim();
+        if (call.code !== 0 || user === '')
+            throw queryFailed(BINARY, call, 'tell who is signed in');
+        return { user };
+    }
+    async canRead(ref) {
+        const call = await this.api(`repos/${slug(ref)}`, ['--jq', '.full_name'], { timeoutMs: 5000 });
+        if (call.code === 0)
+            return 'readable';
+        if (call.code === EXIT.permission)
+            return 'forbidden';
+        // GitHub answers 404 for a private repository the person cannot see, too.
+        if (call.code === EXIT.not_found)
+            return 'missing';
+        return 'unknown';
+    }
+    async fork(ref) {
+        const { user } = await this.whoami();
+        const url = this.forkUrl(user, ref);
+        const existing = await this.api(`repos/${user}/${ref.name}`, ['--jq', '{fork, parent: .parent.full_name, source: .source.full_name}'], QUERY);
+        if (existing.code === 0) {
+            // Being a fork does not say of which repository: only one forked from this
+            // upstream, or from a fork whose network starts at it, can carry its pull requests.
+            const found = objectOf(existing.data) ?? {};
+            const of = [stringAt(found, 'parent'), stringAt(found, 'source')];
+            if (of.some((name) => name?.toLowerCase() === slug(ref).toLowerCase()))
+                return { url, created: false };
+            // A repository of that name that is not this fork would make gh pick another name.
+            throw forkFailed(ref, found['fork'] === true
+                ? `${user}/${ref.name} is a fork of ${of[0] ?? 'another repository'}`
+                : `${user}/${ref.name} exists and is not a fork`);
+        }
+        const call = await this.gh.call(['repo', 'fork', `${this.hostname}/${slug(ref)}`, '--clone=false', '--remote=false'], QUERY);
+        if (call.code !== 0)
+            throw forkFailed(ref, call.error?.message ?? `exit ${call.code}`);
+        return { url, created: true };
+    }
+    async branches(ref) {
+        const [list, repo] = await Promise.all([
+            this.api(`repos/${slug(ref)}/branches?per_page=100`, [
+                '--paginate',
+                '--jq',
+                '.[] | {name, sha: .commit.sha}',
+            ]),
+            this.api(`repos/${slug(ref)}`, ['--jq', '.default_branch']),
+        ]);
+        if (list.code !== 0)
+            throw queryFailed(BINARY, list, `list the branches of ${slug(ref)}`);
+        if (repo.code !== 0)
+            throw queryFailed(BINARY, repo, `read the default branch of ${slug(ref)}`);
+        const defaultBranch = repo.stdout.trim();
+        return records(list, `the branches of ${slug(ref)}`).map((item) => {
+            const name = stringAt(item, 'name');
+            const sha = stringAt(item, 'sha');
+            if (name === undefined || sha === undefined)
+                throw unreadableError(BINARY, `a branch of ${slug(ref)}`);
+            return { name, sha, default: name === defaultBranch };
+        });
+    }
+    // Every page, checked against the total GitHub states: a list shorter than the range
+    // would read as branches that agree.
+    async compare(ref, range) {
+        const what = `${range.from}..${range.to} of ${slug(ref)}`;
+        const call = await this.api(`repos/${slug(ref)}/compare/${refPath(range.from)}...${refPath(range.to)}?per_page=100`, ['--paginate', '--jq', `{total: .total_commits, commits: [.commits[] | ${COMMIT}]}`]);
+        if (call.code !== 0)
+            throw queryFailed(BINARY, call, `compare ${what}`);
+        const pages = records(call, what);
+        const commits = pages.flatMap((page) => Array.isArray(page['commits']) ? page['commits'].map(objectOf) : [undefined]);
+        const total = pages[0]?.['total'];
+        if (typeof total !== 'number' || commits.length !== total)
+            throw unreadableError(BINARY, `an incomplete list of the commits in ${what}`);
+        return commits.map((item) => {
+            const commit = item === undefined ? undefined : commitOf(item);
+            if (commit === undefined)
+                throw unreadableError(BINARY, `a commit of ${what}`);
+            return commit;
+        });
+    }
+    async commit(ref, sha) {
+        const call = await this.api(`repos/${slug(ref)}/commits/${refPath(sha)}`, ['--jq', COMMIT]);
+        const commit = call.code === 0 ? commitOf(objectOf(call.data) ?? {}) : undefined;
+        if (commit === undefined)
+            throw queryFailed(BINARY, call, `read commit ${sha} of ${slug(ref)}`);
+        return commit;
+    }
+    async readFile(ref, path, at) {
+        const call = await this.api(`repos/${slug(ref)}/contents/${refPath(path)}?ref=${encodeURIComponent(at)}`, ['-H', 'Accept: application/vnd.github.raw']);
+        if (call.code === 0)
+            return call.stdout;
+        if (call.code === EXIT.not_found)
+            return undefined;
+        throw queryFailed(BINARY, call, `read ${path} at ${at} of ${slug(ref)}`);
+    }
+    upstreamUrl(ref) {
+        return repoUrl(this.host, ref.project, ref.name);
+    }
+    forkUrl(user, ref) {
+        return repoUrl(this.host, user, ref.name);
+    }
+    webUrl(ref) {
+        return `https://${this.hostname}/${slug(ref)}`;
+    }
+    // gh signs in per host and would otherwise pick one from GH_HOST or its configuration,
+    // so every call names the host the binding names, github.com included.
+    api(path, args, options = QUERY) {
+        return this.gh.call(['api', '--hostname', this.hostname, ...args, path], options);
+    }
+    get host() {
+        return this.vars['host'] ?? '';
+    }
+    get hostname() {
+        return hostnameOf(this.host);
+    }
+}
+export const githubProvider = {
+    id: 'github',
+    capability: 'code-host',
+    tools: [BINARY],
+    recipes: GH_RECIPES,
+    vars: [
+        {
+            name: 'host',
+            desc: 'git clone prefix, e.g. https://github.com, or an ssh:// prefix for SSH clones',
+            required: true,
+        },
+    ],
+    recipeVars: (vars) => ({ hostname: hostnameOf(vars['host'] ?? '') }),
+    create: (deps, vars) => new GitHubCodeHost(deps, vars),
+};
+// An https:// or an ssh:// clone prefix names its host; anything else means github.com.
+function hostnameOf(host) {
+    try {
+        return new URL(host).hostname || DEFAULT_HOSTNAME;
+    }
+    catch {
+        return DEFAULT_HOSTNAME;
+    }
+}
+function records(call, what) {
+    const rows = jsonLines(call.stdout)?.map(objectOf);
+    if (rows === undefined || rows.some((row) => row === undefined))
+        throw unreadableError(BINARY, what);
+    return rows;
+}
+function slug(ref) {
+    return `${ref.project}/${ref.name}`;
+}
+// A branch or path keeps its slashes; anything else that means something in a URL is escaped.
+function refPath(value) {
+    return value.split('/').map(encodeURIComponent).join('/');
+}
+function commitOf(item) {
+    const sha = stringAt(item, 'sha');
+    const date = stringAt(item, 'date');
+    if (sha === undefined || date === undefined)
+        return undefined;
+    const parents = Array.isArray(item['parents'])
+        ? item['parents'].filter((p) => typeof p === 'string')
+        : [];
+    return {
+        sha,
+        author: stringAt(item, 'author') ?? '',
+        date,
+        message: stringAt(item, 'message') ?? '',
+        parents,
+    };
+}
+function forkFailed(ref, reason) {
+    return new DevkitError('permission', 'FORK_FAILED', `${BINARY} could not fork ${slug(ref)}: ${reason}`, {
+        hint: 'Forking needs read access to the repository and a free name in your account.',
+        nextSteps: [`${BINARY} repo view ${slug(ref)}`, 'fx repo list --unreadable'],
+    });
+}
+function contributionUnsupported() {
+    return new DevkitError('config', 'SOURCE_CONTRIBUTION_UNSUPPORTED', 'The github code host does not open pull requests through fx yet', { nextSteps: ['Open the pull request with gh pr create.'] });
+}
+//# sourceMappingURL=provider.js.map

package/dist/adapters/code-host/github/provider.js.map

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

package/dist/adapters/code-host/local-git/import.js

@@ -0,0 +1,30 @@
+// Recognize the local-git provider only from its supported layout and a verified bare repository.
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+export async function identifyLocalGitRemote(process, upstream) {
+    let directory = upstream;
+    if (upstream.startsWith('file://')) {
+        try {
+            directory = fileURLToPath(upstream);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    if (!path.isAbsolute(directory) || !directory.endsWith('.git'))
+        return undefined;
+    const project = path.dirname(directory);
+    if (path.basename(project).length === 0)
+        return undefined;
+    const result = await process.run([
+        'git',
+        '--git-dir',
+        directory,
+        'rev-parse',
+        '--is-bare-repository',
+    ]);
+    if (result.code !== 0 || result.stdout.trim() !== 'true')
+        return undefined;
+    return { provider: 'local-git', host: path.dirname(project) };
+}
+//# sourceMappingURL=import.js.map

package/dist/adapters/code-host/local-git/import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.js","sourceRoot":"","sources":["../../../../src/adapters/code-host/local-git/import.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAElG,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAKzC,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAgB,EAChB,QAAgB;IAEhB,IAAI,SAAS,GAAG,QAAQ,CAAC;IACzB,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IACjF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACxC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1D,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC/B,KAAK;QACL,WAAW;QACX,SAAS;QACT,WAAW;QACX,sBAAsB;KACvB,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC;IAC3E,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;AAChE,CAAC"}

package/dist/adapters/code-host/local-git/provider.js

@@ -0,0 +1,176 @@
+// A code host that is a directory of bare repositories: `host/PROJECT/name.git`
+// upstream, `host/~user/name.git` forks, so a workspace can be exercised end to end
+// without a server. Queries run git against the bare repository itself, never a checkout.
+import path from 'node:path';
+import { DevkitError } from '../../../domain/errors.js';
+import { refFromUrl, repoUrl } from '../../../domain/workspace/ref.js';
+// One line per commit: sha, author, ISO committer date, parents, subject.
+const COMMIT_FORMAT = '--format=%H%x00%an%x00%cI%x00%P%x00%s';
+const MISSING_PATH = /does not exist|exists on disk, but not in|invalid object name/i;
+export class LocalGitCodeHost {
+    deps;
+    vars;
+    supportsContributions = false;
+    constructor(deps, vars) {
+        this.deps = deps;
+        this.vars = vars;
+    }
+    async repositoryIdentity(ref) {
+        const branches = await this.branches(ref);
+        const defaultBranch = branches.find((branch) => branch.default)?.name;
+        if (!defaultBranch)
+            throw contributionUnsupported();
+        const origin = await this.git(ref, ['config', '--get', 'remote.origin.url']);
+        if (origin.code !== 0 && origin.code !== 1)
+            throw failed(ref, 'read fork identity', origin);
+        return {
+            ref,
+            cloneUrls: [this.upstreamUrl(ref)],
+            defaultBranch,
+            personalOwner: ref.project.startsWith('~') ? ref.project.slice(1) : null,
+            parent: origin.code === 1 ? null : refFromUrl(origin.stdout.trim()),
+        };
+    }
+    async pullRequest(_input) {
+        throw contributionUnsupported();
+    }
+    async createPullRequest(_input) {
+        throw contributionUnsupported();
+    }
+    async whoami() {
+        return { user: this.vars['user'] ?? 'me' };
+    }
+    async canRead(ref) {
+        return (await this.deps.fs.exists(this.upstreamUrl(ref))) ? 'readable' : 'missing';
+    }
+    async fork(ref) {
+        const { user } = await this.whoami();
+        const url = this.forkUrl(user, ref);
+        if (await this.deps.fs.exists(url))
+            return { url, created: false };
+        const result = await this.deps.process.run([
+            'git',
+            'clone',
+            '--quiet',
+            '--bare',
+            this.upstreamUrl(ref),
+            url,
+        ]);
+        if (result.code !== 0) {
+            throw new DevkitError('permission', 'FORK_FAILED', `Could not fork ${ref.project}/${ref.name}: ${result.stderr.trim()}`, {
+                nextSteps: [`ls ${path.dirname(url)}`],
+            });
+        }
+        return { url, created: true };
+    }
+    async branches(ref) {
+        const head = await this.git(ref, ['symbolic-ref', '--short', 'HEAD']);
+        const refs = await this.git(ref, [
+            'for-each-ref',
+            '--format=%(refname:short)%00%(objectname)',
+            'refs/heads',
+        ]);
+        if (refs.code !== 0)
+            throw failed(ref, 'list branches', refs);
+        const defaultBranch = head.code === 0 ? head.stdout.trim() : undefined;
+        return lines(refs.stdout).map((line) => {
+            const [name, sha] = line.split('\0');
+            if (name === undefined || sha === undefined || sha === '')
+                throw unreadableError(ref, 'a branch', line);
+            return { name, sha, default: name === defaultBranch };
+        });
+    }
+    async compare(ref, range) {
+        const result = await this.git(ref, ['rev-list', COMMIT_FORMAT, range.to, `^${range.from}`]);
+        if (result.code !== 0)
+            throw failed(ref, `compare ${range.from}..${range.to}`, result);
+        return commitsOf(ref, result.stdout);
+    }
+    async commit(ref, sha) {
+        const result = await this.git(ref, ['rev-list', '-1', COMMIT_FORMAT, sha]);
+        const [commit] = result.code === 0 ? commitsOf(ref, result.stdout) : [];
+        if (commit === undefined)
+            throw failed(ref, `read commit ${sha}`, result);
+        return commit;
+    }
+    async readFile(ref, file, at) {
+        const result = await this.git(ref, ['show', `${at}:${file}`]);
+        if (result.code === 0)
+            return result.stdout;
+        if (MISSING_PATH.test(result.stderr))
+            return undefined;
+        throw failed(ref, `read ${file} at ${at}`, result);
+    }
+    upstreamUrl(ref) {
+        return repoUrl(this.host, ref.project, ref.name);
+    }
+    forkUrl(user, ref) {
+        return repoUrl(this.host, `~${user}`, ref.name);
+    }
+    webUrl(ref) {
+        return this.upstreamUrl(ref);
+    }
+    git(ref, args) {
+        return this.deps.process.run(['git', '--git-dir', this.upstreamUrl(ref), ...args]);
+    }
+    get host() {
+        return this.vars['host'] ?? '';
+    }
+}
+export const localGitProvider = {
+    id: 'local-git',
+    capability: 'code-host',
+    tools: [],
+    recipes: [],
+    vars: [
+        {
+            name: 'host',
+            desc: 'directory holding <project>/<name>.git bare repositories',
+            required: true,
+        },
+        {
+            name: 'user',
+            desc: 'name of the personal namespace (~user); defaults to "me"',
+            required: false,
+        },
+    ],
+    create: (deps, vars) => new LocalGitCodeHost(deps, vars),
+};
+function failed(ref, what, result) {
+    return new DevkitError('server', 'PLATFORM_QUERY_FAILED', `git could not ${what} in ${ref.project}/${ref.name}: ${result.stderr.trim() || `exit ${result.code}`}`, { nextSteps: ['fx repo list --unreadable'] });
+}
+function lines(text) {
+    return text.split('\n').filter((line) => line !== '');
+}
+// rev-list prints a `commit <sha>` header before each formatted line; the
+// formatted line is the one carrying the format's separators, whatever the
+// repository's hash length. A line that is neither is not skipped: a row
+// nobody can read would shorten a comparison into "the branches agree".
+function commitsOf(ref, text) {
+    return lines(text).flatMap((line) => {
+        if (!line.includes('\0')) {
+            if (line.startsWith('commit '))
+                return [];
+            throw unreadableError(ref, 'a commit', line);
+        }
+        const [sha, author, date, parents, message] = line.split('\0');
+        if (sha === undefined || sha === '' || date === undefined)
+            throw unreadableError(ref, 'a commit', line);
+        return [
+            {
+                sha,
+                author: author ?? '',
+                date,
+                message: message ?? '',
+                parents: (parents ?? '').split(' ').filter((p) => p !== ''),
+            },
+        ];
+    });
+}
+function unreadableError(ref, what, line) {
+    return new DevkitError('server', 'PLATFORM_QUERY_FAILED', `git answered with ${what} fx could not read in ${ref.project}/${ref.name}: ${line.slice(0, 80)}`, { nextSteps: ['fx repo list --unreadable'] });
+}
+function contributionUnsupported() {
+    return new DevkitError('config', 'SOURCE_CONTRIBUTION_UNSUPPORTED', 'This local code host has no pull-request service', { nextSteps: ['Select a code-host provider with pull-request support.'] });
+}
+//# sourceMappingURL=provider.js.map