hablas 2.0.5

package/CHANGELOG.md

@@ -0,0 +1,108 @@
+# Changelog
+
+All notable changes to **Hablas CLI** will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [1.0.0] — 2026-05-31 · **First Public Release**
+
+The first formal, polished, production-ready release of Hablas CLI. Months of
+internal iteration consolidated into a focused, type-strict, dead-code-free
+multi-agent system that runs locally or against any OpenAI-compatible API.
+
+### ✨ Highlights
+- **Live Team Theatre** — watch the multi-agent team (Hablas → Emma → Bob →
+  Alex → David) collaborate in real time, in character, with bounded
+  in-character dialogue between agents.
+- **Single-leader UX** — you only talk to Hablas. He delegates, reviews,
+  synthesizes, and replies in his own INTJ voice.
+- **Strict separation of concerns** — `AgentChannel` (event bus),
+  `TheatreRenderer` (UI), `TeamConductor` (orchestration logic),
+  `InterAgentChat` (dialogue generation) are fully decoupled.
+
+### Added
+- **Live Team Theatre subsystem** (5 new modules, ~1,000 LOC):
+  - `agents/agent-channel.ts` — typed event bus, single source of truth.
+  - `agents/inter-agent-chat.ts` — bounded in-character dialogue generator
+    with token budget, cache, and deterministic fallback.
+  - `agents/team-conductor.ts` — drives delegate → handoff → execute →
+    peer-review → synthesize on the AgentChannel.
+  - `repl/theatre.ts` — executive-silver TUI subscriber.
+  - `agents/__tests__/agent-channel.test.ts` — 11 unit tests.
+- **T-shirt sizing** (XS/S/M/L/XL) for complexity-aware routing.
+- **Plan approval flow** with `approve / edit / skip` for L and XL tasks.
+- **`/team`, `/agents`, `/agents models`, `/delegate`** slash commands.
+- **Multi-provider support** — Ollama, NVIDIA NIM, OpenAI-compatible APIs.
+- **Tool Parser V2** — model-aware learning across 6+ tool-call formats.
+- **ReAct engine** with `<thinking>` block parsing and step budget warnings.
+- **Error Recovery engine** — classifies tool failures and injects
+  recovery strategies into the next prompt.
+- **Smart abort** — only critical tool failures stop the chain.
+- **Ctrl+C** — single press cancels the current op, double press exits cleanly.
+- **Checkpoint & Undo Stack** — `/checkpoint save|list|restore`, `/undo [all|list|N]`.
+- **Project memory** — categorized, importance-weighted, decay-based, agent-lanes.
+- **Auto-inject** — files mentioned in user input are auto-loaded into the session.
+- **Setup wizard** on first run.
+- **Team mode** (`--team`) — Supabase + Git-based file locks and presence.
+- **`hablas commit | pr | changelog | security | stats | info`** sub-commands.
+
+### Changed
+- **`package.json` version** bumped from internal `2.0.0` to public `1.0.0`.
+- **README** updated for the v1.0.0 release.
+- **`tsconfig.json`** hardened: enabled `noUnusedLocals`,
+  `noUnusedParameters`, `noImplicitOverride`,
+  `noFallthroughCasesInSwitch`.
+
+### Removed (cleanup)
+- **37 dead-code files** (~6,000 LOC) — abandoned v1/v2/v3 variants,
+  unfinished subsystems, type shims for unused dependencies. Concretely:
+  - `agents/{research-agent, self-evaluator, smart-retry, sub-agents}.ts`
+  - `context/{codebase-index, context-manager-v3, simple-vector-store,
+    sqlite-memory, summarizer}.ts` and `context/v3/*`
+  - `kernel/{hooks, permissions, runtime}.ts`
+  - `llm/{models, thinking-engine}.ts`
+  - `mcp/{client, server}.ts`
+  - `planner/{classifier, executor, smart-planner-v2}.ts`
+  - `tools/{compact, glob, multi-edit, project-intelligence, registry-v3,
+    todo-manager, web-search, v2/web, v2/background}.ts`
+  - `repl/todo-renderer.ts`
+  - `templates/template-manager.ts`
+  - `types/{web-deps, xenova-transformers}.d.ts`
+- **~95 unused imports** across live files, removed via static analysis.
+- **Legacy `setOutputCallback` printer** in `loop.ts` — superseded by the
+  Theatre pipeline.
+- **Hardcoded `2.0.0` strings** — now bind dynamically to `package.json`.
+
+### Fixed
+- `api/server.ts` health endpoint returns the real version from `package.json`.
+- `team-conductor.ts` no longer holds an unused `config` field.
+- `loop.ts` `BACKUP_DIR` and unused `fsPromises` removed.
+- All `tsc --noUnusedLocals --noUnusedParameters` warnings cleared.
+
+### Hard Guarantees
+- ✅ `npm run build` (strict TS) passes with **zero** errors.
+- ✅ `npm test` passes (11/11 channel tests).
+- ✅ `npm install` succeeds with the declared dependencies (no phantom imports).
+- ✅ Hablas is the sole speaker to the user — no agent surprises.
+- ✅ Token budget capped per turn; silent fallback when LLM is offline.
+- ✅ Web app, Supabase schema, and `@Consul` collaboration code untouched.
+
+### Engineering Stats
+| Metric | Before | After |
+|---|---|---|
+| TypeScript files | 111 | **74** |
+| Total LOC | 27,143 | **~21,000** |
+| Dead-code files | 37 | **0** |
+| Unused imports/declarations | 103 | **0** |
+| `--noUnusedLocals` clean | ❌ | ✅ |
+| `--noUnusedParameters` clean | ❌ | ✅ |
+| `@ts-ignore` count | 0 | **0** |
+| Unit tests | 0 | **11** |
+
+---
+
+> The full audit that drove this release is preserved in
+> [`AUDIT_v1.0.0.md`](./AUDIT_v1.0.0.md).

package/CREDITS.md

@@ -0,0 +1,33 @@
+# Credits
+
+## Developer
+
+**Abdulmoin Hablas** — Full-Stack Developer
+
+### Connect
+
+| Platform | Link |
+|----------|------|
+| Portfolio | [portfolio-monopoly63s-projects.vercel.app](https://portfolio-monopoly63s-projects.vercel.app/) |
+| GitHub | [github.com/Monopoly63](https://github.com/Monopoly63?tab=repositories) |
+| Telegram | [@Hablas_Trade](https://t.me/Hablas_Trade) |
+| WhatsApp | [+1 323 212 8875](https://wa.me/13232128875) |
+| Instagram | [@li0vy_](https://www.instagram.com/li0vy_) |
+
+### Other Projects
+
+| Project | Link |
+|---------|------|
+| AI Search Engine | [ai-search-engine-ashy.vercel.app](https://ai-search-engine-ashy.vercel.app/) |
+| Trade Tracker | [trade-tracker-monopoly63s-projects.vercel.app](https://trade-tracker-monopoly63s-projects.vercel.app/) |
+| Tree Algorithms Lab | [tree-algorithms-lab.vercel.app](https://tree-algorithms-lab.vercel.app/) |
+
+---
+
+## Built With
+
+- TypeScript · Node.js 20+ · Ollama · Commander.js · Pino
+
+## License
+
+MIT

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Abdulmoin Hablas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,317 @@
+<div align="center">
+
+# ◆ Hablas CLI
+
+**Premium multi-agent AI coding agent for your terminal**
+
+Local-first · Cloud-compatible · Watch the team work in front of you
+
+*by [Abdulmoin Hablas](https://portfolio-monopoly63s-projects.vercel.app/)*
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Version](https://img.shields.io/badge/version-1.0.0-gold.svg)](CHANGELOG.md)
+[![Node.js](https://img.shields.io/badge/Node.js-20%2B-green.svg)](https://nodejs.org)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.5-blue.svg)](https://www.typescriptlang.org)
+
+</div>
+
+---
+
+## ✦ Overview
+
+**Hablas** is a multi-agent AI development system that runs in your terminal.
+Unlike single-model assistants, Hablas leads a **team of specialists** —
+Emma (Product), Bob (Architect), Alex (Engineer), David (Analyst) — and
+**you watch them collaborate live**, in character, while Hablas (the Team
+Leader) remains your single point of contact.
+
+It runs **locally via Ollama**, or against **any OpenAI-compatible API**
+(NVIDIA NIM, OpenAI, Groq, Together, OpenRouter, and more).
+
+### ✨ What makes v1.0.0 different
+
+- **Live Team Theatre** — see the team handoff tasks, think, run tools,
+  and review each other's work in real time, with an executive-silver TUI.
+- **Hablas-only conversation** — you talk to one leader; the rest is theatre.
+- **Persona-faithful** — each agent stays in their distinctive voice
+  (Hablas is INTJ-direct, Bob is methodical, Alex is pragmatic, …).
+- **Token-bounded dialogue** — the inter-agent chat is capped and
+  gracefully falls back to deterministic lines when offline.
+
+### Key Features
+
+- **Multi-Agent System** — 5 specialized agents with their own mindsets
+  and (optionally) their own models per role.
+- **T-shirt Sizing** — XS/S/M/L/XL routing so a "hi" doesn't trigger a plan.
+- **Plan Approval** — for L/XL tasks, you approve / edit / skip before exec.
+- **Dual Provider** — Ollama (local), NVIDIA NIM, or any
+  OpenAI-compatible API. Switch live with `/provider`.
+- **Dynamic Model Discovery** — `/models` lists everything your API exposes.
+- **Agentic Loop** — multi-step tool execution with auto-retry,
+  smart abort, and recovery hints.
+- **15+ Built-in Tools** — file ops, shell, codebase search, web search,
+  web scraping, PDF reading, code execution, bug detection, and more.
+- **Smart Context** — project-aware prompts, memory with categories and
+  importance decay, shared notebook, auto-injection of mentioned files.
+- **Premium TUI** — executive-silver theme, spinners, progress, plan
+  boxes, session summaries.
+- **Three-tier safety** — `safe / confirm / dangerous` per tool.
+- **Ctrl+C UX** — single = cancel current op, double = exit cleanly.
+- **Auto Mode** — `--auto` skips tool confirmations for scripting
+  (plan approval still required).
+- **Checkpoints & Undo** — `/checkpoint save|restore`, `/undo`.
+- **Team Mode** — optional Supabase + Git-based locks and presence sync.
+
+---
+
+## ✦ Installation
+
+```bash
+git clone https://github.com/Monopoly63/mobile-bot.git
+cd mobile-bot/flowagent
+npm install
+npm run build
+npm link        # exposes the `hablas` command globally
+```
+
+### Requirements
+
+- **Node.js 20+**
+- One of:
+  - **Ollama** running locally (`ollama serve`)
+  - An **OpenAI-compatible API** key
+  - **NVIDIA NIM** API key
+
+First run launches a setup wizard. You can re-run it anytime with `hablas --setup`.
+
+---
+
+## ✦ Quick Start
+
+```bash
+# Interactive REPL
+hablas
+
+# One-shot command
+hablas run "refactor src/auth.ts to use bcrypt"
+
+# Generate a commit message from staged changes
+hablas commit
+
+# Project info
+hablas info
+
+# Diagnostics
+hablas doctor
+```
+
+---
+
+## ✦ Commands Reference
+
+### Core Slash Commands
+
+| Command | Description |
+|---|---|
+| `/help` | List all commands |
+| `/about` · `/version` | Identity & version info |
+| `/team` · `/agents` | Team roster · multi-agent system status |
+| `/agents on\|off\|status\|models` | Toggle and inspect agents |
+| `/delegate <agent> <task>` | Manually assign a task to one agent |
+| `/mindset <name>` · `/mindsets` | Switch / list agent mindsets |
+| `/clear` · `/history [n]` | Reset context · show recent turns |
+| `/status` · `/quit` | Show status · exit |
+
+### Model & Provider
+
+| Command | Description |
+|---|---|
+| `/model [name]` | Show or switch the active model |
+| `/models [page\|query]` | Browse available models (paged + search) |
+| `/provider [ollama\|nvidia\|custom\|test]` | Switch / test the provider |
+| `/addmodel` · `/listmodels` · `/usemodel <name>` · `/removemodel <name>` | Manage saved provider profiles |
+
+### Project Tools
+
+| Command | Description |
+|---|---|
+| `/security` | Run the project security scan |
+| `/git status` | Show Git status |
+| `/workspace` | Show framework/language/CI detection |
+| `/stats` · `/cost` | Usage analytics |
+| `/test [--fix]` | Detect & run tests, optionally let the agent fix them |
+| `/checkpoint save\|list\|restore\|delete` | Snapshot & restore project state |
+| `/undo [N\|all\|list]` | Revert recent agent changes |
+| `/compare <a> <b>` · `/compare HEAD~1` | Side-by-side diff |
+
+### Memory & Context
+
+| Command | Description |
+|---|---|
+| `/memory [set\|del\|search\|clear]` | Persistent project memory |
+| `/learn "<preference>"` | Teach the agent a preference (importance: 9) |
+| `/context [set\|get\|del\|decisions\|clear]` | Cross-agent shared notebook |
+| `/plan status\|finish\|next\|reset` | Inspect the active plan |
+
+### Plugins & Diagnostics
+
+| Command | Description |
+|---|---|
+| `/plugins [enable\|disable]` | Manage plugins (~/.hablas/plugins/) |
+| `/alias [set\|del]` | Custom command aliases |
+| `/doctor` | System diagnostics |
+| `/session save\|list` | Save/load conversation state |
+
+---
+
+## ✦ CLI Flags & Sub-commands
+
+| Flag / Sub-command | Description |
+|---|---|
+| `-m, --model <name>` | Set the active model |
+| `-p, --project <path>` | Set the working directory |
+| `--provider <ollama\|custom\|nvidia>` | Choose LLM provider |
+| `--api-url <url>` · `--api-key <key>` | Configure custom/NVIDIA provider |
+| `--auto` | Skip tool confirmations (plan approval still required) |
+| `--timeout <ms>` | Per-request timeout (default 120000) |
+| `--theme <dark\|light\|galaxy\|ocean\|forest>` | UI theme |
+| `--team --user <name> --team-key <pwd>` | Enable Team Mode |
+| `--setup` | Run the first-time wizard |
+| `hablas run "<prompt>"` | Non-interactive single shot |
+| `hablas commit` · `pr` · `changelog` | Git intelligence sub-commands |
+| `hablas info` · `doctor` · `security` · `stats` | Project insights |
+| `hablas api --port 8080` | Start the REST API server |
+
+---
+
+## ✦ Built-in Tools
+
+| Tool | Purpose | Safety |
+|---|---|---|
+| `read_file`, `list_dir`, `get_file_info` | Read filesystem | safe |
+| `write_file`, `edit_file`, `patch_file`, `append_to_file`, `search_and_replace` | Mutate files | confirm |
+| `delete_file`, `move_file`, `create_dir` | Manage paths | dangerous / confirm |
+| `run_command` | Shell execution (with timeout + blocklist) | dangerous |
+| `search_codebase` | Ripgrep-style search | safe |
+| `detect_bugs` | Static analysis | safe |
+| `web_search` | DuckDuckGo search | safe |
+| `scrape_url`, `extract_links` | HTML scraping | safe |
+| `read_pdf`, `pdf_metadata` | PDF reading | safe |
+| `execute_code` | Sandboxed code execution | confirm |
+
+---
+
+## ✦ Configuration
+
+Config lives at **`~/.hablas/config.json`**. Sub-files:
+
+| File | Purpose |
+|---|---|
+| `~/.hablas/config.json` | Main config (model, provider, theme, flags) |
+| `~/.hablas/agent-models.json` | Per-agent model overrides |
+| `~/.hablas/models.json` | Saved provider profiles (`/addmodel`) |
+| `~/.hablas/aliases.json` | Custom slash-command aliases |
+| `~/.hablas/memory/<hash>.json` | Per-project memory store |
+| `~/.hablas/plugins/` | Installed plugins |
+| `~/.hablas/logs/` | Structured pino logs |
+
+---
+
+## ✦ The Multi-Agent Team
+
+| Agent | Title | Role | Voice |
+|---|---|---|---|
+| **★ Hablas** | Team Leader | Coordination, planning, synthesis, the only one you talk to | INTJ, authoritative, terse |
+| **◆ Emma** | Product Manager | Requirements, PRDs, user stories | Calm, structured |
+| **◆ Bob** | Architect | System design, schemas, contracts, peer-reviews Alex | Methodical, principled |
+| **◆ Alex** | Engineer | Implementation, debugging, tests | Pragmatic, action-biased |
+| **◆ David** | Data Analyst | Research, documentation, comparisons | Factual, evidence-driven |
+
+Routing is automatic and complexity-aware (T-shirt sizing):
+
+| Size | Trigger | Behavior |
+|---|---|---|
+| **XS** | Greetings, casual chat | Hablas replies directly, no tools |
+| **S** | Single clear question | Single agent, no plan |
+| **M** | Single focused task | Live theatre, one specialist + Hablas synthesis |
+| **L** | Multi-step, multi-concern | Plan → approval → live theatre with peer review |
+| **XL** | Full system / feature | XL plan (Emma writes PRD first) → approval → full theatre |
+
+---
+
+## ✦ Examples
+
+```bash
+# Read, then edit
+> read src/auth.ts and add JWT validation
+
+# Multi-step (triggers L flow)
+> design and implement a /users endpoint with tests
+
+# Specific agent
+> /delegate bob design the cache layer for the search API
+
+# Git workflow
+> hablas commit
+> hablas pr --base main
+> hablas changelog --version 1.1.0
+
+# Memory
+> /learn always use tabs and 2-space indent for YAML
+> /memory search auth
+```
+
+---
+
+## ✦ Architecture
+
+```
+src/
+├── repl/          REPL loop, slash commands, TUI, live theatre
+├── agents/        Orchestrator, conductor, runner, channel, dialogue
+├── planner/       T-shirt sizing, plan lifecycle, task queue
+├── llm/           Unified provider (Ollama/Custom/NVIDIA), tool parser v2
+├── mindset/       Per-agent system prompts
+├── tools/         Tool registry + 15 built-in tools
+├── context/       Session, memory, shared notebook, auto-inject
+├── config/        Defaults + JSON loader
+├── collaboration/ Optional Team Mode (Supabase + Git locks)
+├── plugins/       Plugin loader + diagnostics
+├── security/      /security scanner
+├── analytics/     Usage stats
+├── git/           /commit /pr /changelog intelligence
+├── workspace/     Framework / language / CI detection
+└── utils/         logger, diff, tokens
+```
+
+74 TypeScript files, ~21,000 LOC, `strict` mode, zero `@ts-ignore`,
+zero unused locals/parameters.
+
+---
+
+## ✦ Development
+
+```bash
+npm install        # install deps
+npm run build      # tsc → dist/
+npm run lint       # tsc --noEmit
+npm test           # run the channel unit tests
+npm run dev -- run "your prompt"  # dev mode without build
+```
+
+---
+
+## ✦ Author
+
+**Abdulmoin Hablas** — [Portfolio](https://portfolio-monopoly63s-projects.vercel.app/)
+
+### Other Projects
+
+- **mobile-bot** — the web companion + landing pages
+- **Hablas Web Chat** — ChatGPT-style chat on the web
+
+---
+
+## ✦ License
+
+[MIT](LICENSE) © 2024-2026 Abdulmoin Hablas

package/bin/hablas-shim.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const pkg = require('../package.json');
+const VERSION = pkg.version;
+
+const PLATFORM_MAP = {
+  win32: { x64: 'hablas-win-x64.exe' },
+  linux: { x64: 'hablas-linux-x64' },
+  darwin: { x64: 'hablas-macos-x64' }
+};
+
+function getBinaryName() {
+  const osConfig = PLATFORM_MAP[process.platform];
+  if (!osConfig) return null;
+  return osConfig[process.arch] || null;
+}
+
+function run() {
+  const binaryName = getBinaryName();
+  const binaryPath = binaryName ? path.resolve(__dirname, binaryName) : null;
+
+  // If Standalone Binary exists, execute it
+  if (binaryPath && fs.existsSync(binaryPath)) {
+    const args = process.argv.slice(2);
+    const result = spawnSync(binaryPath, args, { stdio: 'inherit' });
+    
+    // Exit with the same status code
+    process.exit(result.status ?? 0);
+  } else {
+    // Graceful fallback to running the bundled JavaScript version
+    const fallbackPath = path.resolve(__dirname, '..', 'dist', 'index.js');
+    if (fs.existsSync(fallbackPath)) {
+      // Execute the bundled JavaScript directly using node
+      require(fallbackPath);
+    } else {
+      console.error(`❌ Error: Hablas CLI entry point not found!`);
+      console.error(`Please reinstall the package using: npm install -g hablas`);
+      process.exit(1);
+    }
+  }
+}
+
+run();