ryugi-artifacts 1.60.0 → 1.61.0

package/README.md

@@ -53,6 +53,14 @@ together. A successful operation can still have unresolved validation evidence.
 Review reads are read-only. Preview a bounded page, read complete evidence, then
 explicitly acknowledge its receipt after using that evidence:
 
+For a complete review in one request, run
+`ryugi-artifacts comment list --artifact document/plan --sections all --detail`.
+Documents include threads/asks; artboards include threads/groups/rounds. Each
+collection retains its own page, snapshot and continuation. Only a complete
+unread thread page issues a receipt; state collections do not. Follow every
+relevant continuation before concluding. Filters, fields and existing cursors
+or snapshots require the single-collection form below.
+
 ```sh
 ryugi-artifacts comment list --artifact document/plan --section threads --format brief
 ryugi-artifacts comment read --artifact document/plan --thread THREAD --detail

package/dist/cli.cjs

@@ -448,6 +448,15 @@ var requiredReviewFields = {
   groups: ["id", "kind", "verdict", "choice"],
   rounds: ["id", "state"]
 };
+var reviewSectionsFor = (artifact) => artifact.startsWith("document/") ? ["threads", "asks"] : ["threads", "groups", "rounds"];
+function validateReviewBundle(input, artifact) {
+  if (input.section) return "Choose section or sections, not both.";
+  if (!input.sections.length || new Set(input.sections).size !== input.sections.length || input.sections.some((section) => !reviewSectionsFor(artifact).includes(section)))
+    return "Choose distinct review sections supported by this artifact.";
+  if (input.fields || input.cursor || input.snapshot || input.thread || input.filters && Object.values(input.filters).some((value3) => value3 !== void 0))
+    return "Fields, filters, thread, cursor and snapshot require a single --section. Follow each collection continuation separately.";
+  return null;
+}
 function validateReviewQuery(input) {
   const { section, filters } = input;
   if (!section && (input.detail || input.cursor || input.fields || filters && Object.values(filters).some(Boolean)))
@@ -523,6 +532,7 @@ function clip(text, size = 160) {
   return segments.length > size ? `${segments.slice(0, size).map((s) => s.segment).join("")}\u2026` : text;
 }
 var scalar = (value3) => value3 === null ? "none" : typeof value3 === "object" ? JSON.stringify(value3) : String(value3);
+var scopeText = (page) => `${clean(page.scope)} \xB7 ${page.returned} shown${page.total === null ? "" : ` / ${page.total} matched`}${page.hasMore ? " \xB7 more available" : ""}`;
 var quote = (value3) => /^[\w./:@=+-]+$/.test(value3) ? value3 : `'${value3.replaceAll("'", "'\\''")}'`;
 function actionText(action) {
   return action.kind === "command" ? action.argv.map(quote).join(" ") : action.url;
@@ -581,8 +591,12 @@ function renderText(view, wire, options, collection, requiredFields = []) {
       continue;
     }
     if (!collection && !selected(section.key)) continue;
+    if (section.page)
+      lines.push(
+        `${clean("title" in section && section.title || section.key)}: ${section.status ? `${clean(section.status)} \xB7 ` : ""}${scopeText(section.page)}`
+      );
     if (section.kind === "records") {
-      if (section.title) lines.push(clean(section.title));
+      if (section.title && !section.page) lines.push(clean(section.title));
       const declared = new Set(section.columns.map((column) => column.key));
       const extra = section.key === collection ? [.../* @__PURE__ */ new Set([...options.fields ?? [], ...requiredFields])].filter((key) => !declared.has(key)).map((key) => ({ key, label: key })) : [];
       const columns2 = [...section.columns, ...extra].filter(
@@ -614,7 +628,22 @@ function renderText(view, wire, options, collection, requiredFields = []) {
               return cell === void 0 || cell === "" ? [] : [`${clean(column.label)}=${cell}`];
             }).join(" \xB7 ")}`
           );
-      if (!rows.length) lines.push("No records.");
+      if (!rows.length && !section.page) lines.push("No records.");
+    } else if (section.kind === "messages") {
+      if (section.title && !section.page) lines.push(`${clean(section.title)}:`);
+      const metadata = (items) => items.map((item) => `${clean(item.label)}=${clean(scalar(item.binding.value))}`).join(" \xB7 ");
+      for (const group of section.groups) {
+        lines.push(`  ${metadata(group.facts)}`);
+        for (const message of group.messages) {
+          lines.push(`    ${metadata(message.facts)}`);
+          lines.push(
+            ...message.text.split("\n").map(
+              (line) => `      ${line.replaceAll(new RegExp("\\p{Cc}", "gu"), (char) => char === "	" ? char : "")}`
+            )
+          );
+        }
+      }
+      if (!section.groups.length && !section.page) lines.push("No messages.");
     } else if (section.kind === "diagnostics") {
       const limit = options.detail ? section.items.length : section.preview ?? 3;
       for (const item of section.items.slice(0, limit))
@@ -628,7 +657,7 @@ function renderText(view, wire, options, collection, requiredFields = []) {
           count: section.items.length - limit
         });
     } else {
-      if (section.title) lines.push(`${clean(section.title)}:`);
+      if (section.title && !section.page) lines.push(`${clean(section.title)}:`);
       lines.push(
         ...section.text.trimEnd().split("\n").map(
           (line) => `  ${line.replaceAll(new RegExp("\\p{Cc}", "gu"), (char) => char === "	" || char === "\n" ? char : "")}`
@@ -636,10 +665,7 @@ function renderText(view, wire, options, collection, requiredFields = []) {
       );
     }
   }
-  if (wire.page)
-    lines.push(
-      `Scope: ${clean(wire.page.scope)} \xB7 ${wire.page.returned} shown${wire.page.total === null ? "" : ` / ${wire.page.total} matched`}${wire.page.hasMore ? " \xB7 more available" : ""}`
-    );
+  if (wire.page) lines.push(`Scope: ${scopeText(wire.page)}`);
   lines.push(...effectLines(wire.effects ?? []));
   for (const warning of wire.warnings ?? []) lines.push(`Warning: ${clean(warning.message)}`);
   if (omissions.length)
@@ -1184,17 +1210,9 @@ function presentRead({ data }) {
     subject: data.artifact,
     facts: [
       fact("Section", field(data, "section"), true),
-      ...data.summary ? [fact("Summary", field(data, "summary"))] : [],
-      ...data.receipt ? [fact("Receipt", field(data, "receipt"), true)] : []
+      ...data.summary ? [fact("Summary", field(data, "summary"))] : []
     ],
-    sections: data.section === "summary" ? [] : data.evidence === "complete" ? [
-      {
-        kind: "content",
-        key: "items",
-        title: "Complete evidence",
-        text: JSON.stringify(data.items, null, 2)
-      }
-    ] : [
+    sections: data.section === "summary" ? [] : data.evidence === "complete" ? [messageSection(data.items)] : [
       {
         kind: "records",
         key: "items",
@@ -1204,10 +1222,194 @@ function presentRead({ data }) {
     ]
   };
 }
+function messageSection(items) {
+  const metadata = (item, excluded) => Object.entries(item).filter(([key]) => key !== excluded).map(([key, value3]) => ({ label: key, binding: { key, value: value3 } }));
+  return {
+    kind: "messages",
+    key: "items",
+    groups: items.map((item) => ({
+      facts: metadata(item, "messages"),
+      messages: (Array.isArray(item.messages) ? item.messages : []).map(
+        (message) => ({
+          facts: metadata(message, "text"),
+          text: typeof message.text === "string" ? message.text : JSON.stringify(message.text ?? null)
+        })
+      )
+    }))
+  };
+}
+function bundledReview(input, artifact, operation) {
+  if (operation !== "list")
+    throw new OutputError({
+      code: "E_ARGUMENT_INVALID",
+      message: "--sections applies to comment list."
+    });
+  const read2 = query(input);
+  const selection = value(input, "sections")?.trim();
+  const sections = selection === "all" ? reviewSectionsFor(artifact) : (selection ?? "").split(",").map((name) => name.trim());
+  const filters = Object.fromEntries(
+    ["status", "waiting-on", "kind", "choice-state"].map((key) => [key, value(input, key)])
+  );
+  const invalid = validateReviewBundle(
+    {
+      ...read2,
+      sections,
+      section: value(input, "section"),
+      thread: value(input, "thread"),
+      filters
+    },
+    artifact
+  );
+  if (invalid) throw new OutputError({ code: "E_ARGUMENT_INVALID", message: invalid });
+  return bindCommand(
+    {
+      id: "comment.list",
+      mode: "finite",
+      output: { formats, detail: true },
+      async run(_input, ctx) {
+        const json = await call(input, ctx, artifact, "review", { op: "list", sections, ...read2 });
+        const data = {};
+        const actions = [];
+        const omitted = [];
+        for (const name of sections) {
+          const raw = json.sections?.[name];
+          if (!raw || !Array.isArray(raw.items) || typeof raw.snapshot !== "string" || !raw.page || typeof raw.page.scope !== "string" || typeof raw.page.hasMore !== "boolean" || !Number.isInteger(raw.page.returned) || !(raw.page.total === null || Number.isInteger(raw.page.total)))
+            throw new OutputError({
+              code: "E_SERVER_UPGRADE_REQUIRED",
+              message: "The server does not provide combined review pages. Run start --background for this project to rebuild/restart it."
+            });
+          if (raw.page.returned !== raw.items.length || raw.page.returned < 0 || raw.page.total !== null && raw.page.total < raw.page.returned || raw.page.snapshot !== raw.snapshot || !(raw.page.nextCursor === null || typeof raw.page.nextCursor === "string") || raw.page.hasMore !== (typeof raw.page.nextCursor === "string" && raw.page.nextCursor.length > 0))
+            throw new OutputError({
+              code: "E_PROTOCOL_MISMATCH",
+              message: "The server returned inconsistent combined review coverage."
+            });
+          const report2 = readResult(input, artifact, name, raw, read2);
+          const { artifact: _artifact, section: _section, ...entry } = report2.data;
+          data[name] = { ...entry, page: raw.page };
+          actions.push(
+            ...report2.actions.map((action) => ({
+              ...action,
+              label: `${name} ${action.label ?? "Next"}`
+            }))
+          );
+          if (entry.evidence === "preview" && name === "threads")
+            omitted.push({ path: "data.sections.threads.items.messages", reason: "summary" });
+        }
+        return result({ artifact, sections: data }, void 0, { actions, coverage: { omitted } });
+      },
+      present({ data }) {
+        return {
+          heading: "Review",
+          status: read2.detail ? "complete" : "preview",
+          subject: artifact,
+          facts: [],
+          sections: Object.entries(data.sections).flatMap(
+            ([name, entry]) => presentRead(result({ ...entry, artifact, section: name })).sections.map((section) => ({
+              ...section,
+              key: name,
+              title: name[0].toUpperCase() + name.slice(1),
+              page: entry.page,
+              status: entry.evidence
+            }))
+          )
+        };
+      }
+    },
+    input
+  );
+}
+function readResult(input, artifact, section, json, read2, thread) {
+  const page = json.page;
+  const data = {
+    artifact,
+    section: section ?? "summary",
+    items: json.items ?? [],
+    evidence: read2.fields ? "projected" : section && section !== "threads" ? "state" : read2.detail || thread ? "complete" : "preview",
+    ...json.snapshot ? { snapshot: json.snapshot } : {},
+    ...json.receipt ? { receipt: json.receipt } : {},
+    ...json.summary ? { summary: json.summary } : {}
+  };
+  const actions = [];
+  const args = targetArgs(input, artifact);
+  if (json.receipt)
+    actions.push(
+      commandAction(["comment", "ack", ...args, "--receipt", json.receipt], "Acknowledge")
+    );
+  if (page?.nextCursor)
+    actions.push(
+      commandAction(
+        [
+          "comment",
+          "list",
+          ...args,
+          "--section",
+          section,
+          ...read2.detail ? ["--detail"] : [],
+          ...Object.entries({
+            "status": value(input, "status"),
+            "waiting-on": value(input, "waiting-on"),
+            "kind": value(input, "kind"),
+            "choice-state": value(input, "choice-state"),
+            "fields": value(input, "fields"),
+            "limit": value(input, "limit")
+          }).flatMap(([key, value3]) => value3 ? [`--${key}`, value3] : []),
+          ...read2.all ? ["--all"] : [],
+          "--cursor",
+          page.nextCursor
+        ],
+        "More"
+      )
+    );
+  if (!section) {
+    actions.push(
+      commandAction(
+        [
+          "comment",
+          "list",
+          ...args,
+          "--sections",
+          "all",
+          "--detail",
+          ...read2.all ? ["--all"] : [],
+          ...value(input, "limit") ? ["--limit", value(input, "limit")] : []
+        ],
+        "Review"
+      )
+    );
+    actions.push(commandAction(["comment", "list", ...args, "--section", "threads"], "Threads"));
+    if (artifact.startsWith("document/"))
+      actions.push(
+        commandAction(["comment", "list", ...args, "--section", "asks", "--detail"], "Answers")
+      );
+  } else if (section === "threads" && data.evidence === "preview" && data.items[0])
+    actions.push(
+      commandAction(
+        [
+          "comment",
+          "read",
+          ...args,
+          "--thread",
+          String(data.items[0].id),
+          "--snapshot",
+          json.snapshot,
+          "--detail"
+        ],
+        "Read"
+      )
+    );
+  return result(data, void 0, {
+    actions,
+    coverage: {
+      ...page ? { page } : {},
+      ...data.evidence === "preview" && section === "threads" ? { omitted: [{ path: "data.items.messages", reason: "summary" }] } : {}
+    }
+  });
+}
 function reviewSemantic(input) {
   const artifact = artifactOf(input);
   const operation = input.positionals[0];
   if (operation === "ack") return ack(input, artifact, "review");
+  if (input.values.sections !== void 0) return bundledReview(input, artifact, operation);
   if (operation !== "list" && operation !== "read")
     throw new OutputError({ code: "E_ARGUMENT_INVALID", message: "Expected list, read or ack." });
   const read2 = query(input);
@@ -1251,81 +1453,7 @@ function reviewSemantic(input) {
           ...thread ? { thread, detail: true } : {},
           ...Object.keys(filters).length ? { filters } : {}
         });
-        const page = json.page;
-        const data = {
-          artifact,
-          section: section ?? "summary",
-          items: json.items ?? [],
-          evidence: read2.fields ? "projected" : section && section !== "threads" ? "state" : read2.detail || thread ? "complete" : "preview",
-          ...json.snapshot ? { snapshot: json.snapshot } : {},
-          ...json.receipt ? { receipt: json.receipt } : {},
-          ...json.summary ? { summary: json.summary } : {}
-        };
-        const actions = [];
-        const args = targetArgs(input, artifact);
-        if (json.receipt)
-          actions.push(
-            commandAction(["comment", "ack", ...args, "--receipt", json.receipt], "Acknowledge")
-          );
-        if (page?.nextCursor)
-          actions.push(
-            commandAction(
-              [
-                "comment",
-                "list",
-                ...args,
-                "--section",
-                section,
-                ...read2.detail ? ["--detail"] : [],
-                ...Object.entries({
-                  "status": value(input, "status"),
-                  "waiting-on": value(input, "waiting-on"),
-                  "kind": value(input, "kind"),
-                  "choice-state": value(input, "choice-state"),
-                  "fields": value(input, "fields"),
-                  "limit": value(input, "limit")
-                }).flatMap(([key, value3]) => value3 ? [`--${key}`, value3] : []),
-                ...read2.all ? ["--all"] : [],
-                "--cursor",
-                page.nextCursor
-              ],
-              "More"
-            )
-          );
-        if (!section) {
-          actions.push(
-            commandAction(["comment", "list", ...args, "--section", "threads"], "Threads")
-          );
-          if (artifact.startsWith("document/"))
-            actions.push(
-              commandAction(
-                ["comment", "list", ...args, "--section", "asks", "--detail"],
-                "Answers"
-              )
-            );
-        } else if (section === "threads" && data.evidence === "preview" && data.items[0])
-          actions.push(
-            commandAction(
-              [
-                "comment",
-                "read",
-                ...args,
-                "--thread",
-                String(data.items[0].id),
-                "--snapshot",
-                json.snapshot,
-                "--detail"
-              ],
-              "Read"
-            )
-          );
-        return result(data, void 0, {
-          actions,
-          coverage: {
-            ...page ? { page } : {},
-            ...data.evidence === "preview" && section === "threads" ? { omitted: [{ path: "data.items.messages", reason: "summary" }] } : {}
-          }
-        });
+        return readResult(input, artifact, section, json, read2, thread);
       },
       present: presentRead
     },
@@ -1641,7 +1769,19 @@ function commentOptions(input) {
     artifact: input.values.artifact,
     projectDir: input.projectDir
   };
-  for (const key of ["ask", "block", "board", "choice", "group", "quote", "round", "text", "thread", "x", "y"])
+  for (const key of [
+    "ask",
+    "block",
+    "board",
+    "choice",
+    "group",
+    "quote",
+    "round",
+    "text",
+    "thread",
+    "x",
+    "y"
+  ])
     options[key] = input.values[key];
   for (const key of ["all", "clear", "withdraw"]) options[key] = !!input.values[key];
   return options;
@@ -1650,9 +1790,18 @@ function commentSemantic(input) {
   const options = commentOptions(input);
   const operation = options.action;
   if (["list", "read", "ack"].includes(operation ?? "")) return reviewSemantic(input);
-  if (["section", "limit", "cursor", "snapshot", "receipt", "status", "waiting-on", "kind", "choice-state"].some(
-    (key) => input.values[key] !== void 0
-  ))
+  if ([
+    "section",
+    "sections",
+    "limit",
+    "cursor",
+    "snapshot",
+    "receipt",
+    "status",
+    "waiting-on",
+    "kind",
+    "choice-state"
+  ].some((key) => input.values[key] !== void 0))
     throw new OutputError({
       code: "E_OPTION_UNSUPPORTED",
       message: "Review query options apply only to list, read and ack."
@@ -1852,6 +2001,7 @@ var commentCommand = {
   name: "comment",
   summary: "Read and answer comments on a document or artboard (needs a running server)",
   usage: [
+    "list    --artifact <document|artboard>/<id> --sections all|<names> [--detail] [--all]",
     "list    --artifact <document|artboard>/<id> [--section threads|asks|groups|rounds] [--all]",
     "read    --artifact <document|artboard>/<id> --thread <threadId> [--snapshot <token>]",
     "ack     --artifact <document|artboard>/<id> --receipt <receipt>",
@@ -1869,6 +2019,11 @@ var commentCommand = {
   ],
   details: "list returns a summary; select threads, asks, groups or rounds to read one collection. Previews do not consume evidence. read returns a complete thread and receipt; use ack after applying that evidence. asks, groups and rounds are independent state reads without receipts. Without --text, add, reply, note and reject read the message from stdin. answer records what your human partner said in the terminal; note settles a question once its answer is applied. pass and reject record a verdict on a verify group only when your human partner asks for it; the board shows the agent recorded it.",
   options: {
+    "sections": {
+      type: "string",
+      value: "<all|threads,asks|threads,groups,rounds>",
+      help: "Read multiple bounded review collections in one request"
+    },
     "section": {
       type: "string",
       value: "<threads|asks|groups|rounds>",
@@ -3544,7 +3699,7 @@ async function startServer(options, hooks) {
   import_node_fs15.default.mkdirSync(paths.state, { recursive: true });
   if (!import_node_fs15.default.existsSync(import_node_path15.default.join(paths.state, ".gitignore")))
     import_node_fs15.default.writeFileSync(import_node_path15.default.join(paths.state, ".gitignore"), "*\n");
-  const cliVersion = process.env.RYUGI_ARTIFACTS_VERSION || (true ? "1.60.0" : "");
+  const cliVersion = process.env.RYUGI_ARTIFACTS_VERSION || (true ? "1.61.0" : "");
   const known = readProjects(machine.projects).some((entry) => entry.dir === paths.project);
   const finish = async (info, reused) => {
     recordAgent(paths);
@@ -3973,7 +4128,7 @@ var updateCommand = {
         try {
           report2 = await performUpdate(
             {
-              current: "1.60.0",
+              current: "1.61.0",
               file: __filename,
               env: process.env,
               registry: process.env.npm_config_registry || "https://registry.npmjs.org/",
@@ -4085,7 +4240,10 @@ function textDefinition(id, data) {
   return {
     id,
     mode: "finite",
-    output: { formats: ["brief", "json", "jsonl"], fields: ["text", "version", "commands"] },
+    output: {
+      formats: ["brief", "json", "jsonl"],
+      fields: ["text", "version", "capabilities", "commands"]
+    },
     run() {
       return result(data);
     },
@@ -4105,7 +4263,10 @@ async function dispatchSemantic(argv, commands, browseOptions, version, options,
   try {
     if (name === "--version" || name === "-v") {
       parse(rest, {}, 0);
-      return await bindCommand(textDefinition("version", { text: version, version }), void 0).run(options, writer);
+      return await bindCommand(
+        textDefinition("version", { text: version, version, capabilities: ["reviewBundlesV1"] }),
+        void 0
+      ).run(options, writer);
     }
     if (name === "--help" || name === "-h" || command && wantsHelp(rest)) {
       if (!command) parse(rest, {}, 0);
@@ -4170,7 +4331,7 @@ async function main(argv) {
   process.on("SIGINT", interrupt);
   process.on("SIGTERM", terminate);
   try {
-    return await dispatchSemantic(argv, COMMANDS, BROWSE_OPTIONS, "1.60.0", selection.options, writer, abort.signal);
+    return await dispatchSemantic(argv, COMMANDS, BROWSE_OPTIONS, "1.61.0", selection.options, writer, abort.signal);
   } finally {
     process.removeListener("SIGINT", interrupt);
     process.removeListener("SIGTERM", terminate);

package/dist/output-bootstrap.cjs

@@ -36,7 +36,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // <define:BOOTSTRAP_OPTIONS>
-var define_BOOTSTRAP_OPTIONS_default = { format: { type: "string" }, json: { type: "boolean" }, detail: { type: "boolean" }, fields: { type: "string" }, quiet: { type: "boolean" }, verbose: { type: "boolean" }, "project-dir": { type: "string" }, artifact: { type: "string" }, host: { type: "string" }, "url-host": { type: "string" }, port: { type: "string" }, open: { type: "boolean" }, "no-open": { type: "boolean" }, foreground: { type: "boolean" }, background: { type: "boolean" }, visibility: { type: "string" }, type: { type: "string" }, project: { type: "boolean" }, limit: { type: "string" }, cursor: { type: "string" }, public: { type: "boolean" }, private: { type: "boolean" }, unpublish: { type: "boolean" }, list: { type: "boolean" }, delete: { type: "string" }, "with-boards": { type: "boolean" }, login: { type: "boolean" }, logout: { type: "boolean" }, section: { type: "string" }, snapshot: { type: "string" }, receipt: { type: "string" }, status: { type: "string" }, "waiting-on": { type: "string" }, kind: { type: "string" }, "choice-state": { type: "string" }, all: { type: "boolean" }, block: { type: "string" }, quote: { type: "string" }, board: { type: "string" }, x: { type: "string" }, y: { type: "string" }, thread: { type: "string" }, text: { type: "string" }, group: { type: "string" }, clear: { type: "boolean" }, ask: { type: "string" }, choice: { type: "string" }, round: { type: "string" }, withdraw: { type: "boolean" }, save: { type: "string" }, source: { type: "boolean" }, download: { type: "boolean" }, out: { type: "string" }, "no-comments": { type: "boolean" }, "output-format": { type: "string" }, "auto-publish": { type: "string" }, check: { type: "boolean" }, pm: { type: "string" } };
+var define_BOOTSTRAP_OPTIONS_default = { format: { type: "string" }, json: { type: "boolean" }, detail: { type: "boolean" }, fields: { type: "string" }, quiet: { type: "boolean" }, verbose: { type: "boolean" }, "project-dir": { type: "string" }, artifact: { type: "string" }, host: { type: "string" }, "url-host": { type: "string" }, port: { type: "string" }, open: { type: "boolean" }, "no-open": { type: "boolean" }, foreground: { type: "boolean" }, background: { type: "boolean" }, visibility: { type: "string" }, type: { type: "string" }, project: { type: "boolean" }, limit: { type: "string" }, cursor: { type: "string" }, public: { type: "boolean" }, private: { type: "boolean" }, unpublish: { type: "boolean" }, list: { type: "boolean" }, delete: { type: "string" }, "with-boards": { type: "boolean" }, login: { type: "boolean" }, logout: { type: "boolean" }, sections: { type: "string" }, section: { type: "string" }, snapshot: { type: "string" }, receipt: { type: "string" }, status: { type: "string" }, "waiting-on": { type: "string" }, kind: { type: "string" }, "choice-state": { type: "string" }, all: { type: "boolean" }, block: { type: "string" }, quote: { type: "string" }, board: { type: "string" }, x: { type: "string" }, y: { type: "string" }, thread: { type: "string" }, text: { type: "string" }, group: { type: "string" }, clear: { type: "boolean" }, ask: { type: "string" }, choice: { type: "string" }, round: { type: "string" }, withdraw: { type: "boolean" }, save: { type: "string" }, source: { type: "boolean" }, download: { type: "boolean" }, out: { type: "string" }, "no-comments": { type: "boolean" }, "output-format": { type: "string" }, "auto-publish": { type: "string" }, check: { type: "boolean" }, pm: { type: "string" } };
 
 // src/cli/output/configuration.ts
 var import_node_fs2 = __toESM(require("node:fs"), 1);
@@ -316,6 +316,7 @@ function clip(text, size = 160) {
   return segments.length > size ? `${segments.slice(0, size).map((s) => s.segment).join("")}\u2026` : text;
 }
 var scalar = (value) => value === null ? "none" : typeof value === "object" ? JSON.stringify(value) : String(value);
+var scopeText = (page) => `${clean(page.scope)} \xB7 ${page.returned} shown${page.total === null ? "" : ` / ${page.total} matched`}${page.hasMore ? " \xB7 more available" : ""}`;
 var quote = (value) => /^[\w./:@=+-]+$/.test(value) ? value : `'${value.replaceAll("'", "'\\''")}'`;
 function actionText(action) {
   return action.kind === "command" ? action.argv.map(quote).join(" ") : action.url;
@@ -374,8 +375,12 @@ function renderText(view, wire, options, collection, requiredFields = []) {
       continue;
     }
     if (!collection && !selected(section.key)) continue;
+    if (section.page)
+      lines.push(
+        `${clean("title" in section && section.title || section.key)}: ${section.status ? `${clean(section.status)} \xB7 ` : ""}${scopeText(section.page)}`
+      );
     if (section.kind === "records") {
-      if (section.title) lines.push(clean(section.title));
+      if (section.title && !section.page) lines.push(clean(section.title));
       const declared = new Set(section.columns.map((column) => column.key));
       const extra = section.key === collection ? [.../* @__PURE__ */ new Set([...options.fields ?? [], ...requiredFields])].filter((key) => !declared.has(key)).map((key) => ({ key, label: key })) : [];
       const columns = [...section.columns, ...extra].filter(
@@ -407,7 +412,22 @@ function renderText(view, wire, options, collection, requiredFields = []) {
               return cell === void 0 || cell === "" ? [] : [`${clean(column.label)}=${cell}`];
             }).join(" \xB7 ")}`
           );
-      if (!rows.length) lines.push("No records.");
+      if (!rows.length && !section.page) lines.push("No records.");
+    } else if (section.kind === "messages") {
+      if (section.title && !section.page) lines.push(`${clean(section.title)}:`);
+      const metadata = (items) => items.map((item) => `${clean(item.label)}=${clean(scalar(item.binding.value))}`).join(" \xB7 ");
+      for (const group of section.groups) {
+        lines.push(`  ${metadata(group.facts)}`);
+        for (const message of group.messages) {
+          lines.push(`    ${metadata(message.facts)}`);
+          lines.push(
+            ...message.text.split("\n").map(
+              (line) => `      ${line.replaceAll(new RegExp("\\p{Cc}", "gu"), (char) => char === "	" ? char : "")}`
+            )
+          );
+        }
+      }
+      if (!section.groups.length && !section.page) lines.push("No messages.");
     } else if (section.kind === "diagnostics") {
       const limit = options.detail ? section.items.length : section.preview ?? 3;
       for (const item of section.items.slice(0, limit))
@@ -421,7 +441,7 @@ function renderText(view, wire, options, collection, requiredFields = []) {
           count: section.items.length - limit
         });
     } else {
-      if (section.title) lines.push(`${clean(section.title)}:`);
+      if (section.title && !section.page) lines.push(`${clean(section.title)}:`);
       lines.push(
         ...section.text.trimEnd().split("\n").map(
           (line) => `  ${line.replaceAll(new RegExp("\\p{Cc}", "gu"), (char) => char === "	" || char === "\n" ? char : "")}`
@@ -429,10 +449,7 @@ function renderText(view, wire, options, collection, requiredFields = []) {
       );
     }
   }
-  if (wire.page)
-    lines.push(
-      `Scope: ${clean(wire.page.scope)} \xB7 ${wire.page.returned} shown${wire.page.total === null ? "" : ` / ${wire.page.total} matched`}${wire.page.hasMore ? " \xB7 more available" : ""}`
-    );
+  if (wire.page) lines.push(`Scope: ${scopeText(wire.page)}`);
   lines.push(...effectLines(wire.effects ?? []));
   for (const warning of wire.warnings ?? []) lines.push(`Warning: ${clean(warning.message)}`);
   if (omissions.length)