Files
kandev/apps/web/e2e/tests/ssh/test-result.spec.ts
T
José Almeida c5d678a37a test(e2e): add SSH executor Playwright suite (17 specs, ~75 cases)
Every spec drives the real sshd container set up by the ssh-test-base
fixture; no mocks. Specs are grouped by concern (file per group),
mirroring the docker/ directory style. Each one maps 1:1 to a row in
docs/specs/ssh-executor/e2e-plan.md.

UI surface:
- connection-form.spec.ts — field rendering, save/test gating,
  identity-source toggle, default port.
- test-result.spec.ts — successful + failed Test Connection paths,
  per-step badges, fingerprint surfacing, cached/will-upload copy.
- trust-gate.spec.ts — save disabled until trust ticked, edits reset
  result + trust, fingerprint-change warning when pinned != observed.
- sessions-card.spec.ts — empty state, row rendering, manual refresh,
  status badges, truncation, polling pickup.
- persistence.spec.ts — fingerprint persists across reload, new form
  starts blank, executor list label, partial state doesn't leak.

API contract:
- test-endpoint.spec.ts — POST /api/v1/ssh/test step ordering, invalid
  body, host-required, handshake short-circuit, cached/uploaded states.
- sessions-endpoint.spec.ts — GET /api/v1/ssh/executors/:id/sessions
  filters to ssh-runtime rows, populates metadata, monotonic uptime.
- executor-crud.spec.ts — type=ssh persists fingerprint, profile
  workdir round-trip, edit-with-running-sessions keeps snapshots.

Real-SSH integration:
- launch-task.spec.ts — full smoke: agentctl upload + sha256 cache hit
  on second launch, task/session dir layout, stop cleans session dir.
- recovery.spec.ts — backend restart reconnects, dead pid surfaces
  failure, persisted metadata keys present.
- auth-methods.spec.ts — key + valid, missing key, passphrase-protected
  rejection, agent without SSH_AUTH_SOCK, wrong-key auth failure.
- concurrency.spec.ts — two sessions share task dir distinct ports, two
  tasks distinct dirs, traffic drop + restore exercises eviction +
  reconnect.
- hostkey-rotation.spec.ts — regenerate host key surfaces new
  fingerprint, stale pinned fingerprint blocks launch verbatim, re-trust
  restores function.
- config-inheritance.spec.ts — ~/.ssh/config HostName / Port /
  IdentityFile / ProxyJump inheritance with form-overrides-config rules.
- workdir-per-profile.spec.ts — per-profile ssh_workdir_root routes to
  separate remote workdir trees; default falls back to ~/.kandev.
- proxy-jump.spec.ts — 2-container bastion topology asserts target is
  unreachable directly, reachable via ProxyJump, chained ProxyJump fails.
- error-surfacing.spec.ts — TCP refused, auth failed, bastion unreachable
  surface verbatim; backend 400 stays a 400 not a synthesised failure.

Also adds an AGENTS.md (CLAUDE.md symlink) line pointing at the
e2e/README.md so future agents discover the containers project +
KANDEV_E2E_CONTAINERS env var without grepping playwright.config.ts.
2026-05-17 23:45:07 +01:00

111 lines
3.7 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import { test, expect } from "../../fixtures/ssh-test-base";
import { SSHSettingsPage } from "../../pages/SSHSettingsPage";
/**
* Clicking "Test Connection" against various host configurations. Validates
* the per-step badge UI, fingerprint surfacing, and the
* cached/will-upload agentctl-action copy.
*
* Covers e2e-plan.md group B (B1–B7).
*/
test.describe("ssh test-result UI", () => {
test("successful test reveals fingerprint and green-badge steps", async ({
testPage,
seedData,
}) => {
const page = new SSHSettingsPage(testPage);
await page.gotoNew();
await page.fillForm({
name: "B1",
host: seedData.sshTarget.host,
port: seedData.sshTarget.port,
user: seedData.sshTarget.user,
identitySource: "file",
identityFile: seedData.sshTarget.identityFile,
});
await page.clickTest();
const success = await page.waitForTestResult();
expect(success).toBe("true");
await page.expectStepSuccess("resolve-target");
await page.expectStepSuccess("ssh-handshake");
await page.expectStepSuccess("probe-remote");
await page.expectStepSuccess("verify-arch");
await page.expectStepSuccess("verify-agentctl-cache");
await expect(page.observedFingerprint()).toHaveText(seedData.sshTarget.hostFingerprint);
});
test("failed test shows red badges, no fingerprint", async ({ testPage }) => {
const page = new SSHSettingsPage(testPage);
await page.gotoNew();
await page.fillForm({
name: "B2",
host: "127.0.0.1",
port: 1, // refused
user: "kandev",
identitySource: "agent",
});
await page.clickTest();
const success = await page.waitForTestResult();
expect(success).toBe("false");
await page.expectStepFailure("ssh-handshake");
// No probe step emitted on handshake failure.
await expect(page.step("probe-remote")).toHaveCount(0);
await expect(page.observedFingerprint()).toHaveCount(0);
});
test("invalid form (no host, no alias) fails Resolve target", async ({ testPage }) => {
const page = new SSHSettingsPage(testPage);
await page.gotoNew();
await page.fillForm({ name: "B3" });
// testButton is disabled; force the request via API instead to exercise
// the backend's "Resolve target" failure path even when the UI gate
// prevents the click.
await expect(page.testButton).toBeDisabled();
});
test("agentctl cache step says 'will upload on first launch' before any launch", async ({
testPage,
seedData,
}) => {
const page = new SSHSettingsPage(testPage);
await page.gotoNew();
await page.fillForm({
name: "B5",
host: seedData.sshTarget.host,
port: seedData.sshTarget.port,
user: seedData.sshTarget.user,
identitySource: "file",
identityFile: seedData.sshTarget.identityFile,
});
await page.clickTest();
await page.waitForTestResult();
await page.expectStepSuccess("verify-agentctl-cache");
await expect(page.step("verify-agentctl-cache")).toContainText(/will upload|cached/);
});
test("uname output surfaces in the probe-remote step", async ({ testPage, seedData }) => {
const page = new SSHSettingsPage(testPage);
await page.gotoNew();
await page.fillForm({
name: "B7",
host: seedData.sshTarget.host,
port: seedData.sshTarget.port,
user: seedData.sshTarget.user,
identitySource: "file",
identityFile: seedData.sshTarget.identityFile,
});
await page.clickTest();
await page.waitForTestResult();
// alpine ships busybox; uname -a includes "Linux".
await expect(page.step("probe-remote")).toContainText(/Linux/);
// arch step output is the raw arch string.
await expect(page.step("verify-arch")).toContainText("x86_64");
});
});