@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.
- package/ADOPTION.md +12 -12
- package/AGENTS.md +85 -120
- package/CHANGELOG.md +36 -0
- package/CODE_REVIEW.md +5 -5
- package/CONTRIBUTING.md +5 -5
- package/GUIDE.md +42 -24
- package/README.md +52 -34
- package/RELEASING.md +78 -64
- package/SECURITY.md +15 -15
- package/VERSIONING.md +16 -15
- package/benchmarks/READING-BENCHMARKS.md +101 -85
- package/benchmarks/README.md +12 -9
- package/benchmarks/WRITING-BENCHMARKS.md +89 -79
- package/benchmarks/performance-buildtime/BENCHMARKS.md +20 -20
- package/benchmarks/performance-runtime/BENCHMARKS.md +107 -107
- package/dist/.dts/_ipc/build-fs.d.ts +3 -3
- package/dist/.dts/_ipc/build-fs.d.ts.map +1 -1
- package/dist/.dts/_ipc/display-path.d.ts +1 -1
- package/dist/.dts/_ipc/glob.d.ts +3 -2
- package/dist/.dts/_ipc/glob.d.ts.map +1 -1
- package/dist/.dts/_ipc/no-node-fs.d.ts +2 -2
- package/dist/.dts/_ipc/resolve-tsconfig-paths.d.ts +16 -16
- package/dist/.dts/_ipc/resolve-tsconfig-paths.d.ts.map +1 -1
- package/dist/.dts/_ipc/typescript.d.ts +4 -4
- package/dist/.dts/build/assemble-project.d.ts +14 -15
- package/dist/.dts/build/assemble-project.d.ts.map +1 -1
- package/dist/.dts/build/change-model.d.ts +14 -14
- package/dist/.dts/build/change-model.d.ts.map +1 -1
- package/dist/.dts/build/check-artifacts.d.ts +4 -4
- package/dist/.dts/build/check-artifacts.d.ts.map +1 -1
- package/dist/.dts/build/citation-verification.d.ts +13 -14
- package/dist/.dts/build/citation-verification.d.ts.map +1 -1
- package/dist/.dts/build/compatibility.d.ts +24 -24
- package/dist/.dts/build/compatibility.d.ts.map +1 -1
- package/dist/.dts/build/contract-model.d.ts +10 -10
- package/dist/.dts/build/contract-model.d.ts.map +1 -1
- package/dist/.dts/build/deep-equal.d.ts +2 -2
- package/dist/.dts/build/deep-freeze.d.ts +2 -2
- package/dist/.dts/build/dependency-graph.d.ts +48 -55
- package/dist/.dts/build/dependency-graph.d.ts.map +1 -1
- package/dist/.dts/build/dependency-model.d.ts +18 -18
- package/dist/.dts/build/dependency-model.d.ts.map +1 -1
- package/dist/.dts/build/discover.d.ts +11 -11
- package/dist/.dts/build/discover.d.ts.map +1 -1
- package/dist/.dts/build/docs.d.ts +34 -38
- package/dist/.dts/build/docs.d.ts.map +1 -1
- package/dist/.dts/build/env-example.d.ts +13 -13
- package/dist/.dts/build/env-example.d.ts.map +1 -1
- package/dist/.dts/build/errors.d.ts +8 -8
- package/dist/.dts/build/evidence-cache.d.ts +23 -23
- package/dist/.dts/build/evidence-cache.d.ts.map +1 -1
- package/dist/.dts/build/evidence-model.d.ts +3 -3
- package/dist/.dts/build/evidence-reference.d.ts +15 -15
- package/dist/.dts/build/evidence-reference.d.ts.map +1 -1
- package/dist/.dts/build/evidence-snapshot.d.ts +47 -53
- package/dist/.dts/build/evidence-snapshot.d.ts.map +1 -1
- package/dist/.dts/build/exclusive-group.d.ts +4 -4
- package/dist/.dts/build/exclusive-group.d.ts.map +1 -1
- package/dist/.dts/build/finding-model.d.ts +12 -12
- package/dist/.dts/build/finding-model.d.ts.map +1 -1
- package/dist/.dts/build/generate-documentation.d.ts +19 -19
- package/dist/.dts/build/generate-documentation.d.ts.map +1 -1
- package/dist/.dts/build/generate-env-artifacts.d.ts +43 -43
- package/dist/.dts/build/generate-env-artifacts.d.ts.map +1 -1
- package/dist/.dts/build/generate-evidence.d.ts +19 -19
- package/dist/.dts/build/generate-evidence.d.ts.map +1 -1
- package/dist/.dts/build/generate-manifest.d.ts +11 -12
- package/dist/.dts/build/generate-manifest.d.ts.map +1 -1
- package/dist/.dts/build/generate-usage.d.ts +23 -24
- package/dist/.dts/build/generate-usage.d.ts.map +1 -1
- package/dist/.dts/build/generated-banner.d.ts +5 -5
- package/dist/.dts/build/governance-fields.d.ts +7 -7
- package/dist/.dts/build/humanize-key.d.ts +1 -1
- package/dist/.dts/build/humanize-key.d.ts.map +1 -1
- package/dist/.dts/build/index.d.ts +20 -36
- package/dist/.dts/build/index.d.ts.map +1 -1
- package/dist/.dts/build/lifecycle-model.d.ts +87 -85
- package/dist/.dts/build/lifecycle-model.d.ts.map +1 -1
- package/dist/.dts/build/link.d.ts +38 -39
- package/dist/.dts/build/link.d.ts.map +1 -1
- package/dist/.dts/build/literal-eval.d.ts +2 -2
- package/dist/.dts/build/literal-eval.d.ts.map +1 -1
- package/dist/.dts/build/live-expirations.d.ts +14 -13
- package/dist/.dts/build/live-expirations.d.ts.map +1 -1
- package/dist/.dts/build/manifest.d.ts +6 -6
- package/dist/.dts/build/map-utils.d.ts +4 -4
- package/dist/.dts/build/merge-documentation.d.ts +9 -8
- package/dist/.dts/build/merge-documentation.d.ts.map +1 -1
- package/dist/.dts/build/ownership-model.d.ts +14 -15
- package/dist/.dts/build/ownership-model.d.ts.map +1 -1
- package/dist/.dts/build/parse.d.ts +20 -21
- package/dist/.dts/build/parse.d.ts.map +1 -1
- package/dist/.dts/build/reference-projections.d.ts +36 -38
- package/dist/.dts/build/reference-projections.d.ts.map +1 -1
- package/dist/.dts/build/resolution/resolve-import.d.ts +18 -14
- package/dist/.dts/build/resolution/resolve-import.d.ts.map +1 -1
- package/dist/.dts/build/resolution/resolve-package-schema.d.ts +26 -26
- package/dist/.dts/build/resolution/resolve-package-schema.d.ts.map +1 -1
- package/dist/.dts/build/resolution/resolve-within-root.d.ts +9 -9
- package/dist/.dts/build/sarif.d.ts +5 -5
- package/dist/.dts/build/sarif.d.ts.map +1 -1
- package/dist/.dts/build/scan-dependencies.d.ts +17 -16
- package/dist/.dts/build/scan-dependencies.d.ts.map +1 -1
- package/dist/.dts/build/sort-by-identity.d.ts +1 -1
- package/dist/.dts/build/source-position.d.ts +13 -13
- package/dist/.dts/build/tool-version.d.ts +1 -1
- package/dist/.dts/build/usage-report.d.ts +19 -19
- package/dist/.dts/build/usage-report.d.ts.map +1 -1
- package/dist/.dts/eslint-plugin/index.d.ts +16 -5
- package/dist/.dts/eslint-plugin/index.d.ts.map +1 -1
- package/dist/.dts/eslint-plugin/no-raw-process-env.d.ts +4 -4
- package/dist/.dts/evidence/define-projection.d.ts +15 -16
- package/dist/.dts/evidence/define-projection.d.ts.map +1 -1
- package/dist/.dts/evidence/index.d.ts +11 -15
- package/dist/.dts/evidence/index.d.ts.map +1 -1
- package/dist/.dts/helpers/index.d.ts +15 -18
- package/dist/.dts/helpers/index.d.ts.map +1 -1
- package/dist/.dts/helpers/validators.d.ts +2 -2
- package/dist/.dts/helpers/validators.d.ts.map +1 -1
- package/dist/.dts/node/index.d.ts +19 -0
- package/dist/.dts/node/index.d.ts.map +1 -1
- package/dist/.dts/runtime/create.d.ts +3 -3
- package/dist/.dts/runtime/document.d.ts +90 -99
- package/dist/.dts/runtime/document.d.ts.map +1 -1
- package/dist/.dts/runtime/errors.d.ts +5 -5
- package/dist/.dts/runtime/reset.d.ts +1 -1
- package/dist/.dts/runtime/types.d.ts +23 -24
- package/dist/.dts/runtime/types.d.ts.map +1 -1
- package/dist/.dts/runtime/validate.d.ts +1 -1
- package/dist/.dts7/_ipc/build-fs.d.ts +3 -3
- package/dist/.dts7/_ipc/build-fs.d.ts.map +1 -1
- package/dist/.dts7/_ipc/display-path.d.ts +1 -1
- package/dist/.dts7/_ipc/glob.d.ts +3 -2
- package/dist/.dts7/_ipc/glob.d.ts.map +1 -1
- package/dist/.dts7/_ipc/no-node-fs.d.ts +2 -2
- package/dist/.dts7/_ipc/resolve-tsconfig-paths.d.ts +16 -16
- package/dist/.dts7/_ipc/resolve-tsconfig-paths.d.ts.map +1 -1
- package/dist/.dts7/_ipc/typescript.d.ts +4 -4
- package/dist/.dts7/build/assemble-project.d.ts +14 -15
- package/dist/.dts7/build/assemble-project.d.ts.map +1 -1
- package/dist/.dts7/build/change-model.d.ts +14 -14
- package/dist/.dts7/build/change-model.d.ts.map +1 -1
- package/dist/.dts7/build/check-artifacts.d.ts +4 -4
- package/dist/.dts7/build/check-artifacts.d.ts.map +1 -1
- package/dist/.dts7/build/citation-verification.d.ts +13 -14
- package/dist/.dts7/build/citation-verification.d.ts.map +1 -1
- package/dist/.dts7/build/compatibility.d.ts +24 -24
- package/dist/.dts7/build/compatibility.d.ts.map +1 -1
- package/dist/.dts7/build/contract-model.d.ts +10 -10
- package/dist/.dts7/build/contract-model.d.ts.map +1 -1
- package/dist/.dts7/build/deep-equal.d.ts +2 -2
- package/dist/.dts7/build/deep-freeze.d.ts +2 -2
- package/dist/.dts7/build/dependency-graph.d.ts +48 -55
- package/dist/.dts7/build/dependency-graph.d.ts.map +1 -1
- package/dist/.dts7/build/dependency-model.d.ts +18 -18
- package/dist/.dts7/build/dependency-model.d.ts.map +1 -1
- package/dist/.dts7/build/discover.d.ts +11 -11
- package/dist/.dts7/build/discover.d.ts.map +1 -1
- package/dist/.dts7/build/docs.d.ts +34 -38
- package/dist/.dts7/build/docs.d.ts.map +1 -1
- package/dist/.dts7/build/env-example.d.ts +13 -13
- package/dist/.dts7/build/env-example.d.ts.map +1 -1
- package/dist/.dts7/build/errors.d.ts +8 -8
- package/dist/.dts7/build/evidence-cache.d.ts +23 -23
- package/dist/.dts7/build/evidence-cache.d.ts.map +1 -1
- package/dist/.dts7/build/evidence-model.d.ts +3 -3
- package/dist/.dts7/build/evidence-reference.d.ts +15 -15
- package/dist/.dts7/build/evidence-reference.d.ts.map +1 -1
- package/dist/.dts7/build/evidence-snapshot.d.ts +47 -53
- package/dist/.dts7/build/evidence-snapshot.d.ts.map +1 -1
- package/dist/.dts7/build/exclusive-group.d.ts +4 -4
- package/dist/.dts7/build/exclusive-group.d.ts.map +1 -1
- package/dist/.dts7/build/finding-model.d.ts +12 -12
- package/dist/.dts7/build/finding-model.d.ts.map +1 -1
- package/dist/.dts7/build/generate-documentation.d.ts +19 -19
- package/dist/.dts7/build/generate-documentation.d.ts.map +1 -1
- package/dist/.dts7/build/generate-env-artifacts.d.ts +43 -43
- package/dist/.dts7/build/generate-env-artifacts.d.ts.map +1 -1
- package/dist/.dts7/build/generate-evidence.d.ts +19 -19
- package/dist/.dts7/build/generate-evidence.d.ts.map +1 -1
- package/dist/.dts7/build/generate-manifest.d.ts +11 -12
- package/dist/.dts7/build/generate-manifest.d.ts.map +1 -1
- package/dist/.dts7/build/generate-usage.d.ts +23 -24
- package/dist/.dts7/build/generate-usage.d.ts.map +1 -1
- package/dist/.dts7/build/generated-banner.d.ts +5 -5
- package/dist/.dts7/build/governance-fields.d.ts +7 -7
- package/dist/.dts7/build/humanize-key.d.ts +1 -1
- package/dist/.dts7/build/humanize-key.d.ts.map +1 -1
- package/dist/.dts7/build/index.d.ts +20 -36
- package/dist/.dts7/build/index.d.ts.map +1 -1
- package/dist/.dts7/build/lifecycle-model.d.ts +87 -85
- package/dist/.dts7/build/lifecycle-model.d.ts.map +1 -1
- package/dist/.dts7/build/link.d.ts +38 -39
- package/dist/.dts7/build/link.d.ts.map +1 -1
- package/dist/.dts7/build/literal-eval.d.ts +2 -2
- package/dist/.dts7/build/literal-eval.d.ts.map +1 -1
- package/dist/.dts7/build/live-expirations.d.ts +14 -13
- package/dist/.dts7/build/live-expirations.d.ts.map +1 -1
- package/dist/.dts7/build/manifest.d.ts +6 -6
- package/dist/.dts7/build/map-utils.d.ts +4 -4
- package/dist/.dts7/build/merge-documentation.d.ts +9 -8
- package/dist/.dts7/build/merge-documentation.d.ts.map +1 -1
- package/dist/.dts7/build/ownership-model.d.ts +14 -15
- package/dist/.dts7/build/ownership-model.d.ts.map +1 -1
- package/dist/.dts7/build/parse.d.ts +20 -21
- package/dist/.dts7/build/parse.d.ts.map +1 -1
- package/dist/.dts7/build/reference-projections.d.ts +36 -38
- package/dist/.dts7/build/reference-projections.d.ts.map +1 -1
- package/dist/.dts7/build/resolution/resolve-import.d.ts +18 -14
- package/dist/.dts7/build/resolution/resolve-import.d.ts.map +1 -1
- package/dist/.dts7/build/resolution/resolve-package-schema.d.ts +26 -26
- package/dist/.dts7/build/resolution/resolve-package-schema.d.ts.map +1 -1
- package/dist/.dts7/build/resolution/resolve-within-root.d.ts +9 -9
- package/dist/.dts7/build/sarif.d.ts +5 -5
- package/dist/.dts7/build/sarif.d.ts.map +1 -1
- package/dist/.dts7/build/scan-dependencies.d.ts +17 -16
- package/dist/.dts7/build/scan-dependencies.d.ts.map +1 -1
- package/dist/.dts7/build/sort-by-identity.d.ts +1 -1
- package/dist/.dts7/build/source-position.d.ts +13 -13
- package/dist/.dts7/build/tool-version.d.ts +1 -1
- package/dist/.dts7/build/usage-report.d.ts +19 -19
- package/dist/.dts7/build/usage-report.d.ts.map +1 -1
- package/dist/.dts7/eslint-plugin/index.d.ts +16 -5
- package/dist/.dts7/eslint-plugin/index.d.ts.map +1 -1
- package/dist/.dts7/eslint-plugin/no-raw-process-env.d.ts +4 -4
- package/dist/.dts7/evidence/define-projection.d.ts +15 -16
- package/dist/.dts7/evidence/define-projection.d.ts.map +1 -1
- package/dist/.dts7/evidence/index.d.ts +11 -15
- package/dist/.dts7/evidence/index.d.ts.map +1 -1
- package/dist/.dts7/helpers/index.d.ts +15 -18
- package/dist/.dts7/helpers/index.d.ts.map +1 -1
- package/dist/.dts7/helpers/validators.d.ts +2 -2
- package/dist/.dts7/helpers/validators.d.ts.map +1 -1
- package/dist/.dts7/node/index.d.ts +19 -0
- package/dist/.dts7/node/index.d.ts.map +1 -1
- package/dist/.dts7/runtime/create.d.ts +3 -3
- package/dist/.dts7/runtime/document.d.ts +90 -99
- package/dist/.dts7/runtime/document.d.ts.map +1 -1
- package/dist/.dts7/runtime/errors.d.ts +5 -5
- package/dist/.dts7/runtime/reset.d.ts +1 -1
- package/dist/.dts7/runtime/types.d.ts +23 -24
- package/dist/.dts7/runtime/types.d.ts.map +1 -1
- package/dist/.dts7/runtime/validate.d.ts +1 -1
- package/dist/{build-DNAYWD2B.js → build-33O5SDTC.js} +37 -39
- package/dist/build-33O5SDTC.js.map +1 -0
- package/dist/build.cjs +36 -38
- package/dist/build.cjs.map +1 -1
- package/dist/build.js +36 -38
- package/dist/build.js.map +1 -1
- package/dist/{chunk-HAGMVMN5.js → chunk-4D67AQFY.js} +2 -2
- package/dist/cli/index.js +29 -28
- package/dist/cli/index.js.map +1 -1
- package/dist/eslint-plugin/index.cjs.map +1 -1
- package/dist/eslint-plugin/index.js.map +1 -1
- package/dist/evidence.cjs +1 -1
- package/dist/evidence.cjs.map +1 -1
- package/dist/evidence.js +1 -1
- package/dist/evidence.js.map +1 -1
- package/dist/helpers.cjs +4 -4
- package/dist/helpers.cjs.map +1 -1
- package/dist/helpers.js +4 -4
- package/dist/helpers.js.map +1 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.js.map +1 -1
- package/examples/README.md +1 -1
- package/package.json +20 -13
- package/schemas/contract-model.schema.json +7 -7
- package/schemas/env-cap-report.schema.json +88 -88
- package/skills/env-cap/SKILL.md +12 -13
- package/skills/env-cap/references/api.md +1 -1
- package/specs/architecture.md +145 -120
- package/specs/decisions/0049-typescript-7-scanner-uses-a-bundled-typescript-6.md +9 -0
- package/specs/generated-artifacts.md +78 -70
- package/specs/migrations/README.md +6 -6
- package/specs/migrations/from-centralized-schema.md +1 -1
- package/specs/migrations/from-t3-env.md +9 -9
- package/PROMPT.md +0 -89
- package/dist/build-DNAYWD2B.js.map +0 -1
- /package/dist/{chunk-HAGMVMN5.js.map → chunk-4D67AQFY.js.map} +0 -0
|
@@ -10,25 +10,22 @@ import type { BuildFileSystem } from "./types.js";
|
|
|
10
10
|
* The persisted evidence artifact and everything that reads/diffs it.
|
|
11
11
|
*
|
|
12
12
|
* Not a sibling of `env.manifest.ts`. `env.manifest.ts` is a *runtime build
|
|
13
|
-
* artifact
|
|
13
|
+
* artifact*: real TypeScript, imported and executed by the running
|
|
14
14
|
* application. This module's own artifact is a *CI/reporting artifact*: the
|
|
15
15
|
* literal `EvidenceModel` a caller gets back from `generateEvidenceModel()`,
|
|
16
|
-
* serialized to disk
|
|
17
|
-
*
|
|
18
|
-
*
|
|
19
|
-
*
|
|
20
|
-
*
|
|
21
|
-
* anymore); a caller supplies it directly, independent of whether a `.ts`
|
|
22
|
-
* manifest is even being generated at all.
|
|
16
|
+
* serialized to disk. Only `--check`, CI tooling and a project's own
|
|
17
|
+
* reporting/projection code read it. Nothing under `src/runtime/` imports it,
|
|
18
|
+
* and it is never a build input to the application itself. Its location is never derived from a
|
|
19
|
+
* manifest's own output path; there is no `<manifest>.snapshot.json` sidecar. A caller supplies
|
|
20
|
+
* it directly, whether or not a `.ts` manifest is being generated at all.
|
|
23
21
|
*
|
|
24
|
-
* Two jobs, one file
|
|
25
|
-
*
|
|
26
|
-
*
|
|
27
|
-
*
|
|
28
|
-
*
|
|
29
|
-
*
|
|
30
|
-
* run
|
|
31
|
-
* first-run state, never an error.
|
|
22
|
+
* Two jobs, one file. (a) It is the baseline `diffContracts()` compares the
|
|
23
|
+
* current run's `ContractModel` against to produce `ManifestChangeReport`.
|
|
24
|
+
* (b) It is the committed content-hash baseline `buildCitationSnapshots()`
|
|
25
|
+
* (`citation-verification.ts`) uses to tell a "fresh" developer
|
|
26
|
+
* dynamic-access citation from a "stale" one (ADR 0037).
|
|
27
|
+
* A project chooses whether to commit this file or regenerate it every CI
|
|
28
|
+
* run. A missing file is always the normal first-run state, never an error.
|
|
32
29
|
*/
|
|
33
30
|
/** One field's before/after value in a {@link ManifestContractUpdate} or {@link ManifestVariableUpdate}. */
|
|
34
31
|
export interface ManifestFieldChange {
|
|
@@ -39,9 +36,9 @@ export interface ManifestFieldChange {
|
|
|
39
36
|
/** The value in the current run, or `undefined` if the field is now unset. */
|
|
40
37
|
readonly current: string | undefined;
|
|
41
38
|
}
|
|
42
|
-
/** Identifies one contract for {@link ManifestChangeReport} purposes
|
|
39
|
+
/** Identifies one contract for {@link ManifestChangeReport} purposes: see {@link ContractRef} for why neither a `contractName` nor a pre-formatted `identity` is carried here. */
|
|
43
40
|
export type ManifestContractRef = ContractRef;
|
|
44
|
-
/** Identifies one variable for {@link ManifestChangeReport} purposes
|
|
41
|
+
/** Identifies one variable for {@link ManifestChangeReport} purposes: its owning contract's identity plus its own key. See {@link ContractRef}. */
|
|
45
42
|
export interface ManifestVariableRef extends ContractRef {
|
|
46
43
|
/** The environment variable name. */
|
|
47
44
|
readonly key: string;
|
|
@@ -57,15 +54,13 @@ export interface ManifestVariableUpdate extends ManifestVariableRef {
|
|
|
57
54
|
readonly changes: readonly ManifestFieldChange[];
|
|
58
55
|
}
|
|
59
56
|
/**
|
|
60
|
-
* The result of diffing two `ContractModel.contracts` arrays
|
|
61
|
-
* `diffContracts()`. Comprehensive by construction
|
|
62
|
-
* `ContractModelContract`/`ContractModelVariable`
|
|
63
|
-
* `hasDefault`/`processorSource`/`validatorSource`/...
|
|
64
|
-
*
|
|
65
|
-
*
|
|
66
|
-
*
|
|
67
|
-
* Contract Model gains a field; the generic differ below can't drift out of
|
|
68
|
-
* sync with the model it diffs.
|
|
57
|
+
* The result of diffing two `ContractModel.contracts` arrays: see
|
|
58
|
+
* `diffContracts()`. Comprehensive by construction. Every own field of
|
|
59
|
+
* `ContractModelContract`/`ContractModelVariable` participates: schema facts
|
|
60
|
+
* (`hasDefault`/`processorSource`/`validatorSource`/...) and documented
|
|
61
|
+
* metadata. Every discovered contract is covered, not only active ones.
|
|
62
|
+
* `diffContracts()` compares every field generically, so a new Contract Model
|
|
63
|
+
* field is diffed without an edit here.
|
|
69
64
|
*/
|
|
70
65
|
export interface ManifestChangeReport {
|
|
71
66
|
/** Contracts present now but not in the previous snapshot. */
|
|
@@ -82,7 +77,7 @@ export interface ManifestChangeReport {
|
|
|
82
77
|
readonly updatedVariables: readonly ManifestVariableUpdate[];
|
|
83
78
|
}
|
|
84
79
|
/**
|
|
85
|
-
* Pure. `previous === undefined` (no snapshot last time, for any reason
|
|
80
|
+
* Pure. `previous === undefined` (no snapshot last time, for any reason:
|
|
86
81
|
* see `EvidenceSnapshotReadResult`) reports everything in `current` as
|
|
87
82
|
* added, nothing as removed/updated.
|
|
88
83
|
*/
|
|
@@ -103,46 +98,45 @@ export type EvidenceSnapshotReadResult = {
|
|
|
103
98
|
export declare function readEvidenceSnapshot(snapshotPath: string, fs: BuildFileSystem): Promise<EvidenceSnapshotReadResult>;
|
|
104
99
|
export declare function writeEvidenceSnapshot(snapshotPath: string, snapshot: EvidenceModel, fs: BuildFileSystem): Promise<void>;
|
|
105
100
|
/**
|
|
106
|
-
* `snapshot`, with two fields normalized to a constant
|
|
101
|
+
* `snapshot`, with two fields normalized to a constant: the comparison
|
|
107
102
|
* basis `--check` uses:
|
|
108
103
|
*
|
|
109
104
|
* - `provenance.generatedAt` is a live timestamp stamped fresh on every real
|
|
110
|
-
* `generate` run
|
|
111
|
-
*
|
|
112
|
-
* time, even with zero real changes
|
|
113
|
-
*
|
|
114
|
-
*
|
|
115
|
-
* `generate` run it's verifying, not something that varies on its own.
|
|
105
|
+
* `generate` run. The two renders' timestamps can never match. So a
|
|
106
|
+
* byte-for-byte comparison with a copy rendered for `--check` would report
|
|
107
|
+
* drift every time, even with zero real changes. `toolVersion`/`commit`
|
|
108
|
+
* stay compared as-is. Both are stable provenance across a `--check` run
|
|
109
|
+
* and the `generate` run it verifies; neither varies on its own.
|
|
116
110
|
* - `change` describes "what's different from whatever snapshot was on disk
|
|
117
|
-
* the moment this run computed it"
|
|
118
|
-
*
|
|
119
|
-
*
|
|
120
|
-
*
|
|
121
|
-
*
|
|
122
|
-
*
|
|
123
|
-
*
|
|
124
|
-
*
|
|
125
|
-
*
|
|
126
|
-
*
|
|
127
|
-
*
|
|
128
|
-
*
|
|
111
|
+
* the moment this run computed it". A second computation cannot reproduce
|
|
112
|
+
* it. By the time `--check` re-derives it, the file just written *is* the
|
|
113
|
+
* new baseline, so the diff comes back empty against itself. This isn't
|
|
114
|
+
* drift; it's `change`'s own definition. So `--check` doesn't re-verify it,
|
|
115
|
+
* the same treatment as `generatedAt`.
|
|
116
|
+
* - every `now`-relative expiry countdown is the same class as `generatedAt`.
|
|
117
|
+
* That covers `lifecycle.expiring[].daysRemaining` and the day-count inside
|
|
118
|
+
* an `EXPIRED`/`EXPIRING_SOON` finding message. A static `expiresAt`
|
|
119
|
+
* produces a different number every day. So a committed artifact would go
|
|
120
|
+
* "stale" with zero real edits. These are normalized to a constant, so
|
|
121
|
+
* `--check` (and the golden tests) verify the substance, not the calendar.
|
|
122
|
+
* The raw `expiresAt` strings stay compared.
|
|
129
123
|
*/
|
|
130
124
|
export declare function normalizeEvidenceSnapshotForComparison(snapshot: EvidenceModel): EvidenceModel;
|
|
131
|
-
/** Everything reading a previous evidence snapshot and diffing the current run against it produces, in one call. Never writes anything itself
|
|
125
|
+
/** Everything reading a previous evidence snapshot and diffing the current run against it produces, in one call. Never writes anything itself: writing the fresh snapshot stays a separate, explicit step on the real write path. */
|
|
132
126
|
export interface EvidenceChangesComputation {
|
|
133
127
|
readonly report: ManifestChangeReport;
|
|
134
|
-
/** Set only when the previous snapshot existed but was unusable (corrupt JSON or an unrecognized `schemaVersion`)
|
|
128
|
+
/** Set only when the previous snapshot existed but was unusable (corrupt JSON or an unrecognized `schemaVersion`). Never set for the ordinary "no snapshot yet" first-run case. */
|
|
135
129
|
readonly readWarning: ParseWarning | undefined;
|
|
136
130
|
readonly dynamicAccessAcknowledgments: ReadonlyMap<string, readonly DynamicAccessAssertion[]>;
|
|
137
131
|
readonly dynamicAccessCitationProblems: readonly DynamicAccessCitationProblem[];
|
|
138
132
|
}
|
|
139
133
|
/**
|
|
140
134
|
* The one I/O-performing helper every caller wanting change/citation-freshness
|
|
141
|
-
* data shares
|
|
142
|
-
* given and a file exists there)
|
|
135
|
+
* data shares. It reads the previous evidence snapshot (if `snapshotPath` is
|
|
136
|
+
* given and a file exists there). It diffs the current run's `ContractModel`
|
|
143
137
|
* against it, and re-checks every current `dynamicAccess` citation's
|
|
144
|
-
* freshness. `snapshotPath` is always caller-supplied,
|
|
145
|
-
*
|
|
138
|
+
* freshness. `snapshotPath` is always caller-supplied, never derived from a
|
|
139
|
+
* manifest's own output path.
|
|
146
140
|
*/
|
|
147
141
|
export declare function computeEvidenceChanges(root: string, snapshotPath: string, activeContracts: readonly DiscoveredContract[], currentContracts: readonly ContractModelContract[], readFile: (filePath: string) => Promise<string>, fs: BuildFileSystem): Promise<EvidenceChangesComputation>;
|
|
148
142
|
//# sourceMappingURL=evidence-snapshot.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"evidence-snapshot.d.ts","sourceRoot":"","sources":["../../../src/build/evidence-snapshot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAA;AAE9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAyB,MAAM,qBAAqB,CAAA;AACvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD
|
|
1
|
+
{"version":3,"file":"evidence-snapshot.d.ts","sourceRoot":"","sources":["../../../src/build/evidence-snapshot.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import type { CompatibilityIssue } from "./compatibility.js";
|
|
2
2
|
import type { DiscoveredContract } from "./link.js";
|
|
3
3
|
/**
|
|
4
|
-
* Detects two *active* contracts declaring the same `exclusiveGroup
|
|
4
|
+
* Detects two *active* contracts declaring the same `exclusiveGroup`:
|
|
5
5
|
* e.g. two interchangeable database backends both left enabled at once.
|
|
6
6
|
*
|
|
7
7
|
* @remarks
|
|
@@ -11,9 +11,9 @@ import type { DiscoveredContract } from "./link.js";
|
|
|
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
|
|
14
|
-
* the caller) so this stays correct
|
|
15
|
-
*
|
|
16
|
-
*
|
|
14
|
+
* the caller), so this stays correct when called directly via the `/build`
|
|
15
|
+
* export. An inactive contract can share a group with an active one with no
|
|
16
|
+
* conflict, since it was never wired into anything.
|
|
17
17
|
*/
|
|
18
18
|
export declare function detectExclusiveGroupIssues(contracts: readonly DiscoveredContract[]): CompatibilityIssue[];
|
|
19
19
|
//# sourceMappingURL=exclusive-group.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"exclusive-group.d.ts","sourceRoot":"","sources":["../../../src/build/exclusive-group.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAEnD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,SAAS,kBAAkB,EAAE,GACvC,kBAAkB,EAAE,
|
|
1
|
+
{"version":3,"file":"exclusive-group.d.ts","sourceRoot":"","sources":["../../../src/build/exclusive-group.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAEnD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,SAAS,kBAAkB,EAAE,GACvC,kBAAkB,EAAE,CA8BtB"}
|
|
@@ -5,14 +5,14 @@ import type { DocumentationFindings } from "./generate-documentation.js";
|
|
|
5
5
|
import type { DynamicAccessCitationProblem } from "./citation-verification.js";
|
|
6
6
|
import type { AbandonedContractFinding, IndeterminateOwnershipFinding, UnconsumedOwnedVariableFinding, UnresolvedConsumerFinding } from "./usage-report.js";
|
|
7
7
|
/**
|
|
8
|
-
* The fourth of env-cap's seven canonical fact models (ADR 0024)
|
|
8
|
+
* The fourth of env-cap's seven canonical fact models (ADR 0024): every
|
|
9
9
|
* rule violation and derived risk signal, unified behind one shape, with a
|
|
10
10
|
* stable `code` and a structured {@link EvidenceReference} instead of four
|
|
11
11
|
* independently-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";
|
|
15
|
-
/** Which source check produced a {@link Finding}
|
|
15
|
+
/** Which source check produced a {@link Finding}: coarser than `code`, for a consumer that only wants to filter by kind (e.g. "show me every documentation gap") without enumerating every individual code. */
|
|
16
16
|
export type FindingFamily = "compatibility" | "drift" | "documentation" | "ownership";
|
|
17
17
|
/** One rule violation or derived signal, in the Finding Model's canonical shape. */
|
|
18
18
|
export interface Finding {
|
|
@@ -21,11 +21,11 @@ export interface Finding {
|
|
|
21
21
|
* exclusive-group conflict); `"warning"` for everything gated by
|
|
22
22
|
* `onIncompatibility`/`onUndocumented`/`onOwnershipIssue`'s default "warn"
|
|
23
23
|
* behavior; `"info"` for an observation that is never actionable enough to
|
|
24
|
-
* block anything, even under `--strict
|
|
24
|
+
* block anything, even under `--strict`: see `INFO_ONLY_CODES` in
|
|
25
25
|
* `generate-env-artifacts.ts`.
|
|
26
26
|
*/
|
|
27
27
|
readonly severity: "error" | "warning" | "info";
|
|
28
|
-
/** Stable, machine-readable identifier
|
|
28
|
+
/** Stable, machine-readable identifier: always set, unlike {@link CompatibilityIssue.code} which stays optional on that narrower, pre-existing type. */
|
|
29
29
|
readonly code: FindingCode;
|
|
30
30
|
/** Which source check produced this finding. */
|
|
31
31
|
readonly family: FindingFamily;
|
|
@@ -34,27 +34,27 @@ export interface Finding {
|
|
|
34
34
|
/** Structured pointer back to what this finding is about. */
|
|
35
35
|
readonly location: EvidenceReference;
|
|
36
36
|
}
|
|
37
|
-
/** Bump only when a reader could misinterpret the new shape
|
|
37
|
+
/** Bump only when a reader could misinterpret the new shape: same discipline every other canonical model's `schemaVersion` follows. */
|
|
38
38
|
export declare const FINDING_MODEL_SCHEMA_VERSION = 3;
|
|
39
|
-
/** The versioned, JSON-serializable root of the Finding Model
|
|
39
|
+
/** The versioned, JSON-serializable root of the Finding Model: every rule violation and derived risk signal from this run, unified behind {@link Finding}'s one shape. See this module's own doc comment for the full picture. */
|
|
40
40
|
export interface FindingModel {
|
|
41
41
|
readonly schemaVersion: typeof FINDING_MODEL_SCHEMA_VERSION;
|
|
42
42
|
readonly findings: readonly Finding[];
|
|
43
43
|
}
|
|
44
44
|
/**
|
|
45
|
-
* Every source a {@link buildFindingModel} call can adapt, all optional
|
|
45
|
+
* Every source a {@link buildFindingModel} call can adapt, all optional:
|
|
46
46
|
* a caller passes whichever of `generateEnvArtifacts()`'s `manifest`/`docs`/
|
|
47
47
|
* `usage` results it actually requested, exactly like that result's own
|
|
48
48
|
* top-level fields are each independently optional.
|
|
49
49
|
*/
|
|
50
50
|
export interface BuildFindingModelInput {
|
|
51
|
-
/** Every `EvidenceReference.file` below is rendered relative to this, matching every other rendered path in this package's output
|
|
51
|
+
/** Every `EvidenceReference.file` below is rendered relative to this, matching every other rendered path in this package's output: see `displayPath()`. */
|
|
52
52
|
readonly root: string;
|
|
53
53
|
/** From `detectCompatibilityIssues()`. */
|
|
54
54
|
readonly compatibilityIssues?: readonly CompatibilityIssue[];
|
|
55
|
-
/** From `detectExclusiveGroupIssues()
|
|
55
|
+
/** From `detectExclusiveGroupIssues()`: kept separate from `compatibilityIssues` since it never sets its own `code` yet (ADR 0009), so this adapter synthesizes `"EXCLUSIVE_GROUP_VIOLATION"` for every entry. */
|
|
56
56
|
readonly exclusiveGroupIssues?: readonly CompatibilityIssue[];
|
|
57
|
-
/** From `checkEnvArtifacts()`'s result. Only `"stale"`/`"missing"` findings become a `Finding
|
|
57
|
+
/** From `checkEnvArtifacts()`'s result. Only `"stale"`/`"missing"` findings become a `Finding`: `"ok"` means nothing to report. */
|
|
58
58
|
readonly artifactCheckFindings?: readonly ArtifactCheckFinding[];
|
|
59
59
|
/** From `generateDocumentation()`'s result. */
|
|
60
60
|
readonly documentation?: DocumentationFindings;
|
|
@@ -66,12 +66,12 @@ export interface BuildFindingModelInput {
|
|
|
66
66
|
readonly unconsumedOwnedVariables?: readonly UnconsumedOwnedVariableFinding[];
|
|
67
67
|
/** From `generateUsageReport()`'s result. */
|
|
68
68
|
readonly indeterminateOwnership?: readonly IndeterminateOwnershipFinding[];
|
|
69
|
-
/** From `computeManifestChanges()`'s result
|
|
69
|
+
/** From `computeManifestChanges()`'s result: every `dynamicAccess` citation that's gone `"stale"` or `"missing"` since it was last acknowledged. See ADR 0037. */
|
|
70
70
|
readonly dynamicAccessCitationProblems?: readonly DynamicAccessCitationProblem[] | undefined;
|
|
71
71
|
}
|
|
72
72
|
/**
|
|
73
73
|
* Adapts every existing finding family into the Finding Model's unified
|
|
74
|
-
* shape
|
|
74
|
+
* shape: an adapter over data that already exists, not a new source of
|
|
75
75
|
* truth. Order of the returned array mirrors the order sources are given
|
|
76
76
|
* above; a consumer wanting a specific order (by severity, by file, ...)
|
|
77
77
|
* sorts it themselves.
|
|
@@ -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
|
|
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"}
|
|
@@ -7,7 +7,7 @@ import type { ParseWarning } from "./parse.js";
|
|
|
7
7
|
import type { BuildFileSystem } from "./types.js";
|
|
8
8
|
/** Options for {@link generateDocumentation}. */
|
|
9
9
|
export interface GenerateDocumentationOptions {
|
|
10
|
-
/** The filesystem capability
|
|
10
|
+
/** The filesystem capability: `./build` never imports `node:fs` (ADR 0040). */
|
|
11
11
|
fs: BuildFileSystem;
|
|
12
12
|
/** Project root schema discovery is relative to. Defaults to `process.cwd()`. */
|
|
13
13
|
root?: string | undefined;
|
|
@@ -25,7 +25,7 @@ export interface GenerateDocumentationOptions {
|
|
|
25
25
|
expiringWithinDays?: number | undefined;
|
|
26
26
|
/**
|
|
27
27
|
* Also emit a `.env.example`-style file, relative to `root`. `onExisting`
|
|
28
|
-
* controls what happens when a file already exists there
|
|
28
|
+
* controls what happens when a file already exists there: defaults to
|
|
29
29
|
* `"keep-sibling"` (never overwrites; see `EnvExampleOnExisting` and
|
|
30
30
|
* `EnvExampleResult`).
|
|
31
31
|
*/
|
|
@@ -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
|
|
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. */
|
|
47
47
|
export interface DocumentationFindings {
|
|
48
48
|
/** Contracts with no linked `documentEnv()` call at all. */
|
|
49
49
|
readonly undocumentedContracts: readonly {
|
|
@@ -72,7 +72,7 @@ export interface DocumentationFindings {
|
|
|
72
72
|
}[];
|
|
73
73
|
/** Variables whose `expiresAt` falls within the configured window. */
|
|
74
74
|
readonly expiringSoon: readonly ExpiringEntry[];
|
|
75
|
-
/** Contract- or variable-level `sensitivity` values outside {@link STANDARD_SENSITIVITY_LEVELS}. Advisory only
|
|
75
|
+
/** Contract- or variable-level `sensitivity` values outside {@link STANDARD_SENSITIVITY_LEVELS}. Advisory only: the declared level is always honored verbatim; this exists purely so vocabulary drift across a repo stays visible. */
|
|
76
76
|
readonly nonstandardSensitivityLevels: readonly NonstandardSensitivityEntry[];
|
|
77
77
|
/** `documentEnv()` calls that couldn't be statically linked to a schema. */
|
|
78
78
|
readonly unresolvedLinks: readonly {
|
|
@@ -91,7 +91,7 @@ export interface GenerateDocumentationResult {
|
|
|
91
91
|
/** Root-relative summary of every discovered contract, active or not. */
|
|
92
92
|
readonly contracts: readonly DiscoveredContractSummary[];
|
|
93
93
|
/** Same descriptive content as the generated Markdown Catalog, reshaped for
|
|
94
|
-
* programmatic consumers
|
|
94
|
+
* programmatic consumers: see `buildCatalog()` in `docs.ts`. */
|
|
95
95
|
readonly catalog: readonly CatalogContract[];
|
|
96
96
|
/** Parse-time warnings collected across every analyzed file (including allow-listed package resolution). */
|
|
97
97
|
readonly parseWarnings: readonly ParseWarning[];
|
|
@@ -106,9 +106,9 @@ export declare const DEFAULT_EXPIRING_WITHIN_DAYS = 30;
|
|
|
106
106
|
* `string` (see {@link runtime.VariableDocs.sensitivity}), any value is
|
|
107
107
|
* honored verbatim, and nothing here ever drops or rewrites a declared level.
|
|
108
108
|
* A level outside this set only produces a non-blocking
|
|
109
|
-
* `NONSTANDARD_SENSITIVITY_LEVEL` finding
|
|
110
|
-
*
|
|
111
|
-
*
|
|
109
|
+
* `NONSTANDARD_SENSITIVITY_LEVEL` finding. A team that deliberately runs its
|
|
110
|
+
* own vocabulary sees one advisory line rather than silent data loss. A team
|
|
111
|
+
* that meant to write `"secret"` and typo'd `"secrets"` finds out.
|
|
112
112
|
*/
|
|
113
113
|
export declare const STANDARD_SENSITIVITY_LEVELS: ReadonlySet<string>;
|
|
114
114
|
/** One contract- or variable-level `sensitivity` declaring a level outside {@link STANDARD_SENSITIVITY_LEVELS}. */
|
|
@@ -127,7 +127,7 @@ export interface NonstandardSensitivityEntry {
|
|
|
127
127
|
* in declaration order (contract first, then its own variables by key).
|
|
128
128
|
*
|
|
129
129
|
* @remarks
|
|
130
|
-
* A variable's *own* declared level only
|
|
130
|
+
* A variable's *own* declared level only: never the contract-inherited one
|
|
131
131
|
* `effectiveSensitivity()` would resolve to. Reporting the inherited value
|
|
132
132
|
* would fire this same finding once per variable on a contract that already
|
|
133
133
|
* produced its own contract-level entry, turning one real vocabulary
|
|
@@ -138,21 +138,21 @@ export interface DocumentationComputation {
|
|
|
138
138
|
readonly contractSummaries: readonly DiscoveredContractSummary[];
|
|
139
139
|
readonly catalog: readonly CatalogContract[];
|
|
140
140
|
readonly documentation: DocumentationFindings;
|
|
141
|
-
/** `ContractModel`'s own projection of the same contracts, built once here and reused by `writeDocumentation()
|
|
141
|
+
/** `ContractModel`'s own projection of the same contracts, built once here and reused by `writeDocumentation()`: the shape `renderDocs()` itself takes (ADR 0038). */
|
|
142
142
|
readonly contractModelContracts: readonly ContractModelContract[];
|
|
143
143
|
}
|
|
144
|
-
/** Root-relative, POSIX-separated
|
|
144
|
+
/** Root-relative, POSIX-separated: `RenderDocsOptions`'s own convention, matching `ContractModel`'s `file`. Exported so `check-artifacts.ts`'s drift check can convert the same `documentation.undocumentedContracts`/`undocumentedVariables` fields for its own `renderDocs()` call, identically. Delegates to `displayPath()` so this can never disagree with the `ContractModel` `file` values it's matched against by identity. */
|
|
145
145
|
export declare function relativizeRef<T extends {
|
|
146
146
|
file: string;
|
|
147
147
|
}>(root: string, ref: T): T;
|
|
148
148
|
/**
|
|
149
|
-
* Pure
|
|
150
|
-
* already-discovered contract graph (active and inactive alike
|
|
151
|
-
* document everything, unlike the manifest). Never blocks
|
|
149
|
+
* Pure: no I/O. Computes undocumented/stale/expiring findings against an
|
|
150
|
+
* already-discovered contract graph (active and inactive alike: docs
|
|
151
|
+
* document everything, unlike the manifest). Never blocks: see
|
|
152
152
|
* `DocumentationFindings`'s own doc comment. Shared by the standalone
|
|
153
153
|
* `generateDocumentation()` and `generate-env-artifacts.ts` (which also
|
|
154
154
|
* reuses this same call for Finding Model's documentation-family findings,
|
|
155
|
-
* ADR 0038
|
|
155
|
+
* ADR 0038: one computation, not two).
|
|
156
156
|
*/
|
|
157
157
|
export declare function computeDocumentation(root: string, linkResult: LinkResult, expiringWithinDays: number, generatedAt: Date): DocumentationComputation;
|
|
158
158
|
/** Writes the docs artifact and, if requested, the `.env.example` file. Callers must have already confirmed both output paths are safe and nothing is blocking. */
|
|
@@ -161,10 +161,10 @@ export declare function writeDocumentation(docsPath: string, envExamplePath: str
|
|
|
161
161
|
}>;
|
|
162
162
|
/**
|
|
163
163
|
* Build-time only. Discovers and links `env.schema.ts` files (same static
|
|
164
|
-
* analysis as {@link generateEnvManifest}) and writes the rich Markdown
|
|
165
|
-
* every variable, its description, default, processor/validator
|
|
166
|
-
* owner, and expiry
|
|
167
|
-
*
|
|
164
|
+
* analysis as {@link generateEnvManifest}) and writes the rich Markdown
|
|
165
|
+
* "Catalog": every variable, its description, default, processor/validator
|
|
166
|
+
* flags, owner, and expiry. Application developers use it as the single
|
|
167
|
+
* onboarding reference for what configuration a feature needs and how to set
|
|
168
168
|
* it up. Optionally also writes a reconciling `.env.example`.
|
|
169
169
|
*
|
|
170
170
|
* @remarks
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"generate-documentation.d.ts","sourceRoot":"","sources":["../../../src/build/generate-documentation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAEhE,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAA2B,MAAM,WAAW,CAAA;AAExF,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAI9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE1F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,iDAAiD;AACjD,MAAM,WAAW,4BAA4B;IAC3C
|
|
1
|
+
{"version":3,"file":"generate-documentation.d.ts","sourceRoot":"","sources":["../../../src/build/generate-documentation.ts"],"names":[],"mappings":"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"}
|