@functional-systems/lambdadb-cli 0.1.2-dev.12 → 0.1.3-dev.13
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 +7 -0
- package/README.md +1 -1
- package/RELEASING.md +31 -6
- package/VALIDATION.md +115 -0
- package/package.json +2 -2
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,13 @@
|
|
|
2
2
|
|
|
3
3
|
## [Unreleased]
|
|
4
4
|
|
|
5
|
+
### Maintenance
|
|
6
|
+
|
|
7
|
+
- Synchronize the 0.1.2 release history and start the 0.1.3 development line.
|
|
8
|
+
- Prepare the Homebrew formula for verified stable 0.1.2 and record npm publication evidence.
|
|
9
|
+
|
|
10
|
+
## [0.1.2] - 2026-10-04
|
|
11
|
+
|
|
5
12
|
### Fixed
|
|
6
13
|
|
|
7
14
|
- Preserve fixed rerank status/provider/model/criteria/reason tokens when they
|
package/README.md
CHANGED
|
@@ -19,7 +19,7 @@ lambdadb --help
|
|
|
19
19
|
```
|
|
20
20
|
|
|
21
21
|
For reproducible CI runs, pin an exact published version such as
|
|
22
|
-
`@functional-systems/lambdadb-cli@0.1.
|
|
22
|
+
`@functional-systems/lambdadb-cli@0.1.2`. To try development builds, explicitly use
|
|
23
23
|
`@functional-systems/lambdadb-cli@dev`; this moving channel contains prereleases.
|
|
24
24
|
Installed CLIs do not update themselves. See
|
|
25
25
|
[RELEASING.md](RELEASING.md#current-status) for release status and
|
package/RELEASING.md
CHANGED
|
@@ -2,6 +2,28 @@
|
|
|
2
2
|
|
|
3
3
|
## Current status
|
|
4
4
|
|
|
5
|
+
CLI 0.1.2 was published on 2026-10-04 from merged main commit
|
|
6
|
+
`6628fe0ed1f405c88fbd91d591e5223d3250dd73` through
|
|
7
|
+
[GitHub Release v0.1.2](https://github.com/lambdadb/lambdadb-cli/releases/tag/v0.1.2)
|
|
8
|
+
and the [successful OIDC workflow](https://github.com/lambdadb/lambdadb-cli/actions/runs/37191188846).
|
|
9
|
+
It pins SDK 0.7.0 and includes 49 fixed analyzer presets, optional per-query
|
|
10
|
+
managed reranking and credential-safe fixed rerank metadata.
|
|
11
|
+
|
|
12
|
+
Independent registry verification confirmed latest=0.1.2 and dev=0.1.2-dev.12.
|
|
13
|
+
The published tarball is byte-identical to the reviewed, live-tested candidate.
|
|
14
|
+
A clean registry consumer passed all 46 CLI contracts, version/help, SDK version,
|
|
15
|
+
integrity, four registry signatures and three attestations. Decoded provenance
|
|
16
|
+
identifies the release commit, tag and workflow. See
|
|
17
|
+
[publication evidence](VALIDATION.md#cli-012-publication-2026-10-04).
|
|
18
|
+
|
|
19
|
+
This post-release branch synchronizes main into develop with 0.1.3-dev.1 and
|
|
20
|
+
prepares the verified 0.1.2 Homebrew formula. The public tap still provides 0.1.1
|
|
21
|
+
until its separate formula PR is reviewed and merged. Publication and bounded
|
|
22
|
+
development smoke do not establish production deployment, search quality,
|
|
23
|
+
load/failure coverage or billing readiness.
|
|
24
|
+
|
|
25
|
+
## CLI 0.1.1 publication
|
|
26
|
+
|
|
5
27
|
CLI 0.1.1 was published on 2026-09-29 through
|
|
6
28
|
[GitHub Release v0.1.1](https://github.com/lambdadb/lambdadb-cli/releases/tag/v0.1.1)
|
|
7
29
|
and the [OIDC release workflow](https://github.com/lambdadb/lambdadb-cli/actions/runs/36557578359).
|
|
@@ -16,8 +38,8 @@ tarball is byte-identical to the tested final candidate; provenance identifies t
|
|
|
16
38
|
release commit, tag and workflow. See [VALIDATION.md](VALIDATION.md#cli-011-publication).
|
|
17
39
|
|
|
18
40
|
The post-release branch synchronizes main history into develop with `0.1.2-dev.1`
|
|
19
|
-
and prepares the 0.1.1 Homebrew formula. The public tap
|
|
20
|
-
|
|
41
|
+
and prepares the 0.1.1 Homebrew formula. The public tap was checked on 2026-10-04
|
|
42
|
+
and matches that verified 0.1.1 formula; the 0.1.2 handoff follows publication. Facets still require a supporting server and newly built keyword
|
|
21
43
|
indexes; publication does not migrate Collections or upgrade installed CLIs.
|
|
22
44
|
|
|
23
45
|
## Prior publication status
|
|
@@ -260,9 +282,11 @@ npm run test:live
|
|
|
260
282
|
|
|
261
283
|
The test fails before API calls when required settings are absent. It creates a
|
|
262
284
|
random temporary collection, imports two 3 MiB documents plus a bulk document,
|
|
263
|
-
|
|
264
|
-
and checks committed query/fetch contents
|
|
265
|
-
window per stage.
|
|
285
|
+
accepts and verifies metadata for all 49 fixed analyzer presets, checks exact
|
|
286
|
+
facet-only and document+facet buckets, and checks committed query/fetch contents
|
|
287
|
+
with a maximum 300-second observation window per stage. It also checks managed reranking with default criteria, null
|
|
288
|
+
and custom criteria, including final/retrieval scores and status metadata.
|
|
289
|
+
Request timeouts and polling sleeps are capped to the remaining
|
|
266
290
|
budget, and responses at or after the deadline cannot pass. Process termination
|
|
267
291
|
and event-loop scheduling may delay reporting. It reports elapsed time and
|
|
268
292
|
matched-document counts; a timeout is a failed smoke, not proof that accepted
|
|
@@ -287,7 +311,8 @@ release, follow the [Homebrew maintainer guide](https://github.com/lambdadb/lamb
|
|
|
287
311
|
update checksums, pass installation checks and prepare a tap PR. Tap publication
|
|
288
312
|
is separate from this repository's npm workflow; no cross-repository write or
|
|
289
313
|
automatic tap update is configured. The public
|
|
290
|
-
[LambdaDB tap](https://github.com/lambdadb/homebrew-tap) provides stable `0.1.
|
|
314
|
+
[LambdaDB tap](https://github.com/lambdadb/homebrew-tap) provides stable `0.1.1`
|
|
315
|
+
(verified on 2026-10-04);
|
|
291
316
|
installation evidence is recorded in [VALIDATION.md](VALIDATION.md#homebrew-publication).
|
|
292
317
|
|
|
293
318
|
## Design references
|
package/VALIDATION.md
CHANGED
|
@@ -3,6 +3,121 @@
|
|
|
3
3
|
Updated: 2026-10-04. Local contract tests use loopback servers and synthetic
|
|
4
4
|
credentials. Authenticated development-project evidence is recorded separately.
|
|
5
5
|
|
|
6
|
+
## CLI 0.1.2 publication (2026-10-04)
|
|
7
|
+
|
|
8
|
+
[PR #15](https://github.com/lambdadb/lambdadb-cli/pull/15) merged as
|
|
9
|
+
`6628fe0ed1f405c88fbd91d591e5223d3250dd73`. The annotated v0.1.2 tag points to
|
|
10
|
+
that commit. [GitHub Release v0.1.2](https://github.com/lambdadb/lambdadb-cli/releases/tag/v0.1.2)
|
|
11
|
+
triggered [OIDC publication](https://github.com/lambdadb/lambdadb-cli/actions/runs/37191188846),
|
|
12
|
+
which passed Node 22/24 validation and exact-artifact tests on attempt 1.
|
|
13
|
+
|
|
14
|
+
- Registry latest=0.1.2; dev=0.1.2-dev.12 remained unchanged.
|
|
15
|
+
- Downloaded npm tarball is byte-identical to the reviewed final candidate and
|
|
16
|
+
merged-main pack. SHA-256:
|
|
17
|
+
`e63c2c0fd624e1d81c45c5ba24d641a11ee0ecdc60f063aba4268e06547761ea`.
|
|
18
|
+
Registry SHA-512 integrity:
|
|
19
|
+
`sha512-9l1WPN2vrX+JXRjuOh7Uz5DCVcaiV/YLpYKgZb7ORU1jphaAIx38VSWeiQitz0V2Nw/b1vTxfcXzvra6EAkaFg==`.
|
|
20
|
+
- An isolated registry consumer passed all 46 installed CLI contracts and
|
|
21
|
+
version/help. Its lockfile integrity matched npm and SDK resolves to 0.7.0.
|
|
22
|
+
npm audit signatures verified four registry signatures and three attestations.
|
|
23
|
+
- Decoded [provenance](https://registry.npmjs.org/-/npm/v1/attestations/@functional-systems%2flambdadb-cli@0.1.2)
|
|
24
|
+
matched the artifact digest, repository, release commit, refs/tags/v0.1.2,
|
|
25
|
+
publish.yaml and workflow run 37191188846. Verification retried registry reads
|
|
26
|
+
during propagation without another publication. Temporary consumer, archive
|
|
27
|
+
and cache were removed.
|
|
28
|
+
- The candidate live evidence below applies to the identical published artifact;
|
|
29
|
+
no additional live run was performed. The earlier failed sample remains recorded.
|
|
30
|
+
- Formula handoff pins this npm tarball and release lockfile SHA-256
|
|
31
|
+
`e2d12af262d13c3a23073d1313b183766bb40b5360abeb0d773b5100819dac65`.
|
|
32
|
+
Public-tap installation and upgrade remain pending its separate PR merge.
|
|
33
|
+
|
|
34
|
+
These checks establish artifact publication and the recorded development sample;
|
|
35
|
+
production deployment, search quality, load/failure coverage and billing readiness
|
|
36
|
+
remain separate dependencies.
|
|
37
|
+
|
|
38
|
+
## CLI 0.1.2 stable candidate (2026-10-04)
|
|
39
|
+
|
|
40
|
+
Prepared release/0.1.2 from reviewed develop merge `aef74a3`, retaining SDK 0.7.0
|
|
41
|
+
and all reviewed runtime/test changes. The release branch changes only version
|
|
42
|
+
metadata, the dated changelog and release/validation documentation. Stable npm
|
|
43
|
+
0.1.2 was absent when checked; latest remains 0.1.1. No stable tag, GitHub Release,
|
|
44
|
+
package publication or main merge was performed during preparation.
|
|
45
|
+
|
|
46
|
+
- npm ci, lint, typecheck, version checks and the explicit
|
|
47
|
+
RELEASE_TAG=v0.1.2 / RELEASE_PRERELEASE=false preflight passed on Node 24.15.0
|
|
48
|
+
with npm 11.12.1. All 71 source tests and 46 separately installed CLI tests passed.
|
|
49
|
+
The executable and lockfile agree on 0.1.2, and the installed SDK is 0.7.0.
|
|
50
|
+
- A candidate tarball was installed into an isolated consumer with its own npm
|
|
51
|
+
cache. Its executable was selected via LAMBDADB_TEST_CLI for the authorized
|
|
52
|
+
development smoke using the existing .env.local target and in-memory mapping.
|
|
53
|
+
The successful run took 54.4 seconds: accepted writes at about 3 seconds,
|
|
54
|
+
committed query/fetch contents at about 52 seconds, exact facets and managed
|
|
55
|
+
reranking default/null/custom by about 54 seconds. All 49 preset metadata
|
|
56
|
+
checks passed. Cleanup returned HTTP 404 for
|
|
57
|
+
`cli-smoke-14b21fee-59e1-4898-9ef2-8a57db823de0`.
|
|
58
|
+
- The first candidate live attempt failed after 53.2 seconds during query
|
|
59
|
+
observation with exit 3 and no HTTP status. The log does not distinguish a
|
|
60
|
+
transport timeout from another request failure; this is not a passing sample
|
|
61
|
+
or proof of a candidate defect. No runtime code was changed for the retry.
|
|
62
|
+
Cleanup was not confirmed by that run. An independent SDK get found its
|
|
63
|
+
test-owned collection still present; delete was accepted and a subsequent
|
|
64
|
+
get returned HTTP 404 for `cli-smoke-c42a987e-592a-4611-a8d7-04cf5b90ad15`.
|
|
65
|
+
- Every live launcher checked .env.local's SHA-256 before/after execution. It
|
|
66
|
+
remained byte-for-byte unchanged. Temporary consumers, caches and initial
|
|
67
|
+
candidate tarballs were removed.
|
|
68
|
+
- Only documentation was updated after the successful live run. The final
|
|
69
|
+
review tarball is rebuilt and checked again through the installed-package
|
|
70
|
+
suite; generated dist remains ignored. Candidate publication will be verified
|
|
71
|
+
independently after approval, rather than assuming dev provenance applies.
|
|
72
|
+
- The public Homebrew tap was read and matches the verified 0.1.1 formula. Its
|
|
73
|
+
0.1.2 update waits for the stable npm artifact and immutable release lockfile.
|
|
74
|
+
|
|
75
|
+
The live checks are bounded development evidence. Provider failure/load behavior,
|
|
76
|
+
dense vector reranking, new-preset language quality, production deployment and
|
|
77
|
+
billing readiness remain outside this verification. The PR must pass Node 22/24
|
|
78
|
+
CI and receive review before main promotion. Tagging and publication are separate
|
|
79
|
+
approved actions; synchronize main back into develop with 0.1.3-dev.1 afterward.
|
|
80
|
+
|
|
81
|
+
## Published SDK 0.7.0 development consumer (2026-10-04)
|
|
82
|
+
|
|
83
|
+
The [develop merge workflow](https://github.com/lambdadb/lambdadb-cli/actions/runs/37188862636)
|
|
84
|
+
completed successfully and published
|
|
85
|
+
[`0.1.2-dev.12`](https://www.npmjs.com/package/@functional-systems/lambdadb-cli/v/0.1.2-dev.12)
|
|
86
|
+
from `aef74a3deeacb1e5d3f50856301562b58739fcdd` on attempt 1. Required Node
|
|
87
|
+
22/24 validation and the exact publication artifact tests passed. Registry
|
|
88
|
+
visibility was checked with reads while the automatic job completed; no second
|
|
89
|
+
publication was attempted. At verification, dev=0.1.2-dev.12 and latest=0.1.1.
|
|
90
|
+
|
|
91
|
+
- Downloaded tarball SHA-512 matched registry integrity and the clean consumer
|
|
92
|
+
lockfile. SDK dependency and the installed SDK both resolve exactly to 0.7.0.
|
|
93
|
+
Integrity: `sha512-AyGfP2ibeu/unYj5RvkkBO2WICkCMk6dp+4TauH0Da2xBsN6g3Nub7MmM/ZeiRE93wwV9r05IhXV2DyS28WY1A==`.
|
|
94
|
+
- Registry/installed gitHead and decoded
|
|
95
|
+
[provenance](https://registry.npmjs.org/-/npm/v1/attestations/@functional-systems%2flambdadb-cli@0.1.2-dev.12)
|
|
96
|
+
agree on the merge commit, repository, develop ref, publish.yaml workflow and
|
|
97
|
+
run 37188862636; the provenance subject digest matches the downloaded artifact.
|
|
98
|
+
- A fresh tarball consumer passed version/help and all 46 CLI contracts. Tests
|
|
99
|
+
came from an archived merge-source snapshot, with its expected package version
|
|
100
|
+
set to the generated published version. A separate registry-version consumer
|
|
101
|
+
with an isolated cache verified matching lockfile integrity and SDK version;
|
|
102
|
+
npm audit signatures verified four registry signatures and three attestations,
|
|
103
|
+
including the published CLI. The preliminary local-tarball audit verified only
|
|
104
|
+
the three registry dependencies, so the registry consumer verified the CLI too.
|
|
105
|
+
- The published CLI's executable was selected through LAMBDADB_TEST_CLI for the
|
|
106
|
+
expanded authorized development smoke. All 49 preset metadata, ordinary/bulk
|
|
107
|
+
writes, full committed query/fetch contents, exact facets and managed reranking
|
|
108
|
+
default/null/custom checks passed in 81.9 seconds. Query contents appeared at
|
|
109
|
+
about 78 seconds; acceptance at about 2 seconds did not imply search readiness.
|
|
110
|
+
- Cleanup was accepted and HTTP 404 confirmed for
|
|
111
|
+
`cli-smoke-5028c4c7-535c-4b29-8978-b3b805054d7d`. Temporary consumers, caches,
|
|
112
|
+
source snapshots and tarballs were removed. .env.local remained byte-for-byte
|
|
113
|
+
unchanged. The designated target and in-memory environment mapping are recorded
|
|
114
|
+
in the authenticated follow-up below.
|
|
115
|
+
|
|
116
|
+
This establishes the published development artifact and a bounded sample on one
|
|
117
|
+
development target. It does not establish stable publication, production feature
|
|
118
|
+
deployment, language-specific search quality, load/failure coverage or billing
|
|
119
|
+
readiness.
|
|
120
|
+
|
|
6
121
|
## SDK 0.7.0 local compatibility (2026-10-04)
|
|
7
122
|
|
|
8
123
|
The checkout began clean on develop at `3903531`. npm now pins the released
|
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.3-dev.13",
|
|
4
4
|
"private": false,
|
|
5
5
|
"description": "Project-scoped LambdaDB command-line tools",
|
|
6
6
|
"type": "module",
|
|
@@ -53,5 +53,5 @@
|
|
|
53
53
|
"url": "https://github.com/lambdadb/lambdadb-cli/issues"
|
|
54
54
|
},
|
|
55
55
|
"license": "Apache-2.0",
|
|
56
|
-
"gitHead": "
|
|
56
|
+
"gitHead": "aefbaeed9c799e76dd7a9501ecda6ab80dc6e958"
|
|
57
57
|
}
|