@bluewombat/manager-github 0.1.0

package/dist/adapter/run/run-adapter.js

@@ -0,0 +1,131 @@
+import { fetchIssue } from "../github/fetch-issue.js";
+import { normalize } from "../normalize/normalize.js";
+import { parseRaw } from "../raw/parse-raw.js";
+import { unwrapIssue } from "../raw/unwrap.js";
+function exitCodeFor(outcome) {
+    switch (outcome) {
+        case "converted":
+            return 0;
+        case "invalid":
+            return 1;
+        case "invalid-invocation":
+            return 2;
+        case "unavailable":
+            return 3;
+        case "interrupted":
+            return 130;
+    }
+}
+export function invalidInvocationResult(write, reason) {
+    write({ event: "result", outcome: "invalid-invocation", detail: reason });
+    return {
+        outcome: "invalid-invocation",
+        detail: reason,
+        exitCode: exitCodeFor("invalid-invocation"),
+    };
+}
+/** The issue number a Fetch would re-read, before any normalization. */
+function fetchableNumber(issue) {
+    const value = issue.number;
+    if (typeof value === "number" && Number.isInteger(value) && value > 0) {
+        return value;
+    }
+    if (typeof value === "string" && /^\d+$/.test(value.trim())) {
+        return Number(value.trim());
+    }
+    return undefined;
+}
+/**
+ * Run one FeatureAdapter invocation to a run outcome.
+ */
+export async function runAdapter(options) {
+    const { invocation, raw } = options;
+    const write = options.write ?? (() => { });
+    const now = options.now ?? (() => Date.now());
+    const interruptState = options.interruptFlag ?? { interrupted: false };
+    const shouldInterrupt = () => interruptState.interrupted;
+    const finishInvalid = (invalid) => {
+        write({
+            event: "result",
+            manager: invocation.manager,
+            outcome: "invalid",
+            code: invalid.code,
+            reason: invalid.reason,
+        });
+        return { outcome: "invalid", invalid, exitCode: exitCodeFor("invalid") };
+    };
+    const finishUnavailable = (detail) => {
+        write({ event: "result", manager: invocation.manager, outcome: "unavailable", detail });
+        return { outcome: "unavailable", detail, exitCode: exitCodeFor("unavailable") };
+    };
+    const finishInterrupted = () => {
+        write({ event: "result", manager: invocation.manager, outcome: "interrupted" });
+        return { outcome: "interrupted", exitCode: exitCodeFor("interrupted") };
+    };
+    if (shouldInterrupt()) {
+        return finishInterrupted();
+    }
+    const parsed = parseRaw(raw, invocation.maxRawBytes);
+    if (!parsed.ok) {
+        // No issue to re-read: the Fetch is skipped entirely.
+        return finishInvalid(parsed.invalid);
+    }
+    const unwrapped = unwrapIssue(parsed.object);
+    let merged = unwrapped;
+    if (invocation.fetch) {
+        const number = fetchableNumber(unwrapped.issue);
+        if (options.github === undefined) {
+            return finishUnavailable("No authenticated channel was given for the Fetch.");
+        }
+        if (number === undefined) {
+            // Nothing to ask for: normalization will refuse this with missing-id.
+            write({ event: "fetch-finished", manager: invocation.manager, result: "skipped" });
+        }
+        else {
+            const fetched = await fetchIssue({
+                invocation,
+                github: options.github,
+                number,
+                deadlineMs: now() + (invocation.fetchDurationMs ?? 1),
+                now,
+                shouldInterrupt,
+            });
+            write({ event: "fetch-finished", manager: invocation.manager, result: fetched.kind });
+            if (fetched.kind === "interrupted") {
+                return finishInterrupted();
+            }
+            if (fetched.kind === "unavailable") {
+                return finishUnavailable(fetched.detail);
+            }
+            // The Fetch is the base; the raw intention is the fresher of the two.
+            merged = { ...unwrapped, issue: { ...fetched.issue, ...unwrapped.issue } };
+        }
+    }
+    if (shouldInterrupt()) {
+        return finishInterrupted();
+    }
+    const result = normalize(merged, {
+        manager: invocation.manager,
+        repo: invocation.repo,
+        defaultPriority: invocation.defaultPriority,
+        projectLabelPrefix: invocation.projectLabelPrefix,
+        priorityLabelPrefix: invocation.priorityLabelPrefix,
+        readyLabel: invocation.readyLabel,
+        normalizedAt: invocation.at ?? new Date(now()).toISOString(),
+        ...(invocation.defaultProject !== undefined
+            ? { defaultProject: invocation.defaultProject }
+            : {}),
+    });
+    if (!result.ok) {
+        return finishInvalid(result.invalid);
+    }
+    write({
+        event: "result",
+        manager: invocation.manager,
+        key: result.feature.key,
+        outcome: "converted",
+        feature: result.feature,
+    });
+    return { outcome: "converted", feature: result.feature, exitCode: exitCodeFor("converted") };
+}
+//# sourceMappingURL=run-adapter.js.map

package/dist/adapter/run/run-adapter.js.map

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

package/dist/adapter/types.d.ts

@@ -0,0 +1,69 @@
+/** Domain types owned by FeatureAdapter. Names match the Block perimeter only. */
+export type RunOutcome = "converted" | "invalid" | "invalid-invocation" | "unavailable" | "interrupted";
+export type Intent = "upsert" | "ready" | "cancel";
+export type InvalidCode = "raw-too-large" | "raw-not-json" | "raw-not-object" | "not-an-issue" | "unknown-action" | "missing-id" | "missing-project" | "ambiguous-project" | "missing-intention" | "bad-field-type" | "bad-priority";
+export type Repository = {
+    owner: string;
+    name: string;
+};
+export type Invocation = {
+    manager: string;
+    repo: Repository;
+    /** Root of the REST API, so a GitHub Enterprise host is one argument away. */
+    apiBase: string;
+    /** The raw intention as one argument; absent means stdin. */
+    raw?: string;
+    defaultProject?: string;
+    defaultPriority: number;
+    maxRawBytes: number;
+    /** Prefix of the label carrying the project, e.g. `project:`. */
+    projectLabelPrefix: string;
+    /** Prefix of the label carrying the priority, e.g. `priority:`. */
+    priorityLabelPrefix: string;
+    /** Label whose arrival means a human unblocked the intention. */
+    readyLabel: string;
+    /** Re-read the issue from the API before normalizing. */
+    fetch: boolean;
+    fetchDurationMs?: number;
+    requestRetries: number;
+    /** Value stamped as normalized_at; absent means the current time. */
+    at?: string;
+};
+export type ParseResult = 
+/** The token is beside the Invocation, never inside it, and only a Fetch needs one. */
+{
+    ok: true;
+    invocation: Invocation;
+    token?: string;
+} | {
+    ok: false;
+    reason: string;
+};
+export type FeatureStandard = {
+    key: string;
+    manager: string;
+    external_id: string;
+    intent: Intent;
+    project: string;
+    title?: string;
+    intention?: string;
+    priority: number;
+    source?: {
+        ref?: string;
+        revision?: string;
+    };
+    fingerprint: string;
+    normalized_at: string;
+};
+export type Invalid = {
+    code: InvalidCode;
+    reason: string;
+};
+export type NormalizeResult = {
+    ok: true;
+    feature: FeatureStandard;
+} | {
+    ok: false;
+    invalid: Invalid;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/adapter/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapter/types.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAElF,MAAM,MAAM,UAAU,GAClB,WAAW,GACX,SAAS,GACT,oBAAoB,GACpB,aAAa,GACb,aAAa,CAAC;AAElB,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEnD,MAAM,MAAM,WAAW,GACnB,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,cAAc,GACd,gBAAgB,GAChB,YAAY,GACZ,iBAAiB,GACjB,mBAAmB,GACnB,mBAAmB,GACnB,gBAAgB,GAChB,cAAc,CAAC;AAEnB,MAAM,MAAM,UAAU,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;IACjB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mEAAmE;IACnE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,KAAK,EAAE,OAAO,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,WAAW;AACrB,uFAAuF;AACvF;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,UAAU,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvF,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GACtC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC"}

package/dist/adapter/types.js

@@ -0,0 +1,3 @@
+/** Domain types owned by FeatureAdapter. Names match the Block perimeter only. */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/adapter/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapter/types.ts"],"names":[],"mappings":"AAAA,kFAAkF"}

package/dist/emitter/event/field-matrix.d.ts

@@ -0,0 +1,29 @@
+import type { EventFields, EventName } from "../types.js";
+export type FieldName = keyof EventFields;
+/** Column order of the matrix: it also orders a rendered section. */
+export declare const FIELD_ORDER: FieldName[];
+export declare const EVENT_NAMES: EventName[];
+type Rule = {
+    required: FieldName[];
+    optional: FieldName[];
+};
+/**
+ * What each Event accepts. A field outside its row is refused, not dropped:
+ * a caller setting `reference` on `planned` has confused two Events, and a
+ * report that hides that is worse than a refusal.
+ */
+export declare const FIELD_MATRIX: Record<EventName, Rule>;
+export type ValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Check one Event's fields against the matrix, plus the two rules on top of it.
+ * Pure: no directory, no clock.
+ */
+export declare function validateFields(event: EventName, fields: EventFields): ValidationResult;
+export declare function flagOf(field: FieldName): string;
+export {};
+//# sourceMappingURL=field-matrix.d.ts.map

package/dist/emitter/event/field-matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-matrix.d.ts","sourceRoot":"","sources":["../../../src/emitter/event/field-matrix.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC;AAE1C,qEAAqE;AACrE,eAAO,MAAM,WAAW,EAAE,SAAS,EAelC,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,SAAS,EAYlC,CAAC;AAEF,KAAK,IAAI,GAAG;IAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAAC,QAAQ,EAAE,SAAS,EAAE,CAAA;CAAE,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,SAAS,EAAE,IAAI,CAyBhD,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,gBAAgB,CA4BtF;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAE/C"}

package/dist/emitter/event/field-matrix.js

@@ -0,0 +1,94 @@
+/** Column order of the matrix: it also orders a rendered section. */
+export const FIELD_ORDER = [
+    "summary",
+    "reason",
+    "stage",
+    "trace",
+    "counters",
+    "plan",
+    "priority",
+    "unit",
+    "remaining",
+    "state",
+    "resume_point",
+    "reference",
+    "integration_reference",
+    "workspace_ref",
+];
+export const EVENT_NAMES = [
+    "invalid",
+    "accepted",
+    "planned",
+    "progress",
+    "escalated",
+    "escalation_reminder",
+    "resumed",
+    "submitted",
+    "done",
+    "cancelled",
+    "reject_late",
+];
+/**
+ * What each Event accepts. A field outside its row is refused, not dropped:
+ * a caller setting `reference` on `planned` has confused two Events, and a
+ * report that hides that is worse than a refusal.
+ */
+export const FIELD_MATRIX = {
+    invalid: { required: ["reason"], optional: [] },
+    accepted: { required: ["priority"], optional: [] },
+    planned: { required: ["plan"], optional: [] },
+    // Progress is one sentence a person reads — a Subtask landed, a refusal
+    // being repaired — and whatever detail the caller wants to leave under it.
+    progress: {
+        required: ["summary"],
+        optional: ["unit", "remaining", "state", "stage", "reason", "trace", "counters"],
+    },
+    escalated: {
+        required: ["reason", "stage"],
+        optional: ["trace", "counters", "unit"],
+    },
+    escalation_reminder: {
+        required: ["reason", "stage"],
+        optional: ["trace", "counters", "unit"],
+    },
+    resumed: { required: ["resume_point"], optional: ["reason"] },
+    // The work is in front of the Authority; the reference is where it can be seen.
+    submitted: { required: ["reference"], optional: [] },
+    // A local fold names nothing a reader could open; only an Authority's fold has a reference.
+    done: { required: [], optional: ["reference", "integration_reference"] },
+    cancelled: { required: ["state"], optional: ["reason", "workspace_ref"] },
+    reject_late: { required: ["reason"], optional: ["state", "reference"] },
+};
+/**
+ * Check one Event's fields against the matrix, plus the two rules on top of it.
+ * Pure: no directory, no clock.
+ */
+export function validateFields(event, fields) {
+    const rule = FIELD_MATRIX[event];
+    const allowed = new Set([...rule.required, ...rule.optional]);
+    const given = FIELD_ORDER.filter((field) => fields[field] !== undefined);
+    const refused = given.filter((field) => !allowed.has(field));
+    if (refused.length > 0) {
+        return {
+            ok: false,
+            reason: `Event "${event}" does not accept: ${refused.map(flagOf).join(", ")}.`,
+        };
+    }
+    const missing = rule.required.filter((field) => fields[field] === undefined);
+    if (missing.length > 0) {
+        return {
+            ok: false,
+            reason: `Event "${event}" requires: ${missing.map(flagOf).join(", ")}.`,
+        };
+    }
+    // An escalation about work that ran, without what it left behind, forces a
+    // human to reproduce the failure before they can understand it.
+    if (fields.stage === "unit" && fields.trace === undefined) {
+        return { ok: false, reason: 'Stage "unit" requires --trace or --trace-file.' };
+    }
+    return { ok: true };
+}
+export function flagOf(field) {
+    return `--${field.replace(/_/g, "-")}`;
+}
+//# sourceMappingURL=field-matrix.js.map

package/dist/emitter/event/field-matrix.js.map

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

package/dist/emitter/github/comments.d.ts

@@ -0,0 +1,14 @@
+import { type GithubClient } from "../../github/client.js";
+import type { Invocation } from "../types.js";
+import type { CallContext, TargetResult } from "./result.js";
+/**
+ * Every comment body already in the Thread. Read only for idempotence: this
+ * Block never edits or deletes a comment, its own included.
+ */
+export declare function listCommentBodies(invocation: Invocation, github: GithubClient, context: CallContext): Promise<TargetResult<string[]>>;
+export type CreatedComment = {
+    url: string | undefined;
+};
+/** Append one comment. One request, so it lands whole or not at all. */
+export declare function createComment(invocation: Invocation, github: GithubClient, context: CallContext, body: string): Promise<TargetResult<CreatedComment>>;
+//# sourceMappingURL=comments.d.ts.map

package/dist/emitter/github/comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../../src/emitter/github/comments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,YAAY,EAAe,MAAM,wBAAwB,CAAC;AACpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAa7D;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,CAkCjC;AAED,MAAM,MAAM,cAAc,GAAG;IAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEzD,wEAAwE;AACxE,wBAAsB,aAAa,CACjC,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,CAmBvC"}

package/dist/emitter/github/comments.js

@@ -0,0 +1,69 @@
+import { callSignal, readFailure } from "../../github/client.js";
+const PER_PAGE = 100;
+/** A Thread nobody would scroll; past it, the idempotence scan gives up. */
+const MAX_PAGES = 50;
+function failed(error, context) {
+    if (context.shouldInterrupt()) {
+        return { kind: "interrupted" };
+    }
+    return { kind: "unreportable", detail: readFailure(error).detail };
+}
+/**
+ * Every comment body already in the Thread. Read only for idempotence: this
+ * Block never edits or deletes a comment, its own included.
+ */
+export async function listCommentBodies(invocation, github, context) {
+    const bodies = [];
+    for (let page = 1; page <= MAX_PAGES; page += 1) {
+        const call = callSignal(context.deadlineMs, context.now, context.shouldInterrupt);
+        try {
+            const response = await github.request("GET /repos/{owner}/{repo}/issues/{issue_number}/comments", {
+                owner: invocation.repo.owner,
+                repo: invocation.repo.name,
+                issue_number: invocation.issue,
+                per_page: PER_PAGE,
+                page,
+                request: { signal: call.signal },
+            });
+            for (const comment of response.data) {
+                if (typeof comment.body === "string") {
+                    bodies.push(comment.body);
+                }
+            }
+            if (response.data.length < PER_PAGE) {
+                return { kind: "ok", value: bodies };
+            }
+        }
+        catch (error) {
+            return failed(error, context);
+        }
+        finally {
+            call.release();
+        }
+    }
+    return {
+        kind: "unreportable",
+        detail: `The Thread holds more than ${MAX_PAGES * PER_PAGE} comments; idempotence cannot be established.`,
+    };
+}
+/** Append one comment. One request, so it lands whole or not at all. */
+export async function createComment(invocation, github, context, body) {
+    const call = callSignal(context.deadlineMs, context.now, context.shouldInterrupt);
+    try {
+        const response = await github.request("POST /repos/{owner}/{repo}/issues/{issue_number}/comments", {
+            owner: invocation.repo.owner,
+            repo: invocation.repo.name,
+            issue_number: invocation.issue,
+            body,
+            request: { signal: call.signal },
+        });
+        return { kind: "ok", value: { url: response.data.html_url } };
+    }
+    catch (error) {
+        return failed(error, context);
+    }
+    finally {
+        call.release();
+    }
+}
+//# sourceMappingURL=comments.js.map

package/dist/emitter/github/comments.js.map

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

package/dist/emitter/github/labels.d.ts

@@ -0,0 +1,18 @@
+import { type GithubClient } from "../../github/client.js";
+import type { Invocation } from "../types.js";
+import type { CallContext, TargetResult } from "./result.js";
+/** The label this Event stands for, e.g. `mason:escalated`. */
+export declare function labelFor(prefix: string, event: string): string;
+export type LabelSync = {
+    added?: string;
+    removed: string[];
+};
+/**
+ * Move the Thread's state label to this Event.
+ *
+ * Only labels carrying the prefix are touched: a `project:` or a `bug` label is
+ * somebody else's, and a report that rewrites the issue's whole label set is a
+ * report that destroys data.
+ */
+export declare function syncStateLabel(invocation: Invocation, github: GithubClient, context: CallContext, prefix: string): Promise<TargetResult<LabelSync>>;
+//# sourceMappingURL=labels.d.ts.map

package/dist/emitter/github/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../../src/emitter/github/labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,YAAY,EAAe,MAAM,wBAAwB,CAAC;AACpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI7D,+DAA+D;AAC/D,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,MAAM,MAAM,SAAS,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAS9D;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAgElC"}

package/dist/emitter/github/labels.js

@@ -0,0 +1,81 @@
+import { callSignal, readFailure } from "../../github/client.js";
+const PER_PAGE = 100;
+/** The label this Event stands for, e.g. `mason:escalated`. */
+export function labelFor(prefix, event) {
+    return `${prefix}${event}`;
+}
+function failed(error, context) {
+    if (context.shouldInterrupt()) {
+        return { kind: "interrupted" };
+    }
+    return { kind: "unreportable", detail: readFailure(error).detail };
+}
+/**
+ * Move the Thread's state label to this Event.
+ *
+ * Only labels carrying the prefix are touched: a `project:` or a `bug` label is
+ * somebody else's, and a report that rewrites the issue's whole label set is a
+ * report that destroys data.
+ */
+export async function syncStateLabel(invocation, github, context, prefix) {
+    const target = labelFor(prefix, invocation.event);
+    const issue = {
+        owner: invocation.repo.owner,
+        repo: invocation.repo.name,
+        issue_number: invocation.issue,
+    };
+    let present;
+    const listing = callSignal(context.deadlineMs, context.now, context.shouldInterrupt);
+    try {
+        const response = await github.request("GET /repos/{owner}/{repo}/issues/{issue_number}/labels", {
+            ...issue,
+            per_page: PER_PAGE,
+            request: { signal: listing.signal },
+        });
+        present = response.data.map((label) => label.name);
+    }
+    catch (error) {
+        return failed(error, context);
+    }
+    finally {
+        listing.release();
+    }
+    const stale = present.filter((name) => name.toLowerCase().startsWith(prefix.toLowerCase()) && name !== target);
+    const removed = [];
+    for (const name of stale) {
+        const call = callSignal(context.deadlineMs, context.now, context.shouldInterrupt);
+        try {
+            await github.request("DELETE /repos/{owner}/{repo}/issues/{issue_number}/labels/{name}", {
+                ...issue,
+                name,
+                request: { signal: call.signal },
+            });
+            removed.push(name);
+        }
+        catch (error) {
+            return failed(error, context);
+        }
+        finally {
+            call.release();
+        }
+    }
+    if (present.includes(target)) {
+        return { kind: "ok", value: { removed } };
+    }
+    const adding = callSignal(context.deadlineMs, context.now, context.shouldInterrupt);
+    try {
+        await github.request("POST /repos/{owner}/{repo}/issues/{issue_number}/labels", {
+            ...issue,
+            labels: [target],
+            request: { signal: adding.signal },
+        });
+    }
+    catch (error) {
+        return failed(error, context);
+    }
+    finally {
+        adding.release();
+    }
+    return { kind: "ok", value: { added: target, removed } };
+}
+//# sourceMappingURL=labels.js.map

package/dist/emitter/github/labels.js.map

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

package/dist/emitter/github/result.d.ts

@@ -0,0 +1,19 @@
+/** What a call to the Target can end as, from this Block's point of view. */
+export type TargetResult<T> = {
+    kind: "ok";
+    value: T;
+}
+/** The Target refused, or nobody answered within the retries and the clock. */
+ | {
+    kind: "unreportable";
+    detail: string;
+} | {
+    kind: "interrupted";
+};
+/** The bound every call of one invocation runs under. */
+export type CallContext = {
+    deadlineMs: number;
+    now: () => number;
+    shouldInterrupt: () => boolean;
+};
+//# sourceMappingURL=result.d.ts.map

package/dist/emitter/github/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../../src/emitter/github/result.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,MAAM,YAAY,CAAC,CAAC,IACtB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE;AAC1B,+EAA+E;GAC7E;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AAE5B,yDAAyD;AACzD,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,OAAO,CAAC;CAChC,CAAC"}

package/dist/emitter/github/result.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=result.js.map

package/dist/emitter/github/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../src/emitter/github/result.ts"],"names":[],"mappings":""}

package/dist/emitter/progress/emit.d.ts

@@ -0,0 +1,3 @@
+export type ProgressWriter = (line: Record<string, unknown>) => void;
+export declare function createStdoutProgressWriter(): ProgressWriter;
+//# sourceMappingURL=emit.d.ts.map

package/dist/emitter/progress/emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../../src/emitter/progress/emit.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAErE,wBAAgB,0BAA0B,IAAI,cAAc,CAI3D"}

package/dist/emitter/progress/emit.js

@@ -0,0 +1,6 @@
+export function createStdoutProgressWriter() {
+    return (line) => {
+        process.stdout.write(`${JSON.stringify(line)}\n`);
+    };
+}
+//# sourceMappingURL=emit.js.map

package/dist/emitter/progress/emit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.js","sourceRoot":"","sources":["../../../src/emitter/progress/emit.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,0BAA0B;IACxC,OAAO,CAAC,IAAI,EAAE,EAAE;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC,CAAC;AACJ,CAAC"}

package/dist/emitter/render/render-event.d.ts

@@ -0,0 +1,20 @@
+import type { EventRecord, Invocation } from "../types.js";
+export type Rendered = {
+    record: EventRecord;
+    /** One section for the human surface, trailing newline included. */
+    section: string;
+    /** The exact bytes the comment receives: the section, then the record. */
+    body: string;
+};
+/**
+ * Turn one invocation into the exact bytes the Thread receives.
+ * Pure: --dry-run renders through this same function, so a preview cannot lie.
+ */
+export declare function renderEvent(invocation: Invocation): Rendered;
+/**
+ * `80/100` says nothing to someone who never saw the scale. A word first, the
+ * number after, and "default" when nobody chose — so a reader knows a label
+ * would change it.
+ */
+export declare function priorityInWords(priority: number, fallback: number | undefined): string;
+//# sourceMappingURL=render-event.d.ts.map

package/dist/emitter/render/render-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-event.d.ts","sourceRoot":"","sources":["../../../src/emitter/render/render-event.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAA0B,WAAW,EAAE,UAAU,EAAS,MAAM,aAAa,CAAC;AAkD1F,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE,WAAW,CAAC;IACpB,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ,CA+C5D;AA8LD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAMtF"}