@maverickcer/env-cap 0.7.5 → 0.7.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (279) hide show
  1. package/ADOPTION.md +12 -12
  2. package/AGENTS.md +85 -120
  3. package/CHANGELOG.md +36 -0
  4. package/CODE_REVIEW.md +5 -5
  5. package/CONTRIBUTING.md +5 -5
  6. package/GUIDE.md +42 -24
  7. package/README.md +52 -34
  8. package/RELEASING.md +78 -64
  9. package/SECURITY.md +15 -15
  10. package/VERSIONING.md +16 -15
  11. package/benchmarks/READING-BENCHMARKS.md +101 -85
  12. package/benchmarks/README.md +12 -9
  13. package/benchmarks/WRITING-BENCHMARKS.md +89 -79
  14. package/benchmarks/performance-buildtime/BENCHMARKS.md +20 -20
  15. package/benchmarks/performance-runtime/BENCHMARKS.md +107 -107
  16. package/dist/.dts/_ipc/build-fs.d.ts +3 -3
  17. package/dist/.dts/_ipc/build-fs.d.ts.map +1 -1
  18. package/dist/.dts/_ipc/display-path.d.ts +1 -1
  19. package/dist/.dts/_ipc/glob.d.ts +3 -2
  20. package/dist/.dts/_ipc/glob.d.ts.map +1 -1
  21. package/dist/.dts/_ipc/no-node-fs.d.ts +2 -2
  22. package/dist/.dts/_ipc/resolve-tsconfig-paths.d.ts +16 -16
  23. package/dist/.dts/_ipc/resolve-tsconfig-paths.d.ts.map +1 -1
  24. package/dist/.dts/_ipc/typescript.d.ts +4 -4
  25. package/dist/.dts/build/assemble-project.d.ts +14 -15
  26. package/dist/.dts/build/assemble-project.d.ts.map +1 -1
  27. package/dist/.dts/build/change-model.d.ts +14 -14
  28. package/dist/.dts/build/change-model.d.ts.map +1 -1
  29. package/dist/.dts/build/check-artifacts.d.ts +4 -4
  30. package/dist/.dts/build/check-artifacts.d.ts.map +1 -1
  31. package/dist/.dts/build/citation-verification.d.ts +13 -14
  32. package/dist/.dts/build/citation-verification.d.ts.map +1 -1
  33. package/dist/.dts/build/compatibility.d.ts +24 -24
  34. package/dist/.dts/build/compatibility.d.ts.map +1 -1
  35. package/dist/.dts/build/contract-model.d.ts +10 -10
  36. package/dist/.dts/build/contract-model.d.ts.map +1 -1
  37. package/dist/.dts/build/deep-equal.d.ts +2 -2
  38. package/dist/.dts/build/deep-freeze.d.ts +2 -2
  39. package/dist/.dts/build/dependency-graph.d.ts +48 -55
  40. package/dist/.dts/build/dependency-graph.d.ts.map +1 -1
  41. package/dist/.dts/build/dependency-model.d.ts +18 -18
  42. package/dist/.dts/build/dependency-model.d.ts.map +1 -1
  43. package/dist/.dts/build/discover.d.ts +11 -11
  44. package/dist/.dts/build/discover.d.ts.map +1 -1
  45. package/dist/.dts/build/docs.d.ts +34 -38
  46. package/dist/.dts/build/docs.d.ts.map +1 -1
  47. package/dist/.dts/build/env-example.d.ts +13 -13
  48. package/dist/.dts/build/env-example.d.ts.map +1 -1
  49. package/dist/.dts/build/errors.d.ts +8 -8
  50. package/dist/.dts/build/evidence-cache.d.ts +23 -23
  51. package/dist/.dts/build/evidence-cache.d.ts.map +1 -1
  52. package/dist/.dts/build/evidence-model.d.ts +3 -3
  53. package/dist/.dts/build/evidence-reference.d.ts +15 -15
  54. package/dist/.dts/build/evidence-reference.d.ts.map +1 -1
  55. package/dist/.dts/build/evidence-snapshot.d.ts +47 -53
  56. package/dist/.dts/build/evidence-snapshot.d.ts.map +1 -1
  57. package/dist/.dts/build/exclusive-group.d.ts +4 -4
  58. package/dist/.dts/build/exclusive-group.d.ts.map +1 -1
  59. package/dist/.dts/build/finding-model.d.ts +12 -12
  60. package/dist/.dts/build/finding-model.d.ts.map +1 -1
  61. package/dist/.dts/build/generate-documentation.d.ts +19 -19
  62. package/dist/.dts/build/generate-documentation.d.ts.map +1 -1
  63. package/dist/.dts/build/generate-env-artifacts.d.ts +43 -43
  64. package/dist/.dts/build/generate-env-artifacts.d.ts.map +1 -1
  65. package/dist/.dts/build/generate-evidence.d.ts +19 -19
  66. package/dist/.dts/build/generate-evidence.d.ts.map +1 -1
  67. package/dist/.dts/build/generate-manifest.d.ts +11 -12
  68. package/dist/.dts/build/generate-manifest.d.ts.map +1 -1
  69. package/dist/.dts/build/generate-usage.d.ts +23 -24
  70. package/dist/.dts/build/generate-usage.d.ts.map +1 -1
  71. package/dist/.dts/build/generated-banner.d.ts +5 -5
  72. package/dist/.dts/build/governance-fields.d.ts +7 -7
  73. package/dist/.dts/build/humanize-key.d.ts +1 -1
  74. package/dist/.dts/build/humanize-key.d.ts.map +1 -1
  75. package/dist/.dts/build/index.d.ts +20 -36
  76. package/dist/.dts/build/index.d.ts.map +1 -1
  77. package/dist/.dts/build/lifecycle-model.d.ts +87 -85
  78. package/dist/.dts/build/lifecycle-model.d.ts.map +1 -1
  79. package/dist/.dts/build/link.d.ts +38 -39
  80. package/dist/.dts/build/link.d.ts.map +1 -1
  81. package/dist/.dts/build/literal-eval.d.ts +2 -2
  82. package/dist/.dts/build/literal-eval.d.ts.map +1 -1
  83. package/dist/.dts/build/live-expirations.d.ts +14 -13
  84. package/dist/.dts/build/live-expirations.d.ts.map +1 -1
  85. package/dist/.dts/build/manifest.d.ts +6 -6
  86. package/dist/.dts/build/map-utils.d.ts +4 -4
  87. package/dist/.dts/build/merge-documentation.d.ts +9 -8
  88. package/dist/.dts/build/merge-documentation.d.ts.map +1 -1
  89. package/dist/.dts/build/ownership-model.d.ts +14 -15
  90. package/dist/.dts/build/ownership-model.d.ts.map +1 -1
  91. package/dist/.dts/build/parse.d.ts +20 -21
  92. package/dist/.dts/build/parse.d.ts.map +1 -1
  93. package/dist/.dts/build/reference-projections.d.ts +36 -38
  94. package/dist/.dts/build/reference-projections.d.ts.map +1 -1
  95. package/dist/.dts/build/resolution/resolve-import.d.ts +18 -14
  96. package/dist/.dts/build/resolution/resolve-import.d.ts.map +1 -1
  97. package/dist/.dts/build/resolution/resolve-package-schema.d.ts +26 -26
  98. package/dist/.dts/build/resolution/resolve-package-schema.d.ts.map +1 -1
  99. package/dist/.dts/build/resolution/resolve-within-root.d.ts +9 -9
  100. package/dist/.dts/build/sarif.d.ts +5 -5
  101. package/dist/.dts/build/sarif.d.ts.map +1 -1
  102. package/dist/.dts/build/scan-dependencies.d.ts +17 -16
  103. package/dist/.dts/build/scan-dependencies.d.ts.map +1 -1
  104. package/dist/.dts/build/sort-by-identity.d.ts +1 -1
  105. package/dist/.dts/build/source-position.d.ts +13 -13
  106. package/dist/.dts/build/tool-version.d.ts +1 -1
  107. package/dist/.dts/build/usage-report.d.ts +19 -19
  108. package/dist/.dts/build/usage-report.d.ts.map +1 -1
  109. package/dist/.dts/eslint-plugin/index.d.ts +16 -5
  110. package/dist/.dts/eslint-plugin/index.d.ts.map +1 -1
  111. package/dist/.dts/eslint-plugin/no-raw-process-env.d.ts +4 -4
  112. package/dist/.dts/evidence/define-projection.d.ts +15 -16
  113. package/dist/.dts/evidence/define-projection.d.ts.map +1 -1
  114. package/dist/.dts/evidence/index.d.ts +11 -15
  115. package/dist/.dts/evidence/index.d.ts.map +1 -1
  116. package/dist/.dts/helpers/index.d.ts +15 -18
  117. package/dist/.dts/helpers/index.d.ts.map +1 -1
  118. package/dist/.dts/helpers/validators.d.ts +2 -2
  119. package/dist/.dts/helpers/validators.d.ts.map +1 -1
  120. package/dist/.dts/node/index.d.ts +19 -0
  121. package/dist/.dts/node/index.d.ts.map +1 -1
  122. package/dist/.dts/runtime/create.d.ts +3 -3
  123. package/dist/.dts/runtime/document.d.ts +90 -99
  124. package/dist/.dts/runtime/document.d.ts.map +1 -1
  125. package/dist/.dts/runtime/errors.d.ts +5 -5
  126. package/dist/.dts/runtime/reset.d.ts +1 -1
  127. package/dist/.dts/runtime/types.d.ts +23 -24
  128. package/dist/.dts/runtime/types.d.ts.map +1 -1
  129. package/dist/.dts/runtime/validate.d.ts +1 -1
  130. package/dist/.dts7/_ipc/build-fs.d.ts +3 -3
  131. package/dist/.dts7/_ipc/build-fs.d.ts.map +1 -1
  132. package/dist/.dts7/_ipc/display-path.d.ts +1 -1
  133. package/dist/.dts7/_ipc/glob.d.ts +3 -2
  134. package/dist/.dts7/_ipc/glob.d.ts.map +1 -1
  135. package/dist/.dts7/_ipc/no-node-fs.d.ts +2 -2
  136. package/dist/.dts7/_ipc/resolve-tsconfig-paths.d.ts +16 -16
  137. package/dist/.dts7/_ipc/resolve-tsconfig-paths.d.ts.map +1 -1
  138. package/dist/.dts7/_ipc/typescript.d.ts +4 -4
  139. package/dist/.dts7/build/assemble-project.d.ts +14 -15
  140. package/dist/.dts7/build/assemble-project.d.ts.map +1 -1
  141. package/dist/.dts7/build/change-model.d.ts +14 -14
  142. package/dist/.dts7/build/change-model.d.ts.map +1 -1
  143. package/dist/.dts7/build/check-artifacts.d.ts +4 -4
  144. package/dist/.dts7/build/check-artifacts.d.ts.map +1 -1
  145. package/dist/.dts7/build/citation-verification.d.ts +13 -14
  146. package/dist/.dts7/build/citation-verification.d.ts.map +1 -1
  147. package/dist/.dts7/build/compatibility.d.ts +24 -24
  148. package/dist/.dts7/build/compatibility.d.ts.map +1 -1
  149. package/dist/.dts7/build/contract-model.d.ts +10 -10
  150. package/dist/.dts7/build/contract-model.d.ts.map +1 -1
  151. package/dist/.dts7/build/deep-equal.d.ts +2 -2
  152. package/dist/.dts7/build/deep-freeze.d.ts +2 -2
  153. package/dist/.dts7/build/dependency-graph.d.ts +48 -55
  154. package/dist/.dts7/build/dependency-graph.d.ts.map +1 -1
  155. package/dist/.dts7/build/dependency-model.d.ts +18 -18
  156. package/dist/.dts7/build/dependency-model.d.ts.map +1 -1
  157. package/dist/.dts7/build/discover.d.ts +11 -11
  158. package/dist/.dts7/build/discover.d.ts.map +1 -1
  159. package/dist/.dts7/build/docs.d.ts +34 -38
  160. package/dist/.dts7/build/docs.d.ts.map +1 -1
  161. package/dist/.dts7/build/env-example.d.ts +13 -13
  162. package/dist/.dts7/build/env-example.d.ts.map +1 -1
  163. package/dist/.dts7/build/errors.d.ts +8 -8
  164. package/dist/.dts7/build/evidence-cache.d.ts +23 -23
  165. package/dist/.dts7/build/evidence-cache.d.ts.map +1 -1
  166. package/dist/.dts7/build/evidence-model.d.ts +3 -3
  167. package/dist/.dts7/build/evidence-reference.d.ts +15 -15
  168. package/dist/.dts7/build/evidence-reference.d.ts.map +1 -1
  169. package/dist/.dts7/build/evidence-snapshot.d.ts +47 -53
  170. package/dist/.dts7/build/evidence-snapshot.d.ts.map +1 -1
  171. package/dist/.dts7/build/exclusive-group.d.ts +4 -4
  172. package/dist/.dts7/build/exclusive-group.d.ts.map +1 -1
  173. package/dist/.dts7/build/finding-model.d.ts +12 -12
  174. package/dist/.dts7/build/finding-model.d.ts.map +1 -1
  175. package/dist/.dts7/build/generate-documentation.d.ts +19 -19
  176. package/dist/.dts7/build/generate-documentation.d.ts.map +1 -1
  177. package/dist/.dts7/build/generate-env-artifacts.d.ts +43 -43
  178. package/dist/.dts7/build/generate-env-artifacts.d.ts.map +1 -1
  179. package/dist/.dts7/build/generate-evidence.d.ts +19 -19
  180. package/dist/.dts7/build/generate-evidence.d.ts.map +1 -1
  181. package/dist/.dts7/build/generate-manifest.d.ts +11 -12
  182. package/dist/.dts7/build/generate-manifest.d.ts.map +1 -1
  183. package/dist/.dts7/build/generate-usage.d.ts +23 -24
  184. package/dist/.dts7/build/generate-usage.d.ts.map +1 -1
  185. package/dist/.dts7/build/generated-banner.d.ts +5 -5
  186. package/dist/.dts7/build/governance-fields.d.ts +7 -7
  187. package/dist/.dts7/build/humanize-key.d.ts +1 -1
  188. package/dist/.dts7/build/humanize-key.d.ts.map +1 -1
  189. package/dist/.dts7/build/index.d.ts +20 -36
  190. package/dist/.dts7/build/index.d.ts.map +1 -1
  191. package/dist/.dts7/build/lifecycle-model.d.ts +87 -85
  192. package/dist/.dts7/build/lifecycle-model.d.ts.map +1 -1
  193. package/dist/.dts7/build/link.d.ts +38 -39
  194. package/dist/.dts7/build/link.d.ts.map +1 -1
  195. package/dist/.dts7/build/literal-eval.d.ts +2 -2
  196. package/dist/.dts7/build/literal-eval.d.ts.map +1 -1
  197. package/dist/.dts7/build/live-expirations.d.ts +14 -13
  198. package/dist/.dts7/build/live-expirations.d.ts.map +1 -1
  199. package/dist/.dts7/build/manifest.d.ts +6 -6
  200. package/dist/.dts7/build/map-utils.d.ts +4 -4
  201. package/dist/.dts7/build/merge-documentation.d.ts +9 -8
  202. package/dist/.dts7/build/merge-documentation.d.ts.map +1 -1
  203. package/dist/.dts7/build/ownership-model.d.ts +14 -15
  204. package/dist/.dts7/build/ownership-model.d.ts.map +1 -1
  205. package/dist/.dts7/build/parse.d.ts +20 -21
  206. package/dist/.dts7/build/parse.d.ts.map +1 -1
  207. package/dist/.dts7/build/reference-projections.d.ts +36 -38
  208. package/dist/.dts7/build/reference-projections.d.ts.map +1 -1
  209. package/dist/.dts7/build/resolution/resolve-import.d.ts +18 -14
  210. package/dist/.dts7/build/resolution/resolve-import.d.ts.map +1 -1
  211. package/dist/.dts7/build/resolution/resolve-package-schema.d.ts +26 -26
  212. package/dist/.dts7/build/resolution/resolve-package-schema.d.ts.map +1 -1
  213. package/dist/.dts7/build/resolution/resolve-within-root.d.ts +9 -9
  214. package/dist/.dts7/build/sarif.d.ts +5 -5
  215. package/dist/.dts7/build/sarif.d.ts.map +1 -1
  216. package/dist/.dts7/build/scan-dependencies.d.ts +17 -16
  217. package/dist/.dts7/build/scan-dependencies.d.ts.map +1 -1
  218. package/dist/.dts7/build/sort-by-identity.d.ts +1 -1
  219. package/dist/.dts7/build/source-position.d.ts +13 -13
  220. package/dist/.dts7/build/tool-version.d.ts +1 -1
  221. package/dist/.dts7/build/usage-report.d.ts +19 -19
  222. package/dist/.dts7/build/usage-report.d.ts.map +1 -1
  223. package/dist/.dts7/eslint-plugin/index.d.ts +16 -5
  224. package/dist/.dts7/eslint-plugin/index.d.ts.map +1 -1
  225. package/dist/.dts7/eslint-plugin/no-raw-process-env.d.ts +4 -4
  226. package/dist/.dts7/evidence/define-projection.d.ts +15 -16
  227. package/dist/.dts7/evidence/define-projection.d.ts.map +1 -1
  228. package/dist/.dts7/evidence/index.d.ts +11 -15
  229. package/dist/.dts7/evidence/index.d.ts.map +1 -1
  230. package/dist/.dts7/helpers/index.d.ts +15 -18
  231. package/dist/.dts7/helpers/index.d.ts.map +1 -1
  232. package/dist/.dts7/helpers/validators.d.ts +2 -2
  233. package/dist/.dts7/helpers/validators.d.ts.map +1 -1
  234. package/dist/.dts7/node/index.d.ts +19 -0
  235. package/dist/.dts7/node/index.d.ts.map +1 -1
  236. package/dist/.dts7/runtime/create.d.ts +3 -3
  237. package/dist/.dts7/runtime/document.d.ts +90 -99
  238. package/dist/.dts7/runtime/document.d.ts.map +1 -1
  239. package/dist/.dts7/runtime/errors.d.ts +5 -5
  240. package/dist/.dts7/runtime/reset.d.ts +1 -1
  241. package/dist/.dts7/runtime/types.d.ts +23 -24
  242. package/dist/.dts7/runtime/types.d.ts.map +1 -1
  243. package/dist/.dts7/runtime/validate.d.ts +1 -1
  244. package/dist/{build-DNAYWD2B.js → build-33O5SDTC.js} +37 -39
  245. package/dist/build-33O5SDTC.js.map +1 -0
  246. package/dist/build.cjs +36 -38
  247. package/dist/build.cjs.map +1 -1
  248. package/dist/build.js +36 -38
  249. package/dist/build.js.map +1 -1
  250. package/dist/{chunk-HAGMVMN5.js → chunk-4D67AQFY.js} +2 -2
  251. package/dist/cli/index.js +29 -28
  252. package/dist/cli/index.js.map +1 -1
  253. package/dist/eslint-plugin/index.cjs.map +1 -1
  254. package/dist/eslint-plugin/index.js.map +1 -1
  255. package/dist/evidence.cjs +1 -1
  256. package/dist/evidence.cjs.map +1 -1
  257. package/dist/evidence.js +1 -1
  258. package/dist/evidence.js.map +1 -1
  259. package/dist/helpers.cjs +4 -4
  260. package/dist/helpers.cjs.map +1 -1
  261. package/dist/helpers.js +4 -4
  262. package/dist/helpers.js.map +1 -1
  263. package/dist/index.cjs.map +1 -1
  264. package/dist/index.js.map +1 -1
  265. package/examples/README.md +1 -1
  266. package/package.json +20 -13
  267. package/schemas/contract-model.schema.json +7 -7
  268. package/schemas/env-cap-report.schema.json +88 -88
  269. package/skills/env-cap/SKILL.md +12 -13
  270. package/skills/env-cap/references/api.md +1 -1
  271. package/specs/architecture.md +145 -120
  272. package/specs/decisions/0049-typescript-7-scanner-uses-a-bundled-typescript-6.md +9 -0
  273. package/specs/generated-artifacts.md +78 -70
  274. package/specs/migrations/README.md +6 -6
  275. package/specs/migrations/from-centralized-schema.md +1 -1
  276. package/specs/migrations/from-t3-env.md +9 -9
  277. package/PROMPT.md +0 -89
  278. package/dist/build-DNAYWD2B.js.map +0 -1
  279. /package/dist/{chunk-HAGMVMN5.js.map → chunk-4D67AQFY.js.map} +0 -0
@@ -1,5 +1,5 @@
1
1
  /**
2
- * Re-verifies developer-declared `dynamicAccess` citations every run -- never
2
+ * Re-verifies developer-declared `dynamicAccess` citations every run: never
3
3
  * trusted forever (ADR 0037). Two independent steps, kept as two separate
4
4
  * functions rather than one, since they answer two different questions and
5
5
  * the second is a pure read over the first's result:
@@ -10,16 +10,16 @@
10
10
  * label the citation `"fresh"` / `"stale"` / `"missing"`. Existence is
11
11
  * always re-checked live, never trusted from either snapshot. A citation
12
12
  * with no previous baseline (the first time it's ever been seen) is
13
- * `"fresh"` -- there is nothing to contradict it yet. Never throws on a
13
+ * `"fresh"`: there is nothing to contradict it yet. Never throws on a
14
14
  * missing file; that citation is simply labeled `"missing"`.
15
15
  * - `verifyDynamicAccessCitations` (pure): flattens that result down to just
16
- * the citations that need a human's attention -- every `"stale"`/`"missing"`
16
+ * the citations that need a human's attention; every `"stale"`/`"missing"`
17
17
  * assertion, enriched with the owning contract's display name. These are the
18
18
  * direct input to `finding-model.ts`'s `STALE_DYNAMIC_ACCESS_CITATION` /
19
19
  * `MISSING_DYNAMIC_ACCESS_CITATION` findings.
20
20
  *
21
21
  * Deliberately separate from `evidence-snapshot.ts`'s own `diffContracts()`,
22
- * which stays synchronous and pure -- these are the only filesystem-touching,
22
+ * which stays synchronous and pure: these are the only filesystem-touching,
23
23
  * citation-specific part of the evidence-snapshot lifecycle. A citation is
24
24
  * always a developer's *re-acknowledgment* that access happens, never a claim
25
25
  * env-cap itself observed anything: nothing here ever folds into the
@@ -28,19 +28,18 @@
28
28
  import type { EvidenceModel } from "./evidence-model.js";
29
29
  import type { DiscoveredContract } from "./link.js";
30
30
  import type { DynamicAccessAssertion, SourcePosition } from "./source-position.js";
31
- /** Stable key {@link buildCitationSnapshots} and `dependency-graph.ts`'s consumer of it agree on -- `file` must be root-relative, POSIX-separated on both sides for a lookup to ever hit. */
31
+ /** Stable key {@link buildCitationSnapshots} and `dependency-graph.ts`'s consumer of it agree on: `file` must be root-relative, POSIX-separated on both sides for a lookup to ever hit. */
32
32
  export declare function dynamicAccessVariableIdentity(file: string, exportName: string, key: string): string;
33
33
  /**
34
34
  * Re-checks every current `dynamicAccess` citation against the previous
35
35
  * evidence snapshot's committed `contentHash` baseline. Existence is always
36
- * re-checked live (never trusted from either snapshot); content drift is
37
- * only detectable when a previous baseline exists at all -- a citation with
38
- * no previous baseline (first time it's ever been seen) is reported
39
- * `"fresh"`, matching the same "nothing to contradict yet" logic. See ADR
40
- * 0037.
36
+ * re-checked live (never trusted from either snapshot). Content drift is
37
+ * only detectable when a previous baseline exists. A citation with no
38
+ * previous baseline (the first time it's seen) is reported `"fresh"`,
39
+ * because nothing contradicts it yet. See ADR 0037.
41
40
  */
42
41
  export declare function buildCitationSnapshots(activeContracts: readonly DiscoveredContract[], previous: EvidenceModel | undefined, root: string, readFile: (filePath: string) => Promise<string>): Promise<ReadonlyMap<string, readonly DynamicAccessAssertion[]>>;
43
- /** One `dynamicAccess` citation env-cap can no longer vouch for -- the direct input to `finding-model.ts`'s `"STALE_DYNAMIC_ACCESS_CITATION"`/`"MISSING_DYNAMIC_ACCESS_CITATION"` findings. See ADR 0037. */
42
+ /** One `dynamicAccess` citation env-cap can no longer vouch for: the direct input to `finding-model.ts`'s `"STALE_DYNAMIC_ACCESS_CITATION"`/`"MISSING_DYNAMIC_ACCESS_CITATION"` findings. See ADR 0037. */
44
43
  export interface DynamicAccessCitationProblem {
45
44
  readonly contractName: string;
46
45
  /** Root-relative, POSIX-separated. */
@@ -48,15 +47,15 @@ export interface DynamicAccessCitationProblem {
48
47
  readonly exportName: string;
49
48
  /** The variable whose `dynamicAccess` citation this is. */
50
49
  readonly key: string;
51
- /** Where the citation points -- not the variable's own declaration. */
50
+ /** Where the citation points: not the variable's own declaration. */
52
51
  readonly position: SourcePosition;
53
52
  readonly acknowledgment: "stale" | "missing";
54
53
  }
55
54
  /**
56
55
  * Flattens {@link buildCitationSnapshots}' result down to just the citations
57
- * that need attention -- every `"stale"`/`"missing"` assertion, enriched with
56
+ * that need attention: every `"stale"`/`"missing"` assertion, enriched with
58
57
  * the owning contract's display name. `"fresh"` assertions are silently
59
- * omitted -- nothing to report about a citation that's still trustworthy.
58
+ * omitted: nothing to report about a citation that's still trustworthy.
60
59
  */
61
60
  export declare function verifyDynamicAccessCitations(activeContracts: readonly DiscoveredContract[], root: string, acknowledgments: ReadonlyMap<string, readonly DynamicAccessAssertion[]>): readonly DynamicAccessCitationProblem[];
62
61
  //# sourceMappingURL=citation-verification.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"citation-verification.d.ts","sourceRoot":"","sources":["../../../src/build/citation-verification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAEnD,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAOlF,6LAA6L;AAC7L,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,GACV,MAAM,CAER;AAyBD;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,eAAe,EAAE,SAAS,kBAAkB,EAAE,EAC9C,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAC9C,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC,CAAC,CAmCjE;AAED,6MAA6M;AAC7M,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAA;IACjC,QAAQ,CAAC,cAAc,EAAE,OAAO,GAAG,SAAS,CAAA;CAC7C;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,eAAe,EAAE,SAAS,kBAAkB,EAAE,EAC9C,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC,GACtE,SAAS,4BAA4B,EAAE,CA6BzC"}
1
+ {"version":3,"file":"citation-verification.d.ts","sourceRoot":"","sources":["../../../src/build/citation-verification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAEnD,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAOlF,2LAA2L;AAC3L,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,GACV,MAAM,CAER;AAyBD;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,eAAe,EAAE,SAAS,kBAAkB,EAAE,EAC9C,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAC9C,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC,CAAC,CAmCjE;AAED,2MAA2M;AAC3M,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAA;IACjC,QAAQ,CAAC,cAAc,EAAE,OAAO,GAAG,SAAS,CAAA;CAC7C;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,eAAe,EAAE,SAAS,kBAAkB,EAAE,EAC9C,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC,GACtE,SAAS,4BAA4B,EAAE,CA4BzC"}
@@ -2,7 +2,7 @@ import type { DiscoveredContract } from "./link.js";
2
2
  /**
3
3
  * Every stable `code` a check in this file (or `exclusive-group.ts`) can
4
4
  * emit. Documented as an enumerated union so a consumer filtering/linking on
5
- * `code` has a closed list to switch over, rather than an arbitrary string --
5
+ * `code` has a closed list to switch over, rather than an arbitrary string:
6
6
  * see ADR 0024/0026. `exclusive-group.ts`'s check does not (yet) set one; see
7
7
  * that file's own comment for why.
8
8
  */
@@ -15,11 +15,11 @@ export interface CompatibilityIssue {
15
15
  readonly variable: string;
16
16
  /**
17
17
  * Every file declaring a conflicting definition. A pairwise comparison
18
- * (compatibility.ts, exclusive-group.ts) always produces exactly two; a
18
+ * (compatibility.ts, exclusive-group.ts) always produces exactly two. A
19
19
  * finding escalated from another family (generate-env-artifacts.ts's
20
20
  * `escalatedFindings()`, via `findingFiles()`) can produce zero, one, or
21
- * two, depending on what location information that finding actually
22
- * carries -- genuinely variable arity, not a tuple.
21
+ * two, depending on the location information that finding carries. So
22
+ * the arity varies, and this is not a tuple.
23
23
  */
24
24
  readonly files: readonly string[];
25
25
  /** Human-readable explanation of the conflict. */
@@ -27,41 +27,41 @@ export interface CompatibilityIssue {
27
27
  /**
28
28
  * Stable, machine-readable identifier for CI filtering / doc-linking /
29
29
  * GitHub Action annotations / IDE integration. `undefined` only for checks
30
- * that don't (yet) set one -- see {@link CompatibilityIssueCode} for the
31
- * full enumerated list of values a check in this file can produce.
30
+ * that don't set one yet. {@link CompatibilityIssueCode} lists every value
31
+ * a check in this file can produce.
32
32
  */
33
33
  readonly code?: CompatibilityIssueCode;
34
34
  }
35
35
  /**
36
36
  * Flags cases where two contracts declare the same variable name but appear to
37
- * disagree about its shape, so a human can confirm they're still meant to be "the same" var.
37
+ * disagree about its shape. A human can then confirm they're still meant to be "the same" var.
38
38
  *
39
39
  * @remarks
40
- * Duplicate variable names across contracts are not a merge problem -- each
41
- * contract independently processes its own copy of the raw value, there is no
42
- * runtime merge at all. This is purely a build-time lint.
40
+ * Duplicate variable names across contracts are not a merge problem. Each
41
+ * contract processes its own copy of the raw value; there is no runtime
42
+ * merge at all. This is purely a build-time lint.
43
43
  *
44
44
  * Only one thing is treated as *provable* without executing code: two
45
45
  * processors with explicit, differing `: T` return type annotations. That is
46
46
  * a hard error. Everything else (differing processor/validator source text
47
- * with no annotation, or none at all) is a warning -- we cannot prove
48
- * semantic non-equivalence via static analysis alone, and the library never
49
- * executes schema code to check further (see literal-eval.ts).
47
+ * with no annotation, or none at all) is a warning. Static analysis alone
48
+ * cannot prove semantic non-equivalence. And the library never executes
49
+ * schema code to check further (see literal-eval.ts).
50
50
  */
51
51
  export declare function detectCompatibilityIssues(contracts: readonly DiscoveredContract[]): CompatibilityIssue[];
52
52
  /**
53
53
  * Flags *differently-named* variables in different contracts that share an
54
- * identical type shape -- a soft signal that two features may be
55
- * independently modelling the same underlying configuration value under two
56
- * names, worth a human glance before they drift apart.
54
+ * identical type shape. It is a soft signal that two features may model the
55
+ * same configuration value under two names. That is worth a human glance
56
+ * before they drift apart.
57
57
  *
58
58
  * @remarks
59
59
  * Always `severity: "info"`, and never escalated to blocking by any flag,
60
- * including `--strict` -- an identical shape is genuinely common and
61
- * frequently correct (two unrelated features can both take a `number` timeout
62
- * with a validator, and that is not a defect). This is an observation offered
63
- * to a reader, not a rule; making it blockable would make it noise a team has
64
- * to suppress rather than a signal they can scan.
60
+ * including `--strict`. An identical shape is common and often correct. Two
61
+ * unrelated features can both take a `number` timeout with a validator, and
62
+ * that is not a defect. This is an observation for a reader, not a rule. A
63
+ * blockable version would be noise a team has to suppress, not a signal
64
+ * they can scan.
65
65
  *
66
66
  * Scope, deliberately narrow on every axis:
67
67
  * - **Different keys only.** Same-key collisions across contracts are
@@ -72,11 +72,11 @@ export declare function detectCompatibilityIssues(contracts: readonly Discovered
72
72
  * - **Active contracts only.** An inactive contract is wired into nothing,
73
73
  * so an overlap with it is not a live duplication.
74
74
  * - **No exclusive-grouped contracts.** Members of an exclusive group are
75
- * interchangeable alternatives by explicit authorial declaration --
75
+ * interchangeable alternatives by explicit authorial declaration:
76
76
  * matching shapes there are the *point*, not a smell.
77
77
  * - **Pairwise, never transitive.** Three mutually-matching variables emit
78
- * three independent findings (A-B, A-C, B-C), never one merged "cluster":
79
- * each pair is its own question a reader answers on its own, and a cluster
78
+ * three independent findings (A-B, A-C, B-C), never one merged "cluster".
79
+ * Each pair is its own question a reader answers on its own. A cluster
80
80
  * would imply a transitive relationship this check never established.
81
81
  */
82
82
  export declare function detectDuplicateVariableShapes(contracts: readonly DiscoveredContract[]): CompatibilityIssue[];
@@ -1 +1 @@
1
- {"version":3,"file":"compatibility.d.ts","sourceRoot":"","sources":["../../../src/build/compatibility.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAsB,MAAM,WAAW,CAAA;AAGvE;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAC9B,gCAAgC,GAChC,2BAA2B,GAC3B,2BAA2B,GAC3B,kCAAkC,GAClC,2CAA2C,CAAA;AAE/C,8HAA8H;AAC9H,MAAM,WAAW,kBAAkB;IACjC,uKAAuK;IACvK,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;IAC/C,iHAAiH;IACjH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,sBAAsB,CAAA;CACvC;AAkCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,SAAS,kBAAkB,EAAE,GACvC,kBAAkB,EAAE,CAqGtB;AA+CD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,SAAS,kBAAkB,EAAE,GACvC,kBAAkB,EAAE,CAqDtB"}
1
+ {"version":3,"file":"compatibility.d.ts","sourceRoot":"","sources":["../../../src/build/compatibility.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAsB,MAAM,WAAW,CAAA;AAGvE;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAC9B,gCAAgC,GAChC,2BAA2B,GAC3B,2BAA2B,GAC3B,kCAAkC,GAClC,2CAA2C,CAAA;AAE/C,8HAA8H;AAC9H,MAAM,WAAW,kBAAkB;IACjC,uKAAuK;IACvK,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;IAC/C,iHAAiH;IACjH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,sBAAsB,CAAA;CACvC;AAkCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,SAAS,kBAAkB,EAAE,GACvC,kBAAkB,EAAE,CA+FtB;AA+CD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,SAAS,kBAAkB,EAAE,GACvC,kBAAkB,EAAE,CAqDtB"}
@@ -4,7 +4,7 @@ import type { DiscoveredVariableEvidence } from "./parse.js";
4
4
  import type { PackageOrigin } from "./resolution/resolve-package-schema.js";
5
5
  import type { SourcePosition } from "./source-position.js";
6
6
  /**
7
- * The first of env-cap's seven canonical fact models (ADR 0024) -- a
7
+ * The first of env-cap's seven canonical fact models (ADR 0024): a
8
8
  * versioned, JSON-serializable projection of every declared environment
9
9
  * variable's structural and documentation contract. See ADR 0025.
10
10
  *
@@ -15,21 +15,21 @@ import type { SourcePosition } from "./source-position.js";
15
15
  * matching `renderManifest()`'s own scope (ADR 0021). This model includes
16
16
  * every discovered contract regardless of `active`, plus the AST-derived
17
17
  * schema facts (`hasDefault`/`hasProcessor`/etc.) the change report
18
- * deliberately excludes -- both are load-bearing for downstream
18
+ * deliberately excludes: both are load-bearing for downstream
19
19
  * Finding/Evidence Model work.
20
20
  */
21
21
  /** Bump only when a reader could misinterpret the new shape (a field changes
22
- * type/meaning, or is removed) -- NOT for every additive field. Same
22
+ * type/meaning, or is removed): NOT for every additive field. Same
23
23
  * discipline `evidence-model.ts`'s `EVIDENCE_MODEL_SCHEMA_VERSION` and
24
24
  * `src/cli/json.ts`'s `JSON_SCHEMA_VERSION` already document. */
25
25
  export declare const CONTRACT_MODEL_SCHEMA_VERSION = 3;
26
26
  /**
27
27
  * One variable's full statically-discoverable contract: schema-shaped facts plus linked documentation.
28
28
  *
29
- * @see {@link DependencyModelVariable} -- this same declared variable's access status.
30
- * @see {@link OwnershipModelVariable} -- this same declared variable's effective owner.
31
- * @see {@link LifecycleModelVariable} -- this same declared variable's lifecycle data.
32
- * @see `CatalogVariable` (`docs.ts`) -- this same declared variable, reshaped for the generated
29
+ * @see {@link DependencyModelVariable}: this same declared variable's access status.
30
+ * @see {@link OwnershipModelVariable}: this same declared variable's effective owner.
31
+ * @see {@link LifecycleModelVariable}: this same declared variable's lifecycle data.
32
+ * @see `CatalogVariable` (`docs.ts`): this same declared variable, reshaped for the generated
33
33
  * docs catalog/JSON. Plain reference, not `{@link}`: `CatalogVariable` is intentionally not part
34
34
  * of the public surface (see `typedoc.json`'s `intentionallyNotExported`).
35
35
  */
@@ -53,14 +53,14 @@ export interface ContractModelVariable extends EnvGovernanceFields {
53
53
  readonly setupInstructions: string | undefined;
54
54
  readonly required: boolean | undefined;
55
55
  readonly documented: boolean;
56
- /** The `evidence` sub-object from this variable's linked documentation -- re-verified every run, unlike every declared-only field above. See {@link runtime.VariableEvidenceDocs} and ADR 0037. */
56
+ /** The `evidence` sub-object from this variable's linked documentation: re-verified every run, unlike every declared-only field above. See {@link runtime.VariableEvidenceDocs} and ADR 0037. */
57
57
  readonly evidence: DiscoveredVariableEvidence | undefined;
58
58
  /** Where this variable's own schema property is declared. See ADR 0036. */
59
59
  readonly declaration: SourcePosition;
60
60
  }
61
61
  /** One `createEnv()` contract's full statically-discoverable contract, active or not. */
62
62
  export interface ContractModelContract extends EnvGovernanceFields {
63
- /** Root-relative, POSIX-separated -- matches `DiscoveredContractSummary.file`. */
63
+ /** Root-relative, POSIX-separated: matches `DiscoveredContractSummary.file`. */
64
64
  readonly file: string;
65
65
  readonly exportName: string;
66
66
  readonly contractName: string;
@@ -75,7 +75,7 @@ export interface ContractModelContract extends EnvGovernanceFields {
75
75
  /** Where this contract's `documentEnv(...)` call is declared, if one exists. See ADR 0036. */
76
76
  readonly documentation: SourcePosition | undefined;
77
77
  }
78
- /** The versioned, JSON-serializable root of the Contract Model -- every discovered `createEnv()` contract (active or not), each with its own full statically-discoverable shape. See {@link ContractModelContract}. */
78
+ /** The versioned, JSON-serializable root of the Contract Model: every discovered `createEnv()` contract (active or not), each with its own full statically-discoverable shape. See {@link ContractModelContract}. */
79
79
  export interface ContractModel {
80
80
  readonly schemaVersion: typeof CONTRACT_MODEL_SCHEMA_VERSION;
81
81
  readonly contracts: readonly ContractModelContract[];
@@ -1 +1 @@
1
- {"version":3,"file":"contract-model.d.ts","sourceRoot":"","sources":["../../../src/build/contract-model.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AACrF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AACnD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAA;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAmB1D;;;;;;;;;;;;;;GAcG;AAEH;;;kEAGkE;AAClE,eAAO,MAAM,6BAA6B,IAAI,CAAA;AAE9C;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,YAAY,EACnB;QAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAA;KAAE,GAAG,SAAS,CAAA;IACrF,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAA;IAChD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAA;IAChD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9C,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;IACtC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,mMAAmM;IACnM,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,GAAG,SAAS,CAAA;IACzD,2EAA2E;IAC3E,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAA;CACrC;AAED,yFAAyF;AACzF,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,kFAAkF;IAClF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3C,QAAQ,CAAC,SAAS,EAAE,SAAS,qBAAqB,EAAE,CAAA;IACpD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,SAAS,CAAA;IACjD,6FAA6F;IAC7F,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAA;IACpC,8FAA8F;IAC9F,QAAQ,CAAC,aAAa,EAAE,cAAc,GAAG,SAAS,CAAA;CACnD;AAED,uNAAuN;AACvN,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,aAAa,EAAE,OAAO,6BAA6B,CAAA;IAC5D,QAAQ,CAAC,SAAS,EAAE,SAAS,qBAAqB,EAAE,CAAA;CACrD;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,kBAAkB,EAAE,EACxC,IAAI,EAAE,MAAM,GACX,aAAa,CAmDf"}
1
+ {"version":3,"file":"contract-model.d.ts","sourceRoot":"","sources":["../../../src/build/contract-model.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AACrF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AACnD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAA;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAmB1D;;;;;;;;;;;;;;GAcG;AAEH;;;kEAGkE;AAClE,eAAO,MAAM,6BAA6B,IAAI,CAAA;AAE9C;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,YAAY,EACnB;QAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAA;KAAE,GAAG,SAAS,CAAA;IACrF,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAA;IAChD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAA;IAChD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9C,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;IACtC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,iMAAiM;IACjM,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,GAAG,SAAS,CAAA;IACzD,2EAA2E;IAC3E,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAA;CACrC;AAED,yFAAyF;AACzF,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3C,QAAQ,CAAC,SAAS,EAAE,SAAS,qBAAqB,EAAE,CAAA;IACpD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,SAAS,CAAA;IACjD,6FAA6F;IAC7F,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAA;IACpC,8FAA8F;IAC9F,QAAQ,CAAC,aAAa,EAAE,cAAc,GAAG,SAAS,CAAA;CACnD;AAED,qNAAqN;AACrN,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,aAAa,EAAE,OAAO,6BAA6B,CAAA;IAC5D,QAAQ,CAAC,SAAS,EAAE,SAAS,qBAAqB,EAAE,CAAA;CACrD;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,kBAAkB,EAAE,EACxC,IAAI,EAAE,MAAM,GACX,aAAa,CAmDf"}
@@ -1,8 +1,8 @@
1
1
  /**
2
- * Structural equality for JSON-safe values -- `documentEnv()`'s `metadata` can hold an
2
+ * Structural equality for JSON-safe values: `documentEnv()`'s `metadata` can hold an
3
3
  * object/array (ADR 0035), so two independently-declared-but-identical values are never `===`.
4
4
  * Values compared here are always JSON-safe (string/number/boolean/null/array/object,
5
- * recursively -- see `literal-eval.ts`), so this doesn't need to handle cycles, `Date`, `Map`, or
5
+ * recursively: see `literal-eval.ts`), so this doesn't need to handle cycles, `Date`, `Map`, or
6
6
  * anything else `evaluateLiteral()` can never produce.
7
7
  */
8
8
  export declare function deepEqual(a: unknown, b: unknown): boolean;
@@ -9,8 +9,8 @@
9
9
  * utility, so Evidence Model's own immutability guarantee (a later phase)
10
10
  * can reuse it instead of duplicating the recursion.
11
11
  *
12
- * Only recurses into arrays and plain objects (`{}` or `Object.create(null)`)
13
- * -- a `Map`, `Set`, or class instance is frozen at its own top level but not
12
+ * Only recurses into arrays and plain objects (`{}` or `Object.create(null)`):
13
+ * a `Map`, `Set`, or class instance is frozen at its own top level but not
14
14
  * walked further. This codebase's fact models are plain JSON-serializable
15
15
  * data, never class instances, so this is deliberately narrow rather than a
16
16
  * general-purpose deep-freeze library. A `WeakSet` guards against infinite
@@ -4,66 +4,61 @@ import type { DiscoveredContract } from "./link.js";
4
4
  import type { ParseWarning } from "./parse.js";
5
5
  import type { DynamicAccessAssertion, SourcePosition } from "./source-position.js";
6
6
  /**
7
- * What env-cap's static scan could prove about one variable's consumption:
8
- * it was member-accessed somewhere (`"used"`), it was never accessed at all
9
- * within the scanned surfaces (`"unconsumed"`), or a computed (dynamic)
10
- * property access on the owning contract makes the answer unprovable
11
- * (`"indeterminate"`).
7
+ * What env-cap's static scan could prove about one variable's consumption.
8
+ * It was member-accessed somewhere (`"used"`), or never accessed within the
9
+ * scanned surfaces (`"unconsumed"`). Or a computed (dynamic) property access
10
+ * on the owning contract makes the answer unprovable (`"indeterminate"`).
12
11
  *
13
12
  * @remarks
14
- * Deliberately narrower than `data-cap`'s equivalent, which
15
- * splits the unprovable case further (an unresolved *consumer* vs. an
16
- * indeterminate *field*). That split exists because a data-cap capability
17
- * exposes many fields at once, so it has a real "we resolved the consumer,
18
- * but can't tell which field it touched" state to name. env-cap's
19
- * consumption model is one value per key: a contract member access either
20
- * names the key statically (`"used"`) or it doesn't (`"indeterminate"`), and
21
- * there is no intermediate case where the consumer is known but the thing
22
- * consumed is ambiguous. Adding a fourth state here would be vocabulary
23
- * borrowed from a model env-cap doesn't have -- see ADR 0010's
24
- * "provable, not heuristic" rule. Developer-declared `dynamicAccess`
13
+ * Deliberately narrower than `data-cap`'s equivalent. That one splits the
14
+ * unprovable case further (an unresolved *consumer* vs. an indeterminate
15
+ * *field*). That split exists because a data-cap capability exposes many
16
+ * fields at once. It has a real "we resolved the consumer, but can't tell
17
+ * which field it touched" state to name. In env-cap, the consumption model
18
+ * is one value per key. A contract member access either
19
+ * names the key statically (`"used"`) or it doesn't (`"indeterminate"`).
20
+ * There is no intermediate case where the consumer is known but the thing
21
+ * consumed is ambiguous. A fourth state here would borrow vocabulary from a
22
+ * model env-cap doesn't have: see ADR 0010's "provable, not heuristic" rule. Developer-declared `dynamicAccess`
25
23
  * citations stay a wholly separate fact and are never folded into this
26
24
  * status (ADR 0037).
27
25
  */
28
26
  export type VariableAccessStatus = "used" | "unconsumed" | "indeterminate";
29
27
  /**
30
28
  * Every reason `deriveOwnershipFindings` can cite for an `indeterminate`
31
- * variable, cited on the {@link EscapeSite} the scanner actually observed --
32
- * `EscapeReason` (destructuring/aliasing shapes the scanner declines to
33
- * follow, see ADR 0039) plus `"reference"` for a tracked import/alias
34
- * mentioned bare (passed as an argument, spread, assigned elsewhere, ...):
35
- * a real, provable read of the contract that this single-file walk simply
36
- * can't attribute to any specific key.
29
+ * variable, cited on the {@link EscapeSite} the scanner actually observed.
30
+ * `EscapeReason` covers destructuring/aliasing shapes the scanner declines to
31
+ * follow (see ADR 0039). `"reference"` covers a tracked import/alias
32
+ * mentioned bare (passed as an argument, spread, assigned elsewhere, ...).
33
+ * That is a real, provable read of the contract, but this single-file walk
34
+ * can't attribute it to any specific key.
37
35
  */
38
36
  type EscapeVia = EscapeReason | "reference";
39
- /** One position where a tracked contract's value escaped this scanner's local dataflow analysis -- see {@link EscapeVia}. */
37
+ /** One position where a tracked contract's value escaped this scanner's local dataflow analysis: see {@link EscapeVia}. */
40
38
  interface EscapeSite extends SourcePosition {
41
39
  readonly via: EscapeVia;
42
40
  }
43
41
  interface VariableAccessInfo {
44
42
  readonly status: VariableAccessStatus;
45
- /** Internal only, never exposed publicly -- which AST evidence produced
46
- * this status, so a future "why does env-cap think this is
47
- * unconsumed" bug report is debuggable without re-deriving the AST walk
48
- * by hand. */
43
+ /** Internal only, never exposed publicly: which AST evidence produced
44
+ * this status. A "why does env-cap think this is unconsumed" bug report
45
+ * is then debuggable without re-deriving the AST walk by hand. */
49
46
  readonly evidence: "member-access" | "dynamic-access" | "escape" | "no-access";
50
47
  /** Every position where a member access was observed for this variable,
51
- * aggregated across every consuming file -- empty unless
52
- * `status === "used"`. Previously computed by `scan-dependencies.ts`'s
53
- * `AccessSite` and discarded before reaching even this internal type;
54
- * threaded through as of ADR 0027 (line only) and ADR 0036 (full
55
- * position, one entry per file rather than a flat, file-less list of
56
- * line numbers) so `dependency-model.ts` can publish it. */
48
+ * aggregated across every consuming file: empty unless
49
+ * `status === "used"`. Taken from `scan-dependencies.ts`'s `AccessSite`
50
+ * so `dependency-model.ts` can publish it: the line since ADR 0027, the
51
+ * full position since ADR 0036. There is one entry per file, not a flat,
52
+ * file-less list of line numbers. */
57
53
  readonly positions: readonly SourcePosition[];
58
- /** Every developer-declared `dynamicAccess` citation's current freshness for this variable -- a wholly separate, independent fact from `status`/`evidence` above, never folded into them. Empty unless the linked `documentEnv()` call declared at least one citation for this key. See ADR 0037. */
54
+ /** Every developer-declared `dynamicAccess` citation's current freshness for this variable: a wholly separate, independent fact from `status`/`evidence` above, never folded into them. Empty unless the linked `documentEnv()` call declared at least one citation for this key. See ADR 0037. */
59
55
  readonly dynamicAccessAssertions: readonly DynamicAccessAssertion[];
60
56
  }
61
- /** One named surface `buildDependencyGraph()`'s scan actually covered -- the
57
+ /** One named surface `buildDependencyGraph()`'s scan actually covered: the
62
58
  * application's own root, plus one entry per allow-listed `packages` (ADR
63
- * 0014) name whose source was also scanned. See ADR 0036: a claim like
64
- * "no consumer found" is only ever as strong as what was actually
65
- * searched, and this is what lets a renderer say so explicitly instead of
66
- * implying an unbounded guarantee it can't back up. */
59
+ * 0014) name whose source was also scanned. See ADR 0036. A claim like
60
+ * "no consumer found" is only as strong as what was searched. This lets a
61
+ * renderer say so explicitly, not imply an unbounded guarantee. */
67
62
  export interface ScannedSurface {
68
63
  /** `"application"` for the local project root, `"package:<name>"` for an allow-listed package's own source. */
69
64
  readonly label: string;
@@ -78,7 +73,7 @@ interface ContractDependencySummary {
78
73
  readonly hasDynamicAccess: boolean;
79
74
  /** Every declared key is always present. */
80
75
  readonly variables: ReadonlyMap<string, VariableAccessInfo>;
81
- /** Every file coupled to this contract -- contract-level "who depends on
76
+ /** Every file coupled to this contract: contract-level "who depends on
82
77
  * this," not proof any specific variable was read. See the
83
78
  * consumer-vs-variable-access semantics note in `deriveOwnershipFindings`. */
84
79
  readonly consumingFiles: readonly string[];
@@ -87,13 +82,11 @@ interface ContractDependencySummary {
87
82
  * re-export. */
88
83
  readonly ambiguousBarrelFiles: readonly string[];
89
84
  /** Every computed (dynamic) property-access site observed anywhere on
90
- * this contract -- previously collapsed into `hasDynamicAccess` alone
91
- * and discarded; threaded through as of ADR 0036 so a finding can cite
92
- * exactly where the uncertainty comes from instead of just asserting it
93
- * exists. */
85
+ * this contract (ADR 0036). `hasDynamicAccess` only says that one exists.
86
+ * This list lets a finding cite where the uncertainty comes from. */
94
87
  readonly dynamicAccessSites: readonly SourcePosition[];
95
88
  /** Every position where the contract's value flowed somewhere this
96
- * scanner's local dataflow analysis can't follow -- see {@link
89
+ * scanner's local dataflow analysis can't follow: see {@link
97
90
  * EscapeVia} and ADR 0039. Like `dynamicAccessSites`, this widens every
98
91
  * not-otherwise-accessed variable on the SAME contract to
99
92
  * `indeterminate`, never `unconsumed`. */
@@ -102,7 +95,7 @@ interface ContractDependencySummary {
102
95
  export interface DependencyGraph {
103
96
  readonly contracts: readonly ContractDependencySummary[];
104
97
  readonly warnings: readonly ParseWarning[];
105
- /** Every surface actually scanned for usage -- see {@link ScannedSurface}. Always has at least one entry (the application root). */
98
+ /** Every surface actually scanned for usage: see {@link ScannedSurface}. Always has at least one entry (the application root). */
106
99
  readonly scannedSurfaces: readonly ScannedSurface[];
107
100
  }
108
101
  /** Sorts two positions by file, then line. @internal Exported for direct unit coverage. */
@@ -122,12 +115,12 @@ interface UnconsumedOwnedVariableOwnershipFinding extends AbandonedOwnershipFind
122
115
  interface IndeterminateAccessOwnershipFinding extends AbandonedOwnershipFinding {
123
116
  readonly key: string;
124
117
  readonly reason: string;
125
- /** Every AST-observed dynamic-access site on this contract -- see ADR 0036. */
118
+ /** Every AST-observed dynamic-access site on this contract: see ADR 0036. */
126
119
  readonly dynamicAccessSites: readonly SourcePosition[];
127
- /** Every AST-observed escape site on this contract -- see {@link EscapeVia} and ADR 0039. */
120
+ /** Every AST-observed escape site on this contract: see {@link EscapeVia} and ADR 0039. */
128
121
  readonly escapeSites: readonly EscapeSite[];
129
122
  }
130
- /** A variable that would otherwise be `unconsumedOwned`/`indeterminate`, but has at least one `"fresh"` developer-declared `dynamicAccess` assertion -- the "asserted" category (ADR 0037). Never silently dropped: the raw `wouldBeStatus` is always shown alongside the assertion, per Design 7's "never let a claim overwrite an observation" rule. */
123
+ /** A variable that would otherwise be `unconsumedOwned`/`indeterminate`, but has at least one `"fresh"` developer-declared `dynamicAccess` assertion: the "asserted" category (ADR 0037). Never silently dropped: the raw `wouldBeStatus` is always shown alongside the assertion, per Design 7's "never let a claim overwrite an observation" rule. */
131
124
  interface AssertedOwnershipFinding extends AbandonedOwnershipFinding {
132
125
  readonly key: string;
133
126
  readonly wouldBeStatus: "unconsumed" | "indeterminate";
@@ -144,23 +137,23 @@ export interface OwnershipFindings {
144
137
  * Derives ownership findings from the graph. This is where the epistemic
145
138
  * rules that matter most live:
146
139
  * - A contract never imported anywhere, with no ambiguous barrel path
147
- * either, is `abandoned` -- a feature's schema outliving the feature.
140
+ * either, is `abandoned`; a feature's schema outliving the feature.
148
141
  * - A contract never *directly* imported, but reachable only through an
149
- * unresolved barrel re-export, is `unresolvedConsumers` -- never
142
+ * unresolved barrel re-export, is `unresolvedConsumers`: never
150
143
  * `abandoned`. Claiming "abandoned" here would be a false positive with
151
144
  * real consequences.
152
145
  * - A variable with no member access anywhere, on a contract with no
153
- * dynamic access anywhere, is `unconsumedOwned` -- "no consumer found in
154
- * this repository," not "provably dead." The scanned surfaces are named
146
+ * dynamic access anywhere, is `unconsumedOwned`. That means "no consumer
147
+ * found in this repository", not "provably dead". The scanned surfaces are named
155
148
  * explicitly in the reason, per ADR 0036, so the claim is exactly as
156
149
  * strong as what was actually searched.
157
150
  * - A variable with no member access, but dynamic access observed
158
- * *somewhere* on that contract, is `indeterminate` -- never
151
+ * *somewhere* on that contract, is `indeterminate`: never
159
152
  * `unconsumedOwned`. Uncertainty is never promoted to certainty in either
160
153
  * direction. Every candidate dynamic-access site is cited by name.
161
154
  * - A variable with at least one `"fresh"` {@link DynamicAccessAssertion}
162
155
  * (ADR 0037) gets neither `unconsumedOwned` nor `indeterminate`, regardless
163
- * of `status` -- a developer has re-acknowledged the access exists. The
156
+ * of `status`: a developer has re-acknowledged the access exists. The
164
157
  * Dependency Model itself still keeps `status` and the assertion side by
165
158
  * side, unedited; only *this* finding-suppression decision reads them
166
159
  * together.
@@ -1 +1 @@
1
- {"version":3,"file":"dependency-graph.d.ts","sourceRoot":"","sources":["../../../src/build/dependency-graph.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"dependency-graph.d.ts","sourceRoot":"","sources":["../../../src/build/dependency-graph.ts"],"names":[],"mappings":"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"}
@@ -5,77 +5,77 @@ import type { ParseWarning } from "./parse.js";
5
5
  import type { ImportResolutionContext } from "./resolution/resolve-import.js";
6
6
  import type { DynamicAccessAssertion, SourcePosition } from "./source-position.js";
7
7
  /**
8
- * The second of env-cap's seven canonical fact models (ADR 0024) -- a
8
+ * The second of env-cap's seven canonical fact models (ADR 0024): a
9
9
  * versioned, JSON-serializable projection of the dependency-ownership
10
10
  * engine's graph. See ADR 0027 and ADR 0036.
11
11
  *
12
12
  * @remarks
13
13
  * `dependency-graph.ts`'s scanning/graph-building internals stay Private,
14
- * unchanged, per ADR 0010 -- this is a fact-shaped *result* built on top of
14
+ * unchanged, per ADR 0010: this is a fact-shaped *result* built on top of
15
15
  * them, not a relaxation of that boundary. Graph-format rendering (DOT,
16
- * Mermaid, a `{nodes, edges}` JSON export) is deliberately not here --
16
+ * Mermaid, a `{nodes, edges}` JSON export) is deliberately not here:
17
17
  * that's presentation over this model's data, not the model itself.
18
18
  */
19
- /** Bump only when a reader could misinterpret the new shape -- same discipline every other canonical model's `schemaVersion` follows. */
19
+ /** Bump only when a reader could misinterpret the new shape: same discipline every other canonical model's `schemaVersion` follows. */
20
20
  export declare const DEPENDENCY_MODEL_SCHEMA_VERSION = 2;
21
21
  /**
22
22
  * One variable's access status within a contract, plus every position it was found
23
23
  * member-accessed at, aggregated across every consuming file.
24
24
  *
25
- * @see {@link ContractModelVariable} -- this same declared variable's canonical starting point.
25
+ * @see {@link ContractModelVariable}: this same declared variable's canonical starting point.
26
26
  */
27
27
  export interface DependencyModelVariable {
28
28
  readonly key: string;
29
29
  readonly status: VariableAccessStatus;
30
- /** Empty unless `status === "used"`. Previously discarded before reaching any public type -- see ADR 0027 (line only) and ADR 0036 (full position, file included per entry). */
30
+ /** Empty unless `status === "used"`. Each entry is a full position with its file (ADR 0027, ADR 0036). */
31
31
  readonly positions: readonly SourcePosition[];
32
- /** Every developer-declared `dynamicAccess` citation's current freshness for this variable -- a wholly separate, independent fact from `status` above, never folded into it. Empty when no citation was declared, or when no manifest snapshot baseline was available to check against (the manifest pass wasn't also requested). See ADR 0037. */
32
+ /** Every developer-declared `dynamicAccess` citation's current freshness for this variable: a wholly separate, independent fact from `status` above, never folded into it. Empty when no citation was declared, or when no manifest snapshot baseline was available to check against (the manifest pass wasn't also requested). See ADR 0037. */
33
33
  readonly dynamicAccessAssertions: readonly DynamicAccessAssertion[];
34
34
  }
35
35
  /** One contract's dependency-ownership facts: which variables were accessed, which files consume it, and every dynamic/ambiguous access site found. See {@link DependencyModelVariable} for the per-variable breakdown. */
36
36
  export interface DependencyModelContract {
37
- /** Root-relative, POSIX-separated -- matches `ContractModelContract.file`. */
37
+ /** Root-relative, POSIX-separated: matches `ContractModelContract.file`. */
38
38
  readonly file: string;
39
39
  readonly exportName: string;
40
40
  readonly contractName: string;
41
41
  readonly imported: boolean;
42
42
  readonly hasDynamicAccess: boolean;
43
43
  readonly variables: readonly DependencyModelVariable[];
44
- /** Every file coupled to this contract -- contract-level "who depends on this," not proof any specific variable was read. */
44
+ /** Every file coupled to this contract: contract-level "who depends on this," not proof any specific variable was read. */
45
45
  readonly consumingFiles: readonly string[];
46
46
  /** Files whose import of this contract's name couldn't be verified because it resolved through a file containing an unresolved wildcard re-export. */
47
47
  readonly ambiguousBarrelFiles: readonly string[];
48
- /** Every computed (dynamic) property-access site observed anywhere on this contract -- see ADR 0036. */
48
+ /** Every computed (dynamic) property-access site observed anywhere on this contract: see ADR 0036. */
49
49
  readonly dynamicAccessSites: readonly SourcePosition[];
50
50
  }
51
- /** One contract, as referenced from the inverse (`consumers`) index -- see {@link ContractRef} for why no `contractName` is carried here. */
51
+ /** One contract, as referenced from the inverse (`consumers`) index: see {@link ContractRef} for why no `contractName` is carried here. */
52
52
  export type DependencyModelContractRef = ContractRef;
53
- /** One consuming file, and every contract it depends on -- the inverse of `DependencyModelContract.consumingFiles`. */
53
+ /** One consuming file, and every contract it depends on: the inverse of `DependencyModelContract.consumingFiles`. */
54
54
  export interface DependencyModelConsumer {
55
55
  /** Root-relative, POSIX-separated. */
56
56
  readonly file: string;
57
57
  readonly contracts: readonly DependencyModelContractRef[];
58
58
  }
59
- /** The versioned, JSON-serializable root of the Dependency Model -- see this module's own doc comment for the full picture. */
59
+ /** The versioned, JSON-serializable root of the Dependency Model: see this module's own doc comment for the full picture. */
60
60
  export interface DependencyModel {
61
61
  readonly schemaVersion: typeof DEPENDENCY_MODEL_SCHEMA_VERSION;
62
62
  readonly contracts: readonly DependencyModelContract[];
63
- /** Inverse of `contracts[].consumingFiles` -- one entry per file that consumes at least one contract, listing which contracts it reads. */
63
+ /** Inverse of `contracts[].consumingFiles`: one entry per file that consumes at least one contract, listing which contracts it reads. */
64
64
  readonly consumers: readonly DependencyModelConsumer[];
65
65
  readonly warnings: readonly ParseWarning[];
66
- /** Every surface actually scanned for usage -- see ADR 0036. Always has at least one entry (the application root). */
66
+ /** Every surface actually scanned for usage: see ADR 0036. Always has at least one entry (the application root). */
67
67
  readonly scannedSurfaces: readonly ScannedSurface[];
68
68
  }
69
69
  /**
70
70
  * Runs the dependency-ownership engine (`buildDependencyGraph()`, Private)
71
71
  * and projects its result into the Dependency Model's versioned,
72
- * JSON-serializable shape -- including the inverse file-\>contracts index
72
+ * JSON-serializable shape: including the inverse file-\>contracts index
73
73
  * neither `dependency-graph.ts` nor `usage-report.ts` exposes today.
74
74
  *
75
75
  * @param scannedSurfaces - See `buildDependencyGraph()`'s own parameter of
76
- * the same name -- passed straight through to the published model.
76
+ * the same name: passed straight through to the published model.
77
77
  * @param dynamicAccessAcknowledgments - See `buildDependencyGraph()`'s own
78
- * parameter of the same name (ADR 0037) -- passed straight through.
78
+ * parameter of the same name (ADR 0037): passed straight through.
79
79
  */
80
80
  export declare function buildDependencyModel(contracts: readonly DiscoveredContract[], scanFiles: readonly string[], readFile: (filePath: string) => Promise<string>, context: ImportResolutionContext, root: string, scannedSurfaces?: readonly ScannedSurface[], dynamicAccessAcknowledgments?: ReadonlyMap<string, readonly DynamicAccessAssertion[]>): Promise<DependencyModel>;
81
81
  //# sourceMappingURL=dependency-model.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"dependency-model.d.ts","sourceRoot":"","sources":["../../../src/build/dependency-model.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AACjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAA;AAC7E,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAElF;;;;;;;;;;;GAWG;AAEH,yIAAyI;AACzI,eAAO,MAAM,+BAA+B,IAAI,CAAA;AAEhD;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;IACrC,gLAAgL;IAChL,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAA;IAC7C,mVAAmV;IACnV,QAAQ,CAAC,uBAAuB,EAAE,SAAS,sBAAsB,EAAE,CAAA;CACpE;AAED,2NAA2N;AAC3N,MAAM,WAAW,uBAAuB;IACtC,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAA;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,uBAAuB,EAAE,CAAA;IACtD,6HAA6H;IAC7H,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1C,sJAAsJ;IACtJ,QAAQ,CAAC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAA;IAChD,wGAAwG;IACxG,QAAQ,CAAC,kBAAkB,EAAE,SAAS,cAAc,EAAE,CAAA;CACvD;AAED,6IAA6I;AAC7I,MAAM,MAAM,0BAA0B,GAAG,WAAW,CAAA;AAEpD,uHAAuH;AACvH,MAAM,WAAW,uBAAuB;IACtC,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,SAAS,0BAA0B,EAAE,CAAA;CAC1D;AAED,+HAA+H;AAC/H,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,aAAa,EAAE,OAAO,+BAA+B,CAAA;IAC9D,QAAQ,CAAC,SAAS,EAAE,SAAS,uBAAuB,EAAE,CAAA;IACtD,2IAA2I;IAC3I,QAAQ,CAAC,SAAS,EAAE,SAAS,uBAAuB,EAAE,CAAA;IACtD,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAA;IAC1C,sHAAsH;IACtH,QAAQ,CAAC,eAAe,EAAE,SAAS,cAAc,EAAE,CAAA;CACpD;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,SAAS,kBAAkB,EAAE,EACxC,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAC/C,OAAO,EAAE,uBAAuB,EAChC,IAAI,EAAE,MAAM,EACZ,eAAe,CAAC,EAAE,SAAS,cAAc,EAAE,EAC3C,4BAA4B,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC,GACpF,OAAO,CAAC,eAAe,CAAC,CAmE1B"}
1
+ {"version":3,"file":"dependency-model.d.ts","sourceRoot":"","sources":["../../../src/build/dependency-model.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AACjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAA;AAC7E,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAElF;;;;;;;;;;;GAWG;AAEH,uIAAuI;AACvI,eAAO,MAAM,+BAA+B,IAAI,CAAA;AAEhD;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;IACrC,0GAA0G;IAC1G,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAA;IAC7C,iVAAiV;IACjV,QAAQ,CAAC,uBAAuB,EAAE,SAAS,sBAAsB,EAAE,CAAA;CACpE;AAED,2NAA2N;AAC3N,MAAM,WAAW,uBAAuB;IACtC,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAA;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,uBAAuB,EAAE,CAAA;IACtD,2HAA2H;IAC3H,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1C,sJAAsJ;IACtJ,QAAQ,CAAC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAA;IAChD,sGAAsG;IACtG,QAAQ,CAAC,kBAAkB,EAAE,SAAS,cAAc,EAAE,CAAA;CACvD;AAED,2IAA2I;AAC3I,MAAM,MAAM,0BAA0B,GAAG,WAAW,CAAA;AAEpD,qHAAqH;AACrH,MAAM,WAAW,uBAAuB;IACtC,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,SAAS,0BAA0B,EAAE,CAAA;CAC1D;AAED,6HAA6H;AAC7H,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,aAAa,EAAE,OAAO,+BAA+B,CAAA;IAC9D,QAAQ,CAAC,SAAS,EAAE,SAAS,uBAAuB,EAAE,CAAA;IACtD,yIAAyI;IACzI,QAAQ,CAAC,SAAS,EAAE,SAAS,uBAAuB,EAAE,CAAA;IACtD,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAA;IAC1C,oHAAoH;IACpH,QAAQ,CAAC,eAAe,EAAE,SAAS,cAAc,EAAE,CAAA;CACpD;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,SAAS,kBAAkB,EAAE,EACxC,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAC/C,OAAO,EAAE,uBAAuB,EAChC,IAAI,EAAE,MAAM,EACZ,eAAe,CAAC,EAAE,SAAS,cAAc,EAAE,EAC3C,4BAA4B,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC,GACpF,OAAO,CAAC,eAAe,CAAC,CAoE1B"}