@contractspec/module.workspace 0.0.0-canary-20260113162409

package/dist/analysis/diff/deep-diff.js

@@ -0,0 +1,114 @@
+//#region src/analysis/diff/deep-diff.ts
+/**
+* Compute deep differences between two IO schemas.
+*/
+function computeIoDiff(base, head, options = {}) {
+	const diffs = [];
+	diffs.push(...computeFieldsDiff(base.input, head.input, "io.input", options));
+	diffs.push(...computeFieldsDiff(base.output, head.output, "io.output", options));
+	return options.breakingOnly ? diffs.filter((d) => d.type === "breaking") : diffs;
+}
+/**
+* Compute differences between two field maps.
+*/
+function computeFieldsDiff(baseFields, headFields, pathPrefix, options = {}) {
+	const diffs = [];
+	const baseNames = new Set(Object.keys(baseFields));
+	const headNames = new Set(Object.keys(headFields));
+	for (const name of baseNames) if (!headNames.has(name)) {
+		const baseField = baseFields[name];
+		diffs.push({
+			type: "breaking",
+			path: `${pathPrefix}.${name}`,
+			oldValue: baseField,
+			newValue: void 0,
+			description: `Field '${name}' was removed`
+		});
+	}
+	for (const name of headNames) if (!baseNames.has(name)) {
+		const headField = headFields[name];
+		const isBreaking = headField?.required === true;
+		diffs.push({
+			type: isBreaking ? "breaking" : "added",
+			path: `${pathPrefix}.${name}`,
+			oldValue: void 0,
+			newValue: headField,
+			description: isBreaking ? `Required field '${name}' was added` : `Optional field '${name}' was added`
+		});
+	}
+	for (const name of baseNames) if (headNames.has(name)) {
+		const baseField = baseFields[name];
+		const headField = headFields[name];
+		if (baseField && headField) diffs.push(...computeFieldDiff(baseField, headField, `${pathPrefix}.${name}`, options));
+	}
+	return diffs;
+}
+/**
+* Compute differences between two field definitions.
+*/
+function computeFieldDiff(base, head, path, _options = {}) {
+	const diffs = [];
+	if (base.type !== head.type) diffs.push({
+		type: "breaking",
+		path: `${path}.type`,
+		oldValue: base.type,
+		newValue: head.type,
+		description: `Field type changed from '${base.type}' to '${head.type}'`
+	});
+	if (base.required !== head.required) {
+		const isBreaking = !base.required && head.required;
+		diffs.push({
+			type: isBreaking ? "breaking" : "changed",
+			path: `${path}.required`,
+			oldValue: base.required,
+			newValue: head.required,
+			description: isBreaking ? `Field '${base.name}' changed from optional to required` : `Field '${base.name}' changed from required to optional`
+		});
+	}
+	if (base.nullable !== head.nullable) {
+		const isBreaking = base.nullable && !head.nullable;
+		diffs.push({
+			type: isBreaking ? "breaking" : "changed",
+			path: `${path}.nullable`,
+			oldValue: base.nullable,
+			newValue: head.nullable,
+			description: isBreaking ? `Field '${base.name}' is no longer nullable` : `Field '${base.name}' is now nullable`
+		});
+	}
+	if (base.type === "enum" && head.type === "enum") {
+		const baseValues = new Set(base.enumValues ?? []);
+		const headValues = new Set(head.enumValues ?? []);
+		for (const value of baseValues) if (!headValues.has(value)) diffs.push({
+			type: "breaking",
+			path: `${path}.enumValues`,
+			oldValue: base.enumValues,
+			newValue: head.enumValues,
+			description: `Enum value '${value}' was removed`
+		});
+		for (const value of headValues) if (!baseValues.has(value)) diffs.push({
+			type: "added",
+			path: `${path}.enumValues`,
+			oldValue: base.enumValues,
+			newValue: head.enumValues,
+			description: `Enum value '${value}' was added`
+		});
+	}
+	if (base.type === "object" && head.type === "object" && base.properties && head.properties) diffs.push(...computeFieldsDiff(base.properties, head.properties, path, _options));
+	if (base.type === "array" && head.type === "array" && base.items && head.items) diffs.push(...computeFieldDiff(base.items, head.items, `${path}.items`, _options));
+	return diffs;
+}
+/**
+* Classify a diff as breaking based on context.
+*/
+function isBreakingChange(diff, context) {
+	if (context === "output") return diff.type === "breaking" || diff.type === "removed";
+	if (context === "input") {
+		if (diff.type === "added" && diff.description?.includes("Required field")) return true;
+		return diff.type === "breaking";
+	}
+	return diff.type === "breaking";
+}
+
+//#endregion
+export { computeFieldDiff, computeFieldsDiff, computeIoDiff, isBreakingChange };
+//# sourceMappingURL=deep-diff.js.map

package/dist/analysis/diff/deep-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-diff.js","names":[],"sources":["../../../src/analysis/diff/deep-diff.ts"],"sourcesContent":["/**\n * Deep diff engine for IO schema comparison.\n *\n * Compares input/output schemas field-by-field to detect\n * breaking and non-breaking changes.\n */\n\nimport type { FieldSnapshot, IoSnapshot } from '../snapshot/types';\nimport type { SemanticDiffItem } from '../../types/analysis-types';\n\n/**\n * Deep diff options.\n */\nexport interface DeepDiffOptions {\n  /** Only report breaking changes */\n  breakingOnly?: boolean;\n  /** Path prefix for nested diffs */\n  pathPrefix?: string;\n}\n\n/**\n * Compute deep differences between two IO schemas.\n */\nexport function computeIoDiff(\n  base: IoSnapshot,\n  head: IoSnapshot,\n  options: DeepDiffOptions = {}\n): SemanticDiffItem[] {\n  const diffs: SemanticDiffItem[] = [];\n\n  // Compare input schemas\n  diffs.push(...computeFieldsDiff(base.input, head.input, 'io.input', options));\n\n  // Compare output schemas\n  diffs.push(\n    ...computeFieldsDiff(base.output, head.output, 'io.output', options)\n  );\n\n  return options.breakingOnly\n    ? diffs.filter((d) => d.type === 'breaking')\n    : diffs;\n}\n\n/**\n * Compute differences between two field maps.\n */\nexport function computeFieldsDiff(\n  baseFields: Record<string, FieldSnapshot>,\n  headFields: Record<string, FieldSnapshot>,\n  pathPrefix: string,\n  options: DeepDiffOptions = {}\n): SemanticDiffItem[] {\n  const diffs: SemanticDiffItem[] = [];\n  const baseNames = new Set(Object.keys(baseFields));\n  const headNames = new Set(Object.keys(headFields));\n\n  // Check for removed fields\n  for (const name of baseNames) {\n    if (!headNames.has(name)) {\n      const baseField = baseFields[name];\n      diffs.push({\n        type: 'breaking',\n        path: `${pathPrefix}.${name}`,\n        oldValue: baseField,\n        newValue: undefined,\n        description: `Field '${name}' was removed`,\n      });\n    }\n  }\n\n  // Check for added fields\n  for (const name of headNames) {\n    if (!baseNames.has(name)) {\n      const headField = headFields[name];\n      const isBreaking = headField?.required === true;\n      diffs.push({\n        type: isBreaking ? 'breaking' : 'added',\n        path: `${pathPrefix}.${name}`,\n        oldValue: undefined,\n        newValue: headField,\n        description: isBreaking\n          ? `Required field '${name}' was added`\n          : `Optional field '${name}' was added`,\n      });\n    }\n  }\n\n  // Check for changed fields\n  for (const name of baseNames) {\n    if (headNames.has(name)) {\n      const baseField = baseFields[name];\n      const headField = headFields[name];\n      if (baseField && headField) {\n        diffs.push(\n          ...computeFieldDiff(\n            baseField,\n            headField,\n            `${pathPrefix}.${name}`,\n            options\n          )\n        );\n      }\n    }\n  }\n\n  return diffs;\n}\n\n/**\n * Compute differences between two field definitions.\n */\nexport function computeFieldDiff(\n  base: FieldSnapshot,\n  head: FieldSnapshot,\n  path: string,\n  _options: DeepDiffOptions = {}\n): SemanticDiffItem[] {\n  const diffs: SemanticDiffItem[] = [];\n\n  // Type change is always breaking\n  if (base.type !== head.type) {\n    diffs.push({\n      type: 'breaking',\n      path: `${path}.type`,\n      oldValue: base.type,\n      newValue: head.type,\n      description: `Field type changed from '${base.type}' to '${head.type}'`,\n    });\n  }\n\n  // Required change\n  if (base.required !== head.required) {\n    const isBreaking = !base.required && head.required; // Optional -> Required is breaking\n    diffs.push({\n      type: isBreaking ? 'breaking' : 'changed',\n      path: `${path}.required`,\n      oldValue: base.required,\n      newValue: head.required,\n      description: isBreaking\n        ? `Field '${base.name}' changed from optional to required`\n        : `Field '${base.name}' changed from required to optional`,\n    });\n  }\n\n  // Nullable change\n  if (base.nullable !== head.nullable) {\n    const isBreaking = base.nullable && !head.nullable; // Nullable -> Non-nullable is breaking\n    diffs.push({\n      type: isBreaking ? 'breaking' : 'changed',\n      path: `${path}.nullable`,\n      oldValue: base.nullable,\n      newValue: head.nullable,\n      description: isBreaking\n        ? `Field '${base.name}' is no longer nullable`\n        : `Field '${base.name}' is now nullable`,\n    });\n  }\n\n  // Enum values change\n  if (base.type === 'enum' && head.type === 'enum') {\n    const baseValues = new Set(base.enumValues ?? []);\n    const headValues = new Set(head.enumValues ?? []);\n\n    // Removed enum values are breaking\n    for (const value of baseValues) {\n      if (!headValues.has(value)) {\n        diffs.push({\n          type: 'breaking',\n          path: `${path}.enumValues`,\n          oldValue: base.enumValues,\n          newValue: head.enumValues,\n          description: `Enum value '${value}' was removed`,\n        });\n      }\n    }\n\n    // Added enum values are non-breaking\n    for (const value of headValues) {\n      if (!baseValues.has(value)) {\n        diffs.push({\n          type: 'added',\n          path: `${path}.enumValues`,\n          oldValue: base.enumValues,\n          newValue: head.enumValues,\n          description: `Enum value '${value}' was added`,\n        });\n      }\n    }\n  }\n\n  // Nested object fields\n  if (\n    base.type === 'object' &&\n    head.type === 'object' &&\n    base.properties &&\n    head.properties\n  ) {\n    diffs.push(\n      ...computeFieldsDiff(base.properties, head.properties, path, _options)\n    );\n  }\n\n  // Array items\n  if (\n    base.type === 'array' &&\n    head.type === 'array' &&\n    base.items &&\n    head.items\n  ) {\n    diffs.push(\n      ...computeFieldDiff(base.items, head.items, `${path}.items`, _options)\n    );\n  }\n\n  return diffs;\n}\n\n/**\n * Classify a diff as breaking based on context.\n */\nexport function isBreakingChange(\n  diff: SemanticDiffItem,\n  context: 'input' | 'output'\n): boolean {\n  // In output context, removing/changing fields is always breaking\n  if (context === 'output') {\n    return diff.type === 'breaking' || diff.type === 'removed';\n  }\n\n  // In input context, adding required fields is breaking\n  if (context === 'input') {\n    if (diff.type === 'added' && diff.description?.includes('Required field')) {\n      return true;\n    }\n    return diff.type === 'breaking';\n  }\n\n  return diff.type === 'breaking';\n}\n"],"mappings":"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"}

package/dist/analysis/diff/semantic.d.ts

@@ -0,0 +1,11 @@
+import { SemanticDiffItem, SemanticDiffOptions } from "../../types/analysis-types.js";
+
+//#region src/analysis/diff/semantic.d.ts
+
+/**
+ * Compute semantic differences between two spec sources.
+ */
+declare function computeSemanticDiff(aCode: string, aPath: string, bCode: string, bPath: string, options?: SemanticDiffOptions): SemanticDiffItem[];
+//#endregion
+export { computeSemanticDiff };
+//# sourceMappingURL=semantic.d.ts.map

package/dist/analysis/diff/semantic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.d.ts","names":[],"sources":["../../../src/analysis/diff/semantic.ts"],"sourcesContent":[],"mappings":";;;;;;;iBAegB,mBAAA,uEAKL,sBACR"}

package/dist/analysis/diff/semantic.js

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

package/dist/analysis/diff/semantic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.js","names":[],"sources":["../../../src/analysis/diff/semantic.ts"],"sourcesContent":["/**\n * Semantic diff computation for contract specs.\n * Extracted from cli-contractspec/src/commands/diff/semantic.ts\n */\n\nimport type {\n  SemanticDiffItem,\n  SemanticDiffOptions,\n  SpecScanResult,\n} from '../../types/analysis-types';\nimport { scanSpecSource } from '../spec-scan';\n\n/**\n * Compute semantic differences between two spec sources.\n */\nexport function computeSemanticDiff(\n  aCode: string,\n  aPath: string,\n  bCode: string,\n  bPath: string,\n  options: SemanticDiffOptions = {}\n): SemanticDiffItem[] {\n  const a = scanSpecSource(aCode, aPath);\n  const b = scanSpecSource(bCode, bPath);\n\n  const diffs: SemanticDiffItem[] = [];\n\n  compareScalar(diffs, 'specType', a.specType, b.specType, {\n    breaking: true,\n    label: 'Spec type',\n  });\n\n  compareScalar(diffs, 'key', a.key, b.key, {\n    breaking: true,\n    label: 'Key',\n  });\n  compareScalar(diffs, 'version', a.version, b.version, {\n    breaking: true,\n    label: 'Version',\n  });\n  compareScalar(diffs, 'kind', a.kind, b.kind, {\n    breaking: true,\n    label: 'Kind',\n  });\n\n  compareScalar(diffs, 'stability', a.stability, b.stability, {\n    breaking: isStabilityDowngrade(a, b),\n    label: 'Stability',\n  });\n\n  compareArray(diffs, 'owners', a.owners ?? [], b.owners ?? [], {\n    label: 'Owners',\n  });\n  compareArray(diffs, 'tags', a.tags ?? [], b.tags ?? [], { label: 'Tags' });\n\n  compareStructuralHints(diffs, a, b);\n\n  const filtered = options.breakingOnly\n    ? diffs.filter((d) => d.type === 'breaking')\n    : diffs;\n\n  return filtered;\n}\n\nfunction compareScalar(\n  diffs: SemanticDiffItem[],\n  path: string,\n  a: unknown,\n  b: unknown,\n  config: { breaking: boolean; label: string }\n) {\n  if (a === b) return;\n  diffs.push({\n    type: config.breaking ? 'breaking' : 'changed',\n    path,\n    oldValue: a,\n    newValue: b,\n    description: `${config.label} changed`,\n  });\n}\n\nfunction compareArray(\n  diffs: SemanticDiffItem[],\n  path: string,\n  a: string[],\n  b: string[],\n  config: { label: string }\n) {\n  const aSorted = [...a].sort();\n  const bSorted = [...b].sort();\n  if (JSON.stringify(aSorted) === JSON.stringify(bSorted)) return;\n\n  diffs.push({\n    type: 'changed',\n    path,\n    oldValue: aSorted,\n    newValue: bSorted,\n    description: `${config.label} changed`,\n  });\n}\n\nfunction isStabilityDowngrade(a: SpecScanResult, b: SpecScanResult): boolean {\n  const order: Record<string, number> = {\n    experimental: 0,\n    beta: 1,\n    stable: 2,\n    deprecated: 3,\n  };\n  const aValue = a.stability ? (order[a.stability] ?? 0) : 0;\n  const bValue = b.stability ? (order[b.stability] ?? 0) : 0;\n  // Moving toward deprecated is effectively a breaking signal for consumers.\n  return bValue > aValue;\n}\n\nfunction compareStructuralHints(\n  diffs: SemanticDiffItem[],\n  a: SpecScanResult,\n  b: SpecScanResult\n) {\n  // For operations these sections are usually required; missing them is breaking.\n  compareScalar(diffs, 'hasMeta', a.hasMeta, b.hasMeta, {\n    breaking: a.specType === 'operation' || b.specType === 'operation',\n    label: 'meta section presence',\n  });\n  compareScalar(diffs, 'hasIo', a.hasIo, b.hasIo, {\n    breaking: a.specType === 'operation' || b.specType === 'operation',\n    label: 'io section presence',\n  });\n  compareScalar(diffs, 'hasPolicy', a.hasPolicy, b.hasPolicy, {\n    breaking: a.specType === 'operation' || b.specType === 'operation',\n    label: 'policy section presence',\n  });\n  compareScalar(diffs, 'hasPayload', a.hasPayload, b.hasPayload, {\n    breaking: a.specType === 'event' || b.specType === 'event',\n    label: 'payload section presence',\n  });\n  compareScalar(diffs, 'hasContent', a.hasContent, b.hasContent, {\n    breaking: a.specType === 'presentation' || b.specType === 'presentation',\n    label: 'content section presence',\n  });\n  compareScalar(diffs, 'hasDefinition', a.hasDefinition, b.hasDefinition, {\n    breaking: a.specType === 'workflow' || b.specType === 'workflow',\n    label: 'definition section presence',\n  });\n}\n"],"mappings":";;;;;;AAeA,SAAgB,oBACd,OACA,OACA,OACA,OACA,UAA+B,EAAE,EACb;CACpB,MAAM,IAAI,eAAe,OAAO,MAAM;CACtC,MAAM,IAAI,eAAe,OAAO,MAAM;CAEtC,MAAM,QAA4B,EAAE;AAEpC,eAAc,OAAO,YAAY,EAAE,UAAU,EAAE,UAAU;EACvD,UAAU;EACV,OAAO;EACR,CAAC;AAEF,eAAc,OAAO,OAAO,EAAE,KAAK,EAAE,KAAK;EACxC,UAAU;EACV,OAAO;EACR,CAAC;AACF,eAAc,OAAO,WAAW,EAAE,SAAS,EAAE,SAAS;EACpD,UAAU;EACV,OAAO;EACR,CAAC;AACF,eAAc,OAAO,QAAQ,EAAE,MAAM,EAAE,MAAM;EAC3C,UAAU;EACV,OAAO;EACR,CAAC;AAEF,eAAc,OAAO,aAAa,EAAE,WAAW,EAAE,WAAW;EAC1D,UAAU,qBAAqB,GAAG,EAAE;EACpC,OAAO;EACR,CAAC;AAEF,cAAa,OAAO,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAC5D,OAAO,UACR,CAAC;AACF,cAAa,OAAO,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,QAAQ,CAAC;AAE1E,wBAAuB,OAAO,GAAG,EAAE;AAMnC,QAJiB,QAAQ,eACrB,MAAM,QAAQ,MAAM,EAAE,SAAS,WAAW,GAC1C;;AAKN,SAAS,cACP,OACA,MACA,GACA,GACA,QACA;AACA,KAAI,MAAM,EAAG;AACb,OAAM,KAAK;EACT,MAAM,OAAO,WAAW,aAAa;EACrC;EACA,UAAU;EACV,UAAU;EACV,aAAa,GAAG,OAAO,MAAM;EAC9B,CAAC;;AAGJ,SAAS,aACP,OACA,MACA,GACA,GACA,QACA;CACA,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM;CAC7B,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM;AAC7B,KAAI,KAAK,UAAU,QAAQ,KAAK,KAAK,UAAU,QAAQ,CAAE;AAEzD,OAAM,KAAK;EACT,MAAM;EACN;EACA,UAAU;EACV,UAAU;EACV,aAAa,GAAG,OAAO,MAAM;EAC9B,CAAC;;AAGJ,SAAS,qBAAqB,GAAmB,GAA4B;CAC3E,MAAM,QAAgC;EACpC,cAAc;EACd,MAAM;EACN,QAAQ;EACR,YAAY;EACb;CACD,MAAM,SAAS,EAAE,YAAa,MAAM,EAAE,cAAc,IAAK;AAGzD,SAFe,EAAE,YAAa,MAAM,EAAE,cAAc,IAAK,KAEzC;;AAGlB,SAAS,uBACP,OACA,GACA,GACA;AAEA,eAAc,OAAO,WAAW,EAAE,SAAS,EAAE,SAAS;EACpD,UAAU,EAAE,aAAa,eAAe,EAAE,aAAa;EACvD,OAAO;EACR,CAAC;AACF,eAAc,OAAO,SAAS,EAAE,OAAO,EAAE,OAAO;EAC9C,UAAU,EAAE,aAAa,eAAe,EAAE,aAAa;EACvD,OAAO;EACR,CAAC;AACF,eAAc,OAAO,aAAa,EAAE,WAAW,EAAE,WAAW;EAC1D,UAAU,EAAE,aAAa,eAAe,EAAE,aAAa;EACvD,OAAO;EACR,CAAC;AACF,eAAc,OAAO,cAAc,EAAE,YAAY,EAAE,YAAY;EAC7D,UAAU,EAAE,aAAa,WAAW,EAAE,aAAa;EACnD,OAAO;EACR,CAAC;AACF,eAAc,OAAO,cAAc,EAAE,YAAY,EAAE,YAAY;EAC7D,UAAU,EAAE,aAAa,kBAAkB,EAAE,aAAa;EAC1D,OAAO;EACR,CAAC;AACF,eAAc,OAAO,iBAAiB,EAAE,eAAe,EAAE,eAAe;EACtE,UAAU,EAAE,aAAa,cAAc,EAAE,aAAa;EACtD,OAAO;EACR,CAAC"}

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

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

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

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

package/dist/analysis/example-scan.js

@@ -0,0 +1,116 @@
+import { isStability, matchStringArrayField, matchStringField, matchStringFieldIn } from "./utils/matchers.js";
+
+//#region src/analysis/example-scan.ts
+/**
+* Check if a file is an example file based on naming conventions.
+*/
+function isExampleFile(filePath) {
+	return filePath.includes("/example.") || filePath.endsWith(".example.ts");
+}
+/**
+* Scan an example source file to extract metadata.
+*/
+function scanExampleSource(code, filePath) {
+	const key = matchStringField(code, "key") ?? extractKeyFromFilePath(filePath);
+	const version = matchStringField(code, "version") ?? void 0;
+	const title = matchStringField(code, "title") ?? void 0;
+	const description = matchStringField(code, "description") ?? void 0;
+	const summary = matchStringField(code, "summary") ?? void 0;
+	const kind = matchStringField(code, "kind") ?? void 0;
+	const visibility = matchStringField(code, "visibility") ?? void 0;
+	const domain = matchStringField(code, "domain") ?? void 0;
+	const stabilityRaw = matchStringField(code, "stability");
+	return {
+		filePath,
+		key,
+		version,
+		title,
+		description,
+		summary,
+		kind,
+		visibility,
+		domain,
+		stability: isStability(stabilityRaw) ? stabilityRaw : void 0,
+		owners: matchStringArrayField(code, "owners"),
+		tags: matchStringArrayField(code, "tags"),
+		docs: extractDocs(code),
+		surfaces: extractSurfaces(code),
+		entrypoints: extractEntrypoints(code)
+	};
+}
+/**
+* Extract docs section from source code.
+*/
+function extractDocs(code) {
+	const docsMatch = code.match(/docs\s*:\s*\{([\s\S]*?)\}/);
+	if (!docsMatch?.[1]) return void 0;
+	const docsContent = docsMatch[1];
+	return {
+		rootDocId: matchStringFieldIn(docsContent, "rootDocId") ?? void 0,
+		goalDocId: matchStringFieldIn(docsContent, "goalDocId") ?? void 0,
+		usageDocId: matchStringFieldIn(docsContent, "usageDocId") ?? void 0
+	};
+}
+/**
+* Extract surfaces section from source code.
+*/
+function extractSurfaces(code) {
+	const surfaces = {
+		templates: false,
+		sandbox: {
+			enabled: false,
+			modes: []
+		},
+		studio: {
+			enabled: false,
+			installable: false
+		},
+		mcp: { enabled: false }
+	};
+	surfaces.templates = /surfaces\s*:\s*\{[\s\S]*?templates\s*:\s*true/.test(code);
+	const sandboxMatch = code.match(/sandbox\s*:\s*\{\s*enabled\s*:\s*(true|false)\s*,\s*modes\s*:\s*\[([^\]]*)\]/);
+	if (sandboxMatch) {
+		surfaces.sandbox.enabled = sandboxMatch[1] === "true";
+		if (sandboxMatch[2]) surfaces.sandbox.modes = Array.from(sandboxMatch[2].matchAll(/['"]([^'"]+)['"]/g)).map((m) => m[1]).filter((v) => typeof v === "string");
+	}
+	const studioMatch = code.match(/studio\s*:\s*\{\s*enabled\s*:\s*(true|false)\s*,\s*installable\s*:\s*(true|false)/);
+	if (studioMatch) {
+		surfaces.studio.enabled = studioMatch[1] === "true";
+		surfaces.studio.installable = studioMatch[2] === "true";
+	}
+	const mcpMatch = code.match(/mcp\s*:\s*\{\s*enabled\s*:\s*(true|false)/);
+	if (mcpMatch) surfaces.mcp.enabled = mcpMatch[1] === "true";
+	return surfaces;
+}
+/**
+* Extract entrypoints section from source code.
+*/
+function extractEntrypoints(code) {
+	const entrypoints = { packageName: "" };
+	const entrypointsMatch = code.match(/entrypoints\s*:\s*\{([\s\S]*?)\}(?=\s*[,}])/);
+	if (!entrypointsMatch?.[1]) return entrypoints;
+	const content = entrypointsMatch[1];
+	entrypoints.packageName = matchStringFieldIn(content, "packageName") ?? "unknown";
+	entrypoints.feature = matchStringFieldIn(content, "feature") ?? void 0;
+	entrypoints.blueprint = matchStringFieldIn(content, "blueprint") ?? void 0;
+	entrypoints.contracts = matchStringFieldIn(content, "contracts") ?? void 0;
+	entrypoints.presentations = matchStringFieldIn(content, "presentations") ?? void 0;
+	entrypoints.handlers = matchStringFieldIn(content, "handlers") ?? void 0;
+	entrypoints.ui = matchStringFieldIn(content, "ui") ?? void 0;
+	entrypoints.docs = matchStringFieldIn(content, "docs") ?? void 0;
+	return entrypoints;
+}
+/**
+* Extract key from file path as fallback.
+*/
+function extractKeyFromFilePath(filePath) {
+	const parts = filePath.split("/");
+	const examplesIndex = parts.findIndex((p) => p === "examples");
+	const exampleName = parts[examplesIndex + 1];
+	if (examplesIndex !== -1 && exampleName !== void 0) return exampleName;
+	return (parts.pop() ?? filePath).replace(/\.example\.[jt]s$/, "").replace(/[^a-zA-Z0-9-]/g, "-");
+}
+
+//#endregion
+export { isExampleFile, scanExampleSource };
+//# sourceMappingURL=example-scan.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"example-scan.js","names":[],"sources":["../../src/analysis/example-scan.ts"],"sourcesContent":["import {\n  isStability,\n  matchStringArrayField,\n  matchStringField,\n  matchStringFieldIn,\n} from './utils/matchers';\nimport type { ExampleScanResult } from '../types/analysis-types';\n\n/**\n * Check if a file is an example file based on naming conventions.\n */\nexport function isExampleFile(filePath: string): boolean {\n  return filePath.includes('/example.') || filePath.endsWith('.example.ts');\n}\n\n/**\n * Scan an example source file to extract metadata.\n */\nexport function scanExampleSource(\n  code: string,\n  filePath: string\n): ExampleScanResult {\n  const key = matchStringField(code, 'key') ?? extractKeyFromFilePath(filePath);\n  const versionRaw = matchStringField(code, 'version');\n  const version = versionRaw ?? undefined;\n  const title = matchStringField(code, 'title') ?? undefined;\n  const description = matchStringField(code, 'description') ?? undefined;\n  const summary = matchStringField(code, 'summary') ?? undefined;\n  const kind = matchStringField(code, 'kind') ?? undefined;\n  const visibility = matchStringField(code, 'visibility') ?? undefined;\n  const domain = matchStringField(code, 'domain') ?? 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  // Extract docs\n  const docs = extractDocs(code);\n\n  // Extract surfaces\n  const surfaces = extractSurfaces(code);\n\n  // Extract entrypoints\n  const entrypoints = extractEntrypoints(code);\n\n  return {\n    filePath,\n    key,\n    version,\n    title,\n    description,\n    summary,\n    kind,\n    visibility,\n    domain,\n    stability,\n    owners,\n    tags,\n    docs,\n    surfaces,\n    entrypoints,\n  };\n}\n\n/**\n * Extract docs section from source code.\n */\nfunction extractDocs(code: string): ExampleScanResult['docs'] {\n  const docsMatch = code.match(/docs\\s*:\\s*\\{([\\s\\S]*?)\\}/);\n  if (!docsMatch?.[1]) return undefined;\n\n  const docsContent = docsMatch[1];\n  return {\n    rootDocId: matchStringFieldIn(docsContent, 'rootDocId') ?? undefined,\n    goalDocId: matchStringFieldIn(docsContent, 'goalDocId') ?? undefined,\n    usageDocId: matchStringFieldIn(docsContent, 'usageDocId') ?? undefined,\n  };\n}\n\n/**\n * Extract surfaces section from source code.\n */\nfunction extractSurfaces(code: string): ExampleScanResult['surfaces'] {\n  const surfaces: ExampleScanResult['surfaces'] = {\n    templates: false,\n    sandbox: { enabled: false, modes: [] },\n    studio: { enabled: false, installable: false },\n    mcp: { enabled: false },\n  };\n\n  // Check templates directly in the surfaces section\n  surfaces.templates = /surfaces\\s*:\\s*\\{[\\s\\S]*?templates\\s*:\\s*true/.test(\n    code\n  );\n\n  // Check sandbox - look for the sandbox object and extract its content\n  const sandboxMatch = code.match(\n    /sandbox\\s*:\\s*\\{\\s*enabled\\s*:\\s*(true|false)\\s*,\\s*modes\\s*:\\s*\\[([^\\]]*)\\]/\n  );\n  if (sandboxMatch) {\n    surfaces.sandbox.enabled = sandboxMatch[1] === 'true';\n    if (sandboxMatch[2]) {\n      surfaces.sandbox.modes = Array.from(\n        sandboxMatch[2].matchAll(/['\"]([^'\"]+)['\"]/g)\n      )\n        .map((m) => m[1])\n        .filter((v): v is string => typeof v === 'string');\n    }\n  }\n\n  // Check studio - look for studio object\n  const studioMatch = code.match(\n    /studio\\s*:\\s*\\{\\s*enabled\\s*:\\s*(true|false)\\s*,\\s*installable\\s*:\\s*(true|false)/\n  );\n  if (studioMatch) {\n    surfaces.studio.enabled = studioMatch[1] === 'true';\n    surfaces.studio.installable = studioMatch[2] === 'true';\n  }\n\n  // Check mcp\n  const mcpMatch = code.match(/mcp\\s*:\\s*\\{\\s*enabled\\s*:\\s*(true|false)/);\n  if (mcpMatch) {\n    surfaces.mcp.enabled = mcpMatch[1] === 'true';\n  }\n\n  return surfaces;\n}\n\n/**\n * Extract entrypoints section from source code.\n */\nfunction extractEntrypoints(code: string): ExampleScanResult['entrypoints'] {\n  const entrypoints: ExampleScanResult['entrypoints'] = {\n    packageName: '',\n  };\n\n  const entrypointsMatch = code.match(\n    /entrypoints\\s*:\\s*\\{([\\s\\S]*?)\\}(?=\\s*[,}])/\n  );\n  if (!entrypointsMatch?.[1]) return entrypoints;\n\n  const content = entrypointsMatch[1];\n\n  entrypoints.packageName =\n    matchStringFieldIn(content, 'packageName') ?? 'unknown';\n  entrypoints.feature = matchStringFieldIn(content, 'feature') ?? undefined;\n  entrypoints.blueprint = matchStringFieldIn(content, 'blueprint') ?? undefined;\n  entrypoints.contracts = matchStringFieldIn(content, 'contracts') ?? undefined;\n  entrypoints.presentations =\n    matchStringFieldIn(content, 'presentations') ?? undefined;\n  entrypoints.handlers = matchStringFieldIn(content, 'handlers') ?? undefined;\n  entrypoints.ui = matchStringFieldIn(content, 'ui') ?? undefined;\n  entrypoints.docs = matchStringFieldIn(content, 'docs') ?? undefined;\n\n  return entrypoints;\n}\n\n/**\n * Extract key from file path as fallback.\n */\nfunction extractKeyFromFilePath(filePath: string): string {\n  // Try to get package name from path\n  const parts = filePath.split('/');\n  const examplesIndex = parts.findIndex((p) => p === 'examples');\n  const exampleName = parts[examplesIndex + 1];\n  if (examplesIndex !== -1 && exampleName !== undefined) {\n    return exampleName;\n  }\n  // Fallback to filename\n  const fileName = parts.pop() ?? filePath;\n  return fileName\n    .replace(/\\.example\\.[jt]s$/, '')\n    .replace(/[^a-zA-Z0-9-]/g, '-');\n}\n"],"mappings":"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"}

package/dist/analysis/feature-extractor.js

@@ -0,0 +1,203 @@
+import { Node, Project, SyntaxKind } from "ts-morph";
+
+//#region src/analysis/feature-extractor.ts
+/**
+* Extract specs referenced in a feature.
+* Uses ts-morph for robust parsing of object structures.
+*/
+function extractFeatureRefs(code) {
+	const result = {
+		operations: [],
+		events: [],
+		presentations: [],
+		experiments: [],
+		capabilities: {
+			provides: [],
+			requires: []
+		},
+		opToPresentationLinks: [],
+		presentationsTargets: []
+	};
+	const sourceFile = new Project({ useInMemoryFileSystem: true }).createSourceFile("feature.ts", code);
+	const extractRefs = (obj, propName, allowKeyOnly = false) => {
+		const refs = [];
+		const prop = obj.getProperty(propName);
+		if (prop && Node.isPropertyAssignment(prop)) {
+			const init = prop.getInitializer();
+			if (init && Node.isArrayLiteralExpression(init)) {
+				for (const elem of init.getElements()) if (Node.isObjectLiteralExpression(elem)) {
+					const keyText = getTextFromProp(elem, "key");
+					const verText = getTextFromProp(elem, "version");
+					if (keyText && verText) refs.push({
+						key: keyText,
+						version: verText
+					});
+					else if (keyText && allowKeyOnly) refs.push({
+						key: keyText,
+						version: "1.0.0"
+					});
+				}
+			}
+		}
+		return refs;
+	};
+	const callExpressions = sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression);
+	for (const call of callExpressions) if ([
+		"defineFeature",
+		"defineAppConfig",
+		"defineAppBlueprint"
+	].includes(call.getExpression().getText())) {
+		const args = call.getArguments();
+		if (args.length > 0 && Node.isObjectLiteralExpression(args[0])) {
+			const obj = args[0];
+			result.operations.push(...extractRefs(obj, "operations"));
+			result.events.push(...extractRefs(obj, "events"));
+			result.presentations.push(...extractRefs(obj, "presentations"));
+			result.experiments.push(...extractRefs(obj, "experiments"));
+			const capsProp = obj.getProperty("capabilities");
+			if (capsProp && Node.isPropertyAssignment(capsProp)) {
+				const capsObj = capsProp.getInitializer();
+				if (capsObj && Node.isObjectLiteralExpression(capsObj)) {
+					result.capabilities.provides.push(...extractRefs(capsObj, "provides"));
+					result.capabilities.requires.push(...extractRefs(capsObj, "requires", true));
+				}
+			}
+			const linksProp = obj.getProperty("opToPresentation");
+			if (linksProp && Node.isPropertyAssignment(linksProp)) {
+				const linksArr = linksProp.getInitializer();
+				if (linksArr && Node.isArrayLiteralExpression(linksArr)) linksArr.getElements().forEach((link) => {
+					if (Node.isObjectLiteralExpression(link)) {
+						const opProp = link.getProperty("op");
+						const presProp = link.getProperty("pres");
+						let opRef;
+						let presRef;
+						if (opProp && Node.isPropertyAssignment(opProp)) {
+							const val = opProp.getInitializer();
+							if (val && Node.isObjectLiteralExpression(val)) {
+								const key = getTextFromProp(val, "key");
+								const version = getTextFromProp(val, "version");
+								if (key && version) opRef = {
+									key,
+									version
+								};
+							}
+						}
+						if (presProp && Node.isPropertyAssignment(presProp)) {
+							const val = presProp.getInitializer();
+							if (val && Node.isObjectLiteralExpression(val)) {
+								const key = getTextFromProp(val, "key");
+								const version = getTextFromProp(val, "version");
+								if (key && version) presRef = {
+									key,
+									version
+								};
+							}
+						}
+						if (opRef && presRef) result.opToPresentationLinks.push({
+							op: opRef,
+							pres: presRef
+						});
+					}
+				});
+			}
+			extractLinks(obj, result.opToPresentationLinks);
+			const targetsProp = obj.getProperty("presentationsTargets");
+			if (targetsProp && Node.isPropertyAssignment(targetsProp)) {
+				const targetsArr = targetsProp.getInitializer();
+				if (targetsArr && Node.isArrayLiteralExpression(targetsArr)) targetsArr.getElements().forEach((targetBlock) => {
+					if (Node.isObjectLiteralExpression(targetBlock)) {
+						const key = getTextFromProp(targetBlock, "key");
+						const version = getTextFromProp(targetBlock, "version");
+						const targetsList = getTargetsList(targetBlock, "targets");
+						if (key && version && targetsList) result.presentationsTargets.push({
+							key,
+							version,
+							targets: targetsList
+						});
+					}
+				});
+			}
+			extractPresentationTargets(obj, result.presentationsTargets);
+		}
+	}
+	return result;
+}
+function extractLinks(obj, opToPresentationLinks) {
+	const interactionsProp = obj.getProperty("interactions");
+	if (interactionsProp && Node.isPropertyAssignment(interactionsProp)) {
+		const interactionsArr = interactionsProp.getInitializer();
+		if (interactionsArr && Node.isArrayLiteralExpression(interactionsArr)) interactionsArr.getElements().forEach((interaction) => {
+			if (Node.isObjectLiteralExpression(interaction)) {
+				const triggerProp = interaction.getProperty("trigger");
+				const triggerObj = triggerProp && Node.isPropertyAssignment(triggerProp) && triggerProp.getInitializer();
+				const actionProp = interaction.getProperty("action");
+				const actionObj = actionProp && Node.isPropertyAssignment(actionProp) && actionProp.getInitializer();
+				if (triggerObj && Node.isObjectLiteralExpression(triggerObj) && actionObj && Node.isObjectLiteralExpression(actionObj)) {
+					const triggerType = getTextFromProp(triggerObj, "type");
+					const actionType = getTextFromProp(actionObj, "type");
+					if (triggerType === "presentation" && actionType === "operation") {
+						const presRef = extractNestedRef(triggerObj, "presentation");
+						const opRef = extractNestedRef(actionObj, "operation");
+						if (presRef && opRef) opToPresentationLinks.push({
+							op: opRef,
+							pres: presRef
+						});
+					}
+				}
+			}
+		});
+	}
+}
+function extractNestedRef(obj, propName) {
+	const prop = obj.getProperty(propName);
+	if (prop && Node.isPropertyAssignment(prop)) {
+		const val = prop.getInitializer();
+		if (val && Node.isObjectLiteralExpression(val)) {
+			const key = getTextFromProp(val, "key");
+			const version = getTextFromProp(val, "version");
+			if (key && version) return {
+				key,
+				version
+			};
+		}
+	}
+}
+function extractPresentationTargets(obj, presentationsTargets) {
+	const presentationsProp = obj.getProperty("presentations");
+	if (presentationsProp && Node.isPropertyAssignment(presentationsProp)) {
+		const presentationsArr = presentationsProp.getInitializer();
+		if (presentationsArr && Node.isArrayLiteralExpression(presentationsArr)) {
+			for (const elem of presentationsArr.getElements()) if (Node.isObjectLiteralExpression(elem)) {
+				const keyText = getTextFromProp(elem, "key");
+				const verText = getTextFromProp(elem, "version");
+				const targetsList = getTargetsList(elem, "targets");
+				if (keyText && verText && targetsList) presentationsTargets.push({
+					key: keyText,
+					version: verText,
+					targets: targetsList
+				});
+			}
+		}
+	}
+}
+function getTextFromProp(obj, propName) {
+	const prop = obj.getProperty(propName);
+	if (prop && Node.isPropertyAssignment(prop)) {
+		const init = prop.getInitializer();
+		if (init && Node.isStringLiteral(init)) return init.getLiteralText();
+	}
+}
+function getTargetsList(obj, propName) {
+	const prop = obj.getProperty(propName);
+	if (prop && Node.isPropertyAssignment(prop)) {
+		const init = prop.getInitializer();
+		if (init && Node.isArrayLiteralExpression(init)) return init.getElements().map((e) => {
+			if (Node.isStringLiteral(e)) return e.getLiteralText();
+			return { target: e.getText() };
+		});
+	}
+}
+
+//#endregion
+export { extractFeatureRefs };
+//# sourceMappingURL=feature-extractor.js.map