@innominatum/agentforge-cli 1.0.8 → 1.1.3

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);
@@ -175,7 +175,7 @@ newCmd
             const agentJson = {
                 agent_key: slug,
                 display_name: name,
-                agent_type: "custom",
+                agent_type: "predefined",
                 status: "active",
                 emoji: "🔥",
                 context_window: 200000,
@@ -198,7 +198,7 @@ newCmd
             const agentJson = {
                 agent_key: slug,
                 display_name: name,
-                agent_type: "custom",
+                agent_type: "predefined",
                 provider: config.goclaw?.default_provider || "ollama cloud",
                 model: config.goclaw?.default_model || "deepseek-v4-pro",
                 other_config: {
@@ -420,6 +420,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 +479,32 @@ 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}.`);
+    await deployAgent(slug, config);
+});
+deployCmd
+    .command("all")
+    .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 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.");
-        }
-        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.");
-        }
-        console.log(`🚀 Sincronizando arquivos de contexto...`);
-        await deployContextFiles(slug, config, agentId);
-        console.log("✅ Deploy completo concluído!");
+    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;
     }
-    catch (error) {
-        console.error(`❌ Erro no deploy da configuração:`, error.response?.data || error.message);
+    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);
+        }
     }
+    console.log("🏁 Deploy em lote concluído!");
 });
 const pullCmd = program
     .command("pull")
@@ -495,6 +522,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 +582,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 +629,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.8",
+  "version": "1.1.3",
   "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);
@@ -163,7 +163,7 @@ newCmd
         const agentJson = {
           agent_key: slug,
           display_name: name,
-          agent_type: "custom",
+          agent_type: "predefined",
           status: "active",
           emoji: "🔥",
           context_window: 200000,
@@ -186,7 +186,7 @@ newCmd
         const agentJson = {
           agent_key: slug,
           display_name: name,
-          agent_type: "custom",
+          agent_type: "predefined",
           provider: config.goclaw?.default_provider || "ollama cloud",
           model: config.goclaw?.default_model || "deepseek-v4-pro",
           other_config: {
@@ -451,6 +451,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 +516,38 @@ 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}.`);
+deployCmd
+  .command("all")
+  .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 agentConfig = await fs.readJson(agentJsonPath);
-    console.log(`🚀 Atualizando configuração do agente "${slug}"...`);
+    const basePath = getWorkspaceRoot();
+    const agentsDir = path.join(basePath, "agents");
     
-    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.");
-      }
-
-      console.log(`🚀 Sincronizando arquivos de contexto...`);
-      await deployContextFiles(slug, config, agentId);
+    if (!(await fs.pathExists(agentsDir))) {
+      console.log("Nenhum agente encontrado em agents/.");
+      return;
+    }
 
-      console.log("✅ Deploy completo concluído!");
-    } catch (error: any) {
-      console.error(`❌ Erro no deploy da configuração:`, error.response?.data || error.message);
+    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);
+      }
     }
+    
+    console.log("🏁 Deploy em lote concluído!");
   });
 
 const pullCmd = program
@@ -536,6 +569,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 +637,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 +685,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,32 @@ 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 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.
+
 ### 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 +89,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
 {