# Переносимость: UNIVERSAL

PATH
====

`bach path` создает центральный реестр путей из `hub/bach_paths.py`
Может использоваться напрямую через CLI и API. Вывод удобен для чтения человеком
а также `--json`, подходящий для автоматизации.


КОМАНДЫ
-------

  bach path
    Показывает сгруппированные наиболее важные пути BACH.

  bach path <name>
  bach path get <name>
    Отображает один зарегистрированный путь с метаданными.

  bach path list [--json]
    Перечисляет полный реестр.

  bach path resolve <relativer-pfad> [--from-root] [--json]
    Разрешает относительный путь к `system/` или корню репо.

  bach path overrides [--json]
    Показывает переопределения активного пути к БД из `system_config`.

  bach path validate [--json]
    Проверяет критические, важные и дополнительные пути.

  bach path set <name> <pfad>
    Сохраняет переопределение пути в канонической базе данных BACH.


ПРИМЕРЫ
---------

  bach path
    -> Сводка для операторов

  bach path db
    -> Канонический путь к базе данных

  bach path list --json
    -> Полный реестр в формате JSON

  bach path resolve docs/README.md --from-root
    -> Абсолютный путь относительно корня репо

  bach path overrides
    -> Проверьте активные переопределения БД


JSON-SURFACES
-------------

Эти вызовы предоставляют машиночитаемые ответы:

  bach path --json
  bach path list --json
  bach path db --json
  bach path overrides --json
  bach path validate --json
  bach path resolve docs/help/path.txt --json


ВАЖНЫЕ ДЕТАЛИ
----------------

- Источник остается `hub/bach_paths.py` (единый источник истины).
- Если `base_path` является внешним, обработчик отражает пути к активному.
  Корень среды выполнения, чтобы тесты и переносимые экземпляры давали чистые результаты.
  получил.
- Переопределения считываются из канонической БД активного корня и
  записано, а не по глобально жестко запрограммированному пути.


ФАЙЛЫ
-------

  Hub/path.py обработчик CLI/API
  Hub/bach_paths.py Центральный реестр путей
  data/bach.db `system_config` для переопределения пути


СМОТРИ ТАКЖЕ
----------

  агент помощи Агент CLI
  Помощь планировщику Области состояния планировщика
  справочные инструменты обзор инструментов
