{"manifestSchemaVersion":"1.0.0","datasetId":"homecostgrid.state-home-project-decision-matrix","title":"HomeCostGrid State Home Project Decision Matrix","dataVersion":"2026.08.28.1","schemaVersion":"1.1.0","publicationVersion":"2026.08.28.1","dates":{"dataReleasedAt":"2026-08-28","editorialReviewedAt":"2026-08-28","publicationUpdatedAt":"2026-08-28","sourcesLastCheckedAt":"2026-08-28"},"language":"en-US","publisher":{"name":"HomeCostGrid Editorial Desk","url":"https://homecostgrid.com/authors/homecostgrid-editorial-team"},"urls":{"canonical":"https://homecostgrid.com/research/state-project-decision-matrix","license":"https://homecostgrid.com/terms#dataset-license","methodology":"https://homecostgrid.com/methodology","reviewPolicy":"https://homecostgrid.com/review-policy"},"structure":{"jurisdictions":51,"projectFamilies":13,"decisionLenses":15,"baseProjectControls":195,"stateControlApplications":9945,"nationalQaModules":5,"totalLogicalRecords":9950,"localPriceFacts":0,"localPermitDeterminations":0,"addressLevelRiskDeterminations":0,"explanation":"The matrix applies 195 shared workflow controls to 51 jurisdictions, producing 9,945 state-labelled applications, then adds five national QA modules. These are not 9,950 independent local observations."},"stableIdentifiers":{"stateControlPattern":"^[a-z]{2}\\.[a-z0-9]+(?:-[a-z0-9]+)*\\.[a-z0-9]+(?:-[a-z0-9]+)*$","nationalModulePattern":"^national\\.[a-z0-9]+(?:-[a-z0-9]+)*$","stateControlComponents":["lowercase state code","project family ID","decision control ID"],"reusePolicy":"Never reuse or repurpose an ID. Text or source maintenance retains the ID; a changed semantic identity receives a new ID and the old ID becomes a tombstone.","tombstones":[]},"ordering":{"stateControls":["id"],"nationalModules":["id"],"sourceLedger":["url"],"collation":"Deterministic ascending UTF-16 code-unit order; current public IDs and field names are ASCII"},"schema":{"stateControlFields":["calculatorHref","category","confidence","contentHash","coverage","decisionStage","effectiveVerifiedDate","geography","id","lastVerified","limitation","nextAction","permitHref","projectFamily","projectLabel","question","replacementSourceUrl","reviewDue","sourceContentHash","sourceLabel","sourceStatus","sourceType","sourceUrl","state","stateCode","stateHref","stateSlug","updateCadence","whyItMatters"],"nationalModuleFields":["check","id","purpose","sourceLabel","sourceUrl","title","updatedAt"],"csvFields":["id","stateCode","state","stateSlug","geography","projectFamily","projectLabel","category","decisionStage","question","whyItMatters","nextAction","sourceLabel","sourceUrl","sourceType","lastVerified","reviewDue","sourceStatus","contentHash","sourceContentHash","replacementSourceUrl","effectiveVerifiedDate","updateCadence","confidence","coverage","limitation","calculatorHref","permitHref","stateHref"],"compatibility":"Schema version uses semantic versioning. Removing, renaming or changing a field's meaning requires a major version; additive fields require a minor version; non-semantic corrections to the field contract require a patch version. General page and citation documentation use publicationVersion instead."},"fingerprints":{"algorithm":"SHA-256","canonicalization":"sorted-key-json-utf8-v1; record arrays sorted by stable ID","stateControlsSha256":"sha256:c20d489b1840f8a1b9bf9415c18a9945e52993879607a66d292a33f45d14639e","nationalModulesSha256":"sha256:684978b5f5595b51db8bd28528394e4904fbc8fd4dddbb24f1d53975f60d7bda","logicalDatasetSha256":"sha256:711f4cb24c2fbd1244c9455345ca58d61c0e7b030d032d440d49cfe94899ab91","sourceLedgerSha256":"sha256:5487b7394ee74f6cd4d7a8dd0b5b7bea532f1d7c98220b8ec6ed9db45cdbb87c","stateControlsCsvSha256":"sha256:6355030046c34491fd647e41124a3c81f502073cb91f2c92bdf52c4f35db2860"},"sourceOperations":{"registeredSources":10,"referencedSources":9,"registeredSourceUrls":["https://consumer.ftc.gov/articles/how-avoid-home-improvement-scam","https://www.cpsc.gov/Recalls","https://www.energy.gov/cmei/femp/home-energy-checklist","https://www.energystar.gov/saveathome","https://www.epa.gov/lead/lead-renovation-repair-and-painting-program","https://www.fema.gov/emergency-managers/risk-management/building-science","https://www.hud.gov/helping-americans/home-improvements","https://www.irs.gov/credits-deductions/energy-efficient-home-improvement-credit","https://www.osha.gov/residential-construction","https://www.usa.gov/state-local-governments"],"referencedSourceUrls":["https://consumer.ftc.gov/articles/how-avoid-home-improvement-scam","https://www.cpsc.gov/Recalls","https://www.energy.gov/cmei/femp/home-energy-checklist","https://www.epa.gov/lead/lead-renovation-repair-and-painting-program","https://www.fema.gov/emergency-managers/risk-management/building-science","https://www.hud.gov/helping-americans/home-improvements","https://www.irs.gov/credits-deductions/energy-efficient-home-improvement-credit","https://www.osha.gov/residential-construction","https://www.usa.gov/state-local-governments"],"unreferencedRegisteredSourceUrls":["https://www.energystar.gov/saveathome"],"statusCounts":{"active":10},"changeCounts":{"stable":10},"lastCheckedAt":"2026-08-28","normalization":"semantic-html-v1 parses bounded 2xx HTML, requires one configured main/article root and two identity anchors, removes hidden or non-content elements, normalizes visible text and resolves semantic links and images. Dynamic feeds use a separately declared identity-only mode.","hashLimitation":"Approved semantic hashes are drift signals, not archived copies or proof that every source remains reachable. SHA-256 hashes of the bounded, Fetch-decoded response body are retained separately as diagnostic evidence and may change with page chrome. They are not hashes of raw on-wire bytes or response headers. Consult each linked agency directly."},"distributions":[{"id":"state-controls-csv","mediaType":"text/csv; charset=utf-8","url":"https://homecostgrid.com/api/public/project-decision-matrix?format=csv","recordTypes":["state-control"],"logicalRecordCount":9945,"headerRows":1,"bytes":13776838,"sha256":"sha256:6355030046c34491fd647e41124a3c81f502073cb91f2c92bdf52c4f35db2860","filename":"homecostgrid-project-decision-matrix-state-controls-2026.08.28.1.csv","legacyUnversionedFilename":"homecostgrid-project-decision-matrix.csv","immutableArchiveUrl":null,"limitation":"This CSV contains 9,945 state control applications, not the five national QA modules. The current URL is not an immutable historical archive; verify these bytes against the release digest."},{"id":"national-modules-json","mediaType":"application/json","url":"https://homecostgrid.com/api/public/project-decision-matrix?scope=national-modules","recordTypes":["national-qa-module"],"logicalRecordCount":5,"sha256":"sha256:684978b5f5595b51db8bd28528394e4904fbc8fd4dddbb24f1d53975f60d7bda","digestScope":"Canonical sorted-key JSON of the five nationalModules objects, not the complete HTTP response bytes.","immutableArchiveUrl":null}],"versionPolicy":{"dataVersion":"Immutable CalVer. Change it whenever a logical state-control or national-module payload changes. Publication-only work must not change it.","schemaVersion":"Semantic version for the public field-and-meaning contract, independent of record content and page publication.","publicationVersion":"CalVer for documentation, citation, indexing-policy and presentation releases. It may change while dataVersion stays fixed."},"citation":{"preferred":"HomeCostGrid Editorial Desk. (2026). HomeCostGrid State Home Project Decision Matrix (Data version 2026.08.28.1; publication version 2026.08.28.1) [Data set]. HomeCostGrid. https://homecostgrid.com/research/state-project-decision-matrix","recordTemplate":"Use the preferred citation, add the stable record ID, and name the record question. Example: HomeCostGrid Editorial Desk. (2026). “What evidence defines the roofing scope before pricing?” (Record tx.roofing.condition-scope; data version 2026.08.28.1). In HomeCostGrid State Home Project Decision Matrix [Data set]. HomeCostGrid. https://homecostgrid.com/research/state-project-decision-matrix","bibtex":"@misc{homecostgrid_state_home_project_decision_matrix,\n  author = {{HomeCostGrid Editorial Desk}},\n  title = {HomeCostGrid State Home Project Decision Matrix},\n  year = {2026},\n  version = {2026.08.28.1},\n  publisher = {HomeCostGrid},\n  url = {https://homecostgrid.com/research/state-project-decision-matrix},\n  note = {Publication version 2026.08.28.1. License: https://homecostgrid.com/terms#dataset-license}\n}","cff":"cff-version: 1.2.0\nmessage: \"If you use this dataset, cite the version shown below and cite the underlying official source for any source-specific claim.\"\ntitle: \"HomeCostGrid State Home Project Decision Matrix\"\ntype: dataset\nauthors:\n  - name: \"HomeCostGrid Editorial Desk\"\nversion: \"2026.08.28.1\"\ndate-released: \"2026-08-28\"\nurl: \"https://homecostgrid.com/research/state-project-decision-matrix\"\nlicense-url: \"https://homecostgrid.com/terms#dataset-license\"\nabstract: \"A generated decision-workflow matrix containing 9,945 state control applications and five national quality-assurance modules. It contains no local prices, permit determinations or address-level findings.\"\n","officialSourceNote":"A HomeCostGrid dataset citation identifies the derived workflow. Cite the linked official agency source separately when making a claim about that source. No DOI has been assigned."},"limitations":["This is a generated decision-workflow checklist, not 9,950 independently observed local facts.","It contains no local price, permit approval, adopted-code interpretation, contractor ranking, duration, insurance determination, tax advice or address-level finding.","The 9,945-row CSV and five national QA modules are separate distributions and must not be described as one 9,950-row CSV.","Source hashes flag possible drift; HomeCostGrid does not publish archived copies of the linked official pages.","No DOI has been assigned. Use the versioned HomeCostGrid citation and separately cite the linked official source for source-specific claims."],"releaseHistory":[{"id":"initial-unversioned","kind":"legacy-publication","releasedAt":"2026-07-30","dataVersion":null,"schemaVersion":null,"publicationVersion":null,"dataChanged":null,"schemaChanged":null,"summary":"Initial unversioned publication of the State Home Project Decision Matrix.","changes":["Published 9,945 generated state control applications and five national quality-assurance modules.","Established 51-jurisdiction, 13-project-family and 15-decision-control coverage without asserting local prices, fees or rules.","No retrospective version number is assigned to this release."]},{"id":"data-2026.08.12.1","kind":"data-release","releasedAt":"2026-08-12","dataVersion":"2026.08.12.1","schemaVersion":null,"publicationVersion":null,"dataChanged":true,"schemaChanged":null,"summary":"First formally versioned data release, adding record and official-source freshness operations while preserving the 9,950 logical-record structure.","changes":["Added lastVerified, reviewDue, sourceStatus, record contentHash, sourceContentHash and replacementSourceUrl fields to state control applications.","Added the ten-entry official-source operations ledger and machine-readable freshness summary.","Recorded the EPA Renovation, Repair and Painting replacement URL and retained HUD automation failure as unreachable rather than dead.","Did not add local prices, permit determinations or address-level findings."]},{"id":"publication-2026.08.20.1","kind":"publication-release","releasedAt":"2026-08-20","dataVersion":"2026.08.12.1","schemaVersion":"1.0.0","publicationVersion":"2026.08.20.1","dataChanged":false,"schemaChanged":true,"summary":"Introduced a reproducible release manifest, explicit version policy and citation contract without changing matrix rows or the data version.","changes":["Separated immutable data, schema and publication versions.","Defined stable record identifiers, deterministic ordering and canonical SHA-256 release fingerprints.","Documented the 9,945-row state-control CSV separately from the five national QA modules.","Added preferred, record-level, BibTeX and Citation File Format guidance with the custom HomeCostGrid dataset-license URL and no invented DOI."]},{"id":"data-2026.08.28.1","kind":"data-release","releasedAt":"2026-08-28","dataVersion":"2026.08.28.1","schemaVersion":"1.1.0","publicationVersion":"2026.08.20.1","dataChanged":true,"schemaChanged":true,"summary":"Human-reviewed the ten-source ledger, corrected two source identities and replaced whole-page hash noise with fail-closed semantic fingerprints.","changes":["Replaced the redirected DOE Energy Saver root with the live DOE Home Energy Checklist and bound the energy control to bills, serving-utility and program verification.","Replaced the generic FTC scam page with the exact official home-improvement guidance for written estimates, contracts and payment controls.","Recorded the IRS credit's current effective-date boundary without presenting an expired federal credit as available.","Added bounded 2xx-only HTML transport checks, semantic main/article fingerprints, source-identity anchors and a dynamic-feed identity mode for CPSC recalls.","Bound the intermittently blocked HUD page to its single article root after manual review, allowing semantic monitoring without treating its changing response shell as content drift.","Tightened HUD, CPSC, OSHA and FTC control wording so each official link supports the action it accompanies without implying broader agency rules."]},{"id":"publication-2026.08.28.1","kind":"publication-release","releasedAt":"2026-08-28","dataVersion":"2026.08.28.1","schemaVersion":"1.1.0","publicationVersion":"2026.08.28.1","dataChanged":false,"schemaChanged":false,"summary":"Published the reviewed source baseline and documented semantic versus response-body drift without claiming archived agency copies.","changes":["Exposed the semantic fingerprint method, content-root and identity-anchor contract in the source operations ledger.","Separated approved semantic hashes from decoded response-body hashes so page chrome and cache variation do not masquerade as source-content change.","Advanced source review dates to August 28, 2026, with the next quarterly review due November 28, 2026."]}]}