@lssm/bundle.contractspec-workspace 1.41.1 → 1.42.1

package/dist/services/doctor/types.d.ts

@@ -0,0 +1,118 @@
+//#region src/services/doctor/types.d.ts
+/**
+ * Doctor service types.
+ *
+ * Types for health checks and auto-fix functionality.
+ */
+/**
+ * Categories of health checks.
+ */
+type CheckCategory = 'cli' | 'config' | 'mcp' | 'deps' | 'workspace' | 'ai';
+/**
+ * All available check categories.
+ */
+declare const ALL_CHECK_CATEGORIES: CheckCategory[];
+/**
+ * Human-readable labels for check categories.
+ */
+declare const CHECK_CATEGORY_LABELS: Record<CheckCategory, string>;
+/**
+ * Status of a health check.
+ */
+type CheckStatus = 'pass' | 'warn' | 'fail' | 'skip';
+/**
+ * Result of applying a fix.
+ */
+interface FixResult {
+  /** Whether the fix was successful. */
+  success: boolean;
+  /** Message describing the result. */
+  message: string;
+}
+/**
+ * An action that can fix a failed check.
+ */
+interface FixAction {
+  /** Description of what the fix will do. */
+  description: string;
+  /** Function to apply the fix. */
+  apply: () => Promise<FixResult>;
+}
+/**
+ * Result of a single health check.
+ */
+interface CheckResult {
+  /** Category of the check. */
+  category: CheckCategory;
+  /** Name of the specific check. */
+  name: string;
+  /** Status of the check. */
+  status: CheckStatus;
+  /** Human-readable message. */
+  message: string;
+  /** Optional fix action if status is 'fail' or 'warn'. */
+  fix?: FixAction;
+  /** Additional details for debugging. */
+  details?: string;
+}
+/**
+ * Options for running the doctor.
+ */
+interface DoctorOptions {
+  /** Root directory of the workspace. */
+  workspaceRoot: string;
+  /** Categories to check (defaults to all). */
+  categories?: CheckCategory[];
+  /** If true, auto-apply fixes without prompting. */
+  autoFix?: boolean;
+  /** Skip AI provider checks. */
+  skipAi?: boolean;
+  /** Verbose output. */
+  verbose?: boolean;
+}
+/**
+ * Summary of doctor results.
+ */
+interface DoctorResult {
+  /** All check results. */
+  checks: CheckResult[];
+  /** Number of passing checks. */
+  passed: number;
+  /** Number of warnings. */
+  warnings: number;
+  /** Number of failures. */
+  failures: number;
+  /** Number of skipped checks. */
+  skipped: number;
+  /** Overall health status. */
+  healthy: boolean;
+}
+/**
+ * Callback for interactive prompts during doctor.
+ */
+interface DoctorPromptCallbacks {
+  /** Confirm a fix action. */
+  confirm: (message: string) => Promise<boolean>;
+  /** Input a value (e.g., API key). */
+  input: (message: string, options?: {
+    password?: boolean;
+  }) => Promise<string>;
+}
+/**
+ * Context passed to check functions.
+ */
+interface CheckContext {
+  /** Workspace root path (monorepo root or single project root). */
+  workspaceRoot: string;
+  /** Current package root (may differ from workspaceRoot in monorepos). */
+  packageRoot: string;
+  /** Whether this is a monorepo. */
+  isMonorepo: boolean;
+  /** Current package name (if in a monorepo package). */
+  packageName?: string;
+  /** Whether verbose output is enabled. */
+  verbose: boolean;
+}
+//#endregion
+export { ALL_CHECK_CATEGORIES, CHECK_CATEGORY_LABELS, CheckCategory, CheckContext, CheckResult, CheckStatus, DoctorOptions, DoctorPromptCallbacks, DoctorResult, FixAction, FixResult };
+//# sourceMappingURL=types.d.ts.map

package/dist/services/doctor/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/services/doctor/types.ts"],"sourcesContent":[],"mappings":";;AASA;AAWA;AAYA;AAYA;AAKA;AAUA;AAUA;AAEY,KA9DA,aAAA,GA8DA,KAAA,GAAA,QAAA,GAAA,KAAA,GAAA,MAAA,GAAA,WAAA,GAAA,IAAA;;;;AAgBK,cAnEJ,oBAuEE,EAvEoB,aAuEP,EAAA;AAY5B;AAkBA;AAUA;cAnGa,uBAAuB,OAAO;;;;KAY/B,WAAA;;;;UAKK,SAAA;;;;;;;;;UAUA,SAAA;;;;eAIF,QAAQ;;;;;UAMN,WAAA;;YAEL;;;;UAIF;;;;QAIF;;;;;;;UAQS,aAAA;;;;eAIF;;;;;;;;;;;UAYE,YAAA;;UAEP;;;;;;;;;;;;;;;UAgBO,qBAAA;;gCAEe;;;;QAEgC;;;;;UAM/C,YAAA"}

package/dist/services/doctor/types.js

@@ -1 +1,27 @@
-const e=[`cli`,`config`,`mcp`,`deps`,`workspace`,`ai`],t={cli:`CLI Installation`,config:`Configuration Files`,mcp:`MCP Server`,deps:`Dependencies`,workspace:`Workspace Structure`,ai:`AI Provider`};export{e as ALL_CHECK_CATEGORIES,t as CHECK_CATEGORY_LABELS};
+//#region src/services/doctor/types.ts
+/**
+* All available check categories.
+*/
+const ALL_CHECK_CATEGORIES = [
+	"cli",
+	"config",
+	"mcp",
+	"deps",
+	"workspace",
+	"ai"
+];
+/**
+* Human-readable labels for check categories.
+*/
+const CHECK_CATEGORY_LABELS = {
+	cli: "CLI Installation",
+	config: "Configuration Files",
+	mcp: "MCP Server",
+	deps: "Dependencies",
+	workspace: "Workspace Structure",
+	ai: "AI Provider"
+};
+
+//#endregion
+export { ALL_CHECK_CATEGORIES, CHECK_CATEGORY_LABELS };
+//# sourceMappingURL=types.js.map

package/dist/services/doctor/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":["ALL_CHECK_CATEGORIES: CheckCategory[]","CHECK_CATEGORY_LABELS: Record<CheckCategory, string>"],"sources":["../../../src/services/doctor/types.ts"],"sourcesContent":["/**\n * Doctor service types.\n *\n * Types for health checks and auto-fix functionality.\n */\n\n/**\n * Categories of health checks.\n */\nexport type CheckCategory =\n  | 'cli'\n  | 'config'\n  | 'mcp'\n  | 'deps'\n  | 'workspace'\n  | 'ai';\n\n/**\n * All available check categories.\n */\nexport const ALL_CHECK_CATEGORIES: CheckCategory[] = [\n  'cli',\n  'config',\n  'mcp',\n  'deps',\n  'workspace',\n  'ai',\n];\n\n/**\n * Human-readable labels for check categories.\n */\nexport const CHECK_CATEGORY_LABELS: Record<CheckCategory, string> = {\n  cli: 'CLI Installation',\n  config: 'Configuration Files',\n  mcp: 'MCP Server',\n  deps: 'Dependencies',\n  workspace: 'Workspace Structure',\n  ai: 'AI Provider',\n};\n\n/**\n * Status of a health check.\n */\nexport type CheckStatus = 'pass' | 'warn' | 'fail' | 'skip';\n\n/**\n * Result of applying a fix.\n */\nexport interface FixResult {\n  /** Whether the fix was successful. */\n  success: boolean;\n  /** Message describing the result. */\n  message: string;\n}\n\n/**\n * An action that can fix a failed check.\n */\nexport interface FixAction {\n  /** Description of what the fix will do. */\n  description: string;\n  /** Function to apply the fix. */\n  apply: () => Promise<FixResult>;\n}\n\n/**\n * Result of a single health check.\n */\nexport interface CheckResult {\n  /** Category of the check. */\n  category: CheckCategory;\n  /** Name of the specific check. */\n  name: string;\n  /** Status of the check. */\n  status: CheckStatus;\n  /** Human-readable message. */\n  message: string;\n  /** Optional fix action if status is 'fail' or 'warn'. */\n  fix?: FixAction;\n  /** Additional details for debugging. */\n  details?: string;\n}\n\n/**\n * Options for running the doctor.\n */\nexport interface DoctorOptions {\n  /** Root directory of the workspace. */\n  workspaceRoot: string;\n  /** Categories to check (defaults to all). */\n  categories?: CheckCategory[];\n  /** If true, auto-apply fixes without prompting. */\n  autoFix?: boolean;\n  /** Skip AI provider checks. */\n  skipAi?: boolean;\n  /** Verbose output. */\n  verbose?: boolean;\n}\n\n/**\n * Summary of doctor results.\n */\nexport interface DoctorResult {\n  /** All check results. */\n  checks: CheckResult[];\n  /** Number of passing checks. */\n  passed: number;\n  /** Number of warnings. */\n  warnings: number;\n  /** Number of failures. */\n  failures: number;\n  /** Number of skipped checks. */\n  skipped: number;\n  /** Overall health status. */\n  healthy: boolean;\n}\n\n/**\n * Callback for interactive prompts during doctor.\n */\nexport interface DoctorPromptCallbacks {\n  /** Confirm a fix action. */\n  confirm: (message: string) => Promise<boolean>;\n  /** Input a value (e.g., API key). */\n  input: (message: string, options?: { password?: boolean }) => Promise<string>;\n}\n\n/**\n * Context passed to check functions.\n */\nexport interface CheckContext {\n  /** Workspace root path (monorepo root or single project root). */\n  workspaceRoot: string;\n  /** Current package root (may differ from workspaceRoot in monorepos). */\n  packageRoot: string;\n  /** Whether this is a monorepo. */\n  isMonorepo: boolean;\n  /** Current package name (if in a monorepo package). */\n  packageName?: string;\n  /** Whether verbose output is enabled. */\n  verbose: boolean;\n}\n"],"mappings":";;;;AAoBA,MAAaA,uBAAwC;CACnD;CACA;CACA;CACA;CACA;CACA;CACD;;;;AAKD,MAAaC,wBAAuD;CAClE,KAAK;CACL,QAAQ;CACR,KAAK;CACL,MAAM;CACN,WAAW;CACX,IAAI;CACL"}

package/dist/services/impact/formatters.d.ts

@@ -0,0 +1,27 @@
+import { CheckRunPayload, PrCommentOptions } from "./types.js";
+import { index_d_exports } from "../../index.js";
+
+//#region src/services/impact/formatters.d.ts
+
+/**
+ * Format impact result as a PR comment (markdown).
+ */
+declare function formatPrComment(result: index_d_exports.ImpactResult, options?: PrCommentOptions): string;
+/**
+ * Format impact result for minimal PR comment.
+ */
+declare function formatMinimalComment(result: index_d_exports.ImpactResult): string;
+/**
+ * Format impact result as GitHub check run payload.
+ */
+declare function formatCheckRun(result: index_d_exports.ImpactResult, headSha: string, options?: {
+  key?: string;
+  failOnBreaking?: boolean;
+}): CheckRunPayload;
+/**
+ * Format impact result as JSON.
+ */
+declare function formatJson(result: index_d_exports.ImpactResult): string;
+//#endregion
+export { formatCheckRun, formatJson, formatMinimalComment, formatPrComment };
+//# sourceMappingURL=formatters.d.ts.map

package/dist/services/impact/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","names":[],"sources":["../../../src/services/impact/formatters.ts"],"sourcesContent":[],"mappings":";;;;;;;;iBAegB,eAAA,SACN,eAAA,CAAA,wBACC;;;;iBAyGK,oBAAA,SAA6B,eAAA,CAAA;;;;iBAa7B,cAAA,SACN,eAAA,CAAA;;;IAGP;;;;iBA2Ca,UAAA,SAAmB,eAAA,CAAA"}

package/dist/services/impact/formatters.js

@@ -0,0 +1,111 @@
+//#region src/services/impact/formatters.ts
+/**
+* Format impact result as a PR comment (markdown).
+*/
+function formatPrComment(result, options = { template: "detailed" }) {
+	const lines = [];
+	lines.push("## 📋 ContractSpec Impact Analysis");
+	lines.push("");
+	if (result.hasBreaking) lines.push("❌ **Breaking changes detected**");
+	else if (result.hasNonBreaking) lines.push("⚠️ **Contract changed (non-breaking)**");
+	else lines.push("✅ **No contract impact**");
+	lines.push("");
+	if (result.summary.breaking > 0 || result.summary.nonBreaking > 0 || result.summary.info > 0) {
+		lines.push("### Summary");
+		lines.push("");
+		lines.push(`| Type | Count |`);
+		lines.push(`|------|-------|`);
+		if (result.summary.breaking > 0) lines.push(`| 🔴 Breaking | ${result.summary.breaking} |`);
+		if (result.summary.nonBreaking > 0) lines.push(`| 🟡 Non-breaking | ${result.summary.nonBreaking} |`);
+		if (result.summary.info > 0) lines.push(`| 🔵 Info | ${result.summary.info} |`);
+		if (result.summary.added > 0) lines.push(`| ➕ Added | ${result.summary.added} |`);
+		if (result.summary.removed > 0) lines.push(`| ➖ Removed | ${result.summary.removed} |`);
+		lines.push("");
+	}
+	if (options.template === "detailed" && result.deltas.length > 0) {
+		lines.push("### Changes");
+		lines.push("");
+		const breaking = result.deltas.filter((d) => d.severity === "breaking");
+		const nonBreaking = result.deltas.filter((d) => d.severity === "non_breaking");
+		if (breaking.length > 0) {
+			lines.push("#### 🔴 Breaking Changes");
+			lines.push("");
+			for (const delta of breaking) lines.push(`- **${delta.specKey}**: ${delta.description}`);
+			lines.push("");
+		}
+		if (nonBreaking.length > 0) {
+			lines.push("#### 🟡 Non-breaking Changes");
+			lines.push("");
+			for (const delta of nonBreaking) lines.push(`- **${delta.specKey}**: ${delta.description}`);
+			lines.push("");
+		}
+	}
+	if (result.addedSpecs.length > 0) {
+		lines.push("### Added Specs");
+		lines.push("");
+		for (const spec of result.addedSpecs) lines.push(`- \`${spec.key}\` v${spec.version} (${spec.type})`);
+		lines.push("");
+	}
+	if (result.removedSpecs.length > 0) {
+		lines.push("### Removed Specs");
+		lines.push("");
+		for (const spec of result.removedSpecs) lines.push(`- \`${spec.key}\` v${spec.version} (${spec.type})`);
+		lines.push("");
+	}
+	lines.push("---");
+	lines.push(`*Generated by ContractSpec at ${result.timestamp}*`);
+	return lines.join("\n");
+}
+/**
+* Format impact result for minimal PR comment.
+*/
+function formatMinimalComment(result) {
+	if (result.hasBreaking) return `❌ **Breaking changes detected** (${result.summary.breaking} breaking, ${result.summary.nonBreaking} non-breaking)`;
+	if (result.hasNonBreaking) return `⚠️ **Contract changed** (${result.summary.nonBreaking} non-breaking changes)`;
+	return "✅ **No contract impact**";
+}
+/**
+* Format impact result as GitHub check run payload.
+*/
+function formatCheckRun(result, headSha, options = {}) {
+	const name = options.key ?? "ContractSpec Impact";
+	const failOnBreaking = options.failOnBreaking ?? true;
+	let conclusion;
+	let title;
+	if (result.hasBreaking) {
+		conclusion = failOnBreaking ? "failure" : "neutral";
+		title = `Breaking changes detected (${result.summary.breaking})`;
+	} else if (result.hasNonBreaking) {
+		conclusion = "success";
+		title = `Non-breaking changes (${result.summary.nonBreaking})`;
+	} else {
+		conclusion = "success";
+		title = "No contract impact";
+	}
+	const summary = formatMinimalComment(result);
+	return {
+		name,
+		headSha,
+		conclusion,
+		title,
+		summary,
+		annotations: result.deltas.filter((d) => d.severity === "breaking").slice(0, 50).map((d) => ({
+			path: d.path,
+			startLine: 1,
+			endLine: 1,
+			annotationLevel: "failure",
+			message: d.description,
+			title: `Breaking: ${d.rule}`
+		}))
+	};
+}
+/**
+* Format impact result as JSON.
+*/
+function formatJson(result) {
+	return JSON.stringify(result, null, 2);
+}
+
+//#endregion
+export { formatCheckRun, formatJson, formatMinimalComment, formatPrComment };
+//# sourceMappingURL=formatters.js.map

package/dist/services/impact/formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.js","names":["lines: string[]","conclusion: 'success' | 'failure' | 'neutral'","title: string"],"sources":["../../../src/services/impact/formatters.ts"],"sourcesContent":["/**\n * Impact result formatters.\n *\n * Formats impact detection results for various outputs:\n * - PR comments (markdown)\n * - GitHub check runs\n * - JSON output\n */\n\nimport type { ImpactResult } from '../../index';\nimport type { CheckRunPayload, PrCommentOptions } from './types';\n\n/**\n * Format impact result as a PR comment (markdown).\n */\nexport function formatPrComment(\n  result: ImpactResult,\n  options: PrCommentOptions = { template: 'detailed' }\n): string {\n  const lines: string[] = [];\n\n  // Header with status\n  lines.push('## 📋 ContractSpec Impact Analysis');\n  lines.push('');\n\n  // Status badge\n  if (result.hasBreaking) {\n    lines.push('❌ **Breaking changes detected**');\n  } else if (result.hasNonBreaking) {\n    lines.push('⚠️ **Contract changed (non-breaking)**');\n  } else {\n    lines.push('✅ **No contract impact**');\n  }\n  lines.push('');\n\n  // Summary\n  if (\n    result.summary.breaking > 0 ||\n    result.summary.nonBreaking > 0 ||\n    result.summary.info > 0\n  ) {\n    lines.push('### Summary');\n    lines.push('');\n    lines.push(`| Type | Count |`);\n    lines.push(`|------|-------|`);\n    if (result.summary.breaking > 0) {\n      lines.push(`| 🔴 Breaking | ${result.summary.breaking} |`);\n    }\n    if (result.summary.nonBreaking > 0) {\n      lines.push(`| 🟡 Non-breaking | ${result.summary.nonBreaking} |`);\n    }\n    if (result.summary.info > 0) {\n      lines.push(`| 🔵 Info | ${result.summary.info} |`);\n    }\n    if (result.summary.added > 0) {\n      lines.push(`| ➕ Added | ${result.summary.added} |`);\n    }\n    if (result.summary.removed > 0) {\n      lines.push(`| ➖ Removed | ${result.summary.removed} |`);\n    }\n    lines.push('');\n  }\n\n  // Detailed changes (if detailed template)\n  if (options.template === 'detailed' && result.deltas.length > 0) {\n    lines.push('### Changes');\n    lines.push('');\n\n    // Group by severity\n    const breaking = result.deltas.filter((d) => d.severity === 'breaking');\n    const nonBreaking = result.deltas.filter(\n      (d) => d.severity === 'non_breaking'\n    );\n\n    if (breaking.length > 0) {\n      lines.push('#### 🔴 Breaking Changes');\n      lines.push('');\n      for (const delta of breaking) {\n        lines.push(`- **${delta.specKey}**: ${delta.description}`);\n      }\n      lines.push('');\n    }\n\n    if (nonBreaking.length > 0) {\n      lines.push('#### 🟡 Non-breaking Changes');\n      lines.push('');\n      for (const delta of nonBreaking) {\n        lines.push(`- **${delta.specKey}**: ${delta.description}`);\n      }\n      lines.push('');\n    }\n  }\n\n  // Added/removed specs\n  if (result.addedSpecs.length > 0) {\n    lines.push('### Added Specs');\n    lines.push('');\n    for (const spec of result.addedSpecs) {\n      lines.push(`- \\`${spec.key}\\` v${spec.version} (${spec.type})`);\n    }\n    lines.push('');\n  }\n\n  if (result.removedSpecs.length > 0) {\n    lines.push('### Removed Specs');\n    lines.push('');\n    for (const spec of result.removedSpecs) {\n      lines.push(`- \\`${spec.key}\\` v${spec.version} (${spec.type})`);\n    }\n    lines.push('');\n  }\n\n  // Footer\n  lines.push('---');\n  lines.push(`*Generated by ContractSpec at ${result.timestamp}*`);\n\n  return lines.join('\\n');\n}\n\n/**\n * Format impact result for minimal PR comment.\n */\nexport function formatMinimalComment(result: ImpactResult): string {\n  if (result.hasBreaking) {\n    return `❌ **Breaking changes detected** (${result.summary.breaking} breaking, ${result.summary.nonBreaking} non-breaking)`;\n  }\n  if (result.hasNonBreaking) {\n    return `⚠️ **Contract changed** (${result.summary.nonBreaking} non-breaking changes)`;\n  }\n  return '✅ **No contract impact**';\n}\n\n/**\n * Format impact result as GitHub check run payload.\n */\nexport function formatCheckRun(\n  result: ImpactResult,\n  headSha: string,\n  options: { key?: string; failOnBreaking?: boolean } = {}\n): CheckRunPayload {\n  const name = options.key ?? 'ContractSpec Impact';\n  const failOnBreaking = options.failOnBreaking ?? true;\n\n  let conclusion: 'success' | 'failure' | 'neutral';\n  let title: string;\n\n  if (result.hasBreaking) {\n    conclusion = failOnBreaking ? 'failure' : 'neutral';\n    title = `Breaking changes detected (${result.summary.breaking})`;\n  } else if (result.hasNonBreaking) {\n    conclusion = 'success';\n    title = `Non-breaking changes (${result.summary.nonBreaking})`;\n  } else {\n    conclusion = 'success';\n    title = 'No contract impact';\n  }\n\n  const summary = formatMinimalComment(result);\n\n  return {\n    name,\n    headSha,\n    conclusion,\n    title,\n    summary,\n    annotations: result.deltas\n      .filter((d) => d.severity === 'breaking')\n      .slice(0, 50) // GitHub limit\n      .map((d) => ({\n        path: d.path,\n        startLine: 1,\n        endLine: 1,\n        annotationLevel: 'failure' as const,\n        message: d.description,\n        title: `Breaking: ${d.rule}`,\n      })),\n  };\n}\n\n/**\n * Format impact result as JSON.\n */\nexport function formatJson(result: ImpactResult): string {\n  return JSON.stringify(result, null, 2);\n}\n"],"mappings":"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"}

package/dist/services/impact/impact-detection-service.d.ts

@@ -0,0 +1,22 @@
+import { FsAdapter } from "../../ports/fs.js";
+import { GitAdapter } from "../../ports/git.js";
+import { LoggerAdapter } from "../../ports/logger.js";
+import { ImpactDetectionOptions, ImpactDetectionResult } from "./types.js";
+
+//#region src/services/impact/impact-detection-service.d.ts
+
+/**
+ * Detect the impact of contract changes between baseline and current state.
+ *
+ * @param adapters - Required adapters (fs, git, logger)
+ * @param options - Detection options
+ * @returns Impact detection result
+ */
+declare function detectImpact(adapters: {
+  fs: FsAdapter;
+  git: GitAdapter;
+  logger: LoggerAdapter;
+}, options?: ImpactDetectionOptions): Promise<ImpactDetectionResult>;
+//#endregion
+export { detectImpact };
+//# sourceMappingURL=impact-detection-service.d.ts.map

package/dist/services/impact/impact-detection-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact-detection-service.d.ts","names":[],"sources":["../../../src/services/impact/impact-detection-service.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;iBA2BsB,YAAA;MACJ;OAAgB;UAAoB;aAC3C,yBACR,QAAQ"}

package/dist/services/impact/impact-detection-service.js

@@ -0,0 +1,96 @@
+import { src_exports } from "../../index.js";
+
+//#region src/services/impact/impact-detection-service.ts
+/**
+* Impact detection service.
+*
+* Orchestrates contract snapshot generation, diff computation,
+* and impact classification for CI/CD pipelines.
+*/
+/**
+* Detect the impact of contract changes between baseline and current state.
+*
+* @param adapters - Required adapters (fs, git, logger)
+* @param options - Detection options
+* @returns Impact detection result
+*/
+async function detectImpact(adapters, options = {}) {
+	const { fs, git, logger } = adapters;
+	const workspaceRoot = options.workspaceRoot ?? process.cwd();
+	logger.info("Starting impact detection...", { baseline: options.baseline });
+	const specFiles = (await fs.glob({
+		pattern: options.pattern ?? "**/*.{operation,event}.ts",
+		cwd: workspaceRoot
+	})).filter((f) => !f.includes(".test.") && !f.includes(".spec.") && !f.includes("node_modules"));
+	logger.debug(`Found ${specFiles.length} spec files`);
+	const headSnapshot = (0, src_exports.generateSnapshot)(await loadSpecs(fs, specFiles, workspaceRoot));
+	let baseSnapshot;
+	if (options.baseline) baseSnapshot = (0, src_exports.generateSnapshot)(await loadBaselineSpecs(fs, git, specFiles, options.baseline, workspaceRoot));
+	else baseSnapshot = {
+		version: 1,
+		generatedAt: "",
+		specs: [],
+		hash: ""
+	};
+	const diffs = computeSnapshotDiffs(baseSnapshot.specs, headSnapshot.specs);
+	const impactResult = (0, src_exports.classifyImpact)(baseSnapshot.specs, headSnapshot.specs, diffs);
+	logger.info("Impact detection complete", {
+		status: impactResult.status,
+		breaking: impactResult.summary.breaking,
+		nonBreaking: impactResult.summary.nonBreaking
+	});
+	return {
+		...impactResult,
+		workspaceRoot,
+		specsAnalyzed: specFiles.length,
+		baseRef: options.baseline
+	};
+}
+/**
+* Load specs from current filesystem.
+*/
+async function loadSpecs(fs, files, _workspaceRoot) {
+	const specs = [];
+	for (const file of files) {
+		const content = await fs.readFile(file);
+		specs.push({
+			path: file,
+			content
+		});
+	}
+	return specs;
+}
+/**
+* Load specs from git baseline.
+*/
+async function loadBaselineSpecs(_fs, git, files, baseline, _workspaceRoot) {
+	const specs = [];
+	for (const file of files) try {
+		const content = await git.showFile(baseline, file);
+		specs.push({
+			path: file,
+			content
+		});
+	} catch {}
+	return specs;
+}
+/**
+* Compute diffs between two sets of spec snapshots.
+*/
+function computeSnapshotDiffs(baseSpecs, headSpecs) {
+	const diffs = [];
+	const baseMap = new Map(baseSpecs.map((s) => [`${s.key}@${s.version}`, s]));
+	const headMap = new Map(headSpecs.map((s) => [`${s.key}@${s.version}`, s]));
+	for (const [key, headSpec] of headMap) {
+		const baseSpec = baseMap.get(key);
+		if (baseSpec && headSpec.type === "operation" && baseSpec.type === "operation") {
+			const ioDiffs = (0, src_exports.computeIoDiff)(baseSpec.io, headSpec.io);
+			diffs.push(...ioDiffs);
+		}
+	}
+	return diffs;
+}
+
+//#endregion
+export { detectImpact };
+//# sourceMappingURL=impact-detection-service.js.map

package/dist/services/impact/impact-detection-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact-detection-service.js","names":["baseSnapshot: ContractSnapshot","specs: { path: string; content: string }[]","diffs: ReturnType<typeof computeIoDiff>"],"sources":["../../../src/services/impact/impact-detection-service.ts"],"sourcesContent":["/**\n * Impact detection service.\n *\n * Orchestrates contract snapshot generation, diff computation,\n * and impact classification for CI/CD pipelines.\n */\n\n// Note: Using internal imports from the bundle which re-exports from module\nimport {\n  classifyImpact,\n  computeIoDiff,\n  generateSnapshot,\n  type ContractSnapshot,\n  type SpecSnapshot,\n} from '../../index';\nimport type { FsAdapter } from '../../ports/fs';\nimport type { GitAdapter } from '../../ports/git';\nimport type { LoggerAdapter } from '../../ports/logger';\nimport type { ImpactDetectionOptions, ImpactDetectionResult } from './types';\n\n/**\n * Detect the impact of contract changes between baseline and current state.\n *\n * @param adapters - Required adapters (fs, git, logger)\n * @param options - Detection options\n * @returns Impact detection result\n */\nexport async function detectImpact(\n  adapters: { fs: FsAdapter; git: GitAdapter; logger: LoggerAdapter },\n  options: ImpactDetectionOptions = {}\n): Promise<ImpactDetectionResult> {\n  const { fs, git, logger } = adapters;\n  const workspaceRoot = options.workspaceRoot ?? process.cwd();\n\n  logger.info('Starting impact detection...', { baseline: options.baseline });\n\n  // Discover spec files\n  const files = await fs.glob({\n    pattern: options.pattern ?? '**/*.{operation,event}.ts',\n    cwd: workspaceRoot,\n  });\n\n  const specFiles = files.filter(\n    (f) =>\n      !f.includes('.test.') &&\n      !f.includes('.spec.') &&\n      !f.includes('node_modules')\n  );\n\n  logger.debug(`Found ${specFiles.length} spec files`);\n\n  // Load current (head) specs\n  const headSpecs = await loadSpecs(fs, specFiles, workspaceRoot);\n  const headSnapshot = generateSnapshot(headSpecs);\n\n  // Load baseline specs if specified\n  let baseSnapshot: ContractSnapshot;\n  if (options.baseline) {\n    const baseSpecs = await loadBaselineSpecs(\n      fs,\n      git,\n      specFiles,\n      options.baseline,\n      workspaceRoot\n    );\n    baseSnapshot = generateSnapshot(baseSpecs);\n  } else {\n    // No baseline means all specs are \"new\"\n    baseSnapshot = { version: 1, generatedAt: '', specs: [], hash: '' };\n  }\n\n  // Compute diffs between snapshots\n  const diffs = computeSnapshotDiffs(baseSnapshot.specs, headSnapshot.specs);\n\n  // Classify the impact\n  const impactResult = classifyImpact(\n    baseSnapshot.specs,\n    headSnapshot.specs,\n    diffs\n  );\n\n  logger.info('Impact detection complete', {\n    status: impactResult.status,\n    breaking: impactResult.summary.breaking,\n    nonBreaking: impactResult.summary.nonBreaking,\n  });\n\n  return {\n    ...impactResult,\n    workspaceRoot,\n    specsAnalyzed: specFiles.length,\n    baseRef: options.baseline,\n  };\n}\n\n/**\n * Load specs from current filesystem.\n */\nasync function loadSpecs(\n  fs: FsAdapter,\n  files: string[],\n  _workspaceRoot: string\n): Promise<{ path: string; content: string }[]> {\n  const specs: { path: string; content: string }[] = [];\n\n  for (const file of files) {\n    const content = await fs.readFile(file);\n    specs.push({ path: file, content });\n  }\n\n  return specs;\n}\n\n/**\n * Load specs from git baseline.\n */\nasync function loadBaselineSpecs(\n  _fs: FsAdapter,\n  git: GitAdapter,\n  files: string[],\n  baseline: string,\n  _workspaceRoot: string\n): Promise<{ path: string; content: string }[]> {\n  const specs: { path: string; content: string }[] = [];\n\n  for (const file of files) {\n    try {\n      const content = await git.showFile(baseline, file);\n      specs.push({ path: file, content });\n    } catch {\n      // File doesn't exist in baseline - skip (it's new)\n    }\n  }\n\n  return specs;\n}\n\n/**\n * Compute diffs between two sets of spec snapshots.\n */\nfunction computeSnapshotDiffs(\n  baseSpecs: SpecSnapshot[],\n  headSpecs: SpecSnapshot[]\n): ReturnType<typeof computeIoDiff> {\n  const diffs: ReturnType<typeof computeIoDiff> = [];\n\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  // Compare specs that exist in both\n  for (const [key, headSpec] of headMap) {\n    const baseSpec = baseMap.get(key);\n    if (\n      baseSpec &&\n      headSpec.type === 'operation' &&\n      baseSpec.type === 'operation'\n    ) {\n      const ioDiffs = computeIoDiff(baseSpec.io, headSpec.io);\n      diffs.push(...ioDiffs);\n    }\n  }\n\n  return diffs;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AA2BA,eAAsB,aACpB,UACA,UAAkC,EAAE,EACJ;CAChC,MAAM,EAAE,IAAI,KAAK,WAAW;CAC5B,MAAM,gBAAgB,QAAQ,iBAAiB,QAAQ,KAAK;AAE5D,QAAO,KAAK,gCAAgC,EAAE,UAAU,QAAQ,UAAU,CAAC;CAQ3E,MAAM,aALQ,MAAM,GAAG,KAAK;EAC1B,SAAS,QAAQ,WAAW;EAC5B,KAAK;EACN,CAAC,EAEsB,QACrB,MACC,CAAC,EAAE,SAAS,SAAS,IACrB,CAAC,EAAE,SAAS,SAAS,IACrB,CAAC,EAAE,SAAS,eAAe,CAC9B;AAED,QAAO,MAAM,SAAS,UAAU,OAAO,aAAa;CAIpD,MAAM,iDADY,MAAM,UAAU,IAAI,WAAW,cAAc,CACf;CAGhD,IAAIA;AACJ,KAAI,QAAQ,SAQV,kDAPkB,MAAM,kBACtB,IACA,KACA,WACA,QAAQ,UACR,cACD,CACyC;KAG1C,gBAAe;EAAE,SAAS;EAAG,aAAa;EAAI,OAAO,EAAE;EAAE,MAAM;EAAI;CAIrE,MAAM,QAAQ,qBAAqB,aAAa,OAAO,aAAa,MAAM;CAG1E,MAAM,+CACJ,aAAa,OACb,aAAa,OACb,MACD;AAED,QAAO,KAAK,6BAA6B;EACvC,QAAQ,aAAa;EACrB,UAAU,aAAa,QAAQ;EAC/B,aAAa,aAAa,QAAQ;EACnC,CAAC;AAEF,QAAO;EACL,GAAG;EACH;EACA,eAAe,UAAU;EACzB,SAAS,QAAQ;EAClB;;;;;AAMH,eAAe,UACb,IACA,OACA,gBAC8C;CAC9C,MAAMC,QAA6C,EAAE;AAErD,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,UAAU,MAAM,GAAG,SAAS,KAAK;AACvC,QAAM,KAAK;GAAE,MAAM;GAAM;GAAS,CAAC;;AAGrC,QAAO;;;;;AAMT,eAAe,kBACb,KACA,KACA,OACA,UACA,gBAC8C;CAC9C,MAAMA,QAA6C,EAAE;AAErD,MAAK,MAAM,QAAQ,MACjB,KAAI;EACF,MAAM,UAAU,MAAM,IAAI,SAAS,UAAU,KAAK;AAClD,QAAM,KAAK;GAAE,MAAM;GAAM;GAAS,CAAC;SAC7B;AAKV,QAAO;;;;;AAMT,SAAS,qBACP,WACA,WACkC;CAClC,MAAMC,QAA0C,EAAE;CAElD,MAAM,UAAU,IAAI,IAAI,UAAU,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC;CAC3E,MAAM,UAAU,IAAI,IAAI,UAAU,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC;AAG3E,MAAK,MAAM,CAAC,KAAK,aAAa,SAAS;EACrC,MAAM,WAAW,QAAQ,IAAI,IAAI;AACjC,MACE,YACA,SAAS,SAAS,eAClB,SAAS,SAAS,aAClB;GACA,MAAM,yCAAwB,SAAS,IAAI,SAAS,GAAG;AACvD,SAAM,KAAK,GAAG,QAAQ;;;AAI1B,QAAO"}

package/dist/services/impact/index.d.ts

@@ -0,0 +1,11 @@
+import { CheckRunAnnotation, CheckRunPayload, ImpactDetectionOptions, ImpactDetectionResult, ImpactResult, PrCommentOptions } from "./types.js";
+import { detectImpact } from "./impact-detection-service.js";
+import { formatCheckRun, formatJson, formatMinimalComment, formatPrComment } from "./formatters.js";
+
+//#region src/services/impact/index.d.ts
+declare namespace index_d_exports {
+  export { CheckRunAnnotation, CheckRunPayload, ImpactDetectionOptions, ImpactDetectionResult, ImpactResult, PrCommentOptions, detectImpact, formatCheckRun, formatJson, formatMinimalComment, formatPrComment };
+}
+//#endregion
+export { index_d_exports };
+//# sourceMappingURL=index.d.ts.map

package/dist/services/impact/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/services/impact/index.ts"],"sourcesContent":[],"mappings":""}

package/dist/services/impact/index.js

@@ -0,0 +1,16 @@
+import { __exportAll } from "../../_virtual/rolldown_runtime.js";
+import { detectImpact } from "./impact-detection-service.js";
+import { formatCheckRun, formatJson, formatMinimalComment, formatPrComment } from "./formatters.js";
+
+//#region src/services/impact/index.ts
+var impact_exports = /* @__PURE__ */ __exportAll({
+	detectImpact: () => detectImpact,
+	formatCheckRun: () => formatCheckRun,
+	formatJson: () => formatJson,
+	formatMinimalComment: () => formatMinimalComment,
+	formatPrComment: () => formatPrComment
+});
+
+//#endregion
+export { impact_exports };
+//# sourceMappingURL=index.js.map

package/dist/services/impact/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/services/impact/index.ts"],"sourcesContent":["/**\n * Impact detection service module.\n */\n\nexport * from './types';\nexport { detectImpact } from './impact-detection-service';\nexport {\n  formatPrComment,\n  formatMinimalComment,\n  formatCheckRun,\n  formatJson,\n} from './formatters';\n"],"mappings":""}

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

@@ -0,0 +1,58 @@
+import { ImpactResult } from "@lssm/module.contractspec-workspace";
+
+//#region src/services/impact/types.d.ts
+
+/** Options for impact detection */
+interface ImpactDetectionOptions {
+  /** Git ref to compare against (branch, tag, commit) */
+  baseline?: string;
+  /** Glob pattern for spec discovery */
+  pattern?: string;
+  /** Workspace root directory */
+  workspaceRoot?: string;
+}
+/** Impact detection result with additional context */
+interface ImpactDetectionResult extends ImpactResult {
+  /** Working directory */
+  workspaceRoot: string;
+  /** Number of specs analyzed */
+  specsAnalyzed: number;
+}
+/** PR comment options */
+interface PrCommentOptions {
+  /** Template style */
+  template: 'minimal' | 'detailed';
+  /** Include links to files */
+  includeLinks?: boolean;
+  /** Repository URL for links */
+  repositoryUrl?: string;
+  /** Commit SHA for links */
+  commitSha?: string;
+}
+/** GitHub check run payload */
+interface CheckRunPayload {
+  /** Check run name */
+  name: string;
+  /** Head SHA */
+  headSha: string;
+  /** Conclusion */
+  conclusion: 'success' | 'failure' | 'neutral';
+  /** Output title */
+  title: string;
+  /** Output summary */
+  summary: string;
+  /** Annotations */
+  annotations?: CheckRunAnnotation[];
+}
+/** Check run annotation */
+interface CheckRunAnnotation {
+  path: string;
+  startLine: number;
+  endLine: number;
+  annotationLevel: 'notice' | 'warning' | 'failure';
+  message: string;
+  title?: string;
+}
+//#endregion
+export { CheckRunAnnotation, CheckRunPayload, ImpactDetectionOptions, ImpactDetectionResult, type ImpactResult, PrCommentOptions };
+//# sourceMappingURL=types.d.ts.map

package/dist/services/impact/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/services/impact/types.ts"],"sourcesContent":[],"mappings":";;;;AA4BA;AAYiB,UA9BA,sBAAA,CA0CD;EAIC;;;;;;;;UApCA,qBAAA,SAA8B;;;;;;;UAQ9B,gBAAA;;;;;;;;;;;UAYA,eAAA;;;;;;;;;;;;gBAYD;;;UAIC,kBAAA"}

package/dist/services/implementation/discovery.d.ts

@@ -0,0 +1,30 @@
+import { FsAdapter } from "../../ports/fs.js";
+import { DiscoveryOptions, SpecReferenceMatch } from "./types.js";
+import { ImplementationType } from "@lssm/lib.contracts";
+
+//#region src/services/implementation/discovery.d.ts
+
+/**
+ * Infer implementation type from file path.
+ */
+declare function inferImplementationType(filePath: string): ImplementationType;
+/**
+ * Extract spec references from source code.
+ */
+declare function extractSpecReferences(code: string, filePath: string): SpecReferenceMatch[];
+/**
+ * Discover implementations that reference a specific spec.
+ */
+declare function discoverImplementationsForSpec(specKey: string, adapters: {
+  fs: FsAdapter;
+}, options?: DiscoveryOptions): Promise<SpecReferenceMatch[]>;
+/**
+ * Discover all spec references in the workspace.
+ * Returns a map of spec key to implementation references.
+ */
+declare function discoverAllImplementations(adapters: {
+  fs: FsAdapter;
+}, options?: DiscoveryOptions): Promise<Map<string, SpecReferenceMatch[]>>;
+//#endregion
+export { discoverAllImplementations, discoverImplementationsForSpec, extractSpecReferences, inferImplementationType };
+//# sourceMappingURL=discovery.d.ts.map

package/dist/services/implementation/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","names":[],"sources":["../../../src/services/implementation/discovery.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAsLU,iBAnIM,uBAAA,CAmIN,QAAA,EAAA,MAAA,CAAA,EAnIiD,kBAmIjD;AAkCV;;;AAGuB,iBAhJP,qBAAA,CAgJO,IAAA,EAAA,MAAA,EAAA,QAAA,EAAA,MAAA,CAAA,EA7IpB,kBA6IoB,EAAA;;;;iBAzCD,8BAAA;MAEJ;aACP,mBACR,QAAQ;;;;;iBAkCW,0BAAA;MACJ;aACP,mBACR,QAAQ,YAAY"}