docs: document daemon tests

steipete · steipete · commit 5ba4eeceac72 · 2026-06-04T20:16:21.000-04:00
diff --git a/src/daemon/cmd-argv.test.ts b/src/daemon/cmd-argv.test.ts
@@ -1,3 +1,4 @@
+// Daemon command argv tests cover command argument construction.
 import { describe, expect, it } from "vitest";
 import { parseCmdScriptCommandLine, quoteCmdScriptArg } from "./cmd-argv.js";
 
diff --git a/src/daemon/constants.test.ts b/src/daemon/constants.test.ts
@@ -1,3 +1,4 @@
+// Daemon constant tests cover platform constants used by service installers.
 import { describe, expect, it } from "vitest";
 import {
   formatGatewayServiceDescription,
diff --git a/src/daemon/diagnostics.test.ts b/src/daemon/diagnostics.test.ts
@@ -1,3 +1,4 @@
+// Daemon diagnostics tests cover service diagnostic collection and formatting.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/src/daemon/inspect.test.ts b/src/daemon/inspect.test.ts
@@ -1,3 +1,4 @@
+// Daemon inspect tests cover service inspection and diagnostic output.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/src/daemon/launchd-current-service.test.ts b/src/daemon/launchd-current-service.test.ts
@@ -1,3 +1,4 @@
+// Launchd current service tests cover resolving active macOS service labels.
 import { describe, expect, it } from "vitest";
 import { isCurrentProcessLaunchdServiceLabel } from "./launchd-current-service.js";
 
diff --git a/src/daemon/launchd-restart-handoff.test.ts b/src/daemon/launchd-restart-handoff.test.ts
@@ -1,3 +1,4 @@
+// Launchd restart handoff tests cover restart coordination on macOS.
 import { afterEach, describe, expect, it, vi } from "vitest";
 
 const spawnMock = vi.hoisted(() => vi.fn());
diff --git a/src/daemon/launchd.integration.e2e.test.ts b/src/daemon/launchd.integration.e2e.test.ts
@@ -1,3 +1,4 @@
+// Launchd integration tests cover daemon CLI behavior in macOS-like scenarios.
 import { spawnSync } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import fs from "node:fs/promises";
diff --git a/src/daemon/launchd.test.ts b/src/daemon/launchd.test.ts
@@ -1,3 +1,4 @@
+// Launchd tests cover macOS service plist generation and command handling.
 import { PassThrough } from "node:stream";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { GATEWAY_SERVICE_KIND, GATEWAY_SERVICE_MARKER } from "./constants.js";
diff --git a/src/daemon/program-args.test.ts b/src/daemon/program-args.test.ts
@@ -1,3 +1,4 @@
+// Daemon program argument tests cover CLI argument construction for services.
 import path from "node:path";
 import { afterEach, describe, expect, it, vi } from "vitest";
 
diff --git a/src/daemon/restart-logs.test.ts b/src/daemon/restart-logs.test.ts
@@ -1,3 +1,4 @@
+// Daemon restart log tests cover restart log formatting and filtering.
 import { describe, expect, it } from "vitest";
 import {
   GATEWAY_RESTART_LOG_FILENAME,
diff --git a/src/daemon/runtime-binary.test.ts b/src/daemon/runtime-binary.test.ts
@@ -1,3 +1,4 @@
+// Daemon runtime binary tests cover runtime executable resolution.
 import { describe, expect, it } from "vitest";
 import { isBunRuntime, isNodeRuntime } from "./runtime-binary.js";
 
diff --git a/src/daemon/runtime-format.test.ts b/src/daemon/runtime-format.test.ts
@@ -1,3 +1,4 @@
+// Daemon runtime format tests cover formatted runtime command display.
 import { describe, expect, it } from "vitest";
 import { formatRuntimeStatus } from "./runtime-format.js";
 
diff --git a/src/daemon/runtime-hints.test.ts b/src/daemon/runtime-hints.test.ts
@@ -1,3 +1,4 @@
+// Daemon runtime hint tests cover platform-specific daemon guidance.
 import { describe, expect, it } from "vitest";
 import { buildPlatformRuntimeLogHints, buildPlatformServiceStartHints } from "./runtime-hints.js";
 
diff --git a/src/daemon/runtime-hints.windows-paths.test.ts b/src/daemon/runtime-hints.windows-paths.test.ts
@@ -1,3 +1,4 @@
+// Windows runtime hint tests cover path guidance for Windows daemon setup.
 import { beforeAll, describe, expect, it, vi } from "vitest";
 
 const resolveGatewayLogPathsMock = vi.fn(() => ({
diff --git a/src/daemon/runtime-paths.test.ts b/src/daemon/runtime-paths.test.ts
@@ -1,3 +1,4 @@
+// Daemon runtime path tests cover executable and config path resolution.
 import { afterEach, describe, expect, it, vi } from "vitest";
 
 const fsMocks = vi.hoisted(() => ({
diff --git a/src/daemon/schtasks-exec.test.ts b/src/daemon/schtasks-exec.test.ts
@@ -1,3 +1,4 @@
+// Windows schtasks exec tests cover scheduled task command execution.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { execSchtasks } from "./schtasks-exec.js";
 
diff --git a/src/daemon/schtasks.install.test.ts b/src/daemon/schtasks.install.test.ts
@@ -1,3 +1,4 @@
+// Windows schtasks install tests cover scheduled task installation behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/src/daemon/schtasks.startup-fallback.test.ts b/src/daemon/schtasks.startup-fallback.test.ts
@@ -1,3 +1,4 @@
+// Windows schtasks startup fallback tests cover fallback startup task behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { PassThrough } from "node:stream";
diff --git a/src/daemon/schtasks.stop.test.ts b/src/daemon/schtasks.stop.test.ts
@@ -1,3 +1,4 @@
+// Windows schtasks stop tests cover stopping scheduled task services.
 import { PassThrough } from "node:stream";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import "./test-helpers/schtasks-base-mocks.js";
diff --git a/src/daemon/schtasks.test.ts b/src/daemon/schtasks.test.ts
@@ -1,3 +1,4 @@
+// Windows schtasks tests cover scheduled task service lifecycle behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/src/daemon/service-audit.test.ts b/src/daemon/service-audit.test.ts
@@ -1,3 +1,4 @@
+// Daemon service audit tests cover installed service inspection and warnings.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/src/daemon/service-env.test.ts b/src/daemon/service-env.test.ts
@@ -1,3 +1,4 @@
+// Daemon service env tests cover environment variable assembly for services.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/src/daemon/service.test.ts b/src/daemon/service.test.ts
@@ -1,3 +1,4 @@
+// Daemon service tests cover service install, start, stop, and status flows.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { afterEach, describe, expect, it, vi } from "vitest";
diff --git a/src/daemon/systemd-hints.test.ts b/src/daemon/systemd-hints.test.ts
@@ -1,3 +1,4 @@
+// Systemd hint tests cover Linux daemon setup guidance.
 import { describe, expect, it } from "vitest";
 import { formatCliCommand } from "../cli/command-format.js";
 import { isSystemdUnavailableDetail, renderSystemdUnavailableHints } from "./systemd-hints.js";
diff --git a/src/daemon/systemd-unavailable.test.ts b/src/daemon/systemd-unavailable.test.ts
@@ -1,3 +1,4 @@
+// Systemd unavailable tests cover fallback behavior when systemd is not present.
 import { describe, expect, it } from "vitest";
 import {
   classifySystemdUnavailableDetail,
diff --git a/src/daemon/systemd-unit.test.ts b/src/daemon/systemd-unit.test.ts
@@ -1,3 +1,4 @@
+// Systemd unit tests cover generated systemd unit files.
 import { describe, expect, it } from "vitest";
 import { buildSystemdUnit } from "./systemd-unit.js";
 
diff --git a/src/daemon/systemd.test.ts b/src/daemon/systemd.test.ts
@@ -1,3 +1,4 @@
+// Systemd tests cover Linux service install, start, stop, and status behavior.
 import type { ExecFileException, ExecFileOptionsWithStringEncoding } from "node:child_process";
 import fs from "node:fs/promises";
 import os from "node:os";

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+// Daemon command argv tests cover command argument construction.`
`1`	`2`	`import { describe, expect, it } from "vitest";`
`2`	`3`	`import { parseCmdScriptCommandLine, quoteCmdScriptArg } from "./cmd-argv.js";`
`3`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+// Daemon constant tests cover platform constants used by service installers.`
`1`	`2`	`import { describe, expect, it } from "vitest";`
`2`	`3`	`import {`
`3`	`4`	`formatGatewayServiceDescription,`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+// Daemon diagnostics tests cover service diagnostic collection and formatting.`
`1`	`2`	`import fs from "node:fs";`
`2`	`3`	`import os from "node:os";`
`3`	`4`	`import path from "node:path";`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+// Daemon inspect tests cover service inspection and diagnostic output.`
`1`	`2`	`import fs from "node:fs/promises";`
`2`	`3`	`import os from "node:os";`
`3`	`4`	`import path from "node:path";`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+// Launchd current service tests cover resolving active macOS service labels.`
`1`	`2`	`import { describe, expect, it } from "vitest";`
`2`	`3`	`import { isCurrentProcessLaunchdServiceLabel } from "./launchd-current-service.js";`
`3`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+// Launchd restart handoff tests cover restart coordination on macOS.`
`1`	`2`	`import { afterEach, describe, expect, it, vi } from "vitest";`
`2`	`3`
`3`	`4`	`const spawnMock = vi.hoisted(() => vi.fn());`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+// Launchd integration tests cover daemon CLI behavior in macOS-like scenarios.`
`1`	`2`	`import { spawnSync } from "node:child_process";`
`2`	`3`	`import { randomUUID } from "node:crypto";`
`3`	`4`	`import fs from "node:fs/promises";`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+// Launchd tests cover macOS service plist generation and command handling.`
`1`	`2`	`import { PassThrough } from "node:stream";`
`2`	`3`	`import { beforeEach, describe, expect, it, vi } from "vitest";`
`3`	`4`	`import { GATEWAY_SERVICE_KIND, GATEWAY_SERVICE_MARKER } from "./constants.js";`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+// Daemon program argument tests cover CLI argument construction for services.`
`1`	`2`	`import path from "node:path";`
`2`	`3`	`import { afterEach, describe, expect, it, vi } from "vitest";`
`3`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+// Daemon restart log tests cover restart log formatting and filtering.`
`1`	`2`	`import { describe, expect, it } from "vitest";`
`2`	`3`	`import {`
`3`	`4`	`GATEWAY_RESTART_LOG_FILENAME,`