mixdog 0.9.19 → 0.9.20

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tribgames
+
+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

@@ -1,29 +1,88 @@
 # mixdog
 
-Standalone coding-agent CLI/TUI for running a multi-provider AI workspace from
-one terminal.
-
-Mixdog combines an Ink-based terminal UI, model/provider routing, workflow
-agents, MCP/plugin/skill loading, memory, web search, channel integrations, and
-repo-focused tools for reading, editing, testing, and reviewing code.
-
-## Highlights
-
-- **Multi-provider model picker** for Anthropic, OpenAI, Google/Gemini, xAI/Grok,
-  DeepSeek, OpenCode Go, OAuth-backed providers, OpenAI-compatible APIs, Ollama,
-  and LM Studio/local endpoints.
-- **Live model catalog** from provider `/models` endpoints, enriched with
-  LiteLLM/models.dev metadata for context windows, output limits, pricing, tool
-  support, reasoning, web search, and recency.
-- **Full-screen TUI** with slash commands, provider setup, model/workflow
-  pickers, usage dashboards, statusline integration, resumable sessions, and
-  detailed tool cards.
-- **Workflow delegation** through `/agent` and the `agent` tool, including
-  worker, heavy-worker, reviewer, debugger, maintainer, and explorer roles.
-- **Repo-native tools** for `read`, `grep`, `glob`, `list`, `code_graph`,
-  `apply_patch`, `shell`, `cwd`, `explore`, web search, and memory recall.
-- **Remote/event workflows** via optional Discord channel, webhook, schedule,
-  and channel-management integrations.
+[![npm](https://img.shields.io/npm/v/mixdog)](https://www.npmjs.com/package/mixdog)
+![node](https://img.shields.io/badge/node-%3E%3D22-brightgreen)
+![license](https://img.shields.io/badge/license-MIT-blue)
+
+Standalone coding-agent CLI/TUI that runs an orchestrated, multi-provider
+agent workflow from one terminal — built for maximum performance at minimum
+cost.
+
+Mixdog combines an Ink-based terminal UI, per-role model routing across
+providers, workflow agents, MCP/plugin/skill/hook support, lightweight
+memory, web search, channel integrations, and repo-native tools for reading,
+editing, testing, and reviewing code.
+
+## Terminal-Bench 2.1 — 89.9% (self-reported)
+
+![Terminal-Bench 2.1 leaderboard with mixdog](https://raw.githubusercontent.com/tribgames/mixdog/main/benchmarks/terminal-bench-2.1/tb21-leaderboard.svg)
+
+Single-run score of **80/89 = 89.9%** (k=1) on
+`terminal-bench/terminal-bench-2-1`, using a cost-reduced per-role routing
+config:
+
+| Role                | Model           | Effort      |
+|---------------------|-----------------|-------------|
+| Lead (orchestrator) | Claude Fable 5  | high        |
+| Explorer            | Claude Haiku 4.5| default     |
+| Worker              | Claude Opus 4.8 | medium      |
+| Heavy worker        | Claude Opus 4.8 | high        |
+| Reviewer            | GPT-5.5         | high (fast) |
+
+Against published model scores this places second overall — behind GPT-5.6
+Sol Ultra (91.9%), ahead of GPT-5.6 Sol (88.8%) and Claude Mythos 5 (88%),
+and well above the same primary model run standalone (Claude Fable 5,
+84.3%). Measured once (k=1) due to cost, so treat it as indicative — a
+max-effort k=5 run is planned and is expected to land higher. Per-task
+results, raw Harbor jobs, and the harness adapter live in
+`benchmarks/terminal-bench-2.1/`.
+
+Full transparency: 4 tasks refused by the primary model's safety layer were
+re-run routed to Claude Opus 4.8 (effort xhigh) and passed; timeouts and
+task resources were left unmodified. Raw Harbor `result.json`/`config.json`
+for every constituent run are included.
+
+## Why mixdog
+
+**Maximum performance at minimum cost**
+
+- Orchestrated agent workflow that mixes providers and models per role, so
+  each step runs on the cheapest model that can do the job well.
+- Cache-aware prompt layout and aggressive context savings across turns.
+- Lean output policy plus fine-grained session management: compaction,
+  resumable sessions, and usage dashboards.
+- A custom harness with tool-call routing tuned for the fewest, most
+  effective calls (`code_graph`, batched `read`/`grep`, windowed reads).
+
+**Any provider**
+
+- Anthropic, OpenAI, Google/Gemini, xAI/Grok, DeepSeek, OpenCode Go,
+  OAuth-backed providers, OpenAI-compatible APIs, Ollama, and LM Studio/local
+  endpoints.
+- Live model catalog from provider `/models` endpoints, enriched with
+  LiteLLM/models.dev metadata for context windows, output limits, pricing,
+  tool support, reasoning, and recency.
+- Customizable web search and repo exploration tools.
+
+**Any environment**
+
+- Full-screen TUI with slash commands, provider setup, model/workflow
+  pickers, statusline integration, and detailed tool cards — plus headless
+  role mode for scripting.
+- Optional Discord/Telegram channels, webhook endpoints, cron schedules, and
+  voice-message transcription for remote/event-driven workflows.
+
+**Memory**
+
+- Lightweight memory restores prior work context across sessions.
+- Important memories are automatically promoted — and demoted when stale.
+
+**Agent-ecosystem compatible**
+
+- Skills, MCP servers, hooks, and plugins load through standard-compatible
+  interfaces.
+- Workflow delegation through the `agent` tool and `/agents`: worker,
+  heavy-worker, reviewer, debugger, maintainer, and explorer roles.
 
 ## Requirements
 
@@ -73,13 +132,14 @@ mixdog reviewer "review the current diff"
 Common slash commands:
 
 ```text
-/help              show help
 /providers         configure provider auth and local endpoints
-/model             choose provider/model, effort, and fast mode
+/model             choose the main provider/model (/effort, /fast tune it)
 /workflow          choose the active workflow
-/agents            show available workflow agents
-/agent             manage active agent tasks
-/mode              switch tool surface: full | readonly
+/agents            show workflow agents and per-agent model overrides
+/setting           open the runtime settings hub
+/mcp               manage MCP servers and tools
+/skills            choose a skill for the next request
+/channels          manage Discord/Telegram, schedules, webhooks, voice
 /compact           compact older conversation context
 /clear             reset the conversation and screen
 /OutputStyle       show or switch Lead output style
@@ -156,3 +216,7 @@ vendor/
 
 `docs/` is not included in the published package unless `package.json#files` is
 changed.
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mixdog",
-  "version": "0.9.19",
+  "version": "0.9.20",
   "private": false,
   "type": "module",
   "description": "Standalone mixdog coding-agent CLI/TUI workspace.",
@@ -35,7 +35,7 @@
     "prepack": "npm run build:tui",
     "start": "node src/cli.mjs",
     "smoke": "node scripts/smoke.mjs",
-    "smoke:all": "npm run smoke && npm run smoke:boot && npm run smoke:tools && npm run smoke:output && npm run smoke:tui && npm run smoke:freevars",
+    "smoke:all": "npm run smoke && npm run smoke:boot && npm run smoke:tools && npm run smoke:output && npm run smoke:tui && npm run smoke:freevars && npm run smoke:logguard",
     "smoke:boot": "node scripts/boot-smoke.mjs",
     "smoke:compact": "node scripts/compact-smoke.mjs",
     "smoke:loop": "node scripts/smoke-loop.mjs",
@@ -45,6 +45,7 @@
     "smoke:output": "node scripts/output-style-smoke.mjs",
     "smoke:tui": "node scripts/tui-render-smoke.mjs",
     "smoke:freevars": "node scripts/freevar-smoke.mjs",
+    "smoke:logguard": "node scripts/log-writer-guard-smoke.mjs",
     "test:toolcall": "node --test scripts/toolcall-args-test.mjs",
     "test:providers": "node --test scripts/provider-toolcall-test.mjs",
     "test:atomiclock": "node --test scripts/atomic-lock-tryonce-test.mjs",