@mirnoorata/codexa 0.2.0

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 (364) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +634 -0
  3. package/dist/artifacts.d.ts +2 -0
  4. package/dist/artifacts.js +375 -0
  5. package/dist/artifacts.js.map +1 -0
  6. package/dist/autonomy.d.ts +17 -0
  7. package/dist/autonomy.js +124 -0
  8. package/dist/autonomy.js.map +1 -0
  9. package/dist/autoverify/policy.d.ts +5 -0
  10. package/dist/autoverify/policy.js +18 -0
  11. package/dist/autoverify/policy.js.map +1 -0
  12. package/dist/autoverify.d.ts +45 -0
  13. package/dist/autoverify.js +1041 -0
  14. package/dist/autoverify.js.map +1 -0
  15. package/dist/cache-lock.d.ts +16 -0
  16. package/dist/cache-lock.js +181 -0
  17. package/dist/cache-lock.js.map +1 -0
  18. package/dist/cli/hooks.d.ts +5 -0
  19. package/dist/cli/hooks.js +264 -0
  20. package/dist/cli/hooks.js.map +1 -0
  21. package/dist/cli.d.ts +2 -0
  22. package/dist/cli.js +1034 -0
  23. package/dist/cli.js.map +1 -0
  24. package/dist/codex-contract.d.ts +2 -0
  25. package/dist/codex-contract.js +78 -0
  26. package/dist/codex-contract.js.map +1 -0
  27. package/dist/command.d.ts +34 -0
  28. package/dist/command.js +162 -0
  29. package/dist/command.js.map +1 -0
  30. package/dist/doctor.d.ts +112 -0
  31. package/dist/doctor.js +518 -0
  32. package/dist/doctor.js.map +1 -0
  33. package/dist/eval/baseline.d.ts +7 -0
  34. package/dist/eval/baseline.js +146 -0
  35. package/dist/eval/baseline.js.map +1 -0
  36. package/dist/eval/historical.d.ts +4 -0
  37. package/dist/eval/historical.js +663 -0
  38. package/dist/eval/historical.js.map +1 -0
  39. package/dist/eval/render.d.ts +2 -0
  40. package/dist/eval/render.js +53 -0
  41. package/dist/eval/render.js.map +1 -0
  42. package/dist/eval/scoring.d.ts +21 -0
  43. package/dist/eval/scoring.js +618 -0
  44. package/dist/eval/scoring.js.map +1 -0
  45. package/dist/eval/synthetic.d.ts +36 -0
  46. package/dist/eval/synthetic.js +107 -0
  47. package/dist/eval/synthetic.js.map +1 -0
  48. package/dist/eval/types.d.ts +36 -0
  49. package/dist/eval/types.js +2 -0
  50. package/dist/eval/types.js.map +1 -0
  51. package/dist/eval.d.ts +140 -0
  52. package/dist/eval.js +551 -0
  53. package/dist/eval.js.map +1 -0
  54. package/dist/git.d.ts +17 -0
  55. package/dist/git.js +189 -0
  56. package/dist/git.js.map +1 -0
  57. package/dist/github-release.d.ts +47 -0
  58. package/dist/github-release.js +610 -0
  59. package/dist/github-release.js.map +1 -0
  60. package/dist/github-sync.d.ts +68 -0
  61. package/dist/github-sync.js +345 -0
  62. package/dist/github-sync.js.map +1 -0
  63. package/dist/graph.d.ts +10 -0
  64. package/dist/graph.js +665 -0
  65. package/dist/graph.js.map +1 -0
  66. package/dist/indexer/aliases.d.ts +2 -0
  67. package/dist/indexer/aliases.js +190 -0
  68. package/dist/indexer/aliases.js.map +1 -0
  69. package/dist/indexer/artifact-writing.d.ts +3 -0
  70. package/dist/indexer/artifact-writing.js +79 -0
  71. package/dist/indexer/artifact-writing.js.map +1 -0
  72. package/dist/indexer/discovery.d.ts +2 -0
  73. package/dist/indexer/discovery.js +5 -0
  74. package/dist/indexer/discovery.js.map +1 -0
  75. package/dist/indexer/external-facts.d.ts +6 -0
  76. package/dist/indexer/external-facts.js +45 -0
  77. package/dist/indexer/external-facts.js.map +1 -0
  78. package/dist/indexer/freshness.d.ts +8 -0
  79. package/dist/indexer/freshness.js +56 -0
  80. package/dist/indexer/freshness.js.map +1 -0
  81. package/dist/indexer/graph-stage.d.ts +2 -0
  82. package/dist/indexer/graph-stage.js +21 -0
  83. package/dist/indexer/graph-stage.js.map +1 -0
  84. package/dist/indexer/parsing.d.ts +30 -0
  85. package/dist/indexer/parsing.js +177 -0
  86. package/dist/indexer/parsing.js.map +1 -0
  87. package/dist/indexer/pipeline.d.ts +5 -0
  88. package/dist/indexer/pipeline.js +8 -0
  89. package/dist/indexer/pipeline.js.map +1 -0
  90. package/dist/indexer/ranking.d.ts +4 -0
  91. package/dist/indexer/ranking.js +134 -0
  92. package/dist/indexer/ranking.js.map +1 -0
  93. package/dist/indexer.d.ts +13 -0
  94. package/dist/indexer.js +395 -0
  95. package/dist/indexer.js.map +1 -0
  96. package/dist/init.d.ts +24 -0
  97. package/dist/init.js +566 -0
  98. package/dist/init.js.map +1 -0
  99. package/dist/language.d.ts +8 -0
  100. package/dist/language.js +123 -0
  101. package/dist/language.js.map +1 -0
  102. package/dist/live-index.d.ts +68 -0
  103. package/dist/live-index.js +215 -0
  104. package/dist/live-index.js.map +1 -0
  105. package/dist/lsp/assist.d.ts +44 -0
  106. package/dist/lsp/assist.js +331 -0
  107. package/dist/lsp/assist.js.map +1 -0
  108. package/dist/lsp/client.d.ts +59 -0
  109. package/dist/lsp/client.js +208 -0
  110. package/dist/lsp/client.js.map +1 -0
  111. package/dist/mcp/compaction.d.ts +15 -0
  112. package/dist/mcp/compaction.js +1249 -0
  113. package/dist/mcp/compaction.js.map +1 -0
  114. package/dist/mcp/envelope.d.ts +44 -0
  115. package/dist/mcp/envelope.js +425 -0
  116. package/dist/mcp/envelope.js.map +1 -0
  117. package/dist/mcp/prompts.d.ts +2 -0
  118. package/dist/mcp/prompts.js +109 -0
  119. package/dist/mcp/prompts.js.map +1 -0
  120. package/dist/mcp/resources.d.ts +2 -0
  121. package/dist/mcp/resources.js +132 -0
  122. package/dist/mcp/resources.js.map +1 -0
  123. package/dist/mcp/runtime.d.ts +15 -0
  124. package/dist/mcp/runtime.js +122 -0
  125. package/dist/mcp/runtime.js.map +1 -0
  126. package/dist/mcp/session-memory.d.ts +3 -0
  127. package/dist/mcp/session-memory.js +61 -0
  128. package/dist/mcp/session-memory.js.map +1 -0
  129. package/dist/mcp/tool-registry.d.ts +269 -0
  130. package/dist/mcp/tool-registry.js +284 -0
  131. package/dist/mcp/tool-registry.js.map +1 -0
  132. package/dist/mcp/tools.d.ts +53 -0
  133. package/dist/mcp/tools.js +372 -0
  134. package/dist/mcp/tools.js.map +1 -0
  135. package/dist/mcp-repo-root.d.ts +16 -0
  136. package/dist/mcp-repo-root.js +322 -0
  137. package/dist/mcp-repo-root.js.map +1 -0
  138. package/dist/mcp-tool-catalog.d.ts +2 -0
  139. package/dist/mcp-tool-catalog.js +2 -0
  140. package/dist/mcp-tool-catalog.js.map +1 -0
  141. package/dist/mcp.d.ts +11 -0
  142. package/dist/mcp.js +332 -0
  143. package/dist/mcp.js.map +1 -0
  144. package/dist/outcome-ranking.d.ts +5 -0
  145. package/dist/outcome-ranking.js +115 -0
  146. package/dist/outcome-ranking.js.map +1 -0
  147. package/dist/parser/context.d.ts +28 -0
  148. package/dist/parser/context.js +2 -0
  149. package/dist/parser/context.js.map +1 -0
  150. package/dist/parser/ecma.d.ts +5 -0
  151. package/dist/parser/ecma.js +388 -0
  152. package/dist/parser/ecma.js.map +1 -0
  153. package/dist/parser/facts.d.ts +12 -0
  154. package/dist/parser/facts.js +137 -0
  155. package/dist/parser/facts.js.map +1 -0
  156. package/dist/parser/json.d.ts +3 -0
  157. package/dist/parser/json.js +318 -0
  158. package/dist/parser/json.js.map +1 -0
  159. package/dist/parser/markdown.d.ts +3 -0
  160. package/dist/parser/markdown.js +180 -0
  161. package/dist/parser/markdown.js.map +1 -0
  162. package/dist/parser/nodes.d.ts +5 -0
  163. package/dist/parser/nodes.js +75 -0
  164. package/dist/parser/nodes.js.map +1 -0
  165. package/dist/parser/python.d.ts +2 -0
  166. package/dist/parser/python.js +307 -0
  167. package/dist/parser/python.js.map +1 -0
  168. package/dist/parser/references.d.ts +3 -0
  169. package/dist/parser/references.js +204 -0
  170. package/dist/parser/references.js.map +1 -0
  171. package/dist/parser/risks.d.ts +4 -0
  172. package/dist/parser/risks.js +62 -0
  173. package/dist/parser/risks.js.map +1 -0
  174. package/dist/parser/routes.d.ts +5 -0
  175. package/dist/parser/routes.js +97 -0
  176. package/dist/parser/routes.js.map +1 -0
  177. package/dist/parser/shallow.d.ts +3 -0
  178. package/dist/parser/shallow.js +545 -0
  179. package/dist/parser/shallow.js.map +1 -0
  180. package/dist/parser/source.d.ts +4 -0
  181. package/dist/parser/source.js +127 -0
  182. package/dist/parser/source.js.map +1 -0
  183. package/dist/parser.d.ts +2 -0
  184. package/dist/parser.js +2 -0
  185. package/dist/parser.js.map +1 -0
  186. package/dist/placeholder-signals.d.ts +15 -0
  187. package/dist/placeholder-signals.js +511 -0
  188. package/dist/placeholder-signals.js.map +1 -0
  189. package/dist/post-edit-outcomes.d.ts +167 -0
  190. package/dist/post-edit-outcomes.js +484 -0
  191. package/dist/post-edit-outcomes.js.map +1 -0
  192. package/dist/queries.d.ts +12 -0
  193. package/dist/queries.js +13 -0
  194. package/dist/queries.js.map +1 -0
  195. package/dist/query/change-plan.d.ts +48 -0
  196. package/dist/query/change-plan.js +858 -0
  197. package/dist/query/change-plan.js.map +1 -0
  198. package/dist/query/compact-data.d.ts +25 -0
  199. package/dist/query/compact-data.js +74 -0
  200. package/dist/query/compact-data.js.map +1 -0
  201. package/dist/query/context.d.ts +5 -0
  202. package/dist/query/context.js +1162 -0
  203. package/dist/query/context.js.map +1 -0
  204. package/dist/query/diff.d.ts +5 -0
  205. package/dist/query/diff.js +111 -0
  206. package/dist/query/diff.js.map +1 -0
  207. package/dist/query/edge-evidence.d.ts +3 -0
  208. package/dist/query/edge-evidence.js +36 -0
  209. package/dist/query/edge-evidence.js.map +1 -0
  210. package/dist/query/formatting.d.ts +14 -0
  211. package/dist/query/formatting.js +67 -0
  212. package/dist/query/formatting.js.map +1 -0
  213. package/dist/query/graph-traversal.d.ts +22 -0
  214. package/dist/query/graph-traversal.js +218 -0
  215. package/dist/query/graph-traversal.js.map +1 -0
  216. package/dist/query/graph.d.ts +14 -0
  217. package/dist/query/graph.js +102 -0
  218. package/dist/query/graph.js.map +1 -0
  219. package/dist/query/impact.d.ts +28 -0
  220. package/dist/query/impact.js +568 -0
  221. package/dist/query/impact.js.map +1 -0
  222. package/dist/query/inspection.d.ts +9 -0
  223. package/dist/query/inspection.js +290 -0
  224. package/dist/query/inspection.js.map +1 -0
  225. package/dist/query/next-tools.d.ts +3 -0
  226. package/dist/query/next-tools.js +25 -0
  227. package/dist/query/next-tools.js.map +1 -0
  228. package/dist/query/placeholders.d.ts +24 -0
  229. package/dist/query/placeholders.js +121 -0
  230. package/dist/query/placeholders.js.map +1 -0
  231. package/dist/query/post-edit/decision.d.ts +49 -0
  232. package/dist/query/post-edit/decision.js +130 -0
  233. package/dist/query/post-edit/decision.js.map +1 -0
  234. package/dist/query/post-edit/dirty-scope.d.ts +16 -0
  235. package/dist/query/post-edit/dirty-scope.js +21 -0
  236. package/dist/query/post-edit/dirty-scope.js.map +1 -0
  237. package/dist/query/post-edit/next-actions.d.ts +22 -0
  238. package/dist/query/post-edit/next-actions.js +44 -0
  239. package/dist/query/post-edit/next-actions.js.map +1 -0
  240. package/dist/query/post-edit/snapshot-contract.d.ts +8 -0
  241. package/dist/query/post-edit/snapshot-contract.js +111 -0
  242. package/dist/query/post-edit/snapshot-contract.js.map +1 -0
  243. package/dist/query/post-edit.d.ts +5 -0
  244. package/dist/query/post-edit.js +1108 -0
  245. package/dist/query/post-edit.js.map +1 -0
  246. package/dist/query/quality.d.ts +43 -0
  247. package/dist/query/quality.js +134 -0
  248. package/dist/query/quality.js.map +1 -0
  249. package/dist/query/raw-search.d.ts +23 -0
  250. package/dist/query/raw-search.js +147 -0
  251. package/dist/query/raw-search.js.map +1 -0
  252. package/dist/query/runtime.d.ts +11 -0
  253. package/dist/query/runtime.js +79 -0
  254. package/dist/query/runtime.js.map +1 -0
  255. package/dist/query/search.d.ts +25 -0
  256. package/dist/query/search.js +429 -0
  257. package/dist/query/search.js.map +1 -0
  258. package/dist/query/session-memory.d.ts +3 -0
  259. package/dist/query/session-memory.js +108 -0
  260. package/dist/query/session-memory.js.map +1 -0
  261. package/dist/query/session.d.ts +41 -0
  262. package/dist/query/session.js +90 -0
  263. package/dist/query/session.js.map +1 -0
  264. package/dist/query/targets.d.ts +25 -0
  265. package/dist/query/targets.js +97 -0
  266. package/dist/query/targets.js.map +1 -0
  267. package/dist/query/test-commands.d.ts +10 -0
  268. package/dist/query/test-commands.js +110 -0
  269. package/dist/query/test-commands.js.map +1 -0
  270. package/dist/query/test-plan.d.ts +6 -0
  271. package/dist/query/test-plan.js +104 -0
  272. package/dist/query/test-plan.js.map +1 -0
  273. package/dist/query/tests.d.ts +48 -0
  274. package/dist/query/tests.js +444 -0
  275. package/dist/query/tests.js.map +1 -0
  276. package/dist/query/verification/shell.d.ts +20 -0
  277. package/dist/query/verification/shell.js +164 -0
  278. package/dist/query/verification/shell.js.map +1 -0
  279. package/dist/query/verification.d.ts +47 -0
  280. package/dist/query/verification.js +1123 -0
  281. package/dist/query/verification.js.map +1 -0
  282. package/dist/query/workflow.d.ts +17 -0
  283. package/dist/query/workflow.js +252 -0
  284. package/dist/query/workflow.js.map +1 -0
  285. package/dist/query/workspace-guidance.d.ts +26 -0
  286. package/dist/query/workspace-guidance.js +214 -0
  287. package/dist/query/workspace-guidance.js.map +1 -0
  288. package/dist/query/worktree-state.d.ts +22 -0
  289. package/dist/query/worktree-state.js +32 -0
  290. package/dist/query/worktree-state.js.map +1 -0
  291. package/dist/query/worktree.d.ts +16 -0
  292. package/dist/query/worktree.js +194 -0
  293. package/dist/query/worktree.js.map +1 -0
  294. package/dist/query-data.d.ts +4 -0
  295. package/dist/query-data.js +112 -0
  296. package/dist/query-data.js.map +1 -0
  297. package/dist/repo-files.d.ts +24 -0
  298. package/dist/repo-files.js +105 -0
  299. package/dist/repo-files.js.map +1 -0
  300. package/dist/resolver.d.ts +9 -0
  301. package/dist/resolver.js +555 -0
  302. package/dist/resolver.js.map +1 -0
  303. package/dist/retrieval.d.ts +46 -0
  304. package/dist/retrieval.js +783 -0
  305. package/dist/retrieval.js.map +1 -0
  306. package/dist/risk-ingest.d.ts +16 -0
  307. package/dist/risk-ingest.js +458 -0
  308. package/dist/risk-ingest.js.map +1 -0
  309. package/dist/rules.d.ts +10 -0
  310. package/dist/rules.js +107 -0
  311. package/dist/rules.js.map +1 -0
  312. package/dist/semantic/python.d.ts +9 -0
  313. package/dist/semantic/python.js +817 -0
  314. package/dist/semantic/python.js.map +1 -0
  315. package/dist/semantic/typescript.d.ts +10 -0
  316. package/dist/semantic/typescript.js +714 -0
  317. package/dist/semantic/typescript.js.map +1 -0
  318. package/dist/semantic-retrieval.d.ts +53 -0
  319. package/dist/semantic-retrieval.js +673 -0
  320. package/dist/semantic-retrieval.js.map +1 -0
  321. package/dist/session-memory/derivation.d.ts +6 -0
  322. package/dist/session-memory/derivation.js +400 -0
  323. package/dist/session-memory/derivation.js.map +1 -0
  324. package/dist/session-memory/event-log.d.ts +23 -0
  325. package/dist/session-memory/event-log.js +126 -0
  326. package/dist/session-memory/event-log.js.map +1 -0
  327. package/dist/session-memory/formatting.d.ts +7 -0
  328. package/dist/session-memory/formatting.js +86 -0
  329. package/dist/session-memory/formatting.js.map +1 -0
  330. package/dist/session-memory/model.d.ts +94 -0
  331. package/dist/session-memory/model.js +17 -0
  332. package/dist/session-memory/model.js.map +1 -0
  333. package/dist/session-memory/runtime.d.ts +24 -0
  334. package/dist/session-memory/runtime.js +289 -0
  335. package/dist/session-memory/runtime.js.map +1 -0
  336. package/dist/session-memory/store.d.ts +27 -0
  337. package/dist/session-memory/store.js +447 -0
  338. package/dist/session-memory/store.js.map +1 -0
  339. package/dist/session-memory.d.ts +1 -0
  340. package/dist/session-memory.js +2 -0
  341. package/dist/session-memory.js.map +1 -0
  342. package/dist/static-analysis.d.ts +36 -0
  343. package/dist/static-analysis.js +505 -0
  344. package/dist/static-analysis.js.map +1 -0
  345. package/dist/symbol-report-ingest.d.ts +8 -0
  346. package/dist/symbol-report-ingest.js +504 -0
  347. package/dist/symbol-report-ingest.js.map +1 -0
  348. package/dist/task-snapshots.d.ts +41 -0
  349. package/dist/task-snapshots.js +430 -0
  350. package/dist/task-snapshots.js.map +1 -0
  351. package/dist/types.d.ts +848 -0
  352. package/dist/types.js +12 -0
  353. package/dist/types.js.map +1 -0
  354. package/dist/util.d.ts +11 -0
  355. package/dist/util.js +63 -0
  356. package/dist/util.js.map +1 -0
  357. package/dist/version.d.ts +1 -0
  358. package/dist/version.js +5 -0
  359. package/dist/version.js.map +1 -0
  360. package/package.json +81 -0
  361. package/plugins/codexa/.codex-plugin/plugin.json +38 -0
  362. package/plugins/codexa/.mcp.json +20 -0
  363. package/plugins/codexa/scripts/codexa-mcp.js +100 -0
  364. package/plugins/codexa/skills/codexa/SKILL.md +48 -0
@@ -0,0 +1,307 @@
1
+ import { stableId } from "../util.js";
2
+ import { baseFact, importFact, rangeOf, riskFact, symbolFact, usageFact } from "./facts.js";
3
+ import { callName, decoratorsForNode } from "./nodes.js";
4
+ import { decoratorName, isRouteDecorator, isTaskDecorator, routeEndpointsFromDecorator } from "./routes.js";
5
+ const PYTHON_DEFINITION_TYPES = new Set(["class_definition", "function_definition", "async_function_definition"]);
6
+ export function extractPython(root, ctx) {
7
+ const stack = [
8
+ { node: root, decorators: [], scope: "module" }
9
+ ];
10
+ while (stack.length > 0) {
11
+ const current = stack.pop();
12
+ const { node } = current;
13
+ let parentSymbolId = current.parentSymbolId;
14
+ let className = current.className;
15
+ let pendingDecorators = current.decorators;
16
+ let definition = node;
17
+ let decoratedDefinition;
18
+ let childScope = current.scope;
19
+ if (node.type === "decorated_definition") {
20
+ pendingDecorators = decoratorsForNode(node, ctx.sourceText);
21
+ const childDefinition = node.namedChildren.find((child) => PYTHON_DEFINITION_TYPES.has(child.type));
22
+ if (childDefinition) {
23
+ definition = childDefinition;
24
+ decoratedDefinition = childDefinition;
25
+ }
26
+ }
27
+ if (PYTHON_DEFINITION_TYPES.has(definition.type) && !current.suppressDefinition) {
28
+ const name = definition.childForFieldName("name")?.text;
29
+ if (name) {
30
+ const isMethod = definition.type === "function_definition" && className !== undefined;
31
+ const kind = pythonSymbolKind(name, definition.type, pendingDecorators, ctx.test, isMethod);
32
+ const qualifiedName = className && isMethod ? `${className}.${name}` : name;
33
+ const symbol = symbolFact(ctx, definition, name, qualifiedName, kind, pendingDecorators, parentSymbolId);
34
+ ctx.symbols.push(symbol);
35
+ parentSymbolId = symbol.id;
36
+ if (definition.type === "class_definition") {
37
+ className = name;
38
+ childScope = "class";
39
+ for (const baseName of pythonClassBaseNames(definition)) {
40
+ ctx.usageSites.push(usageFact(ctx, definition, baseName, "type_reference", `extends ${baseName}`, symbol.id, "derived"));
41
+ }
42
+ }
43
+ else {
44
+ childScope = "function";
45
+ }
46
+ addPythonFrameworkHints(ctx, definition, symbol, pendingDecorators);
47
+ if (kind === "fixture") {
48
+ for (const param of pythonParameterNames(definition)) {
49
+ ctx.usageSites.push(usageFact(ctx, definition, param, "test_reference", `fixture dependency ${param}`, symbol.id, "derived"));
50
+ }
51
+ }
52
+ for (const decorator of pendingDecorators) {
53
+ if (isRouteDecorator(decorator) || isTaskDecorator(decorator)) {
54
+ ctx.usageSites.push(usageFact(ctx, definition, decoratorName(decorator), "decorator", decorator, symbol.id, "heuristic"));
55
+ for (const endpoint of routeEndpointsFromDecorator(decorator)) {
56
+ ctx.usageSites.push(usageFact(ctx, definition, endpoint, "route_handler", decorator, symbol.id, "derived"));
57
+ }
58
+ ctx.risks.push(riskFact(ctx, definition, isRouteDecorator(decorator) ? "route-handler" : "background-job", 2, decorator));
59
+ }
60
+ if (decorator.includes("fixture")) {
61
+ ctx.risks.push(riskFact(ctx, definition, "pytest-fixture", 1, decorator));
62
+ }
63
+ }
64
+ }
65
+ }
66
+ if (node.type === "assignment" && (current.scope === "module" || current.scope === "class")) {
67
+ for (const name of pythonAssignmentNames(node)) {
68
+ const qualifiedName = current.scope === "class" && className ? `${className}.${name}` : name;
69
+ ctx.symbols.push(symbolFact(ctx, node, name, qualifiedName, "variable", [], current.scope === "class" ? parentSymbolId : undefined, current.scope === "module"));
70
+ }
71
+ }
72
+ if (node.type === "import_statement" || node.type === "import_from_statement") {
73
+ for (const imp of pythonImports(node, ctx.sourceText)) {
74
+ ctx.imports.push(importFact(ctx, node, imp.specifier, imp.importedName, imp.localName));
75
+ ctx.usageSites.push(usageFact(ctx, node, imp.localName ?? imp.importedName ?? imp.specifier, "import", node.text, parentSymbolId, "authoritative"));
76
+ addPythonImportFrameworkHint(ctx, node, imp);
77
+ }
78
+ }
79
+ if (node.type === "call") {
80
+ const name = callName(node);
81
+ if (name) {
82
+ ctx.usageSites.push(usageFact(ctx, node, name, "call", node.text, parentSymbolId, "derived"));
83
+ addPythonCallFrameworkHint(ctx, node, name);
84
+ }
85
+ }
86
+ if (ctx.test && PYTHON_DEFINITION_TYPES.has(node.type)) {
87
+ const name = node.childForFieldName("name")?.text ?? "";
88
+ if (name.startsWith("test") || name.startsWith("Test")) {
89
+ ctx.testEdges.push({
90
+ ...baseFact("TestEdge", ctx.path, ctx.snapshotId, ctx.indexedAt, "heuristic", "derived", rangeOf(node)),
91
+ id: stableId("test-edge", ctx.path, name),
92
+ type: "TestEdge",
93
+ path: ctx.path,
94
+ reason: `pytest-style test ${name}`
95
+ });
96
+ for (const param of pythonParameterNames(node)) {
97
+ ctx.usageSites.push(usageFact(ctx, node, param, "test_reference", `fixture parameter ${param}`, parentSymbolId, "derived"));
98
+ }
99
+ }
100
+ }
101
+ for (let i = node.namedChildCount - 1; i >= 0; i -= 1) {
102
+ const child = node.namedChild(i);
103
+ if (child) {
104
+ stack.push({
105
+ node: child,
106
+ parentSymbolId,
107
+ className,
108
+ decorators: [],
109
+ scope: child === decoratedDefinition ? childScope : childScope,
110
+ suppressDefinition: child === decoratedDefinition
111
+ });
112
+ }
113
+ }
114
+ }
115
+ }
116
+ function pythonSymbolKind(name, nodeType, decorators, test, isMethod) {
117
+ if (nodeType === "class_definition") {
118
+ return test && name.startsWith("Test") ? "test" : "class";
119
+ }
120
+ if (decorators.some((decorator) => decorator.includes("fixture"))) {
121
+ return "fixture";
122
+ }
123
+ if (test && name.startsWith("test")) {
124
+ return "test";
125
+ }
126
+ if (decorators.some((decorator) => isRouteDecorator(decorator))) {
127
+ return "route";
128
+ }
129
+ return isMethod ? "method" : "function";
130
+ }
131
+ function pythonAssignmentNames(node) {
132
+ const left = node.childForFieldName("left") ?? node.namedChild(0);
133
+ if (!left) {
134
+ return [];
135
+ }
136
+ if (left.type === "identifier") {
137
+ return [left.text];
138
+ }
139
+ if (left.type === "attribute") {
140
+ const name = left.namedChildren.at(-1)?.text;
141
+ return name ? [name] : [];
142
+ }
143
+ if (left.type === "pattern_list" || left.type === "tuple" || left.type === "list") {
144
+ return left.namedChildren.filter((child) => child.type === "identifier").map((child) => child.text);
145
+ }
146
+ return [];
147
+ }
148
+ function pythonParameterNames(node) {
149
+ const parameters = node.childForFieldName("parameters") ?? node.namedChildren.find((child) => child.type === "parameters");
150
+ if (!parameters) {
151
+ return [];
152
+ }
153
+ const body = parameters.text.replace(/^\(/, "").replace(/\)$/, "");
154
+ const result = [];
155
+ for (const rawPart of splitTopLevel(body, ",")) {
156
+ const cleaned = rawPart
157
+ .trim()
158
+ .replace(/^[*/\s]+/, "")
159
+ .replace(/\s*=.*$/s, "")
160
+ .replace(/\s*:.*$/s, "")
161
+ .trim();
162
+ if (!cleaned || ["self", "cls"].includes(cleaned)) {
163
+ continue;
164
+ }
165
+ if (/^[A-Za-z_]\w*$/.test(cleaned)) {
166
+ result.push(cleaned);
167
+ }
168
+ }
169
+ return [...new Set(result)].sort();
170
+ }
171
+ function splitTopLevel(value, delimiter) {
172
+ const result = [];
173
+ let current = "";
174
+ let depth = 0;
175
+ let quote;
176
+ for (let index = 0; index < value.length; index += 1) {
177
+ const char = value[index];
178
+ const previous = value[index - 1];
179
+ if (quote) {
180
+ current += char;
181
+ if (char === quote && previous !== "\\") {
182
+ quote = undefined;
183
+ }
184
+ continue;
185
+ }
186
+ if (char === "'" || char === "\"") {
187
+ quote = char;
188
+ current += char;
189
+ continue;
190
+ }
191
+ if (char === "(" || char === "[" || char === "{") {
192
+ depth += 1;
193
+ }
194
+ else if (char === ")" || char === "]" || char === "}") {
195
+ depth = Math.max(0, depth - 1);
196
+ }
197
+ if (char === delimiter && depth === 0) {
198
+ result.push(current);
199
+ current = "";
200
+ continue;
201
+ }
202
+ current += char;
203
+ }
204
+ result.push(current);
205
+ return result;
206
+ }
207
+ function pythonImports(node, sourceText) {
208
+ const text = node.text
209
+ .trim()
210
+ .replace(/\\\r?\n/g, " ")
211
+ .replace(/\r?\n/g, " ")
212
+ .replace(/\s+/g, " ");
213
+ if (node.type === "import_statement") {
214
+ return text
215
+ .replace(/^import\s+/, "")
216
+ .split(",")
217
+ .map((part) => part.trim())
218
+ .filter(Boolean)
219
+ .map((part) => {
220
+ const [specifier, alias] = part.split(/\s+as\s+/);
221
+ return { specifier, importedName: "*", localName: alias ?? specifier.split(".")[0] };
222
+ });
223
+ }
224
+ const match = /^from\s+([.\w]+)\s+import\s+(.+)$/.exec(text);
225
+ if (!match) {
226
+ return [{ specifier: sourceText.slice(node.startIndex, node.endIndex), importedName: undefined }];
227
+ }
228
+ const [, specifier, names] = match;
229
+ return names
230
+ .replace(/^\(/, "")
231
+ .replace(/\)$/, "")
232
+ .split(",")
233
+ .map((name) => name.trim())
234
+ .filter(Boolean)
235
+ .map((name) => {
236
+ const [importedName, alias] = name.split(/\s+as\s+/);
237
+ return { specifier, importedName, localName: alias ?? importedName };
238
+ });
239
+ }
240
+ function pythonClassBaseNames(node) {
241
+ const match = /^class\s+[A-Za-z_][\w]*\s*\(([^)]*)\)/s.exec(node.text.trim());
242
+ if (!match) {
243
+ return [];
244
+ }
245
+ return match[1]
246
+ .split(",")
247
+ .map((part) => part
248
+ .trim()
249
+ .replace(/\[.*$/s, "")
250
+ .replace(/\(.*$/s, "")
251
+ .split(".")
252
+ .filter(Boolean)
253
+ .join("."))
254
+ .filter(Boolean)
255
+ .slice(0, 12);
256
+ }
257
+ function addPythonFrameworkHints(ctx, node, symbol, decorators) {
258
+ if (ctx.language !== "python") {
259
+ return;
260
+ }
261
+ const bases = symbol.kind === "class" ? pythonClassBaseNames(node) : [];
262
+ if (symbol.kind === "route") {
263
+ ctx.risks.push(riskFact(ctx, node, "fastapi-route", 2, `${symbol.qualifiedName} is registered by a route decorator`));
264
+ }
265
+ if (decorators.some((decorator) => /(celery|shared_task|\.task|@task|@job)/i.test(decorator))) {
266
+ ctx.risks.push(riskFact(ctx, node, "celery-task", 2, `${symbol.qualifiedName} is registered as a background task`));
267
+ }
268
+ if (bases.some((base) => /\b(BaseModel|pydantic\.BaseModel)\b/.test(base))) {
269
+ ctx.risks.push(riskFact(ctx, node, "pydantic-model", 1.8, `${symbol.qualifiedName} inherits from Pydantic BaseModel`));
270
+ }
271
+ const importsSqlalchemy = /\bfrom\s+(sqlalchemy|sqlmodel)\b|\bimport\s+(sqlalchemy|sqlmodel)\b/i.test(ctx.sourceText);
272
+ const hasDeclarativeBase = /\bclass\s+Base\s*\(\s*(DeclarativeBase|SQLModel)\s*\)/.test(ctx.sourceText) || /\bBase\s*=\s*declarative_base\s*\(/.test(ctx.sourceText);
273
+ if (bases.some((base) => /\b(DeclarativeBase|SQLModel)\b/.test(base) || (importsSqlalchemy && hasDeclarativeBase && /\bBase\b/.test(base))) &&
274
+ /\b(Column|mapped_column|relationship|__tablename__)\b/.test(node.text)) {
275
+ ctx.risks.push(riskFact(ctx, node, "sqlalchemy-model", 1.8, `${symbol.qualifiedName} looks like a SQLAlchemy/SQLModel model`));
276
+ }
277
+ }
278
+ function addPythonImportFrameworkHint(ctx, node, imp) {
279
+ const value = `${imp.specifier}.${imp.importedName ?? ""}.${imp.localName ?? ""}`;
280
+ if (/\bfastapi\b/i.test(value)) {
281
+ ctx.risks.push(riskFact(ctx, node, "fastapi-framework", 1.5, `imports ${imp.importedName ?? imp.specifier}`));
282
+ }
283
+ if (/\b(celery|shared_task)\b/i.test(value)) {
284
+ ctx.risks.push(riskFact(ctx, node, "celery-framework", 1.5, `imports ${imp.importedName ?? imp.specifier}`));
285
+ }
286
+ if (/\bpydantic\b/i.test(value)) {
287
+ ctx.risks.push(riskFact(ctx, node, "pydantic-framework", 1.5, `imports ${imp.importedName ?? imp.specifier}`));
288
+ }
289
+ if (/\b(sqlalchemy|sqlmodel)\b/i.test(value)) {
290
+ ctx.risks.push(riskFact(ctx, node, "sqlalchemy-framework", 1.5, `imports ${imp.importedName ?? imp.specifier}`));
291
+ }
292
+ }
293
+ function addPythonCallFrameworkHint(ctx, node, name) {
294
+ if (/^(FastAPI|APIRouter|include_router|Depends)$|\.include_router$|\.dependency_overrides$/i.test(name)) {
295
+ ctx.risks.push(riskFact(ctx, node, "fastapi-runtime-wiring", 1.5, `FastAPI runtime wiring call ${name}`));
296
+ }
297
+ if (/^(Celery|shared_task)$|\.task$|\.send_task$|\.delay$|\.apply_async$/i.test(name)) {
298
+ ctx.risks.push(riskFact(ctx, node, "celery-runtime-wiring", 1.5, `background task call ${name}`));
299
+ }
300
+ if (/^(BaseModel|Field|model_validate|model_dump)$|\.model_validate$|\.model_dump$/i.test(name)) {
301
+ ctx.risks.push(riskFact(ctx, node, "pydantic-runtime-wiring", 1.2, `Pydantic call ${name}`));
302
+ }
303
+ if (/^(Column|mapped_column|relationship|select|Session)$|\.execute$|\.scalars$|\.commit$/i.test(name)) {
304
+ ctx.risks.push(riskFact(ctx, node, "sqlalchemy-runtime-wiring", 1.5, `SQLAlchemy call ${name}`));
305
+ }
306
+ }
307
+ //# sourceMappingURL=python.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"python.js","sourceRoot":"","sources":["../../src/parser/python.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { ExtractContext } from "./context.js";
2
+ export declare function extractDottedStringReferences(ctx: ExtractContext): void;
3
+ export declare function extractEndpointStringReferences(ctx: ExtractContext): void;
@@ -0,0 +1,204 @@
1
+ import { stableId } from "../util.js";
2
+ import { baseFact, rangeFromOffsets } from "./facts.js";
3
+ import { normalizeEndpointPath } from "./routes.js";
4
+ export function extractDottedStringReferences(ctx) {
5
+ const seen = new Set();
6
+ const pattern = /\b[a-z][a-z0-9_-]*(?:\.[a-z][a-z0-9_-]*)+\b/gi;
7
+ for (const match of ctx.sourceText.matchAll(pattern)) {
8
+ const name = match[0];
9
+ const start = match.index ?? 0;
10
+ const end = start + name.length;
11
+ if (!shouldIndexDottedStringReference(name) || !isStandaloneQuotedDottedStringReference(ctx.sourceText, start, end)) {
12
+ continue;
13
+ }
14
+ const key = `${name}:${start}`;
15
+ if (seen.has(key)) {
16
+ continue;
17
+ }
18
+ seen.add(key);
19
+ ctx.usageSites.push({
20
+ ...baseFact("UsageSite", ctx.path, ctx.snapshotId, ctx.indexedAt, "heuristic", "heuristic", rangeFromOffsets(ctx.sourceText, start, start + name.length)),
21
+ id: stableId("dotted-string-reference", ctx.path, name, start),
22
+ type: "UsageSite",
23
+ path: ctx.path,
24
+ name,
25
+ kind: "reference",
26
+ text: name
27
+ });
28
+ }
29
+ }
30
+ function isStandaloneQuotedDottedStringReference(sourceText, start, end) {
31
+ const quote = sourceText[start - 1];
32
+ return (quote === "'" || quote === "\"" || quote === "`") && sourceText[end] === quote;
33
+ }
34
+ function shouldIndexDottedStringReference(value) {
35
+ const normalized = value.trim();
36
+ if (!normalized || normalized.split(".").length < 2) {
37
+ return false;
38
+ }
39
+ if (/^(?:https?:\/\/|www\.)/iu.test(normalized)) {
40
+ return false;
41
+ }
42
+ if (/^\d+(?:\.\d+)+$/u.test(normalized) || /^v\d+(?:\.\d+)+$/iu.test(normalized) || /^\d+\.\d+$/u.test(normalized)) {
43
+ return false;
44
+ }
45
+ if (/^\d{1,3}(?:\.\d{1,3}){3}$/u.test(normalized)) {
46
+ return false;
47
+ }
48
+ if (/^\d{4}[./-]\d{2}[./-]\d{2}(?:[Tt _-]\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?)?$/u.test(normalized)) {
49
+ return false;
50
+ }
51
+ if (looksLikeCommonDomain(normalized)) {
52
+ return false;
53
+ }
54
+ return true;
55
+ }
56
+ function looksLikeCommonDomain(value) {
57
+ const parts = value.split(".");
58
+ if (parts.length < 2 || parts.length > 6) {
59
+ return false;
60
+ }
61
+ const tld = parts.at(-1)?.toLowerCase();
62
+ if (!tld) {
63
+ return false;
64
+ }
65
+ const commonTlds = new Set([
66
+ "ai",
67
+ "app",
68
+ "biz",
69
+ "ca",
70
+ "ch",
71
+ "co",
72
+ "com",
73
+ "de",
74
+ "dev",
75
+ "edu",
76
+ "fr",
77
+ "gov",
78
+ "hk",
79
+ "info",
80
+ "io",
81
+ "jp",
82
+ "me",
83
+ "net",
84
+ "nl",
85
+ "no",
86
+ "org",
87
+ "pl",
88
+ "pt",
89
+ "ru",
90
+ "se",
91
+ "sg",
92
+ "uk",
93
+ "us",
94
+ "xyz"
95
+ ]);
96
+ if (!commonTlds.has(tld)) {
97
+ return false;
98
+ }
99
+ return parts.every((part, index) => (index === 0 ? /^[a-z][a-z0-9_-]*$/iu.test(part) : /^[a-z0-9-]+$/iu.test(part)));
100
+ }
101
+ export function extractEndpointStringReferences(ctx) {
102
+ const seen = new Set();
103
+ const pattern = /(["'`])(\/[A-Za-z0-9_./:${}()?=&%+-]{1,180})\1/g;
104
+ for (const match of ctx.sourceText.matchAll(pattern)) {
105
+ const rawPath = match[2];
106
+ const start = match.index ?? 0;
107
+ if (!shouldKeepEndpointString(ctx, rawPath, start)) {
108
+ continue;
109
+ }
110
+ const method = inferEndpointMethod(ctx.sourceText, start);
111
+ const name = `${method} ${endpointPathForReference(ctx, rawPath, start)}`;
112
+ const key = `${name}:${start}`;
113
+ if (seen.has(key)) {
114
+ continue;
115
+ }
116
+ seen.add(key);
117
+ ctx.usageSites.push({
118
+ ...baseFact("UsageSite", ctx.path, ctx.snapshotId, ctx.indexedAt, "heuristic", ctx.test ? "derived" : "heuristic", rangeFromOffsets(ctx.sourceText, start, start + match[0].length)),
119
+ id: stableId("endpoint-string-reference", ctx.path, name, start),
120
+ type: "UsageSite",
121
+ path: ctx.path,
122
+ name,
123
+ kind: "endpoint_reference",
124
+ text: ctx.sourceText.slice(Math.max(0, start - 80), Math.min(ctx.sourceText.length, start + match[0].length + 120)).replace(/\s+/g, " ").slice(0, 240)
125
+ });
126
+ }
127
+ }
128
+ function shouldKeepEndpointString(ctx, rawPath, start) {
129
+ const lineStart = ctx.sourceText.lastIndexOf("\n", start);
130
+ const linePrefix = ctx.sourceText.slice(lineStart + 1, start);
131
+ if (ctx.language === "python" &&
132
+ (/@(?:router|app)\.(?:get|post|put|patch|delete|route|api_route|websocket)\s*\([^)]*$/i.test(linePrefix) || isInsidePythonRouteDecorator(ctx.sourceText, start))) {
133
+ return false;
134
+ }
135
+ const window = ctx.sourceText.slice(Math.max(0, start - 140), Math.min(ctx.sourceText.length, start + 220));
136
+ if (/@(?:router|app)\.(?:get|post|put|patch|delete|route|api_route|websocket)\s*\(/.test(window)) {
137
+ return true;
138
+ }
139
+ if (ctx.test && /(?:client|api|request|fetch)\.(?:get|post|put|patch|delete)\s*\(|fetch\s*\(|\bapi(?:<[^>]+>)?\s*\(/i.test(window)) {
140
+ return true;
141
+ }
142
+ return /(?:fetch|apiFetch|request|axios|client\.(?:get|post|put|patch|delete)|http\.(?:get|post|put|patch|delete))\s*\(|\bapi(?:<[^>]+>)?\s*\(/i.test(window);
143
+ }
144
+ function isInsidePythonRouteDecorator(sourceText, start) {
145
+ const before = sourceText.slice(Math.max(0, start - 600), start);
146
+ const match = /@(?:router|app)\.(?:get|post|put|patch|delete|route|api_route|websocket)\s*\(/gi;
147
+ let last = null;
148
+ for (let next = match.exec(before); next; next = match.exec(before)) {
149
+ last = next;
150
+ }
151
+ if (!last) {
152
+ return false;
153
+ }
154
+ const tail = before.slice(last.index);
155
+ return tail.lastIndexOf("(") > tail.lastIndexOf(")");
156
+ }
157
+ function inferEndpointMethod(sourceText, start) {
158
+ const before = sourceText.slice(Math.max(0, start - 180), start);
159
+ const after = sourceText.slice(start, Math.min(sourceText.length, start + 240));
160
+ const afterLine = after.split(/\r?\n/, 1)[0] ?? after;
161
+ const callWindow = enclosingCallWindow(sourceText, start);
162
+ const decoratorMethod = /@(?:router|app)\.(get|post|put|patch|delete|websocket|api_route|route)\s*\([^@\n]*$/i.exec(before)?.[1];
163
+ if (decoratorMethod) {
164
+ if (/websocket/i.test(decoratorMethod)) {
165
+ return "WEBSOCKET";
166
+ }
167
+ if (/api_route|route/i.test(decoratorMethod)) {
168
+ const methods = /methods\s*=\s*\[([^\]]+)\]/i.exec(after)?.[1] ?? /methods\s*=\s*\[([^\]]+)\]/i.exec(before)?.[1];
169
+ const parsed = methods ? [...methods.matchAll(/["']([A-Za-z]+)["']/g)].map((match) => match[1].toUpperCase()) : [];
170
+ return parsed.length === 1 ? parsed[0] : "ANY";
171
+ }
172
+ return decoratorMethod.toUpperCase();
173
+ }
174
+ const clientMethod = /\.(get|post|put|patch|delete)\s*\([^.\n]*$/i.exec(before)?.[1];
175
+ if (clientMethod) {
176
+ return clientMethod.toUpperCase();
177
+ }
178
+ const explicitMethod = /method\s*:\s*["']([A-Za-z]+)["']/i.exec(callWindow)?.[1] ??
179
+ /method\s*:\s*["']([A-Za-z]+)["']/i.exec(afterLine)?.[1] ??
180
+ /method\s*:\s*["']([A-Za-z]+)["']/i.exec(before)?.[1];
181
+ if (explicitMethod) {
182
+ return explicitMethod.toUpperCase();
183
+ }
184
+ return /fetch\s*\([^)\n]*$/i.test(before) ? "GET" : "ANY";
185
+ }
186
+ function enclosingCallWindow(sourceText, start) {
187
+ const before = sourceText.slice(Math.max(0, start - 220), start);
188
+ const callPattern = /(?:fetch|apiFetch|request|axios|client\.(?:get|post|put|patch|delete)|http\.(?:get|post|put|patch|delete)|\bapi(?:<[^>]+>)?)\s*\(/gi;
189
+ let last = null;
190
+ for (let next = callPattern.exec(before); next; next = callPattern.exec(before)) {
191
+ last = next;
192
+ }
193
+ if (!last) {
194
+ return "";
195
+ }
196
+ const callStart = start - before.length + last.index;
197
+ return sourceText.slice(callStart, Math.min(sourceText.length, start + 800));
198
+ }
199
+ function endpointPathForReference(ctx, rawPath, start) {
200
+ const before = ctx.sourceText.slice(Math.max(0, start - 140), start);
201
+ const shouldPrefixApi = ctx.language !== "python" && !rawPath.startsWith("/api/") && /\bapi(?:<[^>]+>)?\s*\([^)\n]*$/i.test(before);
202
+ return normalizeEndpointPath(shouldPrefixApi ? `/api${rawPath}` : rawPath);
203
+ }
204
+ //# sourceMappingURL=references.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"references.js","sourceRoot":"","sources":["../../src/parser/references.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { ExtractContext } from "./context.js";
2
+ export declare function addCommonRisks(ctx: ExtractContext): void;
3
+ export declare function addPatternRisks(ctx: ExtractContext): void;
4
+ export declare function addPlaceholderRisks(ctx: ExtractContext): void;
@@ -0,0 +1,62 @@
1
+ import { isPublicSurfacePath } from "../language.js";
2
+ import { detectPlaceholderRisks } from "../placeholder-signals.js";
3
+ import { CODE_PATTERN_RULES } from "../rules.js";
4
+ import { patternRiskFact, riskFact } from "./facts.js";
5
+ export function addCommonRisks(ctx) {
6
+ if (isPublicSurfacePath(ctx.path)) {
7
+ ctx.risks.push(riskFact(ctx, undefined, "public-surface", 2, "entrypoint, API, adapter, package, or index file"));
8
+ }
9
+ if (ctx.path.includes("/adapters/")) {
10
+ ctx.risks.push(riskFact(ctx, undefined, "adapter-runtime", 2, "adapter runtime boundary"));
11
+ }
12
+ if (ctx.path.includes("/packages/")) {
13
+ ctx.risks.push(riskFact(ctx, undefined, "package-manifest", 1.5, "package or node manifest"));
14
+ }
15
+ if (/^scripts\/(service|release|preview)-control\.sh$/.test(ctx.path) || ctx.path.endsWith(".service")) {
16
+ ctx.risks.push(riskFact(ctx, undefined, "operator-runtime", 2, "service or release control surface"));
17
+ }
18
+ if (ctx.path.includes("migration") || ctx.path.includes("config") || ctx.path.endsWith(".service")) {
19
+ ctx.risks.push(riskFact(ctx, undefined, "config-or-migration", 1.5, "configuration or migration-like path"));
20
+ }
21
+ if (ctx.test) {
22
+ ctx.risks.push(riskFact(ctx, undefined, "test-file", 0.5, "test file"));
23
+ }
24
+ }
25
+ export function addPatternRisks(ctx) {
26
+ const seen = new Set();
27
+ for (const rule of CODE_PATTERN_RULES) {
28
+ if (rule.languages && !rule.languages.includes(ctx.language)) {
29
+ continue;
30
+ }
31
+ if (rule.path && !rule.path.test(ctx.path)) {
32
+ continue;
33
+ }
34
+ const flags = rule.pattern.flags.includes("g") ? rule.pattern.flags : `${rule.pattern.flags}g`;
35
+ const pattern = new RegExp(rule.pattern.source, flags);
36
+ let count = 0;
37
+ for (const match of ctx.sourceText.matchAll(pattern)) {
38
+ const start = match.index ?? 0;
39
+ const key = `${rule.id}:${start}`;
40
+ if (seen.has(key)) {
41
+ continue;
42
+ }
43
+ seen.add(key);
44
+ ctx.risks.push(patternRiskFact(ctx, rule.id, rule.score, rule.reason, start, start + match[0].length));
45
+ count += 1;
46
+ if (count >= 5) {
47
+ break;
48
+ }
49
+ }
50
+ }
51
+ }
52
+ export function addPlaceholderRisks(ctx) {
53
+ ctx.risks.push(...detectPlaceholderRisks({
54
+ path: ctx.path,
55
+ language: ctx.language,
56
+ sourceText: ctx.sourceText,
57
+ snapshotId: ctx.snapshotId,
58
+ indexedAt: ctx.indexedAt,
59
+ test: ctx.test
60
+ }));
61
+ }
62
+ //# sourceMappingURL=risks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"risks.js","sourceRoot":"","sources":["../../src/parser/risks.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ export declare function isRouteDecorator(decorator: string): boolean;
2
+ export declare function isTaskDecorator(decorator: string): boolean;
3
+ export declare function decoratorName(decorator: string): string;
4
+ export declare function routeEndpointsFromDecorator(decorator: string): string[];
5
+ export declare function normalizeEndpointPath(value: string): string;