fix(import): единая идентичность внешних URI (#96)
CI / Rust Checks (push) Successful in 25m54s
CI / UI Checks (push) Successful in 5s
CI / Community Image Smoke (push) Successful in 1m47s
CI / Frontend E2E (push) Successful in 10m12s
CI / Deploy (push) Successful in 1m22s

Единая transport-canonical идентичность внешних документов; normalizer v6 с immutable historical replay; matrix 1.0.4 / corpus 1.0.5. PR CI run840 success, локальная приёмка и independent review выполнены.

Co-authored-by: bsodfather <bsodfather@gmail.com>
This commit was merged in pull request #96.
This commit is contained in:
bsodfather authored and bsodfather committed 2026-10-11 06:19:16 +00:00
1 parent 178093e81b
commit 1b6db09bd1
22 files changed
+1669 -353

No files matched your search

@@ -0,0 +1,170 @@
{
"dependencies": [],
"dependency_snapshots": [],
"normalization": {
"config": {
"external_references_enabled": false,
"max_aliases": 128,
"max_bytes": 262144,
"max_collection_items": 10000,
"max_depth": 64,
"max_expanded_nodes": 100000,
"max_external_document_bytes": 262144,
"max_nodes": 50000,
"max_reference_depth": 32,
"max_reference_documents": 32,
"max_references": 4096,
"max_scalar_bytes": 262144,
"normalizer_version": "normalized-ir-v5",
"projection_version": "preview-v6"
},
"ir_fingerprint": "1e7a724e849b657d79d78f494d962ba5ebc164f154902153a8ed0610e0744679",
"normalizer_version": "normalized-ir-v5",
"projection_version": "preview-v6"
},
"preview": {
"findings": [],
"groups": [
{
"key": "imported_operation",
"operations": [
{
"category": "imported",
"description": "Выполняет GET /items",
"draft": {
"category": "imported",
"display_name": "List Items",
"input_mapping": {},
"input_schema": {
"description": "Входные параметры MCP-инструмента",
"nullable": false,
"required": true,
"type": "object"
},
"name": "list_items",
"output_mapping": {
"rules": [
{
"required": true,
"source": "$.response.body.id",
"target": "$.output.id"
}
]
},
"output_schema": {
"description": "Ответ API",
"fields": {
"id": {
"nullable": false,
"required": true,
"type": "string"
}
},
"nullable": false,
"required": true,
"type": "object"
},
"target": {
"base_url": "https://api.example.test",
"method": "GET",
"path_template": "/items",
"response_contract": [
{
"media_type": "application/json",
"schema_variant": 0,
"status_code": 200
}
]
},
"tool_description": {
"description": "Выполняет GET /items",
"examples": [
{
"input": {}
}
],
"title": "List Items"
},
"wizard_state": {}
},
"findings": [
{
"code": "missing_summary",
"message": "У метода нет summary, отображаемое имя будет сгенерировано автоматически.",
"operation_key": "GET /items",
"severity": "warning",
"source_location": {
"pointer": "/paths/~1items/get"
}
},
{
"code": "missing_description",
"message": "У метода нет description. Перед публикацией лучше описать, когда агенту стоит вызывать этот инструмент.",
"operation_key": "GET /items",
"severity": "warning",
"source_location": {
"pointer": "/paths/~1items/get"
}
},
{
"code": "no_input_fields",
"message": "У инструмента нет входных параметров. Это нормально для справочных методов, но проверьте, что агенту не нужно передавать фильтры.",
"operation_key": "GET /items",
"severity": "info",
"source_location": {
"pointer": "/paths/~1items/get"
}
},
{
"code": "weak_tool_description",
"message": "Описание инструмента слишком короткое или техническое. Перед публикацией добавьте, когда агент должен вызывать инструмент и что будет в успешном ответе.",
"operation_key": "GET /items",
"severity": "warning",
"source_location": {
"pointer": "/paths/~1items/get"
}
},
{
"code": "weak_tool_name",
"message": "Имя инструмента `list_items` выглядит слишком общим. Лучше использовать имя с конкретным действием и объектом.",
"operation_key": "GET /items",
"severity": "warning",
"source_location": {
"pointer": "/paths/~1items/get"
}
}
],
"input_fields": 0,
"key": "GET /items",
"method": "GET",
"operation_id": "listItems",
"output_fields": 1,
"path": "/items",
"server_urls": [
"https://api.example.test"
],
"source_location": {
"pointer": "/paths/~1items/get"
},
"suggested_display_name": "List Items",
"suggested_name": "list_items"
}
],
"title": "Без группы"
}
],
"source": {
"format": "openapi",
"servers": [
"https://api.example.test"
],
"title": "URI preview parity",
"version": "3.1.0"
}
},
"preview_digest": "ab615bbb932979b3c9d7d78223fc932069e1d7443860a24c682edddc0de11637",
"source": {
"digest": "sha256:edc9f4ec760d76a6830ae5b9932881d898626faffbc0067162ddb44ebdf8b94c",
"source_id": "src_openapi_01a1278095397d018780ab3dafd4b464"
}
}