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

package/README.md

@@ -1545,6 +1545,16 @@ 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

@@ -4649,6 +4649,13 @@ var createVoiceInMemoryRealCallProfileRecoveryJobStore = (options = {}) => {
     get(id) {
       return jobs.get(id);
     },
+    list(input = {}) {
+      const limit = Number.isFinite(input.limit) && input.limit !== undefined && input.limit > 0 ? Math.floor(input.limit) : 50;
+      return [...jobs.values()].filter((job) => !input.actionId || job.actionId === input.actionId).filter((job) => !input.status || job.status === input.status).sort((first, second) => {
+        const updatedDelta = Date.parse(second.updatedAt) - Date.parse(first.updatedAt);
+        return updatedDelta === 0 ? second.id.localeCompare(first.id) : updatedDelta;
+      }).slice(0, limit);
+    },
     update(id, update) {
       const existing = jobs.get(id);
       if (!existing) {
@@ -4682,6 +4689,7 @@ var createVoiceSQLiteRealCallProfileRecoveryJobStore = (options = {}) => {
 			payload TEXT NOT NULL
 		)`);
   const selectStatement = database.query(`SELECT payload FROM "${tableName}" WHERE id = ?1 LIMIT 1`);
+  const listStatement = database.query(`SELECT payload FROM "${tableName}" ORDER BY sort_at DESC, id DESC`);
   const upsertStatement = database.query(`INSERT INTO "${tableName}" (id, sort_at, payload)
 		 VALUES (?1, ?2, ?3)
 		 ON CONFLICT(id) DO UPDATE SET sort_at = excluded.sort_at, payload = excluded.payload`);
@@ -4708,6 +4716,10 @@ var createVoiceSQLiteRealCallProfileRecoveryJobStore = (options = {}) => {
     get(id) {
       return readJob(id);
     },
+    list(input = {}) {
+      const limit = Number.isFinite(input.limit) && input.limit !== undefined && input.limit > 0 ? Math.floor(input.limit) : 50;
+      return listStatement.all().map((row) => JSON.parse(row.payload)).filter((job) => !input.actionId || job.actionId === input.actionId).filter((job) => !input.status || job.status === input.status).slice(0, limit);
+    },
     update(id, update) {
       const existing = readJob(id);
       if (!existing) {
@@ -4748,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];
@@ -5448,6 +5548,32 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
     };
   };
   routes.get(`${path}/actions`, async () => Response.json(await listActions(), { headers: options.headers }));
+  routes.get(`${path}/actions/jobs`, async ({
+    query,
+    set
+  }) => {
+    if (!options.jobStore?.list) {
+      set.status = 501;
+      return Response.json({
+        jobs: [],
+        message: "No real-call profile recovery job list store is configured.",
+        ok: false
+      }, { headers: options.headers });
+    }
+    const actionId = Object.keys(realCallProfileActionPaths).includes(query.actionId ?? "") ? query.actionId : undefined;
+    const status = ["fail", "pass", "queued", "running"].includes(query.status ?? "") ? query.status : undefined;
+    const limit = Number(query.limit);
+    const jobs = await options.jobStore.list({
+      actionId,
+      limit: Number.isFinite(limit) && limit > 0 ? limit : undefined,
+      status
+    });
+    return Response.json({
+      generatedAt: new Date().toISOString(),
+      jobs,
+      ok: true
+    }, { headers: options.headers });
+  });
   routes.get(`${path}/actions/:jobId`, async ({
     params,
     set

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, 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

@@ -16118,6 +16118,13 @@ var createVoiceInMemoryRealCallProfileRecoveryJobStore = (options = {}) => {
     get(id) {
       return jobs.get(id);
     },
+    list(input = {}) {
+      const limit = Number.isFinite(input.limit) && input.limit !== undefined && input.limit > 0 ? Math.floor(input.limit) : 50;
+      return [...jobs.values()].filter((job) => !input.actionId || job.actionId === input.actionId).filter((job) => !input.status || job.status === input.status).sort((first, second) => {
+        const updatedDelta = Date.parse(second.updatedAt) - Date.parse(first.updatedAt);
+        return updatedDelta === 0 ? second.id.localeCompare(first.id) : updatedDelta;
+      }).slice(0, limit);
+    },
     update(id, update) {
       const existing = jobs.get(id);
       if (!existing) {
@@ -16151,6 +16158,7 @@ var createVoiceSQLiteRealCallProfileRecoveryJobStore = (options = {}) => {
 			payload TEXT NOT NULL
 		)`);
   const selectStatement = database.query(`SELECT payload FROM "${tableName}" WHERE id = ?1 LIMIT 1`);
+  const listStatement = database.query(`SELECT payload FROM "${tableName}" ORDER BY sort_at DESC, id DESC`);
   const upsertStatement = database.query(`INSERT INTO "${tableName}" (id, sort_at, payload)
 		 VALUES (?1, ?2, ?3)
 		 ON CONFLICT(id) DO UPDATE SET sort_at = excluded.sort_at, payload = excluded.payload`);
@@ -16177,6 +16185,10 @@ var createVoiceSQLiteRealCallProfileRecoveryJobStore = (options = {}) => {
     get(id) {
       return readJob(id);
     },
+    list(input = {}) {
+      const limit = Number.isFinite(input.limit) && input.limit !== undefined && input.limit > 0 ? Math.floor(input.limit) : 50;
+      return listStatement.all().map((row) => JSON.parse(row.payload)).filter((job) => !input.actionId || job.actionId === input.actionId).filter((job) => !input.status || job.status === input.status).slice(0, limit);
+    },
     update(id, update) {
       const existing = readJob(id);
       if (!existing) {
@@ -16217,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];
@@ -16917,6 +17017,32 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
     };
   };
   routes.get(`${path}/actions`, async () => Response.json(await listActions(), { headers: options.headers }));
+  routes.get(`${path}/actions/jobs`, async ({
+    query,
+    set
+  }) => {
+    if (!options.jobStore?.list) {
+      set.status = 501;
+      return Response.json({
+        jobs: [],
+        message: "No real-call profile recovery job list store is configured.",
+        ok: false
+      }, { headers: options.headers });
+    }
+    const actionId = Object.keys(realCallProfileActionPaths).includes(query.actionId ?? "") ? query.actionId : undefined;
+    const status = ["fail", "pass", "queued", "running"].includes(query.status ?? "") ? query.status : undefined;
+    const limit = Number(query.limit);
+    const jobs = await options.jobStore.list({
+      actionId,
+      limit: Number.isFinite(limit) && limit > 0 ? limit : undefined,
+      status
+    });
+    return Response.json({
+      generatedAt: new Date().toISOString(),
+      jobs,
+      ok: true
+    }, { headers: options.headers });
+  });
   routes.get(`${path}/actions/:jobId`, async ({
     params,
     set
@@ -39236,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;
@@ -414,9 +423,15 @@ export type VoiceRealCallProfileRecoveryJobCreateInput = {
     status?: VoiceRealCallProfileRecoveryJobStatus;
 };
 export type VoiceRealCallProfileRecoveryJobUpdate = Partial<Pick<VoiceRealCallProfileRecoveryJob, 'completedAt' | 'message' | 'ok' | 'report' | 'startedAt' | 'status' | 'updatedAt'>>;
+export type VoiceRealCallProfileRecoveryJobListOptions = {
+    actionId?: VoiceRealCallProfileRecoveryActionId;
+    limit?: number;
+    status?: VoiceRealCallProfileRecoveryJobStatus;
+};
 export type VoiceRealCallProfileRecoveryJobStore = {
     create(input: VoiceRealCallProfileRecoveryJobCreateInput): Promise<VoiceRealCallProfileRecoveryJob> | VoiceRealCallProfileRecoveryJob;
     get(id: string): Promise<VoiceRealCallProfileRecoveryJob | undefined> | VoiceRealCallProfileRecoveryJob | undefined;
+    list?(options?: VoiceRealCallProfileRecoveryJobListOptions): Promise<VoiceRealCallProfileRecoveryJob[]> | VoiceRealCallProfileRecoveryJob[];
     update(id: string, update: VoiceRealCallProfileRecoveryJobUpdate): Promise<VoiceRealCallProfileRecoveryJob | undefined> | VoiceRealCallProfileRecoveryJob | undefined;
 };
 export type VoiceSQLiteRealCallProfileRecoveryJobStoreOptions = {
@@ -472,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

@@ -2236,6 +2236,13 @@ var createVoiceInMemoryRealCallProfileRecoveryJobStore = (options = {}) => {
     get(id) {
       return jobs.get(id);
     },
+    list(input = {}) {
+      const limit = Number.isFinite(input.limit) && input.limit !== undefined && input.limit > 0 ? Math.floor(input.limit) : 50;
+      return [...jobs.values()].filter((job) => !input.actionId || job.actionId === input.actionId).filter((job) => !input.status || job.status === input.status).sort((first, second) => {
+        const updatedDelta = Date.parse(second.updatedAt) - Date.parse(first.updatedAt);
+        return updatedDelta === 0 ? second.id.localeCompare(first.id) : updatedDelta;
+      }).slice(0, limit);
+    },
     update(id, update) {
       const existing = jobs.get(id);
       if (!existing) {
@@ -2269,6 +2276,7 @@ var createVoiceSQLiteRealCallProfileRecoveryJobStore = (options = {}) => {
 			payload TEXT NOT NULL
 		)`);
   const selectStatement = database.query(`SELECT payload FROM "${tableName}" WHERE id = ?1 LIMIT 1`);
+  const listStatement = database.query(`SELECT payload FROM "${tableName}" ORDER BY sort_at DESC, id DESC`);
   const upsertStatement = database.query(`INSERT INTO "${tableName}" (id, sort_at, payload)
 		 VALUES (?1, ?2, ?3)
 		 ON CONFLICT(id) DO UPDATE SET sort_at = excluded.sort_at, payload = excluded.payload`);
@@ -2295,6 +2303,10 @@ var createVoiceSQLiteRealCallProfileRecoveryJobStore = (options = {}) => {
     get(id) {
       return readJob(id);
     },
+    list(input = {}) {
+      const limit = Number.isFinite(input.limit) && input.limit !== undefined && input.limit > 0 ? Math.floor(input.limit) : 50;
+      return listStatement.all().map((row) => JSON.parse(row.payload)).filter((job) => !input.actionId || job.actionId === input.actionId).filter((job) => !input.status || job.status === input.status).slice(0, limit);
+    },
     update(id, update) {
       const existing = readJob(id);
       if (!existing) {
@@ -2335,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];
@@ -3035,6 +3135,32 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
     };
   };
   routes.get(`${path}/actions`, async () => Response.json(await listActions(), { headers: options.headers }));
+  routes.get(`${path}/actions/jobs`, async ({
+    query,
+    set
+  }) => {
+    if (!options.jobStore?.list) {
+      set.status = 501;
+      return Response.json({
+        jobs: [],
+        message: "No real-call profile recovery job list store is configured.",
+        ok: false
+      }, { headers: options.headers });
+    }
+    const actionId = Object.keys(realCallProfileActionPaths).includes(query.actionId ?? "") ? query.actionId : undefined;
+    const status = ["fail", "pass", "queued", "running"].includes(query.status ?? "") ? query.status : undefined;
+    const limit = Number(query.limit);
+    const jobs = await options.jobStore.list({
+      actionId,
+      limit: Number.isFinite(limit) && limit > 0 ? limit : undefined,
+      status
+    });
+    return Response.json({
+      generatedAt: new Date().toISOString(),
+      jobs,
+      ok: true
+    }, { headers: options.headers });
+  });
   routes.get(`${path}/actions/:jobId`, async ({
     params,
     set

package/dist/vue/index.js

@@ -2157,6 +2157,13 @@ var createVoiceInMemoryRealCallProfileRecoveryJobStore = (options = {}) => {
     get(id) {
       return jobs.get(id);
     },
+    list(input = {}) {
+      const limit = Number.isFinite(input.limit) && input.limit !== undefined && input.limit > 0 ? Math.floor(input.limit) : 50;
+      return [...jobs.values()].filter((job) => !input.actionId || job.actionId === input.actionId).filter((job) => !input.status || job.status === input.status).sort((first, second) => {
+        const updatedDelta = Date.parse(second.updatedAt) - Date.parse(first.updatedAt);
+        return updatedDelta === 0 ? second.id.localeCompare(first.id) : updatedDelta;
+      }).slice(0, limit);
+    },
     update(id, update) {
       const existing = jobs.get(id);
       if (!existing) {
@@ -2190,6 +2197,7 @@ var createVoiceSQLiteRealCallProfileRecoveryJobStore = (options = {}) => {
 			payload TEXT NOT NULL
 		)`);
   const selectStatement = database.query(`SELECT payload FROM "${tableName}" WHERE id = ?1 LIMIT 1`);
+  const listStatement = database.query(`SELECT payload FROM "${tableName}" ORDER BY sort_at DESC, id DESC`);
   const upsertStatement = database.query(`INSERT INTO "${tableName}" (id, sort_at, payload)
 		 VALUES (?1, ?2, ?3)
 		 ON CONFLICT(id) DO UPDATE SET sort_at = excluded.sort_at, payload = excluded.payload`);
@@ -2216,6 +2224,10 @@ var createVoiceSQLiteRealCallProfileRecoveryJobStore = (options = {}) => {
     get(id) {
       return readJob(id);
     },
+    list(input = {}) {
+      const limit = Number.isFinite(input.limit) && input.limit !== undefined && input.limit > 0 ? Math.floor(input.limit) : 50;
+      return listStatement.all().map((row) => JSON.parse(row.payload)).filter((job) => !input.actionId || job.actionId === input.actionId).filter((job) => !input.status || job.status === input.status).slice(0, limit);
+    },
     update(id, update) {
       const existing = readJob(id);
       if (!existing) {
@@ -2256,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];
@@ -2956,6 +3056,32 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
     };
   };
   routes.get(`${path}/actions`, async () => Response.json(await listActions(), { headers: options.headers }));
+  routes.get(`${path}/actions/jobs`, async ({
+    query,
+    set
+  }) => {
+    if (!options.jobStore?.list) {
+      set.status = 501;
+      return Response.json({
+        jobs: [],
+        message: "No real-call profile recovery job list store is configured.",
+        ok: false
+      }, { headers: options.headers });
+    }
+    const actionId = Object.keys(realCallProfileActionPaths).includes(query.actionId ?? "") ? query.actionId : undefined;
+    const status = ["fail", "pass", "queued", "running"].includes(query.status ?? "") ? query.status : undefined;
+    const limit = Number(query.limit);
+    const jobs = await options.jobStore.list({
+      actionId,
+      limit: Number.isFinite(limit) && limit > 0 ? limit : undefined,
+      status
+    });
+    return Response.json({
+      generatedAt: new Date().toISOString(),
+      jobs,
+      ok: true
+    }, { headers: options.headers });
+  });
   routes.get(`${path}/actions/:jobId`, async ({
     params,
     set

package/package.json

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