`d647e20`

Seed blank HTML child retries

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

SHA: d647e202e84787253b24d058b7ecba97bb8bfca3
Parents: 721c739
Tree: 6ea989a

2 changed files

Status	File	+	-
M	`src/loader/runtime/repair.py`	33	0
M	`tests/test_repair.py`	7	0

src/loader/runtime/repair.pymodified

+         )
          if html_starter_line:
              lines.append(html_starter_line)
 +        html_template_line = self._known_html_starter_template_line(
 +            concrete_target,
 +            require_first_substantive_output=True,
 +            retry_number=retry_number,
 +            outline_label=outline_label,
 +        )
 +        if html_template_line:
 +            lines.append(html_template_line)
          if (
              not compact_retry
              and _should_encourage_initial_version(
              "sections with short body text, and a back link to `../index.html`."
+         )
 +    def _known_html_starter_template_line(
 +        self,
 +        target: Path,
 +        *,
 +        require_first_substantive_output: bool,
 +        retry_number: int,
 +        outline_label: str | None,
 +    ) -> str | None:
 +        if not require_first_substantive_output or retry_number < 4:
 +            return None
 +        if target.suffix.lower() not in {".html", ".htm"}:
 +            return None
 +        label = outline_label.strip() if outline_label and outline_label.strip() else "this chapter"
 +        snippet = (
 +            "<!DOCTYPE html> <html lang=\"en\"> <head> <meta charset=\"UTF-8\"> "
 +            f"<title>{label}</title> </head> <body> <div class=\"container\"> "
 +            f"<h1>{label}</h1> <p>...</p> <h2>Overview</h2> <p>...</p> "
 +            "<p><a href=\"../index.html\">← Back to Main Guide Index</a></p> "
 +            "</div> </body> </html>"
 +        )
 +        return (
 +            "If blanking continues, use this minimal HTML starter as the `content` value "
 +            f"and adapt it: `{snippet}`."
 +        )
++
      def _best_known_root_html_scaffold(self, target: Path) -> Path | None:
          normalized_target = target.expanduser().resolve(strict=False)
          if normalized_target.suffix.lower() not in {".html", ".htm"}:

tests/test_repair.pymodified

          "of `<h2>` sections with short body text, and a back link to `../index.html`."
          in decision.retry_message
+     )
 +    assert (
 +        "If blanking continues, use this minimal HTML starter as the `content` value "
 +        "and adapt it:"
 +        in decision.retry_message
 +    )
 +    assert "<title>Chapter 1: Introduction to Nginx</title>" in decision.retry_message
 +    assert '<p><a href="../index.html">← Back to Main Guide Index</a></p>' in decision.retry_message
      assert (
          f"You already read `{display_runtime_path(reference_chapter)}`; reuse its overall structure "
          "as the starting pattern for this new file, then adapt the content to the current target."