@contractspec/module.workspace 1.57.0 → 1.58.0

package/dist/analysis/snapshot/snapshot.js

@@ -1,163 +0,0 @@
-import { scanSpecSource } from "../spec-scan.js";
-import { computeHash, sortFields, sortSpecs } from "./normalizer.js";
-
-//#region src/analysis/snapshot/snapshot.ts
-/**
-* Contract snapshot generation.
-*
-* Generates canonical, deterministic snapshots from spec source files
-* for comparison and impact detection.
-*/
-/**
-* Generate a contract snapshot from spec source files.
-*
-* @param specs - Array of { path, content } for each spec file
-* @param options - Snapshot generation options
-* @returns Canonical contract snapshot
-*/
-function generateSnapshot(specs, options = {}) {
-	const snapshots = [];
-	for (const { path, content } of specs) {
-		const scanned = scanSpecSource(content, path);
-		if (options.types && !options.types.includes(scanned.specType)) continue;
-		if (scanned.specType === "operation" && scanned.key && scanned.version !== void 0) {
-			const opSnapshot = createOperationSnapshot(scanned, content);
-			if (opSnapshot) snapshots.push(opSnapshot);
-		} else if (scanned.specType === "event" && scanned.key && scanned.version !== void 0) {
-			const eventSnapshot = createEventSnapshot(scanned, content);
-			if (eventSnapshot) snapshots.push(eventSnapshot);
-		}
-	}
-	const sortedSpecs = sortSpecs(snapshots);
-	const hash = computeHash({ specs: sortedSpecs });
-	return {
-		version: "1.0.0",
-		generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-		specs: sortedSpecs,
-		hash
-	};
-}
-/**
-* Create an operation snapshot from scanned spec data.
-*/
-function createOperationSnapshot(scanned, content) {
-	if (!scanned.key || scanned.version === void 0) return null;
-	const io = extractIoFromSource(content);
-	const http = extractHttpBinding(content);
-	return {
-		type: "operation",
-		key: scanned.key,
-		version: scanned.version,
-		kind: scanned.kind === "command" || scanned.kind === "query" ? scanned.kind : "command",
-		stability: scanned.stability ?? "experimental",
-		http: http ?? void 0,
-		io,
-		authLevel: extractAuthLevel(content),
-		emittedEvents: scanned.emittedEvents
-	};
-}
-/**
-* Create an event snapshot from scanned spec data.
-*/
-function createEventSnapshot(scanned, content) {
-	if (!scanned.key || scanned.version === void 0) return null;
-	const payload = extractPayloadFromSource(content);
-	return {
-		type: "event",
-		key: scanned.key,
-		version: scanned.version,
-		stability: scanned.stability ?? "experimental",
-		payload
-	};
-}
-/**
-* Extract IO schema from source code.
-* This is a heuristic extraction - not full Zod introspection.
-*/
-function extractIoFromSource(content) {
-	const input = extractSchemaFields(content, "input");
-	const output = extractSchemaFields(content, "output");
-	return {
-		input: sortFields(input),
-		output: sortFields(output)
-	};
-}
-/**
-* Extract payload schema from event source code.
-*/
-function extractPayloadFromSource(content) {
-	return sortFields(extractSchemaFields(content, "payload"));
-}
-/**
-* Extract schema fields from a specific section of the source.
-*/
-function extractSchemaFields(content, section) {
-	const fields = {};
-	const sectionPattern = new RegExp(`${section}\\s*:\\s*z\\.object\\(\\{([^}]+)\\}`, "s");
-	const sectionMatch = content.match(sectionPattern);
-	if (!sectionMatch?.[1]) return fields;
-	const sectionContent = sectionMatch[1];
-	const fieldPattern = /(\w+)\s*:\s*z\.(\w+)\((.*?)\)/g;
-	let match;
-	while ((match = fieldPattern.exec(sectionContent)) !== null) {
-		const [, fieldName, zodType] = match;
-		if (!fieldName || !zodType) continue;
-		const isOptional = sectionContent.includes(`${fieldName}:`) && sectionContent.slice(sectionContent.indexOf(`${fieldName}:`)).includes(".optional()");
-		const isNullable = sectionContent.includes(`${fieldName}:`) && sectionContent.slice(sectionContent.indexOf(`${fieldName}:`)).includes(".nullable()");
-		fields[fieldName] = {
-			name: fieldName,
-			type: mapZodTypeToFieldType(zodType),
-			required: !isOptional,
-			nullable: isNullable
-		};
-	}
-	return fields;
-}
-/**
-* Map Zod type to FieldType.
-*/
-function mapZodTypeToFieldType(zodType) {
-	return {
-		string: "string",
-		number: "number",
-		boolean: "boolean",
-		object: "object",
-		array: "array",
-		enum: "enum",
-		union: "union",
-		literal: "literal",
-		date: "date",
-		coerce: "unknown"
-	}[zodType] ?? "unknown";
-}
-/**
-* Extract HTTP binding from source code.
-*/
-function extractHttpBinding(content) {
-	const methodMatch = content.match(/method\s*:\s*['"](\w+)['"]/);
-	const pathMatch = content.match(/path\s*:\s*['"]([^'"]+)['"]/);
-	if (methodMatch?.[1] && pathMatch?.[1]) {
-		const method = methodMatch[1].toUpperCase();
-		if ([
-			"GET",
-			"POST",
-			"PUT",
-			"PATCH",
-			"DELETE"
-		].includes(method)) return {
-			method,
-			path: pathMatch[1]
-		};
-	}
-	return null;
-}
-/**
-* Extract auth level from source code.
-*/
-function extractAuthLevel(content) {
-	return content.match(/auth\s*:\s*['"](\w+)['"]/)?.[1];
-}
-
-//#endregion
-export { generateSnapshot };
-//# sourceMappingURL=snapshot.js.map

package/dist/analysis/snapshot/snapshot.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"snapshot.js","names":[],"sources":["../../../src/analysis/snapshot/snapshot.ts"],"sourcesContent":["/**\n * Contract snapshot generation.\n *\n * Generates canonical, deterministic snapshots from spec source files\n * for comparison and impact detection.\n */\n\nimport { scanSpecSource } from '../spec-scan';\nimport { computeHash, sortSpecs, sortFields } from './normalizer';\nimport type {\n  ContractSnapshot,\n  EventSnapshot,\n  FieldSnapshot,\n  FieldType,\n  IoSnapshot,\n  OperationSnapshot,\n  SnapshotOptions,\n  SpecSnapshot,\n} from './types';\n\n/**\n * Generate a contract snapshot from spec source files.\n *\n * @param specs - Array of { path, content } for each spec file\n * @param options - Snapshot generation options\n * @returns Canonical contract snapshot\n */\nexport function generateSnapshot(\n  specs: { path: string; content: string }[],\n  options: SnapshotOptions = {}\n): ContractSnapshot {\n  const snapshots: SpecSnapshot[] = [];\n\n  for (const { path, content } of specs) {\n    const scanned = scanSpecSource(content, path);\n\n    // Filter by types if specified\n    if (\n      options.types &&\n      !options.types.includes(scanned.specType as 'operation' | 'event')\n    ) {\n      continue;\n    }\n\n    if (\n      scanned.specType === 'operation' &&\n      scanned.key &&\n      scanned.version !== undefined\n    ) {\n      const opSnapshot = createOperationSnapshot(scanned, content);\n      if (opSnapshot) {\n        snapshots.push(opSnapshot);\n      }\n    } else if (\n      scanned.specType === 'event' &&\n      scanned.key &&\n      scanned.version !== undefined\n    ) {\n      const eventSnapshot = createEventSnapshot(scanned, content);\n      if (eventSnapshot) {\n        snapshots.push(eventSnapshot);\n      }\n    }\n  }\n\n  const sortedSpecs = sortSpecs(snapshots);\n  const hash = computeHash({ specs: sortedSpecs });\n\n  return {\n    version: '1.0.0',\n    generatedAt: new Date().toISOString(),\n    specs: sortedSpecs,\n    hash,\n  };\n}\n\n/**\n * Create an operation snapshot from scanned spec data.\n */\nfunction createOperationSnapshot(\n  scanned: ReturnType<typeof scanSpecSource>,\n  content: string\n): OperationSnapshot | null {\n  if (!scanned.key || scanned.version === undefined) {\n    return null;\n  }\n\n  const io = extractIoFromSource(content);\n  const http = extractHttpBinding(content);\n\n  return {\n    type: 'operation',\n    key: scanned.key,\n    version: scanned.version,\n    kind:\n      scanned.kind === 'command' || scanned.kind === 'query'\n        ? scanned.kind\n        : 'command',\n    stability: scanned.stability ?? 'experimental',\n    http: http ?? undefined,\n    io,\n    authLevel: extractAuthLevel(content),\n    emittedEvents: scanned.emittedEvents,\n  };\n}\n\n/**\n * Create an event snapshot from scanned spec data.\n */\nfunction createEventSnapshot(\n  scanned: ReturnType<typeof scanSpecSource>,\n  content: string\n): EventSnapshot | null {\n  if (!scanned.key || scanned.version === undefined) {\n    return null;\n  }\n\n  const payload = extractPayloadFromSource(content);\n\n  return {\n    type: 'event',\n    key: scanned.key,\n    version: scanned.version,\n    stability: scanned.stability ?? 'experimental',\n    payload,\n  };\n}\n\n/**\n * Extract IO schema from source code.\n * This is a heuristic extraction - not full Zod introspection.\n */\nfunction extractIoFromSource(content: string): IoSnapshot {\n  const input = extractSchemaFields(content, 'input');\n  const output = extractSchemaFields(content, 'output');\n\n  return {\n    input: sortFields(input) as Record<string, FieldSnapshot>,\n    output: sortFields(output) as Record<string, FieldSnapshot>,\n  };\n}\n\n/**\n * Extract payload schema from event source code.\n */\nfunction extractPayloadFromSource(\n  content: string\n): Record<string, FieldSnapshot> {\n  const fields = extractSchemaFields(content, 'payload');\n  return sortFields(fields) as Record<string, FieldSnapshot>;\n}\n\n/**\n * Extract schema fields from a specific section of the source.\n */\nfunction extractSchemaFields(\n  content: string,\n  section: 'input' | 'output' | 'payload'\n): Record<string, FieldSnapshot> {\n  const fields: Record<string, FieldSnapshot> = {};\n\n  // Look for z.object({ ... }) patterns within the section\n  const sectionPattern = new RegExp(\n    `${section}\\\\s*:\\\\s*z\\\\.object\\\\(\\\\{([^}]+)\\\\}`,\n    's'\n  );\n  const sectionMatch = content.match(sectionPattern);\n\n  if (!sectionMatch?.[1]) {\n    return fields;\n  }\n\n  const sectionContent = sectionMatch[1];\n\n  // Match field definitions: fieldName: z.string(), z.number(), etc.\n  const fieldPattern = /(\\w+)\\s*:\\s*z\\.(\\w+)\\((.*?)\\)/g;\n  let match;\n\n  while ((match = fieldPattern.exec(sectionContent)) !== null) {\n    const [, fieldName, zodType] = match;\n    if (!fieldName || !zodType) continue;\n\n    const isOptional =\n      sectionContent.includes(`${fieldName}:`) &&\n      sectionContent\n        .slice(sectionContent.indexOf(`${fieldName}:`))\n        .includes('.optional()');\n    const isNullable =\n      sectionContent.includes(`${fieldName}:`) &&\n      sectionContent\n        .slice(sectionContent.indexOf(`${fieldName}:`))\n        .includes('.nullable()');\n\n    fields[fieldName] = {\n      name: fieldName,\n      type: mapZodTypeToFieldType(zodType),\n      required: !isOptional,\n      nullable: isNullable,\n    };\n  }\n\n  return fields;\n}\n\n/**\n * Map Zod type to FieldType.\n */\nfunction mapZodTypeToFieldType(zodType: string): FieldType {\n  const mapping: Record<string, FieldType> = {\n    string: 'string',\n    number: 'number',\n    boolean: 'boolean',\n    object: 'object',\n    array: 'array',\n    enum: 'enum',\n    union: 'union',\n    literal: 'literal',\n    date: 'date',\n    coerce: 'unknown',\n  };\n  return mapping[zodType] ?? 'unknown';\n}\n\n/**\n * Extract HTTP binding from source code.\n */\nfunction extractHttpBinding(content: string): {\n  method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';\n  path: string;\n} | null {\n  // Look for http: { method: 'X', path: 'Y' } pattern\n  const methodMatch = content.match(/method\\s*:\\s*['\"](\\w+)['\"]/);\n  const pathMatch = content.match(/path\\s*:\\s*['\"]([^'\"]+)['\"]/);\n\n  if (methodMatch?.[1] && pathMatch?.[1]) {\n    const method = methodMatch[1].toUpperCase();\n    if (['GET', 'POST', 'PUT', 'PATCH', 'DELETE'].includes(method)) {\n      return {\n        method: method as 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE',\n        path: pathMatch[1],\n      };\n    }\n  }\n\n  return null;\n}\n\n/**\n * Extract auth level from source code.\n */\nfunction extractAuthLevel(content: string): string | undefined {\n  const authMatch = content.match(/auth\\s*:\\s*['\"](\\w+)['\"]/);\n  return authMatch?.[1];\n}\n"],"mappings":"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"}

package/dist/analysis/spec-parser.js

@@ -1,89 +0,0 @@
-import { scanAllSpecsFromSource } from "./spec-scan.js";
-import { isFeatureFile, scanFeatureSource } from "./feature-scan.js";
-import { readFile } from "node:fs/promises";
-
-//#region src/analysis/spec-parser.ts
-/**
-* Spec Parser
-*
-* Coordinates scanning of source files and mapping to ParsedSpec format
-* for LLM consumption.
-*/
-/**
-* Load and parse specs from a source file.
-*/
-async function loadSpecFromSource(filePath) {
-	try {
-		const code = await readFile(filePath, "utf-8");
-		if (isFeatureFile(filePath)) return [mapFeatureResultToParsedSpec(scanFeatureSource(code, filePath))];
-		return scanAllSpecsFromSource(code, filePath).map(mapSpecResultToParsedSpec);
-	} catch (error) {
-		console.warn(`Failed to parse spec from ${filePath}:`, error);
-		return [];
-	}
-}
-/**
-* Map FeatureScanResult to ParsedSpec.
-*/
-function mapFeatureResultToParsedSpec(result) {
-	return {
-		meta: {
-			key: result.key,
-			version: "1.0.0",
-			description: result.description,
-			stability: result.stability,
-			owners: result.owners,
-			tags: result.tags,
-			goal: result.goal,
-			context: result.context
-		},
-		specType: "feature",
-		filePath: result.filePath,
-		sourceBlock: result.sourceBlock,
-		operations: result.operations.map(mapToSpecRef),
-		events: result.events.map(mapToSpecRef),
-		presentations: result.presentations.map(mapToSpecRef)
-	};
-}
-/**
-* Map SpecScanResult to ParsedSpec.
-*/
-function mapSpecResultToParsedSpec(result) {
-	return {
-		meta: {
-			key: result.key ?? "unknown",
-			version: result.version ?? "1.0.0",
-			description: result.description,
-			stability: result.stability,
-			owners: result.owners,
-			tags: result.tags,
-			goal: result.goal,
-			context: result.context
-		},
-		specType: result.specType,
-		kind: result.kind,
-		hasIo: result.hasIo,
-		hasPolicy: result.hasPolicy,
-		hasPayload: result.hasPayload,
-		hasContent: result.hasContent,
-		hasDefinition: result.hasDefinition,
-		emittedEvents: result.emittedEvents?.map(mapToSpecRef),
-		policyRefs: result.policyRefs?.map(mapToSpecRef),
-		testRefs: result.testRefs?.map(mapToSpecRef),
-		filePath: result.filePath,
-		sourceBlock: result.sourceBlock
-	};
-}
-/**
-* Map RefInfo to SpecRef.
-*/
-function mapToSpecRef(ref) {
-	return {
-		name: ref.key,
-		version: ref.version
-	};
-}
-
-//#endregion
-export { loadSpecFromSource };
-//# sourceMappingURL=spec-parser.js.map

package/dist/analysis/spec-parser.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"spec-parser.js","names":[],"sources":["../../src/analysis/spec-parser.ts"],"sourcesContent":["/**\n * Spec Parser\n *\n * Coordinates scanning of source files and mapping to ParsedSpec format\n * for LLM consumption.\n */\n\nimport { readFile } from 'node:fs/promises';\nimport { isFeatureFile, scanFeatureSource } from './feature-scan';\nimport { scanAllSpecsFromSource } from './spec-scan';\nimport type { ParsedSpec, ParsedSpecMeta, SpecRef } from '../types/llm-types';\nimport type {\n  FeatureScanResult,\n  RefInfo,\n  SpecScanResult,\n} from '../types/analysis-types';\n\n/**\n * Load and parse specs from a source file.\n */\nexport async function loadSpecFromSource(\n  filePath: string\n): Promise<ParsedSpec[]> {\n  try {\n    const code = await readFile(filePath, 'utf-8');\n\n    if (isFeatureFile(filePath)) {\n      const featureResult = scanFeatureSource(code, filePath);\n      return [mapFeatureResultToParsedSpec(featureResult)];\n    }\n\n    const specResults = scanAllSpecsFromSource(code, filePath);\n    return specResults.map(mapSpecResultToParsedSpec);\n  } catch (error) {\n    // Return empty array if file reading fails\n    console.warn(`Failed to parse spec from ${filePath}:`, error);\n    return [];\n  }\n}\n\n/**\n * Map FeatureScanResult to ParsedSpec.\n */\nfunction mapFeatureResultToParsedSpec(result: FeatureScanResult): ParsedSpec {\n  const meta: ParsedSpecMeta = {\n    key: result.key,\n    version: '1.0.0', // Default for features if not specified\n    description: result.description,\n    stability: result.stability,\n    owners: result.owners,\n    tags: result.tags,\n    goal: result.goal,\n    context: result.context,\n  };\n\n  return {\n    meta,\n    specType: 'feature',\n    filePath: result.filePath,\n    sourceBlock: result.sourceBlock,\n    operations: result.operations.map(mapToSpecRef),\n    events: result.events.map(mapToSpecRef),\n    presentations: result.presentations.map(mapToSpecRef),\n  };\n}\n\n/**\n * Map SpecScanResult to ParsedSpec.\n */\nfunction mapSpecResultToParsedSpec(result: SpecScanResult): ParsedSpec {\n  const meta: ParsedSpecMeta = {\n    key: result.key ?? 'unknown',\n    version: result.version ?? '1.0.0',\n    description: result.description,\n    stability: result.stability,\n    owners: result.owners,\n    tags: result.tags,\n    goal: result.goal,\n    context: result.context,\n  };\n\n  return {\n    meta,\n    specType: result.specType,\n    kind: result.kind,\n    hasIo: result.hasIo,\n    hasPolicy: result.hasPolicy,\n    hasPayload: result.hasPayload,\n    hasContent: result.hasContent,\n    hasDefinition: result.hasDefinition,\n    emittedEvents: result.emittedEvents?.map(mapToSpecRef),\n    policyRefs: result.policyRefs?.map(mapToSpecRef),\n    testRefs: result.testRefs?.map(mapToSpecRef),\n    filePath: result.filePath,\n    sourceBlock: result.sourceBlock,\n  };\n}\n\n/**\n * Map RefInfo to SpecRef.\n */\nfunction mapToSpecRef(ref: RefInfo): SpecRef {\n  return {\n    name: ref.key,\n    version: ref.version,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;AAoBA,eAAsB,mBACpB,UACuB;AACvB,KAAI;EACF,MAAM,OAAO,MAAM,SAAS,UAAU,QAAQ;AAE9C,MAAI,cAAc,SAAS,CAEzB,QAAO,CAAC,6BADc,kBAAkB,MAAM,SAAS,CACJ,CAAC;AAItD,SADoB,uBAAuB,MAAM,SAAS,CACvC,IAAI,0BAA0B;UAC1C,OAAO;AAEd,UAAQ,KAAK,6BAA6B,SAAS,IAAI,MAAM;AAC7D,SAAO,EAAE;;;;;;AAOb,SAAS,6BAA6B,QAAuC;AAY3E,QAAO;EACL,MAZ2B;GAC3B,KAAK,OAAO;GACZ,SAAS;GACT,aAAa,OAAO;GACpB,WAAW,OAAO;GAClB,QAAQ,OAAO;GACf,MAAM,OAAO;GACb,MAAM,OAAO;GACb,SAAS,OAAO;GACjB;EAIC,UAAU;EACV,UAAU,OAAO;EACjB,aAAa,OAAO;EACpB,YAAY,OAAO,WAAW,IAAI,aAAa;EAC/C,QAAQ,OAAO,OAAO,IAAI,aAAa;EACvC,eAAe,OAAO,cAAc,IAAI,aAAa;EACtD;;;;;AAMH,SAAS,0BAA0B,QAAoC;AAYrE,QAAO;EACL,MAZ2B;GAC3B,KAAK,OAAO,OAAO;GACnB,SAAS,OAAO,WAAW;GAC3B,aAAa,OAAO;GACpB,WAAW,OAAO;GAClB,QAAQ,OAAO;GACf,MAAM,OAAO;GACb,MAAM,OAAO;GACb,SAAS,OAAO;GACjB;EAIC,UAAU,OAAO;EACjB,MAAM,OAAO;EACb,OAAO,OAAO;EACd,WAAW,OAAO;EAClB,YAAY,OAAO;EACnB,YAAY,OAAO;EACnB,eAAe,OAAO;EACtB,eAAe,OAAO,eAAe,IAAI,aAAa;EACtD,YAAY,OAAO,YAAY,IAAI,aAAa;EAChD,UAAU,OAAO,UAAU,IAAI,aAAa;EAC5C,UAAU,OAAO;EACjB,aAAa,OAAO;EACrB;;;;;AAMH,SAAS,aAAa,KAAuB;AAC3C,QAAO;EACL,MAAM,IAAI;EACV,SAAS,IAAI;EACd"}

package/dist/analysis/spec-parsing-utils.js

@@ -1,98 +0,0 @@
-import { escapeRegex, findMatchingDelimiter, matchStringField, matchVersionField } from "./utils/matchers.js";
-
-//#region src/analysis/spec-parsing-utils.ts
-function parsePolicy(code) {
-	const policyBlock = code.match(/policy\s*:\s*\{([\s\S]*?)\}/);
-	if (!policyBlock?.[1]) return [];
-	return extractRefList(policyBlock[1], "policies") ?? [];
-}
-function extractRefList(code, field) {
-	const regex = 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 = [];
-	const parts = inner.match(/\{[\s\S]*?\}/g);
-	if (parts) for (const part of parts) {
-		const k = matchStringField(part, "key");
-		const v = matchVersionField(part, "version");
-		if (k) items.push({
-			key: k,
-			version: v ?? "1.0.0"
-		});
-	}
-	return items.length > 0 ? items : void 0;
-}
-function extractTestRefs(code) {
-	const regex = new RegExp(`testRefs\\s*:\\s*\\[([\\s\\S]*?)\\]`);
-	const match = code.match(regex);
-	if (!match?.[1]) return void 0;
-	const inner = match[1];
-	const items = [];
-	const parts = inner.match(/\{[\s\S]*?\}/g);
-	if (parts) for (const part of parts) {
-		const k = matchStringField(part, "key");
-		const v = matchVersionField(part, "version");
-		const t = matchStringField(part, "type");
-		if (k) items.push({
-			key: k,
-			version: v ?? "1.0.0",
-			type: t === "error" ? "error" : "success"
-		});
-	}
-	return items.length > 0 ? items : void 0;
-}
-/**
-* Extract test target from a TestSpec source.
-* Parses the `target: { type: 'operation', key, version }` field OR
-* the nested format `target: { type: 'operation', operation: { key, version } }`.
-*/
-function extractTestTarget(code) {
-	const targetStartMatch = code.match(/target\s*:\s*\{/);
-	if (!targetStartMatch || targetStartMatch.index === void 0) return void 0;
-	const openBraceIndex = targetStartMatch.index + targetStartMatch[0].length - 1;
-	const closeBraceIndex = findMatchingDelimiter(code, openBraceIndex, "{", "}");
-	if (closeBraceIndex === -1) return void 0;
-	const targetBlock = code.substring(openBraceIndex + 1, closeBraceIndex);
-	const typeMatch = targetBlock.match(/type\s*:\s*['"](\w+)['"]/);
-	if (!typeMatch?.[1]) return void 0;
-	const type = typeMatch[1];
-	if (type !== "operation" && type !== "workflow") return void 0;
-	const flatKey = matchStringField(targetBlock, "key");
-	if (flatKey) return {
-		type,
-		key: flatKey,
-		version: matchVersionField(targetBlock, "version")
-	};
-	const refBlockMatch = targetBlock.match(new RegExp(`${type}\\s*:\\s*\\{([\\s\\S]*?)\\}`));
-	if (!refBlockMatch?.[1]) return void 0;
-	const refBlock = refBlockMatch[1];
-	const key = matchStringField(refBlock, "key");
-	if (!key) return void 0;
-	return {
-		type,
-		key,
-		version: matchVersionField(refBlock, "version")
-	};
-}
-/**
-* Extract test coverage info from a TestSpec source.
-* Checks for presence of success (expectOutput) and failure (expectError) scenarios.
-* Supports both formats:
-* - New: `expectOutput: {}` and `expectError: {}`
-* - Old: `{ type: 'expectOutput', ... }` and `{ type: 'expectError', ... }`
-*/
-function extractTestCoverage(code) {
-	const hasSuccessNew = /expectOutput\s*:/.test(code);
-	const hasErrorNew = /expectError\s*:/.test(code);
-	const hasSuccessOld = /(['"]?)type\1\s*:\s*['"]expectOutput['"]/.test(code);
-	const hasErrorOld = /(['"]?)type\1\s*:\s*['"]expectError['"]/.test(code);
-	return {
-		hasSuccess: hasSuccessNew || hasSuccessOld,
-		hasError: hasErrorNew || hasErrorOld
-	};
-}
-
-//#endregion
-export { extractRefList, extractTestCoverage, extractTestRefs, extractTestTarget, parsePolicy };
-//# sourceMappingURL=spec-parsing-utils.js.map

package/dist/analysis/spec-parsing-utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"spec-parsing-utils.js","names":[],"sources":["../../src/analysis/spec-parsing-utils.ts"],"sourcesContent":["import {\n  escapeRegex,\n  matchStringField,\n  matchVersionField,\n  findMatchingDelimiter,\n} from './utils/matchers';\n\nexport function parsePolicy(code: string): { key: string; version: string }[] {\n  const policyBlock = code.match(/policy\\s*:\\s*\\{([\\s\\S]*?)\\}/);\n  if (!policyBlock?.[1]) return [];\n\n  return extractRefList(policyBlock[1], 'policies') ?? [];\n}\n\nexport function extractRefList(\n  code: string,\n  field: string\n): { key: string; version: string }[] | undefined {\n  const regex = new RegExp(`${escapeRegex(field)}\\\\s*:\\\\s*\\\\[([\\\\s\\\\S]*?)\\\\]`);\n  const match = code.match(regex);\n  if (!match?.[1]) return undefined;\n\n  const inner = match[1];\n  const items: { key: string; version: string }[] = [];\n\n  const parts = inner.match(/\\{[\\s\\S]*?\\}/g);\n  if (parts) {\n    for (const part of parts) {\n      const k = matchStringField(part, 'key');\n      const v = matchVersionField(part, 'version');\n      if (k) {\n        items.push({ key: k, version: v ?? '1.0.0' });\n      }\n    }\n  }\n\n  return items.length > 0 ? items : undefined;\n}\n\nexport function extractTestRefs(\n  code: string\n): { key: string; version: string; type: 'success' | 'error' }[] | undefined {\n  const regex = new RegExp(`testRefs\\\\s*:\\\\s*\\\\[([\\\\s\\\\S]*?)\\\\]`);\n  const match = code.match(regex);\n  if (!match?.[1]) return undefined;\n\n  const inner = match[1];\n  const items: { key: string; version: string; type: 'success' | 'error' }[] =\n    [];\n\n  const parts = inner.match(/\\{[\\s\\S]*?\\}/g);\n  if (parts) {\n    for (const part of parts) {\n      const k = matchStringField(part, 'key');\n      const v = matchVersionField(part, 'version');\n      const t = matchStringField(part, 'type');\n      if (k) {\n        items.push({\n          key: k,\n          version: v ?? '1.0.0',\n          type: t === 'error' ? 'error' : 'success',\n        });\n      }\n    }\n  }\n\n  return items.length > 0 ? items : undefined;\n}\n\n/**\n * Extract test target from a TestSpec source.\n * Parses the `target: { type: 'operation', key, version }` field OR\n * the nested format `target: { type: 'operation', operation: { key, version } }`.\n */\nexport function extractTestTarget(\n  code: string\n):\n  | { type: 'operation' | 'workflow'; key: string; version: string | undefined }\n  | undefined {\n  // Find target block start\n  const targetStartMatch = code.match(/target\\s*:\\s*\\{/);\n  if (!targetStartMatch || targetStartMatch.index === undefined)\n    return undefined;\n\n  const openBraceIndex =\n    targetStartMatch.index + targetStartMatch[0].length - 1;\n  const closeBraceIndex = findMatchingDelimiter(code, openBraceIndex, '{', '}');\n\n  if (closeBraceIndex === -1) return undefined;\n\n  const targetBlock = code.substring(openBraceIndex + 1, closeBraceIndex);\n\n  // Extract the type\n  const typeMatch = targetBlock.match(/type\\s*:\\s*['\"](\\w+)['\"]/);\n  if (!typeMatch?.[1]) return undefined;\n\n  const type = typeMatch[1];\n  if (type !== 'operation' && type !== 'workflow') return undefined;\n\n  // Try flat format first: { type: 'operation', key: '...', version: '...' }\n  const flatKey = matchStringField(targetBlock, 'key');\n  if (flatKey) {\n    const flatVersion = matchVersionField(targetBlock, 'version');\n    return {\n      type,\n      key: flatKey,\n      version: flatVersion,\n    };\n  }\n\n  // Try nested format: { type: 'operation', operation: { key: '...', version: '...' } }\n  const refBlockMatch = targetBlock.match(\n    new RegExp(`${type}\\\\s*:\\\\s*\\\\{([\\\\s\\\\S]*?)\\\\}`)\n  );\n\n  if (!refBlockMatch?.[1]) return undefined;\n\n  const refBlock = refBlockMatch[1];\n\n  // Extract key and version from the ref block\n  const key = matchStringField(refBlock, 'key');\n  if (!key) return undefined;\n\n  const version = matchVersionField(refBlock, 'version');\n\n  return {\n    type,\n    key,\n    version,\n  };\n}\n\n/**\n * Extract test coverage info from a TestSpec source.\n * Checks for presence of success (expectOutput) and failure (expectError) scenarios.\n * Supports both formats:\n * - New: `expectOutput: {}` and `expectError: {}`\n * - Old: `{ type: 'expectOutput', ... }` and `{ type: 'expectError', ... }`\n */\nexport function extractTestCoverage(code: string): {\n  hasSuccess: boolean;\n  hasError: boolean;\n} {\n  // Check new format: expectOutput: or expectError: as keys\n  const hasSuccessNew = /expectOutput\\s*:/.test(code);\n  const hasErrorNew = /expectError\\s*:/.test(code);\n\n  // Check old format: { type: 'expectOutput' } or { type: 'expectError' }\n  const hasSuccessOld = /(['\"]?)type\\1\\s*:\\s*['\"]expectOutput['\"]/.test(code);\n  const hasErrorOld = /(['\"]?)type\\1\\s*:\\s*['\"]expectError['\"]/.test(code);\n\n  return {\n    hasSuccess: hasSuccessNew || hasSuccessOld,\n    hasError: hasErrorNew || hasErrorOld,\n  };\n}\n"],"mappings":";;;AAOA,SAAgB,YAAY,MAAkD;CAC5E,MAAM,cAAc,KAAK,MAAM,8BAA8B;AAC7D,KAAI,CAAC,cAAc,GAAI,QAAO,EAAE;AAEhC,QAAO,eAAe,YAAY,IAAI,WAAW,IAAI,EAAE;;AAGzD,SAAgB,eACd,MACA,OACgD;CAChD,MAAM,QAAQ,IAAI,OAAO,GAAG,YAAY,MAAM,CAAC,6BAA6B;CAC5E,MAAM,QAAQ,KAAK,MAAM,MAAM;AAC/B,KAAI,CAAC,QAAQ,GAAI,QAAO;CAExB,MAAM,QAAQ,MAAM;CACpB,MAAM,QAA4C,EAAE;CAEpD,MAAM,QAAQ,MAAM,MAAM,gBAAgB;AAC1C,KAAI,MACF,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,IAAI,iBAAiB,MAAM,MAAM;EACvC,MAAM,IAAI,kBAAkB,MAAM,UAAU;AAC5C,MAAI,EACF,OAAM,KAAK;GAAE,KAAK;GAAG,SAAS,KAAK;GAAS,CAAC;;AAKnD,QAAO,MAAM,SAAS,IAAI,QAAQ;;AAGpC,SAAgB,gBACd,MAC2E;CAC3E,MAAM,QAAQ,IAAI,OAAO,sCAAsC;CAC/D,MAAM,QAAQ,KAAK,MAAM,MAAM;AAC/B,KAAI,CAAC,QAAQ,GAAI,QAAO;CAExB,MAAM,QAAQ,MAAM;CACpB,MAAM,QACJ,EAAE;CAEJ,MAAM,QAAQ,MAAM,MAAM,gBAAgB;AAC1C,KAAI,MACF,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,IAAI,iBAAiB,MAAM,MAAM;EACvC,MAAM,IAAI,kBAAkB,MAAM,UAAU;EAC5C,MAAM,IAAI,iBAAiB,MAAM,OAAO;AACxC,MAAI,EACF,OAAM,KAAK;GACT,KAAK;GACL,SAAS,KAAK;GACd,MAAM,MAAM,UAAU,UAAU;GACjC,CAAC;;AAKR,QAAO,MAAM,SAAS,IAAI,QAAQ;;;;;;;AAQpC,SAAgB,kBACd,MAGY;CAEZ,MAAM,mBAAmB,KAAK,MAAM,kBAAkB;AACtD,KAAI,CAAC,oBAAoB,iBAAiB,UAAU,OAClD,QAAO;CAET,MAAM,iBACJ,iBAAiB,QAAQ,iBAAiB,GAAG,SAAS;CACxD,MAAM,kBAAkB,sBAAsB,MAAM,gBAAgB,KAAK,IAAI;AAE7E,KAAI,oBAAoB,GAAI,QAAO;CAEnC,MAAM,cAAc,KAAK,UAAU,iBAAiB,GAAG,gBAAgB;CAGvE,MAAM,YAAY,YAAY,MAAM,2BAA2B;AAC/D,KAAI,CAAC,YAAY,GAAI,QAAO;CAE5B,MAAM,OAAO,UAAU;AACvB,KAAI,SAAS,eAAe,SAAS,WAAY,QAAO;CAGxD,MAAM,UAAU,iBAAiB,aAAa,MAAM;AACpD,KAAI,QAEF,QAAO;EACL;EACA,KAAK;EACL,SAJkB,kBAAkB,aAAa,UAAU;EAK5D;CAIH,MAAM,gBAAgB,YAAY,MAChC,IAAI,OAAO,GAAG,KAAK,6BAA6B,CACjD;AAED,KAAI,CAAC,gBAAgB,GAAI,QAAO;CAEhC,MAAM,WAAW,cAAc;CAG/B,MAAM,MAAM,iBAAiB,UAAU,MAAM;AAC7C,KAAI,CAAC,IAAK,QAAO;AAIjB,QAAO;EACL;EACA;EACA,SALc,kBAAkB,UAAU,UAAU;EAMrD;;;;;;;;;AAUH,SAAgB,oBAAoB,MAGlC;CAEA,MAAM,gBAAgB,mBAAmB,KAAK,KAAK;CACnD,MAAM,cAAc,kBAAkB,KAAK,KAAK;CAGhD,MAAM,gBAAgB,2CAA2C,KAAK,KAAK;CAC3E,MAAM,cAAc,0CAA0C,KAAK,KAAK;AAExE,QAAO;EACL,YAAY,iBAAiB;EAC7B,UAAU,eAAe;EAC1B"}

package/dist/analysis/spec-scan.js

@@ -1,157 +0,0 @@
-import { findMatchingDelimiter, isStability, matchStringArrayField, matchStringField, matchVersionField } from "./utils/matchers.js";
-import { extractArrayConstants, resolveVariablesInBlock } from "./utils/variables.js";
-import { extractRefList, extractTestCoverage, extractTestRefs, extractTestTarget, parsePolicy } from "./spec-parsing-utils.js";
-
-//#region src/analysis/spec-scan.ts
-/**
-* Scan all specs from a single source file.
-*/
-function scanAllSpecsFromSource(code, filePath) {
-	const results = [];
-	const variables = extractArrayConstants(code);
-	const definitionRegex = /export\s+const\s+(\w+)\s*=\s*define(Command|Query|Event|Presentation|Capability|Policy|Type|Example|AppConfig|Integration|Workflow|TestSpec|Feature)\s*\(/g;
-	let match;
-	while ((match = definitionRegex.exec(code)) !== null) {
-		const start = match.index;
-		const end = findMatchingDelimiter(code, start + match[0].length - 1, "(", ")");
-		if (end === -1) continue;
-		let finalEnd = end;
-		if (code[finalEnd + 1] === ";") finalEnd++;
-		const resolvedBlock = resolveVariablesInBlock(code.substring(start, finalEnd + 1), variables);
-		const result = scanSpecSource(resolvedBlock, filePath);
-		if (result) results.push({
-			...result,
-			sourceBlock: resolvedBlock
-		});
-	}
-	if (results.length === 0 && filePath.includes(".spec.")) {
-		if (scanSpecSource(code, filePath).key !== "unknown") {
-			const result = scanSpecSource(resolveVariablesInBlock(code, variables), filePath);
-			results.push(result);
-		}
-	}
-	return results;
-}
-function inferSpecTypeFromCodeBlock(fileSourceCode) {
-	if (fileSourceCode.includes("defineCommand")) return {
-		specType: "operation",
-		kind: "command"
-	};
-	if (fileSourceCode.includes("defineQuery")) return {
-		specType: "operation",
-		kind: "query"
-	};
-	if (fileSourceCode.includes("defineEvent")) return {
-		specType: "event",
-		kind: "event"
-	};
-	if (fileSourceCode.includes("definePresentation")) return {
-		specType: "presentation",
-		kind: "presentation"
-	};
-	if (fileSourceCode.includes("definePolicy")) return {
-		specType: "policy",
-		kind: "policy"
-	};
-	if (fileSourceCode.includes("defineCapability")) return {
-		specType: "capability",
-		kind: "capability"
-	};
-	if (fileSourceCode.includes("defineExample")) return {
-		specType: "example",
-		kind: "example"
-	};
-	if (fileSourceCode.includes("defineAppConfig") && !fileSourceCode.includes("export const defineAppConfig")) return {
-		specType: "app-config",
-		kind: "app-config"
-	};
-	if (fileSourceCode.includes("defineIntegration")) return {
-		specType: "integration",
-		kind: "integration"
-	};
-	if (fileSourceCode.includes("defineWorkflow")) return {
-		specType: "workflow",
-		kind: "workflow"
-	};
-	if (fileSourceCode.includes("defineTestSpec")) return {
-		specType: "test-spec",
-		kind: "test-spec"
-	};
-	if (fileSourceCode.includes("defineFeature")) return {
-		specType: "feature",
-		kind: "feature"
-	};
-	return {
-		specType: "unknown",
-		kind: "unknown"
-	};
-}
-/**
-* Scan a single spec source string.
-*/
-function scanSpecSource(code, filePath) {
-	const key = (code.match(/key\s*:\s*['"]([^'"]+)['"]/) ?? code.match(/export\s+const\s+(\w+)\s*=/))?.[1] ?? "unknown";
-	const version = matchVersionField(code, "version");
-	const description = matchStringField(code, "description") ?? void 0;
-	const goal = matchStringField(code, "goal") ?? void 0;
-	const context = matchStringField(code, "context") ?? void 0;
-	const stabilityRaw = matchStringField(code, "stability");
-	const stability = isStability(stabilityRaw) ? stabilityRaw : void 0;
-	const owners = matchStringArrayField(code, "owners");
-	const tags = matchStringArrayField(code, "tags");
-	const inferredSpecType = inferSpecTypeFromCodeBlock(code);
-	const hasMeta = /meta\s*:\s*\{/.test(code);
-	const hasIo = /io\s*:\s*\{/.test(code);
-	const hasPolicy = /policy\s*:\s*\{/.test(code);
-	const hasPayload = /payload\s*:\s*\{/.test(code);
-	const hasContent = /content\s*:\s*\{/.test(code);
-	const hasDefinition = /definition\s*:\s*\{/.test(code);
-	const emittedEvents = extractRefList(code, "emits") ?? extractRefList(code, "emittedEvents");
-	const testRefs = extractTestRefs(code);
-	const policyRefs = hasPolicy ? parsePolicy(code) : void 0;
-	return {
-		filePath,
-		key,
-		version,
-		specType: inferredSpecType.specType,
-		kind: inferredSpecType.kind,
-		description,
-		goal,
-		context,
-		stability,
-		owners,
-		tags,
-		hasMeta,
-		hasIo,
-		hasPolicy,
-		hasPayload,
-		hasContent,
-		hasDefinition,
-		emittedEvents,
-		policyRefs,
-		testRefs,
-		testTarget: extractTestTarget(code),
-		testCoverage: extractTestCoverage(code),
-		sourceBlock: code
-	};
-}
-/**
-* Infer spec type from file path convention.
-*/
-function inferSpecTypeFromFilePath(filePath) {
-	if (filePath.includes(".contracts.") || /\/operations?\//.test(filePath)) return "operation";
-	if (filePath.includes(".event.") || /\/events?\//.test(filePath)) return "event";
-	if (filePath.includes(".presentation.") || /\/presentations?\//.test(filePath)) return "presentation";
-	if (filePath.includes(".policy.") || /\/policies?\//.test(filePath)) return "policy";
-	if (filePath.includes(".feature.") || /\/features?\//.test(filePath)) return "feature";
-	if (filePath.includes(".type.") || /\/types?\//.test(filePath)) return "type";
-	if (filePath.includes(".example.") || /\/examples?\//.test(filePath)) return "example";
-	if (filePath.includes(".app-config.")) return "app-config";
-	if (filePath.includes(".workflow.") || /\/workflows?\//.test(filePath)) return "workflow";
-	if (filePath.includes(".integration.") || /\/integrations?\//.test(filePath)) return "integration";
-	return "unknown";
-}
-
-//#endregion
-export { inferSpecTypeFromCodeBlock, inferSpecTypeFromFilePath, scanAllSpecsFromSource, scanSpecSource };
-//# sourceMappingURL=spec-scan.js.map

package/dist/analysis/spec-scan.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"spec-scan.js","names":[],"sources":["../../src/analysis/spec-scan.ts"],"sourcesContent":["/**\n * Spec scanning utilities.\n *\n * Scans source code to extract spec definitions and metadata without execution.\n */\n\nimport type {\n  AnalyzedOperationKind,\n  AnalyzedSpecType,\n  SpecScanResult,\n} from '../types/analysis-types';\nimport {\n  extractArrayConstants,\n  resolveVariablesInBlock,\n} from './utils/variables';\n\nimport {\n  findMatchingDelimiter,\n  isStability,\n  matchStringArrayField,\n  matchStringField,\n  matchVersionField,\n} from './utils/matchers';\n\nimport {\n  extractRefList,\n  extractTestCoverage,\n  extractTestRefs,\n  extractTestTarget,\n  parsePolicy,\n} from './spec-parsing-utils';\n\nexport { extractTestTarget, extractTestCoverage } from './spec-parsing-utils';\n\n/**\n * Scan all specs from a single source file.\n */\nexport function scanAllSpecsFromSource(\n  code: string,\n  filePath: string\n): SpecScanResult[] {\n  const results: SpecScanResult[] = [];\n\n  // Pre-scan for variables available in file scope\n  const variables = extractArrayConstants(code);\n\n  // Match export definitions: export const X = defineXXX calls\n  const definitionRegex =\n    /export\\s+const\\s+(\\w+)\\s*=\\s*define(Command|Query|Event|Presentation|Capability|Policy|Type|Example|AppConfig|Integration|Workflow|TestSpec|Feature)\\s*\\(/g;\n  let match;\n\n  while ((match = definitionRegex.exec(code)) !== null) {\n    const start = match.index;\n    const openParenIndex = start + match[0].length - 1;\n    const end = findMatchingDelimiter(code, openParenIndex, '(', ')');\n    if (end === -1) continue;\n\n    // Optional: include trailing semicolon\n    let finalEnd = end;\n    if (code[finalEnd + 1] === ';') {\n      finalEnd++;\n    }\n\n    const block = code.substring(start, finalEnd + 1);\n\n    // Resolve variables in the block\n    const resolvedBlock = resolveVariablesInBlock(block, variables);\n\n    const result = scanSpecSource(resolvedBlock, filePath);\n    if (result) {\n      results.push({\n        ...result,\n        sourceBlock: resolvedBlock, // Ensure the result has the resolved block\n      });\n    }\n  }\n\n  // Fallback: legacy file scan if no explicit exports found\n  if (results.length === 0 && filePath.includes('.spec.')) {\n    const result = scanSpecSource(code, filePath);\n    if (result.key !== 'unknown') {\n      // Try to resolve globally even for fallback (though scope is harder)\n      const resolvedBlock = resolveVariablesInBlock(code, variables);\n      const result = scanSpecSource(resolvedBlock, filePath);\n      results.push(result);\n    }\n  }\n\n  return results;\n}\n\nexport function inferSpecTypeFromCodeBlock(fileSourceCode: string): {\n  specType: AnalyzedSpecType;\n  kind: AnalyzedOperationKind;\n} {\n  if (fileSourceCode.includes('defineCommand')) {\n    return {\n      specType: 'operation',\n      kind: 'command',\n    };\n  }\n  if (fileSourceCode.includes('defineQuery')) {\n    return {\n      specType: 'operation',\n      kind: 'query',\n    };\n  }\n  if (fileSourceCode.includes('defineEvent')) {\n    return {\n      specType: 'event',\n      kind: 'event',\n    };\n  }\n  if (fileSourceCode.includes('definePresentation')) {\n    return {\n      specType: 'presentation',\n      kind: 'presentation',\n    };\n  }\n  if (fileSourceCode.includes('definePolicy')) {\n    return {\n      specType: 'policy',\n      kind: 'policy',\n    };\n  }\n  if (fileSourceCode.includes('defineCapability')) {\n    return {\n      specType: 'capability',\n      kind: 'capability',\n    };\n  }\n  if (fileSourceCode.includes('defineExample')) {\n    return {\n      specType: 'example',\n      kind: 'example',\n    };\n  }\n  if (\n    fileSourceCode.includes('defineAppConfig') &&\n    !fileSourceCode.includes('export const defineAppConfig')\n  ) {\n    return {\n      specType: 'app-config',\n      kind: 'app-config',\n    };\n  }\n  if (fileSourceCode.includes('defineIntegration')) {\n    return {\n      specType: 'integration',\n      kind: 'integration',\n    };\n  }\n  if (fileSourceCode.includes('defineWorkflow')) {\n    return {\n      specType: 'workflow',\n      kind: 'workflow',\n    };\n  }\n  if (fileSourceCode.includes('defineTestSpec')) {\n    return {\n      specType: 'test-spec',\n      kind: 'test-spec',\n    };\n  }\n\n  if (fileSourceCode.includes('defineFeature')) {\n    return {\n      specType: 'feature',\n      kind: 'feature',\n    };\n  }\n\n  return {\n    specType: 'unknown',\n    kind: 'unknown',\n  };\n}\n\n/**\n * Scan a single spec source string.\n */\nexport function scanSpecSource(code: string, filePath: string): SpecScanResult {\n  const keyMatch =\n    code.match(/key\\s*:\\s*['\"]([^'\"]+)['\"]/) ??\n    code.match(/export\\s+const\\s+(\\w+)\\s*=/);\n  const key = keyMatch?.[1] ?? 'unknown';\n\n  const version = matchVersionField(code, 'version');\n  const description = matchStringField(code, 'description') ?? undefined;\n  const goal = matchStringField(code, 'goal') ?? undefined;\n  const context = matchStringField(code, 'context') ?? undefined;\n  const stabilityRaw = matchStringField(code, 'stability');\n  const stability = isStability(stabilityRaw) ? stabilityRaw : undefined;\n  const owners = matchStringArrayField(code, 'owners');\n  const tags = matchStringArrayField(code, 'tags');\n\n  // Determine type\n  const inferredSpecType = inferSpecTypeFromCodeBlock(code);\n\n  // Check feature flags/sections\n  const hasMeta = /meta\\s*:\\s*\\{/.test(code);\n  const hasIo = /io\\s*:\\s*\\{/.test(code);\n  const hasPolicy = /policy\\s*:\\s*\\{/.test(code);\n  const hasPayload = /payload\\s*:\\s*\\{/.test(code);\n  const hasContent = /content\\s*:\\s*\\{/.test(code);\n  const hasDefinition = /definition\\s*:\\s*\\{/.test(code);\n\n  // References\n  const emittedEvents =\n    extractRefList(code, 'emits') ?? extractRefList(code, 'emittedEvents');\n  const testRefs = extractTestRefs(code);\n\n  const policyRefs = hasPolicy ? parsePolicy(code) : undefined;\n\n  return {\n    filePath,\n    key,\n    version,\n    specType: inferredSpecType.specType,\n    kind: inferredSpecType.kind,\n    description,\n    goal,\n    context,\n    stability,\n    owners,\n    tags,\n    hasMeta,\n    hasIo,\n    hasPolicy,\n    hasPayload,\n    hasContent,\n    hasDefinition,\n    emittedEvents,\n    policyRefs,\n    testRefs,\n    testTarget: extractTestTarget(code),\n    testCoverage: extractTestCoverage(code),\n    sourceBlock: code,\n  };\n}\n\n/**\n * Infer spec type from file path convention.\n */\nexport function inferSpecTypeFromFilePath(\n  filePath: string\n): SpecScanResult['specType'] | 'feature' | 'unknown' {\n  if (filePath.includes('.contracts.') || /\\/operations?\\//.test(filePath)) {\n    return 'operation';\n  }\n  if (filePath.includes('.event.') || /\\/events?\\//.test(filePath)) {\n    return 'event';\n  }\n  if (\n    filePath.includes('.presentation.') ||\n    /\\/presentations?\\//.test(filePath)\n  ) {\n    return 'presentation';\n  }\n  if (filePath.includes('.policy.') || /\\/policies?\\//.test(filePath)) {\n    return 'policy';\n  }\n  if (filePath.includes('.feature.') || /\\/features?\\//.test(filePath)) {\n    return 'feature';\n  }\n  if (filePath.includes('.type.') || /\\/types?\\//.test(filePath)) {\n    return 'type';\n  }\n  if (filePath.includes('.example.') || /\\/examples?\\//.test(filePath)) {\n    return 'example';\n  }\n  if (filePath.includes('.app-config.')) {\n    return 'app-config';\n  }\n  if (filePath.includes('.workflow.') || /\\/workflows?\\//.test(filePath)) {\n    return 'workflow';\n  }\n  if (\n    filePath.includes('.integration.') ||\n    /\\/integrations?\\//.test(filePath)\n  ) {\n    return 'integration';\n  }\n  return 'unknown';\n}\n"],"mappings":"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"}

package/dist/analysis/utils/matchers.js

@@ -1,77 +0,0 @@
-//#region src/analysis/utils/matchers.ts
-/**
-* Escape regex special characters.
-*/
-function escapeRegex(value) {
-	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-/**
-* Match a string field in source code.
-*/
-function matchStringField(code, field) {
-	const regex = new RegExp(`${escapeRegex(field)}\\s*:\\s*['"]([^'"]+)['"]`);
-	return code.match(regex)?.[1] ?? null;
-}
-/**
-* Match a string field within a limited scope.
-*/
-function matchStringFieldIn(code, field) {
-	return matchStringField(code, field);
-}
-/**
-* Match a version field which can be a string or number.
-*/
-function matchVersionField(code, field) {
-	const regex = new RegExp(`${escapeRegex(field)}\\s*:\\s*(?:['"]([^'"]+)['"]|(\\d+(?:\\.\\d+)*))`);
-	const match = code.match(regex);
-	if (match?.[1]) return match[1];
-	if (match?.[2]) return match[2];
-}
-/**
-* Match a string array field in source code.
-*/
-function matchStringArrayField(code, field) {
-	const regex = 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";
-}
-/**
-* Find matching closing delimiter for an opening delimiter.
-* Returns the index of the closing delimiter or -1 if not found.
-*/
-function findMatchingDelimiter(code, startIndex, openChar, closeChar) {
-	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 === openChar) depth++;
-		else if (char === closeChar) {
-			depth--;
-			if (depth === 0) return i;
-		}
-	}
-	return -1;
-}
-
-//#endregion
-export { escapeRegex, findMatchingDelimiter, isStability, matchStringArrayField, matchStringField, matchStringFieldIn, matchVersionField };
-//# sourceMappingURL=matchers.js.map