`515ed7c`

Steer substantive HTML guide writes

Authored by mfwolffe <wolffemf@dukes.jmu.edu> 1 week ago

SHA: 515ed7cc2a0a9aad15caf76409c3f155512f4b5a
Parents: 5e2425f
Tree: c3b3810

2 changed files

Status	File	+	-
M	`src/loader/runtime/prompting.py`	67	0
M	`tests/test_prompt_builder.py`	18	0

src/loader/runtime/prompting.pymodified

          ),
+     ]
 +    html_guide_section = _html_guide_quality_section(current_task)
 +    if html_guide_section is not None:
 +        dynamic_sections.append(html_guide_section)
++
      dynamic_sections.extend(_project_sections(project_context))
      rendered = _render_sections(sections, dynamic_sections)
      return SystemPromptBuildResult(
      return build_system_prompt_result(**kwargs).content
 +def _html_guide_quality_section(current_task: str | None) -> PromptSection | None:
 +    """Return extra guidance for substantive multi-page HTML guide generation."""
++
 +    task = str(current_task or "").lower()
 +    if not task:
 +        return None
 +    guide_like = any(
 +        marker in task
 +        for marker in (
 +            "guide",
 +            "tutorial",
 +            "documentation",
 +            "docs",
 +            "manual",
 +            "course",
 +        )
 +    )
 +    html_like = any(
 +        marker in task
 +        for marker in (
 +            ".html",
 +            "html",
 +            "index.html",
 +            "chapters/",
 +            "pages/",
 +        )
 +    )
 +    substantive_like = any(
 +        marker in task
 +        for marker in (
 +            "thorough",
 +            "cadence",
 +            "same structure",
 +            "reference",
 +            "multi-page",
 +            "multi page",
 +            "chapters",
 +            "chapter",
 +        )
 +    )
 +    if not (guide_like and html_like and substantive_like):
 +        return None
++
 +    return PromptSection(
 +        name="Generated HTML Guide Quality",
 +        body=(
 +            "- For substantive multi-page HTML guide/tutorial/documentation tasks, "
 +            "write each generated page or chapter as a real first pass, not a "
 +            "placeholder outline.\n"
 +            "- A chapter page should usually include 4-6 concrete body sections plus "
 +            "lists, commands, configuration examples, or checks where relevant; avoid "
 +            "filler like \"This section...\" standing in for content.\n"
 +            "- Keep each HTML file structurally complete with exactly one closing "
 +            "`</body>` tag and one closing `</html>` tag. Insert expansions before "
 +            "the closing body/html tags, never after `</html>`.\n"
 +            "- When the user asks to mirror a reference guide's cadence or make an "
 +            "equally thorough guide, match that depth during the initial write rather "
 +            "than relying on later repair passes."
 +        ),
 +        dynamic=True,
 +    )
++
++
  def format_tool_descriptions(tools: list[dict[str, Any]]) -> str:
      """Format tool schemas as readable markdown."""

tests/test_prompt_builder.pymodified

+     )
      assert "Prefer `edit`/`patch`/`write` over shell one-liners" in result.content
++
++
 +def test_prompt_builder_adds_html_guide_quality_guidance(temp_dir: Path) -> None:
 +    result = build_system_prompt_result(
 +        tools=[_tool_schema("write")],
 +        use_react=False,
 +        workflow_mode="execute",
 +        permission_mode="workspace-write",
 +        cwd=temp_dir,
 +        current_task=(
 +            "Create an equally thorough HTML guide with index.html and chapters/ "
 +            "matching the cadence of the reference guide."
 +        ),
 +    )
++
 +    assert "Generated HTML Guide Quality" in result.dynamic_section_names
 +    assert "write each generated page or chapter as a real first pass" in result.content
 +    assert "never after `</html>`" in result.content