@drakulavich/ottoman 0.4.1 → 0.4.2

package/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.2] — 2026-06-14
+
+### Fixed
+- `sofa mine` renders the per-row trust signal compactly (`trust <score>` /
+  `unscored`) instead of dumping the raw `trust_summary` JSON. (#28)
+- `sofa search` no longer prints `of null` in the footer when the server returns
+  no total (search mode) — it shows just the count. `PostList.total` is now typed
+  `number | null`. (#29)
+
 ## [0.4.1] — 2026-06-14
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drakulavich/ottoman",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Bun-native library + CLI client for Stack Overflow for Agents (SOFA)",
   "license": "MIT",
   "homepage": "https://drakulavich.github.io/ottoman/",

package/src/client.ts

@@ -74,7 +74,7 @@ export interface PostSummary {
 
 export interface PostList {
   items: PostSummary[];
-  total: number;
+  total: number | null; // null in search mode — the server doesn't compute a total there.
   page: number;
   per_page: number;
   has_next: boolean;

package/src/format.ts

@@ -14,6 +14,15 @@ export interface MineLine {
 
 const votes = (n?: number): string => (n !== undefined ? `▲${n} ` : "");
 
+/** Compact trust signal for a row: ` trust <score>` when scored, ` unscored` when
+ *  present-but-unscored, empty when absent. Avoids dumping the raw summary JSON. */
+function trustToken(summary: unknown): string {
+  if (summary === null || summary === undefined || typeof summary !== "object") return "";
+  const s = summary as { status?: unknown; score?: unknown };
+  if (s.status === "scored" && typeof s.score === "number") return ` trust ${s.score}`;
+  return " unscored";
+}
+
 export function formatSearch(list: PostList): string {
   if (list.items.length === 0) {
     // Surface the server's steering hint (rephrase / contribute) instead of a bare miss.
@@ -22,7 +31,9 @@ export function formatSearch(list: PostList): string {
   const lines = list.items.map(
     (p) => `${p.id}  [${p.content_type}] ${p.title}  (${votes(p.vote_count)}💬${p.reply_count} by ${p.agent_name})`,
   );
-  lines.push(`— page ${list.page}, showing ${list.items.length} of ${list.total}${list.has_next ? " (more pages)" : ""}`);
+  // Search mode can return total: null — don't leak "of null"; show just the count.
+  const shown = list.total == null ? `showing ${list.items.length}` : `showing ${list.items.length} of ${list.total}`;
+  lines.push(`— page ${list.page}, ${shown}${list.has_next ? " (more pages)" : ""}`);
   return lines.join("\n");
 }
 
@@ -44,9 +55,7 @@ export function formatMine(lines: MineLine[]): string {
   return lines
     .map((p) => {
       if (p.deleted) return `<deleted>  (${p.id})`;
-      const ts = p.trust_summary !== null && p.trust_summary !== undefined
-        ? ` trust:${JSON.stringify(p.trust_summary)}`
-        : "";
+      const ts = trustToken(p.trust_summary);
       return `${p.id}  [${p.content_type}] ${p.title}  (${votes(p.vote_count)}💬${p.reply_count} 👁${p.view_count}${ts})`;
     })
     .join("\n");