v4.2.1

What's Changed

📦 Changes

• 🤖 🆙🔧 Update dependabot config by @octoherd-stoe[bot] in #134
• ✨ Add community health files and governance templates by @stoe in #151

🐛 Bug Fixes

• Fix an error with meow in cli.js by @a-magdy in #152

🆙 Dependencies

• ⬆️ npm: Bump the npm group with 6 updates by @dependabot[bot] in #130
• ⬆️ npm: Bump glob from 10.4.5 to 10.5.0 by @dependabot[bot] in #132
• ⬆️ npm: Bump js-yaml by @dependabot[bot] in #131
• ⬆️ npm: Bump the npm group with 5 updates by @dependabot[bot] in #133
• ⬆️ npm: Bump the npm-development group with 2 updates by @dependabot[bot] in #136
• ⬆️ npm: Bump winston from 3.18.3 to 3.19.0 in the npm-production group by @dependabot[bot] in #135
• ⬆️ npm: Bump the npm-development group with 3 updates by @dependabot[bot] in #139
• ⬆️ npm: Bump the npm-production group across 1 directory with 3 updates by @dependabot[bot] in #138
• ⬆️ npm: Bump minimatch by @dependabot[bot] in #140
• ⬆️ npm: Bump the npm-development group with 2 updates by @dependabot[bot] in #142
• ⬆️ npm: Bump the npm-production group with 3 updates by @dependabot[bot] in #141
• ⬆️ npm: Bump the npm-development group with 6 updates by @dependabot[bot] in #146
• ⬆️ npm: Bump picomatch from 2.3.1 to 2.3.2 by @dependabot[bot] in #147
• ⬆️ npm: Bump flatted from 3.3.3 to 3.4.2 by @dependabot[bot] in #143
• ⬆️ npm: Bump csv from 6.4.1 to 6.5.1 in the npm-production group across 1 directory by @dependabot[bot] in #145
• ⬆️ Upgrade dependencies by @stoe in #150

New Contributors ✨ ✨ ✨

• @a-magdy made their first contribution in #152

Full Changelog: v4.1.1...v4.2.1

v4.1.1

What's Changed

🐛 Bug Fixes

• 🐛 GraphQL workflow processing fixes by @stoe in #129

Full Changelog: v4.1.0...v4.1.1

v4.1.0

What's Changed

📦 Changes

• 👔 Enhance hostname normalization by @stoe in #125
• 🔧 Update Node >=22 and npm >=11 by @stoe in #127
• ⬆️ Update ESLint markdown plugin by @stoe in #128

🐛 Bug Fixes

• 🐛 Fix regression in YAML parsing by @stoe in #126

Full Changelog: v4.0.3...v4.1.0

v4.0.2

What's Changed

🆙 Dependencies

• ⬆️ npm: Bump the npm group with 6 updates by @dependabot[bot] in #122
• ⬆️ npm: Bump the npm group with 5 updates by @dependabot[bot] in #123
• ⬆️ npm: Bump the npm group with 12 updates by @dependabot[bot] in #124

Full Changelog: v4.0.1...v4.0.2

v4.0.1

What's Changed

🆙 Dependencies

• ⬆️ npm: Bump the npm group with 4 updates by @dependabot in #121

Full Changelog: v4.0.0...v4.0.1

v4.0.0

What's Changed

💥 Breaking Changes

• Complete rewrite of the codebase architecture by @stoe in #120
• Changed entry point from index.js to cli.js
• Modified module exports structure in package.json
• Removed deprecated utils/ directory in favor of organized src/ structure
• Changed API contracts and interfaces

✨ New Features

• Enhanced Logging System

  • Added Winston-based logging with multiple output levels
  • Implemented spinners with Ora for better UX during long operations
  • Added debug mode with file-based logging
  • Improved warning log usage (🔊 Use warn logging more often)

• Improved Caching

  • Added dedicated cache management system in cache.js
  • Enhanced performance with persistent API response caching

• Modular Architecture

  • Created specialized GitHub entity classes (Enterprise, Repository, Owner)
  • Implemented pluggable report formats (CSV, JSON, Markdown)
  • Added options to skip archived/forked repositories

• User Experience

  • Improved report logic and generation
  • Added messaging to display report and output options
  • Enhanced CLI help text

🧰 Technical Improvements

• Code Organization

  • Reorganized codebase into logical directories:
    • src/github/: GitHub API interactions
    • src/report/: Report generation logic
    • src/util/: Utility functions

• Documentation

  • Improved README clarity and usage instructions
  • Added comprehensive contributing guidelines
  • Enhanced inline code documentation

• Testing Infrastructure

  • Complete rewrite of tests with Jest framework
  • Implemented mocks for core functionality
  • Added unit tests across all components

🐛 Bug Fixes

No specific bug fixes were included in this release as it's a complete rewrite.

🆙 Dependencies

• Node Requirements

  • Updated Node.js requirement to >=20
  • Updated npm requirement to >=10

• New Dependencies

  • ora (v8.2.0) for terminal spinners and progress indicators
  • winston (v3.17.0) for advanced logging

• Updated Core Dependencies

  • @octokit/core to v7.0.2 by @dependabot in #115
  • @octokit/plugin-paginate-rest to v13.1.0 by @dependabot in #115
  • @octokit/plugin-throttling to v11.0.1 by @dependabot in #115
  • got to v14.4.7 by @dependabot in #114
  • csv to v6.3.11
  • meow to v13.2.0
  • normalize-url to v8.0.2

• Updated Dev Dependencies

  • eslint-config-prettier to v10.1.2 by @dependabot in #115
  • eslint-plugin-prettier to v5.2.6 by @dependabot in #115
  • lint-staged to v15.5.1 by @dependabot in #115
  • All development dependencies updated to latest versions

📊 File Statistics

• Added: 25 new JavaScript files
• Removed: 3 files (index.js, utils/reporting.js, utils/wait.js)
• Total Changes: 15,557 insertions, 2,551 deletions across 54 files

🔄 Migration Guide

Users upgrading from v3.x will need to:

1. Update Node.js to version 20 or later and npm to version 10 or later

2. Update imports/requires to use the new module structure:

   // Old imports (v3)
   import Reporting from '@stoe/action-reporting-cli'
   
   // New imports (v4)
   import Report from '@stoe/action-reporting-cli'
   // or for specific components
   import { CSVReporter } from '@stoe/action-reporting-cli/report'
   import { Repository } from '@stoe/action-reporting-cli/github'

3. Review the updated CLI options and parameters

4. Update any code that directly uses the library's exports

See the documentation for detailed migration instructions.

🎉 Thank you!

@a-magdy, thank you for inspiring this rewrite!
🐙🐱💚

Full Changelog: v3.6.3...v4.0.0

v4.0.0-rc.0

Release Notes v4.0.0-rc.0

This release represents a complete architectural rewrite of the action-reporting-cli with significant enhancements and breaking changes.

📦 Changes

Complete Architectural Rewrite

• Complete codebase rewrite with a new modular architecture and organization
• Changed entry point from index.js to cli.js
• Modified module exports structure in package.json
• Organized codebase into logical directories:
  • src/github/: GitHub API interactions
  • src/report/: Report generation logic
  • src/util/: Utility functions

Enhanced Logging System

• Added Winston-based logging with multiple output levels
• Implemented spinners with Ora for better UX during long operations
• Added debug mode with file-based logging
• Improved warning log usage for better visibility

Improved Caching System

• Added dedicated cache management in src/util/cache.js
• Enhanced performance with persistent API response caching

New Features

• Added options to skip archived/forked repositories
• Improved report logic and generation
• Added messaging to display report and output options
• Enhanced CLI help text

Documentation

• Improved README clarity and usage instructions
• Added comprehensive contributing guidelines
• Enhanced inline code documentation

Testing Infrastructure

• Complete rewrite of tests with Jest framework
• Added mocks and fixtures for testing
• Implemented unit tests across all components

🐛 Bug Fixes

• No specific bug fixes were included in this release as it's a complete rewrite

🆙 Dependencies

• Updated Node.js requirement to >=20 and npm to >=10
• Added new dependencies:
  • ora (v8.2.0) for terminal spinners and progress indicators
  • winston (v3.17.0) for advanced logging
• Updated Octokit packages to latest versions:
  • @octokit/core to v7.0.2
  • @octokit/plugin-paginate-rest to v13.1.0
  • @octokit/plugin-throttling to v11.0.1
• Updated other dependencies:
  • got to v14.4.7
  • csv to v6.3.11
  • meow to v13.2.0
  • normalize-url to v8.0.2
• Updated all development dependencies to latest versions

📊 File Statistics

• Added: 25 new JavaScript files
• Removed: 3 files (index.js, utils/reporting.js, utils/wait.js)
• Total Changes: 15,557 insertions, 2,551 deletions across 54 files

🔄 Migration Guide

Users upgrading from v3.x will need to:

1. Update Node.js to version 20 or later and npm to version 10 or later

2. Update imports/requires to use the new module structure:

   // Old imports (v3)
   import Reporting from '@stoe/action-reporting-cli'
   
   // New imports (v4)
   import Report from '@stoe/action-reporting-cli'
   // or for specific components
   import {CSVReporter} from '@stoe/action-reporting-cli/report'
   import {Repository} from '@stoe/action-reporting-cli/github'

3. Review the updated CLI options and parameters

4. Update any code that directly uses the library's exports

See the documentation for detailed migration instructions.

v4.0.0-alpha.1

Full Changelog: v4.0.0-alpha.0...v4.0.0-alpha.1

v4.0.0-alpha.0

What's Changed

💥 Breaking Changes

• Complete rewrite of the codebase architecture
• Changed entry point from index.js to cli.js
• Modified module exports structure in package.json
• Removed deprecated utils/ directory in favor of organized src/ structure
• Changed API contracts and interfaces

✨ New Features

• Enhanced Logging System

  • Added Winston-based logging with multiple output levels
  • Implemented spinners with Ora for better UX during long operations
  • Added debug mode with file-based logging

• Improved Caching

  • Added dedicated cache management system in cache.js
  • Enhanced performance with persistent API response caching

• Modular Architecture

  • Created specialized GitHub entity classes (Enterprise, Repository, Owner)
  • Implemented pluggable report formats (CSV, JSON, Markdown)

• Testing Infrastructure

  • Added comprehensive Jest testing framework
  • Implemented mocks for core functionality
  • Added unit tests across all components

🧰 Technical Improvements

• Dependencies

  • Updated all dependencies to latest versions
  • Added new dependencies:
    • ora (v8.2.0) for terminal spinners
    • winston (v3.17.0) for advanced logging
  • Updated Octokit packages to latest versions

• Code Organization

  • Reorganized codebase into logical directories:
    • src/github/: GitHub API interactions
    • src/report/: Report generation logic
    • src/util/: Utility functions

• Code Quality

  • Enhanced documentation across the codebase
  • Updated build and test scripts
  • Improved error handling and reporting

Full Changelog: v3.6.3...v4.0.0-alpha.0

v3.7.0-alpha.1

v3.7.0-alpha.1