@undefineds.co/xpod 0.3.58 → 0.3.61

package/dist/api/service/RdfBenchmarkReportGate.js

@@ -0,0 +1,197 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluateRdfBenchmarkReportGate = evaluateRdfBenchmarkReportGate;
+const DEFAULT_MIN_TARGET_QUADS = 1_000_000;
+const DEFAULT_MIN_ITERATIONS = 1;
+const DEFAULT_MIN_WARMUP_ITERATIONS = 0;
+const DEFAULT_MIN_CONCURRENCY = 4;
+function evaluateRdfBenchmarkReportGate(snapshot, options = {}) {
+    const required = normalizeGateOptions(options);
+    const candidates = snapshot.reports.map((report) => evaluateCandidate(report, required));
+    const matched = candidates.find((candidate) => candidate.matched);
+    const matchedReport = matched
+        ? snapshot.reports.find((report) => report.path === matched.path)
+        : undefined;
+    return {
+        matched: Boolean(matched),
+        evaluatedAt: new Date().toISOString(),
+        checkedReportCount: snapshot.reports.length,
+        required,
+        matchedReport,
+        failedReasons: matched ? [] : topLevelFailedReasons(snapshot, candidates),
+        candidates,
+    };
+}
+function normalizeGateOptions(options) {
+    const minTargetQuadCount = positiveOrDefault(options.minTargetQuadCount, DEFAULT_MIN_TARGET_QUADS);
+    return {
+        requiredScale: options.requiredScale ?? 'large',
+        requiredDriver: options.requiredDriver ?? 'pg',
+        requiredCaseProfile: options.requiredCaseProfile,
+        requiredRdfAccelerationProfile: options.requiredRdfAccelerationProfile,
+        requiredTextSearchBackend: options.requiredTextSearchBackend,
+        minTargetQuadCount,
+        minSeedQuadCount: positiveOrDefault(options.minSeedQuadCount, minTargetQuadCount),
+        minIterations: positiveOrDefault(options.minIterations, DEFAULT_MIN_ITERATIONS),
+        minWarmupIterations: nonNegativeOrDefault(options.minWarmupIterations, DEFAULT_MIN_WARMUP_ITERATIONS),
+        minConcurrency: positiveOrDefault(options.minConcurrency, DEFAULT_MIN_CONCURRENCY),
+        requireFullScale: options.requireFullScale ?? true,
+        requireCopyIngest: options.requireCopyIngest ?? true,
+        allowCopyFallbacks: options.allowCopyFallbacks ?? false,
+        requirePlannerStats: options.requirePlannerStats ?? true,
+        requireColdWarmTimings: options.requireColdWarmTimings ?? true,
+        requireStorageRatio: options.requireStorageRatio ?? true,
+        requireServingRegressionGate: options.requireServingRegressionGate ?? false,
+        requireServingRegressionThresholds: options.requireServingRegressionThresholds ?? false,
+        requireFusionBenchmarkGate: options.requireFusionBenchmarkGate ?? false,
+        requireFusionBenchmarkThresholds: options.requireFusionBenchmarkThresholds ?? false,
+        requireFusionBaselineComparison: options.requireFusionBaselineComparison ?? false,
+        requireBenchmarkGateConfigSources: options.requireBenchmarkGateConfigSources ?? false,
+        requireFusionBaselineReportSource: options.requireFusionBaselineReportSource ?? false,
+        requireFusionBaselineSourceBaselineProfile: options.requireFusionBaselineSourceBaselineProfile ?? false,
+        requireFusionHardFilterEvidence: options.requireFusionHardFilterEvidence ?? false,
+        requireFusionBatchedBroadCandidateJoinEvidence: options.requireFusionBatchedBroadCandidateJoinEvidence ?? false,
+        requireNativeTextFtsEvidence: options.requireNativeTextFtsEvidence ?? false,
+        requireNativeVectorEvidence: options.requireNativeVectorEvidence ?? false,
+    };
+}
+function evaluateCandidate(report, required) {
+    const failedReasons = [];
+    requireEqual(failedReasons, 'scale', report.scale, required.requiredScale);
+    requireEqual(failedReasons, 'driver', report.driver, required.requiredDriver);
+    if (required.requiredCaseProfile) {
+        requireEqual(failedReasons, 'caseProfile', report.caseProfile, required.requiredCaseProfile);
+    }
+    if (required.requiredRdfAccelerationProfile) {
+        requireEqual(failedReasons, 'rdfAccelerationProfile', report.rdfAccelerationProfile, required.requiredRdfAccelerationProfile);
+    }
+    if (required.requiredTextSearchBackend) {
+        requireEqual(failedReasons, 'textSearchBackend', report.textSearchBackend, required.requiredTextSearchBackend);
+    }
+    requireAtLeast(failedReasons, 'targetQuadCount', report.targetQuadCount, required.minTargetQuadCount);
+    requireAtLeast(failedReasons, 'seedQuadCount', report.seedQuadCount, required.minSeedQuadCount);
+    requireAtLeast(failedReasons, 'iterations', report.iterations, required.minIterations);
+    requireAtLeast(failedReasons, 'warmupIterations', report.warmupIterations, required.minWarmupIterations);
+    if (required.requireFullScale && report.fullScale !== true) {
+        failedReasons.push(`fullScale expected true, got ${String(report.fullScale)}`);
+    }
+    if (report.planMatched !== true || report.failedPlanCases.length > 0) {
+        failedReasons.push(`plan gate failed: ${report.failedPlanCases.join(', ') || 'planMatched is not true'}`);
+    }
+    requireAtLeast(failedReasons, 'concurrency', report.concurrency, required.minConcurrency);
+    if (report.concurrencyMatched !== true || report.failedConcurrencyCases.length > 0) {
+        failedReasons.push(`concurrency gate failed: ${report.failedConcurrencyCases.join(', ') || 'concurrencyMatched is not true'}`);
+    }
+    if (required.requireServingRegressionGate && (report.servingRegressionMatched !== true || report.failedServingRegressionCases.length > 0)) {
+        failedReasons.push(`serving regression gate failed: ${report.failedServingRegressionCases.join(', ') || 'servingRegressionMatched is not true'}`);
+    }
+    if (required.requireServingRegressionThresholds && report.servingRegressionThresholdsConfigured !== true) {
+        failedReasons.push('serving regression thresholds are not configured');
+    }
+    if (required.requireFusionBenchmarkGate && (report.fusionBenchmarkMatched !== true || report.failedFusionBenchmarkCases.length > 0)) {
+        failedReasons.push(`fusion benchmark gate failed: ${report.failedFusionBenchmarkCases.join(', ') || 'fusionBenchmarkMatched is not true'}`);
+    }
+    if (required.requireFusionBenchmarkThresholds && report.fusionBenchmarkThresholdsConfigured !== true) {
+        failedReasons.push('fusion benchmark thresholds are not configured');
+    }
+    if (required.requireFusionBaselineComparison &&
+        (report.fusionBaselineComparisonMatched !== true || report.failedFusionBaselineComparisonCases.length > 0)) {
+        failedReasons.push(`fusion baseline comparison gate failed: ${report.failedFusionBaselineComparisonCases.join(', ') || 'fusionBaselineComparisonMatched is not true'}`);
+    }
+    if (required.requireBenchmarkGateConfigSources && report.benchmarkGateConfigSourcesConfigured !== true) {
+        failedReasons.push('benchmark gate config sources are not configured');
+    }
+    if (required.requireFusionBaselineReportSource && report.fusionBaselineReportSourceConfigured !== true) {
+        failedReasons.push('fusion baseline report source is not configured');
+    }
+    if (required.requireFusionBaselineSourceBaselineProfile &&
+        report.fusionBaselineReportSourceBaselineProfileConfigured !== true) {
+        failedReasons.push('fusion baseline source baseline profile is not configured');
+    }
+    if (required.requireBenchmarkGateConfigSources && report.benchmarkGateConfigSourceShapeMismatches.length > 0) {
+        failedReasons.push(`benchmark gate config source shape mismatch: ${report.benchmarkGateConfigSourceShapeMismatches.join('; ')}`);
+    }
+    if (required.requireFusionHardFilterEvidence) {
+        requirePositive(failedReasons, 'fusion hard-filter-before-rank evidence', report.fusionHardFiltersBeforeRankCaseCount);
+    }
+    if (required.requireFusionBatchedBroadCandidateJoinEvidence) {
+        requirePositive(failedReasons, 'fusion batched broad candidate join evidence', report.fusionBatchedBroadCandidateJoinCaseCount);
+    }
+    if (required.requireNativeTextFtsEvidence) {
+        requirePositive(failedReasons, 'native text FTS evidence', report.nativeTextFtsCaseCount);
+    }
+    if (required.requireNativeVectorEvidence) {
+        requirePositive(failedReasons, 'native vector evidence', report.nativeVectorCaseCount);
+    }
+    if (required.requireCopyIngest) {
+        requirePositive(failedReasons, 'copyRows', report.copyRows);
+        if (!required.allowCopyFallbacks && (report.copyFallbacks ?? 0) > 0) {
+            failedReasons.push(`copyFallbacks expected 0, got ${report.copyFallbacks}`);
+        }
+    }
+    if (required.requirePlannerStats) {
+        requirePositive(failedReasons, 'refreshDurationMs', report.refreshDurationMs);
+        requireNonNegative(failedReasons, 'plannerStatsDurationMs', report.plannerStatsDurationMs);
+        if (report.plannerStatsAnalyzedTables.length === 0) {
+            failedReasons.push('plannerStatsAnalyzedTables is empty');
+        }
+    }
+    if (required.requireColdWarmTimings) {
+        requirePositive(failedReasons, 'coldStartDurationMs', report.coldStartDurationMs);
+        requirePositive(failedReasons, 'firstQueryDurationMs', report.firstQueryDurationMs);
+        requirePositive(failedReasons, 'warmP50DurationMs', report.warmP50DurationMs);
+        requirePositive(failedReasons, 'warmP95DurationMs', report.warmP95DurationMs);
+    }
+    if (required.requireStorageRatio) {
+        requirePositive(failedReasons, 'storageFactsBytes', report.storageFactsBytes);
+        requirePositive(failedReasons, 'storageTotalBytes', report.storageTotalBytes);
+        requirePositive(failedReasons, 'storageTotalToFactsRatio', report.storageTotalToFactsRatio);
+    }
+    return {
+        id: report.id,
+        path: report.path,
+        generatedAt: report.generatedAt,
+        matched: failedReasons.length === 0,
+        failedReasons,
+    };
+}
+function topLevelFailedReasons(snapshot, candidates) {
+    if (snapshot.reports.length === 0) {
+        return ['no benchmark reports found'];
+    }
+    const newest = candidates[0];
+    if (!newest) {
+        return ['no benchmark reports found'];
+    }
+    return [
+        `no report satisfied the gate; newest report ${newest.path} failed`,
+        ...newest.failedReasons,
+    ];
+}
+function requireEqual(failedReasons, label, actual, expected) {
+    if (actual !== expected) {
+        failedReasons.push(`${label} expected ${expected}, got ${actual ?? 'missing'}`);
+    }
+}
+function requireAtLeast(failedReasons, label, actual, expected) {
+    if (!Number.isFinite(actual) || (actual ?? 0) < expected) {
+        failedReasons.push(`${label} expected >= ${expected}, got ${actual ?? 'missing'}`);
+    }
+}
+function requirePositive(failedReasons, label, actual) {
+    if (!Number.isFinite(actual) || (actual ?? 0) <= 0) {
+        failedReasons.push(`${label} expected > 0, got ${actual ?? 'missing'}`);
+    }
+}
+function requireNonNegative(failedReasons, label, actual) {
+    if (!Number.isFinite(actual) || (actual ?? -1) < 0) {
+        failedReasons.push(`${label} expected >= 0, got ${actual ?? 'missing'}`);
+    }
+}
+function positiveOrDefault(value, defaultValue) {
+    return typeof value === 'number' && Number.isFinite(value) && value > 0 ? Math.floor(value) : defaultValue;
+}
+function nonNegativeOrDefault(value, defaultValue) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? Math.floor(value) : defaultValue;
+}
+//# sourceMappingURL=RdfBenchmarkReportGate.js.map

package/dist/api/service/RdfBenchmarkReportGate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RdfBenchmarkReportGate.js","sourceRoot":"","sources":["../../../src/api/service/RdfBenchmarkReportGate.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  RdfBenchmarkReportCatalogSnapshot,\n  RdfBenchmarkReportSummary,\n} from './RdfBenchmarkReportCatalog';\n\nexport interface RdfBenchmarkReportGateOptions {\n  requiredScale?: string;\n  requiredDriver?: string;\n  requiredCaseProfile?: string;\n  requiredRdfAccelerationProfile?: string;\n  requiredTextSearchBackend?: string;\n  minTargetQuadCount?: number;\n  minSeedQuadCount?: number;\n  minIterations?: number;\n  minWarmupIterations?: number;\n  minConcurrency?: number;\n  requireFullScale?: boolean;\n  requireCopyIngest?: boolean;\n  allowCopyFallbacks?: boolean;\n  requirePlannerStats?: boolean;\n  requireColdWarmTimings?: boolean;\n  requireStorageRatio?: boolean;\n  requireServingRegressionGate?: boolean;\n  requireServingRegressionThresholds?: boolean;\n  requireFusionBenchmarkGate?: boolean;\n  requireFusionBenchmarkThresholds?: boolean;\n  requireFusionBaselineComparison?: boolean;\n  requireBenchmarkGateConfigSources?: boolean;\n  requireFusionBaselineReportSource?: boolean;\n  requireFusionBaselineSourceBaselineProfile?: boolean;\n  requireFusionHardFilterEvidence?: boolean;\n  requireFusionBatchedBroadCandidateJoinEvidence?: boolean;\n  requireNativeTextFtsEvidence?: boolean;\n  requireNativeVectorEvidence?: boolean;\n}\n\nexport interface RdfBenchmarkReportGateResult {\n  matched: boolean;\n  evaluatedAt: string;\n  checkedReportCount: number;\n  required: RequiredRdfBenchmarkReportGateOptions;\n  matchedReport?: RdfBenchmarkReportSummary;\n  failedReasons: string[];\n  candidates: RdfBenchmarkReportGateCandidate[];\n}\n\nexport interface RdfBenchmarkReportGateCandidate {\n  id: string;\n  path: string;\n  generatedAt: string;\n  matched: boolean;\n  failedReasons: string[];\n}\n\nexport interface RequiredRdfBenchmarkReportGateOptions {\n  requiredScale: string;\n  requiredDriver: string;\n  requiredCaseProfile?: string;\n  requiredRdfAccelerationProfile?: string;\n  requiredTextSearchBackend?: string;\n  minTargetQuadCount: number;\n  minSeedQuadCount: number;\n  minIterations: number;\n  minWarmupIterations: number;\n  minConcurrency: number;\n  requireFullScale: boolean;\n  requireCopyIngest: boolean;\n  allowCopyFallbacks: boolean;\n  requirePlannerStats: boolean;\n  requireColdWarmTimings: boolean;\n  requireStorageRatio: boolean;\n  requireServingRegressionGate: boolean;\n  requireServingRegressionThresholds: boolean;\n  requireFusionBenchmarkGate: boolean;\n  requireFusionBenchmarkThresholds: boolean;\n  requireFusionBaselineComparison: boolean;\n  requireBenchmarkGateConfigSources: boolean;\n  requireFusionBaselineReportSource: boolean;\n  requireFusionBaselineSourceBaselineProfile: boolean;\n  requireFusionHardFilterEvidence: boolean;\n  requireFusionBatchedBroadCandidateJoinEvidence: boolean;\n  requireNativeTextFtsEvidence: boolean;\n  requireNativeVectorEvidence: boolean;\n}\n\nconst DEFAULT_MIN_TARGET_QUADS = 1_000_000;\nconst DEFAULT_MIN_ITERATIONS = 1;\nconst DEFAULT_MIN_WARMUP_ITERATIONS = 0;\nconst DEFAULT_MIN_CONCURRENCY = 4;\n\nexport function evaluateRdfBenchmarkReportGate(\n  snapshot: RdfBenchmarkReportCatalogSnapshot,\n  options: RdfBenchmarkReportGateOptions = {},\n): RdfBenchmarkReportGateResult {\n  const required = normalizeGateOptions(options);\n  const candidates = snapshot.reports.map((report) => evaluateCandidate(report, required));\n  const matched = candidates.find((candidate) => candidate.matched);\n  const matchedReport = matched\n    ? snapshot.reports.find((report) => report.path === matched.path)\n    : undefined;\n\n  return {\n    matched: Boolean(matched),\n    evaluatedAt: new Date().toISOString(),\n    checkedReportCount: snapshot.reports.length,\n    required,\n    matchedReport,\n    failedReasons: matched ? [] : topLevelFailedReasons(snapshot, candidates),\n    candidates,\n  };\n}\n\nfunction normalizeGateOptions(options: RdfBenchmarkReportGateOptions): RequiredRdfBenchmarkReportGateOptions {\n  const minTargetQuadCount = positiveOrDefault(options.minTargetQuadCount, DEFAULT_MIN_TARGET_QUADS);\n  return {\n    requiredScale: options.requiredScale ?? 'large',\n    requiredDriver: options.requiredDriver ?? 'pg',\n    requiredCaseProfile: options.requiredCaseProfile,\n    requiredRdfAccelerationProfile: options.requiredRdfAccelerationProfile,\n    requiredTextSearchBackend: options.requiredTextSearchBackend,\n    minTargetQuadCount,\n    minSeedQuadCount: positiveOrDefault(options.minSeedQuadCount, minTargetQuadCount),\n    minIterations: positiveOrDefault(options.minIterations, DEFAULT_MIN_ITERATIONS),\n    minWarmupIterations: nonNegativeOrDefault(options.minWarmupIterations, DEFAULT_MIN_WARMUP_ITERATIONS),\n    minConcurrency: positiveOrDefault(options.minConcurrency, DEFAULT_MIN_CONCURRENCY),\n    requireFullScale: options.requireFullScale ?? true,\n    requireCopyIngest: options.requireCopyIngest ?? true,\n    allowCopyFallbacks: options.allowCopyFallbacks ?? false,\n    requirePlannerStats: options.requirePlannerStats ?? true,\n    requireColdWarmTimings: options.requireColdWarmTimings ?? true,\n    requireStorageRatio: options.requireStorageRatio ?? true,\n    requireServingRegressionGate: options.requireServingRegressionGate ?? false,\n    requireServingRegressionThresholds: options.requireServingRegressionThresholds ?? false,\n    requireFusionBenchmarkGate: options.requireFusionBenchmarkGate ?? false,\n    requireFusionBenchmarkThresholds: options.requireFusionBenchmarkThresholds ?? false,\n    requireFusionBaselineComparison: options.requireFusionBaselineComparison ?? false,\n    requireBenchmarkGateConfigSources: options.requireBenchmarkGateConfigSources ?? false,\n    requireFusionBaselineReportSource: options.requireFusionBaselineReportSource ?? false,\n    requireFusionBaselineSourceBaselineProfile: options.requireFusionBaselineSourceBaselineProfile ?? false,\n    requireFusionHardFilterEvidence: options.requireFusionHardFilterEvidence ?? false,\n    requireFusionBatchedBroadCandidateJoinEvidence: options.requireFusionBatchedBroadCandidateJoinEvidence ?? false,\n    requireNativeTextFtsEvidence: options.requireNativeTextFtsEvidence ?? false,\n    requireNativeVectorEvidence: options.requireNativeVectorEvidence ?? false,\n  };\n}\n\nfunction evaluateCandidate(\n  report: RdfBenchmarkReportSummary,\n  required: RequiredRdfBenchmarkReportGateOptions,\n): RdfBenchmarkReportGateCandidate {\n  const failedReasons: string[] = [];\n  requireEqual(failedReasons, 'scale', report.scale, required.requiredScale);\n  requireEqual(failedReasons, 'driver', report.driver, required.requiredDriver);\n  if (required.requiredCaseProfile) {\n    requireEqual(failedReasons, 'caseProfile', report.caseProfile, required.requiredCaseProfile);\n  }\n  if (required.requiredRdfAccelerationProfile) {\n    requireEqual(\n      failedReasons,\n      'rdfAccelerationProfile',\n      report.rdfAccelerationProfile,\n      required.requiredRdfAccelerationProfile,\n    );\n  }\n  if (required.requiredTextSearchBackend) {\n    requireEqual(\n      failedReasons,\n      'textSearchBackend',\n      report.textSearchBackend,\n      required.requiredTextSearchBackend,\n    );\n  }\n  requireAtLeast(failedReasons, 'targetQuadCount', report.targetQuadCount, required.minTargetQuadCount);\n  requireAtLeast(failedReasons, 'seedQuadCount', report.seedQuadCount, required.minSeedQuadCount);\n  requireAtLeast(failedReasons, 'iterations', report.iterations, required.minIterations);\n  requireAtLeast(failedReasons, 'warmupIterations', report.warmupIterations, required.minWarmupIterations);\n  if (required.requireFullScale && report.fullScale !== true) {\n    failedReasons.push(`fullScale expected true, got ${String(report.fullScale)}`);\n  }\n  if (report.planMatched !== true || report.failedPlanCases.length > 0) {\n    failedReasons.push(`plan gate failed: ${report.failedPlanCases.join(', ') || 'planMatched is not true'}`);\n  }\n  requireAtLeast(failedReasons, 'concurrency', report.concurrency, required.minConcurrency);\n  if (report.concurrencyMatched !== true || report.failedConcurrencyCases.length > 0) {\n    failedReasons.push(`concurrency gate failed: ${report.failedConcurrencyCases.join(', ') || 'concurrencyMatched is not true'}`);\n  }\n  if (required.requireServingRegressionGate && (report.servingRegressionMatched !== true || report.failedServingRegressionCases.length > 0)) {\n    failedReasons.push(`serving regression gate failed: ${report.failedServingRegressionCases.join(', ') || 'servingRegressionMatched is not true'}`);\n  }\n  if (required.requireServingRegressionThresholds && report.servingRegressionThresholdsConfigured !== true) {\n    failedReasons.push('serving regression thresholds are not configured');\n  }\n  if (required.requireFusionBenchmarkGate && (report.fusionBenchmarkMatched !== true || report.failedFusionBenchmarkCases.length > 0)) {\n    failedReasons.push(`fusion benchmark gate failed: ${report.failedFusionBenchmarkCases.join(', ') || 'fusionBenchmarkMatched is not true'}`);\n  }\n  if (required.requireFusionBenchmarkThresholds && report.fusionBenchmarkThresholdsConfigured !== true) {\n    failedReasons.push('fusion benchmark thresholds are not configured');\n  }\n  if (\n    required.requireFusionBaselineComparison &&\n    (report.fusionBaselineComparisonMatched !== true || report.failedFusionBaselineComparisonCases.length > 0)\n  ) {\n    failedReasons.push(`fusion baseline comparison gate failed: ${report.failedFusionBaselineComparisonCases.join(', ') || 'fusionBaselineComparisonMatched is not true'}`);\n  }\n  if (required.requireBenchmarkGateConfigSources && report.benchmarkGateConfigSourcesConfigured !== true) {\n    failedReasons.push('benchmark gate config sources are not configured');\n  }\n  if (required.requireFusionBaselineReportSource && report.fusionBaselineReportSourceConfigured !== true) {\n    failedReasons.push('fusion baseline report source is not configured');\n  }\n  if (\n    required.requireFusionBaselineSourceBaselineProfile &&\n    report.fusionBaselineReportSourceBaselineProfileConfigured !== true\n  ) {\n    failedReasons.push('fusion baseline source baseline profile is not configured');\n  }\n  if (required.requireBenchmarkGateConfigSources && report.benchmarkGateConfigSourceShapeMismatches.length > 0) {\n    failedReasons.push(`benchmark gate config source shape mismatch: ${report.benchmarkGateConfigSourceShapeMismatches.join('; ')}`);\n  }\n  if (required.requireFusionHardFilterEvidence) {\n    requirePositive(\n      failedReasons,\n      'fusion hard-filter-before-rank evidence',\n      report.fusionHardFiltersBeforeRankCaseCount,\n    );\n  }\n  if (required.requireFusionBatchedBroadCandidateJoinEvidence) {\n    requirePositive(\n      failedReasons,\n      'fusion batched broad candidate join evidence',\n      report.fusionBatchedBroadCandidateJoinCaseCount,\n    );\n  }\n  if (required.requireNativeTextFtsEvidence) {\n    requirePositive(failedReasons, 'native text FTS evidence', report.nativeTextFtsCaseCount);\n  }\n  if (required.requireNativeVectorEvidence) {\n    requirePositive(failedReasons, 'native vector evidence', report.nativeVectorCaseCount);\n  }\n  if (required.requireCopyIngest) {\n    requirePositive(failedReasons, 'copyRows', report.copyRows);\n    if (!required.allowCopyFallbacks && (report.copyFallbacks ?? 0) > 0) {\n      failedReasons.push(`copyFallbacks expected 0, got ${report.copyFallbacks}`);\n    }\n  }\n  if (required.requirePlannerStats) {\n    requirePositive(failedReasons, 'refreshDurationMs', report.refreshDurationMs);\n    requireNonNegative(failedReasons, 'plannerStatsDurationMs', report.plannerStatsDurationMs);\n    if (report.plannerStatsAnalyzedTables.length === 0) {\n      failedReasons.push('plannerStatsAnalyzedTables is empty');\n    }\n  }\n  if (required.requireColdWarmTimings) {\n    requirePositive(failedReasons, 'coldStartDurationMs', report.coldStartDurationMs);\n    requirePositive(failedReasons, 'firstQueryDurationMs', report.firstQueryDurationMs);\n    requirePositive(failedReasons, 'warmP50DurationMs', report.warmP50DurationMs);\n    requirePositive(failedReasons, 'warmP95DurationMs', report.warmP95DurationMs);\n  }\n  if (required.requireStorageRatio) {\n    requirePositive(failedReasons, 'storageFactsBytes', report.storageFactsBytes);\n    requirePositive(failedReasons, 'storageTotalBytes', report.storageTotalBytes);\n    requirePositive(failedReasons, 'storageTotalToFactsRatio', report.storageTotalToFactsRatio);\n  }\n\n  return {\n    id: report.id,\n    path: report.path,\n    generatedAt: report.generatedAt,\n    matched: failedReasons.length === 0,\n    failedReasons,\n  };\n}\n\nfunction topLevelFailedReasons(\n  snapshot: RdfBenchmarkReportCatalogSnapshot,\n  candidates: RdfBenchmarkReportGateCandidate[],\n): string[] {\n  if (snapshot.reports.length === 0) {\n    return ['no benchmark reports found'];\n  }\n  const newest = candidates[0];\n  if (!newest) {\n    return ['no benchmark reports found'];\n  }\n  return [\n    `no report satisfied the gate; newest report ${newest.path} failed`,\n    ...newest.failedReasons,\n  ];\n}\n\nfunction requireEqual(\n  failedReasons: string[],\n  label: string,\n  actual: string | undefined,\n  expected: string,\n): void {\n  if (actual !== expected) {\n    failedReasons.push(`${label} expected ${expected}, got ${actual ?? 'missing'}`);\n  }\n}\n\nfunction requireAtLeast(\n  failedReasons: string[],\n  label: string,\n  actual: number | undefined,\n  expected: number,\n): void {\n  if (!Number.isFinite(actual) || (actual ?? 0) < expected) {\n    failedReasons.push(`${label} expected >= ${expected}, got ${actual ?? 'missing'}`);\n  }\n}\n\nfunction requirePositive(failedReasons: string[], label: string, actual: number | undefined): void {\n  if (!Number.isFinite(actual) || (actual ?? 0) <= 0) {\n    failedReasons.push(`${label} expected > 0, got ${actual ?? 'missing'}`);\n  }\n}\n\nfunction requireNonNegative(failedReasons: string[], label: string, actual: number | undefined): void {\n  if (!Number.isFinite(actual) || (actual ?? -1) < 0) {\n    failedReasons.push(`${label} expected >= 0, got ${actual ?? 'missing'}`);\n  }\n}\n\nfunction positiveOrDefault(value: number | undefined, defaultValue: number): number {\n  return typeof value === 'number' && Number.isFinite(value) && value > 0 ? Math.floor(value) : defaultValue;\n}\n\nfunction nonNegativeOrDefault(value: number | undefined, defaultValue: number): number {\n  return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? Math.floor(value) : defaultValue;\n}\n"]}

package/dist/api/service/RdfSearchIndexingService.d.ts

@@ -0,0 +1,113 @@
+import type { EmbeddingService } from '../../ai/service';
+import type { RdfEngineLike, RdfTextChunkInput, RdfTextSourceInput, RdfVectorSourceInput } from '../../storage/rdf/types';
+import type { StoreContext } from '../chatkit/store';
+export type RdfVectorIndexingSkippedReason = 'rdf_engine_unavailable' | 'vector_index_unavailable' | 'ai_config_unavailable' | 'embedding_model_unavailable' | 'embedding_provider_failed';
+export interface RdfSearchIndexingServiceOptions {
+    rdfEngine?: Pick<RdfEngineLike, 'indexVectorSource' | 'deleteVectorSource'>;
+    store: {
+        getAiConfig(context: StoreContext): Promise<RdfSearchAiConfig | undefined> | RdfSearchAiConfig | undefined;
+    };
+    embeddingService: Pick<EmbeddingService, 'embedBatch'>;
+    maxChunks?: number;
+    maxEmbeddingInputChars?: number;
+    embeddingInputKinds?: RdfEmbeddingInputKind[];
+    projectionPolicyVersion?: string;
+    summaryService?: RdfEmbeddingSummaryService;
+    summaryPromptVersion?: string;
+}
+export interface RdfSearchAiConfig {
+    providerId: string;
+    baseUrl: string;
+    proxyUrl?: string;
+    defaultModel?: string;
+    embeddingModel?: string;
+    embeddingModelVersion?: string;
+    apiKey: string;
+    credentialId: string;
+}
+export interface IndexRdfVectorSourceInput {
+    context: StoreContext;
+    source: RdfTextSourceInput & RdfVectorSourceInput;
+    text?: string;
+    chunks?: RdfTextChunkInput[];
+}
+export interface DeleteRdfVectorSourceInput {
+    source: string;
+}
+export type RdfVectorIndexingResult = {
+    status: 'indexed';
+    source: string;
+    model?: string;
+    chunkCount: number;
+    skippedInputs?: RdfSkippedEmbeddingInput[];
+    summarizedInputs?: RdfSummarizedEmbeddingInput[];
+} | {
+    status: 'skipped';
+    source: string;
+    reason: RdfVectorIndexingSkippedReason;
+    message?: string;
+};
+export interface RdfVectorDeleteResult {
+    status: 'deleted' | 'skipped';
+    source: string;
+    deletedChunks: number;
+    reason?: 'rdf_engine_unavailable' | 'vector_index_unavailable';
+}
+export type RdfEmbeddingInputKind = 'locator' | 'semantic';
+export interface RdfSkippedEmbeddingInput {
+    chunkKey: string;
+    inputKind: RdfEmbeddingInputKind;
+    reason: 'input_too_large' | 'summary_failed' | 'summary_too_large';
+    inputChars: number;
+    maxChars: number;
+    summaryChars?: number;
+    message?: string;
+}
+export interface RdfEmbeddingSummaryRequest {
+    content: string;
+    inputKind: RdfEmbeddingInputKind;
+    chunkKey: string;
+    sourceHash?: string;
+    maxChars: number;
+    promptVersion: string;
+}
+export interface RdfEmbeddingSummaryResult {
+    content: string;
+    provider: string;
+    model: string;
+    promptVersion?: string;
+    rounds?: number;
+}
+export interface RdfEmbeddingSummaryService {
+    summarize(request: RdfEmbeddingSummaryRequest): Promise<RdfEmbeddingSummaryResult> | RdfEmbeddingSummaryResult;
+}
+export interface RdfSummarizedEmbeddingInput {
+    chunkKey: string;
+    inputKind: RdfEmbeddingInputKind;
+    originalChars: number;
+    summaryChars: number;
+    rounds: number;
+}
+/**
+ * Product-level bridge from Pod-owned AI credentials to the RDF vector index.
+ *
+ * CSS storage writes can keep text search sources current because they already
+ * have the resource bytes. Vector writes need user Pod AI credentials, so they
+ * live here at the product/service boundary instead of inside MixDataAccessor.
+ */
+export declare class RdfSearchIndexingService {
+    private readonly options;
+    constructor(options: RdfSearchIndexingServiceOptions);
+    indexVectorSource(input: IndexRdfVectorSourceInput): Promise<RdfVectorIndexingResult>;
+    deleteVectorSource(input: DeleteRdfVectorSourceInput): Promise<RdfVectorDeleteResult>;
+    private sourceWithHash;
+    private textChunks;
+    private embeddingInputs;
+    private embeddingInputKinds;
+    private projectionPolicyVersion;
+    private embeddingInputContent;
+    private resolveEmbeddingInputBudget;
+    private summarizeEmbeddingInput;
+    private skippedEmbeddingInput;
+    private indexedResult;
+}

package/dist/api/service/RdfSearchIndexingService.js

@@ -0,0 +1,272 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RdfSearchIndexingService = void 0;
+const node_crypto_1 = require("node:crypto");
+const RdfTextIndex_1 = require("../../storage/rdf/RdfTextIndex");
+const DEFAULT_EMBEDDING_INPUT_KINDS = ['semantic'];
+const DEFAULT_PROJECTION_POLICY_VERSION = 'rdf-vector-projection-v1';
+const DEFAULT_SUMMARY_PROMPT_VERSION = 'rdf-embedding-summary-v1';
+/**
+ * Product-level bridge from Pod-owned AI credentials to the RDF vector index.
+ *
+ * CSS storage writes can keep text search sources current because they already
+ * have the resource bytes. Vector writes need user Pod AI credentials, so they
+ * live here at the product/service boundary instead of inside MixDataAccessor.
+ */
+class RdfSearchIndexingService {
+    constructor(options) {
+        this.options = options;
+    }
+    async indexVectorSource(input) {
+        if (!this.options.rdfEngine) {
+            return { status: 'skipped', source: input.source.source, reason: 'rdf_engine_unavailable' };
+        }
+        if (!this.options.rdfEngine.indexVectorSource) {
+            return { status: 'skipped', source: input.source.source, reason: 'vector_index_unavailable' };
+        }
+        const source = this.sourceWithHash(input.source, input.text);
+        const textChunks = this.textChunks(source, input);
+        if (textChunks.length === 0) {
+            await this.options.rdfEngine.indexVectorSource(source, []);
+            return { status: 'indexed', source: source.source, chunkCount: 0 };
+        }
+        const { accepted: embeddingInputs, skipped: skippedInputs, summarized: summarizedInputs } = await this.resolveEmbeddingInputBudget(source, this.embeddingInputs(source, textChunks));
+        if (embeddingInputs.length === 0) {
+            await this.options.rdfEngine.indexVectorSource(source, []);
+            return this.indexedResult(source.source, undefined, 0, skippedInputs, summarizedInputs);
+        }
+        const config = await this.options.store.getAiConfig(input.context);
+        if (!config?.apiKey) {
+            return { status: 'skipped', source: source.source, reason: 'ai_config_unavailable' };
+        }
+        if (!config.embeddingModel) {
+            return { status: 'skipped', source: source.source, reason: 'embedding_model_unavailable' };
+        }
+        const contents = embeddingInputs.map((embeddingInput) => embeddingInput.content);
+        let embeddings;
+        try {
+            embeddings = await this.options.embeddingService.embedBatch(contents, {
+                provider: config.providerId,
+                apiKey: config.apiKey,
+                baseUrl: config.baseUrl,
+                proxyUrl: config.proxyUrl,
+            }, config.embeddingModel);
+        }
+        catch (error) {
+            return {
+                status: 'skipped',
+                source: source.source,
+                reason: 'embedding_provider_failed',
+                message: error instanceof Error ? error.message : String(error),
+            };
+        }
+        if (embeddings.length !== embeddingInputs.length) {
+            throw new Error(`Embedding batch returned ${embeddings.length} vectors for ${embeddingInputs.length} RDF embedding inputs`);
+        }
+        const projectionPolicyVersion = this.projectionPolicyVersion();
+        await this.options.rdfEngine.indexVectorSource(source, embeddingInputs.map(({ chunk, kind, content, inputHash, summaryMetadata }, index) => ({
+            chunkKey: chunk.chunkKey,
+            ordinal: chunk.ordinal,
+            level: chunk.level,
+            embedding: embeddings[index],
+            provider: config.providerId,
+            model: config.embeddingModel,
+            modelVersion: config.embeddingModelVersion,
+            inputKind: kind,
+            inputHash,
+            projectionPolicyVersion,
+            heading: chunk.heading,
+            path: chunk.path,
+            content,
+            startOffset: chunk.startOffset,
+            endOffset: chunk.endOffset,
+            summaryMetadata,
+        })));
+        return this.indexedResult(source.source, config.embeddingModel, embeddingInputs.length, skippedInputs, summarizedInputs);
+    }
+    async deleteVectorSource(input) {
+        if (!this.options.rdfEngine) {
+            return {
+                status: 'skipped',
+                source: input.source,
+                deletedChunks: 0,
+                reason: 'rdf_engine_unavailable',
+            };
+        }
+        if (!this.options.rdfEngine.deleteVectorSource) {
+            return {
+                status: 'skipped',
+                source: input.source,
+                deletedChunks: 0,
+                reason: 'vector_index_unavailable',
+            };
+        }
+        const deletedChunks = await this.options.rdfEngine.deleteVectorSource(input.source);
+        return {
+            status: 'deleted',
+            source: input.source,
+            deletedChunks,
+        };
+    }
+    sourceWithHash(source, text) {
+        if (source.sourceHash || text === undefined) {
+            return source;
+        }
+        return {
+            ...source,
+            sourceHash: (0, node_crypto_1.createHash)('sha256').update(text).digest('hex'),
+        };
+    }
+    textChunks(source, input) {
+        const chunks = input.chunks ?? (input.text !== undefined ? (0, RdfTextIndex_1.chunkRdfTextSource)(source, input.text) : []);
+        const maxChunks = this.options.maxChunks;
+        const filtered = chunks.filter((chunk) => chunk.content.trim().length > 0);
+        return maxChunks && maxChunks > 0 ? filtered.slice(0, maxChunks) : filtered;
+    }
+    embeddingInputs(source, chunks) {
+        const kinds = this.embeddingInputKinds();
+        const inputs = [];
+        for (const chunk of chunks) {
+            for (const kind of kinds) {
+                const content = this.embeddingInputContent(source, chunk, kind);
+                if (!content) {
+                    continue;
+                }
+                inputs.push({
+                    kind,
+                    chunk,
+                    content,
+                    inputHash: (0, node_crypto_1.createHash)('sha256').update(content).digest('hex'),
+                });
+            }
+        }
+        return inputs;
+    }
+    embeddingInputKinds() {
+        const configured = this.options.embeddingInputKinds?.length
+            ? this.options.embeddingInputKinds
+            : DEFAULT_EMBEDDING_INPUT_KINDS;
+        return [...new Set(configured)];
+    }
+    projectionPolicyVersion() {
+        return this.options.projectionPolicyVersion ?? DEFAULT_PROJECTION_POLICY_VERSION;
+    }
+    embeddingInputContent(source, chunk, kind) {
+        if (kind === 'semantic') {
+            return chunk.content.trim();
+        }
+        const sections = [];
+        const path = source.localPath?.split(/[\\/]+/).filter(Boolean).join(' / ');
+        if (path) {
+            sections.push(`Path: ${path}`);
+        }
+        const headingPath = chunk.path?.length ? chunk.path : (chunk.heading ? [chunk.heading] : []);
+        if (headingPath.length > 0) {
+            sections.push(`Heading: ${headingPath.join(' / ')}`);
+        }
+        return sections.join('\n').trim();
+    }
+    async resolveEmbeddingInputBudget(source, inputs) {
+        const maxChars = this.options.maxEmbeddingInputChars;
+        if (!maxChars || maxChars <= 0) {
+            return { accepted: inputs, skipped: [], summarized: [] };
+        }
+        const accepted = [];
+        const skipped = [];
+        const summarized = [];
+        for (const input of inputs) {
+            if (input.content.length > maxChars) {
+                const summary = await this.summarizeEmbeddingInput(source, input, maxChars);
+                if ('input' in summary) {
+                    accepted.push(summary.input);
+                    summarized.push(summary.summary);
+                }
+                else {
+                    skipped.push(summary.skipped);
+                }
+            }
+            else {
+                accepted.push(input);
+            }
+        }
+        return { accepted, skipped, summarized };
+    }
+    async summarizeEmbeddingInput(source, input, maxChars) {
+        const service = this.options.summaryService;
+        if (!service) {
+            return { skipped: this.skippedEmbeddingInput(input, maxChars, 'input_too_large') };
+        }
+        const promptVersion = this.options.summaryPromptVersion ?? DEFAULT_SUMMARY_PROMPT_VERSION;
+        let result;
+        try {
+            result = await service.summarize({
+                content: input.content,
+                inputKind: input.kind,
+                chunkKey: input.chunk.chunkKey,
+                sourceHash: source.sourceHash,
+                maxChars,
+                promptVersion,
+            });
+        }
+        catch (error) {
+            return {
+                skipped: this.skippedEmbeddingInput(input, maxChars, 'summary_failed', error instanceof Error ? error.message : String(error)),
+            };
+        }
+        const content = result.content.trim();
+        if (!content || content.length > maxChars) {
+            return {
+                skipped: this.skippedEmbeddingInput(input, maxChars, 'summary_too_large', undefined, content.length),
+            };
+        }
+        const rounds = result.rounds ?? 1;
+        const summaryMetadata = {
+            status: 'summarized',
+            provider: result.provider,
+            model: result.model,
+            promptVersion: result.promptVersion ?? promptVersion,
+            ...(source.sourceHash ? { sourceHash: source.sourceHash } : {}),
+            originalChars: input.content.length,
+            summaryChars: content.length,
+            rounds,
+        };
+        return {
+            input: {
+                ...input,
+                content,
+                inputHash: (0, node_crypto_1.createHash)('sha256').update(content).digest('hex'),
+                summaryMetadata,
+            },
+            summary: {
+                chunkKey: input.chunk.chunkKey,
+                inputKind: input.kind,
+                originalChars: input.content.length,
+                summaryChars: content.length,
+                rounds,
+            },
+        };
+    }
+    skippedEmbeddingInput(input, maxChars, reason, message, summaryChars) {
+        return {
+            chunkKey: input.chunk.chunkKey,
+            inputKind: input.kind,
+            reason,
+            inputChars: input.content.length,
+            maxChars,
+            ...(summaryChars !== undefined ? { summaryChars } : {}),
+            ...(message ? { message } : {}),
+        };
+    }
+    indexedResult(source, model, chunkCount, skippedInputs, summarizedInputs = []) {
+        return {
+            status: 'indexed',
+            source,
+            ...(model ? { model } : {}),
+            chunkCount,
+            ...(skippedInputs.length > 0 ? { skippedInputs } : {}),
+            ...(summarizedInputs.length > 0 ? { summarizedInputs } : {}),
+        };
+    }
+}
+exports.RdfSearchIndexingService = RdfSearchIndexingService;
+//# sourceMappingURL=RdfSearchIndexingService.js.map