feat(contract-validator): Complete Sprint 2 - Contract Validator Plugin #195

lmiranda · 2026-01-26T20:22:18Z

lmiranda commented

2026-01-26 20:22:18 +00:00

Summary

Complete implementation of the contract-validator plugin (Sprint 2).

Issues Completed

#185: Plugin structure and MCP server foundation
#186: Parse tools for plugin interface extraction
#187: Validation tools for compatibility checking
#188: Report tools for marketplace-wide validation
#189: Commands (validate-contracts, check-agent, list-interfaces)
#190: Agents (full-validation, agent-check)
#191: Documentation (README.md, claude-md-integration.md)
#192: Marketplace integration
#193: Tests (34 tests, ~88% coverage)

Features

7 MCP tools for contract validation
3 plugin commands
2 specialized agents
Cross-plugin compatibility validation
Interface drift detection

🤖 Generated with Claude Code

## Summary Complete implementation of the contract-validator plugin (Sprint 2). ### Issues Completed - #185: Plugin structure and MCP server foundation - #186: Parse tools for plugin interface extraction - #187: Validation tools for compatibility checking - #188: Report tools for marketplace-wide validation - #189: Commands (validate-contracts, check-agent, list-interfaces) - #190: Agents (full-validation, agent-check) - #191: Documentation (README.md, claude-md-integration.md) - #192: Marketplace integration - #193: Tests (34 tests, ~88% coverage) ### Features - 7 MCP tools for contract validation - 3 plugin commands - 2 specialized agents - Cross-plugin compatibility validation - Interface drift detection 🤖 Generated with Claude Code

lmiranda added 10 commits 2026-01-26 20:22:19 +00:00

feat(contract-validator): create plugin structure (#185 ) 0fc40d0fda

Create the basic plugin structure for contract-validator:

Plugin structure:
- plugins/contract-validator/.claude-plugin/plugin.json
- plugins/contract-validator/.mcp.json
- plugins/contract-validator/mcp-servers/contract-validator -> symlink

MCP server scaffolding:
- mcp-servers/contract-validator/mcp_server/server.py (7 placeholder tools)
- mcp-servers/contract-validator/pyproject.toml
- mcp-servers/contract-validator/requirements.txt
- Virtual environment with mcp>=0.9.0

Tools defined (placeholders):
- parse_plugin_interface
- parse_claude_md_agents
- validate_compatibility
- validate_agent_refs
- validate_data_flow
- generate_compatibility_report
- list_issues

Sprint: Sprint 2 - contract-validator Plugin

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

feat(contract-validator): implement parse tools (#186 ) 2b041cb771

Implement parse_plugin_interface and parse_claude_md_agents tools
for extracting structured data from plugin documentation.

parse_plugin_interface extracts:
- Plugin name and description
- Commands (from tables and ### headers)
- Agents (from Agents section tables)
- Tools (with categories from Tools Summary)
- Features list

parse_claude_md_agents extracts:
- Agent definitions from Four-Agent Model tables
- Agent personality and responsibilities
- Tool references in agent workflows

Tested on: projman (12 cmds), data-platform (7 cmds, 2 agents, 32 tools),
pr-review (3 cmds), code-sentinel (1 cmd), and CLAUDE.md (4 agents)

Sprint: Sprint 2 - contract-validator Plugin

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

feat(contract-validator): implement validation tools (#187 ) 46af00019c

Implement validate_compatibility, validate_agent_refs, and
validate_data_flow tools for cross-plugin validation.

validate_compatibility:
- Compares tool and command names between plugins
- Identifies naming conflicts (ERROR) and shared tools (WARNING)
- Found: data-platform and projman share /initial-setup command

validate_agent_refs:
- Checks agent tool references against available plugins
- Reports missing tools and undocumented references
- Supports optional plugin_paths for tool lookup

validate_data_flow:
- Validates data flow through agent tool sequences
- Checks producer/consumer patterns (e.g., data_ref)
- Extracts workflow steps from responsibilities

Issue types detected:
- missing_tool (ERROR)
- interface_mismatch (ERROR/WARNING)
- optional_dependency (WARNING)
- undeclared_output (WARNING/INFO)

Sprint: Sprint 2 - contract-validator Plugin

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

feat(contract-validator): implement report tools (#188 ) 0e9187c5a9

Add report generation and issue listing tools:
- generate_compatibility_report: Full marketplace validation with
  markdown or JSON output, includes summary statistics
- list_issues: Filtered issue listing by severity and type

The report tools coordinate parse_tools and validation_tools to
scan all plugins in a marketplace, run pairwise compatibility
checks, and aggregate findings into comprehensive reports.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Merge feat/188-report-tools: implement report tools fdee539371

feat(contract-validator): create commands (#189 ) 8f450c0e7b

Add 3 user-facing commands:
- /validate-contracts: Full marketplace compatibility validation
- /check-agent: Validate single agent definition
- /list-interfaces: Show plugin interfaces summary

Each command documents usage, workflow, parameters, and available
MCP tools for implementation.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

feat(contract-validator): create agents (#190 ) cb07a382ea

Add 2 autonomous agents:
- full-validation: Complete cross-plugin compatibility validation
  triggered by /validate-contracts command
- agent-check: Single agent definition validation triggered
  by /check-agent command

Each agent documents capabilities, workflow, validation rules,
and example interactions.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

docs(contract-validator): create documentation (#191 ) ec965dc8ee

Add comprehensive plugin documentation:
- README.md: Plugin overview, problem statement, tool docs,
  example workflows, issue types, best practices
- claude-md-integration.md: CLAUDE.md snippets, interface
  documentation standards, CI/CD integration guide

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

chore(contract-validator): marketplace integration (#192 ) fe6b354ee2

- Add contract-validator to marketplace.json with proper metadata
- Update CLAUDE.md plugin table and commands list
- Validation passes with ./scripts/validate-marketplace.sh

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

test(contract-validator): add comprehensive tests (#193 ) d580464f4a

Add 34 tests across 3 test modules:
- test_parse_tools.py: 11 tests for README/CLAUDE.md parsing
- test_validation_tools.py: 11 tests for compatibility and agent validation
- test_report_tools.py: 12 tests for report generation and filtering

Coverage: parse_tools 79%, validation_tools 96%, report_tools 89%

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

lmiranda merged commit f2cf082ba8 into development

2026-01-26 20:22:42 +00:00

lmiranda referenced this issue from a commit

2026-01-26 20:22:43 +00:00

Merge pull request 'feat(contract-validator): Complete Sprint 2 - Contract Validator Plugin' (#195) from feat/193-tests into development

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#195