hablas-ai 1.3.22 → 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +25 -162
- package/README.md +120 -290
- package/dist/index.js +173 -1222
- package/package.json +6 -11
package/CHANGELOG.md
CHANGED
|
@@ -1,169 +1,32 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
## [2.0.0] — 2026-06-12 · Full Single-Agent Rebuild
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
|
-
|
|
8
|
-
---
|
|
9
|
-
|
|
10
|
-
## [1.3.22] — 2026-06-12 · Direct-Path and Hidden-Team Hotfix
|
|
11
|
-
|
|
12
|
-
### Fixed
|
|
13
|
-
- Casual and simple direct-path turns now skip tool definitions when no tools are required, reducing provider-side instability on trivial inputs like `hi`.
|
|
14
|
-
- Hid the startup team roster by default in the stable line unless explicit debug theatre is enabled.
|
|
15
|
-
- Stopped unified runtime routing payloads from printing in normal operation.
|
|
16
|
-
- Kept internal team coordination behind the scenes by default while preserving it for serious engineering turns.
|
|
17
|
-
|
|
18
|
-
### Notes
|
|
19
|
-
- If needed for debugging or demos, internal theatre can still be exposed explicitly through environment flags.
|
|
20
|
-
|
|
21
|
-
## [1.3.21] — 2026-06-12 · Leader-Only UX Hotfix
|
|
22
|
-
|
|
23
|
-
### Fixed
|
|
24
|
-
- Stopped unified runtime debug payloads from appearing in normal user output.
|
|
25
|
-
- Hid internal team theatre by default in the stable line.
|
|
26
|
-
- Preserved internal coordinated execution while keeping **Hablas** as the only visible user-facing speaker.
|
|
27
|
-
- Replaced visible delegation noise with cleaner coordination status during team execution.
|
|
28
|
-
- Tightened Hablas tone to avoid emojis, hype, and filler in normal responses.
|
|
29
|
-
|
|
30
|
-
### Notes
|
|
31
|
-
- Internal team theatre is now debug-only and can be re-enabled explicitly for inspection.
|
|
32
|
-
- This hotfix targets the reported regression where continuity/team routing leaked internal execution UX to the user.
|
|
33
|
-
|
|
34
|
-
## [1.3.20] — 2026-06-12 · Stable Runtime Recovery
|
|
35
|
-
|
|
36
|
-
### Changed
|
|
37
|
-
- Removed public mode-era commands from the stable CLI surface:
|
|
38
|
-
- `hablas build`
|
|
39
|
-
- `hablas design`
|
|
40
|
-
- `hablas ask`
|
|
41
|
-
- `/mode`
|
|
42
|
-
- Re-centered the product around a **single command surface**:
|
|
43
|
-
- `hablas`
|
|
44
|
-
- `hablas run "..."`
|
|
45
|
-
- Replaced visible mode thinking with an internal unified runtime model based on:
|
|
46
|
-
- `executionPath: direct | team`
|
|
47
|
-
- `taskKind: conversation | analysis | implementation`
|
|
48
|
-
- Updated the interactive REPL and non-interactive `run` command to enter through the unified runtime path first.
|
|
49
|
-
- Simplified setup and help messaging to match the stable mental model.
|
|
50
|
-
|
|
51
|
-
### Removed
|
|
52
|
-
- Hidden gate-based routing from the active stable-line code path.
|
|
53
|
-
- Gate defaults from agent model configuration.
|
|
54
|
-
- Gate mindset registration from the built-in mindset registry.
|
|
5
|
+
This release replaces the old stable product surface with a new one built around a strict single-agent direction.
|
|
55
6
|
|
|
56
7
|
### Added
|
|
57
|
-
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
### Verified
|
|
67
|
-
- `npm test` passes
|
|
68
|
-
- `npm run build` passes
|
|
69
|
-
- CLI help no longer exposes removed public mode commands
|
|
70
|
-
|
|
71
|
-
## [1.0.0] — 2026-05-31 · **First Public Release**
|
|
72
|
-
|
|
73
|
-
The first formal, polished, production-ready release of Hablas CLI. Months of
|
|
74
|
-
internal iteration consolidated into a focused, type-strict, dead-code-free
|
|
75
|
-
multi-agent system that runs locally or against any OpenAI-compatible API.
|
|
76
|
-
|
|
77
|
-
### ✨ Highlights
|
|
78
|
-
- **Live Team Theatre** — watch the multi-agent team (Hablas → Emma → Bob →
|
|
79
|
-
Alex → David) collaborate in real time, in character, with bounded
|
|
80
|
-
in-character dialogue between agents.
|
|
81
|
-
- **Single-leader UX** — you only talk to Hablas. He delegates, reviews,
|
|
82
|
-
synthesizes, and replies in his own INTJ voice.
|
|
83
|
-
- **Strict separation of concerns** — `AgentChannel` (event bus),
|
|
84
|
-
`TheatreRenderer` (UI), `TeamConductor` (orchestration logic),
|
|
85
|
-
`InterAgentChat` (dialogue generation) are fully decoupled.
|
|
86
|
-
|
|
87
|
-
### Added
|
|
88
|
-
- **Live Team Theatre subsystem** (5 new modules, ~1,000 LOC):
|
|
89
|
-
- `agents/agent-channel.ts` — typed event bus, single source of truth.
|
|
90
|
-
- `agents/inter-agent-chat.ts` — bounded in-character dialogue generator
|
|
91
|
-
with token budget, cache, and deterministic fallback.
|
|
92
|
-
- `agents/team-conductor.ts` — drives delegate → handoff → execute →
|
|
93
|
-
peer-review → synthesize on the AgentChannel.
|
|
94
|
-
- `repl/theatre.ts` — executive-silver TUI subscriber.
|
|
95
|
-
- `agents/__tests__/agent-channel.test.ts` — 11 unit tests.
|
|
96
|
-
- **T-shirt sizing** (XS/S/M/L/XL) for complexity-aware routing.
|
|
97
|
-
- **Plan approval flow** with `approve / edit / skip` for L and XL tasks.
|
|
98
|
-
- **`/team`, `/agents`, `/agents models`, `/delegate`** slash commands.
|
|
99
|
-
- **Multi-provider support** — Ollama, NVIDIA NIM, OpenAI-compatible APIs.
|
|
100
|
-
- **Tool Parser V2** — model-aware learning across 6+ tool-call formats.
|
|
101
|
-
- **ReAct engine** with `<thinking>` block parsing and step budget warnings.
|
|
102
|
-
- **Error Recovery engine** — classifies tool failures and injects
|
|
103
|
-
recovery strategies into the next prompt.
|
|
104
|
-
- **Smart abort** — only critical tool failures stop the chain.
|
|
105
|
-
- **Ctrl+C** — single press cancels the current op, double press exits cleanly.
|
|
106
|
-
- **Checkpoint & Undo Stack** — `/checkpoint save|list|restore`, `/undo [all|list|N]`.
|
|
107
|
-
- **Project memory** — categorized, importance-weighted, decay-based, agent-lanes.
|
|
108
|
-
- **Auto-inject** — files mentioned in user input are auto-loaded into the session.
|
|
109
|
-
- **Setup wizard** on first run.
|
|
110
|
-
- **Team mode** (`--team`) — Supabase + Git-based file locks and presence.
|
|
111
|
-
- **`hablas commit | pr | changelog | security | stats | info`** sub-commands.
|
|
8
|
+
- new single-agent CLI entry
|
|
9
|
+
- new single-agent interactive runtime
|
|
10
|
+
- new task analyzer
|
|
11
|
+
- new prompt builder
|
|
12
|
+
- new direct text-turn path
|
|
13
|
+
- new rebuild-oriented docs set
|
|
14
|
+
- analyzer regression test
|
|
15
|
+
- engine smoke test retained around the canonical execution loop
|
|
112
16
|
|
|
113
17
|
### Changed
|
|
114
|
-
-
|
|
115
|
-
-
|
|
116
|
-
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
- `planner/{classifier, executor, smart-planner-v2}.ts`
|
|
130
|
-
- `tools/{compact, glob, multi-edit, project-intelligence, registry-v3,
|
|
131
|
-
todo-manager, web-search, v2/web, v2/background}.ts`
|
|
132
|
-
- `repl/todo-renderer.ts`
|
|
133
|
-
- `templates/template-manager.ts`
|
|
134
|
-
- `types/{web-deps, xenova-transformers}.d.ts`
|
|
135
|
-
- **~95 unused imports** across live files, removed via static analysis.
|
|
136
|
-
- **Legacy `setOutputCallback` printer** in `loop.ts` — superseded by the
|
|
137
|
-
Theatre pipeline.
|
|
138
|
-
- **Hardcoded `2.0.0` strings** — now bind dynamically to `package.json`.
|
|
139
|
-
|
|
140
|
-
### Fixed
|
|
141
|
-
- `api/server.ts` health endpoint returns the real version from `package.json`.
|
|
142
|
-
- `team-conductor.ts` no longer holds an unused `config` field.
|
|
143
|
-
- `loop.ts` `BACKUP_DIR` and unused `fsPromises` removed.
|
|
144
|
-
- All `tsc --noUnusedLocals --noUnusedParameters` warnings cleared.
|
|
145
|
-
|
|
146
|
-
### Hard Guarantees
|
|
147
|
-
- ✅ `npm run build` (strict TS) passes with **zero** errors.
|
|
148
|
-
- ✅ `npm test` passes (11/11 channel tests).
|
|
149
|
-
- ✅ `npm install` succeeds with the declared dependencies (no phantom imports).
|
|
150
|
-
- ✅ Hablas is the sole speaker to the user — no agent surprises.
|
|
151
|
-
- ✅ Token budget capped per turn; silent fallback when LLM is offline.
|
|
152
|
-
- ✅ Web app, Supabase schema, and `@Consul` collaboration code untouched.
|
|
153
|
-
|
|
154
|
-
### Engineering Stats
|
|
155
|
-
| Metric | Before | After |
|
|
156
|
-
|---|---|---|
|
|
157
|
-
| TypeScript files | 111 | **74** |
|
|
158
|
-
| Total LOC | 27,143 | **~21,000** |
|
|
159
|
-
| Dead-code files | 37 | **0** |
|
|
160
|
-
| Unused imports/declarations | 103 | **0** |
|
|
161
|
-
| `--noUnusedLocals` clean | ❌ | ✅ |
|
|
162
|
-
| `--noUnusedParameters` clean | ❌ | ✅ |
|
|
163
|
-
| `@ts-ignore` count | 0 | **0** |
|
|
164
|
-
| Unit tests | 0 | **11** |
|
|
165
|
-
|
|
166
|
-
---
|
|
167
|
-
|
|
168
|
-
> The full audit that drove this release is preserved in
|
|
169
|
-
> [`AUDIT_v1.0.0.md`](./AUDIT_v1.0.0.md).
|
|
18
|
+
- Hablas is now presented as a **single visible engineering agent**
|
|
19
|
+
- the active CLI surface was rewritten from scratch
|
|
20
|
+
- the terminal UI was rebuilt into a simpler minimal style
|
|
21
|
+
- help, startup messaging, and docs were rewritten around the new product model
|
|
22
|
+
|
|
23
|
+
### Removed from active stable branch
|
|
24
|
+
- visible mode-era CLI surface
|
|
25
|
+
- visible team-theatre runtime surface
|
|
26
|
+
- specialist handoff UX
|
|
27
|
+
- old runtime/planner product surface
|
|
28
|
+
- old rebuild and migration documentation set
|
|
29
|
+
- large sections of dead source code and unused dependencies
|
|
30
|
+
|
|
31
|
+
### Release intent
|
|
32
|
+
2.0.0 is the first explicit release candidate of the full stable-branch rebuild direction.
|
package/README.md
CHANGED
|
@@ -1,70 +1,29 @@
|
|
|
1
|
-
|
|
1
|
+
# Hablas CLI
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
**Single-agent terminal AI engineering runtime**.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Hablas is being rebuilt from scratch around one strict product decision:
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
> one visible agent, one execution surface, full tools, zero internal theatre
|
|
8
8
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
[](LICENSE)
|
|
12
|
-
[](CHANGELOG.md)
|
|
13
|
-
[](https://nodejs.org)
|
|
14
|
-
[](https://www.typescriptlang.org)
|
|
15
|
-
|
|
16
|
-
</div>
|
|
9
|
+
This stable branch no longer treats multi-agent choreography as the product.
|
|
10
|
+
The product is now **Hablas only**.
|
|
17
11
|
|
|
18
12
|
---
|
|
19
13
|
|
|
20
|
-
##
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
The current stable direction is intentionally simple:
|
|
31
|
-
- no visible mode system
|
|
32
|
-
- no hidden theatrical router persona
|
|
33
|
-
- one unified runtime that decides, internally and honestly, between:
|
|
34
|
-
- **direct leader handling** for simple turns
|
|
35
|
-
- **coordinated team execution** for serious engineering work
|
|
36
|
-
|
|
37
|
-
Hablas runs **locally via Ollama**, or against **any OpenAI-compatible API**
|
|
38
|
-
including **NVIDIA NIM**, OpenAI, Groq, Together, OpenRouter, and others.
|
|
39
|
-
|
|
40
|
-
### ✨ Stable-line principles
|
|
41
|
-
|
|
42
|
-
- **Single command surface** — use `hablas` interactively or `hablas run "..."` non-interactively.
|
|
43
|
-
- **Architectural honesty** — routing is internal runtime behavior, not a public mode maze.
|
|
44
|
-
- **Leader-first UX** — the user speaks to Hablas only; specialists stay internal.
|
|
45
|
-
- **Real execution paths** — direct turns use the main agentic loop; coordinated turns use the internal team.
|
|
46
|
-
- **Continuity-aware** — unfinished project requests can stay on the team path and reuse context.
|
|
47
|
-
- **One-step delivery support** — requests like “finished project, no questions” preserve a dedicated internal flag.
|
|
48
|
-
|
|
49
|
-
### Key Features
|
|
50
|
-
|
|
51
|
-
- **Unified Runtime** — one internal runtime decides `direct` vs `team` execution.
|
|
52
|
-
- **Multi-Agent Coordination** — Hablas can internally orchestrate Emma, Bob, Alex, and David.
|
|
53
|
-
- **Dual Provider** — Ollama (local), NVIDIA NIM, or any OpenAI-compatible API.
|
|
54
|
-
- **Dynamic Model Discovery** — `/models` lists everything your provider exposes.
|
|
55
|
-
- **Agentic Loop** — multi-step tool execution with retries, tool safety, and recovery hints.
|
|
56
|
-
- **Built-in Tools** — file ops, shell, codebase search, web search, scraping, PDF reading, code execution, and more.
|
|
57
|
-
- **Smart Context** — project-aware prompts, persistent memory, shared notebook, and file auto-injection.
|
|
58
|
-
- **Premium TUI** — executive-silver terminal UI with team rendering and status components.
|
|
59
|
-
- **Three-tier safety** — `safe / confirm / dangerous` tool policy behavior.
|
|
60
|
-
- **Ctrl+C UX** — single press cancels the current op, double press exits cleanly.
|
|
61
|
-
- **Auto Mode** — `--auto` skips tool confirmations when appropriate.
|
|
62
|
-
- **Checkpoints & Undo** — `/checkpoint ...`, `/undo ...`.
|
|
63
|
-
- **Team Mode** — optional Supabase + Git-based locks and presence sync.
|
|
14
|
+
## Product principles
|
|
15
|
+
|
|
16
|
+
1. **Single visible agent**
|
|
17
|
+
2. **Fast direct path for trivial turns**
|
|
18
|
+
3. **Full tool execution for real engineering work**
|
|
19
|
+
4. **No hidden routing leaks in the UX**
|
|
20
|
+
5. **No handoff theatre, no mode maze, no orchestration drama**
|
|
21
|
+
6. **Read before edit, verify before claim**
|
|
22
|
+
7. **Direct technical tone: no emojis, no hype, no filler**
|
|
64
23
|
|
|
65
24
|
---
|
|
66
25
|
|
|
67
|
-
##
|
|
26
|
+
## Installation
|
|
68
27
|
|
|
69
28
|
```bash
|
|
70
29
|
git clone https://github.com/Monopoly63/mobile-bot.git
|
|
@@ -74,289 +33,160 @@ npm run build
|
|
|
74
33
|
npm link
|
|
75
34
|
```
|
|
76
35
|
|
|
77
|
-
|
|
36
|
+
Requirements:
|
|
37
|
+
- Node.js 20+
|
|
38
|
+
- One provider:
|
|
39
|
+
- Ollama
|
|
40
|
+
- NVIDIA NIM
|
|
41
|
+
- any OpenAI-compatible API
|
|
78
42
|
|
|
79
|
-
|
|
80
|
-
- One of:
|
|
81
|
-
- **Ollama** running locally (`ollama serve`)
|
|
82
|
-
- An **OpenAI-compatible API** key
|
|
83
|
-
- **NVIDIA NIM** API key
|
|
43
|
+
---
|
|
84
44
|
|
|
85
|
-
|
|
45
|
+
## Usage
|
|
46
|
+
|
|
47
|
+
### Interactive
|
|
86
48
|
|
|
87
49
|
```bash
|
|
88
|
-
hablas
|
|
50
|
+
hablas
|
|
89
51
|
```
|
|
90
52
|
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
## ✦ Quick Start
|
|
53
|
+
### Interactive with automatic tool confirmations where allowed
|
|
94
54
|
|
|
95
55
|
```bash
|
|
96
|
-
# Interactive REPL
|
|
97
|
-
hablas
|
|
98
|
-
|
|
99
|
-
# Interactive REPL with auto-confirm for tools
|
|
100
56
|
hablas --auto
|
|
101
|
-
|
|
102
|
-
# One-shot unified runtime execution
|
|
103
|
-
hablas run "refactor src/auth.ts to use bcrypt"
|
|
104
|
-
|
|
105
|
-
# Generate a commit message from staged changes
|
|
106
|
-
hablas commit
|
|
107
|
-
|
|
108
|
-
# Project info
|
|
109
|
-
hablas info
|
|
110
|
-
|
|
111
|
-
# Diagnostics
|
|
112
|
-
hablas doctor
|
|
113
57
|
```
|
|
114
58
|
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
## ✦ Mental Model
|
|
118
|
-
|
|
119
|
-
Hablas no longer exposes public modes like `build`, `design`, or `ask`.
|
|
120
|
-
|
|
121
|
-
Instead, every request goes through one internal runtime:
|
|
122
|
-
|
|
123
|
-
1. **User input**
|
|
124
|
-
2. **Unified runtime routing**
|
|
125
|
-
3. **Direct leader path** *or* **coordinated team path**
|
|
126
|
-
4. **Final answer from Hablas**
|
|
127
|
-
|
|
128
|
-
Examples:
|
|
129
|
-
|
|
130
|
-
- `hi` → direct reply
|
|
131
|
-
- `what is the current version of this project?` → direct reply
|
|
132
|
-
- `design the architecture for auth` → team analysis path
|
|
133
|
-
- `continue the unfinished flower store project` → team continuity path
|
|
134
|
-
- `just give me the finished project in one step no questions` → team one-step delivery path
|
|
59
|
+
### One-shot
|
|
135
60
|
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
### Core Slash Commands
|
|
141
|
-
|
|
142
|
-
| Command | Description |
|
|
143
|
-
|---|---|
|
|
144
|
-
| `/help` | List all commands |
|
|
145
|
-
| `/about` · `/version` | Identity & version info |
|
|
146
|
-
| `/team` · `/agents` | Team roster · multi-agent system status |
|
|
147
|
-
| `/agents on\|off\|status\|models` | Toggle and inspect agents |
|
|
148
|
-
| `/delegate <agent> <task>` | Manually assign a task to one visible specialist |
|
|
149
|
-
| `/mindset <name>` · `/mindsets` | Switch / list agent mindsets |
|
|
150
|
-
| `/clear` · `/history [n]` | Reset context · show recent turns |
|
|
151
|
-
| `/status` · `/quit` | Show status · exit |
|
|
152
|
-
|
|
153
|
-
### Model & Provider
|
|
154
|
-
|
|
155
|
-
| Command | Description |
|
|
156
|
-
|---|---|
|
|
157
|
-
| `/model [name]` | Show or switch the active model |
|
|
158
|
-
| `/models [page\|query]` | Browse available models |
|
|
159
|
-
| `/provider [ollama\|nvidia\|custom\|test]` | Switch / test the provider |
|
|
160
|
-
| `/addmodel` · `/listmodels` · `/usemodel <name>` · `/removemodel <name>` | Manage saved provider profiles |
|
|
161
|
-
|
|
162
|
-
### Project Tools
|
|
163
|
-
|
|
164
|
-
| Command | Description |
|
|
165
|
-
|---|---|
|
|
166
|
-
| `/security` | Run the project security scan |
|
|
167
|
-
| `/git status` | Show Git status |
|
|
168
|
-
| `/workspace` | Show framework/language/CI detection |
|
|
169
|
-
| `/stats` · `/cost` | Usage analytics |
|
|
170
|
-
| `/test [--fix]` | Detect & run tests, optionally let the agent fix them |
|
|
171
|
-
| `/checkpoint save\|list\|restore\|delete` | Snapshot & restore project state |
|
|
172
|
-
| `/undo [N\|all\|list]` | Revert recent agent changes |
|
|
173
|
-
| `/compare <a> <b>` · `/compare HEAD~1` | Side-by-side diff |
|
|
174
|
-
|
|
175
|
-
### Memory & Context
|
|
176
|
-
|
|
177
|
-
| Command | Description |
|
|
178
|
-
|---|---|
|
|
179
|
-
| `/memory [set\|del\|search\|clear]` | Persistent project memory |
|
|
180
|
-
| `/learn "<preference>"` | Teach the agent a preference |
|
|
181
|
-
| `/context [set\|get\|del\|decisions\|clear]` | Cross-agent shared notebook |
|
|
182
|
-
| `/plan status\|finish\|next\|reset` | Inspect the active plan state if one exists |
|
|
183
|
-
|
|
184
|
-
### Plugins & Diagnostics
|
|
185
|
-
|
|
186
|
-
| Command | Description |
|
|
187
|
-
|---|---|
|
|
188
|
-
| `/plugins [enable\|disable]` | Manage plugins (`~/.hablas/plugins/`) |
|
|
189
|
-
| `/alias [set\|del]` | Custom command aliases |
|
|
190
|
-
| `/doctor` | System diagnostics |
|
|
191
|
-
| `/session save\|list\|load` | Save/load conversation state |
|
|
192
|
-
|
|
193
|
-
---
|
|
194
|
-
|
|
195
|
-
## ✦ CLI Flags & Sub-commands
|
|
196
|
-
|
|
197
|
-
| Flag / Sub-command | Description |
|
|
198
|
-
|---|---|
|
|
199
|
-
| `-m, --model <name>` | Set the active model |
|
|
200
|
-
| `-p, --project <path>` | Set the working directory |
|
|
201
|
-
| `--provider <ollama\|custom\|nvidia>` | Choose LLM provider |
|
|
202
|
-
| `--api-url <url>` · `--api-key <key>` | Configure custom/NVIDIA provider |
|
|
203
|
-
| `--auto` | Skip tool confirmations where allowed |
|
|
204
|
-
| `--timeout <ms>` | Per-request timeout (default 120000) |
|
|
205
|
-
| `--theme <dark\|light\|galaxy\|ocean\|forest>` | UI theme |
|
|
206
|
-
| `--team --user <name> --team-key <pwd>` | Enable Team Mode |
|
|
207
|
-
| `--setup` | Run the first-time wizard |
|
|
208
|
-
| `hablas run "<prompt>"` | Non-interactive unified runtime execution |
|
|
209
|
-
| `hablas commit` · `pr` · `changelog` | Git intelligence sub-commands |
|
|
210
|
-
| `hablas info` · `doctor` · `security` · `stats` | Project insights |
|
|
211
|
-
| `hablas api --port 8080` | Start the REST API server |
|
|
61
|
+
```bash
|
|
62
|
+
hablas run "read package.json and tell me the version"
|
|
63
|
+
```
|
|
212
64
|
|
|
213
65
|
---
|
|
214
66
|
|
|
215
|
-
##
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
67
|
+
## Current command surface
|
|
68
|
+
|
|
69
|
+
### CLI commands
|
|
70
|
+
- `hablas`
|
|
71
|
+
- `hablas run "..."`
|
|
72
|
+
- `hablas doctor`
|
|
73
|
+
- `hablas info`
|
|
74
|
+
- `hablas security`
|
|
75
|
+
- `hablas stats`
|
|
76
|
+
- `hablas --setup`
|
|
77
|
+
|
|
78
|
+
### Slash commands
|
|
79
|
+
- `/help`
|
|
80
|
+
- `/status`
|
|
81
|
+
- `/model [name]`
|
|
82
|
+
- `/models [query]`
|
|
83
|
+
- `/provider [ollama|nvidia|custom|test]`
|
|
84
|
+
- `/history [n]`
|
|
85
|
+
- `/clear`
|
|
86
|
+
- `/workspace`
|
|
87
|
+
- `/doctor`
|
|
88
|
+
- `/version`
|
|
89
|
+
- `/about`
|
|
90
|
+
- `/exit`
|
|
229
91
|
|
|
230
92
|
---
|
|
231
93
|
|
|
232
|
-
##
|
|
233
|
-
|
|
234
|
-
Config lives at **`~/.hablas/config.json`**.
|
|
94
|
+
## Execution model
|
|
235
95
|
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
| `~/.hablas/aliases.json` | Custom slash-command aliases |
|
|
242
|
-
| `~/.hablas/memory/<hash>.json` | Per-project memory store |
|
|
243
|
-
| `~/.hablas/plugins/` | Installed plugins |
|
|
244
|
-
| `~/.hablas/logs/` | Structured pino logs |
|
|
245
|
-
|
|
246
|
-
---
|
|
96
|
+
Hablas analyzes a request into one of four internal task kinds:
|
|
97
|
+
- `casual`
|
|
98
|
+
- `read`
|
|
99
|
+
- `analysis`
|
|
100
|
+
- `implementation`
|
|
247
101
|
|
|
248
|
-
|
|
102
|
+
Then it decides whether the turn should be:
|
|
103
|
+
- **direct text execution**
|
|
104
|
+
- **tool-based execution**
|
|
249
105
|
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
| **★ Hablas** | Team Leader | User interface, routing, synthesis, final delivery |
|
|
253
|
-
| **◆ Emma** | Product Manager | Requirements, framing, PRDs, scope |
|
|
254
|
-
| **◆ Bob** | Architect | Architecture, structure, trade-offs |
|
|
255
|
-
| **◆ Alex** | Engineer | Implementation, debugging, code changes |
|
|
256
|
-
| **◆ David** | Data Analyst | Research, comparisons, supporting analysis |
|
|
257
|
-
|
|
258
|
-
The user speaks to **Hablas only**.
|
|
259
|
-
The rest of the team is an internal execution system.
|
|
106
|
+
There is no public `build/design/ask` mode system anymore.
|
|
107
|
+
There is no visible team routing layer.
|
|
260
108
|
|
|
261
109
|
---
|
|
262
110
|
|
|
263
|
-
##
|
|
264
|
-
|
|
265
|
-
```bash
|
|
266
|
-
# Read, then edit
|
|
267
|
-
> read src/auth.ts and add JWT validation
|
|
111
|
+
## Examples
|
|
268
112
|
|
|
269
|
-
|
|
270
|
-
|
|
113
|
+
### Simple direct turn
|
|
114
|
+
```text
|
|
115
|
+
hi
|
|
116
|
+
```
|
|
117
|
+
Expected behavior:
|
|
118
|
+
- no tool calls
|
|
119
|
+
- short direct answer
|
|
271
120
|
|
|
272
|
-
|
|
273
|
-
|
|
121
|
+
### Project inspection
|
|
122
|
+
```text
|
|
123
|
+
what is the current version of this project
|
|
124
|
+
```
|
|
125
|
+
Expected behavior:
|
|
126
|
+
- inspect the minimum relevant files
|
|
127
|
+
- answer from evidence
|
|
274
128
|
|
|
275
|
-
|
|
276
|
-
|
|
129
|
+
### Architecture request
|
|
130
|
+
```text
|
|
131
|
+
design the architecture for auth in this repository
|
|
132
|
+
```
|
|
133
|
+
Expected behavior:
|
|
134
|
+
- structured analysis
|
|
135
|
+
- inspect files only if needed
|
|
136
|
+
- answer as one agent
|
|
277
137
|
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
138
|
+
### Continuation request
|
|
139
|
+
```text
|
|
140
|
+
continue the unfinished project
|
|
141
|
+
```
|
|
142
|
+
Expected behavior:
|
|
143
|
+
- continue from existing work
|
|
144
|
+
- do not restart from zero
|
|
282
145
|
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
146
|
+
### One-step delivery request
|
|
147
|
+
```text
|
|
148
|
+
just give me the finished project in one step no questions
|
|
286
149
|
```
|
|
150
|
+
Expected behavior:
|
|
151
|
+
- aggressive execution posture
|
|
152
|
+
- no unnecessary follow-up questions
|
|
153
|
+
- verify before claiming done
|
|
287
154
|
|
|
288
155
|
---
|
|
289
156
|
|
|
290
|
-
##
|
|
157
|
+
## Architecture docs
|
|
291
158
|
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
├── mindset/ Per-agent system prompts
|
|
299
|
-
├── tools/ Tool registry + built-in tools
|
|
300
|
-
├── context/ Session, memory, shared notebook, auto-inject
|
|
301
|
-
├── config/ Defaults + JSON loader
|
|
302
|
-
├── collaboration/ Optional Team Mode (Supabase + Git locks)
|
|
303
|
-
├── plugins/ Plugin loader + diagnostics
|
|
304
|
-
├── security/ /security scanner
|
|
305
|
-
├── analytics/ Usage stats
|
|
306
|
-
├── git/ /commit /pr /changelog intelligence
|
|
307
|
-
├── workspace/ Framework / language / CI detection
|
|
308
|
-
└── utils/ logger, diff, tokens
|
|
309
|
-
```
|
|
310
|
-
|
|
311
|
-
Stable-line architecture focus:
|
|
312
|
-
- **one runtime entry**
|
|
313
|
-
- **direct vs team execution path**
|
|
314
|
-
- **single leader UX**
|
|
315
|
-
- **no public mode system**
|
|
159
|
+
See:
|
|
160
|
+
- `docs/ARCHITECTURE.md`
|
|
161
|
+
- `docs/CLI.md`
|
|
162
|
+
- `docs/ROADMAP.md`
|
|
163
|
+
- `docs/STATUS.md`
|
|
164
|
+
- `docs/PUBLISH.md`
|
|
316
165
|
|
|
317
166
|
---
|
|
318
167
|
|
|
319
|
-
##
|
|
168
|
+
## Development
|
|
320
169
|
|
|
321
170
|
```bash
|
|
322
171
|
npm install
|
|
323
172
|
npm run build
|
|
324
|
-
npm run lint
|
|
325
173
|
npm test
|
|
326
174
|
npm run dev -- run "your prompt"
|
|
327
175
|
```
|
|
328
176
|
|
|
329
|
-
Current automated
|
|
330
|
-
-
|
|
331
|
-
-
|
|
332
|
-
- unified runtime routing regression tests
|
|
177
|
+
Current automated checks cover:
|
|
178
|
+
- shared execution engine smoke behavior
|
|
179
|
+
- analyzer behavior
|
|
333
180
|
|
|
334
181
|
---
|
|
335
182
|
|
|
336
|
-
##
|
|
337
|
-
|
|
338
|
-
Some older design documents in `docs/` describe intermediate runtime experiments
|
|
339
|
-
such as visible modes or hidden gate-based routing.
|
|
340
|
-
|
|
341
|
-
For the current stable direction, start with:
|
|
342
|
-
- `docs/stable-runtime-recovery-plan-2026-06-12.md`
|
|
343
|
-
|
|
344
|
-
Treat older redesign / migration docs as **historical context**, not as the
|
|
345
|
-
current product surface.
|
|
346
|
-
|
|
347
|
-
---
|
|
348
|
-
|
|
349
|
-
## ✦ Author
|
|
350
|
-
|
|
351
|
-
**Abdulmoin Hablas** — [Portfolio](https://portfolio-monopoly63s-projects.vercel.app/)
|
|
352
|
-
|
|
353
|
-
### Other Projects
|
|
183
|
+
## Rebuild status
|
|
354
184
|
|
|
355
|
-
|
|
356
|
-
|
|
185
|
+
This branch is under an intentional **full rebuild** of the stable product surface.
|
|
186
|
+
Dead code from the previous multi-agent product is being physically removed instead of patched.
|
|
357
187
|
|
|
358
188
|
---
|
|
359
189
|
|
|
360
|
-
##
|
|
190
|
+
## License
|
|
361
191
|
|
|
362
|
-
|
|
192
|
+
MIT
|