pi-crew 0.1.30 → 0.1.32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (159) hide show
  1. package/CHANGELOG.md +9 -0
  2. package/README.md +80 -27
  3. package/agents/analyst.md +11 -11
  4. package/agents/critic.md +11 -11
  5. package/agents/executor.md +11 -11
  6. package/agents/explorer.md +11 -11
  7. package/agents/planner.md +11 -11
  8. package/agents/reviewer.md +11 -11
  9. package/agents/security-reviewer.md +11 -11
  10. package/agents/test-engineer.md +11 -11
  11. package/agents/verifier.md +11 -11
  12. package/agents/writer.md +11 -11
  13. package/docs/architecture.md +173 -164
  14. package/docs/refactor-tasks-phase3.md +394 -394
  15. package/docs/refactor-tasks-phase4.md +564 -564
  16. package/docs/refactor-tasks-phase5.md +402 -402
  17. package/docs/refactor-tasks-phase6.md +662 -662
  18. package/docs/research-extension-examples.md +297 -0
  19. package/docs/research-extension-system.md +324 -0
  20. package/docs/research-optimization-plan.md +548 -0
  21. package/docs/research-pi-coding-agent.md +357 -0
  22. package/docs/resource-formats.md +4 -3
  23. package/docs/runtime-flow.md +148 -148
  24. package/docs/source-runtime-refactor-map.md +83 -83
  25. package/docs/usage.md +3 -3
  26. package/index.ts +6 -6
  27. package/package.json +1 -1
  28. package/schema.json +53 -1
  29. package/skills/git-master/SKILL.md +24 -19
  30. package/skills/read-only-explorer/SKILL.md +26 -21
  31. package/skills/safe-bash/SKILL.md +21 -16
  32. package/skills/task-packet/SKILL.md +28 -23
  33. package/skills/verify-evidence/SKILL.md +27 -22
  34. package/src/agents/agent-serializer.ts +34 -34
  35. package/src/agents/discover-agents.ts +102 -102
  36. package/src/config/config.ts +14 -1
  37. package/src/config/defaults.ts +3 -2
  38. package/src/extension/cross-extension-rpc.ts +82 -82
  39. package/src/extension/import-index.ts +4 -3
  40. package/src/extension/management.ts +2 -2
  41. package/src/extension/project-init.ts +9 -7
  42. package/src/extension/register.ts +63 -0
  43. package/src/extension/registration/artifact-cleanup.ts +15 -14
  44. package/src/extension/registration/commands.ts +208 -208
  45. package/src/extension/registration/compaction-guard.ts +125 -0
  46. package/src/extension/registration/subagent-tools.ts +27 -8
  47. package/src/extension/registration/team-tool.ts +61 -44
  48. package/src/extension/result-watcher.ts +98 -98
  49. package/src/extension/run-import.ts +4 -4
  50. package/src/extension/run-index.ts +14 -14
  51. package/src/extension/run-maintenance.ts +24 -24
  52. package/src/extension/team-tool/api.ts +3 -0
  53. package/src/extension/team-tool/cancel.ts +31 -31
  54. package/src/extension/team-tool/doctor.ts +179 -178
  55. package/src/extension/team-tool/inspect.ts +41 -41
  56. package/src/extension/team-tool/lifecycle-actions.ts +79 -79
  57. package/src/extension/team-tool/plan.ts +19 -19
  58. package/src/extension/team-tool/status.ts +73 -73
  59. package/src/prompt/prompt-runtime.ts +68 -68
  60. package/src/runtime/agent-control.ts +64 -64
  61. package/src/runtime/agent-memory.ts +72 -72
  62. package/src/runtime/agent-observability.ts +113 -113
  63. package/src/runtime/async-marker.ts +26 -26
  64. package/src/runtime/background-runner.ts +53 -53
  65. package/src/runtime/crew-agent-runtime.ts +58 -58
  66. package/src/runtime/direct-run.ts +35 -35
  67. package/src/runtime/foreground-control.ts +82 -82
  68. package/src/runtime/green-contract.ts +46 -46
  69. package/src/runtime/group-join.ts +88 -88
  70. package/src/runtime/live-agent-control.ts +78 -78
  71. package/src/runtime/live-agent-manager.ts +85 -85
  72. package/src/runtime/live-control-realtime.ts +36 -36
  73. package/src/runtime/live-session-runtime.ts +299 -299
  74. package/src/runtime/manifest-cache.ts +212 -214
  75. package/src/runtime/model-fallback.ts +261 -261
  76. package/src/runtime/parallel-research.ts +44 -44
  77. package/src/runtime/parallel-utils.ts +99 -99
  78. package/src/runtime/pi-json-output.ts +111 -111
  79. package/src/runtime/pi-spawn.ts +96 -96
  80. package/src/runtime/policy-engine.ts +78 -78
  81. package/src/runtime/post-exit-stdio-guard.ts +86 -86
  82. package/src/runtime/process-status.ts +56 -56
  83. package/src/runtime/progress-event-coalescer.ts +43 -43
  84. package/src/runtime/recovery-recipes.ts +74 -74
  85. package/src/runtime/role-permission.ts +39 -39
  86. package/src/runtime/session-usage.ts +79 -79
  87. package/src/runtime/sidechain-output.ts +28 -28
  88. package/src/runtime/subagent-manager.ts +29 -2
  89. package/src/runtime/task-display.ts +38 -38
  90. package/src/runtime/task-output-context.ts +106 -106
  91. package/src/runtime/task-packet.ts +84 -84
  92. package/src/runtime/task-runner/live-executor.ts +98 -98
  93. package/src/runtime/task-runner/progress.ts +111 -111
  94. package/src/runtime/task-runner/prompt-builder.ts +72 -72
  95. package/src/runtime/task-runner/result-utils.ts +14 -14
  96. package/src/runtime/task-runner/state-helpers.ts +22 -22
  97. package/src/runtime/worker-heartbeat.ts +21 -21
  98. package/src/runtime/worker-startup.ts +57 -57
  99. package/src/schema/config-schema.ts +12 -0
  100. package/src/schema/team-tool-schema.ts +100 -100
  101. package/src/state/artifact-store.ts +108 -108
  102. package/src/state/contracts.ts +105 -105
  103. package/src/state/jsonl-writer.ts +77 -77
  104. package/src/state/state-store.ts +8 -9
  105. package/src/state/task-claims.ts +42 -42
  106. package/src/state/types.ts +180 -180
  107. package/src/state/usage.ts +29 -29
  108. package/src/subagents/async-entry.ts +1 -1
  109. package/src/subagents/index.ts +3 -3
  110. package/src/subagents/live/control.ts +1 -1
  111. package/src/subagents/live/manager.ts +1 -1
  112. package/src/subagents/live/realtime.ts +1 -1
  113. package/src/subagents/live/session-runtime.ts +1 -1
  114. package/src/subagents/manager.ts +1 -1
  115. package/src/subagents/spawn.ts +1 -1
  116. package/src/teams/discover-teams.ts +2 -2
  117. package/src/teams/team-serializer.ts +36 -36
  118. package/src/types/diff.d.ts +18 -0
  119. package/src/ui/crew-footer.ts +101 -101
  120. package/src/ui/crew-select-list.ts +111 -111
  121. package/src/ui/crew-widget.ts +285 -285
  122. package/src/ui/dynamic-border.ts +25 -25
  123. package/src/ui/layout-primitives.ts +106 -106
  124. package/src/ui/loaders.ts +158 -158
  125. package/src/ui/mascot.ts +441 -441
  126. package/src/ui/powerbar-publisher.ts +94 -94
  127. package/src/ui/render-diff.ts +119 -119
  128. package/src/ui/run-dashboard.ts +372 -372
  129. package/src/ui/status-colors.ts +54 -54
  130. package/src/ui/syntax-highlight.ts +116 -116
  131. package/src/ui/transcript-viewer.ts +302 -302
  132. package/src/utils/completion-dedupe.ts +63 -63
  133. package/src/utils/file-coalescer.ts +84 -84
  134. package/src/utils/frontmatter.ts +36 -36
  135. package/src/utils/fs-watch.ts +31 -31
  136. package/src/utils/git.ts +262 -262
  137. package/src/utils/ids.ts +12 -12
  138. package/src/utils/names.ts +26 -26
  139. package/src/utils/paths.ts +34 -7
  140. package/src/utils/sleep.ts +32 -32
  141. package/src/utils/timings.ts +31 -31
  142. package/src/utils/visual.ts +159 -159
  143. package/src/workflows/discover-workflows.ts +2 -2
  144. package/src/workflows/validate-workflow.ts +40 -40
  145. package/src/worktree/branch-freshness.ts +45 -45
  146. package/src/worktree/cleanup.ts +71 -69
  147. package/src/worktree/worktree-manager.ts +3 -1
  148. package/teams/default.team.md +12 -12
  149. package/teams/fast-fix.team.md +11 -11
  150. package/teams/implementation.team.md +18 -18
  151. package/teams/parallel-research.team.md +14 -14
  152. package/teams/research.team.md +11 -11
  153. package/teams/review.team.md +12 -12
  154. package/workflows/default.workflow.md +29 -29
  155. package/workflows/fast-fix.workflow.md +22 -22
  156. package/workflows/implementation.workflow.md +38 -38
  157. package/workflows/parallel-research.workflow.md +46 -46
  158. package/workflows/research.workflow.md +22 -22
  159. package/workflows/review.workflow.md +30 -30
@@ -1,63 +1,63 @@
1
- interface CompletionDataLike {
2
- id?: unknown;
3
- agent?: unknown;
4
- timestamp?: unknown;
5
- sessionId?: unknown;
6
- taskIndex?: unknown;
7
- totalTasks?: unknown;
8
- success?: unknown;
9
- }
10
-
11
- function asNonEmptyString(value: unknown): string | undefined {
12
- if (typeof value !== "string") return undefined;
13
- const trimmed = value.trim();
14
- return trimmed.length > 0 ? trimmed : undefined;
15
- }
16
-
17
- function asFiniteNumber(value: unknown): number | undefined {
18
- if (typeof value !== "number") return undefined;
19
- return Number.isFinite(value) ? value : undefined;
20
- }
21
-
22
- export function buildCompletionKey(data: CompletionDataLike, fallback: string): string {
23
- const id = asNonEmptyString(data.id);
24
- if (id) return `id:${id}`;
25
- const sessionId = asNonEmptyString(data.sessionId) ?? "no-session";
26
- const agent = asNonEmptyString(data.agent) ?? "unknown";
27
- const timestamp = asFiniteNumber(data.timestamp);
28
- const taskIndex = asFiniteNumber(data.taskIndex);
29
- const totalTasks = asFiniteNumber(data.totalTasks);
30
- const success = typeof data.success === "boolean" ? (data.success ? "1" : "0") : "?";
31
- return [
32
- "meta",
33
- sessionId,
34
- agent,
35
- timestamp !== undefined ? String(timestamp) : "no-ts",
36
- taskIndex !== undefined ? String(taskIndex) : "-",
37
- totalTasks !== undefined ? String(totalTasks) : "-",
38
- success,
39
- fallback,
40
- ].join(":");
41
- }
42
-
43
- export function pruneSeenMap(seen: Map<string, number>, now: number, ttlMs: number): void {
44
- for (const [key, ts] of seen.entries()) {
45
- if (now - ts > ttlMs) seen.delete(key);
46
- }
47
- }
48
-
49
- export function markSeenWithTtl(seen: Map<string, number>, key: string, now: number, ttlMs: number): boolean {
50
- pruneSeenMap(seen, now, ttlMs);
51
- if (seen.has(key)) return true;
52
- seen.set(key, now);
53
- return false;
54
- }
55
-
56
- export function getGlobalSeenMap(storeKey: string): Map<string, number> {
57
- const globalStore = globalThis as Record<string, unknown>;
58
- const existing = globalStore[storeKey];
59
- if (existing instanceof Map) return existing as Map<string, number>;
60
- const map = new Map<string, number>();
61
- globalStore[storeKey] = map;
62
- return map;
63
- }
1
+ interface CompletionDataLike {
2
+ id?: unknown;
3
+ agent?: unknown;
4
+ timestamp?: unknown;
5
+ sessionId?: unknown;
6
+ taskIndex?: unknown;
7
+ totalTasks?: unknown;
8
+ success?: unknown;
9
+ }
10
+
11
+ function asNonEmptyString(value: unknown): string | undefined {
12
+ if (typeof value !== "string") return undefined;
13
+ const trimmed = value.trim();
14
+ return trimmed.length > 0 ? trimmed : undefined;
15
+ }
16
+
17
+ function asFiniteNumber(value: unknown): number | undefined {
18
+ if (typeof value !== "number") return undefined;
19
+ return Number.isFinite(value) ? value : undefined;
20
+ }
21
+
22
+ export function buildCompletionKey(data: CompletionDataLike, fallback: string): string {
23
+ const id = asNonEmptyString(data.id);
24
+ if (id) return `id:${id}`;
25
+ const sessionId = asNonEmptyString(data.sessionId) ?? "no-session";
26
+ const agent = asNonEmptyString(data.agent) ?? "unknown";
27
+ const timestamp = asFiniteNumber(data.timestamp);
28
+ const taskIndex = asFiniteNumber(data.taskIndex);
29
+ const totalTasks = asFiniteNumber(data.totalTasks);
30
+ const success = typeof data.success === "boolean" ? (data.success ? "1" : "0") : "?";
31
+ return [
32
+ "meta",
33
+ sessionId,
34
+ agent,
35
+ timestamp !== undefined ? String(timestamp) : "no-ts",
36
+ taskIndex !== undefined ? String(taskIndex) : "-",
37
+ totalTasks !== undefined ? String(totalTasks) : "-",
38
+ success,
39
+ fallback,
40
+ ].join(":");
41
+ }
42
+
43
+ export function pruneSeenMap(seen: Map<string, number>, now: number, ttlMs: number): void {
44
+ for (const [key, ts] of seen.entries()) {
45
+ if (now - ts > ttlMs) seen.delete(key);
46
+ }
47
+ }
48
+
49
+ export function markSeenWithTtl(seen: Map<string, number>, key: string, now: number, ttlMs: number): boolean {
50
+ pruneSeenMap(seen, now, ttlMs);
51
+ if (seen.has(key)) return true;
52
+ seen.set(key, now);
53
+ return false;
54
+ }
55
+
56
+ export function getGlobalSeenMap(storeKey: string): Map<string, number> {
57
+ const globalStore = globalThis as Record<string, unknown>;
58
+ const existing = globalStore[storeKey];
59
+ if (existing instanceof Map) return existing as Map<string, number>;
60
+ const map = new Map<string, number>();
61
+ globalStore[storeKey] = map;
62
+ return map;
63
+ }
@@ -1,84 +1,84 @@
1
- import * as fs from "node:fs";
2
-
3
- interface TimerApi {
4
- setTimeout(handler: () => void, delayMs: number): unknown;
5
- clearTimeout(handle: unknown): void;
6
- }
7
-
8
- const defaultTimerApi: TimerApi = {
9
- setTimeout: (handler, delayMs) => setTimeout(handler, delayMs),
10
- clearTimeout: (handle) => clearTimeout(handle as ReturnType<typeof setTimeout>),
11
- };
12
-
13
- export interface FileCoalescer {
14
- schedule(file: string, delayMs?: number): boolean;
15
- clear(): void;
16
- }
17
-
18
- export function createFileCoalescer(handler: (file: string) => void, defaultDelayMs: number, timerApi: TimerApi = defaultTimerApi): FileCoalescer {
19
- const pending = new Map<string, unknown>();
20
- return {
21
- schedule(file, delayMs = defaultDelayMs) {
22
- if (pending.has(file)) return false;
23
- const timer = timerApi.setTimeout(() => {
24
- pending.delete(file);
25
- handler(file);
26
- }, delayMs);
27
- pending.set(file, timer);
28
- return true;
29
- },
30
- clear() {
31
- for (const timer of pending.values()) timerApi.clearTimeout(timer);
32
- pending.clear();
33
- },
34
- };
35
- }
36
-
37
- interface ReadCacheEntry<T> {
38
- value: T;
39
- mtimeMs: number;
40
- size: number;
41
- expiresAt: number;
42
- }
43
-
44
- const readCache = new Map<string, ReadCacheEntry<unknown>>();
45
- const readCacheSizeLimit = 128;
46
-
47
- function evictOldestCacheEntry(): void {
48
- if (readCache.size < readCacheSizeLimit) return;
49
- const oldestKey = readCache.keys().next().value;
50
- if (oldestKey !== undefined) {
51
- readCache.delete(oldestKey);
52
- }
53
- }
54
-
55
- export function clearReadCache(): void {
56
- readCache.clear();
57
- }
58
-
59
- export function readJsonFileCoalesced<T>(filePath: string, ttlMs: number, read: () => T): T {
60
- const now = Date.now();
61
- const stat = (() => {
62
- try {
63
- const fileStat = fs.statSync(filePath);
64
- return { mtimeMs: fileStat.mtimeMs, size: fileStat.size };
65
- } catch {
66
- return undefined;
67
- }
68
- })();
69
- const cached = readCache.get(filePath);
70
- if (cached && stat && cached.expiresAt > now && cached.mtimeMs === stat.mtimeMs && cached.size === stat.size) {
71
- return cached.value as T;
72
- }
73
- const value = read();
74
- if (stat !== undefined) {
75
- readCache.set(filePath, {
76
- value,
77
- mtimeMs: stat.mtimeMs,
78
- size: stat.size,
79
- expiresAt: now + ttlMs,
80
- });
81
- evictOldestCacheEntry();
82
- }
83
- return value;
84
- }
1
+ import * as fs from "node:fs";
2
+
3
+ interface TimerApi {
4
+ setTimeout(handler: () => void, delayMs: number): unknown;
5
+ clearTimeout(handle: unknown): void;
6
+ }
7
+
8
+ const defaultTimerApi: TimerApi = {
9
+ setTimeout: (handler, delayMs) => setTimeout(handler, delayMs),
10
+ clearTimeout: (handle) => clearTimeout(handle as ReturnType<typeof setTimeout>),
11
+ };
12
+
13
+ export interface FileCoalescer {
14
+ schedule(file: string, delayMs?: number): boolean;
15
+ clear(): void;
16
+ }
17
+
18
+ export function createFileCoalescer(handler: (file: string) => void, defaultDelayMs: number, timerApi: TimerApi = defaultTimerApi): FileCoalescer {
19
+ const pending = new Map<string, unknown>();
20
+ return {
21
+ schedule(file, delayMs = defaultDelayMs) {
22
+ if (pending.has(file)) return false;
23
+ const timer = timerApi.setTimeout(() => {
24
+ pending.delete(file);
25
+ handler(file);
26
+ }, delayMs);
27
+ pending.set(file, timer);
28
+ return true;
29
+ },
30
+ clear() {
31
+ for (const timer of pending.values()) timerApi.clearTimeout(timer);
32
+ pending.clear();
33
+ },
34
+ };
35
+ }
36
+
37
+ interface ReadCacheEntry<T> {
38
+ value: T;
39
+ mtimeMs: number;
40
+ size: number;
41
+ expiresAt: number;
42
+ }
43
+
44
+ const readCache = new Map<string, ReadCacheEntry<unknown>>();
45
+ const readCacheSizeLimit = 128;
46
+
47
+ function evictOldestCacheEntry(): void {
48
+ if (readCache.size < readCacheSizeLimit) return;
49
+ const oldestKey = readCache.keys().next().value;
50
+ if (oldestKey !== undefined) {
51
+ readCache.delete(oldestKey);
52
+ }
53
+ }
54
+
55
+ export function clearReadCache(): void {
56
+ readCache.clear();
57
+ }
58
+
59
+ export function readJsonFileCoalesced<T>(filePath: string, ttlMs: number, read: () => T): T {
60
+ const now = Date.now();
61
+ const stat = (() => {
62
+ try {
63
+ const fileStat = fs.statSync(filePath);
64
+ return { mtimeMs: fileStat.mtimeMs, size: fileStat.size };
65
+ } catch {
66
+ return undefined;
67
+ }
68
+ })();
69
+ const cached = readCache.get(filePath);
70
+ if (cached && stat && cached.expiresAt > now && cached.mtimeMs === stat.mtimeMs && cached.size === stat.size) {
71
+ return cached.value as T;
72
+ }
73
+ const value = read();
74
+ if (stat !== undefined) {
75
+ readCache.set(filePath, {
76
+ value,
77
+ mtimeMs: stat.mtimeMs,
78
+ size: stat.size,
79
+ expiresAt: now + ttlMs,
80
+ });
81
+ evictOldestCacheEntry();
82
+ }
83
+ return value;
84
+ }
@@ -1,36 +1,36 @@
1
- export interface ParsedFrontmatter {
2
- frontmatter: Record<string, string>;
3
- body: string;
4
- }
5
-
6
- export function parseFrontmatter(content: string): ParsedFrontmatter {
7
- if (!content.startsWith("---\n") && !content.startsWith("---\r\n")) {
8
- return { frontmatter: {}, body: content };
9
- }
10
-
11
- const normalized = content.replaceAll("\r\n", "\n");
12
- const end = normalized.indexOf("\n---\n", 4);
13
- if (end === -1) return { frontmatter: {}, body: content };
14
-
15
- const raw = normalized.slice(4, end);
16
- const body = normalized.slice(end + "\n---\n".length);
17
- const frontmatter: Record<string, string> = {};
18
-
19
- for (const line of raw.split("\n")) {
20
- const trimmed = line.trim();
21
- if (!trimmed || trimmed.startsWith("#")) continue;
22
- const separator = trimmed.indexOf(":");
23
- if (separator === -1) continue;
24
- const key = trimmed.slice(0, separator).trim();
25
- const value = trimmed.slice(separator + 1).trim();
26
- if (key) frontmatter[key] = value;
27
- }
28
-
29
- return { frontmatter, body };
30
- }
31
-
32
- export function parseCsv(value: string | undefined): string[] | undefined {
33
- if (value === undefined) return undefined;
34
- const values = value.split(",").map((item) => item.trim()).filter(Boolean);
35
- return values.length > 0 ? [...new Set(values)] : undefined;
36
- }
1
+ export interface ParsedFrontmatter {
2
+ frontmatter: Record<string, string>;
3
+ body: string;
4
+ }
5
+
6
+ export function parseFrontmatter(content: string): ParsedFrontmatter {
7
+ if (!content.startsWith("---\n") && !content.startsWith("---\r\n")) {
8
+ return { frontmatter: {}, body: content };
9
+ }
10
+
11
+ const normalized = content.replaceAll("\r\n", "\n");
12
+ const end = normalized.indexOf("\n---\n", 4);
13
+ if (end === -1) return { frontmatter: {}, body: content };
14
+
15
+ const raw = normalized.slice(4, end);
16
+ const body = normalized.slice(end + "\n---\n".length);
17
+ const frontmatter: Record<string, string> = {};
18
+
19
+ for (const line of raw.split("\n")) {
20
+ const trimmed = line.trim();
21
+ if (!trimmed || trimmed.startsWith("#")) continue;
22
+ const separator = trimmed.indexOf(":");
23
+ if (separator === -1) continue;
24
+ const key = trimmed.slice(0, separator).trim();
25
+ const value = trimmed.slice(separator + 1).trim();
26
+ if (key) frontmatter[key] = value;
27
+ }
28
+
29
+ return { frontmatter, body };
30
+ }
31
+
32
+ export function parseCsv(value: string | undefined): string[] | undefined {
33
+ if (value === undefined) return undefined;
34
+ const values = value.split(",").map((item) => item.trim()).filter(Boolean);
35
+ return values.length > 0 ? [...new Set(values)] : undefined;
36
+ }
@@ -1,31 +1,31 @@
1
- import * as fs from "node:fs";
2
- import type { FSWatcher, WatchListener } from "node:fs";
3
-
4
- export const FS_WATCH_RETRY_DELAY_MS = 5000;
5
-
6
- export function closeWatcher(watcher: FSWatcher | null | undefined): void {
7
- if (!watcher) {
8
- return;
9
- }
10
-
11
- try {
12
- watcher.close();
13
- } catch {
14
- // Ignore watcher close errors
15
- }
16
- }
17
-
18
- export function watchWithErrorHandler(
19
- path: string,
20
- listener: WatchListener<string>,
21
- onError: () => void,
22
- ): FSWatcher | null {
23
- try {
24
- const watcher = fs.watch(path, listener);
25
- watcher.on("error", onError);
26
- return watcher;
27
- } catch {
28
- onError();
29
- return null;
30
- }
31
- }
1
+ import * as fs from "node:fs";
2
+ import type { FSWatcher, WatchListener } from "node:fs";
3
+
4
+ export const FS_WATCH_RETRY_DELAY_MS = 5000;
5
+
6
+ export function closeWatcher(watcher: FSWatcher | null | undefined): void {
7
+ if (!watcher) {
8
+ return;
9
+ }
10
+
11
+ try {
12
+ watcher.close();
13
+ } catch {
14
+ // Ignore watcher close errors
15
+ }
16
+ }
17
+
18
+ export function watchWithErrorHandler(
19
+ path: string,
20
+ listener: WatchListener<string>,
21
+ onError: () => void,
22
+ ): FSWatcher | null {
23
+ try {
24
+ const watcher = fs.watch(path, listener);
25
+ watcher.on("error", onError);
26
+ return watcher;
27
+ } catch {
28
+ onError();
29
+ return null;
30
+ }
31
+ }