@elench/testkit 0.1.98 → 0.1.99

package/lib/cli/commands/status.mjs

@@ -1,7 +1,8 @@
 import { Command } from "@oclif/core";
-import { sharedFlags } from "./flags.mjs";
+import { sharedFlags } from "../command-flags.mjs";
 import { executeStatusOperation } from "../operations/status/operation.mjs";
 import { renderStatusResult } from "../renderers/status/text.mjs";
+import { withAssistantCommandResult } from "../assistant/command-results.mjs";
 
 export default class StatusCommand extends Command {
   static summary = "Show local testkit state";
@@ -11,13 +12,15 @@ export default class StatusCommand extends Command {
   static flags = sharedFlags;
 
   async run() {
-    const { flags } = await this.parse(StatusCommand);
-    const results = await executeStatusOperation(flags);
-    if (!this.jsonEnabled()) {
-      for (const result of results) {
-        for (const line of renderStatusResult(result)) this.log(line);
+    return withAssistantCommandResult("status", async () => {
+      const { flags } = await this.parse(StatusCommand);
+      const results = await executeStatusOperation(flags);
+      if (!this.jsonEnabled()) {
+        for (const result of results) {
+          for (const line of renderStatusResult(result)) this.log(line);
+        }
       }
-    }
-    return { ok: true, results };
+      return { ok: true, results };
+    });
   }
 }

package/lib/cli/commands/typecheck.mjs

@@ -1,6 +1,7 @@
 import { Command, Flags } from "@oclif/core";
 import { executeTypecheckOperation } from "../operations/typecheck/operation.mjs";
 import { renderTypecheckResult } from "../renderers/typecheck/text.mjs";
+import { withAssistantCommandResult } from "../assistant/command-results.mjs";
 
 export default class TypecheckCommand extends Command {
   static summary = "Typecheck testkit config, helpers, and suites";
@@ -14,15 +15,17 @@ export default class TypecheckCommand extends Command {
   };
 
   async run() {
-    const { flags } = await this.parse(TypecheckCommand);
-    const result = await executeTypecheckOperation(flags);
+    return withAssistantCommandResult("typecheck", async () => {
+      const { flags } = await this.parse(TypecheckCommand);
+      const result = await executeTypecheckOperation(flags);
 
-    if (!this.jsonEnabled()) {
-      for (const line of renderTypecheckResult(result)) {
-        this.log(line);
+      if (!this.jsonEnabled()) {
+        for (const line of renderTypecheckResult(result)) {
+          this.log(line);
+        }
       }
-    }
 
-    return result;
+      return result;
+    });
   }
 }

package/lib/cli/entrypoint.mjs

@@ -1,4 +1,7 @@
 export function normalizeCliArgs(argv) {
+  if (argv[0] === "help") return normalizeHelpInvocation(argv);
+  if (isOclifBuiltinInvocation(argv)) return argv;
+
   const topLevelCommands = new Set([
     "assistant",
     "run",
@@ -10,11 +13,6 @@ export function normalizeCliArgs(argv) {
     "doctor",
     "browser",
     "db",
-    "help",
-    "--help",
-    "-h",
-    "--version",
-    "-v",
   ]);
   const runTypeShortcuts = new Set(["int", "e2e", "scenario", "dal", "load", "pw", "all"]);
   const valueFlags = new Set([
@@ -95,6 +93,17 @@ export function normalizeCliArgs(argv) {
   return argv;
 }
 
+function isOclifBuiltinInvocation(argv) {
+  const first = argv[0];
+  if (first === "--help" || first === "-h" || first === "--version" || first === "-v") return true;
+  return false;
+}
+
+function normalizeHelpInvocation(argv) {
+  if (!argv[1]) return ["--help"];
+  return [argv[1], ...argv.slice(2), "--help"];
+}
+
 function findPositionals(args, flagsWithValues) {
   const positionals = [];
   for (let index = 0; index < args.length; index += 1) {

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

@@ -1,6 +1,6 @@
 {
   "name": "@elench/next-analysis",
-  "version": "0.1.98",
+  "version": "0.1.99",
   "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.98",
+  "version": "0.1.99",
   "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.98"
+    "@elench/testkit-protocol": "0.1.99"
   },
   "private": false
 }

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

@@ -1,6 +1,6 @@
 {
   "name": "@elench/testkit-protocol",
-  "version": "0.1.98",
+  "version": "0.1.99",
   "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.98",
+  "version": "0.1.99",
   "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.98",
+  "version": "0.1.99",
   "description": "Assistant-first CLI for running, inspecting, and debugging local testkit suites",
   "type": "module",
   "workspaces": [
@@ -58,7 +58,7 @@
   "scripts": {
     "build:packages": "npm --workspace packages/testkit-protocol run build && npm --workspace packages/ts-analysis run build && npm --workspace packages/next-analysis run build && npm --workspace packages/testkit-bridge run build",
     "typecheck:packages": "npm --workspace packages/testkit-protocol run typecheck && npm --workspace packages/ts-analysis run typecheck && npm --workspace packages/next-analysis run typecheck && npm --workspace packages/testkit-bridge run typecheck && npm --workspace packages/testkit-extension run compile",
-    "test": "npm run build:packages && vitest run",
+    "test": "npm run build:packages && vitest run && node scripts/live-sandbox/harness.mjs",
     "test:audit": "node scripts/test-boundary-audit.mjs",
     "test:unit": "npm run build:packages && npm run test:audit && vitest run --config vitest.unit.config.mjs",
     "test:integration": "npm run build:packages && vitest run test/integration",
@@ -83,10 +83,10 @@
   },
   "dependencies": {
     "@babel/code-frame": "^7.29.0",
-    "@elench/next-analysis": "0.1.98",
-    "@elench/testkit-bridge": "0.1.98",
-    "@elench/testkit-protocol": "0.1.98",
-    "@elench/ts-analysis": "0.1.98",
+    "@elench/next-analysis": "0.1.99",
+    "@elench/testkit-bridge": "0.1.99",
+    "@elench/testkit-protocol": "0.1.99",
+    "@elench/ts-analysis": "0.1.99",
     "@oclif/core": "^4.10.6",
     "esbuild": "^0.25.11",
     "execa": "^9.5.0",

package/lib/cli/assistant/protocol.mjs

@@ -1,67 +0,0 @@
-export function buildAssistantResponseContract({ tools = [] } = {}) {
-  return [
-    "Respond with exactly one JSON object and no surrounding commentary.",
-    'Use {"type":"answer","message":"..."} when you can answer directly.',
-    'Use {"type":"tool","tool":"<name>","arguments":{...},"commentary":"..."} when you need testkit to act before you answer.',
-    "Only request one tool at a time.",
-    `Available tools: ${tools.map((tool) => tool.name).join(", ") || "none"}.`,
-  ].join("\n");
-}
-
-export function parseAssistantEnvelope(text) {
-  const raw = String(text || "").trim();
-  if (!raw) {
-    return {
-      type: "answer",
-      message: "",
-    };
-  }
-
-  const candidate = extractJsonObject(raw);
-  if (!candidate) {
-    return {
-      type: "answer",
-      message: raw,
-    };
-  }
-
-  try {
-    const parsed = JSON.parse(candidate);
-    if (parsed?.type === "tool" && parsed.tool) {
-      return {
-        type: "tool",
-        tool: String(parsed.tool),
-        arguments: normalizePlainObject(parsed.arguments),
-        commentary: parsed.commentary ? String(parsed.commentary) : "",
-      };
-    }
-    if (parsed?.type === "answer") {
-      return {
-        type: "answer",
-        message: parsed.message ? String(parsed.message) : "",
-      };
-    }
-  } catch {
-    // Fall through to raw answer.
-  }
-
-  return {
-    type: "answer",
-    message: raw,
-  };
-}
-
-function extractJsonObject(text) {
-  const fencedMatch = text.match(/```json\s*([\s\S]*?)```/i);
-  if (fencedMatch?.[1]) return fencedMatch[1].trim();
-
-  const start = text.indexOf("{");
-  const end = text.lastIndexOf("}");
-  if (start < 0 || end <= start) return null;
-  return text.slice(start, end + 1);
-}
-
-function normalizePlainObject(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) return {};
-  return value;
-}