@ultrst-armada/kloks 1.9.0 → 1.10.0

package/.krusbl-release-attestation.json

@@ -1,8 +1,8 @@
 {
   "schema": 1,
   "packageName": "@ultrst-armada/kloks",
-  "version": "1.9.0",
-  "sourceCommit": "b6205d2c4f27f354324b4029676d614418fae89d",
+  "version": "1.10.0",
+  "sourceCommit": "302682bf08b2a4adcb8109f8f4a6a44651b25909",
   "releaseWorkflow": "npm Release",
-  "workflowRunId": "40212539594"
+  "workflowRunId": "40287961465"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultrst-armada/kloks",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "private": false,
   "publishConfig": {
     "access": "public",
@@ -164,7 +164,7 @@
     "typescript": "^5.7.3",
     "vitest": "^3.1.0"
   },
-  "packageManager": "pnpm@9.15.0",
+  "packageManager": "pnpm@10.33.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/dinilmusick/Kloks.git"

package/packages/backend/dist/{chunk-SQGBAWZN.js → chunk-OYVHKYJW.js}

@@ -297,9 +297,10 @@ var COMMANDS2 = {
   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"] }
+  frnl: { command: "pnpm", args: ["exec", "frnl", "validate"] },
+  "lockfile-check": { command: "pnpm", args: ["install", "--frozen-lockfile", "--ignore-scripts"] }
 };
-var DEFAULT_LAYERS = ["syntax", "lint", "krnl", "frnl"];
+var DEFAULT_LAYERS = ["lockfile-check", "syntax", "lint", "krnl", "frnl"];
 var commandText = (command, args) => [command, ...args].join(" ");
 var CodeValidationRuntime = class {
   constructor(runtime5 = new WebContainerRuntime()) {
@@ -310,9 +311,9 @@ var CodeValidationRuntime = class {
     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 installed = await this.runtime.runCommand("pnpm", ["install", "--frozen-lockfile", "--ignore-scripts"], input.cwd, input.env);
+      diagnostics.push({ layer: "lockfile-check", ok: installed.exitCode === 0, exitCode: installed.exitCode, output: installed.output, command: "pnpm install --frozen-lockfile --ignore-scripts" });
+      if (installed.exitCode !== 0) return { ok: false, diagnostics, failedLayers: ["lockfile-check"] };
     }
     const layers = input.layers?.length ? input.layers : DEFAULT_LAYERS;
     for (const layer of layers) {
@@ -337,7 +338,7 @@ var runtime2 = new CodeValidationRuntime();
 var CodeValidationServiceDefinition = createServiceDefinition({
   id: "kloks.backend.codeValidation",
   name: "CodeValidationService",
-  version: "1.0.0",
+  version: "1.1.0",
   operations: { validate: { id: "CodeValidationService.validate", name: "validate", handler: async (input) => runtime2.validate(input) } }
 });
 var CodeValidationServiceFacade = {

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

@@ -144,7 +144,7 @@ declare const DevelopmentServiceFacade: {
     execute: <TIn = unknown, TOut = unknown>(op: string, input?: TIn) => Promise<TOut>;
 };
 
-type ValidationLayer = 'syntax' | 'lint' | 'test' | 'build' | 'krnl' | 'frnl' | 'law-l9';
+type ValidationLayer = 'syntax' | 'lint' | 'test' | 'build' | 'krnl' | 'frnl' | 'lockfile-check' | 'law-l9';
 interface CodeValidationInput {
     layers?: ValidationLayer[];
     cwd?: string;

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

@@ -21,7 +21,7 @@ import {
   WebContainerServiceFacade,
   codeDiagnosticsService,
   resolveDevelopmentCommand
-} from "../chunk-SQGBAWZN.js";
+} from "../chunk-OYVHKYJW.js";
 import "../chunk-TY32TUNI.js";
 export {
   AgentHarnessRuntime,

package/packages/backend/dist/index.js

@@ -232,7 +232,7 @@ import {
   WebContainerServiceFacade,
   codeDiagnosticsService,
   resolveDevelopmentCommand
-} from "./chunk-SQGBAWZN.js";
+} from "./chunk-OYVHKYJW.js";
 import "./chunk-TY32TUNI.js";
 
 // src/data/BaseDataProvider.ts

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

@@ -680,6 +680,24 @@ declare const UI_AUTHORING_SCHEMA_VERSION = "1.0.0";
 declare function suggestUIComponent(fieldType: string): string;
 declare function buildServiceUISchema(session: UIAuthoringSession): ServiceUISchema;
 
+type UIComponentPurpose = 'service-ui' | 'general-purpose' | 'application-specific';
+type UIComponentPromotion = 'always' | 'usually' | 'never';
+interface UIComponentArtifact {
+    artifactId: string;
+    schemaVersion: string;
+    purpose: UIComponentPurpose;
+    promotion: UIComponentPromotion;
+    origin: 'kult' | 'theta' | 'kelt' | 'other';
+    context: UIAuthoringContext;
+    name: string;
+    description: string;
+    rootAsset?: AssetRef;
+    session: UIAuthoringSession;
+}
+declare function getUIComponentPurpose(context: UIAuthoringContext): UIComponentPurpose;
+declare function getUIComponentPromotion(purpose: UIComponentPurpose): UIComponentPromotion;
+declare function buildUIComponentArtifact(session: UIAuthoringSession): UIComponentArtifact;
+
 declare const KLOKS_CANONICAL_CONTRACT: {
     package: string;
     version: string;
@@ -699,4 +717,4 @@ declare const KLOKS_CANONICAL_CONTRACT: {
     validateCompatibility: (consumerSymbols?: string[]) => CompatibilityCheckResult;
 };
 
-export { type AssetRef, type AudioBusConfig, AudioBusConfigSchema, type AudioHardwareState, AudioHardwareStateSchema, type BackendOperation, BackendOperationSchema, type CompatibilityCheckResult, type ComponentDescriptor, type ContractDiffResult, type ContractSnapshot, ContractSnapshotSchema, type ExportSymbolEntry, type GraphEntityMetadata, GraphEntityMetadataSchema, KLOKS_CANONICAL_CONTRACT, KLOKS_PUBLIC_SURFACE, type MidiCommandType, MidiCommandTypeSchema, type MidiEventPayload, MidiEventPayloadSchema, type MonacoCreateSessionInput, type MonacoDiagnostic, type MonacoDiagnosticSeverity, type MonacoDocument, type MonacoEditorOptions, type MonacoIdeSession, type MonacoUpdateDocumentInput, type NodeDimensions2D, NodeDimensions2DSchema, type NodeHeaderStyle, NodeHeaderStyleSchema, type NodeScreenRect2D, NodeScreenRect2DSchema, type OperationBinding, type PageDescriptor, type PublicContractDefinition, PublicContractDefinitionSchema, QWNSR_REQUIRED_SURFACE, type SectionDescriptor, type ServiceUISchema, type SocketDirection, SocketDirectionSchema, type SocketGeometryConfig, SocketGeometryConfigSchema, type SocketPosition2D, SocketPosition2DSchema, type SocketStyleConfig, SocketStyleConfigSchema, type UIAuthoringBinding, type UIAuthoringContext, type UIAuthoringCreateInput, type UIAuthoringNode, type UIAuthoringNodeKind, type UIAuthoringOperation, type UIAuthoringSession, type UIAuthoringValidation, type UIRequirementMode, UI_AUTHORING_SCHEMA_VERSION, type WireAnimationConfig, WireAnimationConfigSchema, type WireCurveStyle, WireCurveStyleSchema, type WireEndpoint2D, WireEndpoint2DSchema, type WireVisualConfig, WireVisualConfigSchema, buildServiceUISchema, createKloksSnapshot, diffContractSnapshots, suggestUIComponent, validateConsumerSurfaceCompatibility };
+export { type AssetRef, type AudioBusConfig, AudioBusConfigSchema, type AudioHardwareState, AudioHardwareStateSchema, type BackendOperation, BackendOperationSchema, type CompatibilityCheckResult, type ComponentDescriptor, type ContractDiffResult, type ContractSnapshot, ContractSnapshotSchema, type ExportSymbolEntry, type GraphEntityMetadata, GraphEntityMetadataSchema, KLOKS_CANONICAL_CONTRACT, KLOKS_PUBLIC_SURFACE, type MidiCommandType, MidiCommandTypeSchema, type MidiEventPayload, MidiEventPayloadSchema, type MonacoCreateSessionInput, type MonacoDiagnostic, type MonacoDiagnosticSeverity, type MonacoDocument, type MonacoEditorOptions, type MonacoIdeSession, type MonacoUpdateDocumentInput, type NodeDimensions2D, NodeDimensions2DSchema, type NodeHeaderStyle, NodeHeaderStyleSchema, type NodeScreenRect2D, NodeScreenRect2DSchema, type OperationBinding, type PageDescriptor, type PublicContractDefinition, PublicContractDefinitionSchema, QWNSR_REQUIRED_SURFACE, type SectionDescriptor, type ServiceUISchema, type SocketDirection, SocketDirectionSchema, type SocketGeometryConfig, SocketGeometryConfigSchema, type SocketPosition2D, SocketPosition2DSchema, type SocketStyleConfig, SocketStyleConfigSchema, type UIAuthoringBinding, type UIAuthoringContext, type UIAuthoringCreateInput, type UIAuthoringNode, type UIAuthoringNodeKind, type UIAuthoringOperation, type UIAuthoringSession, type UIAuthoringValidation, type UIComponentArtifact, type UIComponentPromotion, type UIComponentPurpose, type UIRequirementMode, UI_AUTHORING_SCHEMA_VERSION, type WireAnimationConfig, WireAnimationConfigSchema, type WireCurveStyle, WireCurveStyleSchema, type WireEndpoint2D, WireEndpoint2DSchema, type WireVisualConfig, WireVisualConfigSchema, buildServiceUISchema, buildUIComponentArtifact, createKloksSnapshot, diffContractSnapshots, getUIComponentPromotion, getUIComponentPurpose, suggestUIComponent, validateConsumerSurfaceCompatibility };

package/packages/contracts/dist/index.js

@@ -439,6 +439,34 @@ function buildServiceUISchema(session) {
   };
 }
 
+// src/uiAuthoringArtifactSchema.ts
+function getUIComponentPurpose(context) {
+  if (context === "service") return "service-ui";
+  if (context === "general-component") return "general-purpose";
+  return "application-specific";
+}
+function getUIComponentPromotion(purpose) {
+  if (purpose === "service-ui" || purpose === "general-purpose") return "always";
+  return "usually";
+}
+function buildUIComponentArtifact(session) {
+  const purpose = getUIComponentPurpose(session.context);
+  const origin = session.metadata.origin === "kult" || session.metadata.origin === "theta" || session.metadata.origin === "kelt" ? session.metadata.origin : "other";
+  const root = session.nodes.find((node) => node.kind === "component" && !node.parentId)?.assetRef;
+  return {
+    artifactId: "kloks.ui-artifact." + session.sessionId,
+    schemaVersion: "1.0.0",
+    purpose,
+    promotion: getUIComponentPromotion(purpose),
+    origin,
+    context: session.context,
+    name: session.metadata.name || session.sessionId,
+    description: session.metadata.description || "",
+    rootAsset: root,
+    session
+  };
+}
+
 // src/index.ts
 var KLOKS_CANONICAL_CONTRACT = {
   package: "@ultrst-armada/kloks",
@@ -471,8 +499,11 @@ export {
   WireEndpoint2DSchema,
   WireVisualConfigSchema,
   buildServiceUISchema,
+  buildUIComponentArtifact,
   createKloksSnapshot,
   diffContractSnapshots,
+  getUIComponentPromotion,
+  getUIComponentPurpose,
   suggestUIComponent,
   validateConsumerSurfaceCompatibility
 };

package/packages/services/dist/index.js

@@ -1757,7 +1757,7 @@ var MonacoIdeServiceFacade = {
 };
 
 // src/client-services/uiAuthoringService.ts
-import { buildServiceUISchema, suggestUIComponent } from "@ultrst-armada/kloks/contracts";
+import { buildServiceUISchema, buildUIComponentArtifact, suggestUIComponent } from "@ultrst-armada/kloks/contracts";
 var activeUIAuthoringService;
 var UIAuthoringServiceDefinition = createServiceDefinition({
   id: "kloks.service.uiAuthoring",
@@ -1837,6 +1837,11 @@ var UIAuthoringServiceDefinition = createServiceDefinition({
       name: "serialize",
       handler: async (input, ctx) => JSON.stringify(getSession(activeUIAuthoringService, input.sessionId), null, 2)
     },
+    generateArtifact: {
+      id: "UIAuthoringService.generateArtifact",
+      name: "generateArtifact",
+      handler: async (input, ctx) => buildUIComponentArtifact(getSession(activeUIAuthoringService, input.sessionId))
+    },
     generateServiceUI: {
       id: "UIAuthoringService.generateServiceUI",
       name: "generateServiceUI",
@@ -1868,6 +1873,15 @@ function validateSession(session) {
   const errors = [];
   const warnings = [];
   if (!session.nodes.some((node) => node.kind === "page")) errors.push("At least one page is required.");
+  const ids = /* @__PURE__ */ new Set();
+  for (const node of session.nodes) {
+    if (ids.has(node.id)) errors.push(`Duplicate authoring node id: ${node.id}`);
+    ids.add(node.id);
+    if (node.parentId && !session.nodes.some((parent) => parent.id === node.parentId)) errors.push(`Missing parent for node: ${node.id}`);
+    if (node.kind === "page" && node.parentId) errors.push(`Page cannot have a parent: ${node.id}`);
+    if (node.kind === "section" && node.parentId && !session.nodes.some((parent) => parent.id === node.parentId && parent.kind === "page")) errors.push(`Section parent must be a page: ${node.id}`);
+    if (node.kind === "component" && node.parentId && !session.nodes.some((parent) => parent.id === node.parentId && parent.kind === "section")) errors.push(`Component parent must be a section: ${node.id}`);
+  }
   if (session.nodes.some((node) => node.kind === "component" && !node.assetRef)) errors.push("Every component node requires a FLOKS asset reference.");
   if (session.context === "service" && !session.metadata.serviceId) errors.push("Service authoring requires metadata.serviceId.");
   for (const binding of session.bindings) {

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

@@ -22,15 +22,6 @@ import {
   WireTypeRegistry,
   initializeDefaultGraphRules
 } from "./chunk-TZOL3RN7.js";
-import {
-  LifecycleCycleError,
-  LifecycleGraph,
-  SKIPO_STATE,
-  SkipoStateEngine,
-  useLifecycleScope,
-  useSkipoBind,
-  useSkipoState
-} from "./chunk-EW4ACSZB.js";
 import {
   CommandApi,
   GhostStore,
@@ -58,6 +49,15 @@ import {
 import {
   CompatibilityMatrix
 } from "./chunk-ISFNY7EZ.js";
+import {
+  LifecycleCycleError,
+  LifecycleGraph,
+  SKIPO_STATE,
+  SkipoStateEngine,
+  useLifecycleScope,
+  useSkipoBind,
+  useSkipoState
+} from "./chunk-EW4ACSZB.js";
 
 // ../../node_modules/.pnpm/@ultrst-armada+krnl@1.0.3/node_modules/@ultrst-armada/krnl/packages/core/dist/index.js
 var ServiceStateStore = class {