From 93b184173552dc4f07991e5770be7e1841100f2b Mon Sep 17 00:00:00 2001 From: Mikael Hugo Date: Sat, 2 May 2026 01:49:10 +0200 Subject: [PATCH] chore(sf): docstring tweaks in notification-overlay + self-feedback Co-Authored-By: Claude Opus 4.7 (1M context) --- src/resources/extensions/sf/notification-overlay.ts | 4 ++++ src/resources/extensions/sf/self-feedback.ts | 4 ++-- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/src/resources/extensions/sf/notification-overlay.ts b/src/resources/extensions/sf/notification-overlay.ts index 1103f5fcf..c0bb3fdb6 100644 --- a/src/resources/extensions/sf/notification-overlay.ts +++ b/src/resources/extensions/sf/notification-overlay.ts @@ -90,6 +90,10 @@ function formatTimestamp(ts: string): string { } } +/** + * Compute a string signature of notification entries for change detection. + * Used to detect mutations across processes without re-reading entire file. + */ function notificationSignature(entries: readonly NotificationEntry[]): string { return entries .map( diff --git a/src/resources/extensions/sf/self-feedback.ts b/src/resources/extensions/sf/self-feedback.ts index 65e8b6c87..8ba6f160e 100644 --- a/src/resources/extensions/sf/self-feedback.ts +++ b/src/resources/extensions/sf/self-feedback.ts @@ -250,8 +250,8 @@ function readActiveUnit(basePath: string): SelfFeedbackOccurredIn | undefined { // ─── Public API ──────────────────────────────────────────────────────────── /** - * Record a self-feedback entry. Non-fatal — write errors are swallowed and - * a null result is returned so callers can branch on success without try/catch. + * Record a self-feedback entry to the appropriate channel (project or upstream). + * Non-fatal — write errors are swallowed and null is returned on failure. */ export function recordSelfFeedback( entry: SelfFeedbackEntry,