@neat.is/types 0.10.6-dev.20261007 → 0.10.6-dev.20261009

package/dist/index.js

@@ -207,6 +207,12 @@ var EdgeAnomalySchema = z2.union([
   z2.object({ source: z2.string(), rule: z2.string() }),
   z2.boolean()
 ]);
+var EdgeErrorExemplarSchema = z2.object({
+  exceptionType: z2.string().optional(),
+  message: z2.string().optional(),
+  at: z2.string().optional(),
+  httpStatusCode: z2.number().optional()
+});
 var EdgeSignalSchema = z2.object({
   spanCount: z2.number().int().nonnegative(),
   errorCount: z2.number().int().nonnegative(),
@@ -222,7 +228,12 @@ var EdgeSignalSchema = z2.object({
   latencyHist: z2.record(z2.string(), z2.number().int().nonnegative()).optional(),
   // A pre-thresholded external alert riding on the edge (ADR-190). Optional and
   // empty until an alert source is wired.
-  anomalous: EdgeAnomalySchema.optional()
+  anomalous: EdgeAnomalySchema.optional(),
+  // A bounded last-error exemplar (ADR-236) — the most recent failing
+  // observation's exception type/message/status, so the edge carries WHAT
+  // failed, not just how many times. Additive optional growth (ADR-031); absent
+  // on a clean edge, on a legacy edge, and on a connector edge with no detail.
+  lastError: EdgeErrorExemplarSchema.optional()
 });
 var GraphEdgeSchema = z2.object({
   id: z2.string(),
@@ -891,12 +902,54 @@ var IncidentBlastRadiusSchema = z6.object({
 var IncidentPolicySchema = z6.object({
   policyName: z6.string(),
   severity: z6.string(),
-  message: z6.string().optional()
+  message: z6.string().optional(),
+  // What the policy does when violated, as the policy overlay already resolves it
+  // (explicit onViolation, else the severity default, ADR-044). The grade's
+  // policy gate reads it.
+  onViolation: z6.enum(["log", "alert", "block"]).optional()
 });
 var IncidentDivergenceSchema = z6.object({
   type: z6.string(),
   summary: z6.string()
 });
+var GradeEvidenceSchema = z6.array(z6.string());
+var IncidentGradeGateSchema = z6.object({
+  passed: z6.boolean(),
+  evidence: GradeEvidenceSchema
+});
+var IncidentGradeFactorSchema = z6.object({
+  value: z6.number().min(0).max(1).nullable(),
+  weight: z6.number().positive(),
+  // The card fields the value was computed from.
+  evidence: GradeEvidenceSchema,
+  // Why the value is null, or what it rests on when that isn't obvious.
+  reason: z6.string().optional()
+});
+var IncidentGradeBandSchema = z6.enum(["full", "diagnose-only", "out"]);
+var IncidentGradeSchema = z6.object({
+  G: z6.number().min(0).max(1),
+  gamma: z6.union([z6.literal(0), z6.literal(1)]),
+  gates: z6.object({
+    policyNotBlock: IncidentGradeGateSchema,
+    notSymptomOnly: IncidentGradeGateSchema,
+    locusResolves: IncidentGradeGateSchema
+  }),
+  C: z6.number().min(0).max(1),
+  factors: z6.object({
+    evidence: IncidentGradeFactorSchema,
+    locus: IncidentGradeFactorSchema,
+    tests: IncidentGradeFactorSchema,
+    reach: IncidentGradeFactorSchema,
+    kind: IncidentGradeFactorSchema,
+    chain: IncidentGradeFactorSchema,
+    recur: IncidentGradeFactorSchema,
+    div: IncidentGradeFactorSchema
+  }),
+  band: IncidentGradeBandSchema,
+  // Orders incidents within a band; never raises or lowers a grade.
+  urgency: z6.object({ value: z6.number().min(0).max(1).nullable(), reason: z6.string().optional() }),
+  priorsVersion: z6.string()
+});
 var IncidentCardSchema = z6.object({
   kind: z6.literal("incident"),
   id: z6.string(),
@@ -920,7 +973,9 @@ var IncidentCardSchema = z6.object({
   divergence: z6.array(IncidentDivergenceSchema).optional(),
   // The rendered one-line sentence — a human/loose-LLM read over the structured
   // body, never the wire format.
-  headline: z6.string()
+  headline: z6.string(),
+  // Derived from the fields above (ADR-238). Optional so older cards still parse.
+  grade: IncidentGradeSchema.optional()
 });
 var IncidentEventPayloadSchema = z6.object({
   incidentId: z6.string(),
@@ -1443,6 +1498,10 @@ var ObservedFailingDivergenceSchema = z9.object({
   spanCount: z9.number().int().nonnegative().optional(),
   errorCount: z9.number().int().nonnegative().optional(),
   errorRate: z9.number().min(0).max(1).optional(),
+  // The failing edge's bounded last-error exemplar (ADR-236) — WHAT failed,
+  // alongside the error-rate evidence. Edge locus only; absent when the edge
+  // carried no exception/status detail.
+  lastError: EdgeErrorExemplarSchema.optional(),
   // Incident locus (the declared external call whose incident shows a failure).
   location: z9.string().optional(),
   incidentId: z9.string().optional(),
@@ -1769,6 +1828,7 @@ export {
   EMPTY_REGISTRY,
   EXTRACTED_CONFIDENCE,
   EdgeAnomalySchema,
+  EdgeErrorExemplarSchema,
   EdgeEvidenceSchema,
   EdgeSignalSchema,
   EdgeType,
@@ -1795,6 +1855,10 @@ export {
   IncidentChainHopSchema,
   IncidentDivergenceSchema,
   IncidentEventPayloadSchema,
+  IncidentGradeBandSchema,
+  IncidentGradeFactorSchema,
+  IncidentGradeGateSchema,
+  IncidentGradeSchema,
   IncidentKindSchema,
   IncidentLocusSchema,
   IncidentPolicySchema,