mech-ai/tools/model-diagnostics/ModelDiagnosticVerifier/README.md

ModelDiagnosticVerifier

Verifies product models against rule packages generated by RuleTemplateGenerator.

Responsibility

ModelDiagnosticVerifier handles only model-side diagnosis:

• input: a SolidWorks model path or an existing model evidence JSON
• input: a rule package JSON
• output: not_applicable, pass, problem, or needs_review
• it does not interpret teaching images/text
• it does not invent new rules

Pipeline

SolidWorks model
  -> 3D B-rep / structural raw evidence
  -> section 2D structure instance
  -> scene candidates
  -> rule applicability
  -> image 2D structure template matching
  -> real geometry/contact validation
  -> final diagnosis

Current implementation can consume existing evidence JSON. If a .SLDASM or .SLDPRT is passed, it tries to run:

• tools\model-diagnostics\SectionBrepExtractor: extracts section sketch graph evidence such as edges, relations, dimensions, regions, and semantic roles.
• tools\model-diagnostics\StructuralFaultProbe: extracts assembly structure evidence such as components, axial contacts, bearing limits, and fixation information.

The verifier then normalizes and merges these sources before matching rule templates.

Evidence Discipline

The verifier must not treat "no direct relation matched" as immediate failure. For every pass template it reports:

• model evidence found and missing
• 2D structure relations found and missing
• found, candidate, or missing status

This is important because image templates and model evidence usually do not use identical names. Low-level extractor facts may need explicit promotion before they satisfy a higher-level rule evidence type.

Usage

Verify from an existing evidence JSON:

dotnet run --project tools\model-diagnostics\ModelDiagnosticVerifier\ModelDiagnosticVerifier.csproj -c Release -- verify --model runtime\structural_fault_probe\structural_fault_evidence.json --rules runtime\rule_templates\tight_fit_sleeve_requires_disassembly_access.json --out runtime\diagnostics\sleeve_check

Verify directly from a SolidWorks assembly:

dotnet run --project tools\model-diagnostics\ModelDiagnosticVerifier\ModelDiagnosticVerifier.csproj -c Release -- verify --model "D:\path\assembly.SLDASM" --rules runtime\rule_templates\tight_fit_sleeve_requires_disassembly_access.json --out runtime\diagnostics\sleeve_check

Output:

• <out>.json
• <out>.md