From 4e31e8dd4c08d3a7566edf0d8dc3b841ce8ec903 Mon Sep 17 00:00:00 2001 From: A <258483684+la14-1@users.noreply.github.com> Date: Wed, 18 Mar 2026 07:01:19 -0700 Subject: [PATCH] docs(tests): document 5 undocumented test files in README (#2762) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Added missing entries to packages/cli/src/__tests__/README.md for: - auto-update.test.ts — setupAutoUpdate systemd service unit generation - kill-with-timeout.test.ts — killWithTimeout SIGKILL grace period logic - shell.test.ts — platform-aware shell detection utilities - digitalocean-token.test.ts — DigitalOcean token storage and API helpers - hetzner-pagination.test.ts — Hetzner API multi-page pagination All 1467 tests pass. No code changes. -- qa/code-quality Co-authored-by: spawn-qa-bot --- packages/cli/src/__tests__/README.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/packages/cli/src/__tests__/README.md b/packages/cli/src/__tests__/README.md index c9a5556f..0c4fe610 100644 --- a/packages/cli/src/__tests__/README.md +++ b/packages/cli/src/__tests__/README.md @@ -63,8 +63,11 @@ bun test src/__tests__/manifest.test.ts - `paths.test.ts` — `getSpawnDir`, `getCacheDir`, `getHistoryPath`, `getSshDir`, path resolution - `ssh-keys.test.ts` — SSH key discovery, generation, fingerprinting - `update-check.test.ts` — Auto-update check logic +- `auto-update.test.ts` — `setupAutoUpdate`: systemd service unit generation and orchestration integration +- `kill-with-timeout.test.ts` — `killWithTimeout`: SIGKILL after grace period, already-exited process handling - `with-retry-result.test.ts` — `withRetry`, `wrapSshCall`, Result constructors - `orchestrate.test.ts` — `runOrchestration` +- `shell.test.ts` — `getLocalShell`, `isWindows`, `getInstallCmd`, `getWhichCommand`, `getInstallScriptUrl`: platform-aware shell detection - `fs-sandbox.test.ts` — Guardrail: verifies test preload sandbox isolates filesystem writes ### Parsing and type utilities @@ -87,8 +90,10 @@ bun test src/__tests__/manifest.test.ts - `check-entity.test.ts` / `check-entity-messages.test.ts` — Entity validation - `agent-tarball.test.ts` — `tryTarballInstall`: GitHub Release tarball install, fallback, URL validation - `gateway-resilience.test.ts` — `startGateway` systemd unit with auto-restart and cron heartbeat +- `digitalocean-token.test.ts` — DigitalOcean token storage, retrieval, and API client helpers - `do-payment-warning.test.ts` — `ensureDoToken` proactive payment method reminder for first-time DigitalOcean users - `do-snapshot.test.ts` — `findSpawnSnapshot`: DigitalOcean snapshot lookup, filtering, error handling +- `hetzner-pagination.test.ts` — Hetzner API pagination: multi-page server listing and cursor handling - `sprite-keep-alive.test.ts` — `installSpriteKeepAlive` download/install, graceful failure, session script wrapping - `ui-utils.test.ts` — `validateServerName`, `validateRegionName`, `toKebabCase`, `sanitizeTermValue`, `jsonEscape` - `gcp-shellquote.test.ts` — `shellQuote` GCP-specific quoting edge cases