diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index 9e86e68..c7ee1fc 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -1,4 +1,4 @@
-<!-- 
+<!--
 Thanks for contributing!
 PLEASE:
 - Read our contributing guidelines: https://github.com/gurock/trcli/blob/main/CONTRIBUTING.md
@@ -11,10 +11,10 @@ PLEASE:
 How are we solving the problem?
 
 ### Changes
-What changes where made?
+What changes were made?
 
 ### Potential impacts
-What could potentially be affected by the implemented changes? 
+What could potentially be affected by the implemented changes?
 
 ### Steps to test
 Happy path to test implemented scenario
diff --git a/.github/workflows/pr-checklist.yml b/.github/workflows/pr-checklist.yml
new file mode 100644
index 0000000..d4cc0ed
--- /dev/null
+++ b/.github/workflows/pr-checklist.yml
@@ -0,0 +1,176 @@
+name: PR Checklist Enforcement
+
+on:
+  pull_request:
+    types: [opened, edited, synchronize, reopened]
+  pull_request_review:
+    types: [submitted]
+
+permissions:
+  pull-requests: write
+  contents: read
+  checks: write
+
+jobs:
+  check-pr-requirements:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Check PR checklist completion
+        id: checklist
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const prBody = context.payload.pull_request.body || '';
+
+            // Count checked and unchecked items
+            const checkedItems = (prBody.match(/- \[x\]/gi) || []).length;
+            const uncheckedItems = (prBody.match(/- \[ \]/gi) || []).length;
+            const totalItems = checkedItems + uncheckedItems;
+
+            // Check specific required items
+            const hasIssueReference = /Issue being resolved.*https?:\/\//.test(prBody);
+            const hasSolutionDescription = /Solution description[\s\S]{20,}/.test(prBody);
+            const hasTestSteps = /Steps to test[\s\S]{20,}/.test(prBody);
+
+            // Check if PR Tasks are complete
+            const prTasksComplete = checkedItems === totalItems && totalItems > 0;
+
+            core.setOutput('checked_items', checkedItems);
+            core.setOutput('unchecked_items', uncheckedItems);
+            core.setOutput('total_items', totalItems);
+            core.setOutput('pr_tasks_complete', prTasksComplete);
+            core.setOutput('has_issue_reference', hasIssueReference);
+            core.setOutput('has_solution', hasSolutionDescription);
+            core.setOutput('has_test_steps', hasTestSteps);
+
+            return {
+              checkedItems,
+              uncheckedItems,
+              totalItems,
+              prTasksComplete,
+              hasIssueReference,
+              hasSolutionDescription,
+              hasTestSteps
+            };
+
+      - name: Check test coverage
+        id: coverage_check
+        continue-on-error: true
+        run: |
+          # This will be checked by the main build workflow
+          # We just verify that tests exist for this PR
+          echo "coverage_check=pending" >> $GITHUB_OUTPUT
+
+      - name: Create or update check run
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const checkedItems = parseInt('${{ steps.checklist.outputs.checked_items }}');
+            const uncheckedItems = parseInt('${{ steps.checklist.outputs.unchecked_items }}');
+            const totalItems = parseInt('${{ steps.checklist.outputs.total_items }}');
+            const prTasksComplete = '${{ steps.checklist.outputs.pr_tasks_complete }}' === 'true';
+            const hasIssueReference = '${{ steps.checklist.outputs.has_issue_reference }}' === 'true';
+            const hasSolution = '${{ steps.checklist.outputs.has_solution }}' === 'true';
+            const hasTestSteps = '${{ steps.checklist.outputs.has_test_steps }}' === 'true';
+
+            // Determine check status
+            let conclusion = 'success';
+            let summary = '✅ All PR requirements met!';
+
+            const issues = [];
+
+            if (!prTasksComplete && totalItems > 0) {
+              issues.push(`- ${uncheckedItems} checklist items remaining`);
+            }
+
+            if (!hasIssueReference) {
+              issues.push('- Missing issue reference link');
+            }
+
+            if (!hasSolution) {
+              issues.push('- Solution description needs more details (min 20 chars)');
+            }
+
+            if (!hasTestSteps) {
+              issues.push('- Test steps need more details (min 20 chars)');
+            }
+
+            if (issues.length > 0) {
+              conclusion = 'neutral';
+              summary = '⚠️ PR checklist incomplete:\n\n' + issues.join('\n');
+            }
+
+            // Create check run
+            const checkRun = await github.rest.checks.create({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              name: 'PR Checklist',
+              head_sha: context.payload.pull_request.head.sha,
+              status: 'completed',
+              conclusion: conclusion,
+              output: {
+                title: 'PR Requirements Check',
+                summary: summary,
+                text: `### Checklist Progress
+            - Checked items: ${checkedItems}
+            - Unchecked items: ${uncheckedItems}
+            - Total items: ${totalItems}
+
+            ### Required Sections
+            - Issue Reference: ${hasIssueReference ? '✅' : '❌'}
+            - Solution Description: ${hasSolution ? '✅' : '❌'}
+            - Test Steps: ${hasTestSteps ? '✅' : '❌'}
+
+            ${conclusion === 'neutral' ? '\n⚠️ **Note:** This is a soft requirement. You can still merge the PR, but completing these items improves code review quality.' : ''}
+            `
+              }
+            });
+
+      - name: Add label based on checklist status
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const prTasksComplete = '${{ steps.checklist.outputs.pr_tasks_complete }}' === 'true';
+            const hasIssueReference = '${{ steps.checklist.outputs.has_issue_reference }}' === 'true';
+            const hasSolution = '${{ steps.checklist.outputs.has_solution }}' === 'true';
+            const hasTestSteps = '${{ steps.checklist.outputs.has_test_steps }}' === 'true';
+
+            if (prTasksComplete && hasIssueReference && hasSolution && hasTestSteps) {
+              // Remove incomplete label if exists
+              try {
+                await github.rest.issues.removeLabel({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  issue_number: context.issue.number,
+                  name: 'incomplete-pr'
+                });
+              } catch (e) {
+                // Label might not exist
+              }
+
+              // Add ready label
+              await github.rest.issues.addLabels({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: context.issue.number,
+                labels: ['ready-for-review']
+              });
+            } else {
+              // Remove ready label if exists
+              try {
+                await github.rest.issues.removeLabel({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  issue_number: context.issue.number,
+                  name: 'ready-for-review'
+                });
+              } catch (e) {
+                // Label might not exist
+              }
+            }
diff --git a/.github/workflows/pr-validation.yml b/.github/workflows/pr-validation.yml
new file mode 100644
index 0000000..215d98a
--- /dev/null
+++ b/.github/workflows/pr-validation.yml
@@ -0,0 +1,132 @@
+name: PR Validation
+
+on:
+  pull_request:
+    types: [opened, edited, synchronize, reopened]
+
+permissions:
+  pull-requests: write
+  contents: read
+  issues: write
+
+jobs:
+  validate-pr:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Check for Issue Reference
+        id: check_issue
+        run: |
+          PR_TITLE="${{ github.event.pull_request.title }}"
+          PR_BODY="${{ github.event.pull_request.body }}"
+
+          # Check if PR title or body contains issue reference
+          # Accepts: TRCLI-### (JIRA), GIT-### (GitHub), #123 (GitHub), issues/123
+          if echo "$PR_TITLE $PR_BODY" | grep -qE "TRCLI-[0-9]+|GIT-[0-9]+|#[0-9]+|issues/[0-9]+"; then
+            echo "issue_found=true" >> $GITHUB_OUTPUT
+
+            # Extract the issue key/number
+            if echo "$PR_TITLE $PR_BODY" | grep -qE "TRCLI-[0-9]+"; then
+              ISSUE_KEY=$(echo "$PR_TITLE $PR_BODY" | grep -oE "TRCLI-[0-9]+" | head -1)
+              echo "issue_key=$ISSUE_KEY" >> $GITHUB_OUTPUT
+              echo "issue_type=JIRA" >> $GITHUB_OUTPUT
+            elif echo "$PR_TITLE $PR_BODY" | grep -qE "GIT-[0-9]+"; then
+              ISSUE_KEY=$(echo "$PR_TITLE $PR_BODY" | grep -oE "GIT-[0-9]+" | head -1)
+              echo "issue_key=$ISSUE_KEY" >> $GITHUB_OUTPUT
+              echo "issue_type=GitHub" >> $GITHUB_OUTPUT
+            elif echo "$PR_TITLE $PR_BODY" | grep -qE "#[0-9]+"; then
+              ISSUE_KEY=$(echo "$PR_TITLE $PR_BODY" | grep -oE "#[0-9]+" | head -1)
+              echo "issue_key=$ISSUE_KEY" >> $GITHUB_OUTPUT
+              echo "issue_type=GitHub" >> $GITHUB_OUTPUT
+            elif echo "$PR_BODY" | grep -qE "issues/[0-9]+"; then
+              ISSUE_KEY=$(echo "$PR_BODY" | grep -oE "issues/[0-9]+" | head -1)
+              echo "issue_key=$ISSUE_KEY" >> $GITHUB_OUTPUT
+              echo "issue_type=GitHub" >> $GITHUB_OUTPUT
+            fi
+          else
+            echo "issue_found=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Comment on PR if issue reference missing
+        if: steps.check_issue.outputs.issue_found == 'false'
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: `## ⚠️ Missing Issue Reference
+
+              This PR does not reference an issue. Please include a reference in either:
+
+              **JIRA tickets:**
+              - PR title: "feat(api): TRCLI-123 Add new endpoint"
+              - PR description: "Resolves TRCLI-123"
+
+              **GitHub issues:**
+              - PR title: "feat(api): GIT-123 Add new endpoint"
+              - PR description: "Resolves GIT-123" or "Fixes #123"
+              - Or link to the GitHub issue
+
+              This helps with tracking and project management. Thank you!`
+            })
+
+      - name: Check PR Description Completeness
+        id: check_description
+        run: |
+          PR_BODY="${{ github.event.pull_request.body }}"
+
+          # Check for required sections
+          if echo "$PR_BODY" | grep -q "Issue being resolved"; then
+            echo "has_issue=true" >> $GITHUB_OUTPUT
+          else
+            echo "has_issue=false" >> $GITHUB_OUTPUT
+          fi
+
+          if echo "$PR_BODY" | grep -q "Solution description"; then
+            echo "has_solution=true" >> $GITHUB_OUTPUT
+          else
+            echo "has_solution=false" >> $GITHUB_OUTPUT
+          fi
+
+          if echo "$PR_BODY" | grep -q "Steps to test"; then
+            echo "has_test_steps=true" >> $GITHUB_OUTPUT
+          else
+            echo "has_test_steps=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Generate PR Validation Summary
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const issueFound = '${{ steps.check_issue.outputs.issue_found }}' === 'true';
+            const issueKey = '${{ steps.check_issue.outputs.issue_key }}';
+            const issueType = '${{ steps.check_issue.outputs.issue_type }}';
+            const hasIssue = '${{ steps.check_description.outputs.has_issue }}' === 'true';
+            const hasSolution = '${{ steps.check_description.outputs.has_solution }}' === 'true';
+            const hasTestSteps = '${{ steps.check_description.outputs.has_test_steps }}' === 'true';
+
+            const issueStatus = issueFound
+              ? `✅ Found: ${issueKey} (${issueType})`
+              : '⚠️ Missing';
+
+            const summary = `## 📋 PR Validation Summary
+
+            | Check | Status |
+            |-------|--------|
+            | Issue Reference | ${issueStatus} |
+            | Issue Section | ${hasIssue ? '✅ Present' : '⚠️ Missing'} |
+            | Solution Description | ${hasSolution ? '✅ Present' : '⚠️ Missing'} |
+            | Test Steps | ${hasTestSteps ? '✅ Present' : '⚠️ Missing'} |
+
+            ${issueFound && hasSolution && hasTestSteps ? '✅ All checks passed!' : '⚠️ Some optional sections are missing. Consider adding them for better review context.'}
+            `;
+
+            await core.summary
+              .addRaw(summary)
+              .write();
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 60df378..ad5bc89 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -1,6 +1,13 @@
+# Pre-commit hooks for code quality, security, and policy enforcement
+# Install: pip install pre-commit
+# Setup: pre-commit install && pre-commit install --hook-type commit-msg
+# Run manually: pre-commit run --all-files
+
 repos:
--   repo: https://github.com/psf/black
-    rev: stable
+  # Code formatting
+  - repo: https://github.com/psf/black
+    rev: 24.10.0
     hooks:
-    - id: black
-      language_version: python3.8
\ No newline at end of file
+      - id: black
+        language_version: python3.10
+        args: [--line-length=120]
diff --git a/.pre-commit-hooks/commit-msg.py b/.pre-commit-hooks/commit-msg.py
new file mode 100755
index 0000000..d3aef5d
--- /dev/null
+++ b/.pre-commit-hooks/commit-msg.py
@@ -0,0 +1,103 @@
+#!/usr/bin/env python3
+"""Commit message validator for TRCLI project.
+
+Ensures commit messages start with a valid issue reference (JIRA or GitHub).
+
+Valid formats:
+  JIRA tickets:
+    - TRCLI-123: Add new feature
+    - TRCLI-456 Fix bug in parser
+    - [TRCLI-789] Update documentation
+
+  GitHub issues:
+    - GIT-123: Add new feature
+    - GIT-456 Fix bug in parser
+    - #123: Add new feature
+    - [#456] Fix bug in parser
+
+Special cases (allowed without issue reference):
+  - Merge commits
+  - Release commits (starting with "Release")
+  - Version bump commits (starting with "Bump version")
+  - Initial commits
+"""
+
+import re
+import sys
+
+
+def validate_commit_message(commit_msg_file):
+    """Validate that commit message follows TRCLI conventions."""
+    with open(commit_msg_file, "r") as f:
+        commit_msg = f.read().strip()
+
+    # Skip empty messages
+    if not commit_msg:
+        print("ERROR: Commit message is empty")
+        return False
+
+    # Allow merge commits
+    if commit_msg.startswith("Merge"):
+        return True
+
+    # Allow release commits
+    if commit_msg.startswith("Release") or commit_msg.startswith("Bump version"):
+        return True
+
+    # Allow revert commits
+    if commit_msg.startswith("Revert"):
+        return True
+
+    # Check for issue reference at the start
+    # JIRA patterns: TRCLI-123, [TRCLI-123], TRCLI-123:
+    # GitHub patterns: GIT-123, #123, [GIT-123], [#123]
+    issue_patterns = [
+        r"^(\[)?TRCLI-\d+(\])?[:\s]",  # JIRA: TRCLI-123 or [TRCLI-123]
+        r"^(\[)?GIT-\d+(\])?[:\s]",  # GitHub: GIT-123 or [GIT-123]
+        r"^(\[)?#\d+(\])?[:\s]",  # GitHub: #123 or [#123]
+    ]
+
+    # Check if commit message matches any valid pattern
+    for pattern in issue_patterns:
+        if re.match(pattern, commit_msg):
+            return True
+
+    # If we get here, the commit message is invalid
+    print("\n" + "=" * 70)
+    print("COMMIT MESSAGE VALIDATION FAILED")
+    print("=" * 70)
+    print("\nYour commit message must start with an issue reference.")
+    print("\nValid formats:")
+    print("\n  JIRA tickets:")
+    print("    - TRCLI-123: Add new feature")
+    print("    - TRCLI-456 Fix bug in parser")
+    print("    - [TRCLI-789] Update documentation")
+    print("\n  GitHub issues:")
+    print("    - GIT-123: Add new feature")
+    print("    - GIT-456 Fix bug in parser")
+    print("    - #123: Add new feature")
+    print("    - [#456] Fix bug in parser")
+    print("\nSpecial cases (no issue reference needed):")
+    print("  - Merge commits")
+    print("  - Release commits (start with 'Release')")
+    print("  - Version bumps (start with 'Bump version')")
+    print("  - Reverts (start with 'Revert')")
+    print("\nYour commit message:")
+    print(f"  {commit_msg}")
+    print("\nPlease update your commit message and try again.")
+    print("=" * 70 + "\n")
+
+    return False
+
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print("ERROR: No commit message file provided")
+        sys.exit(1)
+
+    commit_msg_file = sys.argv[1]
+
+    if validate_commit_message(commit_msg_file):
+        sys.exit(0)
+    else:
+        sys.exit(1)
diff --git a/CHANGELOG.MD b/CHANGELOG.MD
index 0749997..844310e 100644
--- a/CHANGELOG.MD
+++ b/CHANGELOG.MD
@@ -6,6 +6,14 @@ This project adheres to [Semantic Versioning](https://semver.org/). Version numb
 - **MINOR**: New features that are backward-compatible.
 - **PATCH**: Bug fixes or minor changes that do not affect backward compatibility.
 
+## [1.12.3]
+
+_released 10-31-2025
+
+### Added
+ - Enhanced TRCLI analytics integration with TestRail API enabling better tracking and insight into usage patterns.
+ - Introduced new development workflow improvements to streamline the contributor and release process.
+
 ## [1.12.2]
 
 _released 10-16-2025
diff --git a/DEVELOPMENT_WORKFLOW.md b/DEVELOPMENT_WORKFLOW.md
new file mode 100644
index 0000000..36f2168
--- /dev/null
+++ b/DEVELOPMENT_WORKFLOW.md
@@ -0,0 +1,315 @@
+# Development Workflow Guide
+
+This guide explains the automated quality checks and policy validation integrated into the TRCLI development workflow.
+
+## Table of Contents
+
+1. [Pre-Commit Setup](#pre-commit-setup)
+2. [Commit Message Format](#commit-message-format)
+3. [Pull Request Process](#pull-request-process)
+4. [Automated Checks](#automated-checks)
+5. [Troubleshooting](#troubleshooting)
+
+---
+
+## Pre-Commit Setup
+
+Pre-commit hooks ensure code quality before commits are made, catching issues early in development.
+
+### Installation
+
+```bash
+# Install pre-commit
+pip install pre-commit
+
+# Install the git hooks
+pre-commit install
+
+# Install commit-msg hook for JIRA validation
+pre-commit install --hook-type commit-msg
+
+# (Optional) Run hooks on all files
+pre-commit run --all-files
+```
+
+### What Gets Checked
+
+The pre-commit hooks run the following checks automatically:
+
+#### Code Formatting
+- **Black** - Python code formatter (line length: 120)
+
+### Skipping Hooks (Use Sparingly)
+
+```bash
+# Skip all hooks (not recommended)
+git commit --no-verify -m "your message"
+
+# Skip specific hook
+SKIP=black git commit -m "your message"
+```
+
+---
+
+## Commit Message Format
+
+It's recommended to include an issue reference (JIRA ticket or GitHub issue) in your commit messages for better traceability.
+
+### Valid Formats
+
+**JIRA Tickets:**
+```bash
+# Format 1: JIRA key with colon
+git commit -m "TRCLI-123: Add new feature for XML parsing"
+
+# Format 2: JIRA key with space
+git commit -m "TRCLI-456 Fix bug in API request handler"
+
+# Format 3: JIRA key in brackets
+git commit -m "[TRCLI-789] Update documentation"
+```
+
+**GitHub Issues:**
+```bash
+# Format 1: GIT prefix with issue number
+git commit -m "GIT-123: Add new feature for XML parsing"
+
+# Format 2: Hash symbol with issue number
+git commit -m "#456: Fix bug in API request handler"
+
+# Format 3: Brackets with hash
+git commit -m "[#789] Update documentation"
+```
+
+### Special Cases (No Issue Reference Required)
+
+- Merge commits: `Merge branch 'feature/xyz' into main`
+- Release commits: `Release v1.2.3`
+- Version bumps: `Bump version to 1.2.3`
+- Reverts: `Revert "TRCLI-123: Add feature"` or `Revert "#123: Add feature"`
+
+### Why This Matters
+
+- **Traceability**: Links code changes to requirements/bugs
+- **Project Management**: Enables automatic issue tracking and updates
+- **Release Notes**: Simplifies changelog generation
+- **Code Review**: Provides context for reviewers
+- **Documentation**: Easy to find all commits related to a specific issue
+
+---
+
+## Pull Request Process
+
+### 1. Create Your Branch
+
+```bash
+# Feature branch
+git checkout -b feature/TRCLI-123-add-xml-parser
+
+# Bug fix branch
+git checkout -b fix/TRCLI-456-api-timeout
+
+# Documentation
+git checkout -b docs/TRCLI-789-update-readme
+```
+
+### 2. PR Title Format (Recommended)
+
+It's recommended to use [Conventional Commits](https://www.conventionalcommits.org/) format for clarity:
+
+```
+type(scope): description
+```
+
+**Valid Types:**
+- `feat`: New feature
+- `fix`: Bug fix
+- `docs`: Documentation changes
+- `style`: Code style changes (formatting, no logic change)
+- `refactor`: Code refactoring (no feature change)
+- `perf`: Performance improvements
+- `test`: Adding or updating tests
+- `build`: Build system changes
+- `ci`: CI/CD pipeline changes
+- `chore`: Maintenance tasks
+
+**Examples:**
+```
+feat(parser): add support for JUnit XML format
+fix(api): handle timeout errors gracefully
+docs(readme): update installation instructions
+refactor(cli): simplify argument parsing logic
+test(parser): add edge case tests for empty files
+```
+
+### 3. Fill Out PR Template
+
+The PR template includes required sections:
+- Issue reference (GitHub or JIRA)
+- Solution description
+- Changes made
+- Test steps
+- Checklist items
+
+**All checklist items must be completed** before requesting review.
+
+### 4. Automated PR Checks
+
+When you open a PR, the following checks run automatically:
+
+#### ✅ PR Validation
+- Checks for issue reference (JIRA or GitHub)
+- Ensures PR description is complete
+
+#### 📋 Checklist Enforcement
+- Verifies all checklist items are checked
+- Ensures required sections are filled
+- Adds/removes labels based on completion
+
+---
+
+## Automated Checks
+
+### Build & Test Workflow
+
+Runs on every PR and push to main:
+- Tests on Python 3.10, 3.11, 3.12, 3.13
+- Tests on Ubuntu and Windows
+- Code coverage must be ≥ 80%
+- All tests must pass
+
+### PR Validation
+
+**Checks:**
+- Issue reference (JIRA ticket or GitHub issue)
+- PR description completeness
+
+### Checklist Enforcement
+
+**Validates:**
+- All checklist items are completed
+- Required sections have content
+- Issue reference exists
+- Test steps provided
+
+**Labels:**
+- `ready-for-review`: All checks passed
+- `incomplete-pr`: Missing required items
+
+---
+
+## Troubleshooting
+
+### Pre-Commit Hook Failures
+
+#### "Black would reformat"
+**Problem**: Code formatting doesn't match Black style.
+
+**Solution**:
+```bash
+# Let Black fix it automatically
+pre-commit run black --all-files
+
+# Then commit again
+git add .
+git commit -m "Your commit message"
+```
+
+### PR Check Failures
+
+#### "Issue reference missing"
+**Problem**: No issue reference in PR title or description.
+
+**Solution**: Add issue reference:
+
+**JIRA ticket:**
+- In PR title: `feat(api): TRCLI-123 Add endpoint`
+- In PR body: Link to JIRA or mention `TRCLI-123`
+
+**GitHub issue:**
+- In PR title: `feat(api): GIT-456 Add endpoint` or `feat(api): #789 Add endpoint`
+- In PR body: `Fixes #123` or `Resolves GIT-456` or link to GitHub issue
+
+#### "Checklist incomplete"
+**Problem**: Not all checklist items are checked.
+
+**Solution**: Complete all items or remove non-applicable ones.
+
+---
+
+## Best Practices
+
+### Commit Frequently
+- Make small, logical commits
+- Each commit should have a single purpose
+- Write descriptive commit messages
+
+### Run Pre-Commit Before Pushing
+```bash
+# Test your changes locally first
+pre-commit run --all-files
+pytest tests/
+```
+
+### Keep PRs Small
+- Aim for <400 lines changed per PR
+- Break large features into multiple PRs
+- Easier to review and less likely to introduce bugs
+
+### Test Coverage
+- Maintain ≥80% code coverage
+- Test edge cases
+- Include integration tests where applicable
+
+---
+
+## Quick Reference
+
+### Pre-Commit Commands
+```bash
+pre-commit install                    # Initial setup
+pre-commit install --hook-type commit-msg
+pre-commit run --all-files           # Run on all files
+pre-commit run <hook-id>             # Run specific hook
+SKIP=<hook-id> git commit            # Skip specific hook
+```
+
+### Git Workflow
+```bash
+# Using JIRA ticket
+git checkout -b feature/TRCLI-123-description
+git add .
+git commit -m "TRCLI-123: Description"
+git push origin feature/TRCLI-123-description
+
+# Using GitHub issue
+git checkout -b feature/GIT-456-description
+git add .
+git commit -m "GIT-456: Description"
+# or
+git commit -m "#456: Description"
+git push origin feature/GIT-456-description
+
+# Open PR with semantic title
+```
+
+### Testing
+```bash
+pytest tests/                         # Run all tests
+pytest tests/test_xyz.py             # Run specific test
+pytest --cov=trcli --cov-report=html # Coverage report
+```
+
+### Useful Links
+- [Conventional Commits](https://www.conventionalcommits.org/)
+- [Pre-commit Framework](https://pre-commit.com/)
+
+---
+
+## Getting Help
+
+- **Pre-commit issues**: Check `.pre-commit-config.yaml` configuration
+- **PR workflow issues**: Review `.github/workflows/` files
+- **General questions**: Open an issue or ask in team chat
+
+Happy coding! 🚀
diff --git a/README.md b/README.md
index f192822..2bb0ab4 100644
--- a/README.md
+++ b/README.md
@@ -33,7 +33,7 @@ trcli
 ```
 You should get something like this:
 ```
-TestRail CLI v1.12.2
+TestRail CLI v1.12.3
 Copyright 2025 Gurock Software GmbH - www.gurock.com
 Supported and loaded modules:
     - parse_junit: JUnit XML Files (& Similar)
@@ -47,7 +47,7 @@ CLI general reference
 --------
 ```shell
 $ trcli --help
-TestRail CLI v1.12.1
+TestRail CLI v1.12.3
 Copyright 2025 Gurock Software GmbH - www.gurock.com
 Usage: trcli [OPTIONS] COMMAND [ARGS]...
 
@@ -1094,7 +1094,7 @@ Options:
 ### Reference
 ```shell
 $ trcli add_run --help
-TestRail CLI v1.12.1
+TestRail CLI v1.12.3
 Copyright 2025 Gurock Software GmbH - www.gurock.com
 Usage: trcli add_run [OPTIONS]
 
@@ -1218,7 +1218,7 @@ providing you with a solid base of test cases, which you can further expand on T
 ### Reference
 ```shell
 $ trcli parse_openapi --help
-TestRail CLI v1.12.1
+TestRail CLI v1.12.3
 Copyright 2025 Gurock Software GmbH - www.gurock.com
 Usage: trcli parse_openapi [OPTIONS]
 
diff --git a/setup-dev-tools.sh b/setup-dev-tools.sh
new file mode 100755
index 0000000..00016dd
--- /dev/null
+++ b/setup-dev-tools.sh
@@ -0,0 +1,49 @@
+#!/bin/bash
+
+# TRCLI Development Tools Setup Script
+# This script sets up pre-commit hooks and development tools
+
+set -e
+
+echo "=========================================="
+echo "TRCLI Development Tools Setup"
+echo "=========================================="
+echo ""
+
+# Check Python version
+echo "Checking Python version..."
+python_version=$(python3 --version 2>&1 | awk '{print $2}')
+echo "✓ Python version: $python_version"
+echo ""
+
+# Install pre-commit
+echo "Installing pre-commit..."
+pip install pre-commit
+echo "✓ Pre-commit installed"
+echo ""
+
+# Install git hooks
+echo "Installing git hooks..."
+pre-commit install
+echo "✓ Git hooks installed"
+echo ""
+
+# Run pre-commit on all files (optional)
+echo "Would you like to run pre-commit checks on all files now? (y/n)"
+read -r response
+if [[ "$response" == "y" || "$response" == "Y" ]]; then
+    echo "Running pre-commit checks..."
+    pre-commit run --all-files || true
+    echo ""
+fi
+
+echo "=========================================="
+echo "Setup Complete! ✓"
+echo "=========================================="
+echo ""
+echo "Next steps:"
+echo "1. Read DEVELOPMENT_WORKFLOW.md for detailed guidelines"
+echo "2. Use semantic PR titles (e.g., feat(api): add new endpoint)"
+echo "3. Include issue references in commits for traceability (recommended)"
+echo ""
+echo "Happy coding! 🚀"
diff --git a/tests/test_api_client.py b/tests/test_api_client.py
index 49e95a4..4f64f45 100644
--- a/tests/test_api_client.py
+++ b/tests/test_api_client.py
@@ -45,9 +45,7 @@ class TestAPIClient:
     def test_send_get_status_code_success(self, api_resources, requests_mock):
         """The purpose of this test is to check behaviour of send_get one receiving successful status code.
         Check that response was packed into APIClientResult, retry mechanism was not triggered."""
-        requests_mock.get(
-            create_url("get_projects"), status_code=200, json=FAKE_PROJECT_DATA
-        )
+        requests_mock.get(create_url("get_projects"), status_code=200, json=FAKE_PROJECT_DATA)
         api_client = api_resources
         response = api_client.send_get("get_projects")
 
@@ -58,9 +56,7 @@ def test_send_get_status_code_success(self, api_resources, requests_mock):
     def test_send_post_status_code_success(self, api_resources, requests_mock):
         """The purpose of this test is to check behaviour of send_post one receiving successful status code.
         Check that response was packed into APIClientResult, retry mechanism was not triggered."""
-        requests_mock.post(
-            create_url("add_project"), status_code=201, json=FAKE_PROJECT_DATA
-        )
+        requests_mock.post(create_url("add_project"), status_code=201, json=FAKE_PROJECT_DATA)
         api_client = api_resources
         response = api_client.send_post("add_project", FAKE_PROJECT_DATA)
 
@@ -82,17 +78,13 @@ def test_send_get_status_code_not_success(self, api_resources, requests_mock):
         )
 
         check_calls_count(requests_mock)
-        check_response(
-            400, INVALID_TEST_CASE_ERROR, INVALID_TEST_CASE_ERROR["error"], response
-        )
+        check_response(400, INVALID_TEST_CASE_ERROR, INVALID_TEST_CASE_ERROR["error"], response)
 
     @pytest.mark.api_client
     def test_send_post_status_code_not_success(self, api_resources, requests_mock):
         """The purpose of this test is to check behaviour of send_post one receiving not successful status code.
         Check that response was packed into APIClientResult, retry mechanism was not triggered."""
-        requests_mock.post(
-            create_url("add_project"), status_code=403, json=NO_PERMISSION_PROJECT_ERROR
-        )
+        requests_mock.post(create_url("add_project"), status_code=403, json=NO_PERMISSION_PROJECT_ERROR)
         api_client = api_resources
         response = api_client.send_post("add_project", {"fake_project_data": "data"})
 
@@ -106,9 +98,7 @@ def test_send_post_status_code_not_success(self, api_resources, requests_mock):
 
     @pytest.mark.api_client
     @pytest.mark.parametrize("retries, retry_after", [(4, "30"), (10, "60")])
-    def test_retry_mechanism_too_many_requests(
-        self, retries, retry_after, api_resources_maker, requests_mock, mocker
-    ):
+    def test_retry_mechanism_too_many_requests(self, retries, retry_after, api_resources_maker, requests_mock, mocker):
         """The purpose of this test is to check that retry mechanism will work as expected when
         429 - too many requests will be received as an answer on get request."""
         requests_mock.get(
@@ -161,6 +151,9 @@ def test_retry_mechanism_exceptions(
                 f"\n**** API Call\n"
                 f"method: GET\n"
                 f"url: https://FakeTestRail.io/index.php?/api/v2/get_projects\n"
+                f"headers:\n"
+                f"  User-Agent: TRCLI\n"
+                f"  Content-Type: application/json\n"
             ),
         ]
 
@@ -182,6 +175,9 @@ def test_request_exception(self, api_resources_maker, requests_mock, mocker):
                 f"\n**** API Call\n"
                 f"method: GET\n"
                 f"url: https://FakeTestRail.io/index.php?/api/v2/get_projects\n"
+                f"headers:\n"
+                f"  User-Agent: TRCLI\n"
+                f"  Content-Type: application/json\n"
             )
         ]
         response = api_client.send_get("get_projects")
@@ -190,9 +186,7 @@ def test_request_exception(self, api_resources_maker, requests_mock, mocker):
         check_response(
             -1,
             "",
-            FAULT_MAPPING["unexpected_error_during_request_send"].format(
-                request=request
-            ),
+            FAULT_MAPPING["unexpected_error_during_request_send"].format(request=request),
             response,
         )
         environment.vlog.assert_has_calls(expected_log_calls)
@@ -236,7 +230,8 @@ def test_not_json_response(self, api_resources, requests_mock, mocker):
         api_client = api_resources
         response = api_client.send_get("get_projects")
         check_calls_count(requests_mock)
-        check_response(200, content, content, response)
+        expected_error_message = FAULT_MAPPING["invalid_json_response"].format(status_code=200, response_preview="Test")
+        check_response(200, str(content), expected_error_message, response)
 
     @pytest.mark.api_client
     def test_api_calls_are_logged(self, api_resources_maker, requests_mock, mocker):
@@ -248,6 +243,9 @@ def test_api_calls_are_logged(self, api_resources_maker, requests_mock, mocker):
                 f"\n**** API Call\n"
                 f"method: GET\n"
                 f"url: https://FakeTestRail.io/index.php?/api/v2/get_projects\n"
+                f"headers:\n"
+                f"  User-Agent: TRCLI\n"
+                f"  Content-Type: application/json\n"
                 f"response status code: 200\n"
                 f"response body: ['test', 'list']\n"
                 "****"
@@ -270,9 +268,7 @@ def test_api_calls_are_logged(self, api_resources_maker, requests_mock, mocker):
         ],
         ids=["float", "int", "int as string", "float as string", "invalid value"],
     )
-    def test_timeout_is_parsed_and_validated(
-        self, timeout_value, expected_message, api_resources_maker, mocker
-    ):
+    def test_timeout_is_parsed_and_validated(self, timeout_value, expected_message, api_resources_maker, mocker):
         environment = mocker.patch("trcli.cli.Environment")
         api_client = api_resources_maker(environment=environment, timeout=timeout_value)
 
@@ -283,7 +279,7 @@ def test_timeout_is_parsed_and_validated(
                 environment.log.assert_has_calls([mocker.call(TIMEOUT_PARSE_ERROR)])
 
     @pytest.mark.api_client
-    @patch('requests.post')
+    @patch("requests.post")
     def test_send_post_with_json_default(self, mock_post, api_resources_maker):
         """Test that send_post uses JSON by default"""
         # Mock response
@@ -302,22 +298,22 @@ def test_send_post_with_json_default(self, mock_post, api_resources_maker):
         # Verify the result
         assert result.status_code == 200
         assert result.response_text == {"id": 1, "title": "Test"}
-        
+
         # Verify JSON was used
         mock_post.assert_called_once()
         call_args = mock_post.call_args
-        
+
         # Should use json parameter, not data
-        assert 'json' in call_args[1]
-        assert 'data' not in call_args[1]
-        assert call_args[1]['json'] == {":title": "Test Label"}
-        
+        assert "json" in call_args[1]
+        assert "data" not in call_args[1]
+        assert call_args[1]["json"] == {":title": "Test Label"}
+
         # Should have JSON content type header
-        headers = call_args[1]['headers']
-        assert headers.get('Content-Type') == 'application/json'
+        headers = call_args[1]["headers"]
+        assert headers.get("Content-Type") == "application/json"
 
     @pytest.mark.api_client
-    @patch('requests.post')
+    @patch("requests.post")
     def test_send_post_with_form_data_true(self, mock_post, api_resources_maker):
         """Test that send_post uses form-data when as_form_data=True"""
         # Mock response
@@ -340,21 +336,21 @@ def test_send_post_with_form_data_true(self, mock_post, api_resources_maker):
         # Verify form-data was used
         mock_post.assert_called_once()
         call_args = mock_post.call_args
-        
+
         # Should use data parameter, not json
-        assert 'data' in call_args[1]
-        assert 'json' not in call_args[1]
-        assert call_args[1]['data'] == {":title": "Test Label"}
-        
+        assert "data" in call_args[1]
+        assert "json" not in call_args[1]
+        assert call_args[1]["data"] == {":title": "Test Label"}
+
         # Should NOT have files parameter (uses application/x-www-form-urlencoded)
-        assert 'files' not in call_args[1] or call_args[1]['files'] is None
-        
+        assert "files" not in call_args[1] or call_args[1]["files"] is None
+
         # Should NOT have JSON content type header when using form-data
-        headers = call_args[1]['headers']
-        assert headers.get('Content-Type') != 'application/json'
+        headers = call_args[1]["headers"]
+        assert headers.get("Content-Type") != "application/json"
 
     @pytest.mark.api_client
-    @patch('requests.post')
+    @patch("requests.post")
     def test_send_post_with_form_data_false(self, mock_post, api_resources_maker):
         """Test that send_post uses JSON when as_form_data=False explicitly"""
         # Mock response
@@ -377,18 +373,18 @@ def test_send_post_with_form_data_false(self, mock_post, api_resources_maker):
         # Verify JSON was used
         mock_post.assert_called_once()
         call_args = mock_post.call_args
-        
+
         # Should use json parameter, not data
-        assert 'json' in call_args[1]
-        assert 'data' not in call_args[1]
-        assert call_args[1]['json'] == {":title": "Test Label"}
-        
+        assert "json" in call_args[1]
+        assert "data" not in call_args[1]
+        assert call_args[1]["json"] == {":title": "Test Label"}
+
         # Should have JSON content type header
-        headers = call_args[1]['headers']
-        assert headers.get('Content-Type') == 'application/json'
+        headers = call_args[1]["headers"]
+        assert headers.get("Content-Type") == "application/json"
 
     @pytest.mark.api_client
-    @patch('requests.post')
+    @patch("requests.post")
     def test_send_post_with_files_and_form_data(self, mock_post, api_resources_maker):
         """Test that send_post handles files parameter with form-data"""
         # Mock response
@@ -403,12 +399,7 @@ def test_send_post_with_files_and_form_data(self, mock_post, api_resources_maker
 
         # Call send_post with files and form-data
         files = {"file1": "/path/to/file"}
-        result = api_client.send_post(
-            "test_endpoint", 
-            {":title": "Test Label"}, 
-            files=files, 
-            as_form_data=True
-        )
+        result = api_client.send_post("test_endpoint", {":title": "Test Label"}, files=files, as_form_data=True)
 
         # Verify the result
         assert result.status_code == 200
@@ -417,14 +408,14 @@ def test_send_post_with_files_and_form_data(self, mock_post, api_resources_maker
         # Verify form-data was used
         mock_post.assert_called_once()
         call_args = mock_post.call_args
-        
+
         # Should use data parameter, not json
-        assert 'data' in call_args[1]
-        assert 'json' not in call_args[1]
-        assert call_args[1]['data'] == {":title": "Test Label"}
+        assert "data" in call_args[1]
+        assert "json" not in call_args[1]
+        assert call_args[1]["data"] == {":title": "Test Label"}
         # Files should be passed through as provided (not replaced with empty dict)
-        assert call_args[1]['files'] == files
-        
+        assert call_args[1]["files"] == files
+
         # Should NOT have JSON content type header when using files
-        headers = call_args[1]['headers']
-        assert headers.get('Content-Type') != 'application/json'
+        headers = call_args[1]["headers"]
+        assert headers.get("Content-Type") != "application/json"
diff --git a/trcli/__init__.py b/trcli/__init__.py
index 858085d..53d6006 100644
--- a/trcli/__init__.py
+++ b/trcli/__init__.py
@@ -1 +1 @@
-__version__ = "1.12.2"
+__version__ = "1.12.3"
diff --git a/trcli/api/api_client.py b/trcli/api/api_client.py
index 6a12538..bc24248 100644
--- a/trcli/api/api_client.py
+++ b/trcli/api/api_client.py
@@ -1,5 +1,8 @@
 import json
 from pathlib import Path
+import platform
+import os
+import base64
 
 import requests
 from beartype.typing import Union, Callable, Dict, List
@@ -49,7 +52,8 @@ def __init__(
         verify: bool = True,
         proxy: str = None, #added proxy params
         proxy_user: str = None,
-        noproxy: str = None, 
+        noproxy: str = None,
+        uploader_metadata: str = None,
     ):
         self.username = ""
         self.password = ""
@@ -62,7 +66,8 @@ def __init__(
         self.__validate_and_set_timeout(timeout)
         self.proxy = proxy
         self.proxy_user = proxy_user
-        self.noproxy = noproxy.split(',') if noproxy else [] 
+        self.noproxy = noproxy.split(',') if noproxy else []
+        self.uploader_metadata = uploader_metadata 
         
         if not host_name.endswith("/"):
             host_name = host_name + "/"
@@ -99,6 +104,7 @@ def __send_request(self, method: str, uri: str, payload: dict, files: Dict[str,
         auth = HTTPBasicAuth(username=self.username, password=password)
         headers = {"User-Agent": self.USER_AGENT}
         headers.update(self.__get_proxy_headers())
+        headers.update(self.__get_uploader_metadata_headers())
         if files is None and not as_form_data:
             headers["Content-Type"] = "application/json"
         verbose_log_message = ""
@@ -107,7 +113,7 @@ def __send_request(self, method: str, uri: str, payload: dict, files: Dict[str,
             error_message = ""
             try:
                 verbose_log_message = APIClient.format_request_for_vlog(
-                    method=method, url=url, payload=payload
+                    method=method, url=url, payload=payload, headers=headers
                 )
                 if method == "POST":
                     request_kwargs = {
@@ -177,8 +183,12 @@ def __send_request(self, method: str, uri: str, payload: dict, files: Dict[str,
                         response_text = response.json()
                     error_message = response_text.get("error", "")
                 except (JSONDecodeError, ValueError):
+                    response_preview = response.content[:200].decode('utf-8', errors='ignore')
                     response_text = str(response.content)
-                    error_message = response.content
+                    error_message = FAULT_MAPPING["invalid_json_response"].format(
+                        status_code=status_code,
+                        response_preview=response_preview
+                    )
                 except AttributeError:
                     error_message = ""
                 verbose_log_message = (
@@ -209,6 +219,15 @@ def __get_proxy_headers(self) -> Dict[str, str]:
 
         return headers
 
+    def __get_uploader_metadata_headers(self) -> Dict[str, str]:
+        """
+        Returns headers for uploader metadata.
+        """
+        headers = {}
+        if self.uploader_metadata:
+            headers["X-Uploader-Metadata"] = self.uploader_metadata
+        return headers
+
     def _get_proxies_for_request(self, url: str) -> Dict[str, str]:
         """
         Returns the appropriate proxy dictionary for a given request URL.
@@ -277,12 +296,38 @@ def __validate_and_set_timeout(self, timeout):
             self.timeout = DEFAULT_API_CALL_TIMEOUT
 
     @staticmethod
-    def format_request_for_vlog(method: str, url: str, payload: dict):
-        return (
+    def build_uploader_metadata(version: str) -> str:
+        """
+        Build uploader metadata as base64-encoded JSON.
+
+        :param version: Application version
+        :returns: Base64-encoded metadata string
+        """
+        data = {
+            "app_name": "trcli",
+            "app_version": version,
+            "os": platform.system().lower(),
+            "arch": platform.machine(),
+            "run_mode": "ci" if os.getenv("CI") else "other",
+            "container": os.path.exists("/.dockerenv"),
+        }
+
+        return base64.b64encode(json.dumps(data).encode()).decode()
+
+    @staticmethod
+    def format_request_for_vlog(method: str, url: str, payload: dict, headers: dict = None):
+        log_message = (
             f"\n**** API Call\n"
             f"method: {method}\n"
-            f"url: {url}\n" + (f"payload: {payload}\n" if payload else "")
+            f"url: {url}\n"
         )
+        if headers:
+            log_message += "headers:\n"
+            for key, value in headers.items():
+                log_message += f"  {key}: {value}\n"
+        if payload:
+            log_message += f"payload: {payload}\n"
+        return log_message
 
     @staticmethod
     def format_response_for_vlog(status_code, body):
diff --git a/trcli/api/api_request_handler.py b/trcli/api/api_request_handler.py
index 687f5ea..3dcd196 100644
--- a/trcli/api/api_request_handler.py
+++ b/trcli/api/api_request_handler.py
@@ -977,6 +977,12 @@ def __get_all_entities(self, entity: str, link=None, entities=[]) -> Tuple[List[
             # Endpoints without pagination (legacy)
             if isinstance(response.response_text, list):
                 return response.response_text, response.error_message
+            # Check if response is a string (JSON parse failed)
+            if isinstance(response.response_text, str):
+                error_msg = FAULT_MAPPING["invalid_api_response"].format(
+                    error_details=response.response_text[:200]
+                )
+                return [], error_msg
             # Endpoints with pagination
             entities = entities + response.response_text[entity]
             if response.response_text["_links"]["next"] is not None:
diff --git a/trcli/api/project_based_client.py b/trcli/api/project_based_client.py
index fef7835..3d8cd7e 100644
--- a/trcli/api/project_based_client.py
+++ b/trcli/api/project_based_client.py
@@ -6,6 +6,7 @@
 from trcli.constants import ProjectErrors, FAULT_MAPPING, SuiteModes, PROMPT_MESSAGES
 from trcli.data_classes.data_parsers import MatchersParser
 from trcli.data_classes.dataclass_testrail import TestRailSuite
+import trcli
 
 
 class ProjectBasedClient:
@@ -36,27 +37,25 @@ def instantiate_api_client(self) -> APIClient:
         proxy = self.environment.proxy  # Will be None if --proxy is not defined
         noproxy = self.environment.noproxy  # Will be None if --noproxy is not defined
         proxy_user = self.environment.proxy_user
+
+        # Generate uploader metadata
+        uploader_metadata = APIClient.build_uploader_metadata(version=trcli.__version__)
+
+        # Build client configuration
+        client_kwargs = {
+            "verbose_logging_function": verbose_logging_function,
+            "logging_function": logging_function,
+            "verify": not self.environment.insecure,
+            "proxy": proxy,
+            "proxy_user": proxy_user,
+            "noproxy": noproxy,
+            "uploader_metadata": uploader_metadata
+        }
+
         if self.environment.timeout:
-            api_client = APIClient(
-                self.environment.host,
-                verbose_logging_function=verbose_logging_function,
-                logging_function=logging_function,
-                timeout=self.environment.timeout,
-                verify=not self.environment.insecure,
-                proxy=proxy,
-                proxy_user=proxy_user,
-                noproxy=noproxy
-            )
-        else:
-            api_client = APIClient(
-                self.environment.host,
-                logging_function=logging_function,
-                verbose_logging_function=verbose_logging_function,
-                verify=not self.environment.insecure,
-                proxy=proxy,
-                proxy_user=proxy_user,
-                noproxy=noproxy
-            )
+            client_kwargs["timeout"] = self.environment.timeout
+
+        api_client = APIClient(self.environment.host, **client_kwargs)
         api_client.username = self.environment.username
         api_client.password = self.environment.password
         api_client.api_key = self.environment.key
diff --git a/trcli/constants.py b/trcli/constants.py
index f9541c7..0dc9fec 100644
--- a/trcli/constants.py
+++ b/trcli/constants.py
@@ -65,7 +65,11 @@
     proxy_invalid_configuration= "The provided proxy configuration is invalid. Please check the proxy URL and format.",
     ssl_error_on_proxy= "SSL error encountered while using the HTTPS proxy. Please check the proxy's SSL certificate.",
     no_proxy_match_error= "The host {host} does not match any NO_PROXY rules. Ensure the correct domains or IP addresses are specified for bypassing the proxy.",
-    no_suites_found= "The project {project_id} does not have any suites."
+    no_suites_found= "The project {project_id} does not have any suites.",
+    invalid_json_response= "Received invalid response from TestRail server (HTTP {status_code}). "
+    "Please verify your TestRail host URL (-h) is correct and points to a valid TestRail instance. "
+    "Response preview: {response_preview}",
+    invalid_api_response= "Invalid response from TestRail API: {error_details}"
 )
 
 COMMAND_FAULT_MAPPING = dict(