semantic-complexity 0.0.2-1895c257 → 0.0.3-38ef2e6f

package/dist/index.d.ts

@@ -1,7 +1,13 @@
 /**
- * semantic-complexity - Multi-dimensional code complexity analyzer
+ * semantic-complexity - Multi-dimensional code complexity analyzer (v0.0.3)
  *
  * Core 엔진 모듈
+ *
+ * v0.0.3 Features:
+ * - Second-order tensor: score = v^T M v + <v, w>
+ * - ε-regularization for convergence
+ * - Module-type canonical profiles
+ * - Hodge decomposition of complexity space
  */
 export type { SourceLocation, FunctionInfo, ParameterInfo, ComplexityResult, ComplexityDetail, ComplexityContributor, FileAnalysisResult, ImportInfo, ImportSpecifier, ExportInfo, DependencyNode, CallNode, CallEdge, AnalysisContext, ProjectInfo, AnalysisOptions, DimensionalComplexity, DimensionalWeights, ExtendedComplexityResult, } from './types.js';
 export { DEFAULT_OPTIONS } from './types.js';
@@ -14,6 +20,11 @@ export { MODULE_TYPE_INFO, DEFAULT_META_WEIGHTS, LEVEL_RANGES, CANONICAL_PROFILE
 export type { GateType, GateInfo, ViolationSeverity, Violation, DeltaAnalysis, DeltaThresholds, GateDecision, GateResult, GatePipelineResult, } from './gates/index.js';
 export { GATE_RESPONSIBILITIES, GATE_INFO, DEFAULT_DELTA_THRESHOLDS, calculateDelta, calculateDeltaPercent, detectViolations, analyzeDelta, checkGate, runGatePipeline, createSnapshot, } from './gates/index.js';
 export { calculateSecurity, calculateContext, calculateBehavior, toMetaDimensions, calculateMetaWeightedSum, normalizeMetaDimensions, metaDistance, addMetaDimensions, subtractMetaDimensions, ZERO_META, } from './metrics/meta.js';
+export type { Vector5D, ModuleType as TensorModuleType, Matrix5x5, TensorScore, ConvergenceStatus as TensorConvergenceStatus, ConvergenceAnalysis, HodgeDecomposition, ComplexityLevel, DeviationResult, RefactoringRecommendation, CanonicalBounds, } from './tensor/index.js';
+export { IDX_CONTROL, IDX_NESTING, IDX_STATE, IDX_ASYNC, IDX_COUPLING, DEFAULT_MATRIX, MODULE_MATRICES, DEFAULT_WEIGHTS, CANONICAL_5D_PROFILES, } from './tensor/index.js';
+export { getInteractionMatrix, vectorToArray, arrayToVector, zeroVector, vectorNorm, dotProduct, quadraticForm, isPositiveSemidefinite, euclideanDistance, mahalanobisDistance, } from './tensor/index.js';
+export { calculateTensorScore, convergenceScore, estimateLipschitz, analyzeConvergence as analyzeTensorConvergence, hodgeDecomposition, classifyComplexityLevel, recommendRefactoring, isSafe, needsReview, isViolation, } from './tensor/index.js';
+export { getCanonicalProfile, getProfileCentroid, isWithinCanonicalBounds, getViolationDimensions, isOrphan, analyzeDeviation, findBestModuleType as findBestTensorModuleType, } from './tensor/index.js';
 import type { FileAnalysisResult } from './types.js';
 /**
  * 파일 경로로 복잡도 분석

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,cAAc,EACd,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,UAAU,EACV,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,WAAW,EACX,eAAe,EAEf,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG7C,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,cAAc,GACf,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,eAAe,EACf,uBAAuB,EACvB,WAAW,EACX,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,eAAe,EACf,SAAS,EACT,WAAW,EACX,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGpE,YAAY,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,WAAW,EACX,KAAK,EACL,cAAc,EACd,gBAAgB,EAChB,QAAQ,EACR,SAAS,EACT,iBAAiB,EACjB,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,sBAAsB,EACtB,UAAU,EACV,sBAAsB,EACtB,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,0BAA0B,EAC1B,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,eAAe,EACf,YAAY,EACZ,UAAU,EACV,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,qBAAqB,EACrB,SAAS,EACT,wBAAwB,EACxB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,eAAe,EACf,cAAc,GACf,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,YAAY,EACZ,iBAAiB,EACjB,sBAAsB,EACtB,SAAS,GACV,MAAM,mBAAmB,CAAC;AAO3B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAIpE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,QAAQ,SAAa,GACpB,kBAAkB,CAGpB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,YAAY,EACV,cAAc,EACd,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,UAAU,EACV,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,WAAW,EACX,eAAe,EAEf,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG7C,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,cAAc,GACf,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,eAAe,EACf,uBAAuB,EACvB,WAAW,EACX,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,eAAe,EACf,SAAS,EACT,WAAW,EACX,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGpE,YAAY,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,WAAW,EACX,KAAK,EACL,cAAc,EACd,gBAAgB,EAChB,QAAQ,EACR,SAAS,EACT,iBAAiB,EACjB,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,sBAAsB,EACtB,UAAU,EACV,sBAAsB,EACtB,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,0BAA0B,EAC1B,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,eAAe,EACf,YAAY,EACZ,UAAU,EACV,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,qBAAqB,EACrB,SAAS,EACT,wBAAwB,EACxB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,eAAe,EACf,cAAc,GACf,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,YAAY,EACZ,iBAAiB,EACjB,sBAAsB,EACtB,SAAS,GACV,MAAM,mBAAmB,CAAC;AAK3B,YAAY,EACV,QAAQ,EACR,UAAU,IAAI,gBAAgB,EAC9B,SAAS,EACT,WAAW,EACX,iBAAiB,IAAI,uBAAuB,EAC5C,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,WAAW,EACX,WAAW,EACX,SAAS,EACT,SAAS,EACT,YAAY,EACZ,cAAc,EACd,eAAe,EACf,eAAe,EACf,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,UAAU,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACb,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,IAAI,wBAAwB,EAC9C,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,MAAM,EACN,WAAW,EACX,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,IAAI,wBAAwB,GAC/C,MAAM,mBAAmB,CAAC;AAO3B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAIpE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,QAAQ,SAAa,GACpB,kBAAkB,CAGpB"}

package/dist/index.js

@@ -1,7 +1,13 @@
 /**
- * semantic-complexity - Multi-dimensional code complexity analyzer
+ * semantic-complexity - Multi-dimensional code complexity analyzer (v0.0.3)
  *
  * Core 엔진 모듈
+ *
+ * v0.0.3 Features:
+ * - Second-order tensor: score = v^T M v + <v, w>
+ * - ε-regularization for convergence
+ * - Module-type canonical profiles
+ * - Hodge decomposition of complexity space
  */
 export { DEFAULT_OPTIONS } from './types.js';
 // AST
@@ -16,6 +22,14 @@ export { MODULE_TYPE_INFO, DEFAULT_META_WEIGHTS, LEVEL_RANGES, CANONICAL_PROFILE
 export { GATE_RESPONSIBILITIES, GATE_INFO, DEFAULT_DELTA_THRESHOLDS, calculateDelta, calculateDeltaPercent, detectViolations, analyzeDelta, checkGate, runGatePipeline, createSnapshot, } from './gates/index.js';
 // Meta Dimensions (v0.0.2)
 export { calculateSecurity, calculateContext, calculateBehavior, toMetaDimensions, calculateMetaWeightedSum, normalizeMetaDimensions, metaDistance, addMetaDimensions, subtractMetaDimensions, ZERO_META, } from './metrics/meta.js';
+// Tensor constants
+export { IDX_CONTROL, IDX_NESTING, IDX_STATE, IDX_ASYNC, IDX_COUPLING, DEFAULT_MATRIX, MODULE_MATRICES, DEFAULT_WEIGHTS, CANONICAL_5D_PROFILES, } from './tensor/index.js';
+// Tensor matrix operations
+export { getInteractionMatrix, vectorToArray, arrayToVector, zeroVector, vectorNorm, dotProduct, quadraticForm, isPositiveSemidefinite, euclideanDistance, mahalanobisDistance, } from './tensor/index.js';
+// Tensor scoring
+export { calculateTensorScore, convergenceScore, estimateLipschitz, analyzeConvergence as analyzeTensorConvergence, hodgeDecomposition, classifyComplexityLevel, recommendRefactoring, isSafe, needsReview, isViolation, } from './tensor/index.js';
+// Tensor canonical profiles
+export { getCanonicalProfile, getProfileCentroid, isWithinCanonicalBounds, getViolationDimensions, isOrphan, analyzeDeviation, findBestModuleType as findBestTensorModuleType, } from './tensor/index.js';
 // ─── Convenience Functions ───────────────────────────────────────
 import * as fs from 'node:fs';
 import { parseSourceFile } from './ast/index.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0BH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM;AACN,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,UAAU;AACV,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,eAAe,EACf,uBAAuB,EACvB,WAAW,EACX,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAE5B,QAAQ;AACR,OAAO,EACL,eAAe,EACf,SAAS,EACT,WAAW,EACX,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,UAAU;AACV,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAmBpE,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,sBAAsB,EACtB,UAAU,EACV,sBAAsB,EACtB,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,0BAA0B,EAC1B,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAe9B,OAAO,EACL,qBAAqB,EACrB,SAAS,EACT,wBAAwB,EACxB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,eAAe,EACf,cAAc,GACf,MAAM,kBAAkB,CAAC;AAE1B,2BAA2B;AAC3B,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,YAAY,EACZ,iBAAiB,EACjB,sBAAsB,EACtB,SAAS,GACV,MAAM,mBAAmB,CAAC;AAE3B,oEAAoE;AAEpE,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACtD,OAAO,WAAW,CAAC,UAAU,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAc,EACd,QAAQ,GAAG,UAAU;IAErB,MAAM,UAAU,GAAG,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACrD,OAAO,WAAW,CAAC,UAAU,CAAC,CAAC;AACjC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tensor/canonical.d.ts

@@ -0,0 +1,53 @@
+/**
+ * v0.0.3: Canonical Profiles and Deviation Analysis
+ *
+ * Φ: ModuleType → CanonicalProfile
+ * δ(v, Φ(τ)) = ‖v - Φ(τ)‖_M (Mahalanobis-like distance)
+ */
+import type { Vector5D, ModuleType, DeviationResult } from './types.js';
+/**
+ * Canonical profile bounds for a module type
+ */
+export interface CanonicalBounds {
+    control: [number, number];
+    nesting: [number, number];
+    state: [number, number];
+    async: [number, number];
+    coupling: [number, number];
+}
+/**
+ * Canonical profiles per module type (based on v0.0.3 spec)
+ */
+export declare const CANONICAL_5D_PROFILES: Record<ModuleType, CanonicalBounds>;
+/**
+ * Get canonical profile for module type
+ */
+export declare function getCanonicalProfile(moduleType: ModuleType): CanonicalBounds;
+/**
+ * Calculate centroid of canonical profile
+ */
+export declare function getProfileCentroid(profile: CanonicalBounds): Vector5D;
+/**
+ * Check if vector is within canonical bounds
+ */
+export declare function isWithinCanonicalBounds(vector: Vector5D, profile: CanonicalBounds): boolean;
+/**
+ * Get dimensions that violate canonical bounds
+ */
+export declare function getViolationDimensions(vector: Vector5D, profile: CanonicalBounds): string[];
+/**
+ * Check if vector is orphan (outside ALL canonical regions)
+ */
+export declare function isOrphan(vector: Vector5D): boolean;
+/**
+ * Analyze deviation from canonical form
+ */
+export declare function analyzeDeviation(vector: Vector5D, moduleType?: ModuleType): DeviationResult;
+/**
+ * Find the best fitting module type for a vector
+ */
+export declare function findBestModuleType(vector: Vector5D): {
+    type: ModuleType;
+    distance: number;
+};
+//# sourceMappingURL=canonical.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../../src/tensor/canonical.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAQxE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5B;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,UAAU,EAAE,eAAe,CA2CrE,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe,CAE3E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAQrE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,eAAe,GACvB,OAAO,CAQT;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,eAAe,GACvB,MAAM,EAAE,CAaV;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CASlD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,QAAQ,EAChB,UAAU,GAAE,UAAsB,GACjC,eAAe,CA2CjB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAsB3F"}

package/dist/tensor/canonical.js

@@ -0,0 +1,178 @@
+/**
+ * v0.0.3: Canonical Profiles and Deviation Analysis
+ *
+ * Φ: ModuleType → CanonicalProfile
+ * δ(v, Φ(τ)) = ‖v - Φ(τ)‖_M (Mahalanobis-like distance)
+ */
+import { getInteractionMatrix, euclideanDistance, mahalanobisDistance, vectorToArray, } from './matrix.js';
+/**
+ * Canonical profiles per module type (based on v0.0.3 spec)
+ */
+export const CANONICAL_5D_PROFILES = {
+    api: {
+        control: [0, 5], // low: thin controllers
+        nesting: [0, 3], // low: flat structure
+        state: [0, 2], // low: stateless preferred
+        async: [0, 3], // low: simple I/O
+        coupling: [0, 3], // low: explicit deps
+    },
+    lib: {
+        control: [0, 10], // medium: algorithmic complexity ok
+        nesting: [0, 5], // medium: some depth acceptable
+        state: [0, 2], // low: pure functions preferred
+        async: [0, 2], // low: sync preferred
+        coupling: [0, 2], // low: minimal deps
+    },
+    app: {
+        control: [0, 10], // medium: business logic
+        nesting: [0, 5], // medium: reasonable depth
+        state: [0, 8], // medium: stateful ok
+        async: [0, 8], // medium: async workflows
+        coupling: [0, 5], // low: controlled deps
+    },
+    web: {
+        control: [0, 8], // medium: UI logic
+        nesting: [0, 10], // higher: component hierarchy
+        state: [0, 5], // medium: UI state
+        async: [0, 5], // medium: data fetching
+        coupling: [0, 3], // low: component isolation
+    },
+    deploy: {
+        control: [0, 3], // low: simple scripts
+        nesting: [0, 2], // low: flat
+        state: [0, 2], // low: idempotent
+        async: [0, 2], // low: sequential
+        coupling: [0, 3], // low: explicit config
+    },
+    unknown: {
+        control: [0, 15], // permissive
+        nesting: [0, 10],
+        state: [0, 10],
+        async: [0, 10],
+        coupling: [0, 10],
+    },
+};
+/**
+ * Get canonical profile for module type
+ */
+export function getCanonicalProfile(moduleType) {
+    return CANONICAL_5D_PROFILES[moduleType] ?? CANONICAL_5D_PROFILES.unknown;
+}
+/**
+ * Calculate centroid of canonical profile
+ */
+export function getProfileCentroid(profile) {
+    return {
+        control: (profile.control[0] + profile.control[1]) / 2,
+        nesting: (profile.nesting[0] + profile.nesting[1]) / 2,
+        state: (profile.state[0] + profile.state[1]) / 2,
+        async: (profile.async[0] + profile.async[1]) / 2,
+        coupling: (profile.coupling[0] + profile.coupling[1]) / 2,
+    };
+}
+/**
+ * Check if vector is within canonical bounds
+ */
+export function isWithinCanonicalBounds(vector, profile) {
+    return (vector.control >= profile.control[0] && vector.control <= profile.control[1] &&
+        vector.nesting >= profile.nesting[0] && vector.nesting <= profile.nesting[1] &&
+        vector.state >= profile.state[0] && vector.state <= profile.state[1] &&
+        vector.async >= profile.async[0] && vector.async <= profile.async[1] &&
+        vector.coupling >= profile.coupling[0] && vector.coupling <= profile.coupling[1]);
+}
+/**
+ * Get dimensions that violate canonical bounds
+ */
+export function getViolationDimensions(vector, profile) {
+    const violations = [];
+    const dims = ['control', 'nesting', 'state', 'async', 'coupling'];
+    for (const dim of dims) {
+        const value = vector[dim];
+        const [min, max] = profile[dim];
+        if (value < min || value > max) {
+            violations.push(dim);
+        }
+    }
+    return violations;
+}
+/**
+ * Check if vector is orphan (outside ALL canonical regions)
+ */
+export function isOrphan(vector) {
+    for (const moduleType of Object.keys(CANONICAL_5D_PROFILES)) {
+        if (moduleType === 'unknown')
+            continue;
+        const profile = CANONICAL_5D_PROFILES[moduleType];
+        if (isWithinCanonicalBounds(vector, profile)) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Analyze deviation from canonical form
+ */
+export function analyzeDeviation(vector, moduleType = 'unknown') {
+    const profile = getCanonicalProfile(moduleType);
+    const centroid = getProfileCentroid(profile);
+    const matrix = getInteractionMatrix(moduleType);
+    // Calculate distances
+    const eucDist = euclideanDistance(vector, centroid);
+    const mahDist = mahalanobisDistance(vector, centroid, matrix);
+    // Max dimension deviation
+    const arr = vectorToArray(vector);
+    const centArr = vectorToArray(centroid);
+    const maxDev = Math.max(...arr.map((v, i) => Math.abs(v - centArr[i])));
+    // Normalize to 0-1 scale (assuming max reasonable deviation is 50)
+    const normDev = Math.min(1.0, mahDist / 50.0);
+    // Check canonical bounds
+    const withinBounds = isWithinCanonicalBounds(vector, profile);
+    const violations = getViolationDimensions(vector, profile);
+    const orphan = isOrphan(vector);
+    let status;
+    if (withinBounds) {
+        status = 'canonical';
+    }
+    else if (orphan) {
+        status = 'orphan';
+    }
+    else {
+        status = 'deviated';
+    }
+    return {
+        euclideanDistance: Math.round(eucDist * 1000) / 1000,
+        mahalanobisDistance: Math.round(mahDist * 1000) / 1000,
+        maxDimensionDeviation: Math.round(maxDev * 1000) / 1000,
+        normalizedDeviation: Math.round(normDev * 1000) / 1000,
+        isCanonical: withinBounds,
+        isOrphan: orphan,
+        moduleType,
+        vector,
+        violationDimensions: violations,
+        status,
+    };
+}
+/**
+ * Find the best fitting module type for a vector
+ */
+export function findBestModuleType(vector) {
+    let bestType = 'unknown';
+    let bestDist = Infinity;
+    for (const moduleType of Object.keys(CANONICAL_5D_PROFILES)) {
+        if (moduleType === 'unknown')
+            continue;
+        const profile = CANONICAL_5D_PROFILES[moduleType];
+        const centroid = getProfileCentroid(profile);
+        const matrix = getInteractionMatrix(moduleType);
+        const dist = mahalanobisDistance(vector, centroid, matrix);
+        if (dist < bestDist) {
+            bestDist = dist;
+            bestType = moduleType;
+        }
+    }
+    return {
+        type: bestType,
+        distance: Math.round(bestDist * 1000) / 1000,
+    };
+}
+//# sourceMappingURL=canonical.js.map

package/dist/tensor/canonical.js.map

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

package/dist/tensor/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * v0.0.3: Tensor-based Complexity Analysis
+ *
+ * Second-order tensor framework for multi-dimensional code complexity.
+ *
+ * Mathematical foundation:
+ *   score = v^T M v + <v, w> + ε‖v‖²
+ *
+ * Features:
+ * - 5D complexity vector: [Control, Nesting, State, Async, Coupling]
+ * - Interaction matrix M for dimension cross-effects
+ * - ε-regularization for convergence guarantee
+ * - Module-type canonical profiles
+ * - Hodge decomposition of complexity space
+ */
+export type { Vector5D, ModuleType, Matrix5x5, TensorScore, ConvergenceStatus, ConvergenceAnalysis, HodgeDecomposition, ComplexityLevel, DeviationResult, RefactoringRecommendation, } from './types.js';
+export { IDX_CONTROL, IDX_NESTING, IDX_STATE, IDX_ASYNC, IDX_COUPLING, } from './types.js';
+export { DEFAULT_MATRIX, MODULE_MATRICES, getInteractionMatrix, vectorToArray, arrayToVector, zeroVector, vectorNorm, dotProduct, quadraticForm, isPositiveSemidefinite, euclideanDistance, mahalanobisDistance, } from './matrix.js';
+export { DEFAULT_WEIGHTS, calculateTensorScore, convergenceScore, estimateLipschitz, analyzeConvergence, hodgeDecomposition, classifyComplexityLevel, recommendRefactoring, isSafe, needsReview, isViolation, } from './scoring.js';
+export type { CanonicalBounds } from './canonical.js';
+export { CANONICAL_5D_PROFILES, getCanonicalProfile, getProfileCentroid, isWithinCanonicalBounds, getViolationDimensions, isOrphan, analyzeDeviation, findBestModuleType, } from './canonical.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tensor/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,YAAY,EACV,QAAQ,EACR,UAAU,EACV,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,WAAW,EACX,WAAW,EACX,SAAS,EACT,SAAS,EACT,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,UAAU,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACb,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,MAAM,EACN,WAAW,EACX,WAAW,GACZ,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC"}

package/dist/tensor/index.js

@@ -0,0 +1,22 @@
+/**
+ * v0.0.3: Tensor-based Complexity Analysis
+ *
+ * Second-order tensor framework for multi-dimensional code complexity.
+ *
+ * Mathematical foundation:
+ *   score = v^T M v + <v, w> + ε‖v‖²
+ *
+ * Features:
+ * - 5D complexity vector: [Control, Nesting, State, Async, Coupling]
+ * - Interaction matrix M for dimension cross-effects
+ * - ε-regularization for convergence guarantee
+ * - Module-type canonical profiles
+ * - Hodge decomposition of complexity space
+ */
+export { IDX_CONTROL, IDX_NESTING, IDX_STATE, IDX_ASYNC, IDX_COUPLING, } from './types.js';
+// Matrix operations
+export { DEFAULT_MATRIX, MODULE_MATRICES, getInteractionMatrix, vectorToArray, arrayToVector, zeroVector, vectorNorm, dotProduct, quadraticForm, isPositiveSemidefinite, euclideanDistance, mahalanobisDistance, } from './matrix.js';
+// Scoring
+export { DEFAULT_WEIGHTS, calculateTensorScore, convergenceScore, estimateLipschitz, analyzeConvergence, hodgeDecomposition, classifyComplexityLevel, recommendRefactoring, isSafe, needsReview, isViolation, } from './scoring.js';
+export { CANONICAL_5D_PROFILES, getCanonicalProfile, getProfileCentroid, isWithinCanonicalBounds, getViolationDimensions, isOrphan, analyzeDeviation, findBestModuleType, } from './canonical.js';
+//# sourceMappingURL=index.js.map

package/dist/tensor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tensor/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAgBH,OAAO,EACL,WAAW,EACX,WAAW,EACX,SAAS,EACT,SAAS,EACT,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,oBAAoB;AACpB,OAAO,EACL,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,UAAU,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACb,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,UAAU;AACV,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,MAAM,EACN,WAAW,EACX,WAAW,GACZ,MAAM,cAAc,CAAC;AAItB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC"}

package/dist/tensor/matrix.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 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
+ */
+import type { Matrix5x5, ModuleType, Vector5D } from './types.js';
+/**
+ * Default interaction matrix (symmetric, positive semi-definite)
+ */
+export declare const DEFAULT_MATRIX: Matrix5x5;
+/**
+ * Module-type specific interaction matrices
+ */
+export declare const MODULE_MATRICES: Record<ModuleType, Matrix5x5>;
+/**
+ * Get interaction matrix for module type
+ */
+export declare function getInteractionMatrix(moduleType: ModuleType): Matrix5x5;
+/**
+ * Convert Vector5D to array
+ */
+export declare function vectorToArray(v: Vector5D): number[];
+/**
+ * Create Vector5D from array
+ */
+export declare function arrayToVector(arr: number[]): Vector5D;
+/**
+ * Create zero vector
+ */
+export declare function zeroVector(): Vector5D;
+/**
+ * Calculate L2 norm of vector
+ */
+export declare function vectorNorm(v: Vector5D): number;
+/**
+ * Calculate dot product of two vectors
+ */
+export declare function dotProduct(v1: Vector5D, v2: Vector5D): number;
+/**
+ * Calculate quadratic form: v^T M v
+ *
+ * This captures dimension interactions.
+ */
+export declare function quadraticForm(v: Vector5D, matrix: Matrix5x5): number;
+/**
+ * Check if matrix is positive semi-definite using diagonal dominance
+ * (conservative approximation)
+ */
+export declare function isPositiveSemidefinite(matrix: Matrix5x5): boolean;
+/**
+ * Euclidean distance between two vectors
+ */
+export declare function euclideanDistance(v1: Vector5D, v2: Vector5D): number;
+/**
+ * Mahalanobis-like distance using interaction matrix
+ *
+ * δ(v, target) = sqrt((v - target)^T M (v - target))
+ */
+export declare function mahalanobisDistance(v: Vector5D, target: Vector5D, matrix: Matrix5x5): number;
+//# sourceMappingURL=matrix.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"matrix.d.ts","sourceRoot":"","sources":["../../src/tensor/matrix.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,SAO5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,CA0CzD,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,CAEtE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,EAAE,CAEnD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,QAAQ,CAWrD;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,QAAQ,CAErC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAG9C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,GAAG,MAAM,CAI7D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAG,MAAM,CASpE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAajE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,GAAG,MAAM,CAKpE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,CAAC,EAAE,QAAQ,EACX,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,SAAS,GAChB,MAAM,CAUR"}

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":"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"}

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":"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"}

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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "semantic-complexity",
-  "version": "0.0.2-1895c257",
+  "version": "0.0.3-38ef2e6f",
   "description": "Multi-dimensional code complexity analyzer",
   "type": "module",
   "main": "./dist/index.js",
@@ -33,6 +33,10 @@
     "./gates": {
       "types": "./dist/gates/index.d.ts",
       "import": "./dist/gates/index.js"
+    },
+    "./tensor": {
+      "types": "./dist/tensor/index.d.ts",
+      "import": "./dist/tensor/index.js"
     }
   },
   "files": [