@m3hti/commit-genie 1.1.4 → 1.2.1

package/README.md

@@ -30,6 +30,7 @@ A CLI tool that generates intelligent Git commit messages by analyzing your stag
 - **Custom templates** - Define your own commit message format via config
 - **Commit statistics** - Analyze your repository's commit patterns with `commit-genie stats`
 - **AI-powered descriptions** - Optional LLM integration for smarter commit messages with `--ai`
+- **Semantic role analysis** - Understands code changes by role (UI, logic, data, API, style) for intent-driven messages
 - Shows detailed file change statistics
 - Error handling for edge cases
 
@@ -453,9 +454,10 @@ CommitGenie/
 1. **Git Integration**: Executes git commands to retrieve staged changes and diff information
 2. **File Analysis**: Categorizes files by type (test, docs, config, source)
 3. **Pattern Detection**: Analyzes file paths and diff content for keywords
-4. **History Learning**: Analyzes past commits to learn your project's style (emoji usage, common scopes)
-5. **Ticket Detection**: Extracts ticket references from branch names (e.g., `feature/ABC-123-add-login`)
-6. **Message Generation**: Creates conventional commit messages based on detected patterns
+4. **Semantic Role Analysis**: Identifies what kind of code changed (UI, logic, data, API, etc.) and the intent (add, fix, refactor)
+5. **History Learning**: Analyzes past commits to learn your project's style (emoji usage, common scopes)
+6. **Ticket Detection**: Extracts ticket references from branch names (e.g., `feature/ABC-123-add-login`)
+7. **Message Generation**: Creates intent-driven commit messages based on semantic understanding
 
 ### Ticket Linking
 
@@ -480,6 +482,42 @@ CommitGenie learns from your project's commit history to match its style:
 - **Scope suggestions**: Learns common scopes from history to suggest for your files
 - **Style matching**: Adapts to your team's conventions automatically
 
+### Semantic Role Analysis
+
+CommitGenie analyzes your code changes at a semantic level to understand **what** changed and **why**, generating intent-driven commit messages:
+
+**Detected Roles:**
+| Role | Description | Patterns Detected |
+|------|-------------|-------------------|
+| `ui` | UI/rendering | JSX components, className, onClick, aria-* |
+| `logic` | Business logic | conditionals, loops, try/catch, array methods |
+| `data` | State/data management | useState, useReducer, interfaces, types |
+| `style` | Styling | CSS, styled-components, theme, sx props |
+| `api` | API integration | fetch, axios, useQuery, GraphQL |
+| `config` | Configuration | process.env, settings, constants |
+| `test` | Tests | describe, it, expect, mock |
+
+**Detected Intents:**
+- `add` - Adding new functionality
+- `modify` - Updating existing code
+- `fix` - Adding validation, guards, error handling
+- `remove` - Removing code
+- `refactor` - Code restructuring
+- `enhance` - Performance optimizations (memo, useCallback)
+
+**Example Output:**
+```
+# Instead of generic messages like:
+✨ feat: update userService.ts
+
+# You get intent-driven messages like:
+✨ feat: add UserProfile validation logic
+♻️ refactor: improve API error handling
+🐛 fix: add null check to data processing
+```
+
+The semantic analysis considers pattern significance rather than line counts, so a single important change (like adding a new React component) is weighted more heavily than multiple minor changes.
+
 ### Breaking Change Detection
 
 CommitGenie automatically detects breaking changes and formats commit messages according to Conventional Commits specification:

package/dist/services/analyzerService.d.ts

@@ -21,10 +21,62 @@ export declare class AnalyzerService {
      * Returns true if ALL changes are comments (no code changes)
      */
     private static isCommentOnlyChange;
+    /**
+     * Perform semantic analysis on the diff to understand the nature of changes
+     * This provides intent-based understanding rather than line-count metrics
+     */
+    private static analyzeSemanticChanges;
+    /**
+     * Detect which roles are affected by the changes and calculate semantic significance
+     * Significance is NOT based on line count - it's based on the semantic weight of patterns
+     */
+    private static detectRoleChanges;
+    /**
+     * Determine if a pattern represents a high-value semantic change
+     */
+    private static isHighValuePattern;
+    /**
+     * Detect the intent for changes in a specific role
+     */
+    private static detectRoleIntent;
+    /**
+     * Determine the primary role from all detected role changes
+     */
+    private static determinePrimaryRole;
+    /**
+     * Determine the overall intent of the changes
+     */
+    private static determineIntent;
+    /**
+     * Extract affected element names (components, functions, etc.) from the diff
+     */
+    private static extractAffectedElements;
+    /**
+     * Extract affected elements for a specific role
+     */
+    private static extractElementsForRole;
+    /**
+     * Generate a human-readable summary for a role change
+     */
+    private static generateRoleSummary;
+    /**
+     * Generate the WHY description for the commit
+     */
+    private static generateIntentDescription;
+    /**
+     * Generate the WHAT changed description
+     */
+    private static generateWhatChanged;
     /**
      * Generate a descriptive commit message
+     * Uses semantic analysis when available for intent-based descriptions
      */
     private static generateDescription;
+    /**
+     * Generate description based on semantic analysis
+     * Creates intent-based messages like "update UserProfile validation logic"
+     */
+    private static generateSemanticDescription;
     /**
      * Determine scope from file paths
      */
@@ -35,6 +87,7 @@ export declare class AnalyzerService {
     private static getFileName;
     /**
      * Generate commit body for larger changes
+     * Includes semantic role context when available
      */
     private static generateBody;
     /**

package/dist/services/analyzerService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyzerService.d.ts","sourceRoot":"","sources":["../../src/services/analyzerService.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,aAAa,EAA0B,iBAAiB,EAAc,MAAM,UAAU,CAAC;AAuChH,qBAAa,eAAe;IAC1B;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI,cAAc;IAmFvC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAuEpC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAoQlC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IA4B9B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IA+ClC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IA6ElC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAiD7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAK1B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IA8B3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IA8B5B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAkE/B;;OAEG;IACH,MAAM,CAAC,qBAAqB,IAAI,aAAa;IAkC7C;;OAEG;IACH,MAAM,CAAC,2BAA2B,IAAI,iBAAiB,EAAE;IAqLzD;;OAEG;WACU,yBAAyB,CAAC,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA0E5F;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,8BAA8B;CAqC9C"}
+{"version":3,"file":"analyzerService.d.ts","sourceRoot":"","sources":["../../src/services/analyzerService.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,cAAc,EAEd,aAAa,EAGb,iBAAiB,EAKlB,MAAM,UAAU,CAAC;AA0NlB,qBAAa,eAAe;IAC1B;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI,cAAc;IA0GvC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAuEpC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAoQlC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IA4B9B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IA+ClC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAuBrC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IA8ChC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAkBjC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAkD/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IA6BnC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAsD9B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAkDtC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IA8CrC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAUlC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;IA2BxC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAkClC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAmFlC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,2BAA2B;IAkD1C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAiD7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAK1B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAmD3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IA8B5B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAkE/B;;OAEG;IACH,MAAM,CAAC,qBAAqB,IAAI,aAAa;IAkC7C;;OAEG;IACH,MAAM,CAAC,2BAA2B,IAAI,iBAAiB,EAAE;IAqLzD;;OAEG;WACU,yBAAyB,CAAC,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA0E5F;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,8BAA8B;CAqC9C"}