← All projects
Project record01 mention
Originally shared on Hacker News

blockwatch

A cross-file deterministic drift checker that detects inconsistencies between source code, configs, and docs. Code is annotated with special rules (in source comments or a blockwatch.toml config file) describing how parts of the code, configs, and docs depend on each other, and the tool flags when they drift out of sync. It uses tree-sitter to parse source code and supports 35+ languages.

Last shared For Developers working on large codebases
01 / The problem

What it addresses

Large codebases that share constants across programming languages and configs, and whose docs should strictly reflect the current state of the code, are prone to drift that is hard to detect.

02 / Source history

Shared over time

Each entry reflects what was shared on that date. Details may have changed since then.

  1. blockwatch

    A cross-file deterministic drift checker that detects inconsistencies between source code, configs, and docs. Code is annotated with special rules (in source comments or a blockwatch.toml config file) describing how parts of the code, configs, and docs depend on each other, and the tool flags when they drift out of sync. It uses tree-sitter to parse source code and supports 35+ languages.

    Problem: Large codebases that share constants across programming languages and configs, and whose docs should strictly reflect the current state of the code, are prone to drift that is hard to detect.

    Audience: Developers working on large codebases

    Posted by @mennanov · Original comment ↗

    “I'm working on a cross-file deterministic drift checker https://github.com/mennanov/blockwatch”