feat: integrate AST structural validation into check_code pipeline

@zen-agentchecks n/achecks…zen/check-code-structural-validation → next3 files · +118 −11updated 3mo ago

▸Description

Description

Integrates Mercury's new AST-based structural validator, auto-fixer, and skeleton extractor into the Integrator. This is the companion PR to mercury#17353 (which adds the parser modules).

Changes:

check_code pipeline (Phase 1 integration)

helper.py: Added sys.path setup for Mercury parsers + new _structural_check_and_fix() function
tool.py: Calls structural check between check_if_action_code and _composio_action_checks

How it works:

Imports Mercury's validate_and_fix() (gracefully skips if unavailable)
Runs AST validation on the action file
Auto-fixes what it can (missing imports, docstrings, display_name) and writes the fixed file back
Reports unfixable structural issues back to the agent
Subsequent checks (composio, pyright, ruff) run against the auto-fixed code

Action builder prompt (Phase 2 integration)

prompt.py: Added _get_app_skeleton_context() that calls Mercury's extract_app_context() to generate compact structural summaries of existing actions
Skeleton context injected into the user prompt as "Existing Action Patterns" section
System prompt Step 1 updated to reference skeletons first, reducing need for full-file reads
Gracefully degrades if Mercury parsers unavailable

This reduces builder agent token usage by providing compact pattern context (~2KB for 16 actions) instead of requiring the agent to read multiple full source files.

Depends on: mercury#17353

How did I test this PR

ruff check and ruff format clean on all modified files
Verified graceful degradation: both _structural_check_and_fix and _get_app_skeleton_context return safe defaults when Mercury parsers are unavailable
Mercury parser tests: 155 passed (34 new tests for validator/fixer/extractor)
Tested extract_app_context('hackernews') produces 2KB summary of 16 action files
Integration tested via reading the check_code pipeline and prompt construction flow

🤖 Generated with Claude Code

loading diff…