feat(git): enhance file grouping with project boundaries

- Added ProjectBoundary interface for project detection
- Implemented project detection logic in FileGrouper
- Introduced new ProjectDetector class for scanning directories
- Updated groupByPath and normalizeScope methods for boundaries
- Added getRootDir method in GitService for directory access

Author: misaelabanto

src/git/file-grouper.ts

@@ -1,11 +1,21 @@
 import type { FileChange } from '@/git/git.service.ts';
+import type { ProjectBoundary } from '@/git/project-detector.ts';
 
 export interface FileGroup {
   scope: string;
   files: FileChange[];
 }
 
 export class FileGrouper {
+  private boundaries: ProjectBoundary[];
+
+  constructor(boundaries: ProjectBoundary[] = []) {
+    // Sort longest path first so the most specific project matches first
+    this.boundaries = [...boundaries].sort(
+      (a, b) => b.path.length - a.path.length,
+    );
+  }
+
   groupByPath(files: FileChange[]): FileGroup[] {
     if (files.length === 0) {
       return [];
@@ -33,10 +43,35 @@ export class FileGrouper {
       return 'root';
     }
 
+    const project = this.findProjectForFile(filePath);
+
+    if (project) {
+      const relativePath = filePath.slice(project.path.length + 1);
+      const relativeParts = relativePath.split('/');
+
+      if (relativeParts.length <= 1) {
+        return project.path;
+      }
+
+      const meaningfulParts = this.findMeaningfulPath(relativeParts);
+      return `${project.path}/${meaningfulParts.join('/')}`;
+    }
+
+    if (this.boundaries.length > 0) {
+      // In a monorepo, root-level files that don't belong to any project
+      return 'root';
+    }
+
     const meaningfulParts = this.findMeaningfulPath(parts);
     return meaningfulParts.join('/');
   }
 
+  private findProjectForFile(filePath: string): ProjectBoundary | undefined {
+    return this.boundaries.find(
+      b => filePath === b.path || filePath.startsWith(`${b.path}/`),
+    );
+  }
+
   private findMeaningfulPath(parts: string[]): string[] {
     const commonDirs = ['src', 'lib', 'app', 'pages'];
     const startIdx = parts.findIndex(p => commonDirs.includes(p));
@@ -55,7 +90,6 @@ export class FileGrouper {
   }
 
   optimizeGroups(groups: FileGroup[]): FileGroup[] {
-    const optimized: FileGroup[] = [];
     const scopeMap = new Map<string, FileChange[]>();
 
     for (const group of groups) {
@@ -65,6 +99,7 @@ export class FileGrouper {
       scopeMap.set(normalizedScope, existing);
     }
 
+    const optimized: FileGroup[] = [];
     for (const [scope, files] of scopeMap.entries()) {
       optimized.push({ scope, files });
     }
@@ -77,6 +112,19 @@ export class FileGrouper {
   }
 
   private normalizeScope(scope: string): string {
+    const project = this.findProjectForScope(scope);
+
+    if (project) {
+      const subScope = scope.slice(project.path.length + 1);
+      const parts = subScope.split('/');
+
+      if (parts.length > 2 && parts[0] === 'src') {
+        return `${project.path}/${parts.slice(0, 2).join('/')}`;
+      }
+
+      return scope;
+    }
+
     const parts = scope.split('/');
 
     if (parts.length > 2 && parts[0] === 'src') {
@@ -85,5 +133,10 @@ export class FileGrouper {
 
     return scope;
   }
-}
 
+  private findProjectForScope(scope: string): ProjectBoundary | undefined {
+    return this.boundaries.find(
+      b => scope === b.path || scope.startsWith(`${b.path}/`),
+    );
+  }
+}

src/git/git.service.ts

@@ -17,6 +17,10 @@ export class GitService {
     this.git = simpleGit(this.rootDir);
   }
 
+  getRootDir(): string {
+    return this.rootDir;
+  }
+
   async init(): Promise<void> {
     try {
       const root = await this.git.revparse(['--show-toplevel']);

src/git/project-detector.ts

@@ -0,0 +1,89 @@
+import { readdirSync, statSync } from 'fs';
+import { join, relative } from 'path';
+
+export interface ProjectBoundary {
+  path: string;
+  manifestFile: string;
+}
+
+const MANIFEST_FILES = [
+  'package.json',
+  'Cargo.toml',
+  'go.mod',
+  'pyproject.toml',
+  'pom.xml',
+  'build.gradle',
+  'composer.json',
+  'pubspec.yaml',
+  'mix.exs',
+  'deno.json',
+];
+
+const SKIP_DIRS = new Set([
+  'node_modules',
+  '.git',
+  'dist',
+  'build',
+  'target',
+  'vendor',
+  '__pycache__',
+  '.venv',
+  '.next',
+  '.nuxt',
+  '.turbo',
+  '.cache',
+  'coverage',
+  'out',
+]);
+
+const MAX_DEPTH = 4;
+
+export class ProjectDetector {
+  static detect(rootDir: string): ProjectBoundary[] {
+    const boundaries: ProjectBoundary[] = [];
+    this.scan(rootDir, rootDir, 0, boundaries);
+    return boundaries;
+  }
+
+  private static scan(
+    dir: string,
+    rootDir: string,
+    depth: number,
+    boundaries: ProjectBoundary[],
+  ): void {
+    if (depth > MAX_DEPTH) return;
+
+    let entries: string[];
+    try {
+      entries = readdirSync(dir);
+    } catch {
+      return;
+    }
+
+    const isRoot = dir === rootDir;
+
+    if (!isRoot) {
+      const manifest = entries.find(e => MANIFEST_FILES.includes(e));
+      if (manifest) {
+        boundaries.push({
+          path: relative(rootDir, dir),
+          manifestFile: manifest,
+        });
+        return; // Stop recursing into this project's internals
+      }
+    }
+
+    for (const entry of entries) {
+      if (SKIP_DIRS.has(entry) || entry.startsWith('.')) continue;
+
+      const fullPath = join(dir, entry);
+      try {
+        if (statSync(fullPath).isDirectory()) {
+          this.scan(fullPath, rootDir, depth + 1, boundaries);
+        }
+      } catch {
+        continue;
+      }
+    }
+  }
+}