@functional-systems/lambdadb-cli 0.1.2-dev.12 → 0.1.2

package/CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ## [Unreleased]
 
+## [0.1.2] - 2026-10-04
+
 ### Fixed
 
 - Preserve fixed rerank status/provider/model/criteria/reason tokens when they

package/RELEASING.md

@@ -2,6 +2,22 @@
 
 ## Current status
 
+CLI 0.1.2 is ready for release review from reviewed develop commit `aef74a3` (PR #14).
+The candidate pins SDK 0.7.0, supports 49 fixed text analyzer presets and optional
+per-query managed reranking, and preserves fixed rerank metadata during credential
+redaction. The published 0.1.2-dev.12 artifact passed independent consumer,
+provenance/signature and authorized development-service checks. The separately
+installed 0.1.2 candidate also passed the expanded live smoke; its earlier failed
+attempt and independent cleanup are recorded in [VALIDATION.md](VALIDATION.md).
+
+Stable 0.1.2 is not published yet. The release PR targets main; its merge, immutable
+`v0.1.2` tag and GitHub Release remain separate approved actions. After publishing,
+verify npm latest, artifact integrity/provenance and clean consumers before updating
+Homebrew. Keep develop on its dev version while this release branch is reviewed;
+synchronize main back with the next `0.1.3-dev.1` base after release.
+
+## CLI 0.1.1 publication
+
 CLI 0.1.1 was published on 2026-09-29 through
 [GitHub Release v0.1.1](https://github.com/lambdadb/lambdadb-cli/releases/tag/v0.1.1)
 and the [OIDC release workflow](https://github.com/lambdadb/lambdadb-cli/actions/runs/36557578359).
@@ -16,8 +32,8 @@ tarball is byte-identical to the tested final candidate; provenance identifies t
 release commit, tag and workflow. See [VALIDATION.md](VALIDATION.md#cli-011-publication).
 
 The post-release branch synchronizes main history into develop with `0.1.2-dev.1`
-and prepares the 0.1.1 Homebrew formula. The public tap update requires its separate
-review and merge. Facets still require a supporting server and newly built keyword
+and prepares the 0.1.1 Homebrew formula. The public tap was checked on 2026-10-04
+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
 indexes; publication does not migrate Collections or upgrade installed CLIs.
 
 ## Prior publication status
@@ -260,9 +276,11 @@ npm run test:live
 
 The test fails before API calls when required settings are absent. It creates a
 random temporary collection, imports two 3 MiB documents plus a bulk document,
-uses the new `chinese` analyzer, checks exact facet-only and document+facet buckets,
-and checks committed query/fetch contents with a maximum 300-second observation
-window per stage. Request timeouts and polling sleeps are capped to the remaining
+accepts and verifies metadata for all 49 fixed analyzer presets, checks exact
+facet-only and document+facet buckets, and checks committed query/fetch contents
+with a maximum 300-second observation window per stage. It also checks managed reranking with default criteria, null
+and custom criteria, including final/retrieval scores and status metadata.
+Request timeouts and polling sleeps are capped to the remaining
 budget, and responses at or after the deadline cannot pass. Process termination
 and event-loop scheduling may delay reporting. It reports elapsed time and
 matched-document counts; a timeout is a failed smoke, not proof that accepted
@@ -287,7 +305,8 @@ release, follow the [Homebrew maintainer guide](https://github.com/lambdadb/lamb
 update checksums, pass installation checks and prepare a tap PR. Tap publication
 is separate from this repository's npm workflow; no cross-repository write or
 automatic tap update is configured. The public
-[LambdaDB tap](https://github.com/lambdadb/homebrew-tap) provides stable `0.1.0`;
+[LambdaDB tap](https://github.com/lambdadb/homebrew-tap) provides stable `0.1.1`
+(verified on 2026-10-04);
 installation evidence is recorded in [VALIDATION.md](VALIDATION.md#homebrew-publication).
 
 ## Design references

package/VALIDATION.md

@@ -3,6 +3,89 @@
 Updated: 2026-10-04. Local contract tests use loopback servers and synthetic
 credentials. Authenticated development-project evidence is recorded separately.
 
+## CLI 0.1.2 stable candidate (2026-10-04)
+
+Prepared release/0.1.2 from reviewed develop merge `aef74a3`, retaining SDK 0.7.0
+and all reviewed runtime/test changes. The release branch changes only version
+metadata, the dated changelog and release/validation documentation. Stable npm
+0.1.2 was absent when checked; latest remains 0.1.1. No stable tag, GitHub Release,
+package publication or main merge was performed during preparation.
+
+- npm ci, lint, typecheck, version checks and the explicit
+  RELEASE_TAG=v0.1.2 / RELEASE_PRERELEASE=false preflight passed on Node 24.15.0
+  with npm 11.12.1. All 71 source tests and 46 separately installed CLI tests passed.
+  The executable and lockfile agree on 0.1.2, and the installed SDK is 0.7.0.
+- A candidate tarball was installed into an isolated consumer with its own npm
+  cache. Its executable was selected via LAMBDADB_TEST_CLI for the authorized
+  development smoke using the existing .env.local target and in-memory mapping.
+  The successful run took 54.4 seconds: accepted writes at about 3 seconds,
+  committed query/fetch contents at about 52 seconds, exact facets and managed
+  reranking default/null/custom by about 54 seconds. All 49 preset metadata
+  checks passed. Cleanup returned HTTP 404 for
+  `cli-smoke-14b21fee-59e1-4898-9ef2-8a57db823de0`.
+- The first candidate live attempt failed after 53.2 seconds during query
+  observation with exit 3 and no HTTP status. The log does not distinguish a
+  transport timeout from another request failure; this is not a passing sample
+  or proof of a candidate defect. No runtime code was changed for the retry.
+  Cleanup was not confirmed by that run. An independent SDK get found its
+  test-owned collection still present; delete was accepted and a subsequent
+  get returned HTTP 404 for `cli-smoke-c42a987e-592a-4611-a8d7-04cf5b90ad15`.
+- Every live launcher checked .env.local's SHA-256 before/after execution. It
+  remained byte-for-byte unchanged. Temporary consumers, caches and initial
+  candidate tarballs were removed.
+- Only documentation was updated after the successful live run. The final
+  review tarball is rebuilt and checked again through the installed-package
+  suite; generated dist remains ignored. Candidate publication will be verified
+  independently after approval, rather than assuming dev provenance applies.
+- The public Homebrew tap was read and matches the verified 0.1.1 formula. Its
+  0.1.2 update waits for the stable npm artifact and immutable release lockfile.
+
+The live checks are bounded development evidence. Provider failure/load behavior,
+dense vector reranking, new-preset language quality, production deployment and
+billing readiness remain outside this verification. The PR must pass Node 22/24
+CI and receive review before main promotion. Tagging and publication are separate
+approved actions; synchronize main back into develop with 0.1.3-dev.1 afterward.
+
+## Published SDK 0.7.0 development consumer (2026-10-04)
+
+The [develop merge workflow](https://github.com/lambdadb/lambdadb-cli/actions/runs/37188862636)
+completed successfully and published
+[`0.1.2-dev.12`](https://www.npmjs.com/package/@functional-systems/lambdadb-cli/v/0.1.2-dev.12)
+from `aef74a3deeacb1e5d3f50856301562b58739fcdd` on attempt 1. Required Node
+22/24 validation and the exact publication artifact tests passed. Registry
+visibility was checked with reads while the automatic job completed; no second
+publication was attempted. At verification, dev=0.1.2-dev.12 and latest=0.1.1.
+
+- Downloaded tarball SHA-512 matched registry integrity and the clean consumer
+  lockfile. SDK dependency and the installed SDK both resolve exactly to 0.7.0.
+  Integrity: `sha512-AyGfP2ibeu/unYj5RvkkBO2WICkCMk6dp+4TauH0Da2xBsN6g3Nub7MmM/ZeiRE93wwV9r05IhXV2DyS28WY1A==`.
+- Registry/installed gitHead and decoded
+  [provenance](https://registry.npmjs.org/-/npm/v1/attestations/@functional-systems%2flambdadb-cli@0.1.2-dev.12)
+  agree on the merge commit, repository, develop ref, publish.yaml workflow and
+  run 37188862636; the provenance subject digest matches the downloaded artifact.
+- A fresh tarball consumer passed version/help and all 46 CLI contracts. Tests
+  came from an archived merge-source snapshot, with its expected package version
+  set to the generated published version. A separate registry-version consumer
+  with an isolated cache verified matching lockfile integrity and SDK version;
+  npm audit signatures verified four registry signatures and three attestations,
+  including the published CLI. The preliminary local-tarball audit verified only
+  the three registry dependencies, so the registry consumer verified the CLI too.
+- The published CLI's executable was selected through LAMBDADB_TEST_CLI for the
+  expanded authorized development smoke. All 49 preset metadata, ordinary/bulk
+  writes, full committed query/fetch contents, exact facets and managed reranking
+  default/null/custom checks passed in 81.9 seconds. Query contents appeared at
+  about 78 seconds; acceptance at about 2 seconds did not imply search readiness.
+- Cleanup was accepted and HTTP 404 confirmed for
+  `cli-smoke-5028c4c7-535c-4b29-8978-b3b805054d7d`. Temporary consumers, caches,
+  source snapshots and tarballs were removed. .env.local remained byte-for-byte
+  unchanged. The designated target and in-memory environment mapping are recorded
+  in the authenticated follow-up below.
+
+This establishes the published development artifact and a bounded sample on one
+development target. It does not establish stable publication, production feature
+deployment, language-specific search quality, load/failure coverage or billing
+readiness.
+
 ## SDK 0.7.0 local compatibility (2026-10-04)
 
 The checkout began clean on develop at `3903531`. npm now pins the released

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@functional-systems/lambdadb-cli",
-  "version": "0.1.2-dev.12",
+  "version": "0.1.2",
   "private": false,
   "description": "Project-scoped LambdaDB command-line tools",
   "type": "module",
@@ -52,6 +52,5 @@
   "bugs": {
     "url": "https://github.com/lambdadb/lambdadb-cli/issues"
   },
-  "license": "Apache-2.0",
-  "gitHead": "aef74a3deeacb1e5d3f50856301562b58739fcdd"
+  "license": "Apache-2.0"
 }