code-atlas-forge 1.1.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (181) hide show
  1. code_atlas/__init__.py +6 -0
  2. code_atlas/__main__.py +6 -0
  3. code_atlas/api/__init__.py +5 -0
  4. code_atlas/api/handlers.py +1514 -0
  5. code_atlas/api/server.py +394 -0
  6. code_atlas/cli.py +2084 -0
  7. code_atlas/config.py +149 -0
  8. code_atlas/context/__init__.py +66 -0
  9. code_atlas/context/contracts.py +277 -0
  10. code_atlas/context/domain.py +760 -0
  11. code_atlas/context/engine.py +442 -0
  12. code_atlas/context/expand.py +133 -0
  13. code_atlas/context/renderers.py +71 -0
  14. code_atlas/context/tokenizer.py +37 -0
  15. code_atlas/contracts/__init__.py +38 -0
  16. code_atlas/contracts/enums.py +67 -0
  17. code_atlas/contracts/models.py +175 -0
  18. code_atlas/contracts/ports.py +70 -0
  19. code_atlas/discovery/__init__.py +25 -0
  20. code_atlas/discovery/gitignore.py +119 -0
  21. code_atlas/discovery/identity.py +52 -0
  22. code_atlas/discovery/models.py +204 -0
  23. code_atlas/discovery/scanner.py +495 -0
  24. code_atlas/domains/__init__.py +107 -0
  25. code_atlas/domains/api/__init__.py +28 -0
  26. code_atlas/domains/api/adapter.py +405 -0
  27. code_atlas/domains/api/common.py +308 -0
  28. code_atlas/domains/api/consumers.py +224 -0
  29. code_atlas/domains/api/emit.py +231 -0
  30. code_atlas/domains/api/openapi.py +398 -0
  31. code_atlas/domains/api/routes.py +582 -0
  32. code_atlas/domains/api/yaml_subset.py +683 -0
  33. code_atlas/domains/aws/__init__.py +28 -0
  34. code_atlas/domains/aws/adapter.py +382 -0
  35. code_atlas/domains/aws/common.py +261 -0
  36. code_atlas/domains/aws/configs.py +1164 -0
  37. code_atlas/domains/aws/emit.py +411 -0
  38. code_atlas/domains/aws/pyfiles.py +2220 -0
  39. code_atlas/domains/aws/sqlbridge.py +448 -0
  40. code_atlas/domains/cicd/__init__.py +50 -0
  41. code_atlas/domains/cicd/adapter.py +762 -0
  42. code_atlas/domains/cicd/classify.py +136 -0
  43. code_atlas/domains/cicd/workflow.py +504 -0
  44. code_atlas/domains/cicd/yamlmini.py +946 -0
  45. code_atlas/domains/cli_surface.py +739 -0
  46. code_atlas/domains/contracts.py +274 -0
  47. code_atlas/domains/crossresolve.py +1208 -0
  48. code_atlas/domains/evidence.py +57 -0
  49. code_atlas/domains/identity.py +149 -0
  50. code_atlas/domains/model.py +202 -0
  51. code_atlas/domains/registry.py +250 -0
  52. code_atlas/domains/resolution.py +65 -0
  53. code_atlas/domains/spark/__init__.py +31 -0
  54. code_atlas/domains/spark/adapter.py +146 -0
  55. code_atlas/domains/spark/emit.py +344 -0
  56. code_atlas/domains/spark/extract.py +108 -0
  57. code_atlas/domains/spark/sqllit.py +192 -0
  58. code_atlas/domains/spark/walk.py +1943 -0
  59. code_atlas/domains/sql/__init__.py +30 -0
  60. code_atlas/domains/sql/adapter.py +382 -0
  61. code_atlas/domains/sql/extract.py +1271 -0
  62. code_atlas/domains/sql/nodes.py +264 -0
  63. code_atlas/domains/sql/parser.py +1510 -0
  64. code_atlas/domains/sql/tokens.py +318 -0
  65. code_atlas/domains/summarize.py +126 -0
  66. code_atlas/domains/terraform/__init__.py +20 -0
  67. code_atlas/domains/terraform/adapter.py +127 -0
  68. code_atlas/domains/terraform/catalog.py +43 -0
  69. code_atlas/domains/terraform/extract.py +1277 -0
  70. code_atlas/domains/terraform/hcl.py +538 -0
  71. code_atlas/domains/terraform/refs.py +181 -0
  72. code_atlas/domains/terraform/tfjson.py +163 -0
  73. code_atlas/domains/terraform/tfvars.py +98 -0
  74. code_atlas/domains/validation.py +120 -0
  75. code_atlas/env_override.py +27 -0
  76. code_atlas/eval/__init__.py +26 -0
  77. code_atlas/eval/domain_eval.py +681 -0
  78. code_atlas/eval/ground_truth.py +688 -0
  79. code_atlas/eval/impact_truth.py +758 -0
  80. code_atlas/eval/metrics.py +178 -0
  81. code_atlas/eval/pack_value.py +610 -0
  82. code_atlas/federation/__init__.py +72 -0
  83. code_atlas/federation/federation.py +676 -0
  84. code_atlas/federation/model.py +355 -0
  85. code_atlas/federation/store.py +194 -0
  86. code_atlas/gitbin.py +48 -0
  87. code_atlas/graph/__init__.py +20 -0
  88. code_atlas/graph/builder.py +378 -0
  89. code_atlas/graph/identity.py +54 -0
  90. code_atlas/graph/queries.py +47 -0
  91. code_atlas/graph/validation.py +92 -0
  92. code_atlas/impact/__init__.py +37 -0
  93. code_atlas/impact/blast_radius.py +171 -0
  94. code_atlas/impact/contract_analyzer.py +104 -0
  95. code_atlas/impact/contracts.py +315 -0
  96. code_atlas/impact/diff_reader.py +142 -0
  97. code_atlas/impact/domain_traversal.py +768 -0
  98. code_atlas/impact/engine.py +392 -0
  99. code_atlas/impact/packs.py +128 -0
  100. code_atlas/impact/report.py +136 -0
  101. code_atlas/impact/revision_binding.py +220 -0
  102. code_atlas/impact/risk_classifier.py +83 -0
  103. code_atlas/impact/snapshot_resolver.py +136 -0
  104. code_atlas/impact/symbol_diff.py +210 -0
  105. code_atlas/impact/test_selector.py +166 -0
  106. code_atlas/indexing/__init__.py +5 -0
  107. code_atlas/indexing/cache.py +396 -0
  108. code_atlas/indexing/change_detector.py +278 -0
  109. code_atlas/indexing/coordinator.py +1032 -0
  110. code_atlas/indexing/dependency_planner.py +268 -0
  111. code_atlas/indexing/persist.py +436 -0
  112. code_atlas/indexing/reuse.py +85 -0
  113. code_atlas/install/__init__.py +7 -0
  114. code_atlas/install/cli.py +168 -0
  115. code_atlas/install/lifecycle.py +286 -0
  116. code_atlas/mcp.py +674 -0
  117. code_atlas/observability/__init__.py +19 -0
  118. code_atlas/observability/logging.py +199 -0
  119. code_atlas/parsers/__init__.py +43 -0
  120. code_atlas/parsers/contracts.py +209 -0
  121. code_atlas/parsers/engine.py +125 -0
  122. code_atlas/parsers/languages/__init__.py +1 -0
  123. code_atlas/parsers/languages/python.py +391 -0
  124. code_atlas/parsers/languages/tsx.py +28 -0
  125. code_atlas/parsers/languages/typescript.py +909 -0
  126. code_atlas/parsers/registry.py +51 -0
  127. code_atlas/parsers/tree_sitter_runtime.py +118 -0
  128. code_atlas/resolvers/__init__.py +33 -0
  129. code_atlas/resolvers/bootstrap.py +246 -0
  130. code_atlas/resolvers/capabilities.py +33 -0
  131. code_atlas/resolvers/contracts.py +133 -0
  132. code_atlas/resolvers/coordinator.py +96 -0
  133. code_atlas/resolvers/enrichment.py +318 -0
  134. code_atlas/resolvers/lsp/__init__.py +26 -0
  135. code_atlas/resolvers/lsp/adapter.py +256 -0
  136. code_atlas/resolvers/lsp/lifecycle.py +251 -0
  137. code_atlas/resolvers/lsp/spawn.py +92 -0
  138. code_atlas/resolvers/lsp/transport.py +240 -0
  139. code_atlas/resolvers/registry.py +33 -0
  140. code_atlas/resolvers/scip/__init__.py +49 -0
  141. code_atlas/resolvers/scip/decoder.py +216 -0
  142. code_atlas/resolvers/scip/importer.py +248 -0
  143. code_atlas/resolvers/scip/loader.py +90 -0
  144. code_atlas/resolvers/scip/mapper.py +271 -0
  145. code_atlas/resolvers/scip/provenance.py +211 -0
  146. code_atlas/resolvers/scip/resolver.py +289 -0
  147. code_atlas/resolvers/scip/validation.py +101 -0
  148. code_atlas/resolvers/syntactic/__init__.py +8 -0
  149. code_atlas/resolvers/syntactic/resolver.py +254 -0
  150. code_atlas/search/__init__.py +32 -0
  151. code_atlas/search/contracts.py +176 -0
  152. code_atlas/search/domain.py +561 -0
  153. code_atlas/search/engine.py +530 -0
  154. code_atlas/search/federated.py +276 -0
  155. code_atlas/search/graph.py +282 -0
  156. code_atlas/search/hybrid.py +151 -0
  157. code_atlas/search/intent.py +48 -0
  158. code_atlas/search/lexical.py +176 -0
  159. code_atlas/search/refs.py +359 -0
  160. code_atlas/search/structural.py +505 -0
  161. code_atlas/search/tokenizer.py +43 -0
  162. code_atlas/search/vector/__init__.py +35 -0
  163. code_atlas/search/vector/contracts.py +76 -0
  164. code_atlas/search/vector/embeddings.py +96 -0
  165. code_atlas/search/vector/index.py +169 -0
  166. code_atlas/search/vector/provider.py +50 -0
  167. code_atlas/storage/__init__.py +14 -0
  168. code_atlas/storage/db.py +47 -0
  169. code_atlas/storage/migrations.py +552 -0
  170. code_atlas/storage/store.py +1045 -0
  171. code_atlas/ui/__init__.py +29 -0
  172. code_atlas/ui/i18n.py +143 -0
  173. code_atlas/ui/kit.py +689 -0
  174. code_atlas/ui/wizard.py +317 -0
  175. code_atlas_forge-1.1.0.dist-info/METADATA +246 -0
  176. code_atlas_forge-1.1.0.dist-info/RECORD +181 -0
  177. code_atlas_forge-1.1.0.dist-info/WHEEL +5 -0
  178. code_atlas_forge-1.1.0.dist-info/entry_points.txt +2 -0
  179. code_atlas_forge-1.1.0.dist-info/licenses/LICENSE +202 -0
  180. code_atlas_forge-1.1.0.dist-info/licenses/NOTICE +17 -0
  181. code_atlas_forge-1.1.0.dist-info/top_level.txt +1 -0
@@ -0,0 +1,176 @@
1
+ """Contratos versionados do subsistema de busca (lf-0036 / Cycle 4 Ph1).
2
+
3
+ Toda busca responde ``SearchResult`` vinculada a repository + snapshot +
4
+ query + strategy + ranking_version + evidence + limit + cursor +
5
+ diagnostics. ``to_dict`` é o único serializer (envelope JSON v2).
6
+ """
7
+
8
+ from __future__ import annotations
9
+
10
+ import base64
11
+ import dataclasses
12
+ import hashlib
13
+ import json
14
+ from dataclasses import dataclass
15
+
16
+ SEARCH_SCHEMA_VERSION = 1
17
+ RANKING_VERSION = "bm25-fts5-v1"
18
+
19
+ STRATEGIES = frozenset({"lexical", "structural", "graph", "hybrid", "vector"})
20
+
21
+
22
+ @dataclass(frozen=True)
23
+ class SearchRequest:
24
+ """Pedido de busca — snapshot resolvido para o READY atual.
25
+
26
+ ``domain`` (lf-0119): filtro exato da faceta de entidades de
27
+ domínio (``de.domain = ?``) — não toca hits de símbolo, que não
28
+ têm domínio.
29
+ """
30
+
31
+ query: str
32
+ strategy: str = "lexical"
33
+ repository_root: str = ""
34
+ snapshot_id: int | None = None
35
+ limit: int = 20
36
+ cursor: str | None = None
37
+ language: str | None = None
38
+ kind: str | None = None
39
+ path: str | None = None # substring em relative_path
40
+ domain: str | None = None # filtro da faceta domain_entities
41
+
42
+
43
+ @dataclass(frozen=True)
44
+ class SearchHit:
45
+ """Um resultado: ocorrência + score + explicação.
46
+
47
+ ``repository_id``/``snapshot_id`` (lf-0119): escopo que produziu o
48
+ hit — preenchido sempre que o engine conhece o escopo (busca
49
+ federada depende dele para nunca colapsar homônimos cross-repo).
50
+ ``item_type`` discrimina o tipo do item ("symbol" aqui; a faceta
51
+ de domínio usa ``DomainSearchHit`` com "domain_entity").
52
+ """
53
+
54
+ occurrence_id: int
55
+ qualified_name: str
56
+ kind: str
57
+ language: str
58
+ path: str
59
+ span: dict[str, int] | None
60
+ score: float
61
+ strategy: str
62
+ matched_fields: tuple[str, ...] = ()
63
+ evidence: tuple[str, ...] = ()
64
+ repository_id: int | None = None
65
+ snapshot_id: int | None = None
66
+ item_type: str = "symbol"
67
+
68
+
69
+ @dataclass(frozen=True)
70
+ class DomainSearchHit:
71
+ """Hit da faceta de domínio — entidade lógica observada no snapshot.
72
+
73
+ Nunca se funde com ``SearchHit`` de símbolos: sai em
74
+ ``SearchResult.domain_items`` como faceta separada. ``occurrences``
75
+ é a contagem de evidência (ocorrências da entidade no snapshot);
76
+ ``occurrence_id`` aponta para a primeira ocorrência (row âncora,
77
+ determinística). ``matched_fields`` declara COMO casou:
78
+ ``name``/``qualified_name``/``path`` (match direto por substring),
79
+ ``terms`` (match por token no índice ``domain_fts`` que substring
80
+ não reproduz — fragmento de identificador ou forma normalizada) ou
81
+ ``via_relation`` (endpoint entity↔entity resolvido de
82
+ ``domain_relations`` adjacente a um match direto — a aresta real é
83
+ citada em ``evidence`` como ``via=TYPE:rel:<id>``).
84
+ """
85
+
86
+ entity_id: int
87
+ occurrence_id: int
88
+ domain: str
89
+ kind: str
90
+ qualified_name: str
91
+ name: str
92
+ identity_key: str
93
+ catalog: str
94
+ namespace: str
95
+ environment: str
96
+ path: str
97
+ line: int | None
98
+ occurrences: int
99
+ extraction_status: str
100
+ repository_id: int | None
101
+ snapshot_id: int
102
+ score: float
103
+ item_type: str = "domain_entity"
104
+ matched_fields: tuple[str, ...] = ()
105
+ evidence: tuple[str, ...] = ()
106
+
107
+
108
+ @dataclass(frozen=True)
109
+ class SearchDiagnostic:
110
+ """Diagnóstico tipado de busca (cursor inválido, filtro, etc.)."""
111
+
112
+ code: str
113
+ severity: str
114
+ message: str
115
+
116
+
117
+ @dataclass(frozen=True)
118
+ class SearchResult:
119
+ """Envelope versionado da resposta de busca."""
120
+
121
+ schema_version: int
122
+ repository: str
123
+ snapshot_id: int
124
+ query: str
125
+ strategy: str
126
+ ranking_version: str
127
+ items: tuple[SearchHit, ...]
128
+ limit: int
129
+ truncated: bool
130
+ next_cursor: str | None = None
131
+ diagnostics: tuple[SearchDiagnostic, ...] = ()
132
+ # lf-0119: faceta de domínio — separada de ``items`` por desenho
133
+ # (nunca fundida com símbolos). ``domain_total`` conta matches
134
+ # diretos + adjacentes via_relation encontrados; é top-``limit``
135
+ # deterministicamente ordenada, sem cursor próprio.
136
+ domain_items: tuple[DomainSearchHit, ...] = ()
137
+ domain_total: int = 0
138
+
139
+ def to_dict(self) -> dict[str, object]:
140
+ return dataclasses.asdict(self)
141
+
142
+
143
+ @dataclass(frozen=True)
144
+ class SearchCapability:
145
+ """O que o backend de busca oferece nesta build."""
146
+
147
+ strategies: tuple[str, ...]
148
+ fts5: bool
149
+ vector: bool = False
150
+ detail: str = ""
151
+
152
+
153
+ def encode_cursor(offset: int, fingerprint: str) -> str:
154
+ """Cursor opaco: offset + fingerprint da query (base64)."""
155
+ raw = json.dumps({"o": offset, "f": fingerprint}).encode("utf-8")
156
+ return base64.urlsafe_b64encode(raw).decode("ascii")
157
+
158
+
159
+ def decode_cursor(
160
+ cursor: str, fingerprint: str
161
+ ) -> int | None:
162
+ """Offset do cursor se o fingerprint bate; None = inválido."""
163
+ try:
164
+ data = json.loads(
165
+ base64.urlsafe_b64decode(cursor.encode("ascii")))
166
+ except (ValueError, json.JSONDecodeError):
167
+ return None
168
+ if data.get("f") != fingerprint or not isinstance(data.get("o"), int):
169
+ return None
170
+ return max(0, int(data["o"]))
171
+
172
+
173
+ def query_fingerprint(query: str, filters: dict[str, str | None]) -> str:
174
+ """Hash estável de query+filtros — impede reusar cursor de outra busca."""
175
+ raw = json.dumps([query, sorted(filters.items())], sort_keys=True)
176
+ return hashlib.sha256(raw.encode("utf-8")).hexdigest()[:12]