1c-code-search — locate BSL code
Project-source search is MCP-first within verified contour coverage: graph → mapped code-metadata → scoped native Grep after a bounded miss with a one-line fallback note. Skip uncovered lanes; never substitute a neighboring contour's index. content/rules/multi-contour-search.md selects scope and server mappings for multiple roots; content/rules/mcp-first-search.md owns retrieval, freshness and native exceptions. This skill owns the calls below; any shared-server scope arguments must match its live contract.
Tools and exact arguments
Every graph call below includes the returned project_id matched to the current source roots; <resolved-project-id> in examples must be substituted, never sent literally. Discover via list_graph_projects using the mcp-1c-tools router before this skill when needed. Verify the relevant extension layer and response attribution. Code-server scope comes from its own live schema/mapping; do not copy graph arguments into it. Contract and ambiguity handling — content/rules/multi-contour-search.md.
| Need | Call | Arguments (exact names) |
|---|---|---|
| Code by behaviour / intent | search_code (graph) | query, search_type="semantic", detail_level="L1", top_k=3, optional filter_type |
| Code by identifier / literal | search_code (graph) | query, search_type="fulltext"; miss → codesearch(query, limit=5) |
| Hybrid fallback | codesearch (code) | query, limit=5 — result count is limit, never top_k |
| Routine by name | search_function (code) | name, exact=true, limit=10, optional module_path |
| Full routine body | search_code | detail_level="L0" for one routine; or compact_symbol(name, include_body=true) |
| Module layout before editing | get_module_structure (code) | module_path |
| Members of a context | bsl_scope_members (code) | context (Справочник.Номенклатура, Глобальный), member_type="all" | "methods" | "properties" | "events" |
Text searches above use query; routine lookup uses name. Do not invent q, text, prompt or search_query.
Calls
json{"tool": "search_code", "args": {"project_id": "<resolved-project-id>", "query": "расчёт остатков по складу на дату", "search_type": "semantic", "detail_level": "L1", "top_k": 5}} {"tool": "search_function", "args": {"name": "ОбработкаПроведения", "exact": true, "limit": 10}} {"tool": "codesearch", "args": {"query": "ТекущаяДатаСеанса()", "limit": 5}} {"tool": "get_module_structure", "args": {"module_path": "Documents/РеализацияТоваровУслуг/Ext/ObjectModule.bsl"}}
Miss handling
- Reformulate once when useful, using only that tool's modes and parameters (
search_type,detail_level,top_k/limit,filter_type,module_path). - Current Code search tools have no
grepinput. Readsearch_layer: "grep"as the server's internal file-scan fallback, not a request to resend the call. If an indexed search misses a literal, continue to scoped native search after the bounded attempt. - A typed server answer maps to an action by code —
content/rules/mcp-policy.md → C. Server answers → actions; never probe the same gap through sibling tools. - Then native
Grep/Read, with the note. Reading a file already located here is normal work.
Rare modes, response shapes, compact API paging: content/skills/mcp-1c-tools/docs/1c-code-metadata-mcp.md, content/skills/mcp-1c-tools/docs/1c-graph-metadata-mcp.md.
