This commit is contained in:
@@ -1,344 +1,401 @@
|
||||
# FemLite 0.6.0 TODO
|
||||
# FemLite 0.6.1 TODO
|
||||
|
||||
Source plan: `docs/v6.0_development_plan.md`
|
||||
Source plan: `docs/v6.1_development_plan.md`
|
||||
|
||||
Version goal:
|
||||
|
||||
```text
|
||||
FemLite 0.6.0 = unified nonlinear state machine and lifecycle foundation
|
||||
FemLite 0.6.1 = nonlinear/contact lifecycle diagnostics hardening
|
||||
```
|
||||
|
||||
Boundary:
|
||||
|
||||
- The fifth-version closure boundary is lifted for future planning, but 0.6.0
|
||||
should still remain a controlled loop.
|
||||
- 0.6.1 deepens the 0.6.0 lifecycle foundation; it is not a broad algorithm
|
||||
rewrite release.
|
||||
- Do not implement a complete industrial AL/mortar consistent tangent rewrite
|
||||
in this task list.
|
||||
- Do not move mixed-control continuation, shell preload `K_G`, high-order solid
|
||||
`K_G`, cohesive contact mainline, nonzero harmonic cyclic, DEM subcycling or
|
||||
production roll forming into the 0.6.0 must-complete list.
|
||||
- Every new lifecycle or audit field must be consumed by a test, checker or
|
||||
report audit.
|
||||
production roll forming into the 0.6.1 must-complete list.
|
||||
- Every new reason, status, counter or output field must be consumed by a
|
||||
regression test, checker or report audit.
|
||||
- Keep TODO item size uniform: each task should add one observable contract and
|
||||
one focused verification path.
|
||||
|
||||
## Execution Order
|
||||
|
||||
1. NLCS-1: lifecycle ids, names and snapshot skeleton.
|
||||
2. NLCS-2: static nonlinear lifecycle hook.
|
||||
3. NLCS-3: nonlinear Newmark lifecycle hook.
|
||||
4. NLCS-4: Riks/arc lifecycle hook.
|
||||
5. NLCS-5: rollback audit core.
|
||||
6. NLCS-6: material rollback audit adapter.
|
||||
7. NLCS-7: contact rollback audit adapter.
|
||||
8. NLCS-8: cohesive and particle audit adapters.
|
||||
9. NLCS-9: lifecycle output/report schema.
|
||||
10. NLCS-10: restart lifecycle audit.
|
||||
11. DOC-1: documentation and interface synchronization.
|
||||
12. REL-1: 0.6.0 regression/version close-out.
|
||||
1. NLHD-1: lifecycle increment summary.
|
||||
2. NLHD-2: cutback reason taxonomy.
|
||||
3. NLHD-3: lifecycle report output.
|
||||
4. NLHD-4: contact state diagnostics.
|
||||
5. NLHD-5: contact long-path diagnostic smoke.
|
||||
6. NLHD-6: AL/friction diagnostics.
|
||||
7. NLHD-7: tangent-audit report shell.
|
||||
8. NLHD-8: Riks/arc diagnostics.
|
||||
9. NLHD-9: restart-after-each-accepted audit.
|
||||
10. NLHD-10: solver diagnostics coupling.
|
||||
11. DOC-1: documentation and matrix synchronization.
|
||||
12. REL-1: 0.6.1 regression/version close-out.
|
||||
|
||||
## Detailed Execution Map
|
||||
|
||||
| TODO | Code targets | Output/API contract | Test/checker target | Not in scope |
|
||||
|---|---|---|---|---|
|
||||
| 0.6.0-1 | `src/solver/fem_nonlinear_lifecycle.f90`, diagnostics API | Stable lifecycle event ids/names and queryable empty snapshot | new lifecycle unit/module test | Change Newton algorithms |
|
||||
| 0.6.0-2 | static nonlinear solver loop | Record increment/iteration begin/end and accept/reject events | `solver_implicit` | Change convergence rules |
|
||||
| 0.6.0-3 | nonlinear Newmark solver loop | Record dynamic nonlinear lifecycle events | `solver_implicit` | Rewrite Newmark integration |
|
||||
| 0.6.0-4 | Riks/arc static path | Record load factor, arc residual and path append lifecycle fields | `solver_implicit`, `implicit_inp` | Mixed-control continuation |
|
||||
| 0.6.0-5 | lifecycle audit module | Generic commit/rollback audit counters and status | lifecycle audit unit/module test | Owner-specific checksum details |
|
||||
| 0.6.0-6 | material/element state path | Material local state rollback audit for covered subset | `solver_implicit`, material tests | New material models |
|
||||
| 0.6.0-7 | contact state/history path | Contact state and diagnostic rollback audit for covered subset | `restart`, contact report tests | Full contact state-machine rewrite |
|
||||
| 0.6.0-8 | cohesive and particle compact paths | Cohesive/particle owner audit hooks using existing compact tests | `cohesive_contact`, `particle_acceptance` | Cohesive mainline or DEM subcycling |
|
||||
| 0.6.0-9 | output/report modules | Lifecycle event/report columns or compact lifecycle CSV | `solver_implicit`, output checker | Break existing CSV consumers |
|
||||
| 0.6.0-10 | restart writer/reader and restart tests | Accepted-increment lifecycle diagnostics round trip | `restart` | Redesign restart format |
|
||||
| 0.6.0-11 | docs and manuals | Document lifecycle API, output and deferred boundaries | wording `rg` checks | Expand feature scope |
|
||||
| 0.6.0-12 | version/matrix/report files | Close 0.6.0 after green targeted and V5 acceptance tests | build, targeted tests, acceptance, `git diff --check` | Version bump before tests pass |
|
||||
| 0.6.1-1 | lifecycle module and diagnostics API | Increment summary fields for lifecycle, convergence, residual, solver and audit state | `nonlinear_lifecycle`, `solver_implicit` | Change Newton algorithms |
|
||||
| 0.6.1-2 | control/reason taxonomy | Stable cutback reason ids/names and last cutback reason query | `solver_implicit`, lifecycle test | New nonlinear strategy |
|
||||
| 0.6.1-3 | output/report module | Compact lifecycle report or appended nonlinear report fields | output checker | Break old CSV columns |
|
||||
| 0.6.1-4 | contact state/report modules | Stable contact state counters and gap/slip/friction fields | `contact`, contact reports | Full contact state-machine rewrite |
|
||||
| 0.6.1-5 | contact benchmark checkers | Long-path diagnostic smoke for existing compact contact examples | contact benchmark checkers | New contact benchmark physics |
|
||||
| 0.6.1-6 | multiplier/friction diagnostics | AL multiplier, augmentation and friction trend summaries | `contact_multiplier_report`, `restart` | Complete AL tangent |
|
||||
| 0.6.1-7 | tangent audit reporting | Shared audit schema and coverage counters | tangent audit tests | Claim production consistent tangents |
|
||||
| 0.6.1-8 | Riks/arc path diagnostics | Arc residual history, predictor and reversal indicators | `solver_implicit`, `implicit_inp` | Mixed-control continuation |
|
||||
| 0.6.1-9 | restart writer/reader tests | Multi-increment restart lifecycle audit | `restart` | Large restart benchmark |
|
||||
| 0.6.1-10 | linear solver diagnostics | Solver status fields linked into lifecycle/nonlinear rows | `linear_solver_cg`, `solver_implicit` | New solver backend |
|
||||
| 0.6.1-11 | docs and matrices | Updated interface/user/developer docs and benchmark matrix | wording `rg` checks | Expand feature scope |
|
||||
| 0.6.1-12 | version/report files | Close 0.6.1 after green targeted and V5 acceptance tests | build, targeted tests, acceptance, `git diff --check` | Version bump before tests pass |
|
||||
|
||||
## Implementation Rules
|
||||
|
||||
- Work in the execution order above.
|
||||
- Do not mark a TODO done until its lifecycle field or audit status is consumed
|
||||
by a test, checker or report audit.
|
||||
- Prefer additive lifecycle hooks over solver-loop rewrites.
|
||||
- Keep existing public signatures stable unless a thin new accessor is clearly
|
||||
safer.
|
||||
- If a task exposes incompatible designs for lifecycle ownership, pause and ask
|
||||
for a decision before editing that route.
|
||||
- Do not mark a TODO done until its new field, reason or status is consumed by
|
||||
a test, checker or report audit.
|
||||
- Prefer additive diagnostics over solver-loop rewrites.
|
||||
- Keep old CSV columns stable; append new fields.
|
||||
- Keep restart readers backward compatible; optional diagnostic blocks are
|
||||
preferred over format breaks.
|
||||
- If a task exposes incompatible designs for contact, Riks, material or restart
|
||||
ownership, pause and ask for a decision before editing that route.
|
||||
- If a later task needs a field created by an earlier task, finish and test the
|
||||
earlier task first.
|
||||
|
||||
## 0.6.0 Task List
|
||||
## 0.6.1 Task List
|
||||
|
||||
### [x] TODO 0.6.0-1: Add nonlinear lifecycle ids and snapshot skeleton
|
||||
### [x] TODO 0.6.1-1: Add lifecycle increment summary
|
||||
|
||||
- Source:
|
||||
- `docs/v6.0_development_plan.md` sections 4.1 and 5, NLCS-1.
|
||||
- `docs/v6.1_development_plan.md` sections 4.1 and 5, NLHD-1.
|
||||
- Implementation:
|
||||
- [x] Add stable lifecycle event ids and names for increment begin, trial
|
||||
begin, iteration result, accept, reject, cutback, commit and rollback.
|
||||
- [x] Add a small lifecycle snapshot with step/increment/iteration/event
|
||||
fields and last reason id/name linkage.
|
||||
- [x] Add a reset/begin/query API that returns a valid empty snapshot before
|
||||
any nonlinear solve.
|
||||
- [x] Keep the module passive; it must not change solver behavior yet.
|
||||
- [x] Add a compact lifecycle increment summary structure or query path.
|
||||
- [x] Include step, increment, final event id/name and reason id/name.
|
||||
- [x] Include convergence status, residual breakdown, linear solver status
|
||||
and audit status fields already available in 0.6.0.
|
||||
- [x] Keep existing lifecycle snapshot APIs compatible.
|
||||
- Tests:
|
||||
- [x] Add a lifecycle unit/module test for id/name stability and empty
|
||||
snapshot defaults.
|
||||
- [x] Extend `nonlinear_lifecycle` to verify empty and populated summary
|
||||
fields.
|
||||
- [x] Extend `solver_implicit` to consume the summary after one accepted and
|
||||
one rejected/cutback path.
|
||||
- Acceptance:
|
||||
- [x] Tests can query lifecycle state without running a solve, and all event
|
||||
names are stable.
|
||||
- [x] A test can explain the latest nonlinear increment from one summary
|
||||
query without reading console output.
|
||||
|
||||
Verified:
|
||||
|
||||
- `ctest --test-dir build-codex-gcc -R "^(nonlinear_lifecycle|linear_solver_cg|c_api)$" --output-on-failure`
|
||||
```powershell
|
||||
cmake --build build-codex-gcc --parallel
|
||||
ctest --test-dir build-codex-gcc -R "^(nonlinear_lifecycle|solver_implicit)$" --output-on-failure
|
||||
```
|
||||
|
||||
### [x] TODO 0.6.0-2: Hook static nonlinear lifecycle events
|
||||
### [x] TODO 0.6.1-2: Add cutback reason taxonomy
|
||||
|
||||
- Source:
|
||||
- `docs/v6.0_development_plan.md` sections 4.1 and 5, NLCS-2.
|
||||
- `docs/v6.1_development_plan.md` sections 4.2 and 5, NLHD-2.
|
||||
- Implementation:
|
||||
- [x] Record increment begin and iteration begin in the nonlinear static path.
|
||||
- [x] Record iteration result with convergence status and current failure
|
||||
reason fields.
|
||||
- [x] Record accepted, rejected or cutback increment events without changing
|
||||
the existing cutback decision.
|
||||
- [x] Preserve existing convergence metrics and continuation path behavior.
|
||||
- [x] Add stable cutback reason ids/names for common nonlinear failure modes.
|
||||
- [x] Track the last cutback reason separately from the final convergence
|
||||
failure reason.
|
||||
- [x] Map existing min-step, nonconvergence and linear-solver failure paths
|
||||
into the new taxonomy.
|
||||
- [x] Leave unavailable reasons as reserved/documented ids until a real path
|
||||
consumes them.
|
||||
- Tests:
|
||||
- [x] Extend `solver_implicit` to verify lifecycle event sequence for a
|
||||
converged static nonlinear path and one rejected/cutback path.
|
||||
- [x] Extend `nonlinear_lifecycle` to verify reason-name stability.
|
||||
- [x] Extend `solver_implicit` to verify at least min-step and
|
||||
nonconvergence cutback reasons.
|
||||
- Acceptance:
|
||||
- [x] Static nonlinear diagnostics expose lifecycle events that match the
|
||||
existing solver outcome.
|
||||
- [x] Every implemented 0.6.1 cutback reason is consumed by a regression
|
||||
assertion.
|
||||
|
||||
Verified:
|
||||
|
||||
- `ctest --test-dir build-codex-gcc -R "^(nonlinear_lifecycle|solver_implicit)$" --output-on-failure`
|
||||
```powershell
|
||||
cmake --build build-codex-gcc --parallel
|
||||
ctest --test-dir build-codex-gcc -R "^(nonlinear_lifecycle|solver_implicit)$" --output-on-failure
|
||||
```
|
||||
|
||||
### [x] TODO 0.6.0-3: Hook nonlinear Newmark lifecycle events
|
||||
### [x] TODO 0.6.1-3: Write lifecycle report output
|
||||
|
||||
- Source:
|
||||
- `docs/v6.0_development_plan.md` sections 4.1 and 5, NLCS-3.
|
||||
- `docs/v6.1_development_plan.md` sections 4.3 and 5, NLHD-3.
|
||||
- Implementation:
|
||||
- [x] Record Newmark nonlinear increment and iteration lifecycle events.
|
||||
- [x] Link dynamic residual status to the shared lifecycle snapshot.
|
||||
- [x] Record accepted/rejected dynamic increments where the current path can
|
||||
identify them.
|
||||
- [x] Preserve current Newmark time integration and convergence behavior.
|
||||
- [x] Add `nonlinear_lifecycle.csv` or append equivalent lifecycle summary
|
||||
fields to an existing nonlinear report.
|
||||
- [x] Cover initialized/no-solve, accepted increment and rejected/cutback
|
||||
increment rows.
|
||||
- [x] Include lifecycle summary, cutback reason, residual breakdown, solver
|
||||
status and audit status columns.
|
||||
- [x] Preserve old `continuation_path.csv` column order if that file is
|
||||
extended again.
|
||||
- Tests:
|
||||
- [x] Extend `solver_implicit` to verify lifecycle fields after a nonlinear
|
||||
Newmark run.
|
||||
- [x] Add or extend an output checker to validate required lifecycle report
|
||||
headers.
|
||||
- [x] Verify at least one accepted row and one rejected/cutback row.
|
||||
- Acceptance:
|
||||
- [x] Static and Newmark nonlinear paths expose the same lifecycle field
|
||||
contract for the covered subset.
|
||||
- [x] Missing lifecycle report fields cause a regression failure.
|
||||
|
||||
Verified:
|
||||
|
||||
- `ctest --test-dir build-codex-gcc -R "^(solver_implicit|nonlinear_lifecycle|c_api)$" --output-on-failure`
|
||||
```powershell
|
||||
cmake --build build-codex-gcc --parallel
|
||||
ctest --test-dir build-codex-gcc -R "^(nonlinear_lifecycle|solver_implicit)$" --output-on-failure
|
||||
```
|
||||
|
||||
### [x] TODO 0.6.0-4: Hook Riks/arc lifecycle events
|
||||
### [x] TODO 0.6.1-4: Stabilize contact state diagnostics
|
||||
|
||||
- Source:
|
||||
- `docs/v6.0_development_plan.md` sections 4.1 and 5, NLCS-4.
|
||||
- `docs/v6.1_development_plan.md` sections 4.4 and 5, NLHD-4.
|
||||
- Implementation:
|
||||
- [x] Record Riks/arc lifecycle events in the load-type arc path.
|
||||
- [x] Store current load factor, arc residual and arc reason in the lifecycle
|
||||
snapshot.
|
||||
- [x] Record whether a path row is appended because the increment was
|
||||
accepted.
|
||||
- [x] Preserve current Riks/arc equations and direct displacement-control
|
||||
behavior.
|
||||
- [x] Define stable contact state names: `open`, `closed-stick`,
|
||||
`closed-slip`, `closed-restick`, `separating` and `failed-projection`.
|
||||
- [x] Report state counters through existing contact diagnostics or a compact
|
||||
helper.
|
||||
- [x] Include gap maximum/mean/L2, slip increment/residual, friction residual
|
||||
and active-set flip count where available.
|
||||
- [x] Keep this diagnostic-only; do not rewrite contact solve state
|
||||
ownership.
|
||||
- Tests:
|
||||
- [x] Extend `solver_implicit` or `implicit_inp` to verify arc lifecycle
|
||||
fields on an accepted Riks path.
|
||||
- [x] Extend `contact` or contact report tests to verify state names and
|
||||
counters.
|
||||
- [x] Verify unsupported/unavailable state fields default consistently.
|
||||
- Acceptance:
|
||||
- [x] Riks/arc diagnostics can be interpreted through the same lifecycle
|
||||
event model as static nonlinear diagnostics.
|
||||
- [x] Contact diagnostics can distinguish open, stick/slip and failed
|
||||
projection states without parsing logs.
|
||||
|
||||
Verified:
|
||||
|
||||
- `ctest --test-dir build-codex-gcc -R "^(nonlinear_lifecycle|solver_implicit|c_api)$" --output-on-failure`
|
||||
```powershell
|
||||
cmake --build build-codex-gcc --parallel
|
||||
ctest --test-dir build-codex-gcc -R "^contact$" --output-on-failure
|
||||
```
|
||||
|
||||
### [x] TODO 0.6.0-5: Add generic rollback audit core
|
||||
### [x] TODO 0.6.1-5: Add compact contact long-path diagnostic smoke
|
||||
|
||||
- Source:
|
||||
- `docs/v6.0_development_plan.md` sections 4.2 and 5, NLCS-5.
|
||||
- `docs/v6.1_development_plan.md` sections 4.5 and 5, NLHD-5.
|
||||
- Implementation:
|
||||
- [x] Add generic audit counters for begin-trial, rollback-requested,
|
||||
rollback-ok, rollback-failed and commit-ok.
|
||||
- [x] Add an audit status/name field to the lifecycle snapshot.
|
||||
- [x] Add helpers that owner modules can call without depending on each other.
|
||||
- [x] Keep owner-specific checksum logic out of the generic core.
|
||||
- [x] Select existing compact examples for two-block compression, block
|
||||
sliding, shell-shell contact and shell-solid contact.
|
||||
- [x] Add checker expectations for required diagnostic columns and finite
|
||||
state counters.
|
||||
- [x] Check gap/slip/friction/multiplier diagnostics across path steps.
|
||||
- [x] Keep benchmark physics and tolerances bounded to existing examples.
|
||||
- Tests:
|
||||
- [x] Add lifecycle audit coverage for counter transitions and failure naming.
|
||||
- [x] Extend existing contact benchmark checkers or their CTest assertions.
|
||||
- [x] Verify at least two path steps for one compact long-path case.
|
||||
- Acceptance:
|
||||
- [x] A test can simulate owner audit success/failure and observe the shared
|
||||
audit status.
|
||||
- [x] A compact contact path can fail diagnostics loudly if state or residual
|
||||
fields disappear.
|
||||
|
||||
Verified:
|
||||
|
||||
- `ctest --test-dir build-codex-gcc -R "^nonlinear_lifecycle$" --output-on-failure`
|
||||
```powershell
|
||||
cmake --build build-codex-gcc --parallel
|
||||
ctest --test-dir build-codex-gcc -R "^contact$" --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
|
||||
```
|
||||
|
||||
### [x] TODO 0.6.0-6: Add material rollback audit adapter
|
||||
### [x] TODO 0.6.1-6: Add AL multiplier and friction diagnostic summaries
|
||||
|
||||
- Source:
|
||||
- `docs/v6.0_development_plan.md` sections 4.3 and 5, NLCS-6.
|
||||
- `docs/v6.1_development_plan.md` sections 4.6 and 5, NLHD-6.
|
||||
- Implementation:
|
||||
- [x] Add a covered-subset material state checksum or equivalent audit value
|
||||
before trial updates.
|
||||
- [x] Compare material state after rollback for a rejected nonlinear
|
||||
increment.
|
||||
- [x] Feed material rollback status into the lifecycle audit core.
|
||||
- [x] Keep material constitutive algorithms unchanged.
|
||||
- [x] Add multiplier residual trend and maximum augmented multiplier summary
|
||||
fields.
|
||||
- [x] Add augmentation update count and accepted-step penalty/augmentation
|
||||
factor fields.
|
||||
- [x] Add slip/friction residual summary fields where existing friction state
|
||||
supports them.
|
||||
- [x] Include restart before/after consistency checks for supported fields.
|
||||
- Tests:
|
||||
- [x] Extend `solver_implicit` or material tests with one rejected/cutback
|
||||
material-state rollback audit.
|
||||
- [x] Extend `contact_multiplier_report` to consume new summary fields.
|
||||
- [x] Extend `restart` or `contact` to compare supported multiplier/friction
|
||||
summaries before and after restart.
|
||||
- Acceptance:
|
||||
- [x] Rejected material trial updates are proven not to contaminate committed
|
||||
state for the covered subset.
|
||||
- [x] AL/friction diagnostic summaries are visible in tests and survive the
|
||||
covered restart path.
|
||||
|
||||
Verified:
|
||||
|
||||
- `ctest --test-dir build-codex-gcc -R "^(nonlinear_lifecycle|solver_implicit)$" --output-on-failure`
|
||||
```powershell
|
||||
cmake --build build-codex-gcc --parallel
|
||||
ctest --test-dir build-codex-gcc -R "^(contact_multiplier_report|restart)$" --output-on-failure
|
||||
```
|
||||
|
||||
### [x] TODO 0.6.0-7: Add contact rollback audit adapter
|
||||
### [x] TODO 0.6.1-7: Add shared tangent-audit report shell
|
||||
|
||||
- Source:
|
||||
- `docs/v6.0_development_plan.md` sections 4.3 and 5, NLCS-7.
|
||||
- `docs/v6.1_development_plan.md` sections 4.7 and 5, NLHD-7.
|
||||
- Implementation:
|
||||
- [x] Capture contact state counts and selected contact diagnostics before
|
||||
trial changes.
|
||||
- [x] Compare contact state after rollback for a rejected/cutback increment.
|
||||
- [x] Feed contact rollback status into the lifecycle audit core.
|
||||
- [x] Reuse existing 0.5.3 contact diagnostics rather than adding broad new
|
||||
contact fields.
|
||||
- [x] Define a shared tangent-audit report schema with audit name, branch,
|
||||
sample count, relative error and status fields.
|
||||
- [x] Route existing material/contact/shell/Riks audit summaries into the
|
||||
shared vocabulary where already available.
|
||||
- [x] Add coverage counters for missing or not-applicable audit branches.
|
||||
- [x] Document that this is an audit report shell, not production consistent
|
||||
tangent delivery.
|
||||
- Tests:
|
||||
- [x] Extend `restart` or contact report tests with a contact rollback audit
|
||||
scenario.
|
||||
- [x] Extend existing tangent audit tests or add a schema checker.
|
||||
- [x] Verify at least normal contact and one non-contact audit category in
|
||||
the shared report vocabulary.
|
||||
- Acceptance:
|
||||
- [x] Contact diagnostics and state counts remain consistent after rollback
|
||||
for the covered subset.
|
||||
- [x] Tangent audit output has a uniform schema without changing production
|
||||
tangent behavior.
|
||||
|
||||
Verified:
|
||||
|
||||
- `ctest --test-dir build-codex-gcc -R "^(contact|contact_multiplier_diag)$" --output-on-failure`
|
||||
```powershell
|
||||
cmake --build build-codex-gcc --parallel
|
||||
ctest --test-dir build-codex-gcc -R "^contact_mortar_tangent$" --output-on-failure
|
||||
```
|
||||
|
||||
### [x] TODO 0.6.0-8: Add cohesive and particle audit adapters
|
||||
### [x] TODO 0.6.1-8: Harden Riks and arc diagnostics
|
||||
|
||||
- Source:
|
||||
- `docs/v6.0_development_plan.md` sections 4.3 and 5, NLCS-8.
|
||||
- `docs/v6.1_development_plan.md` sections 4.8 and 5, NLHD-8.
|
||||
- Implementation:
|
||||
- [x] Add cohesive compact-path audit hooks for damage/status/energy rollback
|
||||
where existing state support allows it.
|
||||
- [x] Add particle compact-path audit hooks for mass/momentum/energy counters.
|
||||
- [x] Feed both owner statuses into the lifecycle audit core.
|
||||
- [x] Keep cohesive mainline contact and DEM subcycling out of this task.
|
||||
- [x] Record arc residual history for accepted Riks/arc increments.
|
||||
- [x] Add predictor direction consistency and load-factor reversal indicators.
|
||||
- [x] Add a simple turning-point indicator where current path data supports
|
||||
it.
|
||||
- [x] Add path/report fields that distinguish load-control Riks from direct
|
||||
displacement control.
|
||||
- Tests:
|
||||
- [x] Extend `cohesive_contact` and `particle_acceptance` to consume the new
|
||||
audit statuses.
|
||||
- [x] Extend `solver_implicit` to verify Riks/arc diagnostic fields.
|
||||
- [x] Extend `implicit_inp` only if an existing deterministic input path can
|
||||
consume the fields cheaply.
|
||||
- Acceptance:
|
||||
- [x] Existing compact cohesive and particle tests can report lifecycle audit
|
||||
status without changing their physics paths.
|
||||
- [x] Riks/arc diagnostics expose residual and predictor/path direction state
|
||||
without implementing mixed-control continuation.
|
||||
|
||||
Verified:
|
||||
|
||||
- `ctest --test-dir build-codex-gcc -R "^(cohesive_contact|particle_step|nonlinear_lifecycle)$" --output-on-failure`
|
||||
```powershell
|
||||
cmake --build build-codex-gcc --parallel
|
||||
ctest --test-dir build-codex-gcc -R "^(solver_implicit|implicit_inp)$" --output-on-failure
|
||||
```
|
||||
|
||||
### [x] TODO 0.6.0-9: Write lifecycle diagnostics to output/report path
|
||||
### [x] TODO 0.6.1-9: Add restart-after-each-accepted audit
|
||||
|
||||
- Source:
|
||||
- `docs/v6.0_development_plan.md` sections 4.4 and 5, NLCS-9.
|
||||
- `docs/v6.1_development_plan.md` sections 4.9 and 5, NLHD-9.
|
||||
- Implementation:
|
||||
- [x] Add lifecycle event/status fields to an existing nonlinear report path
|
||||
or a compact `nonlinear_lifecycle.csv`.
|
||||
- [x] Include event id/name, audit status/name, increment, iteration, reason
|
||||
id/name and accepted/rejected counters.
|
||||
- [x] Keep old continuation/contact CSV columns stable.
|
||||
- [x] Represent missing lifecycle data consistently for unsupported paths.
|
||||
- Tests:
|
||||
- [x] Extend `solver_implicit` or an output checker to verify lifecycle output
|
||||
headers and at least one accepted row.
|
||||
- Acceptance:
|
||||
- [x] Checker failure occurs if required 0.6.0 lifecycle output fields are
|
||||
missing.
|
||||
|
||||
Verified:
|
||||
|
||||
- `ctest --test-dir build-codex-gcc -R "^(solver_implicit|nonlinear_lifecycle)$" --output-on-failure`
|
||||
|
||||
### [x] TODO 0.6.0-10: Add restart lifecycle audit
|
||||
|
||||
- Source:
|
||||
- `docs/v6.0_development_plan.md` sections 4.4 and 6, NLCS-10.
|
||||
- Implementation:
|
||||
- [x] Persist accepted-increment lifecycle diagnostics needed for restart
|
||||
audit where restart format already supports the owned state.
|
||||
- [x] Read old restart files without requiring lifecycle fields.
|
||||
- [x] Compare lifecycle event/status and owner audit summaries before and
|
||||
- [x] Add a compact multi-increment restart audit flow.
|
||||
- [x] After each accepted increment, write restart, read into a fresh model
|
||||
and compare lifecycle diagnostics.
|
||||
- [x] Compare supported contact/material/path diagnostic summaries before and
|
||||
after restart.
|
||||
- [x] Avoid redesigning the restart format beyond an optional lifecycle block.
|
||||
- [x] Continue one increment after restart to prove the restored state is
|
||||
usable.
|
||||
- Tests:
|
||||
- [x] Extend `restart` to verify lifecycle diagnostics survive an accepted
|
||||
increment restart round trip.
|
||||
- [x] Extend `restart` or add a compact restart-lifecycle test.
|
||||
- [x] Keep the model small and deterministic.
|
||||
- Acceptance:
|
||||
- [x] Restart proves both owned state and lifecycle diagnostics for the
|
||||
covered subset.
|
||||
- [x] Restart audit covers more than one accepted increment without relying
|
||||
on a large benchmark.
|
||||
|
||||
Verified:
|
||||
|
||||
- `ctest --test-dir build-codex-gcc -R "^(restart|nonlinear_lifecycle)$" --output-on-failure`
|
||||
```powershell
|
||||
cmake --build build-codex-gcc --parallel
|
||||
ctest --test-dir build-codex-gcc -R "^restart$" --output-on-failure
|
||||
```
|
||||
|
||||
### [x] TODO 0.6.0-11: Synchronize documentation and API descriptions
|
||||
### [x] TODO 0.6.1-10: Couple solver diagnostics to nonlinear rows
|
||||
|
||||
- Source:
|
||||
- `docs/v6.0_development_plan.md` sections 2, 4 and 6, DOC-1.
|
||||
- `docs/v6.1_development_plan.md` sections 4.10 and 5, NLHD-10.
|
||||
- Implementation:
|
||||
- [x] Update design and algorithm docs with lifecycle levels and event names.
|
||||
- [x] Update interface docs with new lifecycle query/output fields.
|
||||
- [x] Update test plan with 0.6.0 regression commands and acceptance criteria.
|
||||
- [x] Update user/developer manuals with lifecycle boundary and deferred
|
||||
algorithm rewrites.
|
||||
- [x] Link matrix class, solver method, preconditioner, iteration count and
|
||||
solver status into lifecycle or nonlinear report rows.
|
||||
- [x] Include initial/final/relative residual where current solver diagnostics
|
||||
already provide them.
|
||||
- [x] Add a fallback marker for dense pivoting or method fallback paths if
|
||||
available.
|
||||
- [x] Keep solver selection behavior unchanged.
|
||||
- Tests:
|
||||
- [x] Run wording `rg` checks so docs do not claim 0.6.0 delivers complete
|
||||
- [x] Extend `linear_solver_cg` for field availability and naming where
|
||||
needed.
|
||||
- [x] Extend `solver_implicit` to verify nonlinear rows include solver
|
||||
diagnostics.
|
||||
- Acceptance:
|
||||
- [x] A nonlinear failure can be distinguished from a linear solver failure
|
||||
through report/API fields.
|
||||
|
||||
Verified:
|
||||
|
||||
```powershell
|
||||
cmake --build build-codex-gcc --parallel
|
||||
ctest --test-dir build-codex-gcc -R "^(solver_implicit|linear_solver_cg)$" --output-on-failure
|
||||
```
|
||||
|
||||
### [x] TODO 0.6.1-11: Synchronize documentation and benchmark matrix
|
||||
|
||||
- Source:
|
||||
- `docs/v6.1_development_plan.md` sections 4.11 and 5, DOC-1.
|
||||
- Implementation:
|
||||
- [x] Update `docs/v6_benchmark_matrix.md` with 0.6.1 diagnostic tests and
|
||||
evidence placeholders.
|
||||
- [x] Update interface docs with new lifecycle, cutback, contact and solver
|
||||
diagnostic fields.
|
||||
- [x] Update user/developer manuals with the 0.6.1 boundary and deferred
|
||||
algorithm rewrites.
|
||||
- [x] Add or update a 0.6.1 acceptance report section.
|
||||
- Tests:
|
||||
- [x] Run wording `rg` checks so docs do not claim 0.6.1 delivers complete
|
||||
AL/mortar tangent, mixed-control continuation or cohesive mainline.
|
||||
- Acceptance:
|
||||
- [x] Documentation states that 0.6.0 delivers lifecycle foundation and
|
||||
rollback audit, while larger solver rewrites remain follow-up work.
|
||||
- [x] Documentation states that 0.6.1 delivers diagnostic hardening, while
|
||||
larger solver rewrites remain follow-up work.
|
||||
|
||||
Verified:
|
||||
|
||||
- `rg -n "0\\.6\\.0.*(complete industrial AL/mortar|mixed-control continuation|cohesive contact mainline|cohesive mainline|complete AL/mortar|generalized mixed-control)" docs README.md todo.md`
|
||||
- `rg -n "LIFECYCLE_DIAGNOSTICS|lifecycle_event_id|fem_get_nl_lifecycle|0\\.6\\.0 Lifecycle" docs`
|
||||
```powershell
|
||||
rg -n "0\.6\.1.*(complete|完整|industrial|生产一致切线|mixed-control continuation|AL/mortar consistent tangent).*交付|0\.6\.1.*delivers complete|0\.6\.1.*完整 AL|0\.6\.1.*mixed-control" docs
|
||||
rg -n "0\.6\.1|nonlinear_lifecycle.csv|arc_mode|fem_tangent_audit_report|closed-stick|linear_fail_class" docs/v6_benchmark_matrix.md docs/v6_acceptance_report.md docs/07_user_manual.md docs/08_developer_manual.md
|
||||
```
|
||||
|
||||
### [x] TODO 0.6.0-12: Update version, matrix, report and release evidence
|
||||
### [x] TODO 0.6.1-12: Update version, report and release evidence
|
||||
|
||||
- Source:
|
||||
- `docs/v6.0_development_plan.md` section 6, REL-1.
|
||||
- `docs/v6.1_development_plan.md` section 6, REL-1.
|
||||
- Implementation:
|
||||
- [x] Update benchmark/acceptance matrix with 0.6.0 lifecycle tests and
|
||||
diagnostic evidence.
|
||||
- [x] Update acceptance report with 0.6.0 scope, commands and limitations.
|
||||
- [x] Raise project version only when 0.6.0 implementation is ready to close.
|
||||
- [x] Update benchmark/acceptance matrix with final 0.6.1 test evidence.
|
||||
- [x] Update acceptance report with 0.6.1 scope, commands and limitations.
|
||||
- [x] Raise project version only when 0.6.1 implementation is ready to close.
|
||||
- [x] Keep deferred boundaries explicit in release documentation.
|
||||
- Tests:
|
||||
- [x] Run the planned 0.6.0 targeted regression command.
|
||||
- [x] Run the planned 0.6.1 targeted regression command.
|
||||
- [x] Run `ctest --test-dir build-codex-gcc -L v5_acceptance --output-on-failure`.
|
||||
- [x] Run `git diff --check`.
|
||||
- Acceptance:
|
||||
- [x] 0.6.0 closes with green targeted tests, green acceptance subset and
|
||||
- [x] 0.6.1 closes with green targeted tests, green acceptance subset and
|
||||
documented deferred boundaries.
|
||||
|
||||
Verified:
|
||||
|
||||
- `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`
|
||||
|
||||
## Suggested 0.6.0 Regression 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 -R "^(smoke|perf_contact_pair_p1)$" --output-on-failure
|
||||
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 -L v5_acceptance --output-on-failure
|
||||
git diff --check
|
||||
```
|
||||
|
||||
## Suggested 0.6.1 Regression Commands
|
||||
|
||||
```powershell
|
||||
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 -L v5_acceptance --output-on-failure
|
||||
git diff --check
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user