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

package/dist/index.js

@@ -257,6 +257,27 @@ var GraphEdgeSchema = z2.object({
 });
 
 // src/nodes.ts
+var DeployContextSchema = z3.object({
+  // The deploy fault classification: crash-loop / image-pull / scaled-to-zero /
+  // no-ready-replicas.
+  fault: z3.string().optional(),
+  // The container's waiting reason (CrashLoopBackOff / ImagePullBackOff / …).
+  waitingReason: z3.string().optional(),
+  image: z3.string().optional(),
+  restartCount: z3.number().int().nonnegative().optional(),
+  terminatedReason: z3.string().optional(),
+  exitCode: z3.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: z3.array(z3.string()).optional(),
+  containerArgs: z3.array(z3.string()).optional(),
+  // The last-terminated (or current, ADR-239) stdout tail — the boot traceback.
+  processLog: z3.string().optional()
+});
+var ObservedDeployContextSchema = DeployContextSchema.extend({
+  incidentId: z3.string(),
+  observedAt: z3.string()
+});
 var CompatibleDriverSchema = z3.object({
   name: z3.string(),
   minVersion: z3.string()
@@ -311,6 +332,11 @@ var ServiceNodeSchema = z3.object({
   // (ADR-031, ADR-225), absent on a non-k8s service.
   observedImage: z3.string().optional(),
   observedReadyReplicas: z3.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: z3.string().optional(),
   owner: z3.string().optional(),
   dependencies: z3.record(z3.string(), z3.string()).optional(),
@@ -395,6 +421,28 @@ var ColumnAttrSchema = z3.object({
   // (`kind` is an open string); folded by `foldSdkWrites`, never `foldColumns`.
   sdkWrites: z3.array(z3.enum(["client", "admin"])).optional()
 });
+var FlagDefinitionSchema = z3.object({
+  state: z3.string(),
+  defaultVariant: z3.string().nullable(),
+  variants: z3.record(z3.unknown()),
+  targeting: z3.unknown().optional()
+});
+var FlagAttrSchema = z3.object({
+  key: z3.string(),
+  provenances: z3.array(ProvenanceSchema),
+  declared: FlagDefinitionSchema.optional(),
+  // The flag file the declaration came from, relative to the scan root.
+  declaredIn: z3.string().optional(),
+  observed: FlagDefinitionSchema.optional(),
+  observedAt: z3.string().optional(),
+  observedVariant: z3.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: z3.string().optional(),
+  observedVariantAt: z3.string().optional(),
+  readers: z3.array(z3.object({ file: z3.string(), service: z3.string(), line: z3.number().int().optional() })).optional()
+});
 var InfraNodeSchema = z3.object({
   id: z3.string(),
   type: z3.literal(NodeType.InfraNode),
@@ -425,7 +473,10 @@ var InfraNodeSchema = z3.object({
   // carry the same declared facts on the topology node for traversal/blast-radius.
   image: z3.string().optional(),
   replicas: z3.number().optional(),
-  namespace: z3.string().optional()
+  namespace: z3.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: z3.array(FlagAttrSchema).optional()
 });
 var FrontierNodeSchema = z3.object({
   id: z3.string(),
@@ -961,32 +1012,18 @@ var IncidentGradeSchema = z6.object({
   urgency: z6.object({ value: z6.number().min(0).max(1).nullable(), reason: z6.string().optional() }),
   priorsVersion: z6.string()
 });
-var IncidentDeployContextSchema = z6.object({
-  // The deploy fault classification (k8s.fault): crash-loop / image-pull /
-  // scaled-to-zero / no-ready-replicas.
-  fault: z6.string().optional(),
-  // The container's waiting reason (CrashLoopBackOff / ImagePullBackOff / …).
-  waitingReason: z6.string().optional(),
-  image: z6.string().optional(),
-  restartCount: z6.number().int().nonnegative().optional(),
-  terminatedReason: z6.string().optional(),
-  exitCode: z6.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: z6.array(z6.string()).optional(),
-  containerArgs: z6.array(z6.string()).optional(),
-  // The last-terminated (or current, ADR-239) stdout tail — the boot traceback.
-  processLog: z6.string().optional()
-});
+var IncidentDeployContextSchema = DeployContextSchema;
 var IncidentCardSchema = z6.object({
   kind: z6.literal("incident"),
-  id: z6.string(),
+  id: z6.string().nullable(),
   // ISO8601 — the incident's own time.
-  at: z6.string(),
-  incidentKind: IncidentKindSchema,
-  service: z6.string(),
+  at: z6.string().nullable(),
+  incidentKind: IncidentKindSchema.nullable(),
+  service: z6.string().nullable(),
   affectedNode: z6.string(),
-  message: z6.string(),
+  message: z6.string().nullable(),
+  // Present only on a card composed for a node with no recorded incident.
+  noIncident: z6.object({ reason: z6.string() }).optional(),
   exceptionType: z6.string().optional(),
   httpStatusCode: z6.number().int().optional(),
   // Coalesced burst size (ErrorEvent.incidentCount).
@@ -1550,6 +1587,16 @@ var DeployMismatchDivergenceSchema = z9.object({
   declaredReplicas: z9.number().optional(),
   observedReplicas: z9.number().optional()
 });
+var FlagMismatchDivergenceSchema = z9.object({
+  type: z9.literal("flag-mismatch"),
+  ...commonFields,
+  flagKey: z9.string(),
+  changed: z9.array(z9.string()),
+  declaredVariant: z9.string().nullable().optional(),
+  observedVariant: z9.string().nullable().optional(),
+  // The code locations that read the key in the source service (`file:line`).
+  readers: z9.array(z9.string()).optional()
+});
 var DivergenceSchema = z9.discriminatedUnion("type", [
   MissingObservedDivergenceSchema,
   MissingExtractedDivergenceSchema,
@@ -1558,7 +1605,8 @@ var DivergenceSchema = z9.discriminatedUnion("type", [
   CompatViolationDivergenceSchema,
   ObservedSymbolMismatchDivergenceSchema,
   ObservedFailingDivergenceSchema,
-  DeployMismatchDivergenceSchema
+  DeployMismatchDivergenceSchema,
+  FlagMismatchDivergenceSchema
 ]);
 var DivergenceResultSchema = z9.object({
   divergences: z9.array(DivergenceSchema),
@@ -1575,7 +1623,8 @@ var DivergenceTypeSchema = z9.enum([
   "compat-violation",
   "observed-symbol-mismatch",
   "observed-failing",
-  "deploy-mismatch"
+  "deploy-mismatch",
+  "flag-mismatch"
 ]);
 
 // src/mcp-tools.ts
@@ -1857,6 +1906,7 @@ export {
   DEFAULT_EXTRACTED_PRECISION_FLOOR,
   DaemonHealthResponseSchema,
   DatabaseNodeSchema,
+  DeployContextSchema,
   DeployMismatchDivergenceSchema,
   DeployMismatchKindSchema,
   DiscoveredViaSchema,
@@ -1877,6 +1927,9 @@ export {
   ExtractionCoverageSchema,
   FieldGuardRuleSchema,
   FileNodeSchema,
+  FlagAttrSchema,
+  FlagDefinitionSchema,
+  FlagMismatchDivergenceSchema,
   FrontierNodeSchema,
   GraphDiffResultSchema,
   GraphEdgeSchema,
@@ -1916,6 +1969,7 @@ export {
   NodeType,
   NodeTypeSchema,
   ObservedDependenciesResultSchema,
+  ObservedDeployContextSchema,
   ObservedFailingDivergenceSchema,
   ObservedFailureKindSchema,
   ObservedSymbolMismatchDivergenceSchema,