@bluewombat/manager-github 0.1.0

package/dist/github/client.d.ts

@@ -0,0 +1,63 @@
+/**
+ * The one effect this package has on the outside world: HTTPS requests to the
+ * GitHub REST API, authenticated by a token.
+ *
+ * The transport is `@octokit/core` with its retry and throttling plugins — not
+ * a hand-written HTTP client. What lives here is only what this package owes on
+ * top of it: a token in one place, the wait budget of one invocation, and the
+ * mapping from a failure to this package's own vocabulary.
+ */
+import { Octokit } from "@octokit/core";
+declare const GithubOctokit: typeof Octokit & import("@octokit/core/types").Constructor<import("@octokit/plugin-retry").RetryPlugin>;
+/** The authenticated channel. Injected, so a run is testable with no network. */
+export type GithubClient = InstanceType<typeof GithubOctokit>;
+/** Identifies the caller to GitHub; the API rejects a request without one. */
+export declare const USER_AGENT = "bluewombat-manager-github";
+export type ClientOptions = {
+    /** The token lives here and nowhere else: not in an Invocation, not in a line. */
+    token: string;
+    apiBase: string;
+    /** Extra attempts after the first, on a transport failure, a 5xx, or a rate limit. */
+    requestRetries: number;
+    /** Absolute time no wait may run past. */
+    deadlineMs: number;
+    now?: () => number;
+    shouldInterrupt?: () => boolean;
+    /** Replaces the network in tests. */
+    fetch?: typeof globalThis.fetch;
+    /**
+     * Space writes out the way GitHub asks, and wait out a rate limit. On by
+     * default. Turning it off is a test seam: it also gives up the waiting, so a
+     * real run must leave it alone.
+     */
+    throttle?: boolean;
+};
+/**
+ * Build the channel. Retrying a 5xx and honouring a rate limit are the
+ * plugins'; deciding that a wait would outlive this invocation is ours, because
+ * only this package knows what the duration budget promised.
+ */
+export declare function createClient(options: ClientOptions): GithubClient;
+export declare function trimBase(apiBase: string): string;
+export type Failure = {
+    /** A refusal that will not change on a retry: a 404 does not become a 200. */
+    permanent: boolean;
+    status?: number;
+    detail: string;
+};
+/**
+ * Read what went wrong. Anything that reached here already exhausted the
+ * plugins' retries, so the question left is only whether retrying *later*
+ * could help.
+ */
+export declare function readFailure(error: unknown): Failure;
+export type Call = {
+    /** Aborts on the duration clock, and on a stop signal. */
+    signal: AbortSignal;
+    /** Always call it: the interrupt poll would otherwise hold the process open. */
+    release: () => void;
+};
+/** The bound every single request runs under. */
+export declare function callSignal(deadlineMs: number, now: () => number, shouldInterrupt: () => boolean): Call;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/github/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/github/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAIxC,QAAA,MAAM,aAAa,yGAAoC,CAAC;AAExD,iFAAiF;AACjF,MAAM,MAAM,YAAY,GAAG,YAAY,CAAC,OAAO,aAAa,CAAC,CAAC;AAE9D,8EAA8E;AAC9E,eAAO,MAAM,UAAU,8BAA8B,CAAC;AAEtD,MAAM,MAAM,aAAa,GAAG;IAC1B,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,cAAc,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC;IAChC,qCAAqC;IACrC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CAwBjE;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,MAAM,MAAM,OAAO,GAAG;IACpB,8EAA8E;IAC9E,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAcnD;AAsBD,MAAM,MAAM,IAAI,GAAG;IACjB,0DAA0D;IAC1D,MAAM,EAAE,WAAW,CAAC;IACpB,gFAAgF;IAChF,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF,iDAAiD;AACjD,wBAAgB,UAAU,CACxB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,MAAM,EACjB,eAAe,EAAE,MAAM,OAAO,GAC7B,IAAI,CAYN"}

package/dist/github/client.js

@@ -0,0 +1,96 @@
+/**
+ * The one effect this package has on the outside world: HTTPS requests to the
+ * GitHub REST API, authenticated by a token.
+ *
+ * The transport is `@octokit/core` with its retry and throttling plugins — not
+ * a hand-written HTTP client. What lives here is only what this package owes on
+ * top of it: a token in one place, the wait budget of one invocation, and the
+ * mapping from a failure to this package's own vocabulary.
+ */
+import { Octokit } from "@octokit/core";
+import { retry } from "@octokit/plugin-retry";
+import { throttling } from "@octokit/plugin-throttling";
+const GithubOctokit = Octokit.plugin(retry, throttling);
+/** Identifies the caller to GitHub; the API rejects a request without one. */
+export const USER_AGENT = "bluewombat-manager-github";
+/**
+ * Build the channel. Retrying a 5xx and honouring a rate limit are the
+ * plugins'; deciding that a wait would outlive this invocation is ours, because
+ * only this package knows what the duration budget promised.
+ */
+export function createClient(options) {
+    const now = options.now ?? (() => Date.now());
+    const shouldInterrupt = options.shouldInterrupt ?? (() => false);
+    const mayWait = (retryAfterSeconds, retryCount) => {
+        if (shouldInterrupt() || retryCount >= options.requestRetries) {
+            return false;
+        }
+        return now() + retryAfterSeconds * 1_000 < options.deadlineMs;
+    };
+    return new GithubOctokit({
+        auth: options.token,
+        baseUrl: trimBase(options.apiBase),
+        userAgent: USER_AGENT,
+        retry: { retries: options.requestRetries },
+        throttle: {
+            enabled: options.throttle ?? true,
+            onRateLimit: (retryAfter, _options, _octokit, retryCount) => mayWait(retryAfter, retryCount),
+            onSecondaryRateLimit: (retryAfter, _options, _octokit, retryCount) => mayWait(retryAfter, retryCount),
+        },
+        ...(options.fetch !== undefined ? { request: { fetch: options.fetch } } : {}),
+    });
+}
+export function trimBase(apiBase) {
+    return apiBase.replace(/\/+$/, "");
+}
+const DETAIL_LIMIT = 512;
+/**
+ * Read what went wrong. Anything that reached here already exhausted the
+ * plugins' retries, so the question left is only whether retrying *later*
+ * could help.
+ */
+export function readFailure(error) {
+    const status = statusOf(error);
+    const detail = truncate(messageOf(error));
+    if (status === undefined) {
+        return { permanent: false, detail };
+    }
+    if (status === 429 || (status === 403 && rateLimitSpent(error))) {
+        return { permanent: false, status, detail: `Rate limited (${status}). ${detail}`.trim() };
+    }
+    if (status >= 500) {
+        return { permanent: false, status, detail };
+    }
+    return { permanent: true, status, detail };
+}
+/** A 403 with the budget spent is a wait the invocation declined, not a refusal. */
+function rateLimitSpent(error) {
+    const headers = error?.response
+        ?.headers;
+    return headers?.["x-ratelimit-remaining"] === "0";
+}
+function statusOf(error) {
+    const status = error?.status;
+    return typeof status === "number" ? status : undefined;
+}
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function truncate(text) {
+    return text.length <= DETAIL_LIMIT ? text : `${text.slice(0, DETAIL_LIMIT)}…[truncated]`;
+}
+/** The bound every single request runs under. */
+export function callSignal(deadlineMs, now, shouldInterrupt) {
+    const controller = new AbortController();
+    const poll = setInterval(() => {
+        if (shouldInterrupt()) {
+            controller.abort();
+        }
+    }, 20);
+    const signal = AbortSignal.any([
+        controller.signal,
+        AbortSignal.timeout(Math.max(1, deadlineMs - now())),
+    ]);
+    return { signal, release: () => clearInterval(poll) };
+}
+//# sourceMappingURL=client.js.map

package/dist/github/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+import { type CreateManagerResult, type Finding, type ManagerContext, type ManagerQuestion, type ManagerScaffold, type SetupResult } from "@bluewombat/manager-kit";
+export { issueNumberFromExternalId, issueNumberFromPayload } from "./issue-number.js";
+export { payloadHasLabel } from "./labels.js";
+export type { GithubManagerOptions } from "./manager.js";
+export { createGithubManager, DEFAULT_API_BASE, DEFAULT_PRIORITY, DEFAULT_READY_LABEL, DEFAULT_TOKEN_ENV, } from "./manager.js";
+export { parseRepo, type Repository } from "./repo.js";
+export { type SetupSettings, wantedLabels } from "./setup.js";
+/** What `mason init` asks when it runs at a terminal. */
+export declare function questionsManager(): ManagerQuestion[];
+/**
+ * `mason setup`. The only entry point of this package that writes to GitHub
+ * before a run: it creates the labels the configuration names, once `apply` is
+ * asked for.
+ */
+export declare function setupManager(context: ManagerContext, input: {
+    apply: boolean;
+}): Promise<SetupResult>;
+export declare const DEFAULT_BRANCH = "main";
+export declare const DEFAULT_GIT_HOST = "github.com";
+/**
+ * `manager: "@bluewombat/manager-github"` in the config resolves here. The token
+ * is read from the environment by this package: Host never handles a secret.
+ */
+export declare function createManager(context: ManagerContext): CreateManagerResult;
+/**
+ * What `mason init` writes. Labels are not created here: that would need the
+ * network, and a missing label is a repository fact the operator still owns.
+ */
+export declare function scaffoldManager(context: ManagerContext): ManagerScaffold;
+/** What `mason doctor` reports. Options and environment only, no network. */
+export declare function checkManager(context: ManagerContext): Finding[];
+/** `Name <email>`, the form `git log` prints. */
+export declare function parseAuthor(text: string): {
+    ok: true;
+    value: {
+        name: string;
+        email: string;
+    };
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Where the reference work line is: the repository's own git remote, and the
+ * branch pull requests are opened onto. Host keeps a copy of it; these are the
+ * words `@bluewombat/isolation-git` reads.
+ *
+ * Over HTTPS by default, authenticated with the same token as the API —
+ * `credentialEnv` names the variable, and the strategy reads it when git asks,
+ * so nothing lands in a `.git/config` on disk and the pushes are the token's
+ * account, not the machine's SSH key. `remote` overrides the URL (SSH, a
+ * mirror, GitHub Enterprise). `author` is who the system is on its commits.
+ */
+export declare function referenceManager(context: ManagerContext): Record<string, unknown> | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,OAAO,EAEZ,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,EAGpB,KAAK,WAAW,EAGjB,MAAM,yBAAyB,CAAC;AAWjC,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,KAAK,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE9D,yDAAyD;AACzD,wBAAgB,gBAAgB,IAAI,eAAe,EAAE,CA4BpD;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GACxB,OAAO,CAAC,WAAW,CAAC,CA0CtB;AAmBD,eAAO,MAAM,cAAc,SAAS,CAAC;AACrC,eAAO,MAAM,gBAAgB,eAAe,CAAC;AAuB7C;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,mBAAmB,CA0C1E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,eAAe,CA0BxE;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,EAAE,CAwD/D;AA+FD,iDAAiD;AACjD,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,GACX;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAStF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAY7F"}

package/dist/index.js

@@ -0,0 +1,357 @@
+import { booleanOption, intOption, PRODUCT, rejectUnknownOptions, stringArrayOption, stringOption, } from "@bluewombat/manager-kit";
+import { createGithubManager, DEFAULT_API_BASE, DEFAULT_READY_LABEL, DEFAULT_TOKEN_ENV, } from "./manager.js";
+import { parseRepo } from "./repo.js";
+import { runSetup } from "./setup.js";
+export { issueNumberFromExternalId, issueNumberFromPayload } from "./issue-number.js";
+export { payloadHasLabel } from "./labels.js";
+export { createGithubManager, DEFAULT_API_BASE, DEFAULT_PRIORITY, DEFAULT_READY_LABEL, DEFAULT_TOKEN_ENV, } from "./manager.js";
+export { parseRepo } from "./repo.js";
+export { wantedLabels } from "./setup.js";
+/** What `mason init` asks when it runs at a terminal. */
+export function questionsManager() {
+    return [
+        {
+            key: "repo",
+            prompt: "GitHub repository (owner/name)",
+            required: true,
+            parse: (answer) => parseRepo(answer) === null
+                ? { ok: false, reason: `"${answer}" is not owner/name.` }
+                : { ok: true, value: answer },
+        },
+        {
+            key: "labels",
+            prompt: "Label an issue must carry to be picked up",
+            fallback: PRODUCT,
+            parse: (answer) => ({ ok: true, value: [answer] }),
+        },
+        {
+            key: "defaultProject",
+            prompt: "Project name for issues with no project: label",
+            fallback: "app",
+        },
+        {
+            key: "tokenEnv",
+            prompt: "Environment variable holding the token",
+            fallback: DEFAULT_TOKEN_ENV,
+        },
+    ];
+}
+/**
+ * `mason setup`. The only entry point of this package that writes to GitHub
+ * before a run: it creates the labels the configuration names, once `apply` is
+ * asked for.
+ */
+export async function setupManager(context, input) {
+    const read = readOptions(context);
+    if (!read.ok) {
+        return {
+            ok: false,
+            steps: [
+                { id: "options", summary: "read managerOptions", state: "blocked", detail: read.reason },
+            ],
+        };
+    }
+    const settings = read.settings;
+    const token = settings.token ?? context.env[settings.tokenEnv];
+    if (token === undefined || token.trim().length === 0) {
+        return {
+            ok: false,
+            steps: [
+                {
+                    id: "token",
+                    summary: "a token to talk to GitHub",
+                    state: "blocked",
+                    detail: `${settings.tokenEnv} is not set.`,
+                },
+            ],
+        };
+    }
+    return await runSetup({
+        repo: settings.repo,
+        token,
+        apiBase: settings.apiBase,
+        readyLabel: settings.readyLabel,
+        labels: settings.labels,
+        defaultProject: settings.defaultProject,
+        stateLabelPrefix: settings.stateLabelPrefix,
+        branch: settings.branch,
+        branchConfigured: typeof context.options.branch === "string",
+        durationMs: context.durationMs,
+        interruptFlag: context.interruptFlag,
+        githubFetch: settings.githubFetch,
+    }, input);
+}
+const KNOWN_OPTIONS = [
+    "repo",
+    "token",
+    "tokenEnv",
+    "apiBase",
+    "labels",
+    "defaultProject",
+    "readyLabel",
+    "defaultPriority",
+    "stateLabelPrefix",
+    "branch",
+    "remote",
+    "commitAuthor",
+    "keepBranch",
+    "fetch",
+];
+export const DEFAULT_BRANCH = "main";
+export const DEFAULT_GIT_HOST = "github.com";
+/**
+ * `manager: "@bluewombat/manager-github"` in the config resolves here. The token
+ * is read from the environment by this package: Host never handles a secret.
+ */
+export function createManager(context) {
+    const read = readOptions(context);
+    if (!read.ok) {
+        return read;
+    }
+    const settings = read.settings;
+    const token = settings.token ?? context.env[settings.tokenEnv];
+    if (token === undefined || token.trim().length === 0) {
+        return {
+            ok: false,
+            reason: `GitHub needs a token in ${settings.tokenEnv}. ` +
+                'Set the variable, or name another one with managerOptions "tokenEnv".',
+        };
+    }
+    const options = {
+        repo: settings.repo,
+        token,
+        durationMs: context.durationMs,
+        interruptFlag: context.interruptFlag,
+        apiBase: settings.apiBase,
+        readyLabel: settings.readyLabel,
+    };
+    if (settings.labels !== undefined) {
+        options.labels = settings.labels;
+    }
+    if (settings.defaultProject !== undefined) {
+        options.defaultProject = settings.defaultProject;
+    }
+    if (settings.defaultPriority !== undefined) {
+        options.defaultPriority = settings.defaultPriority;
+    }
+    if (settings.stateLabelPrefix !== undefined) {
+        options.stateLabelPrefix = settings.stateLabelPrefix;
+    }
+    if (settings.keepBranch !== undefined) {
+        options.keepBranch = settings.keepBranch;
+    }
+    if (settings.githubFetch !== undefined) {
+        options.githubFetch = settings.githubFetch;
+    }
+    return { ok: true, manager: createGithubManager(options) };
+}
+/**
+ * What `mason init` writes. Labels are not created here: that would need the
+ * network, and a missing label is a repository fact the operator still owns.
+ */
+export function scaffoldManager(context) {
+    const repo = typeof context.options.repo === "string" ? context.options.repo : "OWNER/REPO";
+    // The variable the operator just named, not the default: `init` calls this
+    // again with the answers in hand so its next steps do not demand something
+    // else than what was typed.
+    const tokenEnv = typeof context.options.tokenEnv === "string" && context.options.tokenEnv.length > 0
+        ? context.options.tokenEnv
+        : DEFAULT_TOKEN_ENV;
+    // `mason setup` creates the labels, so nothing here asks for that by hand.
+    const nextSteps = [`${tokenEnv} — a token with the repo scope, exported in this shell`];
+    if (repo === "OWNER/REPO") {
+        nextSteps.unshift("managerOptions.repo — set it to owner/name (or pass --manager-option repo=owner/name)");
+    }
+    return {
+        options: {
+            repo,
+            tokenEnv,
+            labels: [PRODUCT],
+            readyLabel: "ready",
+            defaultProject: "app",
+        },
+        nextSteps,
+    };
+}
+/** What `mason doctor` reports. Options and environment only, no network. */
+export function checkManager(context) {
+    const read = readOptions(context);
+    if (!read.ok) {
+        return [{ level: "fail", label: "manager options", detail: read.reason }];
+    }
+    const settings = read.settings;
+    const token = settings.token ?? context.env[settings.tokenEnv];
+    const findings = [
+        {
+            level: "ok",
+            label: "repository",
+            detail: `${settings.repo.owner}/${settings.repo.name}`,
+        },
+        token === undefined || token.trim().length === 0
+            ? { level: "fail", label: "token", detail: `${settings.tokenEnv} is not set` }
+            : { level: "ok", label: "token", detail: `${settings.tokenEnv} is set` },
+    ];
+    if (settings.labels === undefined || settings.labels.length === 0) {
+        findings.push({
+            level: "warn",
+            label: "labels",
+            detail: "every open issue is admitted; set labels to narrow the Source",
+        });
+    }
+    else {
+        findings.push({ level: "ok", label: "labels", detail: settings.labels.join(", ") });
+    }
+    findings.push(settings.commitAuthor === undefined
+        ? {
+            level: "warn",
+            label: "commit author",
+            detail: "no \"commitAuthor\": commits will carry this machine's git identity, not the system's",
+        }
+        : {
+            level: "ok",
+            label: "commit author",
+            detail: `${settings.commitAuthor.name} <${settings.commitAuthor.email}>`,
+        });
+    findings.push(settings.remote.startsWith("https://")
+        ? {
+            level: "ok",
+            label: "git remote",
+            detail: `${settings.remote} — with ${settings.tokenEnv}`,
+        }
+        : {
+            level: "warn",
+            label: "git remote",
+            detail: `${settings.remote} — not HTTPS, so git authenticates with this machine's keys, not the token`,
+        });
+    // Whether the repository has the labels is `mason setup`'s question: doctor
+    // stays offline and does not guess.
+    return findings;
+}
+function readOptions(context) {
+    const known = rejectUnknownOptions(context.options, KNOWN_OPTIONS);
+    if (!known.ok) {
+        return known;
+    }
+    const repoRaw = stringOption(context.options, "repo");
+    if (!repoRaw.ok) {
+        return repoRaw;
+    }
+    if (repoRaw.value === undefined) {
+        return { ok: false, reason: 'managerOptions "repo" is required (owner/name).' };
+    }
+    const repo = parseRepo(repoRaw.value);
+    if (repo === null) {
+        return { ok: false, reason: 'managerOptions "repo" must be owner/name.' };
+    }
+    const token = stringOption(context.options, "token");
+    if (!token.ok) {
+        return token;
+    }
+    const tokenEnv = stringOption(context.options, "tokenEnv");
+    if (!tokenEnv.ok) {
+        return tokenEnv;
+    }
+    const apiBase = stringOption(context.options, "apiBase");
+    if (!apiBase.ok) {
+        return apiBase;
+    }
+    const labels = stringArrayOption(context.options, "labels");
+    if (!labels.ok) {
+        return labels;
+    }
+    const defaultProject = stringOption(context.options, "defaultProject");
+    if (!defaultProject.ok) {
+        return defaultProject;
+    }
+    const readyLabel = stringOption(context.options, "readyLabel");
+    if (!readyLabel.ok) {
+        return readyLabel;
+    }
+    const defaultPriority = intOption(context.options, "defaultPriority", 0, 100);
+    if (!defaultPriority.ok) {
+        return defaultPriority;
+    }
+    const stateLabelPrefix = stringOption(context.options, "stateLabelPrefix");
+    if (!stateLabelPrefix.ok) {
+        return stateLabelPrefix;
+    }
+    const branch = stringOption(context.options, "branch");
+    if (!branch.ok) {
+        return branch;
+    }
+    const remote = stringOption(context.options, "remote");
+    if (!remote.ok) {
+        return remote;
+    }
+    const commitAuthor = stringOption(context.options, "commitAuthor");
+    if (!commitAuthor.ok) {
+        return commitAuthor;
+    }
+    const author = commitAuthor.value === undefined ? undefined : parseAuthor(commitAuthor.value);
+    if (author !== undefined && !author.ok) {
+        return author;
+    }
+    const keepBranch = booleanOption(context.options, "keepBranch");
+    if (!keepBranch.ok) {
+        return keepBranch;
+    }
+    const candidateFetch = context.options.fetch;
+    if (candidateFetch !== undefined && typeof candidateFetch !== "function") {
+        return { ok: false, reason: 'managerOptions "fetch" must be a function (tests only).' };
+    }
+    return {
+        ok: true,
+        settings: {
+            repo,
+            token: token.value,
+            tokenEnv: tokenEnv.value ?? DEFAULT_TOKEN_ENV,
+            apiBase: apiBase.value ?? DEFAULT_API_BASE,
+            readyLabel: readyLabel.value ?? DEFAULT_READY_LABEL,
+            labels: labels.value,
+            defaultProject: defaultProject.value,
+            defaultPriority: defaultPriority.value,
+            stateLabelPrefix: stateLabelPrefix.value,
+            branch: branch.value ?? DEFAULT_BRANCH,
+            remote: remote.value ?? `https://${DEFAULT_GIT_HOST}/${repo.owner}/${repo.name}.git`,
+            commitAuthor: author?.value,
+            keepBranch: keepBranch.value,
+            githubFetch: candidateFetch,
+        },
+    };
+}
+/** `Name <email>`, the form `git log` prints. */
+export function parseAuthor(text) {
+    const match = /^\s*(.+?)\s*<([^<>\s]+@[^<>\s]+)>\s*$/.exec(text);
+    if (match?.[1] === undefined || match[2] === undefined) {
+        return {
+            ok: false,
+            reason: `managerOptions "commitAuthor" must read "Name <email>", e.g. "${PRODUCT} <${PRODUCT}@example.com>".`,
+        };
+    }
+    return { ok: true, value: { name: match[1], email: match[2] } };
+}
+/**
+ * Where the reference work line is: the repository's own git remote, and the
+ * branch pull requests are opened onto. Host keeps a copy of it; these are the
+ * words `@bluewombat/isolation-git` reads.
+ *
+ * Over HTTPS by default, authenticated with the same token as the API —
+ * `credentialEnv` names the variable, and the strategy reads it when git asks,
+ * so nothing lands in a `.git/config` on disk and the pushes are the token's
+ * account, not the machine's SSH key. `remote` overrides the URL (SSH, a
+ * mirror, GitHub Enterprise). `author` is who the system is on its commits.
+ */
+export function referenceManager(context) {
+    const read = readOptions(context);
+    if (!read.ok) {
+        return undefined;
+    }
+    const { remote, branch, tokenEnv, commitAuthor } = read.settings;
+    return {
+        remote,
+        branch,
+        ...(remote.startsWith("https://") ? { credentialEnv: tokenEnv } : {}),
+        ...(commitAuthor === undefined ? {} : { author: commitAuthor }),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/issue-number.d.ts

@@ -0,0 +1,5 @@
+/** The issue number encoded in `owner/name#42`. */
+export declare function issueNumberFromExternalId(externalId: string): number | undefined;
+/** The issue number a listing or webhook payload carries. */
+export declare function issueNumberFromPayload(payload: Record<string, unknown>): number | undefined;
+//# sourceMappingURL=issue-number.d.ts.map

package/dist/issue-number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-number.d.ts","sourceRoot":"","sources":["../src/issue-number.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMhF;AAED,6DAA6D;AAC7D,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAS3F"}

package/dist/issue-number.js

@@ -0,0 +1,32 @@
+/** The issue number encoded in `owner/name#42`. */
+export function issueNumberFromExternalId(externalId) {
+    const hash = externalId.lastIndexOf("#");
+    if (hash < 0) {
+        return undefined;
+    }
+    return parsePositiveInt(externalId.slice(hash + 1));
+}
+/** The issue number a listing or webhook payload carries. */
+export function issueNumberFromPayload(payload) {
+    const nested = payload.issue;
+    if (nested !== null && typeof nested === "object" && !Array.isArray(nested)) {
+        const inner = issueNumberFromPayload(nested);
+        if (inner !== undefined) {
+            return inner;
+        }
+    }
+    return parsePositiveInt(payload.number);
+}
+function parsePositiveInt(value) {
+    if (typeof value === "number" && Number.isInteger(value) && value > 0) {
+        return value;
+    }
+    if (typeof value === "string" && /^\d+$/.test(value.trim())) {
+        const parsed = Number(value.trim());
+        if (parsed > 0) {
+            return parsed;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=issue-number.js.map

package/dist/issue-number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-number.js","sourceRoot":"","sources":["../src/issue-number.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,MAAM,UAAU,yBAAyB,CAAC,UAAkB;IAC1D,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,gBAAgB,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,sBAAsB,CAAC,OAAgC;IACrE,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAC7B,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5E,MAAM,KAAK,GAAG,sBAAsB,CAAC,MAAiC,CAAC,CAAC;QACxE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACtE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACpC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACf,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/labels.d.ts

@@ -0,0 +1,3 @@
+/** Whether a GitHub-shaped payload carries this label, ignoring case. */
+export declare function payloadHasLabel(payload: Record<string, unknown>, label: string): boolean;
+//# sourceMappingURL=labels.d.ts.map