validate_cobie
Validates a COBie Excel workbook and generates an HTML report with pass/fail counts, returning status and next actions to fix errors. Use after updating COBie data to confirm compliance.
Instructions
Validate a COBie workbook and generate an HTML report.
**Read-only** (writes HTML report to disk only). Use after commit to revalidate.
**Safety:** No confirm_token on server. Client calls this to revalidate after
update_cobie/capture_installation commit.
Args:
excel_path: Path to the COBie Excel file.
Returns:
ValidationToolResult with summary (error/warning counts), html_path,
status (ok|error), provenance, next_actions.
Example:
result = validate_cobie("project.xlsx")
# result.summary = {"total_fail": 0, "total_pass": 12, ...}
# result.html_path = "project.validation.html"
# result.status = "ok" | "error"
# result.next_actions = ["Fix reported rows and re-run validate_cobie.", ...]
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| excel_path | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | ok | |
| summary | Yes | ||
| html_path | Yes | ||
| provenance | Yes | ||
| executed_at | Yes | ||
| next_actions | No |