feat: add BisonFi override templates

[bakasura980]

BisonFi publishes no IDL and is not an Anchor program, so this adds a raw byte-layout write path guarded by account size and magic, plus four templates on it: price, depth, spread and freshness.

Also introduces optional IDLs on templates, so a program without one no longer needs a reconstructed IDL in the repo.

Greptile Summary

The PR adds IDL-free, guarded raw-byte account overrides and four BisonFi scenario templates.

• Adds exact-size and magic/version validation before raw account writes.
• Supports integer, strided, public-key, and slot-relative raw encodings.
• Registers BisonFi templates without requiring a reconstructed Anchor IDL.
• Adds extensive BisonFi integration coverage and scenario documentation.
• Adds an automated OpenAI review workflow.

Confidence Score: 5/5

The PR appears safe to merge because no blocking failure remains within the eligible follow-up scope.

No blocking failure remains.

Important Files Changed

Filename	Overview
crates/types/src/scenarios.rs	Adds optional template IDLs and guarded raw-layout encoding, validation, and materialization contracts.
crates/core/src/surfnet/svm.rs	Routes raw-layout templates through guarded byte writes while retaining the existing IDL-backed path.
crates/core/src/scenarios/registry.rs	Registers the four BisonFi templates without an IDL and skips IDL registration for IDL-free templates.
crates/core/src/scenarios/protocols/bisonfi/overrides.yaml	Defines the BisonFi account guard and price, depth, spread, and freshness byte layouts.
crates/core/src/tests/bisonfi/mod.rs	Adds broad mainnet-backed validation of BisonFi layouts, guards, writes, and program behavior.
.github/workflows/openai-review.yml	Adds a pull-request workflow that runs Codex and posts its final feedback as an issue comment.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart LR
    S[Scenario override] --> T[Resolve template and account]
    T --> G{Raw layout present?}
    G -->|Yes| V[Validate account size and magic/version]
    V --> E[Encode supplied values]
    E --> W[Write bytes at declared offsets]
    G -->|No| I[Resolve owner IDL]
    I --> D[Decode and update fields]
    D --> W

Loading

_{Reviews (9): Last reviewed commit: "Include the workflow" | Re-trigger Greptile}

Context used (3)

• Knowledge Base — Scenario execution
• Knowledge Base — Shared data contracts
• Knowledge Base — Studio bindings

[github-actions]

• svm.rs:3015: Raw-layout overrides validate size/magic but not account ownership. A caller can target any matching 2,048-byte account, unlike the IDL path which selects by owner program. Include BisonFi’s program ID in RawLayout and reject accounts owned by another program before writing.

[github-actions]

• .github/workflows/openai-review.yml:2: Using pull_request means OPENAI_API_KEY is unavailable for PRs from forks, so the Codex step will fail for external contributors. Add a fork-aware condition or document/use a secure alternative trigger.

Tests couldn’t run because Rustup attempted to write outside the permitted workspace. No other actionable issues found.