@contractspec/bundle.workspace 1.46.2 → 1.48.0

package/dist/services/doctor/doctor-service.mjs

@@ -0,0 +1,118 @@
+import { findPackageRoot, findWorkspaceRoot, getPackageName, isMonorepo } from "../../adapters/workspace.mjs";
+import { ALL_CHECK_CATEGORIES, CHECK_CATEGORY_LABELS } from "./types.mjs";
+import { runCliChecks } from "./checks/cli.mjs";
+import { runConfigChecks } from "./checks/config.mjs";
+import { runMcpChecks } from "./checks/mcp.mjs";
+import { runDepsChecks } from "./checks/deps.mjs";
+import { runWorkspaceChecks } from "./checks/workspace.mjs";
+import { runAiChecks } from "./checks/ai.mjs";
+import { runLayerChecks } from "./checks/layers.mjs";
+import "./checks/index.mjs";
+
+//#region src/services/doctor/doctor-service.ts
+/**
+* Default prompt callbacks that always decline fixes.
+*/
+const defaultPrompts = {
+	confirm: async () => false,
+	input: async () => ""
+};
+/**
+* Run all health checks and optionally apply fixes.
+*/
+async function runDoctor(adapters, options, prompts = defaultPrompts) {
+	const { fs, logger } = adapters;
+	const categories = options.categories ?? ALL_CHECK_CATEGORIES;
+	const workspaceRoot = findWorkspaceRoot(options.workspaceRoot);
+	const packageRoot = findPackageRoot(options.workspaceRoot);
+	const monorepo = isMonorepo(workspaceRoot);
+	const packageName = monorepo ? getPackageName(packageRoot) : void 0;
+	const ctx = {
+		workspaceRoot,
+		packageRoot,
+		isMonorepo: monorepo,
+		packageName,
+		verbose: options.verbose ?? false
+	};
+	if (monorepo) {
+		const pkgInfo = packageName ? ` (package: ${packageName})` : "";
+		logger.info(`Detected monorepo${pkgInfo}`);
+	}
+	const allResults = [];
+	for (const category of categories) {
+		if (options.skipAi && category === "ai") continue;
+		logger.info(`Checking ${CHECK_CATEGORY_LABELS[category]}...`);
+		const categoryResults = await runCategoryChecks(category, fs, ctx, prompts);
+		for (const result of categoryResults) {
+			if (result.fix && (result.status === "fail" || result.status === "warn")) {
+				if (options.autoFix ? true : await prompts.confirm(`Fix "${result.name}"? ${result.fix.description}`)) {
+					logger.info(`Applying fix: ${result.fix.description}`);
+					const fixResult = await result.fix.apply();
+					if (fixResult.success) {
+						logger.info(`✓ ${fixResult.message}`);
+						result.status = "pass";
+						result.message = `Fixed: ${fixResult.message}`;
+						result.fix = void 0;
+					} else logger.warn(`✗ ${fixResult.message}`);
+				}
+			}
+			allResults.push(result);
+		}
+	}
+	const passed = allResults.filter((r) => r.status === "pass").length;
+	const warnings = allResults.filter((r) => r.status === "warn").length;
+	const failures = allResults.filter((r) => r.status === "fail").length;
+	return {
+		checks: allResults,
+		passed,
+		warnings,
+		failures,
+		skipped: allResults.filter((r) => r.status === "skip").length,
+		healthy: failures === 0
+	};
+}
+/**
+* Run checks for a specific category.
+*/
+async function runCategoryChecks(category, fs, ctx, prompts) {
+	switch (category) {
+		case "cli": return runCliChecks(fs, ctx);
+		case "config": return runConfigChecks(fs, ctx);
+		case "mcp": return runMcpChecks(fs, ctx);
+		case "deps": return runDepsChecks(fs, ctx);
+		case "workspace": return runWorkspaceChecks(fs, ctx);
+		case "ai": return runAiChecks(fs, ctx, prompts);
+		case "layers": return runLayerChecks(fs, ctx);
+		default: return [];
+	}
+}
+/**
+* Get a summary string for the doctor result.
+*/
+function formatDoctorSummary(result) {
+	const lines = [];
+	lines.push("");
+	lines.push("=== Health Check Summary ===");
+	lines.push("");
+	if (result.healthy) lines.push("✓ All checks passed!");
+	else lines.push("✗ Some issues found");
+	lines.push("");
+	lines.push(`  Passed:   ${result.passed}`);
+	lines.push(`  Warnings: ${result.warnings}`);
+	lines.push(`  Failures: ${result.failures}`);
+	lines.push(`  Skipped:  ${result.skipped}`);
+	return lines.join("\n");
+}
+/**
+* Format a single check result for display.
+*/
+function formatCheckResult(result) {
+	let line = `${result.status === "pass" ? "✓" : result.status === "warn" ? "⚠" : result.status === "fail" ? "✗" : "○"} ${result.name}: ${result.message}`;
+	if (result.details) line += `\n    ${result.details}`;
+	if (result.fix) line += `\n    Fix available: ${result.fix.description}`;
+	return line;
+}
+
+//#endregion
+export { formatCheckResult, formatDoctorSummary, runDoctor };
+//# sourceMappingURL=doctor-service.mjs.map

package/dist/services/doctor/doctor-service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-service.mjs","names":[],"sources":["../../../src/services/doctor/doctor-service.ts"],"sourcesContent":["/**\n * Doctor service.\n *\n * Orchestrates health checks and applies fixes.\n */\n\nimport type { FsAdapter } from '../../ports/fs';\nimport type { LoggerAdapter } from '../../ports/logger';\nimport type {\n  CheckCategory,\n  CheckResult,\n  CheckContext,\n  DoctorOptions,\n  DoctorResult,\n  DoctorPromptCallbacks,\n} from './types';\nimport { ALL_CHECK_CATEGORIES, CHECK_CATEGORY_LABELS } from './types';\nimport {\n  runCliChecks,\n  runConfigChecks,\n  runMcpChecks,\n  runDepsChecks,\n  runWorkspaceChecks,\n  runAiChecks,\n  runLayerChecks,\n} from './checks/index';\nimport {\n  findPackageRoot,\n  findWorkspaceRoot,\n  isMonorepo,\n  getPackageName,\n} from '../../adapters/workspace';\n\n/**\n * Default prompt callbacks that always decline fixes.\n */\nconst defaultPrompts: DoctorPromptCallbacks = {\n  confirm: async () => false,\n  input: async () => '',\n};\n\n/**\n * Run all health checks and optionally apply fixes.\n */\nexport async function runDoctor(\n  adapters: { fs: FsAdapter; logger: LoggerAdapter },\n  options: DoctorOptions,\n  prompts: DoctorPromptCallbacks = defaultPrompts\n): Promise<DoctorResult> {\n  const { fs, logger } = adapters;\n  const categories = options.categories ?? ALL_CHECK_CATEGORIES;\n\n  // Detect monorepo context\n  const workspaceRoot = findWorkspaceRoot(options.workspaceRoot);\n  const packageRoot = findPackageRoot(options.workspaceRoot);\n  const monorepo = isMonorepo(workspaceRoot);\n  const packageName = monorepo ? getPackageName(packageRoot) : undefined;\n\n  const ctx: CheckContext = {\n    workspaceRoot,\n    packageRoot,\n    isMonorepo: monorepo,\n    packageName,\n    verbose: options.verbose ?? false,\n  };\n\n  // Log monorepo context if detected\n  if (monorepo) {\n    const pkgInfo = packageName ? ` (package: ${packageName})` : '';\n    logger.info(`Detected monorepo${pkgInfo}`);\n  }\n\n  const allResults: CheckResult[] = [];\n\n  // Run checks for each category\n  for (const category of categories) {\n    if (options.skipAi && category === 'ai') {\n      continue;\n    }\n\n    logger.info(`Checking ${CHECK_CATEGORY_LABELS[category]}...`);\n\n    const categoryResults = await runCategoryChecks(category, fs, ctx, prompts);\n\n    // Apply fixes if enabled\n    for (const result of categoryResults) {\n      if (\n        result.fix &&\n        (result.status === 'fail' || result.status === 'warn')\n      ) {\n        const shouldFix = options.autoFix\n          ? true\n          : await prompts.confirm(\n              `Fix \"${result.name}\"? ${result.fix.description}`\n            );\n\n        if (shouldFix) {\n          logger.info(`Applying fix: ${result.fix.description}`);\n          const fixResult = await result.fix.apply();\n\n          if (fixResult.success) {\n            logger.info(`✓ ${fixResult.message}`);\n            // Update status to pass after successful fix\n            result.status = 'pass';\n            result.message = `Fixed: ${fixResult.message}`;\n            result.fix = undefined;\n          } else {\n            logger.warn(`✗ ${fixResult.message}`);\n          }\n        }\n      }\n\n      allResults.push(result);\n    }\n  }\n\n  // Calculate summary\n  const passed = allResults.filter((r) => r.status === 'pass').length;\n  const warnings = allResults.filter((r) => r.status === 'warn').length;\n  const failures = allResults.filter((r) => r.status === 'fail').length;\n  const skipped = allResults.filter((r) => r.status === 'skip').length;\n\n  return {\n    checks: allResults,\n    passed,\n    warnings,\n    failures,\n    skipped,\n    healthy: failures === 0,\n  };\n}\n\n/**\n * Run checks for a specific category.\n */\nasync function runCategoryChecks(\n  category: CheckCategory,\n  fs: FsAdapter,\n  ctx: CheckContext,\n  prompts: DoctorPromptCallbacks\n): Promise<CheckResult[]> {\n  switch (category) {\n    case 'cli':\n      return runCliChecks(fs, ctx);\n    case 'config':\n      return runConfigChecks(fs, ctx);\n    case 'mcp':\n      return runMcpChecks(fs, ctx);\n    case 'deps':\n      return runDepsChecks(fs, ctx);\n    case 'workspace':\n      return runWorkspaceChecks(fs, ctx);\n    case 'ai':\n      return runAiChecks(fs, ctx, prompts);\n    case 'layers':\n      return runLayerChecks(fs, ctx);\n    default:\n      return [];\n  }\n}\n\n/**\n * Get a summary string for the doctor result.\n */\nexport function formatDoctorSummary(result: DoctorResult): string {\n  const lines: string[] = [];\n\n  lines.push('');\n  lines.push('=== Health Check Summary ===');\n  lines.push('');\n\n  if (result.healthy) {\n    lines.push('✓ All checks passed!');\n  } else {\n    lines.push('✗ Some issues found');\n  }\n\n  lines.push('');\n  lines.push(`  Passed:   ${result.passed}`);\n  lines.push(`  Warnings: ${result.warnings}`);\n  lines.push(`  Failures: ${result.failures}`);\n  lines.push(`  Skipped:  ${result.skipped}`);\n\n  return lines.join('\\n');\n}\n\n/**\n * Format a single check result for display.\n */\nexport function formatCheckResult(result: CheckResult): string {\n  const icon =\n    result.status === 'pass'\n      ? '✓'\n      : result.status === 'warn'\n        ? '⚠'\n        : result.status === 'fail'\n          ? '✗'\n          : '○';\n\n  let line = `${icon} ${result.name}: ${result.message}`;\n\n  if (result.details) {\n    line += `\\n    ${result.details}`;\n  }\n\n  if (result.fix) {\n    line += `\\n    Fix available: ${result.fix.description}`;\n  }\n\n  return line;\n}\n"],"mappings":"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"}

package/dist/services/doctor/index.d.mts

@@ -0,0 +1,2 @@
+import { ALL_CHECK_CATEGORIES, CHECK_CATEGORY_LABELS, CheckCategory, CheckContext, CheckResult, CheckStatus, DoctorOptions, DoctorPromptCallbacks, DoctorResult, FixAction, FixResult } from "./types.mjs";
+import { formatCheckResult, formatDoctorSummary, runDoctor } from "./doctor-service.mjs";

package/dist/services/doctor/index.mjs

@@ -0,0 +1,4 @@
+import { ALL_CHECK_CATEGORIES, CHECK_CATEGORY_LABELS } from "./types.mjs";
+import { formatCheckResult, formatDoctorSummary, runDoctor } from "./doctor-service.mjs";
+
+export {  };

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

@@ -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' | 'layers';
+/**
+ * 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.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/services/doctor/types.ts"],"sourcesContent":[],"mappings":";;AASA;AAYA;AAaA;AAaA;AAKA;AAUA;AAUA;AAEY,KAjEA,aAAA,GAiEA,KAAA,GAAA,QAAA,GAAA,KAAA,GAAA,MAAA,GAAA,WAAA,GAAA,IAAA,GAAA,QAAA;;;;AAgBK,cArEJ,oBAyEE,EAzEoB,aAyEP,EAAA;AAY5B;AAkBA;AAUA;cApGa,uBAAuB,OAAO;;;;KAa/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.mjs

@@ -0,0 +1,29 @@
+//#region src/services/doctor/types.ts
+/**
+* All available check categories.
+*/
+const ALL_CHECK_CATEGORIES = [
+	"cli",
+	"config",
+	"mcp",
+	"deps",
+	"workspace",
+	"ai",
+	"layers"
+];
+/**
+* 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",
+	layers: "Contract Layers"
+};
+
+//#endregion
+export { ALL_CHECK_CATEGORIES, CHECK_CATEGORY_LABELS };
+//# sourceMappingURL=types.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","names":[],"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  | 'layers';\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  'layers',\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  layers: 'Contract Layers',\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":";;;;AAqBA,MAAa,uBAAwC;CACnD;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;;;AAKD,MAAa,wBAAuD;CAClE,KAAK;CACL,QAAQ;CACR,KAAK;CACL,MAAM;CACN,WAAW;CACX,IAAI;CACJ,QAAQ;CACT"}

package/dist/services/drift.mjs

@@ -0,0 +1,73 @@
+import { generateArtifacts } from "./generate-artifacts.mjs";
+import { mkdtemp, rm } from "node:fs/promises";
+import path from "path";
+import { tmpdir } from "node:os";
+
+//#region src/services/drift.ts
+/**
+* Drift detection service.
+*
+* Detects when generated artifacts are out of sync with their source specs.
+*/
+/**
+* Detect drift between generated artifacts and source specs.
+*
+* Generates artifacts to a temporary directory and compares against
+* the existing generated directory to find differences.
+*
+* @param adapters - Workspace adapters for file operations
+* @param contractsDir - Directory containing source contracts
+* @param generatedDir - Directory containing generated artifacts
+* @returns Result indicating if drift exists and which files are affected
+*/
+async function detectDrift(adapters, contractsDir, generatedDir) {
+	const tempDir = await mkdtemp(path.join(tmpdir(), "contractspec-drift-"));
+	try {
+		await generateArtifacts(adapters, contractsDir, tempDir);
+		const differences = [];
+		const fs = await import("node:fs/promises");
+		async function getFiles(dir) {
+			const dirents = await fs.readdir(dir, { withFileTypes: true });
+			const files = [];
+			for (const dirent of dirents) {
+				const res = path.resolve(dir, dirent.name);
+				if (dirent.isDirectory()) files.push(...await getFiles(res));
+				else files.push(res);
+			}
+			return files;
+		}
+		const getRelativeFiles = async (root) => {
+			if (!await fs.stat(root).catch(() => false)) return [];
+			return (await getFiles(root)).map((f) => path.relative(root, f)).sort();
+		};
+		const tempFiles = await getRelativeFiles(tempDir);
+		const existingFiles = await getRelativeFiles(generatedDir);
+		const allFiles = new Set([...tempFiles, ...existingFiles]);
+		for (const file of allFiles) {
+			if (!existingFiles.includes(file)) {
+				differences.push(file);
+				continue;
+			}
+			if (!tempFiles.includes(file)) {
+				differences.push(file);
+				continue;
+			}
+			const tempContent = await fs.readFile(path.join(tempDir, file));
+			const existingContent = await fs.readFile(path.join(generatedDir, file));
+			if (!tempContent.equals(existingContent)) differences.push(file);
+		}
+		return {
+			hasDrift: differences.length > 0,
+			files: differences
+		};
+	} finally {
+		await rm(tempDir, {
+			recursive: true,
+			force: true
+		});
+	}
+}
+
+//#endregion
+export { detectDrift };
+//# sourceMappingURL=drift.mjs.map

package/dist/services/drift.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift.mjs","names":[],"sources":["../../src/services/drift.ts"],"sourcesContent":["/**\n * Drift detection service.\n *\n * Detects when generated artifacts are out of sync with their source specs.\n */\n\nimport path from 'path';\nimport { mkdtemp, rm } from 'node:fs/promises';\nimport { tmpdir } from 'node:os';\nimport type { WorkspaceAdapters } from '../ports/logger';\nimport { generateArtifacts } from './generate-artifacts';\n\n/**\n * Result of drift detection.\n */\nexport interface DriftResult {\n  /** Whether drift was detected. */\n  hasDrift: boolean;\n  /** Relative paths of files with drift. */\n  files: string[];\n}\n\n/**\n * Detect drift between generated artifacts and source specs.\n *\n * Generates artifacts to a temporary directory and compares against\n * the existing generated directory to find differences.\n *\n * @param adapters - Workspace adapters for file operations\n * @param contractsDir - Directory containing source contracts\n * @param generatedDir - Directory containing generated artifacts\n * @returns Result indicating if drift exists and which files are affected\n */\nexport async function detectDrift(\n  adapters: WorkspaceAdapters,\n  contractsDir: string,\n  generatedDir: string\n): Promise<DriftResult> {\n  // 1. Create temp directory\n  const tempDir = await mkdtemp(path.join(tmpdir(), 'contractspec-drift-'));\n\n  try {\n    // 2. Generate artifacts to temp dir\n    // We assume generateArtifacts mimics the structure of generatedDir inside tempDir\n    // But generateArtifacts usage in generate-artifacts.ts is:\n    // const docsDir = path.join(generatedDir, 'docs');\n    // It uses generatedDir as root.\n\n    await generateArtifacts(adapters, contractsDir, tempDir);\n\n    // 3. Compare tempDir with generatedDir\n    // We only care about files that exist in tempDir (should match generatedDir)\n    // AND files in generatedDir that shouldn't be there?\n    // \"Generated: configurable generated root..., never hand-edited\"\n    // So distinct(temp) == distinct(generated).\n\n    const differences: string[] = [];\n\n    // Use node:fs for walking directories\n    const fs = await import('node:fs/promises');\n\n    async function getFiles(dir: string): Promise<string[]> {\n      const dirents = await fs.readdir(dir, { withFileTypes: true });\n      const files: string[] = [];\n      for (const dirent of dirents) {\n        const res = path.resolve(dir, dirent.name);\n        if (dirent.isDirectory()) {\n          files.push(...(await getFiles(res)));\n        } else {\n          files.push(res);\n        }\n      }\n      return files;\n    }\n\n    // Get all files from both, relative to root\n    const getRelativeFiles = async (root: string) => {\n      if (!(await fs.stat(root).catch(() => false))) return [];\n      const files = await getFiles(root);\n      return files.map((f) => path.relative(root, f)).sort();\n    };\n\n    const tempFiles = await getRelativeFiles(tempDir);\n    const existingFiles = await getRelativeFiles(generatedDir);\n\n    const allFiles = new Set([...tempFiles, ...existingFiles]);\n\n    for (const file of allFiles) {\n      // Files in temp (expected) but not in existing\n      if (!existingFiles.includes(file)) {\n        differences.push(file); // Missing in existing (drift: outdated/incomplete)\n        continue;\n      }\n\n      // Files in existing but not in temp\n      if (!tempFiles.includes(file)) {\n        differences.push(file); // Extra file in generated (drift: polluted)\n        continue;\n      }\n\n      // Content comparison\n      const tempContent = await fs.readFile(path.join(tempDir, file));\n      const existingContent = await fs.readFile(path.join(generatedDir, file));\n\n      if (!tempContent.equals(existingContent)) {\n        differences.push(file); // Content mismatch\n      }\n    }\n\n    return {\n      hasDrift: differences.length > 0,\n      files: differences,\n    };\n  } finally {\n    // 4. Cleanup\n    await rm(tempDir, { recursive: true, force: true });\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAiCA,eAAsB,YACpB,UACA,cACA,cACsB;CAEtB,MAAM,UAAU,MAAM,QAAQ,KAAK,KAAK,QAAQ,EAAE,sBAAsB,CAAC;AAEzE,KAAI;AAOF,QAAM,kBAAkB,UAAU,cAAc,QAAQ;EAQxD,MAAM,cAAwB,EAAE;EAGhC,MAAM,KAAK,MAAM,OAAO;EAExB,eAAe,SAAS,KAAgC;GACtD,MAAM,UAAU,MAAM,GAAG,QAAQ,KAAK,EAAE,eAAe,MAAM,CAAC;GAC9D,MAAM,QAAkB,EAAE;AAC1B,QAAK,MAAM,UAAU,SAAS;IAC5B,MAAM,MAAM,KAAK,QAAQ,KAAK,OAAO,KAAK;AAC1C,QAAI,OAAO,aAAa,CACtB,OAAM,KAAK,GAAI,MAAM,SAAS,IAAI,CAAE;QAEpC,OAAM,KAAK,IAAI;;AAGnB,UAAO;;EAIT,MAAM,mBAAmB,OAAO,SAAiB;AAC/C,OAAI,CAAE,MAAM,GAAG,KAAK,KAAK,CAAC,YAAY,MAAM,CAAG,QAAO,EAAE;AAExD,WADc,MAAM,SAAS,KAAK,EACrB,KAAK,MAAM,KAAK,SAAS,MAAM,EAAE,CAAC,CAAC,MAAM;;EAGxD,MAAM,YAAY,MAAM,iBAAiB,QAAQ;EACjD,MAAM,gBAAgB,MAAM,iBAAiB,aAAa;EAE1D,MAAM,WAAW,IAAI,IAAI,CAAC,GAAG,WAAW,GAAG,cAAc,CAAC;AAE1D,OAAK,MAAM,QAAQ,UAAU;AAE3B,OAAI,CAAC,cAAc,SAAS,KAAK,EAAE;AACjC,gBAAY,KAAK,KAAK;AACtB;;AAIF,OAAI,CAAC,UAAU,SAAS,KAAK,EAAE;AAC7B,gBAAY,KAAK,KAAK;AACtB;;GAIF,MAAM,cAAc,MAAM,GAAG,SAAS,KAAK,KAAK,SAAS,KAAK,CAAC;GAC/D,MAAM,kBAAkB,MAAM,GAAG,SAAS,KAAK,KAAK,cAAc,KAAK,CAAC;AAExE,OAAI,CAAC,YAAY,OAAO,gBAAgB,CACtC,aAAY,KAAK,KAAK;;AAI1B,SAAO;GACL,UAAU,YAAY,SAAS;GAC/B,OAAO;GACR;WACO;AAER,QAAM,GAAG,SAAS;GAAE,WAAW;GAAM,OAAO;GAAM,CAAC"}

package/dist/services/extract.d.mts

@@ -0,0 +1,12 @@
+import { WorkspaceAdapters } from "../ports/logger.mjs";
+import { OpenApiImportServiceResult } from "./openapi/types.mjs";
+
+//#region src/services/extract.d.ts
+interface ExtractOptions {
+  source: string;
+  outputDir: string;
+}
+declare function extractContracts(adapters: WorkspaceAdapters, options: ExtractOptions, cwd?: string): Promise<OpenApiImportServiceResult>;
+//#endregion
+export { ExtractOptions, extractContracts };
+//# sourceMappingURL=extract.d.mts.map

package/dist/services/extract.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.mts","names":[],"sources":["../../src/services/extract.ts"],"sourcesContent":[],"mappings":";;;;UAKiB,cAAA;;EAAA,SAAA,EAAA,MAAc;AAK/B;AACY,iBADU,gBAAA,CACV,QAAA,EAAA,iBAAA,EAAA,OAAA,EACD,cADC,EAAA,GAAA,CAAA,EAAA,MAAA,CAAA,EAGT,OAHS,CAGD,0BAHC,CAAA"}

package/dist/services/extract.mjs

@@ -0,0 +1,33 @@
+import { loadWorkspaceConfig } from "./config.mjs";
+import { importFromOpenApiService } from "./openapi/import-service.mjs";
+import "./openapi/index.mjs";
+
+//#region src/services/extract.ts
+async function extractContracts(adapters, options, cwd) {
+	const { fs, logger } = adapters;
+	const { source, outputDir } = options;
+	const sourcePath = fs.resolve(cwd ?? process.cwd(), source);
+	if (!await fs.exists(sourcePath)) throw new Error(`Source file not found: ${sourcePath}`);
+	const config = await loadWorkspaceConfig(fs, cwd);
+	const conventions = {
+		models: "models",
+		groupByFeature: false,
+		...config.conventions
+	};
+	const runConfig = {
+		...config,
+		outputDir,
+		schemaFormat: config.schemaFormat ?? "zod",
+		conventions
+	};
+	logger.info(`Extracting contracts from ${sourcePath} to ${outputDir}`);
+	return importFromOpenApiService(runConfig, {
+		source: sourcePath,
+		outputDir,
+		dryRun: false
+	}, adapters);
+}
+
+//#endregion
+export { extractContracts };
+//# sourceMappingURL=extract.mjs.map

package/dist/services/extract.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.mjs","names":[],"sources":["../../src/services/extract.ts"],"sourcesContent":["import type { WorkspaceAdapters } from '../ports/logger';\nimport { loadWorkspaceConfig } from './config';\nimport { importFromOpenApiService } from './openapi/index';\nimport type { OpenApiImportServiceResult } from './openapi/types';\n\nexport interface ExtractOptions {\n  source: string;\n  outputDir: string;\n}\n\nexport async function extractContracts(\n  adapters: WorkspaceAdapters,\n  options: ExtractOptions,\n  cwd?: string\n): Promise<OpenApiImportServiceResult> {\n  const { fs, logger } = adapters;\n  const { source, outputDir } = options;\n\n  // Verify source existence\n  // We resolve source relative to CWD if checking locally, or absolute\n  const sourcePath = fs.resolve(cwd ?? process.cwd(), source);\n  if (!(await fs.exists(sourcePath))) {\n    throw new Error(`Source file not found: ${sourcePath}`);\n  }\n\n  // Load Base Config\n  const config = await loadWorkspaceConfig(fs, cwd);\n\n  // Override config if needed or pass as options to import service\n  // importFromOpenApiService takes (contractsrcConfig, importOptions, adapters)\n  // We need to merge outputDir override if present.\n  const conventions = {\n    models: 'models',\n    groupByFeature: false,\n    ...config.conventions,\n  };\n\n  const runConfig = {\n    ...config,\n    outputDir: outputDir, // CLI/Option override\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    schemaFormat: (config as any).schemaFormat ?? 'zod',\n    conventions,\n  };\n\n  logger.info(`Extracting contracts from ${sourcePath} to ${outputDir}`);\n\n  return importFromOpenApiService(\n    runConfig,\n    {\n      source: sourcePath,\n      outputDir: outputDir,\n      dryRun: false,\n    },\n    adapters\n  );\n}\n"],"mappings":";;;;;AAUA,eAAsB,iBACpB,UACA,SACA,KACqC;CACrC,MAAM,EAAE,IAAI,WAAW;CACvB,MAAM,EAAE,QAAQ,cAAc;CAI9B,MAAM,aAAa,GAAG,QAAQ,OAAO,QAAQ,KAAK,EAAE,OAAO;AAC3D,KAAI,CAAE,MAAM,GAAG,OAAO,WAAW,CAC/B,OAAM,IAAI,MAAM,0BAA0B,aAAa;CAIzD,MAAM,SAAS,MAAM,oBAAoB,IAAI,IAAI;CAKjD,MAAM,cAAc;EAClB,QAAQ;EACR,gBAAgB;EAChB,GAAG,OAAO;EACX;CAED,MAAM,YAAY;EAChB,GAAG;EACQ;EAEX,cAAe,OAAe,gBAAgB;EAC9C;EACD;AAED,QAAO,KAAK,6BAA6B,WAAW,MAAM,YAAY;AAEtE,QAAO,yBACL,WACA;EACE,QAAQ;EACG;EACX,QAAQ;EACT,EACD,SACD"}

package/dist/services/features/completion.d.mts

@@ -0,0 +1,21 @@
+import { AnalyzedSpecType } from "@contractspec/module.workspace";
+
+//#region src/services/features/completion.d.ts
+
+/**
+ * Result of context detection.
+ */
+interface FeatureContext {
+  type: 'operations' | 'events' | 'presentations';
+  specType: AnalyzedSpecType;
+}
+/**
+ * Detect which array context the cursor is in within a feature file.
+ *
+ * @param textBeforeCursor Text from start of file to cursor position.
+ * @param textAfterCursor Text from cursor position to end of file (or reasonable lookahead).
+ */
+declare function detectFeatureContext(textBeforeCursor: string, textAfterCursor: string): FeatureContext | null;
+//#endregion
+export { FeatureContext, detectFeatureContext };
+//# sourceMappingURL=completion.d.mts.map

package/dist/services/features/completion.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.mts","names":[],"sources":["../../../src/services/features/completion.ts"],"sourcesContent":[],"mappings":";;;;;;AAKA;AAWgB,UAXC,cAAA,CAWmB;;YATxB;;;;;;;;iBASI,oBAAA,qDAGb"}

package/dist/services/features/completion.mjs

@@ -0,0 +1,70 @@
+//#region src/services/features/completion.ts
+/**
+* Detect which array context the cursor is in within a feature file.
+*
+* @param textBeforeCursor Text from start of file to cursor position.
+* @param textAfterCursor Text from cursor position to end of file (or reasonable lookahead).
+*/
+function detectFeatureContext(textBeforeCursor, textAfterCursor) {
+	const patterns = [
+		{
+			type: "operations",
+			regex: /operations\s*:\s*\[/g,
+			specType: "operation"
+		},
+		{
+			type: "events",
+			regex: /events\s*:\s*\[/g,
+			specType: "event"
+		},
+		{
+			type: "presentations",
+			regex: /presentations\s*:\s*\[/g,
+			specType: "presentation"
+		}
+	];
+	let lastMatch = null;
+	for (const { type, regex, specType } of patterns) {
+		let match;
+		regex.lastIndex = 0;
+		while ((match = regex.exec(textBeforeCursor)) !== null) if (!lastMatch || match.index > lastMatch.index) lastMatch = {
+			type,
+			specType,
+			index: match.index
+		};
+	}
+	if (!lastMatch) return null;
+	const relevantText = textBeforeCursor.slice(lastMatch.index) + textAfterCursor;
+	const typeStr = lastMatch.type;
+	(/* @__PURE__ */ new RegExp(`${typeStr}\\s*:\\s*\\[`)).exec(relevantText);
+	const textFromMatch = textBeforeCursor.slice(lastMatch.index);
+	let depth = 0;
+	let inString = false;
+	let stringChar = "";
+	for (let i = 0; i < textFromMatch.length; i++) {
+		const char = textFromMatch[i];
+		const prevChar = i > 0 ? textFromMatch[i - 1] : "";
+		if ((char === "\"" || char === "'" || char === "`") && prevChar !== "\\") {
+			if (!inString) {
+				inString = true;
+				stringChar = char;
+			} else if (char === stringChar) inString = false;
+			continue;
+		}
+		if (inString) continue;
+		if (char === "[") depth++;
+		else if (char === "]") {
+			depth--;
+			if (depth === 0) return null;
+		}
+	}
+	if (depth > 0) return {
+		type: lastMatch.type,
+		specType: lastMatch.specType
+	};
+	return null;
+}
+
+//#endregion
+export { detectFeatureContext };
+//# sourceMappingURL=completion.mjs.map

package/dist/services/features/completion.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.mjs","names":[],"sources":["../../../src/services/features/completion.ts"],"sourcesContent":["import type { AnalyzedSpecType } from '@contractspec/module.workspace';\n\n/**\n * Result of context detection.\n */\nexport interface FeatureContext {\n  type: 'operations' | 'events' | 'presentations';\n  specType: AnalyzedSpecType;\n}\n\n/**\n * Detect which array context the cursor is in within a feature file.\n *\n * @param textBeforeCursor Text from start of file to cursor position.\n * @param textAfterCursor Text from cursor position to end of file (or reasonable lookahead).\n */\nexport function detectFeatureContext(\n  textBeforeCursor: string,\n  textAfterCursor: string\n): FeatureContext | null {\n  // Find the last occurrence of each array type\n  const patterns = [\n    {\n      type: 'operations' as const,\n      regex: /operations\\s*:\\s*\\[/g,\n      specType: 'operation' as AnalyzedSpecType,\n    },\n    {\n      type: 'events' as const,\n      regex: /events\\s*:\\s*\\[/g,\n      specType: 'event' as AnalyzedSpecType,\n    },\n    {\n      type: 'presentations' as const,\n      regex: /presentations\\s*:\\s*\\[/g,\n      specType: 'presentation' as AnalyzedSpecType,\n    },\n  ];\n\n  let lastMatch: {\n    type: 'operations' | 'events' | 'presentations';\n    specType: AnalyzedSpecType;\n    index: number;\n  } | null = null;\n\n  for (const { type, regex, specType } of patterns) {\n    let match;\n    // Reset regex lastIndex\n    regex.lastIndex = 0;\n    while ((match = regex.exec(textBeforeCursor)) !== null) {\n      if (!lastMatch || match.index > lastMatch.index) {\n        lastMatch = { type, specType, index: match.index };\n      }\n    }\n  }\n\n  if (!lastMatch) {\n    return null;\n  }\n\n  // Check if we're still inside the array (no closing bracket yet)\n  const relevantText =\n    textBeforeCursor.slice(lastMatch.index) + textAfterCursor;\n  // We only care about checking if the bracket matches.\n  // Actually, simpler logic: verify we haven't closed the array *before* the cursor.\n  // But wait, the cursor is at `textBeforeCursor.length`.\n  // The array starts at `lastMatch.index` (plus length of match).\n  // We need to count brackets from start of array content.\n\n  // Re-extract match to know length\n  const typeStr = lastMatch.type;\n  const arrayStartRegex = new RegExp(`${typeStr}\\\\s*:\\\\s*\\\\[`);\n  arrayStartRegex.exec(relevantText); // this matches at 0 effectively since we sliced?\n  // No, relevantText starts at lastMatch.index.\n  // So validation:\n\n  const textFromMatch = textBeforeCursor.slice(lastMatch.index);\n\n  let depth = 0;\n  let inString = false;\n  let stringChar = '';\n\n  for (let i = 0; i < textFromMatch.length; i++) {\n    const char = textFromMatch[i];\n    const prevChar = i > 0 ? textFromMatch[i - 1] : '';\n\n    // Handle string literals\n    if ((char === '\"' || char === \"'\" || char === '`') && prevChar !== '\\\\') {\n      if (!inString) {\n        inString = true;\n        stringChar = char;\n      } else if (char === stringChar) {\n        inString = false;\n      }\n      continue;\n    }\n\n    if (inString) continue;\n\n    if (char === '[') {\n      depth++;\n    } else if (char === ']') {\n      depth--;\n      if (depth === 0) {\n        // Array is closed before cursor\n        return null;\n      }\n    }\n  }\n\n  // If we are here, depth should be > 0 (usually 1 if flat array, or nested)\n  // If depth is > 0, we are inside.\n  if (depth > 0) {\n    return {\n      type: lastMatch.type,\n      specType: lastMatch.specType,\n    };\n  }\n\n  return null;\n}\n"],"mappings":";;;;;;;AAgBA,SAAgB,qBACd,kBACA,iBACuB;CAEvB,MAAM,WAAW;EACf;GACE,MAAM;GACN,OAAO;GACP,UAAU;GACX;EACD;GACE,MAAM;GACN,OAAO;GACP,UAAU;GACX;EACD;GACE,MAAM;GACN,OAAO;GACP,UAAU;GACX;EACF;CAED,IAAI,YAIO;AAEX,MAAK,MAAM,EAAE,MAAM,OAAO,cAAc,UAAU;EAChD,IAAI;AAEJ,QAAM,YAAY;AAClB,UAAQ,QAAQ,MAAM,KAAK,iBAAiB,MAAM,KAChD,KAAI,CAAC,aAAa,MAAM,QAAQ,UAAU,MACxC,aAAY;GAAE;GAAM;GAAU,OAAO,MAAM;GAAO;;AAKxD,KAAI,CAAC,UACH,QAAO;CAIT,MAAM,eACJ,iBAAiB,MAAM,UAAU,MAAM,GAAG;CAQ5C,MAAM,UAAU,UAAU;AAE1B,kBADwB,IAAI,OAAO,GAAG,QAAQ,cAAc,EAC5C,KAAK,aAAa;CAIlC,MAAM,gBAAgB,iBAAiB,MAAM,UAAU,MAAM;CAE7D,IAAI,QAAQ;CACZ,IAAI,WAAW;CACf,IAAI,aAAa;AAEjB,MAAK,IAAI,IAAI,GAAG,IAAI,cAAc,QAAQ,KAAK;EAC7C,MAAM,OAAO,cAAc;EAC3B,MAAM,WAAW,IAAI,IAAI,cAAc,IAAI,KAAK;AAGhD,OAAK,SAAS,QAAO,SAAS,OAAO,SAAS,QAAQ,aAAa,MAAM;AACvE,OAAI,CAAC,UAAU;AACb,eAAW;AACX,iBAAa;cACJ,SAAS,WAClB,YAAW;AAEb;;AAGF,MAAI,SAAU;AAEd,MAAI,SAAS,IACX;WACS,SAAS,KAAK;AACvB;AACA,OAAI,UAAU,EAEZ,QAAO;;;AAOb,KAAI,QAAQ,EACV,QAAO;EACL,MAAM,UAAU;EAChB,UAAU,UAAU;EACrB;AAGH,QAAO"}

package/dist/services/features/feature-editor.d.mts

@@ -0,0 +1,27 @@
+//#region src/services/features/feature-editor.d.ts
+/**
+ * Feature file editing services.
+ */
+/**
+ * Result of a computation to edit a feature file.
+ */
+interface FeatureEdit {
+  index: number;
+  text: string;
+}
+/**
+ * Compute the edit required to add a spec reference to a feature file.
+ * Returns the index to insert at and the text to insert.
+ */
+declare function computeAddSpecEdit(content: string, spec: {
+  key: string;
+  version: string | number;
+  type: string;
+}): FeatureEdit | null;
+/**
+ * Get array name in feature spec for a given spec type.
+ */
+declare function getArrayNameForSpecType(specType: string): string;
+//#endregion
+export { FeatureEdit, computeAddSpecEdit, getArrayNameForSpecType };
+//# sourceMappingURL=feature-editor.d.mts.map

package/dist/services/features/feature-editor.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-editor.d.mts","names":[],"sources":["../../../src/services/features/feature-editor.ts"],"sourcesContent":[],"mappings":";;AAOA;AASA;AA+BA;;;UAxCiB,WAAA;;;;;;;;iBASD,kBAAA;;;;IAGb;;;;iBA4Ba,uBAAA"}

package/dist/services/features/feature-editor.mjs

@@ -0,0 +1,37 @@
+//#region src/services/features/feature-editor.ts
+/**
+* Compute the edit required to add a spec reference to a feature file.
+* Returns the index to insert at and the text to insert.
+*/
+function computeAddSpecEdit(content, spec) {
+	const arrayName = getArrayNameForSpecType(spec.type);
+	const match = new RegExp(`${arrayName}\\s*:\\s*\\[`, "g").exec(content);
+	if (match) {
+		const insertIndex = match.index + match[0].length;
+		const versionStr = typeof spec.version === "string" ? `'${spec.version}'` : spec.version;
+		return {
+			index: insertIndex,
+			text: `\n    { key: '${spec.key}', version: ${versionStr} },`
+		};
+	}
+	return null;
+}
+/**
+* Get array name in feature spec for a given spec type.
+*/
+function getArrayNameForSpecType(specType) {
+	switch (specType) {
+		case "operation":
+		case "command":
+		case "query": return "operations";
+		case "event": return "events";
+		case "presentation": return "presentations";
+		case "experiment": return "experiments";
+		case "workflow": return "workflows";
+		default: return "operations";
+	}
+}
+
+//#endregion
+export { computeAddSpecEdit, getArrayNameForSpecType };
+//# sourceMappingURL=feature-editor.mjs.map

package/dist/services/features/feature-editor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-editor.mjs","names":[],"sources":["../../../src/services/features/feature-editor.ts"],"sourcesContent":["/**\n * Feature file editing services.\n */\n\n/**\n * Result of a computation to edit a feature file.\n */\nexport interface FeatureEdit {\n  index: number;\n  text: string;\n}\n\n/**\n * Compute the edit required to add a spec reference to a feature file.\n * Returns the index to insert at and the text to insert.\n */\nexport function computeAddSpecEdit(\n  content: string,\n  spec: { key: string; version: string | number; type: string }\n): FeatureEdit | null {\n  const arrayName = getArrayNameForSpecType(spec.type);\n\n  // Find the array in the document\n  const arrayPattern = new RegExp(`${arrayName}\\\\s*:\\\\s*\\\\[`, 'g');\n  const match = arrayPattern.exec(content);\n\n  if (match) {\n    // Insert after the opening bracket\n    const insertIndex = match.index + match[0].length;\n\n    // Format the reference\n    const versionStr =\n      typeof spec.version === 'string' ? `'${spec.version}'` : spec.version;\n    const refText = `\\n    { key: '${spec.key}', version: ${versionStr} },`;\n\n    return {\n      index: insertIndex,\n      text: refText,\n    };\n  }\n\n  return null;\n}\n\n/**\n * Get array name in feature spec for a given spec type.\n */\nexport function getArrayNameForSpecType(specType: string): string {\n  switch (specType) {\n    case 'operation':\n    case 'command':\n    case 'query':\n      return 'operations';\n    case 'event':\n      return 'events';\n    case 'presentation':\n      return 'presentations';\n    case 'experiment':\n      return 'experiments';\n    case 'workflow':\n      return 'workflows'; // Assuming workflows are supported similarly\n    default:\n      return 'operations';\n  }\n}\n"],"mappings":";;;;;AAgBA,SAAgB,mBACd,SACA,MACoB;CACpB,MAAM,YAAY,wBAAwB,KAAK,KAAK;CAIpD,MAAM,QADe,IAAI,OAAO,GAAG,UAAU,eAAe,IAAI,CACrC,KAAK,QAAQ;AAExC,KAAI,OAAO;EAET,MAAM,cAAc,MAAM,QAAQ,MAAM,GAAG;EAG3C,MAAM,aACJ,OAAO,KAAK,YAAY,WAAW,IAAI,KAAK,QAAQ,KAAK,KAAK;AAGhE,SAAO;GACL,OAAO;GACP,MAJc,iBAAiB,KAAK,IAAI,cAAc,WAAW;GAKlE;;AAGH,QAAO;;;;;AAMT,SAAgB,wBAAwB,UAA0B;AAChE,SAAQ,UAAR;EACE,KAAK;EACL,KAAK;EACL,KAAK,QACH,QAAO;EACT,KAAK,QACH,QAAO;EACT,KAAK,eACH,QAAO;EACT,KAAK,aACH,QAAO;EACT,KAAK,WACH,QAAO;EACT,QACE,QAAO"}