p-backlog 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.2.2
+
+- README: npm, CI, Node and license badges; a section on using p-backlog together with code-review-graph (re-check by symbol). No code changes.
+
 ## 0.2.1
 
 - npm keywords match the GitHub topics, so the package is easier to find in npm search. No code changes.

package/README.md

@@ -1,5 +1,7 @@
 # p-backlog
 
+[![npm](https://img.shields.io/npm/v/p-backlog)](https://www.npmjs.com/package/p-backlog) [![downloads](https://img.shields.io/npm/dm/p-backlog)](https://www.npmjs.com/package/p-backlog) [![CI](https://github.com/expatriate/p-backlog/actions/workflows/ci.yml/badge.svg)](https://github.com/expatriate/p-backlog/actions/workflows/ci.yml) [![node](https://img.shields.io/node/v/p-backlog)](https://nodejs.org) [![license](https://img.shields.io/npm/l/p-backlog)](LICENSE)
+
 **[Русская версия](README.ru.md)**
 
 A task backlog that lives as markdown files: an AI agent creates them while working on code, and a human
@@ -112,6 +114,33 @@ requires typing the project id to confirm.
   the backlog still has unprocessed files) — the countdown then shows "deletion delayed" instead.
   Deleted task numbers are never reused.
 
+## Works well with code-review-graph
+
+[code-review-graph](https://github.com/tirth8205/code-review-graph) builds a local graph of your code (functions,
+classes, their lines) in `.code-review-graph/graph.db` at the repository root. p-backlog doesn't need it, but uses
+it when it's there — read-only:
+
+- **Re-check by symbol.** A task's `source` (`file:line`) is matched to the function or class that contains it. The
+  Stop hook and `backlog check` then flag the task only when that symbol changed, not when any line of the file
+  moved — fewer needless re-checks. Without the graph the check falls back to the task's source lines, then to the
+  whole file.
+- **Duplicates by symbol.** Two tasks pointing into the same function are offered as possible duplicates.
+- **Graph state in the web UI.** The sidebar warns when a project has no graph, when it's stale, or when it can't be
+  read (built by a different version or for a different path), with the command that fixes it.
+- **Check precision.** The Quality tab in statistics shows how often each check method (by symbol, by source lines,
+  by file) was right.
+
+Setup, once per repository (Python tool; `pipx install code-review-graph` works too):
+
+```bash
+uv tool install code-review-graph
+code-review-graph build                       # in the repository root
+code-review-graph install --platform claude-code  # optional: its MCP server and instructions for Claude Code
+```
+
+Keep the graph fresh with `code-review-graph watch`, or run `code-review-graph update` after changes. Tested with
+code-review-graph 2.3.
+
 ## Web app
 
 ```bash

package/README.ru.md

@@ -1,5 +1,7 @@
 # p-backlog
 
+[![npm](https://img.shields.io/npm/v/p-backlog)](https://www.npmjs.com/package/p-backlog) [![downloads](https://img.shields.io/npm/dm/p-backlog)](https://www.npmjs.com/package/p-backlog) [![CI](https://github.com/expatriate/p-backlog/actions/workflows/ci.yml/badge.svg)](https://github.com/expatriate/p-backlog/actions/workflows/ci.yml) [![node](https://img.shields.io/node/v/p-backlog)](https://nodejs.org) [![license](https://img.shields.io/npm/l/p-backlog)](LICENSE)
+
 **[English version](README.md)**
 
 Беклог задач, который живёт markdown-файлами: их создаёт ИИ-агент во время работы над кодом, а человек
@@ -107,6 +109,33 @@
 - Любая закрытая задача удаляется через 7 дней вместе с файлом: это делает сервер при старте и раз в час. Задачу завершённого эпика сервер держит, пока эпик не закроется (например, пока в беклоге есть неразобранные файлы), — тогда вместо отсчёта видно «удаление задержано».
   Номера удалённых задач повторно не выдаются.
 
+## В паре с code-review-graph
+
+[code-review-graph](https://github.com/tirth8205/code-review-graph) строит локальный граф кода (функции, классы, их
+строки) в `.code-review-graph/graph.db` в корне репозитория. p-backlog без него работает, но если граф есть —
+использует его, только на чтение:
+
+- **Перепроверка по символу.** `source` задачи (`файл:строка`) сопоставляется с функцией или классом, в которых
+  стоит. Stop-хук и `backlog check` предлагают перепроверить задачу, только когда изменился этот символ, а не
+  любая строка файла, — лишних перепроверок меньше. Без графа проверка опирается на строки `source`, затем на весь
+  файл.
+- **Дубли по символу.** Две задачи, указывающие в одну функцию, предлагаются как возможные дубли.
+- **Состояние графа в вебе.** Боковая панель предупреждает, если у проекта нет графа, он устарел или не читается
+  (собран другой версией или для другого пути), и подсказывает команду, которая это исправит.
+- **Точность проверки.** Вкладка «Качество» в статистике показывает, как часто был прав каждый способ проверки: по
+  символу, по строкам `source`, по файлу.
+
+Настройка, один раз на репозиторий (инструмент на Python; подойдёт и `pipx install code-review-graph`):
+
+```bash
+uv tool install code-review-graph
+code-review-graph build                       # в корне репозитория
+code-review-graph install --platform claude-code  # по желанию: его MCP-сервер и инструкции для Claude Code
+```
+
+Чтобы граф не устаревал, держите запущенным `code-review-graph watch` или выполняйте `code-review-graph update`
+после изменений. Проверено с code-review-graph 2.3.
+
 ## Веб-приложение
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "p-backlog",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Personal developer backlog for Claude Code: tasks as Markdown files, CLI, Stop hook and a local web UI",
   "keywords": [
     "claude-code",