feat(mcp-docugen): Markdown autocontenuto con CSS Tielogic iniettato inline

Problema: i template puntavano a un path host hardcoded
(stylesheet: /home/adriano/.../themes/tielogic.css), quindi il file .md
generato non era portabile — su un'altra macchina md-to-pdf non trovava
il CSS e produceva PDF senza stile.

Soluzione: il Renderer legge il CSS da Settings.inline_stylesheet_path
(default /app/themes/tielogic.css nel container) e lo inietta come
blocco <style>...</style> subito dopo il frontmatter YAML del Markdown
restituito dall'LLM. Il file .md risultante è autocontenuto e portabile.

- renderer.py: nuovo arg inline_stylesheet_path + funzione
  _inject_inline_stylesheet (idempotente, gestisce Markdown senza
  frontmatter, no-op se CSS vuoto)
- config.py: Settings.inline_stylesheet_path: Path | None
- main.py: passa il path al Renderer
- mcp-docugen.Dockerfile: COPY themes ./themes nello stage builder per
  trasportare /app/themes/tielogic.css nell'immagine runtime
- templates_seed/{offerta,report-analisi}/template.md: rimossa la riga
  `stylesheet:` dal frontmatter di output + regola tassativa che vieta
  all'LLM di emettere blocchi <style> di sua iniziativa (evita
  conflitti di cascade visti in test)
- 4 nuovi test unit (76 totali): iniezione dopo frontmatter, prepend
  quando frontmatter assente, no-op CSS vuoto, integrazione full E2E
  via Renderer.generate

scripts/bundle-css.py: utility per fixare file .md legacy che
referenziavano stylesheet: come path host (sostituisce la riga con
<style> inline pescando il CSS dal repo)

README aggiornato con rationale e workflow.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-25 15:35:41 +02:00
parent 7955e0e517
commit b32669caa7
9 changed files with 205 additions and 7 deletions
@@ -272,3 +272,71 @@ async def test_generate_uses_frontmatter_model_override(tmp_path):
template_name="x", content_md="c", variables={}, instructions=None
)
assert llm.chat.await_args.kwargs["model"] == "openai/gpt-4o"
def test_inject_inline_stylesheet_after_frontmatter():
from mcp_docugen.renderer import _inject_inline_stylesheet
md = "---\ntitle: T\n---\n\n# Body\n"
out = _inject_inline_stylesheet(md, "body { color: red; }")
assert out.startswith("---\ntitle: T\n---\n")
assert "<style>\nbody { color: red; }\n</style>" in out
body_idx = out.find("# Body")
style_idx = out.find("<style>")
assert 0 < style_idx < body_idx
def test_inject_inline_stylesheet_no_frontmatter_prepends():
from mcp_docugen.renderer import _inject_inline_stylesheet
out = _inject_inline_stylesheet("# Body only", "h1 { color: blue; }")
assert out.startswith("<style>\nh1 { color: blue; }\n</style>")
def test_inject_inline_stylesheet_empty_css_is_noop():
from mcp_docugen.renderer import _inject_inline_stylesheet
md = "---\nx: 1\n---\nbody"
assert _inject_inline_stylesheet(md, "") == md
assert _inject_inline_stylesheet(md, " \n") == md
async def test_generate_injects_inline_stylesheet_when_configured(tmp_path):
css_path = tmp_path / "tielogic.css"
css_path.write_text("body { font-family: Inter; }", encoding="utf-8")
template_store = TemplateStore(base_dir=tmp_path / "templates")
generation_store = GenerationStore(
db_path=tmp_path / "gen.db",
generated_dir=tmp_path / "generated",
)
await generation_store.init()
llm = AsyncMock(spec=OpenRouterClient)
llm.chat.return_value = LLMResponse(
text="---\ntitle: T\n---\n\n# Body\n",
model="anthropic/claude-sonnet-4",
tokens_in=1,
tokens_out=1,
cost_usd=0.0,
latency_ms=10,
)
renderer = Renderer(
template_store=template_store,
generation_store=generation_store,
llm=llm,
public_base_url="https://mcp.example.com",
default_model="anthropic/claude-sonnet-4",
asset_ttl_days=30,
max_image_size_mb=10,
inline_stylesheet_path=css_path,
)
fm = TemplateFrontmatter(name="t", description="d")
await template_store.create(name="t", frontmatter=fm, body="b")
result = await renderer.generate(
template_name="t", content_md="c", variables={}, instructions=None
)
assert "<style>" in result.markdown
assert "font-family: Inter" in result.markdown
assert result.markdown.startswith("---\n")