@innominatum/agentforge-cli 1.1.3 → 1.1.9

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;
@@ -481,8 +531,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,20 +577,35 @@ 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")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@innominatum/agentforge-cli",
-  "version": "1.1.3",
+  "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

@@ -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) {
@@ -519,8 +577,45 @@ deployCmd
     await deployAgent(slug, config);
   });
 
+
+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/.");
+  }
+}
+
+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("all")
+  .command("agents")
   .description("Faz deploy de todos os agentes do workspace")
   .action(async () => {
     const config = await getConfig();
@@ -528,26 +623,40 @@ deployCmd
       console.error("❌ Configure sua chave de API (token) no agentforge.json.");
       process.exit(1);
     }
-
     const basePath = getWorkspaceRoot();
-    const agentsDir = path.join(basePath, "agents");
-    
-    if (!(await fs.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 basePath = getWorkspaceRoot();
+    await deployAllSkills(config, basePath);
+    console.log("🏁 Deploy de skills concluído!");
+  });
 
-    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);
-      }
+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 em lote concluído!");
+    console.log("🏁 Deploy completo (agentes e skills) concluído!");
   });
 
 const pullCmd = program

package/templates/CLI_MANUAL.md

@@ -42,10 +42,20 @@ 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 (config + context + memory) for **all agents** found in your `agents/` directory. This is the most efficient way to synchronize your entire team after making cross-cutting changes.
+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