muonroi-cli 1.4.0 → 1.5.0

package/src/ui/slash/menu-items.ts

@@ -1,107 +0,0 @@
-/**
- * Slash command autocomplete menu — single source of truth.
- *
- * Extracted from app.tsx so:
- *  1. Tests can verify drift between this list and the runtime registry
- *     without importing the full Ink/React UI module.
- *  2. New slash commands have ONE place to register their menu entry.
- *
- * Built-in commands (exit, help, clear, compact, mcp, agents, sandbox, wallet,
- * models, sessions, commit-*, review, verify, skills, btw, update, debug-*,
- * ee-*) are NOT in the runtime registry — they are handled by legacy switch
- * statements in app.tsx and live here as the only definition.
- *
- * Registry-backed commands (route, plan, execute, discuss, expand, optimize,
- * debug, council, cost, ee, pin, ideal) MUST appear here too — the parity
- * test in __tests__/menu-parity.test.ts enforces this.
- */
-
-export interface SlashMenuItem {
-  id: string;
-  label: string;
-  description: string;
-  /**
-   * When true the command is still routable (typed in full + Enter still works,
-   * parity test still passes) but does NOT appear in the autocomplete dropdown
-   * or `/help` listing. Use to declutter the splash for commands that exist
-   * but are not part of the current "primary surface".
-   */
-  hidden?: boolean;
-}
-
-/**
- * Visible-by-default commands shown in the autocomplete dropdown.
- * Curated set per product decision (2026-05-21): keep only the primary
- * surface (exit, providers, compact, clear, ideal, council). Everything
- * else is `hidden: true` and still works when typed in full.
- *
- * To promote a hidden command back into the dropdown, remove `hidden: true`.
- * To add a new command, append here AND register its handler via
- * `registerSlash` (parity test enforces this).
- */
-export const SLASH_MENU_ITEMS: SlashMenuItem[] = [
-  // ── Primary surface ────────────────────────────────────────────────────
-  { id: "exit", label: "exit", description: "Quit the CLI" },
-  { id: "providers", label: "providers", description: "Manage providers + API keys (enable/disable, set default)" },
-  { id: "compact", label: "compact", description: "Compact conversation context" },
-  { id: "clear", label: "clear", description: "Clear conversation and start fresh" },
-  { id: "ideal", label: "ideal", description: "Product Ideal Loop — autonomous build from idea to ship" },
-  { id: "council", label: "council", description: "Multi-model adversarial debate" },
-  // ── Hidden (still functional when typed in full) ───────────────────────
-  { id: "help", label: "help", description: "Show available commands", hidden: true },
-  { id: "config", label: "config", description: "Open provider and council configuration", hidden: true },
-  { id: "remote-control", label: "remote-control", description: "Remote control", hidden: true },
-  { id: "agents", label: "agents", description: "Manage custom sub-agents", hidden: true },
-  { id: "schedule", label: "schedule", description: "View scheduled runs", hidden: true },
-  { id: "mcp", label: "mcp", description: "Manage MCP servers", hidden: true },
-  { id: "sandbox", label: "sandbox", description: "Select shell sandbox mode", hidden: true },
-  { id: "wallet", label: "wallet", description: "Wallet and payment settings", hidden: true },
-  { id: "models", label: "models", description: "Alias of /providers", hidden: true },
-  { id: "new", label: "new session", description: "Start a new session", hidden: true },
-  { id: "sessions", label: "sessions", description: "List recent sessions to resume", hidden: true },
-  { id: "commit-push", label: "commit & push", description: "Commit and push", hidden: true },
-  { id: "commit-pr", label: "commit & pr", description: "Commit and open PR", hidden: true },
-  { id: "review", label: "review", description: "Review recent changes", hidden: true },
-  { id: "verify", label: "verify", description: "Run local verification", hidden: true },
-  { id: "skills", label: "skills", description: "Manage skills", hidden: true },
-  { id: "btw", label: "btw", description: "Ask a side question without interrupting", hidden: true },
-  { id: "update", label: "update", description: "Update muonroi-cli to the latest version", hidden: true },
-  { id: "cost", label: "cost", description: "Show session cost breakdown", hidden: true },
-  { id: "ee", label: "ee", description: "Experience Engine status and controls", hidden: true },
-  { id: "route", label: "route", description: "Show current model routing info", hidden: true },
-  { id: "plan", label: "plan", description: "Show active GSD plan", hidden: true },
-  { id: "execute", label: "execute", description: "Execute active GSD plan", hidden: true },
-  { id: "discuss", label: "discuss", description: "Discuss phase gray areas", hidden: true },
-  { id: "expand", label: "expand", description: "Expand last compacted context", hidden: true },
-  { id: "optimize", label: "optimize", description: "Optimize prompt for token savings", hidden: true },
-  { id: "debug", label: "debug", description: "Toggle debug trace mode", hidden: true },
-  { id: "debug-on", label: "debug on", description: "Enable pipeline debug tracing", hidden: true },
-  { id: "debug-off", label: "debug off", description: "Disable pipeline debug tracing", hidden: true },
-  { id: "debug-status", label: "debug status", description: "Show session debug summary", hidden: true },
-  { id: "debug-last", label: "debug last", description: "Show last recorded trace", hidden: true },
-  {
-    id: "council-inspect",
-    label: "council inspect",
-    description: "Inspect a past council debate by session ID",
-    hidden: true,
-  },
-  { id: "pin", label: "pin", description: "Pin a user message so it survives compaction", hidden: true },
-  { id: "unpin", label: "unpin", description: "Remove a pinned message by sequence number", hidden: true },
-  { id: "pins", label: "pins", description: "List currently pinned message sequences", hidden: true },
-  { id: "ee-stats", label: "ee stats", description: "Knowledge base statistics", hidden: true },
-  { id: "ee-gates", label: "ee gates", description: "Quality gate checklist", hidden: true },
-  { id: "ee-evolve", label: "ee evolve", description: "Trigger EE evolution cycle", hidden: true },
-  { id: "ee-user", label: "ee user", description: "Current EE user identity", hidden: true },
-  { id: "ee-search", label: "ee search", description: "Semantic search across knowledge base", hidden: true },
-  { id: "ee-timeline", label: "ee timeline", description: "Principle evolution for a topic", hidden: true },
-  { id: "ee-graph", label: "ee graph", description: "Principle relationship graph", hidden: true },
-  { id: "ee-route", label: "ee route", description: "Route task to workflow", hidden: true },
-  { id: "ee-context-on", label: "ee-context on", description: "Enable BB-aware EE context injection", hidden: true },
-  { id: "ee-context-off", label: "ee-context off", description: "Disable BB-aware EE context injection", hidden: true },
-  { id: "ee-context-status", label: "ee-context status", description: "Show current BB-context setting", hidden: true },
-  { id: "export", label: "export", description: "Export entire conversation to a .txt file", hidden: true },
-  { id: "status", label: "status", description: "Show Agile sprint progress dashboard", hidden: true },
-];
-
-/** Items shown in the splash autocomplete + /help listing. */
-export const VISIBLE_SLASH_MENU_ITEMS: SlashMenuItem[] = SLASH_MENU_ITEMS.filter((m) => !m.hidden);

package/src/ui/slash/optimize.ts

@@ -1,47 +0,0 @@
-/**
- * src/ui/slash/optimize.ts
- *
- * /optimize slash command (PIL-07, D-14, D-16, D-17).
- * No-arg: prints last turn's layer-by-layer summary table.
- * Arg: runs PIL pipeline on given string and prints same table.
- *
- * Output format: plain-text, terminal-compatible, headless-safe (D-17 — no ANSI color).
- * Self-registers on module import.
- */
-
-import type { PipelineContext } from "../../pil/index.js";
-import { getPilLastResult, runPipeline } from "../../pil/index.js";
-import { getLastOutputMode } from "../../pil/store.js";
-import type { SlashHandler } from "./registry.js";
-import { registerSlash } from "./registry.js";
-
-function formatPilTable(ctx: PipelineContext): string {
-  const header = `Enriched prompt: ${ctx.enriched}`;
-  const style = `Output style: ${ctx.outputStyle ?? "(none)"}`;
-  const table = ctx.layers
-    .map((l) => `  ${l.name.padEnd(28)} applied=${l.applied ? "yes" : "no "}  delta=${l.delta ?? "(none)"}`)
-    .join("\n");
-
-  let metricsBlock = "";
-  if (ctx.metrics) {
-    const m = ctx.metrics;
-    metricsBlock = `\n\nMetrics:\n  total pipeline: ${m.totalMs}ms\n  input chars: ${m.inputChars}\n  output chars: ${m.outputChars}\n  L6 suffix input cost: ${m.suffixInstructionTokens} tok\n  layer timings:\n${m.layerTimings.map((t) => `    ${t.name.padEnd(28)} ${t.ms}ms`).join("\n")}`;
-  }
-
-  const outputMode = `Output mode: ${getLastOutputMode()}`;
-
-  return `${header}\n${style}\n${outputMode}\n\nLayer breakdown:\n${table}${metricsBlock}`;
-}
-
-export const handleOptimizeSlash: SlashHandler = async (args, _ctx) => {
-  const ctx = args.length > 0 ? await runPipeline(args.join(" ")) : getPilLastResult();
-
-  if (!ctx) {
-    return '/optimize: no prompt processed yet — run a prompt first, or provide a string: /optimize "your prompt"';
-  }
-
-  return formatPilTable(ctx);
-};
-
-// Self-register on module import (same pattern as cost.ts)
-registerSlash("optimize", handleOptimizeSlash);

package/src/ui/slash/pin.ts

@@ -1,41 +0,0 @@
-/**
- * /pin and /pins slash commands.
- *
- * /pin           — pins the most recent user message; survives compaction.
- * /pin <seq>     — pins a specific user message by sequence number.
- * /unpin <seq>   — removes a pin.
- * /pins          — lists currently pinned message sequences.
- *
- * Returns sentinel signals that app.tsx dispatches to the orchestrator,
- * since slash handlers don't hold an Orchestrator reference.
- */
-
-import type { SlashHandler } from "./registry.js";
-import { registerSlash } from "./registry.js";
-
-export const handlePinSlash: SlashHandler = async (args) => {
-  if (args.length === 0) {
-    return "__PIN_LAST__";
-  }
-  const seq = Number.parseInt(args[0] ?? "", 10);
-  if (!Number.isFinite(seq) || seq <= 0) {
-    return "Usage: /pin [<seq>]\n  /pin            pin the last user message\n  /pin <seq>      pin a specific message by sequence number";
-  }
-  return `__PIN_SEQ__\n${seq}`;
-};
-
-export const handleUnpinSlash: SlashHandler = async (args) => {
-  const seq = Number.parseInt(args[0] ?? "", 10);
-  if (!Number.isFinite(seq) || seq <= 0) {
-    return "Usage: /unpin <seq>";
-  }
-  return `__UNPIN_SEQ__\n${seq}`;
-};
-
-export const handlePinsListSlash: SlashHandler = async () => {
-  return "__PINS_LIST__";
-};
-
-registerSlash("pin", handlePinSlash);
-registerSlash("unpin", handleUnpinSlash);
-registerSlash("pins", handlePinsListSlash);

package/src/ui/slash/plan.ts

@@ -1,62 +0,0 @@
-/**
- * src/ui/slash/plan.ts
- *
- * /plan slash command handler (FLOW-06).
- * Gates on unresolved gray areas; writes plan to roadmap.md when unblocked.
- *
- * Self-registers on module import — call once from src/index.ts boot path
- * or import in test to trigger registration.
- */
-
-import { getActiveRunId, loadRun, updateRunFile } from "../../flow/run-manager.js";
-import { ensureFlowDir } from "../../flow/scaffold.js";
-import type { SlashHandler } from "./registry.js";
-import { registerSlash } from "./registry.js";
-
-/**
- * Extract open gray area entries from gray-areas.md content.
- * Returns array of matching lines like "G1 [open] Should we use X?"
- */
-function findOpenGrayAreas(content: string): string[] {
-  const lines = content.split("\n");
-  return lines.filter((line) => /^G\d+\s+\[open\]/.test(line.trim()));
-}
-
-export const handlePlanSlash: SlashHandler = async (args, ctx) => {
-  const flowDir = await ensureFlowDir(ctx.cwd);
-  const activeRunId = await getActiveRunId(flowDir);
-
-  if (!activeRunId) {
-    return "No active run. Start with /discuss.";
-  }
-
-  const run = await loadRun(flowDir, activeRunId);
-  if (!run) {
-    return `Error: active run ${activeRunId} not found on disk.`;
-  }
-
-  // Check for unresolved gray areas
-  const gaContent = run.grayAreas.sections.get("Gray Areas") ?? "";
-  const openAreas = findOpenGrayAreas(gaContent);
-
-  if (openAreas.length > 0) {
-    const entries = openAreas
-      .map(
-        (entry) =>
-          `${entry}\n   Resolution path: Ask user in /discuss or resolve in .muonroi-flow/runs/${activeRunId}/gray-areas.md`,
-      )
-      .join("\n\n");
-
-    return `/plan blocked: ${openAreas.length} unresolved gray areas\n\n${entries}\n\nResolve these before running /plan, or edit gray-areas.md directly.`;
-  }
-
-  // No open gray areas — write plan to roadmap.md
-  const planContent = args.join(" ");
-  run.roadmap.sections.set("Plan", planContent);
-  await updateRunFile(flowDir, activeRunId, "roadmap.md", run.roadmap);
-
-  return `Plan created for run ${activeRunId}.`;
-};
-
-// Self-register on module import
-registerSlash("plan", handlePlanSlash);

package/src/ui/slash/registry.ts

@@ -1,47 +0,0 @@
-/**
- * src/ui/slash/registry.ts
- *
- * Slash command registry — extensible by feature plans (Plan 06+ add commands).
- * Plan 06 wires dispatchSlash() into app.tsx alongside existing switch.
- */
-
-export interface SlashContext {
-  cwd: string;
-  tenantId: string;
-  lastPrompt?: string;
-  defaultProvider: string;
-  defaultModel: string;
-  sessionId?: string;
-  /**
-   * Returns the in-memory TUI scrollback (`messages` state in app.tsx). Used
-   * by /export to compare what was persisted to the DB against what the user
-   * actually saw on screen — they diverge when streaming chunks (council
-   * debate, tool traces) render to TUI but never get appended to `messages`
-   * as a ModelMessage. Optional so non-TUI callers (tests, MCP) can omit it.
-   */
-  getLiveEntries?: () => import("../../types/index.js").ChatEntry[];
-}
-
-export type SlashHandler = (args: string[], ctx: SlashContext) => Promise<string> | string;
-
-const registry = new Map<string, SlashHandler>();
-
-/** Register a slash command handler. */
-export function registerSlash(name: string, handler: SlashHandler): void {
-  registry.set(name, handler);
-}
-
-/**
- * Dispatch a slash command by name.
- * Returns null if command not registered (caller falls back to legacy switch).
- */
-export async function dispatchSlash(name: string, args: string[], ctx: SlashContext): Promise<string | null> {
-  const h = registry.get(name);
-  if (!h) return null;
-  return await h(args, ctx);
-}
-
-/** List all registered slash command names. */
-export function listSlashCommands(): string[] {
-  return [...registry.keys()];
-}

package/src/ui/slash/route.test.ts

@@ -1,82 +0,0 @@
-import { afterAll, beforeAll, beforeEach, describe, expect, it } from "vitest";
-import { type StubHandle, startStubEEServer } from "../../__test-stubs__/ee-server.js";
-import { createEEClient } from "../../ee/client.js";
-import { setDefaultEEClient } from "../../ee/intercept.js";
-import { midstreamPolicy } from "../../usage/midstream.js";
-import { dispatchSlash, listSlashCommands, registerSlash, type SlashContext } from "./registry.js";
-
-// Import route.ts to trigger self-registration
-import "./route.js";
-
-const CTX: SlashContext = {
-  cwd: "/tmp",
-  tenantId: "local",
-  defaultProvider: "anthropic",
-  defaultModel: "claude-3-5-sonnet-latest",
-  lastPrompt: "create file foo.ts",
-};
-
-describe("slash registry", () => {
-  it("registerSlash + dispatchSlash round-trip", async () => {
-    registerSlash("test-cmd", (_args, _ctx) => "test-result");
-    const result = await dispatchSlash("test-cmd", [], CTX);
-    expect(result).toBe("test-result");
-  });
-
-  it("dispatchSlash returns null for unregistered command", async () => {
-    const result = await dispatchSlash("nonexistent", [], CTX);
-    expect(result).toBeNull();
-  });
-
-  it("listSlashCommands includes route after import", () => {
-    const cmds = listSlashCommands();
-    expect(cmds).toContain("route");
-  });
-});
-
-describe("handleRouteSlash", () => {
-  let stub: StubHandle;
-
-  beforeAll(async () => {
-    // Stub EE with no handlers -> warm/cold both fail -> fallback path
-    stub = await startStubEEServer({});
-    setDefaultEEClient(createEEClient({ baseUrl: `http://localhost:${stub.port}` }));
-  });
-
-  afterAll(async () => {
-    await stub.stop();
-  });
-
-  beforeEach(() => {
-    midstreamPolicy.clear();
-  });
-
-  it("returns string containing tier, model, provider, reason", async () => {
-    const result = await dispatchSlash("route", ["create file x"], CTX);
-    expect(result).toBeTypeOf("string");
-    expect(result).toContain("Tier:");
-    expect(result).toContain("Provider:");
-    expect(result).toContain("Model:");
-    expect(result).toContain("Reason:");
-  });
-
-  it("uses lastPrompt when no args given", async () => {
-    const result = await dispatchSlash("route", [], CTX);
-    expect(result).toBeTypeOf("string");
-    expect(result).toContain("Tier:");
-  });
-
-  it("returns help text when no prompt and no lastPrompt", async () => {
-    const noPromptCtx = { ...CTX, lastPrompt: undefined };
-    const result = await dispatchSlash("route", [], noPromptCtx);
-    expect(result).toContain("/route:");
-    expect(result).toContain("no recent prompt");
-  });
-
-  it("includes cap-driven note when cap_overridden", async () => {
-    // Force midstream refuse -> decide will set cap_overridden
-    midstreamPolicy.forceRefuseNext();
-    const result = await dispatchSlash("route", ["create file x"], CTX);
-    expect(result).toContain("Cap-driven");
-  });
-});

package/src/ui/slash/route.ts

@@ -1,43 +0,0 @@
-/**
- * src/ui/slash/route.ts
- *
- * /route slash command handler (ROUTE-05).
- * Prints next-prompt routing decision: tier, model, provider, reason.
- * Includes cap-driven note when cap_overridden is true.
- *
- * Self-registers on module import — call once from src/index.ts boot path
- * or import in test to trigger registration.
- */
-
-import { decide } from "../../router/decide.js";
-import type { SlashHandler } from "./registry.js";
-import { registerSlash } from "./registry.js";
-
-export const handleRouteSlash: SlashHandler = async (args, ctx) => {
-  const prompt = args.join(" ") || ctx.lastPrompt || "";
-  if (!prompt) {
-    return "/route: no recent prompt — type a prompt first or pass it as argument: /route <prompt>";
-  }
-
-  const d = await decide(prompt, {
-    tenantId: ctx.tenantId,
-    cwd: ctx.cwd,
-    defaultModel: ctx.defaultModel,
-    defaultProvider: ctx.defaultProvider,
-  });
-
-  const lines = [`Tier:     ${d.tier}`, `Provider: ${d.provider}`, `Model:    ${d.model}`, `Reason:   ${d.reason}`];
-
-  if (typeof d.confidence === "number") {
-    lines.push(`Confidence: ${d.confidence.toFixed(2)}`);
-  }
-
-  if (d.cap_overridden) {
-    lines.push(`Cap-driven: yes (downgrade applied)`);
-  }
-
-  return lines.join("\n");
-};
-
-// Self-register on module import
-registerSlash("route", handleRouteSlash);

package/src/ui/slash/status.ts

@@ -1,36 +0,0 @@
-/**
- * src/ui/slash/status.ts
- *
- * /status slash command — renders a ProgressSnapshot markdown card.
- *
- * Reads backlog.json + sprint-plan.json + interaction_logs for the current
- * runId and productSlug. Falls back gracefully when no active run exists.
- *
- * Self-registers on module import.
- */
-
-import { computeProgressSnapshot, renderSnapshotMarkdown } from "../../product-loop/progress-snapshot.js";
-import type { SlashHandler } from "./registry.js";
-import { registerSlash } from "./registry.js";
-
-export const handleStatusSlash: SlashHandler = async (_args, ctx) => {
-  // Resolve flowDir from cwd — the planning directory convention.
-  const flowDir = `${ctx.cwd}/.planning`;
-  const runId = ctx.sessionId ?? "";
-  // productSlug: try to read from sessionId or fall back to cwd basename.
-  const productSlug = ctx.cwd ? (ctx.cwd.split(/[/\\]/).filter(Boolean).pop() ?? "unknown") : "unknown";
-
-  if (!runId) {
-    return "No active run. Start `/ideal` first.";
-  }
-
-  try {
-    const snapshot = await computeProgressSnapshot({ flowDir, runId, productSlug });
-    return renderSnapshotMarkdown(snapshot);
-  } catch (err) {
-    return `Error computing status: ${(err as Error).message}`;
-  }
-};
-
-// Self-register on module import
-registerSlash("status", handleStatusSlash);

package/src/ui/state/active-run.ts

@@ -1,56 +0,0 @@
-/**
- * src/ui/state/active-run.ts
- *
- * Singleton store tracking the currently-active /ideal run.
- * Used by StatusBar (B1) and the reporter auto-fire observer (B2).
- *
- * Lifecycle:
- *  - setActiveRunId() called when sprint-plan-committed fires
- *  - clearActiveRunId() called when the run ends (shipped / halted)
- *  - Subscribers receive the new runId (or null) on every change
- */
-
-export interface ActiveRunState {
-  runId: string | null;
-  flowDir: string | null;
-  productSlug: string | null;
-}
-
-type Listener = (state: ActiveRunState) => void;
-
-function makeActiveRunStore() {
-  let state: ActiveRunState = {
-    runId: null,
-    flowDir: null,
-    productSlug: null,
-  };
-  const listeners = new Set<Listener>();
-
-  return {
-    getState: (): ActiveRunState => state,
-
-    setActiveRun: (runId: string, flowDir: string, productSlug: string): void => {
-      state = { runId, flowDir, productSlug };
-      for (const l of listeners) l(state);
-    },
-
-    clearActiveRun: (): void => {
-      state = { runId: null, flowDir: null, productSlug: null };
-      for (const l of listeners) l(state);
-    },
-
-    subscribe: (fn: Listener): (() => void) => {
-      listeners.add(fn);
-      return () => {
-        listeners.delete(fn);
-      };
-    },
-  };
-}
-
-export const activeRunStore = makeActiveRunStore();
-
-/** Test helper: reset to initial state. */
-export function __resetActiveRunStoreForTests(): void {
-  activeRunStore.clearActiveRun();
-}