# Pinoc Roadmap
> Vision:
>
> Become the **Foundry of Pinocchio** — the complete developer toolkit for building, testing, deploying, debugging, and maintaining Solana programs written with Pinocchio.
---
# Phase 1 — Foundation (v0.2)
Goal:
Make Pinoc the obvious CLI every Pinocchio developer installs.
## Project Templates
- [ ] Multiple project templates
- basic
- minimal
- token
- escrow
- vault
- multisig
- staking
Example
```bash
pinoc new escrow
pinoc new token
```
---
## Better Init Experience
- [ ] Interactive project creation
- [ ] Choose template
- [ ] Choose cluster
- [ ] Choose testing framework
- [ ] Choose git initialization
---
## Doctor
```bash
pinoc doctor
```
Checks
- Rust
- Solana CLI
- Cargo
- Wallet
- BPF target
- Program ID
- Cluster
- Pinoc.toml
- Git
Can automatically fix simple issues.
---
## Config Improvements
Support
```toml
[provider]
cluster = "devnet"
wallet = "~/.config/solana/id.json"
[build]
release = true
[test]
framework = "mollusk"
[program]
name = "vault"
```
---
# Phase 2 — Better Development (v0.3)
Goal:
Replace dozens of shell scripts developers write.
## Validator Management
```bash
pinoc local up
pinoc local stop
pinoc local reset
pinoc local logs
```
---
## Better Build
```bash
pinoc build --release
pinoc build --features xyz
pinoc build --timings
```
---
## Better Testing
```bash
pinoc test
pinoc test initialize
pinoc test --watch
pinoc test --coverage
```
Support
- LiteSVM
- Mollusk
- Local validator
---
## Logs
```bash
pinoc logs
pinoc logs --program
pinoc logs --follow
```
---
## Explorer
```bash
pinoc explorer
pinoc explorer <tx>
pinoc explorer <account>
```
Automatically opens browser.
---
# Phase 3 — Deployment (v0.4)
Goal:
Best deployment experience in Solana.
## Deploy
```bash
pinoc deploy
pinoc deploy devnet
pinoc deploy mainnet
```
Features
- confirmation
- retries
- progress
- wallet checks
---
## Upgrade
```bash
pinoc upgrade
```
---
## Verify
```bash
pinoc verify
```
Checks
- deployed program
- binary hash
- upgrade authority
- Program ID
---
## Accounts
```bash
pinoc account
pinoc account decode
pinoc account inspect
```
---
## Program Info
```bash
pinoc info
```
Shows
- Program ID
- Upgrade authority
- Cluster
- Balance
- Deployment slot
- Binary size
---
# Phase 4 — Code Generation (v0.5)
Goal:
Generate everything.
## Client Generation
Integrate Codama.
```bash
pinoc client generate
```
Generate
- Rust
- TypeScript
- Python
---
## Instruction Generator
```bash
pinoc generate instruction initialize
```
Creates
- instruction
- tests
- state
- errors
---
## Account Generator
```bash
pinoc generate account Vault
```
---
## Error Generator
```bash
pinoc generate error
```
---
## IDL
```bash
pinoc idl
```
Generate
- Codama
- JSON
- Documentation
---
# Phase 5 — Package Ecosystem (v0.6)
Goal:
Become Cargo for Pinocchio.
## Registry
```bash
pinoc search
pinoc add
```
Improve with
- versions
- docs
- examples
- ratings
---
## Official Packages
Examples
```bash
pinoc add token
pinoc add metadata
pinoc add ata
pinoc add system
pinoc add memo
```
Automatically
- edits Cargo.toml
- downloads examples
- updates imports
---
## Package Templates
```bash
pinoc add vault-sdk
```
---
# Phase 6 — Debugging (v0.7)
Goal:
Better debugging than Anchor.
## Simulate
```bash
pinoc simulate
```
---
## Trace
```bash
pinoc trace
```
Instruction execution trace.
---
## Compute Units
```bash
pinoc profile
```
Shows
- CU usage
- CPI depth
- allocations
---
## Account Diff
```bash
pinoc diff
```
Before vs after execution.
---
# Phase 7 — Security (v0.8)
Goal:
Catch mistakes before deployment.
## Audit
```bash
pinoc audit
```
Checks
- signer validation
- PDA bumps
- overflow
- authority
- rent
- ownership
---
## Lints
```bash
pinoc lint
```
Pinocchio-specific lints.
---
## Fuzz
```bash
pinoc fuzz
```
---
## Benchmarks
```bash
pinoc bench
```
---
# Phase 8 — Developer Experience (v0.9)
Goal:
The nicest CLI in crypto.
## Shell Completion
- Bash
- Fish
- Zsh
- PowerShell
---
## Update Command
```bash
pinoc update
```
---
## Self Diagnostics
```bash
pinoc doctor --fix
```
---
## Interactive UI
Nice terminal
- progress bars
- colors
- spinners
- tables
---
## Better Errors
Actionable suggestions.
Example
Instead of
> Build failed.
Show
```
Program ID mismatch.
Run:
pinoc keys sync
```
---
# Phase 9 — 1.0
Goal:
Production-ready ecosystem.
## Plugins
```bash
pinoc plugin install xyz
```
---
## Extension API
Third-party commands.
---
## Marketplace
Community plugins.
---
## Remote Templates
```bash
pinoc new github:user/template
```
---
## Telemetry (optional)
Anonymous usage statistics.
---
# Long-Term Vision
Pinoc should become the command developers instinctively reach for when building with Pinocchio.
Instead of:
cargo build
solana program deploy
cargo test
cargo add
codama ...
mollusk ...
solana logs ...
solana-keygen ...
Developers should simply use:
pinoc build
pinoc deploy
pinoc test
pinoc client
pinoc doctor
pinoc profile
pinoc audit
pinoc local
pinoc generate
One CLI.
Entire workflow.