58 lines
1.9 KiB
Markdown
58 lines
1.9 KiB
Markdown
# Step 9: build-test-report
|
|
|
|
## Read These Files First
|
|
|
|
Read the following files before editing:
|
|
|
|
- `/AGENTS.md`
|
|
- `/docs/build-test-reports/README.md`
|
|
- `/docs/implementation-plans/euler-beam-3d-implementation-plan.md`
|
|
- `/src/fesa/elements/euler_beam_3d.hpp`
|
|
- `/src/fesa/elements/euler_beam_3d.cpp`
|
|
- `/tests/unit/euler_beam_3d_local_stiffness_test.cpp`
|
|
- `/tests/unit/euler_beam_3d_transform_recovery_test.cpp`
|
|
|
|
## Task
|
|
|
|
Create `/docs/build-test-reports/euler-beam-3d-build-test.md`.
|
|
|
|
The report must record:
|
|
|
|
- feature id
|
|
- changed files observed for this phase
|
|
- command log summary with exit codes and short evidence tails
|
|
- validation results for:
|
|
- harness self-test
|
|
- CMake configure/build
|
|
- CTest
|
|
- feature-specific tests
|
|
- failure classification if anything failed
|
|
- explicit statement that this report does not approve reference verification or release readiness
|
|
|
|
Do not change source or tests in this step.
|
|
|
|
## Tests To Write First
|
|
|
|
- No C++ test is required in this documentation-only step.
|
|
|
|
## Acceptance Criteria
|
|
|
|
```powershell
|
|
ctest --test-dir build/msvc-debug --output-on-failure -C Debug -R "model_element_test|euler_beam_3d_(local_stiffness|transform_recovery)_test"
|
|
python -m unittest discover -s scripts -p "test_*.py"
|
|
python scripts/validate_workspace.py
|
|
```
|
|
|
|
## Verification Notes
|
|
|
|
1. Record actual command exit codes and concise output evidence.
|
|
2. If validation fails for an environment reason, mark the report `needs-environment-fix` and update this phase step as blocked.
|
|
3. Update `phases/euler-beam-3d/index.json` step 9:
|
|
- success: `"status": "completed"`, `"summary": "3D Euler beam build/test report added"`
|
|
- failure after retries: `"status": "error"`, `"error_message": "<specific error>"`
|
|
- blocked: `"status": "blocked"`, `"blocked_reason": "<specific reason>"`
|
|
|
|
## Forbidden
|
|
|
|
- Do not modify source, tests, requirements, formulations, I/O contracts, or reference artifacts.
|