@contractspec/bundle.workspace 1.46.1 → 1.47.0

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

@@ -0,0 +1,85 @@
+//#region src/services/setup/types.d.ts
+/**
+ * Setup service types.
+ */
+/**
+ * Target components that can be configured during setup.
+ */
+type SetupTarget = 'cli-config' | 'vscode-settings' | 'mcp-cursor' | 'mcp-claude' | 'cursor-rules' | 'agents-md';
+/**
+ * All available setup targets.
+ */
+declare const ALL_SETUP_TARGETS: SetupTarget[];
+/**
+ * Human-readable labels for setup targets.
+ */
+declare const SETUP_TARGET_LABELS: Record<SetupTarget, string>;
+/**
+ * Scope of configuration in a monorepo.
+ */
+type SetupScope = 'workspace' | 'package';
+/**
+ * Options for the setup service.
+ */
+interface SetupOptions {
+  /** Root directory of the workspace (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;
+  /** Where to create config: workspace level or package level. */
+  scope?: SetupScope;
+  /** Current package name (if in a monorepo package). */
+  packageName?: string;
+  /** If true, skip prompts and use defaults. */
+  interactive: boolean;
+  /** Specific targets to configure (defaults to all). */
+  targets: SetupTarget[];
+  /** Project name (defaults to directory name). */
+  projectName?: string;
+  /** Default code owners. */
+  defaultOwners?: string[];
+}
+/**
+ * Result of a single file setup operation.
+ */
+interface SetupFileResult {
+  /** Target that was configured. */
+  target: SetupTarget;
+  /** File path that was created or modified. */
+  filePath: string;
+  /** Action taken. */
+  action: 'created' | 'merged' | 'skipped' | 'error';
+  /** Message describing what happened. */
+  message: string;
+}
+/**
+ * Full result of the setup operation.
+ */
+interface SetupResult {
+  /** Whether all operations succeeded. */
+  success: boolean;
+  /** Results for each file. */
+  files: SetupFileResult[];
+  /** Summary message. */
+  summary: string;
+}
+/**
+ * Callback for interactive prompts during setup.
+ */
+interface SetupPromptCallbacks {
+  /** Confirm an action. */
+  confirm: (message: string) => Promise<boolean>;
+  /** Select multiple options. */
+  multiSelect: <T extends string>(message: string, options: {
+    value: T;
+    label: string;
+    selected?: boolean;
+  }[]) => Promise<T[]>;
+  /** Input a string value. */
+  input: (message: string, defaultValue?: string) => Promise<string>;
+}
+//#endregion
+export { ALL_SETUP_TARGETS, SETUP_TARGET_LABELS, SetupFileResult, SetupOptions, SetupPromptCallbacks, SetupResult, SetupScope, SetupTarget };
+//# sourceMappingURL=types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/services/setup/types.ts"],"sourcesContent":[],"mappings":";;AAOA;AAWA;AAYA;AAYA;AAKA;AAwBiB,KAhEL,WAAA,GAgEoB,YAEtB,GAAA,iBAAW,GAAA,YAAA,GAAA,YAAA,GAAA,cAAA,GAAA,WAAA;AAYrB;AAYA;;AAMsB,cArFT,iBAqFS,EArFU,WAqFV,EAAA;;;;AAGsC,cA5E/C,mBA4E+C,EA5E1B,MA4E0B,CA5EnB,WA4EmB,EAAA,MAAA,CAAA;;;;KAhEhD,UAAA;;;;UAKK,YAAA;;;;;;;;UAQP;;;;;;WAMC;;;;;;;;;UAUM,eAAA;;UAEP;;;;;;;;;;;UAYO,WAAA;;;;SAIR;;;;;;;UAQQ,oBAAA;;gCAEe;;;WAIV;;;UACf,QAAQ;;qDAEsC"}

package/dist/services/setup/types.mjs

@@ -0,0 +1,27 @@
+//#region src/services/setup/types.ts
+/**
+* All available setup targets.
+*/
+const ALL_SETUP_TARGETS = [
+	"cli-config",
+	"vscode-settings",
+	"mcp-cursor",
+	"mcp-claude",
+	"cursor-rules",
+	"agents-md"
+];
+/**
+* Human-readable labels for setup targets.
+*/
+const SETUP_TARGET_LABELS = {
+	"cli-config": "CLI Configuration (.contractsrc.json)",
+	"vscode-settings": "VS Code Settings (.vscode/settings.json)",
+	"mcp-cursor": "MCP for Cursor (.cursor/mcp.json)",
+	"mcp-claude": "MCP for Claude Desktop",
+	"cursor-rules": "Cursor AI Rules (.cursor/rules/)",
+	"agents-md": "Project AI Guide (AGENTS.md)"
+};
+
+//#endregion
+export { ALL_SETUP_TARGETS, SETUP_TARGET_LABELS };
+//# sourceMappingURL=types.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","names":[],"sources":["../../../src/services/setup/types.ts"],"sourcesContent":["/**\n * Setup service types.\n */\n\n/**\n * Target components that can be configured during setup.\n */\nexport type SetupTarget =\n  | 'cli-config'\n  | 'vscode-settings'\n  | 'mcp-cursor'\n  | 'mcp-claude'\n  | 'cursor-rules'\n  | 'agents-md';\n\n/**\n * All available setup targets.\n */\nexport const ALL_SETUP_TARGETS: SetupTarget[] = [\n  'cli-config',\n  'vscode-settings',\n  'mcp-cursor',\n  'mcp-claude',\n  'cursor-rules',\n  'agents-md',\n];\n\n/**\n * Human-readable labels for setup targets.\n */\nexport const SETUP_TARGET_LABELS: Record<SetupTarget, string> = {\n  'cli-config': 'CLI Configuration (.contractsrc.json)',\n  'vscode-settings': 'VS Code Settings (.vscode/settings.json)',\n  'mcp-cursor': 'MCP for Cursor (.cursor/mcp.json)',\n  'mcp-claude': 'MCP for Claude Desktop',\n  'cursor-rules': 'Cursor AI Rules (.cursor/rules/)',\n  'agents-md': 'Project AI Guide (AGENTS.md)',\n};\n\n/**\n * Scope of configuration in a monorepo.\n */\nexport type SetupScope = 'workspace' | 'package';\n\n/**\n * Options for the setup service.\n */\nexport interface SetupOptions {\n  /** Root directory of the workspace (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  /** Where to create config: workspace level or package level. */\n  scope?: SetupScope;\n  /** Current package name (if in a monorepo package). */\n  packageName?: string;\n  /** If true, skip prompts and use defaults. */\n  interactive: boolean;\n  /** Specific targets to configure (defaults to all). */\n  targets: SetupTarget[];\n  /** Project name (defaults to directory name). */\n  projectName?: string;\n  /** Default code owners. */\n  defaultOwners?: string[];\n}\n\n/**\n * Result of a single file setup operation.\n */\nexport interface SetupFileResult {\n  /** Target that was configured. */\n  target: SetupTarget;\n  /** File path that was created or modified. */\n  filePath: string;\n  /** Action taken. */\n  action: 'created' | 'merged' | 'skipped' | 'error';\n  /** Message describing what happened. */\n  message: string;\n}\n\n/**\n * Full result of the setup operation.\n */\nexport interface SetupResult {\n  /** Whether all operations succeeded. */\n  success: boolean;\n  /** Results for each file. */\n  files: SetupFileResult[];\n  /** Summary message. */\n  summary: string;\n}\n\n/**\n * Callback for interactive prompts during setup.\n */\nexport interface SetupPromptCallbacks {\n  /** Confirm an action. */\n  confirm: (message: string) => Promise<boolean>;\n  /** Select multiple options. */\n  multiSelect: <T extends string>(\n    message: string,\n    options: { value: T; label: string; selected?: boolean }[]\n  ) => Promise<T[]>;\n  /** Input a string value. */\n  input: (message: string, defaultValue?: string) => Promise<string>;\n}\n"],"mappings":";;;;AAkBA,MAAa,oBAAmC;CAC9C;CACA;CACA;CACA;CACA;CACA;CACD;;;;AAKD,MAAa,sBAAmD;CAC9D,cAAc;CACd,mBAAmB;CACnB,cAAc;CACd,cAAc;CACd,gBAAgB;CAChB,aAAa;CACd"}

package/dist/services/sync.d.mts

@@ -0,0 +1,42 @@
+import { FsAdapter } from "../ports/fs.mjs";
+import { LoggerAdapter } from "../ports/logger.mjs";
+import { ValidateSpecResult } from "./validate/spec-validator.mjs";
+import "./validate/index.mjs";
+import { BuildSpecOptions } from "./build.mjs";
+import { WorkspaceConfig } from "@contractspec/module.workspace";
+
+//#region src/services/sync.d.ts
+
+interface SyncSpecsOptions {
+  pattern?: string;
+  outputDirs?: (string | undefined)[];
+  validate?: boolean;
+  buildOptions?: Omit<BuildSpecOptions, 'outputDir'>;
+  dryRun?: boolean;
+}
+interface SyncSpecsRunResult {
+  specPath: string;
+  outputDir?: string;
+  validation?: ValidateSpecResult;
+  build?: unknown;
+  error?: {
+    phase: 'validate' | 'build';
+    message: string;
+  };
+}
+interface SyncSpecsResult {
+  specs: string[];
+  runs: SyncSpecsRunResult[];
+}
+type SyncBuildFn<B> = (specPath: string, outputDir: string | undefined) => Promise<B>;
+type SyncValidateFn = (specPath: string) => Promise<ValidateSpecResult>;
+declare function syncSpecs(adapters: {
+  fs: FsAdapter;
+  logger: LoggerAdapter;
+}, config: WorkspaceConfig, options?: SyncSpecsOptions, overrides?: {
+  build?: SyncBuildFn<unknown>;
+  validate?: SyncValidateFn;
+}): Promise<SyncSpecsResult>;
+//#endregion
+export { SyncBuildFn, SyncSpecsOptions, SyncSpecsResult, SyncSpecsRunResult, SyncValidateFn, syncSpecs };
+//# sourceMappingURL=sync.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.mts","names":[],"sources":["../../src/services/sync.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAqCY,UAxBK,gBAAA,CA2BJ;EAED,OAAA,CAAA,EAAA,MAAA;EAEU,UAAA,CAAA,EAAS,CAAA,MAAA,GAAA,SAAA,CAAA,EAAA;EACb,QAAA,CAAA,EAAA,OAAA;EAAmB,YAAA,CAAA,EA5BpB,IA4BoB,CA5Bf,gBA4Be,EAAA,WAAA,CAAA;EAC3B,MAAA,CAAA,EAAA,OAAA;;AAGE,UA5BK,kBAAA,CA4BL;EACG,QAAA,EAAA,MAAA;EAEJ,SAAA,CAAA,EAAA,MAAA;EAAR,UAAA,CAAA,EA5BY,kBA4BZ;EAAO,KAAA,CAAA,EAAA,OAAA;;;;;;UApBO,eAAA;;QAET;;KAGI,sEAGP,QAAQ;KAED,cAAA,yBAAuC,QAAQ;iBAErC,SAAA;MACJ;UAAmB;WAC3B,2BACC;UAEC;aACG;IAEZ,QAAQ"}

package/dist/services/sync.mjs

@@ -0,0 +1,64 @@
+import { validateSpec } from "./validate/spec-validator.mjs";
+import "./validate/index.mjs";
+import { buildSpec } from "./build.mjs";
+
+//#region src/services/sync.ts
+async function syncSpecs(adapters, config, options = {}, overrides) {
+	const { fs, logger } = adapters;
+	const specs = await fs.glob({ pattern: options.pattern });
+	const outputDirs = options.outputDirs?.length ? options.outputDirs : [void 0];
+	const runs = [];
+	const validateFn = overrides?.validate ?? ((specPath) => validateSpec(specPath, {
+		fs,
+		logger
+	}));
+	const buildFn = overrides?.build ?? ((specPath, outputDir) => buildSpec(specPath, {
+		fs,
+		logger
+	}, outputDir ? {
+		...config,
+		outputDir
+	} : config, {
+		...options.buildOptions ?? {},
+		outputDir
+	}));
+	for (const specPath of specs) for (const outputDir of outputDirs) {
+		const run = {
+			specPath,
+			outputDir
+		};
+		if (options.validate) try {
+			run.validation = await validateFn(specPath);
+		} catch (error) {
+			run.error = {
+				phase: "validate",
+				message: error instanceof Error ? error.message : String(error)
+			};
+			runs.push(run);
+			continue;
+		}
+		if (!options.dryRun) try {
+			run.build = await buildFn(specPath, outputDir);
+		} catch (error) {
+			run.error = {
+				phase: "build",
+				message: error instanceof Error ? error.message : String(error)
+			};
+			runs.push(run);
+			continue;
+		}
+		else logger.info("[dry-run] syncSpecs skipped build", {
+			specPath,
+			outputDir
+		});
+		runs.push(run);
+	}
+	return {
+		specs,
+		runs
+	};
+}
+
+//#endregion
+export { syncSpecs };
+//# sourceMappingURL=sync.mjs.map

package/dist/services/sync.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.mjs","names":[],"sources":["../../src/services/sync.ts"],"sourcesContent":["/**\n * Sync service.\n *\n * Build (and optionally validate) all discovered specs, optionally repeating into\n * multiple output buckets (./generated/<bucket>/ or any output dir).\n */\n\nimport type { WorkspaceConfig } from '@contractspec/module.workspace';\nimport type { FsAdapter } from '../ports/fs';\nimport type { LoggerAdapter } from '../ports/logger';\nimport { buildSpec, type BuildSpecOptions } from './build';\nimport { validateSpec, type ValidateSpecResult } from './validate';\n\nexport interface SyncSpecsOptions {\n  pattern?: string;\n  outputDirs?: (string | undefined)[];\n  validate?: boolean;\n  buildOptions?: Omit<BuildSpecOptions, 'outputDir'>;\n  dryRun?: boolean;\n}\n\nexport interface SyncSpecsRunResult {\n  specPath: string;\n  outputDir?: string;\n  validation?: ValidateSpecResult;\n  build?: unknown;\n  error?: {\n    phase: 'validate' | 'build';\n    message: string;\n  };\n}\n\nexport interface SyncSpecsResult {\n  specs: string[];\n  runs: SyncSpecsRunResult[];\n}\n\nexport type SyncBuildFn<B> = (\n  specPath: string,\n  outputDir: string | undefined\n) => Promise<B>;\n\nexport type SyncValidateFn = (specPath: string) => Promise<ValidateSpecResult>;\n\nexport async function syncSpecs(\n  adapters: { fs: FsAdapter; logger: LoggerAdapter },\n  config: WorkspaceConfig,\n  options: SyncSpecsOptions = {},\n  overrides?: {\n    build?: SyncBuildFn<unknown>;\n    validate?: SyncValidateFn;\n  }\n): Promise<SyncSpecsResult> {\n  const { fs, logger } = adapters;\n\n  const specs = await fs.glob({ pattern: options.pattern });\n  const outputDirs = options.outputDirs?.length\n    ? options.outputDirs\n    : [undefined];\n\n  const runs: SyncSpecsRunResult[] = [];\n\n  const validateFn: SyncValidateFn =\n    overrides?.validate ??\n    ((specPath) => validateSpec(specPath, { fs, logger }));\n\n  const buildFn: SyncBuildFn<unknown> =\n    overrides?.build ??\n    ((specPath, outputDir) =>\n      buildSpec(\n        specPath,\n        { fs, logger },\n        outputDir ? { ...config, outputDir } : config,\n        { ...(options.buildOptions ?? {}), outputDir }\n      ));\n\n  for (const specPath of specs) {\n    for (const outputDir of outputDirs) {\n      const run: SyncSpecsRunResult = { specPath, outputDir };\n\n      if (options.validate) {\n        try {\n          run.validation = await validateFn(specPath);\n        } catch (error) {\n          run.error = {\n            phase: 'validate',\n            message: error instanceof Error ? error.message : String(error),\n          };\n          runs.push(run);\n          continue;\n        }\n      }\n\n      if (!options.dryRun) {\n        try {\n          run.build = await buildFn(specPath, outputDir);\n        } catch (error) {\n          run.error = {\n            phase: 'build',\n            message: error instanceof Error ? error.message : String(error),\n          };\n          runs.push(run);\n          continue;\n        }\n      } else {\n        logger.info('[dry-run] syncSpecs skipped build', {\n          specPath,\n          outputDir,\n        });\n      }\n\n      runs.push(run);\n    }\n  }\n\n  return { specs, runs };\n}\n"],"mappings":";;;;;AA4CA,eAAsB,UACpB,UACA,QACA,UAA4B,EAAE,EAC9B,WAI0B;CAC1B,MAAM,EAAE,IAAI,WAAW;CAEvB,MAAM,QAAQ,MAAM,GAAG,KAAK,EAAE,SAAS,QAAQ,SAAS,CAAC;CACzD,MAAM,aAAa,QAAQ,YAAY,SACnC,QAAQ,aACR,CAAC,OAAU;CAEf,MAAM,OAA6B,EAAE;CAErC,MAAM,aACJ,WAAW,cACT,aAAa,aAAa,UAAU;EAAE;EAAI;EAAQ,CAAC;CAEvD,MAAM,UACJ,WAAW,WACT,UAAU,cACV,UACE,UACA;EAAE;EAAI;EAAQ,EACd,YAAY;EAAE,GAAG;EAAQ;EAAW,GAAG,QACvC;EAAE,GAAI,QAAQ,gBAAgB,EAAE;EAAG;EAAW,CAC/C;AAEL,MAAK,MAAM,YAAY,MACrB,MAAK,MAAM,aAAa,YAAY;EAClC,MAAM,MAA0B;GAAE;GAAU;GAAW;AAEvD,MAAI,QAAQ,SACV,KAAI;AACF,OAAI,aAAa,MAAM,WAAW,SAAS;WACpC,OAAO;AACd,OAAI,QAAQ;IACV,OAAO;IACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;IAChE;AACD,QAAK,KAAK,IAAI;AACd;;AAIJ,MAAI,CAAC,QAAQ,OACX,KAAI;AACF,OAAI,QAAQ,MAAM,QAAQ,UAAU,UAAU;WACvC,OAAO;AACd,OAAI,QAAQ;IACV,OAAO;IACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;IAChE;AACD,QAAK,KAAK,IAAI;AACd;;MAGF,QAAO,KAAK,qCAAqC;GAC/C;GACA;GACD,CAAC;AAGJ,OAAK,KAAK,IAAI;;AAIlB,QAAO;EAAE;EAAO;EAAM"}

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

@@ -0,0 +1,2 @@
+import { RunTestsResult, TestServiceOptions, TestServiceResult, listTests, runTestSpecs, runTests } from "./test-service.mjs";
+import { TestGeneratorOptions, TestGeneratorService } from "./test-generator-service.mjs";

package/dist/services/test/index.mjs

@@ -0,0 +1,4 @@
+import { listTests, runTestSpecs, runTests } from "./test-service.mjs";
+import { TestGeneratorService } from "./test-generator-service.mjs";
+
+export {  };

package/dist/services/test/test-generator-service.d.mts

@@ -0,0 +1,24 @@
+import { LoggerAdapter } from "../../ports/logger.mjs";
+import { OperationSpec } from "@contractspec/lib.contracts";
+import { TestSpec } from "@contractspec/lib.contracts/tests";
+import { LanguageModel } from "@contractspec/lib.ai-agent";
+
+//#region src/services/test/test-generator-service.d.ts
+interface TestGeneratorOptions {
+  model?: LanguageModel;
+  maxScenarios?: number;
+}
+declare class TestGeneratorService {
+  private readonly logger;
+  private readonly defaultModel?;
+  constructor(logger: LoggerAdapter, defaultModel?: LanguageModel | undefined);
+  generateTests(spec: OperationSpec<any, any>,
+  // Use any to satisfy generics for now
+  options?: TestGeneratorOptions): Promise<TestSpec>;
+  private parseResponse;
+  private enrichSpec;
+  private logUsage;
+}
+//#endregion
+export { TestGeneratorOptions, TestGeneratorService };
+//# sourceMappingURL=test-generator-service.d.mts.map

package/dist/services/test/test-generator-service.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-generator-service.d.mts","names":[],"sources":["../../../src/services/test/test-generator-service.ts"],"sourcesContent":[],"mappings":";;;;;;UAYiB,oBAAA;UACP;EADO,YAAA,CAAA,EAAA,MAAA;AAyBjB;AAE6B,cAFhB,oBAAA,CAEgB;EACO,iBAAA,MAAA;EAK1B,iBAAA,YAAA;EACG,WAAA,CAAA,MAAA,EAPgB,aAOhB,EAAA,YAAA,CAAA,EANuB,aAMvB,GAAA,SAAA;EACA,aAAA,CAAA,IAAA,EAFH,aAEG,CAAA,GAAA,EAAA,GAAA,CAAA;EAAA;EAAR,OAAA,CAAA,EADQ,oBACR,CAAA,EAAA,OAAA,CAAQ,QAAR,CAAA;EAAO,QAAA,aAAA"}

package/dist/services/test/test-generator-service.mjs

@@ -0,0 +1,92 @@
+import { generateText } from "ai";
+import "@contractspec/lib.contracts/tests";
+
+//#region src/services/test/test-generator-service.ts
+const SYSTEM_PROMPT = `
+You are an expert software test engineer specializing in ContractSpec.
+Your goal is to generate comprehensive test scenarios for a given ContractSpec Operation.
+
+A TestSpec consists of:
+- targeted operation
+- fixtures (setup state)
+- scenarios (given/when/then)
+
+For each scenario:
+1. Define 'given': initial state or data setup
+2. Define 'when': the operation execution with specific input
+3. Define 'then': assertions on output, error, or events
+
+Generate scenarios covering:
+- Happy path (valid input, successful execution)
+- Edge cases (boundary values, optional fields)
+- Error cases (invalid input, business rule violations)
+`.trim();
+var TestGeneratorService = class {
+	constructor(logger, defaultModel) {
+		this.logger = logger;
+		this.defaultModel = defaultModel;
+	}
+	async generateTests(spec, options = {}) {
+		const model = options.model ?? this.defaultModel;
+		if (!model) throw new Error("No AI model provided for test generation");
+		this.logger.info(`Generating tests for operation ${spec.meta.key}...`);
+		const prompt = `
+Generate a TestSpec for the following Operation:
+
+\`\`\`json
+${JSON.stringify(spec, null, 2)}
+\`\`\`
+
+The output must be a valid JSON object conforming to the TestSpec interface.
+Do not include markdown formatting or explanations, just the JSON.
+`.trim();
+		try {
+			const { text, usage } = await generateText({
+				model,
+				system: SYSTEM_PROMPT,
+				prompt
+			});
+			this.logUsage(usage);
+			const generated = this.parseResponse(text);
+			return this.enrichSpec(generated, spec);
+		} catch (error) {
+			this.logger.error("Failed to generate tests", { error });
+			throw error;
+		}
+	}
+	parseResponse(text) {
+		try {
+			const cleaned = text.replace(/```json\n?|\n?```/g, "");
+			return JSON.parse(cleaned);
+		} catch (_e) {
+			throw new Error("Failed to parse AI response as JSON");
+		}
+	}
+	enrichSpec(generated, target) {
+		return {
+			meta: {
+				key: `${target.meta.key}.test`,
+				version: target.meta.version ?? "0.0.1",
+				owners: target.meta.owners ?? []
+			},
+			target: {
+				type: "operation",
+				operation: {
+					key: target.meta.key,
+					version: target.meta.version
+				}
+			},
+			fixtures: generated.fixtures ?? [],
+			scenarios: generated.scenarios ?? [],
+			coverage: generated.coverage
+		};
+	}
+	logUsage(usage) {
+		const u = usage;
+		this.logger.debug(`AI Usage: ${u.promptTokens} prompt + ${u.completionTokens} completion = ${u.totalTokens} total tokens`);
+	}
+};
+
+//#endregion
+export { TestGeneratorService };
+//# sourceMappingURL=test-generator-service.mjs.map

package/dist/services/test/test-generator-service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-generator-service.mjs","names":[],"sources":["../../../src/services/test/test-generator-service.ts"],"sourcesContent":["import type {\n  LanguageModel,\n  LanguageModelUsage,\n} from '@contractspec/lib.ai-agent';\nimport { generateText } from 'ai';\nimport {\n  type TestSpec,\n  type TestTarget,\n} from '@contractspec/lib.contracts/tests';\nimport type { OperationSpec } from '@contractspec/lib.contracts';\nimport type { LoggerAdapter } from '../../ports/logger';\n\nexport interface TestGeneratorOptions {\n  model?: LanguageModel;\n  maxScenarios?: number;\n}\n\nconst SYSTEM_PROMPT = `\nYou are an expert software test engineer specializing in ContractSpec.\nYour goal is to generate comprehensive test scenarios for a given ContractSpec Operation.\n\nA TestSpec consists of:\n- targeted operation\n- fixtures (setup state)\n- scenarios (given/when/then)\n\nFor each scenario:\n1. Define 'given': initial state or data setup\n2. Define 'when': the operation execution with specific input\n3. Define 'then': assertions on output, error, or events\n\nGenerate scenarios covering:\n- Happy path (valid input, successful execution)\n- Edge cases (boundary values, optional fields)\n- Error cases (invalid input, business rule violations)\n`.trim();\n\nexport class TestGeneratorService {\n  constructor(\n    private readonly logger: LoggerAdapter,\n    private readonly defaultModel?: LanguageModel\n  ) {}\n\n  async generateTests(\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    spec: OperationSpec<any, any>, // Use any to satisfy generics for now\n    options: TestGeneratorOptions = {}\n  ): Promise<TestSpec> {\n    const model = options.model ?? this.defaultModel;\n    if (!model) {\n      throw new Error('No AI model provided for test generation');\n    }\n\n    this.logger.info(`Generating tests for operation ${spec.meta.key}...`);\n\n    const prompt = `\nGenerate a TestSpec for the following Operation:\n\n\\`\\`\\`json\n${JSON.stringify(spec, null, 2)}\n\\`\\`\\`\n\nThe output must be a valid JSON object conforming to the TestSpec interface.\nDo not include markdown formatting or explanations, just the JSON.\n`.trim();\n\n    try {\n      const { text, usage } = await generateText({\n        model,\n        system: SYSTEM_PROMPT,\n        prompt,\n      });\n\n      this.logUsage(usage);\n\n      const generated = this.parseResponse(text);\n      return this.enrichSpec(generated, spec);\n    } catch (error) {\n      this.logger.error('Failed to generate tests', { error });\n      throw error;\n    }\n  }\n\n  private parseResponse(text: string): Partial<TestSpec> {\n    try {\n      // clean markdown code blocks if present\n      const cleaned = text.replace(/```json\\n?|\\n?```/g, '');\n      return JSON.parse(cleaned);\n    } catch (_e) {\n      throw new Error('Failed to parse AI response as JSON');\n    }\n  }\n\n  private enrichSpec(\n    generated: Partial<TestSpec>,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    target: OperationSpec<any, any>\n  ): TestSpec {\n    const meta = {\n      key: `${target.meta.key}.test`,\n      version: target.meta.version ?? '0.0.1',\n      owners: target.meta.owners ?? [],\n    };\n\n    const targetRef: TestTarget = {\n      type: 'operation',\n      operation: {\n        key: target.meta.key,\n        version: target.meta.version,\n      },\n    };\n\n    return {\n      meta,\n      target: targetRef,\n      fixtures: generated.fixtures ?? [],\n      scenarios: generated.scenarios ?? [],\n      coverage: generated.coverage,\n    } as TestSpec;\n  }\n\n  private logUsage(usage: LanguageModelUsage) {\n    // Cast to any to avoid type issues with different AI SDK versions\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const u = usage as any;\n    this.logger.debug(\n      `AI Usage: ${u.promptTokens} prompt + ${u.completionTokens} completion = ${u.totalTokens} total tokens`\n    );\n  }\n}\n"],"mappings":";;;;AAiBA,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;EAkBpB,MAAM;AAER,IAAa,uBAAb,MAAkC;CAChC,YACE,AAAiB,QACjB,AAAiB,cACjB;EAFiB;EACA;;CAGnB,MAAM,cAEJ,MACA,UAAgC,EAAE,EACf;EACnB,MAAM,QAAQ,QAAQ,SAAS,KAAK;AACpC,MAAI,CAAC,MACH,OAAM,IAAI,MAAM,2CAA2C;AAG7D,OAAK,OAAO,KAAK,kCAAkC,KAAK,KAAK,IAAI,KAAK;EAEtE,MAAM,SAAS;;;;EAIjB,KAAK,UAAU,MAAM,MAAM,EAAE,CAAC;;;;;EAK9B,MAAM;AAEJ,MAAI;GACF,MAAM,EAAE,MAAM,UAAU,MAAM,aAAa;IACzC;IACA,QAAQ;IACR;IACD,CAAC;AAEF,QAAK,SAAS,MAAM;GAEpB,MAAM,YAAY,KAAK,cAAc,KAAK;AAC1C,UAAO,KAAK,WAAW,WAAW,KAAK;WAChC,OAAO;AACd,QAAK,OAAO,MAAM,4BAA4B,EAAE,OAAO,CAAC;AACxD,SAAM;;;CAIV,AAAQ,cAAc,MAAiC;AACrD,MAAI;GAEF,MAAM,UAAU,KAAK,QAAQ,sBAAsB,GAAG;AACtD,UAAO,KAAK,MAAM,QAAQ;WACnB,IAAI;AACX,SAAM,IAAI,MAAM,sCAAsC;;;CAI1D,AAAQ,WACN,WAEA,QACU;AAeV,SAAO;GACL,MAfW;IACX,KAAK,GAAG,OAAO,KAAK,IAAI;IACxB,SAAS,OAAO,KAAK,WAAW;IAChC,QAAQ,OAAO,KAAK,UAAU,EAAE;IACjC;GAYC,QAV4B;IAC5B,MAAM;IACN,WAAW;KACT,KAAK,OAAO,KAAK;KACjB,SAAS,OAAO,KAAK;KACtB;IACF;GAKC,UAAU,UAAU,YAAY,EAAE;GAClC,WAAW,UAAU,aAAa,EAAE;GACpC,UAAU,UAAU;GACrB;;CAGH,AAAQ,SAAS,OAA2B;EAG1C,MAAM,IAAI;AACV,OAAK,OAAO,MACV,aAAa,EAAE,aAAa,YAAY,EAAE,iBAAiB,gBAAgB,EAAE,YAAY,eAC1F"}

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

@@ -0,0 +1,27 @@
+import { WorkspaceAdapters } from "../../ports/logger.mjs";
+import { OperationSpecRegistry } from "@contractspec/lib.contracts";
+import { TestRunResult, TestSpec } from "@contractspec/lib.contracts/tests";
+
+//#region src/services/test/test-service.d.ts
+interface TestServiceOptions {
+  registry?: string;
+  pattern?: string;
+}
+interface TestServiceResult {
+  results: TestRunResult[];
+  passed: boolean;
+}
+interface RunTestsResult {
+  results: TestRunResult[];
+  passed: number;
+  failed: number;
+}
+declare function runTests(specs: TestSpec[], registry: OperationSpecRegistry): Promise<RunTestsResult>;
+declare function runTestSpecs(specFiles: string[], options: TestServiceOptions, adapters: WorkspaceAdapters): Promise<TestServiceResult>;
+/**
+ * List all available tests in the given files.
+ */
+declare function listTests(specFiles: string[], adapters: WorkspaceAdapters): Promise<TestSpec[]>;
+//#endregion
+export { RunTestsResult, TestServiceOptions, TestServiceResult, listTests, runTestSpecs, runTests };
+//# sourceMappingURL=test-service.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test-service.d.mts","names":[],"sources":["../../../src/services/test/test-service.ts"],"sourcesContent":[],"mappings":";;;;;UAUiB,kBAAA;;EAAA,OAAA,CAAA,EAAA,MAAA;AAKjB;AAKiB,UALA,iBAAA,CAMN;EAKW,OAAA,EAVX,aAUmB,EAAA;EACrB,MAAA,EAAA,OAAA;;AAEE,UATM,cAAA,CASN;EAAR,OAAA,EARQ,aAQR,EAAA;EAAO,MAAA,EAAA,MAAA;EAuBY,MAAA,EAAA,MAAA;;AAGV,iBA7BU,QAAA,CA6BV,KAAA,EA5BH,QA4BG,EAAA,EAAA,QAAA,EA3BA,qBA2BA,CAAA,EA1BT,OA0BS,CA1BD,cA0BC,CAAA;AACD,iBAJW,YAAA,CAIX,SAAA,EAAA,MAAA,EAAA,EAAA,OAAA,EAFA,kBAEA,EAAA,QAAA,EADC,iBACD,CAAA,EAAR,OAAQ,CAAA,iBAAA,CAAA;;;AA2DX;AAEY,iBAFU,SAAA,CAEV,SAAA,EAAA,MAAA,EAAA,EAAA,QAAA,EAAA,iBAAA,CAAA,EACT,OADS,CACD,QADC,EAAA,CAAA"}

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

@@ -0,0 +1,94 @@
+import { loadTypeScriptModule } from "../../utils/module-loader.mjs";
+import { resolve } from "path";
+import { OperationSpecRegistry } from "@contractspec/lib.contracts";
+import { TestRunner } from "@contractspec/lib.contracts/tests";
+
+//#region src/services/test/test-service.ts
+async function runTests(specs, registry) {
+	const runner = new TestRunner({ registry });
+	const results = [];
+	let passed = 0;
+	let failed = 0;
+	for (const spec of specs) {
+		const result = await runner.run(spec);
+		results.push(result);
+		passed += result.passed;
+		failed += result.failed;
+	}
+	return {
+		results,
+		passed,
+		failed
+	};
+}
+async function runTestSpecs(specFiles, options, adapters) {
+	const { logger } = adapters;
+	let registry;
+	if (options.registry) registry = await loadRegistry(resolve(options.registry));
+	else {
+		registry = new OperationSpecRegistry();
+		logger.warn("No registry module provided. Scenarios that execute operations without handlers will fail.");
+	}
+	const runner = new TestRunner({ registry });
+	const results = [];
+	let allPassed = true;
+	for (const specFile of specFiles) try {
+		const specs = extractTestSpecs(await loadTypeScriptModule(resolve(specFile)));
+		if (specs.length === 0) {
+			logger.warn(`No TestSpec exports found in ${specFile}`);
+			continue;
+		}
+		for (const spec of specs) {
+			logger.info(`Running ${spec.meta.key}...`);
+			const result = await runner.run(spec);
+			results.push(result);
+			if (result.failed > 0) {
+				allPassed = false;
+				logger.error(`${spec.meta.key} failed (${result.failed}/${result.scenarios.length})`);
+			} else logger.info(`${spec.meta.key} passed (${result.passed}/${result.scenarios.length})`);
+		}
+	} catch (error) {
+		logger.error(`Failed to load/run spec ${specFile}: ${error instanceof Error ? error.message : String(error)}`);
+		allPassed = false;
+	}
+	return {
+		results,
+		passed: allPassed
+	};
+}
+/**
+* List all available tests in the given files.
+*/
+async function listTests(specFiles, adapters) {
+	const specs = [];
+	for (const specFile of specFiles) try {
+		const fileSpecs = extractTestSpecs(await loadTypeScriptModule(resolve(specFile)));
+		specs.push(...fileSpecs);
+	} catch (error) {
+		adapters.logger.warn(`Failed to load tests from ${specFile}: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	return specs;
+}
+function extractTestSpecs(exports) {
+	const specs = [];
+	for (const value of Object.values(exports)) if (isTestSpec(value)) specs.push(value);
+	return specs;
+}
+function isTestSpec(value) {
+	return typeof value === "object" && value !== null && Array.isArray(value.scenarios) && !!value.meta?.key;
+}
+async function loadRegistry(modulePath) {
+	const exports = await loadTypeScriptModule(modulePath);
+	if (exports instanceof OperationSpecRegistry) return exports;
+	if (exports.registry instanceof OperationSpecRegistry) return exports.registry;
+	const factory = typeof exports.createRegistry === "function" ? exports.createRegistry : typeof exports.default === "function" ? exports.default : void 0;
+	if (factory) {
+		const result = await factory();
+		if (result instanceof OperationSpecRegistry) return result;
+	}
+	throw new Error(`Registry module ${modulePath} must export a OperationSpecRegistry instance or a factory function returning one.`);
+}
+
+//#endregion
+export { listTests, runTestSpecs, runTests };
+//# sourceMappingURL=test-service.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test-service.mjs","names":[],"sources":["../../../src/services/test/test-service.ts"],"sourcesContent":["import { resolve } from 'path';\nimport {\n  TestRunner,\n  type TestSpec,\n  type TestRunResult,\n} from '@contractspec/lib.contracts/tests';\nimport { OperationSpecRegistry } from '@contractspec/lib.contracts';\nimport { loadTypeScriptModule } from '../../utils/module-loader';\nimport type { WorkspaceAdapters } from '../../ports/logger';\n\nexport interface TestServiceOptions {\n  registry?: string;\n  pattern?: string;\n}\n\nexport interface TestServiceResult {\n  results: TestRunResult[];\n  passed: boolean;\n}\n\nexport interface RunTestsResult {\n  results: TestRunResult[];\n  passed: number;\n  failed: number;\n}\n\nexport async function runTests(\n  specs: TestSpec[],\n  registry: OperationSpecRegistry\n): Promise<RunTestsResult> {\n  const runner = new TestRunner({ registry });\n\n  const results: TestRunResult[] = [];\n  let passed = 0;\n  let failed = 0;\n\n  for (const spec of specs) {\n    const result = await runner.run(spec);\n    results.push(result);\n    passed += result.passed;\n    failed += result.failed;\n  }\n\n  return { results, passed, failed };\n}\n\ninterface LoadedRegistryModule {\n  default?: unknown;\n  createRegistry?: () => Promise<OperationSpecRegistry> | OperationSpecRegistry;\n  registry?: OperationSpecRegistry;\n}\n\nexport async function runTestSpecs(\n  specFiles: string[],\n  options: TestServiceOptions,\n  adapters: WorkspaceAdapters\n): Promise<TestServiceResult> {\n  const { logger } = adapters;\n\n  // Load registry\n  let registry: OperationSpecRegistry;\n  if (options.registry) {\n    registry = await loadRegistry(resolve(options.registry));\n  } else {\n    registry = new OperationSpecRegistry();\n    logger.warn(\n      'No registry module provided. Scenarios that execute operations without handlers will fail.'\n    );\n  }\n\n  const runner = new TestRunner({ registry });\n  const results: TestRunResult[] = [];\n  let allPassed = true;\n\n  for (const specFile of specFiles) {\n    try {\n      const resolvedPath = resolve(specFile);\n      const exports = await loadTypeScriptModule(resolvedPath);\n      const specs = extractTestSpecs(exports);\n\n      if (specs.length === 0) {\n        logger.warn(`No TestSpec exports found in ${specFile}`);\n        continue;\n      }\n\n      for (const spec of specs) {\n        logger.info(`Running ${spec.meta.key}...`);\n        const result = await runner.run(spec);\n        results.push(result);\n\n        if (result.failed > 0) {\n          allPassed = false;\n          logger.error(\n            `${spec.meta.key} failed (${result.failed}/${result.scenarios.length})`\n          );\n        } else {\n          logger.info(\n            `${spec.meta.key} passed (${result.passed}/${result.scenarios.length})`\n          );\n        }\n      }\n    } catch (error) {\n      logger.error(\n        `Failed to load/run spec ${specFile}: ${error instanceof Error ? error.message : String(error)}`\n      );\n      allPassed = false;\n    }\n  }\n\n  return { results, passed: allPassed };\n}\n\n/**\n * List all available tests in the given files.\n */\nexport async function listTests(\n  specFiles: string[],\n  adapters: WorkspaceAdapters\n): Promise<TestSpec[]> {\n  const specs: TestSpec[] = [];\n\n  for (const specFile of specFiles) {\n    try {\n      const resolvedPath = resolve(specFile);\n      const exports = await loadTypeScriptModule(resolvedPath);\n      const fileSpecs = extractTestSpecs(exports);\n      specs.push(...fileSpecs);\n    } catch (error) {\n      adapters.logger.warn(\n        `Failed to load tests from ${specFile}: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n\n  return specs;\n}\n\nfunction extractTestSpecs(exports: Record<string, unknown>): TestSpec[] {\n  const specs: TestSpec[] = [];\n  for (const value of Object.values(exports)) {\n    if (isTestSpec(value)) {\n      specs.push(value);\n    }\n  }\n  return specs;\n}\n\nfunction isTestSpec(value: unknown): value is TestSpec {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    Array.isArray((value as TestSpec).scenarios) &&\n    !!(value as TestSpec).meta?.key\n  );\n}\n\nasync function loadRegistry(\n  modulePath: string\n): Promise<OperationSpecRegistry> {\n  const exports = (await loadTypeScriptModule(\n    modulePath\n  )) as LoadedRegistryModule;\n\n  if (exports instanceof OperationSpecRegistry) {\n    return exports;\n  }\n  if (exports.registry instanceof OperationSpecRegistry) {\n    return exports.registry;\n  }\n\n  const factory =\n    typeof exports.createRegistry === 'function'\n      ? exports.createRegistry\n      : typeof exports.default === 'function'\n        ? (exports.default as () =>\n            | Promise<OperationSpecRegistry>\n            | OperationSpecRegistry)\n        : undefined;\n\n  if (factory) {\n    const result = await factory();\n    if (result instanceof OperationSpecRegistry) {\n      return result;\n    }\n  }\n\n  throw new Error(\n    `Registry module ${modulePath} must export a OperationSpecRegistry instance or a factory function returning one.`\n  );\n}\n"],"mappings":";;;;;;AA0BA,eAAsB,SACpB,OACA,UACyB;CACzB,MAAM,SAAS,IAAI,WAAW,EAAE,UAAU,CAAC;CAE3C,MAAM,UAA2B,EAAE;CACnC,IAAI,SAAS;CACb,IAAI,SAAS;AAEb,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,SAAS,MAAM,OAAO,IAAI,KAAK;AACrC,UAAQ,KAAK,OAAO;AACpB,YAAU,OAAO;AACjB,YAAU,OAAO;;AAGnB,QAAO;EAAE;EAAS;EAAQ;EAAQ;;AASpC,eAAsB,aACpB,WACA,SACA,UAC4B;CAC5B,MAAM,EAAE,WAAW;CAGnB,IAAI;AACJ,KAAI,QAAQ,SACV,YAAW,MAAM,aAAa,QAAQ,QAAQ,SAAS,CAAC;MACnD;AACL,aAAW,IAAI,uBAAuB;AACtC,SAAO,KACL,6FACD;;CAGH,MAAM,SAAS,IAAI,WAAW,EAAE,UAAU,CAAC;CAC3C,MAAM,UAA2B,EAAE;CACnC,IAAI,YAAY;AAEhB,MAAK,MAAM,YAAY,UACrB,KAAI;EAGF,MAAM,QAAQ,iBADE,MAAM,qBADD,QAAQ,SAAS,CACkB,CACjB;AAEvC,MAAI,MAAM,WAAW,GAAG;AACtB,UAAO,KAAK,gCAAgC,WAAW;AACvD;;AAGF,OAAK,MAAM,QAAQ,OAAO;AACxB,UAAO,KAAK,WAAW,KAAK,KAAK,IAAI,KAAK;GAC1C,MAAM,SAAS,MAAM,OAAO,IAAI,KAAK;AACrC,WAAQ,KAAK,OAAO;AAEpB,OAAI,OAAO,SAAS,GAAG;AACrB,gBAAY;AACZ,WAAO,MACL,GAAG,KAAK,KAAK,IAAI,WAAW,OAAO,OAAO,GAAG,OAAO,UAAU,OAAO,GACtE;SAED,QAAO,KACL,GAAG,KAAK,KAAK,IAAI,WAAW,OAAO,OAAO,GAAG,OAAO,UAAU,OAAO,GACtE;;UAGE,OAAO;AACd,SAAO,MACL,2BAA2B,SAAS,IAAI,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,GAC/F;AACD,cAAY;;AAIhB,QAAO;EAAE;EAAS,QAAQ;EAAW;;;;;AAMvC,eAAsB,UACpB,WACA,UACqB;CACrB,MAAM,QAAoB,EAAE;AAE5B,MAAK,MAAM,YAAY,UACrB,KAAI;EAGF,MAAM,YAAY,iBADF,MAAM,qBADD,QAAQ,SAAS,CACkB,CACb;AAC3C,QAAM,KAAK,GAAG,UAAU;UACjB,OAAO;AACd,WAAS,OAAO,KACd,6BAA6B,SAAS,IAAI,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,GACjG;;AAIL,QAAO;;AAGT,SAAS,iBAAiB,SAA8C;CACtE,MAAM,QAAoB,EAAE;AAC5B,MAAK,MAAM,SAAS,OAAO,OAAO,QAAQ,CACxC,KAAI,WAAW,MAAM,CACnB,OAAM,KAAK,MAAM;AAGrB,QAAO;;AAGT,SAAS,WAAW,OAAmC;AACrD,QACE,OAAO,UAAU,YACjB,UAAU,QACV,MAAM,QAAS,MAAmB,UAAU,IAC5C,CAAC,CAAE,MAAmB,MAAM;;AAIhC,eAAe,aACb,YACgC;CAChC,MAAM,UAAW,MAAM,qBACrB,WACD;AAED,KAAI,mBAAmB,sBACrB,QAAO;AAET,KAAI,QAAQ,oBAAoB,sBAC9B,QAAO,QAAQ;CAGjB,MAAM,UACJ,OAAO,QAAQ,mBAAmB,aAC9B,QAAQ,iBACR,OAAO,QAAQ,YAAY,aACxB,QAAQ,UAGT;AAER,KAAI,SAAS;EACX,MAAM,SAAS,MAAM,SAAS;AAC9B,MAAI,kBAAkB,sBACpB,QAAO;;AAIX,OAAM,IAAI,MACR,mBAAmB,WAAW,oFAC/B"}

package/dist/services/test-link/index.d.mts

@@ -0,0 +1,18 @@
+import "./test-ref-validator.mjs";
+import "../integrity.mjs";
+import { SpecScanResult } from "@contractspec/module.workspace";
+
+//#region src/services/test-link/index.d.ts
+
+/**
+ * Test target extracted from a TestSpec.
+ * Matches the TestTarget type from @contractspec/lib.contracts.
+ */
+interface ExtractedTestTarget {
+  type: 'operation' | 'workflow';
+  key: string;
+  version?: string;
+}
+//#endregion
+export { ExtractedTestTarget };
+//# sourceMappingURL=index.d.mts.map

package/dist/services/test-link/index.d.mts.map

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

package/dist/services/test-link/index.mjs

@@ -0,0 +1,60 @@
+import { validateTestRefs } from "./test-ref-validator.mjs";
+
+//#region src/services/test-link/index.ts
+/**
+* Build a spec key from key and version.
+*/
+function makeSpecKey(key, version) {
+	return `${key}.v${version}`;
+}
+/**
+* Build the test-to-target index from test spec scan results.
+*
+* @param testSpecScans - Array of test spec scan results with testTarget info
+* @param inventory - The full spec inventory to validate targets against
+* @returns Bidirectional index for test-target relationships
+*/
+function buildTestIndex(testSpecScans, inventory) {
+	const targetToTests = /* @__PURE__ */ new Map();
+	const testToTarget = /* @__PURE__ */ new Map();
+	const orphanedTests = [];
+	const testsWithoutTarget = [];
+	for (const scan of testSpecScans) {
+		if (!scan.key || !scan.version) continue;
+		const testKey = makeSpecKey(scan.key, scan.version);
+		if (!scan.testTarget) {
+			testsWithoutTarget.push(testKey);
+			continue;
+		}
+		const { type, key, version } = scan.testTarget;
+		const targetKey = makeSpecKey(key, version ?? scan.version);
+		const targetMap = getTargetMap(inventory, type);
+		if (!targetMap || !targetMap.has(targetKey)) {
+			orphanedTests.push(testKey);
+			continue;
+		}
+		testToTarget.set(testKey, targetKey);
+		if (!targetToTests.has(targetKey)) targetToTests.set(targetKey, /* @__PURE__ */ new Set());
+		targetToTests.get(targetKey)?.add(testKey);
+	}
+	return {
+		targetToTests,
+		testToTarget,
+		orphanedTests,
+		testsWithoutTarget
+	};
+}
+/**
+* Get the inventory map for a target type.
+*/
+function getTargetMap(inventory, type) {
+	switch (type) {
+		case "operation": return inventory.operations;
+		case "workflow": return inventory.workflows;
+		default: return;
+	}
+}
+
+//#endregion
+export { buildTestIndex };
+//# sourceMappingURL=index.mjs.map

package/dist/services/test-link/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/services/test-link/index.ts"],"sourcesContent":["/**\n * Test-to-target index service.\n *\n * Builds bidirectional mappings between TestSpecs and their targets,\n * enabling contract-first test discovery instead of naming conventions.\n */\n\nimport type { SpecLocation, SpecInventory } from '../integrity';\nimport type { SpecScanResult } from '@contractspec/module.workspace';\n\n/**\n * Test target extracted from a TestSpec.\n * Matches the TestTarget type from @contractspec/lib.contracts.\n */\nexport interface ExtractedTestTarget {\n  type: 'operation' | 'workflow';\n  key: string;\n  version?: string;\n}\n\n/**\n * Extended spec scan result with test target information.\n */\nexport interface TestSpecScanResult extends SpecScanResult {\n  testTarget?: ExtractedTestTarget;\n}\n\n/**\n * Bidirectional index mapping between tests and their targets.\n */\nexport interface TestToTargetIndex {\n  /**\n   * Map from target spec key (e.g., \"my-op.v1.0.0\") to set of test spec keys.\n   * A single target can have multiple tests.\n   */\n  targetToTests: Map<string, Set<string>>;\n\n  /**\n   * Map from test spec key to target key.\n   * Each test targets exactly one spec.\n   */\n  testToTarget: Map<string, string>;\n\n  /**\n   * Tests with targets that don't exist in the inventory.\n   */\n  orphanedTests: string[];\n\n  /**\n   * Tests without a valid target field (legacy naming convention only).\n   */\n  testsWithoutTarget: string[];\n}\n\n/**\n * Build a spec key from key and version.\n */\nfunction makeSpecKey(key: string, version: string): string {\n  return `${key}.v${version}`;\n}\n\n/**\n * Build the test-to-target index from test spec scan results.\n *\n * @param testSpecScans - Array of test spec scan results with testTarget info\n * @param inventory - The full spec inventory to validate targets against\n * @returns Bidirectional index for test-target relationships\n */\nexport function buildTestIndex(\n  testSpecScans: TestSpecScanResult[],\n  inventory: SpecInventory\n): TestToTargetIndex {\n  const targetToTests = new Map<string, Set<string>>();\n  const testToTarget = new Map<string, string>();\n  const orphanedTests: string[] = [];\n  const testsWithoutTarget: string[] = [];\n\n  for (const scan of testSpecScans) {\n    if (!scan.key || !scan.version) continue;\n\n    const testKey = makeSpecKey(scan.key, scan.version);\n\n    if (!scan.testTarget) {\n      // Test doesn't have a target field - relies on naming convention\n      testsWithoutTarget.push(testKey);\n      continue;\n    }\n\n    const { type, key, version } = scan.testTarget;\n    const targetVersion = version ?? scan.version; // Default to test's version\n    const targetKey = makeSpecKey(key, targetVersion);\n\n    // Validate target exists in inventory\n    const targetMap = getTargetMap(inventory, type);\n    if (!targetMap || !targetMap.has(targetKey)) {\n      orphanedTests.push(testKey);\n      continue;\n    }\n\n    // Build bidirectional mapping\n    testToTarget.set(testKey, targetKey);\n\n    if (!targetToTests.has(targetKey)) {\n      targetToTests.set(targetKey, new Set());\n    }\n    targetToTests.get(targetKey)?.add(testKey);\n  }\n\n  return {\n    targetToTests,\n    testToTarget,\n    orphanedTests,\n    testsWithoutTarget,\n  };\n}\n\n/**\n * Get the inventory map for a target type.\n */\nfunction getTargetMap(\n  inventory: SpecInventory,\n  type: 'operation' | 'workflow'\n): Map<string, SpecLocation> | undefined {\n  switch (type) {\n    case 'operation':\n      return inventory.operations;\n    case 'workflow':\n      return inventory.workflows;\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Check if a spec has test coverage via target-based linking.\n *\n * @param specKey - The spec key (e.g., \"my-op.v1.0.0\")\n * @param index - The test-to-target index\n * @returns true if at least one TestSpec targets this spec\n */\nexport function hasTargetedTest(\n  specKey: string,\n  index: TestToTargetIndex\n): boolean {\n  return index.targetToTests.has(specKey);\n}\n\n/**\n * Get all tests that target a specific spec.\n *\n * @param specKey - The spec key (e.g., \"my-op.v1.0.0\")\n * @param index - The test-to-target index\n * @returns Array of test spec keys, empty if none\n */\nexport function getTestsForSpec(\n  specKey: string,\n  index: TestToTargetIndex\n): string[] {\n  const tests = index.targetToTests.get(specKey);\n  return tests ? Array.from(tests) : [];\n}\n\n/**\n * Get the target spec for a test.\n *\n * @param testKey - The test spec key\n * @param index - The test-to-target index\n * @returns The target spec key, or undefined if no target\n */\nexport function getTargetForTest(\n  testKey: string,\n  index: TestToTargetIndex\n): string | undefined {\n  return index.testToTarget.get(testKey);\n}\n\nexport { validateTestRefs } from './test-ref-validator';\nexport type {\n  TestRefValidationResult,\n  TestRefValidationOptions,\n} from './test-ref-validator';\n"],"mappings":";;;;;;AAyDA,SAAS,YAAY,KAAa,SAAyB;AACzD,QAAO,GAAG,IAAI,IAAI;;;;;;;;;AAUpB,SAAgB,eACd,eACA,WACmB;CACnB,MAAM,gCAAgB,IAAI,KAA0B;CACpD,MAAM,+BAAe,IAAI,KAAqB;CAC9C,MAAM,gBAA0B,EAAE;CAClC,MAAM,qBAA+B,EAAE;AAEvC,MAAK,MAAM,QAAQ,eAAe;AAChC,MAAI,CAAC,KAAK,OAAO,CAAC,KAAK,QAAS;EAEhC,MAAM,UAAU,YAAY,KAAK,KAAK,KAAK,QAAQ;AAEnD,MAAI,CAAC,KAAK,YAAY;AAEpB,sBAAmB,KAAK,QAAQ;AAChC;;EAGF,MAAM,EAAE,MAAM,KAAK,YAAY,KAAK;EAEpC,MAAM,YAAY,YAAY,KADR,WAAW,KAAK,QACW;EAGjD,MAAM,YAAY,aAAa,WAAW,KAAK;AAC/C,MAAI,CAAC,aAAa,CAAC,UAAU,IAAI,UAAU,EAAE;AAC3C,iBAAc,KAAK,QAAQ;AAC3B;;AAIF,eAAa,IAAI,SAAS,UAAU;AAEpC,MAAI,CAAC,cAAc,IAAI,UAAU,CAC/B,eAAc,IAAI,2BAAW,IAAI,KAAK,CAAC;AAEzC,gBAAc,IAAI,UAAU,EAAE,IAAI,QAAQ;;AAG5C,QAAO;EACL;EACA;EACA;EACA;EACD;;;;;AAMH,SAAS,aACP,WACA,MACuC;AACvC,SAAQ,MAAR;EACE,KAAK,YACH,QAAO,UAAU;EACnB,KAAK,WACH,QAAO,UAAU;EACnB,QACE"}

package/dist/services/test-link/test-ref-validator.d.mts

@@ -0,0 +1,2 @@
+import "../integrity.mjs";
+import { RefInfo } from "@contractspec/module.workspace";