@ultrst-armada/kloks 1.5.1 → 1.5.2

package/.krusbl-release-attestation.json

@@ -1,8 +1,8 @@
 {
   "schema": 1,
   "packageName": "@ultrst-armada/kloks",
-  "version": "1.5.1",
-  "sourceCommit": "df4285ad26bbf5f16acaca63ba43fe4e40740051",
+  "version": "1.5.2",
+  "sourceCommit": "07f2e1a49da642bbfd42cd79422306c93195493f",
   "releaseWorkflow": "npm Release",
-  "workflowRunId": "39943915592"
+  "workflowRunId": "39969373482"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultrst-armada/kloks",
-  "version": "1.5.1",
+  "version": "1.5.2",
   "private": false,
   "publishConfig": {
     "access": "public",

package/packages/backend/dist/{chunk-OVTXAGL6.js → chunk-3Z7EUZWE.js}

@@ -284,6 +284,86 @@ var DevelopmentServiceFacade = {
   }
 };
 
+// src/development/codeValidationService.ts
+var COMMANDS2 = {
+  syntax: { command: "pnpm", args: ["exec", "tsc", "--noEmit"] },
+  lint: { command: "pnpm", args: ["run", "lint", "--if-present"] },
+  test: { command: "pnpm", args: ["run", "test", "--if-present"] },
+  build: { command: "pnpm", args: ["run", "build", "--if-present"] },
+  krnl: { command: "pnpm", args: ["exec", "krnl", "validate"] },
+  frnl: { command: "pnpm", args: ["exec", "frnl", "validate"] }
+};
+var DEFAULT_LAYERS = ["syntax", "lint", "krnl", "frnl"];
+var commandText = (command, args) => [command, ...args].join(" ");
+var CodeValidationRuntime = class {
+  constructor(runtime3 = new WebContainerRuntime()) {
+    this.runtime = runtime3;
+  }
+  runtime;
+  async validate(input = {}) {
+    if (input.files) await this.runtime.mount(input.files);
+    const diagnostics = [];
+    if (input.install) {
+      const installed = await this.runtime.runCommand("pnpm", ["install", "--no-frozen-lockfile"], input.cwd, input.env);
+      diagnostics.push({ layer: "lint", ok: installed.exitCode === 0, exitCode: installed.exitCode, output: installed.output, command: "pnpm install --no-frozen-lockfile" });
+      if (installed.exitCode !== 0) return { ok: false, diagnostics, failedLayers: ["lint"] };
+    }
+    const layers = input.layers?.length ? input.layers : DEFAULT_LAYERS;
+    for (const layer of layers) {
+      if (layer === "law-l9") {
+        diagnostics.push(await this.validateLawL9(input.cwd, input.maxLines ?? 200));
+        continue;
+      }
+      const spec = COMMANDS2[layer];
+      const result = await this.runtime.runCommand(spec.command, spec.args, input.cwd, input.env);
+      diagnostics.push({ layer, ok: result.exitCode === 0, exitCode: result.exitCode, output: result.output, command: commandText(spec.command, spec.args) });
+      if (result.exitCode !== 0) break;
+    }
+    return { ok: diagnostics.every((item) => item.ok), diagnostics, failedLayers: diagnostics.filter((item) => !item.ok).map((item) => item.layer) };
+  }
+  async validateLawL9(cwd = ".", maxLines = 200) {
+    const script = `python3 -c 'import os,sys; bad=[]; root="src"; [bad.append(os.path.join(r,f)+": "+str(len(open(os.path.join(r,f),encoding="utf-8",errors="ignore").readlines()))+" lines") for r,_,fs in os.walk(root) for f in fs if f.endswith((".ts",".tsx",".js",".jsx")) and not f.endswith(".d.ts") and len(open(os.path.join(r,f),encoding="utf-8",errors="ignore").readlines())>200]; print("\\n".join(bad)); sys.exit(1 if bad else 0)'`;
+    const result = await this.runtime.runCommand("sh", ["-lc", script], cwd);
+    return { layer: "law-l9", ok: result.exitCode === 0, exitCode: result.exitCode, output: result.output, command: script };
+  }
+};
+var runtime2 = new CodeValidationRuntime();
+var CodeValidationServiceDefinition = createServiceDefinition({
+  id: "kloks.backend.codeValidation",
+  name: "CodeValidationService",
+  version: "1.0.0",
+  operations: { validate: { id: "CodeValidationService.validate", name: "validate", handler: async (input) => runtime2.validate(input) } }
+});
+var CodeValidationServiceFacade = {
+  id: CodeValidationServiceDefinition.id,
+  name: CodeValidationServiceDefinition.name,
+  version: CodeValidationServiceDefinition.version,
+  runtime: "client",
+  deployment: "local",
+  definition: CodeValidationServiceDefinition,
+  createInstance: () => createService(CodeValidationServiceDefinition),
+  execute: async (op, input) => {
+    const instance = createService(CodeValidationServiceDefinition);
+    await instance.start();
+    return instance.call(op, input);
+  }
+};
+
+// src/development/codeDiagnosticsService.ts
+var CodeDiagnosticsService = class {
+  constructor(runtime3 = new WebContainerRuntime()) {
+    this.runtime = runtime3;
+  }
+  runtime;
+  async diagnostics(input = {}) {
+    const args = ["exec", "tsc", "--noEmit", "--pretty", "false"];
+    if (input.file) args.push(input.file);
+    const result = await this.runtime.runCommand("pnpm", args, input.cwd);
+    return { ok: result.exitCode === 0, output: result.output, command: ["pnpm", ...args].join(" ") };
+  }
+};
+var codeDiagnosticsService = new CodeDiagnosticsService();
+
 export {
   GitHubActionsClient,
   GitHubActionsServiceDefinition,
@@ -294,5 +374,10 @@ export {
   resolveDevelopmentCommand,
   DevelopmentServiceDefinition,
   DevelopmentRuntime,
-  DevelopmentServiceFacade
+  DevelopmentServiceFacade,
+  CodeValidationRuntime,
+  CodeValidationServiceDefinition,
+  CodeValidationServiceFacade,
+  CodeDiagnosticsService,
+  codeDiagnosticsService
 };

package/packages/backend/dist/development/index.d.ts

@@ -143,4 +143,60 @@ declare const DevelopmentServiceFacade: {
     execute: <TIn = unknown, TOut = unknown>(op: string, input?: TIn) => Promise<TOut>;
 };
 
-export { type DevelopmentProvider, type DevelopmentRequest, type DevelopmentResult, DevelopmentRuntime, type DevelopmentServiceContract, DevelopmentServiceDefinition, DevelopmentServiceFacade, type DevelopmentTask, GitHubActionsClient, type GitHubActionsConfig, GitHubActionsServiceDefinition, GitHubActionsServiceFacade, type WebContainerCommand, type WebContainerRunCommandInput, WebContainerRuntime, WebContainerServiceDefinition, WebContainerServiceFacade, type WorkflowRun, resolveDevelopmentCommand };
+type ValidationLayer = 'syntax' | 'lint' | 'test' | 'build' | 'krnl' | 'frnl' | 'law-l9';
+interface CodeValidationInput {
+    layers?: ValidationLayer[];
+    cwd?: string;
+    env?: Record<string, string>;
+    maxLines?: number;
+    files?: Record<string, unknown>;
+    install?: boolean;
+}
+interface ValidationDiagnostic {
+    layer: ValidationLayer;
+    ok: boolean;
+    exitCode: number;
+    output: string;
+    command: string;
+}
+interface CodeValidationResult {
+    ok: boolean;
+    diagnostics: ValidationDiagnostic[];
+    failedLayers: ValidationLayer[];
+}
+
+declare class CodeValidationRuntime {
+    private readonly runtime;
+    constructor(runtime?: WebContainerRuntime);
+    validate(input?: CodeValidationInput): Promise<CodeValidationResult>;
+    private validateLawL9;
+}
+declare const CodeValidationServiceDefinition: ServiceDefinition;
+declare const CodeValidationServiceFacade: {
+    id: string;
+    name: string;
+    version: string;
+    runtime: "client";
+    deployment: "local";
+    definition: ServiceDefinition<Record<string, unknown>, Record<string, unknown>>;
+    createInstance: () => _ultrst_armada_krnl.ServiceInstance<Record<string, unknown>, Record<string, unknown>>;
+    execute: <TIn = CodeValidationInput, TOut = CodeValidationResult>(op: string, input?: TIn) => Promise<TOut>;
+};
+
+interface CodeDiagnosticsInput {
+    cwd?: string;
+    file?: string;
+}
+interface CodeDiagnosticsResult {
+    ok: boolean;
+    output: string;
+    command: string;
+}
+declare class CodeDiagnosticsService {
+    private readonly runtime;
+    constructor(runtime?: WebContainerRuntime);
+    diagnostics(input?: CodeDiagnosticsInput): Promise<CodeDiagnosticsResult>;
+}
+declare const codeDiagnosticsService: CodeDiagnosticsService;
+
+export { type CodeDiagnosticsInput, type CodeDiagnosticsResult, CodeDiagnosticsService, type CodeValidationInput, type CodeValidationResult, CodeValidationRuntime, CodeValidationServiceDefinition, CodeValidationServiceFacade, type DevelopmentProvider, type DevelopmentRequest, type DevelopmentResult, DevelopmentRuntime, type DevelopmentServiceContract, DevelopmentServiceDefinition, DevelopmentServiceFacade, type DevelopmentTask, GitHubActionsClient, type GitHubActionsConfig, GitHubActionsServiceDefinition, GitHubActionsServiceFacade, type ValidationDiagnostic, type ValidationLayer, type WebContainerCommand, type WebContainerRunCommandInput, WebContainerRuntime, WebContainerServiceDefinition, WebContainerServiceFacade, type WorkflowRun, codeDiagnosticsService, resolveDevelopmentCommand };

package/packages/backend/dist/development/index.js

@@ -1,4 +1,8 @@
 import {
+  CodeDiagnosticsService,
+  CodeValidationRuntime,
+  CodeValidationServiceDefinition,
+  CodeValidationServiceFacade,
   DevelopmentRuntime,
   DevelopmentServiceDefinition,
   DevelopmentServiceFacade,
@@ -8,10 +12,15 @@ import {
   WebContainerRuntime,
   WebContainerServiceDefinition,
   WebContainerServiceFacade,
+  codeDiagnosticsService,
   resolveDevelopmentCommand
-} from "../chunk-OVTXAGL6.js";
+} from "../chunk-3Z7EUZWE.js";
 import "../chunk-TY32TUNI.js";
 export {
+  CodeDiagnosticsService,
+  CodeValidationRuntime,
+  CodeValidationServiceDefinition,
+  CodeValidationServiceFacade,
   DevelopmentRuntime,
   DevelopmentServiceDefinition,
   DevelopmentServiceFacade,
@@ -21,5 +30,6 @@ export {
   WebContainerRuntime,
   WebContainerServiceDefinition,
   WebContainerServiceFacade,
+  codeDiagnosticsService,
   resolveDevelopmentCommand
 };

package/packages/backend/dist/index.d.ts

@@ -13,7 +13,7 @@ export { AdaptedStorageConnection, AppAccountManifest, AppServiceDeclaration, CA
 export { CompositeBackend, EndpointGenerator, GeneratedEndpointSummary, LOCAL_STORAGE_GRAPHS_PREFIX, LocalService, NodeGraphPersistenceService, NodeGraphValidationResult, RemoteServiceProxy, SaveGraphOptions, UniversalAppEntity, UniversalGraphEdge, UniversalGraphNode, UniversalNodeGraphDocument, UniversalStorageConnection, WorkspaceGraphDocument, WorkspaceGraphSummary, createBackend, createCompositeService, createLocalService, createRemoteService, exportGraphAsJsonFile, nodeGraphPersistence, parseGraphJsonFile, validateGraphDocument, workspaceGraphService } from './services/index.js';
 import { AssetDataType as AssetDataType$1, AssetChannelType as AssetChannelType$1, GraphFolderInfo as GraphFolderInfo$1, GraphAssetItem as GraphAssetItem$1, SpaceNode, NodeConnection, DawProject } from '@ultrst-armada/kloks/state-graph';
 export { AuthServiceDefinition, AuthServiceFacade, ControlPlaneServiceDefinition, ControlPlaneServiceFacade, DatabaseServiceDefinition, DatabaseServiceFacade, GeminiServiceDefinition, GeminiServiceFacade, SrklServiceDefinition, SrklServiceFacade, StorageServiceDefinition, StorageServiceFacade, WorkspaceGraphServiceDefinition, WorkspaceGraphServiceFacade, WorkspaceServiceDefinition, WorkspaceServiceFacade, krnlAuthServiceDefinition, krnlAuthServiceFacade, krnlControlPlaneServiceDefinition, krnlControlPlaneServiceFacade, krnlDatabaseServiceDefinition, krnlDatabaseServiceFacade, krnlGeminiServiceDefinition, krnlGeminiServiceFacade, krnlSrklServiceDefinition, krnlSrklServiceFacade, krnlStorageServiceDefinition, krnlStorageServiceFacade, krnlWorkspaceGraphServiceDefinition, krnlWorkspaceGraphServiceFacade, krnlWorkspaceServiceDefinition, krnlWorkspaceServiceFacade } from './krnl-services.js';
-export { DevelopmentProvider, DevelopmentRequest, DevelopmentResult, DevelopmentRuntime, DevelopmentServiceContract, DevelopmentServiceDefinition, DevelopmentServiceFacade, DevelopmentTask, GitHubActionsClient, GitHubActionsConfig, GitHubActionsServiceDefinition, GitHubActionsServiceFacade, WebContainerCommand, WebContainerRunCommandInput, WebContainerRuntime, WebContainerServiceDefinition, WebContainerServiceFacade, WorkflowRun, resolveDevelopmentCommand } from './development/index.js';
+export { CodeDiagnosticsInput, CodeDiagnosticsResult, CodeDiagnosticsService, CodeValidationInput, CodeValidationResult, CodeValidationRuntime, CodeValidationServiceDefinition, CodeValidationServiceFacade, DevelopmentProvider, DevelopmentRequest, DevelopmentResult, DevelopmentRuntime, DevelopmentServiceContract, DevelopmentServiceDefinition, DevelopmentServiceFacade, DevelopmentTask, GitHubActionsClient, GitHubActionsConfig, GitHubActionsServiceDefinition, GitHubActionsServiceFacade, ValidationDiagnostic, ValidationLayer, WebContainerCommand, WebContainerRunCommandInput, WebContainerRuntime, WebContainerServiceDefinition, WebContainerServiceFacade, WorkflowRun, codeDiagnosticsService, resolveDevelopmentCommand } from './development/index.js';
 export { EndpointDescriptor, IService, ProtocolAdapter, ServiceDefinition } from '@ultrst-armada/krnl';
 import 'react';
 

package/packages/backend/dist/index.js

@@ -195,6 +195,10 @@ import {
   resolveSystemDatabaseClusterNodes
 } from "./chunk-RCCQ7IRM.js";
 import {
+  CodeDiagnosticsService,
+  CodeValidationRuntime,
+  CodeValidationServiceDefinition,
+  CodeValidationServiceFacade,
   DevelopmentRuntime,
   DevelopmentServiceDefinition,
   DevelopmentServiceFacade,
@@ -204,8 +208,9 @@ import {
   WebContainerRuntime,
   WebContainerServiceDefinition,
   WebContainerServiceFacade,
+  codeDiagnosticsService,
   resolveDevelopmentCommand
-} from "./chunk-OVTXAGL6.js";
+} from "./chunk-3Z7EUZWE.js";
 import "./chunk-TY32TUNI.js";
 
 // src/data/BaseDataProvider.ts
@@ -4379,6 +4384,10 @@ export {
   CANONICAL_SRKL_URL,
   CallbackRegistry,
   CloudflareResourceFetcher,
+  CodeDiagnosticsService,
+  CodeValidationRuntime,
+  CodeValidationServiceDefinition,
+  CodeValidationServiceFacade,
   CompositeBackend,
   ConcurrencyConflictError,
   ConcurrencyManager,
@@ -4460,6 +4469,7 @@ export {
   buildProjectObservability,
   buildProjectsList,
   cleanDbUrl,
+  codeDiagnosticsService,
   computeDeploymentFinalWeight,
   computeUsageWeightScore,
   configureStarterProjectTemplate,

package/packages/backend/kloks.manifest.json

@@ -258,6 +258,59 @@
       },
       "dependencies": [
         "github-actions",
+        "web-container",
+        "code-validation"
+      ]
+    },
+    {
+      "id": "code-validation",
+      "name": "Code Validation & Diagnostics",
+      "version": "1.0.0",
+      "description": "Shared syntax, lint, test, build, KrnlTS, FrnlTS and Law L9 validation pipeline backed by the canonical WebContainer runtime.",
+      "backend": {
+        "package": "@ultrst-armada/kloks",
+        "subpath": "development",
+        "export": "CodeValidationServiceFacade",
+        "facade": "CodeValidationServiceFacade"
+      },
+      "modes": [
+        "fullstack"
+      ],
+      "targets": {
+        "backend": [
+          "App.main-content"
+        ],
+        "frontend": [
+          "App.main-content"
+        ]
+      },
+      "dependencies": [
+        "web-container"
+      ]
+    },
+    {
+      "id": "code-diagnostics",
+      "name": "TypeScript Code Diagnostics",
+      "version": "1.0.0",
+      "description": "Editor-facing TypeScript diagnostics runner for authored source.",
+      "backend": {
+        "package": "@ultrst-armada/kloks",
+        "subpath": "development",
+        "export": "codeDiagnosticsService",
+        "facade": "codeDiagnosticsService"
+      },
+      "modes": [
+        "fullstack"
+      ],
+      "targets": {
+        "backend": [
+          "App.main-content"
+        ],
+        "frontend": [
+          "App.main-content"
+        ]
+      },
+      "dependencies": [
         "web-container"
       ]
     }

package/packages/state-graph/dist/index.js

@@ -7,21 +7,6 @@ import {
   instantiateSubgraph
 } from "./chunk-S22PMERU.js";
 import "./chunk-RHRXPY2U.js";
-import {
-  AttractionEngine,
-  GhostInferenceEngine,
-  GhostLayoutResolver,
-  GhostTracePathBuilder,
-  calculateSocketCoordinates,
-  getBeamPoints,
-  useMagneticTraces
-} from "./chunk-JXDJZSFW.js";
-import {
-  ConnectionRuleStore,
-  HandleTypeRegistry,
-  WireTypeRegistry,
-  initializeDefaultGraphRules
-} from "./chunk-TZOL3RN7.js";
 import {
   LifecycleCycleError,
   LifecycleGraph,
@@ -45,6 +30,21 @@ import {
   CustomViewWindow,
   DEFAULT_GRAPH_SETTINGS
 } from "./chunk-KG6QYS26.js";
+import {
+  AttractionEngine,
+  GhostInferenceEngine,
+  GhostLayoutResolver,
+  GhostTracePathBuilder,
+  calculateSocketCoordinates,
+  getBeamPoints,
+  useMagneticTraces
+} from "./chunk-JXDJZSFW.js";
+import {
+  ConnectionRuleStore,
+  HandleTypeRegistry,
+  WireTypeRegistry,
+  initializeDefaultGraphRules
+} from "./chunk-TZOL3RN7.js";
 import {
   AutoSolidify,
   SpatialEngine,