@promptowl/contextnest-community 1.14.0 → 1.15.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/CONFIGURATION.md CHANGED
@@ -279,6 +279,20 @@ On first connect the server creates its schema automatically (idempotent) — no
279
279
  manual migration step. There is no built-in SQLite→Postgres data migration; a new
280
280
  Postgres backend starts empty.
281
281
 
282
+ ### First-boot upgrade passes
283
+
284
+ Some upgrades carry a one-shot data pass that runs at startup, before the server
285
+ accepts requests, and records itself in `schema_migrations` so it never repeats.
286
+ Two exist today: the `node_versions` backfill from `history.yaml`, and the
287
+ version-chain repair added in 1.13 (re-anchors documents whose version chain was
288
+ grafted by an older import, and moves inline patches into `v{N}.diff` files).
289
+
290
+ Both walk every document in every nest, so on a large vault the **first** boot
291
+ after upgrading can take noticeably longer than usual — reads of the on-disk
292
+ vault, not database work, so an install on network/FUSE storage feels it most.
293
+ Every subsequent boot skips the pass entirely. Progress and a per-pass summary
294
+ are printed to the server log.
295
+
282
296
  > ⚠️ **Cloud Run durability — read this.** Cloud SQL persists only the *metadata
283
297
  > database*. The actual **document content and version history** live on the
284
298
  > filesystem under `$DATA_ROOT/nests/`, which on Cloud Run is **ephemeral** and is
@@ -3,7 +3,7 @@ import {
3
3
  } from "./chunk-GUNJTORH.js";
4
4
  import {
5
5
  getDb
6
- } from "./chunk-I5KYGMIT.js";
6
+ } from "./chunk-BCFKLY4H.js";
7
7
 
8
8
  // src/governance/grants-service.ts
9
9
  import { v4 as uuid } from "uuid";