RFC: Core Architecture Refactor Before Merge/Remote Features

[Leonardo-Garzon-1995]

Overview

As mygit grows, we are starting to reach the point where more advanced Git features (merge, fetch, push, remote tracking, etc.) will require a cleaner internal architecture.

The current implementation works well for the existing command set, but some duplication and structural inconsistencies have naturally appeared as the project expanded.

This discussion is intended to propose a refactor focused on maintainability and scalability — not a rewrite of existing functionality.

---

Goals

• Reduce duplicated logic
• Clarify separation between:
  • core Git internals
  • CLI commands
  • utilities/helpers
• Make future features like merge/remotes easier to implement
• Preserve existing command behavior
• Improve testability

---

Important

This refactor is NOT intended to invalidate or replace contributor work.

The goal is:

• preserve all existing functionality
• reorganize internals incrementally
• improve maintainability as the project grows

Where possible:

• files will be moved rather than rewritten
• history will be preserved
• refactors will happen in small PRs

---

Proposed Direction

Possible structure:

• core/

  • objects
  • refs
  • index
  • repository
  • merge internals

• commands/

  • thin CLI command wrappers

• services/

  • orchestration logic

• utils/

  • generic helpers only

---

Areas That Probably Need Consolidation

• object storage/parsing
• repository path handling
• refs manipulation
• index read/write
• compression/hash utilities

---

Questions For Contributors

• Which parts of the current structure feel hardest to work with?
• Are there modules that feel duplicated/confusing?
• Would introducing a services layer improve clarity?
• Any concerns about incremental migration?

I'll be posting a lot of issues to start migrating to the new architecture, i will try to keep the source code intact and just move into the corresponding modules and avoiding duplicates or dispersed logic.

Feedback and alternative proposals are welcome.

[Leonardo-Garzon-1995]

New project structure for refactor

mygit/
├── bin/
│   └── mygit.js              # CLI entrypoint
├── src/
│
│   ├── cli/
│   │   ├── parser.js         # argument parsing
│   │   ├── dispatcher.js     # maps commands to handlers
│   │   └── output.js         # terminal formatting/errors
│   │
│   ├── commands/
│   │   ├── init.js
│   │   ├── add.js
│   │   ├── commit.js
│   │   ├── checkout.js
│   │   ├── branch.js
│   │   ├── merge.js
│   │   └── ...
│   │
│   ├── core/
│   │
│   │   ├── repository/
│   │   │   ├── repository.js
│   │   │   ├── paths.js
│   │   │   └── config.js
│   │   │
│   │   ├── objects/
│   │   │   ├── blobs.js
│   │   │   ├── trees.js
│   │   │   ├── commits.js
│   │   │   ├── tags.js
│   │   │   ├── storage.js
│   │   │   └── parser.js
│   │   │
│   │   ├── refs/
│   │   │   ├── refs.js
│   │   │   ├── branches.js
│   │   │   ├── tags.js
│   │   │   └── head.js
│   │   │
│   │   ├── index/
│   │   │   ├── index.js
│   │   │   ├── read.js
│   │   │   ├── write.js
│   │   │   └── entries.js
│   │   │
│   │   ├── working-tree/
│   │   │   ├── status.js
│   │   │   ├── checkout.js
│   │   │   └── restore.js
│   │   │
│   │   └── merge/
│   │       ├── merge-base.js
│   │       ├── three-way.js
│   │       └── conflicts.js
│   │
│   ├── services/
│   │   ├── staging-service.js
│   │   ├── commit-service.js
│   │   ├── checkout-service.js
│   │   ├── merge-service.js
│   │   └── remote-service.js
│   │
│   ├── utils/
│   │   ├── fs.js
│   │   ├── hash.js
│   │   ├── compression.js
│   │   ├── path.js
│   │   └── validation.js
│   │
│   ├── constants.js
│   └── errors.js
│
├── test/
│   ├── unit/
│   ├── integration/
│   └── fixtures/
│
└── package.json

[Leonardo-Garzon-1995]

Refactor: init command and addition of 'repository.js` module

Add src/core/repository/repository.js module

Description
The new refactored 'repository.js' contains all the logic to manage repositories in the form of a js class. The Repository class is in charge of:

• Ensuring path correctness for all ob the .mygit initial directories and files
• Initializing a mygit repo by creating the initial directories and files
• Finding and resolving the path to .mygit/ inside a repo, even from nested directories
• Ensuring repo existance
• Resolving paths for .mygit/ and working directory wd/
• Reading 'HEAD'

Refactor init command

Description
The init command imports and use the logic from 'src/core/reposistory/repository.js`

For more information see the commit