busya/ss-tools
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
034-task-status-center
ss-tools/docs/axiom-mcp-tools-report.md
busya ec6421de35 rename ss-tools to superset-tools across the entire project 
- Replace all occurrences of 'ss-tools' with 'superset-tools' in 104 files
- Rename git bundle file ss-tools.bundle → superset-tools.bundle
- Update .gitignore pattern accordingly
- Preserve variable names (hasSsTools etc.) and code identifiers
2026-06-16 11:15:19 +03:00

7.9 KiB
Raw Permalink Blame History

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

Отчёт: AXIOM MCP Tools — superset-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