@elench/testkit 0.1.108 → 0.1.110

package/README.md

@@ -35,7 +35,7 @@ npx @elench/testkit --type int
 npx @elench/testkit --type dal
 npx @elench/testkit --type e2e
 npx @elench/testkit --type int,e2e,dal
-npx @elench/testkit --type pw
+npx @elench/testkit --type ui
 
 # Parallel file execution
 npx @elench/testkit --workers 8
@@ -44,7 +44,7 @@ npx @elench/testkit --workers 8
 npx @elench/testkit --file-timeout-seconds 60
 
 # Specific service / suite
-npx @elench/testkit --service frontend --type pw -s navigation
+npx @elench/testkit --service frontend --type ui -s navigation
 npx @elench/testkit --service api --type int -s health
 npx @elench/testkit --type int,e2e,dal -s dal:queries
 
@@ -183,9 +183,8 @@ export default defineConfig({
 ```
 
 ```ts
-// playwright.config.ts
-import { defineConfig } from "@elench/testkit/playwright";
-import { devices } from "@playwright/test";
+// ui.config.ts
+import { defineConfig, devices } from "@elench/testkit/ui";
 
 export default defineConfig({
   testDir: "./__testkit__",
@@ -589,7 +588,7 @@ Example layouts:
 
 - `src/api/routes/__testkit__/auth/me.int.testkit.ts`
 - `src/db/__testkit__/sessions/count-type.dal.testkit.ts`
-- `frontend/__testkit__/navigation/navigation.pw.testkit.ts`
+- `frontend/__testkit__/navigation/navigation.ui.testkit.ts`
 - `src/internal/handler/__testkit__/repos/crud.int.testkit.ts`
 
 `testkit` uses these suffixes automatically:
@@ -599,7 +598,9 @@ Example layouts:
 - `*.scenario.testkit.ts`
 - `*.dal.testkit.ts`
 - `*.load.testkit.ts`
-- `*.pw.testkit.ts`
+- `*.ui.testkit.ts`
+
+See [docs/test-types.md](docs/test-types.md) for the canonical type model.
 
 Ownership is inferred from:
 
@@ -645,9 +646,8 @@ identifier plus canonical metadata such as:
 - `path`
 - `service`
 - `suiteName`
-- `selectionType`
+- `type`
 - `internalType`
-- `framework`
 - `skipped`
 - `skipReason`
 - `locks`

package/lib/app/doctor.mjs

@@ -31,12 +31,12 @@ export async function runDoctor(options = {}) {
 
   const playwrightViolations = findPlaywrightRuntimeImportViolations(productDir);
   checks.push({
-    code: "playwright-runtime-imports",
+    code: "ui-runtime-imports",
     level: playwrightViolations.length === 0 ? "pass" : "fail",
     message:
       playwrightViolations.length === 0
-        ? "No runtime @playwright/test imports found in testkit Playwright suites"
-        : `Found ${playwrightViolations.length} Playwright runtime import violation(s)`,
+        ? "No runtime @playwright/test imports found in testkit UI suites"
+        : `Found ${playwrightViolations.length} UI runtime import violation(s); import from @elench/testkit/ui instead`,
     details: playwrightViolations,
   });
 
@@ -51,7 +51,7 @@ export async function runDoctor(options = {}) {
     details: configImportViolations,
   });
 
-  const hasBrowserOrNextWork = discovery.files.some((entry) => entry.selectionType === "pw");
+  const hasBrowserOrNextWork = discovery.files.some((entry) => entry.type === "ui");
   if (hasBrowserOrNextWork) {
     const nodeCount = discovery.coverageGraph?.nodes?.length || 0;
     checks.push({
@@ -159,7 +159,7 @@ function collectFiles(rootDir, out = []) {
       collectFiles(absolutePath, out);
       continue;
     }
-    if (entry.isFile() && entry.name.endsWith(".pw.testkit.ts")) {
+    if (entry.isFile() && (entry.name.endsWith(".ui.testkit.ts") || entry.name.endsWith(".ui.testkit.ts"))) {
       out.push(absolutePath);
     }
   }

package/lib/app/typecheck.mjs

@@ -83,7 +83,7 @@ function writeRootTypecheckConfig({ productDir, configFile, outputDir }) {
       "**/*.load.testkit.ts",
       "**/__testkit__/helpers/**/*.ts",
     ],
-    exclude: ["node_modules", "dist", ".testkit", "**/*.pw.testkit.ts"],
+    exclude: ["node_modules", "dist", ".testkit", "**/*.ui.testkit.ts", "**/*.ui.testkit.ts"],
   };
   fs.writeFileSync(tsconfigPath, `${JSON.stringify(config, null, 2)}\n`);
   return tsconfigPath;
@@ -104,14 +104,15 @@ function writeNextServiceTypecheckConfig({ productDir, cwd, outputDir, serviceNa
     }),
     include: [
       serviceExists(serviceDir, "next-env.d.ts") ? relativeJsonPath(tsconfigPath, path.join(serviceDir, "next-env.d.ts")) : undefined,
-      relativeGlob(tsconfigPath, serviceDir, "src/**/*.pw.testkit.ts"),
+      relativeGlob(tsconfigPath, serviceDir, "src/**/*.ui.testkit.ts"),
+      relativeGlob(tsconfigPath, serviceDir, "src/**/*.ui.testkit.ts"),
       relativeGlob(tsconfigPath, serviceDir, "tests/playwright-fixtures/**/*.ts"),
       relativeGlob(tsconfigPath, serviceDir, "tests/playwright-fixtures/**/*.tsx"),
       relativeGlob(tsconfigPath, serviceDir, "tests/playwright-fixtures/**/*.mts"),
       relativeGlob(tsconfigPath, serviceDir, ".next/types/**/*.ts"),
       relativeGlob(tsconfigPath, serviceDir, ".next/dev/types/**/*.ts"),
-      relativeGlob(tsconfigPath, serviceDir, ".next-testkit/**/dist/types/**/*.ts"),
-      relativeGlob(tsconfigPath, serviceDir, ".next-testkit/**/dist/dev/types/**/*.ts"),
+      relativeGlob(tsconfigPath, productDir, ".next-testkit/**/dist/types/**/*.ts"),
+      relativeGlob(tsconfigPath, productDir, ".next-testkit/**/dist/dev/types/**/*.ts"),
     ].filter(Boolean),
     exclude: ["node_modules", ".next/cache", ".next/dev"],
   };
@@ -195,7 +196,7 @@ function packageTypePaths(tsconfigPath) {
     "@elench/testkit/config": [relativeJsonPath(tsconfigPath, path.join(PACKAGE_ROOT, "lib", "config-api", "index.d.ts"))],
     "@elench/testkit/drizzle": [relativeJsonPath(tsconfigPath, path.join(PACKAGE_ROOT, "lib", "drizzle", "index.d.ts"))],
     "@elench/testkit/env": [relativeJsonPath(tsconfigPath, path.join(PACKAGE_ROOT, "lib", "env", "index.d.ts"))],
-    "@elench/testkit/playwright": [relativeJsonPath(tsconfigPath, path.join(PACKAGE_ROOT, "lib", "playwright", "index.d.ts"))],
+    "@elench/testkit/ui": [relativeJsonPath(tsconfigPath, path.join(PACKAGE_ROOT, "lib", "ui", "index.d.ts"))],
     "@elench/testkit/runtime": [relativeJsonPath(tsconfigPath, path.join(PACKAGE_ROOT, "lib", "runtime", "index.d.ts"))],
     "@elench/testkit/vitest": [relativeJsonPath(tsconfigPath, path.join(PACKAGE_ROOT, "lib", "vitest", "index.d.ts"))],
   };

package/lib/bundler/index.mjs

@@ -10,6 +10,7 @@ const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)),
 const ROOT_ENTRY = path.join(PACKAGE_ROOT, "lib", "index.mjs");
 const CONFIG_ENTRY = path.join(PACKAGE_ROOT, "lib", "config-api", "index.mjs");
 const RUNTIME_ENTRY = path.join(PACKAGE_ROOT, "lib", "runtime", "index.mjs");
+const MANIFEST_FILE = "manifest.json";
 const bundleCache = new Map();
 
 export async function bundleK6File({
@@ -22,9 +23,18 @@ export async function bundleK6File({
   fs.mkdirSync(bundleDir, { recursive: true });
 
   const configFile = findConfigFile(productDir);
-  const cacheKey = await buildCacheKey(absoluteSource, configFile);
+  const metadata = await buildCacheMetadata(absoluteSource, configFile);
+  const { cacheKey } = metadata;
   const cached = bundleCache.get(cacheKey);
   if (cached && fs.existsSync(cached)) {
+    updateBundleManifest(bundleDir, {
+      ...metadata,
+      serviceName: serviceName || "shared",
+      sourceFile: absoluteSource,
+      outputFile: cached,
+      entryFile: inferEntryFile(cached),
+      hasSourcemap: fileHasInlineSourcemap(cached),
+    });
     return cached;
   }
 
@@ -36,6 +46,20 @@ export async function bundleK6File({
     bundleDir,
     `${path.basename(sourceFile, path.extname(sourceFile))}-${cacheKey.slice(0, 12)}.entry.mjs`
   );
+
+  if (fs.existsSync(outputFile) && fs.existsSync(entryFile)) {
+    bundleCache.set(cacheKey, outputFile);
+    updateBundleManifest(bundleDir, {
+      ...metadata,
+      serviceName: serviceName || "shared",
+      sourceFile: absoluteSource,
+      outputFile,
+      entryFile,
+      hasSourcemap: fileHasInlineSourcemap(outputFile),
+    });
+    return outputFile;
+  }
+
   fs.writeFileSync(entryFile, buildBundleEntryModule({
     sourceFile: absoluteSource,
     configFile,
@@ -49,7 +73,7 @@ export async function bundleK6File({
     legalComments: "none",
     outfile: outputFile,
     platform: "neutral",
-    sourcemap: "inline",
+    sourcemap: bundleSourcemapEnabled() ? "inline" : false,
     target: "es2020",
     plugins: [testkitPackageAliasPlugin()],
     external: [
@@ -59,26 +83,44 @@ export async function bundleK6File({
   });
 
   bundleCache.set(cacheKey, outputFile);
+  updateBundleManifest(bundleDir, {
+    ...metadata,
+    serviceName: serviceName || "shared",
+    sourceFile: absoluteSource,
+    outputFile,
+    entryFile,
+    hasSourcemap: bundleSourcemapEnabled(),
+  });
   return outputFile;
 }
 
-async function buildCacheKey(sourceFile, configFile = null) {
+async function buildCacheMetadata(sourceFile, configFile = null) {
   const source = await fs.promises.readFile(sourceFile, "utf8");
-  const packageJson = await fs.promises.readFile(path.join(PACKAGE_ROOT, "package.json"), "utf8");
+  const packageJsonText = await fs.promises.readFile(path.join(PACKAGE_ROOT, "package.json"), "utf8");
+  const packageJson = JSON.parse(packageJsonText);
+  const sourceHash = crypto.createHash("sha256").update(source).digest("hex");
   const hash = crypto
     .createHash("sha256")
     .update(sourceFile)
     .update("\0")
     .update(source)
     .update("\0")
-    .update(packageJson);
+    .update(packageJsonText);
+  let configHash = null;
 
   if (configFile && fs.existsSync(configFile)) {
+    const configText = await fs.promises.readFile(configFile, "utf8");
+    configHash = crypto.createHash("sha256").update(configFile).update("\0").update(configText).digest("hex");
     hash.update("\0").update(configFile).update("\0");
-    hash.update(await fs.promises.readFile(configFile, "utf8"));
+    hash.update(configText);
   }
 
-  return hash.digest("hex");
+  return {
+    cacheKey: hash.digest("hex"),
+    sourceHash,
+    configHash,
+    testkitVersion: packageJson.version || null,
+  };
 }
 
 function testkitPackageAliasPlugin() {
@@ -153,3 +195,88 @@ function normalizeTestkitSuite(module) {
 }
 `;
 }
+
+function updateBundleManifest(bundleDir, entry) {
+  const manifestPath = path.join(bundleDir, MANIFEST_FILE);
+  const manifest = readBundleManifest(manifestPath);
+  const now = new Date().toISOString();
+  const existingIndex = manifest.entries.findIndex((candidate) => candidate.cacheKey === entry.cacheKey);
+  const existing = existingIndex >= 0 ? manifest.entries[existingIndex] : null;
+  const document = {
+    sourceFile: entry.sourceFile,
+    cacheKey: entry.cacheKey,
+    outputFile: entry.outputFile,
+    entryFile: entry.entryFile,
+    createdAt: existing?.createdAt || now,
+    lastUsedAt: now,
+    sizeBytes: safeSize(entry.outputFile) + safeSize(entry.entryFile),
+    testkitVersion: entry.testkitVersion,
+    configHash: entry.configHash,
+    sourceHash: entry.sourceHash,
+    hasSourcemap: Boolean(entry.hasSourcemap),
+  };
+
+  if (existingIndex >= 0) {
+    manifest.entries[existingIndex] = document;
+  } else {
+    manifest.entries.push(document);
+  }
+  manifest.entries.sort((left, right) => String(left.sourceFile).localeCompare(String(right.sourceFile)) || String(left.cacheKey).localeCompare(String(right.cacheKey)));
+  writeBundleManifest(manifestPath, manifest);
+}
+
+function readBundleManifest(manifestPath) {
+  if (!fs.existsSync(manifestPath)) {
+    return {
+      schemaVersion: 1,
+      source: "testkit-bundle-cache",
+      entries: [],
+    };
+  }
+  try {
+    const parsed = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+    return {
+      schemaVersion: 1,
+      source: "testkit-bundle-cache",
+      ...parsed,
+      entries: Array.isArray(parsed.entries) ? parsed.entries : [],
+    };
+  } catch {
+    return {
+      schemaVersion: 1,
+      source: "testkit-bundle-cache",
+      entries: [],
+    };
+  }
+}
+
+function writeBundleManifest(manifestPath, manifest) {
+  const tempPath = `${manifestPath}.${process.pid}.${Date.now()}.tmp`;
+  fs.writeFileSync(tempPath, `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
+  fs.renameSync(tempPath, manifestPath);
+}
+
+function bundleSourcemapEnabled() {
+  return process.env.TESTKIT_BUNDLE_SOURCEMAP === "1";
+}
+
+function inferEntryFile(outputFile) {
+  return outputFile.replace(/\.js$/, ".entry.mjs");
+}
+
+function safeSize(filePath) {
+  try {
+    return fs.statSync(filePath).size;
+  } catch {
+    return 0;
+  }
+}
+
+function fileHasInlineSourcemap(filePath) {
+  try {
+    const text = fs.readFileSync(filePath, "utf8");
+    return /sourceMappingURL=data:application\/json/.test(text);
+  } catch {
+    return false;
+  }
+}

package/lib/cli/args.mjs

@@ -1,11 +1,12 @@
 import path from "path";
 import { normalizeTypeValues, parseSuiteSelectors } from "../runner/suite-selection.mjs";
+import { publicTestTypeList, publicTestTypeListText } from "../domain/test-types.mjs";
 import {
   parseFileTimeoutOption,
   parseWorkersOption,
 } from "../runner/execution-config.mjs";
 
-export const POSITIONAL_TYPES = new Set(["int", "e2e", "scenario", "dal", "load", "pw", "all"]);
+export const POSITIONAL_TYPES = new Set(publicTestTypeList({ includeAll: true, includeLegacy: true }));
 export const LIFECYCLE = new Set(["status", "destroy", "cleanup"]);
 export const RESERVED = new Set([...POSITIONAL_TYPES, ...LIFECYCLE]);
 
@@ -33,7 +34,7 @@ export function resolveCliSelection({ first, second, third }) {
   } else if (first) {
     throw new Error(
       `Unknown argument "${first}". Expected a lifecycle command (status, destroy, cleanup) ` +
-      `or suite type (int, e2e, scenario, dal, load, pw, all).`
+      `or suite type (${publicTestTypeListText({ includeAll: true })}).`
     );
   }
 

package/lib/cli/assistant/app.mjs

@@ -5,6 +5,7 @@ import { RunTreeView } from "../components/blocks/run-tree.mjs";
 import { CodeBlock } from "./code-block.mjs";
 import { getComposerDisplayModel } from "./composer.mjs";
 import { MarkdownBlock } from "./markdown-block.mjs";
+import { QualitySignalStrip } from "./quality-signal-strip.mjs";
 import { buildAssistantViewModel } from "./view-model.mjs";
 import { truncateText, wrapText } from "../terminal/layout.mjs";
 
@@ -68,6 +69,7 @@ export function AssistantApp({
           onRequestClose,
         })
       : null,
+    createElement(HeaderChrome, { view }),
     view.blocks.length === 0
       ? createElement(WelcomePanel, { view })
       : createElement(Transcript, { view }),
@@ -103,6 +105,21 @@ export function AssistantApp({
   );
 }
 
+function HeaderChrome({ view }) {
+  const provider = view.welcome.rows.find(([label]) => label === "Provider")?.[1] || "";
+  return createElement(
+    Box,
+    { flexDirection: "column" },
+    createElement(Text, null, bold(view.title)),
+    provider ? createElement(Text, null, dim(provider)) : null,
+    createElement(QualitySignalStrip, {
+      signal: view.qualitySignal,
+      width: view.terminalWidth,
+    }),
+    createElement(Text, null, "")
+  );
+}
+
 function AssistantInputHandler({ assistantState, snapshot, onRequestClose }) {
   const { exit } = useApp();
 
@@ -154,6 +171,7 @@ function AssistantInputHandler({ assistantState, snapshot, onRequestClose }) {
 }
 
 function WelcomePanel({ view }) {
+  const rows = view.welcome.rows.filter(([label]) => label !== "Provider");
   return createElement(
     Box,
     {
@@ -162,10 +180,9 @@ function WelcomePanel({ view }) {
       paddingLeft: 1,
       paddingRight: 1,
     },
-    createElement(Text, null, bold(view.title)),
     createElement(Text, null, dim(view.welcome.subtitle)),
     createElement(Text, null, ""),
-    ...view.welcome.rows.map(([label, value]) => (
+    ...rows.map(([label, value]) => (
       createElement(Text, { key: label }, `${padLabel(label)} ${colorWelcomeValue(label, value)}`)
     )),
     createElement(Text, null, ""),
@@ -180,9 +197,6 @@ function Transcript({ view }) {
   return createElement(
     Box,
     { flexDirection: "column" },
-    createElement(Text, null, bold(view.title)),
-    createElement(Text, null, dim(view.welcome.rows.find(([label]) => label === "Provider")?.[1] || "")),
-    createElement(Text, null, ""),
     view.notice ? createElement(Text, null, yellow(view.notice)) : null,
     ...view.blocks.flatMap((block) => renderBlock(block, view))
   );

package/lib/cli/assistant/command-observer.mjs

@@ -1,9 +1,10 @@
 import fs from "fs";
 import path from "path";
+import { publicTestTypeList } from "../../domain/test-types.mjs";
 
 const POLL_INTERVAL_MS = 150;
 const OBSERVED_KINDS = new Set(["run", "discover", "status", "doctor", "typecheck"]);
-const RUN_KINDS = new Set(["run", "int", "e2e", "scenario", "dal", "load", "pw", "all"]);
+const RUN_KINDS = new Set(["run", ...publicTestTypeList({ includeAll: true, includeLegacy: true })]);
 
 export function createAssistantCommandObserver({
   productDir,

package/lib/cli/assistant/command-results.mjs

@@ -1,5 +1,6 @@
 import fs from "fs";
 import path from "path";
+import { publicTestTypeList } from "../../domain/test-types.mjs";
 
 export const ASSISTANT_SESSION_ENV = "TESTKIT_ASSISTANT_SESSION_ID";
 export const ASSISTANT_RESULT_DIR_ENV = "TESTKIT_ASSISTANT_RESULT_DIR";
@@ -7,7 +8,7 @@ export const ASSISTANT_COMMAND_LOG_ENV = "TESTKIT_ASSISTANT_COMMAND_LOG";
 export const ASSISTANT_COMMAND_ID_ENV = "TESTKIT_ASSISTANT_COMMAND_ID";
 export const ASSISTANT_WRAPPER_LOGGED_ENV = "TESTKIT_ASSISTANT_WRAPPER_LOGGED";
 
-const RUN_SHORTCUTS = new Set(["int", "e2e", "scenario", "dal", "load", "pw", "all"]);
+const RUN_SHORTCUTS = new Set(publicTestTypeList({ includeAll: true, includeLegacy: true }));
 const FLAGS_WITH_VALUES = new Set([
   "--dir",
   "--service",

package/lib/cli/assistant/context-pack.mjs

@@ -178,7 +178,7 @@ function appendCommandLog(event) {
 }
 
 function inferKind(args) {
-  const runShortcuts = new Set(["int", "e2e", "scenario", "dal", "load", "pw", "all"]);
+  const runShortcuts = new Set(["ui", "e2e", "scenario", "int", "dal", "load", "all"]);
   const flagsWithValues = new Set([
     "--dir",
     "--service",
@@ -248,7 +248,7 @@ function buildContextMarkdown(productDir, snapshot, paths) {
     "## Guidance",
     "- Work normally in the repository and run real commands. Testkit observes recognized Testkit commands and renders them in the assistant UI.",
     "- Prefer `testkit ...` commands when using Testkit directly; `npx testkit ...` and project scripts are also valid.",
-    "- `testkit run e2e` selects e2e suites. `testkit run pw` selects Playwright/browser suites.",
+    "- `testkit run ui` selects UI suites. `testkit run e2e` selects e2e suites.",
     "- Do not reinterpret CLI syntax after an execution failure unless `testkit run --help` confirms a syntax problem.",
     "- Use the command log and focused context files before rereading artifacts manually.",
     "- Prefer repo-local commands over guessing project-specific wrappers.",

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

@@ -15,8 +15,8 @@ export function buildAssistantPrompt({
     "You are Testkit Assistant.",
     "You are running as a coding agent inside the user's repository.",
     "Work normally: inspect files, edit files, run real shell commands, and iterate until the user's request is handled.",
-    "When using Testkit, run real commands such as `testkit discover`, `testkit run e2e`, `testkit run pw`, `npx testkit run int`, or the repository's package scripts.",
-    "`testkit run e2e` selects e2e suites. `testkit run pw` selects Playwright/browser suites. Choose commands from the user's request and the command reference, not from Testkit prompt routing.",
+    "When using Testkit, run real commands such as `testkit discover`, `testkit run ui`, `testkit run e2e`, `npx testkit run int`, or the repository's package scripts.",
+    "`testkit run ui` selects UI suites. `testkit run e2e` selects e2e suites. Choose commands from the user's request and the command reference, not from Testkit prompt routing.",
     "Testkit observes recognized Testkit commands and renders rich assistant UI from the real command output, sidecars, and artifacts.",
     "Do not respond with a JSON tool envelope. Give the user a normal final answer when you are done.",
     "",

package/lib/cli/assistant/quality-signal-strip.mjs

@@ -0,0 +1,103 @@
+import React, { createElement } from "react";
+import { Box, Text } from "ink";
+import { cyan, dim, green, red, yellow } from "../terminal/colors.mjs";
+import { measureWidth, truncateText } from "../terminal/layout.mjs";
+
+const LABEL_ITEM_SEPARATOR = "  ";
+const ITEM_SEPARATOR = " · ";
+const MIN_TRUNCATED_ITEM_WIDTH = 4;
+
+export function fitQualitySignal(signal, { width = 100 } = {}) {
+  const availableWidth = Math.max(0, Number(width) || 0);
+  const label = normalizeText(signal?.label) || "Quality signal";
+  const items = normalizeItems(signal?.items);
+  if (availableWidth <= 0) return { label: "", items: [] };
+  if (items.length === 0) {
+    return {
+      label: truncateText(label, availableWidth),
+      items: [],
+    };
+  }
+
+  for (let count = items.length; count >= 1; count -= 1) {
+    const candidate = {
+      label,
+      items: items.slice(0, count),
+    };
+    if (measureWidth(formatQualitySignalText(candidate)) <= availableWidth) return candidate;
+  }
+
+  const firstItemWidth = availableWidth - measureWidth(label) - measureWidth(LABEL_ITEM_SEPARATOR);
+  if (firstItemWidth >= MIN_TRUNCATED_ITEM_WIDTH) {
+    return {
+      label,
+      items: [
+        {
+          ...items[0],
+          text: truncateText(items[0].text, firstItemWidth),
+        },
+      ],
+    };
+  }
+
+  return {
+    label: truncateText(label, availableWidth),
+    items: [],
+  };
+}
+
+export function formatQualitySignalText(signal) {
+  const label = normalizeText(signal?.label) || "Quality signal";
+  const items = normalizeItems(signal?.items);
+  if (items.length === 0) return label;
+  return `${label}${LABEL_ITEM_SEPARATOR}${items.map((item) => item.text).join(ITEM_SEPARATOR)}`;
+}
+
+export function QualitySignalStrip({ signal, width = 100 } = {}) {
+  const fitted = fitQualitySignal(signal, { width });
+  if (!fitted.label) return null;
+  return createElement(
+    Box,
+    {
+      height: 1,
+      flexDirection: "row",
+    },
+    createElement(
+      Text,
+      null,
+      dim(fitted.label),
+      fitted.items.length > 0 ? LABEL_ITEM_SEPARATOR : "",
+      ...fitted.items.flatMap((item, index) => [
+        index > 0 ? dim(ITEM_SEPARATOR) : "",
+        colorQualitySignalItem(item),
+      ])
+    )
+  );
+}
+
+function normalizeItems(items) {
+  return (Array.isArray(items) ? items : [])
+    .map((item) => ({
+      id: normalizeText(item?.id),
+      text: normalizeText(item?.text),
+      tone: normalizeTone(item?.tone),
+    }))
+    .filter((item) => item.text);
+}
+
+function normalizeText(value) {
+  return String(value ?? "").replace(/\s+/g, " ").trim();
+}
+
+function normalizeTone(value) {
+  if (value === "good" || value === "warning" || value === "danger" || value === "progress") return value;
+  return "neutral";
+}
+
+function colorQualitySignalItem(item) {
+  if (item.tone === "good") return green(item.text);
+  if (item.tone === "warning") return yellow(item.text);
+  if (item.tone === "danger") return red(item.text);
+  if (item.tone === "progress") return cyan(item.text);
+  return item.text;
+}

package/lib/cli/assistant/transcript-text.mjs

@@ -3,10 +3,11 @@ import { truncateText, wrapText } from "../terminal/layout.mjs";
 import { buildAssistantViewModel } from "./view-model.mjs";
 import { renderCodeBlockText } from "./code-block.mjs";
 import { renderMarkdownToAnsi } from "./markdown-block.mjs";
+import { formatQualitySignalText, fitQualitySignal } from "./quality-signal-strip.mjs";
 
 export function renderAssistantSnapshotText(snapshot, { cwd = process.cwd(), ansi = false, width = 100 } = {}) {
   const view = buildAssistantViewModel(snapshot || {}, { cwd, terminalWidth: width });
-  const lines = [view.title, view.welcome.rows.find(([label]) => label === "Provider")?.[1] || ""]
+  const lines = [view.title, view.welcome.rows.find(([label]) => label === "Provider")?.[1] || "", formatQualitySignalText(fitQualitySignal(view.qualitySignal, { width }))]
     .filter(Boolean);
   for (const block of view.blocks || []) {
     lines.push("");