@contractspec/bundle.workspace 1.44.0

package/dist/services/integrity.d.ts

@@ -0,0 +1,134 @@
+import { FsAdapter } from "../ports/fs.js";
+import { LoggerAdapter } from "../ports/logger.js";
+import { AnalyzedSpecType, FeatureScanResult, RefInfo } from "@contractspec/module.workspace";
+
+//#region src/services/integrity.d.ts
+
+/**
+ * Options for integrity analysis.
+ */
+interface IntegrityAnalysisOptions {
+  /**
+   * Glob pattern for file discovery.
+   */
+  pattern?: string;
+  /**
+   * Scan all packages in monorepo.
+   */
+  all?: boolean;
+  /**
+   * Analyze only a specific feature by key.
+   */
+  featureKey?: string;
+  /**
+   * Filter by spec type.
+   */
+  specType?: AnalyzedSpecType;
+}
+/**
+ * Location of a spec in the codebase.
+ */
+interface SpecLocation {
+  key: string;
+  version: number;
+  file: string;
+  type: AnalyzedSpecType;
+  stability?: string;
+}
+/**
+ * Inventory of all discovered specs organized by type.
+ */
+interface SpecInventory {
+  operations: Map<string, SpecLocation>;
+  events: Map<string, SpecLocation>;
+  presentations: Map<string, SpecLocation>;
+  capabilities: Map<string, SpecLocation>;
+  workflows: Map<string, SpecLocation>;
+  dataViews: Map<string, SpecLocation>;
+  forms: Map<string, SpecLocation>;
+  migrations: Map<string, SpecLocation>;
+  experiments: Map<string, SpecLocation>;
+  integrations: Map<string, SpecLocation>;
+  knowledge: Map<string, SpecLocation>;
+  telemetry: Map<string, SpecLocation>;
+  appConfigs: Map<string, SpecLocation>;
+  policies: Map<string, SpecLocation>;
+  testSpecs: Map<string, SpecLocation>;
+}
+/**
+ * An integrity issue found during analysis.
+ */
+interface IntegrityIssue {
+  severity: 'error' | 'warning';
+  type: 'orphaned' | 'unresolved-ref' | 'missing-feature' | 'broken-link';
+  message: string;
+  file: string;
+  specKey?: string;
+  specType?: AnalyzedSpecType;
+  ref?: RefInfo;
+  featureKey?: string;
+}
+/**
+ * Coverage metrics by spec type.
+ */
+interface CoverageByType {
+  total: number;
+  covered: number;
+  orphaned: number;
+}
+/**
+ * Result of integrity analysis.
+ */
+interface IntegrityAnalysisResult {
+  /**
+   * All discovered specs organized by type.
+   */
+  inventory: SpecInventory;
+  /**
+   * All discovered features.
+   */
+  features: FeatureScanResult[];
+  /**
+   * Coverage metrics.
+   */
+  coverage: {
+    total: number;
+    linkedToFeature: number;
+    orphaned: number;
+    byType: Record<string, CoverageByType>;
+  };
+  /**
+   * Issues found during analysis.
+   */
+  issues: IntegrityIssue[];
+  /**
+   * Specs not linked to any feature.
+   */
+  orphanedSpecs: SpecLocation[];
+  /**
+   * Overall health status.
+   */
+  healthy: boolean;
+}
+/**
+ * Analyze contract integrity.
+ */
+declare function analyzeIntegrity(adapters: {
+  fs: FsAdapter;
+  logger: LoggerAdapter;
+}, options?: IntegrityAnalysisOptions): Promise<IntegrityAnalysisResult>;
+/**
+ * Get all specs from inventory as a flat list.
+ */
+declare function getAllSpecs(inventory: SpecInventory): SpecLocation[];
+/**
+ * Filter issues by type.
+ */
+declare function filterIssuesByType(issues: IntegrityIssue[], type: IntegrityIssue['type']): IntegrityIssue[];
+/**
+ * Filter issues by severity.
+ */
+declare function filterIssuesBySeverity(issues: IntegrityIssue[], severity: IntegrityIssue['severity']): IntegrityIssue[];
+//#endregion
+export { CoverageByType, IntegrityAnalysisOptions, IntegrityAnalysisResult, IntegrityIssue, SpecInventory, SpecLocation, analyzeIntegrity, filterIssuesBySeverity, filterIssuesByType, getAllSpecs };
+//# sourceMappingURL=integrity.d.ts.map

package/dist/services/integrity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrity.d.ts","names":[],"sources":["../../src/services/integrity.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AA+D4B,UAxCX,wBAAA,CAwCW;EAAZ;;;EAES,OAAA,CAAA,EAAA,MAAA;EAAZ;;;EAEa,GAAA,CAAA,EAAA,OAAA;EAAZ;;;EAEc,UAAA,CAAA,EAAA,MAAA;EAAZ;;;EAES,QAAA,CAAA,EA7BZ,gBA6BY;;;;;AAEb,UAzBK,YAAA,CAyBL;EACa,GAAA,EAAA,MAAA;EAAZ,OAAA,EAAA,MAAA;EAAG,IAAA,EAAA,MAAA;EAMC,IAAA,EA5BT,gBA4BuB;EAcd,SAAA,CAAA,EAAA,MAAc;AAS/B;;;;AAkBY,UA9DK,aAAA,CA8DL;EAMF,UAAA,EAnEI,GAmEJ,CAAA,MAAA,EAnEgB,YAmEhB,CAAA;EAKO,MAAA,EAvEP,GAuEO,CAAA,MAAA,EAvEK,YAuEL,CAAA;EAAY,aAAA,EAtEZ,GAsEY,CAAA,MAAA,EAtEA,YAsEA,CAAA;EAqEP,YAAA,EA1IN,GA0IM,CAAA,MAAgB,EA1IV,YA0IU,CAAA;EACpB,SAAA,EA1IL,GA0IK,CAAA,MAAA,EA1IO,YA0IP,CAAA;EAAmB,SAAA,EAzIxB,GAyIwB,CAAA,MAAA,EAzIZ,YAyIY,CAAA;EAC1B,KAAA,EAzIF,GAyIE,CAAA,MAAA,EAzIU,YAyIV,CAAA;EACA,UAAA,EAzIG,GAyIH,CAAA,MAAA,EAzIe,YAyIf,CAAA;EAAR,WAAA,EAxIY,GAwIZ,CAAA,MAAA,EAxIwB,YAwIxB,CAAA;EAAO,YAAA,EAvIM,GAuIN,CAAA,MAAA,EAvIkB,YAuIlB,CAAA;EAgRM,SAAA,EAtZH,GAsZc,CAAA,MAAA,EAtZF,YAsZc,CAAA;EAevB,SAAA,EApaH,GAoaG,CAAA,MAAkB,EApaT,YAoaS,CAAA;EACxB,UAAA,EApaI,GAoaJ,CAAA,MAAA,EApagB,YAoahB,CAAA;EACF,QAAA,EApaI,GAoaJ,CAAA,MAAA,EApagB,YAoahB,CAAA;EACL,SAAA,EApaU,GAoaV,CAAA,MAAA,EApasB,YAoatB,CAAA;;AAOH;;;AAGG,UAxac,cAAA,CAwad;EAAc,QAAA,EAAA,OAAA,GAAA,SAAA;;;;;aAlaJ;QACL;;;;;;UAOS,cAAA;;;;;;;;UASA,uBAAA;;;;aAIJ;;;;YAKD;;;;;;;;YASA,eAAe;;;;;UAMjB;;;;iBAKO;;;;;;;;;iBAqEK,gBAAA;MACJ;UAAmB;aAC1B,2BACR,QAAQ;;;;iBAgRK,WAAA,YAAuB,gBAAgB;;;;iBAevC,kBAAA,SACN,wBACF,yBACL;;;;iBAOa,sBAAA,SACN,4BACE,6BACT"}

package/dist/services/integrity.js

@@ -0,0 +1,272 @@
+import { isFeatureFile, scanAllSpecsFromSource, scanFeatureSource } from "@contractspec/module.workspace";
+
+//#region src/services/integrity.ts
+/**
+* Contract integrity analysis service.
+*
+* Analyzes contract specs and features to detect:
+* - Orphaned specs (not linked to any feature)
+* - Unresolved references (broken event/op/presentation refs)
+* - Feature coverage metrics
+*/
+/**
+* Build a spec key from name and version.
+*/
+function specKey(key, version) {
+	return `${key}.v${version}`;
+}
+/**
+* Create an empty spec inventory.
+*/
+function createEmptyInventory() {
+	return {
+		operations: /* @__PURE__ */ new Map(),
+		events: /* @__PURE__ */ new Map(),
+		presentations: /* @__PURE__ */ new Map(),
+		capabilities: /* @__PURE__ */ new Map(),
+		workflows: /* @__PURE__ */ new Map(),
+		dataViews: /* @__PURE__ */ new Map(),
+		forms: /* @__PURE__ */ new Map(),
+		migrations: /* @__PURE__ */ new Map(),
+		experiments: /* @__PURE__ */ new Map(),
+		integrations: /* @__PURE__ */ new Map(),
+		knowledge: /* @__PURE__ */ new Map(),
+		telemetry: /* @__PURE__ */ new Map(),
+		appConfigs: /* @__PURE__ */ new Map(),
+		policies: /* @__PURE__ */ new Map(),
+		testSpecs: /* @__PURE__ */ new Map()
+	};
+}
+/**
+* Get the inventory map for a spec type.
+*/
+function getInventoryMap(inventory, specType) {
+	return {
+		operation: inventory.operations,
+		event: inventory.events,
+		presentation: inventory.presentations,
+		capability: inventory.capabilities,
+		workflow: inventory.workflows,
+		"data-view": inventory.dataViews,
+		form: inventory.forms,
+		migration: inventory.migrations,
+		experiment: inventory.experiments,
+		integration: inventory.integrations,
+		knowledge: inventory.knowledge,
+		telemetry: inventory.telemetry,
+		"app-config": inventory.appConfigs,
+		policy: inventory.policies,
+		"test-spec": inventory.testSpecs
+	}[specType];
+}
+/**
+* Analyze contract integrity.
+*/
+async function analyzeIntegrity(adapters, options = {}) {
+	const { fs, logger } = adapters;
+	logger.info("Starting integrity analysis...", { options });
+	const files = await fs.glob({ pattern: options.pattern });
+	const inventory = createEmptyInventory();
+	const features = [];
+	const issues = [];
+	for (const file of files) {
+		const content = await fs.readFile(file);
+		if (isFeatureFile(file)) {
+			const feature = scanFeatureSource(content, file);
+			features.push(feature);
+		} else {
+			const specs = scanAllSpecsFromSource(content, file);
+			for (const spec of specs) if (spec.specType !== "unknown" && spec.specType !== "feature") {
+				const map = getInventoryMap(inventory, spec.specType);
+				if (map && spec.key && spec.version !== void 0) {
+					const key = specKey(spec.key, spec.version);
+					map.set(key, {
+						key: spec.key,
+						version: spec.version,
+						file: spec.filePath,
+						type: spec.specType,
+						stability: spec.stability
+					});
+				}
+			}
+		}
+	}
+	const relevantFeatures = options.featureKey ? features.filter((f) => f.key === options.featureKey) : features;
+	const referencedSpecs = /* @__PURE__ */ new Set();
+	for (const feature of relevantFeatures) {
+		for (const ref of feature.operations) {
+			const key = specKey(ref.key, ref.version);
+			referencedSpecs.add(`operation:${key}`);
+			if (!inventory.operations.has(key)) issues.push({
+				severity: "error",
+				type: "unresolved-ref",
+				message: `Operation ${ref.key}.v${ref.version} not found`,
+				file: feature.filePath,
+				featureKey: feature.key,
+				specType: "operation",
+				ref
+			});
+		}
+		for (const ref of feature.events) {
+			const key = specKey(ref.key, ref.version);
+			referencedSpecs.add(`event:${key}`);
+			if (!inventory.events.has(key)) issues.push({
+				severity: "error",
+				type: "unresolved-ref",
+				message: `Event ${ref.key}.v${ref.version} not found`,
+				file: feature.filePath,
+				featureKey: feature.key,
+				specType: "event",
+				ref
+			});
+		}
+		for (const ref of feature.presentations) {
+			const key = specKey(ref.key, ref.version);
+			referencedSpecs.add(`presentation:${key}`);
+			if (!inventory.presentations.has(key)) issues.push({
+				severity: "error",
+				type: "unresolved-ref",
+				message: `Presentation ${ref.key}.v${ref.version} not found`,
+				file: feature.filePath,
+				featureKey: feature.key,
+				specType: "presentation",
+				ref
+			});
+		}
+		for (const ref of feature.experiments) {
+			const key = specKey(ref.key, ref.version);
+			referencedSpecs.add(`experiment:${key}`);
+			if (!inventory.experiments.has(key)) issues.push({
+				severity: "error",
+				type: "unresolved-ref",
+				message: `Experiment ${ref.key}.v${ref.version} not found`,
+				file: feature.filePath,
+				featureKey: feature.key,
+				specType: "experiment",
+				ref
+			});
+		}
+		for (const ref of feature.capabilities.provides) {
+			const key = specKey(ref.key, ref.version);
+			referencedSpecs.add(`capability:${key}`);
+			if (!inventory.capabilities.has(key)) issues.push({
+				severity: "warning",
+				type: "unresolved-ref",
+				message: `Provided capability ${ref.key}.v${ref.version} not found`,
+				file: feature.filePath,
+				featureKey: feature.key,
+				specType: "capability",
+				ref
+			});
+		}
+		for (const ref of feature.capabilities.requires) {
+			const key = specKey(ref.key, ref.version);
+			referencedSpecs.add(`capability:${key}`);
+		}
+		for (const link of feature.opToPresentationLinks) {
+			const opKey = specKey(link.op.key, link.op.version);
+			const presKey = specKey(link.pres.key, link.pres.version);
+			if (!inventory.operations.has(opKey)) issues.push({
+				severity: "error",
+				type: "broken-link",
+				message: `Linked operation ${link.op.key}.v${link.op.version} not found`,
+				file: feature.filePath,
+				featureKey: feature.key,
+				specType: "operation",
+				ref: link.op
+			});
+			if (!inventory.presentations.has(presKey)) issues.push({
+				severity: "error",
+				type: "broken-link",
+				message: `Linked presentation ${link.pres.key}.v${link.pres.version} not found`,
+				file: feature.filePath,
+				featureKey: feature.key,
+				specType: "presentation",
+				ref: link.pres
+			});
+		}
+	}
+	const orphanedSpecs = [];
+	const typesThatCanBeOrphaned = [
+		"operation",
+		"event",
+		"presentation",
+		"experiment"
+	];
+	for (const type of typesThatCanBeOrphaned) {
+		const map = getInventoryMap(inventory, type);
+		if (!map) continue;
+		for (const [key, location] of map) if (!referencedSpecs.has(`${type}:${key}`)) {
+			orphanedSpecs.push(location);
+			issues.push({
+				severity: "warning",
+				type: "orphaned",
+				message: `${type} ${location.key}.v${location.version} is not linked to any feature`,
+				file: location.file,
+				specKey: location.key,
+				specType: location.type
+			});
+		}
+	}
+	const coverageByType = {};
+	for (const type of typesThatCanBeOrphaned) {
+		const map = getInventoryMap(inventory, type);
+		if (!map) continue;
+		const total = map.size;
+		let covered = 0;
+		for (const key of map.keys()) if (referencedSpecs.has(`${type}:${key}`)) covered++;
+		coverageByType[type] = {
+			total,
+			covered,
+			orphaned: total - covered
+		};
+	}
+	const totalSpecs = Object.values(coverageByType).reduce((sum, c) => sum + c.total, 0);
+	const coveredSpecs = Object.values(coverageByType).reduce((sum, c) => sum + c.covered, 0);
+	const coverage = {
+		total: totalSpecs,
+		linkedToFeature: coveredSpecs,
+		orphaned: totalSpecs - coveredSpecs,
+		byType: coverageByType
+	};
+	const healthy = !issues.some((i) => i.severity === "error");
+	logger.info("Integrity analysis complete", {
+		features: features.length,
+		totalSpecs,
+		orphaned: orphanedSpecs.length,
+		issues: issues.length,
+		healthy
+	});
+	return {
+		inventory,
+		features: relevantFeatures,
+		coverage,
+		issues,
+		orphanedSpecs,
+		healthy
+	};
+}
+/**
+* Get all specs from inventory as a flat list.
+*/
+function getAllSpecs(inventory) {
+	const all = [];
+	for (const map of Object.values(inventory)) for (const spec of map.values()) all.push(spec);
+	return all;
+}
+/**
+* Filter issues by type.
+*/
+function filterIssuesByType(issues, type) {
+	return issues.filter((i) => i.type === type);
+}
+/**
+* Filter issues by severity.
+*/
+function filterIssuesBySeverity(issues, severity) {
+	return issues.filter((i) => i.severity === severity);
+}
+
+//#endregion
+export { analyzeIntegrity, filterIssuesBySeverity, filterIssuesByType, getAllSpecs };
+//# sourceMappingURL=integrity.js.map

package/dist/services/integrity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrity.js","names":["features: FeatureScanResult[]","issues: IntegrityIssue[]","orphanedSpecs: SpecLocation[]","typesThatCanBeOrphaned: AnalyzedSpecType[]","coverageByType: Record<string, CoverageByType>","all: SpecLocation[]"],"sources":["../../src/services/integrity.ts"],"sourcesContent":["/**\n * Contract integrity analysis service.\n *\n * Analyzes contract specs and features to detect:\n * - Orphaned specs (not linked to any feature)\n * - Unresolved references (broken event/op/presentation refs)\n * - Feature coverage metrics\n */\n\nimport {\n  type AnalyzedSpecType,\n  type FeatureScanResult,\n  isFeatureFile,\n  type RefInfo,\n  scanAllSpecsFromSource,\n  scanFeatureSource,\n} from '@contractspec/module.workspace';\nimport type { FsAdapter } from '../ports/fs';\nimport type { LoggerAdapter } from '../ports/logger';\n\n/**\n * Options for integrity analysis.\n */\nexport interface IntegrityAnalysisOptions {\n  /**\n   * Glob pattern for file discovery.\n   */\n  pattern?: string;\n\n  /**\n   * Scan all packages in monorepo.\n   */\n  all?: boolean;\n\n  /**\n   * Analyze only a specific feature by key.\n   */\n  featureKey?: string;\n\n  /**\n   * Filter by spec type.\n   */\n  specType?: AnalyzedSpecType;\n}\n\n/**\n * Location of a spec in the codebase.\n */\nexport interface SpecLocation {\n  key: string;\n  version: number;\n  file: string;\n  type: AnalyzedSpecType;\n  stability?: string;\n}\n\n/**\n * Inventory of all discovered specs organized by type.\n */\nexport interface SpecInventory {\n  operations: Map<string, SpecLocation>;\n  events: Map<string, SpecLocation>;\n  presentations: Map<string, SpecLocation>;\n  capabilities: Map<string, SpecLocation>;\n  workflows: Map<string, SpecLocation>;\n  dataViews: Map<string, SpecLocation>;\n  forms: Map<string, SpecLocation>;\n  migrations: Map<string, SpecLocation>;\n  experiments: Map<string, SpecLocation>;\n  integrations: Map<string, SpecLocation>;\n  knowledge: Map<string, SpecLocation>;\n  telemetry: Map<string, SpecLocation>;\n  appConfigs: Map<string, SpecLocation>;\n  policies: Map<string, SpecLocation>;\n  testSpecs: Map<string, SpecLocation>;\n}\n\n/**\n * An integrity issue found during analysis.\n */\nexport interface IntegrityIssue {\n  severity: 'error' | 'warning';\n  type: 'orphaned' | 'unresolved-ref' | 'missing-feature' | 'broken-link';\n  message: string;\n  file: string;\n  specKey?: string;\n  specType?: AnalyzedSpecType;\n  ref?: RefInfo;\n  featureKey?: string;\n}\n\n/**\n * Coverage metrics by spec type.\n */\nexport interface CoverageByType {\n  total: number;\n  covered: number;\n  orphaned: number;\n}\n\n/**\n * Result of integrity analysis.\n */\nexport interface IntegrityAnalysisResult {\n  /**\n   * All discovered specs organized by type.\n   */\n  inventory: SpecInventory;\n\n  /**\n   * All discovered features.\n   */\n  features: FeatureScanResult[];\n\n  /**\n   * Coverage metrics.\n   */\n  coverage: {\n    total: number;\n    linkedToFeature: number;\n    orphaned: number;\n    byType: Record<string, CoverageByType>;\n  };\n\n  /**\n   * Issues found during analysis.\n   */\n  issues: IntegrityIssue[];\n\n  /**\n   * Specs not linked to any feature.\n   */\n  orphanedSpecs: SpecLocation[];\n\n  /**\n   * Overall health status.\n   */\n  healthy: boolean;\n}\n\n/**\n * Build a spec key from name and version.\n */\nfunction specKey(key: string, version: number): string {\n  return `${key}.v${version}`;\n}\n\n/**\n * Create an empty spec inventory.\n */\nfunction createEmptyInventory(): SpecInventory {\n  return {\n    operations: new Map(),\n    events: new Map(),\n    presentations: new Map(),\n    capabilities: new Map(),\n    workflows: new Map(),\n    dataViews: new Map(),\n    forms: new Map(),\n    migrations: new Map(),\n    experiments: new Map(),\n    integrations: new Map(),\n    knowledge: new Map(),\n    telemetry: new Map(),\n    appConfigs: new Map(),\n    policies: new Map(),\n    testSpecs: new Map(),\n  };\n}\n\n/**\n * Get the inventory map for a spec type.\n */\nfunction getInventoryMap(\n  inventory: SpecInventory,\n  specType: AnalyzedSpecType\n): Map<string, SpecLocation> | undefined {\n  const typeToMap: Record<string, Map<string, SpecLocation>> = {\n    operation: inventory.operations,\n    event: inventory.events,\n    presentation: inventory.presentations,\n    capability: inventory.capabilities,\n    workflow: inventory.workflows,\n    'data-view': inventory.dataViews,\n    form: inventory.forms,\n    migration: inventory.migrations,\n    experiment: inventory.experiments,\n    integration: inventory.integrations,\n    knowledge: inventory.knowledge,\n    telemetry: inventory.telemetry,\n    'app-config': inventory.appConfigs,\n    policy: inventory.policies,\n    'test-spec': inventory.testSpecs,\n  };\n\n  return typeToMap[specType];\n}\n\n/**\n * Analyze contract integrity.\n */\nexport async function analyzeIntegrity(\n  adapters: { fs: FsAdapter; logger: LoggerAdapter },\n  options: IntegrityAnalysisOptions = {}\n): Promise<IntegrityAnalysisResult> {\n  const { fs, logger } = adapters;\n\n  logger.info('Starting integrity analysis...', { options });\n\n  // Discover all spec and feature files\n  const files = await fs.glob({ pattern: options.pattern });\n\n  const inventory = createEmptyInventory();\n  const features: FeatureScanResult[] = [];\n  const issues: IntegrityIssue[] = [];\n\n  // Scan all files\n  for (const file of files) {\n    const content = await fs.readFile(file);\n\n    if (isFeatureFile(file)) {\n      // Scan as feature\n      const feature = scanFeatureSource(content, file);\n      features.push(feature);\n    } else {\n      // Scan as spec - use the multi-spec scanner to find ALL specs in the file\n      const specs = scanAllSpecsFromSource(content, file);\n\n      for (const spec of specs) {\n        if (spec.specType !== 'unknown' && spec.specType !== 'feature') {\n          const map = getInventoryMap(inventory, spec.specType);\n\n          if (map && spec.key && spec.version !== undefined) {\n            const key = specKey(spec.key, spec.version);\n            map.set(key, {\n              key: spec.key,\n              version: spec.version,\n              file: spec.filePath,\n              type: spec.specType,\n              stability: spec.stability,\n            });\n          }\n        }\n      }\n    }\n  }\n\n  // Filter features if featureKey is specified\n  const relevantFeatures = options.featureKey\n    ? features.filter((f) => f.key === options.featureKey)\n    : features;\n\n  // Build set of specs referenced by features\n  const referencedSpecs = new Set<string>();\n\n  for (const feature of relevantFeatures) {\n    // Check operation refs\n    for (const ref of feature.operations) {\n      const key = specKey(ref.key, ref.version);\n      referencedSpecs.add(`operation:${key}`);\n\n      if (!inventory.operations.has(key)) {\n        issues.push({\n          severity: 'error',\n          type: 'unresolved-ref',\n          message: `Operation ${ref.key}.v${ref.version} not found`,\n          file: feature.filePath,\n          featureKey: feature.key,\n          specType: 'operation',\n          ref,\n        });\n      }\n    }\n\n    // Check event refs\n    for (const ref of feature.events) {\n      const key = specKey(ref.key, ref.version);\n      referencedSpecs.add(`event:${key}`);\n\n      if (!inventory.events.has(key)) {\n        issues.push({\n          severity: 'error',\n          type: 'unresolved-ref',\n          message: `Event ${ref.key}.v${ref.version} not found`,\n          file: feature.filePath,\n          featureKey: feature.key,\n          specType: 'event',\n          ref,\n        });\n      }\n    }\n\n    // Check presentation refs\n    for (const ref of feature.presentations) {\n      const key = specKey(ref.key, ref.version);\n      referencedSpecs.add(`presentation:${key}`);\n\n      if (!inventory.presentations.has(key)) {\n        issues.push({\n          severity: 'error',\n          type: 'unresolved-ref',\n          message: `Presentation ${ref.key}.v${ref.version} not found`,\n          file: feature.filePath,\n          featureKey: feature.key,\n          specType: 'presentation',\n          ref,\n        });\n      }\n    }\n\n    // Check experiment refs\n    for (const ref of feature.experiments) {\n      const key = specKey(ref.key, ref.version);\n      referencedSpecs.add(`experiment:${key}`);\n\n      if (!inventory.experiments.has(key)) {\n        issues.push({\n          severity: 'error',\n          type: 'unresolved-ref',\n          message: `Experiment ${ref.key}.v${ref.version} not found`,\n          file: feature.filePath,\n          featureKey: feature.key,\n          specType: 'experiment',\n          ref,\n        });\n      }\n    }\n\n    // Check capability refs (provides and requires)\n    for (const ref of feature.capabilities.provides) {\n      const key = specKey(ref.key, ref.version);\n      referencedSpecs.add(`capability:${key}`);\n\n      if (!inventory.capabilities.has(key)) {\n        issues.push({\n          severity: 'warning',\n          type: 'unresolved-ref',\n          message: `Provided capability ${ref.key}.v${ref.version} not found`,\n          file: feature.filePath,\n          featureKey: feature.key,\n          specType: 'capability',\n          ref,\n        });\n      }\n    }\n\n    for (const ref of feature.capabilities.requires) {\n      const key = specKey(ref.key, ref.version);\n      // Required capabilities are expected to be provided by other features\n      // We just track the reference\n      referencedSpecs.add(`capability:${key}`);\n    }\n\n    // Check op to presentation links\n    for (const link of feature.opToPresentationLinks) {\n      const opKey = specKey(link.op.key, link.op.version);\n      const presKey = specKey(link.pres.key, link.pres.version);\n\n      if (!inventory.operations.has(opKey)) {\n        issues.push({\n          severity: 'error',\n          type: 'broken-link',\n          message: `Linked operation ${link.op.key}.v${link.op.version} not found`,\n          file: feature.filePath,\n          featureKey: feature.key,\n          specType: 'operation',\n          ref: link.op,\n        });\n      }\n\n      if (!inventory.presentations.has(presKey)) {\n        issues.push({\n          severity: 'error',\n          type: 'broken-link',\n          message: `Linked presentation ${link.pres.key}.v${link.pres.version} not found`,\n          file: feature.filePath,\n          featureKey: feature.key,\n          specType: 'presentation',\n          ref: link.pres,\n        });\n      }\n    }\n  }\n\n  // Find orphaned specs (not referenced by any feature)\n  const orphanedSpecs: SpecLocation[] = [];\n  const typesThatCanBeOrphaned: AnalyzedSpecType[] = [\n    'operation',\n    'event',\n    'presentation',\n    'experiment',\n  ];\n\n  for (const type of typesThatCanBeOrphaned) {\n    const map = getInventoryMap(inventory, type);\n    if (!map) continue;\n\n    for (const [key, location] of map) {\n      if (!referencedSpecs.has(`${type}:${key}`)) {\n        orphanedSpecs.push(location);\n        issues.push({\n          severity: 'warning',\n          type: 'orphaned',\n          message: `${type} ${location.key}.v${location.version} is not linked to any feature`,\n          file: location.file,\n          specKey: location.key,\n          specType: location.type,\n        });\n      }\n    }\n  }\n\n  // Calculate coverage metrics\n  const coverageByType: Record<string, CoverageByType> = {};\n\n  for (const type of typesThatCanBeOrphaned) {\n    const map = getInventoryMap(inventory, type);\n    if (!map) continue;\n\n    const total = map.size;\n    let covered = 0;\n\n    for (const key of map.keys()) {\n      if (referencedSpecs.has(`${type}:${key}`)) {\n        covered++;\n      }\n    }\n\n    coverageByType[type] = {\n      total,\n      covered,\n      orphaned: total - covered,\n    };\n  }\n\n  const totalSpecs = Object.values(coverageByType).reduce(\n    (sum, c) => sum + c.total,\n    0\n  );\n  const coveredSpecs = Object.values(coverageByType).reduce(\n    (sum, c) => sum + c.covered,\n    0\n  );\n\n  const coverage = {\n    total: totalSpecs,\n    linkedToFeature: coveredSpecs,\n    orphaned: totalSpecs - coveredSpecs,\n    byType: coverageByType,\n  };\n\n  // Determine overall health\n  const hasErrors = issues.some((i) => i.severity === 'error');\n  const healthy = !hasErrors;\n\n  logger.info('Integrity analysis complete', {\n    features: features.length,\n    totalSpecs,\n    orphaned: orphanedSpecs.length,\n    issues: issues.length,\n    healthy,\n  });\n\n  return {\n    inventory,\n    features: relevantFeatures,\n    coverage,\n    issues,\n    orphanedSpecs,\n    healthy,\n  };\n}\n\n/**\n * Get all specs from inventory as a flat list.\n */\nexport function getAllSpecs(inventory: SpecInventory): SpecLocation[] {\n  const all: SpecLocation[] = [];\n\n  for (const map of Object.values(inventory)) {\n    for (const spec of map.values()) {\n      all.push(spec);\n    }\n  }\n\n  return all;\n}\n\n/**\n * Filter issues by type.\n */\nexport function filterIssuesByType(\n  issues: IntegrityIssue[],\n  type: IntegrityIssue['type']\n): IntegrityIssue[] {\n  return issues.filter((i) => i.type === type);\n}\n\n/**\n * Filter issues by severity.\n */\nexport function filterIssuesBySeverity(\n  issues: IntegrityIssue[],\n  severity: IntegrityIssue['severity']\n): IntegrityIssue[] {\n  return issues.filter((i) => i.severity === severity);\n}\n"],"mappings":"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"}

package/dist/services/list.d.ts

@@ -0,0 +1,31 @@
+import { FsAdapter } from "../ports/fs.js";
+import { SpecScanResult } from "@contractspec/module.workspace";
+
+//#region src/services/list.d.ts
+
+/**
+ * Options for listing specs.
+ */
+interface ListSpecsOptions {
+  /**
+   * File pattern to search.
+   */
+  pattern?: string;
+  /**
+   * Filter by spec type.
+   */
+  type?: string;
+}
+/**
+ * List all spec files in the workspace.
+ */
+declare function listSpecs(adapters: {
+  fs: FsAdapter;
+}, options?: ListSpecsOptions): Promise<SpecScanResult[]>;
+/**
+ * Group specs by type.
+ */
+declare function groupSpecsByType(specs: SpecScanResult[]): Map<string, SpecScanResult[]>;
+//#endregion
+export { ListSpecsOptions, groupSpecsByType, listSpecs };
+//# sourceMappingURL=list.d.ts.map

package/dist/services/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","names":[],"sources":["../../src/services/list.ts"],"sourcesContent":[],"mappings":";;;;;AA4BA;;;AAGW,UAlBM,gBAAA,CAkBN;EAAR;;AAuBH;EACS,OAAA,CAAA,EAAA,MAAA;EACM;;;;;;;;iBA5BO,SAAA;MACJ;aACP,mBACR,QAAQ;;;;iBAuBK,gBAAA,QACP,mBACN,YAAY"}

package/dist/services/list.js

@@ -0,0 +1,36 @@
+import { scanSpecSource } from "@contractspec/module.workspace";
+
+//#region src/services/list.ts
+/**
+* List specs service.
+*/
+/**
+* List all spec files in the workspace.
+*/
+async function listSpecs(adapters, options = {}) {
+	const { fs } = adapters;
+	const files = await fs.glob({ pattern: options.pattern });
+	const results = [];
+	for (const file of files) {
+		const result = scanSpecSource(await fs.readFile(file), file);
+		if (options.type && result.specType !== options.type) continue;
+		results.push(result);
+	}
+	return results;
+}
+/**
+* Group specs by type.
+*/
+function groupSpecsByType(specs) {
+	const groups = /* @__PURE__ */ new Map();
+	for (const spec of specs) {
+		const group = groups.get(spec.specType) ?? [];
+		group.push(spec);
+		groups.set(spec.specType, group);
+	}
+	return groups;
+}
+
+//#endregion
+export { groupSpecsByType, listSpecs };
+//# sourceMappingURL=list.js.map

package/dist/services/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","names":["results: SpecScanResult[]"],"sources":["../../src/services/list.ts"],"sourcesContent":["/**\n * List specs service.\n */\n\nimport {\n  scanSpecSource,\n  type SpecScanResult,\n} from '@contractspec/module.workspace';\nimport type { FsAdapter } from '../ports/fs';\n\n/**\n * Options for listing specs.\n */\nexport interface ListSpecsOptions {\n  /**\n   * File pattern to search.\n   */\n  pattern?: string;\n\n  /**\n   * Filter by spec type.\n   */\n  type?: string;\n}\n\n/**\n * List all spec files in the workspace.\n */\nexport async function listSpecs(\n  adapters: { fs: FsAdapter },\n  options: ListSpecsOptions = {}\n): Promise<SpecScanResult[]> {\n  const { fs } = adapters;\n\n  const files = await fs.glob({ pattern: options.pattern });\n  const results: SpecScanResult[] = [];\n\n  for (const file of files) {\n    const content = await fs.readFile(file);\n    const result = scanSpecSource(content, file);\n\n    if (options.type && result.specType !== options.type) {\n      continue;\n    }\n\n    results.push(result);\n  }\n\n  return results;\n}\n\n/**\n * Group specs by type.\n */\nexport function groupSpecsByType(\n  specs: SpecScanResult[]\n): Map<string, SpecScanResult[]> {\n  const groups = new Map<string, SpecScanResult[]>();\n\n  for (const spec of specs) {\n    const group = groups.get(spec.specType) ?? [];\n    group.push(spec);\n    groups.set(spec.specType, group);\n  }\n\n  return groups;\n}\n"],"mappings":";;;;;;;;;AA4BA,eAAsB,UACpB,UACA,UAA4B,EAAE,EACH;CAC3B,MAAM,EAAE,OAAO;CAEf,MAAM,QAAQ,MAAM,GAAG,KAAK,EAAE,SAAS,QAAQ,SAAS,CAAC;CACzD,MAAMA,UAA4B,EAAE;AAEpC,MAAK,MAAM,QAAQ,OAAO;EAExB,MAAM,SAAS,eADC,MAAM,GAAG,SAAS,KAAK,EACA,KAAK;AAE5C,MAAI,QAAQ,QAAQ,OAAO,aAAa,QAAQ,KAC9C;AAGF,UAAQ,KAAK,OAAO;;AAGtB,QAAO;;;;;AAMT,SAAgB,iBACd,OAC+B;CAC/B,MAAM,yBAAS,IAAI,KAA+B;AAElD,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,QAAQ,OAAO,IAAI,KAAK,SAAS,IAAI,EAAE;AAC7C,QAAM,KAAK,KAAK;AAChB,SAAO,IAAI,KAAK,UAAU,MAAM;;AAGlC,QAAO"}

package/dist/services/openapi/export-service.d.ts

@@ -0,0 +1,53 @@
+import { FsAdapter } from "../../ports/fs.js";
+import { LoggerAdapter } from "../../ports/logger.js";
+import { OpenApiDocument, OpenApiServer } from "@contractspec/lib.contracts";
+
+//#region src/services/openapi/export-service.d.ts
+
+/**
+ * Options for OpenAPI export.
+ */
+interface OpenApiExportOptions {
+  /**
+   * Path to module exporting OperationSpecRegistry.
+   */
+  registryPath: string;
+  /**
+   * Output file path.
+   */
+  outputPath?: string;
+  /**
+   * OpenAPI title.
+   */
+  title?: string;
+  /**
+   * OpenAPI version.
+   */
+  version?: string;
+  /**
+   * OpenAPI description.
+   */
+  description?: string;
+  /**
+   * Server URLs to include.
+   */
+  servers?: OpenApiServer[];
+}
+/**
+ * Result of OpenAPI export.
+ */
+interface OpenApiExportResult {
+  document: OpenApiDocument;
+  outputPath: string;
+  json: string;
+}
+/**
+ * Export OpenAPI document from a OperationSpecRegistry.
+ */
+declare function exportOpenApi(options: OpenApiExportOptions, adapters: {
+  fs: FsAdapter;
+  logger: LoggerAdapter;
+}): Promise<OpenApiExportResult>;
+//#endregion
+export { OpenApiExportOptions, OpenApiExportResult, exportOpenApi };
+//# sourceMappingURL=export-service.d.ts.map

package/dist/services/openapi/export-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-service.d.ts","names":[],"sources":["../../../src/services/openapi/export-service.ts"],"sourcesContent":[],"mappings":";;;;;;AAmDA;AAkBA;;AAEkB,UAvDD,oBAAA,CAuDC;EAAmB;;;EAC3B,YAAA,EAAA,MAAA;;;;;;;;;;;;;;;;;;;;YA3BE;;;;;UAMK,mBAAA;YACL;;;;;;;iBAiBU,aAAA,UACX;MACO;UAAmB;IAClC,QAAQ"}

package/dist/services/openapi/export-service.js

@@ -0,0 +1,50 @@
+import { OperationSpecRegistry, openApiForRegistry } from "@contractspec/lib.contracts";
+
+//#region src/services/openapi/export-service.ts
+/**
+* OpenAPI export service - generates OpenAPI documents from OperationSpecRegistry.
+*/
+/**
+* Export OpenAPI document from a OperationSpecRegistry.
+*/
+async function exportOpenApi(options, adapters) {
+	const { fs, logger } = adapters;
+	const { registryPath, outputPath = "./openapi.json" } = options;
+	logger.info("Loading registry...", { registryPath });
+	const registry = await loadRegistry(registryPath, fs);
+	logger.info("Generating OpenAPI document...");
+	const document = openApiForRegistry(registry, {
+		title: options.title,
+		version: options.version,
+		description: options.description,
+		servers: options.servers
+	});
+	const json = JSON.stringify(document, null, 2) + "\n";
+	const resolvedPath = fs.resolve(outputPath);
+	await fs.mkdir(fs.dirname(resolvedPath));
+	await fs.writeFile(resolvedPath, json);
+	logger.info(`OpenAPI document written to ${resolvedPath}`);
+	return {
+		document,
+		outputPath: resolvedPath,
+		json
+	};
+}
+/**
+* Load a OperationSpecRegistry from a module.
+*/
+async function loadRegistry(modulePath, fs) {
+	const exports = await import(fs.resolve(modulePath));
+	if (exports instanceof OperationSpecRegistry) return exports;
+	if (exports.registry instanceof OperationSpecRegistry) return exports.registry;
+	const factory = typeof exports.createRegistry === "function" ? exports.createRegistry : typeof exports.default === "function" ? exports.default : void 0;
+	if (factory) {
+		const result = await factory();
+		if (result instanceof OperationSpecRegistry) return result;
+	}
+	throw new Error(`Registry module ${modulePath} must export a OperationSpecRegistry instance or a factory function returning one.`);
+}
+
+//#endregion
+export { exportOpenApi };
+//# sourceMappingURL=export-service.js.map

package/dist/services/openapi/export-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-service.js","names":[],"sources":["../../../src/services/openapi/export-service.ts"],"sourcesContent":["/**\n * OpenAPI export service - generates OpenAPI documents from OperationSpecRegistry.\n */\n\nimport {\n  type OpenApiDocument,\n  openApiForRegistry,\n  type OpenApiServer,\n  OperationSpecRegistry,\n} from '@contractspec/lib.contracts';\nimport type { FsAdapter } from '../../ports/fs';\nimport type { LoggerAdapter } from '../../ports/logger';\n\n/**\n * Options for OpenAPI export.\n */\nexport interface OpenApiExportOptions {\n  /**\n   * Path to module exporting OperationSpecRegistry.\n   */\n  registryPath: string;\n\n  /**\n   * Output file path.\n   */\n  outputPath?: string;\n\n  /**\n   * OpenAPI title.\n   */\n  title?: string;\n\n  /**\n   * OpenAPI version.\n   */\n  version?: string;\n\n  /**\n   * OpenAPI description.\n   */\n  description?: string;\n\n  /**\n   * Server URLs to include.\n   */\n  servers?: OpenApiServer[];\n}\n\n/**\n * Result of OpenAPI export.\n */\nexport interface OpenApiExportResult {\n  document: OpenApiDocument;\n  outputPath: string;\n  json: string;\n}\n\n/**\n * Module that exports a OperationSpecRegistry.\n */\ninterface LoadedRegistryModule {\n  default?: unknown;\n  createRegistry?: () => Promise<OperationSpecRegistry> | OperationSpecRegistry;\n  registry?: OperationSpecRegistry;\n}\n\n/**\n * Export OpenAPI document from a OperationSpecRegistry.\n */\nexport async function exportOpenApi(\n  options: OpenApiExportOptions,\n  adapters: { fs: FsAdapter; logger: LoggerAdapter }\n): Promise<OpenApiExportResult> {\n  const { fs, logger } = adapters;\n  const { registryPath, outputPath = './openapi.json' } = options;\n\n  logger.info('Loading registry...', { registryPath });\n\n  // Load the registry\n  const registry = await loadRegistry(registryPath, fs);\n\n  logger.info('Generating OpenAPI document...');\n\n  // Generate OpenAPI document\n  const document = openApiForRegistry(registry, {\n    title: options.title,\n    version: options.version,\n    description: options.description,\n    servers: options.servers,\n  });\n\n  // Serialize to JSON\n  const json = JSON.stringify(document, null, 2) + '\\n';\n\n  // Resolve output path\n  const resolvedPath = fs.resolve(outputPath);\n\n  // Ensure directory exists\n  await fs.mkdir(fs.dirname(resolvedPath));\n\n  // Write file\n  await fs.writeFile(resolvedPath, json);\n\n  logger.info(`OpenAPI document written to ${resolvedPath}`);\n\n  return {\n    document,\n    outputPath: resolvedPath,\n    json,\n  };\n}\n\n/**\n * Load a OperationSpecRegistry from a module.\n */\nasync function loadRegistry(\n  modulePath: string,\n  fs: FsAdapter\n): Promise<OperationSpecRegistry> {\n  // Resolve absolute path\n  const absPath = fs.resolve(modulePath);\n\n  // Dynamic import\n  const exports = (await import(absPath)) as LoadedRegistryModule;\n\n  // Check if exports is already a registry\n  if (exports instanceof OperationSpecRegistry) {\n    return exports;\n  }\n\n  // Check if registry property exists\n  if (exports.registry instanceof OperationSpecRegistry) {\n    return exports.registry;\n  }\n\n  // Check for factory function\n  const factory =\n    typeof exports.createRegistry === 'function'\n      ? exports.createRegistry\n      : typeof exports.default === 'function'\n        ? (exports.default as () =>\n            | Promise<OperationSpecRegistry>\n            | OperationSpecRegistry)\n        : undefined;\n\n  if (factory) {\n    const result = await factory();\n    if (result instanceof OperationSpecRegistry) {\n      return result;\n    }\n  }\n\n  throw new Error(\n    `Registry module ${modulePath} must export a OperationSpecRegistry instance or a factory function returning one.`\n  );\n}\n"],"mappings":";;;;;;;;;AAqEA,eAAsB,cACpB,SACA,UAC8B;CAC9B,MAAM,EAAE,IAAI,WAAW;CACvB,MAAM,EAAE,cAAc,aAAa,qBAAqB;AAExD,QAAO,KAAK,uBAAuB,EAAE,cAAc,CAAC;CAGpD,MAAM,WAAW,MAAM,aAAa,cAAc,GAAG;AAErD,QAAO,KAAK,iCAAiC;CAG7C,MAAM,WAAW,mBAAmB,UAAU;EAC5C,OAAO,QAAQ;EACf,SAAS,QAAQ;EACjB,aAAa,QAAQ;EACrB,SAAS,QAAQ;EAClB,CAAC;CAGF,MAAM,OAAO,KAAK,UAAU,UAAU,MAAM,EAAE,GAAG;CAGjD,MAAM,eAAe,GAAG,QAAQ,WAAW;AAG3C,OAAM,GAAG,MAAM,GAAG,QAAQ,aAAa,CAAC;AAGxC,OAAM,GAAG,UAAU,cAAc,KAAK;AAEtC,QAAO,KAAK,+BAA+B,eAAe;AAE1D,QAAO;EACL;EACA,YAAY;EACZ;EACD;;;;;AAMH,eAAe,aACb,YACA,IACgC;CAKhC,MAAM,UAAW,MAAM,OAHP,GAAG,QAAQ,WAAW;AAMtC,KAAI,mBAAmB,sBACrB,QAAO;AAIT,KAAI,QAAQ,oBAAoB,sBAC9B,QAAO,QAAQ;CAIjB,MAAM,UACJ,OAAO,QAAQ,mBAAmB,aAC9B,QAAQ,iBACR,OAAO,QAAQ,YAAY,aACxB,QAAQ,UAGT;AAER,KAAI,SAAS;EACX,MAAM,SAAS,MAAM,SAAS;AAC9B,MAAI,kBAAkB,sBACpB,QAAO;;AAIX,OAAM,IAAI,MACR,mBAAmB,WAAW,oFAC/B"}

package/dist/services/openapi/import-service.d.ts

@@ -0,0 +1,17 @@
+import { FsAdapter } from "../../ports/fs.js";
+import { LoggerAdapter } from "../../ports/logger.js";
+import { OpenApiImportServiceOptions, OpenApiImportServiceResult } from "./types.js";
+import { ContractsrcConfig } from "@contractspec/lib.contracts";
+
+//#region src/services/openapi/import-service.d.ts
+
+/**
+ * Import ContractSpec specs from an OpenAPI document.
+ */
+declare function importFromOpenApiService(contractspecOptions: ContractsrcConfig, options: OpenApiImportServiceOptions, adapters: {
+  fs: FsAdapter;
+  logger: LoggerAdapter;
+}): Promise<OpenApiImportServiceResult>;
+//#endregion
+export { importFromOpenApiService };
+//# sourceMappingURL=import-service.d.ts.map

package/dist/services/openapi/import-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-service.d.ts","names":[],"sources":["../../../src/services/openapi/import-service.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAuBqC,iBAHf,wBAAA,CAGe,mBAAA,EAFd,iBAEc,EAAA,OAAA,EAD1B,2BAC0B,EAAA,QAAA,EAAA;EAC1B,EAAA,EADO,SACP;EAAR,MAAA,EADkC,aAClC;CAAO,CAAA,EAAP,OAAO,CAAC,0BAAD,CAAA"}