@lssm/lib.contracts 0.0.0-canary-20251220030446 → 0.0.0-canary-20251221114240

package/dist/server/rest-next-mcp.d.ts

@@ -1,8 +1,8 @@
 import { HandlerCtx } from "../types.js";
-import { SpecRegistry } from "../registry.js";
+import { OperationSpecRegistry } from "../registry.js";
 
 //#region src/server/rest-next-mcp.d.ts
-declare function makeNextMcpServerFromRegistry(reg: SpecRegistry, ctxFactory: () => HandlerCtx): {
+declare function makeNextMcpServerFromRegistry(reg: OperationSpecRegistry, ctxFactory: () => HandlerCtx): {
   GET: (request: Request) => Promise<Response>;
   POST: (request: Request) => Promise<Response>;
   DELETE: (request: Request) => Promise<Response>;

package/dist/server/rest-next-pages.d.ts

@@ -1,9 +1,9 @@
 import { HandlerCtx } from "../types.js";
-import { SpecRegistry } from "../registry.js";
+import { OperationSpecRegistry } from "../registry.js";
 import { RestOptions } from "./rest-generic.js";
 import { NextApiRequest, NextApiResponse } from "next";
 
 //#region src/server/rest-next-pages.d.ts
-declare function makeNextPagesHandler(reg: SpecRegistry, ctxFactory: (req: NextApiRequest) => HandlerCtx, options?: RestOptions): (req: NextApiRequest, res: NextApiResponse) => Promise<void>;
+declare function makeNextPagesHandler(reg: OperationSpecRegistry, ctxFactory: (req: NextApiRequest) => HandlerCtx, options?: RestOptions): (req: NextApiRequest, res: NextApiResponse) => Promise<void>;
 //#endregion
 export { makeNextPagesHandler };

package/dist/telemetry/docs/telemetry.docblock.js

@@ -14,7 +14,7 @@ const tech_contracts_telemetry_DocBlocks = [{
 		"contracts",
 		"telemetry"
 	],
-	body: "## TelemetrySpec\n\nTelemetry specs describe product analytics in a durable, type-safe way. They reference existing `EventSpec`s (same name/version) but layer on privacy classification, retention, sampling, and anomaly detection so instrumentation stays compliant and observable.\n\n- **File location**: `packages/libs/contracts/src/telemetry/spec.ts`\n- **Runtime tracker**: `packages/libs/contracts/src/telemetry/tracker.ts`\n- **Anomaly monitor**: `packages/libs/contracts/src/telemetry/anomaly.ts`\n\n### Core concepts\n\n```ts\nexport interface TelemetrySpec {\n  meta: TelemetryMeta;\n  events: TelemetryEventDef[];\n  config?: TelemetryConfig;\n}\n```\n\n- `meta`: ownership + identifiers (`name`, `version`, `domain`)\n- `events`: per-event semantics, property definitions, privacy level, retention, sampling, anomaly rules\n- `config`: defaults and provider configuration\n- `TelemetryRegistry`: registers specs, resolves latest version, finds event definitions by name/version\n\n### An example\n\n```ts\nexport const SigilTelemetry: TelemetrySpec = {\n  meta: {\n    name: 'sigil.telemetry',\n    version: 1,\n    title: 'Sigil telemetry',\n    description: 'Core Sigil product telemetry',\n    domain: 'sigil',\n    owners: ['@team.analytics'],\n    tags: ['telemetry'],\n    stability: StabilityEnum.Experimental,\n  },\n  config: {\n    defaultRetentionDays: 30,\n    defaultSamplingRate: 1,\n    providers: [\n      { type: 'posthog', config: { projectApiKey: process.env.POSTHOG_KEY } },\n    ],\n  },\n  events: [\n    {\n      name: 'sigil.telemetry.workflow_step',\n      version: 1,\n      semantics: {\n        what: 'Workflow step executed',\n        who: 'Actor executing the workflow',\n      },\n      privacy: 'internal',\n      properties: {\n        workflow: { type: 'string', required: true },\n        step: { type: 'string', required: true },\n        durationMs: { type: 'number' },\n        userId: { type: 'string', pii: true, redact: true },\n      },\n      anomalyDetection: {\n        enabled: true,\n        minimumSample: 10,\n        thresholds: [\n          { metric: 'durationMs', max: 1500 },\n        ],\n        actions: ['alert', 'trigger_regen'],\n      },\n    },\n  ],\n};\n```\n\n### Tracking events at runtime\n\n`TelemetryTracker` performs sampling, PII redaction, provider dispatch, and anomaly detection.\n\n```ts\nconst tracker = new TelemetryTracker({\n  registry: telemetryRegistry,\n  providers: [\n    {\n      id: 'posthog',\n      async send(dispatch) {\n        posthog.capture({\n          event: dispatch.name,\n          properties: dispatch.properties,\n          distinctId: dispatch.context.userId ?? dispatch.context.sessionId,\n        });\n      },\n    },\n  ],\n  anomalyMonitor: new TelemetryAnomalyMonitor({\n    onAnomaly(event) {\n      console.warn('Telemetry anomaly detected', event);\n    },\n  }),\n});\n\nawait tracker.track('sigil.telemetry.workflow_step', 1, {\n  workflow: 'onboarding',\n  step: 'verify_email',\n  durationMs: 2100,\n  userId: 'user-123',\n});\n```\n\n- Sampling obeys the event-specific rate (fallback to spec defaults)\n- Properties flagged with `pii` or `redact` are masked before dispatch\n- Anomaly monitor evaluates thresholds and triggers actions (e.g., log, alert, regeneration)\n\n### Spec integration\n\n- `ContractSpec.telemetry` allows operations to emit success/failure events automatically\n- `SpecRegistry.execute()` uses the tracker when `ctx.telemetry` is provided\n- `WorkflowRunner` (Phase 4 follow-up) will emit telemetry during step transitions\n- `TelemetrySpec` events should reuse `EventSpec` names/versions to keep analytics/contract parity\n\n### CLI workflow\n\n```\ncontracts-cli create telemetry\n```\n\n- Interactive wizard prompts for meta, providers, events, properties, retention, anomaly rules\n- Output: `*.telemetry.ts` file using `TelemetrySpec`\n\n### Best practices\n\n- Prefer `internal` privacy for non-PII; mark PII properties explicitly with `pii` + `redact`\n- Keep sampling ≥0.05 except for high-volume events\n- Configure anomaly detection on key metrics (duration, error count, conversion)\n- Check telemetry into source control alongside contracts; regenerate via CLI when specs change\n\n### Next steps\n\n- Phase 5: Regenerator monitors telemetry anomalies to propose spec improvements\n- Phase 6: Studio surfaces telemetry controls per tenant via `TenantAppConfig`\n\n"
+	body: "## TelemetrySpec\n\nTelemetry specs describe product analytics in a durable, type-safe way. They reference existing `EventSpec`s (same name/version) but layer on privacy classification, retention, sampling, and anomaly detection so instrumentation stays compliant and observable.\n\n- **File location**: `packages/libs/contracts/src/telemetry/spec.ts`\n- **Runtime tracker**: `packages/libs/contracts/src/telemetry/tracker.ts`\n- **Anomaly monitor**: `packages/libs/contracts/src/telemetry/anomaly.ts`\n\n### Core concepts\n\n```ts\nexport interface TelemetrySpec {\n  meta: TelemetryMeta;\n  events: TelemetryEventDef[];\n  config?: TelemetryConfig;\n}\n```\n\n- `meta`: ownership + identifiers (`name`, `version`, `domain`)\n- `events`: per-event semantics, property definitions, privacy level, retention, sampling, anomaly rules\n- `config`: defaults and provider configuration\n- `TelemetryRegistry`: registers specs, resolves latest version, finds event definitions by name/version\n\n### An example\n\n```ts\nexport const SigilTelemetry: TelemetrySpec = {\n  meta: {\n    name: 'sigil.telemetry',\n    version: 1,\n    title: 'Sigil telemetry',\n    description: 'Core Sigil product telemetry',\n    domain: 'sigil',\n    owners: ['@team.analytics'],\n    tags: ['telemetry'],\n    stability: StabilityEnum.Experimental,\n  },\n  config: {\n    defaultRetentionDays: 30,\n    defaultSamplingRate: 1,\n    providers: [\n      { type: 'posthog', config: { projectApiKey: process.env.POSTHOG_KEY } },\n    ],\n  },\n  events: [\n    {\n      name: 'sigil.telemetry.workflow_step',\n      version: 1,\n      semantics: {\n        what: 'Workflow step executed',\n        who: 'Actor executing the workflow',\n      },\n      privacy: 'internal',\n      properties: {\n        workflow: { type: 'string', required: true },\n        step: { type: 'string', required: true },\n        durationMs: { type: 'number' },\n        userId: { type: 'string', pii: true, redact: true },\n      },\n      anomalyDetection: {\n        enabled: true,\n        minimumSample: 10,\n        thresholds: [\n          { metric: 'durationMs', max: 1500 },\n        ],\n        actions: ['alert', 'trigger_regen'],\n      },\n    },\n  ],\n};\n```\n\n### Tracking events at runtime\n\n`TelemetryTracker` performs sampling, PII redaction, provider dispatch, and anomaly detection.\n\n```ts\nconst tracker = new TelemetryTracker({\n  registry: telemetryRegistry,\n  providers: [\n    {\n      id: 'posthog',\n      async send(dispatch) {\n        posthog.capture({\n          event: dispatch.name,\n          properties: dispatch.properties,\n          distinctId: dispatch.context.userId ?? dispatch.context.sessionId,\n        });\n      },\n    },\n  ],\n  anomalyMonitor: new TelemetryAnomalyMonitor({\n    onAnomaly(event) {\n      console.warn('Telemetry anomaly detected', event);\n    },\n  }),\n});\n\nawait tracker.track('sigil.telemetry.workflow_step', 1, {\n  workflow: 'onboarding',\n  step: 'verify_email',\n  durationMs: 2100,\n  userId: 'user-123',\n});\n```\n\n- Sampling obeys the event-specific rate (fallback to spec defaults)\n- Properties flagged with `pii` or `redact` are masked before dispatch\n- Anomaly monitor evaluates thresholds and triggers actions (e.g., log, alert, regeneration)\n\n### Spec integration\n\n- `ContractSpec.telemetry` allows operations to emit success/failure events automatically\n- `OperationSpecRegistry.execute()` uses the tracker when `ctx.telemetry` is provided\n- `WorkflowRunner` (Phase 4 follow-up) will emit telemetry during step transitions\n- `TelemetrySpec` events should reuse `EventSpec` names/versions to keep analytics/contract parity\n\n### CLI workflow\n\n```\ncontracts-cli create telemetry\n```\n\n- Interactive wizard prompts for meta, providers, events, properties, retention, anomaly rules\n- Output: `*.telemetry.ts` file using `TelemetrySpec`\n\n### Best practices\n\n- Prefer `internal` privacy for non-PII; mark PII properties explicitly with `pii` + `redact`\n- Keep sampling ≥0.05 except for high-volume events\n- Configure anomaly detection on key metrics (duration, error count, conversion)\n- Check telemetry into source control alongside contracts; regenerate via CLI when specs change\n\n### Next steps\n\n- Phase 5: Regenerator monitors telemetry anomalies to propose spec improvements\n- Phase 6: Studio surfaces telemetry controls per tenant via `TenantAppConfig`\n\n"
 }];
 registerDocBlocks(tech_contracts_telemetry_DocBlocks);
 

package/dist/tests/runner.d.ts

@@ -1,6 +1,6 @@
 import { Assertion, TestScenario, TestSpec } from "./spec.js";
 import { HandlerCtx } from "../types.js";
-import { SpecRegistry } from "../registry.js";
+import { OperationSpecRegistry } from "../registry.js";
 import "../index.js";
 
 //#region src/tests/runner.d.ts
@@ -22,7 +22,7 @@ interface TestRunResult {
   failed: number;
 }
 interface TestRunnerConfig {
-  registry: SpecRegistry;
+  registry: OperationSpecRegistry;
   createContext?: () => HandlerCtx | Promise<HandlerCtx>;
   beforeEach?: (scenario: TestScenario) => void | Promise<void>;
   afterEach?: (scenario: TestScenario, result: ScenarioRunResult) => void | Promise<void>;

package/dist/types/all.d.ts

@@ -5,7 +5,7 @@ import { EventEnvelope, EventKey, EventSpec, defineEvent, eventKey } from "../ev
 import { ResourceMeta, ResourceRefDescriptor, ResourceRegistry, ResourceTemplateSpec, defineResourceTemplate, isResourceRef, resourceRef } from "../resources.js";
 import { AttributeMatcher, ConsentDefinition, FieldPolicyRule, PIIPolicy, PolicyCondition, PolicyEffect, PolicyMeta, PolicyOPAConfig, PolicyRef, PolicyRegistry, PolicyRule, PolicySpec, RateLimitDefinition, RelationshipDefinition, RelationshipMatcher, ResourceMatcher, SubjectMatcher, makePolicyKey } from "../policy/spec.js";
 import { Action, Assertion, CoverageRequirement, ExpectErrorAssertion, ExpectEventsAssertion, ExpectOutputAssertion, ExpectedEvent, Fixture, OperationTargetRef, TestRegistry, TestScenario, TestSpec, TestSpecMeta, TestSpecRef, TestTarget, WorkflowTargetRef, makeTestKey } from "../tests/spec.js";
-import { AnyContractSpec, ContractSpec, EmitDecl, EmitDeclInline, EmitDeclRef, ImplementationRef, ImplementationType, OpKind, TelemetryTrigger, defineCommand, defineQuery, isEmitDeclRef } from "../spec.js";
+import { AnyOperationSpec, EmitDecl, EmitDeclInline, EmitDeclRef, ImplementationRef, ImplementationType, OpKind, OperationSpec, TelemetryTrigger, defineCommand, defineQuery, isEmitDeclRef } from "../operation.js";
 import { TelemetryAnomalyAction, TelemetryAnomalyDetectionConfig, TelemetryAnomalyThreshold, TelemetryConfig, TelemetryEventDef, TelemetryMeta, TelemetryPrivacyLevel, TelemetryPropertyDef, TelemetryProviderConfig, TelemetryRegistry, TelemetryRetentionConfig, TelemetrySamplingConfig, TelemetrySpec, makeTelemetryKey } from "../telemetry/spec.js";
 import { TelemetryAnomalyEvent, TelemetryAnomalyMonitor, TelemetryAnomalyMonitorOptions } from "../telemetry/anomaly.js";
 import { RuntimeTelemetryProvider, TelemetryDispatch, TelemetryEventContext, TelemetryTracker, TelemetryTrackerOptions } from "../telemetry/tracker.js";
@@ -57,4 +57,4 @@ import { VectorIndexConfig, VectorIndexer } from "../knowledge/ingestion/vector-
 import { StorageIngestionAdapter } from "../knowledge/ingestion/storage-adapter.js";
 import { KnowledgeAnswer, KnowledgeQueryConfig, KnowledgeQueryService } from "../knowledge/query/service.js";
 import { KnowledgeAccessContext, KnowledgeAccessGuard, KnowledgeAccessGuardOptions, KnowledgeAccessResult } from "../knowledge/runtime.js";
-export { Action, ActionExecutionResult, Actor, AllocationStrategy, AnyContractSpec, AppBlueprintMeta, AppBlueprintRegistry, AppBlueprintSpec, AppComposition, AppCompositionDeps, AppIntegrationBinding, AppIntegrationSlot, AppKnowledgeBinding, AppRouteConfig, AppThemeBinding, ArrayFieldSpec, Assertion, AssertionResult, AttributeMatcher, BaseFieldSpec, BehaviorSignal, BehaviorSignalEnvelope, BehaviorSignalProvider, BlueprintTranslationCatalog, BlueprintUpdater, BrandingAssetRef, BrandingDefaults, CapabilityKind, CapabilityMeta, CapabilityRef, CapabilityRegistry, CapabilityRequirement, CapabilitySpec, CapabilitySurface, CapabilitySurfaceRef, Channel, CheckboxFieldSpec, CompensationStep, CompensationStrategy, ComponentMap, ComponentVariantDefinition, ComponentVariantSpec, ComposeOptions, ConnectionStatus, ConsentDefinition, ConstraintDecl, ConstraintHandler, ContractSpec, CoverageRequirement, CreateTenantConfigDraftCommand, DataMigrationStep, DataPresentation, DataViewAction, DataViewBaseConfig, DataViewConfig, DataViewDetailConfig, DataViewField, DataViewFieldFormat, DataViewFilter, DataViewGridConfig, DataViewKind, DataViewListConfig, DataViewMeta, DataViewRegistry, DataViewSections, DataViewSource, DataViewSpec, DataViewStates, DataViewTableColumn, DataViewTableConfig, DecisionContext, DocumentFragment, DocumentProcessor, EmbeddingService, EmitDecl, EmitDeclInline, EmitDeclRef, EnhanceFields, ErrorSignal, ErrorSignalEnvelope, ErrorSignalProvider, EventEnvelope, EventKey, EventPublisher, EventRef, EventSpec, ExecutionStatus, ExecutorProposalSink, ExecutorResultPayload, ExecutorSinkLogger, ExecutorSinkOptions, ExpectErrorAssertion, ExpectEventsAssertion, ExpectOutputAssertion, ExpectedEvent, ExperimentMeta, ExperimentOverride, ExperimentOverrideType, ExperimentRef, ExperimentRegistry, ExperimentSpec, ExperimentVariant, ExpressionContext, FeatureFlagState, FeatureModuleMeta, FeatureModuleSpec, FeatureRef, FeatureRegistry, FieldLevelDecision, FieldPolicyRule, FieldSpec, Fixture, FormAction, FormOption, FormRef, FormRegistry, FormSpec, FormValuesFor, GetResolvedBrandingQuery, GetTenantConfigVersionQuery, GroupFieldSpec, GuardCondition, GuardConditionKind, HandlerCtx, ImplementationRef, ImplementationType, IntegrationByokSetup, IntegrationCallContext, IntegrationCallError, IntegrationCallGuard, IntegrationCallGuardOptions, IntegrationCallResult, IntegrationCapabilityMapping, IntegrationCategory, IntegrationConfigSchema, IntegrationConnection, IntegrationConnectionHealth, IntegrationConnectionMeta, IntegrationContext, IntegrationHealthCheck, IntegrationInvocationStatus, IntegrationMeta, IntegrationOwnershipMode, IntegrationSecretSchema, IntegrationSpec, IntegrationSpecRegistry, IntegrationTelemetryEmitter, IntegrationTelemetryEvent, IntegrationTraceMetadata, IntegrationUsageMetrics, KnowledgeAccessContext, KnowledgeAccessGuard, KnowledgeAccessGuardOptions, KnowledgeAccessPolicy, KnowledgeAccessResult, KnowledgeAnswer, KnowledgeCategory, KnowledgeIndexingConfig, KnowledgeQueryConfig, KnowledgeQueryService, KnowledgeRetentionPolicy, KnowledgeSourceConfig, KnowledgeSourceMeta, KnowledgeSourceType, KnowledgeSpaceMeta, KnowledgeSpaceRegistry, KnowledgeSpaceSpec, ListTenantConfigVersionsQuery, Locale, MarkdownPresentation, MessageKey, MetricAggregation, MigrationCheck, MigrationExecutor, MigrationMeta, MigrationPlan, MigrationRegistry, MigrationSpec, MigrationStep, MigrationStepBase, MigrationStepKind, MissingReference, OpKind, OpRef, OperationTargetRef, OptionsSource, Owner, OwnerShipMeta, Owners, OwnersEnum, PIIPolicy, PlatformTranslationCatalog, PolicyCondition, PolicyDecider, PolicyDeciderInput, PolicyDecision, PolicyEffect, PolicyEngine, PolicyMeta, PolicyOPAConfig, PolicyRef, PolicyRegistry, PolicyRule, PolicySpec, Predicate, PredicateOp, PresentationContent, PresentationDescriptorV2, PresentationKind, PresentationMeta, PresentationPolicy, PresentationRef, PresentationRegistry, PresentationRenderer, PresentationSource, PresentationSourceBlocknotejs, PresentationSourceComponentReact, PresentationSpec, PresentationTarget, PresentationV2Meta, PresentationValidator, PromoteTenantConfigToPreviewCommand, ProposalAction, ProposalBlocker, ProposalConfidence, ProposalExecutionResult, ProposalExecutor, ProposalExecutorDeps, ProposalExecutorOptions, ProposalSink, ProposalTarget, PublishTenantConfigCommand, RadioFieldSpec, RateLimitDefinition, RateLimiter, RawDocument, ReactRenderDescriptor, RegenerationContext, RegenerationRule, RegenerationTrigger, RegeneratorOptions, RegeneratorService, RegeneratorSignal, RelationshipDefinition, RelationshipMatcher, RenderContext, ResolveAppConfigDeps, ResolveMessageQuery, ResolvedAppConfig, ResolvedBranding, ResolvedIntegration, ResolvedKnowledge, ResolvedTranslation, ResourceContext, ResourceMatcher, ResourceMeta, ResourceRefDescriptor, ResourceRegistry, ResourceTemplateSpec, RetryPolicy, RollbackTenantConfigCommand, RunMigrationsAction, RunTestsAction, RuntimeTelemetryProvider, SLA, ScenarioRunResult, SchemaMigrationStep, SelectFieldSpec, SignalAdapters, SpecChangeProposal, SpecPointer, Stability, StabilityEnum, StateStore, Step, StepAction, StepExecution, StepType, StorageIngestionAdapter, SubjectContext, SubjectMatcher, SubjectRelationship, SuccessMetric, SwitchFieldSpec, Tag, Tags, TagsEnum, TargetingRule, TelemetryAnomalyAction, TelemetryAnomalyDetectionConfig, TelemetryAnomalyEvent, TelemetryAnomalyMonitor, TelemetryAnomalyMonitorOptions, TelemetryAnomalyThreshold, TelemetryBinding, TelemetryConfig, TelemetryDispatch, TelemetryEventContext, TelemetryEventDef, TelemetryMeta, TelemetryPrivacyLevel, TelemetryPropertyDef, TelemetryProviderConfig, TelemetryRegistry, TelemetryRetentionConfig, TelemetrySamplingConfig, TelemetrySignal, TelemetrySignalEnvelope, TelemetrySignalProvider, TelemetrySpec, TelemetryTracker, TelemetryTrackerOptions, TelemetryTrigger, TenantAppConfig, TenantAppConfigMeta, TenantBrandingAsset, TenantBrandingConfig, TenantConfigUpdater, TenantRouteOverride, TenantSpecOverride, TestExecutor, TestRegistry, TestRunResult, TestRunner, TestRunnerConfig, TestScenario, TestSpec, TestSpecMeta, TestSpecRef, TestTarget, TextFieldSpec, TextareaFieldSpec, ThemeMeta, ThemeOverride, ThemeRef, ThemeRegistry, ThemeScope, ThemeSpec, ThemeToken, ThemeTokens, TransformEngine, Transition, TranslationCatalogMeta, TranslationCatalogPointer, TranslationEntry, TranslationResolver, TriggerRegenerationAction, TypedOptionsSource, TypedPredicate, TypedWhenClause, UpdateBlueprintAction, UpdateBlueprintTranslationCatalogCommand, UpdateTenantBrandingCommand, UpdateTenantConfigAction, UpdateTenantTranslationOverridesCommand, ValidateWorkflowSpecOptions, ValidationContext, ValidationIssue, ValidationMigrationStep, ValidationResult, ValidationSeverity, VectorIndexConfig, VectorIndexer, VerifyCustomDomainCommand, WebComponentPresentation, WhenClause, WorkflowDefinition, WorkflowMeta, WorkflowRegistry, WorkflowSpec, WorkflowState, WorkflowStateFilters, WorkflowStatus, WorkflowTargetRef, WorkflowValidationError, WorkflowValidationIssue, WorkflowValidationLevel, appConfigContracts, assertWorkflowSpecValid, behaviorToEnvelope, buildZodWithRelations, capabilityKey, composeAppConfig, connectionStatusLabel, createDefaultTransformEngine, dataViewKey, defaultGqlField, defaultMcpTool, defaultRestPath, defineCapability, defineCommand, defineEvent, defineFormSpec, defineQuery, defineResourceTemplate, emailThreadsKnowledgeSpace, ensureConnectionReady, errorToEnvelope, evalPredicate, evaluateExpression, eventKey, financialDocsKnowledgeSpace, financialOverviewKnowledgeSpace, installFeature, isEmitDeclRef, isResourceRef, jsonSchemaForPresentation, jsonSchemaForSpec, lifecycleContracts, makeAppBlueprintKey, makeExperimentKey, makeIntegrationSpecKey, makeKnowledgeSpaceKey, makePolicyKey, makeTelemetryKey, makeTestKey, makeThemeRef, productCanonKnowledgeSpace, registerAppConfigContracts, registerAppConfigLifecycleContracts, registerBasicValidation, registerDefaultReactRenderer, registerEmailThreadsKnowledgeSpace, registerFinancialDocsKnowledgeSpace, registerFinancialOverviewKnowledgeSpace, registerProductCanonKnowledgeSpace, registerReactToMarkdownRenderer, registerSupportFaqKnowledgeSpace, registerUploadedDocsKnowledgeSpace, resolveAppConfig, resourceRef, supportFaqKnowledgeSpace, telemetryToEnvelope, toV2FromV1, uploadedDocsKnowledgeSpace, validateBlueprint, validateConfig, validateFeatureTargetsV2, validateResolvedConfig, validateTenantConfig, validateWorkflowSpec };
+export { Action, ActionExecutionResult, Actor, AllocationStrategy, AnyOperationSpec, AppBlueprintMeta, AppBlueprintRegistry, AppBlueprintSpec, AppComposition, AppCompositionDeps, AppIntegrationBinding, AppIntegrationSlot, AppKnowledgeBinding, AppRouteConfig, AppThemeBinding, ArrayFieldSpec, Assertion, AssertionResult, AttributeMatcher, BaseFieldSpec, BehaviorSignal, BehaviorSignalEnvelope, BehaviorSignalProvider, BlueprintTranslationCatalog, BlueprintUpdater, BrandingAssetRef, BrandingDefaults, CapabilityKind, CapabilityMeta, CapabilityRef, CapabilityRegistry, CapabilityRequirement, CapabilitySpec, CapabilitySurface, CapabilitySurfaceRef, Channel, CheckboxFieldSpec, CompensationStep, CompensationStrategy, ComponentMap, ComponentVariantDefinition, ComponentVariantSpec, ComposeOptions, ConnectionStatus, ConsentDefinition, ConstraintDecl, ConstraintHandler, CoverageRequirement, CreateTenantConfigDraftCommand, DataMigrationStep, DataPresentation, DataViewAction, DataViewBaseConfig, DataViewConfig, DataViewDetailConfig, DataViewField, DataViewFieldFormat, DataViewFilter, DataViewGridConfig, DataViewKind, DataViewListConfig, DataViewMeta, DataViewRegistry, DataViewSections, DataViewSource, DataViewSpec, DataViewStates, DataViewTableColumn, DataViewTableConfig, DecisionContext, DocumentFragment, DocumentProcessor, EmbeddingService, EmitDecl, EmitDeclInline, EmitDeclRef, EnhanceFields, ErrorSignal, ErrorSignalEnvelope, ErrorSignalProvider, EventEnvelope, EventKey, EventPublisher, EventRef, EventSpec, ExecutionStatus, ExecutorProposalSink, ExecutorResultPayload, ExecutorSinkLogger, ExecutorSinkOptions, ExpectErrorAssertion, ExpectEventsAssertion, ExpectOutputAssertion, ExpectedEvent, ExperimentMeta, ExperimentOverride, ExperimentOverrideType, ExperimentRef, ExperimentRegistry, ExperimentSpec, ExperimentVariant, ExpressionContext, FeatureFlagState, FeatureModuleMeta, FeatureModuleSpec, FeatureRef, FeatureRegistry, FieldLevelDecision, FieldPolicyRule, FieldSpec, Fixture, FormAction, FormOption, FormRef, FormRegistry, FormSpec, FormValuesFor, GetResolvedBrandingQuery, GetTenantConfigVersionQuery, GroupFieldSpec, GuardCondition, GuardConditionKind, HandlerCtx, ImplementationRef, ImplementationType, IntegrationByokSetup, IntegrationCallContext, IntegrationCallError, IntegrationCallGuard, IntegrationCallGuardOptions, IntegrationCallResult, IntegrationCapabilityMapping, IntegrationCategory, IntegrationConfigSchema, IntegrationConnection, IntegrationConnectionHealth, IntegrationConnectionMeta, IntegrationContext, IntegrationHealthCheck, IntegrationInvocationStatus, IntegrationMeta, IntegrationOwnershipMode, IntegrationSecretSchema, IntegrationSpec, IntegrationSpecRegistry, IntegrationTelemetryEmitter, IntegrationTelemetryEvent, IntegrationTraceMetadata, IntegrationUsageMetrics, KnowledgeAccessContext, KnowledgeAccessGuard, KnowledgeAccessGuardOptions, KnowledgeAccessPolicy, KnowledgeAccessResult, KnowledgeAnswer, KnowledgeCategory, KnowledgeIndexingConfig, KnowledgeQueryConfig, KnowledgeQueryService, KnowledgeRetentionPolicy, KnowledgeSourceConfig, KnowledgeSourceMeta, KnowledgeSourceType, KnowledgeSpaceMeta, KnowledgeSpaceRegistry, KnowledgeSpaceSpec, ListTenantConfigVersionsQuery, Locale, MarkdownPresentation, MessageKey, MetricAggregation, MigrationCheck, MigrationExecutor, MigrationMeta, MigrationPlan, MigrationRegistry, MigrationSpec, MigrationStep, MigrationStepBase, MigrationStepKind, MissingReference, OpKind, OpRef, OperationSpec, OperationTargetRef, OptionsSource, Owner, OwnerShipMeta, Owners, OwnersEnum, PIIPolicy, PlatformTranslationCatalog, PolicyCondition, PolicyDecider, PolicyDeciderInput, PolicyDecision, PolicyEffect, PolicyEngine, PolicyMeta, PolicyOPAConfig, PolicyRef, PolicyRegistry, PolicyRule, PolicySpec, Predicate, PredicateOp, PresentationContent, PresentationDescriptorV2, PresentationKind, PresentationMeta, PresentationPolicy, PresentationRef, PresentationRegistry, PresentationRenderer, PresentationSource, PresentationSourceBlocknotejs, PresentationSourceComponentReact, PresentationSpec, PresentationTarget, PresentationV2Meta, PresentationValidator, PromoteTenantConfigToPreviewCommand, ProposalAction, ProposalBlocker, ProposalConfidence, ProposalExecutionResult, ProposalExecutor, ProposalExecutorDeps, ProposalExecutorOptions, ProposalSink, ProposalTarget, PublishTenantConfigCommand, RadioFieldSpec, RateLimitDefinition, RateLimiter, RawDocument, ReactRenderDescriptor, RegenerationContext, RegenerationRule, RegenerationTrigger, RegeneratorOptions, RegeneratorService, RegeneratorSignal, RelationshipDefinition, RelationshipMatcher, RenderContext, ResolveAppConfigDeps, ResolveMessageQuery, ResolvedAppConfig, ResolvedBranding, ResolvedIntegration, ResolvedKnowledge, ResolvedTranslation, ResourceContext, ResourceMatcher, ResourceMeta, ResourceRefDescriptor, ResourceRegistry, ResourceTemplateSpec, RetryPolicy, RollbackTenantConfigCommand, RunMigrationsAction, RunTestsAction, RuntimeTelemetryProvider, SLA, ScenarioRunResult, SchemaMigrationStep, SelectFieldSpec, SignalAdapters, SpecChangeProposal, SpecPointer, Stability, StabilityEnum, StateStore, Step, StepAction, StepExecution, StepType, StorageIngestionAdapter, SubjectContext, SubjectMatcher, SubjectRelationship, SuccessMetric, SwitchFieldSpec, Tag, Tags, TagsEnum, TargetingRule, TelemetryAnomalyAction, TelemetryAnomalyDetectionConfig, TelemetryAnomalyEvent, TelemetryAnomalyMonitor, TelemetryAnomalyMonitorOptions, TelemetryAnomalyThreshold, TelemetryBinding, TelemetryConfig, TelemetryDispatch, TelemetryEventContext, TelemetryEventDef, TelemetryMeta, TelemetryPrivacyLevel, TelemetryPropertyDef, TelemetryProviderConfig, TelemetryRegistry, TelemetryRetentionConfig, TelemetrySamplingConfig, TelemetrySignal, TelemetrySignalEnvelope, TelemetrySignalProvider, TelemetrySpec, TelemetryTracker, TelemetryTrackerOptions, TelemetryTrigger, TenantAppConfig, TenantAppConfigMeta, TenantBrandingAsset, TenantBrandingConfig, TenantConfigUpdater, TenantRouteOverride, TenantSpecOverride, TestExecutor, TestRegistry, TestRunResult, TestRunner, TestRunnerConfig, TestScenario, TestSpec, TestSpecMeta, TestSpecRef, TestTarget, TextFieldSpec, TextareaFieldSpec, ThemeMeta, ThemeOverride, ThemeRef, ThemeRegistry, ThemeScope, ThemeSpec, ThemeToken, ThemeTokens, TransformEngine, Transition, TranslationCatalogMeta, TranslationCatalogPointer, TranslationEntry, TranslationResolver, TriggerRegenerationAction, TypedOptionsSource, TypedPredicate, TypedWhenClause, UpdateBlueprintAction, UpdateBlueprintTranslationCatalogCommand, UpdateTenantBrandingCommand, UpdateTenantConfigAction, UpdateTenantTranslationOverridesCommand, ValidateWorkflowSpecOptions, ValidationContext, ValidationIssue, ValidationMigrationStep, ValidationResult, ValidationSeverity, VectorIndexConfig, VectorIndexer, VerifyCustomDomainCommand, WebComponentPresentation, WhenClause, WorkflowDefinition, WorkflowMeta, WorkflowRegistry, WorkflowSpec, WorkflowState, WorkflowStateFilters, WorkflowStatus, WorkflowTargetRef, WorkflowValidationError, WorkflowValidationIssue, WorkflowValidationLevel, appConfigContracts, assertWorkflowSpecValid, behaviorToEnvelope, buildZodWithRelations, capabilityKey, composeAppConfig, connectionStatusLabel, createDefaultTransformEngine, dataViewKey, defaultGqlField, defaultMcpTool, defaultRestPath, defineCapability, defineCommand, defineEvent, defineFormSpec, defineQuery, defineResourceTemplate, emailThreadsKnowledgeSpace, ensureConnectionReady, errorToEnvelope, evalPredicate, evaluateExpression, eventKey, financialDocsKnowledgeSpace, financialOverviewKnowledgeSpace, installFeature, isEmitDeclRef, isResourceRef, jsonSchemaForPresentation, jsonSchemaForSpec, lifecycleContracts, makeAppBlueprintKey, makeExperimentKey, makeIntegrationSpecKey, makeKnowledgeSpaceKey, makePolicyKey, makeTelemetryKey, makeTestKey, makeThemeRef, productCanonKnowledgeSpace, registerAppConfigContracts, registerAppConfigLifecycleContracts, registerBasicValidation, registerDefaultReactRenderer, registerEmailThreadsKnowledgeSpace, registerFinancialDocsKnowledgeSpace, registerFinancialOverviewKnowledgeSpace, registerProductCanonKnowledgeSpace, registerReactToMarkdownRenderer, registerSupportFaqKnowledgeSpace, registerUploadedDocsKnowledgeSpace, resolveAppConfig, resourceRef, supportFaqKnowledgeSpace, telemetryToEnvelope, toV2FromV1, uploadedDocsKnowledgeSpace, validateBlueprint, validateConfig, validateFeatureTargetsV2, validateResolvedConfig, validateTenantConfig, validateWorkflowSpec };

package/dist/workflow/validation.d.ts

@@ -1,5 +1,5 @@
 import { WorkflowSpec } from "./spec.js";
-import { SpecRegistry } from "../registry.js";
+import { OperationSpecRegistry } from "../registry.js";
 import { FormRegistry } from "../forms.js";
 
 //#region src/workflow/validation.d.ts
@@ -10,7 +10,7 @@ interface WorkflowValidationIssue {
   context?: Record<string, unknown>;
 }
 interface ValidateWorkflowSpecOptions {
-  operations?: SpecRegistry;
+  operations?: OperationSpecRegistry;
   forms?: FormRegistry;
 }
 declare class WorkflowValidationError extends Error {

package/dist/workspace-config/contractsrc-schema.d.ts

@@ -0,0 +1,188 @@
+import * as z$1 from "zod";
+
+//#region src/workspace-config/contractsrc-schema.d.ts
+
+/**
+ * OpenAPI source configuration for import/sync/validate operations.
+ */
+declare const OpenApiSourceConfigSchema: z$1.ZodObject<{
+  name: z$1.ZodString;
+  url: z$1.ZodOptional<z$1.ZodURL>;
+  file: z$1.ZodOptional<z$1.ZodString>;
+  syncMode: z$1.ZodDefault<z$1.ZodEnum<{
+    import: "import";
+    sync: "sync";
+    validate: "validate";
+  }>>;
+  tags: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
+  exclude: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
+  include: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
+  prefix: z$1.ZodOptional<z$1.ZodString>;
+  defaultStability: z$1.ZodOptional<z$1.ZodEnum<{
+    experimental: "experimental";
+    beta: "beta";
+    stable: "stable";
+    deprecated: "deprecated";
+  }>>;
+  defaultAuth: z$1.ZodOptional<z$1.ZodEnum<{
+    user: "user";
+    anonymous: "anonymous";
+    admin: "admin";
+  }>>;
+  defaultOwners: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
+}, z$1.core.$strip>;
+declare const OpenApiExportConfigSchema: z$1.ZodObject<{
+  outputPath: z$1.ZodDefault<z$1.ZodString>;
+  format: z$1.ZodDefault<z$1.ZodEnum<{
+    json: "json";
+    yaml: "yaml";
+  }>>;
+  title: z$1.ZodOptional<z$1.ZodString>;
+  version: z$1.ZodOptional<z$1.ZodString>;
+  description: z$1.ZodOptional<z$1.ZodString>;
+  servers: z$1.ZodOptional<z$1.ZodArray<z$1.ZodObject<{
+    url: z$1.ZodString;
+    description: z$1.ZodOptional<z$1.ZodString>;
+  }, z$1.core.$strip>>>;
+}, z$1.core.$strip>;
+/**
+ * OpenAPI configuration section.
+ */
+declare const OpenApiConfigSchema: z$1.ZodObject<{
+  sources: z$1.ZodOptional<z$1.ZodArray<z$1.ZodObject<{
+    name: z$1.ZodString;
+    url: z$1.ZodOptional<z$1.ZodURL>;
+    file: z$1.ZodOptional<z$1.ZodString>;
+    syncMode: z$1.ZodDefault<z$1.ZodEnum<{
+      import: "import";
+      sync: "sync";
+      validate: "validate";
+    }>>;
+    tags: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
+    exclude: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
+    include: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
+    prefix: z$1.ZodOptional<z$1.ZodString>;
+    defaultStability: z$1.ZodOptional<z$1.ZodEnum<{
+      experimental: "experimental";
+      beta: "beta";
+      stable: "stable";
+      deprecated: "deprecated";
+    }>>;
+    defaultAuth: z$1.ZodOptional<z$1.ZodEnum<{
+      user: "user";
+      anonymous: "anonymous";
+      admin: "admin";
+    }>>;
+    defaultOwners: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
+  }, z$1.core.$strip>>>;
+  export: z$1.ZodOptional<z$1.ZodObject<{
+    outputPath: z$1.ZodDefault<z$1.ZodString>;
+    format: z$1.ZodDefault<z$1.ZodEnum<{
+      json: "json";
+      yaml: "yaml";
+    }>>;
+    title: z$1.ZodOptional<z$1.ZodString>;
+    version: z$1.ZodOptional<z$1.ZodString>;
+    description: z$1.ZodOptional<z$1.ZodString>;
+    servers: z$1.ZodOptional<z$1.ZodArray<z$1.ZodObject<{
+      url: z$1.ZodString;
+      description: z$1.ZodOptional<z$1.ZodString>;
+    }, z$1.core.$strip>>>;
+  }, z$1.core.$strip>>;
+}, z$1.core.$strip>;
+/**
+ * Output directory conventions for generated specs.
+ */
+declare const FolderConventionsSchema: z$1.ZodObject<{
+  models: z$1.ZodDefault<z$1.ZodString>;
+  operations: z$1.ZodDefault<z$1.ZodString>;
+  events: z$1.ZodDefault<z$1.ZodString>;
+  presentations: z$1.ZodDefault<z$1.ZodString>;
+  forms: z$1.ZodDefault<z$1.ZodString>;
+}, z$1.core.$strip>;
+/**
+ * Full ContractSpec configuration schema (.contractsrc.json).
+ */
+declare const ContractsrcSchema: z$1.ZodObject<{
+  aiProvider: z$1.ZodDefault<z$1.ZodEnum<{
+    custom: "custom";
+    claude: "claude";
+    openai: "openai";
+    ollama: "ollama";
+  }>>;
+  aiModel: z$1.ZodOptional<z$1.ZodString>;
+  agentMode: z$1.ZodDefault<z$1.ZodEnum<{
+    cursor: "cursor";
+    "claude-code": "claude-code";
+    simple: "simple";
+    "openai-codex": "openai-codex";
+  }>>;
+  customEndpoint: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodURL>>;
+  customApiKey: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodString>>;
+  outputDir: z$1.ZodDefault<z$1.ZodString>;
+  conventions: z$1.ZodObject<{
+    models: z$1.ZodDefault<z$1.ZodString>;
+    operations: z$1.ZodDefault<z$1.ZodString>;
+    events: z$1.ZodDefault<z$1.ZodString>;
+    presentations: z$1.ZodDefault<z$1.ZodString>;
+    forms: z$1.ZodDefault<z$1.ZodString>;
+  }, z$1.core.$strip>;
+  defaultOwners: z$1.ZodDefault<z$1.ZodArray<z$1.ZodString>>;
+  defaultTags: z$1.ZodDefault<z$1.ZodArray<z$1.ZodString>>;
+  packages: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
+  excludePackages: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
+  recursive: z$1.ZodOptional<z$1.ZodBoolean>;
+  openapi: z$1.ZodOptional<z$1.ZodObject<{
+    sources: z$1.ZodOptional<z$1.ZodArray<z$1.ZodObject<{
+      name: z$1.ZodString;
+      url: z$1.ZodOptional<z$1.ZodURL>;
+      file: z$1.ZodOptional<z$1.ZodString>;
+      syncMode: z$1.ZodDefault<z$1.ZodEnum<{
+        import: "import";
+        sync: "sync";
+        validate: "validate";
+      }>>;
+      tags: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
+      exclude: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
+      include: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
+      prefix: z$1.ZodOptional<z$1.ZodString>;
+      defaultStability: z$1.ZodOptional<z$1.ZodEnum<{
+        experimental: "experimental";
+        beta: "beta";
+        stable: "stable";
+        deprecated: "deprecated";
+      }>>;
+      defaultAuth: z$1.ZodOptional<z$1.ZodEnum<{
+        user: "user";
+        anonymous: "anonymous";
+        admin: "admin";
+      }>>;
+      defaultOwners: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
+    }, z$1.core.$strip>>>;
+    export: z$1.ZodOptional<z$1.ZodObject<{
+      outputPath: z$1.ZodDefault<z$1.ZodString>;
+      format: z$1.ZodDefault<z$1.ZodEnum<{
+        json: "json";
+        yaml: "yaml";
+      }>>;
+      title: z$1.ZodOptional<z$1.ZodString>;
+      version: z$1.ZodOptional<z$1.ZodString>;
+      description: z$1.ZodOptional<z$1.ZodString>;
+      servers: z$1.ZodOptional<z$1.ZodArray<z$1.ZodObject<{
+        url: z$1.ZodString;
+        description: z$1.ZodOptional<z$1.ZodString>;
+      }, z$1.core.$strip>>>;
+    }, z$1.core.$strip>>;
+  }, z$1.core.$strip>>;
+}, z$1.core.$strip>;
+type OpenApiSourceConfig = z$1.infer<typeof OpenApiSourceConfigSchema>;
+type OpenApiExportConfig = z$1.infer<typeof OpenApiExportConfigSchema>;
+type OpenApiConfig = z$1.infer<typeof OpenApiConfigSchema>;
+type FolderConventions = z$1.infer<typeof FolderConventionsSchema>;
+type ContractsrcConfig = z$1.infer<typeof ContractsrcSchema>;
+/**
+ * Default configuration values.
+ */
+declare const DEFAULT_CONTRACTSRC: ContractsrcConfig;
+//#endregion
+export { ContractsrcConfig, ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventions, FolderConventionsSchema, OpenApiConfig, OpenApiConfigSchema, OpenApiExportConfig, OpenApiExportConfigSchema, OpenApiSourceConfig, OpenApiSourceConfigSchema };

package/dist/workspace-config/contractsrc-schema.js

@@ -0,0 +1,114 @@
+import * as z$1 from "zod";
+
+//#region src/workspace-config/contractsrc-schema.ts
+/**
+* ContractSpec configuration schema definitions.
+*
+* These schemas define the structure of .contractsrc.json files
+* and are shared across CLI tools and libraries.
+*/
+/**
+* OpenAPI source configuration for import/sync/validate operations.
+*/
+const OpenApiSourceConfigSchema = z$1.object({
+	name: z$1.string(),
+	url: z$1.url().optional(),
+	file: z$1.string().optional(),
+	syncMode: z$1.enum([
+		"import",
+		"sync",
+		"validate"
+	]).default("validate"),
+	tags: z$1.array(z$1.string()).optional(),
+	exclude: z$1.array(z$1.string()).optional(),
+	include: z$1.array(z$1.string()).optional(),
+	prefix: z$1.string().optional(),
+	defaultStability: z$1.enum([
+		"experimental",
+		"beta",
+		"stable",
+		"deprecated"
+	]).optional(),
+	defaultAuth: z$1.enum([
+		"anonymous",
+		"user",
+		"admin"
+	]).optional(),
+	defaultOwners: z$1.array(z$1.string()).optional()
+});
+const OpenApiExportConfigSchema = z$1.object({
+	outputPath: z$1.string().default("./openapi.json"),
+	format: z$1.enum(["json", "yaml"]).default("json"),
+	title: z$1.string().optional(),
+	version: z$1.string().optional(),
+	description: z$1.string().optional(),
+	servers: z$1.array(z$1.object({
+		url: z$1.string(),
+		description: z$1.string().optional()
+	})).optional()
+});
+/**
+* OpenAPI configuration section.
+*/
+const OpenApiConfigSchema = z$1.object({
+	sources: z$1.array(OpenApiSourceConfigSchema).optional(),
+	export: OpenApiExportConfigSchema.optional()
+});
+/**
+* Output directory conventions for generated specs.
+*/
+const FolderConventionsSchema = z$1.object({
+	models: z$1.string().default("models"),
+	operations: z$1.string().default("operations/commands|queries"),
+	events: z$1.string().default("events"),
+	presentations: z$1.string().default("presentations"),
+	forms: z$1.string().default("forms")
+});
+/**
+* Full ContractSpec configuration schema (.contractsrc.json).
+*/
+const ContractsrcSchema = z$1.object({
+	aiProvider: z$1.enum([
+		"claude",
+		"openai",
+		"ollama",
+		"custom"
+	]).default("claude"),
+	aiModel: z$1.string().optional(),
+	agentMode: z$1.enum([
+		"simple",
+		"cursor",
+		"claude-code",
+		"openai-codex"
+	]).default("simple"),
+	customEndpoint: z$1.url().nullable().optional(),
+	customApiKey: z$1.string().nullable().optional(),
+	outputDir: z$1.string().default("./src"),
+	conventions: FolderConventionsSchema,
+	defaultOwners: z$1.array(z$1.string()).default([]),
+	defaultTags: z$1.array(z$1.string()).default([]),
+	packages: z$1.array(z$1.string()).optional(),
+	excludePackages: z$1.array(z$1.string()).optional(),
+	recursive: z$1.boolean().optional(),
+	openapi: OpenApiConfigSchema.optional()
+});
+/**
+* Default configuration values.
+*/
+const DEFAULT_CONTRACTSRC = {
+	aiProvider: "claude",
+	agentMode: "simple",
+	outputDir: "./src",
+	conventions: {
+		models: "models",
+		operations: "interactions/commands|queries",
+		events: "events",
+		presentations: "presentations",
+		forms: "forms"
+	},
+	defaultOwners: [],
+	defaultTags: []
+};
+
+//#endregion
+export { ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventionsSchema, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema };

package/dist/workspace-config/index.d.ts

@@ -0,0 +1,2 @@
+import { ContractsrcConfig, ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventions, FolderConventionsSchema, OpenApiConfig, OpenApiConfigSchema, OpenApiExportConfig, OpenApiExportConfigSchema, OpenApiSourceConfig, OpenApiSourceConfigSchema } from "./contractsrc-schema.js";
+export { type ContractsrcConfig, ContractsrcSchema, DEFAULT_CONTRACTSRC, type FolderConventions, FolderConventionsSchema, type OpenApiConfig, OpenApiConfigSchema, type OpenApiExportConfig, OpenApiExportConfigSchema, type OpenApiSourceConfig, OpenApiSourceConfigSchema };

package/dist/workspace-config/index.js

@@ -0,0 +1,3 @@
+import { ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventionsSchema, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema } from "./contractsrc-schema.js";
+
+export { ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventionsSchema, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/lib.contracts",
-  "version": "0.0.0-canary-20251220030446",
+  "version": "0.0.0-canary-20251221114240",
   "scripts": {
     "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
     "publish:pkg:canary": "bun publish:pkg --tag canary",
@@ -16,8 +16,8 @@
     "test": "bun run"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.0.0-canary-20251220030446",
-    "@lssm/tool.typescript": "0.0.0-canary-20251220030446",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251221114240",
+    "@lssm/tool.typescript": "0.0.0-canary-20251221114240",
     "@types/express": "^5.0.3",
     "@types/turndown": "^5.0.6",
     "tsdown": "^0.18.1",
@@ -35,8 +35,8 @@
     "@elevenlabs/elevenlabs-js": "^2.27.0",
     "@google-cloud/secret-manager": "^6.1.1",
     "@google-cloud/storage": "^7.18.0",
-    "@lssm/lib.logger": "0.0.0-canary-20251220030446",
-    "@lssm/lib.schema": "0.0.0-canary-20251220030446",
+    "@lssm/lib.logger": "0.0.0-canary-20251221114240",
+    "@lssm/lib.schema": "0.0.0-canary-20251221114240",
     "@mistralai/mistralai": "^1.11.0",
     "@modelcontextprotocol/sdk": "^1.24.3",
     "@qdrant/js-client-rest": "^1.16.2",
@@ -249,6 +249,7 @@
     "./onboarding-base": "./dist/onboarding-base.js",
     "./openapi": "./dist/openapi.js",
     "./openbanking/docs/openbanking.docblock": "./dist/openbanking/docs/openbanking.docblock.js",
+    "./operation": "./dist/operation.js",
     "./ownership": "./dist/ownership.js",
     "./policy/docs/policy.docblock": "./dist/policy/docs/policy.docblock.js",
     "./policy/engine": "./dist/policy/engine.js",
@@ -286,7 +287,6 @@
     "./server/rest-next-app": "./dist/server/rest-next-app.js",
     "./server/rest-next-mcp": "./dist/server/rest-next-mcp.js",
     "./server/rest-next-pages": "./dist/server/rest-next-pages.js",
-    "./spec": "./dist/spec.js",
     "./telemetry": "./dist/telemetry/index.js",
     "./telemetry/anomaly": "./dist/telemetry/anomaly.js",
     "./telemetry/docs/telemetry.docblock": "./dist/telemetry/docs/telemetry.docblock.js",
@@ -311,6 +311,8 @@
     "./workflow/spec": "./dist/workflow/spec.js",
     "./workflow/state": "./dist/workflow/state.js",
     "./workflow/validation": "./dist/workflow/validation.js",
+    "./workspace-config": "./dist/workspace-config/index.js",
+    "./workspace-config/contractsrc-schema": "./dist/workspace-config/contractsrc-schema.js",
     "./*": "./*"
   },
   "publishConfig": {
@@ -320,11 +322,11 @@
       "./app-config": "./dist/app-config/index.js",
       "./app-config/app-config.feature": "./dist/app-config/app-config.feature.js",
       "./app-config/branding": "./dist/app-config/branding.js",
-      "./app-config/contracts": "./dist/app-config/contracts.js",
+      "./app-config/contracts": "./dist/app-config/operations.js",
       "./app-config/docs/app-config.docblock": "./dist/app-config/docs/app-config.docblock.js",
       "./app-config/events": "./dist/app-config/events.js",
       "./app-config/lifecycle": "./dist/app-config/lifecycle.js",
-      "./app-config/lifecycle-contracts": "./dist/app-config/lifecycle-contracts.js",
+      "./app-config/lifecycle-contracts": "./dist/app-config/lifecycle-operations.js",
       "./app-config/runtime": "./dist/app-config/runtime.js",
       "./app-config/spec": "./dist/app-config/spec.js",
       "./app-config/validation": "./dist/app-config/validation.js",
@@ -400,7 +402,7 @@
       "./integrations": "./dist/integrations/index.js",
       "./integrations/binding": "./dist/integrations/binding.js",
       "./integrations/connection": "./dist/integrations/connection.js",
-      "./integrations/contracts": "./dist/integrations/contracts.js",
+      "./integrations/contracts": "./dist/integrations/operations.js",
       "./integrations/docs/integrations.docblock": "./dist/integrations/docs/integrations.docblock.js",
       "./integrations/health": "./dist/integrations/health.js",
       "./integrations/openbanking/contracts": "./dist/integrations/openbanking/contracts/index.js",
@@ -471,7 +473,7 @@
       "./jsonschema": "./dist/jsonschema.js",
       "./knowledge": "./dist/knowledge/index.js",
       "./knowledge/binding": "./dist/knowledge/binding.js",
-      "./knowledge/contracts": "./dist/knowledge/contracts.js",
+      "./knowledge/contracts": "./dist/knowledge/operations.js",
       "./knowledge/docs/knowledge.docblock": "./dist/knowledge/docs/knowledge.docblock.js",
       "./knowledge/ingestion": "./dist/knowledge/ingestion/index.js",
       "./knowledge/ingestion/document-processor": "./dist/knowledge/ingestion/document-processor.js",
@@ -537,7 +539,7 @@
       "./server/rest-next-app": "./dist/server/rest-next-app.js",
       "./server/rest-next-mcp": "./dist/server/rest-next-mcp.js",
       "./server/rest-next-pages": "./dist/server/rest-next-pages.js",
-      "./spec": "./dist/spec.js",
+      "./operation": "./dist/operation.js",
       "./telemetry": "./dist/telemetry/index.js",
       "./telemetry/anomaly": "./dist/telemetry/anomaly.js",
       "./telemetry/docs/telemetry.docblock": "./dist/telemetry/docs/telemetry.docblock.js",