mixdog 0.7.17 → 0.8.0

package/setup/tui.mjs

@@ -1,325 +0,0 @@
-/**
- * Zero-dependency clack-style terminal UI helpers for mixdog setup/install.
- * Node built-ins only; assumes an interactive TTY when prompts are used.
- */
-import { emitKeypressEvents } from 'node:readline';
-
-const stdin = process.stdin;
-const stdout = process.stdout;
-
-const ansi = {
-  reset: '\x1b[0m',
-  hideCursor: '\x1b[?25l',
-  showCursor: '\x1b[?25h',
-  cyan: '\x1b[36m',
-  green: '\x1b[32m',
-  red: '\x1b[31m',
-  dim: '\x1b[2m',
-  bold: '\x1b[1m',
-  inverse: '\x1b[7m',
-};
-
-const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
-
-const STRIP_ANSI_RE = /\x1b\[[0-9;]*m/g;
-const STRIP_OSC_RE = /\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)/g;
-const GRAPHEME_SEGMENTER = new Intl.Segmenter(undefined, { granularity: 'grapheme' });
-
-function assertInteractiveTTY() {
-  if (!stdin.isTTY) {
-    throw new Error('setup/tui.mjs: stdin must be a TTY');
-  }
-}
-
-function gutter() {
-  return `${ansi.dim}│${ansi.reset}`;
-}
-
-function railEnd() {
-  return gutter();
-}
-
-/** Global key legend pinned at the bottom of every prompt (outside the rail). */
-const NAV_LEGEND = 'Enter confirm · Ctrl+C quit';
-function navLegendRow() {
-  return `  ${ansi.dim}${NAV_LEGEND}${ansi.reset}`;
-}
-
-function prefixGlyph(done) {
-  return done
-    ? `${ansi.green}✓${ansi.reset}`
-    : `${ansi.cyan}◆${ansi.reset}`;
-}
-
-function codePointsOf(segment) {
-  const cps = [];
-  for (const ch of segment) {
-    cps.push(ch.codePointAt(0));
-  }
-  return cps;
-}
-
-function isCombiningOrZeroWidth(cp) {
-  if (cp >= 0x0300 && cp <= 0x036f) return true;
-  if (cp >= 0x0483 && cp <= 0x0489) return true;
-  if (cp >= 0x0591 && cp <= 0x05bd) return true;
-  if (cp >= 0x064b && cp <= 0x065f) return true;
-  if (cp === 0x0670) return true;
-  if (cp >= 0x06d6 && cp <= 0x06dc) return true;
-  if (cp >= 0x1ab0 && cp <= 0x1aff) return true;
-  if (cp >= 0x1dc0 && cp <= 0x1dff) return true;
-  if (cp >= 0x20d0 && cp <= 0x20ff) return true;
-  if (cp >= 0xfe20 && cp <= 0xfe2f) return true;
-  if (cp === 0x200b || cp === 0x200d) return true;
-  if (cp >= 0xfe00 && cp <= 0xfe0f) return true;
-  return false;
-}
-
-function isWideBaseChar(cp) {
-  if (cp >= 0x1100 && cp <= 0x115f) return true;
-  if (cp >= 0x2e80 && cp <= 0x303e) return true;
-  if (cp >= 0x3041 && cp <= 0x33ff) return true;
-  if (cp >= 0x3400 && cp <= 0x4dbf) return true;
-  if (cp >= 0x4e00 && cp <= 0x9fff) return true;
-  if (cp >= 0xa000 && cp <= 0xa4cf) return true;
-  if (cp >= 0xac00 && cp <= 0xd7a3) return true;
-  if (cp >= 0xf900 && cp <= 0xfaff) return true;
-  if (cp >= 0xfe30 && cp <= 0xfe4f) return true;
-  if (cp >= 0xff00 && cp <= 0xff60) return true;
-  if (cp >= 0xffe0 && cp <= 0xffe6) return true;
-  if (cp >= 0x1f300) return true;
-  if (cp >= 0x20000 && cp <= 0x3fffd) return true;
-  return false;
-}
-
-function graphemeClusterWidth(segment) {
-  const cps = codePointsOf(segment);
-  if (cps.length === 0) return 0;
-  if (cps.every(isCombiningOrZeroWidth)) return 0;
-
-  const hasFe0f = cps.some((cp) => cp >= 0xfe00 && cp <= 0xfe0f);
-  const hasZwj = cps.includes(0x200d);
-  const hasRegional = cps.some((cp) => cp >= 0x1f1e6 && cp <= 0x1f1ff);
-  const hasModifier = cps.some((cp) => cp >= 0x1f3fb && cp <= 0x1f3ff);
-  const hasWideBase = cps.some((cp) => isWideBaseChar(cp));
-
-  if (hasFe0f || hasZwj || hasRegional || hasModifier || hasWideBase) return 2;
-  return 1;
-}
-
-function cellWidth(str) {
-  const plain = str.replace(STRIP_OSC_RE, '').replace(STRIP_ANSI_RE, '');
-  let width = 0;
-  for (const { segment } of GRAPHEME_SEGMENTER.segment(plain)) {
-    width += graphemeClusterWidth(segment);
-  }
-  return width;
-}
-
-function lineCount(text) {
-  if (!text) return 0;
-  const cols = stdout.columns || 80;
-  const logical = text.split('\n');
-  let total = 0;
-  for (const line of logical) {
-    const visible = cellWidth(line);
-    total += Math.max(1, Math.ceil(visible / cols));
-  }
-  return total;
-}
-
-function writeBlock(text) {
-  stdout.write(text.endsWith('\n') ? text : `${text}\n`);
-}
-
-function redrawUp(lines) {
-  if (lines > 0) {
-    stdout.write(`\x1b[${lines}A\x1b[0J`);
-  }
-}
-
-function finishPrompt(lines, finalLine) {
-  redrawUp(lines);
-  stdout.write(`${ansi.green}✓${ansi.reset} ${finalLine}\n`);
-  stdout.write(`${gutter()}\n`);
-}
-
-/**
- * @param {(ctx: {
- *   rerender: (draw: () => string) => void,
- *   onKey: (fn: (str: string, key: import('node:readline').Key) => boolean | void) => void,
- * }) => Promise<unknown>} run
- */
-async function withRawPrompt(run) {
-  assertInteractiveTTY();
-  const wasRaw = stdin.isRaw;
-  const wasPaused = stdin.isPaused();
-  let paintedLines = 0;
-  let keyHandler = null;
-  let settled = false;
-  let activePromptReject = null;
-
-  const promptReject = (rejectFn) => {
-    activePromptReject = rejectFn;
-  };
-
-  const rerender = (draw) => {
-    redrawUp(paintedLines);
-    const block = draw();
-    writeBlock(block);
-    paintedLines = lineCount(block);
-  };
-
-  const onKey = (fn) => {
-    keyHandler = fn;
-  };
-
-  const cleanup = () => {
-    if (settled) return;
-    settled = true;
-    stdin.removeListener('keypress', onKeypress);
-    try {
-      stdin.setRawMode(!!wasRaw);
-    } catch {
-      stdin.setRawMode(false);
-    }
-    if (wasPaused) {
-      stdin.pause();
-    }
-    stdout.write(ansi.showCursor);
-  };
-
-  const onKeypress = (str, key) => {
-    if (!key) return;
-    if (key.ctrl && key.name === 'c') {
-      cleanup();
-      redrawUp(paintedLines);
-      stdout.write('\n');
-      process.exit(130);
-    }
-    if (keyHandler) {
-      try {
-        keyHandler(str, key || {});
-      } catch (err) {
-        cleanup();
-        if (activePromptReject) {
-          const rej = activePromptReject;
-          activePromptReject = null;
-          rej(err);
-        }
-      }
-    }
-  };
-
-  try {
-    emitKeypressEvents(stdin);
-    stdin.setRawMode(true);
-    stdin.resume();
-    stdout.write(ansi.hideCursor);
-    stdin.on('keypress', onKeypress);
-    return await run({ rerender, onKey, promptReject });
-  } finally {
-    cleanup();
-  }
-}
-
-/**
- * @param {string} message
- * @param {{ initial?: boolean }} [opts]
- */
-export async function confirm(message, { initial = false } = {}) {
-  let value = !!initial;
-
-  return withRawPrompt(async ({ rerender, onKey, promptReject }) => {
-    const draw = () => {
-      const yes = value
-        ? `${ansi.cyan}${ansi.inverse} Yes ${ansi.reset}`
-        : `${ansi.dim}Yes${ansi.reset}`;
-      const no = !value
-        ? `${ansi.cyan}${ansi.inverse} No ${ansi.reset}`
-        : `${ansi.dim}No${ansi.reset}`;
-      return [
-        `${prefixGlyph(false)} ${message}`,
-        gutter(),
-        `${gutter()} ${yes} / ${no}`,
-        railEnd(),
-        navLegendRow(),
-      ].join('\n');
-    };
-
-    rerender(draw);
-
-    return new Promise((resolve, reject) => {
-      promptReject(reject);
-      onKey((str, key) => {
-        const name = key.name;
-        if (name === 'y') {
-          value = true;
-          rerender(draw);
-          return;
-        }
-        if (name === 'n') {
-          value = false;
-          rerender(draw);
-          return;
-        }
-        if (name === 'return') {
-          const label = value ? 'Yes' : 'No';
-          finishPrompt(
-            lineCount(draw()),
-            `${message} ${ansi.dim}· ${label}${ansi.reset}`,
-          );
-          resolve(value);
-        }
-      });
-    });
-  });
-}
-
-/**
- * @param {string} message
- */
-export function outro(message) {
-  writeBlock(gutter());
-  writeBlock(`${ansi.green}└${ansi.reset}  ${message}`);
-}
-
-/**
- * @param {string} message
- */
-export function createSpinner(message) {
-  let frame = 0;
-  let current = message;
-  let timer = null;
-  let stopped = false;
-
-  const tick = () => {
-    const glyph = SPINNER_FRAMES[frame % SPINNER_FRAMES.length];
-    frame += 1;
-    stdout.write(`\r${ansi.cyan}${glyph}${ansi.reset} ${current}`);
-  };
-
-  timer = setInterval(tick, 80);
-  tick();
-
-  return {
-    update(msg) {
-      if (stopped) return;
-      current = String(msg ?? '');
-      tick();
-    },
-    stop(finalMsg, ok = true) {
-      if (stopped) return;
-      stopped = true;
-      if (timer) clearInterval(timer);
-      stdout.write('\r\x1b[2K');
-      const tail = finalMsg ? ` ${finalMsg}` : '';
-      if (ok) {
-        stdout.write(`${ansi.green}✓${ansi.reset} ${current}${tail}\n`);
-        return;
-      }
-      const mark = `${ansi.red}✖${ansi.reset}`;
-      stdout.write(`${mark} ${current}${tail}\n`);
-    },
-  };
-}

package/skills/retro-skill-proposer/SKILL.md

@@ -1,92 +0,0 @@
----
-name: retro-skill-proposer
-description: Use ONLY during the Retro phase of a Plan/Execute/Verify/Ship/Retro workflow to evaluate whether the completed session produced a reusable pattern worth saving as a skill draft. Never triggers during other phases. Skip if session was trivial or no distinctive pattern emerged. User-approval gated — never saves without explicit OK.
-version: 0.1.0
----
-
-# Retro Skill Proposer
-
-## When to invoke
-
-Only at the Retro phase of the `Plan -> Execute -> Verify -> Ship -> Retro` workflow. Never during Plan/Execute/Verify/Ship. If the session did not follow this workflow at all (pure Q&A, quick lookup, etc.), do not invoke.
-
-Skip entirely when any of:
-- Fewer than 5 tool calls in session
-- Pure reading / research with no state change
-- No distinctive pattern emerged
-- An existing skill already covers the pattern (check `~/.claude/skills/`, `~/.claude/skills/auto/`, `~/.claude/skills/auto-drafts/`, plugin bundled skills)
-
-## Trigger conditions (ANY ONE is sufficient)
-
-1. **Complex success** — a 5+ tool call workflow completed successfully
-2. **Error recovery** — got past an error and found a working path
-3. **User correction** — user revealed a better approach mid-session
-4. **Novel sequence** — a non-obvious reusable tool chain worth remembering
-
-## Procedure
-
-1. **Silent scan** — review the current session's tool calls, decisions, user corrections. Do NOT narrate this step.
-2. **Match conditions** — evaluate against the four trigger conditions above.
-3. **Dedup check** — compare the candidate pattern against existing skills in:
-   - `~/.claude/skills/` (user global)
-   - `~/.claude/skills/auto/` (auto-generated, promoted)
-   - `~/.claude/skills/auto-drafts/` (auto-generated, pending)
-   - plugin bundled skills
-4. **Propose** — if eligible and non-duplicate, write a concise proposal in the user's configured language:
-   - Skill name (slug form)
-   - Which trigger condition matched
-   - When to invoke the skill
-   - Procedure (step by step)
-   - Verification method
-   - Why this is worth saving (1-2 sentences)
-5. **Wait for user approval** — the user MUST explicitly say "save" or equivalent. Silence or ambiguity means skip.
-6. **On approval** — use the `write` tool to create:
-   - `~/.claude/skills/auto-drafts/{name}/SKILL.md` with proper frontmatter (name, description, version: 0.1.0)
-   - Include the full procedure in markdown body
-7. **On skip or rejection** — leave no trace, no explanation needed. Continue the Retro normally.
-
-## Non-goals
-
-- Do NOT propose for every session
-- Do NOT save without explicit user approval
-- Do NOT duplicate existing skills
-- Do NOT modify CLAUDE.md or bridge common instructions
-- Do NOT propose during Plan/Execute/Verify/Ship phases
-- Do NOT force-inject the skill into future sessions — saved drafts sit dormant until the LLM naturally picks them up via Progressive Disclosure
-
-## SKILL.md frontmatter template for the draft
-
-```yaml
----
-name: <slug-form-name>
-description: <one-line trigger description; keep under 200 chars; lead with "Use when..."; be specific about conditions so the LLM can match accurately>
-version: 0.1.0
-source: retro-skill-proposer
-session: <current session id or date>
----
-```
-
-## Proposal output format (to the user, in their configured language)
-
-```
-Proposed skill: {name}
-Trigger: {which of the 4 conditions matched}
-When to use: {when to invoke this skill}
-
-Procedure:
-1. ...
-2. ...
-3. ...
-
-Verification: {how to confirm the skill worked}
-
-Why it is worth saving: {1-2 sentences}
-
-On approval, save to ~/.claude/skills/auto-drafts/{name}/SKILL.md.
-```
-
-## Verification
-
-After saving, confirm the file exists at the expected path and the frontmatter parses cleanly. Do not auto-test the skill — it sits as a draft until:
-- A batch run promotes it to `auto/` after frequency validation, OR
-- The user manually moves it to `~/.claude/skills/`

package/skills/schedule-add/SKILL.md

@@ -1,77 +0,0 @@
----
-name: schedule-add
-description: Invoke when the user's intent is to register a new recurring/cron-style task in mixdog so the scheduler fires it on a future cadence. Writes a new entry under `${CLAUDE_PLUGIN_DATA}/schedules/<name>/` and reloads the channels config. Do not invoke for one-shot in-session reminders (use `/loop`) or for inspecting existing schedules.
-version: 0.3.0
----
-
-# schedule-add
-
-Register a new schedule item in mixdog.
-
-## When to invoke
-
-User intent: register a new recurring task in the mixdog scheduler. The trigger is the intent, not specific phrasing — invoke whenever the user is asking for a future-cadence task that should persist across sessions.
-
-Skip if the user only wants a one-shot run within the current session (use `/loop` for that), or asks to *list* existing schedules (just read the directory directly).
-
-## Routing model (channel presence — no `type`)
-
-A schedule with **no `channel`** is injected into the current (Lead) session when it fires — the session handles it with full context, like a webhook. A schedule **with a `channel`** is dispatched directly to that Discord channel by a standalone LLM (so it needs a `model`). Channel presence is the only switch; there is no `type` field. `src/channels/lib/config.mjs` buckets entries by `!!channel`.
-
-A channel-direct schedule that fires with nothing worth posting can suppress its own notification: emit `[meta:silent]` as the **first line** of the response and the turn/post is skipped (Discord still gets the body for audit). Mention this in `instructions.md` when the task is a conditional "only ping if X". See `rules/bridge/20-skip-protocol.md`.
-
-## Storage contract
-
-The on-disk schema MUST match what `setup-server` (POST /schedules) writes, because the scheduler reader (`src/channels/lib/scheduler.mjs`) and the setup UI consume the same `config.json` shape. Drift silently disables the entry: `scheduler.mjs` skips cron registration when `time` is absent.
-
-## Required fields
-
-Collect from the user message; ask only for the truly missing ones in plain text (no AskUserQuestion).
-
-| Field | Required | Default | Notes |
-|---|---|---|---|
-| `name` | yes | — | slug `[a-z0-9-]+`, becomes directory name |
-| `time` | yes | — | 5- or 6-field cron expression ONLY (e.g. `0 9 * * *`). Legacy formats (`HH:MM`, `every<N>m`, `hourly`, `daily`) are rejected by the scheduler — translate them: daily 09:00 = `0 9 * * *`; every 15 min = `*/15 * * * *`; weekday 18:00 = `0 18 * * 1-5` |
-| `timezone` | no | `Asia/Seoul` | IANA name; used by node-cron and the DND / holiday guards |
-| `days` | no | `daily` | `daily` / `weekday` / `weekend` |
-| `channel` | no | — (inject to current session) | set to a Discord channel label to dispatch DIRECT to that channel instead of injecting |
-| `model` | conditional | — | REQUIRED when `channel` is set (direct dispatch runs a standalone LLM preset, e.g. `haiku`). Omit when injecting — the session handles it, no preset needed. |
-| `enabled` | no | `true` | omit unless the user explicitly wants the entry pre-disabled (reader filters `enabled !== false`) |
-| `instructions` | yes | — | what the schedule should do when it fires (markdown body) |
-
-## Procedure
-
-1. Parse the user's request. Extract whatever is unambiguous (name, time, channel, instructions). For missing required fields ask in one short message; do NOT proceed with partial data.
-2. Validate:
-   - `name` matches `^[a-z0-9][a-z0-9-]*$`, length ≤ 64
-   - `time` is a valid 5- or 6-field cron expression. Legacy formats (`HH:MM`, `every<N>m`, `hourly`, `daily`) are NOT accepted — convert the user's phrasing to cron before writing
-   - if `channel` is set, `model` MUST also be set (direct dispatch has no preset fallback)
-   - target directory `${CLAUDE_PLUGIN_DATA}/schedules/<name>/` does NOT already exist (if it does, ask user whether to overwrite or rename)
-3. Create directory + write two files atomically (tmp + rename):
-   - `config.json` — omit fields that equal their default; NEVER write `type`:
-     ```json
-     // inject into current session (no channel)
-     { "time": "0 9 * * *" }
-
-     // direct to a channel (channel + model required)
-     { "time": "0 9 * * *", "channel": "main", "model": "haiku" }
-     ```
-   - `instructions.md`: the user-provided body as-is.
-4. Call `mcp__plugin_mixdog_mixdog__reload_config` to re-register schedules.
-5. Call `mcp__plugin_mixdog_mixdog__schedule_status` and confirm the new entry appears.
-6. Report back to the user in their configured language with: name, next fire (local time), and where it goes (current session vs which channel). One short paragraph; no bullet padding.
-
-## Failure handling
-
-- File write error → report path:error, do not retry blindly.
-- `reload_config` error → file is written but not live; tell user to restart Claude Code or rerun.
-- `schedule_status` missing the new entry → `time` expression rejected; show the raw status response.
-
-## Anti-patterns
-
-- Do not invent a `time` value when the cadence the user gave is ambiguous — ask for a specific time.
-- Do not write a legacy `time` format (`HH:MM` / `every<N>m` / `hourly` / `daily`) — the scheduler rejects it and the entry never registers; always convert to a cron expression.
-- Do not auto-overwrite an existing schedule with the same name without explicit confirmation.
-- Do not skip the `reload_config` + `schedule_status` round trip; without it the user has no proof of registration.
-- Do not write a `type` / `cron` / `mode` / `role` key. Routing is decided purely by `channel` presence; the scheduler reader does not consume those keys. Use `time` (+ optional `channel`/`model`) only.
-- Do not set `channel` without `model` — direct dispatch is rejected with no LLM preset.