commit-analyzer 1.1.5 → 1.1.7

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "commit-analyzer",
-  "version": "1.1.5",
+  "version": "1.1.7",
+  "files": ["dist"],
   "description": "Analyze git commits and generate categories, summaries, and descriptions for each commit. Optionally generate a yearly breakdown report of your commit history.",
   "main": "dist/main.ts",
   "bin": {

package/.claude/settings.local.json

@@ -1,23 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(mkdir:*)",
-      "Bash(bun install:*)",
-      "Bash(bun run:*)",
-      "Bash(bun link:*)",
-      "Bash(npm run typecheck:*)",
-      "Bash(npm run lint)",
-      "Bash(npm run build:*)",
-      "Bash(npm run dev:*)",
-      "Bash(bun dev:*)",
-      "Bash(git log:*)",
-      "Bash(git checkout:*)",
-      "Bash(npx ts-node:*)",
-      "Bash(node:*)",
-      "Bash(npm start:*)",
-      "Bash(bun:*)"
-    ],
-    "deny": [],
-    "ask": []
-  }
-}

package/commits.csv

@@ -1,2 +0,0 @@
-year,category,summary,description
-2025,process,"Refactor project structure with numbered layers, path aliases, and automated","Major architectural reorganization moving from nested directories to numbered layer structure (1.domain, 2.application, 3.presentation, 4.infrastructure). Implements TypeScript path aliases (@domain, @app, @presentation, @infra) for cleaner imports and adds ESLint plugin for automatic import sorting and organization. All files renamed to kebab-case and imports updated throughout the codebase to use the new alias system. This improves code maintainability, reduces import path complexity, and establishes consistent file organization patterns."

package/csv-to-report-prompt.md

@@ -1,97 +0,0 @@
-# LLM Prompt Template: CSV to Markdown Report Generation
-
-This is the prompt template to be used by the LLM service to generate condensed
-markdown reports from CSV commit analysis data.
-
-## Prompt Template
-
-```
-Analyze the following CSV data containing git commit analysis results and generate a condensed markdown development summary report.
-
-CSV DATA:
-{csv_content}
-
-INSTRUCTIONS:
-1. Group the data by year (descending order, most recent first)
-2. Within each year, group by category: Features, Process Improvements, and Tweaks & Bug Fixes
-3. Consolidate similar items within each category to create readable summaries
-4. Focus on what was accomplished rather than individual commit details
-5. Use clear, professional language appropriate for stakeholders
-
-CATEGORY MAPPING:
-- "feature" → "Features" section
-- "process" → "Processes" section  
-- "tweak" → "Tweaks & Bug Fixes" section
-
-CONSOLIDATION GUIDELINES:
-- Group similar features together (e.g., "authentication system improvements")
-- Combine related bug fixes (e.g., "resolved 8 authentication issues")
-- Summarize process changes by theme (e.g., "CI/CD pipeline enhancements")
-- Use bullet points for individual items within categories
-- Aim for 3-7 bullet points per category per year
-- Include specific numbers when relevant (e.g., "15 bug fixes", "3 new features")
-
-OUTPUT FORMAT:
-Generate a markdown report with this exact structure:
-
-```markdown
-# Development Summary Report
-
-## Commit Analysis
-- **Total Commits**: [X] commits across [YEAR_RANGE]
-- **[MOST_RECENT_YEAR]**: [X] commits ([X] features, [X] process, [X] tweaks)
-- **[PREVIOUS_YEAR]**: [X] commits ([X] features, [X] process, [X] tweaks)
-- [Continue for each year in the data]
-
-## [YEAR]
-### Features
-- [Consolidated feature summary 1]
-- [Consolidated feature summary 2]
-- [Additional features as needed]
-
-### Processes
-- [Consolidated process improvement 1]
-- [Consolidated process improvement 2]
-- [Additional process items as needed]
-
-### Tweaks & Bug Fixes
-- [Consolidated tweak/fix summary 1]
-- [Consolidated tweak/fix summary 2]
-- [Additional tweaks/fixes as needed]
-
-## [PREVIOUS YEAR]
-[Repeat structure for each year in the data]
-```
-
-QUALITY REQUIREMENTS:
-- Keep summaries concise but informative
-- Use active voice and clear language
-- Avoid technical jargon where possible
-- Ensure each bullet point represents meaningful work
-- Make the report valuable for both technical and non-technical readers
-
-Generate the markdown report now:
-```
-
-## Implementation Notes
-
-This prompt should be used in the `MarkdownReportGenerator` service with the following approach:
-
-1. **Input Processing**: Replace `{csv_content}` with the actual CSV data read from the input file
-2. **LLM Call**: Send this prompt to the configured LLM (Claude, Gemini, etc.)
-3. **Response Parsing**: Extract the markdown content from the LLM response
-4. **File Output**: Write the generated markdown to the specified output file
-
-### Error Handling
-- If LLM returns malformed response, retry up to MAX_RETRIES times
-- Validate that the response contains properly formatted markdown
-- Ensure all years from the CSV data are represented in the output
-- Handle edge cases like empty categories or single-item categories
-
-### Response Validation
-The generated report should:
-- Start with "# Development Summary Report"
-- Have year sections in descending chronological order
-- Include all three category sections for each year (even if empty)
-- Use proper markdown formatting with ## for years and ### for categories
-- Contain bullet points (-) for individual items

package/eslint.config.mts

@@ -1,45 +0,0 @@
-import js from "@eslint/js"
-import { defineConfig } from "eslint/config"
-import simpleImportSort from "eslint-plugin-simple-import-sort"
-import globals from "globals"
-import tseslint from "typescript-eslint"
-
-export default defineConfig([
-  {
-    files: ["**/*.{js,mjs,cjs,ts,mts,cts}"],
-    plugins: { js },
-    extends: ["js/recommended"],
-    languageOptions: { globals: globals.node },
-  },
-  tseslint.configs.recommended,
-  {
-    plugins: {
-      "simple-import-sort": simpleImportSort,
-    },
-    rules: {
-      "simple-import-sort/imports": [
-        "warn",
-        {
-          groups: [
-            // Side effect imports
-            ["^\\u0000"],
-            // Packages. `react` related packages come first.
-            ["^react", "^@?\\w"],
-            // Aliases (adjust these regexes for your aliases)
-            ["^@domain"],
-            ["^@app"],
-            ["^@presentation"],
-            ["^@infra"],
-            // Parent imports
-            ["^\\.\\.(?!/?$)", "^\\.\\./?$"],
-            // Relative imports
-            ["^\\./(?=.*/)(?!/?$)", "^\\.(?!/?$)", "^\\./?$"],
-            // Style imports
-            ["^.+\\.s?css$"],
-          ],
-        },
-      ],
-      "simple-import-sort/exports": "warn",
-    },
-  },
-])

package/prompt.md

@@ -1,69 +0,0 @@
-# Prompt for Git Commit Analysis Program
-
-  Create a TypeScript/Node.js program that analyzes git commits and generates
-  categorized summaries.
-
-  The program should:
-
-## Input Requirements
-
-  - Accept a list of git commit hashes as input (command line arguments or file)
-  - For each commit, extract the commit message, date, and diff
-
-  Core Functionality:
-
-  1. Git Integration:
-     Use git show and git diff to get commit details and changes
-  2. LLM Analysis:
-     Send commit message + diff to the claude cli for categorization.
-  3. CSV Export:
-     Generate output with columns:
-     year, category, summary, description
-
-## LLM Prompt Template
-
-  Analyze this git commit and provide a categorization:
-
-  - COMMIT MESSAGE:
-    {commit_message}
-  - COMMIT DIFF:
-    {diff_content}
-
-  Based on the commit message and code changes, categorize this commit as one
-  of:
-  - "tweak":
-    Minor adjustments, bug fixes, small improvements
-  - "feature":
-    New functionality, major additions
-  - "process":
-    Build system, CI/CD, tooling, configuration changes
-
-  Provide:
-  1. Category:
-     [tweak|feature|process]
-  2. Summary:
-     One-line description (max 80 chars)
-  3. Description:
-     Detailed explanation (2-3 sentences)
-
-  Format as JSON: 
-  ```json
-  { 
-    "category": "...", 
-    "summary": "...",
-    "description": "..."
-  }
-  ```
-
-### Technical Implementation
-
-  - Use Node.js with TypeScript
-  - Extract timestamp from git commit
-
-  Output Format:
-
-  CSV with headers:
-  timestamp,category,summary,description
-
-  The program should be robust, handle edge cases, and provide clear error
-  messages for invalid commits or API failures.

package/src/1.domain/analysis.ts

@@ -1,93 +0,0 @@
-import { Category } from "./category"
-
-/**
- * Domain entity representing the analysis of a commit
- */
-export class Analysis {
-  private static readonly MAX_SUMMARY_LENGTH = 80
-  private static readonly MIN_DESCRIPTION_LENGTH = 10
-  private readonly category: Category
-  private readonly summary: string
-  private readonly description: string
-
-  constructor(params: {
-    category: Category
-    summary: string
-    description: string
-  }) {
-    const { category, summary, description } = params
-    this.category = category
-    this.summary = summary
-    this.description = description
-
-    if (!summary || summary.trim().length === 0) {
-      throw new Error("Summary cannot be empty")
-    }
-
-    if (!description || description.trim().length === 0) {
-      throw new Error("Description cannot be empty")
-    }
-
-    if (summary.length > Analysis.MAX_SUMMARY_LENGTH) {
-      throw new Error(
-        `Summary cannot exceed ${Analysis.MAX_SUMMARY_LENGTH} characters`,
-      )
-    }
-
-    if (description.length < Analysis.MIN_DESCRIPTION_LENGTH) {
-      throw new Error(
-        `Description must be at least ${Analysis.MIN_DESCRIPTION_LENGTH} characters`,
-      )
-    }
-  }
-
-  getCategory(): Category {
-    return this.category
-  }
-
-  getSummary(): string {
-    return this.summary
-  }
-
-  getDescription(): string {
-    return this.description
-  }
-
-  getSummaryTruncated(): string {
-    return this.summary.length > Analysis.MAX_SUMMARY_LENGTH
-      ? this.summary.substring(0, Analysis.MAX_SUMMARY_LENGTH - 3) + "..."
-      : this.summary
-  }
-
-  isFeatureAnalysis(): boolean {
-    return this.category.isFeature()
-  }
-
-  isTweakAnalysis(): boolean {
-    return this.category.isTweak()
-  }
-
-  isProcessAnalysis(): boolean {
-    return this.category.isProcess()
-  }
-
-  equals(other: Analysis): boolean {
-    return (
-      this.category.equals(other.category) &&
-      this.summary === other.summary &&
-      this.description === other.description
-    )
-  }
-
-  toPlainObject(): {
-    category: string
-    summary: string
-    description: string
-  } {
-    return {
-      category: this.category.getValue(),
-      summary: this.summary,
-      description: this.description,
-    }
-  }
-}

package/src/1.domain/analyzed-commit.ts

@@ -1,97 +0,0 @@
-import { Analysis } from "./analysis"
-import { Commit } from "./commit"
-import { CommitHash } from "./commit-hash"
-
-/**
- * Domain entity representing a commit with its analysis
- */
-export class AnalyzedCommit {
-  constructor(
-    private readonly commit: Commit,
-    private readonly analysis: Analysis,
-  ) {
-    if (!commit) {
-      throw new Error("Commit is required")
-    }
-
-    if (!analysis) {
-      throw new Error("Analysis is required")
-    }
-  }
-
-  getCommit(): Commit {
-    return this.commit
-  }
-
-  getAnalysis(): Analysis {
-    return this.analysis
-  }
-
-  getHash(): CommitHash {
-    return this.commit.getHash()
-  }
-
-  getMessage(): string {
-    return this.commit.getMessage()
-  }
-
-  getDate(): Date {
-    return this.commit.getDate()
-  }
-
-  getYear(): number {
-    return this.commit.getYear()
-  }
-
-  getShortHash(length: number = 8): string {
-    return this.commit.getShortHash(length)
-  }
-
-  isLargeChange(): boolean {
-    return this.commit.isLargeChange()
-  }
-
-  equals(other: AnalyzedCommit): boolean {
-    return (
-      this.commit.equals(other.commit) && this.analysis.equals(other.analysis)
-    )
-  }
-
-  toCSVRow(): {
-    timestamp: string
-    category: string
-    summary: string
-    description: string
-  } {
-    return {
-      timestamp: this.getDate().toISOString(),
-      category: this.analysis.getCategory().getValue(),
-      summary: this.analysis.getSummary(),
-      description: this.analysis.getDescription(),
-    }
-  }
-
-  toReportData(): {
-    hash: string
-    shortHash: string
-    message: string
-    date: Date
-    year: number
-    category: string
-    summary: string
-    description: string
-    isLargeChange: boolean
-  } {
-    return {
-      hash: this.commit.getHash().getValue(),
-      shortHash: this.getShortHash(),
-      message: this.getMessage(),
-      date: this.getDate(),
-      year: this.getYear(),
-      category: this.analysis.getCategory().getValue(),
-      summary: this.analysis.getSummary(),
-      description: this.analysis.getDescription(),
-      isLargeChange: this.isLargeChange(),
-    }
-  }
-}

package/src/1.domain/application-error.ts

@@ -1,32 +0,0 @@
-/**
- * Base class for application errors
- */
-export abstract class ApplicationError extends Error {
-  constructor(
-    message: string,
-    public readonly code: string,
-  ) {
-    super(message)
-    this.name = "ApplicationError"
-  }
-}
-
-/**
- * Error for validation failures
- */
-export class ValidationError extends ApplicationError {
-  constructor(message: string) {
-    super(message, "VALIDATION_ERROR")
-    this.name = "ValidationError"
-  }
-}
-
-/**
- * Error for not found resources
- */
-export class NotFoundError extends ApplicationError {
-  constructor(resource: string, identifier: string) {
-    super(`${resource} not found: ${identifier}`, "NOT_FOUND")
-    this.name = "NotFoundError"
-  }
-}

package/src/1.domain/category.ts

@@ -1,52 +0,0 @@
-/**
- * Value object for commit analysis category
- */
-export type CategoryType = "tweak" | "feature" | "process"
-
-export class Category {
-  private static readonly VALID_CATEGORIES: CategoryType[] = ["tweak", "feature", "process"]
-
-  private constructor(private readonly value: CategoryType) {}
-
-  static create(category: string): Category {
-    if (!category || typeof category !== 'string') {
-      throw new Error('Category cannot be empty')
-    }
-
-    const normalizedCategory = category.toLowerCase().trim() as CategoryType
-    
-    if (!this.VALID_CATEGORIES.includes(normalizedCategory)) {
-      throw new Error(`Invalid category: ${category}. Must be one of: ${this.VALID_CATEGORIES.join(', ')}`)
-    }
-
-    return new Category(normalizedCategory)
-  }
-
-  static fromType(category: CategoryType): Category {
-    return new Category(category)
-  }
-
-  getValue(): CategoryType {
-    return this.value
-  }
-
-  equals(other: Category): boolean {
-    return this.value === other.value
-  }
-
-  toString(): string {
-    return this.value
-  }
-
-  isFeature(): boolean {
-    return this.value === "feature"
-  }
-
-  isTweak(): boolean {
-    return this.value === "tweak"
-  }
-
-  isProcess(): boolean {
-    return this.value === "process"
-  }
-}

package/src/1.domain/commit-analysis-service.ts

@@ -1,92 +0,0 @@
-import { IAnalysisRepository } from "@presentation/analysis-repository.interface"
-import { ICommitRepository } from "@presentation/commit-repository.interface"
-
-import { AnalyzedCommit } from "./analyzed-commit"
-import { Commit } from "./commit"
-import { CommitHash } from "./commit-hash"
-
-/**
- * Domain service for commit analysis operations
- */
-export class CommitAnalysisService {
-  constructor(
-    private readonly commitRepository: ICommitRepository,
-    private readonly analysisRepository: IAnalysisRepository,
-  ) {}
-
-  /**
-   * Analyzes a single commit
-   */
-  async analyzeCommit(hash: CommitHash): Promise<AnalyzedCommit> {
-    const commit = await this.commitRepository.getByHash(hash)
-    const analysis = await this.analysisRepository.analyze(commit)
-
-    return new AnalyzedCommit(commit, analysis)
-  }
-
-  /**
-   * Analyzes multiple commits
-   */
-  async analyzeCommits(hashes: CommitHash[]): Promise<AnalyzedCommit[]> {
-    const analyzedCommits: AnalyzedCommit[] = []
-
-    for (const hash of hashes) {
-      try {
-        const analyzedCommit = await this.analyzeCommit(hash)
-        analyzedCommits.push(analyzedCommit)
-      } catch (error) {
-        // Re-throw the error - let the application layer handle logging
-        throw new Error(
-          `Failed to analyze commit ${hash.getShortHash()}: ${error instanceof Error ? error.message : String(error)}`,
-        )
-      }
-    }
-
-    return analyzedCommits
-  }
-
-  /**
-   * Validates that all commit hashes exist
-   */
-  async validateCommits(
-    hashes: CommitHash[],
-  ): Promise<{ valid: CommitHash[]; invalid: CommitHash[] }> {
-    const valid: CommitHash[] = []
-    const invalid: CommitHash[] = []
-
-    for (const hash of hashes) {
-      const exists = await this.commitRepository.exists(hash)
-      if (exists) {
-        valid.push(hash)
-      } else {
-        invalid.push(hash)
-      }
-    }
-
-    return { valid, invalid }
-  }
-
-  /**
-   * Gets commits authored by the current user
-   */
-  async getCurrentUserCommits(params?: {
-    limit?: number
-    since?: string
-    until?: string
-  }): Promise<Commit[]> {
-    const userEmail = await this.commitRepository.getCurrentUserEmail()
-    return this.commitRepository.getByAuthor({
-      authorEmail: userEmail,
-      limit: params?.limit,
-      since: params?.since,
-      until: params?.until,
-    })
-  }
-
-  /**
-   * Checks if the analysis service is ready
-   */
-  async isAnalysisServiceReady(): Promise<boolean> {
-    return this.analysisRepository.isAvailable()
-  }
-}

package/src/1.domain/commit-hash.ts

@@ -1,40 +0,0 @@
-/**
- * Value object for Git commit hash
- */
-export class CommitHash {
-  private constructor(private readonly value: string) {}
-
-  static create(hash: string): CommitHash {
-    if (!hash || typeof hash !== 'string') {
-      throw new Error('Commit hash cannot be empty')
-    }
-
-    // Git short hash is minimum 4 characters, full hash is 40
-    if (hash.length < 4 || hash.length > 40) {
-      throw new Error('Invalid commit hash length')
-    }
-
-    // Only hexadecimal characters allowed
-    if (!/^[a-f0-9]+$/i.test(hash)) {
-      throw new Error('Commit hash must contain only hexadecimal characters')
-    }
-
-    return new CommitHash(hash)
-  }
-
-  getValue(): string {
-    return this.value
-  }
-
-  getShortHash(length: number = 8): string {
-    return this.value.substring(0, Math.min(length, this.value.length))
-  }
-
-  equals(other: CommitHash): boolean {
-    return this.value === other.value
-  }
-
-  toString(): string {
-    return this.value
-  }
-}