@bluewombat/manager-github 0.1.0

package/dist/setup.js

@@ -0,0 +1,281 @@
+import { EVENT_NAMES, PRODUCT } from "@bluewombat/manager-kit";
+import { callSignal, createClient, readFailure } from "./github/client.js";
+const PER_PAGE = 100;
+/** Colours are only there so a human can tell the families apart at a glance. */
+const READY_COLOUR = "0e8a16";
+const ADMISSION_COLOUR = "1d76db";
+const STATE_COLOUR = "5319e7";
+const PROJECT_COLOUR = "c5def5";
+/**
+ * Bring one repository to the shape a run expects: reachable, issues on, a
+ * token that can write, and every label the config names.
+ *
+ * Idempotent by construction — it asks what is there before it creates
+ * anything, and creating a label that already exists is never attempted.
+ */
+export async function runSetup(settings, input) {
+    const now = () => Date.now();
+    const deadlineMs = now() + settings.durationMs;
+    const shouldInterrupt = () => settings.interruptFlag.interrupted;
+    const github = createClient({
+        token: settings.token,
+        apiBase: settings.apiBase,
+        requestRetries: settings.githubFetch === undefined ? 2 : 0,
+        deadlineMs,
+        now,
+        shouldInterrupt,
+        throttle: settings.githubFetch === undefined,
+        ...(settings.githubFetch !== undefined ? { fetch: settings.githubFetch } : {}),
+    });
+    const context = { deadlineMs, now, shouldInterrupt };
+    const steps = [];
+    const repository = await readRepository(github, settings.repo, settings, context);
+    if (repository.ok === false) {
+        steps.push(repository.step);
+        return { ok: false, steps };
+    }
+    steps.push(...repository.steps);
+    if (repository.steps.some((step) => step.state === "blocked")) {
+        return { ok: false, steps };
+    }
+    const present = await readLabels(github, settings.repo, context);
+    if (present.ok === false) {
+        steps.push(present.step);
+        return { ok: false, steps };
+    }
+    const known = new Set(present.names.map((name) => name.toLowerCase()));
+    for (const wanted of wantedLabels(settings)) {
+        if (known.has(wanted.name.toLowerCase())) {
+            steps.push({
+                id: `label:${wanted.name}`,
+                summary: `label ${wanted.name}`,
+                state: "satisfied",
+                detail: "already on the repository",
+            });
+            continue;
+        }
+        if (!input.apply) {
+            steps.push({
+                id: `label:${wanted.name}`,
+                summary: `create label ${wanted.name}`,
+                state: "missing",
+                detail: wanted.description,
+            });
+            continue;
+        }
+        steps.push(await createLabel(github, settings.repo, wanted, context));
+    }
+    return { ok: steps.every((step) => step.state !== "blocked"), steps };
+}
+/** Every label this configuration will look for or write, and why it exists. */
+export function wantedLabels(settings) {
+    const wanted = [];
+    for (const name of settings.labels ?? []) {
+        wanted.push({
+            name,
+            colour: ADMISSION_COLOUR,
+            description: `${PRODUCT} admits an issue only when it carries this label`,
+        });
+    }
+    wanted.push({
+        name: settings.readyLabel,
+        colour: READY_COLOUR,
+        description: `on an escalated feature, ${PRODUCT} resumes it`,
+    });
+    if (settings.defaultProject !== undefined) {
+        wanted.push({
+            name: `project:${settings.defaultProject}`,
+            colour: PROJECT_COLOUR,
+            description: `routes the issue to this ${PRODUCT} Project`,
+        });
+    }
+    if (settings.stateLabelPrefix !== undefined) {
+        for (const event of EVENT_NAMES) {
+            wanted.push({
+                name: `${settings.stateLabelPrefix}${event}`,
+                colour: STATE_COLOUR,
+                description: `${PRODUCT} state: ${event}`,
+            });
+        }
+    }
+    // A repeated name would try to create the same label twice.
+    const seen = new Set();
+    return wanted.filter((label) => {
+        const key = label.name.toLowerCase();
+        if (seen.has(key)) {
+            return false;
+        }
+        seen.add(key);
+        return true;
+    });
+}
+async function readRepository(github, repo, settings, context) {
+    const slug = `${repo.owner}/${repo.name}`;
+    const call = callSignal(context.deadlineMs, context.now, context.shouldInterrupt);
+    try {
+        const response = await github.request("GET /repos/{owner}/{repo}", {
+            owner: repo.owner,
+            repo: repo.name,
+            request: { signal: call.signal },
+        });
+        const data = response.data;
+        const steps = [
+            { id: "repository", summary: `repository ${slug}`, state: "satisfied" },
+        ];
+        steps.push(data.has_issues === true
+            ? { id: "issues", summary: "issues are enabled", state: "satisfied" }
+            : {
+                id: "issues",
+                summary: "issues are enabled",
+                state: "blocked",
+                detail: `Issues are turned off on ${slug}; ${PRODUCT} has no Source without them.`,
+            });
+        // The authenticated repository response carries what this token may do,
+        // which beats guessing at scope names.
+        const push = data.permissions?.push;
+        steps.push(push === true || push === undefined
+            ? {
+                id: "write-access",
+                summary: "the token can write",
+                state: "satisfied",
+                ...(push === undefined ? { detail: "not reported by the API; assuming it can" } : {}),
+            }
+            : {
+                id: "write-access",
+                summary: "the token can write",
+                state: "blocked",
+                detail: `The token can read ${slug} but not write to it; comments and labels would fail.`,
+            });
+        steps.push(await readBranch(github, repo, settings, {
+            defaultBranch: typeof data.default_branch === "string" ? data.default_branch : undefined,
+        }, context));
+        return { ok: true, steps };
+    }
+    catch (error) {
+        const failure = readFailure(error);
+        return {
+            ok: false,
+            step: {
+                id: "repository",
+                summary: `repository ${slug}`,
+                state: "blocked",
+                detail: failure.status === 404
+                    ? `Not found, or this token cannot see it: ${slug}`
+                    : failure.detail,
+            },
+        };
+    }
+    finally {
+        call.release();
+    }
+}
+/**
+ * The branch pull requests are opened onto has to exist. When the config did
+ * not name one, `main` is a guess, and a repository on another default branch
+ * would otherwise fail at the first run, one step later than here.
+ */
+async function readBranch(github, repo, settings, repository, context) {
+    const slug = `${repo.owner}/${repo.name}`;
+    const { branch, branchConfigured } = settings;
+    const summary = `branch ${branch}`;
+    const call = callSignal(context.deadlineMs, context.now, context.shouldInterrupt);
+    try {
+        await github.request("GET /repos/{owner}/{repo}/branches/{branch}", {
+            owner: repo.owner,
+            repo: repo.name,
+            branch,
+            request: { signal: call.signal },
+        });
+    }
+    catch (error) {
+        const failure = readFailure(error);
+        if (failure.status !== 404) {
+            return { id: "branch", summary, state: "blocked", detail: failure.detail };
+        }
+        const hint = repository.defaultBranch === undefined || repository.defaultBranch === branch
+            ? ""
+            : ` Its default branch is "${repository.defaultBranch}": set managerOptions.branch to it, or to the branch pull requests should target.`;
+        return {
+            id: "branch",
+            summary,
+            state: "blocked",
+            detail: branchConfigured
+                ? `No branch "${branch}" on ${slug} (managerOptions.branch).${hint}`
+                : `No branch "${branch}" on ${slug}, and managerOptions.branch does not say.${hint}`,
+        };
+    }
+    finally {
+        call.release();
+    }
+    const detail = repository.defaultBranch === undefined || repository.defaultBranch === branch
+        ? "the repository's default branch"
+        : `not the default branch (${repository.defaultBranch}); pull requests are opened onto it`;
+    return { id: "branch", summary, state: "satisfied", detail };
+}
+async function readLabels(github, repo, context) {
+    const names = [];
+    let page = 1;
+    for (;;) {
+        const call = callSignal(context.deadlineMs, context.now, context.shouldInterrupt);
+        try {
+            const response = await github.request("GET /repos/{owner}/{repo}/labels", {
+                owner: repo.owner,
+                repo: repo.name,
+                per_page: PER_PAGE,
+                page,
+                request: { signal: call.signal },
+            });
+            for (const label of response.data) {
+                names.push(label.name);
+            }
+            if (response.data.length < PER_PAGE) {
+                return { ok: true, names };
+            }
+            page += 1;
+        }
+        catch (error) {
+            return {
+                ok: false,
+                step: {
+                    id: "labels",
+                    summary: "read the repository labels",
+                    state: "blocked",
+                    detail: readFailure(error).detail,
+                },
+            };
+        }
+        finally {
+            call.release();
+        }
+    }
+}
+async function createLabel(github, repo, wanted, context) {
+    const call = callSignal(context.deadlineMs, context.now, context.shouldInterrupt);
+    try {
+        await github.request("POST /repos/{owner}/{repo}/labels", {
+            owner: repo.owner,
+            repo: repo.name,
+            name: wanted.name,
+            color: wanted.colour,
+            description: wanted.description,
+            request: { signal: call.signal },
+        });
+        return {
+            id: `label:${wanted.name}`,
+            summary: `create label ${wanted.name}`,
+            state: "applied",
+        };
+    }
+    catch (error) {
+        return {
+            id: `label:${wanted.name}`,
+            summary: `create label ${wanted.name}`,
+            state: "blocked",
+            detail: readFailure(error).detail,
+        };
+    }
+    finally {
+        call.release();
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/dist/submission/submission.d.ts

@@ -0,0 +1,44 @@
+import type { FoldResult, SubmissionRequest, SubmissionResult } from "@bluewombat/manager-kit";
+import { type GithubClient } from "../github/client.js";
+import type { Repository } from "../repo.js";
+/**
+ * A pull request is this Authority's Submission.
+ *
+ * It opens one and it merges one. Whether the work is good is decided nowhere in
+ * this file: the `ci-green` Gate reads the checks and answers, like any other
+ * Gate. An Authority acts; it does not judge.
+ *
+ * The reference travels as the pull request's address: it identifies the
+ * Submission here, and it is the one thing worth showing a human reading the
+ * issue — a path on the machine that ran is of no use to them.
+ */
+export type SubmissionContext = {
+    repo: Repository;
+    github: GithubClient;
+    deadlineMs: number;
+    now: () => number;
+    shouldInterrupt: () => boolean;
+    /** Leave the feature branch on the remote after the fold. Default: delete it. */
+    keepBranch?: boolean | undefined;
+};
+export declare function referenceOf(repo: Repository, number: number): string;
+export declare function numberFromReference(reference: string): number | undefined;
+export declare function submitPullRequest(input: SubmissionRequest, context: SubmissionContext): Promise<SubmissionResult>;
+export declare function foldPullRequest(reference: string, context: SubmissionContext): Promise<FoldResult>;
+/** `commit_title` and `commit_message` for the squash, from what the pull request carries. */
+export declare function commitOf(pullTitle: string, pullBody: string): {
+    commit_title: string;
+    commit_message: string;
+};
+/**
+ * The issue's title, made a pull request title: no trailing full stop, and
+ * the issue's number where GitHub links it.
+ */
+export declare function titleOf(input: Pick<SubmissionRequest, "key" | "title">): string;
+/**
+ * What the pull request delivers, from what was asked and what was planned.
+ * Nothing here is generated: the intention is the human's words, the steps are
+ * the Plan's. `Closes #N` lets GitHub close the issue when this is merged.
+ */
+export declare function bodyOf(input: Pick<SubmissionRequest, "key" | "title" | "intention" | "steps" | "description">): string;
+//# sourceMappingURL=submission.d.ts.map

package/dist/submission/submission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submission.d.ts","sourceRoot":"","sources":["../../src/submission/submission.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE/F,OAAO,EAAc,KAAK,YAAY,EAAe,MAAM,qBAAqB,CAAC;AAEjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,OAAO,CAAC;IAC/B,iFAAiF;IACjF,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClC,CAAC;AAEF,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOzE;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CA+B3B;AAED,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,UAAU,CAAC,CA+CrB;AA0BD,8FAA8F;AAC9F,wBAAgB,QAAQ,CACtB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAelD;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,KAAK,GAAG,OAAO,CAAC,GAAG,MAAM,CAK/E;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CACpB,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,KAAK,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,GAAG,aAAa,CAAC,GACtF,MAAM,CAuBR"}

package/dist/submission/submission.js

@@ -0,0 +1,189 @@
+import { PRODUCT } from "@bluewombat/manager-kit";
+import { callSignal, readFailure } from "../github/client.js";
+import { issueNumberFromExternalId } from "../issue-number.js";
+export function referenceOf(repo, number) {
+    return `https://github.com/${repo.owner}/${repo.name}/pull/${number}`;
+}
+export function numberFromReference(reference) {
+    const matched = /\/pull\/(\d+)\s*$/.exec(reference.trim());
+    if (matched?.[1] === undefined) {
+        return undefined;
+    }
+    const parsed = Number.parseInt(matched[1], 10);
+    return Number.isInteger(parsed) && parsed > 0 ? parsed : undefined;
+}
+export async function submitPullRequest(input, context) {
+    const existing = await openPullRequestFor(input.ref, context);
+    if (existing.kind === "unavailable") {
+        return { outcome: "unavailable" };
+    }
+    if (existing.kind === "found") {
+        // Republished to the same place: the Authority is judging the same
+        // Submission with new content, so there is nothing to open.
+        return { outcome: "submitted", reference: referenceOf(context.repo, existing.number) };
+    }
+    const call = callSignal(context.deadlineMs, context.now, context.shouldInterrupt);
+    try {
+        const response = await context.github.request("POST /repos/{owner}/{repo}/pulls", {
+            owner: context.repo.owner,
+            repo: context.repo.name,
+            title: titleOf(input),
+            head: input.ref,
+            base: input.target,
+            body: bodyOf(input),
+            request: { signal: call.signal },
+        });
+        return { outcome: "submitted", reference: referenceOf(context.repo, response.data.number) };
+    }
+    catch (error) {
+        const failure = readFailure(error);
+        return failure.permanent
+            ? { outcome: "refused", reason: failure.detail }
+            : { outcome: "unavailable" };
+    }
+    finally {
+        call.release();
+    }
+}
+export async function foldPullRequest(reference, context) {
+    const number = numberFromReference(reference);
+    if (number === undefined) {
+        return { outcome: "unavailable" };
+    }
+    const call = callSignal(context.deadlineMs, context.now, context.shouldInterrupt);
+    try {
+        // One commit on the work line per feature, saying what the pull request
+        // was opened with — the message decided then and kept on it, so a restart
+        // loses nothing — and closing the issue. The branch keeps the
+        // Subtask-by-Subtask history for whoever wants it.
+        const pull = await context.github.request("GET /repos/{owner}/{repo}/pulls/{pull_number}", {
+            owner: context.repo.owner,
+            repo: context.repo.name,
+            pull_number: number,
+            request: { signal: call.signal },
+        });
+        const merged = await context.github.request("PUT /repos/{owner}/{repo}/pulls/{pull_number}/merge", {
+            owner: context.repo.owner,
+            repo: context.repo.name,
+            pull_number: number,
+            merge_method: "squash",
+            ...commitOf(pull.data.title, pull.data.body ?? ""),
+            request: { signal: call.signal },
+        });
+        // The branch has done its job once the work line holds the squash. It is
+        // deleted best-effort: the fold happened whatever this call says, and a
+        // branch left behind is clutter, not a failure.
+        if (context.keepBranch !== true) {
+            await deleteBranch(pull.data.head.ref, context, call.signal);
+        }
+        const reference = merged.data.sha;
+        return typeof reference === "string" ? { outcome: "folded", reference } : { outcome: "folded" };
+    }
+    catch (error) {
+        const failure = readFailure(error);
+        if (failure.status === 405 || failure.status === 409) {
+            return { outcome: "conflict", reason: failure.detail };
+        }
+        return failure.permanent
+            ? { outcome: "conflict", reason: failure.detail }
+            : { outcome: "unavailable" };
+    }
+    finally {
+        call.release();
+    }
+}
+async function deleteBranch(ref, context, signal) {
+    try {
+        await context.github.request("DELETE /repos/{owner}/{repo}/git/refs/{ref}", {
+            owner: context.repo.owner,
+            repo: context.repo.name,
+            ref: `heads/${ref}`,
+            request: { signal },
+        });
+    }
+    catch {
+        // Already gone, protected, or unreachable: the fold stands either way.
+    }
+}
+/**
+ * The fold's message rides on the pull request, invisibly, from the moment it
+ * is opened: subject line first, then the body. `fold` reads it back here.
+ */
+const COMMIT_MESSAGE_OPEN = "<!-- commit-message\n";
+const COMMIT_MESSAGE_CLOSE = "\n-->";
+/** `commit_title` and `commit_message` for the squash, from what the pull request carries. */
+export function commitOf(pullTitle, pullBody) {
+    const closes = /^Closes #\d+$/m.exec(pullBody)?.[0];
+    const start = pullBody.indexOf(COMMIT_MESSAGE_OPEN);
+    const end = start < 0 ? -1 : pullBody.indexOf(COMMIT_MESSAGE_CLOSE, start);
+    if (start < 0 || end < 0) {
+        return { commit_title: pullTitle, commit_message: closes ?? "" };
+    }
+    const stored = pullBody.slice(start + COMMIT_MESSAGE_OPEN.length, end).trim();
+    const [subject, ...rest] = stored.split("\n");
+    const body = rest.join("\n").trim();
+    const withClose = [body, closes].filter((part) => part !== undefined && part.length > 0);
+    return {
+        commit_title: subject?.trim() || pullTitle,
+        commit_message: withClose.join("\n\n"),
+    };
+}
+/**
+ * The issue's title, made a pull request title: no trailing full stop, and
+ * the issue's number where GitHub links it.
+ */
+export function titleOf(input) {
+    const issue = issueNumberFromExternalId(input.key);
+    const base = (input.title ?? "").trim().replace(/[.\s]+$/, "");
+    const title = base.length > 0 ? base : `${PRODUCT} ${input.key}`;
+    return issue === undefined ? title : `${title} (#${issue})`;
+}
+/**
+ * What the pull request delivers, from what was asked and what was planned.
+ * Nothing here is generated: the intention is the human's words, the steps are
+ * the Plan's. `Closes #N` lets GitHub close the issue when this is merged.
+ */
+export function bodyOf(input) {
+    const sections = [];
+    // What the reader sees first: the Project's words when a Describer gave
+    // them, else what the human asked, as they wrote it.
+    const slotBody = input.description?.body?.trim() ?? "";
+    const intention = input.intention?.trim() ?? "";
+    const description = slotBody.length > 0 ? slotBody : intention;
+    if (description.length > 0) {
+        sections.push(description);
+    }
+    if (input.steps !== undefined && input.steps.length > 0) {
+        sections.push(["## Changes", ...input.steps.map((line, at) => `${at + 1}. ${line}`)].join("\n"));
+    }
+    const issue = issueNumberFromExternalId(input.key);
+    sections.push(issue === undefined ? `Key: \`${input.key}\`` : `Closes #${issue}`);
+    // The fold's message, decided now and kept here: the Describer's words, or
+    // the title and the intention — the human's own — when there is no slot.
+    const subject = input.description?.subject.trim() || titleOf(input);
+    const stored = [subject, description].filter((part) => part.length > 0).join("\n\n");
+    sections.push(`${COMMIT_MESSAGE_OPEN}${stored}${COMMIT_MESSAGE_CLOSE}`);
+    return sections.join("\n\n");
+}
+async function openPullRequestFor(head, context) {
+    const call = callSignal(context.deadlineMs, context.now, context.shouldInterrupt);
+    try {
+        const response = await context.github.request("GET /repos/{owner}/{repo}/pulls", {
+            owner: context.repo.owner,
+            repo: context.repo.name,
+            head: `${context.repo.owner}:${head}`,
+            state: "open",
+            per_page: 1,
+            request: { signal: call.signal },
+        });
+        const first = response.data[0];
+        return first === undefined ? { kind: "none" } : { kind: "found", number: first.number };
+    }
+    catch {
+        return { kind: "unavailable" };
+    }
+    finally {
+        call.release();
+    }
+}
+//# sourceMappingURL=submission.js.map

package/dist/submission/submission.js.map

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

package/dist/written-fingerprint.d.ts

@@ -0,0 +1,7 @@
+/**
+ * What a human wrote on the issue: title, body, state, and the labels that are
+ * not this manager's own. A comment or a state label moves `updated_at`, and
+ * neither is a change to the intention.
+ */
+export declare function writtenFingerprint(payload: Record<string, unknown>, stateLabelPrefix: string | undefined): string;
+//# sourceMappingURL=written-fingerprint.d.ts.map

package/dist/written-fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"written-fingerprint.d.ts","sourceRoot":"","sources":["../src/written-fingerprint.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,gBAAgB,EAAE,MAAM,GAAG,SAAS,GACnC,MAAM,CAcR"}

package/dist/written-fingerprint.js

@@ -0,0 +1,38 @@
+import { fingerprintOf } from "./adapter/normalize/fingerprint.js";
+/**
+ * What a human wrote on the issue: title, body, state, and the labels that are
+ * not this manager's own. A comment or a state label moves `updated_at`, and
+ * neither is a change to the intention.
+ */
+export function writtenFingerprint(payload, stateLabelPrefix) {
+    const labels = labelNames(payload)
+        .filter((name) => stateLabelPrefix === undefined ||
+        !name.toLowerCase().startsWith(stateLabelPrefix.toLowerCase()))
+        .sort();
+    return fingerprintOf({
+        title: payload.title,
+        body: payload.body,
+        state: payload.state,
+        labels,
+    });
+}
+function labelNames(payload) {
+    const labels = payload.labels;
+    if (!Array.isArray(labels)) {
+        return [];
+    }
+    const names = [];
+    for (const entry of labels) {
+        if (typeof entry === "string") {
+            names.push(entry);
+        }
+        else if (entry !== null && typeof entry === "object" && "name" in entry) {
+            const name = entry.name;
+            if (typeof name === "string") {
+                names.push(name);
+            }
+        }
+    }
+    return names;
+}
+//# sourceMappingURL=written-fingerprint.js.map

package/dist/written-fingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"written-fingerprint.js","sourceRoot":"","sources":["../src/written-fingerprint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAEnE;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAgC,EAChC,gBAAoC;IAEpC,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC;SAC/B,MAAM,CACL,CAAC,IAAI,EAAE,EAAE,CACP,gBAAgB,KAAK,SAAS;QAC9B,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC,CACjE;SACA,IAAI,EAAE,CAAC;IACV,OAAO,aAAa,CAAC;QACnB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,OAAgC;IAClD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;aAAM,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;YAC1E,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAC;YAChD,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@bluewombat/manager-github",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "GitHub Issues FeatureManager: issues in, comments and labels out; pull requests as Authority.",
+  "keywords": [
+    "mason",
+    "bluewombat",
+    "mason-manager",
+    "github"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/tilap/bluewombat/tree/main/packages/plugins/manager-github#readme",
+  "bugs": "https://github.com/tilap/bluewombat/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tilap/bluewombat.git",
+    "directory": "packages/plugins/manager-github"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "SPECS.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=24.20.0"
+  },
+  "scripts": {
+    "lint": "biome check .",
+    "format": "biome check --write .",
+    "tsc": "tsc --noEmit",
+    "test": "tsx --test $(find src -name '*.test.ts')",
+    "build": "tsc -p tsconfig.build.json"
+  },
+  "dependencies": {
+    "@bluewombat/manager-kit": "^0.1.0",
+    "@octokit/core": "^7.0.8",
+    "@octokit/plugin-retry": "^8.1.1",
+    "@octokit/plugin-throttling": "^11.0.5"
+  }
+}