@bluewombat/manager-github 0.1.0

package/dist/emitter/render/render-event.js

@@ -0,0 +1,293 @@
+import { FIELD_ORDER } from "../event/field-matrix.js";
+import { renderMarker } from "../thread/marker.js";
+import { truncateText } from "./truncate.js";
+/** Free-text fields the report ceiling applies to. */
+const BOUNDED_FIELDS = ["reason", "plan", "trace"];
+/** Fields rendered as a fenced block rather than a bullet. */
+const BLOCK_FIELDS = ["trace"];
+/** Fields that are already text a reader can read, rendered as they are. */
+const PROSE_FIELDS = ["plan"];
+/** Said first, as a sentence: no label, no bullet. */
+const LEAD_FIELDS = ["summary"];
+/**
+ * The heading of a comment.
+ *
+ * The Event, in words, and nothing else: the issue page already shows who
+ * commented and when, and the timestamp stays in the record below for machines.
+ */
+const TITLES = {
+    invalid: "Not accepted",
+    accepted: "Accepted",
+    planned: "Planned",
+    progress: "In progress",
+    escalated: "Escalated",
+    escalation_reminder: "Still escalated",
+    resumed: "Resumed",
+    submitted: "Submitted",
+    done: "Done",
+    cancelled: "Cancelled",
+    reject_late: "Too late",
+};
+const SECTION_TITLES = {
+    trace: "Trace",
+    plan: "Plan",
+};
+/** A field whose generic name says nothing useful under a given Event. */
+const FIELD_LABELS = {
+    done: { reference: "merged into", integration_reference: "commit" },
+    submitted: { reference: "under review at" },
+};
+/** Where on the 0…100 scale a priority stops being ordinary. */
+const HIGH_PRIORITY = 75;
+const LOW_PRIORITY = 25;
+/**
+ * Turn one invocation into the exact bytes the Thread receives.
+ * Pure: --dry-run renders through this same function, so a preview cannot lie.
+ */
+export function renderEvent(invocation) {
+    const bounded = applyCeiling(invocation.fields, invocation.maxReportChars);
+    // The record is what a machine needs to tell one comment from another and
+    // to say it once — nothing more. The fields are in the section above it,
+    // where a human reads them; repeating them here doubled every comment.
+    const record = {
+        event: invocation.event,
+        key: invocation.key,
+        project: invocation.project,
+        at: invocation.at,
+    };
+    if (invocation.eventId !== undefined) {
+        record.event_id = invocation.eventId;
+    }
+    if (bounded.truncated.length > 0) {
+        record.truncated = bounded.truncated;
+    }
+    let section;
+    switch (invocation.event) {
+        case "invalid":
+            section = renderInvalid(bounded.fields);
+            break;
+        case "accepted":
+            section = renderAccepted(invocation, bounded.fields);
+            break;
+        case "planned":
+            section = renderPlanned(bounded.fields);
+            break;
+        case "escalated":
+            section = renderEscalated(bounded.fields);
+            break;
+        case "resumed":
+            section = renderResumed(bounded.fields);
+            break;
+        case "done":
+            section =
+                bounded.fields.reference === undefined && bounded.fields.integration_reference === undefined
+                    ? renderDoneLocally()
+                    : renderSection(invocation, bounded.fields);
+            break;
+        default:
+            section = renderSection(invocation, bounded.fields);
+            break;
+    }
+    return { record, section, body: `${section}${renderMarker(record)}\n` };
+}
+function applyCeiling(fields, maxChars) {
+    const out = { ...fields };
+    const truncated = [];
+    for (const field of BOUNDED_FIELDS) {
+        const value = out[field];
+        if (typeof value !== "string") {
+            continue;
+        }
+        const cut = truncateText(value, maxChars);
+        if (cut.truncated) {
+            truncated.push(field);
+            out[field] = cut.text;
+        }
+    }
+    return { fields: out, truncated };
+}
+/**
+ * Dedicated comments for Events the generic field dump would mis-say.
+ * Each is a string literal; `renderEvent` is what chooses this over `renderSection`.
+ */
+function renderInvalid(fields) {
+    return `## Not accepted
+
+I’m sorry, but I can’t process this issue because some of the required information is missing.
+
+${fields.reason ?? ""}
+`;
+}
+function renderAccepted(invocation, fields) {
+    const priority = typeof fields.priority === "number" ? fields.priority : 0;
+    return `## Accepted
+
+Taken in at ${priorityPhrase(priority, invocation.defaultPriority)}.
+`;
+}
+function renderPlanned(fields) {
+    return `## Planned
+
+I have planned this work this issue.
+
+${fields.plan ?? ""}
+`;
+}
+function renderEscalated(fields) {
+    const where = escalatedWhere(fields);
+    const trace = fields.trace === undefined || fields.trace.length === 0
+        ? ""
+        : `
+
+### Trace
+
+\`\`\`text
+${fields.trace}
+\`\`\``;
+    return `## Escalated
+
+🙋 A human action is required to continue.
+
+${fields.reason ?? ""}${where}
+
+No further work starts until a human answers.${trace}
+`;
+}
+/** A fold with no Authority: there is nothing a reader could open, so say where it went in words. */
+function renderDoneLocally() {
+    return `## Done
+
+Folded into the work line.
+`;
+}
+function renderResumed(fields) {
+    const reason = fields.reason === undefined || fields.reason.length === 0 ? "" : `\n\n${fields.reason}`;
+    return `## Resumed
+
+Work continues from ${fields.resume_point ?? ""}.${reason}
+`;
+}
+const STAGE_PHRASE = {
+    plan: "while planning",
+    unit: "on a Subtask",
+    integrating: "while assembling the feature",
+    submitting: "while the Submission was under review",
+    merging: "while folding into the work line",
+};
+function escalatedWhere(fields) {
+    const unit = fields.unit;
+    const attempts = fields.counters?.attempts;
+    if (unit !== undefined && unit.length > 0 && attempts !== undefined) {
+        return `\n\nAfter ${attemptsShown(attempts)} attempts on \`${unit}\`.`;
+    }
+    if (unit !== undefined && unit.length > 0) {
+        return `\n\nOn \`${unit}\`.`;
+    }
+    if (fields.stage !== undefined) {
+        return `\n\nThis happened ${STAGE_PHRASE[fields.stage]}.`;
+    }
+    return "";
+}
+function attemptsShown(raw) {
+    const slash = /^(\d+)\/(\d+)$/.exec(raw);
+    return slash === null ? raw : `${slash[1]} of ${slash[2]}`;
+}
+function priorityPhrase(priority, fallback) {
+    if (fallback !== undefined && priority === fallback) {
+        return `priority ${priority}/100 (the default)`;
+    }
+    const word = priority >= HIGH_PRIORITY ? "high" : priority <= LOW_PRIORITY ? "low" : "normal";
+    return `${word} priority (${priority}/100)`;
+}
+function renderSection(invocation, fields) {
+    // The key and the project are not repeated here: this comment is on that
+    // issue, and the project is on its label. Both stay in the record below.
+    const lines = [`## ${TITLES[invocation.event]}`];
+    for (const field of LEAD_FIELDS) {
+        const value = fields[field];
+        if (typeof value === "string") {
+            lines.push("", value);
+        }
+    }
+    // Collected rather than pushed, so an Event carrying no bullet at all does
+    // not leave a blank line standing under its heading.
+    const bullets = [];
+    for (const field of FIELD_ORDER) {
+        if (BLOCK_FIELDS.includes(field) ||
+            PROSE_FIELDS.includes(field) ||
+            LEAD_FIELDS.includes(field)) {
+            continue;
+        }
+        const value = fields[field];
+        if (value === undefined) {
+            continue;
+        }
+        const shown = field === "priority" && typeof value === "number"
+            ? priorityInWords(value, invocation.defaultPriority)
+            : bullet(value);
+        bullets.push(`- ${label(invocation.event, field)}: ${shown}`);
+    }
+    const note = standingNote(invocation);
+    if (note !== undefined) {
+        bullets.push(`- ${note}`);
+    }
+    if (bullets.length > 0) {
+        lines.push("", ...bullets);
+    }
+    for (const field of PROSE_FIELDS) {
+        const value = fields[field];
+        if (typeof value !== "string") {
+            continue;
+        }
+        lines.push("", `### ${title(field)}`, "", value);
+    }
+    for (const field of BLOCK_FIELDS) {
+        const value = fields[field];
+        if (typeof value !== "string") {
+            continue;
+        }
+        lines.push("", `### ${title(field)}`, "", "```text", value, "```");
+    }
+    lines.push("");
+    return `${lines.join("\n")}\n`;
+}
+/**
+ * `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 function priorityInWords(priority, fallback) {
+    if (fallback !== undefined && priority === fallback) {
+        return `${priority}/100 (default)`;
+    }
+    const word = priority >= HIGH_PRIORITY ? "high" : priority <= LOW_PRIORITY ? "low" : "normal";
+    return `${word} (${priority}/100)`;
+}
+/** What a reader must be told about this Event beyond its fields. */
+function standingNote(invocation) {
+    switch (invocation.event) {
+        case "escalated":
+            return "frozen: no further work starts until a human answers";
+        case "escalation_reminder":
+            return "frozen: still waiting, this is a repeat of an earlier escalation";
+        case "reject_late":
+            return "too late: this arrived after the point of no return";
+        default:
+            return undefined;
+    }
+}
+function label(event, field) {
+    return FIELD_LABELS[event]?.[field] ?? field.replace(/_/g, " ");
+}
+function title(field) {
+    return SECTION_TITLES[field] ?? field.replace(/_/g, " ");
+}
+function bullet(value) {
+    if (value !== null && typeof value === "object") {
+        return Object.entries(value)
+            .map(([name, entry]) => `${name}=${entry}`)
+            .join(", ");
+    }
+    return String(value);
+}
+//# sourceMappingURL=render-event.js.map

package/dist/emitter/render/render-event.js.map

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

package/dist/emitter/render/truncate.d.ts

@@ -0,0 +1,9 @@
+export declare const TRUNCATION_MARKER = " [\u2026truncated]";
+export type TruncateResult = {
+    text: string;
+    truncated: boolean;
+};
+/** Cut long free text, and say so: a silent cut makes a human trust a
+ *  truncated diagnosis. */
+export declare function truncateText(text: string, maxChars: number): TruncateResult;
+//# sourceMappingURL=truncate.d.ts.map

package/dist/emitter/render/truncate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../../../src/emitter/render/truncate.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,uBAAkB,CAAC;AAEjD,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC;AAElE;2BAC2B;AAC3B,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAK3E"}

package/dist/emitter/render/truncate.js

@@ -0,0 +1,10 @@
+export const TRUNCATION_MARKER = " […truncated]";
+/** Cut long free text, and say so: a silent cut makes a human trust a
+ *  truncated diagnosis. */
+export function truncateText(text, maxChars) {
+    if (text.length <= maxChars) {
+        return { text, truncated: false };
+    }
+    return { text: `${text.slice(0, maxChars)}${TRUNCATION_MARKER}`, truncated: true };
+}
+//# sourceMappingURL=truncate.js.map

package/dist/emitter/render/truncate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.js","sourceRoot":"","sources":["../../../src/emitter/render/truncate.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAIjD;2BAC2B;AAC3B,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,QAAgB;IACzD,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACpC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,iBAAiB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACrF,CAAC"}

package/dist/emitter/run/run-emitter.d.ts

@@ -0,0 +1,27 @@
+import type { GithubClient } from "../../github/client.js";
+import type { ProgressWriter } from "../progress/emit.js";
+import type { Invocation, RunOutcome } from "../types.js";
+export type RunResult = {
+    outcome: RunOutcome;
+    /** `<owner>/<name>#<issue>`: the Thread this Event was appended to. */
+    thread: string;
+    commentUrl?: string;
+    detail?: string;
+    exitCode: number;
+};
+export type RunOptions = {
+    invocation: Invocation;
+    /** The authenticated channel to the Target. Not needed by a dry run. */
+    github?: GithubClient;
+    write?: ProgressWriter;
+    now?: () => number;
+    interruptFlag?: {
+        interrupted: boolean;
+    };
+};
+export declare function invalidInvocationResult(write: ProgressWriter, reason: string): RunResult;
+/**
+ * Run one FeatureEmitter invocation to a run outcome.
+ */
+export declare function runEmitter(options: RunOptions): Promise<RunResult>;
+//# sourceMappingURL=run-emitter.d.ts.map

package/dist/emitter/run/run-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-emitter.d.ts","sourceRoot":"","sources":["../../../src/emitter/run/run-emitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,UAAU,CAAC;IACpB,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,wEAAwE;IACxE,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE;QAAE,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC;CAC1C,CAAC;AAiBF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAQxF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAoGxE"}

package/dist/emitter/run/run-emitter.js

@@ -0,0 +1,121 @@
+import { createComment, listCommentBodies } from "../github/comments.js";
+import { syncStateLabel } from "../github/labels.js";
+import { renderEvent } from "../render/render-event.js";
+import { hasEventId } from "../thread/marker.js";
+function exitCodeFor(outcome) {
+    switch (outcome) {
+        case "reported":
+        case "duplicate":
+        case "rendered":
+            return 0;
+        case "unreportable":
+            return 1;
+        case "invalid-invocation":
+            return 2;
+        case "interrupted":
+            return 130;
+    }
+}
+export function invalidInvocationResult(write, reason) {
+    write({ event: "result", outcome: "invalid-invocation", detail: reason });
+    return {
+        outcome: "invalid-invocation",
+        thread: "",
+        detail: reason,
+        exitCode: exitCodeFor("invalid-invocation"),
+    };
+}
+/**
+ * Run one FeatureEmitter invocation to a run outcome.
+ */
+export async function runEmitter(options) {
+    const { invocation } = options;
+    const write = options.write ?? (() => { });
+    const now = options.now ?? (() => Date.now());
+    const interruptState = options.interruptFlag ?? { interrupted: false };
+    const shouldInterrupt = () => interruptState.interrupted;
+    const thread = `${invocation.repo.owner}/${invocation.repo.name}#${invocation.issue}`;
+    let commentUrl;
+    const finish = (outcome, detail) => {
+        const line = {
+            event: "result",
+            outcome,
+            key: invocation.key,
+            project: invocation.project,
+            thread,
+        };
+        if (commentUrl !== undefined) {
+            line.comment_url = commentUrl;
+        }
+        if (detail !== undefined) {
+            line.detail = detail;
+        }
+        write(line);
+        const result = { outcome, thread, exitCode: exitCodeFor(outcome) };
+        if (commentUrl !== undefined) {
+            result.commentUrl = commentUrl;
+        }
+        if (detail !== undefined) {
+            result.detail = detail;
+        }
+        return result;
+    };
+    if (shouldInterrupt()) {
+        return finish("interrupted");
+    }
+    const rendered = renderEvent(invocation);
+    if (invocation.dryRun) {
+        write({
+            event: "render",
+            key: invocation.key,
+            thread,
+            body: rendered.body,
+            record: rendered.record,
+        });
+        return finish("rendered");
+    }
+    if (options.github === undefined) {
+        return finish("unreportable", "No authenticated channel was given for the Target.");
+    }
+    const github = options.github;
+    const context = {
+        deadlineMs: now() + invocation.durationMs,
+        now,
+        shouldInterrupt,
+    };
+    if (invocation.eventId !== undefined) {
+        const listed = await listCommentBodies(invocation, github, context);
+        if (listed.kind === "interrupted") {
+            return finish("interrupted");
+        }
+        if (listed.kind === "unreportable") {
+            return finish("unreportable", listed.detail);
+        }
+        if (hasEventId(listed.value, invocation.eventId)) {
+            return finish("duplicate");
+        }
+    }
+    const created = await createComment(invocation, github, context, rendered.body);
+    if (created.kind === "interrupted") {
+        return finish("interrupted");
+    }
+    if (created.kind === "unreportable") {
+        return finish("unreportable", created.detail);
+    }
+    commentUrl = created.value.url;
+    // The Event is committed. The label is a rendering of it: failing to move it
+    // leaves the report standing, the way a missing section leaves the truth.
+    if (invocation.labelPrefix !== undefined) {
+        const synced = await syncStateLabel(invocation, github, context, invocation.labelPrefix);
+        write({
+            event: "labels-finished",
+            key: invocation.key,
+            thread,
+            result: synced.kind === "ok" ? "moved" : synced.kind,
+            ...(synced.kind === "ok" ? { added: synced.value.added, removed: synced.value.removed } : {}),
+            ...(synced.kind === "unreportable" ? { detail: synced.detail } : {}),
+        });
+    }
+    return finish("reported");
+}
+//# sourceMappingURL=run-emitter.js.map

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

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

package/dist/emitter/thread/marker.d.ts

@@ -0,0 +1,15 @@
+import type { EventRecord } from "../types.js";
+/**
+ * The machine surface of a Thread.
+ *
+ * A comment is one surface for two audiences: a human reads the section, and a
+ * machine reads the record. The record travels inside an HTML comment, which
+ * GitHub renders as nothing at all, so neither audience pays for the other.
+ */
+export declare const MARKER_TAG = "feature-event";
+export declare function renderMarker(record: EventRecord): string;
+/** Every record a comment body carries. A body a human wrote carries none. */
+export declare function readMarkers(body: string): EventRecord[];
+/** Whether this event id is already in the Thread. */
+export declare function hasEventId(bodies: string[], eventId: string): boolean;
+//# sourceMappingURL=marker.d.ts.map

package/dist/emitter/thread/marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marker.d.ts","sourceRoot":"","sources":["../../../src/emitter/thread/marker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,kBAAkB,CAAC;AAE1C,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAExD;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAkBvD;AAED,sDAAsD;AACtD,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAErE"}

package/dist/emitter/thread/marker.js

@@ -0,0 +1,37 @@
+/**
+ * The machine surface of a Thread.
+ *
+ * A comment is one surface for two audiences: a human reads the section, and a
+ * machine reads the record. The record travels inside an HTML comment, which
+ * GitHub renders as nothing at all, so neither audience pays for the other.
+ */
+export const MARKER_TAG = "feature-event";
+export function renderMarker(record) {
+    return `<!-- ${MARKER_TAG} ${JSON.stringify(record)} -->`;
+}
+/** Every record a comment body carries. A body a human wrote carries none. */
+export function readMarkers(body) {
+    const pattern = new RegExp(`<!--\\s*${MARKER_TAG}\\s*([\\s\\S]*?)-->`, "g");
+    const records = [];
+    for (const matched of body.matchAll(pattern)) {
+        const payload = matched[1];
+        if (payload === undefined) {
+            continue;
+        }
+        try {
+            const parsed = JSON.parse(payload.trim());
+            if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+                records.push(parsed);
+            }
+        }
+        catch {
+            // A marker this Block did not write is not a record it has to honour.
+        }
+    }
+    return records;
+}
+/** Whether this event id is already in the Thread. */
+export function hasEventId(bodies, eventId) {
+    return bodies.some((body) => readMarkers(body).some((record) => record.event_id === eventId));
+}
+//# sourceMappingURL=marker.js.map

package/dist/emitter/thread/marker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marker.js","sourceRoot":"","sources":["../../../src/emitter/thread/marker.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,eAAe,CAAC;AAE1C,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC9C,OAAO,QAAQ,UAAU,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC;AAC5D,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,WAAW,UAAU,qBAAqB,EAAE,GAAG,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACnD,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5E,OAAO,CAAC,IAAI,CAAC,MAAqB,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,sEAAsE;QACxE,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,UAAU,CAAC,MAAgB,EAAE,OAAe;IAC1D,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC;AAChG,CAAC"}

package/dist/emitter/types.d.ts

@@ -0,0 +1,64 @@
+/** Domain types owned by FeatureEmitter. Names match the Block perimeter only. */
+export type RunOutcome = "reported" | "duplicate" | "rendered" | "unreportable" | "invalid-invocation" | "interrupted";
+export type EventName = "invalid" | "accepted" | "planned" | "progress" | "escalated" | "escalation_reminder" | "resumed" | "submitted" | "done" | "cancelled" | "reject_late";
+export type Stage = "plan" | "unit" | "integrating" | "submitting" | "merging";
+export type ResumePoint = "planning" | "running" | "integrating";
+/** The Target: one repository. */
+export type Repository = {
+    owner: string;
+    name: string;
+};
+/** Every field an Event may carry beyond key, project and timestamp. */
+export type EventFields = {
+    /** One sentence a reader gets first, under the heading and before any field. */
+    summary?: string;
+    reason?: string;
+    stage?: Stage;
+    trace?: string;
+    counters?: Record<string, string>;
+    plan?: string;
+    priority?: number;
+    unit?: string;
+    remaining?: number;
+    state?: string;
+    resume_point?: ResumePoint;
+    reference?: string;
+    /** On `done`: the work line's own name for the fold — a commit — when the Authority gave one. */
+    integration_reference?: string;
+    workspace_ref?: string;
+};
+export type Invocation = {
+    repo: Repository;
+    /** The Thread: the issue this Event is appended to. */
+    issue: number;
+    /** Root of the REST API, so a GitHub Enterprise host is one argument away. */
+    apiBase: string;
+    event: EventName;
+    key: string;
+    project: string;
+    at: string;
+    eventId?: string;
+    fields: EventFields;
+    maxReportChars: number;
+    /** What `priority` is when nobody chose one, so the comment can say so. */
+    defaultPriority?: number;
+    /** When set, the Event also lands as `<prefix><event>` on the issue. */
+    labelPrefix?: string;
+    durationMs: number;
+    /** Extra attempts after the first, on a transport failure, a 5xx, or a rate limit. */
+    requestRetries: number;
+    dryRun: boolean;
+};
+export type ParseResult = 
+/** The token is beside the Invocation, never inside it; a dry run needs none. */
+{
+    ok: true;
+    invocation: Invocation;
+    token?: string;
+} | {
+    ok: false;
+    reason: string;
+};
+/** The record a comment carries for machines, inside its marker. */
+export type EventRecord = Record<string, unknown>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/emitter/types.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAElF,MAAM,MAAM,UAAU,GAClB,UAAU,GACV,WAAW,GACX,UAAU,GACV,cAAc,GACd,oBAAoB,GACpB,aAAa,CAAC;AAElB,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,UAAU,GACV,SAAS,GACT,UAAU,GACV,WAAW,GACX,qBAAqB,GACrB,SAAS,GACT,WAAW,GACX,MAAM,GACN,WAAW,GACX,aAAa,CAAC;AAElB,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;AAE/E,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,aAAa,CAAC;AAEjE,kCAAkC;AAClC,MAAM,MAAM,UAAU,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,wEAAwE;AACxE,MAAM,MAAM,WAAW,GAAG;IACxB,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iGAAiG;IACjG,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,UAAU,CAAC;IACjB,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,sFAAsF;IACtF,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,WAAW;AACrB,iFAAiF;AACjF;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,oEAAoE;AACpE,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/emitter/types.js

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

package/dist/emitter/types.js.map

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