gitxplain 0.1.8 → 0.1.9

package/prompts/stash.txt

@@ -0,0 +1,34 @@
+Explain the contents of this Git stash entry.
+
+Context:
+- This stash may include staged work, unstaged work, or both.
+- Focus on what work is preserved here, why it may have been stashed, and what to watch for before applying it.
+
+Stash Message:
+{{commit_message}}
+
+Files Changed:
+{{files_changed}}
+
+Stats:
+{{stats}}
+
+Change Hints:
+{{change_hints}}
+
+Diff:
+{{diff}}
+
+Return:
+
+1. Summary:
+- Explain what work is stored in the stash
+
+2. Likely Intent:
+- Explain why a developer might have stashed these changes
+
+3. Key Changes:
+- Summarize the important code or file-level changes
+
+4. Reapply Notes:
+- Mention any cautions, missing context, or likely conflicts to watch for when applying the stash

package/prompts/test-suggest.txt

@@ -0,0 +1,29 @@
+Suggest what tests should be added or updated for this change.
+
+Commit Message:
+{{commit_message}}
+
+Files Changed:
+{{files_changed}}
+
+Stats:
+{{stats}}
+
+Change Hints:
+{{change_hints}}
+
+Diff:
+{{diff}}
+
+Return:
+
+1. Test Coverage Suggestions:
+- List the highest-value tests to add or update
+- Be specific about scenarios, assertions, and edge cases
+- If existing coverage already looks sufficient, say so clearly
+
+2. Risk Gaps:
+- Call out the most important behaviors that could regress without tests
+
+3. Suggested Test Plan:
+- Organize the recommended tests by unit, integration, or end-to-end when appropriate

package/IMPLEMENTATION.md

@@ -1,225 +0,0 @@
-# GitXplain Enhancement - Implementation Summary
-
-## Overview
-Successfully implemented two major new features for gitxplain:
-1. **GitHub Connection** (`--connect-github`) - Connect GitHub account with Personal Access Token
-2. **Interactive Chat Interface** (`--boot`) - Start a chat session with repository context
-
-## New Features
-
-### 1. GitHub Connection Feature (`--connect-github`)
-
-**Command:**
-```bash
-gitxplain --connect-github
-```
-
-**Functionality:**
-- Prompts user for GitHub Personal Access Token (PAT)
-- Saves connection securely to `~/.gitxplain/git-connection.json`
-- Displays user's git configuration (name and email)
-- Shows success message upon completion
-- Required before using `--boot` feature
-
-**Files Created:**
-- `cli/services/gitConnectionService.js` - Handles connection storage and retrieval
-
-**Key Functions:**
-- `saveGitConnection(token, provider)` - Saves PAT locally
-- `loadGitConnection()` - Retrieves saved connection
-- `isGitConnected()` - Checks if connection exists
-- `getGitUserInfo()` - Gets git user name/email
-
-### 2. Interactive Chat Interface (`--boot`)
-
-**Command:**
-```bash
-gitxplain --boot
-gitxplain --boot --provider groq --model llama-3.3-70b-versatile
-```
-
-**Functionality:**
-- Requires prior git connection (`gitxplain --connect-github`)
-- Initializes repository context (commits, branches, status)
-- Launches interactive readline interface
-- Maintains conversation history with LLM
-- Supports all LLM providers (OpenAI, Groq, OpenRouter, Gemini, Ollama, Chutes)
-
-**Files Created:**
-- `cli/services/chatService.js` - Chat interface implementation
-
-**Key Features:**
-- Repository Context Awareness
-  - Last 20 commits with abbreviated hash and message
-  - All git branches (local and remote)
-  - Current working directory status
-  
-- Chat Commands:
-  - Type normally to ask questions about the code/commits
-  - `clear` - Reset conversation history
-  - `exit` - Close chat session
-
-- Multi-Provider Support:
-  - OpenAI Compatible providers: OpenAI, Groq, OpenRouter, Chutes
-  - Specialized providers: Gemini (with custom formatting)
-  - Local providers: Ollama
-
-**Key Classes:**
-- `ChatService` - Main chat interface class
-  - `constructor(cwd, providerOverride, modelOverride)` - Initialize service
-  - `initializeRepoContext()` - Load repository information
-  - `buildSystemPrompt()` - Create context-aware system prompt
-  - `sendMessage(userMessage)` - Handle user input
-  - `startInteractiveChat()` - Main interactive loop
-
-### 3. Updated CLI (`cli/index.js`)
-
-**New Flags:**
-- `--connect-github` - Initialize GitHub connection
-- `--boot` - Start interactive chat session
-
-**Updated Features:**
-- `parseArgs()` - Now detects `connectGitHub` and `boot` flags
-- `handleConnectGit()` - Manages connection workflow
-- `handleBoot()` - Manages chat initialization
-- `printHelp()` - Updated documentation
-
-**Error Handling:**
-- Checks for git repository existence
-- Validates connection before allowing `--boot`
-- Graceful error messages for missing PAT or connection
-
-## Updated Files
-
-### `cli/services/aiService.js`
-- Exported `getProviderConfig()` function (moved from private)
-- Exported `validateProviderConfig()` function (moved from private)
-- These are now used by `chatService.js`
-
-### `package.json`
-- Updated lint script to include new service files
-  - `gitConnectionService.js`
-  - `chatService.js`
-
-### `README.md`
-- Added new features documentation
-- Added usage examples for `--connect-github` and `--boot`
-- Added section explaining chat commands
-
-## Connection Storage
-
-**Location:** `~/.gitxplain/git-connection.json`
-
-**Format:**
-```json
-{
-  "token": "github_pat_xxx",
-  "provider": "github",
-  "connectedAt": "2026-04-08T09:45:18.238Z"
-}
-```
-
-**Security Notes:**
-- Token stored locally in user's home directory
-- Not included in version control (added to `.gitignore`)
-- Can be manually deleted to disconnect
-
-## Testing
-
-✅ All features tested and working:
-1. `--connect-github` successfully saves PAT
-2. Connection file created at correct location
-3. `--boot` checks for existing connection
-4. Help text updated with new commands
-5. Syntax validation passes for all files
-
-## Usage Examples
-
-### Connect to GitHub
-```bash
-gitxplain --connect-github
-# Enter your PAT when prompted
-# Output: Git Connected Successfully
-```
-
-### Start Interactive Chat with Default Provider
-```bash
-gitxplain --boot
-# Opens chat interface with repository context
-```
-
-### Start Chat with Specific Provider
-```bash
-gitxplain --boot --provider groq --model llama-3.3-70b-versatile
-```
-
-### Chat Commands
-```
-You: What commits were made recently?
-[Assistant responds about recent commits]
-
-You: Explain the last change
-[Assistant explains based on repo context]
-
-You: clear
-[Conversation history cleared]
-
-You: exit
-[Chat session ends]
-```
-
-## Architecture
-
-```
-CLI (index.js)
-├── parseArgs() → detects --connect-github, --boot
-├── handleConnectGit()
-│   └── gitConnectionService.js
-│       ├── saveGitConnection()
-│       └── getGitUserInfo()
-└── handleBoot()
-    └── chatService.js
-        ├── ChatService class
-        ├── initializeRepoContext()
-        ├── sendMessage()
-        └── startInteractiveChat()
-            └── aiService.js
-                ├── getProviderConfig()
-                └── validateProviderConfig()
-```
-
-## Backward Compatibility
-
-✅ All existing features remain fully functional:
-- Commit analysis (`gitxplain <commit-id>`)
-- All analysis modes (--summary, --issues, --fix, --impact, --full)
-- Provider override (--provider, --model)
-- Output formatting (--json)
-- Help command
-
-## Next Steps (Optional Enhancements)
-
-1. Add token validation against GitHub API
-2. Add token expiration checking
-3. Add support for other git platforms (GitLab, Bitbucket)
-4. Add option to save chat history
-5. Add syntax highlighting in chat output
-6. Add keyboard shortcuts for chat commands
-
-## Files Modified/Created
-
-### Created:
-- `cli/services/gitConnectionService.js` (134 lines)
-- `cli/services/chatService.js` (216 lines)
-
-### Modified:
-- `cli/index.js` - Added new features, updated help, added handlers
-- `cli/services/aiService.js` - Exported previously private functions
-- `package.json` - Updated lint script
-- `README.md` - Updated documentation
-
-### Unchanged but Supporting:
-- `cli/services/gitService.js` - Git integration
-- `cli/services/outputFormatter.js` - Output formatting
-- `cli/services/promptService.js` - Prompt templates
-- Prompts directory - All prompt templates