@contractspec/module.workspace 1.44.0

package/dist/templates/telemetry.js.map

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

package/dist/templates/utils.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","names":[],"sources":["../../src/templates/utils.ts"],"sourcesContent":[],"mappings":";;AAOA;AAQA;AAUA;AAUA;AAOA;iBAnCgB,WAAA;;;;iBAQA,YAAA;;;;iBAUA,WAAA;;;;iBAUA,UAAA;;;;iBAOA,YAAA"}

package/dist/templates/utils.js

@@ -0,0 +1,39 @@
+//#region src/templates/utils.ts
+/**
+* Utility functions for template generation.
+*/
+/**
+* Convert string to camelCase.
+*/
+function toCamelCase(str) {
+	const pascal = toPascalCase(str);
+	return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+/**
+* Convert string to PascalCase.
+*/
+function toPascalCase(str) {
+	return str.split(/[-_.]/).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join("");
+}
+/**
+* Convert string to kebab-case.
+*/
+function toKebabCase(str) {
+	return str.replace(/\./g, "-").replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
+}
+/**
+* Capitalize first letter.
+*/
+function capitalize(str) {
+	return str.charAt(0).toUpperCase() + str.slice(1);
+}
+/**
+* Escape single quotes in string.
+*/
+function escapeString(value) {
+	return value.replace(/'/g, "\\'");
+}
+
+//#endregion
+export { capitalize, escapeString, toCamelCase, toKebabCase, toPascalCase };
+//# sourceMappingURL=utils.js.map

package/dist/templates/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":[],"sources":["../../src/templates/utils.ts"],"sourcesContent":["/**\n * Utility functions for template generation.\n */\n\n/**\n * Convert string to camelCase.\n */\nexport function toCamelCase(str: string): string {\n  const pascal = toPascalCase(str);\n  return pascal.charAt(0).toLowerCase() + pascal.slice(1);\n}\n\n/**\n * Convert string to PascalCase.\n */\nexport function toPascalCase(str: string): string {\n  return str\n    .split(/[-_.]/)\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join('');\n}\n\n/**\n * Convert string to kebab-case.\n */\nexport function toKebabCase(str: string): string {\n  return str\n    .replace(/\\./g, '-')\n    .replace(/([a-z])([A-Z])/g, '$1-$2')\n    .toLowerCase();\n}\n\n/**\n * Capitalize first letter.\n */\nexport function capitalize(str: string): string {\n  return str.charAt(0).toUpperCase() + str.slice(1);\n}\n\n/**\n * Escape single quotes in string.\n */\nexport function escapeString(value: string): string {\n  return value.replace(/'/g, \"\\\\'\");\n}\n"],"mappings":";;;;;;;AAOA,SAAgB,YAAY,KAAqB;CAC/C,MAAM,SAAS,aAAa,IAAI;AAChC,QAAO,OAAO,OAAO,EAAE,CAAC,aAAa,GAAG,OAAO,MAAM,EAAE;;;;;AAMzD,SAAgB,aAAa,KAAqB;AAChD,QAAO,IACJ,MAAM,QAAQ,CACd,KAAK,SAAS,KAAK,OAAO,EAAE,CAAC,aAAa,GAAG,KAAK,MAAM,EAAE,CAAC,CAC3D,KAAK,GAAG;;;;;AAMb,SAAgB,YAAY,KAAqB;AAC/C,QAAO,IACJ,QAAQ,OAAO,IAAI,CACnB,QAAQ,mBAAmB,QAAQ,CACnC,aAAa;;;;;AAMlB,SAAgB,WAAW,KAAqB;AAC9C,QAAO,IAAI,OAAO,EAAE,CAAC,aAAa,GAAG,IAAI,MAAM,EAAE;;;;;AAMnD,SAAgB,aAAa,OAAuB;AAClD,QAAO,MAAM,QAAQ,MAAM,MAAM"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-runner.d.ts","names":[],"sources":["../../src/templates/workflow-runner.ts"],"sourcesContent":[],"mappings":";UAAU,qBAAA;EAAA,UAAA,EAAA,MAAA;EAOM,cAAA,EAAA,MAAA;EACd,UAAA,EAAA,MAAA;EACA,YAAA,EAAA,MAAA;;AAEA,iBAJc,8BAAA,CAId;EAAA,UAAA;EAAA,cAAA;EAAA,UAAA;EAAA;AAAA,CAAA,EACC,qBADD,CAAA,EAAA,MAAA"}

package/dist/templates/workflow-runner.js

@@ -0,0 +1,49 @@
+//#region src/templates/workflow-runner.ts
+function generateWorkflowRunnerTemplate({ exportName, specImportPath, runnerName, workflowName }) {
+	return `import {
+  InMemoryStateStore,
+  WorkflowRegistry,
+  WorkflowRunner,
+} from '@contractspec/lib.contracts/workflow';
+import { ${exportName} } from '${specImportPath}';
+
+/**
+ * Runner wiring for ${workflowName}.
+ *
+ * TODO:
+ *  - Replace the in-memory state store with a persistent adapter if needed.
+ *  - Implement opExecutor to invoke the correct contract handlers.
+ *  - Wire eventEmitter to telemetry sinks.
+ */
+const registry = new WorkflowRegistry();
+registry.register(${exportName});
+
+const stateStore = new InMemoryStateStore();
+
+export const ${runnerName} = new WorkflowRunner({
+  registry,
+  stateStore,
+  opExecutor: async (operation, input, ctx) => {
+    // TODO: route to the appropriate contract handler
+    // Example: return contractRegistry.execute(operation.name, operation.version, input, ctx);
+    throw new Error(
+      \`opExecutor for \${operation.name}.v\${operation.version} is not implemented\`
+    );
+  },
+  // appConfigProvider: async (state) => {
+  //   // TODO: return the ResolvedAppConfig for this workflow run (tenant/environment)
+  //   return undefined;
+  // },
+  // enforceCapabilities: async (operation, context) => {
+  //   // TODO: ensure required capabilities are satisfied using context.integrations/context.resolvedAppConfig
+  // },
+  eventEmitter: (_event, _payload) => {
+    // TODO: forward workflow events to telemetry or logging sinks
+  },
+});
+`;
+}
+
+//#endregion
+export { generateWorkflowRunnerTemplate };
+//# sourceMappingURL=workflow-runner.js.map

package/dist/templates/workflow-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-runner.js","names":[],"sources":["../../src/templates/workflow-runner.ts"],"sourcesContent":["interface RunnerTemplateOptions {\n  exportName: string;\n  specImportPath: string;\n  runnerName: string;\n  workflowName: string;\n}\n\nexport function generateWorkflowRunnerTemplate({\n  exportName,\n  specImportPath,\n  runnerName,\n  workflowName,\n}: RunnerTemplateOptions): string {\n  return `import {\n  InMemoryStateStore,\n  WorkflowRegistry,\n  WorkflowRunner,\n} from '@contractspec/lib.contracts/workflow';\nimport { ${exportName} } from '${specImportPath}';\n\n/**\n * Runner wiring for ${workflowName}.\n *\n * TODO:\n *  - Replace the in-memory state store with a persistent adapter if needed.\n *  - Implement opExecutor to invoke the correct contract handlers.\n *  - Wire eventEmitter to telemetry sinks.\n */\nconst registry = new WorkflowRegistry();\nregistry.register(${exportName});\n\nconst stateStore = new InMemoryStateStore();\n\nexport const ${runnerName} = new WorkflowRunner({\n  registry,\n  stateStore,\n  opExecutor: async (operation, input, ctx) => {\n    // TODO: route to the appropriate contract handler\n    // Example: return contractRegistry.execute(operation.name, operation.version, input, ctx);\n    throw new Error(\n      \\`opExecutor for \\${operation.name}.v\\${operation.version} is not implemented\\`\n    );\n  },\n  // appConfigProvider: async (state) => {\n  //   // TODO: return the ResolvedAppConfig for this workflow run (tenant/environment)\n  //   return undefined;\n  // },\n  // enforceCapabilities: async (operation, context) => {\n  //   // TODO: ensure required capabilities are satisfied using context.integrations/context.resolvedAppConfig\n  // },\n  eventEmitter: (_event, _payload) => {\n    // TODO: forward workflow events to telemetry or logging sinks\n  },\n});\n`;\n}\n"],"mappings":";AAOA,SAAgB,+BAA+B,EAC7C,YACA,gBACA,YACA,gBACgC;AAChC,QAAO;;;;;WAKE,WAAW,WAAW,eAAe;;;uBAGzB,aAAa;;;;;;;;oBAQhB,WAAW;;;;eAIhB,WAAW"}

package/dist/templates/workflow.d.ts

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

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

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

package/dist/templates/workflow.js

@@ -0,0 +1,68 @@
+import { escapeString, toPascalCase } from "./utils.js";
+
+//#region src/templates/workflow.ts
+/**
+* Generate workflow spec TypeScript code.
+*/
+function generateWorkflowSpec(data) {
+	const specVarName = toPascalCase(data.name.split(".").pop() ?? "Workflow") + "Workflow";
+	const stepsCode = data.steps.map((step) => formatStep(step)).join(",\n");
+	const transitionsCode = data.transitions.map((transition) => `    {
+      from: '${transition.from}',
+      to: '${transition.to}',
+${transition.condition ? `      condition: '${escapeString(transition.condition)}',` : ""}
+    }`).join(",\n");
+	return `import type { WorkflowSpec } from '@contractspec/lib.contracts/workflow';
+
+/**
+ * Workflow generated via contractspec CLI.
+ * TODO:
+ *  - Review step definitions and descriptions.
+ *  - Wire automation steps to actual operations.
+ *  - Provide form renderers for human steps.
+ *  - Add guards/conditions as needed.
+ */
+export const ${specVarName}: WorkflowSpec = {
+  meta: {
+    key: '${data.name}',
+    version: ${data.version},
+    title: '${escapeString(data.title)}',
+    description: '${escapeString(data.description)}',
+    domain: '${escapeString(data.domain)}',
+    stability: '${data.stability}',
+    owners: [${data.owners.map((owner) => `'${owner}'`).join(", ")}],
+    tags: [${data.tags.map((tag) => `'${tag}'`).join(", ")}],
+  },
+  definition: {
+${data.entryStepId ? `    entryStepId: '${data.entryStepId}',\n` : ""}    steps: [
+${stepsCode}
+    ],
+    transitions: [
+${transitionsCode}
+    ],
+  },
+  ${data.policyFlags.length > 0 ? `policy: {
+    flags: [${data.policyFlags.map((flag) => `'${flag}'`).join(", ")}],
+  },` : "// policy: { flags: [] },"}
+};
+`;
+}
+function formatStep(step) {
+	const lines = [
+		`    {`,
+		`      id: '${step.id}',`,
+		`      type: '${step.type}',`,
+		`      label: '${escapeString(step.label)}',`
+	];
+	if (step.description) lines.push(`      description: '${escapeString(step.description)}',`);
+	const actionLines = [];
+	if (step.operation) actionLines.push(`operation: { name: '${step.operation.name}', version: ${step.operation.version} }`);
+	if (step.form) actionLines.push(`form: { key: '${step.form.key}', version: ${step.form.version} }`);
+	if (actionLines.length) lines.push(`      action: { ${actionLines.join(", ")} },`);
+	lines.push(`    }`);
+	return lines.join("\n");
+}
+
+//#endregion
+export { generateWorkflowSpec };
+//# sourceMappingURL=workflow.js.map

package/dist/templates/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","names":["lines: string[]","actionLines: string[]"],"sources":["../../src/templates/workflow.ts"],"sourcesContent":["/**\n * Workflow spec template generation.\n * Extracted from cli-contractspec/src/templates/workflow.template.ts\n */\n\nimport type { WorkflowSpecData } from '../types/spec-types';\nimport { toPascalCase, escapeString } from './utils';\n\n/**\n * Generate workflow spec TypeScript code.\n */\nexport function generateWorkflowSpec(data: WorkflowSpecData): string {\n  const specVarName =\n    toPascalCase(data.name.split('.').pop() ?? 'Workflow') + 'Workflow';\n\n  const stepsCode = data.steps.map((step) => formatStep(step)).join(',\\n');\n\n  const transitionsCode = data.transitions\n    .map(\n      (transition) => `    {\n      from: '${transition.from}',\n      to: '${transition.to}',\n${transition.condition ? `      condition: '${escapeString(transition.condition)}',` : ''}\n    }`\n    )\n    .join(',\\n');\n\n  return `import type { WorkflowSpec } from '@contractspec/lib.contracts/workflow';\n\n/**\n * Workflow generated via contractspec CLI.\n * TODO:\n *  - Review step definitions and descriptions.\n *  - Wire automation steps to actual operations.\n *  - Provide form renderers for human steps.\n *  - Add guards/conditions as needed.\n */\nexport const ${specVarName}: WorkflowSpec = {\n  meta: {\n    key: '${data.name}',\n    version: ${data.version},\n    title: '${escapeString(data.title)}',\n    description: '${escapeString(data.description)}',\n    domain: '${escapeString(data.domain)}',\n    stability: '${data.stability}',\n    owners: [${data.owners.map((owner) => `'${owner}'`).join(', ')}],\n    tags: [${data.tags.map((tag) => `'${tag}'`).join(', ')}],\n  },\n  definition: {\n${data.entryStepId ? `    entryStepId: '${data.entryStepId}',\\n` : ''}    steps: [\n${stepsCode}\n    ],\n    transitions: [\n${transitionsCode}\n    ],\n  },\n  ${\n    data.policyFlags.length > 0\n      ? `policy: {\n    flags: [${data.policyFlags.map((flag) => `'${flag}'`).join(', ')}],\n  },`\n      : '// policy: { flags: [] },'\n  }\n};\n`;\n}\n\nfunction formatStep(step: WorkflowSpecData['steps'][number]): string {\n  const lines: string[] = [\n    `    {`,\n    `      id: '${step.id}',`,\n    `      type: '${step.type}',`,\n    `      label: '${escapeString(step.label)}',`,\n  ];\n  if (step.description) {\n    lines.push(`      description: '${escapeString(step.description)}',`);\n  }\n\n  const actionLines: string[] = [];\n  if (step.operation) {\n    actionLines.push(\n      `operation: { name: '${step.operation.name}', version: ${step.operation.version} }`\n    );\n  }\n  if (step.form) {\n    actionLines.push(\n      `form: { key: '${step.form.key}', version: ${step.form.version} }`\n    );\n  }\n  if (actionLines.length) {\n    lines.push(`      action: { ${actionLines.join(', ')} },`);\n  }\n\n  lines.push(`    }`);\n  return lines.join('\\n');\n}\n"],"mappings":";;;;;;AAWA,SAAgB,qBAAqB,MAAgC;CACnE,MAAM,cACJ,aAAa,KAAK,KAAK,MAAM,IAAI,CAAC,KAAK,IAAI,WAAW,GAAG;CAE3D,MAAM,YAAY,KAAK,MAAM,KAAK,SAAS,WAAW,KAAK,CAAC,CAAC,KAAK,MAAM;CAExE,MAAM,kBAAkB,KAAK,YAC1B,KACE,eAAe;eACP,WAAW,KAAK;aAClB,WAAW,GAAG;EACzB,WAAW,YAAY,qBAAqB,aAAa,WAAW,UAAU,CAAC,MAAM,GAAG;OAErF,CACA,KAAK,MAAM;AAEd,QAAO;;;;;;;;;;eAUM,YAAY;;YAEf,KAAK,KAAK;eACP,KAAK,QAAQ;cACd,aAAa,KAAK,MAAM,CAAC;oBACnB,aAAa,KAAK,YAAY,CAAC;eACpC,aAAa,KAAK,OAAO,CAAC;kBACvB,KAAK,UAAU;eAClB,KAAK,OAAO,KAAK,UAAU,IAAI,MAAM,GAAG,CAAC,KAAK,KAAK,CAAC;aACtD,KAAK,KAAK,KAAK,QAAQ,IAAI,IAAI,GAAG,CAAC,KAAK,KAAK,CAAC;;;EAGzD,KAAK,cAAc,qBAAqB,KAAK,YAAY,QAAQ,GAAG;EACpE,UAAU;;;EAGV,gBAAgB;;;IAId,KAAK,YAAY,SAAS,IACtB;cACM,KAAK,YAAY,KAAK,SAAS,IAAI,KAAK,GAAG,CAAC,KAAK,KAAK,CAAC;QAE7D,4BACL;;;;AAKH,SAAS,WAAW,MAAiD;CACnE,MAAMA,QAAkB;EACtB;EACA,cAAc,KAAK,GAAG;EACtB,gBAAgB,KAAK,KAAK;EAC1B,iBAAiB,aAAa,KAAK,MAAM,CAAC;EAC3C;AACD,KAAI,KAAK,YACP,OAAM,KAAK,uBAAuB,aAAa,KAAK,YAAY,CAAC,IAAI;CAGvE,MAAMC,cAAwB,EAAE;AAChC,KAAI,KAAK,UACP,aAAY,KACV,uBAAuB,KAAK,UAAU,KAAK,cAAc,KAAK,UAAU,QAAQ,IACjF;AAEH,KAAI,KAAK,KACP,aAAY,KACV,iBAAiB,KAAK,KAAK,IAAI,cAAc,KAAK,KAAK,QAAQ,IAChE;AAEH,KAAI,YAAY,OACd,OAAM,KAAK,mBAAmB,YAAY,KAAK,KAAK,CAAC,KAAK;AAG5D,OAAM,KAAK,QAAQ;AACnB,QAAO,MAAM,KAAK,KAAK"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-types.d.ts","names":[],"sources":["../../src/types/analysis-types.ts"],"sourcesContent":[],"mappings":";;;;AAgCA;AAYA;AAKA;AAQA;AAWiB,KA1DL,gBAAA,GA0DmB,WAAA,GAAA,OAAA,GAAA,cAAA,GAAA,SAAA,GAAA,YAAA,GAAA,WAAA,GAAA,MAAA,GAAA,WAAA,GAAA,UAAA,GAAA,YAAA,GAAA,aAAA,GAAA,WAAA,GAAA,WAAA,GAAA,YAAA,GAAA,QAAA,GAAA,WAAA,GAAA,SAAA;;;;AAoBb,KAxDN,OAAA,GAwDM,WAAA,GAAA,OAAA,GAAA,cAAA,GAAA,YAAA,GAAA,YAAA,GAAA,QAAA,GAAA,MAAA;;;;AAQD,KApDL,qBAAA,GAoDsB,SAAA,GAAA,OAAA,GAAA,SAAA;;;;AAajB,UA5DA,OAAA,CA4DA;EACF,GAAA,EAAA,MAAA;EAID,OAAA,EAAA,MAAA;;;;;AAWF,UApEK,YAAA,CAoEW;EAKX,IAAA,EAxET,OAwES;EAWA,GAAA,EAAA,MAAA;EAOA,OAAA,EAAA,MAAY;EAUjB,UAAA,EAAA,MAAa;EAKR,UAAA,CAAA,EAAA,MAAgB;;;;;UA/FhB,cAAA;;YAEL;;;SAGH;cACK;;;;;;;;;;kBAcI;eACH;aACF;;;;;UAMI,iBAAA;;;;;;cAMH;;;cAKA;UACJ;iBACO;eACF;;cAID;cACA;;;QAIiB;UAAe;;;;;;KAMlC,gBAAA;;;;UAKK,gBAAA;QACT;;;;;;;;;UAUS,mBAAA;;;;;;UAOA,YAAA;;;;;;;;;KAUL,aAAA,GAAgB,YAAY;;;;UAKvB,gBAAA"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"generation-types.d.ts","names":[],"sources":["../../src/types/generation-types.ts"],"sourcesContent":[],"mappings":";;;;AAmBA;AASA;AAKA;AAKY,UA7BK,mBAAA,CA6BQ;EAkBR,QAAA,EAAA,QAAe,GAAA,QAAA,GAAA,QAAA,GAAA,QAAA;EA6BnB,KAAA,CAAA,EAAA,MAAA;EAiBI,QAAA,CAAA,EAAA,MAAA;EASA,MAAA,CAAA,EAAA,OAAA;;;;;UA5FA,gBAAA;;;YAGL;;;;;KAMA,gBAAA;;;;KAKA,UAAA;;;;KAKA,aAAA;;;;UAkBK,eAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA6BJ,0BAA0B;;;;UAiBtB,qBAAA;;SAER;qBACY;;;;;UAMJ,qBAAA"}

package/dist/types/generation-types.js

@@ -0,0 +1,21 @@
+//#region src/types/generation-types.ts
+/**
+* Default workspace configuration.
+*/
+const DEFAULT_WORKSPACE_CONFIG = {
+	aiProvider: "claude",
+	agentMode: "simple",
+	outputDir: "./src",
+	conventions: {
+		operations: "interactions/commands|queries",
+		events: "events",
+		presentations: "presentations",
+		forms: "forms"
+	},
+	defaultOwners: [],
+	defaultTags: []
+};
+
+//#endregion
+export { DEFAULT_WORKSPACE_CONFIG };
+//# sourceMappingURL=generation-types.js.map

package/dist/types/generation-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation-types.js","names":["DEFAULT_WORKSPACE_CONFIG: WorkspaceConfig"],"sources":["../../src/types/generation-types.ts"],"sourcesContent":["/**\n * Code generation related type definitions.\n */\n\nimport type { SpecType, OpKind, PresentationKind } from './spec-types';\n\n/**\n * AI provider options for generation.\n */\nexport interface AIGenerationOptions {\n  provider: 'claude' | 'openai' | 'ollama' | 'custom';\n  model?: string;\n  endpoint?: string;\n  stream?: boolean;\n}\n\n/**\n * Result of code generation.\n */\nexport interface GenerationResult {\n  code: string;\n  filePath: string;\n  specType: SpecType;\n}\n\n/**\n * Build target types.\n */\nexport type GenerationTarget = 'handler' | 'component' | 'form';\n\n/**\n * Test target types.\n */\nexport type TestTarget = 'handler' | 'component';\n\n/**\n * Spec build type detected during build.\n */\nexport type SpecBuildType =\n  | 'operation'\n  | 'presentation'\n  | 'form'\n  | 'event'\n  | 'workflow'\n  | 'data-view'\n  | 'telemetry'\n  | 'migration'\n  | 'experiment'\n  | 'app-config'\n  | 'integration'\n  | 'knowledge'\n  | 'unknown';\n\n/**\n * Configuration for workspace operations.\n */\nexport interface WorkspaceConfig {\n  aiProvider: 'claude' | 'openai' | 'ollama' | 'custom';\n  aiModel?: string;\n  agentMode: 'simple' | 'cursor' | 'claude-code' | 'openai-codex';\n  customEndpoint?: string | null;\n  customApiKey?: string | null;\n  outputDir: string;\n  conventions: {\n    operations: string;\n    events: string;\n    presentations: string;\n    forms: string;\n    workflows?: string;\n    'data-views'?: string;\n    dataViews?: string;\n    migrations?: string;\n    telemetry?: string;\n    experiments?: string;\n    appConfig?: string;\n    integrations?: string;\n    knowledge?: string;\n  };\n  defaultOwners: string[];\n  defaultTags: string[];\n}\n\n/**\n * Default workspace configuration.\n */\nexport const DEFAULT_WORKSPACE_CONFIG: WorkspaceConfig = {\n  aiProvider: 'claude',\n  agentMode: 'simple',\n  outputDir: './src',\n  conventions: {\n    operations: 'interactions/commands|queries',\n    events: 'events',\n    presentations: 'presentations',\n    forms: 'forms',\n  },\n  defaultOwners: [],\n  defaultTags: [],\n};\n\n/**\n * AI prompt context for spec generation.\n */\nexport interface SpecGenerationContext {\n  description: string;\n  kind?: OpKind;\n  presentationKind?: PresentationKind;\n}\n\n/**\n * AI prompt context for code generation.\n */\nexport interface CodeGenerationContext {\n  specCode: string;\n  targetPath?: string;\n  existingCode?: string;\n}\n"],"mappings":";;;;AAqFA,MAAaA,2BAA4C;CACvD,YAAY;CACZ,WAAW;CACX,WAAW;CACX,aAAa;EACX,YAAY;EACZ,QAAQ;EACR,eAAe;EACf,OAAO;EACR;CACD,eAAe,EAAE;CACjB,aAAa,EAAE;CAChB"}