@documentation-robotics/cli 0.1.0 → 0.1.5

package/dist/schemas/bundled/analyzers/cbm.json

@@ -0,0 +1,595 @@
+{
+  "name": "cbm",
+  "version": "0.8.4",
+  "source_version": "0.8.4",
+  "analyzer": {
+    "name": "cbm",
+    "display_name": "codebase-memory-mcp",
+    "description": "Tree-sitter-based code knowledge graph server by DeusData",
+    "homepage": "https://github.com/DeusData/codebase-memory-mcp",
+    "mcp_server_name": "codebase-memory-mcp",
+    "binary_names": ["codebase-memory-mcp"],
+    "supported_tool_contract": {
+      "required_tools": [
+        "search_graph",
+        "index_repository",
+        "list_projects",
+        "trace_path"
+      ],
+      "optional_tools": [
+        "query_graph",
+        "detect_changes",
+        "index_status",
+        "get_graph_schema",
+        "search_code"
+      ]
+    },
+    "supported_languages": [
+      "typescript",
+      "javascript",
+      "python",
+      "java",
+      "go",
+      "rust",
+      "c#",
+      "php",
+      "tsx",
+      "c++",
+      "lua",
+      "scala"
+    ],
+    "known_minimum_version": null,
+    "project_identification": {
+      "strategy": "absolute_path",
+      "description": "DR CLI passes the project root as an absolute path via findProjectRoot(). The analyzer uses this path to establish a stable project identity for consistent indexing and caching across sessions."
+    },
+    "notes": "Uses absolute path indexing for project identification. Ensures consistent graph generation and caching across multiple analysis runs within the same project."
+  },
+  "nodes_by_label": {
+    "Route": {
+      "cbm_label": "Route",
+      "dr_layer": "api",
+      "dr_element_type": "operation",
+      "confidence": "high",
+      "description": "HTTP route maps to API operation with high confidence",
+      "source_reference": {
+        "provenance": "extracted",
+        "file": {
+          "from": "file_path"
+        },
+        "symbol": {
+          "from": "name"
+        }
+      },
+      "dr_element_fields": {
+        "operationId": {
+          "name_template": "{name}",
+          "id_source": "name",
+          "id_transform": "kebab_case"
+        },
+        "summary": {
+          "template": "{properties.method} {properties.path}"
+        },
+        "tags": {
+          "name_template": "tags"
+        }
+      },
+      "verify_role": "primary"
+    },
+    "Function": {
+      "cbm_label": "Function",
+      "dr_layer": "application",
+      "dr_element_type": "applicationfunction",
+      "confidence": "medium",
+      "description": "Function maps to application function; may be promoted to service via heuristics",
+      "source_reference": {
+        "provenance": "extracted",
+        "file": {
+          "from": "file_path"
+        },
+        "symbol": {
+          "from": "name"
+        }
+      },
+      "attribute_mappings": [
+        {
+          "from": "name",
+          "dr_attribute": "name"
+        }
+      ],
+      "dr_element_type_promoted": "applicationservice",
+      "promotion_heuristics": [
+        "is_entry_point",
+        "handles_route",
+        "naming_patterns"
+      ],
+      "evidence_fields": {
+        "fan_in": {
+          "from": "fan_in"
+        },
+        "fan_out": {
+          "from": "fan_out"
+        },
+        "is_exported": {
+          "from": "is_exported"
+        },
+        "argument_types": {
+          "from": "argument_types"
+        },
+        "return_type": {
+          "from": "return_type"
+        }
+      },
+      "conditions": {
+        "serviceType": {
+          "default": "synchronous"
+        }
+      }
+    },
+    "Method": {
+      "cbm_label": "Method",
+      "dr_layer": "application",
+      "dr_element_type": "applicationfunction",
+      "confidence": "medium",
+      "description": "Class method maps to application function; may be promoted to service via heuristics",
+      "source_reference": {
+        "provenance": "extracted",
+        "file": {
+          "from": "file_path"
+        },
+        "symbol": {
+          "from": "name"
+        }
+      },
+      "attribute_mappings": [
+        {
+          "from": "name",
+          "dr_attribute": "name"
+        }
+      ],
+      "dr_element_type_promoted": "applicationservice",
+      "promotion_heuristics": [
+        "is_entry_point",
+        "naming_patterns",
+        "directory_match"
+      ],
+      "evidence_fields": {
+        "visibility": {
+          "from": "visibility"
+        },
+        "is_static": {
+          "from": "is_static"
+        },
+        "is_abstract": {
+          "from": "is_abstract"
+        },
+        "parent_class": {
+          "from": "parent_class"
+        },
+        "overrides": {
+          "from": "overrides"
+        }
+      },
+      "conditions": {
+        "serviceType": {
+          "default": "synchronous"
+        }
+      }
+    },
+    "Class": {
+      "cbm_label": "Class",
+      "dr_layer": "application",
+      "dr_element_type": "applicationcomponent",
+      "confidence": "medium",
+      "description": "Class maps to application component",
+      "source_reference": {
+        "provenance": "extracted",
+        "file": {
+          "from": "file_path"
+        },
+        "symbol": {
+          "from": "name"
+        }
+      },
+      "evidence_fields": {
+        "abstract": {
+          "from": "abstract"
+        },
+        "interfaces": {
+          "from": "interfaces"
+        },
+        "parent_class": {
+          "from": "parent_class"
+        },
+        "methods_count": {
+          "from": "methods_count"
+        },
+        "properties_count": {
+          "from": "properties_count"
+        }
+      }
+    },
+    "Module": {
+      "cbm_label": "Module",
+      "dr_layer": "application",
+      "dr_element_type": "applicationcomponent",
+      "confidence": "low",
+      "description": "Module (file/namespace) maps to application component with low confidence",
+      "source_reference": {
+        "provenance": "extracted",
+        "file": {
+          "from": "file_path"
+        },
+        "symbol": {
+          "from": "name"
+        }
+      }
+    }
+  },
+  "edges_by_type": {
+    "HTTP_CALLS": {
+      "cbm_edge": "HTTP_CALLS",
+      "dr_relationship": "consumes",
+      "confidence": "high",
+      "description": "HTTP API call between services maps to consumes relationship",
+      "usage": "verification_and_mapping",
+      "dr_scope": "cross-layer",
+      "direction": "caller_to_callee",
+      "confidence_from_property": "confidence",
+      "dr_pattern": "application.applicationservice → api.operation",
+      "implementation_note": "Requires HTTP verb and endpoint analysis to create cross-layer reference"
+    },
+    "HANDLES": {
+      "cbm_edge": "HANDLES",
+      "dr_relationship": "provides",
+      "confidence": "high",
+      "description": "HTTP request handler maps to provides relationship",
+      "usage": "verification_and_mapping",
+      "dr_scope": "cross-layer",
+      "direction": "forward",
+      "confidence_from_property": "handler_decorator",
+      "dr_pattern": "application.applicationfunction → api.operation",
+      "implementation_note": "HTTP handler decoration indicates implementation relationship"
+    },
+    "CALLS": {
+      "cbm_edge": "CALLS",
+      "dr_relationship": null,
+      "confidence": "medium",
+      "description": "Function/method call within codebase",
+      "usage": "traversal_only",
+      "dr_scope": "intra-layer",
+      "direction": "forward",
+      "conditions": {
+        "usage_detail": "intra-layer behavioral"
+      }
+    },
+    "IMPORTS": {
+      "cbm_edge": "IMPORTS",
+      "dr_relationship": null,
+      "confidence": "high",
+      "description": "Module/file import dependency",
+      "usage": "traversal_only",
+      "dr_scope": "intra-layer",
+      "direction": "forward",
+      "conditions": {
+        "usage_detail": "intra-layer structural"
+      }
+    },
+    "DEPENDS_ON": {
+      "cbm_edge": "DEPENDS_ON",
+      "dr_relationship": null,
+      "confidence": "medium",
+      "description": "Runtime dependency relationship",
+      "usage": "traversal_only",
+      "dr_scope": "intra-layer",
+      "direction": "forward",
+      "conditions": {
+        "usage_detail": "intra-layer dependency"
+      }
+    },
+    "INHERITS": {
+      "cbm_edge": "INHERITS",
+      "dr_relationship": null,
+      "confidence": "high",
+      "description": "Class inheritance relationship",
+      "usage": "traversal_only",
+      "dr_scope": "intra-layer",
+      "direction": "forward",
+      "conditions": {
+        "usage_detail": "intra-layer structural"
+      }
+    },
+    "IMPLEMENTS": {
+      "cbm_edge": "IMPLEMENTS",
+      "dr_relationship": null,
+      "confidence": "high",
+      "description": "Interface implementation relationship",
+      "usage": "traversal_only",
+      "dr_scope": "intra-layer",
+      "direction": "forward",
+      "conditions": {
+        "usage_detail": "intra-layer structural"
+      }
+    },
+    "CREATES": {
+      "cbm_edge": "CREATES",
+      "dr_relationship": null,
+      "confidence": "medium",
+      "description": "Object instantiation or component creation",
+      "usage": "traversal_only",
+      "dr_scope": "intra-layer",
+      "direction": "forward",
+      "conditions": {
+        "usage_detail": "intra-layer behavioral"
+      }
+    },
+    "USES": {
+      "cbm_edge": "USES",
+      "dr_relationship": null,
+      "confidence": "medium",
+      "description": "General usage relationship",
+      "usage": "traversal_only",
+      "dr_scope": "intra-layer",
+      "direction": "forward",
+      "conditions": {
+        "usage_detail": "intra-layer dependency"
+      }
+    },
+    "EXTENDS": {
+      "cbm_edge": "EXTENDS",
+      "dr_relationship": null,
+      "confidence": "high",
+      "description": "Class or interface extension",
+      "usage": "traversal_only",
+      "dr_scope": "intra-layer",
+      "direction": "forward",
+      "conditions": {
+        "usage_detail": "intra-layer structural"
+      }
+    },
+    "REFERENCES": {
+      "cbm_edge": "REFERENCES",
+      "dr_relationship": null,
+      "confidence": "medium",
+      "description": "Reference to variable, field, or constant",
+      "usage": "traversal_only",
+      "dr_scope": "intra-layer",
+      "direction": "forward",
+      "conditions": {
+        "usage_detail": "intra-layer dependency"
+      }
+    },
+    "RETURNS": {
+      "cbm_edge": "RETURNS",
+      "dr_relationship": null,
+      "confidence": "low",
+      "description": "Return type relationship (type information only)",
+      "usage": "traversal_only",
+      "dr_scope": "intra-layer",
+      "direction": "forward",
+      "conditions": {
+        "usage_detail": "type-level metadata"
+      }
+    },
+    "MODIFIES": {
+      "cbm_edge": "MODIFIES",
+      "dr_relationship": null,
+      "confidence": "medium",
+      "description": "State modification relationship",
+      "usage": "traversal_only",
+      "dr_scope": "intra-layer",
+      "direction": "forward",
+      "conditions": {
+        "usage_detail": "intra-layer behavioral"
+      }
+    }
+  },
+  "heuristics": {
+    "confidence_rubric": {
+      "high": {
+        "min": 0.8,
+        "max": 1,
+        "description": "High confidence: mapping is reliable and well-supported by evidence"
+      },
+      "medium": {
+        "min": 0.5,
+        "max": 0.79,
+        "description": "Medium confidence: mapping is reasonably supported but may have ambiguity"
+      },
+      "low": {
+        "min": 0,
+        "max": 0.49,
+        "description": "Low confidence: mapping is tentative and may require manual verification"
+      }
+    },
+    "heuristics": [
+      {
+        "name": "min_fan_in",
+        "description": "Function/method with high fan-in (many callers) may be a service",
+        "applies_to": ["application.applicationfunction"],
+        "parameters": {
+          "threshold": 5,
+          "source_types": ["function", "method"]
+        },
+        "rule": "If a function/method is called by 5+ other functions/methods, it exhibits service-like behavior and is eligible for promotion to applicationservice",
+        "confidence_adjustment": 0.15
+      },
+      {
+        "name": "directory_match",
+        "description": "Element location in canonical service directories indicates service-level component",
+        "applies_to": [
+          "application.applicationfunction",
+          "application.applicationcomponent"
+        ],
+        "parameters": {
+          "patterns": [
+            "**/services/**",
+            "**/service/**",
+            "**/service.ts",
+            "**/service.js",
+            "**/service.py"
+          ]
+        },
+        "rule": "If element resides in directory matching service-level patterns, promote eligible functions to applicationservice",
+        "confidence_adjustment": 0.2
+      },
+      {
+        "name": "naming_patterns",
+        "description": "Naming conventions indicate service-level components",
+        "applies_to": [
+          "application.applicationfunction",
+          "application.applicationcomponent"
+        ],
+        "parameters": {
+          "service_suffixes": [
+            "Service",
+            "Manager",
+            "Repository",
+            "Factory",
+            "Handler"
+          ]
+        },
+        "rule": "If function/class name ends with service-indicating suffix (Service, Manager, Repository, etc.), promote eligible functions to applicationservice",
+        "confidence_adjustment": 0.25
+      },
+      {
+        "name": "class_is_service",
+        "description": "Class structure and interface patterns indicate service behavior",
+        "applies_to": ["application.applicationcomponent"],
+        "parameters": {
+          "indicators": [
+            "implements_interface",
+            "dependency_injection",
+            "public_methods_count"
+          ]
+        },
+        "rule": "If class implements interfaces, uses dependency injection, or has 3+ public methods, it may represent a service abstraction",
+        "conditions": {
+          "public_methods_threshold": 3
+        }
+      },
+      {
+        "name": "service_class_naming",
+        "description": "Class names following service patterns within classes indicate service methods",
+        "applies_to": ["application.applicationfunction"],
+        "parameters": {
+          "service_method_prefixes": [
+            "create",
+            "fetch",
+            "get",
+            "update",
+            "delete",
+            "list",
+            "search",
+            "process",
+            "handle",
+            "execute"
+          ]
+        },
+        "rule": "If method within service-named class uses CRUD or action-oriented prefix, it exhibits service operation behavior",
+        "confidence_adjustment": 0.2
+      },
+      {
+        "name": "is_entry_point",
+        "description": "Functions that serve as entry points (main, handler, endpoint) indicate service potential",
+        "applies_to": ["application.applicationfunction"],
+        "parameters": {
+          "entry_point_patterns": [
+            "main",
+            "handler",
+            "endpoint",
+            "route",
+            "controller",
+            "listener"
+          ]
+        },
+        "rule": "If function name or type suggests it serves as entry point (handler, endpoint, listener), it may represent service operation",
+        "confidence_adjustment": 0.15
+      },
+      {
+        "name": "handles_route",
+        "description": "Functions that handle HTTP routes map directly to API operations",
+        "applies_to": ["api.operation"],
+        "rule": "Function/method decorated with @Route, @Handler, or similar HTTP decorator maps to api.operation with high confidence",
+        "confidence_adjustment": 0.3
+      },
+      {
+        "name": "datastore_detection",
+        "description": "Patterns and conventions that identify datastore-related elements (tables, schemas, migrations)",
+        "applies_to": [
+          "data-store.table",
+          "data-store.column",
+          "data-model.entity",
+          "data-model.attribute"
+        ],
+        "parameters": {
+          "patterns": [
+            "**/migrations/**",
+            "**/schema/**",
+            "**/*.sql",
+            "**/*.migration.*",
+            "**/*schema.ts",
+            "**/*model.ts"
+          ],
+          "naming_indicators": [
+            "table",
+            "column",
+            "schema",
+            "migration",
+            "entity",
+            "dto",
+            "model"
+          ]
+        },
+        "rule": "If element resides in datastore-related directories or files, or follows datastore naming conventions, identify as data-store or data-model layer element",
+        "confidence_adjustment": 0.25
+      }
+    ],
+    "inference_rules": [
+      {
+        "name": "function-promotion-to-service",
+        "description": "Qualified functions can be promoted to services via heuristic signals",
+        "pattern": "applicationfunction + (min_fan_in >= 5 OR directory_match OR naming_patterns OR is_entry_point) => applicationservice",
+        "confidence": "medium",
+        "enabled": true
+      },
+      {
+        "name": "verify_scope_v1",
+        "description": "Scope boundary rule: verify_role=primary applies only to api.operation (Route elements) in v1",
+        "pattern": "verify_role: primary => api.operation only (excludes Function, Method, Class, Module)",
+        "confidence": "high",
+        "enabled": true
+      }
+    ],
+    "filtering_rules": [
+      {
+        "name": "confidence_floor",
+        "description": "Filter mappings below confidence threshold to reduce noise",
+        "filter_type": "confidence",
+        "threshold": 0.35,
+        "enabled": true
+      },
+      {
+        "name": "test_code_exclusion",
+        "description": "Exclude test files and test-related code from mapping",
+        "filter_type": "pattern",
+        "pattern": "^.*(\\.test\\.|_test\\.|spec\\.|__tests__)",
+        "enabled": true
+      }
+    ],
+    "deduplication_rules": [
+      {
+        "name": "semantic-duplicate-detection",
+        "description": "Detect and merge semantically equivalent mappings",
+        "match_strategy": "semantic",
+        "resolution_strategy": "keep_highest_confidence",
+        "enabled": true
+      }
+    ],
+    "metadata": {
+      "version": "1.0",
+      "created_at": "2026-04-17T00:00:00Z",
+      "updated_at": "2026-04-17T00:00:00Z"
+    }
+  }
+}

package/dist/schemas/bundled/analyzers/manifest.json

@@ -0,0 +1,9 @@
+{
+  "specVersion": "0.8.4",
+  "analyzers": [
+    {
+      "name": "cbm",
+      "version": "0.8.4"
+    }
+  ]
+}