# Changelog

Все значимые изменения **tools/index** (индекс метаданных и модулей 1С) фиксируются в этом файле.

Формат: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
Версионирование: [Semantic Versioning](https://semver.org/lang/ru/).

## [0.3.1] - 2026-07-17

### Changed

- **`--help` подкоманд** `query_1c.py` и `index_1c.py`: общие опции (`--baseconf`, `--config`, `--root`) отображаются в справке каждой подкоманды, а не только на верхнем уровне.
- Текст подсказки `--baseconf` для `index_1c.py reindex`: «индексировать все выгрузки», не «поиск».
- **Автор и лицензия:** Michael BAG (mk@p7net.ru); GNU GPL v3 — [`LICENSE`](LICENSE), справочный перевод [`LICENSE.ru`](LICENSE.ru); раздел в README.

### Fixed

- `query_1c.py`: `-b` / `--baseconf` до подкоманды (`query_1c.py -b crm3-26 search …`) корректно применяется к запросу.

## [0.3.0] - 2026-07-16

### Added

- Таблица **`register_records`** (документ → регистры движений из `RegisterRecords`).
- Команда **`query_1c.py movements`**:
  - документ → список регистров движений;
  - регистр → список документов-регистраторов;
  - `--type`, `--limit`, `-b` как у остальных команд.
- Мягкая миграция схемы **2→3** при открытии индекса (без `reindex --full`): backfill из JSON объектов.

### Changed

- `SCHEMA_VERSION` = 3; инкрементальный `reindex` пишет связи в `register_records`.

## [0.2.0] - 2026-07-16

### Added

- Команда **`query_1c.py object`** — поиск по имени/синониму объекта или реквизита и вывод дерева структуры:
  - реквизиты, измерения, ресурсы, табличные части и колонки;
  - обязательность заполнения (`FillChecking`: обяз. / необяз.);
  - типы данных и ссылочные типы (`CatalogRef.*`, `DocumentRef.*`, `DefinedType.*`, …);
  - опция **`--clear`** — только найденные реквизиты или только заголовок объекта.
- Опция **`query_1c.py modules --names-only` / `-n`** — список модулей (owner + синоним) без фрагментов кода.
- В **`refs`**: лимит **на каждую** конфигурацию; группировка по baseconf; пометка **«среди прочего»** для составных типов.
- Разбор **`TypeSet`** (определяемые типы) и **`FillChecking`** в парсере метаданных.
- Файлы **`VERSION`**, **`CHANGELOG.md`**; флаг **`--version`** у `index_1c.py` и `query_1c.py`.

### Changed

- Параметр конфигурации 1С: **`--baseconf` / `-b`** (алиасы `target`→`crm3-26`, `source`→`crm3-dev`).
- **`--config` / `-c`** — только файл настроек утилиты (JSON), не выгрузка 1С.
- Информативные ошибки: нет индекса / нет папки `src/` / baseconf не проиндексирован / объект не найден (с подсказками).
- Расширена документация `README.md` (примеры, режимы, применение в Cursor).

### Fixed

- `refs` без `-b` больше не ограничивался первой конфигурацией из‑за `ORDER BY` + `LIMIT`.
- Фильтры `-b` / `--type` в `object`: скобки в SQL (`OR` vs `AND`).

## [0.1.0] - 2026-07-15

### Added

- Единый индекс проекта `cache/1c_meta/index.sqlite` (объекты, поля, ссылки, модули BSL, FTS5).
- `index_1c.py`: `reindex` (full / incremental), `status`, `list`; многопоточный разбор (`-j`).
- `query_1c.py`: `search`, `show`, `refs`, `modules`, `module`.
- Инкремент по `mtime`+`size` файлов; индекс модулей `**/*.bsl`.

[0.3.0]: https://git.p7net.ru/1c/index/-/tags/v0.3.0
[0.2.0]: https://git.p7net.ru/1c/index/-/tags/v0.2.0
[0.1.0]: https://git.p7net.ru/1c/index/-/tags/v0.1.0