@maverickcer/env-cap 0.7.4 → 0.7.6

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 (353) hide show
  1. package/ADOPTION.md +106 -124
  2. package/AGENTS.md +94 -128
  3. package/CHANGELOG.md +42 -0
  4. package/CODE_REVIEW.md +69 -173
  5. package/CONTRIBUTING.md +57 -74
  6. package/GUIDE.md +405 -866
  7. package/README.md +112 -89
  8. package/RELEASING.md +81 -65
  9. package/SECURITY.md +76 -227
  10. package/SUPPORT.md +21 -45
  11. package/VERSIONING.md +69 -105
  12. package/benchmarks/READING-BENCHMARKS.md +103 -81
  13. package/benchmarks/README.md +12 -9
  14. package/benchmarks/WRITING-BENCHMARKS.md +90 -80
  15. package/benchmarks/performance-buildtime/BENCHMARKS.md +20 -20
  16. package/benchmarks/performance-runtime/BENCHMARKS.md +107 -107
  17. package/dist/.dts/_ipc/build-fs.d.ts +12 -17
  18. package/dist/.dts/_ipc/build-fs.d.ts.map +1 -1
  19. package/dist/.dts/_ipc/compiler-api.d.ts +6 -6
  20. package/dist/.dts/_ipc/display-path.d.ts +1 -1
  21. package/dist/.dts/_ipc/display-path.d.ts.map +1 -1
  22. package/dist/.dts/_ipc/generated-banner.d.ts +8 -8
  23. package/dist/.dts/_ipc/glob.d.ts +9 -8
  24. package/dist/.dts/_ipc/glob.d.ts.map +1 -1
  25. package/dist/.dts/_ipc/no-node-fs.d.ts +2 -2
  26. package/dist/.dts/_ipc/no-node-fs.d.ts.map +1 -1
  27. package/dist/.dts/_ipc/resolve-tsconfig-paths.d.ts +16 -16
  28. package/dist/.dts/_ipc/resolve-tsconfig-paths.d.ts.map +1 -1
  29. package/dist/.dts/_ipc/typescript.d.ts +4 -4
  30. package/dist/.dts/build/assemble-project.d.ts +14 -15
  31. package/dist/.dts/build/assemble-project.d.ts.map +1 -1
  32. package/dist/.dts/build/change-model.d.ts +14 -14
  33. package/dist/.dts/build/change-model.d.ts.map +1 -1
  34. package/dist/.dts/build/check-artifacts.d.ts +4 -4
  35. package/dist/.dts/build/check-artifacts.d.ts.map +1 -1
  36. package/dist/.dts/build/citation-verification.d.ts +13 -14
  37. package/dist/.dts/build/citation-verification.d.ts.map +1 -1
  38. package/dist/.dts/build/compatibility.d.ts +24 -24
  39. package/dist/.dts/build/compatibility.d.ts.map +1 -1
  40. package/dist/.dts/build/contract-model.d.ts +10 -10
  41. package/dist/.dts/build/contract-model.d.ts.map +1 -1
  42. package/dist/.dts/build/deep-equal.d.ts +2 -2
  43. package/dist/.dts/build/deep-freeze.d.ts +2 -2
  44. package/dist/.dts/build/dependency-graph.d.ts +48 -55
  45. package/dist/.dts/build/dependency-graph.d.ts.map +1 -1
  46. package/dist/.dts/build/dependency-model.d.ts +18 -18
  47. package/dist/.dts/build/dependency-model.d.ts.map +1 -1
  48. package/dist/.dts/build/discover.d.ts +11 -11
  49. package/dist/.dts/build/discover.d.ts.map +1 -1
  50. package/dist/.dts/build/docs.d.ts +34 -38
  51. package/dist/.dts/build/docs.d.ts.map +1 -1
  52. package/dist/.dts/build/env-example.d.ts +13 -13
  53. package/dist/.dts/build/env-example.d.ts.map +1 -1
  54. package/dist/.dts/build/errors.d.ts +8 -8
  55. package/dist/.dts/build/evidence-cache.d.ts +23 -23
  56. package/dist/.dts/build/evidence-cache.d.ts.map +1 -1
  57. package/dist/.dts/build/evidence-model.d.ts +3 -3
  58. package/dist/.dts/build/evidence-reference.d.ts +15 -15
  59. package/dist/.dts/build/evidence-reference.d.ts.map +1 -1
  60. package/dist/.dts/build/evidence-snapshot.d.ts +47 -53
  61. package/dist/.dts/build/evidence-snapshot.d.ts.map +1 -1
  62. package/dist/.dts/build/exclusive-group.d.ts +4 -4
  63. package/dist/.dts/build/exclusive-group.d.ts.map +1 -1
  64. package/dist/.dts/build/finding-model.d.ts +12 -12
  65. package/dist/.dts/build/finding-model.d.ts.map +1 -1
  66. package/dist/.dts/build/generate-documentation.d.ts +19 -19
  67. package/dist/.dts/build/generate-documentation.d.ts.map +1 -1
  68. package/dist/.dts/build/generate-env-artifacts.d.ts +43 -43
  69. package/dist/.dts/build/generate-env-artifacts.d.ts.map +1 -1
  70. package/dist/.dts/build/generate-evidence.d.ts +19 -19
  71. package/dist/.dts/build/generate-evidence.d.ts.map +1 -1
  72. package/dist/.dts/build/generate-manifest.d.ts +11 -12
  73. package/dist/.dts/build/generate-manifest.d.ts.map +1 -1
  74. package/dist/.dts/build/generate-usage.d.ts +23 -24
  75. package/dist/.dts/build/generate-usage.d.ts.map +1 -1
  76. package/dist/.dts/build/generated-banner.d.ts +5 -5
  77. package/dist/.dts/build/governance-fields.d.ts +7 -7
  78. package/dist/.dts/build/humanize-key.d.ts +1 -1
  79. package/dist/.dts/build/humanize-key.d.ts.map +1 -1
  80. package/dist/.dts/build/index.d.ts +20 -36
  81. package/dist/.dts/build/index.d.ts.map +1 -1
  82. package/dist/.dts/build/lifecycle-model.d.ts +90 -83
  83. package/dist/.dts/build/lifecycle-model.d.ts.map +1 -1
  84. package/dist/.dts/build/link.d.ts +38 -39
  85. package/dist/.dts/build/link.d.ts.map +1 -1
  86. package/dist/.dts/build/literal-eval.d.ts +2 -2
  87. package/dist/.dts/build/literal-eval.d.ts.map +1 -1
  88. package/dist/.dts/build/live-expirations.d.ts +14 -13
  89. package/dist/.dts/build/live-expirations.d.ts.map +1 -1
  90. package/dist/.dts/build/manifest.d.ts +6 -6
  91. package/dist/.dts/build/map-utils.d.ts +4 -4
  92. package/dist/.dts/build/merge-documentation.d.ts +9 -8
  93. package/dist/.dts/build/merge-documentation.d.ts.map +1 -1
  94. package/dist/.dts/build/ownership-model.d.ts +14 -15
  95. package/dist/.dts/build/ownership-model.d.ts.map +1 -1
  96. package/dist/.dts/build/parse.d.ts +20 -21
  97. package/dist/.dts/build/parse.d.ts.map +1 -1
  98. package/dist/.dts/build/reference-projections.d.ts +36 -38
  99. package/dist/.dts/build/reference-projections.d.ts.map +1 -1
  100. package/dist/.dts/build/resolution/resolve-import.d.ts +18 -14
  101. package/dist/.dts/build/resolution/resolve-import.d.ts.map +1 -1
  102. package/dist/.dts/build/resolution/resolve-package-schema.d.ts +26 -26
  103. package/dist/.dts/build/resolution/resolve-package-schema.d.ts.map +1 -1
  104. package/dist/.dts/build/resolution/resolve-within-root.d.ts +9 -9
  105. package/dist/.dts/build/sarif.d.ts +5 -5
  106. package/dist/.dts/build/sarif.d.ts.map +1 -1
  107. package/dist/.dts/build/scan-dependencies.d.ts +17 -16
  108. package/dist/.dts/build/scan-dependencies.d.ts.map +1 -1
  109. package/dist/.dts/build/sort-by-identity.d.ts +1 -1
  110. package/dist/.dts/build/source-position.d.ts +13 -13
  111. package/dist/.dts/build/tool-version.d.ts +1 -1
  112. package/dist/.dts/build/usage-report.d.ts +19 -19
  113. package/dist/.dts/build/usage-report.d.ts.map +1 -1
  114. package/dist/.dts/eslint-plugin/index.d.ts +16 -5
  115. package/dist/.dts/eslint-plugin/index.d.ts.map +1 -1
  116. package/dist/.dts/eslint-plugin/no-raw-process-env.d.ts +4 -4
  117. package/dist/.dts/evidence/define-projection.d.ts +15 -16
  118. package/dist/.dts/evidence/define-projection.d.ts.map +1 -1
  119. package/dist/.dts/evidence/index.d.ts +11 -15
  120. package/dist/.dts/evidence/index.d.ts.map +1 -1
  121. package/dist/.dts/helpers/index.d.ts +15 -18
  122. package/dist/.dts/helpers/index.d.ts.map +1 -1
  123. package/dist/.dts/helpers/validators.d.ts +2 -2
  124. package/dist/.dts/helpers/validators.d.ts.map +1 -1
  125. package/dist/.dts/node/index.d.ts +19 -0
  126. package/dist/.dts/node/index.d.ts.map +1 -1
  127. package/dist/.dts/runtime/create.d.ts +6 -3
  128. package/dist/.dts/runtime/create.d.ts.map +1 -1
  129. package/dist/.dts/runtime/document.d.ts +91 -97
  130. package/dist/.dts/runtime/document.d.ts.map +1 -1
  131. package/dist/.dts/runtime/errors.d.ts +5 -5
  132. package/dist/.dts/runtime/index.d.ts +11 -10
  133. package/dist/.dts/runtime/index.d.ts.map +1 -1
  134. package/dist/.dts/runtime/reset.d.ts +1 -1
  135. package/dist/.dts/runtime/types.d.ts +39 -24
  136. package/dist/.dts/runtime/types.d.ts.map +1 -1
  137. package/dist/.dts/runtime/validate.d.ts +15 -2
  138. package/dist/.dts/runtime/validate.d.ts.map +1 -1
  139. package/dist/.dts7/_ipc/build-fs.d.ts +48 -0
  140. package/dist/.dts7/_ipc/build-fs.d.ts.map +1 -0
  141. package/dist/.dts7/_ipc/compiler-api.d.ts +17 -0
  142. package/dist/.dts7/_ipc/compiler-api.d.ts.map +1 -0
  143. package/dist/.dts7/_ipc/display-path.d.ts +27 -0
  144. package/dist/.dts7/_ipc/display-path.d.ts.map +1 -0
  145. package/dist/.dts7/_ipc/generated-banner.d.ts +58 -0
  146. package/dist/.dts7/_ipc/generated-banner.d.ts.map +1 -0
  147. package/dist/.dts7/_ipc/glob.d.ts +23 -0
  148. package/dist/.dts7/_ipc/glob.d.ts.map +1 -0
  149. package/dist/.dts7/_ipc/no-node-fs.d.ts +21 -0
  150. package/dist/.dts7/_ipc/no-node-fs.d.ts.map +1 -0
  151. package/dist/.dts7/_ipc/resolve-tsconfig-paths.d.ts +134 -0
  152. package/dist/.dts7/_ipc/resolve-tsconfig-paths.d.ts.map +1 -0
  153. package/dist/.dts7/_ipc/typescript.d.ts +20 -0
  154. package/dist/.dts7/_ipc/typescript.d.ts.map +1 -0
  155. package/dist/.dts7/build/assemble-project.d.ts +46 -0
  156. package/dist/.dts7/build/assemble-project.d.ts.map +1 -0
  157. package/dist/.dts7/build/change-model.d.ts +63 -0
  158. package/dist/.dts7/build/change-model.d.ts.map +1 -0
  159. package/dist/.dts7/build/check-artifacts.d.ts +48 -0
  160. package/dist/.dts7/build/check-artifacts.d.ts.map +1 -0
  161. package/dist/.dts7/build/citation-verification.d.ts +61 -0
  162. package/dist/.dts7/build/citation-verification.d.ts.map +1 -0
  163. package/dist/.dts7/build/compatibility.d.ts +83 -0
  164. package/dist/.dts7/build/compatibility.d.ts.map +1 -0
  165. package/dist/.dts7/build/compiler-api.d.ts +12 -0
  166. package/dist/.dts7/build/compiler-api.d.ts.map +1 -0
  167. package/dist/.dts7/build/contract-model.d.ts +93 -0
  168. package/dist/.dts7/build/contract-model.d.ts.map +1 -0
  169. package/dist/.dts7/build/deep-equal.d.ts +9 -0
  170. package/dist/.dts7/build/deep-equal.d.ts.map +1 -0
  171. package/dist/.dts7/build/deep-freeze.d.ts +20 -0
  172. package/dist/.dts7/build/deep-freeze.d.ts.map +1 -0
  173. package/dist/.dts7/build/dependency-graph.d.ts +163 -0
  174. package/dist/.dts7/build/dependency-graph.d.ts.map +1 -0
  175. package/dist/.dts7/build/dependency-model.d.ts +81 -0
  176. package/dist/.dts7/build/dependency-model.d.ts.map +1 -0
  177. package/dist/.dts7/build/discover.d.ts +41 -0
  178. package/dist/.dts7/build/discover.d.ts.map +1 -0
  179. package/dist/.dts7/build/display-path.d.ts +6 -0
  180. package/dist/.dts7/build/display-path.d.ts.map +1 -0
  181. package/dist/.dts7/build/docs.d.ts +172 -0
  182. package/dist/.dts7/build/docs.d.ts.map +1 -0
  183. package/dist/.dts7/build/env-example.d.ts +85 -0
  184. package/dist/.dts7/build/env-example.d.ts.map +1 -0
  185. package/dist/.dts7/build/errors.d.ts +78 -0
  186. package/dist/.dts7/build/errors.d.ts.map +1 -0
  187. package/dist/.dts7/build/evidence-cache.d.ts +74 -0
  188. package/dist/.dts7/build/evidence-cache.d.ts.map +1 -0
  189. package/dist/.dts7/build/evidence-model.d.ts +50 -0
  190. package/dist/.dts7/build/evidence-model.d.ts.map +1 -0
  191. package/dist/.dts7/build/evidence-reference.d.ts +67 -0
  192. package/dist/.dts7/build/evidence-reference.d.ts.map +1 -0
  193. package/dist/.dts7/build/evidence-snapshot.d.ts +142 -0
  194. package/dist/.dts7/build/evidence-snapshot.d.ts.map +1 -0
  195. package/dist/.dts7/build/exclusive-group.d.ts +19 -0
  196. package/dist/.dts7/build/exclusive-group.d.ts.map +1 -0
  197. package/dist/.dts7/build/finding-model.d.ts +80 -0
  198. package/dist/.dts7/build/finding-model.d.ts.map +1 -0
  199. package/dist/.dts7/build/generate-documentation.d.ts +176 -0
  200. package/dist/.dts7/build/generate-documentation.d.ts.map +1 -0
  201. package/dist/.dts7/build/generate-env-artifacts.d.ts +191 -0
  202. package/dist/.dts7/build/generate-env-artifacts.d.ts.map +1 -0
  203. package/dist/.dts7/build/generate-evidence.d.ts +77 -0
  204. package/dist/.dts7/build/generate-evidence.d.ts.map +1 -0
  205. package/dist/.dts7/build/generate-manifest.d.ts +100 -0
  206. package/dist/.dts7/build/generate-manifest.d.ts.map +1 -0
  207. package/dist/.dts7/build/generate-usage.d.ts +94 -0
  208. package/dist/.dts7/build/generate-usage.d.ts.map +1 -0
  209. package/dist/.dts7/build/generated-banner.d.ts +43 -0
  210. package/dist/.dts7/build/generated-banner.d.ts.map +1 -0
  211. package/dist/.dts7/build/glob.d.ts +6 -0
  212. package/dist/.dts7/build/glob.d.ts.map +1 -0
  213. package/dist/.dts7/build/governance-fields.d.ts +34 -0
  214. package/dist/.dts7/build/governance-fields.d.ts.map +1 -0
  215. package/dist/.dts7/build/humanize-key.d.ts +14 -0
  216. package/dist/.dts7/build/humanize-key.d.ts.map +1 -0
  217. package/dist/.dts7/build/index.d.ts +89 -0
  218. package/dist/.dts7/build/index.d.ts.map +1 -0
  219. package/dist/.dts7/build/lifecycle-model.d.ts +181 -0
  220. package/dist/.dts7/build/lifecycle-model.d.ts.map +1 -0
  221. package/dist/.dts7/build/link.d.ts +222 -0
  222. package/dist/.dts7/build/link.d.ts.map +1 -0
  223. package/dist/.dts7/build/literal-eval.d.ts +24 -0
  224. package/dist/.dts7/build/literal-eval.d.ts.map +1 -0
  225. package/dist/.dts7/build/live-expirations.d.ts +48 -0
  226. package/dist/.dts7/build/live-expirations.d.ts.map +1 -0
  227. package/dist/.dts7/build/manifest.d.ts +31 -0
  228. package/dist/.dts7/build/manifest.d.ts.map +1 -0
  229. package/dist/.dts7/build/map-utils.d.ts +8 -0
  230. package/dist/.dts7/build/map-utils.d.ts.map +1 -0
  231. package/dist/.dts7/build/merge-documentation.d.ts +36 -0
  232. package/dist/.dts7/build/merge-documentation.d.ts.map +1 -0
  233. package/dist/.dts7/build/ownership-model.d.ts +58 -0
  234. package/dist/.dts7/build/ownership-model.d.ts.map +1 -0
  235. package/dist/.dts7/build/parse.d.ts +206 -0
  236. package/dist/.dts7/build/parse.d.ts.map +1 -0
  237. package/dist/.dts7/build/reference-projections.d.ts +168 -0
  238. package/dist/.dts7/build/reference-projections.d.ts.map +1 -0
  239. package/dist/.dts7/build/resolution/resolve-import.d.ts +62 -0
  240. package/dist/.dts7/build/resolution/resolve-import.d.ts.map +1 -0
  241. package/dist/.dts7/build/resolution/resolve-package-schema.d.ts +83 -0
  242. package/dist/.dts7/build/resolution/resolve-package-schema.d.ts.map +1 -0
  243. package/dist/.dts7/build/resolution/resolve-tsconfig-paths.d.ts +18 -0
  244. package/dist/.dts7/build/resolution/resolve-tsconfig-paths.d.ts.map +1 -0
  245. package/dist/.dts7/build/resolution/resolve-within-root.d.ts +35 -0
  246. package/dist/.dts7/build/resolution/resolve-within-root.d.ts.map +1 -0
  247. package/dist/.dts7/build/sarif.d.ts +66 -0
  248. package/dist/.dts7/build/sarif.d.ts.map +1 -0
  249. package/dist/.dts7/build/scan-dependencies.d.ts +71 -0
  250. package/dist/.dts7/build/scan-dependencies.d.ts.map +1 -0
  251. package/dist/.dts7/build/sort-by-identity.d.ts +14 -0
  252. package/dist/.dts7/build/sort-by-identity.d.ts.map +1 -0
  253. package/dist/.dts7/build/source-position.d.ts +69 -0
  254. package/dist/.dts7/build/source-position.d.ts.map +1 -0
  255. package/dist/.dts7/build/tool-version.d.ts +8 -0
  256. package/dist/.dts7/build/tool-version.d.ts.map +1 -0
  257. package/dist/.dts7/build/types.d.ts +7 -0
  258. package/dist/.dts7/build/types.d.ts.map +1 -0
  259. package/dist/.dts7/build/typescript.d.ts +6 -0
  260. package/dist/.dts7/build/typescript.d.ts.map +1 -0
  261. package/dist/.dts7/build/usage-report.d.ts +124 -0
  262. package/dist/.dts7/build/usage-report.d.ts.map +1 -0
  263. package/dist/.dts7/cli/filesystem.d.ts +7 -0
  264. package/dist/.dts7/cli/filesystem.d.ts.map +1 -0
  265. package/dist/.dts7/eslint-plugin/glob.d.ts +7 -0
  266. package/dist/.dts7/eslint-plugin/glob.d.ts.map +1 -0
  267. package/dist/.dts7/eslint-plugin/index.d.ts +38 -0
  268. package/dist/.dts7/eslint-plugin/index.d.ts.map +1 -0
  269. package/dist/.dts7/eslint-plugin/no-node-fs.d.ts +15 -0
  270. package/dist/.dts7/eslint-plugin/no-node-fs.d.ts.map +1 -0
  271. package/dist/.dts7/eslint-plugin/no-raw-process-env.d.ts +23 -0
  272. package/dist/.dts7/eslint-plugin/no-raw-process-env.d.ts.map +1 -0
  273. package/dist/.dts7/evidence/define-projection.d.ts +51 -0
  274. package/dist/.dts7/evidence/define-projection.d.ts.map +1 -0
  275. package/dist/.dts7/evidence/index.d.ts +19 -0
  276. package/dist/.dts7/evidence/index.d.ts.map +1 -0
  277. package/dist/.dts7/helpers/index.d.ts +132 -0
  278. package/dist/.dts7/helpers/index.d.ts.map +1 -0
  279. package/dist/.dts7/helpers/processors.d.ts +32 -0
  280. package/dist/.dts7/helpers/processors.d.ts.map +1 -0
  281. package/dist/.dts7/helpers/validators.d.ts +68 -0
  282. package/dist/.dts7/helpers/validators.d.ts.map +1 -0
  283. package/dist/.dts7/node/index.d.ts +21 -0
  284. package/dist/.dts7/node/index.d.ts.map +1 -0
  285. package/dist/.dts7/runtime/cache.d.ts +17 -0
  286. package/dist/.dts7/runtime/cache.d.ts.map +1 -0
  287. package/dist/.dts7/runtime/create.d.ts +23 -0
  288. package/dist/.dts7/runtime/create.d.ts.map +1 -0
  289. package/dist/.dts7/runtime/document.d.ts +214 -0
  290. package/dist/.dts7/runtime/document.d.ts.map +1 -0
  291. package/dist/.dts7/runtime/errors.d.ts +55 -0
  292. package/dist/.dts7/runtime/errors.d.ts.map +1 -0
  293. package/dist/.dts7/runtime/index.d.ts +25 -0
  294. package/dist/.dts7/runtime/index.d.ts.map +1 -0
  295. package/dist/.dts7/runtime/registry.d.ts +12 -0
  296. package/dist/.dts7/runtime/registry.d.ts.map +1 -0
  297. package/dist/.dts7/runtime/reset.d.ts +8 -0
  298. package/dist/.dts7/runtime/reset.d.ts.map +1 -0
  299. package/dist/.dts7/runtime/types.d.ts +190 -0
  300. package/dist/.dts7/runtime/types.d.ts.map +1 -0
  301. package/dist/.dts7/runtime/validate.d.ts +27 -0
  302. package/dist/.dts7/runtime/validate.d.ts.map +1 -0
  303. package/dist/{build-6XFHJFQK.js → build-UEENZEUX.js} +43 -42
  304. package/dist/build-UEENZEUX.js.map +1 -0
  305. package/dist/build.cjs +42 -41
  306. package/dist/build.cjs.map +1 -1
  307. package/dist/build.js +42 -41
  308. package/dist/build.js.map +1 -1
  309. package/dist/build.ts7.d.cts +1 -0
  310. package/dist/build.ts7.d.ts +1 -0
  311. package/dist/{chunk-RL5KFVUT.js → chunk-TBL3O7IG.js} +2 -2
  312. package/dist/cli/index.js +29 -28
  313. package/dist/cli/index.js.map +1 -1
  314. package/dist/eslint-plugin/index.cjs.map +1 -1
  315. package/dist/eslint-plugin/index.js.map +1 -1
  316. package/dist/eslint-plugin/index.ts7.d.cts +1 -0
  317. package/dist/eslint-plugin/index.ts7.d.ts +1 -0
  318. package/dist/evidence.cjs +1 -1
  319. package/dist/evidence.cjs.map +1 -1
  320. package/dist/evidence.js +1 -1
  321. package/dist/evidence.js.map +1 -1
  322. package/dist/evidence.ts7.d.cts +1 -0
  323. package/dist/evidence.ts7.d.ts +1 -0
  324. package/dist/helpers.cjs +4 -4
  325. package/dist/helpers.cjs.map +1 -1
  326. package/dist/helpers.js +4 -4
  327. package/dist/helpers.js.map +1 -1
  328. package/dist/helpers.ts7.d.cts +1 -0
  329. package/dist/helpers.ts7.d.ts +1 -0
  330. package/dist/index.cjs.map +1 -1
  331. package/dist/index.js.map +1 -1
  332. package/dist/index.ts7.d.cts +1 -0
  333. package/dist/index.ts7.d.ts +1 -0
  334. package/dist/node.ts7.d.cts +1 -0
  335. package/dist/node.ts7.d.ts +1 -0
  336. package/examples/README.md +46 -80
  337. package/package.json +43 -12
  338. package/schemas/contract-model.schema.json +7 -7
  339. package/schemas/env-cap-report.schema.json +88 -88
  340. package/skills/env-cap/SKILL.md +12 -13
  341. package/skills/env-cap/references/api.md +1 -1
  342. package/specs/architecture.md +147 -122
  343. package/specs/decisions/0001-runtime-documentation-separation.md +1 -1
  344. package/specs/decisions/0014-cross-package-schema-discovery.md +4 -1
  345. package/specs/decisions/0023-tsconfig-path-alias-resolution.md +4 -1
  346. package/specs/decisions/0049-typescript-7-scanner-uses-a-bundled-typescript-6.md +13 -8
  347. package/specs/generated-artifacts.md +91 -71
  348. package/specs/migrations/README.md +6 -6
  349. package/specs/migrations/from-centralized-schema.md +1 -1
  350. package/specs/migrations/from-t3-env.md +9 -9
  351. package/PROMPT.md +0 -89
  352. package/dist/build-6XFHJFQK.js.map +0 -1
  353. /package/dist/{chunk-RL5KFVUT.js.map → chunk-TBL3O7IG.js.map} +0 -0
@@ -1,21 +1,16 @@
1
1
  /**
2
- * The filesystem capability a package's `./build` entry requires from its caller.
2
+ * The filesystem a package's `./build` entry is handed by its caller.
3
3
  *
4
- * `./build` is a **library surface**: it must not acquire filesystem access
5
- * implicitly (no `node:fs` import outside the package's CLI). Every public options object carries a required
6
- * `fs` field of this type, and the caller supplies a concrete adapter: the CLI builds one over
7
- * `node:fs/promises`; a test builds either that same adapter or an in-memory fake.
4
+ * `./build` is a library surface, so it never imports `node:fs` itself (the `no-node-fs` rule enforces that).
5
+ * Every public options object carries a required `fs` of this type. The CLI builds one over `node:fs/promises`;
6
+ * a test hands in the same adapter or an in-memory fake. Real filesystem work still happens; the capability is
7
+ * handed in rather than acquired.
8
8
  *
9
- * "Ambient-fs-free" means specifically: `./build` never reaches for
10
- * `node:fs` itself. It still performs real filesystem operations -- the
11
- * capability is always handed in.
9
+ * The signatures mirror `node:fs/promises`, so a thin adapter is a drop-in value. The entry and stat types are
10
+ * structural ({@link BuildDirent}, {@link BuildStats}) rather than Node's own, so the boundary does not leak
11
+ * Node's types. Only the operations the build code calls are declared.
12
12
  *
13
- * The shape is modeled on `node:fs/promises`'s own signatures so a thin
14
- * adapter is a drop-in value, but uses minimal structural types
15
- * ({@link BuildDirent}/{@link BuildStats}) rather than Node's `Dirent`/
16
- * `Stats` -- the capability boundary shouldn't leak Node's type surface just
17
- * because the concrete adapter happens to be Node-backed. Only the
18
- * operations the build code actually calls are here.
13
+ * This file is the canonical source; a package carries a managed copy (`src/_ipc/build-fs.ts`, see `sync`).
19
14
  */
20
15
  export interface BuildFileSystem {
21
16
  /** Read a UTF-8 text file. Rejects if the path doesn't exist or isn't readable. */
@@ -35,7 +30,7 @@ export interface BuildFileSystem {
35
30
  /** Resolve a path to its canonical, symlink-free absolute form. */
36
31
  readonly realpath: (path: string) => Promise<string>;
37
32
  }
38
- /** One directory entry from {@link BuildFileSystem.readdir} -- the subset of Node's `Dirent` the build code reads. */
33
+ /** One directory entry from {@link BuildFileSystem.readdir}: the subset of Node's `Dirent` the build code reads. */
39
34
  export interface BuildDirent {
40
35
  readonly name: string;
41
36
  /** Same contract as Node's `Dirent.isDirectory()`. */
@@ -43,11 +38,11 @@ export interface BuildDirent {
43
38
  /** Same contract as Node's `Dirent.isFile()`. */
44
39
  readonly isFile: () => boolean;
45
40
  }
46
- /** A path's stat info from {@link BuildFileSystem.stat} -- the subset of Node's `Stats` the build code reads. */
41
+ /** A path's stat info from {@link BuildFileSystem.stat}: the subset of Node's `Stats` the build code reads. */
47
42
  export interface BuildStats {
48
43
  /** Same contract as Node's `Stats.isFile()`. */
49
44
  readonly isFile: () => boolean;
50
- /** Size in bytes -- read by the package-schema resolver to enforce a size ceiling. */
45
+ /** Size in bytes: read by the package-schema resolver to enforce a size ceiling. */
51
46
  readonly size: number;
52
47
  }
53
48
  //# sourceMappingURL=build-fs.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"build-fs.d.ts","sourceRoot":"","sources":["../../../src/_ipc/build-fs.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IACtE,mGAAmG;IACnG,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACnF,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACtF,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,CAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QAAE,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAA;KAAE,KACtC,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAA;IACpC,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACpD,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CACrD;AAED,sHAAsH;AACtH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,sDAAsD;IACtD,QAAQ,CAAC,WAAW,EAAE,MAAM,OAAO,CAAA;IACnC,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAA;CAC/B;AAED,iHAAiH;AACjH,MAAM,WAAW,UAAU;IACzB,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAA;IAC9B,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB"}
1
+ {"version":3,"file":"build-fs.d.ts","sourceRoot":"","sources":["../../../src/_ipc/build-fs.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IACtE,mGAAmG;IACnG,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACnF,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACtF,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,CAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QAAE,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAA;KAAE,KACtC,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAA;IACpC,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACpD,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CACrD;AAED,oHAAoH;AACpH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,sDAAsD;IACtD,QAAQ,CAAC,WAAW,EAAE,MAAM,OAAO,CAAA;IACnC,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAA;CAC/B;AAED,+GAA+G;AAC/G,MAAM,WAAW,UAAU;IACzB,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAA;IAC9B,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB"}
@@ -1,11 +1,11 @@
1
1
  /**
2
- * Fails with a readable message when neither the installed `typescript` nor the bundled
3
- * `@typescript/typescript6` exposes the classic compiler API (`createSourceFile`) the build-time scanner is
4
- * written against. TypeScript 7 ships no programmatic API, so a package normally falls back to the bundled
5
- * TypeScript 6 (see `typescript.ts`); this only fires when that dependency was stripped from the install, where
6
- * a raw call would die with "ts.createSourceFile is not a function".
2
+ * Fails with a readable message when no loaded compiler exposes the classic API (`createSourceFile`) the
3
+ * build-time scanner is written against. TypeScript 7 ships no programmatic API, so a package falls back to the
4
+ * bundled `@typescript/typescript6` (see `typescript.ts`). This fires only when that dependency was stripped from
5
+ * the install; a raw call would otherwise die with "ts.createSourceFile is not a function".
7
6
  *
8
- * This file is the canonical source; a package carries a managed copy (see `sync`) and binds its own name.
7
+ * This file is the canonical source; a package carries a managed copy (`src/_ipc/compiler-api.ts`, see `sync`)
8
+ * and binds its own name.
9
9
  * @param product - The package's name, as users install it, for the message.
10
10
  * @param compiler - The resolved compiler module (a parameter so a test can hand in a stand-in).
11
11
  * @throws Error naming the installed version and how to restore the bundled compiler.
@@ -8,7 +8,7 @@
8
8
  * helpers that call this again. Resolving a relative path against `process.cwd()` first, which is what
9
9
  * `path.relative` does on its own, silently gives a wrong answer whenever the working directory is not `root`.
10
10
  * - An absolute path that would need to climb outside `root` is returned unchanged, never rewritten into a
11
- * `../` escape: a file discovered in another package legitimately lives outside `root`, and its absolute path
11
+ * `../` escape. A file discovered in another package legitimately lives outside `root`, and its absolute path
12
12
  * is the only unambiguous thing to say about it.
13
13
  * @param root - The directory paths are published relative to.
14
14
  * @param filePath - An absolute path, or one already relative to `root`.
@@ -1 +1 @@
1
- {"version":3,"file":"display-path.d.ts","sourceRoot":"","sources":["../../../src/_ipc/display-path.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOlE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvE"}
1
+ {"version":3,"file":"display-path.d.ts","sourceRoot":"","sources":["../../../src/_ipc/display-path.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOlE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvE"}
@@ -1,14 +1,14 @@
1
1
  /**
2
- * The marker every generated file starts with, and the two standing notices every governance-adjacent
3
- * artifact carries, written once for every MaverickCER package that generates files.
2
+ * The marker every generated file starts with, and the two standing notices a generated artifact carries,
3
+ * written once for every package that generates files.
4
4
  *
5
- * This file is the canonical source. A package that uses it holds a managed copy (see `sync`), so it
6
- * needs no dependency on this repository at runtime. It is deliberately self-contained: no imports, no
7
- * Node APIs, no environment access, so it is safe in any bundle.
5
+ * This file is the canonical source; a package carries a managed copy (`src/_ipc/generated-banner.ts`, see
6
+ * `sync`), so it needs no dependency on this repository at runtime. It has no imports, no Node APIs and no
7
+ * environment access, so it is safe in any bundle.
8
8
  *
9
- * One marker means one place decides what "generated" looks like: the code that writes the marker and the
10
- * code that reads it (to refuse to overwrite a hand-written file, or to ignore a file that only imports a
11
- * generated one) can never drift apart.
9
+ * One marker means one place decides what "generated" looks like. The code that writes it and the code that
10
+ * reads it (to refuse to overwrite a hand-written file, or to ignore a file that only imports a generated one)
11
+ * cannot drift apart.
12
12
  */
13
13
  /** What differs between packages; everything else is shared. */
14
14
  export interface GeneratedBannerOptions {
@@ -1,17 +1,18 @@
1
1
  /**
2
- * Converts one glob pattern to a `RegExp`. Handles `**` as "any number of path segments, including zero", so
3
- * `**\/node_modules/**` matches a root-level `node_modules` and `**\/x.ts` matches a root-level file, not
4
- * just nested ones; a plain `**` to `.*` substitution gets both wrong.
2
+ * Converts one glob pattern to a `RegExp`. `**` means any number of path segments, including zero, so
3
+ * `**\/node_modules/**` matches a root-level `node_modules` and `**\/x.ts` a root-level file. A plain `**` to
4
+ * `.*` substitution gets both wrong.
5
5
  *
6
- * One implementation for every package: build-time discovery and ESLint options need exactly the same matching,
7
- * and four hand-kept copies (two designs) had already accumulated. This file is the canonical source; a
8
- * package carries a managed copy (see `sync`).
6
+ * One implementation for every package: build-time discovery and ESLint options need the same matching, and
7
+ * hand-kept copies had already diverged. This file is the canonical source; a package carries a managed copy
8
+ * (`src/_ipc/glob.ts`, see `sync`).
9
9
  */
10
10
  export declare function globToRegExp(pattern: string): RegExp;
11
11
  /**
12
12
  * Whether a lint rule's `allow` list covers a file. ESLint gives a rule the file's absolute path, while a config
13
- * writes its patterns relative to the working directory (`src/cli/**`), so each pattern is tested against the path
14
- * as given and, when the file is inside `cwd`, against the path from there, written with `/` on every platform.
13
+ * writes its patterns relative to the working directory (`src/cli/**`). So each pattern is tested against the path
14
+ * as given. When the file is inside `cwd`, it is also tested against the path from there, written with `/` on
15
+ * every platform.
15
16
  * (`split`/`join`, not `replaceAll`: a package that carries this copy may compile for ES2020.)
16
17
  * @param patterns - the rule's `allow` globs.
17
18
  * @param filename - the file as ESLint names it (`context.filename`).
@@ -1 +1 @@
1
- {"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../../src/_ipc/glob.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA4BpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,GACV,OAAO,CAeT"}
1
+ {"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../../src/_ipc/glob.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA4BpD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,GACV,OAAO,CAeT"}
@@ -8,9 +8,9 @@ export interface NoNodeFsWording {
8
8
  readonly guide: string;
9
9
  }
10
10
  export interface RuleOptions {
11
- /** Glob-array of files this rule doesn't apply to -- a project's own
11
+ /** Glob-array of files this rule doesn't apply to: a project's own
12
12
  * executable entry points (a CLI, a script) that legitimately construct
13
- * the concrete filesystem adapter. Empty by default -- populate it
13
+ * the concrete filesystem adapter. Empty by default: populate it
14
14
  * explicitly; the rule never guesses at what counts as an executable
15
15
  * capability boundary. */
16
16
  allow?: string[];
@@ -1 +1 @@
1
- {"version":3,"file":"no-node-fs.d.ts","sourceRoot":"","sources":["../../../src/_ipc/no-node-fs.ts"],"names":[],"mappings":"AAQA,6GAA6G;AAC7G,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAA;IAC9C,wEAAwE;IACxE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,kHAAkH;IAClH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B;;;;+BAI2B;IAC3B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CACjB;AA6DD,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe;;EAsEtD"}
1
+ {"version":3,"file":"no-node-fs.d.ts","sourceRoot":"","sources":["../../../src/_ipc/no-node-fs.ts"],"names":[],"mappings":"AAYA,6GAA6G;AAC7G,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAA;IAC9C,wEAAwE;IACxE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,kHAAkH;IAClH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B;;;;+BAI2B;IAC3B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CACjB;AA6DD,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe;;EAsEtD"}
@@ -7,14 +7,14 @@ import type { BuildFileSystem } from "./build-fs.js";
7
7
  * `tsconfig.json` `compilerOptions.paths`/`baseUrl`, so a schema or consumer reached only
8
8
  * through an alias isn't misreported by `link.ts`/`dependency-graph.ts` as unresolved or
9
9
  * abandoned. Unlike a package-schema resolver, this never crosses a
10
- * trust/versioning boundary -- every resolved file is already local, already-trusted
11
- * project source -- so it is on by default (auto-detecting `root/tsconfig.json`) rather
10
+ * trust/versioning boundary (every resolved file is already local, already-trusted
11
+ * project source), so it is on by default (auto-detecting `root/tsconfig.json`) rather
12
12
  * than requiring an explicit allowlist.
13
13
  *
14
14
  * The actual `paths`/`baseUrl` matching algorithm (longest-prefix matching, `*` wildcard
15
15
  * substitution, multiple fallback targets, `extends`-chain merging, JSONC parsing) is
16
16
  * delegated entirely to the TypeScript compiler via `ts.resolveModuleName()` and
17
- * `ts.parseJsonConfigFileContent()` -- the same functions `tsc`/`tsserver` themselves use --
17
+ * `ts.parseJsonConfigFileContent()` (the same functions `tsc`/`tsserver` themselves use)
18
18
  * rather than reimplemented here. This module's own logic is limited to loading the config,
19
19
  * caching resolutions, and enforcing the `node_modules` safety boundary below.
20
20
  */
@@ -38,7 +38,7 @@ export interface PathMappingOptions {
38
38
  export declare function pathMappingOptions(options: TS.CompilerOptions): PathMappingOptions;
39
39
  /** Parsed `tsconfig.json` `paths`/`baseUrl` configuration, immutable for the life of one generate*() run. See {@link loadTsconfigPaths}. */
40
40
  export interface TsconfigPathsResolution {
41
- /** The subset of `compilerOptions` `ts.resolveModuleName()` needs -- at minimum `paths` and/or `baseUrl`. */
41
+ /** The subset of `compilerOptions` `ts.resolveModuleName()` needs: at minimum `paths` and/or `baseUrl`. */
42
42
  readonly compilerOptions: TS.CompilerOptions;
43
43
  /** Absolute path of the tsconfig.json this was loaded from, for diagnostics. */
44
44
  readonly configFile: string;
@@ -53,7 +53,7 @@ export interface AliasResolutionCache {
53
53
  /**
54
54
  * Keyed by `` `${importingFile}\0${specifier}` ``, not by `specifier` alone. With one
55
55
  * fixed `compilerOptions` object and no project-reference support, `paths`-pattern
56
- * substitution itself doesn't depend on the importing file -- but `ts.resolveModuleName()`'s
56
+ * substitution itself doesn't depend on the importing file, but `ts.resolveModuleName()`'s
57
57
  * fallback behavior when `paths` doesn't match a real file (classic-mode ancestor search,
58
58
  * extension-preference edge cases) legitimately can. A `Map`, not a network call, so
59
59
  * keying defensively by both costs nothing.
@@ -84,24 +84,24 @@ export declare function typescriptPath(file: string, separator: string): string;
84
84
  /**
85
85
  * Loads and parses a `tsconfig.json` for alias resolution. Called exactly once per
86
86
  * `generate*()`/`computeArtifacts()` invocation, at the same point
87
- * `resolveAllowlistedPackages()` is already called once -- so at most one tsconfig-related
87
+ * `resolveAllowlistedPackages()` is already called once, so at most one tsconfig-related
88
88
  * warning is ever produced per run, never once per file scanned.
89
89
  *
90
90
  * @param product - The consuming package's name, used in the message when no usable compiler resolved.
91
91
  * @remarks
92
92
  * `tsconfigOption === false` disables alias resolution entirely.
93
- * `tsconfigOption === undefined` (the default) looks for `root/tsconfig.json` exactly --
93
+ * `tsconfigOption === undefined` (the default) looks for `root/tsconfig.json` exactly:
94
94
  * deliberately not `ts.findConfigFile()`'s upward directory walk, since every other
95
95
  * root-relative mechanism in this codebase (schema discovery, `packages` resolution)
96
96
  * treats `root` as a hard boundary. A missing default tsconfig is silent (most projects
97
97
  * don't use aliases); a missing *explicit* `tsconfigOption` is a real misconfiguration and
98
- * warns. `jsconfig.json` is intentionally not auto-detected -- pass `tsconfig:
98
+ * warns. `jsconfig.json` is intentionally not auto-detected: pass `tsconfig:
99
99
  * "jsconfig.json"` explicitly if needed; this loader only cares about the file's JSON
100
100
  * shape, not its name.
101
101
  *
102
102
  * The gate for building a resolution is "`paths` non-empty OR `baseUrl` set", not `paths`
103
- * alone -- a `baseUrl`-only tsconfig (no `paths` at all) still makes TypeScript resolve
104
- * bare specifiers relative to `baseUrl`, and `ts.resolveModuleName()` already handles that
103
+ * alone. A `baseUrl`-only tsconfig (no `paths` at all) still makes TypeScript resolve
104
+ * bare specifiers relative to `baseUrl`. `ts.resolveModuleName()` already handles that
105
105
  * once `compilerOptions.baseUrl` is passed through.
106
106
  */
107
107
  export declare function loadTsconfigPaths(product: string, root: string, tsconfigOption: string | false | undefined, fs: BuildFileSystem): Promise<LoadTsconfigPathsResult>;
@@ -110,7 +110,7 @@ export declare function loadTsconfigPaths(product: string, root: string, tsconfi
110
110
  * or returns `undefined` if it doesn't resolve through this mechanism.
111
111
  *
112
112
  * @remarks
113
- * Necessarily synchronous -- `ts.resolveModuleName()` has no async form, matching how
113
+ * Necessarily synchronous: `ts.resolveModuleName()` has no async form, matching how
114
114
  * `tsc`/`tsserver` themselves always call it. `ts.sys` is used directly as the resolution
115
115
  * host (an existing Node-backed singleton the `typescript` package exports; nothing to
116
116
  * construct).
@@ -118,16 +118,16 @@ export declare function loadTsconfigPaths(product: string, root: string, tsconfi
118
118
  * Two safety/scope filters apply to any candidate `ts.resolveModuleName()` returns,
119
119
  * independent of its own internal fallback behavior:
120
120
  * - **Never resolves into `node_modules`.** `ts.resolveModuleName()` can, in principle,
121
- * fall through to classic Node resolution and land inside `node_modules`; any resolved
121
+ * fall through to classic Node resolution and land inside `node_modules`. Any resolved
122
122
  * path containing a `node_modules` path segment (checked after `path.normalize()`, so
123
123
  * mixed separators can't slip past it on Windows) is discarded here. Bare package
124
- * specifiers continue to be handled exclusively by `resolvePackageImport()`
125
- * -- this mechanism never overlaps with that trust boundary.
124
+ * specifiers continue to be handled exclusively by `resolvePackageImport()`:
125
+ * this mechanism never overlaps with that trust boundary.
126
126
  * - **`.ts`/`.tsx` only.** Matches `resolveRelativeImport()`'s own existing candidate set
127
- * and `resolve-package-schema.ts`'s `SCHEMA_FILE_EXTENSIONS` -- this codebase's static-
127
+ * and `resolve-package-schema.ts`'s `SCHEMA_FILE_EXTENSIONS`: this codebase's static-
128
128
  * analysis pipeline is `.ts`/`.tsx` only today. A resolved non-`.ts`/`.tsx` file is a
129
129
  * real risk, not just a gap: feeding it straight into `ts.createSourceFile()` wouldn't
130
- * error, it would silently parse garbage -- exactly the "guess" this codebase's
130
+ * error, it would silently parse garbage: exactly the "guess" this codebase's
131
131
  * warn-don't-guess philosophy exists to avoid.
132
132
  */
133
133
  export declare function resolveAliasImport(specifier: string, importingFile: string, resolution: TsconfigPathsResolution, cache: AliasResolutionCache): string | undefined;
@@ -1 +1 @@
1
- {"version":3,"file":"resolve-tsconfig-paths.d.ts","sourceRoot":"","sources":["../../../src/_ipc/resolve-tsconfig-paths.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAA;AAEhC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,EAAE,CAAC,eAAe,GAAG,kBAAkB,CAElF;AAED,4IAA4I;AAC5I,MAAM,WAAW,uBAAuB;IACtC,6GAA6G;IAC7G,QAAQ,CAAC,eAAe,EAAE,EAAE,CAAC,eAAe,CAAA;IAC5C,gFAAgF;IAChF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;CACtD;AAED,sGAAsG;AACtG,wBAAgB,0BAA0B,IAAI,oBAAoB,CAEjE;AAYD,iIAAiI;AACjI,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,uBAAuB,GAAG,SAAS,CAAA;IACxD,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,CAAA;CAC9C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,EAC1C,EAAE,EAAE,eAAe,GAClB,OAAO,CAAC,uBAAuB,CAAC,CAuElC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,uBAAuB,EACnC,KAAK,EAAE,oBAAoB,GAC1B,MAAM,GAAG,SAAS,CAiBpB"}
1
+ {"version":3,"file":"resolve-tsconfig-paths.d.ts","sourceRoot":"","sources":["../../../src/_ipc/resolve-tsconfig-paths.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAA;AAEhC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,EAAE,CAAC,eAAe,GAAG,kBAAkB,CAElF;AAED,4IAA4I;AAC5I,MAAM,WAAW,uBAAuB;IACtC,2GAA2G;IAC3G,QAAQ,CAAC,eAAe,EAAE,EAAE,CAAC,eAAe,CAAA;IAC5C,gFAAgF;IAChF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;CACtD;AAED,sGAAsG;AACtG,wBAAgB,0BAA0B,IAAI,oBAAoB,CAEjE;AAYD,iIAAiI;AACjI,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,uBAAuB,GAAG,SAAS,CAAA;IACxD,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,CAAA;CAC9C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,EAC1C,EAAE,EAAE,eAAe,GAClB,OAAO,CAAC,uBAAuB,CAAC,CAuElC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,uBAAuB,EACnC,KAAK,EAAE,oBAAoB,GAC1B,MAAM,GAAG,SAAS,CAiBpB"}
@@ -3,13 +3,13 @@ import type TS from "typescript";
3
3
  export type TypeScript = typeof TS;
4
4
  /**
5
5
  * Picks the compiler the scanner parses with: the consumer's `typescript` when it exposes the
6
- * classic compiler API (TypeScript 5 and 6), otherwise the bundled `@typescript/typescript6` --
7
- * Microsoft's side-by-side TypeScript 6 package, a dependency of the package so the scanner keeps working
8
- * for a consumer whose own `typescript` is 7+, which ships no programmatic API. Chosen by capability, never by version,
6
+ * classic compiler API (TypeScript 5 and 6), otherwise the bundled `@typescript/typescript6`. That is
7
+ * Microsoft's side-by-side TypeScript 6 package, a dependency of the package, so the scanner keeps working
8
+ * for a consumer whose own `typescript` is 7+ (which ships no programmatic API). Chosen by capability, never by version,
9
9
  * so a future `typescript` that regains the API is used as-is.
10
10
  *
11
11
  * When neither has the API (the bundled dependency was stripped from an install), it returns the
12
- * consumer's module anyway so `assertCompilerApi` -- called at every scanner entry point -- fails
12
+ * consumer's module anyway so `assertCompilerApi` (called at every scanner entry point) fails
13
13
  * with its readable message instead of a bare "is not a function".
14
14
  * @param load - How a module id is resolved (a parameter so a test can hand in stand-ins).
15
15
  * @throws Whatever `load` throws for a reason other than the module not being installed.
@@ -5,7 +5,7 @@ import type { ImportResolutionContext } from "./resolution/resolve-import.js";
5
5
  import type { PackageOrigin } from "./resolution/resolve-package-schema.js";
6
6
  /** Options for {@link assembleProject}. */
7
7
  export interface AssembleProjectOptions {
8
- /** The filesystem capability -- `./build` never imports `node:fs` (ADR 0040). */
8
+ /** The filesystem capability: `./build` never imports `node:fs` (ADR 0040). */
9
9
  readonly fs: BuildFileSystem;
10
10
  readonly root: string;
11
11
  readonly include: readonly string[];
@@ -15,33 +15,32 @@ export interface AssembleProjectOptions {
15
15
  }
16
16
  /**
17
17
  * Everything downstream model-building and artifact-rendering needs from one
18
- * discovery+link pass: the linked contract graph, the import-resolution
19
- * context every later resolution call (`computeScanSurface()`,
20
- * `buildDependencyModel()`, ...) must reuse to agree with `linkResult`, and a
21
- * shared file-read cache so a file matched by more than one later pass'
22
- * glob (e.g. a schema file also matched by the usage pass' broader
23
- * `SCAN_INCLUDE`) is only ever read from disk once.
18
+ * discovery+link pass. It holds the linked contract graph and the
19
+ * import-resolution context. Every later resolution call
20
+ * (`computeScanSurface()`, `buildDependencyModel()`, ...) must reuse that
21
+ * context to agree with `linkResult`. It also holds a shared file-read cache,
22
+ * so a file matched by more than one later pass' glob is read from disk once
23
+ * (e.g. a schema file also matched by the usage pass' broader `SCAN_INCLUDE`).
24
24
  */
25
25
  export interface AssembledProject {
26
26
  readonly root: string;
27
27
  readonly readFileCached: (filePath: string) => Promise<string>;
28
28
  readonly linkResult: LinkResult;
29
29
  readonly context: ImportResolutionContext;
30
- /** Keyed by resolved file path -- see `resolveAllowlistedPackages()`. */
30
+ /** Keyed by resolved file path: see `resolveAllowlistedPackages()`. */
31
31
  readonly origins: ReadonlyMap<string, PackageOrigin>;
32
32
  readonly packageWarnings: readonly ParseWarning[];
33
33
  readonly tsconfigWarnings: readonly ParseWarning[];
34
34
  }
35
35
  /**
36
- * The one shared discovery+link pass every orchestrator needs -- local +
36
+ * The one shared discovery+link pass every orchestrator needs: local +
37
37
  * allow-listed-package schema discovery, tsconfig path-alias resolution, and
38
- * cross-file linking, exactly once. Extracted from what `computeArtifacts()`
38
+ * cross-file linking, exactly once. `computeArtifacts()`
39
39
  * (`generate-env-artifacts.ts`) and `generateEvidenceModel()`
40
- * (`generate-evidence.ts`) each used to run independently, so the two
41
- * orchestrators can never silently drift into scanning the same source tree
42
- * twice -- the same "shared discovery, computed once" principle ADR 0011
43
- * already established for manifest/docs/usage, now shared with evidence
44
- * assembly too.
40
+ * (`generate-evidence.ts`) both call it, so the two orchestrators can never
41
+ * drift into scanning the same source tree twice. This is ADR 0011's "shared
42
+ * discovery, computed once" principle for manifest/docs/usage, extended to
43
+ * evidence assembly.
45
44
  */
46
45
  export declare function assembleProject(options: AssembleProjectOptions): Promise<AssembledProject>;
47
46
  //# sourceMappingURL=assemble-project.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"assemble-project.d.ts","sourceRoot":"","sources":["../../../src/build/assemble-project.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAA;AAK7E,OAAO,KAAK,EACV,aAAa,EAEd,MAAM,wCAAwC,CAAA;AAM/C,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACrC,iFAAiF;IACjF,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAA;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAA;CAC9C;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9D,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAA;IACzC,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACpD,QAAQ,CAAC,eAAe,EAAE,SAAS,YAAY,EAAE,CAAA;IACjD,QAAQ,CAAC,gBAAgB,EAAE,SAAS,YAAY,EAAE,CAAA;CACnD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2ChG"}
1
+ {"version":3,"file":"assemble-project.d.ts","sourceRoot":"","sources":["../../../src/build/assemble-project.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAA;AAK7E,OAAO,KAAK,EACV,aAAa,EAEd,MAAM,wCAAwC,CAAA;AAM/C,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACrC,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAA;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAA;CAC9C;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9D,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAA;IACzC,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACpD,QAAQ,CAAC,eAAe,EAAE,SAAS,YAAY,EAAE,CAAA;IACjD,QAAQ,CAAC,gBAAgB,EAAE,SAAS,YAAY,EAAE,CAAA;CACnD;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2ChG"}
@@ -1,40 +1,40 @@
1
1
  import type { DiscoveredContract } from "./link.js";
2
2
  import type { ManifestChangeReport } from "./evidence-snapshot.js";
3
3
  /**
4
- * The sixth of env-cap's seven canonical fact models (ADR 0024) -- what
5
- * changed since the last persisted evidence snapshot (ADR 0038; previously
6
- * a manifest-scoped snapshot, ADR 0021). See ADR 0030 (base shape) and ADR
4
+ * The sixth of env-cap's seven canonical fact models (ADR 0024): what
5
+ * changed since the last persisted evidence snapshot (ADR 0038, which
6
+ * replaces the manifest-scoped snapshot of ADR 0021). See ADR 0030 (base shape) and ADR
7
7
  * 0029 (the `renamedFrom` field this file's rename correlation is gated
8
8
  * on).
9
9
  *
10
10
  * @remarks
11
11
  * Wraps `ManifestChangeReport` (`evidence-snapshot.ts`) rather than
12
- * replacing it -- this model exists to give the change report a versioned,
12
+ * replacing it: this model exists to give the change report a versioned,
13
13
  * model-namespaced shape Evidence Model can assemble against, alongside the
14
14
  * other six models. Empty (no adds/removes/updates) whenever no previous
15
- * evidence snapshot location was configured for this run -- there is
15
+ * evidence snapshot location was configured for this run: there is
16
16
  * nothing to diff against, which is a genuinely different state from a
17
17
  * first-ever run *with* tracking configured (where everything reads as
18
18
  * added).
19
19
  */
20
- /** Bump only when a reader could misinterpret the new shape -- same discipline every other canonical model's `schemaVersion` follows. */
20
+ /** Bump only when a reader could misinterpret the new shape: same discipline every other canonical model's `schemaVersion` follows. */
21
21
  export declare const CHANGE_MODEL_SCHEMA_VERSION = 1;
22
22
  /** One `addedVariables`/`removedVariables` pair in `manifest`, correlated into a single rename via the current declaration's `renamedFrom` field (ADR 0029). */
23
23
  export interface RenamedVariable {
24
- /** The owning contract's identity (`${file}#${exportName}`) -- a rename never crosses contracts. */
24
+ /** The owning contract's identity (`${file}#${exportName}`): a rename never crosses contracts. */
25
25
  readonly contractIdentity: string;
26
26
  readonly file: string;
27
27
  readonly exportName: string;
28
28
  readonly contractName: string;
29
- /** The variable's key before the rename -- matches a `manifest.removedVariables` entry. */
29
+ /** The variable's key before the rename: matches a `manifest.removedVariables` entry. */
30
30
  readonly previousKey: string;
31
- /** The variable's key after the rename -- matches a `manifest.addedVariables` entry. */
31
+ /** The variable's key after the rename: matches a `manifest.addedVariables` entry. */
32
32
  readonly currentKey: string;
33
33
  }
34
- /** The versioned, JSON-serializable root of the Change Model -- what changed since the last persisted evidence snapshot. See this module's own doc comment for the full picture. */
34
+ /** The versioned, JSON-serializable root of the Change Model: what changed since the last persisted evidence snapshot. See this module's own doc comment for the full picture. */
35
35
  export interface ChangeModel {
36
36
  readonly schemaVersion: typeof CHANGE_MODEL_SCHEMA_VERSION;
37
- /** The existing manifest change report, unmodified -- see ADR 0021. `addedVariables`/`removedVariables` still list a correlated rename's two halves separately; `renamedVariables` below is an additive, separately-computed view, not a filter over this field. */
37
+ /** The existing manifest change report, unmodified: see ADR 0021. `addedVariables`/`removedVariables` still list a correlated rename's two halves separately; `renamedVariables` below is an additive, separately-computed view, not a filter over this field. */
38
38
  readonly manifest: ManifestChangeReport;
39
39
  /**
40
40
  * Every `addedVariables`/`removedVariables` pair this run's currently
@@ -42,10 +42,10 @@ export interface ChangeModel {
42
42
  * contract identity then current key.
43
43
  *
44
44
  * @remarks
45
- * Only ever populated from an *authored* `renamedFrom` -- never guessed
45
+ * Only ever populated from an *authored* `renamedFrom`: never guessed
46
46
  * from name similarity (ADR 0010's "provable, not heuristic" ethos).
47
47
  * Variable-level only: Lifecycle Model deliberately has no contract-level
48
- * `renamedFrom` (ADR 0029), so there is no `renamedContracts` -- a
48
+ * `renamedFrom` (ADR 0029), so there is no `renamedContracts`; a
49
49
  * contract-level rename has no field to correlate from.
50
50
  */
51
51
  readonly renamedVariables: readonly RenamedVariable[];
@@ -56,7 +56,7 @@ export interface ChangeModel {
56
56
  * shape, and correlates renames using the current run's `renamedFrom`
57
57
  * declarations. `currentContracts` should be the same contracts the
58
58
  * manifest was generated from (active contracts only, matching
59
- * `renderManifest()`'s own scope -- same as every other input to this
59
+ * `renderManifest()`'s own scope: same as every other input to this
60
60
  * report family).
61
61
  */
62
62
  export declare function buildChangeModel(manifest: ManifestChangeReport, currentContracts: readonly DiscoveredContract[], root: string): ChangeModel;
@@ -1 +1 @@
1
- {"version":3,"file":"change-model.d.ts","sourceRoot":"","sources":["../../../src/build/change-model.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AACnD,OAAO,KAAK,EAAE,oBAAoB,EAAuB,MAAM,wBAAwB,CAAA;AAEvF;;;;;;;;;;;;;;;;GAgBG;AAEH,yIAAyI;AACzI,eAAO,MAAM,2BAA2B,IAAI,CAAA;AAE5C,gKAAgK;AAChK,MAAM,WAAW,eAAe;IAC9B,oGAAoG;IACpG,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,2FAA2F;IAC3F,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,wFAAwF;IACxF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED,oLAAoL;AACpL,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,aAAa,EAAE,OAAO,2BAA2B,CAAA;IAC1D,oQAAoQ;IACpQ,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAA;IACvC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,gBAAgB,EAAE,SAAS,eAAe,EAAE,CAAA;CACtD;AAqBD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,oBAAoB,EAC9B,gBAAgB,EAAE,SAAS,kBAAkB,EAAE,EAC/C,IAAI,EAAE,MAAM,GACX,WAAW,CAqCb"}
1
+ {"version":3,"file":"change-model.d.ts","sourceRoot":"","sources":["../../../src/build/change-model.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AACnD,OAAO,KAAK,EAAE,oBAAoB,EAAuB,MAAM,wBAAwB,CAAA;AAEvF;;;;;;;;;;;;;;;;GAgBG;AAEH,uIAAuI;AACvI,eAAO,MAAM,2BAA2B,IAAI,CAAA;AAE5C,gKAAgK;AAChK,MAAM,WAAW,eAAe;IAC9B,kGAAkG;IAClG,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,yFAAyF;IACzF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,sFAAsF;IACtF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED,kLAAkL;AAClL,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,aAAa,EAAE,OAAO,2BAA2B,CAAA;IAC1D,kQAAkQ;IAClQ,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAA;IACvC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,gBAAgB,EAAE,SAAS,eAAe,EAAE,CAAA;CACtD;AAqBD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,oBAAoB,EAC9B,gBAAgB,EAAE,SAAS,kBAAkB,EAAE,EAC/C,IAAI,EAAE,MAAM,GACX,WAAW,CAqCb"}
@@ -24,14 +24,14 @@ export interface CheckEnvArtifactsResult {
24
24
  }
25
25
  /**
26
26
  * Parses `text` as an `EvidenceModel` and re-serializes it with
27
- * `provenance.generatedAt` normalized out (see `normalizeEvidenceSnapshotForComparison()`)
28
- * -- so `--check` never reports drift solely because a fresh render's
27
+ * `provenance.generatedAt` normalized out (see `normalizeEvidenceSnapshotForComparison()`):
28
+ * so `--check` never reports drift solely because a fresh render's
29
29
  * timestamp differs from the committed file's. A parse failure returns
30
30
  * `text` unchanged, so a corrupted on-disk file simply fails to match
31
31
  * `expected`'s normalized form (reported as `"stale"`), rather than
32
32
  * crashing `--check` itself.
33
33
  */
34
- /** @internal Exported for direct unit coverage -- reached through `checkEnvArtifacts()`'s `--evidence` pass in production, but the exact "returns text unchanged, not undefined/thrown" catch behavior isn't independently observable through that public path (any malformed `actual` already reads as "stale" against a well-formed `expected`, regardless of the catch's exact return value). */
34
+ /** @internal Exported for direct unit coverage: reached through `checkEnvArtifacts()`'s `--evidence` pass in production, but the exact "returns text unchanged, not undefined/thrown" catch behavior isn't independently observable through that public path (any malformed `actual` already reads as "stale" against a well-formed `expected`, regardless of the catch's exact return value). */
35
35
  export declare function normalizeEvidenceJsonForComparison(text: string): string;
36
36
  /**
37
37
  * Verifies every requested artifact (`manifest`/`docs`/`envExample`/`usage`)
@@ -39,7 +39,7 @@ export declare function normalizeEvidenceJsonForComparison(text: string): string
39
39
  * writing anything.
40
40
  *
41
41
  * @remarks
42
- * `--check` reports drift, it doesn't paper over a run that would otherwise fail --
42
+ * `--check` reports drift, it doesn't paper over a run that would otherwise fail:
43
43
  * see `@throws` below.
44
44
  *
45
45
  * @throws {EnvProjectGenerationError} On the same blocking findings a real run would throw on.
@@ -1 +1 @@
1
- {"version":3,"file":"check-artifacts.d.ts","sourceRoot":"","sources":["../../../src/build/check-artifacts.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAA;AAU9E;;;;GAIG;AAEH,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB;IACnC,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,YAAY,GAAG,OAAO,GAAG,UAAU,CAAA;IAC5E,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,wHAAwH;IACxH,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAAA;IAC3C,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,+DAA+D;AAC/D,MAAM,WAAW,uBAAuB;IACtC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAA;IACpB,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAA;CACnD;AAOD;;;;;;;;GAQG;AACH,oYAAoY;AACpY,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOvE;AAqBD;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,uBAAuB,CAAC,CAwFlC"}
1
+ {"version":3,"file":"check-artifacts.d.ts","sourceRoot":"","sources":["../../../src/build/check-artifacts.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAA;AAU9E;;;;GAIG;AAEH,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB;IACnC,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,YAAY,GAAG,OAAO,GAAG,UAAU,CAAA;IAC5E,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,wHAAwH;IACxH,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAAA;IAC3C,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,+DAA+D;AAC/D,MAAM,WAAW,uBAAuB;IACtC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAA;IACpB,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAA;CACnD;AAOD;;;;;;;;GAQG;AACH,kYAAkY;AAClY,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOvE;AAqBD;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,uBAAuB,CAAC,CAwFlC"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * Re-verifies developer-declared `dynamicAccess` citations every run -- never
2
+ * Re-verifies developer-declared `dynamicAccess` citations every run: never
3
3
  * trusted forever (ADR 0037). Two independent steps, kept as two separate
4
4
  * functions rather than one, since they answer two different questions and
5
5
  * the second is a pure read over the first's result:
@@ -10,16 +10,16 @@
10
10
  * label the citation `"fresh"` / `"stale"` / `"missing"`. Existence is
11
11
  * always re-checked live, never trusted from either snapshot. A citation
12
12
  * with no previous baseline (the first time it's ever been seen) is
13
- * `"fresh"` -- there is nothing to contradict it yet. Never throws on a
13
+ * `"fresh"`: there is nothing to contradict it yet. Never throws on a
14
14
  * missing file; that citation is simply labeled `"missing"`.
15
15
  * - `verifyDynamicAccessCitations` (pure): flattens that result down to just
16
- * the citations that need a human's attention -- every `"stale"`/`"missing"`
16
+ * the citations that need a human's attention; every `"stale"`/`"missing"`
17
17
  * assertion, enriched with the owning contract's display name. These are the
18
18
  * direct input to `finding-model.ts`'s `STALE_DYNAMIC_ACCESS_CITATION` /
19
19
  * `MISSING_DYNAMIC_ACCESS_CITATION` findings.
20
20
  *
21
21
  * Deliberately separate from `evidence-snapshot.ts`'s own `diffContracts()`,
22
- * which stays synchronous and pure -- these are the only filesystem-touching,
22
+ * which stays synchronous and pure: these are the only filesystem-touching,
23
23
  * citation-specific part of the evidence-snapshot lifecycle. A citation is
24
24
  * always a developer's *re-acknowledgment* that access happens, never a claim
25
25
  * env-cap itself observed anything: nothing here ever folds into the
@@ -28,19 +28,18 @@
28
28
  import type { EvidenceModel } from "./evidence-model.js";
29
29
  import type { DiscoveredContract } from "./link.js";
30
30
  import type { DynamicAccessAssertion, SourcePosition } from "./source-position.js";
31
- /** Stable key {@link buildCitationSnapshots} and `dependency-graph.ts`'s consumer of it agree on -- `file` must be root-relative, POSIX-separated on both sides for a lookup to ever hit. */
31
+ /** Stable key {@link buildCitationSnapshots} and `dependency-graph.ts`'s consumer of it agree on: `file` must be root-relative, POSIX-separated on both sides for a lookup to ever hit. */
32
32
  export declare function dynamicAccessVariableIdentity(file: string, exportName: string, key: string): string;
33
33
  /**
34
34
  * Re-checks every current `dynamicAccess` citation against the previous
35
35
  * evidence snapshot's committed `contentHash` baseline. Existence is always
36
- * re-checked live (never trusted from either snapshot); content drift is
37
- * only detectable when a previous baseline exists at all -- a citation with
38
- * no previous baseline (first time it's ever been seen) is reported
39
- * `"fresh"`, matching the same "nothing to contradict yet" logic. See ADR
40
- * 0037.
36
+ * re-checked live (never trusted from either snapshot). Content drift is
37
+ * only detectable when a previous baseline exists. A citation with no
38
+ * previous baseline (the first time it's seen) is reported `"fresh"`,
39
+ * because nothing contradicts it yet. See ADR 0037.
41
40
  */
42
41
  export declare function buildCitationSnapshots(activeContracts: readonly DiscoveredContract[], previous: EvidenceModel | undefined, root: string, readFile: (filePath: string) => Promise<string>): Promise<ReadonlyMap<string, readonly DynamicAccessAssertion[]>>;
43
- /** One `dynamicAccess` citation env-cap can no longer vouch for -- the direct input to `finding-model.ts`'s `"STALE_DYNAMIC_ACCESS_CITATION"`/`"MISSING_DYNAMIC_ACCESS_CITATION"` findings. See ADR 0037. */
42
+ /** One `dynamicAccess` citation env-cap can no longer vouch for: the direct input to `finding-model.ts`'s `"STALE_DYNAMIC_ACCESS_CITATION"`/`"MISSING_DYNAMIC_ACCESS_CITATION"` findings. See ADR 0037. */
44
43
  export interface DynamicAccessCitationProblem {
45
44
  readonly contractName: string;
46
45
  /** Root-relative, POSIX-separated. */
@@ -48,15 +47,15 @@ export interface DynamicAccessCitationProblem {
48
47
  readonly exportName: string;
49
48
  /** The variable whose `dynamicAccess` citation this is. */
50
49
  readonly key: string;
51
- /** Where the citation points -- not the variable's own declaration. */
50
+ /** Where the citation points: not the variable's own declaration. */
52
51
  readonly position: SourcePosition;
53
52
  readonly acknowledgment: "stale" | "missing";
54
53
  }
55
54
  /**
56
55
  * Flattens {@link buildCitationSnapshots}' result down to just the citations
57
- * that need attention -- every `"stale"`/`"missing"` assertion, enriched with
56
+ * that need attention: every `"stale"`/`"missing"` assertion, enriched with
58
57
  * the owning contract's display name. `"fresh"` assertions are silently
59
- * omitted -- nothing to report about a citation that's still trustworthy.
58
+ * omitted: nothing to report about a citation that's still trustworthy.
60
59
  */
61
60
  export declare function verifyDynamicAccessCitations(activeContracts: readonly DiscoveredContract[], root: string, acknowledgments: ReadonlyMap<string, readonly DynamicAccessAssertion[]>): readonly DynamicAccessCitationProblem[];
62
61
  //# sourceMappingURL=citation-verification.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"citation-verification.d.ts","sourceRoot":"","sources":["../../../src/build/citation-verification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAEnD,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAOlF,6LAA6L;AAC7L,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,GACV,MAAM,CAER;AAyBD;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,eAAe,EAAE,SAAS,kBAAkB,EAAE,EAC9C,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAC9C,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC,CAAC,CAmCjE;AAED,6MAA6M;AAC7M,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAA;IACjC,QAAQ,CAAC,cAAc,EAAE,OAAO,GAAG,SAAS,CAAA;CAC7C;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,eAAe,EAAE,SAAS,kBAAkB,EAAE,EAC9C,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC,GACtE,SAAS,4BAA4B,EAAE,CA6BzC"}
1
+ {"version":3,"file":"citation-verification.d.ts","sourceRoot":"","sources":["../../../src/build/citation-verification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAEnD,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAOlF,2LAA2L;AAC3L,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,GACV,MAAM,CAER;AAyBD;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,eAAe,EAAE,SAAS,kBAAkB,EAAE,EAC9C,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAC9C,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC,CAAC,CAmCjE;AAED,2MAA2M;AAC3M,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAA;IACjC,QAAQ,CAAC,cAAc,EAAE,OAAO,GAAG,SAAS,CAAA;CAC7C;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,eAAe,EAAE,SAAS,kBAAkB,EAAE,EAC9C,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC,GACtE,SAAS,4BAA4B,EAAE,CA4BzC"}