feat: enhance GitLoomDiff with commit mode and remote handling

- Add commit hash detection and dedicated commit mode
- Implement remote changes fetching before diff generation
- Add detailed console output with file tree visualization
- Add version display and branding to CLI
- Bump version to 0.0.44

Key changes:
- New mode parameter to handle commit vs PR diffs differently
- Auto-detect commit hashes vs branch names
- Fetch remote changes automatically
- Improved CLI output with visual file tree

Author: bayuagpr-xaltius

package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitloom-diff",
-  "version": "0.0.43",
+  "version": "0.0.44",
   "description": "Git diff tool that outputs markdown formatted diffs",
   "main": "src/sdk/GitLoomDiff.js",
   "bin": {

src/cli/index.js

@@ -2,6 +2,7 @@
 
 const { program } = require("commander");
 const GitLoomDiff = require("../sdk/GitLoomDiff");
+const pkg = require("../../package.json");
 
 /**
  * Configures and runs the GitLoomDiff CLI program.
@@ -29,9 +30,26 @@ const GitLoomDiff = require("../sdk/GitLoomDiff");
  * - Commit history between refs
  * - Navigation links between files
  */
+
+// Add this helper function
+function isCommitHash(ref) {
+  // Git commit hashes are 40 chars or abbreviated to at least 7 chars
+  // and contain only hexadecimal characters
+  return ref && /^[0-9a-f]{7,40}$/i.test(ref);
+}
+
+// Add this branding function
+function showBranding() {
+  console.log(`
+🧶 GitLoom Diff v${pkg.version}
+===============================
+`);
+}
+
 program
   .name("gitloom-diff")
   .description("Generate markdown-formatted git diffs")
+  .version(pkg.version)
   .option("-s, --start-ref <ref>", "Starting reference (commit hash, branch name, or tag)")
   .option("-e, --end-ref <ref>", "Ending reference (commit hash, branch name, or tag)")
   .option("-o, --output <dir>", "Output directory", "git-diffs")
@@ -50,13 +68,20 @@ Examples:
   $ gitloom-diff -s v1.1.0 -e v1.0.0
 
   # Side-by-side diff with custom output
-  $ gitloom-diff -s main -e develop -o pr-diffs -f side-by-side`)
+  $ gitloom-diff -s main -e develop -o pr-diffs -f side-by-side
+
+  # Compare commit hashes
+  $ gitloom-diff -s 1234567890abcdef1234567890abcdef12345678 -e 0987654321fedcba0987654321fedcba09876543`)
   .action(async (options) => {
+    showBranding();
+    
     const config = {
       outputDir: options.output,
       exclusions: options.exclude || [],
       diffFormat: options.format,
-      darkMode: !options.lightMode
+      darkMode: !options.lightMode,
+      // Auto-detect mode based on ref format
+      mode: (isCommitHash(options.startRef) && isCommitHash(options.endRef)) ? 'commit' : 'pr'
     };
 
     const differ = new GitLoomDiff(config);

src/sdk/GitLoomDiff.js

@@ -14,6 +14,7 @@ class GitLoomDiff {
    * @param {string[]} [options.exclude=[]] - File patterns to exclude from the diff
    * @param {string} [options.format='diff'] - Diff format (diff, unified, side-by-side)
    * @param {boolean} [options.darkMode=true] - Whether to use dark mode theme
+   * @param {string} [options.mode='pr'] - Diff mode ('pr' or 'commit')
    */
   constructor(options = {}) {
     this.config = new Config(options);
@@ -32,6 +33,11 @@ class GitLoomDiff {
 
     try {
       await gitUtils.validateGit();
+      
+      // Add remote fetch handling
+      spinner.text = "Fetching latest remote changes...";
+      await this.#fetchRemoteChanges(startRange, endRange);
+      
       fsUtils.cleanupOutputDir(this.config.outputDir);
 
       const range = this.#buildGitRange(startRange, endRange);
@@ -45,8 +51,20 @@ class GitLoomDiff {
 
       spinner.text = "Writing index file...";
       fsUtils.writeIndexFile(this.config.outputDir, index.join("\n"));
-
+      
       spinner.succeed(`Diffs saved to ${this.config.outputDir}/`);
+      
+      // Add summary of generated content
+      console.log('\nGenerated content:');
+      console.log(`- Index file: ${this.config.outputDir}/DIFF_INDEX.md`);
+      console.log(`- Total files processed: ${changedFiles.length}`);
+      console.log(`- Files generated:`);
+      console.log(`  ${this.config.outputDir}/`);
+      console.log(`  ├── DIFF_INDEX.md`);
+      changedFiles.forEach((file, i) => {
+        const prefix = i === changedFiles.length - 1 ? '  └──' : '  ├──';
+        console.log(`${prefix} ${file}.md`);
+      });
     } catch (error) {
       spinner.fail("Failed to generate diffs");
       console.error(error);
@@ -84,7 +102,11 @@ class GitLoomDiff {
    * @private
    */
   #buildGitRange(startRange, endRange) {
-    return startRange && endRange ? `${endRange}..${startRange}` : "";
+    if (!startRange || !endRange) return "";
+    
+    return this.config.mode === 'pr' 
+      ? `${endRange}..${startRange}`   // For PR branches: target..source
+      : `${startRange}...${endRange}`; // For commit hashes: start...end
   }
 
   /**
@@ -155,6 +177,24 @@ class GitLoomDiff {
     const stats = fileInfo.match(/(\d+) insertion.+(\d+) deletion/)?.[0] || "No changes";
     index.push(`- [${file}](./${file}.md) - ${stats}`);
   }
+
+  /**
+   * Fetches latest changes from specified remote
+   * @param {string} startRange - Starting git reference (commit/branch/tag)
+   * @param {string} endRange - Ending git reference to compare against
+   * @returns {Promise<void>}
+   * @throws {Error} If git fetch fails
+   */
+  async #fetchRemoteChanges(startRange, endRange) {
+    const remotes = new Set([
+      await gitUtils.getRemote(startRange),
+      await gitUtils.getRemote(endRange)
+    ].filter(Boolean));
+
+    for (const remote of remotes) {
+      await gitUtils.fetchRemote(remote);
+    }
+  }
 }
 
 module.exports = GitLoomDiff; 

src/sdk/utils/gitUtils.js

@@ -99,6 +99,40 @@ const gitUtils = {
       `git log --pretty=format:"- %s (%h)" ${endRange}..${startRange}`
     );
     return stdout;
+  },
+
+  /**
+   * Fetches latest changes from specified remote
+   * @param {string} remote - Remote name (e.g. 'origin')
+   * @returns {Promise<void>}
+   * @throws {Error} If git fetch fails
+   */
+  async fetchRemote(remote) {
+    await execAsync(`git fetch ${remote}`);
+  },
+
+  /**
+   * Checks if reference is a remote branch
+   * @param {string} ref - Git reference to check
+   * @returns {string|null} Remote name if remote branch, null otherwise
+   */
+  async getRemote(ref) {
+    if (!ref) return null;
+    
+    try {
+      const { stdout: remotes } = await execAsync('git remote');
+      const remotesList = remotes.trim().split('\n');
+      const remoteMatch = ref.match(/^([^/]+)\//);
+      
+      if (remoteMatch && remotesList.includes(remoteMatch[1])) {
+        return remoteMatch[1];
+      }
+
+      const { stdout: remote } = await execAsync(`git config --get branch.${ref}.remote`);
+      return remote.trim() || null;
+    } catch {
+      return null;
+    }
   }
 };