changelog.md for @git.zone/tstest

2026-03-27 - 3.6.3 - fix(tapbundle_serverside)

add TapNodeTools cleanup hooks to stop SmartNetwork processes after tests

• replace the exported tapNodeTools singleton with a TapNodeTools class that registers cleanup on the tap instance
• run registered cleanup functions at the end of tap.start() to prevent lingering background processes from keeping Node.js alive
• stop SmartNetwork after selecting Chromium runtime ports and update smartnetwork to ^4.5.2

2026-03-27 - 3.6.2 - fix(cli,chromium-runtime)

clean up long-lived test runner resources after runs to prevent hanging processes

• call TsTest.cleanup() after non-watch CLI runs so smartexit handlers are deregistered
• terminate active WebSocket clients before closing the Chromium runtime server to release open connections cleanly

2026-03-26 - 3.6.1 - fix(chromium runtime)

encode Chromium test bundle names correctly for nested file paths

• Use replaceAll() so bundle cache filenames consistently handle test paths with multiple directory separators.
• URL-encode the bundleName query parameter before opening the Chromium test page to avoid lookup issues with generated bundle filenames.

2026-03-24 - 3.6.0 - feat(config)

migrate project metadata to .smartconfig and refresh build configuration

• replace npmextra.json with .smartconfig.json and update packaged files accordingly
• add module-level README documentation under ts/readme.md
• bump build and runtime dependencies including tsbuild, tsbundle, smartstorage, smartwatch, smartserve, and ws
• relax TypeScript compiler strictness and include Node types in tsconfig
• update README license links to point to license.md

2026-03-23 - 3.5.1 - fix(runtime)

handle expected exitCode rejection after terminating timed out test processes

• swallow the child process exitCode rejection triggered by timeout termination
• reduce unhandled rejection noise when test files exceed the configured timeout

2026-03-19 - 3.5.0 - feat(tstest)

add support for package.json before scripts during test execution

• load test:before or test:before:once once per test run from package.json scripts
• run test:before:testfile before each test file execution and pass TSTEST_FILE and TSTEST_RUNTIME environment variables
• log before-script lifecycle events and abort or skip execution when setup scripts fail

2026-03-18 - 3.4.0 - feat(tapbundle,deno)

replace smarts3 test tooling with smartstorage and pre-resolve Deno test dependencies

• switch TapNodeTools storage helper from @push.rocks/smarts3 to @push.rocks/smartstorage and rename createSmarts3() to createSmartStorage()
• update node tests and tapbundle server-side documentation to use the new smartstorage helper
• run deno install --entrypoint before executing Deno tests to resolve dependencies up front
• bump supporting development dependencies including @types/node and @push.rocks/smartshell

2026-03-09 - 3.3.2 - fix(deps)

bump dependency versions and reorder smartserve in package.json

• bump @push.rocks/smartbrowser from ^2.0.10 to ^2.0.11
• bump @push.rocks/smartfs from ^1.4.0 to ^1.5.0
• move @push.rocks/smartserve to later position in dependencies (version unchanged: ^2.0.1)

2026-03-09 - 3.3.1 - fix(serve)

migrate test HTTP server to @push.rocks/smartserve and update related dependencies

• Replace @api.global/typedserver with @push.rocks/smartserve and FileServer; use SmartServe.setHandler to serve static assets and a custom /test response.
• Export smartserve from ts/tstest.plugins.ts and remove typedserver import/export.
• Update package.json dependencies: add @push.rocks/smartserve@^2.0.1 and bump @push.rocks/smartbrowser to ^2.0.10.

2026-03-06 - 3.3.0 - feat(testfile-directives)

Add per-test file directives to control runtime permissions and flags (Deno, Node, Bun, Chromium)

• Introduce test file directive parser (ts/tstest.classes.testfile.directives.ts) to parse comments like // tstest:deno:allowAll and map them to runtime options.
• Add DENO_DEFAULT_PERMISSIONS constant and centralize Deno default flags (ts/tstest.classes.runtime.deno.ts) to avoid repeating the list.
• Integrate directives into the test runner (ts/tstest.classes.tstest.ts): read directives from test files and optional 00init.ts, merge them, and pass runtime-specific options to adapters.
• Documentation: add a "Test File Directives" section to readme.md with examples and available directives.
• Add automated tests for directives behavior (test/test.directives.node.ts).
• Bump package metadata and minor dependency updates; update package description and npmextra.json to reflect new functionality.

2026-03-03 - 3.2.0 - feat(tapbundle_serverside)

add network port discovery utilities and migrate file I/O to smartfs; refactor runtimes to use Node fs and SmartFs, update server APIs and bump dependencies

• Add tapNodeTools.findFreePort, findFreePorts and findFreePortRange to provide network port discovery and ranges for tests
• Integrate @push.rocks/smartfs (smartfsInstance) and replace many @push.rocks/smartfile.fs usages with smartfsInstance file/directory APIs
• Switch several internals to Node's fs (exported via plugins) and introduce SmartFileFactory.nodeFs() for file handling
• Replace smartchok with smartwatch for file watching and update watch/start/stop flows
• Update server instantiation to TypedServer and change addRoute usage to the new handler signature; serve bundled test directory
• Add tests for network tools and update migration/test code to use smartfsInstance
• Bump multiple dependencies (e.g. @api.global/typedserver, @push.rocks/smartfile/smartfs/smartnetwork/smarts3/smartwatch) and @git.zone/tsbuild

2026-01-25 - 3.1.8 - fix(tapbundle)

treat tests that call tools.allowFailure() as passing and update tests to use tools parameter

• Set testResult.ok to this.failureAllowed so allowed failures are considered passing in the tap test runner implementation (ts_tapbundle/tapbundle.classes.taptest.ts).
• Updated multiple tests to accept the tools parameter and call tools.allowFailure() where failures are intended (test/tapbundle/test.performance-metrics.ts, test/tstest/test.fail.ts, test/tstest/test.failing-with-logs.ts).
• Prevents intentionally-failing tests from skewing timing/metric calculations and preserves console logs for allowed failures.

2026-01-25 - 3.1.7 - fix(tap-parser)

append newline to WebSocket tap log messages to ensure proper line-by-line processing

• Fixes handling of WebSocket console.log messages by appending a trailing newline before processing to avoid merged lines.
• Modified ts/tstest.classes.tap.parser.ts: handleTapLog now calls _processLog(tapLog + '\n').

2026-01-19 - 3.1.6 - fix(logging)

handle mid-line streaming output in test logger and add streaming tests

• Introduce isOutputMidLine flag to track when streaming output does not end with a newline
• Only prepend the visual prefix at the start of a line and append segments to the last buffered entry when mid-line
• Write consistent output to log files for both complete lines and raw streaming segments
• Add tests to exercise streaming behavior: test/tstest/test.gap-debug.ts and test/tstest/test.gap-debug2.ts

2026-01-19 - 3.1.5 - fix(tstest)

preserve streaming console output and correctly buffer incomplete TAP lines

• Reworked TapParser._processLog to buffer incomplete lines and only parse complete TAP protocol lines
• Added TapParser.lineBuffer and _looksLikeTapStart() to detect and buffer starts of TAP messages
• Added TapParser._handleConsoleOutput() to centralize console output handling and snapshot parsing; flushes buffered content on process exit
• Added TapTestResult.addLogLineRaw() to append streaming text without adding newlines
• Added TsTestLogger.testConsoleOutputStreaming() and logToTestFileRaw() to preserve streaming output formatting in both console and logfile

2025-12-30 - 3.1.4 - fix(webhelpers)

improve browser test fixture to append element and await custom element upgrade and Lit update completion; add generic return type; update npm packaging release config; remove pnpm onlyBuiltDependencies

• ts_tapbundle/webhelpers.ts: make fixture generic and return T; append created element to document; await customElements.whenDefined for custom elements and await updateComplete for Lit/async components to ensure stable rendering in tests
• npmextra.json: add @git.zone/cli module metadata and release.registries/accessLevel; add @ship.zone/szci entry
• pnpm-workspace.yaml: remove onlyBuiltDependencies entries

2025-11-21 - 3.1.3 - fix(docs)

Update package author and expand license/legal and issue-reporting information in tapbundle docs

• Update package.json author field to Task Venture Capital GmbH
• Add expanded License and Legal Information to ts_tapbundle/readme.md (clarifies MIT license scope and trademark guidance)
• Add expanded License and Legal Information to ts_tapbundle_protocol/readme.md (clarifies MIT license scope and trademark guidance)
• Add Issue Reporting and Security section to ts_tapbundle_protocol/readme.md pointing users to the community hub for bug/security reports
• Include company information and trademark usage guidance in readmes

2025-11-21 - 3.1.2 - fix(docs)

Update README: add issue reporting/security guidance and expanded changelog (3.1.1/3.1.0)

• Add 'Issue Reporting and Security' section pointing to https://community.foss.global/ for bug/security reports and contributor onboarding.
• Expand Changelog with Version 3.1.1 notes: fixed TapTools parameter passing to suite lifecycle hooks (beforeAll/afterAll) and updated @push.rocks/smarts3 dependency to ^3.0.0.
• Include Changelog entries for Version 3.1.0: postTask() API, suite beforeAll/afterAll, new parallel() fluent API, and enhanced tapbundle documentation.
• Documentation-only change (no source code modifications).

2025-11-21 - 3.1.1 - fix(tapbundle)

Pass TapTools to suite lifecycle hooks (beforeAll/afterAll) and update @push.rocks/smarts3 to ^3.0.0

• Replace usage of a Deferred promise with a TapTools instance when invoking suite.beforeAll and suite.afterAll
• Add import for TapTools in ts_tapbundle/tapbundle.classes.tap.ts
• Bump dependency @push.rocks/smarts3 from ^2.2.7 to ^3.0.0 in package.json

2025-11-20 - 3.1.0 - feat(tapbundle)

Add global postTask (teardown) and suite lifecycle hooks (beforeAll/afterAll) to tapbundle

• Introduce PostTask class (ts_tapbundle/tapbundle.classes.posttask.ts) and tap.postTask() API for global teardown.
• Integrate postTask execution into Tap.start() so postTasks run after all tests and before the global afterAll hook.
• Add suite-level beforeAll and afterAll support and ensure afterAll runs after child suites and their tests (changes in ts_tapbundle/tapbundle.classes.tap.ts).
• Add lifecycle tests (test/tapbundle/test.new-lifecycle.ts) verifying execution order, including parallel tests.
• Update documentation (readme.hints.md) describing Phase 1 API improvements and usage notes.
• This is additive and backward-compatible (no breaking changes).

2025-11-20 - 3.0.1 - fix(@push.rocks/smarts3)

Bump @push.rocks/smarts3 dependency to ^2.2.7

• Update package.json: @push.rocks/smarts3 upgraded from ^2.2.6 to ^2.2.7

2025-11-19 - 3.0.0 - BREAKING CHANGE(tapbundle_serverside)

Rename Node-specific tapbundle module to tapbundle_serverside and migrate server-side utilities

• Change public export in package.json from ./tapbundle_node to ./tapbundle_serverside — consumers must update imports to @git.zone/tstest/tapbundle_serverside
• Move and re-create Node-only implementation files under ts_tapbundle_serverside (plugins, paths, classes.tapnodetools, classes.testfileprovider, index, tspublish.json) and remove legacy ts_tapbundle_node sources
• Update internal imports and tests to reference the new tapbundle_serverside path (e.g. test/tapbundle/test.node.ts updated)
• Update documentation (readme.md and readme.hints.md) to describe the new tapbundle_serverside export and its server-side utilities
• Ensure build outputs and publish metadata reflect the new module directory (tspublish.json order preserved)

2025-11-19 - 2.8.3 - fix(dependencies)

Update dependency versions

• Bump devDependency @git.zone/tsbuild to ^3.1.0
• Upgrade @git.zone/tsrun to ^2.0.0 (major)
• Upgrade @push.rocks/smartenv to ^6.0.0 (major)
• Upgrade @push.rocks/smartrequest to ^5.0.1 (major/feature in dependency)
• Patch updates: @api.global/typedserver → ^3.0.80, @git.zone/tsbundle → ^2.5.2, @push.rocks/smartmongo → ^2.0.14

2025-11-17 - 2.8.2 - fix(logging)

Include runtime identifier in per-test logfile name and sanitize runtime string

• Append a sanitized runtime identifier to the per-test log filename (format: <safeFilename>__<safeRuntime>.log) so runs for different runtimes don't clash
• Sanitize runtime names by lowercasing and removing non-alphanumeric characters to produce filesystem-safe filenames

2025-11-17 - 2.8.1 - fix(config)

Remove Bun config file and set deno.json useDefineForClassFields to false for compatibility

• Removed bunfig.toml (Bun-specific TypeScript decorator configuration) — stops shipping a project-local Bun transpiler config.
• Updated deno.json: set compilerOptions.useDefineForClassFields = false to keep legacy class field semantics and avoid runtime/emit incompatibilities in Deno.

2025-11-17 - 2.8.0 - feat(runtime-adapters)

Enable TypeScript decorator support for Deno and Bun runtimes and add decorator tests

• Add bunfig.toml to enable experimentalDecorators for Bun runtime
• Add deno.json to enable experimentalDecorators and set target/lib for Deno
• Update Bun runtime adapter to note bunfig.toml discovery so Bun runs with decorator support
• Update Deno runtime adapter to auto-detect deno.json / deno.jsonc and pass configPath in default options
• Add integration tests for decorators (test/decorator.all.ts) to verify decorator support across runtimes

2025-10-26 - 2.7.0 - feat(tapbundle_protocol)

Add package export for tapbundle_protocol to expose protocol utilities

• Add './tapbundle_protocol' export in package.json pointing to './dist_ts_tapbundle_protocol/index.js'.
• Allows consumers to import protocol utilities (ProtocolEmitter, ProtocolParser, types) via '@git.zone/tstest/tapbundle_protocol'.
• Non-breaking: only extends package exports surface.

2025-10-17 - 2.6.2 - fix(@push.rocks/smartrequest)

Bump @push.rocks/smartrequest from ^4.3.1 to ^4.3.2

• Update dependency @push.rocks/smartrequest from ^4.3.1 to ^4.3.2

2025-10-17 - 2.6.1 - fix(runtime-adapters)

Silence shell version checks for Bun and Deno; add local Claude settings

• Replace smartshell.exec with execSilent in ts/tstest.classes.runtime.bun.ts to suppress output when checking Bun availability
• Replace smartshell.exec with execSilent in ts/tstest.classes.runtime.deno.ts to suppress output when checking Deno availability
• Add .claude/settings.local.json to record local Claude agent permissions/config used for development

2025-10-17 - 2.6.0 - feat(runtime-adapters)

Add runtime environment availability check and logger output; normalize runtime version strings

• Introduce checkEnvironment() in TsTest and invoke it at the start of run() to detect available runtimes before executing tests.
• Add environmentCheck(availability) to TsTestLogger to print a human-friendly environment summary (with JSON and quiet-mode handling).
• Normalize reported runtime version strings from adapters: prefix Deno and Bun versions with 'v' and simplify Chromium version text.
• Display runtime availability information to the user before moving previous logs or running tests.
• Includes addition of local .claude/settings.local.json (local dev/tooling settings).

2025-10-17 - 2.5.2 - fix(runtime.node)

Improve Node runtime adapter to use tsrun.spawnPath, strengthen tsrun detection, and improve process lifecycle and loader handling; update tsrun dependency.

• Use tsrun.spawnPath to spawn Node test processes and pass structured spawn options (cwd, env, args, stdio).
• Detect tsrun availability via plugins.tsrun and require spawnPath; provide a clearer error message when tsrun is missing or outdated.
• Pass --web via spawn args and set TSTEST_FILTER_TAGS on the spawned process env instead of mutating the parent process.env.
• When a 00init.ts exists, create a temporary loader that imports both 00init.ts and the test file, run the loader via tsrun.spawnPath, and clean up the loader after execution.
• Use tsrunProcess.terminate()/kill for timeouts to ensure proper process termination and improve cleanup handling.
• Export tsrun from ts/tstest.plugins.ts so runtime code can access tsrun APIs via the plugins object.
• Bump dependency @git.zone/tsrun from ^1.3.4 to ^1.6.2 in package.json.

2025-10-16 - 2.5.1 - fix(deps)

Bump dependencies and add local tooling settings

• Bumped @api.global/typedserver from ^3.0.78 to ^3.0.79
• Bumped @git.zone/tsrun from ^1.3.3 to ^1.3.4
• Bumped @push.rocks/smartjson from ^5.0.20 to ^5.2.0
• Bumped @push.rocks/smartlog from ^3.1.9 to ^3.1.10
• Add local settings configuration file for developer tooling

2025-10-12 - 2.5.0 - feat(tstest.classes.runtime.parser)

Add support for "all" runtime token and update docs/tests; regenerate lockfile and add local settings

• Add support for the all runtime token (expands to node, chromium, deno, bun) in tstest filename parser (tstest.classes.runtime.parser)
• Handle all with modifiers (e.g. *.all.nonci.ts) and mixed tokens (e.g. node+all) so it expands to the full runtime set
• Add unit tests covering all cases in test/test.runtime.parser.node.ts
• Update README (examples and tables) to document .all.ts and .all.nonci.ts usage and include a universal example
• Update ts files' parser comments and constants to include ALL_RUNTIMES
• Add deno.lock (dependency lockfile) and a local .claude/settings.local.json for project permissions / local settings

2025-10-11 - 2.4.3 - fix(docs)

Update documentation: expand README with multi-runtime architecture, add module READMEs, and add local dev settings

• Expanded project README: fixed typos, clarified availability header, and added a detailed Multi-Runtime Architecture section (runtimes, naming conventions, migration tool, examples, and runtime-specific notes).
• Inserted additional example output and adjusted JSON/example sections to reflect multi-runtime flows and updated totals/durations in examples.
• Added dedicated README files for ts_tapbundle, ts_tapbundle_node, and ts_tapbundle_protocol modules with API overviews and usage guides.
• Added .claude/settings.local.json to provide local development permissions/settings used by the project tooling.
• Minor formatting and documentation cleanup (whitespace, headings, and changelog entries).

2025-10-10 - 2.4.2 - fix(deno)

Enable additional Deno permissions for runtime adapters and add local dev settings

• Add --allow-sys, --allow-import and --node-modules-dir to the default Deno permission set used by the Deno runtime adapter
• Include the new permission flags in the fallback permissions array when constructing Deno command args
• Add .claude/settings.local.json to capture local development permissions and helper commands

2025-10-10 - 2.4.1 - fix(runtime/deno)

Enable Deno runtime tests by adding required permissions and local settings

• ts/tstest.classes.runtime.deno.ts: expanded default Deno permissions to include --allow-net, --allow-write and --sloppy-imports to allow network access, file writes and permissive JS/TS imports
• ts/tstest.classes.runtime.deno.ts: updated fallback permissions used when building the Deno command to match the new default set
• Added .claude/settings.local.json with a set of allowed local commands/permissions used for local development/CI tooling

2025-10-10 - 2.4.0 - feat(runtime)

Add runtime adapters, filename runtime parser and migration tool; integrate runtime selection into TsTest and add tests

• Introduce RuntimeAdapter abstraction and RuntimeAdapterRegistry to manage multiple runtimes
• Add runtime adapters: NodeRuntimeAdapter, ChromiumRuntimeAdapter, DenoRuntimeAdapter and BunRuntimeAdapter
• Add filename runtime parser utilities: parseTestFilename, isLegacyFilename and getLegacyMigrationTarget
• Add Migration class to detect and (dry-run) migrate legacy test filenames to the new naming convention
• Integrate runtime registry into TsTest and choose execution adapters based on parsed runtimes; show deprecation warnings for legacy naming
• Add tests covering runtime parsing and migration: test/test.runtime.parser.node.ts and test/test.migration.node.ts

2025-09-12 - 2.3.8 - fix(tstest)

Improve free port selection for Chrome runner and bump smartnetwork dependency

• Use randomized port selection when finding free HTTP and WebSocket ports to reduce collision probability in concurrent runs
• Ensure WebSocket port search excludes the chosen HTTP port so the two ports will not conflict
• Simplify failure handling: throw early if a free WebSocket port cannot be found instead of retrying with a less robust fallback
• Bump @push.rocks/smartnetwork dependency from ^4.2.0 to ^4.4.0 to pick up new findFreePort options

2025-09-12 - 2.3.7 - fix(tests)

Remove flaky dynamic-ports browser test and add local dev tool settings

• Removed test/tapbundle/test.dynamicports.ts — deletes a browser test that relied on injected dynamic WebSocket ports (reduces flaky CI/browser runs).
• Added .claude/settings.local.json — local development settings for the CLAUDE helper (grants allowed dev/automation commands and webfetch permissions).

2025-09-03 - 2.3.6 - fix(tstest)

Update deps, fix chrome server route for static bundles, add local tool settings and CI ignore

• Bump devDependency @git.zone/tsbuild to ^2.6.8
• Bump dependencies: @api.global/typedserver to ^3.0.78, @push.rocks/smartlog to ^3.1.9, @push.rocks/smartrequest to ^4.3.1
• Fix test server static route in ts/tstest.classes.tstest.ts: replace '(.*)' with '/*splat' so bundled test files are served correctly in Chromium runs
• Add .claude/settings.local.json with local permissions for development tasks
• Add .serena/.gitignore to ignore /cache

2025-08-18 - 2.3.5 - fix(core)

Use SmartRequest with Buffer for binary downloads, tighten static route handling, bump dependencies and add workspace/config files

• ts_tapbundle_node/classes.testfileprovider.ts: switch to SmartRequest.create().url(...).get() and convert response to a Buffer before writing to disk to fix binary download handling for the Docker Alpine image.
• ts/tstest.classes.tstest.ts: change server.addRoute from '' to '(.)' so the typedserver static handler uses a proper regex route.
• package.json: bump several dependencies (e.g. @api.global/typedserver, @git.zone/tsbuild, @push.rocks/smartfile, @push.rocks/smartpath, @push.rocks/smartrequest, @push.rocks/smartshell) to newer patch/minor versions.
• pnpm-workspace.yaml: add onlyBuiltDependencies list (esbuild, mongodb-memory-server, puppeteer).
• Remove registry setting from .npmrc (cleanup).
• Add project/agent config files: .serena/project.yml and .claude/settings.local.json for local tooling/agent configuration.

2025-08-16 - 2.3.4 - fix(ci)

Add local Claude settings to allow required WebFetch and Bash permissions for local tooling and tests

• Add .claude/settings.local.json to configure allowed permissions for local assistant/automation
• Grants WebFetch access for code.foss.global and www.npmjs.com
• Allows various Bash commands used by local tasks and test runs (mkdir, tsbuild, pnpm, node, tsx, tstest, ls, rm, grep, cat)
• No runtime/library code changes — configuration only

2025-08-16 - 2.3.3 - fix(dependencies)

Bump dependency versions and add local Claude settings

• Bumped devDependency @git.zone/tsbuild ^2.6.3 → ^2.6.4
• Updated @git.zone/tsbundle ^2.2.5 → ^2.5.1
• Updated @push.rocks/consolecolor ^2.0.2 → ^2.0.3
• Updated @push.rocks/qenv ^6.1.0 → ^6.1.3
• Updated @push.rocks/smartchok ^1.0.34 → ^1.1.1
• Updated @push.rocks/smartenv ^5.0.12 → ^5.0.13
• Updated @push.rocks/smartfile ^11.2.3 → ^11.2.5
• Updated @push.rocks/smarts3 ^2.2.5 → ^2.2.6
• Updated @push.rocks/smartshell ^3.2.3 → ^3.2.4
• Updated ws ^8.18.2 → ^8.18.3
• Added .claude/settings.local.json for local Claude permissions and tooling (local-only configuration)

2025-07-24 - 2.3.2 - fix(tapbundle)

Fix TypeScript IDE warning about tapTools parameter possibly being undefined

• Changed ITestFunction from interface with optional parameter to union type
• Updated test runner to handle both function signatures (with and without tapTools)
• Resolves IDE warnings while maintaining backward compatibility

2025-05-26 - 2.3.1 - fix(tapParser/logger)

Fix test duration reporting and summary formatting in TAP parser and logger

• Introduce startTime in TapParser to capture the overall test duration
• Pass computed duration to logger methods in evaluateFinalResult for accurate timing
• Update summary output to format duration in a human-readable way (ms vs. s)
• Add local permission settings configuration to .claude/settings.local.json

2025-05-26 - 2.3.0 - feat(cli)

Add '--version' option and warn against global tstest usage in the tstest project

• Introduced a new '--version' CLI flag that prints the version from package.json
• Added logic in ts/index.ts to detect if tstest is run globally within its own project and issue a warning
• Added .claude/settings.local.json to configure allowed permissions for various commands

2025-05-26 - 2.2.6 - fix(tstest)

Improve timeout warning timer management and summary output formatting in the test runner.

• Removed the global timeoutWarningTimer and replaced it with local warning timers in runInNode and runInChrome methods.
• Added warnings when test files run for over one minute if no timeout is specified.
• Ensured proper clearing of warning timers on successful completion or timeout.
• Enhanced quiet mode summary output to clearly display passed and failed test counts.

2025-05-26 - 2.2.5 - fix(protocol)

Fix inline timing metadata parsing and enhance test coverage for performance metrics and timing edge cases

• Updated the protocol parser to correctly parse inline key:value pairs while excluding prefixed formats (META:, SKIP:, TODO:, EVENT:)
• Added new tests for performance metrics, timing edge cases, and protocol timing to verify accurate timing capture and retry handling
• Expanded documentation in readme.hints.md to detail the updated timing implementation and parser fixes

2025-05-26 - 2.2.4 - fix(logging)

Improve performance metrics reporting and add local permissions configuration

• Add .claude/settings.local.json to configure allowed permissions for various commands
• Update tstest logging: compute average test duration from actual durations and adjust slowest test display formatting

2025-05-26 - 2.2.3 - fix(readme/ts/tstest.plugins)

Update npm package scope and documentation to use '@git.zone' instead of '@gitzone', and add local settings configuration.

• Changed npm package links and source repository URLs in readme from '@gitzone/tstest' to '@git.zone/tstest'.
• Updated comments in ts/tstest.plugins.ts to reflect the correct '@git.zone' scope.
• Added .claude/settings.local.json file with local permission settings.

2025-05-26 - 2.2.2 - fix(config)

Cleanup project configuration by adding local CLAUDE settings and removing redundant license files

• Added .claude/settings.local.json with updated permissions for CLI and build tasks
• Removed license and license.md files to streamline repository content

2025-05-26 - 2.2.1 - fix(repo configuration)

Update repository metadata to use 'git.zone' naming and add local permission settings

• Changed githost from 'gitlab.com' to 'code.foss.global' and gitscope from 'gitzone' to 'git.zone' in npmextra.json
• Updated npm package name from '@gitzone/tstest' to '@git.zone/tstest' in npmextra.json and readme.md
• Added .claude/settings.local.json with new permission configuration

2025-05-26 - 2.2.0 - feat(watch mode)

Add watch mode support with CLI options and enhanced documentation

• Introduce '--watch' (or '-w') and '--watch-ignore' CLI flags for automatic test re-runs
• Integrate @push.rocks/smartchok for file watching with 300ms debouncing
• Update readme.md and readme.hints.md with detailed instructions and examples for watch mode
• Add a demo test file (test/watch-demo/test.demo.ts) to illustrate the new feature
• Add smartchok dependency in package.json

2025-05-26 - 2.1.0 - feat(core)

Implement Protocol V2 with enhanced settings and lifecycle hooks

• Migrated to Protocol V2 using Unicode markers and structured metadata with new ts_tapbundle_protocol module
• Refactored TAP parser/emitter to support improved protocol parsing and error reporting
• Integrated global settings via tap.settings() and lifecycle hooks (beforeAll/afterAll, beforeEach/afterEach)
• Enhanced expect wrapper with diff generation for clearer assertion failures
• Updated test loader to automatically run 00init.ts for proper test configuration
• Revised documentation (readme.hints.md, readme.plan.md) to reflect current implementation status and remaining work

2025-05-25 - 2.0.0 - BREAKING CHANGE(protocol)

Introduce protocol v2 implementation and update build configuration with revised build order, new tspublish files, and enhanced documentation

• Added ts_tapbundle_protocol directory with isomorphic implementation for protocol v2
• Updated readme.hints.md and readme.plan.md to explain the complete replacement of the v1 protocol and new build process
• Revised build order in tspublish.json files across ts, ts_tapbundle, ts_tapbundle_node, and ts_tapbundle_protocol
• Introduced .claude/settings.local.json with updated permission settings for CLI and build tools

2025-05-24 - 1.11.5 - fix(tstest)

Fix timeout handling to correctly evaluate TAP results after killing the test process.

• Added call to evaluateFinalResult() after killing the process in runInNode to ensure final TAP output is processed.

2025-05-24 - 1.11.4 - fix(logging)

Improve warning logging and add permission settings file

• Replace multiple logger.error calls with logger.warning for tests running over 1 minute
• Add warning method in tstest logger to display warning messages consistently
• Introduce .claude/settings.local.json to configure allowed permissions

2025-05-24 - 1.11.3 - fix(tstest)

Add timeout warning for long-running tests and introduce local settings configuration

• Add .claude/settings.local.json with permission configuration for local development
• Implement a timeout warning timer that notifies when tests run longer than 1 minute without an explicit timeout
• Clear the timeout warning timer upon test completion
• Remove unused import of logPrefixes in tstest.classes.tstest.ts

2025-05-24 - 1.11.2 - fix(tstest)

Improve timeout and error handling in test execution along with TAP parser timeout logic improvements.

• In the TAP parser, ensure that expected tests are properly set when no tests are defined to avoid false negatives on timeout.
• Use smartshell's terminate method and fallback kill to properly stop the entire process tree on timeout.
• Clean up browser, server, and WebSocket instances reliably even when a timeout occurs.
• Minor improvements in log file filtering and error logging for better clarity.

2025-05-24 - 1.11.1 - fix(tstest)

Clear timeout identifiers after successful test execution and add local CLAUDE settings

• Ensure timeout IDs are cleared when tests complete to prevent lingering timeouts
• Add .claude/settings.local.json with updated permission settings for CLI commands

2025-05-24 - 1.11.0 - feat(cli)

Add new timeout and file range options with enhanced logfile diff logging

• Introduce --timeout option to safeguard tests from running too long
• Add --startFrom and --stopAt options to control the range of test files executed
• Enhance logfile organization by automatically moving previous logs and generating diff reports for failed or changed test outputs
• Update CLI argument parsing and internal timeout handling for both Node.js and browser tests

2025-05-24 - 1.10.2 - fix(tstest-logging)

Improve log file handling with log rotation and diff reporting

• Add .claude/settings.local.json to configure allowed shell and web operations
• Introduce movePreviousLogFiles function to archive previous log files when --logfile is used
• Enhance logging to generate error copies and diff reports between current and previous logs
• Add type annotations for console overrides in browser evaluations for improved stability

2025-05-23 - 1.10.1 - fix(tstest)

Improve file range filtering and summary logging by skipping test files outside the specified range and reporting them in the final summary.

• Introduce runSingleTestOrSkip to check file index against startFrom/stopAt values.
• Log skipped files with appropriate messages and add them to the summary.
• Update the logger to include total skipped files in the test summary.
• Add permission settings in .claude/settings.local.json to support new operations.

2025-05-23 - 1.10.0 - feat(cli)

Add --startFrom and --stopAt options to filter test files by range

• Introduced CLI options --startFrom and --stopAt in ts/index.ts for selective test execution
• Added validation to ensure provided range values are positive and startFrom is not greater than stopAt
• Propagated file range filtering into test grouping in tstest.classes.tstest.ts, applying the range filter across serial and parallel groups
• Updated usage messages to include the new options

2025-05-23 - 1.9.4 - fix(docs)

Update documentation and configuration for legal notices and CI permissions. This commit adds a new local settings file for tool permissions, refines the legal and trademark sections in the readme, and improves glob test files with clearer log messages.

• Added .claude/settings.local.json to configure permissions for various CLI commands
• Revised legal and trademark documentation in the readme to clarify company ownership and usage guidelines
• Updated glob test files with improved console log messages for better clarity during test discovery

2025-05-23 - 1.9.3 - fix(tstest)

Fix test timing display issue and update TAP protocol documentation

• Changed TAP parser regex to non-greedy pattern to correctly separate test timing metadata
• Enhanced readme.hints.md with detailed explanation of test timing fix and planned protocol upgrades
• Updated readme.md with improved usage examples for tapbundle and comprehensive test framework documentation
• Added new protocol design document (readme.protocol.md) and improvement plan (readme.plan.md) outlining future changes
• Introduced .claude/settings.local.json update for npm and CLI permissions
• Exported protocol utilities and added tapbundle protocol implementation for future enhancements

2025-05-23 - 1.9.2 - fix(logging)

Fix log file naming to prevent collisions and update logging system documentation.

• Enhance safe filename generation in tstest logging to preserve directory structure using double underscores.
• Update readme.hints.md to include detailed logging system documentation and behavior.
• Add .claude/settings.local.json with updated permissions for build tools.

2025-05-23 - 1.9.1 - fix(dependencies)

Update dependency versions and add local configuration files

• Bump @git.zone/tsbuild from ^2.5.1 to ^2.6.3
• Bump @types/node from ^22.15.18 to ^22.15.21
• Bump @push.rocks/smartexpect from ^2.4.2 to ^2.5.0
• Bump @push.rocks/smartfile from ^11.2.0 to ^11.2.3
• Bump @push.rocks/smartlog from ^3.1.1 to ^3.1.8
• Add .npmrc with npm registry configuration
• Add .claude/settings.local.json for local permissions

2025-05-16 - 1.9.0 - feat(docs)

Update documentation to embed tapbundle and clarify module exports for browser compatibility; also add CI permission settings.

• Embed tapbundle directly into tstest to simplify usage and ensure browser support.
• Update import paths in examples from '@push.rocks/tapbundle' to '@git.zone/tstest/tapbundle'.
• Revise the changelog to reflect version 1.8.0 improvements including enhanced test lifecycle hooks and parallel execution fixes.
• Add .claude/settings.local.json to configure CI-related permissions and tool operations.

2025-05-16 - 1.8.0 - feat(documentation)

Enhance README with detailed test features and update local settings for build permissions.

• Expanded the documentation to include tag filtering, parallel test execution groups, lifecycle hooks, snapshot testing, timeout control, retry logic, and test fixtures
• Updated .claude/settings.local.json to allow additional permissions for various build and test commands

2025-05-16 - 1.7.0 - feat(tstest)

Enhance tstest with fluent API, suite grouping, tag filtering, fixture & snapshot testing, and parallel execution improvements

• Updated npm scripts to run tests in verbose mode and support glob patterns with quotes
• Introduced tag filtering support (--tags) in the CLI to run tests by specified tags
• Implemented fluent syntax methods (tags, priority, retry, timeout) for defining tests and applying settings
• Added test suite grouping with describe(), along with beforeEach and afterEach lifecycle hooks
• Integrated a fixture system and snapshot testing via TapTools with base64 snapshot communication
• Enhanced TAP parser regex, error collection, and snapshot handling for improved debugging
• Improved parallel test execution by grouping files with a 'para__' pattern and running them concurrently

2025-05-15 - 1.6.0 - feat(package)

Revamp package exports and update permissions with an extensive improvement plan for test runner enhancements.

• Replaced 'main' and 'typings' in package.json with explicit exports for improved module resolution.
• Added .claude/settings.local.json to configure permissions for bash commands and web fetches.
• Updated readme.plan.md with a comprehensive roadmap covering enhanced error reporting, rich test metadata, nested test suites, and advanced test features.

2025-05-15 - 1.5.0 - feat(cli)

Improve test runner configuration: update test scripts, reorganize test directories, update dependencies and add local settings for command permissions.

• Updated package.json scripts to use pnpm and separate commands for tapbundle and tstest.
• Reorganized tests into dedicated directories (test/tapbundle and test/tstest) and removed deprecated test files.
• Refactored import paths and bumped dependency versions in tapbundle, tstest, and associated node utilities.
• Added .claude/settings.local.json to configure local permissions for bash and web fetch commands.
• Introduced ts/tspublish.json to define publish order.

2025-05-15 - 1.4.0 - feat(logging)

Display failed test console logs in default mode

• Introduce log buffering in TsTestLogger to capture console output for failed tests
• Enhance TapParser to collect and display error details when tests fail
• Update README and project plan to document log improvements for debugging

2025-05-15 - 1.3.1 - fix(settings)

Add local permissions configuration and remove obsolete test output log

• Added .claude/settings.local.json to configure allowed permissions for web fetch and bash commands
• Removed test-output.log to eliminate accidental commit of test artifacts

2025-05-15 - 1.3.0 - feat(logger)

Improve logging output and add --logfile support for persistent logs

• Add new .claude/settings.local.json with logging permissions configuration
• Remove obsolete readme.plan.md
• Introduce test/test.console.ts to capture and display console outputs during tests
• Update CLI in ts/index.ts to replace '--log-file' with '--logfile' flag
• Enhance TsTestLogger to support file logging, clean ANSI sequences, and improved JSON output
• Forward TAP protocol logs to testConsoleOutput in TapParser for better console distinction

2025-05-15 - 1.2.0 - feat(logging)

Improve logging output, CLI option parsing, and test report formatting.

• Added a centralized TsTestLogger with support for multiple verbosity levels, JSON output, and file logging (TODO).
• Integrated new logger into CLI parsing, TapParser, TapCombinator, and TsTest classes to ensure consistent and structured output.
• Introduced new CLI options (--quiet, --verbose, --no-color, --json, --log-file) for enhanced user control.
• Enhanced visual design with progress indicators, detailed error aggregation, and performance summaries.
• Updated documentation and logging code to align with improved CI/CD behavior, including skipping non-CI tests.

2025-05-15 - 1.1.0 - feat(cli)

Enhance test discovery with support for single file and glob pattern execution using improved CLI argument detection

• Detect execution mode (file, glob, directory) based on CLI input in ts/index.ts
• Refactor TestDirectory to load test files using SmartFile for single file and glob patterns
• Update TsTest to pass execution mode and adjust test discovery accordingly
• Bump dependency versions for typedserver, tsbundle, tapbundle, and others
• Add .claude/settings.local.json for updated permissions configuration

2025-01-23 - 1.0.96 - fix(TsTest)

Fixed improper type-check for promise-like testModule defaults

• Corrected the type-check for promise-like default exports in test modules
• Removed unnecessary setTimeout used for async execution

2025-01-23 - 1.0.95 - fix(core)

Fix delay handling in Chrome test execution

• Replaced smartdelay.delayFor with native Promise-based delay mechanism in runInChrome method.

2025-01-23 - 1.0.94 - fix(TsTest)

Fix test module execution by ensuring promise resolution delay

• Added a delay to ensure promise resolution when dynamically importing test modules in the runInChrome method.

2025-01-23 - 1.0.93 - fix(tstest)

Handle globalThis.tapPromise in browser runtime evaluation

• Added support for using globalThis.tapPromise in the browser evaluation logic.
• Added log messages to indicate the usage of globalThis.tapPromise.

2025-01-23 - 1.0.92 - fix(core)

Improve error logging for test modules without default promise

• Added logging to display the exported test module content when it does not export a default promise.

2025-01-23 - 1.0.91 - fix(core)

Refactored tstest class to enhance promise handling for test modules.

• Removed .gitlab-ci.yml configuration file.
• Updated package.json dependency versions.
• Added a condition to handle promiselike objects in tests.

2024-04-18 - 1.0.89 to 1.0.90 - Enhancements and Bug Fixes

Multiple updates and fixes have been made.

• Updated core components to enhance stability and performance.

2024-03-07 - 1.0.86 to 1.0.88 - Core Updates

Continued improvements and updates in the core module.

• Applied critical fixes to enhance core stability.

2024-01-19 - 1.0.85 to 1.0.89 - Bug Fixes

Series of core updates have been implemented.

• Addressed known bugs and improved overall system functionality.

2023-11-09 - 1.0.81 to 1.0.84 - Maintenance Updates

Maintenance updates focusing on core reliability.

• Improved core module through systematic updates.
• Strengthened system robustness.

2023-08-26 - 1.0.77 to 1.0.80 - Critical Fixes

Critical fixes implemented in core functionality.

• Enhanced core processing to fix existing issues.

2023-07-13 - 1.0.75 to 1.0.76 - Stability Improvements

Stability enhancements and minor improvements.

• Focused on ensuring a stable operational core.

2022-11-08 - 1.0.73 to 1.0.74 - Routine Fixes

Routine core fixes to address reported issues.

• Addressed minor issues in the core module.

2022-08-03 - 1.0.71 to 1.0.72 - Core Enhancements

Enhancements applied to core systems.

• Tweaked core components for enhanced reliability.

2022-05-04 - 1.0.69 to 1.0.70 - System Reliability Fixes

Fixes targeting the reliability of the core systems.

• Improved system reliability through targeted core updates.

2022-03-17 - 1.0.65 to 1.0.68 - Major Core Updates

Major updates and bug fixes delivered for core components.

• Enhanced central operations through key updates.

2022-02-15 - 1.0.60 to 1.0.64 - Core Stability Improvements

Focused updates on core stability and performance.

• Reinforced stability through systematic core changes.

2021-11-07 - 1.0.54 to 1.0.59 - Core Fixes and Improvements

Multiple core updates aimed at fixing and improving the system.

• Addressed outstanding bugs and improved performance in the core.

2021-08-20 - 1.0.50 to 1.0.53 - Core Functionality Updates

Continued updates to improve core functionality and user experience.

• Implemented essential core fixes to enhance user experience.

2020-10-01 - 1.0.44 to 1.0.49 - Core System Enhancements

Critical enhancements to core systems.

• Improved core operations and tackled existing issues.

2020-09-29 - 1.0.40 to 1.0.43 - Essential Fixes

Series of essential fixes for the core system.

• Rectified known issues and bolstered core functionalities.

2020-07-10 - 1.0.35 to 1.0.39 - Core Function Fixes

Focused improvements and fixes for critical components.

• Addressed critical core functions to boost system performance.

2020-06-01 - 1.0.31 to 1.0.34 - Core Updates

Updates to maintain core functionality efficacy.

• Fixed inefficiencies and updated essential components.

2019-10-02 - 1.0.26 to 1.0.29 - Core Maintenance

Regular maintenance and updates for core reliability.

• Addressed multiple core issues and enhanced system stability.

2019-05-28 - 1.0.20 to 1.0.25 - Core Improvements

General improvements targeting core functionalities.

• Made systematic improvements to core processes.

2019-04-08 - 1.0.16 to 1.0.19 - Bug Squashing

Resolved numerous issues within core operations.

• Fixed and optimized core functionalities for better performance.

2018-12-06 - 1.0.15 - Dependency Updates

Updates aimed at improving dependency management.

• Ensured dependencies are up-to-date for optimal performance.

2018-08-14 - 1.0.14 - Test Improvement

Major improvements in testing mechanisms and logging.

• Improved test results handling for accuracy and reliability.
• Enhanced logging features for increased clarity.

2018-08-04 - 1.0.1 to 1.0.13 - Initial Implementation and Fixes

Initial release and critical updates focusing on core stability and functionality.

• Implemented core components and established initial system structure.
• Addressed key bugs and enhanced initial functionality.