Repository navigation
v0.3.0
Highlights
v0.3.0 turns pvsyst-cli-mcp into an end-to-end AI-autonomous PV engineering MCP server paired with PVsystCLI 8.1.7, spanning zero-template bifacial utility design, deterministic string/inverter sizing, physics anomaly diagnostics, parametric batch sweeps, and 5/10/15/30-minute sub-hourly simulations.
1. Bifacial & Zero-Template Utility 3D Ground Layouts
- Full
pvBiFacialserialization and readback (pvsyst_auto.project.bifacial) with.PANbit-23 ($00800000) preflight verification. - Zero-template
ground_sheds(Sheds) andground_tracker(UnlimTracking/TrackHorizNSAxis) synthesis and execution viapvsyst_simulate_design.
2. AI Autonomy & Guidance Layer
- New
pvsyst_suggest_sizingtool (pvsyst_auto.engineering.suggest) computing deterministic Voc/Vmp temperature bounds, string length (NModSerie), string count (NStringCh), inverter count, and DC/AC ratio from real.PAN+.ONDelectrical parameters. sizing_mode="auto_from_components"inpvsyst_simulate_designfor autonomous sizing directly from selected components.- Built-in MCP server
instructions, 4 reusable workflow prompts (design_rooftop_pv,design_utility_bifacial,diagnose_and_optimize,parametric_sensitivity_sweep), and 2 reference resources (pvsyst://guides/workflow-overview,pvsyst://guides/parameters-reference). - Promoted
pvsyst_license_info,pvsyst_project_handoff, andpvsyst_export_engineering_deliveryinto default tool groups (40 default tools / 69 total withPVSYST_TOOL_GROUPS=all).
3. Physics Result Diagnostics (pvsyst_diagnose_results)
- Single-pass streaming anomaly detector (
pvsyst_auto.engineering.diagnostics) covering PR integrity (monofacial & bifacial ranges), inverter clipping/overvoltage/undervoltage/current/threshold losses, near & electrical shading, soiling, curtailment, storage SOC/unmet load, nighttime export, high-irradiance zero output, and irradiance-vs-output phase lag. - Automatic compact diagnostic summaries embedded into
pvsyst_simulate_design,pvsyst_run_house_task, andpvsyst_run_simulation.
4. Parametric Batch Sweeps & Sub-Hourly Pipeline
- New
pvsyst_run_batch_sweeptool (pvsyst_auto.workflows.batch) executing multi-axis nativeBatchParams.CSVsweeps (tilt, pitch, azimuth, albedo, soiling, tracker limits) with automatic Pareto/optimal ranking. - End-to-end 5 / 10 / 15 / 30 / 60 min sub-hourly weather preparation,
.MEF/.METconversion,build_sfi(..., time_step="subhour"), and annual energy aggregation.
5. Pre-Release Bug Fixes (#191, #192, #193)
- #191: Refused house-task simulation attempts now mark
runs[].status = "failed"in both the returned payload and saved checkpoint manifest; quiet batch runs (log_level0, 1, or 2) now forward redacted native CLI refusal output on missing summary CSV. - #192: Diagnostics calibrated against PVsystCLI 8.1.7 output — apparent (
kVA) grid limits compute and reportactive_dispatch_cap_kw = PLimGrid * cos(phi)without flaggingEApGrid > PLimGrid; variants embeddingPVObject_UserNeeds=pvLoadwith rootpvVCalcul.Flagsbit 19 ($00080000) clear now emitLOAD_NOT_ENABLED; addeddetect_native_refusalhelper and_DEMO_Tracking.VC3clipping calibration test. - #193:
update_project_sourcesnow preserves distinct.METheaders (SiteM,SiteMet,DateDebF,DateFinF,PasAccum, etc.) instead of copying.SITintoSiteMet; headless house tasks now reject non-zeroorientations[].base_slope_deg/BaseSlopeindry_run=Truepreflight before writing any files.
Verification
- Offline CI checks (
scripts/ci_checks.py): 31 / 31 OK - Offline unit & integration suite (
scripts/run_tests.py --suite all): 412 / 412 OK (1 skipped) - Real stdio MCP + PVsystCLI 8.1.7 E2E (
tests.e2e.test_mcp_full_workflows_e2e): 4 / 4 OK