Skip to content

Conversation

Boshen
Copy link
Member

@Boshen Boshen commented Sep 20, 2025

Summary

Reorganize justfile from functional groupings to component-based sections, making it easier for developers to find commands related to specific Oxc components (parser, linter, transformer, minifier, etc.).

Key Changes

New Structure

  • 🔧 Aliases - Quick reference at the top
  • ⚙️ Setup & Initialization - Project setup commands
  • 🚀 Core Development - Daily-use commands (ready, check, test, fmt, fix, doc)
  • 🛠️ Development Tools - Frequently used tools (watch, example, benchmark)
  • 🧪 Testing & Conformance - Cross-component testing
  • 🌳 AST & Codegen - Foundational components
  • 📝 Parser - Parser-specific (ready for future expansion)
  • 🔍 Linter - All linting commands including rule generation
  • ✨ Formatter - Formatter-specific (ready for future expansion)
  • 🔄 Transformer - Transformation commands
  • 📦 Minifier - Minification and optimization commands
  • 🎮 Playground - Playground development commands
  • 🔧 Utilities & Advanced - Specialized tools
  • 🖥️ Platform Helpers - OS-specific utilities

Rule Generation Improvements

  • Consolidated 15 individual new-*-rule commands into a single parameterized new-rule command
  • Maintained all legacy aliases for backward compatibility
  • Moved rule generation to Linter section for better organization

Benefits

  • 🎯 Component-focused navigation: Easy to find commands for specific Oxc components
  • 📈 Priority-based ordering: Most used commands first, specialized tools later
  • 🔮 Future-ready: Empty sections for Parser and Formatter ready for expansion
  • ✅ Zero breaking changes: All commands and aliases preserved
  • 📚 Better developer experience: Intuitive organization matching Oxc's architecture

Test plan

  • Verified all commands still work correctly (just --list, just check, just new-ts-rule)
  • Confirmed all aliases function properly (r, c, f)
  • Tested rule generation with consolidated and legacy commands
  • Ensured justfile syntax is valid

🤖 Generated with Claude Code

Reorganize justfile from functional groupings to component-based sections,
making it easier for developers to find commands related to specific Oxc
components (parser, linter, transformer, minifier, etc.).

## Key Changes

### Structure
- **Aliases**: Quick reference at the top
- **Setup & Initialization**: Project setup commands
- **Core Development**: Daily-use commands (ready, check, test, fmt, fix, doc)
- **Development Tools**: Frequently used tools (watch, example, benchmark)
- **Testing & Conformance**: Cross-component testing
- **AST & Codegen**: Foundational components
- **Component Sections**: Parser, Linter, Formatter, Transformer, Minifier, Playground
- **Utilities & Advanced**: Specialized tools
- **Platform Helpers**: OS-specific utilities

### Improvements
- **Component-focused navigation**: Easy to find commands for specific components
- **Priority-based ordering**: Most used commands first, specialized tools later
- **Future-ready**: Empty sections for Parser and Formatter ready for expansion
- **Zero breaking changes**: All commands and aliases preserved
- **Better developer experience**: Intuitive organization matching Oxc's architecture

### Rule Generation
- Consolidated 15 individual `new-*-rule` commands into a single parameterized `new-rule` command
- Maintained all legacy aliases for backward compatibility
- Moved rule generation to Linter section for better organization

## Benefits
- Developers working on specific components can quickly find relevant commands
- Maintains easy access to frequently used development commands
- Clear separation between daily-use tools and specialized component commands
- Better matches Oxc's architectural organization

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
@Copilot Copilot AI review requested due to automatic review settings September 20, 2025 10:41
Copy link
Contributor

graphite-app bot commented Sep 20, 2025

How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

  • 0-merge - adds this PR to the back of the merge queue
  • hotfix - for urgent hot fixes, skip the queue and merge this PR next

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

@github-actions github-actions bot added the C-cleanup Category - technical debt or refactoring. Solution not expected to change behavior label Sep 20, 2025
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR reorganizes the justfile from functional groupings to component-based sections, improving discoverability and making it easier for developers to find commands related to specific Oxc components. The changes consolidate rule generation commands while maintaining backward compatibility.

Key changes:

  • Restructured justfile into component-based sections with emoji headers for better navigation
  • Consolidated 15 individual new-*-rule commands into a single parameterized new-rule command
  • Maintained all legacy aliases for backward compatibility

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

@Boshen Boshen merged commit fe577f8 into main Sep 21, 2025
18 checks passed
@Boshen Boshen deleted the refactor/component-based-justfile branch September 21, 2025 05:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
C-cleanup Category - technical debt or refactoring. Solution not expected to change behavior
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant