@elench/testkit 0.1.89 → 0.1.90

package/lib/cli/agents/investigation-interpreter.mjs

@@ -1,320 +0,0 @@
-const INSPECT_COMMANDS = new Set([
-  "cat",
-  "find",
-  "grep",
-  "head",
-  "ls",
-  "open",
-  "read",
-  "rg",
-  "sed",
-  "tail",
-]);
-
-const EDIT_COMMANDS = new Set([
-  "apply_patch",
-  "cp",
-  "ed",
-  "mv",
-  "perl",
-  "python",
-  "python3",
-  "ruby",
-  "tee",
-  "write",
-]);
-
-const RERUN_COMMANDS = new Set([
-  "npm",
-  "npx",
-  "pnpm",
-  "pytest",
-  "testkit",
-  "vitest",
-  "yarn",
-]);
-
-const PHASE_LABELS = {
-  planning: "Planning investigation",
-  inspecting: "Inspecting relevant files",
-  editing: "Editing candidate fix",
-  rerunning: "Rerunning validation",
-  summarizing: "Summarizing outcome",
-};
-
-export function createInvestigationInterpreter() {
-  let phase = "planning";
-  let timeline = [];
-  let activeStepId = null;
-  let nextId = 1;
-  let inspectedCount = 0;
-  let rerunCount = 0;
-  const editedFiles = new Set();
-
-  pushTimeline({
-    kind: "phase",
-    phase,
-    label: PHASE_LABELS[phase],
-  });
-
-  return {
-    consumeProviderEvent(event) {
-      if (!event || !event.type) return getSnapshot();
-
-      if (event.type === "start") {
-        setPhase("planning");
-        activateStep("planning", "Preparing investigation", "active");
-        return getSnapshot();
-      }
-
-      if (event.type === "tool") {
-        handleToolEvent(event);
-        return getSnapshot();
-      }
-
-      if (event.type === "status") {
-        handleStatusEvent(event);
-        return getSnapshot();
-      }
-
-      if (event.type === "error") {
-        failActiveStep();
-        pushTimeline({
-          kind: "notice",
-          severity: "error",
-          message: event.message || "Agent error",
-        });
-        return getSnapshot();
-      }
-
-      if (event.type === "final") {
-        finalizeWithText(event.text || "");
-        return getSnapshot();
-      }
-
-      if (event.type === "exit" && Number(event.code) !== 0) {
-        failActiveStep();
-        pushTimeline({
-          kind: "notice",
-          severity: "error",
-          message: `Agent exited with code ${event.code}`,
-        });
-        return getSnapshot();
-      }
-
-      return getSnapshot();
-    },
-
-    getSnapshot,
-  };
-
-  function getSnapshot() {
-    return {
-      phase,
-      activeStep: activeStepId ? findTimeline(activeStepId) : null,
-      timeline: timeline.map((entry) => ({
-        ...entry,
-        files: Array.isArray(entry.files) ? [...entry.files] : entry.files,
-      })),
-      summary: {
-        inspectedCount,
-        rerunCount,
-        editedFiles: [...editedFiles].sort(),
-      },
-    };
-  }
-
-  function handleToolEvent(event) {
-    const commandText = String(event.name || "").trim();
-    const detailText = String(event.detail || "").trim();
-    const command = firstToken(commandText);
-
-    if (RERUN_COMMANDS.has(command) || /(?:^|\s)(testkit|vitest|pytest|npm|pnpm|yarn)(?:\s|$)/i.test(commandText)) {
-      setPhase("rerunning");
-      rerunCount += 1;
-      activateStep("rerunning", "Rerunning validation", "active", compactDetail(commandText, detailText));
-      pushTimeline({
-        kind: "rerun",
-        summary: compactDetail(commandText, detailText) || commandText,
-        command: commandText || detailText || null,
-      });
-      return;
-    }
-
-    if (EDIT_COMMANDS.has(command) || /apply_patch|write|edit/i.test(commandText)) {
-      setPhase("editing");
-      const files = extractFileHints(`${commandText} ${detailText}`);
-      for (const file of files) editedFiles.add(file);
-      activateStep(
-        "editing",
-        "Editing candidate fix",
-        "active",
-        files.length > 0 ? `${files.length} file${files.length === 1 ? "" : "s"} touched` : compactDetail(commandText, detailText)
-      );
-      if (files.length > 0) {
-        upsertTimeline(
-          "latest-edit",
-          {
-            kind: "edit",
-            summary: `Edited ${files.length} file${files.length === 1 ? "" : "s"}`,
-            files,
-          },
-          true
-        );
-      }
-      return;
-    }
-
-    if (INSPECT_COMMANDS.has(command) || /git|diff|read|search|inspect|open/i.test(commandText)) {
-      setPhase("inspecting");
-      inspectedCount += 1;
-      activateStep(
-        "inspecting",
-        "Inspecting relevant files",
-        "active",
-        `${inspectedCount} check${inspectedCount === 1 ? "" : "s"}`
-      );
-      return;
-    }
-
-    setPhase("inspecting");
-    activateStep("inspecting", "Inspecting relevant files", "active", compactDetail(commandText, detailText));
-  }
-
-  function handleStatusEvent(event) {
-    const message = String(event.message || "").trim();
-    if (!message) return;
-    if (/error|failed|exception/i.test(message)) {
-      pushTimeline({
-        kind: "notice",
-        severity: "warning",
-        message,
-      });
-      return;
-    }
-    if (/plan|thinking|analy/i.test(message) && phase === "planning") {
-      activateStep("planning", "Planning investigation", "active", "Gathering context");
-    }
-  }
-
-  function finalizeWithText(text) {
-    setPhase("summarizing");
-    completeActiveStep();
-    const summary = summarizeFinalText(text);
-    if (summary) {
-      pushTimeline({
-        kind: "result",
-        summary,
-        finalText: text,
-      });
-      if (/root cause|likely|caused by|problem/i.test(summary)) {
-        pushTimeline({
-          kind: "finding",
-          severity: "info",
-          summary,
-          confidence: inferConfidence(summary),
-        });
-      }
-    }
-  }
-
-  function setPhase(nextPhase) {
-    if (!nextPhase || nextPhase === phase) return;
-    completeActiveStep();
-    phase = nextPhase;
-    pushTimeline({
-      kind: "phase",
-      phase,
-      label: PHASE_LABELS[phase] || nextPhase,
-    });
-  }
-
-  function activateStep(key, label, status, detail = null) {
-    const stepId = `step:${key}`;
-    upsertTimeline(
-      stepId,
-      {
-        kind: "step",
-        label,
-        status,
-        detail,
-      },
-      false
-    );
-    activeStepId = stepId;
-  }
-
-  function completeActiveStep() {
-    if (!activeStepId) return;
-    const entry = findTimeline(activeStepId);
-    if (entry && entry.status === "active") entry.status = "done";
-    activeStepId = null;
-  }
-
-  function failActiveStep() {
-    if (!activeStepId) return;
-    const entry = findTimeline(activeStepId);
-    if (entry) entry.status = "failed";
-    activeStepId = null;
-  }
-
-  function findTimeline(id) {
-    return timeline.find((entry) => entry.id === id) || null;
-  }
-
-  function pushTimeline(entry) {
-    timeline.push({
-      id: `timeline:${nextId += 1}`,
-      at: Date.now(),
-      ...entry,
-    });
-  }
-
-  function upsertTimeline(id, entry, replaceFiles = false) {
-    const existing = findTimeline(id);
-    if (existing) {
-      Object.assign(existing, entry);
-      if (replaceFiles && Array.isArray(entry.files)) existing.files = [...entry.files];
-      return existing;
-    }
-    const nextEntry = {
-      id,
-      at: Date.now(),
-      ...entry,
-    };
-    timeline.push(nextEntry);
-    return nextEntry;
-  }
-}
-
-function firstToken(commandText) {
-  const normalized = String(commandText || "").trim();
-  if (!normalized) return "";
-  return normalized.split(/\s+/)[0].toLowerCase();
-}
-
-function compactDetail(commandText, detailText) {
-  if (commandText && detailText && detailText !== commandText) {
-    return `${commandText} (${detailText})`;
-  }
-  return commandText || detailText || null;
-}
-
-function summarizeFinalText(text) {
-  const normalized = String(text || "").trim();
-  if (!normalized) return "";
-  const [firstParagraph] = normalized.split(/\n\s*\n/);
-  const [firstSentence] = firstParagraph.split(/(?<=[.!?])\s+/);
-  return firstSentence.trim();
-}
-
-function inferConfidence(summary) {
-  if (/definitely|confirmed|root cause/i.test(summary)) return "high";
-  if (/likely|probably|appears/i.test(summary)) return "medium";
-  return "low";
-}
-
-function extractFileHints(text) {
-  const matches = String(text || "").match(/[A-Za-z0-9_./-]+\.(?:mjs|js|cjs|ts|tsx|jsx|json|md)/g) || [];
-  return [...new Set(matches)];
-}

package/lib/cli/agents/investigation-log.mjs

@@ -1,37 +0,0 @@
-import fs from "fs";
-import path from "path";
-
-export function writeInvestigationLog({ productDir, selectedFailure, agentSession } = {}) {
-  if (!productDir || !selectedFailure || !agentSession) return null;
-
-  try {
-    const rootDir = path.join(productDir, ".testkit", "agent-sessions");
-    fs.mkdirSync(rootDir, { recursive: true });
-    const stamp = new Date().toISOString().replace(/[:.]/g, "-");
-    const fileName = `${stamp}-${sanitize(selectedFailure.serviceName)}-${sanitize(path.basename(selectedFailure.filePath))}.json`;
-    const filePath = path.join(rootDir, fileName);
-    const payload = {
-      serviceName: selectedFailure.serviceName,
-      filePath: selectedFailure.filePath,
-      provider: agentSession.provider,
-      status: agentSession.status,
-      startedAt: agentSession.startedAt || null,
-      endedAt: agentSession.endedAt || null,
-      finalText: agentSession.finalText || "",
-      error: agentSession.error || null,
-      exitCode: agentSession.exitCode ?? null,
-      transcriptEntries: agentSession.transcriptEntries || [],
-      timeline: agentSession.timeline || [],
-      summary: agentSession.summary || null,
-      activePhase: agentSession.activePhase || null,
-    };
-    fs.writeFileSync(filePath, `${JSON.stringify(payload, null, 2)}\n`, "utf8");
-    return filePath;
-  } catch {
-    return null;
-  }
-}
-
-function sanitize(value) {
-  return String(value || "unknown").replace(/[^A-Za-z0-9._-]+/g, "-");
-}

package/lib/cli/agents/prompt-builder.mjs

@@ -1,25 +0,0 @@
-import { formatInvestigationTranscriptContext } from "./investigation-context.mjs";
-
-const DEFAULT_INVESTIGATION_MESSAGE =
-  "Investigate the selected testkit failure. Explain the most likely root cause, cite concrete evidence from the provided context, and suggest the next debugging steps or code changes.";
-
-export function defaultInvestigationMessage() {
-  return DEFAULT_INVESTIGATION_MESSAGE;
-}
-
-export function buildInvestigationPrompt({ context, userMessage } = {}) {
-  const message = userMessage || DEFAULT_INVESTIGATION_MESSAGE;
-  const transcriptContext = formatInvestigationTranscriptContext(context);
-
-  return [
-    "You are investigating a failed testkit run.",
-    "Use the provided run context as the primary evidence.",
-    "If the evidence is incomplete, say what additional command or file you would inspect next.",
-    "Keep the response actionable and focused on root cause, evidence, and next steps.",
-    "",
-    `User request: ${message}`,
-    "",
-    "Run context:",
-    transcriptContext,
-  ].join("\n");
-}

package/lib/cli/assistant/content.mjs

@@ -1,60 +0,0 @@
-import { buildInspectPaneContent } from "../tui/detail-pane.mjs";
-
-export function readAssistantContent({
-  productDir,
-  inspectState,
-  mode = "detail",
-  logTail = 12,
-} = {}) {
-  const snapshot = inspectState.getSnapshot();
-  const content = buildInspectPaneContent({
-    productDir,
-    snapshot,
-    paneMode: normalizeMode(mode),
-    logTail,
-  });
-  return {
-    mode: normalizeMode(mode),
-    title: content.title,
-    lines: content.lines || [],
-    data: content.data ?? null,
-    selection: snapshot.selectedEntry || null,
-    summaryRows: snapshot.summaryData?.rows || [],
-  };
-}
-
-export function buildAssistantContext(snapshot) {
-  const selectedEntry = snapshot?.selectedEntry || null;
-  const summaryRows = snapshot?.summaryData?.rows || [];
-  return {
-    selection: selectedEntry
-      ? {
-          kind: selectedEntry.kind,
-          label: selectedEntry.label || selectedEntry.filePath || selectedEntry.serviceName || "selection",
-          serviceName: selectedEntry.serviceName || null,
-          type: selectedEntry.type || null,
-          suiteName: selectedEntry.suiteName || null,
-          filePath: selectedEntry.filePath || null,
-          status: selectedEntry.status || null,
-        }
-      : null,
-    summaryRows,
-    phase: snapshot?.phase || null,
-    hasArtifact: Boolean(snapshot?.runArtifact),
-  };
-}
-
-export function formatAssistantToolText(title, lines) {
-  const normalizedTitle = String(title || "").trim();
-  const normalizedLines = Array.isArray(lines) ? lines.filter((line) => String(line).length > 0) : [];
-  if (normalizedTitle && normalizedLines.length > 0) {
-    return [normalizedTitle, ...normalizedLines].join("\n");
-  }
-  if (normalizedTitle) return normalizedTitle;
-  return normalizedLines.join("\n");
-}
-
-function normalizeMode(mode) {
-  if (mode === "logs" || mode === "artifacts" || mode === "setup") return mode;
-  return "detail";
-}

package/lib/cli/tui/assistant-app.mjs

@@ -1,82 +0,0 @@
-import React, { createElement, useEffect, useState } from "react";
-import { Box, Text, useAnimation, useApp, useInput } from "ink";
-import { dim, yellow } from "../presentation/colors.mjs";
-import {
-  buildAssistantComposerLines,
-  buildAssistantHeader,
-  buildAssistantTranscriptLines,
-  getAssistantLayout,
-} from "./assistant-render.mjs";
-
-const SPINNER_FRAMES = ["|", "/", "-", "\\"];
-
-export function AssistantApp({ assistantState, stdout } = {}) {
-  const { exit } = useApp();
-  const [snapshot, setSnapshot] = useState(() => assistantState.getSnapshot());
-  const { frame } = useAnimation({ interval: 80, isActive: snapshot.busy });
-
-  useEffect(() => {
-    const unsubscribe = assistantState.subscribe(() => {
-      setSnapshot(assistantState.getSnapshot());
-    });
-    return unsubscribe;
-  }, [assistantState]);
-
-  useInput((input, key) => {
-    if (key.ctrl && input === "c") {
-      exit();
-      return;
-    }
-    if (input === "q" && !snapshot.composer) {
-      exit();
-      return;
-    }
-    if (key.return) {
-      void assistantState.submitCurrentComposer();
-      return;
-    }
-    if (key.backspace || key.delete) {
-      assistantState.backspaceComposer();
-      return;
-    }
-    if (key.escape) {
-      assistantState.setComposer("");
-      return;
-    }
-    if (isPrintableInput(input, key)) {
-      assistantState.appendComposer(input);
-    }
-  });
-
-  const spinner = SPINNER_FRAMES[frame % SPINNER_FRAMES.length];
-  const layout = getAssistantLayout(stdout);
-  const transcriptLines = buildAssistantTranscriptLines(snapshot, {
-    width: layout.width,
-    maxLines: layout.transcriptLines,
-  });
-  const composerLines = buildAssistantComposerLines(snapshot, { width: layout.width });
-
-  return createElement(
-    Box,
-    { flexDirection: "column" },
-    createElement(Text, null, dim(buildAssistantHeader(snapshot, spinner))),
-    snapshot.notice ? createElement(Text, null, yellow(snapshot.notice)) : null,
-    createElement(Text, null, ""),
-    ...transcriptLines.map((line, index) => createElement(Text, { key: `line-${index}` }, line)),
-    createElement(Text, null, ""),
-    ...composerLines.map((line, index) => createElement(Text, { key: `composer-${index}` }, line)),
-    createElement(Text, null, dim("Enter send · Esc clear draft · q quit"))
-  );
-}
-
-function isPrintableInput(input, key) {
-  return Boolean(
-    input &&
-      input.length === 1 &&
-      !key.ctrl &&
-      !key.meta &&
-      !key.return &&
-      !key.escape &&
-      !key.tab
-  );
-}

package/lib/cli/tui/assistant-render.mjs

@@ -1,99 +0,0 @@
-import { bold, cyan, dim, yellow } from "../presentation/colors.mjs";
-import {
-  getTerminalWidth,
-  measureWidth,
-  padEndVisible,
-  wrapText,
-} from "../presentation/terminal-layout.mjs";
-
-export function buildAssistantHeader(snapshot, spinner = "|") {
-  const status = snapshot.busy ? `${spinner} ${snapshot.activeStatus || "working"}` : "ready";
-  const focus = snapshot.context.selection?.filePath
-    || snapshot.context.selection?.label
-    || "no focus";
-  return [`testkit assistant`, `provider ${snapshot.provider}`, status, focus].join(" · ");
-}
-
-export function buildAssistantTranscriptLines(snapshot, { width = 100, maxLines = 40 } = {}) {
-  const blocks = [];
-  for (const message of snapshot.messages) {
-    blocks.push(...formatAssistantMessageBlock(message, width));
-    blocks.push("");
-  }
-  if (snapshot.busy) {
-    blocks.push(dim(`${snapshot.activeStatus || "Working"}...`));
-  }
-  return trimTranscript(blocks, maxLines);
-}
-
-export function buildAssistantComposerLines(snapshot, { width = 100 } = {}) {
-  const boxWidth = Math.max(24, width);
-  const innerWidth = Math.max(18, boxWidth - 4);
-  const draft = snapshot.composer || "";
-  const label = "Message";
-  const promptPrefix = "> ";
-  const contentLines = draft
-    ? wrapText(draft, Math.max(8, innerWidth - measureWidth(promptPrefix)))
-    : [dim("Ask testkit about failures, runs, logs, or artifacts")];
-  const top = `┌${"─".repeat(Math.max(0, boxWidth - 2))}┐`;
-  const labelLine = `│ ${padEndVisible(bold(label), innerWidth)} │`;
-  const draftLines = contentLines.map((line, index) =>
-    `│ ${padEndVisible(index === 0 ? `${promptPrefix}${line}` : `  ${line}`, innerWidth)} │`
-  );
-  const bottom = `└${"─".repeat(Math.max(0, boxWidth - 2))}┘`;
-  return [top, labelLine, ...draftLines, bottom];
-}
-
-export function getAssistantLayout(stdout, { transcriptReserve = 9 } = {}) {
-  const width = getTerminalWidth(stdout, 100);
-  const rows = Number(stdout?.rows);
-  const height = Number.isFinite(rows) && rows > 0 ? rows : 40;
-  const transcriptLines = Math.max(10, height - transcriptReserve);
-  return {
-    width,
-    transcriptLines,
-  };
-}
-
-export function formatAssistantMessageBlock(message, width = 100) {
-  const title = formatRoleTitle(message);
-  const bodyWidth = Math.max(12, width - 2);
-  const bodyLines = String(message.text || "")
-    .split(/\r?\n/)
-    .flatMap((line) => wrapText(line, bodyWidth));
-  const rendered = [title];
-  for (const line of bodyLines) {
-    rendered.push(line ? `  ${line}` : "");
-  }
-  if (message.role === "tool" && message.toolName) {
-    rendered[0] = cyan(title);
-  } else if (message.role === "assistant") {
-    rendered[0] = bold(title);
-  } else if (message.role === "system") {
-    rendered[0] = yellow(title);
-  }
-  return rendered;
-}
-
-function formatRoleTitle(message) {
-  if (message.role === "user") return "You";
-  if (message.role === "assistant") return "Testkit";
-  if (message.role === "tool") return message.title || formatToolName(message.toolName);
-  return "System";
-}
-
-function formatToolName(toolName) {
-  const raw = String(toolName || "Tool").trim();
-  if (!raw) return "Tool";
-  return raw
-    .split(/[_-]+/)
-    .filter(Boolean)
-    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
-    .join(" ");
-}
-
-function trimTranscript(lines, maxLines) {
-  if (lines.length <= maxLines) return lines;
-  const hidden = lines.length - maxLines;
-  return [dim(`… ${hidden} earlier line${hidden === 1 ? "" : "s"} …`), ...lines.slice(-maxLines + 1)];
-}