diff --git a/6-Documentation/famm/SEMANTIC_MASS_ROUTE_PLOW_RUNNER.md b/6-Documentation/famm/SEMANTIC_MASS_ROUTE_PLOW_RUNNER.md new file mode 100644 index 00000000..5e44bd68 --- /dev/null +++ b/6-Documentation/famm/SEMANTIC_MASS_ROUTE_PLOW_RUNNER.md @@ -0,0 +1,55 @@ +# FAMM Semantic Mass Route Plow Runner + +## Purpose + +This runner is the implementation step after the Semantic Mass Z-Domain Accelerator. + +It accepts semantic-mass lanes, optional CFD-style residual streams, route candidates, and optional Hessian receipts. It emits a ranked route receipt. + +## Pipeline + +```text +semantic mass lanes +→ weighted mass stream μ[k] +→ AR/Z-domain recurrence +→ pole/ROC diagnosis +→ route ranking by mass × invariant overlap × scar penalty +→ residual seal / closure recommendation +→ receipt +``` + +## Command + +```bash +python3 5-Applications/tools-scripts/famm/semantic_mass_route_plow.py \ + --config shared-data/examples/famm_semantic_mass_route_plow_config.example.json \ + --out shared-data/semantic-mass-plow/example_receipt.json +``` + +## Route equation + +```math +P(i\to j) +\propto +\exp[-\alpha d_{ij}-\beta\Omega_{ij}+\gamma I_{ij}-\eta C_{ij}+m\mu_j] +``` + +## CFD usage + +Feed solver lanes such as: + +```text +u_norm +v_norm +pressure_norm +vorticity_norm +divergence_residual +pde_residual +boundary_residual +``` + +The runner does not solve Navier-Stokes. It ranks which solver route or boundary closure step deserves compute next. + +## No-drift boundary + +This is a computational routing witness. It accelerates the math forest. It does not replace exact proof, numerical validation, or PDE solver correctness checks.