Skip to content

Restructure repository to follow GitHub and monorepo standards#193

Merged
jaypatrick merged 4 commits intomainfrom
copilot/improve-folder-structure
Dec 27, 2025
Merged

Restructure repository to follow GitHub and monorepo standards#193
jaypatrick merged 4 commits intomainfrom
copilot/improve-folder-structure

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Dec 27, 2025

Repository layout was inconsistent with duplicate resources and unclear organization. Restructured to follow 2024 GitHub repository and multi-language monorepo best practices.

Consolidated Resources

  • API specs: Centralized to api/ from 3 duplicate locations
  • Shell scripts: src/shell/ consolidates src/rules-compiler-shell/ and src/shell-scripts/
  • PowerShell modules: src/powershell/ consolidates src/powershell-modules/ and modern modules from src/adguard-api-powershell/
  • Documentation: Moved 6 root-level docs to docs/
  • Utility scripts: Consolidated to tools/ from root and scripts/

Structure

ad-blocking/
├── api/                    # OpenAPI specifications (single source)
├── docs/                   # All documentation
├── tools/                  # Build and utility scripts
├── src/
│   ├── shell/             # Bash, Zsh scripts
│   ├── powershell/        # PowerShell modules (Common, RulesCompiler, AdGuardWebhook)
│   ├── adguard-api-*/     # API SDKs (.NET, Rust, TypeScript, PowerShell)
│   ├── rules-compiler-*/  # Compilers (.NET, Python, Rust, TypeScript)
│   └── adguard-validation/
└── [root: README, LICENSE, SECURITY, CONTRIBUTING, build/launcher scripts]

Path Updates

All references updated:

  • GitHub Actions workflows (.github/workflows/*.yml)
  • Build scripts (launcher.sh, tools/test-modules.ps1)
  • Documentation (README.md, docs/VALIDATION_ENFORCEMENT.md)

Documentation

New READMEs added:

  • CONTRIBUTING.md - Contribution guidelines (GitHub standard)
  • api/README.md - OpenAPI spec management
  • tools/README.md - Utility scripts reference
  • src/shell/README.md - Shell scripts guide
  • src/powershell/README.md - PowerShell modules guide
  • docs/RESTRUCTURING_SUMMARY.md - Complete migration guide

Deprecated Locations

Remove after verification:

  • src/rules-compiler-shell/src/shell/
  • src/shell-scripts/src/shell/
  • src/powershell-modules/src/powershell/
Original prompt

How can the overall layout, folder structure, and location of source files be done better?


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Copilot AI and others added 3 commits December 27, 2025 10:52
Co-authored-by: jaypatrick <1800595+jaypatrick@users.noreply.github.com>
Co-authored-by: jaypatrick <1800595+jaypatrick@users.noreply.github.com>
Co-authored-by: jaypatrick <1800595+jaypatrick@users.noreply.github.com>
Copilot AI changed the title [WIP] Refactor overall layout and source file location Restructure repository to follow GitHub and monorepo standards Dec 27, 2025
Copilot AI requested a review from jaypatrick December 27, 2025 11:04
@jaypatrick jaypatrick marked this pull request as ready for review December 27, 2025 20:20
@jaypatrick jaypatrick merged commit a8cc7b7 into main Dec 27, 2025
@chatgpt-codex-connector
Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@jaypatrick jaypatrick deleted the copilot/improve-folder-structure branch December 27, 2025 20:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants