topos.mcp.tools.compare¶

Structural comparison tools: AST edit distance between two programs.

topos.mcp.tools.compare.topos_compare_code(params)[source]

Compute AST edit distance between two source strings.

Returns normalized distance in [0, 1] and a similarity score (1 - distance). Useful for detecting clones, measuring refactor impact, or — in conjunction with topos_assess_improvement — catching agents that “improve” scores without actually changing the code (near-zero distance + score jump = suspicious).

topos.mcp.tools.compare.topos_compare_files(params)[source]: AST distance between two files on disk.

topos.mcp.tools.compare.render_comparison_md(r)[source]: Compact markdown for an AST-distance comparison.