From ee8c9dcc117f4c90938bf00ecf3fcfce6928aa91 Mon Sep 17 00:00:00 2001 From: Jeroen Schweitzer Date: Mon, 15 Jun 2026 10:30:02 +0200 Subject: [PATCH] docs(watchdog): drop unresolved [IsolateCrumbFile] doc links MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit watchdog.dart doesn't import pty_log.dart (only references the pattern), so the [IsolateCrumbFile] doc references couldn't resolve and the dart-doc gate fails on the warning. Plain-code-font instead of a doc link — no import added just for a cross-reference. Co-Authored-By: Claude Opus 4.8 (1M context) --- lib/kernel/src/watchdog.dart | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/lib/kernel/src/watchdog.dart b/lib/kernel/src/watchdog.dart index a76b7df7..29f212b9 100644 --- a/lib/kernel/src/watchdog.dart +++ b/lib/kernel/src/watchdog.dart @@ -13,7 +13,7 @@ /// /// Output is JSON-lines in `logDirectory()/clide-watchdog.log`, matching /// [FileLogSink] so it greps/parses the same way, bounded by the same -/// truncate-on-cap scheme as [IsolateCrumbFile]. Everything is synchronous and +/// truncate-on-cap scheme as `IsolateCrumbFile`. Everything is synchronous and /// swallows its own errors — the watchdog must never add a second hang or take /// the app down. /// @@ -112,7 +112,7 @@ class PosixResourceSampler implements ResourceSampler { /// The watchdog's on-disk writer: bounded, synchronously-fsynced JSON-lines /// (heartbeats + samples). Separated from the loop so it unit-tests in -/// isolation. Mirrors [IsolateCrumbFile]'s truncate-on-cap bound. +/// isolation. Mirrors `IsolateCrumbFile`'s truncate-on-cap bound. class WatchdogFile { WatchdogFile(String? path, {int capBytes = 256 * 1024}) : _capBytes = capBytes { if (path == null) return;