@lde/distribution-health 0.2.9 → 0.2.10
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/README.md +8 -32
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,37 +1,13 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @lde/distribution-health
|
|
2
2
|
|
|
3
|
-
Derives a distribution’s **usability** from two separately-produced signals:
|
|
3
|
+
Derives a distribution’s **usability** from two separately-produced signals: **reachability** – can the distribution be fetched? – and **validity** – does the fetched content actually parse as RDF? This is a pure leaf: it _interprets_ the raw results of `@lde/distribution-probe` and `@lde/sparql-importer` rather than producing them.
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
- **validity** – does the fetched content actually parse as RDF? (a by-product of parsing: shallow by the crawler, deep by the knowledge-graph pipeline)
|
|
5
|
+
## Installation
|
|
7
6
|
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
below), so the package stays vocabulary-agnostic.
|
|
7
|
+
```sh
|
|
8
|
+
npm install @lde/distribution-health
|
|
9
|
+
```
|
|
12
10
|
|
|
13
|
-
##
|
|
14
|
-
|
|
15
|
-
- A `ValidityVerdict` type with a typed failure reason (`parse-error` / `empty`),
|
|
16
|
-
a best-effort parser message, the `validatedFingerprint` it was judged against,
|
|
17
|
-
and its producer depth (`shallow` / `deep`).
|
|
18
|
-
- Mappers from a probe result (shallow) and an import outcome (deep) to a verdict.
|
|
19
|
-
- The **usability rollup**: `(reachability, validity verdicts) → { usable | unusable | unknown, cause }`,
|
|
20
|
-
the one canonical rule consumers share. Reachability dominates; a stale verdict
|
|
21
|
-
(one whose fingerprint no longer matches the currently-observed one) decays to
|
|
22
|
-
`unknown`; a deep verdict beats a shallow one.
|
|
23
|
-
|
|
24
|
-
## RDF is the consumer’s responsibility
|
|
25
|
-
|
|
26
|
-
This package emits no RDF and coins no vocabulary, mirroring `@lde/iiif-validator`
|
|
27
|
-
(which returns a TS verdict that the NDE knowledge-graph pipeline maps to RDF).
|
|
28
|
-
A consumer turns a `ValidityVerdict` into its own DQV/PROV quads under its own
|
|
29
|
-
namespace – e.g. NDE writes a `dqv:QualityMeasurement` on the distribution under
|
|
30
|
-
`def.nde.nl`. The `ValidityFailureReason` local names are chosen to drop straight
|
|
31
|
-
into a SKOS failure scheme (`<scheme>#${reason}`) with no lookup table.
|
|
32
|
-
|
|
33
|
-
The normative usability rule and the rejected alternatives are recorded in the
|
|
34
|
-
PRD: netwerk-digitaal-erfgoed/dataset-register#2103.
|
|
35
|
-
|
|
36
|
-
<!-- 0.1.1 was published to npm without its dist/; this republishes the package with the build output. -->
|
|
11
|
+
## Documentation
|
|
37
12
|
|
|
13
|
+
See the [full documentation](https://ldelements.org/reference/distribution-health).
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@lde/distribution-health",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.10",
|
|
4
4
|
"repository": {
|
|
5
5
|
"url": "git+https://github.com/ldelements/lde.git",
|
|
6
6
|
"directory": "packages/distribution-health"
|
|
@@ -24,7 +24,7 @@
|
|
|
24
24
|
"!**/*.tsbuildinfo"
|
|
25
25
|
],
|
|
26
26
|
"dependencies": {
|
|
27
|
-
"@lde/distribution-probe": "^0.2.
|
|
27
|
+
"@lde/distribution-probe": "^0.2.8",
|
|
28
28
|
"@lde/sparql-importer": "^0.6.9",
|
|
29
29
|
"tslib": "^2.3.0"
|
|
30
30
|
},
|