Release v2.1.1

What's New in v2.1.1

This patch release introduces critical structural safeguards to the SPP protocol enforcement, significantly hardens verification logic, and provides multiple developer experience (UX) enhancements.

Features & Improvements

• Interactive Task Parking (Protocol Enforcement): Solved a critical SPP protocol violation where explicitly forcing a new TODO task (while another was IN_PROGRESS) resulted in multiple active tasks. The CLI now gracefully detects this and uses an interactive prompt to safely "park" the active task back to TODO before promoting the urgent task.
• Expanded Quality Gates: Added global linting coverage to include the /scripts and /mcp directories to ensure all utility code adheres to the same standard.

Bug Fixes

• Dependency Resolution Ordering: Swapped dependency checks to evaluate strictly before protocol checks, preventing edge cases where an active task could be parked for an ineligible dependency.
• AST Parser Hardening: Upgraded scripts/check-selectors.ts traversal logic to recursively extract and validate variable-assigned locators rather than just literal inline method calls.
• Husky Pre-commit Loophole: Patched .husky/pre-commit to prevent the CLI from crashing when zero .ts files are left in the Git staging area after filtering.
• Config Resiliency: Hardened playwright.config.ts with correct timeout thresholds, explicit retry definitions, and reliable localhost/SauceDemo fallbacks for BASE_URL initialization.

Documentation

• Updated docs/CLI.md to formally document the Interactive Parking feature and Protocol Enforcement parameters.

v2.1.0 - Stability & Consistency

Smart Playwright Protocol v2.1.0

This release focuses on robustness, improved AI diagnostics, and CLI hardening.

Core Fixes & Improvements

• Graceful YAML Parse Handling: Malformed task files no longer crash the framework.
• Frontmatter Validation: Required metadata (ID, title) is now enforced.
• Improved AI Diagnostics: MCP verification failures now include log excerpts for faster recovery.
• CLI Consistency: All commands (status, blocked) are now correctly documented and implemented.
• Clipboard Fallback: Added explicit feedback when clipboard access is unavailable (e.g., SSH/Docker).
• Commit Convention Sync: Synchronized commit types across protocol, template, and validation hooks.
• ESLint Hardening: Resolved all redundant type checks and spacing issues.

v2.0.1

SPP v2.0.1 Release

This release includes protocol refinements, CLI messaging improvements, and formal JSDoc standards.

Protocol & CLI Improvements

• Strengthened Recover Phase: Mandatory evidence confirmation before applying fixes.
• Improved Complete Response: Added 'Recommended Next Step' guidance for human review.
• Dynamic CLI Guidance: Task creation messaging now accurately reflects SPP priority rules based on current task board state.
• Flexible Browser Exploration: Clarified Playwright MCP usage guidance.

Code Quality & Standards

• JSDoc Standard: Implemented mandatory JSDoc for core framework and CLI files while maintaining noise-free tests.
• ESLint Flat Config: Migrated to standard ESLint v9 array-based configuration, resolving deprecation warnings.
• Type Safety: Improved error handling and removed unused variables in core scripts.

Version Sync

• Synchronized version to v2.0.1 across all documentation and the MCP server.

Smart Playwright Protocol (SPP) v2.0.0

Smart Playwright Protocol (SPP) v2.0.0

SPP v2.0 is a major redesign focused on simplicity, consistency, and practical AI-assisted Playwright automation.

Highlights

Protocol-Driven Workflow

The framework now centers around the Smart Playwright Protocol (SPP):

Select
  ↓
Understand
  ↓
Explore
  ↓
Plan
  ↓
Implement
  ↓
Verify
  ├─ PASS → DONE
  └─ FAIL → BLOCKED → Recover → Verify

Simplified Task Lifecycle

Task states remain intentionally lightweight:

• TODO
• IN_PROGRESS
• BLOCKED
• DONE

Improved CLI Experience

• Interactive task workflow
• Task creation wizard
• Verification-focused lifecycle
• AI handoff prompts
• Clipboard support

Modernized Quality Gates

Pre-commit protections include:

• ESLint via lint-staged
• Selector validation
• test.only protection
• describe.only protection
• waitForTimeout protection
• test.skip warnings

Documentation Overhaul

Documentation is organized around:

• README.md
• PROTOCOL.md
• CLI.md
• ROADMAP.md
• AGENTS.md

MCP Strategy

• Official Playwright MCP is recommended for browser exploration and selector validation.
• SPP remains tool-agnostic and does not require MCP integrations to operate.

Philosophy

SPP v2 prioritizes:

• Simplicity
• Reviewability
• Verification-first development
• Human-AI collaboration
• Lightweight workflows

over complex orchestration and autonomous agent systems.

What's Next

Future improvements will focus on:

• Task frontmatter validation
• CI verification workflows
• Configurable quality gates

while preserving the lightweight nature of the protocol.