Files
FemLite/docs/v6_acceptance_report.md
T
shenw 5e081806fb
FemLite CI / build-test (push) Has been cancelled
Release FemLite 0.6.1
2026-07-01 22:41:16 +08:00

4.5 KiB

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

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.

0.6.1 Diagnostic Hardening Addendum

0.6.1 keeps the 0.6.0 release boundary and hardens diagnostics around the covered nonlinear/contact paths. It adds lifecycle summary queries, cutback-reason taxonomy, nonlinear_lifecycle.csv, stable contact state counters, compact contact long-path checker coverage, AL/friction summary fields, a shared tangent-audit report shell, Riks/arc path indicators, restart-after-each-accepted audit coverage and fuller linear-solver fields in nonlinear rows.

Final 0.6.1 evidence on build-codex-gcc:

cmake --build build-codex-gcc --parallel
ctest --test-dir build-codex-gcc -R "^(nonlinear_lifecycle|solver_implicit|implicit_inp|restart|contact|contact_mortar_report|contact_multiplier_report|cohesive_contact|particle_acceptance|linear_solver_cg)$" --output-on-failure
ctest --test-dir build-codex-gcc -R "^example_(contact_two_blocks_compression|contact_block_sliding|shell_shell_contact|shell_solid_contact)_benchmark$" --output-on-failure
ctest --test-dir build-codex-gcc -L v5_acceptance --output-on-failure
git diff --check

0.6.1 targeted regression passed 10/10, the compact contact benchmark smoke passed 4/4, the V5 acceptance subset passed 39/39 and the version-specific smoke checks passed 2/2 after the public version was raised to 0.6.1.

0.6.1 still does not claim complete industrial AL/mortar consistent tangent delivery, generalized mixed-control continuation, cohesive contact mainline, DEM/FEM subcycling or production roll-forming workflow support.