@duheso/zerocli 1.0.5 → 1.0.7

package/README.md

@@ -11,7 +11,7 @@ Use OpenAI-compatible APIs, Gemini, GitHub Models, Codex OAuth, Codex, Ollama, A
 [![License](https://img.shields.io/badge/license-MIT-2563eb)](LICENSE)
 
 
-[Quick Start](#quick-start) | [Setup Guides](#setup-guides) | [Providers](#supported-providers) | [Source Build](#source-build-and-local-development) | [VS Code Extension](#vs-code-extension) | [Community](#community)
+[Quick Start](#quick-start) | [Setup Guides](#setup-guides) | [Tribunal do Conselho](#️-tribunal-do-conselho--council-tribunal) | [Providers](#supported-providers) | [Source Build](#source-build-and-local-development) | [VS Code Extension](#vs-code-extension) | [Community](#community)
 
 ## Why Zero CLI
 
@@ -19,6 +19,7 @@ Use OpenAI-compatible APIs, Gemini, GitHub Models, Codex OAuth, Codex, Ollama, A
 - Save provider profiles inside the app with `/provider`
 - Run with OpenAI-compatible services, Gemini, GitHub Models, Codex OAuth, Codex, Ollama, Atomic Chat, and other supported providers
 - Keep coding-agent workflows in one place: bash, file tools, grep, glob, agents, tasks, MCP, and web tools
+- Invoke the **Tribunal do Conselho** to have 5 AI advisors debate any problem from radically different perspectives
 - Use the bundled VS Code extension for launch integration and theme support
 
 ## Quick Start
@@ -217,8 +218,110 @@ Advanced and source-build guides:
 - **Images**: URL and base64 image inputs for providers that support vision
 - **Provider profiles**: Guided setup plus saved `.zerocli-profile.json` support
 - **Local and remote model backends**: Cloud APIs, local servers, and Apple Silicon local inference
+- **Tribunal do Conselho**: Multi-agent deliberation with 5 AI advisors modeled on historical figures
+
+## ⚖️ Tribunal do Conselho — Council Tribunal
+
+The **Tribunal do Conselho** is a signature Zero CLI skill that convenes a panel of 5 AI advisors to debate any question, dilemma, or decision from radically different perspectives. Rather than getting a single AI opinion, you get a full deliberation — with agreements, disagreements, and a final synthesized verdict.
+
+This is invaluable for complex decisions, brainstorming, code architecture review, life choices, or any situation where a single perspective is not enough.
+
+### How to invoke
+
+```
+/council  Should I leave my job and start a company?
+/council  Review this architecture — microservices vs monolith for a 3-person team
+/council  I'm getting married in 6 months. How should I prepare financially?
+```
+
+Aliases also work: `/conselho` and `/tribunal`.
+
+Or just type naturally and the model will invoke it:
+
+```
+invoco o tribunal do conselho — quero largar meu emprego
+```
+
+### How it works
+
+```
+User prompt
+    │
+    ▼
+📨 Mensageiro (Messenger)
+    Analyzes complexity → generates 3-13 clarifying questions
+    │
+    ▼
+❓ AskUserQuestion (per question)
+    Collects all context from the user
+    │
+    ▼
+⚖️ TRIBUNAL DO CONSELHO — Round 1 / 2 / 3
+    5 advisors deliberate in parallel
+    React to each other, agree, disagree, debate
+    │
+    ▼
+🔍 Convergence check after Round 3
+    ├── Consensus reached → proceed to verdict
+    └── Still diverging → ⚠️ 2 extra rounds invoked
+                             "DIVERGÊNCIA NO CONSELHO — Rodadas extras invocadas!"
+    │
+    ▼
+📜 Síntese — Synthesizer consolidates the verdict
+    │
+    ▼
+✅ Final verdict delivered to the user
+```
+
+### The Classic Council (default pack)
+
+Five legendary figures with radically different worldviews ensure every angle of your problem is covered:
+
+| Advisor | Role | Focus |
+|---|---|---|
+| 🏛️ **Marco Aurélio** | O Estoico / Líder Consciente | Focus on what you can control, stay calm under pressure, act with ethics and reason |
+| 🗡️ **Maquiavel** | O Estrategista Realista | Pragmatic, cold analysis — human risks, power dynamics, and effective action without idealism |
+| ⚗️ **Marie Curie** | A Cientista Analítica | Demands data, facts, and experimentation — breaks problems logically before committing |
+| 🎨 **Leonardo da Vinci** | O Inovador Criativo | Lateral thinking, unexpected connections, completely original solutions |
+| 👑 **Catarina, a Grande** | A Executora de Longo Prazo | Evaluates long-term impact, master of ambitious plans executed with patience |
+
+### Council Packs
+
+Switch the deliberating panel by passing `pack:` in your prompt or using the tool parameter:
+
+| Pack | Members | Best for |
+|---|---|---|
+| `default` | Marco Aurélio, Maquiavel, Marie Curie, Da Vinci, Catarina | General decisions, life dilemmas, strategy |
+| `strategy` | Sun Tzu, Clausewitz, Bismarck, Napoleão, Genghis Khan | Competitive strategy, negotiations, conflict |
+| `creativity` | Tesla, Ada Lovelace, Frida Kahlo, Mozart, Steve Jobs | Innovation, creative blocks, product design |
+| `leadership` | Churchill, Mandela, Cleópatra, Lincoln, Ashoka | Leadership decisions, team challenges, governance |
+
+### Dynamic rounds
+
+The debate starts with **3 rounds** (minimum). After round 3, convergence is automatically detected:
+
+- **Consensus reached** → debate closes, verdict synthesized immediately
+- **Significant divergence** → a bold visual alert appears and 2 extra rounds are invoked:
+
+```
+⚠️  DIVERGÊNCIA NO CONSELHO — Rodadas extras invocadas!
+🔥  O Tribunal detectou divergências significativas. Invocando 2 rodadas extras finais...
+```
+
+### Dynamic clarification questions
+
+The Messenger automatically calibrates the number of clarifying questions (3–13) based on the detail level of your prompt:
+- **Vague / short prompt** → 8–13 questions to fill all gaps
+- **Moderate detail** → 5–7 focused questions
+- **Detailed prompt** → 3–5 targeted questions on remaining blind spots
+
+### Live progress streaming
+
+You see the debate unfold in real time as each round completes — no waiting until the end to see results. Each advisor's response streams as it finishes, round by round.
+
+---
+
 
-## Provider Notes
 
 Zero CLI supports multiple providers, but behavior is not identical across all of them.
 

package/chrome-extension/background.js

@@ -784,32 +784,45 @@ function pressKey(keyString) {
 }
 
 function scrollPage(direction, distance, coordinate) {
-  let target = document.body;
+  const scrollAmount = distance * 100;
 
+  // When a coordinate is given, try to scroll the element at that point.
+  // Fall back to the nearest scrollable ancestor if the element itself isn't scrollable.
   if (coordinate) {
     const [x, y] = coordinate;
-    const el = document.elementFromPoint(x, y);
-    if (el) target = el;
-  }
+    let el = document.elementFromPoint(x, y);
+
+    // Walk up the DOM to find the nearest scrollable ancestor
+    while (el && el !== document.documentElement) {
+      const style = window.getComputedStyle(el);
+      const overflow = style.overflow + style.overflowY + style.overflowX;
+      const isScrollable = /(auto|scroll)/.test(overflow);
+      if (isScrollable && (el.scrollHeight > el.clientHeight || el.scrollWidth > el.clientWidth)) {
+        break;
+      }
+      el = el.parentElement;
+    }
 
-  const scrollAmount = distance * 100;
+    if (el && el !== document.documentElement) {
+      switch (direction) {
+        case 'up':    el.scrollBy({ top: -scrollAmount, behavior: 'smooth' }); break;
+        case 'down':  el.scrollBy({ top:  scrollAmount, behavior: 'smooth' }); break;
+        case 'left':  el.scrollBy({ left: -scrollAmount, behavior: 'smooth' }); break;
+        case 'right': el.scrollBy({ left:  scrollAmount, behavior: 'smooth' }); break;
+      }
+      return { success: true, scrolled: direction, distance, target: 'element' };
+    }
+  }
 
+  // No coordinate (or no scrollable element found) → scroll the page via window
   switch (direction) {
-    case 'up':
-      target.scrollBy({ top: -scrollAmount, behavior: 'smooth' });
-      break;
-    case 'down':
-      target.scrollBy({ top: scrollAmount, behavior: 'smooth' });
-      break;
-    case 'left':
-      target.scrollBy({ left: -scrollAmount, behavior: 'smooth' });
-      break;
-    case 'right':
-      target.scrollBy({ left: scrollAmount, behavior: 'smooth' });
-      break;
+    case 'up':    window.scrollBy({ top: -scrollAmount, behavior: 'smooth' }); break;
+    case 'down':  window.scrollBy({ top:  scrollAmount, behavior: 'smooth' }); break;
+    case 'left':  window.scrollBy({ left: -scrollAmount, behavior: 'smooth' }); break;
+    case 'right': window.scrollBy({ left:  scrollAmount, behavior: 'smooth' }); break;
   }
 
-  return { success: true, scrolled: direction, distance };
+  return { success: true, scrolled: direction, distance, target: 'window' };
 }
 
 function performDrag(startCoordinate, endCoordinate) {