typekro 0.4.0 → 0.5.0

package/dist/core/expressions/{magic-proxy-detector.d.ts → magic-proxy/magic-proxy-detector.d.ts}

@@ -4,7 +4,7 @@
  * This module provides enhanced detection capabilities for KubernetesRef objects
  * that originate from TypeKro's magic proxy system (SchemaProxy and ResourcesProxy).
  */
-import type { KubernetesRef } from '../types/index.js';
+import type { KubernetesRef } from '../../types/index.js';
 /**
  * Information about a detected KubernetesRef from magic proxy
  */
@@ -76,7 +76,7 @@ export declare class MagicProxyDetector {
      * @param basePath - Base path for reference tracking
      * @returns Detection result
      */
-    detectKubernetesRefs(value: any, config?: MagicProxyDetectionConfig, basePath?: string): MagicProxyDetectionResult;
+    detectKubernetesRefs(value: unknown, config?: MagicProxyDetectionConfig, basePath?: string): MagicProxyDetectionResult;
     /**
      * Check if a value contains any KubernetesRef objects (fast check)
      *
@@ -84,7 +84,7 @@ export declare class MagicProxyDetector {
      * @param maxDepth - Maximum depth to check
      * @returns Whether KubernetesRef objects were found
      */
-    containsKubernetesRefs(value: any, maxDepth?: number): boolean;
+    containsKubernetesRefs(value: unknown, maxDepth?: number): boolean;
     /**
      * Extract all KubernetesRef objects from a value
      *
@@ -92,7 +92,7 @@ export declare class MagicProxyDetector {
      * @param maxDepth - Maximum depth to extract
      * @returns Array of KubernetesRef objects
      */
-    extractKubernetesRefs(value: any, maxDepth?: number): KubernetesRef<any>[];
+    extractKubernetesRefs(value: unknown, maxDepth?: number): KubernetesRef<any>[];
     /**
      * Analyze the source of a KubernetesRef object
      *
@@ -121,7 +121,7 @@ export declare const magicProxyDetector: MagicProxyDetector;
  * @param config - Detection configuration
  * @returns Detection result
  */
-export declare function detectMagicProxyRefs(value: any, config?: MagicProxyDetectionConfig): MagicProxyDetectionResult;
+export declare function detectMagicProxyRefs(value: unknown, config?: MagicProxyDetectionConfig): MagicProxyDetectionResult;
 /**
  * Utility function to check if a value contains KubernetesRef objects
  *
@@ -129,7 +129,7 @@ export declare function detectMagicProxyRefs(value: any, config?: MagicProxyDete
  * @param maxDepth - Maximum depth to check
  * @returns Whether KubernetesRef objects were found
  */
-export declare function containsMagicProxyRefs(value: any, maxDepth?: number): boolean;
+export declare function containsMagicProxyRefs(value: unknown, maxDepth?: number): boolean;
 /**
  * Utility function to extract all KubernetesRef objects from a value
  *
@@ -137,7 +137,7 @@ export declare function containsMagicProxyRefs(value: any, maxDepth?: number): b
  * @param maxDepth - Maximum depth to extract
  * @returns Array of KubernetesRef objects
  */
-export declare function extractMagicProxyRefs(value: any, maxDepth?: number): KubernetesRef<any>[];
+export declare function extractMagicProxyRefs(value: unknown, maxDepth?: number): KubernetesRef<any>[];
 /**
  * Utility function to analyze the source of a KubernetesRef object
  *

package/dist/core/expressions/magic-proxy/magic-proxy-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"magic-proxy-detector.d.ts","sourceRoot":"","sources":["../../../../src/core/expressions/magic-proxy/magic-proxy-detector.ts"],"names":[],"mappings":"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"}

package/dist/core/expressions/{magic-proxy-detector.js → magic-proxy/magic-proxy-detector.js}

@@ -4,8 +4,9 @@
  * This module provides enhanced detection capabilities for KubernetesRef objects
  * that originate from TypeKro's magic proxy system (SchemaProxy and ResourcesProxy).
  */
-import { getComponentLogger } from '../logging/index.js';
-import { isKubernetesRef } from '../../utils/type-guards.js';
+import { isKubernetesRef } from '../../../utils/type-guards.js';
+import { DEFAULT_MAX_ANALYSIS_DEPTH } from '../../config/defaults.js';
+import { getComponentLogger } from '../../logging/index.js';
 const logger = getComponentLogger('magic-proxy-detector');
 /**
  * Magic Proxy Detector
@@ -33,27 +34,27 @@ export class MagicProxyDetector {
                 schemaReferences: 0,
                 resourceReferences: 0,
                 nestedReferences: 0,
-                maxNestingDepth: 0
+                maxNestingDepth: 0,
             },
             metrics: {
                 detectionTimeMs: 0,
                 objectsScanned: 0,
-                propertiesScanned: 0
-            }
+                propertiesScanned: 0,
+            },
         };
         this.scanValue(value, result, config, basePath, 0);
         result.hasKubernetesRefs = result.references.length > 0;
         result.stats.totalReferences = result.references.length;
-        result.stats.schemaReferences = result.references.filter(r => r.source === 'schema').length;
-        result.stats.resourceReferences = result.references.filter(r => r.source === 'resource').length;
-        result.stats.nestedReferences = result.references.filter(r => r.isNested).length;
-        result.stats.maxNestingDepth = Math.max(...result.references.map(r => r.nestingDepth), 0);
+        result.stats.schemaReferences = result.references.filter((r) => r.source === 'schema').length;
+        result.stats.resourceReferences = result.references.filter((r) => r.source === 'resource').length;
+        result.stats.nestedReferences = result.references.filter((r) => r.isNested).length;
+        result.stats.maxNestingDepth = Math.max(...result.references.map((r) => r.nestingDepth), 0);
         result.metrics.detectionTimeMs = performance.now() - startTime;
         if (config.trackMetrics !== false) {
             logger.debug('Magic proxy detection completed', {
                 hasKubernetesRefs: result.hasKubernetesRefs,
                 totalReferences: result.stats.totalReferences,
-                detectionTimeMs: result.metrics.detectionTimeMs
+                detectionTimeMs: result.metrics.detectionTimeMs,
             });
         }
         return result;
@@ -65,7 +66,7 @@ export class MagicProxyDetector {
      * @param maxDepth - Maximum depth to check
      * @returns Whether KubernetesRef objects were found
      */
-    containsKubernetesRefs(value, maxDepth = 10) {
+    containsKubernetesRefs(value, maxDepth = DEFAULT_MAX_ANALYSIS_DEPTH) {
         return this.fastScanForRefs(value, 0, maxDepth);
     }
     /**
@@ -75,7 +76,7 @@ export class MagicProxyDetector {
      * @param maxDepth - Maximum depth to extract
      * @returns Array of KubernetesRef objects
      */
-    extractKubernetesRefs(value, maxDepth = 10) {
+    extractKubernetesRefs(value, maxDepth = DEFAULT_MAX_ANALYSIS_DEPTH) {
         const refs = [];
         this.extractRefs(value, refs, 0, maxDepth);
         return refs;
@@ -95,21 +96,23 @@ export class MagicProxyDetector {
                 source: 'unknown',
                 isSchemaRef: false,
                 isResourceRef: false,
-                fieldPath
+                fieldPath,
             };
         }
         // Detect schema references (typically have __schema__ as resourceId)
         const isSchemaRef = resourceId === '__schema__' || resourceId.startsWith('schema.');
         // Detect resource references (have actual resource IDs)
         const isResourceRef = !isSchemaRef && !!resourceId && resourceId !== '__schema__';
-        const source = isSchemaRef ? 'schema' :
-            isResourceRef ? 'resource' :
-                'unknown';
+        const source = isSchemaRef
+            ? 'schema'
+            : isResourceRef
+                ? 'resource'
+                : 'unknown';
         const result = {
             source,
             isSchemaRef,
             isResourceRef,
-            fieldPath
+            fieldPath,
         };
         if (isResourceRef && resourceId) {
             result.resourceId = resourceId;
@@ -117,7 +120,7 @@ export class MagicProxyDetector {
         return result;
     }
     scanValue(value, result, config, currentPath, depth) {
-        const maxDepth = config.maxDepth || 10;
+        const maxDepth = config.maxDepth || DEFAULT_MAX_ANALYSIS_DEPTH;
         if (depth >= maxDepth) {
             return;
         }
@@ -126,7 +129,12 @@ export class MagicProxyDetector {
         if (isKubernetesRef(value)) {
             const sourceAnalysis = config.analyzeReferenceSources !== false
                 ? this.analyzeReferenceSource(value)
-                : { source: 'unknown', isSchemaRef: false, isResourceRef: false, fieldPath: value.fieldPath };
+                : {
+                    source: 'unknown',
+                    isSchemaRef: false,
+                    isResourceRef: false,
+                    fieldPath: value.fieldPath,
+                };
             const refInfo = {
                 ref: value,
                 path: currentPath,
@@ -134,7 +142,7 @@ export class MagicProxyDetector {
                 ...(sourceAnalysis.resourceId && { resourceId: sourceAnalysis.resourceId }),
                 fieldPath: sourceAnalysis.fieldPath,
                 isNested: depth > 1, // Only consider nested if depth > 1 (not just at object level)
-                nestingDepth: depth
+                nestingDepth: depth,
             };
             result.references.push(refInfo);
             return;
@@ -144,9 +152,7 @@ export class MagicProxyDetector {
             if (Array.isArray(value)) {
                 value.forEach((item, index) => {
                     result.metrics.propertiesScanned++;
-                    const itemPath = config.includeDetailedPaths !== false
-                        ? `${currentPath}[${index}]`
-                        : currentPath;
+                    const itemPath = config.includeDetailedPaths !== false ? `${currentPath}[${index}]` : currentPath;
                     this.scanValue(item, result, config, itemPath, depth + 1);
                 });
             }
@@ -154,7 +160,9 @@ export class MagicProxyDetector {
                 for (const [key, val] of Object.entries(value)) {
                     result.metrics.propertiesScanned++;
                     const propPath = config.includeDetailedPaths !== false
-                        ? currentPath ? `${currentPath}.${key}` : key
+                        ? currentPath
+                            ? `${currentPath}.${key}`
+                            : key
                         : currentPath;
                     this.scanValue(val, result, config, propPath, depth + 1);
                 }
@@ -170,10 +178,10 @@ export class MagicProxyDetector {
         }
         if (value && typeof value === 'object') {
             if (Array.isArray(value)) {
-                return value.some(item => this.fastScanForRefs(item, depth + 1, maxDepth));
+                return value.some((item) => this.fastScanForRefs(item, depth + 1, maxDepth));
             }
             else {
-                return Object.values(value).some(val => this.fastScanForRefs(val, depth + 1, maxDepth));
+                return Object.values(value).some((val) => this.fastScanForRefs(val, depth + 1, maxDepth));
             }
         }
         return false;
@@ -188,10 +196,10 @@ export class MagicProxyDetector {
         }
         if (value && typeof value === 'object') {
             if (Array.isArray(value)) {
-                value.forEach(item => this.extractRefs(item, refs, depth + 1, maxDepth));
+                value.forEach((item) => this.extractRefs(item, refs, depth + 1, maxDepth));
             }
             else {
-                Object.values(value).forEach(val => this.extractRefs(val, refs, depth + 1, maxDepth));
+                Object.values(value).forEach((val) => this.extractRefs(val, refs, depth + 1, maxDepth));
             }
         }
     }

package/dist/core/expressions/magic-proxy/magic-proxy-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"magic-proxy-detector.js","sourceRoot":"","sources":["../../../../src/core/expressions/magic-proxy/magic-proxy-detector.ts"],"names":[],"mappings":"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"}

package/dist/core/expressions/magic-proxy/magic-proxy-types.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Type definitions for the Magic Proxy Analyzer
+ *
+ * These interfaces extend the core analysis types with proxy-specific
+ * information for JavaScript to CEL expression conversion.
+ */
+import type { MagicProxy } from '../../types/references.js';
+import type { SchemaProxy } from '../../types/serialization.js';
+import type { AnalysisContext, CelConversionResult } from '../analysis/analyzer.js';
+/**
+ * Magic proxy analysis context with additional proxy-specific information
+ */
+export interface MagicProxyAnalysisContext extends AnalysisContext {
+    /** Schema proxy instance for schema field references */
+    schemaProxy?: SchemaProxy<any, any>;
+    /** Available resource proxies */
+    resourceProxies?: Record<string, MagicProxy<any>>;
+    /** Whether to perform deep proxy analysis */
+    deepAnalysis?: boolean;
+    /** Maximum depth for recursive analysis */
+    maxDepth?: number;
+}
+/**
+ * Result of magic proxy analysis with proxy-specific information
+ */
+export interface MagicProxyAnalysisResult extends CelConversionResult {
+    /** Detected proxy types */
+    proxyTypes: ('schema' | 'resource')[];
+    /** Schema field references found */
+    schemaReferences: string[];
+    /** Resource field references found */
+    resourceReferences: string[];
+    /** Depth of analysis performed */
+    analysisDepth: number;
+}
+//# sourceMappingURL=magic-proxy-types.d.ts.map

package/dist/core/expressions/magic-proxy/magic-proxy-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"magic-proxy-types.d.ts","sourceRoot":"","sources":["../../../../src/core/expressions/magic-proxy/magic-proxy-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEpF;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,eAAe;IAChE,wDAAwD;IACxD,WAAW,CAAC,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAEpC,iCAAiC;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAElD,6CAA6C;IAC7C,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;IACnE,2BAA2B;IAC3B,UAAU,EAAE,CAAC,QAAQ,GAAG,UAAU,CAAC,EAAE,CAAC;IAEtC,oCAAoC;IACpC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAE3B,sCAAsC;IACtC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAE7B,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/dist/core/expressions/magic-proxy/magic-proxy-types.js

@@ -0,0 +1,8 @@
+/**
+ * Type definitions for the Magic Proxy Analyzer
+ *
+ * These interfaces extend the core analysis types with proxy-specific
+ * information for JavaScript to CEL expression conversion.
+ */
+export {};
+//# sourceMappingURL=magic-proxy-types.js.map

package/dist/core/expressions/magic-proxy/magic-proxy-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"magic-proxy-types.js","sourceRoot":"","sources":["../../../../src/core/expressions/magic-proxy/magic-proxy-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/core/expressions/magic-proxy/optionality-analysis.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Core optionality analysis functions for KubernetesRef objects.
+ *
+ * These standalone functions determine whether KubernetesRef objects
+ * require null-safety handling based on Enhanced type behavior
+ * and field hydration timing.
+ */
+import type { KubernetesRef } from '../../types/common.js';
+import type { OptionalityAnalysisResult, OptionalityContext } from './optionality-types.js';
+/**
+ * Analyze a single KubernetesRef for optionality requirements
+ */
+export declare function analyzeKubernetesRefOptionality(kubernetesRef: KubernetesRef<unknown>, context: OptionalityContext): OptionalityAnalysisResult;
+/**
+ * Determine if a KubernetesRef is potentially undefined at runtime
+ */
+export declare function isPotentiallyUndefinedAtRuntime(kubernetesRef: KubernetesRef<unknown>, context: OptionalityContext): boolean;
+/**
+ * Check if a schema field is potentially undefined
+ */
+export declare function isSchemaFieldPotentiallyUndefined(kubernetesRef: KubernetesRef<unknown>, context: OptionalityContext): boolean;
+/**
+ * Check if a status field is potentially undefined
+ */
+export declare function isStatusFieldPotentiallyUndefined(kubernetesRef: KubernetesRef<unknown>, _context: OptionalityContext): boolean;
+/**
+ * Check if a spec field is potentially undefined
+ */
+export declare function isSpecFieldPotentiallyUndefined(kubernetesRef: KubernetesRef<unknown>, context: OptionalityContext): boolean;
+/**
+ * Check if a metadata field is potentially undefined
+ */
+export declare function isMetadataFieldPotentiallyUndefined(kubernetesRef: KubernetesRef<unknown>, context: OptionalityContext): boolean;
+/**
+ * Check if optional chaining was used in the original expression
+ */
+export declare function hasOptionalChainingInExpression(_kubernetesRef: KubernetesRef<unknown>, _context: OptionalityContext): boolean;
+/**
+ * Calculate confidence level for optionality analysis
+ */
+export declare function calculateOptionalityConfidence(kubernetesRef: KubernetesRef<unknown>, context: OptionalityContext): number;
+/**
+ * Determine the reason for optionality determination
+ */
+export declare function determineOptionalityReason(kubernetesRef: KubernetesRef<unknown>, _context: OptionalityContext): string;
+/**
+ * Generate suggested CEL pattern for null-safety
+ */
+export declare function generateSuggestedCelPattern(kubernetesRef: KubernetesRef<unknown>, context: OptionalityContext): string;
+/**
+ * Delegate to canonical implementation in type-guards.ts
+ */
+export declare function extractKubernetesRefsFromExpression(value: unknown): KubernetesRef<unknown>[];
+//# sourceMappingURL=optionality-analysis.d.ts.map

package/dist/core/expressions/magic-proxy/optionality-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optionality-analysis.d.ts","sourceRoot":"","sources":["../../../../src/core/expressions/magic-proxy/optionality-analysis.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5F;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,EACrC,OAAO,EAAE,kBAAkB,GAC1B,yBAAyB,CA8B3B;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,EACrC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAiCT;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAC/C,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,EACrC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CA2BT;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAC/C,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,EACrC,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAuBT;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,EACrC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CA6BT;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CACjD,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,EACrC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CA+BT;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,cAAc,EAAE,aAAa,CAAC,OAAO,CAAC,EACtC,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAIT;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,EACrC,OAAO,EAAE,kBAAkB,GAC1B,MAAM,CAmBR;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,EACrC,QAAQ,EAAE,kBAAkB,GAC3B,MAAM,CAUR;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,EACrC,OAAO,EAAE,kBAAkB,GAC1B,MAAM,CAeR;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,EAAE,CAE5F"}

package/dist/core/expressions/magic-proxy/optionality-analysis.js

@@ -0,0 +1,239 @@
+/**
+ * Core optionality analysis functions for KubernetesRef objects.
+ *
+ * These standalone functions determine whether KubernetesRef objects
+ * require null-safety handling based on Enhanced type behavior
+ * and field hydration timing.
+ */
+import { extractResourceReferences } from '../../../utils/type-guards.js';
+/**
+ * Analyze a single KubernetesRef for optionality requirements
+ */
+export function analyzeKubernetesRefOptionality(kubernetesRef, context) {
+    const isSchemaReference = kubernetesRef.resourceId === '__schema__';
+    const fieldPath = kubernetesRef.fieldPath || '';
+    // Enhanced types appear non-optional at compile time but may be undefined at runtime
+    const potentiallyUndefined = isPotentiallyUndefinedAtRuntime(kubernetesRef, context);
+    const requiresNullSafety = potentiallyUndefined && (context.conservativeNullSafety ?? true);
+    // Check if optional chaining was used in the original expression
+    const hasOptionalChaining = hasOptionalChainingInExpression(kubernetesRef, context);
+    const confidence = calculateOptionalityConfidence(kubernetesRef, context);
+    const reason = determineOptionalityReason(kubernetesRef, context);
+    const suggestedCelPattern = requiresNullSafety
+        ? generateSuggestedCelPattern(kubernetesRef, context)
+        : undefined;
+    return {
+        kubernetesRef,
+        potentiallyUndefined,
+        requiresNullSafety,
+        hasOptionalChaining,
+        fieldPath,
+        resourceId: kubernetesRef.resourceId,
+        isSchemaReference,
+        confidence,
+        reason,
+        suggestedCelPattern,
+    };
+}
+/**
+ * Determine if a KubernetesRef is potentially undefined at runtime
+ */
+export function isPotentiallyUndefinedAtRuntime(kubernetesRef, context) {
+    // Schema references are generally available, but some schema fields might be optional
+    if (kubernetesRef.resourceId === '__schema__') {
+        return isSchemaFieldPotentiallyUndefined(kubernetesRef, context);
+    }
+    // Resource status fields are potentially undefined during field hydration
+    if (kubernetesRef.fieldPath?.startsWith('status.')) {
+        return isStatusFieldPotentiallyUndefined(kubernetesRef, context);
+    }
+    // Resource spec fields might be optional
+    if (kubernetesRef.fieldPath?.startsWith('spec.')) {
+        return isSpecFieldPotentiallyUndefined(kubernetesRef, context);
+    }
+    // Resource metadata fields are generally available but some might be optional
+    if (kubernetesRef.fieldPath?.startsWith('metadata.')) {
+        return isMetadataFieldPotentiallyUndefined(kubernetesRef, context);
+    }
+    // Check hydration state if available
+    if (context.hydrationStates) {
+        const stateKey = `${kubernetesRef.resourceId}:${kubernetesRef.fieldPath}`;
+        const state = context.hydrationStates.get(stateKey);
+        if (state) {
+            return !state.isHydrated || state.hydrationFailed;
+        }
+    }
+    // Conservative approach: assume potentially undefined for Enhanced types
+    return true;
+}
+/**
+ * Check if a schema field is potentially undefined
+ */
+export function isSchemaFieldPotentiallyUndefined(kubernetesRef, context) {
+    const fieldPath = kubernetesRef.fieldPath || '';
+    // Common optional schema fields
+    const commonOptionalFields = [
+        'metadata.labels',
+        'metadata.annotations',
+        'metadata.namespace',
+        'spec.replicas',
+        'spec.resources',
+        'spec.nodeSelector',
+        'spec.tolerations',
+        'spec.affinity',
+    ];
+    // Check if this is a commonly optional field
+    if (commonOptionalFields.some((optional) => fieldPath.startsWith(optional))) {
+        return true;
+    }
+    // Check for array access which might be undefined
+    if (fieldPath.includes('[') || fieldPath.includes('.length')) {
+        return true;
+    }
+    // Schema fields are generally available, but be conservative
+    return context.conservativeNullSafety ?? true;
+}
+/**
+ * Check if a status field is potentially undefined
+ */
+export function isStatusFieldPotentiallyUndefined(kubernetesRef, _context) {
+    const fieldPath = kubernetesRef.fieldPath || '';
+    // Status fields are almost always potentially undefined during hydration
+    const alwaysUndefinedStatusFields = [
+        'status.conditions',
+        'status.loadBalancer',
+        'status.ingress',
+        'status.podIP',
+        'status.hostIP',
+        'status.phase',
+        'status.readyReplicas',
+        'status.availableReplicas',
+        'status.observedGeneration',
+    ];
+    // Check if this is a field that's commonly undefined
+    if (alwaysUndefinedStatusFields.some((field) => fieldPath.startsWith(field))) {
+        return true;
+    }
+    // All status fields are potentially undefined during field hydration
+    return true;
+}
+/**
+ * Check if a spec field is potentially undefined
+ */
+export function isSpecFieldPotentiallyUndefined(kubernetesRef, context) {
+    const fieldPath = kubernetesRef.fieldPath || '';
+    // Common optional spec fields
+    const commonOptionalSpecFields = [
+        'spec.replicas',
+        'spec.resources',
+        'spec.nodeSelector',
+        'spec.tolerations',
+        'spec.affinity',
+        'spec.volumes',
+        'spec.volumeMounts',
+        'spec.env',
+        'spec.ports',
+        'spec.selector',
+    ];
+    // Check if this is a commonly optional spec field
+    if (commonOptionalSpecFields.some((optional) => fieldPath.startsWith(optional))) {
+        return true;
+    }
+    // Check for array access
+    if (fieldPath.includes('[') || fieldPath.includes('.length')) {
+        return true;
+    }
+    // Most spec fields are required, but be conservative for Enhanced types
+    return context.conservativeNullSafety ?? false;
+}
+/**
+ * Check if a metadata field is potentially undefined
+ */
+export function isMetadataFieldPotentiallyUndefined(kubernetesRef, context) {
+    const fieldPath = kubernetesRef.fieldPath || '';
+    // Common optional metadata fields
+    const commonOptionalMetadataFields = [
+        'metadata.labels',
+        'metadata.annotations',
+        'metadata.namespace',
+        'metadata.ownerReferences',
+        'metadata.finalizers',
+    ];
+    // Check if this is a commonly optional metadata field
+    if (commonOptionalMetadataFields.some((optional) => fieldPath.startsWith(optional))) {
+        return true;
+    }
+    // Core metadata fields like name and uid are generally available
+    const coreMetadataFields = [
+        'metadata.name',
+        'metadata.uid',
+        'metadata.creationTimestamp',
+        'metadata.generation',
+    ];
+    if (coreMetadataFields.some((core) => fieldPath.startsWith(core))) {
+        return false;
+    }
+    // Be conservative for other metadata fields
+    return context.conservativeNullSafety ?? true;
+}
+/**
+ * Check if optional chaining was used in the original expression
+ */
+export function hasOptionalChainingInExpression(_kubernetesRef, _context) {
+    // This would need to be determined from the original expression AST
+    // For now, return false as a placeholder
+    return false;
+}
+/**
+ * Calculate confidence level for optionality analysis
+ */
+export function calculateOptionalityConfidence(kubernetesRef, context) {
+    let confidence = 0.8; // Base confidence
+    // Higher confidence for schema references
+    if (kubernetesRef.resourceId === '__schema__') {
+        confidence += 0.1;
+    }
+    // Lower confidence for status fields (more likely to be undefined)
+    if (kubernetesRef.fieldPath?.startsWith('status.')) {
+        confidence -= 0.2;
+    }
+    // Higher confidence if we have hydration state information
+    if (context.hydrationStates) {
+        confidence += 0.1;
+    }
+    return Math.max(0, Math.min(1, confidence));
+}
+/**
+ * Determine the reason for optionality determination
+ */
+export function determineOptionalityReason(kubernetesRef, _context) {
+    if (kubernetesRef.resourceId === '__schema__') {
+        return 'Schema reference - generally available';
+    }
+    if (kubernetesRef.fieldPath?.startsWith('status.')) {
+        return 'Status field - potentially undefined during field hydration';
+    }
+    return 'Enhanced type - appears non-optional at compile time but may be undefined at runtime';
+}
+/**
+ * Generate suggested CEL pattern for null-safety
+ */
+export function generateSuggestedCelPattern(kubernetesRef, context) {
+    const resourcePath = kubernetesRef.resourceId === '__schema__'
+        ? `schema.${kubernetesRef.fieldPath}`
+        : `resources.${kubernetesRef.resourceId}.${kubernetesRef.fieldPath}`;
+    if (context.generateHasChecks) {
+        return `has(${resourcePath}) && ${resourcePath}`;
+    }
+    if (context.useKroConditionals) {
+        return `${resourcePath}?`;
+    }
+    return resourcePath;
+}
+/**
+ * Delegate to canonical implementation in type-guards.ts
+ */
+export function extractKubernetesRefsFromExpression(value) {
+    return extractResourceReferences(value);
+}
+//# sourceMappingURL=optionality-analysis.js.map

package/dist/core/expressions/magic-proxy/optionality-analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optionality-analysis.js","sourceRoot":"","sources":["../../../../src/core/expressions/magic-proxy/optionality-analysis.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAI1E;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAC7C,aAAqC,EACrC,OAA2B;IAE3B,MAAM,iBAAiB,GAAG,aAAa,CAAC,UAAU,KAAK,YAAY,CAAC;IACpE,MAAM,SAAS,GAAG,aAAa,CAAC,SAAS,IAAI,EAAE,CAAC;IAEhD,qFAAqF;IACrF,MAAM,oBAAoB,GAAG,+BAA+B,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACrF,MAAM,kBAAkB,GAAG,oBAAoB,IAAI,CAAC,OAAO,CAAC,sBAAsB,IAAI,IAAI,CAAC,CAAC;IAE5F,iEAAiE;IACjE,MAAM,mBAAmB,GAAG,+BAA+B,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAEpF,MAAM,UAAU,GAAG,8BAA8B,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAG,0BAA0B,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAElE,MAAM,mBAAmB,GAAG,kBAAkB;QAC5C,CAAC,CAAC,2BAA2B,CAAC,aAAa,EAAE,OAAO,CAAC;QACrD,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO;QACL,aAAa;QACb,oBAAoB;QACpB,kBAAkB;QAClB,mBAAmB;QACnB,SAAS;QACT,UAAU,EAAE,aAAa,CAAC,UAAU;QACpC,iBAAiB;QACjB,UAAU;QACV,MAAM;QACN,mBAAmB;KACpB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAC7C,aAAqC,EACrC,OAA2B;IAE3B,sFAAsF;IACtF,IAAI,aAAa,CAAC,UAAU,KAAK,YAAY,EAAE,CAAC;QAC9C,OAAO,iCAAiC,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IAED,0EAA0E;IAC1E,IAAI,aAAa,CAAC,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACnD,OAAO,iCAAiC,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IAED,yCAAyC;IACzC,IAAI,aAAa,CAAC,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACjD,OAAO,+BAA+B,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAED,8EAA8E;IAC9E,IAAI,aAAa,CAAC,SAAS,EAAE,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACrD,OAAO,mCAAmC,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;IAED,qCAAqC;IACrC,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,GAAG,aAAa,CAAC,UAAU,IAAI,aAAa,CAAC,SAAS,EAAE,CAAC;QAC1E,MAAM,KAAK,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEpD,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,eAAe,CAAC;QACpD,CAAC;IACH,CAAC;IAED,yEAAyE;IACzE,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iCAAiC,CAC/C,aAAqC,EACrC,OAA2B;IAE3B,MAAM,SAAS,GAAG,aAAa,CAAC,SAAS,IAAI,EAAE,CAAC;IAEhD,gCAAgC;IAChC,MAAM,oBAAoB,GAAG;QAC3B,iBAAiB;QACjB,sBAAsB;QACtB,oBAAoB;QACpB,eAAe;QACf,gBAAgB;QAChB,mBAAmB;QACnB,kBAAkB;QAClB,eAAe;KAChB,CAAC;IAEF,6CAA6C;IAC7C,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAC5E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kDAAkD;IAClD,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6DAA6D;IAC7D,OAAO,OAAO,CAAC,sBAAsB,IAAI,IAAI,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iCAAiC,CAC/C,aAAqC,EACrC,QAA4B;IAE5B,MAAM,SAAS,GAAG,aAAa,CAAC,SAAS,IAAI,EAAE,CAAC;IAEhD,yEAAyE;IACzE,MAAM,2BAA2B,GAAG;QAClC,mBAAmB;QACnB,qBAAqB;QACrB,gBAAgB;QAChB,cAAc;QACd,eAAe;QACf,cAAc;QACd,sBAAsB;QACtB,0BAA0B;QAC1B,2BAA2B;KAC5B,CAAC;IAEF,qDAAqD;IACrD,IAAI,2BAA2B,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAC7E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qEAAqE;IACrE,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAC7C,aAAqC,EACrC,OAA2B;IAE3B,MAAM,SAAS,GAAG,aAAa,CAAC,SAAS,IAAI,EAAE,CAAC;IAEhD,8BAA8B;IAC9B,MAAM,wBAAwB,GAAG;QAC/B,eAAe;QACf,gBAAgB;QAChB,mBAAmB;QACnB,kBAAkB;QAClB,eAAe;QACf,cAAc;QACd,mBAAmB;QACnB,UAAU;QACV,YAAY;QACZ,eAAe;KAChB,CAAC;IAEF,kDAAkD;IAClD,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAChF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,yBAAyB;IACzB,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wEAAwE;IACxE,OAAO,OAAO,CAAC,sBAAsB,IAAI,KAAK,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mCAAmC,CACjD,aAAqC,EACrC,OAA2B;IAE3B,MAAM,SAAS,GAAG,aAAa,CAAC,SAAS,IAAI,EAAE,CAAC;IAEhD,kCAAkC;IAClC,MAAM,4BAA4B,GAAG;QACnC,iBAAiB;QACjB,sBAAsB;QACtB,oBAAoB;QACpB,0BAA0B;QAC1B,qBAAqB;KACtB,CAAC;IAEF,sDAAsD;IACtD,IAAI,4BAA4B,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACpF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iEAAiE;IACjE,MAAM,kBAAkB,GAAG;QACzB,eAAe;QACf,cAAc;QACd,4BAA4B;QAC5B,qBAAqB;KACtB,CAAC;IAEF,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAClE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,4CAA4C;IAC5C,OAAO,OAAO,CAAC,sBAAsB,IAAI,IAAI,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAC7C,cAAsC,EACtC,QAA4B;IAE5B,oEAAoE;IACpE,yCAAyC;IACzC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAC5C,aAAqC,EACrC,OAA2B;IAE3B,IAAI,UAAU,GAAG,GAAG,CAAC,CAAC,kBAAkB;IAExC,0CAA0C;IAC1C,IAAI,aAAa,CAAC,UAAU,KAAK,YAAY,EAAE,CAAC;QAC9C,UAAU,IAAI,GAAG,CAAC;IACpB,CAAC;IAED,mEAAmE;IACnE,IAAI,aAAa,CAAC,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACnD,UAAU,IAAI,GAAG,CAAC;IACpB,CAAC;IAED,2DAA2D;IAC3D,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;QAC5B,UAAU,IAAI,GAAG,CAAC;IACpB,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,aAAqC,EACrC,QAA4B;IAE5B,IAAI,aAAa,CAAC,UAAU,KAAK,YAAY,EAAE,CAAC;QAC9C,OAAO,wCAAwC,CAAC;IAClD,CAAC;IAED,IAAI,aAAa,CAAC,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACnD,OAAO,6DAA6D,CAAC;IACvE,CAAC;IAED,OAAO,sFAAsF,CAAC;AAChG,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,aAAqC,EACrC,OAA2B;IAE3B,MAAM,YAAY,GAChB,aAAa,CAAC,UAAU,KAAK,YAAY;QACvC,CAAC,CAAC,UAAU,aAAa,CAAC,SAAS,EAAE;QACrC,CAAC,CAAC,aAAa,aAAa,CAAC,UAAU,IAAI,aAAa,CAAC,SAAS,EAAE,CAAC;IAEzE,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;QAC9B,OAAO,OAAO,YAAY,QAAQ,YAAY,EAAE,CAAC;IACnD,CAAC;IAED,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;QAC/B,OAAO,GAAG,YAAY,GAAG,CAAC;IAC5B,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mCAAmC,CAAC,KAAc;IAChE,OAAO,yBAAyB,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC"}