@maverickcer/env-cap 0.7.5 → 0.7.7

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 (279) hide show
  1. package/ADOPTION.md +12 -12
  2. package/AGENTS.md +85 -120
  3. package/CHANGELOG.md +36 -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-33O5SDTC.js} +37 -39
  245. package/dist/build-33O5SDTC.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-4D67AQFY.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 +20 -13
  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/decisions/0049-typescript-7-scanner-uses-a-bundled-typescript-6.md +9 -0
  273. package/specs/generated-artifacts.md +78 -70
  274. package/specs/migrations/README.md +6 -6
  275. package/specs/migrations/from-centralized-schema.md +1 -1
  276. package/specs/migrations/from-t3-env.md +9 -9
  277. package/PROMPT.md +0 -89
  278. package/dist/build-DNAYWD2B.js.map +0 -1
  279. /package/dist/{chunk-HAGMVMN5.js.map → chunk-4D67AQFY.js.map} +0 -0
@@ -1,47 +1,48 @@
1
1
  import type { DiscoveredContract } from "./link.js";
2
2
  /**
3
3
  * Supplies expiration metadata from a live source (a secrets manager, an
4
- * internal inventory API, ...) as a post-discovery override -- the one
4
+ * internal inventory API, ...) as a post-discovery override: the one
5
5
  * sanctioned escape hatch from static-only `expiresAt`.
6
6
  *
7
7
  * @remarks
8
8
  * Invoked exactly once per generation run, from the orchestration layer, after AST discovery/
9
9
  * linking completes and before documentation is rendered. Never invoked
10
- * during AST parsing or runtime validation -- see ADR 0012 for why a
10
+ * during AST parsing or runtime validation: see ADR 0012 for why a
11
11
  * function embedded in a schema file itself was rejected instead.
12
12
  */
13
13
  export type LiveExpirationDates = (variableNames: readonly string[]) => Promise<Readonly<Record<string, string>>>;
14
14
  /**
15
15
  * Every unique variable key across every linked contract's `variables`.
16
- * Contract-level `expiresAt` is out of scope for override -- the callback is
16
+ * Contract-level `expiresAt` is out of scope for override: the callback is
17
17
  * keyed by variable name, not contract name.
18
18
  */
19
19
  export declare function collectVariableNames(contracts: readonly DiscoveredContract[]): string[];
20
20
  /**
21
- * Applies `overrides` onto a fresh copy of `contracts` -- every contract and
21
+ * Applies `overrides` onto a fresh copy of `contracts`. Every contract and
22
22
  * every variable (and their nested `metadata`/`extra` records) is rebuilt
23
- * into a new object, never the original reference, so the returned structure
24
- * shares no mutable object identity with `contracts` at any depth.
23
+ * into a new object, never the original reference. The returned structure
24
+ * therefore shares no mutable object identity with `contracts` at any depth.
25
25
  *
26
26
  * @remarks
27
27
  * A key absent from `overrides`, or present but not a `parseIsoDate`-parseable
28
- * ISO-8601 string, leaves that variable's static `expiresAt` untouched --
28
+ * ISO-8601 string, leaves that variable's static `expiresAt` untouched:
29
29
  * same "warn/skip, never guess" policy the rest of the generator uses for
30
30
  * malformed data. Contract-level `expiresAt` is never touched; only
31
31
  * variable-level `expiresAt` is in scope for override.
32
32
  */
33
33
  export declare function applyLiveExpirationOverrides(contracts: readonly DiscoveredContract[], overrides: Readonly<Record<string, string>>): readonly DiscoveredContract[];
34
34
  /**
35
- * Orchestration entry point -- the only place `liveExpirationDates` is ever invoked.
35
+ * Orchestration entry point: the only place `liveExpirationDates` is ever invoked.
36
36
  *
37
37
  * @remarks
38
38
  * No-ops (returns the exact same array reference, zero invocations)
39
39
  * when `liveExpirationDates` is undefined, which is what guarantees "omitted ->
40
- * behavior unchanged." Otherwise collects the unique discovered variable
41
- * names, invokes the callback exactly once, applies the result, and
42
- * deep-freezes the returned structure so it can never be mutated into
43
- * affecting `contracts` (used elsewhere, e.g. by the manifest/usage passes in
44
- * the same {@link generateEnvArtifacts} run) or anything else downstream.
40
+ * behavior unchanged." Otherwise it collects the unique discovered variable
41
+ * names, invokes the callback exactly once and applies the result. It
42
+ * deep-freezes the returned structure so no mutation of it can reach
43
+ * `contracts` or anything else downstream. `contracts` is used elsewhere too,
44
+ * e.g. by the manifest and usage passes in the same
45
+ * {@link generateEnvArtifacts} run.
45
46
  */
46
47
  export declare function resolveLiveExpirationDates(contracts: readonly DiscoveredContract[], liveExpirationDates: LiveExpirationDates | undefined): Promise<readonly DiscoveredContract[]>;
47
48
  //# sourceMappingURL=live-expirations.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"live-expirations.d.ts","sourceRoot":"","sources":["../../../src/build/live-expirations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAsB,MAAM,WAAW,CAAA;AAEvE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,aAAa,EAAE,SAAS,MAAM,EAAE,KAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;AAE9C;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,GAAG,MAAM,EAAE,CAMvF;AAiBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,SAAS,kBAAkB,EAAE,EACxC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC1C,SAAS,kBAAkB,EAAE,CAM/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,0BAA0B,CAC9C,SAAS,EAAE,SAAS,kBAAkB,EAAE,EACxC,mBAAmB,EAAE,mBAAmB,GAAG,SAAS,GACnD,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAIxC"}
1
+ {"version":3,"file":"live-expirations.d.ts","sourceRoot":"","sources":["../../../src/build/live-expirations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAsB,MAAM,WAAW,CAAA;AAEvE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,aAAa,EAAE,SAAS,MAAM,EAAE,KAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;AAE9C;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,GAAG,MAAM,EAAE,CAMvF;AAiBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,SAAS,kBAAkB,EAAE,EACxC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC1C,SAAS,kBAAkB,EAAE,CAM/B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,0BAA0B,CAC9C,SAAS,EAAE,SAAS,kBAAkB,EAAE,EACxC,mBAAmB,EAAE,mBAAmB,GAAG,SAAS,GACnD,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAIxC"}
@@ -2,7 +2,7 @@ import type { DiscoveredContract } from "./link.js";
2
2
  /**
3
3
  * Every validation context declared by any variable in an *active* contract
4
4
  * in `contracts` (a variable belonging to a contract documented `active:
5
- * false` never contributes -- same exclusion the `manifest` array itself
5
+ * false` never contributes: same exclusion the `manifest` array itself
6
6
  * already applies), sorted and deduplicated. What {@link renderManifest}
7
7
  * surfaces as the generated `activeContexts` export. Exported for reuse by
8
8
  * anything that needs the same computation (currently just `renderManifest`
@@ -12,17 +12,17 @@ export declare function discoverValidationContexts(contracts: readonly Discovere
12
12
  /**
13
13
  * Renders the deterministic manifest source: sorted imports (aliased on name
14
14
  * collision) plus a `contracts` array, in the exact banner format schema
15
- * authors will recognize as generated. No timestamps, no randomness -- same
15
+ * authors will recognize as generated. No timestamps, no randomness: same
16
16
  * input files always produce byte-identical output.
17
17
  *
18
18
  * @remarks
19
19
  * When at least one discovered variable declares a `context` (ADR 0022),
20
- * this also emits `activeContexts` -- every validation context found across
21
- * `contracts`, as a plain array named to match {@link runtime.validateEnvOptions}'s
22
- * own `activeContexts` field -- so application code can import it alongside
20
+ * this also emits `activeContexts`: every validation context found across
21
+ * `contracts`, as a plain array. Its name matches {@link runtime.validateEnvOptions}'s
22
+ * own `activeContexts` field, so application code can import it alongside
23
23
  * `manifest` and pass it straight through: `validateEnv({ manifest, values, activeContexts })`.
24
24
  * It's every context this manifest has, meant as a starting point to narrow
25
- * per process/deployment, not a pre-scoped default -- see the README's
25
+ * per process/deployment, not a pre-scoped default: see the README's
26
26
  * "Validation contexts" section. Omitted entirely (not even an empty array)
27
27
  * when no variable declares a `context` at all, so generated output for
28
28
  * projects that don't use this feature is untouched.
@@ -1,8 +1,8 @@
1
1
  /**
2
- * `map.get(key)` after iterating `map`'s own `.keys()` is always defined --
3
- * this makes that invariant an explicit, named operation instead of a bare
4
- * `!` non-null assertion at each call site, with a real error (not a
5
- * silent `undefined`) if it's ever violated by a future bug.
2
+ * `map.get(key)` after iterating `map`'s own `.keys()` is always defined.
3
+ * This makes that invariant an explicit, named operation instead of a bare
4
+ * `!` non-null assertion at each call site. A future bug that violates it
5
+ * gets a real error, not a silent `undefined`.
6
6
  */
7
7
  export declare function mustGet<K, V>(map: ReadonlyMap<K, V>, key: K): V;
8
8
  //# sourceMappingURL=map-utils.d.ts.map
@@ -1,26 +1,27 @@
1
1
  import type { DiscoveredContract, DiscoveredVariable } from "./link.js";
2
2
  /**
3
3
  * Every documentation field of a variable that a second declaration of it can supply. `metadata` is merged key by
4
- * key rather than as one value, so it is handled on its own below. `evidence` is not one of them: its citations
5
- * point at the declaring contract's own code and are re-verified there every run (ADR 0037), so they stay with the
6
- * contract that wrote them and are never copied to, or compared with, another declaration.
4
+ * key rather than as one value, so it is handled on its own below. `evidence` is not one of them. Its citations
5
+ * point at the declaring contract's own code and are re-verified there every run (ADR 0037). So they stay with the
6
+ * contract that wrote them, and are never copied to, or compared with, another declaration.
7
7
  */
8
8
  export declare const VALUE_FIELDS: readonly ["description", "owner", "sensitivity", "expiresAt", "refreshInstructions", "authenticatorType", "rotationPeriod", "lastRotatedAt", "rotationTriggerEvents", "setupInstructions", "required", "deprecated", "deprecatedReason", "removeBy", "renamedFrom", "purpose", "legalBasis", "retention", "dataResidency", "auditRequired"];
9
9
  /**
10
10
  * Fills what one declaration of a variable leaves unset from the other declarations of the same variable.
11
11
  *
12
12
  * @remarks
13
- * A variable can be declared in more than one contract: a package that ships its own contract (see
13
+ * A variable can be declared in more than one contract. A package that ships its own contract (see
14
14
  * {@link ../README} "Reusable packages") and the application that consumes it both name the same environment
15
15
  * variable, because the process has one flat namespace. Writing the explanation twice is how the two drift, so the
16
16
  * declaration that carries it can be the one place it is written, and the other adds only what is its own (the
17
17
  * application's own `expiresAt`, say).
18
18
  *
19
19
  * Every field a declaration leaves unset is taken from another declaration that sets it, as long as one of the two
20
- * is a package's contract; when several do, the one from a package's contract wins over the application's own, the
21
- * first package's over a later one's, and the application's own fill a gap only when all of them that set it agree. Two of the application's own contracts never fill each
22
- * other: they are siblings, often alternatives, and each documents the variable for itself. A field a declaration sets itself is never replaced, so two declarations that set the same field
23
- * differently still differ afterwards, and the compatibility check can say so. `metadata` is merged key by key under
20
+ * is a package's contract. When several set it, a package's contract wins over the application's own, and the
21
+ * first package's wins over a later one's. The application's own contracts fill a gap only when all of them that set
22
+ * it agree. Two of the application's own contracts never fill each other: they are siblings, often alternatives,
23
+ * and each documents the variable for itself. A field a declaration sets itself is never replaced. So two
24
+ * declarations that set the same field differently still differ afterwards, and the compatibility check can say so. `metadata` is merged key by key under
24
25
  * the same rule. Pure: the contracts passed in are not changed.
25
26
  */
26
27
  export declare function mergeSharedDocumentation(contracts: readonly DiscoveredContract[]): readonly DiscoveredContract[];
@@ -1 +1 @@
1
- {"version":3,"file":"merge-documentation.d.ts","sourceRoot":"","sources":["../../../src/build/merge-documentation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAEvE;;;;;GAKG;AACH,eAAO,MAAM,YAAY,6UAqBiC,CAAA;AAQ1D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,kBAAkB,EAAE,GACvC,SAAS,kBAAkB,EAAE,CA6B/B;AA8DD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,kBAAkB,GAAG,WAAW,CAAC,MAAM,CAAC,CAE3E"}
1
+ {"version":3,"file":"merge-documentation.d.ts","sourceRoot":"","sources":["../../../src/build/merge-documentation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAEvE;;;;;GAKG;AACH,eAAO,MAAM,YAAY,6UAqBiC,CAAA;AAQ1D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,kBAAkB,EAAE,GACvC,SAAS,kBAAkB,EAAE,CA6B/B;AA8DD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,kBAAkB,GAAG,WAAW,CAAC,MAAM,CAAC,CAE3E"}
@@ -1,47 +1,46 @@
1
1
  import type { ContractRef } from "./evidence-reference.js";
2
2
  import type { DiscoveredContract } from "./link.js";
3
3
  /**
4
- * The third of env-cap's seven canonical fact models (ADR 0024) -- every
4
+ * The third of env-cap's seven canonical fact models (ADR 0024): every
5
5
  * contract and variable's effective owner, plus first-class
6
6
  * `unownedContracts`/`unownedVariables` arrays. See ADR 0028.
7
7
  *
8
8
  * @remarks
9
- * "Unowned" previously existed only as a count (`noOwnerCount`) inside
10
- * `docs.ts`'s `renderSecurityReview()` -- itemized here as real data for the
11
- * first time, computed via the same `effectiveOwner()` (variable overrides
12
- * contract) that ADR 0028 also fixed `usage-report.ts`'s ownership findings
13
- * to use, so this model can never disagree with either of them about who
14
- * owns a variable.
9
+ * `docs.ts`'s security review holds "unowned" only as a count
10
+ * (`noOwnerCount`); this model itemizes it as data. It uses the same
11
+ * `effectiveOwner()` rule (variable overrides contract) as `docs.ts` and
12
+ * `usage-report.ts`'s ownership findings (ADR 0028). So this model can never
13
+ * disagree with either of them about who owns a variable.
15
14
  */
16
- /** Bump only when a reader could misinterpret the new shape -- same discipline every other canonical model's `schemaVersion` follows. */
15
+ /** Bump only when a reader could misinterpret the new shape: same discipline every other canonical model's `schemaVersion` follows. */
17
16
  export declare const OWNERSHIP_MODEL_SCHEMA_VERSION = 1;
18
17
  /**
19
18
  * One variable's effective owner (its own, falling back to the contract's).
20
19
  *
21
- * @see {@link ContractModelVariable} -- this same declared variable's canonical starting point.
20
+ * @see {@link ContractModelVariable}: this same declared variable's canonical starting point.
22
21
  */
23
22
  export interface OwnershipModelVariable {
24
23
  readonly key: string;
25
- /** The variable's own `owner`, falling back to the contract's -- see `effectiveOwner()`. */
24
+ /** The variable's own `owner`, falling back to the contract's: see `effectiveOwner()`. */
26
25
  readonly owner: string | undefined;
27
26
  }
28
27
  /** One contract's own default owner plus every variable's effective owner. See {@link OwnershipModelVariable} for the per-variable shape. */
29
28
  export interface OwnershipModelContract {
30
- /** Root-relative, POSIX-separated -- matches `ContractModelContract.file`. */
29
+ /** Root-relative, POSIX-separated: matches `ContractModelContract.file`. */
31
30
  readonly file: string;
32
31
  readonly exportName: string;
33
32
  readonly contractName: string;
34
- /** The contract's own default owner -- not "effective" the way a variable's is, since there's no level above a contract to fall back to. */
33
+ /** The contract's own default owner: not "effective" the way a variable's is, since there's no level above a contract to fall back to. */
35
34
  readonly owner: string | undefined;
36
35
  readonly variables: readonly OwnershipModelVariable[];
37
36
  }
38
- /** One contract, referenced by identity only -- see {@link ContractRef} for why no `contractName` is carried here. Resolve one from `ContractModel` when a renderer needs display text. */
37
+ /** One contract, referenced by identity only: see {@link ContractRef} for why no `contractName` is carried here. Resolve one from `ContractModel` when a renderer needs display text. */
39
38
  export type OwnershipModelContractRef = ContractRef;
40
- /** One variable, referenced by its owning contract's identity plus its own key -- see {@link ContractRef}. */
39
+ /** One variable, referenced by its owning contract's identity plus its own key: see {@link ContractRef}. */
41
40
  export interface OwnershipModelVariableRef extends ContractRef {
42
41
  readonly key: string;
43
42
  }
44
- /** The versioned, JSON-serializable root of the Ownership Model -- see this module's own doc comment for the full picture. */
43
+ /** The versioned, JSON-serializable root of the Ownership Model: see this module's own doc comment for the full picture. */
45
44
  export interface OwnershipModel {
46
45
  readonly schemaVersion: typeof OWNERSHIP_MODEL_SCHEMA_VERSION;
47
46
  readonly contracts: readonly OwnershipModelContract[];
@@ -1 +1 @@
1
- {"version":3,"file":"ownership-model.d.ts","sourceRoot":"","sources":["../../../src/build/ownership-model.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAEnD;;;;;;;;;;;;GAYG;AAEH,yIAAyI;AACzI,eAAO,MAAM,8BAA8B,IAAI,CAAA;AAE/C;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,4FAA4F;IAC5F,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;CACnC;AAED,6IAA6I;AAC7I,MAAM,WAAW,sBAAsB;IACrC,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,4IAA4I;IAC5I,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,sBAAsB,EAAE,CAAA;CACtD;AAED,2LAA2L;AAC3L,MAAM,MAAM,yBAAyB,GAAG,WAAW,CAAA;AAEnD,8GAA8G;AAC9G,MAAM,WAAW,yBAA0B,SAAQ,WAAW;IAC5D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAED,8HAA8H;AAC9H,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,aAAa,EAAE,OAAO,8BAA8B,CAAA;IAC7D,QAAQ,CAAC,SAAS,EAAE,SAAS,sBAAsB,EAAE,CAAA;IACrD,iDAAiD;IACjD,QAAQ,CAAC,gBAAgB,EAAE,SAAS,yBAAyB,EAAE,CAAA;IAC/D,2GAA2G;IAC3G,QAAQ,CAAC,gBAAgB,EAAE,SAAS,yBAAyB,EAAE,CAAA;CAChE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,kBAAkB,EAAE,EACxC,IAAI,EAAE,MAAM,GACX,cAAc,CAmChB"}
1
+ {"version":3,"file":"ownership-model.d.ts","sourceRoot":"","sources":["../../../src/build/ownership-model.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAEnD;;;;;;;;;;;GAWG;AAEH,uIAAuI;AACvI,eAAO,MAAM,8BAA8B,IAAI,CAAA;AAE/C;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,0FAA0F;IAC1F,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;CACnC;AAED,6IAA6I;AAC7I,MAAM,WAAW,sBAAsB;IACrC,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,0IAA0I;IAC1I,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,sBAAsB,EAAE,CAAA;CACtD;AAED,yLAAyL;AACzL,MAAM,MAAM,yBAAyB,GAAG,WAAW,CAAA;AAEnD,4GAA4G;AAC5G,MAAM,WAAW,yBAA0B,SAAQ,WAAW;IAC5D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAED,4HAA4H;AAC5H,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,aAAa,EAAE,OAAO,8BAA8B,CAAA;IAC7D,QAAQ,CAAC,SAAS,EAAE,SAAS,sBAAsB,EAAE,CAAA;IACrD,iDAAiD;IACjD,QAAQ,CAAC,gBAAgB,EAAE,SAAS,yBAAyB,EAAE,CAAA;IAC/D,2GAA2G;IAC3G,QAAQ,CAAC,gBAAgB,EAAE,SAAS,yBAAyB,EAAE,CAAA;CAChE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,kBAAkB,EAAE,EACxC,IAAI,EAAE,MAAM,GACX,cAAc,CAmChB"}
@@ -1,7 +1,7 @@
1
1
  import type TS from "@typescript/typescript6";
2
2
  import type { EnvGovernanceFields } from "./governance-fields.js";
3
3
  import type { SourcePosition } from "./source-position.js";
4
- /** A recoverable issue found while statically parsing or linking one schema file -- never fatal, always surfaced to the caller as data. */
4
+ /** A recoverable issue found while statically parsing or linking one schema file: never fatal, always surfaced to the caller as data. */
5
5
  export interface ParseWarning {
6
6
  /** Absolute path of the file the warning applies to. */
7
7
  readonly file: string;
@@ -10,8 +10,8 @@ export interface ParseWarning {
10
10
  }
11
11
  /**
12
12
  * How a `createEnv`/`documentEnv` call's first argument resolves, before any
13
- * cross-file linking is attempted (that's `link.ts`'s job, not this file's --
14
- * this module only ever looks at one file's own AST).
13
+ * cross-file linking is attempted. Linking is `link.ts`'s job; this module
14
+ * only ever looks at one file's own AST.
15
15
  */
16
16
  export type SchemaRef = {
17
17
  /** Discriminant: the schema argument is an inline object literal. */
@@ -29,7 +29,7 @@ export type SchemaRef = {
29
29
  };
30
30
  /** One `createEnv(...)` call site, as found by {@link parseSchemaFile}, before cross-file linking. */
31
31
  interface RawCreateEnvCall {
32
- /** The binding name the call result is assigned to (must be exported to be usable -- see {@link parseSchemaFile}). */
32
+ /** The binding name the call result is assigned to (must be exported to be usable: see {@link parseSchemaFile}). */
33
33
  readonly exportName: string;
34
34
  /** How the first (schema) argument resolves within this file. */
35
35
  readonly schemaRef: SchemaRef;
@@ -51,7 +51,7 @@ interface RawDocumentEnvCall {
51
51
  export interface ImportBinding {
52
52
  /** The raw module specifier as written in the import (e.g. `"./payments.schema.js"`). */
53
53
  readonly specifier: string;
54
- /** The name as exported by the source module -- accounts for `import { real as local }`. */
54
+ /** The name as exported by the source module: accounts for `import { real as local }`. */
55
55
  readonly importedName: string;
56
56
  }
57
57
  /** The raw, single-file facts extracted by {@link parseSchemaFile}. */
@@ -74,13 +74,13 @@ export interface FileParseResult {
74
74
  readonly warnings: readonly ParseWarning[];
75
75
  }
76
76
  /**
77
- * Structurally parses one file's AST for everything the generator needs:
78
- * `createEnv(...)`/`documentEnv(...)` call sites, the local `const`
79
- * declarations and imports needed to resolve an identifier passed to either
80
- * of them.
77
+ * Structurally parses one file's AST for everything the generator needs. That
78
+ * is the `createEnv(...)`/`documentEnv(...)` call sites, plus the local
79
+ * `const` declarations and imports that resolve an identifier passed to
80
+ * either.
81
81
  *
82
82
  * @remarks
83
- * Never type-checks or executes the file -- see `link.ts` for how
83
+ * Never type-checks or executes the file: see `link.ts` for how
84
84
  * these raw facts get resolved into actual schema/docs data, including
85
85
  * across files.
86
86
  */
@@ -89,21 +89,20 @@ export declare function parseSchemaFile(filePath: string, sourceText: string): F
89
89
  * Collects named import bindings from one `import` statement into `imports`, keyed by local name.
90
90
  *
91
91
  * @remarks
92
- * Exported for reuse by `scan-dependencies.ts`, which needs the same
93
- * alias-aware named-import tracking this file already does for schema
94
- * linking, just applied to arbitrary application source instead of schema
95
- * files.
92
+ * Exported for reuse by `scan-dependencies.ts`. It needs the same
93
+ * alias-aware named-import tracking this file does for schema linking. It
94
+ * applies it to arbitrary application source instead of schema files.
96
95
  *
97
96
  * @param imports - Mutated in place; a binding re-collected under the same local name overwrites the previous entry.
98
97
  */
99
98
  export declare function collectImportBindings(statement: TS.ImportDeclaration, imports: Map<string, ImportBinding>): void;
100
- /** One schema entry's statically-discoverable shape -- presence facts, never evaluated/executed values. */
99
+ /** One schema entry's statically-discoverable shape: presence facts, never evaluated/executed values. */
101
100
  export interface DiscoveredSchemaVariable {
102
101
  /** The environment variable name (the schema's object key). */
103
102
  readonly key: string;
104
103
  /** Whether the entry declares a `default`. */
105
104
  readonly hasDefault: boolean;
106
- /** The default's statically-evaluated literal value, if `hasDefault` and it was a literal we could evaluate -- `{ ok: false }` when present but not statically resolvable, `undefined` when absent. */
105
+ /** The default's statically-evaluated literal value, if `hasDefault` and it was a literal we could evaluate: `{ ok: false }` when present but not statically resolvable, `undefined` when absent. */
107
106
  readonly defaultValue: {
108
107
  /** Always `true` in this branch. */
109
108
  ok: true;
@@ -117,7 +116,7 @@ export interface DiscoveredSchemaVariable {
117
116
  readonly hasProcessor: boolean;
118
117
  /** The processor function's source text, normalized to single-line, if `hasProcessor`. */
119
118
  readonly processorSource: string | undefined;
120
- /** Only present when the processor has an explicit `: T` return type annotation -- the one thing we treat as provable. */
119
+ /** Only present when the processor has an explicit `: T` return type annotation: the one thing we treat as provable. */
121
120
  readonly processorReturnType: string | undefined;
122
121
  /** Whether the entry declares a `validator`. */
123
122
  readonly hasValidator: boolean;
@@ -125,7 +124,7 @@ export interface DiscoveredSchemaVariable {
125
124
  readonly validatorSource: string | undefined;
126
125
  /** The variable's statically-resolved `context`, if set to a non-empty string literal (see ADR 0022). `undefined` when absent, non-literal, or empty. */
127
126
  readonly context: string | undefined;
128
- /** Where this variable's own schema property (e.g. `SESSION_SECRET: z.string()`) is declared -- distinct from the *contract's* `declaration`/`documentation` (`link.ts`); every variable has exactly one of these, always. See ADR 0036. */
127
+ /** Where this variable's own schema property (e.g. `SESSION_SECRET: z.string()`) is declared: distinct from the *contract's* `declaration`/`documentation` (`link.ts`); every variable has exactly one of these, always. See ADR 0036. */
129
128
  readonly declaration: SourcePosition;
130
129
  }
131
130
  /**
@@ -136,7 +135,7 @@ export interface DiscoveredSchemaVariable {
136
135
  * @param warnings - Mutated in place: one entry is pushed per skipped (non-static, invalid-key, or non-literal) property.
137
136
  */
138
137
  export declare function extractSchemaVariables(schemaLiteral: TS.ObjectLiteralExpression, filePath: string, contextLabel: string, warnings: ParseWarning[], sourceFile: TS.SourceFile): DiscoveredSchemaVariable[];
139
- /** One variable's statically-extracted `documentEnv()` documentation, as declared in that call's `variables` entry for this key -- governance fields (`owner` .. `metadata`) are `EnvGovernanceFields`, resolved from static literals. */
138
+ /** One variable's statically-extracted `documentEnv()` documentation, as declared in that call's `variables` entry for this key: governance fields (`owner` .. `metadata`) are `EnvGovernanceFields`, resolved from static literals. */
140
139
  export interface DiscoveredVariableDocs extends EnvGovernanceFields {
141
140
  /** The environment variable name this documentation applies to. */
142
141
  readonly key: string;
@@ -164,12 +163,12 @@ export interface DiscoveredVariableDocs extends EnvGovernanceFields {
164
163
  readonly removeBy: string | undefined;
165
164
  /** Statically-resolved `renamedFrom`, if set to a string literal. */
166
165
  readonly renamedFrom: string | undefined;
167
- /** Statically-extracted `evidence` sub-object -- the re-verified-every-run half of a variable's documentation, kept structurally apart from the declared-only fields above. `undefined` when the declaration has no `evidence` key at all. See {@link runtime.VariableEvidenceDocs} and ADR 0037. */
166
+ /** Statically-extracted `evidence` sub-object: the re-verified-every-run half of a variable's documentation, kept structurally apart from the declared-only fields above. `undefined` when the declaration has no `evidence` key at all. See {@link runtime.VariableEvidenceDocs} and ADR 0037. */
168
167
  readonly evidence: DiscoveredVariableEvidence | undefined;
169
168
  }
170
169
  /** The statically-extracted contents of one variable's `evidence` sub-object. See {@link runtime.VariableEvidenceDocs}. */
171
170
  export interface DiscoveredVariableEvidence {
172
- /** 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. */
171
+ /** 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. */
173
172
  readonly dynamicAccess: readonly string[] | undefined;
174
173
  }
175
174
  /** A contract's statically-extracted `documentEnv()` documentation. */
@@ -1 +1 @@
1
- {"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/build/parse.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/build/parse.ts"],"names":[],"mappings":"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"}
@@ -1,19 +1,18 @@
1
1
  /**
2
- * env-cap's own built-in reference projections, declared through the exact
3
- * same public `defineEvidenceProjection()` a consumer would use (ADR
4
- * 0031/0032) -- no privileged internal path, no second way of reading the
5
- * Evidence Model.
2
+ * env-cap's own built-in reference projections. They are declared through
3
+ * the same public `defineEvidenceProjection()` a consumer would use (ADR
4
+ * 0031/0032). There is no privileged internal path, and no second way of
5
+ * reading the Evidence Model.
6
6
  *
7
- * This is deliberate dogfooding, not a convenience layer: `renderDocs()`'s
7
+ * This is deliberate dogfooding, not a convenience layer. `renderDocs()`'s
8
8
  * Catalog/ownership/lifecycle sections and `renderUsageReport()`'s ownership
9
- * table now source their underlying data through these projections, so the
10
- * extensibility API is exercised by env-cap's own generated output on every
11
- * single run. If a projector here can't express something, that's a real gap
12
- * in the public API -- discovered by env-cap itself rather than by a consumer
13
- * reporting it.
9
+ * table source their data through these projections. So env-cap's own
10
+ * generated output exercises the extensibility API on every run. If a
11
+ * projector here can't express something, that's a real gap in the public
12
+ * API. It shows up in env-cap's own output, before a consumer has to report it.
14
13
  *
15
14
  * Every projection is pure and derives *only* from `EvidenceModel`. None
16
- * reads the filesystem, and none reaches back into `DiscoveredContract` --
15
+ * reads the filesystem, and none reaches back into `DiscoveredContract`:
17
16
  * that would defeat the point, since a consumer only ever has the model.
18
17
  */
19
18
  import type { EvidenceProjectionResult } from "../evidence/define-projection.js";
@@ -23,7 +22,7 @@ export interface ConfigurationReferenceEntry {
23
22
  /** Root-relative, POSIX-separated path of the declaring contract. */
24
23
  readonly file: string;
25
24
  readonly exportName: string;
26
- /** The declaring contract's display name, resolved from Contract Model -- the one model that owns it. */
25
+ /** The declaring contract's display name, resolved from Contract Model: the one model that owns it. */
27
26
  readonly contractName: string;
28
27
  readonly key: string;
29
28
  readonly description: string | undefined;
@@ -36,17 +35,17 @@ export interface ConfigurationReferenceEntry {
36
35
  readonly hasProcessor: boolean;
37
36
  readonly hasValidator: boolean;
38
37
  readonly expiresAt: string | undefined;
39
- /** Whether the declaring contract is active. Inactive contracts are included -- the reference documents everything discovered, same scope the Catalog always had. */
38
+ /** Whether the declaring contract is active. Inactive contracts are included: the reference documents everything discovered, same scope the Catalog always had. */
40
39
  readonly active: boolean;
41
40
  }
42
41
  /** The Configuration Reference projection's output shape. */
43
42
  export interface ConfigurationReference extends Record<string, unknown> {
44
- /** The standing "declared, not verified" notice -- see `evidenceDisclaimer()`. Carried in the data, not only in a renderer, so a consumer projecting this to their own format can't accidentally drop it. */
43
+ /** The standing "declared, not verified" notice: see `evidenceDisclaimer()`. Carried in the data, not only in a renderer, so a consumer projecting this to their own format can't accidentally drop it. */
45
44
  readonly disclaimer: string;
46
45
  /** Every declared variable across every discovered contract, sorted by contract file, then export name, then key. */
47
46
  readonly entries: readonly ConfigurationReferenceEntry[];
48
47
  }
49
- /** The minimal shape {@link groupVariablesByOwner} needs -- structural, not pinned to one model, so the exact same grouping serves `OwnershipModel`'s already-resolved owners and `ContractModel`'s raw ones alike. */
48
+ /** The minimal shape {@link groupVariablesByOwner} needs. It is structural, not pinned to one model. So one grouping serves `OwnershipModel`'s already-resolved owners and `ContractModel`'s raw ones alike. */
50
49
  export interface OwnerBearingContract {
51
50
  readonly owner: string | undefined;
52
51
  readonly variables: readonly unknown[];
@@ -60,18 +59,18 @@ type VariableOf<C> = C extends {
60
59
  * its contract's), preserving input order within each owner.
61
60
  *
62
61
  * @remarks
63
- * The single implementation of "who owns what, rolled up per owner", shared
64
- * by the {@link ownershipSummary} projection and `docs.ts`'s own rendered
65
- * ownership matrix. Kept as one function precisely so env-cap's generated
66
- * Markdown and the projection a consumer reads can never disagree about the
67
- * grouping -- the same reason `effectiveOwner()` is the single resolution
68
- * rule (ADR 0028). Variables with no effective owner are omitted entirely
69
- * rather than bucketed under a synthetic `"unowned"` key, which would read
70
- * as a real team name; callers that need them ask for them separately.
62
+ * The single implementation of "who owns what, rolled up per owner". The
63
+ * {@link ownershipSummary} projection and `docs.ts`'s rendered ownership
64
+ * matrix share it. One function means env-cap's generated Markdown and the
65
+ * projection a consumer reads can never disagree about the grouping. That is
66
+ * also why `effectiveOwner()` is the single resolution rule (ADR 0028).
67
+ * Variables with no effective owner are omitted entirely. A synthetic
68
+ * `"unowned"` bucket would read as a real team name. Callers that need them
69
+ * ask for them separately.
71
70
  *
72
- * `ownerOf` is supplied by the caller so a model whose owners are already
71
+ * The caller supplies `ownerOf`. So a model whose owners are already
73
72
  * resolved (`OwnershipModel`) and one whose aren't (`ContractModel`) both
74
- * work without this function guessing which it was handed.
73
+ * work, without this function guessing which it was handed.
75
74
  */
76
75
  export declare function groupVariablesByOwner<C extends OwnerBearingContract>(contracts: readonly C[], ownerOf: (contract: C, variable: VariableOf<C>) => string | undefined): ReadonlyMap<string, readonly {
77
76
  contract: C;
@@ -83,9 +82,9 @@ export declare function groupVariablesByOwner<C extends OwnerBearingContract>(co
83
82
  *
84
83
  * @remarks
85
84
  * Resolution (variable's own value falling back to its contract's) happens
86
- * here rather than being left to each consumer, so two readers of this
87
- * projection can never disagree about who owns a variable -- the same reason
88
- * `effectiveOwner()` exists on the generator side (ADR 0028).
85
+ * here rather than being left to each consumer. So two readers of this
86
+ * projection can never disagree about who owns a variable. That is the same
87
+ * reason `effectiveOwner()` exists on the generator side (ADR 0028).
89
88
  */
90
89
  export declare function configurationReference(evidence: EvidenceModel): ConfigurationReference;
91
90
  export declare namespace configurationReference {
@@ -111,7 +110,7 @@ export interface OwnershipSummary extends Record<string, unknown> {
111
110
  readonly unowned: readonly string[];
112
111
  }
113
112
  /**
114
- * Ownership summary: the inverse of Ownership Model's per-contract view --
113
+ * Ownership summary: the inverse of Ownership Model's per-contract view;
115
114
  * who owns what, rolled up per owner, plus an explicit unowned list.
116
115
  */
117
116
  export declare function ownershipSummary(evidence: EvidenceModel): OwnershipSummary;
@@ -128,11 +127,11 @@ export interface ExpiringSoonEntry {
128
127
  readonly contractName: string;
129
128
  /** `undefined` for a contract-level expiry, set for a per-variable one. */
130
129
  readonly key: string | undefined;
131
- /** The raw ISO date string, exactly as declared -- never reformatted. */
130
+ /** The raw ISO date string, exactly as declared: never reformatted. */
132
131
  readonly expiresAt: string;
133
132
  /** Days remaining as of the run that produced this evidence; negative when already expired. */
134
133
  readonly daysRemaining: number;
135
- /** `true` when `daysRemaining` is negative -- the deadline has already passed. */
134
+ /** `true` when `daysRemaining` is negative: the deadline has already passed. */
136
135
  readonly expired: boolean;
137
136
  /** How to obtain a replacement value, if the declaration says. */
138
137
  readonly refreshInstructions: string | undefined;
@@ -150,16 +149,15 @@ export interface ExpiringSoonReport extends Record<string, unknown> {
150
149
  }
151
150
  /**
152
151
  * Expiring-Soon report: Lifecycle Model's `expiring` view, joined with
153
- * ownership and refresh instructions so a reader can act on a row without
152
+ * ownership and refresh instructions. A reader can act on a row without
154
153
  * cross-referencing three other models by hand.
155
154
  *
156
155
  * @remarks
157
- * The window itself was applied upstream, when Lifecycle Model was built --
158
- * this projection deliberately does not re-filter by a date of its own.
159
- * Recomputing "soon" here would make the projection's answer depend on when
160
- * it happened to be *read* rather than when the evidence was *generated*,
161
- * which is exactly the reproducibility property the Evidence Model exists to
162
- * preserve.
156
+ * The window itself was applied upstream, when Lifecycle Model was built.
157
+ * This projection deliberately does not re-filter by a date of its own.
158
+ * Recomputing "soon" here would tie the answer to when it was *read*, not
159
+ * when the evidence was *generated*. The Evidence Model exists to preserve
160
+ * exactly that reproducibility.
163
161
  */
164
162
  export declare function expiringSoonReport(evidence: EvidenceModel): ExpiringSoonReport;
165
163
  export declare namespace expiringSoonReport {
@@ -1 +1 @@
1
- {"version":3,"file":"reference-projections.d.ts","sourceRoot":"","sources":["../../../src/build/reference-projections.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"reference-projections.d.ts","sourceRoot":"","sources":["../../../src/build/reference-projections.ts"],"names":[],"mappings":"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"}