@elench/testkit 0.1.87 → 0.1.88

package/lib/cli/commands/assistant.mjs

@@ -0,0 +1,84 @@
+import React, { createElement } from "react";
+import { Command, Flags } from "@oclif/core";
+import { render } from "ink";
+import { sharedFlags, resolveConfigsForCommand } from "../command-helpers.mjs";
+import { createAssistantState } from "../assistant/state.mjs";
+import { loadLatestRunArtifact, resolveFileSubject } from "../viewer.mjs";
+
+export default class AssistantCommand extends Command {
+  static summary = "Launch the interactive testkit assistant";
+
+  static enableJsonFlag = true;
+
+  static flags = {
+    ...sharedFlags,
+    provider: Flags.string({
+      description: "Assistant provider",
+      options: ["auto", "claude", "codex"],
+      default: "auto",
+    }),
+    pane: Flags.string({
+      description: "Initial workbench pane",
+      options: ["detail", "artifacts", "logs", "setup"],
+      default: "detail",
+    }),
+    file: Flags.string({
+      description: "Initial file selection",
+    }),
+    message: Flags.string({
+      description: "Run one assistant turn non-interactively",
+    }),
+  };
+
+  async run() {
+    const { flags } = await this.parse(AssistantCommand);
+    const { allConfigs } = await resolveConfigsForCommand(flags);
+    const productDir = allConfigs[0]?.productDir || process.cwd();
+    const assistantState = createAssistantState({
+      productDir,
+      provider: flags.provider,
+      initialPane: flags.pane,
+      configs: allConfigs,
+    });
+
+    await assistantState.loadLatestArtifact();
+    if (flags.file) {
+      try {
+        const artifact = loadLatestRunArtifact(productDir);
+        const subject = resolveFileSubject(artifact, flags.file, flags.service || null);
+        assistantState.revealFile(subject.service.name, subject.file.path);
+      } catch {
+        // Ignore missing initial selection.
+      }
+    } else if (flags.service) {
+      assistantState.revealService(flags.service);
+    }
+
+    const interactive = process.stdout.isTTY && !this.jsonEnabled() && !flags.message;
+    if (!interactive) {
+      if (flags.message) {
+        await assistantState.submitInput(flags.message);
+      }
+      const snapshot = assistantState.getSnapshot();
+      if (!this.jsonEnabled()) {
+        for (const message of snapshot.messages) {
+          this.log(`${message.role}: ${message.text}`);
+        }
+      }
+      return snapshot;
+    }
+
+    const { AssistantApp } = await import("../tui/assistant-app.mjs");
+    const app = render(
+      createElement(AssistantApp, {
+        assistantState,
+        stdout: process.stdout,
+        productDir,
+      }),
+      { stdout: process.stdout, exitOnCtrlC: false }
+    );
+
+    await app.waitUntilExit();
+    return assistantState.getSnapshot();
+  }
+}

package/lib/cli/entrypoint.mjs

@@ -1,14 +1,13 @@
 export function normalizeCliArgs(argv) {
   const topLevelCommands = new Set([
+    "assistant",
     "run",
-    "inspect",
     "status",
     "destroy",
     "cleanup",
     "discover",
     "typecheck",
     "doctor",
-    "investigate",
     "browser",
     "db",
     "help",
@@ -41,19 +40,48 @@ export function normalizeCliArgs(argv) {
   ]);
   const positionals = findPositionals(argv, valueFlags);
   const firstPositional = positionals[0] || null;
+  const interactiveTty = process.stdout.isTTY;
+  const runFlagPresent = argv.some((value) =>
+    [
+      "--type",
+      "-t",
+      "--suite",
+      "-s",
+      "--file",
+      "-f",
+      "--workers",
+      "--file-timeout-seconds",
+      "--shard",
+      "--seed",
+      "--write-status",
+      "--allow-partial-status",
+      "--ignore-skip-rules",
+      "--output-mode",
+      "--debug",
+    ].includes(value)
+  );
   const shouldPrefixRun =
-    !firstPositional ||
-    runTypeShortcuts.has(firstPositional.value) ||
-    !topLevelCommands.has(firstPositional.value);
+    (!firstPositional && !interactiveTty) ||
+    runTypeShortcuts.has(firstPositional?.value) ||
+    runFlagPresent ||
+    !topLevelCommands.has(firstPositional?.value);
 
-  if (shouldPrefixRun) {
-    return ["run", ...argv];
+  if (!firstPositional && interactiveTty && !runFlagPresent) {
+    return ["assistant", ...argv];
   }
 
-  if (topLevelCommands.has(firstPositional.value) && argv[0] !== firstPositional.value) {
+  if (!shouldPrefixRun && topLevelCommands.has(firstPositional?.value) && argv[0] !== firstPositional.value) {
     return reorderCommandArgs(argv, positionals);
   }
 
+  if (!topLevelCommands.has(firstPositional?.value) && interactiveTty && !runFlagPresent) {
+    return ["assistant", "--message", argv.join(" ")];
+  }
+
+  if (shouldPrefixRun) {
+    return ["run", ...argv];
+  }
+
   return argv;
 }
 

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

@@ -0,0 +1,131 @@
+import React, { createElement, useEffect, useMemo, useState } from "react";
+import { Box, Text, useAnimation, useApp, useInput } from "ink";
+import { bold, dim, yellow } from "../presentation/colors.mjs";
+import { getTerminalWidth } from "../presentation/terminal-layout.mjs";
+import { buildInspectPaneContent } from "./detail-pane.mjs";
+
+const SPINNER_FRAMES = ["|", "/", "-", "\\"];
+
+export function AssistantApp({ assistantState, stdout, productDir } = {}) {
+  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.tab) {
+      const panes = ["detail", "artifacts", "logs", "setup"];
+      const index = panes.indexOf(snapshot.workbench.paneMode || "detail");
+      assistantState.setPaneMode(panes[(index + 1) % panes.length]);
+      return;
+    }
+    if (isPrintableInput(input, key)) {
+      assistantState.appendComposer(input);
+    }
+  });
+
+  const terminalWidth = getTerminalWidth(stdout, 100);
+  const transcriptWidth = Math.max(54, Math.floor(terminalWidth * 0.58));
+  const contextWidth = Math.max(26, terminalWidth - transcriptWidth - 1);
+  const spinner = SPINNER_FRAMES[frame % SPINNER_FRAMES.length];
+  const contextPane = useMemo(
+    () =>
+      buildInspectPaneContent({
+        productDir,
+        snapshot: snapshot.workbench,
+        paneMode: snapshot.workbench.paneMode,
+        logTail: 12,
+      }),
+    [productDir, snapshot.workbench]
+  );
+
+  return createElement(
+    Box,
+    { flexDirection: "column" },
+    createElement(Text, null, dim(buildHeader(snapshot, spinner))),
+    snapshot.notice ? createElement(Text, null, yellow(snapshot.notice)) : null,
+    createElement(
+      Box,
+      { flexDirection: "row", marginTop: 1 },
+      createElement(
+        Box,
+        { width: transcriptWidth, flexDirection: "column", paddingRight: 1 },
+        ...buildTranscriptLines(snapshot).map((line, index) => createElement(Text, { key: `line-${index}` }, line))
+      ),
+      createElement(
+        Box,
+        { width: contextWidth, flexDirection: "column", paddingLeft: 1 },
+        createElement(Text, null, bold(contextPane.title)),
+        createElement(Text, null, ""),
+        ...contextPane.lines.slice(0, 34).map((line, index) => createElement(Text, { key: `pane-${index}` }, line))
+      )
+    ),
+    createElement(Text, null, ""),
+    createElement(Text, null, dim("Enter send · Tab cycle pane · q quit")),
+    createElement(Text, null, bold("> "), snapshot.composer || dim("Ask testkit or use /run, /file, /discover, /status"))
+  );
+}
+
+function buildHeader(snapshot, spinner) {
+  const workbench = snapshot.workbench;
+  const status = snapshot.busy ? `${spinner} ${snapshot.activeStatus || "working"}` : "ready";
+  const selection = workbench.selectedEntry?.label || workbench.selectedEntry?.filePath || "no selection";
+  return [`testkit assistant`, `provider ${snapshot.provider}`, status, selection].join(" · ");
+}
+
+function buildTranscriptLines(snapshot) {
+  const lines = [];
+  for (const message of snapshot.messages.slice(-28)) {
+    const prefix = rolePrefix(message.role, message.toolName);
+    const messageLines = String(message.text || "").split(/\r?\n/);
+    for (const [index, line] of messageLines.entries()) {
+      lines.push(index === 0 ? `${prefix}${line}` : `  ${line}`);
+    }
+    lines.push("");
+  }
+  if (snapshot.busy && snapshot.messages.length === 0) {
+    lines.push("assistant is starting...");
+  }
+  return lines.slice(-40);
+}
+
+function rolePrefix(role, toolName) {
+  if (role === "user") return "you> ";
+  if (role === "assistant") return "tk> ";
+  if (role === "tool") return `${toolName || "tool"}> `;
+  return "sys> ";
+}
+
+function isPrintableInput(input, key) {
+  return Boolean(
+    input &&
+      input.length === 1 &&
+      !key.ctrl &&
+      !key.meta &&
+      !key.return &&
+      !key.escape &&
+      !key.tab
+  );
+}

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

@@ -1,6 +1,6 @@
 {
   "name": "@elench/next-analysis",
-  "version": "0.1.87",
+  "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.87",
+  "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.87"
+    "@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.87",
+  "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.87",
+  "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.87",
+  "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.87",
-    "@elench/testkit-bridge": "0.1.87",
-    "@elench/testkit-protocol": "0.1.87",
-    "@elench/ts-analysis": "0.1.87",
+    "@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/inspect.mjs

@@ -1,124 +0,0 @@
-import React, { createElement } from "react";
-import { Command, Flags } from "@oclif/core";
-import { render } from "ink";
-import { sharedFlags } from "../command-helpers.mjs";
-import { loadCurrentRunArtifact, loadLatestRunArtifact, resolveFileSubject } from "../viewer.mjs";
-import { createInspectState } from "../tui/inspect-state.mjs";
-import { InspectApp } from "../tui/inspect-app.mjs";
-import { buildInspectPaneContent } from "../tui/detail-pane.mjs";
-import { hydrateInspectStateFromArtifact } from "../tui/inspect-artifact-adapter.mjs";
-
-export default class InspectCommand extends Command {
-  static summary = "Inspect the latest run or a live run in one unified interface";
-
-  static enableJsonFlag = true;
-
-  static flags = {
-    ...sharedFlags,
-    file: Flags.string({
-      description: "File path to inspect; defaults to the first failed file",
-    }),
-    live: Flags.boolean({
-      description: "Inspect the live run artifact instead of the latest completed run",
-      default: false,
-    }),
-    pane: Flags.string({
-      description: "Initial pane",
-      options: ["detail", "artifacts", "logs", "setup"],
-      default: "detail",
-    }),
-    "log-tail": Flags.integer({
-      description: "Number of backend log lines to include in detail/log panes",
-      default: 12,
-    }),
-  };
-
-  async run() {
-    const { flags } = await this.parse(InspectCommand);
-    const productDir = flags.dir || process.cwd();
-    const interactive = process.stdout.isTTY && !this.jsonEnabled();
-
-    if (!interactive) {
-      const artifact = loadArtifact(productDir, flags.live);
-      const inspectState = createInspectState({ dataSource: flags.live ? "live" : "artifact" });
-      hydrateInspectStateFromArtifact(inspectState, artifact);
-      inspectState.setPaneMode(flags.pane);
-      applyInitialSelection(inspectState, artifact, flags.file || null, flags.service || null);
-      const snapshot = inspectState.getSnapshot();
-      const pane = buildInspectPaneContent({
-        productDir,
-        snapshot,
-        paneMode: flags.pane,
-        logTail: flags["log-tail"],
-      });
-      const payload = {
-        source: flags.live ? "live" : "latest",
-        pane: flags.pane,
-        selection: snapshot.selectedEntry,
-        lines: pane.lines,
-        data: pane.data,
-      };
-      if (!this.jsonEnabled()) {
-        for (const line of pane.lines) {
-          this.log(line);
-        }
-      }
-      return payload;
-    }
-
-    const artifact = loadArtifact(productDir, flags.live);
-    const inspectState = createInspectState({ dataSource: flags.live ? "live" : "artifact" });
-    hydrateInspectStateFromArtifact(inspectState, artifact);
-    inspectState.setPaneMode(flags.pane);
-    applyInitialSelection(inspectState, artifact, flags.file || null, flags.service || null);
-
-    const app = render(
-      createElement(InspectApp, {
-        inspectState,
-        stdout: process.stdout,
-        productDir,
-      }),
-      { stdout: process.stdout, exitOnCtrlC: false }
-    );
-
-    let interval = null;
-    if (flags.live) {
-      interval = setInterval(() => {
-        try {
-          const liveArtifact = loadCurrentRunArtifact(productDir);
-          hydrateInspectStateFromArtifact(inspectState, liveArtifact);
-          inspectState.setPaneMode(flags.pane);
-          applyInitialSelection(inspectState, liveArtifact, flags.file || null, flags.service || null);
-        } catch {
-          // Ignore polling misses while the live artifact is being rewritten.
-        }
-      }, 1000);
-    }
-
-    try {
-      await app.waitUntilExit();
-    } finally {
-      if (interval) clearInterval(interval);
-    }
-
-    return {
-      source: flags.live ? "live" : "latest",
-      pane: flags.pane,
-    };
-  }
-}
-
-function loadArtifact(productDir, live) {
-  return live ? loadCurrentRunArtifact(productDir) : loadLatestRunArtifact(productDir);
-}
-
-function applyInitialSelection(inspectState, artifact, fileSelector, serviceFilter) {
-  if (fileSelector) {
-    const subject = resolveFileSubject(artifact, fileSelector, serviceFilter || null);
-    inspectState.revealFile(subject.service.name, subject.file.path);
-    return;
-  }
-  if (serviceFilter) {
-    inspectState.revealService(serviceFilter);
-  }
-}

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