@contractspec/module.workspace 0.0.0-canary-20260113162409

package/dist/templates/handler.js

@@ -0,0 +1,96 @@
+import { toCamelCase, toKebabCase, toPascalCase } from "./utils.js";
+
+//#region src/templates/handler.ts
+/**
+* Handler and component template generation.
+* Extracted from cli-contractspec/src/templates/handler.template.ts
+*/
+/**
+* Generate handler implementation template.
+*/
+function generateHandlerTemplate(specName, kind) {
+	const handlerName = toCamelCase(specName.split(".").pop() ?? "unknown") + "Handler";
+	const specVarName = toPascalCase(specName.split(".").pop() ?? "Unknown") + "Spec";
+	return `import type { ContractHandler } from '@contractspec/lib.contracts';
+import { ${specVarName} } from '../contracts/${toKebabCase(specName)}.contracts';
+
+/**
+ * Handler for ${specName}
+ */
+export const ${handlerName}: ContractHandler<typeof ${specVarName}> = async (
+  input,
+  context
+) => {
+  // TODO: Implement ${kind} logic
+  
+  try {
+    // 1. Validate prerequisites
+    // 2. Perform business logic
+    // 3. Emit events if needed
+    // 4. Return result
+    
+    return {
+      ok: true,
+    };
+  } catch (error) {
+    // Handle and map errors to spec.io.errors
+    throw error;
+  }
+};
+`;
+}
+/**
+* Generate React component template.
+*/
+function generateComponentTemplate(componentName, description) {
+	const pascalName = toPascalCase(componentName);
+	return `import React from 'react';
+
+interface ${pascalName}Props {
+  // TODO: Define props based on presentation spec
+}
+
+/**
+ * ${description}
+ */
+export const ${pascalName}: React.FC<${pascalName}Props> = (props) => {
+  return (
+    <div>
+      {/* TODO: Implement component UI */}
+      <p>Component: ${pascalName}</p>
+    </div>
+  );
+};
+`;
+}
+/**
+* Generate test template.
+*/
+function generateTestTemplate(targetName, type) {
+	const importPath = type === "handler" ? "../handlers" : "../components";
+	const testName = toPascalCase(targetName);
+	return `import { describe, it, expect } from 'bun:test';
+import { ${testName} } from '${importPath}/${toKebabCase(targetName)}';
+
+describe('${testName}', () => {
+  it('should ${type === "handler" ? "handle valid input" : "render correctly"}', async () => {
+    // TODO: Implement test
+    expect(true).toBe(true);
+  });
+
+  it('should handle edge cases', async () => {
+    // TODO: Test edge cases
+  });
+
+  ${type === "handler" ? `it('should handle errors appropriately', async () => {
+    // TODO: Test error scenarios
+  });` : `it('should be accessible', async () => {
+    // TODO: Test accessibility
+  });`}
+});
+`;
+}
+
+//#endregion
+export { generateComponentTemplate, generateHandlerTemplate, generateTestTemplate };
+//# sourceMappingURL=handler.js.map

package/dist/templates/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","names":[],"sources":["../../src/templates/handler.ts"],"sourcesContent":["/**\n * Handler and component template generation.\n * Extracted from cli-contractspec/src/templates/handler.template.ts\n */\n\nimport { toPascalCase, toCamelCase, toKebabCase } from './utils';\n\n/**\n * Generate handler implementation template.\n */\nexport function generateHandlerTemplate(\n  specName: string,\n  kind: 'command' | 'query'\n): string {\n  const handlerName =\n    toCamelCase(specName.split('.').pop() ?? 'unknown') + 'Handler';\n  const specVarName =\n    toPascalCase(specName.split('.').pop() ?? 'Unknown') + 'Spec';\n\n  return `import type { ContractHandler } from '@contractspec/lib.contracts';\nimport { ${specVarName} } from '../contracts/${toKebabCase(specName)}.contracts';\n\n/**\n * Handler for ${specName}\n */\nexport const ${handlerName}: ContractHandler<typeof ${specVarName}> = async (\n  input,\n  context\n) => {\n  // TODO: Implement ${kind} logic\n  \n  try {\n    // 1. Validate prerequisites\n    // 2. Perform business logic\n    // 3. Emit events if needed\n    // 4. Return result\n    \n    return {\n      ok: true,\n    };\n  } catch (error) {\n    // Handle and map errors to spec.io.errors\n    throw error;\n  }\n};\n`;\n}\n\n/**\n * Generate React component template.\n */\nexport function generateComponentTemplate(\n  componentName: string,\n  description: string\n): string {\n  const pascalName = toPascalCase(componentName);\n\n  return `import React from 'react';\n\ninterface ${pascalName}Props {\n  // TODO: Define props based on presentation spec\n}\n\n/**\n * ${description}\n */\nexport const ${pascalName}: React.FC<${pascalName}Props> = (props) => {\n  return (\n    <div>\n      {/* TODO: Implement component UI */}\n      <p>Component: ${pascalName}</p>\n    </div>\n  );\n};\n`;\n}\n\n/**\n * Generate test template.\n */\nexport function generateTestTemplate(\n  targetName: string,\n  type: 'handler' | 'component'\n): string {\n  const importPath = type === 'handler' ? '../handlers' : '../components';\n  const testName = toPascalCase(targetName);\n\n  return `import { describe, it, expect } from 'bun:test';\nimport { ${testName} } from '${importPath}/${toKebabCase(targetName)}';\n\ndescribe('${testName}', () => {\n  it('should ${type === 'handler' ? 'handle valid input' : 'render correctly'}', async () => {\n    // TODO: Implement test\n    expect(true).toBe(true);\n  });\n\n  it('should handle edge cases', async () => {\n    // TODO: Test edge cases\n  });\n\n  ${\n    type === 'handler'\n      ? `it('should handle errors appropriately', async () => {\n    // TODO: Test error scenarios\n  });`\n      : `it('should be accessible', async () => {\n    // TODO: Test accessibility\n  });`\n  }\n});\n`;\n}\n"],"mappings":";;;;;;;;;;AAUA,SAAgB,wBACd,UACA,MACQ;CACR,MAAM,cACJ,YAAY,SAAS,MAAM,IAAI,CAAC,KAAK,IAAI,UAAU,GAAG;CACxD,MAAM,cACJ,aAAa,SAAS,MAAM,IAAI,CAAC,KAAK,IAAI,UAAU,GAAG;AAEzD,QAAO;WACE,YAAY,wBAAwB,YAAY,SAAS,CAAC;;;iBAGpD,SAAS;;eAEX,YAAY,2BAA2B,YAAY;;;;uBAI3C,KAAK;;;;;;;;;;;;;;;;;;;;;AAsB5B,SAAgB,0BACd,eACA,aACQ;CACR,MAAM,aAAa,aAAa,cAAc;AAE9C,QAAO;;YAEG,WAAW;;;;;KAKlB,YAAY;;eAEF,WAAW,aAAa,WAAW;;;;sBAI5B,WAAW;;;;;;;;;AAUjC,SAAgB,qBACd,YACA,MACQ;CACR,MAAM,aAAa,SAAS,YAAY,gBAAgB;CACxD,MAAM,WAAW,aAAa,WAAW;AAEzC,QAAO;WACE,SAAS,WAAW,WAAW,GAAG,YAAY,WAAW,CAAC;;YAEzD,SAAS;eACN,SAAS,YAAY,uBAAuB,mBAAmB;;;;;;;;;IAU1E,SAAS,YACL;;SAGA;;OAGL"}

package/dist/templates/integration-utils.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"integration-utils.js","names":[],"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":";AAOA,SAAgB,mBACd,QACQ;CACR,MAAM,iBAAiB,OAAO,QAAQ,UAAU,MAAM,SAAS;AAsB/D,QAAO;;EApBL,eAAe,SAAS,IACpB,oBAAoB,eACjB,KAAK,UAAU,IAAI,MAAM,IAAI,GAAG,CAChC,KAAK,KAAK,CAAC;IAEd,GAiBQ;GAfK,OAAO,SACtB,OACG,KAAK,UAAU;EACd,MAAM,cAAc,MAAM,cACtB,mBAAmB,OAAO,MAAM,YAAY,CAAC,KAC7C;AACJ,SAAO,WAAW,MAAM,IAAI,aAAa,cACvC,MAAM,KACP,CAAC,GAAG,YAAY;GACjB,CACD,KAAK,MAAM,GACd,OAKU,SAAS;;;;AAKzB,SAAgB,mBACd,QACQ;CACR,MAAM,iBAAiB,OAAO,QAAQ,UAAU,MAAM,SAAS;AAoB/D,QAAO;;EAlBL,eAAe,SAAS,IACpB,oBAAoB,eACjB,KAAK,UAAU,IAAI,MAAM,IAAI,GAAG,CAChC,KAAK,KAAK,CAAC;IAEd,GAeQ;GAbK,OAAO,SACtB,OACG,KAAK,UAAU;EACd,MAAM,cAAc,MAAM,cACtB,mBAAmB,OAAO,MAAM,YAAY,CAAC,KAC7C;AACJ,SAAO,WAAW,MAAM,IAAI,oBAAoB,YAAY;GAC5D,CACD,KAAK,MAAM,GACd,OAKU,SAAS;;;;AAKzB,SAAgB,oBACd,QACQ;AACR,KAAI,OAAO,WAAW,EACpB,QAAO;AAeT,QAAO;EAZgB,OAAO,KAAK,UAAU;AAC3C,UAAQ,MAAM,MAAd;GACE,KAAK,SACH,QAAO,OAAO,MAAM,IAAI;GAC1B,KAAK,UACH,QAAO,OAAO,MAAM,IAAI;GAC1B,KAAK;GACL,QACE,QAAO,OAAO,MAAM,IAAI,KAAK,MAAM,IAAI,aAAa,CAAC;;GAEzD,CAGa,KAAK,MAAM,CAAC;;;AAI7B,SAAgB,oBACd,QACQ;AACR,KAAI,OAAO,WAAW,EACpB,QAAO;AAOT,QAAO;EAJgB,OAAO,KAC3B,UAAU,OAAO,MAAM,IAAI,KAAK,MAAM,IAAI,aAAa,CAAC,UAC1D,CAGc,KAAK,MAAM,CAAC;;;AAI7B,SAAgB,kBAAkB,KAAc,KAAsB;AACpE,KAAI,OAAO,QAAQ,OAAO,KAAM,QAAO;CACvC,MAAM,UAAoB,EAAE;AAC5B,KAAI,OAAO,KAAM,SAAQ,KAAK,cAAc,MAAM;AAClD,KAAI,OAAO,KAAM,SAAQ,KAAK,cAAc,MAAM;AAClD,QAAO;;EAEP,QAAQ,KAAK,MAAM,CAAC;;;;;AAMtB,SAAgB,gBACd,OACA,cACA,QACQ;AACR,KAAI,CAAC,MAAM,SAAS,OAAO,CACzB,QAAO;CAGT,MAAM,mBAAmB,eACrB,2BAA2B,OAAO,aAAa,CAAC,QAChD;CACJ,MAAM,aACJ,UAAU,OAAO,SACb,wBAAwB,OACrB,KAAK,UAAU,IAAI,OAAO,MAAM,CAAC,GAAG,CACpC,KAAK,KAAK,CAAC,QACd;AAEN,KAAI,CAAC,oBAAoB,CAAC,WACxB,QAAO;AAGT,QAAO;EACP,mBAAmB,WAAW;;;AAIhC,SAAgB,cACd,MACQ;AACR,SAAQ,MAAR;EACE,KAAK,SACH,QAAO;EACT,KAAK,UACH,QAAO;EACT,KAAK;EACL,QACE,QAAO;;;AAIb,SAAgB,gBAAgB,WAA8B;AAC5D,SAAQ,WAAR;EACE,KAAK,OACH,QAAO;EACT,KAAK,SACH,QAAO;EACT,KAAK,aACH,QAAO;EACT,KAAK;EACL,QACE,QAAO;;;AAIb,SAAgB,eAAe,MAAmC;AAChE,QAAO,KAAK,qBACT,KAAK,QAAQ,iBAAiB,IAAI,IAAI,cAAc,IAAI,QAAQ,IAAI,CACpE,KAAK,MAAM;;AAGhB,SAAgB,eAAe,MAAmC;AAChE,KAAI,KAAK,qBAAqB,WAAW,EAAG,QAAO;AAEnD,QAAO;EACP,KAAK,qBACJ,KAAK,QAAQ;EACZ,MAAM,UACJ,OAAO,IAAI,YAAY,WAAW,cAAc,IAAI,YAAY;EAClE,MAAM,WAAW,IAAI,WAAW,qBAAqB;EACrD,MAAM,SAAS,IAAI,SAAS,cAAc,OAAO,IAAI,OAAO,CAAC,KAAK;AAClE,SAAO,iBAAiB,IAAI,IAAI,GAAG,UAAU,WAAW,OAAO;GAC/D,CACD,KAAK,MAAM,CAAC;;;AAIf,SAAgB,OAAO,OAAuB;AAC5C,QAAO,MAAM,QAAQ,MAAM,MAAM,CAAC,QAAQ,MAAM,MAAM"}

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,62 @@
+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, defineIntegration } from '@contractspec/lib.contracts';
+import type { IntegrationSpecRegistry } from '@contractspec/lib.contracts/integrations/spec';
+
+export const ${varName} = defineIntegration({
+  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, defineIntegration } from '@contractspec/lib.contracts';\nimport type { IntegrationSpecRegistry } from '@contractspec/lib.contracts/integrations/spec';\n\nexport const ${varName} = defineIntegration({\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;;;eAGM,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":[],"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,MAAM,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"}