@contractspec/module.workspace 0.0.0-canary-20260113162409

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+import { 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, OperationSpecData, PresentationKind, PresentationSpecData, RandomAllocationData, SpecType, Stability, StepType, StickyAllocationData, TargetedAllocationData, TargetingRuleData, TelemetryAnomalyRuleData, TelemetryEventData, TelemetryPrivacy, TelemetryPropertyData, TelemetryProviderData, TelemetrySpecData, WorkflowSpecData, WorkflowStepData, WorkflowTransitionData } from "./types/spec-types.js";
+import { AnalyzedOperationKind, AnalyzedSpecType, ContractGraph, ContractNode, ExampleScanResult, ExtractedRef, ExtractedTestTarget, FeatureScanResult, RefInfo, RefType, SemanticDiffItem, SemanticDiffOptions, SemanticDiffType, SpecScanResult, ValidationResult } from "./types/analysis-types.js";
+import { RuleSyncConfig } from "./types/rulesync-types.js";
+import { AIGenerationOptions, CodeGenerationContext, DEFAULT_WORKSPACE_CONFIG, GenerationResult, GenerationTarget, SpecBuildType, SpecGenerationContext, TestTarget, WorkspaceConfig } from "./types/generation-types.js";
+import { AgentType, LLMExportFormat, LLMExportResult, ParsedSpec, ParsedSpecMeta, SpecRef, SpecToMarkdownOptions, VerificationIssue, VerificationResult, VerificationTier } from "./types/llm-types.js";
+import { extractTestCoverage, extractTestTarget } from "./analysis/spec-parsing-utils.js";
+import { inferSpecTypeFromFilePath, scanAllSpecsFromSource, scanSpecSource } from "./analysis/spec-scan.js";
+import { isFeatureFile, scanFeatureSource } from "./analysis/feature-scan.js";
+import { isExampleFile, scanExampleSource } from "./analysis/example-scan.js";
+import { GroupKeyFn, GroupedItems, SpecFilter, SpecGroupingStrategies, filterFeatures, filterSpecs, getUniqueSpecDomains, getUniqueSpecOwners, getUniqueSpecTags, groupSpecs, groupSpecsToArray } from "./analysis/grouping.js";
+import { computeSemanticDiff } from "./analysis/diff/semantic.js";
+import { ContractSnapshot, EventSnapshot, FieldSnapshot, FieldType, HttpBindingSnapshot, IoSnapshot, OperationSnapshot, SnapshotOptions, SpecSnapshot } from "./analysis/snapshot/types.js";
+import { DeepDiffOptions, computeFieldDiff, computeFieldsDiff, computeIoDiff, isBreakingChange } from "./analysis/diff/deep-diff.js";
+import { addContractNode, buildReverseEdges, createContractGraph, detectCycles, findMissingDependencies, toDot } from "./analysis/deps/graph.js";
+import { parseImportedSpecNames } from "./analysis/deps/parse-imports.js";
+import { RuleSeverity, RulesConfig, SpecKind, validateSpecStructure } from "./analysis/validate/spec-structure.js";
+import { computeHash, normalizeValue, sortFields, sortSpecs, toCanonicalJson } from "./analysis/snapshot/normalizer.js";
+import { generateSnapshot } from "./analysis/snapshot/snapshot.js";
+import { ClassifyOptions, ImpactDelta, ImpactResult, ImpactRule, ImpactSeverity, ImpactStatus, ImpactSummary } from "./analysis/impact/types.js";
+import { BREAKING_RULES, DEFAULT_RULES, INFO_RULES, NON_BREAKING_RULES, findMatchingRule, getRulesBySeverity } from "./analysis/impact/rules.js";
+import { classifyImpact } from "./analysis/impact/classifier.js";
+import { loadSpecFromSource } from "./analysis/spec-parser.js";
+import { generateOperationSpec } from "./templates/operation.js";
+import { generateEventSpec } from "./templates/event.js";
+import { generatePresentationSpec } from "./templates/presentation.js";
+import { generateWorkflowSpec } from "./templates/workflow.js";
+import { generateWorkflowRunnerTemplate } from "./templates/workflow-runner.js";
+import { generateDataViewSpec } from "./templates/data-view.js";
+import { generateTelemetrySpec } from "./templates/telemetry.js";
+import { generateExperimentSpec } from "./templates/experiment.js";
+import { generateAppBlueprintSpec } from "./templates/app-config.js";
+import { generateMigrationSpec } from "./templates/migration.js";
+import { generateIntegrationSpec } from "./templates/integration.js";
+import { generateKnowledgeSpaceSpec } from "./templates/knowledge.js";
+import { generateComponentTemplate, generateHandlerTemplate, generateTestTemplate } from "./templates/handler.js";
+import { capitalize, escapeString, toCamelCase, toKebabCase, toPascalCase } from "./templates/utils.js";
+import { addExampleContext, buildEventSpecPrompt, buildOperationSpecPrompt, buildPresentationSpecPrompt, getSystemPrompt } from "./ai/prompts/spec-creation.js";
+import { buildComponentPrompt, buildFormPrompt, buildHandlerPrompt, buildTestPrompt, getCodeGenSystemPrompt } from "./ai/prompts/code-generation.js";
+import { FormatLogger, FormatResult, FormatterOptions, detectFormatter, formatFiles, formatFilesBatch } from "./formatter.js";
+import { combineSpecMarkdowns, generateSpecsSummaryHeader, specToMarkdown, specToMarkdownWithOptions } from "./formatters/spec-markdown.js";
+import { convertSpecToDocBlock } from "./formatters/spec-to-docblock.js";
+export { AIGenerationOptions, AgentType, AnalyzedOperationKind, AnalyzedSpecType, AppBlueprintSpecData, AppConfigFeatureFlagData, AppConfigMappingData, AppRouteConfigData, BREAKING_RULES, BaseSpecData, ClassifyOptions, CodeGenerationContext, ContractGraph, ContractNode, ContractSnapshot, DEFAULT_RULES, DEFAULT_WORKSPACE_CONFIG, DataViewFieldData, DataViewKind, DataViewSpecData, DeepDiffOptions, EventSnapshot, EventSpecData, ExampleScanResult, ExperimentAllocationData, ExperimentMetricData, ExperimentSpecData, ExperimentVariantData, ExperimentVariantOverrideData, ExtractedRef, ExtractedTestTarget, FeatureScanResult, FeatureSpecData, FieldSnapshot, FieldType, FormSpecData, FormatLogger, FormatResult, FormatterOptions, GenerationResult, GenerationTarget, GroupKeyFn, GroupedItems, HttpBindingSnapshot, INFO_RULES, ImpactDelta, ImpactResult, ImpactRule, ImpactSeverity, ImpactStatus, ImpactSummary, IntegrationCapabilityRefData, IntegrationCapabilityRequirementData, IntegrationCategoryData, IntegrationConfigFieldData, IntegrationConfigFieldType, IntegrationHealthCheckMethod, IntegrationOwnershipModeData, IntegrationSecretFieldData, IntegrationSpecData, IoSnapshot, KnowledgeCategoryData, KnowledgeRetentionData, KnowledgeSpaceSpecData, KnowledgeTrustLevel, LLMExportFormat, LLMExportResult, MigrationSpecData, MigrationStepData, MigrationStepKind, NON_BREAKING_RULES, OperationSnapshot, OperationSpecData, ParsedSpec, ParsedSpecMeta, PresentationKind, PresentationSpecData, RandomAllocationData, RefInfo, RefType, RuleSeverity, RuleSyncConfig, RulesConfig, SemanticDiffItem, SemanticDiffOptions, SemanticDiffType, SnapshotOptions, SpecBuildType, SpecFilter, SpecGenerationContext, SpecGroupingStrategies, SpecKind, SpecRef, SpecScanResult, SpecSnapshot, SpecToMarkdownOptions, SpecType, Stability, StepType, StickyAllocationData, TargetedAllocationData, TargetingRuleData, TelemetryAnomalyRuleData, TelemetryEventData, TelemetryPrivacy, TelemetryPropertyData, TelemetryProviderData, TelemetrySpecData, TestTarget, ValidationResult, VerificationIssue, VerificationResult, VerificationTier, WorkflowSpecData, WorkflowStepData, WorkflowTransitionData, WorkspaceConfig, addContractNode, addExampleContext, buildComponentPrompt, buildEventSpecPrompt, buildFormPrompt, buildHandlerPrompt, buildOperationSpecPrompt, buildPresentationSpecPrompt, buildReverseEdges, buildTestPrompt, capitalize, classifyImpact, combineSpecMarkdowns, computeFieldDiff, computeFieldsDiff, computeHash, computeIoDiff, computeSemanticDiff, convertSpecToDocBlock, createContractGraph, detectCycles, detectFormatter, escapeString, extractTestCoverage, extractTestTarget, filterFeatures, filterSpecs, findMatchingRule, findMissingDependencies, formatFiles, formatFilesBatch, generateAppBlueprintSpec, generateComponentTemplate, generateDataViewSpec, generateEventSpec, generateExperimentSpec, generateHandlerTemplate, generateIntegrationSpec, generateKnowledgeSpaceSpec, generateMigrationSpec, generateOperationSpec, generatePresentationSpec, generateSnapshot, generateSpecsSummaryHeader, generateTelemetrySpec, generateTestTemplate, generateWorkflowRunnerTemplate, generateWorkflowSpec, getCodeGenSystemPrompt, getRulesBySeverity, getSystemPrompt, getUniqueSpecDomains, getUniqueSpecOwners, getUniqueSpecTags, groupSpecs, groupSpecsToArray, inferSpecTypeFromFilePath, isBreakingChange, isExampleFile, isFeatureFile, loadSpecFromSource, normalizeValue, parseImportedSpecNames, scanAllSpecsFromSource, scanExampleSource, scanFeatureSource, scanSpecSource, sortFields, sortSpecs, specToMarkdown, specToMarkdownWithOptions, toCamelCase, toCanonicalJson, toDot, toKebabCase, toPascalCase, validateSpecStructure };

package/dist/index.js

@@ -0,0 +1,39 @@
+import { DEFAULT_WORKSPACE_CONFIG } from "./types/generation-types.js";
+import { extractTestCoverage, extractTestTarget } from "./analysis/spec-parsing-utils.js";
+import { inferSpecTypeFromFilePath, scanAllSpecsFromSource, scanSpecSource } from "./analysis/spec-scan.js";
+import { isFeatureFile, scanFeatureSource } from "./analysis/feature-scan.js";
+import { isExampleFile, scanExampleSource } from "./analysis/example-scan.js";
+import { SpecGroupingStrategies, filterFeatures, filterSpecs, getUniqueSpecDomains, getUniqueSpecOwners, getUniqueSpecTags, groupSpecs, groupSpecsToArray } from "./analysis/grouping.js";
+import { computeSemanticDiff } from "./analysis/diff/semantic.js";
+import { computeFieldDiff, computeFieldsDiff, computeIoDiff, isBreakingChange } from "./analysis/diff/deep-diff.js";
+import { addContractNode, buildReverseEdges, createContractGraph, detectCycles, findMissingDependencies, toDot } from "./analysis/deps/graph.js";
+import { parseImportedSpecNames } from "./analysis/deps/parse-imports.js";
+import { validateSpecStructure } from "./analysis/validate/spec-structure.js";
+import { computeHash, normalizeValue, sortFields, sortSpecs, toCanonicalJson } from "./analysis/snapshot/normalizer.js";
+import { generateSnapshot } from "./analysis/snapshot/snapshot.js";
+import { BREAKING_RULES, DEFAULT_RULES, INFO_RULES, NON_BREAKING_RULES, findMatchingRule, getRulesBySeverity } from "./analysis/impact/rules.js";
+import { classifyImpact } from "./analysis/impact/classifier.js";
+import { loadSpecFromSource } from "./analysis/spec-parser.js";
+import "./analysis/index.js";
+import { capitalize, escapeString, toCamelCase, toKebabCase, toPascalCase } from "./templates/utils.js";
+import { generateOperationSpec } from "./templates/operation.js";
+import { generateEventSpec } from "./templates/event.js";
+import { generatePresentationSpec } from "./templates/presentation.js";
+import { generateWorkflowSpec } from "./templates/workflow.js";
+import { generateWorkflowRunnerTemplate } from "./templates/workflow-runner.js";
+import { generateDataViewSpec } from "./templates/data-view.js";
+import { generateTelemetrySpec } from "./templates/telemetry.js";
+import { generateExperimentSpec } from "./templates/experiment.js";
+import { generateAppBlueprintSpec } from "./templates/app-config.js";
+import { generateMigrationSpec } from "./templates/migration.js";
+import { generateIntegrationSpec } from "./templates/integration.js";
+import { generateKnowledgeSpaceSpec } from "./templates/knowledge.js";
+import { generateComponentTemplate, generateHandlerTemplate, generateTestTemplate } from "./templates/handler.js";
+import { addExampleContext, buildEventSpecPrompt, buildOperationSpecPrompt, buildPresentationSpecPrompt, getSystemPrompt } from "./ai/prompts/spec-creation.js";
+import { buildComponentPrompt, buildFormPrompt, buildHandlerPrompt, buildTestPrompt, getCodeGenSystemPrompt } from "./ai/prompts/code-generation.js";
+import { detectFormatter, formatFiles, formatFilesBatch } from "./formatter.js";
+import { combineSpecMarkdowns, generateSpecsSummaryHeader, specToMarkdown, specToMarkdownWithOptions } from "./formatters/spec-markdown.js";
+import { convertSpecToDocBlock } from "./formatters/spec-to-docblock.js";
+import "./formatters/index.js";
+
+export { BREAKING_RULES, DEFAULT_RULES, DEFAULT_WORKSPACE_CONFIG, INFO_RULES, NON_BREAKING_RULES, SpecGroupingStrategies, addContractNode, addExampleContext, buildComponentPrompt, buildEventSpecPrompt, buildFormPrompt, buildHandlerPrompt, buildOperationSpecPrompt, buildPresentationSpecPrompt, buildReverseEdges, buildTestPrompt, capitalize, classifyImpact, combineSpecMarkdowns, computeFieldDiff, computeFieldsDiff, computeHash, computeIoDiff, computeSemanticDiff, convertSpecToDocBlock, createContractGraph, detectCycles, detectFormatter, escapeString, extractTestCoverage, extractTestTarget, filterFeatures, filterSpecs, findMatchingRule, findMissingDependencies, formatFiles, formatFilesBatch, generateAppBlueprintSpec, generateComponentTemplate, generateDataViewSpec, generateEventSpec, generateExperimentSpec, generateHandlerTemplate, generateIntegrationSpec, generateKnowledgeSpaceSpec, generateMigrationSpec, generateOperationSpec, generatePresentationSpec, generateSnapshot, generateSpecsSummaryHeader, generateTelemetrySpec, generateTestTemplate, generateWorkflowRunnerTemplate, generateWorkflowSpec, getCodeGenSystemPrompt, getRulesBySeverity, getSystemPrompt, getUniqueSpecDomains, getUniqueSpecOwners, getUniqueSpecTags, groupSpecs, groupSpecsToArray, inferSpecTypeFromFilePath, isBreakingChange, isExampleFile, isFeatureFile, loadSpecFromSource, normalizeValue, parseImportedSpecNames, scanAllSpecsFromSource, scanExampleSource, scanFeatureSource, scanSpecSource, sortFields, sortSpecs, specToMarkdown, specToMarkdownWithOptions, toCamelCase, toCanonicalJson, toDot, toKebabCase, toPascalCase, validateSpecStructure };

package/dist/templates/app-config.d.ts

@@ -0,0 +1,7 @@
+import { AppBlueprintSpecData } from "../types/spec-types.js";
+
+//#region src/templates/app-config.d.ts
+declare function generateAppBlueprintSpec(data: AppBlueprintSpecData): string;
+//#endregion
+export { generateAppBlueprintSpec };
+//# sourceMappingURL=app-config.d.ts.map

package/dist/templates/app-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-config.d.ts","names":[],"sources":["../../src/templates/app-config.ts"],"sourcesContent":[],"mappings":";;;iBAGgB,wBAAA,OAA+B"}

package/dist/templates/app-config.js

@@ -0,0 +1,107 @@
+import { toPascalCase } from "./utils.js";
+
+//#region src/templates/app-config.ts
+function generateAppBlueprintSpec(data) {
+	const exportName = toPascalCase(data.name.split(".").pop() ?? "App") + "AppConfig";
+	const capabilitiesSection = buildCapabilitiesSection(data);
+	const featuresSection = buildFeaturesSection(data);
+	const dataViewsSection = buildMappingSection("dataViews", data.dataViews);
+	const workflowsSection = buildMappingSection("workflows", data.workflows);
+	const policiesSection = buildPolicySection(data);
+	const themeSection = buildThemeSection(data);
+	const telemetrySection = buildTelemetrySection(data);
+	const experimentsSection = buildExperimentsSection(data);
+	const flagsSection = buildFeatureFlagsSection(data);
+	const routesSection = buildRoutesSection(data);
+	const notesSection = data.notes ? `  notes: '${escapeString(data.notes)}',\n` : "";
+	return `import type { AppBlueprintSpec } from '@contractspec/lib.contracts/app-config';
+
+export const ${exportName}: AppBlueprintSpec = {
+  meta: {
+    key: '${escapeString(data.name)}',
+    version: '${data.version}',
+    title: '${escapeString(data.title)}',
+    description: '${escapeString(data.description)}',
+    domain: '${escapeString(data.domain)}',
+    owners: [${data.owners.map((owner) => `'${escapeString(owner)}'`).join(", ")}],
+    tags: [${data.tags.map((tag) => `'${escapeString(tag)}'`).join(", ")}],
+    stability: '${data.stability}',
+    appId: '${escapeString(data.appId)}',
+  },
+${capabilitiesSection}${featuresSection}${dataViewsSection}${workflowsSection}${policiesSection}${themeSection}${telemetrySection}${experimentsSection}${flagsSection}${routesSection}${notesSection}};\n`;
+}
+function buildCapabilitiesSection(data) {
+	if (data.capabilitiesEnabled.length === 0 && data.capabilitiesDisabled.length === 0) return "";
+	return `  capabilities: {\n${data.capabilitiesEnabled.length > 0 ? `    enabled: [${data.capabilitiesEnabled.map((key) => formatCapabilityRef(key)).join(", ")}],\n` : ""}${data.capabilitiesDisabled.length > 0 ? `    disabled: [${data.capabilitiesDisabled.map((key) => formatCapabilityRef(key)).join(", ")}],\n` : ""}  },\n`;
+}
+function buildFeaturesSection(data) {
+	if (data.featureIncludes.length === 0 && data.featureExcludes.length === 0) return "";
+	return `  features: {\n${data.featureIncludes.length > 0 ? `    include: [${data.featureIncludes.map((key) => `{ key: '${escapeString(key)}' }`).join(", ")}],\n` : ""}${data.featureExcludes.length > 0 ? `    exclude: [${data.featureExcludes.map((key) => `{ key: '${escapeString(key)}' }`).join(", ")}],\n` : ""}  },\n`;
+}
+function buildMappingSection(prop, mappings) {
+	if (mappings.length === 0) return "";
+	return `  ${prop}: {\n${mappings.map((mapping) => `    ${mapping.slot}: {
+      name: '${escapeString(mapping.name)}',
+      version: '${mapping.version}',
+    }`).join(",\n")}\n  },\n`;
+}
+function buildPolicySection(data) {
+	if (data.policyRefs.length === 0) return "";
+	return `  policies: [\n${data.policyRefs.map((policy) => `    {
+      name: '${escapeString(policy.name)}',
+      version: '${policy.version}',
+    }`).join(",\n")}\n  ],\n`;
+}
+function buildThemeSection(data) {
+	if (!data.theme) return "";
+	return `  theme: {\n${`    primary: { name: '${escapeString(data.theme.name)}', version: ${data.theme.version} },\n`}${data.themeFallbacks.length > 0 ? `    fallbacks: [${data.themeFallbacks.map((theme) => `{ name: '${escapeString(theme.name)}', version: '${theme.version}' }`).join(", ")}],\n` : ""}  },\n`;
+}
+function buildTelemetrySection(data) {
+	if (!data.telemetry) return "";
+	return `  telemetry: {
+    spec: {
+      name: '${escapeString(data.telemetry.name)}'${data.telemetry.version !== void 0 ? `,\n      version: '${data.telemetry.version}'` : ""}
+    },
+  },\n`;
+}
+function buildExperimentsSection(data) {
+	if (data.activeExperiments.length === 0 && data.pausedExperiments.length === 0) return "";
+	return `  experiments: {\n${data.activeExperiments.length > 0 ? `    active: [${data.activeExperiments.map((exp) => formatExperimentRef(exp)).join(", ")}],\n` : ""}${data.pausedExperiments.length > 0 ? `    paused: [${data.pausedExperiments.map((exp) => formatExperimentRef(exp)).join(", ")}],\n` : ""}  },\n`;
+}
+function buildFeatureFlagsSection(data) {
+	if (data.featureFlags.length === 0) return "";
+	return `  featureFlags: [\n${data.featureFlags.map((flag) => `    {
+      key: '${escapeString(flag.key)}',
+      enabled: ${flag.enabled},
+      ${flag.variant ? `variant: '${escapeString(flag.variant)}',` : ""}
+      ${flag.description ? `description: '${escapeString(flag.description)}',` : ""}
+    }`).join(",\n")}\n  ],\n`;
+}
+function buildRoutesSection(data) {
+	if (data.routes.length === 0) return "";
+	return `  routes: [\n${data.routes.map((route) => {
+		return `    { ${[
+			`path: '${escapeString(route.path)}'`,
+			route.label ? `label: '${escapeString(route.label)}'` : null,
+			route.dataView ? `dataView: '${escapeString(route.dataView)}'` : null,
+			route.workflow ? `workflow: '${escapeString(route.workflow)}'` : null,
+			route.guardName ? `guard: { name: '${escapeString(route.guardName)}'${route.guardVersion !== void 0 ? `, version: '${route.guardVersion}'` : ""} }` : null,
+			route.featureFlag ? `featureFlag: '${escapeString(route.featureFlag)}'` : null,
+			route.experimentName ? `experiment: { name: '${escapeString(route.experimentName)}'${route.experimentVersion !== void 0 ? `, version: '${route.experimentVersion}'` : ""} }` : null
+		].filter(Boolean).join(", ")} }`;
+	}).join(",\n")}\n  ],\n`;
+}
+function formatCapabilityRef(key) {
+	return `{ key: '${escapeString(key)}' }`;
+}
+function formatExperimentRef(exp) {
+	const version = typeof exp.version === "string" ? `, version: ${exp.version}` : "";
+	return `{ name: '${escapeString(exp.name)}'${version} }`;
+}
+function escapeString(value) {
+	return value.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+}
+
+//#endregion
+export { generateAppBlueprintSpec };
+//# sourceMappingURL=app-config.js.map

package/dist/templates/app-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-config.js","names":[],"sources":["../../src/templates/app-config.ts"],"sourcesContent":["import type { AppBlueprintSpecData } from '../types/spec-types';\nimport { toPascalCase } from './utils';\n\nexport function generateAppBlueprintSpec(data: AppBlueprintSpecData): string {\n  const exportName =\n    toPascalCase(data.name.split('.').pop() ?? 'App') + 'AppConfig';\n\n  const capabilitiesSection = buildCapabilitiesSection(data);\n  const featuresSection = buildFeaturesSection(data);\n  const dataViewsSection = buildMappingSection('dataViews', data.dataViews);\n  const workflowsSection = buildMappingSection('workflows', data.workflows);\n  const policiesSection = buildPolicySection(data);\n  const themeSection = buildThemeSection(data);\n  const telemetrySection = buildTelemetrySection(data);\n  const experimentsSection = buildExperimentsSection(data);\n  const flagsSection = buildFeatureFlagsSection(data);\n  const routesSection = buildRoutesSection(data);\n  const notesSection = data.notes\n    ? `  notes: '${escapeString(data.notes)}',\\n`\n    : '';\n\n  return `import type { AppBlueprintSpec } from '@contractspec/lib.contracts/app-config';\n\nexport const ${exportName}: AppBlueprintSpec = {\n  meta: {\n    key: '${escapeString(data.name)}',\n    version: '${data.version}',\n    title: '${escapeString(data.title)}',\n    description: '${escapeString(data.description)}',\n    domain: '${escapeString(data.domain)}',\n    owners: [${data.owners.map((owner) => `'${escapeString(owner)}'`).join(', ')}],\n    tags: [${data.tags.map((tag) => `'${escapeString(tag)}'`).join(', ')}],\n    stability: '${data.stability}',\n    appId: '${escapeString(data.appId)}',\n  },\n${capabilitiesSection}${featuresSection}${dataViewsSection}${workflowsSection}${policiesSection}${themeSection}${telemetrySection}${experimentsSection}${flagsSection}${routesSection}${notesSection}};\\n`;\n}\n\nfunction buildCapabilitiesSection(data: AppBlueprintSpecData): string {\n  if (\n    data.capabilitiesEnabled.length === 0 &&\n    data.capabilitiesDisabled.length === 0\n  ) {\n    return '';\n  }\n  const enabled =\n    data.capabilitiesEnabled.length > 0\n      ? `    enabled: [${data.capabilitiesEnabled.map((key) => formatCapabilityRef(key)).join(', ')}],\\n`\n      : '';\n  const disabled =\n    data.capabilitiesDisabled.length > 0\n      ? `    disabled: [${data.capabilitiesDisabled.map((key) => formatCapabilityRef(key)).join(', ')}],\\n`\n      : '';\n  return `  capabilities: {\\n${enabled}${disabled}  },\\n`;\n}\n\nfunction buildFeaturesSection(data: AppBlueprintSpecData): string {\n  if (data.featureIncludes.length === 0 && data.featureExcludes.length === 0) {\n    return '';\n  }\n  const include =\n    data.featureIncludes.length > 0\n      ? `    include: [${data.featureIncludes.map((key) => `{ key: '${escapeString(key)}' }`).join(', ')}],\\n`\n      : '';\n  const exclude =\n    data.featureExcludes.length > 0\n      ? `    exclude: [${data.featureExcludes.map((key) => `{ key: '${escapeString(key)}' }`).join(', ')}],\\n`\n      : '';\n  return `  features: {\\n${include}${exclude}  },\\n`;\n}\n\nfunction buildMappingSection(\n  prop: 'dataViews' | 'workflows',\n  mappings: AppBlueprintSpecData['dataViews']\n): string {\n  if (mappings.length === 0) return '';\n  const body = mappings\n    .map(\n      (mapping) => `    ${mapping.slot}: {\n      name: '${escapeString(mapping.name)}',\n      version: '${mapping.version}',\n    }`\n    )\n    .join(',\\n');\n  return `  ${prop}: {\\n${body}\\n  },\\n`;\n}\n\nfunction buildPolicySection(data: AppBlueprintSpecData): string {\n  if (data.policyRefs.length === 0) return '';\n  const entries = data.policyRefs\n    .map(\n      (policy) => `    {\n      name: '${escapeString(policy.name)}',\n      version: '${policy.version}',\n    }`\n    )\n    .join(',\\n');\n  return `  policies: [\\n${entries}\\n  ],\\n`;\n}\n\nfunction buildThemeSection(data: AppBlueprintSpecData): string {\n  if (!data.theme) return '';\n  const primary = `    primary: { name: '${escapeString(data.theme.name)}', version: ${data.theme.version} },\\n`;\n  const fallbacks =\n    data.themeFallbacks.length > 0\n      ? `    fallbacks: [${data.themeFallbacks\n          .map(\n            (theme) =>\n              `{ name: '${escapeString(theme.name)}', version: '${theme.version}' }`\n          )\n          .join(', ')}],\\n`\n      : '';\n  return `  theme: {\\n${primary}${fallbacks}  },\\n`;\n}\n\nfunction buildTelemetrySection(data: AppBlueprintSpecData): string {\n  if (!data.telemetry) return '';\n  return `  telemetry: {\n    spec: {\n      name: '${escapeString(data.telemetry.name)}'${\n        data.telemetry.version !== undefined\n          ? `,\\n      version: '${data.telemetry.version}'`\n          : ''\n      }\n    },\n  },\\n`;\n}\n\nfunction buildExperimentsSection(data: AppBlueprintSpecData): string {\n  if (\n    data.activeExperiments.length === 0 &&\n    data.pausedExperiments.length === 0\n  ) {\n    return '';\n  }\n  const active =\n    data.activeExperiments.length > 0\n      ? `    active: [${data.activeExperiments.map((exp) => formatExperimentRef(exp)).join(', ')}],\\n`\n      : '';\n  const paused =\n    data.pausedExperiments.length > 0\n      ? `    paused: [${data.pausedExperiments.map((exp) => formatExperimentRef(exp)).join(', ')}],\\n`\n      : '';\n  return `  experiments: {\\n${active}${paused}  },\\n`;\n}\n\nfunction buildFeatureFlagsSection(data: AppBlueprintSpecData): string {\n  if (data.featureFlags.length === 0) return '';\n  const flags = data.featureFlags\n    .map(\n      (flag) => `    {\n      key: '${escapeString(flag.key)}',\n      enabled: ${flag.enabled},\n      ${flag.variant ? `variant: '${escapeString(flag.variant)}',` : ''}\n      ${flag.description ? `description: '${escapeString(flag.description)}',` : ''}\n    }`\n    )\n    .join(',\\n');\n  return `  featureFlags: [\\n${flags}\\n  ],\\n`;\n}\n\nfunction buildRoutesSection(data: AppBlueprintSpecData): string {\n  if (data.routes.length === 0) return '';\n  const routes = data.routes\n    .map((route) => {\n      const entries = [\n        `path: '${escapeString(route.path)}'`,\n        route.label ? `label: '${escapeString(route.label)}'` : null,\n        route.dataView ? `dataView: '${escapeString(route.dataView)}'` : null,\n        route.workflow ? `workflow: '${escapeString(route.workflow)}'` : null,\n        route.guardName\n          ? `guard: { name: '${escapeString(route.guardName)}'${\n              route.guardVersion !== undefined\n                ? `, version: '${route.guardVersion}'`\n                : ''\n            } }`\n          : null,\n        route.featureFlag\n          ? `featureFlag: '${escapeString(route.featureFlag)}'`\n          : null,\n        route.experimentName\n          ? `experiment: { name: '${escapeString(route.experimentName)}'${\n              route.experimentVersion !== undefined\n                ? `, version: '${route.experimentVersion}'`\n                : ''\n            } }`\n          : null,\n      ].filter(Boolean);\n      return `    { ${entries.join(', ')} }`;\n    })\n    .join(',\\n');\n  return `  routes: [\\n${routes}\\n  ],\\n`;\n}\n\nfunction formatCapabilityRef(key: string): string {\n  return `{ key: '${escapeString(key)}' }`;\n}\n\nfunction formatExperimentRef(exp: { name: string; version?: string }): string {\n  const version =\n    typeof exp.version === 'string' ? `, version: ${exp.version}` : '';\n  return `{ name: '${escapeString(exp.name)}'${version} }`;\n}\n\nfunction escapeString(value: string): string {\n  return value.replace(/\\\\/g, '\\\\\\\\').replace(/'/g, \"\\\\'\");\n}\n"],"mappings":"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"}

package/dist/templates/data-view.d.ts

@@ -0,0 +1,7 @@
+import { DataViewSpecData } from "../types/spec-types.js";
+
+//#region src/templates/data-view.d.ts
+declare function generateDataViewSpec(data: DataViewSpecData): string;
+//#endregion
+export { generateDataViewSpec };
+//# sourceMappingURL=data-view.d.ts.map

package/dist/templates/data-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-view.d.ts","names":[],"sources":["../../src/templates/data-view.ts"],"sourcesContent":[],"mappings":";;;iBAGgB,oBAAA,OAA2B"}

package/dist/templates/data-view.js

@@ -0,0 +1,69 @@
+import { escapeString, toPascalCase } from "./utils.js";
+
+//#region src/templates/data-view.ts
+function generateDataViewSpec(data) {
+	const viewVarName = toPascalCase(data.name.split(".").pop() ?? "DataView") + "DataView";
+	const fields = data.fields.map((field) => `      {
+        key: '${escapeString(field.key)}',
+        label: '${escape(field.label)}',
+        dataPath: '${escapeString(field.dataPath)}',
+        ${field.format ? `format: '${escapeString(field.format)}',` : ""}
+        ${field.sortable ? "sortable: true," : ""}
+        ${field.filterable ? "filterable: true," : ""}
+      }`).join(",\n");
+	const secondaryFields = data.secondaryFields?.length ? `secondaryFields: [${data.secondaryFields.map((key) => `'${escapeString(key)}'`).join(", ")}],` : "";
+	const itemOperation = data.itemOperation ? `item: { name: '${escapeString(data.itemOperation.name)}', version: ${data.itemOperation.version} },` : "";
+	return `import type { DataViewSpec } from '@contractspec/lib.contracts/data-views';
+
+export const ${viewVarName}: DataViewSpec = {
+  meta: {
+    key: '${escapeString(data.name)}',
+    version: ${data.version},
+    entity: '${escapeString(data.entity)}',
+    title: '${escape(data.title)}',
+    description: '${escape(data.description || "Describe the purpose of this data view.")}',
+    domain: '${escape(data.domain || data.entity)}',
+    owners: [${data.owners.map((owner) => `'${escapeString(owner)}'`).join(", ")}],
+    tags: [${data.tags.map((tag) => `'${escapeString(tag)}'`).join(", ")}],
+    stability: '${data.stability}',
+  },
+  source: {
+    primary: {
+      name: '${escapeString(data.primaryOperation.name)}',
+      version: ${data.primaryOperation.version},
+    },
+    ${itemOperation}
+    refreshEvents: [
+      // { name: 'entity.updated', version: '1.0.0' },
+    ],
+  },
+  view: {
+    kind: '${data.kind}',
+    fields: [
+${fields}
+    ],
+    ${data.primaryField ? `primaryField: '${escapeString(data.primaryField)}',` : ""}
+    ${secondaryFields}
+    filters: [
+      // Example filter:
+      // { key: 'search', label: 'Search', field: 'fullName', type: 'search' },
+    ],
+    actions: [
+      // Example action:
+      // { key: 'open', label: 'Open', kind: 'navigation' },
+    ],
+  },
+  states: {
+    // empty: { name: 'app.data.empty', version: '1.0.0' },
+    // error: { name: 'app.data.error', version: '1.0.0' },
+  },
+};
+`;
+}
+function escape(value) {
+	return value.replace(/'/g, "\\'");
+}
+
+//#endregion
+export { generateDataViewSpec };
+//# sourceMappingURL=data-view.js.map

package/dist/templates/data-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-view.js","names":[],"sources":["../../src/templates/data-view.ts"],"sourcesContent":["import type { DataViewSpecData } from '../types/spec-types';\nimport { toPascalCase, escapeString } from './utils';\n\nexport function generateDataViewSpec(data: DataViewSpecData): string {\n  const viewVarName =\n    toPascalCase(data.name.split('.').pop() ?? 'DataView') + 'DataView';\n\n  const fields = data.fields\n    .map(\n      (field) => `      {\n        key: '${escapeString(field.key)}',\n        label: '${escape(field.label)}',\n        dataPath: '${escapeString(field.dataPath)}',\n        ${field.format ? `format: '${escapeString(field.format)}',` : ''}\n        ${field.sortable ? 'sortable: true,' : ''}\n        ${field.filterable ? 'filterable: true,' : ''}\n      }`\n    )\n    .join(',\\n');\n\n  const secondaryFields = data.secondaryFields?.length\n    ? `secondaryFields: [${data.secondaryFields\n        .map((key) => `'${escapeString(key)}'`)\n        .join(', ')}],`\n    : '';\n\n  const itemOperation = data.itemOperation\n    ? `item: { name: '${escapeString(data.itemOperation.name)}', version: ${data.itemOperation.version} },`\n    : '';\n\n  return `import type { DataViewSpec } from '@contractspec/lib.contracts/data-views';\n\nexport const ${viewVarName}: DataViewSpec = {\n  meta: {\n    key: '${escapeString(data.name)}',\n    version: ${data.version},\n    entity: '${escapeString(data.entity)}',\n    title: '${escape(data.title)}',\n    description: '${escape(\n      data.description || 'Describe the purpose of this data view.'\n    )}',\n    domain: '${escape(data.domain || data.entity)}',\n    owners: [${data.owners.map((owner) => `'${escapeString(owner)}'`).join(', ')}],\n    tags: [${data.tags.map((tag) => `'${escapeString(tag)}'`).join(', ')}],\n    stability: '${data.stability}',\n  },\n  source: {\n    primary: {\n      name: '${escapeString(data.primaryOperation.name)}',\n      version: ${data.primaryOperation.version},\n    },\n    ${itemOperation}\n    refreshEvents: [\n      // { name: 'entity.updated', version: '1.0.0' },\n    ],\n  },\n  view: {\n    kind: '${data.kind}',\n    fields: [\n${fields}\n    ],\n    ${data.primaryField ? `primaryField: '${escapeString(data.primaryField)}',` : ''}\n    ${secondaryFields}\n    filters: [\n      // Example filter:\n      // { key: 'search', label: 'Search', field: 'fullName', type: 'search' },\n    ],\n    actions: [\n      // Example action:\n      // { key: 'open', label: 'Open', kind: 'navigation' },\n    ],\n  },\n  states: {\n    // empty: { name: 'app.data.empty', version: '1.0.0' },\n    // error: { name: 'app.data.error', version: '1.0.0' },\n  },\n};\n`;\n}\n\nfunction escape(value: string): string {\n  return value.replace(/'/g, \"\\\\'\");\n}\n"],"mappings":";;;AAGA,SAAgB,qBAAqB,MAAgC;CACnE,MAAM,cACJ,aAAa,KAAK,KAAK,MAAM,IAAI,CAAC,KAAK,IAAI,WAAW,GAAG;CAE3D,MAAM,SAAS,KAAK,OACjB,KACE,UAAU;gBACD,aAAa,MAAM,IAAI,CAAC;kBACtB,OAAO,MAAM,MAAM,CAAC;qBACjB,aAAa,MAAM,SAAS,CAAC;UACxC,MAAM,SAAS,YAAY,aAAa,MAAM,OAAO,CAAC,MAAM,GAAG;UAC/D,MAAM,WAAW,oBAAoB,GAAG;UACxC,MAAM,aAAa,sBAAsB,GAAG;SAEjD,CACA,KAAK,MAAM;CAEd,MAAM,kBAAkB,KAAK,iBAAiB,SAC1C,qBAAqB,KAAK,gBACvB,KAAK,QAAQ,IAAI,aAAa,IAAI,CAAC,GAAG,CACtC,KAAK,KAAK,CAAC,MACd;CAEJ,MAAM,gBAAgB,KAAK,gBACvB,kBAAkB,aAAa,KAAK,cAAc,KAAK,CAAC,cAAc,KAAK,cAAc,QAAQ,OACjG;AAEJ,QAAO;;eAEM,YAAY;;YAEf,aAAa,KAAK,KAAK,CAAC;eACrB,KAAK,QAAQ;eACb,aAAa,KAAK,OAAO,CAAC;cAC3B,OAAO,KAAK,MAAM,CAAC;oBACb,OACd,KAAK,eAAe,0CACrB,CAAC;eACS,OAAO,KAAK,UAAU,KAAK,OAAO,CAAC;eACnC,KAAK,OAAO,KAAK,UAAU,IAAI,aAAa,MAAM,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC;aACpE,KAAK,KAAK,KAAK,QAAQ,IAAI,aAAa,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC;kBACvD,KAAK,UAAU;;;;eAIlB,aAAa,KAAK,iBAAiB,KAAK,CAAC;iBACvC,KAAK,iBAAiB,QAAQ;;MAEzC,cAAc;;;;;;aAMP,KAAK,KAAK;;EAErB,OAAO;;MAEH,KAAK,eAAe,kBAAkB,aAAa,KAAK,aAAa,CAAC,MAAM,GAAG;MAC/E,gBAAgB;;;;;;;;;;;;;;;;;AAkBtB,SAAS,OAAO,OAAuB;AACrC,QAAO,MAAM,QAAQ,MAAM,MAAM"}

package/dist/templates/event.d.ts

@@ -0,0 +1,11 @@
+import { EventSpecData } from "../types/spec-types.js";
+
+//#region src/templates/event.d.ts
+
+/**
+ * Generate event spec TypeScript code.
+ */
+declare function generateEventSpec(data: EventSpecData): string;
+//#endregion
+export { generateEventSpec };
+//# sourceMappingURL=event.d.ts.map

package/dist/templates/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","names":[],"sources":["../../src/templates/event.ts"],"sourcesContent":[],"mappings":";;;;;;;iBAWgB,iBAAA,OAAwB"}

package/dist/templates/event.js

@@ -0,0 +1,41 @@
+import { toPascalCase } from "./utils.js";
+
+//#region src/templates/event.ts
+/**
+* Generate event spec TypeScript code.
+*/
+function generateEventSpec(data) {
+	const { name, version, description, stability, owners, tags, piiFields } = data;
+	const eventVarName = toPascalCase(name.replace(/\./g, "_")) + "V" + version;
+	const payloadSchemaName = eventVarName + "Payload";
+	return `import { defineEvent } from '@contractspec/lib.contracts';
+import { ScalarTypeEnum, SchemaModel } from '@contractspec/lib.schema';
+
+// TODO: Define event payload schema
+export const ${payloadSchemaName} = new SchemaModel({
+  name: '${payloadSchemaName}',
+  description: 'Payload for ${name}',
+  fields: {
+    // Add your payload fields here
+    // example: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+  },
+});
+
+export const ${eventVarName} = defineEvent({
+  meta: {
+    name: '${name}',
+    version: ${version},
+    description: '${description}',
+    stability: '${stability}',
+    owners: [${owners.map((o) => `'${o}'`).join(", ")}],
+    tags: [${tags.map((t) => `'${t}'`).join(", ")}],
+  },
+  ${piiFields.length > 0 ? `pii: [${piiFields.map((f) => `'${f}'`).join(", ")}],` : "// pii: [],"}
+  payload: ${payloadSchemaName},
+});
+`;
+}
+
+//#endregion
+export { generateEventSpec };
+//# sourceMappingURL=event.js.map

package/dist/templates/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","names":[],"sources":["../../src/templates/event.ts"],"sourcesContent":["/**\n * Event spec template generation.\n * Extracted from cli-contractspec/src/templates/event.template.ts\n */\n\nimport type { EventSpecData } from '../types/spec-types';\nimport { toPascalCase } from './utils';\n\n/**\n * Generate event spec TypeScript code.\n */\nexport function generateEventSpec(data: EventSpecData): string {\n  const { name, version, description, stability, owners, tags, piiFields } =\n    data;\n\n  const eventVarName = toPascalCase(name.replace(/\\./g, '_')) + 'V' + version;\n  const payloadSchemaName = eventVarName + 'Payload';\n\n  return `import { defineEvent } from '@contractspec/lib.contracts';\nimport { ScalarTypeEnum, SchemaModel } from '@contractspec/lib.schema';\n\n// TODO: Define event payload schema\nexport const ${payloadSchemaName} = new SchemaModel({\n  name: '${payloadSchemaName}',\n  description: 'Payload for ${name}',\n  fields: {\n    // Add your payload fields here\n    // example: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nexport const ${eventVarName} = defineEvent({\n  meta: {\n    name: '${name}',\n    version: ${version},\n    description: '${description}',\n    stability: '${stability}',\n    owners: [${owners.map((o) => `'${o}'`).join(', ')}],\n    tags: [${tags.map((t) => `'${t}'`).join(', ')}],\n  },\n  ${piiFields.length > 0 ? `pii: [${piiFields.map((f) => `'${f}'`).join(', ')}],` : '// pii: [],'}\n  payload: ${payloadSchemaName},\n});\n`;\n}\n"],"mappings":";;;;;;AAWA,SAAgB,kBAAkB,MAA6B;CAC7D,MAAM,EAAE,MAAM,SAAS,aAAa,WAAW,QAAQ,MAAM,cAC3D;CAEF,MAAM,eAAe,aAAa,KAAK,QAAQ,OAAO,IAAI,CAAC,GAAG,MAAM;CACpE,MAAM,oBAAoB,eAAe;AAEzC,QAAO;;;;eAIM,kBAAkB;WACtB,kBAAkB;8BACC,KAAK;;;;;;;eAOpB,aAAa;;aAEf,KAAK;eACH,QAAQ;oBACH,YAAY;kBACd,UAAU;eACb,OAAO,KAAK,MAAM,IAAI,EAAE,GAAG,CAAC,KAAK,KAAK,CAAC;aACzC,KAAK,KAAK,MAAM,IAAI,EAAE,GAAG,CAAC,KAAK,KAAK,CAAC;;IAE9C,UAAU,SAAS,IAAI,SAAS,UAAU,KAAK,MAAM,IAAI,EAAE,GAAG,CAAC,KAAK,KAAK,CAAC,MAAM,cAAc;aACrF,kBAAkB"}

package/dist/templates/experiment.d.ts

@@ -0,0 +1,7 @@
+import { ExperimentSpecData } from "../types/spec-types.js";
+
+//#region src/templates/experiment.d.ts
+declare function generateExperimentSpec(data: ExperimentSpecData): string;
+//#endregion
+export { generateExperimentSpec };
+//# sourceMappingURL=experiment.d.ts.map

package/dist/templates/experiment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"experiment.d.ts","names":[],"sources":["../../src/templates/experiment.ts"],"sourcesContent":[],"mappings":";;;iBAGgB,sBAAA,OAA6B"}

package/dist/templates/experiment.js

@@ -0,0 +1,88 @@
+import { toPascalCase } from "./utils.js";
+
+//#region src/templates/experiment.ts
+function generateExperimentSpec(data) {
+	const specVar = toPascalCase(data.name.split(".").pop() ?? "Experiment") + "Experiment";
+	const variants = data.variants.map((variant) => {
+		const overrides = variant.overrides?.length ? `      overrides: [
+${variant.overrides.map((override) => `        {
+          type: '${override.type}',
+          target: '${escapeString(override.target)}',
+          ${typeof override.version === "number" ? `version: ${override.version},` : ""}
+        }`).join(",\n")}
+      ],` : "";
+		return `    {
+      id: '${escapeString(variant.id)}',
+      name: '${escapeString(variant.name)}',
+      ${variant.description ? `description: '${escapeString(variant.description)}',` : ""}
+      ${typeof variant.weight === "number" ? `weight: ${variant.weight},` : ""}
+${overrides}
+    }`;
+	}).join(",\n");
+	const allocation = renderAllocation(data.allocation);
+	const metrics = data.successMetrics?.length ? `  successMetrics: [
+${data.successMetrics.map((metric) => `    {
+      name: '${escapeString(metric.name)}',
+      telemetryEvent: { name: '${escapeString(metric.eventName)}', version: ${metric.eventVersion} },
+      aggregation: '${metric.aggregation}',
+      ${typeof metric.target === "number" ? `target: ${metric.target},` : ""}
+    }`).join(",\n")}
+  ],` : "";
+	return `import type { ExperimentSpec } from '@contractspec/lib.contracts/experiments';
+
+export const ${specVar}: ExperimentSpec = {
+  meta: {
+    key: '${escapeString(data.name)}',
+    version: ${data.version},
+    title: '${escapeString(data.name)} experiment',
+    description: '${escapeString(data.description || "Describe the experiment goal.")}',
+    domain: '${escapeString(data.domain)}',
+    owners: [${data.owners.map((owner) => `'${escapeString(owner)}'`).join(", ")}],
+    tags: [${data.tags.map((tag) => `'${escapeString(tag)}'`).join(", ")}],
+    stability: '${data.stability}',
+  },
+  controlVariant: '${escapeString(data.controlVariant)}',
+  variants: [
+${variants}
+  ],
+  allocation: ${allocation},
+${metrics}
+};
+`;
+}
+function renderAllocation(allocation) {
+	switch (allocation.type) {
+		case "random": return `{
+    type: 'random',
+    ${allocation.salt ? `salt: '${escapeString(allocation.salt)}',` : ""}
+  }`;
+		case "sticky": return `{
+    type: 'sticky',
+    attribute: '${allocation.attribute}',
+    ${allocation.salt ? `salt: '${escapeString(allocation.salt)}',` : ""}
+  }`;
+		case "targeted": return `{
+    type: 'targeted',
+    rules: [
+${allocation.rules.map((rule) => `      {
+        variantId: '${escapeString(rule.variantId)}',
+        ${typeof rule.percentage === "number" ? `percentage: ${rule.percentage},` : ""}
+        ${rule.policy ? `policy: { name: '${escapeString(rule.policy.name)}'${typeof rule.policy.version === "number" ? `, version: ${rule.policy.version}` : ""} },` : ""}
+        ${rule.expression ? `expression: '${escapeString(rule.expression)}',` : ""}
+      }`).join(",\n")}
+    ],
+    fallback: '${allocation.fallback ?? "control"}',
+  }`;
+		default: return renderUnsupportedAllocation(allocation);
+	}
+}
+function escapeString(value) {
+	return value.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+}
+function renderUnsupportedAllocation(allocation) {
+	throw new Error(`Unsupported allocation type ${allocation}`);
+}
+
+//#endregion
+export { generateExperimentSpec };
+//# sourceMappingURL=experiment.js.map

package/dist/templates/experiment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"experiment.js","names":[],"sources":["../../src/templates/experiment.ts"],"sourcesContent":["import type { ExperimentSpecData } from '../types/spec-types';\nimport { toPascalCase } from './utils';\n\nexport function generateExperimentSpec(data: ExperimentSpecData): string {\n  const specVar =\n    toPascalCase(data.name.split('.').pop() ?? 'Experiment') + 'Experiment';\n\n  const variants = data.variants\n    .map((variant) => {\n      const overrides = variant.overrides?.length\n        ? `      overrides: [\n${variant.overrides\n  .map(\n    (override) => `        {\n          type: '${override.type}',\n          target: '${escapeString(override.target)}',\n          ${typeof override.version === 'number' ? `version: ${override.version},` : ''}\n        }`\n  )\n  .join(',\\n')}\n      ],`\n        : '';\n      return `    {\n      id: '${escapeString(variant.id)}',\n      name: '${escapeString(variant.name)}',\n      ${variant.description ? `description: '${escapeString(variant.description)}',` : ''}\n      ${typeof variant.weight === 'number' ? `weight: ${variant.weight},` : ''}\n${overrides}\n    }`;\n    })\n    .join(',\\n');\n\n  const allocation = renderAllocation(data.allocation);\n\n  const metrics = data.successMetrics?.length\n    ? `  successMetrics: [\n${data.successMetrics\n  .map(\n    (metric) => `    {\n      name: '${escapeString(metric.name)}',\n      telemetryEvent: { name: '${escapeString(metric.eventName)}', version: ${metric.eventVersion} },\n      aggregation: '${metric.aggregation}',\n      ${typeof metric.target === 'number' ? `target: ${metric.target},` : ''}\n    }`\n  )\n  .join(',\\n')}\n  ],`\n    : '';\n\n  return `import type { ExperimentSpec } from '@contractspec/lib.contracts/experiments';\n\nexport const ${specVar}: ExperimentSpec = {\n  meta: {\n    key: '${escapeString(data.name)}',\n    version: ${data.version},\n    title: '${escapeString(data.name)} experiment',\n    description: '${escapeString(\n      data.description || 'Describe the experiment goal.'\n    )}',\n    domain: '${escapeString(data.domain)}',\n    owners: [${data.owners.map((owner) => `'${escapeString(owner)}'`).join(', ')}],\n    tags: [${data.tags.map((tag) => `'${escapeString(tag)}'`).join(', ')}],\n    stability: '${data.stability}',\n  },\n  controlVariant: '${escapeString(data.controlVariant)}',\n  variants: [\n${variants}\n  ],\n  allocation: ${allocation},\n${metrics}\n};\n`;\n}\n\nfunction renderAllocation(\n  allocation: ExperimentSpecData['allocation']\n): string {\n  switch (allocation.type) {\n    case 'random':\n      return `{\n    type: 'random',\n    ${allocation.salt ? `salt: '${escapeString(allocation.salt)}',` : ''}\n  }`;\n    case 'sticky':\n      return `{\n    type: 'sticky',\n    attribute: '${allocation.attribute}',\n    ${allocation.salt ? `salt: '${escapeString(allocation.salt)}',` : ''}\n  }`;\n    case 'targeted':\n      return `{\n    type: 'targeted',\n    rules: [\n${allocation.rules\n  .map(\n    (rule) => `      {\n        variantId: '${escapeString(rule.variantId)}',\n        ${typeof rule.percentage === 'number' ? `percentage: ${rule.percentage},` : ''}\n        ${\n          rule.policy\n            ? `policy: { name: '${escapeString(rule.policy.name)}'${typeof rule.policy.version === 'number' ? `, version: ${rule.policy.version}` : ''} },`\n            : ''\n        }\n        ${rule.expression ? `expression: '${escapeString(rule.expression)}',` : ''}\n      }`\n  )\n  .join(',\\n')}\n    ],\n    fallback: '${allocation.fallback ?? 'control'}',\n  }`;\n    default:\n      return renderUnsupportedAllocation(allocation);\n  }\n}\n\nfunction escapeString(value: string): string {\n  return value.replace(/\\\\/g, '\\\\\\\\').replace(/'/g, \"\\\\'\");\n}\n\nfunction renderUnsupportedAllocation(allocation: never): string {\n  throw new Error(\n    `Unsupported allocation type ${allocation as unknown as string}`\n  );\n}\n"],"mappings":";;;AAGA,SAAgB,uBAAuB,MAAkC;CACvE,MAAM,UACJ,aAAa,KAAK,KAAK,MAAM,IAAI,CAAC,KAAK,IAAI,aAAa,GAAG;CAE7D,MAAM,WAAW,KAAK,SACnB,KAAK,YAAY;EAChB,MAAM,YAAY,QAAQ,WAAW,SACjC;EACR,QAAQ,UACP,KACE,aAAa;mBACC,SAAS,KAAK;qBACZ,aAAa,SAAS,OAAO,CAAC;YACvC,OAAO,SAAS,YAAY,WAAW,YAAY,SAAS,QAAQ,KAAK,GAAG;WAErF,CACA,KAAK,MAAM,CAAC;YAEL;AACJ,SAAO;aACA,aAAa,QAAQ,GAAG,CAAC;eACvB,aAAa,QAAQ,KAAK,CAAC;QAClC,QAAQ,cAAc,iBAAiB,aAAa,QAAQ,YAAY,CAAC,MAAM,GAAG;QAClF,OAAO,QAAQ,WAAW,WAAW,WAAW,QAAQ,OAAO,KAAK,GAAG;EAC7E,UAAU;;GAEN,CACD,KAAK,MAAM;CAEd,MAAM,aAAa,iBAAiB,KAAK,WAAW;CAEpD,MAAM,UAAU,KAAK,gBAAgB,SACjC;EACJ,KAAK,eACJ,KACE,WAAW;eACD,aAAa,OAAO,KAAK,CAAC;iCACR,aAAa,OAAO,UAAU,CAAC,cAAc,OAAO,aAAa;sBAC5E,OAAO,YAAY;QACjC,OAAO,OAAO,WAAW,WAAW,WAAW,OAAO,OAAO,KAAK,GAAG;OAE1E,CACA,KAAK,MAAM,CAAC;QAET;AAEJ,QAAO;;eAEM,QAAQ;;YAEX,aAAa,KAAK,KAAK,CAAC;eACrB,KAAK,QAAQ;cACd,aAAa,KAAK,KAAK,CAAC;oBAClB,aACd,KAAK,eAAe,gCACrB,CAAC;eACS,aAAa,KAAK,OAAO,CAAC;eAC1B,KAAK,OAAO,KAAK,UAAU,IAAI,aAAa,MAAM,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC;aACpE,KAAK,KAAK,KAAK,QAAQ,IAAI,aAAa,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC;kBACvD,KAAK,UAAU;;qBAEZ,aAAa,KAAK,eAAe,CAAC;;EAErD,SAAS;;gBAEK,WAAW;EACzB,QAAQ;;;;AAKV,SAAS,iBACP,YACQ;AACR,SAAQ,WAAW,MAAnB;EACE,KAAK,SACH,QAAO;;MAEP,WAAW,OAAO,UAAU,aAAa,WAAW,KAAK,CAAC,MAAM,GAAG;;EAErE,KAAK,SACH,QAAO;;kBAEK,WAAW,UAAU;MACjC,WAAW,OAAO,UAAU,aAAa,WAAW,KAAK,CAAC,MAAM,GAAG;;EAErE,KAAK,WACH,QAAO;;;EAGX,WAAW,MACV,KACE,SAAS;sBACQ,aAAa,KAAK,UAAU,CAAC;UACzC,OAAO,KAAK,eAAe,WAAW,eAAe,KAAK,WAAW,KAAK,GAAG;UAE7E,KAAK,SACD,oBAAoB,aAAa,KAAK,OAAO,KAAK,CAAC,GAAG,OAAO,KAAK,OAAO,YAAY,WAAW,cAAc,KAAK,OAAO,YAAY,GAAG,OACzI,GACL;UACC,KAAK,aAAa,gBAAgB,aAAa,KAAK,WAAW,CAAC,MAAM,GAAG;SAEhF,CACA,KAAK,MAAM,CAAC;;iBAEE,WAAW,YAAY,UAAU;;EAE9C,QACE,QAAO,4BAA4B,WAAW;;;AAIpD,SAAS,aAAa,OAAuB;AAC3C,QAAO,MAAM,QAAQ,OAAO,OAAO,CAAC,QAAQ,MAAM,MAAM;;AAG1D,SAAS,4BAA4B,YAA2B;AAC9D,OAAM,IAAI,MACR,+BAA+B,aAChC"}

package/dist/templates/handler.d.ts

@@ -0,0 +1,20 @@
+//#region src/templates/handler.d.ts
+/**
+ * Handler and component template generation.
+ * Extracted from cli-contractspec/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 };
+//# sourceMappingURL=handler.d.ts.map

package/dist/templates/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","names":[],"sources":["../../src/templates/handler.ts"],"sourcesContent":[],"mappings":";;AAUA;AAyCA;AA6BA;;;;iBAtEgB,uBAAA;;;;iBAyCA,yBAAA;;;;iBA6BA,oBAAA"}