Skip to content

STRATEGIES: make the leftover-process entry self-contained - #6

Open
cgoniva wants to merge 1 commit into
mainfrom
strategy_leftover_process_after_crash
Open

cgoniva wants to merge 1 commit into
mainfrom
strategy_leftover_process_after_crash

Conversation

@cgoniva

@cgoniva cgoniva commented Oct 1, 2026

Copy link
Copy Markdown
Member

Summary

Rewrites the strategy "Track the actual launch's PIDs before trusting a coupled run has ended" so it states the fact itself: DEM and CFD are separate OS processes, and when one side aborts the other does not necessarily terminate (in either direction). Check both PIDs (pgrep -a aspherix, pgrep -a cfdemSolver) before restarting or reusing a case's output directories.

Why

The entry cited a note on cfdemSimulate.html about process independence. That note was removed from the documentation at review (CFDEMproject/AspherixCFDEM#1098), so the entry would point at text that no longer exists. Guidance on handling failures belongs in the skill rather than the user docs.

Scope

One entry in references/strategies/STRATEGIES.md (1 line replaced by 2). No new entry: portOffset handling (cfdemSimulate removes the files by default) and portFilePath are already covered by the docs and references/commands/cfdemSimulate.md.

Tests

Skill text only; nothing to run.

Risks

None. The "either direction" statement comes from the #1098 review, not from a reproduction.

Rollout / rollback

Revert the commit.

🤖 Generated with Claude Code

The entry cited a cfdemSimulate doc note that is being removed from the
documentation; state the fact (either side may survive a crash) directly.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@cgoniva
cgoniva requested a review from marniemann October 1, 2026 07:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants