Skip to content

docs(strategies): align delta-neutral config and metrics - #1228

Merged
collinsezedike merged 1 commit into
drydocs:mainfrom
maxx-GENIUS:docs/align-delta-neutral-strategy-config-and-metrics
Oct 25, 2026
Merged

collinsezedike merged 1 commit into
drydocs:mainfrom
maxx-GENIUS:docs/align-delta-neutral-strategy-config-and-metrics

Conversation

@maxx-GENIUS

@maxx-GENIUS maxx-GENIUS commented Oct 25, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Aligns apps/docs/strategies/delta-neutral.md with the underlying DeltaNeutralConfig interface and RunReport metrics structure as audited in #1142.

Key Changes

  1. Configuration Table (DeltaNeutralConfig):
    • Replaced placeholder names with actual DeltaNeutralConfig properties: asset, targetLeverage, rebalanceBandBps, fundingRate, priceFeed, hedgeFeed, hedgeVenue, and id.
    • Clarified that parameters like initialCapitalQuote belong to the backtest Scenario configuration rather than the strategy options.
  2. Run Summary Table (RunReport):
    • Documented actual metrics exposed on RunReport: riskMetrics.maxDrawdown, riskMetrics.sharpeProxy, riskMetrics.volatility, eventCounts.rebalances, and finalState.totalValue.
    • Marked strategy-level attribution metrics (netPnl, carryPnl, pricePnl, maxNetDeltaBps, withinNeutralityBand) as planned analytical metrics.

Verification

  • pnpm --filter @meridian/strategies test: 38 test files, 749/749 tests passed.
  • pnpm --filter @meridian/strategies typecheck: Passed cleanly with 0 type errors.
  • pnpm --filter @meridian/docs build: VitePress build completed successfully with 0 errors.
  • pnpm prettier --check apps/docs/strategies/delta-neutral.md: Clean formatting verified.

Closes #1142

@vercel

vercel Bot commented Oct 25, 2026

Copy link
Copy Markdown

@maxx-GENIUS is attempting to deploy a commit to the Collins' projects Team on Vercel.

A member of the Team first needs to authorize it.

@collinsezedike collinsezedike left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@maxx-GENIUS, thank you for the work on this. Two items need changes before this can merge.

The commit header is 76 characters, over the 72-character limit in commitlint.config.mjs, which is why Commit Messages fails. Shorten it to 72 characters or fewer.

Comment thread apps/docs/strategies/delta-neutral.md Outdated
| `hedgeVenue` | Optional modeled hedge execution venue | `HedgeVenue` (optional) |
| `id` | Optional stable identifier recorded in the snapshot | String (optional) |

Scenario-level parameters (e.g. `initialCapitalQuote`, time steps, and seeds)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

initialCapitalQuote is not a scenario field. ScenarioSchema uses startingCapital, and no initialCapitalQuote property exists in the source. Replace it with startingCapital.

@maxx-GENIUS maxx-GENIUS Oct 25, 2026 •

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated! Replaced initialCapitalQuote with startingCapital to align with ScenarioSchema.

- Update DeltaNeutralConfig options table with actual interface properties (asset, targetLeverage, rebalanceBandBps, fundingRate, priceFeed, hedgeFeed, hedgeVenue)
- Align RunReport metrics table to document exposed report metrics (riskMetrics, eventCounts, finalState) and clearly mark unexposed attribution metrics as planned
- Clarify scenario-level parameters (startingCapital, time steps, seeds) versus strategy configuration

Closes drydocs#1142
@maxx-GENIUS
maxx-GENIUS force-pushed the docs/align-delta-neutral-strategy-config-and-metrics branch from bdb5916 to 5f48b0a Compare October 25, 2026 19:25
@maxx-GENIUS maxx-GENIUS changed the title docs(strategies): align delta-neutral config and metrics with implementation docs(strategies): align delta-neutral config and metrics Oct 25, 2026
@maxx-GENIUS

maxx-GENIUS commented Oct 25, 2026 •

Copy link
Copy Markdown
Contributor Author

@collinsezedike Thanks for the review! I have addressed both items:

  1. Commit message length: Shortened the commit header to docs(strategies): align delta-neutral config and metrics (56 characters, well within the 72-char limit in commitlint.config.mjs).
  2. Scenario property: Replaced initialCapitalQuote with startingCapital in apps/docs/strategies/delta-neutral.md matching ScenarioSchema.

All 749 unit/integration tests and typecheck pass locally.

@collinsezedike collinsezedike left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@maxx-GENIUS Thank you for the update. The docs now match the current implementation and CI is green. Please pick up another open issue when you have time.

@collinsezedike
collinsezedike merged commit 1616721 into drydocs:main Oct 25, 2026
11 of 12 checks passed
@collinsezedike

Copy link
Copy Markdown
Collaborator

Thank you for starring the repository, @maxx-GENIUS.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Docs] delta-neutral.md documents config options and metrics that do not exist

2 participants