@lssm/lib.contracts 0.0.0-canary-20251220041653 → 0.0.0-canary-20251221132705

package/dist/knowledge/contracts.d.ts

@@ -1,47 +1,47 @@
-import { AnyContractSpec, ContractSpec } from "../spec.js";
-import { SpecRegistry } from "../registry.js";
+import { AnyOperationSpec, OperationSpec } from "../operation.js";
+import { OperationSpecRegistry } from "../registry.js";
 import "../index.js";
-import * as _lssm_lib_schema352 from "@lssm/lib.schema";
+import * as _lssm_lib_schema497 from "@lssm/lib.schema";
 import { SchemaModel } from "@lssm/lib.schema";
 
 //#region src/knowledge/contracts.d.ts
-declare const CreateKnowledgeSource: ContractSpec<SchemaModel<{
+declare const CreateKnowledgeSource: OperationSpec<SchemaModel<{
   tenantId: {
-    type: _lssm_lib_schema352.FieldType<string, string>;
+    type: _lssm_lib_schema497.FieldType<string, string>;
     isOptional: false;
   };
   spaceKey: {
-    type: _lssm_lib_schema352.FieldType<string, string>;
+    type: _lssm_lib_schema497.FieldType<string, string>;
     isOptional: false;
   };
   spaceVersion: {
-    type: _lssm_lib_schema352.FieldType<number, number>;
+    type: _lssm_lib_schema497.FieldType<number, number>;
     isOptional: false;
   };
   label: {
-    type: _lssm_lib_schema352.FieldType<string, string>;
+    type: _lssm_lib_schema497.FieldType<string, string>;
     isOptional: false;
   };
   sourceType: {
-    type: _lssm_lib_schema352.FieldType<string, string>;
+    type: _lssm_lib_schema497.FieldType<string, string>;
     isOptional: false;
   };
   config: {
-    type: _lssm_lib_schema352.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    type: _lssm_lib_schema497.FieldType<Record<string, unknown>, Record<string, unknown>>;
     isOptional: false;
   };
   syncSchedule: {
     type: SchemaModel<{
       enabled: {
-        type: _lssm_lib_schema352.FieldType<boolean, boolean>;
+        type: _lssm_lib_schema497.FieldType<boolean, boolean>;
         isOptional: false;
       };
       cron: {
-        type: _lssm_lib_schema352.FieldType<string, string>;
+        type: _lssm_lib_schema497.FieldType<string, string>;
         isOptional: true;
       };
       intervalMs: {
-        type: _lssm_lib_schema352.FieldType<number, number>;
+        type: _lssm_lib_schema497.FieldType<number, number>;
         isOptional: true;
       };
     }>;
@@ -49,92 +49,92 @@ declare const CreateKnowledgeSource: ContractSpec<SchemaModel<{
   };
 }>, SchemaModel<{
   id: {
-    type: _lssm_lib_schema352.FieldType<string, string>;
+    type: _lssm_lib_schema497.FieldType<string, string>;
     isOptional: false;
   };
   tenantId: {
-    type: _lssm_lib_schema352.FieldType<string, string>;
+    type: _lssm_lib_schema497.FieldType<string, string>;
     isOptional: false;
   };
   spaceKey: {
-    type: _lssm_lib_schema352.FieldType<string, string>;
+    type: _lssm_lib_schema497.FieldType<string, string>;
     isOptional: false;
   };
   spaceVersion: {
-    type: _lssm_lib_schema352.FieldType<number, number>;
+    type: _lssm_lib_schema497.FieldType<number, number>;
     isOptional: false;
   };
   label: {
-    type: _lssm_lib_schema352.FieldType<string, string>;
+    type: _lssm_lib_schema497.FieldType<string, string>;
     isOptional: false;
   };
   sourceType: {
-    type: _lssm_lib_schema352.FieldType<string, string>;
+    type: _lssm_lib_schema497.FieldType<string, string>;
     isOptional: false;
   };
   syncSchedule: {
     type: SchemaModel<{
       enabled: {
-        type: _lssm_lib_schema352.FieldType<boolean, boolean>;
+        type: _lssm_lib_schema497.FieldType<boolean, boolean>;
         isOptional: false;
       };
       cron: {
-        type: _lssm_lib_schema352.FieldType<string, string>;
+        type: _lssm_lib_schema497.FieldType<string, string>;
         isOptional: true;
       };
       intervalMs: {
-        type: _lssm_lib_schema352.FieldType<number, number>;
+        type: _lssm_lib_schema497.FieldType<number, number>;
         isOptional: true;
       };
     }>;
     isOptional: true;
   };
   lastSyncStatus: {
-    type: _lssm_lib_schema352.FieldType<string, string>;
+    type: _lssm_lib_schema497.FieldType<string, string>;
     isOptional: true;
   };
   lastSyncAt: {
-    type: _lssm_lib_schema352.FieldType<Date, string>;
+    type: _lssm_lib_schema497.FieldType<Date, string>;
     isOptional: true;
   };
   itemsProcessed: {
-    type: _lssm_lib_schema352.FieldType<number, number>;
+    type: _lssm_lib_schema497.FieldType<number, number>;
     isOptional: true;
   };
   createdAt: {
-    type: _lssm_lib_schema352.FieldType<Date, string>;
+    type: _lssm_lib_schema497.FieldType<Date, string>;
     isOptional: true;
   };
   updatedAt: {
-    type: _lssm_lib_schema352.FieldType<Date, string>;
+    type: _lssm_lib_schema497.FieldType<Date, string>;
     isOptional: true;
   };
 }>, undefined>;
-declare const UpdateKnowledgeSource: ContractSpec<SchemaModel<{
+declare const UpdateKnowledgeSource: OperationSpec<SchemaModel<{
   sourceId: {
-    type: _lssm_lib_schema352.FieldType<string, string>;
+    type: _lssm_lib_schema497.FieldType<string, string>;
     isOptional: false;
   };
   label: {
-    type: _lssm_lib_schema352.FieldType<string, string>;
+    type: _lssm_lib_schema497.FieldType<string, string>;
     isOptional: true;
   };
   config: {
-    type: _lssm_lib_schema352.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    type: _lssm_lib_schema497.FieldType<Record<string, unknown>, Record<string, unknown>>;
     isOptional: true;
   };
   syncSchedule: {
     type: SchemaModel<{
       enabled: {
-        type: _lssm_lib_schema352.FieldType<boolean, boolean>;
+        type: _lssm_lib_schema497.FieldType<boolean, boolean>;
         isOptional: false;
       };
       cron: {
-        type: _lssm_lib_schema352.FieldType<string, string>;
+        type: _lssm_lib_schema497.FieldType<string, string>;
         isOptional: true;
       };
       intervalMs: {
-        type: _lssm_lib_schema352.FieldType<number, number>;
+        type: _lssm_lib_schema497.FieldType<number, number>;
         isOptional: true;
       };
     }>;
@@ -142,149 +142,149 @@ declare const UpdateKnowledgeSource: ContractSpec<SchemaModel<{
   };
 }>, SchemaModel<{
   id: {
-    type: _lssm_lib_schema352.FieldType<string, string>;
+    type: _lssm_lib_schema497.FieldType<string, string>;
     isOptional: false;
   };
   tenantId: {
-    type: _lssm_lib_schema352.FieldType<string, string>;
+    type: _lssm_lib_schema497.FieldType<string, string>;
     isOptional: false;
   };
   spaceKey: {
-    type: _lssm_lib_schema352.FieldType<string, string>;
+    type: _lssm_lib_schema497.FieldType<string, string>;
     isOptional: false;
   };
   spaceVersion: {
-    type: _lssm_lib_schema352.FieldType<number, number>;
+    type: _lssm_lib_schema497.FieldType<number, number>;
     isOptional: false;
   };
   label: {
-    type: _lssm_lib_schema352.FieldType<string, string>;
+    type: _lssm_lib_schema497.FieldType<string, string>;
     isOptional: false;
   };
   sourceType: {
-    type: _lssm_lib_schema352.FieldType<string, string>;
+    type: _lssm_lib_schema497.FieldType<string, string>;
     isOptional: false;
   };
   syncSchedule: {
     type: SchemaModel<{
       enabled: {
-        type: _lssm_lib_schema352.FieldType<boolean, boolean>;
+        type: _lssm_lib_schema497.FieldType<boolean, boolean>;
         isOptional: false;
       };
       cron: {
-        type: _lssm_lib_schema352.FieldType<string, string>;
+        type: _lssm_lib_schema497.FieldType<string, string>;
         isOptional: true;
       };
       intervalMs: {
-        type: _lssm_lib_schema352.FieldType<number, number>;
+        type: _lssm_lib_schema497.FieldType<number, number>;
         isOptional: true;
       };
     }>;
     isOptional: true;
   };
   lastSyncStatus: {
-    type: _lssm_lib_schema352.FieldType<string, string>;
+    type: _lssm_lib_schema497.FieldType<string, string>;
     isOptional: true;
   };
   lastSyncAt: {
-    type: _lssm_lib_schema352.FieldType<Date, string>;
+    type: _lssm_lib_schema497.FieldType<Date, string>;
     isOptional: true;
   };
   itemsProcessed: {
-    type: _lssm_lib_schema352.FieldType<number, number>;
+    type: _lssm_lib_schema497.FieldType<number, number>;
     isOptional: true;
   };
   createdAt: {
-    type: _lssm_lib_schema352.FieldType<Date, string>;
+    type: _lssm_lib_schema497.FieldType<Date, string>;
     isOptional: true;
   };
   updatedAt: {
-    type: _lssm_lib_schema352.FieldType<Date, string>;
+    type: _lssm_lib_schema497.FieldType<Date, string>;
     isOptional: true;
   };
 }>, undefined>;
-declare const DeleteKnowledgeSource: ContractSpec<SchemaModel<{
+declare const DeleteKnowledgeSource: OperationSpec<SchemaModel<{
   sourceId: {
-    type: _lssm_lib_schema352.FieldType<string, string>;
+    type: _lssm_lib_schema497.FieldType<string, string>;
     isOptional: false;
   };
 }>, SchemaModel<{
   success: {
-    type: _lssm_lib_schema352.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema497.FieldType<boolean, boolean>;
     isOptional: false;
   };
 }>, undefined>;
-declare const ListKnowledgeSources: ContractSpec<SchemaModel<{
+declare const ListKnowledgeSources: OperationSpec<SchemaModel<{
   tenantId: {
-    type: _lssm_lib_schema352.FieldType<string, string>;
+    type: _lssm_lib_schema497.FieldType<string, string>;
     isOptional: false;
   };
   spaceKey: {
-    type: _lssm_lib_schema352.FieldType<string, string>;
+    type: _lssm_lib_schema497.FieldType<string, string>;
     isOptional: true;
   };
 }>, SchemaModel<{
   sources: {
     type: SchemaModel<{
       id: {
-        type: _lssm_lib_schema352.FieldType<string, string>;
+        type: _lssm_lib_schema497.FieldType<string, string>;
         isOptional: false;
       };
       tenantId: {
-        type: _lssm_lib_schema352.FieldType<string, string>;
+        type: _lssm_lib_schema497.FieldType<string, string>;
         isOptional: false;
       };
       spaceKey: {
-        type: _lssm_lib_schema352.FieldType<string, string>;
+        type: _lssm_lib_schema497.FieldType<string, string>;
         isOptional: false;
       };
       spaceVersion: {
-        type: _lssm_lib_schema352.FieldType<number, number>;
+        type: _lssm_lib_schema497.FieldType<number, number>;
         isOptional: false;
       };
       label: {
-        type: _lssm_lib_schema352.FieldType<string, string>;
+        type: _lssm_lib_schema497.FieldType<string, string>;
         isOptional: false;
       };
       sourceType: {
-        type: _lssm_lib_schema352.FieldType<string, string>;
+        type: _lssm_lib_schema497.FieldType<string, string>;
         isOptional: false;
       };
       syncSchedule: {
         type: SchemaModel<{
           enabled: {
-            type: _lssm_lib_schema352.FieldType<boolean, boolean>;
+            type: _lssm_lib_schema497.FieldType<boolean, boolean>;
             isOptional: false;
           };
           cron: {
-            type: _lssm_lib_schema352.FieldType<string, string>;
+            type: _lssm_lib_schema497.FieldType<string, string>;
             isOptional: true;
           };
           intervalMs: {
-            type: _lssm_lib_schema352.FieldType<number, number>;
+            type: _lssm_lib_schema497.FieldType<number, number>;
             isOptional: true;
           };
         }>;
         isOptional: true;
       };
       lastSyncStatus: {
-        type: _lssm_lib_schema352.FieldType<string, string>;
+        type: _lssm_lib_schema497.FieldType<string, string>;
         isOptional: true;
       };
       lastSyncAt: {
-        type: _lssm_lib_schema352.FieldType<Date, string>;
+        type: _lssm_lib_schema497.FieldType<Date, string>;
         isOptional: true;
       };
       itemsProcessed: {
-        type: _lssm_lib_schema352.FieldType<number, number>;
+        type: _lssm_lib_schema497.FieldType<number, number>;
         isOptional: true;
       };
       createdAt: {
-        type: _lssm_lib_schema352.FieldType<Date, string>;
+        type: _lssm_lib_schema497.FieldType<Date, string>;
         isOptional: true;
       };
       updatedAt: {
-        type: _lssm_lib_schema352.FieldType<Date, string>;
+        type: _lssm_lib_schema497.FieldType<Date, string>;
         isOptional: true;
       };
     }>;
@@ -292,26 +292,26 @@ declare const ListKnowledgeSources: ContractSpec<SchemaModel<{
     isArray: true;
   };
 }>, undefined>;
-declare const TriggerKnowledgeSourceSync: ContractSpec<SchemaModel<{
+declare const TriggerKnowledgeSourceSync: OperationSpec<SchemaModel<{
   sourceId: {
-    type: _lssm_lib_schema352.FieldType<string, string>;
+    type: _lssm_lib_schema497.FieldType<string, string>;
     isOptional: false;
   };
 }>, SchemaModel<{
   success: {
-    type: _lssm_lib_schema352.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema497.FieldType<boolean, boolean>;
     isOptional: false;
   };
   itemsProcessed: {
-    type: _lssm_lib_schema352.FieldType<number, number>;
+    type: _lssm_lib_schema497.FieldType<number, number>;
     isOptional: true;
   };
   error: {
-    type: _lssm_lib_schema352.FieldType<string, string>;
+    type: _lssm_lib_schema497.FieldType<string, string>;
     isOptional: true;
   };
 }>, undefined>;
-declare const knowledgeContracts: Record<string, AnyContractSpec>;
-declare function registerKnowledgeContracts(registry: SpecRegistry): SpecRegistry;
+declare const knowledgeContracts: Record<string, AnyOperationSpec>;
+declare function registerKnowledgeContracts(registry: OperationSpecRegistry): OperationSpecRegistry;
 //#endregion
 export { CreateKnowledgeSource, DeleteKnowledgeSource, ListKnowledgeSources, TriggerKnowledgeSourceSync, UpdateKnowledgeSource, knowledgeContracts, registerKnowledgeContracts };

package/dist/knowledge/contracts.js

@@ -1,5 +1,5 @@
 import { E5, x8 } from "../schema/dist/index.js";
-import { defineCommand, defineQuery } from "../spec.js";
+import { defineCommand, defineQuery } from "../operation.js";
 
 //#region src/knowledge/contracts.ts
 const KnowledgeSyncSchedule = new x8({

package/dist/llm/exporters.d.ts

@@ -2,8 +2,8 @@ import { PresentationDescriptorV2 } from "../presentations.v2.js";
 import { PresentationRegistry } from "../presentations.js";
 import { DocBlock } from "../docs/types.js";
 import { EventSpec } from "../events.js";
-import { AnyContractSpec } from "../spec.js";
-import { SpecRegistry } from "../registry.js";
+import { AnyOperationSpec } from "../operation.js";
+import { OperationSpecRegistry } from "../registry.js";
 import { FeatureModuleSpec } from "../features.js";
 import { FeatureExportOptions, FeatureExportResult, SpecExportOptions, SpecExportResult } from "./types.js";
 import { AnySchemaModel } from "@lssm/lib.schema";
@@ -15,19 +15,19 @@ import { AnySchemaModel } from "@lssm/lib.schema";
  * Includes: goal, context, description, acceptance scenarios.
  * Best for: Understanding what the spec does, providing context to LLMs.
  */
-declare function specToContextMarkdown(spec: AnyContractSpec): string;
+declare function specToContextMarkdown(spec: AnyOperationSpec): string;
 /**
  * Export a single spec to full markdown with all details.
  * Includes: all fields, I/O schemas, policy, events, examples.
  * Best for: Complete documentation, implementation reference.
  */
-declare function specToFullMarkdown(spec: AnyContractSpec, options?: Partial<SpecExportOptions>): string;
+declare function specToFullMarkdown(spec: AnyOperationSpec, options?: Partial<SpecExportOptions>): string;
 /**
  * Export a single spec as an actionable agent prompt.
  * Includes: instructions, full spec, expected output format.
  * Best for: Directly feeding to coding agents for implementation.
  */
-declare function specToAgentPrompt(spec: AnyContractSpec, options?: {
+declare function specToAgentPrompt(spec: AnyOperationSpec, options?: {
   taskType?: 'implement' | 'test' | 'refactor' | 'review';
   existingCode?: string;
 }): string;
@@ -36,7 +36,7 @@ declare function specToAgentPrompt(spec: AnyContractSpec, options?: {
  * Includes all related specs, events, and presentations.
  */
 declare function featureToMarkdown(feature: FeatureModuleSpec, deps?: {
-  specs?: SpecRegistry;
+  specs?: OperationSpecRegistry;
   presentations?: PresentationRegistry;
 }, options?: Partial<FeatureExportOptions>): string;
 /**
@@ -55,12 +55,12 @@ declare function docBlockToMarkdown(doc: DocBlock): string;
  * Export a spec with a specific format.
  * Convenience function that wraps the format-specific functions.
  */
-declare function exportSpec(spec: AnyContractSpec, options?: Partial<SpecExportOptions>): SpecExportResult;
+declare function exportSpec(spec: AnyOperationSpec, options?: Partial<SpecExportOptions>): SpecExportResult;
 /**
  * Export a feature with a specific format.
  */
 declare function exportFeature(feature: FeatureModuleSpec, deps?: {
-  specs?: SpecRegistry;
+  specs?: OperationSpecRegistry;
   presentations?: PresentationRegistry;
 }, options?: Partial<FeatureExportOptions>): FeatureExportResult;
 //#endregion

package/dist/llm/exporters.js

@@ -1,5 +1,5 @@
 import { jsonSchemaForSpec } from "../jsonschema.js";
-import { isEmitDeclRef } from "../spec.js";
+import { isEmitDeclRef } from "../operation.js";
 
 //#region src/llm/exporters.ts
 const DEFAULT_SPEC_OPTIONS = {

package/dist/llm/prompts.d.ts

@@ -1,4 +1,4 @@
-import { AnyContractSpec } from "../spec.js";
+import { AnyOperationSpec } from "../operation.js";
 import { AgentPrompt, AgentType, ImplementationPlan } from "./types.js";
 
 //#region src/llm/prompts.d.ts
@@ -10,29 +10,29 @@ declare const AGENT_SYSTEM_PROMPTS: Record<AgentType, string>;
 /**
  * Generate an implementation prompt for a specific agent type.
  */
-declare function generateImplementationPrompt(spec: AnyContractSpec, agent: AgentType, options?: {
+declare function generateImplementationPrompt(spec: AnyOperationSpec, agent: AgentType, options?: {
   existingCode?: string;
   targetPath?: string;
 }): AgentPrompt;
 /**
  * Generate a test generation prompt.
  */
-declare function generateTestPrompt(spec: AnyContractSpec, agent: AgentType, options?: {
+declare function generateTestPrompt(spec: AnyOperationSpec, agent: AgentType, options?: {
   implementationCode?: string;
   testFramework?: 'vitest' | 'jest' | 'bun';
 }): AgentPrompt;
 /**
  * Generate a code review prompt.
  */
-declare function generateReviewPrompt(spec: AnyContractSpec, agent: AgentType, implementationCode: string): AgentPrompt;
+declare function generateReviewPrompt(spec: AnyOperationSpec, agent: AgentType, implementationCode: string): AgentPrompt;
 /**
  * Generate a verification prompt for AI-powered semantic review.
  */
-declare function generateVerificationPrompt(spec: AnyContractSpec, implementationCode: string): AgentPrompt;
+declare function generateVerificationPrompt(spec: AnyOperationSpec, implementationCode: string): AgentPrompt;
 /**
  * Generate a feature implementation plan.
  */
-declare function generateImplementationPlan(spec: AnyContractSpec, options?: {
+declare function generateImplementationPlan(spec: AnyOperationSpec, options?: {
   projectRoot?: string;
   existingFiles?: string[];
 }): ImplementationPlan;
@@ -43,7 +43,7 @@ declare function formatPlanForAgent(plan: ImplementationPlan, agent: AgentType):
 /**
  * Generate a fix violations prompt after verification.
  */
-declare function generateFixViolationsPrompt(spec: AnyContractSpec, implementationCode: string, violations: {
+declare function generateFixViolationsPrompt(spec: AnyOperationSpec, implementationCode: string, violations: {
   message: string;
   suggestion?: string;
 }[]): AgentPrompt;

package/dist/llm/types.d.ts

@@ -1,7 +1,7 @@
 import { PresentationDescriptorV2 } from "../presentations.v2.js";
 import { DocBlock } from "../docs/types.js";
 import { EventSpec } from "../events.js";
-import { AnyContractSpec } from "../spec.js";
+import { AnyOperationSpec } from "../operation.js";
 import { FeatureModuleSpec } from "../features.js";
 import { AnySchemaModel } from "@lssm/lib.schema";
 
@@ -40,7 +40,7 @@ interface FeatureExportOptions extends SpecExportOptions {
 /** Result of spec export */
 interface SpecExportResult {
   /** The spec that was exported */
-  spec: AnyContractSpec;
+  spec: AnyOperationSpec;
   /** Generated markdown content */
   markdown: string;
   /** Export format used */
@@ -195,7 +195,7 @@ interface BatchExportOptions extends SpecExportOptions {
 /** Exportable item types */
 type ExportableItem = {
   type: 'spec';
-  item: AnyContractSpec;
+  item: AnyOperationSpec;
 } | {
   type: 'feature';
   item: FeatureModuleSpec;

package/dist/markdown.d.ts

@@ -1,5 +1,5 @@
 import { PresentationRegistry } from "./presentations.js";
-import { SpecRegistry } from "./registry.js";
+import { OperationSpecRegistry } from "./registry.js";
 import { FeatureRegistry } from "./features.js";
 
 //#region src/markdown.d.ts
@@ -8,12 +8,12 @@ import { FeatureRegistry } from "./features.js";
  * Render simple Markdown docs for each spec.
  * Useful for dev portals and repo docs generation.
  */
-declare function specsToMarkdown(reg: SpecRegistry, _extras?: {
+declare function specsToMarkdown(reg: OperationSpecRegistry, _extras?: {
   presentations?: PresentationRegistry;
   features?: FeatureRegistry;
 }): string;
 /** Render presentations and features as additional sections. */
-declare function docsToMarkdown(reg: SpecRegistry, extras: {
+declare function docsToMarkdown(reg: OperationSpecRegistry, extras: {
   presentations?: PresentationRegistry;
   features?: FeatureRegistry;
 }): string;

package/dist/markdown.js

@@ -1,4 +1,4 @@
-import { isEmitDeclRef } from "./spec.js";
+import { isEmitDeclRef } from "./operation.js";
 
 //#region src/markdown.ts
 /**