RCA-Spec v2.0 10-Section Evidentiary Report Standard & Hard Linter Rules
RCA-Spec v2.0 absorbs classical ISA (TRAQ, CODIT), ASCA (7-part evidentiary report structure), and Claus Mattheck (t/R hollow-shell buckling, AS 4970 SRZ) rigor into open ECMAScript code while inverting the valuation polarity from tree liquidation to living holobiont equity.
The Five Mandatory Diagnostic Domains & 10-Section Compiled Report
rca_assessment.schema.json)
structural_baseline: Biometrics (dbh_cm, height, crown spread,plus_code_global),isa_traq_riskmatrix,municipal_permit_disposition, ShigoCODITwall response, and Matthecksound_shell_thickness_ratio_t_over_r.rhizosphere_and_root_collar: Root flare diameter (DRF), burial depth, stem-girdling root (SGR) count and severity,airspade_radial_trenching_geometry, andCRZ/SRZ/TIZradii.soil_and_microbiome_baseline: Dry bulk density (g/cm3), steady-state infiltration (mm/hr), organic matter (%), soil pH, andmycorrhizal_and_fungal_observations(F:Bratio, guild, iNaturalist fungal taxa).understory_and_guild_prescription: SER reference ecosystem, engine-scaled biochar (L), humate (kg), fungal compost (m3), ramial woodchip mulch (m3), synthetic NPK/fungicide exclusion check, and native companion species guild (open_nursery_batch_id).outcome_monitoring_schedule: Explicitstim_hypothesis_statement,stim_kill_criterion, 12-month leading indicators, and 60-month lagging indicators with 5-dimension Sanctuary Scorecard targets.
compileRcaEvidentiaryMarkdown)
- Executive Disposition & Biometric Baseline (with canonical
SHA-256cryptographic digest) - Classical Biomechanics: Mattheck Shell-Wall Physics & Shigo CODIT
- Municipal Ordinance & Statutory Compliance (exact code citations & mitigation liability)
- Subterranean Rhizosphere & Pneumatic Root-Collar Forensics (150 psi AirSpade trench volume)
- Soil Physics & Mycorrhizal Microbiome Baseline
- Nodal Biological Amendment & Native Companion Guild Prescription
- Dual Asset Valuation: CTLA 10th Ed. vs. 200-Year Holobiont Biological Equity
- 5-Year Practice Economics: Regenerative Stewardship vs. One-Time Liquidation
- STIM Longitudinal Monitoring Schedule & Sanctuary Scorecard Targets
- Vector Root-Zone Protection Site Map (
SVG) & Evidentiary Verification Summary
Hard Evidentiary Linter Gates (lintRcaEvidentiaryReport)
| Linter Rule Code | Trigger Condition | Enforcement Action & Rationale |
|---|---|---|
MISSING_DOMAIN |
Any of the 5 mandatory RCA domains is absent or non-object | Blocks compilation and Open Badge minting until all 5 above-ground and subterranean domains are populated. |
INVALID_BIOMETRICS / INVALID_GEO_LOCATION |
dbh_cm ≤ 0 or missing plus_code_global |
Requires positive metric DBH and a valid 10-to-15 character Open Location Code (Plus Code). |
UNJUSTIFIED_REMOVAL |
Disposition is Removal_Last_Resort_Unmitigable_Hazard while t/R ≥ 0.30 |
Hard Preservation Gate: Under Mattheck (1994), a hollow shell with t/R ≥ 0.30 retains full hollow-cylinder bending strength. Removal is blocked when rhizosphere remediation and crown reduction can mitigate risk. |
EVIDENTIARY_DEFECT |
Removal recommended without sonic_tomography_or_resistograph_uri |
Requires acoustic tomogram (PiCUS / Arbotom) or micro-drilling resistograph evidence before condemning a mature or protected tree. |
OAK_WILT_VIOLATION |
Structural_Risk_Reduction_Pruning during active seasonal_oak_wilt_restriction_active |
Blocks non-emergency pruning of Quercus hosts during prohibited Ceratocystis fagacearum nitidulid beetle vector months. |
INCOMPLETE_SOIL_DATA |
Missing bulk_density_g_cm3, organic_matter_pct, or infiltration_rate_mm_hr |
Requires quantitative soil physical baseline prior to certifying a regenerative rhizosphere prescription. |
Mathematical & Primary Literature Foundations
Every number emitted by Open Arbor traces to a published standard or primary scientific paper. Zero opaque heuristics or unverified LLM approximations are permitted in the core calculation kernel.
| Domain & Module | Equation & Deterministic Formula | Primary Literature / Statutory Standard |
|---|---|---|
Critical Root Zone (CRZ) & International TPZsrc/core/rootZone.js |
R_CRZ (ft) = max(min_radius_ft, DBH_in × multiplier)AS 4970 TPZ: R_m = clamp(DBH_m × 12, 2.0, 15.0)BS 5837 RPA: R_m = min(DBH_m × 12, 15.0)
|
ANSI A300 (Part 5: Management of Trees and Shrubs During Site Planning, Site Development, and Construction); ISA Best Management Practices; Australian Standard AS 4970-2009; UK BS 5837:2012. |
Structural Root Zone (SRZ)src/core/rootZone.js |
R_SRZ (m) = max(1.5, (D_flare_m × 50)^0.42 × 0.64)(If basal flare D_flare is unmeasured, estimated as 1.2 × DBH)
|
Claus Mattheck & Helge Breloer (1994), The Body Language of Trees: A Handbook for Failure Analysis; codified in Australian Standard AS 4970-2009 § 3.3.5. |
Multi-Stem DBH Aggregation & 1-ft Grid Unionsrc/core/rootZone.js |
Quadratic: sqrt(sum(d_i^2))Largest + Half: d_max + 0.5 × sum(d_other)Union Area: 1-ft Cartesian raster grid de-duplicating overlapping CRZ circles
|
ISA / CTLA Guide for Plant Appraisal (10th Ed.) quadratic mean stem area rule; Austin ECM § 3.5 / Georgetown UDC Ch. 8 / Liberty Hill UDC § 6.07.01 municipal multi-trunk rules. |
Hollow-Shell Buckling Stability (t/R)src/core/rcaEngine.js |
t/R = t_sound_shell_cm / R_trunk_radius_cmStable criterion: t/R ≥ 0.30 (retains full hollow-cylinder bending resistance)
|
Mattheck, C., Bethge, K., & Erb, D. (1993/1994), failure criteria for hollow tree trunks under bending and Brazier ovalization; Shigo, A. L. (1977) CODIT Walls 1 to 4. |
Pneumatic Rhizosphere & Amendment Scalingsrc/core/rcaEngine.js |
V_trench = N_spokes × L_m × W_m × D_mV_basin = π × R_rce^2 × D_burial_mBiochar = 8% V_total; Compost = 15% V_total; Humate = 1.5 kg/m3; Mulch = 8 cm × A_TIZ
|
ANSI A300 Part 2 (Soil Management: Modification, Fertilization, and Drainage); ISA BMP Soil Management for Urban Trees; RCA-Spec v2.0 Domain 2 & Domain 4 prescriptions. |
Allometric Carbon, Stormwater, Air & Coolingsrc/core/ecosystemBenefits.js |
AGB_kg = exp(-2.0773 + 2.3323 × ln(DBH_cm))Total_Biomass = AGB × 1.28 (root shoot ratio) × 0.8 (urban open-grown factor)Carbon_kg = 0.50 × Total_Biomass; CO2_eq = 3.6667 × Carbon
|
Nowak, D. J. (1994) urban forest carbon storage; Cairns et al. (1997) root-to-shoot biomass allocation; Xiao et al. (2000) rainfall interception; Nowak et al. (2006) dry deposition air pollution removal; McPherson & Simpson (1999) shade cooling calibrated to ~80 kWh/tree baseline. |
Veteran Tree Age Estimationsrc/core/ecosystemBenefits.js |
Age_yrs = DBH_cm × (Base_Growth_Factor × Site_Modifier)(Modifiers: Open Grown 0.85x, Urban Street 1.10x, Woodland 1.15x)
|
John White (1998), Estimating the Age of Large and Veteran Trees in Britain, UK Forestry Commission Information Note FCIN12, calibrated with North American species growth factors. |
Dual Valuation: Holobiont Equity vs. CTLA 10th Ed.src/core/rcaEngine.js |
CTLA = (π/4 × DBH_in^2 × $75) × f_cond × f_locHolobiont = (E_carbon_200yr + E_hydrology_50yr + E_CMN_soil) × M_habitat(Keystone multiplier M_habitat: 1.2x up to 3.5x for veteran hollow trees)
|
Council of Tree and Landscape Appraisers (CTLA) Guide for Plant Appraisal (10th Ed., 2018) Trunk Formula Technique vs. RCA-Spec v2.0 Holobiont Biological Equity model (STIM Axiom 7). |
200-Year Data Sovereignty & Heartwood Vault Architecture (2026 to 2226)
A Live Oak, Pecan, or Oregon White Oak preserved today will stand in 2226. Over those two centuries, every proprietary cloud SaaS database and binary lock-in format will vanish. Open Arbor enforces 200-Year Data Sovereignty (docs/13_STRATEGIC_SPEC_2031_SOVEREIGN_ARCHITECTURE.md, STIM Protocol v7.0011) through the Four-Namespace Botanical Directory Contract and the Heartwood/Cambium Dual-File Pattern.
SEEDS/
Immutable Evidence
Write-once primary evidence: official municipal ordinance PDFs with .sha256 sidecars, raw GPR radargrams (.dzt), LiDAR point clouds (.copc.laz), increment cores, and wild mother-tree germplasm manifests.
ARBORETUM/
Living Dossiers
Active cultivated projects, property Tree Preservation Plans, dual-file tree dossiers (Heartwood .md + Cambium .jsonld/.geojson), and open-nursery propagation batches.
UNDERSTORY/
Deterministic Kernel
Zero-dependency ECMAScript core modules (rootZone.js, ordinanceEngine.js, ecosystemBenefits.js, rcaEngine.js, leoRcaEngine.js, soilFunction.js), Draft 2020-12 JSON Schemas, and the 41-tool forestry workbench catalog.
HEARTWOOD/
Bioregional Law
Watershed-scale growth and fire syntheses (Open-FVS, LANDIS-II, FlamMap), bioregional Oak Wilt epidemiology fronts, and Equinox/Solstice archival digests.
Cambium = compile(Heartwood, SEEDS)): Every tree assessment is saved as human-readable UTF-8 Markdown (the Heartwood file, legible in 2226 with any plain-text reader) paired with its deterministic machine-executable Cambium companion (RCA_v2 JSON, OGC CRS84 GeoJSON, to-scale SVG protection map, and OpenBadgeCredential JSON-LD). Every artifact is sealed with a canonical sorted-key SHA-256 digest via computeCanonicalSha256.
Interactive JSON Schema (Draft 2020-12) Inspector
Inspect the property definitions, required constraints, units, and enumerations for Open Arbor's canonical schemas, or download the raw .schema.json files directly.
| JSONPath Property | Type & Constraints | Required | Specification Description & Unit |
|---|