@lssm/bundle.contractspec-workspace 0.0.0-canary-20251217052941 → 0.0.0-canary-20251217060433

package/dist/templates/migration.template.d.ts

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

package/dist/templates/operation.template.d.ts

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

package/dist/templates/presentation.template.d.ts

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

package/dist/templates/telemetry.template.d.ts

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

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

@@ -0,0 +1,15 @@
+//#region src/templates/workflow-runner.template.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.template.d.ts

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

package/dist/types/config.d.ts

@@ -0,0 +1,33 @@
+//#region src/types/config.d.ts
+/**
+ * Configuration types for ContractSpec workspace.
+ */
+/**
+ * AI provider types.
+ */
+type AiProvider = 'claude' | 'openai' | 'ollama' | 'custom';
+/**
+ * Agent mode types.
+ */
+type AgentMode = 'simple' | 'cursor' | 'claude-code' | 'openai-codex';
+/**
+ * Configuration for ContractSpec CLI and services.
+ */
+interface Config {
+  aiProvider: AiProvider;
+  aiModel?: string;
+  agentMode: AgentMode;
+  customEndpoint?: string | null;
+  customApiKey?: string | null;
+  outputDir: string;
+  conventions: {
+    operations: string;
+    events: string;
+    presentations: string;
+    forms: string;
+  };
+  defaultOwners: string[];
+  defaultTags: string[];
+}
+//#endregion
+export { AgentMode, AiProvider, Config };

package/dist/types.d.ts

@@ -0,0 +1,323 @@
+//#region src/types.d.ts
+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;
+}
+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;
+}
+interface IntegrationSecretFieldData extends 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, DataViewSpecData, EventSpecData, ExperimentSpecData, IntegrationSpecData, KnowledgeSpaceSpecData, MigrationSpecData, OpKind, OperationSpecData, PresentationKind, PresentationSpecData, TelemetrySpecData, WorkflowSpecData };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/bundle.contractspec-workspace",
-  "version": "0.0.0-canary-20251217052941",
+  "version": "0.0.0-canary-20251217060433",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -23,26 +23,26 @@
     "test": "bun run"
   },
   "dependencies": {
-    "@lssm/module.contractspec-workspace": "0.0.0-canary-20251217052941",
-    "@lssm/lib.contracts": "0.0.0-canary-20251217052941",
-    "@lssm/lib.contracts-transformers": "0.0.0-canary-20251217052941",
-    "@lssm/lib.ai-providers": "0.0.0-canary-20251217052941",
-    "@lssm/lib.schema": "0.0.0-canary-20251217052941",
-    "@lssm/lib.testing": "0.0.0-canary-20251217052941",
+    "@lssm/module.contractspec-workspace": "0.0.0-canary-20251217060433",
+    "@lssm/lib.contracts": "0.0.0-canary-20251217060433",
+    "@lssm/lib.contracts-transformers": "0.0.0-canary-20251217060433",
+    "@lssm/lib.ai-providers": "0.0.0-canary-20251217060433",
+    "@lssm/lib.schema": "0.0.0-canary-20251217060433",
+    "@lssm/lib.testing": "0.0.0-canary-20251217060433",
     "ai": "beta",
     "zod": "^4.1.13",
     "glob": "^13.0.0",
     "chokidar": "^4.0.1"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217052941",
-    "@lssm/tool.typescript": "0.0.0-canary-20251217052941",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251217060433",
+    "@lssm/tool.typescript": "0.0.0-canary-20251217060433",
     "@types/node": "^22.10.2",
     "tsdown": "^0.17.4",
     "typescript": "^5.9.3"
   },
   "exports": {
-    ".": "./src/index.ts",
+    ".": "./dist/index.js",
     "./*": "./*"
   },
   "publishConfig": {