fix: render unparsed task detail content

Taskr: 2026-05-14-render-unparsed-detail-content

Author: xerrors

src/board-client.ts

@@ -112,7 +112,8 @@ export const boardClientScript = `    let model = window.__TASKR_BOARD__;
           "Implementation Plan": "Implementation Plan",
           "Progress Log": "Progress Log",
           "Agent Notes": "Agent Notes",
-          "Completion Summary": "Completion Summary"
+          "Completion Summary": "Completion Summary",
+          "Unparsed Content": "Additional content"
         },
         actions: {
           edit: "Edit",
@@ -232,7 +233,8 @@ export const boardClientScript = `    let model = window.__TASKR_BOARD__;
           "Implementation Plan": "实现计划",
           "Progress Log": "进度日志",
           "Agent Notes": "代理备注",
-          "Completion Summary": "完成总结"
+          "Completion Summary": "完成总结",
+          "Unparsed Content": "其他内容"
         },
         actions: {
           edit: "编辑",
@@ -644,17 +646,20 @@ export const boardClientScript = `    let model = window.__TASKR_BOARD__;
         fragment.append(commitPanel(task));
       }
 
-      for (const name of detailSectionNames(task)) {
-        fragment.append(section(name, task.sections[name] || t("empty")));
+      for (const name of coreSectionNames()) {
+        if (Object.prototype.hasOwnProperty.call(task.sections || {}, name)) {
+          fragment.append(section(name, task.sections[name] || t("empty")));
+        }
+      }
+      if (task.unsectionedBody && task.unsectionedBody.trim()) {
+        fragment.append(section("Unparsed Content", task.unsectionedBody));
       }
       fragment.append(dangerZone(task));
       return fragment;
     }
 
-    function detailSectionNames(task) {
-      const coreSections = ["Request", "Acceptance Criteria", "Implementation Plan", "Progress Log", "Agent Notes", "Completion Summary"];
-      const extraSections = Object.keys(task.sections || {}).filter((name) => !coreSections.includes(name));
-      return [...coreSections, ...extraSections];
+    function coreSectionNames() {
+      return ["Request", "Acceptance Criteria", "Implementation Plan", "Progress Log", "Agent Notes", "Completion Summary"];
     }
 
     function dangerZone(task) {

src/board-types.ts

@@ -12,6 +12,7 @@ export interface BoardTask {
   commitDetails: BoardCommitDetail[];
   verification: unknown;
   sections: Record<string, string>;
+  unsectionedBody: string;
   criteria: {
     checked: number;
     total: number;

src/board.ts

@@ -4,6 +4,7 @@ import { renderBoardHtml } from "./board-template.js";
 import {
   deleteTask,
   extractSections,
+  extractUnsectionedBody,
   listTasks,
   loadTaskById,
   normalizeCommitIds,
@@ -219,6 +220,7 @@ function boardTask(document: TaskDocument, repoRoot: string): BoardTask {
     commitDetails: commits.map((commit) => commitDetail(repoRoot, commit)),
     verification: document.metadata.verification ?? null,
     sections,
+    unsectionedBody: extractUnsectionedBody(document.body),
     criteria: countCriteria(sections["Acceptance Criteria"] ?? ""),
   };
 }

src/markdown.ts

@@ -12,6 +12,13 @@ export function renderMarkdownHtml(markdown: string): string {
       continue;
     }
 
+    const heading = headingItem(line);
+    if (heading) {
+      blocks.push(`<h${heading.level}>${renderInline(heading.text)}</h${heading.level}>`);
+      index += 1;
+      continue;
+    }
+
     // Detect standalone HTML fragment lines (lines that start with an HTML tag) and pass them through safely
     if (HTML_FRAGMENT_PATTERN.test(line)) {
       // Collect multi-line HTML blocks by looking for continuation lines
@@ -83,7 +90,8 @@ export function renderMarkdownHtml(markdown: string): string {
       lines[index].trim() !== "" &&
       !todoItem(lines[index]) &&
       !unorderedItem(lines[index]) &&
-      !orderedItem(lines[index])
+      !orderedItem(lines[index]) &&
+      !headingItem(lines[index])
     ) {
       paragraph.push(lines[index]);
       index += 1;
@@ -108,6 +116,7 @@ ${renderInline.toString()}
 ${todoItem.toString()}
 ${unorderedItem.toString()}
 ${orderedItem.toString()}
+${headingItem.toString()}
 ${sanitizeHtml.toString()}
 ${escapeHtml.toString()}
 window.renderTaskrMarkdown = renderMarkdownHtml;
@@ -164,6 +173,15 @@ function orderedItem(line: string): string | null {
   return match ? match[1] : null;
 }
 
+function headingItem(line: string): { level: number; text: string } | null {
+  const match = /^(#{1,6})\s+(.+?)\s*#*\s*$/.exec(line);
+  if (!match) return null;
+  return {
+    level: match[1].length,
+    text: match[2],
+  };
+}
+
 // Allowed HTML tags for task markdown fragments
 const ALLOWED_TAGS = new Set([
   "section",

src/protocol.ts

@@ -465,6 +465,45 @@ export function extractSections(body: string): Record<string, string> {
   return sections;
 }
 
+export function extractUnsectionedBody(
+  body: string,
+  sectionNames: readonly string[] = REQUIRED_SECTIONS,
+): string {
+  const knownSections = new Set(sectionNames);
+  const matches = [...body.matchAll(SECTION_RE)];
+  if (matches.length === 0) {
+    return stripLeadingDocumentTitle(body).trim();
+  }
+
+  const chunks: string[] = [];
+  const preambleEnd = matches[0].index ?? 0;
+  const preamble = stripLeadingDocumentTitle(body.slice(0, preambleEnd)).trim();
+  if (preamble) {
+    chunks.push(preamble);
+  }
+
+  for (let index = 0; index < matches.length; index += 1) {
+    const match = matches[index];
+    const title = match[1].trim();
+    if (knownSections.has(title)) {
+      continue;
+    }
+    const start = match.index ?? 0;
+    const end =
+      index + 1 < matches.length ? (matches[index + 1].index ?? body.length) : body.length;
+    const chunk = body.slice(start, end).trim();
+    if (chunk) {
+      chunks.push(chunk);
+    }
+  }
+
+  return chunks.join("\n\n").trim();
+}
+
+function stripLeadingDocumentTitle(body: string): string {
+  return body.replace(/^\s*# [^\n]*(?:\n+|$)/, "");
+}
+
 export function replaceSection(body: string, section: string, content: string): string {
   const matches = [...body.matchAll(SECTION_RE)];
   for (let index = 0; index < matches.length; index += 1) {

tests/markdown.test.ts

@@ -33,6 +33,12 @@ describe("Taskr Markdown renderer", () => {
     expect(html).toContain("<ol><li>First</li><li>Second</li></ol>");
   });
 
+  it("renders Markdown headings", () => {
+    const html = renderMarkdownHtml("## Test HTML Fragments");
+
+    expect(html).toBe("<h2>Test HTML Fragments</h2>");
+  });
+
   it("emits a browser script with the renderer entrypoint", () => {
     const script = markdownBrowserScript();
 

tests/protocol.test.ts

@@ -13,6 +13,7 @@ import {
   defaultTaskId,
   addNote,
   extractSections,
+  extractUnsectionedBody,
   initProtocol,
   loadTask,
   slugify,
@@ -108,6 +109,45 @@ describe("Taskr protocol", () => {
     expect(sections["Progress Log"]).toBe("Empty.");
   });
 
+  it("keeps content outside protocol sections available for detail rendering", () => {
+    const body = [
+      "# Task title already shown in detail header",
+      "",
+      "Intro note before sections.",
+      "",
+      "## Request",
+      "",
+      "Do the work.",
+      "",
+      "## Test HTML Fragments",
+      "",
+      '<section class="demo">',
+      "  <h3>Rendered</h3>",
+      "</section>",
+      "",
+      "## Acceptance Criteria",
+      "",
+      "- [ ] It works.",
+    ].join("\n");
+
+    expect(extractSections(body)).toMatchObject({
+      Request: "Do the work.",
+      "Acceptance Criteria": "- [ ] It works.",
+      "Test HTML Fragments": '<section class="demo">\n  <h3>Rendered</h3>\n</section>',
+    });
+    expect(extractUnsectionedBody(body)).toBe(
+      [
+        "Intro note before sections.",
+        "",
+        "## Test HTML Fragments",
+        "",
+        '<section class="demo">',
+        "  <h3>Rendered</h3>",
+        "</section>",
+      ].join("\n"),
+    );
+  });
+
   it("creates opt-in research report files and records task references", () => {
     const repo = tempRepo();
     initProtocol(repo);
@@ -215,6 +255,7 @@ describe("Taskr protocol", () => {
     expect(
       model.tasks.find((task) => task.id === "implement-board-visualization")?.sections.Request,
     ).toContain("Implement board visualization");
+    expect(model.tasks[0].unsectionedBody).toBe("");
     expect(model.tasks[0].createdAt).toMatch(/^\d{4}-\d{2}-\d{2}T/);
     expect(html).toContain("Taskr Board");
     expect(html).toContain(boardStyles);
@@ -267,7 +308,7 @@ describe("Taskr protocol", () => {
     expect(html).toContain("commitStatusLabel");
     expect(html).toContain("renderTaskrMarkdown");
     expect(html).toContain("markdown-content");
-    expect(html).toContain("detailSectionNames");
+    expect(html).toContain("coreSectionNames");
     expect(html).toContain("grid-template-columns: auto minmax(0, 1fr);");
     expect(html).toContain("appearance: none;");
     expect(html).toContain("border-color: rgba(34, 197, 94, 0.72);");