@contractspec/module.workspace 0.0.0-canary-20260113162409

package/dist/analysis/feature-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-extractor.js","names":[],"sources":["../../src/analysis/feature-extractor.ts"],"sourcesContent":["import {\n  Project,\n  Node,\n  SyntaxKind,\n  type ObjectLiteralExpression,\n} from 'ts-morph';\nimport type { RefInfo } from '../types/analysis-types';\n\n/**\n * Extract specs referenced in a feature.\n * Uses ts-morph for robust parsing of object structures.\n */\nexport function extractFeatureRefs(code: string): {\n  operations: RefInfo[];\n  events: RefInfo[];\n  presentations: RefInfo[];\n  experiments: RefInfo[];\n  capabilities: { provides: RefInfo[]; requires: RefInfo[] };\n  opToPresentationLinks: { op: RefInfo; pres: RefInfo }[];\n  presentationsTargets: {\n    key: string;\n    version: string;\n    targets: Record<string, unknown>[];\n  }[];\n} {\n  const result = {\n    operations: [] as RefInfo[],\n    events: [] as RefInfo[],\n    presentations: [] as RefInfo[],\n    experiments: [] as RefInfo[],\n    capabilities: {\n      provides: [] as RefInfo[],\n      requires: [] as RefInfo[],\n    },\n    opToPresentationLinks: [] as { op: RefInfo; pres: RefInfo }[],\n    presentationsTargets: [] as {\n      key: string;\n      version: string;\n      targets: Record<string, unknown>[];\n    }[],\n  };\n\n  const project = new Project({ useInMemoryFileSystem: true });\n  const sourceFile = project.createSourceFile('feature.ts', code);\n\n  // Helper to extract ref array from an object property\n  const extractRefs = (\n    obj: ObjectLiteralExpression,\n    propName: string,\n    allowKeyOnly = false\n  ): RefInfo[] => {\n    const refs: RefInfo[] = [];\n    const prop = obj.getProperty(propName);\n\n    if (prop && Node.isPropertyAssignment(prop)) {\n      const init = prop.getInitializer();\n      if (init && Node.isArrayLiteralExpression(init)) {\n        for (const elem of init.getElements()) {\n          if (Node.isObjectLiteralExpression(elem)) {\n            const keyText = getTextFromProp(elem, 'key');\n            const verText = getTextFromProp(elem, 'version');\n\n            if (keyText && verText) {\n              refs.push({ key: keyText, version: verText });\n            } else if (keyText && allowKeyOnly) {\n              refs.push({ key: keyText, version: '1.0.0' });\n            }\n          }\n        }\n      }\n    }\n    return refs;\n  };\n\n  // Find defineFeature call\n  const callExpressions = sourceFile.getDescendantsOfKind(\n    SyntaxKind.CallExpression\n  );\n\n  for (const call of callExpressions) {\n    if (\n      ['defineFeature', 'defineAppConfig', 'defineAppBlueprint'].includes(\n        call.getExpression().getText()\n      )\n    ) {\n      const args = call.getArguments();\n      if (args.length > 0 && Node.isObjectLiteralExpression(args[0])) {\n        const obj = args[0];\n\n        // Extract direct lists\n        result.operations.push(...extractRefs(obj, 'operations'));\n        result.events.push(...extractRefs(obj, 'events'));\n        result.presentations.push(...extractRefs(obj, 'presentations'));\n        result.experiments.push(...extractRefs(obj, 'experiments'));\n\n        // Capabilities\n        const capsProp = obj.getProperty('capabilities');\n        if (capsProp && Node.isPropertyAssignment(capsProp)) {\n          const capsObj = capsProp.getInitializer();\n          if (capsObj && Node.isObjectLiteralExpression(capsObj)) {\n            result.capabilities.provides.push(\n              ...extractRefs(capsObj, 'provides')\n            );\n            result.capabilities.requires.push(\n              ...extractRefs(capsObj, 'requires', true)\n            );\n          }\n        }\n\n        // Op to Presentation Links\n        // explicit 'opToPresentation' field\n        const linksProp = obj.getProperty('opToPresentation');\n        if (linksProp && Node.isPropertyAssignment(linksProp)) {\n          const linksArr = linksProp.getInitializer();\n          if (linksArr && Node.isArrayLiteralExpression(linksArr)) {\n            linksArr.getElements().forEach((link) => {\n              if (Node.isObjectLiteralExpression(link)) {\n                const opProp = link.getProperty('op');\n                const presProp = link.getProperty('pres');\n\n                let opRef: RefInfo | undefined;\n                let presRef: RefInfo | undefined;\n\n                if (opProp && Node.isPropertyAssignment(opProp)) {\n                  const val = opProp.getInitializer();\n                  if (val && Node.isObjectLiteralExpression(val)) {\n                    const key = getTextFromProp(val, 'key');\n                    const version = getTextFromProp(val, 'version');\n                    if (key && version) opRef = { key, version };\n                  }\n                }\n                if (presProp && Node.isPropertyAssignment(presProp)) {\n                  const val = presProp.getInitializer();\n                  if (val && Node.isObjectLiteralExpression(val)) {\n                    const key = getTextFromProp(val, 'key');\n                    const version = getTextFromProp(val, 'version');\n                    if (key && version) presRef = { key, version };\n                  }\n                }\n\n                if (opRef && presRef) {\n                  result.opToPresentationLinks.push({\n                    op: opRef,\n                    pres: presRef,\n                  });\n                }\n              }\n            });\n          }\n        }\n\n        // Also support 'interactions' style for forward compatibility\n        extractLinks(obj, result.opToPresentationLinks);\n\n        // Presentation Targets\n        // explicit 'presentationsTargets' field\n        const targetsProp = obj.getProperty('presentationsTargets');\n        if (targetsProp && Node.isPropertyAssignment(targetsProp)) {\n          const targetsArr = targetsProp.getInitializer();\n          if (targetsArr && Node.isArrayLiteralExpression(targetsArr)) {\n            targetsArr.getElements().forEach((targetBlock) => {\n              if (Node.isObjectLiteralExpression(targetBlock)) {\n                const key = getTextFromProp(targetBlock, 'key');\n                const version = getTextFromProp(targetBlock, 'version');\n                const targetsList = getTargetsList(targetBlock, 'targets');\n\n                if (key && version && targetsList) {\n                  result.presentationsTargets.push({\n                    key,\n                    version,\n                    targets: targetsList as Record<string, unknown>[],\n                  });\n                }\n              }\n            });\n          }\n        }\n\n        // Also support inline targets in presentations list\n        extractPresentationTargets(obj, result.presentationsTargets);\n      }\n    }\n  }\n\n  return result;\n}\n\nfunction extractLinks(\n  obj: ObjectLiteralExpression,\n  opToPresentationLinks: { op: RefInfo; pres: RefInfo }[]\n): void {\n  const interactionsProp = obj.getProperty('interactions');\n  if (interactionsProp && Node.isPropertyAssignment(interactionsProp)) {\n    const interactionsArr = interactionsProp.getInitializer();\n    if (interactionsArr && Node.isArrayLiteralExpression(interactionsArr)) {\n      interactionsArr.getElements().forEach((interaction) => {\n        if (Node.isObjectLiteralExpression(interaction)) {\n          // Check: trigger: { type: 'presentation', presentation: { key, version } }\n          // Check: action: { type: 'operation', operation: { key, version } }\n\n          const triggerProp = interaction.getProperty('trigger');\n          const triggerObj =\n            triggerProp &&\n            Node.isPropertyAssignment(triggerProp) &&\n            triggerProp.getInitializer();\n\n          const actionProp = interaction.getProperty('action');\n          const actionObj =\n            actionProp &&\n            Node.isPropertyAssignment(actionProp) &&\n            actionProp.getInitializer();\n\n          if (\n            triggerObj &&\n            Node.isObjectLiteralExpression(triggerObj) &&\n            actionObj &&\n            Node.isObjectLiteralExpression(actionObj)\n          ) {\n            const triggerType = getTextFromProp(triggerObj, 'type');\n            const actionType = getTextFromProp(actionObj, 'type');\n\n            if (triggerType === 'presentation' && actionType === 'operation') {\n              const presRef = extractNestedRef(triggerObj, 'presentation');\n              const opRef = extractNestedRef(actionObj, 'operation');\n\n              if (presRef && opRef) {\n                opToPresentationLinks.push({ op: opRef, pres: presRef });\n              }\n            }\n          }\n        }\n      });\n    }\n  }\n}\n\nfunction extractNestedRef(\n  obj: ObjectLiteralExpression,\n  propName: string\n): RefInfo | undefined {\n  const prop = obj.getProperty(propName);\n  if (prop && Node.isPropertyAssignment(prop)) {\n    const val = prop.getInitializer();\n    if (val && Node.isObjectLiteralExpression(val)) {\n      const key = getTextFromProp(val, 'key');\n      const version = getTextFromProp(val, 'version');\n      if (key && version) return { key, version };\n    }\n  }\n  return undefined;\n}\n\nfunction extractPresentationTargets(\n  obj: ObjectLiteralExpression,\n  presentationsTargets: {\n    key: string;\n    version: string;\n    targets: Record<string, unknown>[];\n  }[]\n): void {\n  const presentationsProp = obj.getProperty('presentations');\n  if (presentationsProp && Node.isPropertyAssignment(presentationsProp)) {\n    const presentationsArr = presentationsProp.getInitializer();\n    if (presentationsArr && Node.isArrayLiteralExpression(presentationsArr)) {\n      for (const elem of presentationsArr.getElements()) {\n        if (Node.isObjectLiteralExpression(elem)) {\n          const keyText = getTextFromProp(elem, 'key');\n          const verText = getTextFromProp(elem, 'version');\n\n          // Use targets extraction from shared utility or local helper\n          const targetsList = getTargetsList(elem, 'targets');\n\n          if (keyText && verText && targetsList) {\n            presentationsTargets.push({\n              key: keyText,\n              version: verText,\n              targets: targetsList as Record<string, unknown>[],\n            });\n          }\n        }\n      }\n    }\n  }\n}\n\nfunction getTextFromProp(\n  obj: ObjectLiteralExpression,\n  propName: string\n): string | undefined {\n  const prop = obj.getProperty(propName);\n  if (prop && Node.isPropertyAssignment(prop)) {\n    const init = prop.getInitializer();\n    if (init && Node.isStringLiteral(init)) {\n      return init.getLiteralText();\n    }\n  }\n  return undefined;\n}\n\nfunction getTargetsList(\n  obj: ObjectLiteralExpression,\n  propName: string\n): unknown[] | undefined {\n  const prop = obj.getProperty(propName);\n  if (prop && Node.isPropertyAssignment(prop)) {\n    const init = prop.getInitializer();\n    if (init && Node.isArrayLiteralExpression(init)) {\n      // Just extract strings for now, or raw text if they are identifiers/enums\n      return init.getElements().map((e) => {\n        if (Node.isStringLiteral(e)) return e.getLiteralText();\n        // Fallback: create a dummy record to match the Expected type in the rest of the app\n        return { target: e.getText() } as unknown;\n      });\n    }\n  }\n  return undefined;\n}\n"],"mappings":"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"}

package/dist/analysis/feature-scan.d.ts

@@ -0,0 +1,15 @@
+import { FeatureScanResult } from "../types/analysis-types.js";
+
+//#region src/analysis/feature-scan.d.ts
+
+/**
+ * Check if a file is a feature file based on naming conventions.
+ */
+declare function isFeatureFile(filePath: string): boolean;
+/**
+ * Scan a feature source file to extract metadata.
+ */
+declare function scanFeatureSource(code: string, filePath: string): FeatureScanResult;
+//#endregion
+export { isFeatureFile, scanFeatureSource };
+//# sourceMappingURL=feature-scan.d.ts.map

package/dist/analysis/feature-scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-scan.d.ts","names":[],"sources":["../../src/analysis/feature-scan.ts"],"sourcesContent":[],"mappings":";;;;;;AAWA;AAOgB,iBAPA,aAAA,CAUb,QAAA,EAAA,MAAA,CAAiB,EAAA,OAAA;;;;iBAHJ,iBAAA,kCAGb"}

package/dist/analysis/feature-scan.js

@@ -0,0 +1,56 @@
+import { isStability, matchStringArrayField, matchStringField } from "./utils/matchers.js";
+import { extractFeatureRefs } from "./feature-extractor.js";
+
+//#region src/analysis/feature-scan.ts
+/**
+* Check if a file is a feature file based on naming conventions.
+*/
+function isFeatureFile(filePath) {
+	return filePath.includes(".feature.") && filePath.endsWith(".ts");
+}
+/**
+* Scan a feature source file to extract metadata.
+*/
+function scanFeatureSource(code, filePath) {
+	const key = matchStringField(code, "key") ?? extractKeyFromFilePath(filePath);
+	const version = matchStringField(code, "version") ?? "1.0.0";
+	const title = matchStringField(code, "title") ?? void 0;
+	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 refs = extractFeatureRefs(code);
+	return {
+		filePath,
+		key,
+		version,
+		title,
+		description,
+		goal,
+		context,
+		stability,
+		owners,
+		tags,
+		operations: refs.operations,
+		events: refs.events,
+		presentations: refs.presentations,
+		experiments: refs.experiments,
+		capabilities: refs.capabilities,
+		opToPresentationLinks: refs.opToPresentationLinks,
+		presentationsTargets: refs.presentationsTargets,
+		sourceBlock: code
+	};
+}
+/**
+* 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, "-");
+}
+
+//#endregion
+export { isFeatureFile, scanFeatureSource };
+//# sourceMappingURL=feature-scan.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feature-scan.js","names":[],"sources":["../../src/analysis/feature-scan.ts"],"sourcesContent":["import {\n  isStability,\n  matchStringArrayField,\n  matchStringField,\n} from './utils/matchers';\nimport type { FeatureScanResult } from '../types/analysis-types';\nimport { extractFeatureRefs } from './feature-extractor';\n\n/**\n * Check if a file is a feature file based on naming conventions.\n */\nexport function isFeatureFile(filePath: string): boolean {\n  return filePath.includes('.feature.') && filePath.endsWith('.ts');\n}\n\n/**\n * Scan a feature source file to extract metadata.\n */\nexport function scanFeatureSource(\n  code: string,\n  filePath: string\n): FeatureScanResult {\n  const key = matchStringField(code, 'key') ?? extractKeyFromFilePath(filePath);\n  const versionRaw = matchStringField(code, 'version');\n  const version = versionRaw ?? '1.0.0'; // Default version\n  const title = matchStringField(code, 'title') ?? undefined;\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  // Parse structure using ts-morph to extract nested refs\n  const refs = extractFeatureRefs(code);\n\n  return {\n    filePath,\n    key,\n    version,\n    title,\n    description,\n    goal,\n    context,\n    stability,\n    owners,\n    tags,\n    operations: refs.operations,\n    events: refs.events,\n    presentations: refs.presentations,\n    experiments: refs.experiments,\n    capabilities: refs.capabilities,\n    opToPresentationLinks: refs.opToPresentationLinks,\n    presentationsTargets: refs.presentationsTargets,\n    sourceBlock: code,\n  };\n}\n\n/**\n * Extract key from file path as fallback.\n */\nfunction extractKeyFromFilePath(filePath: string): string {\n  const fileName = filePath.split('/').pop() ?? filePath;\n  return fileName\n    .replace(/\\.feature\\.[jt]s$/, '')\n    .replace(/[^a-zA-Z0-9-]/g, '-');\n}\n"],"mappings":";;;;;;;AAWA,SAAgB,cAAc,UAA2B;AACvD,QAAO,SAAS,SAAS,YAAY,IAAI,SAAS,SAAS,MAAM;;;;;AAMnE,SAAgB,kBACd,MACA,UACmB;CACnB,MAAM,MAAM,iBAAiB,MAAM,MAAM,IAAI,uBAAuB,SAAS;CAE7E,MAAM,UADa,iBAAiB,MAAM,UAAU,IACtB;CAC9B,MAAM,QAAQ,iBAAiB,MAAM,QAAQ,IAAI;CACjD,MAAM,cAAc,iBAAiB,MAAM,cAAc,IAAI;CAC7D,MAAM,OAAO,iBAAiB,MAAM,OAAO,IAAI;CAC/C,MAAM,UAAU,iBAAiB,MAAM,UAAU,IAAI;CACrD,MAAM,eAAe,iBAAiB,MAAM,YAAY;CACxD,MAAM,YAAY,YAAY,aAAa,GAAG,eAAe;CAC7D,MAAM,SAAS,sBAAsB,MAAM,SAAS;CACpD,MAAM,OAAO,sBAAsB,MAAM,OAAO;CAGhD,MAAM,OAAO,mBAAmB,KAAK;AAErC,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,YAAY,KAAK;EACjB,QAAQ,KAAK;EACb,eAAe,KAAK;EACpB,aAAa,KAAK;EAClB,cAAc,KAAK;EACnB,uBAAuB,KAAK;EAC5B,sBAAsB,KAAK;EAC3B,aAAa;EACd;;;;;AAMH,SAAS,uBAAuB,UAA0B;AAExD,SADiB,SAAS,MAAM,IAAI,CAAC,KAAK,IAAI,UAE3C,QAAQ,qBAAqB,GAAG,CAChC,QAAQ,kBAAkB,IAAI"}

package/dist/analysis/grouping.d.ts

@@ -0,0 +1,79 @@
+import { Stability } from "../types/spec-types.js";
+import { FeatureScanResult, SpecScanResult } from "../types/analysis-types.js";
+
+//#region src/analysis/grouping.d.ts
+
+/**
+ * Filter criteria for spec scan results.
+ */
+interface SpecFilter {
+  /** Filter by tags (item must have at least one matching tag) */
+  tags?: string[];
+  /** Filter by owners (item must have at least one matching owner) */
+  owners?: string[];
+  /** Filter by stability levels */
+  stability?: Stability[];
+  /** Filter by spec type */
+  specType?: SpecScanResult['specType'][];
+  /** Filter by name pattern (glob) */
+  namePattern?: string;
+}
+/**
+ * Grouping key function type.
+ */
+type GroupKeyFn<T> = (item: T) => string;
+/**
+ * Grouped items result.
+ */
+interface GroupedItems<T> {
+  key: string;
+  items: T[];
+}
+/**
+ * Pre-built grouping strategies for spec scan results.
+ */
+declare const SpecGroupingStrategies: {
+  /** Group by first tag. */
+  byTag: (item: SpecScanResult) => string;
+  /** Group by first owner. */
+  byOwner: (item: SpecScanResult) => string;
+  /** Group by domain (first segment of name). */
+  byDomain: (item: SpecScanResult) => string;
+  /** Group by stability. */
+  byStability: (item: SpecScanResult) => string;
+  /** Group by spec type. */
+  bySpecType: (item: SpecScanResult) => string;
+  /** Group by file directory. */
+  byDirectory: (item: SpecScanResult) => string;
+};
+/**
+ * Filter specs by criteria.
+ */
+declare function filterSpecs(specs: SpecScanResult[], filter: SpecFilter): SpecScanResult[];
+/**
+ * Group specs by key function.
+ */
+declare function groupSpecs<T>(items: T[], keyFn: GroupKeyFn<T>): Map<string, T[]>;
+/**
+ * Group specs and return as array.
+ */
+declare function groupSpecsToArray<T>(items: T[], keyFn: GroupKeyFn<T>): GroupedItems<T>[];
+/**
+ * Get unique tags from spec results.
+ */
+declare function getUniqueSpecTags(specs: SpecScanResult[]): string[];
+/**
+ * Get unique owners from spec results.
+ */
+declare function getUniqueSpecOwners(specs: SpecScanResult[]): string[];
+/**
+ * Get unique domains from spec results.
+ */
+declare function getUniqueSpecDomains(specs: SpecScanResult[]): string[];
+/**
+ * Filter features by criteria.
+ */
+declare function filterFeatures(features: FeatureScanResult[], filter: SpecFilter): FeatureScanResult[];
+//#endregion
+export { GroupKeyFn, GroupedItems, SpecFilter, SpecGroupingStrategies, filterFeatures, filterSpecs, getUniqueSpecDomains, getUniqueSpecOwners, getUniqueSpecTags, groupSpecs, groupSpecsToArray };
+//# sourceMappingURL=grouping.d.ts.map

package/dist/analysis/grouping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grouping.d.ts","names":[],"sources":["../../src/analysis/grouping.ts"],"sourcesContent":[],"mappings":";;;;;AAmCA;AAQA;;AAKkB,UAlCD,UAAA,CAkCC;EAGC;EASG,IAAA,CAAA,EAAA,MAAA,EAAA;EAGD;EAGC,MAAA,CAAA,EAAA,MAAA,EAAA;EAAc;EAUpB,SAAA,CAAA,EAxDF,SAwDa,EAAA;EAClB;EACC,QAAA,CAAA,EAxDG,cAwDH,CAAA,UAAA,CAAA,EAAA;EACP;EAAc,WAAA,CAAA,EAAA,MAAA;AAiDjB;;;;AAGe,KArGH,UAqGG,CAAA,CAAA,CAAA,GAAA,CAAA,IAAA,EArGoB,CAqGpB,EAAA,GAAA,MAAA;;;AAmBf;AACS,UApHQ,YAoHR,CAAA,CAAA,CAAA,CAAA;EACW,GAAA,EAAA,MAAA;EAAX,KAAA,EAnHA,CAmHA,EAAA;;;;AAWT;AAagB,cArIH,sBAqI8B,EAAA;EAa3B;EAWA,KAAA,EAAA,CAAA,IAAA,EA3JA,cA2Jc,EAAA,GAAA,MAAA;EAClB;EACF,OAAA,EAAA,CAAA,IAAA,EA1JQ,cA0JR,EAAA,GAAA,MAAA;EACP;EAAiB,QAAA,EAAA,CAAA,IAAA,EAxJD,cAwJC,EAAA,GAAA,MAAA;;sBA/IE;;qBAGD;;sBAGC;;;;;iBAUN,WAAA,QACP,0BACC,aACP;;;;iBAiDa,qBACP,YACA,WAAW,KACjB,YAAY;;;;iBAmBC,4BACP,YACA,WAAW,KACjB,aAAa;;;;iBAUA,iBAAA,QAAyB;;;;iBAazB,mBAAA,QAA2B;;;;iBAa3B,oBAAA,QAA4B;;;;iBAW5B,cAAA,WACJ,6BACF,aACP"}

package/dist/analysis/grouping.js

@@ -0,0 +1,115 @@
+//#region src/analysis/grouping.ts
+/**
+* Pre-built grouping strategies for spec scan results.
+*/
+const SpecGroupingStrategies = {
+	byTag: (item) => item.tags?.[0] ?? "untagged",
+	byOwner: (item) => item.owners?.[0] ?? "unowned",
+	byDomain: (item) => {
+		const key = item.key ?? "";
+		if (key.includes(".")) return key.split(".")[0] ?? "default";
+		return "default";
+	},
+	byStability: (item) => item.stability ?? "stable",
+	bySpecType: (item) => item.specType,
+	byDirectory: (item) => {
+		return item.filePath.split("/").slice(0, -1).join("/") || ".";
+	}
+};
+/**
+* Filter specs by criteria.
+*/
+function filterSpecs(specs, filter) {
+	return specs.filter((spec) => {
+		if (filter.tags?.length) {
+			if (!filter.tags.some((tag) => spec.tags?.includes(tag))) return false;
+		}
+		if (filter.owners?.length) {
+			if (!filter.owners.some((owner) => spec.owners?.includes(owner))) return false;
+		}
+		if (filter.stability?.length) {
+			if (!filter.stability.includes(spec.stability ?? "stable")) return false;
+		}
+		if (filter.specType?.length) {
+			if (!filter.specType.includes(spec.specType)) return false;
+		}
+		if (filter.namePattern) {
+			const key = spec.key ?? "";
+			const pattern = filter.namePattern.replace(/\*/g, ".*").replace(/\?/g, ".");
+			if (!new RegExp(`^${pattern}$`, "i").test(key)) return false;
+		}
+		return true;
+	});
+}
+/**
+* Group specs by key function.
+*/
+function groupSpecs(items, keyFn) {
+	const groups = /* @__PURE__ */ new Map();
+	for (const item of items) {
+		const key = keyFn(item);
+		const existing = groups.get(key);
+		if (existing) existing.push(item);
+		else groups.set(key, [item]);
+	}
+	return groups;
+}
+/**
+* Group specs and return as array.
+*/
+function groupSpecsToArray(items, keyFn) {
+	const map = groupSpecs(items, keyFn);
+	return Array.from(map.entries()).map(([key, items$1]) => ({
+		key,
+		items: items$1
+	})).sort((a, b) => a.key.localeCompare(b.key));
+}
+/**
+* Get unique tags from spec results.
+*/
+function getUniqueSpecTags(specs) {
+	const tags = /* @__PURE__ */ new Set();
+	for (const spec of specs) for (const tag of spec.tags ?? []) tags.add(tag);
+	return Array.from(tags).sort();
+}
+/**
+* Get unique owners from spec results.
+*/
+function getUniqueSpecOwners(specs) {
+	const owners = /* @__PURE__ */ new Set();
+	for (const spec of specs) for (const owner of spec.owners ?? []) owners.add(owner);
+	return Array.from(owners).sort();
+}
+/**
+* Get unique domains from spec results.
+*/
+function getUniqueSpecDomains(specs) {
+	const domains = /* @__PURE__ */ new Set();
+	for (const spec of specs) domains.add(SpecGroupingStrategies.byDomain(spec));
+	return Array.from(domains).sort();
+}
+/**
+* Filter features by criteria.
+*/
+function filterFeatures(features, filter) {
+	return features.filter((feature) => {
+		if (filter.tags?.length) {
+			if (!filter.tags.some((tag) => feature.tags?.includes(tag))) return false;
+		}
+		if (filter.owners?.length) {
+			if (!filter.owners.some((owner) => feature.owners?.includes(owner))) return false;
+		}
+		if (filter.stability?.length) {
+			if (!filter.stability.includes(feature.stability ?? "stable")) return false;
+		}
+		if (filter.namePattern) {
+			const pattern = filter.namePattern.replace(/\*/g, ".*").replace(/\?/g, ".");
+			if (!new RegExp(`^${pattern}$`, "i").test(feature.key)) return false;
+		}
+		return true;
+	});
+}
+
+//#endregion
+export { SpecGroupingStrategies, filterFeatures, filterSpecs, getUniqueSpecDomains, getUniqueSpecOwners, getUniqueSpecTags, groupSpecs, groupSpecsToArray };
+//# sourceMappingURL=grouping.js.map

package/dist/analysis/grouping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grouping.js","names":["items"],"sources":["../../src/analysis/grouping.ts"],"sourcesContent":["/**\n * Grouping and filtering utilities for ContractSpec workspace analysis.\n * Provides services to filter and group scan results.\n */\n\nimport type {\n  FeatureScanResult,\n  SpecScanResult,\n} from '../types/analysis-types';\nimport type { Stability } from '../types/spec-types';\n\n/**\n * Filter criteria for spec scan results.\n */\nexport interface SpecFilter {\n  /** Filter by tags (item must have at least one matching tag) */\n  tags?: string[];\n  /** Filter by owners (item must have at least one matching owner) */\n  owners?: string[];\n  /** Filter by stability levels */\n  stability?: Stability[];\n  /** Filter by spec type */\n  specType?: SpecScanResult['specType'][];\n  /** Filter by name pattern (glob) */\n  namePattern?: string;\n}\n\n/**\n * Grouping key function type.\n */\nexport type GroupKeyFn<T> = (item: T) => string;\n\n/**\n * Grouped items result.\n */\nexport interface GroupedItems<T> {\n  key: string;\n  items: T[];\n}\n\n/**\n * Pre-built grouping strategies for spec scan results.\n */\nexport const SpecGroupingStrategies = {\n  /** Group by first tag. */\n  byTag: (item: SpecScanResult): string => item.tags?.[0] ?? 'untagged',\n\n  /** Group by first owner. */\n  byOwner: (item: SpecScanResult): string => item.owners?.[0] ?? 'unowned',\n\n  /** Group by domain (first segment of name). */\n  byDomain: (item: SpecScanResult): string => {\n    const key = item.key ?? '';\n    if (key.includes('.')) {\n      return key.split('.')[0] ?? 'default';\n    }\n    return 'default';\n  },\n\n  /** Group by stability. */\n  byStability: (item: SpecScanResult): string => item.stability ?? 'stable',\n\n  /** Group by spec type. */\n  bySpecType: (item: SpecScanResult): string => item.specType,\n\n  /** Group by file directory. */\n  byDirectory: (item: SpecScanResult): string => {\n    const parts = item.filePath.split('/');\n    // Return parent directory\n    return parts.slice(0, -1).join('/') || '.';\n  },\n};\n\n/**\n * Filter specs by criteria.\n */\nexport function filterSpecs(\n  specs: SpecScanResult[],\n  filter: SpecFilter\n): SpecScanResult[] {\n  return specs.filter((spec) => {\n    // Filter by tags\n    if (filter.tags?.length) {\n      const hasMatchingTag = filter.tags.some((tag) =>\n        spec.tags?.includes(tag)\n      );\n      if (!hasMatchingTag) return false;\n    }\n\n    // Filter by owners\n    if (filter.owners?.length) {\n      const hasMatchingOwner = filter.owners.some((owner) =>\n        spec.owners?.includes(owner)\n      );\n      if (!hasMatchingOwner) return false;\n    }\n\n    // Filter by stability\n    if (filter.stability?.length) {\n      if (!filter.stability.includes(spec.stability ?? 'stable')) {\n        return false;\n      }\n    }\n\n    // Filter by spec type\n    if (filter.specType?.length) {\n      if (!filter.specType.includes(spec.specType)) {\n        return false;\n      }\n    }\n\n    // Filter by name pattern\n    if (filter.namePattern) {\n      const key = spec.key ?? '';\n      const pattern = filter.namePattern\n        .replace(/\\*/g, '.*')\n        .replace(/\\?/g, '.');\n      const regex = new RegExp(`^${pattern}$`, 'i');\n      if (!regex.test(key)) return false;\n    }\n\n    return true;\n  });\n}\n\n/**\n * Group specs by key function.\n */\nexport function groupSpecs<T>(\n  items: T[],\n  keyFn: GroupKeyFn<T>\n): Map<string, T[]> {\n  const groups = new Map<string, T[]>();\n\n  for (const item of items) {\n    const key = keyFn(item);\n    const existing = groups.get(key);\n    if (existing) {\n      existing.push(item);\n    } else {\n      groups.set(key, [item]);\n    }\n  }\n\n  return groups;\n}\n\n/**\n * Group specs and return as array.\n */\nexport function groupSpecsToArray<T>(\n  items: T[],\n  keyFn: GroupKeyFn<T>\n): GroupedItems<T>[] {\n  const map = groupSpecs(items, keyFn);\n  return Array.from(map.entries())\n    .map(([key, items]) => ({ key, items }))\n    .sort((a, b) => a.key.localeCompare(b.key));\n}\n\n/**\n * Get unique tags from spec results.\n */\nexport function getUniqueSpecTags(specs: SpecScanResult[]): string[] {\n  const tags = new Set<string>();\n  for (const spec of specs) {\n    for (const tag of spec.tags ?? []) {\n      tags.add(tag);\n    }\n  }\n  return Array.from(tags).sort();\n}\n\n/**\n * Get unique owners from spec results.\n */\nexport function getUniqueSpecOwners(specs: SpecScanResult[]): string[] {\n  const owners = new Set<string>();\n  for (const spec of specs) {\n    for (const owner of spec.owners ?? []) {\n      owners.add(owner);\n    }\n  }\n  return Array.from(owners).sort();\n}\n\n/**\n * Get unique domains from spec results.\n */\nexport function getUniqueSpecDomains(specs: SpecScanResult[]): string[] {\n  const domains = new Set<string>();\n  for (const spec of specs) {\n    domains.add(SpecGroupingStrategies.byDomain(spec));\n  }\n  return Array.from(domains).sort();\n}\n\n/**\n * Filter features by criteria.\n */\nexport function filterFeatures(\n  features: FeatureScanResult[],\n  filter: SpecFilter\n): FeatureScanResult[] {\n  return features.filter((feature) => {\n    // Filter by tags\n    if (filter.tags?.length) {\n      const hasMatchingTag = filter.tags.some((tag) =>\n        feature.tags?.includes(tag)\n      );\n      if (!hasMatchingTag) return false;\n    }\n\n    // Filter by owners\n    if (filter.owners?.length) {\n      const hasMatchingOwner = filter.owners.some((owner) =>\n        feature.owners?.includes(owner)\n      );\n      if (!hasMatchingOwner) return false;\n    }\n\n    // Filter by stability\n    if (filter.stability?.length) {\n      if (!filter.stability.includes(feature.stability ?? 'stable')) {\n        return false;\n      }\n    }\n\n    // Filter by name pattern\n    if (filter.namePattern) {\n      const pattern = filter.namePattern\n        .replace(/\\*/g, '.*')\n        .replace(/\\?/g, '.');\n      const regex = new RegExp(`^${pattern}$`, 'i');\n      if (!regex.test(feature.key)) return false;\n    }\n\n    return true;\n  });\n}\n"],"mappings":"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"}

package/dist/analysis/impact/classifier.d.ts

@@ -0,0 +1,19 @@
+import { SemanticDiffItem } from "../../types/analysis-types.js";
+import { SpecSnapshot } from "../snapshot/types.js";
+import { ClassifyOptions, ImpactResult } from "./types.js";
+
+//#region src/analysis/impact/classifier.d.ts
+
+/**
+ * Classify the impact of changes between base and head snapshots.
+ *
+ * @param baseSpecs - Specs from the base (baseline) version
+ * @param headSpecs - Specs from the head (current) version
+ * @param diffs - Semantic diff items from comparison
+ * @param options - Classification options
+ * @returns Classified impact result
+ */
+declare function classifyImpact(baseSpecs: SpecSnapshot[], headSpecs: SpecSnapshot[], diffs: SemanticDiffItem[], options?: ClassifyOptions): ImpactResult;
+//#endregion
+export { classifyImpact };
+//# sourceMappingURL=classifier.d.ts.map

package/dist/analysis/impact/classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.d.ts","names":[],"sources":["../../../src/analysis/impact/classifier.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;iBA0BgB,cAAA,YACH,2BACA,uBACJ,8BACE,kBACR"}

package/dist/analysis/impact/classifier.js

@@ -0,0 +1,135 @@
+import { DEFAULT_RULES, findMatchingRule } from "./rules.js";
+
+//#region src/analysis/impact/classifier.ts
+/**
+* Classify the impact of changes between base and head snapshots.
+*
+* @param baseSpecs - Specs from the base (baseline) version
+* @param headSpecs - Specs from the head (current) version
+* @param diffs - Semantic diff items from comparison
+* @param options - Classification options
+* @returns Classified impact result
+*/
+function classifyImpact(baseSpecs, headSpecs, diffs, options = {}) {
+	const rules = options.customRules ?? DEFAULT_RULES;
+	const deltas = [];
+	const baseMap = new Map(baseSpecs.map((s) => [`${s.key}@${s.version}`, s]));
+	const headMap = new Map(headSpecs.map((s) => [`${s.key}@${s.version}`, s]));
+	const addedSpecs = [];
+	for (const spec of headSpecs) {
+		const lookupKey = `${spec.key}@${spec.version}`;
+		if (!baseMap.has(lookupKey)) addedSpecs.push({
+			key: spec.key,
+			version: spec.version,
+			type: spec.type
+		});
+	}
+	const removedSpecs = [];
+	for (const spec of baseSpecs) {
+		const lookupKey = `${spec.key}@${spec.version}`;
+		if (!headMap.has(lookupKey)) {
+			removedSpecs.push({
+				key: spec.key,
+				version: spec.version,
+				type: spec.type
+			});
+			deltas.push({
+				specKey: spec.key,
+				specVersion: spec.version,
+				specType: spec.type,
+				path: `spec.${spec.key}`,
+				severity: "breaking",
+				rule: "endpoint-removed",
+				description: `${spec.type === "operation" ? "Operation" : "Event"} '${spec.key}' was removed`
+			});
+		}
+	}
+	for (const diff of diffs) {
+		const matchingRule = findMatchingRule({
+			path: diff.path,
+			description: diff.description,
+			type: diff.type
+		}, rules);
+		const specInfo = findSpecInfo(extractSpecKey(diff.path, baseSpecs, headSpecs), baseSpecs, headSpecs);
+		deltas.push({
+			specKey: specInfo?.key ?? "unknown",
+			specVersion: specInfo?.version ?? "1.0.0",
+			specType: specInfo?.type ?? "operation",
+			path: diff.path,
+			severity: matchingRule?.severity ?? mapDiffTypeToSeverity(diff.type),
+			rule: matchingRule?.id ?? "unknown",
+			description: diff.description,
+			oldValue: diff.oldValue,
+			newValue: diff.newValue
+		});
+	}
+	for (const spec of addedSpecs) deltas.push({
+		specKey: spec.key,
+		specVersion: spec.version,
+		specType: spec.type,
+		path: `spec.${spec.key}`,
+		severity: "non_breaking",
+		rule: "endpoint-added",
+		description: `${spec.type === "operation" ? "Operation" : "Event"} '${spec.key}' was added`
+	});
+	const summary = calculateSummary(deltas, addedSpecs, removedSpecs);
+	const hasBreaking = summary.breaking > 0 || summary.removed > 0;
+	const hasNonBreaking = summary.nonBreaking > 0 || summary.added > 0;
+	return {
+		status: determineStatus(hasBreaking, hasNonBreaking),
+		hasBreaking,
+		hasNonBreaking,
+		summary,
+		deltas,
+		addedSpecs,
+		removedSpecs,
+		timestamp: (/* @__PURE__ */ new Date()).toISOString()
+	};
+}
+/**
+* Calculate summary counts from deltas.
+*/
+function calculateSummary(deltas, addedSpecs, removedSpecs) {
+	return {
+		breaking: deltas.filter((d) => d.severity === "breaking").length,
+		nonBreaking: deltas.filter((d) => d.severity === "non_breaking").length,
+		info: deltas.filter((d) => d.severity === "info").length,
+		added: addedSpecs.length,
+		removed: removedSpecs.length
+	};
+}
+/**
+* Determine overall status from flags.
+*/
+function determineStatus(hasBreaking, hasNonBreaking) {
+	if (hasBreaking) return "breaking";
+	if (hasNonBreaking) return "non-breaking";
+	return "no-impact";
+}
+/**
+* Map semantic diff type to impact severity.
+*/
+function mapDiffTypeToSeverity(type) {
+	switch (type) {
+		case "breaking": return "breaking";
+		case "removed": return "breaking";
+		case "added": return "non_breaking";
+		case "changed": return "info";
+		default: return "info";
+	}
+}
+/**
+* Extract spec key from a diff path (heuristic).
+*/
+function extractSpecKey(_path, _baseSpecs, _headSpecs) {}
+/**
+* Find spec info from key.
+*/
+function findSpecInfo(key, baseSpecs, headSpecs) {
+	if (!key) return headSpecs[0] ?? baseSpecs[0];
+	return headSpecs.find((s) => s.key === key) ?? baseSpecs.find((s) => s.key === key);
+}
+
+//#endregion
+export { classifyImpact };
+//# sourceMappingURL=classifier.js.map

package/dist/analysis/impact/classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.js","names":[],"sources":["../../../src/analysis/impact/classifier.ts"],"sourcesContent":["/**\n * Impact classifier.\n *\n * Classifies contract changes as breaking, non-breaking, or info.\n */\n\nimport type { SemanticDiffItem } from '../../types/analysis-types';\nimport type { SpecSnapshot } from '../snapshot/types';\nimport { DEFAULT_RULES, findMatchingRule } from './rules';\nimport type {\n  ClassifyOptions,\n  ImpactDelta,\n  ImpactResult,\n  ImpactStatus,\n  ImpactSummary,\n} from './types';\n\n/**\n * Classify the impact of changes between base and head snapshots.\n *\n * @param baseSpecs - Specs from the base (baseline) version\n * @param headSpecs - Specs from the head (current) version\n * @param diffs - Semantic diff items from comparison\n * @param options - Classification options\n * @returns Classified impact result\n */\nexport function classifyImpact(\n  baseSpecs: SpecSnapshot[],\n  headSpecs: SpecSnapshot[],\n  diffs: SemanticDiffItem[],\n  options: ClassifyOptions = {}\n): ImpactResult {\n  const rules = options.customRules ?? DEFAULT_RULES;\n  const deltas: ImpactDelta[] = [];\n\n  // Create lookup maps\n  const baseMap = new Map(baseSpecs.map((s) => [`${s.key}@${s.version}`, s]));\n  const headMap = new Map(headSpecs.map((s) => [`${s.key}@${s.version}`, s]));\n\n  // Detect added specs\n  const addedSpecs: ImpactResult['addedSpecs'] = [];\n  for (const spec of headSpecs) {\n    const lookupKey = `${spec.key}@${spec.version}`;\n    if (!baseMap.has(lookupKey)) {\n      addedSpecs.push({\n        key: spec.key,\n        version: spec.version,\n        type: spec.type,\n      });\n    }\n  }\n\n  // Detect removed specs\n  const removedSpecs: ImpactResult['removedSpecs'] = [];\n  for (const spec of baseSpecs) {\n    const lookupKey = `${spec.key}@${spec.version}`;\n    if (!headMap.has(lookupKey)) {\n      removedSpecs.push({\n        key: spec.key,\n        version: spec.version,\n        type: spec.type,\n      });\n\n      // Removed spec is always breaking\n      deltas.push({\n        specKey: spec.key,\n        specVersion: spec.version,\n        specType: spec.type,\n        path: `spec.${spec.key}`,\n        severity: 'breaking',\n        rule: 'endpoint-removed',\n        description: `${spec.type === 'operation' ? 'Operation' : 'Event'} '${spec.key}' was removed`,\n      });\n    }\n  }\n\n  // Classify diffs\n  for (const diff of diffs) {\n    const matchingRule = findMatchingRule(\n      { path: diff.path, description: diff.description, type: diff.type },\n      rules\n    );\n\n    // Extract spec key from path (heuristic)\n    const specKey = extractSpecKey(diff.path, baseSpecs, headSpecs);\n    const specInfo = findSpecInfo(specKey, baseSpecs, headSpecs);\n\n    deltas.push({\n      specKey: specInfo?.key ?? 'unknown',\n      specVersion: specInfo?.version ?? '1.0.0',\n      specType: specInfo?.type ?? 'operation',\n      path: diff.path,\n      severity: matchingRule?.severity ?? mapDiffTypeToSeverity(diff.type),\n      rule: matchingRule?.id ?? 'unknown',\n      description: diff.description,\n      oldValue: diff.oldValue,\n      newValue: diff.newValue,\n    });\n  }\n\n  // Add added specs as non-breaking changes\n  for (const spec of addedSpecs) {\n    deltas.push({\n      specKey: spec.key,\n      specVersion: spec.version,\n      specType: spec.type,\n      path: `spec.${spec.key}`,\n      severity: 'non_breaking',\n      rule: 'endpoint-added',\n      description: `${spec.type === 'operation' ? 'Operation' : 'Event'} '${spec.key}' was added`,\n    });\n  }\n\n  // Calculate summary\n  const summary = calculateSummary(deltas, addedSpecs, removedSpecs);\n\n  // Determine status\n  const hasBreaking = summary.breaking > 0 || summary.removed > 0;\n  const hasNonBreaking = summary.nonBreaking > 0 || summary.added > 0;\n  const status = determineStatus(hasBreaking, hasNonBreaking);\n\n  return {\n    status,\n    hasBreaking,\n    hasNonBreaking,\n    summary,\n    deltas,\n    addedSpecs,\n    removedSpecs,\n    timestamp: new Date().toISOString(),\n  };\n}\n\n/**\n * Calculate summary counts from deltas.\n */\nfunction calculateSummary(\n  deltas: ImpactDelta[],\n  addedSpecs: ImpactResult['addedSpecs'],\n  removedSpecs: ImpactResult['removedSpecs']\n): ImpactSummary {\n  return {\n    breaking: deltas.filter((d) => d.severity === 'breaking').length,\n    nonBreaking: deltas.filter((d) => d.severity === 'non_breaking').length,\n    info: deltas.filter((d) => d.severity === 'info').length,\n    added: addedSpecs.length,\n    removed: removedSpecs.length,\n  };\n}\n\n/**\n * Determine overall status from flags.\n */\nfunction determineStatus(\n  hasBreaking: boolean,\n  hasNonBreaking: boolean\n): ImpactStatus {\n  if (hasBreaking) return 'breaking';\n  if (hasNonBreaking) return 'non-breaking';\n  return 'no-impact';\n}\n\n/**\n * Map semantic diff type to impact severity.\n */\nfunction mapDiffTypeToSeverity(type: string): ImpactDelta['severity'] {\n  switch (type) {\n    case 'breaking':\n      return 'breaking';\n    case 'removed':\n      return 'breaking';\n    case 'added':\n      return 'non_breaking';\n    case 'changed':\n      return 'info';\n    default:\n      return 'info';\n  }\n}\n\n/**\n * Extract spec key from a diff path (heuristic).\n */\nfunction extractSpecKey(\n  _path: string,\n  _baseSpecs: SpecSnapshot[],\n  _headSpecs: SpecSnapshot[]\n): string | undefined {\n  // This is a simplified heuristic; in practice would need more context\n  return undefined;\n}\n\n/**\n * Find spec info from key.\n */\nfunction findSpecInfo(\n  key: string | undefined,\n  baseSpecs: SpecSnapshot[],\n  headSpecs: SpecSnapshot[]\n): SpecSnapshot | undefined {\n  if (!key) return headSpecs[0] ?? baseSpecs[0];\n  return (\n    headSpecs.find((s) => s.key === key) ?? baseSpecs.find((s) => s.key === key)\n  );\n}\n"],"mappings":"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"}

package/dist/analysis/impact/index.js

@@ -0,0 +1,2 @@
+import { BREAKING_RULES, DEFAULT_RULES, INFO_RULES, NON_BREAKING_RULES, findMatchingRule, getRulesBySeverity } from "./rules.js";
+import { classifyImpact } from "./classifier.js";

package/dist/analysis/impact/rules.d.ts

@@ -0,0 +1,35 @@
+import { ImpactRule, ImpactSeverity } from "./types.js";
+
+//#region src/analysis/impact/rules.d.ts
+
+/**
+ * Default breaking change rules.
+ */
+declare const BREAKING_RULES: ImpactRule[];
+/**
+ * Non-breaking change rules.
+ */
+declare const NON_BREAKING_RULES: ImpactRule[];
+/**
+ * Info-level change rules.
+ */
+declare const INFO_RULES: ImpactRule[];
+/**
+ * All default rules in priority order (breaking > non_breaking > info).
+ */
+declare const DEFAULT_RULES: ImpactRule[];
+/**
+ * Get rules by severity.
+ */
+declare function getRulesBySeverity(severity: ImpactSeverity): ImpactRule[];
+/**
+ * Find matching rule for a delta.
+ */
+declare function findMatchingRule(delta: {
+  path: string;
+  description: string;
+  type: string;
+}, rules?: ImpactRule[]): ImpactRule | undefined;
+//#endregion
+export { BREAKING_RULES, DEFAULT_RULES, INFO_RULES, NON_BREAKING_RULES, findMatchingRule, getRulesBySeverity };
+//# sourceMappingURL=rules.d.ts.map

package/dist/analysis/impact/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","names":[],"sources":["../../../src/analysis/impact/rules.ts"],"sourcesContent":[],"mappings":";;;;AAqKA;AASA;AAOA;cA1Ka,gBAAgB;;;;cAiFhB,oBAAoB;;;;cA2CpB,YAAY;;;;cA8BZ,eAAe;;;;iBASZ,kBAAA,WAA6B,iBAAiB;;;;iBAO9C,gBAAA;;;;WAEP,eACN"}