@fairfox/polly 0.5.3 → 0.6.1

package/dist/vendor/visualize/src/cli.js

@@ -68,27 +68,27 @@ class ProjectDetector {
     if (background) {
       const file = background.service_worker || background.scripts?.[0] || background.page;
       if (file) {
-        entryPoints.background = this.findSourceFile(file);
+        entryPoints["background"] = this.findSourceFile(file);
       }
     }
     const contentScripts = manifest.content_scripts;
     if (contentScripts && contentScripts.length > 0) {
       const firstScript = contentScripts[0].js?.[0];
       if (firstScript) {
-        entryPoints.content = this.findSourceFile(firstScript);
+        entryPoints["content"] = this.findSourceFile(firstScript);
       }
     }
     const popup = manifest.action?.default_popup || manifest.browser_action?.default_popup;
     if (popup) {
       const jsFile = this.findAssociatedJS(path3.join(this.projectRoot, popup));
       if (jsFile)
-        entryPoints.popup = jsFile;
+        entryPoints["popup"] = jsFile;
     }
     const options = manifest.options_ui?.page || manifest.options_page;
     if (options) {
       const jsFile = this.findAssociatedJS(path3.join(this.projectRoot, options));
       if (jsFile)
-        entryPoints.options = jsFile;
+        entryPoints["options"] = jsFile;
     }
     return {
       type: "chrome-extension",
@@ -112,7 +112,7 @@ class ProjectDetector {
     for (const candidate of swCandidates) {
       const fullPath = path3.join(this.projectRoot, candidate);
       if (fs3.existsSync(fullPath)) {
-        entryPoints.worker = fullPath;
+        entryPoints["worker"] = fullPath;
         break;
       }
     }
@@ -126,7 +126,7 @@ class ProjectDetector {
     for (const candidate of clientCandidates) {
       const fullPath = path3.join(this.projectRoot, candidate);
       if (fs3.existsSync(fullPath)) {
-        entryPoints.client = fullPath;
+        entryPoints["client"] = fullPath;
         break;
       }
     }
@@ -156,7 +156,7 @@ class ProjectDetector {
     for (const candidate of mainCandidates) {
       const fullPath = path3.join(this.projectRoot, candidate);
       if (fs3.existsSync(fullPath) || fs3.existsSync(fullPath.replace(/\.js$/, ".ts"))) {
-        entryPoints.main = fs3.existsSync(fullPath) ? fullPath : fullPath.replace(/\.js$/, ".ts");
+        entryPoints["main"] = fs3.existsSync(fullPath) ? fullPath : fullPath.replace(/\.js$/, ".ts");
         break;
       }
     }
@@ -169,7 +169,7 @@ class ProjectDetector {
     for (const candidate of rendererCandidates) {
       const fullPath = path3.join(this.projectRoot, candidate);
       if (fs3.existsSync(fullPath)) {
-        entryPoints.renderer = fullPath;
+        entryPoints["renderer"] = fullPath;
         break;
       }
     }
@@ -207,13 +207,13 @@ class ProjectDetector {
     const scoredServers = this.scoreServerCandidates(serverCandidates);
     if (scoredServers.length > 0) {
       const best = scoredServers[0];
-      entryPoints.server = best.path;
+      entryPoints["server"] = best.path;
       if (best.hasWebSocket) {
-        contextMapping.server = "WebSocket Server";
+        contextMapping["server"] = "WebSocket Server";
       } else if (best.hasHTTP) {
-        contextMapping.server = "HTTP Server";
+        contextMapping["server"] = "HTTP Server";
       } else {
-        contextMapping.server = "Server";
+        contextMapping["server"] = "Server";
       }
     }
     const clientCandidates = [
@@ -227,8 +227,8 @@ class ProjectDetector {
     for (const candidate of clientCandidates) {
       const fullPath = path3.join(this.projectRoot, candidate);
       if (fs3.existsSync(fullPath)) {
-        entryPoints.client = fullPath;
-        contextMapping.client = "Client";
+        entryPoints["client"] = fullPath;
+        contextMapping["client"] = "Client";
         break;
       }
     }
@@ -367,7 +367,7 @@ class ProjectDetector {
       for (const candidate of commonEntries) {
         const fullPath = path3.join(this.projectRoot, candidate);
         if (fs3.existsSync(fullPath)) {
-          entryPoints.main = fullPath;
+          entryPoints["main"] = fullPath;
           break;
         }
       }
@@ -512,14 +512,14 @@ class ManifestParser {
     if (background) {
       const entryFile = background.files[0];
       if (entryFile) {
-        entryPoints.background = this.findSourceFile(entryFile);
+        entryPoints["background"] = this.findSourceFile(entryFile);
       }
     }
     const contentScripts = this.parseContentScripts();
     if (contentScripts && contentScripts.length > 0) {
-      const firstScript = contentScripts[0].js[0];
+      const firstScript = contentScripts[0]?.js[0];
       if (firstScript) {
-        entryPoints.content = this.findSourceFile(firstScript);
+        entryPoints["content"] = this.findSourceFile(firstScript);
       }
     }
     const popup = this.parsePopup();
@@ -527,7 +527,7 @@ class ManifestParser {
       const htmlPath = path.join(this.baseDir, popup.html);
       const jsPath = this.findAssociatedJS(htmlPath);
       if (jsPath) {
-        entryPoints.popup = jsPath;
+        entryPoints["popup"] = jsPath;
       }
     }
     const options = this.parseOptions();
@@ -535,7 +535,7 @@ class ManifestParser {
       const htmlPath = path.join(this.baseDir, options.page);
       const jsPath = this.findAssociatedJS(htmlPath);
       if (jsPath) {
-        entryPoints.options = jsPath;
+        entryPoints["options"] = jsPath;
       }
     }
     const devtools = this.parseDevtools();
@@ -543,7 +543,7 @@ class ManifestParser {
       const htmlPath = path.join(this.baseDir, devtools.page);
       const jsPath = this.findAssociatedJS(htmlPath);
       if (jsPath) {
-        entryPoints.devtools = jsPath;
+        entryPoints["devtools"] = jsPath;
       }
     }
     return entryPoints;
@@ -705,9 +705,9 @@ class ContextAnalyzer {
       handlers: contextHandlers,
       chromeAPIs,
       externalAPIs: [],
-      components,
+      ...components ? { components } : {},
       dependencies,
-      description
+      ...description ? { description } : {}
     };
   }
   extractChromeAPIs(sourceFile) {
@@ -717,20 +717,23 @@ class ContextAnalyzer {
         const text = node.getText();
         if (text.startsWith("chrome.")) {
           const match = text.match(/^chrome\.([^.(]+(?:\.[^.(]+)?)/);
-          if (match) {
-            apis.add(match[1]);
+          const api = match?.[1];
+          if (api) {
+            apis.add(api);
           }
         }
         if (text.startsWith("browser.")) {
           const match = text.match(/^browser\.([^.(]+(?:\.[^.(]+)?)/);
-          if (match) {
-            apis.add(match[1]);
+          const api = match?.[1];
+          if (api) {
+            apis.add(api);
           }
         }
         if (text.includes("bus.adapters.")) {
           const match = text.match(/bus\.adapters\.([^.(]+)/);
-          if (match) {
-            apis.add(match[1]);
+          const api = match?.[1];
+          if (api) {
+            apis.add(api);
           }
         }
       }
@@ -767,13 +770,14 @@ class ContextAnalyzer {
       if (Node.isFunctionDeclaration(node)) {
         const name = node.getName();
         if (name && this.looksLikeComponent(name, node)) {
+          const description = this.extractJSDocDescription(node);
           components.push({
             name,
             type: "function",
             filePath: sourceFile.getFilePath(),
             line: node.getStartLineNumber(),
             props: this.extractProps(node),
-            description: this.extractJSDocDescription(node)
+            ...description ? { description } : {}
           });
         }
       }
@@ -782,13 +786,14 @@ class ContextAnalyzer {
         const initializer = node.getInitializer();
         if (name && initializer && (Node.isArrowFunction(initializer) || Node.isFunctionExpression(initializer))) {
           if (this.looksLikeComponent(name, initializer)) {
+            const description = this.extractJSDocDescription(node);
             components.push({
               name,
               type: "function",
               filePath: sourceFile.getFilePath(),
               line: node.getStartLineNumber(),
               props: this.extractProps(initializer),
-              description: this.extractJSDocDescription(node)
+              ...description ? { description } : {}
             });
           }
         }
@@ -796,13 +801,14 @@ class ContextAnalyzer {
       if (Node.isClassDeclaration(node)) {
         const name = node.getName();
         if (name && this.looksLikeClassComponent(node)) {
+          const description = this.extractJSDocDescription(node);
           components.push({
             name,
             type: "class",
             filePath: sourceFile.getFilePath(),
             line: node.getStartLineNumber(),
             props: this.extractPropsFromClass(node),
-            description: this.extractJSDocDescription(node)
+            ...description ? { description } : {}
           });
         }
       }
@@ -905,9 +911,9 @@ class FlowAnalyzer {
           messageType,
           from: sender.context,
           to: recipients,
-          trigger: flowMetadata.trigger,
-          flowName: flowMetadata.flowName,
-          description: flowMetadata.description,
+          ...flowMetadata.trigger ? { trigger: flowMetadata.trigger } : {},
+          ...flowMetadata.flowName ? { flowName: flowMetadata.flowName } : {},
+          ...flowMetadata.description ? { description: flowMetadata.description } : {},
           sequence
         });
       }
@@ -1218,7 +1224,7 @@ class IntegrationAnalyzer {
         const moduleSpecifier = importDecl.getModuleSpecifierValue();
         if (!moduleSpecifier.startsWith(".") && !moduleSpecifier.startsWith("/")) {
           const packageName = moduleSpecifier.startsWith("@") ? moduleSpecifier.split("/").slice(0, 2).join("/") : moduleSpecifier.split("/")[0];
-          if (!seen.has(packageName)) {
+          if (packageName && !seen.has(packageName)) {
             seen.add(packageName);
             scripts.push({
               type: "external-script",
@@ -1284,7 +1290,7 @@ class IntegrationAnalyzer {
       const hostname = parsed.hostname;
       const cleanHost = hostname.replace(/^www\./, "");
       const parts = cleanHost.split(".");
-      if (parts.length > 0) {
+      if (parts.length > 0 && parts[0]) {
         return parts[0].charAt(0).toUpperCase() + parts[0].slice(1) + " API";
       }
     } catch {}
@@ -1314,7 +1320,7 @@ class IntegrationAnalyzer {
 }
 
 // vendor/analysis/src/extract/handlers.ts
-import { Project as Project4, SyntaxKind as SyntaxKind3, Node as Node5 } from "ts-morph";
+import { Project as Project4, SyntaxKind, Node as Node5 } from "ts-morph";
 
 // vendor/analysis/src/extract/relationships.ts
 import { Node as Node4 } from "ts-morph";
@@ -1417,7 +1423,7 @@ class RelationshipExtractor {
       const objectExpr = expr.getExpression();
       const objectName = objectExpr.getText();
       const methodName = expr.getName();
-      targetComponent = this.inferComponentFromCall(objectName, methodName);
+      targetComponent = this.inferComponentFromCall(objectName);
       if (!targetComponent) {
         return null;
       }
@@ -1448,7 +1454,7 @@ class RelationshipExtractor {
       rootObject = rootObject.getExpression();
     }
     const objectName = rootObject.getText();
-    const targetComponent = this.inferComponentFromCall(objectName, methodName);
+    const targetComponent = this.inferComponentFromCall(objectName);
     if (!targetComponent) {
       return null;
     }
@@ -1485,7 +1491,7 @@ class RelationshipExtractor {
   }
   extractFromFetchCall(callExpr, handlerName) {
     const args = callExpr.getArguments();
-    if (args.length === 0) {
+    if (args.length === 0 || !args[0]) {
       return null;
     }
     const urlArg = args[0].getText();
@@ -1504,7 +1510,7 @@ class RelationshipExtractor {
       evidence: [`fetch() call to: ${urlArg}`]
     };
   }
-  inferComponentFromCall(objectName, methodName) {
+  inferComponentFromCall(objectName) {
     const mappings = {
       db: "db_client",
       database: "database",
@@ -1581,7 +1587,7 @@ class RelationshipExtractor {
           }
           if (modulePath.includes("/service") || modulePath.includes("/services")) {
             const match = modulePath.match(/\/([^/]+)\.ts$/);
-            if (match) {
+            if (match && match[1]) {
               return this.toComponentId(match[1]);
             }
           }
@@ -1665,8 +1671,9 @@ class HandlerExtractor {
   extractHandlers() {
     const handlers = [];
     const messageTypes = new Set;
+    const invalidMessageTypes = new Set;
     const sourceFiles = this.project.getSourceFiles();
-    if (process.env.POLLY_DEBUG) {
+    if (process.env["POLLY_DEBUG"]) {
       console.log(`[DEBUG] Loaded ${sourceFiles.length} source files`);
       if (sourceFiles.length <= 20) {
         for (const sf of sourceFiles) {
@@ -1678,17 +1685,30 @@ class HandlerExtractor {
       const fileHandlers = this.extractFromFile(sourceFile);
       handlers.push(...fileHandlers);
       for (const handler of fileHandlers) {
-        messageTypes.add(handler.messageType);
+        if (this.isValidTLAIdentifier(handler.messageType)) {
+          messageTypes.add(handler.messageType);
+        } else {
+          invalidMessageTypes.add(handler.messageType);
+        }
       }
     }
-    if (process.env.POLLY_DEBUG) {
+    if (process.env["POLLY_DEBUG"]) {
       console.log(`[DEBUG] Total handlers extracted: ${handlers.length}`);
+      if (invalidMessageTypes.size > 0) {
+        console.log(`[DEBUG] Filtered ${invalidMessageTypes.size} invalid message type(s) from handlers`);
+      }
     }
     return {
       handlers,
       messageTypes
     };
   }
+  isValidTLAIdentifier(s) {
+    if (!s || s.length === 0) {
+      return false;
+    }
+    return /^[a-zA-Z][a-zA-Z0-9_]*$/.test(s);
+  }
   extractFromFile(sourceFile) {
     const handlers = [];
     const filePath = sourceFile.getFilePath();
@@ -1798,7 +1818,7 @@ class HandlerExtractor {
   extractVerificationConditions(funcNode, preconditions, postconditions) {
     const body = funcNode.getBody();
     const statements = Node5.isBlock(body) ? body.getStatements() : [body];
-    statements.forEach((statement, index) => {
+    statements.forEach((statement) => {
       if (Node5.isExpressionStatement(statement)) {
         const expr = statement.getExpression();
         if (Node5.isCallExpression(expr)) {
@@ -1862,13 +1882,13 @@ class HandlerExtractor {
     if (Node5.isNumericLiteral(node)) {
       return node.getLiteralValue();
     }
-    if (node.getKind() === SyntaxKind3.TrueKeyword) {
+    if (node.getKind() === SyntaxKind.TrueKeyword) {
       return true;
     }
-    if (node.getKind() === SyntaxKind3.FalseKeyword) {
+    if (node.getKind() === SyntaxKind.FalseKeyword) {
       return false;
     }
-    if (node.getKind() === SyntaxKind3.NullKeyword) {
+    if (node.getKind() === SyntaxKind.NullKeyword) {
       return null;
     }
     return;
@@ -1951,7 +1971,7 @@ class HandlerExtractor {
         typeGuards = this.findTypePredicateFunctions(sourceFile);
         this.typeGuardCache.set(sourceFile, typeGuards);
       }
-      if (process.env.POLLY_DEBUG) {
+      if (process.env["POLLY_DEBUG"]) {
         console.log(`[DEBUG] File: ${sourceFile.getBaseName()}`);
         console.log(`[DEBUG] Local type guards found: ${typeGuards.size}`);
         if (typeGuards.size > 0) {
@@ -1965,7 +1985,7 @@ class HandlerExtractor {
         const handler = this.extractHandlerFromIfClause(currentIf, typeGuards, context, filePath);
         if (handler) {
           handlers.push(handler);
-          if (process.env.POLLY_DEBUG) {
+          if (process.env["POLLY_DEBUG"]) {
             console.log(`[DEBUG] Found handler: ${handler.messageType} at line ${handler.location.line}`);
           }
         }
@@ -1977,7 +1997,7 @@ class HandlerExtractor {
         }
       }
     } catch (error) {
-      if (process.env.POLLY_DEBUG) {
+      if (process.env["POLLY_DEBUG"]) {
         console.log(`[DEBUG] Error in extractTypeGuardHandlers: ${error}`);
       }
     }
@@ -1985,7 +2005,8 @@ class HandlerExtractor {
   }
   extractHandlerFromIfClause(ifNode, typeGuards, context, filePath) {
     try {
-      const condition = ifNode.getExpression();
+      const ifStmt = ifNode;
+      const condition = ifStmt.getExpression();
       if (!Node5.isCallExpression(condition)) {
         return null;
       }
@@ -1994,32 +2015,32 @@ class HandlerExtractor {
       if (Node5.isIdentifier(funcExpr)) {
         funcName = funcExpr.getText();
       }
-      if (process.env.POLLY_DEBUG && funcName) {
+      if (process.env["POLLY_DEBUG"] && funcName) {
         console.log(`[DEBUG] Processing if condition with function: ${funcName}`);
       }
       let messageType = undefined;
       if (funcName && typeGuards.has(funcName)) {
         messageType = typeGuards.get(funcName);
-        if (process.env.POLLY_DEBUG) {
+        if (process.env["POLLY_DEBUG"]) {
           console.log(`[DEBUG] Found in local type guards: ${funcName} → ${messageType}`);
         }
       } else if (Node5.isIdentifier(funcExpr)) {
-        if (process.env.POLLY_DEBUG) {
+        if (process.env["POLLY_DEBUG"]) {
           console.log(`[DEBUG] Not found locally, trying import resolution for: ${funcName}`);
         }
-        messageType = this.resolveImportedTypeGuard(funcExpr);
+        messageType = this.resolveImportedTypeGuard(funcExpr) ?? undefined;
       }
       if (!messageType) {
-        if (process.env.POLLY_DEBUG && funcName) {
+        if (process.env["POLLY_DEBUG"] && funcName) {
           console.log(`[DEBUG] Could not resolve message type for: ${funcName}`);
         }
         return null;
       }
-      const line = ifNode.getStartLineNumber();
-      const sourceFile = ifNode.getSourceFile();
+      const line = ifStmt.getStartLineNumber();
+      const sourceFile = ifStmt.getSourceFile();
       const handlerName = `${messageType}_handler`;
       let relationships = undefined;
-      const thenStatement = ifNode.getThenStatement();
+      const thenStatement = ifStmt.getThenStatement();
       if (thenStatement) {
         const detectedRelationships = this.relationshipExtractor.extractFromHandler(thenStatement, sourceFile, handlerName);
         if (detectedRelationships.length > 0) {
@@ -2072,7 +2093,7 @@ class HandlerExtractor {
                 const bodyText = body.getText();
                 const typeValueMatch = bodyText.match(/\.type\s*===?\s*['"](\w+)['"]/);
                 if (typeValueMatch) {
-                  messageType = typeValueMatch[1];
+                  messageType = typeValueMatch[1] ?? null;
                 }
               }
             }
@@ -2090,7 +2111,7 @@ class HandlerExtractor {
       const funcName = identifier.getText();
       const definitions = identifier.getDefinitionNodes();
       if (definitions.length === 0) {
-        if (process.env.POLLY_DEBUG) {
+        if (process.env["POLLY_DEBUG"]) {
           console.log(`[DEBUG] No definitions found for imported function: ${funcName}`);
         }
         return null;
@@ -2098,7 +2119,7 @@ class HandlerExtractor {
       for (const def of definitions) {
         if (Node5.isFunctionDeclaration(def) || Node5.isFunctionExpression(def) || Node5.isArrowFunction(def)) {
           const returnTypeNode = def.getReturnTypeNode();
-          if (process.env.POLLY_DEBUG) {
+          if (process.env["POLLY_DEBUG"]) {
             const returnType = def.getReturnType().getText();
             console.log(`[DEBUG] Function ${funcName} return type (resolved): ${returnType}`);
             console.log(`[DEBUG] Has return type node: ${!!returnTypeNode}`);
@@ -2110,7 +2131,7 @@ class HandlerExtractor {
               const typeName = typeNode.getText();
               const messageType = this.extractMessageTypeFromTypeName(typeName);
               if (messageType) {
-                if (process.env.POLLY_DEBUG) {
+                if (process.env["POLLY_DEBUG"]) {
                   console.log(`[DEBUG] Resolved ${funcName} → ${messageType} (from AST type predicate)`);
                 }
                 return messageType;
@@ -2122,8 +2143,8 @@ class HandlerExtractor {
             const bodyText = body.getText();
             const typeValueMatch = bodyText.match(/\.type\s*===?\s*['"](\w+)['"]/);
             if (typeValueMatch) {
-              const messageType = typeValueMatch[1];
-              if (process.env.POLLY_DEBUG) {
+              const messageType = typeValueMatch[1] ?? null;
+              if (process.env["POLLY_DEBUG"]) {
                 console.log(`[DEBUG] Resolved ${funcName} → ${messageType} (from body)`);
               }
               return messageType;
@@ -2132,7 +2153,7 @@ class HandlerExtractor {
         }
       }
     } catch (error) {
-      if (process.env.POLLY_DEBUG) {
+      if (process.env["POLLY_DEBUG"]) {
         console.log(`[DEBUG] Error resolving imported type guard: ${error}`);
       }
     }
@@ -2228,9 +2249,9 @@ class ADRExtractor {
     const content = fs2.readFileSync(filePath, "utf-8");
     const fileName = path2.basename(filePath, ".md");
     const idMatch = fileName.match(/^(\d+)/);
-    const id = idMatch ? idMatch[1] : fileName;
+    const id = idMatch?.[1] ?? fileName;
     const titleMatch = content.match(/^#\s+(.+)$/m);
-    const title = titleMatch ? titleMatch[1].trim() : fileName;
+    const title = titleMatch?.[1]?.trim() ?? fileName;
     const status = this.extractStatus(content);
     const date = this.extractDate(content);
     const context = this.extractSection(content, "Context");
@@ -2251,8 +2272,8 @@ class ADRExtractor {
       context,
       decision,
       consequences,
-      alternatives,
-      links,
+      ...alternatives && alternatives.length > 0 ? { alternatives } : {},
+      ...links.length > 0 ? { links } : {},
       source: filePath
     };
   }
@@ -2260,20 +2281,20 @@ class ADRExtractor {
     const statusMatch = content.match(/Status:\s*(\w+)/i);
     if (!statusMatch)
       return "accepted";
-    const status = statusMatch[1].toLowerCase();
-    if (["proposed", "accepted", "deprecated", "superseded"].includes(status)) {
+    const status = statusMatch[1]?.toLowerCase();
+    if (status && ["proposed", "accepted", "deprecated", "superseded"].includes(status)) {
       return status;
     }
     return "accepted";
   }
   extractDate(content) {
     const dateMatch = content.match(/Date:\s*(\d{4}-\d{2}-\d{2})/i) || content.match(/(\d{4}-\d{2}-\d{2})/i);
-    return dateMatch ? dateMatch[1] : new Date().toISOString().split("T")[0];
+    return dateMatch?.[1] ?? new Date().toISOString().split("T")[0];
   }
   extractSection(content, sectionName) {
     const regex = new RegExp(`##\\s+${sectionName}\\s*\\n([\\s\\S]*?)(?=\\n##|$)`, "i");
     const match = content.match(regex);
-    return match ? match[1].trim() : "";
+    return match?.[1]?.trim() ?? "";
   }
   extractLinks(content) {
     const links = [];
@@ -2281,10 +2302,11 @@ class ADRExtractor {
     if (supersedesMatch) {
       for (const match of supersedesMatch) {
         const idMatch = match.match(/ADR-(\d+)/);
-        if (idMatch) {
+        const id = idMatch?.[1];
+        if (id) {
           links.push({
             type: "supersedes",
-            adrId: idMatch[1]
+            adrId: id
           });
         }
       }
@@ -2293,10 +2315,11 @@ class ADRExtractor {
     if (supersededByMatch) {
       for (const match of supersededByMatch) {
         const idMatch = match.match(/ADR-(\d+)/);
-        if (idMatch) {
+        const id = idMatch?.[1];
+        if (id) {
           links.push({
             type: "superseded-by",
-            adrId: idMatch[1]
+            adrId: id
           });
         }
       }
@@ -2327,7 +2350,7 @@ class ArchitectureAnalyzer {
       systemInfo = {
         name: manifest.name,
         version: manifest.version,
-        description: manifest.description
+        ...manifest.description ? { description: manifest.description } : {}
       };
     } else {
       const { detectProjectConfig: detectProjectConfig2 } = await Promise.resolve().then(() => (init_project_detector(), exports_project_detector));
@@ -2336,7 +2359,7 @@ class ArchitectureAnalyzer {
       systemInfo = {
         name: projectConfig.metadata?.name || "Unknown Project",
         version: projectConfig.metadata?.version || "0.0.0",
-        description: projectConfig.metadata?.description
+        ...projectConfig.metadata?.description ? { description: projectConfig.metadata.description } : {}
       };
     }
     const handlerExtractor = new HandlerExtractor(this.options.tsConfigPath);
@@ -2361,13 +2384,13 @@ class ArchitectureAnalyzer {
     return {
       projectRoot: this.options.projectRoot,
       system: systemInfo,
-      manifest,
-      projectConfig,
+      ...manifest ? { manifest } : {},
+      ...projectConfig ? { projectConfig } : {},
       contexts,
       messageFlows,
       integrations,
-      adrs: adrs.adrs.length > 0 ? adrs : undefined,
-      repository
+      ...adrs.adrs.length > 0 ? { adrs } : {},
+      ...repository ? { repository } : {}
     };
   }
   mergeExternalAPIsIntoContexts(contexts, integrations) {
@@ -2578,7 +2601,6 @@ class StructurizrDSLGenerator {
     const parts = [];
     for (const integration of this.analysis.integrations) {
       if (integration.type === "api" || integration.type === "websocket") {
-        const tech = integration.technology || (integration.type === "websocket" ? "WebSocket" : "REST API");
         let desc = integration.description || "";
         if (!desc && integration.calls && integration.calls.length > 0) {
           const endpoints = integration.calls.slice(0, 3).map((c) => c.endpoint).join(", ");
@@ -2691,7 +2713,7 @@ class StructurizrDSLGenerator {
     return parts.join(`
 `);
   }
-  generateComponentDescription(messageType, handler) {
+  generateComponentDescription(messageType, _handler) {
     const type = messageType.toLowerCase();
     if (type.includes("login")) {
       return "Authenticates users and establishes sessions";
@@ -2721,7 +2743,7 @@ class StructurizrDSLGenerator {
     }
     return `Processes ${messageType} messages and coordinates business logic`;
   }
-  getComponentTags(messageType, handler) {
+  getComponentTags(messageType, _handler) {
     const tags = ["Message Handler"];
     const type = messageType.toLowerCase();
     if (type.includes("login") || type.includes("logout") || type.includes("auth")) {
@@ -2780,7 +2802,7 @@ class StructurizrDSLGenerator {
     }
     return properties;
   }
-  generateComponentRelationships(contextType, contextInfo) {
+  generateComponentRelationships(_contextType, contextInfo) {
     const parts = [];
     const handlersByType = new Map;
     for (const handler of contextInfo.handlers) {
@@ -2792,7 +2814,7 @@ class StructurizrDSLGenerator {
     if (contextInfo.chromeAPIs && contextInfo.chromeAPIs.length > 0) {
       for (const api of contextInfo.chromeAPIs) {
         const apiId = this.toId(`chrome_${api}`);
-        for (const [messageType, handlers] of handlersByType) {
+        for (const [messageType, _handlers] of handlersByType) {
           const componentId = this.toId(this.toComponentName(messageType));
           let description = `Uses ${api}`;
           if (api === "storage") {
@@ -2838,7 +2860,7 @@ class StructurizrDSLGenerator {
     }
     const stateHandlers = [];
     const queryHandlers = [];
-    for (const [messageType, handlers] of handlersByType) {
+    for (const [messageType, _handlers] of handlersByType) {
       const type = messageType.toLowerCase();
       const componentId = this.toId(this.toComponentName(messageType));
       if (type.includes("add") || type.includes("create") || type.includes("update") || type.includes("delete") || type.includes("remove") || type.includes("toggle") || type.includes("clear") || type.includes("login") || type.includes("logout")) {
@@ -2994,7 +3016,6 @@ class StructurizrDSLGenerator {
   }
   generateAutomaticDynamicDiagrams() {
     const diagrams = [];
-    const processedHandlers = new Set;
     const handlersWithRelationships = [];
     for (const [contextType, contextInfo] of Object.entries(this.analysis.contexts)) {
       for (const handler of contextInfo.handlers) {
@@ -3059,7 +3080,7 @@ class StructurizrDSLGenerator {
     const scope = handlers[0]?.contextName ? `extension.${handlers[0].contextName}` : "extension";
     parts.push(`    dynamic ${scope} "${title}" "${description}" {`);
     let stepCount = 0;
-    for (const { handler, contextName } of handlers) {
+    for (const { handler, contextName: _contextName } of handlers) {
       const handlerComponentId = this.toId(`${handler.messageType}_handler`);
       for (const rel of handler.relationships) {
         const toComponent = this.toId(rel.to);
@@ -3142,7 +3163,7 @@ class StructurizrDSLGenerator {
       state: "Application state synchronization",
       general: "Message flow through the system"
     };
-    return descriptions[domain] || descriptions.general;
+    return descriptions[domain] || descriptions["general"];
   }
   getUserAction(domain) {
     const actions = {
@@ -3151,7 +3172,7 @@ class StructurizrDSLGenerator {
       state: "Requests state",
       general: "Interacts"
     };
-    return actions[domain] || actions.general;
+    return actions[domain] || actions["general"];
   }
   getMessageDescription(messageType) {
     const type = messageType.toLowerCase();
@@ -3360,9 +3381,6 @@ class StructurizrDSLGenerator {
   toId(name) {
     return name.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_|_$/g, "");
   }
-  toViewName(flowName) {
-    return flowName.split(/[_-]/).map((part) => this.capitalize(part)).join(" ");
-  }
   capitalize(str) {
     return str.charAt(0).toUpperCase() + str.slice(1);
   }
@@ -3429,12 +3447,12 @@ class StructurizrDSLGenerator {
       let entity = null;
       const underscoreMatch = type.match(/^([a-z]+)_(add|create|update|delete|remove|get|fetch|load|list|query)/);
       if (underscoreMatch) {
-        entity = underscoreMatch[1];
+        entity = underscoreMatch[1] ?? null;
       }
       if (!entity) {
         const camelMatch = type.match(/(add|create|update|delete|remove|get|fetch|load|list|query)([a-z]+)/i);
         if (camelMatch) {
-          entity = camelMatch[2].toLowerCase();
+          entity = camelMatch[2]?.toLowerCase() ?? null;
         }
       }
       if (!entity && type.match(/^[a-z]+$/)) {
@@ -3811,7 +3829,7 @@ Stack trace:`, COLORS.gray));
     process.exit(1);
   }
 }
-async function exportCommand(args) {
+async function exportCommand(_args) {
   console.log(color(`
 \uD83D\uDCE4 Generating static site...
 `, COLORS.blue));
@@ -3884,7 +3902,7 @@ async function serveCommand(args) {
     if (!BunGlobal) {
       throw new Error("Bun runtime is required to run the server");
     }
-    const server = BunGlobal.serve({
+    BunGlobal.serve({
       port,
       fetch(req) {
         const url = new URL(req.url);
@@ -3999,4 +4017,4 @@ Stack trace:`, COLORS.gray));
   process.exit(1);
 });
 
-//# debugId=701BDB9A33D6395464756E2164756E21
+//# debugId=698279082E1D6F3764756E2164756E21