@contractspec/module.workspace 1.44.1 → 1.45.1

package/dist/ai/{code-generation.d.ts → prompts/code-generation.d.ts}

@@ -1,26 +1,22 @@
-//#region src/ai/code-generation.d.ts
+//#region src/ai/prompts/code-generation.d.ts
 /**
- * AI prompts for code generation.
- * Extracted from cli-contractspec/src/ai/prompts/code-generation.ts
- */
-/**
- * Build prompt for generating handler implementation.
+ * Build prompt for generating handler implementation
  */
 declare function buildHandlerPrompt(specCode: string): string;
 /**
- * Build prompt for generating React component from presentation spec.
+ * Build prompt for generating React component from presentation spec
  */
 declare function buildComponentPrompt(specCode: string): string;
 /**
- * Build prompt for generating form component.
+ * Build prompt for generating form component
  */
 declare function buildFormPrompt(specCode: string): string;
 /**
- * Build prompt for generating tests.
+ * Build prompt for generating tests
  */
 declare function buildTestPrompt(specCode: string, implementationCode: string, testType: 'handler' | 'component'): string;
 /**
- * System prompt for code generation.
+ * System prompt for code generation
  */
 declare function getCodeGenSystemPrompt(): string;
 //#endregion

package/dist/ai/prompts/code-generation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-generation.d.ts","names":[],"sources":["../../../src/ai/prompts/code-generation.ts"],"sourcesContent":[],"mappings":";;AAGA;AA0BA;AA0BgB,iBApDA,kBAAA,CAoDe,QAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AA2B/B;AA2CA;;iBAhGgB,oBAAA;;;;iBA0BA,eAAA;;;;iBA2BA,eAAA;;;;iBA2CA,sBAAA,CAAA"}

package/dist/ai/{code-generation.js → prompts/code-generation.js}

@@ -1,10 +1,6 @@
-//#region src/ai/code-generation.ts
+//#region src/ai/prompts/code-generation.ts
 /**
-* AI prompts for code generation.
-* Extracted from cli-contractspec/src/ai/prompts/code-generation.ts
-*/
-/**
-* Build prompt for generating handler implementation.
+* Build prompt for generating handler implementation
 */
 function buildHandlerPrompt(specCode) {
 	return `You are a senior TypeScript developer implementing a handler for a contract specification.
@@ -29,7 +25,7 @@ The handler should be production-ready with proper error handling, logging point
 Return only the TypeScript code for the handler function.`;
 }
 /**
-* Build prompt for generating React component from presentation spec.
+* Build prompt for generating React component from presentation spec
 */
 function buildComponentPrompt(specCode) {
 	return `You are a senior React developer creating a component for a presentation specification.
@@ -54,7 +50,7 @@ The component should follow Atomic Design principles and be reusable.
 Return only the TypeScript/TSX code for the component.`;
 }
 /**
-* Build prompt for generating form component.
+* Build prompt for generating form component
 */
 function buildFormPrompt(specCode) {
 	return `You are a senior React developer creating a form component from a form specification.
@@ -80,7 +76,7 @@ The form should provide excellent UX with real-time validation and helpful feedb
 Return only the TypeScript/TSX code for the form component.`;
 }
 /**
-* Build prompt for generating tests.
+* Build prompt for generating tests
 */
 function buildTestPrompt(specCode, implementationCode, testType) {
 	return `You are a senior developer writing comprehensive tests.
@@ -113,7 +109,7 @@ Use clear test descriptions and follow AAA pattern (Arrange, Act, Assert).
 Return only the TypeScript test code.`;
 }
 /**
-* System prompt for code generation.
+* System prompt for code generation
 */
 function getCodeGenSystemPrompt() {
 	return `You are an expert TypeScript developer with deep knowledge of:

package/dist/ai/prompts/code-generation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-generation.js","names":[],"sources":["../../../src/ai/prompts/code-generation.ts"],"sourcesContent":["/**\n * Build prompt for generating handler implementation\n */\nexport function buildHandlerPrompt(specCode: string): string {\n  return `You are a senior TypeScript developer implementing a handler for a contract specification.\n\nHere is the contract spec:\n\n\\`\\`\\`typescript\n${specCode}\n\\`\\`\\`\n\nGenerate a complete handler implementation that:\n\n1. **Matches the spec signature**: Input/output types from the spec\n2. **Handles errors**: Implement error cases defined in spec.io.errors\n3. **Emits events**: Use the events declared in spec.sideEffects.emits\n4. **Validates input**: Use zod validation from the schema\n5. **Follows best practices**: Clean, type-safe TypeScript\n6. **Includes comments**: Explain business logic\n\nThe handler should be production-ready with proper error handling, logging points, and clear structure.\n\nReturn only the TypeScript code for the handler function.`;\n}\n\n/**\n * Build prompt for generating React component from presentation spec\n */\nexport function buildComponentPrompt(specCode: string): string {\n  return `You are a senior React developer creating a component for a presentation specification.\n\nHere is the presentation spec:\n\n\\`\\`\\`typescript\n${specCode}\n\\`\\`\\`\n\nGenerate a complete React component that:\n\n1. **Props interface**: Typed props from the spec\n2. **Accessibility**: Proper ARIA labels, roles, keyboard navigation\n3. **Mobile-first**: Optimized for small screens and touch\n4. **Clean UI**: Simple, intuitive interface\n5. **Type-safe**: Full TypeScript with no 'any' types\n6. **Best practices**: React hooks, proper state management\n\nThe component should follow Atomic Design principles and be reusable.\n\nReturn only the TypeScript/TSX code for the component.`;\n}\n\n/**\n * Build prompt for generating form component\n */\nexport function buildFormPrompt(specCode: string): string {\n  return `You are a senior React developer creating a form component from a form specification.\n\nHere is the form spec:\n\n\\`\\`\\`typescript\n${specCode}\n\\`\\`\\`\n\nGenerate a complete form component using react-hook-form that:\n\n1. **Form validation**: Use zod schema for validation\n2. **Field types**: Proper inputs for each field type\n3. **Conditional logic**: Support visibleWhen, enabledWhen, requiredWhen predicates\n4. **Error handling**: Clear, user-friendly error messages\n5. **Accessibility**: Labels, hints, ARIA attributes\n6. **Mobile-optimized**: Touch-friendly, appropriate input types\n7. **Type-safe**: Full TypeScript\n\nThe form should provide excellent UX with real-time validation and helpful feedback.\n\nReturn only the TypeScript/TSX code for the form component.`;\n}\n\n/**\n * Build prompt for generating tests\n */\nexport function buildTestPrompt(\n  specCode: string,\n  implementationCode: string,\n  testType: 'handler' | 'component'\n): string {\n  const testFocus =\n    testType === 'handler'\n      ? `\n  - Test all acceptance scenarios from the spec\n  - Test error cases defined in spec.io.errors\n  - Verify events are emitted correctly\n  - Test input validation\n  - Test happy path and edge cases`\n      : `\n  - Test rendering with various props\n  - Test user interactions\n  - Test accessibility (a11y)\n  - Test responsive behavior\n  - Test error states`;\n\n  return `You are a senior developer writing comprehensive tests.\n\nSpec:\n\\`\\`\\`typescript\n${specCode}\n\\`\\`\\`\n\nImplementation:\n\\`\\`\\`typescript\n${implementationCode}\n\\`\\`\\`\n\nGenerate complete test suite using Vitest that:\n${testFocus}\n\nUse clear test descriptions and follow AAA pattern (Arrange, Act, Assert).\n\nReturn only the TypeScript test code.`;\n}\n\n/**\n * System prompt for code generation\n */\nexport function getCodeGenSystemPrompt(): string {\n  return `You are an expert TypeScript developer with deep knowledge of:\n- Type-safe API design\n- React and modern hooks\n- Test-driven development\n- Accessibility best practices\n- Clean code principles\n\nGenerate production-ready code that is:\n- Fully typed (no 'any' or type assertions unless absolutely necessary)\n- Well-documented with TSDoc comments\n- Following project conventions\n- Defensive and error-safe\n- Easy to maintain and extend\n\nAlways prioritize code quality, safety, and user experience.`;\n}\n"],"mappings":";;;;AAGA,SAAgB,mBAAmB,UAA0B;AAC3D,QAAO;;;;;EAKP,SAAS;;;;;;;;;;;;;;;;;;;AAoBX,SAAgB,qBAAqB,UAA0B;AAC7D,QAAO;;;;;EAKP,SAAS;;;;;;;;;;;;;;;;;;;AAoBX,SAAgB,gBAAgB,UAA0B;AACxD,QAAO;;;;;EAKP,SAAS;;;;;;;;;;;;;;;;;;;;AAqBX,SAAgB,gBACd,UACA,oBACA,UACQ;AAgBR,QAAO;;;;EAIP,SAAS;;;;;EAKT,mBAAmB;;;;EAvBjB,aAAa,YACT;;;;;sCAMA;;;;;uBAoBI;;;;;;;;;AAUZ,SAAgB,yBAAiC;AAC/C,QAAO"}

package/dist/ai/{spec-creation.d.ts → prompts/spec-creation.d.ts}

@@ -1,25 +1,26 @@
-import { OpKind, PresentationKind } from "../types/spec-types.js";
+import { PresentationKind } from "../../types/spec-types.js";
+import { OpKind } from "@contractspec/lib.contracts";
 
-//#region src/ai/spec-creation.d.ts
+//#region src/ai/prompts/spec-creation.d.ts
 
 /**
- * Build prompt for creating operation spec from description.
+ * Build prompt for creating operation spec from description
  */
 declare function buildOperationSpecPrompt(description: string, kind: OpKind): string;
 /**
- * Build prompt for creating event spec from description.
+ * Build prompt for creating event spec from description
  */
 declare function buildEventSpecPrompt(description: string): string;
 /**
- * Build prompt for creating presentation spec from description.
+ * Build prompt for creating presentation spec from description
  */
 declare function buildPresentationSpecPrompt(description: string, kind: PresentationKind): string;
 /**
- * Build system prompt for all spec generation.
+ * Build system prompt for all spec generation
  */
 declare function getSystemPrompt(): string;
 /**
- * Create example-based prompt for better results.
+ * Create example-based prompt for better results
  */
 declare function addExampleContext(basePrompt: string, examples: string[]): string;
 //#endregion

package/dist/ai/prompts/spec-creation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-creation.d.ts","names":[],"sources":["../../../src/ai/prompts/spec-creation.ts"],"sourcesContent":[],"mappings":";;;;;;;AAMA;AA4BgB,iBA5BA,wBAAA,CA4BoB,WAAA,EAAA,MAAA,EAAA,IAAA,EA1B5B,MA0B4B,CAAA,EAAA,MAAA;AAqBpC;AAoCA;AAiBA;iBA1EgB,oBAAA;;;;iBAqBA,2BAAA,4BAER;;;;iBAkCQ,eAAA,CAAA;;;;iBAiBA,iBAAA"}

package/dist/ai/{spec-creation.js → prompts/spec-creation.js}

@@ -1,6 +1,6 @@
-//#region src/ai/spec-creation.ts
+//#region src/ai/prompts/spec-creation.ts
 /**
-* Build prompt for creating operation spec from description.
+* Build prompt for creating operation spec from description
 */
 function buildOperationSpecPrompt(description, kind) {
 	return `You are a senior software architect creating a contract specification for an operation.
@@ -24,7 +24,7 @@ Create a complete contract specification following these guidelines:
 Respond with a structured spec.`;
 }
 /**
-* Build prompt for creating event spec from description.
+* Build prompt for creating event spec from description
 */
 function buildEventSpecPrompt(description) {
 	return `You are a senior software architect creating an event specification.
@@ -44,7 +44,7 @@ Events represent things that have already happened and should use past tense.
 Respond with a structured spec.`;
 }
 /**
-* Build prompt for creating presentation spec from description.
+* Build prompt for creating presentation spec from description
 */
 function buildPresentationSpecPrompt(description, kind) {
 	return `You are a senior software architect creating a presentation specification.
@@ -68,7 +68,7 @@ Create a complete presentation specification following these guidelines:
 Respond with a structured spec.`;
 }
 /**
-* Build system prompt for all spec generation.
+* Build system prompt for all spec generation
 */
 function getSystemPrompt() {
 	return `You are an expert software architect specializing in API design and contract-driven development.
@@ -84,7 +84,7 @@ Your specs are:
 Always use proper dot notation for names and ensure all metadata is meaningful and accurate.`;
 }
 /**
-* Create example-based prompt for better results.
+* Create example-based prompt for better results
 */
 function addExampleContext(basePrompt, examples) {
 	if (examples.length === 0) return basePrompt;

package/dist/ai/prompts/spec-creation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-creation.js","names":[],"sources":["../../../src/ai/prompts/spec-creation.ts"],"sourcesContent":["import type { OpKind } from '@contractspec/lib.contracts';\nimport type { PresentationKind } from '../../types/spec-types';\n\n/**\n * Build prompt for creating operation spec from description\n */\nexport function buildOperationSpecPrompt(\n  description: string,\n  kind: OpKind\n): string {\n  return `You are a senior software architect creating a contract specification for an operation.\n\nThe operation is a ${kind} (${kind === 'command' ? 'changes state, has side effects' : 'read-only, idempotent'}).\n\nUser description: ${description}\n\nCreate a complete contract specification following these guidelines:\n\n1. **Name**: Use dot notation like \"domain.operationName\" (e.g., \"user.signup\", \"payment.charge\")\n2. **Version**: Start at 1\n3. **Description**: Clear, concise summary (1-2 sentences)\n4. **Goal**: Business purpose - why this operation exists\n5. **Context**: Background, constraints, scope (what it does and doesn't do)\n6. **Input/Output**: Describe the shape (we'll create schemas separately)\n7. **Auth**: Who can call this - anonymous, user, or admin\n8. **Feature Flags**: Any flags that gate this operation\n9. **Side Effects**: What events might be emitted, analytics to track\n\nRespond with a structured spec.`;\n}\n\n/**\n * Build prompt for creating event spec from description\n */\nexport function buildEventSpecPrompt(description: string): string {\n  return `You are a senior software architect creating an event specification.\n\nUser description: ${description}\n\nCreate a complete event specification following these guidelines:\n\n1. **Name**: Use dot notation like \"domain.event_name\" (e.g., \"user.signup_completed\", \"payment.charged\")\n2. **Version**: Start at 1\n3. **Description**: Clear description of when this event is emitted\n4. **Payload**: Describe what data the event carries\n5. **PII Fields**: List any personally identifiable information fields (e.g., [\"email\", \"name\"])\n\nEvents represent things that have already happened and should use past tense.\n\nRespond with a structured spec.`;\n}\n\n/**\n * Build prompt for creating presentation spec from description\n */\nexport function buildPresentationSpecPrompt(\n  description: string,\n  kind: PresentationKind\n): string {\n  const kindDescriptions = {\n    web_component: 'a React component with props schema',\n    markdown: 'markdown/MDX documentation or guide',\n    data: 'structured data export (JSON/XML)',\n  };\n\n  return `You are a senior software architect creating a presentation specification.\n\nThis is a ${kind} presentation - ${kindDescriptions[kind]}.\n\nUser description: ${description}\n\nCreate a complete presentation specification following these guidelines:\n\n1. **Name**: Use dot notation like \"domain.presentation_name\" (e.g., \"user.profile_card\", \"docs.api_guide\")\n2. **Version**: Start at 1\n3. **Description**: What this presentation shows/provides\n4. **Kind-specific details**:\n   ${\n     kind === 'web_component'\n       ? '- Component key (symbolic, resolved by host app)\\n   - Props structure\\n   - Analytics events to track'\n       : kind === 'markdown'\n         ? '- Content or resource URI\\n   - Target audience'\n         : '- MIME type (e.g., application/json)\\n   - Data structure description'\n   }\n\nRespond with a structured spec.`;\n}\n\n/**\n * Build system prompt for all spec generation\n */\nexport function getSystemPrompt(): string {\n  return `You are an expert software architect specializing in API design and contract-driven development.\n\nYou create clear, well-documented specifications that serve as the single source of truth for operations, events, and presentations.\n\nYour specs are:\n- Precise and unambiguous\n- Following TypeScript conventions\n- Business-oriented (capturing the \"why\" not just \"what\")\n- Designed for both humans and AI agents to understand\n\nAlways use proper dot notation for names and ensure all metadata is meaningful and accurate.`;\n}\n\n/**\n * Create example-based prompt for better results\n */\nexport function addExampleContext(\n  basePrompt: string,\n  examples: string[]\n): string {\n  if (examples.length === 0) return basePrompt;\n\n  return `${basePrompt}\n\nHere are some good examples for reference:\n\n${examples.join('\\n\\n')}\n\nFollow this structure and quality level.`;\n}\n"],"mappings":";;;;AAMA,SAAgB,yBACd,aACA,MACQ;AACR,QAAO;;qBAEY,KAAK,IAAI,SAAS,YAAY,oCAAoC,wBAAwB;;oBAE3F,YAAY;;;;;;;;;;;;;;;;;;;AAoBhC,SAAgB,qBAAqB,aAA6B;AAChE,QAAO;;oBAEW,YAAY;;;;;;;;;;;;;;;;;AAkBhC,SAAgB,4BACd,aACA,MACQ;AAOR,QAAO;;YAEG,KAAK,kBARU;EACvB,eAAe;EACf,UAAU;EACV,MAAM;EACP,CAIiD,MAAM;;oBAEtC,YAAY;;;;;;;;KAS3B,SAAS,kBACL,2GACA,SAAS,aACP,oDACA,wEACP;;;;;;;AAQJ,SAAgB,kBAA0B;AACxC,QAAO;;;;;;;;;;;;;;;AAgBT,SAAgB,kBACd,YACA,UACQ;AACR,KAAI,SAAS,WAAW,EAAG,QAAO;AAElC,QAAO,GAAG,WAAW;;;;EAIrB,SAAS,KAAK,OAAO,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":";;;;;;;iBAYgB,aAAA;;;;iBAOA,iBAAA,kCAGb"}

package/dist/analysis/example-scan.js

@@ -0,0 +1,151 @@
+//#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, "-");
+}
+/**
+* Match a string field in source code.
+*/
+function matchStringField(code, field) {
+	const regex = /* @__PURE__ */ new RegExp(`${escapeRegex(field)}\\s*:\\s*['"]([^'"]+)['"]`);
+	return code.match(regex)?.[1] ?? null;
+}
+/**
+* Match a string field within a limited scope.
+*/
+function matchStringFieldIn(code, field) {
+	const regex = /* @__PURE__ */ new RegExp(`${escapeRegex(field)}\\s*:\\s*['"]([^'"]+)['"]`);
+	return code.match(regex)?.[1] ?? null;
+}
+/**
+* Match a string array field in source code.
+*/
+function matchStringArrayField(code, field) {
+	const regex = /* @__PURE__ */ new RegExp(`${escapeRegex(field)}\\s*:\\s*\\[([\\s\\S]*?)\\]`);
+	const match = code.match(regex);
+	if (!match?.[1]) return void 0;
+	const inner = match[1];
+	const items = Array.from(inner.matchAll(/['"]([^'"]+)['"]/g)).map((m) => m[1]).filter((value) => typeof value === "string" && value.length > 0);
+	return items.length > 0 ? items : void 0;
+}
+/**
+* Check if a value is a valid stability.
+*/
+function isStability(value) {
+	return value === "experimental" || value === "beta" || value === "stable" || value === "deprecated";
+}
+/**
+* Escape regex special characters.
+*/
+function escapeRegex(value) {
+	return value.replace(/[.*+?^${}()|[\]\\]/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":["surfaces: ExampleScanResult['surfaces']","entrypoints: ExampleScanResult['entrypoints']"],"sources":["../../src/analysis/example-scan.ts"],"sourcesContent":["/**\n * Example file scanning utilities.\n *\n * Extracts ExampleSpec metadata from source code without execution.\n */\n\nimport type { ExampleScanResult } from '../types/analysis-types';\nimport type { Stability } from '../types/spec-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\n/**\n * Match a string field in source code.\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\n/**\n * Match a string field within a limited scope.\n */\nfunction matchStringFieldIn(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\n/**\n * Match a string array field in source code.\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\n/**\n * Check if a value is a valid stability.\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\n/**\n * Escape regex special characters.\n */\nfunction escapeRegex(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n"],"mappings":"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"}

package/dist/analysis/feature-scan.js

@@ -12,6 +12,8 @@ function scanFeatureSource(code, filePath) {
 	const key = matchStringField(code, "key") ?? extractKeyFromFilePath(filePath);
 	const title = matchStringField(code, "title") ?? void 0;
 	const description = matchStringField(code, "description") ?? void 0;
+	const goal = matchStringField(code, "goal") ?? void 0;
+	const context = matchStringField(code, "context") ?? void 0;
 	const domain = matchStringField(code, "domain") ?? void 0;
 	const stabilityRaw = matchStringField(code, "stability");
 	return {
@@ -19,6 +21,8 @@ function scanFeatureSource(code, filePath) {
 		key,
 		title,
 		description,
+		goal,
+		context,
 		domain,
 		stability: isStability(stabilityRaw) ? stabilityRaw : void 0,
 		owners: matchStringArrayField(code, "owners"),
@@ -28,7 +32,8 @@ function scanFeatureSource(code, filePath) {
 		presentations: extractRefsFromArray(code, "presentations"),
 		experiments: extractRefsFromArray(code, "experiments"),
 		capabilities: extractCapabilities(code),
-		opToPresentationLinks: extractOpToPresentationLinks(code)
+		opToPresentationLinks: extractOpToPresentationLinks(code),
+		sourceBlock: code
 	};
 }
 /**
@@ -39,11 +44,11 @@ function extractRefsFromArray(code, fieldName) {
 	const arrayPattern = new RegExp(`${escapeRegex(fieldName)}\\s*:\\s*\\[([\\s\\S]*?)\\]`, "m");
 	const arrayMatch = code.match(arrayPattern);
 	if (!arrayMatch?.[1]) return refs;
-	const refPattern = /\{\s*key:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)/g;
+	const refPattern = /\{\s*key:\s*['"]([^'"]+)['"]\s*,\s*version:\s*['"]([^'"]+)['"]/g;
 	let match;
 	while ((match = refPattern.exec(arrayMatch[1])) !== null) if (match[1] && match[2]) refs.push({
 		key: match[1],
-		version: Number(match[2])
+		version: match[2]
 	});
 	return refs;
 }
@@ -53,7 +58,7 @@ function extractRefsFromArray(code, fieldName) {
 function extractCapabilities(code) {
 	const provides = [];
 	const requires = [];
-	const capabilitiesMatch = code.match(/capabilities\s*:\s*\{([\s\S]*?)\}/);
+	const capabilitiesMatch = code.match(/capabilities\s*:\s*\{([\s\S]*?)\}\s*,?\s*(?:opToPresentation|$|\})/);
 	if (!capabilitiesMatch?.[1]) return {
 		provides,
 		requires
@@ -61,26 +66,26 @@ function extractCapabilities(code) {
 	const capabilitiesContent = capabilitiesMatch[1];
 	const providesMatch = capabilitiesContent.match(/provides\s*:\s*\[([\s\S]*?)\]/);
 	if (providesMatch?.[1]) {
-		const refPattern = /\{\s*key:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)/g;
+		const refPattern = /\{\s*key:\s*['"]([^'"]+)['"]\s*,\s*version:\s*['"]([^'"]+)['"]/g;
 		let match;
 		while ((match = refPattern.exec(providesMatch[1])) !== null) if (match[1] && match[2]) provides.push({
 			key: match[1],
-			version: Number(match[2])
+			version: match[2]
 		});
 	}
 	const requiresMatch = capabilitiesContent.match(/requires\s*:\s*\[([\s\S]*?)\]/);
 	if (requiresMatch?.[1]) {
-		const refPatternWithVersion = /\{\s*key:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)/g;
+		const refPatternWithVersion = /\{\s*key:\s*['"]([^'"]+)['"]\s*,\s*version:\s*['"]([^'"]+)['"]/g;
 		const refPatternKeyOnly = /\{\s*key:\s*['"]([^'"]+)['"]\s*\}/g;
 		let match = null;
 		while ((match = refPatternWithVersion.exec(requiresMatch[1])) !== null) if (match[1] && match[2]) requires.push({
 			key: match[1],
-			version: Number(match[2])
+			version: match[2]
 		});
 		while ((match = refPatternKeyOnly.exec(requiresMatch[1])) !== null) if (match && match[1]) {
 			if (!requires.some((r) => r.key === match[1])) requires.push({
 				key: match[1],
-				version: 1
+				version: "1.0.0"
 			});
 		}
 	}
@@ -96,16 +101,16 @@ function extractOpToPresentationLinks(code) {
 	const links = [];
 	const arrayMatch = code.match(/opToPresentation\s*:\s*\[([\s\S]*?)\]/);
 	if (!arrayMatch?.[1]) return links;
-	const linkPattern = /\{\s*op:\s*\{\s*key:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)\s*\}\s*,\s*pres:\s*\{\s*key:\s*['"]([^'"]+)['"]\s*,\s*version:\s*(\d+)\s*\}/g;
+	const linkPattern = /\{\s*op:\s*\{\s*key:\s*['"]([^'"]+)['"]\s*,\s*version:\s*['"]([^'"]+)['"]\s*\}\s*,\s*pres:\s*\{\s*key:\s*['"]([^'"]+)['"]\s*,\s*version:\s*['"]([^'"]+)['"]\s*\}/g;
 	let match;
 	while ((match = linkPattern.exec(arrayMatch[1])) !== null) if (match[1] && match[2] && match[3] && match[4]) links.push({
 		op: {
 			key: match[1],
-			version: Number(match[2])
+			version: match[2]
 		},
 		pres: {
 			key: match[3],
-			version: Number(match[4])
+			version: match[4]
 		}
 	});
 	return links;

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

@@ -1 +1 @@
-{"version":3,"file":"feature-scan.js","names":["refs: RefInfo[]","provides: RefInfo[]","requires: RefInfo[]","match: RegExpExecArray | null","links: { op: RefInfo; pres: RefInfo }[]"],"sources":["../../src/analysis/feature-scan.ts"],"sourcesContent":["/**\n * Feature file scanning utilities.\n *\n * Extracts FeatureModuleSpec metadata from source code without execution.\n */\n\nimport type { FeatureScanResult, RefInfo } from '../types/analysis-types';\nimport type { Stability } from '../types/spec-types';\n\n/**\n * Check if a file is a feature file based on naming conventions.\n */\nexport function isFeatureFile(filePath: string): boolean {\n  return filePath.includes('.feature.');\n}\n\n/**\n * Scan a feature source file to extract metadata.\n */\nexport function scanFeatureSource(\n  code: string,\n  filePath: string\n): FeatureScanResult {\n  const key = matchStringField(code, 'key') ?? extractKeyFromFilePath(filePath);\n  const title = matchStringField(code, 'title') ?? undefined;\n  const description = matchStringField(code, 'description') ?? 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 operations\n  const operations = extractRefsFromArray(code, 'operations');\n\n  // Extract events\n  const events = extractRefsFromArray(code, 'events');\n\n  // Extract presentations\n  const presentations = extractRefsFromArray(code, 'presentations');\n\n  // Extract experiments\n  const experiments = extractRefsFromArray(code, 'experiments');\n\n  // Extract capabilities\n  const capabilities = extractCapabilities(code);\n\n  // Extract op to presentation links\n  const opToPresentationLinks = extractOpToPresentationLinks(code);\n\n  return {\n    filePath,\n    key,\n    title,\n    description,\n    domain,\n    stability,\n    owners,\n    tags,\n    operations,\n    events,\n    presentations,\n    experiments,\n    capabilities,\n    opToPresentationLinks,\n  };\n}\n\n/**\n * Extract refs from a named array (e.g., operations, events, presentations).\n */\nfunction extractRefsFromArray(code: string, fieldName: string): RefInfo[] {\n  const refs: RefInfo[] = [];\n\n  // Match the array section\n  const arrayPattern = new RegExp(\n    `${escapeRegex(fieldName)}\\\\s*:\\\\s*\\\\[([\\\\s\\\\S]*?)\\\\]`,\n    'm'\n  );\n  const arrayMatch = code.match(arrayPattern);\n\n  if (!arrayMatch?.[1]) return refs;\n\n  // Extract each { key: 'x', version: N } entry\n  const refPattern = /\\{\\s*key:\\s*['\"]([^'\"]+)['\"]\\s*,\\s*version:\\s*(\\d+)/g;\n  let match;\n  while ((match = refPattern.exec(arrayMatch[1])) !== null) {\n    if (match[1] && match[2]) {\n      refs.push({\n        key: match[1],\n        version: Number(match[2]),\n      });\n    }\n  }\n\n  return refs;\n}\n\n/**\n * Extract capability bindings (provides and requires).\n */\nfunction extractCapabilities(code: string): {\n  provides: RefInfo[];\n  requires: RefInfo[];\n} {\n  const provides: RefInfo[] = [];\n  const requires: RefInfo[] = [];\n\n  // Match the capabilities section\n  const capabilitiesMatch = code.match(/capabilities\\s*:\\s*\\{([\\s\\S]*?)\\}/);\n  if (!capabilitiesMatch?.[1]) {\n    return { provides, requires };\n  }\n\n  const capabilitiesContent = capabilitiesMatch[1];\n\n  // Extract provides\n  const providesMatch = capabilitiesContent.match(\n    /provides\\s*:\\s*\\[([\\s\\S]*?)\\]/\n  );\n  if (providesMatch?.[1]) {\n    const refPattern = /\\{\\s*key:\\s*['\"]([^'\"]+)['\"]\\s*,\\s*version:\\s*(\\d+)/g;\n    let match;\n    while ((match = refPattern.exec(providesMatch[1])) !== null) {\n      if (match[1] && match[2]) {\n        provides.push({\n          key: match[1],\n          version: Number(match[2]),\n        });\n      }\n    }\n  }\n\n  // Extract requires\n  const requiresMatch = capabilitiesContent.match(\n    /requires\\s*:\\s*\\[([\\s\\S]*?)\\]/\n  );\n  if (requiresMatch?.[1]) {\n    // Requires can have key+version or just key\n    const refPatternWithVersion =\n      /\\{\\s*key:\\s*['\"]([^'\"]+)['\"]\\s*,\\s*version:\\s*(\\d+)/g;\n    const refPatternKeyOnly = /\\{\\s*key:\\s*['\"]([^'\"]+)['\"]\\s*\\}/g;\n\n    let match: RegExpExecArray | null = null;\n    while ((match = refPatternWithVersion.exec(requiresMatch[1])) !== null) {\n      if (match[1] && match[2]) {\n        requires.push({\n          key: match[1],\n          version: Number(match[2]),\n        });\n      }\n    }\n\n    // Also match key-only requires (version defaults to 1)\n    while ((match = refPatternKeyOnly.exec(requiresMatch[1])) !== null) {\n      if (match && match[1]) {\n        // Check if we already added this with a version\n        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n        const alreadyExists = requires.some((r) => r.key === match![1]);\n        if (!alreadyExists) {\n          requires.push({\n            key: match[1],\n            version: 1, // Default version\n          });\n        }\n      }\n    }\n  }\n\n  return { provides, requires };\n}\n\n/**\n * Extract opToPresentation links.\n */\nfunction extractOpToPresentationLinks(\n  code: string\n): { op: RefInfo; pres: RefInfo }[] {\n  const links: { op: RefInfo; pres: RefInfo }[] = [];\n\n  // Match the opToPresentation array\n  const arrayMatch = code.match(/opToPresentation\\s*:\\s*\\[([\\s\\S]*?)\\]/);\n  if (!arrayMatch?.[1]) return links;\n\n  // Match each link entry\n  // Pattern: { op: { key: 'x', version: N }, pres: { key: 'y', version: M } }\n  const linkPattern =\n    /\\{\\s*op:\\s*\\{\\s*key:\\s*['\"]([^'\"]+)['\"]\\s*,\\s*version:\\s*(\\d+)\\s*\\}\\s*,\\s*pres:\\s*\\{\\s*key:\\s*['\"]([^'\"]+)['\"]\\s*,\\s*version:\\s*(\\d+)\\s*\\}/g;\n\n  let match;\n  while ((match = linkPattern.exec(arrayMatch[1])) !== null) {\n    if (match[1] && match[2] && match[3] && match[4]) {\n      links.push({\n        op: { key: match[1], version: Number(match[2]) },\n        pres: { key: match[3], version: Number(match[4]) },\n      });\n    }\n  }\n\n  return links;\n}\n\n/**\n * Extract key from file path as fallback.\n */\nfunction extractKeyFromFilePath(filePath: string): string {\n  const fileName = filePath.split('/').pop() ?? filePath;\n  return fileName\n    .replace(/\\.feature\\.[jt]s$/, '')\n    .replace(/[^a-zA-Z0-9-]/g, '-');\n}\n\n/**\n * Match a string field in source code.\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\n/**\n * Match a string array field in source code.\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\n/**\n * Check if a value is a valid stability.\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\n/**\n * Escape regex special characters.\n */\nfunction escapeRegex(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n"],"mappings":"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"}
+{"version":3,"file":"feature-scan.js","names":["refs: RefInfo[]","provides: RefInfo[]","requires: RefInfo[]","match: RegExpExecArray | null","links: { op: RefInfo; pres: RefInfo }[]"],"sources":["../../src/analysis/feature-scan.ts"],"sourcesContent":["/**\n * Feature file scanning utilities.\n *\n * Extracts FeatureModuleSpec metadata from source code without execution.\n */\n\nimport type { FeatureScanResult, RefInfo } from '../types/analysis-types';\nimport type { Stability } from '../types/spec-types';\n\n/**\n * Check if a file is a feature file based on naming conventions.\n */\nexport function isFeatureFile(filePath: string): boolean {\n  return filePath.includes('.feature.');\n}\n\n/**\n * Scan a feature source file to extract metadata.\n */\nexport function scanFeatureSource(\n  code: string,\n  filePath: string\n): FeatureScanResult {\n  const key = matchStringField(code, 'key') ?? extractKeyFromFilePath(filePath);\n  const title = matchStringField(code, 'title') ?? undefined;\n  const description = matchStringField(code, 'description') ?? undefined;\n  const goal = matchStringField(code, 'goal') ?? undefined;\n  const context = matchStringField(code, 'context') ?? undefined;\n  const 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 operations\n  const operations = extractRefsFromArray(code, 'operations');\n\n  // Extract events\n  const events = extractRefsFromArray(code, 'events');\n\n  // Extract presentations\n  const presentations = extractRefsFromArray(code, 'presentations');\n\n  // Extract experiments\n  const experiments = extractRefsFromArray(code, 'experiments');\n\n  // Extract capabilities\n  const capabilities = extractCapabilities(code);\n\n  // Extract op to presentation links\n  const opToPresentationLinks = extractOpToPresentationLinks(code);\n\n  return {\n    filePath,\n    key,\n    title,\n    description,\n    goal,\n    context,\n    domain,\n    stability,\n    owners,\n    tags,\n    operations,\n    events,\n    presentations,\n    experiments,\n    capabilities,\n    opToPresentationLinks,\n    sourceBlock: code,\n  };\n}\n\n/**\n * Extract refs from a named array (e.g., operations, events, presentations).\n */\nfunction extractRefsFromArray(code: string, fieldName: string): RefInfo[] {\n  const refs: RefInfo[] = [];\n\n  // Match the array section\n  const arrayPattern = new RegExp(\n    `${escapeRegex(fieldName)}\\\\s*:\\\\s*\\\\[([\\\\s\\\\S]*?)\\\\]`,\n    'm'\n  );\n  const arrayMatch = code.match(arrayPattern);\n\n  if (!arrayMatch?.[1]) return refs;\n\n  // Extract each { key: 'x', version: 'x.y.z' } entry\n  const refPattern =\n    /\\{\\s*key:\\s*['\"]([^'\"]+)['\"]\\s*,\\s*version:\\s*['\"]([^'\"]+)['\"]/g;\n  let match;\n  while ((match = refPattern.exec(arrayMatch[1])) !== null) {\n    if (match[1] && match[2]) {\n      refs.push({\n        key: match[1],\n        version: match[2],\n      });\n    }\n  }\n\n  return refs;\n}\n\n/**\n * Extract capability bindings (provides and requires).\n */\nfunction extractCapabilities(code: string): {\n  provides: RefInfo[];\n  requires: RefInfo[];\n} {\n  const provides: RefInfo[] = [];\n  const requires: RefInfo[] = [];\n\n  // Match the capabilities section - need to match nested braces properly\n  const capabilitiesMatch = code.match(\n    /capabilities\\s*:\\s*\\{([\\s\\S]*?)\\}\\s*,?\\s*(?:opToPresentation|$|\\})/\n  );\n  if (!capabilitiesMatch?.[1]) {\n    return { provides, requires };\n  }\n\n  const capabilitiesContent = capabilitiesMatch[1];\n\n  // Extract provides\n  const providesMatch = capabilitiesContent.match(\n    /provides\\s*:\\s*\\[([\\s\\S]*?)\\]/\n  );\n  if (providesMatch?.[1]) {\n    const refPattern =\n      /\\{\\s*key:\\s*['\"]([^'\"]+)['\"]\\s*,\\s*version:\\s*['\"]([^'\"]+)['\"]/g;\n    let match;\n    while ((match = refPattern.exec(providesMatch[1])) !== null) {\n      if (match[1] && match[2]) {\n        provides.push({\n          key: match[1],\n          version: match[2],\n        });\n      }\n    }\n  }\n\n  // Extract requires\n  const requiresMatch = capabilitiesContent.match(\n    /requires\\s*:\\s*\\[([\\s\\S]*?)\\]/\n  );\n  if (requiresMatch?.[1]) {\n    // Requires can have key+version or just key\n    const refPatternWithVersion =\n      /\\{\\s*key:\\s*['\"]([^'\"]+)['\"]\\s*,\\s*version:\\s*['\"]([^'\"]+)['\"]/g;\n    const refPatternKeyOnly = /\\{\\s*key:\\s*['\"]([^'\"]+)['\"]\\s*\\}/g;\n\n    let match: RegExpExecArray | null = null;\n    while ((match = refPatternWithVersion.exec(requiresMatch[1])) !== null) {\n      if (match[1] && match[2]) {\n        requires.push({\n          key: match[1],\n          version: match[2],\n        });\n      }\n    }\n\n    // Also match key-only requires (version defaults to 1)\n    while ((match = refPatternKeyOnly.exec(requiresMatch[1])) !== null) {\n      if (match && match[1]) {\n        // Check if we already added this with a version\n        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n        const alreadyExists = requires.some((r) => r.key === match![1]);\n        if (!alreadyExists) {\n          requires.push({\n            key: match[1],\n            version: '1.0.0', // Default version\n          });\n        }\n      }\n    }\n  }\n\n  return { provides, requires };\n}\n\n/**\n * Extract opToPresentation links.\n */\nfunction extractOpToPresentationLinks(\n  code: string\n): { op: RefInfo; pres: RefInfo }[] {\n  const links: { op: RefInfo; pres: RefInfo }[] = [];\n\n  // Match the opToPresentation array\n  const arrayMatch = code.match(/opToPresentation\\s*:\\s*\\[([\\s\\S]*?)\\]/);\n  if (!arrayMatch?.[1]) return links;\n\n  // Match each link entry\n  // Pattern: { op: { key: 'x', version: 'N' }, pres: { key: 'y', version: 'M' } }\n  const linkPattern =\n    /\\{\\s*op:\\s*\\{\\s*key:\\s*['\"]([^'\"]+)['\"]\\s*,\\s*version:\\s*['\"]([^'\"]+)['\"]\\s*\\}\\s*,\\s*pres:\\s*\\{\\s*key:\\s*['\"]([^'\"]+)['\"]\\s*,\\s*version:\\s*['\"]([^'\"]+)['\"]\\s*\\}/g;\n\n  let match;\n  while ((match = linkPattern.exec(arrayMatch[1])) !== null) {\n    if (match[1] && match[2] && match[3] && match[4]) {\n      links.push({\n        op: { key: match[1], version: match[2] },\n        pres: { key: match[3], version: match[4] },\n      });\n    }\n  }\n\n  return links;\n}\n\n/**\n * Extract key from file path as fallback.\n */\nfunction extractKeyFromFilePath(filePath: string): string {\n  const fileName = filePath.split('/').pop() ?? filePath;\n  return fileName\n    .replace(/\\.feature\\.[jt]s$/, '')\n    .replace(/[^a-zA-Z0-9-]/g, '-');\n}\n\n/**\n * Match a string field in source code.\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\n/**\n * Match a string array field in source code.\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\n/**\n * Check if a value is a valid stability.\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\n/**\n * Escape regex special characters.\n */\nfunction escapeRegex(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n"],"mappings":"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"}

package/dist/analysis/impact/classifier.js

@@ -53,7 +53,7 @@ function classifyImpact(baseSpecs, headSpecs, diffs, options = {}) {
 		const specInfo = findSpecInfo(extractSpecKey(diff.path, baseSpecs, headSpecs), baseSpecs, headSpecs);
 		deltas.push({
 			specKey: specInfo?.key ?? "unknown",
-			specVersion: specInfo?.version ?? 0,
+			specVersion: specInfo?.version ?? "1.0.0",
 			specType: specInfo?.type ?? "operation",
 			path: diff.path,
 			severity: matchingRule?.severity ?? mapDiffTypeToSeverity(diff.type),

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

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

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

@@ -13,7 +13,7 @@ interface ImpactDelta {
   /** Key of the affected spec */
   specKey: string;
   /** Version of the affected spec */
-  specVersion: number;
+  specVersion: string;
   /** Type of the spec (operation, event) */
   specType: 'operation' | 'event';
   /** Path to the changed element */
@@ -52,13 +52,13 @@ interface ImpactResult {
   /** Specs that were added */
   addedSpecs: {
     key: string;
-    version: number;
+    version: string;
     type: 'operation' | 'event';
   }[];
   /** Specs that were removed */
   removedSpecs: {
     key: string;
-    version: number;
+    version: string;
     type: 'operation' | 'event';
   }[];
   /** Base commit/ref */