Initial commit

2025-11-30 09:01:56 +08:00
commit 324f1d386c
21 changed files with 8327 additions and 0 deletions
--- a/commands/toduba-commit.md
+++ b/commands/toduba-commit.md
@@ -0,0 +1,236 @@
+---
+allowed-tools:
+  - Bash
+  - Read
+  - Grep
+argument-hint: "[message]"
+description: "Crea commit con messaggi strutturati seguendo best practices"
+---
+
+# Toduba Commit - Gestione Commit Strutturati 📝
+
+## Obiettivo
+
+Creare commit Git con messaggi ben strutturati, seguendo le convenzioni e best practices del progetto.
+
+## Argomenti
+
+- `message` (opzionale): Messaggio di commit personalizzato
+
+Argomenti ricevuti: $ARGUMENTS
+
+## Processo di Commit
+
+### Fase 1: Analisi Modifiche
+
+```bash
+# Verifica stato repository
+git status --porcelain
+
+# Mostra diff delle modifiche
+git diff --stat
+
+# Conta file modificati
+MODIFIED_FILES=$(git status --porcelain | wc -l)
+```
+
+### Fase 2: Categorizzazione Modifiche
+
+Determina il tipo di commit:
+
+- `feat`: Nuova funzionalità
+- `fix`: Bug fix
+- `docs`: Solo documentazione
+- `style`: Formattazione, no logic changes
+- `refactor`: Refactoring codice
+- `test`: Aggiunta o modifica test
+- `chore`: Manutenzione, dipendenze
+- `perf`: Performance improvements
+
+### Fase 3: Generazione Messaggio
+
+#### Formato Conventional Commits:
+
+```
+<type>(<scope>): <description>
+
+[body opzionale]
+
+[footer opzionale]
+```
+
+#### Esempi:
+
+```
+feat(auth): add JWT token refresh capability
+
+Implemented automatic token refresh when the access token expires.
+Added refresh token storage and validation logic.
+
+Closes #123
+```
+
+### Fase 4: Pre-Commit Checks
+
+```bash
+# Run linting
+npm run lint
+
+# Run tests
+npm test
+
+# Check for console.logs
+if grep -r "console.log" src/; then
+  echo "⚠️ Warning: console.log trovati nel codice"
+fi
+
+# Check for TODO comments
+if grep -r "TODO" src/; then
+  echo "📝 Reminder: TODO comments trovati"
+fi
+```
+
+### Fase 5: Creazione Commit
+
+```bash
+# Stage modifiche appropriate
+git add -A
+
+# Crea commit con messaggio strutturato
+git commit -m "$(cat <<EOF
+$COMMIT_TYPE($COMMIT_SCOPE): $COMMIT_MESSAGE
+
+$COMMIT_BODY
+
+🤖 Generated with Toduba System
+Co-Authored-By: Toduba <noreply@toduba.it>
+EOF
+)"
+```
+
+## Analisi Intelligente per Messaggio
+
+```typescript
+const generateCommitMessage = (changes) => {
+  // Analizza file modificati
+  const analysis = {
+    hasNewFiles: changes.some((c) => c.status === "A"),
+    hasDeletedFiles: changes.some((c) => c.status === "D"),
+    hasModifiedFiles: changes.some((c) => c.status === "M"),
+    mainlyFrontend:
+      changes.filter((c) => c.path.includes("components")).length > 0,
+    mainlyBackend: changes.filter((c) => c.path.includes("api")).length > 0,
+    mainlyTests: changes.filter((c) => c.path.includes(".test.")).length > 0,
+    mainlyDocs:
+      changes.filter((c) => c.path.match(/\.(md|txt|doc)/)).length > 0,
+  };
+
+  // Determina tipo
+  let type = "chore";
+  if (analysis.hasNewFiles && !analysis.mainlyTests) type = "feat";
+  if (analysis.mainlyTests) type = "test";
+  if (analysis.mainlyDocs) type = "docs";
+
+  // Determina scope
+  let scope = "general";
+  if (analysis.mainlyFrontend) scope = "ui";
+  if (analysis.mainlyBackend) scope = "api";
+  if (analysis.mainlyTests) scope = "test";
+
+  // Genera descrizione
+  const description = summarizeChanges(changes);
+
+  return {
+    type,
+    scope,
+    description,
+  };
+};
+```
+
+## Template Messaggi
+
+### Feature
+
+```
+feat(module): add new feature description
+
+- Implemented X functionality
+- Added Y configuration
+- Created Z component
+
+Related to #ISSUE
+```
+
+### Bug Fix
+
+```
+fix(module): resolve issue with X
+
+Fixed the bug where X was causing Y.
+The issue was due to Z condition not being handled.
+
+Fixes #ISSUE
+```
+
+### Refactoring
+
+```
+refactor(module): improve X structure
+
+- Extracted common logic to utilities
+- Reduced code duplication
+- Improved readability
+
+No functional changes.
+```
+
+## Output
+
+```
+🔍 Analisi modifiche in corso...
+
+📊 Riepilogo modifiche:
+- File modificati: 5
+- Aggiunti: 2
+- Modificati: 3
+- Eliminati: 0
+
+📝 Tipo di commit identificato: feat
+📁 Scope: backend
+📌 Descrizione suggerita: add user authentication endpoints
+
+✅ Pre-commit checks:
+- Linting: PASSED
+- Tests: PASSED
+- Build: PASSED
+
+💬 Messaggio di commit:
+────────────────────────────────
+feat(backend): add user authentication endpoints
+
+Implemented login, logout, and token refresh endpoints.
+Added JWT validation middleware and session management.
+
+🤖 Generated with Toduba System
+Co-Authored-By: Toduba <noreply@toduba.it>
+────────────────────────────────
+
+📤 Commit creato con successo!
+Hash: abc123def456
+Branch: feature/auth
+Files: 5 changed, 203 insertions(+), 10 deletions(-)
+
+💡 Prossimo step: git push origin feature/auth
+```
+
+## Best Practices
+
+1. Commit atomici (una feature per commit)
+2. Messaggi descrittivi e chiari
+3. Usare tempo presente imperativo
+4. Limitare subject line a 50 caratteri
+5. Body dettagliato per commit complessi
+6. Referenziare issue quando applicabile
+7. No commit di file generati/build
+8. Verificare sempre prima di committare