docs: update documentation for version 0.3.0

• Add version 0.3.0 release notes to CHANGELOG
• Consolidate all changeset content into changelog entries
• Improve README formatting with better markdown spacing
• Enhance TESTING.md documentation with clearer formatting
• Document all new features and improvements from changesets

Author: SatanshuMishra

CHANGELOG.md

@@ -1,5 +1,79 @@
 # @labcatr/labcommitr
 
+## 0.3.0
+
+### Minor Changes
+
+- 5b707eb: feat: add body requirement prompt to init command
+  - New prompt in init flow to set commit body as required or optional
+  - "Yes" option marked as recommended for better commit practices
+  - Configuration properly respected in commit prompts
+  - When body is required, commit prompts show "required" and remove "Skip" option
+  - Defaults to optional for backward compatibility
+
+- c435d38: feat: add init command alias and improve help text
+  - Add `i` alias for `init` command for faster access
+  - Update help examples to use `lab` instead of `labcommitr` consistently
+  - Add concise examples showing both full commands and aliases
+  - Add note clarifying both `lab` and `labcommitr` can be used
+  - Update README to document `init|i` alias
+  - Remove duplicate pagination text from preview and revert commands
+  - Improve help text clarity and consistency across all commands
+
+- 5b707eb: feat: add editor support for commit body input
+  - Users can now open their preferred editor for writing commit bodies
+  - Supports both inline and editor input methods
+  - Automatically detects available editors (VS Code, Vim, Nano, etc.)
+  - Improved experience for multi-line commit bodies
+  - Configurable editor preference in configuration files
+
+- 12b99b4: feat: add keyboard shortcuts for faster prompt navigation
+  - Add keyboard shortcuts module with auto-assignment algorithm
+  - Enable shortcuts by default in generated configurations
+  - Generate default shortcut mappings for commit types in init workflow
+  - Implement input interception for single-character shortcut selection
+  - Add shortcuts support to type, preview, and body input prompts
+  - Include shortcuts configuration in advanced section with validation
+  - Support custom shortcut mappings with auto-assignment fallback
+  - Display shortcut hints in prompt labels when enabled
+
+- 8a8d29c: feat: add toggle functionality for body and files in preview
+  - Add toggle state for body and files visibility in commit detail view
+  - Implement `b` key to toggle body visibility on/off
+  - Implement `f` key to toggle files visibility on/off
+  - Reset toggles when viewing new commit or returning to list
+  - Update prompt text to indicate toggle behavior
+  - Fixes issue where pressing `b`/`f` caused repeated rendering
+  - Improves UX by allowing users to hide/show sections as needed
+
+- 5b707eb: feat: enhance commit command user experience
+  - Terminal automatically clears at command start for maximum available space
+  - Improved staged file detection with support for renamed and copied files
+  - Color-coded Git status indicators (A, M, D, R, C) matching Git's default colors
+  - Connector lines added to files and preview displays for better visual flow
+  - More accurate file status reporting with copy detection using -C50 flag
+
+### Patch Changes
+
+- 43df95c: fix: move config existence check before Clef intro animation
+  - Perform early validation before any UI/animation in init command
+  - Check for existing config immediately after project root detection
+  - Only show Clef intro animation if initialization will proceed
+  - Provides better UX by failing fast with clear error message
+  - Prevents unnecessary animation when config already exists
+
+- 5b707eb: fix: prevent label text truncation in prompts
+  - Increased label width from 6 to 7 characters to accommodate longer labels
+  - Fixes issue where "subject" label was being truncated to "subjec"
+  - Applied to both commit and init command prompts for consistency
+  - All labels now properly display full text with centered alignment
+
+- 4597502: fix: exclude subject line from commit body extraction
+  - Split commit message by first blank line to separate subject and body
+  - Only return content after blank line as body in preview command
+  - Prevents subject line from appearing in body section
+  - Fixes incorrect display where commit subject was shown as part of body
+
 ## 0.1.0
 
 ### Minor Changes

README.md

@@ -31,11 +31,13 @@ After installation, use either `labcommitr` or `lab` to run commands.
 ## Quick Start
 
 1. **Initialize configuration** in your project:
+
    ```bash
    lab init
    ```
 
 2. **Create your first commit**:
+
    ```bash
    lab commit
    ```
@@ -52,19 +54,22 @@ After installation, use either `labcommitr` or `lab` to run commands.
 Create a standardized commit following your project's configuration.
 
 **Usage:**
+
 ```bash
 lab commit [options]
 lab c [options]  # Short alias
 ```
 
 **Options:**
+
 - `-t, --type <type>` - Commit type (e.g., `feat`, `fix`, `docs`)
 - `-s, --scope <scope>` - Commit scope (e.g., `api`, `auth`, `ui`)
 - `-m, --message <message>` - Commit subject/message
 - `-b, --body <body>` - Commit body/description
 - `--no-verify` - Bypass Git hooks
 
 **Examples:**
+
 ```bash
 # Interactive commit (prompts for missing fields)
 lab commit
@@ -80,6 +85,7 @@ lab commit -t fix -m "fix bug" --no-verify
 ```
 
 **Notes:**
+
 - Messages and body with spaces must be quoted
 - If all required fields are provided via flags, the commit is created immediately
 - If any required fields are missing, an interactive prompt guides you through completion
@@ -92,16 +98,19 @@ lab commit -t fix -m "fix bug" --no-verify
 Initialize Labcommitr configuration in your project. This creates a `.labcommitr.config.yaml` file with your chosen preset and preferences.
 
 **Usage:**
+
 ```bash
 lab init [options]
 lab i [options]  # Short alias
 ```
 
 **Options:**
+
 - `-f, --force` - Overwrite existing configuration file
 - `--preset <type>` - Use a specific preset without prompts (options: `conventional`, `gitmoji`, `angular`, `minimal`)
 
 **Examples:**
+
 ```bash
 # Interactive setup (recommended)
 lab init
@@ -114,13 +123,15 @@ lab init --preset conventional
 ```
 
 **What it does:**
+
 - Guides you through selecting a commit convention preset
 - Configures emoji support based on terminal capabilities
 - Sets up auto-staging preferences
 - Generates `.labcommitr.config.yaml` with default shortcuts enabled
 - Validates the generated configuration
 
 **Presets available:**
+
 - **Conventional Commits** - Popular across open-source and personal projects
 - **Angular Convention** - Strict format used by Angular and enterprise teams (includes `perf`, `build`, `ci` types)
 - **Gitmoji** - Emoji-based commits for visual clarity
@@ -133,6 +144,7 @@ lab init --preset conventional
 Manage and inspect Labcommitr configuration.
 
 **Usage:**
+
 ```bash
 lab config <subcommand>
 ```
@@ -144,14 +156,17 @@ lab config <subcommand>
 Display the currently loaded configuration with source information.
 
 **Usage:**
+
 ```bash
 lab config show [options]
 ```
 
 **Options:**
+
 - `-p, --path <path>` - Start configuration search from a specific directory
 
 **Examples:**
+
 ```bash
 # Show current configuration
 lab config show
@@ -161,6 +176,7 @@ lab config show --path /path/to/project
 ```
 
 **What it shows:**
+
 - Configuration source (file path or "defaults")
 - Emoji mode status
 - Full configuration in JSON format
@@ -173,15 +189,18 @@ lab config show --path /path/to/project
 Browse and inspect commit history interactively without modifying your repository.
 
 **Usage:**
+
 ```bash
 lab preview [options]
 ```
 
 **Options:**
+
 - `-l, --limit <number>` - Maximum commits to fetch (default: 50, max: 100)
 - `-b, --branch <branch>` - Branch to preview (default: current branch)
 
 **Examples:**
+
 ```bash
 # Browse commits on current branch
 lab preview
@@ -194,6 +213,7 @@ lab preview --limit 25
 ```
 
 **Interactive Features:**
+
 - **Commit List View:**
   - Navigate through commits with pagination (10 per page)
   - Press `0-9` to view details of a specific commit
@@ -211,6 +231,7 @@ lab preview --limit 25
   - Press `?` for help
 
 **Notes:**
+
 - Read-only operation - does not modify your repository
 - Fetches commits in batches of 50 (up to 100 total)
 - Works on current branch by default
@@ -223,18 +244,21 @@ lab preview --limit 25
 Revert a commit using the project's commit workflow. Select a commit interactively and create a revert commit following your project's commit message format.
 
 **Usage:**
+
 ```bash
 lab revert [options]
 ```
 
 **Options:**
+
 - `-l, --limit <number>` - Maximum commits to fetch (default: 50, max: 100)
 - `-b, --branch <branch>` - Branch to revert from (default: current branch)
 - `--no-edit` - Skip commit message editing (use Git's default revert message)
 - `--continue` - Continue revert after conflict resolution
 - `--abort` - Abort revert in progress
 
 **Examples:**
+
 ```bash
 # Interactive revert (uses commit workflow)
 lab revert
@@ -253,6 +277,7 @@ lab revert --abort
 ```
 
 **Interactive Features:**
+
 - **Commit Selection:**
   - Browse commits with pagination (10 per page)
   - Press `0-9` to select a commit to revert
@@ -268,6 +293,7 @@ lab revert --abort
   - Handles conflicts with `--continue` and `--abort` options
 
 **Notes:**
+
 - Requires `.labcommitr.config.yaml` (unless using `--no-edit`)
 - Creates a new commit that undoes the selected commit
 - For merge commits, you'll be prompted to select which parent to revert to
@@ -288,6 +314,7 @@ Labcommitr uses a `.labcommitr.config.yaml` file in your project root. The confi
 See [`docs/CONFIG_SCHEMA.md`](docs/CONFIG_SCHEMA.md) for complete configuration documentation.
 
 **Configuration discovery:**
+
 - Searches from current directory up to project root
 - Uses sensible defaults if no configuration found
 - Global configuration support is planned for future releases (see [Planned Features](#planned-features))
@@ -322,19 +349,22 @@ pnpm run dev:cli test clean
 ```
 
 **Alternative:** You can also use `node dist/index-dev.js` instead of `pnpm run dev:cli`:
+
 ```bash
 node dist/index-dev.js test setup
 node dist/index-dev.js test shell
 ```
 
 **Available Scenarios:**
+
 - `existing-project` - Test adding Labcommitr to existing project
 - `with-changes` - Test commit command with various file states (default)
 - `with-history` - Test preview and revert with rich history
 - `with-merge` - Test revert with merge commits
 - `with-conflicts` - Test conflict resolution workflows
 
 **Examples:**
+
 ```bash
 # Set up specific scenario
 pnpm run dev:cli test setup --scenario with-history
@@ -391,11 +421,13 @@ Support for user-level global configuration files to enable consistent commit co
 - Override global settings on a per-project basis when needed
 
 **Use cases:**
+
 - Developers working across multiple repositories who want consistent commit message formats
 - Teams that want to standardize commit conventions organization-wide
 - Personal projects where you want the same commit types everywhere
 
 The global configuration will be stored in OS-specific locations:
+
 - **macOS/Linux**: `~/.labcommitr.config.yaml` or XDG config directory
 - **Windows**: `%USERPROFILE%\.labcommitr.config.yaml` or AppData directory