gitxplain 0.1.3 → 0.1.6

package/.github/workflows/ci.yml

@@ -0,0 +1,28 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: npm
+      - name: Install dependencies
+        run: npm ci
+      - name: Lint
+        run: npm run lint
+      - name: Test
+        run: npm test
+      - name: Verify package
+        env:
+          npm_config_cache: ${{ runner.temp }}/npm-cache
+        run: npm pack --dry-run

package/.github/workflows/release.yml

@@ -0,0 +1,27 @@
+name: Release
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: npm
+          registry-url: 'https://registry.npmjs.org/'
+      - name: Install dependencies
+        run: npm ci
+      - name: Test
+        run: npm test
+      - name: Publish to npm
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npm publish

package/IMPLEMENTATION.md

@@ -2,16 +2,16 @@
 
 ## Overview
 Successfully implemented two major new features for gitxplain:
-1. **Git Connection** (`--connect-git`) - Connect GitHub account with Personal Access Token
+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. Git Connection Feature (`--connect-git`)
+### 1. GitHub Connection Feature (`--connect-github`)
 
 **Command:**
 ```bash
-gitxplain --connect-git
+gitxplain --connect-github
 ```
 
 **Functionality:**
@@ -39,7 +39,7 @@ gitxplain --boot --provider groq --model llama-3.3-70b-versatile
 ```
 
 **Functionality:**
-- Requires prior git connection (`gitxplain --connect-git`)
+- Requires prior git connection (`gitxplain --connect-github`)
 - Initializes repository context (commits, branches, status)
 - Launches interactive readline interface
 - Maintains conversation history with LLM
@@ -75,11 +75,11 @@ gitxplain --boot --provider groq --model llama-3.3-70b-versatile
 ### 3. Updated CLI (`cli/index.js`)
 
 **New Flags:**
-- `--connect-git` - Initialize GitHub connection
+- `--connect-github` - Initialize GitHub connection
 - `--boot` - Start interactive chat session
 
 **Updated Features:**
-- `parseArgs()` - Now detects `connectGit` and `boot` flags
+- `parseArgs()` - Now detects `connectGitHub` and `boot` flags
 - `handleConnectGit()` - Manages connection workflow
 - `handleBoot()` - Manages chat initialization
 - `printHelp()` - Updated documentation
@@ -103,7 +103,7 @@ gitxplain --boot --provider groq --model llama-3.3-70b-versatile
 
 ### `README.md`
 - Added new features documentation
-- Added usage examples for `--connect-git` and `--boot`
+- Added usage examples for `--connect-github` and `--boot`
 - Added section explaining chat commands
 
 ## Connection Storage
@@ -127,7 +127,7 @@ gitxplain --boot --provider groq --model llama-3.3-70b-versatile
 ## Testing
 
 ✅ All features tested and working:
-1. `--connect-git` successfully saves PAT
+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
@@ -137,7 +137,7 @@ gitxplain --boot --provider groq --model llama-3.3-70b-versatile
 
 ### Connect to GitHub
 ```bash
-gitxplain --connect-git
+gitxplain --connect-github
 # Enter your PAT when prompted
 # Output: Git Connected Successfully
 ```
@@ -172,7 +172,7 @@ You: exit
 
 ```
 CLI (index.js)
-├── parseArgs() → detects --connect-git, --boot
+├── parseArgs() → detects --connect-github, --boot
 ├── handleConnectGit()
 │   └── gitConnectionService.js
 │       ├── saveGitConnection()

package/README.md

@@ -18,8 +18,10 @@ Supported providers:
 - Supports AI-assisted commit splitting plans, with optional execution for the latest commit
 - Supports release-branch merge previews driven by detected version bumps in diffs
 - Supports automatic release tagging driven by the same version-bump detection used for release merges
+- Supports release health status checks that show missing tags, unmerged version bumps, branch drift, and next steps
 - Supports AI-assisted commit planning for uncommitted working tree changes
 - Supports quick repository log output for full history inspection
+- Supports repository-aware CI/CD workflow generation for the repo you are currently in
 - Supports single commits, commit ranges, and branch-vs-base comparisons
 - Truncates oversized diffs before sending them to the model and reports that truncation
 - Streams output for supported providers
@@ -65,22 +67,32 @@ cp .env.example .env
 
 ```bash
 gitxplain help
+gitxplain branch -a
+gitxplain checkout -b feature/demo
 gitxplain commit
 gitxplain --commit
 gitxplain merge
 gitxplain --merge
 gitxplain tag
 gitxplain --tag
+gitxplain release
+gitxplain release status
 gitxplore tag
 gitxplore --tag
 gitxplain log --log
 gitxplain status
 gitxplain --status
+gitxplain pipeline
+gitxplain --pipeline
 gitxplain add README.md
 gitxplain remove README.md
+gitxplain remove hard
 gitxplain del scratch.txt
+gitxplain bin
 gitxplain pop
 gitxplain pop 2
+gitxplain pull
+gitxplain pull origin main
 gitxplain push
 gitxplain push origin main
 gitxplain <commit-id>
@@ -146,6 +158,8 @@ Then from any Git repository:
 
 ```bash
 gitxplain help
+gitxplain --connect-github <token>
+gitxplain --boot
 gitxplain HEAD~1 --full
 gitxplain a1b2c3d --summary
 gitxplain HEAD~1 --lines
@@ -153,6 +167,16 @@ gitxplain HEAD~5..HEAD --markdown
 gitxplain --branch main --review
 ```
 
+Inside `gitxplain --boot`, the session now prints the available interactive commands on startup. You can also type `help` at any time to re-display:
+
+- `help`
+- `repos`
+- `issues`
+- `status`
+- `download`
+- `clear`
+- `exit`
+
 The `gitxplain help` command also prints quick API-key setup examples for:
 
 - OpenAI
@@ -181,9 +205,11 @@ node /home/guru/Dev/gitxplain/cli/index.js HEAD~1 --full
 - `--split`: propose how to split a commit into multiple atomic commits
 - `--merge`: preview or execute a merge into the `release` branch based on detected version bumps
 - `--tag`: preview or create release tags from the same detected version windows
+- `release status`: inspect release branch health, missing tags, source-vs-release drift, and the next recommended action
 - `--commit`: propose commits for current uncommitted changes
 - `--log`: print Git log entries for the current repository
 - `--status`: print Git working tree status for the current repository
+- `pipeline` or `--pipeline`: inspect the current repository and generate GitHub Actions CI/CD workflows
 - `--execute`: apply a proposed split by rewriting history
 - `--dry-run`: preview the split or commit plan without applying it
 - `--json`: return structured JSON instead of formatted text
@@ -211,13 +237,34 @@ Run a few common Git actions directly through `gitxplain`:
 gitxplain status
 gitxplain add README.md
 gitxplain remove README.md
+gitxplain remove hard
 gitxplain del scratch.txt
+gitxplain bin
 gitxplain pop
 gitxplain pop 2
+gitxplain pull
+gitxplain pull origin main
 gitxplain push
 gitxplain push origin main
 ```
 
+For native Git commands that do not have a custom `gitxplain` workflow, use them directly:
+
+```bash
+gitxplain branch -a
+gitxplain checkout -b feature/demo
+gitxplain rebase origin/main
+gitxplain worktree list
+```
+
+If you want to force native Git for a reserved custom command name, use the `git` wrapper:
+
+```bash
+gitxplain git commit -m "native commit message"
+gitxplain git merge feature/demo
+gitxplain git tag -a v1.2.3 -m "release"
+```
+
 ## Comparison Modes
 
 Single commit: