catherd-cli 1.4.0 → 2.0.0-beta.20261022113309

package/src/entry/tui/fixtures.ts

@@ -1,637 +0,0 @@
-import type { OrchestrationHost } from "../../domain/host.ts";
-import { sessionKey } from "../../domain/host.ts";
-import { isDeepStrictEqual } from "node:util";
-import {
-  applyPatch,
-  defaultProfileDoc,
-  diffProfiles,
-  type ProfileDoc,
-  resolveProfile,
-} from "../../domain/profile.ts";
-import { repairs, validateProfile } from "../../domain/profile-rules.ts";
-import { catalogQuery, loadCatalog } from "../../services/catalog-service.ts";
-import type { RunRecord } from "../../domain/record.ts";
-import type { DoctorReport } from "../../services/doctor.ts";
-import type { RunSummary } from "../../services/summary.ts";
-import {
-  CHANGED_ON_DISK,
-  type Effects,
-  type RoleDetail,
-  type RoleRow,
-  rowOf,
-  rungDetailOf,
-  type SessionRow,
-  type SessionRun,
-  suggestFor,
-} from "./effects.ts";
-import { withStaged } from "./profile-tree.ts";
-
-/**
- * Fixed data for the storybook (CATHERD_STORY=1), the frame snapshots and the view tests: a setup with
- * one backend missing and one not logged in, two runs (one live), and profiles kept in memory. Only
- * the catalog is the shipped one, read through the catalog service.
- */
-export const FIXTURE_REPORT: DoctorReport = {
-  host: { host: "unknown", session: null, conflict: null },
-  queue: null,
-  push: null,
-  ready: false,
-  version: "1.0.0",
-  checks: [
-    { id: "bun", label: "Bun", state: "ok", word: "ready", detail: "1.4.2" },
-    { id: "config", label: "config", state: "ok", word: "ready", detail: "active profile default" },
-    { id: "profile", label: "profile default", state: "ok", word: "ready", detail: "valid" },
-    {
-      id: "backend:codex",
-      label: "codex",
-      state: "ok",
-      word: "ready",
-      detail: "0.156.1, logged in, 14 models",
-    },
-    {
-      id: "backend:claude-code",
-      label: "claude-code",
-      state: "ok",
-      word: "ready",
-      detail: "2.1.282, logged in, 6 models",
-    },
-    {
-      id: "backend:opencode",
-      label: "opencode",
-      state: "warn",
-      word: "not logged in",
-      detail: "2.0.16 (a failover stand-in uses it)",
-      fix: "opencode auth login",
-    },
-    {
-      id: "jev",
-      label: "Jev",
-      state: "skip",
-      word: "no key",
-      detail: "optional: routing uses the lane files",
-    },
-    {
-      id: "plugin",
-      label: "Claude Code plugin",
-      state: "fail",
-      word: "missing",
-      detail: "not installed",
-      fix: "claude plugin marketplace add 47vigen/catherd && claude plugin install catherd@catherd",
-    },
-    { id: "agents", label: "Claude agents", state: "ok", word: "ready", detail: "2 linked" },
-    { id: "mcp", label: "MCP server", state: "ok", word: "ready", detail: "21 tools" },
-  ],
-};
-
-const summary = (o: Partial<RunSummary> & Pick<RunSummary, "id" | "title">): RunSummary => ({
-  delivery: [],
-  repo: "/home/me/app",
-  createdAt: "2026-09-26T11:48:00.000Z",
-  session: null,
-  continuedIn: null,
-  stateTail: [],
-  live: [],
-  totals: {
-    runs: 0,
-    ok: 0,
-    notOk: [],
-    tokens: { input: 0, cached: 0, output: 0 },
-    costUsd: 0,
-    wallMinutes: 12,
-  },
-  agents: { runs: 0, totalTokens: 0, costUsd: 0 },
-  jev: { decisions: 0, fallbacks: 0 },
-  harness: [],
-  budget: null,
-  milestones: [],
-  verifier: null,
-  questions: [],
-  warnings: [],
-  ...o,
-});
-
-const JOBS = "20260926-114800-jobs-screen";
-const AUTH = "20260925-090000-auth-refactor";
-const PLAN4 = "20260924-080000-auth-plan-4";
-
-const FIXTURE_RUNS: RunSummary[] = [
-  summary({
-    id: JOBS,
-    title: "Jobs screen",
-    session: {
-      host: "claude-code",
-      sessionId: "s-jobs",
-      hostSessionId: null,
-      name: "jobs screen",
-      live: true,
-    },
-    stateTail: ["M1 in review", "Next: fix round for M1.L2"],
-    live: [
-      {
-        name: "worker-M1.L2",
-        rung: "codex:gpt-6-sol#medium",
-        state: "running",
-        secs: 252,
-        dispatchId: "d2",
-      },
-      { name: "reviewer-M1", rung: "codex:gpt-6-sol#high", state: "starting", secs: 4, dispatchId: "d3" },
-    ],
-    totals: {
-      runs: 3,
-      ok: 3,
-      notOk: [],
-      tokens: { input: 812_000, cached: 640_000, output: 41_000 },
-      costUsd: 0,
-      wallMinutes: 12,
-    },
-    jev: { decisions: 2, fallbacks: 0 },
-    budget: { fraction: 0.52, minutes: { spent: 31, cap: 60 } },
-    milestones: ["M0 | scaffold the jobs screen | 3f2a9c1 | 9 | bun test test/jobs"],
-  }),
-  summary({
-    id: AUTH,
-    title: "Auth refactor",
-    repo: "/home/me/api",
-    createdAt: "2026-09-25T09:00:00.000Z",
-    session: {
-      host: "claude-code",
-      sessionId: "s-auth",
-      hostSessionId: null,
-      name: "auth build",
-      live: false,
-    },
-    continuedIn: "kit follow-up",
-    stateTail: ["Next: done"],
-    totals: {
-      runs: 9,
-      ok: 8,
-      notOk: ["worker-M2.L1 (limit)"],
-      tokens: { input: 3_100_000, cached: 2_400_000, output: 160_000 },
-      costUsd: 1.84,
-      wallMinutes: 96,
-    },
-    milestones: ["M1 | tokens | a1 | 30 | ok", "M2 | sessions | b2 | 41 | ok", "M3 | cleanup | c3 | 25 | ok"],
-  }),
-];
-
-/** A role of the fixtures; `since` minutes before the fixed clock (2026-09-26 12:00 UTC) for a live one. */
-const role = (o: Partial<RoleRow> & Pick<RoleRow, "run" | "dispatchId" | "name" | "rung">): RoleRow => ({
-  role: o.name.split("-")[0] ?? "worker",
-  status: "ok",
-  live: false,
-  since: "2026-09-26T11:48:10.000Z",
-  secs: null,
-  lastEvent: null,
-  replyStatus: "complete",
-  ...o,
-});
-
-const auth = (continued: SessionRun["continued"]): SessionRun => ({
-  id: AUTH,
-  title: "Auth refactor",
-  repo: "/home/me/api",
-  createdAt: "2026-09-25T09:00:00.000Z",
-  continued,
-  continuedIn: continued === "elsewhere" ? "kit follow-up" : null,
-  budget: null,
-  milestones: [
-    { name: "M1", landed: true, what: "tokens" },
-    { name: "M2", landed: true, what: "sessions" },
-    { name: "M3", landed: true, what: "cleanup" },
-  ],
-  roles: [
-    role({ run: AUTH, dispatchId: "a3", name: "reviewer-M3", rung: "codex:gpt-6-sol#high", secs: 188 }),
-    role({ run: AUTH, dispatchId: "a2", name: "worker-M3.L1", rung: "codex:gpt-6-luna#high", secs: 402 }),
-    role({
-      run: AUTH,
-      dispatchId: "a1",
-      name: "worker-M2.L1",
-      rung: "codex:gpt-6-sol#medium",
-      status: "limit",
-      secs: 95,
-      replyStatus: null,
-    }),
-  ],
-});
-
-/** The Runs tab's sessions: a live one with three live roles, one whose run another session continued, and it. */
-export const FIXTURE_SESSIONS: { row: SessionRow; runs: SessionRun[] }[] = [
-  {
-    row: {
-      key: sessionKey({ host: "claude-code", sessionId: "s-jobs" }),
-      name: "jobs screen",
-      live: true,
-      runs: 1,
-      liveRoles: 3,
-      landed: 1,
-      lastActivity: "2026-09-26T11:59:40.000Z",
-    },
-    runs: [
-      {
-        id: JOBS,
-        title: "Jobs screen",
-        repo: "/home/me/app",
-        createdAt: "2026-09-26T11:48:00.000Z",
-        continued: null,
-        continuedIn: null,
-        budget: 0.52,
-        milestones: [
-          { name: "M0", landed: true, what: "scaffold the jobs screen" },
-          { name: "M1", landed: false, what: "" },
-        ],
-        roles: [
-          role({
-            run: JOBS,
-            dispatchId: "d2",
-            name: "worker-M1.L2",
-            rung: "codex:gpt-6-sol#medium",
-            status: "running",
-            live: true,
-            since: "2026-09-26T11:55:48.000Z",
-            lastEvent: "$ bun test test/jobs --bail",
-            replyStatus: null,
-          }),
-          role({
-            run: JOBS,
-            dispatchId: "d4",
-            name: "worker-M1.L3",
-            rung: "codex:gpt-6-luna#high",
-            status: "running",
-            live: true,
-            since: "2026-09-26T11:57:00.000Z",
-            lastEvent: "edit src/jobs/list.tsx",
-            replyStatus: null,
-          }),
-          role({
-            run: JOBS,
-            dispatchId: "d3",
-            name: "reviewer-M1",
-            rung: "codex:gpt-6-sol#high",
-            status: "starting",
-            live: true,
-            since: "2026-09-26T11:59:56.000Z",
-            replyStatus: null,
-          }),
-          role({
-            run: JOBS,
-            dispatchId: "d1",
-            name: "worker-M1.L1",
-            rung: "codex:gpt-6-luna#high",
-            secs: 312,
-          }),
-        ],
-      },
-    ],
-  },
-  {
-    row: {
-      key: sessionKey({ host: "claude-code", sessionId: "s-kit" }),
-      name: "kit follow-up",
-      live: false,
-      runs: 1,
-      liveRoles: 0,
-      landed: 3,
-      lastActivity: "2026-09-25T11:20:00.000Z",
-    },
-    runs: [auth("here")],
-  },
-  {
-    row: {
-      key: sessionKey({ host: "claude-code", sessionId: "s-auth" }),
-      name: "auth build",
-      live: false,
-      runs: 2,
-      liveRoles: 0,
-      landed: 5,
-      lastActivity: "2026-09-25T10:36:00.000Z",
-    },
-    runs: [
-      auth("elsewhere"),
-      {
-        id: PLAN4,
-        title: "Auth plan 4",
-        repo: "/home/me/api",
-        createdAt: "2026-09-24T08:00:00.000Z",
-        continued: null,
-        continuedIn: null,
-        budget: null,
-        milestones: [
-          { name: "M1", landed: true, what: "schema" },
-          { name: "M2", landed: true, what: "handlers" },
-        ],
-        roles: [
-          role({
-            run: PLAN4,
-            dispatchId: "p2",
-            name: "reviewer-M2",
-            rung: "codex:gpt-6-sol#high",
-            secs: 140,
-          }),
-          role({
-            run: PLAN4,
-            dispatchId: "p1",
-            name: "worker-M2.L1",
-            rung: "codex:gpt-6-sol#medium",
-            secs: 610,
-          }),
-        ],
-      },
-    ],
-  },
-];
-
-/** The role screen's text: the brief, the reply and the record behind worker-M1.L1 of the jobs screen. */
-const FIXTURE_ROLE: Omit<RoleDetail, "run" | "runTitle" | "dispatchId" | "name" | "role" | "rung" | "state"> =
-  {
-    brief:
-      "Read /home/me/.local/share/catherd/runs/jobs-screen/lanes/M1.L1.md\nFast check: bun test test/jobs/list",
-    reply:
-      "Done: the list renders every job with its state.\nsrc/jobs/list.tsx:12 — the list\nsrc/jobs/list.test.tsx:4 — its test\nSTATUS: complete — list in place, fast check green",
-    record: null,
-  };
-
-/** The digest `land` writes for M0 of the jobs screen (spec 1.1 §10): what a landed milestone's screen shows. */
-export const FIXTURE_DIGEST = [
-  "# M0 — scaffold the jobs screen",
-  "",
-  "Commit 3f2a9c1 · 9 min · landed 2026-09-26T11:57:00.000Z",
-  "A-lines: A1 the jobs screen lists every job with its state",
-  "",
-  "Lanes:",
-  "- M0.L1 · codex:gpt-6-luna#high",
-  "- M0.L2 · codex:gpt-6-luna#medium → codex:gpt-6-sol#medium · climbs: fast check red twice",
-  "",
-  "Reviewer: reviewer-M0 · 1 finding(s): 0 BLOCKER, 0 BUG, 1 NIT",
-  "Verifier: PASS (verifier-M0)",
-  "Evidence: bun test test/jobs",
-  "Tokens: 1204k in (960k cached) · 58k out · Claude subagents 31k (reported)",
-  "",
-].join("\n");
-
-/** The record a finished fixture role would have: what the role screen shows under RECORD. */
-function fixtureRecord(r: SessionRun, x: RoleRow): RunRecord {
-  const start = Date.parse(x.since);
-  return {
-    schema: 1,
-    runId: r.id,
-    dispatchId: x.dispatchId,
-    name: x.name,
-    role: x.role,
-    lane: x.name.includes("-M") && x.name.includes(".") ? x.name.slice(x.name.indexOf("-") + 1) : null,
-    backend: x.rung.slice(0, x.rung.indexOf(":")),
-    rung: x.rung,
-    attempt: 1,
-    failoverFrom: null,
-    thread: "01a0d0d4-d0a6-71a1-983c-82a9169200b4",
-    status: x.status as RunRecord["status"],
-    startedAt: x.since,
-    endedAt: new Date(start + (x.secs ?? 0) * 1000).toISOString(),
-    secs: x.secs ?? 0,
-    exitCode: 0,
-    signal: null,
-    cliVersion: "0.157.0",
-    tokens: { input: 812_000, cached: 640_000, output: 41_000 },
-    costUsd: null,
-    changedOwned: ["src/jobs/list.tsx", "src/jobs/list.test.tsx"],
-    violations: [],
-    replyStatus: x.replyStatus as RunRecord["replyStatus"],
-    replyWhy: x.replyStatus ? "list in place, fast check green" : null,
-    threadHeavy: false,
-    access: "workspace-write",
-    isolated: false,
-    images: [],
-    error: null,
-    replyPath: `roles/${x.name}/${x.dispatchId}/reply.md`,
-  };
-}
-
-const BACKENDS = ["claude", "codex", "claude-code", "opencode"];
-
-/**
- * Effects over the fixtures; profile writes stay in memory and are recorded in `writes`. `repo` is the
- * directory the TUI stands in and `bindings` the repo bindings, as `liveEffects(repo)` reads them.
- */
-export interface FixtureOptions {
-  host?: OrchestrationHost;
-  runs?: RunSummary[];
-  sessions?: { row: SessionRow; runs: SessionRun[] }[];
-  report?: DoctorReport;
-  repo?: string;
-  bindings?: Record<string, string>;
-  /** false: the run folders cannot be watched here, as on a platform without fs.watch */
-  watchable?: boolean;
-}
-
-/** Spec 1.2 §9: the sources as the `r` dialog shows them, one failing. */
-export const FIXTURE_SOURCES: ReturnType<Effects["sources"]> = [
-  { source: "models-dev", name: "models.dev", age: "2 h ago", error: null },
-  { source: "arena", name: "Arena (LMArena)", age: "2 h ago", error: null },
-  { source: "epoch", name: "Epoch AI benchmarks", age: "1 d ago", error: "network error" },
-  { source: "artificial-analysis", name: "Artificial Analysis", age: "never fetched", error: null },
-];
-
-export function fixtureEffects(o: FixtureOptions = {}): Effects & {
-  writes: string[];
-  /** what a change to a watched run file does: every open watch hears of it */
-  touch(): void;
-  /** the run folders watched now */
-  watched: string[][];
-} {
-  const host = o.host ?? "claude-code";
-  const runs = o.runs ?? FIXTURE_RUNS;
-  const sessions = o.sessions ?? FIXTURE_SESSIONS;
-  const listeners = new Set<() => void>();
-  const watched: string[][] = [];
-  const docs = new Map<string, ProfileDoc>([["default", defaultProfileDoc()]]);
-  let active = "default";
-  const bindings = new Map(Object.entries(o.bindings ?? {}));
-  const bound = () => (o.repo && bindings.has(o.repo) ? o.repo : null);
-  const writes: string[] = [];
-  /** what the ProfileService returns for writing `after` over `before` */
-  const result = (
-    name: string,
-    before: ProfileDoc,
-    after: ProfileDoc,
-    staged: Record<string, string> = {},
-  ) => {
-    const p = resolveProfile(after, name, host);
-    const c = withStaged(loadCatalog({ timings: false }), staged);
-    const v = validateProfile(p, c, BACKENDS, undefined, host);
-    // spec 1.2 §6.2, as the ProfileService rules: a save that repairs part of an invalid profile goes through
-    const was = docs.has(name)
-      ? validateProfile(resolveProfile(before, name, host), c, BACKENDS, undefined, host)
-      : null;
-    return {
-      saved: repairs(was, v),
-      ...v,
-      diff: diffProfiles(resolveProfile(before, name, host), p),
-      linked: [],
-      pruned: [],
-      newSessionNeededFor: [],
-    };
-  };
-  return {
-    writes,
-    watched,
-    touch: () => {
-      for (const l of listeners) l();
-    },
-    host: { host, session: null, conflict: null },
-    version: "1.0.0",
-    doctor: async () => o.report ?? FIXTURE_REPORT,
-    runs: () => ({ rows: runs.map(rowOf), warnings: [] }),
-    sessions: () => ({ rows: sessions.map((x) => x.row), warnings: [] }),
-    session(key) {
-      const x = sessions.find((y) => y.row.key === key);
-      if (!x) throw new Error(`no session "${key}"`);
-      return { session: x.row, runs: x.runs, dirs: x.runs.map((r) => `/runs/${r.id}`) };
-    },
-    role(run, dispatchId) {
-      for (const x of sessions)
-        for (const r of x.runs) {
-          const role = r.id === run ? r.roles.find((y) => y.dispatchId === dispatchId) : undefined;
-          if (!role) continue;
-          return {
-            run,
-            runTitle: r.title,
-            dispatchId,
-            name: role.name,
-            role: role.role,
-            rung: role.rung,
-            state: role.live ? role.status : "finished",
-            brief: FIXTURE_ROLE.brief,
-            reply: role.live ? "" : FIXTURE_ROLE.reply,
-            record: role.live ? null : fixtureRecord(r, role),
-          };
-        }
-      throw new Error(`no dispatch ${dispatchId} in run ${run}`);
-    },
-    milestone(run, name) {
-      for (const x of sessions)
-        for (const r of x.runs) {
-          const m = r.id === run ? r.milestones.find((y) => y.name === name) : undefined;
-          if (!m) continue;
-          return { run, runTitle: r.title, ...m, digest: m.landed ? FIXTURE_DIGEST : null };
-        }
-      throw new Error(`no milestone "${name}" in run ${run}`);
-    },
-    watch(dirs, onChange) {
-      if (o.watchable === false) return null;
-      watched.push(dirs);
-      listeners.add(onChange);
-      return () => {
-        listeners.delete(onChange);
-        watched.splice(watched.indexOf(dirs), 1);
-      };
-    },
-    async cancel(run, name) {
-      writes.push(`cancel ${run} ${name}`);
-      return `${name} cancelled`;
-    },
-    profiles: () => ({
-      names: [...docs.keys()].sort(),
-      active,
-      here: bindings.get(o.repo ?? "") ?? active,
-      repo: bound(),
-    }),
-    readProfile(name) {
-      const d = docs.get(name);
-      if (!d) throw new Error(`no profile named "${name}"`);
-      return d;
-    },
-    catalog: (billing) => ({
-      catalog: loadCatalog({ timings: false }),
-      models: catalogQuery({ scoredOnly: false, limit: Number.MAX_SAFE_INTEGER }, billing).models,
-    }),
-    validate: (p, c) => validateProfile(p, c, BACKENDS, undefined, host),
-    enforcement: (rung) => (rung.startsWith("codex:") ? "enforced" : "advisory"),
-    harnesses: ["codex", "claude-code", "opencode"],
-    isolation: () => ({}),
-    agents: (p) =>
-      (["architect", "verifier"] as const)
-        .filter((r) => p.roles[r].enabled)
-        .flatMap((r) =>
-          p.roles[r].rungs
-            .filter((x) => x.startsWith("claude:"))
-            .map((x) => `catherd-${p.name}-${r}-${x.slice(7).replace("#", "-")}`),
-        ),
-    async save(name, patch, treatLikes, shown) {
-      const before = docs.get(name) ?? defaultProfileDoc(name);
-      // the ProfileService's compare-and-swap: nothing is written over a profile the preview did not show
-      if (shown !== undefined && !isDeepStrictEqual(before, shown))
-        return {
-          saved: false,
-          errors: [
-            {
-              path: CHANGED_ON_DISK,
-              message: `profile "${name}" changed on disk since it was shown`,
-              fix: "check the changes and save again",
-            },
-          ],
-          warnings: [],
-          diff: [],
-          linked: [],
-          pruned: [],
-          newSessionNeededFor: [],
-        };
-      const after = applyPatch(before, patch);
-      const r = result(name, before, after, treatLikes);
-      if (r.saved) {
-        docs.set(name, after);
-        const tl = Object.keys(treatLikes).length ? ` ${JSON.stringify(treatLikes)}` : "";
-        writes.push(`save ${name} ${JSON.stringify(patch)}${tl}`);
-      }
-      return r;
-    },
-    activate(name, repo) {
-      if (repo !== null) {
-        bindings.set(repo, name);
-        writes.push(`bind ${name} ${repo}`);
-      } else {
-        active = name;
-        writes.push(`activate ${name}`);
-      }
-      return {
-        linked: [],
-        pruned: [],
-        newSessionNeededFor: [`catherd-${name}-architect-claude-opus-5-5-high`],
-      };
-    },
-    create(name, from) {
-      const doc = { ...(from ? (docs.get(from) as ProfileDoc) : defaultProfileDoc(name)), name };
-      const r = result(name, doc, doc);
-      if (r.saved) {
-        docs.set(name, doc);
-        writes.push(`create ${name}${from ? ` from ${from}` : ""}`);
-      }
-      return r;
-    },
-    remove(name) {
-      if (name === active) throw new Error(`"${name}" is the active profile`);
-      const at = [...bindings].find(([, p]) => p === name);
-      if (at) throw new Error(`"${name}" is bound to ${at[0]}`);
-      docs.delete(name);
-      writes.push(`remove ${name}`);
-      return { linked: [], pruned: [], newSessionNeededFor: [] };
-    },
-    async refreshCatalog() {
-      writes.push("refresh");
-      return [{ backend: "codex", models: 14, fetchedAt: "2026-09-26T12:00:00.000Z" }];
-    },
-    async syncSources() {
-      writes.push("sync");
-      return {
-        busy: false,
-        sources: [],
-        newlyScored: [],
-        noLongerNeeded: [],
-        failed: [],
-        warnings: [],
-        unmatched: {},
-      };
-    },
-    sources: () => FIXTURE_SOURCES,
-    suggest: suggestFor,
-    rungDetail: rungDetailOf,
-  };
-}