mixdog 0.7.18 → 0.8.1

package/commands/config.md

@@ -1,16 +0,0 @@
----
-description: Open the mixdog settings UI (Providers + Presets)
-allowed-tools: Bash(bun:*)
----
-
-## Launch (already executed)
-
-- Launcher output: !`bun "${CLAUDE_PLUGIN_ROOT}/setup/launch.mjs"`
-
-The config UI launcher above has ALREADY run at command invocation — the
-settings window is opening (or open) at http://localhost:3458. Do NOT call
-`open_config` or re-run the launcher when the output above shows a
-"Config UI:" URL; just report that URL to the user.
-
-Only if the launcher output above shows an error instead of a URL, fall back
-to calling the `open_config` tool, then report the resulting URL.

package/commands/doctor.md

@@ -1,13 +0,0 @@
----
-description: Run mixdog health diagnostics
-allowed-tools: Bash(bun:*)
----
-
-<!--
-Checks version sync, Bun version/source, shell runtime, supervisor,
-hook-pipe reachability, config/data files, cache layout & storage sizes,
-voice runtime, required npm deps, and log sizes. Prints an OK/WARN/FAIL
-report; exits 1 on any FAIL.
--->
-
-!`bun "${CLAUDE_PLUGIN_ROOT}/scripts/doctor.mjs"`

package/commands/model.md

@@ -1,61 +0,0 @@
----
-description: Choose/enable the mixdog gateway provider/model (routes Claude Code's main model)
-allowed-tools: mcp__plugin_mixdog_trib-plugin__gateway_select_model, mcp__plugin_mixdog_mixdog__gateway_select_model, Bash(bun:*)
----
-
-## Intent
-
-Open the interactive MCP elicitation picker for the mixdog gateway routing list.
-The first/default choice follows Claude Code's own current `/model` setting
-(including effort/fast when Claude Code exposes them). The remaining choices
-are fixed mixdog provider/model targets. The default `/mixdog:model` action is
-the dropdown-style `gateway_select_model` tool, not the CLI list.
-
-## Default: interactive model picker
-
-When `$ARGUMENTS` is empty, `select`, `ui`, or `picker`, call the mixdog
-`gateway_select_model` MCP tool directly.
-
-Do not run `bun "${CLAUDE_PLUGIN_ROOT}/scripts/gateway-model.mjs"` first for the
-default path. The CLI list is only a fallback if the MCP tool reports that
-elicitation is unavailable.
-
-After the user accepts a choice, report the selected provider/model and whether
-the gateway is already running. Do not modify `settings.json` in this default
-selection flow.
-
-If the user chooses the Claude Code current option, save `gateway.mode =
-"claude-current"` rather than a fixed provider/model preset. In that mode the
-gateway reads the incoming Anthropic request model on every turn, so changes
-made with Claude Code's native `/model` are reflected on the next gateway
-request.
-
-## Quick toggle: `on` / `off`
-
-If `$ARGUMENTS` starts with `on` or `off`, the user is explicitly asking to route
-or stop routing Claude Code's main model through the gateway. Run the matching
-script alias:
-
-```
-bun "${CLAUDE_PLUGIN_ROOT}/scripts/gateway-model.mjs" on [provider] [model]
-bun "${CLAUDE_PLUGIN_ROOT}/scripts/gateway-model.mjs" off
-```
-
-- Bare `on` reuses the currently configured `gateway.defaultProvider` /
-  `gateway.defaultModel`.
-- `on` writes `settings.json` only after the local gateway answers on
-  `http://127.0.0.1:<gatewayPort>`.
-- `off` removes `env.ANTHROPIC_BASE_URL`, sets `modules.gateway.enabled=false`,
-  and waits for the gateway child to stop.
-- Claude Code may need a restart to reload `settings.json` env changes.
-
-## Explicit CLI fallback
-
-Only if the user explicitly asks for a non-interactive command or gives raw
-CLI-style arguments such as `--set`, `--enable`, or `--disable`, run:
-
-```
-bun "${CLAUDE_PLUGIN_ROOT}/scripts/gateway-model.mjs" $ARGUMENTS
-```
-
-Relay the script output exactly enough for the user to know what changed.

package/commands/setup.md

@@ -1,17 +0,0 @@
----
-description: Open the mixdog initial setup UI
-allowed-tools: Bash(bun:*)
-disable-model-invocation: true
----
-
-## Launch (already executed)
-
-- Launcher output: !`bun "${CLAUDE_PLUGIN_ROOT}/setup/launch.mjs"`
-
-The setup UI launcher above has ALREADY run at command invocation — the
-setup window is opening (or open) at http://localhost:3458. Do NOT call
-`open_config` or re-run the launcher when the output above shows a
-"Config UI:" URL; just report that URL to the user.
-
-Only if the launcher output above shows an error instead of a URL, fall back
-to calling the `open_config` tool, then report the resulting URL.

package/defaults/hidden-roles.json

@@ -1,68 +0,0 @@
-{
-  "roles": [
-    {
-      "name": "explorer",
-      "slot": "explore",
-      "systemFile": "rules/bridge/30-explorer.md",
-      "description": "Filesystem navigation agent invoked by the `explore` MCP tool",
-      "invokedBy": "explore",
-      "toolSchemaProfile": "unified",
-      "kind": "retrieval",
-      "permission": "read",
-      "stallCap": { "idleSeconds": 240, "toolRunningSeconds": 180 }
-    },
-    {
-      "name": "cycle1-agent",
-      "slot": "cycle1",
-      "systemFile": "rules/bridge/40-cycle1-agent.md",
-      "description": "Chunker/classifier invoked by memory-cycle runCycle1",
-      "invokedBy": "cycle1",
-      "maintKey": "memory",
-      "toolSchemaProfile": "llm-only",      "kind": "maintenance",
-      "permission": "read",
-      "stallCap": { "idleSeconds": 300, "toolRunningSeconds": 300 }
-    },
-    {
-      "name": "cycle2-agent",
-      "slot": "cycle2",
-      "systemFile": "rules/bridge/41-cycle2-agent.md",
-      "description": "Root re-scorer invoked by memory-cycle runCycle2",
-      "invokedBy": "cycle2",
-      "maintKey": "memory",
-      "toolSchemaProfile": "llm-only",      "kind": "maintenance",
-      "permission": "read",
-      "stallCap": { "idleSeconds": 300, "toolRunningSeconds": 300 }
-    },
-    {
-      "name": "cycle3-agent",
-      "slot": "cycle3",
-      "systemFile": "rules/bridge/42-cycle3-agent.md",
-      "description": "Core memory reviewer invoked by memory-cycle runCycle3",
-      "invokedBy": "cycle3",
-      "maintKey": "memory",
-      "toolSchemaProfile": "llm-only",      "kind": "maintenance",
-      "permission": "read",
-      "stallCap": { "idleSeconds": 300, "toolRunningSeconds": 300 }
-    },
-    {
-      "name": "scheduler-task",
-      "slot": "scheduler",
-      "systemFile": "agents/scheduler-task.md",
-      "description": "Scheduled-task executor invoked by scheduler tick",
-      "invokedBy": "scheduler",
-      "toolSchemaProfile": "unified",      "kind": "maintenance",
-      "permission": "read-write",
-      "stallCap": { "idleSeconds": 600, "toolRunningSeconds": 600 }
-    },
-    {
-      "name": "webhook-handler",
-      "slot": "webhook",
-      "systemFile": "agents/webhook-handler.md",
-      "description": "Webhook payload handler invoked by inbound webhook events",
-      "invokedBy": "webhook",
-      "toolSchemaProfile": "unified",      "kind": "maintenance",
-      "permission": "read-write",
-      "stallCap": { "idleSeconds": 600, "toolRunningSeconds": 600 }
-    }
-  ]
-}

package/defaults/memory-chunk-prompt.md

@@ -1,63 +0,0 @@
-You are a strict memory chunker and classifier.
-
-Read the entries below, group contiguous related entries into memory chunks,
-and output pipe-separated lines only. No JSON, no prose, no fences, no preamble.
-The first character of your response must be a digit.
-
-## Output
-
-One line per chunk:
-
-```
-idx_csv|element|category|summary
-```
-
-- `idx_csv`: comma-separated 1-based input indexes. Use bare numbers.
-- `element`: short recall key, 5-10 words, with the subject and any distinctive
-  identifier.
-- `category`: exactly one of `rule`, `constraint`, `decision`, `fact`, `goal`,
-  `preference`, `task`, `issue`.
-- `summary`: compact declarative memory. Preserve decisive identifiers,
-  numbers, paths, versions, causes, outcomes, and constraints when present.
-- Fields must not contain literal `|` or newlines.
-
-## Chunking
-
-- Every substantive input should appear in exactly one chunk.
-- Omit entries whose only function is acknowledgement, courtesy, reaction, or
-  handoff and which add no fact, decision, constraint, result, preference, or
-  task.
-- Do not include non-substantive rows in a chunk merely because they are
-  adjacent to useful content.
-- Never merge across `[sess:...]` markers.
-- Split unrelated topics even when they are adjacent.
-- Keep question/context and answer/resolution together when they form one
-  cause-outcome memory.
-- If later entries supersede earlier ones, summarize the latest state while
-  keeping the relevant member ids together.
-
-## Categories
-
-- `rule`: standing operating rule or durable identity/system policy.
-- `constraint`: hard limit, prohibition, or approval boundary.
-- `decision`: explicit choice with a clear resolution moment.
-- `fact`: verified current state or observed technical detail.
-- `goal`: long-running target still in flight.
-- `preference`: user style or taste that may guide future behavior.
-- `task`: concrete work item with a done state or next step.
-- `issue`: bug, incident, broken state, or risk needing attention.
-
-Choose the category that best preserves future recall intent. Do not use
-`decision` unless a choice was actually made.
-
-## Quality
-
-- Use the same language as the input content.
-- Prefer one dense sentence; use two only when ambiguity would otherwise remain.
-- Do not pad thin content or speculate beyond the source.
-- Do not name speakers or describe the conversation mechanics.
-- Keep technical identifiers verbatim.
-
-## Entries
-
-{{ENTRIES}}

package/defaults/mixdog-config.template.json

@@ -1,27 +0,0 @@
-{
-  "channels": {
-    "promptInjection": {
-      "mode": "claude_md",
-      "targetPath": "~/.claude/CLAUDE.md"
-    }
-  },
-  "memory": {
-    "enabled": true,
-    "user": { "title": "" },
-    "cycle1": { "interval": "10m" },
-    "cycle2": { "interval": "1h" }
-  },
-  "search": {
-    "enabled": true,
-    "rawSearch": {
-      "maxResults": 10,
-      "credentials": {
-        "firecrawl": { "apiKey": "" },
-        "tavily": { "apiKey": "" },
-        "exa": { "apiKey": "" }
-      }
-    },
-    "requestTimeoutMs": 120000,
-    "crawl": { "maxPages": 10, "maxDepth": 2, "sameDomainOnly": true }
-  }
-}

package/defaults/user-workflow.json

@@ -1,8 +0,0 @@
-{
-  "roles": [
-    { "name": "worker", "preset": "sonnet-high", "permission": "full" },
-    { "name": "heavy-worker", "preset": "opus-high", "permission": "full" },
-    { "name": "reviewer", "preset": "opus-xhigh", "permission": "full" },
-    { "name": "debugger", "preset": "opus-xhigh", "permission": "full" }
-  ]
-}

package/defaults/user-workflow.md

@@ -1,17 +0,0 @@
-Default roles:
-- Implementation → worker for clear, well-specified, mechanical changes of contained scope; heavy-worker when the brief is vague/open-ended or the change is bulk/multi-file. The axis is brief clarity + scope, not raw difficulty — a hard but well-specified, contained task still goes to worker. Pair either tier with a reviewer identically.
-- Verification → reviewer. Debugging → debugger.
-
-Who edits — delegate by default. Implementation and other state-changing edits go to a worker with a paired reviewer, even when the change looks small. The Lead edits directly only when all three hold: it already has full context from its own investigation, the change is genuinely small (a few lines across 1-2 files), and there is nothing else to parallelize. Lead-owned config and git work is always direct. When in doubt, or as soon as scope grows, delegate. A reviewer pairs 1:1 regardless of who made the edit.
-
-Cross-verification loop (1:1 worker↔reviewer pairing is the default):
-- The moment a worker finishes, first dispatch a reviewer scoped to its files, then immediately run the Lead self-check (syntax, diff, invariants) while the reviewer works. Parallel workers get parallel reviewers — reviews never queue behind one combined pass.
-- When workers touched interacting files, the Lead does one thin integration pass directly (a Lead self-check, not another dispatched reviewer) to catch cross-file effects. Never collapse the paired reviewers into a single combined review.
-- If a reviewer finds issues, dispatch a fix worker and re-pair it with a reviewer; repeat until every reviewer is clean ("ship-ready").
-- If an issue requires changing the plan/spec rather than just fixing a bug, halt and report to the user; resume only after the plan is updated.
-- Don't report completion before every reviewer's clean verdict. Mid-loop updates may share round/issue counts but must not claim done.
-
-Fan-out (dispatching N agents in parallel) is a shared technique any role can use — worker, reviewer, debugger, explore. Use a debugger when a bug's root cause is unclear; plain code search and location stay explore's (explorer) job.
-- For a hard bug (unknown cause, intermittent repro, multi-subsystem, or a fix worker's first attempt failed), fan out N debuggers, each investigating independently from a distinct angle (data flow, state/lifecycle, boundary/concurrency), blind to the others.
-- Each debugger only diagnoses — root cause, minimal repro, proposed fix — and never implements. The Lead converges the diagnoses (agreement raises confidence, divergence triggers a cross-check), then hands the agreed cause to a fix worker paired 1:1 with a reviewer.
-- Skip the fan-out for an obvious diff mistake — go straight to a fix worker.

package/hooks/hooks.json

@@ -1,73 +0,0 @@
-{
-  "description": "mixdog unified hooks",
-  "hooks": {
-    "SessionStart": [
-      {
-        "matcher": "startup|clear",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/shim-launcher.cjs\" --part=rules",
-            "timeout": 30
-          },
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/shim-launcher.cjs\" --part=core",
-            "timeout": 130
-          },
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/shim-launcher.cjs\" --part=recap",
-            "timeout": 130
-          }
-        ]
-      }
-    ],
-    "PreToolUse": [
-      {
-        "matcher": "^mcp__plugin_mixdog_(?:mixdog|trib-plugin)__(?!(?:read|list|glob|grep|code_graph|find_symbol|find_references|find_callers|explore|recall|search|fetch|web_fetch|schedule_status|list_models|job_wait|download_attachment)$)",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/shim-launcher.cjs\"",
-            "timeout": 10
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Edit|Write|MultiEdit|Bash|NotebookEdit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/shim-launcher.cjs\" --kind=post-tool",
-            "timeout": 5
-          }
-        ]
-      }
-    ],
-    "UserPromptSubmit": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/turn-timer.cjs\" start",
-            "timeout": 10
-          }
-        ]
-      }
-    ],
-    "Stop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/turn-timer.cjs\" stop",
-            "timeout": 10
-          }
-        ]
-      }
-    ]
-  }
-}

package/hooks/lib/active-instance.cjs

@@ -1,77 +0,0 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-const RUNTIME_ROOT = path.join(os.tmpdir(), 'mixdog');
-const ACTIVE_INSTANCE_FILE = path.join(RUNTIME_ROOT, 'active-instance.json');
-
-function parsePositivePid(value) {
-  const pid = Number(value);
-  return Number.isFinite(pid) && pid > 0 ? pid : null;
-}
-
-function readActiveInstance() {
-  try {
-    const active = JSON.parse(fs.readFileSync(ACTIVE_INSTANCE_FILE, 'utf8'));
-    return activeInstanceStaleReason(active) ? null : active;
-  } catch {
-    return null;
-  }
-}
-
-function getActiveOwnerPid(active) {
-  return parsePositivePid(active && active.ownerLeadPid)
-    || parsePositivePid(active && active.terminalLeadPid)
-    || parsePositivePid(active && active.supervisor_pid)
-    || parsePositivePid(active && active.instanceId);
-}
-
-function isPidAlive(pid) {
-  const n = parsePositivePid(pid);
-  if (!n) return false;
-  try {
-    process.kill(n, 0);
-    return true;
-  } catch (err) {
-    return err && err.code === 'EPERM';
-  }
-}
-
-function activeInstanceStaleReason(active) {
-  const ownerPid = getActiveOwnerPid(active);
-  if (!isPidAlive(ownerPid)) return `owner PID ${ownerPid || 'unknown'} is dead`;
-  const channelsPid = parsePositivePid(active && active.channels_pid);
-  if (channelsPid && !isPidAlive(channelsPid)) return `channels PID ${channelsPid} is dead`;
-  const workerPid = parsePositivePid(active && active.worker_pid);
-  if (workerPid && !isPidAlive(workerPid)) return `worker PID ${workerPid} is dead`;
-  const serverPid = parsePositivePid(active && active.server_pid);
-  if (serverPid && !isPidAlive(serverPid)) return `server PID ${serverPid} is dead`;
-  return '';
-}
-
-function getPermissionInstanceId(active) {
-  return getPermissionInstanceIds(active)[0] || '';
-}
-
-function getPermissionInstanceIds(active) {
-  const ids = [];
-  const ownerPid = parsePositivePid(active && active.ownerLeadPid)
-    || parsePositivePid(active && active.terminalLeadPid);
-  if (ownerPid) ids.push(String(ownerPid));
-  if (active && active.instanceId) ids.push(String(active.instanceId));
-  return [...new Set(ids.filter(Boolean))];
-}
-
-module.exports = {
-  ACTIVE_INSTANCE_FILE,
-  RUNTIME_ROOT,
-  activeInstanceStaleReason,
-  getActiveOwnerPid,
-  getPermissionInstanceId,
-  getPermissionInstanceIds,
-  isPidAlive,
-  parsePositivePid,
-  readActiveInstance,
-};