[Sprint 3] feat: Implement SessionStart auto-validate hook for contract-validator #229

Closed
opened 2026-01-27 21:51:35 +00:00 by lmiranda · 0 comments
Owner

Description

Implement smart mode SessionStart hook that validates plugin compatibility only when files changed since last check.

Implementation

Wiki: Sprint 3: Hooks Implementation

Plugin: plugins/contract-validator/

Technical Details

Hook Configuration

  • Event: SessionStart
  • Behavior: Conditional validation

Smart Mode Logic

  1. Check .contract-validator-lastcheck file
  2. Compare timestamps with git changes
  3. Skip if no changes, validate if changes found

Files to Monitor

  • plugins/**/plugin.json
  • plugins/**/hooks/hooks.json
  • plugins/**/commands/*.md
  • mcp-servers/**/

Files to Create/Modify

plugins/contract-validator/hooks/
  hooks.json         # SessionStart hook
  auto-validate.sh   # Smart validation script

Acceptance Criteria

  • Hook in hooks/hooks.json
  • Tracks last validation timestamp
  • Skips when no changes
  • Validates when changes detected
  • Clear output messages

Dependency

Provides foundation for Breaking Change Detection feature.

Technical Notes

CRITICAL: Hooks must be in hooks/hooks.json, NOT inline in plugin.json.

## Description Implement smart mode `SessionStart` hook that validates plugin compatibility only when files changed since last check. ## Implementation **Wiki:** [Sprint 3: Hooks Implementation](https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/wiki/Change-V5.2.0%3A-Plugin-Enhancements-Proposal-%28Sprint-3-Hooks%29) **Plugin:** `plugins/contract-validator/` ## Technical Details ### Hook Configuration - **Event:** `SessionStart` - **Behavior:** Conditional validation ### Smart Mode Logic 1. Check `.contract-validator-lastcheck` file 2. Compare timestamps with git changes 3. Skip if no changes, validate if changes found ### Files to Monitor - `plugins/**/plugin.json` - `plugins/**/hooks/hooks.json` - `plugins/**/commands/*.md` - `mcp-servers/**/` ### Files to Create/Modify ``` plugins/contract-validator/hooks/ hooks.json # SessionStart hook auto-validate.sh # Smart validation script ``` ## Acceptance Criteria - [ ] Hook in `hooks/hooks.json` - [ ] Tracks last validation timestamp - [ ] Skips when no changes - [ ] Validates when changes detected - [ ] Clear output messages ## Dependency Provides foundation for Breaking Change Detection feature. ## Technical Notes **CRITICAL:** Hooks must be in `hooks/hooks.json`, NOT inline in plugin.json.
lmiranda added the Type/FeaturePriority/HighEffort/MComplexity/Medium labels 2026-01-27 21:51:35 +00:00
lmiranda added this to the Sprint 3 - Hooks milestone 2026-01-27 21:55:30 +00:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: personal-projects/leo-claude-mktplace#229