fix: mkdocs description + staged error handling in plot() (#56, #50)

[tschm]

Addresses three quality issues.

#56 — Replace placeholder mkdocs site_description

mkdocs.yml carried the scaffold placeholder Add your description here.. Set it to the real description already present in pyproject.toml (single source of truth):

High-performance financial charting library for OHLC data visualization with technical indicators

#50 — Narrow broad except Exception in plot()

The plot() body was wrapped in a single broad except Exception, collapsing input-validation failures and server/runtime failures into one generic error. Split into:

• except DataValidationError → {"status": "error", "stage": "validation", ...} — fixable by correcting input arrays.
• except Exception → {"status": "error", "stage": "server", ...} — server startup / browser / runtime failures.

The error key is preserved for backward compatibility. test_plot_with_invalid_data now asserts stage == "validation".

#54 — Failing test_websocket_endpoint_added

The test already carries the defensive getattr(route, "path", None) guard and passes; closing that issue separately as already-fixed.

Verification

Full suite: 94 passed, exit 0.

Closes #56
Closes #50

🤖 Generated with Claude Code

[Copilot]

Pull request overview

This PR improves project metadata and makes the Python plot() API’s error reporting more actionable by distinguishing user-fixable input validation failures from server/runtime failures.

Changes:

• Replaces the MkDocs scaffold placeholder site_description with the real project description (matching pyproject.toml).
• Splits plot() error handling into DataValidationError vs generic runtime errors and annotates error results with a stage.
• Updates the invalid-data plot test to assert stage == "validation".

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File	Description
mkdocs.yml	Replaces placeholder site_description with the real project description for published docs metadata.
src/pycharting/api/interface.py	Adds staged error handling to plot() by catching DataValidationError separately and returning stage in error results.
tests/pycharting/api/test_interface.py	Tightens the invalid-data test to verify validation errors are surfaced with stage: "validation".

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[tschm]

Merged into #58

The commits on this branch (fix-issues-56-54-50) have been merged into #58 (fix-test-layout-55), so that PR now also carries these fixes:

• Replace placeholder mkdocs site_description with real project description #56 — real mkdocs site_description (from pyproject.toml)
• Narrow broad except Exception in plot() #50 — staged error handling in plot() (stage="validation" vs stage="server")
• Fix failing test test_websocket_endpoint_added (fragile assertion on router internals) #54 — test_websocket_endpoint_added confirmed already fixed

No conflicts on merge. #58 supersedes this PR — recommend closing this one in favour of #58 (or merging #57 first, then #58).

🤖 Generated with Claude Code