# tools-debug

Статус: отключен по умолчанию и fail-closed. Этот extension больше не запускает Node subprocess, не хранит debug session, не записывает fake breakpoints и не отправляет debug events.

## Назначение

`tools-debug` должен отвечать за debugger workflows: launch/attach, breakpoints, stepping, pause, output, stack/threads/variables and terminate. После OMP-grounded review локальный skeleton признан неправильной границей, потому что он запускал процесс, но не реализовывал настоящий debugger control.

## Почему он есть в проекте

Extension оставлен как disabled contract shell для старого tool name `debug`. Он показывает желаемую capability, но не притворяется debugger. Настоящее поведение должно быть портировано или тонко упаковано из OMP DAP `debug` tool.

## Пользовательская поверхность

Tool `debug` принимает старые local actions `launch`, `attach`, `set_breakpoint`, `continue`, `pause`, `terminate` и report-only action `sessions`. `sessions` возвращает статус, а остальные actions возвращают `isError=true` с `details.owner="omp-debug-dap"`, `details.ported=false` и `details.redesignRequired=true`.

Пользователь напрямую команду не вызывает.

## Как работает по коду

Entrypoint регистрирует только TypeBox schema и fail-closed handler. Код не импортирует `spawn`, не вызывает `process.execPath`, не читает и не пишет filesystem, не мутирует module-level session state и не отправляет dev events.

- Entrypoint: `./extensions/tools-debug/index.ts`
- Manifest: `extensions/tools-debug/manifest.json`
- Commands: none
- Tools: `debug`
- Hooks: none
- Permissions: fs.read=none, fs.write=none, subprocess=none, network=none, browser=false, models=false, ui=none
- State: none
- Review: status=reviewed, source=wrapper-first, reviewedBy=pi-dev-extensions, reviewedAt=2026-06-01, risk=high

## Ограничения и риски

Этот extension intentionally does not provide live debugging. Если включить его как есть, агент получит только fail-closed errors. Это правильно до тех пор, пока OMP DAP session manager, adapter selection, approval tiers, launch/attach error handling and renderer behavior are not ported.

## Решение

Решение: `disabled`, OMP-owned-to-import. Local subprocess wrapper удален; future plugin must use OMP DAP debug source truth.