@neat.is/types 0.10.6 → 0.10.7-dev.20261012

package/dist/index.cjs

@@ -48,6 +48,7 @@ __export(index_exports, {
   DEFAULT_EXTRACTED_PRECISION_FLOOR: () => DEFAULT_EXTRACTED_PRECISION_FLOOR,
   DaemonHealthResponseSchema: () => DaemonHealthResponseSchema,
   DatabaseNodeSchema: () => DatabaseNodeSchema,
+  DeployContextSchema: () => DeployContextSchema,
   DeployMismatchDivergenceSchema: () => DeployMismatchDivergenceSchema,
   DeployMismatchKindSchema: () => DeployMismatchKindSchema,
   DiscoveredViaSchema: () => DiscoveredViaSchema,
@@ -68,6 +69,9 @@ __export(index_exports, {
   ExtractionCoverageSchema: () => ExtractionCoverageSchema,
   FieldGuardRuleSchema: () => FieldGuardRuleSchema,
   FileNodeSchema: () => FileNodeSchema,
+  FlagAttrSchema: () => FlagAttrSchema,
+  FlagDefinitionSchema: () => FlagDefinitionSchema,
+  FlagMismatchDivergenceSchema: () => FlagMismatchDivergenceSchema,
   FrontierNodeSchema: () => FrontierNodeSchema,
   GraphDiffResultSchema: () => GraphDiffResultSchema,
   GraphEdgeSchema: () => GraphEdgeSchema,
@@ -82,6 +86,7 @@ __export(index_exports, {
   IncidentBlastRadiusSchema: () => IncidentBlastRadiusSchema,
   IncidentCardSchema: () => IncidentCardSchema,
   IncidentChainHopSchema: () => IncidentChainHopSchema,
+  IncidentDeployContextSchema: () => IncidentDeployContextSchema,
   IncidentDivergenceSchema: () => IncidentDivergenceSchema,
   IncidentEventPayloadSchema: () => IncidentEventPayloadSchema,
   IncidentGradeBandSchema: () => IncidentGradeBandSchema,
@@ -106,6 +111,7 @@ __export(index_exports, {
   NodeType: () => NodeType,
   NodeTypeSchema: () => NodeTypeSchema,
   ObservedDependenciesResultSchema: () => ObservedDependenciesResultSchema,
+  ObservedDeployContextSchema: () => ObservedDeployContextSchema,
   ObservedFailingDivergenceSchema: () => ObservedFailingDivergenceSchema,
   ObservedFailureKindSchema: () => ObservedFailureKindSchema,
   ObservedSymbolMismatchDivergenceSchema: () => ObservedSymbolMismatchDivergenceSchema,
@@ -449,6 +455,27 @@ var GraphEdgeSchema = import_zod2.z.object({
 });
 
 // src/nodes.ts
+var DeployContextSchema = import_zod3.z.object({
+  // The deploy fault classification: crash-loop / image-pull / scaled-to-zero /
+  // no-ready-replicas.
+  fault: import_zod3.z.string().optional(),
+  // The container's waiting reason (CrashLoopBackOff / ImagePullBackOff / …).
+  waitingReason: import_zod3.z.string().optional(),
+  image: import_zod3.z.string().optional(),
+  restartCount: import_zod3.z.number().int().nonnegative().optional(),
+  terminatedReason: import_zod3.z.string().optional(),
+  exitCode: import_zod3.z.number().int().optional(),
+  // Redacted, bounded descriptors (ADR-237): a secret-keyed value is masked whole,
+  // a valueFrom is a reference descriptor, never a raw secret.
+  containerEnv: import_zod3.z.array(import_zod3.z.string()).optional(),
+  containerArgs: import_zod3.z.array(import_zod3.z.string()).optional(),
+  // The last-terminated (or current, ADR-239) stdout tail — the boot traceback.
+  processLog: import_zod3.z.string().optional()
+});
+var ObservedDeployContextSchema = DeployContextSchema.extend({
+  incidentId: import_zod3.z.string(),
+  observedAt: import_zod3.z.string()
+});
 var CompatibleDriverSchema = import_zod3.z.object({
   name: import_zod3.z.string(),
   minVersion: import_zod3.z.string()
@@ -477,6 +504,10 @@ var ServiceNodeSchema = import_zod3.z.object({
   // frontend's icon key at the service-rollup level (ADR-133,
   // docs/contracts/static-extraction.md).
   platform: import_zod3.z.string().optional(),
+  // The platform's own name for this service where its config declares one:
+  // the Vercel project name from `.vercel/project.json`, the Supabase
+  // `project_id` (ADR-138). Optional growth (ADR-031); absent elsewhere.
+  platformName: import_zod3.z.string().optional(),
   discoveredVia: DiscoveredViaSchema.optional(),
   version: import_zod3.z.string().optional(),
   dbConnectionTarget: import_zod3.z.string().optional(),
@@ -499,6 +530,11 @@ var ServiceNodeSchema = import_zod3.z.object({
   // (ADR-031, ADR-225), absent on a non-k8s service.
   observedImage: import_zod3.z.string().optional(),
   observedReadyReplicas: import_zod3.z.number().optional(),
+  // The faulted workload's observed deploy/process/config context, fused here at
+  // ingest by the k8s observed reader (ADR-243, amending ADR-237/240). The one copy:
+  // the incident card, `neat incidents` and MCP read it from this node. Optional
+  // growth (ADR-031), absent on a non-k8s or healthy service.
+  observedDeployContext: ObservedDeployContextSchema.optional(),
   repoPath: import_zod3.z.string().optional(),
   owner: import_zod3.z.string().optional(),
   dependencies: import_zod3.z.record(import_zod3.z.string(), import_zod3.z.string()).optional(),
@@ -583,6 +619,28 @@ var ColumnAttrSchema = import_zod3.z.object({
   // (`kind` is an open string); folded by `foldSdkWrites`, never `foldColumns`.
   sdkWrites: import_zod3.z.array(import_zod3.z.enum(["client", "admin"])).optional()
 });
+var FlagDefinitionSchema = import_zod3.z.object({
+  state: import_zod3.z.string(),
+  defaultVariant: import_zod3.z.string().nullable(),
+  variants: import_zod3.z.record(import_zod3.z.unknown()),
+  targeting: import_zod3.z.unknown().optional()
+});
+var FlagAttrSchema = import_zod3.z.object({
+  key: import_zod3.z.string(),
+  provenances: import_zod3.z.array(ProvenanceSchema),
+  declared: FlagDefinitionSchema.optional(),
+  // The flag file the declaration came from, relative to the scan root.
+  declaredIn: import_zod3.z.string().optional(),
+  observed: FlagDefinitionSchema.optional(),
+  observedAt: import_zod3.z.string().optional(),
+  observedVariant: import_zod3.z.string().optional(),
+  // The OpenFeature resolution reason that came with it (STATIC, DEFAULT,
+  // TARGETING_MATCH, SPLIT, ERROR...). A targeted variant is the flag working as
+  // committed, so only a STATIC/DEFAULT resolution is compared to the default.
+  observedVariantReason: import_zod3.z.string().optional(),
+  observedVariantAt: import_zod3.z.string().optional(),
+  readers: import_zod3.z.array(import_zod3.z.object({ file: import_zod3.z.string(), service: import_zod3.z.string(), line: import_zod3.z.number().int().optional() })).optional()
+});
 var InfraNodeSchema = import_zod3.z.object({
   id: import_zod3.z.string(),
   type: import_zod3.z.literal(NodeType.InfraNode),
@@ -613,7 +671,10 @@ var InfraNodeSchema = import_zod3.z.object({
   // carry the same declared facts on the topology node for traversal/blast-radius.
   image: import_zod3.z.string().optional(),
   replicas: import_zod3.z.number().optional(),
-  namespace: import_zod3.z.string().optional()
+  namespace: import_zod3.z.string().optional(),
+  // The flag grain on a `flag-store` InfraNode (ADR-242), one entry per flag key.
+  // Absent on every other InfraNode. Optional growth (ADR-031).
+  flags: import_zod3.z.array(FlagAttrSchema).optional()
 });
 var FrontierNodeSchema = import_zod3.z.object({
   id: import_zod3.z.string(),
@@ -1149,15 +1210,18 @@ var IncidentGradeSchema = import_zod6.z.object({
   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 IncidentDeployContextSchema = DeployContextSchema;
 var IncidentCardSchema = import_zod6.z.object({
   kind: import_zod6.z.literal("incident"),
-  id: import_zod6.z.string(),
+  id: import_zod6.z.string().nullable(),
   // ISO8601 — the incident's own time.
-  at: import_zod6.z.string(),
-  incidentKind: IncidentKindSchema,
-  service: import_zod6.z.string(),
+  at: import_zod6.z.string().nullable(),
+  incidentKind: IncidentKindSchema.nullable(),
+  service: import_zod6.z.string().nullable(),
   affectedNode: import_zod6.z.string(),
-  message: import_zod6.z.string(),
+  message: import_zod6.z.string().nullable(),
+  // Present only on a card composed for a node with no recorded incident.
+  noIncident: import_zod6.z.object({ reason: import_zod6.z.string() }).optional(),
   exceptionType: import_zod6.z.string().optional(),
   httpStatusCode: import_zod6.z.number().int().optional(),
   // Coalesced burst size (ErrorEvent.incidentCount).
@@ -1170,6 +1234,9 @@ var IncidentCardSchema = import_zod6.z.object({
   blastRadius: IncidentBlastRadiusSchema.optional(),
   policies: import_zod6.z.array(IncidentPolicySchema).optional(),
   divergence: import_zod6.z.array(IncidentDivergenceSchema).optional(),
+  // The OBSERVED deploy/process/config context for a pre-span failure (ADR-240),
+  // present only when the incident carries it (a k8s deploy fault).
+  deployContext: IncidentDeployContextSchema.optional(),
   // The rendered one-line sentence — a human/loose-LLM read over the structured
   // body, never the wire format.
   headline: import_zod6.z.string(),
@@ -1718,6 +1785,16 @@ var DeployMismatchDivergenceSchema = import_zod9.z.object({
   declaredReplicas: import_zod9.z.number().optional(),
   observedReplicas: import_zod9.z.number().optional()
 });
+var FlagMismatchDivergenceSchema = import_zod9.z.object({
+  type: import_zod9.z.literal("flag-mismatch"),
+  ...commonFields,
+  flagKey: import_zod9.z.string(),
+  changed: import_zod9.z.array(import_zod9.z.string()),
+  declaredVariant: import_zod9.z.string().nullable().optional(),
+  observedVariant: import_zod9.z.string().nullable().optional(),
+  // The code locations that read the key in the source service (`file:line`).
+  readers: import_zod9.z.array(import_zod9.z.string()).optional()
+});
 var DivergenceSchema = import_zod9.z.discriminatedUnion("type", [
   MissingObservedDivergenceSchema,
   MissingExtractedDivergenceSchema,
@@ -1726,7 +1803,8 @@ var DivergenceSchema = import_zod9.z.discriminatedUnion("type", [
   CompatViolationDivergenceSchema,
   ObservedSymbolMismatchDivergenceSchema,
   ObservedFailingDivergenceSchema,
-  DeployMismatchDivergenceSchema
+  DeployMismatchDivergenceSchema,
+  FlagMismatchDivergenceSchema
 ]);
 var DivergenceResultSchema = import_zod9.z.object({
   divergences: import_zod9.z.array(DivergenceSchema),
@@ -1743,7 +1821,8 @@ var DivergenceTypeSchema = import_zod9.z.enum([
   "compat-violation",
   "observed-symbol-mismatch",
   "observed-failing",
-  "deploy-mismatch"
+  "deploy-mismatch",
+  "flag-mismatch"
 ]);
 
 // src/mcp-tools.ts
@@ -2026,6 +2105,7 @@ var PrVerdictBodySchema = import_zod11.z.object({
   DEFAULT_EXTRACTED_PRECISION_FLOOR,
   DaemonHealthResponseSchema,
   DatabaseNodeSchema,
+  DeployContextSchema,
   DeployMismatchDivergenceSchema,
   DeployMismatchKindSchema,
   DiscoveredViaSchema,
@@ -2046,6 +2126,9 @@ var PrVerdictBodySchema = import_zod11.z.object({
   ExtractionCoverageSchema,
   FieldGuardRuleSchema,
   FileNodeSchema,
+  FlagAttrSchema,
+  FlagDefinitionSchema,
+  FlagMismatchDivergenceSchema,
   FrontierNodeSchema,
   GraphDiffResultSchema,
   GraphEdgeSchema,
@@ -2060,6 +2143,7 @@ var PrVerdictBodySchema = import_zod11.z.object({
   IncidentBlastRadiusSchema,
   IncidentCardSchema,
   IncidentChainHopSchema,
+  IncidentDeployContextSchema,
   IncidentDivergenceSchema,
   IncidentEventPayloadSchema,
   IncidentGradeBandSchema,
@@ -2084,6 +2168,7 @@ var PrVerdictBodySchema = import_zod11.z.object({
   NodeType,
   NodeTypeSchema,
   ObservedDependenciesResultSchema,
+  ObservedDeployContextSchema,
   ObservedFailingDivergenceSchema,
   ObservedFailureKindSchema,
   ObservedSymbolMismatchDivergenceSchema,