Initial commit: establish deterministic rod-string solver stack.

Set up the C solver core, Node API orchestration, TS GUI workflow, and engineering documentation with cleaned repo hygiene for private Git hosting.

Made-with: Cursor

references/papers/README.md

@@ -0,0 +1,19 @@
+# Paper references
+
+This repository does not store third-party paper PDFs. Keep local copies outside the repo if needed for study. Solver equations and implementation traceability are documented in `Agents/MATH_SPEC.md`.
+
+## Backbone references
+
+1. Romero, A., and Almeida, A. R. (2014). *A Numerical Sucker-Rod Pumping Analysis Tool*. SPE Artificial Lift Conference - Latin America and the Caribbean.  
+   DOI: [10.2118/169395-MS](https://doi.org/10.2118/169395-MS)
+
+2. Everitt, T. A., and Jennings, J. W. (1992). *An Improved Finite-Difference Calculation of Downhole Dynamometer Cards for Sucker-Rod Pumps*. SPE Production Engineering.  
+   DOI: [10.2118/18189-PA](https://doi.org/10.2118/18189-PA)
+
+3. Araujo, O., et al. (SPE-173970). *Three-dimensional rod-string dynamics in deviated wells* (trajectory and curvature coupling reference used by this project).  
+   Source: [SPE paper listing](https://onepetro.org/SPEATCE/proceedings-abstract/15ATCE/All-15ATCE/SPE-173970-MS/183778)
+
+4. Eisner, B., Langbauer, C., and Fruhwirth, R. (2022). *Finite-element-based diagnostics for sucker-rod pumping systems* (Newmark integration and diagnostic load-iteration basis).  
+   Source: keep your licensed copy or institutional access link.
+
+5. Lukasiewicz, H. (referenced through Eisner et al.) coupled axial/lateral formulations for deviated rod-string force balance.