okstra 0.131.1 → 0.132.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "okstra",
-  "version": "0.131.1",
+  "version": "0.132.0",
   "description": "Multi-agent cross-verification orchestrator runtime + Claude Code skills.",
   "license": "MIT",
   "author": "devonshin",

package/runtime/BUILD.json

@@ -1,5 +1,5 @@
 {
-  "package": "0.131.1",
-  "builtAt": "2026-07-22T05:33:21.666Z",
+  "package": "0.132.0",
+  "builtAt": "2026-07-22T06:44:24.538Z",
   "repoRoot": "/home/runner/work/okstra/okstra"
 }

package/runtime/python/okstra_ctl/render_final_report.py

@@ -308,6 +308,66 @@ def _build_index(headings: list, definitions: list, labels: dict) -> list[str]:
     return block
 
 
+# --- Prose ventilation post-render pass -----------------------------------
+# Split prose paragraphs at sentence boundaries so raw markdown reads one
+# sentence per line; the HTML view turns those newlines into <br>
+# (report_views._markdown_to_html). Prose only — table cells already carry
+# their own <br>, and headings / lists / code / blockquotes must stay intact.
+# A leading-whitespace line is a list continuation, not a prose paragraph:
+# only column-0 non-block lines are treated as prose (allowlist).
+_LIST_LINE_RE = re.compile(r"^\s*(?:[-*]\s|\d+\.\s)")
+_SENT_BOUNDARY_RE = re.compile(r"[.?!][ \t]+(?=\S)")
+# Trailing tokens whose dot is not a sentence end (compared lowercased with
+# the trailing dot stripped).
+_ABBREV = {
+    "e.g", "i.e", "etc", "cf", "vs", "al", "no", "fig",
+    "dr", "mr", "ms", "inc", "ltd", "jr", "sr",
+}
+
+
+def _ventilate_segment(seg: str) -> str:
+    def replace_boundary(match: re.Match) -> str:
+        mark = match.start()
+        prev = seg[mark - 1] if mark > 0 else ""
+        # A number, a bare-digit, or an ellipsis dot is not a sentence end.
+        if not prev or prev.isspace() or prev.isdigit() or prev == ".":
+            return match.group(0)
+        tail = re.search(r"[A-Za-z.]+$", seg[: mark + 1])
+        if tail and tail.group(0).rstrip(".").lower() in _ABBREV:
+            return match.group(0)
+        return seg[mark] + "\n"
+
+    return _SENT_BOUNDARY_RE.sub(replace_boundary, seg)
+
+
+def _split_prose_line(line: str) -> str:
+    parts = line.split("`")
+    for even in range(0, len(parts), 2):  # segments outside backtick code spans
+        parts[even] = _ventilate_segment(parts[even])
+    return "`".join(parts)
+
+
+def _ventilate_prose(markdown: str) -> str:
+    """Break prose paragraphs into one sentence per line. Idempotent: a line
+    already holding a single sentence has no internal boundary to split."""
+    lines = markdown.split("\n")
+    mask = _code_line_mask(lines)
+    for i, line in enumerate(lines):
+        if mask[i]:  # frontmatter / fenced code
+            continue
+        if not line or line != line.lstrip():  # blank or indented continuation
+            continue
+        if (
+            _HEADING_RE.match(line)
+            or line.startswith("|")
+            or line.startswith(">")
+            or _LIST_LINE_RE.match(line)
+        ):
+            continue
+        lines[i] = _split_prose_line(line)
+    return "\n".join(lines)
+
+
 def _inject_index_and_anchors(markdown: str, dictionary: dict | None) -> str:
     """Append scroll anchors + a top-of-report index to a rendered report.
     Idempotent: re-running on already-anchored markdown is a no-op for
@@ -500,7 +560,8 @@ def render(
     try:
         template = env.get_template(template_path.name)
         rendered = template.render(**data)
-        return _inject_index_and_anchors(rendered, dictionary)
+        rendered = _inject_index_and_anchors(rendered, dictionary)
+        return _ventilate_prose(rendered)
     except I18nError as exc:
         raise FinalReportRenderError(
             f"i18n lookup failed while rendering {template_path.name}: {exc}"

package/runtime/python/okstra_ctl/report_views.py

@@ -399,7 +399,9 @@ def _markdown_to_html(
             para_lines.append(ln)
             i += 1
         if para_lines:
-            out.append("<p>" + _inline(" ".join(para_lines)) + "</p>")
+            # The renderer's prose ventilation puts one sentence per source
+            # line; join with <br> so those breaks survive into the HTML.
+            out.append("<p>" + _inline("<br>".join(para_lines)) + "</p>")
 
     return "\n".join(out), headings