@maverickcer/env-cap 0.7.5 → 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 (278) hide show
  1. package/ADOPTION.md +12 -12
  2. package/AGENTS.md +85 -120
  3. package/CHANGELOG.md +27 -0
  4. package/CODE_REVIEW.md +5 -5
  5. package/CONTRIBUTING.md +5 -5
  6. package/GUIDE.md +42 -24
  7. package/README.md +52 -34
  8. package/RELEASING.md +78 -64
  9. package/SECURITY.md +15 -15
  10. package/VERSIONING.md +16 -15
  11. package/benchmarks/READING-BENCHMARKS.md +101 -85
  12. package/benchmarks/README.md +12 -9
  13. package/benchmarks/WRITING-BENCHMARKS.md +89 -79
  14. package/benchmarks/performance-buildtime/BENCHMARKS.md +20 -20
  15. package/benchmarks/performance-runtime/BENCHMARKS.md +107 -107
  16. package/dist/.dts/_ipc/build-fs.d.ts +3 -3
  17. package/dist/.dts/_ipc/build-fs.d.ts.map +1 -1
  18. package/dist/.dts/_ipc/display-path.d.ts +1 -1
  19. package/dist/.dts/_ipc/glob.d.ts +3 -2
  20. package/dist/.dts/_ipc/glob.d.ts.map +1 -1
  21. package/dist/.dts/_ipc/no-node-fs.d.ts +2 -2
  22. package/dist/.dts/_ipc/resolve-tsconfig-paths.d.ts +16 -16
  23. package/dist/.dts/_ipc/resolve-tsconfig-paths.d.ts.map +1 -1
  24. package/dist/.dts/_ipc/typescript.d.ts +4 -4
  25. package/dist/.dts/build/assemble-project.d.ts +14 -15
  26. package/dist/.dts/build/assemble-project.d.ts.map +1 -1
  27. package/dist/.dts/build/change-model.d.ts +14 -14
  28. package/dist/.dts/build/change-model.d.ts.map +1 -1
  29. package/dist/.dts/build/check-artifacts.d.ts +4 -4
  30. package/dist/.dts/build/check-artifacts.d.ts.map +1 -1
  31. package/dist/.dts/build/citation-verification.d.ts +13 -14
  32. package/dist/.dts/build/citation-verification.d.ts.map +1 -1
  33. package/dist/.dts/build/compatibility.d.ts +24 -24
  34. package/dist/.dts/build/compatibility.d.ts.map +1 -1
  35. package/dist/.dts/build/contract-model.d.ts +10 -10
  36. package/dist/.dts/build/contract-model.d.ts.map +1 -1
  37. package/dist/.dts/build/deep-equal.d.ts +2 -2
  38. package/dist/.dts/build/deep-freeze.d.ts +2 -2
  39. package/dist/.dts/build/dependency-graph.d.ts +48 -55
  40. package/dist/.dts/build/dependency-graph.d.ts.map +1 -1
  41. package/dist/.dts/build/dependency-model.d.ts +18 -18
  42. package/dist/.dts/build/dependency-model.d.ts.map +1 -1
  43. package/dist/.dts/build/discover.d.ts +11 -11
  44. package/dist/.dts/build/discover.d.ts.map +1 -1
  45. package/dist/.dts/build/docs.d.ts +34 -38
  46. package/dist/.dts/build/docs.d.ts.map +1 -1
  47. package/dist/.dts/build/env-example.d.ts +13 -13
  48. package/dist/.dts/build/env-example.d.ts.map +1 -1
  49. package/dist/.dts/build/errors.d.ts +8 -8
  50. package/dist/.dts/build/evidence-cache.d.ts +23 -23
  51. package/dist/.dts/build/evidence-cache.d.ts.map +1 -1
  52. package/dist/.dts/build/evidence-model.d.ts +3 -3
  53. package/dist/.dts/build/evidence-reference.d.ts +15 -15
  54. package/dist/.dts/build/evidence-reference.d.ts.map +1 -1
  55. package/dist/.dts/build/evidence-snapshot.d.ts +47 -53
  56. package/dist/.dts/build/evidence-snapshot.d.ts.map +1 -1
  57. package/dist/.dts/build/exclusive-group.d.ts +4 -4
  58. package/dist/.dts/build/exclusive-group.d.ts.map +1 -1
  59. package/dist/.dts/build/finding-model.d.ts +12 -12
  60. package/dist/.dts/build/finding-model.d.ts.map +1 -1
  61. package/dist/.dts/build/generate-documentation.d.ts +19 -19
  62. package/dist/.dts/build/generate-documentation.d.ts.map +1 -1
  63. package/dist/.dts/build/generate-env-artifacts.d.ts +43 -43
  64. package/dist/.dts/build/generate-env-artifacts.d.ts.map +1 -1
  65. package/dist/.dts/build/generate-evidence.d.ts +19 -19
  66. package/dist/.dts/build/generate-evidence.d.ts.map +1 -1
  67. package/dist/.dts/build/generate-manifest.d.ts +11 -12
  68. package/dist/.dts/build/generate-manifest.d.ts.map +1 -1
  69. package/dist/.dts/build/generate-usage.d.ts +23 -24
  70. package/dist/.dts/build/generate-usage.d.ts.map +1 -1
  71. package/dist/.dts/build/generated-banner.d.ts +5 -5
  72. package/dist/.dts/build/governance-fields.d.ts +7 -7
  73. package/dist/.dts/build/humanize-key.d.ts +1 -1
  74. package/dist/.dts/build/humanize-key.d.ts.map +1 -1
  75. package/dist/.dts/build/index.d.ts +20 -36
  76. package/dist/.dts/build/index.d.ts.map +1 -1
  77. package/dist/.dts/build/lifecycle-model.d.ts +87 -85
  78. package/dist/.dts/build/lifecycle-model.d.ts.map +1 -1
  79. package/dist/.dts/build/link.d.ts +38 -39
  80. package/dist/.dts/build/link.d.ts.map +1 -1
  81. package/dist/.dts/build/literal-eval.d.ts +2 -2
  82. package/dist/.dts/build/literal-eval.d.ts.map +1 -1
  83. package/dist/.dts/build/live-expirations.d.ts +14 -13
  84. package/dist/.dts/build/live-expirations.d.ts.map +1 -1
  85. package/dist/.dts/build/manifest.d.ts +6 -6
  86. package/dist/.dts/build/map-utils.d.ts +4 -4
  87. package/dist/.dts/build/merge-documentation.d.ts +9 -8
  88. package/dist/.dts/build/merge-documentation.d.ts.map +1 -1
  89. package/dist/.dts/build/ownership-model.d.ts +14 -15
  90. package/dist/.dts/build/ownership-model.d.ts.map +1 -1
  91. package/dist/.dts/build/parse.d.ts +20 -21
  92. package/dist/.dts/build/parse.d.ts.map +1 -1
  93. package/dist/.dts/build/reference-projections.d.ts +36 -38
  94. package/dist/.dts/build/reference-projections.d.ts.map +1 -1
  95. package/dist/.dts/build/resolution/resolve-import.d.ts +18 -14
  96. package/dist/.dts/build/resolution/resolve-import.d.ts.map +1 -1
  97. package/dist/.dts/build/resolution/resolve-package-schema.d.ts +26 -26
  98. package/dist/.dts/build/resolution/resolve-package-schema.d.ts.map +1 -1
  99. package/dist/.dts/build/resolution/resolve-within-root.d.ts +9 -9
  100. package/dist/.dts/build/sarif.d.ts +5 -5
  101. package/dist/.dts/build/sarif.d.ts.map +1 -1
  102. package/dist/.dts/build/scan-dependencies.d.ts +17 -16
  103. package/dist/.dts/build/scan-dependencies.d.ts.map +1 -1
  104. package/dist/.dts/build/sort-by-identity.d.ts +1 -1
  105. package/dist/.dts/build/source-position.d.ts +13 -13
  106. package/dist/.dts/build/tool-version.d.ts +1 -1
  107. package/dist/.dts/build/usage-report.d.ts +19 -19
  108. package/dist/.dts/build/usage-report.d.ts.map +1 -1
  109. package/dist/.dts/eslint-plugin/index.d.ts +16 -5
  110. package/dist/.dts/eslint-plugin/index.d.ts.map +1 -1
  111. package/dist/.dts/eslint-plugin/no-raw-process-env.d.ts +4 -4
  112. package/dist/.dts/evidence/define-projection.d.ts +15 -16
  113. package/dist/.dts/evidence/define-projection.d.ts.map +1 -1
  114. package/dist/.dts/evidence/index.d.ts +11 -15
  115. package/dist/.dts/evidence/index.d.ts.map +1 -1
  116. package/dist/.dts/helpers/index.d.ts +15 -18
  117. package/dist/.dts/helpers/index.d.ts.map +1 -1
  118. package/dist/.dts/helpers/validators.d.ts +2 -2
  119. package/dist/.dts/helpers/validators.d.ts.map +1 -1
  120. package/dist/.dts/node/index.d.ts +19 -0
  121. package/dist/.dts/node/index.d.ts.map +1 -1
  122. package/dist/.dts/runtime/create.d.ts +3 -3
  123. package/dist/.dts/runtime/document.d.ts +90 -99
  124. package/dist/.dts/runtime/document.d.ts.map +1 -1
  125. package/dist/.dts/runtime/errors.d.ts +5 -5
  126. package/dist/.dts/runtime/reset.d.ts +1 -1
  127. package/dist/.dts/runtime/types.d.ts +23 -24
  128. package/dist/.dts/runtime/types.d.ts.map +1 -1
  129. package/dist/.dts/runtime/validate.d.ts +1 -1
  130. package/dist/.dts7/_ipc/build-fs.d.ts +3 -3
  131. package/dist/.dts7/_ipc/build-fs.d.ts.map +1 -1
  132. package/dist/.dts7/_ipc/display-path.d.ts +1 -1
  133. package/dist/.dts7/_ipc/glob.d.ts +3 -2
  134. package/dist/.dts7/_ipc/glob.d.ts.map +1 -1
  135. package/dist/.dts7/_ipc/no-node-fs.d.ts +2 -2
  136. package/dist/.dts7/_ipc/resolve-tsconfig-paths.d.ts +16 -16
  137. package/dist/.dts7/_ipc/resolve-tsconfig-paths.d.ts.map +1 -1
  138. package/dist/.dts7/_ipc/typescript.d.ts +4 -4
  139. package/dist/.dts7/build/assemble-project.d.ts +14 -15
  140. package/dist/.dts7/build/assemble-project.d.ts.map +1 -1
  141. package/dist/.dts7/build/change-model.d.ts +14 -14
  142. package/dist/.dts7/build/change-model.d.ts.map +1 -1
  143. package/dist/.dts7/build/check-artifacts.d.ts +4 -4
  144. package/dist/.dts7/build/check-artifacts.d.ts.map +1 -1
  145. package/dist/.dts7/build/citation-verification.d.ts +13 -14
  146. package/dist/.dts7/build/citation-verification.d.ts.map +1 -1
  147. package/dist/.dts7/build/compatibility.d.ts +24 -24
  148. package/dist/.dts7/build/compatibility.d.ts.map +1 -1
  149. package/dist/.dts7/build/contract-model.d.ts +10 -10
  150. package/dist/.dts7/build/contract-model.d.ts.map +1 -1
  151. package/dist/.dts7/build/deep-equal.d.ts +2 -2
  152. package/dist/.dts7/build/deep-freeze.d.ts +2 -2
  153. package/dist/.dts7/build/dependency-graph.d.ts +48 -55
  154. package/dist/.dts7/build/dependency-graph.d.ts.map +1 -1
  155. package/dist/.dts7/build/dependency-model.d.ts +18 -18
  156. package/dist/.dts7/build/dependency-model.d.ts.map +1 -1
  157. package/dist/.dts7/build/discover.d.ts +11 -11
  158. package/dist/.dts7/build/discover.d.ts.map +1 -1
  159. package/dist/.dts7/build/docs.d.ts +34 -38
  160. package/dist/.dts7/build/docs.d.ts.map +1 -1
  161. package/dist/.dts7/build/env-example.d.ts +13 -13
  162. package/dist/.dts7/build/env-example.d.ts.map +1 -1
  163. package/dist/.dts7/build/errors.d.ts +8 -8
  164. package/dist/.dts7/build/evidence-cache.d.ts +23 -23
  165. package/dist/.dts7/build/evidence-cache.d.ts.map +1 -1
  166. package/dist/.dts7/build/evidence-model.d.ts +3 -3
  167. package/dist/.dts7/build/evidence-reference.d.ts +15 -15
  168. package/dist/.dts7/build/evidence-reference.d.ts.map +1 -1
  169. package/dist/.dts7/build/evidence-snapshot.d.ts +47 -53
  170. package/dist/.dts7/build/evidence-snapshot.d.ts.map +1 -1
  171. package/dist/.dts7/build/exclusive-group.d.ts +4 -4
  172. package/dist/.dts7/build/exclusive-group.d.ts.map +1 -1
  173. package/dist/.dts7/build/finding-model.d.ts +12 -12
  174. package/dist/.dts7/build/finding-model.d.ts.map +1 -1
  175. package/dist/.dts7/build/generate-documentation.d.ts +19 -19
  176. package/dist/.dts7/build/generate-documentation.d.ts.map +1 -1
  177. package/dist/.dts7/build/generate-env-artifacts.d.ts +43 -43
  178. package/dist/.dts7/build/generate-env-artifacts.d.ts.map +1 -1
  179. package/dist/.dts7/build/generate-evidence.d.ts +19 -19
  180. package/dist/.dts7/build/generate-evidence.d.ts.map +1 -1
  181. package/dist/.dts7/build/generate-manifest.d.ts +11 -12
  182. package/dist/.dts7/build/generate-manifest.d.ts.map +1 -1
  183. package/dist/.dts7/build/generate-usage.d.ts +23 -24
  184. package/dist/.dts7/build/generate-usage.d.ts.map +1 -1
  185. package/dist/.dts7/build/generated-banner.d.ts +5 -5
  186. package/dist/.dts7/build/governance-fields.d.ts +7 -7
  187. package/dist/.dts7/build/humanize-key.d.ts +1 -1
  188. package/dist/.dts7/build/humanize-key.d.ts.map +1 -1
  189. package/dist/.dts7/build/index.d.ts +20 -36
  190. package/dist/.dts7/build/index.d.ts.map +1 -1
  191. package/dist/.dts7/build/lifecycle-model.d.ts +87 -85
  192. package/dist/.dts7/build/lifecycle-model.d.ts.map +1 -1
  193. package/dist/.dts7/build/link.d.ts +38 -39
  194. package/dist/.dts7/build/link.d.ts.map +1 -1
  195. package/dist/.dts7/build/literal-eval.d.ts +2 -2
  196. package/dist/.dts7/build/literal-eval.d.ts.map +1 -1
  197. package/dist/.dts7/build/live-expirations.d.ts +14 -13
  198. package/dist/.dts7/build/live-expirations.d.ts.map +1 -1
  199. package/dist/.dts7/build/manifest.d.ts +6 -6
  200. package/dist/.dts7/build/map-utils.d.ts +4 -4
  201. package/dist/.dts7/build/merge-documentation.d.ts +9 -8
  202. package/dist/.dts7/build/merge-documentation.d.ts.map +1 -1
  203. package/dist/.dts7/build/ownership-model.d.ts +14 -15
  204. package/dist/.dts7/build/ownership-model.d.ts.map +1 -1
  205. package/dist/.dts7/build/parse.d.ts +20 -21
  206. package/dist/.dts7/build/parse.d.ts.map +1 -1
  207. package/dist/.dts7/build/reference-projections.d.ts +36 -38
  208. package/dist/.dts7/build/reference-projections.d.ts.map +1 -1
  209. package/dist/.dts7/build/resolution/resolve-import.d.ts +18 -14
  210. package/dist/.dts7/build/resolution/resolve-import.d.ts.map +1 -1
  211. package/dist/.dts7/build/resolution/resolve-package-schema.d.ts +26 -26
  212. package/dist/.dts7/build/resolution/resolve-package-schema.d.ts.map +1 -1
  213. package/dist/.dts7/build/resolution/resolve-within-root.d.ts +9 -9
  214. package/dist/.dts7/build/sarif.d.ts +5 -5
  215. package/dist/.dts7/build/sarif.d.ts.map +1 -1
  216. package/dist/.dts7/build/scan-dependencies.d.ts +17 -16
  217. package/dist/.dts7/build/scan-dependencies.d.ts.map +1 -1
  218. package/dist/.dts7/build/sort-by-identity.d.ts +1 -1
  219. package/dist/.dts7/build/source-position.d.ts +13 -13
  220. package/dist/.dts7/build/tool-version.d.ts +1 -1
  221. package/dist/.dts7/build/usage-report.d.ts +19 -19
  222. package/dist/.dts7/build/usage-report.d.ts.map +1 -1
  223. package/dist/.dts7/eslint-plugin/index.d.ts +16 -5
  224. package/dist/.dts7/eslint-plugin/index.d.ts.map +1 -1
  225. package/dist/.dts7/eslint-plugin/no-raw-process-env.d.ts +4 -4
  226. package/dist/.dts7/evidence/define-projection.d.ts +15 -16
  227. package/dist/.dts7/evidence/define-projection.d.ts.map +1 -1
  228. package/dist/.dts7/evidence/index.d.ts +11 -15
  229. package/dist/.dts7/evidence/index.d.ts.map +1 -1
  230. package/dist/.dts7/helpers/index.d.ts +15 -18
  231. package/dist/.dts7/helpers/index.d.ts.map +1 -1
  232. package/dist/.dts7/helpers/validators.d.ts +2 -2
  233. package/dist/.dts7/helpers/validators.d.ts.map +1 -1
  234. package/dist/.dts7/node/index.d.ts +19 -0
  235. package/dist/.dts7/node/index.d.ts.map +1 -1
  236. package/dist/.dts7/runtime/create.d.ts +3 -3
  237. package/dist/.dts7/runtime/document.d.ts +90 -99
  238. package/dist/.dts7/runtime/document.d.ts.map +1 -1
  239. package/dist/.dts7/runtime/errors.d.ts +5 -5
  240. package/dist/.dts7/runtime/reset.d.ts +1 -1
  241. package/dist/.dts7/runtime/types.d.ts +23 -24
  242. package/dist/.dts7/runtime/types.d.ts.map +1 -1
  243. package/dist/.dts7/runtime/validate.d.ts +1 -1
  244. package/dist/{build-DNAYWD2B.js → build-UEENZEUX.js} +37 -39
  245. package/dist/build-UEENZEUX.js.map +1 -0
  246. package/dist/build.cjs +36 -38
  247. package/dist/build.cjs.map +1 -1
  248. package/dist/build.js +36 -38
  249. package/dist/build.js.map +1 -1
  250. package/dist/{chunk-HAGMVMN5.js → chunk-TBL3O7IG.js} +2 -2
  251. package/dist/cli/index.js +29 -28
  252. package/dist/cli/index.js.map +1 -1
  253. package/dist/eslint-plugin/index.cjs.map +1 -1
  254. package/dist/eslint-plugin/index.js.map +1 -1
  255. package/dist/evidence.cjs +1 -1
  256. package/dist/evidence.cjs.map +1 -1
  257. package/dist/evidence.js +1 -1
  258. package/dist/evidence.js.map +1 -1
  259. package/dist/helpers.cjs +4 -4
  260. package/dist/helpers.cjs.map +1 -1
  261. package/dist/helpers.js +4 -4
  262. package/dist/helpers.js.map +1 -1
  263. package/dist/index.cjs.map +1 -1
  264. package/dist/index.js.map +1 -1
  265. package/examples/README.md +1 -1
  266. package/package.json +18 -10
  267. package/schemas/contract-model.schema.json +7 -7
  268. package/schemas/env-cap-report.schema.json +88 -88
  269. package/skills/env-cap/SKILL.md +12 -13
  270. package/skills/env-cap/references/api.md +1 -1
  271. package/specs/architecture.md +145 -120
  272. package/specs/generated-artifacts.md +78 -70
  273. package/specs/migrations/README.md +6 -6
  274. package/specs/migrations/from-centralized-schema.md +1 -1
  275. package/specs/migrations/from-t3-env.md +9 -9
  276. package/PROMPT.md +0 -89
  277. package/dist/build-DNAYWD2B.js.map +0 -1
  278. /package/dist/{chunk-HAGMVMN5.js.map → chunk-TBL3O7IG.js.map} +0 -0
@@ -1 +1 @@
1
- {"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../src/runtime/document.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../src/runtime/document.ts"],"names":[],"mappings":"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"}
@@ -2,10 +2,10 @@
2
2
  * Every error type here is constructed only from: the variable name, the
3
3
  * declaring contract's name, the failure kind, and a message string that the
4
4
  * *developer's own* processor/validator produced. Raw or processed environment
5
- * values are never read into an error -- see the Security section in the README.
5
+ * values are never read into an error: see the Security section in the README.
6
6
  *
7
7
  * Documentation (description, owner, etc.) never appears here, even when a
8
- * {@link documentEnv} call exists for this variable -- `documentEnv` is
8
+ * {@link documentEnv} call exists for this variable: `documentEnv` is
9
9
  * build-time-only and its data is never retained anywhere {@link validateEnv}
10
10
  * could read it back out. This is a deliberate consequence of keeping the
11
11
  * runtime minimal, not an oversight.
@@ -25,11 +25,11 @@ export interface VariableFailure {
25
25
  }
26
26
  /**
27
27
  * Thrown by {@link validateEnv} when one or more variables fail processing or
28
- * validation. Aggregates every failure across every contract in the batch --
28
+ * validation. Aggregates every failure across every contract in the batch:
29
29
  * the caller sees the whole picture in one error, not one-at-a-time.
30
30
  *
31
31
  * @remarks
32
- * `code` is a stable, Stable-tier discriminant for programmatic handling --
32
+ * `code` is a stable, Stable-tier discriminant for programmatic handling:
33
33
  * prefer it over `.name`/`instanceof` when a message-independent switch is needed.
34
34
  */
35
35
  export declare class EnvValidationError extends Error {
@@ -44,7 +44,7 @@ export declare class EnvValidationError extends Error {
44
44
  * {@link validateEnv} has completed successfully for it.
45
45
  *
46
46
  * @remarks
47
- * `code` is a stable, Stable-tier discriminant for programmatic handling --
47
+ * `code` is a stable, Stable-tier discriminant for programmatic handling:
48
48
  * prefer it over `.name`/`instanceof` when a message-independent switch is needed.
49
49
  */
50
50
  export declare class EnvNotReadyError extends Error {
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Clears cached validation state. Intended for tests and dev tooling (e.g.
3
3
  * `beforeEach(() => resetEnvCache())` in a test suite that re-validates with
4
- * different fixture values per test) -- production applications validate
4
+ * different fixture values per test): production applications validate
5
5
  * once at startup and should not normally call this.
6
6
  */
7
7
  export declare function resetEnvCache(): void;
@@ -3,19 +3,18 @@
3
3
  *
4
4
  * These types are intentionally minimal: an `EnvDefinition` describes how to
5
5
  * turn one raw environment value into one typed, validated application
6
- * value. There is no `optional`/`required` flag anywhere in this file --
6
+ * value. There is no `optional`/`required` flag anywhere in this file:
7
7
  * requiredness is just a validator that rejects `undefined`/empty values.
8
8
  *
9
9
  * Documentation fields (description, owner, expiresAt, category, ...) live
10
- * entirely in {@link documentEnv} (see `document.ts`), not here -- this file is
10
+ * entirely in {@link documentEnv} (see `document.ts`), not here: this file is
11
11
  * the runtime's whole vocabulary, and every field in it is read by
12
12
  * `validate.ts`/`create.ts`/`errors.ts` at runtime. If a field is only ever
13
13
  * read by the generator, it belongs in `document.ts`, not here. `context` is
14
- * the one exception worth calling out: it's also read by the build package
15
- * for documentation display (see ADR 0022), but it belongs here rather than
16
- * in `documentEnv()` because `validate.ts` reads it too, to decide pipeline
17
- * participation -- the same bar `default`/`processor`/`validator` already
18
- * clear.
14
+ * the one exception. The build package also reads it for documentation
15
+ * display (see ADR 0022). It belongs here rather than in `documentEnv()`
16
+ * because `validate.ts` reads it too, to decide pipeline participation: the
17
+ * same bar `default`/`processor`/`validator` already clear.
19
18
  */
20
19
  /** The raw, unprocessed source of environment values (e.g. `process.env`, a resolved secrets bag). */
21
20
  export type RawEnv = Readonly<Record<string, unknown>>;
@@ -35,7 +34,7 @@ export type Validator<T> = (value: T, rawEnv: RawEnv) => true | string;
35
34
  *
36
35
  * @remarks
37
36
  * The union is redundant at the type level (`unknown` alone already accepts a
38
- * function) -- it's kept because this type is public API, and collapsing it to bare `unknown`
37
+ * function). It's kept because this type is public API: collapsing it to bare `unknown`
39
38
  * would erase the one thing a reader of the generated `.d.ts` needs to learn here.
40
39
  */
41
40
  export type DefaultValue = unknown | (() => unknown);
@@ -49,17 +48,17 @@ export interface EnvDefinition<T> {
49
48
  validator?: Validator<T>;
50
49
  /**
51
50
  * The validation context this variable belongs to (e.g. `"server"`,
52
- * `"production"`, `"worker"`) -- entirely application-defined; env-cap
51
+ * `"production"`, `"worker"`): entirely application-defined; env-cap
53
52
  * never interprets, detects, or infers this string. Omitted (the
54
53
  * default) means the variable participates in every {@link validateEnv}
55
54
  * run regardless of `activeContexts`. A variable belongs to at most one
56
- * validation context -- see ADR 0022 for why this is a single `string`
57
- * and not `string[]`; do not widen it to an array to let one variable
58
- * join multiple contexts, that reintroduces the AND/OR ambiguity this
55
+ * validation context: see ADR 0022 for why this is a single `string`
56
+ * and not `string[]`. Do not widen it to an array to let one variable
57
+ * join multiple contexts. That reintroduces the AND/OR ambiguity this
59
58
  * design deliberately avoids.
60
59
  *
61
60
  * @remarks
62
- * Validation contexts are a participation filter only -- not
61
+ * Validation contexts are a participation filter only: not
63
62
  * authentication, authorization, or a bundling/security boundary. See
64
63
  * ADR 0022's Formal Invariants.
65
64
  */
@@ -84,7 +83,7 @@ type UnwrapDefault<D> = D extends {
84
83
  * default's type, else `string` (the shape raw process.env values naturally arrive in).
85
84
  *
86
85
  * @remarks
87
- * Same documented generic-bound variance workaround as {@link EnvSchema} above --
86
+ * Same documented generic-bound variance workaround as {@link EnvSchema} above:
88
87
  * `any` here is never surfaced to a consumer's inferred type.
89
88
  */
90
89
  export type InferEnvValue<D extends EnvDefinition<any>> = D extends {
@@ -100,18 +99,18 @@ export interface ContractInternals<S extends EnvSchema = EnvSchema> {
100
99
  }
101
100
  /**
102
101
  * The object returned by {@link createEnv}. Each key is a lazily-resolved getter backed by the
103
- * runtime cache -- there is no global env object, only per-feature contracts like this one.
102
+ * runtime cache: there is no global env object, only per-feature contracts like this one.
104
103
  *
105
104
  * @remarks
106
105
  * `toString()` is intersected in (rather than left to the ambient `Object.prototype`
107
106
  * declaration) because `create.ts` genuinely overrides it to return a redacted
108
- * `EnvContract("name")` representation, never resolved values -- see ADR 0006. Declaring
107
+ * `EnvContract("name")` representation, never resolved values: see ADR 0006. Declaring
109
108
  * it here means the type accurately describes what calling `String(contract)` returns.
110
109
  */
111
110
  export type EnvContract<S extends EnvSchema> = {
112
111
  readonly [K in keyof S]: InferEnvValue<S[K]>;
113
112
  } & {
114
- /** Returns the redacted `EnvContract("name")` representation, never resolved values -- see ADR 0006. */
113
+ /** Returns the redacted `EnvContract("name")` representation, never resolved values: see ADR 0006. */
115
114
  toString(): string;
116
115
  };
117
116
  /**
@@ -126,7 +125,7 @@ export interface validateEnvOptions {
126
125
  /** The raw source of environment values, e.g. `process.env` or a resolved secrets bag. */
127
126
  values: RawEnv;
128
127
  /**
129
- * Every contract to validate -- typically the `contracts` array imported
128
+ * Every contract to validate: typically the `contracts` array imported
130
129
  * from a generated manifest (see {@link build.generateEnvManifest}). Pass all of them
131
130
  * in one call: {@link validateEnv} only ever initializes once per process, so
132
131
  * a second call returns the first call's cached result without
@@ -135,18 +134,18 @@ export interface validateEnvOptions {
135
134
  manifest: readonly EnvContract<any>[];
136
135
  /**
137
136
  * The validation contexts active for this run (e.g. `["server",
138
- * "production"]`) -- entirely application-defined; env-cap never
137
+ * "production"]`): entirely application-defined; env-cap never
139
138
  * detects or infers these, the caller always computes and passes them
140
139
  * explicitly. A variable whose `context` isn't in this list is skipped
141
140
  * entirely (no default/processor/validator runs for it, and it stays in
142
141
  * its not-ready state, exactly as if this run had never happened for
143
- * it) -- see ADR 0022. A variable with no `context` always participates,
142
+ * it): see ADR 0022. A variable with no `context` always participates,
144
143
  * regardless of what's passed here. Omitted (the default) behaves as an
145
144
  * empty list: only variables with no `context` participate.
146
145
  *
147
146
  * @remarks
148
- * Not part of the validation cache's identity -- {@link validateEnv}
149
- * remains one-shot per process exactly as before this option existed. A
147
+ * Not part of the validation cache's identity: {@link validateEnv}
148
+ * remains one-shot per process whatever this option holds. A
150
149
  * second call does not re-evaluate `activeContexts`; it returns the
151
150
  * first call's result outright. Different active contexts belong to
152
151
  * different processes (e.g. a server process and a browser bundle),
@@ -173,7 +172,7 @@ export interface CreateEnvOptions {
173
172
  /**
174
173
  * A short, stable label for this contract (e.g. "payments", "database").
175
174
  * Used in error messages. Defaults to an auto-generated anonymous label if
176
- * omitted -- providing one is strongly recommended for readable validation
175
+ * omitted: providing one is strongly recommended for readable validation
177
176
  * errors.
178
177
  */
179
178
  name?: string;
@@ -181,7 +180,7 @@ export interface CreateEnvOptions {
181
180
  * Pass `import.meta.url` here so validation errors point at the file that
182
181
  * declared the failing variable (e.g. "features/payments/env.schema.ts")
183
182
  * instead of just the short `name` label. There is no portable way for
184
- * `createEnv` to discover its caller's module URL on its own -- this is
183
+ * `createEnv` to discover its caller's module URL on its own: this is
185
184
  * always correct and never goes stale, since it's supplied by the JS
186
185
  * engine rather than hand-typed.
187
186
  */
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/runtime/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,sGAAsG;AACtG,MAAM,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAEtD,uGAAuG;AACvG,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,CAAA;AAEhD;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,CAAA;AAEtE;;;;;;;;GAQG;AAEH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAA;AAEpD,gHAAgH;AAChH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,6EAA6E;IAC7E,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,6FAA6F;IAC7F,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IACxB,sEAAsE;IACtE,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IACxB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;GASG;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAA;AAE1D,KAAK,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,OAAO,EAAE,MAAM,GAAG,CAAA;CAAE,GACpD,GAAG,SAAS,MAAM,MAAM,CAAC,GACvB,CAAC,GACD,GAAG,GACL,KAAK,CAAA;AAET;;;;;;;GAOG;AAEH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS;IAClE,kEAAkE;IAClE,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;CAC9B,GACG,CAAC,GACD,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAChC,MAAM,GACN,aAAa,CAAC,CAAC,CAAC,CAAA;AAEtB,0GAA0G;AAC1G,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS;IAChE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;CACnB;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,SAAS,IAAI;IAC7C,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC7C,GAAG;IACF,wGAAwG;IACxG,QAAQ,IAAI,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,0FAA0F;IAC1F,MAAM,EAAE,MAAM,CAAA;IACd;;;;;;OAMG;IAEH,QAAQ,EAAE,SAAS,WAAW,CAAC,GAAG,CAAC,EAAE,CAAA;IACrC;;;;;;;;;;;;;;;;;;OAkBG;IACH,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACnC;AAED,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/runtime/types.ts"],"names":[],"mappings":"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"}
@@ -5,7 +5,7 @@ import type { validateEnvOptions, validateEnvResult } from "./types.js";
5
5
  *
6
6
  * @remarks
7
7
  * Idempotent: the first successful (or failed) call is authoritative for the life of the
8
- * process -- later calls return (or re-throw) that same outcome without re-running any
8
+ * process; later calls return (or re-throw) that same outcome without re-running any
9
9
  * processor or validator. Concurrent in-flight calls share one underlying run. Call
10
10
  * `resetEnvCache()` to validate again, for example between test scenarios.
11
11
  *
@@ -1,7 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  readToolVersion
4
- } from "./chunk-HAGMVMN5.js";
4
+ } from "./chunk-TBL3O7IG.js";
5
5
 
6
6
  // src/build/evidence-snapshot.ts
7
7
  import path3 from "path";
@@ -393,7 +393,7 @@ async function discoverSchemaFiles(options) {
393
393
  const included = await discoverFiles(options);
394
394
  if (included.length > MAX_DISCOVERED_SCHEMA_FILES) {
395
395
  throw new Error(
396
- `discoverSchemaFiles: found ${String(included.length)} files matching "include" under ${options.root} -- more than the ${String(MAX_DISCOVERED_SCHEMA_FILES)}-file sanity limit. This almost always means "root" (or "include"/"exclude") resolved more broadly than intended -- e.g. an omitted "root" falling back to an unexpectedly large process.cwd() -- rather than a real project genuinely declaring this many contracts. Narrow "root"/"include"/"exclude" to the intended project boundary.`
396
+ `discoverSchemaFiles: found ${String(included.length)} files matching "include" under ${options.root}, more than the ${String(MAX_DISCOVERED_SCHEMA_FILES)}-file sanity limit. This usually means "root" (or "include"/"exclude") resolved more broadly than intended, for example an omitted "root" falling back to a large process.cwd(). Narrow "root"/"include"/"exclude" to the intended project boundary.`
397
397
  );
398
398
  }
399
399
  return included;
@@ -672,7 +672,7 @@ function extractSchemaVariable(key, definition, filePath, contextLabel, warnings
672
672
  } else {
673
673
  warnings.push({
674
674
  file: filePath,
675
- message: evaluated.ok && evaluated.value === "" ? `"context" for "${key}" in "${contextLabel}" is an empty string; ignoring it -- validation contexts must be non-empty.` : `"context" for "${key}" in "${contextLabel}" is not a statically-resolvable string literal; ignoring it.`
675
+ message: evaluated.ok && evaluated.value === "" ? `"context" for "${key}" in "${contextLabel}" is an empty string; ignoring it. Validation contexts must be non-empty.` : `"context" for "${key}" in "${contextLabel}" is not a statically-resolvable string literal; ignoring it.`
676
676
  });
677
677
  }
678
678
  }
@@ -1146,7 +1146,7 @@ function resolveWithinRoot(root, location, optionName, functionName) {
1146
1146
  severity: "error",
1147
1147
  variable: optionName,
1148
1148
  files: [location],
1149
- reason: `"${optionName}" ("${location}") resolves to "${resolved}", which is outside "root" ("${root}"). ${functionName}() refuses to write outside root -- use a path nested under root instead.`
1149
+ reason: `"${optionName}" ("${location}") resolves to "${resolved}", which is outside "root" ("${root}"). ${functionName}() refuses to write outside root. Use a path nested under root instead.`
1150
1150
  }
1151
1151
  };
1152
1152
  }
@@ -1195,7 +1195,7 @@ async function resolveUncached(packageName, root, fs) {
1195
1195
  return {
1196
1196
  ok: false,
1197
1197
  code: "PACKAGE_NOT_FOUND",
1198
- reason: `Package "${packageName}" listed in "packages" could not be resolved from "${root}" -- is it installed?`
1198
+ reason: `Package "${packageName}" listed in "packages" could not be resolved from "${root}". Is it installed?`
1199
1199
  };
1200
1200
  }
1201
1201
  const { packageJsonPath, packageDir } = located;
@@ -1793,7 +1793,7 @@ function buildChangeModel(manifest, currentContracts, root) {
1793
1793
  file: addedRef.file,
1794
1794
  exportName: addedRef.exportName,
1795
1795
  // Resolved from the contract this rename was declared on, not carried
1796
- // on the ref -- see `ContractRef` (`evidence-reference.ts`).
1796
+ // on the ref: see `ContractRef` (`evidence-reference.ts`).
1797
1797
  contractName: contract.contractName,
1798
1798
  previousKey: removedRef.key,
1799
1799
  currentKey: addedRef.key
@@ -1853,7 +1853,7 @@ function detectCompatibilityIssues(contracts) {
1853
1853
  variable: key,
1854
1854
  files: [a.file, b.file],
1855
1855
  code: "PROCESSOR_SOURCE_CONFLICT",
1856
- reason: `"${a.contractName}" and "${b.contractName}" both declare a processor for this variable with different implementations. Return types could not be statically verified -- add explicit return type annotations, or confirm they produce equivalent output.`
1856
+ reason: `"${a.contractName}" and "${b.contractName}" both declare a processor for this variable with different implementations. Return types could not be statically verified. Add explicit return type annotations, or confirm they produce equivalent output.`
1857
1857
  });
1858
1858
  }
1859
1859
  if (a.variable.hasValidator && b.variable.hasValidator && a.variable.validatorSource !== b.variable.validatorSource) {
@@ -1862,7 +1862,7 @@ function detectCompatibilityIssues(contracts) {
1862
1862
  variable: key,
1863
1863
  files: [a.file, b.file],
1864
1864
  code: "VALIDATOR_SOURCE_CONFLICT",
1865
- reason: `"${a.contractName}" and "${b.contractName}" both declare a validator for this variable with different implementations. Validator logic cannot be statically compared -- confirm they enforce compatible rules.`
1865
+ reason: `"${a.contractName}" and "${b.contractName}" both declare a validator for this variable with different implementations. Validator logic cannot be statically compared. Confirm they enforce compatible rules.`
1866
1866
  });
1867
1867
  }
1868
1868
  const divergences = documentationDivergences(a.variable, b.variable);
@@ -1923,7 +1923,7 @@ function detectDuplicateVariableShapes(contracts) {
1923
1923
  variable: `${a.key} / ${b.key}`,
1924
1924
  files: [a.file, b.file],
1925
1925
  code: "DUPLICATE_VARIABLE_SHAPE_ACROSS_CONTRACTS",
1926
- reason: `"${a.key}" (${a.contractName}) and "${b.key}" (${b.contractName}) declare an identical shape (type ${a.shape.valueType}, processor: ${a.shape.hasProcessor ? "yes" : "no"}, validator: ${a.shape.hasValidator ? "yes" : "no"}). Informational only -- they may be the same underlying value modelled twice, or two unrelated values that happen to look alike. Nothing is required.`
1926
+ reason: `"${a.key}" (${a.contractName}) and "${b.key}" (${b.contractName}) declare an identical shape (type ${a.shape.valueType}, processor: ${a.shape.hasProcessor ? "yes" : "no"}, validator: ${a.shape.hasValidator ? "yes" : "no"}). Informational only: they may be the same underlying value modelled twice, or two unrelated values that happen to look alike. Nothing is required.`
1927
1927
  });
1928
1928
  }
1929
1929
  }
@@ -2147,11 +2147,9 @@ function scanFileForDependencies(filePath, sourceText) {
2147
2147
  filePath,
2148
2148
  sourceText,
2149
2149
  ts.ScriptTarget.Latest,
2150
- // Load-bearing, unlike before: `ts.getCombinedNodeFlags()` (used to tell
2151
- // a `const` declaration apart from `let`/`var` when resolving alias
2152
- // candidates) walks parent pointers internally. Flipping this to `false`
2153
- // now breaks const-detection silently rather than merely being an
2154
- // unobserved no-op -- do not remove parent-pointer tracking here.
2150
+ // Load-bearing: `ts.getCombinedNodeFlags()` walks parent pointers. It
2151
+ // tells a `const` declaration from `let`/`var` when resolving alias
2152
+ // candidates. Setting this to `false` breaks const-detection silently.
2155
2153
  true,
2156
2154
  scriptKind
2157
2155
  );
@@ -2264,8 +2262,8 @@ function createGeneratedBanner(describe) {
2264
2262
  return { ts: `// ${text}`, markdown: `<!-- ${text} -->` }[format];
2265
2263
  },
2266
2264
  // Not a bare `startsWith`: a shebang, a `"use strict"` pragma or a license header pushes a real marker
2267
- // off line one, and a stricter check would read a genuinely generated file as hand-written, which a
2268
- // dependency scan would take as "a real consumer imports this" and so permanently mask an abandoned
2265
+ // off line one. A stricter check would read a genuinely generated file as hand-written. A dependency
2266
+ // scan would take that as "a real consumer imports this", and so permanently mask an abandoned
2269
2267
  // contract. The first 20 non-empty lines clear every realistic preamble without scanning a whole file.
2270
2268
  // A line counts only when the marker opens a comment, as `generatedBanner` writes it, so code or prose that
2271
2269
  // merely quotes the marker is not mistaken for a generated file.
@@ -2473,7 +2471,7 @@ function deriveOwnershipFindings(graph) {
2473
2471
  if (contract.ambiguousBarrelFiles.length > 0) {
2474
2472
  unresolvedConsumers.push({
2475
2473
  ...identity,
2476
- reason: `Not directly imported anywhere, but ${contract.ambiguousBarrelFiles.length} file(s) import "${contract.exportName}" through a specifier that resolves to a file containing an unresolved "export * from" re-export -- cannot determine whether this contract is forwarded by it. Files: ${contract.ambiguousBarrelFiles.join(", ")}.`
2474
+ reason: `Not directly imported anywhere, but ${contract.ambiguousBarrelFiles.length} file(s) import "${contract.exportName}" through a specifier that resolves to a file containing an unresolved "export * from" re-export, so whether this contract is forwarded by it cannot be determined. Files: ${contract.ambiguousBarrelFiles.join(", ")}.`
2477
2475
  });
2478
2476
  } else {
2479
2477
  abandoned.push(identity);
@@ -2495,7 +2493,7 @@ function deriveOwnershipFindings(graph) {
2495
2493
  if (info.status === "unconsumed") {
2496
2494
  unconsumedOwned.push({ ...identity, key });
2497
2495
  } else if (info.status === "indeterminate") {
2498
- const reason = info.evidence === "dynamic-access" ? `Dynamic (computed) property access was observed on "${contract.exportName}" -- cannot determine whether "${key}" is read. Searched: ${surfaces}. Dynamic access observed at: ${formatSites(contract.dynamicAccessSites)}.` : `Contract "${contract.exportName}" is used in a way this scanner's local dataflow analysis cannot follow (a rest binding, nested destructuring, a computed key, an ambiguous alias, or the contract passed/referenced directly) -- cannot determine whether "${key}" is read. Searched: ${surfaces}. Escaped at: ${formatEscapeSites(contract.escapeSites)}.`;
2496
+ const reason = info.evidence === "dynamic-access" ? `Dynamic (computed) property access was observed on "${contract.exportName}", so whether "${key}" is read cannot be determined. Searched: ${surfaces}. Dynamic access observed at: ${formatSites(contract.dynamicAccessSites)}.` : `Contract "${contract.exportName}" is used in a way this scanner's local dataflow analysis cannot follow (a rest binding, nested destructuring, a computed key, an ambiguous alias, or the contract passed/referenced directly), so whether "${key}" is read cannot be determined. Searched: ${surfaces}. Escaped at: ${formatEscapeSites(contract.escapeSites)}.`;
2499
2497
  indeterminate.push({
2500
2498
  ...identity,
2501
2499
  key,
@@ -2672,7 +2670,7 @@ function detectExclusiveGroupIssues(contracts) {
2672
2670
  severity: "error",
2673
2671
  variable: `Exclusive group "${group}"`,
2674
2672
  files: [a.file, b.file],
2675
- reason: `"${a.contractName}" and "${b.contractName}" are both active and both declare exclusiveGroup "${group}" -- only one active contract per exclusive group is allowed. Set active: false on whichever one isn't in use.`
2673
+ reason: `"${a.contractName}" and "${b.contractName}" are both active and both declare exclusiveGroup "${group}". Only one active contract per exclusive group is allowed. Set active: false on whichever one isn't in use.`
2676
2674
  });
2677
2675
  }
2678
2676
  }
@@ -2748,11 +2746,11 @@ function defaultExclude() {
2748
2746
  return [
2749
2747
  // `discoverSchemaFiles()`'s own walk (`discover.ts`) hardcodes skipping
2750
2748
  // a directory literally named "node_modules" or ".git" via its own
2751
- // `isAlwaysSkippedDirName()` check, regardless of `exclude` -- it never
2749
+ // `isAlwaysSkippedDirName()` check, regardless of `exclude`: it never
2752
2750
  // even descends into either to test a glob pattern against it. These
2753
2751
  // two entries are provably redundant (kept for readers/tooling that
2754
2752
  // inspect `exclude` directly, and as defense if that hardcoding ever
2755
- // changes) -- hand-verified: emptying both and running the full
2753
+ // changes). Hand-verified: emptying both and running the full
2756
2754
  // `vitest run` leaves all 1243 tests passing.
2757
2755
  "**/node_modules/**",
2758
2756
  "**/dist/**",
@@ -2843,7 +2841,7 @@ function renderAbandoned(findings) {
2843
2841
  const lines = [
2844
2842
  "## Abandoned ownership",
2845
2843
  "",
2846
- "Contracts never imported anywhere in the scanned repository -- a feature's schema outliving the feature.",
2844
+ "Contracts never imported anywhere in the scanned repository: a feature's schema outliving the feature.",
2847
2845
  "",
2848
2846
  "| Contract | Owner | File |",
2849
2847
  "|---|---|---|"
@@ -2858,7 +2856,7 @@ function renderUnresolvedConsumers(findings) {
2858
2856
  const lines = [
2859
2857
  "## Unresolved consumers (barrel re-exports)",
2860
2858
  "",
2861
- "Contracts reachable only through an unresolved `export * from` barrel re-export -- cannot be proven abandoned or consumed. Advisory only; never fails a build.",
2859
+ "Contracts reachable only through an unresolved `export * from` barrel re-export. They cannot be proven abandoned or consumed. Advisory only; never fails a build.",
2862
2860
  ""
2863
2861
  ];
2864
2862
  for (const f of sortedByContractName(findings))
@@ -2880,7 +2878,7 @@ function renderUnconsumedOwned(findings, scannedSurfaces) {
2880
2878
  "",
2881
2879
  `Searched: ${surfaces}.`,
2882
2880
  "",
2883
- 'A blank Stale/missing citations cell is the strongest "looks genuinely unused" signal -- no developer has ever claimed otherwise. A non-blank cell means someone specifically claimed dynamic access here via `dynamicAccess`, and that claim can no longer be verified (ADR 0037) -- check with them before deleting.',
2881
+ 'A blank Stale/missing citations cell is the strongest "looks unused" signal: no developer has ever claimed otherwise. A non-blank cell means someone specifically claimed dynamic access here via `dynamicAccess`, and that claim can no longer be verified (ADR 0037). Check with them before deleting.',
2884
2882
  "",
2885
2883
  "| Variable | Contract | Owner | Stale/missing citations |",
2886
2884
  "|---|---|---|---|"
@@ -2897,7 +2895,7 @@ function renderIndeterminate(findings) {
2897
2895
  const lines = [
2898
2896
  "## Indeterminate (dynamic access)",
2899
2897
  "",
2900
- "Dynamic (computed) property access was observed -- usage cannot be determined statically. Never guessed at.",
2898
+ "Dynamic (computed) property access was observed, so usage cannot be determined statically. Never guessed at.",
2901
2899
  "",
2902
2900
  "| Variable | Contract | Reason | Stale/missing citations |",
2903
2901
  "|---|---|---|---|"
@@ -2918,7 +2916,7 @@ function renderAsserted(findings) {
2918
2916
  const lines = [
2919
2917
  "## Asserted (developer-acknowledged dynamic access)",
2920
2918
  "",
2921
- "Variables env-cap's own scan would otherwise flag as unconsumed or indeterminate, but a developer has cited exactly where the dynamic access happens via `dynamicAccess`. The raw static status is shown alongside the citation, never hidden behind it -- a citation is a re-acknowledgment, not proof.",
2919
+ "Variables env-cap's own scan would otherwise flag as unconsumed or indeterminate, but a developer has cited exactly where the dynamic access happens via `dynamicAccess`. The raw static status is shown alongside the citation, never hidden behind it. A citation is a re-acknowledgment, not proof.",
2922
2920
  "",
2923
2921
  "| Variable | Contract | Static status | Developer assertion |",
2924
2922
  "|---|---|---|---|"
@@ -3255,7 +3253,7 @@ function buildFindingModel(input) {
3255
3253
  severity: "info",
3256
3254
  code: "NONSTANDARD_SENSITIVITY_LEVEL",
3257
3255
  family: "documentation",
3258
- message: `"${n.key ?? n.exportName}" declares sensitivity "${n.sensitivity}", which isn't one of the standard levels (secret/credential/pii/config) -- still honored verbatim, just flagged for vocabulary drift.`,
3256
+ message: `"${n.key ?? n.exportName}" declares sensitivity "${n.sensitivity}", which isn't one of the standard levels (secret/credential/pii/config). It is still honored verbatim, only flagged for vocabulary drift.`,
3259
3257
  location: {
3260
3258
  model: "contract",
3261
3259
  file: displayPath(root, n.file),
@@ -3339,7 +3337,7 @@ function buildFindingModel(input) {
3339
3337
  contractName: i.contractName,
3340
3338
  file: void 0,
3341
3339
  variable: i.key,
3342
- // Multiple candidate sites, never one representative pointer -- see
3340
+ // Multiple candidate sites, never one representative pointer: see
3343
3341
  // `IndeterminateOwnershipFinding.dynamicAccessSites` for the full list.
3344
3342
  position: NO_POSITION
3345
3343
  }
@@ -3356,12 +3354,12 @@ function buildFindingModel(input) {
3356
3354
  model: "ownership",
3357
3355
  contractName: p.contractName,
3358
3356
  // p.file (DynamicAccessCitationProblem.file) is already
3359
- // root-relative -- unlike every other .file above, not a raw
3360
- // absolute path -- so no displayPath() conversion here.
3357
+ // root-relative (unlike every other .file above, not a raw
3358
+ // absolute path) so no displayPath() conversion here.
3361
3359
  file: p.file,
3362
3360
  variable: p.key,
3363
3361
  // The one ownership-family finding with a genuinely meaningful
3364
- // position -- exactly where the (now-stale/missing) citation points.
3362
+ // position: exactly where the (now-stale/missing) citation points.
3365
3363
  position: p.position
3366
3364
  }
3367
3365
  });
@@ -3401,7 +3399,7 @@ function defineEvidenceProjection(schema) {
3401
3399
  }
3402
3400
  function readOnlyMembraneError() {
3403
3401
  return new TypeError(
3404
- "EvidenceModel is read-only inside a projector -- a projection must be a pure function of its evidence argument. See ADR 0032."
3402
+ "EvidenceModel is read-only inside a projector. A projection must be a pure function of its evidence argument. See ADR 0032."
3405
3403
  );
3406
3404
  }
3407
3405
  function createTrackingProxy(evidence) {
@@ -4137,7 +4135,7 @@ function renderEnvExample(contracts, reconciliationHeader = []) {
4137
4135
  lines.push(
4138
4136
  ...renderVariableLines(dup.variable, {
4139
4137
  commented: true,
4140
- note: `Also declared by "${dup.contract.contractName}" -- see "${first.contract.contractName}" above.`
4138
+ note: `Also declared by "${dup.contract.contractName}". See "${first.contract.contractName}" above.`
4141
4139
  })
4142
4140
  );
4143
4141
  }
@@ -4149,7 +4147,7 @@ function renderEnvExample(contracts, reconciliationHeader = []) {
4149
4147
  lines.push(
4150
4148
  ...renderVariableLines(first.variable, {
4151
4149
  commented: true,
4152
- note: `Disabled -- feature "${first.contract.contractName}" is not active.`
4150
+ note: `Disabled: feature "${first.contract.contractName}" is not active.`
4153
4151
  })
4154
4152
  );
4155
4153
  }
@@ -5063,7 +5061,7 @@ async function checkEnvArtifacts(options) {
5063
5061
  path: c.docs.envExamplePath,
5064
5062
  status: driftCount > 0 ? "stale" : "ok",
5065
5063
  // exactOptionalPropertyTypes: omit the key entirely rather than
5066
- // set it to `undefined` -- `detail` is absent when there's
5064
+ // set it to `undefined`; `detail` is absent when there's
5067
5065
  // nothing to report, not present-but-empty.
5068
5066
  ...driftCount > 0 ? {
5069
5067
  detail: `${staleVariables.length} stale, ${variablesToComment.length} to comment, ${variablesToAdd.length} to add`
@@ -5130,9 +5128,9 @@ function buildSarifLog(findingModel) {
5130
5128
  rules: ruleIds.map((id) => ({ id }))
5131
5129
  }
5132
5130
  },
5133
- // exactOptionalPropertyTypes: spread `locations` in only when
5134
- // sarifLocations() actually has one, rather than ever setting the
5135
- // key to `undefined` explicitly.
5131
+ // Under `exactOptionalPropertyTypes` the key must be absent, never
5132
+ // `undefined`. So `locations` is spread in only when
5133
+ // `sarifLocations()` has one.
5136
5134
  results: findingModel.findings.map((finding) => {
5137
5135
  const locations = sarifLocations(finding);
5138
5136
  return {
@@ -5208,4 +5206,4 @@ export {
5208
5206
  resolveRelativeImport,
5209
5207
  writeEnvExample
5210
5208
  };
5211
- //# sourceMappingURL=build-DNAYWD2B.js.map
5209
+ //# sourceMappingURL=build-UEENZEUX.js.map