#region AxiomMCPToolsReport [C:1] [TYPE Module] [SEMANTICS axiom,mcp,tools,inventory,report]
@BRIEF Полный реестр 15 AXIOM MCP tools, доступных в проекте ss-tools, с описанием, назначением и ключевыми параметрами.
@RATIONALE Отчёт создан для фиксации текущего состояния инструментальной базы AXIOM. Позволяет быстро ориентироваться в доступных инструментах без повторного сканирования.
@DATA_CONTRACT Inventory -> { tool_name: str, purpose: str, key_operations: str[], workspace_required: bool }

## Отчёт: AXIOM MCP Tools — ss-tools

**Дата:** 2026-05-25  
**Индекс:** DuckDB (2543 контракта, 1987 связей)  
**Всего инструментов:** 15  

---

### 1. `axiom_contract_metadata`
- **Назначение:** Заголовочные метаданные + редактирование @RELATION рёбер.
- **Ключевые операции:** `update_metadata`, `update_metadata_batch`, `rename_tag`, `prune_metadata`, `add_relation_edge`, `remove_relation_edge`, `rename_relation_predicate`, `update_relation_batch`, `upgrade_complexity_for_scope`.
- **Требует workspace:** да.

---

### 2. `axiom_contract_patch`
- **Назначение:** Патчинг контрактов с preview, belief-протокол инструментация.
- **Ключевые операции:** `simulate`, `guarded_preview`, `guarded_apply`, `apply`, `belief_protocol_preview/apply`, `belief_protocol_apply_batch`.
- **Требует workspace:** да.
- **Примечание:** Не использовать для редактирования @RELATION рёбер — для этого есть `contract_metadata`.

---

### 3. `axiom_contract_refactor`
- **Назначение:** Переименование, перемещение, извлечение, обёртка контрактов; вывод missing @RELATION.
- **Ключевые операции:** `rename_contract_id`, `move_contract`, `extract_contract`, `wrap_node`, `infer_missing_relations_preview/apply`, `change_contract_type`, `infer_missing_relations_for_scope_preview/apply`, `migrate_def_to_region`.
- **Требует workspace:** да.

---

### 4. `axiom_runtime_evidence`
- **Назначение:** Маппинг runtime-трейсов на контракты + чтение структурированных событий.
- **Ключевые операции:** `map_trace_to_contracts`, `read_events`.
- **Требует workspace:** да.

---

### 5. `axiom_security_workflow`
- **Назначение:** Сканирование уязвимостей + подготовка handoff'ов для security-ревью.
- **Ключевые операции:** `scan`, `prepare_handoff`.
- **Требует workspace:** да.

---

### 6. `axiom_semantic_context`
- **Назначение:** Локальный граф (neighbourhood), task-пакеты, health воркспейса, гибридные запросы.
- **Ключевые операции:** `local_context`, `task_context`, `workspace_health`, `hybrid_query`.
- **Режимы `hybrid_query`:** `semantic_neighborhood`, `blast_radius`, `dependency_path`, `dead_code_islands`, `cycle_detection`, `runtime_federation`.
- **Требует workspace:** да.

---

### 7. `axiom_semantic_discovery`
- **Назначение:** Поиск контрактов, AST-поиск, read_outline, описание тегов.
- **Ключевые операции:** `search_contracts`, `ast_search`, `read_outline`, `describe_tags`.
- **Особенности:** Fuzzy-поиск через DuckDB (Levenshtein distance) при `fuzzy=true`.
- **Требует workspace:** да (кроме `describe_tags`).

---

### 8. `axiom_semantic_index`
- **Назначение:** Переиндексация (in-memory), пересборка (DuckDB), статус индекса.
- **Ключевые операции:** `reindex`, `rebuild`, `status`.
- **Режимы:** `incremental` / `full`, с опцией DuckDB и refresh embeddings.
- **Требует workspace:** да.

---

### 9. `axiom_semantic_validation`
- **Назначение:** Аудит контрактов, belief-протокола, runtime, diff, impact-анализ.
- **Ключевые операции:** `audit_contracts`, `audit_belief_protocol`, `audit_belief_runtime`, `diff_contract_semantics`, `impact_analysis`.
- **Фильтры:** `file_path`, `filter_mode` (prefix/contains/exact), `limit`/`offset`.
- **Требует workspace:** да.

---

### 10. `axiom_testing_support`
- **Назначение:** Поиск связанных тестов + генерация scaffold-тестов из метаданных контракта.
- **Ключевые операции:** `trace_related_tests`, `scaffold_tests`.
- **Требует workspace:** да.

---

### 11. `axiom_workspace_artifact`
- **Назначение:** Создание/патч/удаление файлов, генерация docs, scaffold-модулей.
- **Ключевые операции:** `create_file`, `patch_file`, `delete_file`, `scaffold_module`, `scaffold_docs`, `generate_docs`.
- **Режимы target:** `exact_text`, `regex`, `whole_file`.
- **Требует workspace:** да.

---

### 12. `axiom_workspace_checkpoint`
- **Назначение:** Чекпоинты — суммари, diff, rollback preview/apply.
- **Ключевые операции:** `summarize`, `diff`, `rollback_preview`, `rollback_apply`.
- **Требует workspace:** да.

---

### 13. `axiom_workspace_command`
- **Назначение:** Выполнение shell-команд + метрики сервера.
- **Ключевые операции:** `run`, `server_metrics`.
- **Требует workspace:** да (кроме `server_metrics`).

---

### 14. `axiom_workspace_path`
- **Назначение:** Операции с файловой системой (mkdir, move, rename, delete, inspect).
- **Ключевые операции:** `mkdir`, `move`, `rename`, `delete`, `inspect`.
- **Требует workspace:** да.

---

### 15. `axiom_workspace_policy`
- **Назначение:** Разрешение политик, защищённых путей, рабочих директорий.
- **Требует workspace:** да.

---

## Сводная таблица

| # | Инструмент | Категория | Preview | Checkpoint | DuckDB |
|---|-----------|-----------|---------|------------|--------|
| 1 | `axiom_contract_metadata` | Метаданные | да | да | да |
| 2 | `axiom_contract_patch` | Патчинг | да | да | да |
| 3 | `axiom_contract_refactor` | Рефакторинг | да | да | да |
| 4 | `axiom_runtime_evidence` | Runtime | нет | нет | да |
| 5 | `axiom_security_workflow` | Безопасность | нет | нет | да |
| 6 | `axiom_semantic_context` | Контекст | нет | нет | да |
| 7 | `axiom_semantic_discovery` | Поиск | нет | нет | да |
| 8 | `axiom_semantic_index` | Индекс | нет | нет | да |
| 9 | `axiom_semantic_validation` | Валидация | нет | нет | да |
| 10 | `axiom_testing_support` | Тестирование | нет | нет | да |
| 11 | `axiom_workspace_artifact` | Файлы | да | нет | да |
| 12 | `axiom_workspace_checkpoint` | Чекпоинты | да | да | да |
| 13 | `axiom_workspace_command` | Команды | нет | нет | да |
| 14 | `axiom_workspace_path` | FS | да | нет | да |
| 15 | `axiom_workspace_policy` | Политики | нет | нет | да |

**Итого:** 15 инструментов, все интегрированы с DuckDB-индексом. 6 инструментов поддерживают preview-режим. 4 поддерживают checkpoint-механизм.

#endregion AxiomMCPToolsReport
