@contractspec/module.workspace 1.44.0

package/dist/templates/integration-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-utils.js","names":["entries: string[]"],"sources":["../../src/templates/integration-utils.ts"],"sourcesContent":["import type {\n  IntegrationConfigFieldData,\n  IntegrationSecretFieldData,\n  IntegrationSpecData,\n  Stability,\n} from '../types/spec-types';\n\nexport function renderConfigSchema(\n  fields: IntegrationConfigFieldData[]\n): string {\n  const requiredFields = fields.filter((field) => field.required);\n  const requiredBlock =\n    requiredFields.length > 0\n      ? `      required: [${requiredFields\n          .map((field) => `'${field.key}'`)\n          .join(', ')}],\n`\n      : '';\n\n  const properties = fields.length\n    ? fields\n        .map((field) => {\n          const description = field.description\n            ? `, description: '${escape(field.description)}'`\n            : '';\n          return `        ${field.key}: { type: '${mapConfigType(\n            field.type\n          )}'${description} }`;\n        })\n        .join(',\\n')\n    : '';\n\n  return `    schema: {\n      type: 'object',\n${requiredBlock}      properties: {\n${properties || '      '}\n      },\n    },\\n`;\n}\n\nexport function renderSecretSchema(\n  fields: IntegrationSecretFieldData[]\n): string {\n  const requiredFields = fields.filter((field) => field.required);\n  const requiredBlock =\n    requiredFields.length > 0\n      ? `      required: [${requiredFields\n          .map((field) => `'${field.key}'`)\n          .join(', ')}],\n`\n      : '';\n\n  const properties = fields.length\n    ? fields\n        .map((field) => {\n          const description = field.description\n            ? `, description: '${escape(field.description)}'`\n            : '';\n          return `        ${field.key}: { type: 'string'${description} }`;\n        })\n        .join(',\\n')\n    : '';\n\n  return `    schema: {\n      type: 'object',\n${requiredBlock}      properties: {\n${properties || '      '}\n      },\n    },\\n`;\n}\n\nexport function renderConfigExample(\n  fields: IntegrationConfigFieldData[]\n): string {\n  if (fields.length === 0) {\n    return `{}`;\n  }\n\n  const exampleEntries = fields.map((field) => {\n    switch (field.type) {\n      case 'number':\n        return `    ${field.key}: 0`;\n      case 'boolean':\n        return `    ${field.key}: true`;\n      case 'string':\n      default:\n        return `    ${field.key}: '${field.key.toUpperCase()}_VALUE'`;\n    }\n  });\n\n  return `{\n${exampleEntries.join(',\\n')}\n  }`;\n}\n\nexport function renderSecretExample(\n  fields: IntegrationSecretFieldData[]\n): string {\n  if (fields.length === 0) {\n    return `{}`;\n  }\n\n  const exampleEntries = fields.map(\n    (field) => `    ${field.key}: '${field.key.toUpperCase()}_SECRET'`\n  );\n\n  return `{\n${exampleEntries.join(',\\n')}\n  }`;\n}\n\nexport function renderConstraints(rpm?: number, rph?: number): string {\n  if (rpm == null && rph == null) return '';\n  const entries: string[] = [];\n  if (rpm != null) entries.push(`      rpm: ${rpm}`);\n  if (rph != null) entries.push(`      rph: ${rph}`);\n  return `  constraints: {\n    rateLimit: {\n${entries.join(',\\n')}\n    },\n  },\n`;\n}\n\nexport function renderByokSetup(\n  modes: string[],\n  instructions?: string,\n  scopes?: string[]\n): string {\n  if (!modes.includes('byok')) {\n    return '';\n  }\n\n  const instructionsLine = instructions\n    ? `    setupInstructions: '${escape(instructions)}',\\n`\n    : '';\n  const scopesLine =\n    scopes && scopes.length\n      ? `    requiredScopes: [${scopes\n          .map((scope) => `'${escape(scope)}'`)\n          .join(', ')}],\\n`\n      : '';\n\n  if (!instructionsLine && !scopesLine) {\n    return '';\n  }\n\n  return `  byokSetup: {\n${instructionsLine}${scopesLine}  },\n`;\n}\n\nexport function mapConfigType(\n  type: IntegrationConfigFieldData['type']\n): string {\n  switch (type) {\n    case 'number':\n      return 'number';\n    case 'boolean':\n      return 'boolean';\n    case 'string':\n    default:\n      return 'string';\n  }\n}\n\nexport function stabilityToEnum(stability: Stability): string {\n  switch (stability) {\n    case 'beta':\n      return 'Beta';\n    case 'stable':\n      return 'Stable';\n    case 'deprecated':\n      return 'Deprecated';\n    case 'experimental':\n    default:\n      return 'Experimental';\n  }\n}\n\nexport function renderProvides(data: IntegrationSpecData): string {\n  return data.capabilitiesProvided\n    .map((cap) => `      { key: '${cap.key}', version: ${cap.version} }`)\n    .join(',\\n');\n}\n\nexport function renderRequires(data: IntegrationSpecData): string {\n  if (data.capabilitiesRequired.length === 0) return '';\n\n  return `    requires: [\n${data.capabilitiesRequired\n  .map((req) => {\n    const version =\n      typeof req.version === 'number' ? `, version: ${req.version}` : '';\n    const optional = req.optional ? ', optional: true' : '';\n    const reason = req.reason ? `, reason: '${escape(req.reason)}'` : '';\n    return `      { key: '${req.key}'${version}${optional}${reason} }`;\n  })\n  .join(',\\n')}\n    ],`;\n}\n\nexport function escape(value: string): string {\n  return value.replace(/`/g, '\\\\`').replace(/'/g, \"\\\\'\");\n}\n"],"mappings":"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"}

package/dist/templates/integration.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"integration.d.ts","names":[],"sources":["../../src/templates/integration.ts"],"sourcesContent":[],"mappings":";;;iBAegB,uBAAA,OAA8B"}

package/dist/templates/integration.js

@@ -0,0 +1,63 @@
+import { toPascalCase } from "./utils.js";
+import { escape, renderByokSetup, renderConfigExample, renderConfigSchema, renderConstraints, renderProvides, renderRequires, renderSecretExample, renderSecretSchema, stabilityToEnum } from "./integration-utils.js";
+
+//#region src/templates/integration.ts
+function generateIntegrationSpec(data) {
+	const specName = toPascalCase(data.name.split(".").pop() ?? "Integration");
+	const varName = `${specName}IntegrationSpec`;
+	const registerFn = `register${specName}Integration`;
+	const supportedModes = data.supportedModes.length ? data.supportedModes : ["managed"];
+	const supportedModesLine = supportedModes.map((mode) => `'${mode}'`).join(", ");
+	const provides = renderProvides(data);
+	const requires = renderRequires(data);
+	const configSchema = renderConfigSchema(data.configFields);
+	const configExample = renderConfigExample(data.configFields);
+	const secretSchema = renderSecretSchema(data.secretFields);
+	const secretExample = renderSecretExample(data.secretFields);
+	const docsUrl = data.docsUrl ? `  docsUrl: '${escape(data.docsUrl)}',\n` : "";
+	const constraints = renderConstraints(data.rateLimitRpm, data.rateLimitRph);
+	const byokSetup = renderByokSetup(supportedModes, data.byokSetupInstructions, data.byokRequiredScopes);
+	return `import { StabilityEnum } from '@contractspec/lib.contracts/ownership';
+import type { IntegrationSpec } from '@contractspec/lib.contracts/integrations/spec';
+import type { IntegrationSpecRegistry } from '@contractspec/lib.contracts/integrations/spec';
+
+export const ${varName}: IntegrationSpec = {
+  meta: {
+    key: '${escape(data.name)}',
+    version: ${data.version},
+    category: '${data.category}',
+    displayName: '${escape(data.displayName)}',
+    title: '${escape(data.title)}',
+    description: '${escape(data.description)}',
+    domain: '${escape(data.domain)}',
+    owners: [${data.owners.map((owner) => `'${escape(owner)}'`).join(", ")}],
+    tags: [${data.tags.map((tag) => `'${escape(tag)}'`).join(", ")}],
+    stability: StabilityEnum.${stabilityToEnum(data.stability)},
+  },
+  supportedModes: [${supportedModesLine}],
+  capabilities: {
+    provides: [
+${provides}
+    ],
+${requires.length > 0 ? `${requires}\n` : ""}  },
+  configSchema: {
+${configSchema}    example: ${configExample},
+  },
+  secretSchema: {
+${secretSchema}    example: ${secretExample},
+  },
+${docsUrl}${constraints}${byokSetup}  healthCheck: {
+    method: '${data.healthCheckMethod}',
+    timeoutMs: ${data.healthCheckTimeoutMs ?? 5e3},
+  },
+};
+
+export function ${registerFn}(registry: IntegrationSpecRegistry): IntegrationSpecRegistry {
+  return registry.register(${varName});
+}
+`;
+}
+
+//#endregion
+export { generateIntegrationSpec };
+//# sourceMappingURL=integration.js.map

package/dist/templates/integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.js","names":[],"sources":["../../src/templates/integration.ts"],"sourcesContent":["import type { IntegrationSpecData } from '../types/spec-types';\nimport { toPascalCase } from './utils';\nimport {\n  escape,\n  renderByokSetup,\n  renderConfigExample,\n  renderConfigSchema,\n  renderConstraints,\n  renderProvides,\n  renderRequires,\n  renderSecretExample,\n  renderSecretSchema,\n  stabilityToEnum,\n} from './integration-utils';\n\nexport function generateIntegrationSpec(data: IntegrationSpecData): string {\n  const specName = toPascalCase(data.name.split('.').pop() ?? 'Integration');\n  const varName = `${specName}IntegrationSpec`;\n  const registerFn = `register${specName}Integration`;\n\n  const supportedModes = data.supportedModes.length\n    ? data.supportedModes\n    : ['managed'];\n  const supportedModesLine = supportedModes\n    .map((mode) => `'${mode}'`)\n    .join(', ');\n\n  const provides = renderProvides(data);\n  const requires = renderRequires(data);\n\n  const configSchema = renderConfigSchema(data.configFields);\n  const configExample = renderConfigExample(data.configFields);\n  const secretSchema = renderSecretSchema(data.secretFields);\n  const secretExample = renderSecretExample(data.secretFields);\n  const docsUrl = data.docsUrl ? `  docsUrl: '${escape(data.docsUrl)}',\\n` : '';\n  const constraints = renderConstraints(data.rateLimitRpm, data.rateLimitRph);\n  const byokSetup = renderByokSetup(\n    supportedModes,\n    data.byokSetupInstructions,\n    data.byokRequiredScopes\n  );\n\n  return `import { StabilityEnum } from '@contractspec/lib.contracts/ownership';\nimport type { IntegrationSpec } from '@contractspec/lib.contracts/integrations/spec';\nimport type { IntegrationSpecRegistry } from '@contractspec/lib.contracts/integrations/spec';\n\nexport const ${varName}: IntegrationSpec = {\n  meta: {\n    key: '${escape(data.name)}',\n    version: ${data.version},\n    category: '${data.category}',\n    displayName: '${escape(data.displayName)}',\n    title: '${escape(data.title)}',\n    description: '${escape(data.description)}',\n    domain: '${escape(data.domain)}',\n    owners: [${data.owners.map((owner) => `'${escape(owner)}'`).join(', ')}],\n    tags: [${data.tags.map((tag) => `'${escape(tag)}'`).join(', ')}],\n    stability: StabilityEnum.${stabilityToEnum(data.stability)},\n  },\n  supportedModes: [${supportedModesLine}],\n  capabilities: {\n    provides: [\n${provides}\n    ],\n${requires.length > 0 ? `${requires}\\n` : ''}  },\n  configSchema: {\n${configSchema}    example: ${configExample},\n  },\n  secretSchema: {\n${secretSchema}    example: ${secretExample},\n  },\n${docsUrl}${constraints}${byokSetup}  healthCheck: {\n    method: '${data.healthCheckMethod}',\n    timeoutMs: ${data.healthCheckTimeoutMs ?? 5000},\n  },\n};\n\nexport function ${registerFn}(registry: IntegrationSpecRegistry): IntegrationSpecRegistry {\n  return registry.register(${varName});\n}\n`;\n}\n"],"mappings":";;;;AAeA,SAAgB,wBAAwB,MAAmC;CACzE,MAAM,WAAW,aAAa,KAAK,KAAK,MAAM,IAAI,CAAC,KAAK,IAAI,cAAc;CAC1E,MAAM,UAAU,GAAG,SAAS;CAC5B,MAAM,aAAa,WAAW,SAAS;CAEvC,MAAM,iBAAiB,KAAK,eAAe,SACvC,KAAK,iBACL,CAAC,UAAU;CACf,MAAM,qBAAqB,eACxB,KAAK,SAAS,IAAI,KAAK,GAAG,CAC1B,KAAK,KAAK;CAEb,MAAM,WAAW,eAAe,KAAK;CACrC,MAAM,WAAW,eAAe,KAAK;CAErC,MAAM,eAAe,mBAAmB,KAAK,aAAa;CAC1D,MAAM,gBAAgB,oBAAoB,KAAK,aAAa;CAC5D,MAAM,eAAe,mBAAmB,KAAK,aAAa;CAC1D,MAAM,gBAAgB,oBAAoB,KAAK,aAAa;CAC5D,MAAM,UAAU,KAAK,UAAU,eAAe,OAAO,KAAK,QAAQ,CAAC,QAAQ;CAC3E,MAAM,cAAc,kBAAkB,KAAK,cAAc,KAAK,aAAa;CAC3E,MAAM,YAAY,gBAChB,gBACA,KAAK,uBACL,KAAK,mBACN;AAED,QAAO;;;;eAIM,QAAQ;;YAEX,OAAO,KAAK,KAAK,CAAC;eACf,KAAK,QAAQ;iBACX,KAAK,SAAS;oBACX,OAAO,KAAK,YAAY,CAAC;cAC/B,OAAO,KAAK,MAAM,CAAC;oBACb,OAAO,KAAK,YAAY,CAAC;eAC9B,OAAO,KAAK,OAAO,CAAC;eACpB,KAAK,OAAO,KAAK,UAAU,IAAI,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC;aAC9D,KAAK,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC;+BACpC,gBAAgB,KAAK,UAAU,CAAC;;qBAE1C,mBAAmB;;;EAGtC,SAAS;;EAET,SAAS,SAAS,IAAI,GAAG,SAAS,MAAM,GAAG;;EAE3C,aAAa,eAAe,cAAc;;;EAG1C,aAAa,eAAe,cAAc;;EAE1C,UAAU,cAAc,UAAU;eACrB,KAAK,kBAAkB;iBACrB,KAAK,wBAAwB,IAAK;;;;kBAIjC,WAAW;6BACA,QAAQ"}

package/dist/templates/knowledge.d.ts

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

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

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

package/dist/templates/knowledge.js

@@ -0,0 +1,69 @@
+import { escapeString, toPascalCase } from "./utils.js";
+
+//#region src/templates/knowledge.ts
+function generateKnowledgeSpaceSpec(data) {
+	const specName = toPascalCase(data.name.split(".").pop() ?? "KnowledgeSpace");
+	const varName = `${specName}KnowledgeSpace`;
+	const registerFn = `register${specName}KnowledgeSpace`;
+	const retention = renderRetention(data);
+	const access = renderAccess(data);
+	const indexing = renderIndexing(data);
+	const policyComment = data.policyName && !data.policyVersion ? ` // defaults to latest version` : "";
+	return `import { StabilityEnum } from '@contractspec/lib.contracts/ownership';
+import type { KnowledgeSpaceSpec } from '@contractspec/lib.contracts/knowledge/spec';
+import type { KnowledgeSpaceRegistry } from '@contractspec/lib.contracts/knowledge/spec';
+
+export const ${varName}: KnowledgeSpaceSpec = {
+  meta: {
+    key: '${escapeString(data.name)}',
+    version: ${data.version},
+    category: '${data.category}',
+    displayName: '${escape(data.displayName)}',
+    title: '${escape(data.title)}',
+    description: '${escape(data.description)}',
+    domain: '${escape(data.domain)}',
+    owners: [${data.owners.map((owner) => `'${escapeString(owner)}'`).join(", ")}],
+    tags: [${data.tags.map((tag) => `'${escapeString(tag)}'`).join(", ")}],
+    stability: StabilityEnum.${stabilityToEnum(data.stability)},
+  },
+  retention: ${retention},
+  access: {
+${access}${data.policyName ? `    policy: { name: '${escapeString(data.policyName)}',${data.policyVersion ? ` version: ${data.policyVersion}` : ""} },${policyComment}\n` : ""}  },
+${indexing}  description: '${escape(data.description || data.displayName)}',
+};
+
+export function ${registerFn}(registry: KnowledgeSpaceRegistry): KnowledgeSpaceRegistry {
+  return registry.register(${varName});
+}
+`;
+}
+function renderRetention(data) {
+	return `{ ttlDays: ${data.retention.ttlDays === null ? "null" : typeof data.retention.ttlDays === "number" ? String(data.retention.ttlDays) : "null"}${typeof data.retention.archiveAfterDays === "number" ? `, archiveAfterDays: ${data.retention.archiveAfterDays}` : ""} }`;
+}
+function renderAccess(data) {
+	return `${`    trustLevel: '${data.trustLevel}',\n`}${`    automationWritable: ${data.automationWritable},\n`}`;
+}
+function renderIndexing(data) {
+	const entries = [];
+	if (data.embeddingModel) entries.push(`    embeddingModel: '${escape(data.embeddingModel)}'`);
+	if (typeof data.chunkSize === "number") entries.push(`    chunkSize: ${data.chunkSize}`);
+	if (data.vectorDbIntegration) entries.push(`    vectorDbIntegration: '${escape(data.vectorDbIntegration)}'`);
+	if (entries.length === 0) return "";
+	return `  indexing: {\n${entries.join(",\n")}\n  },\n`;
+}
+function stabilityToEnum(stability) {
+	switch (stability) {
+		case "beta": return "Beta";
+		case "stable": return "Stable";
+		case "deprecated": return "Deprecated";
+		case "experimental":
+		default: return "Experimental";
+	}
+}
+function escape(value) {
+	return value.replace(/`/g, "\\`").replace(/'/g, "\\'");
+}
+
+//#endregion
+export { generateKnowledgeSpaceSpec };
+//# sourceMappingURL=knowledge.js.map

package/dist/templates/knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.js","names":["entries: string[]"],"sources":["../../src/templates/knowledge.ts"],"sourcesContent":["import type { KnowledgeSpaceSpecData, Stability } from '../types/spec-types';\nimport { toPascalCase, escapeString } from './utils';\n\nexport function generateKnowledgeSpaceSpec(\n  data: KnowledgeSpaceSpecData\n): string {\n  const specName = toPascalCase(data.name.split('.').pop() ?? 'KnowledgeSpace');\n  const varName = `${specName}KnowledgeSpace`;\n  const registerFn = `register${specName}KnowledgeSpace`;\n\n  const retention = renderRetention(data);\n  const access = renderAccess(data);\n  const indexing = renderIndexing(data);\n  const policyComment =\n    data.policyName && !data.policyVersion\n      ? ` // defaults to latest version`\n      : '';\n\n  return `import { StabilityEnum } from '@contractspec/lib.contracts/ownership';\nimport type { KnowledgeSpaceSpec } from '@contractspec/lib.contracts/knowledge/spec';\nimport type { KnowledgeSpaceRegistry } from '@contractspec/lib.contracts/knowledge/spec';\n\nexport const ${varName}: KnowledgeSpaceSpec = {\n  meta: {\n    key: '${escapeString(data.name)}',\n    version: ${data.version},\n    category: '${data.category}',\n    displayName: '${escape(data.displayName)}',\n    title: '${escape(data.title)}',\n    description: '${escape(data.description)}',\n    domain: '${escape(data.domain)}',\n    owners: [${data.owners.map((owner) => `'${escapeString(owner)}'`).join(', ')}],\n    tags: [${data.tags.map((tag) => `'${escapeString(tag)}'`).join(', ')}],\n    stability: StabilityEnum.${stabilityToEnum(data.stability)},\n  },\n  retention: ${retention},\n  access: {\n${access}${data.policyName ? `    policy: { name: '${escapeString(data.policyName)}',${data.policyVersion ? ` version: ${data.policyVersion}` : ''} },${policyComment}\\n` : ''}  },\n${indexing}  description: '${escape(data.description || data.displayName)}',\n};\n\nexport function ${registerFn}(registry: KnowledgeSpaceRegistry): KnowledgeSpaceRegistry {\n  return registry.register(${varName});\n}\n`;\n}\n\nfunction renderRetention(data: KnowledgeSpaceSpecData): string {\n  const ttl =\n    data.retention.ttlDays === null\n      ? 'null'\n      : typeof data.retention.ttlDays === 'number'\n        ? String(data.retention.ttlDays)\n        : 'null';\n  const archive =\n    typeof data.retention.archiveAfterDays === 'number'\n      ? `, archiveAfterDays: ${data.retention.archiveAfterDays}`\n      : '';\n  return `{ ttlDays: ${ttl}${archive} }`;\n}\n\nfunction renderAccess(data: KnowledgeSpaceSpecData): string {\n  const trustLine = `    trustLevel: '${data.trustLevel}',\\n`;\n  const automationLine = `    automationWritable: ${data.automationWritable},\\n`;\n  return `${trustLine}${automationLine}`;\n}\n\nfunction renderIndexing(data: KnowledgeSpaceSpecData): string {\n  const entries: string[] = [];\n  if (data.embeddingModel) {\n    entries.push(`    embeddingModel: '${escape(data.embeddingModel)}'`);\n  }\n  if (typeof data.chunkSize === 'number') {\n    entries.push(`    chunkSize: ${data.chunkSize}`);\n  }\n  if (data.vectorDbIntegration) {\n    entries.push(\n      `    vectorDbIntegration: '${escape(data.vectorDbIntegration)}'`\n    );\n  }\n  if (entries.length === 0) {\n    return '';\n  }\n  return `  indexing: {\\n${entries.join(',\\n')}\\n  },\\n`;\n}\n\nfunction stabilityToEnum(stability: Stability): string {\n  switch (stability) {\n    case 'beta':\n      return 'Beta';\n    case 'stable':\n      return 'Stable';\n    case 'deprecated':\n      return 'Deprecated';\n    case 'experimental':\n    default:\n      return 'Experimental';\n  }\n}\n\nfunction escape(value: string): string {\n  return value.replace(/`/g, '\\\\`').replace(/'/g, \"\\\\'\");\n}\n"],"mappings":";;;AAGA,SAAgB,2BACd,MACQ;CACR,MAAM,WAAW,aAAa,KAAK,KAAK,MAAM,IAAI,CAAC,KAAK,IAAI,iBAAiB;CAC7E,MAAM,UAAU,GAAG,SAAS;CAC5B,MAAM,aAAa,WAAW,SAAS;CAEvC,MAAM,YAAY,gBAAgB,KAAK;CACvC,MAAM,SAAS,aAAa,KAAK;CACjC,MAAM,WAAW,eAAe,KAAK;CACrC,MAAM,gBACJ,KAAK,cAAc,CAAC,KAAK,gBACrB,mCACA;AAEN,QAAO;;;;eAIM,QAAQ;;YAEX,aAAa,KAAK,KAAK,CAAC;eACrB,KAAK,QAAQ;iBACX,KAAK,SAAS;oBACX,OAAO,KAAK,YAAY,CAAC;cAC/B,OAAO,KAAK,MAAM,CAAC;oBACb,OAAO,KAAK,YAAY,CAAC;eAC9B,OAAO,KAAK,OAAO,CAAC;eACpB,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;+BAC1C,gBAAgB,KAAK,UAAU,CAAC;;eAEhD,UAAU;;EAEvB,SAAS,KAAK,aAAa,wBAAwB,aAAa,KAAK,WAAW,CAAC,IAAI,KAAK,gBAAgB,aAAa,KAAK,kBAAkB,GAAG,KAAK,cAAc,MAAM,GAAG;EAC7K,SAAS,kBAAkB,OAAO,KAAK,eAAe,KAAK,YAAY,CAAC;;;kBAGxD,WAAW;6BACA,QAAQ;;;;AAKrC,SAAS,gBAAgB,MAAsC;AAW7D,QAAO,cATL,KAAK,UAAU,YAAY,OACvB,SACA,OAAO,KAAK,UAAU,YAAY,WAChC,OAAO,KAAK,UAAU,QAAQ,GAC9B,SAEN,OAAO,KAAK,UAAU,qBAAqB,WACvC,uBAAuB,KAAK,UAAU,qBACtC,GAC6B;;AAGrC,SAAS,aAAa,MAAsC;AAG1D,QAAO,GAFW,oBAAoB,KAAK,WAAW,QAC/B,2BAA2B,KAAK,mBAAmB;;AAI5E,SAAS,eAAe,MAAsC;CAC5D,MAAMA,UAAoB,EAAE;AAC5B,KAAI,KAAK,eACP,SAAQ,KAAK,wBAAwB,OAAO,KAAK,eAAe,CAAC,GAAG;AAEtE,KAAI,OAAO,KAAK,cAAc,SAC5B,SAAQ,KAAK,kBAAkB,KAAK,YAAY;AAElD,KAAI,KAAK,oBACP,SAAQ,KACN,6BAA6B,OAAO,KAAK,oBAAoB,CAAC,GAC/D;AAEH,KAAI,QAAQ,WAAW,EACrB,QAAO;AAET,QAAO,kBAAkB,QAAQ,KAAK,MAAM,CAAC;;AAG/C,SAAS,gBAAgB,WAA8B;AACrD,SAAQ,WAAR;EACE,KAAK,OACH,QAAO;EACT,KAAK,SACH,QAAO;EACT,KAAK,aACH,QAAO;EACT,KAAK;EACL,QACE,QAAO;;;AAIb,SAAS,OAAO,OAAuB;AACrC,QAAO,MAAM,QAAQ,MAAM,MAAM,CAAC,QAAQ,MAAM,MAAM"}

package/dist/templates/migration.d.ts

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

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

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

package/dist/templates/migration.js

@@ -0,0 +1,61 @@
+import { escapeString, toPascalCase } from "./utils.js";
+
+//#region src/templates/migration.ts
+function generateMigrationSpec(data) {
+	const migrationVar = `${toPascalCase(data.name.split(".").pop() ?? "Migration")}Migration`;
+	const dependencies = data.dependencies.length > 0 ? `dependencies: [${data.dependencies.map((dep) => `'${escapeString(dep)}'`).join(", ")}],` : "";
+	return `import type { MigrationSpec } from '@contractspec/lib.contracts/migrations';
+
+export const ${migrationVar}: MigrationSpec = {
+  meta: {
+    key: '${escapeString(data.name)}',
+    version: ${data.version},
+    title: '${escape(data.title)}',
+    description: '${escape(data.description ?? "")}',
+    domain: '${escape(data.domain)}',
+    owners: [${data.owners.map((owner) => `'${escapeString(owner)}'`).join(", ")}],
+    tags: [${data.tags.map((tag) => `'${escapeString(tag)}'`).join(", ")}],
+    stability: '${data.stability}',
+  },
+  plan: {
+    up: [
+${renderSteps(data.up)}
+    ],${data.down && data.down.length ? `
+    down: [
+${renderSteps(data.down)}
+    ],` : ""}
+  },
+  ${dependencies}
+};
+`;
+}
+function renderSteps(steps) {
+	return steps.map((step) => {
+		const description = step.description ? `description: '${escape(step.description)}',` : "";
+		switch (step.kind) {
+			case "schema": return `      {
+        kind: 'schema',
+        ${description}
+        sql: \`${escape(step.sql ?? "")}\`,
+      }`;
+			case "data": return `      {
+        kind: 'data',
+        ${description}
+        script: \`${escape(step.script ?? "")}\`,
+      }`;
+			case "validation":
+			default: return `      {
+        kind: 'validation',
+        ${description}
+        assertion: \`${escape(step.assertion ?? "")}\`,
+      }`;
+		}
+	}).join(",\n");
+}
+function escape(value) {
+	return value.replace(/`/g, "\\`").replace(/'/g, "\\'");
+}
+
+//#endregion
+export { generateMigrationSpec };
+//# sourceMappingURL=migration.js.map

package/dist/templates/migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.js","names":[],"sources":["../../src/templates/migration.ts"],"sourcesContent":["import type { MigrationSpecData } from '../types/spec-types';\nimport { toPascalCase, escapeString } from './utils';\n\nexport function generateMigrationSpec(data: MigrationSpecData): string {\n  const specName = toPascalCase(data.name.split('.').pop() ?? 'Migration');\n  const migrationVar = `${specName}Migration`;\n\n  const dependencies =\n    data.dependencies.length > 0\n      ? `dependencies: [${data.dependencies\n          .map((dep) => `'${escapeString(dep)}'`)\n          .join(', ')}],`\n      : '';\n\n  return `import type { MigrationSpec } from '@contractspec/lib.contracts/migrations';\n\nexport const ${migrationVar}: MigrationSpec = {\n  meta: {\n    key: '${escapeString(data.name)}',\n    version: ${data.version},\n    title: '${escape(data.title)}',\n    description: '${escape(data.description ?? '')}',\n    domain: '${escape(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  plan: {\n    up: [\n${renderSteps(data.up)}\n    ],${\n      data.down && data.down.length\n        ? `\n    down: [\n${renderSteps(data.down)}\n    ],`\n        : ''\n    }\n  },\n  ${dependencies}\n};\n`;\n}\n\nfunction renderSteps(steps: MigrationSpecData['up']) {\n  return steps\n    .map((step) => {\n      const description = step.description\n        ? `description: '${escape(step.description)}',`\n        : '';\n      switch (step.kind) {\n        case 'schema':\n          return `      {\n        kind: 'schema',\n        ${description}\n        sql: \\`${escape(step.sql ?? '')}\\`,\n      }`;\n        case 'data':\n          return `      {\n        kind: 'data',\n        ${description}\n        script: \\`${escape(step.script ?? '')}\\`,\n      }`;\n        case 'validation':\n        default:\n          return `      {\n        kind: 'validation',\n        ${description}\n        assertion: \\`${escape(step.assertion ?? '')}\\`,\n      }`;\n      }\n    })\n    .join(',\\n');\n}\n\nfunction escape(value: string): string {\n  return value.replace(/`/g, '\\\\`').replace(/'/g, \"\\\\'\");\n}\n"],"mappings":";;;AAGA,SAAgB,sBAAsB,MAAiC;CAErE,MAAM,eAAe,GADJ,aAAa,KAAK,KAAK,MAAM,IAAI,CAAC,KAAK,IAAI,YAAY,CACvC;CAEjC,MAAM,eACJ,KAAK,aAAa,SAAS,IACvB,kBAAkB,KAAK,aACpB,KAAK,QAAQ,IAAI,aAAa,IAAI,CAAC,GAAG,CACtC,KAAK,KAAK,CAAC,MACd;AAEN,QAAO;;eAEM,aAAa;;YAEhB,aAAa,KAAK,KAAK,CAAC;eACrB,KAAK,QAAQ;cACd,OAAO,KAAK,MAAM,CAAC;oBACb,OAAO,KAAK,eAAe,GAAG,CAAC;eACpC,OAAO,KAAK,OAAO,CAAC;eACpB,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;;;;EAI/B,YAAY,KAAK,GAAG,CAAC;QAEjB,KAAK,QAAQ,KAAK,KAAK,SACnB;;EAER,YAAY,KAAK,KAAK,CAAC;UAEf,GACL;;IAED,aAAa;;;;AAKjB,SAAS,YAAY,OAAgC;AACnD,QAAO,MACJ,KAAK,SAAS;EACb,MAAM,cAAc,KAAK,cACrB,iBAAiB,OAAO,KAAK,YAAY,CAAC,MAC1C;AACJ,UAAQ,KAAK,MAAb;GACE,KAAK,SACH,QAAO;;UAEP,YAAY;iBACL,OAAO,KAAK,OAAO,GAAG,CAAC;;GAEhC,KAAK,OACH,QAAO;;UAEP,YAAY;oBACF,OAAO,KAAK,UAAU,GAAG,CAAC;;GAEtC,KAAK;GACL,QACE,QAAO;;UAEP,YAAY;uBACC,OAAO,KAAK,aAAa,GAAG,CAAC;;;GAG9C,CACD,KAAK,MAAM;;AAGhB,SAAS,OAAO,OAAuB;AACrC,QAAO,MAAM,QAAQ,MAAM,MAAM,CAAC,QAAQ,MAAM,MAAM"}

package/dist/templates/operation.d.ts

@@ -0,0 +1,11 @@
+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 };
+//# sourceMappingURL=operation.d.ts.map

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

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

package/dist/templates/operation.js

@@ -0,0 +1,101 @@
+import { capitalize, toPascalCase } from "./utils.js";
+
+//#region src/templates/operation.ts
+/**
+* Generate operation spec TypeScript code.
+*/
+function generateOperationSpec(data) {
+	const { name, version, kind, description, goal, context, stability, owners, tags, auth, flags } = data;
+	const specVarName = toPascalCase(name.split(".").pop() ?? "Unknown") + "Spec";
+	const inputSchemaName = specVarName.replace("Spec", "Input");
+	const outputSchemaName = specVarName.replace("Spec", "Output");
+	return `import { define${capitalize(kind)} } from '@contractspec/lib.contracts';
+import { ScalarTypeEnum, SchemaModel } from '@contractspec/lib.schema';
+
+// TODO: Define input schema
+export const ${inputSchemaName} = new SchemaModel({
+  name: '${inputSchemaName}',
+  description: 'Input for ${name}',
+  fields: {
+    // Add your fields here
+    // example: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+  },
+});
+
+// TODO: Define output schema
+export const ${outputSchemaName} = new SchemaModel({
+  name: '${outputSchemaName}',
+  description: 'Output for ${name}',
+  fields: {
+    // Add your fields here
+    ok: { type: ScalarTypeEnum.Boolean(), isOptional: false },
+  },
+});
+
+export const ${specVarName} = define${capitalize(kind)}({
+  meta: {
+    key: '${name}',
+    version: ${version},
+    stability: '${stability}',
+    owners: [${owners.map((o) => `'${o}'`).join(", ")}],
+    tags: [${tags.map((t) => `'${t}'`).join(", ")}],
+    description: '${description}',
+    goal: '${goal}',
+    context: '${context}',
+  },
+
+  io: {
+    input: ${inputSchemaName},
+    output: ${outputSchemaName},
+    errors: {
+      // Define possible errors
+      // EXAMPLE_ERROR: {
+      //   description: 'Example error description',
+      //   http: 400,
+      //   when: 'When this error occurs',
+      // },
+    },
+  },
+
+  policy: {
+    auth: '${auth}',
+    ${flags.length > 0 ? `flags: [${flags.map((f) => `'${f}'`).join(", ")}],` : "// flags: [],"}
+  },
+
+  sideEffects: {
+    ${data.emitsEvents ? "emits: [\n      // Define events to emit\n      // { ref: SomeEventSpec, when: 'always' }\n    ]," : "// emits: [],"}
+    analytics: [
+      // Define analytics events
+    ],
+  },
+
+  transport: {
+    rest: { method: '${kind === "command" ? "POST" : "GET"}' },
+    gql: { field: '${name.replace(/\./g, "_")}' },
+    mcp: { toolName: '${name}.v${version}' },
+  },
+
+  acceptance: {
+    scenarios: [
+      {
+        name: 'Happy path',
+        given: ['preconditions'],
+        when: ['action taken'],
+        then: ['expected outcome'],
+      },
+    ],
+    examples: [
+      {
+        name: 'Example usage',
+        input: { /* example input */ },
+        output: { ok: true },
+      },
+    ],
+  },
+});
+`;
+}
+
+//#endregion
+export { generateOperationSpec };
+//# sourceMappingURL=operation.js.map

package/dist/templates/operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation.js","names":[],"sources":["../../src/templates/operation.ts"],"sourcesContent":["/**\n * Operation spec template generation.\n * Extracted from cli-contractspec/src/templates/operation.template.ts\n */\n\nimport type { OperationSpecData } from '../types/spec-types';\nimport { toPascalCase, capitalize } from './utils';\n\n/**\n * Generate operation spec TypeScript code.\n */\nexport function generateOperationSpec(data: OperationSpecData): string {\n  const {\n    name,\n    version,\n    kind,\n    description,\n    goal,\n    context,\n    stability,\n    owners,\n    tags,\n    auth,\n    flags,\n  } = data;\n\n  const specVarName = toPascalCase(name.split('.').pop() ?? 'Unknown') + 'Spec';\n  const inputSchemaName = specVarName.replace('Spec', 'Input');\n  const outputSchemaName = specVarName.replace('Spec', 'Output');\n\n  return `import { define${capitalize(kind)} } from '@contractspec/lib.contracts';\nimport { ScalarTypeEnum, SchemaModel } from '@contractspec/lib.schema';\n\n// TODO: Define input schema\nexport const ${inputSchemaName} = new SchemaModel({\n  name: '${inputSchemaName}',\n  description: 'Input for ${name}',\n  fields: {\n    // Add your fields here\n    // example: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\n// TODO: Define output schema\nexport const ${outputSchemaName} = new SchemaModel({\n  name: '${outputSchemaName}',\n  description: 'Output for ${name}',\n  fields: {\n    // Add your fields here\n    ok: { type: ScalarTypeEnum.Boolean(), isOptional: false },\n  },\n});\n\nexport const ${specVarName} = define${capitalize(kind)}({\n  meta: {\n    key: '${name}',\n    version: ${version},\n    stability: '${stability}',\n    owners: [${owners.map((o) => `'${o}'`).join(', ')}],\n    tags: [${tags.map((t) => `'${t}'`).join(', ')}],\n    description: '${description}',\n    goal: '${goal}',\n    context: '${context}',\n  },\n\n  io: {\n    input: ${inputSchemaName},\n    output: ${outputSchemaName},\n    errors: {\n      // Define possible errors\n      // EXAMPLE_ERROR: {\n      //   description: 'Example error description',\n      //   http: 400,\n      //   when: 'When this error occurs',\n      // },\n    },\n  },\n\n  policy: {\n    auth: '${auth}',\n    ${flags.length > 0 ? `flags: [${flags.map((f) => `'${f}'`).join(', ')}],` : '// flags: [],'}\n  },\n\n  sideEffects: {\n    ${data.emitsEvents ? \"emits: [\\n      // Define events to emit\\n      // { ref: SomeEventSpec, when: 'always' }\\n    ],\" : '// emits: [],'}\n    analytics: [\n      // Define analytics events\n    ],\n  },\n\n  transport: {\n    rest: { method: '${kind === 'command' ? 'POST' : 'GET'}' },\n    gql: { field: '${name.replace(/\\./g, '_')}' },\n    mcp: { toolName: '${name}.v${version}' },\n  },\n\n  acceptance: {\n    scenarios: [\n      {\n        name: 'Happy path',\n        given: ['preconditions'],\n        when: ['action taken'],\n        then: ['expected outcome'],\n      },\n    ],\n    examples: [\n      {\n        name: 'Example usage',\n        input: { /* example input */ },\n        output: { ok: true },\n      },\n    ],\n  },\n});\n`;\n}\n"],"mappings":";;;;;;AAWA,SAAgB,sBAAsB,MAAiC;CACrE,MAAM,EACJ,MACA,SACA,MACA,aACA,MACA,SACA,WACA,QACA,MACA,MACA,UACE;CAEJ,MAAM,cAAc,aAAa,KAAK,MAAM,IAAI,CAAC,KAAK,IAAI,UAAU,GAAG;CACvE,MAAM,kBAAkB,YAAY,QAAQ,QAAQ,QAAQ;CAC5D,MAAM,mBAAmB,YAAY,QAAQ,QAAQ,SAAS;AAE9D,QAAO,kBAAkB,WAAW,KAAK,CAAC;;;;eAI7B,gBAAgB;WACpB,gBAAgB;4BACC,KAAK;;;;;;;;eAQlB,iBAAiB;WACrB,iBAAiB;6BACC,KAAK;;;;;;;eAOnB,YAAY,WAAW,WAAW,KAAK,CAAC;;YAE3C,KAAK;eACF,QAAQ;kBACL,UAAU;eACb,OAAO,KAAK,MAAM,IAAI,EAAE,GAAG,CAAC,KAAK,KAAK,CAAC;aACzC,KAAK,KAAK,MAAM,IAAI,EAAE,GAAG,CAAC,KAAK,KAAK,CAAC;oBAC9B,YAAY;aACnB,KAAK;gBACF,QAAQ;;;;aAIX,gBAAgB;cACf,iBAAiB;;;;;;;;;;;;aAYlB,KAAK;MACZ,MAAM,SAAS,IAAI,WAAW,MAAM,KAAK,MAAM,IAAI,EAAE,GAAG,CAAC,KAAK,KAAK,CAAC,MAAM,gBAAgB;;;;MAI1F,KAAK,cAAc,sGAAsG,gBAAgB;;;;;;;uBAOxH,SAAS,YAAY,SAAS,MAAM;qBACtC,KAAK,QAAQ,OAAO,IAAI,CAAC;wBACtB,KAAK,IAAI,QAAQ"}

package/dist/templates/presentation.d.ts

@@ -0,0 +1,11 @@
+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 };
+//# sourceMappingURL=presentation.d.ts.map

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

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

package/dist/templates/presentation.js

@@ -0,0 +1,79 @@
+import { toPascalCase } from "./utils.js";
+
+//#region src/templates/presentation.ts
+/**
+* Generate presentation spec TypeScript code.
+*/
+function generatePresentationSpec(data) {
+	const { name, version, description, stability, owners, tags, presentationKind } = data;
+	const varName = toPascalCase(name.replace(/\./g, "_")) + "Presentation";
+	let contentBlock = "";
+	switch (presentationKind) {
+		case "web_component":
+			contentBlock = `  content: {
+    kind: 'web_component',
+    framework: 'react',
+    componentKey: '${name.replace(/\./g, "_")}',
+    props: new SchemaModel({
+      name: '${varName}Props',
+      description: 'Props for ${name}',
+      fields: {
+        // TODO: Define component props
+      },
+    }),
+    analytics: [
+      // TODO: Define analytics events
+    ],
+  },`;
+			break;
+		case "markdown":
+			contentBlock = `  content: {
+    kind: 'markdown',
+    content: \`
+# ${description}
+
+TODO: Add markdown content here
+    \`,
+    // Or use resourceUri: 'feature://${name}/guide.md'
+  },`;
+			break;
+		case "data":
+			contentBlock = `  content: {
+    kind: 'data',
+    mimeType: 'application/json',
+    model: new SchemaModel({
+      name: '${varName}Data',
+      description: 'Data structure for ${name}',
+      fields: {
+        // TODO: Define data structure
+      },
+    }),
+  },`;
+			break;
+	}
+	return `import type { PresentationSpec } from '@contractspec/lib.contracts/presentations';
+import { SchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';
+
+export const ${varName}: PresentationSpec = {
+  meta: {
+    key: '${name}',
+    version: ${version},
+    stability: '${stability}',
+    owners: [${owners.map((o) => `'${o}'`).join(", ")}],
+    tags: [${tags.map((t) => `'${t}'`).join(", ")}],
+    description: '${description}',
+  },
+  
+  policy: {
+    // flags: [],
+    // pii: [],
+  },
+  
+${contentBlock}
+};
+`;
+}
+
+//#endregion
+export { generatePresentationSpec };
+//# sourceMappingURL=presentation.js.map

package/dist/templates/presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation.js","names":[],"sources":["../../src/templates/presentation.ts"],"sourcesContent":["/**\n * Presentation spec template generation.\n * Extracted from cli-contractspec/src/templates/presentation.template.ts\n */\n\nimport type { PresentationSpecData } from '../types/spec-types';\nimport { toPascalCase } from './utils';\n\n/**\n * Generate presentation spec TypeScript code.\n */\nexport function generatePresentationSpec(data: PresentationSpecData): string {\n  const {\n    name,\n    version,\n    description,\n    stability,\n    owners,\n    tags,\n    presentationKind,\n  } = data;\n\n  const varName = toPascalCase(name.replace(/\\./g, '_')) + 'Presentation';\n\n  let contentBlock = '';\n\n  switch (presentationKind) {\n    case 'web_component':\n      contentBlock = `  content: {\n    kind: 'web_component',\n    framework: 'react',\n    componentKey: '${name.replace(/\\./g, '_')}',\n    props: new SchemaModel({\n      name: '${varName}Props',\n      description: 'Props for ${name}',\n      fields: {\n        // TODO: Define component props\n      },\n    }),\n    analytics: [\n      // TODO: Define analytics events\n    ],\n  },`;\n      break;\n\n    case 'markdown':\n      contentBlock = `  content: {\n    kind: 'markdown',\n    content: \\`\n# ${description}\n\nTODO: Add markdown content here\n    \\`,\n    // Or use resourceUri: 'feature://${name}/guide.md'\n  },`;\n      break;\n\n    case 'data':\n      contentBlock = `  content: {\n    kind: 'data',\n    mimeType: 'application/json',\n    model: new SchemaModel({\n      name: '${varName}Data',\n      description: 'Data structure for ${name}',\n      fields: {\n        // TODO: Define data structure\n      },\n    }),\n  },`;\n      break;\n  }\n\n  return `import type { PresentationSpec } from '@contractspec/lib.contracts/presentations';\nimport { SchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';\n\nexport const ${varName}: PresentationSpec = {\n  meta: {\n    key: '${name}',\n    version: ${version},\n    stability: '${stability}',\n    owners: [${owners.map((o) => `'${o}'`).join(', ')}],\n    tags: [${tags.map((t) => `'${t}'`).join(', ')}],\n    description: '${description}',\n  },\n  \n  policy: {\n    // flags: [],\n    // pii: [],\n  },\n  \n${contentBlock}\n};\n`;\n}\n"],"mappings":";;;;;;AAWA,SAAgB,yBAAyB,MAAoC;CAC3E,MAAM,EACJ,MACA,SACA,aACA,WACA,QACA,MACA,qBACE;CAEJ,MAAM,UAAU,aAAa,KAAK,QAAQ,OAAO,IAAI,CAAC,GAAG;CAEzD,IAAI,eAAe;AAEnB,SAAQ,kBAAR;EACE,KAAK;AACH,kBAAe;;;qBAGA,KAAK,QAAQ,OAAO,IAAI,CAAC;;eAE/B,QAAQ;gCACS,KAAK;;;;;;;;;AAS/B;EAEF,KAAK;AACH,kBAAe;;;IAGjB,YAAY;;;;wCAIwB,KAAK;;AAEvC;EAEF,KAAK;AACH,kBAAe;;;;eAIN,QAAQ;yCACkB,KAAK;;;;;;AAMxC;;AAGJ,QAAO;;;eAGM,QAAQ;;YAEX,KAAK;eACF,QAAQ;kBACL,UAAU;eACb,OAAO,KAAK,MAAM,IAAI,EAAE,GAAG,CAAC,KAAK,KAAK,CAAC;aACzC,KAAK,KAAK,MAAM,IAAI,EAAE,GAAG,CAAC,KAAK,KAAK,CAAC;oBAC9B,YAAY;;;;;;;;EAQ9B,aAAa"}

package/dist/templates/telemetry.d.ts

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

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

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

package/dist/templates/telemetry.js

@@ -0,0 +1,90 @@
+import { toPascalCase } from "./utils.js";
+
+//#region src/templates/telemetry.ts
+function generateTelemetrySpec(data) {
+	const specVar = toPascalCase(data.name.split(".").pop() ?? "Telemetry") + "Telemetry";
+	const providers = data.providers?.length ? `providers: [
+${data.providers.map((provider) => `      {
+        type: '${provider.type}',
+        config: ${formatConfigValue(provider.config)},
+      }`).join(",\n")}
+    ],` : "";
+	const events = data.events.map((event) => {
+		const properties = event.properties.map((prop) => `      '${prop.name}': {
+        type: '${prop.type}',
+        ${prop.required ? "required: true," : ""}
+        ${prop.pii ? "pii: true," : ""}
+        ${prop.redact ? "redact: true," : ""}
+        ${prop.description ? `description: '${escapeString(prop.description)}',` : ""}
+      }`).join(",\n");
+		const anomalyRules = event.anomalyRules?.length ? `      anomalyDetection: {
+        enabled: true,
+        ${typeof event.anomalyMinimumSample === "number" ? `minimumSample: ${event.anomalyMinimumSample},` : ""}
+        thresholds: [
+${event.anomalyRules.map((rule) => `          {
+            metric: '${escapeString(rule.metric)}',
+            ${typeof rule.min === "number" ? `min: ${rule.min},` : ""}
+            ${typeof rule.max === "number" ? `max: ${rule.max},` : ""}
+          }`).join(",\n")}
+        ],
+        actions: [${(event.anomalyActions ?? []).map((action) => `'${action}'`).join(", ")}],
+      },` : event.anomalyEnabled ? `      anomalyDetection: {
+        enabled: true,
+        ${typeof event.anomalyMinimumSample === "number" ? `minimumSample: ${event.anomalyMinimumSample},` : ""}
+      },` : "";
+		return `    {
+      name: '${escapeString(event.name)}',
+      version: ${event.version},
+      semantics: {
+        what: '${escapeString(event.what)}',
+        ${event.who ? `who: '${escapeString(event.who)}',` : ""}
+        ${event.why ? `why: '${escapeString(event.why)}',` : ""}
+      },
+      privacy: '${event.privacy}',
+      properties: {
+${properties}
+      },
+      ${typeof event.retentionDays === "number" ? `retention: { days: ${event.retentionDays}, ${event.retentionPolicy ? `policy: '${event.retentionPolicy}'` : ""} },` : ""}
+      ${typeof event.samplingRate === "number" ? `sampling: { rate: ${event.samplingRate}${event.samplingConditions ? `, conditions: ['${escapeString(event.samplingConditions)}']` : ""} },` : ""}
+${anomalyRules}
+      ${event.tags?.length ? `tags: [${event.tags.map((tag) => `'${escapeString(tag)}'`).join(", ")}],` : ""}
+    }`;
+	}).join(",\n");
+	return `import type { TelemetrySpec } from '@contractspec/lib.contracts/telemetry';
+
+export const ${specVar}: TelemetrySpec = {
+  meta: {
+    key: '${escapeString(data.name)}',
+    version: ${data.version},
+    title: '${escapeString(data.name)} telemetry',
+    description: '${escapeString(data.description || "Describe the purpose of this telemetry spec.")}',
+    domain: '${escapeString(data.domain)}',
+    owners: [${data.owners.map((owner) => `'${escapeString(owner)}'`).join(", ")}],
+    tags: [${data.tags.map((tag) => `'${escapeString(tag)}'`).join(", ")}],
+    stability: '${data.stability}',
+  },
+  config: {
+    ${typeof data.defaultRetentionDays === "number" ? `defaultRetentionDays: ${data.defaultRetentionDays},` : ""}
+    ${typeof data.defaultSamplingRate === "number" ? `defaultSamplingRate: ${data.defaultSamplingRate},` : ""}
+    ${data.anomalyEnabled ? `anomalyDetection: { enabled: true${typeof data.anomalyCheckIntervalMs === "number" ? `, checkIntervalMs: ${data.anomalyCheckIntervalMs}` : ""} },` : ""}
+${providers}
+  },
+  events: [
+${events}
+  ],
+};
+`;
+}
+function escapeString(value) {
+	return value.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+}
+function formatConfigValue(value) {
+	const trimmed = value.trim();
+	if (!trimmed) return "{}";
+	if (trimmed.startsWith("{") && trimmed.endsWith("}") || trimmed.startsWith("[") && trimmed.endsWith("]")) return trimmed;
+	return `'${escapeString(trimmed)}'`;
+}
+
+//#endregion
+export { generateTelemetrySpec };
+//# sourceMappingURL=telemetry.js.map