Final archive release – project deprecated, superseded by vultool

⚠️ Archived: This project is no longer maintained

This is the final and only release of vultitool-poc-py.
Development has stopped and the project is now archived for posterity.

What’s next?

• Future work and support have moved to vultool

Why archive?

• This repo served as a proof-of-concept and technical reference for understanding Vultisig .vult files.
• The code and docs are preserved for educational and historical purposes.
• All new development is happening in vultool, with improved architecture and support.

Thank you!

To everyone who explored, contributed, or learned from this project—please use vultool for the latest features and ongoing improvements.

---

Status: Archived, read-only.
For all future development: vultool →

v0.3.7 - CI/CD & Developer Experience

[v0.3.7] - 2025-07-24 🏷️ Brand Consistency & Protobuf Version Management

Added

• Comprehensive pre-commit validation system: New scripts/pre-commit-check.sh with quick and full clean-slate testing modes
• Automatic protobuf version management: New scripts/setup-protobuf.py detects protoc compiler version and installs matching Python protobuf library
• Intelligent cross-platform setup: make setup-protobuf handles version compatibility across macOS, Linux, and WSL automatically
• CI/CD-ready infrastructure: Pre-commit hooks and automated validation for professional development workflows
• CLI help flags: Added vultitool help and --help options for comprehensive usage information
• Enhanced macOS bootstrap: bootstrap-macos.sh provides streamlined Quick Start installation experience

Fixed

• CRITICAL: Eliminated protobuf version warnings permanently: Pinned protobuf==5.29.3 in requirements.txt to match generated protobuf files (resolves "Protobuf gencode version 5.29.3 is exactly one major version older than runtime version 6.31.1" warnings)
• Pre-commit validation reliability: Fixed naming convention checks to avoid false positives in validation scripts themselves
• Build system robustness: Clean-slate validation now passes 100% reliably with proper dependency management
• Standardized naming conventions: Corrected "VultiTool" → "vultitool" (lowercase) and "VultIsig" → "Vultisig" (title case) throughout entire codebase
• Cross-platform protobuf compatibility: Automatic version detection works with different protoc versions (macOS Homebrew, Ubuntu packages, WSL environments)

Changed

• Professional branding consistency: All CLI output, documentation, and code comments now use standardized naming conventions
• Improved build system messaging: Makefile targets display consistent lowercase "vultitool" branding
• Enhanced setup workflow: make setup now includes automatic protobuf version alignment for seamless developer experience

Technical

• Version mapping system: Intelligent protoc-to-Python-protobuf version mapping ensures compatibility across platforms
• Flexible requirements: Updated requirements.txt to support automatic version detection while maintaining compatibility
• Synchronized documentation: All naming conventions aligned across Python, Go, shell scripts, and documentation

v0.3.5 - Canonical Public Release: Official Vultisig Integration, Tooling, and Docs

This release marks the first fully public and production-ready launch of vultitool with official Vultisig integration and robust developer tooling.

---

Highlights

• Canonical Vultisig Integration
  Now sources protobuf and cryptographic dependencies directly from the official Vultisig ecosystem for 100% compatibility.

• Enhanced Developer Tooling
  New verification and health-check commands, unified Python and Go components, and a robust, user-friendly CLI.

• Version Management
  Automated VERSION file aligns CLI versioning with Git tags for reliable tracking and reproducible builds.

• Build & Dependency Improvements
  Makefile refactored for easy setup, building, and cross-platform use; Go modules and Python dependencies fully updated.

• Comprehensive Documentation
  All documentation (README.md, CHANGELOG.md, spec.md) updated for developer onboarding, integration, and advanced usage.

---

🛠️ Technical Improvements

• Added verify.go for advanced vault validation
• Expanded doctor.py diagnostics and CLI doctor commands
• Improved .gitignore to exclude build artifacts and binaries
• Refactored Makefile with enhanced build/test targets
• Updated Go modules (go.mod, go.sum) for official commondata
• Enhanced vultitool.py for smoother Python CLI experience

---

📝 Docs & Changelog

• Full CHANGELOG.md with all notable changes
• Detailed README.md with new setup instructions and usage examples
• Updated spec.md outlining project goals and roadmap

---

This release is the official "hello world" for vultitool—ready for real-world use, developer onboarding, and production integration.