@ultrst-armada/krnl 1.0.1 → 1.0.3

package/packages/validate/dist/index.js

@@ -1,359 +1,384 @@
 // src/KrnlValidatorEngine.ts
-import * as fs from "fs";
-import * as path from "path";
-import { Project, SyntaxKind, Node } from "ts-morph";
-var KrnlValidatorEngine = class {
-  project;
-  projectRoot;
-  maxFileLineLimit;
-  maxMainLogicLimit;
-  maxHelperLineLimit;
-  constructor(optionsOrRoot) {
-    const options = typeof optionsOrRoot === "string" ? { projectRoot: optionsOrRoot } : optionsOrRoot;
-    this.projectRoot = path.resolve(options.projectRoot || process.cwd());
-    this.maxFileLineLimit = options.maxFileLineLimit ?? 200;
-    this.maxMainLogicLimit = options.maxMainLogicLimit ?? 20;
-    this.maxHelperLineLimit = options.maxHelperLineLimit ?? 30;
-    const tsConfigPath = path.join(this.projectRoot, "tsconfig.json");
-    if (fs.existsSync(tsConfigPath)) {
-      this.project = new Project({ tsConfigFilePath: tsConfigPath, skipAddingFilesFromTsConfig: true });
-    } else {
-      this.project = new Project({ compilerOptions: {
-        target: 99
-        /* ESNext */
-      } });
-    }
-  }
-  /**
-   * Scans and validates all source files in the project.
-   */
-  validateAll() {
-    const files = this.collectSourceFiles(this.projectRoot);
-    const errors = [];
-    const warnings = [];
-    this.validateWorkspaceLayout(errors);
-    for (const f of files) {
-      const sf = this.project.addSourceFileAtPath(f);
-      const fileReport = this.validateSourceFile(sf);
-      errors.push(...fileReport.errors);
-      warnings.push(...fileReport.warnings);
-    }
-    return {
-      valid: errors.length === 0,
-      totalFiles: files.length,
-      errors,
-      warnings
-    };
+import * as fs2 from "fs";
+import * as path3 from "path";
+import { Project } from "ts-morph";
+
+// src/rules/fileLimits.ts
+function checkFileLimits(sf, options) {
+  const errors = [];
+  const warnings = [];
+  const filePath = sf.getFilePath();
+  const sourceText = sf.getFullText();
+  const lines = sourceText.split("\n");
+  if (lines.length > options.maxFileLineLimit) {
+    errors.push({
+      ruleId: "krnl/file-line-limit",
+      filePath,
+      message: `File exceeds maximum length of ${options.maxFileLineLimit} lines (currently ${lines.length} lines). Decompose into sub-components, custom hooks, quad-units, or concept libraries.`,
+      severity: "error"
+    });
   }
-  /**
-   * Validates a single SourceFile.
-   */
-  validateSourceFile(sf) {
-    const errors = [];
-    const warnings = [];
-    const filePath = sf.getFilePath();
-    const sourceText = sf.getText();
-    const baseName = path.basename(filePath);
-    if (baseName.includes("_pb.") || baseName.endsWith(".d.ts")) {
-      return { errors, warnings };
-    }
-    const lines = sourceText.split("\n");
-    if (lines.length > this.maxFileLineLimit) {
+  for (const decl of sf.getImportDeclarations()) {
+    const moduleSpec = decl.getModuleSpecifierValue();
+    if (moduleSpec.startsWith(".") && !moduleSpec.endsWith(".js") && !moduleSpec.endsWith(".json") && !moduleSpec.endsWith(".css") && !moduleSpec.endsWith(".svg") && !moduleSpec.endsWith(".png")) {
       errors.push({
-        ruleId: "krnl/file-line-limit",
+        ruleId: "krnl/import-suffix",
         filePath,
-        message: `File exceeds maximum length of ${this.maxFileLineLimit} lines (currently ${lines.length} lines). Decompose into sub-components, custom hooks, quad-units, or concept libraries.`,
+        line: decl.getStartLineNumber(),
+        message: `Relative import '${moduleSpec}' must end with '.js' for NodeNext module resolution.`,
         severity: "error"
       });
     }
-    for (const decl of sf.getImportDeclarations()) {
-      const moduleSpec = decl.getModuleSpecifierValue();
-      if (moduleSpec.startsWith(".") && !moduleSpec.endsWith(".js") && !moduleSpec.endsWith(".json") && !moduleSpec.endsWith(".css") && !moduleSpec.endsWith(".svg") && !moduleSpec.endsWith(".png")) {
-        const line = decl.getStartLineNumber();
+  }
+  const isHelper = filePath.includes("helper_functions") || filePath.includes("/helpers/") || filePath.includes("\\helpers\\");
+  if (isHelper) {
+    for (const fn of sf.getFunctions()) {
+      const fnLines = fn.getText().split("\n").length;
+      if (fnLines > options.maxHelperLineLimit && !sourceText.includes("Concepts.")) {
         errors.push({
-          ruleId: "krnl/import-suffix",
+          ruleId: "krnl/helper-line-limit",
           filePath,
-          line,
-          message: `Relative import '${moduleSpec}' must end with '.js' for NodeNext module resolution.`,
+          line: fn.getStartLineNumber(),
+          message: `Helper function '${fn.getName() || "anonymous"}' exceeds ${options.maxHelperLineLimit} lines (${fnLines} lines). Must delegate to a root libraries/{Domain}Concepts.ts library.`,
           severity: "error"
         });
       }
     }
-    const isUiTopLevel = /^(App|main|index|_app|root)\.(tsx|jsx)$/i.test(baseName);
-    const isBackendTopLevel = /^(server|app)\.(ts|js)$/i.test(baseName) && (!filePath.includes("/components/") && !filePath.includes("/entities/") && !filePath.includes("/libraries/"));
-    if (isUiTopLevel) {
-      const jsxElements = sf.getDescendantsOfKind(SyntaxKind.JsxOpeningElement);
-      const jsxSelfClosing = sf.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement);
-      const allJsxTags = [...jsxElements, ...jsxSelfClosing];
-      for (const jsx of allJsxTags) {
-        const tagName = jsx.getTagNameNode().getText();
-        if (/^[a-z]/.test(tagName)) {
-          errors.push({
-            ruleId: "krnl/top-level-purity",
-            filePath,
-            line: jsx.getStartLineNumber(),
-            message: `Top-level file '${baseName}' violates Top-Level Purity Law. Raw JSX/HTML element '<${tagName}>' is strictly forbidden. Top-level files must ONLY import and compose React components.`,
-            severity: "error"
-          });
-        }
-      }
-      const calls2 = sf.getDescendantsOfKind(SyntaxKind.CallExpression);
-      for (const call of calls2) {
-        const exprText = call.getExpression().getText();
-        if (["useState", "useEffect", "useRef", "useMemo", "useCallback", "useReducer", "useContext", "useLayoutEffect"].includes(exprText) || /^use[A-Z]/.test(exprText) && exprText !== "use") {
-          errors.push({
-            ruleId: "krnl/top-level-purity",
-            filePath,
-            line: call.getStartLineNumber(),
-            message: `Top-level file '${baseName}' violates Top-Level Purity Law. React hook '${exprText}' is forbidden in top-level files. Encapsulate state and effects inside dedicated component files.`,
-            severity: "error"
-          });
-        }
-      }
+  }
+  const isMainLogic = filePath.endsWith("logic.ts") || filePath.endsWith("logic.js");
+  if (isMainLogic) {
+    const substantiveLines = lines.filter((l) => {
+      const trimmed = l.trim();
+      return trimmed.length > 0 && !trimmed.startsWith("//") && !trimmed.startsWith("/*") && !trimmed.startsWith("*");
+    });
+    if (substantiveLines.length > options.maxMainLogicLimit && !sourceText.includes("helpers") && !sourceText.includes("Concepts") && !sourceText.includes("state")) {
+      errors.push({
+        ruleId: "krnl/main-delegation",
+        filePath,
+        message: `Main logic function has ${substantiveLines.length} substantive lines without delegating to Layer 1 helper functions or Layer 0 libraries.`,
+        severity: "error"
+      });
     }
-    if (isBackendTopLevel) {
-      const calls2 = sf.getDescendantsOfKind(SyntaxKind.CallExpression);
-      for (const call of calls2) {
-        const exprText = call.getExpression().getText();
-        if (/^(app|router|server)\.(get|post|put|delete|patch|options|head)$/.test(exprText)) {
-          errors.push({
-            ruleId: "krnl/top-level-purity",
-            filePath,
-            line: call.getStartLineNumber(),
-            message: `Backend entry file '${baseName}' violates Entry Purity Law. Inline route definition '${exprText}' is forbidden. Delegate to dedicated route/controller modules.`,
-            severity: "error"
-          });
-        }
+  }
+  return { errors, warnings };
+}
+
+// src/rules/componentRules.ts
+import * as path from "path";
+import { SyntaxKind } from "ts-morph";
+function checkComponentRules(sf) {
+  const errors = [];
+  const warnings = [];
+  const filePath = sf.getFilePath();
+  const baseName = path.basename(filePath);
+  if (filePath.endsWith(".tsx") || filePath.endsWith(".jsx")) {
+    const componentNames = [];
+    for (const fn of sf.getFunctions()) {
+      const name = fn.getName();
+      if (name && /^[A-Z]/.test(name)) {
+        const hasJsx = fn.getDescendantsOfKind(SyntaxKind.JsxElement).length > 0 || fn.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement).length > 0 || fn.getDescendantsOfKind(SyntaxKind.JsxFragment).length > 0;
+        if (hasJsx) componentNames.push(name);
       }
     }
-    if (filePath.endsWith(".tsx") || filePath.endsWith(".jsx")) {
-      const componentNames = [];
-      for (const fn of sf.getFunctions()) {
-        const name = fn.getName();
-        if (name && /^[A-Z]/.test(name)) {
-          const hasJsx = fn.getDescendantsOfKind(SyntaxKind.JsxElement).length > 0 || fn.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement).length > 0 || fn.getDescendantsOfKind(SyntaxKind.JsxFragment).length > 0;
-          if (hasJsx) {
-            componentNames.push(name);
-          }
-        }
-      }
-      for (const stmt of sf.getVariableStatements()) {
-        for (const decl of stmt.getDeclarations()) {
-          const name = decl.getName();
-          if (/^[A-Z]/.test(name)) {
-            const typeText = decl.getTypeNode()?.getText() || "";
-            const isFcType = typeText.includes("FC") || typeText.includes("FunctionComponent") || typeText.includes("ComponentType");
-            const init = decl.getInitializer();
-            if (init) {
-              const hasJsx = init.getDescendantsOfKind(SyntaxKind.JsxElement).length > 0 || init.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement).length > 0 || init.getDescendantsOfKind(SyntaxKind.JsxFragment).length > 0;
-              if (isFcType || hasJsx) {
-                if (!componentNames.includes(name)) {
-                  componentNames.push(name);
-                }
-              }
+    for (const stmt of sf.getVariableStatements()) {
+      for (const decl of stmt.getDeclarations()) {
+        const name = decl.getName();
+        if (/^[A-Z]/.test(name)) {
+          const typeText = decl.getTypeNode()?.getText() || "";
+          const isFcType = typeText.includes("FC") || typeText.includes("FunctionComponent") || typeText.includes("ComponentType");
+          const init = decl.getInitializer();
+          if (init) {
+            const hasJsx = init.getDescendantsOfKind(SyntaxKind.JsxElement).length > 0 || init.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement).length > 0 || init.getDescendantsOfKind(SyntaxKind.JsxFragment).length > 0;
+            if (isFcType || hasJsx) {
+              if (!componentNames.includes(name)) componentNames.push(name);
             }
           }
         }
       }
-      for (const cls of sf.getClasses()) {
-        const name = cls.getName();
-        const ext = cls.getExtends()?.getText() || "";
-        if (name && (ext.includes("Component") || ext.includes("PureComponent"))) {
-          if (!componentNames.includes(name)) {
-            componentNames.push(name);
-          }
-        }
+    }
+    for (const cls of sf.getClasses()) {
+      const name = cls.getName();
+      const ext = cls.getExtends()?.getText() || "";
+      if (name && (ext.includes("Component") || ext.includes("PureComponent"))) {
+        if (!componentNames.includes(name)) componentNames.push(name);
       }
-      if (componentNames.length > 1) {
+    }
+    if (componentNames.length > 1) {
+      errors.push({
+        ruleId: "krnl/one-component-per-file",
+        filePath,
+        message: `File '${baseName}' defines multiple React components (${componentNames.join(
+          ", "
+        )}). Krnl strictly enforces ONE component per file. Decompose into sub-component files.`,
+        severity: "error"
+      });
+    }
+  }
+  const isHelper = filePath.includes("helper_functions") || filePath.includes("/helpers/") || filePath.includes("\\helpers\\");
+  if (isHelper) {
+    for (const decl of sf.getImportDeclarations()) {
+      const spec = decl.getModuleSpecifierValue();
+      if (["fs", "node:fs", "http", "node:http", "ws"].includes(spec)) {
         errors.push({
-          ruleId: "krnl/one-component-per-file",
+          ruleId: "krnl/helper-purity",
           filePath,
-          message: `File '${baseName}' defines multiple React components (${componentNames.join(", ")}). Krnl strictly enforces ONE component per file. Decompose into sub-component files.`,
+          line: decl.getStartLineNumber(),
+          message: `Helper functions (Layer 1) cannot directly import I/O modules ('${spec}'). Delegate to Layer 0 libraries or ServiceFacade context.`,
           severity: "error"
         });
       }
     }
-    const isHelper = filePath.includes("helper_functions") || filePath.includes("/helpers/") || filePath.includes("\\helpers\\");
-    const isMainLogic = filePath.endsWith("logic.ts") || filePath.endsWith("logic.js");
-    const isRootConcept = filePath.includes("libraries/") || filePath.includes("Concepts.ts");
-    if (isHelper) {
-      for (const decl of sf.getImportDeclarations()) {
-        const spec = decl.getModuleSpecifierValue();
-        if (["fs", "node:fs", "http", "node:http", "ws"].includes(spec)) {
-          errors.push({
-            ruleId: "krnl/helper-purity",
-            filePath,
-            line: decl.getStartLineNumber(),
-            message: `Helper functions (Layer 1) cannot directly import I/O modules ('${spec}'). Delegate to Layer 0 libraries or Entity context.`,
-            severity: "error"
-          });
-        }
-      }
-      for (const fn of sf.getFunctions()) {
-        const fnLines = fn.getText().split("\n").length;
-        if (fnLines > this.maxHelperLineLimit && !sourceText.includes("Concepts.")) {
-          errors.push({
-            ruleId: "krnl/helper-line-limit",
-            filePath,
-            line: fn.getStartLineNumber(),
-            message: `Helper function '${fn.getName() || "anonymous"}' exceeds ${this.maxHelperLineLimit} lines (${fnLines} lines). Must delegate to a root libraries/{Domain}Concepts.ts library.`,
-            severity: "error"
-          });
-        }
-      }
-    }
-    if (isMainLogic) {
-      const substantiveLines = lines.filter((l) => {
-        const trimmed = l.trim();
-        return trimmed.length > 0 && !trimmed.startsWith("//") && !trimmed.startsWith("/*") && !trimmed.startsWith("*");
+  }
+  return { errors, warnings };
+}
+
+// src/rules/orchestrationRules.ts
+import { SyntaxKind as SyntaxKind2, Node } from "ts-morph";
+function checkOrchestrationRules(sf) {
+  const errors = [];
+  const warnings = [];
+  const filePath = sf.getFilePath();
+  const sourceText = sf.getText();
+  const calls = sf.getDescendantsOfKind(SyntaxKind2.CallExpression);
+  for (const call of calls) {
+    const exprText = call.getExpression().getText();
+    if (exprText === "setInterval" || exprText === "window.setInterval") {
+      errors.push({
+        ruleId: "krnl/no-polling",
+        filePath,
+        line: call.getStartLineNumber(),
+        message: `Prohibited use of 'setInterval'. Krnl applications must use reactive event streams or triggers.`,
+        severity: "error"
       });
-      if (substantiveLines.length > this.maxMainLogicLimit && !sourceText.includes("helpers") && !sourceText.includes("Concepts") && !sourceText.includes("state")) {
+    }
+  }
+  if (sourceText.includes("main = async") || sourceText.includes("export const main = async")) {
+    const match = sourceText.match(/main\s*=\s*async\s*\([^,]+,\s*\{([^}]*)\}\s*\)/);
+    if (match) {
+      const destructured = match[1];
+      if (/\bsystem\b/.test(destructured)) {
         errors.push({
-          ruleId: "krnl/main-delegation",
+          ruleId: "krnl/context-destructuring",
           filePath,
-          message: `Main logic function has ${substantiveLines.length} substantive lines without delegating to Layer 1 helper functions or Layer 0 libraries.`,
+          message: `Functionality context parameter destructures 'system'. Functionality passes { state, orchestration } or service context.`,
           severity: "error"
         });
       }
     }
-    if (sourceText.includes("main = async") || sourceText.includes("export const main = async")) {
-      const match = sourceText.match(/main\s*=\s*async\s*\([^,]+,\s*\{([^}]*)\}\s*\)/);
-      if (match) {
-        const destructured = match[1];
-        if (/\bsystem\b/.test(destructured) && !/\bentity\b/.test(destructured)) {
-          errors.push({
-            ruleId: "krnl/context-destructuring",
-            filePath,
-            message: `Functionality context parameter destructures 'system'. Functionality passes { state, entity }. Always destructure 'entity'.`,
-            severity: "error"
-          });
-        }
-      }
-    }
-    const calls = sf.getDescendantsOfKind(SyntaxKind.CallExpression);
-    for (const call of calls) {
-      const exprText = call.getExpression().getText();
-      if (exprText === "setInterval" || exprText === "window.setInterval") {
+  }
+  const isOrchestrationClass = sf.getClasses().some((c) => {
+    const ext = c.getExtends();
+    return ext && (ext.getText().includes("FunctionalityOrchestration") || ext.getText().includes("Orchestration") || ext.getText().includes("krnlOrchestrationBase"));
+  });
+  if (isOrchestrationClass) {
+    for (const decl of sf.getImportDeclarations()) {
+      const spec = decl.getModuleSpecifierValue();
+      if (spec.includes("libraries/") || spec.includes("Concepts")) {
         errors.push({
-          ruleId: "krnl/no-polling",
+          ruleId: "krnl/orchestration-no-libraries",
           filePath,
-          line: call.getStartLineNumber(),
-          message: `Prohibited use of 'setInterval'. Krnl applications must use reactive event streams (entity.emitEvent / entity.on).`,
+          line: decl.getStartLineNumber(),
+          message: `FunctionalityOrchestration class violates Library Calling Invariant. FunctionalityOrchestrations must not call or import libraries directly ('${spec}'). Only functionalities are permitted to call shared libraries.`,
           severity: "error"
         });
       }
     }
-    const isEntityClass = sf.getClasses().some((c) => {
-      const ext = c.getExtends();
-      return ext && (ext.getText().includes("Entity") || ext.getText().includes("krnlEntityBase"));
-    });
-    if (isEntityClass) {
-      for (const decl of sf.getImportDeclarations()) {
-        const spec = decl.getModuleSpecifierValue();
-        if (spec.includes("libraries/") || spec.includes("Concepts")) {
+    for (const cls of sf.getClasses()) {
+      const ext = cls.getExtends();
+      if (ext && (ext.getText().includes("FunctionalityOrchestration") || ext.getText().includes("Orchestration") || ext.getText().includes("krnlOrchestrationBase"))) {
+        const loops = [
+          ...cls.getDescendantsOfKind(SyntaxKind2.ForStatement),
+          ...cls.getDescendantsOfKind(SyntaxKind2.ForOfStatement),
+          ...cls.getDescendantsOfKind(SyntaxKind2.ForInStatement),
+          ...cls.getDescendantsOfKind(SyntaxKind2.WhileStatement),
+          ...cls.getDescendantsOfKind(SyntaxKind2.DoStatement)
+        ];
+        for (const loop of loops) {
           errors.push({
-            ruleId: "krnl/entity-no-libraries",
+            ruleId: "krnl/orchestration-purity",
             filePath,
-            line: decl.getStartLineNumber(),
-            message: `Entity class violates Library Calling Invariant. Entities must not call or import libraries directly ('${spec}'). Only functionalities in 'src/functionalities/' are permitted to call shared libraries.`,
+            line: loop.getStartLineNumber(),
+            message: `FunctionalityOrchestration '${cls.getName() || "Anonymous"}' violates Orchestration Purity Law. Loops and procedural algorithms are prohibited inside orchestrations. Move logic to a functionality or a global library function.`,
             severity: "error"
           });
         }
-      }
-      let loadAllLine = -1;
-      const addLocalLines = [];
-      for (const call of calls) {
-        const txt = call.getText();
-        if (txt.includes("MagneticLoader.loadAll") || txt.includes("KrnlMagneticLoader.loadAll")) {
-          loadAllLine = call.getStartLineNumber();
-        } else if (txt.startsWith("this.addLocal(")) {
-          const hasUiSpec = txt.includes("uiSpec");
-          const idMatch = txt.match(/id\s*:\s*["']([^"']+)["']/);
-          addLocalLines.push({
-            line: call.getStartLineNumber(),
-            hasUiSpec,
-            id: idMatch ? idMatch[1] : "unknown"
-          });
-        }
-      }
-      if (loadAllLine !== -1) {
-        for (const al of addLocalLines) {
-          if (al.hasUiSpec && al.line > loadAllLine) {
+        const allowedMethods = /* @__PURE__ */ new Set([
+          "flow",
+          "getFlow",
+          "listFlows",
+          "clearFlows",
+          "thenFunctionality",
+          "parallel",
+          "branch",
+          "fanOut",
+          "thenFunctionalityOrchestration",
+          "getSteps",
+          "assertServiceBoundary"
+        ]);
+        for (const method of cls.getMethods()) {
+          const methodName = method.getName();
+          if (!allowedMethods.has(methodName)) {
             errors.push({
-              ruleId: "krnl/boot-order",
+              ruleId: "krnl/orchestration-purity",
               filePath,
-              line: al.line,
-              message: `addLocal('${al.id}') with uiSpec at line ${al.line} appears AFTER loadAll() at line ${loadAllLine}. All addLocal() with UI must precede loadAll().`,
+              line: method.getStartLineNumber(),
+              message: `FunctionalityOrchestration '${cls.getName() || "Anonymous"}' defines custom method '${methodName}'. FunctionalityOrchestrations are purely declarative compositors. Define capabilities as functionalities or global library functions.`,
               severity: "error"
             });
           }
         }
       }
-      for (const cls of sf.getClasses()) {
-        const ext = cls.getExtends();
-        if (ext && (ext.getText().includes("Entity") || ext.getText().includes("krnlEntityBase"))) {
-          const loops = [
-            ...cls.getDescendantsOfKind(SyntaxKind.ForStatement),
-            ...cls.getDescendantsOfKind(SyntaxKind.ForOfStatement),
-            ...cls.getDescendantsOfKind(SyntaxKind.ForInStatement),
-            ...cls.getDescendantsOfKind(SyntaxKind.WhileStatement),
-            ...cls.getDescendantsOfKind(SyntaxKind.DoStatement)
-          ];
-          for (const loop of loops) {
+    }
+    for (const call of calls) {
+      const callText = call.getText();
+      if (callText.startsWith("this.flow(") || callText.startsWith("orchestration.flow(")) {
+        let currentExpr = call;
+        const chainCalls = [];
+        while (currentExpr && Node.isCallExpression(currentExpr)) {
+          const propAccess = currentExpr.getExpression();
+          if (Node.isPropertyAccessExpression(propAccess)) {
+            const methodName = propAccess.getName();
+            const args = currentExpr.getArguments();
+            const argText = args.length > 0 ? args[0].getText() : void 0;
+            chainCalls.unshift({ name: methodName, node: currentExpr, argText });
+            currentExpr = propAccess.getExpression();
+          } else {
+            break;
+          }
+        }
+        let chainId = "orchestration";
+        for (const step of chainCalls) {
+          if (step.name === "flow") {
+            chainId = step.argText ? step.argText.replace(/['"]/g, "") : "orchestration";
+          } else if (step.name === "thenFunction") {
             errors.push({
-              ruleId: "krnl/entity-purity",
+              ruleId: "krnl/orchestration-no-direct-library-calls",
               filePath,
-              line: loop.getStartLineNumber(),
-              message: `Entity '${cls.getName() || "Anonymous"}' violates Entity Purity Law. Loops and procedural algorithms are prohibited inside entities. Move logic to a functionality or a global library function.`,
+              line: step.node.getStartLineNumber(),
+              message: `FunctionalityOrchestration flow '${chainId}' violates Orchestration Purity Law. Orchestrations cannot chain direct library functions via thenFunction(). Orchestrations must only sequence functionalities (thenFunctionality) and peer functionality orchestrations (thenFunctionalityOrchestration).`,
+              severity: "error"
+            });
+          } else if (step.name === "thenService") {
+            errors.push({
+              ruleId: "krnl/orchestration-no-external-services",
+              filePath,
+              line: step.node.getStartLineNumber(),
+              message: `FunctionalityOrchestration flow '${chainId}' violates Plane Isolation Law L1. A service-level FunctionalityOrchestration cannot compose external services. Use Skipo ServiceOrchestration at the application layer instead.`,
               severity: "error"
             });
           }
-          for (const method of cls.getMethods()) {
-            const methodName = method.getName();
-            if (!["boot", "init", "dispose"].includes(methodName)) {
+        }
+      }
+    }
+  }
+  return { errors, warnings };
+}
+
+// src/rules/workspaceRules.ts
+import * as fs from "fs";
+import * as path2 from "path";
+import { SyntaxKind as SyntaxKind3 } from "ts-morph";
+function checkTopLevelPurity(sf) {
+  const errors = [];
+  const warnings = [];
+  const filePath = sf.getFilePath();
+  const baseName = path2.basename(filePath);
+  const isUiTopLevel = /^(App|main|index|_app|root)\.(tsx|jsx)$/i.test(baseName);
+  const isBackendTopLevel = /^(server|app|index)\.(ts|js)$/i.test(baseName) && !filePath.includes("/components/") && !filePath.includes("/orchestrations/") && !filePath.includes("/services/") && !filePath.includes("/libraries/");
+  if (isUiTopLevel) {
+    const jsxElements = sf.getDescendantsOfKind(SyntaxKind3.JsxOpeningElement);
+    const jsxSelfClosing = sf.getDescendantsOfKind(SyntaxKind3.JsxSelfClosingElement);
+    const allJsxTags = [...jsxElements, ...jsxSelfClosing];
+    for (const jsx of allJsxTags) {
+      const tagName = jsx.getTagNameNode().getText();
+      if (/^[a-z]/.test(tagName)) {
+        errors.push({
+          ruleId: "krnl/top-level-purity",
+          filePath,
+          line: jsx.getStartLineNumber(),
+          message: `Top-level file '${baseName}' violates Top-Level Purity Law. Raw JSX/HTML element '<${tagName}>' is strictly forbidden. Top-level files must ONLY import and compose React components.`,
+          severity: "error"
+        });
+      }
+    }
+    const calls = sf.getDescendantsOfKind(SyntaxKind3.CallExpression);
+    for (const call of calls) {
+      const exprText = call.getExpression().getText();
+      if ([
+        "useState",
+        "useEffect",
+        "useRef",
+        "useMemo",
+        "useCallback",
+        "useReducer",
+        "useContext",
+        "useLayoutEffect"
+      ].includes(exprText) || /^use[A-Z]/.test(exprText) && exprText !== "use") {
+        errors.push({
+          ruleId: "krnl/top-level-purity",
+          filePath,
+          line: call.getStartLineNumber(),
+          message: `Top-level file '${baseName}' violates Top-Level Purity Law. React hook '${exprText}' is forbidden in top-level files. Encapsulate state and effects inside dedicated component files.`,
+          severity: "error"
+        });
+      }
+    }
+  }
+  if (isBackendTopLevel) {
+    const calls = sf.getDescendantsOfKind(SyntaxKind3.CallExpression);
+    for (const call of calls) {
+      const exprText = call.getExpression().getText();
+      if (/^(app|router|server)\.(get|post|put|delete|patch|options|head)$/.test(exprText)) {
+        errors.push({
+          ruleId: "krnl/top-level-purity",
+          filePath,
+          line: call.getStartLineNumber(),
+          message: `Backend entry file '${baseName}' violates Entry Purity Law. Inline route definition '${exprText}' is forbidden. Delegate to dedicated route/controller modules.`,
+          severity: "error"
+        });
+      }
+    }
+  }
+  return { errors, warnings };
+}
+function checkWorkspaceLayout(projectRoot, errors) {
+  const krnlDir = path2.join(projectRoot, "krnl");
+  const srcDir = path2.join(projectRoot, "src");
+  const targetDir = fs.existsSync(krnlDir) ? krnlDir : fs.existsSync(srcDir) ? srcDir : null;
+  if (!targetDir) return;
+  const backendDir = path2.join(targetDir, "backend");
+  const frontendDir = path2.join(targetDir, "frontend");
+  if (fs.existsSync(backendDir)) {
+    const bServices = path2.join(backendDir, "services");
+    if (fs.existsSync(bServices)) {
+      for (const sEntry of fs.readdirSync(bServices, { withFileTypes: true })) {
+        if (!sEntry.isDirectory()) continue;
+        const sDir = path2.join(bServices, sEntry.name);
+        const sLibs = path2.join(sDir, "libraries");
+        if (fs.existsSync(sLibs)) {
+          for (const entry of fs.readdirSync(sLibs, { withFileTypes: true })) {
+            if (!entry.isDirectory()) continue;
+            const libPath = path2.join(sLibs, entry.name);
+            if (!fs.existsSync(path2.join(libPath, "manifest.json"))) {
               errors.push({
-                ruleId: "krnl/entity-purity",
-                filePath,
-                line: method.getStartLineNumber(),
-                message: `Entity '${cls.getName() || "Anonymous"}' defines custom method '${methodName}'. Entities are purely declarative compositors/orchestrators. Define capabilities as functionalities or global library functions.`,
+                ruleId: "krnl/concept-manifest-required",
+                filePath: libPath,
+                message: `Service-owned concept library "${sEntry.name}/${entry.name}" is missing a manifest.json file.`,
                 severity: "error"
               });
             }
           }
         }
-      }
-      for (const call of calls) {
-        const callText = call.getText();
-        if (callText.startsWith("this.orchestration(") || callText.startsWith("this.flow(")) {
-          let currentExpr = call;
-          const chainCalls = [];
-          while (currentExpr && Node.isCallExpression(currentExpr)) {
-            const propAccess = currentExpr.getExpression();
-            if (Node.isPropertyAccessExpression(propAccess)) {
-              const methodName = propAccess.getName();
-              const args = currentExpr.getArguments();
-              const argText = args.length > 0 ? args[0].getText() : void 0;
-              chainCalls.unshift({ name: methodName, node: currentExpr, argText });
-              currentExpr = propAccess.getExpression();
-            } else {
-              break;
-            }
-          }
-          let consecutiveFunctions = 0;
-          let chainId = "orchestration";
-          for (const step of chainCalls) {
-            if (step.name === "orchestration" || step.name === "flow") {
-              chainId = step.argText ? step.argText.replace(/['"]/g, "") : "orchestration";
-            } else if (step.name === "thenFunctionality" || step.name === "then") {
-              consecutiveFunctions = 0;
-            } else if (step.name === "thenEntityOrchestration" || step.name === "thenEntity") {
-              consecutiveFunctions = 0;
-            } else if (step.name === "thenFunction") {
+        const sFuncs = path2.join(sDir, "functionalities");
+        if (fs.existsSync(sFuncs)) {
+          for (const entry of fs.readdirSync(sFuncs, { withFileTypes: true })) {
+            if (!entry.isDirectory()) continue;
+            const funcPath = path2.join(sFuncs, entry.name);
+            if (!fs.existsSync(path2.join(funcPath, "manifest.json"))) {
               errors.push({
-                ruleId: "krnl/entity-no-direct-library-calls",
-                filePath,
-                line: step.node.getStartLineNumber(),
-                message: `Orchestration chain '${chainId}' violates Entity Purity Law. Entities cannot chain direct library functions via thenFunction(). Entities must only orchestrate functionalities (thenFunctionality) and orchestrations from other entities (thenEntityOrchestration).`,
+                ruleId: "krnl/functionality-manifest-required",
+                filePath: funcPath,
+                message: `Service-owned functionality "${sEntry.name}/${entry.name}" is missing a manifest.json file.`,
                 severity: "error"
               });
             }
@@ -361,93 +386,399 @@ var KrnlValidatorEngine = class {
         }
       }
     }
-    return { errors, warnings };
-  }
-  /**
-   * Validates workspace layout invariants for symmetric Krnl architecture.
-   */
-  validateWorkspaceLayout(errors) {
-    const krnlDir = path.join(this.projectRoot, "krnl");
-    const srcDir = path.join(this.projectRoot, "src");
-    const targetDir = fs.existsSync(krnlDir) ? krnlDir : fs.existsSync(srcDir) ? srcDir : null;
-    if (!targetDir) return;
-    const backendDir = path.join(targetDir, "backend");
-    const frontendDir = path.join(targetDir, "frontend");
-    if (fs.existsSync(backendDir)) {
-      const bLibs = path.join(backendDir, "libraries");
-      if (fs.existsSync(bLibs)) {
-        for (const entry of fs.readdirSync(bLibs, { withFileTypes: true })) {
-          if (!entry.isDirectory()) continue;
-          const libPath = path.join(bLibs, entry.name);
-          const manifestPath = path.join(libPath, "manifest.json");
-          if (!fs.existsSync(manifestPath)) {
-            errors.push({
-              ruleId: "krnl/concept-manifest-required",
-              filePath: libPath,
-              message: `Backend concept library "${entry.name}" is missing a manifest.json file.`,
-              severity: "error"
-            });
-          }
+    const bLibs = path2.join(backendDir, "libraries");
+    if (fs.existsSync(bLibs)) {
+      for (const entry of fs.readdirSync(bLibs, { withFileTypes: true })) {
+        if (!entry.isDirectory()) continue;
+        const libPath = path2.join(bLibs, entry.name);
+        if (!fs.existsSync(path2.join(libPath, "manifest.json"))) {
+          errors.push({
+            ruleId: "krnl/concept-manifest-required",
+            filePath: libPath,
+            message: `Backend concept library "${entry.name}" is missing a manifest.json file.`,
+            severity: "error"
+          });
         }
       }
-      const bFuncs = path.join(backendDir, "functionalities");
-      if (fs.existsSync(bFuncs)) {
-        for (const entry of fs.readdirSync(bFuncs, { withFileTypes: true })) {
-          if (!entry.isDirectory()) continue;
-          const funcPath = path.join(bFuncs, entry.name);
-          const manifestPath = path.join(funcPath, "manifest.json");
-          if (!fs.existsSync(manifestPath)) {
-            errors.push({
-              ruleId: "krnl/functionality-manifest-required",
-              filePath: funcPath,
-              message: `Backend functionality "${entry.name}" is missing a manifest.json file.`,
-              severity: "error"
-            });
-          }
+    }
+    const bFuncs = path2.join(backendDir, "functionalities");
+    if (fs.existsSync(bFuncs)) {
+      for (const entry of fs.readdirSync(bFuncs, { withFileTypes: true })) {
+        if (!entry.isDirectory()) continue;
+        const funcPath = path2.join(bFuncs, entry.name);
+        if (!fs.existsSync(path2.join(funcPath, "manifest.json"))) {
+          errors.push({
+            ruleId: "krnl/functionality-manifest-required",
+            filePath: funcPath,
+            message: `Backend functionality "${entry.name}" is missing a manifest.json file.`,
+            severity: "error"
+          });
         }
       }
     }
-    if (fs.existsSync(frontendDir)) {
-      const fLibs = path.join(frontendDir, "libraries");
-      if (fs.existsSync(fLibs)) {
-        for (const entry of fs.readdirSync(fLibs, { withFileTypes: true })) {
-          if (!entry.isDirectory()) continue;
-          const libPath = path.join(fLibs, entry.name);
-          const manifestPath = path.join(libPath, "manifest.json");
-          if (!fs.existsSync(manifestPath)) {
-            errors.push({
-              ruleId: "krnl/frontend-concept-manifest-required",
-              filePath: libPath,
-              message: `Frontend concept library "${entry.name}" is missing a manifest.json file.`,
-              severity: "error"
-            });
-          }
+  }
+  if (fs.existsSync(frontendDir)) {
+    const fLibs = path2.join(frontendDir, "libraries");
+    if (fs.existsSync(fLibs)) {
+      for (const entry of fs.readdirSync(fLibs, { withFileTypes: true })) {
+        if (!entry.isDirectory()) continue;
+        const libPath = path2.join(fLibs, entry.name);
+        if (!fs.existsSync(path2.join(libPath, "manifest.json"))) {
+          errors.push({
+            ruleId: "krnl/frontend-concept-manifest-required",
+            filePath: libPath,
+            message: `Frontend concept library "${entry.name}" is missing a manifest.json file.`,
+            severity: "error"
+          });
+        }
+      }
+    }
+    const fFuncs = path2.join(frontendDir, "functionalities");
+    if (fs.existsSync(fFuncs)) {
+      for (const entry of fs.readdirSync(fFuncs, { withFileTypes: true })) {
+        if (!entry.isDirectory()) continue;
+        const funcPath = path2.join(fFuncs, entry.name);
+        if (!fs.existsSync(path2.join(funcPath, "manifest.json"))) {
+          errors.push({
+            ruleId: "krnl/frontend-functionality-manifest-required",
+            filePath: funcPath,
+            message: `Frontend functionality "${entry.name}" is missing a manifest.json file.`,
+            severity: "error"
+          });
         }
       }
-      const fFuncs = path.join(frontendDir, "functionalities");
-      if (fs.existsSync(fFuncs)) {
-        for (const entry of fs.readdirSync(fFuncs, { withFileTypes: true })) {
-          if (!entry.isDirectory()) continue;
-          const funcPath = path.join(fFuncs, entry.name);
-          const manifestPath = path.join(funcPath, "manifest.json");
-          if (!fs.existsSync(manifestPath)) {
+    }
+  }
+}
+
+// src/rules/serviceBoundaryRules.ts
+function checkServiceBoundaries(sf) {
+  const errors = [];
+  const warnings = [];
+  const filePath = sf.getFilePath().replace(/\\/g, "/");
+  const serviceMatch = filePath.match(/\/services\/([^/]+)\//);
+  if (!serviceMatch) {
+    return { errors, warnings };
+  }
+  const currentService = serviceMatch[1];
+  const imports = sf.getImportDeclarations();
+  for (const imp of imports) {
+    const spec = imp.getModuleSpecifierValue();
+    const crossServiceLibMatch = spec.match(/(?:^|\/|\.\.\/)services\/([^/]+)\/libraries\//) || spec.match(/\.\.\/(?:(?:\.\.\/)+)?([^/]+)\/libraries\//);
+    if (crossServiceLibMatch) {
+      const targetService = crossServiceLibMatch[1];
+      if (targetService !== currentService && targetService !== "." && targetService !== "..") {
+        errors.push({
+          ruleId: "krnl/no-cross-service-library-imports",
+          filePath,
+          line: imp.getStartLineNumber(),
+          message: `Cross-service library import forbidden: '${spec}'. Service '${currentService}' cannot import '${targetService}' libraries directly via filesystem. Access libraries through the '${targetService}' ServiceFacade (e.g. ${targetService}Facade.libraries).`,
+          severity: "error"
+        });
+      }
+    }
+  }
+  return { errors, warnings };
+}
+
+// src/rules/scopedLibraryRules.ts
+import { SyntaxKind as SyntaxKind4 } from "ts-morph";
+var PRIMITIVE_AND_BUILTIN_TYPES = /* @__PURE__ */ new Set([
+  "string",
+  "number",
+  "boolean",
+  "symbol",
+  "bigint",
+  "void",
+  "undefined",
+  "null",
+  "never",
+  "unknown",
+  "any",
+  "object",
+  "Record",
+  "Array",
+  "ReadonlyArray",
+  "Map",
+  "Set",
+  "WeakMap",
+  "WeakSet",
+  "Promise",
+  "Date",
+  "RegExp",
+  "Error",
+  "Uint8Array",
+  "Int8Array",
+  "Uint16Array",
+  "Int16Array",
+  "Uint32Array",
+  "Int32Array",
+  "Float32Array",
+  "Float64Array",
+  "ArrayBuffer",
+  "Buffer",
+  "Iterable",
+  "AsyncIterable",
+  "Iterator",
+  "AsyncIterator",
+  "Partial",
+  "Required",
+  "Readonly",
+  "Pick",
+  "Omit",
+  "Exclude",
+  "Extract",
+  "NonNullable",
+  "Parameters",
+  "ConstructorParameters",
+  "ReturnType",
+  "InstanceType"
+]);
+function detectServiceContext(filePath) {
+  const normalized = filePath.replace(/\\/g, "/");
+  const match = normalized.match(/(?:^|\/)services\/([^/]+)\/libraries\/([^/]+)/);
+  if (match) {
+    return { serviceName: match[1], libraryName: match[2] };
+  }
+  return null;
+}
+function containsIdentifier(name, target) {
+  return name.toLowerCase().includes(target.toLowerCase());
+}
+function isCustomContextualType(typeName, serviceName, localTypes) {
+  if (PRIMITIVE_AND_BUILTIN_TYPES.has(typeName)) return false;
+  if (localTypes.has(typeName)) return true;
+  if (containsIdentifier(typeName, serviceName)) return true;
+  if (/^[A-Z][a-zA-Z0-9]+$/.test(typeName)) return true;
+  return false;
+}
+function hasContextualTypeReference(node, serviceName, localTypes) {
+  const typeRefs = node.getDescendantsOfKind(SyntaxKind4.TypeReference);
+  for (const ref of typeRefs) {
+    const text = ref.getTypeName().getText().trim();
+    if (isCustomContextualType(text, serviceName, localTypes)) {
+      return true;
+    }
+  }
+  return false;
+}
+function checkScopedLibraryRules(sf) {
+  const errors = [];
+  const warnings = [];
+  const promotableAssets = [];
+  const filePath = sf.getFilePath().replace(/\\/g, "/");
+  const context = detectServiceContext(filePath);
+  if (!context) {
+    return { errors, warnings, promotableAssets };
+  }
+  const { serviceName, libraryName } = context;
+  const localTypes = /* @__PURE__ */ new Set();
+  sf.getInterfaces().forEach((i) => localTypes.add(i.getName()));
+  sf.getTypeAliases().forEach((t) => localTypes.add(t.getName()));
+  sf.getClasses().forEach((c) => {
+    const n = c.getName();
+    if (n) localTypes.add(n);
+  });
+  sf.getEnums().forEach((e) => localTypes.add(e.getName()));
+  const functions = sf.getFunctions();
+  for (const fn of functions) {
+    const fnName = fn.getName();
+    if (!fnName) continue;
+    const isContextual = hasContextualTypeReference(fn, serviceName, localTypes);
+    const hasServiceName = containsIdentifier(fnName, serviceName);
+    if (isContextual) {
+      if (!hasServiceName) {
+        errors.push({
+          ruleId: "krnl/service-library-asset-naming",
+          filePath,
+          line: fn.getStartLineNumber(),
+          message: `Service library asset '${fnName}' in service '${serviceName}' violates scoped library naming convention. Custom library asset identifiers must contain the owning service name ('${serviceName}'). Expected name containing '${serviceName}' (e.g. '${serviceName.toLowerCase()}${fnName[0].toUpperCase()}${fnName.slice(1)}'), or eliminate contextual custom type dependencies to make it a generic promotable utility.`,
+          severity: "error"
+        });
+      }
+    } else {
+      promotableAssets.push({
+        name: fnName,
+        kind: "function",
+        filePath,
+        scope: "service",
+        scopeName: serviceName,
+        target: "GutTS"
+      });
+    }
+  }
+  for (const stmt of sf.getVariableStatements()) {
+    for (const decl of stmt.getDeclarations()) {
+      const varName = decl.getName();
+      const init = decl.getInitializer();
+      const isFunction = init && (init.getKind() === SyntaxKind4.ArrowFunction || init.getKind() === SyntaxKind4.FunctionExpression);
+      if (isFunction) {
+        const isContextual = hasContextualTypeReference(decl, serviceName, localTypes);
+        const hasServiceName = containsIdentifier(varName, serviceName);
+        if (isContextual) {
+          if (!hasServiceName) {
             errors.push({
-              ruleId: "krnl/frontend-functionality-manifest-required",
-              filePath: funcPath,
-              message: `Frontend functionality "${entry.name}" is missing a manifest.json file.`,
+              ruleId: "krnl/service-library-asset-naming",
+              filePath,
+              line: decl.getStartLineNumber(),
+              message: `Service library asset '${varName}' in service '${serviceName}' violates scoped library naming convention. Custom library asset identifiers must contain the owning service name ('${serviceName}'). Expected name containing '${serviceName}', or eliminate contextual custom type dependencies to make it a generic promotable utility.`,
               severity: "error"
             });
           }
+        } else {
+          promotableAssets.push({
+            name: varName,
+            kind: "function",
+            filePath,
+            scope: "service",
+            scopeName: serviceName,
+            target: "GutTS"
+          });
+        }
+      } else {
+        const isContextual = hasContextualTypeReference(decl, serviceName, localTypes);
+        const hasServiceName = containsIdentifier(varName, serviceName);
+        if (isContextual && !hasServiceName) {
+          errors.push({
+            ruleId: "krnl/service-library-asset-naming",
+            filePath,
+            line: decl.getStartLineNumber(),
+            message: `Service library asset '${varName}' in service '${serviceName}' violates scoped library naming convention. Custom library asset identifiers must contain the owning service name ('${serviceName}').`,
+            severity: "error"
+          });
         }
       }
     }
   }
+  for (const iface of sf.getInterfaces()) {
+    const name = iface.getName();
+    const hasServiceName = containsIdentifier(name, serviceName);
+    const hasProps = iface.getProperties().length > 0;
+    if (hasProps && !hasServiceName) {
+      errors.push({
+        ruleId: "krnl/service-library-asset-naming",
+        filePath,
+        line: iface.getStartLineNumber(),
+        message: `Service library interface '${name}' in service '${serviceName}' violates scoped library naming convention. Custom library asset identifiers must contain the owning service name ('${serviceName}'). Expected name like '${serviceName}${name}'.`,
+        severity: "error"
+      });
+    }
+  }
+  for (const t of sf.getTypeAliases()) {
+    const name = t.getName();
+    const hasServiceName = containsIdentifier(name, serviceName);
+    const isContextual = hasContextualTypeReference(t, serviceName, localTypes);
+    if (isContextual && !hasServiceName) {
+      errors.push({
+        ruleId: "krnl/service-library-asset-naming",
+        filePath,
+        line: t.getStartLineNumber(),
+        message: `Service library type alias '${name}' in service '${serviceName}' violates scoped library naming convention. Custom library asset identifiers must contain the owning service name ('${serviceName}'). Expected name like '${serviceName}${name}'.`,
+        severity: "error"
+      });
+    }
+  }
+  for (const cls of sf.getClasses()) {
+    const name = cls.getName();
+    if (!name) continue;
+    const hasServiceName = containsIdentifier(name, serviceName);
+    if (!hasServiceName) {
+      errors.push({
+        ruleId: "krnl/service-library-asset-naming",
+        filePath,
+        line: cls.getStartLineNumber(),
+        message: `Service library class '${name}' in service '${serviceName}' violates scoped library naming convention. Custom library asset identifiers must contain the owning service name ('${serviceName}'). Expected name like '${serviceName}${name}'.`,
+        severity: "error"
+      });
+    }
+  }
+  return { errors, warnings, promotableAssets };
+}
+
+// src/KrnlValidatorEngine.ts
+var KrnlValidatorEngine = class {
+  project;
+  projectRoot;
+  limitOptions;
+  constructor(optionsOrRoot) {
+    const options = typeof optionsOrRoot === "string" ? { projectRoot: optionsOrRoot } : optionsOrRoot;
+    this.projectRoot = path3.resolve(options.projectRoot || process.cwd());
+    this.limitOptions = {
+      maxFileLineLimit: options.maxFileLineLimit ?? 200,
+      maxMainLogicLimit: options.maxMainLogicLimit ?? 20,
+      maxHelperLineLimit: options.maxHelperLineLimit ?? 30
+    };
+    const tsConfigPath = path3.join(this.projectRoot, "tsconfig.json");
+    if (fs2.existsSync(tsConfigPath)) {
+      this.project = new Project({ tsConfigFilePath: tsConfigPath, skipAddingFilesFromTsConfig: true });
+    } else {
+      this.project = new Project({ compilerOptions: {
+        target: 99
+        /* ESNext */
+      } });
+    }
+  }
+  validateAll() {
+    const files = this.collectSourceFiles(this.projectRoot);
+    const errors = [];
+    const warnings = [];
+    const promotableAssets = [];
+    checkWorkspaceLayout(this.projectRoot, errors);
+    for (const f of files) {
+      const sf = this.project.addSourceFileAtPath(f);
+      const fileReport = this.validateSourceFile(sf);
+      errors.push(...fileReport.errors);
+      warnings.push(...fileReport.warnings);
+      if (fileReport.promotableAssets) {
+        promotableAssets.push(...fileReport.promotableAssets);
+      }
+    }
+    return {
+      valid: errors.length === 0,
+      totalFiles: files.length,
+      errors,
+      warnings,
+      promotableAssets
+    };
+  }
+  validateSourceFile(sf) {
+    const filePath = sf.getFilePath();
+    const baseName = path3.basename(filePath);
+    if (baseName.includes("_pb.") || baseName.endsWith(".d.ts")) {
+      return { errors: [], warnings: [], promotableAssets: [] };
+    }
+    const limits = checkFileLimits(sf, this.limitOptions);
+    const purity = checkTopLevelPurity(sf);
+    const components = checkComponentRules(sf);
+    const orchestration = checkOrchestrationRules(sf);
+    const boundaries = checkServiceBoundaries(sf);
+    const scopedLibraries = checkScopedLibraryRules(sf);
+    return {
+      errors: [
+        ...limits.errors,
+        ...purity.errors,
+        ...components.errors,
+        ...orchestration.errors,
+        ...boundaries.errors,
+        ...scopedLibraries.errors
+      ],
+      warnings: [
+        ...limits.warnings,
+        ...purity.warnings,
+        ...components.warnings,
+        ...orchestration.warnings,
+        ...boundaries.warnings,
+        ...scopedLibraries.warnings
+      ],
+      promotableAssets: scopedLibraries.promotableAssets
+    };
+  }
   collectSourceFiles(dir, collected = []) {
-    if (!fs.existsSync(dir)) return collected;
-    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    if (!fs2.existsSync(dir)) return collected;
+    const entries = fs2.readdirSync(dir, { withFileTypes: true });
     for (const entry of entries) {
       if (entry.name === "node_modules" || entry.name === "dist" || entry.name === ".git") continue;
-      const full = path.join(dir, entry.name);
+      const full = path3.join(dir, entry.name);
       if (entry.isDirectory()) {
         this.collectSourceFiles(full, collected);
       } else if (entry.isFile() && (entry.name.endsWith(".ts") || entry.name.endsWith(".js") || entry.name.endsWith(".tsx") || entry.name.endsWith(".jsx"))) {