semantic-complexity 0.0.1-cedf2072 → 0.0.3-38ef2e6f

package/dist/tensor/matrix.js

@@ -0,0 +1,171 @@
+/**
+ * v0.0.3: Interaction Matrix for Second-Order Tensor Analysis
+ *
+ * M[i,j] represents the interaction strength between dimensions i and j.
+ * - Diagonal: self-interaction (typically 1.0)
+ * - Off-diagonal: cross-dimension interaction
+ */
+/**
+ * Default interaction matrix (symmetric, positive semi-definite)
+ */
+export const DEFAULT_MATRIX = [
+    //  C     N     S     A     Λ
+    [1.0, 0.3, 0.2, 0.2, 0.3], // Control
+    [0.3, 1.0, 0.4, 0.8, 0.2], // Nesting × Async ↑
+    [0.2, 0.4, 1.0, 0.5, 0.9], // State × Coupling ↑↑
+    [0.2, 0.8, 0.5, 1.0, 0.4], // Async × Nesting ↑
+    [0.3, 0.2, 0.9, 0.4, 1.0], // Coupling × State ↑↑
+];
+/**
+ * Module-type specific interaction matrices
+ */
+export const MODULE_MATRICES = {
+    api: [
+        // API: Coupling interactions are critical
+        [1.0, 0.2, 0.3, 0.2, 0.4],
+        [0.2, 1.0, 0.3, 0.6, 0.2],
+        [0.3, 0.3, 1.0, 0.4, 1.5], // State × Coupling ↑↑↑
+        [0.2, 0.6, 0.4, 1.0, 0.5],
+        [0.4, 0.2, 1.5, 0.5, 1.0], // Coupling × State ↑↑↑
+    ],
+    lib: [
+        // LIB: Control/Nesting interactions are important
+        [1.0, 1.2, 0.2, 0.2, 0.2], // Control × Nesting ↑
+        [1.2, 1.0, 0.3, 0.5, 0.2], // Nesting × Control ↑
+        [0.2, 0.3, 1.0, 0.3, 0.6],
+        [0.2, 0.5, 0.3, 1.0, 0.3],
+        [0.2, 0.2, 0.6, 0.3, 1.0],
+    ],
+    app: [
+        // APP: State/Async interactions are critical
+        [1.0, 0.3, 0.3, 0.3, 0.3],
+        [0.3, 1.0, 0.5, 0.9, 0.2], // Nesting × Async ↑
+        [0.3, 0.5, 1.0, 1.3, 0.7], // State × Async ↑↑
+        [0.3, 0.9, 1.3, 1.0, 0.4], // Async × State ↑↑
+        [0.3, 0.2, 0.7, 0.4, 1.0],
+    ],
+    web: [
+        // WEB: Nesting is most important (component hierarchy)
+        [1.0, 0.5, 0.2, 0.4, 0.2],
+        [0.5, 1.5, 0.3, 0.6, 0.2], // Nesting self-weight ↑
+        [0.2, 0.3, 1.0, 0.3, 0.5],
+        [0.4, 0.6, 0.3, 1.0, 0.3],
+        [0.2, 0.2, 0.5, 0.3, 1.0],
+    ],
+    deploy: [
+        // DEPLOY: All interactions should be minimal
+        [1.0, 0.1, 0.1, 0.1, 0.2],
+        [0.1, 1.0, 0.1, 0.1, 0.1],
+        [0.1, 0.1, 1.0, 0.1, 0.3],
+        [0.1, 0.1, 0.1, 1.0, 0.2],
+        [0.2, 0.1, 0.3, 0.2, 1.0],
+    ],
+    unknown: DEFAULT_MATRIX,
+};
+/**
+ * Get interaction matrix for module type
+ */
+export function getInteractionMatrix(moduleType) {
+    return MODULE_MATRICES[moduleType] ?? DEFAULT_MATRIX;
+}
+/**
+ * Convert Vector5D to array
+ */
+export function vectorToArray(v) {
+    return [v.control, v.nesting, v.state, v.async, v.coupling];
+}
+/**
+ * Create Vector5D from array
+ */
+export function arrayToVector(arr) {
+    if (arr.length !== 5) {
+        throw new Error('Vector5D requires exactly 5 values');
+    }
+    return {
+        control: arr[0],
+        nesting: arr[1],
+        state: arr[2],
+        async: arr[3],
+        coupling: arr[4],
+    };
+}
+/**
+ * Create zero vector
+ */
+export function zeroVector() {
+    return { control: 0, nesting: 0, state: 0, async: 0, coupling: 0 };
+}
+/**
+ * Calculate L2 norm of vector
+ */
+export function vectorNorm(v) {
+    const arr = vectorToArray(v);
+    return Math.sqrt(arr.reduce((sum, x) => sum + x * x, 0));
+}
+/**
+ * Calculate dot product of two vectors
+ */
+export function dotProduct(v1, v2) {
+    const a1 = vectorToArray(v1);
+    const a2 = vectorToArray(v2);
+    return a1.reduce((sum, x, i) => sum + x * a2[i], 0);
+}
+/**
+ * Calculate quadratic form: v^T M v
+ *
+ * This captures dimension interactions.
+ */
+export function quadraticForm(v, matrix) {
+    const arr = vectorToArray(v);
+    let result = 0;
+    for (let i = 0; i < 5; i++) {
+        for (let j = 0; j < 5; j++) {
+            result += arr[i] * matrix[i][j] * arr[j];
+        }
+    }
+    return result;
+}
+/**
+ * Check if matrix is positive semi-definite using diagonal dominance
+ * (conservative approximation)
+ */
+export function isPositiveSemidefinite(matrix) {
+    for (let i = 0; i < 5; i++) {
+        let rowSum = 0;
+        for (let j = 0; j < 5; j++) {
+            if (i !== j) {
+                rowSum += Math.abs(matrix[i][j]);
+            }
+        }
+        if (matrix[i][i] < rowSum) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Euclidean distance between two vectors
+ */
+export function euclideanDistance(v1, v2) {
+    const a1 = vectorToArray(v1);
+    const a2 = vectorToArray(v2);
+    const sumSquares = a1.reduce((sum, x, i) => sum + Math.pow(x - a2[i], 2), 0);
+    return Math.sqrt(sumSquares);
+}
+/**
+ * Mahalanobis-like distance using interaction matrix
+ *
+ * δ(v, target) = sqrt((v - target)^T M (v - target))
+ */
+export function mahalanobisDistance(v, target, matrix) {
+    const diff = {
+        control: v.control - target.control,
+        nesting: v.nesting - target.nesting,
+        state: v.state - target.state,
+        async: v.async - target.async,
+        coupling: v.coupling - target.coupling,
+    };
+    const result = quadraticForm(diff, matrix);
+    return Math.sqrt(Math.abs(result));
+}
+//# sourceMappingURL=matrix.js.map

package/dist/tensor/matrix.js.map

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

package/dist/tensor/scoring.d.ts

@@ -0,0 +1,73 @@
+/**
+ * v0.0.3: Tensor-based Complexity Scoring
+ *
+ * score = v^T M v + <v, w> + ε‖v‖²
+ */
+import type { TensorScore, Vector5D, ModuleType, ConvergenceAnalysis, HodgeDecomposition, ComplexityLevel, RefactoringRecommendation } from './types.js';
+/**
+ * Default linear weights
+ */
+export declare const DEFAULT_WEIGHTS: Vector5D;
+/**
+ * Calculate tensor-based complexity score
+ *
+ * @param vector - 5D complexity vector
+ * @param moduleType - Module type for context-aware analysis
+ * @param epsilon - Regularization parameter (default: 2.0)
+ * @param weights - Linear weights (default: DEFAULT_WEIGHTS)
+ */
+export declare function calculateTensorScore(vector: Vector5D, moduleType?: ModuleType, epsilon?: number, weights?: Vector5D): TensorScore;
+/**
+ * Calculate convergence score
+ *
+ * Returns:
+ *   < 0: Safe zone (converged)
+ *   0-1: ε-neighborhood (review needed)
+ *   > 1: Violation zone
+ */
+export declare function convergenceScore(current: number, threshold: number, epsilon: number): number;
+/**
+ * Estimate Lipschitz constant from two points
+ *
+ * k = |f(x) - f(y)| / |x - y|
+ * For contraction mapping, we need k < 1
+ */
+export declare function estimateLipschitz(v1: Vector5D, v2: Vector5D, score1: number, score2: number): number;
+/**
+ * Analyze convergence status
+ */
+export declare function analyzeConvergence(score: number, threshold?: number, epsilon?: number, options?: {
+    prevVector?: Vector5D;
+    currVector?: Vector5D;
+    prevScore?: number;
+    isOscillating?: boolean;
+}): ConvergenceAnalysis;
+/**
+ * Hodge decomposition of complexity vector
+ *
+ * - H^{2,0} (holomorphic): Control + Nesting → Local algorithmic
+ * - H^{0,2} (anti-holomorphic): State + Coupling → Global structural
+ * - H^{1,1} (harmonic): Async → Mixed/balanced
+ */
+export declare function hodgeDecomposition(vector: Vector5D, weights?: Vector5D): HodgeDecomposition;
+/**
+ * Classify complexity score into level
+ */
+export declare function classifyComplexityLevel(score: number): ComplexityLevel;
+/**
+ * Generate refactoring recommendations based on vector analysis
+ */
+export declare function recommendRefactoring(vector: Vector5D, weights?: Vector5D): RefactoringRecommendation[];
+/**
+ * Check if in safe zone (below threshold - ε)
+ */
+export declare function isSafe(score: TensorScore): boolean;
+/**
+ * Check if needs review (in ε-neighborhood)
+ */
+export declare function needsReview(score: TensorScore): boolean;
+/**
+ * Check if violates threshold
+ */
+export declare function isViolation(score: TensorScore): boolean;
+//# sourceMappingURL=scoring.d.ts.map

package/dist/tensor/scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../src/tensor/scoring.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EACR,UAAU,EACV,mBAAmB,EAEnB,kBAAkB,EAClB,eAAe,EACf,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAUpB;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,QAM7B,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,QAAQ,EAChB,UAAU,GAAE,UAAsB,EAClC,OAAO,GAAE,MAAY,EACrB,OAAO,GAAE,QAA0B,GAClC,WAAW,CAwBb;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,MAAM,CAMR;AAYD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,EACZ,EAAE,EAAE,QAAQ,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,MAAM,CAeR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,MAAa,EACxB,OAAO,GAAE,MAAY,EACrB,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,QAAQ,CAAC;IACtB,UAAU,CAAC,EAAE,QAAQ,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GACA,mBAAmB,CAyBrB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,QAAQ,EAChB,OAAO,GAAE,QAA0B,GAClC,kBAAkB,CAqBpB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAMtE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,QAAQ,EAChB,OAAO,GAAE,QAA0B,GAClC,yBAAyB,EAAE,CAqC7B;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAElD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAEvD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAEvD"}

package/dist/tensor/scoring.js

@@ -0,0 +1,206 @@
+/**
+ * v0.0.3: Tensor-based Complexity Scoring
+ *
+ * score = v^T M v + <v, w> + ε‖v‖²
+ */
+import { getInteractionMatrix, quadraticForm, dotProduct, vectorNorm, vectorToArray, } from './matrix.js';
+/**
+ * Default linear weights
+ */
+export const DEFAULT_WEIGHTS = {
+    control: 1.0,
+    nesting: 1.5,
+    state: 2.0,
+    async: 2.5,
+    coupling: 3.0,
+};
+/**
+ * Calculate tensor-based complexity score
+ *
+ * @param vector - 5D complexity vector
+ * @param moduleType - Module type for context-aware analysis
+ * @param epsilon - Regularization parameter (default: 2.0)
+ * @param weights - Linear weights (default: DEFAULT_WEIGHTS)
+ */
+export function calculateTensorScore(vector, moduleType = 'unknown', epsilon = 2.0, weights = DEFAULT_WEIGHTS) {
+    // Get interaction matrix for module type
+    const matrix = getInteractionMatrix(moduleType);
+    // Calculate components
+    const linear = dotProduct(vector, weights);
+    const quadratic = quadraticForm(vector, matrix) * 0.1; // Scale factor
+    const raw = linear + quadratic;
+    // ε-regularization
+    const normSquared = Math.pow(vectorNorm(vector), 2);
+    const regularization = epsilon * normSquared * 0.01; // Scale factor
+    const regularized = raw + regularization;
+    return {
+        linear: Math.round(linear * 100) / 100,
+        quadratic: Math.round(quadratic * 100) / 100,
+        raw: Math.round(raw * 100) / 100,
+        regularization: Math.round(regularization * 100) / 100,
+        regularized: Math.round(regularized * 100) / 100,
+        epsilon,
+        moduleType,
+        vector,
+    };
+}
+/**
+ * Calculate convergence score
+ *
+ * Returns:
+ *   < 0: Safe zone (converged)
+ *   0-1: ε-neighborhood (review needed)
+ *   > 1: Violation zone
+ */
+export function convergenceScore(current, threshold, epsilon) {
+    if (epsilon === 0) {
+        return current > threshold - epsilon ? Infinity : 0;
+    }
+    const target = threshold - epsilon;
+    return (current - target) / epsilon;
+}
+/**
+ * Determine convergence status from score
+ */
+function getConvergenceStatus(convScore, isOscillating = false) {
+    if (isOscillating)
+        return 'oscillating';
+    if (convScore < 0)
+        return 'safe';
+    if (convScore < 1)
+        return 'review';
+    return 'violation';
+}
+/**
+ * Estimate Lipschitz constant from two points
+ *
+ * k = |f(x) - f(y)| / |x - y|
+ * For contraction mapping, we need k < 1
+ */
+export function estimateLipschitz(v1, v2, score1, score2) {
+    const a1 = vectorToArray(v1);
+    const a2 = vectorToArray(v2);
+    // Calculate vector distance
+    const vDist = Math.sqrt(a1.reduce((sum, x, i) => sum + Math.pow(x - a2[i], 2), 0));
+    if (vDist < 1e-10)
+        return 0;
+    // Calculate score distance
+    const sDist = Math.abs(score1 - score2);
+    return sDist / vDist;
+}
+/**
+ * Analyze convergence status
+ */
+export function analyzeConvergence(score, threshold = 10.0, epsilon = 2.0, options) {
+    const target = threshold - epsilon;
+    const convScore = convergenceScore(score, threshold, epsilon);
+    // Estimate Lipschitz constant if vectors provided
+    let lipschitzEstimate = 0;
+    if (options?.prevVector && options?.currVector && options?.prevScore !== undefined) {
+        lipschitzEstimate = estimateLipschitz(options.prevVector, options.currVector, options.prevScore, score);
+    }
+    return {
+        score,
+        threshold,
+        epsilon,
+        convergenceScore: Math.round(convScore * 1000) / 1000,
+        status: getConvergenceStatus(convScore, options?.isOscillating),
+        distanceToTarget: Math.round((score - target) * 100) / 100,
+        distanceToThreshold: Math.round((threshold - score) * 100) / 100,
+        lipschitzEstimate: Math.round(lipschitzEstimate * 1000) / 1000,
+    };
+}
+/**
+ * Hodge decomposition of complexity vector
+ *
+ * - H^{2,0} (holomorphic): Control + Nesting → Local algorithmic
+ * - H^{0,2} (anti-holomorphic): State + Coupling → Global structural
+ * - H^{1,1} (harmonic): Async → Mixed/balanced
+ */
+export function hodgeDecomposition(vector, weights = DEFAULT_WEIGHTS) {
+    // Algorithmic: Control + Nesting
+    const algorithmic = vector.control * weights.control + vector.nesting * weights.nesting;
+    // Architectural: State + Coupling
+    const architectural = vector.state * weights.state + vector.coupling * weights.coupling;
+    // Balanced: Async (bridges both worlds)
+    const balanced = vector.async * weights.async;
+    const total = algorithmic + architectural + balanced;
+    const balanceRatio = total > 0 ? balanced / total : 0;
+    return {
+        algorithmic: Math.round(algorithmic * 100) / 100,
+        architectural: Math.round(architectural * 100) / 100,
+        balanced: Math.round(balanced * 100) / 100,
+        total: Math.round(total * 100) / 100,
+        balanceRatio: Math.round(balanceRatio * 1000) / 1000,
+        isHarmonic: balanceRatio >= 0.3,
+    };
+}
+/**
+ * Classify complexity score into level
+ */
+export function classifyComplexityLevel(score) {
+    if (score < 2)
+        return 'minimal';
+    if (score < 5)
+        return 'low';
+    if (score < 10)
+        return 'medium';
+    if (score < 20)
+        return 'high';
+    return 'extreme';
+}
+/**
+ * Generate refactoring recommendations based on vector analysis
+ */
+export function recommendRefactoring(vector, weights = DEFAULT_WEIGHTS) {
+    const dimensions = ['control', 'nesting', 'state', 'async', 'coupling'];
+    const arr = vectorToArray(vector);
+    const wArr = vectorToArray(weights);
+    // Calculate weighted contributions
+    const weighted = arr.map((v, i) => v * wArr[i]);
+    const total = weighted.reduce((sum, w) => sum + w, 0);
+    if (total === 0)
+        return [];
+    // Calculate contributions and sort by weight
+    const contributions = dimensions.map((dim, i) => ({
+        dimension: dim,
+        weighted: weighted[i],
+        percentage: weighted[i] / total,
+    }));
+    contributions.sort((a, b) => b.weighted - a.weighted);
+    // Generate recommendations for top contributors
+    const actions = {
+        control: 'Extract complex conditionals into separate functions',
+        nesting: 'Flatten nested structures using early returns or guard clauses',
+        state: 'Reduce state mutations; consider immutable patterns',
+        async: 'Simplify async flow; reduce callback nesting',
+        coupling: 'Extract dependencies; use dependency injection',
+    };
+    return contributions
+        .filter(c => c.percentage >= 0.1) // Only dimensions contributing >= 10%
+        .map(c => ({
+        dimension: c.dimension,
+        priority: Math.min(5, Math.floor(c.percentage * 10) + 1),
+        action: actions[c.dimension],
+        expectedImpact: Math.round(c.weighted * 0.3 * 100) / 100, // Assume 30% reduction
+    }));
+}
+/**
+ * Check if in safe zone (below threshold - ε)
+ */
+export function isSafe(score) {
+    return score.regularized < 8.0; // threshold(10) - ε(2)
+}
+/**
+ * Check if needs review (in ε-neighborhood)
+ */
+export function needsReview(score) {
+    return score.regularized >= 8.0 && score.regularized < 10.0;
+}
+/**
+ * Check if violates threshold
+ */
+export function isViolation(score) {
+    return score.regularized >= 10.0;
+}
+//# sourceMappingURL=scoring.js.map

package/dist/tensor/scoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.js","sourceRoot":"","sources":["../../src/tensor/scoring.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,UAAU,EACV,UAAU,EACV,aAAa,GACd,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAa;IACvC,OAAO,EAAE,GAAG;IACZ,OAAO,EAAE,GAAG;IACZ,KAAK,EAAE,GAAG;IACV,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;CACd,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAgB,EAChB,aAAyB,SAAS,EAClC,UAAkB,GAAG,EACrB,UAAoB,eAAe;IAEnC,yCAAyC;IACzC,MAAM,MAAM,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAEhD,uBAAuB;IACvB,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,eAAe;IACtE,MAAM,GAAG,GAAG,MAAM,GAAG,SAAS,CAAC;IAE/B,mBAAmB;IACnB,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACpD,MAAM,cAAc,GAAG,OAAO,GAAG,WAAW,GAAG,IAAI,CAAC,CAAC,eAAe;IACpE,MAAM,WAAW,GAAG,GAAG,GAAG,cAAc,CAAC;IAEzC,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG;QACtC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,GAAG,CAAC,GAAG,GAAG;QAC5C,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG;QAChC,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,GAAG,CAAC,GAAG,GAAG;QACtD,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,GAAG,GAAG;QAChD,OAAO;QACP,UAAU;QACV,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAe,EACf,SAAiB,EACjB,OAAe;IAEf,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;QAClB,OAAO,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACnC,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,SAAiB,EAAE,gBAAyB,KAAK;IAC7E,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IACxC,IAAI,SAAS,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IACjC,IAAI,SAAS,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IACnC,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,EAAY,EACZ,EAAY,EACZ,MAAc,EACd,MAAc;IAEd,MAAM,EAAE,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC;IAC7B,MAAM,EAAE,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC;IAE7B,4BAA4B;IAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CACrB,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAC1D,CAAC;IAEF,IAAI,KAAK,GAAG,KAAK;QAAE,OAAO,CAAC,CAAC;IAE5B,2BAA2B;IAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAExC,OAAO,KAAK,GAAG,KAAK,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAa,EACb,YAAoB,IAAI,EACxB,UAAkB,GAAG,EACrB,OAKC;IAED,MAAM,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACnC,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAE9D,kDAAkD;IAClD,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,IAAI,OAAO,EAAE,UAAU,IAAI,OAAO,EAAE,UAAU,IAAI,OAAO,EAAE,SAAS,KAAK,SAAS,EAAE,CAAC;QACnF,iBAAiB,GAAG,iBAAiB,CACnC,OAAO,CAAC,UAAU,EAClB,OAAO,CAAC,UAAU,EAClB,OAAO,CAAC,SAAS,EACjB,KAAK,CACN,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK;QACL,SAAS;QACT,OAAO;QACP,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,IAAI;QACrD,MAAM,EAAE,oBAAoB,CAAC,SAAS,EAAE,OAAO,EAAE,aAAa,CAAC;QAC/D,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG;QAC1D,mBAAmB,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG;QAChE,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAAG,IAAI;KAC/D,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAgB,EAChB,UAAoB,eAAe;IAEnC,iCAAiC;IACjC,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAExF,kCAAkC;IAClC,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAExF,wCAAwC;IACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAE9C,MAAM,KAAK,GAAG,WAAW,GAAG,aAAa,GAAG,QAAQ,CAAC;IACrD,MAAM,YAAY,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAEtD,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,GAAG,GAAG;QAChD,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,GAAG,GAAG;QACpD,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,GAAG,GAAG;QAC1C,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG;QACpC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,IAAI;QACpD,UAAU,EAAE,YAAY,IAAI,GAAG;KAChC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5B,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,QAAQ,CAAC;IAChC,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,MAAM,CAAC;IAC9B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAgB,EAChB,UAAoB,eAAe;IAEnC,MAAM,UAAU,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAU,CAAC;IACjF,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAEpC,mCAAmC;IACnC,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAEtD,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAE3B,6CAA6C;IAC7C,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAChD,SAAS,EAAE,GAAG;QACd,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;QACrB,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK;KAChC,CAAC,CAAC,CAAC;IAEJ,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAEtD,gDAAgD;IAChD,MAAM,OAAO,GAA2B;QACtC,OAAO,EAAE,sDAAsD;QAC/D,OAAO,EAAE,gEAAgE;QACzE,KAAK,EAAE,qDAAqD;QAC5D,KAAK,EAAE,8CAA8C;QACrD,QAAQ,EAAE,gDAAgD;KAC3D,CAAC;IAEF,OAAO,aAAa;SACjB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC,sCAAsC;SACvE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACT,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QACxD,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5B,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,GAAG,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,EAAE,uBAAuB;KAClF,CAAC,CAAC,CAAC;AACR,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,KAAkB;IACvC,OAAO,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,uBAAuB;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAkB;IAC5C,OAAO,KAAK,CAAC,WAAW,IAAI,GAAG,IAAI,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAkB;IAC5C,OAAO,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC;AACnC,CAAC"}

package/dist/tensor/types.d.ts

@@ -0,0 +1,176 @@
+/**
+ * v0.0.3: Tensor Types
+ *
+ * Mathematical foundation:
+ *   score^(2) = v^T M v + <v, w>
+ */
+/**
+ * 5-dimensional complexity vector
+ */
+export interface Vector5D {
+    control: number;
+    nesting: number;
+    state: number;
+    async: number;
+    coupling: number;
+}
+/**
+ * Module type for context-aware analysis
+ */
+export type ModuleType = 'api' | 'lib' | 'app' | 'web' | 'deploy' | 'unknown';
+/**
+ * Dimension indices
+ */
+export declare const IDX_CONTROL = 0;
+export declare const IDX_NESTING = 1;
+export declare const IDX_STATE = 2;
+export declare const IDX_ASYNC = 3;
+export declare const IDX_COUPLING = 4;
+/**
+ * 5x5 Interaction Matrix
+ */
+export type Matrix5x5 = [
+    [
+        number,
+        number,
+        number,
+        number,
+        number
+    ],
+    [
+        number,
+        number,
+        number,
+        number,
+        number
+    ],
+    [
+        number,
+        number,
+        number,
+        number,
+        number
+    ],
+    [
+        number,
+        number,
+        number,
+        number,
+        number
+    ],
+    [
+        number,
+        number,
+        number,
+        number,
+        number
+    ]
+];
+/**
+ * Tensor score result
+ */
+export interface TensorScore {
+    /** Linear component: <v, w> */
+    linear: number;
+    /** Quadratic component: v^T M v */
+    quadratic: number;
+    /** Raw score: linear + quadratic */
+    raw: number;
+    /** Regularization term: ε‖v‖² */
+    regularization: number;
+    /** Final regularized score */
+    regularized: number;
+    /** Epsilon value used */
+    epsilon: number;
+    /** Module type used */
+    moduleType: ModuleType;
+    /** Complexity vector */
+    vector: Vector5D;
+}
+/**
+ * Convergence status
+ */
+export type ConvergenceStatus = 'safe' | 'review' | 'violation' | 'oscillating';
+/**
+ * Convergence analysis result
+ */
+export interface ConvergenceAnalysis {
+    /** Current score */
+    score: number;
+    /** Threshold value */
+    threshold: number;
+    /** Epsilon value */
+    epsilon: number;
+    /** Convergence score: (score - target) / ε */
+    convergenceScore: number;
+    /** Status based on convergence score */
+    status: ConvergenceStatus;
+    /** Distance to target (threshold - ε) */
+    distanceToTarget: number;
+    /** Distance to threshold */
+    distanceToThreshold: number;
+    /** Lipschitz constant estimate */
+    lipschitzEstimate: number;
+}
+/**
+ * Hodge decomposition result
+ *
+ * H^k(Code) = ⊕_{p+q=k} H^{p,q}(Code)
+ */
+export interface HodgeDecomposition {
+    /** H^{2,0}: Control + Nesting (algorithmic) */
+    algorithmic: number;
+    /** H^{0,2}: State + Coupling (architectural) */
+    architectural: number;
+    /** H^{1,1}: Async (balanced/harmonic) */
+    balanced: number;
+    /** Total complexity */
+    total: number;
+    /** Balance ratio: balanced / total */
+    balanceRatio: number;
+    /** Is in harmonic state (well-balanced) */
+    isHarmonic: boolean;
+}
+/**
+ * Complexity level classification
+ */
+export type ComplexityLevel = 'minimal' | 'low' | 'medium' | 'high' | 'extreme';
+/**
+ * Deviation from canonical form result
+ */
+export interface DeviationResult {
+    /** Euclidean distance to canonical centroid */
+    euclideanDistance: number;
+    /** Mahalanobis-like distance using interaction matrix */
+    mahalanobisDistance: number;
+    /** Maximum deviation in any dimension */
+    maxDimensionDeviation: number;
+    /** Normalized deviation (0-1 scale) */
+    normalizedDeviation: number;
+    /** Whether vector is within canonical bounds */
+    isCanonical: boolean;
+    /** Whether vector is outside ALL canonical regions */
+    isOrphan: boolean;
+    /** Module type used for comparison */
+    moduleType: ModuleType;
+    /** Current vector */
+    vector: Vector5D;
+    /** Dimensions that violate canonical bounds */
+    violationDimensions: string[];
+    /** Status: canonical | deviated | orphan */
+    status: 'canonical' | 'deviated' | 'orphan';
+}
+/**
+ * Refactoring recommendation
+ */
+export interface RefactoringRecommendation {
+    /** Dimension to address */
+    dimension: string;
+    /** Priority (1-5, higher = more urgent) */
+    priority: number;
+    /** Recommended action */
+    action: string;
+    /** Expected impact on score */
+    expectedImpact: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tensor/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tensor/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,eAAO,MAAM,SAAS,IAAI,CAAC;AAC3B,eAAO,MAAM,SAAS,IAAI,CAAC;AAC3B,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB;QAAC,MAAM;QAAE,MAAM;QAAE,MAAM;QAAE,MAAM;QAAE,MAAM;KAAC;IACxC;QAAC,MAAM;QAAE,MAAM;QAAE,MAAM;QAAE,MAAM;QAAE,MAAM;KAAC;IACxC;QAAC,MAAM;QAAE,MAAM;QAAE,MAAM;QAAE,MAAM;QAAE,MAAM;KAAC;IACxC;QAAC,MAAM;QAAE,MAAM;QAAE,MAAM;QAAE,MAAM;QAAE,MAAM;KAAC;IACxC;QAAC,MAAM;QAAE,MAAM;QAAE,MAAM;QAAE,MAAM;QAAE,MAAM;KAAC;CACzC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,wBAAwB;IACxB,MAAM,EAAE,QAAQ,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,gBAAgB,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,4BAA4B;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kCAAkC;IAClC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yDAAyD;IACzD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,yCAAyC;IACzC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uCAAuC;IACvC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gDAAgD;IAChD,WAAW,EAAE,OAAO,CAAC;IACrB,sDAAsD;IACtD,QAAQ,EAAE,OAAO,CAAC;IAClB,sCAAsC;IACtC,UAAU,EAAE,UAAU,CAAC;IACvB,qBAAqB;IACrB,MAAM,EAAE,QAAQ,CAAC;IACjB,+CAA+C;IAC/C,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,4CAA4C;IAC5C,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,cAAc,EAAE,MAAM,CAAC;CACxB"}

package/dist/tensor/types.js

@@ -0,0 +1,15 @@
+/**
+ * v0.0.3: Tensor Types
+ *
+ * Mathematical foundation:
+ *   score^(2) = v^T M v + <v, w>
+ */
+/**
+ * Dimension indices
+ */
+export const IDX_CONTROL = 0;
+export const IDX_NESTING = 1;
+export const IDX_STATE = 2;
+export const IDX_ASYNC = 3;
+export const IDX_COUPLING = 4;
+//# sourceMappingURL=types.js.map

package/dist/tensor/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tensor/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAC7B,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAC7B,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC;AAC3B,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC;AAC3B,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC"}