vise

Imported from juic3b0x/vise (AGENTS.md). Install upstream with npx skills add juic3b0x/vise. Copyright stays with the author.

AGENTS.md — Vise Core Directive

Project Overview

Vise is a high-performance, industrial-grade Rust download manager engineered for raw speed, high concurrency, and bulletproof crash recovery. No filler, no toy scripts, no bloat.

Tech Stack Mandates

• Language: Rust (stable, latest edition)
• Async Runtime: Tokio
• HTTP Client: Reqwest (chunked streaming)
• WebUI Backend: Axum
• State Persistence: Embedded SQLite (WAL mode, atomic transactions via rusqlite / sqlx)
• CLI Progress: Indicatif

Engineering Standards

1. Zero Bloat: Do not pull in heavy third-party dependency crates unless it's strictly necessary. Keep the binary lean and mean.
2. Crash-Resistant State: All download progress and chunk offsets must commit atomically to SQLite. Never trust fragile flat-file tracking.
3. Strict Linting & Testing:
   • Code must compile clean with zero warnings.
   • Must pass cargo clippy with zero complaints.
   • All tests (cargo test) must pass green before any feature is marked done.
4. Clean Architecture: Keep the core async download engine strictly decoupled from the CLI event loop and the Axum WebUI telemetry bridge.

Commit Message Convention

Use conventional commit prefixes enclosed in parentheses:

• feat(scope): description
• fix(scope): description
• refactor(scope): description
• test(scope): description

Release Preparation

• Follow Semantic Versioning 2.0.0 when deciding Vise version changes.
• Before every major or minor release, run a compatible cargo update without widening dependency requirements. Preserve the declared MSRV, review the lockfile, and validate with the minimum Rust toolchain and current stable, including full tests, Clippy, builds, and installation checks.
• Skip automatic dependency refreshes for patch releases.
• For commit-worthy changes, update relevant documentation/changelog and provide a conventional commit message and pull-request commands. Use branch names without a codex/ prefix.

Rust Doctor Audits

Always pass --rule rust_doctor::cargo::duplicate_major_versions=off when running Rust Doctor. Use this command from the repository root:

rust-doctor . --yes --rule rust_doctor::cargo::duplicate_major_versions=off