v3.0.0

v3.0.0 — ESLint for Claude Code

Policy engine with adaptive enforcement. Rules that learn from your behavior.

Highlights

• Rule Engine — 3-layer loading (safety < company < repo < personal), 6 trigger types, 3 enforcement levels
• Adaptive Enforcement — decay-weighted scoring auto-adjusts rule levels based on violation history
• Safety Rules — force-push, rm -rf, .env commits blocked by default (cannot be disabled)
• Absorbed Workflow Skills — /trace-fix, /build-guard, /review-gate built in
• 198 passing tests across macOS and Linux

Adaptive Enforcement

Rules learn from your behavior:

• 8 violations in 5 days → warn escalates to block
• 0 violations for 3 weeks → warn de-escalates to inform
• Safety rules always exempt

Install

claude plugin marketplace add cukas/patrol
claude plugin install patrol@cukas

What's New (from v2.0.0)

• Rule engine with JSON-based rule definitions
• Trigger types: bash_command, tool_use, sequence, file_changed
• Violation enforcement: inform, warn, block
• Adaptive enforcement with decay scoring (on by default)
• Per-rule adaptive bounds (adaptive: { min, max })
• /patrol-rules command for managing active rules
• V2 investigation gate preserved as customizable rule templates
• Contributor docs (CONTRIBUTING.md, issue & PR templates)

Full Changelog: v2.0.0...v3.0.0

v2.0.0

v2.0.0

Added

• Status line indicator — real-time adaptive display showing read/edit counts, mode, and escalation level
• Two-tier enforcement — light mode (always-on, nudge only) + full mode (bugfix, full escalation)
• /patrol-keywords — manage custom trigger keywords (list/add/remove/reset)
• always_on config — light discipline enforcement even outside bugfix sessions (default: true)
• easter_eggs config — opt-in Yoda-themed messages
• custom_keywords config — extend default keywords without replacing them
• Rich /patrol-status dashboard — box-drawn display with mode, tier, health, verification
• Hero image — shield sentinel visual identity

Changed

• Startup banner condensed to single line (status line carries the detail now)
• /patrol-help updated with two-tier model and new commands
• Keyword matching now uses merged defaults + custom_keywords
• Verify check respects tier (active in both light and full mode)

Migration from v1.x

• No breaking changes. Existing config continues to work.
• keywords config still works but custom_keywords is preferred (extends defaults instead of replacing).
• Set always_on: false to restore v1.x behavior (silent until bugfix detected).

Full Changelog: v1.0.0...v2.0.0

v1.0.0

Full Changelog: https://github.com/cukas/patrol/commits/v1.0.0