@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 CHANGED
@@ -2,7 +2,12 @@
2
2
 
3
3
  ## [Unreleased]
4
4
 
5
- ## [0.1.0] - 2026-09-18
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 uses `release/0.1.0` for this reason. Do not merge
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
- The verified development build is available on the `dev` channel:
13
+ Install the stable channel:
14
14
 
15
15
  ```sh
16
- npm install --global @functional-systems/lambdadb-cli@dev
16
+ npm install --global @functional-systems/lambdadb-cli
17
17
  lambdadb --version
18
18
  lambdadb --help
19
19
  ```
20
20
 
21
- This checkout prepares `0.1.0`. Once its GitHub Release and npm publication are
22
- complete, install the stable version with:
23
-
24
- ```sh
25
- npm install --global @functional-systems/lambdadb-cli@0.1.0
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 `release/0.1.0` candidate prepares the first stable version from reviewed
6
- `develop` commit `c8947e9`. It changes package/lock versions and release documents;
7
- CLI runtime, dependencies, tests and workflows match the verified development build.
8
- The promotion PR targets `main` directly so `develop` keeps its automatic dev base.
9
- Merge with a merge commit, then obtain authorization for `v0.1.0` and a non-prerelease
10
- GitHub Release. Main promotion alone does not publish npm. After publication,
11
- verify `latest=0.1.0`, provenance and a clean consumer installation. Synchronize
12
- main back to develop through a PR that also sets the next development base.
13
- Stable publication has not yet been performed.
14
-
15
- The ordinary develop merge published `0.1.0-dev.5` through OIDC in
16
- [one successful workflow attempt](https://github.com/lambdadb/lambdadb-cli/actions/runs/35344153978).
17
- The new verification logic handled approximately three minutes of registry
18
- propagation without repeating the write or rerunning the workflow. A fresh npm
19
- installation passed 35 CLI contracts, integrity and provenance/signature checks.
20
-
21
- Bootstrap and initial OIDC publication were completed on 2026-09-18:
22
-
23
- - `0.1.0-dev.1` was published publicly from reviewed develop as the manual bootstrap.
24
- - `0.1.0-dev.4` was published by GitHub Actions with verified provenance for
25
- commit `f2397ba`. Its registry installation passed all 35 CLI contract tests.
26
- - The repository variable `NPM_DEV_PUBLISH_ENABLED=true` enables eligible develop
27
- pushes after Node 22/24 CI. Main promotion is required only for rc/stable.
28
-
29
- These are recorded validation milestones, not a continuously updated list of
30
- versions. Check npm for current dist-tags. At verification, `dev` pointed to
31
- `0.1.0-dev.4` and `latest` remained at the bootstrap `0.1.0-dev.1`: the first
32
- publication created both tags despite `--tag dev`, and removing `latest` returned
33
- HTTP 400. The next dev publication preserved `latest`. No stable version has been
34
- published; explicitly select `@dev` or an exact development version until a
35
- reviewed rc/stable release is available. Do not repeatedly delete the bootstrap
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
- Date: 2026-09-18. Local contract tests use loopback servers and synthetic
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. Stable publication remains pending.
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 remain unverified until the
42
- explicit publication and subsequent consumer/provenance checks.
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
- are complete; main promotion and rc/stable publication remain unperformed.
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.0",
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
  }