blockwatch-cli 0.16.1__tar.gz → 0.16.3__tar.gz

blockwatch_cli-0.16.3/.agents/skills/blockwatch/SKILL.md

@@ -0,0 +1,14 @@
+---
+name: blockwatch
+description: Use when a change touches something that another place must match, such as an enum and its docs, a constant and its config, a version written in two files, or a list that must stay sorted or unique. Also use it when a file you edit holds `<block ...>` tags, or `blockwatch.toml` points at it.
+allowed-tools: Bash(blockwatch skill)
+---
+
+# blockwatch skill
+
+`blockwatch skill` prints the skill for the installed version:
+
+!`blockwatch skill`
+
+If its output is not shown above, run `blockwatch skill` and follow what it prints. If `blockwatch` is not installed,
+run `uvx --from blockwatch-cli blockwatch skill` instead.

{blockwatch_cli-0.16.1 → blockwatch_cli-0.16.3}/AGENTS.md

@@ -279,10 +279,11 @@ default), `safe` or `unsafe`.
 `src/skill.md`, `.agents/skills/blockwatch/SKILL.md` and `.claude-plugin/` are part of the *product*. They make up the
 skill this project ships, so that agents can add blocks to **other** repositories:
 
-- `src/skill.md` is the skill. `blockwatch skill` prints it with the version filled in, and users save that output in
-  their projects.
-- `.agents/skills/blockwatch/SKILL.md` is a stub for the plugin in `.claude-plugin/`. It runs `blockwatch skill` each
-  time it loads. It has its own copy of the description, and `tests/skill.rs` checks that the two copies match.
+- `src/skill.md` is the skill. `blockwatch skill` prints it with the version filled in. Its section "Installing this
+  skill" holds the stub that users save in their projects. The stub runs `blockwatch skill` each time an agent loads
+  it.
+- `.agents/skills/blockwatch/SKILL.md` is that stub, for the plugin in `.claude-plugin/`. `tests/skill.rs` checks that
+  it is the stub in `src/skill.md`, and that its description matches the one at the top of `src/skill.md`.
 
 They are not instructions for working on blockwatch, and changing them changes what users get. This file is the
 guidance for working on blockwatch.

{blockwatch_cli-0.16.1 → blockwatch_cli-0.16.3}/CHANGELOG.md

@@ -12,6 +12,36 @@ Releases up to and including v0.3.11 predate this file. Their notes live on the
 
 ## [Unreleased] - ReleaseDate
 
+## [0.16.3] - 2026-11-02
+
+## [0.16.2] - 2026-10-30
+
+### Added
+
+- Symbols in Java files. `Config.java#/Config/MAX_RETRIES` points at a field of the class `Config`, and
+  `#/Config/Mode/RED` at an enum constant. Each type is a symbol, and so is each field, method, enum constant and
+  nested type in it. A text block counts as the text Java reads, without the indentation its lines share. See
+  [Java](docs/symbols.md#java).
+- Symbols in C# files. `Config.cs#/Acme/Billing/Config/MaxRetries` points at a constant of the class `Config` in the
+  namespace `Acme.Billing`. Each type is a symbol, and so is each field, property, method, event, enum member and
+  nested type in it. A raw string counts as the text C# reads, without the white space before its closing quotes. See
+  [C#](docs/symbols.md#c).
+
+### Changed
+
+- Projects now install the agent skill as a short stub that runs `blockwatch skill` each time an agent loads it. So the
+  skill always matches the installed version. Before, projects saved the whole skill, which went stale until an agent
+  saved it again after an upgrade. A saved copy now tells the agent to replace it with the stub. See
+  [Annotating Codebases with AI Agents](docs/agents.md).
+- The agent skill now loads when a change touches something that another place must match, such as an enum and its
+  docs, or a list that must stay sorted. It also loads for files with block tags, or that `blockwatch.toml` points at.
+  Before, it loaded for every code change. This applies to the Claude Code plugin too.
+
+### Fixed
+
+- A path into a YAML file with lists or mappings nested hundreds of levels deep, such as `a: [[[...]]]`, no longer
+  crashes blockwatch with a stack overflow.
+
 ## [0.16.1] - 2026-10-28
 
 ### Added

{blockwatch_cli-0.16.1 → blockwatch_cli-0.16.3}/CLAUDE.md

@@ -279,10 +279,11 @@ default), `safe` or `unsafe`.
 `src/skill.md`, `.agents/skills/blockwatch/SKILL.md` and `.claude-plugin/` are part of the *product*. They make up the
 skill this project ships, so that agents can add blocks to **other** repositories:
 
-- `src/skill.md` is the skill. `blockwatch skill` prints it with the version filled in, and users save that output in
-  their projects.
-- `.agents/skills/blockwatch/SKILL.md` is a stub for the plugin in `.claude-plugin/`. It runs `blockwatch skill` each
-  time it loads. It has its own copy of the description, and `tests/skill.rs` checks that the two copies match.
+- `src/skill.md` is the skill. `blockwatch skill` prints it with the version filled in. Its section "Installing this
+  skill" holds the stub that users save in their projects. The stub runs `blockwatch skill` each time an agent loads
+  it.
+- `.agents/skills/blockwatch/SKILL.md` is that stub, for the plugin in `.claude-plugin/`. `tests/skill.rs` checks that
+  it is the stub in `src/skill.md`, and that its description matches the one at the top of `src/skill.md`.
 
 They are not instructions for working on blockwatch, and changing them changes what users get. This file is the
 guidance for working on blockwatch.