@odla-ai/cli 0.25.10 → 0.25.12

package/README.md

@@ -72,10 +72,15 @@ snapshot instead of scraping Studio or composing collector routes themselves:
 npx odla-ai o11y status --app <appId> --env prod --minutes 60 --json
 ```
 
-Schema v4 keeps application RED, reconciled live-sync load/freshness and
+Schema v6 keeps application RED, an `applicationVersions` breakdown of
+request/error/latency evidence by exact Cloudflare Worker version, reconciled
+live-sync load/freshness and
 subscription recompute/fanout/payload/commit-to-send performance, the exact
 latest protected commit-to-visible canary, collector ingest/scheduler trust,
-and Cloudflare-owned Worker runtime evidence separate. It derives one
+the live Cloudflare Worker read, and 30-day-retained provider snapshot history
+with a seven-day maximum per read separate. Scheduled collection failures,
+source age, expected cadence, collection lag, and history truncation remain
+machine-readable. It derives one
 `healthy`, `degraded`, or `unhealthy` verdict with stable reason codes while
 retaining every source response for diagnosis. Provider unavailability,
 adaptive sampling, publication delay, collector loss, quota rejection, stale

package/dist/bin.cjs

@@ -2388,7 +2388,7 @@ var CAPABILITIES = {
     "compose declared app-capability schema/rules, create guarded seeds when absent, and configure platform AI, auth, and deployment links",
     "apply Google Calendar booking config, then drive state-bound consent, status, discovery, and disconnect flows (bookings run live through the platform proxy)",
     "validate integration contracts offline and smoke-test a provisioned db environment plus anonymous capability routes",
-    "read one versioned o11y status envelope spanning application RED, current live-sync freshness/load, the protected commit-to-visible canary, collector ingest/scheduler trust, provider-owned runtime metrics, and a bounded machine verdict",
+    "read one versioned o11y status envelope spanning application RED, exact Worker versions observed in traffic, current live-sync freshness/load, the protected commit-to-visible canary, collector ingest/scheduler trust, provider-owned runtime metrics, and a bounded machine verdict",
     "inspect durable agent wakeups as a versioned JSON envelope and explicitly requeue one dead-lettered job with a scoped environment credential",
     "run app-attributed hosted security discovery and independent validation without provider keys",
     "connect/revoke source-read-only GitHub sources and drive commit-pinned hosted security jobs without PATs or provider keys",
@@ -2410,7 +2410,7 @@ var CAPABILITIES = {
     "approve GitHub App repository access separately from redacted-snippet disclosure"
   ],
   studio: [
-    "view application telemetry, reconciled live-sync load/freshness, commit-to-visible canary health, provider-owned Worker runtime metrics, and environment state",
+    "view application telemetry grouped by exact Worker version, reconciled live-sync load/freshness, commit-to-visible canary health, provider-owned Worker runtime metrics, and environment state",
     "let signed-in users inventory/revoke their own agent grants and admins audit/global-revoke them",
     "review calendar connection, granted read scope, selected calendars, and sync health without exposing provider tokens",
     "perform manual credential recovery \u2014 for the primary owner or any co-owner \u2014 when the CLI's local shown-once copy is unavailable",
@@ -8115,6 +8115,7 @@ function statusVerdict(reads) {
   sourceHttp(reasons, "canary", reads.canary);
   sourceHttp(reasons, "collector", reads.collector);
   sourceHttp(reasons, "provider", reads.provider);
+  sourceHttp(reasons, "provider", reads.providerHistory, "provider_history_");
   const liveStatus = String(reads.liveSync.body.status ?? "");
   if (liveStatus === "partial") {
     reasons.push({
@@ -8186,6 +8187,14 @@ function statusVerdict(reads) {
       severity: "degraded"
     });
   }
+  const providerHistoryStatus = String(reads.providerHistory.body.status ?? "");
+  if (providerHistoryStatus && providerHistoryStatus !== "observed" && providerHistoryStatus !== "no_data") {
+    reasons.push({
+      source: "provider",
+      code: `provider_history_${providerHistoryStatus}`,
+      severity: "degraded"
+    });
+  }
   return {
     status: reasons.some((reason) => reason.severity === "unhealthy") ? "unhealthy" : reasons.length > 0 ? "degraded" : "healthy",
     reasons
@@ -8205,15 +8214,80 @@ function collectorReason(read3, fallback) {
   );
   return typeof first?.code === "string" && first.code ? first.code : fallback;
 }
-function sourceHttp(reasons, source, read3) {
+function sourceHttp(reasons, source, read3, prefix = "") {
   if (read3.httpStatus >= 200 && read3.httpStatus < 300) return;
   reasons.push({
     source,
-    code: `http_${read3.httpStatus}`,
+    code: `${prefix}http_${read3.httpStatus}`,
     severity: read3.httpStatus >= 500 && read3.httpStatus !== 501 ? "unhealthy" : "degraded"
   });
 }
 
+// src/o11y-output.ts
+function printO11yStatus(status, out) {
+  out.log(
+    `o11y status ${status.scope.appId}/${status.scope.env} (${status.scope.minutes}m)`
+  );
+  const routes = Array.isArray(status.application.body.routes) ? status.application.body.routes.filter(record6) : [];
+  const requests = routes.reduce(
+    (total, row) => total + numeric3(row.requests),
+    0
+  );
+  const errors = routes.reduce(
+    (total, row) => total + numeric3(row.errors),
+    0
+  );
+  out.log(
+    `application	${status.application.httpStatus}	${requests} requests	${errors} errors`
+  );
+  const versions = Array.isArray(status.applicationVersions.body.rows) ? status.applicationVersions.body.rows.filter(record6) : [];
+  out.log(
+    `application-versions	${status.applicationVersions.httpStatus}	${versions.length ? versions.slice(0, 5).map(
+      (row) => `${String(row.value || "(unattributed)")}:${numeric3(row.requests)}`
+    ).join(", ") : "none observed"}`
+  );
+  out.log(liveSyncLine(status.liveSync));
+  const canaryDurations = record6(status.canary.body.durationsMs) ? status.canary.body.durationsMs : {};
+  out.log(
+    `canary	${status.canary.httpStatus}	${String(status.canary.body.status ?? status.canary.body.error ?? "unavailable")}	${optionalNumeric(canaryDurations.publishToVisibleMs)} publish-to-visible`
+  );
+  const collectorIngest = record6(status.collector.body.ingest) ? status.collector.body.ingest : {};
+  const collectorStorage = record6(collectorIngest.storage) ? collectorIngest.storage : {};
+  out.log(
+    `collector	${status.collector.httpStatus}	${String(status.collector.body.status ?? status.collector.body.error ?? "unavailable")}	${numeric3(collectorStorage.affectedPoints)} affected points`
+  );
+  const providerMetrics = record6(status.provider.body.metrics) ? status.provider.body.metrics : {};
+  out.log(
+    `cloudflare	${status.provider.httpStatus}	${String(status.provider.body.status ?? status.provider.body.error ?? "unavailable")}	${numeric3(providerMetrics.requests)} invocations	${numeric3(providerMetrics.errors)} runtime errors`
+  );
+  const providerPoints = Array.isArray(status.providerHistory.body.points) ? status.providerHistory.body.points.length : 0;
+  const providerFreshness = record6(status.providerHistory.body.freshness) ? status.providerHistory.body.freshness : {};
+  out.log(
+    `cloudflare-history	${status.providerHistory.httpStatus}	${String(status.providerHistory.body.status ?? status.providerHistory.body.error ?? "unavailable")}	${providerPoints} snapshots	${optionalAge(providerFreshness.ageMs)} old`
+  );
+  out.log(
+    `verdict	${status.verdict.status}	${status.verdict.reasons.map((reason) => `${reason.source}:${reason.code}`).join(", ") || "all required signals healthy"}`
+  );
+}
+function liveSyncLine(read3) {
+  const performance = record6(read3.body.performance) ? read3.body.performance : {};
+  const commitToSend = record6(performance.commitToSend) ? performance.commitToSend : {};
+  return `live-sync	${read3.httpStatus}	${String(read3.body.status ?? read3.body.error ?? "unavailable")}	${numeric3(read3.body.activeConnections)} active	${optionalNumeric(commitToSend.p95)} commit-to-send p95	${numeric3(performance.sendFailures)} send failures`;
+}
+function record6(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function numeric3(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : 0;
+}
+function optionalNumeric(value) {
+  return typeof value === "number" && Number.isFinite(value) ? `${value} ms` : "\u2014";
+}
+function optionalAge(value) {
+  if (typeof value !== "number" || !Number.isFinite(value)) return "unknown";
+  return `${Math.max(0, Math.round(value / 1e3))}s`;
+}
+
 // src/o11y-command.ts
 async function o11yCommand(parsed, deps = {}) {
   assertArgs(
@@ -8251,8 +8325,23 @@ async function o11yCommand(parsed, deps = {}) {
   const base = `${cfg.platformUrl}/o11y/${encodeURIComponent(appId)}`;
   const query = new URLSearchParams({ env, minutes: String(minutes) });
   const headers = { authorization: `Bearer ${token}` };
-  const [application, liveSync, canary, collector, provider] = await Promise.all([
+  const versionsQuery = new URLSearchParams({
+    env,
+    minutes: String(minutes),
+    dimension: "version",
+    metric: "requests"
+  });
+  const [
+    application,
+    applicationVersions,
+    liveSync,
+    canary,
+    collector,
+    provider,
+    providerHistory
+  ] = await Promise.all([
     read2(`${base}/metrics/red?${query}`, headers, doFetch),
+    read2(`${base}/explore?${versionsQuery}`, headers, doFetch),
     read2(
       `${base}/live-sync/health?${query}`,
       headers,
@@ -8264,31 +8353,35 @@ async function o11yCommand(parsed, deps = {}) {
       doFetch
     ),
     read2(`${base}/self-health?${query}`, headers, doFetch),
-    read2(`${base}/provider/cloudflare?${query}`, headers, doFetch)
+    read2(`${base}/provider/cloudflare?${query}`, headers, doFetch),
+    read2(`${base}/provider/cloudflare/history?${query}`, headers, doFetch)
   ]);
   const verdict = statusVerdict({
     application,
     liveSync,
     canary,
     collector,
-    provider
+    provider,
+    providerHistory
   });
   const status = {
-    schemaVersion: 4,
+    schemaVersion: 6,
     scope: { appId, env, minutes },
     observedAt: (/* @__PURE__ */ new Date()).toISOString(),
     verdict,
     application,
+    applicationVersions,
     liveSync,
     canary,
     collector,
-    provider
+    provider,
+    providerHistory
   };
   if (parsed.options.json === true) {
     out.log(JSON.stringify(status, null, 2));
     return;
   }
-  printStatus2(status, out);
+  printO11yStatus(status, out);
 }
 function statusMinutes(value) {
   if (!Number.isSafeInteger(value) || value < 1 || value > 7 * 24 * 60) {
@@ -8310,56 +8403,6 @@ async function read2(url, headers, doFetch) {
   }
   return { httpStatus: response2.status, body };
 }
-function printStatus2(status, out) {
-  out.log(
-    `o11y status ${status.scope.appId}/${status.scope.env} (${status.scope.minutes}m)`
-  );
-  const routes = Array.isArray(status.application.body.routes) ? status.application.body.routes.filter(record6) : [];
-  const requests = routes.reduce(
-    (total, row) => total + numeric3(row.requests),
-    0
-  );
-  const errors = routes.reduce(
-    (total, row) => total + numeric3(row.errors),
-    0
-  );
-  out.log(
-    `application	${status.application.httpStatus}	${requests} requests	${errors} errors`
-  );
-  out.log(
-    liveSyncLine(status.liveSync)
-  );
-  const canaryDurations = record6(status.canary.body.durationsMs) ? status.canary.body.durationsMs : {};
-  out.log(
-    `canary	${status.canary.httpStatus}	${String(status.canary.body.status ?? status.canary.body.error ?? "unavailable")}	${optionalNumeric(canaryDurations.publishToVisibleMs)} publish-to-visible`
-  );
-  const collectorIngest = record6(status.collector.body.ingest) ? status.collector.body.ingest : {};
-  const collectorStorage = record6(collectorIngest.storage) ? collectorIngest.storage : {};
-  out.log(
-    `collector	${status.collector.httpStatus}	${String(status.collector.body.status ?? status.collector.body.error ?? "unavailable")}	${numeric3(collectorStorage.affectedPoints)} affected points`
-  );
-  const providerMetrics = record6(status.provider.body.metrics) ? status.provider.body.metrics : {};
-  out.log(
-    `cloudflare	${status.provider.httpStatus}	${String(status.provider.body.status ?? status.provider.body.error ?? "unavailable")}	${numeric3(providerMetrics.requests)} invocations	${numeric3(providerMetrics.errors)} runtime errors`
-  );
-  out.log(
-    `verdict	${status.verdict.status}	${status.verdict.reasons.map((reason) => `${reason.source}:${reason.code}`).join(", ") || "all required signals healthy"}`
-  );
-}
-function liveSyncLine(read3) {
-  const performance = record6(read3.body.performance) ? read3.body.performance : {};
-  const commitToSend = record6(performance.commitToSend) ? performance.commitToSend : {};
-  return `live-sync	${read3.httpStatus}	${String(read3.body.status ?? read3.body.error ?? "unavailable")}	${numeric3(read3.body.activeConnections)} active	${optionalNumeric(commitToSend.p95)} commit-to-send p95	${numeric3(performance.sendFailures)} send failures`;
-}
-function record6(value) {
-  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
-function numeric3(value) {
-  return typeof value === "number" && Number.isFinite(value) ? value : 0;
-}
-function optionalNumeric(value) {
-  return typeof value === "number" && Number.isFinite(value) ? `${value} ms` : "\u2014";
-}
 
 // src/provision.ts
 var import_apps5 = require("@odla-ai/apps");