@maverickcer/env-cap 0.7.6 → 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 (184) hide show
  1. package/ADOPTION.md +4 -4
  2. package/AGENTS.md +2 -3
  3. package/CHANGELOG.md +36 -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-UEENZEUX.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-TBL3O7IG.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 +8 -7
  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/decisions/0049-typescript-7-scanner-uses-a-bundled-typescript-6.md +9 -0
  176. package/specs/migrations/README.md +9 -9
  177. package/specs/migrations/from-centralized-schema.md +28 -28
  178. package/specs/migrations/from-dotenv.md +11 -11
  179. package/specs/migrations/from-envalid.md +16 -16
  180. package/specs/migrations/from-process-env.md +19 -19
  181. package/specs/migrations/from-t3-env.md +24 -24
  182. package/specs/migrations/from-zod.md +21 -21
  183. package/dist/build-UEENZEUX.js.map +0 -1
  184. /package/dist/{chunk-TBL3O7IG.js.map → chunk-JRCMG4FQ.js.map} +0 -0
@@ -7,10 +7,9 @@ import type { BuildFileSystem } from "./types.js";
7
7
  * current `EvidenceModel` without silently-stale data. Such a consumer
8
8
  * avoids a full `generateEvidenceModel()` recompute on every invocation
9
9
  * (schema parsing, cross-file linking, the dependency-graph AST scan, all six
10
- * model builds). The mechanism: a cheap content fingerprint,
11
- * computed from raw file bytes with zero AST work, lets a caller cheaply
12
- * prove "nothing relevant to evidence generation has changed since this file
13
- * was last written" before trusting it.
10
+ * model builds). A content fingerprint over raw file bytes costs no AST work.
11
+ * It lets the caller prove that nothing relevant to evidence generation
12
+ * changed since the file was written, before trusting it.
14
13
  */
15
14
  /** Options for {@link computeSourceFingerprint}. */
16
15
  export interface ComputeSourceFingerprintOptions {
@@ -22,9 +21,9 @@ export interface ComputeSourceFingerprintOptions {
22
21
  readonly packages?: readonly string[] | undefined;
23
22
  }
24
23
  /**
25
- * SHA-256 over the raw bytes of every schema file and every usage-scan-
26
- * surface file (the same file sets `assembleProject()`/`computeScanSurface()`
27
- * touch), plus env-cap's own installed version: zero AST parsing or
24
+ * SHA-256 over the raw bytes of every schema file and every usage-scan
25
+ * surface file, plus the installed env-cap version. Those are the file sets
26
+ * `assembleProject()`/`computeScanSurface()` touch. It does no AST parsing or
28
27
  * linking. Still requires the discovery/glob walk itself (fingerprinting has
29
28
  * to know which files matter), but skips everything after it. Deterministic:
30
29
  * file paths are deduplicated and sorted before hashing, so the result never
@@ -37,7 +36,7 @@ export interface ComputeSourceFingerprintOptions {
37
36
  * evidence artifact.
38
37
  */
39
38
  export declare function computeSourceFingerprint(options: ComputeSourceFingerprintOptions): Promise<string>;
40
- /** Writes `fingerprint`'s paired sidecar for `evidencePath`: call immediately after writing the evidence artifact itself, so the two files always describe the same moment in the source tree's history. */
39
+ /** Writes `fingerprint`'s paired sidecar for `evidencePath`. Call it right after writing the evidence artifact, so both files describe the same moment in the source tree. */
41
40
  export declare function writeEvidenceFingerprint(evidencePath: string, fingerprint: string, fs: BuildFileSystem): Promise<void>;
42
41
  /** Options for {@link getEvidenceModel}: every `generateEvidenceModel()` option, plus where the cached artifact lives. */
43
42
  export interface GetEvidenceModelOptions extends GenerateEvidenceModelOptions {
@@ -54,12 +53,11 @@ export interface GetEvidenceModelResult {
54
53
  }
55
54
  /**
56
55
  * Trusts the committed evidence artifact at `options.location` only when its
57
- * paired `.fingerprint` sidecar matches a freshly (cheaply) computed
58
- * {@link computeSourceFingerprint}: never on file presence alone, never on
59
- * a timestamp. On any mismatch (stale fingerprint, missing/corrupt evidence
60
- * file, no fingerprint sidecar at all), falls back to a real
61
- * `generateEvidenceModel()` call: never hard-fails, never silently serves
62
- * data that might be stale.
56
+ * paired `.fingerprint` sidecar matches a fresh {@link computeSourceFingerprint}.
57
+ * File presence or a timestamp never earns that trust. On any mismatch (a
58
+ * stale fingerprint, a missing or corrupt evidence file, no sidecar), it falls
59
+ * back to a real `generateEvidenceModel()` call. So it never fails hard and
60
+ * never serves stale data.
63
61
  *
64
62
  * @remarks
65
63
  * Never writes anything. A cache miss here does not self-heal the cache.
@@ -1 +1 @@
1
- {"version":3,"file":"evidence-cache.d.ts","sourceRoot":"","sources":["../../../src/build/evidence-cache.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAKxD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAA;AAO1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;;;;;;;GAUG;AAEH,oDAAoD;AACpD,MAAM,WAAW,+BAA+B;IAC9C,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAA;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;CAClD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,MAAM,CAAC,CA4CjB;AAMD,4MAA4M;AAC5M,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,eAAe,GAClB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,0HAA0H;AAC1H,MAAM,WAAW,uBAAwB,SAAQ,4BAA4B;IAC3E,+NAA+N;IAC/N,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,8CAA8C;AAC9C,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;IAChC,wKAAwK;IACxK,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAA;IAC/B,0GAA0G;IAC1G,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;CACxC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CAuDjC"}
1
+ {"version":3,"file":"evidence-cache.d.ts","sourceRoot":"","sources":["../../../src/build/evidence-cache.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAKxD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAA;AAO1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;;;;;;GASG;AAEH,oDAAoD;AACpD,MAAM,WAAW,+BAA+B;IAC9C,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAA;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;CAClD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,MAAM,CAAC,CA4CjB;AAMD,8KAA8K;AAC9K,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,eAAe,GAClB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,0HAA0H;AAC1H,MAAM,WAAW,uBAAwB,SAAQ,4BAA4B;IAC3E,+NAA+N;IAC/N,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,8CAA8C;AAC9C,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;IAChC,wKAAwK;IACxK,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAA;IAC/B,0GAA0G;IAC1G,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;CACxC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CAuDjC"}
@@ -6,8 +6,8 @@ import type { LifecycleModel } from "./lifecycle-model.js";
6
6
  import type { OwnershipModel } from "./ownership-model.js";
7
7
  /**
8
8
  * Bump only when a reader could misinterpret the new shape of `EvidenceModel`
9
- * itself (not any one sub-model's own `<MODEL>_SCHEMA_VERSION`, which is
10
- * versioned independently): same rule every other canonical model follows.
9
+ * itself. Each sub-model's `<MODEL>_SCHEMA_VERSION` is versioned separately.
10
+ * Every other canonical model follows the same rule.
11
11
  */
12
12
  export declare const EVIDENCE_MODEL_SCHEMA_VERSION = 1;
13
13
  /**
@@ -27,11 +27,10 @@ export interface EvidenceProvenance {
27
27
  * ADR 0031).
28
28
  *
29
29
  * @remarks
30
- * This type is the one intentional exception to `src/build/`'s zero-
31
- * cross-folder-import rule: `src/evidence/` imports it with `import type`
32
- * only (fully erased at compile time under `verbatimModuleSyntax`), the same
33
- * shape as `helpers`' single sanctioned edge onto `runtime`; see
34
- * `specs/architecture.md`. `src/evidence/` never imports a *value* from
30
+ * This type is the one exception to the rule that nothing imports across
31
+ * `src/build/`. `src/evidence/` imports it with `import type` only, which
32
+ * `verbatimModuleSyntax` erases at compile time. The sanctioned edge from
33
+ * `helpers` onto `runtime` has the same shape (see `specs/architecture.md`). `src/evidence/` never imports a *value* from
35
34
  * here, only this shape, so it stays isomorphic and Node-free. An actual
36
35
  * `EvidenceModel` instance is produced by {@link generateEvidenceModel}
37
36
  * (`@maverickcer/env-cap/build`, Node-only), which runs discovery once,
@@ -1 +1 @@
1
- {"version":3,"file":"evidence-model.d.ts","sourceRoot":"","sources":["../../../src/build/evidence-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,IAAI,CAAA;AAE9C;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CACpC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,aAAa,EAAE,OAAO,6BAA6B,CAAA;IAC5D,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAA;IACvC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;IAChC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAA;IACpC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAA;IAClC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAA;IAClC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;IAC9B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAC7B"}
1
+ {"version":3,"file":"evidence-model.d.ts","sourceRoot":"","sources":["../../../src/build/evidence-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,IAAI,CAAA;AAE9C;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CACpC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,aAAa,EAAE,OAAO,6BAA6B,CAAA;IAC5D,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAA;IACvC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;IAChC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAA;IACpC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAA;IAClC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAA;IAClC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;IAC9B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAC7B"}
@@ -15,7 +15,7 @@ import type { SourcePosition } from "./source-position.js";
15
15
  export type EvidenceReference = ContractEvidenceReference | OwnershipEvidenceReference | ChangeEvidenceReference;
16
16
  /**
17
17
  * The one shape every model in this package uses to point at a declared
18
- * contract: the file it's declared in, and the binding it's exported as.
18
+ * contract: its file and its exported binding.
19
19
  * Nothing else: see ADR 0039.
20
20
  *
21
21
  * @remarks
@@ -23,10 +23,10 @@ export type EvidenceReference = ContractEvidenceReference | OwnershipEvidenceRef
23
23
  * concern. A renderer that needs prose resolves it on demand from
24
24
  * `ContractModel`, the one model that owns it. A copy on every reference
25
25
  * would go stale independently, since the name can change under a
26
- * `documentEnv()` edit. Deliberately not carrying a
27
- * pre-formatted `identity` string either: `${file}#${exportName}` is
28
- * trivially derivable, and a stored copy is one more thing that can disagree
29
- * with the two fields it was built from. Code that genuinely needs a map key
26
+ * `documentEnv()` edit. It carries no pre-formatted
27
+ * `identity` string either, since `${file}#${exportName}` is derivable. A
28
+ * stored copy could disagree with the two fields it was built from. Code that
29
+ * needs a map key
30
30
  * builds that string locally, at the point of use.
31
31
  */
32
32
  export interface ContractRef {
@@ -44,7 +44,7 @@ export interface ContractEvidenceReference {
44
44
  readonly exportName: string | undefined;
45
45
  /** The environment variable name, when the finding is variable-level rather than contract-level. */
46
46
  readonly variable: string | undefined;
47
- /** Exact file:line:column this finding is about; the contract's `createEnv()` declaration, its `documentEnv()` declaration, or the specific variable's own declaration, whichever is most relevant to the finding. `undefined` only when no single position is more relevant than another (e.g. an `indeterminate-ownership` finding, which can have multiple candidate sites: see `IndeterminateOwnershipFinding.dynamicAccessSites` for the full list instead). See ADR 0036. */
47
+ /** Exact file:line:column this finding is about. It is the contract's `createEnv()` declaration, its `documentEnv()` declaration or the variable's declaration, whichever is most relevant. `undefined` only when no single position is more relevant than another. An `indeterminate-ownership` finding is one: `IndeterminateOwnershipFinding.dynamicAccessSites` lists its candidate sites. See ADR 0036. */
48
48
  readonly position: SourcePosition | undefined;
49
49
  }
50
50
  /** Points at a contract by name for an ownership/usage finding: `usage-report.ts`'s finding types don't consistently carry `file`/`exportName` together, only `contractName`. */
@@ -1 +1 @@
1
- {"version":3,"file":"evidence-reference.d.ts","sourceRoot":"","sources":["../../../src/build/evidence-reference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,iBAAiB,GAC3B,yBAAyB,GAAG,0BAA0B,GAAG,uBAAuB,CAAA;AAElF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,WAAW;IAC1B,mGAAmG;IACnG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,gEAAgE;IAChE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED,+TAA+T;AAC/T,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,+GAA+G;IAC/G,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,oGAAoG;IACpG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,mdAAmd;IACnd,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;CAC9C;AAED,iLAAiL;AACjL,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,kGAAkG;IAClG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,oGAAoG;IACpG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;CAC9C;AAED,gJAAgJ;AAChJ,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;IACxB,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB"}
1
+ {"version":3,"file":"evidence-reference.d.ts","sourceRoot":"","sources":["../../../src/build/evidence-reference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,iBAAiB,GAC3B,yBAAyB,GAAG,0BAA0B,GAAG,uBAAuB,CAAA;AAElF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,WAAW;IAC1B,mGAAmG;IACnG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,gEAAgE;IAChE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED,+TAA+T;AAC/T,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,+GAA+G;IAC/G,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,oGAAoG;IACpG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,gZAAgZ;IAChZ,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;CAC9C;AAED,iLAAiL;AACjL,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,kGAAkG;IAClG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,oGAAoG;IACpG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;CAC9C;AAED,gJAAgJ;AAChJ,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;IACxB,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB"}
@@ -5,9 +5,9 @@ import type { DiscoveredContract } from "./link.js";
5
5
  * e.g. two interchangeable database backends both left enabled at once.
6
6
  *
7
7
  * @remarks
8
- * Unlike `detectCompatibilityIssues`, this is never a heuristic warning: an
9
- * author explicitly declared these contracts mutually exclusive, so any
10
- * violation is always a hard error, regardless of `onIncompatibility`. See
8
+ * Unlike `detectCompatibilityIssues`, this is never a heuristic warning. An
9
+ * author declared these contracts mutually exclusive, so a violation is
10
+ * always a hard error, whatever `onIncompatibility` says. See
11
11
  * ADR 0009 for why this doesn't follow 0005's warn-by-default policy.
12
12
  *
13
13
  * Inactive contracts are ignored entirely here (filtered internally, not by
@@ -6,9 +6,9 @@ import type { DynamicAccessCitationProblem } from "./citation-verification.js";
6
6
  import type { AbandonedContractFinding, IndeterminateOwnershipFinding, UnconsumedOwnedVariableFinding, UnresolvedConsumerFinding } from "./usage-report.js";
7
7
  /**
8
8
  * The fourth of env-cap's seven canonical fact models (ADR 0024): every
9
- * rule violation and derived risk signal, unified behind one shape, with a
10
- * stable `code` and a structured {@link EvidenceReference} instead of four
11
- * independently-shaped finding families. See ADR 0026.
9
+ * rule violation and derived risk signal behind one shape. Each has a stable
10
+ * `code` and a structured {@link EvidenceReference}, replacing four
11
+ * differently shaped finding families. See ADR 0026.
12
12
  */
13
13
  /** Every stable `code` a {@link Finding} can carry. A superset of {@link CompatibilityIssueCode} plus one code per non-compatibility source family this model adapts. */
14
14
  export type FindingCode = CompatibilityIssueCode | "EXCLUSIVE_GROUP_VIOLATION" | "ARTIFACT_STALE" | "ARTIFACT_MISSING" | "UNDOCUMENTED_CONTRACT" | "UNDOCUMENTED_VARIABLE" | "STALE_DOC_ENTRY" | "EXPIRED" | "EXPIRING_SOON" | "UNRESOLVED_DOCUMENTENV_LINK" | "ABANDONED_CONTRACT" | "UNRESOLVED_CONSUMER" | "UNCONSUMED_OWNED_VARIABLE" | "INDETERMINATE_OWNERSHIP" | "MISSING_DYNAMIC_ACCESS_CITATION" | "STALE_DYNAMIC_ACCESS_CITATION" | "NONSTANDARD_SENSITIVITY_LEVEL";
@@ -17,12 +17,11 @@ export type FindingFamily = "compatibility" | "drift" | "documentation" | "owner
17
17
  /** One rule violation or derived signal, in the Finding Model's canonical shape. */
18
18
  export interface Finding {
19
19
  /**
20
- * `"error"` for a provable, always-blocking violation (e.g. an
21
- * exclusive-group conflict); `"warning"` for everything gated by
22
- * `onIncompatibility`/`onUndocumented`/`onOwnershipIssue`'s default "warn"
23
- * behavior; `"info"` for an observation that is never actionable enough to
24
- * block anything, even under `--strict`: see `INFO_ONLY_CODES` in
25
- * `generate-env-artifacts.ts`.
20
+ * `"error"` for a provable, always-blocking violation, such as an
21
+ * exclusive-group conflict. `"warning"` for everything gated by the default
22
+ * "warn" of `onIncompatibility`/`onUndocumented`/`onOwnershipIssue`.
23
+ * `"info"` for an observation that never blocks, even under `--strict` (see
24
+ * `INFO_ONLY_CODES` in `generate-env-artifacts.ts`).
26
25
  */
27
26
  readonly severity: "error" | "warning" | "info";
28
27
  /** Stable, machine-readable identifier: always set, unlike {@link CompatibilityIssue.code} which stays optional on that narrower, pre-existing type. */
@@ -42,10 +41,10 @@ export interface FindingModel {
42
41
  readonly findings: readonly Finding[];
43
42
  }
44
43
  /**
45
- * Every source a {@link buildFindingModel} call can adapt, all optional:
46
- * a caller passes whichever of `generateEnvArtifacts()`'s `manifest`/`docs`/
47
- * `usage` results it actually requested, exactly like that result's own
48
- * top-level fields are each independently optional.
44
+ * Every source a {@link buildFindingModel} call can adapt, all optional. A
45
+ * caller passes whichever `manifest`/`docs`/`usage` results of
46
+ * `generateEnvArtifacts()` it requested. Those top-level result fields are
47
+ * optional in the same way.
49
48
  */
50
49
  export interface BuildFindingModelInput {
51
50
  /** Every `EvidenceReference.file` below is rendered relative to this, matching every other rendered path in this package's output: see `displayPath()`. */
@@ -1 +1 @@
1
- {"version":3,"file":"finding-model.d.ts","sourceRoot":"","sources":["../../../src/build/finding-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAEpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AACxE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAA;AAC9E,OAAO,KAAK,EACV,wBAAwB,EACxB,6BAA6B,EAC7B,8BAA8B,EAC9B,yBAAyB,EAC1B,MAAM,mBAAmB,CAAA;AAE1B;;;;;GAKG;AAEH,yKAAyK;AACzK,MAAM,MAAM,WAAW,GACnB,sBAAsB,GACtB,2BAA2B,GAC3B,gBAAgB,GAChB,kBAAkB,GAClB,uBAAuB,GACvB,uBAAuB,GACvB,iBAAiB,GACjB,SAAS,GACT,eAAe,GACf,6BAA6B,GAC7B,oBAAoB,GACpB,qBAAqB,GACrB,2BAA2B,GAC3B,yBAAyB,GACzB,iCAAiC,GACjC,+BAA+B,GAC/B,+BAA+B,CAAA;AAEnC,+MAA+M;AAC/M,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,OAAO,GAAG,eAAe,GAAG,WAAW,CAAA;AAErF,oFAAoF;AACpF,MAAM,WAAW,OAAO;IACtB;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;IAC/C,wJAAwJ;IACxJ,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,2FAA2F;IAC3F,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;CACrC;AAED,uIAAuI;AACvI,eAAO,MAAM,4BAA4B,IAAI,CAAA;AAE7C,kOAAkO;AAClO,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,aAAa,EAAE,OAAO,4BAA4B,CAAA;IAC3D,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;CACtC;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,2JAA2J;IAC3J,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,0CAA0C;IAC1C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAC5D,kNAAkN;IAClN,QAAQ,CAAC,oBAAoB,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAC7D,mIAAmI;IACnI,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAA;IAChE,+CAA+C;IAC/C,QAAQ,CAAC,aAAa,CAAC,EAAE,qBAAqB,CAAA;IAC9C,6CAA6C;IAC7C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAA;IACjE,6CAA6C;IAC7C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAA;IACnE,6CAA6C;IAC7C,QAAQ,CAAC,wBAAwB,CAAC,EAAE,SAAS,8BAA8B,EAAE,CAAA;IAC7E,6CAA6C;IAC7C,QAAQ,CAAC,sBAAsB,CAAC,EAAE,SAAS,6BAA6B,EAAE,CAAA;IAC1E,kKAAkK;IAClK,QAAQ,CAAC,6BAA6B,CAAC,EAAE,SAAS,4BAA4B,EAAE,GAAG,SAAS,CAAA;CAC7F;AAoCD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,YAAY,CAwN7E"}
1
+ {"version":3,"file":"finding-model.d.ts","sourceRoot":"","sources":["../../../src/build/finding-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAEpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AACxE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAA;AAC9E,OAAO,KAAK,EACV,wBAAwB,EACxB,6BAA6B,EAC7B,8BAA8B,EAC9B,yBAAyB,EAC1B,MAAM,mBAAmB,CAAA;AAE1B;;;;;GAKG;AAEH,yKAAyK;AACzK,MAAM,MAAM,WAAW,GACnB,sBAAsB,GACtB,2BAA2B,GAC3B,gBAAgB,GAChB,kBAAkB,GAClB,uBAAuB,GACvB,uBAAuB,GACvB,iBAAiB,GACjB,SAAS,GACT,eAAe,GACf,6BAA6B,GAC7B,oBAAoB,GACpB,qBAAqB,GACrB,2BAA2B,GAC3B,yBAAyB,GACzB,iCAAiC,GACjC,+BAA+B,GAC/B,+BAA+B,CAAA;AAEnC,+MAA+M;AAC/M,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,OAAO,GAAG,eAAe,GAAG,WAAW,CAAA;AAErF,oFAAoF;AACpF,MAAM,WAAW,OAAO;IACtB;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;IAC/C,wJAAwJ;IACxJ,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,2FAA2F;IAC3F,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;CACrC;AAED,uIAAuI;AACvI,eAAO,MAAM,4BAA4B,IAAI,CAAA;AAE7C,kOAAkO;AAClO,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,aAAa,EAAE,OAAO,4BAA4B,CAAA;IAC3D,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;CACtC;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,2JAA2J;IAC3J,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,0CAA0C;IAC1C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAC5D,kNAAkN;IAClN,QAAQ,CAAC,oBAAoB,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAC7D,mIAAmI;IACnI,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAA;IAChE,+CAA+C;IAC/C,QAAQ,CAAC,aAAa,CAAC,EAAE,qBAAqB,CAAA;IAC9C,6CAA6C;IAC7C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAA;IACjE,6CAA6C;IAC7C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAA;IACnE,6CAA6C;IAC7C,QAAQ,CAAC,wBAAwB,CAAC,EAAE,SAAS,8BAA8B,EAAE,CAAA;IAC7E,6CAA6C;IAC7C,QAAQ,CAAC,sBAAsB,CAAC,EAAE,SAAS,6BAA6B,EAAE,CAAA;IAC1E,kKAAkK;IAClK,QAAQ,CAAC,6BAA6B,CAAC,EAAE,SAAS,4BAA4B,EAAE,GAAG,SAAS,CAAA;CAC7F;AAoCD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,YAAY,CAwN7E"}
@@ -43,7 +43,7 @@ export interface GenerateDocumentationOptions {
43
43
  */
44
44
  liveExpirationDates?: LiveExpirationDates | undefined;
45
45
  }
46
- /** Everything {@link generateDocumentation} found that isn't fully documented or up to date: never blocks generation; a team that wants to gate CI on this reads `Finding[]` (the "documentation" family) from the persisted evidence artifact and decides for itself. See ADR 0038. */
46
+ /** Everything {@link generateDocumentation} found that isn't fully documented or up to date. It never blocks generation. To gate CI on it, read the "documentation" family of `Finding[]` from the persisted evidence artifact. See ADR 0038. */
47
47
  export interface DocumentationFindings {
48
48
  /** Contracts with no linked `documentEnv()` call at all. */
49
49
  readonly undocumentedContracts: readonly {
@@ -128,10 +128,9 @@ export interface NonstandardSensitivityEntry {
128
128
  *
129
129
  * @remarks
130
130
  * A variable's *own* declared level only: never the contract-inherited one
131
- * `effectiveSensitivity()` would resolve to. Reporting the inherited value
132
- * would fire this same finding once per variable on a contract that already
133
- * produced its own contract-level entry, turning one real vocabulary
134
- * question into N duplicates of it.
131
+ * `effectiveSensitivity()` would resolve to. The contract already has its
132
+ * own contract-level entry. Reporting the inherited value would repeat that
133
+ * one vocabulary question once per variable.
135
134
  */
136
135
  export declare function findNonstandardSensitivityLevels(contracts: readonly DiscoveredContract[]): NonstandardSensitivityEntry[];
137
136
  export interface DocumentationComputation {
@@ -160,8 +159,8 @@ export declare function writeDocumentation(docsPath: string, envExamplePath: str
160
159
  envExample: EnvExampleResult | undefined;
161
160
  }>;
162
161
  /**
163
- * Build-time only. Discovers and links `env.schema.ts` files (same static
164
- * analysis as {@link generateEnvManifest}) and writes the rich Markdown
162
+ * Build-time only. Discovers and links `env.schema.ts` files, with the static
163
+ * analysis of {@link generateEnvManifest}. Then it writes the Markdown
165
164
  * "Catalog": every variable, its description, default, processor/validator
166
165
  * flags, owner, and expiry. Application developers use it as the single
167
166
  * onboarding reference for what configuration a feature needs and how to set
@@ -1 +1 @@
1
- {"version":3,"file":"generate-documentation.d.ts","sourceRoot":"","sources":["../../../src/build/generate-documentation.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"generate-documentation.d.ts","sourceRoot":"","sources":["../../../src/build/generate-documentation.ts"],"names":[],"mappings":"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"}
@@ -16,10 +16,10 @@ export interface GenerateEvidenceModelOptions {
16
16
  /** See `GenerateEnvManifestOptions.tsconfig`. See ADR 0023. */
17
17
  tsconfig?: string | false | undefined;
18
18
  /**
19
- * Where a previously-persisted evidence artifact lives, relative to
20
- * `root`: read (never written) as the baseline Change Model diffs
21
- * against and dynamic-access citation freshness (ADR 0037) compares
22
- * content hashes to. Independent of any `.ts` manifest a project may or
19
+ * Where a previously persisted evidence artifact lives, relative to
20
+ * `root`. It is read, never written. Change Model diffs against it, and
21
+ * dynamic-access citation freshness (ADR 0037) compares content hashes
22
+ * with it. Independent of any `.ts` manifest a project may or
23
23
  * may not also generate: there is no derivation from a manifest's own
24
24
  * location. Omitted: treated as the normal first-run state (everything
25
25
  * reads as added, no citation-freshness baseline to compare against),
@@ -30,9 +30,9 @@ export interface GenerateEvidenceModelOptions {
30
30
  expiringWithinDays?: number | undefined;
31
31
  /**
32
32
  * Supplies expiration metadata from a live source as a post-discovery
33
- * override, applied to Lifecycle Model's (and Finding Model's
34
- * `expiring-soon` findings') data only: Contract Model still reflects the
35
- * schema's own static `expiresAt`. See `live-expirations.ts` and ADR 0012.
33
+ * override. It applies only to Lifecycle Model and Finding Model's
34
+ * `expiring-soon` findings. Contract Model still reflects the schema's
35
+ * static `expiresAt`. See `live-expirations.ts` and ADR 0012.
36
36
  */
37
37
  liveExpirationDates?: LiveExpirationDates | undefined;
38
38
  /**
@@ -53,10 +53,9 @@ export interface GenerateEvidenceModelOptions {
53
53
  * before being returned.
54
54
  *
55
55
  * @remarks
56
- * Deliberately never throws on a data-quality finding (a compatibility
57
- * issue, an undocumented variable, an abandoned contract, ...): every one
58
- * of those becomes a `Finding` in the returned model's `finding` field
59
- * instead. This differs from `generateEnvManifest()`, which throws by
56
+ * Never throws on a data-quality finding, such as a compatibility issue,
57
+ * an undocumented variable or an abandoned contract. Each becomes a
58
+ * `Finding` in the returned model's `finding` field instead. This differs from `generateEnvManifest()`, which throws by
60
59
  * default, because that is a "should I write this artifact" gate. Evidence
61
60
  * Model assembly is a read-only snapshot. Its purpose is to represent such
62
61
  * issues as data for a consumer's own projection to act on (see ADR 0024's
@@ -64,10 +63,9 @@ export interface GenerateEvidenceModelOptions {
64
63
  * `EnvProjectGenerationError` for a genuine configuration error:
65
64
  * `previousSnapshotLocation` escaping `root`.
66
65
  *
67
- * The dependency-graph scan underlying Dependency Model (via
68
- * `buildDependencyModel()`) and the one underlying Finding Model's
69
- * ownership-related findings (via `computeUsage()`) each run their own,
70
- * independent pass over the repository. That cost is accepted: each half's
66
+ * Dependency Model (via `buildDependencyModel()`) and Finding Model's
67
+ * ownership findings (via `computeUsage()`) each run a dependency-graph scan.
68
+ * The two scans are separate passes over the repository. That cost is accepted: each half's
71
69
  * already-tested public building block is called directly, rather than a
72
70
  * second copy of either's logic being hand-derived here. Both are Node-only,
73
71
  * dev/CI-time-only work (never a runtime hot path), so the redundant I/O is
@@ -1 +1 @@
1
- {"version":3,"file":"generate-evidence.d.ts","sourceRoot":"","sources":["../../../src/build/generate-evidence.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAYxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAEhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,iDAAiD;AACjD,MAAM,WAAW,4BAA4B;IAC3C,+EAA+E;IAC/E,EAAE,EAAE,eAAe,CAAA;IACnB,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC9B,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IACxC,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAA;IACrC;;;;;;;;;OASG;IACH,wBAAwB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7C,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAA;IACrD;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG,SAAS,CAAA;CACzD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,aAAa,CAAC,CAyHxB"}
1
+ {"version":3,"file":"generate-evidence.d.ts","sourceRoot":"","sources":["../../../src/build/generate-evidence.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAYxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAEhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,iDAAiD;AACjD,MAAM,WAAW,4BAA4B;IAC3C,+EAA+E;IAC/E,EAAE,EAAE,eAAe,CAAA;IACnB,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC9B,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IACxC,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAA;IACrC;;;;;;;;;OASG;IACH,wBAAwB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7C,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAA;IACrD;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG,SAAS,CAAA;CACzD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,aAAa,CAAC,CAyHxB"}
@@ -15,11 +15,10 @@ export interface GenerateEnvManifestOptions {
15
15
  /** Glob patterns to exclude. Defaults to node_modules/dist/.git. */
16
16
  exclude?: string[] | undefined;
17
17
  /**
18
- * Explicit allowlist of installed
19
- * package names whose declared `"envCap": { "schema": "<path>" }` entry
20
- * point should also be discovered, so a contract that ships as its own
21
- * separately-published package (no monorepo required) can be included in
22
- * the manifest. Opt-in only: a package is never considered unless its
18
+ * Explicit allowlist of installed package names whose declared
19
+ * `"envCap": { "schema": "<path>" }` entry point is also discovered. It lets
20
+ * the manifest include a contract published as a separate package, with no
21
+ * monorepo required. Opt-in only: a package is never considered unless its
23
22
  * exact name appears here. See ADR 0014.
24
23
  */
25
24
  packages?: readonly string[] | undefined;
@@ -28,9 +27,9 @@ export interface GenerateEnvManifestOptions {
28
27
  * whose `compilerOptions.paths`/`baseUrl` resolve aliased import specifiers (e.g.
29
28
  * `"@/lib/env.schema.js"`) encountered during static analysis, so a contract or consumer
30
29
  * reached only through an alias isn't misreported as abandoned/unresolved. Defaults to
31
- * `"tsconfig.json"` at `root`: on automatically, no opt-in required, since (unlike
32
- * `packages`) this never crosses a trust/versioning boundary: every resolved file is
33
- * already local, already-trusted project source. Pass `false` to disable entirely. See
30
+ * `"tsconfig.json"` at `root`, so it is on with no opt-in. Unlike `packages`, it never
31
+ * crosses a trust or versioning boundary: every resolved file is local, trusted project
32
+ * source. Pass `false` to disable entirely. See
34
33
  * ADR 0023.
35
34
  */
36
35
  tsconfig?: string | false | undefined;
@@ -83,16 +82,15 @@ export declare function computeManifest(root: string, linkResult: LinkResult, on
83
82
  /** Writes the manifest file. Callers must have already confirmed `outputPath` is safe and nothing is blocking. */
84
83
  export declare function writeManifest(outputPath: string, activeContracts: readonly DiscoveredContract[], fs: BuildFileSystem): Promise<void>;
85
84
  /**
86
- * Build-time only. Discovers `env.schema.ts` files, statically analyzes them
87
- * (never executes them) to link `createEnv()`/`documentEnv()` calls, checks
88
- * for provable incompatibilities between duplicate variable declarations,
89
- * and writes a deterministic manifest file that re-exports every discovered
90
- * active contract.
85
+ * Build-time only. Discovers `env.schema.ts` files and analyzes them
86
+ * statically, never executing them, to link `createEnv()`/`documentEnv()`
87
+ * calls. It checks duplicate variable declarations for provable
88
+ * incompatibilities. Then it writes a deterministic manifest file that
89
+ * re-exports every discovered active contract.
91
90
  *
92
91
  * @remarks
93
- * Never call this at application startup or import it from
94
- * runtime code: wire it into an npm script, a bundler plugin, or a CI
95
- * step instead.
92
+ * Run it from an npm script, a bundler plugin or a CI step. Application
93
+ * startup and runtime code never call or import it.
96
94
  *
97
95
  * @throws {EnvManifestGenerationError} If `location` escapes `root`, or if a blocking compatibility/exclusive-group issue is found.
98
96
  */
@@ -1 +1 @@
1
- {"version":3,"file":"generate-manifest.d.ts","sourceRoot":"","sources":["../../../src/build/generate-manifest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAG5D,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,UAAU,EAChB,MAAM,WAAW,CAAA;AAElB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAG9C,+CAA+C;AAC/C,MAAM,WAAW,0BAA0B;IACzC,+EAA+E;IAC/E,EAAE,EAAE,eAAe,CAAA;IACnB,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,yGAAyG;IACzG,QAAQ,EAAE,MAAM,CAAA;IAChB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC9B,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC9B;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IACxC;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAA;IACrC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;CACjD;AAED,iEAAiE;AACjE,MAAM,WAAW,yBAAyB;IACxC,sDAAsD;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,SAAS,yBAAyB,EAAE,CAAA;IACxD,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAChD,4GAA4G;IAC5G,QAAQ,CAAC,aAAa,EAAE,SAAS,YAAY,EAAE,CAAA;CAChD;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAEzC;AACD,8GAA8G;AAC9G,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAczC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,eAAe,EAAE,SAAS,kBAAkB,EAAE,CAAA;IACvD,QAAQ,CAAC,iBAAiB,EAAE,SAAS,yBAAyB,EAAE,CAAA;IAChE,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAChD,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAA;CACjD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,EACtB,iBAAiB,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAC9C,mBAAmB,CAwBrB;AAED,kHAAkH;AAClH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,SAAS,kBAAkB,EAAE,EAC9C,EAAE,EAAE,eAAe,GAClB,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,CAAC,CAoCpC"}
1
+ {"version":3,"file":"generate-manifest.d.ts","sourceRoot":"","sources":["../../../src/build/generate-manifest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAG5D,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,UAAU,EAChB,MAAM,WAAW,CAAA;AAElB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAG9C,+CAA+C;AAC/C,MAAM,WAAW,0BAA0B;IACzC,+EAA+E;IAC/E,EAAE,EAAE,eAAe,CAAA;IACnB,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,yGAAyG;IACzG,QAAQ,EAAE,MAAM,CAAA;IAChB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC9B,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC9B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IACxC;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAA;IACrC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;CACjD;AAED,iEAAiE;AACjE,MAAM,WAAW,yBAAyB;IACxC,sDAAsD;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,SAAS,yBAAyB,EAAE,CAAA;IACxD,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAChD,4GAA4G;IAC5G,QAAQ,CAAC,aAAa,EAAE,SAAS,YAAY,EAAE,CAAA;CAChD;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAEzC;AACD,8GAA8G;AAC9G,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAWzC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,eAAe,EAAE,SAAS,kBAAkB,EAAE,CAAA;IACvD,QAAQ,CAAC,iBAAiB,EAAE,SAAS,yBAAyB,EAAE,CAAA;IAChE,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAChD,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAA;CACjD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,EACtB,iBAAiB,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAC9C,mBAAmB,CAwBrB;AAED,kHAAkH;AAClH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,SAAS,kBAAkB,EAAE,EAC9C,EAAE,EAAE,eAAe,GAClB,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,CAAC,CAoCpC"}
@@ -1,7 +1,7 @@
1
1
  /**
2
- * Regeneration instruction for a report the CLI does not write (ADR 0046): it is produced by the project's own
3
- * script calling the `@maverickcer/env-cap/build` generators, so naming `npx env-cap` there would send a reader to a command that
4
- * cannot regenerate it.
2
+ * Regeneration instruction for a report the CLI does not write (ADR 0046). The project's script produces it
3
+ * with the `@maverickcer/env-cap/build` generators. Naming `npx env-cap` would send a reader to a command
4
+ * that cannot regenerate it.
5
5
  * @returns The instruction, as a sentence.
6
6
  */
7
7
  export declare function reportRegenerateHint(): string;
@@ -26,9 +26,9 @@ export interface EnvGovernanceFields {
26
26
  }
27
27
  /**
28
28
  * Copies exactly the `EnvGovernanceFields` out of a value that carries
29
- * them: for projecting one pipeline stage's contract/variable into the next
30
- * (`link` -> `contract-model` -> `docs` catalog, ...) without re-listing all
31
- * nine fields at every hop.
29
+ * them. Each pipeline stage (`link` -> `contract-model` -> `docs` catalog,
30
+ * ...) projects its contract or variable into the next without re-listing
31
+ * all nine fields.
32
32
  */
33
33
  export declare function governanceFieldsOf(source: EnvGovernanceFields): EnvGovernanceFields;
34
34
  //# sourceMappingURL=governance-fields.d.ts.map
@@ -5,9 +5,9 @@
5
5
  */
6
6
  export declare function humanizeKey(key: string): string;
7
7
  /**
8
- * Formats a `metadata`/`dataResidency` value for display in generated docs/examples: a string
9
- * renders as-is; anything else (ADR 0035 widened `metadata` to any value) renders as its JSON
10
- * text, so an object/array value never prints `[object Object]`. Shared by `docs.ts` and
8
+ * Formats a `metadata`/`dataResidency` value for display in generated docs/examples. A string
9
+ * renders as-is. Anything else renders as its JSON text, since ADR 0035 widened `metadata` to
10
+ * any value. So an object or array never prints `[object Object]`. Shared by `docs.ts` and
11
11
  * `env-example.ts`, same rationale as {@link humanizeKey}.
12
12
  */
13
13
  export declare function renderMetadataValue(value: unknown): string;
@@ -158,9 +158,9 @@ export declare function parseRotationPeriodDays(value: string): number | undefin
158
158
  * `lastRotatedAt` and/or `rotationTriggerEvents`), with no `rotationPeriod` and no past-due
159
159
  * `expiresAt`. Nothing states a time-based obligation this variable could be failing to meet.
160
160
  *
161
- * `rotationTriggerEvents` (the event-based trigger) deliberately never changes the returned status
162
- * by itself. env-cap cannot observe whether a listed event (a suspected compromise, a personnel
163
- * change, ...) actually occurred. Treating its mere presence as either compliant or overdue would
161
+ * `rotationTriggerEvents` (the event-based trigger) never changes the returned status by itself.
162
+ * Nothing in env-cap can observe whether a listed event occurred, such as a suspected compromise or
163
+ * a personnel change. Treating its mere presence as either compliant or overdue would
164
164
  * fabricate a signal. It's presence-only evidence that the event-based half of IA-5's
165
165
  * two-trigger model was at least *declared*. A generator should still surface it, but never fold
166
166
  * it into this computed status.
@@ -11,8 +11,8 @@ export type LiteralEvalResult = {
11
11
  value?: undefined;
12
12
  };
13
13
  /**
14
- * Structurally evaluates a *literal* AST expression (strings, numbers, booleans, null, arrays,
15
- * and object literals of the same) into a real JS value: without ever executing code.
14
+ * Structurally evaluates a *literal* AST expression into a real JS value, without executing code.
15
+ * Literals are strings, numbers, booleans, null, and arrays and object literals of those.
16
16
  *
17
17
  * @remarks
18
18
  * Anything that isn't a literal (identifiers, calls, imports, template expressions with
@@ -1 +1 @@
1
- {"version":3,"file":"literal-eval.d.ts","sourceRoot":"","sources":["../../../src/build/literal-eval.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAA;AAEhC;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,CAAA;AAE/F;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,GAAG,iBAAiB,CA4CtE;AAED,8KAA8K;AAC9K,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,GAAG,MAAM,GAAG,SAAS,CAK/E"}
1
+ {"version":3,"file":"literal-eval.d.ts","sourceRoot":"","sources":["../../../src/build/literal-eval.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAA;AAEhC;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,CAAA;AAE/F;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,GAAG,iBAAiB,CA2CtE;AAED,8KAA8K;AAC9K,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,GAAG,MAAM,GAAG,SAAS,CAK/E"}
@@ -1,8 +1,8 @@
1
1
  import type { DiscoveredContract } from "./link.js";
2
2
  /**
3
- * Supplies expiration metadata from a live source (a secrets manager, an
4
- * internal inventory API, ...) as a post-discovery override: the one
5
- * sanctioned escape hatch from static-only `expiresAt`.
3
+ * Supplies expiration metadata from a live source, such as a secrets manager
4
+ * or an inventory API, as a post-discovery override. It is the one sanctioned
5
+ * 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/
@@ -25,9 +25,9 @@ export declare function collectVariableNames(contracts: readonly DiscoveredContr
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:
29
- * same "warn/skip, never guess" policy the rest of the generator uses for
30
- * malformed data. Contract-level `expiresAt` is never touched; only
28
+ * ISO-8601 string, leaves that variable's static `expiresAt` untouched. The
29
+ * rest of the generator treats malformed data the same way: warn or skip,
30
+ * never guess. 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[];
@@ -35,9 +35,9 @@ export declare function applyLiveExpirationOverrides(contracts: readonly Discove
35
35
  * Orchestration entry point: the only place `liveExpirationDates` is ever invoked.
36
36
  *
37
37
  * @remarks
38
- * No-ops (returns the exact same array reference, zero invocations)
39
- * when `liveExpirationDates` is undefined, which is what guarantees "omitted ->
40
- * behavior unchanged." Otherwise it collects the unique discovered variable
38
+ * When `liveExpirationDates` is undefined it does nothing: it returns the same
39
+ * array reference and invokes nothing. That keeps behavior unchanged when the
40
+ * option is omitted. Otherwise it collects the unique discovered variable
41
41
  * names, invokes the callback exactly once and applies the result. It
42
42
  * deep-freezes the returned structure so no mutation of it can reach
43
43
  * `contracts` or anything else downstream. `contracts` is used elsewhere too,
@@ -1,9 +1,8 @@
1
1
  import type { DiscoveredContract } from "./link.js";
2
2
  /**
3
3
  * Every validation context declared by any variable in an *active* contract
4
- * in `contracts` (a variable belonging to a contract documented `active:
5
- * false` never contributes: same exclusion the `manifest` array itself
6
- * already applies), sorted and deduplicated. What {@link renderManifest}
4
+ * in `contracts`, sorted and deduplicated. A contract documented
5
+ * `active: false` never contributes, as in the `manifest` array. What {@link renderManifest}
7
6
  * surfaces as the generated `activeContexts` export. Exported for reuse by
8
7
  * anything that needs the same computation (currently just `renderManifest`
9
8
  * itself).
@@ -11,8 +10,8 @@ import type { DiscoveredContract } from "./link.js";
11
10
  export declare function discoverValidationContexts(contracts: readonly DiscoveredContract[]): readonly string[];
12
11
  /**
13
12
  * Renders the deterministic manifest source: sorted imports (aliased on name
14
- * collision) plus a `contracts` array, in the exact banner format schema
15
- * authors will recognize as generated. No timestamps, no randomness: same
13
+ * collision) plus a `contracts` array. The banner marks the file as generated
14
+ * for schema authors. No timestamps, no randomness: same
16
15
  * input files always produce byte-identical output.
17
16
  *
18
17
  * @remarks
@@ -23,9 +22,9 @@ export declare function discoverValidationContexts(contracts: readonly Discovere
23
22
  * `manifest` and pass it straight through: `validateEnv({ manifest, values, activeContexts })`.
24
23
  * It's every context this manifest has, meant as a starting point to narrow
25
24
  * per process/deployment, not a pre-scoped default: see the README's
26
- * "Validation contexts" section. Omitted entirely (not even an empty array)
27
- * when no variable declares a `context` at all, so generated output for
28
- * projects that don't use this feature is untouched.
25
+ * "Validation contexts" section. It is omitted, not even an empty array, when
26
+ * no variable declares a `context`. So projects that don't use contexts get
27
+ * unchanged output.
29
28
  */
30
29
  export declare function renderManifest(contracts: readonly DiscoveredContract[], outputFile: string): string;
31
30
  //# sourceMappingURL=manifest.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/build/manifest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAEnD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,SAAS,kBAAkB,EAAE,GACvC,SAAS,MAAM,EAAE,CASnB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,SAAS,kBAAkB,EAAE,EACxC,UAAU,EAAE,MAAM,GACjB,MAAM,CAiER"}
1
+ {"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/build/manifest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAEnD;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,SAAS,kBAAkB,EAAE,GACvC,SAAS,MAAM,EAAE,CASnB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,SAAS,kBAAkB,EAAE,EACxC,UAAU,EAAE,MAAM,GACjB,MAAM,CAiER"}
@@ -10,11 +10,10 @@ export declare const VALUE_FIELDS: readonly ["description", "owner", "sensitivit
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
14
- * {@link ../README} "Reusable packages") and the application that consumes it both name the same environment
15
- * variable, because the process has one flat namespace. Writing the explanation twice is how the two drift, so the
16
- * declaration that carries it can be the one place it is written, and the other adds only what is its own (the
17
- * application's own `expiresAt`, say).
13
+ * A variable can be declared in more than one contract. A package that ships a contract (see {@link ../README}
14
+ * "Reusable packages") and the application that consumes it can name the same environment variable. The process
15
+ * has one flat namespace. Writing the explanation twice is how the two drift. So one declaration carries it, and
16
+ * the other adds only its own fields (the application's `expiresAt`, say).
18
17
  *
19
18
  * Every field a declaration leaves unset is taken from another declaration that sets it, as long as one of the two
20
19
  * is a package's contract. When several set it, a package's contract wins over the application's own, and the
@@ -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;;;;;;;;;;;;;;;;;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
+ {"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"}