# Jiminy Roadmap
> Living checklist for repo maturity. Updated as items are completed.
## Phase A — Harden what exists
| A1 | Rename + tighten `validate_version_compatible` | **Done** | Renamed from `validate_compatible`; view.rs, SAFETY_MODEL.md, ABI_VERSIONING.md, LAYOUT_CONVENTION.md all carry explicit warnings |
| A2 | Compile-time size assertions in `zero_copy_layout!` | **Done** | `const _: () = assert!(size_of == LEN)` already in macro base arm |
| A3 | Verify and document `extends` syntax | **Done** | Macro has extends arm, ABI_VERSIONING.md documents it, LAYOUT_CONVENTION.md has new section |
| A4 | Add padding/identity/authorization language to docs | **Done** | SAFETY_MODEL.md §7 (identity vs auth), §8 (compat weaker), §9 (padding discipline) |
| A5 | Expand tests around tiered loading | **Done** | 61 integration + 13 proptest covering foreign, best-effort, malformed headers, boundary conditions |
| A6 | Expand Miri beyond one test target | **Done** | `cargo miri test -p jiminy-core` now runs full test suite |
| A7 | Doc-example compile gates | Not started | `cargo test --doc -p jiminy-core` — currently all ignored; unblock with `no_run` or mock imports |
## Phase B — Create the standard layer
| B1 | Ship `jiminy-schema` | **Done** | `LayoutManifest`, JSON export, TypeScript decoder codegen, indexer kit |
| B2 | Ship TypeScript decoder package | Not started | Standalone npm package; layout_id verification; standard layout readers |
| B3 | Ship `jiminy-layouts` | **Done** | SPL Token Account, Mint, Multisig overlays with `load_foreign` |
| B4 | Ship cross-program ABI demo | **Done** | `examples/cross-program-read/`, `examples/jiminy-vault/`, `examples/jiminy-escrow/` — cross-program reads, zero deserialization |
| B5 | Ship `jiminy-anchor` | **Done** | Anchor discriminator computation, `check_anchor_disc`, body extraction |
## Phase C — Win adoption
| C1 | Anchor adapter story | **Done** | `jiminy-anchor` crate — "use Anchor for orchestration, Jiminy for hot path + ABI" |
| C2 | Benchmark job in CI | Not started | Reproducible benchmark script; CU regression detection |
| C3 | Enable SBF build in CI | Not started | Blocked on SBF toolchain availability in CI runner |
| C4 | Docs build gate | **Done** | `cargo doc --workspace --no-deps -D warnings` as CI step |
| C5 | Publish reference templates | Not started | Cookiecutters or `cargo generate` templates for vault, escrow, staking |
| C6 | Migration cookbook | **Done** | `docs/MIGRATION_COOKBOOK.md` — pinocchio → Jiminy, Anchor hot-path, version migration, borsh → zero-copy |
## Phase D — Standard status
| D1 | On-chain manifest registry | Design phase | `docs/archive/ON_CHAIN_MANIFEST.md` has the design spec |
| D2 | Explorer/indexer integration | Not started | Depends on B2 (TS decoder) |
| D3 | External audit | Not started | `docs/AUDIT_PREP.md` has the scope and checklist |
| D4 | Unsafe surface inventory doc | Not started | `grep -rn unsafe` + justification review |
## Scorecard
| Core infra | 9.5/10 | 9.5/10 | 9.5/10 | 9.5/10 |
| ABI design | 9/10 | 9/10 | 9/10 | 9/10 |
| Safety posture | 9/10 | 9/10 | 9/10 | 9/10 |
| Docs alignment | 9/10 | 9/10 | 9/10 | 9.5/10 |
| Ecosystem readiness | 9/10 | 9/10 | 9/10 | 9.5/10 |
| Tooling / adoption | 7.5/10 | 7.5/10 | 8/10 | 9/10 |