Summary

This release completes Phase 1 of the roadmap, transitioning Git Pulsar from a strict background daemon into an interactive co-pilot. It also introduces major upgrades to the configuration engine, fundamentally redesigns our testing architecture for distributed state capture, and cleanly separates environment scaffolding into a dedicated tool.

Interactive State Negotiations

• Smart Restore: git pulsar restore now utilizes an interactive state machine when encountering dirty files in the working directory, allowing you to inspect diffs or cancel before applying destructive overwrites.
• Pre-Flight Finalize Checklist: git pulsar finalize intercepts the octopus squash execution pipeline to aggregate diff statistics (diff --shortstat) across all remote machine streams, rendering a deterministic summary table before mutating the primary branch history.

Configuration Engine Overhaul

• Human-Readable Parameters: The configuration parser now accepts human-readable strings for time intervals (e.g., "10m", "1hr") and resource limits (e.g., "100mb", "1gb") with robust fallback logic.
• Schema Introspection: Running git pulsar config --list directly outputs a comprehensive table detailing all available configuration sections, keys, types, and defaults.
• Strict Boundary Enforcement: Added a manage_gitignore boolean to FilesConfig, giving users the ability to explicitly block the daemon from appending state data to project .gitignore files.

Interface & CLI Refinements

• Signal-to-Noise Reduction: A custom argparse.HelpFormatter subclass now intercepts CLI rendering to suppress default container artifacts and cluster subcommands into logical groups (Backup Management, Repository Control, etc.).
• Dynamic Metadata: Introduced a --version flag that dynamically resolves package data via importlib.metadata.
• Documentation Compliance: Enforced Google-style docstrings globally via ruff pydocstyle rules and bumped pre-commit hooks.

Separation of Concerns: Protostar

• Scaffolding Extraction: The --env global flag and its associated environment bootstrapping logic (uv, direnv, IDE settings) have been entirely excised from the Pulsar codebase.
• Migration: Project scaffolding is fundamentally distinct from version control. This logic has been expanded and relocated to a vertically integrated CLI tool: Protostar.

Diagnostics & CI/CD Infrastructure

• Three-Tiered Sandbox Testing: Deployed a highly isolated testing architecture. Tier 2 simulates distributed node synchronization via localized bare remotes, while Tier 3 automates ephemeral Ubuntu VMs (Canonical Multipass) to validate OS-level daemon integrations (systemd, sysfs) without contaminating the host filesystem.
• Telemetry Integration: Integrated Codecov into the GitHub Actions pipeline, establishing a defined baseline with strict degradation thresholds for automated PR analysis.
• Native Dependency Syncing: Rewrote the CD pipeline to utilize PyPI source distributions (SDist) and Homebrew's native brew update-python-resources, ensuring deterministic synchronization of the dependency graph without relying on regex matchers.