Adding Git Embeds and other improvements

[qxprakash]

---

Key Features and Implementations:

1. Extended EmbedArgs:

Enhanced EmbedArgs to support five scenarios:

• Git + Path: Clones the default branch and fetches the latest commit.
• Git + Path + Branch: Clones a specified branch and fetches the latest commit.
• Git + Path + Commit: Clones and checks out to a specific commit hash.
• Git + Path + Tag: Clones and checks out to a specified tag.
• Internal Nested Files: Previous flow intact

---

2. Improved Snippet Handling:

New Flow:

• Entire files are now stored as snippets, enabling efficient parsing and embedding.
• Supports embedding entire files directly when identifiers are not provided by the user.

Caching and Optimization:

• Before cloning a repo, a unique file name is generated based on arguments (git, branch/tag/commit, path).
• Snippets are saved in the .snippets directory.
• File content hashes are compared with snippet hashes to prevent unnecessary updates.
• Introduced DOCIFY_DISABLE_UPDATES to disable updates when unnecessary.

Edge Case Handling:

• Added validation for file paths:
  • Prohibited paths starting with ../.
  • For Git URLs, paths starting with .. or / are forbidden.
• Addressed Git URL edge cases by stripping .git suffixes to avoid hash mismatches.
• Added helpful error messages for all edge cases.

---

let me know if any other changes are required.

With Regards
Prakash

[sam0x17]

this looks great, I will add docs and merge this shortly!