# COMSOL Automatic 6.4 English — 0.2.1

Version 0.2.1 adds strict specification/report checks, recoverable job metadata, busy/cancellation semantics, reviewer tool exposure, submission caps and offline scientific evidence gates. Read [feedback resolution and remaining gaps](docs/portfolio-feedback.md). New SST physical verification is NOT_RUN.

Closed-loop reconstruction (EvidenceRecord, DecisionRequest, persistent controller, repair/calibration provenance) is **`tested_with_mock`**. It is **not** `tested_with_real_COMSOL`. Do not treat unit-test PASS as physical validation. See [closed-loop controller](docs/closed-loop-controller.md). P3 sensitivity/Bayesian optimization remains **`proposed` / `NOT_IMPLEMENTED`**.

Geometry reliability extension based on commit a012b21bcfd604adb8843f3b0e734478fc13b4a3 of tsuntungngaing-jtn/comsol-automatic. Not an official COMSOL product. Original provenance and licenses are in NOTICE.md and vendor/installed-mcp/LICENSE.

This package contains the skill, MCP adapter, vendored tools, catalog metadata, original teaching source, tests and installation scripts. It contains no commercial COMSOL models, manuals, research results, credentials or Python environment.

On Windows, extract the full folder to a new directory, then run `powershell -ExecutionPolicy Bypass -File scripts/install.ps1`. Register the MCP command using the new folder's `.venv/Scripts/python.exe -m server.main serve --transport stdio` and its working directory. Set COMSOL_OUTPUT_ROOT to your research workspace, not this folder. See docs/connectors.md for details. Existing skills/connectors are not replaced automatically.

Repaired: convective heat-flux API; 6.4 inlet U0in and explicit k-epsilon turbulence inputs; real basic-library material insertion with repeat binding; output containment for version saves; unique version reservation; wheel resources. The executable and package remain named comsol-automatic for compatibility; install them in a dedicated environment. The discoverable skill name is comsol-automatic-6-4-en.

Run `python -m unittest discover -s tests` for Python/protocol checks. Real COMSOL validation must run through MCP. Read docs/validation.md before using results in research. This release is not blanket validation of every upstream physics shortcut.


Geometry reliability additions: explicit property failures and unit-safe primitives; final-entity measurements; named selection contracts and guarded binding; recoverable parameter perturbations; provenance-bearing CAD import; JSON schemas; layered reports; ten benchmark task specifications and four-condition experiment manifests. Start with [geometry workflow](docs/geometry-workflow.md), [selection contracts](docs/selection-contract.md), [benchmarks](benchmarks/README.md) and [actual validation scope](docs/geometry-validation-results.md).

These capabilities do not certify all geometries or simulations. The local 6.4 run retains a failing laminar mass-balance benchmark; complex CAD/contact, mesh convergence and agent ablations remain unverified. Software correctness and scientific correctness are reported separately.