@contractspec/bundle.workspace 1.46.2 → 1.47.0

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"}

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

@@ -0,0 +1,11 @@
+import { FeatureEdit, computeAddSpecEdit, getArrayNameForSpecType } from "./feature-editor.mjs";
+import { FeatureRefError, validateFeatureRefs } from "./validation.mjs";
+import { FeatureContext, detectFeatureContext } from "./completion.mjs";
+
+//#region src/services/features/index.d.ts
+declare namespace index_d_exports {
+  export { FeatureContext, FeatureEdit, FeatureRefError, computeAddSpecEdit, detectFeatureContext, getArrayNameForSpecType, validateFeatureRefs };
+}
+//#endregion
+export { index_d_exports };
+//# sourceMappingURL=index.d.mts.map

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

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

package/dist/services/features/index.mjs

@@ -0,0 +1,16 @@
+import { __exportAll } from "../../_virtual/rolldown_runtime.mjs";
+import { computeAddSpecEdit, getArrayNameForSpecType } from "./feature-editor.mjs";
+import { validateFeatureRefs } from "./validation.mjs";
+import { detectFeatureContext } from "./completion.mjs";
+
+//#region src/services/features/index.ts
+var features_exports = /* @__PURE__ */ __exportAll({
+	computeAddSpecEdit: () => computeAddSpecEdit,
+	detectFeatureContext: () => detectFeatureContext,
+	getArrayNameForSpecType: () => getArrayNameForSpecType,
+	validateFeatureRefs: () => validateFeatureRefs
+});
+
+//#endregion
+export { features_exports };
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/services/features/index.ts"],"sourcesContent":["export * from './feature-editor';\nexport * from './validation';\nexport * from './completion';\n"],"mappings":""}

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

@@ -0,0 +1,21 @@
+import { SpecInventory } from "../integrity.mjs";
+import { FeatureScanResult } from "@contractspec/module.workspace";
+
+//#region src/services/features/validation.d.ts
+
+/**
+ * Validation error for a feature reference.
+ */
+interface FeatureRefError {
+  key: string;
+  version: string | number;
+  type: string;
+  message: string;
+}
+/**
+ * Validate references in a feature against the workspace inventory.
+ */
+declare function validateFeatureRefs(feature: FeatureScanResult, inventory: SpecInventory): FeatureRefError[];
+//#endregion
+export { FeatureRefError, validateFeatureRefs };
+//# sourceMappingURL=validation.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.mts","names":[],"sources":["../../../src/services/features/validation.ts"],"sourcesContent":[],"mappings":";;;;;;;AAMA;AAUgB,UAVC,eAAA,CAUkB;EACxB,GAAA,EAAA,MAAA;EACE,OAAA,EAAA,MAAA,GAAA,MAAA;EACV,IAAA,EAAA,MAAA;EAAe,OAAA,EAAA,MAAA;;;;;iBAHF,mBAAA,UACL,8BACE,gBACV"}

package/dist/services/features/validation.mjs

@@ -0,0 +1,27 @@
+//#region src/services/features/validation.ts
+/**
+* Validate references in a feature against the workspace inventory.
+*/
+function validateFeatureRefs(feature, inventory) {
+	const errors = [];
+	const checkRefs = (refs, inventoryMap, type) => {
+		for (const ref of refs) {
+			const key = `${ref.key}.v${ref.version}`;
+			if (!inventoryMap.has(key)) errors.push({
+				key: ref.key,
+				version: ref.version,
+				type,
+				message: `${type} ${ref.key}.v${ref.version} not found`
+			});
+		}
+	};
+	checkRefs(feature.operations, inventory.operations, "Operation");
+	checkRefs(feature.events, inventory.events, "Event");
+	checkRefs(feature.presentations, inventory.presentations, "Presentation");
+	checkRefs(feature.experiments, inventory.experiments, "Experiment");
+	return errors;
+}
+
+//#endregion
+export { validateFeatureRefs };
+//# sourceMappingURL=validation.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.mjs","names":[],"sources":["../../../src/services/features/validation.ts"],"sourcesContent":["import type { FeatureScanResult } from '@contractspec/module.workspace';\nimport type { SpecInventory } from '../integrity';\n\n/**\n * Validation error for a feature reference.\n */\nexport interface FeatureRefError {\n  key: string;\n  version: string | number;\n  type: string;\n  message: string;\n}\n\n/**\n * Validate references in a feature against the workspace inventory.\n */\nexport function validateFeatureRefs(\n  feature: FeatureScanResult,\n  inventory: SpecInventory\n): FeatureRefError[] {\n  const errors: FeatureRefError[] = [];\n\n  // Helper to check refs\n  const checkRefs = (\n    refs: { key: string; version: string | number }[],\n    inventoryMap: Map<string, unknown>,\n    type: string\n  ) => {\n    for (const ref of refs) {\n      const key = `${ref.key}.v${ref.version}`;\n      if (!inventoryMap.has(key)) {\n        errors.push({\n          key: ref.key,\n          version: ref.version,\n          type,\n          message: `${type} ${ref.key}.v${ref.version} not found`,\n        });\n      }\n    }\n  };\n\n  checkRefs(feature.operations, inventory.operations, 'Operation');\n  checkRefs(feature.events, inventory.events, 'Event');\n  checkRefs(feature.presentations, inventory.presentations, 'Presentation');\n  checkRefs(feature.experiments, inventory.experiments, 'Experiment');\n  // Check workflows if/when supported in inventory\n\n  return errors;\n}\n"],"mappings":";;;;AAgBA,SAAgB,oBACd,SACA,WACmB;CACnB,MAAM,SAA4B,EAAE;CAGpC,MAAM,aACJ,MACA,cACA,SACG;AACH,OAAK,MAAM,OAAO,MAAM;GACtB,MAAM,MAAM,GAAG,IAAI,IAAI,IAAI,IAAI;AAC/B,OAAI,CAAC,aAAa,IAAI,IAAI,CACxB,QAAO,KAAK;IACV,KAAK,IAAI;IACT,SAAS,IAAI;IACb;IACA,SAAS,GAAG,KAAK,GAAG,IAAI,IAAI,IAAI,IAAI,QAAQ;IAC7C,CAAC;;;AAKR,WAAU,QAAQ,YAAY,UAAU,YAAY,YAAY;AAChE,WAAU,QAAQ,QAAQ,UAAU,QAAQ,QAAQ;AACpD,WAAU,QAAQ,eAAe,UAAU,eAAe,eAAe;AACzE,WAAU,QAAQ,aAAa,UAAU,aAAa,aAAa;AAGnE,QAAO"}

package/dist/services/fix/fix-link-formatter.d.mts

@@ -0,0 +1,12 @@
+import { IntegrityIssue } from "../integrity.mjs";
+import { FixLink, FixLinkOptions } from "./types.mjs";
+
+//#region src/services/fix/fix-link-formatter.d.ts
+
+/**
+ * Generate fix links for an issue.
+ */
+declare function generateFixLinks(issue: IntegrityIssue, options: FixLinkOptions): FixLink[];
+//#endregion
+export { generateFixLinks };
+//# sourceMappingURL=fix-link-formatter.d.mts.map

package/dist/services/fix/fix-link-formatter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-link-formatter.d.mts","names":[],"sources":["../../../src/services/fix/fix-link-formatter.ts"],"sourcesContent":[],"mappings":";;;;;;;;iBAYgB,gBAAA,QACP,yBACE,iBACR"}

package/dist/services/fix/fix-link-formatter.mjs

@@ -0,0 +1,38 @@
+//#region src/services/fix/fix-link-formatter.ts
+/**
+* Generate fix links for an issue.
+*/
+function generateFixLinks(issue, options) {
+	const links = [];
+	if (!issue.ref || !issue.file) return links;
+	if (options.includeCli) links.push({
+		type: "cli",
+		label: "Fix with CLI",
+		value: `contractspec fix --target "${issue.file}"`
+	});
+	if (options.includeVscode) {
+		const path = issue.file.startsWith("/") ? issue.file : `/${issue.file}`;
+		const ref = issue.ref;
+		const line = ref.line || 1;
+		const col = ref.column || 1;
+		links.push({
+			type: "vscode",
+			label: "Open in VS Code",
+			value: `vscode://file${path}:${line}:${col}`
+		});
+	}
+	if (options.includeGithubIssue && options.repository) {
+		const title = encodeURIComponent(`Fix Integrity Issue: ${issue.message}`);
+		const body = encodeURIComponent(`Found integrity issue in \`${issue.file}\`:\n\n> ${issue.message}\n\nReference: \`${issue.ref.key}.v${issue.ref.version}\``);
+		links.push({
+			type: "github-issue",
+			label: "Create Issue",
+			value: `https://github.com/${options.repository}/issues/new?title=${title}&body=${body}`
+		});
+	}
+	return links;
+}
+
+//#endregion
+export { generateFixLinks };
+//# sourceMappingURL=fix-link-formatter.mjs.map

package/dist/services/fix/fix-link-formatter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-link-formatter.mjs","names":[],"sources":["../../../src/services/fix/fix-link-formatter.ts"],"sourcesContent":["/**\n * Fix Link Formatter.\n *\n * Generates links for external surfaces (CLI, VSCode, GitHub).\n */\n\nimport type { FixLink, FixLinkOptions } from './types';\nimport type { IntegrityIssue } from '../integrity';\n\n/**\n * Generate fix links for an issue.\n */\nexport function generateFixLinks(\n  issue: IntegrityIssue,\n  options: FixLinkOptions\n): FixLink[] {\n  const links: FixLink[] = [];\n\n  if (!issue.ref || !issue.file) {\n    return links;\n  }\n\n  // CLI Command\n  if (options.includeCli) {\n    links.push({\n      type: 'cli',\n      label: 'Fix with CLI',\n      value: `contractspec fix --target \"${issue.file}\"`,\n    });\n  }\n\n  // VSCode Deep Link\n  if (options.includeVscode) {\n    // vscode://file/{path}:{line}:{col}\n    const path = issue.file.startsWith('/') ? issue.file : `/${issue.file}`;\n    // Cast to any to access potential line/column if not in strictly typed RefInfo\n    // or assume they exist if runtime provides them\n    // Cast to unknown first to avoid exact type constraints if properties are missing in type definition\n    const ref = issue.ref as unknown as { line?: number; column?: number };\n    const line = ref.line || 1;\n    const col = ref.column || 1;\n    links.push({\n      type: 'vscode',\n      label: 'Open in VS Code',\n      value: `vscode://file${path}:${line}:${col}`,\n    });\n  }\n\n  // GitHub Issue\n  if (options.includeGithubIssue && options.repository) {\n    const title = encodeURIComponent(`Fix Integrity Issue: ${issue.message}`);\n    const body = encodeURIComponent(\n      `Found integrity issue in \\`${issue.file}\\`:\\n\\n> ${issue.message}\\n\\nReference: \\`${issue.ref.key}.v${issue.ref.version}\\``\n    );\n    links.push({\n      type: 'github-issue',\n      label: 'Create Issue',\n      value: `https://github.com/${options.repository}/issues/new?title=${title}&body=${body}`,\n    });\n  }\n\n  return links;\n}\n"],"mappings":";;;;AAYA,SAAgB,iBACd,OACA,SACW;CACX,MAAM,QAAmB,EAAE;AAE3B,KAAI,CAAC,MAAM,OAAO,CAAC,MAAM,KACvB,QAAO;AAIT,KAAI,QAAQ,WACV,OAAM,KAAK;EACT,MAAM;EACN,OAAO;EACP,OAAO,8BAA8B,MAAM,KAAK;EACjD,CAAC;AAIJ,KAAI,QAAQ,eAAe;EAEzB,MAAM,OAAO,MAAM,KAAK,WAAW,IAAI,GAAG,MAAM,OAAO,IAAI,MAAM;EAIjE,MAAM,MAAM,MAAM;EAClB,MAAM,OAAO,IAAI,QAAQ;EACzB,MAAM,MAAM,IAAI,UAAU;AAC1B,QAAM,KAAK;GACT,MAAM;GACN,OAAO;GACP,OAAO,gBAAgB,KAAK,GAAG,KAAK,GAAG;GACxC,CAAC;;AAIJ,KAAI,QAAQ,sBAAsB,QAAQ,YAAY;EACpD,MAAM,QAAQ,mBAAmB,wBAAwB,MAAM,UAAU;EACzE,MAAM,OAAO,mBACX,8BAA8B,MAAM,KAAK,WAAW,MAAM,QAAQ,mBAAmB,MAAM,IAAI,IAAI,IAAI,MAAM,IAAI,QAAQ,IAC1H;AACD,QAAM,KAAK;GACT,MAAM;GACN,OAAO;GACP,OAAO,sBAAsB,QAAQ,WAAW,oBAAoB,MAAM,QAAQ;GACnF,CAAC;;AAGJ,QAAO"}

package/dist/services/fix/fix-service.d.mts

@@ -0,0 +1,74 @@
+import { FsAdapter } from "../../ports/fs.mjs";
+import { LoggerAdapter } from "../../ports/logger.mjs";
+import { IntegrityIssue } from "../integrity.mjs";
+import { BatchFixRequest, BatchFixResult, FixOptions, FixResult, FixStrategyType, FixableIssue } from "./types.mjs";
+
+//#region src/services/fix/fix-service.d.ts
+
+/**
+ * Service for fixing integrity issues.
+ */
+declare class FixService {
+  private readonly adapters;
+  private strategies;
+  constructor(adapters: {
+    fs: FsAdapter;
+    logger: LoggerAdapter;
+  });
+  /**
+   * Register a fix strategy.
+   */
+  private registerStrategy;
+  /**
+   * Get available strategies for an issue.
+   */
+  getStrategiesForIssue(issue: IntegrityIssue): FixStrategyType[];
+  /**
+   * Parse CI issue into a fixable issue context.
+   */
+  parseFixableIssue(issue: IntegrityIssue): Omit<FixableIssue, 'availableStrategies' | 'strategies'> | undefined;
+  /**
+   * Fix a single issue.
+   */
+  fixIssue(issue: FixableIssue, options: FixOptions): Promise<FixResult>;
+  /**
+   * Batch fix multiple issues.
+   */
+  batchFix(request: BatchFixRequest): Promise<BatchFixResult>;
+  /**
+   * Scan for integrity issues and return fixable ones.
+   */
+  scanAndGetFixables(options?: {
+    pattern?: string;
+    cwd?: string;
+  }): Promise<FixableIssue[]>;
+  /**
+   * Convert an integrity issue into a FixableIssue with strategies.
+   */
+  getToFix(issue: IntegrityIssue): FixableIssue | null;
+  /**
+   * Determine the best strategy for an issue.
+   *
+   * Logic moved from CLI to be shared.
+   */
+  resolveStrategy(issue: FixableIssue, options: {
+    forceStrategy?: FixStrategyType;
+    preferAi?: boolean;
+    interactive?: boolean;
+    select?: (issue: FixableIssue, strategies: FixStrategyType[]) => Promise<FixStrategyType | undefined>;
+  }): Promise<FixStrategyType | undefined>;
+  /**
+   * Determine scan options based on input target.
+   */
+  determineScanOptions(target: string): Promise<{
+    pattern?: string;
+    cwd?: string;
+  }>;
+  /**
+   * Parse CI output JSON into FixableIssues.
+   */
+  parseIssuesFromCIResult(ciIssues: unknown[]): FixableIssue[];
+}
+//#endregion
+export { FixService };
+//# sourceMappingURL=fix-service.d.mts.map

package/dist/services/fix/fix-service.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-service.d.mts","names":[],"sources":["../../../src/services/fix/fix-service.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAkFU,cAtDG,UAAA,CAsDH;EAAL,iBAAA,QAAA;EAiBmB,QAAA,UAAA;EAAuB,WAAA,CAAA,QAAA,EAAA;IAAqB,EAAA,EAnE/B,SAmE+B;IAAR,MAAA,EAnEJ,aAmEI;EA0BlC,CAAA;EAA0B;;;EAuC/C,QAAA,gBAAA;EAca;;;EA0BI,qBAAA,CAAA,KAAA,EA/IS,cA+IT,CAAA,EA/I0B,eA+I1B,EAAA;EAKP;;;EAEJ,iBAAA,CAAA,KAAA,EAlIA,cAkIA,CAAA,EAjIN,IAiIM,CAjID,YAiIC,EAAA,qBAAA,GAAA,YAAA,CAAA,GAAA,SAAA;EAEE;;;EAuDmC,QAAA,CAAA,KAAA,EAzKxB,YAyKwB,EAAA,OAAA,EAzKD,UAyKC,CAAA,EAzKY,OAyKZ,CAzKoB,SAyKpB,CAAA;EAAY;;;oBA/IlC,kBAAkB,QAAQ;;;;;;;MAuC/C,QAAQ;;;;kBAcK,iBAAiB;;;;;;yBAwBxB;oBAEW;;;qBAKP,0BACK,sBACT,QAAQ;MAEd,QAAQ;;;;wCAsCR;;;;;;;gDAiB2C"}