v1.6.1

Added

• Added a bundled MCP server schema and automated schema update workflow so
  server.json validation no longer depends on fetching the schema at runtime.
• Added CloakBrowser dependency metadata to the MkDocs project macros and
  generated llms.txt compatibility values from the same release metadata.

Changed

• Updated the CloakBrowser dependency to ^0.4.7.
• Updated npm dependencies and pinned Docker GitHub Actions used by CI and
  release workflows.

Fixed

• Fixed duplicate Streamable HTTP request body reads.

v1.6.0

Added

• Added persistent browser profile support through PLAYWRIGHT_MCP_USER_DATA_DIR
  and Streamable HTTP session metadata, including writable directory validation
  and in-process duplicate profile protection.
• Added validated context option support through
  CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS and Streamable HTTP session metadata.
• Added extension path support through CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS
  and Streamable HTTP session metadata, backed by CloakBrowser launch argument
  generation and persistent profile requirements.
• Added a CloakBrowser upstream monitor job and helper script alongside the
  Playwright MCP upstream monitor.
• Added Docker and extension documentation for persistent /data profiles,
  mounted extension directories, and cross-platform path handling.
• Added code-assistant E2E runbook coverage for single-subagent full tool
  sweeps and parallel multisession checks against one shared Streamable HTTP
  MCP server.

Changed

• Updated the upstream Playwright MCP dependency and Docker baseline to
  @playwright/mcp ^0.0.77 and
  mcr.microsoft.com/playwright/mcp:v0.0.77.
• Updated the CloakBrowser dependency to ^0.4.5.
• Switched the humanized input integration to CloakBrowser's public JavaScript
  helper surface while keeping the generated Playwright MCP config flow intact.
• Derived the Playwright MCP package tag used by the Tools documentation from
  the MkDocs project macro metadata.
• Simplified the release workflow so release publishing no longer repeats PR
  CI release checks or Docker smoke, and documentation deployment waits for
  npm, Docker, and MCP Registry publishing to succeed.

Fixed

• Clarified Streamable HTTP metadata validation and normalized profile path
  assertions for cross-platform CI behavior.

v1.5.0

Added

• Added a bridge option to match CloakBrowser timezone and locale fingerprint
  flags to the configured proxy's GeoIP location.
• Added a bridge option for CloakBrowser human-like mouse, keyboard, and scroll
  behavior with global and per-session Streamable HTTP configuration, including
  default and careful human presets.
• Auto-cleanup of stale Chromium SingletonLock files on stdio startup to prevent
  "Browser is already in use" errors after an unclean shutdown (SIGKILL/crash).
  Covers Linux, macOS, and Windows profile paths and lock formats, and skips
  locks whose owning process is still alive or whose status is indeterminate
  (EPERM / EACCES).

Changed

• Extracted the singleton-lock cleanup logic into a new
  src/cli/singleton-lock-cleanup.ts module with platform-aware path
  resolution (POSIX XDG cache vs Windows %LOCALAPPDATA%) and a private
  process.kill(pid, 0) probe so the safety guarantees can be unit-tested
  with vi.spyOn(process, 'kill') instead of touching the global state.

v1.4.0

Added

• Added pino-backed operational logging for Streamable HTTP startup and
  completed HTTP requests.
• Added protocol-selectable Streamable HTTP HTTPS support with certificate,
  key, PFX, and passphrase configuration.
• Added packaged CLI end-to-end coverage for stdio, Streamable HTTP, auth,
  HTTPS, CLI/env options, and doctor JSON output.
• Added generated compatibility tables shared by the README and documentation.

Changed

• Expanded supported npm validation to Node.js 22 through 26 across Linux
  x64/arm64, macOS arm64/x64, and Windows x64.
• Expanded Docker release validation and publishing to linux/amd64 and
  linux/arm64.
• Updated MCP client installation documentation for npm, Docker, Codex CLI,
  Claude Code, Claude Desktop, VS Code, Cursor, Continue, Windsurf/Cascade,
  Goose, Warp, and Streamable HTTP.
• Updated @playwright/mcp dependency to ^0.0.76.
• Updated Playwright MCP Docker base image to mcr.microsoft.com/playwright/mcp:v0.0.76.
• Updated CloakBrowser dependency to ^0.3.32.

Fixed

• Hardened internal Streamable HTTP error responses so server exception details
  are not exposed to clients.
• Replaced global test TLS validation disabling with a scoped fixture
  certificate trust path.
• Fixed cross-platform command, path, line-ending, and import resolution issues
  for Windows, macOS, and Linux CI.

v1.3.0

Added

• Added a project release skill for AI agents to prepare, publish, verify, and
  recover releases.
• Added a project Pull Request skill for AI agents to prepare, create, update,
  and report PRs consistently.
• Added property-based tests for CLI and environment parsing.
• Added agent instructions for supply-chain hardening and GitHub security
  changes.
• Added Streamable HTTP GET /healthz and GET /readyz probes for health and
  readiness checks.
• Added the cloakbrowser-mcp doctor diagnostics command with human and JSON
  output.
• Added a stable upstream Playwright MCP tool list reference to the Tools
  documentation.

Changed

• Added the Advanced SEO MkDocs plugin for generated documentation metadata.
• Hardened GitHub workflow token permissions and pinned workflow actions.
• Updated CloakBrowser dependency to ^0.3.31.
• Updated documentation dependency minimums for MkDocs plugins.
• Updated npm development dependency minimums to current compatible releases.
• Expanded Node.js workflow check coverage across major versions 20 through
  26.
• Updated the project Pull Request skill to assign PRs to the authenticated
  GitHub user by default.

v1.2.7

v1.2.7

Added

• Added Docker Hub publication and MCP Registry metadata for
  docker.io/swimmwatch/cloakbrowser-mcp alongside GHCR.
• Added automatic Docker Hub repository overview updates from a
  Docker-specific README.
• Added a Docker Hub pulls badge to the README.

v1.2.6

Summary

v1.2.6 is a metadata and release tooling patch. Runtime behavior and upstream Playwright MCP tool contracts are unchanged.

Changes

• Added npm run registry:check and npm run registry:check:strict to verify official MCP Registry publication, npm package availability, GHCR image availability, and best-effort GitHub MCP Registry visibility.
• Documented the distinction between the official MCP Registry and GitHub's curated github.com/mcp discovery surface.
• Refined registry-facing package and server metadata to describe the project as a Playwright MCP-compatible browser automation bridge.
• Updated documentation, version compatibility tables, pinned examples, and changelog for v1.2.6.

Notes

GitHub /mcp visibility remains best-effort. Absence from github.com/mcp is not treated as a release failure unless the strict registry checker is intentionally used.

v1.2.5

Summary

This release refactors release infrastructure around one unified GitHub Actions workflow and keeps runtime MCP behavior unchanged.

Changed

• Replaced the separate npm, Docker, documentation, and MCP Registry release workflows with one unified Release workflow.
• Simplified the local MCP Registry Publish composite action so npm and Docker publication ordering is handled by workflow job dependencies.
• Added Glama ownership metadata, score badge, and release checklist documentation before the stable 1.2.5 release.

Fixed

• Added retries with fresh GitHub OIDC login attempts around MCP Registry publishing to tolerate transient registry gateway timeouts.

Verification

The release pipeline publishes the npm package, Docker image, documentation site, and MCP Registry entry from the same release event.

CloakBrowser MCP v1.2.3

Summary

CloakBrowser MCP v1.2.3 is an infrastructure-only patch release. Runtime behavior is unchanged.

Changed

• Refactored MCP Registry publishing into a local MCP Registry Publish composite GitHub Action.
• Kept the release workflow as the orchestrator for release events, version application, and explicit action inputs.
• Added a dedicated README badge for the official MCP Registry listing.

Compatibility

• Runtime behavior is unchanged from v1.2.2.
• Supported transports remain stdio and Streamable HTTP.
• The official MCP Registry entry is still published through mcp-publisher and GitHub Actions OIDC.

CloakBrowser MCP v1.2.2

Summary

CloakBrowser MCP v1.2.2 is a patch release that ensures the release-triggered MCP Registry workflow verifies the official registry API response correctly.

Fixed

• Fixed MCP Registry release verification to read .servers[].server.name and .servers[].server.version from the official registry API.
• Made MCP Registry reruns idempotent by skipping publish when the requested server version is already visible.
• Keeps official MCP Registry publishing through mcp-publisher and GitHub Actions OIDC.

Compatibility

• Runtime behavior is unchanged from v1.2.1 and v1.2.0.
• Supported transports remain stdio and Streamable HTTP.