Files
FemLite/docs/v6_acceptance_report.md
T
shenw 175531e24d
FemLite CI / build-test (push) Has been cancelled
Release 0.6.0
2026-07-01 20:44:15 +08:00

69 lines
3.1 KiB
Markdown

# FemLite 0.6.0 Acceptance Report
Date: 2026-07-01
Status: release close-out candidate.
## Scope
FemLite 0.6.0 closes the first algorithm-foundation loop after the 0.5.x V5
diagnostic hardening line. The release adds a shared nonlinear lifecycle
module, lifecycle hooks for the covered static/Newmark/Riks paths, rollback
audit adapters, lifecycle CSV output fields and restart version 5 lifecycle
diagnostics.
0.6.0 does not claim delivery of complete industrial AL/mortar consistent
tangents, generalized mixed-control continuation, cohesive contact mainline,
DEM/FEM subcycling, nonzero harmonic cyclic solving or production roll-forming
workflow support.
## Delivered Evidence
| Item | Evidence |
|---|---|
| Lifecycle ids and snapshot | `nonlinear_lifecycle` covers event names, empty snapshot, history and audit names. |
| Static nonlinear hook | `solver_implicit` covers accepted and rejected/cutback lifecycle paths. |
| Nonlinear Newmark hook | `solver_implicit` covers nonlinear Newmark success and rejection. |
| Riks/arc hook | `solver_implicit` covers lifecycle accept, load factor, arc residual and path append. |
| Rollback audit | Material, contact, cohesive and particle audit adapters feed the shared lifecycle status. |
| Output schema | `continuation_path.csv` appends lifecycle fields without reordering older columns. |
| Restart schema | Restart version 5 writes optional `LIFECYCLE_DIAGNOSTICS`; reader accepts files without the block. |
| Documentation | Design, algorithm, interface, test, user and developer docs state lifecycle boundaries and deferred solver rewrites. |
## Planned Close-Out Commands
```powershell
cmake --build build-codex-gcc --parallel
ctest --test-dir build-codex-gcc -R "^(solver_implicit|implicit_inp|restart|contact_mortar_report|contact_multiplier_report|cohesive_contact|particle_acceptance)$" --output-on-failure
ctest --test-dir build-codex-gcc -L v5_acceptance --output-on-failure
git diff --check
```
## Results
| Command | Result |
|---|---|
| `cmake --build build-codex-gcc --parallel` | passed; CMake regenerated and full build completed. |
| 0.6.0 targeted regression command | 7/7 passed. |
| `ctest --test-dir build-codex-gcc -L v5_acceptance --output-on-failure` | 39/39 passed after updating version assertions to 0.6.0. |
| `git diff --check` | passed; Git reported line-ending normalization warnings only. |
## Close-Out Conclusion
FemLite 0.6.0 meets the planned lifecycle foundation acceptance criteria on
the local `build-codex-gcc` configuration. The release remains bounded to
diagnostic lifecycle infrastructure and rollback audit coverage for the
documented subset.
## Deferred Work
- Complete industrial AL/mortar consistent tangent and full contact
state-machine rewrite.
- Generalized mixed-control continuation and branch switching.
- Complete shell preload `K_G` and high-order solid geometric stiffness.
- Cohesive contact mainline integration.
- Nonzero harmonic cyclic symmetry.
- DEM/FEM subcycling and large-particle long runs.
- Production roll-forming process chain.
- Additional solver scaling and block preconditioning work.