@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
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/runtime/cache.ts","../src/runtime/errors.ts","../src/runtime/registry.ts","../src/runtime/create.ts","../src/runtime/document.ts","../src/runtime/reset.ts","../src/runtime/validate.ts"],"names":["state"],"mappings":"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","file":"index.js"}
1
+ {"version":3,"sources":["../src/runtime/cache.ts","../src/runtime/errors.ts","../src/runtime/registry.ts","../src/runtime/create.ts","../src/runtime/document.ts","../src/runtime/reset.ts","../src/runtime/validate.ts"],"names":["state"],"mappings":"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","file":"index.js"}
@@ -0,0 +1 @@
1
+ export * from "./.dts7/runtime/index.js";
@@ -0,0 +1 @@
1
+ export * from "./.dts7/runtime/index.js";
@@ -0,0 +1 @@
1
+ export * from "./.dts7/node/index.js";
@@ -0,0 +1 @@
1
+ export * from "./.dts7/node/index.js";
@@ -1,95 +1,61 @@
1
1
  # Examples
2
2
 
3
- Three flagship examples, each answering a different question — read them in order, since each
4
- assumes the concepts the previous one already covered:
5
-
6
- 1. **[application](https://github.com/MaverickCER/env-cap/tree/main/examples/application)** — *"How does this make my code better?"* The simplest
7
- possible starting point: one centralized `createEnv()` contract for a whole small app, still
8
- getting fail-fast startup validation, generated docs, a generated `.env.example`, and an
9
- ownership report. For an individual developer adopting `env-cap` in their own project.
10
-
11
- 2. **[team-service](https://github.com/MaverickCER/env-cap/tree/main/examples/team-service)** — *"How does this help my team?"* Multiple
12
- capability-owned contracts spanning two real teams (`data-platform-team`, `security-team`),
13
- including two mutually-exclusive database alternatives (`postgres`/`mongodb`) gated by
14
- `exclusiveGroup`, a `classification: "secret"` variable that gives the generated security
15
- review something real to enumerate, and a `check` script demonstrating the `--check`
16
- CI-gate pattern (see [ADR 0016](../specs/decisions/0016-check-mode-compute-before-compare-never-partial-write.md))
17
- a real PR check would run.
18
-
19
- 3. **[enterprise-platform](https://github.com/MaverickCER/env-cap/tree/main/examples/enterprise-platform)** — *"How does this help my organization?"* A
20
- real, running application — reports, manifests, evidence generation, and a configuration-governance
21
- evidence document built with `defineEvidenceProjection()` — showing what `env-cap` deliberately
22
- doesn't own (a database, auth, external services) alongside what it does.
23
-
24
- Every flagship's own README documents exactly how to run it. All three are validated in CI (see
25
- `.github/workflows/ci.yml`'s `examples` job and
26
- [`test/examples/`](https://github.com/MaverickCER/env-cap/tree/main/test/examples)) against the real,
27
- currently-built `env-cap` package, so they stay in sync with the API rather than
28
- drifting silently.
29
-
30
- ## Framework integration
31
-
32
- [**nextjs-app**](https://github.com/MaverickCER/env-cap/tree/main/examples/nextjs-app) — a deliberately minimal Next.js todo app, not a fourth flagship in
33
- the above progression. Where the three flagships above grow one plain Node/TypeScript app from an
34
- individual developer's project to an organization's, this one proves the fail-fast contract
35
- mechanism inside a real framework's build/request lifecycle — a real `NEXT_PUBLIC_*` (client) vs.
36
- server-only environment variable boundary, and what it actually took to make `validateEnv()`'s
37
- module-level "ready" state survive a bundler that code-splits the app into multiple chunks. See its
38
- own README for what that took.
3
+ Each example is a runnable project that answers one question. Read the first three in order; each assumes the one before it.
4
+
5
+ | Example | Question it answers | Who it is for |
6
+ | ---------------------------------------------------------------------------------------------------- | ----------------------------------- | --------------------------------------- |
7
+ | [application](https://github.com/MaverickCER/env-cap/tree/main/examples/application) | How does this make my code better? | A developer with one central `env.ts` |
8
+ | [team-service](https://github.com/MaverickCER/env-cap/tree/main/examples/team-service) | How does this help my team? | A team with several features and owners |
9
+ | [enterprise-platform](https://github.com/MaverickCER/env-cap/tree/main/examples/enterprise-platform) | How does this help my organization? | Platform engineers and reviewers |
10
+ | [nextjs-app](https://github.com/MaverickCER/env-cap/tree/main/examples/nextjs-app) | Does it work inside a framework? | Next.js developers |
11
+
12
+ ## Before you run one
13
+
14
+ Each example installs the package from this repository (`file:../..`), so build it first:
15
+
16
+ ```bash
17
+ npm ci && npm run build # in the repository root
18
+ cd examples/<name> && npm ci
19
+ ```
20
+
21
+ Each example's README names the command, the expected exit code, and the line of output to look for. Each example commits a `.env` with placeholder values, so it runs as checked out.
22
+
23
+ ## What CI checks
24
+
25
+ CI's `examples` job runs every example against the freshly built package:
26
+
27
+ | Example | What the job runs | Test |
28
+ | --------------------- | -------------------------------------------------------------------------- | ------------------------------------------- |
29
+ | `application` | `npm run typecheck`, `npm start`, `npm run check` | `test/examples/application.test.ts` |
30
+ | `team-service` | `npm run typecheck`, `npm start`, `npm run check`, a drift test | `test/examples/team-service.test.ts` |
31
+ | `enterprise-platform` | `npm run typecheck`, `npm run test:evidence`, `npm start`, `npm run check` | `test/examples/enterprise-platform.test.ts` |
32
+ | `nextjs-app` | `npm run build` | The job step itself |
33
+
34
+ The job also re-runs the root README's demo against `application` (`npm run verify:readme-example`). It runs on every pull request, and `required` waits for it, so a red `examples` job blocks a merge.
39
35
 
40
36
  ## Looking for something specific?
41
37
 
42
- The three flagships above are for humans exploring `env-cap` for the first time — they're not
43
- meant to be an exhaustive catalog of every scenario the library handles. Every other behavior
44
- (the packaged CLI binary, cross-package schema discovery, tsconfig path-alias resolution, the
45
- `liveExpirationDates` callback, per-variable validation contexts, and more) is still fully tested,
46
- just relocated to [`test/integration/`](https://github.com/MaverickCER/env-cap/tree/main/test/integration) as a behavioral fixture rather than
47
- presented as a fourteenth (or fifteenth) example to read through. Each fixture directory still
48
- has its own runnable `package.json`, the same as a flagship does — see its own `package.json`
49
- `description` field for what it proves, or the corresponding test file under
50
- `test/integration/positive/` / `test/integration/negative/`. Examples are for humans; integration
51
- fixtures are for correctness — zero coverage was dropped in that split, only what's presented as
52
- "start here" reading.
38
+ The examples are for people exploring env-cap. Most other behaviours have a fixture under [`test/integration/`](https://github.com/MaverickCER/env-cap/tree/main/test/integration): the packaged CLI, cross-package discovery, path aliases, `liveExpirationDates`, validation contexts and more. Each fixture's `package.json` `description` says what it proves.
53
39
 
54
40
  ## Golden regression testing
55
41
 
56
- The three flagships have **no `expected/` mirror**. Their committed
57
- `docs/ENVIRONMENT.md`, `docs/OWNERSHIP.md`, `docs/env.evidence.json`,
58
- `.env.example`, and `src/generated/env.manifest.ts` *are* the golden — a reader
59
- opening the example sees exactly the bytes CI asserts on. `test/examples/*.test.ts`
60
- verifies each one by running that example's own `check` script (`env-cap --check`),
61
- the same command its README tells you to run in CI, so a drifted artifact fails
62
- the build and the drift guard itself gets exercised at the same time.
63
-
64
- A parallel `expected/` tree used to duplicate every artifact here. It was
65
- removed: each file existed twice with nothing marking which copy was
66
- authoritative, so a stale mirror could sit next to correct output indefinitely.
67
- (`enterprise-platform/expected/output.json` remains — that's the example's own
68
- runtime self-check, not a copy of anything `env-cap` generates.)
69
-
70
- The integration fixtures under `test/integration/positive/` and
71
- `test/integration/negative/` **do** keep `expected/` mirrors
72
- (`multiple-active-exclusive-capabilities` excepted, which by design never
73
- successfully generates anything). Those have no human reader, and an explicit
74
- side-by-side diff of generator output is exactly their point. CI regenerates
75
- each for real and compares byte-for-byte, after normalizing the wall-clock-relative
76
- parts (the docs Markdown's generation timestamp and any "expiring soon"/"expired"
77
- annotations). This is what actually catches a regression in the library's output
78
- formatting, ordering, or serialization — not just "does it still typecheck."
79
-
80
- When a change to `env-cap` intentionally changes generated output (a new field, a
81
- reordered section, a wording change), regenerate everything and review the diff:
42
+ None of the examples keeps an `expected/` tree of env-cap output. `enterprise-platform/expected/output.json` is that example's own smoke-test fixture. The committed `docs/`, `.env.example` and `src/generated/env.manifest.ts` are the golden output. Each example's `check` script recomputes them and compares, without writing:
43
+
44
+ | Command | Exit code | Line of output |
45
+ | --------------- | --------- | ----------------------------------------- |
46
+ | `npm run check` | `0` | `All generated artifacts are up to date.` |
47
+ | `npm run check` | `1` | A line containing `stale or missing` |
48
+
49
+ The integration fixtures under `test/integration/` keep `expected/` directories, because a side-by-side diff of generator output is their purpose. CI's `integration-fixtures` job regenerates each one and compares byte for byte. It ignores generation timestamps and the "expiring soon" annotations, which change with the date.
50
+
51
+ When a change alters generated output on purpose, regenerate everything and read the diff:
82
52
 
83
53
  ```bash
84
54
  npm run examples:update-golden
85
55
  ```
86
56
 
87
- This is deliberately **not** part of `npm run verify` or CI — it's a human-invoked "I meant to
88
- change the output, here's the new baseline" step, not something that should ever run silently.
57
+ This is a deliberate human step. It is not part of `npm run verify` or CI, so a regression is never re-goldened silently.
89
58
 
90
- ## Looking for the performance benchmarks?
59
+ ## Looking for the benchmarks?
91
60
 
92
- They've moved to [`/benchmarks`](../benchmarks/) — project confidence tooling, not an adoption
93
- sample like the three flagships above, so it lives as a top-level sibling of `examples/` rather
94
- than inside it. See [`benchmarks/README.md`](../benchmarks/README.md) for methodology, tier
95
- definitions, and what's deliberately not measured and why.
61
+ They live in [`/benchmarks`](../benchmarks/), with methodology in [`benchmarks/README.md`](../benchmarks/README.md).
package/package.json CHANGED
@@ -1,18 +1,20 @@
1
1
  {
2
2
  "name": "@maverickcer/env-cap",
3
- "version": "0.7.4",
4
- "description": "Secure, type-safe, framework-agnostic environment contracts. Contracts own the environment variables they consume; the package provides runtime validation and build-time contract discovery.",
3
+ "version": "0.7.6",
4
+ "description": "Each feature declares the environment variables it needs and their format. Your app validates them all in one place at startup, fails fast on a bad value, and reports how they should be rotated before they expire. A TypeScript library that works alongside dotenv, Zod or your secret manager.",
5
5
  "keywords": [
6
- "environment",
6
+ "environment-variables",
7
7
  "env",
8
+ "dotenv",
8
9
  "config",
9
- "configuration",
10
- "documentation",
11
10
  "validation",
12
11
  "typescript",
13
- "schema",
12
+ "ownership",
14
13
  "secrets",
15
- "dotenv"
14
+ "environment",
15
+ "expiry",
16
+ "static-analysis",
17
+ "documentation"
16
18
  ],
17
19
  "license": "MIT",
18
20
  "repository": {
@@ -32,60 +34,72 @@
32
34
  "exports": {
33
35
  ".": {
34
36
  "import": {
37
+ "types@>=7": "./dist/index.ts7.d.ts",
35
38
  "types": "./dist/index.d.ts",
36
39
  "default": "./dist/index.js"
37
40
  },
38
41
  "require": {
42
+ "types@>=7": "./dist/index.ts7.d.cts",
39
43
  "types": "./dist/index.d.cts",
40
44
  "default": "./dist/index.cjs"
41
45
  }
42
46
  },
43
47
  "./build": {
44
48
  "import": {
49
+ "types@>=7": "./dist/build.ts7.d.ts",
45
50
  "types": "./dist/build.d.ts",
46
51
  "default": "./dist/build.js"
47
52
  },
48
53
  "require": {
54
+ "types@>=7": "./dist/build.ts7.d.cts",
49
55
  "types": "./dist/build.d.cts",
50
56
  "default": "./dist/build.cjs"
51
57
  }
52
58
  },
53
59
  "./helpers": {
54
60
  "import": {
61
+ "types@>=7": "./dist/helpers.ts7.d.ts",
55
62
  "types": "./dist/helpers.d.ts",
56
63
  "default": "./dist/helpers.js"
57
64
  },
58
65
  "require": {
66
+ "types@>=7": "./dist/helpers.ts7.d.cts",
59
67
  "types": "./dist/helpers.d.cts",
60
68
  "default": "./dist/helpers.cjs"
61
69
  }
62
70
  },
63
71
  "./node": {
64
72
  "import": {
73
+ "types@>=7": "./dist/node.ts7.d.ts",
65
74
  "types": "./dist/node.d.ts",
66
75
  "default": "./dist/node.js"
67
76
  },
68
77
  "require": {
78
+ "types@>=7": "./dist/node.ts7.d.cts",
69
79
  "types": "./dist/node.d.cts",
70
80
  "default": "./dist/node.cjs"
71
81
  }
72
82
  },
73
83
  "./evidence": {
74
84
  "import": {
85
+ "types@>=7": "./dist/evidence.ts7.d.ts",
75
86
  "types": "./dist/evidence.d.ts",
76
87
  "default": "./dist/evidence.js"
77
88
  },
78
89
  "require": {
90
+ "types@>=7": "./dist/evidence.ts7.d.cts",
79
91
  "types": "./dist/evidence.d.cts",
80
92
  "default": "./dist/evidence.cjs"
81
93
  }
82
94
  },
83
95
  "./eslint-plugin": {
84
96
  "import": {
97
+ "types@>=7": "./dist/eslint-plugin/index.ts7.d.ts",
85
98
  "types": "./dist/eslint-plugin/index.d.ts",
86
99
  "default": "./dist/eslint-plugin/index.js"
87
100
  },
88
101
  "require": {
102
+ "types@>=7": "./dist/eslint-plugin/index.ts7.d.cts",
89
103
  "types": "./dist/eslint-plugin/index.d.cts",
90
104
  "default": "./dist/eslint-plugin/index.cjs"
91
105
  }
@@ -125,7 +139,7 @@
125
139
  "lint": "eslint .",
126
140
  "format": "prettier --write .",
127
141
  "format:check": "prettier --check .",
128
- "setup": "npm install && npm run build && npm run schema",
142
+ "setup": "npm install && npm run build && npm run schema && internal-package-contract install-hooks",
129
143
  "size": "internal-package-contract tool size",
130
144
  "schema": "node scripts/generate-json-schema.mjs",
131
145
  "examples:update-golden": "node scripts/update-example-goldens.mjs",
@@ -141,9 +155,10 @@
141
155
  "precommit": "npm run typecheck && npm run lint && npm run format && npm run build && npm run schema && npm run test:coverage && npm run size && npm run verify:ambient && npm run verify:compiler-isolation && npm run docs:api:report:check && npm run verify:readme-example",
142
156
  "verify": "npm run typecheck && npm run lint && npm run format:check && npm run build && npm run schema && npm run test:coverage && npm run size && npm run verify:ambient && npm run verify:compiler-isolation && npm run docs:api:report:check && npm run verify:readme-example",
143
157
  "prepublishOnly": "npm run verify",
144
- "version": "changeset version && npm run build && npm run examples:update-golden && internal-package-contract skill && internal-package-contract site",
158
+ "version": "changeset version && npm run build && internal-package-contract update-baseline && npm run examples:update-golden && internal-package-contract skill && internal-package-contract site",
145
159
  "release": "changeset publish",
146
- "benchmark:check": "node scripts/run-benchmarks.mjs --check"
160
+ "benchmark:check": "node scripts/run-benchmarks.mjs --check",
161
+ "package-managers": "node scripts/package-managers-smoke.mjs"
147
162
  },
148
163
  "dependencies": {
149
164
  "@typescript/typescript6": "^6.0.2"
@@ -175,12 +190,14 @@
175
190
  "@typescript-eslint/utils": "^8.65.0",
176
191
  "@vitest/coverage-v8": "^5.0.3",
177
192
  "ajv": "^8.20.0",
193
+ "ajv-draft-04": "^1.0.0",
194
+ "ajv-formats": "^3.0.1",
178
195
  "esbuild": "^0.28.1",
179
196
  "eslint": "^10.9.0",
180
197
  "eslint-config-prettier": "10.1.8",
181
198
  "fast-check": "^4.10.2",
182
199
  "globals": "^17.9.0",
183
- "internal-package-contract": "github:MaverickCER/internal-package-contract#v0.14.0",
200
+ "internal-package-contract": "github:MaverickCER/internal-package-contract#v0.19.0",
184
201
  "prettier": "3.9.10",
185
202
  "ts-json-schema-generator": "^2.9.0",
186
203
  "tsup": "^9.0.0",
@@ -223,6 +240,8 @@
223
240
  "copies": [
224
241
  "benchmark-budgets",
225
242
  "build-fs",
243
+ "ci-jobs",
244
+ "ci-jobs-test",
226
245
  "code-of-conduct",
227
246
  "compiler-api",
228
247
  "display-path",
@@ -233,6 +252,8 @@
233
252
  "reading-benchmarks",
234
253
  "releasing",
235
254
  "resolve-tsconfig-paths",
255
+ "schema-sarif-2.1.0",
256
+ "standards-readme",
236
257
  "support",
237
258
  "typedoc-markdown",
238
259
  "typescript",
@@ -248,7 +269,17 @@
248
269
  "bin",
249
270
  "./eslint-plugin",
250
271
  "./node"
272
+ ],
273
+ "env": [
274
+ "bin",
275
+ "./eslint-plugin"
251
276
  ]
252
- }
277
+ },
278
+ "surfaceRenderers": [
279
+ "src/build/docs.ts",
280
+ "src/build/env-example.ts",
281
+ "src/build/usage-report.ts",
282
+ "scripts/github-action/report.mjs"
283
+ ]
253
284
  }
254
285
  }
@@ -2,7 +2,7 @@
2
2
  "$schema": "http://json-schema.org/draft-07/schema#",
3
3
  "$id": "https://maverickcer.github.io/env-cap/schema/contract-model.schema.json",
4
4
  "title": "env-cap Contract Model",
5
- "description": "Canonical, versioned projection of every declared environment-variable contract, active or not (see ADR 0024, ADR 0025). Generated from src/build/contract-model.ts's ContractModel type -- never hand-authored.",
5
+ "description": "Canonical, versioned projection of every declared environment-variable contract, active or not (see ADR 0024, ADR 0025). Generated from src/build/contract-model.ts's ContractModel type, never by hand.",
6
6
  "$ref": "#/definitions/ContractModel",
7
7
  "definitions": {
8
8
  "ContractModel": {
@@ -24,7 +24,7 @@
24
24
  "contracts"
25
25
  ],
26
26
  "additionalProperties": false,
27
- "description": "The versioned, JSON-serializable root of the Contract Model -- every discovered `createEnv()` contract (active or not), each with its own full statically-discoverable shape. See ContractModelContract."
27
+ "description": "The versioned, JSON-serializable root of the Contract Model: every discovered `createEnv()` contract (active or not), each with its own full statically-discoverable shape. See ContractModelContract."
28
28
  },
29
29
  "ContractModelContract": {
30
30
  "type": "object",
@@ -69,7 +69,7 @@
69
69
  },
70
70
  "file": {
71
71
  "type": "string",
72
- "description": "Root-relative, POSIX-separated -- matches `DiscoveredContractSummary.file`."
72
+ "description": "Root-relative, POSIX-separated: matches `DiscoveredContractSummary.file`."
73
73
  },
74
74
  "exportName": {
75
75
  "type": "string"
@@ -233,7 +233,7 @@
233
233
  },
234
234
  "evidence": {
235
235
  "$ref": "#/definitions/DiscoveredVariableEvidence",
236
- "description": "The `evidence` sub-object from this variable's linked documentation -- re-verified every run, unlike every declared-only field above. See runtime.VariableEvidenceDocs and ADR 0037."
236
+ "description": "The `evidence` sub-object from this variable's linked documentation: re-verified every run, unlike every declared-only field above. See runtime.VariableEvidenceDocs and ADR 0037."
237
237
  },
238
238
  "declaration": {
239
239
  "$ref": "#/definitions/SourcePosition",
@@ -259,7 +259,7 @@
259
259
  "items": {
260
260
  "type": "string"
261
261
  },
262
- "description": "Well-formed `\"path:line:column\"` entries from `evidence.dynamicAccess`, if set to an array of string literals -- a malformed entry warns and is dropped, never included here. See ADR 0037."
262
+ "description": "Well-formed `\"path:line:column\"` entries from `evidence.dynamicAccess`, if set to an array of string literals: a malformed entry warns and is dropped, never included here. See ADR 0037."
263
263
  }
264
264
  },
265
265
  "additionalProperties": false,
@@ -287,7 +287,7 @@
287
287
  "column"
288
288
  ],
289
289
  "additionalProperties": false,
290
- "description": "A precise pointer into a source file -- the shared shape every exact-position fact in the build pipeline (declaration sites, usage sites, dynamic-access sites) uses, so a consumer never has to reconcile three ad hoc `{ file; line; column }` shapes that happen to mean the same thing. See ADR 0036."
290
+ "description": "A precise pointer into a source file. Every exact-position fact in the build pipeline (declaration sites, usage sites, dynamic-access sites) shares this shape. So a consumer never has to reconcile three ad hoc `{ file; line; column }` shapes that happen to mean the same thing. See ADR 0036."
291
291
  },
292
292
  "PackageOrigin": {
293
293
  "type": "object",
@@ -316,7 +316,7 @@
316
316
  "packageDir"
317
317
  ],
318
318
  "additionalProperties": false,
319
- "description": "Both the authored and resolved forms are kept -- diagnostics benefit from showing exactly what a package author wrote versus what it resolved to."
319
+ "description": "Both the authored and resolved forms are kept: diagnostics benefit from showing exactly what a package author wrote versus what it resolved to."
320
320
  }
321
321
  }
322
322
  }