entkapp 4.5.0 → 5.0.0

package/src/analyzers/OxcAnalyzer.js

@@ -1,383 +1,11 @@
-export class OxcAnalyzer {
-  constructor(context) {
-    this.context = context;
-    this.oxc = null;
-    this.isAvailable = false;
-  }
+import { OxcAnalyzer as CoreOxcAnalyzer } from '../ast/OxcAnalyzer.js';
 
-  async init() {
-    if (this.isAvailable) return true;
-    try {
-      const oxc = await import("oxc-parser");
-      this.oxc = oxc;
-      this.isAvailable = true;
-      return true;
-    } catch (e) {
-      try {
-        const { createRequire } = await import('module');
-        const require = createRequire(import.meta.url);
-        this.oxc = require("oxc-parser");
-        this.isAvailable = true;
-        return true;
-      } catch (err) {
-        this.isAvailable = false;
-        if (this.context.verbose) {
-          console.warn(`[OxcAnalyzer] oxc-parser failed to load: ${err.message}`);
-        }
-        return false;
-      }
+/**
+ * Proxy for the Core OxcAnalyzer to maintain backward compatibility
+ * while centralizing the implementation.
+ */
+export class OxcAnalyzer extends CoreOxcAnalyzer {
+    constructor(context) {
+        super(context);
     }
-  }
-
-  async parseFile(filePath, content, fileNode) {
-    if (!this.isAvailable) {
-      const initialized = await this.init();
-      if (!initialized) return false;
-    }
-
-    try {
-      // Fix: Ensure filePath is correctly handled for OXC (Windows path issue)
-      const normalizedPath = filePath.replace(/\\/g, '/');
-      
-      // Try passing the path directly as the second argument if the object-based options fail
-      // Some versions of oxc-parser expect a string as the second argument for the filename
-      let result;
-      try {
-        result = this.oxc.parseSync(content, {
-          sourceType: "module",
-          sourceFilename: normalizedPath,
-          lang: "typescript"
-        });
-      } catch (e) {
-        // Fallback for versions that expect the path as second argument
-        result = this.oxc.parseSync(content, normalizedPath);
-      }
-
-      // Fix: Handle cases where OXC returns a JSON string instead of an object
-      // Stabilize result through JSON round-trip to fix N-API conversion issues on Windows
-      let parsedResult;
-      try {
-        parsedResult = typeof result === 'string' ? JSON.parse(result) : JSON.parse(JSON.stringify(result));
-      } catch (err) {
-        if (typeof result === 'object') {
-          parsedResult = result; // Last resort
-        } else {
-          throw new Error("OXC returned an invalid format");
-        }
-      }
-
-      let ast;
-      if (parsedResult && typeof parsedResult === 'object') {
-        if (parsedResult.program) {
-          ast = parsedResult;
-        } else if (parsedResult.ast) {
-          ast = { program: parsedResult.ast };
-        } else {
-          ast = { program: parsedResult };
-        }
-      } else {
-        throw new Error("OXC returned an invalid AST format");
-      }
-
-      fileNode.ast = ast.program; // Store the AST for advanced analysis
-      fileNode.jsxComponents = new Set();
-      fileNode.jsxProps = new Set();
-      fileNode.decorators = new Set();
-
-      this.walkOxcAst(ast.program, fileNode, content);
-      
-      const lines = content.split('\n');
-      const getLineCol = (pos) => {
-        let count = 0;
-        for (let i = 0; i < lines.length; i++) {
-          if (count + lines[i].length + 1 > pos) {
-            return { line: i + 1, column: pos - count + 1 };
-          }
-          count += lines[i].length + 1;
-        }
-        return { line: 1, column: 1 };
-      };
-
-      for (const [name, meta] of fileNode.internalExports.entries()) {
-        if (meta.start !== undefined) {
-          fileNode.symbolSourceLocations.set(name, getLineCol(meta.start));
-        }
-      }
-
-      return true;
-    } catch (e) {
-      if (this.context.verbose) {
-        console.warn(`[OXC] Failed to parse ${filePath}. Error: ${e.message}`);
-        if (e.stack) console.debug(e.stack);
-        console.info(`[OXC] Switching back to TypeScript Compiler API for ${filePath}`);
-      }
-      return false;
-    }
-  }
-
-  walkOxcAst(node, fileNode, content) {
-    if (!node) return;
-
-    switch (node.type) {
-      case "ImportDeclaration":
-        this.handleImportDeclaration(node, fileNode);
-        break;
-      case "ExportNamedDeclaration":
-      case "ExportDefaultDeclaration":
-      case "ExportAllDeclaration":
-        this.handleExportDeclaration(node, fileNode, content);
-        break;
-      case "CallExpression":
-        this.handleCallExpression(node, fileNode);
-        break;
-      case "JSXElement":
-      case "JSXFragment":
-        this.handleJsxElement(node, fileNode);
-        break;
-      case "Decorator":
-        this.handleDecorator(node, fileNode);
-        break;
-      case "StringLiteral":
-        fileNode.rawStringReferences.add(node.value);
-        break;
-    }
-
-    for (const key in node) {
-      if (node[key] && typeof node[key] === "object") {
-        if (Array.isArray(node[key])) {
-          node[key].forEach((child) => this.walkOxcAst(child, fileNode, content));
-        } else {
-          this.walkOxcAst(node[key], fileNode, content);
-        }
-      }
-    }
-  }
-
-  handleImportDeclaration(node, fileNode) {
-    const specifier = node.source.value;
-    fileNode.explicitImports.add(specifier);
-
-    if (!specifier.startsWith('.') && !specifier.startsWith('/')) {
-      fileNode.externalPackageUsage.add(this._extractPackageName(specifier));
-    }
-
-    if (node.specifiers) {
-      node.specifiers.forEach((spec) => {
-        if (spec.type === "ImportSpecifier") {
-          const importedName = spec.imported.name || (spec.imported.type === "Identifier" ? spec.imported.name : spec.imported.value);
-          fileNode.importedSymbols.add(`${specifier}:${importedName}`);
-        } else if (spec.type === "ImportDefaultSpecifier") {
-          fileNode.importedSymbols.add(`${specifier}:default`);
-        } else if (spec.type === "ImportNamespaceSpecifier") {
-          fileNode.importedSymbols.add(`${specifier}:*`);
-        }
-      });
-    }
-  }
-
-  handleExportDeclaration(node, fileNode, content) {
-    // 1. Default Exports
-    if (node.type === "ExportDefaultDeclaration") {
-      fileNode.internalExports.set("default", { 
-        type: "default", 
-        start: node.start, 
-        end: node.end 
-      });
-      return;
-    }
-
-    // 2. Re-export All: export * from 'mod' or export * as ns from 'mod'
-    if (node.type === "ExportAllDeclaration") {
-      const sourceSpecifier = node.source.value;
-      fileNode.explicitImports.add(sourceSpecifier);
-      if (!sourceSpecifier.startsWith('.') && !sourceSpecifier.startsWith('/')) {
-        fileNode.externalPackageUsage.add(this._extractPackageName(sourceSpecifier));
-      }
-
-      if (node.exported) {
-        // export * as ns from 'mod'
-        const name = node.exported.name || (node.exported.type === "Identifier" ? node.exported.name : null);
-        if (name) {
-          fileNode.internalExports.set(name, { 
-            type: "re-export-namespace", 
-            source: sourceSpecifier, 
-            originalName: "*", 
-            start: node.start, 
-            end: node.end 
-          });
-          fileNode.importedSymbols.add(`${sourceSpecifier}:*`);
-        }
-      } else {
-        // export * from 'mod'
-        fileNode.internalExports.set("*", { 
-          type: "re-export-all", 
-          source: sourceSpecifier 
-        });
-        fileNode.importedSymbols.add(`${sourceSpecifier}:*`);
-      }
-      return;
-    }
-
-    // 3. Named Exports & Re-exports with specifiers
-    if (node.source) {
-      // Re-export: export { x } from 'mod'
-      const specifier = node.source.value;
-      fileNode.explicitImports.add(specifier);
-      if (!specifier.startsWith('.') && !specifier.startsWith('/')) {
-        fileNode.externalPackageUsage.add(this._extractPackageName(specifier));
-      }
-
-      if (node.specifiers) {
-        node.specifiers.forEach((spec) => {
-          const exportedName = spec.exported.name || (spec.exported.type === "Identifier" ? spec.exported.name : spec.exported.value);
-          const localName = spec.local.name || (spec.local.type === "Identifier" ? spec.local.name : spec.local.value);
-          fileNode.internalExports.set(exportedName, {
-            type: "re-export",
-            source: specifier,
-            originalName: localName,
-            start: spec.start,
-            end: spec.end,
-          });
-          fileNode.importedSymbols.add(`${specifier}:${localName}`);
-        });
-      }
-    } else if (node.declaration) {
-      // Direct declaration export: export const x = 1, export function f() {}
-      const decl = node.declaration;
-      if (decl.type === "VariableDeclaration") {
-        decl.declarations.forEach((d) => {
-          this._extractNamesFromPattern(d.id, (name) => {
-            fileNode.internalExports.set(name, { 
-              type: "variable", 
-              start: d.start, 
-              end: d.end 
-            });
-          });
-        });
-      } else if (decl.id && decl.id.name) {
-        let type = "unknown";
-        if (decl.type === "FunctionDeclaration") type = "function";
-        else if (decl.type === "ClassDeclaration") type = "class";
-        else if (decl.type === "TSEnumDeclaration") type = "enum";
-        else if (decl.type === "TSInterfaceDeclaration") type = "interface";
-        else if (decl.type === "TSTypeAliasDeclaration") type = "type";
-        else if (decl.type === "TSModuleDeclaration") type = "namespace";
-
-        fileNode.internalExports.set(decl.id.name, { 
-          type, 
-          start: decl.start, 
-          end: decl.end 
-        });
-      }
-    } else if (node.specifiers) {
-      // Export existing locals: export { x, y as z }
-      node.specifiers.forEach((spec) => {
-        const exportedName = spec.exported.name || (spec.exported.type === "Identifier" ? spec.exported.name : spec.exported.value);
-        const localName = spec.local.name || (spec.local.type === "Identifier" ? spec.local.name : spec.local.value);
-        fileNode.internalExports.set(exportedName, {
-          type: "export",
-          originalName: localName,
-          start: spec.start,
-          end: spec.end,
-        });
-      });
-    }
-  }
-
-  _extractNamesFromPattern(node, callback) {
-    if (!node) return;
-    if (node.type === "Identifier") {
-      callback(node.name);
-    } else if (node.type === "ObjectPattern") {
-      node.properties.forEach(p => {
-        if (p.type === "Property") {
-          this._extractNamesFromPattern(p.value, callback);
-        } else if (p.type === "RestElement") {
-          this._extractNamesFromPattern(p.argument, callback);
-        }
-      });
-    } else if (node.type === "ArrayPattern") {
-      node.elements.forEach(e => {
-        if (e) this._extractNamesFromPattern(e, callback);
-      });
-    } else if (node.type === "AssignmentPattern") {
-      this._extractNamesFromPattern(node.left, callback);
-    } else if (node.type === "RestElement") {
-      this._extractNamesFromPattern(node.argument, callback);
-    }
-  }
-
-  handleCallExpression(node, fileNode) {
-    // Dynamic import(): import('./module')
-    if (node.callee.type === "Import" && node.arguments.length > 0) {
-      const arg = node.arguments[0];
-      if (arg.type === "StringLiteral") {
-        const specifier = arg.value;
-        fileNode.explicitImports.add(specifier);
-        fileNode.dynamicImports.add(specifier);
-        fileNode.importedSymbols.add(`${specifier}:*`); // Dynamic import usually consumes the whole namespace
-        if (!specifier.startsWith('.') && !specifier.startsWith('/')) {
-          fileNode.externalPackageUsage.add(this._extractPackageName(specifier));
-        }
-      } else {
-        if (fileNode.calculatedDynamicImports) {
-          fileNode.calculatedDynamicImports.push({ kind: arg.type, start: arg.start });
-        }
-      }
-    } else if (node.callee.type === "Identifier" && node.callee.name === "require" && node.arguments.length > 0 && node.arguments[0].type === "StringLiteral") {
-      const specifier = node.arguments[0].value;
-      fileNode.explicitImports.add(specifier);
-      fileNode.importedSymbols.add(`${specifier}:*`);
-      if (!specifier.startsWith('.') && !specifier.startsWith('/')) {
-        fileNode.externalPackageUsage.add(this._extractPackageName(specifier));
-      }
-    }
-  }
-
-  handleJsxElement(node, fileNode) {
-    const getElementName = (nameNode) => {
-      if (nameNode.type === "JSXIdentifier") return nameNode.name;
-      if (nameNode.type === "JSXMemberExpression") return `${getElementName(nameNode.object)}.${nameNode.property.name}`;
-      if (nameNode.type === "JSXNamespacedName") return `${nameNode.namespace.name}:${nameNode.name.name}`;
-      return "unknown";
-    };
-
-    if (node.openingElement) {
-      const tagName = getElementName(node.openingElement.name);
-      fileNode.jsxComponents.add(tagName);
-
-      if (node.openingElement.attributes) {
-        node.openingElement.attributes.forEach(attr => {
-          if (attr.type === "JSXAttribute" && attr.name.type === "JSXIdentifier") {
-            fileNode.jsxProps.add(`${tagName}:${attr.name.name}`);
-          }
-        });
-      }
-    }
-  }
-
-  handleDecorator(node, fileNode) {
-    const getDecoratorName = (expr) => {
-      if (expr.type === "Identifier") return expr.name;
-      if (expr.type === "CallExpression") return getDecoratorName(expr.callee);
-      if (expr.type === "MemberExpression") {
-        const prop = expr.property.name || expr.property.value;
-        return prop || "unknown";
-      }
-      return "unknown";
-    };
-
-    const decoratorName = getDecoratorName(node.expression);
-    if (decoratorName !== "unknown") {
-      fileNode.decorators.add(decoratorName);
-    }
-  }
-
-  _extractPackageName(specifier) {
-    if (specifier.startsWith('@')) {
-      const parts = specifier.split('/');
-      return parts.length >= 2 ? `${parts[0]}/${parts[1]}` : specifier;
-    }
-    return specifier.split('/')[0];
-  }
 }

package/src/api/HeadlessAPI.js

@@ -14,7 +14,7 @@
 
 import EventEmitter from 'events';
 import path from 'path';
-import { RefactoringEngine } from '../index.js';
+// import { RefactoringEngine } from '../index.js';
 
 export class HeadlessAPI extends EventEmitter {
   constructor(options = {}) {

package/src/api/PluginSDK.js

@@ -1,6 +1,6 @@
 /**
  * ============================================================================
- * Plugin SDK for entkapp v4.0.0
+ * Plugin SDK for entkapp v4.7.0 (Enterprise Edition)
  * ============================================================================
  * Provides utilities and helpers for developing custom plugins that extend
  * entkapp's analysis and healing capabilities.
@@ -21,8 +21,6 @@ export class PluginSDKBase extends BasePlugin {
 
   /**
    * Register a hook for a specific lifecycle event
-   * @param {string} eventName - Event name (e.g., 'analyze:start', 'refactor:complete')
-   * @param {Function} handler - Handler function
    */
   registerHook(eventName, handler) {
     if (!this.hooks.has(eventName)) {
@@ -33,8 +31,6 @@ export class PluginSDKBase extends BasePlugin {
 
   /**
    * Emit a hook event
-   * @param {string} eventName - Event name
-   * @param {Object} data - Event data
    */
   async emitHook(eventName, data) {
     const handlers = this.hooks.get(eventName) || [];
@@ -45,7 +41,6 @@ export class PluginSDKBase extends BasePlugin {
 
   /**
    * Register a code transformer
-   * @param {Function} transformer - Transformer function
    */
   registerTransformer(transformer) {
     this.transformers.push(transformer);
@@ -53,41 +48,17 @@ export class PluginSDKBase extends BasePlugin {
 
   /**
    * Register a validator
-   * @param {Function} validator - Validator function
    */
   registerValidator(validator) {
     this.validators.push(validator);
   }
 
   /**
-   * Apply all registered transformers to a code string
-   * @param {string} code - Source code
-   * @param {string} filePath - File path
-   * @returns {Promise<string>} Transformed code
+   * Enterprise: Register a Call Graph visitor
    */
-  async applyTransformers(code, filePath) {
-    let result = code;
-    for (const transformer of this.transformers) {
-      result = await transformer(result, filePath);
-    }
-    return result;
-  }
-
-  /**
-   * Run all validators on a code string
-   * @param {string} code - Source code
-   * @param {string} filePath - File path
-   * @returns {Promise<Array>} Validation errors
-   */
-  async runValidators(code, filePath) {
-    const errors = [];
-    for (const validator of this.validators) {
-      const result = await validator(code, filePath);
-      if (result && result.length > 0) {
-        errors.push(...result);
-      }
-    }
-    return errors;
+  registerCallGraphVisitor(visitor) {
+      this.context.callGraphVisitors = this.context.callGraphVisitors || [];
+      this.context.callGraphVisitors.push(visitor);
   }
 }
 
@@ -97,8 +68,6 @@ export class PluginSDKBase extends BasePlugin {
 export class PluginSDK {
   /**
    * Create a custom plugin class
-   * @param {Object} config - Plugin configuration
-   * @returns {Class} Plugin class
    */
   static createPlugin(config) {
     return class CustomPlugin extends PluginSDKBase {
@@ -136,163 +105,30 @@ export class PluginSDK {
           return await config.analyze(node, filePath, this.context);
         }
       }
-
-      async transform(code, filePath) {
-        if (config.transform) {
-          return await config.transform(code, filePath, this.context);
-        }
-        return code;
-      }
-
-      async validate(code, filePath) {
-        if (config.validate) {
-          return await config.validate(code, filePath, this.context);
-        }
-        return [];
-      }
     };
   }
 
   /**
-   * Create a CSS-in-JS analyzer plugin
-   * @param {Object} config - Configuration for CSS-in-JS analysis
-   * @returns {Class} Plugin class
+   * Create a specialized member usage analyzer
    */
-  static createCSSInJSPlugin(config = {}) {
-    const cssLibraries = config.libraries || [
-      'styled-components',
-      'emotion',
-      '@emotion/react',
-      '@emotion/styled',
-      'linaria',
-      'vanilla-extract'
-    ];
-
-    return this.createPlugin({
-      name: config.name || 'css-in-js-analyzer',
-      configFiles: [],
-      routePatterns: [/\.(tsx?|jsx?)$/],
-      requiredContracts: [],
-
-      async analyze(node, filePath) {
-        // Track CSS-in-JS imports
-        for (const lib of cssLibraries) {
-          if (node.explicitImports.has(lib)) {
-            node.cssInJsLibraries = node.cssInJsLibraries || new Set();
-            node.cssInJsLibraries.add(lib);
-          }
-        }
-
-        // Detect styled component definitions
-        const styledPattern = /(?:styled|css|keyframes)\s*\.\w+|styled\(\w+\)/g;
-        for (const match of (node.rawCode || '').matchAll(styledPattern)) {
-          node.styledComponentUsages = node.styledComponentUsages || [];
-          node.styledComponentUsages.push(match[0]);
-        }
-      },
-
-      async validate(code, filePath) {
-        const errors = [];
-        // Check for unused CSS-in-JS definitions
-        const unusedStylesPattern = /(?:const|let|var)\s+(\w+)\s*=\s*(?:styled|css)\./g;
-        const matches = [...code.matchAll(unusedStylesPattern)];
-
-        for (const match of matches) {
-          const styleName = match[1];
-          const usagePattern = new RegExp(`\\b${styleName}\\b`);
-          if (!usagePattern.test(code.substring(match.index + match[0].length))) {
-            errors.push({
-              type: 'unused-style',
-              name: styleName,
-              line: code.substring(0, match.index).split('\n').length,
-              message: `Unused CSS-in-JS definition: ${styleName}`
-            });
+  static createMemberAnalyzer(config = {}) {
+      return this.createPlugin({
+          name: config.name || 'custom-member-analyzer',
+          async analyze(node, filePath, context) {
+              // Custom logic to protect or flag specific members
+              if (config.protectMembers) {
+                  for (const [symbol, meta] of node.internalExports.entries()) {
+                      if (meta.members) {
+                          meta.members.forEach(m => {
+                              if (config.protectMembers.includes(m.name)) {
+                                  m.isPublic = true; // Mark as public to protect from deletion
+                              }
+                          });
+                      }
+                  }
+              }
           }
-        }
-
-        return errors;
-      }
-    });
-  }
-
-  /**
-   * Create an asset tracking plugin
-   * @param {Object} config - Configuration for asset tracking
-   * @returns {Class} Plugin class
-   */
-  static createAssetTrackingPlugin(config = {}) {
-    const assetExtensions = config.extensions || [
-      '.png', '.jpg', '.jpeg', '.gif', '.svg', '.webp',
-      '.mp4', '.webm', '.mp3', '.wav',
-      '.woff', '.woff2', '.ttf', '.eot'
-    ];
-
-    return this.createPlugin({
-      name: config.name || 'asset-tracker',
-      configFiles: [],
-      routePatterns: [/\.(tsx?|jsx?)$/],
-
-      async analyze(node, filePath) {
-        node.assetReferences = node.assetReferences || new Set();
-
-        // Track asset imports
-        const assetImportPattern = /import\s+(?:\*\s+as\s+\w+|[\w\s,{}]+)\s+from\s+['"]([^'"]+(?:${assetExtensions.join('|')}))['"]/g;
-        for (const match of (node.rawCode || '').matchAll(assetImportPattern)) {
-          node.assetReferences.add(match[1]);
-        }
-
-        // Track asset requires
-        const assetRequirePattern = /require\s*\(\s*['"]([^'"]+(?:${assetExtensions.join('|')}))['"]\s*\)/g;
-        for (const match of (node.rawCode || '').matchAll(assetRequirePattern)) {
-          node.assetReferences.add(match[1]);
-        }
-
-        // Track asset URLs in strings
-        const assetUrlPattern = /['"]([^'"]*(?:${assetExtensions.join('|')}))['"]/g;
-        for (const match of (node.rawCode || '').matchAll(assetUrlPattern)) {
-          node.assetReferences.add(match[1]);
-        }
-      }
-    });
-  }
-
-  /**
-   * Create a monorepo awareness plugin
-   * @param {Object} config - Configuration for monorepo support
-   * @returns {Class} Plugin class
-   */
-  static createMonorepoPlugin(config = {}) {
-    return this.createPlugin({
-      name: config.name || 'monorepo-aware',
-      configFiles: config.configFiles || ['nx.json', 'pnpm-workspace.yaml', 'lerna.json'],
-
-      async analyze(node, filePath) {
-        // Track workspace package references
-        node.workspaceReferences = node.workspaceReferences || new Set();
-
-        // Detect workspace imports (e.g., @workspace/package-name)
-        const workspacePattern = /@[\w-]+\/[\w-]+/g;
-        for (const match of (node.rawCode || '').matchAll(workspacePattern)) {
-          node.workspaceReferences.add(match[0]);
-        }
-      }
-    });
-  }
-
-  /**
-   * Create a circular dependency detector plugin
-   * @param {Object} config - Configuration
-   * @returns {Class} Plugin class
-   */
-  static createCircularDepPlugin(config = {}) {
-    return this.createPlugin({
-      name: config.name || 'circular-dep-detector',
-
-      async analyze(node, filePath) {
-        node.potentialCycles = node.potentialCycles || [];
-        // Cycle detection will be handled by the main engine
-      }
-    });
+      });
   }
 }