- large run log data blocks start collapsed, with per-block and expand/collapse-all toggles; limits set by RUN_LOG_DATA_COLLAPSE_BYTES and RUN_LOG_DATA_COLLAPSE_LINES - copy logs button copies the filtered logs as plain text - GET /manifest.json serves the app version and public client settings, cached by the UI in localStorage - bump version to 1.24.2
21 KiB
21 KiB
Changelog
All notable changes to this project will be documented in this file.
1.24.2 - 2026-10-02
Changes since 1.24.1:
Added
- Large run log data blocks start collapsed behind a "Show data (size, lines)" toggle: data whose pretty-printed JSON is over
RUN_LOG_DATA_COLLAPSE_BYTES(default 256) bytes orRUN_LOG_DATA_COLLAPSE_LINES(default 5) lines. An "Expand data" / "Collapse data" button next to the Logs heading opens or closes all of them. - "Copy logs" button on the run page: copies the currently filtered logs to the clipboard as plain text, with every data block expanded.
GET /manifest.json: public client configuration served by the server - the app name and version, and the run log data limits. The UI caches it inlocalStorageand revalidates it on page load and when the tab is refocused after a while.
Changed
- The sidebar footer shows the server's version (from
/manifest.json); its tooltip suggests reloading the page when it differs from the version the UI was built with. - Run log data blocks are aligned with the context/message column instead of the level column.
1.24.1 - 2026-10-02
Changes since 1.24.0:
Added
context.assert(fn, description, details?): optionaldetailsargument. On failure, theassertion:faillog entry stores{ details, error }as data (erroris the exception message whenfnthrew), so large diagnostics such as a response body can stay out of the message. The exported e2e runtime accepts and prints it too.- The "Step N passed" log entry carries the step's return value as data.
- File names in the run Artifacts and scenario Files tables link to the file content, opening it in a new tab (shown inline when the browser can display it).
Changed
- For assertion failures, the "Step N failed" and "Snippet X failed" log entries name only the assertion (
Assertion failed: <description>) instead of repeating the failure details. The step run's description keeps the full message. - Log output shows elapsed time in whole seconds (
+14s), matching the stored timestamp resolution.
1.24.0 - 2026-10-01
Changes since 1.23.0:
Added
- Code reference in the UI: a (?) button next to the Code label on the step and snippet create/edit pages opens a modal documenting the script runtime - the globals (
context,expect,console, andargsin snippets) and everycontextmember with examples, including pitfalls such as awaitinggetStepOutput()andassert(), anddownloadFile()not sending the browser's cookies.
Changed
ModalUI component: newsize="lg"for long, document-like content. Dialogs are now capped to the viewport height and their body scrolls, instead of overflowing the screen.
1.23.0 - 2026-10-01
Changes since 1.22.2:
Added
- Run log entries now carry a
context(where the message was generated:step:<N>,snippet:<alias>,assertion:pass/fail, orrun) and adatafield:context.log/warn/errorandconsole.*split their arguments so strings join intomessagewhile object/array arguments are kept separate asdata(JSON), instead of beingJSON.stringify'd into the message text. - Added a
debuglog level (context.debug(),console.debug()), alongsidelog/warn/error. - New
LogOutputUI component: a terminal-style log viewer on the run detail page, color-coded by level, with an elapsed-time-since-start column, a context tag, anddatarendered pretty-printed in a separate block below the message. The full log list is shown (no more pagination), capped to a scrollable block. - Run log CSV/Markdown export (
GET /scenarios/:id/runs/:runId/export) include the newcontextanddatacolumns/blocks; the logs search (?q=) also matchescontext.
1.22.2 - 2026-10-01
Changes since 1.22.1:
Added
- MIT license (
LICENSE), declared in allpackage.jsonfiles and the README. - The Docker image includes the license notices of everything it ships:
scripts/third-party-licenses.mjscollects the license of every production dependency of the client and server, the Node.js license is added, and the result is served at/licenses.txt, linked as "Licenses" in the sidebar footer. - OCI image labels for title, version, license and source; CI passes the version as the
VERSIONbuild arg.
Fixed
- The Docker image keeps packages'
LICENSE.md/NOTICE.mdfiles, which the 1.22.1 slimming step deleted along with other Markdown files.
1.22.1 - 2026-10-01
Changes since 1.22.0:
Changed
- The Docker image is about 20% smaller (1.09 GB → 876 MB on disk, 251 MB → 220 MB compressed). Production dependencies and Chromium are installed in a separate stage that drops files nothing loads at runtime (source maps, TypeScript sources and declarations, docs, TypeORM's browser build, better-sqlite3's C sources, Playwright's ffmpeg). The runtime image is
debian:bookworm-slimwith only thenodebinary, so it no longer containsnpm,npx,yarnorcorepack.
1.22.0 - 2026-10-01
Changes since 1.21.1:
Added
- The Export Scenario dialog lists the snippets the scenario uses (including ones used only through other snippets), all checked by default. A selected snippet is exported once per version the scenario uses: the latest for
runSnippet("alias"), plus each version pinned withalias@N.GET /scenarios/:id/exporttakes the newsnippetIdsquery parameter for this. - The Export Scenario dialog shows the scenario version next to its name and id.
1.21.1 - 2026-10-01
Changes since 1.21.0:
Changed
- The credential page hides the credential data when it opens; a Reveal button shows it and Hide hides it again. The data is not rendered on the page until revealed.
Added
- A
RevealableCodeBlockUI component (a CodeBlock that starts hidden behind a Reveal/Hide button), with a Storybook story.
1.21.0 - 2026-10-01
Changes since 1.20.2:
Added
- UUID badges show a small colored circle in front of the short id. Its color comes from the first 6 hex digits of the UUID, so the same id always gets the same color, and its border uses the badge text color to stay visible in both themes.
- UUID badges get lighter on hover to show they can be clicked.
Badgeaccepts an optionalclassName.- A Storybook "Colors" story for UuidBadge with six sample ids and a button to randomize them.
1.20.2 - 2026-09-30
Changes since 1.20.1:
Fixed
- Text contrast now meets WCAG AA (4.5:1) in both themes:
- the "Live" refresh label and the table sort icon use a new
--color-primary-texttoken (dark lime in the light theme) instead of the light lime brand color; - the idle refresh label is no longer dimmed with opacity;
- the light theme's danger button is a little darker, and the dark theme's danger hover is lighter so its dark text stays readable;
- syntax highlighting colors are defined per theme (
--hl-*tokens), darker in the light theme; - muted text is slightly darker in the light theme.
- the "Live" refresh label and the table sort icon use a new
Added
- A Storybook "Accessibility / Contrast" page that measures the contrast of the most contrast-prone components in both themes.
- Storybook accessibility checks now fail the tests on violations (
a11y.test: 'error'). The Colors story shows each token's current value per theme and includes the syntax colors.
1.20.1 - 2026-09-30
Changes since 1.20.0:
Added
- Storybook stories for AutoRefreshIndicator, CodeBlock, CodeEditor, MarkdownContent, Modal, Notification, Search, Textarea, Toast and UuidBadge, with interaction tests where the component has behavior. The DescriptionList story covers all four layouts.
Changed
- Updated all client and server dependencies to the latest versions within their ranges, including React 19.3, Storybook 10.6, NestJS 11.2, TypeORM 0.3.31 and Playwright 1.63 (the Docker image now ships HeadlessChrome 153).
- The Storybook tests are part of the pre-commit checks.
Fixed
- Code flagged by the stricter React hooks lint rules: the runs list no longer writes refs during render, and the scenario list, scenario files and sessions list no longer set state synchronously inside effects.
1.20.0 - 2026-09-30
Changes since 1.19.3:
Added
- Database migrations: the SQLite schema is now managed by TypeORM migrations (
server/src/database/migrations/) instead ofsynchronize. The Docker container applies pending migrations before starting the server, and the server refuses to start while migrations are pending. npm -w server run migration:run,migration:showandmigration:generatescripts; the workflow for schema changes is described indocs/development.md.- A test that fails when an entity changes without a matching migration.
Changed
- Databases created before migrations (by
synchronize) are adopted automatically: the initial migration is recorded as applied without changing them. - Tests now build their database from the migrations instead of
synchronize.
Fixed
- Startup failures were logged but the process exited with code 0; they now exit with code 1.
1.19.3 - 2026-09-30
Changes since 1.19.2:
Changed
- The Docker image runs with
NODE_ENV=production. - The origins allowed to call the API cross-origin depend on
NODE_ENV: the Vite dev server (http://localhost:5173,http://127.0.0.1:5173) in development, the compose port (http://localhost:13000,http://127.0.0.1:13000) in production. The newCORS_ORIGINSsetting (comma separated) overrides both. ANODE_ENV=developmentin.envoverrides the image's production mode. .envis optional: compose loads it only when it exists, and every setting in.env.exampleis commented out and shows its default.
Removed
- The unused
KEYS_DIRsetting and the./keysmount incompose.yaml.
1.19.2 - 2026-09-30
Changes since 1.19.1:
Fixed
- Running a scenario from its detail page could preselect the first environment in the list instead of the scenario's default environment, depending on whether the environment list or the scenario loaded first. The default environment is now chosen when the run modal opens.
- Made the run status filter test deterministic; it could fail when the scheduler picked up the test's pending run mid-test.
1.19.1 - 2026-09-30
Changes since 1.19.0:
Changed
- Upgraded to Node.js 24: the Docker image is based on
node:24-slim, and the rootpackage.jsondeclares"engines": { "node": ">=24" }. - The server reads the app name and version (startup log, Swagger, MCP server info,
APP_NAME/APP_VERSION) from the workspace rootpackage.json. Previously local runs reported the server workspace's ownliqa-server/1.0.0; the server workspace no longer has a version.
Fixed
- Tests using a local HTTP server bind to
127.0.0.1instead oflocalhost, which could resolve to an unreachable::1inside Docker containers.
1.19.0 - 2026-09-30
Changes since 1.18.0:
Changed
- Breaking (deployment): the whole application now runs from a single image and container. The server serves the built client itself (new
CLIENT_DIRsetting, set by the image) next to the API, MCP and Swagger, so the UI moved from http://localhost:13001 to http://localhost:13000. The rootDockerfilereplacesserver/Dockerfile,client/Dockerfileandclient/nginx.conf, andcompose.yamlhas a singleliqaservice. When upgrading, rundocker compose up -d --build --remove-orphansto remove the oldserverandclientcontainers. - The image uses Playwright's headless-only Chromium build (
chromium-headless-shell, always matching the installed Playwright version) with only the libraries it needs, instead of Debian's desktopchromiumpackage. Fonts are now DejaVu and Liberation (metric-compatible with Arial/Times) instead of Noto. Together with clearing the npm cache, this shrinks the image from 1.76 GB to 1.07 GB.
1.18.0 - 2026-09-30
Changes since 1.17.0:
Added
- Added a central import:
POST /import, an Import page in the UI, and theimport_yamlMCP tool. It takes YAML made of----separated documents, each holding one exported item or a list of items (JSON is accepted too), with any mix of environments, credentials, snippets and scenarios. All items are validated before anything is imported, and they are imported in dependency order (environments, credentials, snippets, scenarios), so a scenario can reference an environment or credential from the same file.
Changed
- The Import buttons on the scenario, snippet, credential and environment list pages use the central import. When the file holds exactly one item of the page's kind, that item is opened; otherwise the Import page shows everything that was imported.
Fixed
- Scenario exports that included the environment or credentials were not valid YAML (all entities were written into one document). Each entity is now a separate
---document.
1.17.0 - 2026-09-30
Changes since 1.16.1:
Added
- Files can be deleted from a run: a delete button (with confirmation) in the Files section of the run detail page,
DELETE /scenarios/:id/runs/:runId/files/:fileId, and thedelete_run_fileMCP tool. The stored file is removed once no scenario or run references it.
1.16.1 - 2026-09-30
Changes since 1.16.0:
Changed
- Playwright traces are now off by default (
PLAYWRIGHT_TRACE_MODEdefaults tooff), since a trace often reaches ~10 MB per run. Traces can still be enabled per run in the run modal, viatraceModeinPOST /scenarios/:id/run, or for all runs by settingPLAYWRIGHT_TRACE_MODE.
1.16.0 - 2026-09-30
Changes since 1.15.0:
Added
- Scenarios and snippets are now versioned, starting at version 1. A scenario's version goes up when its name, description, default environment, timeout or steps change; a snippet's when its alias, title, description or code changes. Saving without changes does not create a new version. Credential assignments and scenario files are not versioned.
- Each run records the scenario version it runs. The run modal has a version picker (latest by default),
POST /scenarios/:id/runand therun_scenarioMCP tool accept an optionalversion, and "Repeat run" reuses the run's version. context.runSnippet("alias@N")pins version N of a snippet;runSnippet("alias")keeps using the latest. The scenario page's "Used Snippets" section shows which snippets are pinned.- Version numbers are shown on the scenario, snippet and run pages and in the scenario and run lists.
- Added
GET /scenarios/:id/versions[/:version]andGET /snippets/:id/versions[/:version], and thelist_scenario_versions,get_scenario_version,list_snippet_versionsandget_snippet_versionMCP tools. - Scenario and snippet exports accept
?version=N(theexport_scenarioMCP tool takesversion).
Changed
- Breaking: scenario and snippet exports now include
version, and imports require it. An import restores that exact version by id + version: an existing version is left untouched, and a new one is stored under its number and becomes the latest when it is higher than the current latest. Export files from earlier releases need aversionfield added before they can be imported. - Scenario exports now include scenario and step timeouts.
- Runs keep their own copy of the steps they were created with. Editing or deleting a step no longer changes past runs, and deleting a step no longer deletes its results from past runs. Existing run steps are backfilled from the current steps on startup.
1.15.0 - 2026-09-30
Changes since 1.14.0:
Added
- Scenario runs now record a Playwright trace (screenshots and DOM snapshots) and upload it to the run's files as
trace.zipwhen the run finishes. Open it withnpx playwright show-trace trace.zipor at https://trace.playwright.dev. - Added the
PLAYWRIGHT_TRACE_MODEsetting (on(default),retain-on-failure, oroff) that controls which traces are kept. - Added a "Playwright trace" option to the run modal to override the trace mode for a single run. It defaults to the server's
PLAYWRIGHT_TRACE_MODE, served by the newGET /scenarios/run-defaultsendpoint. POST /scenarios/:id/runand therun_scenarioMCP tool accept an optionaltraceMode. The trace mode is stored on the run, shown on the run detail page, and reused by "Repeat run".
Changed
- The run modals on the scenario list and scenario detail pages now share one component.
server/data/is now git-ignored.
1.14.0 - 2026-09-30
Changes since 1.13.0:
Added
- Added a "Repeat run" button on the scenario run detail page that starts a new run of the same scenario with the same environment and "save session" setting, then navigates to it. The button is disabled when the run's environment has since been deleted.
1.13.0 - 2026-09-30
Changes since 1.12.0:
Added
- Added credential CRUD tools to the MCP server:
list_credentials,get_credential,create_credential,update_credential, anddelete_credential. Combined with the existingadd_scenario_credentialtool, credentials can now be created and attached to scenarios entirely via MCP.
1.12.0 - 2026-09-16
Changes since 1.11.0:
Added
- When a scenario or snippet step fails, a full-page screenshot and the current page HTML are captured and uploaded as run artifacts, so failures can be diagnosed from the run's file list.
1.11.0 - 2026-09-15
Changes since 1.10.1:
Added
- Added export of a scenario as a standalone, plug-and-play Playwright e2e test project (zip archive with
package.json,playwright.config.ts,test.spec.ts,README.md,.env,credentials.json,snippets/*.js, and any attached scenario files) that runs entirely independently of the liqa backend. Available as a "Export e2e test" button on the scenario detail page,GET /scenarios/:id/export-e2e, and theexport_e2e_testMCP tool. - The exported test only bundles the credentials, snippets, and attached files actually referenced (directly or transitively) by the scenario's steps.
- Added a "Used Snippets" section on the scenario detail page listing the snippets referenced by the scenario's steps, linking to each snippet's detail page. Backed by
GET /scenarios/:id/used-snippets.
1.10.1 - 2026-09-15
Changes since 1.10.0:
Added
context.runSnippet()now logs "Snippet started"/"finished"/"failed" entries, matching the automatic step start/pass/fail logging.
Changed
- Reworked the Markdown log export format: each log entry is now its own
## [level] timestampsection with the message as its body, instead of a single large table.
Fixed
- Run logs could persist out of call order (e.g. a snippet's "started" log appearing after its "finished" log) because writes were fire-and-forget and raced against each other. Log entries now carry a per-run sequence number assigned in call order, and queries/exports sort by it.
1.10.0 - 2026-09-15
Changes since 1.9.1:
Added
- Added a "Download logs" button on the scenario run detail page: opens a modal to choose Markdown (default) or CSV, then downloads the run's logs in that format.
- Added
GET /scenarios/:id/run/:runId/logs/export?format=csv|mdbackend endpoint to export a run's logs.
1.9.1 - 2026-09-15
Changes since 1.9.0:
Added
- Scenario run logs now include an automatic entry when a step starts and when it finishes (pass or fail), so step boundaries are visible in run logs even for steps that don't call
context.log/context.assertthemselves.
1.9.0 - 2026-09-15
Changes since 1.8.0:
Added
- Added
context.assert(fn, description)for scenario/snippet script steps: runs the given function, requires it to returntrue, logs the outcome (logon success,erroron failure or exception), and throws to stop the step on failure.
Changed
- Documented
context.assertindocs/scenario.md.
1.8.0 - 2026-09-15
Changes since 1.7.1:
Added
context.downloadFile()now acceptsdata:URIs, so scenario steps can save in-script generated content (e.g. a credential JWT) as a run artifact without a network fetch.
Changed
- Documented the full scenario step
contextfile API (getScenarioFiles,downloadFile) indocs/scenario.md.
1.7.1 - 2026-04-21
Changes since 1.7.0:
Added
- Added MCP tools to upload, list, and fetch scenario files using base64 content payloads.
- Added MCP tools to list run artifacts and fetch run artifact content with metadata.
Changed
- Documented MCP binary content handling for scenario files and run artifacts.
1.7.0 - 2026-04-21
Changes since 1.6.1:
Added
- Added scenario file storage and run artifact support on the backend.
- Added file management UI for scenarios and run details, including artifact lists.
- Added snippet CRUD tools to the MCP server.
Changed
- Added dynamic page titles based on the active client content.
- Extended the scenarios list to show the latest run status and timestamp.
Fixed
- Exposed file expiry metadata in scenario and run file responses.
- Disabled expired download actions in the UI while keeping the action visible.