@autocode-cli/autocode 0.1.13 → 0.1.14

package/templates/prompts/error-handling-review.en.md

@@ -0,0 +1,24 @@
+# Error Handling Review
+
+## Role
+Verify errors are correctly handled throughout the code.
+
+## Actions
+1. Analyze critical files:
+   - src/server/api.ts (REST endpoints)
+   - src/core/ticket.ts (file operations)
+   - src/services/claude.ts (external calls)
+2. Check patterns:
+   - try/catch around I/O
+   - Appropriate HTTP codes (400, 404, 500)
+   - Explicit error messages
+3. Verify error logging
+4. Test error cases via API
+5. Check async/await errors
+
+## Validation Criteria
+- [ ] File operations in try/catch
+- [ ] Correct HTTP codes for each error
+- [ ] Clear error messages for user
+- [ ] Errors logged for debug
+- [ ] No unhandled crashes

package/templates/prompts/error-handling-review.fr.md

@@ -0,0 +1,24 @@
+# Revue de la gestion des erreurs
+
+## Rôle
+Vérifier que les erreurs sont correctement gérées dans tout le code.
+
+## Actions
+1. Analyser les fichiers critiques:
+   - src/server/api.ts (endpoints REST)
+   - src/core/ticket.ts (opérations fichiers)
+   - src/services/claude.ts (appels externes)
+2. Vérifier les patterns:
+   - try/catch autour des I/O
+   - Codes HTTP appropriés (400, 404, 500)
+   - Messages d'erreur explicites
+3. Vérifier le logging des erreurs
+4. Tester les cas d'erreur via l'API
+5. Vérifier les erreurs async/await
+
+## Critères de validation
+- [ ] Opérations fichiers dans try/catch
+- [ ] Codes HTTP corrects pour chaque erreur
+- [ ] Messages d'erreur clairs pour l'utilisateur
+- [ ] Erreurs loggées pour debug
+- [ ] Pas de crash non géré

package/templates/prompts/esm-compatibility.en.md

@@ -0,0 +1,24 @@
+# ESM Compatibility
+
+## Role
+Verify project is correctly configured as ES module.
+
+## Actions
+1. Check package.json:
+   - `"type": "module"` present
+   - `"module"` or `"exports"` configured
+2. Check tsconfig.json:
+   - `"module": "NodeNext"`
+   - `"moduleResolution": "NodeNext"`
+3. Check imports:
+   - .js extension in imports
+   - No `require()` in code
+4. Test compiled package import
+5. Verify dependency compatibility
+
+## Validation Criteria
+- [ ] `"type": "module"` in package.json
+- [ ] Imports with .js extensions
+- [ ] No require() in src/
+- [ ] Package import works
+- [ ] ESM compatible dependencies

package/templates/prompts/esm-compatibility.fr.md

@@ -0,0 +1,24 @@
+# Compatibilité ESM
+
+## Rôle
+Vérifier que le projet est correctement configuré comme module ES.
+
+## Actions
+1. Vérifier package.json:
+   - `"type": "module"` présent
+   - `"module"` ou `"exports"` configuré
+2. Vérifier tsconfig.json:
+   - `"module": "NodeNext"`
+   - `"moduleResolution": "NodeNext"`
+3. Vérifier les imports:
+   - Extension .js dans les imports
+   - Pas de `require()` dans le code
+4. Tester l'import du package compilé
+5. Vérifier la compatibilité avec les dépendances
+
+## Critères de validation
+- [ ] `"type": "module"` dans package.json
+- [ ] Imports avec extensions .js
+- [ ] Pas de require() dans src/
+- [ ] Import du package fonctionne
+- [ ] Dépendances ESM compatibles

package/templates/prompts/file-watcher-test.en.md

@@ -0,0 +1,20 @@
+# File Watcher Test
+
+## Role
+Verify file monitoring system works correctly.
+
+## Actions
+1. Start server with watcher: `node dist/index.js serve`
+2. Create a new ticket file in .autocode/tickets/
+3. Verify dashboard detects the change
+4. Modify an existing ticket
+5. Verify real-time update via WebSocket
+6. Delete a ticket
+7. Test with many files (performance)
+
+## Validation Criteria
+- [ ] File creation detected (<1s)
+- [ ] Modification detected and propagated
+- [ ] Deletion detected
+- [ ] No memory leak on prolonged watch
+- [ ] Acceptable performance with 100+ tickets

package/templates/prompts/file-watcher-test.fr.md

@@ -0,0 +1,20 @@
+# Test du file watcher
+
+## Rôle
+Vérifier que le système de surveillance des fichiers fonctionne correctement.
+
+## Actions
+1. Démarrer le serveur avec watcher: `node dist/index.js serve`
+2. Créer un nouveau fichier ticket dans .autocode/tickets/
+3. Vérifier que le dashboard détecte le changement
+4. Modifier un ticket existant
+5. Vérifier la mise à jour en temps réel via WebSocket
+6. Supprimer un ticket
+7. Tester avec de nombreux fichiers (performance)
+
+## Critères de validation
+- [ ] Création de fichier détectée (<1s)
+- [ ] Modification détectée et propagée
+- [ ] Suppression détectée
+- [ ] Pas de fuite mémoire sur watch prolongé
+- [ ] Performance acceptable avec 100+ tickets

package/templates/prompts/format-prettier-setup.en.md

@@ -0,0 +1,21 @@
+# Prettier Setup
+
+## Role
+Set up automatic code formatting with Prettier to ensure consistency.
+
+## Actions
+1. Check if Prettier is installed (`npm ls prettier`)
+2. If missing, install Prettier:
+   ```bash
+   npm install -D prettier
+   ```
+3. Create .prettierrc configuration file
+4. Create .prettierignore to exclude dist/, node_modules/
+5. Run `npx prettier --check src/` to verify
+6. Format with `npx prettier --write src/` if needed
+
+## Validation Criteria
+- [ ] Prettier is installed
+- [ ] .prettierrc exists with consistent configuration
+- [ ] `npx prettier --check src/` passes without errors
+- [ ] dist/ and node_modules/ are ignored

package/templates/prompts/format-prettier-setup.fr.md

@@ -0,0 +1,21 @@
+# Configuration Prettier
+
+## Rôle
+Mettre en place le formatage automatique du code avec Prettier pour assurer la cohérence.
+
+## Actions
+1. Vérifier si Prettier est installé (`npm ls prettier`)
+2. Si absent, installer Prettier:
+   ```bash
+   npm install -D prettier
+   ```
+3. Créer le fichier .prettierrc avec la configuration
+4. Créer .prettierignore pour exclure dist/, node_modules/
+5. Exécuter `npx prettier --check src/` pour vérifier
+6. Formater avec `npx prettier --write src/` si nécessaire
+
+## Critères de validation
+- [ ] Prettier est installé
+- [ ] .prettierrc existe avec configuration cohérente
+- [ ] `npx prettier --check src/` passe sans erreur
+- [ ] dist/ et node_modules/ sont ignorés

package/templates/prompts/git-conventional-commits.en.md

@@ -0,0 +1,21 @@
+# Conventional Commits Validation
+
+## Role
+Verify commits follow Conventional Commits convention.
+
+## Actions
+1. Analyze recent commits: `git log --oneline -20`
+2. Check format: `type(scope): description`
+3. Valid types: feat, fix, docs, style, refactor, test, chore, perf, ci, build, release
+4. Project examples:
+   - `fix(landing): update messaging`
+   - `release: v0.1.13`
+   - `feat(pipeline): add pipeline analysis`
+5. Install commitlint if missing to automate
+6. Configure husky for pre-commit hook
+
+## Validation Criteria
+- [ ] Recent commits follow format
+- [ ] Types used are valid
+- [ ] Descriptions are clear and concise
+- [ ] Scope optional but consistent

package/templates/prompts/git-conventional-commits.fr.md

@@ -0,0 +1,21 @@
+# Validation des commits conventionnels
+
+## Rôle
+Vérifier que les commits suivent la convention Conventional Commits.
+
+## Actions
+1. Analyser les derniers commits: `git log --oneline -20`
+2. Vérifier le format: `type(scope): description`
+3. Types valides: feat, fix, docs, style, refactor, test, chore, perf, ci, build, release
+4. Exemples du projet:
+   - `fix(landing): update messaging`
+   - `release: v0.1.13`
+   - `feat(pipeline): add pipeline analysis`
+5. Installer commitlint si absent pour automatiser
+6. Configurer husky pour pre-commit hook
+
+## Critères de validation
+- [ ] Derniers commits suivent le format
+- [ ] Types utilisés sont valides
+- [ ] Descriptions sont claires et concises
+- [ ] Scope optionnel mais cohérent

package/templates/prompts/git-hooks-setup.en.md

@@ -0,0 +1,27 @@
+# Git Hooks Setup
+
+## Role
+Set up git hooks to automate checks before commit.
+
+## Actions
+1. Choose a hooks manager:
+   - husky (popular)
+   - lefthook (performant)
+   - simple-git-hooks (lightweight)
+2. Install chosen manager:
+   ```bash
+   npm install -D husky && npx husky init
+   ```
+3. Configure hooks:
+   - pre-commit: lint, typecheck
+   - commit-msg: commitlint
+   - pre-push: tests
+4. Test hooks
+5. Document configuration
+
+## Validation Criteria
+- [ ] Hooks manager installed
+- [ ] pre-commit hook functional
+- [ ] commit-msg validates format
+- [ ] Hooks documented in README
+- [ ] Configuration versioned

package/templates/prompts/git-hooks-setup.fr.md

@@ -0,0 +1,27 @@
+# Configuration des git hooks
+
+## Rôle
+Mettre en place des hooks git pour automatiser les vérifications avant commit.
+
+## Actions
+1. Choisir un gestionnaire de hooks:
+   - husky (populaire)
+   - lefthook (performant)
+   - simple-git-hooks (léger)
+2. Installer le gestionnaire choisi:
+   ```bash
+   npm install -D husky && npx husky init
+   ```
+3. Configurer les hooks:
+   - pre-commit: lint, typecheck
+   - commit-msg: commitlint
+   - pre-push: tests
+4. Tester les hooks
+5. Documenter la configuration
+
+## Critères de validation
+- [ ] Gestionnaire de hooks installé
+- [ ] pre-commit hook fonctionnel
+- [ ] commit-msg valide le format
+- [ ] Hooks documentés dans README
+- [ ] Configuration versionnée

package/templates/prompts/graceful-shutdown.en.md

@@ -0,0 +1,25 @@
+# Graceful Server Shutdown Test
+
+## Role
+Verify server shuts down cleanly on system signals.
+
+## Actions
+1. Start server: `node dist/index.js serve`
+2. Send SIGINT (Ctrl+C)
+3. Verify:
+   - WebSocket connections closed
+   - File watchers stopped
+   - Port released
+   - Confirmation message
+4. Test SIGTERM:
+   ```bash
+   kill -TERM <pid>
+   ```
+5. Verify no in-flight requests lost
+
+## Validation Criteria
+- [ ] SIGINT cleanly stops server
+- [ ] SIGTERM cleanly stops server
+- [ ] WebSocket clients notified
+- [ ] Resources released
+- [ ] Exit code 0 on normal shutdown

package/templates/prompts/graceful-shutdown.fr.md

@@ -0,0 +1,25 @@
+# Test d'arrêt gracieux du serveur
+
+## Rôle
+Vérifier que le serveur s'arrête proprement sur les signaux système.
+
+## Actions
+1. Démarrer le serveur: `node dist/index.js serve`
+2. Envoyer SIGINT (Ctrl+C)
+3. Vérifier:
+   - Connexions WebSocket fermées
+   - File watchers arrêtés
+   - Port libéré
+   - Message de confirmation
+4. Tester SIGTERM:
+   ```bash
+   kill -TERM <pid>
+   ```
+5. Vérifier qu'aucune requête en cours n'est perdue
+
+## Critères de validation
+- [ ] SIGINT arrête proprement le serveur
+- [ ] SIGTERM arrête proprement le serveur
+- [ ] WebSocket clients notifiés
+- [ ] Ressources libérées
+- [ ] Exit code 0 sur arrêt normal

package/templates/prompts/i18n-completeness.en.md

@@ -0,0 +1,21 @@
+# i18n Translation Completeness
+
+## Role
+Verify all FR/EN translations are present and consistent.
+
+## Actions
+1. Identify files with translations:
+   - src/server/dashboard/ (pages, scripts)
+   - public/index.html (landing)
+   - templates/
+2. List all translation keys
+3. Verify each key has FR and EN version
+4. Validate translation quality
+5. Test language switching in dashboard
+6. Check Playwright i18n tests
+
+## Validation Criteria
+- [ ] All keys have FR and EN
+- [ ] No hardcoded text in single language
+- [ ] Translations grammatically correct
+- [ ] i18n.spec.ts test passes

package/templates/prompts/i18n-completeness.fr.md

@@ -0,0 +1,21 @@
+# Complétude des traductions i18n
+
+## Rôle
+Vérifier que toutes les traductions FR/EN sont présentes et cohérentes.
+
+## Actions
+1. Identifier les fichiers avec traductions:
+   - src/server/dashboard/ (pages, scripts)
+   - public/index.html (landing)
+   - templates/
+2. Lister toutes les clés de traduction
+3. Vérifier que chaque clé a une version FR et EN
+4. Valider la qualité des traductions
+5. Tester le switching de langue dans le dashboard
+6. Vérifier les tests Playwright i18n
+
+## Critères de validation
+- [ ] Toutes les clés ont FR et EN
+- [ ] Pas de texte hardcodé en une seule langue
+- [ ] Traductions grammaticalement correctes
+- [ ] Test i18n.spec.ts passe

package/templates/prompts/landing-html-validate.en.md

@@ -0,0 +1,23 @@
+# Landing Page Validation
+
+## Role
+Verify public HTML pages are valid and functional.
+
+## Actions
+1. Validate public/index.html HTML:
+   - Use W3C validator
+   - Check semantic structure
+2. Validate public/demo.html
+3. Check resources:
+   - Images (logo.png, logo.svg)
+   - Favicons
+   - manifest.json
+4. Test responsive design
+5. Verify bilingual support (FR/EN)
+6. Validate links and navigation
+
+## Validation Criteria
+- [ ] Valid HTML5 (no W3C errors)
+- [ ] All images load correctly
+- [ ] Responsive on mobile/tablet/desktop
+- [ ] FR/EN switching works

package/templates/prompts/landing-html-validate.fr.md

@@ -0,0 +1,23 @@
+# Validation landing page
+
+## Rôle
+Vérifier que les pages HTML publiques sont valides et fonctionnelles.
+
+## Actions
+1. Valider le HTML de public/index.html:
+   - Utiliser un validateur W3C
+   - Vérifier la structure sémantique
+2. Valider public/demo.html
+3. Vérifier les ressources:
+   - Images (logo.png, logo.svg)
+   - Favicons
+   - manifest.json
+4. Tester le responsive design
+5. Vérifier le support bilingue (FR/EN)
+6. Valider les liens et navigation
+
+## Critères de validation
+- [ ] HTML5 valide (pas d'erreurs W3C)
+- [ ] Toutes les images chargent correctement
+- [ ] Responsive sur mobile/tablet/desktop
+- [ ] Switching FR/EN fonctionne

package/templates/prompts/lint-eslint-setup.en.md

@@ -0,0 +1,20 @@
+# ESLint Setup
+
+## Role
+Set up and configure ESLint to maintain TypeScript code quality.
+
+## Actions
+1. Check if ESLint is installed (`npm ls eslint`)
+2. If missing, install ESLint with TypeScript support:
+   ```bash
+   npm install -D eslint @typescript-eslint/parser @typescript-eslint/eslint-plugin
+   ```
+3. Create/verify eslint.config.js configuration file
+4. Run `npx eslint src/` to validate code
+5. Fix detected lint errors
+
+## Validation Criteria
+- [ ] ESLint is installed and configured
+- [ ] `npx eslint src/` runs without errors
+- [ ] TypeScript rules are enabled
+- [ ] No warnings ignored without justification

package/templates/prompts/lint-eslint-setup.fr.md

@@ -0,0 +1,20 @@
+# Configuration ESLint
+
+## Rôle
+Mettre en place et configurer ESLint pour maintenir la qualité du code TypeScript.
+
+## Actions
+1. Vérifier si ESLint est installé (`npm ls eslint`)
+2. Si absent, installer ESLint avec support TypeScript:
+   ```bash
+   npm install -D eslint @typescript-eslint/parser @typescript-eslint/eslint-plugin
+   ```
+3. Créer/vérifier le fichier de configuration eslint.config.js
+4. Exécuter `npx eslint src/` pour valider le code
+5. Corriger les erreurs de lint détectées
+
+## Critères de validation
+- [ ] ESLint est installé et configuré
+- [ ] `npx eslint src/` s'exécute sans erreur
+- [ ] Les règles TypeScript sont activées
+- [ ] Aucun warning ignoré sans justification

package/templates/prompts/node-version-check.en.md

@@ -0,0 +1,21 @@
+# Node Version Check
+
+## Role
+Ensure project works with supported Node.js versions.
+
+## Actions
+1. Check engines field in package.json:
+   ```json
+   "engines": { "node": ">=18.0.0" }
+   ```
+2. Check version in .gitlab-ci.yml (node:20-alpine)
+3. Test with Node.js 18 LTS (minimum version)
+4. Test with Node.js 20 LTS (recommended)
+5. Verify ESM/CommonJS compatibility
+6. Create .nvmrc if missing
+
+## Validation Criteria
+- [ ] engines.node defined in package.json
+- [ ] Works with Node.js 18+
+- [ ] CI uses compatible version
+- [ ] .nvmrc present for developers

package/templates/prompts/node-version-check.fr.md

@@ -0,0 +1,21 @@
+# Vérification version Node.js
+
+## Rôle
+S'assurer que le projet fonctionne avec les versions Node.js supportées.
+
+## Actions
+1. Vérifier le champ engines dans package.json:
+   ```json
+   "engines": { "node": ">=18.0.0" }
+   ```
+2. Vérifier la version dans .gitlab-ci.yml (node:20-alpine)
+3. Tester avec Node.js 18 LTS (version minimale)
+4. Tester avec Node.js 20 LTS (recommandée)
+5. Vérifier la compatibilité ESM/CommonJS
+6. Créer .nvmrc si absent
+
+## Critères de validation
+- [ ] engines.node défini dans package.json
+- [ ] Fonctionne avec Node.js 18+
+- [ ] CI utilise une version compatible
+- [ ] .nvmrc présent pour les développeurs

package/templates/prompts/npm-publish-dry-run.en.md

@@ -0,0 +1,25 @@
+# npm Publish Dry Run
+
+## Role
+Validate package is ready for publishing without actually publishing.
+
+## Actions
+1. Run build: `npm run build`
+2. Check package contents:
+   ```bash
+   npm pack --dry-run
+   ```
+3. Analyze tarball size
+4. Verify included files:
+   - dist/ (compiled code)
+   - bin/ (CLI executable)
+   - templates/ (project templates)
+   - README.md, LICENSE
+5. Verify no sensitive files included
+6. Test local installation: `npm pack && npm install -g ./autocode-cli-autocode-*.tgz`
+
+## Validation Criteria
+- [ ] `npm pack --dry-run` succeeds
+- [ ] Reasonable package size (<5MB)
+- [ ] Essential files present
+- [ ] Local installation works

package/templates/prompts/npm-publish-dry-run.fr.md

@@ -0,0 +1,25 @@
+# Simulation de publication npm
+
+## Rôle
+Valider que le package est prêt pour publication sans effectuer la publication réelle.
+
+## Actions
+1. Exécuter le build: `npm run build`
+2. Vérifier le contenu du package:
+   ```bash
+   npm pack --dry-run
+   ```
+3. Analyser la taille du tarball
+4. Vérifier les fichiers inclus:
+   - dist/ (code compilé)
+   - bin/ (exécutable CLI)
+   - templates/ (templates de projet)
+   - README.md, LICENSE
+5. Vérifier qu'aucun fichier sensible n'est inclus
+6. Tester l'installation locale: `npm pack && npm install -g ./autocode-cli-autocode-*.tgz`
+
+## Critères de validation
+- [ ] `npm pack --dry-run` réussit
+- [ ] Taille du package raisonnable (<5MB)
+- [ ] Fichiers essentiels présents
+- [ ] Installation locale fonctionne

package/templates/prompts/pkg-exports-validate.en.md

@@ -0,0 +1,23 @@
+# Package Exports Validation
+
+## Role
+Verify package.json is correctly configured for npm publishing.
+
+## Actions
+1. Check essential package.json fields:
+   - name: @autocode-cli/autocode
+   - version: semver format
+   - main: dist/index.js
+   - type: module
+   - bin: { autocode: bin/autocode }
+   - files: [LICENSE, README.md, dist/, bin/, templates/]
+2. Verify engines.node >= 18.0.0
+3. Simulate publishing: `npm pack --dry-run`
+4. Check generated tarball contents
+5. Validate TypeScript exports (.d.ts)
+
+## Validation Criteria
+- [ ] All required fields present
+- [ ] `npm pack --dry-run` lists correct files
+- [ ] bin/autocode is executable
+- [ ] No sensitive files included (.env, etc.)

package/templates/prompts/pkg-exports-validate.fr.md

@@ -0,0 +1,23 @@
+# Validation des exports package
+
+## Rôle
+Vérifier que le package.json est correctement configuré pour la publication npm.
+
+## Actions
+1. Vérifier les champs essentiels de package.json:
+   - name: @autocode-cli/autocode
+   - version: format semver
+   - main: dist/index.js
+   - type: module
+   - bin: { autocode: bin/autocode }
+   - files: [LICENSE, README.md, dist/, bin/, templates/]
+2. Vérifier que engines.node >= 18.0.0
+3. Simuler la publication: `npm pack --dry-run`
+4. Vérifier le contenu du tarball généré
+5. Valider les exports TypeScript (.d.ts)
+
+## Critères de validation
+- [ ] Tous les champs requis présents
+- [ ] `npm pack --dry-run` liste les bons fichiers
+- [ ] bin/autocode est exécutable
+- [ ] Pas de fichiers sensibles inclus (.env, etc.)

package/templates/prompts/port-conflict-handling.en.md

@@ -0,0 +1,22 @@
+# Port Conflict Handling
+
+## Role
+Verify server handles occupied ports correctly.
+
+## Actions
+1. Start a process on default port (3333)
+2. Try to start autocode serve
+3. Check error message
+4. Test alternative --port option:
+   ```bash
+   node dist/index.js serve --port 3334
+   ```
+5. Verify automatic free port detection
+6. Test with multiple instances
+
+## Validation Criteria
+- [ ] Clear error message if port occupied
+- [ ] --port option works
+- [ ] No silent crash
+- [ ] Port displayed on startup
+- [ ] Graceful EADDRINUSE handling

package/templates/prompts/port-conflict-handling.fr.md

@@ -0,0 +1,22 @@
+# Gestion des conflits de port
+
+## Rôle
+Vérifier que le serveur gère correctement les ports occupés.
+
+## Actions
+1. Démarrer un processus sur le port par défaut (3333)
+2. Tenter de démarrer autocode serve
+3. Vérifier le message d'erreur
+4. Tester l'option --port alternative:
+   ```bash
+   node dist/index.js serve --port 3334
+   ```
+5. Vérifier la détection automatique de port libre
+6. Tester avec plusieurs instances
+
+## Critères de validation
+- [ ] Message d'erreur clair si port occupé
+- [ ] Option --port fonctionne
+- [ ] Pas de crash silencieux
+- [ ] Port affiché au démarrage
+- [ ] Gestion gracieuse de EADDRINUSE