abm-ks 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -5,6 +5,23 @@ Todas as mudanças notáveis neste projeto serão documentadas neste arquivo.
 O formato é baseado em [Keep a Changelog](https://keepachangelog.com/pt-BR/1.0.0/),
 e este projeto adere ao [Versionamento Semântico](https://semver.org/lang/pt-BR/).
 
+## [0.1.1] - 2025-01-15
+
+### Adicionado
+- **Team Selection**: Opção de instalar equipes opcionais (Brainstorming, Documentation)
+- **Language Filter**: Instala apenas templates da linguagem selecionada (Python, NetLogo, ou C++)
+- Pergunta sobre equipes opcionais durante instalação
+- Resumo mostra equipes e templates selecionados
+
+### Corrigido
+- Versão correta exibida no banner (era 0.1.0-alpha.1)
+- URL da documentação atualizado para github.com/muriloms/abm-ks
+- Comandos atualizados: `*init` em vez de `*workflow-init`
+
+### Melhorado
+- Instalação mais rápida ao baixar apenas templates necessários
+- Estrutura de diretórios criada baseada na linguagem selecionada
+
 ## [0.1.0] - 2025-01-15
 
 ### 🎉 Release Inicial

package/README.md

@@ -2,7 +2,7 @@
 
 > **Framework de agentes especializados para desenvolvimento de modelos baseados em agentes (ABM)**
 
-[![Version](https://img.shields.io/badge/version-0.1.0-blue.svg)](https://github.com/abm-ks/abm-ks)
+[![Version](https://img.shields.io/badge/version-0.1.1-blue.svg)](https://github.com/muriloms/abm-ks)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![Tests](https://img.shields.io/badge/tests-331%20passing-brightgreen.svg)](#testes)
 
@@ -98,7 +98,7 @@ npx abm-ks install
 
 ```bash
 # Clone o repositório
-git clone https://github.com/abm-ks/abm-ks.git
+git clone https://github.com/muriloms/abm-ks.git
 
 # Entre no diretório
 cd abm-ks
@@ -450,6 +450,6 @@ Este projeto está licenciado sob a [MIT License](LICENSE).
 
 **ABM-KS v0.1.0** | Feito com ❤️ para a comunidade de modelagem
 
-[Documentação](docs/) · [Issues](https://github.com/abm-ks/abm-ks/issues) · [Discussões](https://github.com/abm-ks/abm-ks/discussions)
+[Documentação](docs/) · [Issues](https://github.com/muriloms/abm-ks/issues) · [Discussões](https://github.com/muriloms/abm-ks/discussions)
 
 </div>

package/docs/guides/getting-started.md

@@ -4,7 +4,7 @@ Welcome to ABM-KS! This guide will help you create your first agent-based model.
 
 ## What is ABM-KS?
 
-ABM-KS (Agent-Based Model Knowledge System) is an AI-powered assistant that guides you through the entire process of creating agent-based models:
+ABM-KS (Agent-Based Modeling Knowledge System) is an AI-powered assistant that guides you through the entire process of creating agent-based models:
 
 - 💡 **Conceptualization** - Define your model's purpose
 - 🏗️ **Design** - Plan agents and behaviors

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "abm-ks",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Agent-Based Modeling Knowledge System - Framework de agentes especializados para desenvolvimento de modelos baseados em agentes (ABM)",
   "type": "module",
   "main": "tools/abm-ks-npx-wrapper.js",
@@ -38,12 +38,12 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/abm-ks/abm-ks.git"
+    "url": "git+https://github.com/muriloms/abm-ks.git"
   },
   "bugs": {
-    "url": "https://github.com/abm-ks/abm-ks/issues"
+    "url": "https://github.com/muriloms/abm-ks/issues"
   },
-  "homepage": "https://github.com/abm-ks/abm-ks#readme",
+  "homepage": "https://github.com/muriloms/abm-ks#readme",
   "engines": {
     "node": ">=18.0.0"
   },

package/src/core/agents/abm-master.agent.yaml

@@ -18,7 +18,7 @@ agent:
   persona:
     role: >
       You are the ABM Master, the primary orchestrator for the ABM-KS 
-      (Agent-Based Model Kick Start) framework. You guide researchers and 
+      (Agent-Based Modeling Knowledge System) framework. You guide researchers and 
       developers through the complete lifecycle of agent-based model development,
       from conceptualization to publication-ready documentation.
       
@@ -153,7 +153,7 @@ agent:
   activation_message: |
     # 🎯 ABM Master Activated
     
-    Welcome to **ABM-KS** (Agent-Based Model Kick Start)!
+    Welcome to **ABM-KS** (Agent-Based Modeling Knowledge System)!
     
     I'm your guide through the ABM development process. I'll help you:
     - Design scientifically rigorous models

package/src/core/workflows/help/instructions.md

@@ -550,7 +550,7 @@ When user runs `*help faq`:
 ## General
 
 ### What is ABM-KS?
-ABM-KS (Agent-Based Model Knowledge System) is an AI assistant that guides you through creating agent-based models, from concept to documentation.
+ABM-KS (Agent-Based Modeling Knowledge System) is an AI assistant that guides you through creating agent-based models, from concept to documentation.
 
 ### What platforms are supported?
 - 🐍 **Python** (Mesa framework)

package/src/modules/abm/workflows/4-documentation/readme-generation/readme-template.md

@@ -258,4 +258,4 @@ This project is licensed under the {{license}} License - see [LICENSE](LICENSE)
 
 ---
 
-*This model was developed using [ABM-KS](https://github.com/abm-ks/abm-ks), the Agent-Based Modeling Knowledge System.*
+*This model was developed using [ABM-KS](https://github.com/muriloms/abm-ks), the Agent-Based Modeling Knowledge System.*

package/tests/test-report.json

@@ -0,0 +1,31 @@
+{
+  "timestamp": "2026-01-16T13:20:06.039Z",
+  "version": "0.1.0",
+  "results": {
+    "structure": {
+      "passed": 265,
+      "failed": 0,
+      "status": "passed"
+    },
+    "yaml": {
+      "passed": 54,
+      "failed": 0,
+      "status": "passed"
+    },
+    "integration": {
+      "passed": 7,
+      "failed": 0,
+      "status": "passed"
+    },
+    "e2e": {
+      "passed": 5,
+      "failed": 0,
+      "status": "passed"
+    }
+  },
+  "summary": {
+    "totalPassed": 331,
+    "totalFailed": 0,
+    "allPassed": true
+  }
+}

package/tools/abm-ks-npx-wrapper.js

@@ -3,7 +3,7 @@
 /**
  * ABM-KS NPX Wrapper
  * ==================
- * Entry point for: npx abm-ks@alpha install
+ * Entry point for: npx abm-ks install
  * 
  * This wrapper delegates to the CLI module
  */

package/tools/cli/abm-ks-cli.js

@@ -16,7 +16,7 @@ const __dirname = dirname(__filename);
 
 // Package info
 export const PACKAGE_NAME = 'abm-ks';
-export const VERSION = '0.1.0-alpha.1';
+export const VERSION = '0.1.1';
 
 // ANSI color codes
 export const colors = {
@@ -47,7 +47,7 @@ ${colors.cyan}${colors.bright}
     ║    ██║  ██║██████╔╝██║ ╚═╝ ██║      ██║  ██╗███████║     ║
     ║    ╚═╝  ╚═╝╚═════╝ ╚═╝     ╚═╝      ╚═╝  ╚═╝╚══════╝     ║
     ║                                                           ║
-    ║         Agent-Based Model Kick Start v${VERSION}          ║
+    ║      Agent-Based Modeling Knowledge System v${VERSION}       ║
     ║                                                           ║
     ╚═══════════════════════════════════════════════════════════╝
 ${colors.reset}`);

package/tools/cli/commands/help.js

@@ -25,17 +25,17 @@ ${colors.bright}Options:${colors.reset}
 
 ${colors.bright}Examples:${colors.reset}
   ${colors.dim}# Install ABM-KS in your project${colors.reset}
-  npx ${PACKAGE_NAME}@alpha install
+  npx ${PACKAGE_NAME} install
 
   ${colors.dim}# Show version${colors.reset}
   npx ${PACKAGE_NAME} --version
 
 ${colors.bright}Documentation:${colors.reset}
-  https://github.com/muriloms/abm-ks
+  https://github.com/abm-ks/abm-ks
 
 ${colors.bright}After Installation:${colors.reset}
   Activate the ABM Master agent in your AI IDE and run:
-  ${colors.cyan}*workflow-init${colors.reset}
+  ${colors.cyan}*init${colors.reset}
 `);
   }
 };

package/tools/installer/lib/config-collector.js

@@ -23,6 +23,14 @@ import {
   getTimestamp 
 } from './utils.js';
 
+/**
+ * Team options for optional modules
+ */
+const TEAM_OPTIONS = [
+  { value: 'brainstorm', label: 'Brainstorming Team', hint: 'ideation, literature review, hypothesis generation', checked: false },
+  { value: 'documentation', label: 'Documentation Team', hint: 'academic papers, technical manuals, analysis protocols', checked: false },
+];
+
 /**
  * Configuration Collector Class
  */
@@ -52,6 +60,10 @@ export class ConfigCollector {
     await this.collectPlatform();
     await this.collectExperience();
 
+    // Collect team selection (optional modules)
+    section('Team Selection');
+    await this.collectTeams();
+
     // Collect IDE settings
     section('IDE Configuration');
     await this.collectIDEs();
@@ -153,6 +165,55 @@ export class ConfigCollector {
       );
       this.config.pythonFramework = framework;
     }
+
+    // Store which template languages to install based on platform
+    this.config.templateLanguages = this.getTemplateLanguages(platform);
+  }
+
+  /**
+   * Get template languages based on platform selection
+   */
+  getTemplateLanguages(platform) {
+    switch (platform) {
+      case 'python':
+        return ['python'];
+      case 'netlogo':
+        return ['netlogo'];
+      case 'cpp':
+        return ['cpp'];
+      case 'multi':
+        return ['python', 'netlogo', 'cpp'];
+      default:
+        return ['python'];
+    }
+  }
+
+  /**
+   * Collect optional team modules
+   */
+  async collectTeams() {
+    logger.info('Core and ABM Development teams are always included.');
+    logger.newline();
+
+    const includeOptional = await confirm(
+      'Include optional teams (Brainstorming, Documentation)?',
+      false
+    );
+
+    if (includeOptional) {
+      const selectedTeams = await multiSelect(
+        'Select optional teams to install:',
+        TEAM_OPTIONS
+      );
+      
+      this.config.optionalTeams = selectedTeams;
+      this.config.includeBrainstorm = selectedTeams.includes('brainstorm');
+      this.config.includeDocumentation = selectedTeams.includes('documentation');
+    } else {
+      this.config.optionalTeams = [];
+      this.config.includeBrainstorm = false;
+      this.config.includeDocumentation = false;
+    }
   }
 
   /**
@@ -236,10 +297,17 @@ export class ConfigCollector {
     const experienceLabel = EXPERIENCE_LEVELS.find(e => e.value === this.config.experience)?.label || this.config.experience;
     const trackInfo = TRACKS[this.config.track];
 
+    // Build teams string
+    let teamsStr = 'Core, ABM Development';
+    if (this.config.includeBrainstorm) teamsStr += ', Brainstorming';
+    if (this.config.includeDocumentation) teamsStr += ', Documentation';
+
     summaryBox('Installation Summary', {
       'Project': this.config.projectName,
       'Domain': domainLabel,
       'Platform': platformLabel,
+      'Templates': this.config.templateLanguages.join(', '),
+      'Teams': teamsStr,
       'Experience': experienceLabel,
       'Track': `${trackInfo.name} (${trackInfo.estimatedTime})`,
       'IDEs': this.config.ides.join(', '),
@@ -269,6 +337,9 @@ export class ConfigCollector {
     if (this.config.ides.length === 0) {
       this.config.ides = ['cursor'];
     }
+    this.config.optionalTeams = [];
+    this.config.includeBrainstorm = false;
+    this.config.includeDocumentation = false;
 
     this.determineTrack();
 

package/tools/installer/lib/installer.js

@@ -4,8 +4,8 @@
  * Main installer class that orchestrates the installation process
  */
 
-import { existsSync, rmSync, writeFileSync } from 'fs';
-import { join } from 'path';
+import { existsSync, rmSync, writeFileSync, readdirSync } from 'fs';
+import { join, basename } from 'path';
 import logger from './logger.js';
 import { Spinner, getTimestamp } from './utils.js';
 import { 
@@ -50,16 +50,19 @@ export class Installer {
       // Step 3: Copy core module
       await this.installCoreModule();
       
-      // Step 4: Copy ABM module
+      // Step 4: Copy ABM module (with language filter)
       await this.installAbmModule();
       
-      // Step 5: Create configuration files
+      // Step 5: Install optional teams
+      await this.installOptionalTeams();
+      
+      // Step 6: Create configuration files
       await this.createConfigFiles();
       
-      // Step 6: Create status file
+      // Step 7: Create status file
       await this.createStatusFile();
       
-      // Step 7: Configure IDEs
+      // Step 8: Configure IDEs
       await this.configureIDEs();
       
       // Show results
@@ -116,10 +119,23 @@ export class Installer {
       // Project directories
       `${PATHS.docsDir}/planning`,
       `${PATHS.docsDir}/odd`,
-      `${PATHS.srcDir}/netlogo`,
-      `${PATHS.srcDir}/python`,
-      `${PATHS.srcDir}/cpp`,
     ];
+
+    // Add source directories based on selected languages
+    const templateLanguages = this.config.templateLanguages || ['python'];
+    for (const lang of templateLanguages) {
+      directories.push(`${PATHS.srcDir}/${lang}`);
+    }
+
+    // Add directories for optional teams
+    if (this.config.includeBrainstorm) {
+      directories.push(`${PATHS.installDir}/brainstorm/agents`);
+      directories.push(`${PATHS.installDir}/brainstorm/workflows`);
+    }
+    if (this.config.includeDocumentation) {
+      directories.push(`${PATHS.installDir}/documentation/agents`);
+      directories.push(`${PATHS.installDir}/documentation/workflows`);
+    }
     
     const created = createDirectories(this.targetDir, directories);
     this.results.created.push(...created);
@@ -154,7 +170,7 @@ export class Installer {
   }
 
   /**
-   * Step 4: Install ABM module
+   * Step 4: Install ABM module with language filter
    */
   async installAbmModule() {
     this.spinner.start('Installing ABM module...');
@@ -167,9 +183,30 @@ export class Installer {
       return;
     }
     
-    // Copy ABM module files
+    // Get selected template languages
+    const templateLanguages = this.config.templateLanguages || ['python', 'netlogo', 'cpp'];
+    
+    // Copy ABM module files with template filtering
     const result = copyDir(abmPath, destAbmPath, {
-      filter: (path, name) => !name.startsWith('.'),
+      filter: (filePath, name) => {
+        // Skip hidden files
+        if (name.startsWith('.')) return false;
+        
+        // Filter templates by language
+        if (filePath.includes('/templates/models/')) {
+          const pathParts = filePath.split('/');
+          const modelsIndex = pathParts.indexOf('models');
+          if (modelsIndex !== -1 && modelsIndex + 1 < pathParts.length) {
+            const lang = pathParts[modelsIndex + 1];
+            // Always include if it's the models directory itself or a selected language
+            if (['python', 'netlogo', 'cpp'].includes(lang)) {
+              return templateLanguages.includes(lang);
+            }
+          }
+        }
+        
+        return true;
+      },
     });
     
     this.results.copied.push(...result.copied);
@@ -179,30 +216,105 @@ export class Installer {
   }
 
   /**
-   * Step 5: Create configuration files
+   * Step 5: Install optional team modules
+   */
+  async installOptionalTeams() {
+    // Install Brainstorming team if selected
+    if (this.config.includeBrainstorm) {
+      await this.installBrainstormModule();
+    }
+    
+    // Install Documentation team if selected
+    if (this.config.includeDocumentation) {
+      await this.installDocumentationModule();
+    }
+  }
+
+  /**
+   * Install Brainstorming team module
+   */
+  async installBrainstormModule() {
+    this.spinner.start('Installing Brainstorming team...');
+    
+    const brainstormPath = moduleManager.getModulePath('brainstorm');
+    const destPath = join(this.installDir, 'brainstorm');
+    
+    if (!existsSync(brainstormPath)) {
+      this.spinner.warn('Brainstorming module not found');
+      return;
+    }
+    
+    const result = copyDir(brainstormPath, destPath, {
+      filter: (path, name) => !name.startsWith('.'),
+    });
+    
+    this.results.copied.push(...result.copied);
+    this.results.errors.push(...result.errors);
+    
+    this.spinner.success(`Brainstorming team installed (${result.copied.length} files)`);
+  }
+
+  /**
+   * Install Documentation team module
+   */
+  async installDocumentationModule() {
+    this.spinner.start('Installing Documentation team...');
+    
+    const docPath = moduleManager.getModulePath('documentation');
+    const destPath = join(this.installDir, 'documentation');
+    
+    if (!existsSync(docPath)) {
+      this.spinner.warn('Documentation module not found');
+      return;
+    }
+    
+    const result = copyDir(docPath, destPath, {
+      filter: (path, name) => !name.startsWith('.'),
+    });
+    
+    this.results.copied.push(...result.copied);
+    this.results.errors.push(...result.errors);
+    
+    this.spinner.success(`Documentation team installed (${result.copied.length} files)`);
+  }
+
+  /**
+   * Step 6: Create configuration files
    */
   async createConfigFiles() {
     this.spinner.start('Creating configuration files...');
     
+    // Build modules list
+    const modules = ['core', 'abm'];
+    if (this.config.includeBrainstorm) modules.push('brainstorm');
+    if (this.config.includeDocumentation) modules.push('documentation');
+    
     // Create manifest.yaml
     const manifestPath = join(this.installDir, '_config', 'manifest.yaml');
     const manifest = {
       abm_ks: {
-        version: '0.1.0-alpha.1',
+        version: '0.1.0',
         installed_at: getTimestamp(),
-        modules: ['core', 'abm'],
+        modules: modules,
       },
       project: {
         name: this.config.projectName,
         domain: this.config.domain,
         platform: this.config.platform,
         track: this.config.track,
+        template_languages: this.config.templateLanguages || ['python'],
       },
       preferences: {
         experience: this.config.experience,
         generate_odd: this.config.generateODD,
         include_examples: this.config.includeExamples,
       },
+      teams: {
+        core: true,
+        abm: true,
+        brainstorm: this.config.includeBrainstorm || false,
+        documentation: this.config.includeDocumentation || false,
+      },
     };
     
     writeYamlFile(manifestPath, manifest, {
@@ -239,13 +351,26 @@ export class Installer {
   }
 
   /**
-   * Step 6: Create workflow status file
+   * Step 7: Create workflow status file
    */
   async createStatusFile() {
     this.spinner.start('Creating workflow status file...');
     
     const statusPath = join(this.targetDir, PATHS.statusFile);
     
+    // Build phases based on installed teams
+    const phases = {
+      phase_1: { status: 'pending', workflows: {} },
+      phase_2: { status: 'pending', workflows: {} },
+      phase_3: { status: 'pending', workflows: {} },
+      phase_4: { status: 'pending', workflows: {} },
+    };
+    
+    // Add phase 0 if brainstorming team is included
+    if (this.config.includeBrainstorm) {
+      phases.phase_0 = { status: 'pending', workflows: {} };
+    }
+    
     const status = {
       project: {
         name: this.config.projectName,
@@ -255,28 +380,11 @@ export class Installer {
         track: this.config.track,
       },
       current: {
-        phase: 1,
+        phase: this.config.includeBrainstorm ? 0 : 1,
         workflow: null,
         status: 'not_started',
       },
-      progress: {
-        phase_1: {
-          status: 'pending',
-          workflows: {},
-        },
-        phase_2: {
-          status: 'pending',
-          workflows: {},
-        },
-        phase_3: {
-          status: 'pending',
-          workflows: {},
-        },
-        phase_4: {
-          status: 'pending',
-          workflows: {},
-        },
-      },
+      progress: phases,
       history: [],
     };
     
@@ -289,7 +397,7 @@ export class Installer {
   }
 
   /**
-   * Step 7: Configure IDEs
+   * Step 8: Configure IDEs
    */
   async configureIDEs() {
     if (!this.config.ides || this.config.ides.length === 0) {
@@ -337,6 +445,17 @@ export class Installer {
     const rulesDir = join(this.targetDir, '.cursor', 'rules');
     ensureDir(rulesDir);
     
+    // Build agent paths based on installed teams
+    let agentPaths = `- \`_abm-ks/core/agents/\` - Core agents
+- \`_abm-ks/abm/agents/\` - ABM Development agents`;
+    
+    if (this.config.includeBrainstorm) {
+      agentPaths += `\n- \`_abm-ks/brainstorm/agents/\` - Brainstorming agents`;
+    }
+    if (this.config.includeDocumentation) {
+      agentPaths += `\n- \`_abm-ks/documentation/agents/\` - Documentation agents`;
+    }
+    
     const rulesContent = `# ABM-KS Agent Rules for Cursor
 # Generated by ABM-KS installer
 
@@ -348,12 +467,11 @@ This is an Agent-Based Model project using ABM-KS framework.
 
 ## Agent Activation
 To activate ABM-KS agents, read the agent files in:
-- \`_abm-ks/core/agents/\` - Core agents
-- \`_abm-ks/abm/agents/\` - Specialized agents
+${agentPaths}
 
 ## Workflow Commands
-- \`*workflow-init\` - Start/restart project initialization
-- \`*workflow-status\` - Check current progress
+- \`*init\` - Start/restart project initialization
+- \`*status\` - Check current progress
 - \`*help\` - Show available commands
 
 ## Status File
@@ -451,6 +569,17 @@ steps:
     }
     logger.outdent();
     
+    // Build teams list
+    let teamsInstalled = 'Core, ABM Development';
+    if (this.config.includeBrainstorm) teamsInstalled += ', Brainstorming';
+    if (this.config.includeDocumentation) teamsInstalled += ', Documentation';
+    
+    logger.newline();
+    logger.subheader('Installed Teams');
+    logger.indent();
+    logger.bullet(teamsInstalled);
+    logger.outdent();
+    
     logger.newline();
     logger.subheader('Project Structure');
     logger.tree(`${this.config.projectName}/`);
@@ -459,6 +588,8 @@ steps:
     logger.indent();
     logger.tree('core/agents/', false);
     logger.tree('abm/workflows/', false);
+    if (this.config.includeBrainstorm) logger.tree('brainstorm/', false);
+    if (this.config.includeDocumentation) logger.tree('documentation/', false);
     logger.tree('_config/', true);
     logger.outdent();
     logger.tree('docs/', false);
@@ -471,7 +602,7 @@ steps:
     logger.indent();
     logger.arrow('Open your AI IDE (Cursor, Claude Code, etc.)');
     logger.arrow('Activate the ABM Master agent');
-    logger.arrow('Run `*workflow-init` to start your project');
+    logger.arrow('Run `*init` to start your project');
     logger.outdent();
     
     logger.newline();