SyncValsverifier → artifact → classifier → verdict
SyncVals · Trajectory

truss2d-solver

claude-code claude-opus-4-8 ✓ resolved GOOD_SUCCESS ↑ View task
Solved from the instruction alone, tests/ and solution/ were withheld from the agent's workspace and restored only for grading.
Reward = tests/test.sh exit code (0 → resolved); the classification below is post-hoc and cannot change it.
Classification , post-hoc; cannot change the reward
GOOD_SUCCESSLegitimate solve, implements the asked-for behavior; tests verify real functionality.
SubtypeLegitimate Solution - Hard Problem
EvidenceAgent implemented all four required solver functions (element_stiffness_global, assemble_system, prestrain_force, solve) in C++. Test results show 100% pass rate: '1/6 Test #1: test_core ... Passed', '2/6 Test #2: test_unilateral ... Passed', '3/6 Test #3: test_geometric ... Passed', '4/6 Test #4: test_soak ... Passed', '5/6 Test #5: test_degenerate ... Passed', '6/6 Test #6: test_settlement ... Passed'. Agent's final summary demonstrates deep domain understanding: 'initial-stress (geometric) consistency' iteration, 'cables drop out under compression, struts under tension', correct sign conventions for prestrain/thermal strain, spring settlement reactions. All implementations align with instruction requirements for handling unilateral members, installed strain, finite spring supports, and small-displacement initial-stress effects.
Root causeAgent successfully understood and implemented a complex structural mechanics solver with coupled nonlinearities (initial-stress effects and active-set logic), passing comprehensive hidden test suite covering core behavior, unilateral member handling, geometric effects, degenerate cases, and spring settlement scenarios.
RecommendationN/A - task is fine
Trajectory
Tool-by-tool agent trajectory
19 tool calls · 3 tool types · 32 steps
# Ticket: Implement the static solver for the `truss2d` network engine ## Context `truss2d` is a compact C++17 structural-analysis engine for planar networks of two-force members on elastic spring supports. The framework around the numerical core is already implemented: the data model and validation, dense linear algebra, text parser, report writer, demo CLI, and a smoke test. The static solver itself is intentionally stubbed. It returns zero-valued results, so the engine does not carry load or satisfy equilibrium. The project is at **`/opt/truss2d`** in the build image. ## Your Task Implement the four member functions in **`/opt/truss2d/src/solver.cpp`** (declared in `include/truss2d/solver.hpp`): - `DenseMatrix StaticSolver::element_stiffness_global(std::size_t e) const` - `DenseMatrix StaticSolver::assemble_system(const std::vector<bool>& active) const` - `std::vector<double> StaticSolver::prestrain_force(const std::vector<bool>& active) const` - `SolveResult StaticSolver::solve() const` Do not change public headers or signatures. You should only need to edit `src/solver.cpp`, using the existing `Model`, `DenseMatrix`, and `solve_spd` support code. This is not just a classical pin-jointed linear truss. The solver must handle unilateral members, installed strain, thermal strain, finite spring supports, and the small-displacement initial-stress effect of taut members. ## Governing Model Each node has two translational degrees of freedom, `x` then `y`. Each element connects two nodes and acts as a two-force member in its own axis. The solver uses small-displacement kinematics: axial extension is the first-order change of end separation projected onto the member axis. ### Member Response Each member has a linear-elastic axial response based on its material, area, and undeformed length. The `kind` controls which signs of total axial force it may carry: - `Bar`: carries either tension or compression and always participates. - `Cable`: tension-only. If the consistent state would place it in compression, it goes slack and contributes no stiffness or installed load. - `Strut`: compression-only. If the consistent state would place it in tension, it separates and contributes no stiffness or installed load. The sign convention for `SolveResult::axial_forces` is positive in tension and negative in compression. Dropped unilateral members must report exactly zero force and zero utilization. ### Installed Strain `Element::prestrain` is a mechanical lack-of-fit strain. `Element::alpha` and `Element::dT` describe a thermal strain contribution. Combine the mechanical and thermal installed strains consistently to first order before computing the installed axial force. A member manufactured too long for its joints pushes its ends apart and is initially compressive. A member manufactured too short pulls its ends together and is initially tensile. The same physical convention applies to thermal expansion and contraction. ### Initial-Stress Stiffness An active member carrying axial force also changes the tangent stiffness for relative motion transverse to its axis. Tension stiffens the transverse mode; compression softens it. This initial-stress contribution: - uses the member's current total axial force, not just the installed component; - acts only for participating members; - does not alter the recovered axial force itself; - vanishes for rigid translation of both ends and for relative motion along the member axis. The transverse stiffness of a taut member depends on the force it carries, and the force depends on the displacement. A single linear solve made from an arbitrary assumed member force is not, by itself, an equilibrium. Find the state in which the assumed member forces, the displacements they produce, and the forces recovered from those displacements all coincide. The graded models are well posed and have a unique consistent state. The matrix helpers report the ordinary elastic behavior only: the single-member helper reports one member's ordinary elastic stiffness, and the assembly helper adds the ordinary elastic stiffness of participating members together with the spring-support stiffness. The force-dependent transverse effect belongs only to the equilibrium solved by `solve()`, not to those helper outputs. ### Spring Supports There are no exact fixed supports. Each support is a grounded linear spring at a node along a unit direction stored by the model. It resists only the displacement component along that direction and produces no reaction perpendicular to it. Two nonparallel springs on one node act like a two-dimensional elastic support; one spring is a skew roller with finite compliance. The support reaction reported by `solve()` is the force applied by the spring to the structure, so it opposes the spring extension. A spring support may also **settle**: its grounded end is held at a prescribed offset (the `settlement` value, measured along the spring's direction). The spring then stores its stretch RELATIVE to that offset , i.e. the elongation is the node's displacement along the direction minus the prescribed offset , so a nonzero settlement loads the structure even with no applied forces, and the reaction depends on that relative stretch. A settlement of zero is an ordinary grounded spring. ### Equilibrium And Active Set At convergence, every node is in static equilibrium under applied loads, support reactions, the axial forces of active members, and the transverse initial-stress forces implied by those active members. The active set and the displacement field must agree with the unilateral rules above. A cable or strut is judged by its total axial force after installed strain and elastic extension are both included. If a governing system is singular or not positive definite, let the exception from the provided linear solver propagate. `solve()` must call `Model::validate()` before assembling the analysis. ## Outputs `SolveResult` must populate: - `displacements`: one value per global DOF. - `reactions`: one value per global DOF, zero for unsupported DOFs. - `axial_forces`: one value per element, positive in tension. - `utilization`: one signed value per element. Use an allowable stress of `2.5e8 Pa`; capacity scales with area. Inactive unilateral members report zero. - `active`: one flag per element. All vectors must have the lengths implied by the model. ## Build And Test ```bash cmake -S /opt/truss2d -B /opt/truss2d/build -DCMAKE_BUILD_TYPE=Release cmake --build /opt/truss2d/build --parallel cd /opt/truss2d/build && ctest --output-on-failure ``` The shipped test is only a smoke test. The grader restores a clean project snapshot, copies in your `src/solver.cpp`, and runs a hidden correctness suite against independent analytic and numerical references.
I'll start by exploring the project structure and understanding the existing code.

/opt/truss2d/src/solver.cpp

contents
1	#include "truss2d/solver.hpp"
2	
3	#include <cstddef>
4	#include <stdexcept>
5	#include <vector>
6	
7	#include "truss2d/dense_matrix.hpp"
8	#include "truss2d/types.hpp"
9	
10	namespace truss2d {
11	
12	// ============================================================================
13	// TODO(candidate): Implement the static solver for the cable/strut/bar network
14	// described in instruction.md.
15	//
16	// The four member functions below are stubs that currently return zero-valued
17	// results, so the analysis is physically wrong and the test suite FAILS.
18	// Replace the stub bodies with correct implementations. Do NOT change the
19	// public signatures declared in include/truss2d/solver.hpp, and reuse the
20	// existing support layer (DenseMatrix, solve_spd, and the Model helpers
21	// element_length / element_direction).
22	//
23	// Read instruction.md for the governing model, output conventions, and
24	// sign/units conventions. This file is the ONLY file you need to edit.
25	// ============================================================================
26	
27	DenseMatrix StaticSolver::element_stiffness_global(std::size_t e) const {
28	    // TODO(candidate): single-member elastic 4x4 stiffness in the global frame.
29	    (void)e;
30	    return DenseMatrix(4, 4); // all zeros -> wrong
31	}
32	
33	DenseMatrix StaticSolver::assemble_system(const std::vector<bool>& active) const {
34	    // TODO(candidate): assemble active-member elastic stiffness + spring terms.
35	    (void)active;
36	    const std::size_t n = model_.num_dofs();
37	    return DenseMatrix(n, n); // all zeros -> wrong
38	}
39	
40	std::vector<double>
41	StaticSolver::prestrain_force(const std::vector<bool>& active) const {
42	    // TODO(candidate): nodal force from member prestrain for this active set.
43	    (void)active;
44	    const std::size_t n = model_.num_dofs();
45	    return std::vector<double>(n, 0.0); // all zeros -> wrong
46	}
47	
48	SolveResult StaticSolver::solve() const {
49	    // TODO(candidate): validate, resolve the active set, solve, recover
50	    // displacements / reactions / axial forces / active flags.
51	    const std::size_t n = model_.num_dofs();
52	    const std::size_t ne = model_.num_elements();
53	    SolveResult result;
54	    result.displacements.assign(n, 0.0);
55	    result.reactions.assign(n, 0.0);
56	    result.axial_forces.assign(ne, 0.0);
57	    result.utilization.assign(ne, 0.0);
58	    result.active.assign(ne, true);
59	    return result; // trivially zero -> wrong
60	}
61	
62	} // namespace truss2d
63

/opt/truss2d/include/truss2d/solver.hpp

contents
1	#ifndef TRUSS2D_SOLVER_HPP
2	#define TRUSS2D_SOLVER_HPP
3	
4	#include <cstddef>
5	#include <vector>
6	
7	#include "truss2d/dense_matrix.hpp"
8	#include "truss2d/model.hpp"
9	
10	namespace truss2d {
11	
12	/// Result of a static analysis of a cable/strut/bar network.
13	struct SolveResult {
14	    /// Nodal displacements, length == model.num_dofs(), ordered by global DOF
15	    /// (2*node + component).
16	    std::vector<double> displacements;
17	
18	    /// Support reaction forces at every global DOF, length == model.num_dofs().
19	    /// Non-zero only at DOFs of nodes carrying a spring support.
20	    std::vector<double> reactions;
21	
22	    /// Internal axial force per element, length == model.num_elements().
23	    /// Sign convention: positive = tension, negative = compression. A member
24	    /// that has dropped out of the load path (a slack cable / a separated
25	    /// strut) reports exactly 0.
26	    std::vector<double> axial_forces;
27	
28	    /// Signed utilization per element, length == model.num_elements(). Inactive
29	    /// unilateral members report 0.
30	    std::vector<double> utilization;
31	
32	    /// Whether each member participates in the converged load path, length ==
33	    /// model.num_elements(). A Bar is always active; a Cable is inactive when
34	    /// slack; a Strut is inactive when separated.
35	    std::vector<bool> active;
36	};
37	
38	/// Static solver for a 2D network of two-force members (bars, cables, struts)
39	/// on spring supports, with member prestrain.
40	///
41	/// The headline departures from a classical linear pin-jointed truss are
42	/// documented in the analysis contract (instruction.md); this header only
43	/// fixes the public surface. The helpers below expose the ordinary elastic
44	/// pieces used by callers and tests.
45	class StaticSolver {
46	public:
47	    explicit StaticSolver(const Model& model) : model_(model) {}
48	
49	    /// Run the full analysis. Calls Model::validate() first and propagates any
50	    /// exception it throws. Throws std::runtime_error if the governing system
51	    /// is singular (e.g. a mechanism / under-supported network).
52	    SolveResult solve() const;
53	
54	    /// The 4x4 single-member elastic stiffness contribution for element `e`
55	    /// expressed in the global frame, local DOF order {n1.x, n1.y, n2.x, n2.y}.
56	    /// This is the elastic part only (it does NOT encode kind, prestrain, or
57	    /// supports). Exposed for testing/reuse.
58	    DenseMatrix element_stiffness_global(std::size_t e) const;
59	
60	    /// Assemble the full governing stiffness matrix (num_dofs x num_dofs) for a
61	    /// GIVEN set of participating members `active` (length num_elements()):
62	    /// the sum of the elastic stiffness of every active member plus every
63	    /// spring-support contribution. Inactive members contribute nothing.
64	    /// Exposed so the equilibrium residual can be checked directly.
65	    DenseMatrix assemble_system(const std::vector<bool>& active) const;
66	
67	    /// The global nodal force vector (length num_dofs()) produced by member
68	    /// prestrain for a GIVEN active set, i.e. the prestrain contribution to the
69	    /// right-hand side of the governing system. Inactive members contribute
70	    /// nothing. Exposed so the equilibrium residual can be checked directly.
71	    std::vector<double> prestrain_force(const std::vector<bool>& active) const;
72	
73	private:
74	    const Model& model_;
75	};
76	
77	} // namespace truss2d
78	
79	#endif // TRUSS2D_SOLVER_HPP
80
Let me explore the supporting code.

/opt/truss2d/include/truss2d/types.hpp

contents
1	#ifndef TRUSS2D_TYPES_HPP
2	#define TRUSS2D_TYPES_HPP
3	
4	#include <array>
5	#include <cstddef>
6	
7	namespace truss2d {
8	
9	/// A point / vector in the 2D plane.
10	struct Vec2 {
11	    double x{0.0};
12	    double y{0.0};
13	};
14	
15	/// A structural node with a planar position. Each node owns two
16	/// translational degrees of freedom (DOFs): x then y.
17	struct Node {
18	    Vec2 position{};
19	};
20	
21	/// Linear-elastic axial material + section properties for a bar element.
22	/// `E` is Young's modulus [Pa], `A` is the cross-sectional area [m^2].
23	struct Section {
24	    double E{0.0};
25	    double A{0.0};
26	};
27	
28	/// Force-transmission character of a member.
29	///
30	///   Bar    - a two-force member that resists BOTH tension and compression
31	///            (the classical bidirectional pin-jointed bar).
32	///   Cable  - a slack-capable member that resists tension ONLY; it carries no
33	///            force and contributes no stiffness when it would otherwise be in
34	///            compression.
35	///   Strut  - a contact-only member that resists compression ONLY; it carries
36	///            no force and contributes no stiffness when it would otherwise be
37	///            in tension (the ends separate).
38	enum class MemberKind { Bar, Cable, Strut };
39	
40	/// A two-force member connecting node `n1` to node `n2`. Indices reference the
41	/// node array stored on the Model.
42	///
43	/// `prestrain`, `alpha`, and `dT` describe installed strain sources. They
44	/// produce internal axial force even at zero nodal displacement; see the task
45	/// contract for the sign convention.
46	struct Element {
47	    std::size_t n1{0};
48	    std::size_t n2{0};
49	    Section section{};
50	    MemberKind kind{MemberKind::Bar};
51	    double prestrain{0.0};
52	    double alpha{0.0};
53	    double dT{0.0};
54	};
55	
56	/// A grounded linear spring support at a single node.
57	///
58	/// The support resists displacement of node `node` ALONG the unit direction
59	/// `dir` with stiffness `kappa` [N/m]. It produces no resistance to motion
60	/// perpendicular to `dir` (a skew roller). Two springs on one node with
61	/// independent directions therefore behave like a 2D elastic support; a single
62	/// spring behaves like an inclined (skew) roller.
63	///
64	/// The support may also SETTLE: its grounded end is held at a prescribed offset
65	/// `settlement` [m] measured along `dir`, so the spring's stored elongation is
66	/// the node's displacement along `dir` relative to that offset. With
67	/// `settlement = 0` this is an ordinary grounded spring.
68	///
69	/// `dir` is stored normalized by the Model.
70	struct SpringSupport {
71	    std::size_t node{0};
72	    Vec2 dir{1.0, 0.0};
73	    double kappa{0.0};
74	    double settlement{0.0};
75	};
76	
77	/// An applied nodal force. `dof` is the global DOF index
78	/// (2*node + component) and `value` is the force magnitude [N].
79	struct Load {
80	    std::size_t dof{0};
81	    double value{0.0};
82	};
83	
84	/// The two global DOF indices owned by a node: {2*node, 2*node + 1}.
85	inline std::array<std::size_t, 2> node_dofs(std::size_t node) {
86	    return {2 * node, 2 * node + 1};
87	}
88	
89	} // namespace truss2d
90	
91	#endif // TRUSS2D_TYPES_HPP
92

/opt/truss2d/include/truss2d/model.hpp

contents
1	#ifndef TRUSS2D_MODEL_HPP
2	#define TRUSS2D_MODEL_HPP
3	
4	#include <cstddef>
5	#include <vector>
6	
7	#include "truss2d/types.hpp"
8	
9	namespace truss2d {
10	
11	/// A 2D structural network of two-force members with spring (skew-roller)
12	/// supports and per-member tension/compression character and prestrain.
13	///
14	/// The model is a plain data container plus light validation / derived-quantity
15	/// helpers. It is fully implemented; the numerical analysis lives in
16	/// StaticSolver (see solver.hpp).
17	class Model {
18	public:
19	    std::size_t add_node(double x, double y);
20	
21	    /// Add a member between two existing nodes.
22	    ///   `kind`      - Bar (default), Cable, or Strut (see types.hpp).
23	    ///   `prestrain` - mechanical installed axial strain (default 0).
24	    ///   `alpha,dT`  - optional thermal expansion data (defaults 0).
25	    /// Throws std::out_of_range if a node index is invalid.
26	    std::size_t add_element(std::size_t n1, std::size_t n2, Section section,
27	                            MemberKind kind = MemberKind::Bar,
28	                            double prestrain = 0.0,
29	                            double alpha = 0.0,
30	                            double dT = 0.0);
31	
32	    /// Add a grounded spring support at `node` resisting displacement along
33	    /// direction (dx, dy) with stiffness `kappa` [N/m]. The direction is
34	    /// normalized internally. Throws std::out_of_range if `node` is invalid,
35	    /// std::runtime_error if (dx, dy) is the zero vector or kappa <= 0.
36	    /// `settlement` (optional, default 0) prescribes the spring's grounded-end
37	    /// offset along (dx, dy); the spring force depends on the node displacement
38	    /// along that direction RELATIVE to this offset.
39	    void add_spring(std::size_t node, double dx, double dy, double kappa,
40	                    double settlement = 0.0);
41	
42	    /// Apply a force `value` [N] to a single global DOF (2*node + component).
43	    /// Throws std::out_of_range if the DOF is invalid.
44	    void add_load(std::size_t dof, double value);
45	
46	    const std::vector<Node>& nodes() const { return nodes_; }
47	    const std::vector<Element>& elements() const { return elements_; }
48	    const std::vector<SpringSupport>& springs() const { return springs_; }
49	    const std::vector<Load>& loads() const { return loads_; }
50	
51	    std::size_t num_nodes() const { return nodes_.size(); }
52	    std::size_t num_elements() const { return elements_.size(); }
53	    std::size_t num_dofs() const { return 2 * nodes_.size(); }
54	
55	    /// Undeformed length of element `e` [m].
56	    /// Throws std::out_of_range if `e` is invalid.
57	    double element_length(std::size_t e) const;
58	
59	    /// Direction cosines (cos, sin) of element `e` measured from node n1
60	    /// toward node n2, in the global frame.
61	    /// Throws std::out_of_range if `e` is invalid, std::runtime_error if the
62	    /// element has zero length.
63	    Vec2 element_direction(std::size_t e) const;
64	
65	    /// Throws std::runtime_error if the model is structurally ill-formed
66	    /// (no nodes, no elements, a zero-length element, a member with
67	    /// non-positive E or A, or no spring supports at all).
68	    void validate() const;
69	
70	private:
71	    std::vector<Node> nodes_;
72	    std::vector<Element> elements_;
73	    std::vector<SpringSupport> springs_;
74	    std::vector<Load> loads_;
75	};
76	
77	} // namespace truss2d
78	
79	#endif // TRUSS2D_MODEL_HPP
80

/opt/truss2d/include/truss2d/dense_matrix.hpp

contents
1	#ifndef TRUSS2D_DENSE_MATRIX_HPP
2	#define TRUSS2D_DENSE_MATRIX_HPP
3	
4	#include <cstddef>
5	#include <stdexcept>
6	#include <vector>
7	
8	namespace truss2d {
9	
10	/// A small, row-major dense matrix of doubles.
11	///
12	/// This is part of the engine's linear-algebra support layer and is fully
13	/// implemented. The truss solver uses it to hold the global stiffness matrix
14	/// and to perform the linear solve via `solve_spd`.
15	class DenseMatrix {
16	public:
17	    DenseMatrix() = default;
18	
19	    DenseMatrix(std::size_t rows, std::size_t cols)
20	        : rows_(rows), cols_(cols), data_(rows * cols, 0.0) {}
21	
22	    std::size_t rows() const { return rows_; }
23	    std::size_t cols() const { return cols_; }
24	
25	    double& operator()(std::size_t r, std::size_t c) {
26	        return data_[r * cols_ + c];
27	    }
28	    double operator()(std::size_t r, std::size_t c) const {
29	        return data_[r * cols_ + c];
30	    }
31	
32	    void fill(double v) {
33	        for (auto& x : data_) x = v;
34	    }
35	
36	private:
37	    std::size_t rows_{0};
38	    std::size_t cols_{0};
39	    std::vector<double> data_;
40	};
41	
42	/// Solve A x = b for a symmetric positive-definite matrix A using an
43	/// LDL^T (Cholesky-style) factorization with no pivoting.
44	///
45	/// `A` is the n-by-n system matrix and `b` is the right-hand side of length n.
46	/// Returns the solution vector x of length n.
47	///
48	/// Throws std::runtime_error if A is not square, if the dimensions are
49	/// inconsistent, or if A is detected to be singular / not positive-definite
50	/// (a zero or negative pivot is encountered). This factorization is
51	/// numerically suitable for the reduced stiffness matrix of a properly
52	/// constrained truss, which is SPD.
53	std::vector<double> solve_spd(const DenseMatrix& A, const std::vector<double>& b);
54	
55	} // namespace truss2d
56	
57	#endif // TRUSS2D_DENSE_MATRIX_HPP
58
Let me look at the implementations of supporting code and a test/demo to understand usage.

/opt/truss2d/src/model.cpp

contents
1	#include "truss2d/model.hpp"
2	
3	#include <cmath>
4	#include <stdexcept>
5	
6	namespace truss2d {
7	
8	std::size_t Model::add_node(double x, double y) {
9	    nodes_.push_back(Node{Vec2{x, y}});
10	    return nodes_.size() - 1;
11	}
12	
13	std::size_t Model::add_element(std::size_t n1, std::size_t n2, Section section,
14	                               MemberKind kind, double prestrain,
15	                               double alpha, double dT) {
16	    if (n1 >= nodes_.size() || n2 >= nodes_.size()) {
17	        throw std::out_of_range("Model::add_element: node index out of range");
18	    }
19	    elements_.push_back(Element{n1, n2, section, kind, prestrain, alpha, dT});
20	    return elements_.size() - 1;
21	}
22	
23	void Model::add_spring(std::size_t node, double dx, double dy, double kappa,
24	                       double settlement) {
25	    if (node >= nodes_.size()) {
26	        throw std::out_of_range("Model::add_spring: node index out of range");
27	    }
28	    const double len = std::sqrt(dx * dx + dy * dy);
29	    if (len <= 0.0) {
30	        throw std::runtime_error("Model::add_spring: zero direction vector");
31	    }
32	    if (kappa <= 0.0) {
33	        throw std::runtime_error("Model::add_spring: non-positive stiffness");
34	    }
35	    springs_.push_back(
36	        SpringSupport{node, Vec2{dx / len, dy / len}, kappa, settlement});
37	}
38	
39	void Model::add_load(std::size_t dof, double value) {
40	    if (dof >= num_dofs()) {
41	        throw std::out_of_range("Model::add_load: DOF out of range");
42	    }
43	    loads_.push_back(Load{dof, value});
44	}
45	
46	double Model::element_length(std::size_t e) const {
47	    if (e >= elements_.size()) {
48	        throw std::out_of_range("Model::element_length: element index out of range");
49	    }
50	    const Element& el = elements_[e];
51	    const Vec2& a = nodes_[el.n1].position;
52	    const Vec2& b = nodes_[el.n2].position;
53	    const double dx = b.x - a.x;
54	    const double dy = b.y - a.y;
55	    return std::sqrt(dx * dx + dy * dy);
56	}
57	
58	Vec2 Model::element_direction(std::size_t e) const {
59	    if (e >= elements_.size()) {
60	        throw std::out_of_range("Model::element_direction: element index out of range");
61	    }
62	    const Element& el = elements_[e];
63	    const Vec2& a = nodes_[el.n1].position;
64	    const Vec2& b = nodes_[el.n2].position;
65	    const double dx = b.x - a.x;
66	    const double dy = b.y - a.y;
67	    const double len = std::sqrt(dx * dx + dy * dy);
68	    if (len <= 0.0) {
69	        throw std::runtime_error("Model::element_direction: zero-length element");
70	    }
71	    return Vec2{dx / len, dy / len};
72	}
73	
74	void Model::validate() const {
75	    if (nodes_.empty()) {
76	        throw std::runtime_error("Model::validate: model has no nodes");
77	    }
78	    if (elements_.empty()) {
79	        throw std::runtime_error("Model::validate: model has no elements");
80	    }
81	    for (std::size_t e = 0; e < elements_.size(); ++e) {
82	        const Element& el = elements_[e];
83	        if (el.section.E <= 0.0 || el.section.A <= 0.0) {
84	            throw std::runtime_error("Model::validate: element has non-positive E or A");
85	        }
86	        if (element_length(e) <= 0.0) {
87	            throw std::runtime_error("Model::validate: element has zero length");
88	        }
89	    }
90	    // Without at least one spring support the network is free to drift; full
91	    // mechanism detection is left to the linear solve, which reports a singular
92	    // system.
93	    if (springs_.empty()) {
94	        throw std::runtime_error(
95	            "Model::validate: no spring supports (rigid-body motion not suppressed)");
96	    }
97	}
98	
99	} // namespace truss2d
100

/opt/truss2d/src/dense_matrix.cpp

contents
1	#include "truss2d/dense_matrix.hpp"
2	
3	#include <cmath>
4	
5	namespace truss2d {
6	
7	std::vector<double> solve_spd(const DenseMatrix& A, const std::vector<double>& b) {
8	    const std::size_t n = A.rows();
9	    if (A.cols() != n) {
10	        throw std::runtime_error("solve_spd: matrix is not square");
11	    }
12	    if (b.size() != n) {
13	        throw std::runtime_error("solve_spd: right-hand side size mismatch");
14	    }
15	
16	    // LDL^T factorization (no pivoting): A = L D L^T with L unit-lower
17	    // triangular and D diagonal. Suitable for the SPD reduced stiffness
18	    // matrix of a well-constrained truss.
19	    DenseMatrix L(n, n);
20	    std::vector<double> D(n, 0.0);
21	
22	    for (std::size_t j = 0; j < n; ++j) {
23	        double dj = A(j, j);
24	        for (std::size_t k = 0; k < j; ++k) {
25	            dj -= L(j, k) * L(j, k) * D[k];
26	        }
27	        // A genuine SPD matrix has strictly positive pivots. A tiny tolerance
28	        // guards against round-off while still flagging singular systems.
29	        if (dj <= 1e-12) {
30	            throw std::runtime_error(
31	                "solve_spd: matrix is singular or not positive-definite");
32	        }
33	        D[j] = dj;
34	        L(j, j) = 1.0;
35	        for (std::size_t i = j + 1; i < n; ++i) {
36	            double s = A(i, j);
37	            for (std::size_t k = 0; k < j; ++k) {
38	                s -= L(i, k) * L(j, k) * D[k];
39	            }
40	            L(i, j) = s / dj;
41	        }
42	    }
43	
44	    // Forward solve L z = b.
45	    std::vector<double> z(n, 0.0);
46	    for (std::size_t i = 0; i < n; ++i) {
47	        double s = b[i];
48	        for (std::size_t k = 0; k < i; ++k) {
49	            s -= L(i, k) * z[k];
50	        }
51	        z[i] = s;
52	    }
53	
54	    // Diagonal solve D y = z.
55	    std::vector<double> y(n, 0.0);
56	    for (std::size_t i = 0; i < n; ++i) {
57	        y[i] = z[i] / D[i];
58	    }
59	
60	    // Back solve L^T x = y.
61	    std::vector<double> x(n, 0.0);
62	    for (std::size_t ii = 0; ii < n; ++ii) {
63	        const std::size_t i = n - 1 - ii;
64	        double s = y[i];
65	        for (std::size_t k = i + 1; k < n; ++k) {
66	            s -= L(k, i) * x[k];
67	        }
68	        x[i] = s;
69	    }
70	
71	    return x;
72	}
73	
74	} // namespace truss2d
75
Let me look at the test, demo, and any instruction file.
shell
ls -R /opt/truss2d --ignore=build 2>/dev/null; echo "---INSTRUCTION---"; cat /opt/truss2d/instruction.md 2>/dev/null | head -200
output
/opt/truss2d:
CMakeLists.txt
examples
include
src
tests

/opt/truss2d/examples:
two_bar.truss

/opt/truss2d/include:
truss2d

/opt/truss2d/include/truss2d:
dense_matrix.hpp
io.hpp
model.hpp
solver.hpp
types.hpp

/opt/truss2d/src:
dense_matrix.cpp
io.cpp
main.cpp
model.cpp
solver.cpp

/opt/truss2d/tests:
CMakeLists.txt
test_smoke.cpp
test_util.hpp
---INSTRUCTION---

[stdout]
/opt/truss2d:
CMakeLists.txt
examples
include
src
tests

/opt/truss2d/examples:
two_bar.truss

/opt/truss2d/include:
truss2d

/opt/truss2d/include/truss2d:
dense_matrix.hpp
io.hpp
model.hpp
solver.hpp
types.hpp

/opt/truss2d/src:
dense_matrix.cpp
io.cpp
main.cpp
model.cpp
solver.cpp

/opt/truss2d/tests:
CMakeLists.txt
test_smoke.cpp
test_util.hpp
---INSTRUCTION---

/opt/truss2d/tests/test_smoke.cpp

contents
1	// Trivial smoke test for the truss2d engine.
2	//
3	// This checks only that the engine links and that the data model + result
4	// shapes are self-consistent. It deliberately makes NO numerical-correctness
5	// assertions, so it passes against the shipped stub solver. The real
6	// correctness / invariant / discriminator suite is provided separately by the
7	// grader.
8	
9	#include <cstddef>
10	#include <sstream>
11	
12	#include "truss2d/io.hpp"
13	#include "truss2d/model.hpp"
14	#include "truss2d/solver.hpp"
15	#include "test_util.hpp"
16	
17	using truss2d::Model;
18	using truss2d::Section;
19	using truss2d::MemberKind;
20	using truss2d::SolveResult;
21	using truss2d::StaticSolver;
22	
23	TRUSS2D_TEST("model_construction_shapes") {
24	    Model m;
25	    m.add_node(0.0, 0.0);
26	    m.add_node(2.0, 0.0);
27	    m.add_element(0, 1, Section{2.0e11, 1.0e-3}, MemberKind::Bar, 0.0);
28	    m.add_spring(0, 1.0, 0.0, 1.0e13);
29	    m.add_spring(0, 0.0, 1.0, 1.0e13);
30	    m.add_spring(1, 0.0, 1.0, 1.0e13);
31	    m.add_load(2, 1.0e3);
32	
33	    truss2d_test::expect(m.num_nodes() == 2, "two nodes");
34	    truss2d_test::expect(m.num_dofs() == 4, "four DOFs");
35	    truss2d_test::expect(m.num_elements() == 1, "one element");
36	    truss2d_test::expect(m.springs().size() == 3, "three springs");
37	}
38	
39	TRUSS2D_TEST("result_vectors_have_expected_lengths") {
40	    Model m;
41	    m.add_node(0.0, 0.0);
42	    m.add_node(3.0, 0.0);
43	    m.add_node(3.0, 4.0);
44	    m.add_element(0, 1, Section{2.0e11, 1.0e-3});
45	    m.add_element(1, 2, Section{2.0e11, 1.0e-3});
46	    m.add_element(0, 2, Section{2.0e11, 1.0e-3});
47	    m.add_spring(0, 1.0, 0.0, 1.0e13);
48	    m.add_spring(0, 0.0, 1.0, 1.0e13);
49	    m.add_spring(1, 0.0, 1.0, 1.0e13);
50	
51	    SolveResult r = StaticSolver(m).solve();
52	    truss2d_test::expect(r.displacements.size() == m.num_dofs(),
53	                         "displacements length == num_dofs");
54	    truss2d_test::expect(r.reactions.size() == m.num_dofs(),
55	                         "reactions length == num_dofs");
56	    truss2d_test::expect(r.axial_forces.size() == m.num_elements(),
57	                         "axial_forces length == num_elements");
58	    truss2d_test::expect(r.utilization.size() == m.num_elements(),
59	                         "utilization length == num_elements");
60	    truss2d_test::expect(r.active.size() == m.num_elements(),
61	                         "active length == num_elements");
62	}
63	
64	TRUSS2D_TEST("parser_reads_records") {
65	    const char* text =
66	        "node 0 0\n"
67	        "node 2 0\n"
68	        "elem 0 1 2.0e11 1.0e-3 1 -5.0e-4 1.2e-5 -25\n"
69	        "spring 0 1 0 1.0e13\n"
70	        "spring 0 0 1 1.0e13\n"
71	        "spring 1 0 1 1.0e13\n"
72	        "load 1 1 -1.0e3\n";
73	    std::istringstream in(text);
74	    Model m = truss2d::parse_model(in);
75	    truss2d_test::expect(m.num_nodes() == 2, "parsed two nodes");
76	    truss2d_test::expect(m.num_elements() == 1, "parsed one element");
77	    truss2d_test::expect(m.elements()[0].kind == MemberKind::Cable,
78	                         "parsed cable kind");
79	    truss2d_test::expect_near(m.elements()[0].alpha, 1.2e-5, 1e-15,
80	                              "parsed alpha");
81	    truss2d_test::expect_near(m.elements()[0].dT, -25.0, 1e-15,
82	                              "parsed dT");
83	    truss2d_test::expect(m.springs().size() == 3, "parsed three springs");
84	}
85	
86	TRUSS2D_TEST_MAIN()
87

/opt/truss2d/tests/test_util.hpp

contents
1	#ifndef TRUSS2D_TEST_UTIL_HPP
2	#define TRUSS2D_TEST_UTIL_HPP
3	
4	// Minimal dependency-free test harness for the truss2d suite.
5	//
6	// Each test executable defines test functions and registers them with
7	// TRUSS2D_TEST(name) { ... }. main() (provided by test_main.hpp via
8	// TRUSS2D_TEST_MAIN) runs every registered test and returns non-zero if any
9	// assertion fails, which CTest interprets as a failure.
10	
11	#include <cmath>
12	#include <cstddef>
13	#include <functional>
14	#include <iostream>
15	#include <string>
16	#include <vector>
17	
18	namespace truss2d_test {
19	
20	struct Case {
21	    std::string name;
22	    std::function<void()> fn;
23	};
24	
25	inline std::vector<Case>& registry() {
26	    static std::vector<Case> cases;
27	    return cases;
28	}
29	
30	struct Registrar {
31	    Registrar(const std::string& name, std::function<void()> fn) {
32	        registry().push_back(Case{name, std::move(fn)});
33	    }
34	};
35	
36	// Thrown by an assertion failure to abort the current test case.
37	struct AssertionError {
38	    std::string message;
39	};
40	
41	inline void expect(bool cond, const std::string& what) {
42	    if (!cond) {
43	        throw AssertionError{what};
44	    }
45	}
46	
47	inline void expect_near(double got, double want, double tol, const std::string& what) {
48	    if (std::fabs(got - want) > tol) {
49	        throw AssertionError{what + " (got " + std::to_string(got) +
50	                             ", want " + std::to_string(want) +
51	                             ", tol " + std::to_string(tol) + ")"};
52	    }
53	}
54	
55	inline int run_all() {
56	    int failures = 0;
57	    for (const auto& c : registry()) {
58	        try {
59	            c.fn();
60	            std::cout << "[ PASS ] " << c.name << "\n";
61	        } catch (const AssertionError& e) {
62	            std::cout << "[ FAIL ] " << c.name << ": " << e.message << "\n";
63	            ++failures;
64	        } catch (const std::exception& e) {
65	            std::cout << "[ FAIL ] " << c.name
66	                      << ": unexpected exception: " << e.what() << "\n";
67	            ++failures;
68	        } catch (...) {
69	            std::cout << "[ FAIL ] " << c.name << ": unknown exception\n";
70	            ++failures;
71	        }
72	    }
73	    std::cout << "----\n"
74	              << (registry().size() - failures) << "/" << registry().size()
75	              << " tests passed\n";
76	    return failures == 0 ? 0 : 1;
77	}
78	
79	} // namespace truss2d_test
80	
81	#define TRUSS2D_CONCAT_INNER(a, b) a##b
82	#define TRUSS2D_CONCAT(a, b) TRUSS2D_CONCAT_INNER(a, b)
83	
84	#define TRUSS2D_TEST(NAME)                                                     \
85	    static void TRUSS2D_CONCAT(truss2d_test_fn_, __LINE__)();                  \
86	    static ::truss2d_test::Registrar TRUSS2D_CONCAT(truss2d_test_reg_,        \
87	                                                    __LINE__){                 \
88	        NAME, &TRUSS2D_CONCAT(truss2d_test_fn_, __LINE__)};                    \
89	    static void TRUSS2D_CONCAT(truss2d_test_fn_, __LINE__)()
90	
91	#define TRUSS2D_TEST_MAIN()                                                    \
92	    int main() { return ::truss2d_test::run_all(); }
93	
94	#endif // TRUSS2D_TEST_UTIL_HPP
95

/opt/truss2d/src/io.cpp

contents
1	#include "truss2d/io.hpp"
2	
3	#include <fstream>
4	#include <iomanip>
5	#include <iostream>
6	#include <sstream>
7	#include <stdexcept>
8	#include <string>
9	
10	namespace truss2d {
11	
12	namespace {
13	
14	[[noreturn]] void fail(std::size_t line_no, const std::string& msg) {
15	    std::ostringstream oss;
16	    oss << "parse_model: line " << line_no << ": " << msg;
17	    throw std::runtime_error(oss.str());
18	}
19	
20	const char* kind_name(MemberKind k) {
21	    switch (k) {
22	        case MemberKind::Bar: return "bar";
23	        case MemberKind::Cable: return "cable";
24	        case MemberKind::Strut: return "strut";
25	    }
26	    return "?";
27	}
28	
29	} // namespace
30	
31	Model parse_model(std::istream& in) {
32	    Model model;
33	    std::string line;
34	    std::size_t line_no = 0;
35	
36	    while (std::getline(in, line)) {
37	        ++line_no;
38	        const auto hash = line.find('#');
39	        if (hash != std::string::npos) {
40	            line.erase(hash);
41	        }
42	        std::istringstream ls(line);
43	        std::string tag;
44	        if (!(ls >> tag)) {
45	            continue; // blank / comment-only line
46	        }
47	
48	        if (tag == "node") {
49	            double x, y;
50	            if (!(ls >> x >> y)) fail(line_no, "expected: node <x> <y>");
51	            model.add_node(x, y);
52	        } else if (tag == "elem") {
53	            std::size_t n1, n2;
54	            double E, A;
55	            if (!(ls >> n1 >> n2 >> E >> A)) {
56	                fail(line_no,
57	                     "expected: elem <n1> <n2> <E> <A> [kind] [prestrain] [alpha] [dT]");
58	            }
59	            int kind_code = 0;
60	            double prestrain = 0.0;
61	            double alpha = 0.0;
62	            double dT = 0.0;
63	            ls >> kind_code;     // optional
64	            ls >> prestrain;     // optional
65	            ls >> alpha;         // optional
66	            ls >> dT;            // optional
67	            MemberKind kind = MemberKind::Bar;
68	            if (kind_code == 1) kind = MemberKind::Cable;
69	            else if (kind_code == 2) kind = MemberKind::Strut;
70	            else if (kind_code != 0) fail(line_no, "kind must be 0/1/2 (bar/cable/strut)");
71	            try {
72	                model.add_element(n1, n2, Section{E, A}, kind, prestrain, alpha, dT);
73	            } catch (const std::exception& ex) {
74	                fail(line_no, ex.what());
75	            }
76	        } else if (tag == "spring") {
77	            std::size_t node;
78	            double dx, dy, kappa;
79	            if (!(ls >> node >> dx >> dy >> kappa)) {
80	                fail(line_no, "expected: spring <node> <dx> <dy> <kappa>");
81	            }
82	            try {
83	                model.add_spring(node, dx, dy, kappa);
84	            } catch (const std::exception& ex) {
85	                fail(line_no, ex.what());
86	            }
87	        } else if (tag == "load") {
88	            std::size_t node, comp;
89	            double value;
90	            if (!(ls >> node >> comp >> value)) {
91	                fail(line_no, "expected: load <node> <comp> <value>");
92	            }
93	            if (comp > 1) fail(line_no, "component must be 0 (x) or 1 (y)");
94	            try {
95	                model.add_load(2 * node + comp, value);
96	            } catch (const std::exception& ex) {
97	                fail(line_no, ex.what());
98	            }
99	        } else {
100	            fail(line_no, "unknown record '" + tag + "'");
101	        }
102	    }
103	
104	    return model;
105	}
106	
107	Model parse_model_file(const std::string& path) {
108	    std::ifstream in(path);
109	    if (!in) {
110	        throw std::runtime_error("parse_model_file: cannot open '" + path + "'");
111	    }
112	    return parse_model(in);
113	}
114	
115	void write_report(std::ostream& out, const Model& model, const SolveResult& result) {
116	    out << std::scientific << std::setprecision(6);
117	    out << "# Truss2D static analysis report\n";
118	    out << "nodes=" << model.num_nodes()
119	        << " elements=" << model.num_elements()
120	        << " dofs=" << model.num_dofs() << "\n\n";
121	
122	    out << "[displacements] (node, ux, uy)\n";
123	    for (std::size_t i = 0; i < model.num_nodes(); ++i) {
124	        out << i << " " << result.displacements[2 * i] << " "
125	            << result.displacements[2 * i + 1] << "\n";
126	    }
127	
128	    out << "\n[reactions] (node, Rx, Ry)\n";
129	    for (std::size_t i = 0; i < model.num_nodes(); ++i) {
130	        out << i << " " << result.reactions[2 * i] << " "
131	            << result.reactions[2 * i + 1] << "\n";
132	    }
133	
134	    out << "\n[axial_forces] (element, kind, active, N [+tension], utilization)\n";
135	    for (std::size_t e = 0; e < model.num_elements(); ++e) {
136	        const bool act = e < result.active.size() ? result.active[e] : true;
137	        const double util = e < result.utilization.size() ? result.utilization[e] : 0.0;
138	        out << e << " " << kind_name(model.elements()[e].kind) << " "
139	            << (act ? 1 : 0) << " " << result.axial_forces[e] << " "
140	            << util << "\n";
141	    }
142	}
143	
144	} // namespace truss2d
145
I now have a thorough understanding. Let me write some quick notes to memory about this task, then implement. I understand the physics required: - **Elastic stiffness**: `Ke = (EA/L)·b·bᵀ` with `b = [-c,-s,c,s]` - **Prestrain**: installed strain `ε₀ = prestrain + α·dT`, installed force `N₀ = -EA·ε₀` (expansion → compression), RHS force `EA·ε₀·b` - **Geometric (initial-stress) stiffness**: `Kg = (N/L)·bp·bpᵀ` with `bp = [s,-c,-s,c]`, using total axial force `N`, solved to self-consistency - **Springs**: `κ·d·dᵀ` stiffness block, settlement adds `κ·settlement·d` to RHS, reaction `= -κ·(u·d - settlement)·d` - **Unilateral members**: active-set iteration on sign of recovered `N = k·δ + N₀` Let me implement:
write · /opt/truss2d/src/solver.cpp
#include "truss2d/solver.hpp"

#include <algorithm>
#include <cmath>
#include <cstddef>
#include <stdexcept>
#include <vector>

#include "truss2d/dense_matrix.hpp"
#include "truss2d/model.hpp"
#include "truss2d/types.hpp"

namespace truss2d {

namespace {

// Allowable axial stress used for the (signed) utilization output [Pa].
constexpr double kAllowableStress = 2.5e8;

// Precomputed per-element kinematics in the global frame.
//
//   b  : axial extension operator, delta = b^T u  with b = [-c,-s, c, s].
//        The single-member elastic stiffness is k * b b^T.
//   bp : transverse operator with bp = [ s,-c,-s, c]. The member's
//        initial-stress (geometric) stiffness is (N/L) * bp bp^T. It vanishes
//        for rigid translation and for relative motion along the axis, and is
//        non-zero only for relative transverse motion.
//   N0 : installed axial force at zero displacement. A positive installed strain
//        eps0 (member manufactured too long / heated) is an elongation the joints
//        resist, so it is initially compressive: N0 = -EA * eps0.
struct ElemData {
    double c{0.0};
    double s{0.0};
    double L{0.0};
    double EA{0.0};
    double k{0.0};
    double eps0{0.0};
    double N0{0.0};
    std::size_t dof[4]{0, 0, 0, 0};
    double b[4]{0.0, 0.0, 0.0, 0.0};
    double bp[4]{0.0, 0.0, 0.0, 0.0};
};

ElemData make_elem(const Model& m, std::size_t e) {
    const Vec2 t = m.element_direction(e);
    const double L = m.element_length(e);
    const Element& el = m.elements()[e];

    ElemData d;
    d.c = t.x;
    d.s = t.y;
    d.L = L;
    d.EA = el.section.E * el.section.A;
    d.k = d.EA / L;
    d.eps0 = el.prestrain + el.alpha * el.dT;  // mechanical + thermal, to 1st order
    d.N0 = -d.EA * d.eps0;

    d.dof[0] = 2 * el.n1;
    d.dof[1] = 2 * el.n1 + 1;
    d.dof[2] = 2 * el.n2;
    d.dof[3] = 2 * el.n2 + 1;

    d.b[0] = -d.c;
    d.b[1] = -d.s;
    d.b[2] = d.c;
    d.b[3] = d.s;

    d.bp[0] = d.s;
    d.bp[1] = -d.c;
    d.bp[2] = -d.s;
    d.bp[3] = d.c;
    return d;
}

}  // namespace

DenseMatrix StaticSolver::element_stiffness_global(std::size_t e) const {
    const ElemData d = make_elem(model_, e);
    DenseMatrix Ke(4, 4);
    for (int i = 0; i < 4; ++i) {
        for (int j = 0; j < 4; ++j) {
            Ke(i, j) = d.k * d.b[i] * d.b[j];
        }
    }
    return Ke;
}

DenseMatrix StaticSolver::assemble_system(const std::vector<bool>& active) const {
    const std::size_t n = model_.num_dofs();
    DenseMatrix K(n, n);

    // Ordinary elastic stiffness of every participating member. (The
    // force-dependent transverse / initial-stress term is NOT included here; it
    // belongs only to the equilibrium solved by solve().)
    const auto& els = model_.elements();
    for (std::size_t e = 0; e < els.size(); ++e) {
        if (!active[e]) continue;
        const ElemData d = make_elem(model_, e);
        for (int i = 0; i < 4; ++i) {
            for (int j = 0; j < 4; ++j) {
                K(d.dof[i], d.dof[j]) += d.k * d.b[i] * d.b[j];
            }
        }
    }

    // Grounded spring supports: kappa * d d^T at the supported node, acting only
    // along the (unit) spring direction.
    for (const auto& sp : model_.springs()) {
        const std::size_t dx = 2 * sp.node;
        const std::size_t dy = 2 * sp.node + 1;
        K(dx, dx) += sp.kappa * sp.dir.x * sp.dir.x;
        K(dx, dy) += sp.kappa * sp.dir.x * sp.dir.y;
        K(dy, dx) += sp.kappa * sp.dir.y * sp.dir.x;
        K(dy, dy) += sp.kappa * sp.dir.y * sp.dir.y;
    }

    return K;
}

std::vector<double>
StaticSolver::prestrain_force(const std::vector<bool>& active) const {
    const std::size_t n = model_.num_dofs();
    std::vector<double> f(n, 0.0);

    const auto& els = model_.elements();
    for (std::size_t e = 0; e < els.size(); ++e) {
        if (!active[e]) continue;
        const ElemData d = make_elem(model_, e);
        if (d.eps0 == 0.0) continue;
        // Equivalent nodal load: F = -b * N0 = EA * eps0 * b. A too-long member
        // (eps0 > 0) pushes its ends apart along the axis.
        const double coef = d.EA * d.eps0;
        for (int i = 0; i < 4; ++i) {
            f[d.dof[i]] += coef * d.b[i];
        }
    }
    return f;
}

SolveResult StaticSolver::solve() const {
    model_.validate();

    const std::size_t n = model_.num_dofs();
    const std::size_t ne = model_.num_elements();
    const auto& els = model_.elements();

    std::vector<ElemData> ed(ne);
    for (std::size_t e = 0; e < ne; ++e) ed[e] = make_elem(model_, e);

    // Applied nodal loads.
    std::vector<double> Fext(n, 0.0);
    for (const auto& ld : model_.loads()) Fext[ld.dof] += ld.value;

    // Elastic axial force recovered from a displacement field for member `e`:
    // N = k * (b^T u) + N0. This is the elastic recovery only -- the
    // initial-stress term never alters the recovered axial force.
    auto recover_N = [&](std::size_t e, const std::vector<double>& u) -> double {
        const ElemData& d = ed[e];
        const double delta = d.b[0] * u[d.dof[0]] + d.b[1] * u[d.dof[1]] +
                             d.b[2] * u[d.dof[2]] + d.b[3] * u[d.dof[3]];
        return d.k * delta + d.N0;
    };

    // Right-hand side for a given active set: applied loads + member prestrain +
    // spring settlement preload (a settled spring pushes/pulls along its axis).
    auto build_rhs = [&](const std::vector<bool>& act) -> std::vector<double> {
        std::vector<double> rhs = Fext;
        const std::vector<double> fp = prestrain_force(act);
        for (std::size_t i = 0; i < n; ++i) rhs[i] += fp[i];
        for (const auto& sp : model_.springs()) {
            const double f = sp.kappa * sp.settlement;
            rhs[2 * sp.node] += f * sp.dir.x;
            rhs[2 * sp.node + 1] += f * sp.dir.y;
        }
        return rhs;
    };

    constexpr int kMaxOuter = 200;  // active-set sweeps
    constexpr int kMaxInner = 200;  // initial-stress (geometric) fixed point

    // Solve the consistent equilibrium for a FIXED active set. The tangent
    // stiffness carries an initial-stress term that depends on the very axial
    // forces it produces, so iterate the assumed member forces until the forces
    // recovered from the resulting displacements coincide with them.
    auto solve_geom = [&](const std::vector<bool>& act) -> std::vector<double> {
        std::vector<double> Nass(ne, 0.0);
        for (std::size_t e = 0; e < ne; ++e) {
            if (act[e]) Nass[e] = ed[e].N0;  // start from installed force
        }
        const std::vector<double> rhs = build_rhs(act);
        std::vector<double> u(n, 0.0);

        for (int inner = 0; inner < kMaxInner; ++inner) {
            DenseMatrix K = assemble_system(act);
            for (std::size_t e = 0; e < ne; ++e) {
                if (!act[e]) continue;
                const double g = Nass[e] / ed[e].L;
                if (g == 0.0) continue;
                const ElemData& d = ed[e];
                for (int i = 0; i < 4; ++i) {
                    for (int j = 0; j < 4; ++j) {
                        K(d.dof[i], d.dof[j]) += g * d.bp[i] * d.bp[j];
                    }
                }
            }

            u = solve_spd(K, rhs);

            double maxdiff = 0.0;
            double maxmag = 0.0;
            for (std::size_t e = 0; e < ne; ++e) {
                if (!act[e]) continue;
                const double Nn = recover_N(e, u);
                maxdiff = std::max(maxdiff, std::fabs(Nn - Nass[e]));
                maxmag = std::max(maxmag, std::fabs(Nn));
                Nass[e] = Nn;
            }
            if (maxdiff <= 1e-12 * (1.0 + maxmag)) break;
        }
        return u;
    };

    // Active-set resolution for the unilateral members. A Bar always
    // participates; a Cable drops out when its consistent axial force would be
    // compressive; a Strut drops out when it would be tensile.
    std::vector<bool> active(ne, true);
    std::vector<double> u(n, 0.0);

    for (int outer = 0; outer < kMaxOuter; ++outer) {
        u = solve_geom(active);

        std::vector<bool> na(ne, true);
        for (std::size_t e = 0; e < ne; ++e) {
            const double Nfull = recover_N(e, u);
            switch (els[e].kind) {
                case MemberKind::Bar:
                    na[e] = true;
                    break;
                case MemberKind::Cable:
                    na[e] = (Nfull > 0.0);
                    break;
                case MemberKind::Strut:
                    na[e] = (Nfull < 0.0);
                    break;
            }
        }
        if (na == active) break;
        active = na;
    }

    // Final consistent state for the resolved active set.
    u = solve_geom(active);

    SolveResult r;
    r.displacements = u;
    r.reactions.assign(n, 0.0);
    r.axial_forces.assign(ne, 0.0);
    r.utilization.assign(ne, 0.0);
    r.active = active;

    for (std::size_t e = 0; e < ne; ++e) {
        if (!active[e]) continue;  // dropped member: exactly zero force/util
        const double N = recover_N(e, u);
        r.axial_forces[e] = N;
        r.utilization[e] = N / (kAllowableStress * els[e].section.A);
    }

    // Support reactions: the force the spring applies to the structure, opposing
    // its stretch relative to any prescribed settlement.
    for (const auto& sp : model_.springs()) {
        const double un =
            u[2 * sp.node] * sp.dir.x + u[2 * sp.node + 1] * sp.dir.y;
        const double force = -sp.kappa * (un - sp.settlement);
        r.reactions[2 * sp.node] += force * sp.dir.x;
        r.reactions[2 * sp.node + 1] += force * sp.dir.y;
    }

    return r;
}

}  // namespace truss2d
Now let me build and run the tests:
shell
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release >/dev/null 2>&1 && cmake --build build --parallel 2>&1 | tail -20 && cd build && ctest --output-on-failure 2>&1 | tail -30
output
[ 11%] Building CXX object CMakeFiles/truss2d.dir/src/dense_matrix.cpp.o
[ 22%] Building CXX object CMakeFiles/truss2d.dir/src/io.cpp.o
[ 33%] Building CXX object CMakeFiles/truss2d.dir/src/solver.cpp.o
[ 44%] Building CXX object CMakeFiles/truss2d.dir/src/model.cpp.o
[ 55%] Linking CXX static library libtruss2d.a
[ 55%] Built target truss2d
[ 66%] Building CXX object CMakeFiles/truss2d_cli.dir/src/main.cpp.o
[ 77%] Building CXX object tests/CMakeFiles/test_smoke.dir/test_smoke.cpp.o
[ 88%] Linking CXX executable truss2d_cli
[ 88%] Built target truss2d_cli
[100%] Linking CXX executable test_smoke
[100%] Built target test_smoke
Test project /opt/truss2d/build
    Start 1: smoke
1/1 Test #1: smoke ............................   Passed    0.00 sec

100% tests passed, 0 tests failed out of 1

Total Test time (real) =   0.00 sec

[stdout]
[ 11%] Building CXX object CMakeFiles/truss2d.dir/src/dense_matrix.cpp.o
[ 22%] Building CXX object CMakeFiles/truss2d.dir/src/io.cpp.o
[ 33%] Building CXX object CMakeFiles/truss2d.dir/src/solver.cpp.o
[ 44%] Building CXX object CMakeFiles/truss2d.dir/src/model.cpp.o
[ 55%] Linking CXX static library libtruss2d.a
[ 55%] Built target truss2d
[ 66%] Building CXX object CMakeFiles/truss2d_cli.dir/src/main.cpp.o
[ 77%] Building CXX object tests/CMakeFiles/test_smoke.dir/test_smoke.cpp.o
[ 88%] Linking CXX executable truss2d_cli
[ 88%] Built target truss2d_cli
[100%] Linking CXX executable test_smoke
[100%] Built target test_smoke
Test project /opt/truss2d/build
    Start 1: smoke
1/1 Test #1: smoke ............................   Passed    0.00 sec

100% tests passed, 0 tests failed out of 1

Total Test time (real) =   0.00 sec
Build and smoke test pass. Now let me verify the physics rigorously with an independent test program covering analytic cases and equilibrium residuals.
shell
cat > /tmp/verify.cpp <<'EOF'
#include "truss2d/model.hpp"
#include "truss2d/solver.hpp"
#include "truss2d/dense_matrix.hpp"
#include <cstdio>
#include <cmath>
using namespace truss2d;

static int fails=0;
void chk(const char* name,double got,double want,double tol){
    bool ok=std::fabs(got-want)<=tol*(1+std::fabs(want));
    printf("%-40s got=% .6e want=% .6e %s\n",name,got,want,ok?"OK":"FAIL");
    if(!ok)fails++;
}

int main(){
  // Case 1: prestrain, near-fixed ends. N should be -EA*eps0.
  {
    Model m; m.add_node(0,0); m.add_node(2,0);
    double E=2e11,A=1e-3; double pre=-5e-4; // too short -> tension
    m.add_element(0,1,Section{E,A},MemberKind::Bar,pre);
    double K=1e16;
    m.add_spring(0,1,0,K); m.add_spring(0,0,1,K);
    m.add_spring(1,1,0,K); m.add_spring(1,0,1,K);
    auto r=StaticSolver(m).solve();
    chk("prestrain N (=-EA*eps0)", r.axial_forces[0], -E*A*pre, 1e-6);
  }
  // Case 2: thermal expansion fixed-fixed -> compression
  {
    Model m; m.add_node(0,0); m.add_node(3,0);
    double E=2e11,A=2e-3,al=1.2e-5,dT=40;
    m.add_element(0,1,Section{E,A},MemberKind::Bar,0.0,al,dT);
    double K=1e16;
    m.add_spring(0,1,0,K); m.add_spring(0,0,1,K);
    m.add_spring(1,1,0,K); m.add_spring(1,0,1,K);
    auto r=StaticSolver(m).solve();
    chk("thermal N (=-EA*al*dT)", r.axial_forces[0], -E*A*al*dT, 1e-6);
  }
  // Case 3: axial load, statically determinate, N = F
  {
    Model m; m.add_node(0,0); m.add_node(2,0);
    double E=2e11,A=1e-3;
    m.add_element(0,1,Section{E,A},MemberKind::Bar);
    double K=1e16;
    m.add_spring(0,1,0,K); m.add_spring(0,0,1,K);
    m.add_spring(1,0,1,K); // roller y at node1
    double F=5e4; m.add_load(2,F); // node1 x
    auto r=StaticSolver(m).solve();
    chk("axial N (=F)", r.axial_forces[0], F, 1e-6);
    chk("axial reaction node0 x (=-F)", r.reactions[0], -F, 1e-6);
    chk("u1x (=FL/EA)", r.displacements[2], F*2.0/(E*A), 1e-4);
  }
  // Case 4: slack cable - cable that would be compressed goes slack
  {
    Model m; m.add_node(0,0); m.add_node(2,0);
    double E=2e11,A=1e-3;
    m.add_element(0,1,Section{E,A},MemberKind::Cable);
    double K=1e16;
    m.add_spring(0,1,0,K); m.add_spring(0,0,1,K);
    m.add_spring(1,0,1,K);
    double F=-5e4; m.add_load(2,F); // push node1 toward node0 -> compression -> slack
    auto r=StaticSolver(m).solve();
    chk("slack cable N (=0)", r.axial_forces[0], 0.0, 1e-9);
    printf("  cable active=%d (want 0)\n", (int)r.active[0]); if(r.active[0])fails++;
  }
  // Case 5: strut in tension -> separates
  {
    Model m; m.add_node(0,0); m.add_node(2,0);
    double E=2e11,A=1e-3;
    m.add_element(0,1,Section{E,A},MemberKind::Strut);
    double K=1e16;
    m.add_spring(0,1,0,K); m.add_spring(0,0,1,K);
    m.add_spring(1,0,1,K);
    double F=5e4; m.add_load(2,F); // pull node1 away -> tension -> strut separates
    auto r=StaticSolver(m).solve();
    chk("separated strut N (=0)", r.axial_forces[0], 0.0, 1e-9);
    printf("  strut active=%d (want 0)\n", (int)r.active[0]); if(r.active[0])fails++;
  }
  // Case 6: settlement produces reaction/force. Node1 on bar to fixed node0,
  // node1 has x-spring with settlement s. With stiff spring node1.x ~ s.
  {
    Model m; m.add_node(0,0); m.add_node(2,0);
    double E=2e11,A=1e-3;
    m.add_element(0,1,Section{E,A},MemberKind::Bar);
    double Kbig=1e16;
    m.add_spring(0,1,0,Kbig); m.add_spring(0,0,1,Kbig);
    m.add_spring(1,0,1,Kbig);
    double ks=1e6, s=1e-3;
    m.add_spring(1,1,0,ks,s); // x spring at node1 with settlement
    auto r=StaticSolver(m).solve();
    // node1: bar stiffness k=EA/L, spring ks pulling toward s. equilibrium:
    // k*u + ks*(u - s) = 0 -> u = ks*s/(k+ks)
    double k=E*A/2.0; double u=ks*s/(k+ks);
    chk("settlement u1x", r.displacements[2], u, 1e-6);
    chk("settlement reaction node1 x", r.reactions[2], -ks*(u-s), 1e-6);
    chk("bar N from settlement (=k*u)", r.axial_forces[0], k*u, 1e-5);
  }
  printf("\n%s\n", fails? "SOME FAILURES" : "ALL PASS");
  return fails?1:0;
}
EOF
g++ -std=c++17 -I/opt/truss2d/include /tmp/verify.cpp /opt/truss2d/build/libtruss2d.a -o /tmp/verify && /tmp/verify
output
Exit code 134
terminate called after throwing an instance of 'std::runtime_error'
  what():  solve_spd: matrix is singular or not positive-definite
/bin/bash: line 203:  1725 Aborted                 /tmp/verify

[error] tool reported failure
shell
cd /tmp && for c in 1 2 3 4 5 6; do echo "=== case $c ==="; done
# add per-case isolation by recompiling with a guard
cat > /tmp/which.cpp <<'EOF'
#include "truss2d/model.hpp"
#include "truss2d/solver.hpp"
#include <cstdio>
using namespace truss2d;
int main(){
  try{
    Model m; m.add_node(0,0); m.add_node(2,0);
    double E=2e11,A=1e-3; double pre=-5e-4;
    m.add_element(0,1,Section{E,A},MemberKind::Bar,pre);
    double K=1e16;
    m.add_spring(0,1,0,K); m.add_spring(0,0,1,K);
    m.add_spring(1,1,0,K); m.add_spring(1,0,1,K);
    auto r=StaticSolver(m).solve();
    printf("case1 ok N=%g\n", r.axial_forces[0]);
  }catch(std::exception&e){printf("case1 threw: %s\n",e.what());}
  return 0;
}
EOF
g++ -std=c++17 -I/opt/truss2d/include /tmp/which.cpp /opt/truss2d/build/libtruss2d.a -o /tmp/which && /tmp/which
output
=== case 1 ===
=== case 2 ===
=== case 3 ===
=== case 4 ===
=== case 5 ===
=== case 6 ===
case1 ok N=100000
Shell cwd was reset to /opt/truss2d

[stdout]
=== case 1 ===
=== case 2 ===
=== case 3 ===
=== case 4 ===
=== case 5 ===
=== case 6 ===
case1 ok N=100000
[stderr]

Shell cwd was reset to /opt/truss2d
Cases 4 and 5 make the structure a genuine mechanism when the unilateral member drops (node1.x loses its only constraint) , that's correct behavior to throw. Let me fix the test design with a backstop spring and re-run all cases:
shell
cat > /tmp/verify.cpp <<'EOF'
#include "truss2d/model.hpp"
#include "truss2d/solver.hpp"
#include <cstdio>
#include <cmath>
using namespace truss2d;
static int fails=0;
void chk(const char* name,double got,double want,double tol){
    bool ok=std::fabs(got-want)<=tol*(1+std::fabs(want));
    printf("%-42s got=% .6e want=% .6e %s\n",name,got,want,ok?"OK":"FAIL");
    if(!ok)fails++;
}
int main(){
  // Case 4: slack cable with backstop spring at node1.x (k=1e5).
  {
    Model m; m.add_node(0,0); m.add_node(2,0);
    double E=2e11,A=1e-3;
    m.add_element(0,1,Section{E,A},MemberKind::Cable);
    double K=1e16;
    m.add_spring(0,1,0,K); m.add_spring(0,0,1,K);
    m.add_spring(1,0,1,K);
    double kb=1e5; m.add_spring(1,1,0,kb); // backstop x
    double F=-50.0; m.add_load(2,F); // compression on cable -> slack
    auto r=StaticSolver(m).solve();
    chk("slack cable N (=0)", r.axial_forces[0], 0.0, 1e-9);
    printf("  cable active=%d (want 0)\n",(int)r.active[0]); if(r.active[0])fails++;
    // node1.x only held by backstop: u = F/kb
    chk("slack node1.x u (=F/kb)", r.displacements[2], F/kb, 1e-6);
  }
  // Case 5: separated strut with backstop
  {
    Model m; m.add_node(0,0); m.add_node(2,0);
    double E=2e11,A=1e-3;
    m.add_element(0,1,Section{E,A},MemberKind::Strut);
    double K=1e16;
    m.add_spring(0,1,0,K); m.add_spring(0,0,1,K);
    m.add_spring(1,0,1,K);
    double kb=1e5; m.add_spring(1,1,0,kb);
    double F=50.0; m.add_load(2,F); // tension on strut -> separate
    auto r=StaticSolver(m).solve();
    chk("separated strut N (=0)", r.axial_forces[0], 0.0, 1e-9);
    printf("  strut active=%d (want 0)\n",(int)r.active[0]); if(r.active[0])fails++;
    chk("separated node1.x u (=F/kb)", r.displacements[2], F/kb, 1e-6);
  }
  // Case 5b: cable in tension stays active, N=F
  {
    Model m; m.add_node(0,0); m.add_node(2,0);
    double E=2e11,A=1e-3;
    m.add_element(0,1,Section{E,A},MemberKind::Cable);
    double K=1e16;
    m.add_spring(0,1,0,K); m.add_spring(0,0,1,K);
    m.add_spring(1,0,1,K);
    double F=4e4; m.add_load(2,F);
    auto r=StaticSolver(m).solve();
    chk("taut cable N (=F)", r.axial_forces[0], F, 1e-6);
    printf("  cable active=%d (want 1)\n",(int)r.active[0]); if(!r.active[0])fails++;
    chk("util (=N/(2.5e8*A))", r.utilization[0], F/(2.5e8*A), 1e-9);
  }
  printf("\n%s\n", fails? "SOME FAILURES":"ALL PASS");
  return fails?1:0;
}
EOF
g++ -std=c++17 -I/opt/truss2d/include /tmp/verify.cpp /opt/truss2d/build/libtruss2d.a -o /tmp/verify && /tmp/verify
output
slack cable N (=0)                         got= 0.000000e+00 want= 0.000000e+00 OK
  cable active=0 (want 0)
slack node1.x u (=F/kb)                    got=-5.000000e-04 want=-5.000000e-04 OK
separated strut N (=0)                     got= 0.000000e+00 want= 0.000000e+00 OK
  strut active=0 (want 0)
separated node1.x u (=F/kb)                got= 5.000000e-04 want= 5.000000e-04 OK
taut cable N (=F)                          got= 4.000000e+04 want= 4.000000e+04 OK
  cable active=1 (want 1)
util (=N/(2.5e8*A))                        got= 1.600000e-01 want= 1.600000e-01 OK

ALL PASS

[stdout]
slack cable N (=0)                         got= 0.000000e+00 want= 0.000000e+00 OK
  cable active=0 (want 0)
slack node1.x u (=F/kb)                    got=-5.000000e-04 want=-5.000000e-04 OK
separated strut N (=0)                     got= 0.000000e+00 want= 0.000000e+00 OK
  strut active=0 (want 0)
separated node1.x u (=F/kb)                got= 5.000000e-04 want= 5.000000e-04 OK
taut cable N (=F)                          got= 4.000000e+04 want= 4.000000e+04 OK
  cable active=1 (want 1)
util (=N/(2.5e8*A))                        got= 1.600000e-01 want= 1.600000e-01 OK

ALL PASS
Now let me verify the earlier cases (prestrain, thermal, axial, settlement) plus the geometric/initial-stress effect with a taut-string transverse stiffness test:
shell
cat > /tmp/v2.cpp <<'EOF'
#include "truss2d/model.hpp"
#include "truss2d/solver.hpp"
#include "truss2d/dense_matrix.hpp"
#include <cstdio>
#include <cmath>
#include <vector>
using namespace truss2d;
static int fails=0;
void chk(const char* n,double g,double w,double t){bool ok=std::fabs(g-w)<=t*(1+std::fabs(w));
  printf("%-44s got=% .6e want=% .6e %s\n",n,g,w,ok?"OK":"FAIL"); if(!ok)fails++;}
int main(){
  // 1 prestrain too-short -> tension
  {Model m;m.add_node(0,0);m.add_node(2,0);double E=2e11,A=1e-3,pre=-5e-4;
   m.add_element(0,1,Section{E,A},MemberKind::Bar,pre);double K=1e16;
   m.add_spring(0,1,0,K);m.add_spring(0,0,1,K);m.add_spring(1,1,0,K);m.add_spring(1,0,1,K);
   auto r=StaticSolver(m).solve();chk("prestrain N (=-EA*eps0)",r.axial_forces[0],-E*A*pre,1e-6);}
  // 2 thermal
  {Model m;m.add_node(0,0);m.add_node(3,0);double E=2e11,A=2e-3,al=1.2e-5,dT=40;
   m.add_element(0,1,Section{E,A},MemberKind::Bar,0,al,dT);double K=1e16;
   m.add_spring(0,1,0,K);m.add_spring(0,0,1,K);m.add_spring(1,1,0,K);m.add_spring(1,0,1,K);
   auto r=StaticSolver(m).solve();chk("thermal N (=-EA*al*dT)",r.axial_forces[0],-E*A*al*dT,1e-6);}
  // 3 axial determinate
  {Model m;m.add_node(0,0);m.add_node(2,0);double E=2e11,A=1e-3;
   m.add_element(0,1,Section{E,A},MemberKind::Bar);double K=1e16;
   m.add_spring(0,1,0,K);m.add_spring(0,0,1,K);m.add_spring(1,0,1,K);
   double F=5e4;m.add_load(2,F);auto r=StaticSolver(m).solve();
   chk("axial N (=F)",r.axial_forces[0],F,1e-6);
   chk("reaction0x (=-F)",r.reactions[0],-F,1e-6);
   chk("u1x (=FL/EA)",r.displacements[2],F*2.0/(E*A),1e-4);}
  // 6 settlement
  {Model m;m.add_node(0,0);m.add_node(2,0);double E=2e11,A=1e-3;
   m.add_element(0,1,Section{E,A},MemberKind::Bar);double Kb=1e16;
   m.add_spring(0,1,0,Kb);m.add_spring(0,0,1,Kb);m.add_spring(1,0,1,Kb);
   double ks=1e6,s=1e-3;m.add_spring(1,1,0,ks,s);auto r=StaticSolver(m).solve();
   double k=E*A/2.0,u=ks*s/(k+ks);
   chk("settlement u1x",r.displacements[2],u,1e-6);
   chk("settlement reaction1x",r.reactions[2],-ks*(u-s),1e-6);
   chk("settlement bar N (=k*u)",r.axial_forces[0],k*u,1e-5);}

  // GEOMETRIC: taut string, 3 nodes, two pretensioned segments, transverse load.
  // Pretension T via prestrain (too short). Independent reference: solve the
  // 1-DOF nonlinear consistency by hand-iterating the same physics.
  {
    double E=2e11,A=1e-4,a=1.0; double pre=-1e-3; // tension T0=EA*1e-3=2e4
    Model m;m.add_node(0,0);m.add_node(a,0);m.add_node(2*a,0);
    double K=1e16;
    m.add_element(0,1,Section{E,A},MemberKind::Bar,pre);
    m.add_element(1,2,Section{E,A},MemberKind::Bar,pre);
    m.add_spring(0,1,0,K);m.add_spring(0,0,1,K);
    m.add_spring(2,1,0,K);m.add_spring(2,0,1,K);
    m.add_spring(1,1,0,K); // fix node1 x (symmetric, no x motion)
    double P=2e3; m.add_load(3,P); // transverse y at node1
    auto r=StaticSolver(m).solve();
    double v=r.displacements[3];
    double N=r.axial_forces[0];
    // Independent check: at node1, equilibrium in y (1st order geometric):
    //   2 * (N/a) * v = P   with  N = EA*( sqrt(a^2+v^2)-a - (-pre*a) )/a... 
    // small-disp consistent: N = EA*(v^2/(2a^2) - pre)  (elastic strain = dL/a, dL= v^2/2a + (-pre*a)? )
    // elastic strain = (stretch - natural_stretch)/L; natural too short by pre*a.
    // axial extension delta (1st order)=0 for pure transverse; but solver uses delta=b^T u
    // For node1 pure y move, delta of each seg = projection = 0 to 1st order, so N=N0=-EA*pre=T0.
    // Then geometric: 2*(T0/a)*v=P -> v=P a/(2 T0)
    double T0=-E*A*pre;
    double v_ref=P*a/(2*T0);
    chk("taut-string transverse v",v,v_ref,2e-3);
    chk("taut-string axial N (=T0)",N,T0,2e-3);
    // verify both segments equal by symmetry
    chk("string seg2 N == seg1",r.axial_forces[1],r.axial_forces[0],1e-9);
  }
  printf("\n%s\n", fails?"SOME FAILURES":"ALL PASS");
  return fails?1:0;
}
EOF
g++ -std=c++17 -I/opt/truss2d/include /tmp/v2.cpp /opt/truss2d/build/libtruss2d.a -o /tmp/v2 && /tmp/v2
output
prestrain N (=-EA*eps0)                      got= 1.000000e+05 want= 1.000000e+05 OK
thermal N (=-EA*al*dT)                       got=-1.920000e+05 want=-1.920000e+05 OK
axial N (=F)                                 got= 5.000000e+04 want= 5.000000e+04 OK
reaction0x (=-F)                             got=-5.000000e+04 want=-5.000000e+04 OK
u1x (=FL/EA)                                 got= 5.000000e-04 want= 5.000000e-04 OK
settlement u1x                               got= 9.900990e-06 want= 9.900990e-06 OK
settlement reaction1x                        got= 9.900990e+02 want= 9.900990e+02 OK
settlement bar N (=k*u)                      got= 9.900990e+02 want= 9.900990e+02 OK
taut-string transverse v                     got= 5.000000e-02 want= 5.000000e-02 OK
taut-string axial N (=T0)                    got= 2.000000e+04 want= 2.000000e+04 OK
string seg2 N == seg1                        got= 2.000000e+04 want= 2.000000e+04 OK

ALL PASS

[stdout]
prestrain N (=-EA*eps0)                      got= 1.000000e+05 want= 1.000000e+05 OK
thermal N (=-EA*al*dT)                       got=-1.920000e+05 want=-1.920000e+05 OK
axial N (=F)                                 got= 5.000000e+04 want= 5.000000e+04 OK
reaction0x (=-F)                             got=-5.000000e+04 want=-5.000000e+04 OK
u1x (=FL/EA)                                 got= 5.000000e-04 want= 5.000000e-04 OK
settlement u1x                               got= 9.900990e-06 want= 9.900990e-06 OK
settlement reaction1x                        got= 9.900990e+02 want= 9.900990e+02 OK
settlement bar N (=k*u)                      got= 9.900990e+02 want= 9.900990e+02 OK
taut-string transverse v                     got= 5.000000e-02 want= 5.000000e-02 OK
taut-string axial N (=T0)                    got= 2.000000e+04 want= 2.000000e+04 OK
string seg2 N == seg1                        got= 2.000000e+04 want= 2.000000e+04 OK

ALL PASS
Excellent , all analytic cases pass, including the geometric initial-stress effect. Let me do a final general equilibrium-residual check on a 2D inclined truss to exercise direction cosines and confirm internal consistency:
shell
cat > /tmp/v3.cpp <<'EOF'
#include "truss2d/model.hpp"
#include "truss2d/solver.hpp"
#include <cstdio>
#include <cmath>
using namespace truss2d;
static int fails=0;
void chk(const char* n,double g,double w,double t){bool ok=std::fabs(g-w)<=t*(1+std::fabs(w));
  printf("%-40s got=% .6e want=% .6e %s\n",n,g,w,ok?"OK":"FAIL"); if(!ok)fails++;}
int main(){
  // Classic symmetric 2-bar truss: A(0,0),B(2,0) pinned top; C(1,-1) load P down.
  // theta=45deg. 2*N*sin45 = P (N tension). N = P/(2*sin45).
  double E=2e11,A=1e-3,P=1e5;
  Model m;m.add_node(0,0);m.add_node(2,0);m.add_node(1,-1);
  double K=1e16;
  m.add_element(0,2,Section{E,A}); // AC
  m.add_element(1,2,Section{E,A}); // BC
  m.add_spring(0,1,0,K);m.add_spring(0,0,1,K);
  m.add_spring(1,1,0,K);m.add_spring(1,0,1,K);
  m.add_load(5,-P); // node2 y down
  auto r=StaticSolver(m).solve();
  double th=std::atan2(1.0,1.0); // 45
  double Nref=P/(2*std::sin(th));
  chk("2-bar N AC",r.axial_forces[0],Nref,1e-3);
  chk("2-bar N BC",r.axial_forces[1],Nref,1e-3);
  // reactions at A,B vertical = P/2 each (up)
  chk("reaction A y (=P/2)",r.reactions[1],P/2,1e-3);
  chk("reaction B y (=P/2)",r.reactions[3],P/2,1e-3);
  // global equilibrium: sum reactions + loads = 0
  double sx=0,sy=0;
  for(size_t i=0;i<m.num_nodes();++i){sx+=r.reactions[2*i];sy+=r.reactions[2*i+1];}
  for(auto&l:m.loads()){ if(l.dof%2==0)sx+=l.value; else sy+=l.value;}
  chk("global sum Fx",sx,0.0,1e-3);
  chk("global sum Fy",sy,0.0,1e-3);
  printf("\n%s\n", fails?"SOME FAILURES":"ALL PASS");
  return fails?1:0;
}
EOF
g++ -std=c++17 -I/opt/truss2d/include /tmp/v3.cpp /opt/truss2d/build/libtruss2d.a -o /tmp/v3 && /tmp/v3
output
2-bar N AC                               got= 7.068570e+04 want= 7.071068e+04 OK
2-bar N BC                               got= 7.068570e+04 want= 7.071068e+04 OK
reaction A y (=P/2)                      got= 5.000000e+04 want= 5.000000e+04 OK
reaction B y (=P/2)                      got= 5.000000e+04 want= 5.000000e+04 OK
global sum Fx                            got= 0.000000e+00 want= 0.000000e+00 OK
global sum Fy                            got=-2.910383e-11 want= 0.000000e+00 OK

ALL PASS

[stdout]
2-bar N AC                               got= 7.068570e+04 want= 7.071068e+04 OK
2-bar N BC                               got= 7.068570e+04 want= 7.071068e+04 OK
reaction A y (=P/2)                      got= 5.000000e+04 want= 5.000000e+04 OK
reaction B y (=P/2)                      got= 5.000000e+04 want= 5.000000e+04 OK
global sum Fx                            got= 0.000000e+00 want= 0.000000e+00 OK
global sum Fy                            got=-2.910383e-11 want= 0.000000e+00 OK

ALL PASS
All checks pass. The implementation is complete and verified. Let me run the project's own test suite one final time to confirm everything is green:
shell
cd /opt/truss2d/build && cmake --build . --parallel 2>&1 | tail -2 && ctest --output-on-failure 2>&1 | tail -5
output
[ 77%] Built target truss2d_cli
[100%] Built target test_smoke
1/1 Test #1: smoke ............................   Passed    0.00 sec

100% tests passed, 0 tests failed out of 1

Total Test time (real) =   0.00 sec

[stdout]
[ 77%] Built target truss2d_cli
[100%] Built target test_smoke
1/1 Test #1: smoke ............................   Passed    0.00 sec

100% tests passed, 0 tests failed out of 1

Total Test time (real) =   0.00 sec
I've implemented the static solver in `/opt/truss2d/src/solver.cpp`. The build succeeds and all tests pass, including an extensive set of independent analytic verifications I ran against the library. ## What I implemented **`element_stiffness_global(e)`** , ordinary elastic 4×4 member stiffness `(EA/L)·b·bᵀ` in the global frame, with `b = [-c,-s,c,s]` (the axial-extension operator, `δ = bᵀu`). **`assemble_system(active)`** , sums the elastic stiffness of participating members plus each spring's `κ·d·dᵀ` block. Deliberately *excludes* the force-dependent initial-stress term, as the contract requires the helpers to report ordinary elastic behavior only. **`prestrain_force(active)`** , combines mechanical and thermal installed strain to first order (`ε₀ = prestrain + α·dT`), giving the RHS load `EA·ε₀·b`. Sign convention is correct: a member made too long / heated (`ε₀>0`) pushes its ends apart and is initially compressive (`N₀ = -EA·ε₀`). **`solve()`** , calls `Model::validate()`, then resolves two coupled nonlinearities: - **Initial-stress (geometric) consistency**: each taut member adds `(N/L)·bp·bpᵀ` (`bp = [s,-c,-s,c]`) to the tangent stiffness using its *total* axial force. Since `N` depends on `u` which depends on the stiffness, it iterates the assumed forces until recovered forces coincide. This term stiffens transverse motion under tension and softens under compression, and vanishes for rigid translation and axial relative motion. It never alters the recovered axial force (`N = k·δ + N₀`). - **Active set**: bars always participate; cables drop out under compression, struts under tension , judged by the consistent total axial force. Dropped members report exactly zero force/utilization. Outputs include skew/settling spring reactions (`-κ·(u·d − settlement)·d`, opposing relative stretch), signed utilization (`N / (2.5e8·A)`), and all vectors sized to the model. Singular/non-PD governing systems let the solver's exception propagate. ## Verification (independent of the shipped smoke test) - Prestrain & thermal fixed-fixed: `N = -EA·ε₀` ✓ - Statically determinate axial loading, displacement & reactions ✓ - Slack cable / separated strut → zero force, `active=false`; taut cable carries load ✓ - Spring settlement preload, displacement, reaction, induced member force ✓ - **Geometric effect**: taut-string transverse stiffness `2T/a` (so `v = Pa/2T`) matched exactly ✓ - 45° two-bar truss: member forces, support reactions, and global force balance ✓ I only edited `src/solver.cpp`; no headers or signatures changed.
Final diff , what the agent changed

No file changes, the agent left the workspace untouched.

Verifier output , the proof behind the reward
tests/test.sh
== Restoring pristine project ==
== Staging candidate solver ==
== Injecting hidden grading tests ==
== Configuring (cmake) ==
-- The CXX compiler identification is GNU 11.4.0
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Check for working CXX compiler: /usr/bin/c++ - skipped
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- Configuring done
-- Generating done
-- Build files have been written to: /tmp/tmp.FlmBbXAGXh/truss2d/build_grade
== Building ==
[  5%] Building CXX object CMakeFiles/truss2d.dir/src/dense_matrix.cpp.o
[ 10%] Building CXX object CMakeFiles/truss2d.dir/src/solver.cpp.o
[ 15%] Building CXX object CMakeFiles/truss2d.dir/src/model.cpp.o
[ 21%] Building CXX object CMakeFiles/truss2d.dir/src/io.cpp.o
[ 26%] Linking CXX static library libtruss2d.a
[ 26%] Built target truss2d
[ 31%] Building CXX object CMakeFiles/truss2d_cli.dir/src/main.cpp.o
[ 36%] Building CXX object tests/CMakeFiles/test_core.dir/test_core.cpp.o
[ 42%] Building CXX object tests/CMakeFiles/test_soak.dir/test_soak.cpp.o
[ 47%] Building CXX object tests/CMakeFiles/test_unilateral.dir/test_unilateral.cpp.o
[ 52%] Building CXX object tests/CMakeFiles/test_geometric.dir/test_geometric.cpp.o
[ 57%] Building CXX object tests/CMakeFiles/test_degenerate.dir/test_degenerate.cpp.o
[ 63%] Building CXX object tests/CMakeFiles/test_settlement.dir/test_settlement.cpp.o
[ 68%] Linking CXX executable truss2d_cli
[ 68%] Built target truss2d_cli
[ 73%] Linking CXX executable test_degenerate
[ 73%] Built target test_degenerate
[ 78%] Linking CXX executable test_soak
[ 78%] Built target test_soak
[ 84%] Linking CXX executable test_unilateral
[ 89%] Linking CXX executable test_settlement
[ 89%] Built target test_settlement
[ 89%] Built target test_unilateral
[ 94%] Linking CXX executable test_core
[ 94%] Built target test_core
[100%] Linking CXX executable test_geometric
[100%] Built target test_geometric
== Running hidden tests ==
Test project /tmp/tmp.FlmBbXAGXh/truss2d/build_grade
    Start 1: test_core
1/6 Test #1: test_core ........................   Passed    0.00 sec
    Start 2: test_unilateral
2/6 Test #2: test_unilateral ..................   Passed    0.00 sec
    Start 3: test_geometric
3/6 Test #3: test_geometric ...................   Passed    0.00 sec
    Start 4: test_soak
4/6 Test #4: test_soak ........................   Passed    0.00 sec
    Start 5: test_degenerate
5/6 Test #5: test_degenerate ..................   Passed    0.00 sec
    Start 6: test_settlement
6/6 Test #6: test_settlement ..................   Passed    0.00 sec

100% tests passed, 0 tests failed out of 6

Label Time Summary:
hidden    =   0.02 sec*proc (6 tests)

Total Test time (real) =   0.02 sec
PASS: all hidden tests passed

Reproduce this trial: git checkout 2f94510 && PYTHONPATH=src python3 scripts/build_site.py , then open trial/trial_4cf7c5e8285a42fd. Re-running the agent live requires EVAL_PLATFORM_ENABLE_OAUTH_SMOKE=1 and is non-deterministic.

Trial trial_4cf7c5e8285a42fd · verifier authoritative; classifier explanatory.