Skip to content

v0.3.0

Choose a tag to compare

@Anonymousnake Anonymousnake released this 19 Nov 11:50
· 81 commits to main since this release

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 pvBiFacial serialization and readback (pvsyst_auto.project.bifacial) with .PAN bit-23 ($00800000) preflight verification.
  • Zero-template ground_sheds (Sheds) and ground_tracker (UnlimTracking / TrackHorizNSAxis) synthesis and execution via pvsyst_simulate_design.

2. AI Autonomy & Guidance Layer

  • New pvsyst_suggest_sizing tool (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 + .OND electrical parameters.
  • sizing_mode="auto_from_components" in pvsyst_simulate_design for 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, and pvsyst_export_engineering_delivery into default tool groups (40 default tools / 69 total with PVSYST_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, and pvsyst_run_simulation.

4. Parametric Batch Sweeps & Sub-Hourly Pipeline

  • New pvsyst_run_batch_sweep tool (pvsyst_auto.workflows.batch) executing multi-axis native BatchParams.CSV sweeps (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/.MET conversion, 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_level 0, 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 report active_dispatch_cap_kw = PLimGrid * cos(phi) without flagging EApGrid > PLimGrid; variants embedding PVObject_UserNeeds=pvLoad with root pvVCalcul.Flags bit 19 ($00080000) clear now emit LOAD_NOT_ENABLED; added detect_native_refusal helper and _DEMO_Tracking.VC3 clipping calibration test.
  • #193: update_project_sources now preserves distinct .MET headers (SiteM, SiteMet, DateDebF, DateFinF, PasAccum, etc.) instead of copying .SIT into SiteMet; headless house tasks now reject non-zero orientations[].base_slope_deg / BaseSlope in dry_run=True preflight 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