@followthecode/cli 1.1.8 → 1.1.10

package/README.md

@@ -488,4 +488,50 @@ ftc code "./meu-repo" --csv --export s3://meu-bucket/analises/resultado.csv
 - Se `--s3-bucket` não for informado, será usado o bucket padrão `ftc-analyzer`.
 - Para JSON: Se `--s3-key` não for informado, será usado o padrão `analises/<nome_repositorio>-ano-mes-dia.json`.
 - Para CSV: Se `--s3-key` não for informado, será usado o padrão `analises/<nome_repositorio>-ano-mes-dia.csv`.
-- O parâmetro `--s3-region` pode ser usado para especificar a região AWS. 
+- O parâmetro `--s3-region` pode ser usado para especificar a região AWS. 
+
+## Exportação via API HTTP (x-apikey)
+
+Agora é possível exportar arquivos diretamente para uma API HTTP utilizando o header `x-apikey`.
+
+**Exemplo de configuração:**
+
+```
+api:https://sua-api.com/upload?apikey=SEU_API_KEY
+```
+
+- O arquivo será compactado (gzip) e enviado via POST para a URL informada.
+- O header `x-apikey` será preenchido automaticamente com o valor fornecido.
+- O header `x-provider` será enviado se especificado na URL.
+- O conteúdo enviado será do tipo `application/octet-stream` com encoding `gzip`.
+
+**Uso no código:**
+
+```csharp
+await ExportHelper.ExportDataAsync(
+    dados, 
+    "api:https://sua-api.com/upload?apikey=SEU_API_KEY",
+    repoPath,
+    serviceProvider,
+    ExportFormat.Json
+);
+``` 
+
+### Exemplo: Envio de arquivo compactado para o endpoint de commit-files
+
+```
+api:https://ftc-api.eximia.co/collect/commit-files?apikey=xpt-apikey&provider=Azure
+```
+
+- O arquivo será compactado (gzip) e enviado via POST.
+- Headers enviados: x-apikey, x-provider
+- Suporta CSV ou JSON.
+- Formato: application/octet-stream com encoding gzip
+
+### Exemplo: Consulta do last-sync via GET
+
+```csharp
+var client = new ApiKeyHttpGetClient(serviceProvider.GetRequiredService<IHttpClientFactory>(), "xpt-apikey");
+var lastSync = await client.GetLastSyncAsync("https://ftc-api.eximia.co/collect/repositories/repo01/last-sync");
+Console.WriteLine($"Última sincronização: {lastSync}");
+``` 

package/TESTING.md

@@ -0,0 +1,169 @@
+# 🧪 Guia de Testes - Follow The Code CLI
+
+## Testes de Permissões
+
+### 1. **Teste Básico de Permissões**
+```bash
+cd contexts/ftc.cli
+npm run test-permissions
+```
+
+Este comando verifica:
+- ✅ Permissões dos arquivos executáveis
+- ✅ Existência dos arquivos
+- ✅ Funcionamento dos scripts de correção
+
+### 2. **Teste Completo do Build**
+```bash
+npm run build
+```
+
+Verifica todo o processo:
+- 🔨 Compilação para todas as plataformas
+- 📋 Cópia de configurações
+- 🔐 Definição de permissões
+
+### 3. **Teste Individual dos Scripts**
+```bash
+# Teste de cópia de configuração
+npm run copy-config
+
+# Teste de definição de permissões
+npm run set-permissions
+
+# Teste de correção manual
+npm run fix-permissions
+```
+
+### 4. **Teste com Docker (Linux)**
+```bash
+# Requer Docker instalado
+npm run test-linux
+```
+
+Simula instalação em ambiente Linux limpo.
+
+## Verificação Manual
+
+### Verificar Permissões
+```bash
+# Linux/macOS
+ls -la bin/linux-x64/ftc.cli
+ls -la bin/osx-x64/ftc.cli
+ls -la bin/ftc.js
+
+# Deve mostrar: -rwxr-xr-x (755)
+```
+
+### Testar Execução
+```bash
+# Teste do CLI
+./bin/ftc.js --help
+
+# Deve mostrar a ajuda do CLI
+```
+
+## Teste de Publicação
+
+### 1. **Teste Local de Publicação**
+```bash
+# Simula publicação sem enviar para npm
+npm run build
+npm pack
+
+# Verifica o conteúdo do pacote
+tar -tzf followthecode-cli-*.tgz
+```
+
+### 2. **Teste de Instalação Local**
+```bash
+# Instala o pacote localmente
+npm install -g ./followthecode-cli-*.tgz
+
+# Testa a instalação
+ftc --help
+```
+
+## Cenários de Teste
+
+### ✅ **Cenário 1: Build Completo**
+1. Execute `npm run build`
+2. Verifique se todos os arquivos foram criados
+3. Verifique permissões com `npm run test-permissions`
+
+### ✅ **Cenário 2: Instalação Limpa**
+1. Delete a pasta `bin/`
+2. Execute `npm run build`
+3. Verifique se as permissões foram definidas
+
+### ✅ **Cenário 3: Correção Manual**
+1. Remova permissões: `chmod -x bin/linux-x64/ftc.cli`
+2. Execute `npm run fix-permissions`
+3. Verifique se as permissões foram restauradas
+
+### ✅ **Cenário 4: Teste Cross-Platform**
+1. Execute em Windows
+2. Execute em Linux (via Docker)
+3. Execute em macOS (se disponível)
+
+## Resultados Esperados
+
+### ✅ **Sucesso**
+```
+🧪 Testando permissões de execução...
+
+🔍 Verificando arquivos...
+
+📁 bin/ftc.js
+   Permissões: 755
+   Executável: ✅ Sim
+   Tamanho: 2048 bytes
+
+📁 bin/linux-x64/ftc.cli
+   Permissões: 755
+   Executável: ✅ Sim
+   Tamanho: 51200 bytes
+
+📊 Resultado do teste:
+✅ Todas as permissões estão corretas!
+```
+
+### ❌ **Falha**
+```
+📁 bin/linux-x64/ftc.cli
+   Permissões: 644
+   Executável: ❌ Não
+   Tamanho: 51200 bytes
+
+📊 Resultado do teste:
+❌ Algumas permissões precisam ser corrigidas
+💡 Execute: npm run fix-permissions
+```
+
+## Troubleshooting
+
+### Problema: "Script não encontrado"
+```bash
+# Verifique se os scripts existem
+ls -la scripts/
+```
+
+### Problema: "Permissão negada"
+```bash
+# No Linux/macOS
+chmod +x scripts/*.js
+chmod +x scripts/*.sh
+```
+
+### Problema: "Docker não encontrado"
+```bash
+# Instale Docker ou use apenas os testes Node.js
+npm run test-permissions
+```
+
+## Próximos Passos
+
+Após os testes:
+1. ✅ Se tudo passar: Pronto para publicação
+2. ❌ Se houver falhas: Corrija e teste novamente
+3. 🔄 Para publicação: `npm run publish:patch` 

package/TROUBLESHOOTING.md

@@ -0,0 +1,60 @@
+# 🔧 Troubleshooting - Follow The Code CLI
+
+## Problemas de Permissão no Linux
+
+### Sintoma
+Após instalar a CLI no Linux, você recebe um erro como:
+```
+bash: ./ftc.cli: Permission denied
+```
+
+### Solução Automática
+Execute o comando de correção de permissões:
+```bash
+npm run fix-permissions
+```
+
+### Solução Manual
+Se a solução automática não funcionar, execute manualmente:
+```bash
+chmod +x bin/linux-x64/ftc.cli
+chmod +x bin/ftc.js
+```
+
+### Verificação
+Para verificar se as permissões estão corretas:
+```bash
+ls -la bin/linux-x64/ftc.cli
+ls -la bin/ftc.js
+```
+
+As permissões devem aparecer como `-rwxr-xr-x` (755).
+
+## Outros Problemas Comuns
+
+### Erro: "Executável .NET não encontrado"
+Certifique-se de que o projeto foi compilado para todas as plataformas:
+```bash
+npm run build
+```
+
+### Erro: "Plataforma não suportada"
+A CLI suporta apenas:
+- Windows (x64)
+- macOS (x64) 
+- Linux (x64)
+
+### Problemas de Rede
+Se houver problemas de conectividade, verifique:
+- Configuração de proxy
+- Firewall
+- DNS
+
+## Logs de Debug
+Para obter mais informações sobre erros, execute:
+```bash
+ftc --help
+```
+
+## Suporte
+Se os problemas persistirem, abra uma issue no repositório do projeto. 

package/bin/ftc.js

@@ -75,6 +75,24 @@ if (!fs.existsSync(executablePath)) {
     process.exit(1);
 }
 
+// Verifica permissões de execução no Linux/macOS
+if (platform !== 'win32') {
+    try {
+        const stats = fs.statSync(executablePath);
+        const isExecutable = (stats.mode & fs.constants.S_IXUSR) !== 0;
+        
+        if (!isExecutable) {
+            console.error('❌ Erro: Arquivo não tem permissões de execução:', executablePath);
+            console.error('💡 Execute: npm run fix-permissions');
+            console.error('💡 Ou manualmente: chmod +x', executablePath);
+            process.exit(1);
+        }
+    } catch (error) {
+        console.error('❌ Erro ao verificar permissões:', error.message);
+        process.exit(1);
+    }
+}
+
 // Executa o binário .NET
 const executableDir = path.dirname(executablePath);
 const child = spawn(executablePath, args, {

package/bin/linux-x64/appsettings.json

@@ -29,27 +29,7 @@
         "Args": {
           "outputTemplate": "[{Timestamp:HH:mm:ss} {Level:u3}] [{ThreadId}] [{TraceId}/{SpanId}] {Message:lj}{NewLine}{Exception}"
         }
-      },
-      {
-        "Name": "OpenTelemetry",
-        "Args": {
-          "endpoint": "http://10.0.17.241:4317",
-          "protocol": "Grpc",
-          "timeout": 1000,
-          "batchSizeLimit": 10,
-          "period": 1
-        }
       }
     ]
-  },
-  "OpenTelemetry": {
-    "ServiceName": "ftc.cli",
-    "OtlpEndpoint": "http://10.0.17.241:4317"
-  },
-  "AWS": {
-    "Region": "us-east-1",
-    "S3": {
-      "BucketName": "ftc-analyzer"
-    }
   }
 } 

package/bin/linux-x64/ftc.cli.deps.json

@@ -13,6 +13,7 @@
           "LibGit2Sharp": "0.27.0",
           "Microsoft.Extensions.Configuration.Binder": "9.0.0",
           "Microsoft.Extensions.Configuration.Json": "8.0.0",
+          "Microsoft.Extensions.Http": "8.0.0",
           "OpenTelemetry": "1.11.2",
           "OpenTelemetry.Exporter.OpenTelemetryProtocol": "1.11.2",
           "OpenTelemetry.Extensions.Hosting": "1.11.2",
@@ -910,6 +911,19 @@
           }
         }
       },
+      "Microsoft.Extensions.Diagnostics/8.0.0": {
+        "dependencies": {
+          "Microsoft.Extensions.Configuration": "9.0.0",
+          "Microsoft.Extensions.Diagnostics.Abstractions": "9.0.0",
+          "Microsoft.Extensions.Options.ConfigurationExtensions": "9.0.0"
+        },
+        "runtime": {
+          "lib/net8.0/Microsoft.Extensions.Diagnostics.dll": {
+            "assemblyVersion": "8.0.0.0",
+            "fileVersion": "8.0.23.53103"
+          }
+        }
+      },
       "Microsoft.Extensions.Diagnostics.Abstractions/9.0.0": {
         "dependencies": {
           "Microsoft.Extensions.DependencyInjection.Abstractions": "9.0.0",
@@ -970,6 +984,22 @@
           }
         }
       },
+      "Microsoft.Extensions.Http/8.0.0": {
+        "dependencies": {
+          "Microsoft.Extensions.Configuration.Abstractions": "9.0.0",
+          "Microsoft.Extensions.DependencyInjection.Abstractions": "9.0.0",
+          "Microsoft.Extensions.Diagnostics": "8.0.0",
+          "Microsoft.Extensions.Logging": "9.0.0",
+          "Microsoft.Extensions.Logging.Abstractions": "9.0.0",
+          "Microsoft.Extensions.Options": "9.0.0"
+        },
+        "runtime": {
+          "lib/net8.0/Microsoft.Extensions.Http.dll": {
+            "assemblyVersion": "8.0.0.0",
+            "fileVersion": "8.0.23.53103"
+          }
+        }
+      },
       "Microsoft.Extensions.Logging/9.0.0": {
         "dependencies": {
           "Microsoft.Extensions.DependencyInjection": "9.0.0",
@@ -1420,6 +1450,13 @@
       "path": "microsoft.extensions.dependencymodel/9.0.0",
       "hashPath": "microsoft.extensions.dependencymodel.9.0.0.nupkg.sha512"
     },
+    "Microsoft.Extensions.Diagnostics/8.0.0": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-3PZp/YSkIXrF7QK7PfC1bkyRYwqOHpWFad8Qx+4wkuumAeXo1NHaxpS9LboNA9OvNSAu+QOVlXbMyoY+pHSqcw==",
+      "path": "microsoft.extensions.diagnostics/8.0.0",
+      "hashPath": "microsoft.extensions.diagnostics.8.0.0.nupkg.sha512"
+    },
     "Microsoft.Extensions.Diagnostics.Abstractions/9.0.0": {
       "type": "package",
       "serviceable": true,
@@ -1455,6 +1492,13 @@
       "path": "microsoft.extensions.hosting.abstractions/9.0.0",
       "hashPath": "microsoft.extensions.hosting.abstractions.9.0.0.nupkg.sha512"
     },
+    "Microsoft.Extensions.Http/8.0.0": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-cWz4caHwvx0emoYe7NkHPxII/KkTI8R/LC9qdqJqnKv2poTJ4e2qqPGQqvRoQ5kaSA4FU5IV3qFAuLuOhoqULQ==",
+      "path": "microsoft.extensions.http/8.0.0",
+      "hashPath": "microsoft.extensions.http.8.0.0.nupkg.sha512"
+    },
     "Microsoft.Extensions.Logging/9.0.0": {
       "type": "package",
       "serviceable": true,

package/bin/osx-x64/appsettings.json

@@ -29,27 +29,7 @@
         "Args": {
           "outputTemplate": "[{Timestamp:HH:mm:ss} {Level:u3}] [{ThreadId}] [{TraceId}/{SpanId}] {Message:lj}{NewLine}{Exception}"
         }
-      },
-      {
-        "Name": "OpenTelemetry",
-        "Args": {
-          "endpoint": "http://10.0.17.241:4317",
-          "protocol": "Grpc",
-          "timeout": 1000,
-          "batchSizeLimit": 10,
-          "period": 1
-        }
       }
     ]
-  },
-  "OpenTelemetry": {
-    "ServiceName": "ftc.cli",
-    "OtlpEndpoint": "http://10.0.17.241:4317"
-  },
-  "AWS": {
-    "Region": "us-east-1",
-    "S3": {
-      "BucketName": "ftc-analyzer"
-    }
   }
 } 

package/bin/osx-x64/ftc.cli.deps.json

@@ -13,6 +13,7 @@
           "LibGit2Sharp": "0.27.0",
           "Microsoft.Extensions.Configuration.Binder": "9.0.0",
           "Microsoft.Extensions.Configuration.Json": "8.0.0",
+          "Microsoft.Extensions.Http": "8.0.0",
           "OpenTelemetry": "1.11.2",
           "OpenTelemetry.Exporter.OpenTelemetryProtocol": "1.11.2",
           "OpenTelemetry.Extensions.Hosting": "1.11.2",
@@ -910,6 +911,19 @@
           }
         }
       },
+      "Microsoft.Extensions.Diagnostics/8.0.0": {
+        "dependencies": {
+          "Microsoft.Extensions.Configuration": "9.0.0",
+          "Microsoft.Extensions.Diagnostics.Abstractions": "9.0.0",
+          "Microsoft.Extensions.Options.ConfigurationExtensions": "9.0.0"
+        },
+        "runtime": {
+          "lib/net8.0/Microsoft.Extensions.Diagnostics.dll": {
+            "assemblyVersion": "8.0.0.0",
+            "fileVersion": "8.0.23.53103"
+          }
+        }
+      },
       "Microsoft.Extensions.Diagnostics.Abstractions/9.0.0": {
         "dependencies": {
           "Microsoft.Extensions.DependencyInjection.Abstractions": "9.0.0",
@@ -970,6 +984,22 @@
           }
         }
       },
+      "Microsoft.Extensions.Http/8.0.0": {
+        "dependencies": {
+          "Microsoft.Extensions.Configuration.Abstractions": "9.0.0",
+          "Microsoft.Extensions.DependencyInjection.Abstractions": "9.0.0",
+          "Microsoft.Extensions.Diagnostics": "8.0.0",
+          "Microsoft.Extensions.Logging": "9.0.0",
+          "Microsoft.Extensions.Logging.Abstractions": "9.0.0",
+          "Microsoft.Extensions.Options": "9.0.0"
+        },
+        "runtime": {
+          "lib/net8.0/Microsoft.Extensions.Http.dll": {
+            "assemblyVersion": "8.0.0.0",
+            "fileVersion": "8.0.23.53103"
+          }
+        }
+      },
       "Microsoft.Extensions.Logging/9.0.0": {
         "dependencies": {
           "Microsoft.Extensions.DependencyInjection": "9.0.0",
@@ -1420,6 +1450,13 @@
       "path": "microsoft.extensions.dependencymodel/9.0.0",
       "hashPath": "microsoft.extensions.dependencymodel.9.0.0.nupkg.sha512"
     },
+    "Microsoft.Extensions.Diagnostics/8.0.0": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-3PZp/YSkIXrF7QK7PfC1bkyRYwqOHpWFad8Qx+4wkuumAeXo1NHaxpS9LboNA9OvNSAu+QOVlXbMyoY+pHSqcw==",
+      "path": "microsoft.extensions.diagnostics/8.0.0",
+      "hashPath": "microsoft.extensions.diagnostics.8.0.0.nupkg.sha512"
+    },
     "Microsoft.Extensions.Diagnostics.Abstractions/9.0.0": {
       "type": "package",
       "serviceable": true,
@@ -1455,6 +1492,13 @@
       "path": "microsoft.extensions.hosting.abstractions/9.0.0",
       "hashPath": "microsoft.extensions.hosting.abstractions.9.0.0.nupkg.sha512"
     },
+    "Microsoft.Extensions.Http/8.0.0": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-cWz4caHwvx0emoYe7NkHPxII/KkTI8R/LC9qdqJqnKv2poTJ4e2qqPGQqvRoQ5kaSA4FU5IV3qFAuLuOhoqULQ==",
+      "path": "microsoft.extensions.http/8.0.0",
+      "hashPath": "microsoft.extensions.http.8.0.0.nupkg.sha512"
+    },
     "Microsoft.Extensions.Logging/9.0.0": {
       "type": "package",
       "serviceable": true,

package/bin/win-x64/appsettings.json

@@ -29,27 +29,7 @@
         "Args": {
           "outputTemplate": "[{Timestamp:HH:mm:ss} {Level:u3}] [{ThreadId}] [{TraceId}/{SpanId}] {Message:lj}{NewLine}{Exception}"
         }
-      },
-      {
-        "Name": "OpenTelemetry",
-        "Args": {
-          "endpoint": "http://10.0.17.241:4317",
-          "protocol": "Grpc",
-          "timeout": 1000,
-          "batchSizeLimit": 10,
-          "period": 1
-        }
       }
     ]
-  },
-  "OpenTelemetry": {
-    "ServiceName": "ftc.cli",
-    "OtlpEndpoint": "http://10.0.17.241:4317"
-  },
-  "AWS": {
-    "Region": "us-east-1",
-    "S3": {
-      "BucketName": "ftc-analyzer"
-    }
   }
 } 

package/bin/win-x64/ftc.cli.deps.json

@@ -13,6 +13,7 @@
           "LibGit2Sharp": "0.27.0",
           "Microsoft.Extensions.Configuration.Binder": "9.0.0",
           "Microsoft.Extensions.Configuration.Json": "8.0.0",
+          "Microsoft.Extensions.Http": "8.0.0",
           "OpenTelemetry": "1.11.2",
           "OpenTelemetry.Exporter.OpenTelemetryProtocol": "1.11.2",
           "OpenTelemetry.Extensions.Hosting": "1.11.2",
@@ -910,6 +911,19 @@
           }
         }
       },
+      "Microsoft.Extensions.Diagnostics/8.0.0": {
+        "dependencies": {
+          "Microsoft.Extensions.Configuration": "9.0.0",
+          "Microsoft.Extensions.Diagnostics.Abstractions": "9.0.0",
+          "Microsoft.Extensions.Options.ConfigurationExtensions": "9.0.0"
+        },
+        "runtime": {
+          "lib/net8.0/Microsoft.Extensions.Diagnostics.dll": {
+            "assemblyVersion": "8.0.0.0",
+            "fileVersion": "8.0.23.53103"
+          }
+        }
+      },
       "Microsoft.Extensions.Diagnostics.Abstractions/9.0.0": {
         "dependencies": {
           "Microsoft.Extensions.DependencyInjection.Abstractions": "9.0.0",
@@ -970,6 +984,22 @@
           }
         }
       },
+      "Microsoft.Extensions.Http/8.0.0": {
+        "dependencies": {
+          "Microsoft.Extensions.Configuration.Abstractions": "9.0.0",
+          "Microsoft.Extensions.DependencyInjection.Abstractions": "9.0.0",
+          "Microsoft.Extensions.Diagnostics": "8.0.0",
+          "Microsoft.Extensions.Logging": "9.0.0",
+          "Microsoft.Extensions.Logging.Abstractions": "9.0.0",
+          "Microsoft.Extensions.Options": "9.0.0"
+        },
+        "runtime": {
+          "lib/net8.0/Microsoft.Extensions.Http.dll": {
+            "assemblyVersion": "8.0.0.0",
+            "fileVersion": "8.0.23.53103"
+          }
+        }
+      },
       "Microsoft.Extensions.Logging/9.0.0": {
         "dependencies": {
           "Microsoft.Extensions.DependencyInjection": "9.0.0",
@@ -1420,6 +1450,13 @@
       "path": "microsoft.extensions.dependencymodel/9.0.0",
       "hashPath": "microsoft.extensions.dependencymodel.9.0.0.nupkg.sha512"
     },
+    "Microsoft.Extensions.Diagnostics/8.0.0": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-3PZp/YSkIXrF7QK7PfC1bkyRYwqOHpWFad8Qx+4wkuumAeXo1NHaxpS9LboNA9OvNSAu+QOVlXbMyoY+pHSqcw==",
+      "path": "microsoft.extensions.diagnostics/8.0.0",
+      "hashPath": "microsoft.extensions.diagnostics.8.0.0.nupkg.sha512"
+    },
     "Microsoft.Extensions.Diagnostics.Abstractions/9.0.0": {
       "type": "package",
       "serviceable": true,
@@ -1455,6 +1492,13 @@
       "path": "microsoft.extensions.hosting.abstractions/9.0.0",
       "hashPath": "microsoft.extensions.hosting.abstractions.9.0.0.nupkg.sha512"
     },
+    "Microsoft.Extensions.Http/8.0.0": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-cWz4caHwvx0emoYe7NkHPxII/KkTI8R/LC9qdqJqnKv2poTJ4e2qqPGQqvRoQ5kaSA4FU5IV3qFAuLuOhoqULQ==",
+      "path": "microsoft.extensions.http/8.0.0",
+      "hashPath": "microsoft.extensions.http.8.0.0.nupkg.sha512"
+    },
     "Microsoft.Extensions.Logging/9.0.0": {
       "type": "package",
       "serviceable": true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@followthecode/cli",
-  "version": "1.1.8",
+  "version": "1.1.10",
   "description": "CLI tool for Git repository analysis and data collection",
   "main": "index.js",
   "license": "UNLICENSED",
@@ -12,12 +12,23 @@
   },
   "scripts": {
     "prepublishOnly": "npm run build",
-    "build": "npm run build:win && npm run build:mac && npm run build:linux && npm run copy-config",
+    "build": "npm run build:win && npm run build:mac && npm run build:linux && npm run copy-config && npm run set-permissions",
     "build:win": "dotnet publish ftc.cli.csproj -c Release -r win-x64 --self-contained true -o ./bin/win-x64",
     "build:mac": "dotnet publish ftc.cli.csproj -c Release -r osx-x64 --self-contained true -o ./bin/osx-x64",
     "build:linux": "dotnet publish ftc.cli.csproj -c Release -r linux-x64 --self-contained true -o ./bin/linux-x64",
-    "copy-config": "copy appsettings.json bin\\win-x64\\ && copy appsettings.json bin\\osx-x64\\ && copy appsettings.json bin\\linux-x64\\",
+    "copy-config": "node scripts/copy-config.js",
+    "set-permissions": "node scripts/set-permissions.js",
+    "postinstall": "node scripts/set-permissions.js",
+    "fix-permissions": "node scripts/fix-permissions.js",
     "test": "dotnet test",
+    "test-permissions": "node scripts/test-permissions.js",
+    "test-linux": "bash scripts/test-linux-permissions.sh",
+    "test-local-install": "node scripts/test-local-install.js",
+    "test-docker-real": "bash scripts/test-docker-real.sh",
+    "test-wsl": "wsl bash scripts/test-wsl-basic.sh",
+    "validate-wsl": "wsl bash scripts/validate-wsl.sh",
+    "validate-wsl-simple": "wsl bash scripts/validate-wsl-simple.sh",
+    "validate-wsl-no-sudo": "wsl bash scripts/validate-wsl-no-sudo.sh",
     "clean": "dotnet clean",
     "publish:patch": "node scripts/publish.js --patch",
     "publish:minor": "node scripts/publish.js --minor",
@@ -73,8 +84,12 @@
     "bin/linux-x64/ftc.cli.deps.json",
     "bin/linux-x64/appsettings.json",
     "bin/linux-x64/*.dll",
+    "scripts/set-permissions.js",
+    "scripts/fix-permissions.js",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "TROUBLESHOOTING.md",
+    "TESTING.md"
   ],
   "dependencies": {
     "@followthecode/cli": "^1.0.1",

package/scripts/fix-permissions.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+console.log('🔧 Corrigindo permissões de execução...');
+
+// Função para definir permissões recursivamente
+function setExecutablePermissions(dir) {
+    if (!fs.existsSync(dir)) {
+        console.warn(`⚠️  Diretório não encontrado: ${dir}`);
+        return;
+    }
+
+    const items = fs.readdirSync(dir);
+    
+    items.forEach(item => {
+        const fullPath = path.join(dir, item);
+        const stat = fs.statSync(fullPath);
+        
+        if (stat.isDirectory()) {
+            setExecutablePermissions(fullPath);
+        } else if (stat.isFile()) {
+            // Define permissões de execução para arquivos binários
+            const isExecutable = item === 'ftc.cli' || item === 'ftc.js' || item.endsWith('.exe');
+            
+            if (isExecutable) {
+                try {
+                    fs.chmodSync(fullPath, 0o755);
+                    console.log(`✅ Permissões corrigidas: ${fullPath}`);
+                } catch (error) {
+                    console.error(`❌ Erro ao corrigir permissões para ${fullPath}:`, error.message);
+                }
+            }
+        }
+    });
+}
+
+// Define permissões para os diretórios das plataformas
+const platforms = ['linux-x64', 'osx-x64'];
+platforms.forEach(platform => {
+    const platformDir = path.join('bin', platform);
+    setExecutablePermissions(platformDir);
+});
+
+// Define permissões para o arquivo ftc.js
+const ftcJsPath = path.join('bin', 'ftc.js');
+if (fs.existsSync(ftcJsPath)) {
+    try {
+        fs.chmodSync(ftcJsPath, 0o755);
+        console.log(`✅ Permissões corrigidas: ${ftcJsPath}`);
+    } catch (error) {
+        console.error(`❌ Erro ao corrigir permissões para ${ftcJsPath}:`, error.message);
+    }
+}
+
+console.log('✅ Correção de permissões concluída!');
+console.log('💡 Se ainda houver problemas, execute manualmente: chmod +x bin/linux-x64/ftc.cli'); 

package/scripts/set-permissions.js

@@ -0,0 +1,62 @@
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+console.log('🔐 Definindo permissões de execução...');
+
+// Detecta a plataforma
+const platform = process.platform;
+const isWindows = platform === 'win32';
+
+const platforms = [
+    { dir: 'linux-x64', executable: 'ftc.cli' },
+    { dir: 'osx-x64', executable: 'ftc.cli' }
+];
+
+platforms.forEach(platformConfig => {
+    const executablePath = path.join('bin', platformConfig.dir, platformConfig.executable);
+    
+    if (fs.existsSync(executablePath)) {
+        try {
+            if (isWindows) {
+                // No Windows, tenta definir permissões mesmo assim
+                try {
+                    fs.chmodSync(executablePath, 0o755);
+                    console.log(`✅ Permissões definidas para ${executablePath} (Windows)`);
+                } catch (error) {
+                    console.log(`✅ Arquivo preparado para ${executablePath} (Windows - permissões não aplicáveis)`);
+                }
+            } else {
+                // No Linux/macOS, define permissões reais
+                fs.chmodSync(executablePath, 0o755);
+                console.log(`✅ Permissões definidas para ${executablePath}`);
+            }
+        } catch (error) {
+            console.error(`❌ Erro ao definir permissões para ${executablePath}:`, error.message);
+        }
+    } else {
+        console.warn(`⚠️  Executável não encontrado: ${executablePath}`);
+    }
+});
+
+// Também define permissões para o arquivo ftc.js
+const ftcJsPath = path.join('bin', 'ftc.js');
+if (fs.existsSync(ftcJsPath)) {
+    try {
+        if (isWindows) {
+            try {
+                fs.chmodSync(ftcJsPath, 0o755);
+                console.log(`✅ Permissões definidas para ${ftcJsPath} (Windows)`);
+            } catch (error) {
+                console.log(`✅ Arquivo preparado para ${ftcJsPath} (Windows - permissões não aplicáveis)`);
+            }
+        } else {
+            fs.chmodSync(ftcJsPath, 0o755);
+            console.log(`✅ Permissões definidas para ${ftcJsPath}`);
+        }
+    } catch (error) {
+        console.error(`❌ Erro ao definir permissões para ${ftcJsPath}:`, error.message);
+    }
+}
+
+console.log('✅ Permissões de execução definidas com sucesso');