peridigm-evidence-fracture
Peridigm evidence workflow
The AI client supplies language understanding. The deterministic core supplies context state, compilation, execution and checks; neither silently invokes another model nor treats a successful process as physical validation.
Clarify and confirm
- Call
peridigm_doctorandperidigm_templatesbefore promising a supported simulation. - Call
peridigm_start_context(request, actor)with the actual request. Retain itsrun_id. - Ask the returned questions, grouping at most three important questions per turn. Distinguish missing facts from facts inferable from an explicitly accepted template. Do not invent steel, concrete, damage or contact parameters.
- Pass the actual answer to
peridigm_answer_context. Selectingcompression-two-point-v1ornotched-tension-damage-v1returns its complete synthetic parameters and confirmation hash. Record whether confirmation comes from the human or an AI operator acting within explicit delegation; never label a scripted test or operator answer as a human response. - Submit the returned
confirm_spec_sha256only after review. If the user changes the problem, start a new specification. Preserve the old one.
For CLI use pd-agent start --json '{"request":"..."}', then answer, validate, submit, status, log, repair, collect, and report. CLI and MCP share core.py. The project-local launcher sets the machine config; do not embed server paths or credentials in reusable instructions.
Execute and diagnose
peridigm_validate checks the frozen specification and exact compiled input. peridigm_submit launches a bounded detached worker. Query the same run after client disconnection; never restart just because observation timed out. Cancel only the recorded job with peridigm_cancel.
Use logs to distinguish dependency, syntax, field/node-set, numerical and physical-semantic errors. peridigm_repair only regenerates an invalid deck from an unchanged frozen spec, retaining the previous file and diff. It stops after three attempts. It does not tune constitutive laws, damage, boundaries, velocity or physical end time to force success.