GitOutbox v0.2.0

GitOutbox v0.2.0

GitOutbox v0.2.0 is an official feature and UX release delivering dedicated Git and Scheduler inspection dashboards, a redesigned user event timeline, structured draft queue lifecycle management, complete Windows desktop settings integration, and a Developer Demo Data Generator tool.

---

✨ Highlights

• Dedicated Git & Scheduler Management: Immediate visibility into installed Git version, executable path, authentication identity, default branch, scheduler status (Running, Paused, Stopped), active queue breakdown, and retry policy.
• Redesigned Activity Stream: High-level event timeline replacing verbose execution logs with readable user-facing events (Repository Added, Draft Created, Scheduled, Executed, Push Completed, Execution Failed).
• Structured Queue Lifecycle: Organizes draft commits into filterable status categories (All, Pending, Scheduled, Executing, Completed, Failed, Skipped, Archived) with batch operations.
• Categorized Windows Settings: 8 structured sections (General, Git, Scheduler, Execution, Notifications, Updates, Advanced, About) with launch-on-startup, minimize-to-tray, and system tray control.
• Icon Artwork & Scroll Container Polish: Scaled transparent icon margins to 92-95% artwork coverage for Windows taskbar and system tray, and added pb-20 bottom padding buffer across all views.

---

🚀 Added

• Git Diagnostic View: View Git version, executable location, authentication user/email, default branch name, and repository scan metrics.
• Scheduler Diagnostic View: View scheduler status indicator, running state, active/pending queues, next execution timer, and retry limits.
• Developer Demo Data Generator: Reusable development utility located in tools/demo-data/ (generate.py / generate.js) for seeding test data with volume presets (small, medium, large).
• Raw System Logs Tab: Dedicated tab in Activity view with level filtering (ALL, INFO, WARNING, ERROR) and copy-to-clipboard functionality.
• Advanced Diagnostics: Open application data folder, open database location, export logs, reset onboarding flow, and clear cache actions in Settings.

---

🎨 Improved

• Queue Drawer Details: Click any draft card to inspect assigned files, fingerprints, branch target, and retry history.
• System Tray Controls: Direct tray menu options to Pause/Resume Scheduler, Open Application, or Quit.
• Visual Hierarchy & Spacing: Unified color tokens, typography scales, badge variants, and bottom padding buffers (pb-20).

---

🐛 Fixed

• Taskbar & Tray Icon Visibility: Replaced oversized padding in icon assets with full-canvas artwork (32x32, 128x128, .ico).
• Card Cut-Off at Bottom: Resolved layout issue where the last item in scrollable lists was partially clipped by adding bottom padding buffers.

GitOutbox v0.1.1

GitOutbox v0.1.1 Patch Release

This release fixes two critical issues discovered during the first real-world overnight execution.

Bug Fixes & Improvements

• Fingerprint Verification Hotfix: Fixed a post-staging verification bug where newly-added (untracked) files were incorrectly classified as modified, causing scheduled commits to abort execution.
• Paused Recovery System: Implemented a comprehensive recovery dashboard for paused scheduled items. You can now Retry, Reschedule, Return to Draft, or Delete paused items individually or in bulk.
• Attention Banner: Added a top-level alert banner on startup to notify you if any scheduled commits require manual review or recovery.

GitOutbox v0.1.0

GitOutbox v0.1.0 Release Notes

Overview

GitOutbox is a local-first, Windows-first desktop Git scheduling utility designed for bursty developers. It allows you to organize and stage files, compose commit messages using dynamic templates, and schedule them to be committed and/or pushed automatically in the background according to your preferred schedule.

---

Highlights

• Durable Local State: Never lose queued items; everything is saved locally in SQLite.
• Strict Safety Contract: Protects your active workspace from accidental checkouts, wildcard staging (git add .), or merge/rebase absorption.
• Seed-based Variable Spacing: Simulates a natural human coding rhythm using deterministic spacing calculations.

---

Major Features

• Draft Commit Management: Create, edit, and delete draft commits before scheduling them.
• Interactive Schedule Composer: Visual configuration panel for setting dates, time windows, intervals, and multi-day allocations.
• Variable Spacing: Uses a seeded Pseudo-Random Number Generator (PRNG) to generate natural gaps.
• Commit templates: local template editor with variable resolutions ({stem}, {directory}, {branch}, etc.) evaluated per-file.
• Durable Activity Log: Audit staged states, preflight successes, commit hashes, and push events.

---

Git Safety

GitOutbox implements a strict, non-destructive safety protocol:

• Explicit Path Staging: stages strictly by assigned path arrays. It never runs glob or wildcard commands.
• Double-Verification Gate: Asserts that files in the Git index match assigned draft files exactly after staging. Reset/rollback is run on any mismatch.
• Workspace Guards: Verification blocks execution if target branch doesn't match workspace branch or if a merge/rebase/cherry-pick/bisect/revert is in progress.
• Stash Protection: Detects pre-staged files in the repository and pauses execution to avoid absorbing active work.
• Fingerprint Protection: Compares SHA-256 content hashes of files before staging; pauses execution on changes.

---

Scheduler

• Exact Mode: Commits at precise user-selected timestamps.
• Interval Mode: Commits spaced out sequentially by a fixed duration.
• Window Mode: Distributes commits within a start and end time window on a target day.
• Multi-Day Mode: Spreads commits across multiple days within daily active windows.

---

Background Execution

• Tick Worker: A background Rust thread checks the SQLite database every 5 seconds.
• Serialization Locks: Restricts repository operations to a single worker execution to avoid concurrent Git conflicts.
• Exponential Backoff: Pushing failures (e.g. network dropouts) trigger up to 3 retries using backoff before transitioning to Paused (marked Needs Review).

---

Installation

To install GitOutbox on Windows:

1. Download the latest installer (.msi or .exe setup) from the Releases page.
2. Run the installer wizard.
3. Launch the application from your Start Menu.

---

Known Limitations

• Staging Resolution: Stages whole files only (no partial hunk or line-by-chunk staging).
• Git Authentication: Uses existing terminal/SSH authentication configurations. Does not collect or manage private credentials.
• Platform: Optimized and packaged exclusively for Windows desktop environments.