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

package/dist/index.cjs

@@ -57,6 +57,7 @@ __export(index_exports, {
   EMPTY_REGISTRY: () => EMPTY_REGISTRY,
   EXTRACTED_CONFIDENCE: () => EXTRACTED_CONFIDENCE,
   EdgeAnomalySchema: () => EdgeAnomalySchema,
+  EdgeErrorExemplarSchema: () => EdgeErrorExemplarSchema,
   EdgeEvidenceSchema: () => EdgeEvidenceSchema,
   EdgeSignalSchema: () => EdgeSignalSchema,
   EdgeType: () => EdgeType,
@@ -83,6 +84,10 @@ __export(index_exports, {
   IncidentChainHopSchema: () => IncidentChainHopSchema,
   IncidentDivergenceSchema: () => IncidentDivergenceSchema,
   IncidentEventPayloadSchema: () => IncidentEventPayloadSchema,
+  IncidentGradeBandSchema: () => IncidentGradeBandSchema,
+  IncidentGradeFactorSchema: () => IncidentGradeFactorSchema,
+  IncidentGradeGateSchema: () => IncidentGradeGateSchema,
+  IncidentGradeSchema: () => IncidentGradeSchema,
   IncidentKindSchema: () => IncidentKindSchema,
   IncidentLocusSchema: () => IncidentLocusSchema,
   IncidentPolicySchema: () => IncidentPolicySchema,
@@ -393,6 +398,12 @@ var EdgeAnomalySchema = import_zod2.z.union([
   import_zod2.z.object({ source: import_zod2.z.string(), rule: import_zod2.z.string() }),
   import_zod2.z.boolean()
 ]);
+var EdgeErrorExemplarSchema = import_zod2.z.object({
+  exceptionType: import_zod2.z.string().optional(),
+  message: import_zod2.z.string().optional(),
+  at: import_zod2.z.string().optional(),
+  httpStatusCode: import_zod2.z.number().optional()
+});
 var EdgeSignalSchema = import_zod2.z.object({
   spanCount: import_zod2.z.number().int().nonnegative(),
   errorCount: import_zod2.z.number().int().nonnegative(),
@@ -408,7 +419,12 @@ var EdgeSignalSchema = import_zod2.z.object({
   latencyHist: import_zod2.z.record(import_zod2.z.string(), import_zod2.z.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 = import_zod2.z.object({
   id: import_zod2.z.string(),
@@ -1077,12 +1093,54 @@ var IncidentBlastRadiusSchema = import_zod6.z.object({
 var IncidentPolicySchema = import_zod6.z.object({
   policyName: import_zod6.z.string(),
   severity: import_zod6.z.string(),
-  message: import_zod6.z.string().optional()
+  message: import_zod6.z.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: import_zod6.z.enum(["log", "alert", "block"]).optional()
 });
 var IncidentDivergenceSchema = import_zod6.z.object({
   type: import_zod6.z.string(),
   summary: import_zod6.z.string()
 });
+var GradeEvidenceSchema = import_zod6.z.array(import_zod6.z.string());
+var IncidentGradeGateSchema = import_zod6.z.object({
+  passed: import_zod6.z.boolean(),
+  evidence: GradeEvidenceSchema
+});
+var IncidentGradeFactorSchema = import_zod6.z.object({
+  value: import_zod6.z.number().min(0).max(1).nullable(),
+  weight: import_zod6.z.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: import_zod6.z.string().optional()
+});
+var IncidentGradeBandSchema = import_zod6.z.enum(["full", "diagnose-only", "out"]);
+var IncidentGradeSchema = import_zod6.z.object({
+  G: import_zod6.z.number().min(0).max(1),
+  gamma: import_zod6.z.union([import_zod6.z.literal(0), import_zod6.z.literal(1)]),
+  gates: import_zod6.z.object({
+    policyNotBlock: IncidentGradeGateSchema,
+    notSymptomOnly: IncidentGradeGateSchema,
+    locusResolves: IncidentGradeGateSchema
+  }),
+  C: import_zod6.z.number().min(0).max(1),
+  factors: import_zod6.z.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: import_zod6.z.object({ value: import_zod6.z.number().min(0).max(1).nullable(), reason: import_zod6.z.string().optional() }),
+  priorsVersion: import_zod6.z.string()
+});
 var IncidentCardSchema = import_zod6.z.object({
   kind: import_zod6.z.literal("incident"),
   id: import_zod6.z.string(),
@@ -1106,7 +1164,9 @@ var IncidentCardSchema = import_zod6.z.object({
   divergence: import_zod6.z.array(IncidentDivergenceSchema).optional(),
   // The rendered one-line sentence — a human/loose-LLM read over the structured
   // body, never the wire format.
-  headline: import_zod6.z.string()
+  headline: import_zod6.z.string(),
+  // Derived from the fields above (ADR-238). Optional so older cards still parse.
+  grade: IncidentGradeSchema.optional()
 });
 var IncidentEventPayloadSchema = import_zod6.z.object({
   incidentId: import_zod6.z.string(),
@@ -1629,6 +1689,10 @@ var ObservedFailingDivergenceSchema = import_zod9.z.object({
   spanCount: import_zod9.z.number().int().nonnegative().optional(),
   errorCount: import_zod9.z.number().int().nonnegative().optional(),
   errorRate: import_zod9.z.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: import_zod9.z.string().optional(),
   incidentId: import_zod9.z.string().optional(),
@@ -1956,6 +2020,7 @@ var PrVerdictBodySchema = import_zod11.z.object({
   EMPTY_REGISTRY,
   EXTRACTED_CONFIDENCE,
   EdgeAnomalySchema,
+  EdgeErrorExemplarSchema,
   EdgeEvidenceSchema,
   EdgeSignalSchema,
   EdgeType,
@@ -1982,6 +2047,10 @@ var PrVerdictBodySchema = import_zod11.z.object({
   IncidentChainHopSchema,
   IncidentDivergenceSchema,
   IncidentEventPayloadSchema,
+  IncidentGradeBandSchema,
+  IncidentGradeFactorSchema,
+  IncidentGradeGateSchema,
+  IncidentGradeSchema,
   IncidentKindSchema,
   IncidentLocusSchema,
   IncidentPolicySchema,