@functional-systems/lambdadb-cli 0.1.0 → 0.1.1-dev.6
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 +6 -1
- package/CONTRIBUTING.md +1 -1
- package/README.md +7 -12
- package/RELEASING.md +31 -43
- package/VALIDATION.md +36 -8
- package/package.json +3 -2
package/CHANGELOG.md
CHANGED
|
@@ -2,7 +2,12 @@
|
|
|
2
2
|
|
|
3
3
|
## [Unreleased]
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
### Maintenance
|
|
6
|
+
|
|
7
|
+
- Synchronize the 0.1.0 release history into develop and start the 0.1.1 development
|
|
8
|
+
line. Stable installs use npm's default channel; dev builds remain opt-in.
|
|
9
|
+
|
|
10
|
+
## [0.1.0] - 2026-09-19
|
|
6
11
|
|
|
7
12
|
### Added
|
|
8
13
|
|
package/CONTRIBUTING.md
CHANGED
|
@@ -66,7 +66,7 @@ development base in that synchronization PR so develop retains a dev version.
|
|
|
66
66
|
|
|
67
67
|
A separate `release/*` branch can be created from reviewed develop and target
|
|
68
68
|
main when preparing rc/stable metadata while develop retains its automatic dev
|
|
69
|
-
base. The first stable release
|
|
69
|
+
base. The first stable release used `release/0.1.0` for this reason. Do not merge
|
|
70
70
|
stable package metadata into develop without setting its next dev base, because
|
|
71
71
|
automatic development publication requires an `X.Y.Z-dev.N` version.
|
|
72
72
|
|
package/README.md
CHANGED
|
@@ -10,24 +10,19 @@ Requires Node.js 22.14 or newer and npm.
|
|
|
10
10
|
|
|
11
11
|
### Install from npm
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
Install the stable channel:
|
|
14
14
|
|
|
15
15
|
```sh
|
|
16
|
-
npm install --global @functional-systems/lambdadb-cli
|
|
16
|
+
npm install --global @functional-systems/lambdadb-cli
|
|
17
17
|
lambdadb --version
|
|
18
18
|
lambdadb --help
|
|
19
19
|
```
|
|
20
20
|
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
```
|
|
27
|
-
|
|
28
|
-
The `dev` channel contains prerelease versions. For reproducible CI runs, pin an
|
|
29
|
-
exact published version instead of the moving `dev` tag. See
|
|
30
|
-
[RELEASING.md](RELEASING.md#current-status) for release preparation status and
|
|
21
|
+
For reproducible CI runs, pin an exact published version such as
|
|
22
|
+
`@functional-systems/lambdadb-cli@0.1.0`. To try development builds, explicitly use
|
|
23
|
+
`@functional-systems/lambdadb-cli@dev`; this moving channel contains prereleases.
|
|
24
|
+
Installed CLIs do not update themselves. See
|
|
25
|
+
[RELEASING.md](RELEASING.md#current-status) for release status and
|
|
31
26
|
[VALIDATION.md](VALIDATION.md) for verification results and remaining limitations.
|
|
32
27
|
|
|
33
28
|
### Build from source
|
package/RELEASING.md
CHANGED
|
@@ -2,49 +2,37 @@
|
|
|
2
2
|
|
|
3
3
|
## Current status
|
|
4
4
|
|
|
5
|
-
The `
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
The
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
- `0.1.0-dev.
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
tag or publish a placeholder to work around it.
|
|
37
|
-
|
|
38
|
-
The CLI is licensed under [Apache-2.0](LICENSE), with matching package metadata.
|
|
39
|
-
Publication, provenance and development-project smoke evidence are recorded in
|
|
40
|
-
[VALIDATION.md](VALIDATION.md). Local bootstrap has no GitHub Actions provenance;
|
|
41
|
-
the automated development artifact does.
|
|
42
|
-
|
|
43
|
-
The workflow rejects private packages and missing license metadata. Explicit
|
|
44
|
-
rc/stable releases also require matching tags, prerelease flags and dated
|
|
45
|
-
changelog entries. Passing metadata validation does not establish live-service
|
|
46
|
-
verification. Enabling automatic dev publication authorizes eligible develop
|
|
47
|
-
pushes to publish after CI; rc/stable publication remains an explicit action.
|
|
5
|
+
The first stable version, `0.1.0`, was published on 2026-09-19 through
|
|
6
|
+
[GitHub Release v0.1.0](https://github.com/lambdadb/lambdadb-cli/releases/tag/v0.1.0)
|
|
7
|
+
and the [OIDC release workflow](https://github.com/lambdadb/lambdadb-cli/actions/runs/35421226854).
|
|
8
|
+
Tag and main release commit `c8d389f` have the same tree as the reviewed and
|
|
9
|
+
live-tested candidate `658ea7c`. The workflow passed on attempt 1, including Node
|
|
10
|
+
22/24 validation and tests of the exact publication tarball.
|
|
11
|
+
|
|
12
|
+
Registry verification confirmed `latest=0.1.0` and `dev=0.1.0-dev.5`. A clean,
|
|
13
|
+
unqualified npm install passed all 35 CLI contracts, version/help, integrity,
|
|
14
|
+
provenance and signature checks. Version/tag and attestation metadata propagated
|
|
15
|
+
separately; verification used read retries without republishing.
|
|
16
|
+
|
|
17
|
+
The post-release synchronization brings main history back into develop with
|
|
18
|
+
`0.1.1-dev.1` as the next development base. Its promotion PR must preserve shared
|
|
19
|
+
ancestry with a merge commit. Once merged, the normal develop push workflow
|
|
20
|
+
publishes a numbered `0.1.1-dev.N` build on `dev`; it does not move `latest`.
|
|
21
|
+
No separate stable release or tag is needed for this maintenance step.
|
|
22
|
+
|
|
23
|
+
Bootstrap `0.1.0-dev.1` and the first OIDC development builds were verified on
|
|
24
|
+
2026-09-18. The ordinary develop merge published `0.1.0-dev.5` in
|
|
25
|
+
[one successful attempt](https://github.com/lambdadb/lambdadb-cli/actions/runs/35344153978),
|
|
26
|
+
handling approximately three minutes of registry propagation without another write.
|
|
27
|
+
The bootstrap initially assigned `latest` to `0.1.0-dev.1`, and a removal attempt
|
|
28
|
+
returned HTTP 400. The stable publication replaces that temporary tag state.
|
|
29
|
+
Do not repeat bootstrap or change tags to work around propagation delays.
|
|
30
|
+
|
|
31
|
+
These are dated validation milestones, not a continuously updated version list.
|
|
32
|
+
Check npm for current dist-tags. Apache-2.0 licensing, publication, provenance,
|
|
33
|
+
consumer checks and development-project smoke evidence are recorded in
|
|
34
|
+
[VALIDATION.md](VALIDATION.md). Automatic dev publication is enabled;
|
|
35
|
+
future stable/rc tags and GitHub Releases remain explicit release actions.
|
|
48
36
|
|
|
49
37
|
## Branch and version policy
|
|
50
38
|
|
package/VALIDATION.md
CHANGED
|
@@ -1,14 +1,44 @@
|
|
|
1
1
|
# Validation record
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Updated: 2026-09-19. Local contract tests use loopback servers and synthetic
|
|
4
4
|
credentials. A separate authenticated development-project smoke is recorded below.
|
|
5
5
|
|
|
6
|
+
## Stable 0.1.0 publication
|
|
7
|
+
|
|
8
|
+
On 2026-09-19, [GitHub Release v0.1.0](https://github.com/lambdadb/lambdadb-cli/releases/tag/v0.1.0)
|
|
9
|
+
and its annotated tag identified main commit
|
|
10
|
+
`c8d389f3264d641ae6eafc7737fedd5ea046ddf1`. Its tree exactly matches the reviewed
|
|
11
|
+
candidate `658ea7ccdce535bbd4f2e29ae06813e2f2e716e2` from PR #5, including the
|
|
12
|
+
runtime verified by the installed-candidate development smoke below. That smoke
|
|
13
|
+
was not repeated because release contents were unchanged.
|
|
14
|
+
|
|
15
|
+
The [release-event workflow](https://github.com/lambdadb/lambdadb-cli/actions/runs/35421226854)
|
|
16
|
+
passed on attempt 1. Node 22/24 validation and exact-tarball contracts passed;
|
|
17
|
+
Trusted Publishing published `0.1.0` on `latest` at 04:27:06 UTC. Version/tag
|
|
18
|
+
metadata and attestation metadata propagated separately. Verification retried
|
|
19
|
+
reads only; no second publication or workflow rerun was needed.
|
|
20
|
+
|
|
21
|
+
A clean, unqualified npm install with an isolated cache resolved to `0.1.0` and
|
|
22
|
+
passed version/help plus all 35 CLI contract tests. The downloaded tarball digest,
|
|
23
|
+
installed lockfile integrity and provenance subject matched. The decoded SLSA
|
|
24
|
+
provenance identified this repository, `.github/workflows/publish.yaml`,
|
|
25
|
+
`refs/tags/v0.1.0`, release commit `c8d389f` and workflow attempt 1.
|
|
26
|
+
`npm audit signatures` reported no invalid or missing signatures.
|
|
27
|
+
At verification, `latest=0.1.0` and `dev=0.1.0-dev.5`; the stable release replaced
|
|
28
|
+
the initial bootstrap latest tag without changing the dev channel.
|
|
29
|
+
|
|
30
|
+
The subsequent main-to-develop synchronization sets `0.1.1-dev.1` as the next
|
|
31
|
+
base. Its local clean install, lint, types, version checks, 59 source tests and
|
|
32
|
+
35 installed-package contracts passed. This maintenance change updates versions
|
|
33
|
+
and documentation only; CLI runtime, dependencies, tests and workflows match
|
|
34
|
+
`v0.1.0`. Its PR validation does not itself publish a new dev version.
|
|
35
|
+
|
|
6
36
|
## Stable 0.1.0 candidate
|
|
7
37
|
|
|
8
38
|
Prepared `release/0.1.0` from reviewed develop commit
|
|
9
39
|
`c8947e96308283ac593e712716f0732121bb1958`. Relative to that commit, only package
|
|
10
40
|
versions and release documents change. Runtime source, dependencies, tests,
|
|
11
|
-
examples and workflows are unchanged.
|
|
41
|
+
examples and workflows are unchanged. This records the pre-publication candidate.
|
|
12
42
|
|
|
13
43
|
On Node.js 24.15.0 / npm 11.12.1, a new worktree passed `npm ci`, lint, type
|
|
14
44
|
checking, all 59 source tests, and 35 installed-package contract tests.
|
|
@@ -38,8 +68,8 @@ Target: `bench-recall` at
|
|
|
38
68
|
Only documentation was updated after this live run; the final package is checked
|
|
39
69
|
again with the installed-package contracts. This is development-service evidence
|
|
40
70
|
for a bounded sample, not a latency/readiness guarantee or live tag/alias coverage.
|
|
41
|
-
The stable npm artifact and release-event workflow
|
|
42
|
-
|
|
71
|
+
The stable npm artifact and release-event workflow were not verified at candidate
|
|
72
|
+
preparation time; the subsequent publication evidence is recorded above.
|
|
43
73
|
|
|
44
74
|
## Public bootstrap and OIDC publication
|
|
45
75
|
|
|
@@ -74,7 +104,8 @@ At this verification, `dev=0.1.0-dev.4` and `latest=0.1.0-dev.1`. Bootstrap had
|
|
|
74
104
|
created both tags despite `--tag dev`; a removal attempt for `latest` returned
|
|
75
105
|
HTTP 400. The automated dev publication left `latest` unchanged. This observation
|
|
76
106
|
does not establish a general version-count rule for npm. Bootstrap and OIDC setup
|
|
77
|
-
|
|
107
|
+
were complete at that stage; main promotion and stable publication followed as
|
|
108
|
+
recorded above.
|
|
78
109
|
|
|
79
110
|
## Publication verification hardening
|
|
80
111
|
|
|
@@ -298,9 +329,6 @@ deployment state of an individual LambdaDB endpoint.
|
|
|
298
329
|
receipt. Those capabilities are not implemented.
|
|
299
330
|
- No Windows-specific permission or signal validation. POSIX modes and injected
|
|
300
331
|
SIGINT/SIGTERM were checked on macOS; CI targets Linux.
|
|
301
|
-
- No main promotion, explicit rc/stable publication or GitHub Release workflow
|
|
302
|
-
execution. Public bootstrap and automatic dev/OIDC publication are verified
|
|
303
|
-
above, including the five-minute verification behavior on an ordinary develop merge.
|
|
304
332
|
- Mock large-response tests cover SDK routing/credential separation at 1 MiB;
|
|
305
333
|
the live sample verifies combined content above 6 MiB. Neither is an exhaustive
|
|
306
334
|
memory/size stress test. Imports buffer a maximum 64 MiB source file
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@functional-systems/lambdadb-cli",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1-dev.6",
|
|
4
4
|
"private": false,
|
|
5
5
|
"description": "Project-scoped LambdaDB command-line tools",
|
|
6
6
|
"type": "module",
|
|
@@ -52,5 +52,6 @@
|
|
|
52
52
|
"bugs": {
|
|
53
53
|
"url": "https://github.com/lambdadb/lambdadb-cli/issues"
|
|
54
54
|
},
|
|
55
|
-
"license": "Apache-2.0"
|
|
55
|
+
"license": "Apache-2.0",
|
|
56
|
+
"gitHead": "397fbfbe6977fbd4fbb3977eca73887a4899d564"
|
|
56
57
|
}
|