code-search

name	code-search
description	Поиск и исследование BSL-кода и точек входа 1С. Используй когда нужно найти реализацию, вызовы, обработчики, модули, поток выполнения или быстро разобраться в механизме конфигурации.

Code Search

MCP routing

• Preferred path: use MCP unica tools unica.code.search, unica.code.definition, unica.code.outline, unica.code.grep, unica.code.graph, unica.meta.profile, and unica.project.map.
• Use object-specific unica.*.info tools when code behavior depends on metadata, forms, SKD, roles, or HTTP service structure.
• Do not call internal code-index, analyzer, or package adapters directly. They are hidden behind MCP unica.

Tool choice

• MCP-first discipline: prefer the public unica.* project-index tools before shell search for 1C source. Use shell search only after the relevant unica.code.* / unica.meta.* attempts did not close the context gap, and report what was tried when that fallback matters to the answer.
• Use unica.code.definition for an exact procedure/function definition by name, especially exported methods.
• Use unica.code.outline before reading a large module; it gives regions, header context, and method ranges.
• Use unica.code.grep for arbitrary text, XML, query fragments, string literals, captions, and non-method tokens.
• Use unica.code.graph for callers, callees, neighbors, graph overview, and impact analysis when a method or metadata node id is known or can be resolved.
• Use unica.meta.profile for a compact metadata object profile: structure, modules, roles, event subscriptions, functional options, and predefined items.
• Use unica.code.search for broad BSL search and mixed analyzer/index results.

Workflow

1. Map the workspace with unica.project.map when the active source-set or source format is unclear.
2. For an exact metadata object name, call unica.meta.profile before broad search to identify related modules, rights, subscriptions, and functional options.
3. Resolve exact method names with unica.code.definition; inspect large candidate modules with unica.code.outline.
4. For flow questions, resolve the node and ask unica.code.graph for callers, callees, or neighbors before treating lexical hits as execution flow.
5. Search exact identifiers next: object names, module names, event handlers, exported procedures, command names, URL templates.
6. Use unica.code.grep for raw text fragments that are not BSL method names.
7. Broaden only after exact search fails: synonyms, business terms, common module prefixes, form command captions.
8. Fall back to local rg only for repository files outside the public Unica index or after the MCP-first attempts above were insufficient.
9. For every result, separate declaration, caller, handler, graph edge, and dead-looking match. Do not infer flow from one hit.
10. Report concrete file paths and line anchors; include the query that produced each important hit when the search was non-obvious.

Common searches

• Object lifecycle: ОбработкаПроведения, ПередЗаписью, ПриЗаписи, ПриСозданииНаСервере.
• Managed form flow: command handler, server procedure, client wrapper, form attribute name.
• Integrations: HTTP service root URL, method name, header name, endpoint path, exchange plan node.
• BSP entry points: exported common-module procedure plus surrounding callers.

MCP examples

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "unica.project.map",
    "arguments": {
      "cwd": "<workspace>"
    }
  }
}

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "unica.code.search",
    "arguments": {
      "cwd": "<workspace>",
      "query": "ОбработкаПроведения",
      "limit": 20
    }
  }
}

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "unica.code.graph",
    "arguments": {
      "cwd": "<workspace>",
      "mode": "callers",
      "id": "method:CommonModule.Продажи.ОбработкаПроведения",
      "limit": 25
    }
  }
}

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "unica.meta.profile",
    "arguments": {
      "cwd": "<workspace>",
      "name": "Document.SalesOrder",
      "sections": ["structure", "modules", "roles", "subscriptions", "functionalOptions"],
      "limit": 20
    }
  }
}

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "unica.code.definition",
    "arguments": {
      "cwd": "<workspace>",
      "name": "ОбработкаПроведения",
      "limit": 10
    }
  }
}

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "unica.code.grep",
    "arguments": {
      "cwd": "<workspace>",
      "query": "ВЫБРАТЬ",
      "fileTypes": "bsl",
      "limit": 20
    }
  }
}