@absolutejs/voice 0.0.22-beta.376 → 0.0.22-beta.377

package/README.md

@@ -1547,6 +1547,14 @@ const recoveryJobs = createVoiceSQLiteRealCallProfileRecoveryJobStore({
 
 Recovery routes expose recent persisted jobs at `${path}/actions/jobs`. Stores can implement `list({ limit, actionId, status })`; the bundled memory and SQLite stores both support it.
 
+Use `buildVoiceRealCallProfileRecoveryJobHistoryCheck(...)` in production readiness to prove recovery jobs are persisted and inspectable:
+
+```ts
+additionalChecks: async () => [
+	await buildVoiceRealCallProfileRecoveryJobHistoryCheck(recoveryJobs)
+];
+```
+
 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

@@ -4760,6 +4760,94 @@ var buildVoiceRealCallProfileReadinessCheck = (report, options = {}) => {
     value: `${String(report.defaults.summary.actionableProfiles)}/${String(report.summary.profileCount)} actionable`
   };
 };
+var buildVoiceRealCallProfileRecoveryJobHistoryCheck = async (store, options = {}) => {
+  const href = options.href ?? "/voice/real-call-profile-recovery";
+  const sourceHref = options.sourceHref ?? "/api/voice/real-call-profile-history/actions/jobs";
+  const minCompletedJobs = options.minCompletedJobs ?? 1;
+  const label = options.label ?? "Real-call recovery job history";
+  if (!store?.list) {
+    return {
+      actions: [
+        {
+          description: "Configure a recovery job store with list support so operators can inspect proof repair history.",
+          href,
+          label: "Configure recovery job history"
+        }
+      ],
+      detail: "No real-call profile recovery job store with list support is configured.",
+      gateExplanation: {
+        evidenceHref: sourceHref,
+        observed: "missing",
+        remediation: "Use the bundled memory or SQLite recovery job store, or implement list() on the custom store.",
+        sourceHref,
+        threshold: "list support",
+        thresholdLabel: "Inspectable recovery jobs",
+        unit: "status"
+      },
+      href,
+      label,
+      status: "fail",
+      value: "missing"
+    };
+  }
+  const jobs = await store.list({ limit: 50 });
+  const now = Date.now();
+  const recentJobs = options.maxAgeMs === undefined ? jobs : jobs.filter((job) => now - Date.parse(job.updatedAt) <= options.maxAgeMs);
+  const completedJobs = recentJobs.filter((job) => job.status === "pass" || job.status === "fail");
+  const failedJobs = recentJobs.filter((job) => job.status === "fail");
+  const runningJobs = recentJobs.filter((job) => job.status === "queued" || job.status === "running");
+  const issues = [];
+  const warnings = [];
+  if (completedJobs.length < minCompletedJobs) {
+    issues.push(`Expected at least ${String(minCompletedJobs)} completed recovery job(s), found ${String(completedJobs.length)}.`);
+  }
+  if (!options.allowFailedJobs && failedJobs.length > 0) {
+    issues.push(`${String(failedJobs.length)} recent recovery job(s) failed.`);
+  }
+  if (runningJobs.length > 0) {
+    const message = `${String(runningJobs.length)} recovery job(s) are still queued or running.`;
+    if (options.failOnRunningJobs) {
+      issues.push(message);
+    } else {
+      warnings.push(message);
+    }
+  }
+  const status = issues.length > 0 ? "fail" : warnings.length > 0 ? "warn" : "pass";
+  const detail = status === "pass" ? `${String(completedJobs.length)} completed recovery job(s), ${String(failedJobs.length)} failed, ${String(runningJobs.length)} running.` : [...issues, ...warnings].join(" ");
+  return {
+    actions: [
+      {
+        description: "Open the recovery job UI and run or inspect proof repair jobs.",
+        href,
+        label: "Open recovery job history"
+      },
+      {
+        description: "Open the recovery job history API.",
+        href: sourceHref,
+        label: "Open recovery jobs API"
+      }
+    ],
+    detail,
+    gateExplanation: {
+      evidenceHref: sourceHref,
+      observed: completedJobs.length,
+      remediation: "Run a browser or phone recovery proof job and ensure recent recovery jobs complete without failure.",
+      sourceHref,
+      threshold: minCompletedJobs,
+      thresholdLabel: "Minimum completed recovery jobs",
+      unit: "count"
+    },
+    href,
+    label,
+    proofSource: {
+      href: sourceHref,
+      source: "recovery-job-store",
+      sourceLabel: "Real-call recovery jobs"
+    },
+    status,
+    value: `${String(completedJobs.length)} completed / ${String(failedJobs.length)} failed / ${String(runningJobs.length)} running`
+  };
+};
 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, buildVoiceRealCallProfileReadinessCheck, buildVoiceRealCallProfileRecoveryActions, createVoiceInMemoryRealCallProfileRecoveryJobStore, createVoiceSQLiteRealCallProfileRecoveryJobStore, createVoiceProofTrendRecommendationRoutes, createVoiceProofTrendRoutes, createVoiceRealCallProfileHistoryRoutes, createVoiceRealCallProfileRecoveryActionRoutes, 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, buildVoiceRealCallProfileRecoveryJobHistoryCheck, buildVoiceRealCallProfileRecoveryActions, createVoiceInMemoryRealCallProfileRecoveryJobStore, createVoiceSQLiteRealCallProfileRecoveryJobStore, createVoiceProofTrendRecommendationRoutes, createVoiceProofTrendRoutes, createVoiceRealCallProfileHistoryRoutes, createVoiceRealCallProfileRecoveryActionRoutes, 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, VoiceRealCallProfileReadinessCheckOptions, VoiceRealCallProfileRecoveryActionOptions, VoiceRealCallProfileRecoveryAction, VoiceRealCallProfileRecoveryActionHandler, VoiceRealCallProfileRecoveryActionHandlerInput, VoiceRealCallProfileRecoveryActionId, VoiceRealCallProfileRecoveryActionResult, VoiceRealCallProfileRecoveryActionRoutesOptions, VoiceRealCallProfileRecoveryJob, VoiceRealCallProfileRecoveryJobCreateInput, VoiceRealCallProfileRecoveryJobListOptions, VoiceRealCallProfileRecoveryJobStatus, VoiceRealCallProfileRecoveryJobStore, VoiceRealCallProfileRecoveryJobUpdate, VoiceSQLiteRealCallProfileRecoveryJobStoreOptions, 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, VoiceRealCallProfileRecoveryActionOptions, VoiceRealCallProfileRecoveryAction, VoiceRealCallProfileRecoveryActionHandler, VoiceRealCallProfileRecoveryActionHandlerInput, VoiceRealCallProfileRecoveryActionId, VoiceRealCallProfileRecoveryJobHistoryCheckOptions, VoiceRealCallProfileRecoveryActionResult, VoiceRealCallProfileRecoveryActionRoutesOptions, VoiceRealCallProfileRecoveryJob, VoiceRealCallProfileRecoveryJobCreateInput, VoiceRealCallProfileRecoveryJobListOptions, VoiceRealCallProfileRecoveryJobStatus, VoiceRealCallProfileRecoveryJobStore, VoiceRealCallProfileRecoveryJobUpdate, VoiceSQLiteRealCallProfileRecoveryJobStoreOptions, 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

@@ -16229,6 +16229,94 @@ var buildVoiceRealCallProfileReadinessCheck = (report, options = {}) => {
     value: `${String(report.defaults.summary.actionableProfiles)}/${String(report.summary.profileCount)} actionable`
   };
 };
+var buildVoiceRealCallProfileRecoveryJobHistoryCheck = async (store, options = {}) => {
+  const href = options.href ?? "/voice/real-call-profile-recovery";
+  const sourceHref = options.sourceHref ?? "/api/voice/real-call-profile-history/actions/jobs";
+  const minCompletedJobs = options.minCompletedJobs ?? 1;
+  const label = options.label ?? "Real-call recovery job history";
+  if (!store?.list) {
+    return {
+      actions: [
+        {
+          description: "Configure a recovery job store with list support so operators can inspect proof repair history.",
+          href,
+          label: "Configure recovery job history"
+        }
+      ],
+      detail: "No real-call profile recovery job store with list support is configured.",
+      gateExplanation: {
+        evidenceHref: sourceHref,
+        observed: "missing",
+        remediation: "Use the bundled memory or SQLite recovery job store, or implement list() on the custom store.",
+        sourceHref,
+        threshold: "list support",
+        thresholdLabel: "Inspectable recovery jobs",
+        unit: "status"
+      },
+      href,
+      label,
+      status: "fail",
+      value: "missing"
+    };
+  }
+  const jobs = await store.list({ limit: 50 });
+  const now = Date.now();
+  const recentJobs = options.maxAgeMs === undefined ? jobs : jobs.filter((job) => now - Date.parse(job.updatedAt) <= options.maxAgeMs);
+  const completedJobs = recentJobs.filter((job) => job.status === "pass" || job.status === "fail");
+  const failedJobs = recentJobs.filter((job) => job.status === "fail");
+  const runningJobs = recentJobs.filter((job) => job.status === "queued" || job.status === "running");
+  const issues = [];
+  const warnings = [];
+  if (completedJobs.length < minCompletedJobs) {
+    issues.push(`Expected at least ${String(minCompletedJobs)} completed recovery job(s), found ${String(completedJobs.length)}.`);
+  }
+  if (!options.allowFailedJobs && failedJobs.length > 0) {
+    issues.push(`${String(failedJobs.length)} recent recovery job(s) failed.`);
+  }
+  if (runningJobs.length > 0) {
+    const message = `${String(runningJobs.length)} recovery job(s) are still queued or running.`;
+    if (options.failOnRunningJobs) {
+      issues.push(message);
+    } else {
+      warnings.push(message);
+    }
+  }
+  const status = issues.length > 0 ? "fail" : warnings.length > 0 ? "warn" : "pass";
+  const detail = status === "pass" ? `${String(completedJobs.length)} completed recovery job(s), ${String(failedJobs.length)} failed, ${String(runningJobs.length)} running.` : [...issues, ...warnings].join(" ");
+  return {
+    actions: [
+      {
+        description: "Open the recovery job UI and run or inspect proof repair jobs.",
+        href,
+        label: "Open recovery job history"
+      },
+      {
+        description: "Open the recovery job history API.",
+        href: sourceHref,
+        label: "Open recovery jobs API"
+      }
+    ],
+    detail,
+    gateExplanation: {
+      evidenceHref: sourceHref,
+      observed: completedJobs.length,
+      remediation: "Run a browser or phone recovery proof job and ensure recent recovery jobs complete without failure.",
+      sourceHref,
+      threshold: minCompletedJobs,
+      thresholdLabel: "Minimum completed recovery jobs",
+      unit: "count"
+    },
+    href,
+    label,
+    proofSource: {
+      href: sourceHref,
+      source: "recovery-job-store",
+      sourceLabel: "Real-call recovery jobs"
+    },
+    status,
+    value: `${String(completedJobs.length)} completed / ${String(failedJobs.length)} failed / ${String(runningJobs.length)} running`
+  };
+};
 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];
@@ -39274,6 +39362,7 @@ export {
   buildVoiceRealtimeProviderContractMatrix,
   buildVoiceRealtimeChannelRuntimeSamplesFromTrace,
   buildVoiceRealtimeChannelReport,
+  buildVoiceRealCallProfileRecoveryJobHistoryCheck,
   buildVoiceRealCallProfileRecoveryActions,
   buildVoiceRealCallProfileReadinessCheck,
   buildVoiceRealCallProfileHistoryReport,

package/dist/proofTrends.d.ts

@@ -378,6 +378,15 @@ export type VoiceRealCallProfileReadinessCheckOptions = {
     sourceHref?: string;
 };
 export type VoiceRealCallProfileRecoveryActionOptions = VoiceRealCallProfileReadinessCheckOptions;
+export type VoiceRealCallProfileRecoveryJobHistoryCheckOptions = {
+    allowFailedJobs?: boolean;
+    failOnRunningJobs?: boolean;
+    href?: string;
+    label?: string;
+    maxAgeMs?: number;
+    minCompletedJobs?: number;
+    sourceHref?: string;
+};
 export type VoiceRealCallProfileRecoveryActionHandlerInput = {
     actionId: VoiceRealCallProfileRecoveryActionId;
     report: VoiceRealCallProfileHistoryReport;
@@ -478,6 +487,7 @@ export declare const createVoiceInMemoryRealCallProfileRecoveryJobStore: (option
 }) => VoiceRealCallProfileRecoveryJobStore;
 export declare const createVoiceSQLiteRealCallProfileRecoveryJobStore: (options?: VoiceSQLiteRealCallProfileRecoveryJobStoreOptions) => VoiceRealCallProfileRecoveryJobStore;
 export declare const buildVoiceRealCallProfileReadinessCheck: (report: VoiceRealCallProfileHistoryReport, options?: VoiceRealCallProfileReadinessCheckOptions) => VoiceProductionReadinessCheck;
+export declare const buildVoiceRealCallProfileRecoveryJobHistoryCheck: (store: Pick<VoiceRealCallProfileRecoveryJobStore, "list"> | undefined, options?: VoiceRealCallProfileRecoveryJobHistoryCheckOptions) => Promise<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

@@ -2347,6 +2347,94 @@ var buildVoiceRealCallProfileReadinessCheck = (report, options = {}) => {
     value: `${String(report.defaults.summary.actionableProfiles)}/${String(report.summary.profileCount)} actionable`
   };
 };
+var buildVoiceRealCallProfileRecoveryJobHistoryCheck = async (store, options = {}) => {
+  const href = options.href ?? "/voice/real-call-profile-recovery";
+  const sourceHref = options.sourceHref ?? "/api/voice/real-call-profile-history/actions/jobs";
+  const minCompletedJobs = options.minCompletedJobs ?? 1;
+  const label = options.label ?? "Real-call recovery job history";
+  if (!store?.list) {
+    return {
+      actions: [
+        {
+          description: "Configure a recovery job store with list support so operators can inspect proof repair history.",
+          href,
+          label: "Configure recovery job history"
+        }
+      ],
+      detail: "No real-call profile recovery job store with list support is configured.",
+      gateExplanation: {
+        evidenceHref: sourceHref,
+        observed: "missing",
+        remediation: "Use the bundled memory or SQLite recovery job store, or implement list() on the custom store.",
+        sourceHref,
+        threshold: "list support",
+        thresholdLabel: "Inspectable recovery jobs",
+        unit: "status"
+      },
+      href,
+      label,
+      status: "fail",
+      value: "missing"
+    };
+  }
+  const jobs = await store.list({ limit: 50 });
+  const now = Date.now();
+  const recentJobs = options.maxAgeMs === undefined ? jobs : jobs.filter((job) => now - Date.parse(job.updatedAt) <= options.maxAgeMs);
+  const completedJobs = recentJobs.filter((job) => job.status === "pass" || job.status === "fail");
+  const failedJobs = recentJobs.filter((job) => job.status === "fail");
+  const runningJobs = recentJobs.filter((job) => job.status === "queued" || job.status === "running");
+  const issues = [];
+  const warnings = [];
+  if (completedJobs.length < minCompletedJobs) {
+    issues.push(`Expected at least ${String(minCompletedJobs)} completed recovery job(s), found ${String(completedJobs.length)}.`);
+  }
+  if (!options.allowFailedJobs && failedJobs.length > 0) {
+    issues.push(`${String(failedJobs.length)} recent recovery job(s) failed.`);
+  }
+  if (runningJobs.length > 0) {
+    const message = `${String(runningJobs.length)} recovery job(s) are still queued or running.`;
+    if (options.failOnRunningJobs) {
+      issues.push(message);
+    } else {
+      warnings.push(message);
+    }
+  }
+  const status = issues.length > 0 ? "fail" : warnings.length > 0 ? "warn" : "pass";
+  const detail = status === "pass" ? `${String(completedJobs.length)} completed recovery job(s), ${String(failedJobs.length)} failed, ${String(runningJobs.length)} running.` : [...issues, ...warnings].join(" ");
+  return {
+    actions: [
+      {
+        description: "Open the recovery job UI and run or inspect proof repair jobs.",
+        href,
+        label: "Open recovery job history"
+      },
+      {
+        description: "Open the recovery job history API.",
+        href: sourceHref,
+        label: "Open recovery jobs API"
+      }
+    ],
+    detail,
+    gateExplanation: {
+      evidenceHref: sourceHref,
+      observed: completedJobs.length,
+      remediation: "Run a browser or phone recovery proof job and ensure recent recovery jobs complete without failure.",
+      sourceHref,
+      threshold: minCompletedJobs,
+      thresholdLabel: "Minimum completed recovery jobs",
+      unit: "count"
+    },
+    href,
+    label,
+    proofSource: {
+      href: sourceHref,
+      source: "recovery-job-store",
+      sourceLabel: "Real-call recovery jobs"
+    },
+    status,
+    value: `${String(completedJobs.length)} completed / ${String(failedJobs.length)} failed / ${String(runningJobs.length)} running`
+  };
+};
 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

@@ -2268,6 +2268,94 @@ var buildVoiceRealCallProfileReadinessCheck = (report, options = {}) => {
     value: `${String(report.defaults.summary.actionableProfiles)}/${String(report.summary.profileCount)} actionable`
   };
 };
+var buildVoiceRealCallProfileRecoveryJobHistoryCheck = async (store, options = {}) => {
+  const href = options.href ?? "/voice/real-call-profile-recovery";
+  const sourceHref = options.sourceHref ?? "/api/voice/real-call-profile-history/actions/jobs";
+  const minCompletedJobs = options.minCompletedJobs ?? 1;
+  const label = options.label ?? "Real-call recovery job history";
+  if (!store?.list) {
+    return {
+      actions: [
+        {
+          description: "Configure a recovery job store with list support so operators can inspect proof repair history.",
+          href,
+          label: "Configure recovery job history"
+        }
+      ],
+      detail: "No real-call profile recovery job store with list support is configured.",
+      gateExplanation: {
+        evidenceHref: sourceHref,
+        observed: "missing",
+        remediation: "Use the bundled memory or SQLite recovery job store, or implement list() on the custom store.",
+        sourceHref,
+        threshold: "list support",
+        thresholdLabel: "Inspectable recovery jobs",
+        unit: "status"
+      },
+      href,
+      label,
+      status: "fail",
+      value: "missing"
+    };
+  }
+  const jobs = await store.list({ limit: 50 });
+  const now = Date.now();
+  const recentJobs = options.maxAgeMs === undefined ? jobs : jobs.filter((job) => now - Date.parse(job.updatedAt) <= options.maxAgeMs);
+  const completedJobs = recentJobs.filter((job) => job.status === "pass" || job.status === "fail");
+  const failedJobs = recentJobs.filter((job) => job.status === "fail");
+  const runningJobs = recentJobs.filter((job) => job.status === "queued" || job.status === "running");
+  const issues = [];
+  const warnings = [];
+  if (completedJobs.length < minCompletedJobs) {
+    issues.push(`Expected at least ${String(minCompletedJobs)} completed recovery job(s), found ${String(completedJobs.length)}.`);
+  }
+  if (!options.allowFailedJobs && failedJobs.length > 0) {
+    issues.push(`${String(failedJobs.length)} recent recovery job(s) failed.`);
+  }
+  if (runningJobs.length > 0) {
+    const message = `${String(runningJobs.length)} recovery job(s) are still queued or running.`;
+    if (options.failOnRunningJobs) {
+      issues.push(message);
+    } else {
+      warnings.push(message);
+    }
+  }
+  const status = issues.length > 0 ? "fail" : warnings.length > 0 ? "warn" : "pass";
+  const detail = status === "pass" ? `${String(completedJobs.length)} completed recovery job(s), ${String(failedJobs.length)} failed, ${String(runningJobs.length)} running.` : [...issues, ...warnings].join(" ");
+  return {
+    actions: [
+      {
+        description: "Open the recovery job UI and run or inspect proof repair jobs.",
+        href,
+        label: "Open recovery job history"
+      },
+      {
+        description: "Open the recovery job history API.",
+        href: sourceHref,
+        label: "Open recovery jobs API"
+      }
+    ],
+    detail,
+    gateExplanation: {
+      evidenceHref: sourceHref,
+      observed: completedJobs.length,
+      remediation: "Run a browser or phone recovery proof job and ensure recent recovery jobs complete without failure.",
+      sourceHref,
+      threshold: minCompletedJobs,
+      thresholdLabel: "Minimum completed recovery jobs",
+      unit: "count"
+    },
+    href,
+    label,
+    proofSource: {
+      href: sourceHref,
+      source: "recovery-job-store",
+      sourceLabel: "Real-call recovery jobs"
+    },
+    status,
+    value: `${String(completedJobs.length)} completed / ${String(failedJobs.length)} failed / ${String(runningJobs.length)} running`
+  };
+};
 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.376",
+	"version": "0.0.22-beta.377",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",