@akanjs/cli 3.0.0-alpha.2 → 3.0.0-alpha.4

package/{quality.command-z5kth2wa.js → quality.command-hy5vt1bh.js}

@@ -7,9 +7,9 @@ import {
   command,
   runner,
   script
-} from "./index-8hsbnyes.js";
-import"./index-hgna5rjy.js";
-import"./index-mxvakhsm.js";
+} from "./index-jk9q6pse.js";
+import"./index-jtm86byd.js";
+import"./index-6pz1j0zj.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";
 
@@ -18,369 +18,7 @@ import { createHash } from "crypto";
 import { readdir, readFile, stat } from "fs/promises";
 import path from "path";
 import ignore from "ignore";
-import ts2 from "typescript";
-
-// pkgs/@akanjs/devkit/ssrScanner.ts
 import ts from "typescript";
-var STATIC_COMPONENT_MIN_MASS = 4;
-var MIXED_COMPONENT_MIN_MASS = 10;
-var MIXED_COMPONENT_MAX_TOUCHES = 2;
-var MODULE_SERVER_VIEW_MIN_CLIENT_MASS = 12;
-
-class SsrScanner {
-  static #serverSafeCalls = new Set(["usePage", "getSelf", "useServer"]);
-  static #clientGlobals = new Set([
-    "window",
-    "document",
-    "navigator",
-    "localStorage",
-    "sessionStorage",
-    "location",
-    "history",
-    "screen",
-    "matchMedia",
-    "IntersectionObserver",
-    "ResizeObserver",
-    "MutationObserver",
-    "requestAnimationFrame",
-    "WebSocket"
-  ]);
-  static #clientRuntimeImports = new Set(["st", "fetch"]);
-  scan(sourceFiles) {
-    const componentFiles = sourceFiles.filter((sourceFile) => this.#isBalancedFile(sourceFile.file));
-    return {
-      warnings: [
-        ...componentFiles.flatMap((sourceFile) => this.#scanFile(sourceFile)),
-        ...this.#scanModules(componentFiles)
-      ],
-      balance: this.#measureBalance(componentFiles)
-    };
-  }
-  #scanFile(sourceFile) {
-    if (!this.#hasUseClient(sourceFile.sourceFile))
-      return [];
-    const vendorNames = this.#getVendorNames(sourceFile.sourceFile);
-    const hasVendorImport = this.#hasVendorImport(sourceFile.sourceFile);
-    const importsClientRuntime = this.#importsClientRuntime(sourceFile.sourceFile);
-    const components = this.#getComponents(sourceFile, vendorNames);
-    const warnings = [];
-    if (!hasVendorImport && !importsClientRuntime && this.#getTouches(sourceFile.sourceFile, sourceFile.sourceFile).length === 0 && !this.#isConventionClientFile(sourceFile.file)) {
-      warnings.push({
-        rule: "akan.ssr.unnecessary-use-client",
-        scope: "ssr",
-        severity: "warning",
-        file: sourceFile.file,
-        line: 1,
-        message: `"use client" is declared but the file uses no client-only capability (hook, event handler, store, or browser API).`
-      });
-    }
-    for (const component of components) {
-      if (component.vendorTags)
-        continue;
-      if (component.touches.length === 0 && component.mass >= STATIC_COMPONENT_MIN_MASS) {
-        warnings.push({
-          rule: "akan.ssr.client-static-component",
-          scope: "ssr",
-          severity: "warning",
-          file: sourceFile.file,
-          line: component.line,
-          message: `Client component "${component.name}" renders ${component.mass} JSX elements with no client-only capability. It is server-renderable markup sitting in the client bundle.`
-        });
-        continue;
-      }
-      if (component.touches.length >= 1 && component.touches.length <= MIXED_COMPONENT_MAX_TOUCHES && component.mass >= MIXED_COMPONENT_MIN_MASS) {
-        warnings.push({
-          rule: "akan.ssr.client-static-markup",
-          scope: "ssr",
-          severity: "warning",
-          file: sourceFile.file,
-          line: component.line,
-          message: `Client component "${component.name}" renders ${component.mass} JSX elements around only ${component.touches.length} client-only touch (${[...new Set(component.touches)].join(", ")}). Most of this subtree does not need the client bundle.`
-        });
-      }
-    }
-    warnings.push(...this.#getMountLoadWarnings(sourceFile));
-    warnings.push(...this.#getTemplateStateWarnings(sourceFile));
-    return warnings;
-  }
-  #scanModules(sourceFiles) {
-    const modules = new Map;
-    for (const sourceFile of sourceFiles) {
-      const moduleDir = this.#getModuleDir(sourceFile.file);
-      if (!moduleDir)
-        continue;
-      const entry = modules.get(moduleDir) ?? { clientMass: 0, serverFiles: 0, line: sourceFile.file };
-      if (this.#hasUseClient(sourceFile.sourceFile))
-        entry.clientMass += this.#getMass(sourceFile.sourceFile);
-      else if (/\.(Unit|View)\.tsx$/.test(sourceFile.file))
-        entry.serverFiles += 1;
-      modules.set(moduleDir, entry);
-    }
-    return [...modules].filter(([, entry]) => entry.serverFiles === 0 && entry.clientMass >= MODULE_SERVER_VIEW_MIN_CLIENT_MASS).map(([moduleDir, entry]) => ({
-      rule: "akan.ssr.module-missing-server-view",
-      scope: "ssr",
-      severity: "warning",
-      file: entry.line,
-      message: `Module "${moduleDir}" renders ${entry.clientMass} JSX elements from client files only; it declares no Unit or View server component.`
-    }));
-  }
-  #getMountLoadWarnings(sourceFile) {
-    const warnings = [];
-    const visit = (node) => {
-      if (this.#isMountEffect(sourceFile.sourceFile, node)) {
-        for (const load of this.#getLoadCalls(sourceFile.sourceFile, node)) {
-          warnings.push({
-            rule: "akan.ssr.client-mount-load",
-            scope: "ssr",
-            severity: "warning",
-            file: sourceFile.file,
-            line: this.#getLine(sourceFile.sourceFile, load.node),
-            message: `Mount-only effect loads server data with ${load.callee}(). The route can fetch this before the first byte instead.`
-          });
-        }
-      }
-      ts.forEachChild(node, visit);
-    };
-    ts.forEachChild(sourceFile.sourceFile, visit);
-    return warnings;
-  }
-  #isMountEffect(sourceFile, node) {
-    if (!ts.isCallExpression(node))
-      return false;
-    const callee = node.expression.getText(sourceFile);
-    if (callee !== "useEffect" && callee !== "useLayoutEffect")
-      return false;
-    const deps = node.arguments[1];
-    return !!deps && ts.isArrayLiteralExpression(deps) && deps.elements.length === 0;
-  }
-  #getLoadCalls(sourceFile, node) {
-    const calls = [];
-    const visit = (child) => {
-      if (ts.isCallExpression(child)) {
-        const callee = child.expression.getText(sourceFile);
-        if (/^fetch\.[a-z]/.test(callee) || /^st\.do\.(init|get|view|load|list|count|insight)[A-Z]/.test(callee))
-          calls.push({ callee, node: child });
-      }
-      ts.forEachChild(child, visit);
-    };
-    ts.forEachChild(node, visit);
-    return calls;
-  }
-  #getTemplateStateWarnings(sourceFile) {
-    if (!sourceFile.file.endsWith(".Template.tsx"))
-      return [];
-    const warnings = [];
-    const visit = (node) => {
-      if (ts.isCallExpression(node) && node.expression.getText(sourceFile.sourceFile) === "useState") {
-        warnings.push({
-          rule: "akan.ssr.template-client-state",
-          scope: "ssr",
-          severity: "warning",
-          file: sourceFile.file,
-          line: this.#getLine(sourceFile.sourceFile, node),
-          message: "Template holds form state in useState. Templates are store-driven and carry no local state."
-        });
-      }
-      ts.forEachChild(node, visit);
-    };
-    ts.forEachChild(sourceFile.sourceFile, visit);
-    return warnings;
-  }
-  #measureBalance(sourceFiles) {
-    const scopes = new Map;
-    for (const sourceFile of sourceFiles) {
-      const segments = sourceFile.file.split("/");
-      const scope = `${segments[0]}/${segments[1]}`;
-      const entry = scopes.get(scope) ?? { serverMass: 0, clientMass: 0 };
-      const mass = this.#getMass(sourceFile.sourceFile);
-      if (this.#hasUseClient(sourceFile.sourceFile))
-        entry.clientMass += mass;
-      else
-        entry.serverMass += mass;
-      scopes.set(scope, entry);
-    }
-    const entries = [...scopes].map(([scope, mass]) => ({ scope, ...mass, serverShare: getShare(mass.serverMass, mass.clientMass) })).sort((a, b) => a.scope.localeCompare(b.scope));
-    if (entries.length < 2)
-      return entries;
-    const serverMass = entries.reduce((sum, entry) => sum + entry.serverMass, 0);
-    const clientMass = entries.reduce((sum, entry) => sum + entry.clientMass, 0);
-    return [...entries, { scope: "workspace", serverMass, clientMass, serverShare: getShare(serverMass, clientMass) }];
-  }
-  #getComponents(sourceFile, vendorNames) {
-    const components = [];
-    for (const statement of sourceFile.sourceFile.statements) {
-      for (const { name, node } of this.#getComponentNodes(statement)) {
-        if (!/^[A-Z]/.test(name))
-          continue;
-        components.push({
-          name,
-          line: this.#getLine(sourceFile.sourceFile, node),
-          mass: this.#getMass(node),
-          touches: this.#getTouches(sourceFile.sourceFile, node),
-          vendorTags: [...this.#getTagNames(sourceFile.sourceFile, node)].some((tag) => vendorNames.has(tag))
-        });
-      }
-    }
-    return components;
-  }
-  #getComponentNodes(statement) {
-    if (ts.isFunctionDeclaration(statement) && statement.body)
-      return [{ name: statement.name?.text ?? "default", node: statement.body }];
-    if (!ts.isVariableStatement(statement))
-      return [];
-    return statement.declarationList.declarations.flatMap((declaration) => {
-      if (!ts.isIdentifier(declaration.name) || !declaration.initializer)
-        return [];
-      if (!ts.isArrowFunction(declaration.initializer) && !ts.isFunctionExpression(declaration.initializer))
-        return [];
-      return [{ name: declaration.name.text, node: declaration.initializer }];
-    });
-  }
-  #getTouches(sourceFile, node) {
-    const touches = [];
-    const visit = (child) => {
-      if (ts.isCallExpression(child)) {
-        const callee = child.expression.getText(sourceFile);
-        const bareName = callee.split(".").pop() ?? callee;
-        if (callee === "createContext" || callee === "lazy")
-          touches.push(callee);
-        else if (/^use[A-Z]/.test(bareName) && !SsrScanner.#serverSafeCalls.has(bareName))
-          touches.push(bareName);
-      }
-      if (ts.isJsxAttribute(child) && /^on[A-Z]/.test(child.name.getText(sourceFile)))
-        touches.push(child.name.getText(sourceFile));
-      if (ts.isPropertyAccessExpression(child)) {
-        const root = getAccessRoot(child);
-        if (root === "st")
-          touches.push("st");
-        else if (SsrScanner.#clientGlobals.has(root))
-          touches.push(root);
-      }
-      ts.forEachChild(child, visit);
-    };
-    ts.forEachChild(node, visit);
-    return touches;
-  }
-  #getTagNames(sourceFile, node) {
-    const tags = new Set;
-    const visit = (child) => {
-      if (ts.isJsxOpeningElement(child) || ts.isJsxSelfClosingElement(child))
-        tags.add(child.tagName.getText(sourceFile).split(".")[0]);
-      ts.forEachChild(child, visit);
-    };
-    ts.forEachChild(node, visit);
-    return tags;
-  }
-  #getMass(node) {
-    let mass = 0;
-    const visit = (child) => {
-      if (ts.isJsxOpeningElement(child) || ts.isJsxSelfClosingElement(child))
-        mass += 1;
-      ts.forEachChild(child, visit);
-    };
-    ts.forEachChild(node, visit);
-    return mass;
-  }
-  #hasUseClient(sourceFile) {
-    const first = sourceFile.statements[0];
-    if (!first || !ts.isExpressionStatement(first) || !ts.isStringLiteral(first.expression))
-      return false;
-    return first.expression.text === "use client";
-  }
-  #hasVendorImport(sourceFile) {
-    return sourceFile.statements.some((statement) => ts.isImportDeclaration(statement) && isVendorSpecifier(getSpecifier(statement)));
-  }
-  #getVendorNames(sourceFile) {
-    const names = new Set;
-    for (const statement of sourceFile.statements) {
-      if (!ts.isImportDeclaration(statement) || !isVendorSpecifier(getSpecifier(statement)))
-        continue;
-      const clause = statement.importClause;
-      if (clause?.name)
-        names.add(clause.name.text);
-      if (clause?.namedBindings && ts.isNamespaceImport(clause.namedBindings))
-        names.add(clause.namedBindings.name.text);
-      if (clause?.namedBindings && ts.isNamedImports(clause.namedBindings))
-        for (const element of clause.namedBindings.elements)
-          names.add(element.name.text);
-    }
-    return names;
-  }
-  #importsClientRuntime(sourceFile) {
-    for (const statement of sourceFile.statements) {
-      if (!ts.isImportDeclaration(statement))
-        continue;
-      const bindings = statement.importClause?.namedBindings;
-      if (!bindings || !ts.isNamedImports(bindings))
-        continue;
-      if (bindings.elements.some((element) => SsrScanner.#clientRuntimeImports.has(element.name.text)))
-        return true;
-    }
-    return false;
-  }
-  #isConventionClientFile(file) {
-    if (file.endsWith("/index_.tsx"))
-      return true;
-    return /\.(Zone|Template|Util)\.tsx$/.test(file) && this.#getModuleDir(file) !== null;
-  }
-  #isBalancedFile(file) {
-    if (!file.endsWith(".tsx") || file.endsWith(".test.tsx") || file.endsWith(".spec.tsx"))
-      return false;
-    const segments = file.split("/");
-    if (segments[0] !== "apps" && segments[0] !== "libs")
-      return false;
-    return segments[2] === "ui" || segments[2] === "lib";
-  }
-  #getModuleDir(file) {
-    const segments = file.split("/");
-    const libIndex = segments.indexOf("lib");
-    if (libIndex < 1 || segments.length <= libIndex + 2)
-      return null;
-    const moduleName = segments[libIndex + 1];
-    if (moduleName.startsWith("_"))
-      return null;
-    return segments.slice(0, libIndex + 2).join("/");
-  }
-  #getLine(sourceFile, node) {
-    return sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile)).line + 1;
-  }
-}
-var SSR_SERVER_SHARE_TARGET = 0.5;
-function formatSsrBalance(balance) {
-  if (balance.length === 0)
-    return ["No component files found."];
-  return balance.map((entry) => {
-    const total = entry.serverMass + entry.clientMass;
-    const share = `${Math.round(entry.serverShare * 100)}% server`;
-    const counts = `${entry.serverMass} of ${total} JSX elements, ${entry.clientMass} client`;
-    const flag = entry.serverShare < SSR_SERVER_SHARE_TARGET ? `  <- below the ${Math.round(SSR_SERVER_SHARE_TARGET * 100)}% target` : "";
-    return `  ${entry.scope}: ${share} (${counts})${flag}`;
-  });
-}
-function getShare(serverMass, clientMass) {
-  const total = serverMass + clientMass;
-  return total === 0 ? 1 : serverMass / total;
-}
-function getSpecifier(statement) {
-  return ts.isStringLiteral(statement.moduleSpecifier) ? statement.moduleSpecifier.text : "";
-}
-function isVendorSpecifier(specifier) {
-  if (specifier === "" || specifier.startsWith(".") || specifier.startsWith("/"))
-    return false;
-  if (specifier === "react" || specifier === "react-dom" || specifier.startsWith("react/"))
-    return false;
-  if (specifier.startsWith("node:"))
-    return false;
-  return !/^(akanjs|@akanjs|@libs|@apps|@contract)(\/|$)/.test(specifier);
-}
-function getAccessRoot(node) {
-  let current = node;
-  while (ts.isPropertyAccessExpression(current))
-    current = current.expression;
-  return ts.isIdentifier(current) ? current.text : "";
-}
-
-// pkgs/@akanjs/devkit/qualityScanner.ts
 var MAX_FILE_LINES = 2000;
 var PLACEHOLDER_EXPORT_NAMES = new Set([
   "aa",
@@ -463,13 +101,7 @@ var RULE_FIXES = {
   "akan.file.component-export": "Move the value or type to a util/constant/type file in ui/, webkit/, or common/ and import it. Adding `export` is not a valid fix \u2014 only PascalCase components and their `<Component>Props` interface belong here.",
   "akan.layout.app-root-file": "Move the file into a conventional app folder (common, env, lib, page, private, public, script, srvkit, ui, or webkit).",
   "akan.layout.lib-root-file": "Move the file into a domain module folder under lib/; keep lib root limited to generated support facets.",
-  "akan.layout.module-ui-file": "Rename the file to an allowed module UI name, or move it to ui/ if it is not a module component.",
-  "akan.ssr.unnecessary-use-client": 'Delete the "use client" directive so the file renders on the server. If it exists only to wrap one client child, drop the wrapper and use the child directly.',
-  "akan.ssr.client-static-component": "Move the component to a server file \u2014 a <Model>.Unit.tsx / <Model>.View.tsx for a module, or a ui/ file with no directive \u2014 and reference it from the client file.",
-  "akan.ssr.client-static-markup": "Keep the interactive element in the client component and hoist the static subtree into a server component, then accept it as `children` or render it through a Unit/View reference.",
-  "akan.ssr.client-mount-load": "Load the data in the route with `fetch.initX(...)` / `fetch.viewX(...)` and pass the init/view object down as a prop; the client store hydrates from it and the effect goes away.",
-  "akan.ssr.module-missing-server-view": "Add a <Model>.Unit.tsx for list/card rendering and a <Model>.View.tsx for the detail surface, then have the Zone delegate to them.",
-  "akan.ssr.template-client-state": "Bind the field to the store instead: `value={xForm.field}` with `onChange={st.do.setFieldOnX}`."
+  "akan.layout.module-ui-file": "Rename the file to an allowed module UI name, or move it to ui/ if it is not a module component."
 };
 function getRuleFix(rule) {
   if (rule.startsWith("akan.convention"))
@@ -482,21 +114,18 @@ class AkanQualityScanner {
     const targetFiles = await this.#collectTargetFiles(workspaceRoot);
     const sourceFiles = await Promise.all(targetFiles.filter((file) => !AbstractDoc.isAbstractPath(file)).map((file) => this.#readSourceFile(workspaceRoot, file)));
     const abstractFiles = await Promise.all(targetFiles.filter((file) => AbstractDoc.isAbstractPath(file)).map((file) => this.#readTextFile(workspaceRoot, file)));
-    const ssr = new SsrScanner().scan(sourceFiles);
     const warnings = [
       ...this.#scanGlobalQuality(sourceFiles),
       ...sourceFiles.flatMap((sourceFile) => this.#scanSingleFileQuality(sourceFile)),
       ...sourceFiles.flatMap((sourceFile) => this.#scanComponentQuality(sourceFile)),
       ...sourceFiles.flatMap((sourceFile) => this.#scanConventionQuality(sourceFile)),
       ...sourceFiles.flatMap((sourceFile) => this.#scanLayoutQuality(sourceFile)),
-      ...abstractFiles.flatMap((abstractFile) => this.#scanAbstractQuality(abstractFile)),
-      ...ssr.warnings
+      ...abstractFiles.flatMap((abstractFile) => this.#scanAbstractQuality(abstractFile))
     ];
     return {
       workspaceRoot,
       scannedFiles: sourceFiles.length + abstractFiles.length,
       warnings: warnings.map((warning) => ({ ...warning, fix: warning.fix ?? getRuleFix(warning.rule) })).sort(compareWarnings),
-      ssrBalance: ssr.balance,
       suggestedRules: SUGGESTED_RULES
     };
   }
@@ -542,7 +171,7 @@ class AkanQualityScanner {
       file,
       absolutePath,
       content,
-      sourceFile: ts2.createSourceFile(file, content, ts2.ScriptTarget.Latest, true, getScriptKind(file))
+      sourceFile: ts.createSourceFile(file, content, ts.ScriptTarget.Latest, true, getScriptKind(file))
     };
   }
   async#readTextFile(workspaceRoot, file) {
@@ -739,10 +368,6 @@ function formatQualityScanResult(result) {
     "",
     ...formatQualityWarnings(result.warnings),
     "",
-    "SSR balance (component files, JSX elements rendered per side):",
-    "",
-    ...formatSsrBalance(result.ssrBalance),
-    "",
     "Suggested quality rules:",
     "",
     ...result.suggestedRules.map((rule) => `  - ${rule}`)
@@ -750,24 +375,6 @@ function formatQualityScanResult(result) {
   return sections.join(`
 `);
 }
-function formatSsrScanResult(result) {
-  const sections = [
-    "Akan SSR Balance Scan",
-    `workspace: ${result.workspaceRoot}`,
-    `scanned files: ${result.scannedFiles}`,
-    `ssr warnings: ${result.warnings.length}`,
-    "",
-    "Server render share (component files, JSX elements rendered per side):",
-    "",
-    ...formatSsrBalance(result.ssrBalance),
-    "",
-    "Warnings:",
-    "",
-    ...formatQualityWarnings(result.warnings)
-  ];
-  return sections.join(`
-`);
-}
 function formatQualityWarnings(warnings) {
   if (warnings.length === 0)
     return ["No warnings found."];
@@ -789,7 +396,7 @@ function getExportedFunctionLikes(sourceFile) {
   const declarations = [];
   const nameExempt = isPageRouteFile(sourceFile.file) || isUiComponentFile(sourceFile.file);
   for (const statement of sourceFile.sourceFile.statements) {
-    if (ts2.isFunctionDeclaration(statement) && statement.name && isExported(statement)) {
+    if (ts.isFunctionDeclaration(statement) && statement.name && isExported(statement)) {
       declarations.push({
         name: statement.name.text,
         kind: "function",
@@ -799,7 +406,7 @@ function getExportedFunctionLikes(sourceFile) {
         duplicateNameExempt: nameExempt || isConventionDuplicateNameExempt(sourceFile.file, false)
       });
     }
-    if (ts2.isClassDeclaration(statement) && statement.name && isExported(statement)) {
+    if (ts.isClassDeclaration(statement) && statement.name && isExported(statement)) {
       declarations.push({
         name: statement.name.text,
         kind: "class",
@@ -809,9 +416,9 @@ function getExportedFunctionLikes(sourceFile) {
         duplicateNameExempt: nameExempt || isConventionDuplicateNameExempt(sourceFile.file, isEnumClassStatement(sourceFile.sourceFile, statement))
       });
     }
-    if (ts2.isVariableStatement(statement) && isExported(statement)) {
+    if (ts.isVariableStatement(statement) && isExported(statement)) {
       for (const declaration of statement.declarationList.declarations) {
-        if (!ts2.isIdentifier(declaration.name) || !isFunctionLikeInitializer(declaration.initializer))
+        if (!ts.isIdentifier(declaration.name) || !isFunctionLikeInitializer(declaration.initializer))
           continue;
         declarations.push({
           name: declaration.name.text,
@@ -850,14 +457,14 @@ function isInLibModule(file) {
   return (segments[0] === "apps" || segments[0] === "libs") && segments.includes("lib");
 }
 function isEnumClassStatement(sourceFile, statement) {
-  if (!ts2.isClassDeclaration(statement))
+  if (!ts.isClassDeclaration(statement))
     return false;
-  const heritageClause = statement.heritageClauses?.find((clause) => clause.token === ts2.SyntaxKind.ExtendsKeyword);
+  const heritageClause = statement.heritageClauses?.find((clause) => clause.token === ts.SyntaxKind.ExtendsKeyword);
   const expression = heritageClause?.types[0]?.expression;
   return !!expression && expression.getText(sourceFile).startsWith("enumOf(");
 }
 function getExportedClassNames(sourceFile) {
-  return sourceFile.statements.filter((statement) => ts2.isClassDeclaration(statement) && !!statement.name).filter((statement) => isExported(statement)).map((statement) => statement.name.text);
+  return sourceFile.statements.filter((statement) => ts.isClassDeclaration(statement) && !!statement.name).filter((statement) => isExported(statement)).map((statement) => statement.name.text);
 }
 function isComponentDeclarationFile(file) {
   if (!file.endsWith(".tsx"))
@@ -873,7 +480,7 @@ function isComponentDeclarationFile(file) {
 function getComponentFileDeclarations(sourceFile) {
   const reExportedNames = new Set;
   for (const statement of sourceFile.statements) {
-    if (ts2.isExportDeclaration(statement) && statement.exportClause && ts2.isNamedExports(statement.exportClause)) {
+    if (ts.isExportDeclaration(statement) && statement.exportClause && ts.isNamedExports(statement.exportClause)) {
       for (const element of statement.exportClause.elements)
         reExportedNames.add((element.propertyName ?? element.name).text);
     }
@@ -883,19 +490,19 @@ function getComponentFileDeclarations(sourceFile) {
     const isDefaultExport = isDefaultExportStatement(statement);
     const inlineExported = isExported(statement);
     const add = (name, kind, line) => declarations.push({ name, kind, line, exported: inlineExported || reExportedNames.has(name), isDefaultExport });
-    if (ts2.isInterfaceDeclaration(statement))
+    if (ts.isInterfaceDeclaration(statement))
       add(statement.name.text, "interface", getLine(sourceFile, statement));
-    else if (ts2.isTypeAliasDeclaration(statement))
+    else if (ts.isTypeAliasDeclaration(statement))
       add(statement.name.text, "type", getLine(sourceFile, statement));
-    else if (ts2.isEnumDeclaration(statement))
+    else if (ts.isEnumDeclaration(statement))
       add(statement.name.text, "enum", getLine(sourceFile, statement));
-    else if (ts2.isFunctionDeclaration(statement) && statement.name)
+    else if (ts.isFunctionDeclaration(statement) && statement.name)
       add(statement.name.text, "function", getLine(sourceFile, statement));
-    else if (ts2.isClassDeclaration(statement) && statement.name)
+    else if (ts.isClassDeclaration(statement) && statement.name)
       add(statement.name.text, "class", getLine(sourceFile, statement));
-    else if (ts2.isVariableStatement(statement)) {
+    else if (ts.isVariableStatement(statement)) {
       for (const declaration of statement.declarationList.declarations) {
-        if (!ts2.isIdentifier(declaration.name))
+        if (!ts.isIdentifier(declaration.name))
           continue;
         const kind = isFunctionLikeInitializer(declaration.initializer) ? "function" : "variable";
         add(declaration.name.text, kind, getLine(sourceFile, declaration));
@@ -907,15 +514,15 @@ function getComponentFileDeclarations(sourceFile) {
 function getCompoundComponentNames(sourceFile) {
   const names = new Set;
   for (const statement of sourceFile.statements) {
-    if (!ts2.isExpressionStatement(statement))
+    if (!ts.isExpressionStatement(statement))
       continue;
     const { expression } = statement;
-    if (!ts2.isBinaryExpression(expression) || expression.operatorToken.kind !== ts2.SyntaxKind.EqualsToken)
+    if (!ts.isBinaryExpression(expression) || expression.operatorToken.kind !== ts.SyntaxKind.EqualsToken)
       continue;
-    if (!ts2.isPropertyAccessExpression(expression.left) || !isPascalCaseName(expression.left.name.text))
+    if (!ts.isPropertyAccessExpression(expression.left) || !isPascalCaseName(expression.left.name.text))
       continue;
     names.add(expression.left.name.text);
-    if (ts2.isIdentifier(expression.right) && isPascalCaseName(expression.right.text))
+    if (ts.isIdentifier(expression.right) && isPascalCaseName(expression.right.text))
       names.add(expression.right.text);
   }
   return names;
@@ -935,9 +542,9 @@ function isPascalCaseName(name) {
   return /^[A-Z]/.test(name) && !/^[A-Z0-9_]+$/.test(name);
 }
 function isDefaultExportStatement(statement) {
-  if (ts2.isExportAssignment(statement))
+  if (ts.isExportAssignment(statement))
     return !statement.isExportEquals;
-  return !!(ts2.getCombinedModifierFlags(statement) & ts2.ModifierFlags.Default);
+  return !!(ts.getCombinedModifierFlags(statement) & ts.ModifierFlags.Default);
 }
 function getPlaceholderExportWarnings(sourceFile) {
   if (!sourceFile.file.endsWith("/index.ts") && !sourceFile.file.endsWith("/index.tsx"))
@@ -967,7 +574,7 @@ function getDictionaryTextWarnings(sourceFile) {
 function getGlobalMutationWarnings(sourceFile) {
   const warnings = [];
   for (const statement of sourceFile.sourceFile.statements) {
-    if (ts2.isModuleDeclaration(statement) && statement.name.getText(sourceFile.sourceFile) === "global") {
+    if (ts.isModuleDeclaration(statement) && statement.name.getText(sourceFile.sourceFile) === "global") {
       warnings.push({
         rule: "akan.file.global-declaration",
         scope: "file",
@@ -977,7 +584,7 @@ function getGlobalMutationWarnings(sourceFile) {
         message: "Global declarations require an explicit low-level integration allowlist."
       });
     }
-    if (ts2.isInterfaceDeclaration(statement) && statement.name.text === "Window") {
+    if (ts.isInterfaceDeclaration(statement) && statement.name.text === "Window") {
       warnings.push({
         rule: "akan.file.window-augmentation",
         scope: "file",
@@ -987,7 +594,7 @@ function getGlobalMutationWarnings(sourceFile) {
         message: "Window augmentation should be isolated to approved browser integration files."
       });
     }
-    if (ts2.isExpressionStatement(statement) && statement.expression.getText(sourceFile.sourceFile).includes(".prototype.")) {
+    if (ts.isExpressionStatement(statement) && statement.expression.getText(sourceFile.sourceFile).includes(".prototype.")) {
       warnings.push({
         rule: "akan.file.prototype-mutation",
         scope: "file",
@@ -1005,23 +612,23 @@ function getTopLevelDeclarations(sourceFile) {
 }
 function getTopLevelDeclaration(sourceFile, statement) {
   const line = getLine(sourceFile, statement);
-  if (ts2.isClassDeclaration(statement) && statement.name) {
+  if (ts.isClassDeclaration(statement) && statement.name) {
     return [{ name: statement.name.text, kind: "class", line, exported: isExported(statement), node: statement }];
   }
-  if (ts2.isFunctionDeclaration(statement) && statement.name) {
+  if (ts.isFunctionDeclaration(statement) && statement.name) {
     return [{ name: statement.name.text, kind: "function", line, exported: isExported(statement), node: statement }];
   }
-  if (ts2.isInterfaceDeclaration(statement)) {
+  if (ts.isInterfaceDeclaration(statement)) {
     return [{ name: statement.name.text, kind: "interface", line, exported: isExported(statement), node: statement }];
   }
-  if (ts2.isTypeAliasDeclaration(statement)) {
+  if (ts.isTypeAliasDeclaration(statement)) {
     return [{ name: statement.name.text, kind: "type", line, exported: isExported(statement), node: statement }];
   }
-  if (ts2.isEnumDeclaration(statement)) {
+  if (ts.isEnumDeclaration(statement)) {
     return [{ name: statement.name.text, kind: "enum", line, exported: isExported(statement), node: statement }];
   }
-  if (ts2.isVariableStatement(statement)) {
-    return statement.declarationList.declarations.filter((declaration) => ts2.isIdentifier(declaration.name)).map((declaration) => ({
+  if (ts.isVariableStatement(statement)) {
+    return statement.declarationList.declarations.filter((declaration) => ts.isIdentifier(declaration.name)).map((declaration) => ({
       name: declaration.name.text,
       kind: "variable",
       line: getLine(sourceFile, declaration),
@@ -1029,7 +636,7 @@ function getTopLevelDeclaration(sourceFile, statement) {
       node: statement
     }));
   }
-  if (ts2.isExportDeclaration(statement)) {
+  if (ts.isExportDeclaration(statement)) {
     return [{ name: "export declaration", kind: "export", line, exported: true, node: statement }];
   }
   return [];
@@ -1054,9 +661,9 @@ function isAllowedConstantDeclaration(modelName, declaration) {
     return false;
   if ([`${modelName}Input`, `${modelName}Object`, modelName, `Light${modelName}`, `${modelName}Insight`].includes(declaration.name))
     return true;
-  if (!ts2.isClassDeclaration(declaration.node))
+  if (!ts.isClassDeclaration(declaration.node))
     return false;
-  const heritageClause = declaration.node.heritageClauses?.find((clause) => clause.token === ts2.SyntaxKind.ExtendsKeyword);
+  const heritageClause = declaration.node.heritageClauses?.find((clause) => clause.token === ts.SyntaxKind.ExtendsKeyword);
   const expression = heritageClause?.types[0]?.expression;
   return !!expression && expression.getText().startsWith("enumOf(");
 }
@@ -1122,13 +729,13 @@ function getModuleInfo(file) {
   return { moduleName, fileName, kind: "database" };
 }
 function isExportedConst(declaration) {
-  return declaration.exported && ts2.isVariableStatement(declaration.node) && (declaration.node.declarationList.flags & ts2.NodeFlags.Const) !== 0;
+  return declaration.exported && ts.isVariableStatement(declaration.node) && (declaration.node.declarationList.flags & ts.NodeFlags.Const) !== 0;
 }
 function isExported(node) {
-  return !!ts2.getCombinedModifierFlags(node) && !!(ts2.getCombinedModifierFlags(node) & ts2.ModifierFlags.Export);
+  return !!ts.getCombinedModifierFlags(node) && !!(ts.getCombinedModifierFlags(node) & ts.ModifierFlags.Export);
 }
 function isFunctionLikeInitializer(node) {
-  return !!node && (ts2.isArrowFunction(node) || ts2.isFunctionExpression(node));
+  return !!node && (ts.isArrowFunction(node) || ts.isFunctionExpression(node));
 }
 function getBodyFingerprint(sourceFile, node) {
   if (!node)
@@ -1150,7 +757,7 @@ async function isDirectory(absolutePath) {
   }
 }
 function getScriptKind(file) {
-  return file.endsWith(".tsx") ? ts2.ScriptKind.TSX : ts2.ScriptKind.TS;
+  return file.endsWith(".tsx") ? ts.ScriptKind.TSX : ts.ScriptKind.TS;
 }
 function getLine(sourceFile, node) {
   return sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile)).line + 1;
@@ -1203,13 +810,6 @@ class QualityScript extends script("quality", [QualityRunner]) {
     spinner.succeed(`Quality scan completed (${result.scannedFiles} files, ${result.warnings.length} warnings)`);
     Logger.rawLog(format === "json" ? JSON.stringify(result, null, 2) : formatQualityScanResult(result));
   }
-  async ssr(workspace, format = "text") {
-    const spinner = workspace.spinning("Measuring Akan server/client render balance...");
-    const scanned = await this.qualityRunner.scan(workspace);
-    const result = { ...scanned, warnings: scanned.warnings.filter((warning) => warning.scope === "ssr") };
-    spinner.succeed(`SSR scan completed (${result.scannedFiles} files, ${result.warnings.length} warnings)`);
-    Logger.rawLog(format === "json" ? JSON.stringify(result, null, 2) : formatSsrScanResult(result));
-  }
 }
 
 // pkgs/@akanjs/cli/quality/quality.command.ts
@@ -1217,18 +817,15 @@ class QualityCommand extends command("quality", [QualityScript], ({ public: targ
   quality: target({ desc: "Scan apps and libs for Akan code quality warnings" }).arg("action", String, {
     desc: "quality action",
     default: "scan",
-    enum: ["scan", "ssr"]
+    enum: ["scan"]
   }).option("format", String, {
     desc: "output format",
     default: "text",
     enum: ["text", "json"]
   }).with(Workspace).exec(async function(action, format, workspace) {
-    if (action === "scan")
-      await this.qualityScript.scan(workspace, format);
-    else if (action === "ssr")
-      await this.qualityScript.ssr(workspace, format);
-    else
-      throw new Error(`Unknown quality action: ${action}. Use "scan" or "ssr".`);
+    if (action !== "scan")
+      throw new Error(`Unknown quality action: ${action}. Use "scan".`);
+    await this.qualityScript.scan(workspace, format);
   })
 })) {
 }