sinapse-ai 1.7.0 → 1.9.0

package/.claude/hooks/enforce-permission-mode.cjs

@@ -0,0 +1,249 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * Hook: Enforce Permission Mode — PreToolUse guard
+ *
+ * RULE: When the project is in "explore" (read-only) mode, Write and Edit
+ *       operations are BLOCKED. Read operations are always allowed.
+ *       Bash commands classified as write/delete/execute are also blocked.
+ *
+ * Protocol (Claude Code PreToolUse):
+ *   exit 0  → allow (operation proceeds)
+ *   exit 2  → block (message shown to model via stderr)
+ *
+ * Fail-open policy:
+ *   - If the permission config cannot be loaded, the hook allows (exit 0).
+ *   - If mode is "ask" or "auto", the hook allows (exit 0).
+ *   - Any unexpected error: exit 0.
+ *
+ * @module enforce-permission-mode
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// ---------------------------------------------------------------------------
+// Project root resolution
+// ---------------------------------------------------------------------------
+
+function projectRoot() {
+  return process.env.CLAUDE_PROJECT_DIR || process.cwd();
+}
+
+// ---------------------------------------------------------------------------
+// Lightweight mode loader (no yaml dependency — parses the simple key: value)
+// ---------------------------------------------------------------------------
+
+/**
+ * Parse `permissions.mode` from a minimal YAML config without requiring js-yaml.
+ * Handles:
+ *   permissions:
+ *     mode: explore
+ *
+ * Returns 'ask' (the safe default) if the file is missing, unreadable, or
+ * the key is absent.
+ *
+ * @param {string} configPath
+ * @returns {string} mode name
+ */
+function loadPermissionMode(configPath) {
+  try {
+    const content = fs.readFileSync(configPath, 'utf8');
+    // Match "mode: <value>" under a "permissions:" block
+    const match = content.match(/^\s*mode:\s*["']?(\w+)["']?\s*$/m);
+    if (match) {
+      return match[1].toLowerCase();
+    }
+  } catch {
+    // File missing or unreadable — fail-open
+  }
+  return 'ask';
+}
+
+// ---------------------------------------------------------------------------
+// Operation classifier (mirrors OperationGuard.classifyOperation)
+// ---------------------------------------------------------------------------
+
+const SAFE_COMMANDS = [
+  'git status', 'git log', 'git diff', 'git branch', 'git show',
+  'git ls-files', 'git remote -v',
+  'ls', 'pwd', 'cat', 'head', 'tail', 'wc', 'find', 'grep', 'which',
+  'file', 'stat',
+  'npm list', 'npm outdated', 'npm audit', 'npm view', 'npm search',
+  'yarn list', 'yarn info', 'bun pm ls',
+  'node --version', 'npm --version', 'yarn --version', 'bun --version',
+  'git --version', 'python --version', 'python3 --version',
+  'uname', 'whoami', 'hostname', 'date', 'uptime', 'df -h', 'free -h',
+  'env', 'printenv',
+  'curl -I', 'ping -c', 'nslookup', 'dig',
+  'ps aux', 'top -l 1', 'htop',
+  'gh auth status', 'gh repo view', 'gh pr list', 'gh pr view',
+  'gh issue list', 'gh issue view', 'gh api',
+];
+
+const DESTRUCTIVE_PATTERNS = [
+  /\brm\s+(-[rf]+\s+)?/,
+  /\brmdir\b/,
+  /\bunlink\b/,
+  /\bgit\s+reset\s+--hard\b/,
+  /\bgit\s+push\s+--force\b/,
+  /\bgit\s+push\s+-f\b/,
+  /\bgit\s+clean\s+-[fd]+/,
+  /\bgit\s+checkout\s+\.\s*$/,
+  /\bgit\s+restore\s+\.\s*$/,
+  /\bgit\s+stash\s+drop\b/,
+  /\bgit\s+branch\s+-[dD]\b/,
+  /\bDROP\s+(TABLE|DATABASE|INDEX|VIEW)\b/i,
+  /\bDELETE\s+FROM\b/i,
+  /\bTRUNCATE\b/i,
+  /\bALTER\s+TABLE\b.*\bDROP\b/i,
+  /\bkill\s+-9\b/,
+  /\bkillall\b/,
+  /\bshutdown\b/,
+  /\breboot\b/,
+  /\bnpm\s+uninstall\b/,
+  /\byarn\s+remove\b/,
+  /\bbun\s+remove\b/,
+];
+
+const WRITE_PATTERNS = [
+  /[^<]>/,
+  />>/,
+  /\bmkdir\b/,
+  /\btouch\b/,
+  /\bmv\b/,
+  /\bcp\b/,
+  /\bln\b/,
+  /\bchmod\b/,
+  /\bchown\b/,
+  /\bsed\s+-i\b/,
+  /\bawk\s+-i\b/,
+  /\bgit\s+add\b/,
+  /\bgit\s+commit\b/,
+  /\bgit\s+push\b/,
+  /\bgit\s+merge\b/,
+  /\bgit\s+rebase\b/,
+  /\bgit\s+cherry-pick\b/,
+  /\bgit\s+stash\b/,
+  /\bnpm\s+install\b/,
+  /\bnpm\s+i\b/,
+  /\bnpm\s+ci\b/,
+  /\byarn\s+add\b/,
+  /\byarn\s+install\b/,
+  /\bbun\s+install\b/,
+  /\bbun\s+add\b/,
+];
+
+/**
+ * Classify a Bash command as read/write/delete/execute.
+ * @param {string} command
+ * @returns {string}
+ */
+function classifyBashCommand(command) {
+  const normalized = command.trim().toLowerCase();
+  for (const safe of SAFE_COMMANDS) {
+    if (normalized.startsWith(safe.toLowerCase())) return 'read';
+  }
+  for (const pat of DESTRUCTIVE_PATTERNS) {
+    if (pat.test(command)) return 'delete';
+  }
+  for (const pat of WRITE_PATTERNS) {
+    if (pat.test(command)) return 'write';
+  }
+  return 'execute';
+}
+
+/**
+ * Classify a tool call into an operation type.
+ * @param {string} tool
+ * @param {Object} params
+ * @returns {string}
+ */
+function classifyOperation(tool, params) {
+  if (['Read', 'Glob', 'Grep', 'WebFetch', 'WebSearch'].includes(tool)) return 'read';
+  if (['Write', 'Edit', 'NotebookEdit'].includes(tool)) return 'write';
+  if (tool === 'Bash') return classifyBashCommand(params.command || '');
+  if (tool === 'Task') {
+    const readOnlyAgents = ['Explore', 'Plan', 'claude-code-guide'];
+    return readOnlyAgents.includes(params.subagent_type) ? 'read' : 'execute';
+  }
+  if (tool.startsWith('mcp__')) return 'execute';
+  return 'read'; // default to read (safe)
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+
+function main() {
+  // Parse stdin — fail-open on any parse error
+  let input;
+  try {
+    input = JSON.parse(fs.readFileSync(0, 'utf8'));
+  } catch {
+    process.exit(0);
+  }
+
+  const toolName = (input.tool_name || '').trim();
+  const toolInput = input.tool_input || {};
+
+  // Resolve project root
+  const root = projectRoot();
+  const configPath = path.join(root, '.sinapse', 'config.yaml');
+
+  // Load permission mode — fail-open if unresolvable
+  let mode;
+  try {
+    mode = loadPermissionMode(configPath);
+  } catch {
+    process.exit(0);
+  }
+
+  // Only enforce in explore mode. All other modes: allow.
+  if (mode !== 'explore') {
+    process.exit(0);
+  }
+
+  // Classify the operation
+  let operation;
+  try {
+    operation = classifyOperation(toolName, toolInput);
+  } catch {
+    process.exit(0); // fail-open
+  }
+
+  // In explore mode, only reads are allowed
+  if (operation === 'read') {
+    process.exit(0);
+  }
+
+  // Build context for the block message
+  let detail = '';
+  if (toolName === 'Bash' && toolInput.command) {
+    const cmd = toolInput.command;
+    detail = `\nCommand: ${cmd.length > 120 ? cmd.slice(0, 120) + '...' : cmd}`;
+  } else if (toolInput.file_path) {
+    detail = `\nFile: ${toolInput.file_path}`;
+  }
+
+  // BLOCK — exit 2
+  process.stderr.write(
+    `\nPERMISSION-MODE BLOCK [Explore / Read-Only]\n` +
+    `Tool: ${toolName}  Operation: ${operation}${detail}\n` +
+    `\n` +
+    `The project is in Explore (read-only) mode. Write, Edit, and destructive\n` +
+    `Bash commands are not allowed in this mode.\n` +
+    `\n` +
+    `To enable writes, change the permission mode:\n` +
+    `  *mode ask    — confirm before each change\n` +
+    `  *mode auto   — full autonomy (no prompts)\n` +
+    `\n` +
+    `Or update .sinapse/config.yaml:\n` +
+    `  permissions:\n` +
+    `    mode: ask\n`,
+  );
+  process.exit(2);
+}
+
+main();

package/.claude/hooks/mind-clone-governance.py

@@ -1,212 +1,212 @@
-#!/usr/bin/env python3
-"""
-Hook: Mind Clone Governance
-
-REGRA: Agents baseados em pessoas reais (mind clones) DEVEM passar pelo
-pipeline de extração de DNA antes de serem criados.
-
-Este hook intercepta Write/Edit em squads/*/agents/*.md e verifica:
-1. Se é um mind clone (baseado em pessoa real)
-2. Se existe DNA extraído correspondente
-
-NÃO BLOQUEIA:
-- Orchestrators (nome contém 'chief', 'orchestrator', 'chair')
-- Tool agents (nome contém 'validator', 'calculator', 'generator')
-- Process agents (nome contém 'architect', 'mapper', 'designer')
-- Edição de arquivo existente (apenas criação é bloqueada)
-
-Exit Codes:
-- 0: Permitido
-- 2: Bloqueado (mind clone sem DNA)
-"""
-
-import json
-import sys
-import os
-import re
-from pathlib import Path
-
-# =============================================================================
-# CONFIGURAÇÃO
-# =============================================================================
-
-# Padrões que indicam que NÃO é um mind clone (agents funcionais)
-FUNCTIONAL_AGENT_PATTERNS = [
-    # Orchestrators
-    r'.*-chief$',
-    r'.*-orchestrator$',
-    r'.*-chair$',
-    r'^orchestrator$',
-
-    # Tool agents
-    r'.*-validator$',
-    r'.*-calculator$',
-    r'.*-generator$',
-    r'.*-extractor$',
-    r'.*-analyzer$',
-
-    # Process agents
-    r'.*-architect$',
-    r'.*-mapper$',
-    r'.*-designer$',
-    r'.*-engineer$',
-
-    # Generic functional
-    r'^tools?-.*',
-    r'^process-.*',
-    r'^workflow-.*',
-]
-
-# Locais onde DNA pode estar
-DNA_LOCATIONS = [
-    "squads/{pack}/data/minds/{agent_id}_dna.yaml",
-    "squads/{pack}/data/minds/{agent_id}_dna.md",
-    "squads/{pack}/data/{agent_id}-dna.yaml",
-    "outputs/minds/{agent_id}/",
-]
-
-# =============================================================================
-# LÓGICA DO HOOK
-# =============================================================================
-
-def get_project_root():
-    """Obtém o root do projeto via variável de ambiente ou cwd."""
-    return os.environ.get("CLAUDE_PROJECT_DIR", os.getcwd())
-
-def extract_agent_info(file_path: str) -> tuple:
-    """Extrai pack_name e agent_id do path."""
-    # squads/{pack}/agents/{agent_id}.md
-    match = re.match(r'.*/squads/([^/]+)/agents/([^/]+)\.md$', file_path)
-    if match:
-        return match.group(1), match.group(2)
-    return None, None
-
-def is_functional_agent(agent_id: str) -> bool:
-    """Verifica se o agent é funcional (não é mind clone)."""
-    for pattern in FUNCTIONAL_AGENT_PATTERNS:
-        if re.match(pattern, agent_id, re.IGNORECASE):
-            return True
-    return False
-
-def has_dna_extracted(project_root: str, pack_name: str, agent_id: str) -> tuple:
-    """Verifica se existe DNA extraído para o agent."""
-    for location_template in DNA_LOCATIONS:
-        location = location_template.format(pack=pack_name, agent_id=agent_id)
-        full_path = os.path.join(project_root, location)
-
-        # Se é diretório, verificar se existe
-        if location.endswith('/'):
-            if os.path.isdir(full_path):
-                return True, full_path
-        # Se é arquivo, verificar se existe
-        elif os.path.isfile(full_path):
-            return True, full_path
-
-    return False, None
-
-def file_already_exists(file_path: str) -> bool:
-    """Verifica se o arquivo já existe (edit vs create)."""
-    return os.path.isfile(file_path)
-
-def main():
-    # Ler input do stdin
-    try:
-        input_data = json.load(sys.stdin)
-    except json.JSONDecodeError:
-        # Se não conseguir parsear, permitir (fail-open)
-        sys.exit(0)
-
-    tool_name = input_data.get("tool_name", "")
-    tool_input = input_data.get("tool_input", {})
-
-    # Só processar Write e Edit
-    if tool_name not in ["Write", "Edit"]:
-        sys.exit(0)
-
-    file_path = tool_input.get("file_path", "")
-    if not file_path:
-        sys.exit(0)
-
-    # Só processar arquivos em squads/*/agents/
-    if "/squads/" not in file_path or "/agents/" not in file_path:
-        sys.exit(0)
-
-    if not file_path.endswith(".md"):
-        sys.exit(0)
-
-    project_root = get_project_root()
-
-    # Extrair informações do path
-    pack_name, agent_id = extract_agent_info(file_path)
-    if not pack_name or not agent_id:
-        sys.exit(0)
-
-    # Se é agent funcional (não mind clone), permitir
-    if is_functional_agent(agent_id):
-        sys.exit(0)
-
-    # Block 3b — fail-closed para edição de arquivo existente:
-    # se o arquivo NÃO carrega o marker BEGIN PERSONA NOTICE, bloqueia.
-    # (Antes era fail-open em arquivos existentes — todos os 22 personas
-    # foram grandfathered em 2025 sem disclaimer. Decisão 1c do clinical
-    # audit dim-7 exige disclaimer obrigatório agora.)
-    if file_already_exists(file_path):
-        try:
-            with open(file_path, "r", encoding="utf-8") as fh:
-                existing = fh.read()
-            if "<!-- BEGIN PERSONA NOTICE" in existing:
-                sys.exit(0)
-            # Edição de mind clone existente sem o disclaimer.
-            print(
-                f"\nMIND CLONE GOVERNANCE: arquivo {agent_id}.md é uma persona simulada "
-                "mas não carrega o marker '<!-- BEGIN PERSONA NOTICE -->'. "
-                "Rode 'node scripts/apply-persona-disclaimer.js' antes de editar.",
-                file=sys.stderr,
-            )
-            sys.exit(2)
-        except Exception:
-            # Fail-open em erros de leitura — preserva princípio "hook não derruba dev".
-            sys.exit(0)
-
-    # Verificar se existe DNA extraído
-    has_dna, dna_path = has_dna_extracted(project_root, pack_name, agent_id)
-
-    if has_dna:
-        sys.exit(0)
-
-    # BLOQUEAR: Tentando criar mind clone sem DNA
-    error_message = f"""
-╔══════════════════════════════════════════════════════════════════════════════╗
-║  🧬 MIND CLONE GOVERNANCE: DNA não encontrado                                 ║
-╠══════════════════════════════════════════════════════════════════════════════╣
-║                                                                              ║
-║  Agent: {agent_id:<60} ║
-║  Pack:  {pack_name:<60} ║
-║                                                                              ║
-║  PROBLEMA: Este parece ser um MIND CLONE (baseado em pessoa real),           ║
-║            mas não foi encontrado DNA extraído.                              ║
-║                                                                              ║
-║  Mind clones DEVEM passar pelo pipeline de extração:                         ║
-║  1. *collect-sources  → Coletar fontes (livros, entrevistas, artigos)        ║
-║  2. *extract-voice-dna → Extrair padrões linguísticos                        ║
-║  3. *extract-thinking-dna → Extrair frameworks e heurísticas                 ║
-║  4. *create-agent → Criar agent a partir do DNA                              ║
-║                                                                              ║
-║  LOCAIS VERIFICADOS:                                                         ║
-║  • squads/{pack_name}/data/minds/{agent_id}_dna.yaml
-║  • squads/{pack_name}/data/minds/{agent_id}_dna.md
-║  • outputs/minds/{agent_id}/
-║                                                                              ║
-║  SOLUÇÕES:                                                                   ║
-║  1. Execute o pipeline de clone: /squad-creator → *collect-sources           ║
-║  2. OU se é agent FUNCIONAL, renomeie com sufixo:                            ║
-║     -chief, -orchestrator, -validator, -architect, etc.                      ║
-║                                                                              ║
-╚══════════════════════════════════════════════════════════════════════════════╝
-"""
-    print(error_message, file=sys.stderr)
-    sys.exit(2)
-
-if __name__ == "__main__":
-    main()
-
+#!/usr/bin/env python3
+"""
+Hook: Mind Clone Governance
+
+REGRA: Agents baseados em pessoas reais (mind clones) DEVEM passar pelo
+pipeline de extração de DNA antes de serem criados.
+
+Este hook intercepta Write/Edit em squads/*/agents/*.md e verifica:
+1. Se é um mind clone (baseado em pessoa real)
+2. Se existe DNA extraído correspondente
+
+NÃO BLOQUEIA:
+- Orchestrators (nome contém 'chief', 'orchestrator', 'chair')
+- Tool agents (nome contém 'validator', 'calculator', 'generator')
+- Process agents (nome contém 'architect', 'mapper', 'designer')
+- Edição de arquivo existente (apenas criação é bloqueada)
+
+Exit Codes:
+- 0: Permitido
+- 2: Bloqueado (mind clone sem DNA)
+"""
+
+import json
+import sys
+import os
+import re
+from pathlib import Path
+
+# =============================================================================
+# CONFIGURAÇÃO
+# =============================================================================
+
+# Padrões que indicam que NÃO é um mind clone (agents funcionais)
+FUNCTIONAL_AGENT_PATTERNS = [
+    # Orchestrators
+    r'.*-chief$',
+    r'.*-orchestrator$',
+    r'.*-chair$',
+    r'^orchestrator$',
+
+    # Tool agents
+    r'.*-validator$',
+    r'.*-calculator$',
+    r'.*-generator$',
+    r'.*-extractor$',
+    r'.*-analyzer$',
+
+    # Process agents
+    r'.*-architect$',
+    r'.*-mapper$',
+    r'.*-designer$',
+    r'.*-engineer$',
+
+    # Generic functional
+    r'^tools?-.*',
+    r'^process-.*',
+    r'^workflow-.*',
+]
+
+# Locais onde DNA pode estar
+DNA_LOCATIONS = [
+    "squads/{pack}/data/minds/{agent_id}_dna.yaml",
+    "squads/{pack}/data/minds/{agent_id}_dna.md",
+    "squads/{pack}/data/{agent_id}-dna.yaml",
+    "outputs/minds/{agent_id}/",
+]
+
+# =============================================================================
+# LÓGICA DO HOOK
+# =============================================================================
+
+def get_project_root():
+    """Obtém o root do projeto via variável de ambiente ou cwd."""
+    return os.environ.get("CLAUDE_PROJECT_DIR", os.getcwd())
+
+def extract_agent_info(file_path: str) -> tuple:
+    """Extrai pack_name e agent_id do path."""
+    # squads/{pack}/agents/{agent_id}.md
+    match = re.match(r'.*/squads/([^/]+)/agents/([^/]+)\.md$', file_path)
+    if match:
+        return match.group(1), match.group(2)
+    return None, None
+
+def is_functional_agent(agent_id: str) -> bool:
+    """Verifica se o agent é funcional (não é mind clone)."""
+    for pattern in FUNCTIONAL_AGENT_PATTERNS:
+        if re.match(pattern, agent_id, re.IGNORECASE):
+            return True
+    return False
+
+def has_dna_extracted(project_root: str, pack_name: str, agent_id: str) -> tuple:
+    """Verifica se existe DNA extraído para o agent."""
+    for location_template in DNA_LOCATIONS:
+        location = location_template.format(pack=pack_name, agent_id=agent_id)
+        full_path = os.path.join(project_root, location)
+
+        # Se é diretório, verificar se existe
+        if location.endswith('/'):
+            if os.path.isdir(full_path):
+                return True, full_path
+        # Se é arquivo, verificar se existe
+        elif os.path.isfile(full_path):
+            return True, full_path
+
+    return False, None
+
+def file_already_exists(file_path: str) -> bool:
+    """Verifica se o arquivo já existe (edit vs create)."""
+    return os.path.isfile(file_path)
+
+def main():
+    # Ler input do stdin
+    try:
+        input_data = json.load(sys.stdin)
+    except json.JSONDecodeError:
+        # Se não conseguir parsear, permitir (fail-open)
+        sys.exit(0)
+
+    tool_name = input_data.get("tool_name", "")
+    tool_input = input_data.get("tool_input", {})
+
+    # Só processar Write e Edit
+    if tool_name not in ["Write", "Edit"]:
+        sys.exit(0)
+
+    file_path = tool_input.get("file_path", "")
+    if not file_path:
+        sys.exit(0)
+
+    # Só processar arquivos em squads/*/agents/
+    if "/squads/" not in file_path or "/agents/" not in file_path:
+        sys.exit(0)
+
+    if not file_path.endswith(".md"):
+        sys.exit(0)
+
+    project_root = get_project_root()
+
+    # Extrair informações do path
+    pack_name, agent_id = extract_agent_info(file_path)
+    if not pack_name or not agent_id:
+        sys.exit(0)
+
+    # Se é agent funcional (não mind clone), permitir
+    if is_functional_agent(agent_id):
+        sys.exit(0)
+
+    # Block 3b — fail-closed para edição de arquivo existente:
+    # se o arquivo NÃO carrega o marker BEGIN PERSONA NOTICE, bloqueia.
+    # (Antes era fail-open em arquivos existentes — todos os 22 personas
+    # foram grandfathered em 2025 sem disclaimer. Decisão 1c do clinical
+    # audit dim-7 exige disclaimer obrigatório agora.)
+    if file_already_exists(file_path):
+        try:
+            with open(file_path, "r", encoding="utf-8") as fh:
+                existing = fh.read()
+            if "<!-- BEGIN PERSONA NOTICE" in existing:
+                sys.exit(0)
+            # Edição de mind clone existente sem o disclaimer.
+            print(
+                f"\nMIND CLONE GOVERNANCE: arquivo {agent_id}.md é uma persona simulada "
+                "mas não carrega o marker '<!-- BEGIN PERSONA NOTICE -->'. "
+                "Rode 'node scripts/apply-persona-disclaimer.js' antes de editar.",
+                file=sys.stderr,
+            )
+            sys.exit(2)
+        except Exception:
+            # Fail-open em erros de leitura — preserva princípio "hook não derruba dev".
+            sys.exit(0)
+
+    # Verificar se existe DNA extraído
+    has_dna, dna_path = has_dna_extracted(project_root, pack_name, agent_id)
+
+    if has_dna:
+        sys.exit(0)
+
+    # BLOQUEAR: Tentando criar mind clone sem DNA
+    error_message = f"""
+╔══════════════════════════════════════════════════════════════════════════════╗
+║  🧬 MIND CLONE GOVERNANCE: DNA não encontrado                                 ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║                                                                              ║
+║  Agent: {agent_id:<60} ║
+║  Pack:  {pack_name:<60} ║
+║                                                                              ║
+║  PROBLEMA: Este parece ser um MIND CLONE (baseado em pessoa real),           ║
+║            mas não foi encontrado DNA extraído.                              ║
+║                                                                              ║
+║  Mind clones DEVEM passar pelo pipeline de extração:                         ║
+║  1. *collect-sources  → Coletar fontes (livros, entrevistas, artigos)        ║
+║  2. *extract-voice-dna → Extrair padrões linguísticos                        ║
+║  3. *extract-thinking-dna → Extrair frameworks e heurísticas                 ║
+║  4. *create-agent → Criar agent a partir do DNA                              ║
+║                                                                              ║
+║  LOCAIS VERIFICADOS:                                                         ║
+║  • squads/{pack_name}/data/minds/{agent_id}_dna.yaml
+║  • squads/{pack_name}/data/minds/{agent_id}_dna.md
+║  • outputs/minds/{agent_id}/
+║                                                                              ║
+║  SOLUÇÕES:                                                                   ║
+║  1. Execute o pipeline de clone: /squad-creator → *collect-sources           ║
+║  2. OU se é agent FUNCIONAL, renomeie com sufixo:                            ║
+║     -chief, -orchestrator, -validator, -architect, etc.                      ║
+║                                                                              ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+"""
+    print(error_message, file=sys.stderr)
+    sys.exit(2)
+
+if __name__ == "__main__":
+    main()
+