@lssm/module.contractspec-workspace 0.0.0-canary-20251217083314 → 1.41.1

package/dist/templates/handler.d.ts

@@ -1,19 +0,0 @@
-//#region src/templates/handler.d.ts
-/**
- * Handler and component template generation.
- * Extracted from cli-contracts/src/templates/handler.template.ts
- */
-/**
- * Generate handler implementation template.
- */
-declare function generateHandlerTemplate(specName: string, kind: 'command' | 'query'): string;
-/**
- * Generate React component template.
- */
-declare function generateComponentTemplate(componentName: string, description: string): string;
-/**
- * Generate test template.
- */
-declare function generateTestTemplate(targetName: string, type: 'handler' | 'component'): string;
-//#endregion
-export { generateComponentTemplate, generateHandlerTemplate, generateTestTemplate };

package/dist/templates/integration.d.ts

@@ -1,6 +0,0 @@
-import { IntegrationSpecData } from "../types/spec-types.js";
-
-//#region src/templates/integration.d.ts
-declare function generateIntegrationSpec(data: IntegrationSpecData): string;
-//#endregion
-export { generateIntegrationSpec };

package/dist/templates/knowledge.d.ts

@@ -1,6 +0,0 @@
-import { KnowledgeSpaceSpecData } from "../types/spec-types.js";
-
-//#region src/templates/knowledge.d.ts
-declare function generateKnowledgeSpaceSpec(data: KnowledgeSpaceSpecData): string;
-//#endregion
-export { generateKnowledgeSpaceSpec };

package/dist/templates/migration.d.ts

@@ -1,6 +0,0 @@
-import { MigrationSpecData } from "../types/spec-types.js";
-
-//#region src/templates/migration.d.ts
-declare function generateMigrationSpec(data: MigrationSpecData): string;
-//#endregion
-export { generateMigrationSpec };

package/dist/templates/operation.d.ts

@@ -1,10 +0,0 @@
-import { OperationSpecData } from "../types/spec-types.js";
-
-//#region src/templates/operation.d.ts
-
-/**
- * Generate operation spec TypeScript code.
- */
-declare function generateOperationSpec(data: OperationSpecData): string;
-//#endregion
-export { generateOperationSpec };

package/dist/templates/presentation.d.ts

@@ -1,10 +0,0 @@
-import { PresentationSpecData } from "../types/spec-types.js";
-
-//#region src/templates/presentation.d.ts
-
-/**
- * Generate presentation spec TypeScript code.
- */
-declare function generatePresentationSpec(data: PresentationSpecData): string;
-//#endregion
-export { generatePresentationSpec };

package/dist/templates/telemetry.d.ts

@@ -1,6 +0,0 @@
-import { TelemetrySpecData } from "../types/spec-types.js";
-
-//#region src/templates/telemetry.d.ts
-declare function generateTelemetrySpec(data: TelemetrySpecData): string;
-//#endregion
-export { generateTelemetrySpec };

package/dist/templates/utils.d.ts

@@ -1,26 +0,0 @@
-//#region src/templates/utils.d.ts
-/**
- * Utility functions for template generation.
- */
-/**
- * Convert string to camelCase.
- */
-declare function toCamelCase(str: string): string;
-/**
- * Convert string to PascalCase.
- */
-declare function toPascalCase(str: string): string;
-/**
- * Convert string to kebab-case.
- */
-declare function toKebabCase(str: string): string;
-/**
- * Capitalize first letter.
- */
-declare function capitalize(str: string): string;
-/**
- * Escape single quotes in string.
- */
-declare function escapeString(value: string): string;
-//#endregion
-export { capitalize, escapeString, toCamelCase, toKebabCase, toPascalCase };

package/dist/templates/workflow-runner.d.ts

@@ -1,15 +0,0 @@
-//#region src/templates/workflow-runner.d.ts
-interface RunnerTemplateOptions {
-  exportName: string;
-  specImportPath: string;
-  runnerName: string;
-  workflowName: string;
-}
-declare function generateWorkflowRunnerTemplate({
-  exportName,
-  specImportPath,
-  runnerName,
-  workflowName
-}: RunnerTemplateOptions): string;
-//#endregion
-export { generateWorkflowRunnerTemplate };

package/dist/templates/workflow.d.ts

@@ -1,10 +0,0 @@
-import { WorkflowSpecData } from "../types/spec-types.js";
-
-//#region src/templates/workflow.d.ts
-
-/**
- * Generate workflow spec TypeScript code.
- */
-declare function generateWorkflowSpec(data: WorkflowSpecData): string;
-//#endregion
-export { generateWorkflowSpec };

package/dist/types/analysis-types.d.ts

@@ -1,125 +0,0 @@
-import { Stability } from "./spec-types.js";
-
-//#region src/types/analysis-types.d.ts
-
-/**
- * Spec type detected from file analysis.
- * Covers all contract types from @lssm/lib.contracts.
- */
-type AnalyzedSpecType = 'operation' | 'event' | 'presentation' | 'feature' | 'capability' | 'data-view' | 'form' | 'migration' | 'workflow' | 'experiment' | 'integration' | 'knowledge' | 'telemetry' | 'app-config' | 'policy' | 'test-spec' | 'unknown';
-/**
- * Types that can be referenced by features.
- */
-type RefType = 'operation' | 'event' | 'presentation' | 'capability' | 'experiment' | 'policy' | 'test';
-/**
- * Operation kind detected from file analysis.
- */
-type AnalyzedOperationKind = 'command' | 'query' | 'unknown';
-/**
- * Reference information (name + version).
- */
-interface RefInfo {
-  name: string;
-  version: number;
-}
-/**
- * A reference extracted from source code with location context.
- */
-interface ExtractedRef {
-  type: RefType;
-  name: string;
-  version: number;
-  sourceFile: string;
-  sourceLine?: number;
-}
-/**
- * Result of scanning a spec source file.
- */
-interface SpecScanResult {
-  filePath: string;
-  specType: AnalyzedSpecType;
-  name?: string;
-  version?: number;
-  kind?: AnalyzedOperationKind;
-  stability?: Stability;
-  description?: string;
-  owners?: string[];
-  tags?: string[];
-  hasMeta: boolean;
-  hasIo: boolean;
-  hasPolicy: boolean;
-  hasPayload: boolean;
-  hasContent: boolean;
-  hasDefinition: boolean;
-  emittedEvents?: RefInfo[];
-  policyRefs?: RefInfo[];
-  testRefs?: RefInfo[];
-}
-/**
- * Result of scanning a feature file.
- */
-interface FeatureScanResult {
-  filePath: string;
-  key: string;
-  title?: string;
-  description?: string;
-  domain?: string;
-  stability?: Stability;
-  owners?: string[];
-  tags?: string[];
-  operations: RefInfo[];
-  events: RefInfo[];
-  presentations: RefInfo[];
-  experiments: RefInfo[];
-  capabilities: {
-    provides: RefInfo[];
-    requires: RefInfo[];
-  };
-  opToPresentationLinks: {
-    op: RefInfo;
-    pres: RefInfo;
-  }[];
-}
-/**
- * Semantic diff item types.
- */
-type SemanticDiffType = 'breaking' | 'changed' | 'added' | 'removed';
-/**
- * A single semantic difference between two specs.
- */
-interface SemanticDiffItem {
-  type: SemanticDiffType;
-  path: string;
-  oldValue?: unknown;
-  newValue?: unknown;
-  description: string;
-}
-/**
- * Options for semantic diff computation.
- */
-interface SemanticDiffOptions {
-  breakingOnly?: boolean;
-}
-/**
- * A node in the contract dependency graph.
- */
-interface ContractNode {
-  name: string;
-  file: string;
-  dependencies: string[];
-  dependents: string[];
-}
-/**
- * The contract dependency graph.
- */
-type ContractGraph = Map<string, ContractNode>;
-/**
- * Result of spec structure validation.
- */
-interface ValidationResult {
-  valid: boolean;
-  errors: string[];
-  warnings: string[];
-}
-//#endregion
-export { AnalyzedOperationKind, AnalyzedSpecType, ContractGraph, ContractNode, ExtractedRef, FeatureScanResult, RefInfo, RefType, SemanticDiffItem, SemanticDiffOptions, SemanticDiffType, SpecScanResult, ValidationResult };

package/dist/types/generation-types.d.ts

@@ -1,83 +0,0 @@
-import { OpKind, PresentationKind, SpecType } from "./spec-types.js";
-
-//#region src/types/generation-types.d.ts
-
-/**
- * AI provider options for generation.
- */
-interface AIGenerationOptions {
-  provider: 'claude' | 'openai' | 'ollama' | 'custom';
-  model?: string;
-  endpoint?: string;
-  stream?: boolean;
-}
-/**
- * Result of code generation.
- */
-interface GenerationResult {
-  code: string;
-  filePath: string;
-  specType: SpecType;
-}
-/**
- * Build target types.
- */
-type GenerationTarget = 'handler' | 'component' | 'form';
-/**
- * Test target types.
- */
-type TestTarget = 'handler' | 'component';
-/**
- * Spec build type detected during build.
- */
-type SpecBuildType = 'operation' | 'presentation' | 'form' | 'event' | 'workflow' | 'data-view' | 'telemetry' | 'migration' | 'experiment' | 'app-config' | 'integration' | 'knowledge' | 'unknown';
-/**
- * Configuration for workspace operations.
- */
-interface WorkspaceConfig {
-  aiProvider: 'claude' | 'openai' | 'ollama' | 'custom';
-  aiModel?: string;
-  agentMode: 'simple' | 'cursor' | 'claude-code' | 'openai-codex';
-  customEndpoint?: string | null;
-  customApiKey?: string | null;
-  outputDir: string;
-  conventions: {
-    operations: string;
-    events: string;
-    presentations: string;
-    forms: string;
-    workflows?: string;
-    'data-views'?: string;
-    dataViews?: string;
-    migrations?: string;
-    telemetry?: string;
-    experiments?: string;
-    appConfig?: string;
-    integrations?: string;
-    knowledge?: string;
-  };
-  defaultOwners: string[];
-  defaultTags: string[];
-}
-/**
- * Default workspace configuration.
- */
-declare const DEFAULT_WORKSPACE_CONFIG: WorkspaceConfig;
-/**
- * AI prompt context for spec generation.
- */
-interface SpecGenerationContext {
-  description: string;
-  kind?: OpKind;
-  presentationKind?: PresentationKind;
-}
-/**
- * AI prompt context for code generation.
- */
-interface CodeGenerationContext {
-  specCode: string;
-  targetPath?: string;
-  existingCode?: string;
-}
-//#endregion
-export { AIGenerationOptions, CodeGenerationContext, DEFAULT_WORKSPACE_CONFIG, GenerationResult, GenerationTarget, SpecBuildType, SpecGenerationContext, TestTarget, WorkspaceConfig };

package/dist/types/spec-types.d.ts

@@ -1,344 +0,0 @@
-//#region src/types/spec-types.d.ts
-/**
- * Core spec type definitions.
- * Extracted from cli-contracts/src/types.ts
- */
-type SpecType = 'operation' | 'event' | 'presentation' | 'form' | 'feature' | 'workflow' | 'data-view' | 'migration' | 'telemetry' | 'experiment' | 'app-config' | 'integration' | 'knowledge';
-type OpKind = 'command' | 'query';
-type PresentationKind = 'web_component' | 'markdown' | 'data';
-type Stability = 'experimental' | 'beta' | 'stable' | 'deprecated';
-type StepType = 'human' | 'automation' | 'decision';
-interface BaseSpecData {
-  name: string;
-  version: number;
-  description: string;
-  owners: string[];
-  tags: string[];
-  stability: Stability;
-}
-interface OperationSpecData extends BaseSpecData {
-  kind: OpKind;
-  goal: string;
-  context: string;
-  hasInput: boolean;
-  hasOutput: boolean;
-  auth: 'anonymous' | 'user' | 'admin';
-  flags: string[];
-  emitsEvents: boolean;
-}
-interface EventSpecData extends BaseSpecData {
-  piiFields: string[];
-}
-interface PresentationSpecData extends BaseSpecData {
-  presentationKind: PresentationKind;
-}
-type FormSpecData = BaseSpecData;
-interface FeatureSpecData extends BaseSpecData {
-  key: string;
-  operations: {
-    name: string;
-    version: number;
-  }[];
-  events: {
-    name: string;
-    version: number;
-  }[];
-  presentations: {
-    name: string;
-    version: number;
-  }[];
-}
-interface WorkflowStepData {
-  id: string;
-  label: string;
-  type: StepType;
-  description?: string;
-  operation?: {
-    name: string;
-    version: number;
-  };
-  form?: {
-    key: string;
-    version: number;
-  };
-}
-interface WorkflowTransitionData {
-  from: string;
-  to: string;
-  condition?: string;
-}
-interface WorkflowSpecData extends BaseSpecData {
-  title: string;
-  domain: string;
-  entryStepId?: string;
-  steps: WorkflowStepData[];
-  transitions: WorkflowTransitionData[];
-  policyFlags: string[];
-}
-type DataViewKind = 'list' | 'detail' | 'table' | 'grid';
-interface DataViewFieldData {
-  key: string;
-  label: string;
-  dataPath: string;
-  format?: string;
-  sortable?: boolean;
-  filterable?: boolean;
-}
-interface DataViewSpecData extends BaseSpecData {
-  title: string;
-  domain: string;
-  entity: string;
-  kind: DataViewKind;
-  primaryOperation: {
-    name: string;
-    version: number;
-  };
-  itemOperation?: {
-    name: string;
-    version: number;
-  };
-  fields: DataViewFieldData[];
-  primaryField?: string;
-  secondaryFields?: string[];
-}
-type TelemetryPrivacy = 'public' | 'internal' | 'pii' | 'sensitive';
-interface TelemetryPropertyData {
-  name: string;
-  type: 'string' | 'number' | 'boolean' | 'timestamp' | 'json';
-  required?: boolean;
-  pii?: boolean;
-  redact?: boolean;
-  description?: string;
-}
-interface TelemetryAnomalyRuleData {
-  metric: string;
-  min?: number;
-  max?: number;
-}
-interface TelemetryEventData {
-  name: string;
-  version: number;
-  what: string;
-  who?: string;
-  why?: string;
-  privacy: TelemetryPrivacy;
-  properties: TelemetryPropertyData[];
-  retentionDays?: number;
-  retentionPolicy?: 'archive' | 'delete';
-  samplingRate?: number;
-  samplingConditions?: string;
-  anomalyEnabled?: boolean;
-  anomalyMinimumSample?: number;
-  anomalyRules?: TelemetryAnomalyRuleData[];
-  anomalyActions?: ('alert' | 'log' | 'trigger_regen')[];
-  tags?: string[];
-}
-interface TelemetryProviderData {
-  type: 'posthog' | 'segment' | 'opentelemetry' | 'internal';
-  config: string;
-}
-interface TelemetrySpecData extends BaseSpecData {
-  domain: string;
-  defaultRetentionDays?: number;
-  defaultSamplingRate?: number;
-  providers?: TelemetryProviderData[];
-  anomalyEnabled?: boolean;
-  anomalyCheckIntervalMs?: number;
-  events: TelemetryEventData[];
-}
-interface ExperimentVariantOverrideData {
-  type: 'dataView' | 'workflow' | 'theme' | 'policy' | 'presentation';
-  target: string;
-  version?: number;
-}
-interface ExperimentVariantData {
-  id: string;
-  name: string;
-  description?: string;
-  weight?: number;
-  overrides?: ExperimentVariantOverrideData[];
-}
-interface TargetingRuleData {
-  variantId: string;
-  percentage?: number;
-  policy?: {
-    name: string;
-    version?: number;
-  };
-  expression?: string;
-}
-interface RandomAllocationData {
-  type: 'random';
-  salt?: string;
-}
-interface StickyAllocationData {
-  type: 'sticky';
-  attribute: 'userId' | 'organizationId' | 'sessionId';
-  salt?: string;
-}
-interface TargetedAllocationData {
-  type: 'targeted';
-  fallback?: 'control' | 'random';
-  rules: TargetingRuleData[];
-}
-type ExperimentAllocationData = RandomAllocationData | StickyAllocationData | TargetedAllocationData;
-interface ExperimentMetricData {
-  name: string;
-  eventName: string;
-  eventVersion: number;
-  aggregation: 'count' | 'avg' | 'p75' | 'p90' | 'p95' | 'p99';
-  target?: number;
-}
-interface ExperimentSpecData extends BaseSpecData {
-  domain: string;
-  controlVariant: string;
-  variants: ExperimentVariantData[];
-  allocation: ExperimentAllocationData;
-  successMetrics?: ExperimentMetricData[];
-}
-interface AppConfigMappingData {
-  slot: string;
-  name: string;
-  version?: number;
-}
-interface AppConfigFeatureFlagData {
-  key: string;
-  enabled: boolean;
-  variant?: string;
-  description?: string;
-}
-interface AppRouteConfigData {
-  path: string;
-  label?: string;
-  dataView?: string;
-  workflow?: string;
-  guardName?: string;
-  guardVersion?: number;
-  featureFlag?: string;
-  experimentName?: string;
-  experimentVersion?: number;
-}
-interface AppBlueprintSpecData extends BaseSpecData {
-  title: string;
-  domain: string;
-  appId: string;
-  capabilitiesEnabled: string[];
-  capabilitiesDisabled: string[];
-  featureIncludes: string[];
-  featureExcludes: string[];
-  dataViews: AppConfigMappingData[];
-  workflows: AppConfigMappingData[];
-  policyRefs: {
-    name: string;
-    version?: number;
-  }[];
-  theme?: {
-    name: string;
-    version: number;
-  };
-  themeFallbacks: {
-    name: string;
-    version: number;
-  }[];
-  telemetry?: {
-    name: string;
-    version?: number;
-  };
-  activeExperiments: {
-    name: string;
-    version?: number;
-  }[];
-  pausedExperiments: {
-    name: string;
-    version?: number;
-  }[];
-  featureFlags: AppConfigFeatureFlagData[];
-  routes: AppRouteConfigData[];
-  notes?: string;
-}
-type MigrationStepKind = 'schema' | 'data' | 'validation';
-interface MigrationStepData {
-  kind: MigrationStepKind;
-  description?: string;
-  sql?: string;
-  script?: string;
-  assertion?: string;
-  timeoutMs?: number;
-  retries?: number;
-  preChecks?: {
-    description: string;
-    expression: string;
-  }[];
-  postChecks?: {
-    description: string;
-    expression: string;
-  }[];
-}
-interface MigrationSpecData extends BaseSpecData {
-  title: string;
-  domain: string;
-  dependencies: string[];
-  up: MigrationStepData[];
-  down?: MigrationStepData[];
-}
-type IntegrationCategoryData = 'payments' | 'email' | 'calendar' | 'sms' | 'ai-llm' | 'ai-voice' | 'speech-to-text' | 'vector-db' | 'storage' | 'accounting' | 'crm' | 'helpdesk' | 'open-banking' | 'custom';
-type IntegrationConfigFieldType = 'string' | 'number' | 'boolean';
-type IntegrationOwnershipModeData = 'managed' | 'byok';
-type IntegrationHealthCheckMethod = 'ping' | 'list' | 'custom';
-interface IntegrationCapabilityRefData {
-  key: string;
-  version: number;
-}
-interface IntegrationCapabilityRequirementData {
-  key: string;
-  version?: number;
-  optional?: boolean;
-  reason?: string;
-}
-interface IntegrationConfigFieldData {
-  key: string;
-  type: IntegrationConfigFieldType;
-  required: boolean;
-  description?: string;
-}
-type IntegrationSecretFieldData = IntegrationConfigFieldData;
-interface IntegrationSpecData extends BaseSpecData {
-  title: string;
-  domain: string;
-  displayName: string;
-  category: IntegrationCategoryData;
-  supportedModes: IntegrationOwnershipModeData[];
-  capabilitiesProvided: IntegrationCapabilityRefData[];
-  capabilitiesRequired: IntegrationCapabilityRequirementData[];
-  configFields: IntegrationConfigFieldData[];
-  secretFields: IntegrationSecretFieldData[];
-  docsUrl?: string;
-  rateLimitRpm?: number;
-  rateLimitRph?: number;
-  healthCheckMethod: IntegrationHealthCheckMethod;
-  healthCheckTimeoutMs?: number;
-  byokSetupInstructions?: string;
-  byokRequiredScopes?: string[];
-}
-type KnowledgeCategoryData = 'canonical' | 'operational' | 'external' | 'ephemeral';
-type KnowledgeTrustLevel = 'high' | 'medium' | 'low';
-interface KnowledgeRetentionData {
-  ttlDays?: number | null;
-  archiveAfterDays?: number;
-}
-interface KnowledgeSpaceSpecData extends BaseSpecData {
-  title: string;
-  domain: string;
-  displayName: string;
-  category: KnowledgeCategoryData;
-  retention: KnowledgeRetentionData;
-  policyName?: string;
-  policyVersion?: number;
-  trustLevel: KnowledgeTrustLevel;
-  automationWritable: boolean;
-  embeddingModel?: string;
-  chunkSize?: number;
-  vectorDbIntegration?: string;
-}
-//#endregion
-export { AppBlueprintSpecData, AppConfigFeatureFlagData, AppConfigMappingData, AppRouteConfigData, BaseSpecData, DataViewFieldData, DataViewKind, DataViewSpecData, EventSpecData, ExperimentAllocationData, ExperimentMetricData, ExperimentSpecData, ExperimentVariantData, ExperimentVariantOverrideData, FeatureSpecData, FormSpecData, IntegrationCapabilityRefData, IntegrationCapabilityRequirementData, IntegrationCategoryData, IntegrationConfigFieldData, IntegrationConfigFieldType, IntegrationHealthCheckMethod, IntegrationOwnershipModeData, IntegrationSecretFieldData, IntegrationSpecData, KnowledgeCategoryData, KnowledgeRetentionData, KnowledgeSpaceSpecData, KnowledgeTrustLevel, MigrationSpecData, MigrationStepData, MigrationStepKind, OpKind, OperationSpecData, PresentationKind, PresentationSpecData, RandomAllocationData, SpecType, Stability, StepType, StickyAllocationData, TargetedAllocationData, TargetingRuleData, TelemetryAnomalyRuleData, TelemetryEventData, TelemetryPrivacy, TelemetryPropertyData, TelemetryProviderData, TelemetrySpecData, WorkflowSpecData, WorkflowStepData, WorkflowTransitionData };