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.
- code_atlas/__init__.py +6 -0
- code_atlas/__main__.py +6 -0
- code_atlas/api/__init__.py +5 -0
- code_atlas/api/handlers.py +1514 -0
- code_atlas/api/server.py +394 -0
- code_atlas/cli.py +2084 -0
- code_atlas/config.py +149 -0
- code_atlas/context/__init__.py +66 -0
- code_atlas/context/contracts.py +277 -0
- code_atlas/context/domain.py +760 -0
- code_atlas/context/engine.py +442 -0
- code_atlas/context/expand.py +133 -0
- code_atlas/context/renderers.py +71 -0
- code_atlas/context/tokenizer.py +37 -0
- code_atlas/contracts/__init__.py +38 -0
- code_atlas/contracts/enums.py +67 -0
- code_atlas/contracts/models.py +175 -0
- code_atlas/contracts/ports.py +70 -0
- code_atlas/discovery/__init__.py +25 -0
- code_atlas/discovery/gitignore.py +119 -0
- code_atlas/discovery/identity.py +52 -0
- code_atlas/discovery/models.py +204 -0
- code_atlas/discovery/scanner.py +495 -0
- code_atlas/domains/__init__.py +107 -0
- code_atlas/domains/api/__init__.py +28 -0
- code_atlas/domains/api/adapter.py +405 -0
- code_atlas/domains/api/common.py +308 -0
- code_atlas/domains/api/consumers.py +224 -0
- code_atlas/domains/api/emit.py +231 -0
- code_atlas/domains/api/openapi.py +398 -0
- code_atlas/domains/api/routes.py +582 -0
- code_atlas/domains/api/yaml_subset.py +683 -0
- code_atlas/domains/aws/__init__.py +28 -0
- code_atlas/domains/aws/adapter.py +382 -0
- code_atlas/domains/aws/common.py +261 -0
- code_atlas/domains/aws/configs.py +1164 -0
- code_atlas/domains/aws/emit.py +411 -0
- code_atlas/domains/aws/pyfiles.py +2220 -0
- code_atlas/domains/aws/sqlbridge.py +448 -0
- code_atlas/domains/cicd/__init__.py +50 -0
- code_atlas/domains/cicd/adapter.py +762 -0
- code_atlas/domains/cicd/classify.py +136 -0
- code_atlas/domains/cicd/workflow.py +504 -0
- code_atlas/domains/cicd/yamlmini.py +946 -0
- code_atlas/domains/cli_surface.py +739 -0
- code_atlas/domains/contracts.py +274 -0
- code_atlas/domains/crossresolve.py +1208 -0
- code_atlas/domains/evidence.py +57 -0
- code_atlas/domains/identity.py +149 -0
- code_atlas/domains/model.py +202 -0
- code_atlas/domains/registry.py +250 -0
- code_atlas/domains/resolution.py +65 -0
- code_atlas/domains/spark/__init__.py +31 -0
- code_atlas/domains/spark/adapter.py +146 -0
- code_atlas/domains/spark/emit.py +344 -0
- code_atlas/domains/spark/extract.py +108 -0
- code_atlas/domains/spark/sqllit.py +192 -0
- code_atlas/domains/spark/walk.py +1943 -0
- code_atlas/domains/sql/__init__.py +30 -0
- code_atlas/domains/sql/adapter.py +382 -0
- code_atlas/domains/sql/extract.py +1271 -0
- code_atlas/domains/sql/nodes.py +264 -0
- code_atlas/domains/sql/parser.py +1510 -0
- code_atlas/domains/sql/tokens.py +318 -0
- code_atlas/domains/summarize.py +126 -0
- code_atlas/domains/terraform/__init__.py +20 -0
- code_atlas/domains/terraform/adapter.py +127 -0
- code_atlas/domains/terraform/catalog.py +43 -0
- code_atlas/domains/terraform/extract.py +1277 -0
- code_atlas/domains/terraform/hcl.py +538 -0
- code_atlas/domains/terraform/refs.py +181 -0
- code_atlas/domains/terraform/tfjson.py +163 -0
- code_atlas/domains/terraform/tfvars.py +98 -0
- code_atlas/domains/validation.py +120 -0
- code_atlas/env_override.py +27 -0
- code_atlas/eval/__init__.py +26 -0
- code_atlas/eval/domain_eval.py +681 -0
- code_atlas/eval/ground_truth.py +688 -0
- code_atlas/eval/impact_truth.py +758 -0
- code_atlas/eval/metrics.py +178 -0
- code_atlas/eval/pack_value.py +610 -0
- code_atlas/federation/__init__.py +72 -0
- code_atlas/federation/federation.py +676 -0
- code_atlas/federation/model.py +355 -0
- code_atlas/federation/store.py +194 -0
- code_atlas/gitbin.py +48 -0
- code_atlas/graph/__init__.py +20 -0
- code_atlas/graph/builder.py +378 -0
- code_atlas/graph/identity.py +54 -0
- code_atlas/graph/queries.py +47 -0
- code_atlas/graph/validation.py +92 -0
- code_atlas/impact/__init__.py +37 -0
- code_atlas/impact/blast_radius.py +171 -0
- code_atlas/impact/contract_analyzer.py +104 -0
- code_atlas/impact/contracts.py +315 -0
- code_atlas/impact/diff_reader.py +142 -0
- code_atlas/impact/domain_traversal.py +768 -0
- code_atlas/impact/engine.py +392 -0
- code_atlas/impact/packs.py +128 -0
- code_atlas/impact/report.py +136 -0
- code_atlas/impact/revision_binding.py +220 -0
- code_atlas/impact/risk_classifier.py +83 -0
- code_atlas/impact/snapshot_resolver.py +136 -0
- code_atlas/impact/symbol_diff.py +210 -0
- code_atlas/impact/test_selector.py +166 -0
- code_atlas/indexing/__init__.py +5 -0
- code_atlas/indexing/cache.py +396 -0
- code_atlas/indexing/change_detector.py +278 -0
- code_atlas/indexing/coordinator.py +1032 -0
- code_atlas/indexing/dependency_planner.py +268 -0
- code_atlas/indexing/persist.py +436 -0
- code_atlas/indexing/reuse.py +85 -0
- code_atlas/install/__init__.py +7 -0
- code_atlas/install/cli.py +168 -0
- code_atlas/install/lifecycle.py +286 -0
- code_atlas/mcp.py +674 -0
- code_atlas/observability/__init__.py +19 -0
- code_atlas/observability/logging.py +199 -0
- code_atlas/parsers/__init__.py +43 -0
- code_atlas/parsers/contracts.py +209 -0
- code_atlas/parsers/engine.py +125 -0
- code_atlas/parsers/languages/__init__.py +1 -0
- code_atlas/parsers/languages/python.py +391 -0
- code_atlas/parsers/languages/tsx.py +28 -0
- code_atlas/parsers/languages/typescript.py +909 -0
- code_atlas/parsers/registry.py +51 -0
- code_atlas/parsers/tree_sitter_runtime.py +118 -0
- code_atlas/resolvers/__init__.py +33 -0
- code_atlas/resolvers/bootstrap.py +246 -0
- code_atlas/resolvers/capabilities.py +33 -0
- code_atlas/resolvers/contracts.py +133 -0
- code_atlas/resolvers/coordinator.py +96 -0
- code_atlas/resolvers/enrichment.py +318 -0
- code_atlas/resolvers/lsp/__init__.py +26 -0
- code_atlas/resolvers/lsp/adapter.py +256 -0
- code_atlas/resolvers/lsp/lifecycle.py +251 -0
- code_atlas/resolvers/lsp/spawn.py +92 -0
- code_atlas/resolvers/lsp/transport.py +240 -0
- code_atlas/resolvers/registry.py +33 -0
- code_atlas/resolvers/scip/__init__.py +49 -0
- code_atlas/resolvers/scip/decoder.py +216 -0
- code_atlas/resolvers/scip/importer.py +248 -0
- code_atlas/resolvers/scip/loader.py +90 -0
- code_atlas/resolvers/scip/mapper.py +271 -0
- code_atlas/resolvers/scip/provenance.py +211 -0
- code_atlas/resolvers/scip/resolver.py +289 -0
- code_atlas/resolvers/scip/validation.py +101 -0
- code_atlas/resolvers/syntactic/__init__.py +8 -0
- code_atlas/resolvers/syntactic/resolver.py +254 -0
- code_atlas/search/__init__.py +32 -0
- code_atlas/search/contracts.py +176 -0
- code_atlas/search/domain.py +561 -0
- code_atlas/search/engine.py +530 -0
- code_atlas/search/federated.py +276 -0
- code_atlas/search/graph.py +282 -0
- code_atlas/search/hybrid.py +151 -0
- code_atlas/search/intent.py +48 -0
- code_atlas/search/lexical.py +176 -0
- code_atlas/search/refs.py +359 -0
- code_atlas/search/structural.py +505 -0
- code_atlas/search/tokenizer.py +43 -0
- code_atlas/search/vector/__init__.py +35 -0
- code_atlas/search/vector/contracts.py +76 -0
- code_atlas/search/vector/embeddings.py +96 -0
- code_atlas/search/vector/index.py +169 -0
- code_atlas/search/vector/provider.py +50 -0
- code_atlas/storage/__init__.py +14 -0
- code_atlas/storage/db.py +47 -0
- code_atlas/storage/migrations.py +552 -0
- code_atlas/storage/store.py +1045 -0
- code_atlas/ui/__init__.py +29 -0
- code_atlas/ui/i18n.py +143 -0
- code_atlas/ui/kit.py +689 -0
- code_atlas/ui/wizard.py +317 -0
- code_atlas_forge-1.1.0.dist-info/METADATA +246 -0
- code_atlas_forge-1.1.0.dist-info/RECORD +181 -0
- code_atlas_forge-1.1.0.dist-info/WHEEL +5 -0
- code_atlas_forge-1.1.0.dist-info/entry_points.txt +2 -0
- code_atlas_forge-1.1.0.dist-info/licenses/LICENSE +202 -0
- code_atlas_forge-1.1.0.dist-info/licenses/NOTICE +17 -0
- 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]
|