@elench/testkit 0.1.89 → 0.1.91

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/testkit",
-  "version": "0.1.89",
+  "version": "0.1.91",
   "description": "CLI for discovering and running local HTTP, DAL, and Playwright test suites",
   "type": "module",
   "workspaces": [
@@ -82,10 +82,10 @@
   },
   "dependencies": {
     "@babel/code-frame": "^7.29.0",
-    "@elench/next-analysis": "0.1.89",
-    "@elench/testkit-bridge": "0.1.89",
-    "@elench/testkit-protocol": "0.1.89",
-    "@elench/ts-analysis": "0.1.89",
+    "@elench/next-analysis": "0.1.91",
+    "@elench/testkit-bridge": "0.1.91",
+    "@elench/testkit-protocol": "0.1.91",
+    "@elench/ts-analysis": "0.1.91",
     "@oclif/core": "^4.10.6",
     "esbuild": "^0.25.11",
     "execa": "^9.5.0",

package/lib/cli/agents/investigate.mjs

@@ -1,75 +0,0 @@
-import { loadInvestigationContext } from "./investigation-context.mjs";
-import { buildInvestigationPrompt } from "./prompt-builder.mjs";
-import { startAgentSession, startInteractiveAgentHandoff } from "./index.mjs";
-
-export function createInvestigationRequest({
-  productDir,
-  serviceName,
-  filePath,
-  provider = "auto",
-  userMessage,
-} = {}) {
-  const context = loadInvestigationContext({
-    productDir,
-    serviceName,
-    filePath,
-  });
-  const prompt = buildInvestigationPrompt({ context, userMessage });
-  return {
-    provider,
-    context,
-    prompt,
-  };
-}
-
-export function startHostedInvestigation({
-  productDir,
-  serviceName,
-  filePath,
-  provider = "auto",
-  userMessage,
-  onEvent,
-} = {}) {
-  const request = createInvestigationRequest({
-    productDir,
-    serviceName,
-    filePath,
-    provider,
-    userMessage,
-  });
-  const session = startAgentSession({
-    provider: request.provider,
-    cwd: productDir,
-    prompt: request.prompt,
-    onEvent,
-  });
-  return {
-    ...session,
-    request,
-  };
-}
-
-export async function runInteractiveInvestigation({
-  productDir,
-  serviceName,
-  filePath,
-  provider = "auto",
-  userMessage,
-} = {}) {
-  const request = createInvestigationRequest({
-    productDir,
-    serviceName,
-    filePath,
-    provider,
-    userMessage,
-  });
-  const result = await startInteractiveAgentHandoff({
-    provider: request.provider,
-    cwd: productDir,
-    prompt: request.prompt,
-  });
-  return {
-    ...result,
-    request,
-  };
-}

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

@@ -1,102 +0,0 @@
-import path from "path";
-import {
-  collectArtifactEntries,
-  formatArtifactPreview,
-  formatFileDetail,
-  getServiceLogRefs,
-  getSetupOperationsForService,
-  loadCurrentRunArtifact,
-  resolveFileSubject,
-} from "../viewer.mjs";
-import { readLogTail } from "../../runner/logs.mjs";
-
-export function loadInvestigationContext({
-  productDir,
-  serviceName,
-  filePath,
-  logTail = 20,
-  failureLimit = 5,
-  previewLength = 6,
-} = {}) {
-  if (!productDir) throw new Error("productDir is required");
-  if (!serviceName) throw new Error("serviceName is required");
-  if (!filePath) throw new Error("filePath is required");
-
-  const runArtifact = loadCurrentRunArtifact(productDir);
-  const subject = resolveFileSubject(runArtifact, filePath, serviceName);
-  const detailLines = formatFileDetail(productDir, runArtifact, subject, {
-    logTail,
-    failureLimit,
-    previewLength,
-  });
-  const artifacts = collectArtifactEntries(productDir, runArtifact, subject.file.path, subject.service.name).map((entry) => ({
-    name: entry.artifactRef.name,
-    kind: entry.artifactRef.kind || null,
-    summary: entry.artifactRef.summary || null,
-    path: entry.artifactRef.path,
-    previewLines: formatArtifactPreview(entry.payload, previewLength),
-  }));
-  const setupOperations = getSetupOperationsForService(runArtifact, subject.service.name).slice(0, 8).map((operation) => ({
-    stage: operation.stage,
-    status: operation.status,
-    summary: operation.summary || null,
-    durationMs: operation.durationMs ?? null,
-    logPath: operation.logRef?.path || null,
-    error: operation.error || null,
-  }));
-  const backendLogs = getServiceLogRefs(runArtifact, subject.service.name).map((logRef) => ({
-    runtimeLabel: logRef.runtimeLabel,
-    path: logRef.path,
-    lines: readLogTail(path.join(productDir, logRef.path), logTail),
-  }));
-
-  return {
-    productDir,
-    runArtifact,
-    subject,
-    detailLines,
-    summary: {
-      service: subject.service.name,
-      suite: `${subject.suite.type}:${subject.suite.name}`,
-      file: subject.file.path,
-      status: subject.file.status,
-      durationMs: subject.file.durationMs || 0,
-      error: subject.file.error || null,
-      failureCount: Array.isArray(subject.file.failureDetails) ? subject.file.failureDetails.length : 0,
-    },
-    setupOperations,
-    artifacts,
-    backendLogs,
-  };
-}
-
-export function formatInvestigationTranscriptContext(context) {
-  if (!context) return "";
-  const artifactSummary = context.artifacts.length === 0
-    ? "none"
-    : context.artifacts
-        .map((entry) => `${entry.name}${entry.kind ? ` [${entry.kind}]` : ""}: ${entry.path}`)
-        .join("\n");
-  const logSummary = context.backendLogs.length === 0
-    ? "none"
-    : context.backendLogs.map((entry) => `${entry.runtimeLabel}: ${entry.path}`).join("\n");
-
-  return [
-    `Service: ${context.summary.service}`,
-    `Suite: ${context.summary.suite}`,
-    `File: ${context.summary.file}`,
-    `Status: ${context.summary.status}`,
-    context.summary.error ? `Error: ${context.summary.error}` : null,
-    "",
-    "Artifacts:",
-    artifactSummary,
-    "",
-    "Backend Logs:",
-    logSummary,
-    "",
-    "Detailed Failure View:",
-    ...context.detailLines,
-  ]
-    .filter(Boolean)
-    .join("\n");
-}

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";
-}