@innominatum/agentforge-cli 1.0.9 → 1.1.9

package/dist/index.js

@@ -52,7 +52,7 @@ function confirmOverwrite(entityType) {
         output: process.stdout
     });
     return new Promise(resolve => {
-        rl.question(`⚠️ Atenção: O pull irá sobrescrever as suas ${entityType} locais. Quaisquer alterações não publicadas serão perdidas. Deseja continuar? (s/N) `, answer => {
+        rl.question(`⚠️ Atenção: O pull irá APAGAR as suas ${entityType} locais e substituí-las pelo estado do servidor. Quaisquer alterações ou entidades não publicadas serão PERDIDAS. Deseja continuar? (s/N) `, answer => {
             rl.close();
             const isYes = answer.toLowerCase() === 's' || answer.toLowerCase() === 'sim' || answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes';
             resolve(isYes);
@@ -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;
@@ -420,6 +470,38 @@ async function deployContextFiles(slug, config, resolvedId) {
             await fs_extra_1.default.remove(tarPath);
     }
 }
+async function deployAgent(slug, config) {
+    const basePath = getWorkspaceRoot();
+    const agentPath = path_1.default.join(basePath, "agents", slug);
+    const agentJsonPath = path_1.default.join(agentPath, "agent.json");
+    if (!(await fs_extra_1.default.pathExists(agentJsonPath))) {
+        console.error(`❌ agent.json não encontrado em agents/${slug}.`);
+        return;
+    }
+    const agentConfig = await fs_extra_1.default.readJson(agentJsonPath);
+    console.log(`🚀 Sincronizando agente "${slug}"...`);
+    try {
+        const agentId = await resolveAgentId(slug, config);
+        const exists = agentId !== null;
+        if (!exists) {
+            await axios_1.default.post(`${config.goclaw.api_url}/v1/agents`, agentConfig, {
+                headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
+            });
+            console.log(`✅ Agente "${slug}" criado.`);
+        }
+        else {
+            await axios_1.default.put(`${config.goclaw.api_url}/v1/agents/${agentId}`, agentConfig, {
+                headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
+            });
+            console.log(`✅ Configuração de "${slug}" atualizada.`);
+        }
+        await deployContextFiles(slug, config, agentId);
+        console.log(`✅ Agente "${slug}" sincronizado com sucesso!`);
+    }
+    catch (error) {
+        console.error(`❌ Erro no deploy de "${slug}":`, error.response?.data || error.message);
+    }
+}
 deployCmd
     .command("context <slug>")
     .description("Faz upload dos arquivos de contexto diretamente para o agente usando a API de importação")
@@ -447,37 +529,83 @@ deployCmd
         console.error("❌ Configure sua chave de API (token) no agentforge.json.");
         process.exit(1);
     }
-    const basePath = getWorkspaceRoot();
-    const agentPath = path_1.default.join(basePath, "agents", slug);
-    const agentJsonPath = path_1.default.join(agentPath, "agent.json");
-    if (!(await fs_extra_1.default.pathExists(agentJsonPath))) {
-        console.error(`❌ agent.json não encontrado em agents/${slug}.`);
-        process.exit(1);
-    }
-    const agentConfig = await fs_extra_1.default.readJson(agentJsonPath);
-    console.log(`🚀 Atualizando configuração do agente "${slug}"...`);
-    try {
-        const agentId = await resolveAgentId(slug, config);
-        const exists = agentId !== null;
-        if (!exists) {
-            await axios_1.default.post(`${config.goclaw.api_url}/v1/agents`, agentConfig, {
-                headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
-            });
-            console.log("✅ Agente criado com sucesso.");
+    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 {
-            await axios_1.default.put(`${config.goclaw.api_url}/v1/agents/${agentId}`, agentConfig, {
-                headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
-            });
-            console.log("✅ Configurações do agente atualizadas.");
+    }
+    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);
+            }
         }
-        console.log(`🚀 Sincronizando arquivos de contexto...`);
-        await deployContextFiles(slug, config, agentId);
-        console.log("✅ Deploy completo concluído!");
     }
-    catch (error) {
-        console.error(`❌ Erro no deploy da configuração:`, error.response?.data || error.message);
+    else {
+        console.log("Nenhuma skill encontrada em skills/.");
+    }
+}
+deployCmd
+    .command("agents")
+    .description("Faz deploy de todos os agentes 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 basePath = getWorkspaceRoot();
+    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 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);
     }
+    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")
@@ -495,6 +623,8 @@ 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'}`;
@@ -553,6 +683,28 @@ pullCmd
                 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 (!validSlugs.has(item)) {
+                    await fs_extra_1.default.remove(path_1.default.join(skillsDir, item));
+                }
+            }
+        }
         console.log("✅ Pull concluído com sucesso! As skills foram atualizadas localmente.");
     }
     catch (error) {
@@ -578,6 +730,8 @@ pullCmd
         console.log("❌ Pull cancelado pelo utilizador.");
         return;
     }
+    console.log("🧹 Limpando a pasta local de agentes...");
+    await fs_extra_1.default.emptyDir(path_1.default.join(getWorkspaceRoot(), "agents"));
     console.log("📥 Buscando lista de agentes do GoClaw...");
     try {
         const listResponse = await axios_1.default.get(`${config.goclaw.api_url}/v1/agents`, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@innominatum/agentforge-cli",
-  "version": "1.0.9",
+  "version": "1.1.9",
   "description": "A powerful command-line interface to scaffold, manage, build, and deploy AI Agents and Skills for the GoClaw platform.",
   "main": "dist/index.js",
   "bin": {

package/src/index.ts

@@ -17,7 +17,7 @@ function confirmOverwrite(entityType: string): Promise<boolean> {
   });
 
   return new Promise(resolve => {
-    rl.question(`⚠️ Atenção: O pull irá sobrescrever as suas ${entityType} locais. Quaisquer alterações não publicadas serão perdidas. Deseja continuar? (s/N) `, answer => {
+    rl.question(`⚠️ Atenção: O pull irá APAGAR as suas ${entityType} locais e substituí-las pelo estado do servidor. Quaisquer alterações ou entidades não publicadas serão PERDIDAS. Deseja continuar? (s/N) `, answer => {
       rl.close();
       const isYes = answer.toLowerCase() === 's' || answer.toLowerCase() === 'sim' || answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes';
       resolve(isYes);
@@ -314,9 +314,106 @@ const deployCmd = program
   .command("deploy")
   .description("Faz o deploy de entidades para a plataforma GoClaw");
 
+async function deploySkill(slug: string, config: any, basePath: string) {
+  const skillPath = path.join(basePath, "skills", slug);
+  const exportsPath = path.join(basePath, "exports");
+  const safeSlug = slug.replace(/[\\\/]/g, '_');
+  const zipPath = path.join(exportsPath, `${safeSlug}.zip`);
+
+  if (!(await fs.pathExists(skillPath))) {
+    console.error(`❌ A skill "${slug}" não foi encontrada em skills/${slug}.`);
+    return;
+  }
+  
+  await fs.ensureDir(exportsPath);
+  const zip = new AdmZip();
+  zip.addLocalFolder(skillPath, "");
+  zip.writeZip(zipPath);
+  
+  console.log(`🚀 Fazendo upload da skill "${slug}" para o GoClaw...`);
+  const form = new FormData();
+  form.append("file", fs.createReadStream(zipPath));
+
+  try {
+    const url = `${config.goclaw.api_url}/v1/skills/upload`;
+    const response = await axios.post(url, form, {
+      headers: {
+        ...form.getHeaders(),
+        Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system"
+      }
+    });
+    const data = response.data;
+    if (data && 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.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: any) => s.slug === slug);
+    
+    if (remoteSkill) {
+      const metadataPath = path.join(skillPath, "metadata.json");
+      if (await fs.pathExists(metadataPath)) {
+        console.log(`🚀 Sincronizando metadados da skill "${slug}"...`);
+        const metadata = await fs.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.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.join(skillPath, "grants.jsonl");
+      if (await fs.pathExists(grantsPath)) {
+        console.log(`🚀 Sincronizando permissões (grants) da skill "${slug}"...`);
+        const grantsContent = await fs.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.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: any) {
+            console.warn(`   ⚠️ Falha ao conceder permissão: ${e.response?.data?.error || e.message}`);
+          }
+        }
+        console.log(`✅ Permissões sincronizadas.`);
+      }
+    }
+
+  } catch (error: any) {
+    console.error(`❌ Erro no deploy da skill "${slug}":`);
+    if (error.response) {
+      console.error(error.response.data);
+    } else {
+      console.error(error.message);
+    }
+  }
+}
+
 deployCmd
   .command("skill <slug>")
-  .description("Faz o build da skill e envia para a API do GoClaw")
+  .description("Faz build e upload automático de uma skill para o GoClaw")
   .action(async (slug: string) => {
     const config = await getConfig();
     if (!config.goclaw || !config.goclaw.token) {
@@ -325,46 +422,7 @@ deployCmd
     }
 
     const basePath = getWorkspaceRoot();
-    const skillPath = path.join(basePath, "skills", slug);
-    const exportsPath = path.join(basePath, "exports");
-    const zipPath = path.join(exportsPath, `${slug}.zip`);
-
-    if (!(await fs.pathExists(skillPath))) {
-      console.error(`❌ A skill "${slug}" não foi encontrada em skills/${slug}.`);
-      process.exit(1);
-    }
-    
-    await fs.ensureDir(exportsPath);
-    const zip = new AdmZip();
-    zip.addLocalFolder(skillPath, "");
-    zip.writeZip(zipPath);
-    
-    console.log(`✅ Build concluído: ${slug}.zip preparado para envio.`);
-
-    console.log(`🚀 Fazendo upload para o GoClaw...`);
-    const form = new FormData();
-    form.append("file", fs.createReadStream(zipPath));
-
-    try {
-      const url = `${config.goclaw.api_url}/v1/skills/upload`;
-      const response = await axios.post(url, form, {
-        headers: {
-          ...form.getHeaders(),
-          Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system"
-        }
-      });
-      const data = response.data;
-      if (data && data.version) {
-        console.log(`📌 Skill atualizada para a versão ${data.version}.`);
-      }
-    } catch (error: any) {
-      console.error("❌ Erro durante o deploy:");
-      if (error.response) {
-        console.error(error.response.data);
-      } else {
-        console.error(error.message);
-      }
-    }
+    await deploySkill(slug, config, basePath);
   });
 
 async function deployContextFiles(slug: string, config: any, resolvedId?: string | null) {
@@ -451,6 +509,42 @@ async function deployContextFiles(slug: string, config: any, resolvedId?: string
   }
 }
 
+async function deployAgent(slug: string, config: any) {
+  const basePath = getWorkspaceRoot();
+  const agentPath = path.join(basePath, "agents", slug);
+  const agentJsonPath = path.join(agentPath, "agent.json");
+
+  if (!(await fs.pathExists(agentJsonPath))) {
+    console.error(`❌ agent.json não encontrado em agents/${slug}.`);
+    return;
+  }
+
+  const agentConfig = await fs.readJson(agentJsonPath);
+  console.log(`🚀 Sincronizando agente "${slug}"...`);
+  
+  try {
+    const agentId = await resolveAgentId(slug, config);
+    const exists = agentId !== null;
+
+    if (!exists) {
+       await axios.post(`${config.goclaw.api_url}/v1/agents`, agentConfig, {
+         headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
+       });
+       console.log(`✅ Agente "${slug}" criado.`);
+    } else {
+       await axios.put(`${config.goclaw.api_url}/v1/agents/${agentId}`, agentConfig, {
+         headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
+       });
+       console.log(`✅ Configuração de "${slug}" atualizada.`);
+    }
+
+    await deployContextFiles(slug, config, agentId);
+    console.log(`✅ Agente "${slug}" sincronizado com sucesso!`);
+  } catch (error: any) {
+    console.error(`❌ Erro no deploy de "${slug}":`, error.response?.data || error.message);
+  }
+}
+
 deployCmd
   .command("context <slug>")
   .description("Faz upload dos arquivos de contexto diretamente para o agente usando a API de importação")
@@ -480,41 +574,89 @@ deployCmd
       process.exit(1);
     }
 
-    const basePath = getWorkspaceRoot();
-    const agentPath = path.join(basePath, "agents", slug);
-    const agentJsonPath = path.join(agentPath, "agent.json");
+    await deployAgent(slug, config);
+  });
 
-    if (!(await fs.pathExists(agentJsonPath))) {
-      console.error(`❌ agent.json não encontrado em agents/${slug}.`);
-      process.exit(1);
+
+async function deployAllAgents(config: any, basePath: string) {
+  const agentsDir = path.join(basePath, "agents");
+  if (await fs.pathExists(agentsDir)) {
+    const agents = await fs.readdir(agentsDir);
+    console.log(`🚀 Iniciando deploy em lote de ${agents.length} agentes...`);
+    for (const slug of agents) {
+      const agentPath = path.join(agentsDir, slug);
+      if ((await fs.stat(agentPath)).isDirectory()) {
+         await deployAgent(slug, config);
+      }
     }
+  } else {
+    console.log("Nenhum agente encontrado em agents/.");
+  }
+}
 
-    const agentConfig = await fs.readJson(agentJsonPath);
-    console.log(`🚀 Atualizando configuração do agente "${slug}"...`);
-    
-    try {
-      const agentId = await resolveAgentId(slug, config);
-      const exists = agentId !== null;
-
-      if (!exists) {
-         await axios.post(`${config.goclaw.api_url}/v1/agents`, agentConfig, {
-           headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
-         });
-         console.log("✅ Agente criado com sucesso.");
-      } else {
-         await axios.put(`${config.goclaw.api_url}/v1/agents/${agentId}`, agentConfig, {
-           headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
-         });
-         console.log("✅ Configurações do agente atualizadas.");
+async function deployAllSkills(config: any, basePath: string) {
+  const skillsDir = path.join(basePath, "skills");
+  if (await fs.pathExists(skillsDir)) {
+    const skills = await fs.readdir(skillsDir);
+    console.log(`🚀 Iniciando deploy em lote de skills...`);
+    for (const item of skills) {
+      const itemPath = path.join(skillsDir, item);
+      if ((await fs.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("agents")
+  .description("Faz deploy de todos os agentes 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 basePath = getWorkspaceRoot();
+    await deployAllAgents(config, basePath);
+    console.log("🏁 Deploy de agentes concluído!");
+  });
 
-      console.log(`🚀 Sincronizando arquivos de contexto...`);
-      await deployContextFiles(slug, config, agentId);
+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 basePath = getWorkspaceRoot();
+    await deployAllSkills(config, basePath);
+    console.log("🏁 Deploy de skills concluído!");
+  });
 
-      console.log("✅ Deploy completo concluído!");
-    } catch (error: any) {
-      console.error(`❌ Erro no deploy da configuração:`, error.response?.data || error.message);
+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);
     }
+
+    const basePath = getWorkspaceRoot();
+    await deployAllAgents(config, basePath);
+    await deployAllSkills(config, basePath);
+    
+    console.log("🏁 Deploy completo (agentes e skills) concluído!");
   });
 
 const pullCmd = program
@@ -536,6 +678,9 @@ pullCmd
       return;
     }
 
+    console.log("🧹 Limpando a pasta local de skills...");
+    await fs.emptyDir(path.join(getWorkspaceRoot(), "skills"));
+
     console.log("📥 Baixando skills do GoClaw...");
     try {
       const url = `${config.goclaw.api_url}${config.goclaw.skills_export_endpoint || '/v1/skills/export'}`;
@@ -601,6 +746,28 @@ pullCmd
         }
       }
 
+      // Remover quaisquer skills fantasmas que o tarball tenha extraído (skills apagadas mas ainda no export)
+      const validSlugs = new Set(skills.map((s: any) => s.is_system === true ? path.join("system", s.slug) : s.slug));
+      const skillsDir = path.join(getWorkspaceRoot(), "skills");
+      if (await fs.pathExists(skillsDir)) {
+        const localItems = await fs.readdir(skillsDir);
+        for (const item of localItems) {
+          if (item === "system") {
+            const systemDir = path.join(skillsDir, "system");
+            if (await fs.pathExists(systemDir)) {
+              const systemItems = await fs.readdir(systemDir);
+              for (const sysItem of systemItems) {
+                if (!validSlugs.has(path.join("system", sysItem))) {
+                  await fs.remove(path.join(systemDir, sysItem));
+                }
+              }
+            }
+          } else if (!validSlugs.has(item)) {
+            await fs.remove(path.join(skillsDir, item));
+          }
+        }
+      }
+
       console.log("✅ Pull concluído com sucesso! As skills foram atualizadas localmente.");
     } catch (error: any) {
       console.error("❌ Erro durante o pull das skills:");
@@ -627,6 +794,9 @@ pullCmd
       return;
     }
 
+    console.log("🧹 Limpando a pasta local de agentes...");
+    await fs.emptyDir(path.join(getWorkspaceRoot(), "agents"));
+
     console.log("📥 Buscando lista de agentes do GoClaw...");
     try {
       const listResponse = await axios.get(`${config.goclaw.api_url}/v1/agents`, {

package/templates/CLI_MANUAL.md

@@ -41,26 +41,42 @@ agentforge pull all
 ```
 Downloads all agents and skills from the GoClaw server. It performs a **surgical extraction**, retrieving only the core `agent.json`, `context_files/`, and skill definitions to keep your workspace perfectly clean. Note: This will ask for confirmation before overwriting local files.
 
+### Bulk Deployment
+```bash
+agentforge deploy agents
+```
+Performs a full deployment (config + context + memory) for **all agents** found in your `agents/` directory.
+
+```bash
+agentforge deploy skills
+```
+Packages and uploads **all skills** (including those in the `system/` directory) found in your `skills/` directory.
+
+```bash
+agentforge deploy all
+```
+Performs a full deployment for **all agents and skills**. This is the most efficient way to synchronize your entire team and toolset after making cross-cutting changes.
+
 ### Agent Management
 ```bash
 agentforge new agent "<Agent Name>"
 ```
-Creates a new agent inside the `agents/` directory using the files found in `templates/default-agent/`. If the name contains spaces, remember to wrap it in quotes. The CLI will automatically slugify the folder name (e.g., `agents/my-super-agent/`).
+Creates a new agent inside the `agents/` directory. The default `agent_type` is now `predefined`, aligning with GoClaw's official standard for agents with established personalities.
 
 ```bash
 agentforge pull agents
 ```
-Downloads all agents from the GoClaw server and extracts them locally.
+Downloads all agents from the GoClaw server and extracts them locally. It automatically reconstructs memory files from GoClaw's internal JSONL format back into readable Markdown files.
 
 ```bash
 agentforge deploy agent <slug>
 ```
-**Full Deployment:** Reads the local `agent.json` to create a new agent or update an existing one (e.g., updating the LLM model). Then, it automatically synchronizes all context files.
+**Full Deployment:** Reads the local `agent.json` to create or update an agent. Then, it synchronizes all context files and memory (including `MEMORY.md` and the `memory/` folder).
 
 ```bash
 agentforge deploy context <slug>
 ```
-**Hot Reload for Context:** Fast-path deployment that reads all local `.md`, `.txt`, and `.py` files in your agent folder and uploads them directly to the agent's mind on the server. Perfect for iterating on prompts.
+**Hot Reload for Context & Memory:** Fast-path deployment that uploads all local context files (`.md`, `.txt`, `.py`) and memory data directly to the server.
 
 ### Skill Management
 ```bash
@@ -83,8 +99,18 @@ agentforge deploy skill <slug>
 ```
 Automatically builds your skill into a `.zip` file and securely uploads it to your GoClaw server via the Upload API.
 
-### Configuration
-Before using the deployment commands, make sure to add your GoClaw Bearer Token to the `agentforge.json` file located at the root of your workspace:
+---
+
+## Memory Support 🧠
+AgentForge CLI handles agent memory as first-class citizens:
+- **MEMORY.md**: Use this file at the root of your agent folder for curated, long-term memory.
+- **memory/**: Any files inside this folder (e.g., chat histories, user-specific facts) are synchronized.
+- **Auto-Conversion**: When pulling, the CLI converts GoClaw's `.jsonl` exports back into `.md` files for easier editing in VS Code.
+
+---
+
+## Configuration
+Before using the deployment commands, make sure to add your GoClaw Bearer Token to the `agentforge.json` file:
 
 ```json
 {