{
  "schemaVersion": 1,
  "slug": "house-cleaning-cost-calculator",
  "category": "cleaning",
  "kind": "implementation",
  "independentValidation": false,
  "implementationHash": "60405b5b588ad9c9b582e537b454cdddf75414f5690bb375d0c0680524b4715a",
  "provenance": "Generated from the calculation contract used by the published page. Publication is not external validation.",
  "sourceFiles": [
    "data/calculators/house-cleaning-cost-calculator.json",
    "src/engine.js"
  ],
  "runtimeSource": "/sources/engine.txt",
  "runtimeHash": "5c888d8898afbdee36267bb9977829e1e2ac568f6677c8ee87469c139864645c",
  "scope": "The compute function records implemented equations, constants, lookup tables and custom rules. Inputs record defaults and allowed values; outputs record precision and units. Defaults are examples, not recommendations. General background references are not evidence for this specific algorithm.",
  "publishedFormula": {
    "formula": "C = min(A × r + Br × sb + Ba × sa, H × w) × m",
    "vars": [
      [
        "A",
        "home area (sq ft)"
      ],
      [
        "r",
        "rate per sq ft (USD)"
      ],
      [
        "Br",
        "bedrooms"
      ],
      [
        "sb",
        "editable bedroom surcharge (USD)"
      ],
      [
        "Ba",
        "bathrooms"
      ],
      [
        "sa",
        "editable bathroom surcharge (USD)"
      ],
      [
        "H",
        "hours per visit"
      ],
      [
        "w",
        "hourly rate (USD)"
      ],
      [
        "m",
        "frequency scenario factor"
      ]
    ],
    "note": "Frequency factor m: weekly 0.85, every two weeks 0.92, monthly 1.00, one-time 1.15. These are user-editable-model assumptions, not market averages. Visits per year: 52/26/12/1."
  },
  "externalEvidence": null,
  "contract": {
    "compute": "const areaCost=area*ratePerSqFt+bedrooms*bedroomSurcharge+bathrooms*bathroomSurcharge; const hourCost=hoursPerVisit*hourlyRate; const freqMult=frequency==='weekly'?0.85:frequency==='biweekly'?0.92:frequency==='monthly'?1:1.15; const perVisit=Math.min(areaCost,hourCost)*freqMult; const visits=frequency==='weekly'?52:frequency==='biweekly'?26:frequency==='monthly'?12:1; const recommendation=Math.abs(areaCost-hourCost)<0.005?'The two base estimates are about equal':areaCost<hourCost?'The square foot quote is cheaper':'The hourly quote is cheaper'; return {perVisit,perVisitByHour:hourCost*freqMult,perMonth:perVisit*visits/12,perYear:perVisit*visits,visitsPerYear:visits,costPerSqFt:area>0?perVisit/area:0,recommendation};",
    "inputs": [
      {
        "name": "area",
        "type": "number",
        "default": 1800,
        "min": 100,
        "max": 50000,
        "step": 50,
        "slider": true
      },
      {
        "name": "bedrooms",
        "type": "number",
        "default": 3,
        "min": 0,
        "max": 20,
        "step": 1,
        "slider": true
      },
      {
        "name": "bedroomSurcharge",
        "type": "number",
        "default": 12,
        "min": 0,
        "max": 500,
        "step": 1,
        "slider": true,
        "advanced": true
      },
      {
        "name": "bathrooms",
        "type": "number",
        "default": 2,
        "min": 0,
        "max": 20,
        "step": 1,
        "slider": true
      },
      {
        "name": "bathroomSurcharge",
        "type": "number",
        "default": 25,
        "min": 0,
        "max": 500,
        "step": 1,
        "slider": true,
        "advanced": true
      },
      {
        "name": "frequency",
        "type": "select",
        "default": "biweekly",
        "options": [
          {
            "value": "weekly"
          },
          {
            "value": "biweekly"
          },
          {
            "value": "monthly"
          },
          {
            "value": "onetime"
          }
        ]
      },
      {
        "name": "ratePerSqFt",
        "type": "number",
        "default": 0.11,
        "min": 0,
        "max": 10,
        "step": 0.005,
        "slider": true,
        "advanced": true
      },
      {
        "name": "hourlyRate",
        "type": "number",
        "default": 45,
        "min": 0,
        "max": 500,
        "step": 1,
        "slider": true,
        "advanced": true
      },
      {
        "name": "hoursPerVisit",
        "type": "number",
        "default": 3,
        "min": 0.5,
        "max": 20,
        "step": 0.5,
        "slider": true,
        "advanced": true
      }
    ],
    "outputs": [
      {
        "name": "perVisit",
        "precision": 2,
        "unit": "$"
      },
      {
        "name": "perVisitByHour",
        "precision": 2,
        "unit": "$"
      },
      {
        "name": "perMonth",
        "precision": 2,
        "unit": "$"
      },
      {
        "name": "perYear",
        "precision": 2,
        "unit": "$"
      },
      {
        "name": "visitsPerYear",
        "precision": 0,
        "unit": ""
      },
      {
        "name": "costPerSqFt",
        "precision": 4,
        "unit": "$"
      },
      {
        "name": "recommendation",
        "precision": 0,
        "unit": "",
        "type": "text"
      }
    ],
    "interpret": null
  }
}
