@siuver/omp-debug-mode 0.1.2 → 0.1.3

package/src/log-files.ts

@@ -24,6 +24,75 @@ export function readJsonlLines(file: string | null): string[] {
 	}
 }
 
+interface CountEntry {
+	size: number;
+	mtimeMs: number;
+	count: number;
+}
+
+/**
+ * Line counts keyed by file identity. The reproduction gate polls the active
+ * log once a second, so re-reading every archived run each time would scale
+ * with the length of the debugging session for no new information.
+ */
+export class JsonlLineCounter {
+	#cache = new Map<string, CountEntry>();
+
+	count(file: string | null): number {
+		if (!file) return 0;
+		const stat = fs.statSync(file, { throwIfNoEntry: false });
+		if (!stat) {
+			this.#cache.delete(file);
+			return 0;
+		}
+		const hit = this.#cache.get(file);
+		if (hit && hit.size === stat.size && hit.mtimeMs === stat.mtimeMs) return hit.count;
+		const count = readJsonlLines(file).length;
+		this.#cache.set(file, { size: stat.size, mtimeMs: stat.mtimeMs, count });
+		return count;
+	}
+
+	clear(): void {
+		this.#cache.clear();
+	}
+}
+
+export interface HypothesisTally {
+	id: string;
+	count: number;
+}
+
+const UNATTRIBUTED = "(unattributed)";
+
+/**
+ * Group observations by the hypothesis each probe was meant to settle, so the
+ * user and the agent can see which hypotheses actually produced evidence
+ * before anyone reads the raw log.
+ */
+export function summarizeHypotheses(lines: readonly string[]): HypothesisTally[] {
+	const counts = new Map<string, number>();
+	for (const line of lines) {
+		let id = UNATTRIBUTED;
+		try {
+			const entry = JSON.parse(line) as { hypothesisId?: unknown };
+			if (typeof entry.hypothesisId === "string" && entry.hypothesisId.trim().length > 0) {
+				id = entry.hypothesisId.trim();
+			}
+		} catch {
+			continue;
+		}
+		counts.set(id, (counts.get(id) ?? 0) + 1);
+	}
+	return [...counts]
+		.map(([id, count]) => ({ id, count }))
+		.sort((a, b) => (b.count !== a.count ? b.count - a.count : a.id < b.id ? -1 : 1));
+}
+
+export function describeHypotheses(tallies: readonly HypothesisTally[]): string {
+	if (tallies.length === 0) return "no hypothesis-attributed observations";
+	return tallies.map(t => `${t.id}=${t.count}`).join(", ");
+}
+
 export function prepareRunLog(debugDir: string, previousRun: string | null): string {
 	const activeFile = path.join(debugDir, ACTIVE_LOG_FILE);
 	const archivedFile = previousRun ? path.join(debugDir, `${previousRun}.jsonl`) : null;