Changelog

0.8.3 — Duplicate Intelligence & CLI Maturity

Feature Expansion Release

Version 0.8.3 expands Pedro’s analysis layer with deterministic duplicate intelligence and a more complete operator-facing CLI.

🧠 Deterministic Duplicate Clustering

• Stable duplicate clusters built from reproducible signals
• Hash + fingerprint correlation
• Transparent cluster membership
• Deterministic cluster ordering

🎯 Advisory Primary Suggestions

• Deterministic primary recommendations
• Configurable policies (lossless, size, container preference)
• Transparent ranking output
• Never automatic — advisory only

📦 Container Detection Improvements

• Hybrid container detection (header + extension)
• More robust duplicate comparisons
• Safer handling of mislabeled files

🧭 CLI Improvements

• pedro dupes stats
• pedro dupes largest
• pedro dupes suggest
• Better schema resilience and migration handling

This release strengthens Pedro’s ability to reason about real-world libraries while preserving its preview-first, deterministic philosophy.

0.8.0 — A Deterministic Music Library Manager Built for Safety

Architecture Release

This release solidifies Pedro’s core architecture and safety model, focusing on predictable and reviewable filesystem operations.

🔒 Deterministic Filesystem Engine

• The same database state always produces the same filesystem result.
• No hidden side effects.
• No silent modifications.
• Every action is computed first and executed in a controlled way.

This makes Pedro especially reliable for large music libraries.

👀 Preview-First Architecture

Before anything touches your filesystem, you can preview exactly what will happen.

pedro preview
pedro preview --limit 10
pedro apply --dry-run

Nothing happens unless you explicitly apply it. Safety is the default.

Schema-Safe Database Migrations

• Automatic, non-destructive schema upgrades
• No full re-scan required
• No data loss
• No manual SQL

🗑 Improved Deletion Safety

• Files are quarantined by default
• Permanent deletion requires explicit confirmation
• Interactive DELETE safeguard
• Lock file prevents concurrent apply operations

🧭 CLI Structure Improvements

• pedro db namespace
• pedro analyze (alias: scan)
• pedro preview
• pedro apply
• pedro version

This release strengthens the foundation before expanding functionality.

0.7.0 — Structural Confidence Release

Version 0.7.0 established the foundational system boundaries that support deterministic operations and operator control.

Added

• Canonical CLI spine
• Configuration backbone
• Persistent active database tracking
• Startup inspection utilities
• Genre management command set
• i18n-aware CLI output

Improved

• Clear separation between analysis and execution
• Database as single source of truth
• Expanded schema evolution safeguards

0.5.0 — Execution Backbone & Lifecycle Model

This release transformed Pedro from an analysis tool into an operational system.

• Initial execution engine
• File lifecycle tracking
• Quarantine-based soft delete
• Expanded metadata support

0.3.0 — Normalization & Signal Foundations

• Canonical normalization pipeline
• Duplicate-detection signals
• Alias relationship views
• Forward-compatible schema upgrades

0.1.0 — Initial Release

• Initial CLI
• SQLite knowledge ingestion
• Metadata extraction
• SHA-256 hashing
• Optional fingerprinting
• Album art discovery
• Safe, non-destructive design