@neat.is/types 0.10.6 → 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()
@@ -285,6 +306,10 @@ var ServiceNodeSchema = z3.object({
   // frontend's icon key at the service-rollup level (ADR-133,
   // docs/contracts/static-extraction.md).
   platform: z3.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: z3.string().optional(),
   discoveredVia: DiscoveredViaSchema.optional(),
   version: z3.string().optional(),
   dbConnectionTarget: z3.string().optional(),
@@ -307,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(),
@@ -391,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),
@@ -421,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(),
@@ -957,15 +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 = 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).
@@ -978,6 +1036,9 @@ var IncidentCardSchema = z6.object({
   blastRadius: IncidentBlastRadiusSchema.optional(),
   policies: z6.array(IncidentPolicySchema).optional(),
   divergence: z6.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: z6.string(),
@@ -1526,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,
@@ -1534,7 +1605,8 @@ var DivergenceSchema = z9.discriminatedUnion("type", [
   CompatViolationDivergenceSchema,
   ObservedSymbolMismatchDivergenceSchema,
   ObservedFailingDivergenceSchema,
-  DeployMismatchDivergenceSchema
+  DeployMismatchDivergenceSchema,
+  FlagMismatchDivergenceSchema
 ]);
 var DivergenceResultSchema = z9.object({
   divergences: z9.array(DivergenceSchema),
@@ -1551,7 +1623,8 @@ var DivergenceTypeSchema = z9.enum([
   "compat-violation",
   "observed-symbol-mismatch",
   "observed-failing",
-  "deploy-mismatch"
+  "deploy-mismatch",
+  "flag-mismatch"
 ]);
 
 // src/mcp-tools.ts
@@ -1833,6 +1906,7 @@ export {
   DEFAULT_EXTRACTED_PRECISION_FLOOR,
   DaemonHealthResponseSchema,
   DatabaseNodeSchema,
+  DeployContextSchema,
   DeployMismatchDivergenceSchema,
   DeployMismatchKindSchema,
   DiscoveredViaSchema,
@@ -1853,6 +1927,9 @@ export {
   ExtractionCoverageSchema,
   FieldGuardRuleSchema,
   FileNodeSchema,
+  FlagAttrSchema,
+  FlagDefinitionSchema,
+  FlagMismatchDivergenceSchema,
   FrontierNodeSchema,
   GraphDiffResultSchema,
   GraphEdgeSchema,
@@ -1867,6 +1944,7 @@ export {
   IncidentBlastRadiusSchema,
   IncidentCardSchema,
   IncidentChainHopSchema,
+  IncidentDeployContextSchema,
   IncidentDivergenceSchema,
   IncidentEventPayloadSchema,
   IncidentGradeBandSchema,
@@ -1891,6 +1969,7 @@ export {
   NodeType,
   NodeTypeSchema,
   ObservedDependenciesResultSchema,
+  ObservedDeployContextSchema,
   ObservedFailingDivergenceSchema,
   ObservedFailureKindSchema,
   ObservedSymbolMismatchDivergenceSchema,