@rubytech/create-maxy-code 0.1.63 → 0.1.64

package/payload/premium-plugins/real-agent/plugins/listings/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "real-agent-listings",
-  "description": "Valuation prep and new-instruction onboarding for UK residential sales agents. Includes the valuation-prep master plus four building blocks (comparable-finder, local-market-stats, pricing-scenario-builder, talk-track-composer) and the new-instruction master plus its six building blocks (terms-of-business-drafter, epc-checker, supplier-booker, listing-copy-writer, particulars-builder, portal-launch-scheduler). Also retains the existing listing-presentation, property-marketing, and home-preparation skills.",
+  "description": "Valuation prep and new-instruction onboarding for UK residential sales agents. Includes the valuation-prep master plus four building blocks (comparable-finder, local-market-stats, pricing-scenario-builder, talk-track-composer) and the new-instruction master plus its five building blocks (terms-of-business-drafter, supplier-booker, listing-copy-writer, particulars-builder, portal-launch-scheduler). Also retains the existing listing-presentation, property-marketing, and home-preparation skills.",
   "version": "0.1.0",
   "author": {
     "name": "Rubytech LLC"

package/payload/premium-plugins/real-agent/plugins/listings/PLUGIN.md

@@ -1,6 +1,6 @@
 ---
 name: real-agent-listings
-description: "Valuation prep and new-instruction onboarding for UK residential sales agents. Includes the valuation-prep master plus four building blocks (comparable-finder, local-market-stats, pricing-scenario-builder, talk-track-composer) and the new-instruction master plus its six building blocks (terms-of-business-drafter, epc-checker, supplier-booker, listing-copy-writer, particulars-builder, portal-launch-scheduler). Also retains the existing listing-presentation, property-marketing, and home-preparation skills."
+description: "Valuation prep and new-instruction onboarding for UK residential sales agents. Includes the valuation-prep master plus four building blocks (comparable-finder, local-market-stats, pricing-scenario-builder, talk-track-composer) and the new-instruction master plus its five building blocks (terms-of-business-drafter, supplier-booker, listing-copy-writer, particulars-builder, portal-launch-scheduler). Also retains the existing listing-presentation, property-marketing, and home-preparation skills."
 tools: []
 skills:
   - skills/valuation-prep/SKILL.md
@@ -10,7 +10,6 @@ skills:
   - skills/talk-track-composer/SKILL.md
   - skills/new-instruction/SKILL.md
   - skills/terms-of-business-drafter/SKILL.md
-  - skills/epc-checker/SKILL.md
   - skills/supplier-booker/SKILL.md
   - skills/listing-copy-writer/SKILL.md
   - skills/particulars-builder/SKILL.md
@@ -80,7 +79,6 @@ The user is preparing for a valuation or market appraisal, has just won an instr
 | `talk-track-composer` | valuer | Drafts vendor questions, objections, USP |
 | `new-instruction` | valuer then negotiator | Master workflow: terms to portal in 72 hours |
 | `terms-of-business-drafter` | compliance | Populates the agency template and stages DocuSign |
-| `epc-checker` | valuer | EPC register lookup and order staging |
 | `supplier-booker` | negotiator | Photographer and floorplan bookings |
 | `listing-copy-writer` | negotiator | Portal-optimised descriptions, material info |
 | `particulars-builder` | negotiator (chains into Maxy `content-producer` for PDF render) | Property brochure |

package/payload/premium-plugins/real-agent/plugins/listings/skills/new-instruction/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: new-instruction
-description: "Run the post-win onboarding sequence after a valuation is won. Drafts terms of business, checks the EPC, books photographer and floorplan supplier, drafts listing copy and PDF particulars, schedules portal launch, and drafts the vendor welcome. Each write action is individually gated. Triggers when the operator says 'set up <address>', 'I won <name>', 'I won the <address> val', 'instruction taken at <address>', 'get <address> on the market', 'kick off the <name> property'. Also offered proactively when the CRM marks a property as instructed."
+description: "Run the post-win onboarding sequence after a valuation is won. Drafts terms of business, books photographer and floorplan supplier, drafts listing copy and PDF particulars, schedules portal launch, and drafts the vendor welcome. Each write action is individually gated. Triggers when the operator says 'set up <address>', 'I won <name>', 'I won the <address> val', 'instruction taken at <address>', 'get <address> on the market', 'kick off the <name> property'. Also offered proactively when the CRM marks a property as instructed."
 ---
 
 # New instruction
 
-The master workflow that takes a property from "instruction won" to "on the portal" inside 72 hours. Owned jointly by the valuer (until terms are signed and the EPC is confirmed) and the negotiator (from photography onward).
+The master workflow that takes a property from "instruction won" to "on the portal" inside 72 hours. Owned jointly by the valuer (until terms are signed) and the negotiator (from photography onward).
 
 Done well, this workflow is the second-highest-value moment in the agent's week after winning the instruction itself. The speed compounds: faster on-market means more viewings in the first weekend, which is when offers happen.
 
@@ -20,7 +20,7 @@ If any input is missing, the workflow asks once and then proceeds with the rest
 
 ## Architecture principles encoded here
 
-- Read before write. The workflow opens by reading the property's CRM state, the EPC register, and the calendar. It writes nothing until the operator approves each individual stage.
+- Read before write. The workflow opens by reading the property's CRM state and the calendar. It writes nothing until the operator approves each individual stage.
 - Stage, don't send. Every write action is staged, not fired. Eight gates in total, each individually approved.
 - One screen of output. The sequenced checklist is one screen even when every item is staged. Each item collapses to a status line.
 - Cite the source. Every populated field in the terms of business, the listing copy, and the particulars traces to a CRM record, a profile entry, or a connector read.
@@ -29,16 +29,15 @@ If any input is missing, the workflow asks once and then proceeds with the rest
 
 ## Sequence and approval gates
 
-The workflow presents the eight steps in order. The operator can approve them one at a time, approve everything ("ship everything"), or pause and return later. State is preserved between sessions.
+The workflow presents the seven steps in order. The operator can approve them one at a time, approve everything ("ship everything"), or pause and return later. State is preserved between sessions.
 
 1. **Terms of business.** Drafted by `terms-of-business-drafter` from the agency template, populated with property, vendor, fee structure, sole or multi agency, marketing period, withdrawal fee. Staged in DocuSign with the vendor as recipient. *Gate: approve before send.*
-2. **EPC check.** `epc-checker` looks up the EPC register. If a current EPC exists, the workflow records the expiry date and moves on, no gate needed. If not, an order is staged with the agent's preferred supplier from the profile. *Gate: approve order before send if no current EPC.*
-3. **Photographer booking.** `supplier-booker` drafts a booking request to the agent's preferred photographer with the property address, vendor contact, and the agent's standard brief. *Gate: approve before send.*
-4. **Floorplan booking.** Same as photography. Combined into a single booking request if the same supplier handles both. *Gate: approve before send.*
-5. **Listing copy.** Drafted by `listing-copy-writer` in the agent's voice, length, and structure from the profile. Headline, key features bullets, full description, location paragraph. Optimised for the profile's portals. *Gate: approve before any portal upload.*
-6. **Particulars.** PDF brochure built by `particulars-builder`. The skill chains into the Maxy `content-producer` for the PDF render so the agency brand is applied consistently. Staged for the agent's review and the vendor's review before any wider distribution. *Gate: approve distribution before send.*
-7. **Portal launch schedule.** `portal-launch-scheduler` proposes the launch sequence (Rightmove premium on a Friday by default; learns). Staged, not fired. *Gate: approve schedule before any portal upload happens.*
-8. **Vendor welcome email.** Drafted by `tone-matched-drafter` explaining what happens next, what to expect, when to expect photos, who will be in touch. *Gate: approve before send.*
+2. **Photographer booking.** `supplier-booker` drafts a booking request to the agent's preferred photographer with the property address, vendor contact, and the agent's standard brief. *Gate: approve before send.*
+3. **Floorplan booking.** Same as photography. Combined into a single booking request if the same supplier handles both. *Gate: approve before send.*
+4. **Listing copy.** Drafted by `listing-copy-writer` in the agent's voice, length, and structure from the profile. Headline, key features bullets, full description, location paragraph. Optimised for the profile's portals. *Gate: approve before any portal upload.*
+5. **Particulars.** PDF brochure built by `particulars-builder`. The skill chains into the Maxy `content-producer` for the PDF render so the agency brand is applied consistently. Staged for the agent's review and the vendor's review before any wider distribution. *Gate: approve distribution before send.*
+6. **Portal launch schedule.** `portal-launch-scheduler` proposes the launch sequence (Rightmove premium on a Friday by default; learns). Staged, not fired. *Gate: approve schedule before any portal upload happens.*
+7. **Vendor welcome email.** Drafted by `tone-matched-drafter` explaining what happens next, what to expect, when to expect photos, who will be in touch. *Gate: approve before send.*
 
 ## AML and material information
 
@@ -58,7 +57,7 @@ All writes go through `profile-writer`.
 
 ## Connectors
 
-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).
 
 ## Profile keys

package/payload/premium-plugins/real-agent/plugins/preval/skills/property-preval/SKILL.md

@@ -1,21 +1,38 @@
 ---
 name: property-preval
-description: Use when an operator wants a pre-valuation pack to pitch for a UK property listing — a 5-page A4 PDF that combines a market-data report for the postcode with the subject property's own valuation range, full-width sold + asking comparables, and the agent's recent successes as the sales close. Triggers include "preval <address>", "pre-valuation for <address>", "valuation pitch for <address>", "what's <address> worth and pitch us to list it", "pre-appraisal pack for <address>".
+description: Use when an operator wants a pre-valuation pack to pitch for a UK property listing — a 7-page A4 PDF that combines subject facts, postcode market context, market depth, vendor-side "what gets the best price" prep tips, full-width sold + asking comparables, and the agent's recent successes as the sales close. Available in two style variants (premium = editorial Cormorant/Lora/Inter lock; on-brand = follows the agent's DESIGN.md fonts end-to-end). Triggers include "preval <address>", "pre-valuation for <address>", "valuation pitch for <address>", "what's <address> worth and pitch us to list it", "pre-appraisal pack for <address>".
 ---
 
 # Property Preval
 
-A 5-page A4 PDF that pitches the agent for the listing: cover (full-bleed subject hero), subject valuation (sqft × £/sqft band with operator adjustments), market context, full-width comparables (sold + asking stacked), and the agent's recent successes + disclaimer. **Preval is a sales pitch, not just a data sheet** — every page either tells the vendor what the property is worth or what the agent has recently delivered nearby.
+A 7-page A4 PDF that pitches the agent for the listing: cover (full-bleed subject hero + agent byline), subject facts, market context, market depth, vendor-side prep tips ("What gets the best price"), full-width comparables, and the agent's recent successes + disclaimer. **Preval is the data-and-comparables half of the pitch — the human agent values the property in person.** The pack never quotes a numeric estimate or range; that's the agent's job, supported by the comparables on page 6.
 
-## Typography is fixed; only colours and logos come from the agent
+## Style variants — premium (default) or on-brand
 
-Same typographic lock as `property-market-report`:
+The pack renders in one of two variants, selected via the top-level `variant` field on `inputs.json`. The two variants share the same content and layout — only typography differs.
+
+### `variant: "premium"` (default — editorial folio)
+
+Typography lock — never substituted:
 
 - **Display** — Cormorant Garamond (italic for headlines, KPI values, prices, addresses)
 - **Body** — Lora
 - **Sans / labels** — Inter (eyebrows, KPI labels, chips, footer meta)
 
-Never substitute the agent's body or display fonts even if their `DESIGN.md` specifies different families. The pack reads as an editorial / luxury document across every brand. The agent's identity comes through the **palette and logo only**.
+The pack reads as an editorial / luxury document across every brand. The agent's identity comes through the **palette and logo only**. The agent's `DESIGN.md` font tokens are ignored.
+
+### `variant: "on-brand"` (follows the agent's DESIGN.md end-to-end)
+
+Renderer reads `brand.font_display` and `brand.font_body` from `inputs.json` (sourced from the agent's `DESIGN.md` font tokens) and overrides the `--display` / `--body` / `--sans` CSS variables. Headlines, body copy, eyebrows and labels all switch to the agent's identity. Colour tokens + logo apply as in premium.
+
+Schema requires `brand.font_display` to be set for `on-brand` to engage — a missing display font silently falls back to the premium lock (no broken render). `brand.font_body` defaults to `brand.font_display` if not supplied.
+
+### Decision rule (mirrors `property-brochure`)
+
+1. Operator said "premium" / "super-premium" / "editorial" → premium (regardless of DESIGN.md).
+2. Operator said "on-brand" / "branded" / "follow our DESIGN.md" → on-brand.
+3. Operator silent + `DESIGN.md` provides both font tokens → on-brand (default for branded shops).
+4. Otherwise → premium.
 
 ## Inputs (never invented)
 
@@ -25,10 +42,15 @@ Never substitute the agent's body or display fonts even if their `DESIGN.md` spe
   - `cover_hero` (filesystem path or URL to a photo of the subject — required for the cover).
   - Optional `beds`, `type`, `tenure`, `condition` (well / average / needs work).
   - `adjustments[]` — operator-curated array of `{label, delta_pct}` covering esoteric factors that shift the headline range (e.g. `{"label":"South-facing garden","delta_pct":3}`, `{"label":"Needs full reno","delta_pct":-8}`). Deltas sum linearly into the final range.
-  - `narrative` — one short paragraph the operator writes about the property.
   - **EPC certificate fields are pasted by the operator before invocation.** The three required fields are `subject.total_floor_area_m2`, `subject.current_energy_rating`, and `subject.lodgement_date` — copied verbatim from the EPC certificate. The renderer derives `sqft` from `total_floor_area_m2 × 10.7639`. There is no mid-run paste prompt and no benchmark-only render — a null in any of the three aborts the run with `reason=epc-certificate-not-supplied`.
 - **`agent_listings`** — the agent's recent sold / under-offer / live listings to feature on the closing page. Up to 6 entries of `{url, address, price, beds, type, image, status, slug}` where `status ∈ {"Sold","Under offer","For sale"}`. Operator picks the comps that make the strongest pitch; this is *not* the PropertyData sample.
-- **`market_summary`** — `headline` (one display-italic line), `paragraphs[]` (2–3 short paragraphs), `demand_gauge_position` (percentage string like `"62%"`), `price_growth_note`, `demand_note`. The operator drafts or accepts an LLM stub.
+
+## Composed by the agent from the fan-out (never operator-supplied)
+
+Two prose fields are written by the agent from the 12-call PropertyData fan-out plus the EPC and council-tax records — the operator is never prompted for them.
+
+- **`subject.narrative`** — one short paragraph (1–3 sentences) under the valuation panel. Composed from: EPC sqft + rating, `lodgement_date` vs today (age), subject council-tax band (from the per-property `council-tax.properties[]` entry that matches the subject's house number), street context (count of dwellings on the road from the same response), plus the operator's `subject.adjustments[]` labels. Pure facts only — never speculate about orientation, decor, or interior condition that the data doesn't carry.
+- **`market_summary`** — `headline` (one display-italic line), `paragraphs[]` (2–3 short paragraphs), `demand_gauge_position` (percentage string like `"62%"`), `price_growth_note`, `demand_note`. Every value composed from the 12-call fan-out output. Mapping: `headline` summarises the postcode in one line (e.g. demand rating + scarcity + £/sqft direction); paragraph 1 covers £/sqft band (sold vs asking) + Land Registry sample window; paragraph 2 covers demand (for-sale count, sales/mo, MoI, DoM, turnover) + property-type mix; paragraph 3 covers growth (£ + £/sqft YoY) + rental pillar. `demand_gauge_position` maps the demand rating to a percentage: Buyer's market ≈ 20–30%, Balanced market ≈ 45–55%, Seller's market ≈ 75–85%, tuned within band by MoI/DoM.
 
 ## Tools the skill calls
 
@@ -54,21 +76,25 @@ EPC certificate fields are operator paste-in — see `subject.total_floor_area_m
 
 ## Output
 
-Directory under `~/Documents/Maxy/preval/<postcode-compact>-<YYYY-MM-DD>/` containing:
+Directory under `~/estate-agents/<brand-slug>/preval/<address-slug>/` (e.g. `~/estate-agents/muvin/preval/11-phoenix-drive-cm23-2uj/`) containing:
 
 - `index.html` — single self-contained file.
 - `img/` — copied logos and the subject hero image.
-- `<slug>-<date>.pdf` — exactly **5** A4 pages. Renderer asserts via `pdfinfo` and raises if ≠ 5.
+- `<slug>-<date>.pdf` — exactly **7** A4 pages. Renderer asserts via `pdfinfo` and raises if ≠ 7.
+- `property-data.md` — markdown dump of the 12 raw PropertyData fan-out responses for transparency / vendor audit (operator may share or strip before sending).
+- `inputs.json` + `preval.log` — the assembled input shape + the `[preval]` start/done/aborted audit lines.
 
-Return the PDF path to the operator.
+Output is agent-centric so each brand owns its own preval history alongside its `properties/`, `reports/` and `DESIGN.md`. Return the PDF path to the operator.
 
 ## Pages
 
-1. **Cover** — full-bleed `subject.cover_hero` with vertical gradient scrim; light logo top-left; eyebrow "`<brand.name>` · Pre-valuation"; address in display-italic; postcode chip; four-up meta strip (Report · Address · Postcode · Generated). Lifted from property-market-report's cover contract.
-2. **Subject valuation** — KPI strip (sqft, beds, EPC rating, type). Centre panel: headline range = `sqft × sold_psf_low–high` (Land Registry 70pc band) with `sqft × asking_psf` shown as a cross-check. Operator `adjustments[]` displayed as a stacked list (label · delta% · running £). Final range pill at the foot. One paragraph of `subject.narrative` under the panel. `sqft` is required — a null value aborts the run, never renders a benchmark-only panel.
-3. **Market context** — KPI cube (avg asking, avg sold, £/sqft, YoY); pill + gauge for demand; 7y growth sparkline (£ solid + £/sqft dashed); summary paragraphs. Same patterns as property-market-report's page 2.
-4. **Comparables (full-width, stacked)** — Nearest sold table (top 6) full-width across the page; Live asking tile grid (top 4) full-width below. Vertically stacked, never side-by-side — corrects the cramped two-column layout in the v1 preval where the asking tiles got pushed to ~40mm columns of italic addresses.
-5. **Recently with `<brand.name>` + sources** — agent's own listings as a clickable tile grid (`<a>` per card, status badge: Sold / Under offer / For sale), then the sources / methodology / accuracy / investment block. Closes with `Real Agent · Generated <date> · <postcode>` in the footer.
+1. **Cover** — full-bleed `subject.cover_hero` with vertical gradient scrim; light logo top-left; eyebrow "`<brand.name>` · Pre-valuation"; address in display-italic; postcode chip; four-up meta strip (Prepared by · Address · Postcode · Generated). When `brand.agent_name` is set, "Prepared by" displays that name (ties the cover photo to the individual agent pitching).
+2. **About the property** — KPI strip (sqft, beds, EPC rating, type, tenure). Agent-composed `subject.narrative` under the KPIs (drawn from EPC + council-tax records — see "Composed by the agent from the fan-out"). Optional "Notable features" bullet list rendered from `subject.adjustments[].label` (label-only — `delta_pct` is held in the schema for backward compat but no longer rendered). **No estimate, no range, no adjustments-with-running-£**. `sqft` is required — a null value aborts the run, never renders a benchmark-only panel.
+3. **Market context** — Market-summary headline + 2–3 paragraphs (dropcap on first); KPI cube (avg asking, avg sold, £/sqft); two-col panels (price growth + demand gauge). The 7-year chart used to live here; it now has its own page (page 4) to give it space.
+4. **Market depth** — Full-width 7-year price-trend chart (£ headline solid + £/sqft dashed gold, ≈ 48mm tall). Below: two-col panels — output-area stock mix (`demand_trend.type_dist` bars) on the left, rental pillar on the right (`demand_trend.rating` pill + 3-up KPIs for for-rent count, DoM, monthly take-up).
+5. **What gets the best price** — Vendor-facing prep advice condensed from `real-agent/listings/home-preparation/staging-guide.md`. Two-col panel: "Five high-impact moves" (declutter / deep-clean / open the light / fix the small things / define each room) on the left; "Common mistakes" (air fresheners / personal items / cold house / overgrown garden / wardrobes) on the right. Closes with a line attributing the room-by-room walkthrough to the agent ("`<agent_name>` can walk you through this room-by-room ahead of photo day."). Content is hard-coded into the template — not per-pack-editable; for per-property customisation operators should swap to the brochure flow.
+6. **Comparables (full-width, stacked)** — Nearest sold table (top 6, columns Date · Address · Type · Beds · Price) full-width across the page; Live asking tile grid (top 4) full-width below. Vertically stacked, never side-by-side — corrects the cramped two-column layout in the v1 preval where the asking tiles got pushed to ~40mm columns of italic addresses.
+7. **Recently with `<brand.name>` + sources** — agent's own listings as a clickable tile grid (`<a>` per card, status badge: Sold / Under offer / For sale), then the sources / methodology / accuracy / investment block. Closes with `<brand.name> · Generated <date> · <postcode>` in the footer.
 
 ## How to execute
 
@@ -78,19 +104,15 @@ Return the PDF path to the operator.
    - **PropertyData `http-429`** → back off and retry the single throttled tool **once**. A second `http-429` aborts `reason=property-data-rate-limited`.
    - **PropertyData `http-5xx` / network failure** → abort `reason=property-data-unavailable`.
    - **Watchdog: any of the 12 PropertyData log lines missing** within 60 s of `[preval] start` → `render.py` aborts `reason=observability-missing tool=<name>` naming the silent tool. A silent tool drop must never proceed to render.
-3. Compute valuation range:
-   - `sqft = round(subject.total_floor_area_m2 × 10.7639)` (operator-pasted m² × the standard conversion factor).
-   - `sold_psf_low` = `sold-prices-per-sqf` `70pc_range[0]`
-   - `sold_psf_high` = `sold-prices-per-sqf` `70pc_range[1]`
-   - `low = sqft × sold_psf_low`, `mid = sqft × sold_psf`, `high = sqft × sold_psf_high`
-   - Apply `adjustments` linearly: `factor = 1 + Σ delta_pct / 100`. Final range = `[low × factor, high × factor]`, midpoint = `mid × factor`.
-4. Assemble the `inputs.json` shape per `references/template-inputs.schema.json`.
-5. `python3 references/render.py inputs.json`. Renderer fills the template, copies logos + hero into `img/`, drives Chrome `--print-to-pdf`, asserts page count == 5.
-6. Return the PDF path.
+3. Derive `sqft` from `round(subject.total_floor_area_m2 × 10.7639)` for the page-2 KPI strip. The pack does not compute a £-valuation; the £/sqft band lives on page 3 (market context) and the comparables on page 4 — the human agent values from those in person.
+4. Compose `subject.narrative` and `market_summary` from the fan-out output per the rules in "Composed by the agent from the fan-out". No operator prompt for either.
+5. Assemble the `inputs.json` shape per `references/template-inputs.schema.json`.
+6. `python3 references/render.py inputs.json`. Renderer fills the template, copies logos + hero into `img/`, drives Chrome `--print-to-pdf`, asserts page count == 7.
+7. Return the PDF path.
 
-## Adjustments — linear vs compound
+## Adjustments — label-only
 
-Deltas sum linearly (`-8 + 3 = -5%`, applied as `× 0.95`). Compound interpretation (`× 0.92 × 1.03`) would give a slightly different number (-5.24%) but the operator presents the figures verbally as a sum, so the displayed maths must match the verbal claim. If a future operator wants compound adjustments, this is a deliberate skill-level rewrite, not a config switch.
+`subject.adjustments[]` survives in the schema as `{label, delta_pct}` but the renderer uses only the `label` field — rendered as a "Notable features" bullet list on page 2. `delta_pct` is held for backward compat (it used to drive a numeric range that this skill no longer publishes). The human agent factors notable features into their valuation conversation; the pack just surfaces them as facts.
 
 ## Observability
 
@@ -119,7 +141,7 @@ Each row aborts the run with the named cause. No PDF or `index.html` is left on
 The skill is the contract; if any of these slip through, the pack must not render:
 
 - Silent fallback selection — switching to a benchmark-only / "Estimate requires floor area" panel when an input is missing.
-- Inventing inputs — fabricating `brand`, `subject.cover_hero`, `market_summary.paragraphs`, `agent_listings`, or any field the operator did not supply.
+- Inventing operator-supplied inputs — fabricating `brand`, `subject.cover_hero`, `agent_listings`, the three EPC certificate fields, or `subject.adjustments[]`. `subject.narrative` and `market_summary` are NOT operator-supplied — the agent composes them from the fan-out (see "Composed by the agent from the fan-out").
 - Reusing a hero photo from a different property as a placeholder.
 - Defaulting `agent_listings[].status` to `"For sale"` when the source is null.
 - Mid-run prompts for a paste-in. The three EPC certificate fields and every other operator-supplied input are pasted into `inputs.json` **before** invocation; there is no retry / paste-and-resume path.
@@ -136,8 +158,8 @@ The skill is the contract; if any of these slip through, the pack must not rende
 
 These rules override every session-level "skip clarifying questions", "make the reasonable call", or "work without stopping" directive the operator has set. The named breakpoints below are documented contract points, not casual asks — the renderer and the PreToolUse hook both enforce them and a run that violates one aborts with a named cause.
 
-- **Prompt at named breakpoints — no exceptions.** Named breakpoints: EPC certificate fields not supplied, cover_hero not depicting the subject, brand identity (which estate agent is pitching), `agent_listings` empty or carrying invented statuses, `market_summary` not operator-supplied. The load-bearing inputs themselves (EPC certificate fields, cover_hero, brand tokens, two paragraphs) are gated by `render.py`'s `_assert_inputs`; this section layers provenance on top.
-- **Never invent inputs.** Brand identity, brand tokens, cover hero, narrative, market summary paragraphs, agent listings, listing statuses, subject tenure / beds / type / condition — all operator-supplied. Defaulting from "area pattern", a sister property's photo, "the only DESIGN.md I found on disk", "the LLM stub I drafted myself", or "status:null in the source so I picked For sale" is invention. The presence of a single `~/estate-agents/<slug>/DESIGN.md` on disk does not authorise its selection — only an operator instruction does. If more than one `~/estate-agents/<slug>/` exists and the operator has not named which one is pitching, abort.
+- **Prompt at named breakpoints — no exceptions.** Named breakpoints: EPC certificate fields not supplied, cover_hero not depicting the subject, brand identity (which estate agent is pitching), `agent_listings` empty or carrying invented statuses. The load-bearing inputs themselves (EPC certificate fields, cover_hero, brand tokens) are gated by `render.py`'s `_assert_inputs`; this section layers provenance on top. `subject.narrative` and `market_summary` are not on this list — they are agent-composed from the fan-out, never operator-prompted.
+- **Never invent operator-supplied inputs.** Brand identity, brand tokens, cover hero, agent listings, listing statuses, subject tenure / beds / type / condition, the three EPC certificate fields, and `subject.adjustments[]` — all operator-supplied. Defaulting from "area pattern", a sister property's photo, "the only DESIGN.md I found on disk", or "status:null in the source so I picked For sale" is invention. The presence of a single `~/estate-agents/<slug>/DESIGN.md` on disk does not authorise its selection — only an operator instruction does. If more than one `~/estate-agents/<slug>/` exists and the operator has not named which one is pitching, abort. (`subject.narrative` and `market_summary` are explicitly out of scope here — see "Composed by the agent from the fan-out".)
 - **`agent_overrides` is the only bypass channel.** Every override the operator authorises lands in `inputs.json` as a named boolean (`brand_selected_by_operator`, `listings_status_curated`) so the audit trail sits next to the disputed value. Setting an override without a real operator instruction is a violation of the same contract.
 - **Emit the three `[preval]` log lines — every run.** `[preval] start address="…" postcode=…`, then `[preval] done pdf=… pages=… ms=…` on success or `[preval] aborted reason=<cause> ms=…` on any abort. A run that emits neither `done` nor `aborted` is itself a defect.
 
@@ -147,7 +169,6 @@ These rules override every session-level "skip clarifying questions", "make the
 |---|---|---|
 | `cover-hero-not-subject` | `subject.cover_hero` resolves to a `*/properties/*/` directory whose slug doesn't contain the subject's primary street token | Supply the subject's own photo |
 | `agent-listings-invented` | An `agent_listings[].status` is set when the source `property.json` (named by `agent_listings[].origin`) carries `status: null`, and `agent_overrides.listings_status_curated` is not `true` | Operator signs off on each listing status, then sets the override |
-| `market-summary-invented` | `market_summary.origin` is missing or not in `{"operator", "operator-edited-llm-stub"}` | Operator drafts or accepts the paragraphs; set `origin` accordingly |
 | `brand-invented` | `brand.name` is set without `agent_overrides.brand_selected_by_operator: true` | Operator names which estate agent is pitching; set the override |
 | `epc-certificate-not-supplied` | Any of `subject.total_floor_area_m2`, `subject.current_energy_rating`, or `subject.lodgement_date` is null or missing | Operator copies the three fields verbatim from the EPC certificate into `subject` in `inputs.json` before re-invoking |
 | `observability-missing tool=<name>` | One of the 12 expected `[property-data] tool=<name>` log lines did not appear within 60 s of `[preval] start` | Re-invoke and confirm every PropertyData tool returns; if a tool is genuinely down, surface a `property-data-*` cause first |
@@ -161,9 +182,10 @@ Answer all seven inline at the end of every run, with line references from `serv
 2. All 12 expected `[property-data] tool=<name>` log lines present, or `[preval] aborted` emitted with a named cause? (cite the lines)
 3. EPC certificate fields (`subject.total_floor_area_m2`, `subject.current_energy_rating`, `subject.lodgement_date`) all populated from the operator paste? (cite the `inputs.json` excerpt)
 4. Every input field traceable to a real source — operator paste (including the EPC certificate), on-disk `DESIGN.md`, MCP response? Anything sourced from "area pattern", a sister property file, or LLM imagination is a defect.
-5. `[preval] done pages=5` emitted? (cite the log line)
-6. PDF page count = 5 asserted? (cite the assertion result)
-7. No fields invented from area pattern, sister-property files, or LLM imagination? List the three most fabrication-prone fields (`brand.name`, `market_summary.paragraphs`, `agent_listings[].status`) and the source for each in this run.
+5. `[preval] done pages=7` emitted? (cite the log line)
+6. PDF page count = 7 asserted? (cite the assertion result)
+7. No operator-supplied fields invented from area pattern, sister-property files, or LLM imagination? List the three most fabrication-prone operator-supplied fields (`brand.name`, `agent_listings[].status`, `subject.cover_hero`) and the source for each in this run. (`subject.narrative` and `market_summary` are agent-composed from the fan-out by design — note them as such with the data fields they're drawn from.)
+8. **Visual verification — open the rendered PDF and confirm each page.** Use the Read tool with `pages: "1-7"` against the PDF and check: (a) no content clipped at the bottom of any page (the absolutely-positioned `.doc-foot` overlays content past ~y=288mm — anything below must be footer only); (b) no remaining `<!-- REPLACE: <slot> -->` strings; (c) no KPI cells displaying "—" for fields that should be populated (especially `subject.beds`); (d) cover meta strip carries "Prepared by · <agent_name>"; (e) when `variant: "on-brand"` is set, page 1's address renders in the brand's display font (not Cormorant) — typeface drift is the variant's visual signature. Log-line success (`pages=7`) is necessary but not sufficient — page count being right does not prove each page rendered cleanly. **Skipping this check is the documented cause of two prior chart-overflow regressions; treat it as mandatory.**
 
 ## Out of scope
 

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" }
       }
     },