# @maintainable.xyz/house-spec

Documentation for @maintainable.xyz/house-spec

# readme.md for @maintainable.xyz/house-spec

The open specification for building maximally maintainable, healthy homes.

## What This Is

A complete, opinionated building specification for a Baufritz timber-frame house engineered around **clean-room-level indoor air quality**, **laboratory-grade water purity**, **self-hosted infrastructure**, and **lifetime maintainability**. Every system — air filtration, water treatment, heating, flooring, plumbing, datacenter — is designed so that components can be inspected, serviced, and replaced without destructive intervention.

## Specification Documents

| Spec | Scope |
|------|-------|
| [01 — Air System](specs/01-air-system-spec.md) | H13 HEPA whole-house filtration, MVHR, steam humidification, duct design, pressure management |
| [02 — Sensors & Automation](specs/02-sensor-automation-spec.md) | Per-room air quality sensors, KNX/Zigbee architecture, Home Assistant integration, demand-controlled ventilation |
| [03 — Baufritz Coordination](specs/03-baufritz-coordination-spec.md) | Technical room, duct routing, airtightness, radon protection, construction checkpoints |
| [04 — Flooring & Ceiling](specs/04-flooring-ceiling-spec.md) | Lindner NORTEC Doppelboden raised floor, WOODline parquet, Plafotherm AirHybrid radiant ceiling |
| [05 — Water System](specs/05-water-system-spec.md) | POE reverse osmosis, 316L stainless steel plumbing, ceiling-routed distribution, leak detection |
| [06 — Home Datacenter](specs/06-datacenter-spec.md) | Cellar, 4x 42U racks, closed-loop cooling, heat recovery, goods elevator, UPS, structured cabling |

## Key Design Principles

- **Whole-house H13 HEPA** — 99.95% particle capture at 0.3 um, ISO Class 7-8 equivalent
- **Every air parameter controlled** — particulates, CO2, VOCs, humidity, temperature, pressure, radon
- **Heating via ceiling** (Plafotherm AirHybrid), not floor — fast response, furniture-independent, integrates MVHR supply air
- **Raised access floor** (Lindner NORTEC Doppelboden) — individually liftable 600x600 mm panels for full access to services underneath
- **Dry construction throughout** — no wet trades, ideal for Baufritz timber-frame
- **Whole-house POE reverse osmosis** — 95-99% TDS removal, remineralized, UV-sterilized, PFAS/microplastic-free
- **316L stainless steel plumbing** — food-grade, zero leaching, press-fit, routed accessibly under suspended ceiling
- **Home datacenter in cellar** — 4x 42U racks, 10 kW closed-loop cooling, N+1 redundancy, heat recovery heats the house in winter
- **Goods elevator** — 1000 kg capacity, cellar to ground floor, handles fully loaded server racks
- **Positive pressure** (+3-5 Pa) — unfiltered air never enters the building envelope

## PDF Build

The specs can be compiled into a single styled PDF with rendered Mermaid diagrams:

```sh
pnpm install
pnpm build
# Output: dist/house-spec.pdf
```

Requires Chromium (installed automatically via Puppeteer).

## License

All rights reserved. Copyright maintainable.xyz.

# changelog.md for @maintainable.xyz/house-spec

## 2026-03-15 - 1.2.0 - feat(specs)
add whole-house water system and cellar datacenter specifications with cross-document coordination updates

- Introduce a new water system specification covering point-of-entry reverse osmosis, 316L stainless steel distribution, leak detection, monitoring, and installation sequencing.
- Introduce a new home datacenter specification for a reinforced concrete cellar with racks, cooling, UPS, elevator, structured cabling, and commissioning requirements.
- Update existing air, automation, Baufritz coordination, flooring, and README documents to integrate water treatment, plumbing access strategy, cellar infrastructure, electrical sizing, and datacenter monitoring requirements.

## 2026-03-15 - 1.1.2 - fix(repo)
no changes to commit


## 2026-03-15 - 1.1.1 - fix(package)
mark package as publishable by disabling private mode

- Change package.json private from true to false to allow publishing or external consumption of the package.

## 2026-03-15 - 1.1.0 - feat(package)
add project metadata, release configuration, and README documentation

- add npmextra release configuration for publishing metadata and registries
- expand package metadata with repository, homepage, author, keywords, and updated project description
- add pnpm build config for esbuild and puppeteer
- introduce a README describing the specification scope, design principles, and PDF build workflow

## 2026-03-08 - 1.0.0 - initial specification
Initial house specification covering HVAC, sensors, construction coordination, and finish systems.

- Defined whole-house air system with H13 HEPA filtration, MVHR, duct design, and pressure management
- Documented sensor placement, automation logic, Home Assistant integration, and wiring
- Added Baufritz builder coordination details, construction checkpoints, and project timeline
- Specified Lindner NORTEC Doppelboden with WOODline parquet and Plafotherm AirHybrid radiant ceiling
- Introduced the documentation build system using tsx, marked, and puppeteer with Mermaid-to-PDF rendering