каталог задач уехал из docs/ в корень репозитория

Версия 8 отпустила задачи из канона — перестала требовать каталог и перестала в
него смотреть, — но место он занимал всё то же, docs/tasks/. Полдела: каталог,
принадлежащий одному плагину, лежал внутри дерева, которым владеет другой.
Проекту, поставившему учёт работ без канона документов, приходилось заводить
docs/ ради одной вложенной папки.

Дом задач теперь tasks/ в корне. tasks.py ищет его там первым, docs/tasks и
doc/tasks остались в списке поиска для непереехавших проектов, init заводит
только в корне, --target у adopt тоже. Настройки лежат рядом, tasks/.tasks.json —
после версии 8 они уже были в своём файле, теперь и файл вне чужого дерева.

docs.py продолжает терпеть docs/tasks/ в списке нечитаемого: непереехавший проект
не должен получать выдуманную ошибку «файл вне канона» вдобавок к записи журнала,
которая и так велит ему переехать. Адреса упразднённых слотов (plan.md, backlog/)
теперь ведут в tasks/ и называют плагин.

Тридцать три живых упоминания пути разведены по смыслу, а не заменой строки: в
раскладке канона tasks/ вышел из-под docs/ и стоит на своём уровне; у
doc-consistency каталог перестал быть исключением внутри docs/** и стал чужой
территорией, названной в обеих формах; у review-scope и review-pipeline
процессный список поехал вместе с путём. В журнале версий тринадцать упоминаний
оставлены как есть — они описывают прошлое состояние.

Канон повышен до версии 11. В записи названа тихая часть переезда: файл
tasks/items/x.md стал на уровень ближе к корню, и ../../passport.md в теле записи
теперь ../docs/passport.md. Битую относительную ссылку внутри записи tasks.py
check не ловит вовсе — её видит только docs.py и только у документов канона, так
что этот шаг делается руками и тем же коммитом, что git mv.

Фикстура переехала, поиск вверх по дереву находит новый путь, гейт зелёный.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
av
2026-08-09 14:33:33 +03:00
co-authored by Claude Opus 5
parent fdadfb65ac
commit f40e0cd7bb
13 changed files with 91 additions and 53 deletions
+18 -17
View File
@@ -6,11 +6,12 @@
спринт — замороженный набор задач, обычно под одну цель. Индексов теперь
четыре, и задача живёт ровно в одном из них за раз.
Раскладка. Путь каталога — `docs/tasks`, жёстко: это часть канона документов
av-dev, и подгоняется под него проект. Имена внутри настраиваются через
`docs/.pm.json`, ключ `tasks`.
Раскладка. Путь каталога — `tasks/` в корне репозитория, жёстко. Каталог
принадлежит этому плагину, а не канону документов: `docs/` ведёт другой плагин, и
проект, поставивший учёт работ без него, каталога `docs/` не имеет вовсе. Имена
внутри настраиваются через `tasks/.tasks.json`.
docs/tasks/
tasks/
items/ задачи и цели файлами, <slug>.md
ROADMAP.md состояние проекта: что уже умеет и чего ещё не умеет.
Секции канонические и в этом порядке: Запланировано |
@@ -75,9 +76,9 @@ goal | feature | fix | chore | research, по-английски, как и пр
tasks.py adopt scan --from PATH [PATH …] [--target DIR] [--out PLAN.json]
tasks.py adopt apply --plan PLAN.json [--refs PATH …] [--dry-run]
Каталог задач: `--dir` (обязан быть внутри рабочего каталога) → `docs/tasks`
вверх от текущего каталога. Прежние раскладки (`tasks`, `doc/tasks`) читаются,
пока живы непереехавшие проекты; переводит их скилл av-dev-docs:canon.
Каталог задач: `--dir` (обязан быть внутри рабочего каталога) → `tasks/` вверх
от текущего каталога. Прежние раскладки (`docs/tasks`, `doc/tasks`) читаются,
пока живы непереехавшие проекты; переезд — запись 11 журнала версий канона.
Коды выхода (единый словарь, на нём ветвятся скиллы):
@@ -572,7 +573,7 @@ def resolve_layout(explicit: str | None) -> Layout:
return Layout(root, load_config(root))
here = Path.cwd().resolve()
for base in (here, *here.parents):
for candidate in (base, base / "docs/tasks", base / "tasks", base / "doc/tasks"):
for candidate in (base, base / "tasks", base / "docs/tasks", base / "doc/tasks"):
if looks_like_tasks(candidate):
try:
rel = candidate.relative_to(here)
@@ -581,10 +582,10 @@ def resolve_layout(explicit: str | None) -> Layout:
return Layout(rel if str(rel) != "." else candidate, load_config(candidate))
if (base / ".git").exists():
break # выше корня репозитория не ищем
raise Env("каталог задач не найден: ни --dir, ни docs/tasks вверх от"
f" {here}. По канону путь всегда docs/tasks; чужую раскладку"
" переводит скилл av-dev-docs:canon, новый проект —"
" tasks.py init --dir docs/tasks")
raise Env("каталог задач не найден: ни --dir, ни tasks/ вверх от"
f" {here}. Путь всегда tasks/ в корне репозитория; прежний"
" docs/tasks переезжает по записи 11 журнала версий канона,"
" новый проект — tasks.py init --dir tasks")
# --- Чтение индексов ---
@@ -3090,9 +3091,9 @@ def cmd_adopt_scan(a: argparse.Namespace) -> int:
def requalify_links(text: str, old_dir: Path, new_dir: Path) -> str:
"""Относительные ссылки тела после переезда файла глубже.
`docs/backlog/x.md` знал соседей как `../passport.md`; из
`docs/tasks/items/x.md` тот же файл — уже `../../passport.md`. Молча
съехавшая на уровень ссылка — самый дешёвый способ развалить документацию.
`docs/backlog/x.md` знал соседей как `../passport.md`; из `tasks/items/x.md`
тот же файл — уже `../docs/passport.md`. Молча съехавшая на уровень ссылка —
самый дешёвый способ развалить документацию.
"""
delta = len(new_dir.parts) - len(old_dir.parts)
if delta <= 0:
@@ -3420,7 +3421,7 @@ def main() -> int:
asub = p.add_subparsers(dest="adopt_command", required=True)
s = asub.add_parser("scan", help="только карта: что найдено и как разложилось")
s.add_argument("--from", dest="sources", nargs="+", required=True)
s.add_argument("--target", default="docs/tasks")
s.add_argument("--target", default="tasks")
s.add_argument("--out", default="tasks-adopt-plan.json")
s.add_argument("--sections", default=DEFAULT_SECTIONS)
@@ -3431,7 +3432,7 @@ def main() -> int:
a = ap.parse_args()
if a.command == "init":
return cmd_init(Path(a.dir or "docs/tasks"), a)
return cmd_init(Path(a.dir or "tasks"), a)
if a.command == "adopt":
return cmd_adopt_scan(a) if a.adopt_command == "scan" else cmd_adopt_apply(a)
lay = resolve_layout(a.dir)