@absolutejs/voice 0.0.22-beta.438 → 0.0.22-beta.439

package/dist/incidentTimeline.d.ts

@@ -60,6 +60,44 @@ export type VoiceIncidentRecoveryOutcomeReport = {
     total: number;
     unchanged: number;
 };
+export type VoiceIncidentRecoveryTrendStatus = 'empty' | 'fail' | 'pass' | 'warn';
+export type VoiceIncidentRecoveryTrendCycle = {
+    checkedAt: number;
+    failed: number;
+    failureRate: number;
+    improved: number;
+    improvementRate: number;
+    regressed: number;
+    regressionRate: number;
+    total: number;
+    unchanged: number;
+    unchangedRate: number;
+};
+export type VoiceIncidentRecoveryTrendReport = {
+    checkedAt: number;
+    cycles: VoiceIncidentRecoveryTrendCycle[];
+    latest?: VoiceIncidentRecoveryTrendCycle;
+    previous?: VoiceIncidentRecoveryTrendCycle;
+    status: VoiceIncidentRecoveryTrendStatus;
+    summary: {
+        cycles: number;
+        failed: number;
+        failureRate: number;
+        improved: number;
+        improvementRate: number;
+        regressed: number;
+        regressionRate: number;
+        total: number;
+        unchanged: number;
+        unchangedRate: number;
+    };
+    trend: {
+        failureRateDelta?: number;
+        improvementRateDelta?: number;
+        regressionRateDelta?: number;
+        unchangedRateDelta?: number;
+    };
+};
 export type VoiceIncidentRecoveryOutcomeOptions = {
     audit?: VoiceAuditEventStore;
     limit?: number;
@@ -138,6 +176,10 @@ export type VoiceIncidentTimelineRoutesOptions = VoiceIncidentTimelineOptions &
     render?: (report: VoiceIncidentTimelineReport) => string | Promise<string>;
     recoveryOutcomeHtmlPath?: false | string;
     recoveryOutcomePath?: false | string;
+    recoveryTrendHtmlPath?: false | string;
+    recoveryTrendMarkdownPath?: false | string;
+    recoveryTrendPath?: false | string;
+    recoveryTrendReports?: VoiceIncidentRecoveryOutcomeReport[] | (() => VoiceIncidentRecoveryOutcomeReport[] | Promise<VoiceIncidentRecoveryOutcomeReport[]>);
     title?: string;
     trace?: VoiceTraceEventStore;
 };
@@ -146,6 +188,13 @@ export declare const renderVoiceIncidentRecoveryOutcomeHTML: (report: VoiceIncid
     title?: string;
 }) => string;
 export declare const buildVoiceIncidentRecoveryOutcomeReadinessCheck: (report: VoiceIncidentRecoveryOutcomeReport, options?: VoiceIncidentRecoveryOutcomeReadinessOptions) => VoiceProductionReadinessCheck;
+export declare const buildVoiceIncidentRecoveryTrendReport: (reports?: readonly VoiceIncidentRecoveryOutcomeReport[]) => VoiceIncidentRecoveryTrendReport;
+export declare const renderVoiceIncidentRecoveryTrendMarkdown: (report: VoiceIncidentRecoveryTrendReport, options?: {
+    title?: string;
+}) => string;
+export declare const renderVoiceIncidentRecoveryTrendHTML: (report: VoiceIncidentRecoveryTrendReport, options?: {
+    title?: string;
+}) => string;
 export declare const buildVoiceIncidentTimelineReport: (options: VoiceIncidentTimelineOptions) => Promise<VoiceIncidentTimelineReport>;
 export declare const renderVoiceIncidentTimelineMarkdown: (report: VoiceIncidentTimelineReport, options?: {
     title?: string;

package/dist/index.d.ts

@@ -52,7 +52,7 @@ export { assertVoiceLiveOpsControlEvidence, assertVoiceLiveOpsEvidence, buildVoi
 export type { VoiceLiveOpsAction, VoiceLiveOpsActionInput, VoiceLiveOpsActionResult, VoiceLiveOpsControllerOptions, VoiceLiveOpsControlState, VoiceLiveOpsControlStatus, VoiceLiveOpsControlStore, VoiceLiveOpsControlEvidenceInput, VoiceLiveOpsControlEvidenceReport, VoiceLiveOpsEvidenceInput, VoiceLiveOpsEvidenceReport, VoiceLiveOpsRoutesOptions } from './liveOps';
 export { buildVoiceDeliveryRuntimeReport, createVoiceDeliveryRuntime, createVoiceDeliveryRuntimePresetConfig, createVoiceDeliveryRuntimeRoutes, renderVoiceDeliveryRuntimeHTML } from './deliveryRuntime';
 export { buildVoiceOperationalStatusReport, createVoiceOperationalStatusRoutes, renderVoiceOperationalStatusHTML } from './operationalStatus';
-export { buildVoiceIncidentRecoveryOutcomeReport, buildVoiceIncidentRecoveryOutcomeReadinessCheck, buildVoiceIncidentTimelineReport, createVoiceIncidentTimelineRoutes, renderVoiceIncidentRecoveryOutcomeHTML, renderVoiceIncidentTimelineHTML, renderVoiceIncidentTimelineMarkdown } from './incidentTimeline';
+export { buildVoiceIncidentRecoveryOutcomeReport, buildVoiceIncidentRecoveryOutcomeReadinessCheck, buildVoiceIncidentRecoveryTrendReport, buildVoiceIncidentTimelineReport, createVoiceIncidentTimelineRoutes, renderVoiceIncidentRecoveryOutcomeHTML, renderVoiceIncidentRecoveryTrendHTML, renderVoiceIncidentRecoveryTrendMarkdown, renderVoiceIncidentTimelineHTML, renderVoiceIncidentTimelineMarkdown } from './incidentTimeline';
 export { applyVoiceDataRetentionPolicy, assertVoiceDataControlEvidence, buildVoiceDataControlReport, buildVoiceDataRetentionPlan, createVoiceDataControlRoutes, createVoiceZeroRetentionPolicy, evaluateVoiceDataControlEvidence, renderVoiceDataControlHTML, renderVoiceDataControlMarkdown, voiceComplianceRedactionDefaults } from './dataControl';
 export type { VoiceDataControlAssertionInput, VoiceDataControlAssertionReport, VoiceDataControlProviderKeySurface, VoiceDataControlReport, VoiceDataControlRoutesOptions, VoiceDataControlStorageSurface, VoiceDataRetentionPolicy, VoiceDataRetentionReport, VoiceDataRetentionScope, VoiceDataRetentionScopeReport, VoiceDataRetentionStores } from './dataControl';
 export type { VoiceDemoReadyReport, VoiceDemoReadyRoutesOptions, VoiceDemoReadySection, VoiceDemoReadyStatus } from './demoReadyRoutes';
@@ -60,7 +60,7 @@ export type { VoiceDeliverySinkDescriptor, VoiceDeliverySinkDescriptorInput, Voi
 export type { VoiceOpsActionAuditRecord, VoiceOpsActionAuditRoutesOptions, VoiceOpsActionHistoryEntry, VoiceOpsActionHistoryReport } from './opsActionAuditRoutes';
 export type { VoiceDeliveryRuntime, VoiceDeliveryRuntimeAuditConfig, VoiceDeliveryRuntimeConfig, VoiceDeliveryRuntimeFilePresetOptions, VoiceDeliveryRuntimePresetLeaseConfig, VoiceDeliveryRuntimePresetMode, VoiceDeliveryRuntimePresetOptions, VoiceDeliveryRuntimeReport, VoiceDeliveryRuntimeRoutesOptions, VoiceDeliveryRuntimeS3PresetOptions, VoiceDeliveryRuntimeSummary, VoiceDeliveryRuntimeTickResult, VoiceDeliveryRuntimeTraceConfig, VoiceDeliveryRuntimeWebhookPresetOptions } from './deliveryRuntime';
 export type { VoiceOperationalStatus, VoiceOperationalStatusCheck, VoiceOperationalStatusOptions, VoiceOperationalStatusReport, VoiceOperationalStatusRoutesOptions, VoiceOperationalStatusValue } from './operationalStatus';
-export type { VoiceIncidentRecoveryAction, VoiceIncidentRecoveryActionHandler, VoiceIncidentRecoveryActionHandlerInput, VoiceIncidentRecoveryActionResult, VoiceIncidentRecoveryOutcome, VoiceIncidentRecoveryOutcomeEntry, VoiceIncidentRecoveryOutcomeOptions, VoiceIncidentRecoveryOutcomeReadinessOptions, VoiceIncidentRecoveryOutcomeReport, VoiceIncidentTimelineAction, VoiceIncidentTimelineEvent, VoiceIncidentTimelineLinks, VoiceIncidentTimelineOptions, VoiceIncidentTimelineReport, VoiceIncidentTimelineRoutesOptions, VoiceIncidentTimelineSeverity, VoiceIncidentTimelineStatus, VoiceIncidentTimelineValue } from './incidentTimeline';
+export type { VoiceIncidentRecoveryAction, VoiceIncidentRecoveryActionHandler, VoiceIncidentRecoveryActionHandlerInput, VoiceIncidentRecoveryActionResult, VoiceIncidentRecoveryOutcome, VoiceIncidentRecoveryOutcomeEntry, VoiceIncidentRecoveryOutcomeOptions, VoiceIncidentRecoveryOutcomeReadinessOptions, VoiceIncidentRecoveryOutcomeReport, VoiceIncidentRecoveryTrendCycle, VoiceIncidentRecoveryTrendReport, VoiceIncidentRecoveryTrendStatus, VoiceIncidentTimelineAction, VoiceIncidentTimelineEvent, VoiceIncidentTimelineLinks, VoiceIncidentTimelineOptions, VoiceIncidentTimelineReport, VoiceIncidentTimelineRoutesOptions, VoiceIncidentTimelineSeverity, VoiceIncidentTimelineStatus, VoiceIncidentTimelineValue } from './incidentTimeline';
 export { compareVoiceEvalBaseline, createVoiceFileEvalBaselineStore, createVoiceFileScenarioFixtureStore, createVoiceEvalRoutes, renderVoiceEvalBaselineHTML, renderVoiceEvalHTML, renderVoiceScenarioEvalHTML, renderVoiceScenarioFixtureEvalHTML, runVoiceScenarioEvals, runVoiceScenarioFixtureEvals, runVoiceSessionEvals } from './evalRoutes';
 export { assertVoiceSimulationSuiteEvidence, createVoiceSimulationSuiteRoutes, evaluateVoiceSimulationSuiteEvidence, renderVoiceSimulationSuiteHTML, runVoiceSimulationSuite } from './simulationSuite';
 export { createVoiceWorkflowContract, createVoiceWorkflowContractHandler, createVoiceWorkflowContractPreset, createVoiceWorkflowScenario, recordVoiceWorkflowContractTrace, validateVoiceWorkflowRouteResult } from './workflowContract';

package/dist/index.js

@@ -26590,6 +26590,96 @@ var buildVoiceIncidentRecoveryOutcomeReadinessCheck = (report, options = {}) =>
     value: `${report.improved}/${report.total} improved`
   };
 };
+var rate3 = (count, total) => total > 0 ? count / total : 0;
+var toIncidentRecoveryTrendCycle = (report) => ({
+  checkedAt: report.checkedAt,
+  failed: report.failed,
+  failureRate: rate3(report.failed, report.total),
+  improved: report.improved,
+  improvementRate: rate3(report.improved, report.total),
+  regressed: report.regressed,
+  regressionRate: rate3(report.regressed, report.total),
+  total: report.total,
+  unchanged: report.unchanged,
+  unchangedRate: rate3(report.unchanged, report.total)
+});
+var buildVoiceIncidentRecoveryTrendReport = (reports = []) => {
+  const cycles = reports.map(toIncidentRecoveryTrendCycle).sort((left, right) => left.checkedAt - right.checkedAt);
+  const totals = cycles.reduce((summary, cycle) => ({
+    failed: summary.failed + cycle.failed,
+    improved: summary.improved + cycle.improved,
+    regressed: summary.regressed + cycle.regressed,
+    total: summary.total + cycle.total,
+    unchanged: summary.unchanged + cycle.unchanged
+  }), { failed: 0, improved: 0, regressed: 0, total: 0, unchanged: 0 });
+  const latest = cycles.at(-1);
+  const previous = cycles.at(-2);
+  const status = cycles.length === 0 ? "empty" : latest && (latest.failed > 0 || latest.regressed > 0) ? "fail" : latest && previous && (latest.improvementRate < previous.improvementRate || latest.unchangedRate > previous.unchangedRate) ? "warn" : "pass";
+  return {
+    checkedAt: Date.now(),
+    cycles,
+    latest,
+    previous,
+    status,
+    summary: {
+      cycles: cycles.length,
+      failed: totals.failed,
+      failureRate: rate3(totals.failed, totals.total),
+      improved: totals.improved,
+      improvementRate: rate3(totals.improved, totals.total),
+      regressed: totals.regressed,
+      regressionRate: rate3(totals.regressed, totals.total),
+      total: totals.total,
+      unchanged: totals.unchanged,
+      unchangedRate: rate3(totals.unchanged, totals.total)
+    },
+    trend: {
+      failureRateDelta: latest && previous ? latest.failureRate - previous.failureRate : undefined,
+      improvementRateDelta: latest && previous ? latest.improvementRate - previous.improvementRate : undefined,
+      regressionRateDelta: latest && previous ? latest.regressionRate - previous.regressionRate : undefined,
+      unchangedRateDelta: latest && previous ? latest.unchangedRate - previous.unchangedRate : undefined
+    }
+  };
+};
+var percent = (value) => value === undefined ? "n/a" : `${Math.round(value * 100)}%`;
+var renderVoiceIncidentRecoveryTrendMarkdown = (report, options = {}) => {
+  const title = options.title ?? "Voice Incident Recovery Trend";
+  const rows = report.cycles.map((cycle) => `| ${new Date(cycle.checkedAt).toISOString()} | ${cycle.total} | ${cycle.improved} | ${cycle.unchanged} | ${cycle.regressed} | ${cycle.failed} | ${percent(cycle.improvementRate)} | ${percent(cycle.regressionRate)} |`).join(`
+`);
+  return `# ${title}
+
+Generated: ${new Date(report.checkedAt).toISOString()}
+
+Status: **${report.status}**
+
+Cycles: ${report.summary.cycles}
+
+Total actions: ${report.summary.total}
+
+Improvement rate: ${percent(report.summary.improvementRate)}
+
+Regression rate: ${percent(report.summary.regressionRate)}
+
+Failure rate: ${percent(report.summary.failureRate)}
+
+Unchanged rate: ${percent(report.summary.unchangedRate)}
+
+Improvement delta: ${percent(report.trend.improvementRateDelta)}
+
+Regression delta: ${percent(report.trend.regressionRateDelta)}
+
+## Cycles
+
+| Checked at | Total | Improved | Unchanged | Regressed | Failed | Improve % | Regress % |
+| --- | ---: | ---: | ---: | ---: | ---: | ---: | ---: |
+${rows || "| n/a | 0 | 0 | 0 | 0 | 0 | n/a | n/a |"}
+`;
+};
+var renderVoiceIncidentRecoveryTrendHTML = (report, options = {}) => {
+  const title = options.title ?? "AbsoluteJS Voice Incident Recovery Trend";
+  const rows = report.cycles.map((cycle) => `<tr><td>${escapeHtml41(new Date(cycle.checkedAt).toLocaleString())}</td><td>${String(cycle.total)}</td><td>${String(cycle.improved)}</td><td>${String(cycle.unchanged)}</td><td>${String(cycle.regressed)}</td><td>${String(cycle.failed)}</td><td>${escapeHtml41(percent(cycle.improvementRate))}</td><td>${escapeHtml41(percent(cycle.regressionRate))}</td></tr>`).join("");
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml41(title)}</title><style>body{background:#10120d;color:#fbf4df;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1080px;padding:32px}.hero,table{background:#181711;border:1px solid #39301d;border-radius:24px}.hero{margin-bottom:16px;padding:24px}h1{font-size:clamp(2rem,6vw,4.5rem);line-height:.95}.summary{display:flex;flex-wrap:wrap;gap:10px}.summary span{border:1px solid #4a3f23;border-radius:999px;padding:8px 12px}table{border-collapse:collapse;overflow:hidden;width:100%}td,th{border-bottom:1px solid #39301d;padding:12px;text-align:left}.pass{color:#86efac}.warn,.empty{color:#fcd34d}.fail{color:#fca5a5}p{color:#cfc5a8}</style></head><body><main><section class="hero"><span>Recovery trend</span><h1>${escapeHtml41(title)}</h1><p class="${escapeHtml41(report.status)}">Status: ${escapeHtml41(report.status)}</p><div class="summary"><span>${String(report.summary.cycles)} cycles</span><span>${String(report.summary.total)} actions</span><span>${escapeHtml41(percent(report.summary.improvementRate))} improved</span><span>${escapeHtml41(percent(report.summary.regressionRate))} regressed</span><span>${escapeHtml41(percent(report.trend.improvementRateDelta))} improvement delta</span></div></section><table><thead><tr><th>Checked at</th><th>Total</th><th>Improved</th><th>Unchanged</th><th>Regressed</th><th>Failed</th><th>Improve %</th><th>Regress %</th></tr></thead><tbody>${rows || '<tr><td colspan="8">No recovery outcome history has been recorded.</td></tr>'}</tbody></table></main></body></html>`;
+};
 var pushOperationalStatusEvents = (events, report, links) => {
   if (!report) {
     return;
@@ -26838,6 +26928,17 @@ var createVoiceIncidentTimelineRoutes = (options) => {
   const actionPath = options.actionPath === undefined ? "/api/voice/incident-timeline/actions" : options.actionPath;
   const recoveryOutcomePath = options.recoveryOutcomePath === undefined ? "/api/voice/incident-timeline/recovery-outcomes" : options.recoveryOutcomePath;
   const recoveryOutcomeHtmlPath = options.recoveryOutcomeHtmlPath === undefined ? "/voice/incident-recovery-outcomes" : options.recoveryOutcomeHtmlPath;
+  const recoveryTrendPath = options.recoveryTrendPath === undefined ? "/api/voice/incident-timeline/recovery-trends" : options.recoveryTrendPath;
+  const recoveryTrendHtmlPath = options.recoveryTrendHtmlPath === undefined ? "/voice/incident-recovery-trends" : options.recoveryTrendHtmlPath;
+  const recoveryTrendMarkdownPath = options.recoveryTrendMarkdownPath === undefined ? "/voice/incident-recovery-trends.md" : options.recoveryTrendMarkdownPath;
+  const buildRecoveryTrendReport = async () => {
+    const reports = typeof options.recoveryTrendReports === "function" ? await options.recoveryTrendReports() : options.recoveryTrendReports;
+    return buildVoiceIncidentRecoveryTrendReport(reports ?? [
+      await buildVoiceIncidentRecoveryOutcomeReport({
+        audit: options.audit
+      })
+    ]);
+  };
   const routes = new Elysia43({
     name: options.name ?? "absolutejs-voice-incident-timeline"
   }).get(path, async () => {
@@ -26989,6 +27090,43 @@ var createVoiceIncidentTimelineRoutes = (options) => {
       });
     });
   }
+  if (recoveryTrendPath !== false) {
+    routes.get(recoveryTrendPath, async () => {
+      const report = await buildRecoveryTrendReport();
+      return new Response(JSON.stringify(report), {
+        headers: {
+          "Content-Type": "application/json; charset=utf-8",
+          ...options.headers
+        }
+      });
+    });
+  }
+  if (recoveryTrendHtmlPath !== false) {
+    routes.get(recoveryTrendHtmlPath, async () => {
+      const report = await buildRecoveryTrendReport();
+      return new Response(renderVoiceIncidentRecoveryTrendHTML(report, {
+        title: `${options.title ?? "AbsoluteJS Voice Incident Timeline"} Recovery Trend`
+      }), {
+        headers: {
+          "Content-Type": "text/html; charset=utf-8",
+          ...options.headers
+        }
+      });
+    });
+  }
+  if (recoveryTrendMarkdownPath !== false) {
+    routes.get(recoveryTrendMarkdownPath, async () => {
+      const report = await buildRecoveryTrendReport();
+      return new Response(renderVoiceIncidentRecoveryTrendMarkdown(report, {
+        title: `${options.title ?? "AbsoluteJS Voice Incident Timeline"} Recovery Trend`
+      }), {
+        headers: {
+          "Content-Type": "text/markdown; charset=utf-8",
+          ...options.headers
+        }
+      });
+    });
+  }
   return routes;
 };
 
@@ -31373,7 +31511,7 @@ import { Elysia as Elysia48 } from "elysia";
 import { mkdir as mkdir3 } from "fs/promises";
 import { dirname as dirname2 } from "path";
 var escapeHtml45 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-var rate3 = (count, total) => count / Math.max(1, total);
+var rate4 = (count, total) => count / Math.max(1, total);
 var normalizeSearchText = (value) => value.trim().toLowerCase();
 var getString18 = (value) => typeof value === "string" ? value : undefined;
 var resolveSessionHref3 = (value, sessionId) => {
@@ -31621,7 +31759,7 @@ var summarizeEvalBaseline = (report) => {
   return {
     failed: report.failed,
     failedSessionIds,
-    passRate: rate3(report.passed, report.total),
+    passRate: rate4(report.passed, report.total),
     passed: report.passed,
     total: report.total
   };
@@ -41617,6 +41755,8 @@ export {
   renderVoiceLatencySLOMarkdown,
   renderVoiceIncidentTimelineMarkdown,
   renderVoiceIncidentTimelineHTML,
+  renderVoiceIncidentRecoveryTrendMarkdown,
+  renderVoiceIncidentRecoveryTrendHTML,
   renderVoiceIncidentRecoveryOutcomeHTML,
   renderVoiceHandoffHealthHTML,
   renderVoiceGuardrailMarkdown,
@@ -42119,6 +42259,7 @@ export {
   buildVoiceLiveOpsControlState,
   buildVoiceLatencySLOGate,
   buildVoiceIncidentTimelineReport,
+  buildVoiceIncidentRecoveryTrendReport,
   buildVoiceIncidentRecoveryOutcomeReport,
   buildVoiceIncidentRecoveryOutcomeReadinessCheck,
   buildVoiceIncidentBundle,

package/package.json

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