@disclosureos/cli 1.1.0 → 2.0.0-beta.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +57 -0
- package/README.md +122 -3
- package/dist/index.js +3490 -224
- package/package.json +9 -8
package/CHANGELOG.md
CHANGED
|
@@ -1,9 +1,66 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 2.0.0-beta.0
|
|
4
|
+
|
|
5
|
+
### Major Changes
|
|
6
|
+
|
|
7
|
+
- Prepare the coordinated v2 beta package set. This prerelease packages the merged
|
|
8
|
+
experimental observation and claim contracts, acquisition and dataset exchange,
|
|
9
|
+
versioned evaluation, and bounded migration tooling for external consumer testing.
|
|
10
|
+
Existing root APIs and schema identities remain available; the new contracts keep
|
|
11
|
+
explicit `/experimental/v2` imports. Observables and origins retain their existing
|
|
12
|
+
catalogs within the pinned beta dependency graph. This is not a stable v2 release,
|
|
13
|
+
scientific certification, or publication of partner data. See
|
|
14
|
+
`docs/releases/2.0.0-beta.0.md` for package-specific scope and validation boundaries.
|
|
15
|
+
|
|
16
|
+
### Patch Changes
|
|
17
|
+
|
|
18
|
+
- Updated dependencies
|
|
19
|
+
- @disclosureos/records@2.0.0-beta.0
|
|
20
|
+
- @disclosureos/observables@2.0.0-beta.0
|
|
21
|
+
- @disclosureos/origins@2.0.0-beta.0
|
|
22
|
+
- @disclosureos/instruments@2.0.0-beta.0
|
|
23
|
+
- @disclosureos/scoring@2.0.0-beta.0
|
|
24
|
+
- @disclosureos/schema@2.0.0-beta.0
|
|
25
|
+
|
|
3
26
|
All notable changes to `@disclosureos/cli` are documented here. The format is based on
|
|
4
27
|
[Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and this project adheres to
|
|
5
28
|
[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
6
29
|
|
|
30
|
+
## Unreleased compatibility additions
|
|
31
|
+
|
|
32
|
+
- Add descriptive population-coverage naming while preserving legacy completeness results and schema identities.
|
|
33
|
+
|
|
34
|
+
## Unreleased experimental work
|
|
35
|
+
|
|
36
|
+
- Add a bounded compatibility inventory and explicit, artifact-pinned sensor revision review without automatic measurement conversion.
|
|
37
|
+
|
|
38
|
+
- Add explicit standalone legacy score preservation plans and adapters, retaining historical versions and values separately from v2 evaluations.
|
|
39
|
+
|
|
40
|
+
- Add pinned local read-path activation, verified candidate reads and append-only rollback with stale-head protection and retained stores.
|
|
41
|
+
|
|
42
|
+
- Add private local candidate application with pinned intents, atomic publication, interruption-safe resume, retained historical revisions and self-contained completion receipt verification.
|
|
43
|
+
|
|
44
|
+
- Add exact-ledger-pinned revision resolution plans with explicit select/defer decisions, preserved competing revisions and complete non-destructive planning reports.
|
|
45
|
+
|
|
46
|
+
- Add immutable cross-batch staging ledgers with pinned receipts, exact batch deduplication, conservative candidate revision conflicts and self-contained verification.
|
|
47
|
+
|
|
48
|
+
- Add private reviewed-candidate export bundles, exact rerun reuse, destination conflict rejection and current-code verification with complete exported/pending/quarantine accounting.
|
|
49
|
+
|
|
50
|
+
- Add pinned migration review plans for explicit time/position mappings, preserved reviewer declarations and shared v2 validation. Reviewed candidates remain separate from imports and legacy evaluations.
|
|
51
|
+
|
|
52
|
+
- Add bounded v1 migration dry runs with exact input preservation, validated review drafts, per-field unresolved mappings and complete candidate/quarantine accounting.
|
|
53
|
+
|
|
54
|
+
- Add explicit profile-preparation plans and private bundle assembly from exact existing inputs, retaining profile failures and missingness without inventing source metadata.
|
|
55
|
+
|
|
56
|
+
- Add explicit profile listing, manifest inspection and bounded local evaluation with readable required/recommended checks, preserved full JSON results and separate receipt/profile status.
|
|
57
|
+
|
|
58
|
+
- Add experimental source intake with exact-byte local receipts, explicit unknown context and actionable gaps; CLI create, inspect and validate require no fabricated measurements or reviews.
|
|
59
|
+
|
|
60
|
+
- Add experimental dataset/session composition for pinned reproduction packets, with explicit membership, context conflict checks, and local dataset inspection/validation.
|
|
61
|
+
|
|
62
|
+
- Add `packet inspect`, `packet validate`, and `packet reproduce` for local v2 reproduction packets, with shared validator diagnostics and a fixed synthetic mean executor. Existing v1 commands and package versions remain unchanged.
|
|
63
|
+
|
|
7
64
|
## 1.1.0
|
|
8
65
|
|
|
9
66
|
### Minor Changes
|
package/README.md
CHANGED
|
@@ -33,7 +33,8 @@ pnpm dlx @disclosureos/cli --help
|
|
|
33
33
|
```text
|
|
34
34
|
disclosureos scaffold Generate typed data structure templates
|
|
35
35
|
disclosureos validate Validate observation JSON files
|
|
36
|
-
disclosureos
|
|
36
|
+
disclosureos population-coverage Count populated legacy observation fields
|
|
37
|
+
disclosureos completeness Legacy name for population coverage
|
|
37
38
|
disclosureos registry Introspect field, observable, and origin registries
|
|
38
39
|
disclosureos info Quick reference for types and definitions
|
|
39
40
|
disclosureos help Show help
|
|
@@ -46,8 +47,8 @@ disclosureos version Print version
|
|
|
46
47
|
disclosureos scaffold observation --full
|
|
47
48
|
disclosureos validate ./data/ --recursive
|
|
48
49
|
disclosureos validate ./data/ --recursive --json
|
|
49
|
-
disclosureos
|
|
50
|
-
disclosureos
|
|
50
|
+
disclosureos population-coverage ./out/ --recursive
|
|
51
|
+
disclosureos population-coverage ./out/ --recursive --json
|
|
51
52
|
disclosureos registry origins --id 1.1.3
|
|
52
53
|
disclosureos info observable TO-3
|
|
53
54
|
```
|
|
@@ -58,3 +59,121 @@ that don't point to any evidence (`media:`, `sensor:`, …) present in the recor
|
|
|
58
59
|
## License
|
|
59
60
|
|
|
60
61
|
MIT © [Disclosure Foundation](https://disclosure.org)
|
|
62
|
+
|
|
63
|
+
## Experimental v2 packets (unreleased)
|
|
64
|
+
|
|
65
|
+
The source CLI adds `packet inspect`, `packet validate`, and `packet reproduce`.
|
|
66
|
+
These commands operate on local reproduction packets, preserve shared validation
|
|
67
|
+
diagnostics with `--json`, and never execute packet-supplied code. Reproduction is
|
|
68
|
+
limited to the built-in synthetic mean control; scientific eligibility remains
|
|
69
|
+
unchecked. Follow the [complete local workflow](../../docs/experimental/packet-cli.md)
|
|
70
|
+
for build commands, the supplied example, exit codes, and input-size limits.
|
|
71
|
+
|
|
72
|
+
`dataset inspect` and `dataset validate` extend that local workflow to releases of
|
|
73
|
+
multiple pinned packets. See the [two-session walkthrough](../../docs/experimental/dataset-release.md).
|
|
74
|
+
|
|
75
|
+
`intake create`, `intake inspect`, and `intake validate` receive unassessed local
|
|
76
|
+
source files with explicit unknown context. See the [source intake guide](../../docs/experimental/source-intake.md) for byte preservation, missingness, and limits.
|
|
77
|
+
|
|
78
|
+
The new population-coverage command is unreleased. It counts field presence, not analytical readiness. Its JSON and exit behavior match the legacy completeness command. See the [coverage guide](../../docs/experimental/population-coverage.md).
|
|
79
|
+
|
|
80
|
+
## Experimental profile selection
|
|
81
|
+
|
|
82
|
+
Use `disclosureos profile list` to compare the four domain paths,
|
|
83
|
+
`profile inspect <evaluation.json>` to inspect explicit selection without reading input
|
|
84
|
+
files, and `profile check <evaluation.json>` to run a pinned provenance profile.
|
|
85
|
+
Human output separates input integrity, profile outcome, receipt status and next actions;
|
|
86
|
+
`--json` preserves the full evaluator result. Instrument research retains `packet validate`.
|
|
87
|
+
See [profile CLI documentation](../../docs/experimental/profile-cli.md) for input layout,
|
|
88
|
+
exit codes and synthetic examples. This command does not choose profiles automatically
|
|
89
|
+
or publish results.
|
|
90
|
+
|
|
91
|
+
Experimental [profile preparation](../../docs/experimental/profile-preparation.md) assembles exact existing inputs into a new private evaluation bundle, calculates byte pins and preserves failing or unchecked profile outcomes.
|
|
92
|
+
|
|
93
|
+
## Experimental legacy migration dry run
|
|
94
|
+
|
|
95
|
+
`disclosureos migrate dry-run legacy.json --id source-namespace [--json]` prepares
|
|
96
|
+
review drafts and accounts for every input. Exact source bytes and historical fields
|
|
97
|
+
are retained in JSON output; scores and assessments are not promoted into v2 claims.
|
|
98
|
+
No imports or file writes occur. Exit 0 means candidates prepared, 1 means quarantined
|
|
99
|
+
rows, and 2 means an input/usage failure. See the
|
|
100
|
+
[mapping and compatibility checkpoint](../../docs/experimental/migration-dry-run.md)
|
|
101
|
+
for limits and remaining WP09 work.
|
|
102
|
+
|
|
103
|
+
### Explicit migration review
|
|
104
|
+
|
|
105
|
+
`disclosureos migrate review legacy.json review.json [--json]` checks a pinned review
|
|
106
|
+
plan and applies explicit time/position decisions to draft candidates. Source bytes,
|
|
107
|
+
review rationale and unresolved fields are retained; invalid rows are quarantined
|
|
108
|
+
without partial mappings. No imports occur. See the
|
|
109
|
+
[review contract and synthetic walkthrough](../../docs/experimental/migration-review.md).
|
|
110
|
+
|
|
111
|
+
### Private migration bundles
|
|
112
|
+
|
|
113
|
+
`disclosureos migrate export legacy.json review.json --out bundle [--json]` saves
|
|
114
|
+
reviewed candidates separately with pinned inputs and complete row accounting. Exact
|
|
115
|
+
reruns reuse a verified destination; conflicting contents are never overwritten.
|
|
116
|
+
`disclosureos migrate verify bundle [--json]` recomputes and checks every artifact.
|
|
117
|
+
These operations do not import records. See the
|
|
118
|
+
[bundle contract and walkthrough](../../docs/experimental/migration-export.md).
|
|
119
|
+
|
|
120
|
+
### Cross-batch migration ledger
|
|
121
|
+
|
|
122
|
+
`disclosureos migrate ledger bundle-a bundle-b --out ledger [--json]` records
|
|
123
|
+
verified bundles in a private snapshot, deduplicates exact batches and marks differing
|
|
124
|
+
revisions of a stable identity as conflicts. `migrate ledger-verify ledger [--json]`
|
|
125
|
+
recomputes the snapshot from retained inputs. These are staging receipts, not imports.
|
|
126
|
+
See the [ledger policy](../../docs/experimental/migration-ledger.md).
|
|
127
|
+
|
|
128
|
+
### Explicit revision resolution
|
|
129
|
+
|
|
130
|
+
`disclosureos migrate resolve ledger decisions.json [--json]` checks a ledger-pinned
|
|
131
|
+
select/defer plan and emits complete row dispositions and selected candidate pins.
|
|
132
|
+
Unmentioned identities stay unresolved. No candidates are changed or imported. See
|
|
133
|
+
the [resolution contract](../../docs/experimental/migration-resolution.md).
|
|
134
|
+
|
|
135
|
+
### Resumable local application
|
|
136
|
+
|
|
137
|
+
`disclosureos migrate apply ledger decisions.json --out store [--json]` materializes
|
|
138
|
+
explicitly selected candidates in a private local store, retains the full historical
|
|
139
|
+
ledger and publishes a completion receipt. Repeating the same operation resumes missing
|
|
140
|
+
files or reuses an exact completed store. `migrate apply-verify store [--json]` checks
|
|
141
|
+
the completed store. No Index database or read path is changed. See the
|
|
142
|
+
[local application contract](../../docs/experimental/migration-application.md).
|
|
143
|
+
|
|
144
|
+
### Local read-path activation and rollback
|
|
145
|
+
|
|
146
|
+
`migrate read-init --out selector --json` starts a private selector in legacy fallback
|
|
147
|
+
mode. `migrate read-activate selector store --id CURRENT_HEAD --json` selects a verified
|
|
148
|
+
completed store. `migrate read-path selector --json` returns the selected mode and
|
|
149
|
+
verified candidates. `migrate read-rollback selector EARLIER_HEAD --id CURRENT_HEAD
|
|
150
|
+
--json` restores an earlier selection without deleting stores or transition history.
|
|
151
|
+
The expected current head prevents conflicting concurrent changes. This is local
|
|
152
|
+
consumer plumbing; the Index website and database remain unchanged. See the
|
|
153
|
+
[read-path contract](../../docs/experimental/migration-read-path.md) for recovery and limits.
|
|
154
|
+
|
|
155
|
+
### Preserve standalone historical scores
|
|
156
|
+
|
|
157
|
+
`migrate legacy-scores scores.json plan.json --json` preserves explicitly declared
|
|
158
|
+
legacy completeness/compellingness outputs, their methodology versions and observation
|
|
159
|
+
associations. Every input row is retained as historical, pending review or quarantined.
|
|
160
|
+
The report preserves exact input bytes and excludes historical scores from v2 rankings;
|
|
161
|
+
it neither recalculates scores nor imports v2 evaluations. See the
|
|
162
|
+
[adapter contract](../../docs/experimental/migration-legacy-scores.md).
|
|
163
|
+
|
|
164
|
+
### Migration field dispositions and sensor revision review
|
|
165
|
+
|
|
166
|
+
`migrate compatibility legacy.json [sensor-review.json] --id namespace --json`
|
|
167
|
+
inventories mapped, retained-without-conversion and unresolved fields. Optional explicit
|
|
168
|
+
review pins an acquisition's manifest and supplied provenance without inferring
|
|
169
|
+
calibration or converting measurements. The review plan is exposed as
|
|
170
|
+
`MigrationCompatibilitySchema`, `MigrationCompatibility` and
|
|
171
|
+
`migrationCompatibilityJsonSchema` from `@disclosureos/schema/experimental/v2`.
|
|
172
|
+
See the [compatibility inventory contract](../../docs/experimental/migration-compatibility.md).
|
|
173
|
+
|
|
174
|
+
## Experimental v2 migration and compatibility
|
|
175
|
+
|
|
176
|
+
Start with the [developer compatibility guide](../../docs/experimental/migration-guide.md)
|
|
177
|
+
for breaking changes, parser/version boundaries, supported migration workflows,
|
|
178
|
+
exit handling, profile differences and non-destructive local rollback. This is an
|
|
179
|
+
experimental checkout workflow; merging package changes does not deploy the Index.
|