@elench/testkit 0.1.86 → 0.1.88

package/lib/cli/tui/inspect-state.mjs

@@ -0,0 +1,321 @@
+import {
+  applyArtifactToModel,
+  buildSnapshot,
+  createEmptyInspectModel,
+  cyclePane,
+  findEntryIdForFile,
+  findEntryIdForService,
+  finishModel,
+  initModelFromPlans,
+  markFileFinished,
+  markFileRunning,
+  markPlannedSkip,
+  markRuntimeError,
+  markServiceSkipped,
+  resetInspectModel,
+  revealEntry,
+  setPane,
+  setPhase,
+  setRegressionCatalog,
+  setTotalFileCount,
+  toggleCollapsed,
+  updateFilter,
+} from "./inspect-model.mjs";
+
+export function createInspectState({ dataSource = "live" } = {}) {
+  const model = createEmptyInspectModel(dataSource);
+  let mode = dataSource === "artifact" ? "complete" : "running";
+  let notice = null;
+  let agentSession = null;
+  const listeners = new Set();
+
+  function notify() {
+    for (const callback of listeners) callback();
+  }
+
+  function appendTranscriptEntry(kind, text) {
+    if (!agentSession || !text) return;
+    const normalizedText = String(text);
+    const entries = agentSession.transcriptEntries || [];
+    const lastEntry = entries.at(-1);
+    if (kind === "assistant" && lastEntry?.kind === "assistant") {
+      lastEntry.text += normalizedText;
+      agentSession.updatedAt = Date.now();
+      return;
+    }
+    entries.push({ kind, text: normalizedText });
+    agentSession.transcriptEntries = entries;
+    agentSession.updatedAt = Date.now();
+  }
+
+  function finishAgentSession(status, extra = {}) {
+    if (!agentSession) return;
+    agentSession = {
+      ...agentSession,
+      ...extra,
+      status,
+      endedAt: Date.now(),
+    };
+  }
+
+  function moveCursor(delta) {
+    const snapshot = getSnapshot();
+    if (snapshot.visibleEntries.length === 0) return;
+    const currentIndex = snapshot.visibleEntries.findIndex((entry) => entry.id === snapshot.selectedEntryId);
+    const nextIndex = clampIndex((currentIndex < 0 ? 0 : currentIndex) + delta, snapshot.visibleEntries.length);
+    model.selectedEntryId = snapshot.visibleEntries[nextIndex].id;
+    notify();
+  }
+
+  function getSnapshot() {
+    return {
+      ...buildSnapshot(model),
+      mode,
+      notice,
+      agentSession,
+    };
+  }
+
+  return {
+    initFromPlans(servicePlans) {
+      initModelFromPlans(model, servicePlans);
+      notify();
+    },
+
+    hydrateFromArtifact(artifact) {
+      applyArtifactToModel(model, artifact);
+      mode = model.finished ? "complete" : "running";
+      notify();
+    },
+
+    resetForLive() {
+      resetInspectModel(model, "live");
+      mode = "running";
+      notice = null;
+      agentSession = null;
+      notify();
+    },
+
+    setRegressionCatalog(document) {
+      setRegressionCatalog(model, document);
+      notify();
+    },
+
+    markFileRunning(serviceName, suiteKey, filePath) {
+      markFileRunning(model, serviceName, suiteKey, filePath);
+      notify();
+    },
+
+    markFileFinished(task, outcome) {
+      markFileFinished(model, task, outcome);
+      notify();
+    },
+
+    markServiceSkipped(serviceName, reason) {
+      markServiceSkipped(model, serviceName, reason);
+      notify();
+    },
+
+    markPlannedSkip(entry) {
+      markPlannedSkip(model, entry);
+      notify();
+    },
+
+    markRuntimeError(task, message) {
+      markRuntimeError(model, task, message);
+      notify();
+    },
+
+    setTotalFileCount(count) {
+      setTotalFileCount(model, count);
+      notify();
+    },
+
+    setPhase(label) {
+      setPhase(model, label);
+      notify();
+    },
+
+    finish(results, durationMs, regressionReport) {
+      finishModel(model, results, durationMs, regressionReport);
+      mode = "complete";
+      notify();
+    },
+
+    setNotice(message) {
+      notice = message ? String(message) : null;
+      notify();
+    },
+
+    clearNotice() {
+      if (!notice) return;
+      notice = null;
+      notify();
+    },
+
+    moveCursorUp() {
+      moveCursor(-1);
+    },
+
+    moveCursorDown() {
+      moveCursor(1);
+    },
+
+    moveCursorToEntry(entryId) {
+      model.selectedEntryId = entryId || null;
+      notify();
+    },
+
+    toggleExpand() {
+      const snapshot = getSnapshot();
+      if (!snapshot.selectedEntry) return;
+      toggleCollapsed(model, snapshot.selectedEntry.id);
+      notify();
+    },
+
+    activateFilter() {
+      model.filterActive = true;
+      notify();
+    },
+
+    updateFilterQuery(query) {
+      updateFilter(model, query);
+      const snapshot = buildSnapshot(model);
+      if (snapshot.filter.results.length > 0) {
+        model.selectedEntryId = snapshot.filter.results[0].id;
+      }
+      notify();
+    },
+
+    deactivateFilter() {
+      model.filterActive = false;
+      model.filterQuery = "";
+      model.filterMatches = new Map();
+      notify();
+    },
+
+    revealFile(serviceName, filePath) {
+      const entryId = findEntryIdForFile(model, serviceName, filePath);
+      if (!entryId) return false;
+      revealEntry(model, entryId);
+      notify();
+      return true;
+    },
+
+    revealService(serviceName) {
+      const entryId = findEntryIdForService(model, serviceName);
+      if (!entryId) return false;
+      revealEntry(model, entryId);
+      notify();
+      return true;
+    },
+
+    cyclePaneMode() {
+      cyclePane(model);
+      notify();
+    },
+
+    setPaneMode(paneMode) {
+      setPane(model, paneMode);
+      notify();
+    },
+
+    beginInvestigation({ provider, userMessage } = {}) {
+      mode = "investigating";
+      notice = null;
+      agentSession = {
+        provider: provider || "auto",
+        userMessage: userMessage || "",
+        status: "starting",
+        startedAt: Date.now(),
+        updatedAt: Date.now(),
+        rawEvents: [],
+        transcriptEntries: [],
+        timeline: [],
+        summary: null,
+        activePhase: "planning",
+        activeStep: null,
+        viewMode: "summary",
+      };
+      notify();
+    },
+
+    recordInvestigationProgress(event, presentation = null) {
+      if (!agentSession || !event) return;
+      agentSession.rawEvents.push({ ...event });
+      if (event.type === "start") {
+        agentSession.status = "running";
+      } else if (event.type === "delta") {
+        appendTranscriptEntry("assistant", event.text || "");
+      } else if (event.type === "final") {
+        if (event.text && !(agentSession.transcriptEntries || []).some((entry) => entry.kind === "assistant")) {
+          appendTranscriptEntry("assistant", event.text);
+        }
+        agentSession.finalText = event.text || agentSession.finalText || "";
+      } else if (event.type === "tool") {
+        appendTranscriptEntry("tool", event.detail ? `${event.name}: ${event.detail}` : event.name);
+      } else if (event.type === "status") {
+        appendTranscriptEntry("status", event.message || "");
+      } else if (event.type === "error") {
+        appendTranscriptEntry("error", event.message || "Agent error");
+      } else if (event.type === "exit") {
+        agentSession.exitCode = event.code;
+      }
+
+      if (presentation) {
+        agentSession.activePhase = presentation.phase || agentSession.activePhase || null;
+        agentSession.activeStep = presentation.activeStep || null;
+        agentSession.timeline = presentation.timeline || [];
+        agentSession.summary = presentation.summary || null;
+      }
+      notify();
+    },
+
+    toggleInvestigationViewMode() {
+      if (!agentSession) return;
+      agentSession.viewMode = agentSession.viewMode === "summary" ? "transcript" : "summary";
+      notify();
+    },
+
+    completeAgentSession(result = {}) {
+      finishAgentSession("complete", {
+        finalText: result.finalText || agentSession?.finalText || "",
+        exitCode: result.exitCode ?? agentSession?.exitCode ?? 0,
+      });
+      notify();
+    },
+
+    failAgentSession(error) {
+      finishAgentSession("error", {
+        error: error instanceof Error ? error.message : String(error || "Agent error"),
+      });
+      notify();
+    },
+
+    cancelAgentSession(message = "Cancelled investigation.") {
+      finishAgentSession("cancelled");
+      mode = "complete";
+      notice = message;
+      notify();
+    },
+
+    returnToSummary() {
+      mode = "complete";
+      notify();
+    },
+
+    subscribe(callback) {
+      listeners.add(callback);
+      return () => listeners.delete(callback);
+    },
+
+    getSnapshot,
+  };
+}
+
+function clampIndex(index, length) {
+  if (length <= 0) return 0;
+  if (index < 0) return 0;
+  if (index >= length) return length - 1;
+  return index;
+}

package/node_modules/@elench/next-analysis/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/next-analysis",
-  "version": "0.1.86",
+  "version": "0.1.88",
   "description": "SWC-backed Next.js source analysis primitives for Erench tools",
   "type": "module",
   "exports": {

package/node_modules/@elench/testkit-bridge/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/testkit-bridge",
-  "version": "0.1.86",
+  "version": "0.1.88",
   "description": "Browser bridge helpers for testkit",
   "type": "module",
   "main": "./dist/index.js",
@@ -22,7 +22,7 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@elench/testkit-protocol": "0.1.86"
+    "@elench/testkit-protocol": "0.1.88"
   },
   "private": false
 }

package/node_modules/@elench/testkit-protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/testkit-protocol",
-  "version": "0.1.86",
+  "version": "0.1.88",
   "description": "Shared browser protocol for testkit bridge and extension consumers",
   "type": "module",
   "main": "./dist/index.js",

package/node_modules/@elench/ts-analysis/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/ts-analysis",
-  "version": "0.1.86",
+  "version": "0.1.88",
   "description": "TypeScript compiler-backed source analysis primitives for Erench tools",
   "type": "module",
   "exports": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/testkit",
-  "version": "0.1.86",
+  "version": "0.1.88",
   "description": "CLI for discovering and running local HTTP, DAL, and Playwright test suites",
   "type": "module",
   "workspaces": [
@@ -52,7 +52,7 @@
   "oclif": {
     "bin": "testkit",
     "commands": "./lib/cli/commands",
-    "default": "run",
+    "default": "assistant",
     "topicSeparator": " "
   },
   "scripts": {
@@ -82,10 +82,10 @@
   },
   "dependencies": {
     "@babel/code-frame": "^7.29.0",
-    "@elench/next-analysis": "0.1.86",
-    "@elench/testkit-bridge": "0.1.86",
-    "@elench/testkit-protocol": "0.1.86",
-    "@elench/ts-analysis": "0.1.86",
+    "@elench/next-analysis": "0.1.88",
+    "@elench/testkit-bridge": "0.1.88",
+    "@elench/testkit-protocol": "0.1.88",
+    "@elench/ts-analysis": "0.1.88",
     "@oclif/core": "^4.10.6",
     "esbuild": "^0.25.11",
     "execa": "^9.5.0",

package/lib/cli/commands/artifacts.mjs

@@ -1,45 +0,0 @@
-import { Args, Command } from "@oclif/core";
-import { sharedFlags } from "../command-helpers.mjs";
-import { collectArtifactEntries, loadCurrentRunArtifact } from "../viewer.mjs";
-
-export default class ArtifactsCommand extends Command {
-  static summary = "List persisted artifacts from the latest run";
-
-  static enableJsonFlag = true;
-
-  static args = {
-    file: Args.string({
-      description: "Optional file path to filter artifacts",
-      required: false,
-    }),
-  };
-
-  static flags = sharedFlags;
-
-  async run() {
-    const { args, flags } = await this.parse(ArtifactsCommand);
-    const productDir = flags.dir || process.cwd();
-    const runArtifact = loadCurrentRunArtifact(productDir);
-    const entries = collectArtifactEntries(productDir, runArtifact, args.file || null, flags.service || null)
-      .map((entry) => ({
-        service: entry.service.name,
-        suite: `${entry.suite.type}:${entry.suite.name}`,
-        file: entry.file.path,
-        name: entry.artifactRef.name,
-        kind: entry.artifactRef.kind,
-        summary: entry.artifactRef.summary,
-        path: entry.artifactRef.path,
-      }));
-
-    if (!this.jsonEnabled()) {
-      for (const entry of entries) {
-        this.log(`${entry.file}`);
-        this.log(`  ${entry.name}${entry.kind ? ` [${entry.kind}]` : ""}`);
-        if (entry.summary) this.log(`    ${entry.summary}`);
-        this.log(`    ${entry.path}`);
-      }
-    }
-
-    return entries;
-  }
-}

package/lib/cli/commands/investigate.mjs

@@ -1,87 +0,0 @@
-import { Args, Command, Flags } from "@oclif/core";
-import { sharedFlags } from "../command-helpers.mjs";
-import { loadCurrentRunArtifact, resolveFileSubject } from "../viewer.mjs";
-import { runInteractiveInvestigation, startHostedInvestigation } from "../agents/investigate.mjs";
-
-export default class InvestigateCommand extends Command {
-  static summary = "Investigate a failed file from the latest run with Codex or Claude";
-
-  static enableJsonFlag = true;
-
-  static args = {
-    file: Args.string({
-      description: "Optional file path; defaults to the first failed file",
-      required: false,
-    }),
-  };
-
-  static flags = {
-    ...sharedFlags,
-    provider: Flags.string({
-      description: "Agent provider to use",
-      options: ["auto", "claude", "codex"],
-      default: "auto",
-    }),
-    message: Flags.string({
-      description: "Additional user instruction for the investigation prompt",
-    }),
-    handoff: Flags.boolean({
-      description: "Launch the provider's native interactive TUI instead of hosted output",
-      default: false,
-    }),
-  };
-
-  async run() {
-    const { args, flags } = await this.parse(InvestigateCommand);
-    const productDir = flags.dir || process.cwd();
-    const runArtifact = loadCurrentRunArtifact(productDir);
-    const subject = resolveFileSubject(runArtifact, args.file || null, flags.service || null);
-
-    if (flags.handoff) {
-      const result = await runInteractiveInvestigation({
-        productDir,
-        serviceName: subject.service.name,
-        filePath: subject.file.path,
-        provider: flags.provider,
-        userMessage: flags.message || null,
-      });
-      if (!this.jsonEnabled()) {
-        this.log(`${result.provider} exited with code ${result.exitCode}`);
-      }
-      return result;
-    }
-
-    let finalText = "";
-    const session = startHostedInvestigation({
-      productDir,
-      serviceName: subject.service.name,
-      filePath: subject.file.path,
-      provider: flags.provider,
-      userMessage: flags.message || null,
-      onEvent: this.jsonEnabled()
-        ? null
-        : (event) => {
-            if (event.type === "status" || event.type === "tool") {
-              this.log(event.type === "tool" ? `[tool] ${event.name}${event.detail ? `: ${event.detail}` : ""}` : `[status] ${event.message}`);
-            } else if (event.type === "error") {
-              this.error(event.message);
-            }
-          },
-    });
-    const result = await session.completion;
-    finalText = result.finalText || "";
-
-    if (!this.jsonEnabled() && finalText.trim()) {
-      this.log("");
-      this.log(finalText.trim());
-    }
-
-    return {
-      provider: result.provider,
-      exitCode: result.exitCode,
-      file: subject.file.path,
-      service: subject.service.name,
-      finalText,
-    };
-  }
-}

package/lib/cli/commands/logs.mjs

@@ -1,47 +0,0 @@
-import { Args, Command, Flags } from "@oclif/core";
-import { sharedFlags } from "../command-helpers.mjs";
-import { readLogTail } from "../../runner/logs.mjs";
-import { getServiceLogRefs, loadCurrentRunArtifact, resolveFileSubject } from "../viewer.mjs";
-import path from "path";
-
-export default class LogsCommand extends Command {
-  static summary = "Show backend log tails relevant to one file from the latest run";
-
-  static enableJsonFlag = true;
-
-  static args = {
-    file: Args.string({
-      description: "Optional file path; defaults to the first failed file",
-      required: false,
-    }),
-  };
-
-  static flags = {
-    ...sharedFlags,
-    tail: Flags.integer({
-      description: "Number of lines to show from each log",
-      default: 40,
-    }),
-  };
-
-  async run() {
-    const { args, flags } = await this.parse(LogsCommand);
-    const productDir = flags.dir || process.cwd();
-    const runArtifact = loadCurrentRunArtifact(productDir);
-    const subject = resolveFileSubject(runArtifact, args.file || null, flags.service || null);
-    const logs = getServiceLogRefs(runArtifact, subject.service.name).map((entry) => ({
-      ...entry,
-      lines: readLogTail(path.join(productDir, entry.path), flags.tail),
-    }));
-
-    if (!this.jsonEnabled()) {
-      for (const entry of logs) {
-        this.log(`${entry.runtimeLabel}`);
-        this.log(`  ${entry.path}`);
-        for (const line of entry.lines) this.log(`  ${line}`);
-      }
-    }
-
-    return logs;
-  }
-}

package/lib/cli/commands/show.mjs

@@ -1,47 +0,0 @@
-import { Args, Command, Flags } from "@oclif/core";
-import { sharedFlags } from "../command-helpers.mjs";
-import { formatFileDetail, loadCurrentRunArtifact, resolveFileSubject } from "../viewer.mjs";
-
-export default class ShowCommand extends Command {
-  static summary = "Show the most useful details for one file from the latest run";
-
-  static enableJsonFlag = true;
-
-  static args = {
-    file: Args.string({
-      description: "File path to inspect; defaults to the first failed file",
-      required: false,
-    }),
-  };
-
-  static flags = {
-    ...sharedFlags,
-    "log-tail": Flags.integer({
-      description: "Number of backend log lines to include",
-      default: 12,
-    }),
-  };
-
-  async run() {
-    const { args, flags } = await this.parse(ShowCommand);
-    const productDir = flags.dir || process.cwd();
-    const runArtifact = loadCurrentRunArtifact(productDir);
-    const subject = resolveFileSubject(runArtifact, args.file || null, flags.service || null);
-    const result = {
-      file: subject.file,
-      suite: {
-        name: subject.suite.name,
-        type: subject.suite.type,
-      },
-      service: {
-        name: subject.service.name,
-      },
-    };
-    if (!this.jsonEnabled()) {
-      for (const line of formatFileDetail(productDir, runArtifact, subject, { logTail: flags["log-tail"] })) {
-        this.log(line);
-      }
-    }
-    return result;
-  }
-}

package/lib/cli/commands/watch.mjs

@@ -1,23 +0,0 @@
-import React, { createElement } from "react";
-import { Command } from "@oclif/core";
-import { render } from "ink";
-import { sharedFlags } from "../command-helpers.mjs";
-import { WatchApp } from "../tui/watch-app.mjs";
-
-export default class WatchCommand extends Command {
-  static summary = "Open an interactive viewer for the latest run artifact";
-
-  static flags = sharedFlags;
-
-  async run() {
-    const { flags } = await this.parse(WatchCommand);
-    const productDir = flags.dir || process.cwd();
-    const app = render(
-      createElement(WatchApp, {
-        productDir,
-        serviceFilter: flags.service || null,
-      })
-    );
-    await app.waitUntilExit();
-  }
-}

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

@@ -1 +0,0 @@
-export { RunSessionApp as RunApp } from "./run-session-app.mjs";