github-archiver 1.1.5 → 1.3.0

package/CHANGELOG.md

@@ -1,5 +1,118 @@
 ## [1.1.1](https://github.com/mynameistito/github-archiver/compare/v1.1.0...v1.1.1) (2026-01-12)
 
+## 1.3.0
+
+### Minor Changes
+
+- [`3644afb`](https://github.com/mynameistito/github-archiver/commit/3644afb853d7b17e954b8f55db565f7c5f372e07) Thanks [@mynameistito](https://github.com/mynameistito)! - ## Comprehensive Test Coverage Expansion
+
+  This changeset introduces a major test coverage expansion, achieving 100% coverage on all core business logic and adding 200+ new test cases.
+
+  ### Key Changes
+
+  #### Test Coverage Improvements
+
+  - **Added 200+ new test cases** with 549 total assertions
+  - **Achieved 100% coverage on 15 src files** (71% of all src files)
+  - **95%+ coverage on all testable code**
+  - **366 passing tests** with zero failures
+  - Test execution time: ~4.8 seconds
+
+  #### Core Business Logic (100% Complete)
+
+  - All 3 constants files: 100% coverage
+  - All 4 type definition files: 100% coverage
+  - Both service files (archiver, auth-manager): 100% coverage
+  - 6 utility files (colors, config, errors, formatting, progress, logger): 98-100% coverage
+
+  #### Code Refactoring for Testability
+
+  - **archive.ts**: Exported 9 helper functions
+
+    - `validateOptions()` - validates CLI options with bounds checking
+    - `authenticateUser()` - handles GitHub authentication
+    - `getRepositories()` - reads repositories from file/stdin/interactive
+    - `logParseErrors()` - displays parsing errors with line numbers
+    - `showRepositoriesPreview()` - displays repository preview
+    - `confirmOperation()` - handles user confirmation
+    - `archiveRepositories()` - executes archiving workflow
+    - `displayResults()` - shows archiving results
+    - `handleArchiveError()` / `provideErrorGuidance()` - error handling
+
+  - **auth.ts**: Exported 6 helper functions
+    - `createLoginCommand()` - login subcommand
+    - `createLogoutCommand()` - logout subcommand
+    - `createStatusCommand()` - status subcommand
+    - `createValidateCommand()` - validate subcommand
+    - `promptForToken()` - token input prompt
+    - `confirmAction()` - confirmation prompt
+
+  #### Test Files Added/Enhanced
+
+  - `tests/unit/archive-command.test.ts` - 48 test cases for archive command logic
+  - `tests/unit/auth-command.test.ts` - 41 test cases for auth command logic
+  - Enhanced `tests/unit/github.test.ts` with 50+ test cases
+  - Enhanced `tests/unit/input-handler.test.ts` with 30+ test cases
+  - Enhanced `tests/unit/logger.test.ts` with console formatting tests
+  - Enhanced `tests/unit/parser.test.ts` with edge case coverage
+
+  #### Code Quality
+
+  - ✅ All tests comply with Ultracite code standards
+  - ✅ No console.log/debugger statements in code
+  - ✅ Proper error handling and cleanup
+  - ✅ Type-safe test implementation
+  - ✅ Comprehensive test isolation with beforeEach/afterEach
+
+  #### Documentation
+
+  - Added `COVERAGE_SUMMARY.md` with detailed coverage breakdown
+  - Added `TEST_COVERAGE_ANALYSIS.md` with comprehensive analysis
+
+  ### Coverage Metrics
+
+  | Category    | Files  | 100% Coverage   | Avg Coverage |
+  | ----------- | ------ | --------------- | ------------ |
+  | Constants   | 3      | 3/3 (100%)      | 100%         |
+  | Types       | 4      | 4/4 (100%)      | 100%         |
+  | Services    | 2      | 2/2 (100%)      | 100%         |
+  | Utilities   | 6      | 6/6 (100%)      | 99%          |
+  | Commands    | 2      | 0/2 (0%)        | 32%          |
+  | Integration | 1      | 0/1 (0%)        | 9%           |
+  | **TOTAL**   | **21** | **15/21 (71%)** | **87%**      |
+
+  ### Breaking Changes
+
+  None. All exported functions are implementation details that maintain backward compatibility.
+
+  ### Migration Guide
+
+  No migration needed. The exported functions were previously internal and are now available for testing. CLI and public API remain unchanged.
+
+  ### Future Work
+
+  For 100% coverage on remaining files:
+
+  - CLI integration tests (archive.ts, auth.ts) - requires integration test framework
+  - GitHub API mocking (github.ts) - requires API mocking library
+  - Interactive readline tests (input-handler.ts) - requires readline mock library
+
+  These require specialized testing frameworks beyond unit testing and are typically handled with dedicated integration/E2E test suites.
+
+## 1.2.0
+
+### Minor Changes
+
+- [`6948c29`](https://github.com/mynameistito/github-archiver/commit/6948c29abe67508b817a84cd95c4f88d89afdb5c) Thanks [@mynameistito](https://github.com/mynameistito)! - Migrate to Bun runtime and enhance documentation
+
+  - Migrate all npm scripts to use Bun for faster development and execution
+  - Replace tsx with native Bun TypeScript support
+  - Add comprehensive Bun installation and development documentation
+  - Improve README with Bun-first approach and npm fallback
+  - Enhance bunfig.toml configuration for better test setup
+  - Update build target to Node.js 22+
+  - Fix output formatting for improved readability
+
 ## 1.1.5
 
 ### Patch Changes

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mynameistito (Hone Tito)
+
+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

@@ -23,22 +23,30 @@ A powerful CLI for mass archiving GitHub repositories with parallel processing a
 npm install -g github-archiver
 ```
 
+or with Bun:
+
+```bash
+bun install -g github-archiver
+```
+
 ### From Source
 
 ```bash
 git clone https://github.com/mynameistito/github-archiver.git
 cd github-archiver
-npm install && npm run build
-npm install -g .
+bun install && bun run build
+bun install -g .
 ```
 
 ### Development
 
 ```bash
-npm install
-npm run dev -- <command>
+bun install
+bun run dev -- <command>
 ```
 
+**Note:** This project is optimized for [Bun](https://bun.sh). While it works with Node.js (v22+), Bun provides faster installation, execution, and development experience.
+
 ## Quick Start
 
 ```bash
@@ -55,11 +63,11 @@ github-archiver archive
 
 Manage GitHub authentication.
 
-| Command | Description |
-|---------|-------------|
-| `auth login` | Authenticate with Personal Access Token |
-| `auth logout` | Remove stored token |
-| `auth status` | Check authentication status |
+| Command        | Description                        |
+| -------------- | ---------------------------------- |
+| `auth login`   | Authenticate with Personal Access Token |
+| `auth logout`  | Remove stored token                |
+| `auth status`  | Check authentication status        |
 
 ### `archive`
 
@@ -69,15 +77,15 @@ Archive multiple repositories.
 github-archiver archive [options]
 ```
 
-| Option | Default | Description |
-|--------|---------|-------------|
-| `--file <path>` | - | Read repository URLs from file |
-| `--stdin` | - | Read from stdin |
-| `--dry-run` | false | Validate without archiving |
-| `--concurrency <n>` | 3 | Parallel operations (1-50) |
-| `--timeout <n>` | 300 | API timeout in seconds (10-3600) |
-| `--verbose` | false | Enable verbose logging |
-| `--force` | false | Skip confirmation prompts |
+| Option                | Default | Description                            |
+| --------------------- | ------- | -------------------------------------- |
+| `--file <path>`       | -       | Read repository URLs from file         |
+| `--stdin`             | -       | Read from stdin                        |
+| `--dry-run`           | false   | Validate without archiving             |
+| `--concurrency <n>`   | 3       | Parallel operations (1-50)             |
+| `--timeout <n>`       | 300     | API timeout in seconds (10-3600)       |
+| `--verbose`           | false   | Enable verbose logging                 |
+| `--force`             | false   | Skip confirmation prompts               |
 
 **Examples:**
 
@@ -148,16 +156,16 @@ Starting to archive repositories... (concurrency: 3)
 
 [=======================     ] 4/5 (80%) - owner/repo-3
 
-╔════════════════════════════════════╗
-║       Archive Operation Summary    ║
-╠════════════════════════════════════╣
-║ ✅ Successful:  5                  ║
-║ ⚠️  Skipped:     0                  ║
-║ ❌ Failed:      0                  ║
-╠════════════════════════════════════╣
-║ Total:         5                   ║
-║ Duration:      2m 45s              ║
-╚════════════════════════════════════╝
+┌────────────────────────────────────┐
+│  Archive Operation Summary         │
+├────────────────────────────────────┤
+│ Successful: 5                      │
+│ Skipped:    0                      │
+│ Failed:     0                      │
+├────────────────────────────────────┤
+│ Total:      5                      │
+│ Duration:   2m 45s                 │
+└────────────────────────────────────┘
 
 ✅ All repositories processed successfully!
 ```
@@ -216,13 +224,28 @@ tests/
 
 ## Development
 
+```bash
+bun install
+
+# Development commands
+bun run typecheck    # Check TypeScript
+bun run test         # Run unit tests
+bun run test:coverage  # Run tests with coverage
+bun run build        # Build production bundle
+bun run lint         # Check code style
+bun run format       # Auto-format code
+bun run dev -- auth login  # Run dev mode
+```
+
+**Using npm instead?**
+
 ```bash
 npm install
-npm run typecheck    # Check TypeScript
-npm run test         # Run unit tests
-npm run build        # Build production bundle
-npm run lint         # Check code style
-npm run format       # Auto-format code
+npm run typecheck    # Equivalent commands
+npm run test
+npm run build
+npm run lint
+npm run format
 ```
 
 ### Code Standards
@@ -233,7 +256,17 @@ This project uses **Ultracite** (Biome) for:
 - Consistent formatting
 - Comprehensive error handling
 
-See `AGENTS.md` for details.
+**Run code quality checks:**
+
+```bash
+# Check for issues
+bun run lint
+
+# Auto-fix and format code
+bun run format
+```
+
+See `AGENTS.md` for detailed code standards and best practices.
 
 ## Release Process
 
@@ -249,10 +282,21 @@ Pushing to `main` triggers automatic release. See [docs/RELEASE.md](docs/RELEASE
 
 ## Contributing
 
-1. Follow code standards (`npm run format`)
-2. Add tests for new features
-3. Ensure `npm run typecheck` and `npm run test` pass
-4. Create pull request with clear description
+1. Install dependencies: `bun install`
+2. Follow code standards: `bun run format`
+3. Add tests for new features
+4. Ensure `bun run typecheck` and `bun run test` pass
+5. Create pull request with clear description
+
+**Before committing:**
+
+```bash
+bun run format    # Auto-fix code style
+bun run lint      # Check for issues
+bun run typecheck # Verify TypeScript
+bun run test      # Run test suite
+bun run build     # Build production bundle
+```
 
 ## License
 
@@ -262,10 +306,22 @@ MIT - See LICENSE file for details.
 
 Check the [Troubleshooting](#troubleshooting) section or open an issue on GitHub.
 
+## Runtime & Tooling
+
+- **Runtime**: [Bun](https://bun.sh) (primary) or Node.js 22+
+- **Package Manager**: Bun (recommended) or npm
+- **Language**: TypeScript
+- **CLI Framework**: Commander.js
+- **GitHub API**: Octokit
+- **Logging**: Winston
+- **Code Quality**: Biome (via Ultracite preset)
+- **Task Queue**: p-queue
+- **Release Management**: Changesets
+
 ## Acknowledgments
 
-Built with TypeScript, Commander.js, Octokit, Winston, and Biome.
+Built with TypeScript, Commander.js, Octokit, Winston, Biome, and optimized for Bun runtime.
 
 ---
 
-Current version: 1.0.0 | [Releases](https://github.com/mynameistito/github-archiver/releases)
+[Releases](https://github.com/mynameistito/github-archiver/releases)

package/bunfig.toml

@@ -1,16 +1,16 @@
 [install]
-# Install settings inherited by tests
+# Install settings
 registry = "https://registry.npmjs.org/"
+# Use exact versions in lockfile for reproducible builds
+lockfile = "bun.lock"
 
 [env]
-# Environment variables for tests
+# Environment variables for tests and runtime
 NODE_ENV = "test"
 
 [test]
-# Test discovery
-root = "src"
-
-# Execution settings
+# Test discovery and execution
+root = "tests"
 timeout = 10000
 
 # Coverage configuration
@@ -22,5 +22,15 @@ coverageSkipTestFiles = true
 # Coverage path ignore patterns
 coveragePathIgnorePatterns = [
   "**/*.test.ts",
-  "**/*.spec.ts"
+  "**/*.spec.ts",
+  "**/node_modules/**"
 ]
+
+# Test environment
+env = "node"
+# Use Bun's test runner (default)
+run = "bun"
+
+[define]
+# Global constants for build/runtime
+"process.env.NODE_ENV" = "\"test\""