@contractspec/bundle.workspace 0.0.0-canary-20260113162409

package/dist/services/validate/implementation-validator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"implementation-validator.mjs","names":[],"sources":["../../../src/services/validate/implementation-validator.ts"],"sourcesContent":["/**\n * Implementation validation service (handlers + tests).\n *\n * Deterministic, static checks intended for reuse across CLI/VSCode/web tooling.\n * This does NOT execute spec modules.\n */\n\nimport type { WorkspaceConfig } from '@contractspec/module.workspace';\nimport { scanSpecSource } from '@contractspec/module.workspace';\nimport type { FsAdapter } from '../../ports/fs';\n\nexport interface ValidateImplementationOptions {\n  checkHandlers?: boolean;\n  checkTests?: boolean;\n  /**\n   * Override workspace outputDir (defaults to config.outputDir).\n   */\n  outputDir?: string;\n}\n\nexport interface ValidateImplementationResult {\n  valid: boolean;\n  errors: string[];\n  warnings: string[];\n  expected: {\n    handlerPath?: string;\n    handlerTestPath?: string;\n    componentPath?: string;\n    componentTestPath?: string;\n    formPath?: string;\n    formTestPath?: string;\n  };\n}\n\nfunction toKebabCase(value: string): string {\n  return value\n    .replace(/\\./g, '-')\n    .replace(/([a-z])([A-Z])/g, '$1-$2')\n    .toLowerCase();\n}\n\nfunction toPascalCase(value: string): string {\n  return value\n    .split(/[-_.]/)\n    .filter(Boolean)\n    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))\n    .join('');\n}\n\nexport async function validateImplementationFiles(\n  specFile: string,\n  adapters: { fs: FsAdapter },\n  config: WorkspaceConfig,\n  options: ValidateImplementationOptions = {}\n): Promise<ValidateImplementationResult> {\n  const { fs } = adapters;\n  const errors: string[] = [];\n  const warnings: string[] = [];\n\n  const exists = await fs.exists(specFile);\n  if (!exists) {\n    return {\n      valid: false,\n      errors: [`Spec file not found: ${specFile}`],\n      warnings: [],\n      expected: {},\n    };\n  }\n\n  const code = await fs.readFile(specFile);\n  const scan = scanSpecSource(code, specFile);\n  const specName = scan.key ?? fs.basename(specFile).replace(/\\.[jt]s$/, '');\n  const outRoot = options.outputDir ?? config.outputDir ?? './src';\n  const kebab = toKebabCase(specName);\n\n  const expected: ValidateImplementationResult['expected'] = {};\n\n  if (scan.specType === 'operation') {\n    expected.handlerPath = fs.join(outRoot, 'handlers', `${kebab}.handler.ts`);\n    expected.handlerTestPath = fs.join(\n      outRoot,\n      'handlers',\n      `${kebab}.handler.test.ts`\n    );\n  }\n  if (scan.specType === 'presentation') {\n    expected.componentPath = fs.join(outRoot, 'components', `${kebab}.tsx`);\n    expected.componentTestPath = fs.join(\n      outRoot,\n      'components',\n      `${kebab}.test.tsx`\n    );\n  }\n  if (scan.specType === 'form') {\n    expected.formPath = fs.join(outRoot, 'forms', `${kebab}.form.tsx`);\n    expected.formTestPath = fs.join(outRoot, 'forms', `${kebab}.form.test.tsx`);\n  }\n\n  if (options.checkHandlers && expected.handlerPath) {\n    const handlerExists = await fs.exists(expected.handlerPath);\n    if (!handlerExists) {\n      errors.push(`Missing handler file: ${expected.handlerPath}`);\n    } else {\n      const handlerCode = await fs.readFile(expected.handlerPath);\n\n      const expectedSpecVar = `${toPascalCase(specName.split('.').pop() ?? specName)}Spec`;\n      const hasContractHandlerType = /ContractHandler<\\s*typeof\\s+\\w+\\s*>/.test(\n        handlerCode\n      );\n      const referencesExpectedSpec = new RegExp(\n        `typeof\\\\s+${expectedSpecVar}\\\\b`\n      ).test(handlerCode);\n      if (!hasContractHandlerType) {\n        warnings.push(\n          `Handler does not appear to type itself as ContractHandler<typeof Spec>: ${expected.handlerPath}`\n        );\n      } else if (!referencesExpectedSpec) {\n        warnings.push(\n          `Handler ContractHandler typing does not reference expected spec var (${expectedSpecVar}): ${expected.handlerPath}`\n        );\n      }\n    }\n  }\n\n  if (options.checkTests) {\n    const candidateTests = [\n      expected.handlerTestPath,\n      expected.componentTestPath,\n      expected.formTestPath,\n    ].filter((p): p is string => typeof p === 'string');\n\n    for (const testPath of candidateTests) {\n      const testExists = await fs.exists(testPath);\n      if (!testExists) {\n        errors.push(`Missing test file: ${testPath}`);\n      }\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    warnings,\n    expected,\n  };\n}\n"],"mappings":";;;AAkCA,SAAS,YAAY,OAAuB;AAC1C,QAAO,MACJ,QAAQ,OAAO,IAAI,CACnB,QAAQ,mBAAmB,QAAQ,CACnC,aAAa;;AAGlB,SAAS,aAAa,OAAuB;AAC3C,QAAO,MACJ,MAAM,QAAQ,CACd,OAAO,QAAQ,CACf,KAAK,SAAS,KAAK,OAAO,EAAE,CAAC,aAAa,GAAG,KAAK,MAAM,EAAE,CAAC,CAC3D,KAAK,GAAG;;AAGb,eAAsB,4BACpB,UACA,UACA,QACA,UAAyC,EAAE,EACJ;CACvC,MAAM,EAAE,OAAO;CACf,MAAM,SAAmB,EAAE;CAC3B,MAAM,WAAqB,EAAE;AAG7B,KAAI,CADW,MAAM,GAAG,OAAO,SAAS,CAEtC,QAAO;EACL,OAAO;EACP,QAAQ,CAAC,wBAAwB,WAAW;EAC5C,UAAU,EAAE;EACZ,UAAU,EAAE;EACb;CAIH,MAAM,OAAO,eADA,MAAM,GAAG,SAAS,SAAS,EACN,SAAS;CAC3C,MAAM,WAAW,KAAK,OAAO,GAAG,SAAS,SAAS,CAAC,QAAQ,YAAY,GAAG;CAC1E,MAAM,UAAU,QAAQ,aAAa,OAAO,aAAa;CACzD,MAAM,QAAQ,YAAY,SAAS;CAEnC,MAAM,WAAqD,EAAE;AAE7D,KAAI,KAAK,aAAa,aAAa;AACjC,WAAS,cAAc,GAAG,KAAK,SAAS,YAAY,GAAG,MAAM,aAAa;AAC1E,WAAS,kBAAkB,GAAG,KAC5B,SACA,YACA,GAAG,MAAM,kBACV;;AAEH,KAAI,KAAK,aAAa,gBAAgB;AACpC,WAAS,gBAAgB,GAAG,KAAK,SAAS,cAAc,GAAG,MAAM,MAAM;AACvE,WAAS,oBAAoB,GAAG,KAC9B,SACA,cACA,GAAG,MAAM,WACV;;AAEH,KAAI,KAAK,aAAa,QAAQ;AAC5B,WAAS,WAAW,GAAG,KAAK,SAAS,SAAS,GAAG,MAAM,WAAW;AAClE,WAAS,eAAe,GAAG,KAAK,SAAS,SAAS,GAAG,MAAM,gBAAgB;;AAG7E,KAAI,QAAQ,iBAAiB,SAAS,YAEpC,KAAI,CADkB,MAAM,GAAG,OAAO,SAAS,YAAY,CAEzD,QAAO,KAAK,yBAAyB,SAAS,cAAc;MACvD;EACL,MAAM,cAAc,MAAM,GAAG,SAAS,SAAS,YAAY;EAE3D,MAAM,kBAAkB,GAAG,aAAa,SAAS,MAAM,IAAI,CAAC,KAAK,IAAI,SAAS,CAAC;EAC/E,MAAM,yBAAyB,sCAAsC,KACnE,YACD;EACD,MAAM,0CAAyB,IAAI,OACjC,aAAa,gBAAgB,KAC9B,EAAC,KAAK,YAAY;AACnB,MAAI,CAAC,uBACH,UAAS,KACP,2EAA2E,SAAS,cACrF;WACQ,CAAC,uBACV,UAAS,KACP,wEAAwE,gBAAgB,KAAK,SAAS,cACvG;;AAKP,KAAI,QAAQ,YAAY;EACtB,MAAM,iBAAiB;GACrB,SAAS;GACT,SAAS;GACT,SAAS;GACV,CAAC,QAAQ,MAAmB,OAAO,MAAM,SAAS;AAEnD,OAAK,MAAM,YAAY,eAErB,KAAI,CADe,MAAM,GAAG,OAAO,SAAS,CAE1C,QAAO,KAAK,sBAAsB,WAAW;;AAKnD,QAAO;EACL,OAAO,OAAO,WAAW;EACzB;EACA;EACA;EACD"}

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

@@ -0,0 +1,5 @@
+import { ValidateSpecOptions, ValidateSpecResult, validateSpec, validateSpecs } from "./spec-validator.mjs";
+import { ValidateImplementationOptions, ValidateImplementationResult, validateImplementationFiles } from "./implementation-validator.mjs";
+import { BlueprintValidationResult, validateBlueprint } from "./blueprint-validator.mjs";
+import { TenantValidationContext, TenantValidationResult, validateTenantConfig } from "./tenant-validator.mjs";
+import { ImplementationValidationResult, ImplementationValidatorOptions, validateImplementationWithAgent } from "./implementation-agent-validator.mjs";

package/dist/services/validate/index.mjs

@@ -0,0 +1,7 @@
+import { validateSpec, validateSpecs } from "./spec-validator.mjs";
+import { validateImplementationFiles } from "./implementation-validator.mjs";
+import { validateBlueprint } from "./blueprint-validator.mjs";
+import { validateTenantConfig } from "./tenant-validator.mjs";
+import { validateImplementationWithAgent } from "./implementation-agent-validator.mjs";
+
+export {  };

package/dist/services/validate/spec-validator.d.mts

@@ -0,0 +1,42 @@
+import { FsAdapter } from "../../ports/fs.mjs";
+import { LoggerAdapter } from "../../ports/logger.mjs";
+import { ValidationResult } from "@contractspec/module.workspace";
+
+//#region src/services/validate/spec-validator.d.ts
+
+/**
+ * Options for spec validation.
+ */
+interface ValidateSpecOptions {
+  /**
+   * Skip spec structure validation (e.g., for blueprint files).
+   */
+  skipStructure?: boolean;
+}
+/**
+ * Result of spec validation.
+ */
+interface ValidateSpecResult {
+  valid: boolean;
+  structureResult?: ValidationResult;
+  errors: string[];
+  warnings: string[];
+  code?: string;
+}
+/**
+ * Validate a spec file.
+ */
+declare function validateSpec(specFile: string, adapters: {
+  fs: FsAdapter;
+  logger: LoggerAdapter;
+}, options?: ValidateSpecOptions): Promise<ValidateSpecResult>;
+/**
+ * Validate multiple spec files.
+ */
+declare function validateSpecs(specFiles: string[], adapters: {
+  fs: FsAdapter;
+  logger: LoggerAdapter;
+}, options?: ValidateSpecOptions): Promise<Map<string, ValidateSpecResult>>;
+//#endregion
+export { ValidateSpecOptions, ValidateSpecResult, validateSpec, validateSpecs };
+//# sourceMappingURL=spec-validator.d.mts.map

package/dist/services/validate/spec-validator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-validator.d.mts","names":[],"sources":["../../../src/services/validate/spec-validator.ts"],"sourcesContent":[],"mappings":";;;;;;AAwBA;AAWA;;AAEqC,UAvBpB,mBAAA,CAuBoB;EAC1B;;;EACD,aAAA,CAAA,EAAA,OAAA;AAqCV;;;;AAIuB,UAxDN,kBAAA,CAwDM;EAAZ,KAAA,EAAA,OAAA;EAAR,eAAA,CAAA,EAtDiB,gBAsDjB;EAAO,MAAA,EAAA,MAAA,EAAA;;;;;;;iBA7CY,YAAA;MAEJ;UAAmB;aAC1B,sBACR,QAAQ;;;;iBAqCW,aAAA;MAEJ;UAAmB;aAC1B,sBACR,QAAQ,YAAY"}

package/dist/services/validate/spec-validator.mjs

@@ -0,0 +1,49 @@
+import { validateSpecStructure } from "@contractspec/module.workspace";
+
+//#region src/services/validate/spec-validator.ts
+/**
+* Validation service.
+*/
+/**
+* Validate a spec file.
+*/
+async function validateSpec(specFile, adapters, options = {}) {
+	const { fs } = adapters;
+	if (!await fs.exists(specFile)) return {
+		valid: false,
+		errors: [`Spec file not found: ${specFile}`],
+		warnings: [],
+		code: void 0
+	};
+	const specCode = await fs.readFile(specFile);
+	const allErrors = [];
+	const allWarnings = [];
+	let structureResult;
+	if (!options.skipStructure) {
+		structureResult = validateSpecStructure(specCode, specFile);
+		allErrors.push(...structureResult.errors);
+		allWarnings.push(...structureResult.warnings);
+	}
+	return {
+		valid: allErrors.length === 0,
+		structureResult,
+		errors: allErrors,
+		warnings: allWarnings,
+		code: specCode
+	};
+}
+/**
+* Validate multiple spec files.
+*/
+async function validateSpecs(specFiles, adapters, options = {}) {
+	const results = /* @__PURE__ */ new Map();
+	for (const specFile of specFiles) {
+		const result = await validateSpec(specFile, adapters, options);
+		results.set(specFile, result);
+	}
+	return results;
+}
+
+//#endregion
+export { validateSpec, validateSpecs };
+//# sourceMappingURL=spec-validator.mjs.map

package/dist/services/validate/spec-validator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-validator.mjs","names":[],"sources":["../../../src/services/validate/spec-validator.ts"],"sourcesContent":["/**\n * Validation service.\n */\n\nimport {\n  validateSpecStructure,\n  type ValidationResult,\n} from '@contractspec/module.workspace';\nimport type { FsAdapter } from '../../ports/fs';\nimport type { LoggerAdapter } from '../../ports/logger';\n\n/**\n * Options for spec validation.\n */\nexport interface ValidateSpecOptions {\n  /**\n   * Skip spec structure validation (e.g., for blueprint files).\n   */\n  skipStructure?: boolean;\n}\n\n/**\n * Result of spec validation.\n */\nexport interface ValidateSpecResult {\n  valid: boolean;\n  structureResult?: ValidationResult;\n  errors: string[];\n  warnings: string[];\n  code?: string;\n}\n\n/**\n * Validate a spec file.\n */\nexport async function validateSpec(\n  specFile: string,\n  adapters: { fs: FsAdapter; logger: LoggerAdapter },\n  options: ValidateSpecOptions = {}\n): Promise<ValidateSpecResult> {\n  const { fs } = adapters;\n\n  const exists = await fs.exists(specFile);\n  if (!exists) {\n    return {\n      valid: false,\n      errors: [`Spec file not found: ${specFile}`],\n      warnings: [],\n      code: undefined,\n    };\n  }\n\n  const specCode = await fs.readFile(specFile);\n\n  const allErrors: string[] = [];\n  const allWarnings: string[] = [];\n  let structureResult: ValidationResult | undefined;\n\n  if (!options.skipStructure) {\n    structureResult = validateSpecStructure(specCode, specFile);\n    allErrors.push(...structureResult.errors);\n    allWarnings.push(...structureResult.warnings);\n  }\n\n  return {\n    valid: allErrors.length === 0,\n    structureResult,\n    errors: allErrors,\n    warnings: allWarnings,\n    code: specCode,\n  };\n}\n\n/**\n * Validate multiple spec files.\n */\nexport async function validateSpecs(\n  specFiles: string[],\n  adapters: { fs: FsAdapter; logger: LoggerAdapter },\n  options: ValidateSpecOptions = {}\n): Promise<Map<string, ValidateSpecResult>> {\n  const results = new Map<string, ValidateSpecResult>();\n\n  for (const specFile of specFiles) {\n    const result = await validateSpec(specFile, adapters, options);\n    results.set(specFile, result);\n  }\n\n  return results;\n}\n"],"mappings":";;;;;;;;;AAmCA,eAAsB,aACpB,UACA,UACA,UAA+B,EAAE,EACJ;CAC7B,MAAM,EAAE,OAAO;AAGf,KAAI,CADW,MAAM,GAAG,OAAO,SAAS,CAEtC,QAAO;EACL,OAAO;EACP,QAAQ,CAAC,wBAAwB,WAAW;EAC5C,UAAU,EAAE;EACZ,MAAM;EACP;CAGH,MAAM,WAAW,MAAM,GAAG,SAAS,SAAS;CAE5C,MAAM,YAAsB,EAAE;CAC9B,MAAM,cAAwB,EAAE;CAChC,IAAI;AAEJ,KAAI,CAAC,QAAQ,eAAe;AAC1B,oBAAkB,sBAAsB,UAAU,SAAS;AAC3D,YAAU,KAAK,GAAG,gBAAgB,OAAO;AACzC,cAAY,KAAK,GAAG,gBAAgB,SAAS;;AAG/C,QAAO;EACL,OAAO,UAAU,WAAW;EAC5B;EACA,QAAQ;EACR,UAAU;EACV,MAAM;EACP;;;;;AAMH,eAAsB,cACpB,WACA,UACA,UAA+B,EAAE,EACS;CAC1C,MAAM,0BAAU,IAAI,KAAiC;AAErD,MAAK,MAAM,YAAY,WAAW;EAChC,MAAM,SAAS,MAAM,aAAa,UAAU,UAAU,QAAQ;AAC9D,UAAQ,IAAI,UAAU,OAAO;;AAG/B,QAAO"}

package/dist/services/validate/tenant-validator.d.mts

@@ -0,0 +1,21 @@
+import { FsAdapter } from "../../ports/fs.mjs";
+import { AppBlueprintSpec, TenantAppConfig, validateConfig } from "@contractspec/lib.contracts";
+
+//#region src/services/validate/tenant-validator.d.ts
+interface TenantValidationResult {
+  config?: TenantAppConfig;
+  report?: ReturnType<typeof validateConfig>;
+  valid: boolean;
+  errors: string[];
+}
+interface TenantValidationContext {
+  connections?: string[] | string;
+  integrationRegistrars?: string[] | string;
+  translationCatalog?: string;
+}
+declare function validateTenantConfig(blueprint: AppBlueprintSpec, tenantPath: string, contextOptions: TenantValidationContext, adapters: {
+  fs: FsAdapter;
+}): Promise<TenantValidationResult>;
+//#endregion
+export { TenantValidationContext, TenantValidationResult, validateTenantConfig };
+//# sourceMappingURL=tenant-validator.d.mts.map

package/dist/services/validate/tenant-validator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-validator.d.mts","names":[],"sources":["../../../src/services/validate/tenant-validator.ts"],"sourcesContent":[],"mappings":";;;;UAaiB,sBAAA;WACN;EADM,MAAA,CAAA,EAEN,UAFM,CAAA,OAEY,cAFU,CAAA;EAC5B,KAAA,EAAA,OAAA;EACkB,MAAA,EAAA,MAAA,EAAA;;AAAR,UAKJ,uBAAA,CALI;EAKJ,WAAA,CAAA,EAAA,MAAA,EAAA,GAAA,MAAuB;EAMlB,qBAAA,CAAA,EAAoB,MAAA,EAAA,GAAA,MAAA;EAC7B,kBAAA,CAAA,EAAA,MAAA;;AAGK,iBAJI,oBAAA,CAIJ,SAAA,EAHL,gBAGK,EAAA,UAAA,EAAA,MAAA,EAAA,cAAA,EADA,uBACA,EAAA,QAAA,EAAA;EACP,EAAA,EADO,SACP;CAAR,CAAA,EAAA,OAAA,CAAQ,sBAAR,CAAA"}

package/dist/services/validate/tenant-validator.mjs

@@ -0,0 +1,165 @@
+import { resolve } from "path";
+import { pathToFileURL } from "url";
+import { validateConfig } from "@contractspec/lib.contracts";
+import { readFile } from "fs/promises";
+
+//#region src/services/validate/tenant-validator.ts
+async function validateTenantConfig(blueprint, tenantPath, contextOptions, adapters) {
+	const { fs } = adapters;
+	const resolvedPath = resolve(process.cwd(), tenantPath);
+	if (!await fs.exists(resolvedPath)) return {
+		valid: false,
+		errors: [`Tenant config file not found: ${resolvedPath}`]
+	};
+	try {
+		const tenant = await loadTenantConfig(resolvedPath);
+		const connections = await loadIntegrationConnections(contextOptions.connections, fs);
+		const catalog = await loadTranslationCatalog(contextOptions.translationCatalog, fs);
+		const integrationSpecs = await loadIntegrationRegistrars(contextOptions.integrationRegistrars);
+		const context = {};
+		if (connections.length > 0) context.tenantConnections = connections;
+		if (catalog) context.translationCatalogs = {
+			blueprint: [catalog],
+			platform: []
+		};
+		if (integrationSpecs) context.integrationSpecs = integrationSpecs;
+		const report = validateConfig(blueprint, tenant, context);
+		return {
+			config: tenant,
+			report,
+			valid: report.valid,
+			errors: report.errors.map((e) => `[${e.code}] ${e.path}: ${e.message}`)
+		};
+	} catch (error) {
+		return {
+			valid: false,
+			errors: [error instanceof Error ? error.message : String(error)]
+		};
+	}
+}
+async function loadTenantConfig(tenantPath) {
+	if (tenantPath.endsWith(".json")) {
+		const raw = await readFile(tenantPath, "utf-8");
+		const json = JSON.parse(raw);
+		if (!isTenantConfig(json)) throw new Error("Tenant config JSON does not match the expected structure (missing meta).");
+		return json;
+	}
+	const mod = await loadModule(tenantPath);
+	const candidates = Object.values(mod).filter(isTenantConfig);
+	if (candidates.length === 0) throw new Error("Tenant config module does not export a TenantAppConfig.");
+	return candidates[0];
+}
+function isTenantConfig(value) {
+	return typeof value === "object" && value !== null && "meta" in value && typeof value.meta?.tenantId === "string";
+}
+async function loadModule(modulePath) {
+	try {
+		return await import(pathToFileURL(modulePath).href);
+	} catch (error) {
+		throw new Error(`Failed to load module at ${modulePath}: ${error}`);
+	}
+}
+function normalizePathOption(value) {
+	if (!value) return [];
+	return (Array.isArray(value) ? value : value.split(",")).map((entry) => entry.trim()).filter(Boolean);
+}
+async function loadIntegrationConnections(value, fs) {
+	const paths = normalizePathOption(value);
+	if (!paths.length) return [];
+	const results = [];
+	for (const path$1 of paths) {
+		const resolved = resolve(process.cwd(), path$1);
+		if (!await fs.exists(resolved)) {
+			console.warn(`Warning: Connection file not found: ${resolved}`);
+			continue;
+		}
+		if (resolved.endsWith(".json")) {
+			const raw = await readFile(resolved, "utf-8");
+			const parsed = JSON.parse(raw);
+			results.push(...collectConnections(parsed));
+			continue;
+		}
+		const mod = await loadModule(resolved);
+		results.push(...collectConnections(mod));
+	}
+	return results;
+}
+function collectConnections(value) {
+	if (Array.isArray(value)) {
+		const connections = value.filter(isIntegrationConnection);
+		if (connections.length) return connections;
+	}
+	if (isIntegrationConnection(value)) return [value];
+	if (value && typeof value === "object") {
+		const collected = Object.values(value).flatMap((entry) => collectConnections(entry));
+		if (collected.length) return collected;
+	}
+	return [];
+}
+function isIntegrationConnection(value) {
+	return typeof value === "object" && value !== null && "meta" in value && typeof value.meta?.id === "string" && typeof value.secretRef === "string";
+}
+async function loadTranslationCatalog(path$1, fs) {
+	if (!path$1) return void 0;
+	const resolved = resolve(process.cwd(), path$1);
+	if (!await fs.exists(resolved)) return void 0;
+	if (resolved.endsWith(".json")) {
+		const raw = await readFile(resolved, "utf-8");
+		const parsed = JSON.parse(raw);
+		if (isBlueprintTranslationCatalog(parsed)) return normaliseTranslationCatalog(parsed);
+		return;
+	}
+	const mod = await loadModule(resolved);
+	const catalogs = Object.values(mod).filter(isBlueprintTranslationCatalog);
+	if (catalogs.length === 0) return void 0;
+	return normaliseTranslationCatalog(catalogs[0]);
+}
+function isBlueprintTranslationCatalog(value) {
+	return typeof value === "object" && value !== null && "meta" in value && typeof value.meta?.key === "string" && typeof value.meta?.version === "string" && Array.isArray(value.entries);
+}
+function normaliseTranslationCatalog(catalog) {
+	const supportedLocales = catalog.supportedLocales && catalog.supportedLocales.length > 0 ? catalog.supportedLocales : [catalog.defaultLocale];
+	return {
+		...catalog,
+		supportedLocales
+	};
+}
+async function loadIntegrationRegistrars(value) {
+	const entries = normalizePathOption(value);
+	if (!entries.length) return void 0;
+	const { IntegrationSpecRegistry } = await import("@contractspec/lib.contracts");
+	const registry = new IntegrationSpecRegistry();
+	for (const entry of entries) {
+		const { modulePath, exportName } = parseRegistrarEntry(entry);
+		if (!modulePath) continue;
+		const resolved = resolve(process.cwd(), modulePath);
+		try {
+			const registrar = pickRegistrar(await loadModule(resolved), exportName);
+			if (registrar) await registrar(registry);
+		} catch (e) {
+			console.warn(`Failed to load registrar from ${resolved}: ${e}`);
+		}
+	}
+	return registry;
+}
+function parseRegistrarEntry(entry) {
+	if (!entry) return { modulePath: null };
+	const [modulePathRaw, exportNameRaw] = entry.split("#");
+	return {
+		modulePath: modulePathRaw?.trim() ?? null,
+		exportName: exportNameRaw?.trim()
+	};
+}
+function pickRegistrar(mod, exportName) {
+	if (exportName) {
+		const candidate = mod[exportName];
+		if (typeof candidate === "function") return candidate;
+		return;
+	}
+	if (typeof mod.default === "function") return mod.default;
+	for (const value of Object.values(mod)) if (typeof value === "function") return value;
+}
+
+//#endregion
+export { validateTenantConfig };
+//# sourceMappingURL=tenant-validator.mjs.map

package/dist/services/validate/tenant-validator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-validator.mjs","names":["validateTenantConfigSpecs","path"],"sources":["../../../src/services/validate/tenant-validator.ts"],"sourcesContent":["import { resolve } from 'path';\nimport { readFile } from 'fs/promises';\nimport { pathToFileURL } from 'url';\nimport {\n  validateConfig as validateTenantConfigSpecs,\n  type AppBlueprintSpec,\n  type TenantAppConfig,\n  type IntegrationSpecRegistry,\n  type BlueprintTranslationCatalog,\n  type IntegrationConnection,\n} from '@contractspec/lib.contracts';\nimport type { FsAdapter } from '../../ports/fs';\n\nexport interface TenantValidationResult {\n  config?: TenantAppConfig;\n  report?: ReturnType<typeof validateTenantConfigSpecs>;\n  valid: boolean;\n  errors: string[];\n}\n\nexport interface TenantValidationContext {\n  connections?: string[] | string;\n  integrationRegistrars?: string[] | string;\n  translationCatalog?: string;\n}\n\nexport async function validateTenantConfig(\n  blueprint: AppBlueprintSpec,\n  tenantPath: string,\n  contextOptions: TenantValidationContext,\n  adapters: { fs: FsAdapter }\n): Promise<TenantValidationResult> {\n  const { fs } = adapters;\n  const resolvedPath = resolve(process.cwd(), tenantPath);\n\n  if (!(await fs.exists(resolvedPath))) {\n    return {\n      valid: false,\n      errors: [`Tenant config file not found: ${resolvedPath}`],\n    };\n  }\n\n  try {\n    const tenant = await loadTenantConfig(resolvedPath);\n    const connections = await loadIntegrationConnections(\n      contextOptions.connections,\n      fs\n    );\n    const catalog = await loadTranslationCatalog(\n      contextOptions.translationCatalog,\n      fs\n    );\n    const integrationSpecs = await loadIntegrationRegistrars(\n      contextOptions.integrationRegistrars\n    );\n\n    const context: Parameters<typeof validateTenantConfigSpecs>[2] = {};\n    if (connections.length > 0) {\n      context.tenantConnections = connections;\n    }\n    if (catalog) {\n      context.translationCatalogs = {\n        blueprint: [catalog],\n        platform: [],\n      };\n    }\n    if (integrationSpecs) {\n      context.integrationSpecs = integrationSpecs;\n    }\n\n    const report = validateTenantConfigSpecs(blueprint, tenant, context);\n\n    return {\n      config: tenant,\n      report,\n      valid: report.valid,\n      errors: report.errors.map((e) => `[${e.code}] ${e.path}: ${e.message}`),\n    };\n  } catch (error) {\n    return {\n      valid: false,\n      errors: [error instanceof Error ? error.message : String(error)],\n    };\n  }\n}\n\n// Helpers\n\nasync function loadTenantConfig(tenantPath: string): Promise<TenantAppConfig> {\n  if (tenantPath.endsWith('.json')) {\n    const raw = await readFile(tenantPath, 'utf-8');\n    const json = JSON.parse(raw);\n    if (!isTenantConfig(json)) {\n      throw new Error(\n        'Tenant config JSON does not match the expected structure (missing meta).'\n      );\n    }\n    return json;\n  }\n\n  const mod = await loadModule(tenantPath);\n  const candidates = Object.values(mod).filter(isTenantConfig);\n  if (candidates.length === 0) {\n    throw new Error('Tenant config module does not export a TenantAppConfig.');\n  }\n  return candidates[0] as TenantAppConfig;\n}\n\nfunction isTenantConfig(value: unknown): value is TenantAppConfig {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'meta' in value &&\n    typeof (value as TenantAppConfig).meta?.tenantId === 'string'\n  );\n}\n\n// Basic module loader\nasync function loadModule(\n  modulePath: string\n): Promise<Record<string, unknown>> {\n  try {\n    const url = pathToFileURL(modulePath).href;\n    const mod = await import(url);\n    return mod;\n  } catch (error) {\n    throw new Error(`Failed to load module at ${modulePath}: ${error}`);\n  }\n}\n\n// --- Connection Loaders ---\n\nfunction normalizePathOption(value?: string | string[]): string[] {\n  if (!value) return [];\n  const values = Array.isArray(value) ? value : value.split(',');\n  return values.map((entry) => entry.trim()).filter(Boolean);\n}\n\nasync function loadIntegrationConnections(\n  value: string | string[] | undefined,\n  fs: FsAdapter\n): Promise<IntegrationConnection[]> {\n  const paths = normalizePathOption(value);\n  if (!paths.length) return [];\n\n  const results: IntegrationConnection[] = [];\n  for (const path of paths) {\n    const resolved = resolve(process.cwd(), path);\n    if (!(await fs.exists(resolved))) {\n      console.warn(`Warning: Connection file not found: ${resolved}`);\n      continue;\n    }\n\n    if (resolved.endsWith('.json')) {\n      const raw = await readFile(resolved, 'utf-8');\n      const parsed = JSON.parse(raw);\n      results.push(...collectConnections(parsed));\n      continue;\n    }\n\n    const mod = await loadModule(resolved);\n    results.push(...collectConnections(mod));\n  }\n  return results;\n}\n\nfunction collectConnections(value: unknown): IntegrationConnection[] {\n  if (Array.isArray(value)) {\n    const connections = value.filter(isIntegrationConnection);\n    if (connections.length) return connections;\n  }\n  if (isIntegrationConnection(value)) {\n    return [value];\n  }\n  if (value && typeof value === 'object') {\n    const entries = Object.values(value as Record<string, unknown>);\n    const collected = entries.flatMap((entry) => collectConnections(entry));\n    if (collected.length) return collected;\n  }\n  return [];\n}\n\nfunction isIntegrationConnection(\n  value: unknown\n): value is IntegrationConnection {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'meta' in value &&\n    typeof (value as IntegrationConnection).meta?.id === 'string' &&\n    typeof (value as IntegrationConnection).secretRef === 'string'\n  );\n}\n\n// --- Translation Catalog Loaders ---\n\nasync function loadTranslationCatalog(\n  path: string | undefined,\n  fs: FsAdapter\n): Promise<BlueprintTranslationCatalog | undefined> {\n  if (!path) return undefined;\n  const resolved = resolve(process.cwd(), path);\n  if (!(await fs.exists(resolved))) return undefined;\n\n  if (resolved.endsWith('.json')) {\n    const raw = await readFile(resolved, 'utf-8');\n    const parsed = JSON.parse(raw);\n    if (isBlueprintTranslationCatalog(parsed)) {\n      return normaliseTranslationCatalog(parsed);\n    }\n    return undefined;\n  }\n\n  const mod = await loadModule(resolved);\n  const catalogs = Object.values(mod).filter(isBlueprintTranslationCatalog);\n  if (catalogs.length === 0) return undefined;\n  return normaliseTranslationCatalog(\n    catalogs[0] as BlueprintTranslationCatalog\n  );\n}\n\nfunction isBlueprintTranslationCatalog(\n  value: unknown\n): value is BlueprintTranslationCatalog {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'meta' in value &&\n    typeof (value as BlueprintTranslationCatalog).meta?.key === 'string' &&\n    typeof (value as BlueprintTranslationCatalog).meta?.version === 'string' &&\n    Array.isArray((value as BlueprintTranslationCatalog).entries)\n  );\n}\n\nfunction normaliseTranslationCatalog(\n  catalog: BlueprintTranslationCatalog\n): BlueprintTranslationCatalog {\n  const supportedLocales =\n    catalog.supportedLocales && catalog.supportedLocales.length > 0\n      ? catalog.supportedLocales\n      : [catalog.defaultLocale];\n  return {\n    ...catalog,\n    supportedLocales,\n  };\n}\n\n// --- Registrar Loaders ---\n// Important: This needs IntegrationSpecRegistry which is a Class.\n// We only import type in signature, but need constructor.\n// Imports fixed at top.\n\nasync function loadIntegrationRegistrars(\n  value?: string | string[]\n): Promise<IntegrationSpecRegistry | undefined> {\n  const entries = normalizePathOption(value);\n  if (!entries.length) return undefined;\n\n  // We need to import the Class dynamically or have it available.\n  // It is imported from @contractspec/lib.contracts\n  const { IntegrationSpecRegistry } =\n    await import('@contractspec/lib.contracts');\n  const registry = new IntegrationSpecRegistry();\n\n  for (const entry of entries) {\n    const { modulePath, exportName } = parseRegistrarEntry(entry);\n    if (!modulePath) continue;\n    const resolved = resolve(process.cwd(), modulePath);\n    // Logic simplified for brevity, assume module exists or handled by catch in loadModule\n    try {\n      const mod = await loadModule(resolved);\n      const registrar = pickRegistrar(mod, exportName);\n      if (registrar) {\n        await registrar(registry);\n      }\n    } catch (e) {\n      console.warn(`Failed to load registrar from ${resolved}: ${e}`);\n    }\n  }\n  return registry;\n}\n\nfunction parseRegistrarEntry(entry: string): {\n  modulePath: string | null;\n  exportName?: string;\n} {\n  if (!entry) return { modulePath: null };\n  const [modulePathRaw, exportNameRaw] = entry.split('#');\n  const modulePath = modulePathRaw?.trim() ?? null;\n  const exportName = exportNameRaw?.trim();\n  return { modulePath, exportName };\n}\n\nfunction pickRegistrar(\n  mod: Record<string, unknown>,\n  exportName?: string\n): ((registry: IntegrationSpecRegistry) => void | Promise<void>) | undefined {\n  if (exportName) {\n    const candidate = mod[exportName];\n    if (typeof candidate === 'function') {\n      return candidate as (\n        registry: IntegrationSpecRegistry\n      ) => void | Promise<void>;\n    }\n    return undefined;\n  }\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  if (typeof (mod as any).default === 'function') {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return (mod as any).default;\n  }\n  for (const value of Object.values(mod)) {\n    if (typeof value === 'function') {\n      return value as (\n        registry: IntegrationSpecRegistry\n      ) => void | Promise<void>;\n    }\n  }\n  return undefined;\n}\n"],"mappings":"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"}

package/dist/services/verification-cache/adapters/filesystem.d.mts

@@ -0,0 +1,46 @@
+import { CacheKeyString, CacheStorageAdapter, VerificationCacheEntry } from "../types.mjs";
+
+//#region src/services/verification-cache/adapters/filesystem.d.ts
+
+/**
+ * Filesystem storage adapter.
+ */
+declare class FileSystemCacheStorage implements CacheStorageAdapter {
+  private filePath;
+  private cache;
+  private isDirty;
+  constructor(filePath?: string, workspaceRoot?: string);
+  /**
+   * Load cache from disk synchronously.
+   */
+  private loadSync;
+  /**
+   * Save cache to disk.
+   */
+  private saveSync;
+  get(key: CacheKeyString): Promise<VerificationCacheEntry | null>;
+  set(key: CacheKeyString, entry: VerificationCacheEntry): Promise<void>;
+  delete(key: CacheKeyString): Promise<boolean>;
+  has(key: CacheKeyString): Promise<boolean>;
+  keys(): Promise<CacheKeyString[]>;
+  clear(): Promise<void>;
+  stats(): Promise<{
+    entryCount: number;
+    memoryUsage?: number;
+  }>;
+  /**
+   * Force save any pending changes.
+   */
+  flush(): void;
+  /**
+   * Reload cache from disk.
+   */
+  reload(): void;
+}
+/**
+ * Create a filesystem cache storage adapter.
+ */
+declare function createFileSystemCacheStorage(filePath?: string, workspaceRoot?: string): FileSystemCacheStorage;
+//#endregion
+export { FileSystemCacheStorage, createFileSystemCacheStorage };
+//# sourceMappingURL=filesystem.d.mts.map

package/dist/services/verification-cache/adapters/filesystem.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.mts","names":[],"sources":["../../../../src/services/verification-cache/adapters/filesystem.ts"],"sourcesContent":[],"mappings":";;;;;;;AAwHoB,cAhFP,sBAAA,YAAkC,mBAgF3B,CAAA;EAAiB,QAAA,QAAA;EASpB,QAAA,KAAA;EAAiB,QAAA,OAAA;EAIV,WAAA,CAAA,QAAA,CAAA,EAAA,MAAA,EAAA,aAAA,CAAA,EAAA,MAAA;EAAR;;;EA7F+B,QAAA,QAAA;EAAmB;AA4IlE;;;WAtEiB,iBAAiB,QAAQ;WAIzB,uBAAuB,yBAAyB;cAM7C,iBAAiB;WASpB,iBAAiB;UAIlB,QAAQ;WAIP;WAMA;;;;;;;;;;;;;;;;iBAqCD,4BAAA,6CAGb"}

package/dist/services/verification-cache/adapters/filesystem.mjs

@@ -0,0 +1,120 @@
+import { dirname, join } from "path";
+import { existsSync, mkdirSync, readFileSync, renameSync, statSync, writeFileSync } from "fs";
+
+//#region src/services/verification-cache/adapters/filesystem.ts
+/**
+* Filesystem cache storage adapter.
+*
+* Stores cache entries in a JSON file for CLI and CI environments.
+* Uses atomic writes to prevent corruption.
+*/
+/**
+* Default cache file location.
+*/
+const DEFAULT_CACHE_FILE = ".contractspec/verification-cache.json";
+const CURRENT_VERSION = 1;
+/**
+* Filesystem storage adapter.
+*/
+var FileSystemCacheStorage = class {
+	filePath;
+	cache;
+	isDirty = false;
+	constructor(filePath, workspaceRoot) {
+		const root = workspaceRoot ?? process.cwd();
+		this.filePath = filePath ?? join(root, DEFAULT_CACHE_FILE);
+		this.cache = /* @__PURE__ */ new Map();
+		this.loadSync();
+	}
+	/**
+	* Load cache from disk synchronously.
+	*/
+	loadSync() {
+		try {
+			if (!existsSync(this.filePath)) return;
+			const content = readFileSync(this.filePath, "utf-8");
+			const data = JSON.parse(content);
+			if (data.version !== CURRENT_VERSION) return;
+			for (const [key, entry] of Object.entries(data.entries)) this.cache.set(key, entry);
+		} catch {}
+	}
+	/**
+	* Save cache to disk.
+	*/
+	saveSync() {
+		if (!this.isDirty) return;
+		try {
+			const dir = dirname(this.filePath);
+			if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+			const data = {
+				version: CURRENT_VERSION,
+				entries: Object.fromEntries(this.cache.entries())
+			};
+			const tempPath = `${this.filePath}.tmp`;
+			writeFileSync(tempPath, JSON.stringify(data, null, 2), "utf-8");
+			renameSync(tempPath, this.filePath);
+			this.isDirty = false;
+		} catch {}
+	}
+	async get(key) {
+		return this.cache.get(key) ?? null;
+	}
+	async set(key, entry) {
+		this.cache.set(key, entry);
+		this.isDirty = true;
+		this.saveSync();
+	}
+	async delete(key) {
+		const existed = this.cache.delete(key);
+		if (existed) {
+			this.isDirty = true;
+			this.saveSync();
+		}
+		return existed;
+	}
+	async has(key) {
+		return this.cache.has(key);
+	}
+	async keys() {
+		return Array.from(this.cache.keys());
+	}
+	async clear() {
+		this.cache.clear();
+		this.isDirty = true;
+		this.saveSync();
+	}
+	async stats() {
+		let fileSize = 0;
+		try {
+			if (existsSync(this.filePath)) fileSize = statSync(this.filePath).size;
+		} catch {}
+		return {
+			entryCount: this.cache.size,
+			memoryUsage: fileSize
+		};
+	}
+	/**
+	* Force save any pending changes.
+	*/
+	flush() {
+		this.saveSync();
+	}
+	/**
+	* Reload cache from disk.
+	*/
+	reload() {
+		this.cache.clear();
+		this.loadSync();
+		this.isDirty = false;
+	}
+};
+/**
+* Create a filesystem cache storage adapter.
+*/
+function createFileSystemCacheStorage(filePath, workspaceRoot) {
+	return new FileSystemCacheStorage(filePath, workspaceRoot);
+}
+
+//#endregion
+export { FileSystemCacheStorage, createFileSystemCacheStorage };
+//# sourceMappingURL=filesystem.mjs.map

package/dist/services/verification-cache/adapters/filesystem.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.mjs","names":[],"sources":["../../../../src/services/verification-cache/adapters/filesystem.ts"],"sourcesContent":["/**\n * Filesystem cache storage adapter.\n *\n * Stores cache entries in a JSON file for CLI and CI environments.\n * Uses atomic writes to prevent corruption.\n */\n\nimport {\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  writeFileSync,\n  statSync,\n  renameSync,\n} from 'fs';\nimport { dirname, join } from 'path';\nimport type {\n  CacheKeyString,\n  CacheStorageAdapter,\n  VerificationCacheEntry,\n} from '../types';\n\n/**\n * Default cache file location.\n */\nconst DEFAULT_CACHE_FILE = '.contractspec/verification-cache.json';\n\n/**\n * Cache file structure.\n */\ninterface CacheFileData {\n  version: number;\n  entries: Record<CacheKeyString, VerificationCacheEntry>;\n}\n\nconst CURRENT_VERSION = 1;\n\n/**\n * Filesystem storage adapter.\n */\nexport class FileSystemCacheStorage implements CacheStorageAdapter {\n  private filePath: string;\n  private cache: Map<CacheKeyString, VerificationCacheEntry>;\n  private isDirty = false;\n\n  constructor(filePath?: string, workspaceRoot?: string) {\n    const root = workspaceRoot ?? process.cwd();\n    this.filePath = filePath ?? join(root, DEFAULT_CACHE_FILE);\n    this.cache = new Map();\n    this.loadSync();\n  }\n\n  /**\n   * Load cache from disk synchronously.\n   */\n  private loadSync(): void {\n    try {\n      if (!existsSync(this.filePath)) {\n        return;\n      }\n\n      const content = readFileSync(this.filePath, 'utf-8');\n      const data = JSON.parse(content) as CacheFileData;\n\n      // Version check\n      if (data.version !== CURRENT_VERSION) {\n        // Incompatible version, start fresh\n        return;\n      }\n\n      // Load entries\n      for (const [key, entry] of Object.entries(data.entries)) {\n        this.cache.set(key, entry);\n      }\n    } catch {\n      // Ignore load errors, start with empty cache\n    }\n  }\n\n  /**\n   * Save cache to disk.\n   */\n  private saveSync(): void {\n    if (!this.isDirty) return;\n\n    try {\n      // Ensure directory exists\n      const dir = dirname(this.filePath);\n      if (!existsSync(dir)) {\n        mkdirSync(dir, { recursive: true });\n      }\n\n      const data: CacheFileData = {\n        version: CURRENT_VERSION,\n        entries: Object.fromEntries(this.cache.entries()),\n      };\n\n      // Atomic write: write to temp file, then rename\n      const tempPath = `${this.filePath}.tmp`;\n      writeFileSync(tempPath, JSON.stringify(data, null, 2), 'utf-8');\n\n      // Rename is atomic on most filesystems\n      renameSync(tempPath, this.filePath);\n\n      this.isDirty = false;\n    } catch {\n      // Ignore save errors\n    }\n  }\n\n  async get(key: CacheKeyString): Promise<VerificationCacheEntry | null> {\n    return this.cache.get(key) ?? null;\n  }\n\n  async set(key: CacheKeyString, entry: VerificationCacheEntry): Promise<void> {\n    this.cache.set(key, entry);\n    this.isDirty = true;\n    this.saveSync();\n  }\n\n  async delete(key: CacheKeyString): Promise<boolean> {\n    const existed = this.cache.delete(key);\n    if (existed) {\n      this.isDirty = true;\n      this.saveSync();\n    }\n    return existed;\n  }\n\n  async has(key: CacheKeyString): Promise<boolean> {\n    return this.cache.has(key);\n  }\n\n  async keys(): Promise<CacheKeyString[]> {\n    return Array.from(this.cache.keys());\n  }\n\n  async clear(): Promise<void> {\n    this.cache.clear();\n    this.isDirty = true;\n    this.saveSync();\n  }\n\n  async stats(): Promise<{ entryCount: number; memoryUsage?: number }> {\n    let fileSize = 0;\n    try {\n      if (existsSync(this.filePath)) {\n        const stat = statSync(this.filePath);\n        fileSize = stat.size;\n      }\n    } catch {\n      // Ignore\n    }\n\n    return {\n      entryCount: this.cache.size,\n      memoryUsage: fileSize,\n    };\n  }\n\n  /**\n   * Force save any pending changes.\n   */\n  flush(): void {\n    this.saveSync();\n  }\n\n  /**\n   * Reload cache from disk.\n   */\n  reload(): void {\n    this.cache.clear();\n    this.loadSync();\n    this.isDirty = false;\n  }\n}\n\n/**\n * Create a filesystem cache storage adapter.\n */\nexport function createFileSystemCacheStorage(\n  filePath?: string,\n  workspaceRoot?: string\n): FileSystemCacheStorage {\n  return new FileSystemCacheStorage(filePath, workspaceRoot);\n}\n"],"mappings":";;;;;;;;;;;;;AAyBA,MAAM,qBAAqB;AAU3B,MAAM,kBAAkB;;;;AAKxB,IAAa,yBAAb,MAAmE;CACjE,AAAQ;CACR,AAAQ;CACR,AAAQ,UAAU;CAElB,YAAY,UAAmB,eAAwB;EACrD,MAAM,OAAO,iBAAiB,QAAQ,KAAK;AAC3C,OAAK,WAAW,YAAY,KAAK,MAAM,mBAAmB;AAC1D,OAAK,wBAAQ,IAAI,KAAK;AACtB,OAAK,UAAU;;;;;CAMjB,AAAQ,WAAiB;AACvB,MAAI;AACF,OAAI,CAAC,WAAW,KAAK,SAAS,CAC5B;GAGF,MAAM,UAAU,aAAa,KAAK,UAAU,QAAQ;GACpD,MAAM,OAAO,KAAK,MAAM,QAAQ;AAGhC,OAAI,KAAK,YAAY,gBAEnB;AAIF,QAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,QAAQ,CACrD,MAAK,MAAM,IAAI,KAAK,MAAM;UAEtB;;;;;CAQV,AAAQ,WAAiB;AACvB,MAAI,CAAC,KAAK,QAAS;AAEnB,MAAI;GAEF,MAAM,MAAM,QAAQ,KAAK,SAAS;AAClC,OAAI,CAAC,WAAW,IAAI,CAClB,WAAU,KAAK,EAAE,WAAW,MAAM,CAAC;GAGrC,MAAM,OAAsB;IAC1B,SAAS;IACT,SAAS,OAAO,YAAY,KAAK,MAAM,SAAS,CAAC;IAClD;GAGD,MAAM,WAAW,GAAG,KAAK,SAAS;AAClC,iBAAc,UAAU,KAAK,UAAU,MAAM,MAAM,EAAE,EAAE,QAAQ;AAG/D,cAAW,UAAU,KAAK,SAAS;AAEnC,QAAK,UAAU;UACT;;CAKV,MAAM,IAAI,KAA6D;AACrE,SAAO,KAAK,MAAM,IAAI,IAAI,IAAI;;CAGhC,MAAM,IAAI,KAAqB,OAA8C;AAC3E,OAAK,MAAM,IAAI,KAAK,MAAM;AAC1B,OAAK,UAAU;AACf,OAAK,UAAU;;CAGjB,MAAM,OAAO,KAAuC;EAClD,MAAM,UAAU,KAAK,MAAM,OAAO,IAAI;AACtC,MAAI,SAAS;AACX,QAAK,UAAU;AACf,QAAK,UAAU;;AAEjB,SAAO;;CAGT,MAAM,IAAI,KAAuC;AAC/C,SAAO,KAAK,MAAM,IAAI,IAAI;;CAG5B,MAAM,OAAkC;AACtC,SAAO,MAAM,KAAK,KAAK,MAAM,MAAM,CAAC;;CAGtC,MAAM,QAAuB;AAC3B,OAAK,MAAM,OAAO;AAClB,OAAK,UAAU;AACf,OAAK,UAAU;;CAGjB,MAAM,QAA+D;EACnE,IAAI,WAAW;AACf,MAAI;AACF,OAAI,WAAW,KAAK,SAAS,CAE3B,YADa,SAAS,KAAK,SAAS,CACpB;UAEZ;AAIR,SAAO;GACL,YAAY,KAAK,MAAM;GACvB,aAAa;GACd;;;;;CAMH,QAAc;AACZ,OAAK,UAAU;;;;;CAMjB,SAAe;AACb,OAAK,MAAM,OAAO;AAClB,OAAK,UAAU;AACf,OAAK,UAAU;;;;;;AAOnB,SAAgB,6BACd,UACA,eACwB;AACxB,QAAO,IAAI,uBAAuB,UAAU,cAAc"}

package/dist/services/verification-cache/adapters/in-memory.d.mts

@@ -0,0 +1,27 @@
+import { CacheKeyString, CacheStorageAdapter, VerificationCacheEntry } from "../types.mjs";
+
+//#region src/services/verification-cache/adapters/in-memory.d.ts
+
+/**
+ * In-memory storage adapter using a Map.
+ */
+declare class InMemoryCacheStorage implements CacheStorageAdapter {
+  private cache;
+  get(key: CacheKeyString): Promise<VerificationCacheEntry | null>;
+  set(key: CacheKeyString, entry: VerificationCacheEntry): Promise<void>;
+  delete(key: CacheKeyString): Promise<boolean>;
+  has(key: CacheKeyString): Promise<boolean>;
+  keys(): Promise<CacheKeyString[]>;
+  clear(): Promise<void>;
+  stats(): Promise<{
+    entryCount: number;
+    memoryUsage?: number;
+  }>;
+}
+/**
+ * Create an in-memory cache storage adapter.
+ */
+declare function createInMemoryCacheStorage(): InMemoryCacheStorage;
+//#endregion
+export { InMemoryCacheStorage, createInMemoryCacheStorage };
+//# sourceMappingURL=in-memory.d.mts.map

package/dist/services/verification-cache/adapters/in-memory.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.d.mts","names":[],"sources":["../../../../src/services/verification-cache/adapters/in-memory.ts"],"sourcesContent":[],"mappings":";;;;;;;AA2BoB,cAXP,oBAAA,YAAgC,mBAWzB,CAAA;EAAiB,QAAA,KAAA;EAIpB,GAAA,CAAA,GAAA,EAZA,cAYA,CAAA,EAZiB,OAYjB,CAZyB,sBAYzB,GAAA,IAAA,CAAA;EAAiB,GAAA,CAAA,GAAA,EARjB,cAQiB,EAAA,KAAA,EARM,sBAQN,CAAA,EAR+B,OAQ/B,CAAA,IAAA,CAAA;EAIV,MAAA,CAAA,GAAA,EARJ,cAQI,CAAA,EARa,OAQb,CAAA,OAAA,CAAA;EAAR,GAAA,CAAA,GAAA,EAJC,cAID,CAAA,EAJkB,OAIlB,CAAA,OAAA,CAAA;EAIC,IAAA,CAAA,CAAA,EAJD,OAIC,CAJO,cAIP,EAAA,CAAA;EAIA,KAAA,CAAA,CAAA,EAJA,OAIA,CAAA,IAAA,CAAA;EA3B4B,KAAA,CAAA,CAAA,EA2B5B,OA3B4B,CAAA;IAAmB,UAAA,EAAA,MAAA;IA6ChD,WAAA,CAAA,EAAA,MAAA;;;;;;iBAAA,0BAAA,CAAA,GAA8B"}

package/dist/services/verification-cache/adapters/in-memory.mjs

@@ -0,0 +1,46 @@
+//#region src/services/verification-cache/adapters/in-memory.ts
+/**
+* In-memory storage adapter using a Map.
+*/
+var InMemoryCacheStorage = class {
+	cache = /* @__PURE__ */ new Map();
+	async get(key) {
+		return this.cache.get(key) ?? null;
+	}
+	async set(key, entry) {
+		this.cache.set(key, entry);
+	}
+	async delete(key) {
+		return this.cache.delete(key);
+	}
+	async has(key) {
+		return this.cache.has(key);
+	}
+	async keys() {
+		return Array.from(this.cache.keys());
+	}
+	async clear() {
+		this.cache.clear();
+	}
+	async stats() {
+		let memoryUsage = 0;
+		for (const [key, value] of this.cache.entries()) {
+			memoryUsage += key.length * 2;
+			memoryUsage += JSON.stringify(value).length * 2;
+		}
+		return {
+			entryCount: this.cache.size,
+			memoryUsage
+		};
+	}
+};
+/**
+* Create an in-memory cache storage adapter.
+*/
+function createInMemoryCacheStorage() {
+	return new InMemoryCacheStorage();
+}
+
+//#endregion
+export { InMemoryCacheStorage, createInMemoryCacheStorage };
+//# sourceMappingURL=in-memory.mjs.map

package/dist/services/verification-cache/adapters/in-memory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.mjs","names":[],"sources":["../../../../src/services/verification-cache/adapters/in-memory.ts"],"sourcesContent":["/**\n * In-memory cache storage adapter.\n *\n * Suitable for tests and single-process environments.\n * Data is lost on process restart.\n */\n\nimport type {\n  CacheKeyString,\n  CacheStorageAdapter,\n  VerificationCacheEntry,\n} from '../types';\n\n/**\n * In-memory storage adapter using a Map.\n */\nexport class InMemoryCacheStorage implements CacheStorageAdapter {\n  private cache = new Map<CacheKeyString, VerificationCacheEntry>();\n\n  async get(key: CacheKeyString): Promise<VerificationCacheEntry | null> {\n    return this.cache.get(key) ?? null;\n  }\n\n  async set(key: CacheKeyString, entry: VerificationCacheEntry): Promise<void> {\n    this.cache.set(key, entry);\n  }\n\n  async delete(key: CacheKeyString): Promise<boolean> {\n    return this.cache.delete(key);\n  }\n\n  async has(key: CacheKeyString): Promise<boolean> {\n    return this.cache.has(key);\n  }\n\n  async keys(): Promise<CacheKeyString[]> {\n    return Array.from(this.cache.keys());\n  }\n\n  async clear(): Promise<void> {\n    this.cache.clear();\n  }\n\n  async stats(): Promise<{ entryCount: number; memoryUsage?: number }> {\n    // Estimate memory usage (rough approximation)\n    let memoryUsage = 0;\n    for (const [key, value] of this.cache.entries()) {\n      memoryUsage += key.length * 2; // UTF-16 string\n      memoryUsage += JSON.stringify(value).length * 2;\n    }\n\n    return {\n      entryCount: this.cache.size,\n      memoryUsage,\n    };\n  }\n}\n\n/**\n * Create an in-memory cache storage adapter.\n */\nexport function createInMemoryCacheStorage(): InMemoryCacheStorage {\n  return new InMemoryCacheStorage();\n}\n"],"mappings":";;;;AAgBA,IAAa,uBAAb,MAAiE;CAC/D,AAAQ,wBAAQ,IAAI,KAA6C;CAEjE,MAAM,IAAI,KAA6D;AACrE,SAAO,KAAK,MAAM,IAAI,IAAI,IAAI;;CAGhC,MAAM,IAAI,KAAqB,OAA8C;AAC3E,OAAK,MAAM,IAAI,KAAK,MAAM;;CAG5B,MAAM,OAAO,KAAuC;AAClD,SAAO,KAAK,MAAM,OAAO,IAAI;;CAG/B,MAAM,IAAI,KAAuC;AAC/C,SAAO,KAAK,MAAM,IAAI,IAAI;;CAG5B,MAAM,OAAkC;AACtC,SAAO,MAAM,KAAK,KAAK,MAAM,MAAM,CAAC;;CAGtC,MAAM,QAAuB;AAC3B,OAAK,MAAM,OAAO;;CAGpB,MAAM,QAA+D;EAEnE,IAAI,cAAc;AAClB,OAAK,MAAM,CAAC,KAAK,UAAU,KAAK,MAAM,SAAS,EAAE;AAC/C,kBAAe,IAAI,SAAS;AAC5B,kBAAe,KAAK,UAAU,MAAM,CAAC,SAAS;;AAGhD,SAAO;GACL,YAAY,KAAK,MAAM;GACvB;GACD;;;;;;AAOL,SAAgB,6BAAmD;AACjE,QAAO,IAAI,sBAAsB"}

package/dist/services/verification-cache/adapters/index.d.mts

@@ -0,0 +1,3 @@
+import { InMemoryCacheStorage, createInMemoryCacheStorage } from "./in-memory.mjs";
+import { FileSystemCacheStorage, createFileSystemCacheStorage } from "./filesystem.mjs";
+import { KeyValueStore, WorkspaceStateCacheStorage, createWorkspaceStateCacheStorage } from "./workspace-state.mjs";

package/dist/services/verification-cache/adapters/index.mjs

@@ -0,0 +1,5 @@
+import { InMemoryCacheStorage, createInMemoryCacheStorage } from "./in-memory.mjs";
+import { FileSystemCacheStorage, createFileSystemCacheStorage } from "./filesystem.mjs";
+import { WorkspaceStateCacheStorage, createWorkspaceStateCacheStorage } from "./workspace-state.mjs";
+
+export {  };