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

package/dist/analysis/spec-scan.js

@@ -1,344 +1 @@
-//#region src/analysis/spec-scan.ts
-/**
-* Infer spec type from file path based on naming conventions.
-* Supports all contract types from @lssm/lib.contracts.
-*/
-function inferSpecTypeFromFilePath(filePath) {
-	if (filePath.includes(".contracts.") || filePath.includes("/contracts/")) return "operation";
-	if (filePath.includes(".event.") || filePath.includes("/events/") || filePath.endsWith("/events.ts")) return "event";
-	if (filePath.includes(".presentation.") || filePath.includes("/presentations/") || filePath.endsWith("/presentations.ts")) return "presentation";
-	if (filePath.includes(".feature.")) return "feature";
-	if (filePath.includes(".capability.")) return "capability";
-	if (filePath.includes(".data-view.")) return "data-view";
-	if (filePath.includes(".form.")) return "form";
-	if (filePath.includes(".migration.")) return "migration";
-	if (filePath.includes(".workflow.")) return "workflow";
-	if (filePath.includes(".experiment.")) return "experiment";
-	if (filePath.includes(".integration.")) return "integration";
-	if (filePath.includes(".knowledge.")) return "knowledge";
-	if (filePath.includes(".telemetry.")) return "telemetry";
-	if (filePath.includes(".app-config.")) return "app-config";
-	if (filePath.includes(".policy.")) return "policy";
-	if (filePath.includes(".test-spec.")) return "test-spec";
-	return "unknown";
-}
-/**
-* Scan spec source code to extract metadata without executing it.
-*/
-function scanSpecSource(code, filePath) {
-	const specType = inferSpecTypeFromFilePath(filePath);
-	const name = matchStringField(code, "name");
-	const description = matchStringField(code, "description");
-	const stabilityRaw = matchStringField(code, "stability");
-	const stability = isStability(stabilityRaw) ? stabilityRaw : void 0;
-	const owners = matchStringArrayField(code, "owners");
-	const tags = matchStringArrayField(code, "tags");
-	const version = matchNumberField(code, "version");
-	const kind = inferOperationKind(code);
-	const hasMeta = /meta\s*:\s*{/.test(code);
-	const hasIo = /\bio\s*:\s*{/.test(code);
-	const hasPolicy = /\bpolicy\s*:\s*{/.test(code);
-	const hasPayload = /\bpayload\s*:\s*{/.test(code);
-	const hasContent = /\bcontent\s*:\s*{/.test(code);
-	const hasDefinition = /\bdefinition\s*:\s*{/.test(code);
-	const emittedEvents = specType === "operation" ? extractEmittedEvents(code) : void 0;
-	const policyRefs = specType === "operation" ? extractPolicyRefs(code) : void 0;
-	const testRefs = extractTestRefs(code);
-	return {
-		filePath,
-		specType,
-		name: name ?? void 0,
-		description: description ?? void 0,
-		stability,
-		owners,
-		tags,
-		version: version ?? void 0,
-		kind,
-		hasMeta,
-		hasIo,
-		hasPolicy,
-		hasPayload,
-		hasContent,
-		hasDefinition,
-		emittedEvents,
-		policyRefs,
-		testRefs
-	};
-}
-/**
-* Extract emitted event refs from operation spec source.
-* Looks for sideEffects.emits array entries.
-*/
-function extractEmittedEvents(code) {
-	const events = [];
-	const inlinePattern = /\{\s*name:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)/g;
-	let match;
-	while ((match = inlinePattern.exec(code)) !== null) if (match[1] && match[2]) events.push({
-		name: match[1],
-		version: Number(match[2])
-	});
-	const refPattern = /\{\s*ref:\s*(\w+)/g;
-	while ((match = refPattern.exec(code)) !== null) if (match[1] && !match[1].startsWith("when")) {}
-	return events.length > 0 ? events : void 0;
-}
-/**
-* Extract policy refs from operation spec source.
-*/
-function extractPolicyRefs(code) {
-	const policies = [];
-	const policyPattern = /\{\s*name:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)/g;
-	const policySectionMatch = code.match(/policies\s*:\s*\[([\s\S]*?)\]/);
-	if (policySectionMatch?.[1]) {
-		let match;
-		while ((match = policyPattern.exec(policySectionMatch[1])) !== null) if (match[1] && match[2]) policies.push({
-			name: match[1],
-			version: Number(match[2])
-		});
-	}
-	return policies.length > 0 ? policies : void 0;
-}
-/**
-* Extract test spec refs.
-*/
-function extractTestRefs(code) {
-	const tests = [];
-	const testsSectionMatch = code.match(/tests\s*:\s*\[([\s\S]*?)\]/);
-	if (testsSectionMatch?.[1]) {
-		const refPattern = /\{\s*name:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)/g;
-		let match;
-		while ((match = refPattern.exec(testsSectionMatch[1])) !== null) if (match[1] && match[2]) tests.push({
-			name: match[1],
-			version: Number(match[2])
-		});
-	}
-	return tests.length > 0 ? tests : void 0;
-}
-function matchStringField(code, field) {
-	const regex = /* @__PURE__ */ new RegExp(`${escapeRegex(field)}\\s*:\\s*['"]([^'"]+)['"]`);
-	return code.match(regex)?.[1] ?? null;
-}
-function matchNumberField(code, field) {
-	const regex = /* @__PURE__ */ new RegExp(`${escapeRegex(field)}\\s*:\\s*(\\d+)`);
-	const match = code.match(regex);
-	if (!match?.[1]) return null;
-	const parsed = Number(match[1]);
-	return Number.isFinite(parsed) ? parsed : null;
-}
-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;
-}
-function isStability(value) {
-	return value === "experimental" || value === "beta" || value === "stable" || value === "deprecated";
-}
-function escapeRegex(value) {
-	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-/**
-* Infer operation kind from source code.
-* First checks for defineCommand/defineQuery usage (which set kind automatically),
-* then falls back to explicit kind field.
-*/
-function inferOperationKind(code) {
-	if (/defineCommand\s*\(/.test(code)) return "command";
-	if (/defineQuery\s*\(/.test(code)) return "query";
-	const kindRaw = matchStringField(code, "kind");
-	return kindRaw === "command" || kindRaw === "query" ? kindRaw : "unknown";
-}
-/**
-* Infer operation kind from a specific code block.
-*/
-function inferOperationKindFromBlock(block) {
-	if (/defineCommand\s*\(/.test(block)) return "command";
-	if (/defineQuery\s*\(/.test(block)) return "query";
-	const kindRaw = matchStringField(block, "kind");
-	return kindRaw === "command" || kindRaw === "query" ? kindRaw : "unknown";
-}
-/**
-* Extract name and version from a meta block.
-*/
-function extractMetaFromBlock(block) {
-	const name = matchStringField(block, "name");
-	const version = matchNumberField(block, "version");
-	if (name && version !== null) return {
-		name,
-		version
-	};
-	return null;
-}
-/**
-* Define function patterns for all spec types.
-*/
-const DEFINE_FUNCTION_PATTERNS = [
-	{
-		pattern: /defineCommand\s*\(\s*\{/g,
-		type: "operation"
-	},
-	{
-		pattern: /defineQuery\s*\(\s*\{/g,
-		type: "operation"
-	},
-	{
-		pattern: /defineEvent\s*\(\s*\{/g,
-		type: "event"
-	},
-	{
-		pattern: /:\s*PresentationDescriptorV2\s*=\s*\{/g,
-		type: "presentation"
-	},
-	{
-		pattern: /:\s*PresentationDescriptor\s*=\s*\{/g,
-		type: "presentation"
-	},
-	{
-		pattern: /definePresentation\s*\(\s*\{/g,
-		type: "presentation"
-	},
-	{
-		pattern: /defineCapability\s*\(\s*\{/g,
-		type: "capability"
-	},
-	{
-		pattern: /defineWorkflow\s*\(\s*\{/g,
-		type: "workflow"
-	},
-	{
-		pattern: /defineExperiment\s*\(\s*\{/g,
-		type: "experiment"
-	},
-	{
-		pattern: /defineIntegration\s*\(\s*\{/g,
-		type: "integration"
-	},
-	{
-		pattern: /defineKnowledge\s*\(\s*\{/g,
-		type: "knowledge"
-	},
-	{
-		pattern: /defineTelemetry\s*\(\s*\{/g,
-		type: "telemetry"
-	},
-	{
-		pattern: /defineAppConfig\s*\(\s*\{/g,
-		type: "app-config"
-	},
-	{
-		pattern: /definePolicy\s*\(\s*\{/g,
-		type: "policy"
-	},
-	{
-		pattern: /defineTestSpec\s*\(\s*\{/g,
-		type: "test-spec"
-	},
-	{
-		pattern: /defineDataView\s*\(\s*\{/g,
-		type: "data-view"
-	},
-	{
-		pattern: /defineForm\s*\(\s*\{/g,
-		type: "form"
-	},
-	{
-		pattern: /defineMigration\s*\(\s*\{/g,
-		type: "migration"
-	}
-];
-/**
-* Find matching closing brace for an opening brace.
-* Returns the index of the closing brace or -1 if not found.
-*/
-function findMatchingBrace(code, startIndex) {
-	let depth = 0;
-	let inString = false;
-	let stringChar = "";
-	for (let i = startIndex; i < code.length; i++) {
-		const char = code[i];
-		const prevChar = i > 0 ? code[i - 1] : "";
-		if ((char === "\"" || char === "'" || char === "`") && prevChar !== "\\") {
-			if (!inString) {
-				inString = true;
-				stringChar = char;
-			} else if (char === stringChar) inString = false;
-			continue;
-		}
-		if (inString) continue;
-		if (char === "{") depth++;
-		else if (char === "}") {
-			depth--;
-			if (depth === 0) return i;
-		}
-	}
-	return -1;
-}
-/**
-* Scan spec source code to extract ALL specs from a file.
-* This function finds multiple spec definitions in a single file.
-*/
-function scanAllSpecsFromSource(code, filePath) {
-	const results = [];
-	const baseSpecType = inferSpecTypeFromFilePath(filePath);
-	const processedPositions = /* @__PURE__ */ new Set();
-	for (const { pattern, type } of DEFINE_FUNCTION_PATTERNS) {
-		pattern.lastIndex = 0;
-		let match;
-		while ((match = pattern.exec(code)) !== null) {
-			const startPos = match.index;
-			if (processedPositions.has(startPos)) continue;
-			processedPositions.add(startPos);
-			const openBracePos = code.indexOf("{", startPos);
-			if (openBracePos === -1) continue;
-			const closeBracePos = findMatchingBrace(code, openBracePos);
-			if (closeBracePos === -1) continue;
-			const block = code.slice(openBracePos, closeBracePos + 1);
-			const meta = extractMetaFromBlock(block);
-			if (!meta) continue;
-			const description = matchStringField(block, "description");
-			const stabilityRaw = matchStringField(block, "stability");
-			const stability = isStability(stabilityRaw) ? stabilityRaw : void 0;
-			const owners = matchStringArrayField(block, "owners");
-			const tags = matchStringArrayField(block, "tags");
-			const hasMeta = /meta\s*:\s*{/.test(block);
-			const hasIo = /\bio\s*:\s*{/.test(block);
-			const hasPolicy = /\bpolicy\s*:\s*{/.test(block);
-			const hasPayload = /\bpayload\s*:\s*{/.test(block);
-			const hasContent = /\bcontent\s*:\s*{/.test(block);
-			const hasDefinition = /\bdefinition\s*:\s*{/.test(block);
-			const kind = type === "operation" ? inferOperationKindFromBlock(block) : "unknown";
-			const emittedEvents = type === "operation" ? extractEmittedEvents(block) : void 0;
-			const policyRefs = type === "operation" ? extractPolicyRefs(block) : void 0;
-			const testRefs = extractTestRefs(block);
-			results.push({
-				filePath,
-				specType: type,
-				name: meta.name,
-				version: meta.version,
-				description: description ?? void 0,
-				stability,
-				owners,
-				tags,
-				kind,
-				hasMeta,
-				hasIo,
-				hasPolicy,
-				hasPayload,
-				hasContent,
-				hasDefinition,
-				emittedEvents,
-				policyRefs,
-				testRefs
-			});
-		}
-	}
-	if (results.length === 0 && baseSpecType !== "unknown") {
-		const fallback = scanSpecSource(code, filePath);
-		if (fallback.name && fallback.version !== void 0) results.push(fallback);
-	}
-	return results;
-}
-
-//#endregion
-export { extractEmittedEvents, extractPolicyRefs, extractTestRefs, inferSpecTypeFromFilePath, scanAllSpecsFromSource, scanSpecSource };
+function e(e){return e.includes(`.contracts.`)||e.includes(`/contracts/`)?`operation`:e.includes(`.event.`)||e.includes(`/events/`)||e.endsWith(`/events.ts`)?`event`:e.includes(`.presentation.`)||e.includes(`/presentations/`)||e.endsWith(`/presentations.ts`)?`presentation`:e.includes(`.feature.`)?`feature`:e.includes(`.capability.`)?`capability`:e.includes(`.data-view.`)?`data-view`:e.includes(`.form.`)?`form`:e.includes(`.migration.`)?`migration`:e.includes(`.workflow.`)?`workflow`:e.includes(`.experiment.`)?`experiment`:e.includes(`.integration.`)?`integration`:e.includes(`.knowledge.`)?`knowledge`:e.includes(`.telemetry.`)?`telemetry`:e.includes(`.app-config.`)?`app-config`:e.includes(`.policy.`)?`policy`:e.includes(`.test-spec.`)?`test-spec`:`unknown`}function t(t,l){let d=e(l),f=a(t,`name`),p=a(t,`description`),m=a(t,`stability`),h=c(m)?m:void 0,g=s(t,`owners`),_=s(t,`tags`),v=o(t,`version`),y=u(t),b=/meta\s*:\s*{/.test(t),x=/\bio\s*:\s*{/.test(t),S=/\bpolicy\s*:\s*{/.test(t),C=/\bpayload\s*:\s*{/.test(t),w=/\bcontent\s*:\s*{/.test(t),T=/\bdefinition\s*:\s*{/.test(t),E=d===`operation`?n(t):void 0,D=d===`operation`?r(t):void 0,O=i(t);return{filePath:l,specType:d,name:f??void 0,description:p??void 0,stability:h,owners:g,tags:_,version:v??void 0,kind:y,hasMeta:b,hasIo:x,hasPolicy:S,hasPayload:C,hasContent:w,hasDefinition:T,emittedEvents:E,policyRefs:D,testRefs:O}}function n(e){let t=[],n=/\{\s*name:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)/g,r;for(;(r=n.exec(e))!==null;)r[1]&&r[2]&&t.push({name:r[1],version:Number(r[2])});let i=/\{\s*ref:\s*(\w+)/g;for(;(r=i.exec(e))!==null;)r[1]&&r[1].startsWith(`when`);return t.length>0?t:void 0}function r(e){let t=[],n=/\{\s*name:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)/g,r=e.match(/policies\s*:\s*\[([\s\S]*?)\]/);if(r?.[1]){let e;for(;(e=n.exec(r[1]))!==null;)e[1]&&e[2]&&t.push({name:e[1],version:Number(e[2])})}return t.length>0?t:void 0}function i(e){let t=[],n=e.match(/tests\s*:\s*\[([\s\S]*?)\]/);if(n?.[1]){let e=/\{\s*name:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)/g,r;for(;(r=e.exec(n[1]))!==null;)r[1]&&r[2]&&t.push({name:r[1],version:Number(r[2])})}return t.length>0?t:void 0}function a(e,t){let n=RegExp(`${l(t)}\\s*:\\s*['"]([^'"]+)['"]`);return e.match(n)?.[1]??null}function o(e,t){let n=RegExp(`${l(t)}\\s*:\\s*(\\d+)`),r=e.match(n);if(!r?.[1])return null;let i=Number(r[1]);return Number.isFinite(i)?i: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,`\\$&`)}function u(e){if(/defineCommand\s*\(/.test(e))return`command`;if(/defineQuery\s*\(/.test(e))return`query`;let t=a(e,`kind`);return t===`command`||t===`query`?t:`unknown`}function d(e){if(/defineCommand\s*\(/.test(e))return`command`;if(/defineQuery\s*\(/.test(e))return`query`;let t=a(e,`kind`);return t===`command`||t===`query`?t:`unknown`}function f(e){let t=a(e,`name`),n=o(e,`version`);return t&&n!==null?{name:t,version:n}:null}const p=[{pattern:/defineCommand\s*\(\s*\{/g,type:`operation`},{pattern:/defineQuery\s*\(\s*\{/g,type:`operation`},{pattern:/defineEvent\s*\(\s*\{/g,type:`event`},{pattern:/:\s*PresentationDescriptorV2\s*=\s*\{/g,type:`presentation`},{pattern:/:\s*PresentationDescriptor\s*=\s*\{/g,type:`presentation`},{pattern:/definePresentation\s*\(\s*\{/g,type:`presentation`},{pattern:/defineCapability\s*\(\s*\{/g,type:`capability`},{pattern:/defineWorkflow\s*\(\s*\{/g,type:`workflow`},{pattern:/defineExperiment\s*\(\s*\{/g,type:`experiment`},{pattern:/defineIntegration\s*\(\s*\{/g,type:`integration`},{pattern:/defineKnowledge\s*\(\s*\{/g,type:`knowledge`},{pattern:/defineTelemetry\s*\(\s*\{/g,type:`telemetry`},{pattern:/defineAppConfig\s*\(\s*\{/g,type:`app-config`},{pattern:/definePolicy\s*\(\s*\{/g,type:`policy`},{pattern:/defineTestSpec\s*\(\s*\{/g,type:`test-spec`},{pattern:/defineDataView\s*\(\s*\{/g,type:`data-view`},{pattern:/defineForm\s*\(\s*\{/g,type:`form`},{pattern:/defineMigration\s*\(\s*\{/g,type:`migration`}];function m(e,t){let n=0,r=!1,i=``;for(let a=t;a<e.length;a++){let t=e[a],o=a>0?e[a-1]:``;if((t===`"`||t===`'`||t==="`")&&o!==`\\`){r?t===i&&(r=!1):(r=!0,i=t);continue}if(!r){if(t===`{`)n++;else if(t===`}`&&(n--,n===0))return a}}return-1}function h(o,l){let u=[],h=e(l),g=new Set;for(let{pattern:e,type:t}of p){e.lastIndex=0;let p;for(;(p=e.exec(o))!==null;){let e=p.index;if(g.has(e))continue;g.add(e);let h=o.indexOf(`{`,e);if(h===-1)continue;let _=m(o,h);if(_===-1)continue;let v=o.slice(h,_+1),y=f(v);if(!y)continue;let b=a(v,`description`),x=a(v,`stability`),S=c(x)?x:void 0,C=s(v,`owners`),w=s(v,`tags`),T=/meta\s*:\s*{/.test(v),E=/\bio\s*:\s*{/.test(v),D=/\bpolicy\s*:\s*{/.test(v),O=/\bpayload\s*:\s*{/.test(v),k=/\bcontent\s*:\s*{/.test(v),A=/\bdefinition\s*:\s*{/.test(v),j=t===`operation`?d(v):`unknown`,M=t===`operation`?n(v):void 0,N=t===`operation`?r(v):void 0,P=i(v);u.push({filePath:l,specType:t,name:y.name,version:y.version,description:b??void 0,stability:S,owners:C,tags:w,kind:j,hasMeta:T,hasIo:E,hasPolicy:D,hasPayload:O,hasContent:k,hasDefinition:A,emittedEvents:M,policyRefs:N,testRefs:P})}}if(u.length===0&&h!==`unknown`){let e=t(o,l);e.name&&e.version!==void 0&&u.push(e)}return u}export{n as extractEmittedEvents,r as extractPolicyRefs,i as extractTestRefs,e as inferSpecTypeFromFilePath,h as scanAllSpecsFromSource,t as scanSpecSource};

package/dist/analysis/validate/spec-structure.js

@@ -1,122 +1 @@
-//#region src/analysis/validate/spec-structure.ts
-/**
-* Validate spec structure based on source code and filename.
-*/
-function validateSpecStructure(code, fileName) {
-	const errors = [];
-	const warnings = [];
-	if (!/export\s+(const|let)\s+\w+/.test(code)) errors.push("No exported spec found");
-	if (fileName.includes(".contracts.")) validateOperationSpec(code, errors, warnings);
-	if (fileName.includes(".event.")) validateEventSpec(code, errors, warnings);
-	if (fileName.includes(".presentation.")) validatePresentationSpec(code, errors, warnings);
-	if (fileName.includes(".workflow.")) validateWorkflowSpec(code, errors, warnings);
-	if (fileName.includes(".data-view.")) validateDataViewSpec(code, errors, warnings);
-	if (fileName.includes(".migration.")) validateMigrationSpec(code, errors, warnings);
-	if (fileName.includes(".telemetry.")) validateTelemetrySpec(code, errors, warnings);
-	if (fileName.includes(".experiment.")) validateExperimentSpec(code, errors, warnings);
-	if (fileName.includes(".app-config.")) validateAppConfigSpec(code, errors, warnings);
-	validateCommonFields(code, errors, warnings);
-	return {
-		valid: errors.length === 0,
-		errors,
-		warnings
-	};
-}
-/**
-* Validate operation spec
-*/
-function validateOperationSpec(code, errors, warnings) {
-	if (!/define(Command|Query)/.test(code)) errors.push("Missing defineCommand or defineQuery call");
-	if (!code.includes("meta:")) errors.push("Missing meta section");
-	if (!code.includes("io:")) errors.push("Missing io section");
-	if (!code.includes("policy:")) errors.push("Missing policy section");
-	if (!code.match(/name:\s*['"][^'"]+['"]/)) errors.push("Missing or invalid name field");
-	if (!code.match(/version:\s*\d+/)) errors.push("Missing or invalid version field");
-	const hasDefineCommand = /defineCommand\s*\(/.test(code);
-	const hasDefineQuery = /defineQuery\s*\(/.test(code);
-	const hasExplicitKind = /kind:\s*['"](?:command|query)['"]/.test(code);
-	if (!hasDefineCommand && !hasDefineQuery && !hasExplicitKind) errors.push("Missing kind: use defineCommand(), defineQuery(), or explicit kind field");
-	if (!code.includes("acceptance:")) warnings.push("No acceptance scenarios defined");
-	if (!code.includes("examples:")) warnings.push("No examples provided");
-	if (code.includes("TODO")) warnings.push("Contains TODO items that need completion");
-}
-function validateTelemetrySpec(code, errors, warnings) {
-	if (!code.match(/:\s*TelemetrySpec\s*=/)) errors.push("Missing TelemetrySpec type annotation");
-	if (!code.match(/meta:\s*{[\s\S]*name:/)) errors.push("TelemetrySpec.meta is required");
-	if (!code.includes("events:")) errors.push("TelemetrySpec must declare events");
-	if (!code.match(/privacy:\s*'(public|internal|pii|sensitive)'/)) warnings.push("No explicit privacy classification found");
-}
-function validateExperimentSpec(code, errors, warnings) {
-	if (!code.match(/:\s*ExperimentSpec\s*=/)) errors.push("Missing ExperimentSpec type annotation");
-	if (!code.includes("controlVariant")) errors.push("ExperimentSpec must declare controlVariant");
-	if (!code.includes("variants:")) errors.push("ExperimentSpec must declare variants");
-	if (!code.match(/allocation:\s*{/)) warnings.push("ExperimentSpec missing allocation configuration");
-}
-function validateAppConfigSpec(code, errors, warnings) {
-	if (!code.match(/:\s*AppBlueprintSpec\s*=/)) errors.push("Missing AppBlueprintSpec type annotation");
-	if (!code.includes("meta:")) errors.push("AppBlueprintSpec must define meta");
-	if (!code.includes("appId")) warnings.push("AppBlueprint meta missing appId assignment");
-	if (!code.includes("capabilities")) warnings.push("App blueprint spec does not declare capabilities");
-}
-/**
-* Validate event spec
-*/
-function validateEventSpec(code, errors, warnings) {
-	if (!code.includes("defineEvent")) errors.push("Missing defineEvent call");
-	if (!code.match(/name:\s*['"][^'"]+['"]/)) errors.push("Missing or invalid name field");
-	if (!code.match(/version:\s*\d+/)) errors.push("Missing or invalid version field");
-	if (!code.includes("payload:")) errors.push("Missing payload field");
-	const nameMatch = code.match(/name:\s*['"]([^'"]+)['"]/);
-	if (nameMatch?.[1]) {
-		if (!(nameMatch[1].split(".").pop() ?? "").match(/(ed|created|updated|deleted|completed)$/i)) warnings.push("Event name should use past tense (e.g., \"created\", \"updated\")");
-	}
-}
-/**
-* Validate presentation spec
-*/
-function validatePresentationSpec(code, errors, _warnings) {
-	if (!code.match(/:\s*PresentationSpec\s*=/)) errors.push("Missing PresentationSpec type annotation");
-	if (!code.includes("meta:")) errors.push("Missing meta section");
-	if (!code.includes("content:")) errors.push("Missing content section");
-	if (!code.match(/kind:\s*['"](?:web_component|markdown|data)['"]/)) errors.push("Missing or invalid kind field");
-}
-function validateWorkflowSpec(code, errors, warnings) {
-	if (!code.match(/:\s*WorkflowSpec\s*=/)) errors.push("Missing WorkflowSpec type annotation");
-	if (!code.includes("definition:")) errors.push("Missing definition section");
-	if (!code.includes("steps:")) errors.push("Workflow must declare steps");
-	if (!code.includes("transitions:")) warnings.push("No transitions declared; workflow will complete after first step.");
-	if (!code.match(/title:\s*['"][^'"]+['"]/)) warnings.push("Missing workflow title");
-	if (!code.match(/domain:\s*['"][^'"]+['"]/)) warnings.push("Missing domain field");
-	if (code.includes("TODO")) warnings.push("Contains TODO items that need completion");
-}
-function validateMigrationSpec(code, errors, warnings) {
-	if (!code.match(/:\s*MigrationSpec\s*=/)) errors.push("Missing MigrationSpec type annotation");
-	if (!code.includes("plan:")) errors.push("Missing plan section");
-	else if (!code.includes("up:")) errors.push("Migration must define at least one up step");
-	if (!code.match(/name:\s*['"][^'"]+['"]/)) errors.push("Missing or invalid migration name");
-	if (!code.match(/version:\s*\d+/)) errors.push("Missing or invalid migration version");
-	if (code.includes("TODO")) warnings.push("Contains TODO items that need completion");
-}
-/**
-* Validate common fields across all spec types
-*/
-function validateCommonFields(code, errors, warnings) {
-	if (code.includes("SchemaModel") && !code.includes("from '@lssm/lib.schema'")) errors.push("Missing import for SchemaModel from @lssm/lib.schema");
-	if (!code.includes("from '@lssm/lib.contracts'")) errors.push("Missing import from @lssm/lib.contracts");
-	const ownersMatch = code.match(/owners:\s*\[(.*?)\]/s);
-	if (ownersMatch?.[1]) {
-		if (!ownersMatch[1].includes("@")) warnings.push("Owners should start with @ (e.g., \"@team\")");
-	}
-	if (!code.match(/stability:\s*['"](?:experimental|beta|stable|deprecated)['"]/)) warnings.push("Missing or invalid stability field");
-}
-function validateDataViewSpec(code, errors, _warnings) {
-	if (!code.match(/:\s*DataViewSpec\s*=/)) errors.push("Missing DataViewSpec type annotation");
-	if (!code.includes("meta:")) errors.push("Missing meta section");
-	if (!code.includes("source:")) errors.push("Missing source section");
-	if (!code.includes("view:")) errors.push("Missing view section");
-	if (!code.match(/kind:\s*['"](list|table|detail|grid)['"]/)) errors.push("Missing or invalid view.kind (list/table/detail/grid)");
-	if (!code.match(/fields:\s*\[/)) errors.push("No fields defined for data view");
-}
-
-//#endregion
-export { validateSpecStructure };
+function e(e,d){let f=[],p=[];return/export\s+(const|let)\s+\w+/.test(e)||f.push(`No exported spec found`),d.includes(`.contracts.`)&&t(e,f,p),d.includes(`.event.`)&&a(e,f,p),d.includes(`.presentation.`)&&o(e,f,p),d.includes(`.workflow.`)&&s(e,f,p),d.includes(`.data-view.`)&&u(e,f,p),d.includes(`.migration.`)&&c(e,f,p),d.includes(`.telemetry.`)&&n(e,f,p),d.includes(`.experiment.`)&&r(e,f,p),d.includes(`.app-config.`)&&i(e,f,p),l(e,f,p),{valid:f.length===0,errors:f,warnings:p}}function t(e,t,n){/define(Command|Query)/.test(e)||t.push(`Missing defineCommand or defineQuery call`),e.includes(`meta:`)||t.push(`Missing meta section`),e.includes(`io:`)||t.push(`Missing io section`),e.includes(`policy:`)||t.push(`Missing policy section`),e.match(/name:\s*['"][^'"]+['"]/)||t.push(`Missing or invalid name field`),e.match(/version:\s*\d+/)||t.push(`Missing or invalid version field`);let r=/defineCommand\s*\(/.test(e),i=/defineQuery\s*\(/.test(e),a=/kind:\s*['"](?:command|query)['"]/.test(e);!r&&!i&&!a&&t.push(`Missing kind: use defineCommand(), defineQuery(), or explicit kind field`),e.includes(`acceptance:`)||n.push(`No acceptance scenarios defined`),e.includes(`examples:`)||n.push(`No examples provided`),e.includes(`TODO`)&&n.push(`Contains TODO items that need completion`)}function n(e,t,n){e.match(/:\s*TelemetrySpec\s*=/)||t.push(`Missing TelemetrySpec type annotation`),e.match(/meta:\s*{[\s\S]*name:/)||t.push(`TelemetrySpec.meta is required`),e.includes(`events:`)||t.push(`TelemetrySpec must declare events`),e.match(/privacy:\s*'(public|internal|pii|sensitive)'/)||n.push(`No explicit privacy classification found`)}function r(e,t,n){e.match(/:\s*ExperimentSpec\s*=/)||t.push(`Missing ExperimentSpec type annotation`),e.includes(`controlVariant`)||t.push(`ExperimentSpec must declare controlVariant`),e.includes(`variants:`)||t.push(`ExperimentSpec must declare variants`),e.match(/allocation:\s*{/)||n.push(`ExperimentSpec missing allocation configuration`)}function i(e,t,n){e.match(/:\s*AppBlueprintSpec\s*=/)||t.push(`Missing AppBlueprintSpec type annotation`),e.includes(`meta:`)||t.push(`AppBlueprintSpec must define meta`),e.includes(`appId`)||n.push(`AppBlueprint meta missing appId assignment`),e.includes(`capabilities`)||n.push(`App blueprint spec does not declare capabilities`)}function a(e,t,n){e.includes(`defineEvent`)||t.push(`Missing defineEvent call`),e.match(/name:\s*['"][^'"]+['"]/)||t.push(`Missing or invalid name field`),e.match(/version:\s*\d+/)||t.push(`Missing or invalid version field`),e.includes(`payload:`)||t.push(`Missing payload field`);let r=e.match(/name:\s*['"]([^'"]+)['"]/);r?.[1]&&((r[1].split(`.`).pop()??``).match(/(ed|created|updated|deleted|completed)$/i)||n.push(`Event name should use past tense (e.g., "created", "updated")`))}function o(e,t,n){e.match(/:\s*PresentationSpec\s*=/)||t.push(`Missing PresentationSpec type annotation`),e.includes(`meta:`)||t.push(`Missing meta section`),e.includes(`content:`)||t.push(`Missing content section`),e.match(/kind:\s*['"](?:web_component|markdown|data)['"]/)||t.push(`Missing or invalid kind field`)}function s(e,t,n){e.match(/:\s*WorkflowSpec\s*=/)||t.push(`Missing WorkflowSpec type annotation`),e.includes(`definition:`)||t.push(`Missing definition section`),e.includes(`steps:`)||t.push(`Workflow must declare steps`),e.includes(`transitions:`)||n.push(`No transitions declared; workflow will complete after first step.`),e.match(/title:\s*['"][^'"]+['"]/)||n.push(`Missing workflow title`),e.match(/domain:\s*['"][^'"]+['"]/)||n.push(`Missing domain field`),e.includes(`TODO`)&&n.push(`Contains TODO items that need completion`)}function c(e,t,n){e.match(/:\s*MigrationSpec\s*=/)||t.push(`Missing MigrationSpec type annotation`),e.includes(`plan:`)?e.includes(`up:`)||t.push(`Migration must define at least one up step`):t.push(`Missing plan section`),e.match(/name:\s*['"][^'"]+['"]/)||t.push(`Missing or invalid migration name`),e.match(/version:\s*\d+/)||t.push(`Missing or invalid migration version`),e.includes(`TODO`)&&n.push(`Contains TODO items that need completion`)}function l(e,t,n){e.includes(`SchemaModel`)&&!e.includes(`from '@lssm/lib.schema'`)&&t.push(`Missing import for SchemaModel from @lssm/lib.schema`),e.includes(`from '@lssm/lib.contracts'`)||t.push(`Missing import from @lssm/lib.contracts`);let r=e.match(/owners:\s*\[(.*?)\]/s);r?.[1]&&(r[1].includes(`@`)||n.push(`Owners should start with @ (e.g., "@team")`)),e.match(/stability:\s*['"](?:experimental|beta|stable|deprecated)['"]/)||n.push(`Missing or invalid stability field`)}function u(e,t,n){e.match(/:\s*DataViewSpec\s*=/)||t.push(`Missing DataViewSpec type annotation`),e.includes(`meta:`)||t.push(`Missing meta section`),e.includes(`source:`)||t.push(`Missing source section`),e.includes(`view:`)||t.push(`Missing view section`),e.match(/kind:\s*['"](list|table|detail|grid)['"]/)||t.push(`Missing or invalid view.kind (list/table/detail/grid)`),e.match(/fields:\s*\[/)||t.push(`No fields defined for data view`)}export{e as validateSpecStructure};

package/dist/index.js

@@ -1,25 +1 @@
-import { DEFAULT_WORKSPACE_CONFIG } from "./types/generation-types.js";
-import { extractEmittedEvents, extractPolicyRefs, extractTestRefs, inferSpecTypeFromFilePath, scanAllSpecsFromSource, scanSpecSource } from "./analysis/spec-scan.js";
-import { isFeatureFile, scanFeatureSource } from "./analysis/feature-scan.js";
-import { computeSemanticDiff } from "./analysis/diff/semantic.js";
-import { addContractNode, buildReverseEdges, createContractGraph, detectCycles, findMissingDependencies, toDot } from "./analysis/deps/graph.js";
-import { parseImportedSpecNames } from "./analysis/deps/parse-imports.js";
-import { validateSpecStructure } from "./analysis/validate/spec-structure.js";
-import { capitalize, escapeString, toCamelCase, toKebabCase, toPascalCase } from "./templates/utils.js";
-import { generateOperationSpec } from "./templates/operation.js";
-import { generateEventSpec } from "./templates/event.js";
-import { generatePresentationSpec } from "./templates/presentation.js";
-import { generateWorkflowSpec } from "./templates/workflow.js";
-import { generateWorkflowRunnerTemplate } from "./templates/workflow-runner.js";
-import { generateDataViewSpec } from "./templates/data-view.js";
-import { generateTelemetrySpec } from "./templates/telemetry.js";
-import { generateExperimentSpec } from "./templates/experiment.js";
-import { generateAppBlueprintSpec } from "./templates/app-config.js";
-import { generateMigrationSpec } from "./templates/migration.js";
-import { generateIntegrationSpec } from "./templates/integration.js";
-import { generateKnowledgeSpaceSpec } from "./templates/knowledge.js";
-import { generateComponentTemplate, generateHandlerTemplate, generateTestTemplate } from "./templates/handler.js";
-import { addExampleContext, buildEventSpecPrompt, buildOperationSpecPrompt, buildPresentationSpecPrompt, getSystemPrompt } from "./ai/spec-creation.js";
-import { buildComponentPrompt, buildFormPrompt, buildHandlerPrompt, buildTestPrompt, getCodeGenSystemPrompt } from "./ai/code-generation.js";
-
-export { DEFAULT_WORKSPACE_CONFIG, addContractNode, addExampleContext, buildComponentPrompt, buildEventSpecPrompt, buildFormPrompt, buildHandlerPrompt, buildOperationSpecPrompt, buildPresentationSpecPrompt, buildReverseEdges, buildTestPrompt, capitalize, computeSemanticDiff, createContractGraph, detectCycles, escapeString, extractEmittedEvents, extractPolicyRefs, extractTestRefs, findMissingDependencies, generateAppBlueprintSpec, generateComponentTemplate, generateDataViewSpec, generateEventSpec, generateExperimentSpec, generateHandlerTemplate, generateIntegrationSpec, generateKnowledgeSpaceSpec, generateMigrationSpec, generateOperationSpec, generatePresentationSpec, generateTelemetrySpec, generateTestTemplate, generateWorkflowRunnerTemplate, generateWorkflowSpec, getCodeGenSystemPrompt, getSystemPrompt, inferSpecTypeFromFilePath, isFeatureFile, parseImportedSpecNames, scanAllSpecsFromSource, scanFeatureSource, scanSpecSource, toCamelCase, toDot, toKebabCase, toPascalCase, validateSpecStructure };
+import{DEFAULT_WORKSPACE_CONFIG as e}from"./types/generation-types.js";import{extractEmittedEvents as t,extractPolicyRefs as n,extractTestRefs as r,inferSpecTypeFromFilePath as i,scanAllSpecsFromSource as a,scanSpecSource as o}from"./analysis/spec-scan.js";import{isFeatureFile as s,scanFeatureSource as c}from"./analysis/feature-scan.js";import{computeSemanticDiff as l}from"./analysis/diff/semantic.js";import{addContractNode as u,buildReverseEdges as d,createContractGraph as f,detectCycles as p,findMissingDependencies as m,toDot as h}from"./analysis/deps/graph.js";import{parseImportedSpecNames as g}from"./analysis/deps/parse-imports.js";import{validateSpecStructure as _}from"./analysis/validate/spec-structure.js";import{capitalize as v,escapeString as y,toCamelCase as b,toKebabCase as x,toPascalCase as S}from"./templates/utils.js";import{generateOperationSpec as C}from"./templates/operation.js";import{generateEventSpec as w}from"./templates/event.js";import{generatePresentationSpec as T}from"./templates/presentation.js";import{generateWorkflowSpec as E}from"./templates/workflow.js";import{generateWorkflowRunnerTemplate as D}from"./templates/workflow-runner.js";import{generateDataViewSpec as O}from"./templates/data-view.js";import{generateTelemetrySpec as k}from"./templates/telemetry.js";import{generateExperimentSpec as A}from"./templates/experiment.js";import{generateAppBlueprintSpec as j}from"./templates/app-config.js";import{generateMigrationSpec as M}from"./templates/migration.js";import{generateIntegrationSpec as N}from"./templates/integration.js";import{generateKnowledgeSpaceSpec as P}from"./templates/knowledge.js";import{generateComponentTemplate as F,generateHandlerTemplate as I,generateTestTemplate as L}from"./templates/handler.js";import{addExampleContext as R,buildEventSpecPrompt as z,buildOperationSpecPrompt as B,buildPresentationSpecPrompt as V,getSystemPrompt as H}from"./ai/spec-creation.js";import{buildComponentPrompt as U,buildFormPrompt as W,buildHandlerPrompt as G,buildTestPrompt as K,getCodeGenSystemPrompt as q}from"./ai/code-generation.js";export{e as DEFAULT_WORKSPACE_CONFIG,u as addContractNode,R as addExampleContext,U as buildComponentPrompt,z as buildEventSpecPrompt,W as buildFormPrompt,G as buildHandlerPrompt,B as buildOperationSpecPrompt,V as buildPresentationSpecPrompt,d as buildReverseEdges,K as buildTestPrompt,v as capitalize,l as computeSemanticDiff,f as createContractGraph,p as detectCycles,y as escapeString,t as extractEmittedEvents,n as extractPolicyRefs,r as extractTestRefs,m as findMissingDependencies,j as generateAppBlueprintSpec,F as generateComponentTemplate,O as generateDataViewSpec,w as generateEventSpec,A as generateExperimentSpec,I as generateHandlerTemplate,N as generateIntegrationSpec,P as generateKnowledgeSpaceSpec,M as generateMigrationSpec,C as generateOperationSpec,T as generatePresentationSpec,k as generateTelemetrySpec,L as generateTestTemplate,D as generateWorkflowRunnerTemplate,E as generateWorkflowSpec,q as getCodeGenSystemPrompt,H as getSystemPrompt,i as inferSpecTypeFromFilePath,s as isFeatureFile,g as parseImportedSpecNames,a as scanAllSpecsFromSource,c as scanFeatureSource,o as scanSpecSource,b as toCamelCase,h as toDot,x as toKebabCase,S as toPascalCase,_ as validateSpecStructure};