9e3fdc5
@@ -0,0 +1,41 @@
/**
 * The note posted when a clog clears (#5930): the cause on one line, how long
 * the clog took to be noticed and to clear, and the dollars stranded at the
 * peak. Pure: plain data in, markdown out. Posting it is another module's job.
 */
export interface ClogNoteInput {
  /** Why the clog was declared, one phrase each. */
  readonly reasons: readonly string[];
  /** Epoch ms: when the clog began, when it was declared, when it cleared. */
  readonly startedAt: number;
  readonly detectedAt: number;
  readonly clearedAt: number;
  /** Dollars stranded at the peak; absent or not above zero leaves the line out. */
  readonly strandedUsd?: number | null;
}
const MINUTE = 60_000;
const HOUR_AFTER_MIN = 90;
/** "12 min" up to 90 minutes, then "2.5 h"; a negative or non-finite span reads as 0 min. */
export function duration(ms: number): string {
  const min = Number.isFinite(ms) && ms > 0 ? ms / MINUTE : 0;
  if (min <= HOUR_AFTER_MIN) return `${Math.round(min)} min`;
  return `${(Math.round(min / 6) / 10).toString()} h`;
}
export function clogNote(input: ClogNoteInput): string {
  const why = input.reasons.map((r) => r.trim()).filter(Boolean);
  const lines = [
    `Clog cleared. Cause: ${why.length ? why.join("; ") : "not recorded"}.`,
    "",
    `- Time to detect: ${duration(input.detectedAt - input.startedAt)}`,
    `- Time to clear: ${duration(input.clearedAt - input.detectedAt)}`,
  ];
  const usd = input.strandedUsd;
  if (typeof usd === "number" && Number.isFinite(usd) && usd > 0) {
    lines.push(`- Stranded at peak: $${usd.toLocaleString("en-US", { maximumFractionDigits: 2 })}`);
  }
  return lines.join("\n") + "\n";
}
@@ -0,0 +1,33 @@
/** The clog-cleared note: full, without dollars, minutes and hours, never negative. */
import { expect, test } from "bun:test";
import { clogNote, duration } from "../src/flow/clog_note.ts";
const M = 60_000;
const base = { reasons: ["red main", "no reviewer"], startedAt: 0, detectedAt: 10 * M, clearedAt: 70 * M };
test("a full note names cause, both times and the dollars", () => {
  const note = clogNote({ ...base, strandedUsd: 1234.5 });
  expect(note).toBe(
    "Clog cleared. Cause: red main; no reviewer.\n\n- Time to detect: 10 min\n- Time to clear: 60 min\n- Stranded at peak: $1,234.5\n",
  );
});
test("no dollars leaves the line out", () => {
  expect(clogNote(base)).not.toContain("Stranded");
  expect(clogNote({ ...base, strandedUsd: 0 })).not.toContain("Stranded");
});
test("minutes up to 90, hours past it", () => {
  expect(duration(90 * M)).toBe("90 min");
  expect(duration(91 * M)).toBe("1.5 h");
  expect(duration(150 * M)).toBe("2.5 h");
});
test("a negative span reads as zero", () => {
  expect(duration(-5 * M)).toBe("0 min");
  expect(clogNote({ ...base, detectedAt: -M })).toContain("Time to detect: 0 min");
});
test("no reasons still reads", () => {
  expect(clogNote({ ...base, reasons: [] })).toContain("Cause: not recorded.");
});
		@@ -0,0 +1,41 @@
	1	/**
	2	* The note posted when a clog clears (#5930): the cause on one line, how long
	3	* the clog took to be noticed and to clear, and the dollars stranded at the
	4	* peak. Pure: plain data in, markdown out. Posting it is another module's job.
	5	*/
	6
	7	export interface ClogNoteInput {
	8	/** Why the clog was declared, one phrase each. */
	9	readonly reasons: readonly string[];
	10	/** Epoch ms: when the clog began, when it was declared, when it cleared. */
	11	readonly startedAt: number;
	12	readonly detectedAt: number;
	13	readonly clearedAt: number;
	14	/** Dollars stranded at the peak; absent or not above zero leaves the line out. */
	15	readonly strandedUsd?: number \| null;
	16	}
	17
	18	const MINUTE = 60_000;
	19	const HOUR_AFTER_MIN = 90;
	20
	21	/** "12 min" up to 90 minutes, then "2.5 h"; a negative or non-finite span reads as 0 min. */
	22	export function duration(ms: number): string {
	23	const min = Number.isFinite(ms) && ms > 0 ? ms / MINUTE : 0;
	24	if (min <= HOUR_AFTER_MIN) return `${Math.round(min)} min`;
	25	return `${(Math.round(min / 6) / 10).toString()} h`;
	26	}
	27
	28	export function clogNote(input: ClogNoteInput): string {
	29	const why = input.reasons.map((r) => r.trim()).filter(Boolean);
	30	const lines = [
	31	`Clog cleared. Cause: ${why.length ? why.join("; ") : "not recorded"}.`,
	32	"",
	33	`- Time to detect: ${duration(input.detectedAt - input.startedAt)}`,
	34	`- Time to clear: ${duration(input.clearedAt - input.detectedAt)}`,
	35	];
	36	const usd = input.strandedUsd;
	37	if (typeof usd === "number" && Number.isFinite(usd) && usd > 0) {
	38	lines.push(`- Stranded at peak: $${usd.toLocaleString("en-US", { maximumFractionDigits: 2 })}`);
	39	}
	40	return lines.join("\n") + "\n";
	41	}
		@@ -0,0 +1,33 @@
	1	/** The clog-cleared note: full, without dollars, minutes and hours, never negative. */
	2	import { expect, test } from "bun:test";
	3	import { clogNote, duration } from "../src/flow/clog_note.ts";
	4
	5	const M = 60_000;
	6	const base = { reasons: ["red main", "no reviewer"], startedAt: 0, detectedAt: 10 * M, clearedAt: 70 * M };
	7
	8	test("a full note names cause, both times and the dollars", () => {
	9	const note = clogNote({ ...base, strandedUsd: 1234.5 });
	10	expect(note).toBe(
	11	"Clog cleared. Cause: red main; no reviewer.\n\n- Time to detect: 10 min\n- Time to clear: 60 min\n- Stranded at peak: $1,234.5\n",
	12	);
	13	});
	14
	15	test("no dollars leaves the line out", () => {
	16	expect(clogNote(base)).not.toContain("Stranded");
	17	expect(clogNote({ ...base, strandedUsd: 0 })).not.toContain("Stranded");
	18	});
	19
	20	test("minutes up to 90, hours past it", () => {
	21	expect(duration(90 * M)).toBe("90 min");
	22	expect(duration(91 * M)).toBe("1.5 h");
	23	expect(duration(150 * M)).toBe("2.5 h");
	24	});
	25
	26	test("a negative span reads as zero", () => {
	27	expect(duration(-5 * M)).toBe("0 min");
	28	expect(clogNote({ ...base, detectedAt: -M })).toContain("Time to detect: 0 min");
	29	});
	30
	31	test("no reasons still reads", () => {
	32	expect(clogNote({ ...base, reasons: [] })).toContain("Cause: not recorded.");
	33	});