@innominatum/agentforge-cli 1.1.3 → 1.1.22

package/dist/index.js

@@ -301,29 +301,20 @@ async function resolveAgentId(slug, config) {
 const deployCmd = program
     .command("deploy")
     .description("Faz o deploy de entidades para a plataforma GoClaw");
-deployCmd
-    .command("skill <slug>")
-    .description("Faz o build da skill e envia para a API do GoClaw")
-    .action(async (slug) => {
-    const config = await getConfig();
-    if (!config.goclaw || !config.goclaw.token) {
-        console.error("❌ Configure sua chave de API (token) no agentforge.json antes de fazer o deploy.");
-        process.exit(1);
-    }
-    const basePath = getWorkspaceRoot();
+async function deploySkill(slug, config, basePath) {
     const skillPath = path_1.default.join(basePath, "skills", slug);
     const exportsPath = path_1.default.join(basePath, "exports");
-    const zipPath = path_1.default.join(exportsPath, `${slug}.zip`);
+    const safeSlug = slug.replace(/[\\\/]/g, '_');
+    const zipPath = path_1.default.join(exportsPath, `${safeSlug}.zip`);
     if (!(await fs_extra_1.default.pathExists(skillPath))) {
         console.error(`❌ A skill "${slug}" não foi encontrada em skills/${slug}.`);
-        process.exit(1);
+        return;
     }
     await fs_extra_1.default.ensureDir(exportsPath);
     const zip = new adm_zip_1.default();
     zip.addLocalFolder(skillPath, "");
     zip.writeZip(zipPath);
-    console.log(`✅ Build concluído: ${slug}.zip preparado para envio.`);
-    console.log(`🚀 Fazendo upload para o GoClaw...`);
+    console.log(`🚀 Fazendo upload da skill "${slug}" para o GoClaw...`);
     const form = new form_data_1.default();
     form.append("file", fs_extra_1.default.createReadStream(zipPath));
     try {
@@ -336,11 +327,58 @@ deployCmd
         });
         const data = response.data;
         if (data && data.version) {
-            console.log(`📌 Skill atualizada para a versão ${data.version}.`);
+            console.log(`✅ Arquivos da skill "${slug}" atualizados (versão ${data.version}).`);
+        }
+        else {
+            console.log(`✅ Arquivos da skill "${slug}" atualizados.`);
+        }
+        // Sincronizar metadados (visibility, description, tags, etc)
+        const skillsListRes = await axios_1.default.get(`${config.goclaw.api_url}/v1/skills`, {
+            headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
+        });
+        const remoteSkill = skillsListRes.data.skills?.find((s) => s.slug === slug);
+        if (remoteSkill) {
+            const metadataPath = path_1.default.join(skillPath, "metadata.json");
+            if (await fs_extra_1.default.pathExists(metadataPath)) {
+                console.log(`🚀 Sincronizando metadados da skill "${slug}"...`);
+                const metadata = await fs_extra_1.default.readJson(metadataPath);
+                // Remover campos que não devem ser enviados no PUT
+                const payload = { ...metadata };
+                delete payload.id;
+                delete payload.slug;
+                delete payload.name;
+                await axios_1.default.put(`${config.goclaw.api_url}/v1/skills/${remoteSkill.id}`, payload, {
+                    headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
+                });
+                console.log(`✅ Metadados sincronizados com sucesso.`);
+            }
+            // Sincronizar permissões (grants)
+            const grantsPath = path_1.default.join(skillPath, "grants.jsonl");
+            if (await fs_extra_1.default.pathExists(grantsPath)) {
+                console.log(`🚀 Sincronizando permissões (grants) da skill "${slug}"...`);
+                const grantsContent = await fs_extra_1.default.readFile(grantsPath, 'utf8');
+                const lines = grantsContent.split('\n').filter(l => l.trim());
+                for (const line of lines) {
+                    try {
+                        const grant = JSON.parse(line);
+                        if (grant.agent_key) {
+                            const agentId = await resolveAgentId(grant.agent_key, config);
+                            if (agentId) {
+                                await axios_1.default.post(`${config.goclaw.api_url}/v1/skills/${remoteSkill.id}/grants/agent`, { agent_id: agentId, version: grant.pinned_version || null }, { headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" } });
+                                console.log(`   ➕ Permissão concedida ao agente: ${grant.agent_key}`);
+                            }
+                        }
+                    }
+                    catch (e) {
+                        console.warn(`   ⚠️ Falha ao conceder permissão: ${e.response?.data?.error || e.message}`);
+                    }
+                }
+                console.log(`✅ Permissões sincronizadas.`);
+            }
         }
     }
     catch (error) {
-        console.error("❌ Erro durante o deploy:");
+        console.error(`❌ Erro no deploy da skill "${slug}":`);
         if (error.response) {
             console.error(error.response.data);
         }
@@ -348,6 +386,18 @@ deployCmd
             console.error(error.message);
         }
     }
+}
+deployCmd
+    .command("skill <slug>")
+    .description("Faz build e upload automático de uma skill para o GoClaw")
+    .action(async (slug) => {
+    const config = await getConfig();
+    if (!config.goclaw || !config.goclaw.token) {
+        console.error("❌ Configure sua chave de API (token) no agentforge.json antes de fazer o deploy.");
+        process.exit(1);
+    }
+    const basePath = getWorkspaceRoot();
+    await deploySkill(slug, config, basePath);
 });
 async function deployContextFiles(slug, config, resolvedId) {
     const agentId = resolvedId || (await resolveAgentId(slug, config)) || slug;
@@ -357,53 +407,112 @@ async function deployContextFiles(slug, config, resolvedId) {
         throw new Error(`Agente não encontrado em agents/${slug}`);
     }
     const files = await fs_extra_1.default.readdir(agentPath);
-    // Identificar ficheiros de contexto e de memória
-    const memoryFileNames = ['MEMORY.md', 'memory.md'];
-    const memoryDirName = 'memory';
-    const contextFiles = files.filter(f => (f.endsWith('.md') || f.endsWith('.txt') || f.endsWith('.py')) &&
-        f !== 'README.md' &&
-        f !== 'agent.json' &&
-        !memoryFileNames.includes(f));
-    const hasMemoryDir = await fs_extra_1.default.pathExists(path_1.default.join(agentPath, memoryDirName));
-    const memoryFilesFound = files.filter(f => memoryFileNames.includes(f));
-    const hasMemory = hasMemoryDir || memoryFilesFound.length > 0;
-    if (contextFiles.length === 0 && !hasMemory) {
+    const itemsToSync = files.filter(f => f !== 'agent.json' && f !== 'README.md');
+    if (itemsToSync.length === 0) {
         console.log(`Nenhum ficheiro de contexto ou memória encontrado para "${slug}".`);
         return;
     }
     const tempExportDir = path_1.default.join(basePath, `temp_export_${slug}`);
-    const tempContextDir = path_1.default.join(tempExportDir, "context_files");
-    const tempMemoryDir = path_1.default.join(tempExportDir, "memory");
     const tarPath = path_1.default.join(basePath, `temp_export_${slug}.tar.gz`);
+    // Guardar lista de ficheiros locais para pruning
+    const localFilePaths = [];
+    async function collectFilesRecursive(dir, baseDir) {
+        const results = [];
+        if (!(await fs_extra_1.default.pathExists(dir)))
+            return results;
+        const entries = await fs_extra_1.default.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path_1.default.join(dir, entry.name);
+            const relativePath = path_1.default.relative(baseDir, fullPath).replace(/\\/g, '/');
+            if (entry.isDirectory()) {
+                const subResults = await collectFilesRecursive(fullPath, baseDir);
+                results.push(...subResults);
+            }
+            else {
+                results.push(relativePath);
+            }
+        }
+        return results;
+    }
     try {
-        const sections = [];
-        if (contextFiles.length > 0) {
-            sections.push("context_files");
-            await fs_extra_1.default.ensureDir(tempContextDir);
-            for (const file of contextFiles) {
-                await fs_extra_1.default.copy(path_1.default.join(agentPath, file), path_1.default.join(tempContextDir, file));
+        const sections = new Set();
+        // Processar ficheiros/pastas da raiz do agente
+        for (const item of itemsToSync) {
+            const itemPath = path_1.default.join(agentPath, item);
+            const isDir = (await fs_extra_1.default.stat(itemPath)).isDirectory();
+            const section = "context_files";
+            sections.add(section);
+            const targetDir = path_1.default.join(tempExportDir, section);
+            await fs_extra_1.default.ensureDir(targetDir);
+            if (isDir) {
+                // Obter todos os ficheiros da pasta (ex: memory, _system)
+                // e achatá-os (flatten) com o nome da pasta como prefixo (ex: memory_arquivo.md)
+                // O GoClaw espera que os ficheiros de contexto não tenham pastas, mas sim prefixos achatados!
+                const subFiles = await fs_extra_1.default.readdir(itemPath);
+                for (const sub of subFiles) {
+                    const subPath = path_1.default.join(itemPath, sub);
+                    const isSubDir = (await fs_extra_1.default.stat(subPath)).isDirectory();
+                    if (!isSubDir) {
+                        const flatName = `${item}_${sub}`;
+                        await fs_extra_1.default.copy(subPath, path_1.default.join(targetDir, flatName));
+                    }
+                }
+            }
+            else {
+                await fs_extra_1.default.copy(itemPath, path_1.default.join(targetDir, item));
             }
         }
-        if (hasMemory) {
-            sections.push("memory");
-            await fs_extra_1.default.ensureDir(tempMemoryDir);
-            // Copiar ficheiros de memória explícitos para a pasta memory no arquivo
-            for (const file of memoryFilesFound) {
-                await fs_extra_1.default.copy(path_1.default.join(agentPath, file), path_1.default.join(tempMemoryDir, file));
+        // Coletar ficheiros para pruning
+        const sectionDir = path_1.default.join(tempExportDir, "context_files");
+        const sectionEntries = await collectFilesRecursive(sectionDir, sectionDir);
+        for (const entry of sectionEntries) {
+            // O GoClaw retorna os caminhos das memórias com barras (memory/arquivo.md)
+            // Nós achatamos para o upload (memory_arquivo.md). Para o pruning não apagar ficheiros
+            // válidos acidentalmente, temos que re-mapear o nome achatado para a versão com barra.
+            let finalEntry = entry;
+            if (entry.startsWith("memory_")) {
+                finalEntry = entry.replace("memory_", "memory/");
             }
-            // Copiar conteúdo da pasta memory se existir
-            if (hasMemoryDir) {
-                await fs_extra_1.default.copy(path_1.default.join(agentPath, memoryDirName), tempMemoryDir);
+            else if (entry.startsWith("_system_")) {
+                finalEntry = entry.replace("_system_", "_system/");
             }
+            localFilePaths.push(finalEntry);
+        }
+        const sectionsArray = Array.from(sections);
+        // --- HACK PARA APAGAR FICHEIROS FÍSICOS DO GOCLAW ---
+        // O GoClaw não apaga ficheiros do disco (context_files) quando os apagamos da DB (memory_documents).
+        // Isto faz com que os ficheiros voltem como "fantasmas" durante o pull.
+        // Solução: Injetar ficheiros vazios no tarball para os órfãos, forçando o /import a esmagá-los com 0 bytes!
+        try {
+            const docsUrl = `${config.goclaw.api_url}/v1/agents/${agentId}/memory/documents`;
+            const preDocsRes = await axios_1.default.get(docsUrl, {
+                headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
+            });
+            const preDocs = preDocsRes.data || [];
+            for (const pDoc of preDocs) {
+                if (pDoc.path && !localFilePaths.includes(pDoc.path)) {
+                    const flatGhost = pDoc.path.replace(/[\/\\]/g, '_');
+                    const ghostPath = path_1.default.join(tempExportDir, "context_files", flatGhost);
+                    await fs_extra_1.default.ensureDir(path_1.default.dirname(ghostPath));
+                    await fs_extra_1.default.writeFile(ghostPath, " "); // 1 byte soft-delete payload
+                    if (!sectionsArray.includes("context_files")) {
+                        sectionsArray.push("context_files");
+                    }
+                }
+            }
+        }
+        catch (e) {
+            console.warn("Aviso: Falha ao procurar fantasmas para o tarball.", e.message);
         }
         await tar.c({
             gzip: true,
             file: tarPath,
             cwd: tempExportDir
-        }, sections);
+        }, sectionsArray);
         const form = new form_data_1.default();
         form.append("file", fs_extra_1.default.createReadStream(tarPath));
-        const url = `${config.goclaw.api_url}/v1/agents/${agentId}/import?include=${sections.join(",")}`;
+        // Upload dos ficheiros (aditivo)
+        const url = `${config.goclaw.api_url}/v1/agents/${agentId}/import?include=${sectionsArray.join(",")}`;
         await axios_1.default.post(url, form, {
             headers: {
                 ...form.getHeaders(),
@@ -411,7 +520,73 @@ async function deployContextFiles(slug, config, resolvedId) {
                 "X-GoClaw-User-Id": config.goclaw.username || "system"
             }
         });
-        console.log(`✅ Upload cirúrgico de ${contextFiles.length} ficheiros de contexto e ${hasMemory ? 'dados de memória' : 'sem memória'} concluído com sucesso!`);
+        console.log(`✅ Upload de ficheiros e subpastas de contexto concluído com sucesso!`);
+        // Atualização forçada de memórias editadas (bypassa a proteção de overwrite do /import)
+        for (const localPath of localFilePaths) {
+            if (localPath.startsWith('memory/') && localPath.endsWith('.md')) {
+                try {
+                    // O ficheiro físico no tempExportDir está achatado (memory_arquivo.md)
+                    const flatFileName = localPath.replace("memory/", "memory_");
+                    const content = await fs_extra_1.default.readFile(path_1.default.join(sectionDir, flatFileName), 'utf8');
+                    // O endpoint usa {path...} portanto não podemos fazer URL encode das barras
+                    const putUrl = `${config.goclaw.api_url}/v1/agents/${agentId}/memory/documents/${localPath}`;
+                    await axios_1.default.put(putUrl, { content }, {
+                        headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
+                    });
+                    console.log(`✅ Edição de memória forçada com sucesso: ${localPath}`);
+                }
+                catch (putErr) {
+                    console.warn(`⚠️ Aviso na edição de ${localPath}: O conteúdo pode não ter sido alterado. (${putErr.message})`);
+                }
+            }
+        }
+        // --- Início do Pruning (Remover ficheiros órfãos do servidor) ---
+        try {
+            const documentsUrl = `${config.goclaw.api_url}/v1/agents/${agentId}/memory/documents`;
+            const docsResponse = await axios_1.default.get(documentsUrl, {
+                headers: {
+                    Authorization: `Bearer ${config.goclaw.token}`,
+                    "X-GoClaw-User-Id": config.goclaw.username || "system"
+                }
+            });
+            const remoteDocs = docsResponse.data || [];
+            let deletedCount = 0;
+            for (const doc of remoteDocs) {
+                if (!doc.path)
+                    continue;
+                // Verifica se o ficheiro remoto existe na nossa lista de ficheiros locais
+                if (!localFilePaths.includes(doc.path)) {
+                    console.log(`🧹 Removendo memória órfã no servidor: ${doc.path}`);
+                    try {
+                        // O endpoint do GoClaw espera o caminho exato sem URL encode (route genérica {path...})
+                        // E é mandatório passar o user_id dono do documento, senão dá erro 500.
+                        const deleteUrl = `${config.goclaw.api_url}/v1/agents/${agentId}/memory/documents/${doc.path}`;
+                        await axios_1.default.delete(deleteUrl, {
+                            headers: {
+                                Authorization: `Bearer ${config.goclaw.token}`,
+                                "X-GoClaw-User-Id": doc.user_id || config.goclaw.username || "system"
+                            }
+                        });
+                        deletedCount++;
+                    }
+                    catch (delErr) {
+                        const errorData = delErr.response?.data?.error || "";
+                        if (delErr.response?.status === 500 && errorData.includes("not found")) {
+                            console.log(`✅ ${doc.path} já estava removido da base de dados.`);
+                        }
+                        else {
+                            console.warn(`⚠️ Não foi possível apagar ${doc.path}: ${delErr.message}`);
+                        }
+                    }
+                }
+            }
+            if (deletedCount > 0) {
+                console.log(`✅ Pruning concluído: ${deletedCount} ficheiro(s) apagado(s) do GoClaw.`);
+            }
+        }
+        catch (pruneErr) {
+            console.warn(`⚠️ Aviso: Falha ao fazer pruning das memórias: ${pruneErr.message}`);
+        }
     }
     finally {
         if (await fs_extra_1.default.pathExists(tempExportDir))
@@ -481,8 +656,44 @@ deployCmd
     }
     await deployAgent(slug, config);
 });
+async function deployAllAgents(config, basePath) {
+    const agentsDir = path_1.default.join(basePath, "agents");
+    if (await fs_extra_1.default.pathExists(agentsDir)) {
+        const agents = await fs_extra_1.default.readdir(agentsDir);
+        console.log(`🚀 Iniciando deploy em lote de ${agents.length} agentes...`);
+        for (const slug of agents) {
+            const agentPath = path_1.default.join(agentsDir, slug);
+            if ((await fs_extra_1.default.stat(agentPath)).isDirectory()) {
+                await deployAgent(slug, config);
+            }
+        }
+    }
+    else {
+        console.log("Nenhum agente encontrado em agents/.");
+    }
+}
+async function deployAllSkills(config, basePath) {
+    const skillsDir = path_1.default.join(basePath, "skills");
+    if (await fs_extra_1.default.pathExists(skillsDir)) {
+        const skills = await fs_extra_1.default.readdir(skillsDir);
+        console.log(`🚀 Iniciando deploy em lote de skills...`);
+        for (const item of skills) {
+            const itemPath = path_1.default.join(skillsDir, item);
+            if ((await fs_extra_1.default.stat(itemPath)).isDirectory()) {
+                if (item === "system") {
+                    console.log("⏩ Ignorando pasta 'system/' (skills nativas do GoClaw são apenas de leitura)");
+                    continue;
+                }
+                await deploySkill(item, config, basePath);
+            }
+        }
+    }
+    else {
+        console.log("Nenhuma skill encontrada em skills/.");
+    }
+}
 deployCmd
-    .command("all")
+    .command("agents")
     .description("Faz deploy de todos os agentes do workspace")
     .action(async () => {
     const config = await getConfig();
@@ -491,24 +702,122 @@ deployCmd
         process.exit(1);
     }
     const basePath = getWorkspaceRoot();
-    const agentsDir = path_1.default.join(basePath, "agents");
-    if (!(await fs_extra_1.default.pathExists(agentsDir))) {
-        console.log("Nenhum agente encontrado em agents/.");
-        return;
+    await deployAllAgents(config, basePath);
+    console.log("🏁 Deploy de agentes concluído!");
+});
+deployCmd
+    .command("skills")
+    .description("Faz deploy de todas as skills do workspace")
+    .action(async () => {
+    const config = await getConfig();
+    if (!config.goclaw || !config.goclaw.token) {
+        console.error("❌ Configure sua chave de API (token) no agentforge.json.");
+        process.exit(1);
     }
-    const agents = await fs_extra_1.default.readdir(agentsDir);
-    console.log(`🚀 Iniciando deploy em lote de ${agents.length} agentes...`);
-    for (const slug of agents) {
-        const agentPath = path_1.default.join(agentsDir, slug);
-        if ((await fs_extra_1.default.stat(agentPath)).isDirectory()) {
-            await deployAgent(slug, config);
-        }
+    const basePath = getWorkspaceRoot();
+    await deployAllSkills(config, basePath);
+    console.log("🏁 Deploy de skills concluído!");
+});
+deployCmd
+    .command("all")
+    .description("Faz deploy de todos os agentes e skills do workspace")
+    .action(async () => {
+    const config = await getConfig();
+    if (!config.goclaw || !config.goclaw.token) {
+        console.error("❌ Configure sua chave de API (token) no agentforge.json.");
+        process.exit(1);
     }
-    console.log("🏁 Deploy em lote concluído!");
+    const basePath = getWorkspaceRoot();
+    await deployAllAgents(config, basePath);
+    await deployAllSkills(config, basePath);
+    console.log("🏁 Deploy completo (agentes e skills) concluído!");
 });
 const pullCmd = program
     .command("pull")
     .description("Sincroniza entidades do GoClaw para o workspace local");
+async function pullAllSkills(config) {
+    console.log("🧹 Limpando a pasta local de skills...");
+    await fs_extra_1.default.emptyDir(path_1.default.join(getWorkspaceRoot(), "skills"));
+    console.log("📥 Baixando skills do GoClaw...");
+    const url = `${config.goclaw.api_url}${config.goclaw.skills_export_endpoint || '/v1/skills/export'}`;
+    const response = await axios_1.default.get(url, {
+        headers: {
+            Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system"
+        },
+        responseType: "stream"
+    });
+    const tempTarPath = path_1.default.join(getWorkspaceRoot(), "temp_skills.tar.gz");
+    const writer = fs_extra_1.default.createWriteStream(tempTarPath);
+    response.data.pipe(writer);
+    await new Promise((resolve, reject) => {
+        writer.on("finish", resolve);
+        writer.on("error", reject);
+    });
+    console.log("📦 Extraindo skills para a pasta local...");
+    await tar.x({
+        file: tempTarPath,
+        cwd: getWorkspaceRoot()
+    });
+    await fs_extra_1.default.remove(tempTarPath);
+    console.log("📥 Baixando ficheiros de código das skills...");
+    const skillsListRes = await axios_1.default.get(`${config.goclaw.api_url}/v1/skills`, {
+        headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
+    });
+    const skills = skillsListRes.data.skills || [];
+    for (const skill of skills) {
+        try {
+            const isSystem = skill.is_system === true;
+            const targetFolder = isSystem ? path_1.default.join("system", skill.slug) : skill.slug;
+            if (isSystem) {
+                const originalPath = path_1.default.join(getWorkspaceRoot(), "skills", skill.slug);
+                const newPath = path_1.default.join(getWorkspaceRoot(), "skills", targetFolder);
+                if (await fs_extra_1.default.pathExists(originalPath)) {
+                    await fs_extra_1.default.ensureDir(path_1.default.dirname(newPath));
+                    await fs_extra_1.default.move(originalPath, newPath, { overwrite: true });
+                }
+            }
+            const filesRes = await axios_1.default.get(`${config.goclaw.api_url}/v1/skills/${skill.id}/files`, {
+                headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
+            });
+            const files = filesRes.data.files || [];
+            for (const file of files) {
+                if (file.isDir)
+                    continue;
+                const fileContentRes = await axios_1.default.get(`${config.goclaw.api_url}/v1/skills/${skill.id}/files/${file.path}`, {
+                    headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
+                });
+                const filePath = path_1.default.join(getWorkspaceRoot(), "skills", targetFolder, file.path);
+                await fs_extra_1.default.ensureDir(path_1.default.dirname(filePath));
+                await fs_extra_1.default.writeFile(filePath, fileContentRes.data.content || "");
+            }
+        }
+        catch (fileErr) {
+            console.warn(`⚠️ Não foi possível transferir os ficheiros da skill ${skill.slug}: ${fileErr.message}`);
+        }
+    }
+    // Remover quaisquer skills fantasmas que o tarball tenha extraído
+    const validSlugs = new Set(skills.map((s) => s.is_system === true ? path_1.default.join("system", s.slug) : s.slug));
+    const skillsDir = path_1.default.join(getWorkspaceRoot(), "skills");
+    if (await fs_extra_1.default.pathExists(skillsDir)) {
+        const localItems = await fs_extra_1.default.readdir(skillsDir);
+        for (const item of localItems) {
+            if (item === "system") {
+                const systemDir = path_1.default.join(skillsDir, "system");
+                if (await fs_extra_1.default.pathExists(systemDir)) {
+                    const systemItems = await fs_extra_1.default.readdir(systemDir);
+                    for (const sysItem of systemItems) {
+                        if (!validSlugs.has(path_1.default.join("system", sysItem))) {
+                            await fs_extra_1.default.remove(path_1.default.join(systemDir, sysItem));
+                        }
+                    }
+                }
+            }
+            else if (!validSlugs.has(item)) {
+                await fs_extra_1.default.remove(path_1.default.join(skillsDir, item));
+            }
+        }
+    }
+}
 pullCmd
     .command("skills")
     .description("Faz download do arquivo tar.gz de skills do GoClaw e extrai localmente")
@@ -522,100 +831,97 @@ pullCmd
         console.log("❌ Pull cancelado pelo utilizador.");
         return;
     }
-    console.log("🧹 Limpando a pasta local de skills...");
-    await fs_extra_1.default.emptyDir(path_1.default.join(getWorkspaceRoot(), "skills"));
-    console.log("📥 Baixando skills do GoClaw...");
     try {
-        const url = `${config.goclaw.api_url}${config.goclaw.skills_export_endpoint || '/v1/skills/export'}`;
-        const response = await axios_1.default.get(url, {
-            headers: {
-                Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system"
-            },
-            responseType: "stream"
-        });
-        const tempTarPath = path_1.default.join(getWorkspaceRoot(), "temp_skills.tar.gz");
+        await pullAllSkills(config);
+        console.log("✅ Pull de skills concluído com sucesso! As skills foram atualizadas localmente.");
+    }
+    catch (error) {
+        console.error("❌ Erro durante o pull das skills:");
+        if (error.response) {
+            console.error(`Status HTTP ${error.response.status}`);
+        }
+        else {
+            console.error(error.message);
+        }
+    }
+});
+async function pullAgent(slug, agentId, config) {
+    console.log(`📦 Baixando agente: ${slug}...`);
+    const url = `${config.goclaw.api_url}/v1/agents/${agentId}/export`;
+    const response = await axios_1.default.get(url, {
+        headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" },
+        responseType: "stream"
+    });
+    const tempTarPath = path_1.default.join(getWorkspaceRoot(), `temp_agent_${slug}.tar.gz`);
+    try {
         const writer = fs_extra_1.default.createWriteStream(tempTarPath);
         response.data.pipe(writer);
         await new Promise((resolve, reject) => {
             writer.on("finish", resolve);
             writer.on("error", reject);
         });
-        console.log("📦 Extraindo skills para a pasta local...");
+        const agentPath = path_1.default.join(getWorkspaceRoot(), "agents", slug);
+        if (await fs_extra_1.default.pathExists(agentPath)) {
+            await fs_extra_1.default.emptyDir(agentPath);
+        }
+        else {
+            await fs_extra_1.default.ensureDir(agentPath);
+        }
+        // Obter os caminhos reais (com barras) da API para reverter o flattening do export
+        const docsRes = await axios_1.default.get(`${config.goclaw.api_url}/v1/agents/${agentId}/memory/documents`, {
+            headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
+        });
+        const pathMap = {};
+        (docsRes.data || []).forEach((d) => {
+            if (d.path) {
+                const flat = d.path.replace(/[\/\\]/g, '_');
+                pathMap[flat] = d.path;
+            }
+        });
         await tar.x({
             file: tempTarPath,
-            cwd: getWorkspaceRoot()
-        });
-        await fs_extra_1.default.remove(tempTarPath);
-        console.log("📥 Baixando ficheiros de código das skills...");
-        const skillsListRes = await axios_1.default.get(`${config.goclaw.api_url}/v1/skills`, {
-            headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
+            cwd: agentPath,
+            strip: 0,
+            filter: (path) => {
+                return path === 'agent.json' || path.startsWith('context_files/');
+            }
         });
-        const skills = skillsListRes.data.skills || [];
-        for (const skill of skills) {
-            try {
-                const isSystem = skill.is_system === true;
-                const targetFolder = isSystem ? path_1.default.join("system", skill.slug) : skill.slug;
-                if (isSystem) {
-                    const originalPath = path_1.default.join(getWorkspaceRoot(), "skills", skill.slug);
-                    const newPath = path_1.default.join(getWorkspaceRoot(), "skills", targetFolder);
-                    if (await fs_extra_1.default.pathExists(originalPath)) {
-                        await fs_extra_1.default.ensureDir(path_1.default.dirname(newPath));
-                        await fs_extra_1.default.move(originalPath, newPath, { overwrite: true });
+        const contextDir = path_1.default.join(agentPath, "context_files");
+        if (await fs_extra_1.default.pathExists(contextDir)) {
+            const contextFiles = await fs_extra_1.default.readdir(contextDir);
+            for (const f of contextFiles) {
+                const filePath = path_1.default.join(contextDir, f);
+                const stat = await fs_extra_1.default.stat(filePath);
+                if (stat.isFile()) {
+                    const content = await fs_extra_1.default.readFile(filePath, 'utf8');
+                    if (content === " " || content === "") {
+                        // Fantasma neutralizado pelo nosso script de deploy! Deita fora!
+                        await fs_extra_1.default.remove(filePath);
+                        continue;
                     }
                 }
-                const filesRes = await axios_1.default.get(`${config.goclaw.api_url}/v1/skills/${skill.id}/files`, {
-                    headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
-                });
-                const files = filesRes.data.files || [];
-                for (const file of files) {
-                    if (file.isDir)
-                        continue;
-                    const fileContentRes = await axios_1.default.get(`${config.goclaw.api_url}/v1/skills/${skill.id}/files/${file.path}`, {
-                        headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
-                    });
-                    const filePath = path_1.default.join(getWorkspaceRoot(), "skills", targetFolder, file.path);
-                    await fs_extra_1.default.ensureDir(path_1.default.dirname(filePath));
-                    await fs_extra_1.default.writeFile(filePath, fileContentRes.data.content || "");
+                if (pathMap[f]) {
+                    const targetPath = path_1.default.join(agentPath, pathMap[f]);
+                    await fs_extra_1.default.ensureDir(path_1.default.dirname(targetPath));
+                    await fs_extra_1.default.move(filePath, targetPath, { overwrite: true });
                 }
-            }
-            catch (fileErr) {
-                console.warn(`⚠️ Não foi possível transferir os ficheiros da skill ${skill.slug}: ${fileErr.message}`);
-            }
-        }
-        // Remover quaisquer skills fantasmas que o tarball tenha extraído (skills apagadas mas ainda no export)
-        const validSlugs = new Set(skills.map((s) => s.is_system === true ? path_1.default.join("system", s.slug) : s.slug));
-        const skillsDir = path_1.default.join(getWorkspaceRoot(), "skills");
-        if (await fs_extra_1.default.pathExists(skillsDir)) {
-            const localItems = await fs_extra_1.default.readdir(skillsDir);
-            for (const item of localItems) {
-                if (item === "system") {
-                    const systemDir = path_1.default.join(skillsDir, "system");
-                    if (await fs_extra_1.default.pathExists(systemDir)) {
-                        const systemItems = await fs_extra_1.default.readdir(systemDir);
-                        for (const sysItem of systemItems) {
-                            if (!validSlugs.has(path_1.default.join("system", sysItem))) {
-                                await fs_extra_1.default.remove(path_1.default.join(systemDir, sysItem));
-                            }
-                        }
-                    }
+                else if (f.startsWith('_system_') || f.startsWith('memory_')) {
+                    // É um stub de diretório do export do GoClaw (ex: _system_dreaming_) ou um órfão esmagado. Ignoramos.
+                    await fs_extra_1.default.remove(filePath);
                 }
-                else if (!validSlugs.has(item)) {
-                    await fs_extra_1.default.remove(path_1.default.join(skillsDir, item));
+                else {
+                    await fs_extra_1.default.move(filePath, path_1.default.join(agentPath, f), { overwrite: true });
                 }
             }
+            await fs_extra_1.default.remove(contextDir);
         }
-        console.log("✅ Pull concluído com sucesso! As skills foram atualizadas localmente.");
     }
-    catch (error) {
-        console.error("❌ Erro durante o pull das skills:");
-        if (error.response) {
-            console.error(`Status HTTP ${error.response.status}`);
-        }
-        else {
-            console.error(error.message);
+    finally {
+        if (await fs_extra_1.default.pathExists(tempTarPath)) {
+            await fs_extra_1.default.remove(tempTarPath);
         }
     }
-});
+}
 pullCmd
     .command("agents")
     .description("Faz download cirúrgico dos agentes (configuração e contexto)")
@@ -640,77 +946,7 @@ pullCmd
         console.log(`Encontrados ${agents.length} agentes. Sincronizando...`);
         for (const agent of agents) {
             const slug = agent.agent_key;
-            console.log(`📦 Baixando agente: ${slug}...`);
-            const url = `${config.goclaw.api_url}/v1/agents/${agent.id}/export?sections=config,context_files,memory`;
-            const response = await axios_1.default.get(url, {
-                headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" },
-                responseType: "stream"
-            });
-            const tempTarPath = path_1.default.join(getWorkspaceRoot(), `temp_agent_${slug}.tar.gz`);
-            try {
-                const writer = fs_extra_1.default.createWriteStream(tempTarPath);
-                response.data.pipe(writer);
-                await new Promise((resolve, reject) => {
-                    writer.on("finish", resolve);
-                    writer.on("error", reject);
-                });
-                const agentPath = path_1.default.join(getWorkspaceRoot(), "agents", slug);
-                await fs_extra_1.default.ensureDir(agentPath);
-                await tar.x({
-                    file: tempTarPath,
-                    cwd: agentPath,
-                    strip: 0,
-                    filter: (path) => {
-                        return path === 'agent.json' || path.startsWith('context_files/') || path.startsWith('memory/') || path === 'MEMORY.md' || path === 'memory.md';
-                    }
-                });
-                const contextDir = path_1.default.join(agentPath, "context_files");
-                if (await fs_extra_1.default.pathExists(contextDir)) {
-                    const contextFiles = await fs_extra_1.default.readdir(contextDir);
-                    for (const f of contextFiles) {
-                        await fs_extra_1.default.move(path_1.default.join(contextDir, f), path_1.default.join(agentPath, f), { overwrite: true });
-                    }
-                    await fs_extra_1.default.remove(contextDir);
-                }
-                // Reconstruir ficheiros de memória a partir de JSONL
-                const memoryDir = path_1.default.join(agentPath, "memory");
-                if (await fs_extra_1.default.pathExists(memoryDir)) {
-                    const processJsonl = async (filePath) => {
-                        if (!(await fs_extra_1.default.pathExists(filePath)))
-                            return;
-                        const content = await fs_extra_1.default.readFile(filePath, 'utf8');
-                        const lines = content.split('\n').filter(l => l.trim());
-                        for (const line of lines) {
-                            try {
-                                const entry = JSON.parse(line);
-                                if (entry.path && entry.content) {
-                                    const targetPath = path_1.default.join(agentPath, entry.path);
-                                    await fs_extra_1.default.ensureDir(path_1.default.dirname(targetPath));
-                                    await fs_extra_1.default.writeFile(targetPath, entry.content);
-                                }
-                            }
-                            catch (e) { }
-                        }
-                        await fs_extra_1.default.remove(filePath);
-                    };
-                    await processJsonl(path_1.default.join(memoryDir, "global.jsonl"));
-                    const usersDir = path_1.default.join(memoryDir, "users");
-                    if (await fs_extra_1.default.pathExists(usersDir)) {
-                        const userFiles = await fs_extra_1.default.readdir(usersDir);
-                        for (const uf of userFiles) {
-                            if (uf.endsWith(".jsonl")) {
-                                await processJsonl(path_1.default.join(usersDir, uf));
-                            }
-                        }
-                        await fs_extra_1.default.remove(usersDir);
-                    }
-                }
-            }
-            finally {
-                if (await fs_extra_1.default.pathExists(tempTarPath)) {
-                    await fs_extra_1.default.remove(tempTarPath);
-                }
-            }
+            await pullAgent(slug, agent.id, config);
         }
         console.log("✅ Pull de agentes concluído com sucesso!");
     }
@@ -740,55 +976,7 @@ pullCmd
     // PULL SKILLS INLINE
     console.log('\n--- [1/2] SKILLS ---');
     try {
-        const url = `${config.goclaw.api_url}${config.goclaw.skills_export_endpoint || '/v1/skills/export'}`;
-        const response = await axios_1.default.get(url, {
-            headers: { Authorization: `Bearer ${config.goclaw.token}`, 'X-GoClaw-User-Id': config.goclaw.username || 'system' },
-            responseType: 'stream'
-        });
-        const tempTarPath = path_1.default.join(getWorkspaceRoot(), 'temp_skills.tar.gz');
-        const writer = fs_extra_1.default.createWriteStream(tempTarPath);
-        response.data.pipe(writer);
-        await new Promise((resolve, reject) => {
-            writer.on('finish', resolve);
-            writer.on('error', reject);
-        });
-        await tar.x({ file: tempTarPath, cwd: getWorkspaceRoot() });
-        await fs_extra_1.default.remove(tempTarPath);
-        const skillsListRes = await axios_1.default.get(`${config.goclaw.api_url}/v1/skills`, {
-            headers: { Authorization: `Bearer ${config.goclaw.token}`, 'X-GoClaw-User-Id': config.goclaw.username || 'system' }
-        });
-        const skills = skillsListRes.data.skills || [];
-        for (const skill of skills) {
-            try {
-                const isSystem = skill.is_system === true;
-                const targetFolder = isSystem ? path_1.default.join('system', skill.slug) : skill.slug;
-                if (isSystem) {
-                    const originalPath = path_1.default.join(getWorkspaceRoot(), 'skills', skill.slug);
-                    const newPath = path_1.default.join(getWorkspaceRoot(), 'skills', targetFolder);
-                    if (await fs_extra_1.default.pathExists(originalPath)) {
-                        await fs_extra_1.default.ensureDir(path_1.default.dirname(newPath));
-                        await fs_extra_1.default.move(originalPath, newPath, { overwrite: true });
-                    }
-                }
-                const filesRes = await axios_1.default.get(`${config.goclaw.api_url}/v1/skills/${skill.id}/files`, {
-                    headers: { Authorization: `Bearer ${config.goclaw.token}`, 'X-GoClaw-User-Id': config.goclaw.username || 'system' }
-                });
-                const files = filesRes.data.files || [];
-                for (const file of files) {
-                    if (file.isDir)
-                        continue;
-                    const fileContentRes = await axios_1.default.get(`${config.goclaw.api_url}/v1/skills/${skill.id}/files/${file.path}`, {
-                        headers: { Authorization: `Bearer ${config.goclaw.token}`, 'X-GoClaw-User-Id': config.goclaw.username || 'system' }
-                    });
-                    const filePath = path_1.default.join(getWorkspaceRoot(), 'skills', targetFolder, file.path);
-                    await fs_extra_1.default.ensureDir(path_1.default.dirname(filePath));
-                    await fs_extra_1.default.writeFile(filePath, fileContentRes.data.content || '');
-                }
-            }
-            catch (fileErr) {
-                console.warn(`⚠️ Não foi possível transferir os ficheiros da skill ${skill.slug}: ${fileErr.message}`);
-            }
-        }
+        await pullAllSkills(config);
         console.log('✅ Pull de skills concluído!');
     }
     catch (error) {
@@ -804,44 +992,7 @@ pullCmd
         console.log(`Encontrados ${agents.length} agentes. Sincronizando...`);
         for (const agent of agents) {
             const slug = agent.agent_key;
-            console.log(`📦 Baixando agente: ${slug}...`);
-            const url = `${config.goclaw.api_url}/v1/agents/${agent.id}/export`;
-            const response = await axios_1.default.get(url, {
-                headers: { Authorization: `Bearer ${config.goclaw.token}`, 'X-GoClaw-User-Id': config.goclaw.username || 'system' },
-                responseType: 'stream'
-            });
-            const tempTarPath = path_1.default.join(getWorkspaceRoot(), `temp_agent_${slug}.tar.gz`);
-            try {
-                const writer = fs_extra_1.default.createWriteStream(tempTarPath);
-                response.data.pipe(writer);
-                await new Promise((resolve, reject) => {
-                    writer.on('finish', resolve);
-                    writer.on('error', reject);
-                });
-                const agentPath = path_1.default.join(getWorkspaceRoot(), 'agents', slug);
-                await fs_extra_1.default.ensureDir(agentPath);
-                await tar.x({
-                    file: tempTarPath,
-                    cwd: agentPath,
-                    strip: 0,
-                    filter: (path) => {
-                        return path === 'agent.json' || path.startsWith('context_files/');
-                    }
-                });
-                const contextDir = path_1.default.join(agentPath, 'context_files');
-                if (await fs_extra_1.default.pathExists(contextDir)) {
-                    const contextFiles = await fs_extra_1.default.readdir(contextDir);
-                    for (const f of contextFiles) {
-                        await fs_extra_1.default.move(path_1.default.join(contextDir, f), path_1.default.join(agentPath, f), { overwrite: true });
-                    }
-                    await fs_extra_1.default.remove(contextDir);
-                }
-            }
-            finally {
-                if (await fs_extra_1.default.pathExists(tempTarPath)) {
-                    await fs_extra_1.default.remove(tempTarPath);
-                }
-            }
+            await pullAgent(slug, agent.id, config);
         }
         console.log('✅ Pull de agentes concluído!');
     }