@lssm/bundle.contractspec-workspace 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217073102

package/dist/modules/contractspec-workspace/dist/analysis/deps/graph.js

@@ -1,2 +1,84 @@
-function e(e){for(let t of e.values())t.dependents=[];for(let[t,n]of e)for(let r of n.dependencies){let n=e.get(r);n&&n.dependents.push(t)}for(let t of e.values())t.dependents.sort((e,t)=>e.localeCompare(t))}function t(e){let t=new Set,n=new Set,r=[];function i(a,o){if(n.has(a)){let e=o.indexOf(a);e>=0&&r.push([...o.slice(e),a]);return}if(t.has(a))return;t.add(a),n.add(a);let s=e.get(a);if(s)for(let e of s.dependencies)i(e,[...o,a]);n.delete(a)}for(let n of e.keys())t.has(n)||i(n,[]);return r}function n(e){let t=[];for(let[n,r]of e){let i=r.dependencies.filter(t=>!e.has(t));i.length>0&&t.push({contract:n,missing:i})}return t}function r(e){let t=[];t.push(`digraph ContractDependencies {`),t.push(`  rankdir=LR;`),t.push(`  node [shape=box];`);for(let[n,r]of e){for(let e of r.dependencies)t.push(`  "${n}" -> "${e}";`);r.dependencies.length===0&&t.push(`  "${n}";`)}return t.push(`}`),t.join(`
-`)}function i(){return new Map}function a(e,t,n,r){e.set(t,{name:t,file:n,dependencies:r,dependents:[]})}export{a,e,i,n,r,t};
+//#region ../../modules/contractspec-workspace/dist/analysis/deps/graph.js
+/**
+* Build reverse edges (dependents) for all nodes in the graph.
+*/
+function buildReverseEdges(graph) {
+	for (const node of graph.values()) node.dependents = [];
+	for (const [name, node] of graph) for (const dep of node.dependencies) {
+		const depNode = graph.get(dep);
+		if (depNode) depNode.dependents.push(name);
+	}
+	for (const node of graph.values()) node.dependents.sort((a, b) => a.localeCompare(b));
+}
+/**
+* Detect circular dependencies in the graph.
+*/
+function detectCycles(graph) {
+	const visited = /* @__PURE__ */ new Set();
+	const stack = /* @__PURE__ */ new Set();
+	const cycles = [];
+	function dfs(name, path) {
+		if (stack.has(name)) {
+			const start = path.indexOf(name);
+			if (start >= 0) cycles.push([...path.slice(start), name]);
+			return;
+		}
+		if (visited.has(name)) return;
+		visited.add(name);
+		stack.add(name);
+		const node = graph.get(name);
+		if (node) for (const dep of node.dependencies) dfs(dep, [...path, name]);
+		stack.delete(name);
+	}
+	for (const name of graph.keys()) if (!visited.has(name)) dfs(name, []);
+	return cycles;
+}
+/**
+* Find missing dependencies (referenced but not defined).
+*/
+function findMissingDependencies(graph) {
+	const missing = [];
+	for (const [name, node] of graph) {
+		const absent = node.dependencies.filter((dep) => !graph.has(dep));
+		if (absent.length > 0) missing.push({
+			contract: name,
+			missing: absent
+		});
+	}
+	return missing;
+}
+/**
+* Generate DOT format output for visualization.
+*/
+function toDot(graph) {
+	const lines = [];
+	lines.push("digraph ContractDependencies {");
+	lines.push("  rankdir=LR;");
+	lines.push("  node [shape=box];");
+	for (const [name, node] of graph) {
+		for (const dep of node.dependencies) lines.push(`  "${name}" -> "${dep}";`);
+		if (node.dependencies.length === 0) lines.push(`  "${name}";`);
+	}
+	lines.push("}");
+	return lines.join("\n");
+}
+/**
+* Create an empty contract graph.
+*/
+function createContractGraph() {
+	return /* @__PURE__ */ new Map();
+}
+/**
+* Add a node to the contract graph.
+*/
+function addContractNode(graph, name, file, dependencies) {
+	graph.set(name, {
+		name,
+		file,
+		dependencies,
+		dependents: []
+	});
+}
+
+//#endregion
+export { addContractNode, buildReverseEdges, createContractGraph, detectCycles, findMissingDependencies, toDot };

package/dist/modules/contractspec-workspace/dist/analysis/deps/parse-imports.js

@@ -1 +1,30 @@
-function e(e,t){let n=[],r=/import\s+.*?\s+from\s+['"]([^'"]+\.(?:contracts|event|presentation|workflow|data-view|migration|telemetry|experiment|app-config|integration|knowledge)(?:\.[jt]s)?)['"]/g,i;for(;(i=r.exec(e))!==null;){let e=i[1];if(!e||!e.startsWith(`.`)&&!e.startsWith(`/`))continue;let t=e.split(`/`),r=(t[t.length-1]??``).replace(/\.(ts|js)$/,``).replace(/\.(contracts|event|presentation|workflow|data-view|migration|telemetry|experiment|app-config|integration|knowledge)$/,``);r.length>0&&n.push(r)}return Array.from(new Set(n)).sort((e,t)=>e.localeCompare(t))}export{e};
+//#region ../../modules/contractspec-workspace/dist/analysis/deps/parse-imports.js
+/**
+* Import parsing utilities for dependency analysis.
+* Extracted from cli-contracts/src/commands/deps/parse-imports.ts
+*/
+/**
+* Parse spec imports from source code.
+* Returns the names of imported specs based on file naming conventions.
+*
+* @param sourceCode - The source code to parse
+* @param fromFilePath - The path of the file being parsed (for relative resolution)
+* @returns Array of imported spec names
+*/
+function parseImportedSpecNames(sourceCode, _fromFilePath) {
+	const imports = [];
+	const importRegex = /import\s+.*?\s+from\s+['"]([^'"]+\.(?:contracts|event|presentation|workflow|data-view|migration|telemetry|experiment|app-config|integration|knowledge)(?:\.[jt]s)?)['"]/g;
+	let match;
+	while ((match = importRegex.exec(sourceCode)) !== null) {
+		const importPath = match[1];
+		if (!importPath) continue;
+		if (!importPath.startsWith(".") && !importPath.startsWith("/")) continue;
+		const pathParts = importPath.split("/");
+		const name = (pathParts[pathParts.length - 1] ?? "").replace(/\.(ts|js)$/, "").replace(/\.(contracts|event|presentation|workflow|data-view|migration|telemetry|experiment|app-config|integration|knowledge)$/, "");
+		if (name.length > 0) imports.push(name);
+	}
+	return Array.from(new Set(imports)).sort((a, b) => a.localeCompare(b));
+}
+
+//#endregion
+export { parseImportedSpecNames };

package/dist/modules/contractspec-workspace/dist/analysis/diff/semantic.js

@@ -1 +1,96 @@
-import{t as e}from"../spec-scan.js";function t(t,o,s,c,l={}){let u=e(t,o),d=e(s,c),f=[];return n(f,`specType`,u.specType,d.specType,{breaking:!0,label:`Spec type`}),n(f,`name`,u.name,d.name,{breaking:!0,label:`Name`}),n(f,`version`,u.version,d.version,{breaking:!0,label:`Version`}),n(f,`kind`,u.kind,d.kind,{breaking:!0,label:`Kind`}),n(f,`stability`,u.stability,d.stability,{breaking:i(u,d),label:`Stability`}),r(f,`owners`,u.owners??[],d.owners??[],{label:`Owners`}),r(f,`tags`,u.tags??[],d.tags??[],{label:`Tags`}),a(f,u,d),l.breakingOnly?f.filter(e=>e.type===`breaking`):f}function n(e,t,n,r,i){n!==r&&e.push({type:i.breaking?`breaking`:`changed`,path:t,oldValue:n,newValue:r,description:`${i.label} changed`})}function r(e,t,n,r,i){let a=[...n].sort(),o=[...r].sort();JSON.stringify(a)!==JSON.stringify(o)&&e.push({type:`changed`,path:t,oldValue:a,newValue:o,description:`${i.label} changed`})}function i(e,t){let n={experimental:0,beta:1,stable:2,deprecated:3},r=e.stability?n[e.stability]??0:0;return(t.stability?n[t.stability]??0:0)>r}function a(e,t,r){n(e,`hasMeta`,t.hasMeta,r.hasMeta,{breaking:t.specType===`operation`||r.specType===`operation`,label:`meta section presence`}),n(e,`hasIo`,t.hasIo,r.hasIo,{breaking:t.specType===`operation`||r.specType===`operation`,label:`io section presence`}),n(e,`hasPolicy`,t.hasPolicy,r.hasPolicy,{breaking:t.specType===`operation`||r.specType===`operation`,label:`policy section presence`}),n(e,`hasPayload`,t.hasPayload,r.hasPayload,{breaking:t.specType===`event`||r.specType===`event`,label:`payload section presence`}),n(e,`hasContent`,t.hasContent,r.hasContent,{breaking:t.specType===`presentation`||r.specType===`presentation`,label:`content section presence`}),n(e,`hasDefinition`,t.hasDefinition,r.hasDefinition,{breaking:t.specType===`workflow`||r.specType===`workflow`,label:`definition section presence`})}export{t};
+import { scanSpecSource } from "../spec-scan.js";
+
+//#region ../../modules/contractspec-workspace/dist/analysis/diff/semantic.js
+/**
+* Compute semantic differences between two spec sources.
+*/
+function computeSemanticDiff(aCode, aPath, bCode, bPath, options = {}) {
+	const a = scanSpecSource(aCode, aPath);
+	const b = scanSpecSource(bCode, bPath);
+	const diffs = [];
+	compareScalar(diffs, "specType", a.specType, b.specType, {
+		breaking: true,
+		label: "Spec type"
+	});
+	compareScalar(diffs, "name", a.name, b.name, {
+		breaking: true,
+		label: "Name"
+	});
+	compareScalar(diffs, "version", a.version, b.version, {
+		breaking: true,
+		label: "Version"
+	});
+	compareScalar(diffs, "kind", a.kind, b.kind, {
+		breaking: true,
+		label: "Kind"
+	});
+	compareScalar(diffs, "stability", a.stability, b.stability, {
+		breaking: isStabilityDowngrade(a, b),
+		label: "Stability"
+	});
+	compareArray(diffs, "owners", a.owners ?? [], b.owners ?? [], { label: "Owners" });
+	compareArray(diffs, "tags", a.tags ?? [], b.tags ?? [], { label: "Tags" });
+	compareStructuralHints(diffs, a, b);
+	return options.breakingOnly ? diffs.filter((d) => d.type === "breaking") : diffs;
+}
+function compareScalar(diffs, path, a, b, config) {
+	if (a === b) return;
+	diffs.push({
+		type: config.breaking ? "breaking" : "changed",
+		path,
+		oldValue: a,
+		newValue: b,
+		description: `${config.label} changed`
+	});
+}
+function compareArray(diffs, path, a, b, config) {
+	const aSorted = [...a].sort();
+	const bSorted = [...b].sort();
+	if (JSON.stringify(aSorted) === JSON.stringify(bSorted)) return;
+	diffs.push({
+		type: "changed",
+		path,
+		oldValue: aSorted,
+		newValue: bSorted,
+		description: `${config.label} changed`
+	});
+}
+function isStabilityDowngrade(a, b) {
+	const order = {
+		experimental: 0,
+		beta: 1,
+		stable: 2,
+		deprecated: 3
+	};
+	const aValue = a.stability ? order[a.stability] ?? 0 : 0;
+	return (b.stability ? order[b.stability] ?? 0 : 0) > aValue;
+}
+function compareStructuralHints(diffs, a, b) {
+	compareScalar(diffs, "hasMeta", a.hasMeta, b.hasMeta, {
+		breaking: a.specType === "operation" || b.specType === "operation",
+		label: "meta section presence"
+	});
+	compareScalar(diffs, "hasIo", a.hasIo, b.hasIo, {
+		breaking: a.specType === "operation" || b.specType === "operation",
+		label: "io section presence"
+	});
+	compareScalar(diffs, "hasPolicy", a.hasPolicy, b.hasPolicy, {
+		breaking: a.specType === "operation" || b.specType === "operation",
+		label: "policy section presence"
+	});
+	compareScalar(diffs, "hasPayload", a.hasPayload, b.hasPayload, {
+		breaking: a.specType === "event" || b.specType === "event",
+		label: "payload section presence"
+	});
+	compareScalar(diffs, "hasContent", a.hasContent, b.hasContent, {
+		breaking: a.specType === "presentation" || b.specType === "presentation",
+		label: "content section presence"
+	});
+	compareScalar(diffs, "hasDefinition", a.hasDefinition, b.hasDefinition, {
+		breaking: a.specType === "workflow" || b.specType === "workflow",
+		label: "definition section presence"
+	});
+}
+
+//#endregion
+export { computeSemanticDiff };

package/dist/modules/contractspec-workspace/dist/analysis/feature-scan.js

@@ -1 +1,151 @@
-function e(e){return e.includes(`.feature.`)}function t(e,t){let l=o(e,`key`)??a(t),u=o(e,`title`)??void 0,d=o(e,`description`)??void 0,f=o(e,`domain`)??void 0,p=o(e,`stability`);return{filePath:t,key:l,title:u,description:d,domain:f,stability:c(p)?p:void 0,owners:s(e,`owners`),tags:s(e,`tags`),operations:n(e,`operations`),events:n(e,`events`),presentations:n(e,`presentations`),experiments:n(e,`experiments`),capabilities:r(e),opToPresentationLinks:i(e)}}function n(e,t){let n=[],r=RegExp(`${l(t)}\\s*:\\s*\\[([\\s\\S]*?)\\]`,`m`),i=e.match(r);if(!i?.[1])return n;let a=/\{\s*name:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)/g,o;for(;(o=a.exec(i[1]))!==null;)o[1]&&o[2]&&n.push({name:o[1],version:Number(o[2])});return n}function r(e){let t=[],n=[],r=e.match(/capabilities\s*:\s*\{([\s\S]*?)\}/);if(!r?.[1])return{provides:t,requires:n};let i=r[1],a=i.match(/provides\s*:\s*\[([\s\S]*?)\]/);if(a?.[1]){let e=/\{\s*key:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)/g,n;for(;(n=e.exec(a[1]))!==null;)n[1]&&n[2]&&t.push({name:n[1],version:Number(n[2])})}let o=i.match(/requires\s*:\s*\[([\s\S]*?)\]/);if(o?.[1]){let e=/\{\s*key:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)/g,t=/\{\s*key:\s*['"]([^'"]+)['"]\s*\}/g,r=null;for(;(r=e.exec(o[1]))!==null;)r[1]&&r[2]&&n.push({name:r[1],version:Number(r[2])});for(;(r=t.exec(o[1]))!==null;)r&&r[1]&&(n.some(e=>e.name===r[1])||n.push({name:r[1],version:1}))}return{provides:t,requires:n}}function i(e){let t=[],n=e.match(/opToPresentation\s*:\s*\[([\s\S]*?)\]/);if(!n?.[1])return t;let r=/\{\s*op:\s*\{\s*name:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)\s*\}\s*,\s*pres:\s*\{\s*name:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)\s*\}/g,i;for(;(i=r.exec(n[1]))!==null;)i[1]&&i[2]&&i[3]&&i[4]&&t.push({op:{name:i[1],version:Number(i[2])},pres:{name:i[3],version:Number(i[4])}});return t}function a(e){return(e.split(`/`).pop()??e).replace(/\.feature\.[jt]s$/,``).replace(/[^a-zA-Z0-9-]/g,`-`)}function o(e,t){let n=RegExp(`${l(t)}\\s*:\\s*['"]([^'"]+)['"]`);return e.match(n)?.[1]??null}function s(e,t){let n=RegExp(`${l(t)}\\s*:\\s*\\[([\\s\\S]*?)\\]`),r=e.match(n);if(!r?.[1])return;let i=r[1],a=Array.from(i.matchAll(/['"]([^'"]+)['"]/g)).map(e=>e[1]).filter(e=>typeof e==`string`&&e.length>0);return a.length>0?a:void 0}function c(e){return e===`experimental`||e===`beta`||e===`stable`||e===`deprecated`}function l(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}export{e,t};
+//#region ../../modules/contractspec-workspace/dist/analysis/feature-scan.js
+/**
+* Check if a file is a feature file based on naming conventions.
+*/
+function isFeatureFile(filePath) {
+	return filePath.includes(".feature.");
+}
+/**
+* Scan a feature source file to extract metadata.
+*/
+function scanFeatureSource(code, filePath) {
+	const key = matchStringField(code, "key") ?? extractKeyFromFilePath(filePath);
+	const title = matchStringField(code, "title") ?? void 0;
+	const description = matchStringField(code, "description") ?? void 0;
+	const domain = matchStringField(code, "domain") ?? void 0;
+	const stabilityRaw = matchStringField(code, "stability");
+	return {
+		filePath,
+		key,
+		title,
+		description,
+		domain,
+		stability: isStability(stabilityRaw) ? stabilityRaw : void 0,
+		owners: matchStringArrayField(code, "owners"),
+		tags: matchStringArrayField(code, "tags"),
+		operations: extractRefsFromArray(code, "operations"),
+		events: extractRefsFromArray(code, "events"),
+		presentations: extractRefsFromArray(code, "presentations"),
+		experiments: extractRefsFromArray(code, "experiments"),
+		capabilities: extractCapabilities(code),
+		opToPresentationLinks: extractOpToPresentationLinks(code)
+	};
+}
+/**
+* Extract refs from a named array (e.g., operations, events, presentations).
+*/
+function extractRefsFromArray(code, fieldName) {
+	const refs = [];
+	const arrayPattern = new RegExp(`${escapeRegex(fieldName)}\\s*:\\s*\\[([\\s\\S]*?)\\]`, "m");
+	const arrayMatch = code.match(arrayPattern);
+	if (!arrayMatch?.[1]) return refs;
+	const refPattern = /\{\s*name:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)/g;
+	let match;
+	while ((match = refPattern.exec(arrayMatch[1])) !== null) if (match[1] && match[2]) refs.push({
+		name: match[1],
+		version: Number(match[2])
+	});
+	return refs;
+}
+/**
+* Extract capability bindings (provides and requires).
+*/
+function extractCapabilities(code) {
+	const provides = [];
+	const requires = [];
+	const capabilitiesMatch = code.match(/capabilities\s*:\s*\{([\s\S]*?)\}/);
+	if (!capabilitiesMatch?.[1]) return {
+		provides,
+		requires
+	};
+	const capabilitiesContent = capabilitiesMatch[1];
+	const providesMatch = capabilitiesContent.match(/provides\s*:\s*\[([\s\S]*?)\]/);
+	if (providesMatch?.[1]) {
+		const refPattern = /\{\s*key:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)/g;
+		let match;
+		while ((match = refPattern.exec(providesMatch[1])) !== null) if (match[1] && match[2]) provides.push({
+			name: match[1],
+			version: Number(match[2])
+		});
+	}
+	const requiresMatch = capabilitiesContent.match(/requires\s*:\s*\[([\s\S]*?)\]/);
+	if (requiresMatch?.[1]) {
+		const refPatternWithVersion = /\{\s*key:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)/g;
+		const refPatternKeyOnly = /\{\s*key:\s*['"]([^'"]+)['"]\s*\}/g;
+		let match = null;
+		while ((match = refPatternWithVersion.exec(requiresMatch[1])) !== null) if (match[1] && match[2]) requires.push({
+			name: match[1],
+			version: Number(match[2])
+		});
+		while ((match = refPatternKeyOnly.exec(requiresMatch[1])) !== null) if (match && match[1]) {
+			if (!requires.some((r) => r.name === match[1])) requires.push({
+				name: match[1],
+				version: 1
+			});
+		}
+	}
+	return {
+		provides,
+		requires
+	};
+}
+/**
+* Extract opToPresentation links.
+*/
+function extractOpToPresentationLinks(code) {
+	const links = [];
+	const arrayMatch = code.match(/opToPresentation\s*:\s*\[([\s\S]*?)\]/);
+	if (!arrayMatch?.[1]) return links;
+	const linkPattern = /\{\s*op:\s*\{\s*name:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)\s*\}\s*,\s*pres:\s*\{\s*name:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)\s*\}/g;
+	let match;
+	while ((match = linkPattern.exec(arrayMatch[1])) !== null) if (match[1] && match[2] && match[3] && match[4]) links.push({
+		op: {
+			name: match[1],
+			version: Number(match[2])
+		},
+		pres: {
+			name: match[3],
+			version: Number(match[4])
+		}
+	});
+	return links;
+}
+/**
+* Extract key from file path as fallback.
+*/
+function extractKeyFromFilePath(filePath) {
+	return (filePath.split("/").pop() ?? filePath).replace(/\.feature\.[jt]s$/, "").replace(/[^a-zA-Z0-9-]/g, "-");
+}
+/**
+* Match a string field in source code.
+*/
+function matchStringField(code, field) {
+	const regex = /* @__PURE__ */ new RegExp(`${escapeRegex(field)}\\s*:\\s*['"]([^'"]+)['"]`);
+	return code.match(regex)?.[1] ?? null;
+}
+/**
+* Match a string array field in source code.
+*/
+function matchStringArrayField(code, field) {
+	const regex = /* @__PURE__ */ new RegExp(`${escapeRegex(field)}\\s*:\\s*\\[([\\s\\S]*?)\\]`);
+	const match = code.match(regex);
+	if (!match?.[1]) return void 0;
+	const inner = match[1];
+	const items = Array.from(inner.matchAll(/['"]([^'"]+)['"]/g)).map((m) => m[1]).filter((value) => typeof value === "string" && value.length > 0);
+	return items.length > 0 ? items : void 0;
+}
+/**
+* Check if a value is a valid stability.
+*/
+function isStability(value) {
+	return value === "experimental" || value === "beta" || value === "stable" || value === "deprecated";
+}
+/**
+* Escape regex special characters.
+*/
+function escapeRegex(value) {
+	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+//#endregion
+export { isFeatureFile, scanFeatureSource };