heimdall-agent 1.2.0 → 1.4.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/README.md +99 -29
- package/README.pt-BR.md +100 -30
- package/agents/frontend-designer.md +6 -1
- package/agents/modernizer.md +4 -1
- package/agents/orchestrator.md +2 -1
- package/agents/reviewer.md +1 -1
- package/config/agents.json +166 -4
- package/config/mcp.resolved.json +74 -0
- package/config/mcp.template.json +85 -0
- package/config/models.json +70 -0
- package/config/profiles.json +4 -3
- package/config/skills.json +911 -762
- package/docs/SKILLS.md +82 -21
- package/docs/designs/old/2026-11-16 upstream-skill-sync-and-provenance-links.md +60 -0
- package/doctrine/AGENTS.md +3 -3
- package/hooks/heimdall-hook.cjs +16 -1
- package/hooks/hooks.json +11 -0
- package/lib/model-context.cjs +50 -1
- package/lib/model-router.cjs +294 -0
- package/package.json +1 -1
- package/playbooks/05-canonical-plan-template.md +5 -12
- package/playbooks/06-model-registry-matrix.md +27 -19
- package/readme.html +1006 -0
- package/setup.mjs +317 -206
- package/skills/communication-doctrine/SKILL.md +2 -2
- package/skills/handoff/SKILL.md +13 -0
- package/skills/mcp-cleanup/SKILL.md +61 -0
- package/skills/mcp-sync/SKILL.md +58 -0
- package/skills/modern-web-guidance/SKILL.md +90 -0
- package/skills/ruminate/SKILL.md +140 -0
- package/skills/taste-skill/SKILL.md +367 -534
- package/skills/upstream-skill-sync/SKILL.md +46 -0
- package/skills/writing-plans/SKILL.md +1 -1
|
@@ -43,17 +43,10 @@
|
|
|
43
43
|
### Phase 3: Integration & Playwright E2E Verification
|
|
44
44
|
### Phase 4: Review, Purge & Handoff
|
|
45
45
|
|
|
46
|
-
## 5. Symmetric
|
|
47
|
-
- In Herdr (`HERDR_ENV=1`), validate tasks
|
|
48
|
-
-
|
|
49
|
-
|
|
50
|
-
`herdr agent prompt codex-reviewer "Review git diff for security regressions and boundary conditions." --wait --timeout 120000`
|
|
51
|
-
- Tasks executed by Gemini -> Validate with Claude or Codex:
|
|
52
|
-
`herdr agent prompt claude-reviewer "Review git diff for security regressions and type errors." --wait --timeout 120000`
|
|
53
|
-
`herdr agent prompt codex-reviewer "Review git diff for security regressions and boundary conditions." --wait --timeout 120000`
|
|
54
|
-
- Tasks executed by Codex -> Validate with Claude or Gemini:
|
|
55
|
-
`herdr agent prompt claude-reviewer "Review git diff for security regressions and type errors." --wait --timeout 120000`
|
|
56
|
-
`herdr agent prompt gemini-reviewer "Review git diff for security regressions and type errors." --wait --timeout 120000`
|
|
46
|
+
## 5. Symmetric Cross-Family Validation Loop
|
|
47
|
+
- In Herdr (`HERDR_ENV=1`), validate tasks using a **different model family** from the authoring model (e.g., Anthropic ↔ Google ↔ OpenAI/Codex ↔ Zhipu/GLM ↔ Tencent/Hunyuan ↔ Xiaomi/MiMo) selected from `config/models.json` / `playbooks/06-model-registry-matrix.md`:
|
|
48
|
+
- `herdr agent prompt <cross-family-reviewer> "Review git diff for security regressions, boundary conditions, and type errors." --wait --timeout 120000`
|
|
49
|
+
- Select any live reviewer agent/model from a distinct family rather than restricting validation to Claude/Gemini/Codex alone.
|
|
57
50
|
|
|
58
51
|
## 6. Orchestrator Heartbeat
|
|
59
52
|
- Orchestrator monitors progress every 3 minutes.
|
|
@@ -103,4 +96,4 @@
|
|
|
103
96
|
- Every task must explicitly declare one of the registered models and an allowed effort level (`low`, `medium`, `high`, `xhigh`) defined in `playbooks/06-model-registry-matrix.md`.
|
|
104
97
|
- Tasks requiring deep architectural reasoning, type safety, or complex algorithms must use `high` or `xhigh`.
|
|
105
98
|
- Fast scans, boilerplate scaffolding, or rapid audits may use `low` or `medium`.
|
|
106
|
-
- When Gemini 4 Argon reaches quota cooldown,
|
|
99
|
+
- When Gemini 4 Argon reaches quota cooldown, fallback in order: Gemini 4 Hydrogen → Gemini 3.8 Flash → GhostCLI models (Claude/GPT).
|
|
@@ -10,8 +10,8 @@ Models are partitioned into two architectural access channels:
|
|
|
10
10
|
|
|
11
11
|
- **Channel 1: GhostCLI Unified Gateway (`https://ghostcli.cloud`)**
|
|
12
12
|
- Powers **Claude Code CLI**, **OpenAI Codex CLI**, and **Hermes Agent**.
|
|
13
|
-
- Serves all
|
|
14
|
-
- Because GhostCLI exposes multi-protocol translation (`/v1/messages`, `/v1/responses`, `/v1/chat/completions`),
|
|
13
|
+
- Serves all GhostCLI-proxied model families (Anthropic `claude-*`, OpenAI `gpt-*`, Zhipu `z-ai/glm-*`, Tencent `tencent/Hy4-*`, Xiaomi `XiaomiMiMo/*`, and any newly discovered models in `config/models.json`).
|
|
14
|
+
- Because GhostCLI exposes multi-protocol translation (`/v1/messages`, `/v1/responses`, `/v1/chat/completions`), any CLI harness can run any GhostCLI model directly (e.g. `claude --model z-ai/glm-5.3`, `claude --model tencent/Hy4-preview`, `codex --model claude-sonnet-5-5`).
|
|
15
15
|
- When coordinating between harnesses in Herdr (`HERDR_ENV=1`), use native Herdr multiplexing (`herdr agent start/prompt`) directly.
|
|
16
16
|
|
|
17
17
|
- **Channel 2: Google Gemini Direct API (`gemini.googleapis.com`)**
|
|
@@ -22,19 +22,25 @@ Models are partitioned into two architectural access channels:
|
|
|
22
22
|
|
|
23
23
|
## 2. GhostCLI Models (via `https://ghostcli.cloud`)
|
|
24
24
|
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
|
29
|
-
|
|
|
30
|
-
| **Claude
|
|
31
|
-
| **Claude
|
|
32
|
-
| **
|
|
33
|
-
| **
|
|
34
|
-
| **
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
25
|
+
<!-- heimdall:ghostcli-models:start -->
|
|
26
|
+
All GhostCLI models are discovered dynamically via `heimdall sync` / `heimdall sync-models` and stored in `config/models.json`:
|
|
27
|
+
|
|
28
|
+
| Model Name | Canonical Flag | Family | Context Window | Allowed Effort Levels | Specialization / Description |
|
|
29
|
+
| :--- | :--- | :--- | :--- | :--- | :--- |
|
|
30
|
+
| **Claude Opus 5.5** | `claude-opus-5-5` | anthropic | 1M | `low`, `medium`, `high`, `xhigh` | Melhor equilíbrio entre capacidade e custo |
|
|
31
|
+
| **Claude Sonnet 5** | `claude-sonnet-5` | anthropic | 1M | `low`, `medium`, `high` | O mais rápido sem abrir mão de qualidade |
|
|
32
|
+
| **Claude Sonnet 5.5** | `claude-sonnet-5-5` | anthropic | 1M | `low`, `medium`, `high` | Rápido e mais capaz que o Sonnet 5 |
|
|
33
|
+
| **Claude Fable 5.2** | `claude-fable-5.2` | anthropic | 1M | `low`, `medium`, `high`, `xhigh` | Máxima capacidade disponível |
|
|
34
|
+
| **GLM 5.3** | `z-ai/glm-5.3` | z-ai | 1M | `low`, `medium`, `high`, `xhigh` | Código agêntico com contexto de 1M |
|
|
35
|
+
| **GLM 5.3 Flash** | `z-ai/glm-5.3-flash` | z-ai | 1M | `low`, `medium`, `high` | Respostas rápidas para código |
|
|
36
|
+
| **Hunyuan Hy4 Preview** | `tencent/Hy4-preview` | tencent | 1M | `low`, `medium`, `high`, `xhigh` | Raciocínio e código |
|
|
37
|
+
| **DeepSeek V4.1 Flash** | `deepseek-ai/DeepSeek-V4.1-Flash-1017` | deepseek-ai | 1M | `low`, `medium`, `high` | Respostas rápidas para código |
|
|
38
|
+
| **MiMo V2.6 Pro** | `XiaomiMiMo/MiMo-V2.6-Pro` | xiaomi | 1M | `low`, `medium`, `high`, `xhigh` | Código e raciocínio |
|
|
39
|
+
| **GPT-6 Astra** | `gpt-6-astra` | openai | 1M | `low`, `medium`, `high`, `xhigh` | Trabalho agêntico longo com janela de 1M |
|
|
40
|
+
|
|
41
|
+
> [!NOTE]
|
|
42
|
+
> **Dynamic Model Registry**: Always resolve live model IDs from `config/models.json` or this table after `heimdall sync` / `heimdall sync-models`. Route tasks by **capability tier** across all available families (Anthropic, Google, OpenAI, GLM, Hunyuan, MiMo, etc.), not only Claude/Gemini/Codex.
|
|
43
|
+
<!-- heimdall:ghostcli-models:end -->
|
|
38
44
|
|
|
39
45
|
---
|
|
40
46
|
|
|
@@ -44,8 +50,10 @@ Accessed natively via Google Antigravity / `agy` CLI (never through GhostCLI):
|
|
|
44
50
|
|
|
45
51
|
| Model Name | Canonical Flag | Allowed Effort Levels | Optimal Specialization |
|
|
46
52
|
| :--- | :--- | :--- | :--- |
|
|
47
|
-
| **Gemini 4
|
|
48
|
-
| **Gemini
|
|
53
|
+
| **Gemini 4 Hydrogen** | `gemini-4-hydrogen-{effort}` (e.g. `gemini-4-hydrogen-xhigh`) | `low`, `medium`, `high`, `xhigh` | Efficient frontier reasoning with speed and long decodes up to 1M tokens. Supports xhigh effort tier. Replaces Flash branding. |
|
|
54
|
+
| **Gemini 4 Argon** | `gemini-4-argon-{effort}` (e.g. `gemini-4-argon-high`) | `low`, `medium`, `high` | Efficient Gemini 4 frontier reasoning, faster responses and lower token spend. Subject to quota cooldowns. |
|
|
55
|
+
| **Orchestrator (Argon)** | N/A (model dropdown option in Antigravity) | Auto-managed | Dynamic mode that splits tasks between Carbon (planning/review) and Hydrogen (implementation) within one session. Uses ~24% less quota and finishes ~19% faster than Carbon alone. Requires Google AI Ultra subscription; not a standalone model. |
|
|
56
|
+
| **Gemini 3.8 Flash** | `gemini-3.8-flash-{effort}` (e.g. `gemini-3.8-flash-high`) | `low`, `medium`, `high` | Stable previous-generation Flash for software engineering, autonomous agents, and complex enterprise workflows. Current default workhorse. |
|
|
49
57
|
|
|
50
58
|
---
|
|
51
59
|
|
|
@@ -72,12 +80,12 @@ The `/model` picker in Claude Code shows a hardcoded list that may include model
|
|
|
72
80
|
|
|
73
81
|
To dispatch any GhostCLI model — including those invisible in the picker — pass its canonical flag via the Agent tool's `model` parameter when spawning subagents (e.g. `model: "gpt-6-astra"`, `model: "z-ai/glm-5.3"`). The API call routes through GhostCLI regardless of what `/model` displays.
|
|
74
82
|
|
|
75
|
-
Gemini models (`gemini-4`, `gemini-
|
|
83
|
+
Gemini models (`gemini-4-hydrogen`, `gemini-4-argon`, `gemini-3.8-flash`) are never reachable through GhostCLI; they are accessed natively via Google Antigravity (`agy` CLI in Herdr). `Orchestrator (Argon)` is a dynamic mode that splits tasks between planning and implementation within one session — it is not a standalone model. Gemini 4 Carbon exists but is unavailable on current plan tier.
|
|
76
84
|
|
|
77
85
|
---
|
|
78
86
|
|
|
79
87
|
## 6. Effort Constraint & Fallback Rules
|
|
80
88
|
|
|
81
89
|
- **Effort Constraint Rule**: Each task in a plan must explicitly declare one of the registered models and an allowed effort level matching the tables above.
|
|
82
|
-
- **Quota Fallback Rule**: When Gemini 4 Argon reaches quota cooldown,
|
|
90
|
+
- **Quota Fallback Rule**: When Gemini 4 Argon reaches quota cooldown, fallback in order: Gemini 4 Hydrogen → Gemini 3.8 Flash → GhostCLI models (Claude/GPT).
|
|
83
91
|
- **Headless Execution Limitation**: The `agy` CLI requires a TTY for all execution modes including `--print`. Non-interactive/headless invocations from scripts, CI, or piped environments will hang indefinitely. Use Herdr split/tab/window modes instead, or run `agy` interactively.
|