@plune-ai/cli 0.17.0 → 0.17.1

package/dist/index.cjs

@@ -35,19 +35,22 @@ __export(src_exports, {
   SyncFileError: () => SyncFileError,
   SyncHttpError: () => SyncHttpError,
   SyncNetworkError: () => SyncNetworkError,
+  TEST_CASE_SCHEMA_VERSION: () => TEST_CASE_SCHEMA_VERSION,
   TokenRejectedError: () => TokenRejectedError,
   assertionConfigSchema: () => assertionConfigSchema,
-  assertionResultRecordSchema: () => assertionResultRecordSchema,
+  assertionResultRecordSchema: () => assertionResultRecordSchema2,
   binaryVerdictSchema: () => binaryVerdictSchema,
   formatIngestResult: () => formatIngestResult,
   ingest: () => handleIngest,
   parseRunResult: () => parseRunResult,
+  parseTestCase: () => parseTestCase,
   readCairnRun: () => readCairnRun,
   reportIngestFailure: () => reportIngestFailure,
   reportSyncFailure: () => reportSyncFailure,
   run: () => handleRun,
   runResultSchema: () => runResultSchema,
-  sync: () => handleSync
+  sync: () => handleSync,
+  testCaseSchema: () => testCaseSchema
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -1552,59 +1555,116 @@ var fs6 = __toESM(require("fs"), 1);
 var path5 = __toESM(require("path"), 1);
 
 // src/types/run-result-schema.ts
+var import_zod3 = require("zod");
+
+// src/types/test-case-schema.ts
 var import_zod2 = require("zod");
-var RUN_RESULT_SCHEMA_VERSION = 1;
-var binaryVerdictSchema = import_zod2.z.object({
-  question: import_zod2.z.string().min(1),
-  passed: import_zod2.z.boolean()
+var TEST_CASE_SCHEMA_VERSION = 2;
+var externalKeySchema = import_zod2.z.object({
+  kind: import_zod2.z.enum(["playwright-id", "path-title", "allure-history", "cairn-stable", "eval-id", "qase", "testrail"]),
+  value: import_zod2.z.string().min(1)
+});
+var manualStepSchema = import_zod2.z.object({
+  action: import_zod2.z.string().min(1),
+  expected: import_zod2.z.string().min(1).optional()
 });
 var assertionResultRecordSchema = import_zod2.z.object({
-  type: import_zod2.z.string(),
+  type: import_zod2.z.string().min(1),
   passed: import_zod2.z.boolean(),
   score: import_zod2.z.number().optional(),
-  reason: import_zod2.z.string().optional(),
-  binaryVerdicts: import_zod2.z.array(binaryVerdictSchema).optional()
+  reason: import_zod2.z.string().optional()
+});
+var manualCaseSchema = import_zod2.z.object({
+  type: import_zod2.z.literal("manual"),
+  steps: import_zod2.z.array(manualStepSchema).min(1),
+  expected: import_zod2.z.string().min(1).optional()
+});
+var automatedCaseSchema = import_zod2.z.object({
+  type: import_zod2.z.literal("automated"),
+  specRef: import_zod2.z.string().min(1)
+});
+var evalCaseSchema = import_zod2.z.object({
+  type: import_zod2.z.literal("eval"),
+  prompt: import_zod2.z.string().min(1),
+  goldenSetId: import_zod2.z.string().min(1).optional(),
+  assertions: import_zod2.z.array(assertionResultRecordSchema).min(1)
+});
+var testCaseBaseSchema = import_zod2.z.object({
+  schemaVersion: import_zod2.z.literal(TEST_CASE_SCHEMA_VERSION),
+  id: import_zod2.z.string().min(1),
+  externalKeys: import_zod2.z.array(externalKeySchema).optional(),
+  /** ADR 0045 / plune#1246 — optional, purely additive; schemaVersion stays 2. */
+  is_flaky: import_zod2.z.boolean().optional(),
+  /** ADR 0045 / plune#1246 — optional, purely additive; schemaVersion stays 2. */
+  is_muted: import_zod2.z.boolean().optional()
+});
+var testCaseSchema = import_zod2.z.discriminatedUnion("type", [
+  testCaseBaseSchema.merge(manualCaseSchema),
+  testCaseBaseSchema.merge(automatedCaseSchema),
+  testCaseBaseSchema.merge(evalCaseSchema)
+]);
+function parseTestCase(value) {
+  return testCaseSchema.parse(value);
+}
+
+// src/types/results.ts
+var ROW_INCONCLUSIVE = ["blocked", "skipped"];
+
+// src/types/run-result-schema.ts
+var RUN_RESULT_SCHEMA_VERSION = 1;
+var binaryVerdictSchema = import_zod3.z.object({
+  question: import_zod3.z.string().min(1),
+  passed: import_zod3.z.boolean()
+});
+var assertionResultRecordSchema2 = import_zod3.z.object({
+  type: import_zod3.z.string(),
+  passed: import_zod3.z.boolean(),
+  score: import_zod3.z.number().optional(),
+  reason: import_zod3.z.string().optional(),
+  binaryVerdicts: import_zod3.z.array(binaryVerdictSchema).optional()
 });
-var usageSchema = import_zod2.z.object({
-  input_tokens: import_zod2.z.number(),
-  output_tokens: import_zod2.z.number(),
-  cost_usd: import_zod2.z.number()
+var usageSchema = import_zod3.z.object({
+  input_tokens: import_zod3.z.number(),
+  output_tokens: import_zod3.z.number(),
+  cost_usd: import_zod3.z.number()
 });
-var runErrorSchema = import_zod2.z.object({
-  code: import_zod2.z.string(),
-  message: import_zod2.z.string()
+var runErrorSchema = import_zod3.z.object({
+  code: import_zod3.z.string(),
+  message: import_zod3.z.string()
 });
-var rowResultSchema = import_zod2.z.object({
-  vars: import_zod2.z.record(import_zod2.z.string(), import_zod2.z.unknown()),
-  output: import_zod2.z.string().nullable(),
-  cached: import_zod2.z.boolean(),
+var rowResultSchema = import_zod3.z.object({
+  vars: import_zod3.z.record(import_zod3.z.string(), import_zod3.z.unknown()),
+  output: import_zod3.z.string().nullable(),
+  cached: import_zod3.z.boolean(),
   usage: usageSchema.optional(),
-  latency_ms: import_zod2.z.number().optional(),
+  latency_ms: import_zod3.z.number().optional(),
   error: runErrorSchema.optional(),
-  assertions: import_zod2.z.array(assertionResultRecordSchema)
+  assertions: import_zod3.z.array(assertionResultRecordSchema2),
+  /** ADR 0045. Optional and additive — the same enum the platform validates on `POST /v1/runs`. */
+  inconclusive: import_zod3.z.enum(ROW_INCONCLUSIVE).optional()
 });
-var summarySchema = import_zod2.z.object({
-  total: import_zod2.z.number(),
-  passed: import_zod2.z.number(),
-  failed: import_zod2.z.number(),
-  errored: import_zod2.z.number(),
-  cost_usd: import_zod2.z.number(),
-  duration_ms: import_zod2.z.number()
+var summarySchema = import_zod3.z.object({
+  total: import_zod3.z.number(),
+  passed: import_zod3.z.number(),
+  failed: import_zod3.z.number(),
+  errored: import_zod3.z.number(),
+  cost_usd: import_zod3.z.number(),
+  duration_ms: import_zod3.z.number()
 });
-var evalResultSchema = import_zod2.z.object({
-  id: import_zod2.z.string(),
-  tags: import_zod2.z.array(import_zod2.z.string()),
-  rows: import_zod2.z.array(rowResultSchema),
-  passed: import_zod2.z.boolean()
+var evalResultSchema = import_zod3.z.object({
+  id: import_zod3.z.string(),
+  tags: import_zod3.z.array(import_zod3.z.string()),
+  rows: import_zod3.z.array(rowResultSchema),
+  passed: import_zod3.z.boolean()
 });
-var runResultSchema = import_zod2.z.object({
-  schemaVersion: import_zod2.z.literal(RUN_RESULT_SCHEMA_VERSION),
-  plune_version: import_zod2.z.string(),
-  started_at: import_zod2.z.string(),
-  finished_at: import_zod2.z.string(),
-  config_hash: import_zod2.z.string(),
+var runResultSchema = import_zod3.z.object({
+  schemaVersion: import_zod3.z.literal(RUN_RESULT_SCHEMA_VERSION),
+  plune_version: import_zod3.z.string(),
+  started_at: import_zod3.z.string(),
+  finished_at: import_zod3.z.string(),
+  config_hash: import_zod3.z.string(),
   summary: summarySchema,
-  evals: import_zod2.z.array(evalResultSchema)
+  evals: import_zod3.z.array(evalResultSchema)
 });
 function parseRunResult(value) {
   return runResultSchema.parse(value);
@@ -1988,6 +2048,7 @@ function formatIngestResult(r) {
   SyncFileError,
   SyncHttpError,
   SyncNetworkError,
+  TEST_CASE_SCHEMA_VERSION,
   TokenRejectedError,
   assertionConfigSchema,
   assertionResultRecordSchema,
@@ -1995,10 +2056,12 @@ function formatIngestResult(r) {
   formatIngestResult,
   ingest,
   parseRunResult,
+  parseTestCase,
   readCairnRun,
   reportIngestFailure,
   reportSyncFailure,
   run,
   runResultSchema,
-  sync
+  sync,
+  testCaseSchema
 });

package/dist/index.d.cts

@@ -23,6 +23,54 @@ interface RunError {
     code: string;
     message: string;
 }
+interface ManualStep {
+    action: string;
+    expected?: string;
+}
+interface ExternalKey {
+    kind: 'playwright-id' | 'path-title' | 'allure-history' | 'cairn-stable' | 'eval-id' | 'qase' | 'testrail';
+    value: string;
+}
+type ManualCase = {
+    type: 'manual';
+    steps: {
+        action: string;
+        expected?: string;
+    }[];
+    expected?: string;
+};
+type AutomatedCase = {
+    type: 'automated';
+    specRef: string;
+};
+type EvalCase = {
+    type: 'eval';
+    prompt: string;
+    goldenSetId?: string;
+    assertions: AssertionResultRecord[];
+};
+interface TestCaseBase {
+    schemaVersion: 2;
+    id: string;
+    externalKeys?: ExternalKey[];
+    is_flaky?: boolean;
+    is_muted?: boolean;
+}
+type TestCase = TestCaseBase & (ManualCase | AutomatedCase | EvalCase);
+/**
+ * The two words a row may use to say the product was never judged (ADR 0045).
+ *
+ * Both are already statuses this system has — they are `RESULT_STATUSES` entries — and neither was
+ * reachable through this contract: a row could only report `passed`, `failed` or `broken`. So a
+ * runner whose row was stopped by something outside the test had exactly one word left, `failed`,
+ * and the word was wrong. A red build because a dependency fell over reads identically to a red
+ * build because the code is broken, and those are two different pieces of work.
+ *
+ * `invalid` is deliberately absent: Qase's `invalid` is our `broken`, and a second word for one
+ * idea would fork the contract at both ends.
+ */
+declare const ROW_INCONCLUSIVE: readonly ["blocked", "skipped"];
+type RowInconclusive = (typeof ROW_INCONCLUSIVE)[number];
 interface RowResult {
     vars: Record<string, unknown>;
     output: string | null;
@@ -31,6 +79,14 @@ interface RowResult {
     latency_ms?: number;
     error?: RunError;
     assertions: AssertionResultRecord[];
+    /**
+     * ADR 0045. Say it when the test was never judged, rather than letting `failed` stand for both
+     * "the environment broke" and "the code is wrong".
+     *
+     * Optional and purely additive: a producer that does not send it validates exactly as before,
+     * which is why `schemaVersion` stays 1.
+     */
+    inconclusive?: RowInconclusive;
 }
 interface EvalResult {
     id: string;
@@ -404,6 +460,10 @@ declare const runResultSchema: z.ZodObject<{
                     passed: z.ZodBoolean;
                 }, z.core.$strip>>>;
             }, z.core.$strip>>;
+            inconclusive: z.ZodOptional<z.ZodEnum<{
+                blocked: "blocked";
+                skipped: "skipped";
+            }>>;
         }, z.core.$strip>>;
         passed: z.ZodBoolean;
     }, z.core.$strip>>;
@@ -417,6 +477,133 @@ type BinaryVerdict = z.infer<typeof binaryVerdictSchema>;
 /** Parse + validate an unknown value as a RunResult. Throws ZodError on failure. */
 declare function parseRunResult(value: unknown): ParsedRunResult;
 
+/**
+ * Runtime validation for the TestCase contract — the JSON that `plune run import` emits
+ * or that the platform accepts on `POST /v1/test-cases`.
+ *
+ * The canonical TypeScript shape is owned by `./results.ts` (`TEST_CASE_SCHEMA_VERSION: 2`).
+ * This module is its zod mirror: the validator for anything that has to *ingest* that
+ * output rather than produce it. `plune sync` validates the local case file with it
+ * before uploading, and the Plune platform validates the same body on
+ * `POST /v1/test-cases` — one schema, both ends.
+ */
+declare const TEST_CASE_SCHEMA_VERSION: TestCase['schemaVersion'];
+declare const testCaseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    id: z.ZodString;
+    externalKeys: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            "playwright-id": "playwright-id";
+            "path-title": "path-title";
+            "allure-history": "allure-history";
+            "cairn-stable": "cairn-stable";
+            "eval-id": "eval-id";
+            qase: "qase";
+            testrail: "testrail";
+        }>;
+        value: z.ZodString;
+    }, z.core.$strip>>>;
+    is_flaky: z.ZodOptional<z.ZodBoolean>;
+    is_muted: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"manual">;
+    steps: z.ZodArray<z.ZodObject<{
+        action: z.ZodString;
+        expected: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    expected: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    id: z.ZodString;
+    externalKeys: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            "playwright-id": "playwright-id";
+            "path-title": "path-title";
+            "allure-history": "allure-history";
+            "cairn-stable": "cairn-stable";
+            "eval-id": "eval-id";
+            qase: "qase";
+            testrail: "testrail";
+        }>;
+        value: z.ZodString;
+    }, z.core.$strip>>>;
+    is_flaky: z.ZodOptional<z.ZodBoolean>;
+    is_muted: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"automated">;
+    specRef: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    id: z.ZodString;
+    externalKeys: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            "playwright-id": "playwright-id";
+            "path-title": "path-title";
+            "allure-history": "allure-history";
+            "cairn-stable": "cairn-stable";
+            "eval-id": "eval-id";
+            qase: "qase";
+            testrail: "testrail";
+        }>;
+        value: z.ZodString;
+    }, z.core.$strip>>>;
+    is_flaky: z.ZodOptional<z.ZodBoolean>;
+    is_muted: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"eval">;
+    prompt: z.ZodString;
+    goldenSetId: z.ZodOptional<z.ZodString>;
+    assertions: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        passed: z.ZodBoolean;
+        score: z.ZodOptional<z.ZodNumber>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>], "type">;
+/** Parse + validate an unknown value as a TestCase. Throws ZodError on failure. */
+declare function parseTestCase(value: unknown): {
+    schemaVersion: 2;
+    id: string;
+    type: "manual";
+    steps: {
+        action: string;
+        expected?: string | undefined;
+    }[];
+    externalKeys?: {
+        kind: "playwright-id" | "path-title" | "allure-history" | "cairn-stable" | "eval-id" | "qase" | "testrail";
+        value: string;
+    }[] | undefined;
+    is_flaky?: boolean | undefined;
+    is_muted?: boolean | undefined;
+    expected?: string | undefined;
+} | {
+    schemaVersion: 2;
+    id: string;
+    type: "automated";
+    specRef: string;
+    externalKeys?: {
+        kind: "playwright-id" | "path-title" | "allure-history" | "cairn-stable" | "eval-id" | "qase" | "testrail";
+        value: string;
+    }[] | undefined;
+    is_flaky?: boolean | undefined;
+    is_muted?: boolean | undefined;
+} | {
+    schemaVersion: 2;
+    id: string;
+    type: "eval";
+    prompt: string;
+    assertions: {
+        type: string;
+        passed: boolean;
+        score?: number | undefined;
+        reason?: string | undefined;
+    }[];
+    externalKeys?: {
+        kind: "playwright-id" | "path-title" | "allure-history" | "cairn-stable" | "eval-id" | "qase" | "testrail";
+        value: string;
+    }[] | undefined;
+    is_flaky?: boolean | undefined;
+    is_muted?: boolean | undefined;
+    goldenSetId?: string | undefined;
+};
+
 interface IngestDeps {
     /** The Cairn run directory to read. Omit it and the newest run under `runsDir` is used. */
     dir?: string;
@@ -485,4 +672,4 @@ interface ReadCairnRunDeps {
  */
 declare function readCairnRun(dir: string, deps?: ReadCairnRunDeps): Promise<CairnIngestPayload>;
 
-export { type AssertionResultRecord, type BinaryVerdict, type CairnIngestCase, type CairnIngestPayload, type Config, type EvalResult, type IngestDeps, type IngestResult, NotLoggedInError, type ParsedRunResult, RUN_RESULT_SCHEMA_VERSION, type RowResult, type RunError, type RunOptions, type RunResult, type Summary, type SyncDeps, SyncFileError, SyncHttpError, SyncNetworkError, type SyncResult, TokenRejectedError, type Usage, assertionConfigSchema, assertionResultRecordSchema, binaryVerdictSchema, formatIngestResult, handleIngest as ingest, parseRunResult, readCairnRun, reportIngestFailure, reportSyncFailure, handleRun as run, runResultSchema, handleSync as sync };
+export { type AssertionResultRecord, type BinaryVerdict, type CairnIngestCase, type CairnIngestPayload, type Config, type EvalResult, type ExternalKey, type IngestDeps, type IngestResult, type ManualStep, NotLoggedInError, type ParsedRunResult, RUN_RESULT_SCHEMA_VERSION, type RowResult, type RunError, type RunOptions, type RunResult, type Summary, type SyncDeps, SyncFileError, SyncHttpError, SyncNetworkError, type SyncResult, TEST_CASE_SCHEMA_VERSION, type TestCase, TokenRejectedError, type Usage, assertionConfigSchema, assertionResultRecordSchema, binaryVerdictSchema, formatIngestResult, handleIngest as ingest, parseRunResult, parseTestCase, readCairnRun, reportIngestFailure, reportSyncFailure, handleRun as run, runResultSchema, handleSync as sync, testCaseSchema };

package/dist/index.d.ts

@@ -23,6 +23,54 @@ interface RunError {
     code: string;
     message: string;
 }
+interface ManualStep {
+    action: string;
+    expected?: string;
+}
+interface ExternalKey {
+    kind: 'playwright-id' | 'path-title' | 'allure-history' | 'cairn-stable' | 'eval-id' | 'qase' | 'testrail';
+    value: string;
+}
+type ManualCase = {
+    type: 'manual';
+    steps: {
+        action: string;
+        expected?: string;
+    }[];
+    expected?: string;
+};
+type AutomatedCase = {
+    type: 'automated';
+    specRef: string;
+};
+type EvalCase = {
+    type: 'eval';
+    prompt: string;
+    goldenSetId?: string;
+    assertions: AssertionResultRecord[];
+};
+interface TestCaseBase {
+    schemaVersion: 2;
+    id: string;
+    externalKeys?: ExternalKey[];
+    is_flaky?: boolean;
+    is_muted?: boolean;
+}
+type TestCase = TestCaseBase & (ManualCase | AutomatedCase | EvalCase);
+/**
+ * The two words a row may use to say the product was never judged (ADR 0045).
+ *
+ * Both are already statuses this system has — they are `RESULT_STATUSES` entries — and neither was
+ * reachable through this contract: a row could only report `passed`, `failed` or `broken`. So a
+ * runner whose row was stopped by something outside the test had exactly one word left, `failed`,
+ * and the word was wrong. A red build because a dependency fell over reads identically to a red
+ * build because the code is broken, and those are two different pieces of work.
+ *
+ * `invalid` is deliberately absent: Qase's `invalid` is our `broken`, and a second word for one
+ * idea would fork the contract at both ends.
+ */
+declare const ROW_INCONCLUSIVE: readonly ["blocked", "skipped"];
+type RowInconclusive = (typeof ROW_INCONCLUSIVE)[number];
 interface RowResult {
     vars: Record<string, unknown>;
     output: string | null;
@@ -31,6 +79,14 @@ interface RowResult {
     latency_ms?: number;
     error?: RunError;
     assertions: AssertionResultRecord[];
+    /**
+     * ADR 0045. Say it when the test was never judged, rather than letting `failed` stand for both
+     * "the environment broke" and "the code is wrong".
+     *
+     * Optional and purely additive: a producer that does not send it validates exactly as before,
+     * which is why `schemaVersion` stays 1.
+     */
+    inconclusive?: RowInconclusive;
 }
 interface EvalResult {
     id: string;
@@ -404,6 +460,10 @@ declare const runResultSchema: z.ZodObject<{
                     passed: z.ZodBoolean;
                 }, z.core.$strip>>>;
             }, z.core.$strip>>;
+            inconclusive: z.ZodOptional<z.ZodEnum<{
+                blocked: "blocked";
+                skipped: "skipped";
+            }>>;
         }, z.core.$strip>>;
         passed: z.ZodBoolean;
     }, z.core.$strip>>;
@@ -417,6 +477,133 @@ type BinaryVerdict = z.infer<typeof binaryVerdictSchema>;
 /** Parse + validate an unknown value as a RunResult. Throws ZodError on failure. */
 declare function parseRunResult(value: unknown): ParsedRunResult;
 
+/**
+ * Runtime validation for the TestCase contract — the JSON that `plune run import` emits
+ * or that the platform accepts on `POST /v1/test-cases`.
+ *
+ * The canonical TypeScript shape is owned by `./results.ts` (`TEST_CASE_SCHEMA_VERSION: 2`).
+ * This module is its zod mirror: the validator for anything that has to *ingest* that
+ * output rather than produce it. `plune sync` validates the local case file with it
+ * before uploading, and the Plune platform validates the same body on
+ * `POST /v1/test-cases` — one schema, both ends.
+ */
+declare const TEST_CASE_SCHEMA_VERSION: TestCase['schemaVersion'];
+declare const testCaseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    id: z.ZodString;
+    externalKeys: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            "playwright-id": "playwright-id";
+            "path-title": "path-title";
+            "allure-history": "allure-history";
+            "cairn-stable": "cairn-stable";
+            "eval-id": "eval-id";
+            qase: "qase";
+            testrail: "testrail";
+        }>;
+        value: z.ZodString;
+    }, z.core.$strip>>>;
+    is_flaky: z.ZodOptional<z.ZodBoolean>;
+    is_muted: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"manual">;
+    steps: z.ZodArray<z.ZodObject<{
+        action: z.ZodString;
+        expected: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    expected: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    id: z.ZodString;
+    externalKeys: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            "playwright-id": "playwright-id";
+            "path-title": "path-title";
+            "allure-history": "allure-history";
+            "cairn-stable": "cairn-stable";
+            "eval-id": "eval-id";
+            qase: "qase";
+            testrail: "testrail";
+        }>;
+        value: z.ZodString;
+    }, z.core.$strip>>>;
+    is_flaky: z.ZodOptional<z.ZodBoolean>;
+    is_muted: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"automated">;
+    specRef: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    id: z.ZodString;
+    externalKeys: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            "playwright-id": "playwright-id";
+            "path-title": "path-title";
+            "allure-history": "allure-history";
+            "cairn-stable": "cairn-stable";
+            "eval-id": "eval-id";
+            qase: "qase";
+            testrail: "testrail";
+        }>;
+        value: z.ZodString;
+    }, z.core.$strip>>>;
+    is_flaky: z.ZodOptional<z.ZodBoolean>;
+    is_muted: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"eval">;
+    prompt: z.ZodString;
+    goldenSetId: z.ZodOptional<z.ZodString>;
+    assertions: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        passed: z.ZodBoolean;
+        score: z.ZodOptional<z.ZodNumber>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>], "type">;
+/** Parse + validate an unknown value as a TestCase. Throws ZodError on failure. */
+declare function parseTestCase(value: unknown): {
+    schemaVersion: 2;
+    id: string;
+    type: "manual";
+    steps: {
+        action: string;
+        expected?: string | undefined;
+    }[];
+    externalKeys?: {
+        kind: "playwright-id" | "path-title" | "allure-history" | "cairn-stable" | "eval-id" | "qase" | "testrail";
+        value: string;
+    }[] | undefined;
+    is_flaky?: boolean | undefined;
+    is_muted?: boolean | undefined;
+    expected?: string | undefined;
+} | {
+    schemaVersion: 2;
+    id: string;
+    type: "automated";
+    specRef: string;
+    externalKeys?: {
+        kind: "playwright-id" | "path-title" | "allure-history" | "cairn-stable" | "eval-id" | "qase" | "testrail";
+        value: string;
+    }[] | undefined;
+    is_flaky?: boolean | undefined;
+    is_muted?: boolean | undefined;
+} | {
+    schemaVersion: 2;
+    id: string;
+    type: "eval";
+    prompt: string;
+    assertions: {
+        type: string;
+        passed: boolean;
+        score?: number | undefined;
+        reason?: string | undefined;
+    }[];
+    externalKeys?: {
+        kind: "playwright-id" | "path-title" | "allure-history" | "cairn-stable" | "eval-id" | "qase" | "testrail";
+        value: string;
+    }[] | undefined;
+    is_flaky?: boolean | undefined;
+    is_muted?: boolean | undefined;
+    goldenSetId?: string | undefined;
+};
+
 interface IngestDeps {
     /** The Cairn run directory to read. Omit it and the newest run under `runsDir` is used. */
     dir?: string;
@@ -485,4 +672,4 @@ interface ReadCairnRunDeps {
  */
 declare function readCairnRun(dir: string, deps?: ReadCairnRunDeps): Promise<CairnIngestPayload>;
 
-export { type AssertionResultRecord, type BinaryVerdict, type CairnIngestCase, type CairnIngestPayload, type Config, type EvalResult, type IngestDeps, type IngestResult, NotLoggedInError, type ParsedRunResult, RUN_RESULT_SCHEMA_VERSION, type RowResult, type RunError, type RunOptions, type RunResult, type Summary, type SyncDeps, SyncFileError, SyncHttpError, SyncNetworkError, type SyncResult, TokenRejectedError, type Usage, assertionConfigSchema, assertionResultRecordSchema, binaryVerdictSchema, formatIngestResult, handleIngest as ingest, parseRunResult, readCairnRun, reportIngestFailure, reportSyncFailure, handleRun as run, runResultSchema, handleSync as sync };
+export { type AssertionResultRecord, type BinaryVerdict, type CairnIngestCase, type CairnIngestPayload, type Config, type EvalResult, type ExternalKey, type IngestDeps, type IngestResult, type ManualStep, NotLoggedInError, type ParsedRunResult, RUN_RESULT_SCHEMA_VERSION, type RowResult, type RunError, type RunOptions, type RunResult, type Summary, type SyncDeps, SyncFileError, SyncHttpError, SyncNetworkError, type SyncResult, TEST_CASE_SCHEMA_VERSION, type TestCase, TokenRejectedError, type Usage, assertionConfigSchema, assertionResultRecordSchema, binaryVerdictSchema, formatIngestResult, handleIngest as ingest, parseRunResult, parseTestCase, readCairnRun, reportIngestFailure, reportSyncFailure, handleRun as run, runResultSchema, handleSync as sync, testCaseSchema };