@absolutejs/voice 0.0.22-beta.369 → 0.0.22-beta.370

package/README.md

@@ -1486,6 +1486,22 @@ app.use(
 
 The point is not to benchmark a fake demo once. The point is to let every real call add profile evidence so `/api/voice/real-call-profile-history`, provider recommendations, profile-switch readiness, and operations records can explain which provider/runtime path is winning for each call shape.
 
+Use `buildVoiceRealCallProfileReadinessCheck(...)` to make that history deploy-blocking through `createVoiceProductionReadinessRoutes(...)`:
+
+```ts
+createVoiceProductionReadinessRoutes({
+	additionalChecks: async () => [
+		buildVoiceRealCallProfileReadinessCheck(await buildRealCallHistory(), {
+			minActionableProfiles: 2,
+			minCycles: 10,
+			requiredProfileIds: ['meeting-recorder', 'support-agent'],
+			requiredProviderRoles: ['llm', 'stt', 'tts']
+		})
+	],
+	store: runtime.traces
+});
+```
+
 Use `createVoiceProfileTraceTagger(...)` when the app already has a trace store and needs every appended trace to carry a benchmark profile label. It wraps any `VoiceTraceEventStore`, preserves the underlying store behavior, and adds `profileId`/`benchmarkProfileId` metadata and payload fields that real-call profile history can ingest later.
 
 ```ts

package/dist/client/index.js

@@ -4506,6 +4506,81 @@ var expandProviderRouteCandidates = (provider, role, aliases = {}) => {
   ];
 };
 var readRealCallProfileDefaultsReport = (input) => ("defaults" in input) ? input.defaults : input;
+var buildRealCallProfileReadinessIssues = (report, options) => {
+  const minProfiles = options.minProfiles ?? 1;
+  const minActionableProfiles = options.minActionableProfiles ?? 1;
+  const minCycles = options.minCycles ?? 1;
+  const requiredProviderRoles = options.requiredProviderRoles ?? [];
+  const defaultsByProfile = new Map(report.defaults.profiles.map((profile) => [profile.profileId, profile]));
+  const issues = [];
+  const warnings = [];
+  if (report.status === "fail" || report.ok !== true) {
+    issues.push(`Real-call profile history is ${report.status}.`);
+  }
+  if ((report.summary.profileCount ?? 0) < minProfiles) {
+    issues.push(`Expected at least ${String(minProfiles)} real-call profile(s), found ${String(report.summary.profileCount ?? 0)}.`);
+  }
+  if (report.defaults.summary.actionableProfiles < minActionableProfiles) {
+    issues.push(`Expected at least ${String(minActionableProfiles)} actionable profile default(s), found ${String(report.defaults.summary.actionableProfiles)}.`);
+  }
+  if ((report.summary.cycles ?? 0) < minCycles) {
+    issues.push(`Expected at least ${String(minCycles)} real-call cycle(s), found ${String(report.summary.cycles ?? 0)}.`);
+  }
+  const ageMs = report.trend.ageMs ?? (report.generatedAt ? Date.now() - new Date(report.generatedAt).getTime() : undefined);
+  if (options.maxAgeMs !== undefined && (ageMs === undefined || ageMs > options.maxAgeMs)) {
+    issues.push(`Expected real-call profile history age <= ${String(options.maxAgeMs)}ms, found ${String(ageMs ?? "missing")}ms.`);
+  }
+  for (const profileId of options.requiredProfileIds ?? []) {
+    const profile = defaultsByProfile.get(profileId);
+    if (!profile) {
+      issues.push(`Missing required real-call profile: ${profileId}.`);
+      continue;
+    }
+    if (profile.status === "fail") {
+      issues.push(`Required real-call profile ${profileId} is failing.`);
+    } else if (profile.status === "warn") {
+      warnings.push(`Required real-call profile ${profileId} is warning.`);
+    }
+    for (const role of requiredProviderRoles) {
+      if (!profile.providerRoutes[role]) {
+        warnings.push(`Required real-call profile ${profileId} is missing ${role} provider default evidence.`);
+      }
+    }
+  }
+  if (report.recommendations.profiles.some((item) => item.status === "fail")) {
+    issues.push("At least one real-call profile recommendation is failing.");
+  }
+  if (report.recommendations.profiles.some((item) => item.status === "warn")) {
+    warnings.push("At least one real-call profile recommendation is warning.");
+  }
+  return { issues, warnings };
+};
+var buildVoiceRealCallProfileReadinessCheck = (report, options = {}) => {
+  const { issues, warnings } = buildRealCallProfileReadinessIssues(report, options);
+  const status = issues.length > 0 ? "fail" : warnings.length > 0 && options.failOnWarnings === true ? "fail" : warnings.length > 0 ? "warn" : "pass";
+  const detail = status === "pass" ? `${String(report.summary.profileCount)} profile(s), ${String(report.summary.cycles ?? 0)} cycle(s), ${String(report.defaults.summary.actionableProfiles)} actionable default(s).` : [...issues, ...warnings].join(" ");
+  return {
+    detail,
+    gateExplanation: {
+      evidenceHref: options.href ?? "/api/voice/real-call-profile-history",
+      observed: report.defaults.summary.actionableProfiles,
+      remediation: "Run fresh browser or phone calls for required profiles so provider/runtime recommendations have measured profile evidence.",
+      sourceHref: options.sourceHref ?? "/voice/real-call-profile-history",
+      threshold: options.minActionableProfiles ?? 1,
+      thresholdLabel: "Minimum actionable real-call profiles",
+      unit: "count"
+    },
+    href: options.href ?? "/voice/real-call-profile-history",
+    label: options.label ?? "Real-call profile history",
+    proofSource: {
+      href: options.sourceHref ?? "/api/voice/real-call-profile-history",
+      source: report.source,
+      sourceLabel: "Real-call profile history"
+    },
+    status,
+    value: `${String(report.defaults.summary.actionableProfiles)}/${String(report.summary.profileCount)} actionable`
+  };
+};
 var resolveVoiceRealCallProfileProviderRoute = (options) => {
   const defaults = readRealCallProfileDefaultsReport(options.defaults);
   const profile = defaults.profiles.find((item) => item.profileId === options.profileId) ?? defaults.profiles.find((item) => item.status === "pass") ?? defaults.profiles[0];

package/dist/index.d.ts

@@ -30,12 +30,12 @@ export { assertVoicePlatformCoverage, buildVoicePlatformCoverageSummary, createV
 export { assertVoiceCompetitiveCoverage, buildVoiceCompetitiveCoverageReport, createVoiceCompetitiveCoverageRoutes, evaluateVoiceCompetitiveCoverage, renderVoiceCompetitiveCoverageHTML, renderVoiceCompetitiveCoverageMarkdown } from './competitiveCoverage';
 export type { VoiceCompetitiveCoverageAssertionInput, VoiceCompetitiveCoverageAssertionReport, VoiceCompetitiveCoverageIssue, VoiceCompetitiveCoverageLevel, VoiceCompetitiveCoverageReport, VoiceCompetitiveCoverageReportInput, VoiceCompetitiveCoverageRoutesOptions, VoiceCompetitiveCoverageStatus, VoiceCompetitiveCoverageSummary, VoiceCompetitiveDepthLevel, VoiceCompetitiveEvidence, VoiceCompetitiveSurface } from './competitiveCoverage';
 export type { VoicePlatformCoverageAssertionInput, VoicePlatformCoverageAssertionReport, VoicePlatformCoverageEvidence, VoicePlatformCoverageRoutesOptions, VoicePlatformCoverageStatus, VoicePlatformCoverageSummary, VoicePlatformCoverageSummaryInput, VoicePlatformCoverageSurface } from './platformCoverage';
-export { assertVoiceProofTrendEvidence, buildEmptyVoiceProofTrendReport, buildVoiceProofTrendProfileSummaries, buildVoiceProofTrendRecommendationReport, buildVoiceProofTrendReportFromRealCallProfiles, buildVoiceProofTrendReport, buildVoiceRealCallProfileEvidenceFromTraceEvents, buildVoiceRealCallProfileDefaults, buildVoiceRealCallProfileHistoryReport, createVoiceProofTrendRecommendationRoutes, createVoiceProofTrendRoutes, createVoiceRealCallProfileHistoryRoutes, DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS, DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS, evaluateVoiceProofTrendEvidence, formatVoiceProofTrendAge, loadVoiceRealCallProfileEvidenceFromTraceStore, normalizeVoiceProofTrendReport, readVoiceProofTrendReportFile, renderVoiceProofTrendRecommendationHTML, renderVoiceProofTrendRecommendationMarkdown, renderVoiceRealCallProfileHistoryHTML, renderVoiceRealCallProfileHistoryMarkdown, resolveVoiceRealCallProfileProviderRoute } from './proofTrends';
+export { assertVoiceProofTrendEvidence, buildEmptyVoiceProofTrendReport, buildVoiceProofTrendProfileSummaries, buildVoiceProofTrendRecommendationReport, buildVoiceProofTrendReportFromRealCallProfiles, buildVoiceProofTrendReport, buildVoiceRealCallProfileEvidenceFromTraceEvents, buildVoiceRealCallProfileDefaults, buildVoiceRealCallProfileHistoryReport, buildVoiceRealCallProfileReadinessCheck, createVoiceProofTrendRecommendationRoutes, createVoiceProofTrendRoutes, createVoiceRealCallProfileHistoryRoutes, DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS, DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS, evaluateVoiceProofTrendEvidence, formatVoiceProofTrendAge, loadVoiceRealCallProfileEvidenceFromTraceStore, normalizeVoiceProofTrendReport, readVoiceProofTrendReportFile, renderVoiceProofTrendRecommendationHTML, renderVoiceProofTrendRecommendationMarkdown, renderVoiceRealCallProfileHistoryHTML, renderVoiceRealCallProfileHistoryMarkdown, resolveVoiceRealCallProfileProviderRoute } from './proofTrends';
 export { applyVoiceProfileSwitchGuard, buildVoiceProfileSwitchReadinessReport, buildVoiceProfileSwitchLiveDecisionReport, createVoiceProfileSwitchLiveDecisionRoutes, createVoiceProfileSwitchPolicyProofRoutes, createVoiceProfileSwitchReadinessRoutes, recommendVoiceProfileSwitch, renderVoiceProfileSwitchLiveDecisionHTML, renderVoiceProfileSwitchPolicyProofHTML, renderVoiceProfileSwitchReadinessHTML, runVoiceProfileSwitchPolicyProof } from './profileSwitchRecommendation';
 export type { VoiceProfileSwitchGuardAction, VoiceProfileSwitchGuardDecision, VoiceProfileSwitchGuardMode, VoiceProfileSwitchGuardOptions, VoiceProfileSwitchObservedSignals, VoiceProfileSwitchLiveDecisionEvidence, VoiceProfileSwitchLiveDecisionReport, VoiceProfileSwitchLiveDecisionReportOptions, VoiceProfileSwitchLiveDecisionRoutesOptions, VoiceProfileSwitchLiveDecisionSession, VoiceProfileSwitchPolicyProofCase, VoiceProfileSwitchPolicyProofCaseResult, VoiceProfileSwitchPolicyProofOptions, VoiceProfileSwitchPolicyProofReport, VoiceProfileSwitchPolicyProofRoutesOptions, VoiceProfileSwitchReadinessIssue, VoiceProfileSwitchReadinessOptions, VoiceProfileSwitchReadinessReport, VoiceProfileSwitchReadinessRoutesOptions, VoiceProfileSwitchReadinessStatus, VoiceProfileSwitchRecommendation, VoiceProfileSwitchRecommendationOptions } from './profileSwitchRecommendation';
 export { buildVoiceProviderDecisionTraceReport, createVoiceProviderDecisionTraceEvent, createVoiceProviderDecisionTraceRoutes, listVoiceProviderDecisionTraces, renderVoiceProviderDecisionTraceHTML, renderVoiceProviderDecisionTraceMarkdown } from './providerDecisionTraces';
 export type { VoiceProviderDecisionStatus, VoiceProviderDecisionSurfaceReport, VoiceProviderDecisionTrace, VoiceProviderDecisionTraceInput, VoiceProviderDecisionTraceIssue, VoiceProviderDecisionTraceReport, VoiceProviderDecisionTraceReportOptions, VoiceProviderDecisionTraceRoutesOptions } from './providerDecisionTraces';
-export type { VoiceProofTrendAssertionInput, VoiceProofTrendAssertionReport, VoiceProofTrendCycle, VoiceProofTrendProfileDefinition, VoiceProofTrendProfileRecommendation, VoiceProofTrendProfileSummaryOptions, VoiceProofTrendProfileSummary, VoiceProofTrendProviderRecommendation, VoiceProofTrendProviderSummary, VoiceProofTrendRecommendation, VoiceProofTrendRecommendationOptions, VoiceProofTrendRecommendationReport, VoiceProofTrendRecommendationRoutesOptions, VoiceProofTrendRecommendationStatus, VoiceProofTrendRecommendationSurface, VoiceProofTrendRealCallProfileEvidence, VoiceProofTrendRealCallProfileReportOptions, VoiceProofTrendReport, VoiceProofTrendReportInput, VoiceProofTrendRoutesOptions, VoiceProofTrendRuntimeChannelSummary, VoiceProofTrendStatus, VoiceProofTrendSummary, VoiceRealCallProfileDefault, VoiceRealCallProfileDefaultsOptions, VoiceRealCallProfileDefaultsReport, VoiceRealCallProfileHistoryOptions, VoiceRealCallProfileHistoryReport, VoiceRealCallProfileHistoryRoutesOptions, VoiceRealCallProfileProviderRouteOptions, VoiceRealCallProfileTraceEvidenceOptions, VoiceRealCallProfileTraceStoreEvidenceOptions } from './proofTrends';
+export type { VoiceProofTrendAssertionInput, VoiceProofTrendAssertionReport, VoiceProofTrendCycle, VoiceProofTrendProfileDefinition, VoiceProofTrendProfileRecommendation, VoiceProofTrendProfileSummaryOptions, VoiceProofTrendProfileSummary, VoiceProofTrendProviderRecommendation, VoiceProofTrendProviderSummary, VoiceProofTrendRecommendation, VoiceProofTrendRecommendationOptions, VoiceProofTrendRecommendationReport, VoiceProofTrendRecommendationRoutesOptions, VoiceProofTrendRecommendationStatus, VoiceProofTrendRecommendationSurface, VoiceProofTrendRealCallProfileEvidence, VoiceProofTrendRealCallProfileReportOptions, VoiceProofTrendReport, VoiceProofTrendReportInput, VoiceProofTrendRoutesOptions, VoiceProofTrendRuntimeChannelSummary, VoiceProofTrendStatus, VoiceProofTrendSummary, VoiceRealCallProfileDefault, VoiceRealCallProfileDefaultsOptions, VoiceRealCallProfileDefaultsReport, VoiceRealCallProfileHistoryOptions, VoiceRealCallProfileHistoryReport, VoiceRealCallProfileHistoryRoutesOptions, VoiceRealCallProfileProviderRouteOptions, VoiceRealCallProfileReadinessCheckOptions, VoiceRealCallProfileTraceEvidenceOptions, VoiceRealCallProfileTraceStoreEvidenceOptions } from './proofTrends';
 export { assertVoiceSloCalibration, buildVoiceSloCalibrationReport, buildVoiceSloReadinessThresholdReport, createVoiceSloReadinessThresholdOptions, createVoiceSloReadinessThresholdRoutes, createVoiceSloThresholdProfile, createVoiceSloCalibrationRoutes, renderVoiceSloCalibrationMarkdown, renderVoiceSloReadinessThresholdHTML, renderVoiceSloReadinessThresholdMarkdown } from './sloCalibration';
 export type { VoiceSloCalibrationMetricKey, VoiceSloCalibrationOptions, VoiceSloCalibrationReport, VoiceSloCalibrationRoutesOptions, VoiceSloCalibrationSample, VoiceSloCalibrationStatus, VoiceSloCalibrationThreshold, VoiceSloCalibrationThresholds, VoiceSloReadinessThresholdReport, VoiceSloReadinessThresholdReportOptions, VoiceSloReadinessThresholdOptions, VoiceSloReadinessThresholdRoutesOptions, VoiceSloThresholdProfile } from './sloCalibration';
 export { assertVoiceLiveOpsControlEvidence, assertVoiceLiveOpsEvidence, buildVoiceLiveOpsControlState, createVoiceLiveOpsController, createVoiceLiveOpsRoutes, createVoiceMemoryLiveOpsControlStore, evaluateVoiceLiveOpsControlEvidence, evaluateVoiceLiveOpsEvidence, getVoiceLiveOpsControlStatus, VOICE_LIVE_OPS_ACTIONS } from './liveOps';

package/dist/index.js

@@ -15975,6 +15975,81 @@ var expandProviderRouteCandidates = (provider, role, aliases = {}) => {
   ];
 };
 var readRealCallProfileDefaultsReport = (input) => ("defaults" in input) ? input.defaults : input;
+var buildRealCallProfileReadinessIssues = (report, options) => {
+  const minProfiles = options.minProfiles ?? 1;
+  const minActionableProfiles = options.minActionableProfiles ?? 1;
+  const minCycles = options.minCycles ?? 1;
+  const requiredProviderRoles = options.requiredProviderRoles ?? [];
+  const defaultsByProfile = new Map(report.defaults.profiles.map((profile) => [profile.profileId, profile]));
+  const issues = [];
+  const warnings = [];
+  if (report.status === "fail" || report.ok !== true) {
+    issues.push(`Real-call profile history is ${report.status}.`);
+  }
+  if ((report.summary.profileCount ?? 0) < minProfiles) {
+    issues.push(`Expected at least ${String(minProfiles)} real-call profile(s), found ${String(report.summary.profileCount ?? 0)}.`);
+  }
+  if (report.defaults.summary.actionableProfiles < minActionableProfiles) {
+    issues.push(`Expected at least ${String(minActionableProfiles)} actionable profile default(s), found ${String(report.defaults.summary.actionableProfiles)}.`);
+  }
+  if ((report.summary.cycles ?? 0) < minCycles) {
+    issues.push(`Expected at least ${String(minCycles)} real-call cycle(s), found ${String(report.summary.cycles ?? 0)}.`);
+  }
+  const ageMs = report.trend.ageMs ?? (report.generatedAt ? Date.now() - new Date(report.generatedAt).getTime() : undefined);
+  if (options.maxAgeMs !== undefined && (ageMs === undefined || ageMs > options.maxAgeMs)) {
+    issues.push(`Expected real-call profile history age <= ${String(options.maxAgeMs)}ms, found ${String(ageMs ?? "missing")}ms.`);
+  }
+  for (const profileId of options.requiredProfileIds ?? []) {
+    const profile = defaultsByProfile.get(profileId);
+    if (!profile) {
+      issues.push(`Missing required real-call profile: ${profileId}.`);
+      continue;
+    }
+    if (profile.status === "fail") {
+      issues.push(`Required real-call profile ${profileId} is failing.`);
+    } else if (profile.status === "warn") {
+      warnings.push(`Required real-call profile ${profileId} is warning.`);
+    }
+    for (const role of requiredProviderRoles) {
+      if (!profile.providerRoutes[role]) {
+        warnings.push(`Required real-call profile ${profileId} is missing ${role} provider default evidence.`);
+      }
+    }
+  }
+  if (report.recommendations.profiles.some((item) => item.status === "fail")) {
+    issues.push("At least one real-call profile recommendation is failing.");
+  }
+  if (report.recommendations.profiles.some((item) => item.status === "warn")) {
+    warnings.push("At least one real-call profile recommendation is warning.");
+  }
+  return { issues, warnings };
+};
+var buildVoiceRealCallProfileReadinessCheck = (report, options = {}) => {
+  const { issues, warnings } = buildRealCallProfileReadinessIssues(report, options);
+  const status = issues.length > 0 ? "fail" : warnings.length > 0 && options.failOnWarnings === true ? "fail" : warnings.length > 0 ? "warn" : "pass";
+  const detail = status === "pass" ? `${String(report.summary.profileCount)} profile(s), ${String(report.summary.cycles ?? 0)} cycle(s), ${String(report.defaults.summary.actionableProfiles)} actionable default(s).` : [...issues, ...warnings].join(" ");
+  return {
+    detail,
+    gateExplanation: {
+      evidenceHref: options.href ?? "/api/voice/real-call-profile-history",
+      observed: report.defaults.summary.actionableProfiles,
+      remediation: "Run fresh browser or phone calls for required profiles so provider/runtime recommendations have measured profile evidence.",
+      sourceHref: options.sourceHref ?? "/voice/real-call-profile-history",
+      threshold: options.minActionableProfiles ?? 1,
+      thresholdLabel: "Minimum actionable real-call profiles",
+      unit: "count"
+    },
+    href: options.href ?? "/voice/real-call-profile-history",
+    label: options.label ?? "Real-call profile history",
+    proofSource: {
+      href: options.sourceHref ?? "/api/voice/real-call-profile-history",
+      source: report.source,
+      sourceLabel: "Real-call profile history"
+    },
+    status,
+    value: `${String(report.defaults.summary.actionableProfiles)}/${String(report.summary.profileCount)} actionable`
+  };
+};
 var resolveVoiceRealCallProfileProviderRoute = (options) => {
   const defaults = readRealCallProfileDefaultsReport(options.defaults);
   const profile = defaults.profiles.find((item) => item.profileId === options.profileId) ?? defaults.profiles.find((item) => item.status === "pass") ?? defaults.profiles[0];
@@ -38832,6 +38907,7 @@ export {
   buildVoiceRealtimeProviderContractMatrix,
   buildVoiceRealtimeChannelRuntimeSamplesFromTrace,
   buildVoiceRealtimeChannelReport,
+  buildVoiceRealCallProfileReadinessCheck,
   buildVoiceRealCallProfileHistoryReport,
   buildVoiceRealCallProfileEvidenceFromTraceEvents,
   buildVoiceRealCallProfileDefaults,

package/dist/proofTrends.d.ts

@@ -1,4 +1,5 @@
 import { Elysia } from 'elysia';
+import type { VoiceProductionReadinessCheck } from './productionReadiness';
 import type { StoredVoiceTraceEvent, VoiceTraceEventStore } from './trace';
 export type VoiceProofTrendStatus = 'empty' | 'fail' | 'pass' | 'stale';
 export type VoiceProofTrendSummary = {
@@ -355,6 +356,18 @@ export type VoiceRealCallProfileHistoryRoutesOptions = Omit<VoiceRealCallProfile
     source?: (() => Promise<VoiceRealCallProfileHistoryOptions> | VoiceRealCallProfileHistoryOptions) | VoiceRealCallProfileHistoryOptions;
     title?: string;
 };
+export type VoiceRealCallProfileReadinessCheckOptions = {
+    failOnWarnings?: boolean;
+    href?: string;
+    label?: string;
+    maxAgeMs?: number;
+    minActionableProfiles?: number;
+    minCycles?: number;
+    minProfiles?: number;
+    requiredProfileIds?: readonly string[];
+    requiredProviderRoles?: readonly string[];
+    sourceHref?: string;
+};
 export declare const DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS: number;
 export declare const DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS: ({
     description: string;
@@ -388,6 +401,7 @@ export declare const loadVoiceRealCallProfileEvidenceFromTraceStore: (options: V
 export declare const buildVoiceProofTrendProfileSummaries: (input: VoiceProofTrendReport | readonly VoiceProofTrendReport[], options?: VoiceProofTrendProfileSummaryOptions) => VoiceProofTrendProfileSummary[];
 export declare const buildVoiceProofTrendReportFromRealCallProfiles: (options: VoiceProofTrendRealCallProfileReportOptions) => VoiceProofTrendReport;
 export declare const buildVoiceRealCallProfileDefaults: (input: VoiceRealCallProfileHistoryReport | VoiceProofTrendReport, options?: VoiceRealCallProfileDefaultsOptions) => VoiceRealCallProfileDefaultsReport;
+export declare const buildVoiceRealCallProfileReadinessCheck: (report: VoiceRealCallProfileHistoryReport, options?: VoiceRealCallProfileReadinessCheckOptions) => VoiceProductionReadinessCheck;
 export declare const resolveVoiceRealCallProfileProviderRoute: <TProvider extends string = string>(options: VoiceRealCallProfileProviderRouteOptions<TProvider>) => TProvider | undefined;
 export declare const buildVoiceRealCallProfileHistoryReport: (options?: VoiceRealCallProfileHistoryOptions) => VoiceRealCallProfileHistoryReport;
 export declare const evaluateVoiceProofTrendEvidence: (report: VoiceProofTrendReport, input?: VoiceProofTrendAssertionInput) => VoiceProofTrendAssertionReport;

package/dist/react/index.js

@@ -2093,6 +2093,81 @@ var expandProviderRouteCandidates = (provider, role, aliases = {}) => {
   ];
 };
 var readRealCallProfileDefaultsReport = (input) => ("defaults" in input) ? input.defaults : input;
+var buildRealCallProfileReadinessIssues = (report, options) => {
+  const minProfiles = options.minProfiles ?? 1;
+  const minActionableProfiles = options.minActionableProfiles ?? 1;
+  const minCycles = options.minCycles ?? 1;
+  const requiredProviderRoles = options.requiredProviderRoles ?? [];
+  const defaultsByProfile = new Map(report.defaults.profiles.map((profile) => [profile.profileId, profile]));
+  const issues = [];
+  const warnings = [];
+  if (report.status === "fail" || report.ok !== true) {
+    issues.push(`Real-call profile history is ${report.status}.`);
+  }
+  if ((report.summary.profileCount ?? 0) < minProfiles) {
+    issues.push(`Expected at least ${String(minProfiles)} real-call profile(s), found ${String(report.summary.profileCount ?? 0)}.`);
+  }
+  if (report.defaults.summary.actionableProfiles < minActionableProfiles) {
+    issues.push(`Expected at least ${String(minActionableProfiles)} actionable profile default(s), found ${String(report.defaults.summary.actionableProfiles)}.`);
+  }
+  if ((report.summary.cycles ?? 0) < minCycles) {
+    issues.push(`Expected at least ${String(minCycles)} real-call cycle(s), found ${String(report.summary.cycles ?? 0)}.`);
+  }
+  const ageMs = report.trend.ageMs ?? (report.generatedAt ? Date.now() - new Date(report.generatedAt).getTime() : undefined);
+  if (options.maxAgeMs !== undefined && (ageMs === undefined || ageMs > options.maxAgeMs)) {
+    issues.push(`Expected real-call profile history age <= ${String(options.maxAgeMs)}ms, found ${String(ageMs ?? "missing")}ms.`);
+  }
+  for (const profileId of options.requiredProfileIds ?? []) {
+    const profile = defaultsByProfile.get(profileId);
+    if (!profile) {
+      issues.push(`Missing required real-call profile: ${profileId}.`);
+      continue;
+    }
+    if (profile.status === "fail") {
+      issues.push(`Required real-call profile ${profileId} is failing.`);
+    } else if (profile.status === "warn") {
+      warnings.push(`Required real-call profile ${profileId} is warning.`);
+    }
+    for (const role of requiredProviderRoles) {
+      if (!profile.providerRoutes[role]) {
+        warnings.push(`Required real-call profile ${profileId} is missing ${role} provider default evidence.`);
+      }
+    }
+  }
+  if (report.recommendations.profiles.some((item) => item.status === "fail")) {
+    issues.push("At least one real-call profile recommendation is failing.");
+  }
+  if (report.recommendations.profiles.some((item) => item.status === "warn")) {
+    warnings.push("At least one real-call profile recommendation is warning.");
+  }
+  return { issues, warnings };
+};
+var buildVoiceRealCallProfileReadinessCheck = (report, options = {}) => {
+  const { issues, warnings } = buildRealCallProfileReadinessIssues(report, options);
+  const status = issues.length > 0 ? "fail" : warnings.length > 0 && options.failOnWarnings === true ? "fail" : warnings.length > 0 ? "warn" : "pass";
+  const detail = status === "pass" ? `${String(report.summary.profileCount)} profile(s), ${String(report.summary.cycles ?? 0)} cycle(s), ${String(report.defaults.summary.actionableProfiles)} actionable default(s).` : [...issues, ...warnings].join(" ");
+  return {
+    detail,
+    gateExplanation: {
+      evidenceHref: options.href ?? "/api/voice/real-call-profile-history",
+      observed: report.defaults.summary.actionableProfiles,
+      remediation: "Run fresh browser or phone calls for required profiles so provider/runtime recommendations have measured profile evidence.",
+      sourceHref: options.sourceHref ?? "/voice/real-call-profile-history",
+      threshold: options.minActionableProfiles ?? 1,
+      thresholdLabel: "Minimum actionable real-call profiles",
+      unit: "count"
+    },
+    href: options.href ?? "/voice/real-call-profile-history",
+    label: options.label ?? "Real-call profile history",
+    proofSource: {
+      href: options.sourceHref ?? "/api/voice/real-call-profile-history",
+      source: report.source,
+      sourceLabel: "Real-call profile history"
+    },
+    status,
+    value: `${String(report.defaults.summary.actionableProfiles)}/${String(report.summary.profileCount)} actionable`
+  };
+};
 var resolveVoiceRealCallProfileProviderRoute = (options) => {
   const defaults = readRealCallProfileDefaultsReport(options.defaults);
   const profile = defaults.profiles.find((item) => item.profileId === options.profileId) ?? defaults.profiles.find((item) => item.status === "pass") ?? defaults.profiles[0];

package/dist/vue/index.js

@@ -2014,6 +2014,81 @@ var expandProviderRouteCandidates = (provider, role, aliases = {}) => {
   ];
 };
 var readRealCallProfileDefaultsReport = (input) => ("defaults" in input) ? input.defaults : input;
+var buildRealCallProfileReadinessIssues = (report, options) => {
+  const minProfiles = options.minProfiles ?? 1;
+  const minActionableProfiles = options.minActionableProfiles ?? 1;
+  const minCycles = options.minCycles ?? 1;
+  const requiredProviderRoles = options.requiredProviderRoles ?? [];
+  const defaultsByProfile = new Map(report.defaults.profiles.map((profile) => [profile.profileId, profile]));
+  const issues = [];
+  const warnings = [];
+  if (report.status === "fail" || report.ok !== true) {
+    issues.push(`Real-call profile history is ${report.status}.`);
+  }
+  if ((report.summary.profileCount ?? 0) < minProfiles) {
+    issues.push(`Expected at least ${String(minProfiles)} real-call profile(s), found ${String(report.summary.profileCount ?? 0)}.`);
+  }
+  if (report.defaults.summary.actionableProfiles < minActionableProfiles) {
+    issues.push(`Expected at least ${String(minActionableProfiles)} actionable profile default(s), found ${String(report.defaults.summary.actionableProfiles)}.`);
+  }
+  if ((report.summary.cycles ?? 0) < minCycles) {
+    issues.push(`Expected at least ${String(minCycles)} real-call cycle(s), found ${String(report.summary.cycles ?? 0)}.`);
+  }
+  const ageMs = report.trend.ageMs ?? (report.generatedAt ? Date.now() - new Date(report.generatedAt).getTime() : undefined);
+  if (options.maxAgeMs !== undefined && (ageMs === undefined || ageMs > options.maxAgeMs)) {
+    issues.push(`Expected real-call profile history age <= ${String(options.maxAgeMs)}ms, found ${String(ageMs ?? "missing")}ms.`);
+  }
+  for (const profileId of options.requiredProfileIds ?? []) {
+    const profile = defaultsByProfile.get(profileId);
+    if (!profile) {
+      issues.push(`Missing required real-call profile: ${profileId}.`);
+      continue;
+    }
+    if (profile.status === "fail") {
+      issues.push(`Required real-call profile ${profileId} is failing.`);
+    } else if (profile.status === "warn") {
+      warnings.push(`Required real-call profile ${profileId} is warning.`);
+    }
+    for (const role of requiredProviderRoles) {
+      if (!profile.providerRoutes[role]) {
+        warnings.push(`Required real-call profile ${profileId} is missing ${role} provider default evidence.`);
+      }
+    }
+  }
+  if (report.recommendations.profiles.some((item) => item.status === "fail")) {
+    issues.push("At least one real-call profile recommendation is failing.");
+  }
+  if (report.recommendations.profiles.some((item) => item.status === "warn")) {
+    warnings.push("At least one real-call profile recommendation is warning.");
+  }
+  return { issues, warnings };
+};
+var buildVoiceRealCallProfileReadinessCheck = (report, options = {}) => {
+  const { issues, warnings } = buildRealCallProfileReadinessIssues(report, options);
+  const status = issues.length > 0 ? "fail" : warnings.length > 0 && options.failOnWarnings === true ? "fail" : warnings.length > 0 ? "warn" : "pass";
+  const detail = status === "pass" ? `${String(report.summary.profileCount)} profile(s), ${String(report.summary.cycles ?? 0)} cycle(s), ${String(report.defaults.summary.actionableProfiles)} actionable default(s).` : [...issues, ...warnings].join(" ");
+  return {
+    detail,
+    gateExplanation: {
+      evidenceHref: options.href ?? "/api/voice/real-call-profile-history",
+      observed: report.defaults.summary.actionableProfiles,
+      remediation: "Run fresh browser or phone calls for required profiles so provider/runtime recommendations have measured profile evidence.",
+      sourceHref: options.sourceHref ?? "/voice/real-call-profile-history",
+      threshold: options.minActionableProfiles ?? 1,
+      thresholdLabel: "Minimum actionable real-call profiles",
+      unit: "count"
+    },
+    href: options.href ?? "/voice/real-call-profile-history",
+    label: options.label ?? "Real-call profile history",
+    proofSource: {
+      href: options.sourceHref ?? "/api/voice/real-call-profile-history",
+      source: report.source,
+      sourceLabel: "Real-call profile history"
+    },
+    status,
+    value: `${String(report.defaults.summary.actionableProfiles)}/${String(report.summary.profileCount)} actionable`
+  };
+};
 var resolveVoiceRealCallProfileProviderRoute = (options) => {
   const defaults = readRealCallProfileDefaultsReport(options.defaults);
   const profile = defaults.profiles.find((item) => item.profileId === options.profileId) ?? defaults.profiles.find((item) => item.status === "pass") ?? defaults.profiles[0];

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@absolutejs/voice",
-	"version": "0.0.22-beta.369",
+	"version": "0.0.22-beta.370",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",