measur-tools-suite 1.2.2-beta.0 → 1.2.2-beta.2

package/README.md

@@ -29,9 +29,9 @@ npm install measur-tools-suite
 
 ```js
 // Initialize module
-const moduleFactory = (await import('/path/to/client.js')).default;
+const moduleFactory = (await import('measur-tools-suite')).default;
 const toolsSuiteModule = await moduleFactory({
-	locateFile: (filename) => '/path/to/client.wasm'
+	locateFile: (filename) => `/path/to/${filename}`
 });
 
 // Plain function call — returns a number directly
@@ -54,7 +54,7 @@ doc.delete();
 import createModule, { type MeasurToolsSuite } from 'measur-tools-suite';
 
 const toolsSuiteModule: MeasurToolsSuite = await createModule({
-	locateFile: (filename) => '/path/to/client.wasm'
+	locateFile: (filename) => `/path/to/${filename}`
 });
 
 const doc = new toolsSuiteModule.DryerOperatingCost(1752, 50, 100, 24, 7, 52, 0.08, 0.2, 0.25);
@@ -64,6 +64,10 @@ res.delete();
 doc.delete();
 ```
 
+Package consumers should import `measur-tools-suite`, not `bin/client.js`
+directly. Deploy the package's `bin/client.wasm` with your application and use
+`locateFile` to return its public URL.
+
 ### Building from Source
 
 ```bash
@@ -72,8 +76,8 @@ cmake -S . -B build-cpp
 cmake --build build-cpp
 
 # WebAssembly build (requires Emscripten)
-emcmake cmake -DBUILD_WASM=ON
-emmake make
+emcmake cmake -S . -B build-wasm -DBUILD_WASM=ON
+emmake make -C build-wasm
 
 # Packaging
 cmake -S . -B build-pkg -DBUILD_PACKAGE=ON -DBUILD_TESTING=OFF

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "measur-tools-suite",
-  "version": "1.2.2-beta.0",
+  "version": "1.2.2-beta.2",
   "engines": {
     "node": "20.19.4",
     "npm": "10.8.2"

package/ts_def/ts_def_modules/processCooling/chillers.d.ts

@@ -4,6 +4,8 @@
  * Chiller Efficiency (Temperature Reset Capacity, Staging).
  */
 
+import type { DoubleVector } from '../binding/registered_vectors';
+
 // ---------------------------------------------------------------------------
 // Enumerations
 // ---------------------------------------------------------------------------
@@ -103,10 +105,16 @@ export interface PowerEnergyConsumptionOutput {
  * @property savingsEnergy double, units kWh
  */
 export interface StagingPowerConsumptionOutput {
-    /** Power consumption for each baseline chiller load, units kW */
-    baselinePowerList: number[];
-    /** Power consumption for each modification chiller load, units kW */
-    modPowerList: number[];
+    /**
+     * Registered WASM vector of baseline chiller power values, units kW.
+     * Call `delete()` when finished.
+     */
+    baselinePowerList: DoubleVector;
+    /**
+     * Registered WASM vector of modification chiller power values, units kW.
+     * Call `delete()` when finished.
+     */
+    modPowerList: DoubleVector;
     /** Total baseline power, units kW */
     baselineTotalPower: number;
     /** Total baseline energy, units kWh */
@@ -328,8 +336,8 @@ export function ChillerCapacityEfficiency(
  * @param operatingHours double, operating hours, units hours
  * @param waterSupplyTemp double, chilled water supply temperature, units F
  * @param waterEnteringTemp double, condenser water entering temperature, units F
- * @param baselineLoadList list of doubles for each baseline chiller load, units ton
- * @param modLoadList list of doubles for each modification chiller load, units ton
+ * @param baselineLoadList Registered WASM vector of baseline chiller loads, units ton
+ * @param modLoadList Registered WASM vector of modification chiller loads, units ton
  * @returns {@link StagingPowerConsumptionOutput}
  */
 export function ChillerStagingEfficiency(
@@ -342,8 +350,8 @@ export function ChillerStagingEfficiency(
     operatingHours: number,
     waterSupplyTemp: number,
     waterEnteringTemp: number,
-    baselineLoadList: number[],
-    modLoadList: number[]
+    baselineLoadList: DoubleVector,
+    modLoadList: DoubleVector
 ): StagingPowerConsumptionOutput;
 
 export type ChillersModule = {

package/ts_def/ts_def_modules/steamModeler/ssmt.d.ts

@@ -14,6 +14,7 @@ import type {
     Solve,
     TurbineProperty,
 } from './ssmtEnum';
+import type { InletVector } from '../binding/registered_vectors';
 
 export type { ThermodynamicQuantity, Solve, TurbineProperty };
 
@@ -564,9 +565,10 @@ export declare class Inlet {
 export declare class Header {
     /**
      * @param headerPressure Header pressure, units MPa
-     * @param inletVec Array of {@link Inlet} objects
+     * @param inletVec Registered WASM vector of {@link Inlet} objects. Call
+     * `delete()` when finished with the vector.
      */
-    constructor(headerPressure: number, inletVec: Inlet[]);
+    constructor(headerPressure: number, inletVec: InletVector);
 
     /** @returns {@link SteamPropertiesOutput} combined header steam properties */
     getHeaderProperties(): SteamPropertiesOutput;
@@ -576,8 +578,11 @@ export declare class Header {
     getInletEnergyFlow(): number;
     /** @returns Total inlet mass flow, units kg/hr */
     getInletMassFlow(): number;
-    /** @returns Array of {@link Inlet} objects */
-    getInlets(): Inlet[];
+    /**
+     * @returns Registered WASM vector of {@link Inlet} objects. Call `delete()`
+     * when finished with the vector.
+     */
+    getInlets(): InletVector;
 
     /** Frees the underlying resource; must be called when finished with the instance */
     delete(): void;

package/ts_def/ts_def_modules/wasteWater/wasteWater.d.ts

@@ -5,7 +5,7 @@
  * process outputs with and without the full iteration calculations table.
  */
 
-import { CalculationsTableV } from "../binding/registered_vectors";
+import type { CalculationsTableV, DoubleVector } from "../binding/registered_vectors";
 
 /**
  * Iteration row of intermediate wastewater-treatment calculations.
@@ -67,8 +67,11 @@ export declare class CalculationsTable {
     /** Solids retention time, units days. */
     SRT: number;
 
-    /** @returns Numeric array view of this row in model-defined order */
-    getArray(): number[];
+    /**
+     * @returns Registered WASM vector of row values in model-defined order.
+     * Call `delete()` when finished.
+     */
+    getArray(): DoubleVector;
 
     /** Frees the underlying resource; must be called when finished with the instance */
     delete(): void;

package/.agents/README.md

@@ -1,51 +0,0 @@
-# Agent Personas
-
-This directory defines repo-neutral personas for namespace refactors and algorithm documentation work. These personas are guidance for AI agents and automation tools; they are not tied to any single tool or runtime.
-
-Use this workflow when a task asks to refactor a calculation module into a namespace pattern, split a module, or write/update algorithm documentation alongside source, WebAssembly, TypeScript, or test changes.
-
-## Required Sequence
-
-Work through the personas in this order:
-
-1. [`refactor-planner`](personas/refactor-planner.md)
-2. [`cpp-namespace-refactorer`](personas/cpp-namespace-refactorer.md)
-3. [`wasm-ts-steward`](personas/wasm-ts-steward.md)
-4. [`algorithm-docs-author`](personas/algorithm-docs-author.md)
-5. [`verification-reviewer`](personas/verification-reviewer.md)
-
-Each persona must read the current handoff, perform its phase, and update the handoff before the next persona starts. Use [`templates/refactor-handoff.md`](templates/refactor-handoff.md) for the handoff.
-
-## Defaults
-
-- Preserve public API compatibility unless the user explicitly approves a breaking change.
-- If the user explicitly approves a breaking namespace/module refactor, remove obsolete compatibility wrappers and legacy runtime surfaces instead of keeping old support code in parallel.
-- Keep source, bindings, TypeScript declarations, tests, and documentation in sync.
-- Prefer established module patterns, especially the `processHeat/` namespace examples.
-- Treat `.dox` files as algorithm documentation for engineering users who need to check formulas, units, and assumptions.
-- Do not guess units or formula meaning. Inspect source, tests, docs, and downstream usage first; if still unclear, record the uncertainty in the handoff.
-
-## Handoff Rules
-
-The handoff is the shared state for the workflow. It should be short, concrete, and updated after each persona phase.
-
-Every handoff must include:
-
-- Target module and related files across C++, WebAssembly, TypeScript, tests, and docs.
-- Current public API and proposed namespace API.
-- Compatibility decision: compatible by default, intentionally breaking only with explicit approval.
-- For approved breaking changes, the old-to-new migration and removed legacy surfaces.
-- Formula and unit notes, including uncertain or unresolved items.
-- Validation commands run and remaining validation needed.
-- Open questions or blockers.
-
-## Completion Standard
-
-The workflow is complete only when the verification reviewer confirms:
-
-- The C++ API shape matches the namespace/module plan.
-- Embind names and TypeScript declarations match the runtime surface.
-- Classes, value objects, registered vectors, and enums follow `AGENTS.md` TypeScript rules.
-- C++ and WASM tests cover changed public behavior.
-- Algorithm documentation is top-down, formula-driven, and includes units and symbol tables.
-- Any public compatibility change has migration notes.

package/.agents/handoffs/compressed-air-compressor-assessment-refactor.md

@@ -1,70 +0,0 @@
-# Refactor Handoff
-
-## Target Module
-
-- Domain/path: `compressedAir/assessment`
-- Logical module: compressor assessment performance models, EEM calculations, and compressor catalog records
-- Original files: `include/compressedAir/Compressors.h`, `src/compressedAir/Compressors.cpp`, `include/compressedAir/compressors_data.h`, `bindings-wasm/compressedAir/compressorsCalc.cpp`, `ts_def/ts_def_modules/compressedAir/compressorsCalc.d.ts`, `tests/cpp/compressedAir/Compressors.unit.cpp`, `tests/wasm/compressedAir/wasm-compressorsCalc-test.js`, `tests/wasm/compressedAir/wasm-compressorCalc-reciprocatingScrew-test.js`, `tests/wasm/compressedAir/wasm-compressorCalc-helpers.js`
-- New files: `include/compressedAir/assessment/*`, `src/compressedAir/assessment/*`, `bindings-wasm/compressedAir/assessment/*`, `ts_def/ts_def_modules/compressedAir/assessment/*`, `tests/cpp/compressedAir/assessment/*`, `tests/wasm-mocha/compressedAir/assessment/*`, `docs/dox-content/calculators/compressedAir/assessment/*`
-- Nearby examples: namespace-based `compressedAir` one-off calculators and `compressedAir/leak_survey`
-
-## Current Public API
-
-- C++ symbols: global `CompressorsBase`, `Compressors_*`, `Compressor_VFD`, `CompressorEEMs`, and `CompressorsData`
-- Embind runtime names: legacy `Compressors_*`, `Compressor_VFD`, `CompressorsOutput`, `CompressorsOutputBlowOff`, `CompressorsData`, `CompressorsDataV`, and EEM function names
-- TypeScript declarations: `compressedAir/compressorsCalc.d.ts`
-- Test-visible behavior: C++ compressor unit tests plus legacy JS WASM tests
-
-## Proposed Namespace API
-
-- Namespace: `compressed_air::assessment`
-- Functions: EEM free functions under `compressor_eem`
-- Structs/value objects: compressor performance/blow-off results, EEM results, `CompressorCatalogRecord`
-- Enums: `CompressorType`, `CompressorControl`, `CompressorStage`, `CompressorLubricant`, `CompressorInputBasis`
-- Runtime names to preserve: none; this is an approved breaking cleanup
-
-## Compatibility Decision
-
-- Default: preserve public compatibility.
-- Decision: breaking cleanup approved by user.
-- Migration notes needed: old class/function/type names are removed and replaced by new assessment names.
-- User approval for breaking changes: yes.
-- Removed legacy surfaces: old C++ headers/source, old embind names, old TS `compressorsCalc`, and legacy JS WASM tests.
-
-## Touched Layers
-
-- Headers/source: split into `include/compressedAir/assessment` and `src/compressedAir/assessment`; legacy compressor headers/source removed.
-- C++ tests: split under `tests/cpp/compressedAir/assessment`; legacy monolithic test removed.
-- WebAssembly bindings: split under `bindings-wasm/compressedAir/assessment`; legacy `compressorsCalc.cpp` removed.
-- TypeScript declarations: split under `ts_def/ts_def_modules/compressedAir/assessment`; legacy `compressorsCalc.d.ts` removed; client and registered vector declarations updated.
-- WASM Mocha tests: typed tests under `tests/wasm-mocha/compressedAir/assessment`; legacy JS tests removed.
-- Algorithm docs: new `.dox` files under `docs/dox-content/calculators/compressedAir/assessment`.
-
-## Formulas And Units
-
-- Final result formula: preserve current formulas and expected numeric outputs exactly.
-- Supporting formulas: pressure/inlet correction, compressor control curves, load/unload cycle timing, VFD interpolation, EEM pressure reduction.
-- Constants: existing 1.732 three-phase conversion, 0.746 hp-to-kW conversion, pressure correction coefficients, and existing time constants.
-- Units: kW, acfm, psig, psia, hp, seconds, hours/year, $/kWh, kWh/year, dimensionless fractions.
-- Unclear or unverified items: legacy catalog comments contain some inconsistent units and should be documented according to field usage/tests.
-
-## Validation
-
-- Commands run:
-  - `cmake -S . -B build-cpp`
-  - `cmake --build build-cpp`
-  - `./build-cpp/bin/cpp_tests` passed: 4033 assertions in 301 test cases.
-  - `./node_modules/.bin/tsc --noEmit` passed.
-  - `doxygen Doxyfile` exited 0, but printed the repo's existing BibTeX failure and unrelated documentation warnings.
-  - `npm run tests` ran against stale `bin/client.*`; 230 existing tests passed and 10 new assessment tests failed because the new WASM constructors/functions were not present.
-  - `git diff --check` passed.
-- Commands still needed:
-  - Re-run `emcmake cmake -S . -B build-wasm -DBUILD_WASM=ON`.
-  - Re-run `emmake make -C build-wasm`.
-  - Re-run `npm run tests` after `bin/client.js` and `bin/client.wasm` are rebuilt.
-- Known environment limits:
-  - `emcmake`, `emmake`, and `emcc` were not installed or not on PATH in this environment, so the WASM artifact could not be rebuilt.
-
-## Open Questions Or Blockers
-
-- WASM binding compile and runtime browser tests remain blocked on Emscripten availability.

package/.agents/handoffs/compressed_air_capacity_velocity_pipe_data.md

@@ -1,199 +0,0 @@
-# Refactor Handoff
-
-## Target Module
-
-- Domain/path: `compressedAir`
-- Logical module: Coordinated refactor of `AirSystemCapacity`, `AirVelocity`, and shared `PipeData`
-- Original files:
-  - `include/compressedAir/AirSystemCapacity.h`
-  - `include/compressedAir/AirVelocity.h`
-  - `include/compressedAir/PipeData.h`
-  - `bindings-wasm/compressedAir/compressedAir.cpp`
-  - `ts_def/ts_def_modules/compressedAir/compressedAir.d.ts`
-  - `tests/cpp/compressedAir/CompressedAir.unit.cpp`
-  - `tests/wasm-mocha/compressedAir/wasm_air_system_capacity.test.ts`
-  - `tests/wasm-mocha/compressedAir/wasm_air_velocity.test.ts`
-- Current files after refactor:
-  - `include/compressedAir/pipe_data.h`
-  - `src/compressedAir/pipe_data.cpp`
-  - `include/compressedAir/air_system_capacity.h`
-  - `src/compressedAir/air_system_capacity.cpp`
-  - `include/compressedAir/air_velocity.h`
-  - `src/compressedAir/air_velocity.cpp`
-  - `bindings-wasm/compressedAir/pipe_data.cpp`
-  - `bindings-wasm/compressedAir/air_system_capacity.cpp`
-  - `bindings-wasm/compressedAir/air_velocity.cpp`
-  - `ts_def/ts_def_modules/compressedAir/pipe_data.d.ts`
-  - `ts_def/ts_def_modules/compressedAir/air_system_capacity.d.ts`
-  - `ts_def/ts_def_modules/compressedAir/air_velocity.d.ts`
-  - `ts_def/ts_def_modules/compressedAir/compressedAir.d.ts`
-  - `tests/cpp/compressedAir/pipe_data.unit.cpp`
-  - `tests/cpp/compressedAir/air_system_capacity.unit.cpp`
-  - `tests/cpp/compressedAir/air_velocity.unit.cpp`
-  - `tests/wasm-mocha/compressedAir/wasm_pipe_data.test.ts`
-  - `tests/wasm-mocha/compressedAir/wasm_air_system_capacity.test.ts`
-  - `tests/wasm-mocha/compressedAir/wasm_air_velocity.test.ts`
-- Nearby examples:
-  - `include/compressedAir/pipe_sizing.h`
-  - `src/compressedAir/pipe_sizing.cpp`
-  - `bindings-wasm/compressedAir/pipe_sizing.cpp`
-  - `ts_def/ts_def_modules/compressedAir/pipe_sizing.d.ts`
-  - `include/compressedAir/leak_survey/compressed_air_leak_survey.h`
-  - `src/compressedAir/leak_survey/compressed_air_leak_survey.cpp`
-  - `bindings-wasm/compressedAir/leak_survey/compressed_air_leak_survey.cpp`
-  - `docs/dox-content/calculators/compressedAir/pipe_sizing_calculator.dox`
-
-## Current Public API
-
-- Original C++ symbols:
-  - Global `struct PipeData`
-  - Global `class AirSystemCapacity`
-  - Nested `AirSystemCapacity::Output`
-  - Global `class AirVelocity`
-  - `AirSystemCapacity::calculate()`
-  - `AirVelocity::calculate()`
-- Original embind runtime names:
-  - `PipeData`
-  - `AirSystemCapacity`
-  - `AirSystemCapacityOutput`
-  - `AirVelocity`
-  - `calculate` instance method on `AirSystemCapacity` and `AirVelocity`
-- Original TypeScript declarations:
-  - `PipeData`, `AirSystemCapacity`, `AirSystemCapacityOutput`, and `AirVelocity` runtime classes in `compressedAir.d.ts`
-  - `CompressedAirModule` module type exposing those runtime classes
-- Test-visible behavior:
-  - `PipeData` constructor receives pipe lengths in ft and stores per-size pipe volumes in ft3.
-  - `AirSystemCapacity` receives `PipeData` plus receiver capacities in gal, returns total pipe volume, receiver volumes in ft3, total capacity in ft3, and per-size pipe volumes.
-  - `AirVelocity` receives airflow in scfm, pipe pressure in psig, and atmospheric pressure in psia, then returns velocities by pipe size in ft/s.
-
-## Proposed Namespace API
-
-- Namespace:
-  - `pipe_data`
-  - `air_system_capacity`
-  - `air_velocity`
-- Functions:
-  - `air_system_capacity::calculate(const Input&) -> Output`
-  - `air_velocity::calculate(const Input&) -> pipe_data::PipeData`
-- Structs/value objects:
-  - `pipe_data::PipeData`
-  - `air_system_capacity::Input`
-  - `air_system_capacity::Output`
-  - `air_velocity::Input`
-- Enums: none
-- Runtime names to preserve:
-  - `PipeData`
-  - `AirSystemCapacityInput`
-  - `AirSystemCapacityOutput`
-  - `AirVelocityInput`
-  - `calculateAirSystemCapacity`
-  - `calculateAirVelocity`
-
-## Compatibility Decision
-
-- Default: preserve public compatibility.
-- Decision: Intentionally breaking after user approval. Do not retain wrapper classes, legacy PascalCase headers, legacy runtime constructors, or compatibility-only tests.
-- Migration notes needed:
-  - C++ callers that included `compressedAir/AirSystemCapacity.h`, `compressedAir/AirVelocity.h`, or `compressedAir/PipeData.h` must switch to `compressedAir/air_system_capacity.h`, `compressedAir/air_velocity.h`, or `compressedAir/pipe_data.h`.
-  - C++ callers should use `air_system_capacity::calculate({pipe_lengths, receivers})` and `air_velocity::calculate({airflow, pipe_pressure, atmospheric_pressure})`.
-  - WASM/TypeScript callers should replace `new AirSystemCapacity(pipeData, receivers).calculate()` with `calculateAirSystemCapacity({ pipeLengths: pipeData, receivers })`.
-  - WASM/TypeScript callers should replace `new AirVelocity(airFlow, pipePressure, atmosphericPressure).calculate()` with `calculateAirVelocity({ airFlow, pipePressure, atmosphericPressure })`.
-  - `AirSystemCapacityOutput` is now an embind `value_object` interface rather than a runtime class. Do not call `delete()` on the output object itself; clean up nested `receiverCapacities` and `pipeLengths` runtime objects when finished.
-- User approval for breaking changes: Approved by follow-up requests to remove old implementation files and then remove legacy support methods/wrapper code altogether.
-- Removed legacy surfaces:
-  - `include/compressedAir/AirSystemCapacity.h`
-  - `include/compressedAir/AirVelocity.h`
-  - `include/compressedAir/PipeData.h`
-  - C++ wrapper classes `air_system_capacity::AirSystemCapacity` and `air_velocity::AirVelocity`
-  - Embind runtime classes `AirSystemCapacity` and `AirVelocity`
-  - Embind constructor/class binding for `AirSystemCapacityOutput`
-  - TypeScript class declarations for `AirSystemCapacity`, `AirVelocity`, and class-shaped `AirSystemCapacityOutput`
-  - Compatibility-only C++ and WASM tests for the deleted constructor-and-instance-method path
-
-## Touched Layers
-
-- Headers/source:
-  - Added `include/compressedAir/pipe_data.h`, `src/compressedAir/pipe_data.cpp`
-  - Added `include/compressedAir/air_system_capacity.h`, `src/compressedAir/air_system_capacity.cpp`
-  - Added `include/compressedAir/air_velocity.h`, `src/compressedAir/air_velocity.cpp`
-  - Removed legacy `AirSystemCapacity.h`, `AirVelocity.h`, and `PipeData.h` after user approval.
-  - Removed compatibility wrapper classes from the new snake_case modules after explicit user approval.
-  - Made `pipe_data::PipeData` default-constructible and assignable so embind value-object inputs/results can carry it.
-- C++ tests:
-  - Replaced combined `CompressedAir.unit.cpp` coverage with namespace-focused module tests:
-    - `tests/cpp/compressedAir/pipe_data.unit.cpp`
-    - `tests/cpp/compressedAir/air_system_capacity.unit.cpp`
-    - `tests/cpp/compressedAir/air_velocity.unit.cpp`
-- WebAssembly bindings:
-  - Split old `compressedAir.cpp` into one binding file each for `pipe_data`, `air_system_capacity`, and `air_velocity`.
-  - Kept `PipeData` as the shared runtime class.
-  - Replaced `AirSystemCapacity` and `AirVelocity` runtime classes with `calculateAirSystemCapacity` and `calculateAirVelocity` module functions.
-  - Replaced class-shaped `AirSystemCapacityOutput` with an embind `value_object`.
-  - Added `AirSystemCapacityInput`, `AirSystemCapacityOutput`, and `AirVelocityInput` value objects.
-- TypeScript declarations:
-  - Added one declaration file per binding surface:
-    - `ts_def/ts_def_modules/compressedAir/pipe_data.d.ts`
-    - `ts_def/ts_def_modules/compressedAir/air_system_capacity.d.ts`
-    - `ts_def/ts_def_modules/compressedAir/air_velocity.d.ts`
-  - Kept `compressedAir.d.ts` as a barrel and module type aggregator.
-  - Removed old calculator class declarations and represented value objects as interfaces.
-- WASM Mocha tests:
-  - Updated runtime tests to call `calculateAirSystemCapacity` and `calculateAirVelocity`.
-  - Added `tests/wasm-mocha/compressedAir/wasm_pipe_data.test.ts`.
-- Algorithm docs:
-  - Added `.dox` docs under `docs/dox-content/calculators/compressedAir/`.
-
-## Formulas And Units
-
-- Final result formula:
-  - Air system capacity: `V_system = V_pipe,total + V_receiver,total`, units ft3.
-  - Air velocity by pipe size: `v_i = Q * P_atm / (P_line + P_atm) * 144 / A_i / 60`, units ft/s.
-- Supporting formulas:
-  - Pipe volume by size: `V_i = L_i * c_i`, where `L_i` is pipe length in ft and `c_i` is per-foot pipe volume in ft3/ft.
-  - Total pipe volume: `V_pipe,total = sum(V_i)`, units ft3.
-  - Receiver capacity conversion: `V_receiver,j = G_j / 7.480515625`, with gallons converted to ft3.
-  - Total receiver volume: `V_receiver,total = sum(V_receiver,j)`, units ft3.
-- Constants:
-  - Receiver conversion: `7.480515625 gal/ft3` from existing implementation.
-  - Area conversion: `144 in2/ft2`.
-  - Time conversion: `60 s/min`.
-  - Pipe volume coefficients by nominal size: `0.0021`, `0.0037`, `0.006`, `0.0104`, `0.0141`, `0.0233`, `0.0333`, `0.0513`, `0.0687`, `0.0884`, `0.1389`, `0.2006`, `0.3442`, `0.5476`, `0.7763`, `0.9354`, `1.223`, `1.555`, `1.926`, `2.793` ft3/ft.
-  - Pipe internal areas by nominal size: `0.3`, `0.53`, `0.86`, `1.5`, `2.04`, `3.36`, `4.79`, `7.39`, `9.89`, `12.73`, `20`, `28.89`, `50.02`, `78.85`, `111.9`, `135.3`, `176.7`, `224`, `278`, `402.10` in2.
-- Units:
-  - Pipe lengths: ft.
-  - Stored `PipeData` values: context-specific, ft3 for capacity volume data or ft/s for velocity results.
-  - `totalPipeVolume`, `totalReceiverVolume`, and total system capacity: ft3.
-  - Receiver inputs: gal; converted receiver outputs: ft3.
-  - Airflow: scfm.
-  - Pipe pressure: psig.
-  - Atmospheric pressure: psia.
-  - Velocity results: ft/s.
-- Unclear or unverified items:
-  - Existing `PipeData` helper comment said velocity pipe area was square feet, but the formula and constants require square inches. Document as square inches.
-  - Source of pipe volume coefficients and internal area table is not cited in existing code; docs should present them as implementation tables, not external standard references.
-
-## Validation
-
-- Commands run:
-  - `cmake -S . -B build-cpp` passed after removing the legacy wrappers.
-  - `cmake --build build-cpp` passed after removing the legacy wrappers.
-  - `./build-cpp/bin/cpp_tests` passed: 4029 assertions in 296 test cases.
-  - `./node_modules/.bin/tsc --noEmit` passed after the TypeScript declaration changes.
-  - `emcmake cmake -S . -B build-wasm -DBUILD_WASM=ON` failed because `emcmake` is not installed in this shell.
-  - `npm run tests` failed with 4 compressed-air failures because the existing `bin/client.*` artifact does not expose the newly bound `calculateAirSystemCapacity` or `calculateAirVelocity` functions. The command reported 226 passing tests and 4 failing tests.
-  - `git diff --check` passed after the final edits.
-  - `rg -n "[ \t]+$" ...` over new files found no trailing whitespace.
-  - `rg -n "new moduleInstance\\.(AirSystemCapacity|AirVelocity)|moduleInstance\\.(AirSystemCapacity|AirVelocity)\\b|export declare class (AirSystemCapacity|AirVelocity)|class_<.*(AirSystemCapacity|AirVelocity)|air_system_capacity::AirSystemCapacity|air_velocity::AirVelocity" include src bindings-wasm ts_def tests AGENTS.md .agents` found no live legacy API references outside this handoff.
-- Commands still needed:
-  - Install or source Emscripten, then run `emcmake cmake -S . -B build-wasm -DBUILD_WASM=ON`.
-  - Run `emmake make -C build-wasm`.
-  - Rerun `npm run tests` after rebuilding `bin/client.js` and `bin/client.wasm`.
-- Known environment limits:
-  - WASM build requires Emscripten tools to be installed; `emcmake` is not available in this shell.
-  - `clang-format` is not available in this shell, so C++ formatting was manually reviewed instead of auto-formatted.
-  - Karma can run in this shell, but it currently exercises stale `bin/client.*` artifacts because the WASM rebuild is blocked.
-
-## Open Questions Or Blockers
-
-- No source-level blockers remain.
-- Remaining validation risk: the split embind files could not be compiled into a fresh WASM artifact here because Emscripten is unavailable.

package/.agents/personas/algorithm-docs-author.md

@@ -1,30 +0,0 @@
-# Algorithm Docs Author
-
-## Purpose
-
-Write or update engineer-facing algorithm documentation for calculations. The audience is engineering users checking formulas, units, and assumptions, not developers reading implementation details.
-
-## Inputs
-
-- Current handoff.
-- Updated C++ API, tests, and known expected results.
-- Existing `.dox` files for the target module and nearby examples.
-- `contributing/documentation.md`.
-
-## Responsibilities
-
-- Write `.dox` documentation under `docs/dox-content/` following nearby organization.
-- Use a top-down structure: final result first, then supporting formulas, factors, constants, and assumptions.
-- Use Doxygen aliases consistently: `@formula`, `@symtable`, `@symrow`, `@unitb`, and related project conventions.
-- Include symbol tables for every documented formula.
-- Keep formula labels unique and descriptive.
-- Match formula variables, units, constants, and assumptions to the implementation and tests.
-- Avoid developer-only implementation narration unless it explains engineering assumptions or formula behavior.
-- Record uncertain units, undocumented source assumptions, or missing references in the handoff instead of guessing.
-
-## Done When
-
-- The `.dox` docs let an engineering user trace the final result back through formulas and symbols.
-- Units are present for parameters, return values, constants, and formula symbols.
-- Documentation cross-references match public C++ Doxygen comments where relevant.
-- The handoff is updated for final verification.

package/.agents/personas/cpp-namespace-refactorer.md

@@ -1,30 +0,0 @@
-# C++ Namespace Refactorer
-
-## Purpose
-
-Implement the C++ portion of a namespace refactor while preserving calculation behavior and public compatibility decisions from the handoff.
-
-## Inputs
-
-- Current handoff.
-- Matching public headers and source files.
-- Relevant C++ tests and nearby namespace-pattern examples.
-- `contributing/style-guide.md` and `contributing/documentation.md`.
-
-## Responsibilities
-
-- Update headers and source before downstream bindings, declarations, or docs.
-- Place public calculation APIs in the planned namespace using path-appropriate naming.
-- Keep one `.h`/`.cpp` pair per logical module unless the handoff explicitly says otherwise.
-- Use Doxygen blocks for public files, namespaces, structs, enums, constants, and functions.
-- Preserve formulas, constants, parameter order, return values, and behavior unless the handoff explicitly identifies a behavior change.
-- Remove legacy C++ wrapper classes, headers, and compatibility-only tests when the handoff records explicit approval for a breaking refactor.
-- Update C++ unit tests to call the namespace API and cover changed public behavior.
-- Record any unresolved formula, unit, naming, or compatibility concern in the handoff.
-
-## Done When
-
-- Header and source compile conceptually with matching declarations and definitions.
-- C++ tests reflect the new namespace API.
-- Public Doxygen comments include units or explicit unitless/dimensionless status for numeric values.
-- The handoff is updated for the WebAssembly and TypeScript steward.

package/.agents/personas/refactor-planner.md

@@ -1,29 +0,0 @@
-# Refactor Planner
-
-## Purpose
-
-Plan namespace refactors and algorithm documentation work before any implementation begins. This persona maps the target module across repository layers and creates the handoff used by every later persona.
-
-## Inputs
-
-- User request and any explicit compatibility constraints.
-- `AGENTS.md`, `ARCHITECTURE.md`, `contributing/style-guide.md`, and `contributing/documentation.md`.
-- Existing source, bindings, TypeScript declarations, tests, and `.dox` docs for the target module.
-- Nearby examples in the same domain, especially namespace-based `processHeat/` modules.
-
-## Responsibilities
-
-- Identify the logical module name and target namespace.
-- List all affected files across `include/`, `src/`, `bindings-wasm/`, `ts_def/`, `tests/cpp/`, `tests/wasm-mocha/`, and `docs/dox-content/`.
-- Record the current public API, including C++ symbols, embind names, TypeScript declarations, and test-visible runtime names.
-- Propose the namespace API and classify compatibility.
-- Preserve public API compatibility by default. Mark a change as intentionally breaking only when the user explicitly approved it.
-- When a breaking change is approved, plan removal of obsolete wrappers, legacy headers, legacy runtime names, and compatibility-only tests instead of retaining shim code.
-- Identify formulas, units, source constants, example inputs, and expected outputs that documentation and tests must preserve.
-- Create or update the handoff using `templates/refactor-handoff.md`.
-
-## Done When
-
-- The handoff names the target module and all affected layers.
-- The compatibility decision is explicit.
-- The next persona can update C++ headers/source without making discovery or policy decisions.

package/.agents/personas/verification-reviewer.md

@@ -1,30 +0,0 @@
-# Verification Reviewer
-
-## Purpose
-
-Review the completed refactor and documentation as an integrated public change across C++, WebAssembly, TypeScript, tests, and algorithm docs.
-
-## Inputs
-
-- Current handoff.
-- Final diff.
-- Relevant source, binding, declaration, test, and `.dox` files.
-- Validation command output.
-
-## Responsibilities
-
-- Check that source changes match the one-module rule and planned namespace structure.
-- Verify embind runtime names match TypeScript declarations and WASM tests.
-- Check TypeScript semantics for runtime classes, value objects, registered vectors, and enums.
-- Confirm all numeric public API declarations have units or explicit unitless/dimensionless status.
-- Confirm algorithm docs are top-down and formula-driven.
-- Confirm every documented formula has a symbol table and every symbol has units.
-- Compare formulas in docs against source and tests for calculation consistency.
-- Check public API compatibility and confirm migration notes exist for approved breaking changes.
-- Recommend focused validation commands based on the changed surface, then record what passed or could not run.
-
-## Done When
-
-- The handoff has final validation notes.
-- Any remaining risk is explicit and actionable.
-- The final response can accurately state what changed and which validation commands were run.

package/.agents/personas/wasm-ts-steward.md

@@ -1,33 +0,0 @@
-# WebAssembly TypeScript Steward
-
-## Purpose
-
-Keep the WebAssembly runtime surface and TypeScript declarations synchronized with the C++ namespace refactor.
-
-## Inputs
-
-- Current handoff.
-- Updated C++ headers/source.
-- Matching `bindings-wasm/`, `ts_def/`, and `tests/wasm-mocha/` files.
-- `ts_def/README.md` and `tests/wasm-mocha/README.md`.
-
-## Responsibilities
-
-- Update or create exactly one binding file per logical module.
-- Match embind functions, classes, value objects, registered vectors, and enums to the C++ API.
-- Preserve runtime API names by default when compatibility requires it.
-- Remove legacy embind constructors, runtime names, TypeScript declarations, and WASM tests when the handoff records explicit approval for a breaking refactor.
-- Match TypeScript declarations to embind semantics:
-  - `class_<T>` becomes `export declare class` and includes `delete(): void`.
-  - `value_object<T>` becomes an `interface` and is not listed as a constructible module property.
-  - `register_vector<T>` is constructible through the module type and must be cleaned up with `delete()`.
-  - `enum_<T>` appears on the module type only when exposed at runtime.
-- Document numeric TypeScript properties, parameters, and return values with units or explicit unitless/dimensionless status.
-- Update WASM Mocha tests to import from the package entrypoint and verify runtime behavior.
-- Update the handoff with binding names, declaration changes, and validation needed.
-
-## Done When
-
-- Embind names, TypeScript declarations, and WASM tests describe the same runtime surface.
-- Public compatibility decisions from the handoff are preserved or explicitly documented.
-- The handoff is ready for algorithm documentation work.