{
  "spec": "my-pi.ai-docs/v1",
  "package": "@ineersa/my-pi-jetbrains-index",
  "version": "0.3.0",
  "updatedAt": "2026-05-10",
  "entities": [
    {
      "id": "jetbrains-index",
      "kind": "extension",
      "name": "jetbrains-index",
      "entry": "./extensions/jetbrains-index/jetbrains-index.ts",
      "docs": {
        "settings": "docs/extensions/jetbrains-index/settings.md",
        "usage": "docs/extensions/jetbrains-index/usage.md",
        "maintenance": "docs/extensions/jetbrains-index/maintenance.md"
      },
      "activation": {
        "requiresIdeaDirectory": true,
        "requiresJetBrainsMcpServer": true,
        "mcpServerName": "jetbrains-index",
        "configSource": "Pi settings.json (jetbrainsIndex key) with mcp.json fallback"
      },
      "behaviors": [
        "Injects IDE tool prompt guidelines into system prompt Guidelines section (prefer IDE tools over bash/rg/find, tool-specific usage guidance, CWD restriction)",
        "Loads JetBrains connection config from Pi settings.json (jetbrainsIndex key) with fallback to mcp.json",
        "Blocks any tool call when IDE/index becomes unavailable and aborts the agent run",
        "Syncs entire project at turn start and reports only newly introduced diagnostics",
        "Nudges toward IDE move refactoring and syncs the whole project after mv/git mv inside CWD",
        "Exposes internal JetBrainsService layer (transport, catalog, indexing lifecycle) and standalone response-formatting module for TOON/payload/error helpers",
        "Provides target-resolution module (target-resolver.ts) that resolves symbol or location targets to canonical file/line/column for semantic tool wrappers",
        "Registers first-class Pi wrapper tools (13 tools) on session start when IDE is available: ide_find_file, ide_search_text, ide_find_symbol, ide_find_references, ide_rename_symbol, ide_rename_file, ide_find_implementations, ide_find_super_methods, ide_type_hierarchy, ide_call_hierarchy, ide_diagnostics, ide_move_file, ide_file_structure",
        "Mutation tools (ide_rename_symbol, ide_rename_file, ide_move_file) perform one whole-project sync after successful IDE mutation and do not run diagnostics"
      ]
    }
  ]
}
