[KageRyo]

Summary

The first recorded equity previously became the initial drawdown peak, so a first loss from starting capital 1.0 to 0.8 followed by recovery incorrectly reported zero drawdown. Include 1.0 only in the drawdown calculation input; that example now reports -20%.

Public equity-curve points and timestamps, serialized result fields, returns, Sharpe samples, and trade/signal counts retain their contracts. Document the initial reference and negative-or-zero sign convention in both READMEs and the backtesting guide.

Closes #65.

Validation

• First-loss/recovery and consecutive-loss regressions failed before the fix, then passed; later peak-to-trough and neutral cases also pass.
• Full suite: 131 passed; coverage83.65% (required80%). Compatibility assertions cover other metrics, timestamps, and public result keys.
• Wheel/sdist build and strict Twine checks passed.
• ruff check .
• ruff format --check .
• pyright
• pytest

Checklist

• Branch follows feature/<issue>-<description>.
• No credentials, .env files, or generated market data were committed.
• English and 正體中文 documentation are aligned.
• Outputs remain clearly labelled as informational, not financial advice.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud