Release: Merge development into main (Sprint 2 - contract-validator v5.0.0) #196

lmiranda · 2026-01-26T20:24:38Z

lmiranda commented

2026-01-26 20:24:38 +00:00

Release Summary

Merge development branch containing Sprint 2 (contract-validator plugin) into main.

Sprint 2 - contract-validator Plugin

contract-validator v1.0.0 - Cross-plugin compatibility validation
7 MCP tools, 3 commands, 2 agents
34 tests with ~88% coverage
Full marketplace integration

Documentation Updates

README.md, CANONICAL-PATHS.md, COMMANDS-CHEATSHEET.md updated
Lessons learned captured in wiki

🤖 Generated with Claude Code

## Release Summary Merge development branch containing Sprint 2 (contract-validator plugin) into main. ### Sprint 2 - contract-validator Plugin - **contract-validator** v1.0.0 - Cross-plugin compatibility validation - 7 MCP tools, 3 commands, 2 agents - 34 tests with ~88% coverage - Full marketplace integration ### Documentation Updates - README.md, CANONICAL-PATHS.md, COMMANDS-CHEATSHEET.md updated - Lessons learned captured in wiki 🤖 Generated with Claude Code

lmiranda added 13 commits 2026-01-26 20:24:39 +00:00

docs: fix documentation drift (19 items) 9d5615409c

Critical fixes:
- Fix projman version mismatch (3.1.0 -> 3.2.0 in plugin.json)
- Update CLAUDE.md version to 4.1.0

Stale documentation updates:
- Add viz-platform to README.md (plugins, MCP servers, verification table)
- Add viz-platform to COMMANDS-CHEATSHEET.md (8 commands, hooks, MCP table)
- Add viz-platform and data-platform to CANONICAL-PATHS.md
- Add viz-platform and data-platform to CONFIGURATION.md
- Fix CHANGELOG.md tool counts (Layout 5, Theme 6, Page 5)
- Add data-platform to CLAUDE.md repository structure

Missing documentation:
- Create mcp-servers/viz-platform/README.md (21 tools documented)
- Add viz-platform SessionStart hook to COMMANDS-CHEATSHEET.md

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

Merge pull request 'docs: Fix documentation drift (19 items)' (#194 ) from fix/documentation-drift into development 68f50fed55

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>

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

lmiranda merged commit 1fb9e6cece into main

2026-01-26 20:24:47 +00:00

lmiranda referenced this issue from a commit

2026-01-26 20:24:49 +00:00

Merge pull request 'Release: Merge development into main (Sprint 2 - contract-validator v5.0.0)' (#196) from development into main

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