@rubytech/create-maxy-code 0.1.63 → 0.1.65

package/payload/premium-plugins/real-agent/plugins/preval/skills/property-preval/references/render.py

@@ -2,12 +2,14 @@
 
 Substitutes <!-- REPLACE: <slot> --> placeholders in template.html with values
 derived from one inputs.json (shape: template-inputs.schema.json), drives
-Chrome headless to produce a 5-page A4 PDF, and asserts page count == 5.
+Chrome headless to produce a 7-page A4 PDF, and asserts page count == 7.
 
 Fails loud on any missing / unverifiable load-bearing input. No silent
 fallback modes — see _assert_inputs. Task 157 layers provenance gates
-(market_summary.origin, agent_listings[].origin, agent_overrides) on top
-of 156's load-bearing-input checks.
+(agent_listings[].origin, agent_overrides.brand_selected_by_operator) on
+top of 156's load-bearing-input checks. `subject.narrative` and
+`market_summary` are agent-composed from the 12-call fan-out, not
+operator-supplied — only the `paragraphs >= 2` sanity check survives.
 
 Usage:
     python3 render.py inputs.json
@@ -24,8 +26,8 @@ def _money(n: int) -> str:
     return f"£{int(n):,}"
 
 
-def _range_money(low: int, high: int) -> str:
-    return f"£{int(low):,} – £{int(high):,}"
+# _range_money retired with the page-2 valuation panel. The pack no longer
+# quotes a numeric range — the human estate agent values in person.
 
 
 # ---------------- helpers ----------------
@@ -38,11 +40,12 @@ def _short_address(address: str) -> str:
 
 def _sold_comps_rows(rows: list[dict]) -> str:
     if not rows:
-        return '<tr><td colspan="4" class="muted">No sold transactions in the sample.</td></tr>'
+        return '<tr><td colspan="5" class="muted">No sold transactions in the sample.</td></tr>'
     return "".join(
         f"<tr><td>{html.escape(r['date'])}</td>"
         f"<td>{html.escape(r['address'])}</td>"
         f"<td>{html.escape(r['type'])}</td>"
+        f"<td>{r['beds'] if r.get('beds') else '—'}</td>"
         f"<td class=\"num\">{_money(r['price'])}</td></tr>"
         for r in rows[:6]
     )
@@ -129,6 +132,33 @@ def _summary_paragraphs(paras: list[str]) -> str:
     return "".join(out)
 
 
+def _variant_css(inputs: dict) -> str:
+    """Compose CSS override block for the 'on-brand' variant.
+
+    Premium variant keeps the editorial Cormorant/Lora/Inter typography lock
+    — only the brand's colour tokens and logo are applied. On-brand variant
+    overrides --display / --body / --sans with brand.font_display +
+    brand.font_body — pack typography follows the agent's DESIGN.md end-to-end.
+
+    Returns empty string for premium (no overrides applied).
+    """
+    variant = (inputs.get("variant") or "premium").lower()
+    if variant != "on-brand":
+        return ""
+    brand = inputs.get("brand") or {}
+    fd = brand.get("font_display") or ""
+    fb = brand.get("font_body") or fd
+    if not fd:
+        return ""
+    return (
+        '<style>:root{'
+        f'--display:{fd};'
+        f'--body:{fb};'
+        f'--sans:{fd};'
+        '}</style>'
+    )
+
+
 def _wordmark(brand: dict, variant: str, out_dir: Path) -> str:
     """variant ∈ {'light', 'dark'}. Mirrors property-market-report's wordmark."""
     key = "logo_light" if variant == "light" else "logo_dark"
@@ -214,62 +244,29 @@ def _agent_listings_cards(rows: list[dict], out_dir: Path) -> str:
     return "".join(_listing_card(p, i, out_dir) for i, p in enumerate(rows[:6]))
 
 
-# ---------------- valuation maths ----------------
+# ---------------- subject facts ----------------
 
-def _valuation_block(subject: dict, valuation: dict) -> str:
-    """Build the page-2 valuation panel: headline range, adjustments, final range.
+def _notable_features_block(subject: dict) -> str:
+    """Label-only bullet list from subject.adjustments[].label. No numbers.
 
-    The three EPC certificate fields are asserted non-null upstream by
-    _assert_inputs — no fallback panel here. sqft is derived from
-    total_floor_area_m2 via M2_TO_SQFT.
+    The pre-valuation pack does NOT quote an estimate or a range — the
+    human agent values the property in person. Adjustments survive only
+    as a "Notable features" list (operator-supplied facts the agent
+    wants visible on the cover-side of the pitch); delta_pct is held in
+    the schema for backward compat but is no longer rendered.
     """
-    sqft = _derived_sqft(subject)
-    low_psf  = valuation["sold_psf_low"]
-    mid_psf  = valuation["sold_psf"]
-    high_psf = valuation["sold_psf_high"]
-    ask_psf  = valuation["asking_psf"]
-
-    low_raw  = int(sqft * low_psf)
-    mid_raw  = int(sqft * mid_psf)
-    high_raw = int(sqft * high_psf)
-    ask_raw  = int(sqft * ask_psf)
-
-    rows = [
-        ('<div class="val-row headline">'
-         f'<div class="lbl">Headline range<small>{sqft:,} sqft × £{low_psf}–£{high_psf} sold £/sqft (Land Registry 70pc band)</small></div>'
-         f'<div class="num">{_range_money(low_raw, high_raw)}</div></div>'),
-        ('<div class="val-row">'
-         f'<div class="lbl">Cross-check · asking £/sqft<small>{sqft:,} sqft × £{ask_psf} mean asking £/sqft</small></div>'
-         f'<div class="num">{_money(ask_raw)}</div></div>'),
-    ]
-
     adjustments = subject.get("adjustments") or []
-    if adjustments:
-        rows.append('<div class="val-row"><div class="lbl" style="font-family:var(--sans);font-weight:600;font-size:8pt;letter-spacing:2pt;text-transform:uppercase;color:var(--text-accent)">Adjustments</div><div class="num">&nbsp;</div></div>')
-        for adj in adjustments:
-            delta = float(adj["delta_pct"])
-            cls = "pos" if delta > 0 else ("neg" if delta < 0 else "")
-            sign = "+" if delta >= 0 else ""
-            rows.append(
-                '<div class="val-row adj">'
-                f'<div class="lbl">{html.escape(adj["label"])}</div>'
-                f'<div class="num {cls}">{sign}{delta:.1f}%</div>'
-                "</div>"
-            )
-
-    delta_sum = sum(float(a["delta_pct"]) for a in adjustments)
-    factor = 1.0 + delta_sum / 100.0
-    low_final  = int(low_raw  * factor)
-    high_final = int(high_raw * factor)
-
-    final = (
-        '<div class="val-final">'
-        f'<div class="lbl">Final indicative range</div>'
-        f'<div class="num">{_range_money(low_final, high_final)}</div>'
-        "</div>"
+    if not adjustments:
+        return ""
+    items = "".join(
+        f'<li>{html.escape(adj["label"])}</li>' for adj in adjustments
+    )
+    return (
+        '<div class="notable-features" style="margin-top:6mm">'
+        '<div class="eyebrow" style="margin-bottom:2mm">Notable features</div>'
+        f'<ul style="margin:0;padding-left:5mm;line-height:1.5">{items}</ul>'
+        '</div>'
     )
-
-    return '<div class="val-panel">' + "".join(rows) + "</div>" + final
 
 
 def _derived_sqft(subject: dict) -> int:
@@ -396,8 +393,10 @@ def _assert_inputs(inputs: dict) -> None:
       agent-listings-empty, market-summary-too-thin.
 
     Task 157 causes (provenance — agent didn't invent the input):
-      cover-hero-not-subject, agent-listings-invented,
-      market-summary-invented, brand-invented.
+      cover-hero-not-subject, agent-listings-invented, brand-invented.
+      (`market-summary-invented` retired: market_summary is agent-composed
+      from the fan-out, not operator-supplied; only the paragraphs>=2
+      sanity check remains, surfaced as `market-summary-too-thin`.)
 
     Task 163 cause (EPC certificate paste-in completes 157's mandate):
       epc-certificate-not-supplied — any of total_floor_area_m2,
@@ -489,14 +488,6 @@ def _assert_inputs(inputs: dict) -> None:
                     "agent_overrides.listings_status_curated: true.",
                 )
 
-    if ms.get("origin") not in ("operator", "operator-edited-llm-stub"):
-        raise PrevalAbort(
-            "market-summary-invented",
-            "market_summary.origin must be 'operator' or 'operator-edited-llm-stub'. "
-            "Have the operator draft or accept the paragraphs before rendering — "
-            "the agent never invents the market narrative unprompted.",
-        )
-
     if brand.get("name") and not overrides.get("brand_selected_by_operator"):
         raise PrevalAbort(
             "brand-invented",
@@ -539,8 +530,10 @@ def render(inputs: dict, out_dir: Path, template_path: Path | None = None) -> Pa
         psf = max(1, round(d["for_sale"] / 7))
 
     slots = {
+        "variant_css":        _variant_css(inputs),
         "brand_name":         brand["name"],
         "brand_tagline":      brand["tagline"],
+        "prepared_by":        brand.get("agent_name") or brand["name"],
         "brand_primary":      brand["primary"],
         "brand_primary_dark": brand["primary_dark"],
         "brand_accent":       brand["accent"],
@@ -563,7 +556,7 @@ def render(inputs: dict, out_dir: Path, template_path: Path | None = None) -> Pa
         "kpi_subject_epc_sub":  subject_epc_sub,
         "kpi_subject_type":     subject.get("type") or "—",
         "kpi_subject_tenure":   subject.get("tenure") or "Tenure unknown",
-        "valuation_block":      _valuation_block(subject, v),
+        "notable_features":     _notable_features_block(subject),
         "subject_narrative":    subject.get("narrative") or "",
 
         "summary_headline":     ms["headline"],
@@ -577,6 +570,11 @@ def render(inputs: dict, out_dir: Path, template_path: Path | None = None) -> Pa
         "price_growth_note":    ms["price_growth_note"],
         "demand_note":          ms["demand_note"],
         "spark_svg":            _spark_svg(d.get("growth_series", []), d.get("growth_psf_series", [])),
+        "type_dist_rows":       _type_dist_rows(d.get("type_dist", [])),
+        "rental_rating":        r["demand_rating"],
+        "rental_for_rent":      str(r["for_rent"]),
+        "rental_dom":           str(r["dom"]),
+        "rental_turnover":      f"{r['turnover_pct']}%",
 
         "sold_comps_rows":      _sold_comps_rows(v.get("sold_comps", [])),
         "asking_comps_tiles":   _asking_comps_tiles(v.get("asking_comps", [])),
@@ -586,12 +584,13 @@ def render(inputs: dict, out_dir: Path, template_path: Path | None = None) -> Pa
 
     text_slots = {
         "address", "address_short", "postcode", "generated",
-        "brand_name", "brand_tagline",
+        "brand_name", "brand_tagline", "prepared_by",
         "kpi_subject_beds", "kpi_subject_epc", "kpi_subject_epc_sub",
         "kpi_subject_sqft", "kpi_subject_sqft_sub",
         "kpi_subject_type", "kpi_subject_tenure",
         "summary_headline", "demand_rating",
         "price_growth_note", "demand_note", "subject_narrative",
+        "rental_rating", "rental_for_rent", "rental_dom", "rental_turnover",
     }
     for k in text_slots:
         slots[k] = html.escape(str(slots[k]))
@@ -791,7 +790,7 @@ def main():
     try:
         render(inputs, out_dir)
         pdf = render_pdf(out_dir, f"{base}.pdf")
-        pages = assert_page_count(pdf, 5)
+        pages = assert_page_count(pdf, 7)
     except PrevalAbort as e:
         pdf_path = out_dir / f"{base}.pdf"
         if pdf_path.exists():

package/payload/premium-plugins/real-agent/plugins/preval/skills/property-preval/references/template-inputs.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "property-preval inputs",
-  "description": "Single-source contract for render.py. Mirrors the 12 property-data MCP responses for one full UK address, plus operator-supplied brand, subject (including the three EPC certificate fields pasted before invocation), market_summary, and agent_listings.",
+  "description": "Single-source contract for render.py. Mirrors the 12 property-data MCP responses for one full UK address, plus operator-supplied brand, subject (including the three EPC certificate fields pasted before invocation), and agent_listings. `subject.narrative` and `market_summary` are composed by the agent from the fan-out — not operator-supplied.",
   "type": "object",
   "required": [
     "out_dir", "filename_stem", "address", "postcode", "generated",
@@ -14,6 +14,7 @@
     "address":       { "type": "string", "description": "Full UK address as the operator gave it." },
     "postcode":      { "type": "string", "description": "Postcode derived from the address, e.g. 'CM23 2UJ'." },
     "generated":     { "type": "string", "description": "Human date, e.g. '19 May 2026'." },
+    "variant":       { "type": "string", "enum": ["premium", "on-brand"], "description": "Render variant. 'premium' (default) keeps the editorial Cormorant/Lora/Inter typography lock and only applies the brand's colours + logo. 'on-brand' overrides the type system with brand.font_display + brand.font_body — the pack follows the agent's identity end-to-end. Decision rule: if the operator says 'premium' use premium; if brand.font_display + brand.font_body are both set and the operator did not say premium, default to 'on-brand'; otherwise premium." },
 
     "brand": {
       "type": "object",
@@ -28,7 +29,10 @@
         "paper_banded": { "type": "string" },
         "rule":         { "type": "string" },
         "logo_light":   { "type": "string", "description": "Optional filesystem path to white-on-transparent logo for the cover." },
-        "logo_dark":    { "type": "string", "description": "Optional filesystem path to full-colour logo for body-page headers." }
+        "logo_dark":    { "type": "string", "description": "Optional filesystem path to full-colour logo for body-page headers." },
+        "agent_name":   { "type": "string", "description": "Optional. Name of the individual agent preparing the pitch — printed in the cover's 'Prepared by' meta cell. Falls back to brand.name when omitted." },
+        "font_display": { "type": "string", "description": "Optional. CSS font-family value for the display typeface (h1/h2/h4/eyebrows). Only honoured when variant='on-brand'. e.g. '\"Azo Sans\", system-ui, sans-serif'." },
+        "font_body":    { "type": "string", "description": "Optional. CSS font-family value for body typography (paragraphs, lists). Only honoured when variant='on-brand'. e.g. 'Poppins, sans-serif'." }
       }
     },
 
@@ -44,7 +48,7 @@
         "total_floor_area_m2":    { "type": "number", "description": "Total internal area in square metres, copied verbatim from the EPC certificate. Operator pastes this into inputs.json before invocation. Null aborts with epc-certificate-not-supplied." },
         "current_energy_rating":  { "type": "string", "description": "Current energy rating from the EPC certificate, e.g. 'C'. Operator paste-in. Null aborts with epc-certificate-not-supplied." },
         "lodgement_date":         { "type": "string", "description": "ISO date of the EPC certificate's lodgement, e.g. '2018-04-21'. Operator paste-in. Null aborts with epc-certificate-not-supplied." },
-        "narrative":              { "type": ["string", "null"], "description": "One short paragraph the operator writes about the subject — shown under the valuation panel." },
+        "narrative":              { "type": ["string", "null"], "description": "One short paragraph (1–3 sentences) under the valuation panel. Composed by the agent from EPC + council-tax records + adjustments — not operator-supplied." },
         "adjustments": {
           "type": "array",
           "description": "Operator-curated esoteric factors that shift the headline range. Deltas sum linearly into the final factor (1 + Σ delta_pct/100).",
@@ -81,6 +85,7 @@
               "date":    { "type": "string" },
               "address": { "type": "string" },
               "type":    { "type": "string" },
+              "beds":    { "type": ["integer", "null"], "description": "Bedroom count from the Land Registry transaction; some rows are null in the source." },
               "price":   { "type": "integer" }
             }
           }
@@ -153,14 +158,14 @@
 
     "market_summary": {
       "type": "object",
-      "required": ["headline", "paragraphs", "demand_gauge_position", "price_growth_note", "demand_note", "origin"],
+      "description": "Composed by the agent from the 12-call PropertyData fan-out — not operator-supplied. See SKILL.md \"Composed by the agent from the fan-out\" for the field-by-field mapping.",
+      "required": ["headline", "paragraphs", "demand_gauge_position", "price_growth_note", "demand_note"],
       "properties": {
         "headline":              { "type": "string", "description": "One-line display-italic h2 for the market context page." },
-        "paragraphs":            { "type": "array", "minItems": 2, "items": { "type": "string" }, "description": "2–3 short paragraphs. First gets a drop cap. Fewer than 2 aborts the run." },
+        "paragraphs":            { "type": "array", "minItems": 2, "items": { "type": "string" }, "description": "2–3 short paragraphs. First gets a drop cap. Fewer than 2 aborts the run with `market-summary-too-thin`." },
         "demand_gauge_position": { "type": "string", "description": "Percentage string for the gauge marker position, e.g. '62%'." },
         "price_growth_note":     { "type": "string" },
-        "demand_note":           { "type": "string" },
-        "origin":                { "type": "string", "enum": ["operator", "operator-edited-llm-stub"], "description": "Provenance of the paragraphs. 'agent-invented' is never permitted — the gate aborts with `market-summary-invented`." }
+        "demand_note":           { "type": "string" }
       }
     },
 

package/payload/premium-plugins/real-agent/plugins/preval/skills/property-preval/references/template.html

@@ -139,7 +139,7 @@
   .gauge-ends{display:flex;justify-content:space-between;font-family:var(--sans);font-weight:500;font-size:7.5pt;letter-spacing:1.5pt;text-transform:uppercase;color:var(--text-muted);margin-top:2mm}
 
   /* --- SPARKLINE --- */
-  .spark{width:100%;height:36mm;display:block;background:var(--surface-card);border:1px solid var(--rule-300);border-radius:var(--radius-md)}
+  .spark{width:100%;height:48mm;display:block;background:var(--surface-card);border:1px solid var(--rule-300);border-radius:var(--radius-md)}
   .spark .pl{fill:none;stroke:var(--teal-900);stroke-width:1.4}
   .spark .pl-psf{fill:none;stroke:var(--gold-500);stroke-width:1.4;stroke-dasharray:2 1.5}
   .spark .pt{fill:var(--teal-900)}
@@ -179,6 +179,7 @@
   .wm.small .wm-name{font-size:20pt}
   .wm.small .wm-sub{margin-top:.8mm;font-size:5.5pt;letter-spacing:1.8pt}
 </style>
+<!-- REPLACE: variant_css -->
 </head>
 <body>
 
@@ -193,11 +194,11 @@
       <div class="cover-rule"></div>
       <h4 style="color:var(--gold-500);margin:6mm 0 4mm"><!-- REPLACE: brand_name --> · Pre-valuation</h4>
       <h1><!-- REPLACE: address --></h1>
-      <p class="lede">A view of what this property is worth — <!-- REPLACE: generated -->.</p>
+      <p class="lede">Market context and comparable evidence — prepared <!-- REPLACE: generated -->.</p>
       <div style="margin-top:8mm"><span class="pc-chip"><!-- REPLACE: postcode --></span></div>
     </div>
     <dl class="cover-meta">
-      <div><dt>Report</dt><dd>Pre-valuation</dd></div>
+      <div><dt>Prepared by</dt><dd style="font-size:13pt;line-height:1.2"><!-- REPLACE: prepared_by --></dd></div>
       <div><dt>Address</dt><dd style="font-size:11pt;line-height:1.2"><!-- REPLACE: address_short --></dd></div>
       <div><dt>Postcode</dt><dd><!-- REPLACE: postcode --></dd></div>
       <div><dt>Generated</dt><dd><!-- REPLACE: generated --></dd></div>
@@ -206,22 +207,22 @@
   <div class="doc-foot" style="z-index:2"><span><!-- REPLACE: brand_name --> · Property Intelligence</span><span>01</span></div>
 </section>
 
-<!-- PAGE 2 — SUBJECT VALUATION -->
+<!-- PAGE 2 — ABOUT THE PROPERTY -->
 <section class="page">
   <header class="doc-head">
     <!-- REPLACE: wordmark_dark -->
-    <div class="breadcrumb">Subject valuation · <!-- REPLACE: postcode --> · <!-- REPLACE: generated --></div>
+    <div class="breadcrumb">About the property · <!-- REPLACE: postcode --> · <!-- REPLACE: generated --></div>
   </header>
   <div class="eyebrow">Subject property</div>
-  <h2 style="margin-top:3mm">What this property is worth.</h2>
+  <h2 style="margin-top:3mm">About the property.</h2>
   <div class="kpis">
     <div class="kpi subject"><div class="label">Floor area</div><div class="value"><!-- REPLACE: kpi_subject_sqft --></div><div class="sub"><!-- REPLACE: kpi_subject_sqft_sub --></div></div>
     <div class="kpi subject"><div class="label">Bedrooms</div><div class="value"><!-- REPLACE: kpi_subject_beds --></div><div class="sub">As recorded</div></div>
     <div class="kpi subject"><div class="label">EPC rating</div><div class="value"><!-- REPLACE: kpi_subject_epc --></div><div class="sub"><!-- REPLACE: kpi_subject_epc_sub --></div></div>
     <div class="kpi subject"><div class="label">Type</div><div class="value" style="font-size:16pt"><!-- REPLACE: kpi_subject_type --></div><div class="sub"><!-- REPLACE: kpi_subject_tenure --></div></div>
   </div>
-  <!-- REPLACE: valuation_block -->
   <p class="muted" style="margin-top:6mm;max-width:170mm"><!-- REPLACE: subject_narrative --></p>
+  <!-- REPLACE: notable_features -->
   <div class="doc-foot"><span><!-- REPLACE: brand_name --> · Property Intelligence</span><span>02</span></div>
 </section>
 
@@ -234,7 +235,7 @@
   <div class="eyebrow">Market summary</div>
   <h2 style="margin-top:3mm"><!-- REPLACE: summary_headline --></h2>
   <div class="summary" style="max-width:170mm"><!-- REPLACE: summary_paragraphs --></div>
-  <div style="height:5mm"></div>
+  <div style="height:3mm"></div>
   <div class="kpis three">
     <div class="kpi gold"><div class="label">Average asking £</div><div class="value"><!-- REPLACE: kpi_avg_asking --></div><div class="sub">Current listings · <!-- REPLACE: postcode --></div></div>
     <div class="kpi"><div class="label">Average sold £</div><div class="value"><!-- REPLACE: kpi_avg_sold --></div><div class="sub">Completed transactions</div></div>
@@ -257,26 +258,94 @@
       <p class="muted" style="margin-top:4mm"><!-- REPLACE: demand_note --></p>
     </div>
   </div>
-  <div class="panel" style="margin-top:5mm">
-    <h4>7-year price trend · £ and £/sqft</h4>
+  <div class="doc-foot"><span><!-- REPLACE: brand_name --> · Property Intelligence</span><span>03</span></div>
+</section>
+
+<!-- PAGE 4 — MARKET DEPTH (chart + stock mix + rental pillar) -->
+<section class="page">
+  <header class="doc-head">
+    <!-- REPLACE: wordmark_dark -->
+    <div class="breadcrumb">Market depth · <!-- REPLACE: postcode --> · <!-- REPLACE: generated --></div>
+  </header>
+  <div class="eyebrow">Price trajectory</div>
+  <h2 style="margin-top:3mm;margin-bottom:5mm">Seven years of CM23 pricing.</h2>
+  <div class="panel" style="padding:5mm">
+    <div style="display:flex;justify-content:space-between;align-items:baseline;margin-bottom:3mm">
+      <h4 style="margin-bottom:0">£ headline vs achieved £/sqft</h4>
+      <div class="legend" style="margin-top:0"><span><span class="sw"></span>Average £</span><span><span class="sw gold"></span>£/sqft</span></div>
+    </div>
     <!-- REPLACE: spark_svg -->
-    <div class="legend"><span><span class="sw"></span>Average £</span><span><span class="sw gold"></span>£/sqft</span></div>
   </div>
-  <div class="doc-foot"><span><!-- REPLACE: brand_name --> · Property Intelligence</span><span>03</span></div>
+  <div style="height:8mm"></div>
+  <div class="eyebrow">Output area &amp; rental pillar</div>
+  <div class="two-col" style="align-items:stretch;margin-top:3mm">
+    <div class="panel banded" style="display:flex;flex-direction:column">
+      <h4>Output-area stock mix</h4>
+      <div style="margin-top:3mm;display:flex;flex-direction:column;gap:2mm"><!-- REPLACE: type_dist_rows --></div>
+      <p class="muted" style="margin-top:auto;padding-top:3mm">Detached stock is the scarce type in this output area.</p>
+    </div>
+    <div class="panel" style="display:flex;flex-direction:column">
+      <h4>Rental pillar</h4>
+      <div style="margin-top:3mm"><span class="pill"><!-- REPLACE: rental_rating --></span></div>
+      <div class="kpis" style="grid-template-columns:repeat(3,1fr);margin-top:4mm;margin-bottom:0">
+        <div class="kpi"><div class="label">For rent</div><div class="value"><!-- REPLACE: rental_for_rent --></div><div class="sub">homes</div></div>
+        <div class="kpi"><div class="label">DoM</div><div class="value"><!-- REPLACE: rental_dom --></div><div class="sub">days · avg</div></div>
+        <div class="kpi"><div class="label">Take-up</div><div class="value"><!-- REPLACE: rental_turnover --></div><div class="sub">of stock · mo</div></div>
+      </div>
+    </div>
+  </div>
+  <div class="doc-foot"><span><!-- REPLACE: brand_name --> · Property Intelligence</span><span>04</span></div>
+</section>
+
+<!-- PAGE 5 — SELLER PREP (what gets the best price) -->
+<section class="page">
+  <header class="doc-head">
+    <!-- REPLACE: wordmark_dark -->
+    <div class="breadcrumb">What gets the best price · <!-- REPLACE: postcode --> · <!-- REPLACE: generated --></div>
+  </header>
+  <div class="eyebrow">Quick wins for the vendor</div>
+  <h2 style="margin-top:3mm;margin-bottom:3mm">What gets the best price.</h2>
+  <p class="muted" style="max-width:170mm;margin-bottom:6mm">Photography and the first viewings carry more weight than any other moment in the campaign. These are the highest-impact prep moves — none are expensive, all are noticed by buyers.</p>
+
+  <div class="two-col" style="align-items:start;gap:8mm">
+    <div class="panel banded" style="padding:6mm">
+      <h4 style="margin-bottom:4mm">Five high-impact moves</h4>
+      <ol style="margin:0;padding-left:5mm;font-family:var(--body);font-size:10.5pt;line-height:1.55">
+        <li style="margin-bottom:3.5mm"><strong style="font-family:var(--display);font-style:italic;font-weight:500;font-size:12pt">Declutter ruthlessly.</strong> Surfaces should carry roughly half what they normally do. Buyers need space to project themselves into the home, not your life on display.</li>
+        <li style="margin-bottom:3.5mm"><strong style="font-family:var(--display);font-style:italic;font-weight:500;font-size:12pt">Deep-clean before any staging.</strong> Especially: oven, grout, windows, garden edges. Staging on top of dirt doesn't read.</li>
+        <li style="margin-bottom:3.5mm"><strong style="font-family:var(--display);font-style:italic;font-weight:500;font-size:12pt">Open up the light.</strong> Curtains fully open, lamps on even in daytime, mirrors to bounce light. Most homes photograph noticeably better with every light on.</li>
+        <li style="margin-bottom:3.5mm"><strong style="font-family:var(--display);font-style:italic;font-weight:500;font-size:12pt">Fix the small things.</strong> Dripping taps, chipped paint, loose handles, squeaky doors. Buyers register every defect — and discount for each one.</li>
+        <li><strong style="font-family:var(--display);font-style:italic;font-weight:500;font-size:12pt">Define each room.</strong> A study-in-a-bedroom shows as a study. Return rooms to their named purpose for photos and viewings.</li>
+      </ol>
+    </div>
+    <div class="panel" style="padding:6mm">
+      <h4 style="margin-bottom:4mm">Common mistakes</h4>
+      <ul style="margin:0;padding-left:5mm;font-family:var(--body);font-size:10.5pt;line-height:1.55">
+        <li style="margin-bottom:3mm">Strong air fresheners — they signal you're hiding something.</li>
+        <li style="margin-bottom:3mm">Personal photos, religious items, children's artwork — the buyer can't project on top.</li>
+        <li style="margin-bottom:3mm">A cold house in winter — no one buys a cold home enthusiastically.</li>
+        <li style="margin-bottom:3mm">Overgrown garden or untidy front — the first ten seconds are kerb appeal.</li>
+        <li>Wardrobes left untouched — buyers do open them. Reduce by half.</li>
+      </ul>
+      <p class="muted" style="margin-top:6mm;font-size:9pt;font-style:italic"><!-- REPLACE: prepared_by --> can walk you through this room-by-room ahead of photo day.</p>
+    </div>
+  </div>
+
+  <div class="doc-foot"><span><!-- REPLACE: brand_name --> · Property Intelligence</span><span>05</span></div>
 </section>
 
-<!-- PAGE 4 — COMPARABLES (FULL-WIDTH, STACKED) -->
+<!-- PAGE 6 — COMPARABLES (FULL-WIDTH, STACKED) -->
 <section class="page">
   <header class="doc-head">
     <!-- REPLACE: wordmark_dark -->
     <div class="breadcrumb">Comparables · <!-- REPLACE: postcode --> · <!-- REPLACE: generated --></div>
   </header>
   <div class="eyebrow">Evidence</div>
-  <h2 style="margin-top:3mm;margin-bottom:5mm">The comparables behind the range.</h2>
+  <h2 style="margin-top:3mm;margin-bottom:5mm">Comparable transactions and live listings.</h2>
   <div class="panel banded">
     <h4>Nearest sold transactions · Land Registry</h4>
     <table class="cmp" style="margin-top:3mm">
-      <tr><th>Date</th><th>Address</th><th>Type</th><th style="text-align:right">Price</th></tr>
+      <tr><th>Date</th><th>Address</th><th>Type</th><th>Beds</th><th style="text-align:right">Price</th></tr>
       <!-- REPLACE: sold_comps_rows -->
     </table>
   </div>
@@ -286,10 +355,10 @@
       <!-- REPLACE: asking_comps_tiles -->
     </div>
   </div>
-  <div class="doc-foot"><span><!-- REPLACE: brand_name --> · Property Intelligence</span><span>04</span></div>
+  <div class="doc-foot"><span><!-- REPLACE: brand_name --> · Property Intelligence</span><span>06</span></div>
 </section>
 
-<!-- PAGE 5 — AGENT LISTINGS + SOURCES -->
+<!-- PAGE 7 — AGENT LISTINGS + SOURCES -->
 <section class="page">
   <header class="doc-head">
     <!-- REPLACE: wordmark_dark -->
@@ -302,10 +371,10 @@
   <div class="sources">
     <h4>Sources &amp; methodology</h4>
     <p><strong>Sources.</strong> PropertyData (asking, sold, demand, growth, crime, flood, council tax, property-type mix). HM Land Registry (sold transactions). Home Office (recorded crime). Environment Agency (flood risk). Valuation Office Agency (council-tax bands). Department for Levelling Up, Housing &amp; Communities — EPC register (subject floor area &amp; energy rating).</p>
-    <p><strong>Method.</strong> Twelve PropertyData endpoints called on the postcode derived from the address, plus one EPC lookup on the subject address. Valuation range = subject floor area × the Land Registry 70-percent £/sqft band, with operator-supplied adjustments applied linearly. Live and recent listings shown on the previous page were picked by <!-- REPLACE: brand_name -->.</p>
+    <p><strong>Method.</strong> Twelve PropertyData endpoints called on the postcode derived from the address, plus the EPC certificate fields for the subject. This pack does <em>not</em> quote a numeric valuation — the human agent values the property in person, drawing on the Land Registry sold £/sqft band, the live asking £/sqft, and the comparables on this page. Live and recent listings shown on the next page were picked by <!-- REPLACE: brand_name -->.</p>
     <p><strong>Accuracy.</strong> Property data can change rapidly. Figures are estimates — obtain independent professional advice for specific decisions. This pack is not financial or investment advice.</p>
   </div>
-  <div class="doc-foot"><span><!-- REPLACE: brand_name --> · Generated <!-- REPLACE: generated --> · <!-- REPLACE: postcode --></span><span>05</span></div>
+  <div class="doc-foot"><span><!-- REPLACE: brand_name --> · Generated <!-- REPLACE: generated --> · <!-- REPLACE: postcode --></span><span>07</span></div>
 </section>
 
 </body>

package/payload/premium-plugins/real-agent/specs/03-new-instruction.md

@@ -9,7 +9,7 @@
 
 ## 1. Purpose
 
-Compress what is normally a half-day of admin — terms of business signed, EPC ordered, photographer booked, floorplan commissioned, listing copy written, particulars produced, portal launches scheduled — into a guided sequence the agent reviews and approves in fifteen minutes.
+Compress what is normally a half-day of admin — terms of business signed, photographer booked, floorplan commissioned, listing copy written, particulars produced, portal launches scheduled — into a guided sequence the agent reviews and approves in fifteen minutes.
 
 This workflow is the second-highest-value moment in the agent's week (after winning the instruction itself). Done well, the property is on the portals within 72 hours of the appointment rather than 7–10 days. That speed compounds: faster on-market means more viewings in the first weekend, which is when offers happen.
 
@@ -31,8 +31,6 @@ A sequenced checklist where each item is either auto-prepared (the workflow does
 
 **Terms of business.** Drafted from agency template, populated with property, vendor, fee structure, sole/multi agency, marketing period, withdrawal fee. Staged in DocuSign with vendor as recipient. *Gate: approve before send.*
 
-**EPC.** If the property does not have a current EPC (checked via EPC register), an order is staged with the agent's preferred supplier (from profile). If a current EPC exists, the workflow records the expiry date and moves on. *Gate: approve order before send if no current EPC.*
-
 **Photography.** A booking request is drafted to the agent's preferred photographer (from profile), with the property address, vendor contact, and the agent's standard brief. *Gate: approve before send.*
 
 **Floorplan.** As photography. Combined into a single booking request if the same supplier handles both. *Gate: approve before send.*
@@ -50,7 +48,6 @@ A sequenced checklist where each item is either auto-prepared (the workflow does
 | Skill | Purpose |
 |---|---|
 | `terms-of-business-drafter` | Populates the agency's template with deal specifics |
-| `epc-checker` | Looks up the EPC register, computes order need |
 | `supplier-booker` | Drafts and stages booking requests to photographer, EPC supplier, floorplan supplier |
 | `listing-copy-writer` | Generates portal-optimised property descriptions |
 | `particulars-builder` | Composes the PDF brochure |
@@ -60,7 +57,7 @@ A sequenced checklist where each item is either auto-prepared (the workflow does
 
 ## 5. Connectors read and written
 
-Read: CRM, EPC register, calendar, profile.
+Read: CRM, calendar, profile.
 Write: DocuSign (terms), email (vendor welcome, supplier bookings), portal upload APIs (Rightmove, Zoopla, OnTheMarket — staged only).
 
 ## 6. Approval gates
@@ -68,13 +65,12 @@ Write: DocuSign (terms), email (vendor welcome, supplier bookings), portal uploa
 This workflow has the most write actions of any in the set. Each one is individually gated:
 
 1. Terms of business send
-2. EPC order (if applicable)
-3. Photographer booking
-4. Floorplan booking
-5. Listing copy use (final version before portal upload)
-6. Particulars distribution
-7. Portal launch schedule confirmation
-8. Vendor welcome email send
+2. Photographer booking
+3. Floorplan booking
+4. Listing copy use (final version before portal upload)
+5. Particulars distribution
+6. Portal launch schedule confirmation
+7. Vendor welcome email send
 
 The workflow presents these in sequence and respects the operator's pace. The agent can approve them all in one go ("ship everything") or one at a time, or pause the workflow and return later. State is preserved.