blockwatch-cli 0.16.6__tar.gz → 0.16.8__tar.gz

{blockwatch_cli-0.16.6 → blockwatch_cli-0.16.8}/.markdownlint-cli2.yaml

@@ -21,6 +21,10 @@ config:
     # A shell command or a table row cannot be wrapped without changing what it means.
     code_blocks: false
     tables: false
+  MD010:
+    # A recipe line in a Makefile must start with a tab, so an example with spaces would not work.
+    ignore_code_languages:
+      - make
   MD024:
     # CHANGELOG.md follows Keep a Changelog, where every release repeats "Added" and "Fixed".
     # Requiring uniqueness only among headings sharing a parent still catches a real duplicate.

{blockwatch_cli-0.16.6 → blockwatch_cli-0.16.8}/AGENTS.md

@@ -226,11 +226,11 @@ The main modules:
   (`b/src/main.rs`), a path found in the walk and a `file:name` attribute all become a `RepoPath`. So the same file is
   always the same map key.
 - `src/language_parsers/` — one parser for each language, most of them a tree-sitter grammar. Markdown and MDX use
-  the `markdown` crate, and Lean has its own scanner. Each language has a `parser()` that returns a
-  `LanguageParser`, which knows which syntax nodes are comments. `src/block_parser.rs` turns those comments into
-  blocks. `language_parsers()` in `language_parsers/mod.rs` returns `LanguageParsers`: the parser of each extension.
-  Its `parser_for` picks the parser of a file, using the settings' extension mappings too. **To add a language, add a
-  module here and register it in that function.**
+  the `markdown` crate, Makefile uses the `makefile-lossless` crate, and Lean has its own scanner. Each language has
+  a `parser()` that returns a `LanguageParser`, which knows which syntax nodes are comments. `src/block_parser.rs`
+  turns those comments into blocks. `language_parsers()` in `language_parsers/mod.rs` returns `LanguageParsers`: the
+  parser of each extension. Its `parser_for` picks the parser of a file, using the settings' extension mappings too.
+  **To add a language, add a module here and register it in that function.**
 
   Some languages also have symbols. Such a language has a `SymbolsParser`, which its `parser()` passes to
   `.with_symbols(...)`:
@@ -239,6 +239,8 @@ The main modules:
   - TOML finds its symbols with `toml_edit`. What a TOML key means depends on the order of the headers, not on how the
     syntax tree is nested.
   - Markdown finds its sections with the `markdown` crate, the same parser that finds its comments.
+  - Makefile finds its symbols with `makefile-lossless`, the same crate that finds its comments. The crate is pinned to
+    one version. Its known bugs are listed in `docs/symbols.md`, not worked around.
 
   Each language's tests list every symbol it finds. When you give a language symbols, also document its paths in
   `docs/symbols.md` and in the "Symbols" section of the skill, `src/skill.md`. A test in `language_parsers/mod.rs` and the

{blockwatch_cli-0.16.6 → blockwatch_cli-0.16.8}/CHANGELOG.md

@@ -12,6 +12,44 @@ Releases up to and including v0.3.11 predate this file. Their notes live on the
 
 ## [Unreleased] - ReleaseDate
 
+## [0.16.8] - 2026-11-05
+
+### Added
+
+- Symbols in Makefiles (`Makefile`, `GNUmakefile`, `makefile`, `.mk` and `.mak`). `Makefile#/GO_VERSION` points at
+  the value of a variable, and `#/build` at the rule of a target. A value is read as GNU make reads it, without its
+  inline comment, and is never expanded. See [Makefile](docs/symbols.md#makefile).
+
+### Fixed
+
+- Some block tags in Makefile comments were not found, such as one after an assignment, as in `VERSION := 1.2 # ...`,
+  or one below a `(` that is not part of a reference. Now Makefiles are read with the `makefile-lossless` crate. A
+  comment that ends in `\` takes in the next line. A `#` after a rule's `;`, after a backslash, as in `\#`, or inside
+  `$(...)` doesn't start a comment.
+
+### Changed
+
+- A block tag in a Makefile is now found on a recipe line whose first character after the tab is `#`, and after any
+  `#` in a `define` body. Make reads no comment there, so these tags were not found before. See the known limits in
+  [Makefile](docs/symbols.md#makefile).
+
+## [0.16.7] - 2026-11-04
+
+### Added
+
+- Symbols in PHP files (`.php` and `.phtml`). `Invoice.php#/Invoice/STATUS_PAID` points at a class constant,
+  `#/Invoice/$perPage` at a property, and `version.php#/$wp_version` at a top-level variable. A
+  `define('NAME', value)` call is a symbol too, at `#/NAME`. The namespace is not part of a path. See
+  [PHP](docs/symbols.md#php).
+- Symbols in shell scripts (`.sh`, `.bash`, `.bashrc`, `.bash_profile` and `.envrc`). `install.sh#/GO_VERSION`
+  points at the value of a variable, and `#/log` at a function. A name counts when it is set outside functions, loops
+  and subshells. zsh files have no symbols. See [Shell](docs/symbols.md#shell).
+
+### Fixed
+
+- A Python or Starlark string with an escape that Python rejects, such as `"\x4"` or `"\N"`, gave its text as the
+  value. Now a path to it stops the run, as a path to a string with a `\N{...}` escape does.
+
 ## [0.16.6] - 2026-11-04
 
 ### Added

{blockwatch_cli-0.16.6 → blockwatch_cli-0.16.8}/CLAUDE.md

@@ -226,11 +226,11 @@ The main modules:
   (`b/src/main.rs`), a path found in the walk and a `file:name` attribute all become a `RepoPath`. So the same file is
   always the same map key.
 - `src/language_parsers/` — one parser for each language, most of them a tree-sitter grammar. Markdown and MDX use
-  the `markdown` crate, and Lean has its own scanner. Each language has a `parser()` that returns a
-  `LanguageParser`, which knows which syntax nodes are comments. `src/block_parser.rs` turns those comments into
-  blocks. `language_parsers()` in `language_parsers/mod.rs` returns `LanguageParsers`: the parser of each extension.
-  Its `parser_for` picks the parser of a file, using the settings' extension mappings too. **To add a language, add a
-  module here and register it in that function.**
+  the `markdown` crate, Makefile uses the `makefile-lossless` crate, and Lean has its own scanner. Each language has
+  a `parser()` that returns a `LanguageParser`, which knows which syntax nodes are comments. `src/block_parser.rs`
+  turns those comments into blocks. `language_parsers()` in `language_parsers/mod.rs` returns `LanguageParsers`: the
+  parser of each extension. Its `parser_for` picks the parser of a file, using the settings' extension mappings too.
+  **To add a language, add a module here and register it in that function.**
 
   Some languages also have symbols. Such a language has a `SymbolsParser`, which its `parser()` passes to
   `.with_symbols(...)`:
@@ -239,6 +239,8 @@ The main modules:
   - TOML finds its symbols with `toml_edit`. What a TOML key means depends on the order of the headers, not on how the
     syntax tree is nested.
   - Markdown finds its sections with the `markdown` crate, the same parser that finds its comments.
+  - Makefile finds its symbols with `makefile-lossless`, the same crate that finds its comments. The crate is pinned to
+    one version. Its known bugs are listed in `docs/symbols.md`, not worked around.
 
   Each language's tests list every symbol it finds. When you give a language symbols, also document its paths in
   `docs/symbols.md` and in the "Symbols" section of the skill, `src/skill.md`. A test in `language_parsers/mod.rs` and the

{blockwatch_cli-0.16.6 → blockwatch_cli-0.16.8}/Cargo.lock

@@ -274,7 +274,7 @@ checksum = "3ded4057c258ba199e2d26386d3af3780957ecaee6c4ef4041c6b4b8b97c0b06"
 
 [[package]]
 name = "blockwatch"
-version = "0.16.6"
+version = "0.16.8"
 dependencies = [
  "anyhow",
  "assert-json-diff",
@@ -289,6 +289,7 @@ dependencies = [
  "heck",
  "ignore",
  "libc",
+ "makefile-lossless",
  "markdown",
  "mlua",
  "percent-encoding",
@@ -326,7 +327,6 @@ dependencies = [
  "tree-sitter-json",
  "tree-sitter-kotlin-ng",
  "tree-sitter-lua",
- "tree-sitter-make",
  "tree-sitter-nix",
  "tree-sitter-ocaml",
  "tree-sitter-php",
@@ -491,6 +491,12 @@ version = "1.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "7f8f80099a98041a3d1622845c271458a2d73e688351bf3cb999266764b81d48"
 
+[[package]]
+name = "countme"
+version = "3.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7704b5fdd17b18ae31c4c1da5a2e0305a2bf17b5249300a9ee9ed7b72114c636"
+
 [[package]]
 name = "cpufeatures"
 version = "0.3.1"
@@ -861,6 +867,12 @@ dependencies = [
  "regex-syntax",
 ]
 
+[[package]]
+name = "hashbrown"
+version = "0.14.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e5274423e17b7c9fc20b6e7e208532f9b19825d82dfd615708b70edd83df41f1"
+
 [[package]]
 name = "hashbrown"
 version = "0.17.1"
@@ -1119,7 +1131,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "cc4e190f5d26ca7051642629da2c52fc03bde85a03197c99408dcd291734c855"
 dependencies = [
  "equivalent",
- "hashbrown",
+ "hashbrown 0.17.1",
 ]
 
 [[package]]
@@ -1274,6 +1286,15 @@ dependencies = [
  "which",
 ]
 
+[[package]]
+name = "makefile-lossless"
+version = "0.4.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "25a80f1e6bd18fe790d69cc1dda3eedaaa75bbd052a9734a137017056b5e1fa7"
+dependencies = [
+ "rowan",
+]
+
 [[package]]
 name = "markdown"
 version = "1.0.0"
@@ -1341,7 +1362,7 @@ dependencies = [
  "mlua-sys",
  "num-traits",
  "parking_lot",
- "rustc-hash",
+ "rustc-hash 2.1.3",
 ]
 
 [[package]]
@@ -1535,7 +1556,7 @@ dependencies = [
  "pin-project-lite",
  "quinn-proto",
  "quinn-udp",
- "rustc-hash",
+ "rustc-hash 2.1.3",
  "rustls",
  "socket2",
  "thiserror",
@@ -1557,7 +1578,7 @@ dependencies = [
  "rand 0.10.3",
  "rand_pcg",
  "ring",
- "rustc-hash",
+ "rustc-hash 2.1.3",
  "rustls",
  "rustls-pki-types",
  "slab",
@@ -1751,6 +1772,24 @@ dependencies = [
  "windows-sys 0.52.0",
 ]
 
+[[package]]
+name = "rowan"
+version = "0.16.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "417a3a9f582e349834051b8a10c8d71ca88da4211e4093528e36b9845f6b5f21"
+dependencies = [
+ "countme",
+ "hashbrown 0.14.5",
+ "rustc-hash 1.1.0",
+ "text-size",
+]
+
+[[package]]
+name = "rustc-hash"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "08d43f7aa6b08d49f382cde6a7982047c3426db949b1424bc4b7ec9ae12c6ce2"
+
 [[package]]
 name = "rustc-hash"
 version = "2.1.3"
@@ -2183,6 +2222,12 @@ version = "0.5.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "8f50febec83f5ee1df3015341d8bd429f2d1cc62bcba7ea2076759d315084683"
 
+[[package]]
+name = "text-size"
+version = "1.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f18aa187839b2bdb1ad2fa35ead8c4c2976b64e4363c386d45ac0f7ee85c9233"
+
 [[package]]
 name = "thiserror"
 version = "2.0.21"
@@ -2602,16 +2647,6 @@ dependencies = [
  "tree-sitter-language",
 ]
 
-[[package]]
-name = "tree-sitter-make"
-version = "1.1.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c5998dc7cbcbdab19fae8aefef982bf2d6544513d8d2e69cc44aec4c63810104"
-dependencies = [
- "cc",
- "tree-sitter-language",
-]
-
 [[package]]
 name = "tree-sitter-nix"
 version = "0.3.0"

{blockwatch_cli-0.16.6 → blockwatch_cli-0.16.8}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "blockwatch"
-version = "0.16.6"
+version = "0.16.8"
 edition = "2024"
 repository = "https://github.com/mennanov/blockwatch"
 description = "Language agnostic linter that keeps your code and documentation in sync and valid"
@@ -25,6 +25,8 @@ fnv = "1.0"
 globset = "0.4.18"
 heck = "0.5"
 ignore = "0.4"
+# Pinned exactly: a new version can change which symbols and comments a Makefile has.
+makefile-lossless = "=0.4.8"
 markdown = "1.0.0"
 mlua = { version = "0.12.0", features = ["lua54", "vendored", "async", "send"] }
 percent-encoding = "2.3"
@@ -61,7 +63,6 @@ tree-sitter-javascript = "0.25"
 tree-sitter-json = "0.24.8"
 tree-sitter-kotlin-ng = "1.1"
 tree-sitter-lua = "0.5"
-tree-sitter-make = "1.1"
 tree-sitter-nix = "0.3.0"
 tree-sitter-ocaml = "0.26"
 tree-sitter-php = "0.25"

{blockwatch_cli-0.16.6 → blockwatch_cli-0.16.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: blockwatch-cli
-Version: 0.16.6
+Version: 0.16.8
 Summary: Language agnostic linter that keeps your code and documentation in sync and valid
 Keywords: linter,sync,drift,comments,agents
 Home-Page: https://github.com/mennanov/blockwatch

{blockwatch_cli-0.16.6 → blockwatch_cli-0.16.8}/README.md

@@ -90,9 +90,9 @@ Two validators work across files:
 
 Both can point to a block, a whole file, a specific value in a file like `package.json#/version`, a section of a
 Markdown file, an element or attribute in an XML file such as `pom.xml` or a `.csproj`, a constant in a Go, C, C++,
-Python, Rust, TypeScript, JavaScript, Java, C#, Kotlin or Swift file, a field in a Protocol Buffers file, or a value in
-a Terraform or other HCL file (see [Symbols](docs/symbols.md)). The other validators check a single block on their
-own: the things you'd otherwise have to nitpick in code review.
+Python, Rust, TypeScript, JavaScript, Java, C#, Kotlin, Swift or PHP file, a variable in a shell script or a Makefile, a
+field in a Protocol Buffers file, or a value in a Terraform or other HCL file (see [Symbols](docs/symbols.md)). The
+other validators check a single block on their own: the things you'd otherwise have to nitpick in code review.
 
 <!-- <block name="available-validators"
      same-as="src/validators/mod.rs:validator-registry, docs/validators/README.md:validators-index"
@@ -220,7 +220,7 @@ exclusions, and custom extension mappings.
 
 ```yaml
 - repo: https://github.com/mennanov/blockwatch
-  rev: v0.16.6  # Use latest release
+  rev: v0.16.8  # Use latest release
   hooks:
     - id: blockwatch
 ```

{blockwatch_cli-0.16.6 → blockwatch_cli-0.16.8}/blockwatch.toml

@@ -50,4 +50,4 @@ same-as-pattern = '^\|\s*`(?P<value>[a-z-]+)`'
 [[block]]
 target = 'src/skill.md#/blockwatch/Symbols/Files with symbols'
 name = 'extensions-with-symbols'
-same-as-pattern = '`\.?(?P<value>[A-Za-z.]+)`'
+same-as-pattern = '`\.?(?P<value>[A-Za-z._]+)`'

{blockwatch_cli-0.16.6 → blockwatch_cli-0.16.8}/docs/ci.md

@@ -19,7 +19,7 @@ To use [pre-commit](https://pre-commit.com), add the hook to `.pre-commit-config
 
 ```yaml
 - repo: https://github.com/mennanov/blockwatch
-  rev: v0.16.6  # Use latest release
+  rev: v0.16.8  # Use latest release
   hooks:
     - id: blockwatch
 ```
@@ -59,7 +59,7 @@ The `blockwatch` hook runs before the commit message exists, so it cannot see a
 
 ```yaml
 - repo: https://github.com/mennanov/blockwatch
-  rev: v0.16.6  # Use latest release
+  rev: v0.16.8  # Use latest release
   hooks:
     - id: blockwatch-commit-msg
 ```

{blockwatch_cli-0.16.6 → blockwatch_cli-0.16.8}/docs/cli.md

@@ -557,15 +557,15 @@ Nothing else about the run changes: the same violations are found, and the exit
       "tool": {
         "driver": {
           "name": "blockwatch",
-          "version": "0.16.6",
-          "semanticVersion": "0.16.6",
+          "version": "0.16.8",
+          "semanticVersion": "0.16.8",
           "informationUri": "https://github.com/mennanov/blockwatch",
           "rules": [
             {
               "id": "keep-sorted",
               "name": "keep-sorted",
               "shortDescription": { "text": "Requires the lines of a block to stay in order." },
-              "helpUri": "https://github.com/mennanov/blockwatch/blob/v0.16.6/docs/validators/keep-sorted.md"
+              "helpUri": "https://github.com/mennanov/blockwatch/blob/v0.16.8/docs/validators/keep-sorted.md"
             }
           ]
         }