init(project): setup complete project structure

Author: NeaByteLab

.github/workflows/ci.yml

@@ -0,0 +1,74 @@
+# Node.js
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# Coverage directory used by tools like istanbul
+coverage/
+*.lcov
+
+# Dependency directories
+jspm_packages/
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variables file
+.env
+.env.test
+.env.production
+.env.local
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Build output
+dist/
+build/
+
+# Logs
+logs
+*.log
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Coverage
+.nyc_output
+
+# Temporary folders
+tmp/
+temp/
+
+# Local development
+.local/
+
+# Test output
+test-results/

.gitignore

@@ -0,0 +1,44 @@
+# Development files
+tests/
+example-demo.js
+test-auth.js
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+
+# Coverage
+coverage/
+.nyc_output/
+
+# Environment
+.env
+.env.local
+.env.test
+
+# Temporary files
+tmp/
+temp/
+
+# Git
+.git/
+.gitignore
+
+# Documentation (keep only essential)
+docs/development/
+CONTRIBUTING.md
+CHANGELOG.md
+
+# Build artifacts
+dist/
+build/

.npmignore

@@ -0,0 +1,127 @@
+# Git-Smart API Documentation
+
+## Classes
+
+### GitSmart
+
+Main class for generating commit messages.
+
+```javascript
+const { GitSmart } = require('git-smart')
+
+const gitSmart = new GitSmart({
+  interactive: false,
+  verbose: false,
+  dryRun: false
+})
+
+await gitSmart.run()
+```
+
+#### Options
+
+- `interactive` (boolean): Enable interactive mode with multiple suggestions
+- `verbose` (boolean): Show detailed analysis information
+- `dryRun` (boolean): Show suggestions without committing
+
+### MessageGenerator
+
+Generates commit messages based on analysis.
+
+```javascript
+const { MessageGenerator } = require('git-smart/src/generators/MessageGenerator')
+
+const generator = new MessageGenerator()
+const messages = generator.generateMessages(analysis, styleGuide, options)
+```
+
+#### Available Commit Types (18)
+
+**Core**: feat, fix, refactor, docs, test, style, chore, perf
+**Extended**: build, ci, security, deps, revert, hotfix, wip, merge, init, release
+
+#### Available Actions/Scopes (70+)
+
+Categories include: api, ui, auth, database, config, security, build, ci, deploy, payment, etc.
+
+### DiffAnalyzer
+
+Analyzes git diff and staged files.
+
+```javascript
+const { DiffAnalyzer } = require('git-smart/src/analyzers/DiffAnalyzer')
+
+const analyzer = new DiffAnalyzer()
+const analysis = analyzer.analyze(diff, stagedFiles)
+```
+
+### HistoryAnalyzer
+
+Analyzes commit history for style patterns.
+
+```javascript
+const { HistoryAnalyzer } = require('git-smart/src/analyzers/HistoryAnalyzer')
+
+const historyAnalyzer = new HistoryAnalyzer()
+const styleGuide = historyAnalyzer.generateStyleGuide(commits)
+```
+
+## CLI Usage
+
+```bash
+# Basic usage
+git-smart
+
+# Interactive mode
+git-smart --interactive
+
+# Dry run
+git-smart --dry-run
+
+# Verbose output
+git-smart --verbose
+
+# Help
+git-smart --help
+```
+
+## Analysis Object Structure
+
+```javascript
+{
+  changeType: 'feat',
+  confidence: 85,
+  fileChanges: {
+    added: ['src/auth.js'],
+    modified: [],
+    deleted: [],
+    renamed: [],
+    categories: Set(['code']),
+    fileTypes: Set(['JavaScript'])
+  },
+  codeChanges: {
+    newFunctions: ['authenticate'],
+    newClasses: [],
+    imports: 1,
+    exports: 1,
+    apiCalls: 0,
+    database: 0,
+    tests: 0,
+    keywords: ['auth']
+  }
+}
+```
+
+## Style Guide Object
+
+```javascript
+{
+  useConventional: true,
+  preferredPrefix: 'feat',
+  targetLength: 50,
+  includeScope: true,
+  useCapitalization: false,
+  usePeriod: false,
+  tone: 'casual'
+}
+```

API.md

@@ -0,0 +1,64 @@
+# Changelog
+
+All notable changes to Git-Smart will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2025-07-12
+
+### Added
+- 🎉 Initial release of Git-Smart
+- AI-powered commit message generation that works completely offline
+- Intelligent analysis of staged changes and code patterns
+- Learning from existing commit history for personalized style
+- Interactive mode with multiple commit message suggestions
+- Support for conventional commit format with type(action): description
+- **18 commit types** including extended types (build, ci, security, deps, etc.)
+- **70+ actions/scopes** for precise categorization
+- Automatic detection of change types with high accuracy
+- Smart action detection based on file paths, extensions, and content
+- Zero configuration setup - works out of the box
+- Support for multiple programming languages and file types
+- Dry-run mode for testing suggestions without committing
+- Verbose mode for detailed analysis information
+- Command-line interface with intuitive options
+- Comprehensive test suite with unit and integration tests
+- Complete documentation and examples
+
+### Commit Types (18 total)
+**Core Types**: feat, fix, refactor, docs, test, style, chore, perf
+**Extended Types**: build, ci, security, deps, revert, hotfix, wip, merge, init, release
+
+### Actions/Scopes (70+ total)
+- **Architecture**: api, service, controller, model, data, middleware
+- **Security**: auth, security, permission, oauth, jwt, session
+- **DevOps**: build, ci, deploy, docker, k8s, monitoring
+- **Business**: payment, order, cart, product, notification, analytics
+- **Frontend**: ui, component, view, layout, style
+- **Backend**: database, migration, schema, query
+- **And many more...**
+
+### Features
+- **Offline Operation**: No API keys or external services required
+- **Smart Analysis**: Understands code structure, functions, classes, and patterns
+- **Style Learning**: Adapts to your project's existing commit message style
+- **Conventional Commits**: Generates properly formatted conventional commit messages
+- **Multi-language Support**: Works with JavaScript, TypeScript, Python, Java, and more
+- **Interactive Prompts**: Choose from multiple suggestions or write custom messages
+- **Cross-platform**: Works on macOS, Linux, and Windows
+- **Comprehensive Detection**: File paths, extensions, keywords, and code analysis
+- **Zero Dependencies**: Completely self-contained package
+
+### Technical Details
+- Built with Node.js (requires 14.0.0+)
+- Pure JavaScript implementation with no external dependencies
+- Modular architecture with separate analyzers and generators
+- Comprehensive error handling and user feedback
+- Extensive test coverage for reliability
+
+---
+
+## Future Releases
+
+See [GitHub Issues](https://github.com/NeaDigitra/Git-Smart/issues) for planned features and improvements.