p-backlog 0.2.0 → 0.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +8 -0
- package/README.md +29 -0
- package/README.ru.md +29 -0
- package/package.json +14 -4
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,13 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.2.2
|
|
4
|
+
|
|
5
|
+
- 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.
|
|
6
|
+
|
|
7
|
+
## 0.2.1
|
|
8
|
+
|
|
9
|
+
- npm keywords match the GitHub topics, so the package is easier to find in npm search. No code changes.
|
|
10
|
+
|
|
3
11
|
## 0.2.0
|
|
4
12
|
|
|
5
13
|
- Two interface languages: Russian and English (`backlog config language`, RU/EN switch in the web UI).
|
package/README.md
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# p-backlog
|
|
2
2
|
|
|
3
|
+
[](https://www.npmjs.com/package/p-backlog) [](https://www.npmjs.com/package/p-backlog) [](https://github.com/expatriate/p-backlog/actions/workflows/ci.yml) [](https://nodejs.org) [](LICENSE)
|
|
4
|
+
|
|
3
5
|
**[Русская версия](README.ru.md)**
|
|
4
6
|
|
|
5
7
|
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.
|
|
|
112
114
|
the backlog still has unprocessed files) — the countdown then shows "deletion delayed" instead.
|
|
113
115
|
Deleted task numbers are never reused.
|
|
114
116
|
|
|
117
|
+
## Works well with code-review-graph
|
|
118
|
+
|
|
119
|
+
[code-review-graph](https://github.com/tirth8205/code-review-graph) builds a local graph of your code (functions,
|
|
120
|
+
classes, their lines) in `.code-review-graph/graph.db` at the repository root. p-backlog doesn't need it, but uses
|
|
121
|
+
it when it's there — read-only:
|
|
122
|
+
|
|
123
|
+
- **Re-check by symbol.** A task's `source` (`file:line`) is matched to the function or class that contains it. The
|
|
124
|
+
Stop hook and `backlog check` then flag the task only when that symbol changed, not when any line of the file
|
|
125
|
+
moved — fewer needless re-checks. Without the graph the check falls back to the task's source lines, then to the
|
|
126
|
+
whole file.
|
|
127
|
+
- **Duplicates by symbol.** Two tasks pointing into the same function are offered as possible duplicates.
|
|
128
|
+
- **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
|
|
129
|
+
read (built by a different version or for a different path), with the command that fixes it.
|
|
130
|
+
- **Check precision.** The Quality tab in statistics shows how often each check method (by symbol, by source lines,
|
|
131
|
+
by file) was right.
|
|
132
|
+
|
|
133
|
+
Setup, once per repository (Python tool; `pipx install code-review-graph` works too):
|
|
134
|
+
|
|
135
|
+
```bash
|
|
136
|
+
uv tool install code-review-graph
|
|
137
|
+
code-review-graph build # in the repository root
|
|
138
|
+
code-review-graph install --platform claude-code # optional: its MCP server and instructions for Claude Code
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
Keep the graph fresh with `code-review-graph watch`, or run `code-review-graph update` after changes. Tested with
|
|
142
|
+
code-review-graph 2.3.
|
|
143
|
+
|
|
115
144
|
## Web app
|
|
116
145
|
|
|
117
146
|
```bash
|
package/README.ru.md
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# p-backlog
|
|
2
2
|
|
|
3
|
+
[](https://www.npmjs.com/package/p-backlog) [](https://www.npmjs.com/package/p-backlog) [](https://github.com/expatriate/p-backlog/actions/workflows/ci.yml) [](https://nodejs.org) [](LICENSE)
|
|
4
|
+
|
|
3
5
|
**[English version](README.md)**
|
|
4
6
|
|
|
5
7
|
Беклог задач, который живёт markdown-файлами: их создаёт ИИ-агент во время работы над кодом, а человек
|
|
@@ -107,6 +109,33 @@
|
|
|
107
109
|
- Любая закрытая задача удаляется через 7 дней вместе с файлом: это делает сервер при старте и раз в час. Задачу завершённого эпика сервер держит, пока эпик не закроется (например, пока в беклоге есть неразобранные файлы), — тогда вместо отсчёта видно «удаление задержано».
|
|
108
110
|
Номера удалённых задач повторно не выдаются.
|
|
109
111
|
|
|
112
|
+
## В паре с code-review-graph
|
|
113
|
+
|
|
114
|
+
[code-review-graph](https://github.com/tirth8205/code-review-graph) строит локальный граф кода (функции, классы, их
|
|
115
|
+
строки) в `.code-review-graph/graph.db` в корне репозитория. p-backlog без него работает, но если граф есть —
|
|
116
|
+
использует его, только на чтение:
|
|
117
|
+
|
|
118
|
+
- **Перепроверка по символу.** `source` задачи (`файл:строка`) сопоставляется с функцией или классом, в которых
|
|
119
|
+
стоит. Stop-хук и `backlog check` предлагают перепроверить задачу, только когда изменился этот символ, а не
|
|
120
|
+
любая строка файла, — лишних перепроверок меньше. Без графа проверка опирается на строки `source`, затем на весь
|
|
121
|
+
файл.
|
|
122
|
+
- **Дубли по символу.** Две задачи, указывающие в одну функцию, предлагаются как возможные дубли.
|
|
123
|
+
- **Состояние графа в вебе.** Боковая панель предупреждает, если у проекта нет графа, он устарел или не читается
|
|
124
|
+
(собран другой версией или для другого пути), и подсказывает команду, которая это исправит.
|
|
125
|
+
- **Точность проверки.** Вкладка «Качество» в статистике показывает, как часто был прав каждый способ проверки: по
|
|
126
|
+
символу, по строкам `source`, по файлу.
|
|
127
|
+
|
|
128
|
+
Настройка, один раз на репозиторий (инструмент на Python; подойдёт и `pipx install code-review-graph`):
|
|
129
|
+
|
|
130
|
+
```bash
|
|
131
|
+
uv tool install code-review-graph
|
|
132
|
+
code-review-graph build # в корне репозитория
|
|
133
|
+
code-review-graph install --platform claude-code # по желанию: его MCP-сервер и инструкции для Claude Code
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
Чтобы граф не устаревал, держите запущенным `code-review-graph watch` или выполняйте `code-review-graph update`
|
|
137
|
+
после изменений. Проверено с code-review-graph 2.3.
|
|
138
|
+
|
|
110
139
|
## Веб-приложение
|
|
111
140
|
|
|
112
141
|
```bash
|
package/package.json
CHANGED
|
@@ -1,13 +1,23 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "p-backlog",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.2",
|
|
4
4
|
"description": "Personal developer backlog for Claude Code: tasks as Markdown files, CLI, Stop hook and a local web UI",
|
|
5
5
|
"keywords": [
|
|
6
|
-
"backlog",
|
|
7
6
|
"claude-code",
|
|
8
|
-
"
|
|
7
|
+
"claude",
|
|
8
|
+
"anthropic",
|
|
9
|
+
"ai-agents",
|
|
10
|
+
"coding-agent",
|
|
11
|
+
"agent-skills",
|
|
12
|
+
"backlog",
|
|
9
13
|
"task-management",
|
|
10
|
-
"
|
|
14
|
+
"tech-debt",
|
|
15
|
+
"todo",
|
|
16
|
+
"developer-tools",
|
|
17
|
+
"productivity",
|
|
18
|
+
"cli",
|
|
19
|
+
"markdown",
|
|
20
|
+
"local-first"
|
|
11
21
|
],
|
|
12
22
|
"homepage": "https://github.com/expatriate/p-backlog#readme",
|
|
13
23
|
"repository": {
|