@odla-ai/cli 0.25.9 → 0.25.11

package/README.md

@@ -72,10 +72,13 @@ 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 v5 keeps application RED, 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
@@ -238,6 +241,14 @@ advancing the cursor. A restore or truncated history exits 3 and emits an
 explicit replacement checkpoint; an explicit timeout exits 75, and an
 exhausted remote retry exits 6.
 
+`discuss read <topic> --json` follows the server's bounded forward post pages
+before emitting one complete document. A long-lived agent can therefore watch
+an event and then read the full topic rather than receiving an apparently
+successful response capped to its oldest 200 posts. Use `--limit <n>
+--offset <n>` to request one bounded page instead; complete reads fail closed
+after 10,000 posts or three continuously changing scans rather than consuming
+memory forever or claiming an inconsistent result.
+
 `code connect` is the first-party personal Code terminal runtime. Run the exact
 command copied from **Studio → Code → Terminal** while your shell is in the
 local Git checkout. `--platform`, `--app-id`, and `--env` make the requested

package/dist/bin.cjs

@@ -6563,7 +6563,7 @@ Usage:
   odla-ai pm handoff --app <id> [--json]
   odla-ai discuss groups [--json]
   odla-ai discuss list [--app <id>] [--q <text>] [--state open|resolved|all] [--json]
-  odla-ai discuss read <topic> [--json]
+  odla-ai discuss read <topic> [--limit <n> --offset <n>] [--json]
   odla-ai discuss post --app <id> --subject "..." --body "..." [--markup "... @[Label](kind/id)"] [--mutation-id <id>]
   odla-ai discuss reply <topic> --body "..." [--markup "..."] [--mutation-id <id>]
   odla-ai discuss resolve <topic> [--reopen] [--mutation-id <id>]
@@ -7409,22 +7409,59 @@ async function discussList(ctx, parsed) {
     }
   });
 }
-async function discussRead(ctx, id) {
-  const result = await request(
-    ctx,
-    "GET",
-    `/topics/${encodeURIComponent(id)}`
-  );
-  emit(ctx, result, () => {
-    ctx.out.log(`${result.topic.subject}  [${state(result.topic)}]  ${result.topic.appId ?? ""}`);
-    for (const post of result.posts) {
-      const who = post.authorKind === "bot" ? `${post.authorId} (agent)` : post.authorId;
-      ctx.out.log(`
-\u2014 ${who}`);
-      ctx.out.log(bodyWithRefs(post));
-      for (const file of post.attachments ?? []) ctx.out.log(`  [attachment] ${file.name} (${file.size} bytes)`);
+async function discussRead(ctx, id, parsed) {
+  const requestedLimit = stringOpt(parsed.options.limit);
+  const requestedOffset = stringOpt(parsed.options.offset);
+  if (requestedLimit !== void 0 || requestedOffset !== void 0) {
+    const query = new URLSearchParams({
+      limit: requestedLimit ?? "200",
+      offset: requestedOffset ?? "0"
+    });
+    const page = await request(ctx, "GET", `/topics/${encodeURIComponent(id)}?${query}`);
+    emit(ctx, page, () => renderRead(ctx, page.topic, page.posts));
+    return;
+  }
+  for (let scan = 0; scan < 3; scan++) {
+    const posts = /* @__PURE__ */ new Map();
+    let topic = null;
+    let offset = 0;
+    for (; ; ) {
+      const page = await request(
+        ctx,
+        "GET",
+        `/topics/${encodeURIComponent(id)}?limit=200&offset=${offset}`
+      );
+      topic = page.topic;
+      for (const post of page.posts) posts.set(post.id, post);
+      if (posts.size > 1e4) throw new Error("discuss read failed: conversation exceeds 10000 posts");
+      if (!page.page?.hasMore) break;
+      if (page.page.nextOffset === null || page.page.nextOffset <= offset) {
+        throw new Error("discuss read failed: registry returned a non-advancing post page");
+      }
+      offset = page.page.nextOffset;
     }
-  });
+    const ordered = [...posts.values()].sort(
+      (a, b) => a.createdAt - b.createdAt || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0)
+    );
+    const expected = Number.isInteger(topic.replyCount) ? topic.replyCount + 1 : ordered.length;
+    if (ordered.length === expected) {
+      const result = { topic, posts: ordered };
+      emit(ctx, result, () => renderRead(ctx, result.topic, result.posts));
+      return;
+    }
+    if (offset === 0) throw new Error("discuss read failed: registry did not provide forward post pages");
+  }
+  throw new Error("discuss read failed: conversation changed during every complete-read attempt");
+}
+function renderRead(ctx, topic, posts) {
+  ctx.out.log(`${topic.subject}  [${state(topic)}]  ${topic.appId ?? ""}`);
+  for (const post of posts) {
+    const who = post.authorKind === "bot" ? `${post.authorId} (agent)` : post.authorId;
+    ctx.out.log(`
+\u2014 ${who}`);
+    ctx.out.log(bodyWithRefs(post));
+    for (const file of post.attachments ?? []) ctx.out.log(`  [attachment] ${file.name} (${file.size} bytes)`);
+  }
 }
 async function discussPost(ctx, parsed) {
   const appId = stringOpt(parsed.options.app);
@@ -7751,7 +7788,7 @@ async function discussCommand(parsed, deps = {}) {
     case "topics":
       return discussList(ctx, parsed);
     case "read":
-      return discussRead(ctx, requireId(id, "read"));
+      return discussRead(ctx, requireId(id, "read"), parsed);
     case "post":
       return discussPost(ctx, parsed);
     case "reply":
@@ -8078,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({
@@ -8149,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
@@ -8168,11 +8214,11 @@ 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"
   });
 }
@@ -8214,7 +8260,7 @@ 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 [application, liveSync, canary, collector, provider, providerHistory] = await Promise.all([
     read2(`${base}/metrics/red?${query}`, headers, doFetch),
     read2(
       `${base}/live-sync/health?${query}`,
@@ -8227,17 +8273,19 @@ 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: 5,
     scope: { appId, env, minutes },
     observedAt: (/* @__PURE__ */ new Date()).toISOString(),
     verdict,
@@ -8245,7 +8293,8 @@ async function o11yCommand(parsed, deps = {}) {
     liveSync,
     canary,
     collector,
-    provider
+    provider,
+    providerHistory
   };
   if (parsed.options.json === true) {
     out.log(JSON.stringify(status, null, 2));
@@ -8305,6 +8354,11 @@ function printStatus2(status, out) {
   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"}`
   );
@@ -8323,6 +8377,10 @@ function numeric3(value) {
 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/provision.ts
 var import_apps5 = require("@odla-ai/apps");