git-cvnty 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,56 @@
+# Changelog
+
+All notable changes to git-cvnty will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [1.1.0] - 2026-03-17
+
+### Added
+
+- **Changelog Viewer** — integrated tabbed interface inspired by `jdeniau/changelog-view`
+  - Browse local `CHANGELOG.md` with per-version sidebar navigation
+  - Fetch changelogs for npm packages and GitHub repositories
+  - Terminal markdown rendering (headings, bullets, code spans)
+  - Inline package query: `package@version` or `owner/repo`
+- Stash Manager action (push, pop, drop)
+- `ink-spinner` loading indicator during network fetches
+- `semver` + `find-versions` for robust version parsing
+
+### Changed
+
+- Upgraded to `ink-select-input@5` and `ink-text-input@5` for Ink 4 compatibility
+- Changelog source can be `local` (repo file) or `package` (remote npm/GitHub)
+- Footer keyboard hints now include PageUp/PageDown for content scrolling
+- esbuild now compiles `.js` files as JSX (`loader: { '.js': 'jsx' }`)
+
+### Fixed
+
+- Corrected import paths in all component files (`../../src/git.js` → `../git.js`)
+- Removed duplicate shebang line from bundled output
+
+---
+
+## [1.0.0] - 2026-03-14
+
+### Added
+
+- Initial release of **git-cvnty** — a modern, sleek CLI git management tool
+- Built with [Ink 4](https://github.com/vadimdemedes/ink) (React 18 + ESM)
+- Gradient ASCII logo header using `ink-big-text` + `ink-gradient`
+- Live status panel (unstaged / staged changes) with color-coded file flags
+- Commit graph panel (`git log --all --graph`) using `ink-big-text`
+- Action menu with horizontal navigation:
+  - Stage Changes (individual or all files)
+  - Commit Changes
+  - Push / Pull
+  - Checkout / Create Branch
+  - Delete Branch
+- Cyan + magenta theme with round border styling
+- Keyboard hint footer (Tab, ↑↓, Enter, Esc, Ctrl+C)
+- `src/theme.js` for centralized style configuration
+- `src/git.js` with typed git utility functions (status, branch, graph, push, pull, commit, stash, diff)
+- `build.js` esbuild bundler with JSX transpilation

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Val Alexander
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,202 @@
+# git-cvnty
+
+A **modern, sleek CLI git management tool** — a complete reimagining of [GitGud](https://github.com/GitGud-org/GitGud) built with [Ink 4](https://github.com/vadimdemedes/ink) (React 18 + ESM), a built-in Changelog Viewer inspired by [changelog-view](https://github.com/jdeniau/changelog-view), and a polished cyan/magenta terminal aesthetic.
+
+```
+█▀▀ █ ▀█▀ ▄▄ █▀▀ █ █ █▄ █ ▀█▀
+ █▄█ █  █     █▄▄ ▀▄▀ █ ▀█  █
+
+  ⎇  Branch: main
+```
+
+---
+
+## Features
+
+- **Status Panels** — color-coded unstaged / staged file changes (`●` modified · `✚` added · `✖` deleted · `»` renamed)
+- **Commit Graph** — live `git log --all --graph` visualization
+- **Stage Changes** — toggle individual files or all at once
+- **Commit** — enter a commit message inline without quoting
+- **Push / Pull** — push or pull the current branch with one keypress
+- **Checkout / Create Branch** — switch to existing branch or create a new one
+- **Delete Branch** — force-delete a local branch with safety confirmation
+- **Stash Manager** — push (with optional message), pop, and drop stashes
+- **📋 Changelog Viewer** — browse changelogs right in your terminal:
+  - **Local** — reads `CHANGELOG.md` / `HISTORY.md` from your repo root, parses Keep-a-Changelog format into per-version sections
+  - **Remote** — fetch changelogs for npm packages or GitHub repos (e.g. `react`, `react@18.0.0`, `facebook/react`)
+  - Tabbed version sidebar (left) + scrollable markdown content (right)
+  - Terminal markdown rendering: headings, bullets, code spans, separators
+  - Loading spinner for network fetches
+- **Keyboard-first navigation** — Tab · ↑↓ · Enter · Esc · PageUp/PageDown
+- **Configurable theme** — edit `src/theme.js` to change colors, border style, logo visibility
+
+---
+
+## Requirements
+
+- **Node.js ≥ 18**
+- **Git ≥ 2.23** (for `git restore --staged` support)
+- npm ≥ 7
+
+---
+
+## Installation
+
+```bash
+npm install --global git-cvnty
+```
+
+Or run without installing:
+
+```bash
+npx git-cvnty
+```
+
+---
+
+## Usage
+
+Navigate to any directory that contains a `.git` folder and run:
+
+```bash
+git-cvnty
+```
+
+### Options
+
+| Flag | Description |
+|------|-------------|
+| `--no-logo` | Hide the ASCII logo at startup |
+
+### Navigation
+
+| Key | Action |
+|-----|--------|
+| `↑` / `↓` | Move between menu items |
+| `Enter` | Select / confirm |
+| `Esc` | Go back to main menu |
+| `Ctrl+C` | Quit |
+
+### Changelog Viewer — additional keys
+
+| Key | Action |
+|-----|--------|
+| `Tab` or `Shift+↑↓` | Switch between version entries |
+| `↑` / `↓` | Scroll changelog content |
+| `PageUp` / `PageDown` | Fast-scroll content |
+
+---
+
+## Changelog Viewer
+
+The **View Changelog** action provides two modes:
+
+### 1. Local CHANGELOG.md
+
+Reads the first changelog file found in your git repo root:
+
+> `CHANGELOG.md` · `HISTORY.md` · `CHANGES.md` · `ChangeLog.md` · …
+
+Parses any [Keep a Changelog](https://keepachangelog.com/) format:
+
+```markdown
+## [1.2.0] - 2024-03-01
+### Added
+- New feature
+
+## [1.1.0] - 2024-01-15
+### Fixed
+- Bug fix
+```
+
+### 2. Remote package / GitHub repo
+
+Enter a query string in any of these formats:
+
+```
+react                        # auto-detects version from node_modules
+react@18.0.0                 # shows changes since 18.0.0
+facebook/react               # GitHub owner/repo
+facebook/react@18.0.0        # GitHub repo + filter version
+```
+
+git-cvnty checks `CHANGELOG.md`, `HISTORY.md`, and GitHub Releases in order, then renders the changelog in your terminal with filtered versions.
+
+---
+
+## Building from source
+
+```bash
+git clone https://github.com/BunsDev/git-cvnty
+cd git-cvnty
+npm install
+npm run build   # compiles src/ → dist/ with esbuild
+node dist/cli.js
+```
+
+To watch for changes during development:
+
+```bash
+npm run dev
+```
+
+---
+
+## Customization
+
+Edit `src/theme.js` to change the look and feel:
+
+```js
+const theme = {
+  accent: 'cyan',        // border/heading color
+  highlight: 'magenta',  // secondary accent
+  staged: 'green',       // staged file indicator
+  unstaged: 'yellow',    // unstaged file indicator
+  border: 'round',       // 'single' | 'double' | 'round' | 'bold'
+  showLogo: true,        // show/hide the ASCII header
+};
+```
+
+---
+
+## Project Structure
+
+```
+git-cvnty/
+├── cli.js                    # Entry point (ESM, JSX via esbuild)
+├── build.js                  # esbuild bundler config
+├── CHANGELOG.md              # This project's changelog
+├── src/
+│   ├── app.js                # Main app component + action router + horizontal action menu
+│   ├── git.js                # All git operations (status, commit, push, …)
+│   ├── changelog.js          # Changelog parsing + GitHub/npm fetching
+│   ├── theme.js              # Centralized color/style config
+│   └── components/
+│       ├── Header.js         # Logo + current branch display
+│       ├── StatusPanel.js    # Unstaged/staged file panels
+│       ├── BranchPanel.js    # git log --graph visualization
+│       ├── Footer.js         # Keyboard hint bar
+│       ├── CommitDialog.js   # Commit message prompt
+│       ├── CheckoutDialog.js # Branch checkout/create
+│       ├── DeleteDialog.js   # Branch deletion
+│       ├── StageDialog.js    # File staging toggle
+│       ├── StashDialog.js    # Stash push/pop/drop
+│       ├── PushPullStatus.js # Push/pull result banner
+│       └── ChangelogDialog.js# Tabbed changelog viewer ← inspired by changelog-view
+└── dist/
+    └── cli.js                # Compiled output (auto-generated by npm run build)
+```
+
+---
+
+## Credits
+
+- Inspired by [GitGud](https://github.com/GitGud-org/GitGud) by GitGud-org
+- Changelog viewer interface inspired by [changelog-view](https://github.com/jdeniau/changelog-view) by Julien Deniau
+- Built with [Ink](https://github.com/vadimdemedes/ink) by Vadim Demedes
+
+---
+
+## License
+
+MIT