@maverickcer/env-cap 0.7.7 → 0.8.0

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 (183) hide show
  1. package/ADOPTION.md +4 -4
  2. package/AGENTS.md +2 -3
  3. package/CHANGELOG.md +27 -0
  4. package/CODE_REVIEW.md +1 -1
  5. package/CONTRIBUTING.md +1 -1
  6. package/GUIDE.md +12 -12
  7. package/README.md +11 -12
  8. package/VERSIONING.md +2 -1
  9. package/dist/.dts/_ipc/resolve-tsconfig-paths.d.ts +3 -4
  10. package/dist/.dts/_ipc/resolve-tsconfig-paths.d.ts.map +1 -1
  11. package/dist/.dts/build/assemble-project.d.ts +3 -3
  12. package/dist/.dts/build/change-model.d.ts +9 -11
  13. package/dist/.dts/build/change-model.d.ts.map +1 -1
  14. package/dist/.dts/build/check-artifacts.d.ts +5 -6
  15. package/dist/.dts/build/check-artifacts.d.ts.map +1 -1
  16. package/dist/.dts/build/citation-verification.d.ts +6 -7
  17. package/dist/.dts/build/citation-verification.d.ts.map +1 -1
  18. package/dist/.dts/build/contract-model.d.ts +7 -8
  19. package/dist/.dts/build/contract-model.d.ts.map +1 -1
  20. package/dist/.dts/build/deep-equal.d.ts +3 -3
  21. package/dist/.dts/build/deep-freeze.d.ts +5 -7
  22. package/dist/.dts/build/deep-freeze.d.ts.map +1 -1
  23. package/dist/.dts/build/dependency-model.d.ts +2 -2
  24. package/dist/.dts/build/dependency-model.d.ts.map +1 -1
  25. package/dist/.dts/build/discover.d.ts +6 -6
  26. package/dist/.dts/build/discover.d.ts.map +1 -1
  27. package/dist/.dts/build/env-example.d.ts +6 -7
  28. package/dist/.dts/build/env-example.d.ts.map +1 -1
  29. package/dist/.dts/build/errors.d.ts +4 -4
  30. package/dist/.dts/build/evidence-cache.d.ts +12 -14
  31. package/dist/.dts/build/evidence-cache.d.ts.map +1 -1
  32. package/dist/.dts/build/evidence-model.d.ts +6 -7
  33. package/dist/.dts/build/evidence-model.d.ts.map +1 -1
  34. package/dist/.dts/build/evidence-reference.d.ts +6 -6
  35. package/dist/.dts/build/evidence-reference.d.ts.map +1 -1
  36. package/dist/.dts/build/exclusive-group.d.ts +3 -3
  37. package/dist/.dts/build/finding-model.d.ts +12 -13
  38. package/dist/.dts/build/finding-model.d.ts.map +1 -1
  39. package/dist/.dts/build/generate-documentation.d.ts +6 -7
  40. package/dist/.dts/build/generate-documentation.d.ts.map +1 -1
  41. package/dist/.dts/build/generate-evidence.d.ts +13 -15
  42. package/dist/.dts/build/generate-evidence.d.ts.map +1 -1
  43. package/dist/.dts/build/generate-manifest.d.ts +14 -16
  44. package/dist/.dts/build/generate-manifest.d.ts.map +1 -1
  45. package/dist/.dts/build/generated-banner.d.ts +3 -3
  46. package/dist/.dts/build/governance-fields.d.ts +3 -3
  47. package/dist/.dts/build/humanize-key.d.ts +3 -3
  48. package/dist/.dts/build/lifecycle-model.d.ts +3 -3
  49. package/dist/.dts/build/literal-eval.d.ts +2 -2
  50. package/dist/.dts/build/literal-eval.d.ts.map +1 -1
  51. package/dist/.dts/build/live-expirations.d.ts +9 -9
  52. package/dist/.dts/build/manifest.d.ts +7 -8
  53. package/dist/.dts/build/manifest.d.ts.map +1 -1
  54. package/dist/.dts/build/merge-documentation.d.ts +4 -5
  55. package/dist/.dts/build/merge-documentation.d.ts.map +1 -1
  56. package/dist/.dts/build/resolution/resolve-import.d.ts +8 -9
  57. package/dist/.dts/build/resolution/resolve-import.d.ts.map +1 -1
  58. package/dist/.dts/build/resolution/resolve-within-root.d.ts +4 -4
  59. package/dist/.dts/build/sarif.d.ts +9 -11
  60. package/dist/.dts/build/sarif.d.ts.map +1 -1
  61. package/dist/.dts/build/source-position.d.ts +14 -17
  62. package/dist/.dts/build/source-position.d.ts.map +1 -1
  63. package/dist/.dts/build/usage-report.d.ts +16 -17
  64. package/dist/.dts/build/usage-report.d.ts.map +1 -1
  65. package/dist/.dts/cli/filesystem.d.ts.map +1 -1
  66. package/dist/.dts/eslint-plugin/glob.d.ts +2 -2
  67. package/dist/.dts/eslint-plugin/index.d.ts +2 -1
  68. package/dist/.dts/eslint-plugin/index.d.ts.map +1 -1
  69. package/dist/.dts/eslint-plugin/no-node-fs.d.ts +5 -5
  70. package/dist/.dts/eslint-plugin/no-raw-process-env.d.ts +4 -4
  71. package/dist/.dts/evidence/define-projection.d.ts +6 -6
  72. package/dist/.dts/runtime/create.d.ts +2 -3
  73. package/dist/.dts/runtime/create.d.ts.map +1 -1
  74. package/dist/.dts/runtime/errors.d.ts +7 -8
  75. package/dist/.dts/runtime/errors.d.ts.map +1 -1
  76. package/dist/.dts/runtime/index.d.ts +2 -2
  77. package/dist/.dts/runtime/types.d.ts +18 -20
  78. package/dist/.dts/runtime/types.d.ts.map +1 -1
  79. package/dist/.dts/runtime/validate.d.ts +2 -2
  80. package/dist/.dts/runtime/validate.d.ts.map +1 -1
  81. package/dist/.dts7/_ipc/resolve-tsconfig-paths.d.ts +3 -4
  82. package/dist/.dts7/_ipc/resolve-tsconfig-paths.d.ts.map +1 -1
  83. package/dist/.dts7/build/assemble-project.d.ts +3 -3
  84. package/dist/.dts7/build/change-model.d.ts +9 -11
  85. package/dist/.dts7/build/change-model.d.ts.map +1 -1
  86. package/dist/.dts7/build/check-artifacts.d.ts +5 -6
  87. package/dist/.dts7/build/check-artifacts.d.ts.map +1 -1
  88. package/dist/.dts7/build/citation-verification.d.ts +6 -7
  89. package/dist/.dts7/build/citation-verification.d.ts.map +1 -1
  90. package/dist/.dts7/build/contract-model.d.ts +7 -8
  91. package/dist/.dts7/build/contract-model.d.ts.map +1 -1
  92. package/dist/.dts7/build/deep-equal.d.ts +3 -3
  93. package/dist/.dts7/build/deep-freeze.d.ts +5 -7
  94. package/dist/.dts7/build/deep-freeze.d.ts.map +1 -1
  95. package/dist/.dts7/build/dependency-model.d.ts +2 -2
  96. package/dist/.dts7/build/dependency-model.d.ts.map +1 -1
  97. package/dist/.dts7/build/discover.d.ts +6 -6
  98. package/dist/.dts7/build/discover.d.ts.map +1 -1
  99. package/dist/.dts7/build/env-example.d.ts +6 -7
  100. package/dist/.dts7/build/env-example.d.ts.map +1 -1
  101. package/dist/.dts7/build/errors.d.ts +4 -4
  102. package/dist/.dts7/build/evidence-cache.d.ts +12 -14
  103. package/dist/.dts7/build/evidence-cache.d.ts.map +1 -1
  104. package/dist/.dts7/build/evidence-model.d.ts +6 -7
  105. package/dist/.dts7/build/evidence-model.d.ts.map +1 -1
  106. package/dist/.dts7/build/evidence-reference.d.ts +6 -6
  107. package/dist/.dts7/build/evidence-reference.d.ts.map +1 -1
  108. package/dist/.dts7/build/exclusive-group.d.ts +3 -3
  109. package/dist/.dts7/build/finding-model.d.ts +12 -13
  110. package/dist/.dts7/build/finding-model.d.ts.map +1 -1
  111. package/dist/.dts7/build/generate-documentation.d.ts +6 -7
  112. package/dist/.dts7/build/generate-documentation.d.ts.map +1 -1
  113. package/dist/.dts7/build/generate-evidence.d.ts +13 -15
  114. package/dist/.dts7/build/generate-evidence.d.ts.map +1 -1
  115. package/dist/.dts7/build/generate-manifest.d.ts +14 -16
  116. package/dist/.dts7/build/generate-manifest.d.ts.map +1 -1
  117. package/dist/.dts7/build/generated-banner.d.ts +3 -3
  118. package/dist/.dts7/build/governance-fields.d.ts +3 -3
  119. package/dist/.dts7/build/humanize-key.d.ts +3 -3
  120. package/dist/.dts7/build/lifecycle-model.d.ts +3 -3
  121. package/dist/.dts7/build/literal-eval.d.ts +2 -2
  122. package/dist/.dts7/build/literal-eval.d.ts.map +1 -1
  123. package/dist/.dts7/build/live-expirations.d.ts +9 -9
  124. package/dist/.dts7/build/manifest.d.ts +7 -8
  125. package/dist/.dts7/build/manifest.d.ts.map +1 -1
  126. package/dist/.dts7/build/merge-documentation.d.ts +4 -5
  127. package/dist/.dts7/build/merge-documentation.d.ts.map +1 -1
  128. package/dist/.dts7/build/resolution/resolve-import.d.ts +8 -9
  129. package/dist/.dts7/build/resolution/resolve-import.d.ts.map +1 -1
  130. package/dist/.dts7/build/resolution/resolve-within-root.d.ts +4 -4
  131. package/dist/.dts7/build/sarif.d.ts +9 -11
  132. package/dist/.dts7/build/sarif.d.ts.map +1 -1
  133. package/dist/.dts7/build/source-position.d.ts +14 -17
  134. package/dist/.dts7/build/source-position.d.ts.map +1 -1
  135. package/dist/.dts7/build/usage-report.d.ts +16 -17
  136. package/dist/.dts7/build/usage-report.d.ts.map +1 -1
  137. package/dist/.dts7/cli/filesystem.d.ts.map +1 -1
  138. package/dist/.dts7/eslint-plugin/glob.d.ts +2 -2
  139. package/dist/.dts7/eslint-plugin/index.d.ts +2 -1
  140. package/dist/.dts7/eslint-plugin/index.d.ts.map +1 -1
  141. package/dist/.dts7/eslint-plugin/no-node-fs.d.ts +5 -5
  142. package/dist/.dts7/eslint-plugin/no-raw-process-env.d.ts +4 -4
  143. package/dist/.dts7/evidence/define-projection.d.ts +6 -6
  144. package/dist/.dts7/runtime/create.d.ts +2 -3
  145. package/dist/.dts7/runtime/create.d.ts.map +1 -1
  146. package/dist/.dts7/runtime/errors.d.ts +7 -8
  147. package/dist/.dts7/runtime/errors.d.ts.map +1 -1
  148. package/dist/.dts7/runtime/index.d.ts +2 -2
  149. package/dist/.dts7/runtime/types.d.ts +18 -20
  150. package/dist/.dts7/runtime/types.d.ts.map +1 -1
  151. package/dist/.dts7/runtime/validate.d.ts +2 -2
  152. package/dist/.dts7/runtime/validate.d.ts.map +1 -1
  153. package/dist/{build-33O5SDTC.js → build-Z76NCC65.js} +7 -10
  154. package/dist/build-Z76NCC65.js.map +1 -0
  155. package/dist/build.cjs +6 -9
  156. package/dist/build.cjs.map +1 -1
  157. package/dist/build.js +6 -9
  158. package/dist/build.js.map +1 -1
  159. package/dist/{chunk-4D67AQFY.js → chunk-JRCMG4FQ.js} +2 -2
  160. package/dist/cli/index.js +3 -3
  161. package/dist/cli/index.js.map +1 -1
  162. package/dist/eslint-plugin/index.cjs.map +1 -1
  163. package/dist/eslint-plugin/index.js.map +1 -1
  164. package/dist/evidence.cjs.map +1 -1
  165. package/dist/evidence.js.map +1 -1
  166. package/dist/index.cjs.map +1 -1
  167. package/dist/index.js.map +1 -1
  168. package/dist/node.cjs.map +1 -1
  169. package/dist/node.js.map +1 -1
  170. package/package.json +6 -4
  171. package/schemas/env-cap-report.schema.json +11 -11
  172. package/skills/env-cap/SKILL.md +1 -1
  173. package/skills/env-cap/references/api.md +1 -1
  174. package/specs/architecture.md +6 -6
  175. package/specs/migrations/README.md +9 -9
  176. package/specs/migrations/from-centralized-schema.md +28 -28
  177. package/specs/migrations/from-dotenv.md +11 -11
  178. package/specs/migrations/from-envalid.md +16 -16
  179. package/specs/migrations/from-process-env.md +19 -19
  180. package/specs/migrations/from-t3-env.md +24 -24
  181. package/specs/migrations/from-zod.md +21 -21
  182. package/dist/build-33O5SDTC.js.map +0 -1
  183. /package/dist/{chunk-4D67AQFY.js.map → chunk-JRCMG4FQ.js.map} +0 -0
@@ -2,18 +2,17 @@ import type { BuildFileSystem } from "../types.js";
2
2
  import { type PackageSchemaResolutionResult } from "./resolve-package-schema.js";
3
3
  import { type AliasResolutionCache, type TsconfigPathsResolution } from "./resolve-tsconfig-paths.js";
4
4
  /**
5
- * Resolves a relative import specifier (as written in source: `"./schema.js"`,
6
- * matching this codebase's own convention of `.js`-suffixed relative imports
7
- * pointing at `.ts` source files) to an absolute file path, relative to the
8
- * file that contains the import.
5
+ * Resolves a relative import specifier, as written in source (`"./schema.js"`),
6
+ * to an absolute file path. It resolves against the file that contains the
7
+ * import. A `.js` suffix points at the `.ts` source file, as in this codebase.
9
8
  *
10
9
  * @remarks
11
10
  * Deliberately narrow: only handles a direct relative specifier resolving to
12
- * a real `.ts`/`.tsx` file on disk. Bare/package specifiers, namespace
13
- * imports, and anything requiring real module resolution (re-export chains,
14
- * `exports` map lookups, etc.) return `undefined`: the caller treats that
15
- * as "couldn't statically link" and warns rather than guesses, the same
16
- * philosophy `evaluateLiteral` already uses for non-literal expressions.
11
+ * a real `.ts`/`.tsx` file on disk. Anything else returns `undefined`: bare
12
+ * or package specifiers, namespace imports, and anything that needs real
13
+ * module resolution (re-export chains, `exports` map lookups). The caller
14
+ * reads that as "couldn't statically link" and warns rather than guesses.
15
+ * `evaluateLiteral` treats non-literal expressions the same way.
17
16
  *
18
17
  * @returns The resolved absolute path, or `undefined` when the specifier isn't relative or doesn't resolve to a real file.
19
18
  */
@@ -1 +1 @@
1
- {"version":3,"file":"resolve-import.d.ts","sourceRoot":"","sources":["../../../../src/build/resolution/resolve-import.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC7B,MAAM,6BAA6B,CAAA;AAEpC;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,qBAAqB,CACzC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,eAAe,GAClB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAe7B;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAKlF;AAED,8GAA8G;AAC9G,MAAM,WAAW,uBAAuB;IACtC,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAA;IAC5B,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,2HAA2H;IAC3H,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,4HAA4H;IAC5H,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,6BAA6B,CAAC,CAAC,CAAA;IACnE,wIAAwI;IACxI,QAAQ,CAAC,aAAa,EAAE,uBAAuB,GAAG,SAAS,CAAA;IAC3D,+LAA+L;IAC/L,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAA;CAC1C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,sBAAsB,CAC1C,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAe7B"}
1
+ {"version":3,"file":"resolve-import.d.ts","sourceRoot":"","sources":["../../../../src/build/resolution/resolve-import.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC7B,MAAM,6BAA6B,CAAA;AAEpC;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,qBAAqB,CACzC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,eAAe,GAClB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAe7B;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAKlF;AAED,8GAA8G;AAC9G,MAAM,WAAW,uBAAuB;IACtC,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAA;IAC5B,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,2HAA2H;IAC3H,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,4HAA4H;IAC5H,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,6BAA6B,CAAC,CAAC,CAAA;IACnE,wIAAwI;IACxI,QAAQ,CAAC,aAAa,EAAE,uBAAuB,GAAG,SAAS,CAAA;IAC3D,+LAA+L;IAC/L,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAA;CAC1C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,sBAAsB,CAC1C,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAe7B"}
@@ -22,10 +22,10 @@ export declare function isWithinDirectory(baseDir: string, targetPath: string):
22
22
  * branch of the filesystem entirely). Discovery (`include`/`exclude`) is
23
23
  * already safe by construction: it only ever walks *down* from `root` via
24
24
  * `readdir`, so a pattern can't make it read outside `root`. Output
25
- * locations have no such structural guarantee, since `path.resolve` happily
26
- * walks back out via `..` segments, so this is a plain lexical bounds-check
27
- * (not a symlink-aware `realpath` check: these are *output* paths that
28
- * usually don't exist yet).
25
+ * locations have no such guarantee, since `path.resolve` walks back out
26
+ * through `..` segments. So this is a lexical bounds-check. It is not a
27
+ * symlink-aware `realpath` check, because *output* paths usually don't
28
+ * exist yet.
29
29
  *
30
30
  * Never throws itself: returns a `CompatibilityIssue`-shaped finding on
31
31
  * escape so each generator function (`generateEnvManifest`, `generateDocumentation`,
@@ -1,14 +1,13 @@
1
1
  /**
2
2
  * SARIF export: an adapter over Finding Model, not a new fact source.
3
3
  * Produces a minimal, spec-conformant SARIF 2.1.0 log
4
- * (https://docs.oasis-open.org/sarif/sarif/v2.1.0/) so env-cap's findings can
5
- * be consumed by any SARIF-aware tool (GitHub code scanning, most CI security
6
- * dashboards) without a bespoke integration.
4
+ * (https://docs.oasis-open.org/sarif/sarif/v2.1.0/). Any SARIF-aware tool can
5
+ * then read env-cap's findings, such as GitHub code scanning or a CI security
6
+ * dashboard.
7
7
  *
8
- * Pure and synchronous: every input is already computed by the time this
9
- * runs, so this never re-derives a finding, never reads the filesystem, and
10
- * never decides what is or isn't a problem; it only re-shapes what
11
- * `buildFindingModel()` already concluded.
8
+ * Pure and synchronous: every input is computed before this runs. It never
9
+ * re-derives a finding, reads the filesystem or decides what is a problem.
10
+ * It only re-shapes what `buildFindingModel()` concluded.
12
11
  */
13
12
  import type { FindingModel } from "./finding-model.js";
14
13
  /** SARIF's `level` enum: see the SARIF 2.1.0 spec, section 3.27.10. */
@@ -55,10 +54,9 @@ export interface SarifLog {
55
54
  *
56
55
  * @remarks
57
56
  * `rules` lists every distinct `FindingCode` actually present in this run,
58
- * sorted: not the full `FindingCode` union. A SARIF consumer treats the
59
- * rules array as "what this tool reported", and advertising rules that
60
- * produced no result makes a clean run look like it has unexplained silent
61
- * rules. `results` preserves Finding Model's own order, which a caller wanting
57
+ * sorted: not the full `FindingCode` union. A SARIF consumer reads the rules
58
+ * array as "what this tool reported". Rules with no result would make a clean
59
+ * run look like it has unexplained silent rules. `results` preserves Finding Model's own order, which a caller wanting
62
60
  * a different one sorts themselves.
63
61
  */
64
62
  export declare function buildSarifLog(findingModel: FindingModel): SarifLog;
@@ -1 +1 @@
1
- {"version":3,"file":"sarif.d.ts","sourceRoot":"","sources":["../../../src/build/sarif.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAW,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAI/D,uEAAuE;AACvE,KAAK,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;AAOvD,UAAU,aAAa;IACrB,QAAQ,CAAC,gBAAgB,EAAE;QACzB,QAAQ,CAAC,gBAAgB,EAAE;YAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;QACnD,QAAQ,CAAC,MAAM,CAAC,EAAE;YAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAA;KAC/E,CAAA;CACF;AAsCD,UAAU,WAAW;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,aAAa,EAAE,CAAA;CAC9C;AAED,iHAAiH;AACjH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS;QACtB,QAAQ,CAAC,IAAI,EAAE;YACb,QAAQ,CAAC,MAAM,EAAE;gBACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;gBACrB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;gBAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;gBACxB,QAAQ,CAAC,KAAK,EAAE,SAAS;oBAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;iBAAE,EAAE,CAAA;aACnD,CAAA;SACF,CAAA;QACD,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAA;KACzC,EAAE,CAAA;CACJ;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,YAAY,GAAG,QAAQ,CAgClE"}
1
+ {"version":3,"file":"sarif.d.ts","sourceRoot":"","sources":["../../../src/build/sarif.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAW,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAI/D,uEAAuE;AACvE,KAAK,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;AAOvD,UAAU,aAAa;IACrB,QAAQ,CAAC,gBAAgB,EAAE;QACzB,QAAQ,CAAC,gBAAgB,EAAE;YAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;QACnD,QAAQ,CAAC,MAAM,CAAC,EAAE;YAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAA;KAC/E,CAAA;CACF;AAsCD,UAAU,WAAW;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,aAAa,EAAE,CAAA;CAC9C;AAED,iHAAiH;AACjH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS;QACtB,QAAQ,CAAC,IAAI,EAAE;YACb,QAAQ,CAAC,MAAM,EAAE;gBACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;gBACrB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;gBAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;gBACxB,QAAQ,CAAC,KAAK,EAAE,SAAS;oBAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;iBAAE,EAAE,CAAA;aACnD,CAAA;SACF,CAAA;QACD,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAA;KACzC,EAAE,CAAA;CACJ;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,YAAY,GAAG,QAAQ,CAgClE"}
@@ -15,10 +15,9 @@ export interface SourcePosition {
15
15
  }
16
16
  /**
17
17
  * `node`'s starting line/column within `sourceFile`, both 1-indexed: TypeScript's own
18
- * `getLineAndCharacterOfPosition()` returns 0-indexed values for both. Callers combine this with
19
- * the file path they already have in scope to build a full {@link SourcePosition}; this returns
20
- * only the two numbers so it's usable identically whether the caller's `file` is already
21
- * root-relative or still absolute.
18
+ * `getLineAndCharacterOfPosition()` returns 0-indexed values for both. Callers add the file path
19
+ * they have in scope to build a full {@link SourcePosition}. Returning only the two numbers keeps
20
+ * it usable whether that path is root-relative or absolute.
22
21
  */
23
22
  export declare function positionOf(sourceFile: ts.SourceFile, node: ts.Node): {
24
23
  line: number;
@@ -27,28 +26,26 @@ export declare function positionOf(sourceFile: ts.SourceFile, node: ts.Node): {
27
26
  /**
28
27
  * Parses a developer-supplied `"<relative-path>:<line>:<column>"` citation
29
28
  * (a {@link runtime.VariableEvidenceDocs.dynamicAccess} entry) into a
30
- * {@link SourcePosition}. Splits on the *last* two colons so a path
31
- * containing colons of its own (rare, but not impossible) still parses:
32
- * only the trailing `:<line>:<column>` is treated as position syntax.
33
- * Returns `undefined` for anything that isn't exactly that shape (missing
34
- * segments, a non-positive-integer line/column, an empty path): callers
35
- * treat that as a malformed citation, never a thrown error. See ADR 0037.
29
+ * {@link SourcePosition}. Splits on the *last* two colons, so a path that
30
+ * contains colons still parses. Only the trailing `:<line>:<column>` is
31
+ * position syntax. Returns `undefined` for any other shape: missing segments,
32
+ * a line or column that is not a positive integer, or an empty path. Callers
33
+ * treat that as a malformed citation, not a thrown error. See ADR 0037.
36
34
  */
37
35
  export declare function parsePositionCitation(citation: string): SourcePosition | undefined;
38
36
  /**
39
37
  * One developer-declared {@link runtime.VariableEvidenceDocs.dynamicAccess} citation's
40
- * current acknowledgment state: a claim, never an observation. Kept fully
41
- * separate from `VariableAccessStatus` (which stays exactly 3-valued and
42
- * purely AST-derived) so a developer's assertion can never make env-cap
43
- * claim it observed something it didn't. See
38
+ * current acknowledgment state: a claim, never an observation. It stays
39
+ * separate from `VariableAccessStatus`, which is 3-valued and AST-derived only.
40
+ * So a developer's assertion can never make env-cap claim an observation it
41
+ * did not make. See
44
42
  * `evidence-snapshot.ts`'s `computeDynamicAccessAcknowledgments()` (where
45
43
  * this is computed) and ADR 0037.
46
44
  */
47
45
  export interface DynamicAccessAssertion extends SourcePosition {
48
46
  /**
49
- * `"fresh"`: the cited file currently exists and either matches the
50
- * committed baseline hash or has no baseline yet (a brand-new citation,
51
- * nothing to contradict it yet). `"stale"`: the cited file exists but its
47
+ * `"fresh"`: the cited file exists and matches the committed baseline
48
+ * hash, or has no baseline yet (a new citation). `"stale"`: the cited file exists but its
52
49
  * content has changed since the committed baseline. `"missing"`: the
53
50
  * cited file no longer exists at all. Re-derived from scratch every run;
54
51
  * never cached across runs.
@@ -1 +1 @@
1
- {"version":3,"file":"source-position.d.ts","sourceRoot":"","sources":["../../../src/build/source-position.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAA;AAEhC;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,UAAU,EAAE,EAAE,CAAC,UAAU,EACzB,IAAI,EAAE,EAAE,CAAC,IAAI,GACZ;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAGlC;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAQlF;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D;;;;;;;OAOG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAA;IACtD;;;;;;;;;OASG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;CACzC"}
1
+ {"version":3,"file":"source-position.d.ts","sourceRoot":"","sources":["../../../src/build/source-position.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAA;AAEhC;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,UAAU,EAAE,EAAE,CAAC,UAAU,EACzB,IAAI,EAAE,EAAE,CAAC,IAAI,GACZ;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAGlC;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAQlF;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAA;IACtD;;;;;;;;;OASG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;CACzC"}
@@ -12,9 +12,9 @@ export interface OwnershipDependencyEntry {
12
12
  readonly owner: string | undefined;
13
13
  /** Number of variables declared in this contract's schema. */
14
14
  readonly variableCount: number;
15
- /** Files coupled to this contract (imported it, referenced it, or read a
16
- * member from it): contract-level "who depends on this," NOT proof any
17
- * specific variable was read. Blast radius if this contract changes is
15
+ /** Files coupled to this contract: they import it, reference it, or read a
16
+ * member from it. This answers "who depends on this" per contract; it does
17
+ * not prove any variable was read. Blast radius if this contract changes is
18
18
  * `consumers.length`, computed by callers/renderers on demand rather than
19
19
  * stored redundantly here. */
20
20
  readonly consumers: readonly string[];
@@ -52,7 +52,7 @@ export interface UnconsumedOwnedVariableFinding {
52
52
  * claimed otherwise. A non-empty list means someone specifically claimed
53
53
  * dynamic access here once, and that claim can no longer be verified. That
54
54
  * is worth a human check before deleting, not a stronger reason to trust
55
- * "unconsumed." The list holds the raw citations, not a collapsed
55
+ * "unconsumed". The list holds the raw citations, not a collapsed
56
56
  * `high`/`low` label, matching this codebase's "show the receipt" pattern
57
57
  * (ADR 0036/0037). A reader can judge confidence from the actual evidence
58
58
  * rather than trusting a derived summary. See ADR 0038.
@@ -72,7 +72,7 @@ export interface IndeterminateOwnershipFinding {
72
72
  /** See {@link UnconsumedOwnedVariableFinding.staleOrMissingCitations}. */
73
73
  readonly staleOrMissingCitations: readonly DynamicAccessCitationProblem[];
74
74
  }
75
- /** A variable that would otherwise be reported `unconsumedOwnedVariables`/`indeterminate`, but has at least one `"fresh"` developer-declared `dynamicAccess` citation: the raw static status is always shown alongside the assertion, never replaced by it. See ADR 0037. */
75
+ /** A variable that would otherwise be reported `unconsumedOwnedVariables`/`indeterminate` but has at least one `"fresh"` developer-declared `dynamicAccess` citation. The raw static status is shown beside the assertion, never replaced by it. See ADR 0037. */
76
76
  export interface AssertedDynamicAccessFinding {
77
77
  /** Resolved display name (see {@link DiscoveredContract.contractName}). */
78
78
  readonly contractName: string;
@@ -84,10 +84,9 @@ export interface AssertedDynamicAccessFinding {
84
84
  readonly dynamicAccessAssertions: readonly DynamicAccessAssertion[];
85
85
  }
86
86
  /** Everything {@link renderUsageReport} needs to render the Dependency &
87
- * Ownership Report: deliberately independent of (not derived from)
88
- * `GenerateUsageReportResult` in `generate-usage.js`, the same way
89
- * `RenderDocsOptions` in `docs.ts` doesn't derive from
90
- * `GenerateDocumentationResult`. `generate-usage.ts` composes its own
87
+ * Ownership Report. It is not derived from `GenerateUsageReportResult` in
88
+ * `generate-usage.js`, as `RenderDocsOptions` in `docs.ts` is not derived
89
+ * from `GenerateDocumentationResult`. `generate-usage.ts` composes its own
91
90
  * public result type from these building blocks instead, keeping this
92
91
  * renderer module importable without its orchestrator. */
93
92
  export interface RenderUsageReportOptions {
@@ -105,20 +104,20 @@ export interface RenderUsageReportOptions {
105
104
  readonly indeterminate: readonly IndeterminateOwnershipFinding[];
106
105
  /** Variables a developer has re-acknowledged via `dynamicAccess`, freshly: see ADR 0037. */
107
106
  readonly asserted: readonly AssertedDynamicAccessFinding[];
108
- /** Schema-discovery parse warnings plus, since ADR 0014, any `packages`
109
- * resolution failures: surfaced here too (not just from
110
- * `generateEnvManifest`/`generateDocumentation`) so a team relying only
111
- * on `--ownership` output still learns when a cross-package contract
112
- * failed to resolve. */
107
+ /** Schema-discovery parse warnings plus any `packages` resolution failures
108
+ * (ADR 0014). They appear here as well as in
109
+ * `generateEnvManifest`/`generateDocumentation`, so a team that reads only
110
+ * this report still learns when a cross-package contract failed to
111
+ * resolve. */
113
112
  readonly parseWarnings: readonly ParseWarning[];
114
113
  /** Every surface actually scanned for usage: see ADR 0036. Named explicitly next to `unconsumedOwnedVariables` so "no consumer found" is never read as a stronger claim than what was actually searched. */
115
114
  readonly scannedSurfaces: readonly ScannedSurface[];
116
115
  }
117
116
  /**
118
117
  * Renders the Dependency & Ownership Report: who owns each variable, which
119
- * features consume each contract, and what the blast radius is if it
120
- * changes; structured around exactly those three questions, never generic
121
- * "dead code"/"unused symbol" language.
118
+ * features consume each contract, and the blast radius of a change. It
119
+ * answers those three questions, never in generic "dead code" or "unused
120
+ * symbol" terms.
122
121
  */
123
122
  export declare function renderUsageReport(computed: RenderUsageReportOptions): string;
124
123
  //# sourceMappingURL=usage-report.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"usage-report.d.ts","sourceRoot":"","sources":["../../../src/build/usage-report.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"usage-report.d.ts","sourceRoot":"","sources":["../../../src/build/usage-report.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../../src/cli/filesystem.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,eAAe,EAAc,MAAM,mBAAmB,CAAA;AAiDjF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,eAO9B,CAAA"}
1
+ {"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../../src/cli/filesystem.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,eAAe,EAAc,MAAM,mBAAmB,CAAA;AAgDjF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,eAO9B,CAAA"}
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Matching of the plugin's `allow` options against the file a rule is checking. The behavior lives in
3
- * `../_ipc/glob.ts`, a managed copy of internal-package-contract's `runtime/glob.ts`: a pattern written relative to
4
- * the working directory (`src/cli/**`) matches the absolute path ESLint passes, on Windows too.
3
+ * `../_ipc/glob.ts`, a managed copy of `runtime/glob.ts` from internal-package-contract. A pattern written
4
+ * relative to the working directory (`src/cli/**`) matches the absolute path ESLint passes, on Windows too.
5
5
  */
6
6
  export { matchesAllowList } from "../_ipc/glob.js";
7
7
  //# sourceMappingURL=glob.d.ts.map
@@ -3,7 +3,8 @@
3
3
  *
4
4
  * `no-raw-process-env` flags direct `process.env` reads outside `env.schema.ts` files. `no-node-fs` flags
5
5
  * `node:fs` imports in library code, which should take its file system from the caller. The plugin runs
6
- * inside the project's own ESLint; CI runs the rules on ESLint 10 only.
6
+ * inside the project's ESLint. The `eslint-compat` CI job tests it on the lowest and newest release of each
7
+ * ESLint major in the peer range.
7
8
  *
8
9
  * @packageDocumentation
9
10
  */
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/eslint-plugin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEzD;;;;;;;;;;GAUG;AACH,QAAA,MAAM,MAAM;IACV,wEAAwE;;QAEtE,mCAAmC;;;;QAEnC,4BAA4B;;;;;CAG/B,CAAA;AACD,eAAe,MAAM,CAAA;AACrB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAA"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/eslint-plugin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEzD;;;;;;;;;;GAUG;AACH,QAAA,MAAM,MAAM;IACV,wEAAwE;;QAEtE,mCAAmC;;;;QAEnC,4BAA4B;;;;;CAG/B,CAAA;AACD,eAAe,MAAM,CAAA;AACrB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAA"}
@@ -1,11 +1,11 @@
1
1
  /**
2
- * Flags any `import`/`require`/dynamic `import()` of `node:fs` in library code, so a library surface acquires
3
- * its filesystem capability from the caller instead of reaching for `node:fs` itself.
2
+ * Flags any `import`, `require` or dynamic `import()` of `node:fs` in library code. A library surface then
3
+ * receives its filesystem capability from the caller instead of importing `node:fs`.
4
4
  *
5
5
  * @remarks
6
- * Nothing is exempt by default. A package's own config allows its CLI folder (for example `src/cli/**`),
7
- * which builds the `node:fs/promises` adapter, and a consuming project sets the `allow` option for its own CLI
8
- * or script entry points. The rule itself lives in `../_ipc/no-node-fs.ts`, a managed copy of
6
+ * Nothing is exempt by default. A package's config allows its CLI folder (for example `src/cli/**`), which
7
+ * builds the `node:fs/promises` adapter. A consuming project sets the `allow` option for its CLI or script
8
+ * entry points. The rule itself lives in `../_ipc/no-node-fs.ts`, a managed copy of
9
9
  * internal-package-contract's `runtime/no-node-fs.ts`; this supplies env-cap's documentation link and the decision
10
10
  * record the message cites.
11
11
  */
@@ -10,12 +10,12 @@ export interface RuleOptions {
10
10
  }
11
11
  /**
12
12
  * Flags any direct `process.env.X`/`process.env["X"]` read in application code, so environment
13
- * access always goes through a capability's own `createEnv()` contract instead.
13
+ * access always goes through the `createEnv()` contract of the feature that owns the variable.
14
14
  *
15
15
  * @remarks
16
- * `env.schema.ts`/`env.schema.tsx` files are always exempt (that's where `createEnv()` itself
17
- * reads `process.env`); the rule's `allow` option extends that exemption to a consuming
18
- * project's own trusted bootstrap code.
16
+ * `env.schema.ts`/`env.schema.tsx` files are always exempt, because `createEnv()` reads
17
+ * `process.env` there. The rule's `allow` option extends that exemption to a consuming
18
+ * project's trusted bootstrap code.
19
19
  */
20
20
  export declare const noRawProcessEnv: import("@typescript-eslint/utils/ts-eslint").RuleModule<"noRawProcessEnv", [RuleOptions], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
21
21
  name: string;
@@ -1,10 +1,10 @@
1
1
  import type { EvidenceModel } from "../build/evidence-model.js";
2
2
  /**
3
3
  * A pure function from the full Evidence Model to one field of a
4
- * projection's output shape. Must not mutate `evidence` (the membrane
5
- * `defineEvidenceProjection()` wraps it in enforces that at runtime, see
6
- * `createTrackingProxy()` below) and must not perform I/O; env-cap can
7
- * enforce the read-only half of purity but not the "no side effects" half.
4
+ * projection's output shape. It reads `evidence` and performs no I/O.
5
+ * The membrane `defineEvidenceProjection()` wraps around `evidence` throws on
6
+ * any write (see `createTrackingProxy()` below). That enforces the read-only
7
+ * half of purity. The "no side effects" half is the author's job.
8
8
  */
9
9
  export type EvidenceProjector<T> = (evidence: EvidenceModel) => T;
10
10
  /** One independent, pure projector function per key of the projection's output shape `T`. */
@@ -28,8 +28,8 @@ export interface EvidenceProjection<T extends Record<string, unknown>> {
28
28
  }
29
29
  /**
30
30
  * Declares a projection: a named, pure transform from the immutable
31
- * `EvidenceModel` to any consumer-defined output shape, built entirely from
32
- * `schema`'s independent per-field projector functions; see ADR 0031/0032.
31
+ * `EvidenceModel` to any consumer-defined output shape. It is built from the
32
+ * independent per-field projector functions in `schema` (ADR 0031, ADR 0032).
33
33
  *
34
34
  * The reference projections env-cap ships (`.env.example`, Environment
35
35
  * Configuration Reference, Configuration Ownership, etc.) are built through
@@ -7,9 +7,8 @@ import type { CreateEnvOptions, EnvContract, EnvSchema } from "./types.js";
7
7
  * `createEnv` is runtime-only: `processor`/`validator`/`default` are the
8
8
  * whole vocabulary, because they're the only fields {@link validateEnv} actually
9
9
  * reads. Documentation (description, ownership, lifecycle, category, and
10
- * everything else that only exists to generate docs) lives in a separate
11
- * {@link documentEnv} call (see `document.ts`), which is entirely optional and
12
- * never required for this to work.
10
+ * everything else that only feeds generated docs) lives in a separate
11
+ * {@link documentEnv} call (see `document.ts`). That call is optional.
13
12
  *
14
13
  * @returns An {@link EnvContract} exposing one read-only getter per key: there is no
15
14
  * global env object, only per-feature contracts like `paymentsEnv.STRIPE_KEY`. Accessing a
@@ -1 +1 @@
1
- {"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/runtime/create.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAqB,gBAAgB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAI7F;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,SAAS,EAC3C,MAAM,EAAE,CAAC,EACT,OAAO,GAAE,gBAAqB,GAC7B,WAAW,CAAC,CAAC,CAAC,CA4ChB"}
1
+ {"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/runtime/create.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAqB,gBAAgB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAI7F;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,SAAS,EAC3C,MAAM,EAAE,CAAC,EACT,OAAO,GAAE,gBAAqB,GAC7B,WAAW,CAAC,CAAC,CAAC,CA4ChB"}
@@ -1,14 +1,13 @@
1
1
  /**
2
- * Every error type here is constructed only from: the variable name, the
3
- * declaring contract's name, the failure kind, and a message string that the
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.
2
+ * Every error type here is built from four things only. They are the variable
3
+ * name, the declaring contract's name, the failure kind, and a message from
4
+ * the developer's processor or validator. Raw or processed environment values
5
+ * never reach 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
9
- * build-time-only and its data is never retained anywhere {@link validateEnv}
10
- * could read it back out. This is a deliberate consequence of keeping the
11
- * runtime minimal, not an oversight.
8
+ * {@link documentEnv} call exists for this variable. `documentEnv` is
9
+ * build-time-only, and {@link validateEnv} has nowhere to read its data from.
10
+ * That follows from keeping the runtime minimal.
12
11
  */
13
12
  /** One variable's processing or validation failure, as recorded by {@link validateEnv}. */
14
13
  export interface VariableFailure {
@@ -1 +1 @@
1
- {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/runtime/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,2FAA2F;AAC3F,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,sEAAsE;IACtE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,gIAAgI;IAChI,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAAA;IACxC,qGAAqG;IACrG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAwBD;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,uFAAuF;IACvF,QAAQ,CAAC,IAAI,2BAA0B;IACvC,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAA;gBAEjC,QAAQ,EAAE,SAAS,eAAe,EAAE;CAMjD;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,mBAAkB;gBAEnB,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAS9C"}
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/runtime/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,2FAA2F;AAC3F,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,sEAAsE;IACtE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,gIAAgI;IAChI,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAAA;IACxC,qGAAqG;IACrG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAwBD;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,uFAAuF;IACvF,QAAQ,CAAC,IAAI,2BAA0B;IACvC,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAA;gBAEjC,QAAQ,EAAE,SAAS,eAAe,EAAE;CAMjD;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,mBAAkB;gBAEnB,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAS9C"}
@@ -7,8 +7,8 @@
7
7
  * Node imports, `process.` and `Buffer.`, but a third-party import would pass unnoticed.
8
8
  * Discovery and manifest generation live in `@maverickcer/env-cap/build`, never here.
9
9
  *
10
- * `documentEnv` is exported here, not from `./build`, because it is called inline in the same
11
- * schema file as `createEnv`, which may end up in any bundle. It must be as cheap to import as
10
+ * `documentEnv` is exported here, not from `./build`. It is called inline in the same schema file
11
+ * as `createEnv`, and that file may end up in any bundle. It must be as cheap to import as
12
12
  * `createEnv` (see `document.ts`).
13
13
  *
14
14
  * @packageDocumentation
@@ -7,9 +7,9 @@
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
11
- * the runtime's whole vocabulary, and every field in it is read by
12
- * `validate.ts`/`create.ts`/`errors.ts` at runtime. If a field is only ever
10
+ * in {@link documentEnv} (see `document.ts`), not here. This file is the
11
+ * runtime's whole vocabulary. `validate.ts`, `create.ts` and `errors.ts` read
12
+ * every field in it at runtime. If a field is only ever
13
13
  * read by the generator, it belongs in `document.ts`, not here. `context` is
14
14
  * the one exception. The build package also reads it for documentation
15
15
  * display (see ADR 0022). It belongs here rather than in `documentEnv()`
@@ -34,8 +34,8 @@ export type Validator<T> = (value: T, rawEnv: RawEnv) => true | string;
34
34
  *
35
35
  * @remarks
36
36
  * The union is redundant at the type level (`unknown` alone already accepts a
37
- * function). It's kept because this type is public API: collapsing it to bare `unknown`
38
- * would erase the one thing a reader of the generated `.d.ts` needs to learn here.
37
+ * function). It's kept because this type is public API. A reader of the generated `.d.ts`
38
+ * learns the thunk form from it, and bare `unknown` would hide that.
39
39
  */
40
40
  export type DefaultValue = unknown | (() => unknown);
41
41
  /** Configuration for one schema entry: how to default, process, and validate a single raw environment value. */
@@ -68,9 +68,9 @@ export interface EnvDefinition<T> {
68
68
  * A schema is a map of variable name -> definition.
69
69
  *
70
70
  * @remarks
71
- * `EnvDefinition<any>` is used only as the generic *bound* here (never surfaced to consumers):
71
+ * `EnvDefinition<any>` is used only as the generic *bound* here, never surfaced to consumers.
72
72
  * TypeScript infers a precise, per-key literal type for `S` from the object passed to
73
- * {@link createEnv}, so the resolved contract type (see {@link InferEnvValue}) stays fully
73
+ * {@link createEnv}. So the resolved contract type (see {@link InferEnvValue}) stays fully
74
74
  * strict. This is the same variance workaround used by schema libraries like zod/trpc for
75
75
  * heterogeneous generic maps.
76
76
  */
@@ -102,9 +102,9 @@ export interface ContractInternals<S extends EnvSchema = EnvSchema> {
102
102
  * runtime cache: there is no global env object, only per-feature contracts like this one.
103
103
  *
104
104
  * @remarks
105
- * `toString()` is intersected in (rather than left to the ambient `Object.prototype`
106
- * declaration) because `create.ts` genuinely overrides it to return a redacted
107
- * `EnvContract("name")` representation, never resolved values: see ADR 0006. Declaring
105
+ * `toString()` is intersected in, rather than left to the ambient `Object.prototype`
106
+ * declaration. `create.ts` overrides it to return a redacted `EnvContract("name")`
107
+ * representation, never resolved values (ADR 0006). Declaring
108
108
  * it here means the type accurately describes what calling `String(contract)` returns.
109
109
  */
110
110
  export type EnvContract<S extends EnvSchema> = {
@@ -127,9 +127,9 @@ export interface validateEnvOptions {
127
127
  /**
128
128
  * Every contract to validate: typically the `contracts` array imported
129
129
  * from a generated manifest (see {@link build.generateEnvManifest}). Pass all of them
130
- * in one call: {@link validateEnv} only ever initializes once per process, so
131
- * a second call returns the first call's cached result without
132
- * re-running anything, even if it passes a different manifest.
130
+ * in one call. {@link validateEnv} initializes once per process. A second call
131
+ * returns the first call's cached result without re-running anything, even if
132
+ * it passes a different manifest.
133
133
  */
134
134
  manifest: readonly EnvContract<any>[];
135
135
  /**
@@ -137,9 +137,8 @@ export interface validateEnvOptions {
137
137
  * "production"]`): entirely application-defined; env-cap never
138
138
  * detects or infers these, the caller always computes and passes them
139
139
  * explicitly. A variable whose `context` isn't in this list is skipped
140
- * entirely (no default/processor/validator runs for it, and it stays in
141
- * its not-ready state, exactly as if this run had never happened for
142
- * it): see ADR 0022. A variable with no `context` always participates,
140
+ * (ADR 0022). No default, processor or validator runs for it. It stays
141
+ * not ready, as if this run had never happened. A variable with no `context` always participates,
143
142
  * regardless of what's passed here. Omitted (the default) behaves as an
144
143
  * empty list: only variables with no `context` participate.
145
144
  *
@@ -179,10 +178,9 @@ export interface CreateEnvOptions {
179
178
  /**
180
179
  * Pass `import.meta.url` here so validation errors point at the file that
181
180
  * declared the failing variable (e.g. "features/payments/env.schema.ts")
182
- * instead of just the short `name` label. There is no portable way for
183
- * `createEnv` to discover its caller's module URL on its own: this is
184
- * always correct and never goes stale, since it's supplied by the JS
185
- * engine rather than hand-typed.
181
+ * instead of the short `name` label. `createEnv` has no portable way to
182
+ * discover its caller's module URL. The JS engine supplies
183
+ * `import.meta.url`, so it is always correct and never goes stale.
186
184
  */
187
185
  source?: string;
188
186
  }
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/runtime/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/runtime/types.ts"],"names":[],"mappings":"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"}
@@ -4,8 +4,8 @@ import type { validateEnvOptions, validateEnvResult } from "./types.js";
4
4
  * `options.values`, then caches the results.
5
5
  *
6
6
  * @remarks
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
7
+ * Idempotent: the first call's outcome, success or failure, holds for the life of the
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 +1 @@
1
- {"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/runtime/validate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEvE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0BzF"}
1
+ {"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/runtime/validate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEvE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAyBzF"}
@@ -125,10 +125,9 @@ export declare function loadTsconfigPaths(product: string, root: string, tsconfi
125
125
  * this mechanism never overlaps with that trust boundary.
126
126
  * - **`.ts`/`.tsx` only.** Matches `resolveRelativeImport()`'s own existing candidate set
127
127
  * and `resolve-package-schema.ts`'s `SCHEMA_FILE_EXTENSIONS`: this codebase's static-
128
- * analysis pipeline is `.ts`/`.tsx` only today. A resolved non-`.ts`/`.tsx` file is a
129
- * real risk, not just a gap: feeding it straight into `ts.createSourceFile()` wouldn't
130
- * error, it would silently parse garbage: exactly the "guess" this codebase's
131
- * warn-don't-guess philosophy exists to avoid.
128
+ * analysis pipeline reads only `.ts` and `.tsx` today. Any other resolved file is a risk.
129
+ * `ts.createSourceFile()` would not error on it; it would parse garbage. That is the
130
+ * "guess" the warn-don't-guess rule exists to prevent.
132
131
  */
133
132
  export declare function resolveAliasImport(specifier: string, importingFile: string, resolution: TsconfigPathsResolution, cache: AliasResolutionCache): string | undefined;
134
133
  //# sourceMappingURL=resolve-tsconfig-paths.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"resolve-tsconfig-paths.d.ts","sourceRoot":"","sources":["../../../src/_ipc/resolve-tsconfig-paths.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAA;AAEhC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,EAAE,CAAC,eAAe,GAAG,kBAAkB,CAElF;AAED,4IAA4I;AAC5I,MAAM,WAAW,uBAAuB;IACtC,2GAA2G;IAC3G,QAAQ,CAAC,eAAe,EAAE,EAAE,CAAC,eAAe,CAAA;IAC5C,gFAAgF;IAChF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;CACtD;AAED,sGAAsG;AACtG,wBAAgB,0BAA0B,IAAI,oBAAoB,CAEjE;AAYD,iIAAiI;AACjI,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,uBAAuB,GAAG,SAAS,CAAA;IACxD,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,CAAA;CAC9C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,EAC1C,EAAE,EAAE,eAAe,GAClB,OAAO,CAAC,uBAAuB,CAAC,CAuElC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,uBAAuB,EACnC,KAAK,EAAE,oBAAoB,GAC1B,MAAM,GAAG,SAAS,CAiBpB"}
1
+ {"version":3,"file":"resolve-tsconfig-paths.d.ts","sourceRoot":"","sources":["../../../src/_ipc/resolve-tsconfig-paths.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAA;AAEhC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,EAAE,CAAC,eAAe,GAAG,kBAAkB,CAElF;AAED,4IAA4I;AAC5I,MAAM,WAAW,uBAAuB;IACtC,2GAA2G;IAC3G,QAAQ,CAAC,eAAe,EAAE,EAAE,CAAC,eAAe,CAAA;IAC5C,gFAAgF;IAChF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;CACtD;AAED,sGAAsG;AACtG,wBAAgB,0BAA0B,IAAI,oBAAoB,CAEjE;AAYD,iIAAiI;AACjI,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,uBAAuB,GAAG,SAAS,CAAA;IACxD,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,CAAA;CAC9C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,EAC1C,EAAE,EAAE,eAAe,GAClB,OAAO,CAAC,uBAAuB,CAAC,CAuElC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,uBAAuB,EACnC,KAAK,EAAE,oBAAoB,GAC1B,MAAM,GAAG,SAAS,CAiBpB"}
@@ -18,9 +18,9 @@ export interface AssembleProjectOptions {
18
18
  * discovery+link pass. It holds the linked contract graph and the
19
19
  * import-resolution context. Every later resolution call
20
20
  * (`computeScanSurface()`, `buildDependencyModel()`, ...) must reuse that
21
- * context to agree with `linkResult`. It also holds a shared file-read cache,
22
- * so a file matched by more than one later pass' glob is read from disk once
23
- * (e.g. a schema file also matched by the usage pass' broader `SCAN_INCLUDE`).
21
+ * context to agree with `linkResult`. It also holds a shared file-read cache.
22
+ * So a file that several later passes match is read from disk once. A schema
23
+ * file that the usage pass' broader `SCAN_INCLUDE` also matches is one case.
24
24
  */
25
25
  export interface AssembledProject {
26
26
  readonly root: string;