Groovy — 130 Operations for AI Agents

This page is the canonical reference an AI coding agent uses to refactor, query, and analyze Groovy code through the act MCP server. 130 operations available: 56 refactor, 18 query, 42 analysis, 14 verification. Each operation is callable from Claude Code, Cursor, Codex, OpenCode, or any MCP-compatible agent host. Click any operation for a stable anchor link suitable for citation.

Worked Groovy examples

act101 edits Groovy source using the class and expression structure the tree-sitter grammar exposes, so an edit targets a specific null check, closure, or class body rather than a raw text position. It can collapse a null-check guard around a method call into the ?. safe navigation operator, extract an inline closure argument into a named variable, and generate equals()/hashCode() overrides from a class's declared fields. The generated equals()/hashCode() pair reads the class's own field list to build its comparisons and hash terms, rather than emitting a fixed template. Each example below is the verbatim output of the command shown, run against the file shown.

Convert a null check to safe navigation

Service.groovy guards user.getName() with an explicit if (user != null) check before calling it.

$ act refactor-lang convert_to_safe_navigation --file Service.groovy --params '{"line":3,"column":9}'

Before

class Service {
    def process(User user) {
        if (user != null) {
            return user.getName()
        }
        return null
    }
}

After

class Service {
    def process(User user) {
        return user?.getName()
    }
}

The if guard and its body collapse into a single return user?.getName(), so the null check happens inline through the ?. operator instead of a separate branch.

Extract an inline closure into a named variable

Processor.groovy passes the closure { it.toUpperCase() } directly into items.collect.

$ act refactor-lang extract_closure --file Processor.groovy --params '{"name":"toUpper","line":3,"column":30}'

Before

class Processor {
    def process(List items) {
        return items.collect { it.toUpperCase() }
    }
}

After

class Processor {
    def process(List items) {
        def toUpper = { it.toUpperCase() }
        return items.collect(toUpper)
    }
}

The closure is bound to a new toUpper variable declared just above the collect call, which now passes toUpper instead of the inline closure literal.

Generate equals() and hashCode() for a class

Point.groovy declares x and y as plain int fields with no equals() or hashCode() override.

$ act refactor-lang generate_equals_and_hash_code_groovy --file Point.groovy --params '{"line":1,"column":1}'

Before

class Point {
    int x
    int y
}

After

class Point {
    int x
    int y

    @Override
    boolean equals(Object obj) {
        if (this.is(obj)) return true
        if (obj == null || getClass() != obj.getClass()) return false
        Point other = (Point) obj
        return x == other.x && y == other.y
    }

    @Override
    int hashCode() {
        final int prime = 31
        int result = 1
        result = prime * result + x
        result = prime * result + y
        return result
    }
}

Both methods are appended to the class: equals() compares x and y field-by-field after a class and null check, and hashCode() combines them using the standard prime-multiplier pattern.

Query

18 query tools, the same on every supported language. Descriptions live in the shared reference: /docs/query-tools.

callers control_flow data_flow definition diagnostics effect_closure effect_summary fix_auto get_type graph import_organize interface mutations references repo_outline skeleton symbols symbols_batch

Refactor

Analysis

42 analysis tools, the same on every supported language. Descriptions live in the shared reference: /docs/analysis-tools.

analyze_api_diff analyze_chokepoints analyze_clones analyze_clusters analyze_cohesion analyze_conformance analyze_coupling analyze_cycle_risk analyze_cycles analyze_dead_code analyze_depth analyze_entry_points analyze_export analyze_extraction analyze_fan_balance analyze_features analyze_hotspots analyze_impact analyze_inconsistencies analyze_inheritance analyze_interface_bloat analyze_interfaces analyze_layers analyze_orphan_types analyze_patterns analyze_platform_deps analyze_readiness analyze_roles analyze_seams analyze_stability analyze_surface analyze_test_gaps analyze_thickness analyze_type_completeness churn_hotspots co_change_clusters coverage_overlay ownership_map profile_overlay simulate split_module trace_overlay

Verify

14 verify tools, the same on every supported language. Descriptions live in the shared reference: /docs/verification.

bisect_regression gate generate_test_harness scan secret_surface summarize_pr taint_flow unsafe_surface verify_behavioral_equivalence verify_contract_preserved verify_diff_semantics verify_port_parity verify_side_effects verify_test_impact