@duckmind/dm-darwin-x64 0.67.2 → 0.67.4

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 (606) hide show
  1. package/README.md +2 -2
  2. package/dm +1 -1
  3. package/extensions/.dm-extensions.json +613 -15
  4. package/extensions/dm-lens/clients/dispatch/runners/utils/runner-helpers.js +1 -1
  5. package/extensions/dm-lens/dist/clients/actionable-warnings-logger.js +24 -0
  6. package/extensions/dm-lens/dist/clients/actionable-warnings.js +1066 -0
  7. package/extensions/dm-lens/dist/clients/advisory-provenance.js +388 -0
  8. package/extensions/dm-lens/dist/clients/agent-behavior-client.js +94 -0
  9. package/extensions/dm-lens/dist/clients/agent-nudge.js +253 -0
  10. package/extensions/dm-lens/dist/clients/analysed-root.js +1 -0
  11. package/extensions/dm-lens/dist/clients/analysis-root.js +133 -0
  12. package/extensions/dm-lens/dist/clients/ast-grep-client.js +587 -0
  13. package/extensions/dm-lens/dist/clients/ast-grep-rule-manager.js +137 -0
  14. package/extensions/dm-lens/dist/clients/ast-grep-tool-logger.js +85 -0
  15. package/extensions/dm-lens/dist/clients/ast-grep-types.js +1 -0
  16. package/extensions/dm-lens/dist/clients/ast-grep-yaml-synth.js +109 -0
  17. package/extensions/dm-lens/dist/clients/atomic-write-staging.js +66 -0
  18. package/extensions/dm-lens/dist/clients/atomic-write.js +37 -0
  19. package/extensions/dm-lens/dist/clients/availability-probe-flight.js +11 -0
  20. package/extensions/dm-lens/dist/clients/bash-file-access.js +1257 -0
  21. package/extensions/dm-lens/dist/clients/biome-client.js +223 -0
  22. package/extensions/dm-lens/dist/clients/blocker-freshness.js +553 -0
  23. package/extensions/dm-lens/dist/clients/blocker-past-eof.js +51 -0
  24. package/extensions/dm-lens/dist/clients/bootstrap.js +246 -0
  25. package/extensions/dm-lens/dist/clients/bounded-cache.js +105 -0
  26. package/extensions/dm-lens/dist/clients/bounded-pid-file-lock.js +275 -0
  27. package/extensions/dm-lens/dist/clients/bounded-telemetry.js +110 -0
  28. package/extensions/dm-lens/dist/clients/build-identity.js +45 -0
  29. package/extensions/dm-lens/dist/clients/bundled-resource-health.js +41 -0
  30. package/extensions/dm-lens/dist/clients/bus-events-logger.js +48 -0
  31. package/extensions/dm-lens/dist/clients/bus-publish.js +117 -0
  32. package/extensions/dm-lens/dist/clients/cache/rule-cache.js +87 -0
  33. package/extensions/dm-lens/dist/clients/cache-manager.js +449 -0
  34. package/extensions/dm-lens/dist/clients/cache-observability.js +1105 -0
  35. package/extensions/dm-lens/dist/clients/call-graph.js +628 -0
  36. package/extensions/dm-lens/dist/clients/cargo-manifest.js +167 -0
  37. package/extensions/dm-lens/dist/clients/cascade-budget.js +52 -0
  38. package/extensions/dm-lens/dist/clients/cascade-format.js +301 -0
  39. package/extensions/dm-lens/dist/clients/cascade-logger.js +22 -0
  40. package/extensions/dm-lens/dist/clients/cascade-types.js +1 -0
  41. package/extensions/dm-lens/dist/clients/child-unref.js +59 -0
  42. package/extensions/dm-lens/dist/clients/code-quality-warnings.js +192 -0
  43. package/extensions/dm-lens/dist/clients/codebase-model.js +110 -0
  44. package/extensions/dm-lens/dist/clients/collateral-test-role.js +8 -0
  45. package/extensions/dm-lens/dist/clients/complexity-client.js +398 -0
  46. package/extensions/dm-lens/dist/clients/config-core/deny.js +117 -0
  47. package/extensions/dm-lens/dist/clients/config-core/index.js +2 -0
  48. package/extensions/dm-lens/dist/clients/config-core/merge.js +228 -0
  49. package/extensions/dm-lens/dist/clients/config-core/normalize.js +226 -0
  50. package/extensions/dm-lens/dist/clients/config-core/process-spec.js +147 -0
  51. package/extensions/dm-lens/dist/clients/config-core/provenance.js +54 -0
  52. package/extensions/dm-lens/dist/clients/config-core/records.js +79 -0
  53. package/extensions/dm-lens/dist/clients/config-core/resolve.js +48 -0
  54. package/extensions/dm-lens/dist/clients/config-core/safe-object.js +22 -0
  55. package/extensions/dm-lens/dist/clients/config-core/schema.js +93 -0
  56. package/extensions/dm-lens/dist/clients/config-diagnostic-codes.js +90 -0
  57. package/extensions/dm-lens/dist/clients/config-locations.js +169 -0
  58. package/extensions/dm-lens/dist/clients/config-resolve.js +359 -0
  59. package/extensions/dm-lens/dist/clients/config-schema.js +230 -0
  60. package/extensions/dm-lens/dist/clients/config-warn.js +146 -0
  61. package/extensions/dm-lens/dist/clients/confirmed-delete.js +11 -0
  62. package/extensions/dm-lens/dist/clients/console-guard-install.js +4 -0
  63. package/extensions/dm-lens/dist/clients/content-stamp.js +16 -0
  64. package/extensions/dm-lens/dist/clients/context-injection-ledger.js +157 -0
  65. package/extensions/dm-lens/dist/clients/cooperative-budget.js +36 -0
  66. package/extensions/dm-lens/dist/clients/custom-rule-locations.js +28 -0
  67. package/extensions/dm-lens/dist/clients/dead-code-client.js +408 -0
  68. package/extensions/dm-lens/dist/clients/dead-code-logger.js +18 -0
  69. package/extensions/dm-lens/dist/clients/deadline-utils.js +117 -0
  70. package/extensions/dm-lens/dist/clients/debug-handles.js +121 -0
  71. package/extensions/dm-lens/dist/clients/debug-heap.js +80 -0
  72. package/extensions/dm-lens/dist/clients/deferred-lsp-work.js +33 -0
  73. package/extensions/dm-lens/dist/clients/deferred-runner-blockers.js +146 -0
  74. package/extensions/dm-lens/dist/clients/deferred-test-targets.js +31 -0
  75. package/extensions/dm-lens/dist/clients/degradation-ledger.js +306 -0
  76. package/extensions/dm-lens/dist/clients/demoted-finding-render.js +64 -0
  77. package/extensions/dm-lens/dist/clients/dependency-checker.js +534 -0
  78. package/extensions/dm-lens/dist/clients/deps/ast-grep-napi.js +27 -0
  79. package/extensions/dm-lens/dist/clients/deps/dm-host-deps.js +10 -0
  80. package/extensions/dm-lens/dist/clients/deps/dm-tui-compat.js +58 -0
  81. package/extensions/dm-lens/dist/clients/deps/js-yaml.js +7 -0
  82. package/extensions/dm-lens/dist/clients/deps/minimatch.js +6 -0
  83. package/extensions/dm-lens/dist/clients/deps/pidusage.js +5 -0
  84. package/extensions/dm-lens/dist/clients/deps/typebox.js +5 -0
  85. package/extensions/dm-lens/dist/clients/deps/vscode-jsonrpc.js +8 -0
  86. package/extensions/dm-lens/dist/clients/deps/web-tree-sitter.js +11 -0
  87. package/extensions/dm-lens/dist/clients/diagnostic-dispositions.js +334 -0
  88. package/extensions/dm-lens/dist/clients/diagnostic-line-freshness.js +142 -0
  89. package/extensions/dm-lens/dist/clients/diagnostic-logger.js +60 -0
  90. package/extensions/dm-lens/dist/clients/diagnostic-tracker.js +89 -0
  91. package/extensions/dm-lens/dist/clients/diagnostics-publish.js +134 -0
  92. package/extensions/dm-lens/dist/clients/disk-change-consumers.js +312 -0
  93. package/extensions/dm-lens/dist/clients/disk-change-subscribers.js +191 -0
  94. package/extensions/dm-lens/dist/clients/disk-changes.js +165 -0
  95. package/extensions/dm-lens/dist/clients/dispatch/adopted-root-runners.js +22 -0
  96. package/extensions/dm-lens/dist/clients/dispatch/ast-grep-catalog.js +16 -0
  97. package/extensions/dm-lens/dist/clients/dispatch/auxiliary-lsp.js +162 -0
  98. package/extensions/dm-lens/dist/clients/dispatch/collect-later-tier.js +25 -0
  99. package/extensions/dm-lens/dist/clients/dispatch/diagnostic-taxonomy.js +58 -0
  100. package/extensions/dm-lens/dist/clients/dispatch/dispatcher.js +1240 -0
  101. package/extensions/dm-lens/dist/clients/dispatch/fact-provider-types.js +1 -0
  102. package/extensions/dm-lens/dist/clients/dispatch/fact-rule-runner.js +17 -0
  103. package/extensions/dm-lens/dist/clients/dispatch/fact-runner.js +18 -0
  104. package/extensions/dm-lens/dist/clients/dispatch/fact-scheduler.js +52 -0
  105. package/extensions/dm-lens/dist/clients/dispatch/fact-store.js +193 -0
  106. package/extensions/dm-lens/dist/clients/dispatch/facts/comment-facts.js +23 -0
  107. package/extensions/dm-lens/dist/clients/dispatch/facts/file-content.js +18 -0
  108. package/extensions/dm-lens/dist/clients/dispatch/facts/function-facts.js +274 -0
  109. package/extensions/dm-lens/dist/clients/dispatch/facts/import-facts.js +169 -0
  110. package/extensions/dm-lens/dist/clients/dispatch/facts/tree-sitter-facts.js +19 -0
  111. package/extensions/dm-lens/dist/clients/dispatch/facts/try-catch-facts.js +95 -0
  112. package/extensions/dm-lens/dist/clients/dispatch/finding-policy.js +188 -0
  113. package/extensions/dm-lens/dist/clients/dispatch/indent-detect.js +227 -0
  114. package/extensions/dm-lens/dist/clients/dispatch/inline-suppressions.js +52 -0
  115. package/extensions/dm-lens/dist/clients/dispatch/integration.js +1698 -0
  116. package/extensions/dm-lens/dist/clients/dispatch/known-runner-ids.js +13 -0
  117. package/extensions/dm-lens/dist/clients/dispatch/lane-copies.js +23 -0
  118. package/extensions/dm-lens/dist/clients/dispatch/lazy.js +8 -0
  119. package/extensions/dm-lens/dist/clients/dispatch/pending-runner-findings.js +133 -0
  120. package/extensions/dm-lens/dist/clients/dispatch/plan.js +284 -0
  121. package/extensions/dm-lens/dist/clients/dispatch/pre-edit-seed.js +57 -0
  122. package/extensions/dm-lens/dist/clients/dispatch/priorities.js +14 -0
  123. package/extensions/dm-lens/dist/clients/dispatch/rule-id-normalize.js +54 -0
  124. package/extensions/dm-lens/dist/clients/dispatch/rule-ignores.js +21 -0
  125. package/extensions/dm-lens/dist/clients/dispatch/rule-policy.js +102 -0
  126. package/extensions/dm-lens/dist/clients/dispatch/rules/async-noise.js +31 -0
  127. package/extensions/dm-lens/dist/clients/dispatch/rules/async-unnecessary-wrapper.js +27 -0
  128. package/extensions/dm-lens/dist/clients/dispatch/rules/cors-wildcard.js +35 -0
  129. package/extensions/dm-lens/dist/clients/dispatch/rules/error-obscuring.js +29 -0
  130. package/extensions/dm-lens/dist/clients/dispatch/rules/error-swallowing.js +29 -0
  131. package/extensions/dm-lens/dist/clients/dispatch/rules/framework-call-noise.js +31 -0
  132. package/extensions/dm-lens/dist/clients/dispatch/rules/high-complexity.js +41 -0
  133. package/extensions/dm-lens/dist/clients/dispatch/rules/high-fan-out.js +37 -0
  134. package/extensions/dm-lens/dist/clients/dispatch/rules/high-import-coupling.js +31 -0
  135. package/extensions/dm-lens/dist/clients/dispatch/rules/missing-error-propagation.js +45 -0
  136. package/extensions/dm-lens/dist/clients/dispatch/rules/no-commented-credentials.js +46 -0
  137. package/extensions/dm-lens/dist/clients/dispatch/rules/pass-through-wrappers.js +38 -0
  138. package/extensions/dm-lens/dist/clients/dispatch/rules/placeholder-comments.js +40 -0
  139. package/extensions/dm-lens/dist/clients/dispatch/rules/unsafe-boundary.js +101 -0
  140. package/extensions/dm-lens/dist/clients/dispatch/runner-context.js +41 -0
  141. package/extensions/dm-lens/dist/clients/dispatch/runners/actionlint.js +98 -0
  142. package/extensions/dm-lens/dist/clients/dispatch/runners/ast-grep-literal-anchors.js +58 -0
  143. package/extensions/dm-lens/dist/clients/dispatch/runners/ast-grep-napi.js +739 -0
  144. package/extensions/dm-lens/dist/clients/dispatch/runners/biome-check.js +196 -0
  145. package/extensions/dm-lens/dist/clients/dispatch/runners/cpp-check.js +190 -0
  146. package/extensions/dm-lens/dist/clients/dispatch/runners/credo.js +66 -0
  147. package/extensions/dm-lens/dist/clients/dispatch/runners/cue-vet.js +161 -0
  148. package/extensions/dm-lens/dist/clients/dispatch/runners/dart-analyze.js +151 -0
  149. package/extensions/dm-lens/dist/clients/dispatch/runners/detekt.js +158 -0
  150. package/extensions/dm-lens/dist/clients/dispatch/runners/dotnet-build.js +163 -0
  151. package/extensions/dm-lens/dist/clients/dispatch/runners/elixir-check.js +153 -0
  152. package/extensions/dm-lens/dist/clients/dispatch/runners/eslint.js +99 -0
  153. package/extensions/dm-lens/dist/clients/dispatch/runners/fact-rules.js +20 -0
  154. package/extensions/dm-lens/dist/clients/dispatch/runners/fish-indent.js +120 -0
  155. package/extensions/dm-lens/dist/clients/dispatch/runners/gleam-check.js +100 -0
  156. package/extensions/dm-lens/dist/clients/dispatch/runners/go-vet.js +52 -0
  157. package/extensions/dm-lens/dist/clients/dispatch/runners/golangci-lint.js +105 -0
  158. package/extensions/dm-lens/dist/clients/dispatch/runners/hadolint.js +83 -0
  159. package/extensions/dm-lens/dist/clients/dispatch/runners/helm-lint.js +147 -0
  160. package/extensions/dm-lens/dist/clients/dispatch/runners/helm-render.js +593 -0
  161. package/extensions/dm-lens/dist/clients/dispatch/runners/htmlhint.js +103 -0
  162. package/extensions/dm-lens/dist/clients/dispatch/runners/index.js +100 -0
  163. package/extensions/dm-lens/dist/clients/dispatch/runners/javac.js +82 -0
  164. package/extensions/dm-lens/dist/clients/dispatch/runners/ktlint.js +115 -0
  165. package/extensions/dm-lens/dist/clients/dispatch/runners/lsp.js +275 -0
  166. package/extensions/dm-lens/dist/clients/dispatch/runners/markdownlint.js +129 -0
  167. package/extensions/dm-lens/dist/clients/dispatch/runners/mypy.js +70 -0
  168. package/extensions/dm-lens/dist/clients/dispatch/runners/oxlint.js +296 -0
  169. package/extensions/dm-lens/dist/clients/dispatch/runners/php-lint.js +66 -0
  170. package/extensions/dm-lens/dist/clients/dispatch/runners/phpstan.js +90 -0
  171. package/extensions/dm-lens/dist/clients/dispatch/runners/prisma-validate.js +66 -0
  172. package/extensions/dm-lens/dist/clients/dispatch/runners/psscriptanalyzer.js +307 -0
  173. package/extensions/dm-lens/dist/clients/dispatch/runners/pyright.js +118 -0
  174. package/extensions/dm-lens/dist/clients/dispatch/runners/rubocop.js +79 -0
  175. package/extensions/dm-lens/dist/clients/dispatch/runners/ruff.js +69 -0
  176. package/extensions/dm-lens/dist/clients/dispatch/runners/rust-clippy.js +166 -0
  177. package/extensions/dm-lens/dist/clients/dispatch/runners/shellcheck.js +168 -0
  178. package/extensions/dm-lens/dist/clients/dispatch/runners/shfmt.js +92 -0
  179. package/extensions/dm-lens/dist/clients/dispatch/runners/spellcheck.js +74 -0
  180. package/extensions/dm-lens/dist/clients/dispatch/runners/spotbugs.js +208 -0
  181. package/extensions/dm-lens/dist/clients/dispatch/runners/sqlfluff.js +136 -0
  182. package/extensions/dm-lens/dist/clients/dispatch/runners/stylelint.js +118 -0
  183. package/extensions/dm-lens/dist/clients/dispatch/runners/swiftlint.js +143 -0
  184. package/extensions/dm-lens/dist/clients/dispatch/runners/taplo.js +109 -0
  185. package/extensions/dm-lens/dist/clients/dispatch/runners/terragrunt.js +110 -0
  186. package/extensions/dm-lens/dist/clients/dispatch/runners/tflint.js +104 -0
  187. package/extensions/dm-lens/dist/clients/dispatch/runners/tree-sitter.js +534 -0
  188. package/extensions/dm-lens/dist/clients/dispatch/runners/trivy-config.js +155 -0
  189. package/extensions/dm-lens/dist/clients/dispatch/runners/utils/availability-policy.js +313 -0
  190. package/extensions/dm-lens/dist/clients/dispatch/runners/utils/candidate-probe.js +66 -0
  191. package/extensions/dm-lens/dist/clients/dispatch/runners/utils/diagnostic-parsers.js +62 -0
  192. package/extensions/dm-lens/dist/clients/dispatch/runners/utils/lazy-installer.js +130 -0
  193. package/extensions/dm-lens/dist/clients/dispatch/runners/utils/runner-helpers.js +1143 -0
  194. package/extensions/dm-lens/dist/clients/dispatch/runners/utils/spawn-outcome.js +40 -0
  195. package/extensions/dm-lens/dist/clients/dispatch/runners/utils/tool-failure.js +110 -0
  196. package/extensions/dm-lens/dist/clients/dispatch/runners/utils/toolchain-availability.js +88 -0
  197. package/extensions/dm-lens/dist/clients/dispatch/runners/utils.js +8 -0
  198. package/extensions/dm-lens/dist/clients/dispatch/runners/vale.js +92 -0
  199. package/extensions/dm-lens/dist/clients/dispatch/runners/yaml-rule-parser.js +170 -0
  200. package/extensions/dm-lens/dist/clients/dispatch/runners/yamllint.js +83 -0
  201. package/extensions/dm-lens/dist/clients/dispatch/runners/zig-check.js +72 -0
  202. package/extensions/dm-lens/dist/clients/dispatch/suppress-writer.js +57 -0
  203. package/extensions/dm-lens/dist/clients/dispatch/tool-profile.js +30 -0
  204. package/extensions/dm-lens/dist/clients/dispatch/types.js +72 -0
  205. package/extensions/dm-lens/dist/clients/dispatch/utils/format-utils.js +58 -0
  206. package/extensions/dm-lens/dist/clients/dispatch/utils/lsp-diagnostics.js +32 -0
  207. package/extensions/dm-lens/dist/clients/disposition-logger.js +19 -0
  208. package/extensions/dm-lens/dist/clients/disposition-publish.js +88 -0
  209. package/extensions/dm-lens/dist/clients/durable-store.js +77 -0
  210. package/extensions/dm-lens/dist/clients/effective-config.js +170 -0
  211. package/extensions/dm-lens/dist/clients/env-utils.js +26 -0
  212. package/extensions/dm-lens/dist/clients/ephemeral-root.js +55 -0
  213. package/extensions/dm-lens/dist/clients/error-class.js +3 -0
  214. package/extensions/dm-lens/dist/clients/eval-timestamp.js +2 -0
  215. package/extensions/dm-lens/dist/clients/event-loop-hold.js +119 -0
  216. package/extensions/dm-lens/dist/clients/event-loop-monitor.js +84 -0
  217. package/extensions/dm-lens/dist/clients/extension-log.js +230 -0
  218. package/extensions/dm-lens/dist/clients/extension-mode.js +20 -0
  219. package/extensions/dm-lens/dist/clients/feature-hints.js +88 -0
  220. package/extensions/dm-lens/dist/clients/file-kinds.js +317 -0
  221. package/extensions/dm-lens/dist/clients/file-mutation-queue.js +91 -0
  222. package/extensions/dm-lens/dist/clients/file-role.js +50 -0
  223. package/extensions/dm-lens/dist/clients/file-time.js +112 -0
  224. package/extensions/dm-lens/dist/clients/file-utils.js +840 -0
  225. package/extensions/dm-lens/dist/clients/finding-delivery-gate.js +146 -0
  226. package/extensions/dm-lens/dist/clients/finding-identity.js +79 -0
  227. package/extensions/dm-lens/dist/clients/fix-run-restore.js +423 -0
  228. package/extensions/dm-lens/dist/clients/fix-worklog.js +75 -0
  229. package/extensions/dm-lens/dist/clients/format-events-publish.js +310 -0
  230. package/extensions/dm-lens/dist/clients/format-service.js +177 -0
  231. package/extensions/dm-lens/dist/clients/formatters-lazy.js +8 -0
  232. package/extensions/dm-lens/dist/clients/formatters.js +1367 -0
  233. package/extensions/dm-lens/dist/clients/freshness-cadence.js +1 -0
  234. package/extensions/dm-lens/dist/clients/freshness.js +8 -0
  235. package/extensions/dm-lens/dist/clients/generated-artifacts.js +209 -0
  236. package/extensions/dm-lens/dist/clients/generation-guard.js +147 -0
  237. package/extensions/dm-lens/dist/clients/generation-lock.js +181 -0
  238. package/extensions/dm-lens/dist/clients/git-guard.js +1208 -0
  239. package/extensions/dm-lens/dist/clients/git-tracked-ignore.js +120 -0
  240. package/extensions/dm-lens/dist/clients/gitleaks-client.js +290 -0
  241. package/extensions/dm-lens/dist/clients/go-client.js +47 -0
  242. package/extensions/dm-lens/dist/clients/govulncheck-client.js +416 -0
  243. package/extensions/dm-lens/dist/clients/gradle-ktfmt-style.js +177 -0
  244. package/extensions/dm-lens/dist/clients/grammar-source.js +263 -0
  245. package/extensions/dm-lens/dist/clients/grammar-wasm-imports.js +48 -0
  246. package/extensions/dm-lens/dist/clients/gzip-stage-write.js +174 -0
  247. package/extensions/dm-lens/dist/clients/hard-failure-summary.js +28 -0
  248. package/extensions/dm-lens/dist/clients/hashline-anchor.js +222 -0
  249. package/extensions/dm-lens/dist/clients/hook-budgets.js +17 -0
  250. package/extensions/dm-lens/dist/clients/host-edit-normalize.js +87 -0
  251. package/extensions/dm-lens/dist/clients/host-ports.js +35 -0
  252. package/extensions/dm-lens/dist/clients/indent-retarget.js +102 -0
  253. package/extensions/dm-lens/dist/clients/inline-blocker-dispositions.js +103 -0
  254. package/extensions/dm-lens/dist/clients/inline-blocker-fields.js +8 -0
  255. package/extensions/dm-lens/dist/clients/install-diagnostics.js +135 -0
  256. package/extensions/dm-lens/dist/clients/installer/index.js +3928 -0
  257. package/extensions/dm-lens/dist/clients/installer/managed-tool-refresh-session.js +17 -0
  258. package/extensions/dm-lens/dist/clients/installer/managed-tool-refresh.js +721 -0
  259. package/extensions/dm-lens/dist/clients/instance-reaper-state.js +3 -0
  260. package/extensions/dm-lens/dist/clients/instance-reaper.js +693 -0
  261. package/extensions/dm-lens/dist/clients/instance-registry-lock.js +166 -0
  262. package/extensions/dm-lens/dist/clients/instance-registry-tail.js +17 -0
  263. package/extensions/dm-lens/dist/clients/instance-registry.js +607 -0
  264. package/extensions/dm-lens/dist/clients/io-bridge-contract.js +7 -0
  265. package/extensions/dm-lens/dist/clients/io-bridge.js +357 -0
  266. package/extensions/dm-lens/dist/clients/jscpd-client.js +311 -0
  267. package/extensions/dm-lens/dist/clients/json-cache-read.js +25 -0
  268. package/extensions/dm-lens/dist/clients/knip-client.js +534 -0
  269. package/extensions/dm-lens/dist/clients/knip-scan-roots.js +26 -0
  270. package/extensions/dm-lens/dist/clients/language-policy.js +244 -0
  271. package/extensions/dm-lens/dist/clients/language-profile.js +259 -0
  272. package/extensions/dm-lens/dist/clients/language-registry.js +468 -0
  273. package/extensions/dm-lens/dist/clients/latency-logger.js +210 -0
  274. package/extensions/dm-lens/dist/clients/lazy-import.js +14 -0
  275. package/extensions/dm-lens/dist/clients/ledger-bounds.js +21 -0
  276. package/extensions/dm-lens/dist/clients/lens-config.js +254 -0
  277. package/extensions/dm-lens/dist/clients/lens-engine.js +188 -0
  278. package/extensions/dm-lens/dist/clients/lens-events.js +105 -0
  279. package/extensions/dm-lens/dist/clients/lens-flag-registry.js +308 -0
  280. package/extensions/dm-lens/dist/clients/lens-map.js +980 -0
  281. package/extensions/dm-lens/dist/clients/line-alignment.js +200 -0
  282. package/extensions/dm-lens/dist/clients/live-bus-emitter.js +53 -0
  283. package/extensions/dm-lens/dist/clients/log-cleanup.js +138 -0
  284. package/extensions/dm-lens/dist/clients/lsp/aggregation.js +89 -0
  285. package/extensions/dm-lens/dist/clients/lsp/auxiliary-lifecycle.js +23 -0
  286. package/extensions/dm-lens/dist/clients/lsp/capabilities.js +94 -0
  287. package/extensions/dm-lens/dist/clients/lsp/cascade-tier.js +318 -0
  288. package/extensions/dm-lens/dist/clients/lsp/client-registry.js +877 -0
  289. package/extensions/dm-lens/dist/clients/lsp/client.js +3232 -0
  290. package/extensions/dm-lens/dist/clients/lsp/config.js +571 -0
  291. package/extensions/dm-lens/dist/clients/lsp/content-limits.js +21 -0
  292. package/extensions/dm-lens/dist/clients/lsp/content-scan.js +69 -0
  293. package/extensions/dm-lens/dist/clients/lsp/created-import-targets.js +134 -0
  294. package/extensions/dm-lens/dist/clients/lsp/diagnostic-binding.js +113 -0
  295. package/extensions/dm-lens/dist/clients/lsp/document-drift.js +372 -0
  296. package/extensions/dm-lens/dist/clients/lsp/edits.js +1060 -0
  297. package/extensions/dm-lens/dist/clients/lsp/environment-gap.js +186 -0
  298. package/extensions/dm-lens/dist/clients/lsp/file-server-match.js +26 -0
  299. package/extensions/dm-lens/dist/clients/lsp/grouping.js +38 -0
  300. package/extensions/dm-lens/dist/clients/lsp/implicit-scope.js +205 -0
  301. package/extensions/dm-lens/dist/clients/lsp/index.js +4292 -0
  302. package/extensions/dm-lens/dist/clients/lsp/inferred-project.js +140 -0
  303. package/extensions/dm-lens/dist/clients/lsp/jvm-runtime.js +200 -0
  304. package/extensions/dm-lens/dist/clients/lsp/language.js +26 -0
  305. package/extensions/dm-lens/dist/clients/lsp/launch.js +606 -0
  306. package/extensions/dm-lens/dist/clients/lsp/lombok.js +133 -0
  307. package/extensions/dm-lens/dist/clients/lsp/path-utils.js +1 -0
  308. package/extensions/dm-lens/dist/clients/lsp/pending-aux-coverage.js +120 -0
  309. package/extensions/dm-lens/dist/clients/lsp/position-encoding.js +21 -0
  310. package/extensions/dm-lens/dist/clients/lsp/resolved-config.js +183 -0
  311. package/extensions/dm-lens/dist/clients/lsp/ruby-drive-dirs.js +42 -0
  312. package/extensions/dm-lens/dist/clients/lsp/server-config-files.js +11 -0
  313. package/extensions/dm-lens/dist/clients/lsp/server-covers.js +8 -0
  314. package/extensions/dm-lens/dist/clients/lsp/server-traits.js +45 -0
  315. package/extensions/dm-lens/dist/clients/lsp/server.js +2827 -0
  316. package/extensions/dm-lens/dist/clients/lsp/service-singleton.js +59 -0
  317. package/extensions/dm-lens/dist/clients/lsp/session-roots.js +83 -0
  318. package/extensions/dm-lens/dist/clients/lsp/spawn-history.js +15 -0
  319. package/extensions/dm-lens/dist/clients/lsp/sync-kind.js +30 -0
  320. package/extensions/dm-lens/dist/clients/lsp/tsserver-sync.js +156 -0
  321. package/extensions/dm-lens/dist/clients/lsp/wait-policy/capability-snapshot.js +1 -0
  322. package/extensions/dm-lens/dist/clients/lsp/wait-policy/classification.js +37 -0
  323. package/extensions/dm-lens/dist/clients/lsp/wait-policy/index.js +3 -0
  324. package/extensions/dm-lens/dist/clients/lsp/wait-policy/strategies.js +276 -0
  325. package/extensions/dm-lens/dist/clients/lsp/watch-queue.js +61 -0
  326. package/extensions/dm-lens/dist/clients/lsp/workspace-diagnostics-cache.js +395 -0
  327. package/extensions/dm-lens/dist/clients/lsp/workspace-diagnostics-session.js +42 -0
  328. package/extensions/dm-lens/dist/clients/lsp/workspace-sweep-hold.js +93 -0
  329. package/extensions/dm-lens/dist/clients/lsp-budget.js +87 -0
  330. package/extensions/dm-lens/dist/clients/lsp-document-symbols.js +93 -0
  331. package/extensions/dm-lens/dist/clients/lsp-lazy.js +8 -0
  332. package/extensions/dm-lens/dist/clients/lsp-mutation.js +309 -0
  333. package/extensions/dm-lens/dist/clients/lsp-status.js +35 -0
  334. package/extensions/dm-lens/dist/clients/map-with-concurrency.js +20 -0
  335. package/extensions/dm-lens/dist/clients/mcp/analyze.js +302 -0
  336. package/extensions/dm-lens/dist/clients/mcp/host-shim.js +14 -0
  337. package/extensions/dm-lens/dist/clients/mcp/ipc.js +344 -0
  338. package/extensions/dm-lens/dist/clients/mcp/review.js +137 -0
  339. package/extensions/dm-lens/dist/clients/mcp/session.js +300 -0
  340. package/extensions/dm-lens/dist/clients/memory-sampler.js +163 -0
  341. package/extensions/dm-lens/dist/clients/message-end-attribution.js +18 -0
  342. package/extensions/dm-lens/dist/clients/metrics-client.js +80 -0
  343. package/extensions/dm-lens/dist/clients/metrics-history.js +242 -0
  344. package/extensions/dm-lens/dist/clients/middle-man-analysis.js +161 -0
  345. package/extensions/dm-lens/dist/clients/model-provider.js +31 -0
  346. package/extensions/dm-lens/dist/clients/module-report-lsp.js +140 -0
  347. package/extensions/dm-lens/dist/clients/module-report.js +1648 -0
  348. package/extensions/dm-lens/dist/clients/mutating-tool.js +388 -0
  349. package/extensions/dm-lens/dist/clients/mutation-attribution.js +173 -0
  350. package/extensions/dm-lens/dist/clients/mutation-bridge.js +231 -0
  351. package/extensions/dm-lens/dist/clients/ndjson-logger.js +504 -0
  352. package/extensions/dm-lens/dist/clients/observed-mutation-sources.js +43 -0
  353. package/extensions/dm-lens/dist/clients/observed-mutation.js +735 -0
  354. package/extensions/dm-lens/dist/clients/oldtext-autopatch.js +100 -0
  355. package/extensions/dm-lens/dist/clients/opaque-mutation-scan.js +541 -0
  356. package/extensions/dm-lens/dist/clients/opengrep-client.js +224 -0
  357. package/extensions/dm-lens/dist/clients/opengrep-config.js +57 -0
  358. package/extensions/dm-lens/dist/clients/opengrep-rule-pack.js +19 -0
  359. package/extensions/dm-lens/dist/clients/out-of-band-changes.js +329 -0
  360. package/extensions/dm-lens/dist/clients/package-manager.js +332 -0
  361. package/extensions/dm-lens/dist/clients/package-root.js +21 -0
  362. package/extensions/dm-lens/dist/clients/partial-edit-apply.js +341 -0
  363. package/extensions/dm-lens/dist/clients/path-attribution-telemetry.js +31 -0
  364. package/extensions/dm-lens/dist/clients/path-birth.js +58 -0
  365. package/extensions/dm-lens/dist/clients/path-keyed-map.js +57 -0
  366. package/extensions/dm-lens/dist/clients/path-utils.js +654 -0
  367. package/extensions/dm-lens/dist/clients/performance-report.js +291 -0
  368. package/extensions/dm-lens/dist/clients/persist-debounce.js +37 -0
  369. package/extensions/dm-lens/dist/clients/persist-worker-stats.js +16 -0
  370. package/extensions/dm-lens/dist/clients/persistent-reverify.js +167 -0
  371. package/extensions/dm-lens/dist/clients/php-cs-fixer-config.js +15 -0
  372. package/extensions/dm-lens/dist/clients/pipeline.js +1473 -0
  373. package/extensions/dm-lens/dist/clients/post-autofix-notice.js +19 -0
  374. package/extensions/dm-lens/dist/clients/print-mode.js +3 -0
  375. package/extensions/dm-lens/dist/clients/probe-home-state.js +73 -0
  376. package/extensions/dm-lens/dist/clients/process-bridge.js +48 -0
  377. package/extensions/dm-lens/dist/clients/process-singletons.js +69 -0
  378. package/extensions/dm-lens/dist/clients/process-snapshot.js +130 -0
  379. package/extensions/dm-lens/dist/clients/project-changes.js +180 -0
  380. package/extensions/dm-lens/dist/clients/project-conventions.js +152 -0
  381. package/extensions/dm-lens/dist/clients/project-diagnostics/cache.js +91 -0
  382. package/extensions/dm-lens/dist/clients/project-diagnostics/extractors.js +53 -0
  383. package/extensions/dm-lens/dist/clients/project-diagnostics/fresh-fetch.js +413 -0
  384. package/extensions/dm-lens/dist/clients/project-diagnostics/runner-adapters/call-graph-impact.js +64 -0
  385. package/extensions/dm-lens/dist/clients/project-diagnostics/runner-adapters/dead-code.js +38 -0
  386. package/extensions/dm-lens/dist/clients/project-diagnostics/runner-adapters/gitleaks.js +21 -0
  387. package/extensions/dm-lens/dist/clients/project-diagnostics/runner-adapters/govulncheck.js +23 -0
  388. package/extensions/dm-lens/dist/clients/project-diagnostics/runner-adapters/jscpd.js +28 -0
  389. package/extensions/dm-lens/dist/clients/project-diagnostics/runner-adapters/knip.js +45 -0
  390. package/extensions/dm-lens/dist/clients/project-diagnostics/runner-adapters/madge.js +34 -0
  391. package/extensions/dm-lens/dist/clients/project-diagnostics/runner-adapters/opengrep.js +32 -0
  392. package/extensions/dm-lens/dist/clients/project-diagnostics/runner-adapters/runner-findings.js +79 -0
  393. package/extensions/dm-lens/dist/clients/project-diagnostics/runner-adapters/trivy.js +41 -0
  394. package/extensions/dm-lens/dist/clients/project-diagnostics/scanner.js +351 -0
  395. package/extensions/dm-lens/dist/clients/project-diagnostics/types.js +1 -0
  396. package/extensions/dm-lens/dist/clients/project-lens-config.js +462 -0
  397. package/extensions/dm-lens/dist/clients/project-report.js +527 -0
  398. package/extensions/dm-lens/dist/clients/project-root-markers.js +8 -0
  399. package/extensions/dm-lens/dist/clients/project-scale.js +60 -0
  400. package/extensions/dm-lens/dist/clients/project-scan-policy.js +4 -0
  401. package/extensions/dm-lens/dist/clients/project-snapshot-fingerprint.js +44 -0
  402. package/extensions/dm-lens/dist/clients/project-snapshot-persist-worker.js +31 -0
  403. package/extensions/dm-lens/dist/clients/project-snapshot.js +1355 -0
  404. package/extensions/dm-lens/dist/clients/project-trust.js +104 -0
  405. package/extensions/dm-lens/dist/clients/python-environment.js +388 -0
  406. package/extensions/dm-lens/dist/clients/python-provenance.js +551 -0
  407. package/extensions/dm-lens/dist/clients/quiet-window-config.js +16 -0
  408. package/extensions/dm-lens/dist/clients/quiet-window.js +129 -0
  409. package/extensions/dm-lens/dist/clients/read-bridge.js +53 -0
  410. package/extensions/dm-lens/dist/clients/read-expansion.js +218 -0
  411. package/extensions/dm-lens/dist/clients/read-guard-branch.js +126 -0
  412. package/extensions/dm-lens/dist/clients/read-guard-logger.js +186 -0
  413. package/extensions/dm-lens/dist/clients/read-guard-tool-lines.js +1044 -0
  414. package/extensions/dm-lens/dist/clients/read-guard.js +1517 -0
  415. package/extensions/dm-lens/dist/clients/recent-touches.js +126 -0
  416. package/extensions/dm-lens/dist/clients/redact/secrets.js +386 -0
  417. package/extensions/dm-lens/dist/clients/resource-sampler.js +344 -0
  418. package/extensions/dm-lens/dist/clients/reverse-deps.js +227 -0
  419. package/extensions/dm-lens/dist/clients/review-graph/builder.js +3780 -0
  420. package/extensions/dm-lens/dist/clients/review-graph/format.js +30 -0
  421. package/extensions/dm-lens/dist/clients/review-graph/git-identity.js +173 -0
  422. package/extensions/dm-lens/dist/clients/review-graph/import-resolvers.js +332 -0
  423. package/extensions/dm-lens/dist/clients/review-graph/persist-worker.js +8 -0
  424. package/extensions/dm-lens/dist/clients/review-graph/query.js +195 -0
  425. package/extensions/dm-lens/dist/clients/review-graph/revision-drift.js +3 -0
  426. package/extensions/dm-lens/dist/clients/review-graph/service.js +60 -0
  427. package/extensions/dm-lens/dist/clients/review-graph/shared-extraction-ir.js +54 -0
  428. package/extensions/dm-lens/dist/clients/review-graph/symbol-id.js +29 -0
  429. package/extensions/dm-lens/dist/clients/review-graph/tsconfig-paths.js +286 -0
  430. package/extensions/dm-lens/dist/clients/review-graph/types.js +1 -0
  431. package/extensions/dm-lens/dist/clients/review-graph/workspace-modules.js +374 -0
  432. package/extensions/dm-lens/dist/clients/review-graph-logger.js +51 -0
  433. package/extensions/dm-lens/dist/clients/ruff-client.js +107 -0
  434. package/extensions/dm-lens/dist/clients/rules-scanner.js +70 -0
  435. package/extensions/dm-lens/dist/clients/run-duration.js +9 -0
  436. package/extensions/dm-lens/dist/clients/runtime-agent-end.js +831 -0
  437. package/extensions/dm-lens/dist/clients/runtime-config.js +39 -0
  438. package/extensions/dm-lens/dist/clients/runtime-context.js +155 -0
  439. package/extensions/dm-lens/dist/clients/runtime-coordinator.js +1254 -0
  440. package/extensions/dm-lens/dist/clients/runtime-session.js +1806 -0
  441. package/extensions/dm-lens/dist/clients/runtime-tool-call.js +1026 -0
  442. package/extensions/dm-lens/dist/clients/runtime-tool-result.js +2068 -0
  443. package/extensions/dm-lens/dist/clients/runtime-turn.js +3198 -0
  444. package/extensions/dm-lens/dist/clients/rust-client.js +46 -0
  445. package/extensions/dm-lens/dist/clients/safe-spawn.js +1402 -0
  446. package/extensions/dm-lens/dist/clients/sanitize.js +5 -0
  447. package/extensions/dm-lens/dist/clients/scan-utils.js +7 -0
  448. package/extensions/dm-lens/dist/clients/scanner-temp-root.js +8 -0
  449. package/extensions/dm-lens/dist/clients/scratch-tree-policy.js +63 -0
  450. package/extensions/dm-lens/dist/clients/search-read-registration.js +76 -0
  451. package/extensions/dm-lens/dist/clients/secret-findings.js +69 -0
  452. package/extensions/dm-lens/dist/clients/security-scan-client.js +208 -0
  453. package/extensions/dm-lens/dist/clients/session-event-guard.js +111 -0
  454. package/extensions/dm-lens/dist/clients/session-lifecycle.js +309 -0
  455. package/extensions/dm-lens/dist/clients/session-repository.js +113 -0
  456. package/extensions/dm-lens/dist/clients/session-scope.js +451 -0
  457. package/extensions/dm-lens/dist/clients/session-start-observability.js +59 -0
  458. package/extensions/dm-lens/dist/clients/session-state-store.js +71 -0
  459. package/extensions/dm-lens/dist/clients/session-summary.js +8 -0
  460. package/extensions/dm-lens/dist/clients/sessionstart-logger.js +22 -0
  461. package/extensions/dm-lens/dist/clients/sg-runner.js +642 -0
  462. package/extensions/dm-lens/dist/clients/sgconfig.js +299 -0
  463. package/extensions/dm-lens/dist/clients/shared-checkout-guard.js +177 -0
  464. package/extensions/dm-lens/dist/clients/single-flight.js +53 -0
  465. package/extensions/dm-lens/dist/clients/situational-tool-telemetry.js +85 -0
  466. package/extensions/dm-lens/dist/clients/skills-resolver.js +38 -0
  467. package/extensions/dm-lens/dist/clients/slow-fs.js +77 -0
  468. package/extensions/dm-lens/dist/clients/smells-rollup.js +118 -0
  469. package/extensions/dm-lens/dist/clients/source-filter.js +323 -0
  470. package/extensions/dm-lens/dist/clients/source-walker.js +114 -0
  471. package/extensions/dm-lens/dist/clients/spawn-output-cap.js +35 -0
  472. package/extensions/dm-lens/dist/clients/spawn-timeout-cooldown.js +51 -0
  473. package/extensions/dm-lens/dist/clients/stale-marker.js +1 -0
  474. package/extensions/dm-lens/dist/clients/startup-scan.js +221 -0
  475. package/extensions/dm-lens/dist/clients/startup-timing.js +67 -0
  476. package/extensions/dm-lens/dist/clients/string-utils.js +6 -0
  477. package/extensions/dm-lens/dist/clients/subagent-mode.js +40 -0
  478. package/extensions/dm-lens/dist/clients/symbol-containment.js +16 -0
  479. package/extensions/dm-lens/dist/clients/symbol-types.js +1 -0
  480. package/extensions/dm-lens/dist/clients/test-runner-client.js +1686 -0
  481. package/extensions/dm-lens/dist/clients/test-runner-delivery.js +285 -0
  482. package/extensions/dm-lens/dist/clients/test-target-roots.js +17 -0
  483. package/extensions/dm-lens/dist/clients/todo-scanner.js +164 -0
  484. package/extensions/dm-lens/dist/clients/tool-agreement.js +640 -0
  485. package/extensions/dm-lens/dist/clients/tool-config.js +239 -0
  486. package/extensions/dm-lens/dist/clients/tool-cwd.js +236 -0
  487. package/extensions/dm-lens/dist/clients/tool-definition.js +22 -0
  488. package/extensions/dm-lens/dist/clients/tool-event.js +24 -0
  489. package/extensions/dm-lens/dist/clients/tool-policy.js +2386 -0
  490. package/extensions/dm-lens/dist/clients/tool-probe.js +13 -0
  491. package/extensions/dm-lens/dist/clients/tool-render.js +79 -0
  492. package/extensions/dm-lens/dist/clients/tool-set-policy.js +106 -0
  493. package/extensions/dm-lens/dist/clients/tree-sitter-cache.js +206 -0
  494. package/extensions/dm-lens/dist/clients/tree-sitter-client.js +3101 -0
  495. package/extensions/dm-lens/dist/clients/tree-sitter-logger.js +77 -0
  496. package/extensions/dm-lens/dist/clients/tree-sitter-navigator.js +198 -0
  497. package/extensions/dm-lens/dist/clients/tree-sitter-query-loader.js +401 -0
  498. package/extensions/dm-lens/dist/clients/tree-sitter-shared.js +87 -0
  499. package/extensions/dm-lens/dist/clients/tree-sitter-symbol-extractor.js +984 -0
  500. package/extensions/dm-lens/dist/clients/trivy-client.js +335 -0
  501. package/extensions/dm-lens/dist/clients/tui-fit.js +26 -0
  502. package/extensions/dm-lens/dist/clients/turn-context.js +48 -0
  503. package/extensions/dm-lens/dist/clients/turn-end/delivery-holds.js +59 -0
  504. package/extensions/dm-lens/dist/clients/turn-end/lane.js +1 -0
  505. package/extensions/dm-lens/dist/clients/turn-end/lanes/govulncheck.js +54 -0
  506. package/extensions/dm-lens/dist/clients/turn-end/lanes/secrets.js +131 -0
  507. package/extensions/dm-lens/dist/clients/turn-summary-render.js +56 -0
  508. package/extensions/dm-lens/dist/clients/turn-summary.js +84 -0
  509. package/extensions/dm-lens/dist/clients/typos-config.js +9 -0
  510. package/extensions/dm-lens/dist/clients/user-notify.js +15 -0
  511. package/extensions/dm-lens/dist/clients/vanished-instance-marker.js +18 -0
  512. package/extensions/dm-lens/dist/clients/warm-attach.js +232 -0
  513. package/extensions/dm-lens/dist/clients/widget-state.js +1014 -0
  514. package/extensions/dm-lens/dist/clients/word-index-logger.js +24 -0
  515. package/extensions/dm-lens/dist/clients/word-index-store.js +222 -0
  516. package/extensions/dm-lens/dist/clients/word-index.js +1503 -0
  517. package/extensions/dm-lens/dist/clients/workspace-topology.js +274 -0
  518. package/extensions/dm-lens/dist/clients/write-ordering-guard.js +28 -0
  519. package/extensions/dm-lens/dist/clients/zizmor-config.js +160 -0
  520. package/extensions/dm-lens/dist/i18n.js +67 -0
  521. package/extensions/dm-lens/dist/index.js +2144 -0
  522. package/extensions/dm-lens/dist/mcp/analyze-cli.js +205 -0
  523. package/extensions/dm-lens/dist/mcp/build-staleness.js +55 -0
  524. package/extensions/dm-lens/dist/mcp/cli.js +96 -0
  525. package/extensions/dm-lens/dist/mcp/server.js +1241 -0
  526. package/extensions/dm-lens/dist/mcp/tool-arguments.js +134 -0
  527. package/extensions/dm-lens/dist/mcp/worker.js +41 -0
  528. package/extensions/dm-lens/dist/scripts/lib/process-scan.mjs +375 -0
  529. package/extensions/dm-lens/dist/scripts/lib/skills-predicate.mjs +53 -0
  530. package/extensions/dm-lens/dist/scripts/lib/web-tree-sitter-dir.mjs +51 -0
  531. package/extensions/dm-lens/dist/tools/activate-tools.js +63 -0
  532. package/extensions/dm-lens/dist/tools/ast-grep-outline.js +128 -0
  533. package/extensions/dm-lens/dist/tools/ast-grep-replace.js +234 -0
  534. package/extensions/dm-lens/dist/tools/ast-grep-search.js +690 -0
  535. package/extensions/dm-lens/dist/tools/effective-config.js +59 -0
  536. package/extensions/dm-lens/dist/tools/lens-diagnostic-mark.js +251 -0
  537. package/extensions/dm-lens/dist/tools/lens-diagnostics.js +1693 -0
  538. package/extensions/dm-lens/dist/tools/lsp-diagnostics.js +1397 -0
  539. package/extensions/dm-lens/dist/tools/lsp-navigation.js +1301 -0
  540. package/extensions/dm-lens/dist/tools/lsp-structured-output.js +277 -0
  541. package/extensions/dm-lens/dist/tools/module-report.js +333 -0
  542. package/extensions/dm-lens/dist/tools/project-report.js +72 -0
  543. package/extensions/dm-lens/dist/tools/render-compact.js +272 -0
  544. package/extensions/dm-lens/dist/tools/scan-progress.js +31 -0
  545. package/extensions/dm-lens/dist/tools/shared.js +46 -0
  546. package/extensions/dm-lens/dist/tools/symbol-search.js +133 -0
  547. package/extensions/dm-mcp-adapter/dist/abort.js +35 -0
  548. package/extensions/dm-mcp-adapter/dist/agent-dir.js +45 -0
  549. package/extensions/dm-mcp-adapter/dist/agent-plugin-loader.js +392 -0
  550. package/extensions/dm-mcp-adapter/dist/agent-plugin-provenance.js +26 -0
  551. package/extensions/dm-mcp-adapter/dist/bearer-command-resolver.js +184 -0
  552. package/extensions/dm-mcp-adapter/dist/claude-plugin-loader.js +350 -0
  553. package/extensions/dm-mcp-adapter/dist/config.js +1984 -0
  554. package/extensions/dm-mcp-adapter/dist/consent-manager.js +84 -0
  555. package/extensions/dm-mcp-adapter/dist/elicitation-handler.js +374 -0
  556. package/extensions/dm-mcp-adapter/dist/errors.js +225 -0
  557. package/extensions/dm-mcp-adapter/dist/extraction-settings.js +43 -0
  558. package/extensions/dm-mcp-adapter/dist/http-ca.js +75 -0
  559. package/extensions/dm-mcp-adapter/dist/jev-client.js +359 -0
  560. package/extensions/dm-mcp-adapter/dist/jev-contracts.js +1 -0
  561. package/extensions/dm-mcp-adapter/dist/jev-key-store.js +189 -0
  562. package/extensions/dm-mcp-adapter/dist/json-schema-validator.js +70 -0
  563. package/extensions/dm-mcp-adapter/dist/lifecycle.js +387 -0
  564. package/extensions/dm-mcp-adapter/dist/logger.js +115 -0
  565. package/extensions/dm-mcp-adapter/dist/mcp-auth-fetch.js +86 -0
  566. package/extensions/dm-mcp-adapter/dist/mcp-auth-flow.js +956 -0
  567. package/extensions/dm-mcp-adapter/dist/mcp-auth.js +998 -0
  568. package/extensions/dm-mcp-adapter/dist/mcp-bearer-store.js +182 -0
  569. package/extensions/dm-mcp-adapter/dist/mcp-callback-server.js +380 -0
  570. package/extensions/dm-mcp-adapter/dist/mcp-oauth-provider.js +525 -0
  571. package/extensions/dm-mcp-adapter/dist/mcp-probe.js +151 -0
  572. package/extensions/dm-mcp-adapter/dist/mcp-tasks.js +339 -0
  573. package/extensions/dm-mcp-adapter/dist/mcp-trace.js +220 -0
  574. package/extensions/dm-mcp-adapter/dist/metadata-cache.js +411 -0
  575. package/extensions/dm-mcp-adapter/dist/npx-resolver.js +465 -0
  576. package/extensions/dm-mcp-adapter/dist/output-shape.js +312 -0
  577. package/extensions/dm-mcp-adapter/dist/package-mcp-loader.js +144 -0
  578. package/extensions/dm-mcp-adapter/dist/project-server-trust.js +274 -0
  579. package/extensions/dm-mcp-adapter/dist/request-headers-command.js +310 -0
  580. package/extensions/dm-mcp-adapter/dist/resource-tools.js +7 -0
  581. package/extensions/dm-mcp-adapter/dist/runtime-owner.js +95 -0
  582. package/extensions/dm-mcp-adapter/dist/sampling-handler.js +219 -0
  583. package/extensions/dm-mcp-adapter/dist/script-tools.js +72 -0
  584. package/extensions/dm-mcp-adapter/dist/secure-keyring.js +191 -0
  585. package/extensions/dm-mcp-adapter/dist/semantic-settings.js +51 -0
  586. package/extensions/dm-mcp-adapter/dist/server-log.js +19 -0
  587. package/extensions/dm-mcp-adapter/dist/server-manager.js +1635 -0
  588. package/extensions/dm-mcp-adapter/dist/session-approvals.js +127 -0
  589. package/extensions/dm-mcp-adapter/dist/session-recovery.js +83 -0
  590. package/extensions/dm-mcp-adapter/dist/state.js +1 -0
  591. package/extensions/dm-mcp-adapter/dist/task-entries.js +60 -0
  592. package/extensions/dm-mcp-adapter/dist/task-jobs.js +259 -0
  593. package/extensions/dm-mcp-adapter/dist/ts-shape.js +157 -0
  594. package/extensions/dm-mcp-adapter/dist/types.js +293 -0
  595. package/extensions/dm-mcp-adapter/dist/ui-app-bridge-helpers.js +36 -0
  596. package/extensions/dm-mcp-adapter/dist/ui-resource-handler.js +204 -0
  597. package/extensions/dm-mcp-adapter/dist/ui-stream-types.js +58 -0
  598. package/extensions/dm-mcp-adapter/dist/ui-tool-visibility.js +26 -0
  599. package/extensions/dm-mcp-adapter/dist/unix-socket-transport.js +83 -0
  600. package/extensions/dm-mcp-adapter/dist/utils.js +444 -0
  601. package/extensions/dm-mcp-adapter/mcp-keyring-helper.cjs +1 -1
  602. package/extensions/dm-ponytail/hooks/ponytail-activate.js +1 -1
  603. package/extensions/dm-ponytail/hooks/ponytail-instructions.js +1 -1
  604. package/extensions/dm-ponytail/hooks/ponytail-mode-tracker.js +1 -1
  605. package/extensions/dm-subagents/src/runs/shared/child-session.js +5 -3
  606. package/package.json +1 -1
@@ -0,0 +1,1517 @@
1
+ import { constants as bufferConstants } from "node:buffer";
2
+ import * as fs from "node:fs";
3
+ import { BoundedFifoMap, BoundedSet } from "./bounded-cache.js";
4
+ import { incrementDegradationCount, recordDegradationOnce } from "./degradation-ledger.js";
5
+ import { createFileTime } from "./file-time.js";
6
+ import { hashContentBytes, hashFileBytes } from "./content-stamp.js";
7
+ import { normalizeEphemeralMapKey, normalizeFilePath } from "./path-utils.js";
8
+ import { logReadGuardEvent, sanitizeCorrelationId } from "./read-guard-logger.js";
9
+ import { beginScope, moveBranch } from "./session-scope.js";
10
+ export const READ_GUARD_STATE_VERSION = 2;
11
+ const DEFAULT_CONFIG = {
12
+ enabled: true,
13
+ mode: "block",
14
+ contextLines: 3,
15
+ exemptions: [
16
+ { pattern: "*.md", mode: "warn" },
17
+ { pattern: "*.txt", mode: "allow" },
18
+ { pattern: "*.log", mode: "allow" }
19
+ ]
20
+ };
21
+ const READ_HASH_MAX_LINES = Math.max(0, Number.parseInt(process.env.DM_LENS_READ_GUARD_HASH_MAX_LINES ?? "3000", 10) || 3000);
22
+ const READ_BINDING_MAX_BYTES = 4 * 1024 * 1024;
23
+ const ABSENT_SIZE = -1;
24
+ function observeAuthoredBytes(filePath, knownHash, authoredRanges) {
25
+ try {
26
+ const stat = fs.statSync(filePath);
27
+ const hash = knownHash !== undefined ? knownHash : stat.size <= READ_BINDING_MAX_BYTES ? hashFileBytes(filePath) : undefined;
28
+ return {
29
+ size: stat.size,
30
+ mtimeMs: stat.mtimeMs,
31
+ ctimeMs: stat.ctimeMs,
32
+ ...hash !== undefined && { hash },
33
+ ...authoredRanges !== undefined && { authoredRanges },
34
+ ...authoredRanges !== undefined && {
35
+ authoredLineCount: splitLines(fs.readFileSync(filePath, "utf-8")).length
36
+ }
37
+ };
38
+ } catch {
39
+ return { size: ABSENT_SIZE, mtimeMs: 0, ctimeMs: 0 };
40
+ }
41
+ }
42
+ function composeAuthoredRanges(previous, next, nextLineCount) {
43
+ const ranges = previous.authoredLineCount !== undefined && nextLineCount === previous.authoredLineCount ? [...previous.authoredRanges ?? [], ...next] : next;
44
+ const sorted = [...ranges].sort((a, b) => a[0] - b[0]);
45
+ const merged = [];
46
+ for (const [start, end] of sorted) {
47
+ const last = merged.at(-1);
48
+ if (last && start <= last[1] + 1)
49
+ last[1] = Math.max(last[1], end);
50
+ else
51
+ merged.push([start, end]);
52
+ }
53
+ return merged;
54
+ }
55
+ function authoredRangeCovers(authored, touchedLines, editRanges) {
56
+ if (authored.authoredRanges === undefined)
57
+ return true;
58
+ const requested = editRanges ?? (touchedLines ? [touchedLines] : undefined);
59
+ return requested !== undefined && requested.every(([start, end]) => authored.authoredRanges.some(([authoredStart, authoredEnd]) => start >= authoredStart && end <= authoredEnd));
60
+ }
61
+ function isValidAuthoredRanges(value) {
62
+ return Array.isArray(value) && value.every((range) => Array.isArray(range) && range.length === 2 && Number.isFinite(range[0]) && Number.isFinite(range[1]));
63
+ }
64
+ function authoredBytesIntact(filePath, authored) {
65
+ let stat;
66
+ try {
67
+ stat = fs.statSync(filePath);
68
+ } catch {
69
+ return authored.size === ABSENT_SIZE;
70
+ }
71
+ if (stat.size === authored.size && stat.mtimeMs === authored.mtimeMs && stat.ctimeMs === authored.ctimeMs)
72
+ return true;
73
+ if (authored.hash === undefined || stat.size !== authored.size)
74
+ return false;
75
+ try {
76
+ if (hashFileBytes(filePath) !== authored.hash)
77
+ return false;
78
+ } catch {
79
+ return false;
80
+ }
81
+ authored.mtimeMs = stat.mtimeMs;
82
+ authored.ctimeMs = stat.ctimeMs;
83
+ return true;
84
+ }
85
+ const READ_GUARD_MAX_FILES = 256;
86
+ const READ_GUARD_MAX_RECORDS_PER_FILE = 128;
87
+ const NO_TRIM = {
88
+ evictedCount: 0,
89
+ evictedCreditCount: 0,
90
+ evictedGenuineCount: 0
91
+ };
92
+ function enforceRecordCapForFile(records) {
93
+ if (records.length <= READ_GUARD_MAX_RECORDS_PER_FILE)
94
+ return NO_TRIM;
95
+ const excess = records.length - READ_GUARD_MAX_RECORDS_PER_FILE;
96
+ const evicted = new Set;
97
+ let evictedCreditCount = 0;
98
+ for (let i = 0;i < records.length && evicted.size < excess; i++) {
99
+ if (records[i].searchCredit !== undefined) {
100
+ evicted.add(i);
101
+ evictedCreditCount++;
102
+ }
103
+ }
104
+ for (let i = 0;i < records.length && evicted.size < excess; i++) {
105
+ evicted.add(i);
106
+ }
107
+ const kept = records.filter((_, i) => !evicted.has(i));
108
+ records.length = 0;
109
+ for (const record of kept)
110
+ records.push(record);
111
+ return {
112
+ evictedCount: excess,
113
+ evictedCreditCount,
114
+ evictedGenuineCount: excess - evictedCreditCount
115
+ };
116
+ }
117
+ const READ_GUARD_MAX_EDITS_PER_FILE = 256;
118
+ const READ_GUARD_MAX_UNCONSUMED_FILES = 4096;
119
+ const READ_GUARD_MAX_AUTHORED_FILES = READ_GUARD_MAX_UNCONSUMED_FILES;
120
+ const READ_GUARD_MAX_CHECKED_CALLS = 16;
121
+ const READ_GUARD_MAX_CHECKED_PATHS_PER_CALL = 128;
122
+ const READ_GUARD_IDLE_EVICT_MS_DEFAULT = 30 * 60000;
123
+ export function captureReadContentBinding(filePath, offset, limit) {
124
+ try {
125
+ if (fs.statSync(filePath).size > READ_BINDING_MAX_BYTES)
126
+ return;
127
+ const content = fs.readFileSync(filePath, "utf-8");
128
+ const lines = splitLinesThrough(content, READ_HASH_MAX_LINES + 1);
129
+ if (lines.length <= READ_HASH_MAX_LINES) {
130
+ return {
131
+ hash: hashContentBytes(Buffer.from(content, "utf8")),
132
+ fullFile: true,
133
+ offset: 1,
134
+ limit: lines.length
135
+ };
136
+ }
137
+ const scopedOffset = Math.max(1, offset);
138
+ const scopedLimit = Math.min(Math.max(0, limit), READ_HASH_MAX_LINES);
139
+ if (scopedLimit === 0)
140
+ return;
141
+ const rangeLines = splitLinesThrough(content, scopedOffset - 1 + scopedLimit);
142
+ const scopedContent = rangeLines.slice(scopedOffset - 1, scopedOffset - 1 + scopedLimit).join(`
143
+ `);
144
+ return {
145
+ hash: hashContentBytes(Buffer.from(scopedContent, "utf8")),
146
+ fullFile: false,
147
+ offset: scopedOffset,
148
+ limit: scopedLimit
149
+ };
150
+ } catch {
151
+ return;
152
+ }
153
+ }
154
+ export function _currentContentMatchesBindingForTests(filePath, binding) {
155
+ try {
156
+ const content = fs.readFileSync(filePath, "utf-8");
157
+ const boundContent = binding.fullFile ? content : splitLines(content).slice(binding.offset - 1, binding.offset - 1 + binding.limit).join(`
158
+ `);
159
+ return hashContentBytes(Buffer.from(boundContent, "utf8")) === binding.hash;
160
+ } catch {
161
+ return false;
162
+ }
163
+ }
164
+ const currentContentMatchesBinding = _currentContentMatchesBindingForTests;
165
+ const RELOCATION_WINDOW_MIN = Math.max(1, Number.parseInt(process.env.DM_LENS_READ_GUARD_RELOCATION_WINDOW_MIN ?? "40", 10) || 40);
166
+ const RELOCATION_WINDOW_PER_EDIT = Math.max(0, Number.parseInt(process.env.DM_LENS_READ_GUARD_RELOCATION_WINDOW_PER_EDIT ?? "20", 10) || 20);
167
+ const RELOCATION_WINDOW_MAX = Math.max(RELOCATION_WINDOW_MIN, Number.parseInt(process.env.DM_LENS_READ_GUARD_RELOCATION_WINDOW_MAX ?? "400", 10) || 400);
168
+ function splitLines(text) {
169
+ return text.split(/\r?\n/);
170
+ }
171
+ function splitLinesThrough(text, maxLines) {
172
+ if (maxLines <= 0)
173
+ return [];
174
+ const lines = [];
175
+ let start = 0;
176
+ while (lines.length < maxLines) {
177
+ const newline = text.indexOf(`
178
+ `, start);
179
+ if (newline === -1) {
180
+ lines.push(text.slice(start));
181
+ break;
182
+ }
183
+ const end = newline > start && text[newline - 1] === "\r" ? newline - 1 : newline;
184
+ lines.push(text.slice(start, end));
185
+ start = newline + 1;
186
+ if (start === text.length && lines.length < maxLines) {
187
+ lines.push("");
188
+ break;
189
+ }
190
+ }
191
+ return lines;
192
+ }
193
+ export function lineContentHash(line) {
194
+ const normalized = line.replace(/\s+/g, "");
195
+ let hash = 2166136261;
196
+ for (let i = 0;i < normalized.length; i++) {
197
+ hash = Math.imul(hash ^ normalized.charCodeAt(i), 16777619);
198
+ }
199
+ return (hash >>> 0).toString(16).padStart(8, "0");
200
+ }
201
+ function readRangeCoversLine(read, lineNo) {
202
+ return lineNo >= read.effectiveOffset && lineNo <= read.effectiveOffset + read.effectiveLimit - 1;
203
+ }
204
+ function newestViewOfLine(reads, lineNo) {
205
+ for (let i = reads.length - 1;i >= 0; i -= 1) {
206
+ if (reads[i].provisional !== true && readRangeCoversLine(reads[i], lineNo)) {
207
+ return reads[i];
208
+ }
209
+ }
210
+ return;
211
+ }
212
+ function hashLines(lines, firstLine) {
213
+ const hashes = {};
214
+ lines.forEach((line, i) => {
215
+ hashes[firstLine + i] = lineContentHash(line);
216
+ });
217
+ return lines.length > 0 ? hashes : undefined;
218
+ }
219
+ const SCAN_CHUNK_BYTES = 64 * 1024;
220
+ const SCAN_MAX_BYTES = bufferConstants.MAX_STRING_LENGTH;
221
+ function hashedWindow(offset, limit) {
222
+ if (limit <= 0 || limit > READ_HASH_MAX_LINES)
223
+ return;
224
+ const first = Math.max(1, offset);
225
+ const last = offset + limit - 1;
226
+ return last < first ? undefined : [first, last];
227
+ }
228
+ export function scanFileLines(filePath, ranges, opts) {
229
+ const windows = ranges.flatMap((r) => {
230
+ const window = hashedWindow(r.offset, Math.min(r.limit, READ_HASH_MAX_LINES));
231
+ return window ? [window] : [];
232
+ }).sort((a, b) => a[0] - b[0]);
233
+ let cursor = 0;
234
+ const wanted = (lineNo) => {
235
+ let window = windows[cursor];
236
+ while (window && window[1] < lineNo) {
237
+ cursor += 1;
238
+ window = windows[cursor];
239
+ }
240
+ return window !== undefined && window[0] <= lineNo;
241
+ };
242
+ const lastWanted = windows.reduce((max, [, last]) => Math.max(max, last), 0);
243
+ const done = (lineNo) => !opts.count && lineNo > lastWanted;
244
+ const lines = new Map;
245
+ let fd;
246
+ try {
247
+ fd = fs.openSync(filePath, "r");
248
+ const size = fs.fstatSync(fd).size;
249
+ if (size > SCAN_MAX_BYTES)
250
+ return overByteGate(filePath, size);
251
+ const byteBudget = size > 0 ? size : SCAN_MAX_BYTES + 1;
252
+ const chunk = Buffer.allocUnsafe(Math.min(SCAN_CHUNK_BYTES, byteBudget));
253
+ let consumed = 0;
254
+ let lineNo = 1;
255
+ let keep = wanted(lineNo);
256
+ let parts = [];
257
+ const keepLine = () => lines.set(lineNo, Buffer.concat(parts).toString("utf8"));
258
+ while (consumed < byteBudget && !done(lineNo)) {
259
+ const n = fs.readSync(fd, chunk, 0, Math.min(chunk.length, byteBudget - consumed), null);
260
+ if (n === 0)
261
+ break;
262
+ consumed += n;
263
+ if (consumed > SCAN_MAX_BYTES)
264
+ return overByteGate(filePath, consumed);
265
+ let start = 0;
266
+ let runStart = -1;
267
+ let runLine = 0;
268
+ const flushRun = (end) => {
269
+ if (runStart < 0)
270
+ return;
271
+ chunk.toString("utf8", runStart, end).split(`
272
+ `).forEach((text, i) => lines.set(runLine + i, text));
273
+ runStart = -1;
274
+ };
275
+ while (!done(lineNo)) {
276
+ const newline = chunk.indexOf(10, start);
277
+ if (newline === -1 || newline >= n) {
278
+ if (keep)
279
+ parts.push(Buffer.from(chunk.subarray(start, n)));
280
+ break;
281
+ }
282
+ if (!keep)
283
+ flushRun(start - 1);
284
+ else if (parts.length > 0) {
285
+ parts.push(chunk.subarray(start, newline));
286
+ keepLine();
287
+ parts = [];
288
+ } else if (runStart < 0) {
289
+ runStart = start;
290
+ runLine = lineNo;
291
+ }
292
+ lineNo += 1;
293
+ keep = wanted(lineNo);
294
+ start = newline + 1;
295
+ }
296
+ flushRun(start - 1);
297
+ }
298
+ if (keep && !done(lineNo))
299
+ keepLine();
300
+ return {
301
+ totalLines: opts.count ? lineNo : undefined,
302
+ hashes(offset, limit) {
303
+ const window = hashedWindow(offset, limit);
304
+ if (!window)
305
+ return;
306
+ const shown = [];
307
+ for (let n = window[0];n <= window[1] && lines.has(n); n += 1)
308
+ shown.push(lines.get(n));
309
+ return hashLines(shown, window[0]);
310
+ }
311
+ };
312
+ } catch {
313
+ return;
314
+ } finally {
315
+ if (fd !== undefined)
316
+ fs.closeSync(fd);
317
+ }
318
+ }
319
+ function overByteGate(filePath, bytes) {
320
+ recordDegradationOnce({
321
+ kind: "read-guard-scan-byte-gate",
322
+ subject: filePath,
323
+ reason: `${bytes} bytes is over the ${SCAN_MAX_BYTES}-byte read-accounting gate: one line counted, no line hashes`
324
+ });
325
+ return;
326
+ }
327
+ export function deliveredLineEvidence(text, offset) {
328
+ const lines = splitLines(text);
329
+ return {
330
+ lineCount: lines.length,
331
+ lineHashes: lines.length <= READ_HASH_MAX_LINES ? hashLines(lines, offset) : undefined
332
+ };
333
+ }
334
+ export function currentLinesMatchReadSnapshot(filePath, read, [startLine, endLine]) {
335
+ const hashes = read.lineHashes ?? {};
336
+ const missingLines = [];
337
+ const mismatchedLines = [];
338
+ for (let lineNo = startLine;lineNo <= endLine; lineNo += 1) {
339
+ if (!readRangeCoversLine(read, lineNo) || hashes[lineNo] === undefined) {
340
+ missingLines.push(lineNo);
341
+ }
342
+ }
343
+ if (missingLines.length > 0) {
344
+ return { checked: false, matches: false, missingLines, mismatchedLines };
345
+ }
346
+ let lines;
347
+ try {
348
+ lines = splitLines(fs.readFileSync(filePath, "utf-8"));
349
+ } catch {
350
+ return {
351
+ checked: true,
352
+ matches: false,
353
+ missingLines,
354
+ mismatchedLines: [...Array(endLine - startLine + 1)].map((_, index) => startLine + index)
355
+ };
356
+ }
357
+ for (let lineNo = startLine;lineNo <= endLine; lineNo += 1) {
358
+ if (lineNo < 1 || lineNo > lines.length) {
359
+ mismatchedLines.push(lineNo);
360
+ continue;
361
+ }
362
+ if (lineContentHash(lines[lineNo - 1] ?? "") !== hashes[lineNo]) {
363
+ mismatchedLines.push(lineNo);
364
+ }
365
+ }
366
+ return {
367
+ checked: true,
368
+ matches: mismatchedLines.length === 0,
369
+ missingLines,
370
+ mismatchedLines
371
+ };
372
+ }
373
+
374
+ export class ReadGuard {
375
+ config;
376
+ reads = new Map;
377
+ edits = new Map;
378
+ fileLastUsed = new Map;
379
+ fileIdleTimers = new Map;
380
+ consumedReadFiles = new Set;
381
+ fileTime;
382
+ exemptions = new Set;
383
+ pendingCreations = new Map;
384
+ writtenThisSession = new Map;
385
+ checkedPathsByCall = new BoundedFifoMap(READ_GUARD_MAX_CHECKED_CALLS);
386
+ expiredWrites = new BoundedSet(READ_GUARD_MAX_FILES);
387
+ knownPathIndex = new Map;
388
+ trimAccumulators = new Map;
389
+ sessionId;
390
+ scope;
391
+ constructor(sessionId, config = {}, scope = beginScope({ role: "primary" })) {
392
+ this.scope = scope;
393
+ this.sessionId = sessionId;
394
+ this.config = { ...DEFAULT_CONFIG, ...config };
395
+ this.fileTime = createFileTime(sessionId);
396
+ }
397
+ key(filePath) {
398
+ return normalizeFilePath(filePath);
399
+ }
400
+ idleEvictMs() {
401
+ const value = Number.parseInt(process.env.DM_LENS_READ_GUARD_IDLE_EVICT_MS ?? "", 10);
402
+ return Number.isSafeInteger(value) && value > 0 ? value : READ_GUARD_IDLE_EVICT_MS_DEFAULT;
403
+ }
404
+ clearFileTimer(filePath) {
405
+ const timer = this.fileIdleTimers.get(filePath);
406
+ if (timer)
407
+ clearTimeout(timer);
408
+ this.fileIdleTimers.delete(filePath);
409
+ }
410
+ evictFile(filePath, reason) {
411
+ this.clearFileTimer(filePath);
412
+ this.reads.delete(filePath);
413
+ this.edits.delete(filePath);
414
+ this.fileLastUsed.delete(filePath);
415
+ this.consumedReadFiles.delete(filePath);
416
+ const droppedAuthorship = this.writtenThisSession.delete(filePath);
417
+ for (const [syntacticKey, stored] of this.knownPathIndex) {
418
+ if (stored === filePath)
419
+ this.knownPathIndex.delete(syntacticKey);
420
+ }
421
+ if (reason === "idle-timeout") {
422
+ if (droppedAuthorship)
423
+ this.noteExpiredWrite(filePath);
424
+ return;
425
+ }
426
+ const isRisingEdge = incrementDegradationCount({
427
+ kind: "read-guard-file-evicted",
428
+ subject: filePath,
429
+ reason: `evicted (${reason})`
430
+ });
431
+ if (isRisingEdge) {
432
+ logReadGuardEvent({
433
+ event: "read_file_evicted",
434
+ sessionId: this.sessionId,
435
+ filePath,
436
+ metadata: { reason }
437
+ });
438
+ }
439
+ }
440
+ noteExpiredWrite(filePath, reason = "idle-timeout") {
441
+ if (this.expiredWrites.has(filePath))
442
+ return;
443
+ this.expiredWrites.add(filePath);
444
+ if (reason === "authorship-cap") {
445
+ const isRisingEdge = incrementDegradationCount({
446
+ kind: "read-guard-authorship-cap",
447
+ subject: this.sessionId,
448
+ reason: "authorship cap evicted a live write record"
449
+ });
450
+ if (isRisingEdge) {
451
+ logReadGuardEvent({
452
+ event: "read_file_evicted",
453
+ sessionId: this.sessionId,
454
+ filePath,
455
+ metadata: { reason, authorshipDropped: true }
456
+ });
457
+ }
458
+ return;
459
+ }
460
+ logReadGuardEvent({
461
+ event: "read_file_evicted",
462
+ sessionId: this.sessionId,
463
+ filePath,
464
+ metadata: { reason, authorshipDropped: true }
465
+ });
466
+ }
467
+ enforceAuthorshipCap() {
468
+ let excess = this.writtenThisSession.size - READ_GUARD_MAX_AUTHORED_FILES;
469
+ if (excess <= 0)
470
+ return;
471
+ for (const [filePath, authored] of this.writtenThisSession) {
472
+ if (excess <= 0)
473
+ return;
474
+ if (!authored.retired)
475
+ continue;
476
+ this.writtenThisSession.delete(filePath);
477
+ excess -= 1;
478
+ }
479
+ for (const filePath of this.writtenThisSession.keys()) {
480
+ if (excess <= 0)
481
+ return;
482
+ this.writtenThisSession.delete(filePath);
483
+ this.noteExpiredWrite(filePath, "authorship-cap");
484
+ excess -= 1;
485
+ }
486
+ }
487
+ touchFile(filePath) {
488
+ const now = Date.now();
489
+ this.fileLastUsed.set(filePath, now);
490
+ this.clearFileTimer(filePath);
491
+ if (this.reads.has(filePath) && !this.consumedReadFiles.has(filePath))
492
+ return;
493
+ const stamp = now;
494
+ const timer = setTimeout(() => {
495
+ if (this.fileLastUsed.get(filePath) !== stamp)
496
+ return;
497
+ if (this.reads.has(filePath) && !this.consumedReadFiles.has(filePath))
498
+ return;
499
+ this.evictFile(filePath, "idle-timeout");
500
+ }, this.idleEvictMs());
501
+ timer.unref?.();
502
+ this.fileIdleTimers.set(filePath, timer);
503
+ }
504
+ enforceFileCap() {
505
+ while (this.reads.size > READ_GUARD_MAX_FILES) {
506
+ const victim = [...this.reads.keys()].filter((filePath) => this.consumedReadFiles.has(filePath)).sort((a, b) => (this.fileLastUsed.get(a) ?? 0) - (this.fileLastUsed.get(b) ?? 0))[0];
507
+ if (!victim)
508
+ break;
509
+ this.evictFile(victim, "file-cap-consumed");
510
+ }
511
+ while (this.reads.size > READ_GUARD_MAX_UNCONSUMED_FILES) {
512
+ const victim = [...this.reads.keys()].filter((filePath) => !this.consumedReadFiles.has(filePath)).sort((a, b) => (this.fileLastUsed.get(a) ?? 0) - (this.fileLastUsed.get(b) ?? 0))[0];
513
+ if (!victim)
514
+ break;
515
+ this.evictFile(victim, "file-cap-unconsumed");
516
+ }
517
+ }
518
+ dropProvisionalReads() {
519
+ let dropped = 0;
520
+ for (const [filePath, records] of this.reads) {
521
+ const kept = records.filter((record) => {
522
+ if (!record.provisional)
523
+ return true;
524
+ dropped += 1;
525
+ return false;
526
+ });
527
+ if (kept.length === 0)
528
+ this.reads.delete(filePath);
529
+ else if (kept.length !== records.length)
530
+ this.reads.set(filePath, kept);
531
+ }
532
+ return dropped;
533
+ }
534
+ dropProvisionalReadByCall(toolCallId) {
535
+ for (const [filePath, records] of this.reads) {
536
+ const source = `native-read:${toolCallId}:provisional`;
537
+ const index = records.findIndex((record) => record.source === source);
538
+ if (index < 0)
539
+ continue;
540
+ records.splice(index, 1);
541
+ if (records.length === 0)
542
+ this.reads.delete(filePath);
543
+ return true;
544
+ }
545
+ return false;
546
+ }
547
+ recordRead(record, opts) {
548
+ const filePath = this.key(record.filePath);
549
+ if (opts?.supersedes)
550
+ this.dropProvisionalReadByCall(opts.supersedes.toolCallId);
551
+ this.knownPathIndex.set(normalizeEphemeralMapKey(record.filePath), filePath);
552
+ const { effectiveOffset: offset, effectiveLimit: limit } = record;
553
+ const storedRecord = {
554
+ ...record,
555
+ filePath,
556
+ lineHashes: record.lineHashes ?? (opts?.captureLineHashes === false || !hashedWindow(offset, limit) ? undefined : scanFileLines(filePath, [{ offset, limit }], {
557
+ count: false
558
+ })?.hashes(offset, limit))
559
+ };
560
+ const arr = this.reads.get(storedRecord.filePath) ?? [];
561
+ this.consumedReadFiles.delete(storedRecord.filePath);
562
+ arr.push(storedRecord);
563
+ this.reads.set(storedRecord.filePath, arr);
564
+ const rawReadCountForFile = arr.length;
565
+ const { evictedCount: evictedRecordCount, evictedCreditCount, evictedGenuineCount } = enforceRecordCapForFile(arr);
566
+ this.touchFile(storedRecord.filePath);
567
+ this.enforceFileCap();
568
+ logReadGuardEvent({
569
+ event: "read_recorded",
570
+ sessionId: this.sessionId,
571
+ filePath: storedRecord.filePath,
572
+ requestedOffset: storedRecord.requestedOffset,
573
+ requestedLimit: storedRecord.requestedLimit,
574
+ effectiveOffset: storedRecord.effectiveOffset,
575
+ effectiveLimit: storedRecord.effectiveLimit,
576
+ symbol: storedRecord.enclosingSymbol?.name,
577
+ symbolKind: storedRecord.enclosingSymbol?.kind,
578
+ symbolStartLine: storedRecord.enclosingSymbol?.startLine,
579
+ symbolEndLine: storedRecord.enclosingSymbol?.endLine,
580
+ metadata: {
581
+ expandedByLsp: storedRecord.expandedByLsp,
582
+ turnIndex: storedRecord.turnIndex,
583
+ writeIndex: storedRecord.writeIndex,
584
+ readCountForFile: arr.length,
585
+ hashLineCount: Object.keys(storedRecord.lineHashes ?? {}).length,
586
+ ...storedRecord.source !== undefined && {
587
+ source: storedRecord.source
588
+ },
589
+ ...storedRecord.searchCredit !== undefined && {
590
+ searchCreditReason: storedRecord.searchCredit.reason,
591
+ searchCreditMarginBefore: storedRecord.searchCredit.marginBefore,
592
+ searchCreditMarginAfter: storedRecord.searchCredit.marginAfter
593
+ },
594
+ ...evictedRecordCount > 0 && {
595
+ evictedRecordCount,
596
+ rawReadCountForFile
597
+ }
598
+ }
599
+ });
600
+ if (evictedRecordCount > 0) {
601
+ const key = storedRecord.filePath;
602
+ const acc = this.trimAccumulators.get(key) ?? {
603
+ totalEvicted: 0,
604
+ evictedCreditCount: 0,
605
+ evictedGenuineCount: 0,
606
+ trimEventCount: 0
607
+ };
608
+ acc.totalEvicted += evictedRecordCount;
609
+ acc.evictedCreditCount += evictedCreditCount;
610
+ acc.evictedGenuineCount += evictedGenuineCount;
611
+ acc.trimEventCount += 1;
612
+ this.trimAccumulators.set(key, acc);
613
+ const isRisingEdge = incrementDegradationCount({
614
+ kind: "read-guard-record-cap-trim",
615
+ subject: key,
616
+ reason: `trim #${acc.trimEventCount}: evicted ${evictedRecordCount} (credit ${evictedCreditCount}, genuine ${evictedGenuineCount})`
617
+ });
618
+ if (isRisingEdge) {
619
+ logReadGuardEvent({
620
+ event: "read_cap_trimmed",
621
+ sessionId: this.sessionId,
622
+ filePath: storedRecord.filePath,
623
+ metadata: {
624
+ trimEventCount: acc.trimEventCount,
625
+ evictedRecordCount: acc.totalEvicted,
626
+ evictedCreditCount: acc.evictedCreditCount,
627
+ evictedGenuineCount: acc.evictedGenuineCount,
628
+ rawReadCountForFile
629
+ }
630
+ });
631
+ }
632
+ }
633
+ if (opts?.stampFileTime !== false)
634
+ this.fileTime.read(storedRecord.filePath);
635
+ }
636
+ retireChangedAuthorship(rawFilePath) {
637
+ return this.retireIfChanged(this.key(rawFilePath));
638
+ }
639
+ noteCheckedPaths(rawToolCallId, rawPaths) {
640
+ const toolCallId = sanitizeCorrelationId(rawToolCallId);
641
+ if (toolCallId === undefined || rawPaths.length === 0)
642
+ return;
643
+ let checked = this.checkedPathsByCall.get(toolCallId);
644
+ if (!checked) {
645
+ checked = new Set;
646
+ this.checkedPathsByCall.set(toolCallId, checked);
647
+ }
648
+ for (const rawPath of rawPaths) {
649
+ if (checked.size >= READ_GUARD_MAX_CHECKED_PATHS_PER_CALL)
650
+ return;
651
+ checked.add(this.key(rawPath));
652
+ }
653
+ }
654
+ consumeCheckedAtCall(toolCallId, filePath) {
655
+ const callId = sanitizeCorrelationId(toolCallId);
656
+ if (callId === undefined)
657
+ return false;
658
+ const checked = this.checkedPathsByCall.get(callId);
659
+ const licensedPath = this.key(filePath);
660
+ if (checked?.has(licensedPath) !== true)
661
+ return false;
662
+ checked.delete(licensedPath);
663
+ if (checked.size === 0)
664
+ this.checkedPathsByCall.delete(callId);
665
+ return true;
666
+ }
667
+ retireIfChanged(filePath, writer) {
668
+ const authored = this.writtenThisSession.get(filePath);
669
+ if (!authored || authored.retired || authoredBytesIntact(filePath, authored))
670
+ return false;
671
+ authored.retired = true;
672
+ const isRisingEdge = incrementDegradationCount({
673
+ kind: "read-guard-authorship-retired",
674
+ subject: filePath,
675
+ reason: "another writer changed the bytes the conversation wrote; the next edit needs a read"
676
+ });
677
+ if (isRisingEdge)
678
+ logReadGuardEvent({
679
+ event: "authorship_retired",
680
+ sessionId: this.sessionId,
681
+ filePath,
682
+ metadata: {
683
+ authoredSize: authored.size,
684
+ hashed: authored.hash !== undefined,
685
+ ...writer !== undefined && { writer },
686
+ ...authored.toolCallId !== undefined && {
687
+ toolCallId: authored.toolCallId
688
+ }
689
+ }
690
+ });
691
+ return true;
692
+ }
693
+ fileTimeMoved(filePath) {
694
+ return this.fileTime.hasChanged(this.key(filePath));
695
+ }
696
+ diskMovedSinceStamp(filePath) {
697
+ const key = this.key(filePath);
698
+ return this.fileTime.get(key) !== undefined && this.fileTime.hasChanged(key);
699
+ }
700
+ recordSymbolRead(filePath, symbol, turnIndex, writeIndex, toolCallId) {
701
+ const span = Math.max(1, symbol.endLine - symbol.startLine + 1);
702
+ this.recordRead({
703
+ filePath,
704
+ requestedOffset: symbol.startLine,
705
+ requestedLimit: span,
706
+ effectiveOffset: symbol.startLine,
707
+ effectiveLimit: span,
708
+ expandedByLsp: false,
709
+ enclosingSymbol: {
710
+ name: symbol.name,
711
+ kind: symbol.kind,
712
+ startLine: symbol.startLine,
713
+ endLine: symbol.endLine
714
+ },
715
+ turnIndex,
716
+ writeIndex,
717
+ timestamp: Date.now(),
718
+ ...toolCallId !== undefined && { toolCallId }
719
+ });
720
+ }
721
+ checkEdit(filePath, touchedLines, editRanges, options) {
722
+ filePath = this.key(filePath);
723
+ if (this.reads.has(filePath) || this.edits.has(filePath))
724
+ this.touchFile(filePath);
725
+ if (this.exemptions.has(filePath)) {
726
+ this.exemptions.delete(filePath);
727
+ const verdict = this.allow();
728
+ this.recordVerdict(filePath, "edit", touchedLines, verdict, {
729
+ reasonKind: "manual_exemption"
730
+ });
731
+ return verdict;
732
+ }
733
+ const exemptionMode = this.getExemptionMode(filePath);
734
+ if (exemptionMode === "allow") {
735
+ const verdict = this.allow();
736
+ this.recordVerdict(filePath, "edit", touchedLines, verdict, {
737
+ reasonKind: "pattern_exemption",
738
+ exemptionMode
739
+ });
740
+ return verdict;
741
+ }
742
+ const effectiveMode = exemptionMode === "warn" ? "warn" : undefined;
743
+ const fileReads = this.reads.get(filePath);
744
+ if (!fileReads || fileReads.length === 0) {
745
+ this.retireChangedAuthorship(filePath);
746
+ if (this.writtenThisSession.get(filePath)?.retired) {
747
+ const verdict = this.blockOrWarn("authorship-retired", `\uD83D\uDD04 RETRYABLE — File modified since your write: \`${filePath}\` no longer holds the bytes this conversation wrote. Read it first, then retry: \`read path="${filePath}"\`.`, undefined, effectiveMode);
748
+ this.recordVerdict(filePath, "edit", touchedLines, verdict, {
749
+ reasonKind: "authorship_retired"
750
+ });
751
+ return verdict;
752
+ }
753
+ const authored = this.writtenThisSession.get(filePath);
754
+ if (authored && authoredRangeCovers(authored, touchedLines, editRanges)) {
755
+ if (authored.authoredRanges === undefined)
756
+ this.injectCreationRead(filePath, 0, 0, authored.toolCallId);
757
+ const verdict = this.allow();
758
+ this.recordVerdict(filePath, "edit", touchedLines, verdict, {
759
+ reasonKind: "session_authored"
760
+ });
761
+ return verdict;
762
+ }
763
+ if (authored) {
764
+ const verdict = this.blockOrWarn("authorship-range", `\uD83D\uDD04 RETRYABLE — Edit without read: this write only covered part of \`${filePath}\`; read the requested lines first, then retry.`, undefined, effectiveMode);
765
+ this.recordVerdict(filePath, "edit", touchedLines, verdict, {
766
+ reasonKind: "authorship_range"
767
+ });
768
+ return verdict;
769
+ }
770
+ const writeRecordExpired = this.expiredWrites.has(filePath);
771
+ const verdict = this.blockOrWarn("zero-read", writeRecordExpired ? `\uD83D\uDD04 RETRYABLE — Edit without read: the earlier write record for \`${filePath}\` expired, so it needs a read again. Read it first, then retry: \`read path="${filePath}"\`.` : `\uD83D\uDD04 RETRYABLE — Edit without read: you have not read \`${filePath}\` in this conversation. Read it first, then retry: \`read path="${filePath}"\`.`, undefined, effectiveMode);
772
+ this.recordVerdict(filePath, "edit", touchedLines, verdict, {
773
+ reasonKind: "zero_read",
774
+ ...writeRecordExpired ? { writeRecordExpired } : {}
775
+ });
776
+ return verdict;
777
+ }
778
+ const lastBoundRead = [...fileReads].reverse().find((read) => read.contentBinding !== undefined);
779
+ if (lastBoundRead?.contentBinding && !currentContentMatchesBinding(filePath, lastBoundRead.contentBinding) && !this.newerReadSupersedesBinding(filePath, fileReads, lastBoundRead, touchedLines, editRanges)) {
780
+ const verdict = this.blockOrWarn("file-modified", `\uD83D\uDD04 RETRYABLE — File modified since read
781
+
782
+ You last read \`${filePath}\` at ${new Date(lastBoundRead.timestamp).toISOString()}.
783
+ The file content no longer matches the bridge-recorded read.
784
+
785
+ Your mental model is out of sync with the actual file content.
786
+ To proceed:
787
+ 1. Re-read the file: \`read path="${filePath}"\``, undefined, effectiveMode);
788
+ this.recordVerdict(filePath, "edit", touchedLines, verdict, {
789
+ reasonKind: "file_modified",
790
+ lastReadTimestamp: lastBoundRead.timestamp,
791
+ contentBindingMismatch: true
792
+ });
793
+ return verdict;
794
+ }
795
+ let ignoredHashStaleness = false;
796
+ let ignoredOldTextResolvedStaleness = false;
797
+ if (this.fileTime.hasChanged(filePath)) {
798
+ const lastRead = fileReads[fileReads.length - 1];
799
+ if (options?.oldTextResolved === true) {
800
+ ignoredOldTextResolvedStaleness = true;
801
+ } else if (this.canIgnoreStalenessByHashes(filePath, fileReads, touchedLines, editRanges)) {
802
+ ignoredHashStaleness = true;
803
+ } else {
804
+ const verdict = this.blockOrWarn("file-modified", `\uD83D\uDD04 RETRYABLE — File modified since read
805
+
806
+ You last read \`${filePath}\` at ${new Date(lastRead.timestamp).toISOString()}.
807
+ The file has been modified on disk since then (auto-format, external tool, or previous edit).
808
+
809
+ Your mental model is out of sync with the actual file content.
810
+ To proceed:
811
+ 1. Re-read the file: \`read path="${filePath}"\``, undefined, effectiveMode);
812
+ this.recordVerdict(filePath, "edit", touchedLines, verdict, {
813
+ reasonKind: "file_modified",
814
+ lastReadTimestamp: lastRead.timestamp
815
+ });
816
+ return verdict;
817
+ }
818
+ }
819
+ if (!touchedLines) {
820
+ const verdict = this.allow();
821
+ this.recordVerdict(filePath, "edit", touchedLines, verdict, {
822
+ reasonKind: "no_line_info"
823
+ });
824
+ return verdict;
825
+ }
826
+ const rangesToCheck = editRanges && editRanges.length > 1 ? editRanges : [touchedLines];
827
+ let viaSymbol = false;
828
+ for (const range of rangesToCheck) {
829
+ const coverage = this.checkCoverage(filePath, range);
830
+ if (!coverage.covered) {
831
+ const lastRead = fileReads[fileReads.length - 1];
832
+ const [editStart, editEnd] = range;
833
+ const lastReadEnd = lastRead.effectiveOffset + lastRead.effectiveLimit - 1;
834
+ const outOfRangeMode = options?.oldTextResolved ? "warn" : effectiveMode;
835
+ const verdict = this.blockOrWarn("out-of-range", `\uD83D\uDD04 RETRYABLE — Edit outside read range
836
+
837
+ You read \`${filePath}\` lines ${lastRead.effectiveOffset}-${lastReadEnd}${lastRead.enclosingSymbol ? ` (${lastRead.enclosingSymbol.kind} \`${lastRead.enclosingSymbol.name}\`)` : ""}, but your edit touches lines ${editStart}-${editEnd}.
838
+
839
+ Read the relevant section first, then retry the edit:
840
+ \`read path="${filePath}" offset=${Math.max(1, editStart - 5)} limit=${Math.min(30, editEnd - editStart + 10)}\``, {
841
+ editRange: range,
842
+ readRanges: fileReads.map((r) => ({
843
+ start: r.effectiveOffset,
844
+ end: r.effectiveOffset + r.effectiveLimit - 1
845
+ })),
846
+ symbolRanges: fileReads.filter((r) => r.enclosingSymbol).map((r) => ({
847
+ name: r.enclosingSymbol.name,
848
+ start: r.enclosingSymbol.startLine,
849
+ end: r.enclosingSymbol.endLine
850
+ }))
851
+ }, outOfRangeMode);
852
+ this.recordVerdict(filePath, "edit", touchedLines, verdict, {
853
+ reasonKind: "out_of_range",
854
+ oldTextResolved: options?.oldTextResolved ?? false
855
+ });
856
+ return verdict;
857
+ }
858
+ const snapshotValidation = this.validateRangeSnapshot(filePath, range, !!options?.skipSnapshotCheck);
859
+ if (snapshotValidation.shouldBlock && !options?.skipSnapshotCheck) {
860
+ const [editStart, editEnd] = range;
861
+ const relocation = this.findRelocation(filePath, fileReads, range);
862
+ const relocationNote = relocation ? `
863
+
864
+ \uD83D\uDCCD The content you read at lines ${relocation.from[0]}-${relocation.from[1]} now appears unchanged at lines ${relocation.to[0]}-${relocation.to[1]} — it shifted position. Re-target your edit to lines ${relocation.to[0]}-${relocation.to[1]}.` : "";
865
+ const verdict = this.blockOrWarn("range-stale", `\uD83D\uDD04 RETRYABLE — Edit range changed since read
866
+
867
+ You are editing \`${filePath}\` lines ${editStart}-${editEnd}, but those lines no longer match the content you read earlier.${relocationNote}
868
+
869
+ Re-read the relevant section, then retry the edit using the current line range/content:
870
+ \`read path="${filePath}" offset=${Math.max(1, editStart - 5)} limit=${Math.min(30, editEnd - editStart + 10)}\``, {
871
+ editRange: range,
872
+ readRanges: fileReads.map((r) => ({
873
+ start: r.effectiveOffset,
874
+ end: r.effectiveOffset + r.effectiveLimit - 1
875
+ })),
876
+ symbolRanges: fileReads.filter((r) => r.enclosingSymbol).map((r) => ({
877
+ name: r.enclosingSymbol.name,
878
+ start: r.enclosingSymbol.startLine,
879
+ end: r.enclosingSymbol.endLine
880
+ })),
881
+ snapshot: {
882
+ status: snapshotValidation.status,
883
+ mismatchedLines: snapshotValidation.mismatchedLines,
884
+ missingLines: snapshotValidation.missingLines
885
+ },
886
+ ...relocation ? { relocation } : {}
887
+ }, effectiveMode);
888
+ if (relocation && rangesToCheck.length === 1) {
889
+ verdict.relocation = relocation;
890
+ }
891
+ this.recordVerdict(filePath, "edit", touchedLines, verdict, {
892
+ reasonKind: "range_stale",
893
+ range,
894
+ mismatchedLines: snapshotValidation.mismatchedLines.slice(0, 20),
895
+ relocatedTo: relocation?.to ?? null,
896
+ relocationAutoApplyOffered: !!verdict.relocation
897
+ });
898
+ return verdict;
899
+ }
900
+ if (coverage.viaSymbol)
901
+ viaSymbol = true;
902
+ }
903
+ const verdict = this.allow();
904
+ this.recordVerdict(filePath, "edit", touchedLines, verdict, {
905
+ reasonKind: ignoredOldTextResolvedStaleness ? "file_modified_oldtext_unique" : viaSymbol ? "symbol_coverage" : "range_coverage",
906
+ viaSymbol,
907
+ ignoredHashStaleness,
908
+ oldTextResolved: ignoredOldTextResolvedStaleness
909
+ });
910
+ return verdict;
911
+ }
912
+ isNewFile(filePath) {
913
+ try {
914
+ return !fs.existsSync(filePath);
915
+ } catch {
916
+ return true;
917
+ }
918
+ }
919
+ hasKnownPath(filePath) {
920
+ const stored = this.knownPathIndex.get(normalizeEphemeralMapKey(filePath));
921
+ return stored !== undefined && (this.reads.has(stored) || this.writtenThisSession.has(stored));
922
+ }
923
+ getTrackedPaths() {
924
+ const tracked = new Set(this.reads.keys());
925
+ for (const written of this.writtenThisSession.keys())
926
+ tracked.add(written);
927
+ return [...tracked];
928
+ }
929
+ forgetPath(filePath) {
930
+ const stored = this.knownPathIndex.get(normalizeEphemeralMapKey(filePath));
931
+ this.evictFile(stored ?? this.key(filePath), "external-delete");
932
+ }
933
+ noteCreatedFile(filePath, turnIndex, writeIndex, toolCallId) {
934
+ this.pendingCreations.set(normalizeEphemeralMapKey(filePath), {
935
+ turnIndex,
936
+ writeIndex,
937
+ ...toolCallId !== undefined && { toolCallId }
938
+ });
939
+ }
940
+ recordWritten(rawFilePath, opts) {
941
+ if (opts?.branchEpoch !== undefined && opts.branchEpoch !== this.currentBranchEpoch) {
942
+ incrementDegradationCount({
943
+ kind: "read-guard-write-after-branch-move",
944
+ subject: "recordWritten",
945
+ reason: `a write captured at branch epoch ${opts.branchEpoch} landed at ${this.currentBranchEpoch}; not credited to the new branch`
946
+ });
947
+ return;
948
+ }
949
+ const filePath = this.key(rawFilePath);
950
+ this.knownPathIndex.set(normalizeEphemeralMapKey(rawFilePath), filePath);
951
+ if (opts?.stampFileTime !== false)
952
+ this.fileTime.read(filePath);
953
+ this.creditAuthorship(filePath, opts);
954
+ if (this.reads.has(filePath))
955
+ this.consumedReadFiles.add(filePath);
956
+ this.touchFile(filePath);
957
+ this.enforceFileCap();
958
+ const creationKey = normalizeEphemeralMapKey(rawFilePath);
959
+ const creation = this.pendingCreations.get(creationKey);
960
+ if (creation) {
961
+ this.pendingCreations.delete(creationKey);
962
+ this.injectCreationRead(filePath, creation.turnIndex, creation.writeIndex, creation.toolCallId, opts?.writtenContent);
963
+ }
964
+ }
965
+ addExemption(filePath) {
966
+ this.exemptions.add(this.key(filePath));
967
+ logReadGuardEvent({
968
+ event: "exemption_added",
969
+ sessionId: this.sessionId,
970
+ filePath,
971
+ metadata: {
972
+ source: "lens-allow-edit"
973
+ }
974
+ });
975
+ }
976
+ getSummary() {
977
+ let totalEdits = 0;
978
+ let totalBlocks = 0;
979
+ let lspExpansionsHelped = 0;
980
+ const byReason = {};
981
+ const byFile = {};
982
+ for (const [filePath, records] of this.edits) {
983
+ for (const record of records) {
984
+ totalEdits++;
985
+ byFile[filePath] = byFile[filePath] ?? { edits: 0, blocks: 0 };
986
+ byFile[filePath].edits++;
987
+ if (record.verdict === "blocked") {
988
+ totalBlocks++;
989
+ byFile[filePath].blocks++;
990
+ }
991
+ if (record.reason) {
992
+ byReason[record.reason] = (byReason[record.reason] ?? 0) + 1;
993
+ }
994
+ if (record.precedingReads.some((r) => r.expandedByLsp) && record.verdict === "allowed") {
995
+ lspExpansionsHelped++;
996
+ }
997
+ }
998
+ }
999
+ return {
1000
+ totalEdits,
1001
+ totalBlocks,
1002
+ byReason,
1003
+ byFile,
1004
+ lspExpansionsHelped
1005
+ };
1006
+ }
1007
+ getReadHistory(filePath) {
1008
+ const key = this.key(filePath);
1009
+ if (this.reads.has(key))
1010
+ this.touchFile(key);
1011
+ return this.reads.get(key) ?? [];
1012
+ }
1013
+ contentMatchesLastRead(filePath) {
1014
+ const reads = this.getReadHistory(filePath);
1015
+ const binding = [...reads].reverse().find((read) => read.contentBinding?.fullFile)?.contentBinding;
1016
+ return binding === undefined ? undefined : currentContentMatchesBinding(filePath, binding);
1017
+ }
1018
+ getTrimStats(filePath) {
1019
+ const stats = this.trimAccumulators.get(this.key(filePath));
1020
+ return stats ? { ...stats } : undefined;
1021
+ }
1022
+ exportState() {
1023
+ return {
1024
+ version: READ_GUARD_STATE_VERSION,
1025
+ reads: [...this.reads.entries()].map(([key, records]) => [
1026
+ key,
1027
+ records.map((record) => ({ ...record }))
1028
+ ])
1029
+ };
1030
+ }
1031
+ exportAuthorship() {
1032
+ return {
1033
+ written: [...this.writtenThisSession].flatMap(([filePath, authored]) => authored.retired ? [] : [filePath]),
1034
+ entries: [...this.writtenThisSession].map(([filePath, authored]) => ({
1035
+ filePath,
1036
+ ...authored
1037
+ }))
1038
+ };
1039
+ }
1040
+ importAuthorship(state, onBranch) {
1041
+ const result = { imported: 0, dropped: 0 };
1042
+ const authorship = state;
1043
+ const entries = Array.isArray(authorship?.entries) ? authorship.entries : [];
1044
+ const withEntry = new Set;
1045
+ for (const entry of entries) {
1046
+ const candidate = entry;
1047
+ if (typeof candidate?.filePath !== "string")
1048
+ continue;
1049
+ withEntry.add(candidate.filePath);
1050
+ if (typeof candidate.toolCallId !== "string" || !onBranch.has(candidate.toolCallId) || typeof candidate.size !== "number" || typeof candidate.mtimeMs !== "number" || typeof candidate.ctimeMs !== "number" || candidate.hash !== undefined && typeof candidate.hash !== "string" || candidate.retired !== undefined && candidate.retired !== true || candidate.authoredRanges !== undefined && !isValidAuthoredRanges(candidate.authoredRanges) || candidate.authoredLineCount !== undefined && typeof candidate.authoredLineCount !== "number") {
1051
+ result.dropped += 1;
1052
+ continue;
1053
+ }
1054
+ const filePath = this.key(candidate.filePath);
1055
+ this.knownPathIndex.set(normalizeEphemeralMapKey(candidate.filePath), filePath);
1056
+ this.writtenThisSession.set(filePath, {
1057
+ size: candidate.size,
1058
+ mtimeMs: candidate.mtimeMs,
1059
+ ctimeMs: candidate.ctimeMs,
1060
+ ...candidate.hash !== undefined && { hash: candidate.hash },
1061
+ toolCallId: candidate.toolCallId,
1062
+ ...candidate.retired === true && { retired: true },
1063
+ ...candidate.authoredRanges !== undefined && {
1064
+ authoredRanges: candidate.authoredRanges
1065
+ },
1066
+ ...candidate.authoredLineCount !== undefined && {
1067
+ authoredLineCount: candidate.authoredLineCount
1068
+ }
1069
+ });
1070
+ result.imported += 1;
1071
+ }
1072
+ this.enforceAuthorshipCap();
1073
+ if (Array.isArray(authorship?.written)) {
1074
+ for (const filePath of authorship.written)
1075
+ if (typeof filePath === "string" && !withEntry.has(filePath))
1076
+ result.dropped += 1;
1077
+ }
1078
+ return result;
1079
+ }
1080
+ retainBranch(onBranch) {
1081
+ const result = { kept: 0, dropped: 0 };
1082
+ for (const [filePath, records] of this.reads) {
1083
+ const kept = [];
1084
+ for (const read of records)
1085
+ if (read.toolCallId !== undefined && onBranch.has(read.toolCallId))
1086
+ kept.push(read);
1087
+ result.kept += kept.length;
1088
+ result.dropped += records.length - kept.length;
1089
+ if (kept.length > 0) {
1090
+ this.reads.set(filePath, kept);
1091
+ continue;
1092
+ }
1093
+ this.reads.delete(filePath);
1094
+ }
1095
+ for (const [filePath, authored] of this.writtenThisSession)
1096
+ if (authored.toolCallId === undefined || !onBranch.has(authored.toolCallId))
1097
+ this.writtenThisSession.delete(filePath);
1098
+ this.edits.clear();
1099
+ this.expiredWrites.clear();
1100
+ this.pendingCreations.clear();
1101
+ this.checkedPathsByCall.clear();
1102
+ this.fileTime.clear();
1103
+ moveBranch(this.scope);
1104
+ return result;
1105
+ }
1106
+ get currentBranchEpoch() {
1107
+ return this.scope.branchEpoch();
1108
+ }
1109
+ get lineageKey() {
1110
+ return `${process.pid}:${this.scope.scopeId}`;
1111
+ }
1112
+ importBranch(state, onBranch) {
1113
+ const result = { imported: 0, dropped: 0 };
1114
+ if (!state || state.version !== READ_GUARD_STATE_VERSION)
1115
+ return result;
1116
+ if (!Array.isArray(state.reads))
1117
+ return result;
1118
+ for (const entry of state.reads) {
1119
+ if (!Array.isArray(entry) || entry.length !== 2)
1120
+ continue;
1121
+ const [rawPath, records] = entry;
1122
+ if (typeof rawPath !== "string")
1123
+ continue;
1124
+ if (!Array.isArray(records) || records.length === 0)
1125
+ continue;
1126
+ const filePath = this.key(rawPath);
1127
+ const exists = fs.existsSync(filePath);
1128
+ for (const read of records) {
1129
+ const id = read?.toolCallId;
1130
+ if (!exists || typeof id !== "string" || !onBranch.has(id)) {
1131
+ result.dropped += 1;
1132
+ continue;
1133
+ }
1134
+ this.recordRead({ ...read, filePath, lineHashes: read.lineHashes ?? {} }, { stampFileTime: false });
1135
+ result.imported += 1;
1136
+ }
1137
+ }
1138
+ return result;
1139
+ }
1140
+ getEditHistory(filePath) {
1141
+ const key = this.key(filePath);
1142
+ if (this.edits.has(key))
1143
+ this.touchFile(key);
1144
+ return this.edits.get(key) ?? [];
1145
+ }
1146
+ mayAdvanceAuthorship(filePath, opts) {
1147
+ if (opts?.advanceAuthorship === undefined)
1148
+ return true;
1149
+ if (opts.advanceAuthorship !== true)
1150
+ return false;
1151
+ return this.consumeCheckedAtCall(opts.toolCallId, filePath);
1152
+ }
1153
+ creditAuthorship(filePath, opts) {
1154
+ const existing = this.writtenThisSession.get(filePath);
1155
+ if (!existing && opts?.allowFirstAuthorship === false)
1156
+ return;
1157
+ if (existing?.retired)
1158
+ return;
1159
+ if (existing && !this.mayAdvanceAuthorship(filePath, opts)) {
1160
+ this.retireIfChanged(filePath, "bridge");
1161
+ return;
1162
+ }
1163
+ if (opts?.authorship === "unknown" && !existing)
1164
+ return;
1165
+ const keeps = opts?.authorship !== "unknown" || (this.reads.get(filePath)?.some((read) => read.toolCallId !== undefined) ?? false);
1166
+ const nextRanges = !existing ? opts?.authoredRanges : keeps && existing.authoredRanges === undefined ? undefined : opts?.authoredRanges ?? [];
1167
+ const observed = observeAuthoredBytes(filePath, opts?.contentHash, nextRanges);
1168
+ const { authoredRanges: _observedRanges, ...observedWithoutRanges } = observed;
1169
+ const composedRanges = nextRanges !== undefined && keeps && existing?.authoredRanges !== undefined ? composeAuthoredRanges(existing, nextRanges, observed.authoredLineCount) : nextRanges;
1170
+ const toolCallId = opts?.toolCallId ?? existing?.toolCallId;
1171
+ this.writtenThisSession.delete(filePath);
1172
+ this.writtenThisSession.set(filePath, {
1173
+ ...observedWithoutRanges,
1174
+ ...composedRanges !== undefined ? {
1175
+ authoredRanges: composedRanges,
1176
+ ...observed.authoredLineCount !== undefined && {
1177
+ authoredLineCount: observed.authoredLineCount
1178
+ }
1179
+ } : {},
1180
+ ...toolCallId !== undefined && { toolCallId }
1181
+ });
1182
+ this.enforceAuthorshipCap();
1183
+ }
1184
+ injectCreationRead(filePath, turnIndex, writeIndex, toolCallId, writtenContent) {
1185
+ let evidence;
1186
+ try {
1187
+ evidence = writtenContent !== undefined ? deliveredLineEvidence(writtenContent, 1) : {
1188
+ lineCount: splitLines(fs.readFileSync(filePath, "utf-8")).length,
1189
+ lineHashes: undefined
1190
+ };
1191
+ } catch {
1192
+ return;
1193
+ }
1194
+ const { lineCount, lineHashes } = evidence;
1195
+ if (lineCount === 0)
1196
+ return;
1197
+ this.recordRead({
1198
+ filePath,
1199
+ requestedOffset: 1,
1200
+ requestedLimit: lineCount,
1201
+ effectiveOffset: 1,
1202
+ effectiveLimit: lineCount,
1203
+ expandedByLsp: false,
1204
+ ...lineHashes && { lineHashes },
1205
+ turnIndex,
1206
+ writeIndex,
1207
+ timestamp: Date.now(),
1208
+ ...toolCallId !== undefined && { toolCallId }
1209
+ });
1210
+ }
1211
+ canIgnoreStalenessByHashes(filePath, reads, touchedLines, editRanges) {
1212
+ let lines;
1213
+ try {
1214
+ lines = splitLines(fs.readFileSync(filePath, "utf-8"));
1215
+ } catch {
1216
+ return false;
1217
+ }
1218
+ const rangesToCheck = touchedLines ? editRanges && editRanges.length > 1 ? editRanges : [touchedLines] : undefined;
1219
+ if (!rangesToCheck) {
1220
+ const lastRead = reads.at(-1);
1221
+ return !!lastRead && this.readHashesStillMatch(lastRead, lines);
1222
+ }
1223
+ return rangesToCheck.every(([startLine, endLine]) => {
1224
+ for (let lineNo = startLine;lineNo <= endLine; lineNo += 1) {
1225
+ const view = newestViewOfLine(reads, lineNo);
1226
+ if (!view || !this.readRangeHashesStillMatch(view, lines, [lineNo, lineNo])) {
1227
+ return false;
1228
+ }
1229
+ }
1230
+ return true;
1231
+ });
1232
+ }
1233
+ validateRangeSnapshot(filePath, [startLine, endLine], snapshotCheckSkipped) {
1234
+ const reads = this.reads.get(filePath) ?? [];
1235
+ const runs = [];
1236
+ const missingLines = [];
1237
+ for (let lineNo = startLine;lineNo <= endLine; lineNo += 1) {
1238
+ const view = newestViewOfLine(reads, lineNo);
1239
+ if (!view || view.lineHashes?.[lineNo] === undefined) {
1240
+ missingLines.push(lineNo);
1241
+ continue;
1242
+ }
1243
+ const last = runs.at(-1);
1244
+ if (last?.read === view && last.range[1] === lineNo - 1) {
1245
+ last.range[1] = lineNo;
1246
+ } else {
1247
+ runs.push({ read: view, range: [lineNo, lineNo] });
1248
+ }
1249
+ }
1250
+ const mismatchedLines = [];
1251
+ let checkedLineCount = 0;
1252
+ for (const { read, range } of runs) {
1253
+ checkedLineCount += range[1] - range[0] + 1;
1254
+ mismatchedLines.push(...currentLinesMatchReadSnapshot(filePath, read, range).mismatchedLines);
1255
+ }
1256
+ const status = mismatchedLines.length > 0 ? "mismatch" : missingLines.length === 0 ? "match" : "unavailable";
1257
+ const shouldBlock = status === "mismatch";
1258
+ const outcome = shouldBlock ? snapshotCheckSkipped ? "bypassed-content-match" : "enforced-block" : status === "match" ? "enforced-pass" : "not-decidable";
1259
+ logReadGuardEvent({
1260
+ event: "range_snapshot_validation",
1261
+ sessionId: this.sessionId,
1262
+ filePath,
1263
+ metadata: {
1264
+ range: [startLine, endLine],
1265
+ status,
1266
+ viewRunCount: runs.length,
1267
+ checkedLineCount,
1268
+ missingLineCount: missingLines.length,
1269
+ mismatchedLineCount: mismatchedLines.length,
1270
+ missingLines: missingLines.slice(0, 20),
1271
+ mismatchedLines: mismatchedLines.slice(0, 20),
1272
+ enforced: shouldBlock || status === "match",
1273
+ outcome
1274
+ }
1275
+ });
1276
+ return { status, missingLines, mismatchedLines, shouldBlock };
1277
+ }
1278
+ readRangeHashesStillMatch(read, lines, [startLine, endLine]) {
1279
+ const hashes = read.lineHashes ?? {};
1280
+ for (let lineNo = startLine;lineNo <= endLine; lineNo += 1) {
1281
+ if (!readRangeCoversLine(read, lineNo) || hashes[lineNo] === undefined) {
1282
+ return false;
1283
+ }
1284
+ if (lineNo < 1 || lineNo > lines.length)
1285
+ return false;
1286
+ if (lineContentHash(lines[lineNo - 1] ?? "") !== hashes[lineNo]) {
1287
+ return false;
1288
+ }
1289
+ }
1290
+ return true;
1291
+ }
1292
+ newerReadSupersedesBinding(filePath, fileReads, boundRead, touchedLines, editRanges) {
1293
+ if (!touchedLines)
1294
+ return false;
1295
+ const rangesToCheck = editRanges && editRanges.length > 1 ? editRanges : [touchedLines];
1296
+ const boundIndex = fileReads.lastIndexOf(boundRead);
1297
+ if (boundIndex < 0)
1298
+ return false;
1299
+ for (const candidate of fileReads.slice(boundIndex + 1).reverse()) {
1300
+ if (candidate.provisional === true)
1301
+ continue;
1302
+ const deliversEveryEditedLine = rangesToCheck.every((range) => {
1303
+ const evidence = currentLinesMatchReadSnapshot(filePath, candidate, range);
1304
+ return evidence.checked && evidence.matches;
1305
+ });
1306
+ if (deliversEveryEditedLine)
1307
+ return true;
1308
+ }
1309
+ return false;
1310
+ }
1311
+ findRelocation(filePath, reads, [startLine, endLine]) {
1312
+ const span = endLine - startLine + 1;
1313
+ if (span < 2)
1314
+ return;
1315
+ const source = newestViewOfLine(reads, startLine);
1316
+ if (!source?.lineHashes)
1317
+ return;
1318
+ const wanted = [];
1319
+ for (let lineNo = startLine;lineNo <= endLine; lineNo += 1) {
1320
+ const hash = source.lineHashes[lineNo];
1321
+ if (hash === undefined || newestViewOfLine(reads, lineNo) !== source) {
1322
+ return;
1323
+ }
1324
+ wanted.push(hash);
1325
+ }
1326
+ let lines;
1327
+ try {
1328
+ lines = splitLines(fs.readFileSync(filePath, "utf-8"));
1329
+ } catch {
1330
+ return;
1331
+ }
1332
+ const currentHashes = lines.map((line) => lineContentHash(line));
1333
+ const lastStart = currentHashes.length - span;
1334
+ const matchStarts = [];
1335
+ for (let i = 0;i <= lastStart; i += 1) {
1336
+ let ok = true;
1337
+ for (let j = 0;j < span; j += 1) {
1338
+ if (currentHashes[i + j] !== wanted[j]) {
1339
+ ok = false;
1340
+ break;
1341
+ }
1342
+ }
1343
+ if (ok)
1344
+ matchStarts.push(i + 1);
1345
+ }
1346
+ let newStart;
1347
+ if (matchStarts.length === 1) {
1348
+ newStart = matchStarts[0];
1349
+ } else if (matchStarts.length > 1) {
1350
+ const appliedEdits = (this.edits.get(filePath) ?? []).filter((record) => record.verdict !== "blocked").length;
1351
+ const window = Math.min(RELOCATION_WINDOW_MAX, Math.max(RELOCATION_WINDOW_MIN, appliedEdits * RELOCATION_WINDOW_PER_EDIT));
1352
+ const lo = startLine - window;
1353
+ const hi = endLine + window;
1354
+ const local = matchStarts.filter((start) => start >= lo && start <= hi);
1355
+ if (local.length === 1)
1356
+ newStart = local[0];
1357
+ }
1358
+ if (newStart === undefined || newStart === startLine)
1359
+ return;
1360
+ return { from: [startLine, endLine], to: [newStart, newStart + span - 1] };
1361
+ }
1362
+ readHashesStillMatch(read, lines) {
1363
+ const entries = Object.entries(read.lineHashes ?? {});
1364
+ if (entries.length === 0)
1365
+ return false;
1366
+ for (const [lineText, expected] of entries) {
1367
+ const lineNo = Number(lineText);
1368
+ if (!Number.isInteger(lineNo) || lineNo < 1 || lineNo > lines.length) {
1369
+ return false;
1370
+ }
1371
+ if (lineContentHash(lines[lineNo - 1] ?? "") !== expected)
1372
+ return false;
1373
+ }
1374
+ return true;
1375
+ }
1376
+ checkCoverage(filePath, touchedLines) {
1377
+ const [editStart, editEnd] = touchedLines;
1378
+ const reads = this.reads.get(filePath) ?? [];
1379
+ for (const read of reads) {
1380
+ if (read.provisional === true)
1381
+ continue;
1382
+ const readStart = Math.max(1, read.effectiveOffset - this.config.contextLines);
1383
+ const readEnd = read.effectiveOffset + read.effectiveLimit - 1 + this.config.contextLines;
1384
+ if (editStart >= readStart && editEnd <= readEnd) {
1385
+ return { covered: true, viaSymbol: false };
1386
+ }
1387
+ if (read.enclosingSymbol) {
1388
+ const symStart = read.enclosingSymbol.startLine;
1389
+ const symEnd = read.enclosingSymbol.endLine;
1390
+ if (symStart <= editStart && symEnd >= editEnd) {
1391
+ return { covered: true, viaSymbol: true };
1392
+ }
1393
+ }
1394
+ }
1395
+ const intervals = reads.filter((read) => read.provisional !== true).map((read) => [
1396
+ Math.max(1, read.effectiveOffset - this.config.contextLines),
1397
+ read.effectiveOffset + read.effectiveLimit - 1 + this.config.contextLines
1398
+ ]);
1399
+ intervals.sort((a, b) => a[0] - b[0]);
1400
+ const merged = [];
1401
+ for (const [s, e] of intervals) {
1402
+ if (merged.length > 0 && s <= merged[merged.length - 1][1] + 1) {
1403
+ merged[merged.length - 1][1] = Math.max(merged[merged.length - 1][1], e);
1404
+ } else {
1405
+ merged.push([s, e]);
1406
+ }
1407
+ }
1408
+ for (const [s, e] of merged) {
1409
+ if (editStart >= s && editEnd <= e) {
1410
+ return { covered: true, viaSymbol: false };
1411
+ }
1412
+ }
1413
+ return { covered: false, viaSymbol: false };
1414
+ }
1415
+ getExemptionMode(filePath) {
1416
+ for (const exemption of this.config.exemptions) {
1417
+ if (this.matchesPattern(filePath, exemption.pattern)) {
1418
+ return exemption.mode;
1419
+ }
1420
+ }
1421
+ return null;
1422
+ }
1423
+ matchesPattern(filePath, pattern) {
1424
+ if (pattern.startsWith("*")) {
1425
+ const suffix = pattern.slice(1);
1426
+ return filePath.endsWith(suffix);
1427
+ }
1428
+ if (pattern.includes("*")) {
1429
+ const collapsedPattern = pattern.replace(/\*+/g, "*");
1430
+ const regex = new RegExp(`^${collapsedPattern.replace(/\\/g, "\\\\").replace(/\./g, "\\.").replace(/\*/g, ".*")}$`);
1431
+ return regex.test(filePath);
1432
+ }
1433
+ return filePath === pattern;
1434
+ }
1435
+ blockOrWarn(_reason, message, details, overrideMode) {
1436
+ const mode = overrideMode ?? this.config.mode;
1437
+ if (mode === "warn") {
1438
+ return { action: "warn", reason: message, details };
1439
+ }
1440
+ return { action: "block", reason: message, details };
1441
+ }
1442
+ allow() {
1443
+ return { action: "allow" };
1444
+ }
1445
+ recordEdit(filePath, tool, touchedLines, verdict) {
1446
+ this.touchFile(filePath);
1447
+ const arr = this.edits.get(filePath) ?? [];
1448
+ arr.push({
1449
+ filePath,
1450
+ tool,
1451
+ touchedLines,
1452
+ precedingReads: this.reads.get(filePath) ?? [],
1453
+ verdict: mapVerdictAction(verdict.action),
1454
+ reason: verdict.reason,
1455
+ timestamp: Date.now()
1456
+ });
1457
+ if (arr.length > READ_GUARD_MAX_EDITS_PER_FILE) {
1458
+ const trimmedCount = arr.length - READ_GUARD_MAX_EDITS_PER_FILE;
1459
+ arr.splice(0, trimmedCount);
1460
+ const isRisingEdge = incrementDegradationCount({
1461
+ kind: "read-guard-edits-cap-trim",
1462
+ subject: filePath,
1463
+ reason: `trimmed ${trimmedCount} edit record(s) past cap`
1464
+ });
1465
+ if (isRisingEdge) {
1466
+ logReadGuardEvent({
1467
+ event: "edits_cap_trimmed",
1468
+ sessionId: this.sessionId,
1469
+ filePath,
1470
+ metadata: { trimmedCount, cappedLength: arr.length }
1471
+ });
1472
+ }
1473
+ }
1474
+ this.edits.set(filePath, arr);
1475
+ }
1476
+ recordVerdict(filePath, tool, touchedLines, verdict, metadata = {}) {
1477
+ const normalizedTouchedLines = touchedLines ?? [1, 1];
1478
+ this.recordEdit(filePath, tool, normalizedTouchedLines, verdict);
1479
+ const reads = this.reads.get(filePath) ?? [];
1480
+ logReadGuardEvent({
1481
+ event: verdict.action === "allow" ? "edit_allowed" : verdict.action === "warn" ? "edit_warned" : "edit_blocked",
1482
+ sessionId: this.sessionId,
1483
+ filePath,
1484
+ metadata: {
1485
+ tool,
1486
+ touchedLines: touchedLines ?? null,
1487
+ normalizedTouchedLines,
1488
+ readCount: reads.length,
1489
+ reads: reads.map((read) => ({
1490
+ requestedOffset: read.requestedOffset,
1491
+ requestedLimit: read.requestedLimit,
1492
+ effectiveOffset: read.effectiveOffset,
1493
+ effectiveLimit: read.effectiveLimit,
1494
+ expandedByLsp: read.expandedByLsp,
1495
+ enclosingSymbol: read.enclosingSymbol ?? null,
1496
+ timestamp: read.timestamp
1497
+ })),
1498
+ verdictAction: verdict.action,
1499
+ details: verdict.details,
1500
+ ...metadata
1501
+ }
1502
+ });
1503
+ }
1504
+ }
1505
+ function mapVerdictAction(action) {
1506
+ switch (action) {
1507
+ case "allow":
1508
+ return "allowed";
1509
+ case "block":
1510
+ return "blocked";
1511
+ case "warn":
1512
+ return "warned";
1513
+ }
1514
+ }
1515
+ export function createReadGuard(sessionId, config) {
1516
+ return new ReadGuard(sessionId, config);
1517
+ }