@mks2508/better-logger 0.0.2-alpha.2 → 0.3.0

package/CLAUDE.md

@@ -36,6 +36,58 @@ npm run preview      # Preview production build
 - Use browser DevTools console to see styled output
 - Click buttons to test different log levels and features
 
+### Testing & Validation
+```bash
+# Validar workflows YAML y estructura
+npm run validate:workflows
+
+# Test completo de resolución de conflictos  
+npm run test:workflows
+
+# Lint YAML con configuración personalizada
+npm run lint:yaml
+
+# Auto-fix problemas YAML comunes
+npm run fix:yaml
+```
+
+**IMPORTANTE**: Siempre ejecutar `npm run test:workflows` antes de commits que modifiquen workflows para verificar que la resolución de conflictos esté intacta.
+
+### Commits Locales Anti-Conflictos
+Para evitar conflictos localmente, **SIEMPRE usa los comandos project-utils** en lugar de `git commit` manual:
+
+```bash
+# Commit automático con AI (RECOMENDADO)
+npm run commit:auto
+
+# Commit interactivo con UI  
+npm run commit:ui
+
+# Para releases específicos
+npm run commit:auto --context "fix critical bug" --work-type "fix"
+npm run commit:auto --context "new feature" --work-type "feature"
+```
+
+**Parámetros disponibles para commit-generator:**
+```bash
+bun project-utils/commit-generator.ts [opciones]
+
+--auto-approve                # Ejecutar automáticamente sin confirmación
+--quiet                      # Ejecución silenciosa 
+--context <texto>            # Contexto del trabajo
+--work-type <tipo>           # feature|fix|refactor|docs|test
+--affected-components <lista> # Componentes: core,styling,exports,cli,docs
+--performance-impact <tipo>   # none|minor|major
+--no-push                    # Solo commit, no push
+--proposal-file <ruta>       # Usar propuesta existente
+```
+
+**Detección automática de conflictos:**
+- ✅ **Local**: Detecta automáticamente archivos de release (package.json, CHANGELOG.json) 
+- ✅ **GitHub Actions**: Detecta contexto de workflow via RELEASE_WORKFLOW=true
+- ✅ **Estrategia dual**: Pull-rebase-push con MAX_RETRIES=3 + fallback manual
+- ✅ **Smart push**: Sincronización inteligente antes de push
+
 ## Architecture Patterns
 
 ### Log Level Hierarchy
@@ -110,4 +162,43 @@ src/
   └── style.css      # Basic Vite styling (not logger-related)
 ```
 
-The logger is designed as a single-file library with comprehensive TypeScript documentation and can be imported as individual functions or as a class instance.
+The logger is designed as a single-file library with comprehensive TypeScript documentation and can be imported as individual functions or as a class instance.
+
+## Advanced Anti-Conflict System
+
+### Intelligent Conflict Detection
+The project includes an advanced conflict resolution system in `project-utils/commit-generator.ts` that:
+
+- **Type Analysis**: Detects different types of conflicts (merge, rebase, tmp-files, manual)
+- **Auto-Resolution**: Automatically resolves conflicts in temporary files
+- **Safety Backups**: Creates backup branches before dangerous operations
+- **Context Awareness**: Different strategies for local vs GitHub Actions environments
+
+### Conflict Types Handled
+- `tmp-files`: Conflicts in `.temp`, `tmp`, `.cache` directories - auto-resolvable
+- `merge`: Standard merge conflicts requiring analysis
+- `rebase`: Rebase conflicts with specialized handling
+- `manual`: Critical file conflicts requiring user intervention
+
+### Safety Features
+- **TypeCheck Integration**: Both commit-generator and commit-ui run `npm run type-check` before proceeding
+- **Backup Creation**: Automatic backup branches before risky operations (format: `backup-before-conflict-resolution-TIMESTAMP`)
+- **Critical File Protection**: Special handling for `src/`, `package.json`, `tsconfig.json`, `.github/workflows/`
+- **Manual Intervention Detection**: Identifies when user input is required vs auto-resolvable conflicts
+
+### Usage Commands
+```bash
+# Auto-commit with conflict resolution
+npm run commit:auto
+
+# Interactive UI with conflict handling
+npm run commit:ui
+
+# Test conflict resolution system
+npm run test:workflows
+```
+
+### Environment Variables
+- `GITHUB_ACTIONS=true`: Detects CI environment
+- `RELEASE_WORKFLOW=true`: Activates release-specific conflict strategies
+- `GITHUB_WORKFLOW`: Workflow name for logging and context