@contractspec/module.workspace 1.44.0 → 1.45.0

package/dist/analysis/index.js

@@ -1,5 +1,6 @@
 import { extractEmittedEvents, extractPolicyRefs, extractTestRefs, inferSpecTypeFromFilePath, scanAllSpecsFromSource, scanSpecSource } from "./spec-scan.js";
 import { isFeatureFile, scanFeatureSource } from "./feature-scan.js";
+import { isExampleFile, scanExampleSource } from "./example-scan.js";
 import { SpecGroupingStrategies, filterFeatures, filterSpecs, getUniqueSpecDomains, getUniqueSpecOwners, getUniqueSpecTags, groupSpecs, groupSpecsToArray } from "./grouping.js";
 import { computeSemanticDiff } from "./diff/semantic.js";
 import { computeFieldDiff, computeFieldsDiff, computeIoDiff, isBreakingChange } from "./diff/deep-diff.js";
@@ -12,3 +13,4 @@ import "./snapshot/index.js";
 import { BREAKING_RULES, DEFAULT_RULES, INFO_RULES, NON_BREAKING_RULES, findMatchingRule, getRulesBySeverity } from "./impact/rules.js";
 import { classifyImpact } from "./impact/classifier.js";
 import "./impact/index.js";
+import { loadSpecFromSource } from "./spec-parser.js";

package/dist/analysis/snapshot/normalizer.d.ts

@@ -25,7 +25,7 @@ declare function computeHash(value: unknown): string;
  */
 declare function sortSpecs<T extends {
   key: string;
-  version: number;
+  version: string;
 }>(specs: T[]): T[];
 /**
  * Sort field snapshots by name for deterministic ordering.

package/dist/analysis/snapshot/normalizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalizer.d.ts","names":[],"sources":["../../../src/analysis/snapshot/normalizer.ts"],"sourcesContent":[],"mappings":";;AAeA;AA+BA;AAOA;AAQA;AAaA;;;;;;;iBA3DgB,cAAA;;;;iBA+BA,eAAA;;;;iBAOA,WAAA;;;;iBAQA;;;UACP,MACN;;;;iBAWa,UAAA,SACN,0BACP"}
+{"version":3,"file":"normalizer.d.ts","names":[],"sources":["../../../src/analysis/snapshot/normalizer.ts"],"sourcesContent":[],"mappings":";;AAgBA;AA+BA;AAOA;AAQA;AAaA;;;;;;;iBA3DgB,cAAA;;;;iBA+BA,eAAA;;;;iBAOA,WAAA;;;;iBAQA;;;UACP,MACN;;;;iBAWa,UAAA,SACN,0BACP"}

package/dist/analysis/snapshot/normalizer.js

@@ -1,4 +1,5 @@
 import { createHash } from "crypto";
+import { compareVersions } from "compare-versions";
 
 //#region src/analysis/snapshot/normalizer.ts
 /**
@@ -48,7 +49,7 @@ function sortSpecs(specs) {
 	return [...specs].sort((a, b) => {
 		const keyCompare = a.key.localeCompare(b.key);
 		if (keyCompare !== 0) return keyCompare;
-		return a.version - b.version;
+		return compareVersions(a.version, b.version);
 	});
 }
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"normalizer.js","names":["normalized: Record<string, unknown>","sorted: Record<string, unknown>"],"sources":["../../../src/analysis/snapshot/normalizer.ts"],"sourcesContent":["/**\n * JSON normalization utilities for deterministic snapshots.\n *\n * Ensures that snapshots are stable across ordering, whitespace,\n * and other non-semantic differences.\n */\n\nimport { createHash } from 'crypto';\n\n/**\n * Normalize a value for deterministic JSON serialization.\n * - Sorts object keys alphabetically\n * - Removes undefined values\n * - Preserves null values\n */\nexport function normalizeValue(value: unknown): unknown {\n  if (value === null || value === undefined) {\n    return value === null ? null : undefined;\n  }\n\n  if (Array.isArray(value)) {\n    return value.map(normalizeValue);\n  }\n\n  if (typeof value === 'object') {\n    const obj = value as Record<string, unknown>;\n    const sortedKeys = Object.keys(obj).sort();\n    const normalized: Record<string, unknown> = {};\n\n    for (const key of sortedKeys) {\n      const normalizedValue = normalizeValue(obj[key]);\n      // Only include defined values\n      if (normalizedValue !== undefined) {\n        normalized[key] = normalizedValue;\n      }\n    }\n\n    return normalized;\n  }\n\n  return value;\n}\n\n/**\n * Serialize a value to deterministic JSON string.\n */\nexport function toCanonicalJson(value: unknown): string {\n  return JSON.stringify(normalizeValue(value), null, 0);\n}\n\n/**\n * Compute a SHA-256 hash of canonical JSON representation.\n */\nexport function computeHash(value: unknown): string {\n  const canonical = toCanonicalJson(value);\n  return createHash('sha256').update(canonical).digest('hex').slice(0, 16);\n}\n\n/**\n * Sort specs by key and version for deterministic ordering.\n */\nexport function sortSpecs<T extends { key: string; version: number }>(\n  specs: T[]\n): T[] {\n  return [...specs].sort((a, b) => {\n    const keyCompare = a.key.localeCompare(b.key);\n    if (keyCompare !== 0) return keyCompare;\n    return a.version - b.version;\n  });\n}\n\n/**\n * Sort field snapshots by name for deterministic ordering.\n */\nexport function sortFields(\n  fields: Record<string, unknown>\n): Record<string, unknown> {\n  const sorted: Record<string, unknown> = {};\n  const keys = Object.keys(fields).sort();\n  for (const key of keys) {\n    sorted[key] = fields[key];\n  }\n  return sorted;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAeA,SAAgB,eAAe,OAAyB;AACtD,KAAI,UAAU,QAAQ,UAAU,OAC9B,QAAO,UAAU,OAAO,OAAO;AAGjC,KAAI,MAAM,QAAQ,MAAM,CACtB,QAAO,MAAM,IAAI,eAAe;AAGlC,KAAI,OAAO,UAAU,UAAU;EAC7B,MAAM,MAAM;EACZ,MAAM,aAAa,OAAO,KAAK,IAAI,CAAC,MAAM;EAC1C,MAAMA,aAAsC,EAAE;AAE9C,OAAK,MAAM,OAAO,YAAY;GAC5B,MAAM,kBAAkB,eAAe,IAAI,KAAK;AAEhD,OAAI,oBAAoB,OACtB,YAAW,OAAO;;AAItB,SAAO;;AAGT,QAAO;;;;;AAMT,SAAgB,gBAAgB,OAAwB;AACtD,QAAO,KAAK,UAAU,eAAe,MAAM,EAAE,MAAM,EAAE;;;;;AAMvD,SAAgB,YAAY,OAAwB;CAClD,MAAM,YAAY,gBAAgB,MAAM;AACxC,QAAO,WAAW,SAAS,CAAC,OAAO,UAAU,CAAC,OAAO,MAAM,CAAC,MAAM,GAAG,GAAG;;;;;AAM1E,SAAgB,UACd,OACK;AACL,QAAO,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM;EAC/B,MAAM,aAAa,EAAE,IAAI,cAAc,EAAE,IAAI;AAC7C,MAAI,eAAe,EAAG,QAAO;AAC7B,SAAO,EAAE,UAAU,EAAE;GACrB;;;;;AAMJ,SAAgB,WACd,QACyB;CACzB,MAAMC,SAAkC,EAAE;CAC1C,MAAM,OAAO,OAAO,KAAK,OAAO,CAAC,MAAM;AACvC,MAAK,MAAM,OAAO,KAChB,QAAO,OAAO,OAAO;AAEvB,QAAO"}
+{"version":3,"file":"normalizer.js","names":["normalized: Record<string, unknown>","sorted: Record<string, unknown>"],"sources":["../../../src/analysis/snapshot/normalizer.ts"],"sourcesContent":["/**\n * JSON normalization utilities for deterministic snapshots.\n *\n * Ensures that snapshots are stable across ordering, whitespace,\n * and other non-semantic differences.\n */\n\nimport { createHash } from 'crypto';\nimport { compareVersions } from 'compare-versions';\n\n/**\n * Normalize a value for deterministic JSON serialization.\n * - Sorts object keys alphabetically\n * - Removes undefined values\n * - Preserves null values\n */\nexport function normalizeValue(value: unknown): unknown {\n  if (value === null || value === undefined) {\n    return value === null ? null : undefined;\n  }\n\n  if (Array.isArray(value)) {\n    return value.map(normalizeValue);\n  }\n\n  if (typeof value === 'object') {\n    const obj = value as Record<string, unknown>;\n    const sortedKeys = Object.keys(obj).sort();\n    const normalized: Record<string, unknown> = {};\n\n    for (const key of sortedKeys) {\n      const normalizedValue = normalizeValue(obj[key]);\n      // Only include defined values\n      if (normalizedValue !== undefined) {\n        normalized[key] = normalizedValue;\n      }\n    }\n\n    return normalized;\n  }\n\n  return value;\n}\n\n/**\n * Serialize a value to deterministic JSON string.\n */\nexport function toCanonicalJson(value: unknown): string {\n  return JSON.stringify(normalizeValue(value), null, 0);\n}\n\n/**\n * Compute a SHA-256 hash of canonical JSON representation.\n */\nexport function computeHash(value: unknown): string {\n  const canonical = toCanonicalJson(value);\n  return createHash('sha256').update(canonical).digest('hex').slice(0, 16);\n}\n\n/**\n * Sort specs by key and version for deterministic ordering.\n */\nexport function sortSpecs<T extends { key: string; version: string }>(\n  specs: T[]\n): T[] {\n  return [...specs].sort((a, b) => {\n    const keyCompare = a.key.localeCompare(b.key);\n    if (keyCompare !== 0) return keyCompare;\n    return compareVersions(a.version, b.version);\n  });\n}\n\n/**\n * Sort field snapshots by name for deterministic ordering.\n */\nexport function sortFields(\n  fields: Record<string, unknown>\n): Record<string, unknown> {\n  const sorted: Record<string, unknown> = {};\n  const keys = Object.keys(fields).sort();\n  for (const key of keys) {\n    sorted[key] = fields[key];\n  }\n  return sorted;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,SAAgB,eAAe,OAAyB;AACtD,KAAI,UAAU,QAAQ,UAAU,OAC9B,QAAO,UAAU,OAAO,OAAO;AAGjC,KAAI,MAAM,QAAQ,MAAM,CACtB,QAAO,MAAM,IAAI,eAAe;AAGlC,KAAI,OAAO,UAAU,UAAU;EAC7B,MAAM,MAAM;EACZ,MAAM,aAAa,OAAO,KAAK,IAAI,CAAC,MAAM;EAC1C,MAAMA,aAAsC,EAAE;AAE9C,OAAK,MAAM,OAAO,YAAY;GAC5B,MAAM,kBAAkB,eAAe,IAAI,KAAK;AAEhD,OAAI,oBAAoB,OACtB,YAAW,OAAO;;AAItB,SAAO;;AAGT,QAAO;;;;;AAMT,SAAgB,gBAAgB,OAAwB;AACtD,QAAO,KAAK,UAAU,eAAe,MAAM,EAAE,MAAM,EAAE;;;;;AAMvD,SAAgB,YAAY,OAAwB;CAClD,MAAM,YAAY,gBAAgB,MAAM;AACxC,QAAO,WAAW,SAAS,CAAC,OAAO,UAAU,CAAC,OAAO,MAAM,CAAC,MAAM,GAAG,GAAG;;;;;AAM1E,SAAgB,UACd,OACK;AACL,QAAO,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM;EAC/B,MAAM,aAAa,EAAE,IAAI,cAAc,EAAE,IAAI;AAC7C,MAAI,eAAe,EAAG,QAAO;AAC7B,SAAO,gBAAgB,EAAE,SAAS,EAAE,QAAQ;GAC5C;;;;;AAMJ,SAAgB,WACd,QACyB;CACzB,MAAMC,SAAkC,EAAE;CAC1C,MAAM,OAAO,OAAO,KAAK,OAAO,CAAC,MAAM;AACvC,MAAK,MAAM,OAAO,KAChB,QAAO,OAAO,OAAO;AAEvB,QAAO"}

package/dist/analysis/snapshot/snapshot.js

@@ -31,7 +31,7 @@ function generateSnapshot(specs, options = {}) {
 	const sortedSpecs = sortSpecs(snapshots);
 	const hash = computeHash({ specs: sortedSpecs });
 	return {
-		version: 1,
+		version: "1.0.0",
 		generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
 		specs: sortedSpecs,
 		hash

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

@@ -1 +1 @@
-{"version":3,"file":"snapshot.js","names":["snapshots: SpecSnapshot[]","fields: Record<string, FieldSnapshot>"],"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,\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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"}
+{"version":3,"file":"snapshot.js","names":["snapshots: SpecSnapshot[]","fields: Record<string, FieldSnapshot>"],"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/snapshot/types.d.ts

@@ -1,10 +1,7 @@
+import { EventRef } from "@contractspec/lib.contracts";
+
 //#region src/analysis/snapshot/types.d.ts
-/**
- * Canonical contract snapshot types.
- *
- * These types define the normalized, deterministic representation
- * of contracts for comparison and impact detection.
- */
+
 /** Field type in a schema */
 type FieldType = 'string' | 'number' | 'boolean' | 'object' | 'array' | 'enum' | 'union' | 'literal' | 'date' | 'unknown';
 /** Schema field definition */
@@ -34,22 +31,19 @@ interface HttpBindingSnapshot {
 interface OperationSnapshot {
   type: 'operation';
   key: string;
-  version: number;
+  version: string;
   kind: 'command' | 'query';
   stability: string;
   http?: HttpBindingSnapshot;
   io: IoSnapshot;
   authLevel?: string;
-  emittedEvents?: {
-    key: string;
-    version: number;
-  }[];
+  emittedEvents?: EventRef[];
 }
 /** Event payload snapshot */
 interface EventSnapshot {
   type: 'event';
   key: string;
-  version: number;
+  version: string;
   stability: string;
   payload: Record<string, FieldSnapshot>;
 }
@@ -58,7 +52,7 @@ type SpecSnapshot = OperationSnapshot | EventSnapshot;
 /** Full contract snapshot for a workspace */
 interface ContractSnapshot {
   /** Schema version for forward compatibility */
-  version: 1;
+  version: '1.0.0';
   /** Generation timestamp (ISO 8601) */
   generatedAt: string;
   /** Git commit SHA if available */

package/dist/analysis/snapshot/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/analysis/snapshot/types.ts"],"sourcesContent":[],"mappings":";;AAQA;AAaA;;;;;AAUe,KAvBH,SAAA,GAuBG,QAAA,GAAA,QAAA,GAAA,SAAA,GAAA,QAAA,GAAA,OAAA,GAAA,MAAA,GAAA,OAAA,GAAA,SAAA,GAAA,MAAA,GAAA,SAAA;;AAIE,UAdA,aAAA,CAcU;EACH,IAAA,EAAA,MAAA;EAAf,IAAA,EAbD,SAaC;EACgB,QAAA,EAAA,OAAA;EAAf,QAAA,EAAA,OAAA;EAAM,WAAA,CAAA,EAAA,MAAA;EAIC,UAAA,CAAA,EAAA,MAAA,EAAA;EAMA,YAAA,CAAA,EAAA,OAAiB;EAajB,KAAA,CAAA,EA/BP,aA+BoB;EASlB,UAAA,CAAA,EAvCG,MAuCS,CAAA,MAAA,EAvCM,aAuCH,CAAA;EAGV,UAAA,CAAA,EAzCF,aAyCkB,EAAA;AAcjC;;UAnDiB,UAAA;SACR,eAAe;UACd,eAAe;;;UAIR,mBAAA;;;;;UAMA,iBAAA;;;;;;SAMR;MACH;;;;;;;;UAMW,aAAA;;;;;WAKN,eAAe;;;KAId,YAAA,GAAe,oBAAoB;;UAG9B,gBAAA;;;;;;;;SAQR;;;;;UAMQ,eAAA"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/analysis/snapshot/types.ts"],"sourcesContent":[],"mappings":";;;;;AAgCe,KAtBH,SAAA,GAsBG,QAAA,GAAA,QAAA,GAAA,SAAA,GAAA,QAAA,GAAA,OAAA,GAAA,MAAA,GAAA,OAAA,GAAA,SAAA,GAAA,MAAA,GAAA,SAAA;;AACa,UAVX,aAAA,CAUW;EAIX,IAAA,EAAA,MAAA;EACO,IAAA,EAbhB,SAagB;EAAf,QAAA,EAAA,OAAA;EACgB,QAAA,EAAA,OAAA;EAAf,WAAA,CAAA,EAAA,MAAA;EAAM,UAAA,CAAA,EAAA,MAAA,EAAA;EAIC,YAAA,CAAA,EAAA,OAAmB;EAMnB,KAAA,CAAA,EAlBP,aAkBwB;EAMzB,UAAA,CAAA,EAvBM,MAuBN,CAAA,MAAA,EAvBqB,aAuBrB,CAAA;EACH,UAAA,CAAA,EAvBS,aAuBT,EAAA;;;AAMW,UAzBA,UAAA,CAyBa;EASlB,KAAA,EAjCH,MAiCG,CAAA,MAAY,EAjCA,aAiCG,CAAA;EAGV,MAAA,EAnCP,MAmCO,CAAA,MAAgB,EAnCR,aA2ChB,CAAA;AAMT;;UA7CiB,mBAAA;;;;;UAMA,iBAAA;;;;;;SAMR;MACH;;kBAEY;;;UAID,aAAA;;;;;WAKN,eAAe;;;KAId,YAAA,GAAe,oBAAoB;;UAG9B,gBAAA;;;;;;;;SAQR;;;;;UAMQ,eAAA"}

package/dist/analysis/spec-parser.d.ts

@@ -0,0 +1,11 @@
+import { ParsedSpec } from "../types/llm-types.js";
+
+//#region src/analysis/spec-parser.d.ts
+
+/**
+ * Load and parse specs from a source file.
+ */
+declare function loadSpecFromSource(filePath: string): Promise<ParsedSpec[]>;
+//#endregion
+export { loadSpecFromSource };
+//# sourceMappingURL=spec-parser.d.ts.map

package/dist/analysis/spec-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-parser.d.ts","names":[],"sources":["../../src/analysis/spec-parser.ts"],"sourcesContent":[],"mappings":";;;;;;;iBAoBsB,kBAAA,oBAEnB,QAAQ"}

package/dist/analysis/spec-parser.js

@@ -0,0 +1,89 @@
+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

@@ -0,0 +1 @@
+{"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-scan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec-scan.d.ts","names":[],"sources":["../../src/analysis/spec-scan.ts"],"sourcesContent":[],"mappings":";;;;AAoHA;AAgCA;AA0BA;AAoMA;iBAjWgB,yBAAA,oBAA6C;;;;iBA8C7C,cAAA,kCAAgD;;;;;iBAqDhD,oBAAA,gBAAoC;;;;iBAgCpC,iBAAA,gBAAiC;;;;iBA0BjC,eAAA,gBAA+B;;;;;iBAoM/B,sBAAA,kCAGb"}
+{"version":3,"file":"spec-scan.d.ts","names":[],"sources":["../../src/analysis/spec-scan.ts"],"sourcesContent":[],"mappings":";;;;AAyHA;AAgCA;AA0BA;AAsMA;iBAxWgB,yBAAA,oBAA6C;;;;iBA8C7C,cAAA,kCAAgD;;;;;iBA0DhD,oBAAA,gBAAoC;;;;iBAgCpC,iBAAA,gBAAiC;;;;iBA0BjC,eAAA,gBAA+B;;;;;iBAsM/B,sBAAA,kCAGb"}

package/dist/analysis/spec-scan.js

@@ -29,11 +29,13 @@ function scanSpecSource(code, filePath) {
 	const specType = inferSpecTypeFromFilePath(filePath);
 	const key = matchStringField(code, "key");
 	const description = matchStringField(code, "description");
+	const goal = matchStringField(code, "goal");
+	const context = matchStringField(code, "context");
 	const stabilityRaw = matchStringField(code, "stability");
 	const stability = isStability(stabilityRaw) ? stabilityRaw : void 0;
 	const owners = matchStringArrayField(code, "owners");
 	const tags = matchStringArrayField(code, "tags");
-	const version = matchNumberField(code, "version");
+	const version = matchVersionField(code, "version");
 	const kind = inferOperationKind(code);
 	const hasMeta = /meta\s*:\s*{/.test(code);
 	const hasIo = /\bio\s*:\s*{/.test(code);
@@ -49,6 +51,8 @@ function scanSpecSource(code, filePath) {
 		specType,
 		key: key ?? void 0,
 		description: description ?? void 0,
+		goal: goal ?? void 0,
+		context: context ?? void 0,
 		stability,
 		owners,
 		tags,
@@ -62,7 +66,8 @@ function scanSpecSource(code, filePath) {
 		hasDefinition,
 		emittedEvents,
 		policyRefs,
-		testRefs
+		testRefs,
+		sourceBlock: code
 	};
 }
 /**
@@ -71,12 +76,16 @@ function scanSpecSource(code, filePath) {
 */
 function extractEmittedEvents(code) {
 	const events = [];
-	const inlinePattern = /\{\s*key:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)/g;
+	const inlinePattern = /\{\s*key:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(?:['"]([^'"]+)['"]|(\d+(?:\.\d+)*))/g;
 	let match;
-	while ((match = inlinePattern.exec(code)) !== null) if (match[1] && match[2]) events.push({
-		key: match[1],
-		version: Number(match[2])
-	});
+	while ((match = inlinePattern.exec(code)) !== null) {
+		const key = match[1];
+		const version = match[2] || match[3];
+		if (key && version) events.push({
+			key,
+			version
+		});
+	}
 	const refPattern = /\{\s*ref:\s*(\w+)/g;
 	while ((match = refPattern.exec(code)) !== null) if (match[1] && !match[1].startsWith("when")) {}
 	return events.length > 0 ? events : void 0;
@@ -86,14 +95,18 @@ function extractEmittedEvents(code) {
 */
 function extractPolicyRefs(code) {
 	const policies = [];
-	const policyPattern = /\{\s*key:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)/g;
+	const policyPattern = /\{\s*key:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(?:['"]([^'"]+)['"]|(\d+(?:\.\d+)*))/g;
 	const policySectionMatch = code.match(/policies\s*:\s*\[([\s\S]*?)\]/);
 	if (policySectionMatch?.[1]) {
 		let match;
-		while ((match = policyPattern.exec(policySectionMatch[1])) !== null) if (match[1] && match[2]) policies.push({
-			key: match[1],
-			version: Number(match[2])
-		});
+		while ((match = policyPattern.exec(policySectionMatch[1])) !== null) {
+			const key = match[1];
+			const version = match[2] || match[3];
+			if (key && version) policies.push({
+				key,
+				version
+			});
+		}
 	}
 	return policies.length > 0 ? policies : void 0;
 }
@@ -104,12 +117,16 @@ function extractTestRefs(code) {
 	const tests = [];
 	const testsSectionMatch = code.match(/tests\s*:\s*\[([\s\S]*?)\]/);
 	if (testsSectionMatch?.[1]) {
-		const refPattern = /\{\s*key:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)/g;
+		const refPattern = /\{\s*key:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(?:['"]([^'"]+)['"]|(\d+(?:\.\d+)*))/g;
 		let match;
-		while ((match = refPattern.exec(testsSectionMatch[1])) !== null) if (match[1] && match[2]) tests.push({
-			key: match[1],
-			version: Number(match[2])
-		});
+		while ((match = refPattern.exec(testsSectionMatch[1])) !== null) {
+			const key = match[1];
+			const version = match[2] || match[3];
+			if (key && version) tests.push({
+				key,
+				version
+			});
+		}
 	}
 	return tests.length > 0 ? tests : void 0;
 }
@@ -117,12 +134,11 @@ function matchStringField(code, field) {
 	const regex = /* @__PURE__ */ new RegExp(`${escapeRegex(field)}\\s*:\\s*['"]([^'"]+)['"]`);
 	return code.match(regex)?.[1] ?? null;
 }
-function matchNumberField(code, field) {
-	const regex = /* @__PURE__ */ new RegExp(`${escapeRegex(field)}\\s*:\\s*(\\d+)`);
+function matchVersionField(code, field) {
+	const regex = /* @__PURE__ */ new RegExp(`${escapeRegex(field)}\\s*:\\s*(?:['"]([^'"]+)['"]|(\\d+(?:\\.\\d+)*))`);
 	const match = code.match(regex);
-	if (!match?.[1]) return null;
-	const parsed = Number(match[1]);
-	return Number.isFinite(parsed) ? parsed : null;
+	if (match?.[1]) return match[1];
+	if (match?.[2]) return match[2];
 }
 function matchStringArrayField(code, field) {
 	const regex = /* @__PURE__ */ new RegExp(`${escapeRegex(field)}\\s*:\\s*\\[([\\s\\S]*?)\\]`);
@@ -163,8 +179,8 @@ function inferOperationKindFromBlock(block) {
 */
 function extractMetaFromBlock(block) {
 	const key = matchStringField(block, "key");
-	const version = matchNumberField(block, "version");
-	if (key && version !== null) return {
+	const version = matchVersionField(block, "version");
+	if (key && version !== void 0) return {
 		key,
 		version
 	};
@@ -301,6 +317,8 @@ function scanAllSpecsFromSource(code, filePath) {
 			const meta = extractMetaFromBlock(block);
 			if (!meta) continue;
 			const description = matchStringField(block, "description");
+			const goal = matchStringField(block, "goal");
+			const context = matchStringField(block, "context");
 			const stabilityRaw = matchStringField(block, "stability");
 			const stability = isStability(stabilityRaw) ? stabilityRaw : void 0;
 			const owners = matchStringArrayField(block, "owners");
@@ -321,6 +339,8 @@ function scanAllSpecsFromSource(code, filePath) {
 				key: meta.key,
 				version: meta.version,
 				description: description ?? void 0,
+				goal: goal ?? void 0,
+				context: context ?? void 0,
 				stability,
 				owners,
 				tags,
@@ -333,13 +353,17 @@ function scanAllSpecsFromSource(code, filePath) {
 				hasDefinition,
 				emittedEvents,
 				policyRefs,
-				testRefs
+				testRefs,
+				sourceBlock: block
 			});
 		}
 	}
 	if (results.length === 0 && baseSpecType !== "unknown") {
 		const fallback = scanSpecSource(code, filePath);
-		if (fallback.key && fallback.version !== void 0) results.push(fallback);
+		if (fallback.key && fallback.version !== void 0) results.push({
+			...fallback,
+			sourceBlock: code
+		});
 	}
 	return results;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"spec-scan.js","names":["events: RefInfo[]","policies: RefInfo[]","tests: RefInfo[]","results: SpecScanResult[]"],"sources":["../../src/analysis/spec-scan.ts"],"sourcesContent":["/**\n * Spec source scanning utilities.\n * Extracted from cli-contractspec/src/utils/spec-scan.ts\n */\n\nimport type {\n  AnalyzedOperationKind,\n  AnalyzedSpecType,\n  RefInfo,\n  SpecScanResult,\n} from '../types/analysis-types';\nimport type { Stability } from '../types/spec-types';\n\n/**\n * Infer spec type from file path based on naming conventions.\n * Supports all contract types from @contractspec/lib.contracts.\n */\nexport function inferSpecTypeFromFilePath(filePath: string): AnalyzedSpecType {\n  // Check more specific patterns first\n  // Operation patterns: .contracts. OR /contracts/ directory\n  if (\n    filePath.includes('.operations.') ||\n    filePath.includes('/operations/') ||\n    filePath.includes('.operation.') ||\n    filePath.includes('/operation/')\n  )\n    return 'operation';\n\n  // Event patterns: .event. OR /events/ OR /events.ts\n  if (\n    filePath.includes('.event.') ||\n    filePath.includes('/events/') ||\n    filePath.endsWith('/events.ts')\n  )\n    return 'event';\n\n  // Presentation patterns: .presentation. OR /presentations/ OR /presentations.ts\n  if (\n    filePath.includes('.presentation.') ||\n    filePath.includes('/presentations/') ||\n    filePath.endsWith('/presentations.ts')\n  )\n    return 'presentation';\n\n  if (filePath.includes('.feature.')) return 'feature';\n  if (filePath.includes('.capability.')) return 'capability';\n  if (filePath.includes('.data-view.')) return 'data-view';\n  if (filePath.includes('.form.')) return 'form';\n  if (filePath.includes('.migration.')) return 'migration';\n  if (filePath.includes('.workflow.')) return 'workflow';\n  if (filePath.includes('.experiment.')) return 'experiment';\n  if (filePath.includes('.integration.')) return 'integration';\n  if (filePath.includes('.knowledge.')) return 'knowledge';\n  if (filePath.includes('.telemetry.')) return 'telemetry';\n  if (filePath.includes('.app-config.')) return 'app-config';\n  if (filePath.includes('.policy.')) return 'policy';\n  if (filePath.includes('.test-spec.')) return 'test-spec';\n  return 'unknown';\n}\n\n/**\n * Scan spec source code to extract metadata without executing it.\n */\nexport function scanSpecSource(code: string, filePath: string): SpecScanResult {\n  const specType = inferSpecTypeFromFilePath(filePath);\n\n  const key = matchStringField(code, 'key');\n  const description = matchStringField(code, 'description');\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  const version = matchNumberField(code, 'version');\n  const kind = inferOperationKind(code);\n\n  const hasMeta = /meta\\s*:\\s*{/.test(code);\n  const hasIo = /\\bio\\s*:\\s*{/.test(code);\n  const hasPolicy = /\\bpolicy\\s*:\\s*{/.test(code);\n  const hasPayload = /\\bpayload\\s*:\\s*{/.test(code);\n  const hasContent = /\\bcontent\\s*:\\s*{/.test(code);\n  const hasDefinition = /\\bdefinition\\s*:\\s*{/.test(code);\n\n  // Extract references from operations\n  const emittedEvents =\n    specType === 'operation' ? extractEmittedEvents(code) : undefined;\n  const policyRefs =\n    specType === 'operation' ? extractPolicyRefs(code) : undefined;\n  const testRefs = extractTestRefs(code);\n\n  return {\n    filePath,\n    specType,\n    key: key ?? undefined,\n    description: description ?? undefined,\n    stability,\n    owners,\n    tags,\n    version: version ?? undefined,\n    kind,\n    hasMeta,\n    hasIo,\n    hasPolicy,\n    hasPayload,\n    hasContent,\n    hasDefinition,\n    emittedEvents,\n    policyRefs,\n    testRefs,\n  };\n}\n\n/**\n * Extract emitted event refs from operation spec source.\n * Looks for sideEffects.emits array entries.\n */\nexport function extractEmittedEvents(code: string): RefInfo[] | undefined {\n  const events: RefInfo[] = [];\n\n  // Match inline emit declarations: { key: 'x', version: N, ... }\n  const inlinePattern = /\\{\\s*key:\\s*['\"]([^'\"]+)['\"]\\s*,\\s*version:\\s*(\\d+)/g;\n  let match;\n  while ((match = inlinePattern.exec(code)) !== null) {\n    if (match[1] && match[2]) {\n      events.push({\n        key: match[1],\n        version: Number(match[2]),\n      });\n    }\n  }\n\n  // Match ref pattern: { ref: SomeEventSpec, ... }\n  // We can't fully resolve these without execution, but we can note they exist\n  const refPattern = /\\{\\s*ref:\\s*(\\w+)/g;\n  while ((match = refPattern.exec(code)) !== null) {\n    // Store a placeholder - actual resolution needs runtime\n    if (match[1] && !match[1].startsWith('when')) {\n      // We can't extract key/version from a variable ref statically\n      // This is noted for completeness but won't be fully resolvable\n    }\n  }\n\n  return events.length > 0 ? events : undefined;\n}\n\n/**\n * Extract policy refs from operation spec source.\n */\nexport function extractPolicyRefs(code: string): RefInfo[] | undefined {\n  const policies: RefInfo[] = [];\n\n  // Match policy ref pattern in policies array\n  const policyPattern = /\\{\\s*key:\\s*['\"]([^'\"]+)['\"]\\s*,\\s*version:\\s*(\\d+)/g;\n\n  // Only look within policy section\n  const policySectionMatch = code.match(/policies\\s*:\\s*\\[([\\s\\S]*?)\\]/);\n  if (policySectionMatch?.[1]) {\n    let match;\n    while ((match = policyPattern.exec(policySectionMatch[1])) !== null) {\n      if (match[1] && match[2]) {\n        policies.push({\n          key: match[1],\n          version: Number(match[2]),\n        });\n      }\n    }\n  }\n\n  return policies.length > 0 ? policies : undefined;\n}\n\n/**\n * Extract test spec refs.\n */\nexport function extractTestRefs(code: string): RefInfo[] | undefined {\n  const tests: RefInfo[] = [];\n\n  // Look for tests array\n  const testsSectionMatch = code.match(/tests\\s*:\\s*\\[([\\s\\S]*?)\\]/);\n  if (testsSectionMatch?.[1]) {\n    const refPattern = /\\{\\s*key:\\s*['\"]([^'\"]+)['\"]\\s*,\\s*version:\\s*(\\d+)/g;\n    let match;\n    while ((match = refPattern.exec(testsSectionMatch[1])) !== null) {\n      if (match[1] && match[2]) {\n        tests.push({\n          key: match[1],\n          version: Number(match[2]),\n        });\n      }\n    }\n  }\n\n  return tests.length > 0 ? tests : undefined;\n}\n\nfunction matchStringField(code: string, field: string): string | null {\n  const regex = new RegExp(`${escapeRegex(field)}\\\\s*:\\\\s*['\"]([^'\"]+)['\"]`);\n  const match = code.match(regex);\n  return match?.[1] ?? null;\n}\n\nfunction matchNumberField(code: string, field: string): number | null {\n  const regex = new RegExp(`${escapeRegex(field)}\\\\s*:\\\\s*(\\\\d+)`);\n  const match = code.match(regex);\n  if (!match?.[1]) return null;\n  const parsed = Number(match[1]);\n  return Number.isFinite(parsed) ? parsed : null;\n}\n\nfunction matchStringArrayField(\n  code: string,\n  field: string\n): 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 = Array.from(inner.matchAll(/['\"]([^'\"]+)['\"]/g))\n    .map((m) => m[1])\n    .filter(\n      (value): value is string => typeof value === 'string' && value.length > 0\n    );\n\n  return items.length > 0 ? items : undefined;\n}\n\nfunction isStability(value: string | null): value is Stability {\n  return (\n    value === 'experimental' ||\n    value === 'beta' ||\n    value === 'stable' ||\n    value === 'deprecated'\n  );\n}\n\nfunction escapeRegex(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\n/**\n * Infer operation kind from source code.\n * First checks for defineCommand/defineQuery usage (which set kind automatically),\n * then falls back to explicit kind field.\n */\nfunction inferOperationKind(code: string): AnalyzedOperationKind {\n  // Check for defineCommand/defineQuery usage first (they set kind automatically)\n  if (/defineCommand\\s*\\(/.test(code)) return 'command';\n  if (/defineQuery\\s*\\(/.test(code)) return 'query';\n  // Fall back to explicit kind field\n  const kindRaw = matchStringField(code, 'kind');\n  return kindRaw === 'command' || kindRaw === 'query' ? kindRaw : 'unknown';\n}\n\n/**\n * Infer operation kind from a specific code block.\n */\nfunction inferOperationKindFromBlock(block: string): AnalyzedOperationKind {\n  if (/defineCommand\\s*\\(/.test(block)) return 'command';\n  if (/defineQuery\\s*\\(/.test(block)) return 'query';\n  const kindRaw = matchStringField(block, 'kind');\n  return kindRaw === 'command' || kindRaw === 'query' ? kindRaw : 'unknown';\n}\n\n/**\n * Extract key and version from a meta block.\n */\nfunction extractMetaFromBlock(\n  block: string\n): { key: string; version: number } | null {\n  const key = matchStringField(block, 'key');\n  const version = matchNumberField(block, 'version');\n  if (key && version !== null) {\n    return { key, version };\n  }\n  return null;\n}\n\n/**\n * Define function patterns for all spec types.\n */\nconst DEFINE_FUNCTION_PATTERNS = [\n  // Operations\n  { pattern: /defineCommand\\s*\\(\\s*\\{/g, type: 'operation' as const },\n  { pattern: /defineQuery\\s*\\(\\s*\\{/g, type: 'operation' as const },\n  // Events\n  { pattern: /defineEvent\\s*\\(\\s*\\{/g, type: 'event' as const },\n  // Presentations (both v1 and v2 patterns)\n  {\n    pattern: /:\\s*PresentationSpec\\s*=\\s*\\{/g,\n    type: 'presentation' as const,\n  },\n  {\n    pattern: /:\\s*PresentationSpec\\s*=\\s*\\{/g,\n    type: 'presentation' as const,\n  },\n  {\n    pattern: /:\\s*PresentationDescriptor\\s*=\\s*\\{/g,\n    type: 'presentation' as const,\n  },\n  { pattern: /definePresentation\\s*\\(\\s*\\{/g, type: 'presentation' as const },\n  // Capabilities\n  { pattern: /defineCapability\\s*\\(\\s*\\{/g, type: 'capability' as const },\n  // Workflows\n  { pattern: /defineWorkflow\\s*\\(\\s*\\{/g, type: 'workflow' as const },\n  // Experiments\n  { pattern: /defineExperiment\\s*\\(\\s*\\{/g, type: 'experiment' as const },\n  // Integrations\n  { pattern: /defineIntegration\\s*\\(\\s*\\{/g, type: 'integration' as const },\n  // Knowledge\n  { pattern: /defineKnowledge\\s*\\(\\s*\\{/g, type: 'knowledge' as const },\n  // Telemetry\n  { pattern: /defineTelemetry\\s*\\(\\s*\\{/g, type: 'telemetry' as const },\n  // App config\n  { pattern: /defineAppConfig\\s*\\(\\s*\\{/g, type: 'app-config' as const },\n  // Policy\n  { pattern: /definePolicy\\s*\\(\\s*\\{/g, type: 'policy' as const },\n  // Test spec\n  { pattern: /defineTestSpec\\s*\\(\\s*\\{/g, type: 'test-spec' as const },\n  // Data view\n  { pattern: /defineDataView\\s*\\(\\s*\\{/g, type: 'data-view' as const },\n  // Form\n  { pattern: /defineForm\\s*\\(\\s*\\{/g, type: 'form' as const },\n  // Migration\n  { pattern: /defineMigration\\s*\\(\\s*\\{/g, type: 'migration' as const },\n];\n\n/**\n * Find matching closing brace for an opening brace.\n * Returns the index of the closing brace or -1 if not found.\n */\nfunction findMatchingBrace(code: string, startIndex: number): number {\n  let depth = 0;\n  let inString = false;\n  let stringChar = '';\n\n  for (let i = startIndex; i < code.length; i++) {\n    const char = code[i];\n    const prevChar = i > 0 ? code[i - 1] : '';\n\n    // Handle string literals\n    if ((char === '\"' || char === \"'\" || char === '`') && prevChar !== '\\\\') {\n      if (!inString) {\n        inString = true;\n        stringChar = char;\n      } else if (char === stringChar) {\n        inString = false;\n      }\n      continue;\n    }\n\n    if (inString) continue;\n\n    if (char === '{') {\n      depth++;\n    } else if (char === '}') {\n      depth--;\n      if (depth === 0) {\n        return i;\n      }\n    }\n  }\n\n  return -1;\n}\n\n/**\n * Scan spec source code to extract ALL specs from a file.\n * This function finds multiple spec definitions in a single file.\n */\nexport function scanAllSpecsFromSource(\n  code: string,\n  filePath: string\n): SpecScanResult[] {\n  const results: SpecScanResult[] = [];\n  const baseSpecType = inferSpecTypeFromFilePath(filePath);\n\n  // Track positions we've already processed to avoid duplicates\n  const processedPositions = new Set<number>();\n\n  for (const { pattern, type } of DEFINE_FUNCTION_PATTERNS) {\n    // Reset the regex lastIndex\n    pattern.lastIndex = 0;\n\n    let match;\n    while ((match = pattern.exec(code)) !== null) {\n      const startPos = match.index;\n\n      // Skip if we've already processed this position\n      if (processedPositions.has(startPos)) continue;\n      processedPositions.add(startPos);\n\n      // Find the opening brace position\n      const openBracePos = code.indexOf('{', startPos);\n      if (openBracePos === -1) continue;\n\n      // Find the matching closing brace\n      const closeBracePos = findMatchingBrace(code, openBracePos);\n      if (closeBracePos === -1) continue;\n\n      // Extract the block content\n      const block = code.slice(openBracePos, closeBracePos + 1);\n\n      // Extract meta information\n      const meta = extractMetaFromBlock(block);\n      if (!meta) continue;\n\n      // Extract additional metadata\n      const description = matchStringField(block, 'description');\n      const stabilityRaw = matchStringField(block, 'stability');\n      const stability = isStability(stabilityRaw) ? stabilityRaw : undefined;\n      const owners = matchStringArrayField(block, 'owners');\n      const tags = matchStringArrayField(block, 'tags');\n\n      const hasMeta = /meta\\s*:\\s*{/.test(block);\n      const hasIo = /\\bio\\s*:\\s*{/.test(block);\n      const hasPolicy = /\\bpolicy\\s*:\\s*{/.test(block);\n      const hasPayload = /\\bpayload\\s*:\\s*{/.test(block);\n      const hasContent = /\\bcontent\\s*:\\s*{/.test(block);\n      const hasDefinition = /\\bdefinition\\s*:\\s*{/.test(block);\n\n      // Infer kind for operations\n      const kind =\n        type === 'operation' ? inferOperationKindFromBlock(block) : 'unknown';\n\n      // Extract references from operations\n      const emittedEvents =\n        type === 'operation' ? extractEmittedEvents(block) : undefined;\n      const policyRefs =\n        type === 'operation' ? extractPolicyRefs(block) : undefined;\n      const testRefs = extractTestRefs(block);\n\n      results.push({\n        filePath,\n        specType: type,\n        key: meta.key,\n        version: meta.version,\n        description: description ?? undefined,\n        stability,\n        owners,\n        tags,\n        kind,\n        hasMeta,\n        hasIo,\n        hasPolicy,\n        hasPayload,\n        hasContent,\n        hasDefinition,\n        emittedEvents,\n        policyRefs,\n        testRefs,\n      });\n    }\n  }\n\n  // If no specs found via patterns, fall back to file-type based scanning\n  // This handles cases where the file uses non-standard patterns\n  if (results.length === 0 && baseSpecType !== 'unknown') {\n    const fallback = scanSpecSource(code, filePath);\n    if (fallback.key && fallback.version !== undefined) {\n      results.push(fallback);\n    }\n  }\n\n  return results;\n}\n"],"mappings":"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"}
+{"version":3,"file":"spec-scan.js","names":["events: RefInfo[]","policies: RefInfo[]","tests: RefInfo[]","results: SpecScanResult[]"],"sources":["../../src/analysis/spec-scan.ts"],"sourcesContent":["/**\n * Spec source scanning utilities.\n * Extracted from cli-contractspec/src/utils/spec-scan.ts\n */\n\nimport type {\n  AnalyzedOperationKind,\n  AnalyzedSpecType,\n  RefInfo,\n  SpecScanResult,\n} from '../types/analysis-types';\nimport type { Stability } from '../types/spec-types';\n\n/**\n * Infer spec type from file path based on naming conventions.\n * Supports all contract types from @contractspec/lib.contracts.\n */\nexport function inferSpecTypeFromFilePath(filePath: string): AnalyzedSpecType {\n  // Check more specific patterns first\n  // Operation patterns: .contracts. OR /contracts/ directory\n  if (\n    filePath.includes('.operations.') ||\n    filePath.includes('/operations/') ||\n    filePath.includes('.operation.') ||\n    filePath.includes('/operation/')\n  )\n    return 'operation';\n\n  // Event patterns: .event. OR /events/ OR /events.ts\n  if (\n    filePath.includes('.event.') ||\n    filePath.includes('/events/') ||\n    filePath.endsWith('/events.ts')\n  )\n    return 'event';\n\n  // Presentation patterns: .presentation. OR /presentations/ OR /presentations.ts\n  if (\n    filePath.includes('.presentation.') ||\n    filePath.includes('/presentations/') ||\n    filePath.endsWith('/presentations.ts')\n  )\n    return 'presentation';\n\n  if (filePath.includes('.feature.')) return 'feature';\n  if (filePath.includes('.capability.')) return 'capability';\n  if (filePath.includes('.data-view.')) return 'data-view';\n  if (filePath.includes('.form.')) return 'form';\n  if (filePath.includes('.migration.')) return 'migration';\n  if (filePath.includes('.workflow.')) return 'workflow';\n  if (filePath.includes('.experiment.')) return 'experiment';\n  if (filePath.includes('.integration.')) return 'integration';\n  if (filePath.includes('.knowledge.')) return 'knowledge';\n  if (filePath.includes('.telemetry.')) return 'telemetry';\n  if (filePath.includes('.app-config.')) return 'app-config';\n  if (filePath.includes('.policy.')) return 'policy';\n  if (filePath.includes('.test-spec.')) return 'test-spec';\n  return 'unknown';\n}\n\n/**\n * Scan spec source code to extract metadata without executing it.\n */\nexport function scanSpecSource(code: string, filePath: string): SpecScanResult {\n  const specType = inferSpecTypeFromFilePath(filePath);\n\n  const key = matchStringField(code, 'key');\n  const description = matchStringField(code, 'description');\n  const goal = matchStringField(code, 'goal');\n  const context = matchStringField(code, 'context');\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  const version = matchVersionField(code, 'version');\n  const kind = inferOperationKind(code);\n\n  const hasMeta = /meta\\s*:\\s*{/.test(code);\n  const hasIo = /\\bio\\s*:\\s*{/.test(code);\n  const hasPolicy = /\\bpolicy\\s*:\\s*{/.test(code);\n  const hasPayload = /\\bpayload\\s*:\\s*{/.test(code);\n  const hasContent = /\\bcontent\\s*:\\s*{/.test(code);\n  const hasDefinition = /\\bdefinition\\s*:\\s*{/.test(code);\n\n  // Extract references from operations\n  const emittedEvents =\n    specType === 'operation' ? extractEmittedEvents(code) : undefined;\n  const policyRefs =\n    specType === 'operation' ? extractPolicyRefs(code) : undefined;\n  const testRefs = extractTestRefs(code);\n\n  return {\n    filePath,\n    specType,\n    key: key ?? undefined,\n    description: description ?? undefined,\n    goal: goal ?? undefined,\n    context: context ?? undefined,\n    stability,\n    owners,\n    tags,\n    version: version ?? undefined,\n    kind,\n    hasMeta,\n    hasIo,\n    hasPolicy,\n    hasPayload,\n    hasContent,\n    hasDefinition,\n    emittedEvents,\n    policyRefs,\n    testRefs,\n    sourceBlock: code,\n  };\n}\n\n/**\n * Extract emitted event refs from operation spec source.\n * Looks for sideEffects.emits array entries.\n */\nexport function extractEmittedEvents(code: string): RefInfo[] | undefined {\n  const events: RefInfo[] = [];\n\n  // Match inline emit declarations: { key: 'x', version: '1' or 1, ... }\n  const inlinePattern =\n    /\\{\\s*key:\\s*['\"]([^'\"]+)['\"]\\s*,\\s*version:\\s*(?:['\"]([^'\"]+)['\"]|(\\d+(?:\\.\\d+)*))/g;\n  let match;\n  while ((match = inlinePattern.exec(code)) !== null) {\n    const key = match[1];\n    const version = match[2] || match[3];\n    if (key && version) {\n      events.push({ key, version });\n    }\n  }\n\n  // Match ref pattern: { ref: SomeEventSpec, ... }\n  // We can't fully resolve these without execution, but we can note they exist\n  const refPattern = /\\{\\s*ref:\\s*(\\w+)/g;\n  while ((match = refPattern.exec(code)) !== null) {\n    // Store a placeholder - actual resolution needs runtime\n    if (match[1] && !match[1].startsWith('when')) {\n      // We can't extract key/version from a variable ref statically\n      // This is noted for completeness but won't be fully resolvable\n    }\n  }\n\n  return events.length > 0 ? events : undefined;\n}\n\n/**\n * Extract policy refs from operation spec source.\n */\nexport function extractPolicyRefs(code: string): RefInfo[] | undefined {\n  const policies: RefInfo[] = [];\n\n  // Match policy ref pattern in policies array\n  const policyPattern =\n    /\\{\\s*key:\\s*['\"]([^'\"]+)['\"]\\s*,\\s*version:\\s*(?:['\"]([^'\"]+)['\"]|(\\d+(?:\\.\\d+)*))/g;\n\n  // Only look within policy section\n  const policySectionMatch = code.match(/policies\\s*:\\s*\\[([\\s\\S]*?)\\]/);\n  if (policySectionMatch?.[1]) {\n    let match;\n    while ((match = policyPattern.exec(policySectionMatch[1])) !== null) {\n      const key = match[1];\n      const version = match[2] || match[3];\n      if (key && version) {\n        policies.push({ key, version });\n      }\n    }\n  }\n\n  return policies.length > 0 ? policies : undefined;\n}\n\n/**\n * Extract test spec refs.\n */\nexport function extractTestRefs(code: string): RefInfo[] | undefined {\n  const tests: RefInfo[] = [];\n\n  // Look for tests array\n  const testsSectionMatch = code.match(/tests\\s*:\\s*\\[([\\s\\S]*?)\\]/);\n  if (testsSectionMatch?.[1]) {\n    const refPattern =\n      /\\{\\s*key:\\s*['\"]([^'\"]+)['\"]\\s*,\\s*version:\\s*(?:['\"]([^'\"]+)['\"]|(\\d+(?:\\.\\d+)*))/g;\n    let match;\n    while ((match = refPattern.exec(testsSectionMatch[1])) !== null) {\n      const key = match[1];\n      const version = match[2] || match[3];\n      if (key && version) {\n        tests.push({ key, version });\n      }\n    }\n  }\n\n  return tests.length > 0 ? tests : undefined;\n}\n\nfunction matchStringField(code: string, field: string): string | null {\n  const regex = new RegExp(`${escapeRegex(field)}\\\\s*:\\\\s*['\"]([^'\"]+)['\"]`);\n  const match = code.match(regex);\n  return match?.[1] ?? null;\n}\n\nfunction matchVersionField(code: string, field: string): string | undefined {\n  const regex = new RegExp(\n    `${escapeRegex(field)}\\\\s*:\\\\s*(?:['\"]([^'\"]+)['\"]|(\\\\d+(?:\\\\.\\\\d+)*))`\n  );\n  const match = code.match(regex);\n  if (match?.[1]) return match[1];\n  if (match?.[2]) return match[2];\n  return undefined;\n}\n\nfunction matchStringArrayField(\n  code: string,\n  field: string\n): 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 = Array.from(inner.matchAll(/['\"]([^'\"]+)['\"]/g))\n    .map((m) => m[1])\n    .filter(\n      (value): value is string => typeof value === 'string' && value.length > 0\n    );\n\n  return items.length > 0 ? items : undefined;\n}\n\nfunction isStability(value: string | null): value is Stability {\n  return (\n    value === 'experimental' ||\n    value === 'beta' ||\n    value === 'stable' ||\n    value === 'deprecated'\n  );\n}\n\nfunction escapeRegex(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\n/**\n * Infer operation kind from source code.\n * First checks for defineCommand/defineQuery usage (which set kind automatically),\n * then falls back to explicit kind field.\n */\nfunction inferOperationKind(code: string): AnalyzedOperationKind {\n  // Check for defineCommand/defineQuery usage first (they set kind automatically)\n  if (/defineCommand\\s*\\(/.test(code)) return 'command';\n  if (/defineQuery\\s*\\(/.test(code)) return 'query';\n  // Fall back to explicit kind field\n  const kindRaw = matchStringField(code, 'kind');\n  return kindRaw === 'command' || kindRaw === 'query' ? kindRaw : 'unknown';\n}\n\n/**\n * Infer operation kind from a specific code block.\n */\nfunction inferOperationKindFromBlock(block: string): AnalyzedOperationKind {\n  if (/defineCommand\\s*\\(/.test(block)) return 'command';\n  if (/defineQuery\\s*\\(/.test(block)) return 'query';\n  const kindRaw = matchStringField(block, 'kind');\n  return kindRaw === 'command' || kindRaw === 'query' ? kindRaw : 'unknown';\n}\n\n/**\n * Extract key and version from a meta block.\n */\nfunction extractMetaFromBlock(\n  block: string\n): { key: string; version: string } | null {\n  const key = matchStringField(block, 'key');\n  const version = matchVersionField(block, 'version');\n  if (key && version !== undefined) {\n    return { key, version };\n  }\n  return null;\n}\n\n/**\n * Define function patterns for all spec types.\n */\nconst DEFINE_FUNCTION_PATTERNS = [\n  // Operations\n  { pattern: /defineCommand\\s*\\(\\s*\\{/g, type: 'operation' as const },\n  { pattern: /defineQuery\\s*\\(\\s*\\{/g, type: 'operation' as const },\n  // Events\n  { pattern: /defineEvent\\s*\\(\\s*\\{/g, type: 'event' as const },\n  // Presentations (both v1 and v2 patterns)\n  {\n    pattern: /:\\s*PresentationSpec\\s*=\\s*\\{/g,\n    type: 'presentation' as const,\n  },\n  {\n    pattern: /:\\s*PresentationSpec\\s*=\\s*\\{/g,\n    type: 'presentation' as const,\n  },\n  {\n    pattern: /:\\s*PresentationDescriptor\\s*=\\s*\\{/g,\n    type: 'presentation' as const,\n  },\n  { pattern: /definePresentation\\s*\\(\\s*\\{/g, type: 'presentation' as const },\n  // Capabilities\n  { pattern: /defineCapability\\s*\\(\\s*\\{/g, type: 'capability' as const },\n  // Workflows\n  { pattern: /defineWorkflow\\s*\\(\\s*\\{/g, type: 'workflow' as const },\n  // Experiments\n  { pattern: /defineExperiment\\s*\\(\\s*\\{/g, type: 'experiment' as const },\n  // Integrations\n  { pattern: /defineIntegration\\s*\\(\\s*\\{/g, type: 'integration' as const },\n  // Knowledge\n  { pattern: /defineKnowledge\\s*\\(\\s*\\{/g, type: 'knowledge' as const },\n  // Telemetry\n  { pattern: /defineTelemetry\\s*\\(\\s*\\{/g, type: 'telemetry' as const },\n  // App config\n  { pattern: /defineAppConfig\\s*\\(\\s*\\{/g, type: 'app-config' as const },\n  // Policy\n  { pattern: /definePolicy\\s*\\(\\s*\\{/g, type: 'policy' as const },\n  // Test spec\n  { pattern: /defineTestSpec\\s*\\(\\s*\\{/g, type: 'test-spec' as const },\n  // Data view\n  { pattern: /defineDataView\\s*\\(\\s*\\{/g, type: 'data-view' as const },\n  // Form\n  { pattern: /defineForm\\s*\\(\\s*\\{/g, type: 'form' as const },\n  // Migration\n  { pattern: /defineMigration\\s*\\(\\s*\\{/g, type: 'migration' as const },\n];\n\n/**\n * Find matching closing brace for an opening brace.\n * Returns the index of the closing brace or -1 if not found.\n */\nfunction findMatchingBrace(code: string, startIndex: number): number {\n  let depth = 0;\n  let inString = false;\n  let stringChar = '';\n\n  for (let i = startIndex; i < code.length; i++) {\n    const char = code[i];\n    const prevChar = i > 0 ? code[i - 1] : '';\n\n    // Handle string literals\n    if ((char === '\"' || char === \"'\" || char === '`') && prevChar !== '\\\\') {\n      if (!inString) {\n        inString = true;\n        stringChar = char;\n      } else if (char === stringChar) {\n        inString = false;\n      }\n      continue;\n    }\n\n    if (inString) continue;\n\n    if (char === '{') {\n      depth++;\n    } else if (char === '}') {\n      depth--;\n      if (depth === 0) {\n        return i;\n      }\n    }\n  }\n\n  return -1;\n}\n\n/**\n * Scan spec source code to extract ALL specs from a file.\n * This function finds multiple spec definitions in a single file.\n */\nexport function scanAllSpecsFromSource(\n  code: string,\n  filePath: string\n): SpecScanResult[] {\n  const results: SpecScanResult[] = [];\n  const baseSpecType = inferSpecTypeFromFilePath(filePath);\n\n  // Track positions we've already processed to avoid duplicates\n  const processedPositions = new Set<number>();\n\n  for (const { pattern, type } of DEFINE_FUNCTION_PATTERNS) {\n    // Reset the regex lastIndex\n    pattern.lastIndex = 0;\n\n    let match;\n    while ((match = pattern.exec(code)) !== null) {\n      const startPos = match.index;\n\n      // Skip if we've already processed this position\n      if (processedPositions.has(startPos)) continue;\n      processedPositions.add(startPos);\n\n      // Find the opening brace position\n      const openBracePos = code.indexOf('{', startPos);\n      if (openBracePos === -1) continue;\n\n      // Find the matching closing brace\n      const closeBracePos = findMatchingBrace(code, openBracePos);\n      if (closeBracePos === -1) continue;\n\n      // Extract the block content\n      const block = code.slice(openBracePos, closeBracePos + 1);\n\n      // Extract meta information\n      const meta = extractMetaFromBlock(block);\n      if (!meta) continue;\n\n      // Extract additional metadata\n      const description = matchStringField(block, 'description');\n      const goal = matchStringField(block, 'goal');\n      const context = matchStringField(block, 'context');\n      const stabilityRaw = matchStringField(block, 'stability');\n      const stability = isStability(stabilityRaw) ? stabilityRaw : undefined;\n      const owners = matchStringArrayField(block, 'owners');\n      const tags = matchStringArrayField(block, 'tags');\n\n      const hasMeta = /meta\\s*:\\s*{/.test(block);\n      const hasIo = /\\bio\\s*:\\s*{/.test(block);\n      const hasPolicy = /\\bpolicy\\s*:\\s*{/.test(block);\n      const hasPayload = /\\bpayload\\s*:\\s*{/.test(block);\n      const hasContent = /\\bcontent\\s*:\\s*{/.test(block);\n      const hasDefinition = /\\bdefinition\\s*:\\s*{/.test(block);\n\n      // Infer kind for operations\n      const kind =\n        type === 'operation' ? inferOperationKindFromBlock(block) : 'unknown';\n\n      // Extract references from operations\n      const emittedEvents =\n        type === 'operation' ? extractEmittedEvents(block) : undefined;\n      const policyRefs =\n        type === 'operation' ? extractPolicyRefs(block) : undefined;\n      const testRefs = extractTestRefs(block);\n\n      results.push({\n        filePath,\n        specType: type,\n        key: meta.key,\n        version: meta.version,\n        description: description ?? undefined,\n        goal: goal ?? undefined,\n        context: context ?? undefined,\n        stability,\n        owners,\n        tags,\n        kind,\n        hasMeta,\n        hasIo,\n        hasPolicy,\n        hasPayload,\n        hasContent,\n        hasDefinition,\n        emittedEvents,\n        policyRefs,\n        testRefs,\n        sourceBlock: block,\n      });\n    }\n  }\n\n  // If no specs found via patterns, fall back to file-type based scanning\n  // This handles cases where the file uses non-standard patterns\n  if (results.length === 0 && baseSpecType !== 'unknown') {\n    const fallback = scanSpecSource(code, filePath);\n    if (fallback.key && fallback.version !== undefined) {\n      results.push({ ...fallback, sourceBlock: code });\n    }\n  }\n\n  return results;\n}\n"],"mappings":"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"}

package/dist/formatter.js

@@ -1,8 +1,8 @@
+import { readFile } from "node:fs/promises";
 import { exec } from "node:child_process";
 import { promisify } from "node:util";
 import { existsSync } from "node:fs";
 import { dirname, resolve } from "node:path";
-import { readFile } from "node:fs/promises";
 
 //#region src/formatter.ts
 /**
@@ -92,10 +92,10 @@ function getFormatterCommand(type, files, config) {
 	const fileArgs = files.map((f) => `"${f}"`).join(" ");
 	const extraArgs = config?.args?.join(" ") || "";
 	switch (type) {
-		case "prettier": return `npx prettier --write ${extraArgs} ${fileArgs}`;
-		case "eslint": return `npx eslint --fix ${extraArgs} ${fileArgs}`;
-		case "biome": return `npx @biomejs/biome format --write ${extraArgs} ${fileArgs}`;
-		case "dprint": return `npx dprint fmt ${extraArgs} ${fileArgs}`;
+		case "prettier": return `bunx prettier --write ${extraArgs} ${fileArgs}`;
+		case "eslint": return `bunx eslint --fix ${extraArgs} ${fileArgs}`;
+		case "biome": return `bunx @biomejs/biome format --write ${extraArgs} ${fileArgs}`;
+		case "dprint": return `bunx dprint fmt ${extraArgs} ${fileArgs}`;
 		case "custom":
 			if (!config?.command) throw new Error("Custom formatter requires a command to be specified in config");
 			return `${config.command} ${extraArgs} ${fileArgs}`;