/*
<MODULE_CONTRACT>
<purpose>RFC-0825: Shared TypeScript types for the post-deploy smoke testing system.
Lives in the engine package so both engine and site plugin can import without
cross-package violations (DNA-64).</purpose>


<non-goals>
  <item>Do not implement smoke runner logic — that lives in @warpgogol/werkstatt-site.</item>
  <item>Do not import stack-specific dependencies.</item>
</non-goals>
</MODULE_CONTRACT>
<CHANGE_SUMMARY>
  <item>RFC-0825: initial smoke testing type contracts.</item>
  <item>RFC-1097: step 6 — compass.migrate codemod run

Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
  <item>RFC-1097: sweep — werkstatt-engine clean

Sweep batch 4: 73 Compass headers on headerless engine files (certification, component-runtime, isolation, evolution, testing), real KEY_DECISIONS on 75 files (kernel, cache, dht, swim, gitmesh, runtime), ~80 purpose expansions (CONTRACT-02/PURPOSE-02), non-goals on 13 CONTRACT-03 files, CS-07 history literal fix repo-wide (253 files). Policy: .template.ts/.template.astro excludedPaths. werkstatt-engine now 0 diagnostics.</item>
</CHANGE_SUMMARY>
*/

export interface SmokeEndpoint {
  path: string;
  method?: "GET" | "POST" | "HEAD";
  body?: Record<string, unknown>;
  contentType?: string;
  expectStatus: number;
  expectBodyContains?: string;
  timeoutMs: number;
}

export interface SmokeRunInput {
  service?: string;
  site?: string;
  url?: string;
  json?: boolean;
}

export interface SmokeCheckResult {
  path: string;
  method: string;
  status: number | null;
  passed: boolean;
  error?: string;
  durationMs: number;
}

export interface SmokeRunResult {
  command: "service.smoke.run" | "site.smoke.run";
  status: "pass" | "fail";
  targetId: string;
  url: string;
  checks: SmokeCheckResult[];
  durationMs: number;
}

export interface SmokeEvidence {
  smokeResult: SmokeRunResult;
  recordedAt: string;
}