EPIC v0.2.0-beta.0

EPIC v0.2.0-beta.0

This release marks the first public beta of EPIC: Upgrade Intelligence for Solana.
EPIC acts as a deployment safety layer, answering a single, critical question before you sign a migration transaction: "Can I safely deploy this?"

Highlights

• Account Compatibility Engine: Complete simulation of byte shifts, structural alterations, and serialization drifts across Anchor layouts.
• First-class GitHub Action Integration: Natively embeds into CI/CD pipelines to block PRs that would break on-chain state.
• Prebuilt Cross-Platform Binaries: The Rust-based parser is now bundled into the NPM CLI via optional dependencies for seamless installation across macOS, Linux, and Windows.
• Intelligent Upgrades Intelligence: Classification of changes into SAFE, MIGRATION REQUIRED, and BLOCKED states with explicit remediation plans.

What's New

CLI

• Re-architected as a thin integration and rendering wrapper (@solana-epic/cli).
• Improved, human-readable terminal rendering.
• New --format json and --format sarif outputs for programmatic consumption.
• epic doctor safely checks host dependencies.

Parser (@solana-epic/parser)

• A full rewriting of the AST engine in Rust to support recursive nested struct resolution.
• Resolves Rust structs with lifetimes, generics, and complex attribute macros.
• Advanced memory layout mapping logic specifically designed for Anchor's padding and discriminator offsets.

Diff Engine (@solana-epic/diff-engine)

• Tracks precise byte insertions, removals, and dynamic sizing behavior (Vec, String).
• Enforces explicit semantic rules matching Solana deployment mechanics (e.g., rejecting mid-struct field insertions).
• Maps layout drift against security policies defined in epic.toml.

GitHub Action (@solana-epic/github-action)

• Extracted from a monolithic implementation into a clean execution orchestrator.
• Submits PR comments using GITHUB_STEP_SUMMARY.
• Fully supports GitHub Advanced Security via formal SARIF v2.1.0 report generation.

Testing & Confidence

• Extensive historical benchmarks on real-world Solana upgrades (Kamino, Marginfi, Drift, etc.).
• Automated cross-architecture distribution testing.
• Total test coverage of exact on-disk serialization failures.

Known Limitations

• Advanced tracking of PDA derivation logic is not yet fully stabilized.
• Dynamic Vec reallocation limits are approximated when parsing non-static arrays.

Installation

npm install -g @solana-epic/cli@0.2.0-beta.0

Roadmap

• v0.3.0: Dynamic resizing bounds checking and PDA validation.
• v0.4.0: Automated zero-downtime migration scaffolding.
• v1.0.0: Stable release.

EPIC v0.1.0-beta.3

EPIC v0.1.0-beta.3

This release focuses on developer experience, packaging reliability, repository hygiene, and release consistency.

This release completes the EPIC v2 CLI experience and ensures that the repository, npm packages, documentation, and CI pipeline are fully synchronized.

What’s New

Premium CLI Experience

• Redesigned terminal interface with improved typography and formatting.
• Dynamic version reporting (epic --version) sourced directly from the published package.
• New epic doctor command for environment diagnostics.
• Improved help menus and command organization.

Developer Experience

• Updated README with a clearer onboarding flow.
• Added configuration examples for epic.toml.
• Added JSON and SARIF output documentation.
• Improved command documentation and usage examples.

Packaging & Distribution

• Published all platform-specific parser binaries for:
  • macOS (Apple Silicon & Intel)
  • Linux x64
  • Windows x64
• Synchronized all npm packages to v0.1.0-beta.3.
• Fixed package version consistency across the monorepo.

Repository Cleanup

• Removed obsolete development artifacts and temporary files.
• Cleaned .gitignore.
• Consolidated examples and documentation.
• Improved repository structure for contributors.

CI & Reliability

• Fixed cross-platform npm ci issues caused by optional binary dependencies.
• Regenerated a clean, reproducible package-lock.json.
• GitHub Actions now build and test successfully across supported environments.

Packages

• @solana-epic/cli
• @solana-epic/parser
• @solana-epic/diff-engine
• @solana-epic/cli-darwin-arm64
• @solana-epic/cli-darwin-x64
• @solana-epic/cli-linux-x64
• @solana-epic/cli-win32-x64

Installation

npm install -g @solana-epic/cli

Verification

epic --version
epic doctor
epic --help

Thank you to everyone testing EPIC during the beta period. Feedback from this release will guide the roadmap toward the first stable release.

EPIC v0.1.0-beta.1

chore(release): polish package metadata, whitelist files, and prep be…