Уровни актуальности

Страницы в этом vault'е устаревают с разной скоростью. Саммари статьи описывает неизменяемый источник и не устаревает само по себе - статья сказала то, что сказала. Страница toolbox описывает движущуюся цель: в репозитории выходят релизы, меняется лицензия или он забрасывается. Страница concept об LLM-агентах описывает то, что переписывается каждые несколько месяцев. Одинаковое отношение ко всем страницам приведёт либо к перечитыванию саммари, которые никак не могли измениться, либо к тому, что отставание страницы инструмента от своего репозитория на два года останется незамеченным.

Список freshness: во frontmatter выше - это машиночитаемая часть. warren lint --src . считывает его со страницы, где он объявлен, рассчитывает уровень для каждой страницы в wiki/, toolbox/, books/ и talks/ и сообщает обо всех страницах, чья дата updated: старше, чем допускает их уровень. Эта страница - единственное место, где зафиксированы уровни, поэтому таблица ниже и проверка линтера не могут противоречить друг другу. planned-pages решает ту же задачу для намеренных пробелов.

Как страница получает свой уровень

Базовый уровень определяется полем type:, затем разделом каталога, затем значением default. Тег может сократить конечный базовый срок, но никогда не увеличивает его и не отменяет never. Поэтому страница concept с тегом ai-agents устаревает за девять месяцев, а не за два года, тогда как страница summary с тем же тегом не устаревает вовсе: саммари посвящено статье, а статья уже не изменится.

Уровень	К чему применяется	Почему
`never`	`summary`, `book`, `talk` (через `default`)	Они описывают неизменяемый источник. Устареть может утверждение, которое vault повторяет в другом месте, но это вопрос смысловой части линтинга, а не этой проверки.
`2y`	`concept`	Идеи сохраняют актуальность; примеры и упомянутые вокруг них инструменты - нет.
`18m`	`entity`	Компании, продукты и люди меняют состояние: их покупают, переименовывают, закрывают.
`1y`	`toolbox`, `comparison`, `analysis`, `overview`	Страница инструмента - снимок состояния репозитория; сравнение - снимок нескольких репозиториев.
`9m`	теги `ai-agents`, `agentic-coding`, `coding-agent`, `llm`, `local-models`, `mcp`	Самая быстро меняющаяся область в vault'е. Страница concept об агентных фреймворках, написанная весной, к следующей весне описывает уже совсем другую область.
`6m`	тег `claude-code`	Продукт с еженедельными релизами; утверждения о его возможностях и хуках устаревают быстрее всего.

Сроки записываются как <n>d, <n>w, <n>m (месяцы, 30 дней) или <n>y (365 дней), либо словом never. Любой другой формат warren lint отклоняет с ошибкой front-freshness на этой странице, поскольку опечатка здесь молча исключила бы из проверки целый уровень.

У watchlist свой ритм - дата следующей проверки для каждой строки, по умолчанию 90 дней, - и здесь он не дублируется. Инструмент из списка наблюдения относится к уровню toolbox, как и любой другой; строка в таблице задаёт лишь более точный график.

Что делать при обнаружении устаревшей страницы

Срабатывание stale - это запрос на проверку, а не дефект. Перечитайте страницу, сопоставьте её с тем, что произошло с тех пор: вышел ли релиз, появился ли более свежий источник в vault'е, что написано в текущем README репозитория. Затем выберите одно из двух действий: обновите страницу, если что-то изменилось, или подтвердите её, если изменений нет. В обоих случаях нужно обновить дату updated:, поскольку даже проверка без правок фиксирует дату, на момент которой страница гарантированно верна, а именно это и измеряет проверка. Обновление даты updated: вслепую - единственное действие, которое полностью лишает проверку смысла.

Если проверка запускается заранее при подготовке к ревизии ("что устареет к декабрю?"), флаг warren lint --as-of 2026-12-01 проведёт расчёт относительно этой даты, а не сегодняшнего дня.