add-tool

name	add-tool
description	Добавить новый инструмент (карточку) в ландшафт технологий 1С — разметка по методологии, связи, логотип, проверки. Use when the user asks to add a new tool/instrument/card to the landscape (добавить инструмент, новая карточка, принесли технологии).

Добавление инструмента в ландшафт

Карточка живет в app/data.js (window.LANDSCAPE.items). Правила разметки — docs/METHODOLOGY.md (сверяйся с ним, ниже — выжимка). UI только русский, без буквы «ё».

1. Собери сведения

Имя (как принято в сообществе), сайт, репозиторий, что делает, зачем 1С-специалисту. Если пользователь принес список — у него могут быть подсказки по зрелости/происхождению, используй их, но проверяй по методологии.

2. Разметь 6 осей

• roles (массив) — кто «работает руками»: разработчик / администратор (включая devops) / тестировщик / аналитик. Решения: производительность и СУБД — админ (исключение: анализ техжурнала — разработчик); юнит-тесты — разработчик; функциональные автотесты — тестировщик (+аналитик помогает сценариям); CI-серверы — А+Т+Р; API-клиенты — Р+Т (+Ан, если аналитики реально пользуются).
• contexts (массив): франчайзи (простота, минимум инфраструктуры) / продукты (максимум современных практик) / проекты (крупные внедрения) / инхаус (самый широкий профиль).
• maturity (скаляр) — положение в экосистеме 1С, не общесофтовое: базовое (обязан знать каждый) / продвинутое (профессиональный мейнстрим) / нишевое (узкие задачи; новые отечественные продукты и технически устаревшие — сюда).
• origin: отечественное / зарубежное — по родине технологии (ClickHouse — отечественное).
• license: open-source (по основному продукту) / бесплатное (закрытый код, бесплатно; или платный сервис с рабочим бесплатным тарифом — GitHub, Jira) / проприетарное.
• availability: ограничен — вендор ушел из РФ, заблокировал аккаунты или платный зарубежный продукт, который из РФ не купить; рабочий из РФ бесплатный тариф = доступен. Проверь «соседей» вендора: у JetBrains/HashiCorp/Atlassian/Microsoft/Amazon все продукты должны быть размечены одинаково.

Значения должны точно совпадать с axes.<ось>.values в data.js — иначе фильтр не сработает (проверит validate.js).

3. Категория и подкатегория

Категория — только из LANDSCAPE.categories. Подкатегорию смотри у соседей по категории (выгрузи их: node -e со списком category/subcategory). Если карточка не ложится в существующие подгруппы — оставь subcategory: null (на схеме такие рисуются сверху колонки). Новую подкатегорию заводи, только когда в ней будет ≥2 карточек.

Пороги ёмкости (жёсткие, проверяет validate.js): подкатегория — не более 9 инструментов (бакет «без подкатегории» тоже считается); раздел (blocks) — не более 6 категорий. Если новая карточка переполняет подкатегорию — разбей группу на подкатегории; если в подходящий раздел не влезает новая категория — заведи новый раздел. Подробнее — docs/METHODOLOGY.md («Ёмкость подкатегорий и разделов»).

4. Тексты

• description — одна строка, что это; why — зачем 1С-нику, конкретная польза. Оба без точки в конце, без «ё» (проверяет validate.js).
• aliases — скрытые поисковые синонимы: русские транслитерации и разговорные названия («мермейд», «тимсити»).
• start — массив {label, url} ссылок «с чего начать», можно пустой.

5. Связи

• analogs — двусторонние: добавил на новой карточке → добавь новую в analogs каждой указанной. Валидатор проверит и существование имен, и симметрию.
• depends — односторонние (только у зависимой карточки).

6. Запись в data.js

Мелкие правки — через редактор (./start.command → кнопка «Сохранить» сама пишет файл и прогоняет cachebust). Программно — либо точечные текстовые вставки, либо полная пересериализация строго канонично, как editor.js: JSON.stringify(D, null, 2) без umbrella и без пустых analogs/depends (файл хранится в этой канон-форме, validate.js проверяет совпадение байт-в-байт). Формат: JSON с 2-пробельным отступом, объекты items с отступом 4, поля 6, элементы массивов 8. Вставка новой карточки — перед \n ]\n}; в конце файла:

const obj = JSON.stringify(card, null, 2).split("\n")
    .map((l, k) => (k ? "    " + l : l)).join("\n");
src = src.slice(0, tailAt) + ",\n    " + obj + src.slice(tailAt);

Дописывание в массив существующей карточки — найди сегмент по "name": <json-имя> до следующего "name": ", замени regex-ом ("roles": \[)([\s\S]*?)(\n {6}\]) → `${m[1]}${m[2]},\n ${JSON.stringify(value)}${m[3]}` — не теряй ${m[3]} (закрывающую скобку). Поля может не быть вовсе (редактор не пишет пустые массивы) — тогда вставь его перед закрытием объекта.

Даты карточки (ISO YYYY-MM-DD): у новой карточки задай и added, и updated = сегодня. При ручной правке существующей карточки обнови её updated на сегодня (редактор делает это сам; программно — не забудь). validate.js требует корректные added/updated у каждой карточки и updated >= added.

При ручной правке обнови и LANDSCAPE.updated (дата файла) на сегодняшнюю дату («11 июня 2026» — без нулей, месяц родительным падежом).

7. Логотип

Источники по убыванию удобства (проверять curl-ом, что пришел настоящий SVG/PNG, а не HTML-страница 404):

1. https://cdn.simpleicons.org/<slug> — отдает SVG в фирменном цвете;
2. https://cdn.jsdelivr.net/gh/gilbarbara/logos@master/logos/<name>.svg (есть варианты <name>-icon.svg);
3. официальный сайт: /favicon.svg, /icon.svg, логотип со страницы;
4. Wikimedia API: commons.wikimedia.org/w/api.php?action=query&list=search&srnamespace=6.

Файл — в app/logos/, имя маленькими буквами через дефис, SVG предпочтительнее PNG. В карточке logo: "имя.svg"; темный монохромный логотип — "logoInvert": true (движок инвертирует в темной теме). Не нашелся — logo: null (заглушка «1С»), скажи об этом пользователю.

8. Проверки и коммит

node scripts/validate.js     # оси, категории, логотипы, связи и их симметрия, канон-форма, «ё», точки
node scripts/cachebust.js    # бамп ?v= у data.js на всех страницах

Смоук без скриншотов (визуал проверяет пользователь): страница должна открываться без ошибок консоли, карточка находиться поиском, модалка показывать категорию · подкатегорию. Коммит в стиле репозитория: Данные: <что добавлено> (<новое число карточек>), подпись Co-Authored-By: Claude Fable 5 <[e-mail]>.