@solidxai/core 0.1.13-beta.11 → 0.1.13-beta.12

package/dist/testing/runner/run-from-metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-from-metadata.js","sourceRoot":"","sources":["../../../src/testing/runner/run-from-metadata.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Reporter } from \"../reporter/reporter.types\";\nimport type { TestingMetadata, TestingDataRecord } from \"../contracts/testing-metadata.types\";\nimport type { ApiAdapterOptions } from \"../adapters/api/api.types\";\nimport type { PlaywrightAdapterOptions } from \"../adapters/ui/ui.types\";\nimport { ApiAdapter } from \"../adapters/api/api-adapter\";\nimport { registerApiSteps } from \"../steps/api\";\nimport { registerUiSteps } from \"../steps/ui\";\nimport { registerAssertSteps } from \"../steps/assert\";\nimport { registerUtilSteps } from \"../steps/util\";\nimport { registerTestSteps } from \"../steps/test\";\nimport { SimpleResourceStore } from \"../core/resource-store\";\nimport { StepRegistry } from \"../core/step-registry\";\nimport { SpecRegistry } from \"../core/spec-registry\";\nimport { TestingEngine } from \"../core/testing-engine\";\nimport { filterScenarios } from \"./scenario-filter\";\nimport { ensureUiStarted, scenarioNeedsUi } from \"./lifecycle\";\nimport { ConsoleReporter } from \"../reporter/console-reporter\";\n\n\nfunction buildTestDataIndex(data?: TestingDataRecord[]): Record<string, Record<string, any>> {\n  const index: Record<string, Record<string, any>> = {};\n  if (!Array.isArray(data)) return index;\n  for (const record of data) {\n    if (!record?.modelUserKey || !record?.recUserKeyValue) continue;\n    if (!index[record.modelUserKey]) {\n      index[record.modelUserKey] = {};\n    }\n    index[record.modelUserKey][record.recUserKeyValue] = record.data ?? {};\n  }\n  return index;\n}\n\nexport type RunnerOptions = {\n  metadata: TestingMetadata;\n  scenarioIds?: string[];\n  includeTags?: string[];\n  skipScenarioIds?: string[];\n  reporter?: Reporter;\n  api?: ApiAdapterOptions;\n  ui?: PlaywrightAdapterOptions;\n  defaults?: { timeoutMs?: number; retries?: number };\n  options?: { printApiLogs?: boolean };\n  specs?: (registry: SpecRegistry) => void;\n};\n\nexport async function runFromMetadata(opts: RunnerOptions): Promise<void> {\n  const startedAt = Date.now();\n  const registry = new StepRegistry();\n  registerApiSteps(registry);\n  registerUiSteps(registry);\n  registerAssertSteps(registry);\n  registerUtilSteps(registry);\n  registerTestSteps(registry);\n\n  const engine = new TestingEngine(registry, opts.defaults);\n  const scenarios = filterScenarios(opts.metadata.testing.scenarios, {\n    scenarioIds: opts.scenarioIds,\n    includeTags: opts.includeTags,\n    skipScenarioIds: opts.skipScenarioIds,\n  });\n\n  const specRegistry = new SpecRegistry();\n  const testData = buildTestDataIndex(opts.metadata.testing?.data);\n  if (opts.specs) {\n    opts.specs(specRegistry);\n  }\n\n  const resources = new SimpleResourceStore();\n  const reporter = opts.reporter ?? new ConsoleReporter();\n  const api = new ApiAdapter(opts.api);\n  const { PlaywrightAdapter } = await import(\"../adapters/ui/playwright-adapter\");\n  const ui = new PlaywrightAdapter(opts.ui);\n  const ctxBase = { resources, reporter, api, ui, specRegistry, testData, options: opts.options };\n  const uiStarted = { value: false };\n  let passed = 0;\n  let failed = 0;\n  let runError: unknown;\n\n  try {\n    for (const scenario of scenarios) {\n      if (scenarioNeedsUi(scenario)) {\n        await ensureUiStarted(ctxBase, uiStarted);\n      }\n      try {\n        await engine.runScenario(scenario, ctxBase);\n        passed += 1;\n      } catch (error) {\n        failed += 1;\n        runError = error;\n        throw error;\n      }\n    }\n  } finally {\n    reporter.onRunEnd?.({\n      ok: !runError,\n      total: scenarios.length,\n      passed,\n      failed,\n      durationMs: Date.now() - startedAt,\n    });\n    if (uiStarted.value) {\n      await ui.stop();\n    }\n  }\n}\n"]}
+{"version":3,"file":"run-from-metadata.js","sourceRoot":"","sources":["../../../src/testing/runner/run-from-metadata.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,0CA4DC;AArGD,6DAAyD;AACzD,sCAAgD;AAChD,oCAA8C;AAC9C,4CAAsD;AACtD,wCAAkD;AAClD,wCAAkD;AAClD,2DAA6D;AAC7D,yDAAqD;AACrD,yDAAqD;AACrD,2DAAuD;AACvD,uDAAoD;AACpD,2CAA+D;AAC/D,mEAA+D;AAG/D,SAAS,kBAAkB,CAAC,IAA0B;IACpD,MAAM,KAAK,GAAwC,EAAE,CAAC;IACtD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,KAAK,MAAM,MAAM,IAAI,IAAI,EAAE,CAAC;QAC1B,IAAI,CAAC,MAAM,EAAE,YAAY,IAAI,CAAC,MAAM,EAAE,eAAe;YAAE,SAAS;QAChE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YAChC,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;QAClC,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;IACzE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAeM,KAAK,UAAU,eAAe,CAAC,IAAmB;IACvD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,IAAI,4BAAY,EAAE,CAAC;IACpC,IAAA,sBAAgB,EAAC,QAAQ,CAAC,CAAC;IAC3B,IAAA,oBAAe,EAAC,QAAQ,CAAC,CAAC;IAC1B,IAAA,4BAAmB,EAAC,QAAQ,CAAC,CAAC;IAC9B,IAAA,wBAAiB,EAAC,QAAQ,CAAC,CAAC;IAC5B,IAAA,wBAAiB,EAAC,QAAQ,CAAC,CAAC;IAE5B,MAAM,MAAM,GAAG,IAAI,8BAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAG,IAAA,iCAAe,EAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE;QACjE,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,eAAe,EAAE,IAAI,CAAC,eAAe;KACtC,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,IAAI,4BAAY,EAAE,CAAC;IACxC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACjE,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,oCAAmB,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,kCAAe,EAAE,CAAC;IACxD,QAAQ,CAAC,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,IAAI,wBAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,EAAE,iBAAiB,EAAE,GAAG,wDAAa,mCAAmC,GAAC,CAAC;IAChF,MAAM,EAAE,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IAChG,MAAM,SAAS,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACnC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,QAAiB,CAAC;IAEtB,IAAI,CAAC;QACH,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,IAAA,2BAAe,EAAC,QAAQ,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAA,2BAAe,EAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAC5C,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAC5C,MAAM,IAAI,CAAC,CAAC;YACd,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,CAAC,CAAC;gBACZ,QAAQ,GAAG,KAAK,CAAC;gBACjB,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAClB,EAAE,EAAE,CAAC,QAAQ;YACb,KAAK,EAAE,SAAS,CAAC,MAAM;YACvB,MAAM;YACN,MAAM;YACN,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACnC,CAAC,CAAC;QACH,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;YACpB,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["import type { Reporter } from \"../reporter/reporter.types\";\nimport type { TestingMetadata, TestingDataRecord } from \"../contracts/testing-metadata.types\";\nimport type { ApiAdapterOptions } from \"../adapters/api/api.types\";\nimport type { PlaywrightAdapterOptions } from \"../adapters/ui/ui.types\";\nimport { ApiAdapter } from \"../adapters/api/api-adapter\";\nimport { registerApiSteps } from \"../steps/api\";\nimport { registerUiSteps } from \"../steps/ui\";\nimport { registerAssertSteps } from \"../steps/assert\";\nimport { registerUtilSteps } from \"../steps/util\";\nimport { registerTestSteps } from \"../steps/test\";\nimport { SimpleResourceStore } from \"../core/resource-store\";\nimport { StepRegistry } from \"../core/step-registry\";\nimport { SpecRegistry } from \"../core/spec-registry\";\nimport { TestingEngine } from \"../core/testing-engine\";\nimport { filterScenarios } from \"./scenario-filter\";\nimport { ensureUiStarted, scenarioNeedsUi } from \"./lifecycle\";\nimport { ConsoleReporter } from \"../reporter/console-reporter\";\n\n\nfunction buildTestDataIndex(data?: TestingDataRecord[]): Record<string, Record<string, any>> {\n  const index: Record<string, Record<string, any>> = {};\n  if (!Array.isArray(data)) return index;\n  for (const record of data) {\n    if (!record?.modelUserKey || !record?.recUserKeyValue) continue;\n    if (!index[record.modelUserKey]) {\n      index[record.modelUserKey] = {};\n    }\n    index[record.modelUserKey][record.recUserKeyValue] = record.data ?? {};\n  }\n  return index;\n}\n\nexport type RunnerOptions = {\n  metadata: TestingMetadata;\n  scenarioIds?: string[];\n  includeTags?: string[];\n  skipScenarioIds?: string[];\n  reporter?: Reporter;\n  api?: ApiAdapterOptions;\n  ui?: PlaywrightAdapterOptions;\n  defaults?: { timeoutMs?: number; retries?: number };\n  options?: { printApiLogs?: boolean };\n  specs?: (registry: SpecRegistry) => void;\n};\n\nexport async function runFromMetadata(opts: RunnerOptions): Promise<void> {\n  const startedAt = Date.now();\n  const registry = new StepRegistry();\n  registerApiSteps(registry);\n  registerUiSteps(registry);\n  registerAssertSteps(registry);\n  registerUtilSteps(registry);\n  registerTestSteps(registry);\n\n  const engine = new TestingEngine(registry, opts.defaults);\n  const scenarios = filterScenarios(opts.metadata.testing.scenarios, {\n    scenarioIds: opts.scenarioIds,\n    includeTags: opts.includeTags,\n    skipScenarioIds: opts.skipScenarioIds,\n  });\n\n  const specRegistry = new SpecRegistry();\n  const testData = buildTestDataIndex(opts.metadata.testing?.data);\n  if (opts.specs) {\n    opts.specs(specRegistry);\n  }\n\n  const resources = new SimpleResourceStore();\n  const reporter = opts.reporter ?? new ConsoleReporter();\n  reporter.onRunStart?.({ total: scenarios.length });\n  const api = new ApiAdapter(opts.api);\n  const { PlaywrightAdapter } = await import(\"../adapters/ui/playwright-adapter\");\n  const ui = new PlaywrightAdapter(opts.ui);\n  const ctxBase = { resources, reporter, api, ui, specRegistry, testData, options: opts.options };\n  const uiStarted = { value: false };\n  let passed = 0;\n  let failed = 0;\n  let runError: unknown;\n\n  try {\n    for (const scenario of scenarios) {\n      if (scenarioNeedsUi(scenario)) {\n        await ensureUiStarted(ctxBase, uiStarted);\n      }\n      try {\n        await engine.runScenario(scenario, ctxBase);\n        passed += 1;\n      } catch (error) {\n        failed += 1;\n        runError = error;\n        throw error;\n      }\n    }\n  } finally {\n    reporter.onRunEnd?.({\n      ok: !runError,\n      total: scenarios.length,\n      passed,\n      failed,\n      durationMs: Date.now() - startedAt,\n    });\n    if (uiStarted.value) {\n      await ui.stop();\n    }\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solidxai/core",
-  "version": "0.1.13-beta.11",
+  "version": "0.1.13-beta.12",
   "description": "This module is a NestJS module containing all the required core providers required by a Solid application",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/commands/run-tests.command.ts

@@ -3,6 +3,7 @@ import { SubCommand, CommandRunner, Option } from 'nest-commander';
 import * as path from 'path';
 import { ModuleMetadataHelperService } from 'src/helpers/module-metadata-helper.service';
 import { ConsoleReporter } from 'src/testing/reporter/console-reporter';
+import { ProgressReporter } from 'src/testing/reporter/progress-reporter';
 import { WebhookReporter } from 'src/testing/reporter/webhook-reporter';
 import { runFromMetadata } from 'src/testing/runner/run-from-metadata';
 import type { TestingMetadata } from 'src/testing/contracts/testing-metadata.types';
@@ -27,6 +28,7 @@ interface TestRunCommandOptions {
   listSpecs?: boolean;
   printApiLogs?: boolean;
   runName?: string;
+  progress?: boolean;
 }
 
 @SubCommand({
@@ -106,9 +108,12 @@ export class TestRunCommand extends CommandRunner {
 
       const webhookUrl = process.env.SOLIDCTL_WEBHOOK_URL;
       const runName = options?.runName ?? `run-${Date.now()}`;
-      const reporter = webhookUrl
+      const baseReporter = webhookUrl
         ? new WebhookReporter(webhookUrl, runName)
         : new ConsoleReporter();
+      const reporter = options?.progress === false
+        ? baseReporter
+        : new ProgressReporter(baseReporter);
 
       try {
         await runFromMetadata({
@@ -138,8 +143,8 @@ export class TestRunCommand extends CommandRunner {
         console.error('Run tests command failed');
         process.exitCode = 1;
       } finally {
-        if (reporter instanceof WebhookReporter) {
-          await reporter.flush(Number(process.exitCode ?? 0));
+        if (baseReporter instanceof WebhookReporter) {
+          await baseReporter.flush(Number(process.exitCode ?? 0));
         }
       }
       return;
@@ -289,6 +294,15 @@ export class TestRunCommand extends CommandRunner {
   parseRunName(val: string): string {
     return val;
   }
+
+  @Option({
+    flags: '--no-progress',
+    description: 'Disable the interactive test progress footer.',
+    required: false,
+  })
+  parseNoProgress(): boolean {
+    return false;
+  }
 }
 
 function splitCsv(value?: string): string[] | undefined {

package/src/testing/README.md

@@ -479,10 +479,11 @@ Common `test run` flags (all pass through solidctl unchanged):
 - `--ui-navigation-timeout-ms <number>` — default wait for `ui.goto`
 - `--timeout-ms <number>` / `--retries <number>` — scenario-level guard and retry count
 - `--scenario-ids <ids>` / `--include-tags <tags>` / `--skip-scenario-ids <ids>`
+- `--no-progress` — disable the interactive test progress footer
 
 ## Add A New Step (SOP)
 1. Create a new `*.step.ts` in the right domain folder.
 2. Implement a `registerXSteps(registry)` function and `registry.register("op.name", handler)`.
 3. Validate required `step.with` fields and throw clear errors.
 4. Use adapters via `ctx.api` / `ctx.ui` and update `ctx.last` when helpful.
-5. Export and register it from the domain `index.ts`.
+5. Export and register it from the domain `index.ts`.

package/src/testing/reporter/console-reporter.ts

@@ -150,6 +150,10 @@ export class ConsoleReporter implements Reporter {
   private passedScenarios = 0;
   private failedScenarios = 0;
 
+  onRunStart(_args: { total: number }): void {
+    // Progress-aware reporters use this hook; the plain console reporter has no setup.
+  }
+
   onScenarioStart(scenario: { id: string; name?: string }): void {
     const label = scenario.name ? `${scenario.id} (${scenario.name})` : scenario.id;
     console.log(`\n▶ Scenario: ${label}`);

package/src/testing/reporter/progress-reporter.ts

@@ -0,0 +1,251 @@
+import * as readline from "readline";
+import type { StepPhase } from "../contracts/runtime-context.types";
+import type { OpStep, ScenarioSpec } from "../contracts/testing-metadata.types";
+import type { SolidTestSpecResult } from "../contracts/test-spec.types";
+import type { Reporter } from "./reporter.types";
+
+const ANSI_BOLD = "\u001b[1m";
+const ANSI_BOLD_OFF = "\u001b[22m";
+const ANSI_DIM = "\u001b[2m";
+const ANSI_GREEN = "\u001b[32m";
+const ANSI_COLOR_OFF = "\u001b[39m";
+const ANSI_RED = "\u001b[31m";
+const ANSI_INVERSE = "\u001b[7m";
+const ANSI_INVERSE_OFF = "\u001b[27m";
+
+export class ProgressReporter implements Reporter {
+  private startedAt = Date.now();
+  private total = 0;
+  private completed = 0;
+  private passed = 0;
+  private failed = 0;
+  private timer?: NodeJS.Timeout;
+  private rendered = false;
+
+  constructor(private readonly delegate: Reporter) {}
+
+  onRunStart(args: { total: number }): void {
+    this.total = args.total;
+    this.startedAt = Date.now();
+    this.completed = 0;
+    this.passed = 0;
+    this.failed = 0;
+    this.delegate.onRunStart?.(args);
+    this.startTimer();
+    this.renderFooter();
+  }
+
+  onScenarioStart(scenario: ScenarioSpec): void {
+    this.withFooterPaused(() => this.delegate.onScenarioStart(scenario));
+  }
+
+  onScenarioEnd(
+    scenario: ScenarioSpec,
+    result: { ok: boolean; error?: unknown; durationMs: number },
+  ): void {
+    this.completed += 1;
+    if (result.ok) {
+      this.passed += 1;
+    } else {
+      this.failed += 1;
+    }
+    this.withFooterPaused(() => this.delegate.onScenarioEnd(scenario, result));
+  }
+
+  onStepStart(args: {
+    scenarioId: string;
+    phase: StepPhase;
+    step: OpStep;
+  }): void {
+    this.withFooterPaused(() => this.delegate.onStepStart(args));
+  }
+
+  onStepEnd(args: {
+    scenarioId: string;
+    phase: StepPhase;
+    step: OpStep;
+    ok: boolean;
+    error?: unknown;
+    durationMs: number;
+  }): void {
+    this.withFooterPaused(() => this.delegate.onStepEnd(args));
+  }
+
+  onSpecResult(args: {
+    scenarioId: string;
+    specId: string;
+    stepName?: string;
+    result: SolidTestSpecResult;
+  }): void {
+    this.withFooterPaused(() => this.delegate.onSpecResult?.(args));
+  }
+
+  attach(args: {
+    scenarioId: string;
+    name: string;
+    contentType: string;
+    data: Buffer | string;
+  }): void {
+    this.withFooterPaused(() => this.delegate.attach?.(args));
+  }
+
+  onRunEnd(args: {
+    ok: boolean;
+    total: number;
+    passed: number;
+    failed: number;
+    durationMs: number;
+  }): void {
+    this.completed = args.passed + args.failed;
+    this.passed = args.passed;
+    this.failed = args.failed;
+    this.total = args.total;
+    this.stopTimer();
+    this.withFooterPaused(() => this.delegate.onRunEnd?.(args), false);
+  }
+
+  private startTimer(): void {
+    this.stopTimer();
+    if (!this.isInteractive()) {
+      return;
+    }
+    this.timer = setInterval(() => this.renderFooter(), 1_000);
+    this.timer.unref?.();
+  }
+
+  private stopTimer(): void {
+    if (!this.timer) {
+      return;
+    }
+    clearInterval(this.timer);
+    this.timer = undefined;
+  }
+
+  private withFooterPaused(callback: () => void, renderAfter = true): void {
+    this.clearFooter();
+    callback();
+    if (renderAfter) {
+      this.renderFooter();
+    }
+  }
+
+  private renderFooter(): void {
+    if (!this.isInteractive()) {
+      return;
+    }
+
+    const terminalWidth = process.stdout.columns || 80;
+    const elapsed = formatElapsed(Date.now() - this.startedAt);
+    const progressText = `${this.completed}/${this.total}`;
+    const resultText = `${ANSI_GREEN}${this.passed} passed${ANSI_COLOR_OFF}${ANSI_DIM} | ${ANSI_BOLD_OFF}${this.failed ? ANSI_RED : ANSI_DIM}${this.failed} failed${this.failed ? ANSI_COLOR_OFF : ANSI_BOLD_OFF}`;
+    const footer = [
+      `${ANSI_BOLD}Tests${ANSI_BOLD_OFF}: ${this.renderProgressBar(terminalWidth)} ${progressText}`,
+      `${ANSI_BOLD}Elapsed${ANSI_BOLD_OFF}: ${elapsed}`,
+      resultText,
+    ].join(`${ANSI_DIM} | ${ANSI_BOLD_OFF}`);
+
+    readline.clearLine(process.stdout, 0);
+    readline.cursorTo(process.stdout, 0);
+    process.stdout.write(truncateAnsiText(`${ANSI_INVERSE} ${footer} ${ANSI_INVERSE_OFF}`, terminalWidth));
+    this.rendered = true;
+  }
+
+  private clearFooter(): void {
+    if (!this.rendered || !this.isInteractive()) {
+      return;
+    }
+    readline.clearLine(process.stdout, 0);
+    readline.cursorTo(process.stdout, 0);
+    this.rendered = false;
+  }
+
+  private renderProgressBar(terminalWidth: number): string {
+    const width = terminalWidth >= 120 ? 30 : terminalWidth >= 90 ? 22 : 14;
+    const ratio = this.total > 0 ? Math.min(1, this.completed / this.total) : 0;
+    const filled = Math.round(width * ratio);
+    const empty = Math.max(0, width - filled);
+    return `[${ANSI_GREEN}${"=".repeat(filled)}${ANSI_COLOR_OFF}${" ".repeat(empty)}]`;
+  }
+
+  private isInteractive(): boolean {
+    return Boolean(process.stdout.isTTY || process.env.SOLIDCTL_TEST_PROGRESS === "1");
+  }
+}
+
+function formatElapsed(durationMs: number): string {
+  const totalSeconds = Math.max(0, Math.floor(durationMs / 1000));
+  const minutes = Math.floor(totalSeconds / 60);
+  const seconds = totalSeconds % 60;
+  if (minutes < 60) {
+    return `${minutes}:${seconds.toString().padStart(2, "0")}`;
+  }
+  const hours = Math.floor(minutes / 60);
+  const remainingMinutes = minutes % 60;
+  return `${hours}:${remainingMinutes.toString().padStart(2, "0")}:${seconds.toString().padStart(2, "0")}`;
+}
+
+function truncateAnsiText(text: string, maxWidth: number): string {
+  if (maxWidth <= 0) {
+    return "";
+  }
+
+  let visibleWidth = 0;
+  let index = 0;
+  let output = "";
+  let hasEscape = false;
+
+  while (index < text.length) {
+    if (text[index] === "\u001b") {
+      const match = /\u001b\[[0-9;]*m/.exec(text.slice(index));
+      if (!match) {
+        break;
+      }
+      output += match[0];
+      hasEscape = true;
+      index += match[0].length;
+      continue;
+    }
+
+    if (visibleWidth >= maxWidth) {
+      break;
+    }
+
+    output += text[index];
+    visibleWidth += 1;
+    index += 1;
+  }
+
+  if (index < text.length && maxWidth >= 1) {
+    output = trimAnsiText(output, maxWidth - 1) + "…";
+  }
+
+  if (hasEscape && !output.endsWith(ANSI_INVERSE_OFF)) {
+    output += ANSI_INVERSE_OFF;
+  }
+
+  return output;
+}
+
+function trimAnsiText(text: string, maxWidth: number): string {
+  let visibleWidth = 0;
+  let index = 0;
+  let output = "";
+
+  while (index < text.length && visibleWidth < maxWidth) {
+    if (text[index] === "\u001b") {
+      const match = /\u001b\[[0-9;]*m/.exec(text.slice(index));
+      if (!match) {
+        break;
+      }
+      output += match[0];
+      index += match[0].length;
+      continue;
+    }
+
+    output += text[index];
+    visibleWidth += 1;
+    index += 1;
+  }
+
+  return output;
+}

package/src/testing/reporter/reporter.types.ts

@@ -3,6 +3,9 @@ import type { OpStep, ScenarioSpec } from "../contracts/testing-metadata.types";
 import type { SolidTestSpecResult } from "../contracts/test-spec.types";
 
 export interface Reporter {
+  onRunStart?(args: {
+    total: number;
+  }): void;
   onScenarioStart(scenario: ScenarioSpec): void;
   onScenarioEnd(
     scenario: ScenarioSpec,

package/src/testing/runner/run-from-metadata.ts

@@ -67,6 +67,7 @@ export async function runFromMetadata(opts: RunnerOptions): Promise<void> {
 
   const resources = new SimpleResourceStore();
   const reporter = opts.reporter ?? new ConsoleReporter();
+  reporter.onRunStart?.({ total: scenarios.length });
   const api = new ApiAdapter(opts.api);
   const { PlaywrightAdapter } = await import("../adapters/ui/playwright-adapter");
   const ui = new PlaywrightAdapter(opts.ui);