@lssm/bundle.contractspec-workspace 0.0.0-canary-20251217080011 → 1.41.0

package/dist/services/integrity-diagram.js

@@ -1,274 +1,6 @@
-//#region src/services/integrity-diagram.ts
-/**
-* Generate a Mermaid diagram from integrity analysis results.
-*/
-function generateMermaidDiagram(result, type = "feature-map", options = {}) {
-	switch (type) {
-		case "feature-map": return generateFeatureMapDiagram(result, options);
-		case "orphans": return generateOrphansDiagram(result, options);
-		case "dependencies": return generateDependenciesDiagram(result, options);
-		case "full": return generateFullDiagram(result, options);
-		default: return generateFeatureMapDiagram(result, options);
-	}
-}
-/**
-* Generate a feature map diagram showing features and their linked specs.
-*/
-function generateFeatureMapDiagram(result, options) {
-	const { direction = "LR", showVersions = true, maxNodes = 50 } = options;
-	const lines = [`flowchart ${direction}`];
-	let features = result.features;
-	if (options.featureKeys && options.featureKeys.length > 0) features = features.filter((f) => options.featureKeys.includes(f.key));
-	let nodeCount = 0;
-	if (features.length > 0) {
-		lines.push("    subgraph features [Features]");
-		for (const feature of features) {
-			if (nodeCount >= maxNodes) break;
-			const nodeId = sanitizeId(`F_${feature.key}`);
-			const label = feature.title ?? feature.key;
-			lines.push(`        ${nodeId}["${escapeLabel(label)}"]`);
-			nodeCount++;
-		}
-		lines.push("    end");
-	}
-	const ops = getReferencedSpecs(features, "operations", result.inventory);
-	if (ops.length > 0 && nodeCount < maxNodes) {
-		lines.push("    subgraph ops [Operations]");
-		for (const op of ops) {
-			if (nodeCount >= maxNodes) break;
-			const nodeId = sanitizeId(`O_${op.name}_v${op.version}`);
-			const label = showVersions ? `${op.name}.v${op.version}` : op.name;
-			lines.push(`        ${nodeId}["${escapeLabel(label)}"]`);
-			nodeCount++;
-		}
-		lines.push("    end");
-	}
-	const events = getReferencedSpecs(features, "events", result.inventory);
-	if (events.length > 0 && nodeCount < maxNodes) {
-		lines.push("    subgraph events [Events]");
-		for (const event of events) {
-			if (nodeCount >= maxNodes) break;
-			const nodeId = sanitizeId(`E_${event.name}_v${event.version}`);
-			const label = showVersions ? `${event.name}.v${event.version}` : event.name;
-			lines.push(`        ${nodeId}["${escapeLabel(label)}"]`);
-			nodeCount++;
-		}
-		lines.push("    end");
-	}
-	const presentations = getReferencedSpecs(features, "presentations", result.inventory);
-	if (presentations.length > 0 && nodeCount < maxNodes) {
-		lines.push("    subgraph presentations [Presentations]");
-		for (const pres of presentations) {
-			if (nodeCount >= maxNodes) break;
-			const nodeId = sanitizeId(`P_${pres.name}_v${pres.version}`);
-			const label = showVersions ? `${pres.name}.v${pres.version}` : pres.name;
-			lines.push(`        ${nodeId}["${escapeLabel(label)}"]`);
-			nodeCount++;
-		}
-		lines.push("    end");
-	}
-	for (const feature of features) {
-		const featureId = sanitizeId(`F_${feature.key}`);
-		for (const op of feature.operations) {
-			const opId = sanitizeId(`O_${op.name}_v${op.version}`);
-			lines.push(`    ${featureId} --> ${opId}`);
-		}
-		for (const event of feature.events) {
-			const eventId = sanitizeId(`E_${event.name}_v${event.version}`);
-			lines.push(`    ${featureId} -.-> ${eventId}`);
-		}
-		for (const pres of feature.presentations) {
-			const presId = sanitizeId(`P_${pres.name}_v${pres.version}`);
-			lines.push(`    ${featureId} --> ${presId}`);
-		}
-	}
-	return lines.join("\n");
-}
-/**
-* Generate a diagram highlighting orphaned specs.
-*/
-function generateOrphansDiagram(result, options) {
-	const { direction = "TB", showVersions = true, maxNodes = 50 } = options;
-	const lines = [`flowchart ${direction}`];
-	const linkedOps = /* @__PURE__ */ new Set();
-	const linkedEvents = /* @__PURE__ */ new Set();
-	const linkedPres = /* @__PURE__ */ new Set();
-	for (const feature of result.features) {
-		for (const op of feature.operations) linkedOps.add(`${op.name}.v${op.version}`);
-		for (const event of feature.events) linkedEvents.add(`${event.name}.v${event.version}`);
-		for (const pres of feature.presentations) linkedPres.add(`${pres.name}.v${pres.version}`);
-	}
-	let nodeCount = 0;
-	if (result.features.length > 0) {
-		lines.push("    subgraph features [Features]");
-		for (const feature of result.features) {
-			if (nodeCount >= maxNodes) break;
-			const nodeId = sanitizeId(`F_${feature.key}`);
-			lines.push(`        ${nodeId}["${escapeLabel(feature.title ?? feature.key)}"]`);
-			nodeCount++;
-		}
-		lines.push("    end");
-	}
-	if (result.orphanedSpecs.length > 0) {
-		lines.push("    subgraph orphaned [Orphaned Specs]");
-		for (const spec of result.orphanedSpecs) {
-			if (nodeCount >= maxNodes) break;
-			const nodeId = sanitizeId(`orphan_${spec.type}_${spec.name}_v${spec.version}`);
-			const label = showVersions ? `${spec.name}.v${spec.version}` : spec.name;
-			lines.push(`        ${nodeId}["${escapeLabel(label)}"]`);
-			nodeCount++;
-		}
-		lines.push("    end");
-	}
-	const allLinked = [];
-	for (const key of linkedOps) {
-		const [name, version] = parseSpecKey(key);
-		if (name && version) allLinked.push({
-			type: "operation",
-			name,
-			version
-		});
-	}
-	for (const key of linkedEvents) {
-		const [name, version] = parseSpecKey(key);
-		if (name && version) allLinked.push({
-			type: "event",
-			name,
-			version
-		});
-	}
-	for (const key of linkedPres) {
-		const [name, version] = parseSpecKey(key);
-		if (name && version) allLinked.push({
-			type: "presentation",
-			name,
-			version
-		});
-	}
-	if (allLinked.length > 0 && nodeCount < maxNodes) {
-		lines.push("    subgraph linked [Linked Specs]");
-		for (const spec of allLinked) {
-			if (nodeCount >= maxNodes) break;
-			const nodeId = sanitizeId(`${spec.type}_${spec.name}_v${spec.version}`);
-			const label = showVersions ? `${spec.name}.v${spec.version}` : spec.name;
-			lines.push(`        ${nodeId}["${escapeLabel(label)}"]`);
-			nodeCount++;
-		}
-		lines.push("    end");
-	}
-	for (const feature of result.features) {
-		const featureId = sanitizeId(`F_${feature.key}`);
-		for (const op of feature.operations) {
-			const opId = sanitizeId(`operation_${op.name}_v${op.version}`);
-			lines.push(`    ${featureId} --> ${opId}`);
-		}
-		for (const event of feature.events) {
-			const eventId = sanitizeId(`event_${event.name}_v${event.version}`);
-			lines.push(`    ${featureId} -.-> ${eventId}`);
-		}
-		for (const pres of feature.presentations) {
-			const presId = sanitizeId(`presentation_${pres.name}_v${pres.version}`);
-			lines.push(`    ${featureId} --> ${presId}`);
-		}
-	}
-	return lines.join("\n");
-}
-/**
-* Generate a dependency diagram showing spec relationships.
-*/
-function generateDependenciesDiagram(result, options) {
-	const { direction = "TB", showVersions = true, maxNodes = 50 } = options;
-	const lines = [`flowchart ${direction}`];
-	let nodeCount = 0;
-	for (const feature of result.features) {
-		if (nodeCount >= maxNodes) break;
-		const featureId = sanitizeId(`F_${feature.key}`);
-		lines.push(`    ${featureId}["${escapeLabel(feature.title ?? feature.key)}"]`);
-		nodeCount++;
-		for (const op of feature.operations) {
-			if (nodeCount >= maxNodes) break;
-			const opId = sanitizeId(`O_${op.name}_v${op.version}`);
-			const label = showVersions ? `${op.name}.v${op.version}` : op.name;
-			lines.push(`    ${opId}["${escapeLabel(label)}"]`);
-			lines.push(`    ${featureId} --> ${opId}`);
-			nodeCount++;
-		}
-		for (const event of feature.events) {
-			if (nodeCount >= maxNodes) break;
-			const eventId = sanitizeId(`E_${event.name}_v${event.version}`);
-			const label = showVersions ? `${event.name}.v${event.version}` : event.name;
-			lines.push(`    ${eventId}["${escapeLabel(label)}"]`);
-			lines.push(`    ${featureId} -.-> ${eventId}`);
-			nodeCount++;
-		}
-		for (const pres of feature.presentations) {
-			if (nodeCount >= maxNodes) break;
-			const presId = sanitizeId(`P_${pres.name}_v${pres.version}`);
-			const label = showVersions ? `${pres.name}.v${pres.version}` : pres.name;
-			lines.push(`    ${presId}["${escapeLabel(label)}"]`);
-			lines.push(`    ${featureId} --> ${presId}`);
-			nodeCount++;
-		}
-		for (const link of feature.opToPresentationLinks) {
-			const opId = sanitizeId(`O_${link.op.name}_v${link.op.version}`);
-			const presId = sanitizeId(`P_${link.pres.name}_v${link.pres.version}`);
-			lines.push(`    ${opId} --> ${presId}`);
-		}
-	}
-	return lines.join("\n");
-}
-/**
-* Generate a full diagram with all relationships.
-*/
-function generateFullDiagram(result, options) {
-	const featureMap = generateFeatureMapDiagram(result, options);
-	if (result.orphanedSpecs.length === 0) return featureMap;
-	const lines = featureMap.split("\n");
-	lines.push("    subgraph orphaned [Orphaned Specs]");
-	for (const spec of result.orphanedSpecs.slice(0, 20)) {
-		const nodeId = sanitizeId(`orphan_${spec.type}_${spec.name}_v${spec.version}`);
-		const label = `${spec.name}.v${spec.version}`;
-		lines.push(`        ${nodeId}["${escapeLabel(label)}"]:::orphan`);
-	}
-	lines.push("    end");
-	lines.push("    classDef orphan stroke-dasharray: 5 5");
-	return lines.join("\n");
-}
-/**
-* Get referenced specs from features.
-*/
-function getReferencedSpecs(features, field, _inventory) {
-	const seen = /* @__PURE__ */ new Set();
-	const result = [];
-	for (const feature of features) for (const ref of feature[field]) {
-		const key = `${ref.name}.v${ref.version}`;
-		if (!seen.has(key)) {
-			seen.add(key);
-			result.push(ref);
-		}
-	}
-	return result;
-}
-/**
-* Parse a spec key like "name.v1" into [name, version].
-*/
-function parseSpecKey(key) {
-	const match = key.match(/^(.+)\.v(\d+)$/);
-	if (!match) return [void 0, void 0];
-	return [match[1], Number(match[2])];
-}
-/**
-* Sanitize an ID for use in Mermaid.
-*/
-function sanitizeId(id) {
-	return id.replace(/[^a-zA-Z0-9_]/g, "_");
-}
-/**
-* Escape a label for use in Mermaid.
-*/
-function escapeLabel(label) {
-	return label.replace(/"/g, "'").replace(/\[/g, "(").replace(/\]/g, ")").replace(/\{/g, "(").replace(/\}/g, ")");
-}
-
-//#endregion
-export { generateMermaidDiagram };
+function e(e,a=`feature-map`,o={}){switch(a){case`feature-map`:return t(e,o);case`orphans`:return n(e,o);case`dependencies`:return r(e,o);case`full`:return i(e,o);default:return t(e,o)}}function t(e,t){let{direction:n=`LR`,showVersions:r=!0,maxNodes:i=50}=t,o=[`flowchart ${n}`],l=e.features;t.featureKeys&&t.featureKeys.length>0&&(l=l.filter(e=>t.featureKeys.includes(e.key)));let u=0;if(l.length>0){o.push(`    subgraph features [Features]`);for(let e of l){if(u>=i)break;let t=s(`F_${e.key}`),n=e.title??e.key;o.push(`        ${t}["${c(n)}"]`),u++}o.push(`    end`)}let d=a(l,`operations`,e.inventory);if(d.length>0&&u<i){o.push(`    subgraph ops [Operations]`);for(let e of d){if(u>=i)break;let t=s(`O_${e.name}_v${e.version}`),n=r?`${e.name}.v${e.version}`:e.name;o.push(`        ${t}["${c(n)}"]`),u++}o.push(`    end`)}let f=a(l,`events`,e.inventory);if(f.length>0&&u<i){o.push(`    subgraph events [Events]`);for(let e of f){if(u>=i)break;let t=s(`E_${e.name}_v${e.version}`),n=r?`${e.name}.v${e.version}`:e.name;o.push(`        ${t}["${c(n)}"]`),u++}o.push(`    end`)}let p=a(l,`presentations`,e.inventory);if(p.length>0&&u<i){o.push(`    subgraph presentations [Presentations]`);for(let e of p){if(u>=i)break;let t=s(`P_${e.name}_v${e.version}`),n=r?`${e.name}.v${e.version}`:e.name;o.push(`        ${t}["${c(n)}"]`),u++}o.push(`    end`)}for(let e of l){let t=s(`F_${e.key}`);for(let n of e.operations){let e=s(`O_${n.name}_v${n.version}`);o.push(`    ${t} --> ${e}`)}for(let n of e.events){let e=s(`E_${n.name}_v${n.version}`);o.push(`    ${t} -.-> ${e}`)}for(let n of e.presentations){let e=s(`P_${n.name}_v${n.version}`);o.push(`    ${t} --> ${e}`)}}return o.join(`
+`)}function n(e,t){let{direction:n=`TB`,showVersions:r=!0,maxNodes:i=50}=t,a=[`flowchart ${n}`],l=new Set,u=new Set,d=new Set;for(let t of e.features){for(let e of t.operations)l.add(`${e.name}.v${e.version}`);for(let e of t.events)u.add(`${e.name}.v${e.version}`);for(let e of t.presentations)d.add(`${e.name}.v${e.version}`)}let f=0;if(e.features.length>0){a.push(`    subgraph features [Features]`);for(let t of e.features){if(f>=i)break;let e=s(`F_${t.key}`);a.push(`        ${e}["${c(t.title??t.key)}"]`),f++}a.push(`    end`)}if(e.orphanedSpecs.length>0){a.push(`    subgraph orphaned [Orphaned Specs]`);for(let t of e.orphanedSpecs){if(f>=i)break;let e=s(`orphan_${t.type}_${t.name}_v${t.version}`),n=r?`${t.name}.v${t.version}`:t.name;a.push(`        ${e}["${c(n)}"]`),f++}a.push(`    end`)}let p=[];for(let e of l){let[t,n]=o(e);t&&n&&p.push({type:`operation`,name:t,version:n})}for(let e of u){let[t,n]=o(e);t&&n&&p.push({type:`event`,name:t,version:n})}for(let e of d){let[t,n]=o(e);t&&n&&p.push({type:`presentation`,name:t,version:n})}if(p.length>0&&f<i){a.push(`    subgraph linked [Linked Specs]`);for(let e of p){if(f>=i)break;let t=s(`${e.type}_${e.name}_v${e.version}`),n=r?`${e.name}.v${e.version}`:e.name;a.push(`        ${t}["${c(n)}"]`),f++}a.push(`    end`)}for(let t of e.features){let e=s(`F_${t.key}`);for(let n of t.operations){let t=s(`operation_${n.name}_v${n.version}`);a.push(`    ${e} --> ${t}`)}for(let n of t.events){let t=s(`event_${n.name}_v${n.version}`);a.push(`    ${e} -.-> ${t}`)}for(let n of t.presentations){let t=s(`presentation_${n.name}_v${n.version}`);a.push(`    ${e} --> ${t}`)}}return a.join(`
+`)}function r(e,t){let{direction:n=`TB`,showVersions:r=!0,maxNodes:i=50}=t,a=[`flowchart ${n}`],o=0;for(let t of e.features){if(o>=i)break;let e=s(`F_${t.key}`);a.push(`    ${e}["${c(t.title??t.key)}"]`),o++;for(let n of t.operations){if(o>=i)break;let t=s(`O_${n.name}_v${n.version}`),l=r?`${n.name}.v${n.version}`:n.name;a.push(`    ${t}["${c(l)}"]`),a.push(`    ${e} --> ${t}`),o++}for(let n of t.events){if(o>=i)break;let t=s(`E_${n.name}_v${n.version}`),l=r?`${n.name}.v${n.version}`:n.name;a.push(`    ${t}["${c(l)}"]`),a.push(`    ${e} -.-> ${t}`),o++}for(let n of t.presentations){if(o>=i)break;let t=s(`P_${n.name}_v${n.version}`),l=r?`${n.name}.v${n.version}`:n.name;a.push(`    ${t}["${c(l)}"]`),a.push(`    ${e} --> ${t}`),o++}for(let e of t.opToPresentationLinks){let t=s(`O_${e.op.name}_v${e.op.version}`),n=s(`P_${e.pres.name}_v${e.pres.version}`);a.push(`    ${t} --> ${n}`)}}return a.join(`
+`)}function i(e,n){let r=t(e,n);if(e.orphanedSpecs.length===0)return r;let i=r.split(`
+`);i.push(`    subgraph orphaned [Orphaned Specs]`);for(let t of e.orphanedSpecs.slice(0,20)){let e=s(`orphan_${t.type}_${t.name}_v${t.version}`),n=`${t.name}.v${t.version}`;i.push(`        ${e}["${c(n)}"]:::orphan`)}return i.push(`    end`),i.push(`    classDef orphan stroke-dasharray: 5 5`),i.join(`
+`)}function a(e,t,n){let r=new Set,i=[];for(let n of e)for(let e of n[t]){let t=`${e.name}.v${e.version}`;r.has(t)||(r.add(t),i.push(e))}return i}function o(e){let t=e.match(/^(.+)\.v(\d+)$/);return t?[t[1],Number(t[2])]:[void 0,void 0]}function s(e){return e.replace(/[^a-zA-Z0-9_]/g,`_`)}function c(e){return e.replace(/"/g,`'`).replace(/\[/g,`(`).replace(/\]/g,`)`).replace(/\{/g,`(`).replace(/\}/g,`)`)}export{e as generateMermaidDiagram};

package/dist/services/integrity.js

@@ -1,272 +1 @@
-import { scanAllSpecsFromSource } from "../modules/contractspec-workspace/dist/analysis/spec-scan.js";
-import { isFeatureFile, scanFeatureSource } from "../modules/contractspec-workspace/dist/analysis/feature-scan.js";
-
-//#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(name, version) {
-	return `${name}.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.name && spec.version !== void 0) {
-					const key = specKey(spec.name, spec.version);
-					map.set(key, {
-						name: spec.name,
-						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.name, ref.version);
-			referencedSpecs.add(`operation:${key}`);
-			if (!inventory.operations.has(key)) issues.push({
-				severity: "error",
-				type: "unresolved-ref",
-				message: `Operation ${ref.name}.v${ref.version} not found`,
-				file: feature.filePath,
-				featureKey: feature.key,
-				specType: "operation",
-				ref
-			});
-		}
-		for (const ref of feature.events) {
-			const key = specKey(ref.name, ref.version);
-			referencedSpecs.add(`event:${key}`);
-			if (!inventory.events.has(key)) issues.push({
-				severity: "error",
-				type: "unresolved-ref",
-				message: `Event ${ref.name}.v${ref.version} not found`,
-				file: feature.filePath,
-				featureKey: feature.key,
-				specType: "event",
-				ref
-			});
-		}
-		for (const ref of feature.presentations) {
-			const key = specKey(ref.name, ref.version);
-			referencedSpecs.add(`presentation:${key}`);
-			if (!inventory.presentations.has(key)) issues.push({
-				severity: "error",
-				type: "unresolved-ref",
-				message: `Presentation ${ref.name}.v${ref.version} not found`,
-				file: feature.filePath,
-				featureKey: feature.key,
-				specType: "presentation",
-				ref
-			});
-		}
-		for (const ref of feature.experiments) {
-			const key = specKey(ref.name, ref.version);
-			referencedSpecs.add(`experiment:${key}`);
-			if (!inventory.experiments.has(key)) issues.push({
-				severity: "error",
-				type: "unresolved-ref",
-				message: `Experiment ${ref.name}.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.name, ref.version);
-			referencedSpecs.add(`capability:${key}`);
-			if (!inventory.capabilities.has(key)) issues.push({
-				severity: "warning",
-				type: "unresolved-ref",
-				message: `Provided capability ${ref.name}.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.name, ref.version);
-			referencedSpecs.add(`capability:${key}`);
-		}
-		for (const link of feature.opToPresentationLinks) {
-			const opKey = specKey(link.op.name, link.op.version);
-			const presKey = specKey(link.pres.name, link.pres.version);
-			if (!inventory.operations.has(opKey)) issues.push({
-				severity: "error",
-				type: "broken-link",
-				message: `Linked operation ${link.op.name}.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.name}.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.name}.v${location.version} is not linked to any feature`,
-				file: location.file,
-				specName: location.name,
-				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 };
+import{isFeatureFile as e,scanAllSpecsFromSource as t,scanFeatureSource as n}from"@lssm/module.contractspec-workspace";function r(e,t){return`${e}.v${t}`}function i(){return{operations:new Map,events:new Map,presentations:new Map,capabilities:new Map,workflows:new Map,dataViews:new Map,forms:new Map,migrations:new Map,experiments:new Map,integrations:new Map,knowledge:new Map,telemetry:new Map,appConfigs:new Map,policies:new Map,testSpecs:new Map}}function a(e,t){return{operation:e.operations,event:e.events,presentation:e.presentations,capability:e.capabilities,workflow:e.workflows,"data-view":e.dataViews,form:e.forms,migration:e.migrations,experiment:e.experiments,integration:e.integrations,knowledge:e.knowledge,telemetry:e.telemetry,"app-config":e.appConfigs,policy:e.policies,"test-spec":e.testSpecs}[t]}async function o(o,s={}){let{fs:c,logger:l}=o;l.info(`Starting integrity analysis...`,{options:s});let u=await c.glob({pattern:s.pattern}),d=i(),f=[],p=[];for(let i of u){let o=await c.readFile(i);if(e(i)){let e=n(o,i);f.push(e)}else{let e=t(o,i);for(let t of e)if(t.specType!==`unknown`&&t.specType!==`feature`){let e=a(d,t.specType);if(e&&t.name&&t.version!==void 0){let n=r(t.name,t.version);e.set(n,{name:t.name,version:t.version,file:t.filePath,type:t.specType,stability:t.stability})}}}}let m=s.featureKey?f.filter(e=>e.key===s.featureKey):f,h=new Set;for(let e of m){for(let t of e.operations){let n=r(t.name,t.version);h.add(`operation:${n}`),d.operations.has(n)||p.push({severity:`error`,type:`unresolved-ref`,message:`Operation ${t.name}.v${t.version} not found`,file:e.filePath,featureKey:e.key,specType:`operation`,ref:t})}for(let t of e.events){let n=r(t.name,t.version);h.add(`event:${n}`),d.events.has(n)||p.push({severity:`error`,type:`unresolved-ref`,message:`Event ${t.name}.v${t.version} not found`,file:e.filePath,featureKey:e.key,specType:`event`,ref:t})}for(let t of e.presentations){let n=r(t.name,t.version);h.add(`presentation:${n}`),d.presentations.has(n)||p.push({severity:`error`,type:`unresolved-ref`,message:`Presentation ${t.name}.v${t.version} not found`,file:e.filePath,featureKey:e.key,specType:`presentation`,ref:t})}for(let t of e.experiments){let n=r(t.name,t.version);h.add(`experiment:${n}`),d.experiments.has(n)||p.push({severity:`error`,type:`unresolved-ref`,message:`Experiment ${t.name}.v${t.version} not found`,file:e.filePath,featureKey:e.key,specType:`experiment`,ref:t})}for(let t of e.capabilities.provides){let n=r(t.name,t.version);h.add(`capability:${n}`),d.capabilities.has(n)||p.push({severity:`warning`,type:`unresolved-ref`,message:`Provided capability ${t.name}.v${t.version} not found`,file:e.filePath,featureKey:e.key,specType:`capability`,ref:t})}for(let t of e.capabilities.requires){let e=r(t.name,t.version);h.add(`capability:${e}`)}for(let t of e.opToPresentationLinks){let n=r(t.op.name,t.op.version),i=r(t.pres.name,t.pres.version);d.operations.has(n)||p.push({severity:`error`,type:`broken-link`,message:`Linked operation ${t.op.name}.v${t.op.version} not found`,file:e.filePath,featureKey:e.key,specType:`operation`,ref:t.op}),d.presentations.has(i)||p.push({severity:`error`,type:`broken-link`,message:`Linked presentation ${t.pres.name}.v${t.pres.version} not found`,file:e.filePath,featureKey:e.key,specType:`presentation`,ref:t.pres})}}let g=[],_=[`operation`,`event`,`presentation`,`experiment`];for(let e of _){let t=a(d,e);if(t)for(let[n,r]of t)h.has(`${e}:${n}`)||(g.push(r),p.push({severity:`warning`,type:`orphaned`,message:`${e} ${r.name}.v${r.version} is not linked to any feature`,file:r.file,specName:r.name,specType:r.type}))}let v={};for(let e of _){let t=a(d,e);if(!t)continue;let n=t.size,r=0;for(let n of t.keys())h.has(`${e}:${n}`)&&r++;v[e]={total:n,covered:r,orphaned:n-r}}let y=Object.values(v).reduce((e,t)=>e+t.total,0),b=Object.values(v).reduce((e,t)=>e+t.covered,0),x={total:y,linkedToFeature:b,orphaned:y-b,byType:v},S=!p.some(e=>e.severity===`error`);return l.info(`Integrity analysis complete`,{features:f.length,totalSpecs:y,orphaned:g.length,issues:p.length,healthy:S}),{inventory:d,features:m,coverage:x,issues:p,orphanedSpecs:g,healthy:S}}function s(e){let t=[];for(let n of Object.values(e))for(let e of n.values())t.push(e);return t}function c(e,t){return e.filter(e=>e.type===t)}function l(e,t){return e.filter(e=>e.severity===t)}export{o as analyzeIntegrity,l as filterIssuesBySeverity,c as filterIssuesByType,s as getAllSpecs};

package/dist/services/list.js

@@ -1,35 +1 @@
-import { scanSpecSource } from "../modules/contractspec-workspace/dist/analysis/spec-scan.js";
-
-//#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 };
+import{scanSpecSource as e}from"@lssm/module.contractspec-workspace";async function t(t,n={}){let{fs:r}=t,i=await r.glob({pattern:n.pattern}),a=[];for(let t of i){let i=e(await r.readFile(t),t);n.type&&i.specType!==n.type||a.push(i)}return a}function n(e){let t=new Map;for(let n of e){let e=t.get(n.specType)??[];e.push(n),t.set(n.specType,e)}return t}export{n as groupSpecsByType,t as listSpecs};

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

@@ -1,51 +1,2 @@
-import { SpecRegistry } from "../../libs/contracts/dist/registry.js";
-import { openApiForRegistry } from "../../libs/contracts/dist/openapi.js";
-import "../../libs/contracts/dist/index.js";
-
-//#region src/services/openapi/export-service.ts
-/**
-* OpenAPI export service - generates OpenAPI documents from SpecRegistry.
-*/
-/**
-* Export OpenAPI document from a SpecRegistry.
-*/
-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 SpecRegistry from a module.
-*/
-async function loadRegistry(modulePath, fs) {
-	const exports = await import(fs.resolve(modulePath));
-	if (exports instanceof SpecRegistry) return exports;
-	if (exports.registry instanceof SpecRegistry) 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 SpecRegistry) return result;
-	}
-	throw new Error(`Registry module ${modulePath} must export a SpecRegistry instance or a factory function returning one.`);
-}
-
-//#endregion
-export { exportOpenApi };
+import{SpecRegistry as e,openApiForRegistry as t}from"@lssm/lib.contracts";async function n(e,n){let{fs:i,logger:a}=n,{registryPath:o,outputPath:s=`./openapi.json`}=e;a.info(`Loading registry...`,{registryPath:o});let c=await r(o,i);a.info(`Generating OpenAPI document...`);let l=t(c,{title:e.title,version:e.version,description:e.description,servers:e.servers}),u=JSON.stringify(l,null,2)+`
+`,d=i.resolve(s);return await i.mkdir(i.dirname(d)),await i.writeFile(d,u),a.info(`OpenAPI document written to ${d}`),{document:l,outputPath:d,json:u}}async function r(t,n){let r=await import(n.resolve(t));if(r instanceof e)return r;if(r.registry instanceof e)return r.registry;let i=typeof r.createRegistry==`function`?r.createRegistry:typeof r.default==`function`?r.default:void 0;if(i){let t=await i();if(t instanceof e)return t}throw Error(`Registry module ${t} must export a SpecRegistry instance or a factory function returning one.`)}export{n as exportOpenApi};