@pdtf/schemas 3.6.0-dev.6 → 3.6.0-dev.8

package/busy-spence-79c6bf/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@pdtf/schemas",
+  "version": "3.6.0-dev.8",
+  "description": "Property Data Trust Framework Schemas and Utilities",
+  "main": "index.js",
+  "directories": {
+    "doc": "docs"
+  },
+  "scripts": {
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "extract-overlays": "cd src/utils && node extractOverlay.js",
+    "extract-extension-overlays": "cd src/utils && node extractExtensionOverlays.js",
+    "publish:dev": "npm publish --tag dev",
+    "publish:next": "npm publish --tag next",
+    "publish:latest": "npm publish --tag latest"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Property-Data-Trust-Framework/schemas.git"
+  },
+  "keywords": [
+    "PDTF",
+    "Schemas"
+  ],
+  "author": "",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Property-Data-Trust-Framework/schemas/issues"
+  },
+  "homepage": "https://github.com/Property-Data-Trust-Framework/schemas#readme",
+  "dependencies": {
+    "@jdw/jst": "^2.0.0-beta.15",
+    "ajv": "^8.12.0",
+    "ajv-formats": "^2.1.1",
+    "deepmerge": "^4.3.1",
+    "gpt-3-encoder": "^1.1.4",
+    "jsonpointer": "^5.0.0",
+    "traverse": "^0.6.7"
+  },
+  "devDependencies": {
+    "jest": "^27.5.1"
+  }
+}

package/busy-spence-79c6bf/scripts/ta6ed6-titles.js

@@ -0,0 +1,403 @@
+// One-off tooling: apply exact TA6 6th-edition field titles (ta6ed6Title) to
+// src/schemas/v3/combined.json.
+//
+// Source of truth: the Law Society "TA6 Property Information Form (6th edition)
+// (2025)" — text extracted with pdftotext (see tmp/TA6 Form 6th edition.pdf).
+//
+// LABELS is keyed by "<ta6ed6Ref>::<last path segment>" and holds the VERBATIM
+// form label. normalize() applies the house style (see mapping-report §C.5):
+//   - strip leading sub-question markers "(a) ", "(i) " ...
+//   - strip leading conditional prefixes "If yes, " / "If no, "
+//   - collapse whitespace, capitalise first letter.
+// A ta6ed6Title is written only where the normalised form label DIFFERS from the
+// property's existing base `title` (per the agreed scope). Collisions on a key
+// (same field repeated across oneOf branches) intentionally share one label.
+
+const LABELS = {
+  // ---- Section 1: Property and seller details ----
+  "1.4::sellersCapacity": "What is your role in the sale?",
+  "1.5::dateBecameOwnerOrAuthority":
+    "When did you become the owner of, or get authority to sell, the property? (DD/MM/YYYY)",
+  "1.1::address": "Address of the property",
+  "1.2::uprn": "UPRN (if known)",
+
+  // ---- Section 2: Boundaries ----
+  "2::legalBoundaries": "Boundaries",
+  "2.1::uniformBoundaries":
+    "Looking towards the property from the road, who owns or accepts responsibility to maintain or repair the boundary features:",
+  "2.1a::left": "On the left?",
+  "2.1b::right": "On the right?",
+  "2.1c::rear": "At the rear?",
+  "2.1d::front": "At the front?",
+  "2.2.1::details":
+    "If the boundaries of the property are irregular, indicate ownership by written description or by reference to a plan:",
+  "2.3.2::details": "If yes, please give details:",
+  "2.4.2::details": "If yes, please give details:",
+  "2.5::partyWallAct":
+    "Are you aware of any notice being served or received under the Party Wall etc. Act 1996 in respect of any shared/party walls or boundaries?",
+  "2.5.2::details": "If yes, supply a copy and give details of any works carried out or agreed:",
+
+  // ---- Section 3: Disputes ----
+  "3::disputesAndComplaints": "Disputes",
+  "3.1.2::details": "If yes, give details such as when this took place and who was involved:",
+  "3.2.2::details": "If yes, please give details:",
+
+  // ---- Section 4: Notices ----
+  "4.1::otherNotices":
+    "Are you aware of any notices, communications, negotiations or discussions which affect the property or a property nearby? For example, from or to a neighbour, council or government department.",
+  "4.1.2::details": "If yes, please give details:",
+  "4.2::neighbourDevelopment":
+    "Are you aware of any plans or proposals to develop property or land nearby?",
+  "4.2.2::details": "If yes, please give details:",
+  "4.3::planningApplication":
+    "Are you aware of any proposals to make alterations to or change the use of buildings nearby?",
+  "4.3.2::details": "If yes, please give details:",
+
+  // ---- Section 5: Alterations ----
+  "5::alterationsAndChanges": "Alterations",
+  // 5.1 alteration type checkboxes (a)-(i)
+  "5.1a::windowReplacementsSince2002":
+    "Replacement windows, roof windows, roof lights, glazed doors since 1 April 2002",
+  "5.1c::hasAddedConservatory": "Conservatory",
+  "5.1g::removalOfChimneyBreast": "Removal of chimney breast",
+  // 5.3 non-residential use
+  "5.3::nonResidentialPurposes":
+    "Is any part of the property used exclusively for non-residential purposes?",
+  "5.3.2::details": "If yes, give details and supply a copy of any relevant planning permission:",
+  // 5.4 breaches
+  "5.4::planningPermissionBreaches":
+    "Are you aware of any breaches of planning permission conditions or building regulations consent conditions, unfinished work or work that does not have all necessary consents?",
+  "5.4.2::details": "If yes, please give details:",
+  // 5.5 unresolved issues
+  "5.5::unresolvedPlanningIssues":
+    "Are you aware of any planning or building control issues that need to be resolved?",
+  "5.5.2::details": "If yes, please give details:",
+  // 5.6 solar power systems
+  "5.6::solarPanels":
+    "Has a solar power system for generating electricity, hot water or heating been installed at the property?",
+  "5.6a::hotWaterOnly":
+    "Is the system used only to provide hot water or heating and not to generate electricity?",
+  "5.6b::yearInstalled": "Which year was the system installed? (YYYY)",
+  "5.6c::panelsOwnedOutright": "Do you own the system outright?",
+  "5.6d::panelProviderLease":
+    "Has a long lease of the roof or air space been granted to a solar power system provider? A typical long lease may last 20 to 25 years.",
+  "5.6e::maintenanceAgreement": "Do you have a maintenance agreement in place for the system?",
+  "5.6f::photovoltaicBatteries": "Is there a battery for storing solar power?",
+  "5.6f2::details":
+    "If yes, provide the make, model and storage capacity in kWh of the battery:",
+  "5.6g::nationalGrid": "Does the system feed into the National Grid?",
+  "5.6g1::fitOrSegInPlace":
+    "Is there a Feed-in Tariff (FIT) or Smart Export Guarantee (SEG) in place?",
+  "5.6g4::fitSegAssignmentProcedure":
+    "Provide details of the procedure for assigning the benefit of the FIT or SEG agreement on completion of the purchase to the buyer.",
+  "5.6h::installationCertificates":
+    "Provide a copy of the building regulations completion certificate or compliance certificate (e.g. MCS) for the installation of the system.",
+
+  // ---- Section 6: Guarantees and warranties ----
+  "6::guaranteesWarrantiesAndIndemnityInsurances": "Guarantees and warranties",
+  "6.1::hasValidGuaranteesOrWarranties":
+    "Does the property have any of the following unexpired guarantees or warranties?",
+  "6.1a::newHomeWarranty": "New home warranty (e.g. NHBC or similar)",
+  "6.1b::dampProofingTreatment": "Damp proofing",
+  "6.1c::timberRotOrInfestationTreatment": "Timber treatment",
+  "6.1d::doubleGlazing": "Windows, roof lights, roof windows or glazed doors",
+  "6.1e::roofingWork": "Roofing",
+  "6.1g::subsidenceWork": "Underpinning",
+  "6.1i::otherGuarantees": "Other (please state):",
+  "6.1i2::details": "If yes, please give details:",
+  "6.2::outstandingClaimsOrApplications":
+    "Are you aware of any claims under any of these guarantees or warranties?",
+  "6.2.2::details": "If yes, please give details:",
+  "6.3::breachOfTermsOrConditions":
+    "Are you aware of anything that may breach the terms and conditions of any of these guarantees or warranties?",
+  "6.3.2::details": "If yes, please give details:",
+
+  // ---- Section 7: Insurance ----
+  "7::insurance": "Insurance",
+  "7.1.1::whoInsures": "If no, who insures the property?",
+
+  // ---- Section 8: Environmental matters ----
+  "8::environmentalIssues": "Environmental matters",
+  "8::flooding": "Flooding",
+  "8.1.1::hasBeenFlooded": "Are you aware of the property or any part of it ever being flooded?",
+  "8.2.1::hasFloodDefences":
+    "Are you aware of any defences installed at the property to prevent flooding?",
+  "8.3::radon": "Radon",
+  "8.3::radonTest": "Are you aware of any radon tests that have been carried out on the property?",
+  "8.3.1a::details": "Was the test result below the 'recommended action level'?",
+  "8.3.1b::attachments": "Supply a copy of the report",
+  "8.4::remedialMeasuresOnConstruction":
+    "Were any remedial measures undertaken to reduce radon gas levels in the property? Measures could have been undertaken during construction or while adding an extension.",
+  "8.5::greenDealLoan": "Green Deal",
+  "8.5.1::hasGreenDealLoan":
+    "Have any installations in the property been financed under the Green Deal scheme?",
+  "8.5.1b::details":
+    "If yes, give details of all installations and supply a copy of your last electricity bill:",
+  "8.6::japaneseKnotweed": "Japanese knotweed",
+  "8.6.1::yesNo": "Is the property affected by Japanese knotweed?",
+  "8.6.2::managementPlanInPlace":
+    "Is there a Japanese knotweed management and treatment plan in place?",
+  "8.6.3::attachments": "Provide a copy of the plan with any insurance cover linked to the plan.",
+  "8.7::knotweedSurveyCarriedOut":
+    "Has a Japanese knotweed survey been carried out in relation to the property?",
+  "8.7.2::attachments": "Provide a copy of the survey.",
+
+  // ---- Section 9: Rights and informal arrangements ----
+  "9::rightsAndInformalArrangements": "Rights and informal arrangements",
+  "9.4::rightsOrArrangements":
+    "Do the owners of any other properties exercise any rights or arrangements over the property?",
+  "9.5::askedOthersToContribute":
+    "Have you asked the owner of any other properties to contribute towards the cost of the jointly used facilities?",
+  "9.5.2::details":
+    "If yes, specify whether you receive this payment or if it is made to a third party. Include details about how much is paid and how often payments are made:",
+  "9.6::disagreementOrComplaint":
+    "Are you aware of any disagreement or complaint about any such right or arrangement?",
+  "9.6.2::details": "If yes, please give details:",
+  "9::servicesCrossing": "Facilities crossing the property or any other property",
+  "9.7.2::details": "If yes, please give details:",
+  "9.8.2::details": "If yes, please give details:",
+  "9.9.2::details": "If yes, supply a copy or give details:",
+
+  // ---- Section 10: Parking ----
+  "10::parking": "Parking",
+  "10.1::parkingArrangements": "What are the parking arrangements at the property?",
+  "10.3::electricVehicleChargingPoint":
+    "Does the property have an electric vehicle (EV) charging point?",
+  "10.3a::chargerDetails":
+    "Specify the type of EV charger, connector and its location and provide building regulation approvals:",
+  "10.3b::cableCrossesPavement": "Does an EV charging cable have to cross the public pavement?",
+  "10.3b2::details": "If yes, specify any relevant local authority licence or terms and conditions:",
+
+  // ---- Section 11: Services ----
+  "11::electricalWorks": "Electrical systems",
+  "11.1::electricalWorkSince2005":
+    "Are you aware of any electrical installation works carried out at the property?",
+  "11.1::details": "If yes, give details including when this work took place:",
+  // (11.2 "Does the property have any certificates..." is the suppliedCertificate
+  // object, already titled among the pre-existing set. yearWorkCarriedOut is an
+  // overlay-only year field with no distinct form label — left as base.)
+  "11.3::testedByQualifiedElectrician":
+    "Does the property have an Electrical Installation Condition Report (EICR)?",
+  "11.4::heating": "Heating systems",
+  "11.4.1::heatingType": "How is the property heated? Tick all that apply:",
+  "11.4a::centralHeatingInstalled":
+    "When was the heating system installed? (DD/MM/YYYY)",
+  "11.4c::replacementOtherThanBoiler":
+    "Has there been any replacement to the heating system (other than replacement of a boiler)?",
+  "11.4b2::boilerInstallationDate":
+    "If there is a boiler (of any kind) when was it installed? (DD/MM/YYYY)",
+  "11.4g1::heatingLastServicedDate":
+    "In what year was the boiler and heating system last serviced or maintained?",
+  "11.4g2::heatingLastServicedReport": "Please supply a copy of any service report.",
+  "11.5a::mainsFoulDrainage": "Foul water drainage?",
+  "11.5b::mainsSurfaceWaterDrainage": "Surface water drainage?",
+  "11.7a::dateDischargeCommenced": "When did the discharge commence? (MM/YYYY)",
+  "11.7b::dateInstalled": "When was the system installed? (MM/YYYY)",
+  "11.7c::dateReplaced": "When was the sewerage system last replaced or upgraded? (MM/YYYY)",
+  "11.7d::dateLastEmptied": "If a cesspool, when was the container last emptied? (MM/YYYY)",
+  "11.7e::dateLastServiced":
+    "If the property is served by a sewage treatment plant, when was the treatment plant last serviced? (MM/YYYY)",
+  "11.7g::hasInfiltrationSystem":
+    "If the sewerage system discharges to the ground, does it have an infiltration system?",
+  "11.7h::otherConnectedProperties":
+    "Is the use of the sewerage system shared with other properties?",
+  "11.7i::plantOnOtherLand":
+    "Is any part of the sewerage system, or the access to it, outside the boundary of the property?",
+  "11.7i::attachments":
+    "If yes, supply a plan showing the location of the system and how access is obtained.",
+  // waterAndDrainage parent container spans form 11.5-11.7 + 12.3 — no single form
+  // label; the `drainage` child already carries "Drains and sewers".
+
+  // ---- Section 12: Connection to services ----
+  "12::connectivity": "Connection to services",
+  // electricity / water are broad containers (electricity also holds solar etc.);
+  // the form labels the service line, which is the mainsElectricity / mainsWater child.
+  "12.1.2::supplier": "Provider's name",
+  "12.1.3::location": "Location of meter",
+  "12.1.4::mpan": "MPAN number",
+  "12.2.3::location": "Location of meter",
+  "12.2.4::mprn": "MPRN number",
+  "12.3.2::supplier": "Provider's name",
+  "12.3.3::stopcock": "Location of stopcock",
+  "12.3.3::location": "Location of stopcock",
+  "12.3.4::location": "Location of meter (if any)",
+  "12.5.2::supplier": "Provider's name",
+  "12.5.3::makeModel": "Make/model",
+  "12.5.4::serviceProviderName": "Service provider's name",
+  "12.6.3::makeModel": "Make/model",
+  "12.6.4::serviceProviderName": "Service provider's name",
+  "12.7::telephone": "Telephone",
+  "12.7.2::supplier": "Provider's name",
+  "12.8::broadband": "Broadband",
+  "12.8.2::providerName": "Provider's name",
+  "12.9.1::otherServices": "If there are any other services, please give details:",
+
+  // ---- Section 13: Transaction information ----
+  "13::occupiers": "Occupiers",
+  "13.1::otherPropertyInChain":
+    "Does this sale depend on you completing the purchase of another property on the same day?",
+  "13.2::moveRestrictionDates": "Do you have any special requirements about a moving date?",
+  "13.2.2::details": "If yes, please give details:",
+  "13.4::hasOthersAged17OrOver": "Does anyone else, aged 17 or over, live at the property?",
+  "13.4b::aged17OrOverTenantsOrLodgers":
+    "Are any of those occupiers who are aged 17 or over your tenants or lodgers?",
+  "13.5.1::soldWithVacantPossession":
+    "Is the property being sold with vacant possession (empty of all occupiers, rubbish and any contents or fittings not included in the sale)?",
+  // Form 13.6 is one question; the schema splits it into two booleans. Bind the form
+  // text to the "sign to confirm will vacate" property; leave aged17OrOverAgreedToLeave.
+  "13.6b::aged17OrOverWillSignToConfirmWillVacate":
+    "Have all occupiers aged 17 or over agreed to sign the sale contract and to vacate the property on or before completion?",
+  "13.7b::attachments":
+    "If the property is not being sold with vacant possession, provide details of all occupiers and copies of their tenancy agreements.",
+
+  // ---- Section 14: Completion ----
+  "14::completionAndMoving": "Completion",
+
+  // ---- Section 15: Additional information ----
+  "15::additionalInformation": "Additional information about your answers",
+  "15.1::consents":
+    "Please supply copies of all consents that have been given under any covenants, estate management schemes or other restrictions affecting the title to the property for all actions you have disclosed in your answers to questions 5 (Alterations), 8.5 (Green Deal), 10.3 (EV charging points) and 11 (Services).",
+  "15.1.2::consentsAttached": "Consents attached:",
+  "15.1.3::consentsToFollow": "Consents to follow:",
+  "15.1.4::consentsNotAvailable": "List any consents that are not available:",
+  "15.2::furtherInformation":
+    "If there is any further information about any of your answers on this form, provide details below and/or supply additional documents.",
+};
+
+function normalize(s) {
+  let t = String(s).replace(/\s+/g, " ").trim();
+  t = t.replace(/^\([a-z0-9]+\)\s*/i, ""); // (a) (i) ...
+  t = t.replace(/^if\s+(yes|no),?\s*/i, ""); // If yes, / If no,
+  t = t.replace(/\s*:\s*$/, ""); // omit trailing colon (house style)
+  if (t.length) t = t[0].toUpperCase() + t.slice(1);
+  return t;
+}
+
+// Compare key for "differs from base?" — trailing colon/space ignored so a
+// colon-only difference does not trigger an override.
+function cmpKey(s) {
+  return String(s).replace(/\s*:\s*$/, "").trim();
+}
+
+function toJsoncPath(dotted) {
+  return dotted.split(".").map((seg) => {
+    const m = seg.match(/^\[(\d+)\]$/);
+    return m ? Number(m[1]) : seg;
+  });
+}
+
+// Pre-existing ta6ed6Title values that violate the house style (un-stripped
+// "(a)" / "If yes," prefixes). Exact string replacements applied after inserts.
+const FIXUPS = [
+  [
+    "(a) state the full names of any occupiers (other than the sellers) aged 17 or over:",
+    "State the full names of any occupiers (other than the sellers) aged 17 or over:",
+  ],
+  ["If yes, what type of flooding took place?", "What type of flooding took place?"],
+];
+
+// Apply ta6ed6Title insertions to a combined.json text, returning {text, applied}.
+function applyTitles(text) {
+  const jsonc = require("jsonc-parser");
+  const rows = require("/tmp/ta6ed6_worksheet.json");
+  const opts = { formattingOptions: { insertSpaces: true, tabSize: 2 } };
+  let applied = 0;
+  for (const r of rows) {
+    if (r.ed6) continue; // don't touch the pre-existing 51 here
+    const seg = r.path.split(".").pop().replace(/^\[\d+\]$/, "IDX");
+    const key = r.ref + "::" + seg;
+    if (!(key in LABELS)) continue;
+    const want = normalize(LABELS[key]);
+    if (want === cmpKey(r.title)) continue; // identical to base (colon ignored) — skip
+    const objPath = toJsoncPath(r.path);
+    const insertOpts = {
+      ...opts,
+      getInsertionIndex: (props) => {
+        const i = props.indexOf("title");
+        if (i >= 0) return i + 1;
+        const j = props.indexOf("ta6ed6Ref");
+        return j >= 0 ? j + 1 : props.length;
+      },
+    };
+    const edits = jsonc.modify(text, [...objPath, "ta6ed6Title"], want, insertOpts);
+    text = jsonc.applyEdits(text, edits);
+    applied++;
+  }
+  let fixed = 0;
+  for (const [from, to] of FIXUPS) {
+    const needle = `"ta6ed6Title": ${JSON.stringify(from)}`;
+    const repl = `"ta6ed6Title": ${JSON.stringify(to)}`;
+    if (text.includes(needle)) {
+      text = text.split(needle).join(repl);
+      fixed++;
+    }
+  }
+  // House style: ta6ed6Title sits immediately after title, so overrides are
+  // obvious. New inserts already do; reposition any pre-existing that don't.
+  const moved = reorderTitles();
+  function reorderTitles() {
+    const tree = JSON.parse(text);
+    const targets = [];
+    (function walk(node, path) {
+      if (!node || typeof node !== "object") return;
+      if (!Array.isArray(node) && "ta6ed6Title" in node && "title" in node) {
+        const keys = Object.keys(node);
+        if (keys.indexOf("ta6ed6Title") !== keys.indexOf("title") + 1) {
+          targets.push({ path, value: node.ta6ed6Title });
+        }
+      }
+      for (const k of Object.keys(node)) walk(node[k], path.concat(Array.isArray(node) ? Number(k) : k));
+    })(tree, []);
+    for (const { path, value } of targets) {
+      text = jsonc.applyEdits(text, jsonc.modify(text, [...path, "ta6ed6Title"], undefined, opts));
+      text = jsonc.applyEdits(
+        text,
+        jsonc.modify(text, [...path, "ta6ed6Title"], value, {
+          ...opts,
+          getInsertionIndex: (props) => props.indexOf("title") + 1,
+        })
+      );
+    }
+    return targets.length;
+  }
+
+  // House style: strip a trailing colon from every ta6ed6Title (new + pre-existing).
+  let colons = 0;
+  text = text.replace(/("ta6ed6Title": "(?:[^"\\]|\\.)*?)\s*:(")/g, (_, a, b) => {
+    colons++;
+    return a + b;
+  });
+  return { text, applied, fixed, colons, moved };
+}
+
+module.exports = { LABELS, normalize, applyTitles, toJsoncPath };
+
+if (require.main === module) {
+  // Dry-run report: show what WOULD change.
+  const rows = require("/tmp/ta6ed6_worksheet.json");
+  let add = 0,
+    same = 0,
+    missing = [];
+  for (const r of rows) {
+    if (r.ed6) continue;
+    const seg = r.path.split(".").pop().replace(/^\[\d+\]$/, "IDX");
+    const key = r.ref + "::" + seg;
+    if (!(key in LABELS)) continue;
+    const want = normalize(LABELS[key]);
+    if (want === cmpKey(r.title)) {
+      same++;
+    } else {
+      add++;
+      console.log(`ADD  ${r.ref.padEnd(10)} ${seg.padEnd(28)} :: ${want}`);
+    }
+  }
+  // labels defined but not matched to any candidate path
+  const matchedKeys = new Set();
+  for (const r of rows) {
+    const seg = r.path.split(".").pop().replace(/^\[\d+\]$/, "IDX");
+    matchedKeys.add(r.ref + "::" + seg);
+  }
+  for (const k of Object.keys(LABELS)) if (!matchedKeys.has(k)) missing.push(k);
+  console.log(`\n${add} to add, ${same} already match base title.`);
+  if (missing.length) console.log(`\nLABELS keys with NO matching property (check!):\n  ` + missing.join("\n  "));
+}

package/busy-spence-79c6bf/scripts/ta7ed5-titles.js

@@ -0,0 +1,183 @@
+// One-off tooling: apply exact TA7 5th-edition field titles (ta7ed5Title) to
+// src/schemas/v3/combined.json.
+//
+// Source of truth: the Law Society "TA7 Leasehold Information Form (5th edition)
+// (2025)" — text extracted with pdftotext (TA7-5th-edition.pdf, 9 pages).
+//
+// LABELS is keyed by "<ta7ed5Ref>::<last path segment>" and holds the VERBATIM
+// form label. normalize() applies the house style: strip leading "(a)"/"(i)" and
+// "If yes,"/"If no," prefixes, omit trailing colon, collapse whitespace,
+// capitalise first letter. A ta7ed5Title is written only where the normalised
+// form label DIFFERS from the base `title` (colon ignored). Every ta7ed5Title is
+// placed immediately after `title`; a global pass strips trailing colons from the
+// pre-existing titles too. Curly apostrophes match the form.
+
+const LABELS = {
+  // ---- Section 1: Property and seller details ----
+  "1.1::address": "Address of the property",
+  "1.1.3::uprn": "UPRN (if known)",
+
+  // ---- Section 2: The lease (2.2 payment demands — sub-item names) ----
+  "2.2a::mostRecentGroundRentDemandStatus": "Ground rent",
+  "2.2b::mostRecentServiceChargeDemandStatus": "Service charge",
+  "2.2c::mostRecentBuildingsInsuranceDemandStatus": "Buildings insurance",
+
+  // ---- Section 3: Contact details ----
+  "3::contactDetails": "Contact details",
+  "3.1.2::managementCompany": "Management company",
+  // per-contact field labels: Name / Email
+  "3.1.1.1::nameOrOrganisation": "Name",
+  "3.1.2.1::nameOrOrganisation": "Name",
+  "3.1.3.1::nameOrOrganisation": "Name",
+  "3.1.4.1::nameOrOrganisation": "Name",
+  "3.1.5.1::nameOrOrganisation": "Name",
+  "3.1.1.3::emailAddress": "Email",
+  "3.1.2.3::emailAddress": "Email",
+  "3.1.3.3::emailAddress": "Email",
+  "3.1.4.3::emailAddress": "Email",
+  "3.1.5.3::emailAddress": "Email",
+
+  // ---- Section 4: Management ----
+  "4.1.2.1::nameOrOrganisation": "Name",
+  "4.1.2.3::emailAddress": "Email",
+  "4.2::collectsbuildingInsurancePremiums":
+    "Does the managing agent arrange or collect charges for the insurance of the building?",
+  "4.3::collectsGroundRent": "If ground rent is payable, is it collected by the managing agent?",
+  "4.4.1::yesNo":
+    "Does the seller alone, or jointly with others, own the freehold, any headlease or a management company named in the lease?",
+  "4.4.2::attachments":
+    "If yes, supply evidence of your ownership or share certificate for membership of the organisation that is responsible for the management of the building.",
+
+  // ---- Section 5: Maintenance and service charges ----
+  "5.1::externally": "In what year was the outside of the building last decorated?",
+  "5.2::internally": "In what year were any internal communal parts last decorated?",
+  "5.3::sellerContributesToServiceCharge": "Do you contribute to the cost of maintaining the building?",
+  "5.4::largeAdditionalExpense":
+    "Do you know of any expense (e.g. the cost of redecoration of outside or communal areas that is not usually incurred annually) that is likely to be shown in the service charge accounts within the next three years?",
+  "5.4.2::details": "If yes, please give details:",
+  "5.5::serviceChargeChallenged":
+    "Have you challenged the service charge or any expense in the last three years?",
+  "5.6::problemInServiceChargeLevel":
+    "Do you know of any issues in the last three years regarding the level of service charges or with the management?",
+
+  // ---- Section 7: Enfranchisement ----
+  "7.3::sellerAwareOfResponse":
+    "Are you aware of any response to a notice disclosed in replies to 7.1 and 7.2 above?",
+
+  // ---- Section 8: Consents ----
+  "8.1::changesInTermOfLease": "Are you aware of any changes to the terms of the lease?",
+  "8.2::landlordConsents":
+    "Are you aware of the landlord giving any formal or informal consents required by the lease?",
+  "8.2.2::details":
+    "If yes, please supply the consent or if the consent was not in writing, please give details:",
+
+  // ---- Section 9: Alterations ----
+  "9.1::sellerAwareOfAlterations":
+    "Are you aware of any alterations having been made to the property since the lease was originally granted?",
+
+  // ---- Section 10: Complaints ----
+  "10::disputes": "Complaints",
+
+  // ---- Section 11: Building safety for blocks of flats ----
+  "11::buildingSafetyAct": "Building safety for blocks of flats",
+};
+
+function normalize(s) {
+  let t = String(s).replace(/\s+/g, " ").trim();
+  t = t.replace(/^\([a-z0-9]+\)\s*/i, ""); // (a) (i) ...
+  t = t.replace(/^if\s+(yes|no),?\s*/i, ""); // If yes, / If no,
+  t = t.replace(/\s*:\s*$/, ""); // omit trailing colon (house style)
+  if (t.length) t = t[0].toUpperCase() + t.slice(1);
+  return t;
+}
+
+function cmpKey(s) {
+  return String(s).replace(/\s*:\s*$/, "").trim();
+}
+
+function toJsoncPath(dotted) {
+  return dotted.split(".").map((seg) => {
+    const m = seg.match(/^\[(\d+)\]$/);
+    return m ? Number(m[1]) : seg;
+  });
+}
+
+function applyTitles(text) {
+  const jsonc = require("jsonc-parser");
+  const rows = require("/tmp/ta7ed5_worksheet.json");
+  const opts = { formattingOptions: { insertSpaces: true, tabSize: 2 } };
+  let applied = 0;
+  for (const r of rows) {
+    if (r.ed5) continue; // don't re-insert pre-existing
+    const seg = r.path.split(".").pop().replace(/^\[\d+\]$/, "IDX");
+    const key = r.ref + "::" + seg;
+    if (!(key in LABELS)) continue;
+    const want = normalize(LABELS[key]);
+    if (want === cmpKey(r.title)) continue; // colon-only / identical — skip
+    const objPath = toJsoncPath(r.path);
+    const edits = jsonc.modify(text, [...objPath, "ta7ed5Title"], want, {
+      ...opts,
+      getInsertionIndex: (props) => {
+        const i = props.indexOf("title");
+        if (i >= 0) return i + 1;
+        const j = props.indexOf("ta7ed5Ref");
+        return j >= 0 ? j + 1 : props.length;
+      },
+    });
+    text = jsonc.applyEdits(text, edits);
+    applied++;
+  }
+  // House style: ta7ed5Title immediately after title — reposition pre-existing.
+  const tree = JSON.parse(text);
+  const targets = [];
+  (function walk(node, path) {
+    if (!node || typeof node !== "object") return;
+    if (!Array.isArray(node) && "ta7ed5Title" in node && "title" in node) {
+      const keys = Object.keys(node);
+      if (keys.indexOf("ta7ed5Title") !== keys.indexOf("title") + 1) targets.push({ path, value: node.ta7ed5Title });
+    }
+    for (const k of Object.keys(node)) walk(node[k], path.concat(Array.isArray(node) ? Number(k) : k));
+  })(tree, []);
+  for (const { path, value } of targets) {
+    text = jsonc.applyEdits(text, jsonc.modify(text, [...path, "ta7ed5Title"], undefined, opts));
+    text = jsonc.applyEdits(
+      text,
+      jsonc.modify(text, [...path, "ta7ed5Title"], value, {
+        ...opts,
+        getInsertionIndex: (props) => props.indexOf("title") + 1,
+      })
+    );
+  }
+  const moved = targets.length;
+  // House style: strip a trailing colon from every ta7ed5Title (new + pre-existing).
+  let colons = 0;
+  text = text.replace(/("ta7ed5Title": "(?:[^"\\]|\\.)*?)\s*:(")/g, (_, a, b) => {
+    colons++;
+    return a + b;
+  });
+  return { text, applied, moved, colons };
+}
+
+module.exports = { LABELS, normalize, cmpKey, applyTitles, toJsoncPath };
+
+if (require.main === module) {
+  const rows = require("/tmp/ta7ed5_worksheet.json");
+  let add = 0,
+    same = 0;
+  const matched = new Set();
+  for (const r of rows) matched.add(r.ref + "::" + r.path.split(".").pop().replace(/^\[\d+\]$/, "IDX"));
+  for (const r of rows) {
+    if (r.ed5) continue;
+    const key = r.ref + "::" + r.path.split(".").pop().replace(/^\[\d+\]$/, "IDX");
+    if (!(key in LABELS)) continue;
+    const want = normalize(LABELS[key]);
+    if (want === cmpKey(r.title)) same++;
+    else {
+      add++;
+      console.log(`ADD  ${r.ref.padEnd(9)} ${key.split("::")[1].padEnd(34)} :: ${want}`);
+    }
+  }
+  const orphans = Object.keys(LABELS).filter((k) => !matched.has(k));
+  console.log(`\n${add} to add, ${same} already match base title.`);
+  if (orphans.length) console.log(`\nLABELS with NO matching property (check!):\n  ` + orphans.join("\n  "));
+}

package/busy-spence-79c6bf/src/examples/v1/exampleAddParticipantVouch.json

@@ -0,0 +1,32 @@
+{
+  "verification": {
+    "trust_framework": "uk_pdtf",
+    "time": "2022-01-25T13:05:03.108Z",
+    "evidence": [
+      {
+        "type": "vouch",
+        "attestation": {
+          "type": "digital_attestation",
+          "voucher": {
+            "name": "Martin Abode"
+          }
+        },
+        "verification_method": {
+          "type": "auth"
+        }
+      }
+    ]
+  },
+  "claims": {
+    "/participants/-": {
+      "name": {
+        "firstName": "Martin",
+        "lastName": "Abode"
+      },
+      "email": "martin@abode.co.uk",
+      "organisation": "Abode and Floggit Estate Agents",
+      "organisationReference": "MAR/12243/22",
+      "role": "Estate Agent"
+    }
+  }
+}